mister-wolf 2.19.0 → 2.20.1

package/dist/domain/line-diff.d.ts

@@ -0,0 +1,36 @@
+export interface DiffLine {
+    kind: 'context' | 'del' | 'add';
+    text: string;
+}
+export interface DiffHunk {
+    /** 1-based стартовые номера и длины сторон (как в unified diff). */
+    aStart: number;
+    aLines: number;
+    bStart: number;
+    bLines: number;
+    lines: DiffLine[];
+}
+export interface LineDiffResult {
+    hunks: DiffHunk[];
+    /** Число добавленных/удалённых строк (для заголовков `−N +M`). */
+    added: number;
+    removed: number;
+    /** Сколько строк содержимого скрыто лимитом вывода. */
+    truncated: number;
+    /** Вход был длиннее maxInput и обрезан (лимит §4.10). */
+    inputTruncated: boolean;
+}
+export interface LineDiffLimits {
+    maxInput?: number;
+    maxOutput?: number;
+    /** Строк контекста вокруг изменения (по умолчанию 2). */
+    context?: number;
+}
+/**
+ * Diff двух текстов (a — «было», b — «стало»): хунки с контекстом, счётчики
+ * изменений, обрезка вывода по maxOutput (скрытые строки → `truncated`).
+ */
+export declare function lineDiff(aText: string, bText: string, limits?: LineDiffLimits): LineDiffResult;
+/** Текстовое представление diff (unified-подобное): заголовки хунков и строки. */
+export declare function formatDiff(result: LineDiffResult): string[];
+//# sourceMappingURL=line-diff.d.ts.map

package/dist/domain/line-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-diff.d.ts","sourceRoot":"","sources":["../../src/domain/line-diff.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,SAAS,GAAG,KAAK,GAAG,KAAK,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA2GD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,cAAmB,GAAG,cAAc,CA4ClG;AAED,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAW3D"}

package/dist/domain/line-diff.js

@@ -0,0 +1,175 @@
+// src/domain/line-diff.ts
+// T8 (волна 2.20.0, REQ-08, design §4.10): построчный LCS-diff для `--show` и
+// `--review`. Без внешних зависимостей, детерминирован: при равной длине LCS
+// удаление идёт раньше вставки, хунки — от начала файла. Лимиты — вход
+// (maxInput строк на сторону) и вывод (maxOutput строк содержимого, далее
+// «… ещё N строк»). EOL нормализуется: `\r` не делает каждую строку изменённой.
+const DEFAULT_MAX_INPUT = 4000;
+const DEFAULT_MAX_OUTPUT = 200;
+const DEFAULT_CONTEXT = 2;
+/** Порог DP LCS: при n×m больше — блок считается заменой (детерминированно). */
+const DP_CELL_LIMIT = 4_000_000;
+const toLines = (source) => {
+    const normalized = source.replace(/\r\n/g, '\n');
+    const lines = normalized.split('\n');
+    if (lines.length > 0 && lines[lines.length - 1] === '')
+        lines.pop();
+    return lines;
+};
+function middleOps(a, b) {
+    const n = a.length;
+    const m = b.length;
+    if (n === 0)
+        return b.map((text) => ({ kind: 'add', text }));
+    if (m === 0)
+        return a.map((text) => ({ kind: 'del', text }));
+    if (n * m > DP_CELL_LIMIT) {
+        return [...a.map((text) => ({ kind: 'del', text })), ...b.map((text) => ({ kind: 'add', text }))];
+    }
+    const width = m + 1;
+    const dp = new Uint32Array((n + 1) * width);
+    for (let i = n - 1; i >= 0; i--) {
+        for (let j = m - 1; j >= 0; j--) {
+            dp[i * width + j] =
+                a[i] === b[j] ? dp[(i + 1) * width + j + 1] + 1 : Math.max(dp[(i + 1) * width + j], dp[i * width + j + 1]);
+        }
+    }
+    const ops = [];
+    let i = 0;
+    let j = 0;
+    while (i < n && j < m) {
+        if (a[i] === b[j]) {
+            ops.push({ kind: 'equal', text: a[i] });
+            i++;
+            j++;
+        }
+        else if (dp[(i + 1) * width + j] >= dp[i * width + j + 1]) {
+            ops.push({ kind: 'del', text: a[i] });
+            i++;
+        }
+        else {
+            ops.push({ kind: 'add', text: b[j] });
+            j++;
+        }
+    }
+    while (i < n)
+        ops.push({ kind: 'del', text: a[i++] });
+    while (j < m)
+        ops.push({ kind: 'add', text: b[j++] });
+    return ops;
+}
+/** Полный список операций: общий префикс/суффикс не входят в DP. */
+function diffOps(a, b) {
+    let start = 0;
+    while (start < a.length && start < b.length && a[start] === b[start])
+        start++;
+    let endA = a.length;
+    let endB = b.length;
+    while (endA > start && endB > start && a[endA - 1] === b[endB - 1]) {
+        endA--;
+        endB--;
+    }
+    const ops = a.slice(0, start).map((text) => ({ kind: 'equal', text }));
+    ops.push(...middleOps(a.slice(start, endA), b.slice(start, endB)));
+    for (let i = endA; i < a.length; i++)
+        ops.push({ kind: 'equal', text: a[i] });
+    return ops;
+}
+/** Группировка в хунки: изменения ближе 2×context сливаются, иначе — отдельные. */
+function toHunks(ops, context) {
+    // префиксные счётчики сторон: сколько строк a/b прошло до индекса k
+    const aBefore = new Uint32Array(ops.length + 1);
+    const bBefore = new Uint32Array(ops.length + 1);
+    for (let k = 0; k < ops.length; k++) {
+        aBefore[k + 1] = aBefore[k] + (ops[k].kind === 'add' ? 0 : 1);
+        bBefore[k + 1] = bBefore[k] + (ops[k].kind === 'del' ? 0 : 1);
+    }
+    const ranges = [];
+    let lastChange = -1;
+    for (let i = 0; i < ops.length; i++) {
+        if (ops[i].kind === 'equal')
+            continue;
+        const end = Math.min(ops.length - 1, i + context);
+        const last = ranges[ranges.length - 1];
+        // равный промежуток ≤ 2×context → тот же хунк (стандартное слияние)
+        if (last && lastChange >= 0 && i - lastChange - 1 <= 2 * context)
+            last[1] = Math.max(last[1], end);
+        else
+            ranges.push([Math.max(0, i - context), end]);
+        lastChange = i;
+    }
+    return ranges.map(([start, end]) => {
+        const lines = ops.slice(start, end + 1).map((op) => ({ kind: op.kind, text: op.text }));
+        return {
+            aStart: aBefore[start] + 1,
+            aLines: aBefore[end + 1] - aBefore[start],
+            bStart: bBefore[start] + 1,
+            bLines: bBefore[end + 1] - bBefore[start],
+            lines,
+        };
+    });
+}
+/**
+ * Diff двух текстов (a — «было», b — «стало»): хунки с контекстом, счётчики
+ * изменений, обрезка вывода по maxOutput (скрытые строки → `truncated`).
+ */
+export function lineDiff(aText, bText, limits = {}) {
+    const maxInput = limits.maxInput ?? DEFAULT_MAX_INPUT;
+    const maxOutput = limits.maxOutput ?? DEFAULT_MAX_OUTPUT;
+    const context = limits.context ?? DEFAULT_CONTEXT;
+    if (aText === bText) {
+        return { hunks: [], added: 0, removed: 0, truncated: 0, inputTruncated: false };
+    }
+    let a = toLines(aText);
+    let b = toLines(bText);
+    const inputTruncated = a.length > maxInput || b.length > maxInput;
+    if (a.length > maxInput)
+        a = a.slice(0, maxInput);
+    if (b.length > maxInput)
+        b = b.slice(0, maxInput);
+    const ops = diffOps(a, b);
+    const added = ops.filter((op) => op.kind === 'add').length;
+    const removed = ops.filter((op) => op.kind === 'del').length;
+    const all = toHunks(ops, context);
+    const hunks = [];
+    let budget = maxOutput;
+    let hidden = 0;
+    for (const hunk of all) {
+        if (budget <= 0) {
+            hidden += hunk.lines.length;
+            continue;
+        }
+        if (hunk.lines.length <= budget) {
+            hunks.push(hunk);
+            budget -= hunk.lines.length;
+            continue;
+        }
+        hunks.push({ ...hunk, lines: hunk.lines.slice(0, budget), aLines: 0, bLines: 0 });
+        hidden += hunk.lines.length - budget;
+        budget = 0;
+    }
+    // длины сторон обрезанного хунка пересчитываются по фактическим строкам
+    for (const hunk of hunks) {
+        if (hunk.aLines === 0 && hunk.bLines === 0 && hunk.lines.length > 0) {
+            hunk.aLines = hunk.lines.filter((l) => l.kind !== 'add').length;
+            hunk.bLines = hunk.lines.filter((l) => l.kind !== 'del').length;
+        }
+    }
+    return { hunks, added, removed, truncated: hidden, inputTruncated };
+}
+/** Текстовое представление diff (unified-подобное): заголовки хунков и строки. */
+export function formatDiff(result) {
+    const out = [];
+    for (const hunk of result.hunks) {
+        out.push(`@@ -${hunk.aStart},${hunk.aLines} +${hunk.bStart},${hunk.bLines} @@`);
+        for (const line of hunk.lines) {
+            out.push(`${line.kind === 'del' ? '-' : line.kind === 'add' ? '+' : ' '}${line.text}`);
+        }
+    }
+    if (result.truncated > 0)
+        out.push(`… ${result.truncated} more lines`);
+    if (result.inputTruncated)
+        out.push('… input truncated to the line limit');
+    return out;
+}
+//# sourceMappingURL=line-diff.js.map

package/dist/domain/line-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-diff.js","sourceRoot":"","sources":["../../src/domain/line-diff.ts"],"names":[],"mappings":"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"}

package/dist/domain/protect-key.d.ts

@@ -0,0 +1,21 @@
+/** Разобранное значение ключа: `true` / `X.Y.Z` / null (false, пусто, вне грамматики). */
+export interface ProtectValue {
+    /** Держать локальный контент (в т.ч. fail-safe для недописанного/битого значения). */
+    held: boolean;
+    value: 'true' | string | null;
+    raw: string | null;
+    /** Значение вне грамматики (`yes`, `2.19`, кавычки, пусто) — держим, но предупреждаем (ADR-5). */
+    unrecognized?: true;
+}
+export interface InsertProtectResult {
+    content: string;
+    changed: boolean;
+    error?: 'no-yaml-frontmatter' | 'frontmatter-unparsable';
+}
+export declare function parseProtect(content: string): ProtectValue;
+/** Контент без строк ключа (все они, внутри frontmatter): единая база сравнения и свидетеля. */
+export declare function normalizeManaged(content: string): string;
+export declare function insertProtect(content: string, value: 'true' | string): InsertProtectResult;
+/** Снятие: удаляет все строки ключа, остальное байт-в-байт. */
+export declare function removeProtect(content: string): string;
+//# sourceMappingURL=protect-key.d.ts.map

package/dist/domain/protect-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protect-key.d.ts","sourceRoot":"","sources":["../../src/domain/protect-key.ts"],"names":[],"mappings":"AAMA,0FAA0F;AAC1F,MAAM,WAAW,YAAY;IAC3B,sFAAsF;IACtF,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC9B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,kGAAkG;IAClG,YAAY,CAAC,EAAE,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,qBAAqB,GAAG,wBAAwB,CAAC;CAC1D;AAwCD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAe1D;AAED,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,mBAAmB,CA6B1F;AAWD,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/domain/protect-key.js

@@ -0,0 +1,112 @@
+// src/domain/protect-key.ts
+// REQ-05 (design §4.1): единственная точка правды о ключе `protect` в
+// YAML-frontmatter. Чистая логика без I/O: грамматика (parseProtect),
+// нормализация (normalizeManaged), вставка/снятие ключа построчной правкой.
+// Регекса штампа `wolf:rendered` здесь нет — он живёт только в stamp.ts (§4.4).
+const FENCE = '---';
+const KEY_LINE = /^protect\s*:\s*(.*?)\s*$/;
+/** Строка ключа в блоке — для нормализации (шире грамматики: снимаем и `false`). */
+const KEY_ANY = /^protect\s*:/;
+const FULL_VERSION = /^\d+\.\d+\.\d+$/;
+function splitLines(content) {
+    const out = [];
+    let i = 0;
+    while (i < content.length) {
+        const nl = content.indexOf('\n', i);
+        if (nl === -1) {
+            out.push({ text: content.slice(i), eol: '' });
+            break;
+        }
+        const crlf = nl > i && content[nl - 1] === '\r';
+        out.push({ text: content.slice(i, crlf ? nl - 1 : nl), eol: crlf ? '\r\n' : '\n' });
+        i = nl + 1;
+    }
+    return out;
+}
+const joinLines = (lines) => lines.map((l) => l.text + l.eol).join('');
+/** Границы frontmatter в строках: первая строка файла — `---`, закрывающая — следующая `---`. */
+function frontmatter(lines) {
+    if (lines.length === 0 || lines[0].text !== FENCE)
+        return null;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].text === FENCE)
+            return { open: 0, close: i };
+    }
+    return null;
+}
+export function parseProtect(content) {
+    const lines = splitLines(content);
+    const fm = frontmatter(lines);
+    if (!fm)
+        return { held: false, value: null, raw: null };
+    for (let i = fm.open + 1; i < fm.close; i++) {
+        const m = lines[i].text.match(KEY_LINE);
+        if (!m)
+            continue;
+        const raw = m[1];
+        if (raw === '' || raw === '~' || raw === 'null')
+            return { held: true, value: null, raw, unrecognized: true };
+        if (raw === 'true')
+            return { held: true, value: 'true', raw };
+        if (raw === 'false')
+            return { held: false, value: null, raw };
+        if (FULL_VERSION.test(raw))
+            return { held: true, value: raw, raw };
+        return { held: true, value: null, raw, unrecognized: true };
+    }
+    return { held: false, value: null, raw: null };
+}
+/** Контент без строк ключа (все они, внутри frontmatter): единая база сравнения и свидетеля. */
+export function normalizeManaged(content) {
+    const lines = splitLines(content);
+    const fm = frontmatter(lines);
+    if (!fm)
+        return content;
+    const kept = lines.filter((l, i) => !(i > fm.open && i < fm.close && KEY_ANY.test(l.text)));
+    return joinLines(kept);
+}
+export function insertProtect(content, value) {
+    const lines = splitLines(content);
+    const fm0 = frontmatter(lines);
+    if (!fm0)
+        return { content, changed: false, error: 'no-yaml-frontmatter' };
+    const normalized = lines.filter((l, i) => !(i > fm0.open && i < fm0.close && KEY_ANY.test(l.text)));
+    const fm = frontmatter(normalized);
+    if (!fm)
+        return { content, changed: false, error: 'frontmatter-unparsable' };
+    const closeEol = normalized[fm.close].eol === '\r\n' ? '\r\n' : '\n';
+    const result = joinLines([
+        ...normalized.slice(0, fm.close),
+        { text: `protect: ${value}`, eol: closeEol },
+        ...normalized.slice(fm.close),
+    ]);
+    // Структурная проверка ДО возврата (§4.1 п.3): границы блока, распознавание значения,
+    // взаимная обратимость с нормализацией. Файл пишет вызывающий — но только валидный контент.
+    const check = splitLines(result);
+    const fm1 = frontmatter(check);
+    if (!fm1 || fm1.close !== fm.close + 1 || check[fm1.close].text !== FENCE) {
+        return { content, changed: false, error: 'frontmatter-unparsable' };
+    }
+    const parsed = parseProtect(result);
+    const expected = value === 'true' ? parsed.held && parsed.value === 'true' : parsed.held && parsed.value === value;
+    if (!expected)
+        return { content, changed: false, error: 'frontmatter-unparsable' };
+    if (reinstateProtectLine(result, value) !== result) {
+        return { content, changed: false, error: 'frontmatter-unparsable' };
+    }
+    return { content: result, changed: result !== content };
+}
+/** Обратимость (в): нормализованный контент + строка ключа перед закрывающим `---`. */
+function reinstateProtectLine(content, value) {
+    const lines = splitLines(normalizeManaged(content));
+    const fm = frontmatter(lines);
+    if (!fm)
+        return content;
+    const eol = lines[fm.close].eol === '\r\n' ? '\r\n' : '\n';
+    return joinLines([...lines.slice(0, fm.close), { text: `protect: ${value}`, eol }, ...lines.slice(fm.close)]);
+}
+/** Снятие: удаляет все строки ключа, остальное байт-в-байт. */
+export function removeProtect(content) {
+    return normalizeManaged(content);
+}
+//# sourceMappingURL=protect-key.js.map

package/dist/domain/protect-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protect-key.js","sourceRoot":"","sources":["../../src/domain/protect-key.ts"],"names":[],"mappings":"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"}

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

@@ -7,6 +7,14 @@ export interface RenderOutcome {
      *  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 {
@@ -15,12 +23,30 @@ export interface ModelContext {
 }
 /** Действие read-only инспекции цели (T10, REQ-08, design §«--check»): цель
  *  сверяется с текущим рендером без единой записи на диск. foreign — unstamped
- *  файл на месте цели (wx-политика: чужое, вне покрытия). */
-export type InspectAction = 'identical' | 'differs' | 'missing' | 'mutated' | 'foreign' | 'unknown';
+ *  файл на месте цели (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). */
@@ -34,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). */
@@ -43,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;IAChB;;sCAEkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,gGAAgG;AAChG,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;6DAE6D;AAC7D,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEpG,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;CACvB;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/dist/ports/platform-adapter.port.d.ts

@@ -40,18 +40,24 @@ export interface PlatformAdapter {
      * Идемпотентная запись wolf-сервера (ключ идемпотентности — имя MCP-сервера 'wolf'):
      * 'written' — создан, 'replaced' — существующая запись wolf перезаписана (в т.ч. ручная
      * dev-запись), 'unchanged' — уже канонический. Чужие серверы и секции не трогаются.
-     * opencode мерджит ещё и default_agent/subagent_depth (§6.1): конфликт — unchanged + reason.
+     * opencode мерджит ещё и default_agent/subagent_depth (§6.1) — глубина живёт в
+     * `experimental.subagent_depth` (opencode v2; верхнеуровневый ключ deprecated): конфликт — unchanged + reason.
      */
     writeConfig(projectRoot: string, cmd: McpCommand): Promise<PlatformWriteResult>;
     /** Удалить wolf-запись (для --platform replace-семантики); true если удалил. */
     removeWolf(projectRoot: string): Promise<boolean>;
     /**
      * 2.16.2 (uninstall): удалить ТОЛЬКО wolf-ключи с ТОЧНЫМ нашим значением
-     * (mcp.wolf / mcpServers.wolf; default_agent === mr-wolf; subagent_depth === 2 —
+     * (mcp.wolf / mcpServers.wolf; default_agent === mr-wolf; experimental.subagent_depth === 2 —
      * пользовательскую повышенную настройку не трогаем). Отсутствующий конфиг —
      * { action: 'skipped', reason }.
      */
     removeWolfKeys?(projectRoot: string): Promise<PlatformWriteResult>;
+    /**
+     * Строки проблем конфига, которые знает только адаптер (6.2/6.3: обе формы MCP-записи).
+     * Нет метода — doctor делает generic-проверку wolf-записи.
+     */
+    configIssues?(projectRoot: string): Promise<string[]>;
     /** Детект версии платформы (опционально; init не ломается, если адаптер не умеет). */
     detectVersion?(projectRoot: string): Promise<PlatformVersionInfo>;
 }

package/dist/ports/platform-adapter.port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-adapter.port.d.ts","sourceRoot":"","sources":["../../src/ports/platform-adapter.port.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,8EAA8E;AAC9E,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD,2HAA2H;AAC3H,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mGAAmG;IACnG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gHAAgH;IAChH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,GAAG,IAAI,GAAG,aAAa,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE3F,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,yDAAyD;IACzD,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAChE;;;;;OAKG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChF,gFAAgF;IAChF,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD;;;;;OAKG;IACH,cAAc,CAAC,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACnE,sFAAsF;IACtF,aAAa,CAAC,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACnE"}
+{"version":3,"file":"platform-adapter.port.d.ts","sourceRoot":"","sources":["../../src/ports/platform-adapter.port.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,8EAA8E;AAC9E,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD,2HAA2H;AAC3H,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mGAAmG;IACnG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gHAAgH;IAChH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,GAAG,IAAI,GAAG,aAAa,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE3F,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,yDAAyD;IACzD,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAChE;;;;;;OAMG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChF,gFAAgF;IAChF,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD;;;;;OAKG;IACH,cAAc,CAAC,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACnE;;;OAGG;IACH,YAAY,CAAC,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACtD,sFAAsF;IACtF,aAAa,CAAC,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACnE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mister-wolf",
-  "version": "2.19.0",
+  "version": "2.20.1",
   "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-24T17:36:23.551Z agent-id=v2-router-probe-xyz playbook=hit name=fallback variant=fallback source=default resolution=error face_id=- version=- hash=- session=opc-277ab5c4-acf5-40ed-bfb9-6037555e3f73 injected=yes ms=1 bytes=1274
+2026-10-25T20:17:27.443Z agent-id=v2-router-probe-xyz playbook=hit name=fallback variant=fallback source=default resolution=error face_id=- version=- hash=- session=opc-4200d069-b038-4694-a9a6-3509841abc3c injected=yes ms=1 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

@@ -1,6 +1,6 @@
 {
-  "version": "2.19.0",
-  "prev": "2.18.5",
+  "version": "2.20.1",
+  "prev": "2.20.0",
   "files": [
     {
       "path": "base/agents/executor-lead.md",