mister-wolf 2.18.5 → 2.20.0

package/dist/ports/base-set-renderer.port.d.ts

@@ -3,12 +3,51 @@ export interface RenderOutcome {
     file: string;
     action: RenderAction;
     reason?: string;
+    /** 2.19.0 (design §«Сверка»): структурный флаг mutated-skip — сверка
+     *  verifyAgainstMap различает skipped-identical / skipped-mutated полем,
+     *  не парсингом reason-строки. */
+    mutated?: boolean;
+    /** Правило 2 §4.3: файл держится ключом protect, не тронут (вне needs-decision). */
+    protected?: true;
+    /** Значение ключа для дайджеста (`true` | `X.Y.Z` | raw вне грамматики). */
+    protect?: string | true;
+    /** Правило 6.5 §4.3: принятый локальный контент (origin:'keep'), файл не менялся. */
+    kept?: true;
+    /** Путь бэкапа, если файл был перезаписан по режиму take-on-mutated (§4.12). */
+    backup?: string;
 }
 /** Контекст подстановки моделей (onboarding v2, §4.5): {{model.primary}} / {{model.worker}}. */
 export interface ModelContext {
     primary: string;
     worker: string;
 }
+/** Действие read-only инспекции цели (T10, REQ-08, design §«--check»): цель
+ *  сверяется с текущим рендером без единой записи на диск. foreign — unstamped
+ *  файл на месте цели (wx-политика: чужое, вне покрытия). protected/kept —
+ *  защищённая вариация и принятый локальный контент: не решения (§4.6). */
+export type InspectAction = 'identical' | 'differs' | 'missing' | 'mutated' | 'foreign' | 'unknown' | 'protected' | 'kept';
+export interface InspectOutcome {
+    /** rel-путь от baseDir — тот же ключ, что RenderOutcome.file. */
+    file: string;
+    action: InspectAction;
+    protected?: true;
+    protect?: string | true;
+    kept?: true;
+    /** База, на которой владелец принял локальный контент (правило 6.5 §4.3). */
+    keepBase?: string;
+    /** Причина наблюдения для человека (`onboarding markers broken`, …); в classify
+     *  и `--check` передаётся полем, а не разбором reason-строки (§4.15). */
+    detail?: string;
+}
+/** Хук бэкапа: приложение решает, куда и как копировать; рендерер только
+ *  требует «сначала бэкап, потом запись» (NFR-05). Возвращает путь бэкапа. */
+export type BackupHook = (rel: string, content: string) => Promise<string>;
+export interface SyncBaseSetOptions {
+    /** --yes (§4.12): mutated → бэкап + эталон. Без хука режим запрещён. */
+    takeMutated?: {
+        backup: BackupHook;
+    };
+}
 export interface BakeResolver {
     /** Вернуть тело playbook'а для вживления (bake-in) или null. Источник — память целевого проекта (§4). */
     (baseName: string): string | null;
@@ -21,6 +60,22 @@ export interface RenderBaseSetOptions {
      * 'full' (дефолт) — весь базовый набор. */
     scope?: 'full' | 'agents-md';
 }
+/** Реестр защит (`--check`, REQ-09; design §4.11): включая файлы вне карты. */
+export interface ProtectEntry {
+    /** Корень проекта (abs). */
+    project: string;
+    /** rel-путь от корня проекта. */
+    file: string;
+    /** `true` | `X.Y.Z` либо raw вне грамматики. */
+    value: 'true' | string;
+    /** false — значение вне грамматики (вывод с предупреждением). */
+    recognized: boolean;
+    stamp: string | null;
+    /** Версия базы (map.version). */
+    base: string;
+    /** Нормализованный контент != fresh; null — эталона нет (файл вне карты). */
+    behind: boolean | null;
+}
 export interface BaseSetRenderer {
     id: string;
     /** Init-рендер: create + diff-ветка (§4.5: stamped + diff контента → updated; unstamped → skipped). */
@@ -30,9 +85,15 @@ export interface BaseSetRenderer {
      * models — контекст из routing-объекта; 'omit' (и undefined — легаси без routing-объекта) —
      * построчное удаление model:-строки из fresh-контента (§4.5).
      */
-    syncBaseSet(baseDir: string, models?: ModelContext | 'omit'): Promise<{
+    syncBaseSet(baseDir: string, models?: ModelContext | 'omit', opts?: SyncBaseSetOptions): Promise<{
         outcomes: RenderOutcome[];
         orphaned: string[];
     }>;
+    /** Read-only инспекция целей base-set и AGENTS.md (`--check`, §4.6). */
+    inspectBaseSet?(baseDir: string, opts?: RenderBaseSetOptions): Promise<InspectOutcome[]>;
+    /** Read-only реестр защит по каталогам base-set, включая файлы вне карты (§4.11). */
+    listProtections?(baseDir: string, base: string): Promise<ProtectEntry[]>;
+    /** Свежий рендер одного rel-файла (эталон для `--show`/`behind`); null — файла нет в карте. */
+    renderFreshFile?(baseDir: string, rel: string, opts?: RenderBaseSetOptions): string | null;
 }
 //# sourceMappingURL=base-set-renderer.port.d.ts.map

package/dist/ports/base-set-renderer.port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-set-renderer.port.d.ts","sourceRoot":"","sources":["../../src/ports/base-set-renderer.port.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAEvF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,gGAAgG;AAChG,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,yGAAyG;IACzG,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,0GAA0G;IAC1G,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAC/B;+CAC2C;IAC3C,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,uGAAuG;IACvG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACtF;;;;OAIG;IACH,WAAW,CACT,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,GAC7B,OAAO,CAAC;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAC/D"}
+{"version":3,"file":"base-set-renderer.port.d.ts","sourceRoot":"","sources":["../../src/ports/base-set-renderer.port.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mister-wolf",
-  "version": "2.18.5",
+  "version": "2.20.0",
   "description": "Local-first project memory for AI coding agents: decisions, lessons, tools and processes that outlive the session",
   "keywords": [
     "ai-agents",
@@ -24,7 +24,8 @@
   },
   "files": [
     "dist",
-    "templates"
+    "templates",
+    "update-map.json"
   ],
   "scripts": {
     "build": "tsc",

package/templates/.wolf/router.log

@@ -1 +1 @@
-2026-10-16T01:25:09.588Z agent-id=v2-router-probe-xyz playbook=hit name=fallback variant=fallback source=default resolution=error face_id=- version=- hash=- session=opc-2ee5fcc7-4ace-4117-8a61-33fa882b0b4d injected=yes ms=0 bytes=1274
+2026-10-25T15:56:04.865Z agent-id=v2-router-probe-xyz playbook=hit name=fallback variant=fallback source=default resolution=error face_id=- version=- hash=- session=opc-f3c9b14e-d389-4f32-bd73-6c36eedd3c72 injected=yes ms=0 bytes=1274

package/templates/base/AGENTS.md

@@ -1,4 +1,4 @@
-<!-- wolf:onboarding v2 -->
+<!-- wolf:onboarding v3 -->
 
 # Mr. Wolf — память проекта
 
@@ -26,7 +26,10 @@
 ## Указатели
 
 - Документация: `docs/README.md`
+- Защита файла от обновления: `protect: true` (или `protect: X.Y.Z`) в YAML-frontmatter
+  agent/skill/command-файла; конфликты разбираются `wolf upgrade --review`,
+  снятие защиты — `wolf upgrade --resolve <файл>=take|keep`.
 - Номер версии всегда полный X.Y.Z — в планах, тредах, волнах, тегах и разговоре.
-Голый минор («2.16») запрещён как имя релиза/волны/треда/плана: релизов «2.16» не
-существует, есть «2.16.0», «2.16.1» (пример корректного полного номера: 2.16.2).
+  Голый минор («2.16») запрещён как имя релиза/волны/треда/плана: релизов «2.16» не
+  существует, есть «2.16.0», «2.16.1» (пример корректного полного номера: 2.16.2).
 <!-- /wolf:onboarding -->

package/update-map.json

@@ -0,0 +1,204 @@
+{
+  "version": "2.20.0",
+  "prev": "2.19.0",
+  "files": [
+    {
+      "path": "base/agents/executor-lead.md",
+      "kind": "agent",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/agents/mr-wolf.md",
+      "kind": "agent",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/agents/steward.md",
+      "kind": "agent",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/agents/worker-implementer.md",
+      "kind": "agent",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/agents/worker-researcher.md",
+      "kind": "agent",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/agents/worker-reviewer.md",
+      "kind": "agent",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/commands/analyze-doc.md",
+      "kind": "command",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/commands/complain.md",
+      "kind": "command",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/commands/doc-review.md",
+      "kind": "command",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/skills/finishing-a-development-branch/SKILL.md",
+      "kind": "skill",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/skills/receiving-code-review/SKILL.md",
+      "kind": "skill",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/skills/requesting-code-review/SKILL.md",
+      "kind": "skill",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/skills/test-driven-development/SKILL.md",
+      "kind": "skill",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/skills/using-git-worktrees/SKILL.md",
+      "kind": "skill",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/skills/using-skills/SKILL.md",
+      "kind": "skill",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/skills/verification-before-completion/SKILL.md",
+      "kind": "skill",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/skills/wolf-brainstorm/SKILL.md",
+      "kind": "skill",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/skills/wolf-debug/SKILL.md",
+      "kind": "skill",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/skills/wolf-design/SKILL.md",
+      "kind": "skill",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/skills/wolf-execute/SKILL.md",
+      "kind": "skill",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/skills/wolf-explain/SKILL.md",
+      "kind": "skill",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/skills/wolf-handoff/SKILL.md",
+      "kind": "skill",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/skills/wolf-plan/SKILL.md",
+      "kind": "skill",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/skills/wolf-review/SKILL.md",
+      "kind": "skill",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/skills/wolf-sdd/SKILL.md",
+      "kind": "skill",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/skills/wolf-skill-intake/SKILL.md",
+      "kind": "skill",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/skills/wolf-testplan/SKILL.md",
+      "kind": "skill",
+      "category": "unchanged"
+    },
+    {
+      "path": "base/skills/writing-skills/SKILL.md",
+      "kind": "skill",
+      "category": "unchanged"
+    },
+    {
+      "path": "opencode/plugins/wolf-router.ts",
+      "kind": "plugin",
+      "category": "unchanged"
+    },
+    {
+      "path": "opencode/plugins/wolf-session-start.js",
+      "kind": "plugin",
+      "category": "unchanged"
+    }
+  ],
+  "faces": [
+    {
+      "template": "base/playbooks/complaint-protocol.md",
+      "owner_skill": "mr-wolf",
+      "category": "unchanged",
+      "seed": true
+    },
+    {
+      "template": "base/playbooks/executor-lead-playbook.md",
+      "owner_skill": "executor-lead",
+      "category": "unchanged",
+      "seed": true
+    },
+    {
+      "template": "base/playbooks/steward-nastavnik.md",
+      "owner_skill": "steward",
+      "category": "unchanged",
+      "seed": true
+    },
+    {
+      "template": "base/playbooks/worker-implementer-playbook.md",
+      "owner_skill": "worker-implementer",
+      "category": "unchanged",
+      "seed": true
+    },
+    {
+      "template": "base/playbooks/worker-researcher-playbook.md",
+      "owner_skill": "worker-researcher",
+      "category": "unchanged",
+      "seed": true
+    },
+    {
+      "template": "base/playbooks/worker-reviewer-playbook.md",
+      "owner_skill": "worker-reviewer",
+      "category": "unchanged",
+      "seed": true
+    }
+  ],
+  "agents_md": {
+    "category": "changed",
+    "mode": "append-block"
+  },
+  "schema_migrations": [],
+  "outside_v1": [
+    "taxonomy (config.yaml memory_types — manual wolf taxonomy)",
+    "tool-skills (generated by wolf tool — not a base-set path)",
+    "local/foreign artifacts (untracked .opencode/* and .wolf/* files)"
+  ]
+}