@co-engram/core 0.1.0

package/dist/reinforcement/ltp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ltp.js","sourceRoot":"","sources":["../../src/reinforcement/ltp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,EAAE,cAAc,EAA4B,MAAM,aAAa,CAAC;AAYvE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAsB,EACtB,EAAU,EACV,aAAqB,EACrB,SAA8B,cAAc,EAC5C,SAAiB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IAEzC,IAAI,aAAa,GAAG,CAAC,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,uCAAuC,aAAa,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,eAAe,GAAG,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC;IACvD,IAAI,CAAC,kBAAkB,CAAC,EAAE,EAAE;QAC1B,cAAc,EAAE,CAAC;QACjB,cAAc,EAAE,CAAC;QACjB,kBAAkB,EAAE,aAAa;QACjC,eAAe;QACf,eAAe,EAAE,MAAM;QACvB,eAAe,EAAE,MAAM;KACxB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACpC,OAAO;QACL,EAAE;QACF,eAAe;QACf,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;QAChD,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,MAAM;KACnD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAsB,EACtB,EAAU,EACV,MAAc,EACd,SAAiB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IAEzC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,4BAA4B,MAAM,EAAE,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,CAAC,kBAAkB,CAAC,EAAE,EAAE;QAC1B,eAAe,EAAE,MAAM;QACvB,eAAe,EAAE,MAAM;KACxB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACpC,OAAO;QACL,EAAE;QACF,eAAe,EAAE,MAAM;QACvB,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAc,EACd,KAAa,EACb,mBAAmB,GAAG,CAAC,EACvB,SAA8B,cAAc;IAE5C,IAAI,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,UAAU,IAAI,mBAAmB,GAAG,MAAM,CAAC,OAAO,CAAC;QACnD,IAAI,UAAU,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;AACjC,CAAC"}

package/dist/reinforcement/related.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Hebbian 关联强化
+ *
+ * 神经科学依据："一起激活的神经元连接增强"（Hebb, 1949）。
+ * 业务含义：engram A 被有效强化时，与 A 相连的邻居 engram 也得到部分增益。
+ *
+ * 策略：
+ *   - 沿 outgoing/incoming synapse 找邻居
+ *   - 每个邻居得到 importanceDelta × hebbianRatio（默认 0.5）
+ *   - 排除 contradicts（矛盾邻居不强化）
+ *   - 跳过 archived/forgotten（生命周期已结束的不强化）
+ *
+ * 与 ltp.ts 的关系：
+ *   - ltp.recordRetrievalSuccess：直接强化单个 engram
+ *   - related.reinforceRelated：触发 ltp 后，对邻居做 reinforceEngram（不更新统计）
+ *
+ * @module @co-engram/core/reinforcement
+ */
+import type { EngramRepository } from "../storage/repository.js";
+import { type ReinforcementConfig } from "./config.js";
+export interface ReinforceRelatedResult {
+    /** 被强化的邻居 id 列表 */
+    readonly reinforcedNeighborIds: readonly string[];
+    /** 跳过的邻居数（contradicts / archived / 不存在） */
+    readonly skipped: number;
+    /** 给每个邻居的 importanceDelta */
+    readonly importanceDeltaPerNeighbor: number;
+}
+/**
+ * 对邻居执行 Hebbian 强化
+ *
+ * @param repo - 仓库
+ * @param engramId - 触发强化的 engram id
+ * @param baseImportanceDelta - 原始 engram 得到的 importanceDelta
+ * @param config - 配置（可选）
+ * @param nowIso - 当前时间
+ */
+export declare function reinforceRelated(repo: EngramRepository, engramId: string, baseImportanceDelta: number, config?: ReinforcementConfig, nowIso?: string): ReinforceRelatedResult;
+//# sourceMappingURL=related.d.ts.map

package/dist/reinforcement/related.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"related.d.ts","sourceRoot":"","sources":["../../src/reinforcement/related.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAAkB,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAQvE,MAAM,WAAW,sBAAsB;IACrC,mBAAmB;IACnB,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;IAClD,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6BAA6B;IAC7B,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;CAC7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,MAAM,EAChB,mBAAmB,EAAE,MAAM,EAC3B,MAAM,GAAE,mBAAoC,EAC5C,MAAM,GAAE,MAAiC,GACxC,sBAAsB,CA4DxB"}

package/dist/reinforcement/related.js

@@ -0,0 +1,92 @@
+/**
+ * Hebbian 关联强化
+ *
+ * 神经科学依据："一起激活的神经元连接增强"（Hebb, 1949）。
+ * 业务含义：engram A 被有效强化时，与 A 相连的邻居 engram 也得到部分增益。
+ *
+ * 策略：
+ *   - 沿 outgoing/incoming synapse 找邻居
+ *   - 每个邻居得到 importanceDelta × hebbianRatio（默认 0.5）
+ *   - 排除 contradicts（矛盾邻居不强化）
+ *   - 跳过 archived/forgotten（生命周期已结束的不强化）
+ *
+ * 与 ltp.ts 的关系：
+ *   - ltp.recordRetrievalSuccess：直接强化单个 engram
+ *   - related.reinforceRelated：触发 ltp 后，对邻居做 reinforceEngram（不更新统计）
+ *
+ * @module @co-engram/core/reinforcement
+ */
+import { DEFAULT_CONFIG } from "./config.js";
+import { reinforceEngram } from "./ltp.js"; // 无循环依赖：ltp.ts 不 import related.ts
+/** 不应该被强化的 synapse 类型（矛盾关系） */
+const NEGATIVE_KINDS = new Set([
+    "contradicts",
+]);
+/**
+ * 对邻居执行 Hebbian 强化
+ *
+ * @param repo - 仓库
+ * @param engramId - 触发强化的 engram id
+ * @param baseImportanceDelta - 原始 engram 得到的 importanceDelta
+ * @param config - 配置（可选）
+ * @param nowIso - 当前时间
+ */
+export function reinforceRelated(repo, engramId, baseImportanceDelta, config = DEFAULT_CONFIG, nowIso = new Date().toISOString()) {
+    if (!repo.exists(engramId)) {
+        throw new Error(`Engram not found: ${engramId}`);
+    }
+    if (baseImportanceDelta < 0) {
+        // LTD 不应触发 Hebbian 强化（避免反向放大失败）
+        return {
+            reinforcedNeighborIds: [],
+            skipped: 0,
+            importanceDeltaPerNeighbor: 0,
+        };
+    }
+    const neighborDelta = baseImportanceDelta * config.hebbianRatio;
+    if (neighborDelta <= 0) {
+        return {
+            reinforcedNeighborIds: [],
+            skipped: 0,
+            importanceDeltaPerNeighbor: 0,
+        };
+    }
+    // 收集 outgoing + incoming 邻居
+    const all = repo.collectAllSynapses();
+    const neighborIds = new Set();
+    let skipped = 0;
+    for (const { fromId, synapse } of all) {
+        if (NEGATIVE_KINDS.has(synapse.kind)) {
+            skipped += 1;
+            continue;
+        }
+        if (fromId === engramId) {
+            // 我是 from，邻居是 to
+            neighborIds.add(synapse.to);
+        }
+        else if (synapse.to === engramId) {
+            // 我是 to，邻居是 from
+            neighborIds.add(fromId);
+        }
+    }
+    const reinforced = [];
+    for (const neighborId of neighborIds) {
+        if (!repo.exists(neighborId)) {
+            skipped += 1;
+            continue;
+        }
+        const neighbor = repo.readEngram(neighborId);
+        if (neighbor.status === "archived" || neighbor.status === "forgotten") {
+            skipped += 1;
+            continue;
+        }
+        reinforceEngram(repo, neighborId, neighborDelta, nowIso);
+        reinforced.push(neighborId);
+    }
+    return {
+        reinforcedNeighborIds: reinforced,
+        skipped,
+        importanceDeltaPerNeighbor: neighborDelta,
+    };
+}
+//# sourceMappingURL=related.js.map

package/dist/reinforcement/related.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"related.js","sourceRoot":"","sources":["../../src/reinforcement/related.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,EAAE,cAAc,EAA4B,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC,CAAC,mCAAmC;AAE/E,+BAA+B;AAC/B,MAAM,cAAc,GAA6B,IAAI,GAAG,CAAc;IACpE,aAAa;CACd,CAAC,CAAC;AAWH;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAsB,EACtB,QAAgB,EAChB,mBAA2B,EAC3B,SAA8B,cAAc,EAC5C,SAAiB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IAEzC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,mBAAmB,GAAG,CAAC,EAAE,CAAC;QAC5B,gCAAgC;QAChC,OAAO;YACL,qBAAqB,EAAE,EAAE;YACzB,OAAO,EAAE,CAAC;YACV,0BAA0B,EAAE,CAAC;SAC9B,CAAC;IACJ,CAAC;IACD,MAAM,aAAa,GAAG,mBAAmB,GAAG,MAAM,CAAC,YAAY,CAAC;IAChE,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,qBAAqB,EAAE,EAAE;YACzB,OAAO,EAAE,CAAC;YACV,0BAA0B,EAAE,CAAC;SAC9B,CAAC;IACJ,CAAC;IAED,4BAA4B;IAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;IACtC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,CAAC;QACtC,IAAI,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC,CAAC;YACb,SAAS;QACX,CAAC;QACD,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxB,iBAAiB;YACjB,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,OAAO,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YACnC,iBAAiB;YACjB,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,CAAC;YACb,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,QAAQ,CAAC,MAAM,KAAK,UAAU,IAAI,QAAQ,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YACtE,OAAO,IAAI,CAAC,CAAC;YACb,SAAS;QACX,CAAC;QACD,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;QACzD,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO;QACL,qBAAqB,EAAE,UAAU;QACjC,OAAO;QACP,0BAA0B,EAAE,aAAa;KAC1C,CAAC;AACJ,CAAC"}

package/dist/retrieval/filter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 检索过滤器
+ *
+ * 基于 SearchFilter 对 DigestLine 应用各种过滤条件
+ *
+ * @module @co-engram/core/retrieval
+ */
+import type { DigestLine } from "../index/types.js";
+import type { SearchFilter } from "../types/disclosure.js";
+/**
+ * 应用过滤器，返回是否通过
+ */
+export declare function matchesFilter(line: DigestLine, filter: SearchFilter | undefined): boolean;
+/**
+ * 过滤 DigestLine 列表
+ */
+export declare function applyFilter(lines: readonly DigestLine[], filter: SearchFilter | undefined): DigestLine[];
+//# sourceMappingURL=filter.d.ts.map

package/dist/retrieval/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/retrieval/filter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,YAAY,GAAG,SAAS,GAC/B,OAAO,CA+DT;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,MAAM,EAAE,YAAY,GAAG,SAAS,GAC/B,UAAU,EAAE,CAEd"}

package/dist/retrieval/filter.js

@@ -0,0 +1,68 @@
+/**
+ * 检索过滤器
+ *
+ * 基于 SearchFilter 对 DigestLine 应用各种过滤条件
+ *
+ * @module @co-engram/core/retrieval
+ */
+/**
+ * 应用过滤器，返回是否通过
+ */
+export function matchesFilter(line, filter) {
+    if (!filter) {
+        return true;
+    }
+    if (filter.domainTags && filter.domainTags.length > 0) {
+        if (!filter.domainTags.some((t) => line.domainTags.includes(t))) {
+            return false;
+        }
+    }
+    if (filter.kinds && filter.kinds.length > 0) {
+        if (!filter.kinds.some((k) => line.kinds.includes(k))) {
+            return false;
+        }
+    }
+    if (filter.status && filter.status.length > 0) {
+        if (!filter.status.includes(line.status)) {
+            return false;
+        }
+    }
+    // 默认排除 archived/forgotten（除非显式查询）
+    const statusFilter = filter.status ?? ["active", "draft"];
+    if (!statusFilter.includes(line.status)) {
+        return false;
+    }
+    if (filter.freshness && filter.freshness.length > 0) {
+        if (!filter.freshness.includes(line.freshness)) {
+            return false;
+        }
+    }
+    if (filter.emotionalValence && filter.emotionalValence.length > 0) {
+        if (!filter.emotionalValence.includes(line.emotionalValence)) {
+            return false;
+        }
+    }
+    if (filter.createdBy && filter.createdBy.length > 0) {
+        if (!filter.createdBy.includes(line.createdBy)) {
+            return false;
+        }
+    }
+    if (filter.createdAfter && line.createdAt < filter.createdAfter) {
+        return false;
+    }
+    if (filter.createdBefore && line.createdAt > filter.createdBefore) {
+        return false;
+    }
+    if (filter.minImportance !== undefined &&
+        line.importance < filter.minImportance) {
+        return false;
+    }
+    return true;
+}
+/**
+ * 过滤 DigestLine 列表
+ */
+export function applyFilter(lines, filter) {
+    return lines.filter((line) => matchesFilter(line, filter));
+}
+//# sourceMappingURL=filter.js.map

package/dist/retrieval/filter.js.map

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

package/dist/retrieval/fts.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Full Text Search（关键词匹配）
+ *
+ * 简单实现：基于 digest.jsonl 的内存倒排索引。
+ * P1 阶段会替换为 MiniSearch 等成熟方案；P0 先用极简实现验证流程。
+ *
+ * 策略：
+ *   - 中文：按字符切分（bigram）
+ *   - 英文：按 word boundary 切分
+ *   - 大小写不敏感
+ *
+ * @module @co-engram/core/retrieval
+ */
+import type { DigestLine } from "../index/types.js";
+/**
+ * FTS 索引（简化版：基于 token -> docId set 的倒排索引）
+ */
+export interface FtsIndex {
+    /** token -> Set<docId> */
+    readonly inverted: ReadonlyMap<string, ReadonlySet<string>>;
+    /** docId -> token set（用于快速过滤） */
+    readonly docTokens: ReadonlyMap<string, ReadonlySet<string>>;
+    /** docId -> DigestLine */
+    readonly docs: ReadonlyMap<string, DigestLine>;
+}
+/**
+ * 构建 FTS 索引
+ *
+ * 索引字段：title + summary + domainTags
+ */
+export declare function buildFtsIndex(lines: Iterable<DigestLine>): FtsIndex;
+/** FTS 搜索结果 */
+export interface FtsHit {
+    readonly docId: string;
+    readonly score: number;
+    readonly matchedTokens: readonly string[];
+}
+/**
+ * 在 FTS 索引上搜索
+ *
+ * 计分：每个匹配 token 加 1 分；title 中的 token 加权（2x）
+ */
+export declare function searchFts(query: string, index: FtsIndex, limit?: number): FtsHit[];
+//# sourceMappingURL=fts.d.ts.map

package/dist/retrieval/fts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fts.d.ts","sourceRoot":"","sources":["../../src/retrieval/fts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAqCpD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7D,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAChD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,QAAQ,CA+BnE;AAED,eAAe;AACf,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,QAAQ,EACf,KAAK,SAAK,GACT,MAAM,EAAE,CAuCV"}

package/dist/retrieval/fts.js

@@ -0,0 +1,120 @@
+/**
+ * Full Text Search（关键词匹配）
+ *
+ * 简单实现：基于 digest.jsonl 的内存倒排索引。
+ * P1 阶段会替换为 MiniSearch 等成熟方案；P0 先用极简实现验证流程。
+ *
+ * 策略：
+ *   - 中文：按字符切分（bigram）
+ *   - 英文：按 word boundary 切分
+ *   - 大小写不敏感
+ *
+ * @module @co-engram/core/retrieval
+ */
+/** Token 化结果 */
+function tokenize(text) {
+    if (!text) {
+        return [];
+    }
+    const lower = text.toLowerCase();
+    const tokens = [];
+    // 英文 word
+    const englishWords = lower.match(/[a-z][a-z0-9_-]{1,}/g) ?? [];
+    tokens.push(...englishWords);
+    // 中文 bigram
+    const chineseSegments = lower.match(/[一-龥]+/g) ?? [];
+    for (const seg of chineseSegments) {
+        if (seg.length === 1) {
+            tokens.push(seg);
+        }
+        else {
+            for (let i = 0; i < seg.length - 1; i++) {
+                tokens.push(seg.slice(i, i + 2));
+            }
+            // 也加入单字，便于短查询匹配
+            for (const ch of seg) {
+                tokens.push(ch);
+            }
+        }
+    }
+    // 数字
+    const numbers = lower.match(/\d+/g) ?? [];
+    tokens.push(...numbers);
+    return tokens;
+}
+/**
+ * 构建 FTS 索引
+ *
+ * 索引字段：title + summary + domainTags
+ */
+export function buildFtsIndex(lines) {
+    const inverted = new Map();
+    const docTokens = new Map();
+    const docs = new Map();
+    for (const line of lines) {
+        docs.set(line.id, line);
+        const text = [
+            line.title,
+            line.summary,
+            line.domainTags.join(" "),
+            line.contextTags.join(" "),
+        ].join(" ");
+        const tokens = new Set(tokenize(text));
+        docTokens.set(line.id, tokens);
+        for (const token of tokens) {
+            let postings = inverted.get(token);
+            if (!postings) {
+                postings = new Set();
+                inverted.set(token, postings);
+            }
+            postings.add(line.id);
+        }
+    }
+    return {
+        inverted: inverted,
+        docTokens: docTokens,
+        docs,
+    };
+}
+/**
+ * 在 FTS 索引上搜索
+ *
+ * 计分：每个匹配 token 加 1 分；title 中的 token 加权（2x）
+ */
+export function searchFts(query, index, limit = 50) {
+    const queryTokens = tokenize(query);
+    if (queryTokens.length === 0) {
+        return [];
+    }
+    const scores = new Map();
+    for (const token of queryTokens) {
+        const postings = index.inverted.get(token);
+        if (!postings) {
+            continue;
+        }
+        for (const docId of postings) {
+            let entry = scores.get(docId);
+            if (!entry) {
+                entry = { score: 0, matched: new Set() };
+                scores.set(docId, entry);
+            }
+            // 基础分
+            entry.score += 1;
+            entry.matched.add(token);
+            // title 加权：如果 token 在 title 中
+            const doc = index.docs.get(docId);
+            if (doc && tokenize(doc.title).includes(token)) {
+                entry.score += 1;
+            }
+        }
+    }
+    return Array.from(scores.entries())
+        .map(([docId, { score, matched }]) => ({
+        docId,
+        score,
+        matchedTokens: Array.from(matched),
+    }))
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit);
+}
+//# sourceMappingURL=fts.js.map

package/dist/retrieval/fts.js.map

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

package/dist/retrieval/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 检索 barrel
+ *
+ * @module @co-engram/core/retrieval
+ */
+export * from "./fts.js";
+export * from "./filter.js";
+export * from "./scoring.js";
+export * from "./orchestrator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/retrieval/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retrieval/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC"}

package/dist/retrieval/index.js

@@ -0,0 +1,10 @@
+/**
+ * 检索 barrel
+ *
+ * @module @co-engram/core/retrieval
+ */
+export * from "./fts.js";
+export * from "./filter.js";
+export * from "./scoring.js";
+export * from "./orchestrator.js";
+//# sourceMappingURL=index.js.map

package/dist/retrieval/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/retrieval/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC"}

package/dist/retrieval/orchestrator.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 检索编排器
+ *
+ * 协调 FTS / 过滤器 / 三因子排序，返回 Catalog Entry 列表
+ *
+ * P1 阶段实现（2.3）：
+ *   - FTS 相关度（归一化到 [0,1]）
+ *   - 三因子打分：α·relevance + β·recency + γ·importance
+ *   - 权重可通过 setWeights() 配置
+ *   - 同输入同输出（prompt cache 友好）
+ *
+ * P2 阶段会增加：
+ *   - 向量余弦相似度（RRF 融合）
+ *   - 动态自适应披露集成
+ *
+ * @module @co-engram/core/retrieval
+ */
+import type { EngramCatalogEntry, EngramId } from "../types/engram.js";
+import type { SearchFilter } from "../types/disclosure.js";
+import type { DigestLine } from "../index/types.js";
+import { type ThreeFactorWeights } from "./scoring.js";
+/**
+ * 简单检索结果（P0 阶段）
+ */
+export interface SimpleSearchResult {
+    readonly id: EngramId;
+    readonly score: number;
+    readonly entry: EngramCatalogEntry;
+}
+/**
+ * 检索器
+ *
+ * 需要先调用 `build()` 构建 FTS 索引；后续搜索复用索引
+ */
+export declare class SearchOrchestrator {
+    private ftsIndex;
+    private lines;
+    private weights;
+    private nowFn;
+    /**
+     * 构建 FTS 索引
+     */
+    build(lines: readonly DigestLine[]): void;
+    /**
+     * 配置三因子权重（默认 α=0.5, β=0.3, γ=0.2）
+     *
+     * 会校验和为 1。
+     */
+    setWeights(weights: ThreeFactorWeights): void;
+    /** 读取当前权重 */
+    getWeights(): ThreeFactorWeights;
+    /**
+     * 注入时钟函数（测试用，避免依赖系统时间）
+     */
+    setClock(nowFn: () => Date): void;
+    /**
+     * 搜索
+     *
+     * @param query - 查询字符串
+     * @param filter - 过滤器（可选）
+     * @param limit - 最大结果数（默认 20）
+     */
+    search(query: string, filter?: SearchFilter, limit?: number): SimpleSearchResult[];
+    /**
+     * 按过滤器列出（无查询）
+     *
+     * 不打相关度分（score=0），按原顺序返回。
+     * 可通过 listByImportance() 获取按 importance 排序的列表。
+     */
+    listByFilter(filter?: SearchFilter, limit?: number): SimpleSearchResult[];
+    /**
+     * 按 importance + recency 排序列出（无 query）
+     *
+     * 用于"最近有效的最重要 engram"类查询（如首页推荐）。
+     */
+    listByImportance(filter?: SearchFilter, limit?: number): SimpleSearchResult[];
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/retrieval/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/retrieval/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;CACpC;AAED;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,KAAK,CAAgC;IAE7C;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI;IAKzC;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAK7C,aAAa;IACb,UAAU,IAAI,kBAAkB;IAIhC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI;IAIjC;;;;;;OAMG;IACH,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,YAAY,EACrB,KAAK,SAAK,GACT,kBAAkB,EAAE;IA6CvB;;;;;OAKG;IACH,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,KAAK,SAAM,GAAG,kBAAkB,EAAE;IActE;;;;OAIG;IACH,gBAAgB,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,KAAK,SAAM,GAAG,kBAAkB,EAAE;CAuB3E"}