@co-engram/core 0.1.4 → 0.1.6

package/dist/retrieval/sqlite-orchestrator.js.map

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

package/dist/storage/bootstrap.d.ts

@@ -0,0 +1,31 @@
+import type { Language } from "../i18n/index.js";
+import { type SearchEngine, type SearchEngineType } from "../retrieval/search-engine.js";
+import { EngramRepository } from "./repository.js";
+import { IndexDb } from "./index-db.js";
+export interface BootstrapOptions {
+    readonly dataRoot: string;
+    readonly language?: Language;
+    /** 注入 env(测试用);默认 process.env */
+    readonly env?: NodeJS.ProcessEnv;
+}
+export interface BootstrapResult {
+    readonly repository: EngramRepository;
+    readonly searchEngine: SearchEngine;
+    readonly engineType: SearchEngineType;
+    /** SQLite 模式下的 indexDb 引用;memory 模式为 undefined。host 持有以在
+     *  关闭时显式 close()(进程退出时 OS 自动回收 fd,但测试 / 显式资源管理
+     *  需要确定性释放)。 */
+    readonly indexDb?: IndexDb;
+}
+/**
+ * 装配 EngramRepository + SearchEngine。
+ *
+ * Engine 选择:env.CO_ENGRAM_SEARCH_ENGINE=sqlite → SQLite FTS5 模式;
+ * 未设置 / 其他值 → 默认 memory(in-memory Intl.Segmenter)。
+ *
+ * Cold start 行为(sqlite 模式):db 为空时,从 repository.listEngrams()
+ * 枚举全量 engram,readEngram() 读详情,转 EngramIndexEntry[] 后
+ * rebuildFromEntries() 一次性灌入。已有数据的 db 不重建。
+ */
+export declare function bootstrapRepositoryAndSearch(opts: BootstrapOptions): BootstrapResult;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/storage/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/storage/bootstrap.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAyB,MAAM,eAAe,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,iCAAiC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC;;oBAEgB;IAChB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,gBAAgB,GACrB,eAAe,CAkDjB"}

package/dist/storage/bootstrap.js

@@ -0,0 +1,89 @@
+// packages/core/src/storage/bootstrap.ts
+//
+// 装配 EngramRepository + SearchEngine —— 把 host adapter(claude-code-mcp /
+// openclaw-plugin)共用的初始化逻辑抽到 core,避免双宿主行为漂移。
+//
+// 默认行为(memory 模式)完全等同此前各 host 内联的 new SearchOrchestrator()
+// + rebuildSearchIndex。sqlite 模式额外做:
+//   1. 打开 .co-engram/index.db(WAL,首次自动建 schema)
+//   2. 把 indexDb 注入 EngramRepository(开启 write-through)
+//   3. Cold start:db 为空时从 engrams/*.md 全量重建索引
+//   4. 用 SqliteSearchEngineAdapter 包装 SearchEngine
+//
+// @module @co-engram/core/storage
+import { existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { createSearchEngine, resolveSearchEngineType, } from "../retrieval/search-engine.js";
+import { EngramRepository } from "./repository.js";
+import { IndexDb } from "./index-db.js";
+/**
+ * 装配 EngramRepository + SearchEngine。
+ *
+ * Engine 选择:env.CO_ENGRAM_SEARCH_ENGINE=sqlite → SQLite FTS5 模式;
+ * 未设置 / 其他值 → 默认 memory(in-memory Intl.Segmenter)。
+ *
+ * Cold start 行为(sqlite 模式):db 为空时,从 repository.listEngrams()
+ * 枚举全量 engram,readEngram() 读详情,转 EngramIndexEntry[] 后
+ * rebuildFromEntries() 一次性灌入。已有数据的 db 不重建。
+ */
+export function bootstrapRepositoryAndSearch(opts) {
+    const engineType = resolveSearchEngineType(opts.env);
+    if (engineType === "sqlite") {
+        const dbDir = join(opts.dataRoot, ".co-engram");
+        if (!existsSync(dbDir))
+            mkdirSync(dbDir, { recursive: true });
+        const dbPath = join(dbDir, "index.db");
+        const indexDb = new IndexDb({ dbPath });
+        indexDb.open();
+        // 先构造 repository with indexDb,write-through 在后续所有写入路径生效
+        const repository = new EngramRepository({
+            rootPath: opts.dataRoot,
+            ...(opts.language ? { language: opts.language } : {}),
+        }, indexDb);
+        // Cold start:db 空时全量重建
+        const count = indexDb.prepare("SELECT count(*) as n FROM engrams").get();
+        if (count.n === 0) {
+            const entries = [];
+            // listEngrams 返回 EngramCatalogEntry[],取 .id 作为 readEngram 入参
+            for (const catalog of repository.listEngrams()) {
+                try {
+                    const engram = repository.readEngram(catalog.id);
+                    if (!engram)
+                        continue;
+                    entries.push(engramToIndexEntry(engram));
+                }
+                catch {
+                    // 跳过损坏 engram;doctor 自愈路径会单独处理
+                }
+            }
+            indexDb.rebuildFromEntries(entries);
+        }
+        const searchEngine = createSearchEngine({ type: "sqlite", indexDb });
+        return { repository, searchEngine, engineType, indexDb };
+    }
+    // memory 模式:行为与原 host 内联代码等价
+    const repository = new EngramRepository({
+        rootPath: opts.dataRoot,
+        ...(opts.language ? { language: opts.language } : {}),
+    });
+    const searchEngine = createSearchEngine({ type: "memory" });
+    return { repository, searchEngine, engineType };
+}
+/** Engram → EngramIndexEntry 投影(与 repository.syncEngramToIndex 同义) */
+function engramToIndexEntry(e) {
+    return {
+        id: e.id,
+        title: e.title,
+        kind: e.kind,
+        importance: e.importance,
+        confidence: e.confidence,
+        updatedAt: Date.parse(e.updatedAt),
+        contentSize: e.contentSize,
+        visibility: e.visibility,
+        status: e.status,
+        domainTags: [...e.domainTags],
+        summary: e.summary,
+        contentTokens: e.content,
+    };
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/storage/bootstrap.js.map

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

package/dist/storage/engram-index.d.ts

@@ -58,6 +58,15 @@ export declare function buildIndexEntryFromFrontmatter(params: {
  * - frontmatter 缺 id 的 .md 跳过(由 doctor 报告为 orphan_markdown)
  */
 export declare function rebuildEngramIndex(dataRoot: string, onOrphan?: (relativePath: string) => void): EngramIndexMap;
+/**
+ * 收集 dataRoot 下所有 .md 文件(跳过 SKIP_DIRECTORIES 与 SKIP_MARKDOWN_FILENAMES)。
+ *
+ * 与 rebuildEngramIndex 共用同一份"哪些目录/文件不扫"规则,确保 watcher 的
+ * 外部提案扫描与索引重建看到一致的文件集合。
+ *
+ * @returns 绝对路径数组(无特定顺序)
+ */
+export declare function collectMarkdownFiles(dataRoot: string): string[];
 /**
  * 增量更新:仅更新单条 engram 的 index entry。
  */

package/dist/storage/engram-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engram-index.d.ts","sourceRoot":"","sources":["../../src/storage/engram-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAaH,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAEjB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAE3B,0BAA0B;AAC1B,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAEhD,4BAA4B;AAC5B,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AAyBzD,6BAA6B;AAC7B,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,gCAAgC;AAChC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;IACxD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,gBAAgB;AAChB,wBAAgB,sBAAsB,IAAI,cAAc,CAMvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAwBhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,cAAc,GACpB,IAAI,CAaN;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IACrD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,GAAG,gBAAgB,CA6BnB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,GACxC,cAAc,CAgDhB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,gBAAgB,GACtB,cAAc,CAGhB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,EACrB,EAAE,EAAE,cAAc,GACjB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,EACrB,YAAY,EAAE,MAAM,GACnB,cAAc,GAAG,SAAS,CAK5B"}
+{"version":3,"file":"engram-index.d.ts","sourceRoot":"","sources":["../../src/storage/engram-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAaH,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAEjB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAE3B,0BAA0B;AAC1B,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAEhD,4BAA4B;AAC5B,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AAyBzD,6BAA6B;AAC7B,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,gCAAgC;AAChC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;IACxD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,gBAAgB;AAChB,wBAAgB,sBAAsB,IAAI,cAAc,CAMvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAwBhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,cAAc,GACpB,IAAI,CAaN;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IACrD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,GAAG,gBAAgB,CA6BnB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,GACxC,cAAc,CAgDhB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAwB/D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,gBAAgB,GACtB,cAAc,CAGhB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,EACrB,EAAE,EAAE,cAAc,GACjB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,EACrB,YAAY,EAAE,MAAM,GACnB,cAAc,GAAG,SAAS,CAK5B"}

package/dist/storage/engram-index.js

@@ -189,6 +189,44 @@ export function rebuildEngramIndex(dataRoot, onOrphan) {
     index.lastRebuiltAt = new Date().toISOString();
     return index;
 }
+/**
+ * 收集 dataRoot 下所有 .md 文件(跳过 SKIP_DIRECTORIES 与 SKIP_MARKDOWN_FILENAMES)。
+ *
+ * 与 rebuildEngramIndex 共用同一份"哪些目录/文件不扫"规则,确保 watcher 的
+ * 外部提案扫描与索引重建看到一致的文件集合。
+ *
+ * @returns 绝对路径数组(无特定顺序)
+ */
+export function collectMarkdownFiles(dataRoot) {
+    const out = [];
+    function walk(currentDir) {
+        let entries;
+        try {
+            entries = readdirSync(currentDir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (SKIP_DIRECTORIES.has(entry.name))
+                continue;
+            const absolutePath = join(currentDir, entry.name);
+            if (entry.isDirectory()) {
+                walk(absolutePath);
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            if (!entry.name.endsWith(".md"))
+                continue;
+            if (SKIP_MARKDOWN_FILENAMES.has(entry.name.toLowerCase()))
+                continue;
+            out.push(absolutePath);
+        }
+    }
+    walk(dataRoot);
+    return out;
+}
 /**
  * 增量更新:仅更新单条 engram 的 index entry。
  */

package/dist/storage/engram-index.js.map

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

package/dist/storage/index-cleanup.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 派生索引 dangling reference 自愈(post-doctor cleanup)。
+ *
+ * 触发场景:
+ *   - 用户外部删除 .md 文件(git rm / rm / IDE 删除)
+ *   - runDoctor 清理 engram-index.json(去除 missing_file entry)
+ *   - **但**派生索引(observation-windows.jsonl / digest.jsonl / graph.json)
+ *     仍保留被删 engram 的 id → engram_search 返回 stale 结果 / viewer 显示重影
+ *
+ * 本模块在 runDoctor 完成后运行,基于 canonicalIds 清除这些悬空引用。
+ *
+ * 设计:
+ *   - 纯函数,失败不抛(返回空 issues),让上层 doctor 主流程继续
+ *   - 幂等(过滤逻辑重复运行结果一致)
+ *   - 廉价:observation-windows 直接过滤;digest/graph 检测到悬空才 fullRebuild
+ *
+ * 检查范围:
+ *   1. observation-windows.jsonl  — filter in-place by engramId
+ *   2. digest.jsonl + graph.json  — 检测到悬空则触发 IndexOrchestrator.fullRebuild
+ *
+ * 不检查(无 engram id 引用):
+ *   - topic-clusters.jsonl — 引用 cluster.id(短 hash),与 engram 无关
+ *   - proposals.jsonl      — entityId = cluster.id 或外部 .md path,非 engram id
+ *   - prompt-signals.json  — 字段是 tag 字符串
+ *   - audit.jsonl          — append-only 历史日志,不应清理
+ *
+ * @module @co-engram/core/storage
+ */
+import type { EngramRepository } from "./repository.js";
+import type { DoctorIssue } from "../types/repository-types.js";
+export interface IndexCleanupResult {
+    readonly fixes: readonly DoctorIssue[];
+}
+/**
+ * 清除派生索引中对已不存在 engram 的引用。
+ *
+ * 在 runDoctor 完成后调用 —— 此时 engram-index.json 已被刷新,
+ * canonicalIds 应来自 readEngramIndex(dataRoot).entries 或等价途径。
+ */
+export declare function cleanupDanglingIndexReferences(params: {
+    readonly repo: EngramRepository;
+    readonly dataRoot: string;
+    readonly canonicalIds: ReadonlySet<string>;
+}): IndexCleanupResult;
+//# sourceMappingURL=index-cleanup.d.ts.map

package/dist/storage/index-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-cleanup.d.ts","sourceRoot":"","sources":["../../src/storage/index-cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;CACxC;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IACrD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC5C,GAAG,kBAAkB,CAgBrB"}

package/dist/storage/index-cleanup.js

@@ -0,0 +1,186 @@
+/**
+ * 派生索引 dangling reference 自愈(post-doctor cleanup)。
+ *
+ * 触发场景:
+ *   - 用户外部删除 .md 文件(git rm / rm / IDE 删除)
+ *   - runDoctor 清理 engram-index.json(去除 missing_file entry)
+ *   - **但**派生索引(observation-windows.jsonl / digest.jsonl / graph.json)
+ *     仍保留被删 engram 的 id → engram_search 返回 stale 结果 / viewer 显示重影
+ *
+ * 本模块在 runDoctor 完成后运行,基于 canonicalIds 清除这些悬空引用。
+ *
+ * 设计:
+ *   - 纯函数,失败不抛(返回空 issues),让上层 doctor 主流程继续
+ *   - 幂等(过滤逻辑重复运行结果一致)
+ *   - 廉价:observation-windows 直接过滤;digest/graph 检测到悬空才 fullRebuild
+ *
+ * 检查范围:
+ *   1. observation-windows.jsonl  — filter in-place by engramId
+ *   2. digest.jsonl + graph.json  — 检测到悬空则触发 IndexOrchestrator.fullRebuild
+ *
+ * 不检查(无 engram id 引用):
+ *   - topic-clusters.jsonl — 引用 cluster.id(短 hash),与 engram 无关
+ *   - proposals.jsonl      — entityId = cluster.id 或外部 .md path,非 engram id
+ *   - prompt-signals.json  — 字段是 tag 字符串
+ *   - audit.jsonl          — append-only 历史日志,不应清理
+ *
+ * @module @co-engram/core/storage
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { IndexOrchestrator, defaultCachePath } from "../index/orchestrator.js";
+/**
+ * 清除派生索引中对已不存在 engram 的引用。
+ *
+ * 在 runDoctor 完成后调用 —— 此时 engram-index.json 已被刷新,
+ * canonicalIds 应来自 readEngramIndex(dataRoot).entries 或等价途径。
+ */
+export function cleanupDanglingIndexReferences(params) {
+    const { repo, dataRoot, canonicalIds } = params;
+    const fixes = [];
+    const cachePath = defaultCachePath(dataRoot);
+    const windowsFix = cleanupObservationWindows(cachePath, canonicalIds);
+    if (windowsFix)
+        fixes.push(windowsFix);
+    const digestGraphFix = rebuildDigestGraphIfStale(repo, cachePath, canonicalIds);
+    if (digestGraphFix)
+        fixes.push(digestGraphFix);
+    return { fixes };
+}
+/**
+ * 过滤 observation-windows.jsonl,删除 engramId 不在 canonicalIds 中的行。
+ *
+ * 文件格式:JSONL,每行 { id, engramId, query, score, hitAt, deadline, kind, status }。
+ * 直接 in-place 重写(append-mostly 日志,过滤是正确语义)。
+ */
+function cleanupObservationWindows(cachePath, canonicalIds) {
+    const filePath = join(cachePath, "observation-windows.jsonl");
+    if (!existsSync(filePath))
+        return null;
+    let raw;
+    try {
+        raw = readFileSync(filePath, "utf8");
+    }
+    catch {
+        return null;
+    }
+    const lines = raw.split("\n");
+    let removed = 0;
+    const kept = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let isDangling = false;
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (typeof parsed.engramId === "string" &&
+                !canonicalIds.has(parsed.engramId)) {
+                isDangling = true;
+            }
+        }
+        catch {
+            // 保留无法解析的行(让 audit / 人工检查)
+        }
+        if (isDangling) {
+            removed++;
+            continue;
+        }
+        kept.push(trimmed);
+    }
+    if (removed === 0)
+        return null;
+    try {
+        mkdirSync(dirname(filePath), { recursive: true });
+        writeFileSync(filePath, kept.length > 0 ? kept.join("\n") + "\n" : "", "utf8");
+    }
+    catch {
+        return null;
+    }
+    return {
+        kind: "dangling_index_reference",
+        path: filePath,
+        message: `Removed ${removed} dangling observation window(s) whose engramId no longer exists`,
+        autoFixed: true,
+    };
+}
+/**
+ * 检测 digest.jsonl 与 graph.json 中的 dangling engram id。
+ *
+ * 若发现任何悬空,触发 IndexOrchestrator.fullRebuild
+ * (fullRebuild 一次性重建 digest + graph,保证二者一致)。
+ *
+ * 检测代价:O(digest 行数 + graph 节点数 + graph 边数)。
+ * 重建代价:仅在检测到悬空时才发生,常见路径(doctored 之后的稳态)开销为 0。
+ */
+function rebuildDigestGraphIfStale(repo, cachePath, canonicalIds) {
+    const digestPath = join(cachePath, "digest.jsonl");
+    const graphPath = join(cachePath, "graph.json");
+    let digestDangling = 0;
+    let graphDangling = 0;
+    if (existsSync(digestPath)) {
+        try {
+            const raw = readFileSync(digestPath, "utf8");
+            for (const line of raw.split("\n")) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                try {
+                    const parsed = JSON.parse(trimmed);
+                    if (typeof parsed.id === "string" && !canonicalIds.has(parsed.id)) {
+                        digestDangling++;
+                    }
+                }
+                catch {
+                    // 跳过无效行(不是 dangling,只是损坏 — 让别处报)
+                }
+            }
+        }
+        catch {
+            // 读失败:当作无 dangling,跳过
+        }
+    }
+    if (existsSync(graphPath)) {
+        try {
+            const raw = readFileSync(graphPath, "utf8");
+            const parsed = JSON.parse(raw);
+            for (const node of parsed.nodes ?? []) {
+                if (typeof node.id === "string" && !canonicalIds.has(node.id)) {
+                    graphDangling++;
+                }
+            }
+            for (const edge of parsed.edges ?? []) {
+                if (typeof edge.from === "string" && !canonicalIds.has(edge.from)) {
+                    graphDangling++;
+                }
+                if (typeof edge.to === "string" && !canonicalIds.has(edge.to)) {
+                    graphDangling++;
+                }
+            }
+        }
+        catch {
+            // 读失败:当作无 dangling,跳过
+        }
+    }
+    if (digestDangling === 0 && graphDangling === 0)
+        return null;
+    try {
+        const orchestrator = new IndexOrchestrator(repo, cachePath);
+        const result = orchestrator.fullRebuild();
+        return {
+            kind: "dangling_index_reference",
+            path: cachePath,
+            message: `Rebuilt stale derived indexes (digest had ${digestDangling} dangling entr${digestDangling === 1 ? "y" : "ies"}, graph had ${graphDangling} dangling ref${graphDangling === 1 ? "" : "s"}; rebuild produced digest=${result.digest.total}, graph nodes=${result.graph.nodes}, edges=${result.graph.edges})`,
+            autoFixed: true,
+        };
+    }
+    catch {
+        return {
+            kind: "dangling_index_reference",
+            path: cachePath,
+            message: `Detected ${digestDangling} dangling digest entry/${graphDangling} dangling graph ref but fullRebuild failed (check logs)`,
+            autoFixed: false,
+        };
+    }
+}
+//# sourceMappingURL=index-cleanup.js.map

package/dist/storage/index-cleanup.js.map

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

package/dist/storage/index-db-cursor.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 稳定排序键:importance DESC, updatedAt DESC, id ASC
+ *
+ * cursor 是 opaque base64url token,encode 当前页最后一条的 sort key,
+ * 让下一页查询能"接着"这个位置往后取(避免 offset 漂移导致的数据跳过/重复)。
+ *
+ * 选择 base64url 而非 base64:cursor 经常出现在 URL query string,
+ * base64url 无需 URL encode(+ / = 等特殊字符)。
+ */
+export interface SortKey {
+    readonly importance: number;
+    readonly updatedAt: number;
+    readonly id: string;
+}
+export declare function encodeCursor(key: SortKey): string;
+export declare function decodeCursor(cursor: string): SortKey;
+/**
+ * 比较两个 sort key,返回 -1 / 0 / 1。
+ * 返回 -1 表示 a 排在 b 前面;1 表示 a 排在 b 后面;0 表示相等。
+ *
+ * 顺序:importance 大→小;同分 updatedAt 新→旧;再同分 id 字典序升序(稳定)。
+ *
+ * 用于 cursor 分页:取出 cursor 之后,过滤掉所有 compareSortKey(key, cursor) <= 0 的项
+ * (cursor 之前或等于的项跳过),从下一个开始取。
+ */
+export declare function compareSortKey(a: SortKey, b: SortKey): number;
+//# sourceMappingURL=index-db-cursor.d.ts.map

package/dist/storage/index-db-cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-db-cursor.d.ts","sourceRoot":"","sources":["../../src/storage/index-db-cursor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,OAAO;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAIjD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAwBpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,CAK7D"}

package/dist/storage/index-db-cursor.js

@@ -0,0 +1,59 @@
+/**
+ * 稳定排序键:importance DESC, updatedAt DESC, id ASC
+ *
+ * cursor 是 opaque base64url token,encode 当前页最后一条的 sort key,
+ * 让下一页查询能"接着"这个位置往后取(避免 offset 漂移导致的数据跳过/重复)。
+ *
+ * 选择 base64url 而非 base64:cursor 经常出现在 URL query string,
+ * base64url 无需 URL encode(+ / = 等特殊字符)。
+ */
+export function encodeCursor(key) {
+    // 用数组而非 object:更紧凑,且避免 key 顺序歧义
+    const json = JSON.stringify([key.importance, key.updatedAt, key.id]);
+    return Buffer.from(json, "utf8").toString("base64url");
+}
+export function decodeCursor(cursor) {
+    if (!cursor)
+        throw new Error("invalid cursor: empty");
+    let json;
+    try {
+        json = Buffer.from(cursor, "base64url").toString("utf8");
+    }
+    catch {
+        throw new Error("invalid cursor: base64 decode failed");
+    }
+    let arr;
+    try {
+        arr = JSON.parse(json);
+    }
+    catch {
+        throw new Error("invalid cursor: JSON parse failed");
+    }
+    if (!Array.isArray(arr) ||
+        arr.length !== 3 ||
+        typeof arr[0] !== "number" ||
+        typeof arr[1] !== "number" ||
+        typeof arr[2] !== "string") {
+        throw new Error("invalid cursor: shape mismatch");
+    }
+    return { importance: arr[0], updatedAt: arr[1], id: arr[2] };
+}
+/**
+ * 比较两个 sort key,返回 -1 / 0 / 1。
+ * 返回 -1 表示 a 排在 b 前面;1 表示 a 排在 b 后面;0 表示相等。
+ *
+ * 顺序:importance 大→小;同分 updatedAt 新→旧;再同分 id 字典序升序(稳定)。
+ *
+ * 用于 cursor 分页:取出 cursor 之后,过滤掉所有 compareSortKey(key, cursor) <= 0 的项
+ * (cursor 之前或等于的项跳过),从下一个开始取。
+ */
+export function compareSortKey(a, b) {
+    if (a.importance !== b.importance)
+        return a.importance > b.importance ? -1 : 1;
+    if (a.updatedAt !== b.updatedAt)
+        return a.updatedAt > b.updatedAt ? -1 : 1;
+    if (a.id !== b.id)
+        return a.id < b.id ? -1 : 1;
+    return 0;
+}
+//# sourceMappingURL=index-db-cursor.js.map

package/dist/storage/index-db-cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-db-cursor.js","sourceRoot":"","sources":["../../src/storage/index-db-cursor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,MAAM,UAAU,YAAY,CAAC,GAAY;IACxC,gCAAgC;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACrE,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IAC1C,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACtD,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACJ,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACJ,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACtD,CAAC;IACD,IACC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QACnB,GAAG,CAAC,MAAM,KAAK,CAAC;QAChB,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,QAAQ;QAC1B,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,QAAQ;QAC1B,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,QAAQ,EACzB,CAAC;QACF,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,CAAU,EAAE,CAAU;IACpD,IAAI,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU;QAAE,OAAO,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/E,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS;QAAE,OAAO,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE;QAAE,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,CAAC;AACV,CAAC"}