spectra-cli 4.1.1

package/dist/scripts/preuninstall.js

@@ -0,0 +1,62 @@
+/**
+ * preuninstall 脚本
+ * 全局卸载时清理 ~/.claude/skills/ 和/或 ~/.codex/skills/ 中已注册的 skill
+ * 复用 installer 模块的核心逻辑
+ */
+import { removeSkills, resolveTargetDir, } from '../installer/skill-installer.js';
+function resolvePreUninstallTargets() {
+    const env = process.env['REVERSE_SPEC_SKILL_TARGET'];
+    if (!env) {
+        // 默认清理双端，避免遗留
+        return ['claude', 'codex'];
+    }
+    const value = env.trim().toLowerCase();
+    if (value === 'both') {
+        return ['claude', 'codex'];
+    }
+    const values = value
+        .split(',')
+        .map((item) => item.trim())
+        .filter(Boolean);
+    const targets = new Set();
+    for (const item of values) {
+        if (item === 'claude' || item === 'codex') {
+            targets.add(item);
+        }
+    }
+    if (targets.size === 0) {
+        console.warn(`⚠ 警告: REVERSE_SPEC_SKILL_TARGET=${env} 无效，回退清理双端（可选: claude, codex, both）`);
+        return ['claude', 'codex'];
+    }
+    return [...targets];
+}
+function main() {
+    // 仅在全局卸载时执行
+    if (process.env['npm_config_global'] !== 'true') {
+        return;
+    }
+    try {
+        const targets = resolvePreUninstallTargets();
+        for (const platform of targets) {
+            const targetDir = resolveTargetDir('global', platform);
+            const summary = removeSkills({ targetDir, mode: 'global', platform });
+            const rootDir = platform === 'codex' ? '.codex' : '.claude';
+            const platformLabel = platform === 'codex' ? 'Codex' : 'Claude Code';
+            for (const result of summary.results) {
+                if (result.status === 'removed') {
+                    console.log(`✓ 已清理: ~/${rootDir}/skills/${result.skillName}/`);
+                }
+                else if (result.status === 'failed') {
+                    console.warn(`⚠ 警告: 清理 ${result.skillName} 失败: ${result.error ?? '未知错误'}`);
+                }
+            }
+            console.log(`spectra skills 已从 ${platformLabel} 注销`);
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.warn(`⚠ 警告: skill 注销失败: ${message}`);
+    }
+}
+main();
+//# sourceMappingURL=preuninstall.js.map

package/dist/scripts/preuninstall.js.map

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

package/dist/spec-store/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * spec-store 模块统一导出入口
+ *
+ * 封装 SpecStore 类和 SpecSourceKind 类型，
+ * 为所有消费方提供统一的 spec 集合查询接口。
+ */
+export { SpecStore, type IndexableModuleSpec, type SpecStoreOptions } from './spec-store.js';
+export { getDefaultSourceKind, type SpecSourceKind } from './spec-identity.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/spec-store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/spec-store/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,KAAK,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/spec-store/index.js

@@ -0,0 +1,9 @@
+/**
+ * spec-store 模块统一导出入口
+ *
+ * 封装 SpecStore 类和 SpecSourceKind 类型，
+ * 为所有消费方提供统一的 spec 集合查询接口。
+ */
+export { SpecStore } from './spec-store.js';
+export { getDefaultSourceKind } from './spec-identity.js';
+//# sourceMappingURL=index.js.map

package/dist/spec-store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/spec-store/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAmD,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAuB,MAAM,oBAAoB,CAAC"}

package/dist/spec-store/spec-identity.d.ts

@@ -0,0 +1,28 @@
+/**
+ * spec 身份标识类型与辅助函数
+ *
+ * 定义 SpecSourceKind 类型和 getDefaultSourceKind 辅助函数，
+ * 用于区分 canonical（权威原始）、derived（衍生）、bundle_copy（bundle 副本）。
+ */
+/**
+ * spec 身份类型
+ * - canonical：权威原始 spec，由 batch 生成并直接对应源代码模块
+ * - derived：从 canonical 派生的变体（如翻译版、摘要版），内容可能不同
+ * - bundle_copy：bundle 打包时原样复制的副本，内容与 canonical 完全一致
+ *
+ * 历史遗留 spec（缺少此字段）默认视为 canonical。
+ */
+export type SpecSourceKind = 'canonical' | 'derived' | 'bundle_copy';
+/**
+ * 将原始值（可能来自 frontmatter 解析）规范化为合法的 SpecSourceKind。
+ *
+ * 向后兼容规则：
+ * - 缺失值（undefined / null / ''）→ 'canonical'
+ * - 非法字符串 → 'canonical'
+ * - 合法的枚举值 → 原样返回
+ *
+ * @param value 待规范化的原始值
+ * @returns 合法的 SpecSourceKind，缺失或无效时返回 'canonical'
+ */
+export declare function getDefaultSourceKind(value?: string | null): SpecSourceKind;
+//# sourceMappingURL=spec-identity.d.ts.map

package/dist/spec-store/spec-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-identity.d.ts","sourceRoot":"","sources":["../../src/spec-store/spec-identity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,SAAS,GAAG,aAAa,CAAC;AAErE;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,cAAc,CAK1E"}

package/dist/spec-store/spec-identity.js

@@ -0,0 +1,24 @@
+/**
+ * spec 身份标识类型与辅助函数
+ *
+ * 定义 SpecSourceKind 类型和 getDefaultSourceKind 辅助函数，
+ * 用于区分 canonical（权威原始）、derived（衍生）、bundle_copy（bundle 副本）。
+ */
+/**
+ * 将原始值（可能来自 frontmatter 解析）规范化为合法的 SpecSourceKind。
+ *
+ * 向后兼容规则：
+ * - 缺失值（undefined / null / ''）→ 'canonical'
+ * - 非法字符串 → 'canonical'
+ * - 合法的枚举值 → 原样返回
+ *
+ * @param value 待规范化的原始值
+ * @returns 合法的 SpecSourceKind，缺失或无效时返回 'canonical'
+ */
+export function getDefaultSourceKind(value) {
+    if (value === 'canonical' || value === 'derived' || value === 'bundle_copy') {
+        return value;
+    }
+    return 'canonical';
+}
+//# sourceMappingURL=spec-identity.js.map

package/dist/spec-store/spec-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-identity.js","sourceRoot":"","sources":["../../src/spec-store/spec-identity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAqB;IACxD,IAAI,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,aAAa,EAAE,CAAC;QAC5E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/spec-store/spec-store.d.ts

@@ -0,0 +1,62 @@
+import type { ModuleSpec } from '../models/module-spec.js';
+import type { StoredModuleSpecSummary, ExistingSpecDocument } from '../panoramic/builders/doc-graph-builder.js';
+import type { IndexableModuleSpec } from '../generator/index-generator.js';
+import { type SpecSourceKind } from './spec-identity.js';
+export type { IndexableModuleSpec };
+export interface SpecStoreOptions {
+    /** 本次 batch 生成的 spec 列表 */
+    currentSpecs: ModuleSpec[];
+    /** 磁盘已有的 spec 摘要列表（来自 scanStoredModuleSpecs） */
+    storedSpecs: StoredModuleSpecSummary[];
+    /** 项目根目录绝对路径（用于 orphan 判断） */
+    projectRoot: string;
+    /** 将绝对路径转为项目相对路径的工具函数 */
+    toProjectPath: (absPath: string) => string;
+    /**
+     * 文件存在性检查函数（可注入，用于测试）
+     * 生产环境默认使用 fs.existsSync
+     */
+    existsFn?: (filePath: string) => boolean;
+}
+export declare class SpecStore {
+    private readonly mergedMap;
+    private readonly orphans;
+    private readonly currentSpecPaths;
+    private readonly storedSpecsInput;
+    private readonly currentSpecsInput;
+    constructor(options: SpecStoreOptions);
+    /**
+     * 返回本次生成 + 历史存储的合集，已去重。
+     * 默认：排除 orphan + 排除 sourceKind 为 bundle_copy/derived 的 spec。
+     */
+    allKnownSpecs(options?: {
+        includeOrphans?: boolean;
+        includeNonCanonical?: boolean;
+    }): IndexableModuleSpec[];
+    /** 仅返回本次运行中新生成的 spec，不含历史缓存。 */
+    currentRunSpecs(): ModuleSpec[];
+    /**
+     * 返回磁盘中存在但本次未重新生成的 spec 摘要。
+     * 可按 sourceKind 过滤。
+     */
+    storedOnlySpecs(options?: {
+        sourceKind?: SpecSourceKind;
+    }): StoredModuleSpecSummary[];
+    /** 返回磁盘上存在但对应源文件已不存在的 spec 摘要列表。 */
+    orphanSpecs(): StoredModuleSpecSummary[];
+    /**
+     * 替代原来直接传 collectedModuleSpecs + existingStoredSpecs 的调用方式。
+     * currentRunSpecs → moduleSpecs（标记 currentRun: true）
+     * storedSpecs（非本次生成，已过滤 orphan）→ existingSpecs
+     */
+    asDocGraphInput(): {
+        moduleSpecs: ModuleSpec[];
+        existingSpecs: ExistingSpecDocument[];
+    };
+    /**
+     * 所有已知 canonical spec 的总数（排除 orphan）。
+     * 等价于 allKnownSpecs().length，但语义更明确。
+     */
+    totalKnownCount(): number;
+}
+//# sourceMappingURL=spec-store.d.ts.map

package/dist/spec-store/spec-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-store.d.ts","sourceRoot":"","sources":["../../src/spec-store/spec-store.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,0BAA0B,CAAC;AAE5E,OAAO,KAAK,EACV,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,4CAA4C,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAO/E,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAMpC,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,gDAAgD;IAChD,WAAW,EAAE,uBAAuB,EAAE,CAAC;IACvC,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;CAC1C;AAMD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAc;IAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA4B;IAC7D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAe;gBAErC,OAAO,EAAE,gBAAgB;IAiFrC;;;OAGG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE;QACtB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,GAAG,mBAAmB,EAAE;IA8BzB,gCAAgC;IAChC,eAAe,IAAI,UAAU,EAAE;IAQ/B;;;OAGG;IACH,eAAe,CAAC,OAAO,CAAC,EAAE;QACxB,UAAU,CAAC,EAAE,cAAc,CAAC;KAC7B,GAAG,uBAAuB,EAAE;IAuB7B,oCAAoC;IACpC,WAAW,IAAI,uBAAuB,EAAE;IAUxC;;;;OAIG;IACH,eAAe,IAAI;QACjB,WAAW,EAAE,UAAU,EAAE,CAAC;QAC1B,aAAa,EAAE,oBAAoB,EAAE,CAAC;KACvC;IAqCD;;;OAGG;IACH,eAAe,IAAI,MAAM;CAG1B"}

package/dist/spec-store/spec-store.js

@@ -0,0 +1,201 @@
+/**
+ * SpecStore — spec 集合统一查询入口
+ *
+ * 封装"本次生成 + 历史存储 + orphan 识别 + 身份过滤"，
+ * 泛化自 batch-orchestrator.ts 的 mergeIndexSpecs 私有函数。
+ * 所有消费方必须通过此类获取 spec 集合，不得自行合并。
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { getSpectraVersionString } from '../generator/frontmatter.js';
+import { getDefaultSourceKind } from './spec-identity.js';
+// ============================================================
+// SpecStore 类实现
+// ============================================================
+export class SpecStore {
+    mergedMap;
+    orphans;
+    currentSpecPaths;
+    storedSpecsInput;
+    currentSpecsInput;
+    constructor(options) {
+        const { currentSpecs, storedSpecs, projectRoot, toProjectPath } = options;
+        const existsFn = options.existsFn ?? fs.existsSync;
+        this.storedSpecsInput = storedSpecs;
+        this.currentSpecsInput = currentSpecs;
+        this.mergedMap = new Map();
+        this.orphans = new Set();
+        this.currentSpecPaths = new Set();
+        // 迁移自 batch-orchestrator.ts mergeIndexSpecs（第 912-966 行）的合并逻辑：
+        // 1. 先插入磁盘已存储的 spec（有 skeletonHash 校验）
+        for (const storedSpec of storedSpecs) {
+            // 原 mergeIndexSpecs 中的 skeletonHash 存在性检查：无 hash 则跳过
+            if (!storedSpec.skeletonHash) {
+                continue;
+            }
+            // 从 storedSpec 构造 IndexableModuleSpec，将 sourceKind 携带进 frontmatter
+            // 这样 allKnownSpecs() 的 sourceKind 过滤才能正确工作
+            const storedSourceKind = storedSpec.sourceKind;
+            const frontmatterFromStored = {
+                type: 'module-spec',
+                version: storedSpec.version ?? 'v1',
+                generatedBy: getSpectraVersionString(),
+                sourceTarget: storedSpec.sourceTarget,
+                relatedFiles: storedSpec.relatedFiles,
+                lastUpdated: new Date().toISOString(),
+                confidence: storedSpec.confidence ?? 'medium',
+                skeletonHash: storedSpec.skeletonHash,
+                language: storedSpec.language,
+                crossLanguageRefs: storedSpec.crossLanguageRefs,
+            };
+            if (storedSourceKind !== undefined) {
+                frontmatterFromStored.sourceKind = storedSourceKind;
+            }
+            this.mergedMap.set(storedSpec.outputPath, {
+                frontmatter: frontmatterFromStored,
+                outputPath: storedSpec.outputPath,
+                intentSummary: storedSpec.intentSummary,
+            });
+        }
+        // 2. 用本次生成的 spec 覆盖（同一 outputPath 时本次生成优先）
+        for (const currentSpec of currentSpecs) {
+            const normalizedOutputPath = path.isAbsolute(currentSpec.outputPath)
+                ? toProjectPath(path.resolve(currentSpec.outputPath))
+                : currentSpec.outputPath;
+            this.mergedMap.set(normalizedOutputPath, {
+                frontmatter: currentSpec.frontmatter,
+                outputPath: normalizedOutputPath,
+                sections: {
+                    intent: currentSpec.sections.intent,
+                },
+            });
+            this.currentSpecPaths.add(normalizedOutputPath);
+        }
+        // 3. Orphan 检测：仅对 canonical（或字段缺失）的 storedSpec 做文件存在性检查
+        for (const storedSpec of storedSpecs) {
+            const sourceKind = getDefaultSourceKind(storedSpec.sourceKind);
+            // bundle_copy 和 derived 的派生 spec 不做 orphan 判断（其源是另一个 spec，不是代码文件）
+            if (sourceKind !== 'canonical') {
+                continue;
+            }
+            const absoluteSourceTarget = path.join(projectRoot, storedSpec.sourceTarget);
+            if (!existsFn(absoluteSourceTarget)) {
+                this.orphans.add(storedSpec.outputPath);
+            }
+        }
+    }
+    // ============================================================
+    // 视图 1：所有已知 spec（canonical，排除 orphan 和非 canonical）
+    // ============================================================
+    /**
+     * 返回本次生成 + 历史存储的合集，已去重。
+     * 默认：排除 orphan + 排除 sourceKind 为 bundle_copy/derived 的 spec。
+     */
+    allKnownSpecs(options) {
+        const includeOrphans = options?.includeOrphans ?? false;
+        const includeNonCanonical = options?.includeNonCanonical ?? false;
+        return [...this.mergedMap.values()]
+            .filter((spec) => {
+            // orphan 过滤
+            if (!includeOrphans && this.orphans.has(spec.outputPath)) {
+                return false;
+            }
+            // sourceKind 身份过滤（从 frontmatter 中读取，缺失默认为 canonical）
+            if (!includeNonCanonical) {
+                const sourceKind = getDefaultSourceKind(spec.frontmatter.sourceKind);
+                if (sourceKind !== 'canonical') {
+                    return false;
+                }
+            }
+            return true;
+        })
+            .sort((a, b) => a.outputPath.localeCompare(b.outputPath));
+    }
+    // ============================================================
+    // 视图 2：本次 batch 生成的 spec
+    // ============================================================
+    /** 仅返回本次运行中新生成的 spec，不含历史缓存。 */
+    currentRunSpecs() {
+        return [...this.currentSpecsInput];
+    }
+    // ============================================================
+    // 视图 3：磁盘已有的 spec（不含本次生成的部分）
+    // ============================================================
+    /**
+     * 返回磁盘中存在但本次未重新生成的 spec 摘要。
+     * 可按 sourceKind 过滤。
+     */
+    storedOnlySpecs(options) {
+        return this.storedSpecsInput.filter((storedSpec) => {
+            // 排除本次已生成的路径（outputPath 规范化后已在 currentSpecPaths 中）
+            if (this.currentSpecPaths.has(storedSpec.outputPath)) {
+                return false;
+            }
+            // 按 sourceKind 过滤（若有）
+            if (options?.sourceKind !== undefined) {
+                const actualKind = getDefaultSourceKind(storedSpec.sourceKind);
+                if (actualKind !== options.sourceKind) {
+                    return false;
+                }
+            }
+            return true;
+        });
+    }
+    // ============================================================
+    // 视图 4：orphan spec（源文件已不存在的磁盘 spec）
+    // ============================================================
+    /** 返回磁盘上存在但对应源文件已不存在的 spec 摘要列表。 */
+    orphanSpecs() {
+        return this.storedSpecsInput.filter((storedSpec) => this.orphans.has(storedSpec.outputPath));
+    }
+    // ============================================================
+    // 辅助方法：转为 buildDocGraph 所需的输入参数
+    // ============================================================
+    /**
+     * 替代原来直接传 collectedModuleSpecs + existingStoredSpecs 的调用方式。
+     * currentRunSpecs → moduleSpecs（标记 currentRun: true）
+     * storedSpecs（非本次生成，已过滤 orphan）→ existingSpecs
+     */
+    asDocGraphInput() {
+        // existingSpecs：仅包含 canonical + 非 orphan 的存储 spec，且不含本次生成的（避免重复）
+        const existingSpecs = this.storedSpecsInput
+            .filter((storedSpec) => {
+            // 排除 orphan
+            if (this.orphans.has(storedSpec.outputPath)) {
+                return false;
+            }
+            // 排除本次已生成（doc-graph-builder 会从 moduleSpecs 中取，不需要再放进 existingSpecs）
+            if (this.currentSpecPaths.has(storedSpec.outputPath)) {
+                return false;
+            }
+            // 排除 bundle_copy / derived（docGraph 只处理 canonical spec）
+            const sourceKind = getDefaultSourceKind(storedSpec.sourceKind);
+            if (sourceKind !== 'canonical') {
+                return false;
+            }
+            return true;
+        })
+            .map((storedSpec) => ({
+            specPath: storedSpec.specPath,
+            sourceTarget: storedSpec.sourceTarget,
+            relatedFiles: storedSpec.relatedFiles,
+            linked: storedSpec.linked,
+            confidence: storedSpec.confidence,
+        }));
+        return {
+            moduleSpecs: this.currentSpecsInput,
+            existingSpecs,
+        };
+    }
+    // ============================================================
+    // 辅助方法：canonical spec 总数（排除 orphan）
+    // ============================================================
+    /**
+     * 所有已知 canonical spec 的总数（排除 orphan）。
+     * 等价于 allKnownSpecs().length，但语义更明确。
+     */
+    totalKnownCount() {
+        return this.allKnownSpecs().length;
+    }
+}
+//# sourceMappingURL=spec-store.js.map

package/dist/spec-store/spec-store.js.map

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

package/dist/utils/atomic-write.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 原子写入 JSON 数据到文件
+ * 先写临时文件再 rename，防止写入中断导致数据损坏
+ * .tmp 残留由 renameSync 覆盖，无需预清理
+ *
+ * @param filePath - 目标文件路径
+ * @param data - 要序列化为 JSON 的数据
+ */
+export declare function writeAtomicJson(filePath: string, data: unknown): void;
+//# sourceMappingURL=atomic-write.d.ts.map

package/dist/utils/atomic-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.d.ts","sourceRoot":"","sources":["../../src/utils/atomic-write.ts"],"names":[],"mappings":"AAQA;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAarE"}

package/dist/utils/atomic-write.js

@@ -0,0 +1,27 @@
+/**
+ * 原子写入工具函数
+ * 从 checkpoint.ts 的 saveCheckpoint() 提取通用原子写入逻辑
+ * 核心流程：解析绝对路径 → 创建目录 → 写 .tmp → renameSync 原子替换
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * 原子写入 JSON 数据到文件
+ * 先写临时文件再 rename，防止写入中断导致数据损坏
+ * .tmp 残留由 renameSync 覆盖，无需预清理
+ *
+ * @param filePath - 目标文件路径
+ * @param data - 要序列化为 JSON 的数据
+ */
+export function writeAtomicJson(filePath, data) {
+    const resolvedPath = path.resolve(filePath);
+    const dir = path.dirname(resolvedPath);
+    // 确保目录存在
+    fs.mkdirSync(dir, { recursive: true });
+    // 原子写入：先写临时文件
+    const tmpPath = `${resolvedPath}.tmp`;
+    const content = JSON.stringify(data, null, 2);
+    fs.writeFileSync(tmpPath, content, 'utf-8');
+    fs.renameSync(tmpPath, resolvedPath);
+}
+//# sourceMappingURL=atomic-write.js.map

package/dist/utils/atomic-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.js","sourceRoot":"","sources":["../../src/utils/atomic-write.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,IAAa;IAC7D,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAEvC,SAAS;IACT,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvC,cAAc;IACd,MAAM,OAAO,GAAG,GAAG,YAAY,MAAM,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAE9C,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AACvC,CAAC"}

package/dist/utils/chunk-splitter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 超大文件分块策略
+ * 当文件超过 5k LOC 时，按函数边界分割，返回带元数据的分块数组（FR-005）
+ */
+/** 分块阈值：5000 行 */
+export declare const CHUNK_THRESHOLD = 5000;
+/** 单个分块 */
+export interface Chunk {
+    /** 分块索引（从 0 开始） */
+    index: number;
+    /** 总分块数 */
+    totalChunks: number;
+    /** 分块内容 */
+    content: string;
+    /** 起始行号（1-based） */
+    startLine: number;
+    /** 结束行号（1-based） */
+    endLine: number;
+    /** 行数 */
+    lineCount: number;
+    /** 分块中包含的顶层函数/类名称 */
+    symbols: string[];
+}
+/**
+ * 将文件内容按函数边界分块
+ *
+ * @param content - 文件完整内容
+ * @param maxLinesPerChunk - 每个分块的目标最大行数（默认与阈值相同）
+ * @returns 分块数组，如果文件不超过阈值则返回单元素数组
+ */
+export declare function splitIntoChunks(content: string, maxLinesPerChunk?: number): Chunk[];
+//# sourceMappingURL=chunk-splitter.d.ts.map

package/dist/utils/chunk-splitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-splitter.d.ts","sourceRoot":"","sources":["../../src/utils/chunk-splitter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kBAAkB;AAClB,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC,WAAW;AACX,MAAM,WAAW,KAAK;IACpB,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AA6DD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,gBAAgB,GAAE,MAAwB,GACzC,KAAK,EAAE,CA0DT"}

package/dist/utils/chunk-splitter.js

@@ -0,0 +1,116 @@
+/**
+ * 超大文件分块策略
+ * 当文件超过 5k LOC 时，按函数边界分割，返回带元数据的分块数组（FR-005）
+ */
+/** 分块阈值：5000 行 */
+export const CHUNK_THRESHOLD = 5000;
+/**
+ * 检测顶层函数/类声明的正则模式
+ * 匹配 export function, export class, export interface, export type, export const 等
+ */
+const TOP_LEVEL_DECL_RE = /^(?:export\s+)?(?:default\s+)?(?:abstract\s+)?(?:async\s+)?(?:function|class|interface|type|enum|const|let|var)\s+(\w+)/;
+/**
+ * 查找函数边界（寻找以 } 结尾的行作为函数/类的结束位置）
+ * 在 threshold 附近寻找最近的边界
+ */
+function findBoundary(lines, targetLine) {
+    // 在目标行前后 200 行范围内寻找最佳分割点
+    const searchRadius = 200;
+    const start = Math.max(0, targetLine - searchRadius);
+    const end = Math.min(lines.length - 1, targetLine + searchRadius);
+    let bestBoundary = targetLine;
+    let bestDistance = Infinity;
+    for (let i = start; i <= end; i++) {
+        const trimmed = lines[i].trim();
+        // 寻找顶层声明的开头作为分割点（在下一行开始新分块）
+        if (TOP_LEVEL_DECL_RE.test(trimmed) && i > 0) {
+            const distance = Math.abs(i - targetLine);
+            if (distance < bestDistance) {
+                bestDistance = distance;
+                bestBoundary = i; // 在声明之前分割
+            }
+        }
+        // 或者寻找仅有 } 的行（函数/类结束）
+        if (trimmed === '}' || trimmed === '};') {
+            const distance = Math.abs(i - targetLine);
+            if (distance < bestDistance) {
+                bestDistance = distance;
+                bestBoundary = i + 1; // 在 } 之后分割
+            }
+        }
+    }
+    return bestBoundary;
+}
+/**
+ * 提取分块中的顶层符号名称
+ */
+function extractSymbols(lines) {
+    const symbols = [];
+    for (const line of lines) {
+        const match = TOP_LEVEL_DECL_RE.exec(line);
+        if (match?.[1]) {
+            symbols.push(match[1]);
+        }
+    }
+    return symbols;
+}
+/**
+ * 将文件内容按函数边界分块
+ *
+ * @param content - 文件完整内容
+ * @param maxLinesPerChunk - 每个分块的目标最大行数（默认与阈值相同）
+ * @returns 分块数组，如果文件不超过阈值则返回单元素数组
+ */
+export function splitIntoChunks(content, maxLinesPerChunk = CHUNK_THRESHOLD) {
+    const lines = content.split('\n');
+    const totalLines = lines.length;
+    // 不需要分块
+    if (totalLines <= CHUNK_THRESHOLD) {
+        return [
+            {
+                index: 0,
+                totalChunks: 1,
+                content,
+                startLine: 1,
+                endLine: totalLines,
+                lineCount: totalLines,
+                symbols: extractSymbols(lines),
+            },
+        ];
+    }
+    // 需要分块
+    const chunks = [];
+    let currentStart = 0;
+    while (currentStart < totalLines) {
+        let currentEnd;
+        if (currentStart + maxLinesPerChunk >= totalLines) {
+            // 最后一块
+            currentEnd = totalLines;
+        }
+        else {
+            // 在函数边界处分割
+            currentEnd = findBoundary(lines, currentStart + maxLinesPerChunk);
+            // 确保至少前进一些行，防止无限循环
+            if (currentEnd <= currentStart) {
+                currentEnd = currentStart + maxLinesPerChunk;
+            }
+        }
+        const chunkLines = lines.slice(currentStart, currentEnd);
+        chunks.push({
+            index: chunks.length,
+            totalChunks: 0, // 稍后回填
+            content: chunkLines.join('\n'),
+            startLine: currentStart + 1, // 1-based
+            endLine: currentEnd,
+            lineCount: chunkLines.length,
+            symbols: extractSymbols(chunkLines),
+        });
+        currentStart = currentEnd;
+    }
+    // 回填 totalChunks
+    for (const chunk of chunks) {
+        chunk.totalChunks = chunks.length;
+    }
+    return chunks;
+}
+//# sourceMappingURL=chunk-splitter.js.map

package/dist/utils/chunk-splitter.js.map

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