spec-manager 0.1.0

package/dist/core/delta.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Delta Spec 解析器
+ *
+ * 一个 change 提案 = changes/<name>/
+ *   ├── proposal.md          ← 为什么 + 范围
+ *   ├── specs/<topic>/<code>/<code>.md  ← ADDED 时主 spec 的占位（带 frontmatter）
+ *   └── deltas/<code>.md     ← ADDED/MODIFIED/REMOVED/RENAMED 列表
+ *
+ * 本文件：解析 deltas/<code>.md 或内联在 spec 文件 ## DELTA 段中的变更。
+ *
+ * 文件格式（每个 delta 文件）：
+ *   ---
+ *   code: 2026-06-04-a1b2c3
+ *   ---
+ *
+ *   ## ADDED Requirements
+ *   ### Requirement: Two-Factor Authentication
+ *   The system **SHALL** ...（完整 SHALL/MUST 表述）
+ *
+ *   ## MODIFIED Requirements
+ *   ### Requirement: ...
+ *   **旧文**：...
+ *   **新文**：...
+ *
+ *   ## REMOVED Requirements
+ *   ### Requirement: ...
+ *   说明删除原因
+ *
+ *   ## RENAMED Requirements
+ *   - FROM: 2026-06-04-a1b2c3-old TO: 2026-06-04-a1b2c3-new
+ *
+ * Archive 时按 RENAMED→REMOVED→MODIFIED→ADDED 顺序应用：
+ *   - RENAMED: spec 文件改名 + frontmatter code 改写
+ *   - REMOVED: spec 文件移到 archive
+ *   - MODIFIED: 替换 section 内容
+ *   - ADDED: 创建新 spec
+ */
+import { type ChangeEntry, type DeltaSpec } from '../schemas/change.js';
+import type { ProjectPaths } from './paths.js';
+export interface ChangeDir {
+    root: string;
+    proposal: string;
+    deltaFiles: string[];
+    specFiles: string[];
+}
+export declare function changeDir(paths: ProjectPaths, name: string): string;
+export declare function getChangeDir(paths: ProjectPaths, name: string): ChangeDir | null;
+export declare function listChanges(paths: ProjectPaths): Array<{
+    name: string;
+    root: string;
+    created: string;
+}>;
+/**
+ * 解析一个 delta 文件为 ChangeEntry 列表。
+ * 一个 delta 文件可以含多个 ## ADDED/MODIFIED/REMOVED/RENAMED 段。
+ */
+export declare function parseDeltaFile(filePath: string): {
+    specCode: string;
+    entries: ChangeEntry[];
+};
+/**
+ * 解析整个 change 目录，返回结构化 DeltaSpec。
+ * 校验：每个 delta 文件的 specCode 必须和文件名一致；entry.code 必填。
+ */
+export declare function parseDeltaSpec(paths: ProjectPaths, name: string): DeltaSpec;
+/**
+ * 创建一个新 change 目录（scaffold）。
+ * 包含 proposal.md 模板 + deltas/ + specs/ 空目录。
+ */
+export interface CreateChangeInput {
+    paths: ProjectPaths;
+    name: string;
+    description?: string;
+}
+export declare function createChange(input: CreateChangeInput): {
+    name: string;
+    root: string;
+    proposalFile: string;
+};
+/**
+ * 把 delta entry 渲染成可写的 delta 文件格式。
+ * 用户可以直接 edit 这个文件，然后再 archive。
+ */
+export declare function renderDeltaFile(specCode: string, entries: ChangeEntry[]): string;
+//# sourceMappingURL=delta.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delta.d.ts","sourceRoot":"","sources":["../../src/core/delta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAKH,OAAO,EAAmB,KAAK,WAAW,EAAkB,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACzG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAwBhF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAevG;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,EAAE,CAAA;CAAE,CA+D7F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAoB3E;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CA0B3G;AAqBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CA2BhF"}

package/dist/core/delta.js

@@ -0,0 +1,264 @@
+/**
+ * Delta Spec 解析器
+ *
+ * 一个 change 提案 = changes/<name>/
+ *   ├── proposal.md          ← 为什么 + 范围
+ *   ├── specs/<topic>/<code>/<code>.md  ← ADDED 时主 spec 的占位（带 frontmatter）
+ *   └── deltas/<code>.md     ← ADDED/MODIFIED/REMOVED/RENAMED 列表
+ *
+ * 本文件：解析 deltas/<code>.md 或内联在 spec 文件 ## DELTA 段中的变更。
+ *
+ * 文件格式（每个 delta 文件）：
+ *   ---
+ *   code: 2026-06-04-a1b2c3
+ *   ---
+ *
+ *   ## ADDED Requirements
+ *   ### Requirement: Two-Factor Authentication
+ *   The system **SHALL** ...（完整 SHALL/MUST 表述）
+ *
+ *   ## MODIFIED Requirements
+ *   ### Requirement: ...
+ *   **旧文**：...
+ *   **新文**：...
+ *
+ *   ## REMOVED Requirements
+ *   ### Requirement: ...
+ *   说明删除原因
+ *
+ *   ## RENAMED Requirements
+ *   - FROM: 2026-06-04-a1b2c3-old TO: 2026-06-04-a1b2c3-new
+ *
+ * Archive 时按 RENAMED→REMOVED→MODIFIED→ADDED 顺序应用：
+ *   - RENAMED: spec 文件改名 + frontmatter code 改写
+ *   - REMOVED: spec 文件移到 archive
+ *   - MODIFIED: 替换 section 内容
+ *   - ADDED: 创建新 spec
+ */
+import { existsSync, writeFileSync, readdirSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { readFrontmatter, writeFrontmatter } from './frontmatter.js';
+import { DeltaSpecSchema } from '../schemas/change.js';
+export function changeDir(paths, name) {
+    return join(paths.changesDir, name);
+}
+export function getChangeDir(paths, name) {
+    const root = changeDir(paths, name);
+    if (!existsSync(root))
+        return null;
+    const proposal = join(root, 'proposal.md');
+    const deltasDir = join(root, 'deltas');
+    const specsDir = join(root, 'specs');
+    const deltaFiles = existsSync(deltasDir)
+        ? readdirSync(deltasDir).filter(f => f.endsWith('.md')).map(f => join(deltasDir, f))
+        : [];
+    // 树形布局下,占位文件位置: changes/<name>/specs/<topic>/<code>/<code>.md
+    // 扁平,不在 change 内部再嵌套父链 — placeholder 只用于携带 level/parentCode
+    const specFiles = [];
+    if (existsSync(specsDir)) {
+        for (const topicEntry of readdirSync(specsDir, { withFileTypes: true })) {
+            if (!topicEntry.isDirectory() || topicEntry.name.startsWith('.'))
+                continue;
+            const topicDir = join(specsDir, topicEntry.name);
+            for (const specEntry of readdirSync(topicDir, { withFileTypes: true })) {
+                if (!specEntry.isDirectory() || specEntry.name.startsWith('.') || specEntry.name.startsWith('_'))
+                    continue;
+                const f = join(topicDir, specEntry.name, `${specEntry.name}.md`);
+                if (existsSync(f))
+                    specFiles.push(f);
+            }
+        }
+    }
+    return { root, proposal, deltaFiles, specFiles };
+}
+export function listChanges(paths) {
+    if (!existsSync(paths.changesDir))
+        return [];
+    return readdirSync(paths.changesDir)
+        .filter(f => !f.startsWith('.'))
+        .map(f => {
+        const root = join(paths.changesDir, f);
+        const proposalPath = join(root, 'proposal.md');
+        let created = '';
+        if (existsSync(proposalPath)) {
+            const { data } = readFrontmatter(proposalPath);
+            created = data.created ?? '';
+        }
+        return { name: f, root, created };
+    })
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * 解析一个 delta 文件为 ChangeEntry 列表。
+ * 一个 delta 文件可以含多个 ## ADDED/MODIFIED/REMOVED/RENAMED 段。
+ */
+export function parseDeltaFile(filePath) {
+    const { data, content } = readFrontmatter(filePath);
+    const fm = data;
+    if (!fm.code)
+        throw new Error(`Delta 文件 ${filePath} 缺 frontmatter code 字段`);
+    const entries = [];
+    // 按 ## XXX 段切分
+    const sections = content.split(/^## (ADDED|MODIFIED|REMOVED|RENAMED) Requirements$/m);
+    // sections[0] = 前言；sections[1] = 第一个 op 名；sections[2] = 第一个 op 内容；...
+    for (let i = 1; i < sections.length; i += 2) {
+        const op = sections[i];
+        const body = sections[i + 1] ?? '';
+        if (op === 'RENAMED') {
+            // 形如: - FROM: <old> TO: <new>
+            const matches = body.matchAll(/FROM:\s*(\S+)\s+TO:\s*(\S+)/g);
+            for (const m of matches) {
+                entries.push({ op, code: m[1], newCode: m[2] });
+            }
+        }
+        else if (op === 'REMOVED') {
+            // 形如: ### Requirement: <code>
+            // 或 - <code>: <reason>
+            const reqMatches = body.matchAll(/### Requirement:\s*(\S+)/g);
+            for (const m of reqMatches) {
+                entries.push({ op, code: m[1] });
+            }
+        }
+        else if (op === 'ADDED' || op === 'MODIFIED') {
+            // 形如: ### Requirement: <code>\n<content>\n
+            // 用 indexOf 找每个 ### Requirement: 起点和下一个段头终点
+            const reqRegex = /^### Requirement:\s*(\S+)$/gm;
+            let m;
+            const reqStarts = [];
+            while ((m = reqRegex.exec(body)) !== null) {
+                const code = m[1];
+                const bodyStart = m.index + m[0].length; // 跳过整行（含 \n）
+                reqStarts.push({ code, lineStart: m.index, bodyStart });
+            }
+            for (let i = 0; i < reqStarts.length; i++) {
+                const { code, bodyStart } = reqStarts[i];
+                const nextStart = i + 1 < reqStarts.length ? reqStarts[i + 1].lineStart : body.length;
+                const reqBody = body.slice(bodyStart, nextStart).trim();
+                if (op === 'ADDED') {
+                    // ADDED 必须含 title + content
+                    const titleMatch = reqBody.match(/^#+\s+(.+?)$/m);
+                    entries.push({
+                        op,
+                        code,
+                        title: titleMatch?.[1]?.trim(),
+                        content: reqBody,
+                        changeSummary: 'delta ADDED',
+                    });
+                }
+                else {
+                    // MODIFIED: 必有 content（新文）
+                    entries.push({
+                        op,
+                        code,
+                        content: reqBody,
+                        changeSummary: 'delta MODIFIED',
+                    });
+                }
+            }
+        }
+    }
+    return { specCode: fm.code, entries };
+}
+/**
+ * 解析整个 change 目录，返回结构化 DeltaSpec。
+ * 校验：每个 delta 文件的 specCode 必须和文件名一致；entry.code 必填。
+ */
+export function parseDeltaSpec(paths, name) {
+    const dir = getChangeDir(paths, name);
+    if (!dir)
+        throw new Error(`Change not found: ${name}`);
+    const allEntries = [];
+    for (const f of dir.deltaFiles) {
+        const { entries } = parseDeltaFile(f);
+        allEntries.push(...entries);
+    }
+    // 校验：entry.code 必填
+    for (const e of allEntries) {
+        if (!e.code)
+            throw new Error(`Delta entry 缺 code 字段：op=${e.op}`);
+    }
+    const result = {
+        name,
+        changes: allEntries,
+    };
+    return DeltaSpecSchema.parse(result);
+}
+export function createChange(input) {
+    if (!/^[a-z0-9-]+$/.test(input.name)) {
+        throw new Error(`change name 非法: ${input.name}（必须 ^[a-z0-9-]+$）`);
+    }
+    const root = changeDir(input.paths, input.name);
+    if (existsSync(root))
+        throw new Error(`Change 已存在: ${input.name}`);
+    mkdirSync(join(root, 'deltas'), { recursive: true });
+    mkdirSync(join(root, 'specs'), { recursive: true });
+    const proposalFile = join(root, 'proposal.md');
+    const now = new Date().toISOString();
+    const fm = {
+        name: input.name,
+        why: '',
+        scope: '',
+        created: now,
+    };
+    const content = renderProposalTemplate(input.name, input.description ?? '');
+    writeFileSync(proposalFile, writeFrontmatter(fm, content), 'utf8');
+    // 写 README 占位
+    const readme = join(root, 'README.md');
+    writeFileSync(readme, `# Change: ${input.name}\n\n创建于 ${now}\n`, 'utf8');
+    return { name: input.name, root, proposalFile };
+}
+function renderProposalTemplate(name, description) {
+    return `# ${name}
+
+> ${description || '（请填写 change 描述）'}
+
+## 为什么
+<!-- 这次变更的动机？要解决的痛点？ -->
+
+## 范围
+<!-- 影响哪些 topic / L1 / L2 / L3？ -->
+
+## 风险与回滚
+<!-- 失败时如何回滚？影响哪些 AC？ -->
+
+## 影响的需求
+<!-- 列出 affectedCriteria -->
+`;
+}
+/**
+ * 把 delta entry 渲染成可写的 delta 文件格式。
+ * 用户可以直接 edit 这个文件，然后再 archive。
+ */
+export function renderDeltaFile(specCode, entries) {
+    const fm = { code: specCode };
+    const body = [];
+    const grouped = {
+        ADDED: [], MODIFIED: [], REMOVED: [], RENAMED: [],
+    };
+    for (const e of entries)
+        grouped[e.op].push(e);
+    for (const op of ['ADDED', 'MODIFIED', 'REMOVED', 'RENAMED']) {
+        if (grouped[op].length === 0)
+            continue;
+        body.push(`## ${op} Requirements`);
+        body.push('');
+        for (const e of grouped[op]) {
+            if (op === 'RENAMED') {
+                body.push(`- FROM: ${e.code} TO: ${e.newCode}`);
+            }
+            else if (op === 'REMOVED') {
+                body.push(`### Requirement: ${e.code}`);
+                if (e.changeSummary)
+                    body.push(e.changeSummary);
+            }
+            else {
+                body.push(`### Requirement: ${e.code}`);
+                body.push('');
+                body.push(e.content ?? '（待填写）');
+            }
+            body.push('');
+        }
+    }
+    return writeFrontmatter(fm, body.join('\n'));
+}
+//# sourceMappingURL=delta.js.map

package/dist/core/delta.js.map

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

package/dist/core/dict.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 数据字典 — 外部系统元数据（表.字段 → 业务含义）
+ * 存储位置：.spec-manager/dict.yaml
+ * 格式：
+ *   <table>:
+ *     <field>:
+ *       meaning: <string>
+ *       updated: <iso>
+ */
+import type { ProjectPaths } from './paths.js';
+export interface DictEntry {
+    table: string;
+    field: string;
+    meaning: string;
+    updated: string;
+}
+export interface DictData {
+    [table: string]: {
+        [field: string]: Omit<DictEntry, 'table' | 'field'>;
+    };
+}
+export declare function readDict(paths: ProjectPaths): DictData;
+export declare function writeDict(paths: ProjectPaths, data: DictData): void;
+export declare function registerField(paths: ProjectPaths, table: string, field: string, meaning: string): DictData;
+export declare function queryField(paths: ProjectPaths, table: string, field: string): DictEntry | null;
+export declare function listFieldsByTable(paths: ProjectPaths, table: string): DictEntry[];
+export declare function listAllTables(paths: ProjectPaths): string[];
+//# sourceMappingURL=dict.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dict.d.ts","sourceRoot":"","sources":["../../src/core/dict.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,CAAC,KAAK,EAAE,MAAM,GAAG;QACf,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC;KACrD,CAAC;CACH;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,QAAQ,CAItD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAInE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAS1G;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAO9F;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,CAKjF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,EAAE,CAG3D"}

package/dist/core/dict.js

@@ -0,0 +1,57 @@
+/**
+ * 数据字典 — 外部系统元数据（表.字段 → 业务含义）
+ * 存储位置：.spec-manager/dict.yaml
+ * 格式：
+ *   <table>:
+ *     <field>:
+ *       meaning: <string>
+ *       updated: <iso>
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import YAML from 'yaml';
+export function readDict(paths) {
+    if (!existsSync(paths.dictFile))
+        return {};
+    const raw = readFileSync(paths.dictFile, 'utf8');
+    return YAML.parse(raw) ?? {};
+}
+export function writeDict(paths, data) {
+    const dir = dirname(paths.dictFile);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(paths.dictFile, YAML.stringify(data), 'utf8');
+}
+export function registerField(paths, table, field, meaning) {
+    const data = readDict(paths);
+    if (!data[table])
+        data[table] = {};
+    data[table][field] = {
+        meaning,
+        updated: new Date().toISOString(),
+    };
+    writeDict(paths, data);
+    return data;
+}
+export function queryField(paths, table, field) {
+    const data = readDict(paths);
+    const t = data[table];
+    if (!t)
+        return null;
+    const f = t[field];
+    if (!f)
+        return null;
+    return { table, field, ...f };
+}
+export function listFieldsByTable(paths, table) {
+    const data = readDict(paths);
+    const t = data[table];
+    if (!t)
+        return [];
+    return Object.entries(t).map(([field, v]) => ({ table, field, ...v }));
+}
+export function listAllTables(paths) {
+    const data = readDict(paths);
+    return Object.keys(data).sort();
+}
+//# sourceMappingURL=dict.js.map

package/dist/core/dict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dict.js","sourceRoot":"","sources":["../../src/core/dict.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AAgBxB,MAAM,UAAU,QAAQ,CAAC,KAAmB;IAC1C,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3C,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjD,OAAQ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAc,IAAI,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAmB,EAAE,IAAc;IAC3D,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAmB,EAAE,KAAa,EAAE,KAAa,EAAE,OAAe;IAC9F,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IACnC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG;QACnB,OAAO;QACP,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KAClC,CAAC;IACF,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAmB,EAAE,KAAa,EAAE,KAAa;IAC1E,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACnB,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAmB,EAAE,KAAa;IAClE,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAClB,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAmB;IAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAClC,CAAC"}

package/dist/core/frontmatter.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 读取文件，返回 { data, content }。
+ * data 是 YAML frontmatter，content 是正文（已剥离 frontmatter 标记）。
+ */
+export declare function readFrontmatter(filePath: string): {
+    data: Record<string, unknown>;
+    content: string;
+};
+/**
+ * 序列化：data + content → 带 frontmatter 的 markdown 字符串。
+ * gray-matter 不接受 undefined 值；递归剔除后再 dump。
+ */
+export declare function writeFrontmatter(data: Record<string, unknown>, content: string): string;
+/**
+ * 原子写：先写临时文件，再 rename。确保并发下不会读到半截内容。
+ */
+export declare function writeAtomic(filePath: string, raw: string): void;
+export declare function writeFrontmatterAtomic(filePath: string, data: Record<string, unknown>, content: string): void;
+//# sourceMappingURL=frontmatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/core/frontmatter.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAGpG;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAM/D;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7G"}

package/dist/core/frontmatter.js

@@ -0,0 +1,57 @@
+import matter from 'gray-matter';
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { randomBytes } from 'node:crypto';
+/**
+ * 读取文件，返回 { data, content }。
+ * data 是 YAML frontmatter，content 是正文（已剥离 frontmatter 标记）。
+ */
+export function readFrontmatter(filePath) {
+    const raw = readFileSync(filePath, 'utf8');
+    return matter(raw);
+}
+/**
+ * 序列化：data + content → 带 frontmatter 的 markdown 字符串。
+ * gray-matter 不接受 undefined 值；递归剔除后再 dump。
+ */
+export function writeFrontmatter(data, content) {
+    return matter.stringify(content, stripUndefined(data));
+}
+/**
+ * 原子写：先写临时文件，再 rename。确保并发下不会读到半截内容。
+ */
+export function writeAtomic(filePath, raw) {
+    const dir = dirname(filePath);
+    mkdirSync(dir, { recursive: true });
+    const tmp = join(dir, `.${randomBytes(6).toString('hex')}.tmp`);
+    writeFileSync(tmp, raw, 'utf8');
+    renameSync(tmp, filePath);
+}
+export function writeFrontmatterAtomic(filePath, data, content) {
+    writeAtomic(filePath, writeFrontmatter(data, content));
+}
+/** 序列化时跳过的字段（已废弃或由外部系统注入） */
+const FM_SKIP_KEYS = new Set(['project']);
+function stripUndefined(v) {
+    if (Array.isArray(v))
+        return v.map(stripUndefined);
+    if (v && typeof v === 'object') {
+        const out = {};
+        for (const [k, val] of Object.entries(v)) {
+            if (val === undefined)
+                continue;
+            if (FM_SKIP_KEYS.has(k))
+                continue;
+            const cleaned = stripUndefined(val);
+            // 跳过空数组和空字符串
+            if (Array.isArray(cleaned) && cleaned.length === 0)
+                continue;
+            if (cleaned === '')
+                continue;
+            out[k] = cleaned;
+        }
+        return out;
+    }
+    return v;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/core/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/core/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3C,OAAO,MAAM,CAAC,GAAG,CAA8B,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAA6B,EAAE,OAAe;IAC7E,OAAO,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAA4B,CAAC,CAAC;AACpF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,GAAW;IACvD,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9B,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChE,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAChC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAgB,EAAE,IAA6B,EAAE,OAAe;IACrG,WAAW,CAAC,QAAQ,EAAE,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,6BAA6B;AAC7B,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAE1C,SAAS,cAAc,CAAC,CAAU;IAChC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACnD,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAA4B,CAAC,EAAE,CAAC;YACpE,IAAI,GAAG,KAAK,SAAS;gBAAE,SAAS;YAChC,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,SAAS;YAClC,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;YACpC,aAAa;YACb,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAC7D,IAAI,OAAO,KAAK,EAAE;gBAAE,SAAS;YAC7B,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;QACnB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/core/incident.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Incident 记录
+ * 存储位置：.spec-manager/incidents/INC-YYYYMMDD-NNN.md
+ * frontmatter：id, ruleId, severity, status, created, specCode?, taskCode?
+ * 正文：触发场景、影响、临时修复、永久方案、关联 spec/task
+ */
+import type { ProjectPaths } from './paths.js';
+export type Severity = 'low' | 'medium' | 'high' | 'critical';
+export type IncidentStatus = 'open' | 'mitigated' | 'resolved' | 'closed';
+export interface IncidentRecord {
+    id: string;
+    fm: {
+        id: string;
+        ruleId: string;
+        severity: Severity;
+        status: IncidentStatus;
+        title: string;
+        specCode?: string;
+        taskCode?: string;
+        relatedDecisions?: string[];
+        created: string;
+        updated: string;
+    };
+    content: string;
+    filePath: string;
+}
+export declare function listIncidents(paths: ProjectPaths, opts?: {
+    status?: IncidentStatus;
+    relatedDecision?: string;
+}): IncidentRecord[];
+export declare function findIncident(paths: ProjectPaths, id: string): IncidentRecord | null;
+export declare function nextIncidentId(paths: ProjectPaths): string;
+export interface CreateIncidentInput {
+    paths: ProjectPaths;
+    ruleId: string;
+    severity: Severity;
+    title: string;
+    description?: string;
+    specCode?: string;
+    taskCode?: string;
+    relatedDecisions?: string[];
+}
+export declare function createIncident(input: CreateIncidentInput): IncidentRecord;
+export declare function updateIncidentStatus(paths: ProjectPaths, id: string, status: IncidentStatus, note?: string): IncidentRecord;
+//# sourceMappingURL=incident.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"incident.d.ts","sourceRoot":"","sources":["../../src/core/incident.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE;QACF,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,QAAQ,CAAC;QACnB,MAAM,EAAE,cAAc,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5B,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAKD,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,cAAc,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,cAAc,EAAE,CAajI;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAKnF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAa1D;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CA8BzE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,CAa3H"}