@thread-memory/core 0.1.0

package/dist/events.d.ts

@@ -0,0 +1,18 @@
+import type Database from "better-sqlite3";
+export declare const MAX_BODY_CHARS = 100000;
+export type EventKind = "user_message" | "assistant_message" | "tool_call" | "tool_result" | "session_start" | "session_end" | "compact_checkpoint";
+export interface SessionEvent {
+    id: number;
+    session_id: string;
+    kind: EventKind;
+    ts: string;
+    seq: number;
+    body: string;
+    meta?: Record<string, unknown>;
+    truncated: boolean;
+}
+export declare function truncateBody(body: string, maxChars?: number): {
+    body: string;
+    truncated: boolean;
+};
+export declare function eventKindCounts(db: Database.Database): Partial<Record<EventKind, number>>;

package/dist/events.js

@@ -0,0 +1,17 @@
+export const MAX_BODY_CHARS = 100_000;
+export function truncateBody(body, maxChars = MAX_BODY_CHARS) {
+    if (body.length <= maxChars) {
+        return { body, truncated: false };
+    }
+    const kept = body.slice(0, maxChars);
+    return { body: `${kept}\n... [truncated ${body.length - maxChars} chars]`, truncated: true };
+}
+export function eventKindCounts(db) {
+    const counts = {};
+    const rows = db.prepare(`SELECT kind, COUNT(*) AS c FROM events GROUP BY kind`).all();
+    for (const row of rows) {
+        counts[row.kind] = row.c;
+    }
+    return counts;
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAsBtC,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,WAAmB,cAAc;IAC1E,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACpC,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACrC,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,oBAAoB,IAAI,CAAC,MAAM,GAAG,QAAQ,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC/F,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAqB;IACnD,MAAM,MAAM,GAAuC,EAAE,CAAC;IACtD,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,sDAAsD,CAAC,CAAC,GAAG,EAGjF,CAAC;IACH,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/events.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/events.test.js

@@ -0,0 +1,46 @@
+import { describe, expect, it } from "vitest";
+import Database from "better-sqlite3";
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { eventKindCounts } from "./events.js";
+function openEventsDb(prefix) {
+    const dir = mkdtempSync(join(tmpdir(), prefix));
+    const db = new Database(join(dir, "events.db"));
+    db.exec(`CREATE TABLE events (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    session_id TEXT NOT NULL,
+    kind TEXT NOT NULL,
+    ts TEXT NOT NULL,
+    seq INTEGER NOT NULL,
+    body TEXT NOT NULL,
+    meta TEXT,
+    truncated INTEGER NOT NULL DEFAULT 0
+  );`);
+    return { db, dir };
+}
+describe("eventKindCounts", () => {
+    it("counts events grouped by kind", () => {
+        const { db, dir } = openEventsDb("thread-events-");
+        const insert = db.prepare(`INSERT INTO events (session_id, kind, ts, seq, body) VALUES (?, ?, ?, ?, ?)`);
+        const rows = [
+            ["s1", "user_message", "2026-08-13T00:00:00.000Z", 1, "hello"],
+            ["s1", "tool_call", "2026-08-13T00:00:01.000Z", 2, "edit a.ts"],
+            ["s1", "tool_result", "2026-08-13T00:00:02.000Z", 3, "ok"],
+            ["s2", "user_message", "2026-08-13T00:00:03.000Z", 1, "hi"],
+            ["s2", "user_message", "2026-08-13T00:00:04.000Z", 2, "again"],
+        ];
+        for (const row of rows)
+            insert.run(...row);
+        expect(eventKindCounts(db)).toEqual({ user_message: 3, tool_call: 1, tool_result: 1 });
+        db.close();
+        rmSync(dir, { recursive: true, force: true });
+    });
+    it("returns an empty object for an empty table", () => {
+        const { db, dir } = openEventsDb("thread-events-empty-");
+        expect(eventKindCounts(db)).toEqual({});
+        db.close();
+        rmSync(dir, { recursive: true, force: true });
+    });
+});
+//# sourceMappingURL=events.test.js.map

package/dist/events.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.test.js","sourceRoot":"","sources":["../src/events.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,SAAS,YAAY,CAAC,MAAc;IAClC,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;IAChD,EAAE,CAAC,IAAI,CAAC;;;;;;;;;KASL,CAAC,CAAC;IACL,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC;AACrB,CAAC;AAED,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CACvB,6EAA6E,CAC9E,CAAC;QACF,MAAM,IAAI,GAAoD;YAC5D,CAAC,IAAI,EAAE,cAAc,EAAE,0BAA0B,EAAE,CAAC,EAAE,OAAO,CAAC;YAC9D,CAAC,IAAI,EAAE,WAAW,EAAE,0BAA0B,EAAE,CAAC,EAAE,WAAW,CAAC;YAC/D,CAAC,IAAI,EAAE,aAAa,EAAE,0BAA0B,EAAE,CAAC,EAAE,IAAI,CAAC;YAC1D,CAAC,IAAI,EAAE,cAAc,EAAE,0BAA0B,EAAE,CAAC,EAAE,IAAI,CAAC;YAC3D,CAAC,IAAI,EAAE,cAAc,EAAE,0BAA0B,EAAE,CAAC,EAAE,OAAO,CAAC;SAC/D,CAAC;QACF,KAAK,MAAM,GAAG,IAAI,IAAI;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;QAE3C,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;QACvF,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,sBAAsB,CAAC,CAAC;QAEzD,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACxC,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/feedback-guard.d.ts

@@ -0,0 +1,3 @@
+import type { FeedbackRow } from "./store.js";
+export declare function extractBlockedTokens(text: string): string[];
+export declare function matchToolFeedback(rows: readonly FeedbackRow[], toolName: string): FeedbackRow | undefined;

package/dist/feedback-guard.js

@@ -0,0 +1,33 @@
+// B⑥-② 反馈拦截：确定性提取"禁用指令"里的目标工具名，与待执行工具名匹配。
+// 零 LLM、同步——误报可接受（阻断成本低，拒绝原因即教训原文，可见可纠偏）。
+const BLOCK_PATTERNS = [
+    /不要(?:再|直接|再直接)?(?:用|使用|调用)?\s*[`'"]?([A-Za-z_][\w-]{2,}|[\u4e00-\u9fa5]{2,8})[`'"]?/g,
+    /(?:别|禁止|禁用|勿)(?:再|直接|再直接)?(?:用|使用|调用)?\s*[`'"]?([A-Za-z_][\w-]{2,}|[\u4e00-\u9fa5]{2,8})[`'"]?/g,
+    /never\s+(?:use|call)\s+[`'"]?([A-Za-z_][\w-]{2,})[`'"]?/gi,
+    /don'?t\s+(?:use|call)\s+[`'"]?([A-Za-z_][\w-]{2,})[`'"]?/gi,
+    /avoid\s+(?:using|calling)?\s*[`'"]?([A-Za-z_][\w-]{2,})[`'"]?/gi,
+];
+export function extractBlockedTokens(text) {
+    const tokens = new Set();
+    for (const pattern of BLOCK_PATTERNS) {
+        for (const m of text.matchAll(pattern)) {
+            const token = m[1];
+            if (token) {
+                tokens.add(token.toLowerCase());
+            }
+        }
+    }
+    return [...tokens];
+}
+export function matchToolFeedback(rows, toolName) {
+    const name = toolName.toLowerCase();
+    for (const row of rows) {
+        for (const token of extractBlockedTokens(row.text)) {
+            if (token === name || (token.length >= 3 && name.includes(token))) {
+                return row;
+            }
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=feedback-guard.js.map

package/dist/feedback-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-guard.js","sourceRoot":"","sources":["../src/feedback-guard.ts"],"names":[],"mappings":"AAEA,0CAA0C;AAC1C,0CAA0C;AAC1C,MAAM,cAAc,GAAa;IAC/B,sFAAsF;IACtF,iGAAiG;IACjG,2DAA2D;IAC3D,4DAA4D;IAC5D,iEAAiE;CAClE,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACnB,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAA4B,EAC5B,QAAgB;IAEhB,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACpC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,MAAM,KAAK,IAAI,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBAClE,OAAO,GAAG,CAAC;YACb,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/feedback-guard.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/feedback-guard.test.js

@@ -0,0 +1,67 @@
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { extractBlockedTokens, matchToolFeedback } from "./feedback-guard.js";
+import { ThreadStore } from "./store.js";
+const row = (text, kind = "correction") => ({ id: 1, session_id: "s1", text, kind, created_at: "2026-08-15T00:00:00Z" });
+describe("extractBlockedTokens（B⑥-② 禁用指令 token 提取）", () => {
+    it("提取中文指令后的工具名", () => {
+        expect(extractBlockedTokens("不要用 pwsh 直接改文件")).toContain("pwsh");
+        expect(extractBlockedTokens("别再用 Read 读大文件")).toContain("read");
+        expect(extractBlockedTokens("禁止调用 query_session_memory 做验证")).toContain("query_session_memory");
+    });
+    it("提取英文指令后的工具名", () => {
+        expect(extractBlockedTokens("never use bash")).toContain("bash");
+        expect(extractBlockedTokens("don't call git_commit")).toContain("git_commit");
+        expect(extractBlockedTokens("avoid using pwsh")).toContain("pwsh");
+    });
+    it("无禁用指令时返回空", () => {
+        expect(extractBlockedTokens("我记下了用 JWT 做认证")).toHaveLength(0);
+        expect(extractBlockedTokens("项目决策：状态卡预算 200 行")).toHaveLength(0);
+    });
+});
+describe("matchToolFeedback（工具名匹配）", () => {
+    it("命中：token 与工具名相等（大小写不敏感）", () => {
+        const hit = matchToolFeedback([row("不要用 pwsh 改配置")], "pwsh");
+        expect(hit?.text).toContain("pwsh");
+    });
+    it("命中：工具名包含 token（如 edit → edit_file）", () => {
+        const hit = matchToolFeedback([row("不要用 edit 直接改")], "edit_file");
+        expect(hit?.text).toContain("edit");
+    });
+    it("不命中：无关教训", () => {
+        expect(matchToolFeedback([row("不要用 pwsh 改配置")], "read")).toBeUndefined();
+    });
+    it("不命中：短 token 不参与包含匹配（噪声防护）", () => {
+        // "别问了" 提取中文 token，不影响任何英文工具名
+        expect(matchToolFeedback([row("以后别问了")], "write")).toBeUndefined();
+    });
+    it("命中后返回第一条匹配教训原文", () => {
+        const rows = [row("第一条无关"), row("不要用 grep"), row("也不要再用 grep")];
+        expect(matchToolFeedback(rows, "grep")?.text).toBe("不要用 grep");
+    });
+});
+describe("deleteFeedback（B⑥-② 恢复通道：教训可删即恢复）", () => {
+    let dir;
+    let store;
+    beforeAll(() => {
+        dir = mkdtempSync(join(tmpdir(), "thread-guard-"));
+        store = new ThreadStore({ eventsPath: join(dir, "events.db"), structuredPath: join(dir, "structured.db"), projectKey: "guard-proj" });
+    });
+    afterAll(() => {
+        store.close();
+        rmSync(dir, { recursive: true, force: true });
+    });
+    it("删除后守卫不再命中（恢复通道闭环）", () => {
+        const row = store.addFeedback("s1", "不要用 pwsh 改配置", "correction");
+        const before = matchToolFeedback(store.getFeedbackMerged("s1", "guard-proj", 50), "pwsh");
+        expect(before?.id).toBe(row.id);
+        expect(store.deleteFeedback(row.id)).toBe(true);
+        expect(matchToolFeedback(store.getFeedbackMerged("s1", "guard-proj", 50), "pwsh")).toBeUndefined();
+    });
+    it("不存在的 id 返回 false", () => {
+        expect(store.deleteFeedback(999999)).toBe(false);
+    });
+});
+//# sourceMappingURL=feedback-guard.test.js.map

package/dist/feedback-guard.test.js.map

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

package/dist/governor.d.ts

@@ -0,0 +1,16 @@
+import type { EventKind } from "./events.js";
+export interface SpillDecision {
+    spill: boolean;
+    kept: string;
+    ref?: string;
+}
+export declare class SpillPolicy {
+    private threshold;
+    private keptChars;
+    constructor(threshold?: number, keptChars?: number);
+    evaluate(body: string, opts?: {
+        ref?: string;
+    }): SpillDecision;
+}
+export declare const INDEXABLE_KINDS: ReadonlySet<EventKind>;
+export declare function isIndexable(kind: EventKind): boolean;

package/dist/governor.js

@@ -0,0 +1,25 @@
+// 大正文 spill：正文 > 阈值 → 保留前 keptChars 字符摘要 + ref 引用；原文进 spills 表或指向底座日志
+export class SpillPolicy {
+    threshold;
+    keptChars;
+    constructor(threshold = 4096, keptChars = 400) {
+        this.threshold = threshold;
+        this.keptChars = keptChars;
+    }
+    evaluate(body, opts = {}) {
+        if (body.length <= this.threshold) {
+            return { spill: false, kept: body };
+        }
+        return { spill: true, kept: body.slice(0, this.keptChars), ref: opts.ref };
+    }
+}
+// FTS 分层：只索引轻量文本（indexable），tool_call/tool_result 大块不建全文索引，检索按引用回拉
+export const INDEXABLE_KINDS = new Set([
+    "user_message",
+    "assistant_message",
+    "compact_checkpoint",
+]);
+export function isIndexable(kind) {
+    return INDEXABLE_KINDS.has(kind);
+}
+//# sourceMappingURL=governor.js.map

package/dist/governor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governor.js","sourceRoot":"","sources":["../src/governor.ts"],"names":[],"mappings":"AAQA,sEAAsE;AACtE,MAAM,OAAO,WAAW;IAEZ;IACA;IAFV,YACU,YAAY,IAAI,EAChB,YAAY,GAAG;QADf,cAAS,GAAT,SAAS,CAAO;QAChB,cAAS,GAAT,SAAS,CAAM;IACtB,CAAC;IAEJ,QAAQ,CAAC,IAAY,EAAE,OAAyB,EAAE;QAChD,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAClC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACtC,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7E,CAAC;CACF;AAED,mEAAmE;AACnE,MAAM,CAAC,MAAM,eAAe,GAA2B,IAAI,GAAG,CAAY;IACxE,cAAc;IACd,mBAAmB;IACnB,oBAAoB;CACrB,CAAC,CAAC;AAEH,MAAM,UAAU,WAAW,CAAC,IAAe;IACzC,OAAO,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export declare const THREAD_VERSION = "0.0.0";
+export * from "./events.js";
+export * from "./state.js";
+export * from "./store.js";
+export * from "./light-confirm.js";
+export * from "./query.js";
+export * from "./governor.js";
+export * from "./project-key.js";
+export * from "./migrate.js";
+export * from "./paths.js";
+export * from "./status-card.js";
+export * from "./feedback-guard.js";

package/dist/index.js

@@ -0,0 +1,13 @@
+export const THREAD_VERSION = "0.0.0";
+export * from "./events.js";
+export * from "./state.js";
+export * from "./store.js";
+export * from "./light-confirm.js";
+export * from "./query.js";
+export * from "./governor.js";
+export * from "./project-key.js";
+export * from "./migrate.js";
+export * from "./paths.js";
+export * from "./status-card.js";
+export * from "./feedback-guard.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

package/dist/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.test.js

@@ -0,0 +1,8 @@
+import { describe, expect, it } from "vitest";
+import { THREAD_VERSION } from "./index.js";
+describe("core", () => {
+    it("exposes a version", () => {
+        expect(THREAD_VERSION).toBe("0.0.0");
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE;IACpB,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/isolation.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/isolation.test.js

@@ -0,0 +1,102 @@
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { buildStatusCard } from "./status-card.js";
+import { queryEvents } from "./query.js";
+import { ThreadStore } from "./store.js";
+let dir;
+let store;
+beforeAll(() => {
+    dir = mkdtempSync(join(tmpdir(), "thread-isolation-"));
+    store = new ThreadStore({
+        eventsPath: join(dir, "events.db"),
+        structuredPath: join(dir, "structured.db"),
+        projectKey: "proj-iso",
+    });
+});
+afterAll(() => {
+    store.close();
+    rmSync(dir, { recursive: true, force: true });
+});
+describe("会话隔离（B⑧）", () => {
+    it("写入：对话上下文打隔离标记，tool 事件强制共享", () => {
+        const msg = store.append({ session_id: "iso-s1", kind: "user_message", ts: "2026-08-15T00:00:00.000Z", body: "隔离会话消息" }, { isolation: true });
+        expect(msg.isolation).toBe(1);
+        const tool = store.append({ session_id: "iso-s1", kind: "tool_call", ts: "2026-08-15T00:00:01.000Z", body: "改文件", meta: { tool_name: "Write", file_path: "a.ts" } }, { isolation: true });
+        expect(tool.isolation).toBe(0);
+    });
+    it("结构化写入带隔离标记（决策/反馈），跨会话合并视图过滤", () => {
+        store.addFeedback("iso-s1", "隔离会话偏好：用 pnpm", "preference", {
+            scope: "project",
+            projectKey: "proj-iso",
+            isolation: true,
+            ts: "2026-08-15T00:00:02.000Z",
+        });
+        store.proposeDecision("iso-s1", "隔离决策：改用 yarn", {
+            scope: "project",
+            projectKey: "proj-iso",
+            isolation: true,
+            ts: "2026-08-15T00:00:03.000Z",
+        });
+        store.confirmLatestProposed("iso-s1", { ts: "2026-08-15T00:00:04.000Z" });
+        // 本会话自己可见
+        expect(store.getActiveDecisions("iso-s1").some((d) => d.text.includes("yarn"))).toBe(true);
+        // 其他会话（未隔离）看不到隔离内容
+        expect(store.getActiveDecisionsMerged("other-s1", "proj-iso").some((d) => d.text.includes("yarn"))).toBe(false);
+        expect(store.getFeedbackMerged("other-s1", "proj-iso", 10).some((f) => f.text.includes("pnpm"))).toBe(false);
+    });
+    it("检索过滤：search / queryEvents / expand 对他人不可见，自己可见", () => {
+        store.append({ session_id: "iso-s1", kind: "user_message", ts: "2026-08-15T00:00:05.000Z", body: "隔离细节金丝雀编号 8842" }, { isolation: true });
+        expect(store.search("金丝雀", { sessionId: "other-s1" })).toHaveLength(0);
+        expect(store.search("金丝雀", { sessionId: "iso-s1" }).length).toBeGreaterThan(0);
+        const ev = store.append({ session_id: "iso-s1", kind: "user_message", ts: "2026-08-15T00:00:06.000Z", body: "隔离可回拉标记" }, { isolation: true, spillRef: "iso://spill/1" });
+        expect(store.expand(ev.id, { sessionId: "other-s1" })).toContain("隔离内容不可见");
+        expect(store.expand(ev.id, { sessionId: "iso-s1" })).toContain("隔离可回拉标记");
+        const q = queryEvents(store, { sessionId: "other-s1", kind: "user_message" });
+        expect(q.results.some((r) => r.body.includes("金丝雀"))).toBe(false);
+        const self = queryEvents(store, { sessionId: "iso-s1", kind: "user_message" });
+        expect(self.results.some((r) => r.body.includes("金丝雀"))).toBe(true);
+    });
+    it("会话隔离状态切换：进入后写入隔离，解除后历史仍隔离、新写共享", () => {
+        store.setSessionIsolation("iso-s2", true);
+        expect(store.getSessionIsolation("iso-s2")).toBe(true);
+        store.append({ session_id: "iso-s2", kind: "user_message", ts: "2026-08-15T00:00:07.000Z", body: "隔离期内容" }, { isolation: store.getSessionIsolation("iso-s2") });
+        expect(store.eventsDb.prepare(`SELECT isolation FROM events WHERE session_id = 'iso-s2' AND body = '隔离期内容'`).get()).toEqual({ isolation: 1 });
+        store.setSessionIsolation("iso-s2", false);
+        expect(store.getSessionIsolation("iso-s2")).toBe(false);
+        store.append({ session_id: "iso-s2", kind: "user_message", ts: "2026-08-15T00:00:08.000Z", body: "解除后共享内容" }, { isolation: store.getSessionIsolation("iso-s2") });
+        expect(store.eventsDb.prepare(`SELECT isolation FROM events WHERE session_id = 'iso-s2' AND body = '解除后共享内容'`).get()).toEqual({ isolation: 0 });
+        // 历史仍隔离：他人检索不到
+        expect(store.search("隔离期", { sessionId: "other-s1" })).toHaveLength(0);
+    });
+    it("沉淀：unisolateRow 后他人可见，supersede replacement 继承隔离标记", () => {
+        const d = store.getActiveDecisions("iso-s1").find((x) => x.text.includes("yarn"));
+        expect(d).toBeDefined();
+        expect(d?.isolation).toBe(1);
+        const ok = store.unisolateRow("iso-s1", "decisions", d.id);
+        expect(ok).toBe(true);
+        expect(store.getActiveDecisionsMerged("other-s1", "proj-iso").some((x) => x.text.includes("yarn"))).toBe(true);
+        // supersede replacement 继承被 supersede 行的隔离标记
+        store.proposeDecision("iso-s1", "待替换的隔离决策", {
+            scope: "project",
+            projectKey: "proj-iso",
+            isolation: true,
+            ts: "2026-08-15T00:00:09.000Z",
+        });
+        store.confirmLatestProposed("iso-s1", { ts: "2026-08-15T00:00:10.000Z" });
+        const r = store.supersedeLatestActive("iso-s1", "替换后决策", { ts: "2026-08-15T00:00:11.000Z" });
+        expect(r?.replacement.isolation).toBe(1);
+    });
+    it("状态卡：隔离模式只显示本会话内容并标注", () => {
+        const card = buildStatusCard(store, { sessionId: "iso-s1", projectKey: "proj-iso", isolated: true });
+        expect(card).toContain("本会话已隔离");
+        expect(card).toContain("替换后决策");
+        expect(card).not.toContain("（来自其他会话）");
+        // 非隔离模式状态卡包含已沉淀内容（未隔离继承）
+        const normal = buildStatusCard(store, { sessionId: "other-s1", projectKey: "proj-iso" });
+        expect(normal).toContain("yarn");
+        expect(normal).not.toContain("替换后决策");
+    });
+});
+//# sourceMappingURL=isolation.test.js.map

package/dist/isolation.test.js.map

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

package/dist/light-confirm.d.ts

@@ -0,0 +1,37 @@
+import type { Decision, FeedbackRow, Goal, StructuredWriteOptions, ThreadStore } from "./store.js";
+export interface TurnInput {
+    user_msg?: string;
+    assistant_msg?: string;
+}
+export interface GoalAction {
+    text: string;
+    action: "add";
+}
+export type DecisionAction = {
+    action: "propose";
+    text: string;
+} | {
+    action: "confirm";
+} | {
+    action: "revoke";
+} | {
+    action: "supersede";
+    text: string;
+};
+export interface FeedbackAction {
+    text: string;
+    kind: "preference" | "correction";
+}
+export interface TurnAnalysis {
+    goals: GoalAction[];
+    decisions: DecisionAction[];
+    feedback: FeedbackAction[];
+}
+export declare function analyzeTurn(input: TurnInput): TurnAnalysis;
+export interface AppliedTurn {
+    goals: Goal[];
+    decisions: Decision[];
+    feedback: FeedbackRow[];
+}
+export declare function applyTurn(store: ThreadStore, sessionId: string, input: TurnInput, opts?: StructuredWriteOptions): AppliedTurn;
+export declare function applyAnalysis(store: ThreadStore, sessionId: string, input: TurnInput, opts?: StructuredWriteOptions): AppliedTurn;

package/dist/light-confirm.js

@@ -0,0 +1,149 @@
+const ACCEPT_SHORT = new Set([
+    "嗯",
+    "恩",
+    "好",
+    "好的",
+    "可以",
+    "行",
+    "没问题",
+    "ok",
+    "okay",
+    "确认",
+    "同意",
+    "就这样",
+    "不错",
+    "对",
+    "是",
+    "收到",
+    "明白",
+]);
+const ACCEPT_RE = /^(嗯+|好+|行+|可以|没问题|OK|ok|Okay|收到|明白|确认|同意)$/;
+const SUPERSEDE_RE = /(?:改成|改用|换成|改为|换用)[：:，,\s]*([^。！!？?]+)/;
+const REVOKE_RE = /(?:算了|撤销|放弃|不要(?:用|做|要)?了|不要用|别(?:用|做|要)|不用了|回退|改回|别用了)/;
+const DECLARE_RE = [
+    /(?<![忘标登])(?:我|我们)?(?:已|已经)?记下(?:了)?[：:，,\s]*([^。！!？?]+)/,
+    /(?:方案定为|就采用|决定采用)[：:，,\s]*([^。！!？?]+)/,
+    /(?:我|我们)(?:已|已经)?(?:决定(?!性)|确定(?!性))[：:，,\s]*([^。！!？?]+)/,
+];
+const GOAL_RE = /^(?:帮我|请|再帮我|然后帮我|接着帮我|帮我再|还要帮我|麻烦帮我)?(?:实现|修复|重构|添加|新增|完成|构建|创建|删除|优化|升级|接入|验证|设计|规划|开发|搭建|编写|整理|部署|迁移|拆分|合并|安装|配置|生成)/;
+const PREFERENCE_RE = /(?:以后|下次|永远|总是|记得|优先|别再|不要再)/;
+const CORRECTION_RE = /(?:不要|别|别再|不要再)/;
+const MAX_DECISION_TEXT = 200;
+const MAX_GOAL_TEXT = 500;
+export function analyzeTurn(input) {
+    const analysis = { goals: [], decisions: [], feedback: [] };
+    const userRaw = (input.user_msg ?? "").trim();
+    const user = stripPunct(userRaw);
+    const assistantRaw = (input.assistant_msg ?? "").trim();
+    const assistant = stripPunct(assistantRaw);
+    if (user) {
+        if (GOAL_RE.test(user)) {
+            analysis.goals.push({ text: userRaw.slice(0, MAX_GOAL_TEXT), action: "add" });
+        }
+        const isPreference = PREFERENCE_RE.test(user);
+        if (isPreference) {
+            analysis.feedback.push({
+                text: userRaw.slice(0, MAX_GOAL_TEXT),
+                kind: CORRECTION_RE.test(user) ? "correction" : "preference",
+            });
+        }
+        const supersede = userRaw.match(SUPERSEDE_RE);
+        if (supersede) {
+            analysis.decisions.push({ action: "supersede", text: supersede[1].trim().slice(0, MAX_DECISION_TEXT) });
+        }
+        else if (!isPreference) {
+            if (REVOKE_RE.test(user)) {
+                analysis.decisions.push({ action: "revoke" });
+            }
+            else if (ACCEPT_SHORT.has(user) || ACCEPT_RE.test(user)) {
+                analysis.decisions.push({ action: "confirm" });
+            }
+        }
+    }
+    if (assistant) {
+        for (const re of DECLARE_RE) {
+            const m = assistantRaw.match(re);
+            if (m && m[1]?.trim()) {
+                const text = m[1].trim().slice(0, MAX_DECISION_TEXT);
+                if (!/[吗呢吧]$/.test(text)) {
+                    analysis.decisions.push({ action: "propose", text });
+                }
+                break;
+            }
+        }
+    }
+    return analysis;
+}
+export function applyTurn(store, sessionId, input, opts = {}) {
+    const ts = opts.ts ?? new Date().toISOString();
+    let sourceEvent = opts.sourceEvent;
+    const userMsg = (input.user_msg ?? "").trim();
+    const assistantMsg = (input.assistant_msg ?? "").trim();
+    if (userMsg) {
+        const ev = store.append({
+            session_id: sessionId,
+            kind: "user_message",
+            ts,
+            body: userMsg,
+        });
+        sourceEvent ??= ev.id;
+    }
+    if (assistantMsg) {
+        const ev = store.append({
+            session_id: sessionId,
+            kind: "assistant_message",
+            ts,
+            body: assistantMsg,
+        });
+        sourceEvent ??= ev.id;
+    }
+    return applyAnalysis(store, sessionId, input, { ...opts, sourceEvent, ts });
+}
+export function applyAnalysis(store, sessionId, input, opts = {}) {
+    const analysis = analyzeTurn(input);
+    const ts = opts.ts ?? new Date().toISOString();
+    const sourceEvent = opts.sourceEvent;
+    const structuredOpts = { sourceEvent, ts, scope: opts.scope, projectKey: opts.projectKey, origin: opts.origin, isolation: opts.isolation };
+    return store.transact(() => {
+        const applied = { goals: [], decisions: [], feedback: [] };
+        for (const g of analysis.goals) {
+            applied.goals.push(store.addGoal(sessionId, g.text, structuredOpts));
+        }
+        for (const d of analysis.decisions) {
+            switch (d.action) {
+                case "propose":
+                    applied.decisions.push(store.proposeDecision(sessionId, d.text, structuredOpts));
+                    break;
+                case "confirm": {
+                    const confirmed = store.confirmLatestProposed(sessionId, { ts });
+                    if (confirmed) {
+                        applied.decisions.push(confirmed);
+                    }
+                    break;
+                }
+                case "revoke": {
+                    const revoked = store.revokeLatestActive(sessionId, { ts });
+                    if (revoked) {
+                        applied.decisions.push(revoked);
+                    }
+                    break;
+                }
+                case "supersede": {
+                    const result = store.supersedeLatestActive(sessionId, d.text, structuredOpts);
+                    if (result) {
+                        applied.decisions.push(result.superseded, result.replacement);
+                    }
+                    break;
+                }
+            }
+        }
+        for (const f of analysis.feedback) {
+            applied.feedback.push(store.addFeedback(sessionId, f.text, f.kind, structuredOpts));
+        }
+        return applied;
+    });
+}
+function stripPunct(text) {
+    return text.replace(/[，。！!？?、]/g, "").trim();
+}
+//# sourceMappingURL=light-confirm.js.map