@spec-box/sdd 0.6.4 → 0.7.0

package/README.md

@@ -37,11 +37,14 @@ src/core/        доменная модель, конфиг, состояние
                  пакет для роли, приём отчёта, change-set, headless-цикл run, доставка и текст PR, гейты через PR,
                  отчёты тестов и покрытие, категории документации и doctor, архивация
 src/adapters/    spec/spec-box, spec/openspec — истина и дельты в двух форматах; runner/claude, runner/codex — среды агентов;
-                 repo/github, repo/local — хостинг репозитория; host/claude — материалы для Claude Code
+                 repo/github, repo/local — хостинг репозитория; host/skills — раскладки скиллов по хостам, host/claude — агенты Claude Code
 src/cli/         команды commander: init, doctor, host, change, next, report, approve, reject,
                  status, instructions, validate, spec, archive
+src/browser/     sbox-browser: демон с Chrome на сессию, клиент через локальный сокет, команды страницы,
+                 снимок дерева доступности со ссылками, поиск и установка браузера, вход человеком, перенос состояния
 assets/roles/    определения ролей (Markdown): researcher, planner, tester, implementer, reviewer, verifier…
 assets/schema/   граф артефактов по умолчанию и инструкции к ним
+assets/skills/   скиллы хостов (единый источник): sbox-run, sbox-approve, sbox-browser; копируются в папку хоста при init и host install
 assets/templates/ шаблоны артефактов изменения
 assets/project/  шаблоны категорий проектной документации
 assets/ci/       шаблоны GitHub Actions и Dockerfile
@@ -70,6 +73,28 @@ sbox prompt show project-docs                 # промпт для заполн
 
 Модели и усилие по ролям задаются в `runner.models` и `runner.efforts` (по умолчанию opus только для planner и challenger, effort medium); после правки выполните `sbox host install --target claude`. Среды: `claude` через Claude Agent SDK (нужен `ANTHROPIC_API_KEY` для CI; локально годится вход Claude Code), `codex` через `codex exec` (в конфиге `runner.codex.executable`, например бинарник из ChatGPT.app). Репозиторий: `repo.adapter: github` с токеном в `GITHUB_TOKEN`; `local` только коммитит.
 
+## Браузер для проверки интерфейса
+
+Отдельный бинарник `sbox-browser` даёт агентам и людям управляемый Chrome: верификатор проверяет затронутую страницу по-настоящему, а не только сборкой, исследователь и тестировщик смотрят текущий интерфейс глазами пользователя. Пакет браузер не скачивает: `puppeteer-core` подключается к тому, что есть, а установка отдельная и необязательная.
+
+```bash
+sbox-browser doctor                                   # какой браузер будет использован и откуда
+sbox-browser install                                  # скачать Chrome for Testing в ~/.sbox/browser/cache (по желанию)
+sbox-browser install --browser chrome-headless-shell  # лёгкий вариант только для headless
+sbox-browser login https://app.local --profile app    # человек входит в окне; вход остаётся в профиле
+sbox-browser goto https://app.local/orders            # первая команда сама поднимает сессию (headless)
+sbox-browser snapshot                                 # дерево элементов со ссылками [eN]
+sbox-browser click e7                                 # действия по ссылкам или селекторам: css, text=, aria=, xpath=
+sbox-browser fill e3 "кофе" && sbox-browser press Enter
+sbox-browser wait --text "Найдено" && sbox-browser text
+sbox-browser console --errors && sbox-browser requests # ошибки консоли, ответы 4xx/5xx и неудачные запросы
+sbox-browser screenshot                               # PNG в ~/.sbox/browser/shots, путь печатается
+sbox-browser state save auth.json                     # перенести вход в CI: там sbox-browser state load auth.json
+sbox-browser stop
+```
+
+Существующий браузер вместо установки: флаг `--executable`, переменная `SBOX_BROWSER_EXECUTABLE` или `browser.executable` в `.sbox/config.yaml`; без них по порядку проверяются кэш инструмента, кэш puppeteer, системный Chrome, Chromium, Edge и Brave. Сессия это фоновый процесс с браузером: команды идут к нему через локальный сокет, поэтому страница, куки, консоль и сетевые ошибки сохраняются между вызовами; `--session <имя>` даёт несколько независимых браузеров, простой 30 минут завершает сессию. Настройки в секции `browser` конфига: `executable`, `headless`, `profile`, `baseUrl`, `cacheDir`, `viewport`, `timeoutMs`, `idleMinutes`; те же значения задаются переменными `SBOX_BROWSER_EXECUTABLE`, `SBOX_BROWSER_HEADLESS`, `SBOX_BROWSER_PROFILE`, `SBOX_BROWSER_BASE_URL`, `SBOX_BROWSER_CACHE_DIR` (каталог инструмента: `SBOX_BROWSER_HOME`) и глобальными флагами `--profile`, `--session`, `--timeout`, `--cwd`. Все команды поддерживают `--json`, ошибки разбора аргументов тоже приходят в JSON-конверте. Профили и файлы состояния содержат секреты входа и живут в `~/.sbox/browser`, вне репозитория. Скилл `sbox-browser` лежит в `assets/skills` и копируется в папку хоста командой `sbox host install --target claude | codex`; агентам researcher, tester и verifier он подключается по `metadata.roles` (в Claude Code полем `skills`).
+
 ## Состояние
 
 Готово (этапы 1 и 2): конфиг и раскладка `.sbox/`, жизненный цикл изменения с гейтами, возвратами и бюджетом (`parked`), ревизия и lock `change.yaml`, пакеты и receipt запусков, приём отчётов с проверками (артефакты, дельты, задачи, защищённые тесты, дрейф change-set, disposition и `delivery_narrative` ревьюера), запечатывание change-set после реализации, адаптер spec-box, категории документации и структурный `doctor`, материалы для Claude Code, адаптеры сред Claude и Codex с надзором и одним транспортным повтором, `run`/`stop`/`watch`, адаптер GitHub с идемпотентной доставкой и каналом гейтов через комментарии, отчёты тестов jest/vitest/playwright и покрытие, шаблоны CI и Dockerfile.
@@ -78,4 +103,6 @@ sbox prompt show project-docs                 # промпт для заполн
 
 Готово также: wiki проекта в `.sbox/wiki/` (индекс страниц с `read_when` попадает в пакет каждой роли), метрики `sbox metrics` и оценка `sbox change rate`.
 
+Готово также: `sbox-browser` для проверки интерфейса (сессии с Chrome через `puppeteer-core`, необязательная установка браузера, вход человеком с постоянным профилем, снимок дерева доступности для агентов, перенос состояния входа), проверка браузера в `sbox doctor`.
+
 Не готово: дискавери и правила (этап 3), Arcadia и Codex-материалы для хоста (этап 4), межрепозиторный протокол (этап 5), роутер и дистилляция wiki (этап 6), продолжение сессий Codex, семантический `doctor --deep`.

package/assets/ci/Dockerfile

@@ -3,6 +3,8 @@ FROM node:22-bookworm-slim
 RUN apt-get update && apt-get install -y --no-install-recommends git ca-certificates && rm -rf /var/lib/apt/lists/*
 RUN npm install -g pnpm @spec-box/sdd
 # Codex CLI ставится отдельно, если нужен адаптер codex: npm install -g @openai/codex
+# Проверка интерфейса верификатором: RUN sbox-browser install --browser chrome-headless-shell
+# (в Debian/Ubuntu Chrome требует системные библиотеки: libnss3, libatk-bridge2.0-0, libgbm1, libasound2 и другие)
 WORKDIR /work
 ENV SBOX_HOME=/work/.sbox-runs
 ENTRYPOINT ["sbox"]

package/assets/hosts/claude/agent.md

@@ -0,0 +1,13 @@
+---
+name: sbox-{{role}}
+description: {{description}}
+tools: {{tools}}
+model: {{model}}
+effort: {{effort}}
+{{skills}}---
+
+Ты выполняешь роль {{role}} инструмента @spec-box/sdd. Во входном сообщении путь к JSON-пакету (`packet`). Прочитай пакет целиком: там цель, допущенные файлы, ограничения, правила проекта, инструкции к артефактам и путь `resultFile`.
+
+Порядок работы: прочитай пакет → выполни этапы роли ниже → запиши полный ответ (Markdown и завершающий блок `# sbox-result`) в файл `resultFile` из пакета → в сообщении верни только две строки: путь к resultFile и статус.
+
+{{body}}

package/assets/project/testing.md

@@ -17,6 +17,10 @@ verification: needs-review
 <!-- Узкий прогон одного файла, полный прогон, проверки типов и линтеров. Команды в обратных кавычках, например `pnpm test`.
      Обязательно опишите дымовой запуск: как поднять приложение или сервис локально (зависимости, порт) и какой URL или команда подтверждает, что оно работает. Верификатор запускает его, когда изменение добавляет модуль, маршрут или сборку. -->
 
+## Проверка интерфейса в браузере
+
+<!-- Если у продукта есть веб-интерфейс: базовый URL локального запуска (`browser.baseUrl` в .sbox/config.yaml), нужен ли вход и под каким профилем: человек входит один раз командой `sbox-browser login <url> --profile <имя>`, имя профиля укажите здесь и в `browser.profile`. Какие маршруты считать дымовыми для верификатора. Если интерфейса нет — «—». -->
+
 ## Отчёты
 
 <!-- Куда пишутся отчёты тестов (jest --json, playwright json) и как их получить в CI. -->

package/assets/roles/challenger.md

@@ -1,3 +1,7 @@
+---
+description: "Аудитор плана @spec-box/sdd. Вызывается только скиллом sbox-run."
+---
+
 # Роль: challenger (аудитор плана)
 
 ## Правила

package/assets/roles/distiller.md

@@ -1,3 +1,7 @@
+---
+description: "Дистиллятор знаний @spec-box/sdd."
+---
+
 # Роль: distiller (дистиллятор знаний)
 
 ## Правила

package/assets/roles/implementer.md

@@ -1,3 +1,7 @@
+---
+description: "Реализатор @spec-box/sdd: выполняет tasks.md, не трогая защищённые тесты. Вызывается только скиллом sbox-run."
+---
+
 # Роль: implementer (реализатор)
 
 ## Правила

package/assets/roles/planner.md

@@ -1,3 +1,7 @@
+---
+description: "Планировщик @spec-box/sdd: proposal, дельты спецификаций, design, tasks. Вызывается только скиллом sbox-run."
+---
+
 # Роль: planner (планировщик)
 
 ## Правила

package/assets/roles/researcher.md

@@ -1,3 +1,7 @@
+---
+description: "Исследователь @spec-box/sdd: Evidence Pack по изменению. Вызывается только скиллом sbox-run."
+---
+
 # Роль: researcher (исследователь)
 
 ## Правила
@@ -19,8 +23,9 @@
 2. Определи затронутые capability: `sbox spec list --json`, затем `sbox spec show <code> --json` для каждой релевантной.
 3. Найди ближайший аналог: существующую функциональность того же рода в этом проекте (похожая страница, команда, обработчик, модуль). Зафиксируй её файлы и структуру как образец для единообразия: новая функциональность должна повторять его, если нет причины отступить. Если в пакете есть страницы wiki с подходящим read_when, прочитай их первыми.
    Места подключения: выполни `git grep -l -F --untracked -- '<идентификатор аналога>'` и перечисли все файлы вне каталога аналога, где он упоминается. Это кандидаты в чеклист регистрации нового модуля: по каждому файлу отметь, нужна ли там регистрация для этой задачи и почему. Регистрация в конфигах, сборке и навигации обычно не проверяется компиляцией, поэтому её пропуск проявляется только при запуске.
-4. Проследи критический путь в коде: точка входа и вызывающий код, преобразование данных и состояния, границы и интерфейсы, побочные эффекты и ошибки, тесты, которые покрывают текущее поведение.
-5. Запиши Evidence Pack в `evidence/research.md` с разделами:
+4. Если запрос касается веб-интерфейса и `testing.md` описывает запуск приложения, посмотри текущее поведение глазами пользователя: `sbox-browser goto <url>`, `snapshot`, `text`; зафиксируй тексты, элементы и маршруты как факты с пометкой «наблюдение в браузере».
+5. Проследи критический путь в коде: точка входа и вызывающий код, преобразование данных и состояния, границы и интерфейсы, побочные эффекты и ошибки, тесты, которые покрывают текущее поведение.
+6. Запиши Evidence Pack в `evidence/research.md` с разделами:
    - **Цель и критерий готовности** — нормализованная формулировка запроса;
    - **Текущее поведение** — как работает сейчас, с путями;
    - **Затронутые capability** — идентификаторы и требования, которые изменятся;
@@ -30,7 +35,7 @@
    - **Ограничения и паттерны** — правила проекта и решения, которые нужно сохранить;
    - **Поверхности изменения и проверки** — где вероятно править и чем проверять, без выбора дизайна;
    - **Допущения и пробелы** — что не удалось подтвердить.
-6. Если пробел меняет объём или контракт и не закрывается кодом, верни статус «заблокировано» с категорией «пользователь» и точным вопросом.
+7. Если пробел меняет объём или контракт и не закрывается кодом, верни статус «заблокировано» с категорией «пользователь» и точным вопросом.
 
 ## Бюджет
 

package/assets/roles/reviewer.md

@@ -1,3 +1,7 @@
+---
+description: "Ревьюер @spec-box/sdd: тесты против спецификаций, код против артефактов. Вызывается только скиллом sbox-run."
+---
+
 # Роль: reviewer (ревьюер)
 
 ## Правила

package/assets/roles/tester.md

@@ -1,3 +1,7 @@
+---
+description: "Тестировщик @spec-box/sdd: тесты по сценариям до реализации. Вызывается только скиллом sbox-run."
+---
+
 # Роль: tester (тестировщик)
 
 ## Правила
@@ -15,7 +19,7 @@
 
 ## Этапы
 
-1. Прочитай дельты, `design.md` и `testing.md`. Составь список всех утверждений из секций added и modified.
+1. Прочитай дельты, `design.md` и `testing.md`. Составь список всех утверждений из секций added и modified. Чтобы увидеть текущий интерфейс и точные тексты, роли и идентификаторы элементов, открой страницу через `sbox-browser goto <url>` и `sbox-browser snapshot`; сами тесты пиши на инструментах проекта из `testing.md`, а не на `sbox-browser`.
 2. Для каждого утверждения выбери уровень по `testing.md` и напиши тест. Если утверждение нельзя автоматизировать, зафиксируй причину.
 3. Заполни `coverage.yaml` по инструкции `sbox instructions coverage --change <id> --json`.
 4. Если есть утверждения с пометкой manual или конфиг требует план всегда, заполни `test-plan.md`.

package/assets/roles/verifier.md

@@ -1,3 +1,7 @@
+---
+description: "Верификатор @spec-box/sdd: полнота, корректность, согласованность. Вызывается только скиллом sbox-run."
+---
+
 # Роль: verifier (верификатор)
 
 ## Правила
@@ -18,7 +22,7 @@
 2. **Полнота.** Все задачи `tasks.md` отмечены (`sbox status --json`). Каждое утверждение из дельт имеет реализацию: найди код по ключевым словам утверждения и `design.md`.
 3. **Корректность.** Запусти тесты из `coverage.yaml` и полные проверки из `testing.md` (тесты, типы, линтеры); прочитай отчёты. Каждый сценарий покрыт зелёным тестом либо пометкой manual в coverage. Проверь ближайший неверный вариант реализации, если это дёшево: тест должен различать правильную и неправильную ветку.
 4. **Согласованность.** Решения из `design.md` видны в коде; правила проекта соблюдены; паттерны проекта не нарушены. Если в пакете есть `wiring` (образец объявлен в `design.md`), рассмотри каждый файл из его `gaps`: нужна ли там регистрация нового модуля. Нужна и её нет — пункт FAIL с путём; не нужна, потому что файл относится к другому контексту образца — пункт PASS с обоснованием и путём. Файлы, которые ты не рассмотрел, CLI добавит в отчёт как PARTIAL для ревьюера.
-5. **Запуск.** Сборка и статические проверки не доказывают, что изменение работает в запущенной системе. Если `testing.md` описывает, как запустить приложение или сервис (команда запуска, порт, зависимости вроде базы в контейнере), запусти его и проверь доступность затронутого маршрута или страницы (`curl`, код ответа, ключевые строки ответа), затем останови процесс. Пробел (gap) допустим только когда запуск в этой среде невозможен по причине, которую ты назвал и попытался устранить, а не потому, что это долго.
+5. **Запуск.** Сборка и статические проверки не доказывают, что изменение работает в запущенной системе. Если `testing.md` описывает, как запустить приложение или сервис (команда запуска, порт, зависимости вроде базы в контейнере), запусти его и проверь затронутый маршрут или страницу, затем останови процесс. Для API достаточно `curl` (код ответа, ключевые строки). Для веб-интерфейса используй `sbox-browser`: `goto <url>`, `snapshot` (дерево элементов со ссылками `[eN]`), действия `click`, `fill`, `wait`, чтение `text`, затем `console --errors` и `requests`: ошибки в консоли и ответы 4xx/5xx на затронутой странице это FAIL, а не примечание. Скриншот (`screenshot`) прикладывай как доказательство к пункту. Если страница требует входа, профиль указан в `testing.md` или в `browser.profile` конфига (человек входит один раз командой `sbox-browser login`); без профиля это пробел (gap) с окружением «вход в приложение». Пробел (gap) допустим только когда запуск в этой среде невозможен по причине, которую ты назвал и попытался устранить, а не потому, что это долго.
 6. Составь отчёт:
 
 ```markdown

package/assets/skills/sbox-approve.md

@@ -0,0 +1,11 @@
+---
+name: sbox-approve
+description: Утвердить или отклонить гейт изменения @spec-box/sdd (proposal, plan, tests). Используй, когда пользователь говорит «утверждаю», «одобряю план», «отклоняю с замечанием».
+---
+
+# sbox-approve
+
+1. Определи изменение и гейт: `sbox status --change <id> --json` показывает ожидающий гейт.
+2. Утверждение: `sbox approve <gate> --change <id> --by <user> [--comment "..."] [--answer Q1=B]`.
+3. Отклонение: `sbox reject <gate> --change <id> --by <user> --comment "<замечание>"`.
+4. Покажи результат и предложи продолжить скиллом sbox-run.

package/assets/skills/sbox-browser.md

@@ -0,0 +1,31 @@
+---
+name: sbox-browser
+description: Проверка веб-интерфейса через управляемый Chrome командой sbox-browser — открыть страницу, снять дерево элементов, кликать и вводить, читать текст, консоль и сетевые ошибки, делать скриншоты; вход в приложение выполняет человек. Используй, когда нужно проверить страницу или сценарий в браузере, посмотреть, что видит пользователь, или собрать доказательства для верификации.
+metadata:
+  roles: [researcher, tester, verifier]
+---
+
+# sbox-browser
+
+Управляемый Chrome для проверки интерфейса. Первая команда сама поднимает сессию (headless), она живёт между вызовами: страница, куки, консоль и сетевые ошибки сохраняются. Все команды поддерживают `--json`; ошибки приходят с кодами `BROWSER_*` и подсказкой, что делать.
+
+## Порядок работы
+
+1. Один раз `sbox-browser doctor`: какой браузер и профиль будут использованы. Браузера нет → предложи человеку `sbox-browser install` или путь в `browser.executable` конфига; сам не устанавливай без просьбы.
+2. `sbox-browser goto <url>`; относительный путь считается от `browser.baseUrl`.
+3. `sbox-browser snapshot` даёт дерево элементов со ссылками `[eN]`. Действуй по ним: `click e3`, `fill e5 "текст"`, `press Enter`, `select e7 значение`, `check e2`. После изменения страницы снимай snapshot заново: ссылки нумеруются при каждом снимке, старая ссылка даёт `BROWSER_REF_STALE`.
+4. Проверяй результат: `wait --text "…"` или `wait --url '*/orders*'`, затем `text`, `exists`, `value`.
+5. Собирай доказательства: `console --errors`, `requests` (ответы 4xx/5xx и неудачные запросы), `screenshot` (путь к PNG печатается). Ошибки консоли и ответы 4xx/5xx на проверяемой странице это дефект, а не примечание.
+6. В конце `sbox-browser stop`, если сессия больше не нужна; иначе она завершится по простою.
+
+## Селекторы
+
+CSS по умолчанию; `text=Войти`, `aria=Сохранить`, `xpath=//button`. Предпочитай ссылки `[eN]` из снимка: они не зависят от вёрстки.
+
+## Вход в приложение
+
+Пароли, коды и токены не вводи и не спрашивай. Если страница требует входа, попроси человека выполнить `sbox-browser login <url> --profile <имя>`: откроется окно браузера, он войдёт сам и нажмёт Enter в терминале, затем `sbox-browser stop`. После этого команды с глобальным флагом `--profile <имя>` перед командой (`sbox-browser --profile <имя> goto <url>`) или с `browser.profile` в конфиге работают под входом без окна. В CI вход переносится файлом: `sbox-browser state load auth.json` из секрета.
+
+## Полезное
+
+`status`, `sessions`, `--session <имя>` для второго браузера; `pages`, `page new | switch | close`; `back`, `reload`; `html`, `attr`, `count`, `eval "<js>"`; `cookies list | set | clear`; `dialog accept | dismiss`; `viewport 375x812` для мобильной ширины; глобальный `--timeout <мс>` для медленных страниц. Полная справка: `sbox-browser --help`.

package/assets/skills/sbox-run.md

@@ -0,0 +1,24 @@
+---
+name: sbox-run
+description: Выполнить следующий шаг изменения @spec-box/sdd — запросить пакет у CLI, выполнить роль субагентом и сдать отчёт. Используй, когда пользователь просит продвинуть изменение, запустить sbox, выполнить следующий шаг.
+metadata:
+  hosts: [claude]
+---
+
+# sbox-run
+
+Ты оркестратор: не исследуешь проект и не решаешь задачу сам. Роли выполняют субагенты `sbox-<role>`.
+
+1. Определи изменение: из аргумента, из контекста или `sbox change list --json`. Если активных изменений несколько и не ясно, какое брать, спроси пользователя.
+2. Запроси следующий шаг: `sbox next --change <id> --brief --json`. Никогда не запрашивай `next` без `--brief` и не читай packet.json сам: пакет нужен субагенту, а не тебе.
+3. По полю `kind` ответа:
+   - `role`: если субагент этой роли уже запускался в этой сессии, продолжи его тем же сообщением через SendMessage (он помнит проект и артефакты, повторное чтение не нужно); иначе запусти нового субагента `sbox-<role>`. Сообщение: `packet: <path из поля packetFile>`. Дождись ответа. Затем сдай отчёт: `sbox report --change <id> --role <role> --json`. Ответ `report` уже содержит статус и диагностику: не читай result.md и evidence целиком, покажи пользователю только строку статуса и ошибки. Если CLI вернул ошибки (например, не создан артефакт или изменены защищённые файлы), передай их тому же субагенту одним сообщением и повтори отчёт; не больше двух повторов.
+   - `gate`: покажи пользователю пути артефактов из ответа и спроси: «Утвердить <gate>? Ответьте «да» или замечанием». «да» → `sbox approve <gate> --change <id> --by <user>`; замечание → `sbox reject <gate> --change <id> --comment "<текст>"`. Мелкие правки формулировок пользователь может внести в артефакт сам и ответить «да»: отклонение запускает цикл доработки роли. Затем вернись к шагу 2.
+   - `deliver`: покажи чеклист `sbox deliver --change <id> --check` и предложи доставку `sbox deliver --change <id>` (архив, коммит, push, пул-реквест). Не запускай доставку без просьбы пользователя.
+   - `wait`: покажи статус и блокер, спроси пользователя, что делать.
+   - `done`: сообщи об окончании.
+4. Повторяй шаги 2–3, пока не встретишь gate, wait, deliver или done. Не запускай субагентов параллельно.
+
+Полезные команды: `sbox status --change <id>` (состояние, change-set, привязка ревью), `sbox changeset show` (запечатанный диф и дрейф), `sbox coverage --report jest=<path>` (покрытие утверждений тестами), `sbox change resume --returns N` (продолжить после parked).
+
+Экономия контекста: не читай артефакты изменения (design.md, спецификации, отчёты) целиком; тебе нужны только ответы CLI. Запрещено: переформулировать задачу пользователя, редактировать артефакты, вызывать роли напрямую в обход пакета, менять код.

package/bin/sbox-browser.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import('../dist/browser/cli.js').then((m) => m.main(process.argv)).catch((err) => {
+  console.error(err instanceof Error ? err.message : String(err));
+  process.exit(1);
+});

package/dist/adapters/host/claude/index.js

@@ -1,43 +1,25 @@
 import path from 'node:path';
-import { loadRoleText } from '../../../core/roles.js';
+import { loadRoleDescription, loadRoleText } from '../../../core/roles.js';
 import { ROLES } from '../../../core/phases.js';
-import { defaultHostModel } from '../../../core/runner.js';
-import { writeText } from '../../../core/paths.js';
+import { defaultHostModel, READ_ONLY_ROLES } from '../../../core/runner.js';
+import { loadSkills, skillsForRole } from '../../../core/skills.js';
+import { assetsDir, readText, writeText } from '../../../core/paths.js';
+import { configSchema } from '../../../core/config.js';
 const AGENT_ROLES = ['researcher', 'planner', 'tester', 'implementer', 'reviewer', 'verifier', 'challenger'];
-const TOOLS = {
-    researcher: 'Read, Grep, Glob, Bash',
-    planner: 'Read, Write, Edit, Grep, Glob, Bash',
-    challenger: 'Read, Grep, Glob, Bash',
-    tester: 'Read, Write, Edit, Grep, Glob, Bash',
-    implementer: 'Read, Write, Edit, Grep, Glob, Bash',
-    reviewer: 'Read, Grep, Glob, Bash',
-    verifier: 'Read, Grep, Glob, Bash',
-    distiller: 'Read, Write, Edit, Grep, Glob',
-};
-const DESCRIPTIONS = {
-    researcher: 'Исследователь @spec-box/sdd: Evidence Pack по изменению. Вызывается только скиллом sbox-run.',
-    planner: 'Планировщик @spec-box/sdd: proposal, дельты спецификаций, design, tasks. Вызывается только скиллом sbox-run.',
-    challenger: 'Аудитор плана @spec-box/sdd. Вызывается только скиллом sbox-run.',
-    tester: 'Тестировщик @spec-box/sdd: тесты по сценариям до реализации. Вызывается только скиллом sbox-run.',
-    implementer: 'Реализатор @spec-box/sdd: выполняет tasks.md, не трогая защищённые тесты. Вызывается только скиллом sbox-run.',
-    reviewer: 'Ревьюер @spec-box/sdd: тесты против спецификаций, код против артефактов. Вызывается только скиллом sbox-run.',
-    verifier: 'Верификатор @spec-box/sdd: полнота, корректность, согласованность. Вызывается только скиллом sbox-run.',
-    distiller: 'Дистиллятор знаний @spec-box/sdd.',
-};
-/** Материалы для Claude Code: тонкий скилл-оркестратор и по агенту на роль (docs/design.md, раздел 11). */
-export function installClaudeMaterials(root, config) {
+/**
+ * Агенты Claude Code по одному на роль. Текст агента это шаблон assets/hosts/claude/agent.md с данными роли:
+ * описание из фронтматтера файла роли, инструменты из runner.claude конфига (как в headless-режиме),
+ * скиллы из metadata.roles полем skills (субагенты не видят скиллы проекта сами).
+ */
+export function installClaudeAgents(root, config, skills = loadSkills(root)) {
     const written = [];
-    const skill = path.join(root, '.claude', 'skills', 'sbox-run', 'SKILL.md');
-    writeText(skill, RUN_SKILL);
-    written.push(skill);
-    const approve = path.join(root, '.claude', 'skills', 'sbox-approve', 'SKILL.md');
-    writeText(approve, APPROVE_SKILL);
-    written.push(approve);
+    const cfg = config ?? configSchema.parse({ version: 1, spec: { adapter: 'spec-box' } });
+    const template = readText(path.join(assetsDir(), 'hosts', 'claude', 'agent.md'));
     for (const role of ROLES) {
         if (!AGENT_ROLES.includes(role))
             continue;
         const file = path.join(root, '.claude', 'agents', `sbox-${role}.md`);
-        writeText(file, agentFile(root, role, config?.runner.models[role], config?.runner.efforts[role] ?? config?.runner.defaultEffort ?? 'medium'));
+        writeText(file, agentFile(template, root, role, cfg, skillsForRole(skills, role)));
         written.push(file);
     }
     return written;
@@ -55,58 +37,18 @@ function agentModel(configured) {
         return 'haiku';
     return configured;
 }
-function agentFile(root, role, configuredModel, effort = 'medium') {
-    const body = loadRoleText(root, role);
-    const model = agentModel(configuredModel) ?? defaultHostModel(role);
-    // Без явного effort субагент наследует усилие сессии (в пилоте это был xhigh на каждом ходе).
-    return `---
-name: sbox-${role}
-description: ${DESCRIPTIONS[role]}
-tools: ${TOOLS[role]}
-model: ${model}
-effort: ${effort}
----
-
-Ты выполняешь роль ${role} инструмента @spec-box/sdd. Во входном сообщении путь к JSON-пакету (\`packet\`). Прочитай пакет целиком: там цель, допущенные файлы, ограничения, правила проекта, инструкции к артефактам и путь \`resultFile\`.
-
-Порядок работы: прочитай пакет → выполни этапы роли ниже → запиши полный ответ (Markdown и завершающий блок \`# sbox-result\`) в файл \`resultFile\` из пакета → в сообщении верни только две строки: путь к resultFile и статус.
-
-${body.trim()}
-`;
+function agentFile(template, root, role, config, skills) {
+    const tools = (READ_ONLY_ROLES.has(role) ? config.runner.claude.readOnlyTools : config.runner.claude.allowedTools).join(', ');
+    const values = {
+        role,
+        description: JSON.stringify(loadRoleDescription(root, role)),
+        tools,
+        model: agentModel(config.runner.models[role]) ?? defaultHostModel(role),
+        // Без явного effort субагент наследует усилие сессии (в пилоте это был xhigh на каждом ходе).
+        effort: config.runner.efforts[role] ?? config.runner.defaultEffort,
+        skills: skills.length ? `skills:\n${skills.map((s) => `  - ${s}`).join('\n')}\n` : '',
+        body: loadRoleText(root, role).trim(),
+    };
+    return template.replace(/\{\{(\w+)\}\}/g, (_, key) => values[key] ?? '');
 }
-const RUN_SKILL = `---
-name: sbox-run
-description: Выполнить следующий шаг изменения @spec-box/sdd — запросить пакет у CLI, выполнить роль субагентом и сдать отчёт. Используй, когда пользователь просит продвинуть изменение, запустить sbox, выполнить следующий шаг.
----
-
-# sbox-run
-
-Ты оркестратор: не исследуешь проект и не решаешь задачу сам. Роли выполняют субагенты \`sbox-<role>\`.
-
-1. Определи изменение: из аргумента, из контекста или \`sbox change list --json\`. Если активных изменений несколько и не ясно, какое брать, спроси пользователя.
-2. Запроси следующий шаг: \`sbox next --change <id> --brief --json\`. Никогда не запрашивай \`next\` без \`--brief\` и не читай packet.json сам: пакет нужен субагенту, а не тебе.
-3. По полю \`kind\` ответа:
-   - \`role\`: если субагент этой роли уже запускался в этой сессии, продолжи его тем же сообщением через SendMessage (он помнит проект и артефакты, повторное чтение не нужно); иначе запусти нового субагента \`sbox-<role>\`. Сообщение: \`packet: <path из поля packetFile>\`. Дождись ответа. Затем сдай отчёт: \`sbox report --change <id> --role <role> --json\`. Ответ \`report\` уже содержит статус и диагностику: не читай result.md и evidence целиком, покажи пользователю только строку статуса и ошибки. Если CLI вернул ошибки (например, не создан артефакт или изменены защищённые файлы), передай их тому же субагенту одним сообщением и повтори отчёт; не больше двух повторов.
-   - \`gate\`: покажи пользователю пути артефактов из ответа и спроси: «Утвердить <gate>? Ответьте «да» или замечанием». «да» → \`sbox approve <gate> --change <id> --by <user>\`; замечание → \`sbox reject <gate> --change <id> --comment "<текст>"\`. Мелкие правки формулировок пользователь может внести в артефакт сам и ответить «да»: отклонение запускает цикл доработки роли. Затем вернись к шагу 2.
-   - \`deliver\`: покажи чеклист \`sbox deliver --change <id> --check\` и предложи доставку \`sbox deliver --change <id>\` (архив, коммит, push, пул-реквест). Не запускай доставку без просьбы пользователя.
-   - \`wait\`: покажи статус и блокер, спроси пользователя, что делать.
-   - \`done\`: сообщи об окончании.
-4. Повторяй шаги 2–3, пока не встретишь gate, wait, deliver или done. Не запускай субагентов параллельно.
-
-Полезные команды: \`sbox status --change <id>\` (состояние, change-set, привязка ревью), \`sbox changeset show\` (запечатанный диф и дрейф), \`sbox coverage --report jest=<path>\` (покрытие утверждений тестами), \`sbox change resume --returns N\` (продолжить после parked).
-
-Экономия контекста: не читай артефакты изменения (design.md, спецификации, отчёты) целиком; тебе нужны только ответы CLI. Запрещено: переформулировать задачу пользователя, редактировать артефакты, вызывать роли напрямую в обход пакета, менять код.
-`;
-const APPROVE_SKILL = `---
-name: sbox-approve
-description: Утвердить или отклонить гейт изменения @spec-box/sdd (proposal, plan, tests). Используй, когда пользователь говорит «утверждаю», «одобряю план», «отклоняю с замечанием».
----
-
-# sbox-approve
-
-1. Определи изменение и гейт: \`sbox status --change <id> --json\` показывает ожидающий гейт.
-2. Утверждение: \`sbox approve <gate> --change <id> --by <user> [--comment "..."] [--answer Q1=B]\`.
-3. Отклонение: \`sbox reject <gate> --change <id> --by <user> --comment "<замечание>"\`.
-4. Покажи результат и предложи продолжить скиллом sbox-run.
-`;
 //# sourceMappingURL=index.js.map

package/dist/adapters/host/claude/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/host/claude/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/host/claude/index.ts"],"names":[],"mappings":"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"}

package/dist/adapters/host/index.js

@@ -0,0 +1,25 @@
+import { SboxError } from '../../core/errors.js';
+import { loadSkills } from '../../core/skills.js';
+import { installClaudeAgents } from './claude/index.js';
+import { HOST_TARGETS, installSkills, isHostTarget } from './skills.js';
+/** Материалы хоста: скиллы из единого источника для любого хоста плюс агенты, если адаптер хоста их умеет. */
+export function installHostMaterials(root, target, config) {
+    if (!isHostTarget(target))
+        throw new SboxError('HOST_UNKNOWN', `Неизвестный хост ${target}; доступны ${HOST_TARGETS.join(' и ')}.`);
+    const skills = loadSkills(root);
+    const files = installSkills(root, target, skills);
+    const notes = [];
+    let next;
+    switch (target) {
+        case 'claude':
+            files.push(...installClaudeAgents(root, config, skills));
+            next = 'В Claude Code: `/sbox-run` после `sbox change new <id> --title "..." --request "..."`.';
+            break;
+        case 'codex':
+            notes.push('Для Codex установлены скиллы sbox-approve и sbox-browser в .agents/skills; оркестратор sbox-run, агенты ролей и раздел AGENTS.md для Codex появятся на этапе 4 плана.');
+            next = 'В Codex: скиллы из .agents/skills доступны сразу; изменения пока ведутся из Claude Code или командами `sbox next` и `sbox report` вручную.';
+            break;
+    }
+    return { target, files, notes, next };
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/host/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/host/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAmB,MAAM,aAAa,CAAC;AAUzF,8GAA8G;AAC9G,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,MAAc,EAAE,MAAe;IAChF,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,cAAc,EAAE,oBAAoB,MAAM,cAAc,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpI,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAY,CAAC;IACjB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ;YACX,KAAK,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YACzD,IAAI,GAAG,wFAAwF,CAAC;YAChG,MAAM;QACR,KAAK,OAAO;YACV,KAAK,CAAC,IAAI,CAAC,uKAAuK,CAAC,CAAC;YACpL,IAAI,GAAG,4IAA4I,CAAC;YACpJ,MAAM;IACV,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACxC,CAAC"}

package/dist/adapters/host/skills.js

@@ -0,0 +1,27 @@
+import path from 'node:path';
+import { loadSkills, skillsForHost } from '../../core/skills.js';
+import { writeText } from '../../core/paths.js';
+/**
+ * Где хост читает скиллы проекта. Claude Code: .claude/skills/<имя>/SKILL.md.
+ * Codex: .agents/skills/<имя>/SKILL.md (Agent Skills; пользовательские ~/.agents/skills и ~/.codex/skills инструмент не трогает).
+ * Новый хост это новая строка здесь.
+ */
+export const SKILL_LAYOUT = {
+    claude: (name) => path.join('.claude', 'skills', name, 'SKILL.md'),
+    codex: (name) => path.join('.agents', 'skills', name, 'SKILL.md'),
+};
+export const HOST_TARGETS = Object.keys(SKILL_LAYOUT);
+export function isHostTarget(value) {
+    return Object.hasOwn(SKILL_LAYOUT, value);
+}
+/** Копирует скиллы из единого источника (assets/skills и .sbox/skills), применимые к хосту, в его раскладку без изменений текста. */
+export function installSkills(root, target, skills = loadSkills(root)) {
+    const written = [];
+    for (const skill of skillsForHost(skills, target)) {
+        const file = path.join(root, SKILL_LAYOUT[target](skill.name));
+        writeText(file, skill.text);
+        written.push(file);
+    }
+    return written;
+}
+//# sourceMappingURL=skills.js.map

package/dist/adapters/host/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../src/adapters/host/skills.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,aAAa,EAAwB,MAAM,sBAAsB,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC;IAC1E,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC;CACjE,CAAC;AAIX,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAiB,CAAC;AAEtE,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED,qIAAqI;AACrI,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,MAAkB,EAAE,MAAM,GAAsB,UAAU,CAAC,IAAI,CAAC;IAC1G,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/D,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}