specdo 1.0.2

package/dist/commands/_shared.d.ts

@@ -0,0 +1,45 @@
+/**
+ * commands 共享类型与工具
+ *
+ * 所有命令遵循同一签名：
+ *   `handle(options): Promise<CommandResult>`
+ *
+ * `CommandResult.exitCode` 必须使用 phases/03-phase2-commands.md §"Exit Code
+ * 体系" 定义的统一编码。`stdout` / `stderr` 由 CLI wrapper 写入终端；测试
+ * 直接断言数组内容，无需 spawn 子进程。
+ */
+export interface CommandResult {
+    exitCode: 0 | 1 | 2 | 3 | 4;
+    stdout: string[];
+    stderr: string[];
+}
+export declare function ok(stdout?: string[]): CommandResult;
+export declare function fail(exitCode: 1 | 2 | 3 | 4, stderr: string[], stdout?: string[]): CommandResult;
+/**
+ * 检测目标目录是否已经 init（specdo/config.yaml 或 .yml 存在）。
+ *
+ * 不存在 → 返回 null；存在 → 返回绝对路径。
+ */
+export declare function findSpecdoConfig(cwd: string): string | null;
+export declare function getSpecdoDir(cwd: string): string;
+export declare function getChangeDir(cwd: string, changeName: string): string;
+export declare function getArchiveDir(cwd: string, changeName: string): string;
+export declare function getSpecsDir(cwd: string): string;
+/**
+ * 从用户的 idea 描述生成 change slug（kebab-case），最多 5 个有意义 token，
+ * 总长度 ≤ 50 字符。规则与 phases/03-phase2-commands.md §"Change 名称 slug
+ * 生成规则" 完全对齐。
+ *
+ * 失败：返回空字符串；调用方应转为 exit code 1 提示 "Cannot generate
+ * change name from input. Use --change <name>."
+ */
+export declare function generateChangeSlug(idea: string): string;
+/** 用户提供的 --change 名称合规性校验 */
+export declare function isValidChangeName(name: string): boolean;
+export declare function safeIsFile(p: string): boolean;
+export declare function safeIsDir(p: string): boolean;
+export declare function safeExists(p: string): boolean;
+import type { ConfigIssue, ConfigLoadResult } from '../core/config-store.js';
+export declare function failOnInvalidConfig(result: ConfigLoadResult): CommandResult | null;
+export declare function renderConfigIssues(issues: ConfigIssue[]): string[];
+//# sourceMappingURL=_shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../src/commands/_shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,EAAE,CAAC,MAAM,GAAE,MAAM,EAAO,GAAG,aAAa,CAEvD;AAED,wBAAgB,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,GAAE,MAAM,EAAO,GAAG,aAAa,CAEpG;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM3D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAQD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBvD;AAED,6BAA6B;AAC7B,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAM7C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAM5C;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAO7C;AAID,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE7E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,aAAa,GAAG,IAAI,CAMlF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,CAKlE"}

package/dist/commands/_shared.js

@@ -0,0 +1,124 @@
+/**
+ * commands 共享类型与工具
+ *
+ * 所有命令遵循同一签名：
+ *   `handle(options): Promise<CommandResult>`
+ *
+ * `CommandResult.exitCode` 必须使用 phases/03-phase2-commands.md §"Exit Code
+ * 体系" 定义的统一编码。`stdout` / `stderr` 由 CLI wrapper 写入终端；测试
+ * 直接断言数组内容，无需 spawn 子进程。
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+export function ok(stdout = []) {
+    return { exitCode: 0, stdout, stderr: [] };
+}
+export function fail(exitCode, stderr, stdout = []) {
+    return { exitCode, stdout, stderr };
+}
+/**
+ * 检测目标目录是否已经 init（specdo/config.yaml 或 .yml 存在）。
+ *
+ * 不存在 → 返回 null；存在 → 返回绝对路径。
+ */
+export function findSpecdoConfig(cwd) {
+    for (const candidate of ['specdo/config.yaml', 'specdo/config.yml']) {
+        const abs = path.join(cwd, candidate);
+        if (safeIsFile(abs))
+            return abs;
+    }
+    return null;
+}
+export function getSpecdoDir(cwd) {
+    return path.join(cwd, 'specdo');
+}
+export function getChangeDir(cwd, changeName) {
+    return path.join(cwd, 'specdo', 'changes', changeName);
+}
+export function getArchiveDir(cwd, changeName) {
+    return path.join(cwd, 'specdo', 'archive', changeName);
+}
+export function getSpecsDir(cwd) {
+    return path.join(cwd, 'specdo', 'specs');
+}
+const STOP_WORDS = new Set([
+    'a', 'an', 'and', 'as', 'at', 'be', 'but', 'by', 'do', 'for', 'from', 'in', 'is', 'it', 'of',
+    'on', 'or', 'so', 'the', 'to', 'with', 'add', 'fix', 'create', 'update', 'feature', 'change',
+    'support', 'enable', 'allow',
+]);
+/**
+ * 从用户的 idea 描述生成 change slug（kebab-case），最多 5 个有意义 token，
+ * 总长度 ≤ 50 字符。规则与 phases/03-phase2-commands.md §"Change 名称 slug
+ * 生成规则" 完全对齐。
+ *
+ * 失败：返回空字符串；调用方应转为 exit code 1 提示 "Cannot generate
+ * change name from input. Use --change <name>."
+ */
+export function generateChangeSlug(idea) {
+    if (!idea || idea.trim().length === 0)
+        return '';
+    // 1. 转小写 + 非 ASCII 字符替换为空格
+    const ascii = idea.toLowerCase().replace(/[^\x20-\x7e]+/g, ' ');
+    // 2. 拆 token
+    const rawTokens = ascii.split(/[^a-z0-9]+/).filter(Boolean);
+    // 3. 过滤停用词；如果过滤后没有 token，回退为不过滤的列表
+    const filtered = rawTokens.filter((t) => !STOP_WORDS.has(t));
+    const tokens = filtered.length > 0 ? filtered : rawTokens;
+    // 4. 取前 5 个，连接
+    const joined = tokens.slice(0, 5).join('-');
+    if (!joined)
+        return '';
+    // 5. 仅保留 [a-z0-9-]，去除连续/边缘 -
+    let slug = joined.replace(/[^a-z0-9-]+/g, '').replace(/-+/g, '-').replace(/^-+|-+$/g, '');
+    // 6. 截断 50 字符
+    if (slug.length > 50) {
+        slug = slug.slice(0, 50).replace(/-+$/, '');
+    }
+    return slug;
+}
+/** 用户提供的 --change 名称合规性校验 */
+export function isValidChangeName(name) {
+    if (!name || name.length === 0 || name.length > 50)
+        return false;
+    return /^[a-z0-9][a-z0-9-]*[a-z0-9]$/.test(name) || /^[a-z0-9]$/.test(name);
+}
+export function safeIsFile(p) {
+    try {
+        return fs.statSync(p).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+export function safeIsDir(p) {
+    try {
+        return fs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+export function safeExists(p) {
+    try {
+        fs.statSync(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function failOnInvalidConfig(result) {
+    if (result.config && result.issues.length === 0)
+        return null;
+    const issues = result.issues.length > 0
+        ? result.issues
+        : [{ path: 'specdo/config.yaml', message: 'config could not be loaded' }];
+    return fail(1, renderConfigIssues(issues));
+}
+export function renderConfigIssues(issues) {
+    return [
+        'Invalid specdo/config.yaml:',
+        ...issues.map((issue) => `  - ${issue.path}: ${issue.message}`),
+    ];
+}
+//# sourceMappingURL=_shared.js.map

package/dist/commands/_shared.js.map

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

package/dist/commands/apply.d.ts

@@ -0,0 +1,30 @@
+/**
+ * specdo apply [--change <name>] [--done N | --undo N] [--evidence "..."]
+ *
+ * 行为遵循 phases/03-phase2-commands.md §`apply`：
+ *
+ *   - 仅展示当前简报（无 --done/--undo）
+ *   - 标记任务完成：写入 tasks.md + tasksEvidence + 重新渲染 apply-brief.md
+ *   - 取消任务完成：删除 evidence 行 + 同步 context
+ *   - 全部完成时输出"All tasks complete (N/N)"
+ *
+ * 关键不变量：
+ *   - tasks.md 是唯一事实来源；context.apply 由解析结果回填，不会自创
+ *   - --done 与 --undo 互斥
+ *   - --done 必须带非空 --evidence；--undo 不能带 --evidence
+ *   - protocol（review-to-solid）注入条件：
+ *       1. ctx.propose.domainsUsed 含 'quality'
+ *       2. 或 当前任务在完整 resolved domains 中 scoreDomains 命中 quality
+ *     满足任一则注入；显式 trigger phrase 仅用于独立检测工具，不直接驱动 apply 注入
+ */
+import { CommandResult } from './_shared.js';
+export interface ApplyOptions {
+    cwd: string;
+    change?: string;
+    done?: string;
+    undo?: string;
+    evidence?: string;
+    now?: () => string;
+}
+export declare function handleApply(options: ApplyOptions): Promise<CommandResult>;
+//# sourceMappingURL=apply.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../src/commands/apply.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAsBH,OAAO,EACL,aAAa,EAQd,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAuK/E"}

package/dist/commands/apply.js

@@ -0,0 +1,393 @@
+/**
+ * specdo apply [--change <name>] [--done N | --undo N] [--evidence "..."]
+ *
+ * 行为遵循 phases/03-phase2-commands.md §`apply`：
+ *
+ *   - 仅展示当前简报（无 --done/--undo）
+ *   - 标记任务完成：写入 tasks.md + tasksEvidence + 重新渲染 apply-brief.md
+ *   - 取消任务完成：删除 evidence 行 + 同步 context
+ *   - 全部完成时输出"All tasks complete (N/N)"
+ *
+ * 关键不变量：
+ *   - tasks.md 是唯一事实来源；context.apply 由解析结果回填，不会自创
+ *   - --done 与 --undo 互斥
+ *   - --done 必须带非空 --evidence；--undo 不能带 --evidence
+ *   - protocol（review-to-solid）注入条件：
+ *       1. ctx.propose.domainsUsed 含 'quality'
+ *       2. 或 当前任务在完整 resolved domains 中 scoreDomains 命中 quality
+ *     满足任一则注入；显式 trigger phrase 仅用于独立检测工具，不直接驱动 apply 注入
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { scoreDomains } from '../domains/index.js';
+import { getProtocolByName } from '../protocols/index.js';
+import { ContextStore } from '../core/context-store.js';
+import { loadConfig, resolveDomains, } from '../core/config-store.js';
+import { applyTaskMutation, findTaskByNumber, isCanonicalTaskReference, parseTasks, } from '../core/task-parser.js';
+import { renderApplyBrief } from '../core/apply-brief-renderer.js';
+import { fail, findSpecdoConfig, getChangeDir, isValidChangeName, safeExists, safeIsDir, failOnInvalidConfig, } from './_shared.js';
+export async function handleApply(options) {
+    const { cwd } = options;
+    if (!findSpecdoConfig(cwd)) {
+        return fail(1, ["Not initialized. Run 'specdo init' first."]);
+    }
+    if (!options.change) {
+        return fail(1, ['apply requires --change <name>.']);
+    }
+    if (!isValidChangeName(options.change)) {
+        return fail(1, [`Invalid --change name: "${options.change}".`]);
+    }
+    if (options.done !== undefined && options.undo !== undefined) {
+        return fail(1, ['--done and --undo are mutually exclusive.']);
+    }
+    const changeName = options.change;
+    const changeDir = getChangeDir(cwd, changeName);
+    if (!safeIsDir(changeDir)) {
+        return fail(1, [
+            `Change directory not found: ${changeDir}.`,
+            `Run 'specdo explore' and 'specdo propose' first.`,
+        ]);
+    }
+    const tasksPath = path.join(changeDir, 'tasks.md');
+    if (!safeExists(tasksPath)) {
+        return fail(1, [
+            `tasks.md not found at ${tasksPath}.`,
+            `Run 'specdo propose --change ${changeName}' to generate the tasks template first.`,
+        ]);
+    }
+    const configResult = loadConfig(cwd);
+    const configFailure = failOnInvalidConfig(configResult);
+    if (configFailure)
+        return configFailure;
+    const resolvedAll = resolveDomains(configResult.config);
+    const now = options.now ?? (() => new Date().toISOString());
+    const store = new ContextStore({ changeDir, now });
+    const ctx = store.read();
+    let tasksContent;
+    try {
+        tasksContent = fs.readFileSync(tasksPath, 'utf-8');
+    }
+    catch (err) {
+        return toFilesystemFailure(`Failed to read tasks.md for change "${changeName}".`, err);
+    }
+    let parsed;
+    try {
+        parsed = parseTasks(tasksContent);
+    }
+    catch (err) {
+        return fail(1, [`Invalid tasks.md: ${err.message}`]);
+    }
+    const briefPath = path.join(changeDir, 'apply-brief.md');
+    const originalTasksContent = tasksContent;
+    let originalBrief;
+    try {
+        originalBrief = readOptionalFile(briefPath);
+    }
+    catch (err) {
+        return toFilesystemFailure(`Failed to inspect existing apply-brief.md for change "${changeName}".`, err);
+    }
+    const shouldRewriteTasks = options.done !== undefined || options.undo !== undefined;
+    // ─── 处理 --done ───
+    if (options.done !== undefined) {
+        const validation = validateDoneArgs(options, parsed.tasks);
+        if (validation)
+            return validation;
+        const target = findTaskByNumber(parsed, options.done);
+        tasksContent = applyTaskMutation(tasksContent, target, {
+            completed: true,
+            evidence: options.evidence ?? null,
+        });
+        try {
+            parsed = parseTasks(tasksContent);
+        }
+        catch (err) {
+            return fail(1, [`Invalid tasks.md after mutation: ${err.message}`]);
+        }
+    }
+    // ─── 处理 --undo ───
+    if (options.undo !== undefined) {
+        const validation = validateUndoArgs(options, parsed.tasks);
+        if (validation)
+            return validation;
+        const target = findTaskByNumber(parsed, options.undo);
+        tasksContent = applyTaskMutation(tasksContent, target, { completed: false, evidence: null });
+        try {
+            parsed = parseTasks(tasksContent);
+        }
+        catch (err) {
+            return fail(1, [`Invalid tasks.md after mutation: ${err.message}`]);
+        }
+    }
+    // ─── 计算当前任务 + 协议注入 ───
+    const completedCount = parsed.tasks.filter((t) => t.completed).length;
+    const currentTask = parsed.tasks.find((t) => !t.completed) ?? null;
+    const domains = pickDomainsForTask(resolvedAll, currentTask, ctx);
+    const protocol = pickProtocol(resolvedAll.map((r) => r.domain), currentTask, ctx);
+    // ─── 渲染并写 apply-brief.md ───
+    const brief = renderApplyBrief({
+        changeName,
+        domains,
+        protocol,
+        tasks: parsed.tasks,
+        currentTaskNumber: currentTask?.number ?? null,
+        generatedAt: now(),
+    });
+    // ─── 同步 context.apply ───
+    const allDone = parsed.tasks.length > 0 && completedCount === parsed.tasks.length;
+    const nextTasksEvidence = buildTasksEvidencePatch(ctx.apply?.tasksEvidence ?? {}, parsed.tasks);
+    const writeFailure = syncApplyArtifacts({
+        tasksPath,
+        tasksContent,
+        originalTasksContent,
+        shouldRewriteTasks,
+        briefPath,
+        briefContent: brief,
+        originalBrief,
+        store,
+        applyState: {
+            tasksTotal: parsed.tasks.length,
+            tasksCompleted: completedCount,
+            tasksEvidence: nextTasksEvidence,
+            applyBriefGenerated: true,
+            completedAt: allDone ? now() : null,
+        },
+    });
+    if (writeFailure)
+        return writeFailure;
+    // ─── 输出 ───
+    const stdout = [];
+    for (const w of parsed.warnings) {
+        stdout.push(`! ${w}`);
+    }
+    stdout.push(`# specdo apply --change ${changeName}`);
+    stdout.push('');
+    stdout.push(`Tasks: ${completedCount}/${parsed.tasks.length} complete`);
+    if (options.done !== undefined) {
+        stdout.push(`✓ Marked task ${options.done} done.`);
+    }
+    if (options.undo !== undefined) {
+        stdout.push(`✓ Reverted task ${options.undo} to incomplete (evidence cleared).`);
+    }
+    stdout.push('');
+    if (allDone) {
+        stdout.push(`All tasks complete (${completedCount}/${parsed.tasks.length}).`);
+        stdout.push(`Run 'specdo sync --change ${changeName}' then 'specdo archive --change ${changeName}' to finalize.`);
+    }
+    else if (currentTask) {
+        stdout.push(`Current focus: task ${currentTask.number}. ${currentTask.title}`);
+        stdout.push(`Brief written to ${path.relative(cwd, briefPath)}.`);
+        stdout.push('');
+        stdout.push(`Mark complete with: specdo apply --change ${changeName} --done ${currentTask.number} --evidence "<...>"`);
+    }
+    else if (parsed.tasks.length === 0) {
+        stdout.push('No tasks defined yet. Edit tasks.md to add `- [ ] 1.1 <title>` entries, then re-run apply.');
+    }
+    if (protocol) {
+        stdout.push('');
+        stdout.push(`Protocol injected: ${protocol.name}`);
+    }
+    return { exitCode: 0, stdout, stderr: [] };
+}
+// ─── helpers ────────────────────────────────────────────────────
+function validateDoneArgs(options, tasks) {
+    const { done, evidence, undo } = options;
+    if (done === undefined)
+        return null;
+    if (undo !== undefined)
+        return fail(1, ['--done and --undo are mutually exclusive.']);
+    if (!isCanonicalTaskReference(done)) {
+        return fail(1, [`--done expects a task reference like "1" or "1.1"; got ${done}.`]);
+    }
+    if (tasks.length === 0) {
+        return fail(1, [`tasks.md has no parseable tasks; cannot mark ${done} done.`]);
+    }
+    const target = tasks.find((t) => t.number === done);
+    if (!target) {
+        return fail(1, [
+            `No task numbered ${done} in tasks.md.`,
+            `Available task refs include: ${tasks.slice(0, 6).map((t) => t.number).join(', ')}${tasks.length > 6 ? ', ...' : ''}`,
+        ]);
+    }
+    if (target.completed) {
+        return fail(1, [
+            `Task ${done} is already completed.`,
+            `Run 'specdo apply --change ${options.change} --undo ${done}' first to update its evidence.`,
+        ]);
+    }
+    if (evidence === undefined) {
+        return fail(1, ['--evidence is required when marking done. Provide a non-empty string.']);
+    }
+    if (typeof evidence !== 'string' || evidence.trim().length === 0) {
+        return fail(1, ['Evidence must be non-empty.']);
+    }
+    return null;
+}
+function validateUndoArgs(options, tasks) {
+    const { undo, evidence } = options;
+    if (undo === undefined)
+        return null;
+    if (evidence !== undefined) {
+        return fail(1, ['--evidence cannot be used with --undo. Use --done N --evidence "..." instead.']);
+    }
+    if (!isCanonicalTaskReference(undo)) {
+        return fail(1, [`--undo expects a task reference like "1" or "1.1"; got ${undo}.`]);
+    }
+    if (tasks.length === 0) {
+        return fail(1, [`tasks.md has no parseable tasks; cannot undo ${undo}.`]);
+    }
+    const target = tasks.find((t) => t.number === undo);
+    if (!target) {
+        return fail(1, [`No task numbered ${undo} in tasks.md.`]);
+    }
+    if (!target.completed) {
+        return fail(1, [`Task ${undo} is not completed; nothing to undo.`]);
+    }
+    return null;
+}
+function pickDomainsFromContext(resolvedAll, ctx) {
+    const byName = new Map(resolvedAll.map((r) => [r.domain.name, r.domain]));
+    const used = ctx?.propose?.domainsUsed;
+    if (!used || used.length === 0) {
+        return resolvedAll.map((r) => r.domain);
+    }
+    const out = [];
+    for (const name of used) {
+        const d = byName.get(name);
+        if (d)
+            out.push(d);
+    }
+    return out.length > 0 ? out : resolvedAll.map((r) => r.domain);
+}
+function pickDomainsForTask(resolvedAll, currentTask, ctx) {
+    if (!currentTask) {
+        return pickDomainsFromContext(resolvedAll, ctx);
+    }
+    const allDomains = resolvedAll.map((r) => r.domain);
+    const taskMatches = scoreDomains(currentTask.title, allDomains);
+    if (taskMatches.length === 0) {
+        return pickDomainsFromContext(resolvedAll, ctx);
+    }
+    const byName = new Map(resolvedAll.map((r) => [r.domain.name, r.domain]));
+    const out = [];
+    for (const match of taskMatches) {
+        const d = byName.get(match.name);
+        if (d)
+            out.push(d);
+    }
+    return out.length > 0 ? out : pickDomainsFromContext(resolvedAll, ctx);
+}
+function buildTasksEvidenceMap(tasks) {
+    const out = {};
+    for (const task of tasks) {
+        if (!task.completed)
+            continue;
+        if (!task.evidence || task.evidence.trim().length === 0)
+            continue;
+        out[String(task.number)] = task.evidence;
+    }
+    return out;
+}
+function buildTasksEvidencePatch(previous, tasks) {
+    const next = buildTasksEvidenceMap(tasks);
+    const patch = {};
+    for (const [key, value] of Object.entries(next)) {
+        patch[key] = value;
+    }
+    for (const key of Object.keys(previous)) {
+        if (!(key in next)) {
+            patch[key] = null;
+        }
+    }
+    return patch;
+}
+function syncApplyArtifacts(input) {
+    const rollbackSteps = [];
+    try {
+        if (input.shouldRewriteTasks) {
+            atomicWriteText(input.tasksPath, input.tasksContent);
+            rollbackSteps.push(() => {
+                atomicWriteText(input.tasksPath, input.originalTasksContent);
+            });
+        }
+        atomicWriteText(input.briefPath, input.briefContent);
+        rollbackSteps.push(() => {
+            restoreOptionalFile(input.briefPath, input.originalBrief);
+        });
+        input.store.writeDeep({
+            apply: input.applyState,
+        });
+        return null;
+    }
+    catch (err) {
+        const rollbackErrors = [];
+        for (let idx = rollbackSteps.length - 1; idx >= 0; idx--) {
+            try {
+                rollbackSteps[idx]?.();
+            }
+            catch (rollbackErr) {
+                rollbackErrors.push(rollbackErr.message);
+            }
+        }
+        return toFilesystemFailure('Failed to synchronize apply state.', err, rollbackErrors);
+    }
+}
+function atomicWriteText(targetPath, content) {
+    fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+    const tmpPath = `${targetPath}.tmp-${process.pid}-${Date.now().toString(16)}`;
+    try {
+        fs.writeFileSync(tmpPath, content, 'utf-8');
+        fs.renameSync(tmpPath, targetPath);
+    }
+    finally {
+        try {
+            fs.rmSync(tmpPath, { force: true });
+        }
+        catch {
+            /* tmp cleanup is best-effort */
+        }
+    }
+}
+function readOptionalFile(filePath) {
+    try {
+        return { exists: true, content: fs.readFileSync(filePath, 'utf-8') };
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'ENOENT')
+            return { exists: false, content: null };
+        throw err;
+    }
+}
+function restoreOptionalFile(filePath, state) {
+    if (!state.exists) {
+        fs.rmSync(filePath, { force: true });
+        return;
+    }
+    atomicWriteText(filePath, state.content ?? '');
+}
+function toFilesystemFailure(message, err, rollbackErrors = []) {
+    const detail = err instanceof Error ? err.message : String(err);
+    const stderr = [`${message} ${detail}`];
+    if (rollbackErrors.length > 0) {
+        stderr.push(`Rollback failed: ${rollbackErrors.join(' | ')}`);
+    }
+    stderr.push('This is treated as a filesystem reliability failure (exit code 3).');
+    return fail(3, stderr);
+}
+function pickProtocol(allResolvedDomains, currentTask, ctx) {
+    // 触发条件：
+    //   1. domainsUsed 含 quality
+    //   2. 当前任务 scoreDomains 命中 quality
+    const usedHasQuality = ctx?.propose?.domainsUsed?.includes('quality') ?? false;
+    let taskHitsQuality = false;
+    if (currentTask) {
+        const taskMatches = scoreDomains(currentTask.title, allResolvedDomains);
+        taskHitsQuality = taskMatches.some((m) => m.name === 'quality');
+    }
+    if (!usedHasQuality && !taskHitsQuality)
+        return null;
+    // 注入 review-to-solid（若可用）；否则降级为 TDD（返回 null）
+    const protocol = getProtocolByName('review-to-solid');
+    return protocol ?? null;
+}
+//# sourceMappingURL=apply.js.map

package/dist/commands/apply.js.map

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

package/dist/commands/archive.d.ts

@@ -0,0 +1,25 @@
+/**
+ * specdo archive [--change <name>] [--skip-sync-check]
+ *
+ * 行为：
+ *   1. 必须 init；--change 必需
+ *   2. 检查 tasks 全部完成 + 每个完成任务有 evidence
+ *   3. 实时只读检查当前 changes/<name>/specs 与 specdo/specs 的同步状态
+ *        - 只要存在 added / conflict → 始终失败（即使 --skip-sync-check）
+ *        - sync 未运行 → 失败（除非 --skip-sync-check）
+ *        - sync.completedAt = null → 失败（除非 --skip-sync-check）
+ *   4. same-filesystem rename: changes/<name>/ → archive/<name>/
+ *   5. 在 archive 目录内写 archive-summary.md 与 context.archive 元数据
+ *      - rename 失败 EXDEV → exit 3
+ *      - 目标已存在 → exit 1
+ *      - 元数据写入失败 → 尝试回滚 rename，避免 active change 脏状态
+ */
+import { CommandResult } from './_shared.js';
+export interface ArchiveOptions {
+    cwd: string;
+    change?: string;
+    skipSyncCheck?: boolean;
+    now?: () => string;
+}
+export declare function handleArchive(options: ArchiveOptions): Promise<CommandResult>;
+//# sourceMappingURL=archive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/commands/archive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAUH,OAAO,EACL,aAAa,EASd,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAkOnF"}