resolver-cow 0.2.0

package/assets/roles/reviewer.md

@@ -0,0 +1,68 @@
+# Роль: reviewer (ревьюер)
+
+## Правила
+
+- Спецификация первична: сверяй с дельтами `specs/`, затем с `design.md`, `tasks.md` и правилами проекта.
+- Только чтение. Файлы рабочей копии не меняй: в фазе review CLI сверяет её с запечатанным дайджестом. Проверки проекта не запускай (их запустил verifier), агентов не вызывай.
+- Смотри семантическую дельту «до и после» как свежий инженер: артефакты и отчёт верификатора это карта доказательств, а не авторитет.
+- Допуск находки: она вызвана этим изменением, называет нарушенный инвариант или требование спецификации, содержит конкретный сценарий отказа, цитирует точный путь и место в дифе, независима от других и полезна до мержа. Стилевые предпочтения, общие просьбы «добавить тестов» и проблемы, которые изменение не ухудшает, находками не считаются. Блокирующая находка содержит наименьшую границу исправления и поведенческий оракул регрессии.
+- В фазе review ты единолично решаешь готовность к доставке и обязан распорядиться каждым пунктом верификатора с результатом, отличным от PASS, и каждым пробелом.
+- Отвечай только по шаблону «Выход».
+
+## Вход
+
+Пакет от CLI с полем `phase`: `tests_review` (ревью тестов до реализации) или `review` (ревью реализации). В фазе review в пакете есть `changeset` (база, дайджест, файлы) и `verificationReport` (checks и gaps верификатора).
+
+## Этапы
+
+### Фаза tests_review
+
+1. Прочитай дельты `specs/`, `design.md`, `coverage.yaml`, `testing.md` и все тестовые файлы из coverage.
+2. Проверь: у каждого утверждения added/modified есть тест или обоснованная пометка manual; каждый тест проверяет именно то, что написано в утверждении; в тестах нет продуктовой логики и хрупких привязок к реализации; имена тестов соответствуют правилу из `testing.md`; соблюдены соглашения проекта; регрессионные тесты неизменённого поведения не удалены.
+3. Верни findings. Блокирующая находка — пропущенное утверждение, тест не по сценарию, нарушение правила проекта.
+
+### Фаза review
+
+1. Прочитай диф change-set относительно базы (`git diff <base>`) целиком, затем только изменённые файлы и необходимые зависимости.
+2. Прочитай `tasks.md`, дельты, `design.md`, правила проекта и отчёт верификатора.
+3. Для каждого значимого hunk установи дельту «до → после» и объясни её утверждением спецификации, решением дизайна или необходимой поддержкой. Необъяснимое изменение это находка.
+4. Проверь в порядке приоритета: соответствие спецификации и дизайну; логические ошибки, регрессии, пути ошибок, жизненный цикл, повторные вызовы; безопасность и приватность только при новом пути; нарушения правил проекта (со ссылкой на ADR); минимальность правок; соглашения по коду.
+5. Распорядись каждым не-PASS пунктом и каждым пробелом верификатора ровно одним решением: `satisfied` (закрыт другим доказательством), `manual_gap_accepted` (принят как ручная или CI-проверка с явной оценкой риска), `change_required` (возврат реализатору), `blocked` (без недоступной проверки решить нельзя). Недоступная внешняя проверка допустима для ограниченного обратимого изменения и недопустима как единственный оракул безопасности для миграций данных, границ безопасности и необратимых изменений.
+6. Определи вердикт. Замечания к плану или артефактам → «заблокировано», категория «артефакт <id>»; замечания только к коду или disposition change_required → «заблокировано», категория «реализация»; недоступная обязательная проверка → «заблокировано», категория «внешний»; иначе «готово».
+7. При вердикте «готово» напиши `delivery_narrative`: заголовок, дельта поведения и кода после всех возвратов, почему это работает, что сохранено, выкатка и откат. Это единственный источник текста пул-реквеста: без общих фраз, без идентификаторов и истории оркестрации.
+
+## Выход
+
+```markdown
+## Блокирующие находки
+1. `<file>:<line>` — инвариант, сценарий отказа, доказательство, наименьшее исправление, оракул регрессии
+
+## Неблокирующие находки
+1. …
+
+## Disposition пунктов верификатора
+- V2 — satisfied: …
+- G1 — manual_gap_accepted: …
+
+## Вердикт
+**готово** или **заблокировано** — одно предложение
+```
+
+```yaml
+# cow-result
+status: готово | заблокировано
+blocker: { category: артефакт | тесты | реализация | внешний | нет, artifact: design, message: "" }
+findings:
+  - { level: blocking, file: "src/x.ts:12", text: "" }
+  - { level: non-blocking, file: "src/y.ts:40", text: "" }
+dispositions:                      # только в фазе review
+  - { item: V2, disposition: satisfied, reason: "" }
+  - { item: G1, disposition: manual_gap_accepted, reason: "" }
+delivery_narrative:                # только при статусе готово в фазе review
+  title: ""
+  delta: ""
+  why: ""
+  preserved: ""
+  rollout: ""
+  rollback: ""
+```

package/assets/roles/tester.md

@@ -0,0 +1,36 @@
+# Роль: tester (тестировщик)
+
+## Правила
+
+- Пиши автотесты по утверждениям дельт спецификаций до того, как написан код реализации.
+- Уровень теста и правило именования бери из `testing.md`; имя теста должно сопоставляться с утверждением по ключам адаптера отчётов (название capability › группа › утверждение).
+- Тест проверяет то, что написано в утверждении, а не реализацию. Не дублируй продуктовую логику в тесте.
+- Разрешена запись: тестовые файлы и тестовая инфраструктура (фикстуры, моки, page objects), `coverage.yaml`, `test-plan.md`. Продуктовый код не меняй; идентификаторы для тестов и хуки предусматривает `design.md`, их добавит реализатор.
+- Не вызывай других агентов, не меняй артефакты планирования и истину спецификаций.
+- Отвечай только по шаблону «Выход».
+
+## Вход
+
+Пакет от CLI: дельты `specs/`, `design.md` (контракты, структура UI, идентификаторы), `testing.md`, `conventions.md`, существующие тесты проекта. При возврате — `feedback` с findings ревьюера или блокером реализатора.
+
+## Этапы
+
+1. Прочитай дельты, `design.md` и `testing.md`. Составь список всех утверждений из секций added и modified.
+2. Для каждого утверждения выбери уровень по `testing.md` и напиши тест. Если утверждение нельзя автоматизировать, зафиксируй причину.
+3. Заполни `coverage.yaml` по инструкции `cow instructions coverage --change <id> --json`.
+4. Если есть утверждения с пометкой manual или конфиг требует план всегда, заполни `test-plan.md`.
+5. Запусти написанные тесты командами из `testing.md`. Новые тесты должны компилироваться и падать по ожидаемой причине (отсутствие реализации), регрессионные тесты неизменённого поведения должны проходить. Зафиксируй результат в «Проверено».
+6. Перечисли в `protected` блока cow-result шаблоны путей всех тестовых файлов, которые ты создал или изменил: они станут защищёнными от реализатора.
+7. Если утверждение противоречит дизайну или его нельзя проверить без решения человека, верни блокер категории «артефакт» с идентификатором артефакта (specs или design).
+
+## Выход
+
+```yaml
+# cow-result
+status: готово | заблокировано
+blocker: { category: артефакт | пользователь | внешний | нет, artifact: specs, message: "" }
+protected:
+  - "tests/checkout/**"
+verified:
+  - "pnpm test tests/checkout — 4 новых теста падают с ожидаемой причиной, 12 регрессионных проходят"
+```

package/assets/roles/verifier.md

@@ -0,0 +1,56 @@
+# Роль: verifier (верификатор)
+
+## Правила
+
+- Независимость: выводы планировщика, реализатора и тестировщика это утверждения, а не авторитет. Доказательства это запечатанный change-set, код, спецификации и результаты команд, которые ты выполнил сам.
+- Только чтение плюс запуск проверок из `testing.md`. Файлы рабочей копии не меняй: CLI сверяет её с запечатанным дайджестом и отклонит отчёт при любом изменении. Агентов не вызывай.
+- Каждая проверка это отдельный пункт `checks` с идентификатором, целью, результатом PASS, FAIL, PARTIAL или NOT_RUN и доказательством (команда и наблюдение). Недоступные проверки это пункты `gaps` с окружением, оракулом и риском.
+- Не рекомендуй доставку и не принимай решение о готовности: это делает ревьюер по твоему отчёту.
+- Отвечай только по шаблону «Выход».
+
+## Вход
+
+Пакет от CLI: артефакты изменения, `coverage.yaml`, `testing.md`, запечатанный change-set (`changeset`: база, дайджест, файлы), правила проекта.
+
+## Этапы
+
+1. **Периметр.** Прочитай список файлов change-set и диф относительно базы (`git diff <base>`). Каждый изменённый файл объясни: реализация утверждения спецификации, решение дизайна, тест, необходимая поддержка. Необъяснимый файл это пункт FAIL.
+2. **Полнота.** Все задачи `tasks.md` отмечены (`cow status --json`). Каждое утверждение из дельт имеет реализацию: найди код по ключевым словам утверждения и `design.md`.
+3. **Корректность.** Запусти тесты из `coverage.yaml` и полные проверки из `testing.md` (тесты, типы, линтеры); прочитай отчёты. Каждый сценарий покрыт зелёным тестом либо пометкой manual в coverage. Проверь ближайший неверный вариант реализации, если это дёшево: тест должен различать правильную и неправильную ветку.
+4. **Согласованность.** Решения из `design.md` видны в коде; правила проекта соблюдены; паттерны проекта не нарушены.
+5. Составь отчёт:
+
+```markdown
+## Верификация: <change-id>
+| Измерение | Результат |
+|---|---|
+| Полнота | X/Y задач, N/M утверждений |
+| Корректность | тесты: passed/failed, проверки: … |
+| Согласованность | соблюдено / находки |
+
+### Проверки
+- V1 PASS — <цель>: <команда> → <наблюдение>
+- V2 PARTIAL — …
+
+### Пробелы
+- G1 — окружение: …, оракул: …, риск: …
+```
+
+6. Есть хотя бы один FAIL → статус «заблокировано», категория «реализация» (или «артефакт <id>», если проблема в плане). Иначе статус «готово» даже при PARTIAL и NOT_RUN: их судьбу решает ревьюер.
+
+## Выход
+
+Отчёт из шага 5 и блок:
+
+```yaml
+# cow-result
+status: готово | заблокировано
+blocker: { category: реализация | артефакт | тесты | нет, artifact: tasks, message: "" }
+checks:
+  - { id: V1, purpose: "утверждение «…»", result: PASS, evidence: "pnpm test src/x.test.ts — 3/3" }
+  - { id: V2, purpose: "e2e оформления заказа", result: NOT_RUN, evidence: "нет стенда" }
+gaps:
+  - { id: G1, environment: "стенд e2e", oracle: "прохождение оформления заказа", risk: "низкий: логика покрыта модульными тестами" }
+verified:
+  - "pnpm test — 24/24"
+```

package/assets/schema/cow-answer.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "cow role answer",
+  "type": "object",
+  "required": ["markdown", "result"],
+  "additionalProperties": false,
+  "properties": {
+    "markdown": { "type": "string", "description": "Полный ответ роли в Markdown без блока cow-result" },
+    "result": {
+      "type": "object",
+      "required": ["status"],
+      "properties": {
+        "status": { "type": "string", "enum": ["готово", "утверждение", "заблокировано"] },
+        "blocker": {
+          "type": "object",
+          "properties": {
+            "category": { "type": "string", "enum": ["артефакт", "тесты", "реализация", "внешний", "пользователь", "нет"] },
+            "artifact": { "type": "string" },
+            "message": { "type": "string" }
+          }
+        },
+        "size": { "type": "string", "enum": ["small", "normal", "large"] },
+        "skip_specs": { "type": "boolean" },
+        "complexity": {
+          "type": "object",
+          "properties": {
+            "implementation": { "type": "string", "enum": ["обычная", "высокая"] },
+            "review": { "type": "string", "enum": ["обычная", "высокая"] }
+          }
+        },
+        "questions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "priority": { "type": "string", "enum": ["P0", "P1", "P2"] }, "text": { "type": "string" } } } },
+        "findings": { "type": "array", "items": { "type": "object", "properties": { "level": { "type": "string", "enum": ["blocking", "non-blocking"] }, "file": { "type": "string" }, "text": { "type": "string" } } } },
+        "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "purpose": { "type": "string" }, "result": { "type": "string", "enum": ["PASS", "FAIL", "PARTIAL", "NOT_RUN"] }, "evidence": { "type": "string" } } } },
+        "gaps": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "environment": { "type": "string" }, "oracle": { "type": "string" }, "risk": { "type": "string" } } } },
+        "dispositions": { "type": "array", "items": { "type": "object", "properties": { "item": { "type": "string" }, "disposition": { "type": "string", "enum": ["satisfied", "manual_gap_accepted", "change_required", "blocked"] }, "reason": { "type": "string" } } } },
+        "delivery_narrative": { "type": "object", "properties": { "title": { "type": "string" }, "delta": { "type": "string" }, "why": { "type": "string" }, "preserved": { "type": "string" }, "rollout": { "type": "string" }, "rollback": { "type": "string" } } },
+        "protected": { "type": "array", "items": { "type": "string" } },
+        "verified": { "type": "array", "items": { "type": "string" } }
+      }
+    }
+  }
+}

package/assets/schema/default.yaml

@@ -0,0 +1,116 @@
+name: default
+version: 1
+artifacts:
+  - id: proposal
+    phase: propose
+    generates: proposal.md
+    template: proposal.md
+    description: "Предложение: зачем нужно изменение и его границы"
+    instruction: |
+      Создай предложение: объясни, ЗАЧЕМ нужно изменение, и определи его границы.
+
+      - перед записью прочитай request.md и evidence/research.md и используй их как принятый контекст;
+      - предложение — документ согласования проблемы, границ и состава изменения;
+      - если к разделу нет применимой информации, укажи «—».
+
+      Не включай: точные требования и сценарии; имена файлов, функций и модулей; технические решения; задачи реализации.
+
+      ## Зачем — 1–3 предложения о проблеме, какую проблему решает, почему сейчас.
+      ## Границы изменения — подразделы «Входит» и «Не входит».
+      ## Функциональности — новые и изменяемые capability с идентификаторами (`cow spec list --json`); для новой capability придумай code в kebab-case. Если поведение продукта не меняется, укажи skip_specs: true в блоке cow-result.
+      ## Внешнее влияние — затронутые потребители, контракты, зависимости; несовместимые изменения помечай **BREAKING**.
+
+      В блоке cow-result укажи size (small | normal | large) и complexity для реализации и ревью.
+    requires: []
+
+  - id: specs
+    phase: plan
+    generates: "specs/**/*.{yml,yaml,md}"
+    description: Дельты спецификаций
+    skippable: true
+    instruction: |
+      Создай дельты спецификаций: определи, ЧТО должна делать система после изменения.
+
+      - перед записью прочитай proposal.md и текущие спецификации затронутых capability (`cow spec show <code> --json`);
+      - описывай наблюдаемое поведение с точки зрения пользователя или внешнего контракта;
+      - каждое утверждение проверяемо одним тестом: одно поведение, одно действие, один наблюдаемый результат;
+      - формулировки бери из glossary.md;
+      - по одной дельте на capability из раздела «Функциональности» предложения.
+
+      Не включай: архитектурные решения, структуры данных, алгоритмы, задачи разработки.
+
+      Формат дельты задаёт адаптер спецификаций проекта, его инструкция приложена ниже.
+    requires: [proposal]
+
+  - id: design
+    phase: plan
+    generates: design.md
+    template: design.md
+    description: "Дизайн-документ: общая картина, контракты, решения, вопросы"
+    instruction: |
+      Создай дизайн-документ: покажи человеку общую картину и собери все решения в одном месте.
+
+      - перед записью прочитай proposal.md, дельты specs/ и architecture.md;
+      - раздел «Общая картина» описывает, как будет работать изменяемая функциональность целиком: путь пользователя, участвующие компоненты, что меняется в каждом; одна схема потока данных;
+      - раздел «Контракты» перечисляет изменения интерфейсов: API, события, схемы, структура UI и идентификаторы для тестов;
+      - раздел «Решения»: каждое с идентификатором D1, D2…, обоснованием, альтернативами и последствиями; флаг promote, если решение стоит сделать постоянным правилом;
+      - раздел «Вопросы, требующие решения»: таблица с приоритетом P0 (нельзя писать спецификации и тесты), P1 (меняет дизайн, но есть рекомендация), P2 (вкусовщина), вариантами, рекомендацией и влиянием; продублируй вопросы в блоке cow-result;
+      - раздел «Соответствие правилам»: каждое применимое правило из rules пакета и как дизайн его соблюдает;
+      - «Риски и компромиссы» в формате «риск → мера снижения»; «Стратегия проверки» по уровням из testing.md; «Миграция и откат», если применимо.
+
+      Не включай: мотивацию и границы из proposal; задачи; построчную реализацию.
+    requires: [proposal, specs]
+
+  - id: tasks
+    phase: plan
+    generates: tasks.md
+    template: tasks.md
+    description: Проверяемый список задач реализации
+    instruction: |
+      Создай список задач: разбей реализацию на проверяемые шаги.
+
+      - перед записью прочитай дельты specs/ и design.md;
+      - группируй задачи под нумерованными заголовками `##`;
+      - каждая задача — флажок `- [ ] X.Y Описание`; задачи без флажка не отслеживаются;
+      - упорядочи по зависимостям: подготовка → основная реализация → проверки;
+      - в каждой задаче ссылайся на утверждение спецификации или помечай её как техническую;
+      - добавь задачи на прогон проверок из testing.md (тесты, типы, линтеры).
+
+      Не включай: новые требования; пересмотр решений; ручные проверки и шаги, требующие человека; написание или изменение тестов (их пишет tester до реализации).
+    requires: [specs, design]
+
+  - id: coverage
+    phase: cover
+    generates: coverage.yaml
+    template: coverage.yaml
+    description: Связь сценариев с автотестами
+    instruction: |
+      Заполни coverage.yaml: для каждого утверждения из дельт specs/ укажи тесты (путь, полное имя, уровень) либо manual с причиной.
+
+      - имя теста строится по правилу из testing.md, чтобы отчёт тестов сопоставился с утверждением;
+      - уровень выбирай по testing.md: unit, component, module, e2e;
+      - утверждения без теста допустимы только с пометкой manual и причиной.
+    requires: [specs, design]
+
+  - id: test-plan
+    phase: cover
+    generates: test-plan.md
+    template: test-plan.md
+    optional: true
+    description: План ручного тестирования
+    instruction: |
+      Создай план ручной проверки только для утверждений с пометкой manual в coverage.yaml и короткий чеклист для человека перед мержем.
+    requires: [coverage]
+
+apply:
+  requires: [tasks, coverage]
+  tracks: tasks.md
+  instruction: |
+    Выполни утверждённый план изменения.
+
+    - источник требований — дельты specs/, технических решений — design.md, шагов — tasks.md;
+    - выполняй задачи последовательно с учётом зависимостей;
+    - защищённые тестовые файлы не меняй; если тест неверен, верни блокер категории «тесты» с доказательством;
+    - отмечай задачу `- [x]` только после фактической реализации и прогона проверки;
+    - единственная допустимая правка артефактов — отметки в tasks.md;
+    - при невыполнимой задаче или расхождении с планом остановись и верни блокер категории «артефакт» с идентификатором артефакта.

package/assets/templates/coverage.yaml

@@ -0,0 +1,12 @@
+# Связь утверждений спецификации с автотестами.
+# capability → группа → утверждение → тесты | manual
+# uncomment and fill:
+# checkout-page:
+#   "Пользователь может выбрать адрес доставки":
+#     "При нажатии «Выбрать адрес» открывается диалог выбора адреса на карте":
+#       tests:
+#         - level: e2e
+#           file: e2e/checkout/address.spec.ts
+#           name: "Страница оформления заказа › Пользователь может выбрать адрес доставки › При нажатии «Выбрать адрес» открывается диалог выбора адреса на карте"
+#     "Адрес сохраняется в профиле":
+#       manual: "Требует реального аккаунта с историей заказов"

package/assets/templates/design.md

@@ -0,0 +1,39 @@
+## Общая картина
+
+<!-- путь пользователя от входа до результата, участвующие компоненты, что меняется в каждом; схема потока данных -->
+
+## Контракты
+
+<!-- API, события, схемы данных, структура UI и идентификаторы для тестов -->
+
+## Решения
+
+### D1. <!-- название решения -->
+
+- Решение: <!-- выбранный подход -->
+- Обоснование: <!-- почему -->
+- Альтернативы: <!-- отклонённые варианты и почему -->
+- Последствия: <!-- что меняется -->
+- promote: false
+
+## Вопросы, требующие решения
+
+| ID | Приоритет | Вопрос | Варианты | Рекомендация | Влияние |
+|---|---|---|---|---|---|
+<!-- | Q1 | P1 | … | A / B | A | … | -->
+
+## Соответствие правилам
+
+<!-- ADR-xxxx: как соблюдается -->
+
+## Риски и компромиссы
+
+<!-- риск → мера снижения -->
+
+## Стратегия проверки
+
+<!-- что и на каком уровне проверяется -->
+
+## Миграция и откат
+
+<!-- шаги применения и возврата или «—» -->

package/assets/templates/proposal.md

@@ -0,0 +1,27 @@
+## Зачем
+
+<!-- проблема или возможность, почему сейчас -->
+
+## Границы изменения
+
+### Входит
+
+<!-- результаты в границах изменения -->
+
+### Не входит
+
+<!-- смежные результаты, которые остаются за пределами -->
+
+## Функциональности
+
+### Новые
+
+<!-- - `<code>`: краткое описание -->
+
+### Изменяемые
+
+<!-- - `<code>`: что меняется в поведении -->
+
+## Внешнее влияние
+
+<!-- затронутые потребители, контракты, зависимости; **BREAKING** для несовместимых -->

package/assets/templates/tasks.md

@@ -0,0 +1,9 @@
+## 1. <!-- Название группы задач -->
+
+- [ ] 1.1 <!-- Описание задачи (утверждение спецификации или «техническая») -->
+- [ ] 1.2 <!-- Описание задачи -->
+
+## 2. Проверки
+
+- [ ] 2.1 <!-- Прогнать тесты из coverage.yaml -->
+- [ ] 2.2 <!-- Прогнать проверки из testing.md -->

package/assets/templates/test-plan.md

@@ -0,0 +1,7 @@
+## Ручные проверки
+
+<!-- по одной на утверждение с пометкой manual: шаги, ожидаемый результат, окружение -->
+
+## Чеклист перед мержем
+
+- [ ] <!-- пункт для человека -->

package/bin/cow.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import('../dist/cli/main.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

@@ -0,0 +1,94 @@
+import path from 'node:path';
+import { loadRoleText } from '../../../core/roles.js';
+import { ROLES } from '../../../core/phases.js';
+import { writeText } from '../../../core/paths.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: 'Исследователь cow: Evidence Pack по изменению. Вызывается только скиллом cow-run.',
+    planner: 'Планировщик cow: proposal, дельты спецификаций, design, tasks. Вызывается только скиллом cow-run.',
+    challenger: 'Аудитор плана cow. Вызывается только скиллом cow-run.',
+    tester: 'Тестировщик cow: тесты по сценариям до реализации. Вызывается только скиллом cow-run.',
+    implementer: 'Реализатор cow: выполняет tasks.md, не трогая защищённые тесты. Вызывается только скиллом cow-run.',
+    reviewer: 'Ревьюер cow: тесты против спецификаций, код против артефактов. Вызывается только скиллом cow-run.',
+    verifier: 'Верификатор cow: полнота, корректность, согласованность. Вызывается только скиллом cow-run.',
+    distiller: 'Дистиллятор знаний cow.',
+};
+/** Материалы для Claude Code: тонкий скилл-оркестратор и по агенту на роль (docs/design.md, раздел 11). */
+export function installClaudeMaterials(root) {
+    const written = [];
+    const skill = path.join(root, '.claude', 'skills', 'cow-run', 'SKILL.md');
+    writeText(skill, RUN_SKILL);
+    written.push(skill);
+    const approve = path.join(root, '.claude', 'skills', 'cow-approve', 'SKILL.md');
+    writeText(approve, APPROVE_SKILL);
+    written.push(approve);
+    for (const role of ROLES) {
+        if (!AGENT_ROLES.includes(role))
+            continue;
+        const file = path.join(root, '.claude', 'agents', `cow-${role}.md`);
+        writeText(file, agentFile(root, role));
+        written.push(file);
+    }
+    return written;
+}
+function agentFile(root, role) {
+    const body = loadRoleText(root, role);
+    return `---
+name: cow-${role}
+description: ${DESCRIPTIONS[role]}
+tools: ${TOOLS[role]}
+---
+
+Ты выполняешь роль ${role} инструмента cow. Во входном сообщении путь к JSON-пакету (\`packet\`). Прочитай пакет целиком: там цель, допущенные файлы, ограничения, правила проекта, инструкции к артефактам и путь \`resultFile\`.
+
+Порядок работы: прочитай пакет → выполни этапы роли ниже → запиши полный ответ (Markdown и завершающий блок \`# cow-result\`) в файл \`resultFile\` из пакета → в сообщении верни только две строки: путь к resultFile и статус.
+
+${body.trim()}
+`;
+}
+const RUN_SKILL = `---
+name: cow-run
+description: Выполнить следующий шаг изменения cow — запросить пакет у CLI, выполнить роль субагентом и сдать отчёт. Используй, когда пользователь просит продвинуть изменение, запустить cow, выполнить следующий шаг.
+---
+
+# cow-run
+
+Ты оркестратор: не исследуешь проект и не решаешь задачу сам. Роли выполняют субагенты \`cow-<role>\`.
+
+1. Определи изменение: из аргумента, из контекста или \`cow change list --json\`. Если активных изменений несколько и не ясно, какое брать, спроси пользователя.
+2. Запроси следующий шаг: \`cow next --change <id> --json\`.
+3. По полю \`kind\` ответа:
+   - \`role\`: запусти субагента \`cow-<role>\` с сообщением: \`packet: <path из поля packetFile>\`. Дождись ответа. Затем сдай отчёт: \`cow report --change <id> --role <role> --file <resultFile> --json\`. Если CLI вернул ошибки (например, не создан артефакт или изменены защищённые файлы), передай их тому же субагенту одним сообщением и повтори отчёт; не больше двух повторов.
+   - \`gate\`: покажи пользователю, что нужно посмотреть (пути артефактов из ответа), и спроси: «Утвердить <gate>? Ответьте «да» или замечанием». «да» → \`cow approve <gate> --change <id> --by <user>\`; замечание → \`cow reject <gate> --change <id> --comment "<текст>"\`. Затем вернись к шагу 2.
+   - \`deliver\`: покажи чеклист \`cow deliver --change <id> --check\` и предложи доставку \`cow deliver --change <id>\` (архив, коммит, push, пул-реквест). Не запускай доставку без просьбы пользователя.
+   - \`wait\`: покажи статус и блокер, спроси пользователя, что делать.
+   - \`done\`: сообщи об окончании.
+4. Повторяй шаги 2–3, пока не встретишь gate, wait, deliver или done. Не запускай субагентов параллельно.
+
+Полезные команды: \`cow status --change <id>\` (состояние, change-set, привязка ревью), \`cow changeset show\` (запечатанный диф и дрейф), \`cow coverage --report jest=<path>\` (покрытие утверждений тестами), \`cow change resume --returns N\` (продолжить после parked).
+
+Запрещено: переформулировать задачу пользователя, редактировать артефакты, вызывать роли напрямую в обход пакета, менять код.
+`;
+const APPROVE_SKILL = `---
+name: cow-approve
+description: Утвердить или отклонить гейт изменения cow (proposal, plan, tests). Используй, когда пользователь говорит «утверждаю», «одобряю план», «отклоняю с замечанием».
+---
+
+# cow-approve
+
+1. Определи изменение и гейт: \`cow status --change <id> --json\` показывает ожидающий гейт.
+2. Утверждение: \`cow approve <gate> --change <id> --by <user> [--comment "..."] [--answer Q1=B]\`.
+3. Отклонение: \`cow reject <gate> --change <id> --by <user> --comment "<замечание>"\`.
+4. Покажи результат и предложи продолжить скиллом cow-run.
+`;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/host/claude/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAa,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,WAAW,GAAW,CAAC,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;AAErH,MAAM,KAAK,GAAyB;IAClC,UAAU,EAAE,wBAAwB;IACpC,OAAO,EAAE,qCAAqC;IAC9C,UAAU,EAAE,wBAAwB;IACpC,MAAM,EAAE,qCAAqC;IAC7C,WAAW,EAAE,qCAAqC;IAClD,QAAQ,EAAE,wBAAwB;IAClC,QAAQ,EAAE,wBAAwB;IAClC,SAAS,EAAE,+BAA+B;CAC3C,CAAC;AAEF,MAAM,YAAY,GAAyB;IACzC,UAAU,EAAE,mFAAmF;IAC/F,OAAO,EAAE,mGAAmG;IAC5G,UAAU,EAAE,uDAAuD;IACnE,MAAM,EAAE,uFAAuF;IAC/F,WAAW,EAAE,oGAAoG;IACjH,QAAQ,EAAE,mGAAmG;IAC7G,QAAQ,EAAE,6FAA6F;IACvG,SAAS,EAAE,yBAAyB;CACrC,CAAC;AAEF,2GAA2G;AAC3G,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC1E,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC5B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC;IAChF,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,SAAS;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,IAAI,KAAK,CAAC,CAAC;QACpE,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,IAAU;IACzC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,OAAO;YACG,IAAI;eACD,YAAY,CAAC,IAAI,CAAC;SACxB,KAAK,CAAC,IAAI,CAAC;;;qBAGC,IAAI;;;;EAIvB,IAAI,CAAC,IAAI,EAAE;CACZ,CAAC;AACF,CAAC;AAED,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;CAsBjB,CAAC;AAEF,MAAM,aAAa,GAAG;;;;;;;;;;;CAWrB,CAAC"}

package/dist/adapters/repo/git.js

@@ -0,0 +1,81 @@
+import { execFileSync } from 'node:child_process';
+import { CowError } from '../../core/errors.js';
+/** Локальные операции git, общие для адаптеров GitHub и local. */
+export class GitOps {
+    root;
+    constructor(root) {
+        this.root = root;
+    }
+    run(args, opts = {}) {
+        try {
+            return execFileSync('git', args, { cwd: this.root, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
+        }
+        catch (e) {
+            if (opts.allowFail)
+                return '';
+            const err = e;
+            throw new CowError('GIT_FAILED', `git ${args.join(' ')}: ${(err.stderr ?? err.message).trim()}`);
+        }
+    }
+    currentBranch() {
+        return this.run(['rev-parse', '--abbrev-ref', 'HEAD']).trim();
+    }
+    branchExists(name) {
+        return this.run(['rev-parse', '--verify', '--quiet', `refs/heads/${name}`], { allowFail: true }).trim().length > 0;
+    }
+    ensureBranch(name, from) {
+        if (this.currentBranch() === name)
+            return;
+        if (this.branchExists(name))
+            this.run(['checkout', name]);
+        else
+            this.run(['checkout', '-b', name, from]);
+    }
+    findCommitByIntent(intentKey) {
+        const out = this.run(['log', '--all', '--format=%H', `--grep=Cow-Intent-Key: ${intentKey}`], { allowFail: true }).trim();
+        return out ? out.split('\n')[0] : null;
+    }
+    commitAll(message, intentKey) {
+        this.run(['add', '-A']);
+        const staged = this.run(['diff', '--cached', '--name-only']).trim();
+        if (!staged) {
+            const existing = this.findCommitByIntent(intentKey);
+            if (existing)
+                return existing;
+            throw new CowError('NOTHING_TO_COMMIT', 'Нет изменений для коммита.');
+        }
+        const full = `${message.trimEnd()}\n\nCow-Intent-Key: ${intentKey}\n`;
+        this.run(['commit', '-q', '-F', '-'], { allowFail: false });
+        void full;
+        return this.run(['rev-parse', 'HEAD']).trim();
+    }
+    commitAllWithMessage(message, intentKey) {
+        this.run(['add', '-A']);
+        const staged = this.run(['diff', '--cached', '--name-only']).trim();
+        if (!staged) {
+            const existing = this.findCommitByIntent(intentKey);
+            if (existing)
+                return existing;
+            throw new CowError('NOTHING_TO_COMMIT', 'Нет изменений для коммита.');
+        }
+        const full = `${message.trimEnd()}\n\nCow-Intent-Key: ${intentKey}\n`;
+        execFileSync('git', ['commit', '-q', '-F', '-'], { cwd: this.root, input: full, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] });
+        return this.run(['rev-parse', 'HEAD']).trim();
+    }
+    hasRemote(name = 'origin') {
+        return this.run(['remote'], { allowFail: true }).split('\n').map((l) => l.trim()).includes(name);
+    }
+    push(branch, remote = 'origin') {
+        this.run(['push', '-u', remote, branch]);
+    }
+    remoteUrl(remote = 'origin') {
+        const out = this.run(['remote', 'get-url', remote], { allowFail: true }).trim();
+        return out || null;
+    }
+}
+/** owner/repo из URL GitHub: https://github.com/o/r(.git) или git@github.com:o/r(.git). */
+export function parseGitHubRemote(url) {
+    const m = url.match(/github\.com[:/]([^/]+)\/([^/]+?)(?:\.git)?\/?$/);
+    return m ? { owner: m[1], repo: m[2] } : null;
+}
+//# sourceMappingURL=git.js.map