@co-engram/core 0.1.0

package/dist/signals/extract.js

@@ -0,0 +1,388 @@
+/**
+ * 行为信号提取规则引擎（P4 A.3）
+ *
+ * 从 ToolCallEvent 流中推断每条 engram 的"真实效用",不依赖 agent 自律上报。
+ *
+ * 设计：
+ *   - 数据驱动：每条规则是 { name, weight, match } 纯函数
+ *   - 可组合：DEFAULT_RULES 是 6 条内置规则的组合
+ *   - 可扩展：宿主可以传入自己的 rules
+ *
+ * 规则说明（按 weight 强弱）：
+ *   强正(≥ 0.6):repeated_get / get_then_action / contradicts_deleted
+ *   弱正(0.2-0.5):get_no_resimilar_search
+ *   强负(≤ -0.6):get_then_immediate_search / contradicts_created
+ *   弱负(-0.2 - -0.5):user_correction
+ *
+ * @module @co-engram/core/signals
+ */
+/** 默认 sliding window 大小 */
+export const DEFAULT_WINDOW_SIZE = 10;
+/**
+ * 提取所有规则的信号并合并去重
+ *
+ * 合并策略：同 (engramId, source) 取 weight 绝对值最大的；不同 source 全部保留。
+ */
+export function extractSignals(events, rules = DEFAULT_RULES, options) {
+    const all = [];
+    for (const rule of rules) {
+        const signals = rule.match(events, options);
+        all.push(...signals);
+    }
+    return dedupeSignals(all);
+}
+/**
+ * 去重：同 (engramId, source) 取绝对值最大
+ */
+export function dedupeSignals(signals) {
+    const map = new Map();
+    for (const s of signals) {
+        const key = `${s.engramId}::${s.source}`;
+        const existing = map.get(key);
+        if (!existing || Math.abs(s.weight) > Math.abs(existing.weight)) {
+            map.set(key, s);
+        }
+    }
+    return [...map.values()];
+}
+// ============================================================
+// 内置规则
+// ============================================================
+/**
+ * 规则 1：同 sliding window 内同一 engram 被 engram_get ≥ 2 次
+ *
+ * 神经科学依据：反复访问 = 强化（retrieval + reinforcement）
+ * weight: +0.6（强正）
+ */
+export const repeatedGetRule = {
+    name: "repeated_get",
+    weight: 0.6,
+    match(events, options) {
+        const windowSize = options?.windowSize ?? DEFAULT_WINDOW_SIZE;
+        const signals = [];
+        const emittedFor = new Map();
+        for (let i = 0; i < events.length; i++) {
+            const window = events.slice(i, i + windowSize);
+            const counts = new Map();
+            for (const e of window) {
+                if (e.toolName !== "engram_get")
+                    continue;
+                const ids = e.retrievedEngramIds ?? [];
+                for (const id of ids) {
+                    counts.set(id, (counts.get(id) ?? 0) + 1);
+                }
+            }
+            const windowEnd = window[window.length - 1].at;
+            for (const [id, count] of counts) {
+                if (count < 2)
+                    continue;
+                const existing = emittedFor.get(id);
+                // 同 engramId 只保留 count 最大且最早出现的那个窗口
+                if (!existing || count > existing.count) {
+                    emittedFor.set(id, { count, windowStart: i, windowEnd });
+                }
+            }
+        }
+        for (const [id, info] of emittedFor) {
+            signals.push({
+                engramId: id,
+                weight: 0.6,
+                source: "repeated_get",
+                evidence: {
+                    count: info.count,
+                    windowStart: info.windowStart,
+                    windowSize,
+                },
+                sessionId: events[info.windowStart].sessionId,
+                at: info.windowEnd,
+            });
+        }
+        return signals;
+    },
+};
+/**
+ * 规则 2：engram_get 后跟 file_edit / bash / git_commit 等动作
+ *
+ * 含义：从"读"变成"做",有落地证据
+ * weight: +0.8（强正）
+ */
+export const getFollowedByActionRule = {
+    name: "get_then_action",
+    weight: 0.8,
+    match(events, options) {
+        const windowSize = options?.windowSize ?? DEFAULT_WINDOW_SIZE;
+        const actionTools = new Set([
+            "file_edit",
+            "file_write",
+            "bash",
+            "git_commit",
+            "git_push",
+            "edit_file",
+            "write_file",
+        ]);
+        const signals = [];
+        for (let i = 0; i < events.length; i++) {
+            const e = events[i];
+            if (e.toolName !== "engram_get")
+                continue;
+            const ids = e.retrievedEngramIds ?? [];
+            if (ids.length === 0)
+                continue;
+            // 看后续 windowSize 个事件是否有 action
+            const followUps = events.slice(i + 1, i + 1 + windowSize);
+            const hasAction = followUps.some((f) => actionTools.has(f.toolName));
+            if (!hasAction)
+                continue;
+            for (const id of ids) {
+                signals.push({
+                    engramId: id,
+                    weight: 0.8,
+                    source: "get_then_action",
+                    evidence: {
+                        getAt: i,
+                        actionFound: followUps
+                            .filter((f) => actionTools.has(f.toolName))
+                            .map((f) => f.toolName),
+                        windowSize,
+                    },
+                    sessionId: e.sessionId,
+                    at: e.at,
+                });
+            }
+        }
+        return signals;
+    },
+};
+/**
+ * 规则 3：engram_get 后 windowSize 内没有 engram_search 同主题
+ *
+ * 含义：读了一次就够了,问题已解决
+ * weight: +0.4（弱正）
+ *
+ * 注意：这是"沉默的满意"信号,容易误判（可能只是没继续做）。weight 较弱。
+ */
+export const getFollowedByNoSearchRule = {
+    name: "get_no_resimilar_search",
+    weight: 0.4,
+    match(events, options) {
+        const windowSize = options?.windowSize ?? DEFAULT_WINDOW_SIZE;
+        const signals = [];
+        const emitted = new Set();
+        for (let i = 0; i < events.length; i++) {
+            const e = events[i];
+            if (e.toolName !== "engram_get")
+                continue;
+            const ids = e.retrievedEngramIds ?? [];
+            if (ids.length === 0)
+                continue;
+            const followUps = events.slice(i + 1, i + 1 + windowSize);
+            // 后续 windowSize 内没有 engram_search
+            const hasSearch = followUps.some((f) => f.toolName === "engram_search");
+            if (hasSearch)
+                continue;
+            // 前一个事件也不能是同 id 的 search（否则会被 get_then_immediate_search 规则捕获）
+            const prior = events[i - 1];
+            if (prior && prior.toolName === "engram_search")
+                continue;
+            for (const id of ids) {
+                const dedupeKey = `${id}@${i}`;
+                if (emitted.has(dedupeKey))
+                    continue;
+                emitted.add(dedupeKey);
+                signals.push({
+                    engramId: id,
+                    weight: 0.4,
+                    source: "get_no_resimilar_search",
+                    evidence: { getAt: i, windowSize, followUpCount: followUps.length },
+                    sessionId: e.sessionId,
+                    at: e.at,
+                });
+            }
+        }
+        return signals;
+    },
+};
+/**
+ * 规则 4：engram_get 后 < 3 事件立即 engram_search 同主题
+ *
+ * 含义：get 没解决问题,要再找
+ * weight: -0.7（强负）
+ */
+export const getThenImmediateSearchRule = {
+    name: "get_then_immediate_search",
+    weight: -0.7,
+    match(events) {
+        const threshold = 3; // 后续 3 个事件内
+        const signals = [];
+        const emitted = new Set();
+        for (let i = 0; i < events.length; i++) {
+            const e = events[i];
+            if (e.toolName !== "engram_get")
+                continue;
+            const ids = e.retrievedEngramIds ?? [];
+            if (ids.length === 0)
+                continue;
+            const followUps = events.slice(i + 1, i + 1 + threshold);
+            const hasSearch = followUps.some((f) => f.toolName === "engram_search");
+            if (!hasSearch)
+                continue;
+            for (const id of ids) {
+                const dedupeKey = `${id}@${i}`;
+                if (emitted.has(dedupeKey))
+                    continue;
+                emitted.add(dedupeKey);
+                signals.push({
+                    engramId: id,
+                    weight: -0.7,
+                    source: "get_then_immediate_search",
+                    evidence: {
+                        getAt: i,
+                        searchAt: i +
+                            1 +
+                            followUps.findIndex((f) => f.toolName === "engram_search"),
+                        window: threshold,
+                    },
+                    sessionId: e.sessionId,
+                    at: e.at,
+                });
+            }
+        }
+        return signals;
+    },
+};
+/**
+ * 规则 5：用户消息包含纠正词
+ *
+ * 纠正词表："不对" / "错了" / "should be" / "actually" / "wait" / "不是"
+ * 信号来源：tool args 里如果有 message / prompt / reply 字段包含纠正词
+ *
+ * 注意：这是一个保守的近似——真正的用户消息可能在 transcript 里但不在 tool args 里。
+ * 后续 hook 改造后可以从专门的 user_message 事件类型捕获。
+ *
+ * weight: -0.4（弱负）
+ */
+export const userCorrectionRule = {
+    name: "user_correction",
+    weight: -0.4,
+    match(events) {
+        const correctionWords = [
+            "不对",
+            "错了",
+            "不是",
+            "should be",
+            "actually",
+            "wait, no",
+            "no,",
+        ];
+        const signals = [];
+        const emitted = new Set();
+        for (let i = 0; i < events.length; i++) {
+            const e = events[i];
+            // 检查 input 里是否有 message / prompt / text 字段含纠正词
+            const text = extractTextFromInput(e.input);
+            if (!text)
+                continue;
+            const lower = text.toLowerCase();
+            const hit = correctionWords.find((w) => lower.includes(w.toLowerCase()));
+            if (!hit)
+                continue;
+            // 找前面最近的 engram_get / engram_search / engram_create 作为关联
+            const prior = findPriorEngramEvent(events, i);
+            if (!prior)
+                continue;
+            const ids = prior.retrievedEngramIds ?? [];
+            for (const id of ids) {
+                const dedupeKey = `${id}@${i}`;
+                if (emitted.has(dedupeKey))
+                    continue;
+                emitted.add(dedupeKey);
+                signals.push({
+                    engramId: id,
+                    weight: -0.4,
+                    source: "user_correction",
+                    evidence: {
+                        correctionWord: hit,
+                        eventAt: i,
+                        relatedTool: prior.toolName,
+                    },
+                    sessionId: e.sessionId,
+                    at: e.at,
+                });
+            }
+        }
+        return signals;
+    },
+};
+/**
+ * 规则 6：创建 contradicts synapse 指向某 engram
+ *
+ * 含义：被显式反驳
+ * weight: -0.8（强负）
+ *
+ * 注意：被 contradicts 不等于被 refute（refute 是 verificationStatus 状态机的事）。
+ * 这里只记录信号,后续 metacognition 会综合其他维度决定是否 refute。
+ */
+export const contradictsCreatedRule = {
+    name: "contradicts_created",
+    weight: -0.8,
+    match(events) {
+        const signals = [];
+        for (const e of events) {
+            if (e.toolName !== "synapse_create")
+                continue;
+            const kind = e.input.kind;
+            if (kind !== "contradicts")
+                continue;
+            const to = e.input.to;
+            if (typeof to !== "string")
+                continue;
+            signals.push({
+                engramId: to,
+                weight: -0.8,
+                source: "contradicts_created",
+                evidence: {
+                    synapseFrom: e.input.from,
+                    at: e.at,
+                },
+                sessionId: e.sessionId,
+                at: e.at,
+            });
+        }
+        return signals;
+    },
+};
+/** 默认规则集（按 weight 从强到弱排序,仅影响审计日志可读性,不影响结果） */
+export const DEFAULT_RULES = [
+    contradictsCreatedRule, // -0.8
+    getThenImmediateSearchRule, // -0.7
+    getFollowedByActionRule, // +0.8
+    repeatedGetRule, // +0.6
+    userCorrectionRule, // -0.4
+    getFollowedByNoSearchRule, // +0.4
+];
+// ============================================================
+// 工具函数
+// ============================================================
+function extractTextFromInput(input) {
+    const fields = ["message", "prompt", "text", "reply", "content", "msg"];
+    for (const f of fields) {
+        const v = input[f];
+        if (typeof v === "string" && v.length > 0)
+            return v;
+    }
+    return undefined;
+}
+function findPriorEngramEvent(events, index) {
+    for (let i = index - 1; i >= 0 && i >= index - 5; i--) {
+        const e = events[i];
+        if ((e.toolName === "engram_get" ||
+            e.toolName === "engram_search" ||
+            e.toolName === "engram_create") &&
+            e.retrievedEngramIds &&
+            e.retrievedEngramIds.length > 0) {
+            return e;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=extract.js.map

package/dist/signals/extract.js.map

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

package/dist/signals/file-sink.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 默认信号收集器实现
+ *
+ * - FileSignalSink：JSONL 文件持久化（生产用，路径默认 <dataRoot>/.co-engram/signals.jsonl）
+ * - MemorySignalSink：内存数组（测试用，断言方便）
+ *
+ * 设计：
+ *   - append 只追加一行 JSON，不做 fsync（性能优先）
+ *   - drain 读取整个文件 + 截断（O(n)）
+ *   - prune 读取 + 过滤 + 重写（O(n)）
+ *
+ * 并发：单进程内 by-design 安全；多进程并发需要文件锁，留作 TODO（MVP 单进程场景够用）。
+ *
+ * @module @co-engram/core/signals
+ */
+import type { SignalSink, ToolCallEvent } from "./types.js";
+/**
+ * JSONL 文件信号收集器
+ *
+ * 文件格式：每行一个 JSON object,字段对应 ToolCallEvent。
+ * drain() 会读取全部并截断文件；prune() 会保留最近 N ms 的事件。
+ */
+export declare class FileSignalSink implements SignalSink {
+    private readonly filePath;
+    private readonly buffer;
+    private flushTimer;
+    private readonly flushIntervalMs;
+    private readonly flushThreshold;
+    constructor(options: FileSignalSinkOptions);
+    append(event: ToolCallEvent): void;
+    drain(): readonly ToolCallEvent[];
+    prune(olderThanMs: number): Promise<void>;
+    /** 显式 flush（测试或进程退出时调） */
+    flush(): Promise<void>;
+    /**
+     * 主动从 exit handler 注销(测试结束后清理)
+     *
+     * 不强制要求调用,但测试中创建大量 sink 时调用可避免 Set 无限增长
+     * (生产中只有 1 个 sink,生命周期 = 进程生命周期,无所谓)。
+     */
+    dispose(): void;
+    private flushSync;
+}
+export interface FileSignalSinkOptions {
+    /** JSONL 文件路径 */
+    readonly filePath: string;
+    /** 批量 flush 间隔（ms，默认 5000） */
+    readonly flushIntervalMs?: number;
+    /** 触发立即 flush 的缓冲大小（默认 50） */
+    readonly flushThreshold?: number;
+}
+/**
+ * 内存信号收集器（测试用）
+ *
+ * drain() 返回当前缓冲并清空，但不涉及文件 IO。
+ */
+export declare class MemorySignalSink implements SignalSink {
+    private readonly events;
+    append(event: ToolCallEvent): void;
+    drain(): readonly ToolCallEvent[];
+    prune(olderThanMs: number): Promise<void>;
+    /** 当前缓冲长度（不断言 drain 后的状态） */
+    get size(): number;
+    /** 查看当前缓冲（不消费） */
+    peek(): readonly ToolCallEvent[];
+}
+/**
+ * 创建默认的 FileSignalSink（便捷工厂）
+ *
+ * 文件位置:`<dataRoot>/.co-engram/signals.jsonl`,与 audit.jsonl /
+ * proposals.jsonl / topic-clusters.jsonl / prompt-signals.json 等其它
+ * 状态文件保持一致。
+ *
+ * 历史遗留:0.x 版本曾写到 `<dataRoot>/signals.jsonl`(根目录),与其它状态
+ * 文件不在同一子目录,导致用户备份 `.co-engram/` 时会漏掉 signals。此处会
+ * 自动把根目录的旧文件迁移到新位置(只在首次创建 sink 时执行一次,代价极低)。
+ */
+export declare function createDefaultSignalSink(dataRoot: string): FileSignalSink;
+/** 仅用于测试：清空文件 */
+export declare function resetFileSignalSink(sink: FileSignalSink): void;
+//# sourceMappingURL=file-sink.d.ts.map

package/dist/signals/file-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-sink.d.ts","sourceRoot":"","sources":["../../src/signals/file-sink.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAaH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAkC5D;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,OAAO,EAAE,qBAAqB;IAU1C,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAYlC,KAAK,IAAI,SAAS,aAAa,EAAE;IAqB3B,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/C,0BAA0B;IACpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;;;OAKG;IACH,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,SAAS;CAgBlB;AAED,MAAM,WAAW,qBAAqB;IACpC,iBAAiB;IACjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8BAA8B;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,8BAA8B;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAE9C,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAIlC,KAAK,IAAI,SAAS,aAAa,EAAE;IAM3B,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/C,6BAA6B;IAC7B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,kBAAkB;IAClB,IAAI,IAAI,SAAS,aAAa,EAAE;CAGjC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAIxE;AAkBD,iBAAiB;AACjB,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAU9D"}