spec-manager 0.1.0

package/dist/core/task.js

@@ -0,0 +1,340 @@
+/**
+ * Agent Task 生命周期
+ * - task 元数据：specs/<topic>/<L1>/<L2>/<L3>/tasks/<taskId>.json
+ * - task 步骤：L3 spec frontmatter steps[]（与 spec 同文件，原子写）
+ *
+ * 状态机：draft → running → (waiting →) running → completed | failed
+ * cascade: complete 时若 L3 已全 implemented → 把父 L2 也置 implemented（递归）
+ */
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { siblingMetaDir } from './paths.js';
+import { findSpecByCode, updateSpec, writeSpec, listAllSpecs } from './spec-io.js';
+import { writeAtomic } from './frontmatter.js';
+import { PlanJsonSchema } from '../schemas/spec.js';
+import { validatePlanJson } from './validate.js';
+import { ID_PAD_WIDTH, TASK_FILE_EXT, TASK_ID_PREFIX } from './constants.js';
+import { recordAuditHit } from './audit-events.js';
+import { listTopicMetaFiles } from './repository.js';
+import { assertTaskTransition } from './status.js';
+export { canTaskTransition } from './status.js';
+/**
+ * 平铺布局下,tasks/ 在 topic 目录下:
+ *   specs/<topic>/tasks/<specCode>-<taskId>.json
+ * 文件名加 specCode 前缀避免跨 L3 的 T-001 冲突。
+ */
+function tasksDirOfSpec(specFilePath) {
+    return siblingMetaDir(specFilePath, 'tasks');
+}
+function taskFilePath(specFilePath, specCode, taskId) {
+    return join(tasksDirOfSpec(specFilePath), `${specCode}-${taskId}${TASK_FILE_EXT}`);
+}
+/**
+ * 从任务文件名反解 taskId: <specCode>-T-001.json → T-001
+ */
+function taskIdFromFilename(filename, specCode) {
+    const prefix = `${specCode}-`;
+    if (!filename.startsWith(prefix) || !filename.endsWith(TASK_FILE_EXT))
+        return null;
+    return filename.slice(prefix.length, -TASK_FILE_EXT.length);
+}
+export function generateTaskId(specFilePath, specCode) {
+    const tasksDir = tasksDirOfSpec(specFilePath);
+    if (!existsSync(tasksDir))
+        return `${TASK_ID_PREFIX}${'1'.padStart(ID_PAD_WIDTH, '0')}`;
+    const existing = readdirSync(tasksDir)
+        .map(f => taskIdFromFilename(f, specCode))
+        .filter((id) => id !== null)
+        .map(id => {
+        const m = id.match(/^T-(\d+)$/);
+        return m ? Number(m[1]) : 0;
+    });
+    const max = existing.length > 0 ? Math.max(...existing) : 0;
+    return `${TASK_ID_PREFIX}${String(max + 1).padStart(ID_PAD_WIDTH, '0')}`;
+}
+function writeTaskJSON(filePath, data) {
+    writeAtomic(filePath, JSON.stringify(data, null, 2));
+}
+/**
+ * 按 taskId 查找任务。
+ * 传 specCode 时按文件名精确查找（避免跨 spec 的 T-001 冲突）；
+ * 不传时回退到全局扫描（向后兼容）。
+ */
+function findTaskById(paths, taskId, specCode) {
+    if (specCode) {
+        const spec = findSpecByCode(paths, specCode);
+        if (!spec)
+            throw new Error(`Spec not found: ${specCode}`);
+        const f = taskFilePath(spec.filePath, specCode, taskId);
+        if (!existsSync(f))
+            throw new Error(`Task not found: ${taskId} (in ${specCode})`);
+        return JSON.parse(readFileSync(f, 'utf8'));
+    }
+    const found = listTasks(paths).find(t => t.id === taskId);
+    if (!found)
+        throw new Error(`Task not found: ${taskId}`);
+    return found;
+}
+export function createTask(input) {
+    const spec = findSpecByCode(input.paths, input.specCode);
+    if (!spec)
+        throw new Error(`Spec not found: ${input.specCode}`);
+    if (spec.fm.level !== 'L3')
+        throw new Error(`Agent Task 只能由 L3 spec 创建，${input.specCode} 是 ${spec.fm.level}`);
+    if (spec.fm.status !== 'frozen') {
+        recordAuditHit({ paths: input.paths, ruleId: 'R3', specCode: input.specCode }, input.auditSink);
+        throw new Error(`R3: L3 必须 frozen 才能建 Task，当前 status=${spec.fm.status}`);
+    }
+    const parsedPlan = PlanJsonSchema.safeParse(input.planJson);
+    if (!parsedPlan.success) {
+        const message = parsedPlan.error.issues.map(i => i.message).join('; ');
+        if (message.includes('R11')) {
+            recordAuditHit({ paths: input.paths, ruleId: 'R11', specCode: input.specCode }, input.auditSink);
+        }
+        throw new Error(message);
+    }
+    const planWarnings = validatePlanJson(input.planJson);
+    const r10 = planWarnings.find(w => w.rule === 'R10');
+    if (r10) {
+        recordAuditHit({ paths: input.paths, ruleId: 'R10', specCode: input.specCode }, input.auditSink);
+        throw new Error(r10.message);
+    }
+    if (!input.planJson.coveredSpecs?.includes(input.specCode)) {
+        recordAuditHit({ paths: input.paths, ruleId: 'R12', specCode: input.specCode }, input.auditSink);
+        throw new Error(`R12: planJson.coveredSpecs 必须包含当前 L3 specCode (${input.specCode})，禁止凭记忆写 planJson`);
+    }
+    const taskId = generateTaskId(spec.filePath, input.specCode);
+    const task = {
+        id: taskId,
+        specCode: input.specCode,
+        status: 'draft',
+        steps: input.planJson.steps.map((ps) => ({
+            stepNo: ps.stepNo,
+            stepType: ps.stepType,
+            name: ps.name,
+            status: 'pending',
+        })),
+        autoConfirm: input.autoConfirm,
+        startedAt: null,
+        finishedAt: null,
+        created: new Date().toISOString(),
+        waitReason: null,
+        errorCode: null,
+        errorMessage: null,
+    };
+    const taskFile = taskFilePath(spec.filePath, input.specCode, taskId);
+    writeTaskJSON(taskFile, task);
+    // 兼容旧 workflow: spec frontmatter 保留计划快照;运行态 step report 写入 task.steps。
+    spec.fm.steps = task.steps;
+    spec.fm.updated = new Date().toISOString();
+    writeSpec(spec);
+    return { task, taskFile };
+}
+export function findTask(paths, specCode, taskId) {
+    const spec = findSpecByCode(paths, specCode);
+    if (!spec)
+        return null;
+    const f = taskFilePath(spec.filePath, specCode, taskId);
+    if (!existsSync(f))
+        return null;
+    return JSON.parse(readFileSync(f, 'utf8'));
+}
+export function listTasks(paths, opts) {
+    const out = [];
+    const specPrefix = opts?.specCode ? `${opts.specCode}-` : null;
+    const topicSpecCodes = opts?.topic
+        ? new Set(listAllSpecs(paths).filter(s => s.fm.topic === opts.topic).map(s => s.fm.code))
+        : null;
+    const taskFiles = listTopicMetaFiles(paths, 'tasks', {
+        topic: opts?.topic,
+        extension: TASK_FILE_EXT,
+        filePrefix: specPrefix ?? undefined,
+    });
+    for (const file of taskFiles) {
+        const t = JSON.parse(readFileSync(file.filePath, 'utf8'));
+        if (topicSpecCodes && !topicSpecCodes.has(t.specCode))
+            continue;
+        if (opts?.status && t.status !== opts.status)
+            continue;
+        out.push(t);
+    }
+    return out.sort((a, b) => a.created.localeCompare(b.created));
+}
+function specFilePathOf(paths, specCode) {
+    const spec = findSpecByCode(paths, specCode);
+    if (!spec)
+        throw new Error(`Spec not found: ${specCode}`);
+    return spec.filePath;
+}
+export function startTask(paths, taskId, specCode) {
+    const t = findTaskById(paths, taskId, specCode);
+    assertTaskTransition(t.status, 'running');
+    const updated = { ...t, status: 'running', startedAt: t.startedAt ?? new Date().toISOString() };
+    writeTaskJSON(taskFilePath(specFilePathOf(paths, t.specCode), t.specCode, taskId), updated);
+    return updated;
+}
+export function reportStep(input) {
+    const task = findTaskById(input.paths, input.taskId, input.specCode);
+    // R15: outputJson 必含 summary（warning 而非 throw）
+    const warnings = [];
+    if (input.status === 'succeeded') {
+        if (!input.outputJson) {
+            warnings.push('R15: succeeded step 必须提供 outputJson.summary');
+        }
+        else {
+            try {
+                const parsed = JSON.parse(input.outputJson);
+                if (typeof parsed.summary !== 'string' || parsed.summary.length === 0) {
+                    warnings.push('R15: outputJson 缺 summary 字段');
+                }
+            }
+            catch {
+                warnings.push('outputJson 不是合法 JSON');
+            }
+        }
+    }
+    const spec = findSpecByCode(input.paths, task.specCode);
+    if (!spec)
+        throw new Error(`Spec not found: ${task.specCode}`);
+    const steps = [...taskSteps(task, spec.fm.steps)];
+    const idx = steps.findIndex(s => String(s.stepNo) === String(input.stepNo));
+    const step = {
+        stepNo: input.stepNo,
+        stepType: (steps[idx]?.stepType ?? 'mcp_tool'),
+        name: steps[idx]?.name ?? '(unnamed)',
+        status: input.status,
+        toolName: input.toolName,
+        inputJson: input.inputJson,
+        outputJson: input.outputJson,
+        errorCode: input.errorCode,
+        errorMessage: input.errorMessage,
+        latencyMs: input.latencyMs,
+        reportedAt: new Date().toISOString(),
+    };
+    if (idx >= 0)
+        steps[idx] = step;
+    else
+        steps.push(step);
+    const updatedTask = { ...task, steps };
+    writeTaskJSON(taskFilePath(spec.filePath, task.specCode, task.id), updatedTask);
+    return { task: updatedTask, spec, warnings };
+}
+export function completeTask(input) {
+    const task = findTaskById(input.paths, input.taskId, input.specCode);
+    assertTaskTransition(task.status, 'completed');
+    // R5: 校验所有 plan 步骤都已上报(不能跳步)
+    const l3 = findSpecByCode(input.paths, task.specCode);
+    if (l3) {
+        if (l3.fm.status !== 'frozen') {
+            recordAuditHit({ paths: input.paths, ruleId: 'R6', specCode: task.specCode, taskCode: task.id }, input.auditSink);
+            throw new Error(`R6: task complete 前 L3 必须仍是 frozen，当前 status=${l3.fm.status}`);
+        }
+        const unfinished = taskSteps(task, l3.fm.steps).filter(s => s.status !== 'succeeded');
+        if (unfinished.length > 0) {
+            recordAuditHit({ paths: input.paths, ruleId: 'R5', specCode: task.specCode }, input.auditSink);
+            throw new Error(`R5: 仍有 ${unfinished.length} 个步骤未成功（pending/running/failed/skipped）:` +
+                unfinished.map(s => `#${s.stepNo}`).join(', ') +
+                ` — 请先逐个 reportStep 到 succeeded，失败或跳过步骤需修复后重新上报，禁止跳号`);
+        }
+    }
+    // 把 task 标记为 completed
+    const updated = { ...task, status: 'completed', finishedAt: new Date().toISOString() };
+    writeTaskJSON(taskFilePath(specFilePathOf(input.paths, task.specCode), task.specCode, task.id), updated);
+    // L3 spec → implemented (cascade)
+    const cascaded = [];
+    const skipped = [];
+    cascadeImplemented(input.paths, task.specCode, cascaded, skipped, input.auditSink);
+    const implemented = findSpecByCode(input.paths, task.specCode);
+    if (implemented?.fm.status !== 'implemented') {
+        recordAuditHit({ paths: input.paths, ruleId: 'R6', specCode: task.specCode, taskCode: task.id }, input.auditSink);
+        throw new Error(`R6: task complete 后 ${task.specCode} 必须是 implemented，当前 status=${implemented?.fm.status ?? 'missing'}`);
+    }
+    const cascadedL1Specs = cascaded
+        .filter(c => c.level === 'L1' || c.level === 'L0')
+        .map(c => c.code);
+    return { task: updated, cascadedSpecs: cascaded, cascadedL1Specs, skippedSpecs: skipped };
+}
+function cascadeImplemented(paths, specCode, cascaded, skipped, auditSink) {
+    const spec = findSpecByCode(paths, specCode);
+    if (!spec)
+        return;
+    const oldStatus = spec.fm.status;
+    if (oldStatus !== 'frozen') {
+        skipped.push({ code: specCode, status: oldStatus, reason: `expected frozen, got ${oldStatus}` });
+        return;
+    }
+    updateSpec(paths, specCode, { status: 'implemented', changeSummary: `cascade: task complete` }, { auditSink });
+    cascaded.push({ code: specCode, oldStatus, newStatus: 'implemented', level: spec.fm.level });
+    // 父级
+    if (spec.fm.parentCode) {
+        const allChildren = listAllSpecsByParent(paths, spec.fm.parentCode);
+        const allImpl = allChildren.length > 0 && allChildren.every(s => s.fm.status === 'implemented');
+        if (allChildren.length === 0) {
+            skipped.push({ code: spec.fm.parentCode, status: '?', reason: 'no children' });
+        }
+        else if (allImpl) {
+            cascadeImplemented(paths, spec.fm.parentCode, cascaded, skipped, auditSink);
+        }
+        else {
+            skipped.push({
+                code: spec.fm.parentCode,
+                status: '?',
+                reason: `${allChildren.filter(s => s.fm.status !== 'implemented').length}/${allChildren.length} children not implemented yet`,
+            });
+        }
+    }
+}
+function listAllSpecsByParent(paths, parentCode) {
+    return listAllSpecs(paths).filter(s => s.fm.parentCode === parentCode);
+}
+export function failTask(input) {
+    const task = findTaskById(input.paths, input.taskId, input.specCode);
+    assertTaskTransition(task.status, 'failed');
+    const updated = {
+        ...task,
+        status: 'failed',
+        errorCode: input.errorCode ?? 'AGENT_TOOL',
+        errorMessage: input.errorMessage ?? '未知错误',
+        finishedAt: new Date().toISOString(),
+    };
+    writeTaskJSON(taskFilePath(specFilePathOf(input.paths, task.specCode), task.specCode, task.id), updated);
+    return updated;
+}
+export function waitTask(input) {
+    const task = findTaskById(input.paths, input.taskId, input.specCode);
+    assertTaskTransition(task.status, 'waiting');
+    const updated = {
+        ...task,
+        status: 'waiting',
+        waitReason: input.reason ?? '需要人工确认',
+    };
+    writeTaskJSON(taskFilePath(specFilePathOf(input.paths, task.specCode), task.specCode, task.id), updated);
+    return updated;
+}
+export function showTask(paths, taskId, opts) {
+    let task;
+    if (opts?.specCode) {
+        try {
+            task = findTaskById(paths, taskId, opts.specCode);
+        }
+        catch {
+            return null;
+        }
+    }
+    else {
+        task = listTasks(paths).find(t => t.id === taskId);
+    }
+    if (!task)
+        return null;
+    const spec = findSpecByCode(paths, task.specCode);
+    const steps = taskSteps(task, spec?.fm.steps);
+    const all = [...steps].sort((a, b) => Number(a.stepNo) - Number(b.stepNo));
+    if (opts?.full || all.length <= 5) {
+        return { task, steps: all, truncated: false };
+    }
+    return { task, steps: all.slice(-5), truncated: true };
+}
+function taskSteps(task, fallback) {
+    return task.steps ?? fallback ?? [];
+}
+//# sourceMappingURL=task.js.map

package/dist/core/task.js.map

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

package/dist/core/usability.d.ts

@@ -0,0 +1,25 @@
+import { type SpecRecord } from './spec-io.js';
+import { type TaskRecord } from './task.js';
+import type { ProjectPaths } from './paths.js';
+import type { SpecLevel } from './validate.js';
+export type DoctorSeverity = 'ok' | 'warn' | 'fail';
+export interface DoctorCheck {
+    status: DoctorSeverity;
+    label: string;
+    detail: string;
+    action?: string;
+}
+export declare function runProjectDoctor(paths: ProjectPaths): DoctorCheck[];
+export interface TopicFlow {
+    topic: string;
+    specs: SpecRecord[];
+    tasks: TaskRecord[];
+    nextAction: string;
+}
+export declare function getFlowStatus(paths: ProjectPaths, opts?: {
+    topic?: string;
+}): TopicFlow[];
+export declare function suggestNextActionForTopic(topic: string, specs: SpecRecord[], tasks: TaskRecord[]): string;
+export declare function suggestAfterSpecCommand(spec: SpecRecord): string;
+export declare function renderTemplate(packageRoot: string, level: SpecLevel | 'agent-plan', title?: string): string;
+//# sourceMappingURL=usability.d.ts.map

package/dist/core/usability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usability.d.ts","sourceRoot":"","sources":["../../src/core/usability.ts"],"names":[],"mappings":"AAKA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW,EAAE,CAmDnE;AAUD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EAAE,CAezF;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAwBzG;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAUhE;AAMD,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,YAAY,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAK3G"}

package/dist/core/usability.js

@@ -0,0 +1,136 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { AGENT_PROVIDER_INFO } from './agents.js';
+import { readAudit } from './audit.js';
+import { PLACEHOLDER_MARKER } from './constants.js';
+import { listAllSpecs } from './spec-io.js';
+import { listTasks } from './task.js';
+export function runProjectDoctor(paths) {
+    const checks = [];
+    checks.push(fileCheck(paths.isInitialized, '.spec-manager/', 'Project initialized', 'spec-manager project init'));
+    checks.push(fileCheck(existsSync(paths.configFile), '.spec-manager/config.yaml', 'Config file present', 'spec-manager project init'));
+    checks.push(fileCheck(existsSync(paths.auditFile), '.spec-manager/audit.json', 'Audit file present', 'spec-manager project init'));
+    checks.push(fileCheck(existsSync(paths.specsDir), 'specs/', 'Specs directory present', 'spec-manager project init'));
+    checks.push(fileCheck(existsSync(paths.changesDir), 'changes/', 'Changes directory present', 'spec-manager project init'));
+    checks.push(fileCheck(existsSync(paths.archiveDir), 'archive/', 'Archive directory present', 'spec-manager project init'));
+    const agentFiles = AGENT_PROVIDER_INFO.flatMap((p) => p.files);
+    const installedAgentFiles = Array.from(new Set(agentFiles)).filter((f) => existsSync(join(paths.root, trimTrailingSlash(f))));
+    checks.push({
+        status: installedAgentFiles.length > 0 ? 'ok' : 'warn',
+        label: 'AI agent instructions',
+        detail: installedAgentFiles.length > 0 ? installedAgentFiles.join(', ') : 'No agent instruction files found',
+        action: installedAgentFiles.length > 0 ? undefined : 'spec-manager project agents --provider all',
+    });
+    const claudeSkill = join(paths.root, '.claude', 'skills', 'spec-manager');
+    if (existsSync(claudeSkill)) {
+        checks.push(fileCheck(existsSync(join(claudeSkill, 'rules')), '.claude/skills/spec-manager/rules', 'Claude skill rules bundled', 'spec-manager project agents --provider claude --force'));
+        checks.push(fileCheck(existsSync(join(claudeSkill, 'templates')), '.claude/skills/spec-manager/templates', 'Claude skill templates bundled', 'spec-manager project agents --provider claude --force'));
+    }
+    const codeBuddySkill = join(paths.root, '.codebuddy', 'skills', 'spec-manager');
+    if (existsSync(codeBuddySkill)) {
+        checks.push(fileCheck(existsSync(join(codeBuddySkill, 'rules')), '.codebuddy/skills/spec-manager/rules', 'CodeBuddy skill rules bundled', 'spec-manager project agents --provider codebuddy --force'));
+        checks.push(fileCheck(existsSync(join(codeBuddySkill, 'templates')), '.codebuddy/skills/spec-manager/templates', 'CodeBuddy skill templates bundled', 'spec-manager project agents --provider codebuddy --force'));
+    }
+    const specs = paths.isInitialized ? listAllSpecs(paths) : [];
+    const placeholders = specs.filter((s) => s.content.includes(PLACEHOLDER_MARKER));
+    checks.push({
+        status: placeholders.length === 0 ? 'ok' : 'warn',
+        label: 'Spec placeholder content',
+        detail: placeholders.length === 0 ? 'No placeholder specs' : placeholders.map((s) => s.fm.code).join(', '),
+        action: placeholders.length === 0 ? undefined : 'spec-manager spec update <code> --content ./draft.md --ai-summary "..." --change-summary "..."',
+    });
+    try {
+        readAudit(paths);
+        checks.push({ status: 'ok', label: 'Audit readable', detail: paths.auditFile });
+    }
+    catch (err) {
+        checks.push({
+            status: 'fail',
+            label: 'Audit readable',
+            detail: err instanceof Error ? err.message : String(err),
+            action: 'Check .spec-manager/audit.json permissions or recreate it',
+        });
+    }
+    return checks;
+}
+function fileCheck(condition, detail, label, action) {
+    return { status: condition ? 'ok' : 'fail', label, detail, action: condition ? undefined : action };
+}
+function trimTrailingSlash(value) {
+    return value.endsWith('/') ? value.slice(0, -1) : value;
+}
+export function getFlowStatus(paths, opts) {
+    const specs = listAllSpecs(paths).filter((s) => !opts?.topic || s.fm.topic === opts.topic);
+    const topics = new Set(specs.map((s) => s.fm.topic));
+    if (opts?.topic)
+        topics.add(opts.topic);
+    return [...topics].sort().map((topic) => {
+        const topicSpecs = specs.filter((s) => s.fm.topic === topic).sort(compareSpecRecords);
+        const tasks = listTasks(paths, { topic });
+        return {
+            topic,
+            specs: topicSpecs,
+            tasks,
+            nextAction: suggestNextActionForTopic(topic, topicSpecs, tasks),
+        };
+    });
+}
+export function suggestNextActionForTopic(topic, specs, tasks) {
+    if (specs.length === 0) {
+        return `spec-manager spec new L1 --topic ${topic} --title "..."`;
+    }
+    const placeholder = specs.find((s) => s.content.includes(PLACEHOLDER_MARKER));
+    if (placeholder) {
+        return `spec-manager spec update ${placeholder.fm.code} --content ./draft.md --ai-summary "..." --change-summary "..."`;
+    }
+    const draft = specs.find((s) => s.fm.status === 'draft');
+    if (draft)
+        return `spec-manager spec confirm ${draft.fm.code}`;
+    const confirmedL3 = specs.find((s) => s.fm.level === 'L3' && s.fm.status === 'confirmed');
+    if (confirmedL3)
+        return `spec-manager spec freeze ${confirmedL3.fm.code}`;
+    const frozenL3 = specs.find((s) => s.fm.level === 'L3' && s.fm.status === 'frozen');
+    if (frozenL3) {
+        const task = tasks.find((t) => t.specCode === frozenL3.fm.code && t.status !== 'completed' && t.status !== 'failed');
+        if (!task)
+            return `spec-manager task create ${frozenL3.fm.code} --plan ./plan.json`;
+        if (task.status === 'draft')
+            return `spec-manager task start ${task.id} --spec ${task.specCode}`;
+        if (task.status === 'running')
+            return `spec-manager task step ${task.id} --spec ${task.specCode} --no <N> --status succeeded --output-json '{"summary":"..."}'`;
+        if (task.status === 'waiting')
+            return `Resolve wait reason, then spec-manager task start ${task.id} --spec ${task.specCode}`;
+    }
+    const confirmedNonL3 = specs.find((s) => (s.fm.level === 'L1' || s.fm.level === 'L2') && s.fm.status === 'confirmed');
+    if (confirmedNonL3?.fm.level === 'L1')
+        return `spec-manager spec new L2 --topic ${topic} --parent ${confirmedNonL3.fm.code} --title "..."`;
+    if (confirmedNonL3?.fm.level === 'L2')
+        return `spec-manager spec new L3 --topic ${topic} --parent ${confirmedNonL3.fm.code} --title "..."`;
+    return 'No immediate action. Use spec-manager flow status for details.';
+}
+export function suggestAfterSpecCommand(spec) {
+    if (spec.content.includes(PLACEHOLDER_MARKER)) {
+        return `spec-manager spec update ${spec.fm.code} --content ./draft.md --ai-summary "..." --change-summary "init"`;
+    }
+    if (spec.fm.status === 'draft')
+        return `Wait for user approval, then spec-manager spec confirm ${spec.fm.code}`;
+    if (spec.fm.level === 'L3' && spec.fm.status === 'confirmed')
+        return `Wait for user approval, then spec-manager spec freeze ${spec.fm.code}`;
+    if (spec.fm.level === 'L3' && spec.fm.status === 'frozen')
+        return `spec-manager task create ${spec.fm.code} --plan ./plan.json`;
+    if (spec.fm.level === 'L1' && spec.fm.status === 'confirmed')
+        return `spec-manager spec new L2 --topic ${spec.fm.topic} --parent ${spec.fm.code} --title "..."`;
+    if (spec.fm.level === 'L2' && spec.fm.status === 'confirmed')
+        return `spec-manager spec new L3 --topic ${spec.fm.topic} --parent ${spec.fm.code} --title "..."`;
+    return 'spec-manager flow status';
+}
+function compareSpecRecords(a, b) {
+    return a.fm.code.localeCompare(b.fm.code);
+}
+export function renderTemplate(packageRoot, level, title) {
+    const fileName = level === 'agent-plan' ? 'agent-plan.json' : `${level}-prd.md`;
+    const actual = level === 'L2' ? 'L2-design.md' : level === 'L3' ? 'L3-impl.md' : fileName;
+    const raw = readFileSync(join(packageRoot, 'templates', actual), 'utf8');
+    return raw.replaceAll('{{title}}', title ?? 'Untitled');
+}
+//# sourceMappingURL=usability.js.map

package/dist/core/usability.js.map

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

package/dist/core/validate.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 验证 spec 正文的必填段，**只返回 warning，不 throw**。
+ * 这是 MCP 版 doc_update 的 validateSpecSections 行为的直接复刻。
+ *
+ * 必填段定义:
+ *   L1: 背景 / 用户故事 / 验收标准 / 范围边界
+ *   L2: 方案概述 / 技术决策 / 受影响模块 / 接口契约 / L3 裂变计划
+ *   L3: 目标 / 实施步骤 / 验证命令
+ *
+ * 同时校验 RFC 2119 关键字（如果 L1/L2 内容包含"验收标准"段，则该段每条 AC 应含
+ * SHALL/MUST/SHOULD 之一）。这是 OpenSpec 风格的强化。
+ */
+export type SpecLevel = 'L0' | 'L1' | 'L2' | 'L3';
+export interface ValidationWarning {
+    rule: string;
+    level: 'info' | 'warn';
+    message: string;
+    section?: string;
+}
+export declare function validateSpecContent(level: SpecLevel, content: string): ValidationWarning[];
+/**
+ * 校验 planJson（来自 templates/agent-plan.json 模板）。
+ * INC-005 教训：禁止用 no/type/desc，必须 stepNo/stepType/name。
+ */
+export interface PlanStep {
+    stepNo: number | string;
+    stepType: 'llm_call' | 'mcp_tool' | 'human_gate';
+    name: string;
+}
+export interface PlanJson {
+    steps: PlanStep[];
+}
+export declare function validatePlanJson(plan: unknown): ValidationWarning[];
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/core/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAWD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE,CA0F1F;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,QAAQ,EAAE,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;IACjD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,EAAE,CAmEnE"}