mister-wolf 2.21.2 → 2.22.0

package/README.md

@@ -54,7 +54,7 @@ wolf bootstrap
 - **Path B — OpenCode organization:** `wolf init --full --platform opencode` renders the full base set (6 agent frames, 19 skills, 3 commands, 2 plugins, seeded playbook faces) and writes `opencode.json` (`mcp.servers.wolf`, `default_agent=mr-wolf`, `experimental.subagent_depth=2`). **Restart opencode** after it — the MCP server and the default agent connect at startup. Claude Code will ask you to approve the project-scope MCP server on first start — that is expected.
 
 - **Try it without installing:** `npx mister-wolf init` — try-out mode: creates the `.wolf/` memory skeleton but never writes MCP configs or the base set. Like it? `npm install -g mister-wolf` and run `wolf init` again.
-- **Updating:** `wolf upgrade` — one command updates everything: the npm phase (`npm install -g mister-wolf@latest`) is followed by the update pass over all registered projects (stamped base-set files and seeded faces; deletions only with confirmation). `--check` reports CLI + park freshness without installing; `--here` updates only the current project (no npm, no registry); `--yes` skips the confirmation and backs up whatever it overwrites. Dev/linked installs are refused honestly. `wolf sync` is deprecated → `wolf upgrade --here` (still available in 2.20.0).
+- **Updating:** `wolf upgrade` — one command updates everything: the npm phase (`npm install -g mister-wolf@latest`) is followed by the update pass over all registered projects (stamped base-set files and seeded faces; deletions only with confirmation). `--check` reports CLI + park freshness without installing; `--here` updates only the current project (no npm, no registry); `--yes` skips the confirmation and backs up whatever it overwrites. Dev/linked installs are refused honestly. `wolf sync` is deprecated → `wolf upgrade --here` (the alias still works and re-renders stamped files; its DEPRECATED notice still says `removed in 2.20.0` — stale wording, the command is alive).
 - **Owner intent (2.20.0):** when a pass needs your word, it names the file and the reason (`mutated` / `conflict`, per path — no bare counters). `--review` walks the decisions with a diff, `--show <file|N>` prints local vs base, `--resolve <file|N>=take|keep|protect|pin` applies one, `--json` is the machine channel (`wolf.upgrade/1`, and `wolf.upgrade.check/1` with `--check`). `protect: true` (or `protect: X.Y.Z`) in an agent/skill/command frontmatter holds that file forever — never overwritten, never deleted, still visible in `--check`. A local conflict, start to finish:
 
   ```bash

package/README.ru.md

@@ -62,7 +62,8 @@ wolf bootstrap
   `--check` — read-only сводка свежести CLI и парка; `--here` — обновить только текущий проект
   (без npm и реестра); `--yes` — без интерактивного подтверждения, с бэкапом всего, что
   перезаписывает. Dev/linked-установке откажет честно. `wolf sync` депрекирован →
-  `wolf upgrade --here` (алиас ещё работает в 2.20.0).
+  `wolf upgrade --here` (алиас ещё работает и перерендеривает штампованные файлы; его уведомление
+  DEPRECATED всё ещё говорит `removed in 2.20.0` — устаревшая формулировка, команда жива).
 - **Намерения владельца (2.20.0):** когда проходу нужно ваше слово, он называет файл и причину
   (`mutated` / `conflict`, по путям — без голых счётчиков). `--review` разбирает решения с диффом,
   `--show <файл|N>` печатает локальный vs эталон, `--resolve <файл|N>=take|keep|protect|pin`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mister-wolf",
-  "version": "2.21.2",
+  "version": "2.22.0",
   "description": "Local-first project memory for AI coding agents: decisions, lessons, tools and processes that outlive the session",
   "keywords": [
     "ai-agents",

package/templates/.wolf/router.log

@@ -1 +1 @@
-2026-10-30T13:59:40.930Z agent-id=v2-router-probe-xyz playbook=hit name=fallback variant=fallback source=default resolution=error face_id=- version=- hash=- session=opc-4fe037e6-1e4b-499e-9655-3f38c55686c8 injected=yes ms=0 bytes=1274
+2026-10-31T00:14:38.946Z agent-id=v2-router-probe-xyz playbook=hit name=fallback variant=fallback source=default resolution=error face_id=- version=- hash=- session=opc-4959328f-6d56-4600-9e0e-52a774766922 injected=yes ms=0 bytes=1274

package/templates/base/agents/executor-lead.md

@@ -144,6 +144,60 @@ handoff; не маскируй отказ памяти файлом в доку
 - Самообучение: значимые ошибки/удачи воркеров — `wolf add --type
   lesson` (только нетривиальное и воспроизводимое).
 
+### Выбор сеанса: fresh / continue / replace
+
+Правило действует только после решения делегировать. Малая связанная работа остаётся
+у L1 и не создаёт обязательного L2/исследователя; требуемую независимую приёмку
+выполняет другой уполномоченный участник, self-review независимой приёмкой не является.
+Ядро и профиль поручения — по канону using-skills.
+
+- **fresh** — новый самостоятельный принимаемый результат → новый L2 и отобранный под
+  него TASK.
+- **continue** — тот же ещё не принятый результат → прежний L2: уточнение, следующий
+  связанный этап, дополнительное evidence, ограниченное исправление по приёмке.
+- **replace** — та же задача, прежнее исполнение больше не подходит → новый L2 через
+  handoff (порядок ниже).
+
+Инварианты:
+
+1. `task_id` — идентификатор задачи, не id сеанса; совпадение имён параметров инструмента
+   не делает их равными.
+2. `continue` не расширяет scope: новые самостоятельные требования не добавляются под
+   видом исправления, несвязанная задача не дробится после каждого шага.
+3. `DONE` не закрывает задачу: после ACCEPTED прежний L2 не становится свободным слотом
+   под следующую задачу.
+4. Правило не создаёт исследователя или агента на файл: малая связанная работа остаётся
+   у L1, независимая приёмка — у другого уполномоченного участника.
+5. Первичное независимое review получает проверяемые материалы, нормы и evidence, но не
+   историю родителя, не чужие findings и не ожидаемый verdict; повторная проверка
+   исправлений своих замечаний тем же reviewer допустима.
+6. При замене model/variant resume не доказывает смену модели; неподдержанная в resume
+   смена → новый исполнитель.
+7. Новый id сеанса не доказывает чистую изоляцию: если host наследует историю родителя,
+   независимость не закрыта — результат остаётся `INCONCLUSIVE` либо ограниченным;
+   честный отчёт о возможностях host ≠ успешная независимая приёмка.
+8. Незавершённая приёмка при замене не обнуляется: известный результат и открытые
+   замечания передаются через handoff. Учёт фактических расходов — A1.1/E2; без связей
+   результат помечается «неизвестно с покрытием», не нулём.
+
+### Порядок replace
+
+Четыре различимых шага; `1` и `4` — не одно действие.
+
+1. **stop-writing** — прекратить новые изменения и подтвердить завершение пишущих
+   инструментов прежнего исполнителя.
+2. **preserve** — уполномоченный владелец/L1 сохраняет известный результат и handoff,
+   выполняет требуемую публикацию. L2 без права коммита отдаёт checkpoint L1; L1
+   фиксирует его после прекращения записи.
+3. **hand-over** — получатель проверяет доступность результата и принимает ownership;
+   при неопределённости передача той же ветки не завершена.
+4. **close** — прежняя сессия закрывается после сохранения нужного контекста.
+
+Инварианты порядка: таймаут, молчание и истёкший бюджет не доказывают остановку записи;
+read-only review не требует нового worktree; task identity, evidence, права и действующая
+политика model/variant сохраняются; незавершённая приёмка и известный результат не
+обнуляются.
+
 ## Библиотека регулярных средств
 
 Перед повторяющейся процедурой или обходом известного трения проверь готовое

package/templates/base/skills/using-skills/SKILL.md

@@ -200,12 +200,62 @@ FULL — несколько компонентов, новые контракт
 
 ## Контракты передачи
 
+### Ядро TASK
+
+Ядро обязательно для любого поручения; каждый пункт — проверяемое предписание,
+а не перечисление через запятую. Профиль (ниже) добавляет к ядру, не заменяет его.
+
+- `task_id` — идентификатор подзадачи, отличный от id сеанса; по нему сверяются отчёт
+  и evidence.
+- Цель/ожидаемый результат — что должно быть на выходе, одной проверяемой формулировкой.
+- AC — приёмочные критерии, по каждому из которых можно сказать «подтверждено» или нет.
+- Scope и полномочия — что входит в работу, что запрещено (запись, спавн, коммиты),
+  где вести рабочие материалы.
+- Входы и назначенная методика — какие нормы и файлы читать и каким процессом
+  исполнять; недостающий обязательный вход запрашивается, не додумывается.
+- Проверка — точные команды или процедуры и ожидаемый результат; запускает исполнитель.
+- Конечный бюджет и stop/return — лимит работы и условия немедленного возврата L1.
+- Ожидаемый RESULT — форма отчёта по роли, включая допустимые статусы и вердикты.
+
+Инварианты ядра: применимое ядерное поле нельзя опустить; неизвестный обязательный
+вход явно запрашивается (`NEEDS_CONTEXT`), не заполняется заглушкой. Опускание
+неприменимого профильного поля — не дефект поручения.
+
+### Профили поручения
+
+Профиль `implement | review | research` добавляет поля к ядру. Неприменимое поле
+опускается, а не заполняется заглушкой; поручение без такого поля корректно.
+
+- `implement` добавляет: repo/workspace, `base_sha`, allowlist записи, разрешённые
+  области чтения, зависимости, ссылки на design/test-plan. Из ядра не опускает ничего.
+  RESULT: `DONE | DONE_WITH_CONCERNS | NEEDS_CONTEXT | BLOCKED`.
+- `review` добавляет: revision проверяемого артефакта, назначенную линзу, норму
+  и evidence-набор. Не требует `base_sha`, allowlist записи, worktree.
+  RESULT: `SUMMARY/VERDICT/FINDINGS/SCOPE/LIMITS/EVIDENCE`; вердикты
+  `APPROVED | CHANGES_REQUIRED | INCONCLUSIVE`.
+- `research` добавляет: проверяемый вопрос, критерий ответа, revision документа или
+  источника, границы поиска и условие остановки. Не требует `base_sha`, allowlist записи.
+  RESULT: `FINDINGS/CONFIDENCE/GAPS` с разделением источника, факта, вывода и гипотезы.
+
+Формат передачи по умолчанию — сообщение; точные разрешённые выходные файлы, если они
+нужны, и место временной работы вне документации указывает L1. Ответственность
+за общий план и покрытие остаётся у L1.
+
+### Словарь контрактов
+
+Термины определены статически; определения не описывают поведение механизмов
+и не ссылаются на команды или поля, которых нет. Ниже таблицы — действующие формы
+`RESULT`/`EVIDENCE`/`ACCEPTANCE`: они подробны, таблица даёт только смысл термина.
+
+| Термин | Значение |
+| --- | --- |
+| TASK | Поручение исполнителю: ядро из восьми элементов плюс поля применимого профиля. |
+| RESULT | Отчёт исполнителя по форме своей роли: статус или вердикт, изменения, границы. |
+| EVIDENCE | Подтверждение claim/AC: команда или процедура, cwd, revision, exit, результат. |
+| ACCEPTANCE | Сверка каждого AC с evidence и итоговый verdict приёмки у L0. |
+| SCOPE | Границы задачи: что входит и что запрещено. В отчёте worker-reviewer `SCOPE` — покрытие ревью, не границы задачи. |
+| LIMITS/GAPS | Что не проверено, где нет данных или остался риск; отсутствие данных не равно нулю или успеху. |
 
-TASK: task_id, цель, AC/REQ, base_sha, cwd/worktree, allowlist записи, разрешённые области чтения, зависимости, ссылки на design/test-plan, проверки, ограничения, ожидаемый отчёт. Для L2: один конечный результат,
-способ/границы допустимого поиска, конечный лимит и точный триггер возврата L1;
-формат передачи (по умолчанию сообщение), точные разрешённые выходные файлы,
-если нужны, и место временной работы вне документации;
-ответственность за общий план и покрытие остаётся у L1.
 RESULT: task_id, DONE | DONE_WITH_CONCERNS | NEEDS_CONTEXT | BLOCKED, изменения, проверки и evidence, отклонения, оставшиеся риски. DONE означает готовность к ревью, а не приёмку.
 EVIDENCE: claim/AC, command или процедура, cwd, revision, dirty-state digest при наличии, существенное окружение, время, exit/status, результат и ссылка на имеющееся подтверждение (лог, вывод инструмента, CI-артефакт). Отдельный файл лога не обязателен. Не выдумывай отсутствующие поля.
 ACCEPTANCE: по каждому AC подтверждение/не подтверждено, актуальные evidence, независимое ревью, ограничения; финальный verdict L0: ACCEPTED | PARTIAL | REJECTED | INCONCLUSIVE.

package/templates/base/skills/wolf-handoff/SKILL.md

@@ -14,7 +14,7 @@ description: "Применять перед сменой сессии или и
 
 ## Выбор действия
 
-Различай: продолжение той же роли в новой сессии, замена исполнителя и новая подзадача. L0 передаёт цель преемнику L0 либо поручает L1 поставку; L1 заменяет L2/исполнительскую сессию; L2 возвращает checkpoint и запрос L1. L2 не спавнит преемника. Указание tool.task не гарантирует сброс контекста родителя — проверь возможности платформы.
+Различай: продолжение той же роли в новой сессии, замена исполнителя и новая подзадача. L0 передаёт цель преемнику L0 либо поручает L1 поставку; L1 заменяет L2/исполнительскую сессию (порядок замены и выбор сеанса — по канону executor-lead); L2 возвращает checkpoint и запрос L1. L2 не спавнит преемника. Указание tool.task не гарантирует сброс контекста родителя — проверь возможности платформы.
 
 ## Snapshot
 
@@ -40,7 +40,7 @@ Snapshot не становится проектным документом ав
 
 1. Зафиксируй snapshot revision и место. При недоступной записи L2 передаёт его L1, не обходит permissions.
 2. Действующим механизмом останови или отзови право записи старого исполнителя; проверь незавершённые инструменты/процессы. При неизвестном исходе сначала выясни состояние.
-3. L1/L0 передаёт преемнику TASK, snapshot и доступные источники. Если технической блокировки нет, установи протокольного единственного владельца и явно обозначь ограничение.
+3. L1/L0 передаёт преемнику TASK (по канону ядра и профилю поручения в using-skills), snapshot и доступные источники. Если технической блокировки нет, установи протокольного единственного владельца и явно обозначь ограничение.
 4. Преемник подтверждает цель, revision, dirty-state и следующий шаг; сверяет память/план с фактом. Несовпадение → NEEDS_CONTEXT, не слепое продолжение.
 5. Только после подтверждения отметь передачу завершённой и сообщи ответственному уровню ID/статус.
 

package/templates/base/skills/wolf-plan/SKILL.md

@@ -20,7 +20,7 @@ description: "Применять перед декомпозицией утве
 
 1. Проверь версии входов. Отнеси каждый REQ/NFR к задаче и проверке; зафиксируй пробелы до исполнения.
 2. Раздели работу по результатам и ответственности. Размер задачи определяется независимой проверкой и доступным контекстом, а не обязательными 2–5 минутами.
-3. Для каждой задачи заполни TASK из using-skills: цель, AC, baseline, ссылки на контракт, allowlist, зависимости, проверки, ограничение scope и ожидаемый RESULT. Разреши читать затронутый код и потребителей; отсутствие истории сессии не означает запрета чтения.
+3. Для каждой задачи заполни TASK из using-skills по канону ядра и профилю поручения; перечень полей не дублируй, сошлись на канон. Разреши читать затронутый код и потребителей; отсутствие истории сессии не означает запрета чтения.
 4. Укажи достаточно точные действия и символы, не полный код реализации. Примеры допустимы для неоднозначного контракта, но не дублируют design. Не предписывай точный код теста вместо проверяемого свойства.
 5. Построй зависимости. Параллельность разреши только для независимых outputs, изолированной записи и определённого владельца интеграции. Общие контракты и миграции сериализуй.
 6. Для выходов TASK укажи сообщение либо точный файл/раздел; временную область назначь вне документации. Дополнительному документу этапа задай назначение, читателя и владельца прямо в plan, без отдельного реестра. Добавь отдельную интеграционную задачу: порядок объединения, проверка взаимодействий, полный гейт и правила разрешения конфликтов. Укажи промежуточные чекпоинты для длительной работы.

package/templates/base/skills/wolf-review/SKILL.md

@@ -14,9 +14,9 @@ worker-reviewer. L2 не получает полномочий диспетче
 эту организационную методику в каждый worker-TASK. При явно назначенной иной
 специализированной методике доставь её полный текст, не самодельное сокращение.
 
-TASK: цель владельца одной строкой → вклад подзадачи → проверяемый результат,
-baseline/revision/digest/cwd, норма и относящиеся политики, источники, границы,
-полный мандат/AC, инструменты/контракты, RESULT/evidence, бюджет и стоп-условие.
+TASK собирается по канону ядра и профилю review в using-skills, без пересказа
+перечня полей. Собственная рамка роли: цель владельца одной строкой, вклад
+подзадачи и проверяемый результат — по ним оценивается покрытие.
 Обязательные нормативные фрагменты передай без потери исключений и приоритета;
 сохрани точные ссылки для дочитывания, не подменяй норму пересказом. Историю
 родителя, чужие находки и ожидаемый вердикт в независимый первый проход не передавай.

package/templates/base/skills/wolf-sdd/SKILL.md

@@ -18,7 +18,7 @@ description: "Применять при исполнении утверждён
 
 ## Цикл задачи
 
-1. Разрежь работу до конечных мандатов L2; архитектуру, стратегию поиска и зависимости определяет L1. Назначь владельца проверки общих связей. Выбери независимые ready-задачи, запусти параллельно в бюджете и с изоляцией; собери каждому TASK из using-skills. Передай ссылки и минимальный достаточный контекст, проверенные контракты и expected RESULT. L2 разрешено читать нужные файлы и потребителей; история родительской сессии не наследуется.
+1. Разрежь работу до конечных мандатов L2; архитектуру, стратегию поиска и зависимости определяет L1. Назначь владельца проверки общих связей. Выбери независимые ready-задачи, запусти параллельно в бюджете и с изоляцией; собери каждому TASK из using-skills по канону ядра. Выбор сеанса L2 — по канону executor-lead. Передай ссылки и минимальный достаточный контекст, проверенные контракты и expected RESULT. L2 разрешено читать нужные файлы и потребителей; история родительской сессии не наследуется.
 2. Доставь полную методику действия L2 и активный playbook, относящиеся нормы и TASK/RESULT/EVIDENCE; не весь процесс L1/ACCEPTANCE. Для регулярного шага/трения L1 проверяет tool-библиотеку и передаёт подходящий контракт. L2 не выбирает организацию и не спавнит.
 3. Принимай RESULT по готовности: DONE → diff/evidence; DONE_WITH_CONCERNS → риск до ревью; NEEDS_CONTEXT → точный вход; BLOCKED → решение L1, готовое средство или разбиение. Следующий вызов получает решённый вопрос, короткий остаток и новый конечный лимит. Один эксперт — при точном пробеле; дорогой консилиум — только по критериям рамки L1. Изменение цели → L0. Дефект правила → жалобный триаж/Стюард. Не возвращай L2 прежнее «разберись» и не запускай идентичный провал.
 4. Проверь allowlist и новые файлы, включая untracked: RESULT L2 не требует отдельного документа. Частные отчёты/скрипты в docs/dev нарушают состав папки; L1 встраивает полезные выводы в основные документы. Не удаляй чужое/прежнее автоматически. Проверь отсутствие посторонних изменений. Воркер не коммитит; L1 фиксирует результат разрешённым git-действием после проверок, включая авторизованность самого коммита.

package/templates/opencode/plugins/wolf-session-start.js

@@ -77,6 +77,8 @@ function governanceBody() {
 const WORKER_BODY = `## using-skills: пассивный режим воркера (L2)
 
 - Работаешь ровно одну подзадачу: читаешь назначенные скиллы, каталог сам не перебираешь.
+- Методика и ядро поручения доставлены в самом поручении: бери их по ссылке
+  на канон, копию каталога скиллов и ядра не переноси.
 - Методики загружай до исполнения. Блокер и недостающие входы передай L1;
   не начинай продуктовый discovery и новый тред вместо назначенной задачи.
 - Не спавнишь агентов и не коммитишь.

package/update-map.json

@@ -1,11 +1,11 @@
 {
-  "version": "2.21.2",
-  "prev": "2.21.1",
+  "version": "2.22.0",
+  "prev": "2.21.2",
   "files": [
     {
       "path": "base/agents/executor-lead.md",
       "kind": "agent",
-      "category": "unchanged"
+      "category": "changed"
     },
     {
       "path": "base/agents/mr-wolf.md",
@@ -75,7 +75,7 @@
     {
       "path": "base/skills/using-skills/SKILL.md",
       "kind": "skill",
-      "category": "unchanged"
+      "category": "changed"
     },
     {
       "path": "base/skills/verification-before-completion/SKILL.md",
@@ -110,22 +110,22 @@
     {
       "path": "base/skills/wolf-handoff/SKILL.md",
       "kind": "skill",
-      "category": "unchanged"
+      "category": "changed"
     },
     {
       "path": "base/skills/wolf-plan/SKILL.md",
       "kind": "skill",
-      "category": "unchanged"
+      "category": "changed"
     },
     {
       "path": "base/skills/wolf-review/SKILL.md",
       "kind": "skill",
-      "category": "unchanged"
+      "category": "changed"
     },
     {
       "path": "base/skills/wolf-sdd/SKILL.md",
       "kind": "skill",
-      "category": "unchanged"
+      "category": "changed"
     },
     {
       "path": "base/skills/wolf-skill-intake/SKILL.md",
@@ -150,7 +150,7 @@
     {
       "path": "opencode/plugins/wolf-session-start.js",
       "kind": "plugin",
-      "category": "unchanged"
+      "category": "changed"
     }
   ],
   "faces": [