@thread-memory/core 0.1.0

package/dist/query.test.js

@@ -0,0 +1,162 @@
+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 { queryMemory, queryEvents, queryStructured } from "./query.js";
+import { ThreadStore } from "./store.js";
+let dir;
+let store;
+beforeAll(() => {
+    dir = mkdtempSync(join(tmpdir(), "thread-query-"));
+    store = new ThreadStore({ eventsPath: join(dir, "events.db"), structuredPath: join(dir, "structured.db"), projectKey: "test-proj" });
+    store.append({
+        session_id: "q1",
+        kind: "user_message",
+        ts: "2026-08-13T00:00:00.000Z",
+        body: "帮我实现登录功能，密码用 bcrypt 加密",
+    });
+    store.append({
+        session_id: "q1",
+        kind: "tool_call",
+        ts: "2026-08-13T00:00:01.000Z",
+        body: "创建 auth 模块，使用 bcrypt 加密密码",
+        meta: { tool_name: "Write", file_path: "src/auth.ts" },
+    });
+    store.append({
+        session_id: "q1",
+        kind: "tool_result",
+        ts: "2026-08-13T00:00:02.000Z",
+        body: "auth 模块已创建，含 bcrypt 哈希函数",
+    });
+    store.append({
+        session_id: "q2",
+        kind: "user_message",
+        ts: "2026-08-13T00:00:03.000Z",
+        body: "完全无关的内容：今天天气不错",
+    });
+});
+afterAll(() => {
+    store.close();
+    rmSync(dir, { recursive: true, force: true });
+});
+describe("queryMemory", () => {
+    it("returns found with BM25 hits", () => {
+        const result = queryMemory(store, "bcrypt 加密", { sessionId: "q1" });
+        expect(result.status).toBe("found");
+        expect(result.results.length).toBeGreaterThan(0);
+        expect(result.results[0].kind).toBe("user");
+    });
+    it("returns not-found with actionable note", () => {
+        const result = queryMemory(store, "不存在的概念量子咖啡机", { sessionId: "q1" });
+        expect(result.status).toBe("not-found");
+        expect(result.results).toHaveLength(0);
+        expect(result.note).toContain("未检索到");
+        expect(result.note).toContain("建议");
+    });
+    it("filters by session and hides isolated content from others", () => {
+        // 未隔离内容跨会话可见（跨会话继承检索语义）
+        const visible = queryMemory(store, "bcrypt", { sessionId: "q2" });
+        expect(visible.status).toBe("found");
+        // 隔离内容对其他会话不可见（全链路过滤）
+        store.append({
+            session_id: "q-iso",
+            kind: "user_message",
+            ts: "2026-08-13T00:00:04.000Z",
+            body: "秘密计划代号红隼",
+        }, { isolation: true });
+        const hidden = queryMemory(store, "红隼", { sessionId: "q2" });
+        expect(hidden.status).toBe("not-found");
+        // 隔离会话自己可见
+        const self = queryMemory(store, "红隼", { sessionId: "q-iso" });
+        expect(self.status).toBe("found");
+    });
+    it("respects token budget", () => {
+        const small = queryMemory(store, "登录 模块 bcrypt auth", {
+            sessionId: "q1",
+            tokenBudget: 10,
+        });
+        const large = queryMemory(store, "登录 模块 bcrypt auth", {
+            sessionId: "q1",
+            tokenBudget: 4000,
+        });
+        const smallChars = small.results.reduce((n, r) => n + r.body.length, 0);
+        expect(smallChars).toBeLessThanOrEqual(20 * 2 + 64);
+        expect(large.results.length).toBeGreaterThanOrEqual(small.results.length);
+    });
+    it("falls through to not-found when no episode summary exists", () => {
+        const result = queryMemory(store, "summary-marker", { sessionId: "q1" });
+        expect(result.status).toBe("not-found");
+    });
+    it("degrades to episode summary on partial-token mismatch", () => {
+        store.append({
+            session_id: "q1",
+            kind: "user_message",
+            ts: "2026-08-13T00:00:10.000Z",
+            body: "继续开发",
+        });
+        const result = queryMemory(store, "bcryp", { sessionId: "q1" });
+        expect(result.status).toBe("degraded");
+        expect(result.results[0].kind).toBe("summary");
+        expect(result.results[0].body).toContain("bcrypt");
+    });
+    it("queryEvents filters by kind and time range", () => {
+        const result = queryEvents(store, {
+            sessionId: "q1",
+            kind: "user_message",
+            timeRange: { since: "2026-08-13T00:00:00.000Z", until: "2026-08-13T00:00:11.000Z" },
+            order: "asc",
+        });
+        expect(result.status).toBe("found");
+        expect(result.results.length).toBeGreaterThan(0);
+        expect(result.results.every((r) => r.kind === "user")).toBe(true);
+        const first = result.results[0];
+        expect(first.ts).toBe("2026-08-13T00:00:00.000Z");
+    });
+    it("queryEvents counts events", () => {
+        const result = queryEvents(store, {
+            sessionId: "q1",
+            kind: ["tool_call", "tool_result"],
+            count: true,
+        });
+        expect(result.status).toBe("found");
+        expect(result.count).toBe(2);
+    });
+    it("queryEvents returns not-found on empty range", () => {
+        const result = queryEvents(store, {
+            sessionId: "q1",
+            timeRange: { since: "2030-01-01T00:00:00.000Z" },
+        });
+        expect(result.status).toBe("not-found");
+        expect(result.results).toHaveLength(0);
+    });
+    it("queryStructured returns table rows with ids (② 后置入口)", () => {
+        store.addGoal("q1", "登录用 JWT");
+        const fb = store.addFeedback("q1", "不要用 pwsh", "correction");
+        const goals = queryStructured(store, { sessionId: "q1", table: "goals" });
+        expect(goals.status).toBe("found");
+        expect(goals.results.some((r) => r.body === "登录用 JWT")).toBe(true);
+        const fbRes = queryStructured(store, { sessionId: "q1", table: "feedback" });
+        expect(fbRes.results[0].segment_id).toBe(fb.id);
+        expect(fbRes.results[0].body).toBe("不要用 pwsh");
+    });
+    it("queryStructured applies isolation filtering (隔离语义与事件一致)", () => {
+        store.addFeedback("q-iso", "秘密偏好", "preference", { isolation: true });
+        const other = queryStructured(store, { sessionId: "q1", table: "feedback" });
+        expect(other.results.some((r) => r.body === "秘密偏好")).toBe(false);
+        const self = queryStructured(store, { sessionId: "q-iso", table: "feedback" });
+        expect(self.results.some((r) => r.body === "秘密偏好")).toBe(true);
+    });
+    it("queryStructured supports count", () => {
+        const res = queryStructured(store, { sessionId: "q1", table: "goals", count: true });
+        expect(res.count).toBeGreaterThanOrEqual(1);
+    });
+    it("queryEvents exposes isolation flag on event rows (⑨)", () => {
+        const result = queryEvents(store, { sessionId: "q-iso", order: "desc" });
+        expect(result.status).toBe("found");
+        const hit = result.results.find((r) => r.body.includes("红隼"));
+        expect(hit?.isolation).toBe(1);
+        const shared = queryEvents(store, { sessionId: "q1", order: "desc" });
+        expect(shared.results.every((r) => r.isolation === 0)).toBe(true);
+    });
+});
+//# sourceMappingURL=query.test.js.map

package/dist/query.test.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,4 @@
+import type Database from "better-sqlite3";
+export declare const SCHEMA_VERSION = 3;
+export type SchemaKind = "events" | "structured";
+export declare function ensureSchema(db: Database.Database, kind: SchemaKind): void;

package/dist/schema.js

@@ -0,0 +1,92 @@
+export const SCHEMA_VERSION = 3;
+// 双库（B④）：事件库（events/episodes/spills/lineage_edges 事件域）与结构化库
+// （goals/decisions/feedback/entities/decision_entities/metrics/lineage_edges 结构化域）
+// 各库独立 schema_version 表、独立迁移链，共用 SCHEMA_VERSION。
+// 迁移只负责：旧库按需补 v2 列/表，幂等（列存在则跳过），最后写 schema_version。
+export function ensureSchema(db, kind) {
+    db.exec(`CREATE TABLE IF NOT EXISTS schema_version (
+    version INTEGER NOT NULL,
+    applied_at TEXT NOT NULL
+  );`);
+    const row = db.prepare(`SELECT COALESCE(MAX(version), 0) AS v FROM schema_version`).get();
+    if (row.v >= SCHEMA_VERSION)
+        return;
+    db.transaction(() => {
+        const cols = (t) => new Set(db.prepare(`PRAGMA table_info(${t})`).all().map((c) => c.name));
+        if (kind === "events") {
+            const eventsCols = cols("events");
+            if (!eventsCols.has("project_key"))
+                db.exec(`ALTER TABLE events ADD COLUMN project_key TEXT`);
+            if (!eventsCols.has("scope"))
+                db.exec(`ALTER TABLE events ADD COLUMN scope TEXT NOT NULL DEFAULT 'project'`);
+            if (!eventsCols.has("origin"))
+                db.exec(`ALTER TABLE events ADD COLUMN origin TEXT`);
+            if (!eventsCols.has("spilled"))
+                db.exec(`ALTER TABLE events ADD COLUMN spilled INTEGER NOT NULL DEFAULT 0`);
+            if (!eventsCols.has("isolation"))
+                db.exec(`ALTER TABLE events ADD COLUMN isolation INTEGER NOT NULL DEFAULT 0`);
+            db.exec(`CREATE INDEX IF NOT EXISTS idx_events_project ON events(project_key, ts)`);
+            db.exec(`CREATE UNIQUE INDEX IF NOT EXISTS idx_events_origin ON events(origin) WHERE origin IS NOT NULL`);
+            db.exec(`CREATE TABLE IF NOT EXISTS spills (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        event_id INTEGER NOT NULL REFERENCES events(id),
+        ref TEXT NOT NULL,
+        blob TEXT,
+        sha256 TEXT NOT NULL,
+        created_at TEXT NOT NULL
+      );`);
+        }
+        else {
+            for (const t of ["goals", "decisions"]) {
+                const c = cols(t);
+                if (!c.has("project_key"))
+                    db.exec(`ALTER TABLE ${t} ADD COLUMN project_key TEXT`);
+                if (!c.has("scope"))
+                    db.exec(`ALTER TABLE ${t} ADD COLUMN scope TEXT NOT NULL DEFAULT 'project'`);
+                if (!c.has("origin"))
+                    db.exec(`ALTER TABLE ${t} ADD COLUMN origin TEXT`);
+                if (!c.has("isolation"))
+                    db.exec(`ALTER TABLE ${t} ADD COLUMN isolation INTEGER NOT NULL DEFAULT 0`);
+                db.exec(`CREATE INDEX IF NOT EXISTS idx_${t}_project ON ${t}(project_key, status)`);
+            }
+            {
+                const c = cols("feedback");
+                if (!c.has("project_key"))
+                    db.exec(`ALTER TABLE feedback ADD COLUMN project_key TEXT`);
+                if (!c.has("scope"))
+                    db.exec(`ALTER TABLE feedback ADD COLUMN scope TEXT NOT NULL DEFAULT 'project'`);
+                if (!c.has("origin"))
+                    db.exec(`ALTER TABLE feedback ADD COLUMN origin TEXT`);
+                if (!c.has("isolation"))
+                    db.exec(`ALTER TABLE feedback ADD COLUMN isolation INTEGER NOT NULL DEFAULT 0`);
+                db.exec(`CREATE INDEX IF NOT EXISTS idx_feedback_project ON feedback(project_key, kind)`);
+            }
+            db.exec(`CREATE TABLE IF NOT EXISTS session_isolation (
+        session_id TEXT PRIMARY KEY,
+        isolated INTEGER NOT NULL DEFAULT 0,
+        updated_at TEXT NOT NULL
+      );`);
+            db.exec(`CREATE TABLE IF NOT EXISTS entities (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        name TEXT NOT NULL UNIQUE,
+        kind TEXT NOT NULL
+      );`);
+            db.exec(`CREATE TABLE IF NOT EXISTS decision_entities (
+        decision_id INTEGER NOT NULL REFERENCES decisions(id),
+        entity_id INTEGER NOT NULL REFERENCES entities(id),
+        edge TEXT NOT NULL DEFAULT 'references',
+        ts TEXT NOT NULL,
+        PRIMARY KEY (decision_id, entity_id)
+      );`);
+            db.exec(`CREATE TABLE IF NOT EXISTS metrics (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        event_id INTEGER,
+        name TEXT NOT NULL,
+        value REAL NOT NULL,
+        ts TEXT NOT NULL
+      );`);
+        }
+        db.prepare(`INSERT INTO schema_version (version, applied_at) VALUES (?, ?)`).run(SCHEMA_VERSION, new Date().toISOString());
+    })();
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/dist/schema.test.d.ts

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

package/dist/schema.test.js

@@ -0,0 +1,80 @@
+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 { ensureSchema } from "./schema.js";
+describe("schema v2 migration (B④ 双库)", () => {
+    it("migrates a v1 events db (adds columns/tables)", () => {
+        const dir = mkdtempSync(join(tmpdir(), "thread-migrate-events-"));
+        const dbPath = join(dir, "events.db");
+        const db = new Database(dbPath);
+        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
+    );
+    INSERT INTO events (session_id, kind, ts, seq, body) VALUES ('s-old', 'user_message', '2026-08-13T00:00:00.000Z', 1, 'legacy data');`);
+        ensureSchema(db, "events");
+        const count = db.prepare("SELECT COUNT(*) AS c FROM events").get();
+        expect(count.c).toBe(1);
+        const cols = new Set(db.prepare("PRAGMA table_info(events)").all().map((c) => c.name));
+        for (const col of ["project_key", "scope", "origin", "spilled", "isolation"])
+            expect(cols.has(col)).toBe(true);
+        for (const t of ["spills", "schema_version"]) {
+            expect(db.prepare(`SELECT 1 FROM sqlite_master WHERE type='table' AND name=?`).get(t), `table ${t}`).toBeTruthy();
+        }
+        expect(db.prepare("SELECT MAX(version) AS v FROM schema_version").get().v).toBe(3);
+        db.close();
+        rmSync(dir, { recursive: true, force: true });
+    });
+    it("migrates a v1 structured db (adds columns/tables)", () => {
+        const dir = mkdtempSync(join(tmpdir(), "thread-migrate-structured-"));
+        const dbPath = join(dir, "structured.db");
+        const db = new Database(dbPath);
+        db.exec(`CREATE TABLE goals (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      session_id TEXT NOT NULL,
+      text TEXT NOT NULL,
+      status TEXT NOT NULL DEFAULT 'active',
+      source_event INTEGER,
+      created_at TEXT NOT NULL
+    );
+    CREATE TABLE decisions (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      session_id TEXT NOT NULL,
+      text TEXT NOT NULL,
+      status TEXT NOT NULL DEFAULT 'proposed',
+      superseded_by INTEGER,
+      source_event INTEGER,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL
+    );
+    CREATE TABLE feedback (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      session_id TEXT NOT NULL,
+      text TEXT NOT NULL,
+      kind TEXT NOT NULL DEFAULT 'preference',
+      source_event INTEGER,
+      created_at TEXT NOT NULL
+    );`);
+        ensureSchema(db, "structured");
+        for (const t of ["goals", "decisions", "feedback"]) {
+            const cols = new Set(db.prepare(`PRAGMA table_info(${t})`).all().map((c) => c.name));
+            for (const col of ["project_key", "scope", "origin", "isolation"])
+                expect(cols.has(col), `${t}.${col}`).toBe(true);
+        }
+        for (const t of ["entities", "decision_entities", "metrics", "session_isolation", "schema_version"]) {
+            expect(db.prepare(`SELECT 1 FROM sqlite_master WHERE type='table' AND name=?`).get(t), `table ${t}`).toBeTruthy();
+        }
+        expect(db.prepare("SELECT MAX(version) AS v FROM schema_version").get().v).toBe(3);
+        db.close();
+        rmSync(dir, { recursive: true, force: true });
+    });
+});
+//# sourceMappingURL=schema.test.js.map

package/dist/schema.test.js.map

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

package/dist/state.d.ts

@@ -0,0 +1,4 @@
+export type DecisionStatus = "proposed" | "active" | "superseded" | "revoked";
+export declare function canTransition(from: DecisionStatus, to: DecisionStatus): boolean;
+export declare function assertTransition(from: DecisionStatus, to: DecisionStatus): void;
+export type GoalStatus = "active" | "completed" | "abandoned";

package/dist/state.js

@@ -0,0 +1,15 @@
+const TRANSITIONS = {
+    proposed: ["active", "superseded", "revoked"],
+    active: ["superseded", "revoked"],
+    superseded: [],
+    revoked: [],
+};
+export function canTransition(from, to) {
+    return TRANSITIONS[from].includes(to);
+}
+export function assertTransition(from, to) {
+    if (!canTransition(from, to)) {
+        throw new Error(`invalid decision transition: ${from} -> ${to}`);
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAA6C;IAC5D,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,CAAC;IAC7C,MAAM,EAAE,CAAC,YAAY,EAAE,SAAS,CAAC;IACjC,UAAU,EAAE,EAAE;IACd,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,IAAoB,EAAE,EAAkB;IACpE,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAoB,EAAE,EAAkB;IACvE,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,OAAO,EAAE,EAAE,CAAC,CAAC;IACnE,CAAC;AACH,CAAC"}

package/dist/status-card.d.ts

@@ -0,0 +1,10 @@
+import type { ThreadStore } from "./store.js";
+export interface BuildStatusCardOptions {
+    sessionId: string;
+    projectKey?: string;
+    budgetLines?: number;
+    recentCount?: number;
+    isolated?: boolean;
+    firstTurn?: boolean;
+}
+export declare function buildStatusCard(store: ThreadStore, opts: BuildStatusCardOptions): string;

package/dist/status-card.js

@@ -0,0 +1,65 @@
+import { applyScopePriority } from "./store.js";
+export function buildStatusCard(store, opts) {
+    const sessionId = opts.sessionId;
+    const projectKey = opts.projectKey;
+    const budgetLines = opts.budgetLines ?? 100;
+    const firstTurn = opts.firstTurn ?? false;
+    const recentCount = opts.recentCount ?? (firstTurn ? 5 : 3);
+    const listLimit = firstTurn ? 8 : 5;
+    const feedbackLimit = firstTurn ? 8 : 5;
+    const isolated = opts.isolated ?? false;
+    let goals = [];
+    let decisions = [];
+    let feedback = [];
+    let recent = [];
+    try {
+        if (isolated) {
+            // 隔离模式：只显示本会话内容（不继承项目/全局），状态卡不随其他代理变动
+            goals = store.getActiveGoals(sessionId);
+            decisions = store.getActiveDecisions(sessionId);
+            feedback = store.getFeedback(sessionId, feedbackLimit);
+        }
+        else {
+            goals = applyScopePriority(store.getActiveGoalsMerged(sessionId, projectKey));
+            decisions = applyScopePriority(store.getActiveDecisionsMerged(sessionId, projectKey));
+            feedback = applyScopePriority(store.getFeedbackMerged(sessionId, projectKey, feedbackLimit));
+        }
+        recent = store.getRecentEvents(sessionId, recentCount);
+    }
+    catch {
+        // 状态卡是主路径增强，任何失败都降级为最小卡，绝不阻塞
+    }
+    const shareMark = (row) => row.scope === "global" ? "（全局）" : row.session_id !== sessionId ? "（来自其他会话）" : "";
+    const lines = [];
+    lines.push(isolated ? "[Thread 会话记忆状态卡]（本会话已隔离，内容仅自己可见）" : "[Thread 会话记忆状态卡]");
+    if (goals.length > 0) {
+        lines.push("目标:");
+        goals
+            .slice()
+            .reverse()
+            .slice(0, listLimit)
+            .forEach((g, i) => lines.push(`  ${i + 1}. ${g.text.slice(0, 120)}${shareMark(g)} #${g.id}`));
+    }
+    if (decisions.length > 0) {
+        lines.push("决策（生效中）:");
+        decisions.slice(0, listLimit).forEach((d, i) => lines.push(`  ${i + 1}. ${d.text.slice(0, 120)}${shareMark(d)} #${d.id}`));
+    }
+    if (feedback.length > 0) {
+        lines.push("偏好:");
+        feedback.forEach((f) => {
+            lines.push(`  - ${f.text.slice(0, 120)}${shareMark(f)} #${f.id}`);
+        });
+    }
+    if (recent.length > 0) {
+        lines.push("最近事件:");
+        recent
+            .slice()
+            .reverse()
+            .forEach((e) => lines.push(`  - ${e.kind}: ${e.body.slice(0, 60)}`));
+    }
+    // 收束语（外部借鉴③）：绑定式行动收束，防止纯"再想想"式开放引导
+    lines.push("需要更早的历史细节时，调用 query_session_memory 工具查询，并基于结果给出结论。");
+    lines.push("收到 隔离//unisolate//thread-publish 单命令时，只回一句状态确认，不展开思考。");
+    return lines.slice(0, budgetLines).join("\n");
+}
+//# sourceMappingURL=status-card.js.map

package/dist/status-card.js.map

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

package/dist/status-card.test.d.ts

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

package/dist/status-card.test.js

@@ -0,0 +1,53 @@
+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 { ThreadStore } from "./store.js";
+let dir;
+let store;
+beforeAll(() => {
+    dir = mkdtempSync(join(tmpdir(), "thread-card-"));
+    store = new ThreadStore({ eventsPath: join(dir, "events.db"), structuredPath: join(dir, "structured.db"), projectKey: "card-proj" });
+    for (let i = 1; i <= 6; i++) {
+        store.addGoal("s1", `目标 ${i}`);
+        store.proposeDecision("s1", `决策 ${i}`);
+        store.confirmLatestProposed("s1");
+    }
+    store.addFeedback("s1", "偏好 1", "preference");
+    store.append({ session_id: "s1", kind: "user_message", ts: new Date().toISOString(), body: "事件 1" });
+    store.append({ session_id: "s1", kind: "assistant_message", ts: new Date().toISOString(), body: "事件 2" });
+});
+afterAll(() => {
+    store.close();
+    rmSync(dir, { recursive: true, force: true });
+});
+describe("buildStatusCard（外部借鉴 ①③：首轮加权 + 收束语）", () => {
+    it("尾行收束语为绑定式行动引导（③）", () => {
+        const card = buildStatusCard(store, { sessionId: "s1", projectKey: "card-proj" });
+        expect(card).toContain("需要更早的历史细节时，调用 query_session_memory 工具查询，并基于结果给出结论。");
+    });
+    it("首轮档展示更多目标/决策（① 锚点全量）", () => {
+        const normal = buildStatusCard(store, { sessionId: "s1", projectKey: "card-proj" });
+        const first = buildStatusCard(store, { sessionId: "s1", projectKey: "card-proj", firstTurn: true });
+        const countOf = (card, marker) => card.split("\n").filter((l) => l.includes(marker)).length;
+        expect(countOf(first, "决策 ")).toBeGreaterThan(countOf(normal, "决策 "));
+        expect(countOf(first, "目标 ")).toBeGreaterThan(countOf(normal, "目标 "));
+    });
+    it("首轮档默认 recent 更多（5 条档）", () => {
+        const first = buildStatusCard(store, { sessionId: "s1", projectKey: "card-proj", firstTurn: true });
+        const events = first.split("\n").filter((l) => l.startsWith("  - "));
+        expect(events.length).toBeGreaterThanOrEqual(2);
+    });
+    it("隔离 + 首轮组合不降级崩溃", () => {
+        const card = buildStatusCard(store, { sessionId: "s1", projectKey: "card-proj", isolated: true, firstTurn: true });
+        expect(card).toContain("本会话已隔离");
+    });
+    it("行尾带行 id（① 治理可见性：目标/决策/偏好均可定位）", () => {
+        const card = buildStatusCard(store, { sessionId: "s1", projectKey: "card-proj" });
+        expect(card).toMatch(/决策 1 #\d+/);
+        expect(card).toMatch(/目标 \d+ #\d+/);
+        expect(card).toMatch(/偏好 1 #\d+/);
+    });
+});
+//# sourceMappingURL=status-card.test.js.map

package/dist/status-card.test.js.map

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