@co-engram/core 0.1.0

package/dist/prompt-signals/cache.js

@@ -0,0 +1,70 @@
+/**
+ * Prompt signals 缓存文件读写
+ *
+ * 路径:`<dataRoot>/.co-engram/prompt-signals.json`
+ *
+ * 与 team-memory/config.json 同目录,但语义不同:
+ *   - config.json:用户首次选择(语言/作者),很少变
+ *   - prompt-signals.json:light stage 周期性生成,频繁变
+ *
+ * 失败策略:
+ *   - read: 文件不存在或解析失败 → 返回 undefined(首次启动/损坏降级)
+ *   - write: 失败抛错(light stage 会捕获并记 log)
+ *
+ * @module @co-engram/core/prompt-signals
+ */
+/**
+ * 缓存文件名
+ */
+export const PROMPT_SIGNALS_FILENAME = "prompt-signals.json";
+/**
+ * 读取 prompt signals 缓存
+ *
+ * @param dataRoot team-memory 根目录
+ * @param fsRead 可选的自定义读取函数(测试注入)
+ */
+export async function readPromptSignals(dataRoot, fsRead) {
+    try {
+        const path = joinPath(dataRoot, ".co-engram", PROMPT_SIGNALS_FILENAME);
+        const content = fsRead ? await fsRead(path) : await defaultReadFile(path);
+        const parsed = JSON.parse(content);
+        if (parsed && typeof parsed === "object" && parsed.version === 1) {
+            return parsed;
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * 写入 prompt signals 缓存
+ *
+ * @param dataRoot team-memory 根目录
+ * @param signals 完整 snapshot
+ * @param fsWrite 可选的自定义写入函数(测试注入)
+ */
+export async function writePromptSignals(dataRoot, signals, fsWrite) {
+    const path = joinPath(dataRoot, ".co-engram", PROMPT_SIGNALS_FILENAME);
+    const content = JSON.stringify(signals, null, 2) + "\n";
+    if (fsWrite) {
+        await fsWrite(path, content);
+        return;
+    }
+    await defaultWriteFile(path, content);
+}
+// --- 内部:Node fs 默认实现 ---
+async function defaultReadFile(path) {
+    const { readFile } = await import("node:fs/promises");
+    return await readFile(path, "utf-8");
+}
+async function defaultWriteFile(path, content) {
+    const { writeFile, mkdir } = await import("node:fs/promises");
+    const { dirname } = await import("node:path");
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, content, "utf-8");
+}
+function joinPath(...segments) {
+    return segments.filter(Boolean).join("/").replace(/\/+/g, "/");
+}
+//# sourceMappingURL=cache.js.map

package/dist/prompt-signals/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/prompt-signals/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAgB,EAChB,MAA0C;IAE1C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,uBAAuB,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAyB,CAAC;QAC3D,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;YACjE,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB,EAChB,OAA6B,EAC7B,OAA0D;IAE1D,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,uBAAuB,CAAC,CAAC;IACvE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACxD,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7B,OAAO;IACT,CAAC;IACD,MAAM,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC;AAED,0BAA0B;AAE1B,KAAK,UAAU,eAAe,CAAC,IAAY;IACzC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IACtD,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,OAAe;IAC3D,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAC9D,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,QAAQ,CAAC,GAAG,QAAkB;IACrC,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACjE,CAAC"}

package/dist/prompt-signals/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Prompt signals 模块入口
+ *
+ * 导出类型、统计逻辑、缓存读写。
+ *
+ * @module @co-engram/core/prompt-signals
+ */
+export type { PromptSignalSnapshot, PromptSignalStats } from "./types.js";
+export { EMPTY_PROMPT_SIGNALS } from "./types.js";
+export { computePromptSignals, type ComputePromptSignalsOptions, } from "./stats.js";
+export { readPromptSignals, writePromptSignals, PROMPT_SIGNALS_FILENAME, } from "./cache.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/prompt-signals/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompt-signals/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,GACjC,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,YAAY,CAAC"}

package/dist/prompt-signals/index.js

@@ -0,0 +1,11 @@
+/**
+ * Prompt signals 模块入口
+ *
+ * 导出类型、统计逻辑、缓存读写。
+ *
+ * @module @co-engram/core/prompt-signals
+ */
+export { EMPTY_PROMPT_SIGNALS } from "./types.js";
+export { computePromptSignals, } from "./stats.js";
+export { readPromptSignals, writePromptSignals, PROMPT_SIGNALS_FILENAME, } from "./cache.js";
+//# sourceMappingURL=index.js.map

package/dist/prompt-signals/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompt-signals/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EACL,oBAAoB,GAErB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,YAAY,CAAC"}

package/dist/prompt-signals/stats.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Prompt signals 统计逻辑
+ *
+ * 从 EngramRepository 的 listEngrams() 扫描所有 domainTags,
+ * 统计高频 tag,生成 PromptSignalSnapshot。
+ *
+ * 当前实现:
+ *   - topTags:高频领域(从 domainTags 统计)
+ *   - lowConfidenceTopics:频繁检索但 truthScore 低(RPE 反馈)
+ *   - missedTopics:暂留空(需对话历史分析,后续接入 signals sink / audit log)
+ *
+ * @module @co-engram/core/prompt-signals
+ */
+import type { EngramRepository } from "../storage/repository.js";
+import type { PromptSignalSnapshot } from "./types.js";
+/**
+ * 统计参数
+ */
+export interface ComputePromptSignalsOptions {
+    /** top N tags(默认 5) */
+    readonly topTagsLimit?: number;
+    /** tag 频次低于此值不计入 topTags(默认 3,避免噪声) */
+    readonly topTagsMinCount?: number;
+    /** 低置信度话题最大数量(默认 3) */
+    readonly lowConfidenceLimit?: number;
+    /** 被认定为"频繁检索"的最小 retrievalCount(默认 2) */
+    readonly lowConfidenceMinRetrievals?: number;
+    /** truthScore 阈值,低于此值视为低置信(默认 0.4) */
+    readonly lowConfidenceMaxScore?: number;
+    /** 生成器标识(写入 snapshot.generatedBy) */
+    readonly generatedBy?: string;
+}
+/**
+ * 从 repository 统计 prompt signals
+ *
+ * 扫描所有 engram,生成三类信号:
+ *   - topTags:高频领域(从 domainTags 统计)
+ *   - lowConfidenceTopics:频繁检索但 truthScore 低(RPE 反馈)
+ *   - missedTopics:暂留空(需对话历史分析)
+ *
+ * 内部需要读取完整 engram(不只 catalog)以访问 confidence/retrievalCount。
+ * 代价是 N 次 fs 读,light stage 5 分钟一次可接受。
+ */
+export declare function computePromptSignals(repository: EngramRepository, options?: ComputePromptSignalsOptions): PromptSignalSnapshot;
+//# sourceMappingURL=stats.d.ts.map

package/dist/prompt-signals/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/prompt-signals/stats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAqB,MAAM,YAAY,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,uBAAuB;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,uCAAuC;IACvC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,uBAAuB;IACvB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,yCAAyC;IACzC,QAAQ,CAAC,0BAA0B,CAAC,EAAE,MAAM,CAAC;IAC7C,sCAAsC;IACtC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,qCAAqC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAQD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,gBAAgB,EAC5B,OAAO,GAAE,2BAAgC,GACxC,oBAAoB,CA4DtB"}

package/dist/prompt-signals/stats.js

@@ -0,0 +1,119 @@
+/**
+ * Prompt signals 统计逻辑
+ *
+ * 从 EngramRepository 的 listEngrams() 扫描所有 domainTags,
+ * 统计高频 tag,生成 PromptSignalSnapshot。
+ *
+ * 当前实现:
+ *   - topTags:高频领域(从 domainTags 统计)
+ *   - lowConfidenceTopics:频繁检索但 truthScore 低(RPE 反馈)
+ *   - missedTopics:暂留空(需对话历史分析,后续接入 signals sink / audit log)
+ *
+ * @module @co-engram/core/prompt-signals
+ */
+const DEFAULT_TOP_TAGS_LIMIT = 5;
+const DEFAULT_TOP_TAGS_MIN_COUNT = 3;
+const DEFAULT_LOW_CONFIDENCE_LIMIT = 3;
+const DEFAULT_LOW_CONFIDENCE_MIN_RETRIEVALS = 2;
+const DEFAULT_LOW_CONFIDENCE_MAX_SCORE = 0.4;
+/**
+ * 从 repository 统计 prompt signals
+ *
+ * 扫描所有 engram,生成三类信号:
+ *   - topTags:高频领域(从 domainTags 统计)
+ *   - lowConfidenceTopics:频繁检索但 truthScore 低(RPE 反馈)
+ *   - missedTopics:暂留空(需对话历史分析)
+ *
+ * 内部需要读取完整 engram(不只 catalog)以访问 confidence/retrievalCount。
+ * 代价是 N 次 fs 读,light stage 5 分钟一次可接受。
+ */
+export function computePromptSignals(repository, options = {}) {
+    const topTagsLimit = options.topTagsLimit ?? DEFAULT_TOP_TAGS_LIMIT;
+    const topTagsMinCount = options.topTagsMinCount ?? DEFAULT_TOP_TAGS_MIN_COUNT;
+    const lowConfidenceLimit = options.lowConfidenceLimit ?? DEFAULT_LOW_CONFIDENCE_LIMIT;
+    const lowConfidenceMinRetrievals = options.lowConfidenceMinRetrievals ?? DEFAULT_LOW_CONFIDENCE_MIN_RETRIEVALS;
+    const lowConfidenceMaxScore = options.lowConfidenceMaxScore ?? DEFAULT_LOW_CONFIDENCE_MAX_SCORE;
+    const generatedBy = options.generatedBy ?? "light-stage";
+    const entries = repository.listEngrams();
+    const tagCounts = countTags(entries);
+    const topTags = pickTopTags(tagCounts, topTagsLimit, topTagsMinCount);
+    // 收集低置信度 engram 的 tags(RPE 反馈)
+    const lowConfidenceTagCounts = {};
+    for (const entry of entries) {
+        let engram = null;
+        try {
+            const full = repository.readEngram(entry.id);
+            engram = {
+                confidence: full.confidence,
+                retrievalCount: full.retrievalCount,
+            };
+        }
+        catch {
+            continue;
+        }
+        if (engram.retrievalCount < lowConfidenceMinRetrievals)
+            continue;
+        if (engram.confidence >= lowConfidenceMaxScore)
+            continue;
+        for (const tag of entry.domainTags ?? []) {
+            const normalized = tag.trim();
+            if (!normalized)
+                continue;
+            lowConfidenceTagCounts[normalized] =
+                (lowConfidenceTagCounts[normalized] ?? 0) + 1;
+        }
+    }
+    const lowConfidenceTopics = pickTopTags(lowConfidenceTagCounts, lowConfidenceLimit, 1);
+    const stats = {
+        totalEngrams: entries.length,
+        totalTagOccurrences: sumCounts(tagCounts),
+        uniqueTags: Object.keys(tagCounts).length,
+        tagCounts,
+    };
+    return {
+        version: 1,
+        topTags,
+        // 后续接入对话历史分析时填充(signals sink / audit log)
+        missedTopics: [],
+        lowConfidenceTopics,
+        updatedAt: new Date().toISOString(),
+        generatedBy,
+        stats,
+    };
+}
+/**
+ * 统计所有 domainTags 的频次
+ */
+function countTags(entries) {
+    const counts = {};
+    for (const entry of entries) {
+        for (const tag of entry.domainTags ?? []) {
+            const normalized = tag.trim();
+            if (!normalized)
+                continue;
+            counts[normalized] = (counts[normalized] ?? 0) + 1;
+        }
+    }
+    return counts;
+}
+/**
+ * 选取 top N tags(按频次降序,过滤低于 minCount 的)
+ */
+function pickTopTags(counts, limit, minCount) {
+    return Object.entries(counts)
+        .filter(([, count]) => count >= minCount)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, limit)
+        .map(([tag]) => tag);
+}
+/**
+ * 对频次表求和(用于 stats)
+ */
+function sumCounts(counts) {
+    let total = 0;
+    for (const count of Object.values(counts)) {
+        total += count;
+    }
+    return total;
+}
+//# sourceMappingURL=stats.js.map

package/dist/prompt-signals/stats.js.map

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

package/dist/prompt-signals/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Prompt signals 类型定义
+ *
+ * 由 maintenance light stage 周期性生成,缓存到
+ * `<dataRoot>/.co-engram/prompt-signals.json`。
+ *
+ * promptBuilder 读取这份 snapshot,动态填充 memory section 的
+ * "Frequent topics" / "Recently missed" 等条件性提示。
+ *
+ * 设计原则:
+ *   - snapshot 是不可变的(readonly),只整体替换
+ *   - 字段全部可选(除 version),允许增量演进(初版只填 topTags)
+ *   - 含 stats 元数据,便于调试和审计
+ *
+ * @module @co-engram/core/prompt-signals
+ */
+/**
+ * 完整的 prompt signals snapshot
+ */
+export interface PromptSignalSnapshot {
+    /** schema 版本 */
+    readonly version: 1;
+    /** 高频 engram 领域(从 domainTags 统计 top N) */
+    readonly topTags: readonly string[];
+    /** 最近遗漏话题(RPE false negative 检测) */
+    readonly missedTopics: readonly string[];
+    /** 低置信度频繁检索话题 */
+    readonly lowConfidenceTopics: readonly string[];
+    /** ISO timestamp,light stage 每次更新时刷新 */
+    readonly updatedAt: string;
+    /** 生成器标识(如 "light-stage@0.1.0") */
+    readonly generatedBy: string;
+    /** 统计元数据(调试/审计用,不影响 prompt 生成) */
+    readonly stats: PromptSignalStats;
+}
+/**
+ * 统计元数据
+ */
+export interface PromptSignalStats {
+    /** team-memory 中 engram 总数 */
+    readonly totalEngrams: number;
+    /** 参与统计的 tag 总频次 */
+    readonly totalTagOccurrences: number;
+    /** 唯一 tag 数量 */
+    readonly uniqueTags: number;
+    /** 完整 tag 频次表(调试用,不进 prompt) */
+    readonly tagCounts: Readonly<Record<string, number>>;
+}
+/**
+ * 空快照(用于初始化或失败降级)
+ */
+export declare const EMPTY_PROMPT_SIGNALS: PromptSignalSnapshot;
+//# sourceMappingURL=types.d.ts.map

package/dist/prompt-signals/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/prompt-signals/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gBAAgB;IAChB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,oCAAoC;IACpC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,iBAAiB;IACjB,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,wCAAwC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mCAAmC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,oBAAoB;IACpB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,gBAAgB;IAChB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gCAAgC;IAChC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,oBAalC,CAAC"}

package/dist/prompt-signals/types.js

@@ -0,0 +1,34 @@
+/**
+ * Prompt signals 类型定义
+ *
+ * 由 maintenance light stage 周期性生成,缓存到
+ * `<dataRoot>/.co-engram/prompt-signals.json`。
+ *
+ * promptBuilder 读取这份 snapshot,动态填充 memory section 的
+ * "Frequent topics" / "Recently missed" 等条件性提示。
+ *
+ * 设计原则:
+ *   - snapshot 是不可变的(readonly),只整体替换
+ *   - 字段全部可选(除 version),允许增量演进(初版只填 topTags)
+ *   - 含 stats 元数据,便于调试和审计
+ *
+ * @module @co-engram/core/prompt-signals
+ */
+/**
+ * 空快照(用于初始化或失败降级)
+ */
+export const EMPTY_PROMPT_SIGNALS = {
+    version: 1,
+    topTags: [],
+    missedTopics: [],
+    lowConfidenceTopics: [],
+    updatedAt: "",
+    generatedBy: "",
+    stats: {
+        totalEngrams: 0,
+        totalTagOccurrences: 0,
+        uniqueTags: 0,
+        tagCounts: {},
+    },
+};
+//# sourceMappingURL=types.js.map

package/dist/prompt-signals/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/prompt-signals/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAoCH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAyB;IACxD,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,EAAE;IACX,YAAY,EAAE,EAAE;IAChB,mBAAmB,EAAE,EAAE;IACvB,SAAS,EAAE,EAAE;IACb,WAAW,EAAE,EAAE;IACf,KAAK,EAAE;QACL,YAAY,EAAE,CAAC;QACf,mBAAmB,EAAE,CAAC;QACtB,UAAU,EAAE,CAAC;QACb,SAAS,EAAE,EAAE;KACd;CACF,CAAC"}

package/dist/provenance/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Provenance 模块 barrel
+ *
+ * @module @co-engram/core/provenance
+ */
+export * from "./reliability.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provenance/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAC"}

package/dist/provenance/index.js

@@ -0,0 +1,7 @@
+/**
+ * Provenance 模块 barrel
+ *
+ * @module @co-engram/core/provenance
+ */
+export * from "./reliability.js";
+//# sourceMappingURL=index.js.map

package/dist/provenance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/provenance/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAC"}

package/dist/provenance/reliability.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Provenance 奖惩回路（spec §3.8 核心创新）
+ *
+ * 把单条 engram 的三信号追踪聚合到来源（createdBy）级别，形成信用系统：
+ *
+ *   sourceReliability = Σ effectiveRetrievals / (Σ effectiveRetrievals + Σ failedUses)
+ *
+ * 关键设计：派生而非存储（零额外字段）。每次需要时从所有 engram 的统计派生。
+ *
+ * 副作用（落盘时）：
+ *   - 低 reliability 来源旗下 engram 的 verificationStatus 降级（默认 → plausible）
+ *   - 高 reliability 来源的新 engram 初始 confidence 加成（默认 +0.1）
+ *
+ * 与 closeLearningLoop 集成：上层在 onProvenanceUpdate 回调中调用 applyProvenanceSignal，
+ * 或显式调用本模块独立 API。
+ *
+ * @module @co-engram/core/provenance
+ */
+import type { EngramRepository } from "../storage/repository.js";
+import type { VerificationStatus } from "../types/engram.js";
+import type { LearningOutcome } from "../learning/loop.js";
+/** 单来源 reliability 派生结果 */
+export interface SourceReliability {
+    readonly createdBy: string;
+    /** 该来源所有 engram 的 effectiveRetrievals 累加 */
+    readonly totalEffective: number;
+    /** 该来源所有 engram 的 failedUses 累加 */
+    readonly totalFailed: number;
+    /** 该来源所有 engram 的 retrievalCount 累加（包含 partial 等） */
+    readonly totalRetrievals: number;
+    /** 该来源的 engram 数量 */
+    readonly engramCount: number;
+    /** reliability ∈ [0,1]，无样本时返回 0.5（中性） */
+    readonly reliability: number;
+}
+/** Provenance 配置 */
+export interface ProvenanceConfig {
+    /** reliability < 此值 → 标记为低信用（默认 0.4） */
+    readonly lowReliabilityThreshold: number;
+    /** reliability > 此值 → 标记为高信用（默认 0.8） */
+    readonly highReliabilityThreshold: number;
+    /** 高信用来源新 engram 的 confidence 加成（默认 0.1，上限 1.0） */
+    readonly confidenceBoost: number;
+    /** 样本量下限：effectiveRetrievals + failedUses < 此值时不评判（默认 3） */
+    readonly minSampleSize: number;
+    /** 低信用来源旗下 engram 的 verificationStatus 降级目标（默认 'plausible'） */
+    readonly flaggedVerificationStatus: VerificationStatus;
+}
+export declare const DEFAULT_PROVENANCE_CONFIG: ProvenanceConfig;
+/** Provenance 信号处理结果 */
+export interface ProvenanceSignalResult {
+    readonly engramId: string;
+    readonly createdBy: string;
+    readonly outcome: LearningOutcome;
+    readonly effectiveness: number;
+    /** 信号处理后的 reliability 快照（不是 before，因为派生只读当前状态） */
+    readonly reliability: SourceReliability;
+    /** reliability 是否跨越低信用阈值 */
+    readonly isLowReliability: boolean;
+    /** reliability 是否跨越高信用阈值 */
+    readonly isHighReliability: boolean;
+    /** 是否因为样本不足跳过判定 */
+    readonly insufficientSamples: boolean;
+}
+/** 批量标记结果 */
+export interface FlagLowReliabilityResult {
+    readonly flagged: ReadonlyArray<{
+        readonly createdBy: string;
+        readonly reliability: number;
+        readonly engramIds: readonly string[];
+    }>;
+    readonly persisted: boolean;
+}
+/**
+ * 派生单个来源的 reliability
+ *
+ * 实现细节：扫描所有 engram，过滤 createdBy 匹配的，累加三信号。
+ * 无样本时 reliability = 0.5（中性，避免一上来就被标记为低信用）。
+ */
+export declare function deriveSourceReliability(repo: EngramRepository, createdBy: string): SourceReliability | null;
+/**
+ * 派生所有来源的 reliability
+ *
+ * 返回按 reliability 升序排序（最低信用在前，便于优先标记）。
+ */
+export declare function deriveAllSourceReliability(repo: EngramRepository): SourceReliability[];
+/**
+ * 判定 reliability 是否为低/高信用
+ *
+ * 样本不足时一律不评判（避免新来源被误判）。
+ */
+export declare function classifyReliability(reliability: SourceReliability, config?: ProvenanceConfig): {
+    isLow: boolean;
+    isHigh: boolean;
+    insufficient: boolean;
+};
+/**
+ * Provenance 奖惩钩子
+ *
+ * 从 engramId 解析 createdBy，派生当前 reliability，返回信号快照。
+ *
+ * 注意：reliability 本身是派生的，三信号已经在 closeLearningLoop 的 LTP/LTD 阶段
+ * 更新到 engram 上，所以本函数只做"读取 + 分类"，不写盘。
+ *
+ * 副作用（如 verificationStatus 降级）通过 flagLowReliabilitySources 显式触发。
+ */
+export declare function applyProvenanceSignal(repo: EngramRepository, engramId: string, outcome: LearningOutcome, effectiveness: number, options?: {
+    config?: Partial<ProvenanceConfig>;
+}): ProvenanceSignalResult;
+/**
+ * 扫描所有来源，把低 reliability 来源旗下 engram 的 verificationStatus 降级
+ *
+ * 默认目标状态：plausible（spec §3.8：触发反思或标记为"不可信来源"）。
+ * 已是 refuted 的不升回 plausible（避免覆盖人工裁决）。
+ *
+ * @param persist true 则写盘 verificationStatus；false 只返回计算结果
+ */
+export declare function flagLowReliabilitySources(repo: EngramRepository, options?: {
+    config?: Partial<ProvenanceConfig>;
+    persist?: boolean;
+}): FlagLowReliabilityResult;
+/**
+ * 计算高 reliability 来源新 engram 的初始 confidence 加成
+ *
+ * 用法：engram_create 时，先按 sourceType 默认 confidence 生成 base，
+ * 再调用本函数：如果 createdBy reliability 高，返回 min(1.0, base + boost)。
+ *
+ * @returns 调整后的 confidence ∈ [0,1]
+ */
+export declare function computeInitialConfidence(repo: EngramRepository, createdBy: string, baseConfidence: number, options?: {
+    config?: Partial<ProvenanceConfig>;
+}): number;
+//# sourceMappingURL=reliability.d.ts.map

package/dist/provenance/reliability.d.ts.map

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