specdo 1.0.2

package/dist/commands/status.js

@@ -0,0 +1,146 @@
+/**
+ * specdo status [--change <name>] [--json]
+ *
+ * 行为：
+ *   - 无 --change：汇总所有 active changes（每个一行）
+ *   - 有 --change：详细展示该 change 的 5 阶段状态 + tasks 进度 + sync 摘要
+ *
+ * 不写文件，仅读取。
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { ContextStore } from '../core/context-store.js';
+import { parseTasks } from '../core/task-parser.js';
+import { fail, findSpecdoConfig, getArchiveDir, getChangeDir, getSpecdoDir, isValidChangeName, ok, safeExists, safeIsDir, } from './_shared.js';
+export async function handleStatus(options) {
+    const { cwd } = options;
+    if (!findSpecdoConfig(cwd)) {
+        return fail(1, ["Not initialized. Run 'specdo init' first."]);
+    }
+    if (options.change) {
+        if (!isValidChangeName(options.change)) {
+            return fail(1, [`Invalid --change name: "${options.change}".`]);
+        }
+        return statusForChange(cwd, options.change, options.json ?? false);
+    }
+    return statusOverview(cwd, options.json ?? false);
+}
+function statusForChange(cwd, name, asJson) {
+    const candidates = [
+        { dir: getChangeDir(cwd, name), location: 'active' },
+        { dir: getArchiveDir(cwd, name), location: 'archived' },
+    ];
+    const found = candidates.find((c) => safeIsDir(c.dir));
+    if (!found) {
+        return fail(1, [`Change '${name}' not found in specdo/changes/ or specdo/archive/.`]);
+    }
+    const summary = collectSummary(name, found.dir, found.location);
+    if (asJson) {
+        return ok([JSON.stringify({ kind: 'status', summary }, null, 2)]);
+    }
+    const ctx = new ContextStore({ changeDir: found.dir }).read();
+    const stdout = [];
+    stdout.push(`Change: ${name} (${found.location})`);
+    stdout.push('');
+    stdout.push(`Stage    : ${summary.stage}`);
+    stdout.push(`Tasks    : ${summary.tasksCompleted}/${summary.tasksTotal} complete${summary.evidenceMissing > 0 ? ` (${summary.evidenceMissing} missing evidence)` : ''}`);
+    stdout.push(`Updated  : ${summary.updatedAt ?? '(unknown)'}`);
+    stdout.push('');
+    stdout.push('Pipeline:');
+    stdout.push(`  explore : ${ctx.explore ? (ctx.explore.completedAt ? '✓' : '… in progress') : '(not run)'}`);
+    stdout.push(`  propose : ${ctx.propose ? (ctx.propose.completedAt ? '✓' : '… in progress') : '(not run)'}`);
+    stdout.push(`  apply   : ${ctx.apply ? (ctx.apply.completedAt ? '✓' : `… ${ctx.apply.tasksCompleted}/${ctx.apply.tasksTotal}`) : '(not run)'}`);
+    stdout.push(`  sync    : ${ctx.sync ? (ctx.sync.completedAt ? '✓' + (summary.hasUnresolvedConflicts ? ' (with unresolved conflicts!)' : '') : '… in progress') : '(not run)'}`);
+    stdout.push(`  archive : ${ctx.archive ? '✓' : '(not run)'}`);
+    if (summary.hasUnresolvedConflicts) {
+        stdout.push('');
+        stdout.push('⚠ Unresolved sync conflicts. Run `specdo sync --change ' + name + '` to inspect.');
+    }
+    if (summary.evidenceMissing > 0) {
+        stdout.push('');
+        stdout.push(`⚠ ${summary.evidenceMissing} completed task(s) lack evidence. Run validate for details.`);
+    }
+    return ok(stdout);
+}
+function statusOverview(cwd, asJson) {
+    const summaries = [];
+    const changesDir = path.join(getSpecdoDir(cwd), 'changes');
+    if (safeIsDir(changesDir)) {
+        for (const name of fs.readdirSync(changesDir)) {
+            const dir = path.join(changesDir, name);
+            if (!safeIsDir(dir))
+                continue;
+            summaries.push(collectSummary(name, dir, 'active'));
+        }
+    }
+    summaries.sort((a, b) => {
+        const ta = a.updatedAt ? new Date(a.updatedAt).getTime() : 0;
+        const tb = b.updatedAt ? new Date(b.updatedAt).getTime() : 0;
+        return tb - ta;
+    });
+    if (asJson) {
+        return ok([JSON.stringify({ kind: 'status-overview', changes: summaries }, null, 2)]);
+    }
+    const stdout = [];
+    if (summaries.length === 0) {
+        stdout.push('No active changes. Run `specdo explore "<idea>"` to start one.');
+        return ok(stdout);
+    }
+    stdout.push(`Active changes (${summaries.length}):`);
+    stdout.push('');
+    stdout.push(`  ${'NAME'.padEnd(28)} ${'STAGE'.padEnd(10)} ${'TASKS'.padEnd(10)} ${'FLAGS'.padEnd(10)} UPDATED`);
+    for (const s of summaries) {
+        const tasks = s.tasksTotal > 0 ? `${s.tasksCompleted}/${s.tasksTotal}` : '-';
+        const flags = [
+            s.hasUnresolvedConflicts ? 'conflict' : null,
+            s.hasForcedConflicts ? 'forced' : null,
+            s.evidenceMissing > 0 ? `ev-${s.evidenceMissing}` : null,
+        ].filter(Boolean).join(',') || '-';
+        const updated = s.updatedAt ? s.updatedAt.replace('T', ' ').slice(0, 19) : '(unknown)';
+        stdout.push(`  ${s.name.padEnd(28)} ${s.stage.padEnd(10)} ${tasks.padEnd(10)} ${flags.padEnd(10)} ${updated}`);
+    }
+    return ok(stdout);
+}
+function collectSummary(name, dir, location) {
+    const ctx = new ContextStore({ changeDir: dir }).read();
+    let total = 0;
+    let completed = 0;
+    let evidenceMissing = 0;
+    const tasksPath = path.join(dir, 'tasks.md');
+    if (safeExists(tasksPath)) {
+        try {
+            const parsed = parseTasks(fs.readFileSync(tasksPath, 'utf-8'));
+            total = parsed.tasks.length;
+            completed = parsed.tasks.filter((t) => t.completed).length;
+            evidenceMissing = parsed.tasks.filter((t) => t.completed && (!t.evidence || t.evidence.trim().length === 0)).length;
+        }
+        catch {
+            /* parse error → counts stay 0; validate command will surface */
+        }
+    }
+    return {
+        name,
+        location,
+        stage: deriveStage(ctx),
+        tasksCompleted: completed,
+        tasksTotal: total,
+        evidenceMissing,
+        hasUnresolvedConflicts: (ctx.sync?.conflicts ?? []).length > 0,
+        hasForcedConflicts: (ctx.sync?.forcedConflicts ?? []).length > 0,
+        updatedAt: ctx.change?.updatedAt ?? null,
+    };
+}
+function deriveStage(ctx) {
+    if (ctx.archive)
+        return 'archive';
+    if (ctx.sync?.completedAt)
+        return 'synced';
+    if (ctx.apply)
+        return ctx.apply.completedAt ? 'apply✓' : 'apply';
+    if (ctx.propose)
+        return 'propose';
+    if (ctx.explore)
+        return 'explore';
+    return 'init';
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

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

package/dist/commands/sync.d.ts

@@ -0,0 +1,21 @@
+/**
+ * specdo sync [--change <name>] [--force]
+ *
+ * 行为：
+ *   1. 递归读取 specdo/changes/<name>/specs/ 下的全部 markdown spec 文件
+ *   2. 与 specdo/specs/ 下的对应相对路径文件做比对
+ *   3. 仅 added → 写入；含 conflict 且无 --force → exit 1，写 conflicts
+ *   4. 含 conflict 且 --force → 备份 + 覆盖 + 写 forcedConflicts/forcedConflictHashes
+ *   5. 写 context.sync.{syncedSpecs, conflicts, forcedConflicts, forcedConflictHashes, forced, completedAt}
+ *
+ * `.sync-backup/` 残留 → exit 3
+ */
+import { CommandResult } from './_shared.js';
+export interface SyncOptions {
+    cwd: string;
+    change?: string;
+    force?: boolean;
+    now?: () => string;
+}
+export declare function handleSync(options: SyncOptions): Promise<CommandResult>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/commands/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EACL,aAAa,EAQd,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CA0G7E"}

package/dist/commands/sync.js

@@ -0,0 +1,113 @@
+/**
+ * specdo sync [--change <name>] [--force]
+ *
+ * 行为：
+ *   1. 递归读取 specdo/changes/<name>/specs/ 下的全部 markdown spec 文件
+ *   2. 与 specdo/specs/ 下的对应相对路径文件做比对
+ *   3. 仅 added → 写入；含 conflict 且无 --force → exit 1，写 conflicts
+ *   4. 含 conflict 且 --force → 备份 + 覆盖 + 写 forcedConflicts/forcedConflictHashes
+ *   5. 写 context.sync.{syncedSpecs, conflicts, forcedConflicts, forcedConflictHashes, forced, completedAt}
+ *
+ * `.sync-backup/` 残留 → exit 3
+ */
+import * as path from 'node:path';
+import { ContextStore } from '../core/context-store.js';
+import { executeSync, SyncError } from '../core/spec-sync.js';
+import { fail, findSpecdoConfig, getChangeDir, getSpecdoDir, getSpecsDir, isValidChangeName, safeIsDir, } from './_shared.js';
+export async function handleSync(options) {
+    const { cwd, force } = options;
+    if (!findSpecdoConfig(cwd)) {
+        return fail(1, ["Not initialized. Run 'specdo init' first."]);
+    }
+    if (!options.change) {
+        return fail(1, ['sync requires --change <name>.']);
+    }
+    if (!isValidChangeName(options.change)) {
+        return fail(1, [`Invalid --change name: "${options.change}".`]);
+    }
+    const changeName = options.change;
+    const changeDir = getChangeDir(cwd, changeName);
+    if (!safeIsDir(changeDir)) {
+        return fail(1, [`Change directory not found: ${changeDir}.`]);
+    }
+    const sourceSpecsDir = path.join(changeDir, 'specs');
+    if (!safeIsDir(sourceSpecsDir)) {
+        return fail(1, [
+            `Source specs directory not found at ${sourceSpecsDir}.`,
+            `Run 'specdo propose --change ${changeName}' first.`,
+        ]);
+    }
+    const specsDir = getSpecsDir(cwd);
+    const backupDir = path.join(getSpecdoDir(cwd), '.sync-backup');
+    const now = options.now ?? (() => new Date().toISOString());
+    const store = new ContextStore({ changeDir, now });
+    const ctx = store.read();
+    // 前置条件：apply 必须完成
+    if (!ctx.apply || ctx.apply.completedAt === null) {
+        return fail(1, [
+            `Cannot sync: apply is not complete.`,
+            `Run 'specdo apply --change ${changeName}' and complete all tasks first.`,
+        ]);
+    }
+    try {
+        const result = executeSync({
+            changesSpecsDir: sourceSpecsDir,
+            specsDir,
+            backupDir,
+            force: Boolean(force),
+        });
+        const stdout = [];
+        const stderr = [];
+        if (result.conflicts.length > 0) {
+            // 未使用 --force 且存在冲突
+            stderr.push(`Sync blocked: ${result.conflicts.length} conflict(s) detected.`);
+            for (const rel of result.conflicts) {
+                stderr.push(`  ✗ ${rel}`);
+            }
+            stderr.push(`Run with --force to overwrite (a backup will be written to specdo/.sync-backup/).`);
+            store.writeDeep({
+                sync: {
+                    syncedSpecs: result.syncedSpecs,
+                    conflicts: result.conflicts,
+                    forcedConflicts: [],
+                    forcedConflictHashes: {},
+                    forced: false,
+                    completedAt: null,
+                },
+            });
+            return { exitCode: 1, stdout, stderr };
+        }
+        stdout.push(`# specdo sync --change ${changeName}`);
+        stdout.push('');
+        stdout.push(`Synced ${result.syncedSpecs.length} spec file(s) into ${path.relative(cwd, specsDir)}/.`);
+        for (const rel of result.syncedSpecs) {
+            const forcedTag = result.forcedConflicts.includes(rel) ? '  [forced]' : '';
+            stdout.push(`  ✓ ${rel}${forcedTag}`);
+        }
+        if (result.forcedConflicts.length > 0) {
+            stdout.push('');
+            stdout.push(`Forced overwrites recorded in context.json.sync.forcedConflictHashes (${result.forcedConflicts.length} entries).`);
+        }
+        store.writeDeep({
+            sync: {
+                syncedSpecs: result.syncedSpecs,
+                conflicts: [],
+                forcedConflicts: result.forcedConflicts,
+                forcedConflictHashes: result.forcedConflictHashes,
+                forced: result.forced,
+                completedAt: now(),
+            },
+        });
+        stdout.push('');
+        stdout.push(`Next: specdo archive --change ${changeName}`);
+        return { exitCode: 0, stdout, stderr };
+    }
+    catch (err) {
+        if (err instanceof SyncError) {
+            const code = err.exitCode === 1 || err.exitCode === 3 ? err.exitCode : 3;
+            return fail(code, [err.message]);
+        }
+        return fail(3, [`Sync failed: ${err.message}`]);
+    }
+}
+//# sourceMappingURL=sync.js.map

package/dist/commands/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAEL,IAAI,EACJ,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,SAAS,GACV,MAAM,cAAc,CAAC;AAStB,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAoB;IACnD,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAE/B,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC,2CAA2C,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC,gCAAgC,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC,2BAA2B,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAClC,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAChD,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC,+BAA+B,SAAS,GAAG,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACrD,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,CAAC,EAAE;YACb,uCAAuC,cAAc,GAAG;YACxD,gCAAgC,UAAU,UAAU;SACrD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,cAAc,CAAC,CAAC;IAE/D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAEzB,kBAAkB;IAClB,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC,CAAC,EAAE;YACb,qCAAqC;YACrC,8BAA8B,UAAU,iCAAiC;SAC1E,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,WAAW,CAAC;YACzB,eAAe,EAAE,cAAc;YAC/B,QAAQ;YACR,SAAS;YACT,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC;SACtB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,oBAAoB;YACpB,MAAM,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,SAAS,CAAC,MAAM,wBAAwB,CAAC,CAAC;YAC9E,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACnC,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;YAC5B,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,mFAAmF,CAAC,CAAC;YACjG,KAAK,CAAC,SAAS,CAAC;gBACd,IAAI,EAAE;oBACJ,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,eAAe,EAAE,EAAE;oBACnB,oBAAoB,EAAE,EAAE;oBACxB,MAAM,EAAE,KAAK;oBACb,WAAW,EAAE,IAAI;iBAClB;aACF,CAAC,CAAC;YACH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QACzC,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,0BAA0B,UAAU,EAAE,CAAC,CAAC;QACpD,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,WAAW,CAAC,MAAM,sBAAsB,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvG,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3E,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG,GAAG,SAAS,EAAE,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,yEAAyE,MAAM,CAAC,eAAe,CAAC,MAAM,YAAY,CAAC,CAAC;QAClI,CAAC;QAED,KAAK,CAAC,SAAS,CAAC;YACd,IAAI,EAAE;gBACJ,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,SAAS,EAAE,EAAE;gBACb,eAAe,EAAE,MAAM,CAAC,eAAe;gBACvC,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;gBACjD,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,WAAW,EAAE,GAAG,EAAE;aACnB;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,iCAAiC,UAAU,EAAE,CAAC,CAAC;QAC3D,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YACzE,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC,gBAAiB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC"}

package/dist/commands/validate.d.ts

@@ -0,0 +1,117 @@
+/**
+ * specdo validate [--change <name>] [--json]
+ *
+ * 校验范围：
+ *   1. config.yaml schema + overrides (loadConfig)
+ *   2. 每个 change（active）的 context.json schema (Zod)
+ *   3. tasks.md 一致性：
+ *      - 重复编号 / 缺口 → warn（缺口）/ error（重复）
+ *      - 已完成任务缺 evidence → warning
+ *      - context.apply.{tasksTotal, tasksCompleted, tasksEvidence} 与 tasks.md 一致
+ *   4. artifact 引用：proposal/design/tasks/specs 文件存在
+ *   5. context.json 与 propose.artifacts 路径自洽
+ *
+ * 输出：分组 (config / changes/<name>) 列出 issues；error 计数 > 0 → exit 1。
+ * 任意 change 失败时仍继续校验剩余 change。
+ */
+import { z } from 'zod';
+import { CommandResult } from './_shared.js';
+export interface ValidateOptions {
+    cwd: string;
+    change?: string;
+    json?: boolean;
+}
+export interface ValidationIssue {
+    level: 'error' | 'warn';
+    scope: string;
+    path: string;
+    message: string;
+}
+export interface ChangeValidationSnapshot {
+    issues: ValidationIssue[];
+    context: z.infer<typeof contextSchema> | null;
+    tasks: {
+        total: number;
+        completed: number;
+        evidenceMap: Record<string, string>;
+    };
+}
+declare const contextSchema: z.ZodObject<{
+    version: z.ZodLiteral<2>;
+    change: z.ZodObject<{
+        name: z.ZodString;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>;
+    explore: z.ZodOptional<z.ZodObject<{
+        input: z.ZodString;
+        matchedDomains: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            score: z.ZodNumber;
+            reason: z.ZodString;
+        }, z.core.$strip>>;
+        answers: z.ZodRecord<z.ZodString, z.ZodString>;
+        flaggedConcerns: z.ZodArray<z.ZodString>;
+        completedAt: z.ZodNullable<z.ZodString>;
+        collectedContext: z.ZodOptional<z.ZodString>;
+        depth: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            shallow: "shallow";
+            standard: "standard";
+            deep: "deep";
+        }>>>;
+        llmQuestions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+    }, z.core.$strip>>;
+    propose: z.ZodOptional<z.ZodObject<{
+        artifacts: z.ZodObject<{
+            proposal: z.ZodString;
+            specs: z.ZodArray<z.ZodString>;
+            design: z.ZodString;
+            tasks: z.ZodString;
+        }, z.core.$strip>;
+        domainsUsed: z.ZodArray<z.ZodString>;
+        capabilities: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            kind: z.ZodEnum<{
+                new: "new";
+                modified: "modified";
+            }>;
+            specPath: z.ZodString;
+        }, z.core.$strip>>>;
+        completedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    apply: z.ZodOptional<z.ZodObject<{
+        completedAt: z.ZodNullable<z.ZodString>;
+        tasksTotal: z.ZodNumber;
+        tasksCompleted: z.ZodNumber;
+        tasksEvidence: z.ZodRecord<z.ZodString, z.ZodString>;
+        applyBriefGenerated: z.ZodBoolean;
+    }, z.core.$strip>>;
+    sync: z.ZodOptional<z.ZodObject<{
+        syncedSpecs: z.ZodArray<z.ZodString>;
+        conflicts: z.ZodArray<z.ZodString>;
+        forcedConflicts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        forcedConflictHashes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            before: z.ZodString;
+            after: z.ZodString;
+        }, z.core.$strip>>>;
+        forced: z.ZodBoolean;
+        completedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    archive: z.ZodOptional<z.ZodObject<{
+        archivedAt: z.ZodString;
+        archivePath: z.ZodString;
+        summaryPath: z.ZodString;
+        skippedSyncCheck: z.ZodOptional<z.ZodBoolean>;
+        skipSyncReason: z.ZodOptional<z.ZodString>;
+        syncSnapshot: z.ZodOptional<z.ZodObject<{
+            completedAt: z.ZodNullable<z.ZodString>;
+            unresolvedConflicts: z.ZodArray<z.ZodString>;
+            forcedConflicts: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+        riskNotes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare function handleValidate(options: ValidateOptions): Promise<CommandResult>;
+export declare function validateChange(cwd: string, name: string): ChangeValidationSnapshot;
+export {};
+//# sourceMappingURL=validate.d.ts.map

package/dist/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACL,aAAa,EASd,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,GAAG,IAAI,CAAC;IAC9C,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACrC,CAAC;CACH;AA6ED,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAcjB,CAAC;AAEH,wBAAsB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,CA4ErF;AAYD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,wBAAwB,CAkNlF"}