@co-engram/core 0.1.2 → 0.1.3

package/dist/reinforcement/related.js

@@ -12,7 +12,15 @@
  *
  * 与 ltp.ts 的关系：
  *   - ltp.recordRetrievalSuccess：直接强化单个 engram
- *   - related.reinforceRelated：触发 ltp 后，对邻居做 reinforceEngram（不更新统计）
+ *   - related.reinforceRelated：触发 ltp 后，对邻居做 reinforceEngram
+ *
+ * P0-9 修复:此前邻居联动是"幽灵强化" —— 邻居 importance 被改但
+ *   (a) effectiveRetrievals/retrievalCount/reinforcementScore 全为 0
+ *   (b) audit_log 无任何 reinforce 记录(查 action:reinforce, engramId:B 永远空)
+ *   (c) 也不知道是哪个 engram 触发的联动
+ * 现在通过 options.auditLog + options.triggeredBy 让联动可观察:
+ *   - reinforceEngram 传 withStats:true 让统计字段同步更新
+ *   - auditLog.append({action:"reinforce", engramId:邻居, metadata:{triggeredBy, sourceImportanceDelta, ...}})
  *
  * @module @co-engram/core/reinforcement
  */
@@ -30,8 +38,9 @@ const NEGATIVE_KINDS = new Set([
  * @param baseImportanceDelta - 原始 engram 得到的 importanceDelta
  * @param config - 配置（可选）
  * @param nowIso - 当前时间
+ * @param options - P0-9 修复:可选 auditLog + triggeredBy,让联动可观察
  */
-export function reinforceRelated(repo, engramId, baseImportanceDelta, config = DEFAULT_CONFIG, nowIso = new Date().toISOString()) {
+export function reinforceRelated(repo, engramId, baseImportanceDelta, config = DEFAULT_CONFIG, nowIso = new Date().toISOString(), options = {}) {
     if (!repo.exists(engramId)) {
         throw new Error(`Engram not found: ${engramId}`);
     }
@@ -54,6 +63,8 @@ export function reinforceRelated(repo, engramId, baseImportanceDelta, config = D
     // 收集 outgoing + incoming 邻居
     const all = repo.collectAllSynapses();
     const neighborIds = new Set();
+    /** 记录每个邻居关联的 synapse id,用于 audit metadata 追溯 */
+    const neighborSynapseMap = new Map();
     let skipped = 0;
     for (const { fromId, synapse } of all) {
         if (NEGATIVE_KINDS.has(synapse.kind)) {
@@ -63,10 +74,12 @@ export function reinforceRelated(repo, engramId, baseImportanceDelta, config = D
         if (fromId === engramId) {
             // 我是 from，邻居是 to
             neighborIds.add(synapse.to);
+            neighborSynapseMap.set(synapse.to, synapse.id);
         }
         else if (synapse.to === engramId) {
             // 我是 to，邻居是 from
             neighborIds.add(fromId);
+            neighborSynapseMap.set(fromId, synapse.id);
         }
     }
     const reinforced = [];
@@ -80,8 +93,31 @@ export function reinforceRelated(repo, engramId, baseImportanceDelta, config = D
             skipped += 1;
             continue;
         }
-        reinforceEngram(repo, neighborId, neighborDelta, nowIso);
+        // P0-9 修复:邻居联动也更新统计字段,让 effectiveRetrievals/retrievalCount/
+        // reinforcementScore 可观察。语义上邻居被"间接有效检索"。
+        reinforceEngram(repo, neighborId, neighborDelta, nowIso, {
+            withStats: true,
+            effectiveness: neighborDelta,
+        });
         reinforced.push(neighborId);
+        // P0-9 修复:写邻居 audit,让联动可追溯
+        if (options.auditLog) {
+            options.auditLog.append({
+                actor: "system",
+                action: "reinforce",
+                engramId: neighborId,
+                host: options.host,
+                metadata: {
+                    triggeredBy: options.triggeredBy ?? engramId,
+                    triggerTool: options.triggerTool,
+                    sourceEngramId: engramId,
+                    synapseId: neighborSynapseMap.get(neighborId),
+                    importanceDelta: neighborDelta,
+                    effectiveness: neighborDelta,
+                    hebbian: true,
+                },
+            });
+        }
     }
     return {
         reinforcedNeighborIds: reinforced,

package/dist/reinforcement/related.js.map

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

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

@@ -1 +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"}
+{"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,CAuET;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

@@ -17,6 +17,13 @@ export function matchesFilter(line, filter) {
             return false;
         }
     }
+    // P0-3 修复:contextTags 此前在 SearchFilter 三方缺失,现在补齐
+    // 语义与 domainTags 一致:engram.contextTags 与 filter.contextTags 有交集则通过
+    if (filter.contextTags && filter.contextTags.length > 0) {
+        if (!filter.contextTags.some((t) => line.contextTags.includes(t))) {
+            return false;
+        }
+    }
     if (filter.kinds && filter.kinds.length > 0) {
         if (!filter.kinds.some((k) => line.kinds.includes(k))) {
             return false;

package/dist/retrieval/filter.js.map

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

package/dist/retrieval/fts.d.ts

@@ -1,12 +1,13 @@
 /**
  * Full Text Search（关键词匹配）
  *
- * 简单实现：基于 digest.jsonl 的内存倒排索引。
- * P1 阶段会替换为 MiniSearch 等成熟方案；P0 先用极简实现验证流程。
+ * 基于内存倒排索引。Task 4.1 把 P0 时代的中文 bigram 切分换成了
+ * Intl.Segmenter(Node 22+ 内置,零新依赖),消除 bigram 跨词边界的假阳性。
  *
- * 策略：
- *   - 中文：按字符切分（bigram）
- *   - 英文：按 word boundary 切分
+ * 策略:
+ *   - 中文:Intl.Segmenter(granularity=word)按字典做词级切分,
+ *     同时保留单字让短查询仍能命中(unigram 覆盖,无 bigram 假阳性)。
+ *   - 英文:word boundary 切分
  *   - 大小写不敏感
  *
  * @module @co-engram/core/retrieval

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

@@ -1 +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"}
+{"version":3,"file":"fts.d.ts","sourceRoot":"","sources":["../../src/retrieval/fts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAoFpD;;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,CAwCV"}

package/dist/retrieval/fts.js

@@ -1,18 +1,48 @@
 /**
  * Full Text Search（关键词匹配）
  *
- * 简单实现：基于 digest.jsonl 的内存倒排索引。
- * P1 阶段会替换为 MiniSearch 等成熟方案；P0 先用极简实现验证流程。
+ * 基于内存倒排索引。Task 4.1 把 P0 时代的中文 bigram 切分换成了
+ * Intl.Segmenter(Node 22+ 内置,零新依赖),消除 bigram 跨词边界的假阳性。
  *
- * 策略：
- *   - 中文：按字符切分（bigram）
- *   - 英文：按 word boundary 切分
+ * 策略:
+ *   - 中文:Intl.Segmenter(granularity=word)按字典做词级切分,
+ *     同时保留单字让短查询仍能命中(unigram 覆盖,无 bigram 假阳性)。
+ *   - 英文:word boundary 切分
  *   - 大小写不敏感
  *
  * @module @co-engram/core/retrieval
  */
-/** Token 化结果 */
-function tokenize(text) {
+/**
+ * 中文 word segmenter(lazy 单例)
+ *
+ * Intl.Segmenter 实例可重用,构造有非零开销。模块级缓存让多次 tokenize 共享。
+ */
+let zhWordSegmenter = null;
+function getZhSegmenter() {
+    if (zhWordSegmenter !== null)
+        return zhWordSegmenter;
+    try {
+        zhWordSegmenter = new Intl.Segmenter("zh", { granularity: "word" });
+    }
+    catch {
+        zhWordSegmenter = null; // 旧 ICU / 非 zh 环境:fallback 到单字
+    }
+    return zhWordSegmenter;
+}
+/** Token 化结果
+ *
+ * mode 参数(P0-6 修复):
+ *   - 'index':索引阶段。word-level segment 长度 > 1 时,额外补单字 token,
+ *     让单字 query(如"团")能命中含该字的词(如"团队")。
+ *   - 'query':查询阶段。不补单字 token,但 segmenter 输出的 word-level
+ *     单字 token(如"调试"被切成["调","试"])正常加入。
+ *
+ * Task 4.1 anti-false-positive 的 trade-off(P0-6 修订):
+ *   索引端补单字后,segmenter 不识别的 2 字 query(如"忆系")会产生跨词
+ *   边界匹配(假阳性)。但用户极少查无意义 2 字组合,单字 query 极常见,
+ *   trade-off 划算。FTS 真正消除假阳性需要 phrase matching(未实现)。
+ */
+function tokenize(text, mode = "index") {
     if (!text) {
         return [];
     }
@@ -21,20 +51,41 @@ function tokenize(text) {
     // 英文 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);
+    // 中文段(Intl.Segmenter 也能切英文,但 regex 已处理;这里只跑中日韩段)
+    const cjkSegments = lower.match(/[一-龥ぁ-んァ-ン]+/g) ?? [];
+    const segmenter = getZhSegmenter();
+    for (const seg of cjkSegments) {
+        if (segmenter !== null) {
+            // 词级切分:不额外生成单字 token,避免 "忆系" 这种跨词边界的查询命中
+            // "记忆系统设计"(否则单字 "忆"/"系" 都在文档 tokens 里,导致假阳性)。
+            // ICU 字典能识别的常见词("记忆"/"系统"/"设计")会作为一个 token,
+            // 词典不识别的("调试"→["调","试"])按单字输出,符合用户直觉。
+            const seen = new Set();
+            for (const { segment } of segmenter.segment(seg)) {
+                const trimmed = segment.trim();
+                if (!trimmed)
+                    continue;
+                if (!seen.has(trimmed)) {
+                    seen.add(trimmed);
+                    tokens.push(trimmed);
+                }
+                // P0-6 修复(index 模式):word-level segment 额外补单字 token,
+                // 让单字 query(如"团")能命中含该字的词(如"团队")。
+                // 仅 index 模式拆字;query 模式不拆,避免膨胀 query token 集合。
+                if (mode === "index" && trimmed.length > 1) {
+                    for (const ch of trimmed) {
+                        if (/[一-龥ぁ-んァ-ン]/.test(ch) && !seen.has(ch)) {
+                            seen.add(ch);
+                            tokens.push(ch);
+                        }
+                    }
+                }
+            }
         }
         else {
-            for (let i = 0; i < seg.length - 1; i++) {
-                tokens.push(seg.slice(i, i + 2));
-            }
-            // 也加入单字，便于短查询匹配
-            for (const ch of seg) {
+            // fallback:无 Intl.Segmenter 时退到单字(不引入 bigram 假阳性)
+            for (const ch of seg)
                 tokens.push(ch);
-            }
         }
     }
     // 数字
@@ -59,7 +110,7 @@ export function buildFtsIndex(lines) {
             line.domainTags.join(" "),
             line.contextTags.join(" "),
         ].join(" ");
-        const tokens = new Set(tokenize(text));
+        const tokens = new Set(tokenize(text, "index"));
         docTokens.set(line.id, tokens);
         for (const token of tokens) {
             let postings = inverted.get(token);
@@ -82,7 +133,7 @@ export function buildFtsIndex(lines) {
  * 计分：每个匹配 token 加 1 分；title 中的 token 加权（2x）
  */
 export function searchFts(query, index, limit = 50) {
-    const queryTokens = tokenize(query);
+    const queryTokens = tokenize(query, "query");
     if (queryTokens.length === 0) {
         return [];
     }
@@ -101,9 +152,10 @@ export function searchFts(query, index, limit = 50) {
             // 基础分
             entry.score += 1;
             entry.matched.add(token);
-            // title 加权：如果 token 在 title 中
+            // title 加权：如果 token 在 title 中(用 index 模式 tokenize,
+            // 因为 doc.title 在索引阶段也用 index 模式,两端一致)
             const doc = index.docs.get(docId);
-            if (doc && tokenize(doc.title).includes(token)) {
+            if (doc && tokenize(doc.title, "index").includes(token)) {
                 entry.score += 1;
             }
         }

package/dist/retrieval/fts.js.map

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

package/dist/status/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 健康可视化状态模块
+ *
+ * @module @co-engram/core/status
+ */
+export { computeStatus, formatStatusAsText, type StatusSnapshot, type HealthCheck, } from "./status.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/status/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC"}

package/dist/status/index.js

@@ -0,0 +1,7 @@
+/**
+ * 健康可视化状态模块
+ *
+ * @module @co-engram/core/status
+ */
+export { computeStatus, formatStatusAsText, } from "./status.js";
+//# sourceMappingURL=index.js.map

package/dist/status/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/status/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,aAAa,EACb,kBAAkB,GAGnB,MAAM,aAAa,CAAC"}

package/dist/status/status.d.ts

@@ -0,0 +1,132 @@
+/**
+ * 健康可视化状态(Finding 128 / 254 等 P0 的用户感知层)
+ *
+ * `co-engram status` 命令与 viewer Health tab 共用本模块。
+ * 设计目标:把"静默失败"变成"一眼可见"——挑剔用户首启就能看到问题在哪。
+ *
+ * @module @co-engram/core/status
+ */
+/** 单项健康检查结果 */
+export interface HealthCheck {
+    /** 检查项 id(snake_case) */
+    readonly id: string;
+    /** 显示名 */
+    readonly label: string;
+    /** ok / warn / error / info */
+    readonly status: "ok" | "warn" | "error" | "info";
+    /** 简短说明 */
+    readonly message: string;
+    /** 可选详情(展开看) */
+    readonly detail?: string;
+    /**
+     * 警告含义说明(只在 warn/error 时填;ok/info 留空)
+     *
+     * 结构化对齐:i18n key `viewer.health.why.<checkId>` —— viewer 端按当前
+     * 语言渲染,core 不耦合文案。例如 checkId='merge_driver' 时 viewer 翻译表里
+     * 有 `viewer.health.why.merge_driver = "未配置时,多人协作合并分支会引发
+     * engram frontmatter 冲突,需手工解决"`。
+     */
+    readonly whyI18nKey?: string;
+    /**
+     * 修复指引(结构化,只在 warn/error 时填)
+     *
+     * 与 doctor 的 `DoctorNextAction` 区别:nextAction 给 LLM agent(含 argsHint),
+     * `fix` 给人(含可复制命令)。两者刻意区分,不混用。
+     */
+    readonly fix?: HealthCheckFix;
+}
+/** 健康检查的修复指引(给 viewer UI 用) */
+export interface HealthCheckFix {
+    /**
+     * 修复描述 i18n key(viewer 端按语言渲染)
+     *
+     * 例如 checkId='merge_driver' → `viewer.health.fix.merge_driver.description`
+     */
+    readonly descriptionI18nKey: string;
+    /**
+     * 可执行的 shell 命令(可选,UI 提供"复制命令"按钮)
+     *
+     * 不通过 i18n key —— 命令跨语言一致。例如 `co-engram init`、
+     * `git init && git add -A && git commit -m initial`。
+     */
+    readonly command?: string;
+    /**
+     * 对应的 co-engram 工具名(可选,UI 显示工具名 + argsHint)
+     *
+     * 例如 `engram_list_proposals`、`engram_doctor`。
+     */
+    readonly tool?: string;
+    /** 工具参数提示(配合 tool 用) */
+    readonly argsHint?: string;
+}
+/** 完整状态快照 */
+export interface StatusSnapshot {
+    /** 生成时间 ISO */
+    readonly generatedAt: string;
+    /** dataRoot 路径 */
+    readonly dataRoot: string;
+    /** dataRoot 是否存在 */
+    readonly dataRootExists: boolean;
+    /** 是否为 co-engram 仓库(含 .co-engram/config.json) */
+    readonly isEngramWarehouse: boolean;
+    /** 配置(若可读) */
+    readonly config?: Readonly<Record<string, unknown>>;
+    /** engram 统计 */
+    readonly stats: {
+        readonly total: number;
+        readonly byKind: Readonly<Record<string, number>>;
+        readonly byStatus: Readonly<Record<string, number>>;
+        readonly archived: number;
+        readonly forgotten: number;
+    };
+    /** 索引文件状态 */
+    readonly indexes: {
+        readonly engramIndex: {
+            readonly exists: boolean;
+            readonly mtime?: string;
+            readonly sizeBytes?: number;
+        };
+        readonly digestJsonl: {
+            readonly exists: boolean;
+            readonly mtime?: string;
+            readonly sizeBytes?: number;
+        };
+        readonly graphJson: {
+            readonly exists: boolean;
+            readonly mtime?: string;
+            readonly sizeBytes?: number;
+        };
+    };
+    /** 候选提案 */
+    readonly proposals: {
+        readonly pending: number;
+        readonly total: number;
+    };
+    /** Git 状态 */
+    readonly git: {
+        readonly isRepo: boolean;
+        readonly dirty: boolean;
+        readonly uncommittedCount: number;
+    };
+    /** merge driver 配置 */
+    readonly mergeDriver: {
+        readonly configured: boolean;
+        readonly detail?: string;
+    };
+    /** 健康检查项列表 */
+    readonly checks: readonly HealthCheck[];
+    /** 总体健康(ok = 所有 check 都 ok/info;warn = 有 warn;error = 有 error) */
+    readonly overall: "ok" | "warn" | "error";
+}
+/**
+ * 计算仓库健康状态
+ *
+ * @param dataRoot team-memory 根目录
+ * @returns StatusSnapshot;即使 dataRoot 不存在也返回(便于 UI 显示诊断)
+ */
+export declare function computeStatus(dataRoot: string): StatusSnapshot;
+/**
+ * 把 StatusSnapshot 格式化为人类可读文本
+ */
+export declare function formatStatusAsText(s: StatusSnapshot): string;
+//# sourceMappingURL=status.d.ts.map

package/dist/status/status.d.ts.map

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