spec-manager 0.1.0

package/dist/core/spec-io.js

@@ -0,0 +1,260 @@
+/**
+ * Spec 文件的原子读写。
+ *
+ * 写策略：写临时文件 → rename，保证并发下不会读到半截内容。
+ * 读策略：先解析 frontmatter，找不到时返回 null（由调用方决定 fallback）。
+ */
+import { existsSync, renameSync, statSync } from 'node:fs';
+import { readFrontmatter, writeFrontmatter, writeAtomic } from './frontmatter.js';
+import { assertSafeSpecCode, assertSafeTopic, listSpecFiles, listSpecPathMigrations, specFilePath, } from './paths.js';
+import { AI_SUMMARY_MAX, PLACEHOLDER_MARKER, PLACEHOLDER_CONTENT_MAX } from './constants.js';
+import { recordAuditHit } from './audit-events.js';
+export const DESC_MAX_LEN = 15;
+/**
+ * 生成 spec code: 点分编号，层级自文档化。
+ * - L1: <topic>-L1
+ * - L2: <topic>-L2.1（第 1 个 L2 子 spec）
+ * - L3: <topic>-L3.1.1[-desc]（可选描述后缀，≤15 字符）
+ *
+ * parentCode 为空时生成 <topic>-<level>；
+ * 非空时生成 <topic>-<level>.<N>[.M...][-desc]。
+ */
+export function generateSpecCode(topic, level, parentCode, siblingCount, desc) {
+    if (!parentCode) {
+        return desc ? `${topic}-${level}-${desc}` : `${topic}-${level}`;
+    }
+    const idx = (siblingCount ?? 0) + 1;
+    const match = parentCode.match(/^(.+)-L\d+(.*)$/);
+    const base = match
+        ? `${match[1]}-${level}${match[2]}.${idx}`
+        : `${topic}-${level}.${idx}`;
+    return desc ? `${base}-${desc}` : base;
+}
+export function readSpec(filePath) {
+    try {
+        const { data, content } = readFrontmatter(filePath);
+        return { fm: data, content, filePath };
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return null;
+        throw err;
+    }
+}
+export function findSpecByCode(paths, code) {
+    const all = listAllSpecs(paths);
+    return all.find(s => s.fm.code === code) ?? null;
+}
+const specCache = new Map();
+/**
+ * 带 mtime 失效的 listAllSpecs。文件未变时复用内存里的解析结果,
+ * 避免每次 decision/task/archive/delta 全扫都重新 parse frontmatter。
+ *
+ * 注意:单进程内有效;多进程或显式调 invalidateSpecCache() 失效。
+ */
+export function listAllSpecs(paths) {
+    const files = listSpecFiles(paths);
+    const out = [];
+    for (const f of files) {
+        let mtimeMs;
+        try {
+            mtimeMs = statSync(f.filePath).mtimeMs;
+        }
+        catch {
+            // file gone — drop from cache, skip
+            specCache.delete(f.filePath);
+            continue;
+        }
+        const cached = specCache.get(f.filePath);
+        if (cached && cached.mtimeMs === mtimeMs) {
+            out.push(cached.record);
+            continue;
+        }
+        const rec = readSpec(f.filePath);
+        if (rec) {
+            validateSpecFileIdentity(f, rec);
+            specCache.set(f.filePath, { mtimeMs, record: rec });
+            out.push(rec);
+        }
+    }
+    return out;
+}
+export function invalidateSpecCache(filePath) {
+    if (filePath) {
+        specCache.delete(filePath);
+    }
+    else {
+        specCache.clear();
+    }
+}
+/**
+ * 原子写：先写临时文件，再 rename。
+ */
+export function writeSpec(record) {
+    const out = writeFrontmatter(record.fm, record.content);
+    writeAtomic(record.filePath, out);
+    invalidateSpecCache(record.filePath);
+}
+export function createSpec(args) {
+    let parentFilePath = null;
+    if (args.parentCode) {
+        const parent = args.parentRecord ?? findSpecByCode(args.paths, args.parentCode);
+        if (!parent) {
+            throw new Error(`parentCode 指向不存在的 spec: ${args.parentCode}`);
+        }
+        const expectedParentLevels = {
+            L0: [],
+            L1: [],
+            L2: ['L0', 'L1'],
+            L3: ['L2'],
+        };
+        if (!expectedParentLevels[args.level].includes(parent.fm.level)) {
+            recordAuditHit({ paths: args.paths, ruleId: 'R7', specCode: args.code }, args.auditSink);
+            throw new Error(`R7: ${args.level} 的 parent 必须是 ${expectedParentLevels[args.level].join('/')}, ` +
+                `实际是 ${parent.fm.level} (${args.parentCode})`);
+        }
+        if ((args.level === 'L2' || args.level === 'L3') && parent.fm.status === 'draft') {
+            recordAuditHit({ paths: args.paths, ruleId: 'R4', specCode: args.code }, args.auditSink);
+            throw new Error(`R4: 创建 ${args.level} 前父级 ${args.parentCode} 必须先通过独立审核（confirmed/frozen/implemented），` +
+                `当前 status=${parent.fm.status}`);
+        }
+        recordAuditHit({ paths: args.paths, ruleId: 'R4', specCode: args.code }, args.auditSink);
+        parentFilePath = parent.filePath;
+    }
+    else if (args.level === 'L2' || args.level === 'L3') {
+        recordAuditHit({ paths: args.paths, ruleId: 'R7', specCode: args.code }, args.auditSink);
+        throw new Error(`R7: ${args.level} 必须有 parentCode`);
+    }
+    const filePath = specFilePath(args.paths, parentFilePath, args.code, args.topic);
+    const now = new Date().toISOString();
+    const fm = {
+        code: args.code,
+        level: args.level,
+        title: args.title,
+        topic: args.topic,
+        parentCode: args.parentCode,
+        status: 'draft',
+        milestone: args.milestone,
+        created: now,
+        updated: now,
+    };
+    const rec = { fm, content: `# ${args.title}\n\n${PLACEHOLDER_MARKER}\n`, filePath };
+    writeSpec(rec);
+    if (args.level === 'L0' || args.level === 'L1') {
+        recordAuditHit({ paths: args.paths, ruleId: 'R4', specCode: args.code }, args.auditSink);
+    }
+    return rec;
+}
+export function updateSpec(paths, code, patch, opts) {
+    const warnings = [];
+    const existing = findSpecByCode(paths, code);
+    if (!existing) {
+        throw new Error(`Spec not found: ${code}`);
+    }
+    const fm = { ...existing.fm };
+    let content = existing.content;
+    if (patch.content !== undefined) {
+        if (patch.aiSummary === undefined || patch.aiSummary.trim().length === 0) {
+            recordAuditHit({ paths, ruleId: 'R13', specCode: code }, opts?.auditSink);
+            throw new Error(`R13: spec update --content 必须同时提供 aiSummary，禁止写正文后没有 AI 摘要`);
+        }
+        if (isPlaceholderContent(patch.content)) {
+            recordAuditHit({ paths, ruleId: 'R22', specCode: code }, opts?.auditSink);
+            throw new Error(`R22: contentTemplate 仍是占位内容，spec 创建后必须立即写正文`);
+        }
+        content = patch.content;
+    }
+    if (patch.aiSummary !== undefined) {
+        if (patch.aiSummary.length > AI_SUMMARY_MAX) {
+            recordAuditHit({ paths, ruleId: 'R21', specCode: code }, opts?.auditSink);
+            warnings.push(`aiSummary 超过 ${AI_SUMMARY_MAX} 字符，已自动截断（原长 ${patch.aiSummary.length}）`);
+            fm.aiSummary = patch.aiSummary.slice(0, AI_SUMMARY_MAX);
+        }
+        else {
+            fm.aiSummary = patch.aiSummary;
+        }
+    }
+    if (patch.changeSummary !== undefined)
+        fm.changeSummary = patch.changeSummary;
+    if (patch.status !== undefined)
+        fm.status = patch.status;
+    if (patch.appendStep) {
+        fm.steps = [...(fm.steps ?? []), patch.appendStep];
+    }
+    if (patch.replaceStep) {
+        const steps = [...(fm.steps ?? [])];
+        const idx = steps.findIndex(s => String(s.stepNo) === String(patch.replaceStep.no));
+        if (idx >= 0)
+            steps[idx] = patch.replaceStep.step;
+        else
+            steps.push(patch.replaceStep.step);
+        fm.steps = steps;
+    }
+    if (patch.addRelation) {
+        fm.relations = [...(fm.relations ?? []), patch.addRelation];
+    }
+    fm.updated = new Date().toISOString();
+    const rec = { fm, content, filePath: existing.filePath };
+    writeSpec(rec);
+    if (patch.content !== undefined) {
+        recordAuditHit({ paths, ruleId: 'R1', specCode: code }, opts?.auditSink);
+        recordAuditHit({ paths, ruleId: 'R13', specCode: code }, opts?.auditSink);
+        recordAuditHit({ paths, ruleId: 'R22', specCode: code }, opts?.auditSink);
+    }
+    return { record: rec, warnings };
+}
+/**
+ * R22: contentTemplate 是不是只剩 createSpec 写出的占位?
+ * 占位 = 文件里有 marker 行,且去掉 marker 后正文长度 < PLACEHOLDER_CONTENT_MAX。
+ */
+export function isPlaceholderContent(content) {
+    if (!content || !content.includes(PLACEHOLDER_MARKER))
+        return false;
+    const stripped = content.replace(PLACEHOLDER_MARKER, '').trim();
+    return stripped.length < PLACEHOLDER_CONTENT_MAX;
+}
+function validateSpecFileIdentity(entry, record) {
+    assertSafeTopic(entry.topic);
+    assertSafeSpecCode(entry.code);
+    if (record.fm.code !== entry.code) {
+        throw new Error(`Spec 文件名和 frontmatter code 不一致: ${entry.filePath} (filename=${entry.code}, fm=${record.fm.code})`);
+    }
+    if (record.fm.topic !== entry.topic) {
+        throw new Error(`Spec 目录和 frontmatter topic 不一致: ${entry.filePath} (dir=${entry.topic}, fm=${record.fm.topic})`);
+    }
+}
+export function migrateSpecPaths(paths, opts) {
+    const migrations = listSpecPathMigrations(paths);
+    const errors = [];
+    for (const m of migrations) {
+        try {
+            assertSafeTopic(m.topic);
+            assertSafeSpecCode(m.code);
+            const rec = readSpec(m.from);
+            if (!rec)
+                throw new Error('无法读取 spec');
+            validateSpecFileIdentity({ topic: m.topic, code: m.code, filePath: m.from }, rec);
+            if (existsSync(m.to))
+                throw new Error(`目标文件已存在: ${m.to}`);
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            errors.push(`${m.from}: ${reason}`);
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error(`spec path migration 预检失败:\n${errors.join('\n')}`);
+    }
+    if (!opts?.dryRun) {
+        for (const m of migrations) {
+            renameSync(m.from, m.to);
+            invalidateSpecCache(m.from);
+            invalidateSpecCache(m.to);
+        }
+    }
+    return {
+        dryRun: opts?.dryRun ?? false,
+        migrated: migrations.map(m => ({ code: m.code, from: m.from, to: m.to })),
+    };
+}
+//# sourceMappingURL=spec-io.js.map

package/dist/core/spec-io.js.map

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

package/dist/core/status.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Spec 状态机：draft → confirmed → frozen → implemented
+ * - draft → confirmed: 用户批准
+ * - confirmed → frozen: 用户批准（仅 L3）
+ * - frozen → implemented: 仅由 task complete 触发（自动级联）
+ * - * → archived: supersede 时
+ *
+ * 严禁：confirmed → draft（回退），除非显式 supersede
+ */
+export type SpecStatus = 'draft' | 'confirmed' | 'frozen' | 'implemented' | 'archived';
+export declare function canTransition(from: SpecStatus, to: SpecStatus): boolean;
+export declare function nextStatuses(from: SpecStatus): SpecStatus[];
+export declare const ALL_STATUSES: SpecStatus[];
+export declare function isActiveStatus(s: SpecStatus): boolean;
+export declare function isCompleteStatus(s: SpecStatus): boolean;
+export type TaskStatus = 'draft' | 'running' | 'waiting' | 'completed' | 'failed';
+export declare const ALL_TASK_STATUSES: TaskStatus[];
+export declare function canTaskTransition(from: TaskStatus, to: TaskStatus): boolean;
+export declare function nextTaskStatuses(from: TaskStatus): TaskStatus[];
+export declare function assertTaskTransition(from: TaskStatus, to: TaskStatus): void;
+export declare function assertSpecTransition(from: SpecStatus, to: SpecStatus): void;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/core/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,GAAG,UAAU,CAAC;AAUvF,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,GAAG,OAAO,CAEvE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,EAAE,CAE3D;AAED,eAAO,MAAM,YAAY,EAAE,UAAU,EAAgE,CAAC;AAEtG,wBAAgB,cAAc,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAErD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAEvD;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAUlF,eAAO,MAAM,iBAAiB,EAAE,UAAU,EAA2D,CAAC;AAEtG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,GAAG,OAAO,CAE3E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,EAAE,CAE/D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,GAAG,IAAI,CAI3E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,GAAG,IAAI,CAI3E"}

package/dist/core/status.js

@@ -0,0 +1,54 @@
+/**
+ * Spec 状态机：draft → confirmed → frozen → implemented
+ * - draft → confirmed: 用户批准
+ * - confirmed → frozen: 用户批准（仅 L3）
+ * - frozen → implemented: 仅由 task complete 触发（自动级联）
+ * - * → archived: supersede 时
+ *
+ * 严禁：confirmed → draft（回退），除非显式 supersede
+ */
+const TRANSITIONS = {
+    draft: ['confirmed', 'archived'],
+    confirmed: ['frozen', 'archived'], // L1/L2 confirmed 后也可直接 archived（被取代）
+    frozen: ['implemented', 'confirmed', 'archived'], // frozen → confirmed 允许用户重审
+    implemented: ['archived'], // implemented → archived（被新 spec 取代）
+    archived: [], // 终态
+};
+export function canTransition(from, to) {
+    return TRANSITIONS[from]?.includes(to) ?? false;
+}
+export function nextStatuses(from) {
+    return TRANSITIONS[from] ?? [];
+}
+export const ALL_STATUSES = ['draft', 'confirmed', 'frozen', 'implemented', 'archived'];
+export function isActiveStatus(s) {
+    return s !== 'archived';
+}
+export function isCompleteStatus(s) {
+    return s === 'implemented' || s === 'archived';
+}
+const TASK_TRANSITIONS = {
+    draft: ['running', 'failed'],
+    running: ['waiting', 'completed', 'failed'],
+    waiting: ['running', 'failed', 'completed'],
+    completed: [],
+    failed: [],
+};
+export const ALL_TASK_STATUSES = ['draft', 'running', 'waiting', 'completed', 'failed'];
+export function canTaskTransition(from, to) {
+    return TASK_TRANSITIONS[from]?.includes(to) ?? false;
+}
+export function nextTaskStatuses(from) {
+    return TASK_TRANSITIONS[from] ?? [];
+}
+export function assertTaskTransition(from, to) {
+    if (!canTaskTransition(from, to)) {
+        throw new Error(`Task 状态非法: ${from} → ${to}`);
+    }
+}
+export function assertSpecTransition(from, to) {
+    if (!canTransition(from, to)) {
+        throw new Error(`状态非法: ${from} → ${to}`);
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/core/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/core/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,GAAqC;IACpD,KAAK,EAAO,CAAC,WAAW,EAAE,UAAU,CAAC;IACrC,SAAS,EAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAW,sCAAsC;IACnF,MAAM,EAAM,CAAC,aAAa,EAAE,WAAW,EAAE,UAAU,CAAC,EAAG,4BAA4B;IACnF,WAAW,EAAC,CAAC,UAAU,CAAC,EAAqB,qCAAqC;IAClF,QAAQ,EAAI,EAAE,EAA+B,KAAK;CACnD,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,IAAgB,EAAE,EAAc;IAC5D,OAAO,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAgB;IAC3C,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC;AAEtG,MAAM,UAAU,cAAc,CAAC,CAAa;IAC1C,OAAO,CAAC,KAAK,UAAU,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,CAAa;IAC5C,OAAO,CAAC,KAAK,aAAa,IAAI,CAAC,KAAK,UAAU,CAAC;AACjD,CAAC;AAID,MAAM,gBAAgB,GAAqC;IACzD,KAAK,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC5B,OAAO,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC;IAC3C,OAAO,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC;IAC3C,SAAS,EAAE,EAAE;IACb,MAAM,EAAE,EAAE;CACX,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAiB,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;AAEtG,MAAM,UAAU,iBAAiB,CAAC,IAAgB,EAAE,EAAc;IAChE,OAAO,gBAAgB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAgB;IAC/C,OAAO,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAgB,EAAE,EAAc;IACnE,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAgB,EAAE,EAAc;IACnE,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC"}

package/dist/core/task.d.ts

@@ -0,0 +1,118 @@
+/**
+ * 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 { type ProjectPaths } from './paths.js';
+import { findSpecByCode, type StepFrontmatter } from './spec-io.js';
+import { type StepStatusT, type StepTypeT } from '../schemas/spec.js';
+import { type AuditSink } from './audit-events.js';
+import { type TaskStatus } from './status.js';
+export type { TaskStatus } from './status.js';
+export interface TaskRecord {
+    id: string;
+    specCode: string;
+    status: TaskStatus;
+    steps?: StepFrontmatter[];
+    autoConfirm: boolean;
+    startedAt: string | null;
+    finishedAt: string | null;
+    created: string;
+    waitReason: string | null;
+    errorCode: string | null;
+    errorMessage: string | null;
+}
+export { canTaskTransition } from './status.js';
+export declare function generateTaskId(specFilePath: string, specCode: string): string;
+export interface CreateTaskInput {
+    paths: ProjectPaths;
+    specCode: string;
+    planJson: {
+        coveredSpecs?: string[];
+        steps: Array<{
+            stepNo: number | string;
+            stepType: StepTypeT;
+            name: string;
+        }>;
+    };
+    autoConfirm: boolean;
+    auditSink?: AuditSink;
+}
+export declare function createTask(input: CreateTaskInput): {
+    task: TaskRecord;
+    taskFile: string;
+};
+export declare function findTask(paths: ProjectPaths, specCode: string, taskId: string): TaskRecord | null;
+export declare function listTasks(paths: ProjectPaths, opts?: {
+    specCode?: string;
+    status?: TaskStatus;
+    topic?: string;
+}): TaskRecord[];
+export declare function startTask(paths: ProjectPaths, taskId: string, specCode?: string): TaskRecord;
+export interface StepInput {
+    paths: ProjectPaths;
+    taskId: string;
+    specCode?: string;
+    stepNo: number | string;
+    status: StepStatusT;
+    toolName?: string;
+    inputJson?: string;
+    outputJson?: string;
+    errorCode?: string;
+    errorMessage?: string;
+    latencyMs?: number;
+}
+export declare function reportStep(input: StepInput): {
+    task: TaskRecord;
+    spec: ReturnType<typeof findSpecByCode>;
+    warnings: string[];
+};
+export interface CompleteInput {
+    paths: ProjectPaths;
+    taskId: string;
+    specCode?: string;
+    auditSink?: AuditSink;
+}
+export interface CompleteResult {
+    task: TaskRecord;
+    cascadedSpecs: Array<{
+        code: string;
+        oldStatus: string;
+        newStatus: string;
+        level: 'L0' | 'L1' | 'L2' | 'L3';
+    }>;
+    cascadedL1Specs: string[];
+    skippedSpecs: Array<{
+        code: string;
+        status: string;
+        reason: string;
+    }>;
+}
+export declare function completeTask(input: CompleteInput): CompleteResult;
+export interface FailInput {
+    paths: ProjectPaths;
+    taskId: string;
+    specCode?: string;
+    errorCode?: string;
+    errorMessage?: string;
+}
+export declare function failTask(input: FailInput): TaskRecord;
+export interface WaitInput {
+    paths: ProjectPaths;
+    taskId: string;
+    specCode?: string;
+    reason?: string;
+}
+export declare function waitTask(input: WaitInput): TaskRecord;
+export declare function showTask(paths: ProjectPaths, taskId: string, opts?: {
+    full?: boolean;
+    specCode?: string;
+}): {
+    task: TaskRecord;
+    steps: StepFrontmatter[];
+    truncated: boolean;
+} | null;
+//# sourceMappingURL=task.d.ts.map

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

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