mister-wolf 2.18.5 → 2.20.0

package/dist/adapters/fs/projects-registry.js

@@ -1,5 +1,5 @@
 import * as fs from 'fs/promises';
-import { mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { mkdirSync, readFileSync, realpathSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import yaml from 'js-yaml';
 import { writeFileAtomic } from './markdown-memory-store.js';
@@ -33,6 +33,31 @@ export class ProjectsRegistry {
         const projects = doc?.projects;
         return Array.isArray(projects) ? projects : [];
     }
+    /**
+     * Строгая альтернатива list() для прохода upgrade (design «Гварды прохода»):
+     * файла нет (ENOENT) → пустой реестр штатно; битый yaml / ошибка чтения →
+     * throw — «реестр нечитаем» обязан отличаться от «реестр пуст» (exit 1 vs 0).
+     */
+    async listStrict() {
+        let raw;
+        try {
+            raw = await fs.readFile(this.file, 'utf-8');
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return []; // реестра ещё нет
+            throw err;
+        }
+        let doc;
+        try {
+            doc = yaml.load(raw);
+        }
+        catch (err) {
+            throw new Error(`failed to read projects registry ${this.file}: ${err.message}`);
+        }
+        const projects = doc?.projects;
+        return Array.isArray(projects) ? projects : [];
+    }
     async register(path, schemaVersion) {
         const projects = await this.list();
         const existing = projects.find((p) => p.path === path);
@@ -100,4 +125,32 @@ export class ProjectsRegistry {
         await writeFileAtomic(this.file, body);
     }
 }
+/**
+ * Дедуп списка проектов по fs.realpathSync(root) (design «Гварды прохода»):
+ * ручные правки yaml могут задублировать один проект symlink'ом/алиас-путём.
+ * Несуществующий путь realpath не резолвится — запись сохраняется как есть
+ * (missing-статус классифицирует проход, не дедуп).
+ */
+export function dedupeByRealpath(projects) {
+    const seen = new Set();
+    const unique = [];
+    const duplicates = [];
+    for (const project of projects) {
+        let real;
+        try {
+            real = realpathSync(project.path);
+        }
+        catch {
+            unique.push(project);
+            continue;
+        }
+        if (seen.has(real))
+            duplicates.push(project);
+        else {
+            seen.add(real);
+            unique.push(project);
+        }
+    }
+    return { unique, duplicates };
+}
 //# sourceMappingURL=projects-registry.js.map

package/dist/adapters/fs/projects-registry.js.map

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

package/dist/adapters/fs/update-map.d.ts

@@ -0,0 +1,102 @@
+import { z } from 'zod';
+export declare const UpdateCategorySchema: z.ZodEnum<{
+    deprecated: "deprecated";
+    new: "new";
+    removed: "removed";
+    unchanged: "unchanged";
+    changed: "changed";
+}>;
+export type UpdateCategory = z.infer<typeof UpdateCategorySchema>;
+export declare const FileKindSchema: z.ZodEnum<{
+    command: "command";
+    agent: "agent";
+    skill: "skill";
+    plugin: "plugin";
+}>;
+export type FileKind = z.infer<typeof FileKindSchema>;
+export declare const FileEntrySchema: z.ZodObject<{
+    path: z.ZodString;
+    kind: z.ZodEnum<{
+        command: "command";
+        agent: "agent";
+        skill: "skill";
+        plugin: "plugin";
+    }>;
+    category: z.ZodEnum<{
+        deprecated: "deprecated";
+        new: "new";
+        removed: "removed";
+        unchanged: "unchanged";
+        changed: "changed";
+    }>;
+}, z.core.$strip>;
+export type FileEntry = z.infer<typeof FileEntrySchema>;
+export declare const FaceEntrySchema: z.ZodObject<{
+    template: z.ZodString;
+    owner_skill: z.ZodString;
+    category: z.ZodEnum<{
+        deprecated: "deprecated";
+        new: "new";
+        removed: "removed";
+        unchanged: "unchanged";
+        changed: "changed";
+    }>;
+    seed: z.ZodBoolean;
+}, z.core.$strip>;
+export type FaceEntry = z.infer<typeof FaceEntrySchema>;
+export declare const UpdateMapSchema: z.ZodObject<{
+    version: z.ZodString;
+    prev: z.ZodString;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        kind: z.ZodEnum<{
+            command: "command";
+            agent: "agent";
+            skill: "skill";
+            plugin: "plugin";
+        }>;
+        category: z.ZodEnum<{
+            deprecated: "deprecated";
+            new: "new";
+            removed: "removed";
+            unchanged: "unchanged";
+            changed: "changed";
+        }>;
+    }, z.core.$strip>>;
+    faces: z.ZodArray<z.ZodObject<{
+        template: z.ZodString;
+        owner_skill: z.ZodString;
+        category: z.ZodEnum<{
+            deprecated: "deprecated";
+            new: "new";
+            removed: "removed";
+            unchanged: "unchanged";
+            changed: "changed";
+        }>;
+        seed: z.ZodBoolean;
+    }, z.core.$strip>>;
+    agents_md: z.ZodObject<{
+        category: z.ZodEnum<{
+            deprecated: "deprecated";
+            new: "new";
+            removed: "removed";
+            unchanged: "unchanged";
+            changed: "changed";
+        }>;
+        mode: z.ZodLiteral<"append-block">;
+    }, z.core.$strip>;
+    schema_migrations: z.ZodArray<z.ZodObject<{
+        from: z.ZodNumber;
+        to: z.ZodNumber;
+    }, z.core.$strip>>;
+    outside_v1: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type UpdateMap = z.infer<typeof UpdateMapSchema>;
+/** Сравнение полных версий X.Y.Z: -1 (a<b) | 0 | 1 (a>b). */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * Читает и валидирует update-map.json из корня пакета. Карта из будущего
+ * (version новее CLI) — честный отказ, не молчаливое использование.
+ */
+export declare function loadUpdateMap(pkgRoot?: string): UpdateMap;
+//# sourceMappingURL=update-map.d.ts.map

package/dist/adapters/fs/update-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-map.d.ts","sourceRoot":"","sources":["../../../src/adapters/fs/update-map.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,oBAAoB;;;;;;EAAmE,CAAC;AACrG,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,cAAc;;;;;EAAkD,CAAC;AAC9E,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;iBAI1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,eAAe;;;;;;;;;;;iBAM1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAW1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,6DAA6D;AAC7D,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAO5D;AAeD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,MAA6B,GAAG,SAAS,CA4B/E"}

package/dist/adapters/fs/update-map.js

@@ -0,0 +1,95 @@
+// src/adapters/fs/update-map.ts
+// T1 (волна 2.19.0, ADR-1): карта обновления — zod-схема wire-формата
+// update-map.json (полный инвентарь состава релиза, корень пакета) и
+// загрузчик из packageRoot. Путь в FileEntry/FaceEntry — относительно
+// templates/ пакета: base/agents/*.md, base/skills/<name>/SKILL.md,
+// base/commands/*.md, base/playbooks/*.md, opencode/plugins/* — те же
+// корни, что обходит templateFiles() рендерера (opencode-renderer.ts).
+import { readFileSync } from 'fs';
+import { join } from 'path';
+import { z } from 'zod';
+import { UserFacingError } from '../../domain/errors.js';
+import { packageRoot as defaultPackageRoot } from '../render/templates-root.js';
+/** Полный X.Y.Z — голые миноры запрещены (AGENTS.md). */
+const SEMVER_RE = /^\d+\.\d+\.\d+$/;
+export const UpdateCategorySchema = z.enum(['new', 'changed', 'unchanged', 'deprecated', 'removed']);
+export const FileKindSchema = z.enum(['agent', 'skill', 'command', 'plugin']);
+export const FileEntrySchema = z.object({
+    path: z.string().min(1),
+    kind: FileKindSchema,
+    category: UpdateCategorySchema,
+});
+export const FaceEntrySchema = z.object({
+    template: z.string().min(1),
+    owner_skill: z.string().min(1),
+    category: UpdateCategorySchema,
+    /** true = сеять недостающее лицо (seed-missing-only); false = репортить, не мутировать (deprecated). */
+    seed: z.boolean(),
+});
+export const UpdateMapSchema = z.object({
+    version: z.string().regex(SEMVER_RE),
+    prev: z.string().regex(SEMVER_RE),
+    /** ВСЕ файловые цели base-set — полный инвентарь, не компоновка дельт. */
+    files: z.array(FileEntrySchema),
+    faces: z.array(FaceEntrySchema),
+    agents_md: z.object({ category: UpdateCategorySchema, mode: z.literal('append-block') }),
+    /** Пусто = релиз без миграций схемы. */
+    schema_migrations: z.array(z.object({ from: z.number().int(), to: z.number().int() })),
+    /** Классы вне покрытия v1 — граница «не трогать чужое» объявлена явно. */
+    outside_v1: z.array(z.string()),
+});
+/** Сравнение полных версий X.Y.Z: -1 (a<b) | 0 | 1 (a>b). */
+export function compareVersions(a, b) {
+    const pa = a.split('.').map(Number);
+    const pb = b.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        if (pa[i] !== pb[i])
+            return (pa[i] ?? 0) < (pb[i] ?? 0) ? -1 : 1;
+    }
+    return 0;
+}
+function readCliVersion(pkgRoot) {
+    let version;
+    try {
+        version = JSON.parse(readFileSync(join(pkgRoot, 'package.json'), 'utf8')).version;
+    }
+    catch {
+        throw new UserFacingError(`package.json not found or corrupted at ${pkgRoot}`);
+    }
+    if (typeof version !== 'string' || !SEMVER_RE.test(version)) {
+        throw new UserFacingError(`package.json at ${pkgRoot} has no valid X.Y.Z version`);
+    }
+    return version;
+}
+/**
+ * Читает и валидирует update-map.json из корня пакета. Карта из будущего
+ * (version новее CLI) — честный отказ, не молчаливое использование.
+ */
+export function loadUpdateMap(pkgRoot = defaultPackageRoot()) {
+    const mapPath = join(pkgRoot, 'update-map.json');
+    let raw;
+    try {
+        raw = readFileSync(mapPath, 'utf8');
+    }
+    catch {
+        throw new UserFacingError(`update-map.json not found at ${mapPath} — reinstall the package`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new UserFacingError(`update-map.json is corrupted (invalid JSON): ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const result = UpdateMapSchema.safeParse(parsed);
+    if (!result.success) {
+        const issue = result.error.issues[0];
+        throw new UserFacingError(`update-map.json is invalid at ${issue.path.join('.')}: ${issue.message}`);
+    }
+    const cliVersion = readCliVersion(pkgRoot);
+    if (compareVersions(result.data.version, cliVersion) > 0) {
+        throw new UserFacingError(`update-map.json version ${result.data.version} is newer than CLI ${cliVersion} — update wolf first`);
+    }
+    return result.data;
+}
+//# sourceMappingURL=update-map.js.map

package/dist/adapters/fs/update-map.js.map

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

package/dist/adapters/fs/upgrade-lock.d.ts

@@ -0,0 +1,23 @@
+/**
+ * TTL lock-файла параллельного upgrade (REQ-01/06): проход, убитый без
+ * release (SIGKILL/OOM), не должен блокировать следующие запуски навсегда —
+ * протухший lock перехватывается. 10 минут ≥ парковый бюджет N03.1 (≤40 с
+ * на 4 проекта) с запасом на медленные окружения.
+ */
+export declare const LOCK_TTL_MS: number;
+/**
+ * Lock-файл параллельного upgrade в ОС-tmp (механика в духе flock, но с
+ * TTL). Владелец — экземпляр в процессе: повторный acquire() тем же
+ * экземпляром идемпотентен; живой чужой lock → Error 'upgrade already
+ * running'; отсутствующий/протухший/битый — захватывается перезаписью.
+ */
+export declare class UpgradeLock {
+    private readonly now;
+    private readonly dir;
+    private readonly held;
+    constructor(now?: () => number, dir?: string);
+    private file;
+    acquire(id: string): boolean;
+    release(id: string): void;
+}
+//# sourceMappingURL=upgrade-lock.d.ts.map

package/dist/adapters/fs/upgrade-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-lock.d.ts","sourceRoot":"","sources":["../../../src/adapters/fs/upgrade-lock.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,eAAO,MAAM,WAAW,QAAiB,CAAC;AAE1C;;;;;GAKG;AACH,qBAAa,WAAW;IAIpB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAJtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;gBAGvB,GAAG,GAAE,MAAM,MAAiB,EAC5B,GAAG,GAAE,MAAiB;IAGzC,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAmB5B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAQ1B"}

package/dist/adapters/fs/upgrade-lock.js

@@ -0,0 +1,59 @@
+import { mkdirSync, readFileSync, unlinkSync, writeFileSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+/**
+ * TTL lock-файла параллельного upgrade (REQ-01/06): проход, убитый без
+ * release (SIGKILL/OOM), не должен блокировать следующие запуски навсегда —
+ * протухший lock перехватывается. 10 минут ≥ парковый бюджет N03.1 (≤40 с
+ * на 4 проекта) с запасом на медленные окружения.
+ */
+export const LOCK_TTL_MS = 10 * 60 * 1000;
+/**
+ * Lock-файл параллельного upgrade в ОС-tmp (механика в духе flock, но с
+ * TTL). Владелец — экземпляр в процессе: повторный acquire() тем же
+ * экземпляром идемпотентен; живой чужой lock → Error 'upgrade already
+ * running'; отсутствующий/протухший/битый — захватывается перезаписью.
+ */
+export class UpgradeLock {
+    now;
+    dir;
+    held = new Set();
+    constructor(now = Date.now, dir = tmpdir()) {
+        this.now = now;
+        this.dir = dir;
+    }
+    file(id) {
+        return join(this.dir, `${id}.lock`);
+    }
+    acquire(id) {
+        if (this.held.has(id))
+            return true; // тот же владелец — идемпотентно
+        let raw;
+        try {
+            raw = readFileSync(this.file(id), 'utf-8');
+        }
+        catch {
+            raw = undefined; // lock-файла нет — захват
+        }
+        if (raw !== undefined) {
+            const ts = Number(raw);
+            if (Number.isFinite(ts) && this.now() - ts < LOCK_TTL_MS)
+                throw new Error('upgrade already running');
+            // протухший (≥ TTL) или битый lock — перезаписываем
+        }
+        mkdirSync(this.dir, { recursive: true });
+        writeFileSync(this.file(id), String(this.now()));
+        this.held.add(id);
+        return true;
+    }
+    release(id) {
+        this.held.delete(id);
+        try {
+            unlinkSync(this.file(id));
+        }
+        catch {
+            // файла нет — уже снят
+        }
+    }
+}
+//# sourceMappingURL=upgrade-lock.js.map

package/dist/adapters/fs/upgrade-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-lock.js","sourceRoot":"","sources":["../../../src/adapters/fs/upgrade-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,OAAO,WAAW;IAIH;IACA;IAJF,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE1C,YACmB,MAAoB,IAAI,CAAC,GAAG,EAC5B,MAAc,MAAM,EAAE;QADtB,QAAG,GAAH,GAAG,CAAyB;QAC5B,QAAG,GAAH,GAAG,CAAmB;IACtC,CAAC;IAEI,IAAI,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC,CAAC,iCAAiC;QACrE,IAAI,GAAuB,CAAC;QAC5B,IAAI,CAAC;YACH,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,GAAG,SAAS,CAAC,CAAC,0BAA0B;QAC7C,CAAC;QACD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,WAAW;gBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YACrG,oDAAoD;QACtD,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrB,IAAI,CAAC;YACH,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;IACH,CAAC;CACF"}

package/dist/adapters/render/opencode/opencode-renderer.d.ts

@@ -1,4 +1,4 @@
-import { BaseSetRenderer, ModelContext, RenderBaseSetOptions, RenderOutcome } from '../../../ports/base-set-renderer.port.js';
+import { BaseSetRenderer, InspectOutcome, ModelContext, ProtectEntry, RenderBaseSetOptions, RenderOutcome, SyncBaseSetOptions } from '../../../ports/base-set-renderer.port.js';
 export declare class OpencodeBaseSetRenderer implements BaseSetRenderer {
     private readonly baseTemplatesRoot;
     private readonly opts;
@@ -12,19 +12,59 @@ export declare class OpencodeBaseSetRenderer implements BaseSetRenderer {
     private templateFiles;
     private walkAbs;
     renderBaseSet(baseDir: string, opts?: RenderBaseSetOptions): Promise<RenderOutcome[]>;
-    syncBaseSet(baseDir: string, models?: ModelContext | 'omit'): Promise<{
+    syncBaseSet(baseDir: string, models?: ModelContext | 'omit', opts?: SyncBaseSetOptions): Promise<{
         outcomes: RenderOutcome[];
         orphaned: string[];
     }>;
+    /** Блочный режим AGENTS.md (§4.5): управляется только текст между маркерами;
+     *  контент выше и ниже — байт-в-байт. protect у AGENTS.md не поддерживается.
+     *  Штампованная цель с блоком (миграция 2.19.0 → 2.20.0, M-1) после замены
+     *  блока получает штамп текущей базы и свидетель; `state` передаёт только
+     *  init-ветка (блочный файл без штампа свидетеля не имеет). */
+    private syncAgentsBlock;
+    /** Штампованная цель с блоком: штамп приводится к текущей базе **на своём
+     *  месте** (позицию задаёт `insertStamp` — после frontmatter, `---` остаётся
+     *  первой строкой). Без нового регекса штампа (§4.4): канонический текст
+     *  `renderStamp` заменяется строкой текущей базы; нестандартную запись штампа
+     *  не переписываем (файл честно останется `mutated`). */
+    private restampAgents;
+    /** Свидетель после обновления блока: только если файл совпал с эталоном
+     *  (EOL отличием не считается — проход приводит его правилом 7). Иначе
+     *  локальный текст вне блока остаётся решением `mutated` и не перезаписывается. */
+    private recordAgentsBase;
+    /** T10 (REQ-08): read-only инспекция целей base-set — предикат того, что
+     *  сделает syncBaseSet, БЕЗ записей (ни writeFileAtomic, ни saveSyncState):
+     *  missing / protected / foreign (unstamped, wx-политика) / identical (в т.ч.
+     *  штамп-дрейф: проходу нечего решать) / differs / mutated / kept. models по
+     *  умолчанию 'omit' — паритет с syncBaseSet, чей исход и предсказываем. */
+    inspectBaseSet(baseDir: string, opts?: RenderBaseSetOptions): Promise<InspectOutcome[]>;
+    /** Реестр защит (§4.11, REQ-09): read-only обход каталогов base-set, включая
+     *  файлы вне карты. AGENTS.md в реестр не входит — protect у него не поддерживается. */
+    listProtections(baseDir: string, base: string): Promise<ProtectEntry[]>;
+    /** Свежий рендер одного файла карты (эталон для `--show` и `behind`); null — вне карты. */
+    renderFreshFile(baseDir: string, rel: string, opts?: RenderBaseSetOptions): string | null;
+    /** Read-only инспекция AGENTS.md (§4.2) — по фактическим веткам управления:
+     *  штампованный цельный файл — зона syncAgentsMd (сверка всего файла со
+     *  штампом, mutated по свидетелю); без штампа — маркер-блок append-ветки
+     *  init (синку не принадлежит, свидетеля не имеет); нет ни штампа, ни
+     *  маркера — чужой файл на месте цели (wx-политика → foreign). */
+    private inspectAgentsMd;
     /** AGENTS.md — цель в КОРНЕ проекта (§4.2); шаблона нет — тихо нет исхода. */
     private agentsMdPaths;
     private agentsMdContent;
     /** Init-ветка AGENTS.md: create (wx + штамп) / marker-append / skip (D3). */
     private renderAgentsMd;
-    /** Sync-ветка AGENTS.md: только штампованный цельный файл; append-блок синку не принадлежит. */
+    /** Sync-ветка AGENTS.md: только штампованный цельный файл; append-блок синку не принадлежит.
+     *  protect у AGENTS.md не поддерживается (§4.5); правила 6/6.5/7 §4.3 действуют,
+     *  включая take-on-mutated (6′) с бэкапом — механизм тот же, что у файлов карты (§4.12). */
     private syncAgentsMd;
+    /** Единый порядок решающих правил §4.3: missing → protect → unstamped →
+     *  identical → штамп-дрейф → mutated → kept → rewrite. Режимы (sync/render/
+     *  inspect) читают это решение и выполняют свою часть (запись или нет). */
+    private classify;
+    /** Свидетель записи: хэш нормализованного контента + происхождение + база (§4.2). */
+    private record;
+    private writeFresh;
     private renderContent;
-    /** Пишет рендер и возвращает записанный контент (T010: хэш для sync-state). */
-    private writeRendered;
 }
 //# sourceMappingURL=opencode-renderer.d.ts.map

package/dist/adapters/render/opencode/opencode-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opencode-renderer.d.ts","sourceRoot":"","sources":["../../../../src/adapters/render/opencode/opencode-renderer.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,eAAe,EAEf,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACd,MAAM,0CAA0C,CAAC;AAuBlD,qBAAa,uBAAwB,YAAW,eAAe;IAI3D,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJvB,EAAE,SAAc;gBAGG,iBAAiB,EAAE,MAAM,EACzB,IAAI,GAAE;QAAE,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO;IAGpF,OAAO,KAAK,UAAU,GAErB;IAED,gFAAgF;IAChF,OAAO,CAAE,aAAa;IAmBtB,OAAO,CAAE,OAAO;IASV,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA8CrF,WAAW,CACf,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;IA8D7D,8EAA8E;IAC9E,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,eAAe;IAKvB,6EAA6E;YAC/D,cAAc;IAyB5B,gGAAgG;YAClF,YAAY;IA2C1B,OAAO,CAAC,aAAa;IASrB,+EAA+E;YACjE,aAAa;CAM5B"}
+{"version":3,"file":"opencode-renderer.d.ts","sourceRoot":"","sources":["../../../../src/adapters/render/opencode/opencode-renderer.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,eAAe,EAEf,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EACnB,MAAM,0CAA0C,CAAC;AAqFlD,qBAAa,uBAAwB,YAAW,eAAe;IAI3D,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJvB,EAAE,SAAc;gBAGG,iBAAiB,EAAE,MAAM,EACzB,IAAI,GAAE;QAAE,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO;IAGpF,OAAO,KAAK,UAAU,GAErB;IAED,gFAAgF;IAChF,OAAO,CAAE,aAAa;IAmBtB,OAAO,CAAE,OAAO;IASV,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA6DrF,WAAW,CACf,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,EAC9B,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAoG7D;;;;mEAI+D;YACjD,eAAe;IA4C7B;;;;6DAIyD;IACzD,OAAO,CAAC,aAAa;IAQrB;;uFAEmF;IACnF,OAAO,CAAC,gBAAgB;IAKxB;;;;+EAI2E;IACrE,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA4C7F;4FACwF;IAClF,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA8B7E,2FAA2F;IAC3F,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI;IAkBzF;;;;sEAIkE;IAClE,OAAO,CAAC,eAAe;IA2BvB,8EAA8E;IAC9E,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,eAAe;IAKvB,6EAA6E;YAC/D,cAAc;IAmC5B;;gGAE4F;YAC9E,YAAY;IA8D1B;;+EAE2E;IAC3E,OAAO,CAAC,QAAQ;IAehB,qFAAqF;IACrF,OAAO,CAAC,MAAM;YAIA,UAAU;IAKxB,OAAO,CAAC,aAAa;CAQtB"}