spectra-cli 4.1.1 → 4.2.0

package/dist/knowledge-graph/module-derivation.js.map

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

package/dist/knowledge-graph/persistence.d.ts

@@ -0,0 +1,270 @@
+import { z } from 'zod';
+import { type UnifiedGraph } from './unified-graph.js';
+/** SnapshotWrapper 自身版本（与内嵌 UnifiedGraph.metadata.schemaVersion 解耦） */
+export declare const SNAPSHOT_WRAPPER_VERSION: "1.0";
+/**
+ * SnapshotWrapper schema — `.spectra/unified-graph.json` 的顶层结构。
+ *
+ * 字段定义参见 spec.md §4.2：
+ *   schemaVersion: SnapshotWrapper 自身版本（升版时本字段 bump）
+ *   generatedAt:   ISO 8601 datetime
+ *   graph:         完整 UnifiedGraph（不裁剪 symbol 节点）
+ *   fileHashes:    绝对路径 → 该文件内容的 SHA-256 hex
+ */
+export declare const SnapshotWrapperSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    generatedAt: z.ZodString;
+    graph: z.ZodObject<{
+        nodes: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            kind: z.ZodEnum<["module", "package", "component", "service", "spec", "document", "api", "api-schema", "event", "diagram", "symbol"]>;
+            language: z.ZodOptional<z.ZodString>;
+            filePath: z.ZodOptional<z.ZodString>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "symbol" | "module" | "package" | "component" | "service" | "spec" | "document" | "api" | "api-schema" | "event" | "diagram";
+            id: string;
+            label: string;
+            filePath?: string | undefined;
+            language?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }, {
+            kind: "symbol" | "module" | "package" | "component" | "service" | "spec" | "document" | "api" | "api-schema" | "event" | "diagram";
+            id: string;
+            label: string;
+            filePath?: string | undefined;
+            language?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }>, "many">;
+        edges: z.ZodArray<z.ZodEffects<z.ZodObject<{
+            source: z.ZodString;
+            target: z.ZodString;
+            relation: z.ZodEnum<["calls", "depends-on", "cross-module", "contains", "documents", "references", "conceptually_related_to", "rationale_for", "groups", "deploys"]>;
+            confidence: z.ZodEnum<["high", "medium", "low"]>;
+            directional: z.ZodOptional<z.ZodBoolean>;
+            evidence: z.ZodOptional<z.ZodString>;
+            weight: z.ZodOptional<z.ZodNumber>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            source: string;
+            target: string;
+            relation: "cross-module" | "calls" | "depends-on" | "contains" | "documents" | "references" | "conceptually_related_to" | "rationale_for" | "groups" | "deploys";
+            confidence: "high" | "medium" | "low";
+            metadata?: Record<string, unknown> | undefined;
+            directional?: boolean | undefined;
+            evidence?: string | undefined;
+            weight?: number | undefined;
+        }, {
+            source: string;
+            target: string;
+            relation: "cross-module" | "calls" | "depends-on" | "contains" | "documents" | "references" | "conceptually_related_to" | "rationale_for" | "groups" | "deploys";
+            confidence: "high" | "medium" | "low";
+            metadata?: Record<string, unknown> | undefined;
+            directional?: boolean | undefined;
+            evidence?: string | undefined;
+            weight?: number | undefined;
+        }>, {
+            source: string;
+            target: string;
+            relation: "cross-module" | "calls" | "depends-on" | "contains" | "documents" | "references" | "conceptually_related_to" | "rationale_for" | "groups" | "deploys";
+            confidence: "high" | "medium" | "low";
+            metadata?: Record<string, unknown> | undefined;
+            directional?: boolean | undefined;
+            evidence?: string | undefined;
+            weight?: number | undefined;
+        }, {
+            source: string;
+            target: string;
+            relation: "cross-module" | "calls" | "depends-on" | "contains" | "documents" | "references" | "conceptually_related_to" | "rationale_for" | "groups" | "deploys";
+            confidence: "high" | "medium" | "low";
+            metadata?: Record<string, unknown> | undefined;
+            directional?: boolean | undefined;
+            evidence?: string | undefined;
+            weight?: number | undefined;
+        }>, "many">;
+        metadata: z.ZodObject<{
+            generatedAt: z.ZodString;
+            projectRoot: z.ZodString;
+            schemaVersion: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            generatedAt: string;
+            projectRoot: string;
+            schemaVersion: string;
+        }, {
+            generatedAt: string;
+            projectRoot: string;
+            schemaVersion: string;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        metadata: {
+            generatedAt: string;
+            projectRoot: string;
+            schemaVersion: string;
+        };
+        nodes: {
+            kind: "symbol" | "module" | "package" | "component" | "service" | "spec" | "document" | "api" | "api-schema" | "event" | "diagram";
+            id: string;
+            label: string;
+            filePath?: string | undefined;
+            language?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }[];
+        edges: {
+            source: string;
+            target: string;
+            relation: "cross-module" | "calls" | "depends-on" | "contains" | "documents" | "references" | "conceptually_related_to" | "rationale_for" | "groups" | "deploys";
+            confidence: "high" | "medium" | "low";
+            metadata?: Record<string, unknown> | undefined;
+            directional?: boolean | undefined;
+            evidence?: string | undefined;
+            weight?: number | undefined;
+        }[];
+    }, {
+        metadata: {
+            generatedAt: string;
+            projectRoot: string;
+            schemaVersion: string;
+        };
+        nodes: {
+            kind: "symbol" | "module" | "package" | "component" | "service" | "spec" | "document" | "api" | "api-schema" | "event" | "diagram";
+            id: string;
+            label: string;
+            filePath?: string | undefined;
+            language?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }[];
+        edges: {
+            source: string;
+            target: string;
+            relation: "cross-module" | "calls" | "depends-on" | "contains" | "documents" | "references" | "conceptually_related_to" | "rationale_for" | "groups" | "deploys";
+            confidence: "high" | "medium" | "low";
+            metadata?: Record<string, unknown> | undefined;
+            directional?: boolean | undefined;
+            evidence?: string | undefined;
+            weight?: number | undefined;
+        }[];
+    }>;
+    fileHashes: z.ZodRecord<z.ZodString, z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    generatedAt: string;
+    schemaVersion: "1.0";
+    graph: {
+        metadata: {
+            generatedAt: string;
+            projectRoot: string;
+            schemaVersion: string;
+        };
+        nodes: {
+            kind: "symbol" | "module" | "package" | "component" | "service" | "spec" | "document" | "api" | "api-schema" | "event" | "diagram";
+            id: string;
+            label: string;
+            filePath?: string | undefined;
+            language?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }[];
+        edges: {
+            source: string;
+            target: string;
+            relation: "cross-module" | "calls" | "depends-on" | "contains" | "documents" | "references" | "conceptually_related_to" | "rationale_for" | "groups" | "deploys";
+            confidence: "high" | "medium" | "low";
+            metadata?: Record<string, unknown> | undefined;
+            directional?: boolean | undefined;
+            evidence?: string | undefined;
+            weight?: number | undefined;
+        }[];
+    };
+    fileHashes: Record<string, string>;
+}, {
+    generatedAt: string;
+    schemaVersion: "1.0";
+    graph: {
+        metadata: {
+            generatedAt: string;
+            projectRoot: string;
+            schemaVersion: string;
+        };
+        nodes: {
+            kind: "symbol" | "module" | "package" | "component" | "service" | "spec" | "document" | "api" | "api-schema" | "event" | "diagram";
+            id: string;
+            label: string;
+            filePath?: string | undefined;
+            language?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }[];
+        edges: {
+            source: string;
+            target: string;
+            relation: "cross-module" | "calls" | "depends-on" | "contains" | "documents" | "references" | "conceptually_related_to" | "rationale_for" | "groups" | "deploys";
+            confidence: "high" | "medium" | "low";
+            metadata?: Record<string, unknown> | undefined;
+            directional?: boolean | undefined;
+            evidence?: string | undefined;
+            weight?: number | undefined;
+        }[];
+    };
+    fileHashes: Record<string, string>;
+}>;
+export type SnapshotWrapper = z.infer<typeof SnapshotWrapperSchema>;
+/** 给定项目根，计算 `.spectra/unified-graph.json` 的绝对路径 */
+export declare function snapshotPath(projectRoot: string): string;
+/**
+ * 计算单个文件内容的 SHA-256 hex digest。
+ * 文件不存在时返回 null（让 detectStaleFiles 决定如何处理 deleted 路径）。
+ */
+export declare function computeFileHash(absPath: string): Promise<string | null>;
+/**
+ * 批量计算文件 hash（串行执行，clarify Q-D4 决议；与 SHA-256 计算量比较，IO 是瓶颈，并行收益有限）。
+ *
+ * @param files 绝对路径数组
+ * @returns 路径 → hash 的 record；不存在的文件不出现在 record 中
+ */
+export declare function computeAllFileHashes(_projectRoot: string, files: string[]): Promise<Record<string, string>>;
+/**
+ * 持久化 SnapshotWrapper 到 `.spectra/unified-graph.json`。
+ *
+ * 写入策略（FR-5 / spec NG-3 amendment / W1 v3 多进程 tradeoff）：
+ *   1. mkdir -p .spectra/
+ *   2. JSON.stringify(snapshot, null, 2) → 写入 unified-graph.<pid>.tmp
+ *   3. fs.rename(tmp, target) — POSIX rename 是原子操作
+ * 多进程并发场景：`<pid>` 区分各进程的 tmp，rename 后写者覆盖前者；
+ * 不会出现部分写入的损坏文件（worst case：丢失某次写入，可接受）。
+ *
+ * @param snapshot 要写入的 SnapshotWrapper（建议先经 schema 校验）
+ * @param projectRoot 项目根目录（绝对或相对路径均可，内部会 resolve）
+ */
+export declare function saveSnapshot(snapshot: SnapshotWrapper, projectRoot: string): Promise<void>;
+/**
+ * 读取并 safeParse `.spectra/unified-graph.json`。
+ *
+ * 返回 null 的 4 种情况（均不抛异常，让调用方触发 full re-index）：
+ *   1. 文件不存在
+ *   2. JSON 解析失败（磁盘损坏、手动编辑出错）
+ *   3. SnapshotWrapperSchema.safeParse 失败（schema 漂移、版本不匹配）
+ *   4. 内嵌 UnifiedGraphSchema 校验失败
+ *
+ * 降级原因写入 stdout（machine-readable JSON line），方便上游脚本判断。
+ */
+export declare function loadSnapshot(projectRoot: string): Promise<SnapshotWrapper | null>;
+/**
+ * 比对 snapshot 中的 fileHashes 与磁盘实际 hash，找出需要重索引的文件集合。
+ *
+ * stale 判定规则（覆盖 EC-9）：
+ *   - 当前文件存在 + hash 与 snapshot 记录不同 → stale（需重索引）
+ *   - 当前文件存在 + snapshot 中无记录 → stale（新增文件）
+ *   - 当前文件不存在 + snapshot 中有记录 → stale（被 rename / delete 的旧路径）
+ *   - 当前文件存在 + hash 与 snapshot 一致 → 不 stale（可复用）
+ *
+ * @param snapshot 已加载的 SnapshotWrapper
+ * @param currentFiles 当前项目扫描出的源文件绝对路径列表
+ * @returns 需要重索引的绝对路径集合（含新增 / 修改 / 删除三类）
+ */
+export declare function detectStaleFiles(snapshot: SnapshotWrapper, currentFiles: string[]): Promise<string[]>;
+/**
+ * 把一个 UnifiedGraph + 文件 hash 表打包成 SnapshotWrapper。
+ *
+ * @param graph 已构建的 UnifiedGraph
+ * @param fileHashes 路径 → SHA-256 hex
+ */
+export declare function buildSnapshotWrapper(graph: UnifiedGraph, fileHashes: Record<string, string>): SnapshotWrapper;
+//# sourceMappingURL=persistence.d.ts.map

package/dist/knowledge-graph/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../src/knowledge-graph/persistence.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAM3E,uEAAuE;AACvE,eAAO,MAAM,wBAAwB,EAAG,KAAc,CAAC;AAEvD;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AASpE,mDAAmD;AACnD,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAExD;AAMD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS7E;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CASjC;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,eAAe,EACzB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAyCvF;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,eAAe,EACzB,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,MAAM,EAAE,CAAC,CA6BnB;AAMD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,eAAe,CAOjB"}

package/dist/knowledge-graph/persistence.js

@@ -0,0 +1,226 @@
+/**
+ * Feature 156 W2 — UnifiedGraph snapshot 持久化层。
+ *
+ * 提供 .spectra/unified-graph.json 的读写 + 文件 hash 索引能力，
+ * 让 `spectra index` 命令在多次运行之间复用图结构（FR-1 ~ FR-5、FR-30、AC-9）。
+ *
+ * 关键设计决策：
+ * - 写盘格式 = pretty JSON（clarify Q1 决议；调试友好，1 MB 量级 parse/stringify < 50 ms）
+ * - 不裁剪 symbol 节点（clarify Q2 决议；保留完整 UnifiedGraph 让 caller expansion 精确到 symbol 粒度）
+ * - 原子写入 = 临时文件 + rename（process.pid 区分多进程，"最后写者胜"语义）
+ * - SnapshotWrapperSchema 是独立的 Zod schema，**不修改** UnifiedGraphSchema（NG-3）
+ * - load 失败 / corruption / schemaVersion 不匹配 → 返回 null，由调用方触发 full re-index（EC-3 / EC-8）
+ * - 跨 worktree 隔离（EC-11）：每个 worktree 各自的 projectRoot/.spectra/，互不共享
+ *
+ * Spec v3.2 W1 → W2 handoff：SnapshotWrapper 必须**完整透传** UnifiedEdge.metadata 字段
+ * （含 `importType`），不允许像 panoramic graph-builder 序列化路径那样静默丢失结构化扩展数据。
+ * 本模块直接序列化 UnifiedGraph（走 Zod schema 派生 → JSON.stringify），天然保留所有字段。
+ */
+import * as fs from 'node:fs';
+import * as fsp from 'node:fs/promises';
+import * as path from 'node:path';
+import { createHash, randomBytes } from 'node:crypto';
+import { z } from 'zod';
+import { UnifiedGraphSchema } from './unified-graph.js';
+// ───────────────────────────────────────────────────────────
+// Schema
+// ───────────────────────────────────────────────────────────
+/** SnapshotWrapper 自身版本（与内嵌 UnifiedGraph.metadata.schemaVersion 解耦） */
+export const SNAPSHOT_WRAPPER_VERSION = '1.0';
+/**
+ * SnapshotWrapper schema — `.spectra/unified-graph.json` 的顶层结构。
+ *
+ * 字段定义参见 spec.md §4.2：
+ *   schemaVersion: SnapshotWrapper 自身版本（升版时本字段 bump）
+ *   generatedAt:   ISO 8601 datetime
+ *   graph:         完整 UnifiedGraph（不裁剪 symbol 节点）
+ *   fileHashes:    绝对路径 → 该文件内容的 SHA-256 hex
+ */
+export const SnapshotWrapperSchema = z.object({
+    schemaVersion: z.literal(SNAPSHOT_WRAPPER_VERSION),
+    generatedAt: z.string().datetime(),
+    graph: UnifiedGraphSchema,
+    fileHashes: z.record(z.string(), z.string()),
+});
+// ───────────────────────────────────────────────────────────
+// 路径常量
+// ───────────────────────────────────────────────────────────
+const SNAPSHOT_DIR = '.spectra';
+const SNAPSHOT_FILENAME = 'unified-graph.json';
+/** 给定项目根，计算 `.spectra/unified-graph.json` 的绝对路径 */
+export function snapshotPath(projectRoot) {
+    return path.join(path.resolve(projectRoot), SNAPSHOT_DIR, SNAPSHOT_FILENAME);
+}
+// ───────────────────────────────────────────────────────────
+// Hash 工具（FR-2 SHA-256）
+// ───────────────────────────────────────────────────────────
+/**
+ * 计算单个文件内容的 SHA-256 hex digest。
+ * 文件不存在时返回 null（让 detectStaleFiles 决定如何处理 deleted 路径）。
+ */
+export async function computeFileHash(absPath) {
+    try {
+        const content = await fsp.readFile(absPath);
+        return createHash('sha256').update(content).digest('hex');
+    }
+    catch (err) {
+        // 文件不存在 / 权限错误等 → 返回 null
+        void err;
+        return null;
+    }
+}
+/**
+ * 批量计算文件 hash（串行执行，clarify Q-D4 决议；与 SHA-256 计算量比较，IO 是瓶颈，并行收益有限）。
+ *
+ * @param files 绝对路径数组
+ * @returns 路径 → hash 的 record；不存在的文件不出现在 record 中
+ */
+export async function computeAllFileHashes(_projectRoot, files) {
+    const out = {};
+    for (const f of files) {
+        const h = await computeFileHash(f);
+        if (h !== null) {
+            out[f] = h;
+        }
+    }
+    return out;
+}
+// ───────────────────────────────────────────────────────────
+// save（FR-1 / FR-5 原子写入）
+// ───────────────────────────────────────────────────────────
+/**
+ * 持久化 SnapshotWrapper 到 `.spectra/unified-graph.json`。
+ *
+ * 写入策略（FR-5 / spec NG-3 amendment / W1 v3 多进程 tradeoff）：
+ *   1. mkdir -p .spectra/
+ *   2. JSON.stringify(snapshot, null, 2) → 写入 unified-graph.<pid>.tmp
+ *   3. fs.rename(tmp, target) — POSIX rename 是原子操作
+ * 多进程并发场景：`<pid>` 区分各进程的 tmp，rename 后写者覆盖前者；
+ * 不会出现部分写入的损坏文件（worst case：丢失某次写入，可接受）。
+ *
+ * @param snapshot 要写入的 SnapshotWrapper（建议先经 schema 校验）
+ * @param projectRoot 项目根目录（绝对或相对路径均可，内部会 resolve）
+ */
+export async function saveSnapshot(snapshot, projectRoot) {
+    const targetPath = snapshotPath(projectRoot);
+    const dir = path.dirname(targetPath);
+    await fsp.mkdir(dir, { recursive: true });
+    // pretty JSON（clarify Q1）
+    const content = JSON.stringify(snapshot, null, 2);
+    // 含 pid + 随机后缀的唯一 tmp 名，多进程 / 同进程并发时都不互相覆盖 tmp
+    // （单进程同 pid 多次并发调用 saveSnapshot 时单纯用 pid 会导致 tmp 路径冲突）
+    const tmpPath = path.join(dir, `${SNAPSHOT_FILENAME}.${process.pid}.${randomBytes(4).toString('hex')}.tmp`);
+    await fsp.writeFile(tmpPath, content, 'utf-8');
+    // POSIX rename 原子覆盖目标文件
+    await fsp.rename(tmpPath, targetPath);
+}
+// ───────────────────────────────────────────────────────────
+// load（FR-3 / EC-8 corruption 降级）
+// ───────────────────────────────────────────────────────────
+/**
+ * 读取并 safeParse `.spectra/unified-graph.json`。
+ *
+ * 返回 null 的 4 种情况（均不抛异常，让调用方触发 full re-index）：
+ *   1. 文件不存在
+ *   2. JSON 解析失败（磁盘损坏、手动编辑出错）
+ *   3. SnapshotWrapperSchema.safeParse 失败（schema 漂移、版本不匹配）
+ *   4. 内嵌 UnifiedGraphSchema 校验失败
+ *
+ * 降级原因写入 stdout（machine-readable JSON line），方便上游脚本判断。
+ */
+export async function loadSnapshot(projectRoot) {
+    const targetPath = snapshotPath(projectRoot);
+    let raw;
+    try {
+        raw = await fsp.readFile(targetPath, 'utf-8');
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'ENOENT') {
+            return null; // 文件不存在 — 静默返回 null，调用方触发 full re-index
+        }
+        // 其他读错误（权限等）记录后降级
+        process.stdout.write(`${JSON.stringify({ event: 'snapshot-load-fallback', fallbackReason: 'read-error', error: String(err) })}\n`);
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        process.stdout.write(`${JSON.stringify({ event: 'snapshot-load-fallback', fallbackReason: 'json-parse-error', error: String(err) })}\n`);
+        return null;
+    }
+    const result = SnapshotWrapperSchema.safeParse(parsed);
+    if (!result.success) {
+        process.stdout.write(`${JSON.stringify({
+            event: 'snapshot-load-fallback',
+            fallbackReason: 'schema-validation-failed',
+            issues: result.error.issues.slice(0, 3).map((i) => ({ path: i.path, message: i.message })),
+        })}\n`);
+        return null;
+    }
+    return result.data;
+}
+// ───────────────────────────────────────────────────────────
+// stale 检测（FR-3 / EC-9 rename-delete）
+// ───────────────────────────────────────────────────────────
+/**
+ * 比对 snapshot 中的 fileHashes 与磁盘实际 hash，找出需要重索引的文件集合。
+ *
+ * stale 判定规则（覆盖 EC-9）：
+ *   - 当前文件存在 + hash 与 snapshot 记录不同 → stale（需重索引）
+ *   - 当前文件存在 + snapshot 中无记录 → stale（新增文件）
+ *   - 当前文件不存在 + snapshot 中有记录 → stale（被 rename / delete 的旧路径）
+ *   - 当前文件存在 + hash 与 snapshot 一致 → 不 stale（可复用）
+ *
+ * @param snapshot 已加载的 SnapshotWrapper
+ * @param currentFiles 当前项目扫描出的源文件绝对路径列表
+ * @returns 需要重索引的绝对路径集合（含新增 / 修改 / 删除三类）
+ */
+export async function detectStaleFiles(snapshot, currentFiles) {
+    const stale = new Set();
+    const currentSet = new Set(currentFiles);
+    // (1) 检查当前文件：新增或 hash 不一致 → stale
+    for (const f of currentFiles) {
+        const oldHash = snapshot.fileHashes[f];
+        const newHash = await computeFileHash(f);
+        if (newHash === null) {
+            // 文件读不到（罕见：扫描时存在但现在消失）→ 视为 deleted
+            if (oldHash !== undefined)
+                stale.add(f);
+            continue;
+        }
+        if (oldHash === undefined || oldHash !== newHash) {
+            stale.add(f);
+        }
+    }
+    // (2) 检查 snapshot 中存在但当前已不存在的路径 → deleted（也算 stale，调用方需移除节点）
+    for (const oldPath of Object.keys(snapshot.fileHashes)) {
+        if (!currentSet.has(oldPath)) {
+            // 若 currentFiles 已包含则跳过（避免重复）
+            if (!fs.existsSync(oldPath)) {
+                stale.add(oldPath);
+            }
+        }
+    }
+    return Array.from(stale).sort();
+}
+// ───────────────────────────────────────────────────────────
+// Helper：构建一个完整的 SnapshotWrapper（供 spectra index 命令使用）
+// ───────────────────────────────────────────────────────────
+/**
+ * 把一个 UnifiedGraph + 文件 hash 表打包成 SnapshotWrapper。
+ *
+ * @param graph 已构建的 UnifiedGraph
+ * @param fileHashes 路径 → SHA-256 hex
+ */
+export function buildSnapshotWrapper(graph, fileHashes) {
+    return {
+        schemaVersion: SNAPSHOT_WRAPPER_VERSION,
+        generatedAt: new Date().toISOString(),
+        graph,
+        fileHashes,
+    };
+}
+//# sourceMappingURL=persistence.js.map

package/dist/knowledge-graph/persistence.js.map

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