mister-wolf 2.17.0 → 2.18.0

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

@@ -0,0 +1,343 @@
+import { closeSync, existsSync, linkSync, mkdirSync, openSync, readFileSync, readdirSync, renameSync, statSync, unlinkSync, writeFileSync, } from 'fs';
+import { join } from 'path';
+import { UserFacingError } from '../../domain/errors.js';
+/**
+ * 2.17.1 REQ-05 (R06), design §3.5 / ADR-5: файловый claim-реестр владения
+ * общими артефактами (TASK-бриф, план, отчёт, worktree). JSON-файлы в общем
+ * `.wolf/shared/claims/` (cross-copy видимость — root из resolveMemoryRoot);
+ * атомарный захват — `openSync(…, 'wx')` (механика FsMemoryLock tryAcquire);
+ * stale: PID мёртв (ESRCH) ИЛИ возраст > CLAIM_TTL ИЛИ heartbeat старше окна
+ * (2.18.0 REQ-03); перехват stale сохраняет
+ * прежний файл жёсткой ссылкой в след `<slug>.<epochMs>.json` (excl, NFR-02).
+ */
+/** TTL claim'а: локальный-first (heartbeat — opt-in продление, REQ-03). */
+export const CLAIM_TTL_MS = 24 * 60 * 60 * 1000;
+/** Окно свежести heartbeat (2.18.0 REQ-03, design §3.3 / ADR-7): heartbeat
+ * старше окна — claim stale; независимая величина от CLAIM_TTL_MS (DAP-2). */
+export const CLAIM_HEARTBEAT_WINDOW_MS = 10 * 60 * 1000;
+export class ClaimHeldError extends Error {
+    claimPath;
+    owner;
+    reason;
+    constructor(claimPath, owner, reason) {
+        super(`Claim held by ${owner}: ${claimPath} (${reason})`);
+        this.claimPath = claimPath;
+        this.owner = owner;
+        this.reason = reason;
+        this.name = 'ClaimHeldError';
+    }
+}
+export function claimsDir(root) {
+    return join(root, '.wolf', 'shared', 'claims');
+}
+/** Имя файла claim'а: слэг артефакта, безопасный для ФС.
+ * shortcut: различные артефакты могут слэгнуться одинаково (отказ fail-closed, не порча). */
+export function claimSlug(artifact) {
+    return artifact.replace(/[^A-Za-z0-9._-]+/g, '_');
+}
+export function claimFilePath(root, artifact) {
+    return join(claimsDir(root), `${claimSlug(artifact)}.json`);
+}
+/** След перехвата: `<slug>.<epochMs>.json` (исходные байты сохраняются, NFR-02). */
+export function claimTrailPath(root, artifact, epochMs) {
+    return join(claimsDir(root), `${claimSlug(artifact)}.${epochMs}.json`);
+}
+/** Путь heartbeat-файла артефакта (2.18.0 REQ-03): `<slug>.heartbeat` рядом с claim-файлом. */
+export function heartbeatFilePath(root, artifact) {
+    return join(claimsDir(root), `${claimSlug(artifact)}.heartbeat`);
+}
+/** Чтение heartbeat: null при отсутствии/повреждении — нет heartbeat = правила
+ * 2.17.1 (NFR-03), повреждённый файл = stale (как у claim). */
+export function readHeartbeat(path) {
+    let raw;
+    try {
+        raw = readFileSync(path, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    try {
+        const d = JSON.parse(raw);
+        if (typeof d.written_at !== 'string' || typeof d.writer !== 'string')
+            return null;
+        return { written_at: d.written_at, writer: d.writer };
+    }
+    catch {
+        return null;
+    }
+}
+/** Запись heartbeat (REQ-03, ADR-7): атомарная замена — уникальный tmp (wx) +
+ * rename поверх, поэтому параллельные писатели не ломают JSON, последний
+ * выигрывает, следа (в отличие от claim-перехвата) не остаётся.
+ * shortcut: уникальность tmp через hrtime+Math.random — pid делят воркеры
+ * на macOS, threadId есть только в worker, атомарность через wx+rename. */
+export function writeHeartbeat(deps, input) {
+    const dir = claimsDir(deps.root);
+    mkdirSync(dir, { recursive: true });
+    const now = (deps.now ?? (() => new Date()))();
+    const record = { written_at: now.toISOString(), writer: input.writer };
+    const tag = `${process.hrtime.bigint().toString(36)}.${Math.random().toString(36).slice(2, 10)}`;
+    const tmp = join(dir, `${claimSlug(input.artifact)}.heartbeat.${tag}.tmp`);
+    const fd = openSync(tmp, 'wx');
+    writeFileSync(fd, JSON.stringify(record), 'utf-8');
+    closeSync(fd);
+    try {
+        renameSync(tmp, heartbeatFilePath(deps.root, input.artifact));
+    }
+    catch (e) {
+        try {
+            unlinkSync(tmp);
+        }
+        catch {
+            /* конкурент уже убрал — не маскируем исходную ошибку */
+        }
+        throw e;
+    }
+    return record;
+}
+/** Прод-liveness: signal 0; ESRCH — мёртв, EPERM — жив (чужой user). pid<=0 —
+ * неизвестен (переданный claim) — считаем живым, пока не истечёт TTL. */
+export function pidAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return true;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (e) {
+        return e.code === 'EPERM';
+    }
+}
+/** Синхронное ожидание in-flight окна (MINOR-2): Atomics.wait — без busy-loop. */
+function sleepMs(ms) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+function parseClaim(raw) {
+    try {
+        const d = JSON.parse(raw);
+        if (typeof d.artifact !== 'string' || typeof d.owner !== 'string')
+            return null;
+        return {
+            artifact: d.artifact,
+            owner: d.owner,
+            session_id: typeof d.session_id === 'string' ? d.session_id : null,
+            pid: typeof d.pid === 'number' ? d.pid : 0,
+            cwd: typeof d.cwd === 'string' ? d.cwd : '',
+            acquired_at: typeof d.acquired_at === 'string' ? d.acquired_at : '',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** Stale (design §3.3): мёртвый PID ИЛИ возраст > TTL ИЛИ (heartbeat есть и
+ * старше окна/повреждён); нет heartbeat → правила 2.17.1 (NFR-03). */
+export function isStale(rec, hb, deps) {
+    if (rec === null)
+        return true;
+    const alive = deps.isAlive ?? pidAlive;
+    if (!alive(rec.pid))
+        return true;
+    const acquired = Date.parse(rec.acquired_at);
+    if (Number.isNaN(acquired))
+        return true;
+    const now = (deps.now ?? (() => new Date()))().getTime();
+    if (now - acquired > CLAIM_TTL_MS)
+        return true;
+    if (hb !== null) {
+        const written = Date.parse(hb.written_at);
+        if (Number.isNaN(written))
+            return true; // повреждён = stale
+        if (now - written > CLAIM_HEARTBEAT_WINDOW_MS)
+            return true;
+    }
+    return false;
+}
+function readClaimFile(path) {
+    try {
+        const raw = readFileSync(path, 'utf-8');
+        return { raw, rec: parseClaim(raw) };
+    }
+    catch {
+        return { raw: null, rec: null };
+    }
+}
+function describeHolder(rec) {
+    return `session ${rec.session_id ?? '-'}, pid ${rec.pid}, acquired ${rec.acquired_at}`;
+}
+/** Атомарный захват (REQ-05 AC-1): wx-create; занято и fresh — ClaimHeldError
+ * с идентификатором владельца; stale/порченый — перехват со следом. */
+export function acquireClaim(deps, input) {
+    const dir = claimsDir(deps.root);
+    mkdirSync(dir, { recursive: true });
+    const path = claimFilePath(deps.root, input.artifact);
+    const now = deps.now ?? (() => new Date());
+    const record = {
+        artifact: input.artifact,
+        owner: input.identity.owner,
+        session_id: input.identity.sessionId,
+        pid: input.identity.pid,
+        cwd: input.cwd,
+        acquired_at: now().toISOString(),
+    };
+    for (let attempt = 0;; attempt++) {
+        try {
+            const fd = openSync(path, 'wx');
+            writeFileSync(fd, JSON.stringify(record), 'utf-8');
+            closeSync(fd);
+            return record;
+        }
+        catch (e) {
+            const code = e.code;
+            if (code !== 'EEXIST')
+                throw e;
+        }
+        const { raw, rec } = readClaimFile(path);
+        // MINOR-2 (ревью T5): пустой файл — in-flight окно создателя (между wx и
+        // write), не порча: takeover запрещён, короткое ожидание и повтор
+        if (raw !== null && raw.trim() === '') {
+            if (attempt >= 60) {
+                throw new ClaimHeldError(path, 'unknown', 'claim file exists but stays empty (in-flight write?) — if it persists, remove it manually');
+            }
+            (deps.wait ?? sleepMs)(10);
+            continue;
+        }
+        if (rec !== null && !isStale(rec, readHeartbeat(heartbeatFilePath(deps.root, input.artifact)), deps)) {
+            throw new ClaimHeldError(path, rec.owner, describeHolder(rec));
+        }
+        // stale/порченый (rec === null, сырые байты могли быть) → перехват со следом;
+        // проигранная гонка перехвата (ENOENT на link/unlink) — повтор захвата
+        try {
+            const epoch = now().getTime();
+            // FIX-4 (MINOR-4, ревью T5): след — через linkSync (excl-семантика):
+            // exists+rename TOCTOU позволял двум перехватчикам одной мс перезаписать
+            // чужой след (потеря байтов, NFR-02); при EEXIST — bump эпохи до свободного
+            let preserved = null;
+            for (let bump = 0; bump < 50 && preserved === null; bump++) {
+                const trail = claimTrailPath(deps.root, input.artifact, epoch + bump);
+                try {
+                    linkSync(path, trail);
+                    preserved = trail;
+                }
+                catch (e) {
+                    if (e.code !== 'EEXIST')
+                        throw e;
+                }
+            }
+            if (preserved !== null) {
+                // решение принималось по raw, а слинковаться мог уже переписанный файл
+                // (чужой takeover между чтением и link): чужую свежую запись в след не
+                // берём и claim-имя под ней не освобождаем — перечитаем и откажемся
+                if (raw !== null && readFileSync(preserved, 'utf-8') !== raw) {
+                    unlinkSync(preserved);
+                }
+                else if (statSync(path).ino === statSync(preserved).ino) {
+                    // unlink только сохранённый inode: конкурент мог уже пересоздать claim
+                    unlinkSync(path);
+                }
+            }
+        }
+        catch {
+            /* конкурент уже сохранил/убрал файл — идём на повторный wx */
+        }
+        if (attempt > 20) {
+            throw new ClaimHeldError(path, rec?.owner ?? 'unknown', 'too many contention attempts');
+        }
+    }
+}
+function ownerSessionMatch(rec, identity) {
+    return rec.owner === identity.owner && rec.session_id === identity.sessionId;
+}
+/** Освобождение (design §3.5): владелец — совпадение owner+session+pid.
+ * Освобождение чужим (иной owner/session, или pid записи жив и не совпал) —
+ * отказ с именем владельца. Мёртвый/stale держатель: тот же owner+session
+ * может убрать запись (равносильно перехвату acquire — новой власти не даёт). */
+export function releaseClaim(deps, input) {
+    const path = claimFilePath(deps.root, input.artifact);
+    const { rec } = readClaimFile(path);
+    if (!existsSync(path)) {
+        throw new UserFacingError(`No claim held for "${input.artifact}" (claim file: ${path})`);
+    }
+    if (rec === null) {
+        // FIX-5 (MINOR-5, ревью T5): файл есть, но не читается как claim — «No claim
+        // held» лгало об отсутствии; честный отказ без расширения поведения.
+        throw new UserFacingError(`Claim file for "${input.artifact}" is corrupt — ownership cannot be verified; take over via "wolf claim acquire" (preserves bytes) or remove it manually (claim file: ${path})`);
+    }
+    const fullMatch = ownerSessionMatch(rec, input.identity) && rec.pid === input.identity.pid;
+    const pidReleasable = rec.pid <= 0 || isStale(rec, readHeartbeat(heartbeatFilePath(deps.root, input.artifact)), deps);
+    // MINOR-1b (интегральное ревью 2.17.1): зеркально requireClaim — адресат
+    // transfer (session null + owner) освобождает своей сессией, иначе передача
+    // паркует release до TTL
+    const transferredToWho = rec.session_id === null && rec.owner === input.identity.owner;
+    if (!fullMatch && !transferredToWho && !(ownerSessionMatch(rec, input.identity) && pidReleasable)) {
+        throw new UserFacingError(`Claim for "${input.artifact}" is owned by ${rec.owner} (${describeHolder(rec)}) — release is owner-only (claim file: ${path})`);
+    }
+    if (input.transferTo !== undefined) {
+        const now = (deps.now ?? (() => new Date()))();
+        const transferred = {
+            artifact: rec.artifact,
+            owner: input.transferTo,
+            // новый владелец ещё не предъявил процесс — liveness неизвестна (TTL решает)
+            session_id: null,
+            pid: 0,
+            cwd: rec.cwd,
+            acquired_at: now.toISOString(),
+        };
+        writeFileSync(path, JSON.stringify(transferred), 'utf-8');
+        return { action: 'transferred', owner: input.transferTo };
+    }
+    unlinkSync(path);
+    return { action: 'released', owner: rec.owner };
+}
+/** Реестр для наблюдаемости (REQ-05 AC-2): кто/когда/что из файлов; следы
+ * `<slug>.<epochMs>.json` исключаются — по содержимому: след хранит запись
+ * базового артефакта, его slug ≠ имя файла следа (MINOR-4). */
+export function listClaims(deps) {
+    const dir = claimsDir(deps.root);
+    let names;
+    try {
+        names = readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const name of names) {
+        if (!name.endsWith('.json'))
+            continue;
+        const { rec } = readClaimFile(join(dir, name));
+        if (rec === null)
+            continue;
+        // MINOR-4: имя с 13 цифрами на конце может быть легитимным claim'ом —
+        // след распознаём по несоответствию имени и slug(rec.artifact), не по маске
+        if (claimFilePath(deps.root, rec.artifact) !== join(dir, name))
+            continue;
+        out.push(rec);
+    }
+    return out;
+}
+/** Guard записи (REQ-05 AC-3): активный claim артефакта должен существовать и
+ * принадлежать пишущему (owner+session; pid писателя ≠ pid захватчика —
+ * захват и запись обычно разные процессы). Отказ — UserFacingError с именем
+ * владельца и путём claim-файла. */
+export function requireClaim(deps, artifact, who) {
+    const path = claimFilePath(deps.root, artifact);
+    const { rec } = readClaimFile(path);
+    if (!existsSync(path)) {
+        throw new UserFacingError(`No claim held for "${artifact}" — acquire it first: wolf claim acquire "${artifact}" (claim file: ${path})`);
+    }
+    if (rec === null) {
+        throw new UserFacingError(`Claim file for "${artifact}" is corrupt — treated as stale; re-acquire: wolf claim acquire "${artifact}" (claim file: ${path})`);
+    }
+    if (isStale(rec, readHeartbeat(heartbeatFilePath(deps.root, artifact)), deps)) {
+        throw new UserFacingError(`Claim for "${artifact}" is stale (holder ${rec.owner}) — re-acquire: wolf claim acquire "${artifact}" (claim file: ${path})`);
+    }
+    // MINOR-1 (ревью T5): переданный claim (transfer: session null, pid 0)
+    // доступен адресату с любой его сессией — иначе передача парковала бы
+    // запись до TTL. pid-проверка для pid:0 не применяется (pidAlive).
+    const transferredToWho = rec.session_id === null && rec.owner === who.owner;
+    if (!transferredToWho && (rec.owner !== who.owner || rec.session_id !== who.sessionId)) {
+        throw new UserFacingError(`Artifact "${artifact}" is claimed by ${rec.owner} (${describeHolder(rec)}) — claim file: ${path}`);
+    }
+}
+//# sourceMappingURL=claim-registry.js.map

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

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

package/dist/adapters/fs/memory-root.d.ts

@@ -1,13 +1,38 @@
 export interface MemoryRootInfo {
     /** Корень чекаута, владеющего общим .wolf/ (main-чекоут; вне worktree — сам baseDir). */
     root: string;
-    /** Имя linked worktree или null (main-чекоут / вне git / аномалия). */
+    /** Токен WT-ID linked worktree (`w-<12 hex>`) или null (main-чекоут / вне git / аномалия).
+     * 2.17.1 REQ-02 (R02): токен вместо basename — одинаковые basename двух копий дают
+     * разные идентификаторы; consumer подставляет его в scope как `worktree:${worktree}`. */
     worktree: string | null;
 }
+/** 2.17.1 REQ-02 (R02), design §3.1 (ADR-1): устойчивая идентичность linked worktree. */
+export interface WorktreeIdentity {
+    /** Полный scope-токен копии: `worktree:w-<12 hex sha1(realpath(baseDir))>`. */
+    id: string;
+    /** basename(baseDir) — маппинг legacy-токенов `worktree:<name>` (записанных до 2.17.1). */
+    legacyName: string;
+    /** true — ровно одна живая копия с этим basename: legacy-имя однозначно маппится на неё. */
+    legacyUnique: boolean;
+}
+/** Токен WT-ID без префикса scope: `w-` + первые 12 hex sha1(realpath(dir)).
+ * Идентичность по realpath: одинаковые basename двух копий дают разные токены;
+ * переименование каталога = новая копия с новым WT-ID (ограничение ADR-1). */
+export declare function worktreeScopeToken(dir: string): string;
 /** WP3 §6.1 (спека 2.16): linked worktree резолвит общий .wolf/ в main-чекоуте.
  * Механика спеки — git common-dir (`git rev-parse --git-common-dir`); здесь тот же
  * информационный fs-парс без подпроцессов (прецедент чтения .git/HEAD:
  * heuristic-project-scanner.ts:221-239) — юнит-тестируемо без git, нет подпроцесса
  * в hot-path. Любой сбой — безопасный fallback на локальный .wolf/ (риск Р5 спеки). */
 export declare function resolveMemoryRoot(baseDir: string): MemoryRootInfo;
+/** 2.17.1 REQ-02 (R02), design §3.1 (ADR-1): идентичность linked worktree.
+ * null — main-чекоут, вне git, bare-аномалия, сбой git-метаданных (fail-closed:
+ * legacy-токены не маппятся, чужой scope недоступен — §5).
+ * Вызывать лениво — по встрече legacy-токена (бюджет NFR-01: ≤1 git-подпроцесса
+ * на процесс, только linked worktree; main-чекоут git не запускает). */
+export declare function resolveWorktreeIdentity(baseDir: string): WorktreeIdentity | null;
+/** Каталог выглядит linked worktree (.git — файл-указатель), но метаданные не
+ * резолвятся в общий root: fail-closed предупреждение доставки (REQ-02 AC-5,
+ * design §5 — предупреждение в wolf call). null — не broken (main/outside git). */
+export declare function brokenWorktreeHint(baseDir: string): string | null;
 //# sourceMappingURL=memory-root.d.ts.map

package/dist/adapters/fs/memory-root.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-root.d.ts","sourceRoot":"","sources":["../../../src/adapters/fs/memory-root.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;uFAIuF;AACvF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAmBjE"}
+{"version":3,"file":"memory-root.d.ts","sourceRoot":"","sources":["../../../src/adapters/fs/memory-root.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAC;IACb;;6FAEyF;IACzF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAC/B,+EAA+E;IAC/E,EAAE,EAAE,MAAM,CAAC;IACX,2FAA2F;IAC3F,UAAU,EAAE,MAAM,CAAC;IACnB,4FAA4F;IAC5F,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;8EAE8E;AAC9E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;uFAIuF;AACvF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAmBjE;AAsCD;;;;wEAIwE;AACxE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAWhF;AAED;;mFAEmF;AACnF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWjE"}

package/dist/adapters/fs/memory-root.js

@@ -1,5 +1,13 @@
-import { existsSync, readFileSync } from 'fs';
+import { execFileSync } from 'child_process';
+import { createHash } from 'crypto';
+import { existsSync, readFileSync, realpathSync, statSync } from 'fs';
 import { basename, dirname, isAbsolute, join, resolve } from 'path';
+/** Токен WT-ID без префикса scope: `w-` + первые 12 hex sha1(realpath(dir)).
+ * Идентичность по realpath: одинаковые basename двух копий дают разные токены;
+ * переименование каталога = новая копия с новым WT-ID (ограничение ADR-1). */
+export function worktreeScopeToken(dir) {
+    return 'w-' + createHash('sha1').update(realpathSync(dir)).digest('hex').slice(0, 12);
+}
 /** WP3 §6.1 (спека 2.16): linked worktree резолвит общий .wolf/ в main-чекоуте.
  * Механика спеки — git common-dir (`git rev-parse --git-common-dir`); здесь тот же
  * информационный fs-парс без подпроцессов (прецедент чтения .git/HEAD:
@@ -25,10 +33,88 @@ export function resolveMemoryRoot(baseDir) {
         // bare-репо + linked worktree: commondir указывает мимо чекаута — fallback локальный (Р5)
         if (!existsSync(join(root, '.git')))
             return { root: baseDir, worktree: null };
-        return { root, worktree: basename(baseDir) };
+        return { root, worktree: worktreeScopeToken(baseDir) };
     }
     catch {
         return { root: baseDir, worktree: null };
     }
 }
+/** basename каждой живой записи `git worktree list --porcelain` (включая main-чекоут).
+ * Дубликаты сохраняются: однозначность legacy-имени — счёт, не множество. Кэш на
+ * процесс (NFR-01 (R02): ≤1 git-подпроцесса); null — сбой git-метаданных. */
+const liveBasenamesCache = new Map();
+function liveWorktreeBasenames(baseDir) {
+    let key;
+    try {
+        key = realpathSync(baseDir);
+    }
+    catch {
+        return null;
+    }
+    if (liveBasenamesCache.has(key))
+        return liveBasenamesCache.get(key);
+    let result = null;
+    try {
+        const out = execFileSync('git', ['worktree', 'list', '--porcelain'], {
+            cwd: baseDir,
+            encoding: 'utf-8',
+            timeout: 10_000,
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        result = [];
+        for (const line of out.split('\n')) {
+            if (!line.startsWith('worktree '))
+                continue;
+            try {
+                result.push(basename(realpathSync(line.slice('worktree '.length).trim())));
+            }
+            catch {
+                // каталог записи исчез — git пометит prunable; в счёт живых он не входит
+            }
+        }
+    }
+    catch {
+        result = null; // битые git-метаданные — fail-closed (design §5)
+    }
+    liveBasenamesCache.set(key, result);
+    return result;
+}
+/** 2.17.1 REQ-02 (R02), design §3.1 (ADR-1): идентичность linked worktree.
+ * null — main-чекоут, вне git, bare-аномалия, сбой git-метаданных (fail-closed:
+ * legacy-токены не маппятся, чужой scope недоступен — §5).
+ * Вызывать лениво — по встрече legacy-токена (бюджет NFR-01: ≤1 git-подпроцесса
+ * на процесс, только linked worktree; main-чекоут git не запускает). */
+export function resolveWorktreeIdentity(baseDir) {
+    const info = resolveMemoryRoot(baseDir);
+    if (info.worktree === null)
+        return null;
+    const live = liveWorktreeBasenames(baseDir);
+    if (live === null)
+        return null;
+    const legacyName = basename(baseDir);
+    return {
+        id: `worktree:${info.worktree}`,
+        legacyName,
+        legacyUnique: live.filter((n) => n === legacyName).length === 1,
+    };
+}
+/** Каталог выглядит linked worktree (.git — файл-указатель), но метаданные не
+ * резолвятся в общий root: fail-closed предупреждение доставки (REQ-02 AC-5,
+ * design §5 — предупреждение в wolf call). null — не broken (main/outside git). */
+export function brokenWorktreeHint(baseDir) {
+    try {
+        const dotGit = join(baseDir, '.git');
+        if (!existsSync(dotGit) || statSync(dotGit).isDirectory())
+            return null;
+        const raw = readFileSync(dotGit, 'utf-8');
+        if (!raw.startsWith('gitdir:'))
+            return null;
+        if (resolveMemoryRoot(baseDir).worktree !== null)
+            return null;
+        return `worktree git metadata is broken in ${baseDir} — delivery is fail-closed, worktree-scoped memory stays hidden`;
+    }
+    catch {
+        return null;
+    }
+}
 //# sourceMappingURL=memory-root.js.map

package/dist/adapters/fs/memory-root.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-root.js","sourceRoot":"","sources":["../../../src/adapters/fs/memory-root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AASpE;;;;uFAIuF;AACvF,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAClE,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,iBAAiB;QACjG,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1E,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,qBAAqB;QAC/F,MAAM,GAAG,GAAG,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACxD,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAClE,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;QACnC,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC/D,0FAA0F;QAC1F,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC9E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC3C,CAAC;AACH,CAAC"}
+{"version":3,"file":"memory-root.js","sourceRoot":"","sources":["../../../src/adapters/fs/memory-root.ts"],"names":[],"mappings":"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"}

package/dist/app/use-cases/build-analytics.d.ts

@@ -7,6 +7,7 @@ import type { MemoryStore } from '../../ports/memory-store.port.js';
 import type { EventLog } from '../../ports/event-log.port.js';
 import type { RelationLog } from '../../ports/relation-log.port.js';
 import type { Clock } from '../../ports/clock.port.js';
+import type { MemoryObject } from '../../domain/schemas/memory-object-schema.js';
 import { type SignalEvent } from '../../adapters/fs/session-metrics-log.js';
 import { type EconomyResult } from '../../domain/tool-economy.js';
 import type { RouterLogRow } from '../../domain/router-log.js';
@@ -395,6 +396,10 @@ export interface CouncilsView {
         sharePct: number | null;
         medianHours: number | null;
     };
+    /** A9 (2.18.0 REQ-01): сколько мнений несут claims (аудируемые), и суммарный
+     * неразрешённый dissent по синтезам — расширение, не замена прежних полей. */
+    audited_count: number;
+    unresolved_dissent_total: number;
     weeks: CouncilWeekActivity[];
     openQuestions: CouncilOpenQuestion[];
 }
@@ -467,6 +472,23 @@ export declare function parseSkillInvocations(text: string): {
     rows: SkillInvocationRow[];
     malformedLines: number;
 };
+/** A9 (2.18.0 REQ-01, NFR-01): claims мнения; legacy-запись без поля → [] —
+ * чтение исторических советов не падает и не даёт мусора. */
+export declare function extractClaims(op: MemoryObject): string[];
+/** A9: метаданные синтеза (5 полей v2-контракта, design §3.1). */
+export interface SynthesisMeta {
+    accepted_claims: string[];
+    rejected_alternatives: {
+        claim: string;
+        reason: string;
+    }[];
+    unresolved_dissent: string[];
+    confidence: MemoryObject['confidence'];
+    required_validation: string[];
+}
+/** A9: v2-метаданные синтеза; legacy-синтез без новых полей → пустые списки и
+ * confidence 'medium' (ADR-9) — чтение не падает (NFR-01). */
+export declare function extractSynthesisMeta(s: MemoryObject): SynthesisMeta;
 /**
  * Полный аналитический отчёт M5 из трёх портов: чистая агрегация, детерминированная.
  * Не падает на пустой памяти — все блоки возвращают нули/null/пустые массивы.