# projects — агент v12: доски проектов из параметров команд — план

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** агент v12 берёт доски Jira из параметров команд: `ensure_sprint` — из `board_id` команды, `refresh` — из
`boards` (`[{id, type}]`); для досок с `type = null` определяет тип (`GET /rest/agile/1.0/board/{id}`) и возвращает его
в результате `boards`, спринты задач собирает со всех scrum-досок; без `board_id`/`boards` работает по
`settings.board_id`, как v11.

**Architecture:** всё в `src/agent.py`, класс `Executor`. Кэш спринтов `_sprints` из одного словаря становится словарём
«доска → (имя → спринт)» и по-прежнему сбрасывается в `Executor.run` на каждую команду (а при смене настроек `Runner`
пересоздаёт `Executor`). `sprints(board)` читает активные и будущие спринты одной доски; `do_ensure_sprint` берёт доску
`p["board_id"]`, иначе `settings.board_id`. В `do_refresh` первым шагом `refresh_boards(p)` определяет типы досок с
`type = null` (`board_type(board)`, ошибка HTTP — `None` и строка в логе) и отдаёт список scrum-досок и словарь для
результата; `sprint_names(keys, boards)` обходит доски по порядку, последнее найденное имя побеждает.

**Tech Stack:** Python 3.9.6 (`/usr/bin/python3`), только стандартная библиотека; тесты — `unittest` на фейках
`tests/fake_jira.py`, `tests/fake_hub.py`.

**Spec:** change хаба `projects` (aep/jira-hub#61), пока в worktree хаба:
`/Users/andrey.epifancev/projects/jira-bridge/jira-hub/.wt/scopes/openspec/changes/projects/` —
`specs/agent/spec.md` (ADDED «Доски проектов» — основное, MODIFIED «Состав и настройки агента»),
`specs/commands/spec.md` (таблица команд: `ensure_sprint.board_id`, `refresh.boards`, результат `boards`),
`design.md` (решения 4, 7, 14, 15; «Decisions made without discussion» № 6, 7, 14). Действующая спека агента —
`/Users/andrey.epifancev/projects/jira-bridge/jira-hub/.wt/scopes/openspec/specs/agent/spec.md`. Решения агентской
части — `openspec/changes/agent-v12-project-boards/design.md` (создаётся в Task 3).

**Worktree:** `/Users/andrey.epifancev/projects/jira-bridge/jira-agent/.wt/projects`, ветка `feat/35-projects`
(aep/jira-agent#35). Все команды — из корня worktree; основные checkout'ы `jira-agent` и `jira-hub` не трогать.

## Global Constraints

- Python ≥ 3.9 (на виртуалке 3.9.6, тесты — `/usr/bin/python3`), только стандартная библиотека; синтаксис 3.10+
  (`X | Y` в аннотациях функций, `match`) запрещён — `tests/test_py39.py`. Для кортежей в аннотациях — `typing.Tuple`.
- Тесты: `/usr/bin/python3 -W error::ResourceWarning -m unittest discover -s tests -t .` — зелёным считается только весь
  набор (до плана — 262 теста; набор идёт ≈2 минуты, прогон всего набора — в фоне).
- `AGENT_VERSION` SHALL быть 12.
- `ensure_sprint` SHALL брать доску из `board_id` команды; нет `board_id` (или он `null`) — из `settings.board_id`, как v11.
- `refresh` SHALL брать доски из `boards` (`[{id, type}]`, `type` — `"scrum"`, `"kanban"` или `null`). Нет ключа
  `boards` (хаб до проектов) — одна доска `settings.board_id`, как v11, результат без `boards`.
- Для каждой доски с `type = null` — ровно один `GET /rest/agile/1.0/board/{id}`; тип из ответа (`type`) — `"scrum"` или
  `"kanban"`, иначе `null`; ошибка запроса — `null`, строка в логе с номером доски и кодом ответа, `refresh` продолжается.
- Результат `refresh` — `boards: {"<id>": "scrum" | "kanban" | null}` только для досок, чей тип агент запрашивал; ключ —
  строка.
- Имена спринтов — со всех досок типа `scrum` (известного или только что определённого) в порядке `boards`; `kanban` и
  `null` пропускаются; задача в спринтах двух досок получает последнее найденное имя (как в v11).
- `ensure_sprint` на доске без спринтов (Jira ответила ошибкой на список спринтов) — `failed` с текстом Jira.
- Коммиты на русском с `(#35)`, трейлер `Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>`.

## Review Focus

1. Хаб с проектами прислал `boards: []` (ни у одного проекта нет доски), а в его настройках остался `board_id = 4216`
   (решение 14 хаба) — агент не читает спринты доски из настроек, спринты задач — `null` (Task 2,
   `test_empty_boards_no_settings_fallback`).
2. `GET /board/{id}` ответил 5xx (а не 404) — тип `null`, строка в логе с кодом, `refresh` завершается `done`, состояние
   уходит в хаб (Task 2, `test_board_type_5xx_logged_refresh_continues`).
3. Одна и та же доска с `type = null` дважды в `boards` — один запрос типа, один ключ в результате (Task 2,
   `test_duplicate_null_board_requested_once`).
4. `refresh {keys: []}` с доской неизвестного типа — тип всё равно определяется и возвращается (иначе хвост пакета без
   задач оставил бы тип неизвестным) (Task 2, `test_empty_keys_still_resolves_boards`).
5. Доска, известная хабу как `scrum`, перестала отдавать спринты (стала канбаном, удалена) — `refresh` `failed` с текстом
   Jira, как v11, а не молчаливое обнуление спринтов в зеркале (Task 2, `test_scrum_board_sprints_error_fails_refresh`;
   решение R-32).

---

### Task 1: Спринты по доске и `ensure_sprint` с `board_id` из команды

**Модель исполнителя:** sonnet.

**Files:**
- Modify: `tests/fake_jira.py` — `FakeJira.__init__` (новые поля), маршруты Agile в `route` (стр. 352–380)
- Modify: `src/agent.py` — `Executor.__init__` и `Executor.run` (стр. 556–564, сброс `_sprints`), `Executor.sprints`
  (стр. 838–851), `Executor.do_ensure_sprint` (стр. 853–873)
- Test: `tests/test_executor_links.py`

**Interfaces:**
- Consumes: —
- Produces:
  - `FakeJira.boards: Dict[int, str]` — доска → тип, по умолчанию `{4216: "scrum"}`. `GET /rest/agile/1.0/board/{id}`:
    есть — 200 `{"id": id, "name": "Доска <id>", "type": <тип>}`, нет — 404 `{"errorMessages": ["Board does not exist"]}`.
    `GET /rest/agile/1.0/board/{id}/sprint` у доски с типом `"kanban"` — 400
    `{"errorMessages": ["The board does not support sprints"]}`.
  - `FakeJira.board_sprints: Dict[int, List[dict]]` — спринты доски; доски нет в словаре — общий `self.sprints` (как
    раньше, чтобы старые тесты не менялись).
  - `FakeJira.sprint_members: Dict[int, List[str]]` — id спринта → ключи задач; для такого спринта
    `GET /sprint/{id}/issue` отдаёт эти ключи (с фильтром по `jql` `key in (…)`) вместо сравнения по имени.
  - `FakeJira.all_sprints() -> List[dict]` — `self.sprints` + все списки `board_sprints`; по нему ищут спринт
    `/sprint/{id}/issue` и `GET /rest/agile/1.0/issue/{key}`.
  - `Executor._sprints: Dict[str, Dict[str, dict]]` — `str(доска)` → имя → спринт; `{}` в `__init__` и в начале `run`.
  - `Executor.sprints(self, board: Any) -> Dict[str, dict]` — активные и будущие спринты доски `board` (постранично, как
    v11), с кэшем на команду; ошибку Jira не глотает.

- [ ] **Step 1: Фейк — доски, спринты по доске, участники спринта**

Добавить в `FakeJira` поля и маршрут `GET /rest/agile/1.0/board/{id}` из Interfaces (регулярка `^/rest/agile/1\.0/board/(\d+)$`
не пересекается с `…/sprint`), 400 для канбан-доски в маршруте `/board/{id}/sprint`, список спринтов по `board_sprints`,
`all_sprints()` в маршрутах `/sprint/{id}/issue` и `/agile/1.0/issue/{key}`, `sprint_members` в `GET /sprint/{id}/issue`.

Run: `/usr/bin/python3 -m unittest tests.test_executor_links tests.test_refresh -v`
Expected: PASS (фейк по умолчанию ведёт себя как раньше).

- [ ] **Step 2: Падающие тесты**

В `tests/test_executor_links.py`, после `test_sprint_without_board`:

```python
    def test_sprint_board_from_params(self):
        self.fake.boards[5120] = "scrum"
        self.fake.board_sprints[5120] = [{"id": 7, "name": "Спринт K", "state": "active"}]
        out = self.run_cmd("ensure_sprint", key="AURORA-1", sprint="Спринт K", board_id=5120)
        self.assertEqual(out["status"], "done", out)
        self.assertEqual(out["result"], {"sprint": "Спринт K", "from": None})
        self.assertEqual(self.fake.issues["AURORA-1"]["sprint"], "Спринт K")
        paths = [r[1] for r in self.fake.requests]
        self.assertIn("/rest/agile/1.0/board/5120/sprint", paths)
        self.assertNotIn("/rest/agile/1.0/board/4216/sprint", paths)    # settings.board_id = 4216 не трогается
        again = self.run_cmd("ensure_sprint", key="AURORA-1", sprint="Спринт K", board_id=5120)
        self.assertEqual(again["result"], {"sprint": "Спринт K", "changed": False})

    def test_sprint_board_from_params_without_settings(self):   # сценарий «Спринт по доске из команды»
        self.ex.s["board_id"] = None
        out = self.run_cmd("ensure_sprint", key="AURORA-1", sprint="Спринт 2", board_id=4216)
        self.assertEqual(out["status"], "done", out)
        self.assertEqual(self.fake.issues["AURORA-1"]["sprint"], "Спринт 2")

    def test_sprint_unknown_name_names_param_board(self):
        self.fake.board_sprints[5120] = [{"id": 7, "name": "Спринт K", "state": "active"}]
        out = self.run_cmd("ensure_sprint", key="AURORA-1", sprint="Спринт 2", board_id=5120)
        self.assertEqual(out["status"], "failed")
        self.assertIn("5120", out["error"])
        self.assertIn("Спринт K", out["error"])

    def test_sprint_kanban_board_failed_with_jira_text(self):
        self.fake.boards[5120] = "kanban"
        out = self.run_cmd("ensure_sprint", key="AURORA-1", sprint="Спринт 2", board_id=5120)
        self.assertEqual(out["status"], "failed")
        self.assertIn("HTTP 400", out["error"])
        self.assertIn("does not support sprints", out["error"])
        self.assertFalse(out["retryable"])
        self.assertIsNone(self.fake.issues["AURORA-1"]["sprint"])

    def test_sprint_backlog_ignores_board(self):
        self.fake.boards[5120] = "kanban"
        self.fake.issues["AURORA-1"]["sprint"] = "Спринт 1"
        out = self.run_cmd("ensure_sprint", key="AURORA-1", sprint="backlog", board_id=5120)
        self.assertEqual(out["result"], {"sprint": None, "from": "Спринт 1"})
        self.assertFalse(any("/board/" in r[1] for r in self.fake.requests))
```

`test_sprint_without_board` (без `board_id` в команде и в настройках) не меняется: ошибка по-прежнему содержит `board_id`.

Run: `/usr/bin/python3 -m unittest tests.test_executor_links -v`
Expected: FAIL `test_sprint_board_from_params` (идёт на доску 4216: «нет спринта «Спринт K»»),
`test_sprint_board_from_params_without_settings` («board_id не задан…»), `test_sprint_unknown_name_names_param_board`
(в тексте 4216, а не 5120); `test_sprint_kanban_board_failed_with_jira_text` и `test_sprint_backlog_ignores_board` могут
пройти уже сейчас — это допустимо, они фиксируют поведение.

- [ ] **Step 3: Реализация**

- `Executor._sprints = {}` в `__init__` и в начале `run` (вместо `None`).
- `sprints(self, board: Any) -> Dict[str, dict]` — тело v11, доска из аргумента, кэш `self._sprints[str(board)]`;
  docstring: «Имя → спринт (active и future) доски board».
- `do_ensure_sprint`: `board = p.get("board_id") or self.s.get("board_id")` после ветки `backlog`; нет доски —
  `failed` «board_id нет ни в команде, ни в настройках хаба — спринты недоступны»; дальше как v11 с `self.sprints(board)`,
  в тексте «нет спринта …» — номер `board`.
- `sprint_names` пока зовёт `self.sprints(self.s["board_id"])` (переделывается в Task 2).

Run: `/usr/bin/python3 -m unittest tests.test_executor_links tests.test_refresh -v`
Expected: PASS.

- [ ] **Step 4: Весь набор**

Run: `/usr/bin/python3 -W error::ResourceWarning -m unittest discover -s tests -t .`
Expected: `OK`.

- [ ] **Step 5: Commit**

```bash
git add tests/fake_jira.py tests/test_executor_links.py src/agent.py
git commit -m "feat(agent): ensure_sprint по доске из команды, кэш спринтов по доскам (#35)" -m "Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>"
```

---

### Task 2: `refresh` с досками проектов: тип доски, спринты со всех scrum-досок, результат `boards`

**Модель исполнителя:** sonnet.

**Files:**
- Modify: `src/agent.py` — импорт `Tuple` из `typing` (стр. 34), новые `Executor.board_type`, `Executor.refresh_boards`
  (раздел `refresh`, перед `sprint_names`), `Executor.sprint_names` (стр. 1024–1043), `Executor.do_refresh`
  (стр. 1045–1095)
- Test: `tests/test_refresh.py`

**Interfaces:**
- Consumes: Task 1 — `Executor.sprints(board)`, `FakeJira.boards`, `FakeJira.board_sprints`, `FakeJira.sprint_members`.
- Produces:
  - `Executor.board_type(self, board: Any) -> Optional[str]` — `GET /rest/agile/1.0/board/{board}`; `type` из ответа,
    если он `"scrum"` или `"kanban"` (точное совпадение), иначе `None` и в лог
    `"refresh: доска %s — тип «%s» не scrum/kanban" % (board, t)`; `HttpError` любого кода — `None` и в лог
    `"refresh: доска %s — тип не определён (HTTP %d)" % (board, e.code)`; `ConnectionError` не ловит.
  - `Executor.refresh_boards(self, p: dict) -> Tuple[List[Any], Optional[Dict[str, Optional[str]]]]` — (scrum-доски в
    порядке `boards` без повторов по `str(id)`, словарь для результата). Нет ключа `boards` — `([settings.board_id]` или
    `[]`, `None)`. Есть — для каждой доски с `type is None` один `board_type`; словарь — запрошенные доски
    (`str(id)` → тип), пустой словарь возвращается как `None`. Элемент без `id` пропускается.
  - `Executor.sprint_names(self, keys: List[str], boards: List[Any]) -> Dict[str, str]` — как v11, но по каждой доске
    `boards` по порядку (`for board in boards: for name, sp in self.sprints(board).items(): …`); пустые `keys` или
    `boards` — `{}`.
  - `do_refresh`: первым действием `scrum, types = self.refresh_boards(p)` (до поиска и до раннего выхода по пустым
    `keys`); `names = self.sprint_names(keys, scrum)`; если `types is not None` — `result["boards"] = types` (и в раннем
    выходе по пустым `keys`).

- [ ] **Step 1: Падающие тесты**

В `tests/test_refresh.py` поменять вызов в `test_sprint_names_paginated` на
`self.ex.sprint_names(["AURORA-%d" % i for i in range(1, 101)], [4216])` и добавить:

```python
    JQL = "project = AURORA AND labels in (AWPCA, STOCKS_DRRK)"

    def refresh(self, **params):
        return self.ex.run({"id": 5, "type": "refresh", "params": params})

    def logged(self, fn):
        logs, orig = [], agent.log
        agent.log = logs.append
        try:
            return fn(), logs
        finally:
            agent.log = orig

    def test_two_boards_one_new(self):            # сценарий «Две доски, одна новая»
        self.fake.boards[5120] = "kanban"
        self.fake.add("AURORA-1", sprint="Спринт 2")
        out = self.refresh(jql=self.JQL, boards=[{"id": 4216, "type": "scrum"}, {"id": 5120, "type": None}])
        self.assertEqual(out["status"], "done", out)
        self.assertEqual(out["result"]["boards"], {"5120": "kanban"})
        paths = [r[1] for r in self.fake.requests]
        self.assertEqual(paths.count("/rest/agile/1.0/board/5120"), 1)
        self.assertNotIn("/rest/agile/1.0/board/5120/sprint", paths)
        self.assertNotIn("/rest/agile/1.0/board/4216", paths)          # тип известен — не спрашиваем
        self.assertEqual(self.hub.states[0]["issues"][0]["sprint"], "Спринт 2")

    def test_board_not_found(self):               # сценарий «Доска не найдена»
        self.fake.add("AURORA-1")
        out, logs = self.logged(lambda: self.refresh(jql=self.JQL, boards=[{"id": 9999, "type": None}]))
        self.assertEqual(out["status"], "done", out)
        self.assertEqual(out["result"]["boards"], {"9999": None})
        self.assertTrue(any("9999" in l and "HTTP 404" in l for l in logs), logs)
        self.assertEqual(len(self.hub.states), 1)

    def test_new_scrum_board_sprints_read(self):
        self.fake.boards[5120] = "scrum"
        self.fake.board_sprints[5120] = [{"id": 7, "name": "Спринт K", "state": "active"}]
        self.fake.add("AURORA-1", sprint="Спринт K")
        out = self.refresh(jql=self.JQL, boards=[{"id": 5120, "type": None}])
        self.assertEqual(out["result"]["boards"], {"5120": "scrum"})
        self.assertEqual(self.hub.states[0]["issues"][0]["sprint"], "Спринт K")
        self.assertNotIn("/rest/agile/1.0/board/4216/sprint", [r[1] for r in self.fake.requests])

    def test_old_hub_without_boards(self):        # сценарий «Старый хаб»
        self.fake.add("AURORA-1", sprint="Спринт 2")
        out = self.refresh(jql=self.JQL)
        self.assertNotIn("boards", out["result"])
        self.assertIn("/rest/agile/1.0/board/4216/sprint", [r[1] for r in self.fake.requests])
        self.assertEqual(self.hub.states[0]["issues"][0]["sprint"], "Спринт 2")

    def test_known_boards_no_type_requests(self):
        self.fake.add("AURORA-1", sprint="Спринт 2")
        out = self.refresh(jql=self.JQL, boards=[{"id": 4216, "type": "scrum"}])
        self.assertNotIn("boards", out["result"])
        self.assertNotIn("/rest/agile/1.0/board/4216", [r[1] for r in self.fake.requests])
        self.assertEqual(self.hub.states[0]["issues"][0]["sprint"], "Спринт 2")

    def test_empty_boards_no_settings_fallback(self):
        self.fake.add("AURORA-1", sprint="Спринт 2")
        out = self.refresh(jql=self.JQL, boards=[])
        self.assertEqual(out["status"], "done", out)
        self.assertNotIn("boards", out["result"])
        self.assertFalse(any("/rest/agile/1.0/board/" in r[1] for r in self.fake.requests))
        self.assertIsNone(self.hub.states[0]["issues"][0]["sprint"])

    def test_board_type_5xx_logged_refresh_continues(self):
        self.fake.add("AURORA-1")
        self.fake.fail_next.append((500, {}))      # первый вызов Jira в refresh — тип доски
        out, logs = self.logged(lambda: self.refresh(jql=self.JQL, boards=[{"id": 5120, "type": None}]))
        self.assertEqual(out["status"], "done", out)
        self.assertEqual(out["result"]["boards"], {"5120": None})
        self.assertTrue(any("5120" in l and "HTTP 500" in l for l in logs), logs)

    def test_board_other_type_is_null(self):
        self.fake.boards[7000] = "simple"
        out, logs = self.logged(lambda: self.refresh(keys=[], boards=[{"id": 7000, "type": None}]))
        self.assertEqual(out["result"]["boards"], {"7000": None})
        self.assertTrue(any("7000" in l and "simple" in l for l in logs), logs)

    def test_duplicate_null_board_requested_once(self):
        self.fake.boards[5120] = "kanban"
        out = self.refresh(keys=[], boards=[{"id": 5120, "type": None}, {"id": 5120, "type": None}])
        self.assertEqual(out["result"]["boards"], {"5120": "kanban"})
        self.assertEqual([r[1] for r in self.fake.requests].count("/rest/agile/1.0/board/5120"), 1)

    def test_empty_keys_still_resolves_boards(self):
        self.fake.boards[5120] = "kanban"
        out = self.refresh(keys=[], boards=[{"id": 5120, "type": None}])
        self.assertEqual(out["status"], "done")
        self.assertEqual(out["result"], {"issues": 0, "neighbors": 0, "pages": 0, "boards": {"5120": "kanban"}})

    def test_last_found_sprint_wins_across_boards(self):
        self.fake.boards[5120] = "scrum"
        self.fake.board_sprints[5120] = [{"id": 7, "name": "Спринт K", "state": "active"}]
        self.fake.add("AURORA-1")
        self.fake.sprint_members = {2: ["AURORA-1"], 7: ["AURORA-1"]}
        both = [{"id": 4216, "type": "scrum"}, {"id": 5120, "type": "scrum"}]
        self.refresh(jql=self.JQL, boards=both)
        self.assertEqual(self.hub.states[-1]["issues"][0]["sprint"], "Спринт K")
        self.refresh(jql=self.JQL, boards=both[::-1])
        self.assertEqual(self.hub.states[-1]["issues"][0]["sprint"], "Спринт 2")

    def test_scrum_board_sprints_error_fails_refresh(self):   # R-32
        self.fake.boards[5120] = "kanban"                     # хаб думает, что scrum
        self.fake.add("AURORA-1")
        out = self.refresh(jql=self.JQL, boards=[{"id": 5120, "type": "scrum"}])
        self.assertEqual(out["status"], "failed")
        self.assertIn("HTTP 400", out["error"])
        self.assertEqual(self.hub.states, [])
```

`FakeJira.search_keys` на любую JQL без `key in` и без `reporter` отдаёт задачи с меткой `AWPCA` — `self.JQL` подходит.
В `test_board_type_5xx_logged_refresh_continues` 500 достаётся запросу типа доски потому, что `refresh_boards` — первый
вызов Jira в `do_refresh` (R-30).

Run: `/usr/bin/python3 -m unittest tests.test_refresh -v`
Expected: FAIL — `KeyError: 'boards'` в результате, `TypeError` у `test_sprint_names_paginated` (лишний аргумент) и
запросы к доске 4216 там, где их быть не должно; `test_old_hub_without_boards` проходит уже сейчас.

- [ ] **Step 2: Реализация**

`board_type`, `refresh_boards`, `sprint_names(keys, boards)` и правка `do_refresh` — по Interfaces. Комментарий R-6 у
`sprint_names` сохранить.

Run: `/usr/bin/python3 -m unittest tests.test_refresh tests.test_executor_links -v`
Expected: PASS.

- [ ] **Step 3: Весь набор**

Run: `/usr/bin/python3 -W error::ResourceWarning -m unittest discover -s tests -t .`
Expected: `OK`.

- [ ] **Step 4: Commit**

```bash
git add src/agent.py tests/test_refresh.py
git commit -m "feat(agent): refresh по доскам проектов — тип доски, спринты со всех scrum-досок, результат boards (#35)" -m "Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>"
```

---

### Task 3: Версия 12, документация, change решений агента

**Модель исполнителя:** haiku (готовый текст).

**Files:**
- Modify: `src/agent.py:36` (`AGENT_VERSION`)
- Modify: `tests/test_folder.py:185-186` (`test_version`)
- Modify: `README.md` — абзац «Остальные настройки…» (стр. 27), строки `ensure_sprint` и `refresh` таблицы команд
  (стр. 173, 175), пункт «Версия» (стр. 193–200), пункт 3 «Известных ограничений» (стр. 237–238)
- Modify: `ARCHITECTURE.md` — строка «Исполнитель» таблицы разделов (стр. 14)
- Modify: `CLAUDE.md` — раздел «Первая подсистема», строка «Последний change —»
- Create: `openspec/changes/agent-v12-project-boards/design.md` (через `openspec new change agent-v12-project-boards`)

**Interfaces:**
- Consumes: Task 1–2.
- Produces: `AGENT_VERSION = 12`.

- [ ] **Step 1: Падающий тест версии**

В `tests/test_folder.py`, `test_version`: `assertEqual(agent.AGENT_VERSION, 11)` → `assertEqual(agent.AGENT_VERSION, 12)`.

Run: `/usr/bin/python3 -m unittest tests.test_folder -v`
Expected: FAIL — `AssertionError: 11 != 12`.

- [ ] **Step 2: Версия**

В `src/agent.py` `AGENT_VERSION = 11` → `AGENT_VERSION = 12`.

Run: `/usr/bin/python3 -m unittest tests.test_folder -v`
Expected: PASS.

- [ ] **Step 3: README**

- Стр. 27: `(id полей, типы задач, карта переходов, типы связей, доска, темп)` → `(id полей, типы задач, карта переходов,
  типы связей, темп)`, а после предложения дописать: «Доски Jira (с v12) приходят в параметрах команд: `ensure_sprint` —
  `board_id`, `refresh` — `boards`; `board_id` из настроек — запасной для команд старого хаба.»
- Строка `ensure_sprint`: `переносит в спринт доски `board_id` команды (без него — доски из настроек хаба; активные и
  будущие спринты) или в бэклог; доска без спринтов (канбан) — `failed` с текстом Jira`.
- Строка `refresh`: дописать в конец ячейки `; доски с неизвестным типом (`boards`, `type = null`) — запрос
  `/rest/agile/1.0/board/{id}`, тип в результате `boards`; спринты — со всех scrum-досок`.
- Пункт «Версия»: `(сейчас 11)` → `(сейчас 12)`; после строки «Агент v10 на `ensure_attachment` …» дописать строкой того
  же отступа:

```markdown
  Версия 12 — доски проектов из параметров команд (`ensure_sprint.board_id`, `refresh.boards`), тип доски в результате
  `refresh`, спринты со всех scrum-досок; без этих параметров — `board_id` из настроек, как v11. Хаб с проектами
  выкатывается только после v12 (design хаба `projects`, решение 14).
```

- Пункт 3 ограничений: `**Спринт в `refresh` — только активные и будущие спринты доски.**` → `**Спринт в `refresh` —
  только активные и будущие спринты scrum-досок.**`; после «У задач закрытых спринтов `sprint = null`.» дописать: «Задачи
  канбан-досок и досок неизвестного типа — тоже `null`. Задача в спринтах двух досок получает имя спринта последней по
  списку `boards`. Если scrum-доска не отдала спринты (удалена, стала канбаном), `refresh` завершается `failed` с текстом
  Jira (R-32).»

- [ ] **Step 4: ARCHITECTURE.md и CLAUDE.md**

- `ARCHITECTURE.md`, строка «Исполнитель», колонка «Ответственность» — дописать в конец: `; доски — из параметров команд
  (`ensure_sprint.board_id`, `refresh.boards`, тип доски — `board_type`), `board_id` настроек — запасной`.
- `CLAUDE.md`, строку `Последний change — …` заменить на:

```markdown
Последний change — `../jira-hub/openspec/changes/projects/` (агент v12: доски проектов из параметров команд, тип доски в `refresh`; решения агента — `openspec/changes/agent-v12-project-boards/design.md`), план — `docs/superpowers/plans/2026-10-19-projects-agent.md`.
```

- [ ] **Step 5: Change решений агента**

Run: `openspec new change agent-v12-project-boards`
Expected: создан каталог `openspec/changes/agent-v12-project-boards/`.

Создать `openspec/changes/agent-v12-project-boards/design.md`; таблица — те же строки R-30…R-35, что в разделе
«Decisions made without discussion» этого плана; решения, принятые при исполнении, контроллер дописывает следующими
номерами, начиная с R-36:

```markdown
# agent-v12-project-boards — решения агента

Спека и дизайн изменения — в `jira-hub/openspec/changes/projects/` (issue aep/jira-hub#61, aep/jira-agent#35).
Агентская часть — решения 7, 14, 15 дизайна хаба и требования `agent` «Доски проектов» (ADDED) и «Состав и настройки
агента» (MODIFIED); контракт команд — `commands` (`ensure_sprint.board_id`, `refresh.boards`, результат `boards`).

## Decisions made without discussion

Решения 1–21 записаны в `jira-hub/openspec/changes/projects/design.md` (раздел «Decisions made without discussion»;
для агента — № 6, 7, 14); здесь — только решения агентской части.

| Маркер | Дата | Решение | Обоснование | Цена ошибки |
|---|---|---|---|---|
<строки R-30…R-35 из плана>
```

- [ ] **Step 6: Весь набор и синтаксис 3.9**

Run: `/usr/bin/python3 -W error::ResourceWarning -m unittest discover -s tests -t .`
Expected: `OK` (262 + новые из Task 1–2).

Run: `/usr/bin/python3 -m unittest tests.test_py39 -v`
Expected: PASS.

- [ ] **Step 7: Commit**

```bash
git add src/agent.py tests/test_folder.py README.md ARCHITECTURE.md CLAUDE.md openspec/changes/agent-v12-project-boards
git commit -m "chore(agent): версия 12, README и решения агента для досок проектов (#35)" -m "Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>"
```

---

## Decisions made without discussion

Нумерация рулингов агентской части — с R-30, чтобы не пересечься с рулингами исполнения хабовой части change.

| Маркер | Дата | Решение | Обоснование | Цена ошибки |
|---|---|---|---|---|
| R-30 | 2026-10-19 | Типы досок определяются первым шагом `refresh` — до поиска и в том числе при пустых `keys` | Спека: «для каждой доски с `type = null` агент SHALL запросить» — без условий; хвост пакета `refresh {keys: []}` не должен оставлять тип неизвестным | Лишний `GET /board/{id}` на доску неизвестного типа, если поиск затем упадёт; результат с типом при этом теряется до следующего `refresh` |
| R-31 | 2026-10-19 | Любой `HttpError` на `GET /board/{id}` (в том числе 5xx) — тип `null` и строка в логе, `refresh` продолжается; `ConnectionError` не ловится — весь `refresh` `failed` с повтором, как при обрыве связи с Jira | Спека: «ошибка запроса — в лог, `refresh` продолжается»; `null` тип в хабе не меняет, следующий `refresh` спросит снова; обрыв связи — не свойство доски | Временный 5xx откладывает определение типа до следующего `refresh` (автообновление) |
| R-32 | 2026-10-19 | Ошибка чтения спринтов scrum-доски (известной или только что определённой) в `refresh` не глотается: `refresh` `failed` с текстом Jira, как v11 | Пропуск доски записал бы в зеркало `sprint = null` всем её задачам; спека о такой ошибке молчит | Одна сломанная доска (удалена, стала канбаном) останавливает обновление зеркала всех проектов, пока владелец не поправит доску в базе хаба |
| R-33 | 2026-10-19 | Запасной `settings.board_id` — только когда ключа `boards` нет (`refresh`) или `board_id` нет / `null` (`ensure_sprint`); `boards: []` — ни одной доски, спринты не читаются | Новый хаб оставляет `board_id` в настройках (решение 14 хаба) и шлёт `boards` всегда; `[]` от него значит «у проектов нет досок», а не «старый хаб» | Если старый хаб когда-нибудь пришлёт `boards: []`, спринты пропадут из зеркала; такого хаба нет |
| R-34 | 2026-10-19 | Ключ `boards` в результате `refresh` — только если агент запросил тип хотя бы одной доски; иначе ключа нет | Спека: результат «для досок, чей тип агент запрашивал»; сценарий «Старый хаб» — «результат без `boards`» | Хаб SHALL принимать результат без `boards`; если он ждёт `{}`, — ошибка разбора результата в хабе |
| R-35 | 2026-10-19 | Доски сравниваются и выводятся по `str(id)`; повторы в `boards` отбрасываются (запрос типа — один); элемент без `id` пропускается; тип принимается только точным `"scrum"`/`"kanban"`, иное (`"simple"` и т. п.) — `null` со строкой в логе; спринты читаются в порядке `boards`, последнее найденное имя побеждает | Ключи результата в спеке — строки; хаб шлёт без повторов, но повтор не должен стоить второго запроса; сценарий спеки — «один раз» | Доска `"4216"` строкой и `4216` числом считаются одной; другой регистр типа от Jira (`"Scrum"`) дал бы `null` |

## После плана

- Финальное ревью ветки (opus), затем PR в aep/jira-agent со ссылкой на #35 и на change `projects` хаба. Агент
  сливается и публикуется первым (design хаба, решения 14 и 15).
- После merge: `uv run --project ../jira-hub jira-hub agent publish src/agent.py` из основного checkout `jira-agent` на
  main — пишет в каталог живого хаба, выполняется только по отдельной команде владельца; проверка — MCP `agent_status`
  «обновление: ok v11 → v12». Затем — выкатка хаба (шаги 2–4 решения 14 хаба).