specdo 1.0.2

package/dist/core/apply-brief-renderer.js

@@ -0,0 +1,242 @@
+/**
+ * apply-brief-renderer — apply-brief.md 渲染器
+ *
+ * 渲染顺序遵循 phases/03-phase2-commands.md §`apply-brief.md 内容模板`：
+ *
+ *   1. 标题 + 进度（completed/total）
+ *   2. 当前任务（基于 tasks.md 第一个未完成任务）
+ *   3. Domain Focus（聚合所有命中领域的 implement.focusAreas）
+ *   4. Execution Discipline (TDD)
+ *      - 默认：3 步红绿重构
+ *      - 若 quality protocol 命中：替换为 review-to-solid 顺序工作流
+ *   5. Verification Gates（test/lint/manual）
+ *   6. Guardrails（领域 antiPatterns）
+ *   7. Evidence 提示
+ *
+ * 设计要点：
+ *   - 命令层负责选择哪些 domain / protocol 注入；本模块仅做无状态渲染
+ *   - 输出确定性：相同输入相同字符串（顺序、空行、分隔符）；测试必须可
+ *     断言完整字符串
+ *   - 完成态（all-done）展示祝贺 + 下一步指引（sync / archive）
+ */
+export function renderApplyBrief(input) {
+    const total = input.tasks.length;
+    const completed = input.tasks.filter((t) => t.completed).length;
+    const lines = [];
+    lines.push(`# Apply Brief: ${input.changeName}`);
+    lines.push('');
+    lines.push(`**Progress**: ${completed}/${total} tasks complete`);
+    lines.push('');
+    lines.push(`<!-- generatedAt: ${input.generatedAt} -->`);
+    lines.push('');
+    if (total === 0) {
+        lines.push('> No tasks defined yet. Edit tasks.md to add `- [ ] 1.1 <title>` entries.');
+        lines.push('');
+        return lines.join('\n');
+    }
+    if (completed === total) {
+        lines.push('## ✅ All tasks complete');
+        lines.push('');
+        lines.push('Run the following to finalize:');
+        lines.push('');
+        lines.push('```');
+        lines.push(`specdo sync --change ${input.changeName}`);
+        lines.push(`specdo archive --change ${input.changeName}`);
+        lines.push('```');
+        lines.push('');
+        return lines.join('\n');
+    }
+    const currentNumber = input.currentTaskNumber ?? input.tasks.find((t) => !t.completed)?.number ?? null;
+    const currentTask = currentNumber !== null ? input.tasks.find((t) => t.number === currentNumber) : null;
+    lines.push(`## Current Task: ${currentTask ? `${currentTask.number} ${currentTask.title}` : '(none selected)'}`);
+    lines.push('');
+    // ─── Domain Focus ───
+    lines.push('### Domain Focus');
+    lines.push('');
+    const focusAreas = aggregateFocusAreas(input.domains);
+    if (focusAreas.length === 0) {
+        lines.push('_No focus areas injected from domains._');
+    }
+    else {
+        for (const item of focusAreas) {
+            lines.push(`- ${item}`);
+        }
+    }
+    lines.push('');
+    // ─── Patterns ───
+    lines.push('### Patterns');
+    lines.push('');
+    const patterns = aggregatePatterns(input.domains);
+    if (patterns.length === 0) {
+        lines.push('_No patterns injected from domains._');
+    }
+    else {
+        for (const item of patterns) {
+            lines.push(`- **${item.name}** (${item.domain}): ${item.description}`);
+        }
+    }
+    lines.push('');
+    // ─── Execution Discipline ───
+    lines.push('### Execution Discipline');
+    lines.push('');
+    if (input.protocol) {
+        lines.push(`> Driven by protocol: **${input.protocol.name}** — ${input.protocol.goal}`);
+        lines.push('');
+        for (const step of input.protocol.workflow) {
+            lines.push(`${step.step}. **${step.title}** — ${step.goal}`);
+            for (const action of step.actions) {
+                lines.push(`   - ${action}`);
+            }
+            if (step.exitCriteria && step.exitCriteria.length > 0) {
+                lines.push(`   - _Exit when_: ${step.exitCriteria.join('; ')}`);
+            }
+            if (step.loopBackTo && step.loopBackTo.length > 0) {
+                lines.push(`   - _Loop back to_: ${step.loopBackTo.join(', ')} until convergence`);
+            }
+        }
+        appendProtocolContract(lines, input.protocol);
+    }
+    else {
+        lines.push('1. [ ] **Write failing test** — confirm it fails for the right reason');
+        lines.push('2. [ ] **Minimal implementation** — make the test pass');
+        lines.push('3. [ ] **Refactor** — improve design while keeping tests green');
+    }
+    lines.push('');
+    // ─── Verification Gates ───
+    lines.push('### Verification Gates');
+    lines.push('');
+    lines.push('- [ ] `pnpm test` passes (or workspace equivalent)');
+    lines.push('- [ ] `pnpm lint` passes');
+    const verifyItems = aggregateVerifyChecklist(input.domains);
+    for (const item of verifyItems) {
+        lines.push(`- [ ] ${item}`);
+    }
+    lines.push('');
+    // ─── Guardrails ───
+    lines.push('### Guardrails');
+    lines.push('');
+    const guardrails = aggregateAntiPatterns(input.domains);
+    if (input.protocol?.prohibitions && input.protocol.prohibitions.length > 0) {
+        for (const item of input.protocol.prohibitions) {
+            guardrails.push(`(${input.protocol.name}) ${item}`);
+        }
+    }
+    if (guardrails.length === 0) {
+        lines.push('_No guardrails injected from domains or protocols._');
+    }
+    else {
+        for (const item of guardrails) {
+            lines.push(`- ⚠️ ${item}`);
+        }
+    }
+    lines.push('');
+    // ─── Evidence reminder ───
+    lines.push('### Evidence');
+    lines.push('');
+    if (currentTask) {
+        lines.push('To mark this task complete:');
+        lines.push('');
+        lines.push('```');
+        lines.push(`specdo apply --change ${input.changeName} --done ${currentTask.number} --evidence "<test output / lint result / manual check>"`);
+        lines.push('```');
+    }
+    else {
+        lines.push('Use `specdo apply --done N --evidence "<...>"` for each task.');
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+// ─── helpers ────────────────────────────────────────────────────
+function aggregateFocusAreas(domains) {
+    const out = [];
+    const seen = new Set();
+    for (const domain of domains) {
+        for (const item of domain.implement?.focusAreas ?? []) {
+            if (seen.has(item))
+                continue;
+            seen.add(item);
+            out.push(`(${domain.name}) ${item}`);
+        }
+    }
+    return out;
+}
+function aggregateVerifyChecklist(domains) {
+    const out = [];
+    const seen = new Set();
+    for (const domain of domains) {
+        for (const item of domain.verify?.checklist ?? []) {
+            if (seen.has(item))
+                continue;
+            seen.add(item);
+            out.push(`(${domain.name}) ${item}`);
+        }
+    }
+    return out;
+}
+function aggregateAntiPatterns(domains) {
+    const out = [];
+    const seen = new Set();
+    for (const domain of domains) {
+        const all = [...(domain.design?.antiPatterns ?? []), ...(domain.implement?.antiPatterns ?? [])];
+        for (const item of all) {
+            if (seen.has(item))
+                continue;
+            seen.add(item);
+            out.push(`(${domain.name}) ${item}`);
+        }
+    }
+    return out;
+}
+function aggregatePatterns(domains) {
+    const out = [];
+    const seen = new Set();
+    for (const domain of domains) {
+        const patterns = domain.implement?.patterns;
+        if (!patterns)
+            continue;
+        for (const [name, description] of Object.entries(patterns)) {
+            if (seen.has(name))
+                continue;
+            seen.add(name);
+            out.push({ name, domain: domain.name, description });
+        }
+    }
+    return out;
+}
+function appendProtocolContract(lines, protocol) {
+    if (protocol.severityLevels && Object.keys(protocol.severityLevels).length > 0) {
+        lines.push('');
+        lines.push('#### Protocol Severity Levels');
+        for (const [level, description] of Object.entries(protocol.severityLevels)) {
+            lines.push(`- **${level}**: ${description}`);
+        }
+    }
+    if (protocol.stopConditions.length > 0) {
+        lines.push('');
+        lines.push('#### Protocol Stop Conditions');
+        for (const condition of protocol.stopConditions) {
+            lines.push(`- ${condition}`);
+        }
+    }
+    if (protocol.outputContract.length > 0) {
+        lines.push('');
+        lines.push('#### Protocol Output Contract');
+        for (const section of protocol.outputContract) {
+            const required = section.required ? 'required' : 'conditional';
+            lines.push(`- **${section.name}** (${required}, ${section.format}): ${section.description}`);
+        }
+    }
+    if (protocol.generalConstraints && protocol.generalConstraints.length > 0) {
+        lines.push('');
+        lines.push('#### Protocol General Constraints');
+        for (const constraint of protocol.generalConstraints) {
+            lines.push(`- ${constraint}`);
+        }
+    }
+    if (protocol.artifactChecklists && Object.keys(protocol.artifactChecklists).length > 0) {
+        lines.push('');
+        lines.push('#### Protocol Artifact Checklists Available');
+        lines.push(`- ${Object.keys(protocol.artifactChecklists).join(', ')}`);
+    }
+}
+//# sourceMappingURL=apply-brief-renderer.js.map

package/dist/core/apply-brief-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-brief-renderer.js","sourceRoot":"","sources":["../../src/core/apply-brief-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAgBH,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;IACjC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;IAChE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,kBAAkB,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,iBAAiB,SAAS,IAAI,KAAK,iBAAiB,CAAC,CAAC;IACjE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,qBAAqB,KAAK,CAAC,WAAW,MAAM,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;QACxF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,wBAAwB,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,2BAA2B,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,aAAa,GAAG,KAAK,CAAC,iBAAiB,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,MAAM,IAAI,IAAI,CAAC;IACvG,MAAM,WAAW,GAAG,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAExG,KAAK,CAAC,IAAI,CAAC,oBAAoB,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACjH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,uBAAuB;IACvB,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IACxD,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,mBAAmB;IACnB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACrD,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,+BAA+B;IAC/B,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,2BAA2B,KAAK,CAAC,QAAQ,CAAC,IAAI,QAAQ,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACxF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7D,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClC,KAAK,CAAC,IAAI,CAAC,QAAQ,MAAM,EAAE,CAAC,CAAC;YAC/B,CAAC;YACD,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtD,KAAK,CAAC,IAAI,CAAC,qBAAqB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClE,CAAC;YACD,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClD,KAAK,CAAC,IAAI,CAAC,wBAAwB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YACrF,CAAC;QACH,CAAC;QACD,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC;QACpF,KAAK,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IAC/E,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,6BAA6B;IAC7B,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;IACjE,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,wBAAwB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5D,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAC9B,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,qBAAqB;IACrB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,MAAM,UAAU,GAAG,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,KAAK,CAAC,QAAQ,EAAE,YAAY,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3E,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;YAC/C,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;IACpE,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,4BAA4B;IAC5B,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CACR,yBAAyB,KAAK,CAAC,UAAU,WAAW,WAAW,CAAC,MAAM,0DAA0D,CACjI,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IAC9E,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,mEAAmE;AAEnE,SAAS,mBAAmB,CAAC,OAAuB;IAClD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,SAAS,EAAE,UAAU,IAAI,EAAE,EAAE,CAAC;YACtD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,wBAAwB,CAAC,OAAuB;IACvD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,EAAE,CAAC;YAClD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAuB;IACpD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;QAChG,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;YACvB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAuB;IAChD,MAAM,GAAG,GAA4D,EAAE,CAAC;IACxE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC;QAC5C,IAAI,CAAC,QAAQ;YAAE,SAAS;QACxB,KAAK,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3D,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAe,EAAE,QAAkB;IACjE,IAAI,QAAQ,CAAC,cAAc,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC5C,KAAK,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;YAC3E,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,OAAO,WAAW,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC5C,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC5C,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;YAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC;YAC/D,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,IAAI,OAAO,QAAQ,KAAK,OAAO,CAAC,MAAM,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,kBAAkB,IAAI,QAAQ,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAChD,KAAK,MAAM,UAAU,IAAI,QAAQ,CAAC,kBAAkB,EAAE,CAAC;YACrD,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,kBAAkB,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;AACH,CAAC"}

package/dist/core/config-store.d.ts

@@ -0,0 +1,190 @@
+/**
+ * ConfigStore — `specdo/config.yaml` 唯一读写入口
+ *
+ * 设计要点（与 phases/03-phase2-commands.md §`config.overrides 最低契约` 完全对齐）：
+ *
+ *   1. **Schema 定义**：使用 Zod 描述当前 config 顶层结构与 overrides 树
+ *   2. **`enabled: false`**：禁用指定 stage（不是删整个 domain），renderer 跳过注入
+ *   3. **override action 三选一**：同一 item 必须且只能包含 prepend / append / replace 之一
+ *   4. **未知 domain / stage / field**：必须由 validate 报错（friendly path）
+ *   5. **优先级**：内置 domain → config.overrides 深合并；CLI 参数不得临时改写 domain
+ *
+ * 模块只读，写入由 init 命令处理。
+ */
+import { z } from 'zod';
+import type { DomainModule } from '../domains/types.js';
+declare const stageOverridesSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    questions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        prepend: z.ZodOptional<z.ZodString>;
+        append: z.ZodOptional<z.ZodString>;
+        replace: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    checklist: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        prepend: z.ZodOptional<z.ZodString>;
+        append: z.ZodOptional<z.ZodString>;
+        replace: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    focusAreas: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        prepend: z.ZodOptional<z.ZodString>;
+        append: z.ZodOptional<z.ZodString>;
+        replace: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    antiPatterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        prepend: z.ZodOptional<z.ZodString>;
+        append: z.ZodOptional<z.ZodString>;
+        replace: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    patterns: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>;
+declare const configSchema: z.ZodObject<{
+    domainVersion: z.ZodString;
+    overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        explore: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            questions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                prepend: z.ZodOptional<z.ZodString>;
+                append: z.ZodOptional<z.ZodString>;
+                replace: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            checklist: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                prepend: z.ZodOptional<z.ZodString>;
+                append: z.ZodOptional<z.ZodString>;
+                replace: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            focusAreas: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                prepend: z.ZodOptional<z.ZodString>;
+                append: z.ZodOptional<z.ZodString>;
+                replace: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            antiPatterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                prepend: z.ZodOptional<z.ZodString>;
+                append: z.ZodOptional<z.ZodString>;
+                replace: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            patterns: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>>;
+        design: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            questions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                prepend: z.ZodOptional<z.ZodString>;
+                append: z.ZodOptional<z.ZodString>;
+                replace: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            checklist: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                prepend: z.ZodOptional<z.ZodString>;
+                append: z.ZodOptional<z.ZodString>;
+                replace: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            focusAreas: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                prepend: z.ZodOptional<z.ZodString>;
+                append: z.ZodOptional<z.ZodString>;
+                replace: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            antiPatterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                prepend: z.ZodOptional<z.ZodString>;
+                append: z.ZodOptional<z.ZodString>;
+                replace: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            patterns: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>>;
+        implement: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            questions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                prepend: z.ZodOptional<z.ZodString>;
+                append: z.ZodOptional<z.ZodString>;
+                replace: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            checklist: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                prepend: z.ZodOptional<z.ZodString>;
+                append: z.ZodOptional<z.ZodString>;
+                replace: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            focusAreas: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                prepend: z.ZodOptional<z.ZodString>;
+                append: z.ZodOptional<z.ZodString>;
+                replace: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            antiPatterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                prepend: z.ZodOptional<z.ZodString>;
+                append: z.ZodOptional<z.ZodString>;
+                replace: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            patterns: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>>;
+        verify: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            questions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                prepend: z.ZodOptional<z.ZodString>;
+                append: z.ZodOptional<z.ZodString>;
+                replace: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            checklist: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                prepend: z.ZodOptional<z.ZodString>;
+                append: z.ZodOptional<z.ZodString>;
+                replace: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            focusAreas: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                prepend: z.ZodOptional<z.ZodString>;
+                append: z.ZodOptional<z.ZodString>;
+                replace: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            antiPatterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                prepend: z.ZodOptional<z.ZodString>;
+                append: z.ZodOptional<z.ZodString>;
+                replace: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            patterns: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type SpecdoConfig = z.infer<typeof configSchema>;
+export type StageOverridesParsed = z.infer<typeof stageOverridesSchema>;
+export interface ConfigIssue {
+    /** human-readable JSON path, e.g. `overrides.security.design.checklist[0]` */
+    path: string;
+    message: string;
+}
+export interface ConfigLoadResult {
+    /** 原始 YAML 解析结果（用于 doctor 等需要查看原文的命令） */
+    raw: unknown;
+    /** 校验通过的 typed config；schema 错误时为 null */
+    config: SpecdoConfig | null;
+    /** 校验问题列表；为空表示 config 完全合法 */
+    issues: ConfigIssue[];
+}
+export interface ResolvedDomain {
+    /** override 应用后的 DomainModule */
+    domain: DomainModule;
+    /** 是否有任意 stage 被 enabled=false 禁用 */
+    hasDisabledStages: boolean;
+    /** 各 stage 的 override 统计 */
+    overrideCounts: {
+        stage: 'explore' | 'design' | 'implement' | 'verify';
+        appended: number;
+        prepended: number;
+        replaced: number;
+        patternsAdded: number;
+        enabled: boolean;
+    }[];
+}
+/**
+ * 加载并校验 specdo/config.yaml。
+ *
+ * - 文件不存在 → issues=[NOT_FOUND]，config=null
+ * - YAML parse 失败 → issues=[YAML]，config=null
+ * - Zod schema 失败 → issues=[zod paths]，config=null
+ * - 未知 domain / stage / field → 由 strict() + 自定义校验产出 friendly path
+ */
+export declare function loadConfig(cwd: string): ConfigLoadResult;
+/**
+ * 应用项目级 overrides，返回所有可用领域（按 ALL_DOMAINS 顺序），含统计信息。
+ *
+ * 即使有 issues 也尽量产出可用 ResolvedDomain（issues 由调用方 validate 报告）。
+ */
+export declare function resolveDomains(config: SpecdoConfig | null | undefined): ResolvedDomain[];
+export declare function getResolvedDomain(config: SpecdoConfig | null | undefined, name: string): ResolvedDomain | undefined;
+/** locate specdo/config.{yaml,yml}; null if neither exists */
+export declare function locateConfigPath(cwd: string): string | null;
+export {};
+//# sourceMappingURL=config-store.d.ts.map

package/dist/core/config-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.d.ts","sourceRoot":"","sources":["../../src/core/config-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,qBAAqB,CAAC;AAsBvF,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;kBA2Bf,CAAC;AAWZ,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAKP,CAAC;AAEZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACxD,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIxE,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,GAAG,EAAE,OAAO,CAAC;IACb,0CAA0C;IAC1C,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,8BAA8B;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,MAAM,EAAE,YAAY,CAAC;IACrB,qCAAqC;IACrC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,4BAA4B;IAC5B,cAAc,EAAE;QACd,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;QACrD,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,OAAO,CAAC;KAClB,EAAE,CAAC;CACL;AAKD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAmDxD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,GAAG,cAAc,EAAE,CA2CxF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAGnH;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM3D"}