@spec-box/sdd 0.6.4

package/dist/cli/commands/run.js

@@ -0,0 +1,157 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { loadChange, saveChange, TERMINAL_STATUSES } from '../../core/change.js';
+import { readLock } from '../../core/lock.js';
+import { nextStep } from '../../core/phases.js';
+import { clearStop, requestStop, runChange } from '../../core/run.js';
+import { createRunner } from '../../core/runner.js';
+import { createRepoHost } from '../../core/repo-host.js';
+import { pollPullRequestGate } from '../../core/gates.js';
+import { changeContext } from '../context.js';
+import { emit, emitError } from '../output.js';
+const UNSUCCESSFUL = new Set(['parked', 'blocked', 'failed', 'stopped', 'delivery_unknown']);
+export function registerRun(program) {
+    program
+        .command('run')
+        .description('Headless: выполнять фазы через адаптер среды до гейта, блокера, точки ожидания, лимита или конца')
+        .option('--change <id>')
+        .option('--runner <name>', 'claude | codex (по умолчанию из конфига)')
+        .option('--max-runs <n>', 'предел запусков ролей за вызов', (v) => Number.parseInt(v, 10))
+        .option('--max-cost <usd>', 'предел стоимости за вызов', (v) => Number.parseFloat(v))
+        .option('--detach', 'запустить в фоне и вернуть управление')
+        .action(async (opts, cmd) => {
+        const g = cmd.optsWithGlobals();
+        try {
+            const ctx = changeContext(g.cwd, opts.change);
+            if (opts.detach) {
+                const logDir = path.join(ctx.dir, 'runs');
+                fs.mkdirSync(logDir, { recursive: true });
+                const logFile = path.join(logDir, 'run.log');
+                const out = fs.openSync(logFile, 'a');
+                const args = [process.argv[1], '--cwd', ctx.root, 'run', '--change', ctx.change.id, ...(opts.runner ? ['--runner', opts.runner] : []), ...(opts.maxRuns ? ['--max-runs', String(opts.maxRuns)] : [])];
+                const child = spawn(process.execPath, args, { detached: true, stdio: ['ignore', out, out], cwd: ctx.root });
+                child.unref();
+                emit(g, { detached: true, pid: child.pid, log: path.relative(ctx.root, logFile) }, (d) => `Запущено в фоне (pid ${d.pid}). Журнал: ${d.log}. Следить: sbox watch --change ${ctx.change.id}`);
+                return;
+            }
+            const runnerName = opts.runner ?? ctx.config.runner.default;
+            const runner = createRunner(runnerName, ctx.root, ctx.config);
+            const prGate = ctx.config.gates.channels.includes('pr-comments') && ctx.config.repo.adapter !== 'local'
+                ? async () => {
+                    const host = createRepoHost(ctx.root, ctx.config);
+                    const branch = ctx.change.branch ?? `${ctx.config.repo.branchPrefix}${ctx.change.id}`;
+                    const pr = await host.findPullRequest(branch);
+                    if (!pr)
+                        return false;
+                    const outcome = await pollPullRequestGate(ctx.root, ctx.config, ctx.dir, host, pr);
+                    return outcome.applied !== null;
+                }
+                : undefined;
+            const summary = await runChange({
+                root: ctx.root,
+                config: ctx.config,
+                dir: ctx.dir,
+                adapter: ctx.adapter,
+                runner,
+                maxRuns: opts.maxRuns,
+                maxCostUsd: opts.maxCost,
+                log: (line) => process.stderr.write(`${line}\n`),
+                onGate: prGate,
+            });
+            emit(g, { reason: summary.reason, runs: summary.runs, cost_usd: summary.costUsd, status: summary.change.status, phase: summary.change.phase, next: summary.next }, (d) => `Остановка: ${d.reason}. Запусков: ${d.runs}, стоимость: $${d.cost_usd.toFixed(2)}. Изменение: фаза ${d.phase}, статус ${d.status}. Дальше: ${JSON.stringify(d.next)}`);
+            if (UNSUCCESSFUL.has(summary.change.status) || summary.reason === 'failed')
+                process.exitCode = 1;
+        }
+        catch (e) {
+            emitError(g, e);
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command('stop')
+        .description('Остановить запуск роли и запретить доставку; изменение получает статус stopped')
+        .option('--change <id>')
+        .option('--wait <seconds>', 'ждать завершения процесса', (v) => Number.parseInt(v, 10), 30)
+        .action(async (opts, cmd) => {
+        const g = cmd.optsWithGlobals();
+        try {
+            const ctx = changeContext(g.cwd, opts.change);
+            requestStop(ctx.dir);
+            const lock = readLock(ctx.dir);
+            if (!lock) {
+                // Активного процесса нет: переводим сразу.
+                const change = loadChange(ctx.dir);
+                change.status = 'stopped';
+                change.stop_requested = true;
+                change.settled = true;
+                change.active_run = null;
+                saveChange(ctx.dir, change, { allowTerminalReopen: true });
+                clearStop(ctx.dir);
+                emit(g, { stopped: true, immediate: true }, () => 'Активного запуска не было; изменение переведено в stopped.');
+                return;
+            }
+            const deadline = Date.now() + opts.wait * 1000;
+            while (Date.now() < deadline) {
+                const change = loadChange(ctx.dir);
+                if (change.status === 'stopped' && change.settled) {
+                    emit(g, { stopped: true, pid: lock.pid }, (d) => `Запуск ${d.pid} остановлен, изменение в stopped.`);
+                    return;
+                }
+                await new Promise((r) => setTimeout(r, 1000));
+            }
+            emit(g, { stopped: false, pid: lock.pid }, (d) => `Запрос остановки записан, процесс ${d.pid} ещё не завершился. Проверьте: sbox watch`);
+            process.exitCode = 1;
+        }
+        catch (e) {
+            emitError(g, e);
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command('watch')
+        .description('Ждать терминального статуса или остановки на гейте; выход 1 для parked, blocked, failed, stopped, delivery_unknown')
+        .option('--change <id>')
+        .option('--interval <seconds>', 'период опроса', (v) => Number.parseInt(v, 10), 5)
+        .option('--timeout <minutes>', 'предел ожидания', (v) => Number.parseInt(v, 10), 240)
+        .action(async (opts, cmd) => {
+        const g = cmd.optsWithGlobals();
+        try {
+            const ctx = changeContext(g.cwd, opts.change);
+            const deadline = Date.now() + opts.timeout * 60_000;
+            let lastLine = '';
+            for (;;) {
+                const change = loadChange(ctx.dir);
+                const step = nextStep(change, ctx.config);
+                const line = `${change.id}: фаза ${change.phase}, статус ${change.status}, запусков ${change.runs.length}${change.active_run ? `, активен ${change.active_run}` : ''}`;
+                if (line !== lastLine && !g.json)
+                    process.stderr.write(`${line}\n`);
+                lastLine = line;
+                const noProcess = change.settled && !readLock(ctx.dir);
+                if (noProcess && step.kind === 'role' && !TERMINAL_STATUSES.has(change.status)) {
+                    emit(g, { idle: true, id: change.id, phase: change.phase, status: change.status, next: step }, (d) => `Ничего не запущено: изменение ждёт роль ${JSON.stringify(d.next)}. Запустите sbox run.`);
+                    process.exitCode = 2;
+                    return;
+                }
+                const settledStop = noProcess && (step.kind !== 'role' || TERMINAL_STATUSES.has(change.status));
+                if (settledStop) {
+                    emit(g, { id: change.id, revision: change.revision, phase: change.phase, status: change.status, settled: change.settled, next: step }, (d) => `Завершено: статус ${d.status}, дальше ${JSON.stringify(d.next)}`);
+                    if (UNSUCCESSFUL.has(change.status))
+                        process.exitCode = 1;
+                    return;
+                }
+                if (Date.now() > deadline) {
+                    emit(g, { timeout: true, status: change.status }, () => 'Время ожидания истекло.');
+                    process.exitCode = 1;
+                    return;
+                }
+                await new Promise((r) => setTimeout(r, opts.interval * 1000));
+            }
+        }
+        catch (e) {
+            emitError(g, e);
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=run.js.map

package/dist/cli/commands/run.js.map

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

package/dist/cli/commands/spec.js

@@ -0,0 +1,84 @@
+import path from 'node:path';
+import { archiveChange } from '../../core/archive.js';
+import { SboxError } from '../../core/errors.js';
+import { changeContext, projectContext } from '../context.js';
+import { emit, emitError, formatDiagnostics } from '../output.js';
+export function registerSpec(program) {
+    const spec = program.command('spec').description('Истина спецификаций через адаптер');
+    spec
+        .command('list')
+        .description('Список capability')
+        .action(async (_opts, cmd) => {
+        const g = cmd.optsWithGlobals();
+        try {
+            const ctx = projectContext(g.cwd);
+            const truth = await ctx.adapter.readTruth();
+            const items = truth.map((c) => ({ id: c.id, title: c.title, requirements: c.requirements.length, scenarios: c.requirements.reduce((n, r) => n + r.scenarios.length, 0), source: c.source }));
+            emit(g, { adapter: ctx.adapter.name, capabilities: items }, (d) => d.capabilities.map((c) => `${c.id}\t${c.title}\t${c.requirements} групп, ${c.scenarios} утверждений\t${c.source ?? ''}`).join('\n') || 'Спецификаций нет.');
+        }
+        catch (e) {
+            emitError(g, e);
+            process.exitCode = 1;
+        }
+    });
+    spec
+        .command('show <id>')
+        .description('Capability целиком')
+        .action(async (id, _opts, cmd) => {
+        const g = cmd.optsWithGlobals();
+        try {
+            const ctx = projectContext(g.cwd);
+            const cap = (await ctx.adapter.readTruth()).find((c) => c.id === id);
+            if (!cap)
+                throw new SboxError('NO_CAPABILITY', `Capability ${id} не найдена`, 'Список: `sbox spec list`.');
+            emit(g, { capability: cap }, (d) => [`# ${d.capability.title} (${d.capability.id})`, d.capability.purpose ?? '', ...d.capability.requirements.flatMap((r) => [`## ${r.title}`, ...r.scenarios.map((s) => `- ${s.title}${s.description ? `\n  ${s.description.replace(/\n/g, '\n  ')}` : ''}`)])].join('\n'));
+        }
+        catch (e) {
+            emitError(g, e);
+            process.exitCode = 1;
+        }
+    });
+    spec
+        .command('diff')
+        .description('Дельты изменения относительно истины')
+        .option('--change <id>')
+        .action(async (opts, cmd) => {
+        const g = cmd.optsWithGlobals();
+        try {
+            const ctx = changeContext(g.cwd, opts.change);
+            const truth = await ctx.adapter.readTruth();
+            const deltas = await ctx.adapter.readDelta(path.join(ctx.dir, 'specs'));
+            const diagnostics = ctx.adapter.validate(truth, deltas);
+            emit(g, { deltas, diagnostics }, (d) => [
+                ...d.deltas.map((delta) => [`# ${delta.capabilityId}${delta.isNew ? ' (новая)' : ''} — ${delta.source}`, ...delta.ops.map((op) => op.op === 'add-requirement' ? `+ ${op.requirement.title} (${op.requirement.scenarios.length})` : op.op === 'modify-requirement' ? `~ ${op.requirement.title} (${op.requirement.scenarios.length})` : op.op === 'remove-requirement' ? `- ${op.requirementTitle}${op.scenarios ? ` [${op.scenarios.length} утв.]` : ''}` : `→ ${op.from} ⇒ ${op.to}`)].join('\n')),
+                '',
+                formatDiagnostics(d.diagnostics),
+            ].join('\n'));
+        }
+        catch (e) {
+            emitError(g, e);
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command('archive')
+        .description('Применить дельты к истине и перенести изменение в архив')
+        .option('--change <id>')
+        .option('--force', 'применить несмотря на ошибки валидации')
+        .action(async (opts, cmd) => {
+        const g = cmd.optsWithGlobals();
+        try {
+            const ctx = changeContext(g.cwd, opts.change);
+            if (ctx.change.phase !== 'deliver' && !opts.force) {
+                throw new SboxError('NOT_DELIVERABLE', `Изменение в фазе ${ctx.change.phase}, а не deliver.`, 'Доведите изменение до фазы deliver или используйте --force.');
+            }
+            const result = await archiveChange(ctx.root, ctx.config, ctx.adapter, ctx.dir, ctx.change, { force: opts.force });
+            emit(g, { archivedTo: path.relative(ctx.root, result.archivedTo), appliedFiles: result.appliedFiles, diagnostics: result.diagnostics }, (d) => [`Архив: ${d.archivedTo}`, ...d.appliedFiles.map((f) => `  ~ ${f}`), formatDiagnostics(d.diagnostics)].join('\n'));
+        }
+        catch (e) {
+            emitError(g, e);
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=spec.js.map

package/dist/cli/commands/spec.js.map

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

package/dist/cli/commands/wiring.js

@@ -0,0 +1,50 @@
+import path from 'node:path';
+import { SboxError } from '../../core/errors.js';
+import { exists, readText } from '../../core/paths.js';
+import { parseAnalogFromDesign, wiringGaps } from '../../core/wiring.js';
+import { changeContext, projectContext } from '../context.js';
+import { emit, emitError } from '../output.js';
+export function registerWiring(program) {
+    program
+        .command('wiring')
+        .description('Проверить, что новый модуль подключён везде, где подключён модуль-образец (по design.md или флагам)')
+        .option('--change <id>')
+        .option('--analog <id>', 'идентификатор образца, как он встречается в коде и конфигах')
+        .option('--new <id>', 'идентификатор нового модуля')
+        .option('--except <files...>', 'файлы, где регистрация не нужна')
+        .action((opts, cmd) => {
+        const g = cmd.optsWithGlobals();
+        try {
+            let analog = opts.analog;
+            let fresh = opts.new;
+            let exceptions = opts.except ?? [];
+            let root;
+            if (analog && fresh)
+                root = projectContext(g.cwd).root;
+            else {
+                const ctx = changeContext(g.cwd, opts.change);
+                root = ctx.root;
+                const designFile = path.join(ctx.dir, 'design.md');
+                const parsed = exists(designFile) ? parseAnalogFromDesign(readText(designFile)) : null;
+                if (!parsed)
+                    throw new SboxError('NO_ANALOG', 'В design.md нет строк «Образец: `X`» и «Новый модуль: `Y`».', 'Укажите --analog и --new или добавьте строки в раздел «Единообразие».');
+                analog = parsed.analog;
+                fresh = parsed.fresh;
+                exceptions = exceptions.length ? exceptions : parsed.exceptions;
+            }
+            const result = wiringGaps(root, analog, fresh, exceptions);
+            emit(g, result, (d) => [
+                `Образец ${d.analog} зарегистрирован в ${d.registrationFiles.length} файлах вне своего каталога:`,
+                ...d.registrationFiles.map((f) => `  ${d.gaps.some((x) => x.file === f) ? '✗' : '✓'} ${f}`),
+                d.gaps.length ? `Нет регистрации нового модуля ${d.fresh}: ${d.gaps.map((x) => x.file).join(', ')}` : `Новый модуль ${d.fresh} подключён везде.`,
+            ].join('\n'));
+            if (result.gaps.length > 0)
+                process.exitCode = 1;
+        }
+        catch (e) {
+            emitError(g, e);
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=wiring.js.map

package/dist/cli/commands/wiring.js.map

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

package/dist/cli/context.js

@@ -0,0 +1,18 @@
+import { loadConfig } from '../core/config.js';
+import { requireProjectRoot } from '../core/paths.js';
+import { createSpecAdapter } from '../core/spec-adapter.js';
+import { resolveChange } from '../core/change.js';
+import '../adapters/spec/index.js';
+import '../adapters/runner/index.js';
+import '../adapters/repo/index.js';
+export function projectContext(cwd) {
+    const root = requireProjectRoot(cwd);
+    const config = loadConfig(root);
+    return { root, config, adapter: createSpecAdapter(root, config) };
+}
+export function changeContext(cwd, id) {
+    const ctx = projectContext(cwd);
+    const { dir, change } = resolveChange(ctx.root, ctx.config, id);
+    return { ...ctx, dir, change };
+}
+//# sourceMappingURL=context.js.map

package/dist/cli/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/cli/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAe,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAoB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAe,MAAM,mBAAmB,CAAC;AAC/D,OAAO,2BAA2B,CAAC;AACnC,OAAO,6BAA6B,CAAC;AACrC,OAAO,2BAA2B,CAAC;AAQnC,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAuB,EAAE,EAAW;IAChE,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAChE,OAAO,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;AACjC,CAAC"}

package/dist/cli/main.js

@@ -0,0 +1,63 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { Command } from 'commander';
+import { packageRoot } from '../core/paths.js';
+import { registerArtifacts } from './commands/artifacts.js';
+import { registerChange } from './commands/change.js';
+import { registerDoctor } from './commands/doctor.js';
+import { registerHost } from './commands/host.js';
+import { registerInit } from './commands/init.js';
+import { registerProtocol } from './commands/protocol.js';
+import { registerSpec } from './commands/spec.js';
+import { registerRun } from './commands/run.js';
+import { registerChangeset } from './commands/changeset.js';
+import { registerDeliver } from './commands/deliver.js';
+import { registerCoverage } from './commands/coverage.js';
+import { registerCi } from './commands/ci.js';
+import { registerPrompt } from './commands/prompt.js';
+import { registerMetrics } from './commands/metrics.js';
+import { registerWiring } from './commands/wiring.js';
+function readVersion() {
+    try {
+        return JSON.parse(fs.readFileSync(path.join(packageRoot(), 'package.json'), 'utf8')).version;
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+export function buildProgram() {
+    const program = new Command();
+    program
+        .name('sbox')
+        .description('@spec-box/sdd: автономная реализация продуктовых фич ИИ-агентами')
+        .version(readVersion())
+        .option('--json', 'один JSON-документ в stdout', false)
+        .option('--cwd <dir>', 'корень проекта или каталог внутри него');
+    registerInit(program);
+    registerDoctor(program);
+    registerHost(program);
+    registerChange(program);
+    registerProtocol(program);
+    registerArtifacts(program);
+    registerSpec(program);
+    registerRun(program);
+    registerChangeset(program);
+    registerDeliver(program);
+    registerCoverage(program);
+    registerCi(program);
+    registerPrompt(program);
+    registerMetrics(program);
+    registerWiring(program);
+    return program;
+}
+export async function main(argv) {
+    await buildProgram().parseAsync(argv);
+}
+const invokedDirectly = process.argv[1] && /main\.(ts|js)$/.test(process.argv[1]);
+if (invokedDirectly) {
+    main(process.argv).catch((err) => {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

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

package/dist/cli/output.js

@@ -0,0 +1,31 @@
+import { SboxError } from '../core/errors.js';
+/** Один JSON-документ в stdout в режиме --json; человекочитаемый текст в stdout иначе. */
+export function emit(opts, data, human) {
+    if (opts.json) {
+        process.stdout.write(`${JSON.stringify({ ok: true, ...data }, null, 2)}\n`);
+    }
+    else {
+        process.stdout.write(`${human(data).trimEnd()}\n`);
+    }
+}
+export function emitError(opts, err) {
+    const status = err instanceof SboxError
+        ? [{ severity: 'error', code: err.code, message: err.message, ...(err.fix ? { fix: err.fix } : {}) }]
+        : [{ severity: 'error', code: 'UNEXPECTED', message: err instanceof Error ? err.message : String(err) }];
+    if (opts.json) {
+        process.stdout.write(`${JSON.stringify({ ok: false, status }, null, 2)}\n`);
+    }
+    else {
+        for (const s of status)
+            process.stderr.write(`ошибка ${s.code}: ${s.message}${s.fix ? `\n  → ${s.fix}` : ''}\n`);
+    }
+}
+export function formatDiagnostics(diagnostics) {
+    if (diagnostics.length === 0)
+        return 'Диагностика: без замечаний';
+    const icon = { error: 'E', warning: 'W', info: 'i' };
+    return diagnostics
+        .map((d) => `[${icon[d.severity]}] ${d.code}${d.target ? ` (${d.target})` : ''}: ${d.message}${d.fix ? `\n    → ${d.fix}` : ''}`)
+        .join('\n');
+}
+//# sourceMappingURL=output.js.map

package/dist/cli/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAO9C,0FAA0F;AAC1F,MAAM,UAAU,IAAI,CAAmB,IAAmB,EAAE,IAAO,EAAE,KAAuB;IAC1F,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9E,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAmB,EAAE,GAAY;IACzD,MAAM,MAAM,GACV,GAAG,YAAY,SAAS;QACtB,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACrG,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7G,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9E,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,CAAC,IAAI,MAAM;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACnH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,WAAyB;IACzD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,4BAA4B,CAAC;IAClE,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAW,CAAC;IAC9D,OAAO,WAAW;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;SAChI,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/core/archive.js

@@ -0,0 +1,77 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { hasErrors } from './diagnostics.js';
+import { SboxError } from './errors.js';
+import { today } from './paths.js';
+import { archiveDir, saveChange } from './change.js';
+/** Каталог считается пустым, если в нём нет ни одного файла (git не хранит пустые каталоги, `checkout` их оставляет). */
+export function isEmptyTree(dir) {
+    if (!fs.existsSync(dir))
+        return true;
+    const walk = (d) => fs.readdirSync(d, { withFileTypes: true }).every((e) => e.isDirectory() && walk(path.join(d, e.name)));
+    return walk(dir);
+}
+/**
+ * Архивация (docs/design.md, «Архивация до мержа»): проверки до любых записей, снимок затронутых файлов истины,
+ * применение дельт, структурная проверка результата, перенос папки; любая ошибка откатывает истину к снимку.
+ * Повторный запуск после сбоя даёт тот же результат, что и однократный успешный: применение дельт идемпотентно.
+ */
+export async function archiveChange(root, config, adapter, dir, change, opts = {}) {
+    const date = opts.date ?? today();
+    const target = path.join(archiveDir(root, config), `${date}-${change.id}`);
+    let cleanedStaleArchive = false;
+    if (fs.existsSync(target)) {
+        if (isEmptyTree(target)) {
+            fs.rmSync(target, { recursive: true, force: true });
+            cleanedStaleArchive = true;
+        }
+        else {
+            throw new SboxError('ARCHIVE_EXISTS', `Каталог архива уже существует и не пуст: ${target}`, 'Если это след прерванной доставки этого же изменения, сравните содержимое с папкой изменения и удалите каталог; если там другое изменение с тем же идентификатором, переименуйте его.');
+        }
+    }
+    const truth = await adapter.readTruth();
+    const deltas = change.skip_specs ? [] : await adapter.readDelta(path.join(dir, 'specs'));
+    const diagnostics = adapter.validate(truth, deltas);
+    if (hasErrors(diagnostics) && !opts.force) {
+        throw new SboxError('DELTA_INVALID', `Дельты не проходят валидацию: ${diagnostics.filter((d) => d.severity === 'error').map((d) => d.message).join('; ')}`, 'Исправьте дельты или используйте --force.');
+    }
+    // Снимок затронутых файлов истины: содержимое или отсутствие.
+    const targets = deltas.length > 0 ? adapter.targets(truth, deltas) : [];
+    const snapshot = new Map();
+    for (const rel of targets) {
+        const abs = path.join(root, rel);
+        snapshot.set(abs, fs.existsSync(abs) ? fs.readFileSync(abs) : null);
+    }
+    const rollback = () => {
+        for (const [abs, content] of snapshot) {
+            if (content === null)
+                fs.rmSync(abs, { force: true });
+            else {
+                fs.mkdirSync(path.dirname(abs), { recursive: true });
+                fs.writeFileSync(abs, content);
+            }
+        }
+    };
+    let appliedFiles = [];
+    try {
+        appliedFiles = deltas.length > 0 ? await adapter.apply(truth, deltas) : [];
+        // Постусловие: истина после применения структурно валидна (нет дубликатов).
+        const after = await adapter.readTruth();
+        const post = adapter.checkTruth(after);
+        diagnostics.push(...post);
+        if (hasErrors(post)) {
+            throw new SboxError('TRUTH_INVALID', `Истина спецификаций после применения дельт невалидна: ${post.filter((d) => d.severity === 'error').map((d) => `${d.target ?? ''}: ${d.message}`).join('; ')}`);
+        }
+        change.phase = 'archived';
+        change.status = 'archived';
+        saveChange(dir, change);
+        fs.mkdirSync(path.dirname(target), { recursive: true });
+        fs.renameSync(dir, target);
+    }
+    catch (e) {
+        rollback();
+        throw e instanceof SboxError ? e : new SboxError('ARCHIVE_FAILED', `Архивация прервана, истина спецификаций восстановлена: ${e.message}`);
+    }
+    return { archivedTo: target, appliedFiles, diagnostics, cleanedStaleArchive };
+}
+//# sourceMappingURL=archive.js.map

package/dist/core/archive.js.map

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