specdo 1.0.2

package/dist/core/task-parser.js

@@ -0,0 +1,244 @@
+/**
+ * task-parser — tasks.md 唯一事实来源解析器
+ *
+ * 输入：tasks.md 全文文本
+ * 输出：结构化 ParsedTasks { tasks, warnings }
+ *
+ * 解析规则（与 phases/03-phase2-commands.md §task-parser 完全对齐）：
+ *
+ *   1. 仅识别零缩进的顶层 checkbox：`- [ ] N. <title>`、`- [ ] N.M <title>` 或 `- [x] ...`
+ *      （大小写 x 均视为已完成）
+ *   2. 编号必须是正整数路径（如 `1`、`2`、`1.1`、`2.3`），编号后空格分隔
+ *   3. 缩进 checkbox（子任务）忽略
+ *   4. 三反引号代码块内任何内容忽略
+ *   5. 无编号 checkbox `- [ ] Title` 加 warning 并跳过
+ *   6. 重复编号 → throw（exit code 1）
+ *   7. 编号缺口（1,2,4 缺 3）→ warning 但允许
+ *   8. 编号不从 1 开始 → warning 但允许
+ *   9. evidence：紧随任务行下方、缩进对齐的 `Evidence:` 行（含跨行延续）
+ *
+ * 该模块**只读**，不写回 tasks.md；写回由 commands/apply.ts 负责。
+ */
+const TOP_LEVEL_CHECKBOX_RE = /^- \[(?<mark>[ xX])\]\s+(?<rest>.+)$/;
+const UNNUMBERED_HINT_RE = /^- \[[ xX]\]\s+/;
+const NON_CANONICAL_NUMBERED_HINT_RE = /^(?<candidate>\d+(?:\.\d+)*)(?:\.)?\s+/;
+const EVIDENCE_RE = /^(?<indent>\s+)Evidence:\s*(?<text>.*)$/;
+const FENCE_RE = /^\s*```/;
+const ROOT_TASK_RE = /^(?<num>[1-9]\d*)\.\s+(?<title>.+)$/;
+const GROUPED_TASK_RE = /^(?<num>[1-9]\d*\.[1-9]\d*)\s+(?<title>.+)$/;
+export function isCanonicalTaskReference(value) {
+    return /^(?:[1-9]\d*)(?:\.[1-9]\d*)?$/.test(value);
+}
+export function parseTasks(content) {
+    const lines = content.split(/\r?\n/);
+    const tasks = [];
+    const warnings = [];
+    const seen = new Set();
+    let inFence = false;
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i] ?? '';
+        if (FENCE_RE.test(line)) {
+            inFence = !inFence;
+            i++;
+            continue;
+        }
+        if (inFence) {
+            i++;
+            continue;
+        }
+        const checkboxMatch = TOP_LEVEL_CHECKBOX_RE.exec(line);
+        if (!checkboxMatch || checkboxMatch.groups === undefined) {
+            i++;
+            continue;
+        }
+        const restRaw = checkboxMatch.groups.rest ?? '';
+        const completed = (checkboxMatch.groups.mark ?? ' ').toLowerCase() === 'x';
+        const numberedMatch = parseTaskHeader(restRaw);
+        if (!numberedMatch || numberedMatch.groups === undefined) {
+            const nonCanonicalMatch = NON_CANONICAL_NUMBERED_HINT_RE.exec(restRaw);
+            if (nonCanonicalMatch?.groups?.candidate) {
+                warnings.push(`Line ${i + 1}: non-canonical task reference skipped (${nonCanonicalMatch.groups.candidate}); use "1" or "1.1" style numbering`);
+            }
+            else if (UNNUMBERED_HINT_RE.test(line)) {
+                // 无编号 checkbox：跳过并 warn
+                warnings.push(`Line ${i + 1}: unnumbered checkbox skipped (only "- [ ] N. <title>" is recognized)`);
+            }
+            i++;
+            continue;
+        }
+        const number = numberedMatch.groups.num ?? '0';
+        const title = (numberedMatch.groups.title ?? '').trim();
+        if (seen.has(number)) {
+            throw new Error(`Duplicate task number ${number} in tasks.md`);
+        }
+        seen.add(number);
+        const taskLineIndex = i;
+        let evidence = null;
+        let evidenceLineIndex = null;
+        let j = i + 1;
+        const immediateNext = lines[j] ?? '';
+        const evidenceMatch = EVIDENCE_RE.exec(immediateNext);
+        if (evidenceMatch?.groups) {
+            evidence = (evidenceMatch.groups.text ?? '').trim();
+            evidenceLineIndex = j;
+            const evidenceIndent = evidenceMatch.groups.indent?.length ?? 0;
+            let k = j + 1;
+            while (k < lines.length) {
+                const cont = lines[k] ?? '';
+                if (TOP_LEVEL_CHECKBOX_RE.test(cont))
+                    break;
+                if (FENCE_RE.test(cont))
+                    break;
+                if (cont.trim().length === 0)
+                    break;
+                const contIndent = leadingWhitespaceWidth(cont);
+                if (contIndent <= evidenceIndent)
+                    break;
+                evidence = `${evidence ?? ''}\n${cont.trim()}`.trim();
+                k++;
+            }
+            j = k;
+        }
+        tasks.push({ number, title, completed, lineIndex: taskLineIndex, evidence, evidenceLineIndex });
+        i = j > i ? j : i + 1;
+    }
+    // 编号合规性 warning
+    if (tasks.length > 0) {
+        const sorted = [...tasks].sort((a, b) => compareTaskNumberParts(parseTaskNumber(a.number), parseTaskNumber(b.number)));
+        warnings.push(...buildNumberingWarnings(sorted.map((task) => task.number)));
+    }
+    return { tasks, warnings };
+}
+/** 判断给定 N 是否为合法任务编号（用于 --done/--undo 越界检查） */
+export function findTaskByNumber(parsed, n) {
+    return parsed.tasks.find((t) => t.number === n);
+}
+/**
+ * 将一个任务在原文件中标记为 完成 / 未完成，并同步写入或删除 evidence。
+ *
+ * 返回新内容字符串；调用方负责写盘。
+ *
+ * 行为：
+ *   - completed = true 且提供 evidence：勾选 [x] 并在任务行下插入 `  Evidence: ...`
+ *   - completed = false：取消勾选 [x] 改回 [ ]，并删除已存在的 evidence 行
+ *   - 修改时尽量保留原文件其他行（缩进、空行、注释）不变
+ */
+export function applyTaskMutation(content, task, next) {
+    const lines = content.split(/\r?\n/);
+    const lineEnding = content.includes('\r\n') ? '\r\n' : '\n';
+    // 1. 改写 checkbox
+    const original = lines[task.lineIndex] ?? '';
+    const updated = next.completed
+        ? original.replace(/^- \[[ xX]\]/, '- [x]')
+        : original.replace(/^- \[[ xX]\]/, '- [ ]');
+    lines[task.lineIndex] = updated;
+    // 2. 删除已有 evidence（如有）
+    if (task.evidenceLineIndex !== null) {
+        const removeStart = task.evidenceLineIndex;
+        const evidenceLine = lines[removeStart] ?? '';
+        const evidenceIndent = leadingWhitespaceWidth(evidenceLine);
+        let removeEnd = removeStart + 1;
+        while (removeEnd < lines.length) {
+            const cand = lines[removeEnd] ?? '';
+            if (TOP_LEVEL_CHECKBOX_RE.test(cand))
+                break;
+            if (FENCE_RE.test(cand))
+                break;
+            if (cand.trim().length === 0)
+                break;
+            if (leadingWhitespaceWidth(cand) <= evidenceIndent)
+                break;
+            removeEnd++;
+        }
+        lines.splice(removeStart, removeEnd - removeStart);
+    }
+    // 3. 写入新 evidence（仅当 completed 且 evidence 非空）
+    if (next.completed && next.evidence !== undefined && next.evidence !== null && next.evidence.trim().length > 0) {
+        const evidenceLines = next.evidence
+            .split(/\r?\n/)
+            .map((seg, idx) => (idx === 0 ? `  Evidence: ${seg}` : `    ${seg}`));
+        const insertAt = task.lineIndex + 1;
+        lines.splice(insertAt, 0, ...evidenceLines);
+    }
+    return lines.join(lineEnding);
+}
+function leadingWhitespaceWidth(line) {
+    const match = /^\s*/.exec(line);
+    return match?.[0].length ?? 0;
+}
+function buildNumberingWarnings(numbers) {
+    if (numbers.length === 0)
+        return [];
+    const warnings = [];
+    const parsed = [...numbers]
+        .map((value) => ({ value, parts: parseTaskNumber(value) }))
+        .sort((a, b) => compareTaskNumberParts(a.parts, b.parts));
+    const hasGrouped = parsed.some((entry) => entry.parts.length > 1);
+    if (!hasGrouped) {
+        const ints = parsed.map((entry) => entry.parts[0] ?? 0);
+        if ((ints[0] ?? 0) !== 1) {
+            warnings.push(`Task numbering does not start at 1 (first number = ${parsed[0]?.value ?? 'n/a'})`);
+        }
+        for (let index = 0; index < ints.length - 1; index++) {
+            const cur = ints[index] ?? 0;
+            const nxt = ints[index + 1] ?? 0;
+            if (nxt - cur > 1) {
+                warnings.push(`Task numbering has a gap between ${cur} and ${nxt}`);
+            }
+        }
+        return warnings;
+    }
+    const roots = [...new Set(parsed.map((entry) => entry.parts[0] ?? 0))].sort((a, b) => a - b);
+    if ((roots[0] ?? 0) !== 1) {
+        warnings.push(`Task numbering does not start at 1 (first group = ${roots[0] ?? 'n/a'})`);
+    }
+    for (let index = 0; index < roots.length - 1; index++) {
+        const cur = roots[index] ?? 0;
+        const nxt = roots[index + 1] ?? 0;
+        if (nxt - cur > 1) {
+            warnings.push(`Task group numbering has a gap between ${cur} and ${nxt}`);
+        }
+    }
+    const childrenByRoot = new Map();
+    for (const entry of parsed) {
+        if (entry.parts.length < 2)
+            continue;
+        const root = entry.parts[0] ?? 0;
+        const child = entry.parts[1] ?? 0;
+        const current = childrenByRoot.get(root) ?? [];
+        current.push(child);
+        childrenByRoot.set(root, current);
+    }
+    for (const [root, childNumbers] of childrenByRoot.entries()) {
+        const sortedChildren = [...new Set(childNumbers)].sort((a, b) => a - b);
+        if ((sortedChildren[0] ?? 0) !== 1) {
+            warnings.push(`Task numbering inside group ${root} does not start at 1 (first task = ${root}.${sortedChildren[0] ?? 'n/a'})`);
+        }
+        for (let index = 0; index < sortedChildren.length - 1; index++) {
+            const cur = sortedChildren[index] ?? 0;
+            const nxt = sortedChildren[index + 1] ?? 0;
+            if (nxt - cur > 1) {
+                warnings.push(`Task numbering has a gap between ${root}.${cur} and ${root}.${nxt}`);
+            }
+        }
+    }
+    return warnings;
+}
+function parseTaskNumber(value) {
+    return value.split('.').map((part) => Number.parseInt(part, 10));
+}
+function compareTaskNumberParts(left, right) {
+    const max = Math.max(left.length, right.length);
+    for (let index = 0; index < max; index++) {
+        const l = left[index] ?? 0;
+        const r = right[index] ?? 0;
+        if (l !== r)
+            return l - r;
+    }
+    return 0;
+}
+function parseTaskHeader(rest) {
+    return GROUPED_TASK_RE.exec(rest) ?? ROOT_TASK_RE.exec(rest);
+}
+//# sourceMappingURL=task-parser.js.map

package/dist/core/task-parser.js.map

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

package/dist/core/template-renderer.d.ts

@@ -0,0 +1,51 @@
+/**
+ * template-renderer — propose 阶段 4 个 artifact 模板生成
+ *
+ * 当前版本对齐 OpenSpec core artifact 语义：
+ *   - proposal.md: Why / What Changes / Capabilities / Impact
+ *   - design.md: Context / Goals / Non-Goals / Decisions / Risks / Trade-offs
+ *   - tasks.md: grouped task sections + execution-ready task refs (1.1 / 1.2)
+ *   - specs/<capability>/spec.md: ADDED Requirements / Requirement / Scenario
+ *
+ * SpecDo 的增强内容仍然存在，但只能注入到这些标准骨架内。
+ */
+import type { DomainModule } from '../domains/types.js';
+export interface ProposedCapability {
+    name: string;
+    kind: 'new' | 'modified';
+    summary: string;
+    rationale?: string;
+    domains: string[];
+}
+export interface RenderInput {
+    changeName: string;
+    idea: string;
+    domains: DomainModule[];
+    answers: Record<string, string>;
+    flaggedConcerns: string[];
+    generatedAt: string;
+    capabilities: ProposedCapability[];
+}
+export interface RenderedArtifacts {
+    proposal: string;
+    specs: {
+        relativePath: string;
+        content: string;
+    }[];
+    design: string;
+    tasks: string;
+}
+export declare function renderArtifacts(input: RenderInput): RenderedArtifacts;
+export declare function renderProposal(input: RenderInput): string;
+export declare function renderSpecs(input: RenderInput): {
+    relativePath: string;
+    content: string;
+}[];
+export declare function renderDesign(input: RenderInput): string;
+export declare function renderTasks(input: RenderInput): string;
+export declare function inferCapabilitiesFromChange(input: {
+    changeName: string;
+    idea: string;
+    domains: DomainModule[];
+}): ProposedCapability[];
+//# sourceMappingURL=template-renderer.d.ts.map

package/dist/core/template-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-renderer.d.ts","sourceRoot":"","sources":["../../src/core/template-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,GAAG,UAAU,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,kBAAkB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAOrE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAsDzD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CA+B3F;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CA+DvD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAsBtD;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB,GAAG,kBAAkB,EAAE,CAcvB"}

package/dist/core/template-renderer.js

@@ -0,0 +1,362 @@
+/**
+ * template-renderer — propose 阶段 4 个 artifact 模板生成
+ *
+ * 当前版本对齐 OpenSpec core artifact 语义：
+ *   - proposal.md: Why / What Changes / Capabilities / Impact
+ *   - design.md: Context / Goals / Non-Goals / Decisions / Risks / Trade-offs
+ *   - tasks.md: grouped task sections + execution-ready task refs (1.1 / 1.2)
+ *   - specs/<capability>/spec.md: ADDED Requirements / Requirement / Scenario
+ *
+ * SpecDo 的增强内容仍然存在，但只能注入到这些标准骨架内。
+ */
+export function renderArtifacts(input) {
+    return {
+        proposal: renderProposal(input),
+        specs: renderSpecs(input),
+        design: renderDesign(input),
+        tasks: renderTasks(input),
+    };
+}
+export function renderProposal(input) {
+    const lines = [];
+    lines.push(`# Proposal: ${input.changeName}`);
+    lines.push('');
+    lines.push(frontmatter(input, 'proposal'));
+    lines.push('');
+    lines.push('## Why');
+    lines.push('');
+    if (input.idea.trim().length > 0) {
+        lines.push(`- This change starts from the explored request: ${input.idea}`);
+    }
+    else {
+        lines.push('- <!-- Describe the user-visible or business motivation for this change. -->');
+    }
+    if (input.flaggedConcerns.length > 0) {
+        lines.push(`- Resolve the currently known concern(s): ${input.flaggedConcerns.join('; ')}`);
+    }
+    else {
+        lines.push('- <!-- Explain why the change is needed now and what problem it solves. -->');
+    }
+    lines.push('');
+    lines.push('## What Changes');
+    lines.push('');
+    for (const capability of input.capabilities) {
+        lines.push(`- ${capitalize(capability.kind)} capability \`${capability.name}\`: ${capability.summary}`);
+    }
+    lines.push('');
+    lines.push('## Capabilities');
+    lines.push('');
+    const newCapabilities = input.capabilities.filter((capability) => capability.kind === 'new');
+    const modifiedCapabilities = input.capabilities.filter((capability) => capability.kind === 'modified');
+    lines.push('### New Capabilities');
+    lines.push(...renderCapabilitiesSection(newCapabilities, 'new'));
+    lines.push('');
+    lines.push('### Modified Capabilities');
+    lines.push(...renderCapabilitiesSection(modifiedCapabilities, 'modified'));
+    lines.push('');
+    lines.push('## Impact');
+    lines.push('');
+    lines.push(`- Affected artifacts: ${input.capabilities.map((capability) => `specs/${capability.name}/spec.md`).join(', ')}`);
+    lines.push(`- Matched domains: ${input.domains.length > 0 ? input.domains.map((domain) => domain.name).join(', ') : '(none)'}`);
+    if (input.flaggedConcerns.length > 0) {
+        for (const concern of input.flaggedConcerns) {
+            lines.push(`- Risk to resolve: ${concern}`);
+        }
+    }
+    if (Object.keys(input.answers).length > 0) {
+        lines.push('- Explore answers that constrain implementation:');
+        for (const [key, value] of Object.entries(input.answers)) {
+            lines.push(`  - ${key}: ${value || '_(empty)_'}`);
+        }
+    }
+    else {
+        lines.push('- <!-- Record affected systems, APIs, data, rollout, or user-surface impact. -->');
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+export function renderSpecs(input) {
+    return input.capabilities.map((capability) => {
+        const lines = [];
+        lines.push(`# Delta for ${capability.name}`);
+        lines.push('');
+        lines.push(frontmatter(input, 'spec', capability.name));
+        lines.push('');
+        lines.push(capability.kind === 'modified' ? '## MODIFIED Requirements' : '## ADDED Requirements');
+        lines.push('');
+        lines.push(`### Requirement: ${requirementTitleFromCapability(capability)}`);
+        lines.push(`The system SHALL ${capability.summary.toLowerCase()}.`);
+        lines.push('');
+        lines.push(`#### Scenario: ${scenarioTitleFromCapability(capability)}`);
+        lines.push('- **WHEN** the relevant user or system flow reaches this capability');
+        lines.push('- **THEN** the expected behavior SHALL match the approved proposal and design');
+        if (capability.rationale) {
+            lines.push(`- **AND** the implementation SHALL respect this rationale: ${capability.rationale}`);
+        }
+        const verifyItems = collectCapabilityVerificationItems(input.domains, capability.domains);
+        if (verifyItems.length > 0) {
+            lines.push('- **AND** the following verification concerns SHALL be covered:');
+            for (const item of verifyItems.slice(0, 4)) {
+                lines.push(`  - ${item}`);
+            }
+        }
+        lines.push('');
+        return {
+            relativePath: `specs/${capability.name}/spec.md`,
+            content: lines.join('\n'),
+        };
+    });
+}
+export function renderDesign(input) {
+    const lines = [];
+    lines.push(`# Design: ${input.changeName}`);
+    lines.push('');
+    lines.push(frontmatter(input, 'design'));
+    lines.push('');
+    lines.push('## Context');
+    lines.push('');
+    if (input.idea.trim().length > 0) {
+        lines.push(`- Explored change request: ${input.idea}`);
+    }
+    lines.push(`- Capability scope: ${input.capabilities.map((capability) => capability.name).join(', ')}`);
+    lines.push(`- Domain context: ${input.domains.length > 0 ? input.domains.map((domain) => domain.name).join(', ') : '(none)'}`);
+    if (Object.keys(input.answers).length > 0) {
+        lines.push('- Known design constraints from explore answers:');
+        for (const [key, value] of Object.entries(input.answers)) {
+            lines.push(`  - ${key}: ${value || '_(empty)_'}`);
+        }
+    }
+    else {
+        lines.push('- <!-- Capture existing system shape, constraints, and relevant baseline behavior. -->');
+    }
+    lines.push('');
+    lines.push('## Goals / Non-Goals');
+    lines.push('');
+    lines.push('**Goals:**');
+    lines.push(...input.capabilities.map((capability) => `- Deliver capability \`${capability.name}\` with clear requirement coverage.`));
+    lines.push('');
+    lines.push('**Non-Goals:**');
+    lines.push('- <!-- Record what this change intentionally does not solve. -->');
+    lines.push('');
+    lines.push('## Decisions');
+    lines.push('');
+    lines.push('### Capability Structure');
+    lines.push('');
+    for (const capability of input.capabilities) {
+        lines.push(`- \`${capability.name}\` is treated as a ${capability.kind} capability and renders to \`specs/${capability.name}/spec.md\`.`);
+    }
+    const decisionBlocks = collectDecisionBlocks(input.domains);
+    if (decisionBlocks.length > 0) {
+        for (const block of decisionBlocks) {
+            lines.push('');
+            lines.push(`### ${block.title}`);
+            lines.push('');
+            for (const item of block.items) {
+                lines.push(`- ${item}`);
+            }
+        }
+    }
+    else {
+        lines.push('- <!-- Document technical decisions, interfaces, data flow, and responsibilities. -->');
+    }
+    lines.push('');
+    lines.push('## Risks / Trade-offs');
+    lines.push('');
+    const risks = collectRiskItems(input.domains, input.flaggedConcerns);
+    if (risks.length > 0) {
+        for (const item of risks) {
+            lines.push(`- ${item}`);
+        }
+    }
+    else {
+        lines.push('- <!-- Capture open trade-offs, failure paths, rollout risks, and unknowns. -->');
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+export function renderTasks(input) {
+    const lines = [];
+    lines.push(`# Tasks: ${input.changeName}`);
+    lines.push('');
+    lines.push(frontmatter(input, 'tasks'));
+    lines.push('');
+    lines.push('> Task refs remain the execution contract for `specdo apply`.');
+    lines.push('> Use `specdo apply --change <name> --done 1.1 --evidence "..."` to complete a task.');
+    lines.push('');
+    const taskGroups = buildTaskGroups(input);
+    for (const [groupIndex, group] of taskGroups.entries()) {
+        const groupNumber = groupIndex + 1;
+        lines.push(`## ${groupNumber}. ${group.title}`);
+        lines.push('');
+        for (const [taskIndex, item] of group.items.entries()) {
+            lines.push(`- [ ] ${groupNumber}.${taskIndex + 1} ${item}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function inferCapabilitiesFromChange(input) {
+    const slug = slugify(input.changeName) || 'change';
+    const summary = input.idea.trim().length > 0
+        ? normalizeSentence(input.idea)
+        : `deliver ${slug.replace(/-/g, ' ')} behavior changes`;
+    return [
+        {
+            name: slug,
+            kind: 'new',
+            summary,
+            rationale: input.idea.trim().length > 0 ? `Derived from explored request: ${normalizeSentence(input.idea)}` : undefined,
+            domains: input.domains.map((domain) => domain.name),
+        },
+    ];
+}
+function renderCapabilitiesSection(capabilities, kind) {
+    if (capabilities.length === 0) {
+        return ['- _(none)_'];
+    }
+    return capabilities.flatMap((capability) => [
+        `- \`${capability.name}\`: ${capability.summary}`,
+        `  - spec path: \`specs/${capability.name}/spec.md\``,
+        `  - kind: ${kind}`,
+    ]);
+}
+function collectCapabilityVerificationItems(domains, selectedDomainNames) {
+    const selected = new Set(selectedDomainNames);
+    const out = [];
+    const seen = new Set();
+    for (const domain of domains) {
+        if (!selected.has(domain.name))
+            continue;
+        for (const item of domain.verify?.checklist ?? []) {
+            if (seen.has(item))
+                continue;
+            seen.add(item);
+            out.push(item);
+        }
+    }
+    return out;
+}
+function collectDecisionBlocks(domains) {
+    const blocks = [];
+    for (const domain of domains) {
+        const items = [];
+        for (const item of domain.design?.checklist ?? []) {
+            items.push(item);
+        }
+        for (const [name, description] of Object.entries(domain.design?.patterns ?? {})) {
+            items.push(`${name}: ${description}`);
+        }
+        if (items.length > 0) {
+            blocks.push({ title: `${displayName(domain)} Design`, items });
+        }
+    }
+    return blocks;
+}
+function collectRiskItems(domains, concerns) {
+    const out = [];
+    const seen = new Set();
+    for (const concern of concerns) {
+        if (seen.has(concern))
+            continue;
+        seen.add(concern);
+        out.push(concern);
+    }
+    for (const domain of domains) {
+        for (const item of domain.design?.antiPatterns ?? []) {
+            if (seen.has(item))
+                continue;
+            seen.add(item);
+            out.push(`(${domain.name}) ${item}`);
+        }
+        for (const item of domain.implement?.antiPatterns ?? []) {
+            if (seen.has(item))
+                continue;
+            seen.add(item);
+            out.push(`(${domain.name}) ${item}`);
+        }
+    }
+    return out;
+}
+function buildTaskGroups(input) {
+    const primaryCapability = input.capabilities[0];
+    const groups = [];
+    groups.push({
+        title: 'Spec Updates',
+        items: [
+            `Finalize requirement scenarios for ${primaryCapability?.name ?? input.changeName}`,
+            `Review proposal and design alignment for ${primaryCapability?.name ?? input.changeName}`,
+        ],
+    });
+    const implementationItems = collectImplementationItems(input.domains, primaryCapability?.name ?? input.changeName);
+    groups.push({
+        title: 'Implementation',
+        items: implementationItems.length > 0
+            ? implementationItems
+            : [`Implement the approved behavior for ${primaryCapability?.name ?? input.changeName}`],
+    });
+    const verificationItems = collectVerificationItems(input.domains, primaryCapability?.name ?? input.changeName);
+    groups.push({
+        title: 'Verification',
+        items: verificationItems.length > 0
+            ? verificationItems
+            : [`Verify the ${primaryCapability?.name ?? input.changeName} flow end to end`],
+    });
+    return groups;
+}
+function collectImplementationItems(domains, fallbackName) {
+    const out = [];
+    for (const domain of domains) {
+        for (const item of domain.implement?.focusAreas?.slice(0, 1) ?? []) {
+            out.push(`${capitalize(domain.name)}: ${item}`);
+        }
+    }
+    return out.slice(0, 3).length > 0 ? out.slice(0, 3) : [`Implement core logic for ${fallbackName}`];
+}
+function collectVerificationItems(domains, fallbackName) {
+    const out = [];
+    for (const domain of domains) {
+        for (const item of domain.verify?.checklist?.slice(0, 1) ?? []) {
+            out.push(`${capitalize(domain.name)}: ${item}`);
+        }
+    }
+    return out.slice(0, 3).length > 0 ? out.slice(0, 3) : [`Confirm acceptance behavior for ${fallbackName}`];
+}
+function frontmatter(input, artifact, capabilityName) {
+    return [
+        '<!--',
+        '  generatedBy: specdo template-renderer',
+        `  artifact: ${artifact}`,
+        `  change: ${input.changeName}`,
+        capabilityName ? `  capability: ${capabilityName}` : '',
+        `  domains: ${input.domains.map((d) => d.name).join(', ') || '(none)'}`,
+        `  generatedAt: ${input.generatedAt}`,
+        '-->',
+    ]
+        .filter(Boolean)
+        .join('\n');
+}
+function displayName(domain) {
+    return domain.name.charAt(0).toUpperCase() + domain.name.slice(1);
+}
+function slugify(value) {
+    return value.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+}
+function normalizeSentence(value) {
+    return value.trim().replace(/\s+/g, ' ');
+}
+function capitalize(value) {
+    return value.charAt(0).toUpperCase() + value.slice(1);
+}
+function requirementTitleFromCapability(capability) {
+    return capability.summary
+        .replace(/\.$/, '')
+        .replace(/^deliver\s+/i, '')
+        .replace(/^add\s+/i, 'Add ');
+}
+function scenarioTitleFromCapability(capability) {
+    return capability.summary
+        .replace(/\.$/, '')
+        .replace(/^add\s+/i, 'Use ')
+        .replace(/^deliver\s+/i, 'Use ');
+}
+//# sourceMappingURL=template-renderer.js.map