@spec-box/sdd 0.6.4

package/dist/core/project-docs.js

@@ -0,0 +1,246 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import YAML from 'yaml';
+import { diag } from './diagnostics.js';
+import { exists, readText, toPosix } from './paths.js';
+export const DOC_CATEGORIES = [
+    {
+        id: 'product',
+        file: 'overview.md',
+        title: 'Продукт и границы',
+        questions: 'Что за продукт, кто пользователи, какие системы рядом, где живёт код, где истина спецификаций',
+        sections: ['Что за продукт', 'Пользователи', 'Системы рядом', 'Где живёт код', 'Истина спецификаций'],
+        readers: ['researcher', 'planner', 'challenger'],
+        required: true,
+    },
+    {
+        id: 'architecture',
+        file: 'architecture.md',
+        title: 'Архитектура и карта кода',
+        questions: 'Какие пакеты и модули есть, точки входа, поток данных, где что лежит, границы модулей, генерируемый код',
+        sections: ['Карта пакетов и модулей', 'Точки входа', 'Поток данных', 'Границы модулей', 'Генерируемый код'],
+        readers: ['researcher', 'planner', 'implementer', 'challenger'],
+        required: true,
+    },
+    {
+        id: 'conventions',
+        file: 'conventions.md',
+        title: 'Соглашения по коду',
+        questions: 'Язык кода и комментариев, стиль, запрещённые конструкции, именование, правила коммитов',
+        sections: ['Язык', 'Стиль', 'Запрещено', 'Именование', 'Коммиты'],
+        readers: ['implementer', 'reviewer', 'tester'],
+        required: true,
+    },
+    {
+        id: 'testing',
+        file: 'testing.md',
+        title: 'Тестирование и проверки',
+        questions: 'Уровни тестов, команды узкого и полного прогона, пути отчётов, правило именования тестов по сценариям, среда e2e, что нельзя автоматизировать',
+        sections: ['Уровни тестов', 'Команды', 'Отчёты', 'Именование тестов по сценариям', 'Среда e2e', 'Не автоматизируется'],
+        readers: ['tester', 'implementer', 'verifier', 'reviewer'],
+        required: true,
+    },
+    {
+        id: 'workflow',
+        file: 'workflow.md',
+        title: 'Рабочий процесс',
+        questions: 'Ветки, пул-реквесты, обязательные проверки CI, что запрещено без человека, разрешённые команды для агентов',
+        sections: ['Ветки', 'Пул-реквесты', 'Проверки CI', 'Запрещено без человека', 'Разрешённые команды'],
+        readers: ['implementer', 'tester', 'verifier'],
+        required: true,
+    },
+    {
+        id: 'glossary',
+        file: 'glossary.md',
+        title: 'Словарь домена',
+        questions: 'Термины в формулировках, которыми пишутся спецификации и тесты',
+        sections: ['Термины'],
+        readers: ['researcher', 'planner', 'tester', 'implementer', 'reviewer', 'verifier', 'challenger'],
+        required: true,
+    },
+    {
+        id: 'contracts',
+        file: 'contracts.md',
+        title: 'Интеграции и контракты',
+        questions: 'Внешние API, события, схемы, кто потребитель, где лежат машиночитаемые контракты, репозитории-партнёры',
+        sections: ['Внешние API', 'События', 'Схемы', 'Потребители', 'Машиночитаемые контракты'],
+        readers: ['planner', 'tester', 'challenger'],
+        required: false,
+    },
+];
+export const DOC_FRONTMATTER_FIELDS = ['id', 'summary', 'read_when', 'updated', 'verification'];
+const VERIFICATION_VALUES = new Set(['verified', 'needs-review']);
+const PLACEHOLDER = /(\bTODO\b|\bTBD\b|\bFIXME\b|\{\{[^}]+\}\}|<заполн[^>]*>|<fill[^>]*>)/iu;
+export function parseDoc(text) {
+    let frontmatter = {};
+    let body = text;
+    const m = text.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/);
+    if (m) {
+        try {
+            frontmatter = YAML.parse(m[1]) ?? {};
+        }
+        catch {
+            frontmatter = { __invalid: true };
+        }
+        body = text.slice(m[0].length);
+    }
+    const headings = [];
+    body.split(/\r?\n/).forEach((line, i) => {
+        const h = line.match(/^(#{1,6})\s+(.+?)\s*#*\s*$/);
+        if (h)
+            headings.push({ level: h[1].length, text: h[2].trim(), line: i + 1 });
+    });
+    return { frontmatter, body, headings };
+}
+export function docsDir(root, config) {
+    return path.join(root, config.project.docs);
+}
+export function docsForRole(role) {
+    return DOC_CATEGORIES.filter((c) => c.readers.includes(role));
+}
+const norm = (s) => s.toLowerCase().replace(/[^\p{L}\p{N}]+/gu, ' ').trim();
+/** Структурный уровень `sbox doctor`: наличие, фронтматтер, разделы, заглушки, ссылки на пути и команды, правила. */
+export function doctorDocs(root, config) {
+    const out = [];
+    const dir = docsDir(root, config);
+    if (!exists(dir)) {
+        out.push(diag('error', 'DOCS_DIR_MISSING', `Нет каталога проектной документации ${toPosix(path.relative(root, dir))}`, undefined, 'Выполните `sbox init`.'));
+        return out;
+    }
+    const scripts = readPackageScripts(root);
+    for (const category of DOC_CATEGORIES) {
+        const file = path.join(dir, category.file);
+        const target = toPosix(path.relative(root, file));
+        if (!exists(file)) {
+            if (category.required)
+                out.push(diag('error', 'DOC_MISSING', `Нет файла категории «${category.title}»`, target, `Создайте ${category.file} с разделами: ${category.sections.join(', ')}.`));
+            else
+                out.push(diag('info', 'DOC_OPTIONAL_MISSING', `Необязательная категория «${category.title}» не заполнена`, target));
+            continue;
+        }
+        const text = readText(file);
+        const doc = parseDoc(text);
+        if (doc.frontmatter.__invalid)
+            out.push(diag('error', 'DOC_FRONTMATTER_INVALID', 'Фронтматтер не разбирается как YAML', target));
+        for (const field of DOC_FRONTMATTER_FIELDS) {
+            if (doc.frontmatter[field] === undefined || doc.frontmatter[field] === '') {
+                out.push(diag('error', 'DOC_FRONTMATTER_FIELD', `В фронтматтере нет поля ${field}`, target));
+            }
+        }
+        const verification = doc.frontmatter.verification;
+        if (typeof verification === 'string' && !VERIFICATION_VALUES.has(verification)) {
+            out.push(diag('error', 'DOC_VERIFICATION_VALUE', `verification должно быть verified или needs-review, а не «${verification}»`, target));
+        }
+        const h2 = doc.headings.filter((h) => h.level === 2).map((h) => norm(h.text));
+        for (const section of category.sections) {
+            if (!h2.includes(norm(section))) {
+                out.push(diag('error', 'DOC_SECTION_MISSING', `Нет раздела «## ${section}»`, target, `Категория «${category.title}» отвечает на: ${category.questions}.`));
+            }
+        }
+        doc.body.split(/\r?\n/).forEach((line, i) => {
+            if (PLACEHOLDER.test(line)) {
+                out.push(diag('error', 'DOC_PLACEHOLDER', `Заглушка в строке ${i + 1}: ${line.trim().slice(0, 80)}`, target));
+            }
+        });
+        if (wordCount(doc.body) < 40) {
+            out.push(diag('warning', 'DOC_TOO_SHORT', 'Содержимое короче 40 слов: категория вряд ли закрыта', target));
+        }
+        for (const ref of pathRefs(doc.body)) {
+            if (!exists(path.join(root, ref))) {
+                out.push(diag('warning', 'DOC_PATH_MISSING', `Упомянутый путь не найден в репозитории: ${ref}`, target));
+            }
+        }
+        if (category.id === 'testing' && scripts) {
+            for (const cmd of scriptRefs(doc.body)) {
+                if (!(cmd in scripts))
+                    out.push(diag('warning', 'DOC_SCRIPT_MISSING', `Скрипт «${cmd}» упомянут, но его нет в package.json`, target));
+            }
+        }
+    }
+    out.push(...doctorDecisions(root, config));
+    return out;
+}
+function wordCount(text) {
+    return text.split(/\s+/).filter(Boolean).length;
+}
+/** Пути в обратных кавычках: содержат «/», без пробелов, не URL, не глоб. */
+function pathRefs(body) {
+    const refs = new Set();
+    for (const m of body.matchAll(/`([^`\s]+)`/g)) {
+        const v = m[1];
+        if (!v.includes('/') || /^[a-z]+:\/\//i.test(v) || /[*?{}[\]]/.test(v) || v.startsWith('/') || v.startsWith('-'))
+            continue;
+        if (/^[A-Za-z0-9_.@-][A-Za-z0-9_./@-]*$/.test(v))
+            refs.add(v.replace(/\/$/, ''));
+    }
+    return [...refs];
+}
+/** Команды вида `pnpm test:unit`, `npm run lint`, `yarn e2e` → имя скрипта. */
+function scriptRefs(body) {
+    const refs = new Set();
+    for (const m of body.matchAll(/`(?:pnpm|npm run|yarn)\s+([a-z][\w:-]*)`/g))
+        refs.add(m[1]);
+    return [...refs];
+}
+function readPackageScripts(root) {
+    const file = path.join(root, 'package.json');
+    if (!exists(file))
+        return null;
+    try {
+        return JSON.parse(readText(file)).scripts ?? {};
+    }
+    catch {
+        return null;
+    }
+}
+export function decisionsDir(root, config) {
+    return path.join(docsDir(root, config), 'decisions');
+}
+export function loadDecisions(root, config) {
+    const dir = decisionsDir(root, config);
+    if (!exists(dir))
+        return [];
+    return fs
+        .readdirSync(dir)
+        .filter((f) => /^ADR-\d+.*\.md$/i.test(f))
+        .sort()
+        .map((f) => {
+        const doc = parseDoc(readText(path.join(dir, f)));
+        const fm = doc.frontmatter;
+        const ruleSection = doc.body.match(/##\s*Правило\s*\n([\s\S]*?)(?=\n##\s|$)/);
+        return {
+            id: String(fm.id ?? f),
+            title: String(fm.title ?? f),
+            status: fm.status ?? 'accepted',
+            scope: Array.isArray(fm.scope) ? fm.scope.map(String) : [],
+            rule: (ruleSection?.[1] ?? '').trim(),
+            file: toPosix(path.relative(root, path.join(dir, f))),
+        };
+    });
+}
+function doctorDecisions(root, config) {
+    const out = [];
+    const seen = new Set();
+    for (const d of loadDecisions(root, config)) {
+        if (!/^ADR-\d{4}$/.test(d.id))
+            out.push(diag('error', 'ADR_ID', `Идентификатор правила должен быть вида ADR-0001, а не «${d.id}»`, d.file));
+        if (seen.has(d.id))
+            out.push(diag('error', 'ADR_DUPLICATE', `Идентификатор ${d.id} повторяется`, d.file));
+        seen.add(d.id);
+        if (!['accepted', 'superseded'].includes(d.status))
+            out.push(diag('error', 'ADR_STATUS', `status должен быть accepted или superseded`, d.file));
+        if (!d.rule)
+            out.push(diag('error', 'ADR_RULE', 'Нет раздела «## Правило» с формулировкой', d.file));
+        if (d.scope.length === 0)
+            out.push(diag('warning', 'ADR_SCOPE', 'Не задана область действия scope', d.file));
+    }
+    return out;
+}
+/** Действующие правила, чья область пересекается с затронутыми путями (или все, если пути неизвестны). */
+export function applicableDecisions(decisions, paths) {
+    const accepted = decisions.filter((d) => d.status === 'accepted');
+    if (!paths || paths.length === 0)
+        return accepted;
+    return accepted.filter((d) => d.scope.length === 0 || d.scope.some((s) => paths.some((p) => p.startsWith(s) || s.startsWith(p))));
+}
+//# sourceMappingURL=project-docs.js.map

package/dist/core/project-docs.js.map

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

package/dist/core/protect.js

@@ -0,0 +1,47 @@
+import { createHash } from 'node:crypto';
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import fg from 'fast-glob';
+const IGNORE = ['**/node_modules/**', '**/.git/**', '**/dist/**', '**/coverage/**'];
+function sha256(file) {
+    return createHash('sha256').update(fs.readFileSync(file)).digest('hex');
+}
+/** Текущие файлы по шаблонам и их хеши. */
+export function snapshotProtected(root, globs) {
+    if (globs.length === 0)
+        return {};
+    const files = fg.sync(globs, { cwd: root, onlyFiles: true, dot: true, ignore: IGNORE }).sort();
+    const out = {};
+    for (const f of files)
+        out[f] = sha256(path.join(root, f));
+    return out;
+}
+/** Расхождения текущей рабочей копии со снимком: изменён, удалён или добавлен файл под защитой. */
+export function protectedViolations(root, globs, snapshot) {
+    if (globs.length === 0)
+        return [];
+    const current = snapshotProtected(root, globs);
+    const out = [];
+    for (const [p, sha] of Object.entries(snapshot)) {
+        if (!(p in current))
+            out.push({ path: p, kind: 'deleted' });
+        else if (current[p] !== sha)
+            out.push({ path: p, kind: 'modified' });
+    }
+    for (const p of Object.keys(current))
+        if (!(p in snapshot))
+            out.push({ path: p, kind: 'added' });
+    return out.sort((a, b) => a.path.localeCompare(b.path));
+}
+/** Изменённые относительно HEAD отслеживаемые файлы (без untracked): запасной путь для изменений без снимка. */
+export function trackedChangedFiles(root) {
+    try {
+        const out = execFileSync('git', ['diff', '--name-only', 'HEAD', '--'], { cwd: root, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+        return out.split('\n').map((l) => l.trim()).filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=protect.js.map

package/dist/core/protect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protect.js","sourceRoot":"","sources":["../../src/core/protect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,WAAW,CAAC;AAS3B,MAAM,MAAM,GAAG,CAAC,oBAAoB,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,CAAC,CAAC;AAEpF,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,KAAe;IAC7D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/F,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3D,OAAO,GAAG,CAAC;AACb,CAAC;AAOD,mGAAmG;AACnG,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,KAAe,EAAE,QAA2B;IAC5F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAyB,EAAE,CAAC;IACrC,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;aACvD,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACjG,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,gHAAgH;AAChH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC7I,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/core/repo-host.js

@@ -0,0 +1,11 @@
+const registry = new Map();
+export function registerRepoHost(name, factory) {
+    registry.set(name, factory);
+}
+export function createRepoHost(root, config, name = config.repo.adapter) {
+    const factory = registry.get(name);
+    if (!factory)
+        throw new Error(`Адаптер репозитория "${name}" не зарегистрирован`);
+    return factory(root, config);
+}
+//# sourceMappingURL=repo-host.js.map

package/dist/core/repo-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-host.js","sourceRoot":"","sources":["../../src/core/repo-host.ts"],"names":[],"mappings":"AAwDA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;AAEpD,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,OAAwB;IACrE,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,MAAc,EAAE,IAAI,GAAW,MAAM,CAAC,IAAI,CAAC,OAAO;IAC7F,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,sBAAsB,CAAC,CAAC;IAClF,OAAO,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/core/report.js

@@ -0,0 +1,286 @@
+import { createHash } from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { diag, hasErrors } from './diagnostics.js';
+import { nextRunId, runDir, saveChange } from './change.js';
+import { isGitRepo, sealChangeSet, writeChangeSet } from './changeset.js';
+import { reconcileDrift } from './drift.js';
+import { completePhase, nextStep, routeBlocker } from './phases.js';
+import { parseRoleResult } from './result.js';
+import { artifactStates, loadWorkflow, pendingArtifacts } from './schema.js';
+import { taskProgress } from './tasks.js';
+import { wiringForChange } from './wiring.js';
+import picomatch from 'picomatch';
+import { protectedViolations, snapshotProtected, trackedChangedFiles } from './protect.js';
+import { exists, readText, toPosix, writeText } from './paths.js';
+export const CHANGESET_EXCLUDE_DEFAULT = ['.sbox/**', 'node_modules/**', 'dist/**', 'build/**', 'coverage/**', 'reports/**'];
+export function changesetExclude(config, changeDirRel) {
+    return [...(config.changeset?.exclude ?? CHANGESET_EXCLUDE_DEFAULT), `${changeDirRel}/**`];
+}
+function sha256(text) {
+    return createHash('sha256').update(text).digest('hex');
+}
+/** Принять ответ роли: сохранить, разобрать, проверить и перевести изменение в следующее состояние. */
+export async function applyReport(input) {
+    const { root, config, dir, change, role, phase, markdown } = input;
+    const diagnostics = [];
+    const runId = nextRunId(change);
+    const rdir = runDir(dir, runId);
+    fs.mkdirSync(rdir, { recursive: true });
+    const resultFile = path.join(rdir, 'result.md');
+    writeText(resultFile, markdown);
+    const receiptBase = {
+        id: runId,
+        role,
+        phase,
+        attempt: input.receipt?.attempt ?? 1,
+        runner: input.receipt?.runner ?? null,
+        model: input.receipt?.model ?? null,
+        session: input.receipt?.session ?? null,
+        started: input.receipt?.started ?? null,
+        finished: new Date().toISOString(),
+        exit_code: input.receipt?.exitCode ?? null,
+        cost_usd: input.receipt?.costUsd ?? null,
+        packet_sha256: input.receipt?.packetSha256 ?? (exists(path.join(rdir, 'packet.json')) ? sha256(readText(path.join(rdir, 'packet.json'))) : null),
+        prompt_sha256: input.receipt?.promptSha256 ?? null,
+        result_sha256: sha256(markdown),
+        result_bytes: Buffer.byteLength(markdown),
+        events_path: input.receipt?.eventsPath ?? null,
+        events_sha256: input.receipt?.eventsSha256 ?? null,
+        stderr_sha256: input.receipt?.stderrSha256 ?? null,
+    };
+    const pushRun = (status, failure) => {
+        change.runs.push({
+            id: runId,
+            role,
+            phase,
+            attempt: receiptBase.attempt,
+            status,
+            dir: `runs/${runId}`,
+            finished: receiptBase.finished,
+            ...(receiptBase.runner ? { runner: receiptBase.runner } : {}),
+            ...(receiptBase.model ? { model: receiptBase.model } : {}),
+            ...(receiptBase.session ? { session: receiptBase.session } : {}),
+            ...(receiptBase.started ? { started: receiptBase.started } : {}),
+            ...(receiptBase.cost_usd !== null ? { cost_usd: receiptBase.cost_usd } : {}),
+            ...(failure ? { failure } : {}),
+        });
+        writeText(path.join(rdir, 'receipt.json'), `${JSON.stringify({ ...receiptBase, status, ...(failure ? { failure } : {}) }, null, 2)}\n`);
+    };
+    let result;
+    try {
+        result = parseRoleResult(markdown);
+    }
+    catch (e) {
+        pushRun('failed', 'no-result');
+        saveChange(dir, change);
+        throw e;
+    }
+    saveEvidence(dir, change, role, phase, markdown);
+    if (role === 'planner' && phase === 'propose') {
+        if (result.size)
+            change.size = result.size;
+        if (result.skip_specs !== undefined) {
+            change.skip_specs = result.skip_specs;
+            const openspecMeta = path.join(dir, '.openspec.yaml');
+            if (exists(openspecMeta))
+                writeText(openspecMeta, readText(openspecMeta).replace(/^skip_specs:.*$/m, `skip_specs: ${result.skip_specs}`));
+        }
+    }
+    if (result.complexity) {
+        const prev = change.complexity;
+        change.complexity = {
+            implementation: prev?.implementation === 'высокая' ? 'высокая' : result.complexity.implementation,
+            review: prev?.review === 'высокая' ? 'высокая' : result.complexity.review,
+        };
+    }
+    if (role === 'tester' && result.protected && result.protected.length > 0) {
+        change.protected = [...new Set([...change.protected, ...result.protected, ...config.testing.protectedGlobs])];
+    }
+    if (role === 'verifier' && (result.checks || result.gaps)) {
+        change.verification = { run: runId, checks: result.checks ?? [], gaps: result.gaps ?? [] };
+        // Кандидаты подключения по образцу, которые верификатор не закрыл сам: становятся пунктами PARTIAL для disposition ревьюера.
+        const w = wiringForChange(root, dir);
+        if (w && w.gaps.length > 0) {
+            const covered = new Set(change.verification.checks.flatMap((c) => w.gaps.filter((g) => `${c.purpose ?? ''} ${c.evidence ?? ''}`.includes(g.file)).map((g) => g.file)));
+            for (const [i, gap] of w.gaps.filter((g) => !covered.has(g.file)).entries()) {
+                change.verification.checks.push({ id: `W${i + 1}`, purpose: `подключение нового модуля «${w.fresh}» в ${gap.file}, где зарегистрирован образец «${w.analog}»`, result: 'PARTIAL', evidence: `sbox wiring: образец упомянут ${gap.analogMentions} раз, новый модуль не упомянут; верификатор этот файл не рассматривал` });
+            }
+        }
+    }
+    if (role === 'reviewer' && phase === 'review' && result.dispositions) {
+        change.accepted_gaps = result.dispositions.filter((d) => d.disposition === 'manual_gap_accepted').map((d) => ({ item: d.item, ...(d.reason ? { reason: d.reason } : {}) }));
+    }
+    let phaseCompleted = false;
+    let runStatus = 'done';
+    const p0 = (result.questions ?? []).filter((q) => q.priority === 'P0');
+    const changeDirRel = toPosix(path.relative(root, dir));
+    if (result.status === 'заблокировано') {
+        runStatus = 'blocked';
+        routeBlocker(change, config, { category: result.blocker.category, artifact: result.blocker.artifact, message: result.blocker.message ?? 'без описания', role, phase });
+    }
+    else if (p0.length > 0) {
+        runStatus = 'blocked';
+        routeBlocker(change, config, { category: 'пользователь', message: `Вопросы P0: ${p0.map((q) => `${q.id}: ${q.text}`).join(' | ')}`, role, phase });
+    }
+    else {
+        const check = await checkPhaseDone({ ...input, result, changeDirRel });
+        diagnostics.push(...check);
+        if (hasErrors(check)) {
+            runStatus = 'failed';
+        }
+        else if (role === 'verifier' && (result.checks ?? []).some((c) => c.result === 'FAIL')) {
+            runStatus = 'blocked';
+            routeBlocker(change, config, {
+                category: 'реализация',
+                message: `Проверки FAIL: ${(result.checks ?? []).filter((c) => c.result === 'FAIL').map((c) => `${c.id}${c.evidence ? ` (${c.evidence})` : ''}`).join(' | ')}`,
+                role,
+                phase,
+            });
+        }
+        else if (role === 'reviewer' && (result.findings ?? []).some((f) => f.level === 'blocking')) {
+            runStatus = 'blocked';
+            routeBlocker(change, config, {
+                category: phase === 'tests_review' ? 'тесты' : 'реализация',
+                message: (result.findings ?? []).filter((f) => f.level === 'blocking').map((f) => `${f.file ? `${f.file}: ` : ''}${f.text}`).join(' | '),
+                role,
+                phase,
+            });
+        }
+        else if (role === 'reviewer' && phase === 'review' && (result.dispositions ?? []).some((d) => d.disposition === 'change_required')) {
+            runStatus = 'blocked';
+            routeBlocker(change, config, {
+                category: 'реализация',
+                message: (result.dispositions ?? []).filter((d) => d.disposition === 'change_required').map((d) => `${d.item}: ${d.reason ?? ''}`).join(' | '),
+                role,
+                phase,
+            });
+        }
+        else if (role === 'reviewer' && phase === 'review' && (result.dispositions ?? []).some((d) => d.disposition === 'blocked')) {
+            runStatus = 'blocked';
+            routeBlocker(change, config, {
+                category: 'внешний',
+                message: (result.dispositions ?? []).filter((d) => d.disposition === 'blocked').map((d) => `${d.item}: ${d.reason ?? ''}`).join(' | '),
+                role,
+                phase,
+            });
+        }
+        else {
+            if (phase === 'cover' && change.protected.length > 0) {
+                change.protected_snapshot = snapshotProtected(root, change.protected);
+                diagnostics.push(diag('info', 'PROTECTED_SNAPSHOT', `Снимок защищённых файлов: ${Object.keys(change.protected_snapshot).length}`, 'protected'));
+            }
+            if (phase === 'implement')
+                sealAfterImplement(root, config, dir, change, runId, changeDirRel, diagnostics);
+            if ((phase === 'verify' || phase === 'review') && change.changeset)
+                change.reviewed_digest = change.changeset.digest;
+            completePhase(change, config, phase);
+            phaseCompleted = true;
+        }
+    }
+    pushRun(runStatus, runStatus === 'failed' ? 'checks' : undefined);
+    saveChange(dir, change);
+    return { runId, result, phaseCompleted, diagnostics, next: nextStep(change, config) };
+}
+function sealAfterImplement(root, config, dir, change, runId, changeDirRel, diagnostics) {
+    if (!isGitRepo(root) || !change.base_revision) {
+        diagnostics.push(diag('warning', 'CHANGESET_SKIPPED', 'Change-set не запечатан: нет git-репозитория или базовой ревизии', 'changeset'));
+        return;
+    }
+    const sealed = sealChangeSet(root, change.base_revision, changesetExclude(config, changeDirRel), runId);
+    writeChangeSet(dir, sealed);
+    change.changeset = { base: sealed.base, digest: sealed.digest, paths: sealed.paths, sealed_after: runId, sealed_at: sealed.sealed_at, rebound: [] };
+    change.reviewed_digest = null;
+    diagnostics.push(diag('info', 'CHANGESET_SEALED', `Change-set запечатан: ${sealed.paths} файлов, ${sealed.digest.slice(0, 19)}…`, 'changeset'));
+}
+function saveEvidence(dir, change, role, phase, markdown) {
+    const n = change.runs.filter((r) => r.role === role && r.phase === phase).length + 1;
+    const names = {
+        'researcher:research': 'research.md',
+        'reviewer:tests_review': `tests-review-${n}.md`,
+        'reviewer:review': `review-${n}.md`,
+        'verifier:verify': `verify-${n}.md`,
+        'challenger:plan': 'challenge.md',
+    };
+    const name = names[`${role}:${phase}`];
+    if (!name)
+        return;
+    const file = path.join(dir, 'evidence', name);
+    if (role === 'researcher' && exists(file))
+        return;
+    writeText(file, markdown);
+}
+/** Детерминированные проверки завершённости фазы: артефакты, дельты, задачи, защищённые файлы, дайджест, disposition. */
+async function checkPhaseDone(input) {
+    const { root, config, dir, change, phase, role, result, adapter, changeDirRel } = input;
+    const out = [];
+    const workflow = loadWorkflow(root);
+    const states = artifactStates(workflow, change, dir);
+    if (phase === 'propose' || phase === 'plan' || phase === 'cover') {
+        for (const s of pendingArtifacts(states, phase)) {
+            if (s.optional)
+                continue;
+            if (phase === 'cover' && s.id === 'test-plan')
+                continue;
+            out.push(diag('error', 'ARTIFACT_MISSING', `Артефакт ${s.id} не создан: ожидался ${path.relative(root, s.outputPath)}`, s.id));
+        }
+    }
+    if (phase === 'plan' && !change.skip_specs) {
+        try {
+            const truth = await adapter.readTruth();
+            const deltas = await adapter.readDelta(path.join(dir, 'specs'));
+            if (deltas.length === 0)
+                out.push(diag('error', 'DELTA_MISSING', 'В specs/ нет ни одной дельты, а skip_specs не задан', 'specs'));
+            out.push(...adapter.validate(truth, deltas));
+        }
+        catch (e) {
+            out.push(diag('error', 'DELTA_READ', e.message, 'specs'));
+        }
+    }
+    if (phase === 'implement') {
+        const tasksFile = path.join(dir, 'tasks.md');
+        if (exists(tasksFile)) {
+            const progress = taskProgress(readText(tasksFile));
+            if (progress.remaining > 0) {
+                out.push(diag('error', 'TASKS_REMAINING', `Не отмечено задач: ${progress.remaining} из ${progress.total}`, 'tasks.md', 'Выполните задачи и отметьте их `- [x]`, либо верните статус «заблокировано».'));
+            }
+        }
+        if (change.protected.length > 0) {
+            const hasSnapshot = Object.keys(change.protected_snapshot).length > 0;
+            const violations = hasSnapshot
+                ? protectedViolations(root, change.protected, change.protected_snapshot).map((v) => `${v.path} (${v.kind === 'modified' ? 'изменён' : v.kind === 'deleted' ? 'удалён' : 'добавлен'})`)
+                : trackedChangedFiles(root).filter((f) => picomatch(change.protected, { dot: true })(f)).map((f) => `${f} (изменён)`);
+            if (violations.length > 0) {
+                out.push(diag('error', 'PROTECTED_CHANGED', `Изменены защищённые файлы: ${violations.join(', ')}`, 'protected', 'Откатите правки тестов; спорный тест возвращайте блокером категории «тесты».'));
+            }
+        }
+    }
+    if (phase === 'verify' && config.wiring.strict) {
+        const w = wiringForChange(root, dir);
+        if (w && w.gaps.length > 0) {
+            out.push(diag('error', 'WIRING_MISSING', `Образец «${w.analog}» подключён в файлах, где нового модуля «${w.fresh}» нет: ${w.gaps.map((g) => g.file).join(', ')}`, 'wiring', 'Добавьте регистрацию или перечислите файлы в design.md строкой «Исключения подключения» с причиной; либо выключите wiring.strict.'));
+        }
+    }
+    if ((phase === 'verify' || phase === 'review') && change.changeset && isGitRepo(root)) {
+        // Безобидный дрейф (документация, .gitignore, материалы хостов) перепривязывается, код после запечатывания меняться не может.
+        out.push(...reconcileDrift(root, config, dir, change, { rebind: true }).diagnostics);
+    }
+    if (role === 'reviewer' && phase === 'review') {
+        const pending = new Set();
+        for (const c of change.verification?.checks ?? [])
+            if (c.result !== 'PASS')
+                pending.add(c.id);
+        for (const g of change.verification?.gaps ?? [])
+            pending.add(g.id);
+        for (const d of result.dispositions ?? [])
+            pending.delete(d.item);
+        if (pending.size > 0) {
+            out.push(diag('error', 'REVIEW_DISPOSITION_MISSING', `Нет disposition для пунктов верификатора: ${[...pending].join(', ')}`, 'dispositions', 'Каждый не-PASS пункт и пробел получает satisfied, manual_gap_accepted, change_required или blocked.'));
+        }
+        if (result.status === 'готово' && !result.delivery_narrative) {
+            out.push(diag('error', 'DELIVERY_NARRATIVE_MISSING', 'Вердикт «готово» требует delivery_narrative с полями title, delta, why', 'delivery_narrative'));
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=report.js.map