spec-manager 0.1.0

package/dist/core/incident.js

@@ -0,0 +1,128 @@
+/**
+ * Incident 记录
+ * 存储位置：.spec-manager/incidents/INC-YYYYMMDD-NNN.md
+ * frontmatter：id, ruleId, severity, status, created, specCode?, taskCode?
+ * 正文：触发场景、影响、临时修复、永久方案、关联 spec/task
+ */
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { readFrontmatter, writeFrontmatterAtomic } from './frontmatter.js';
+import { RULE_ID_RE } from './audit.js';
+import { ID_PAD_WIDTH } from './constants.js';
+const VALID_SEVERITY = ['low', 'medium', 'high', 'critical'];
+const VALID_STATUS = ['open', 'mitigated', 'resolved', 'closed'];
+export function listIncidents(paths, opts) {
+    if (!existsSync(paths.incidentsDir))
+        return [];
+    const out = [];
+    for (const f of readdirSync(paths.incidentsDir)) {
+        if (!f.endsWith('.md') || f.startsWith('.'))
+            continue;
+        const filePath = join(paths.incidentsDir, f);
+        const { data, content } = readFrontmatter(filePath);
+        const fm = data;
+        if (opts?.status && fm.status !== opts.status)
+            continue;
+        if (opts?.relatedDecision && !(fm.relatedDecisions ?? []).includes(opts.relatedDecision))
+            continue;
+        out.push({ id: fm.id, fm, content, filePath });
+    }
+    return out.sort((a, b) => b.fm.created.localeCompare(a.fm.created));
+}
+export function findIncident(paths, id) {
+    for (const i of listIncidents(paths)) {
+        if (i.id === id || i.fm.id === id)
+            return i;
+    }
+    return null;
+}
+export function nextIncidentId(paths) {
+    if (!existsSync(paths.incidentsDir)) {
+        const today = new Date().toISOString().slice(0, 10).replace(/-/g, '');
+        return `INC-${today}-001`;
+    }
+    const today = new Date().toISOString().slice(0, 10).replace(/-/g, '');
+    const prefix = `INC-${today}-`;
+    const existing = readdirSync(paths.incidentsDir)
+        .map(f => f.match(/^INC-\d{8}-(\d+)\.md$/))
+        .filter((m) => m !== null)
+        .map(m => Number(m[1]));
+    const max = existing.length > 0 ? Math.max(...existing) : 0;
+    return `${prefix}${String(max + 1).padStart(ID_PAD_WIDTH, '0')}`;
+}
+export function createIncident(input) {
+    if (!RULE_ID_RE.test(input.ruleId)) {
+        throw new Error(`ruleId 格式非法: ${input.ruleId}`);
+    }
+    if (!VALID_SEVERITY.includes(input.severity)) {
+        throw new Error(`severity 非法: ${input.severity}（必须 ${VALID_SEVERITY.join('|')}）`);
+    }
+    if (!input.title.trim()) {
+        throw new Error('title 必填');
+    }
+    const id = nextIncidentId(input.paths);
+    const now = new Date().toISOString();
+    const fm = {
+        id,
+        ruleId: input.ruleId,
+        severity: input.severity,
+        status: 'open',
+        title: input.title,
+        specCode: input.specCode,
+        taskCode: input.taskCode,
+        relatedDecisions: input.relatedDecisions && input.relatedDecisions.length > 0
+            ? input.relatedDecisions
+            : undefined,
+        created: now,
+        updated: now,
+    };
+    const content = renderContent(fm, input.description ?? '');
+    const filePath = join(input.paths.incidentsDir, `${id}.md`);
+    writeFrontmatterAtomic(filePath, fm, content);
+    return { id, fm, content, filePath };
+}
+export function updateIncidentStatus(paths, id, status, note) {
+    const inc = findIncident(paths, id);
+    if (!inc)
+        throw new Error(`Incident not found: ${id}`);
+    if (!VALID_STATUS.includes(status)) {
+        throw new Error(`status 非法: ${status}（必须 ${VALID_STATUS.join('|')}）`);
+    }
+    const updated = {
+        ...inc,
+        fm: { ...inc.fm, status, updated: new Date().toISOString() },
+        content: inc.content + (note ? `\n\n## ${status} (${new Date().toISOString()})\n${note}\n` : ''),
+    };
+    writeFrontmatterAtomic(inc.filePath, updated.fm, updated.content);
+    return updated;
+}
+function renderContent(fm, description) {
+    const lines = [];
+    lines.push(`# ${fm.id} — ${fm.title}`);
+    lines.push('');
+    lines.push(`> 规则: **${fm.ruleId}**  |  严重度: **${fm.severity}**  |  状态: **${fm.status}**${fm.specCode ? `  |  spec: ${fm.specCode}` : ''}${fm.taskCode ? `  |  task: ${fm.taskCode}` : ''}`);
+    lines.push('');
+    lines.push(`> 创建: ${fm.created}`);
+    lines.push('');
+    lines.push('## 触发场景');
+    lines.push(description || '（请补充）');
+    lines.push('');
+    lines.push('## 影响');
+    lines.push('（请补充：影响范围 + 用户痛点）');
+    lines.push('');
+    lines.push('## 临时修复');
+    lines.push('（请补充：紧急止血）');
+    lines.push('');
+    lines.push('## 永久方案');
+    lines.push('（请补充：根因 + 长期修复）');
+    lines.push('');
+    lines.push('## 关联');
+    lines.push('- spec: ' + (fm.specCode ?? '-'));
+    lines.push('- task: ' + (fm.taskCode ?? '-'));
+    lines.push('- 规则: ' + fm.ruleId);
+    if (fm.relatedDecisions && fm.relatedDecisions.length > 0) {
+        lines.push('- 决策: ' + fm.relatedDecisions.join(', '));
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=incident.js.map

package/dist/core/incident.js.map

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

package/dist/core/paths.d.ts

@@ -0,0 +1,68 @@
+/**
+ * 解析项目根目录。
+ * 策略：优先用 SPEC_MANAGER_ROOT 环境变量，否则从 cwd 向上找 .spec-manager/，
+ * 找到为止；找不到就用 cwd（让首次 init 有合理默认值）。
+ */
+export declare function resolveProjectRoot(cwd?: string): string;
+export interface ProjectPaths {
+    root: string;
+    configDir: string;
+    configFile: string;
+    auditFile: string;
+    incidentsDir: string;
+    dictFile: string;
+    specsDir: string;
+    changesDir: string;
+    archiveDir: string;
+    isInitialized: boolean;
+}
+export declare function getPaths(root?: string): ProjectPaths;
+/**
+ * 平铺布局下的 spec 文件路径。
+ *
+ * 布局：specs/<topic>/<code>.md
+ * 点分编号已编码层级关系，无需嵌套目录。
+ *
+ * @param parentFilePath 保留参数（向后兼容），平铺布局下忽略
+ * @param code spec code（如 auth-L1、auth-L2.1、auth-L3.1.1）
+ * @param topic topic 名
+ * @param date 保留参数（向后兼容），canonical 路径下忽略
+ */
+export declare function specFilePath(paths: ProjectPaths, _parentFilePath: string | null, code: string, topic?: string, _date?: string): string;
+export declare function assertSafeTopic(topic: string): void;
+export declare function assertSafeSpecCode(code: string): void;
+/**
+ * 平铺布局下,元数据目录在 topic 级别:
+ *   specs/<topic>/decisions/、specs/<topic>/tasks/
+ */
+export declare function siblingMetaDir(specFilePath: string, name: 'decisions' | 'tasks'): string;
+export interface SpecFileEntry {
+    topic: string;
+    code: string;
+    filePath: string;
+}
+export interface ParsedSpecFilename {
+    code: string;
+    format: 'canonical' | 'legacy-date';
+    legacyDate?: string;
+}
+export interface SpecPathMigration {
+    topic: string;
+    code: string;
+    from: string;
+    to: string;
+    legacyDate: string;
+}
+/**
+ * 平铺布局：直接扫描 specs/<topic>/ 下的 .md 文件。
+ * 跳过元数据目录（decisions/ tasks/ 等）。
+ */
+export declare function listSpecFiles(paths: ProjectPaths): SpecFileEntry[];
+export declare function listSpecPathMigrations(paths: ProjectPaths): SpecPathMigration[];
+/**
+ * 从文件名提取 code。
+ * canonical: <code>.md
+ * legacy:    <code>-<YYYYMMDD>.md
+ */
+export declare function parseSpecFilename(filename: string): ParsedSpecFilename | null;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAYtE;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,QAAQ,CAAC,IAAI,GAAE,MAA6B,GAAG,YAAY,CAe1E;AAUD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,YAAY,EACnB,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAKR;AASD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAInD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIrD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,GAAG,MAAM,CAExF;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,EAAE,CAqBlE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,iBAAiB,EAAE,CAoB/E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAU7E"}

package/dist/core/paths.js

@@ -0,0 +1,162 @@
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { SPEC_CODE_RE, TOPIC_RE } from './constants.js';
+/**
+ * 解析项目根目录。
+ * 策略：优先用 SPEC_MANAGER_ROOT 环境变量，否则从 cwd 向上找 .spec-manager/，
+ * 找到为止；找不到就用 cwd（让首次 init 有合理默认值）。
+ */
+export function resolveProjectRoot(cwd = process.cwd()) {
+    const envRoot = process.env.SPEC_MANAGER_ROOT;
+    if (envRoot)
+        return resolve(envRoot);
+    let dir = resolve(cwd);
+    for (let i = 0; i < 8; i++) {
+        if (existsSync(join(dir, '.spec-manager')))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return resolve(cwd);
+}
+export function getPaths(root = resolveProjectRoot()) {
+    const configDir = join(root, '.spec-manager');
+    const isInitialized = statSafe(configDir)?.isDirectory() ?? false;
+    return {
+        root,
+        configDir,
+        configFile: join(configDir, 'config.yaml'),
+        auditFile: join(configDir, 'audit.json'),
+        incidentsDir: join(configDir, 'incidents'),
+        dictFile: join(configDir, 'dict.yaml'),
+        specsDir: join(root, 'specs'),
+        changesDir: join(root, 'changes'),
+        archiveDir: join(root, 'archive'),
+        isInitialized,
+    };
+}
+function statSafe(p) {
+    try {
+        return statSync(p);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 平铺布局下的 spec 文件路径。
+ *
+ * 布局：specs/<topic>/<code>.md
+ * 点分编号已编码层级关系，无需嵌套目录。
+ *
+ * @param parentFilePath 保留参数（向后兼容），平铺布局下忽略
+ * @param code spec code（如 auth-L1、auth-L2.1、auth-L3.1.1）
+ * @param topic topic 名
+ * @param date 保留参数（向后兼容），canonical 路径下忽略
+ */
+export function specFilePath(paths, _parentFilePath, code, topic, _date) {
+    assertSafeSpecCode(code);
+    const t = topic ?? extractTopicFromCode(code);
+    assertSafeTopic(t);
+    return join(paths.specsDir, t, `${code}.md`);
+}
+function extractTopicFromCode(code) {
+    // spec-manager-ai-ux-L1 → spec-manager-ai-ux
+    const match = code.match(/^(.+)-L\d/);
+    if (match)
+        return match[1];
+    throw new Error(`specFilePath: 无法从 code 推断 topic，请传 topic 参数`);
+}
+export function assertSafeTopic(topic) {
+    if (!TOPIC_RE.test(topic)) {
+        throw new Error(`topic 非法: ${topic}（必须匹配 ${TOPIC_RE.source}，且不能包含路径分隔符）`);
+    }
+}
+export function assertSafeSpecCode(code) {
+    if (!SPEC_CODE_RE.test(code)) {
+        throw new Error(`spec code 非法: ${code}（必须匹配 ${SPEC_CODE_RE.source}，且不能包含路径分隔符）`);
+    }
+}
+/**
+ * 平铺布局下,元数据目录在 topic 级别:
+ *   specs/<topic>/decisions/、specs/<topic>/tasks/
+ */
+export function siblingMetaDir(specFilePath, name) {
+    return join(dirname(specFilePath), name);
+}
+/**
+ * 平铺布局：直接扫描 specs/<topic>/ 下的 .md 文件。
+ * 跳过元数据目录（decisions/ tasks/ 等）。
+ */
+export function listSpecFiles(paths) {
+    const out = [];
+    if (!existsSync(paths.specsDir))
+        return out;
+    for (const topicEntry of readdirSync(paths.specsDir, { withFileTypes: true })) {
+        if (!topicEntry.isDirectory() || topicEntry.name.startsWith('.'))
+            continue;
+        const topicDir = join(paths.specsDir, topicEntry.name);
+        for (const file of readdirSync(topicDir, { withFileTypes: true })) {
+            if (file.isDirectory())
+                continue;
+            if (!file.name.endsWith('.md'))
+                continue;
+            if (file.name.startsWith('.'))
+                continue;
+            const parsed = parseSpecFilename(file.name);
+            if (!parsed)
+                continue;
+            const filePath = join(topicDir, file.name);
+            const dup = out.find(e => e.topic === topicEntry.name && e.code === parsed.code);
+            if (dup) {
+                throw new Error(`重复 spec code: ${parsed.code} (${dup.filePath}, ${filePath})`);
+            }
+            out.push({ topic: topicEntry.name, code: parsed.code, filePath });
+        }
+    }
+    return out.sort((a, b) => a.code.localeCompare(b.code));
+}
+export function listSpecPathMigrations(paths) {
+    const out = [];
+    if (!existsSync(paths.specsDir))
+        return out;
+    for (const topicEntry of readdirSync(paths.specsDir, { withFileTypes: true })) {
+        if (!topicEntry.isDirectory() || topicEntry.name.startsWith('.'))
+            continue;
+        const topicDir = join(paths.specsDir, topicEntry.name);
+        for (const file of readdirSync(topicDir, { withFileTypes: true })) {
+            if (file.isDirectory() || file.name.startsWith('.') || !file.name.endsWith('.md'))
+                continue;
+            const parsed = parseSpecFilename(file.name);
+            if (!parsed || parsed.format !== 'legacy-date' || !parsed.legacyDate)
+                continue;
+            out.push({
+                topic: topicEntry.name,
+                code: parsed.code,
+                from: join(topicDir, file.name),
+                to: join(topicDir, `${parsed.code}.md`),
+                legacyDate: parsed.legacyDate,
+            });
+        }
+    }
+    return out.sort((a, b) => a.code.localeCompare(b.code));
+}
+/**
+ * 从文件名提取 code。
+ * canonical: <code>.md
+ * legacy:    <code>-<YYYYMMDD>.md
+ */
+export function parseSpecFilename(filename) {
+    const legacy = filename.match(/^(.+)-(\d{8})\.md$/);
+    if (legacy && SPEC_CODE_RE.test(legacy[1])) {
+        return { code: legacy[1], format: 'legacy-date', legacyDate: legacy[2] };
+    }
+    const old = filename.match(/^(.+)\.md$/);
+    if (old && SPEC_CODE_RE.test(old[1])) {
+        return { code: old[1], format: 'canonical' };
+    }
+    return null;
+}
+//# sourceMappingURL=paths.js.map

package/dist/core/paths.js.map

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

package/dist/core/repository.d.ts

@@ -0,0 +1,13 @@
+import type { ProjectPaths } from './paths.js';
+export type TopicMetaDir = 'tasks' | 'decisions';
+export interface TopicMetaFile {
+    topic: string;
+    fileName: string;
+    filePath: string;
+}
+export declare function listTopicMetaFiles(paths: ProjectPaths, dirName: TopicMetaDir, opts?: {
+    topic?: string;
+    extension?: string;
+    filePrefix?: string;
+}): TopicMetaFile[];
+//# sourceMappingURL=repository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../src/core/repository.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,WAAW,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,YAAY,EACrB,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACjE,aAAa,EAAE,CAuBjB"}

package/dist/core/repository.js

@@ -0,0 +1,29 @@
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+export function listTopicMetaFiles(paths, dirName, opts) {
+    const out = [];
+    if (!existsSync(paths.specsDir))
+        return out;
+    for (const topicEntry of readdirSync(paths.specsDir, { withFileTypes: true })) {
+        if (!topicEntry.isDirectory() || topicEntry.name.startsWith('.'))
+            continue;
+        if (opts?.topic && topicEntry.name !== opts.topic)
+            continue;
+        const metaDir = join(paths.specsDir, topicEntry.name, dirName);
+        if (!existsSync(metaDir))
+            continue;
+        for (const fileName of readdirSync(metaDir)) {
+            if (opts?.extension && !fileName.endsWith(opts.extension))
+                continue;
+            if (opts?.filePrefix && !fileName.startsWith(opts.filePrefix))
+                continue;
+            out.push({
+                topic: topicEntry.name,
+                fileName,
+                filePath: join(metaDir, fileName),
+            });
+        }
+    }
+    return out.sort((a, b) => a.filePath.localeCompare(b.filePath));
+}
+//# sourceMappingURL=repository.js.map

package/dist/core/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../src/core/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAWjC,MAAM,UAAU,kBAAkB,CAChC,KAAmB,EACnB,OAAqB,EACrB,IAAkE;IAElE,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC;QAAE,OAAO,GAAG,CAAC;IAE5C,KAAK,MAAM,UAAU,IAAI,WAAW,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9E,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAC3E,IAAI,IAAI,EAAE,KAAK,IAAI,UAAU,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK;YAAE,SAAS;QAE5D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/D,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,SAAS;QAEnC,KAAK,MAAM,QAAQ,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5C,IAAI,IAAI,EAAE,SAAS,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;gBAAE,SAAS;YACpE,IAAI,IAAI,EAAE,UAAU,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC;gBAAE,SAAS;YACxE,GAAG,CAAC,IAAI,CAAC;gBACP,KAAK,EAAE,UAAU,CAAC,IAAI;gBACtB,QAAQ;gBACR,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC;aAClC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/core/spec-io.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Spec 文件的原子读写。
+ *
+ * 写策略：写临时文件 → rename，保证并发下不会读到半截内容。
+ * 读策略：先解析 frontmatter，找不到时返回 null（由调用方决定 fallback）。
+ */
+import type { SpecLevel } from './validate.js';
+import { type ProjectPaths } from './paths.js';
+import { type AuditSink } from './audit-events.js';
+export interface SpecFrontmatter {
+    id?: string;
+    code: string;
+    level: SpecLevel;
+    title: string;
+    topic: string;
+    parentCode: string | null;
+    status: 'draft' | 'confirmed' | 'frozen' | 'implemented' | 'archived';
+    milestone?: string;
+    aiSummary?: string;
+    coveredTasks?: string[];
+    steps?: StepFrontmatter[];
+    relations?: Array<{
+        type: string;
+        target: string;
+    }>;
+    created?: string;
+    updated?: string;
+    changeSummary?: string;
+}
+export interface StepFrontmatter {
+    stepNo: number | string;
+    stepType: 'llm_call' | 'mcp_tool' | 'human_gate';
+    name: string;
+    status: 'pending' | 'running' | 'succeeded' | 'failed' | 'skipped';
+    toolName?: string;
+    inputJson?: string;
+    outputJson?: string;
+    errorCode?: string;
+    errorMessage?: string;
+    latencyMs?: number;
+    reportedAt?: string;
+}
+export interface SpecRecord {
+    fm: SpecFrontmatter;
+    content: string;
+    filePath: string;
+}
+export declare 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 declare function generateSpecCode(topic: string, level: SpecLevel, parentCode?: string, siblingCount?: number, desc?: string): string;
+export declare function readSpec(filePath: string): SpecRecord | null;
+export declare function findSpecByCode(paths: ProjectPaths, code: string): SpecRecord | null;
+/**
+ * 带 mtime 失效的 listAllSpecs。文件未变时复用内存里的解析结果,
+ * 避免每次 decision/task/archive/delta 全扫都重新 parse frontmatter。
+ *
+ * 注意:单进程内有效;多进程或显式调 invalidateSpecCache() 失效。
+ */
+export declare function listAllSpecs(paths: ProjectPaths): SpecRecord[];
+export declare function invalidateSpecCache(filePath?: string): void;
+/**
+ * 原子写：先写临时文件，再 rename。
+ */
+export declare function writeSpec(record: SpecRecord): void;
+export declare function createSpec(args: {
+    paths: ProjectPaths;
+    code: string;
+    level: SpecLevel;
+    title: string;
+    topic: string;
+    parentCode: string | null;
+    parentRecord?: SpecRecord | null;
+    milestone?: string;
+    auditSink?: AuditSink;
+}): SpecRecord;
+/**
+ * 更新 spec：传 partial 覆盖 frontmatter，更新 content，更新 updated 时间戳。
+ * 自动截断 aiSummary 到 300 字符（带 warning）。
+ */
+export interface UpdateResult {
+    record: SpecRecord;
+    warnings: string[];
+}
+export declare function updateSpec(paths: ProjectPaths, code: string, patch: {
+    content?: string;
+    aiSummary?: string;
+    changeSummary?: string;
+    status?: SpecFrontmatter['status'];
+    appendStep?: StepFrontmatter;
+    replaceStep?: {
+        no: number | string;
+        step: StepFrontmatter;
+    };
+    addRelation?: {
+        type: string;
+        target: string;
+    };
+}, opts?: {
+    auditSink?: AuditSink;
+}): UpdateResult;
+/**
+ * R22: contentTemplate 是不是只剩 createSpec 写出的占位?
+ * 占位 = 文件里有 marker 行,且去掉 marker 后正文长度 < PLACEHOLDER_CONTENT_MAX。
+ */
+export declare function isPlaceholderContent(content: string): boolean;
+export interface SpecPathMigrationResult {
+    dryRun: boolean;
+    migrated: Array<{
+        code: string;
+        from: string;
+        to: string;
+    }>;
+}
+export declare function migrateSpecPaths(paths: ProjectPaths, opts?: {
+    dryRun?: boolean;
+}): SpecPathMigrationResult;
+//# sourceMappingURL=spec-io.d.ts.map

package/dist/core/spec-io.d.ts.map

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