/** * Graph merger + trigger + derivation tests (vision §1, 2026-09-02 redesign; * events cleanup 2026-09-27). * The merger (core/graph.ts mergeFindings) is the pipeline's deterministic * apply stage: AUDITED VERDICTS in, ledger appends out — link-or-create * identity (the auditor's linkTo, never string matching) and the * idempotency guarantees. No events ledger: quiz outcomes and * understanding observations are no longer formalized in the graph. * * Ledger isolation: PATHS is fixed at import time, so the five data/graph * ledgers are backed up and cleared before the suite and restored after * (try/finally-shaped: the after() hook always runs, even on failure). * The chat fixtures are real ChatRecords in the chat store (created and * deleted by this suite) — the merger reads exactly what production reads. * The full LLM pipeline (extractor → auditor) is tested in * tests/extraction.test.ts with mock models. */ import assert from "node:assert/strict"; import * as fs from "node:fs"; import { after, describe, it } from "node:test"; import type { AuditVerdicts, GraphChain, GraphNode, SessionFindings } from "../src/core/contracts.ts"; import type { QuestionAnswerData } from "../src/core/question-core.ts"; import type { LhMessage } from "../src/core/native-messages.ts"; import { projectView as projectNative } from "../src/core/view.ts"; import { deriveView, getGraph, graphSnapshot, mergeFindings, type GraphDeps } from "../src/core/graph.ts"; import { coverageSlots } from "../src/core/coverage.ts"; import { graphStore } from "../src/store/graph.ts"; import { chatStore } from "../src/store/chats.ts"; import { LEDGER_FILES, PATHS, SOURCES_FILE } from "../config.ts"; /** The wired fs adapters, exactly what src/server/stores.ts passes in production. */ const graphDeps = { chatStore, graphStore } as const satisfies GraphDeps; /** The session merge source for a chat — what the pipeline passes: the * fold stamp only (the merger reads no transcript; quiz-event rebuilding * died with the events ledger, 2026-09-27). */ function sessionSource(chatId: string): { foldedAt: string } { const record = chatStore.getChat(chatId)!; return { foldedAt: record.updatedAt }; } // ─── ledger isolation (backup-and-clear of data/graph/*.jsonl) ────────────── const LEDGER_PATHS = [...Object.values(LEDGER_FILES), SOURCES_FILE]; const backups: Array<{ file: string; bak: string }> = []; const createdChats: string[] = []; fs.mkdirSync(PATHS.graph, { recursive: true }); for (const file of LEDGER_PATHS) { if (fs.existsSync(file)) { const bak = `${file}.w5test.bak`; fs.renameSync(file, bak); backups.push({ file, bak }); } } after(() => { for (const file of LEDGER_PATHS) { try { fs.unlinkSync(file); } catch { /* nothing was written here */ } } for (const { file, bak } of backups) fs.renameSync(bak, file); for (const id of createdChats) { try { fs.unlinkSync(`${PATHS.chats}/${id}.json`); } catch { /* already gone */ } } }); // ─── fixture builders ──────────────────────────────────────────────────────── // Native fixture builders (Wave B): the record holds pi-native history — // an assistant message carrying tool calls + one tool result per call. The // projection reproduces the old part shapes (state output-available, input // = arguments, output = result details). interface NativeCall { name: string; toolCallId: string; input: Record; output: QuestionAnswerData; } function user(id: string, text: string): LhMessage[] { return [{ id, role: "user", content: text, timestamp: Date.now() } as never]; } /** A teacher-prose message (the coverage unit, owner 2026-09-28). */ function teacher(id: string, text: string): LhMessage[] { return [{ id, role: "assistant", content: [{ type: "text", text }], timestamp: Date.now() } as never]; } function assistant(id: string, calls: NativeCall[]): LhMessage[] { const content = calls.map((c) => ({ type: "toolCall", id: c.toolCallId, name: c.name, arguments: c.input as never })); const out: LhMessage[] = [ { id, role: "assistant", content, api: "openai-completions", provider: "openrouter", model: "test", usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, stopReason: "stop", timestamp: Date.now(), } as never, ]; for (const c of calls) { out.push({ id: `r_${c.toolCallId}`, role: "toolResult", toolCallId: c.toolCallId, toolName: c.name, content: [{ type: "text", text: "ok" }], details: c.output, isError: false, timestamp: Date.now(), } as never); } return out; } function quizPart( toolCallId: string, input: Record, output: QuestionAnswerData, ): NativeCall { return { name: "quiz", toolCallId, input, output }; } function askPart( toolCallId: string, input: Record, output: QuestionAnswerData, ): NativeCall { return { name: "ask_user_question", toolCallId, input, output }; } function answer(over: Partial): QuestionAnswerData { return { kind: "quiz", questionText: "question text", dontKnow: false, answers: [], answeredAt: "2026-08-22T00:00:00.000Z", ...over, }; } /** Create a chat in the real store with messages; returns the record. * Tree-blind world: the plan tree is irrelevant to the merger — no tree. */ function fixtureChat(title: string, messages: LhMessage[]) { const chat = chatStore.createChat(title); createdChats.push(chat.id); chatStore.saveMessages(chat.id, messages); return chatStore.getChat(chat.id)!; } /** The full fixture transcript: five graded quizzes + a dismissed one + an ask. */ function fixtureMessages(): LhMessage[] { return [ user("u1", "teach me the fixture topic"), assistant("a1", [ quizPart( "call-1", { question: "Q1", options: [{ label: "a" }, { label: "b" }], correctAnswer: "a", explanation: "e" }, answer({ questionText: "Q1 text", correct: false, answeredAt: "2026-08-22T01:00:00.000Z" }), ), ]), assistant("a2", [ quizPart( "call-2", { question: "Q2", options: [{ label: "a" }, { label: "b" }], correctAnswer: "a", explanation: "e" }, answer({ questionText: "Q2 text", dontKnow: true, correct: false, answeredAt: "2026-08-22T01:01:00.000Z" }), ), ]), assistant("a3", [ // input.nodeId "alpha" is deliberately present and IGNORED — // attribution is the only quiz→node path in the tree-blind world. quizPart( "call-3", { question: "Q3", nodeId: "alpha", options: [{ label: "a" }, { label: "b" }], correctAnswer: "a", explanation: "e" }, answer({ questionText: "Q3 text", correct: true, thinking: "recalled the diagram", answeredAt: "2026-08-22T02:00:00.000Z" }), ), ]), assistant("a4", [ quizPart( "call-4", { question: "Q4", options: [{ label: "a" }, { label: "b" }], correctAnswer: "a", explanation: "e" }, answer({ questionText: "Q4 text", correct: false, answeredAt: "2026-08-22T02:01:00.000Z" }), ), ]), assistant("a5", [ quizPart( "call-5", { question: "Q5", options: [{ label: "a" }, { label: "b" }], correctAnswer: "a", explanation: "e" }, answer({ questionText: "Q5 text", dontKnow: true, correct: false, answeredAt: "2026-08-22T02:02:00.000Z" }), ), ]), assistant("a6", [ // dismissed quiz + an answered ask — neither becomes an event quizPart( "call-6", { question: "Q6", options: [{ label: "a" }, { label: "b" }], correctAnswer: "a", explanation: "e" }, answer({ questionText: "Q6 text", dismissed: true }), ), askPart( "call-7", { question: "free text?" }, answer({ kind: "ask", questionText: "free text?", text: "because" }), ), ]), ].flat(); } /** The extractor's findings for the fixture chat: three propositions, * one follows edge (the graph starts empty — no links). */ function fixtureFindings(): SessionFindings { return { propositions: [ { id: "p1", name: "Alpha", statement: "Alpha intuition", aliases: ["alpha feel"], }, { id: "p2", name: "Beta rule", statement: "Beta rule", aliases: [], }, { id: "p3", name: "Gamma", statement: "Gamma application", aliases: [], }, ], chains: [ { premises: ["p1"], conclusion: "p2", }, ], }; } /** The auditor's verdicts when nothing links: an empty verdict set is a * valid full review (verdicts-only, owner 2026-09-28). */ function fixtureVerdicts(): AuditVerdicts { return { links: [] }; } /** The chat every merger test folds (shared, so ordering is intentional). */ const chat1 = fixtureChat("Graph fixture", fixtureMessages()); /** Set by the cross-session tests; the snapshot test (which runs after) reads them. */ let chat2Id = ""; let chat3Id = ""; // ─── the merger ────────────────────────────────────────────────────────────── /** Everything the graph holds for a set of chats (other processes' test * emissions run concurrently against the same files — scope, never assume). */ function scopedGraph(chatIds: string[]) { const graph = getGraph(graphStore); return { nodes: graph.nodes.filter((n) => n.provenance.some((pt) => chatIds.includes(pt.chatId))), chains: graph.chains.filter((c) => c.provenance.some((pt) => chatIds.includes(pt.chatId))), }; } describe("the merger (mergeFindings)", () => { it("creates nodes from the verdicts with chat-level provenance", () => { const stats = mergeFindings(chat1.id, fixtureFindings(), fixtureVerdicts(), graphDeps, sessionSource(chat1.id)); assert.deepEqual(stats, { nodes: 3, chains: 1 }); const graph = scopedGraph([chat1.id]); assert.equal(graph.nodes.length, 3); const idByStatement = new Map(graph.nodes.map((n) => [n.statement, n.id])); for (const node of graph.nodes) { assert.match(node.id, /^n_/); assert.ok(node.name.length > 0, "name is required"); assert.equal("kind" in node, false, "no kind field"); assert.ok(Array.isArray(node.provenance), "provenance attached"); } // Provenance is CHAT-LEVEL (submit-schema slim, 2026-09-28): // propositions no longer carry message ids — the run's source key // is the whole provenance. const alpha = graph.nodes.find((n) => n.statement === "Alpha intuition")!; assert.deepEqual(alpha.provenance, [{ chatId: chat1.id, messageId: "" }]); // The stored chain, provenance attached. assert.equal(graph.chains.length, 1); const chain = graph.chains[0]!; assert.match(chain.id, /^arg_/, "store-minted argument id"); assert.deepEqual(chain.premises, [idByStatement.get("Alpha intuition")]); assert.equal(chain.conclusion, idByStatement.get("Beta rule")); assert.deepEqual(chain.provenance, [{ chatId: chat1.id, messageId: "" }]); }); it("merges INDEPENDENTLY per call — no cross-run identity (owner, 2026-09-29)", () => { // The mappings ledger is gone: resolution is a job-local in-memory // map, so a second merge of the same verdicts knows nothing of the // first. Cross-run identity is the AUDITOR's job (linkTo) plus the // coverage ledger (nothing re-extracts) — never the merger's. // (Own chat + unique statements — this suite stacks on shared // files, so nothing here may touch the other tests' counts.) const rep = fixtureChat("Independence fixture", [user("u1", "rep")].flat()); const findings: SessionFindings = { propositions: [ { id: "p1", name: "Rep one", statement: "Independence one statement", aliases: [] }, { id: "p2", name: "Rep two", statement: "Independence two statement", aliases: [] }, ], chains: [{ premises: ["p1"], conclusion: "p2" }], }; const first = mergeFindings(rep.id, findings, { links: [] }, graphDeps, sessionSource(rep.id)); assert.deepEqual(first, { nodes: 2, chains: 1 }); const second = mergeFindings(rep.id, findings, { links: [] }, graphDeps, sessionSource(rep.id)); assert.deepEqual(second, { nodes: 2, chains: 1 }, "nothing remembered — everything re-creates"); const graph = scopedGraph([rep.id]); assert.equal(graph.nodes.length, 4, "the propositions merge again as fresh nodes"); assert.equal(graph.chains.length, 2, "fresh endpoints — fresh chain assertions"); // exactly one checkpoint line per merge, though — checkpoints are a log assert.equal(graphStore.readCheckpoints().filter((c) => c.chatId === rep.id).length, 2); }); it("is idempotent WITHIN one submit — a repeated proposition id resolves once", () => { const dup = fixtureChat("Duplicate-id fixture", [user("u1", "dup")].flat()); const findings: SessionFindings = { propositions: [ { id: "p1", name: "Dup", statement: "Dup statement", aliases: [] }, { id: "p1", name: "Dup", statement: "Dup statement", aliases: [] }, ], chains: [], }; const stats = mergeFindings(dup.id, findings, { links: [] }, graphDeps, sessionSource(dup.id)); assert.deepEqual(stats, { nodes: 1, chains: 0 }, "the duplicate id is skipped — first resolution stands"); }); it("applies a linkTo verdict: phrasings join aliases, provenance unions, no duplicate node", () => { const alphaId = scopedGraph([chat1.id]).nodes.find((n) => n.statement === "Alpha intuition")!.id; const chat2 = fixtureChat("Graph fixture 2", [ user("u1", "again"), assistant("a1", [ quizPart( "call-9", { question: "Q9", options: [{ label: "a" }, { label: "b" }], correctAnswer: "a", explanation: "e" }, answer({ questionText: "Q9 text", correct: true, answeredAt: "2026-08-22T03:00:00.000Z" }), ), ]), ].flat()); chat2Id = chat2.id; // The auditor's identity verdict: this proposition IS the alpha node. const stats = mergeFindings( chat2.id, { propositions: [ { id: "q1", name: "Alpha", statement: "Alpha feel", // a DIFFERENT phrasing — identity is the verdict, not strings aliases: ["alpha intuition"], }, ], chains: [], }, // VERDICTS-ONLY: the identity call is a link entry, not a field // on the proposition (owner, 2026-09-28). { links: [{ id: "q1", linkTo: alphaId }] }, graphDeps, sessionSource(chat2.id), ); assert.deepEqual(stats, { nodes: 0, chains: 0 }); const after = scopedGraph([chat1.id, chat2.id]); assert.equal(after.nodes.length, 3, "no duplicate node"); const alpha = getGraph(graphStore).nodes.find((n) => n.id === alphaId)!; assert.ok(alpha.aliases.includes("Alpha feel"), "the session's phrasing joins the aliases"); assert.ok(alpha.aliases.includes("alpha intuition")); assert.ok( alpha.provenance.some((pt) => pt.chatId === chat2.id), "provenance unions", ); }); it("resolves imported-notes ids to their file paths in the snapshot (static provenance)", () => { // The notes front door in miniature: a source record + a merge under // its src id — the snapshot must label it with the file path (a // static entry), never as a chat session. graphStore.upsertSource({ id: "src_snapfixture", filePath: "/vault/learn vim.md", importedAt: "2026-09-13T00:00:00.000Z" }); mergeFindings( "src_snapfixture", { propositions: [ { id: "p1", name: "Vim registers", statement: "Vim registers map single keys to editing commands.", aliases: [], }, ], chains: [], }, { links: [] }, graphDeps, { foldedAt: "2026-09-13T00:00:00.000Z" }, ); const snap = graphSnapshot(graphDeps); const node = snap.nodes.find((n) => n.statement === "Vim registers map single keys to editing commands.")!; assert.equal(snap.fileSources["src_snapfixture"], "/vault/learn vim.md"); assert.deepEqual(snap.nodeSessions[node.id], ["src_snapfixture"], "the file entry joins the node's sessions list"); assert.equal(snap.sessions["src_snapfixture"], undefined, "a notes source is never a chat session"); }); it("derives BIRTH-SESSION clusters in graphSnapshot, labeled with the session's name", () => { // Wave 7 (owner-locked 2026-09-23): embeddings are dead — a cluster is // the session that BIRTHED its propositions, derived on read from // provenance. No ledger partition to play, no LLM naming pass — the // label IS the session's name (chat title / file path). const tri = ["Alpha.", "Beta.", "Gamma cluster."] as const; graphStore.upsertSource({ id: "src_clusterfixture", filePath: "/vault/cluster notes.md", importedAt: "2026-09-13T00:00:00.000Z" }); const merge = mergeFindings( "src_clusterfixture", { propositions: tri.map((statement, i) => ({ id: `p${i + 1}`, name: `Cluster node ${i + 1}`, statement, aliases: [], })), chains: [ { premises: ["p1"], conclusion: "p2", }, { premises: ["p2"], conclusion: "p3", }, ], }, { links: [] }, graphDeps, { foldedAt: "2026-09-13T00:00:00.000Z" }, ); assert.equal(merge.nodes, 3); const snap = graphSnapshot(graphDeps); // Presentation threshold: every cluster is >= 3 members. assert.ok(snap.clusters.every((c) => c.members.length >= 3)); // Our trio is exactly one cluster — the notes file that BIRTHED it, // labeled with its path, id = the source id (stable, no content hash). const mine = snap.clusters.find((c) => c.members.length === 3 && tri.every((s) => c.members.includes(snap.nodes.find((n) => n.statement === s)!.id))); assert.ok(mine, "the trio is one cluster"); assert.equal(mine!.id, "src_clusterfixture"); assert.equal(mine!.label, "/vault/cluster notes.md", "a notes file is a birth-session — the label is its path"); // Chains-primary split (owner, 2026-09-30): `nodes` is the canvas // image, `propositions` the stored truth alone (the chain table's // input). The store is shared across this suite, so assert the // INVARIANT, not counts — and since the rendering arc // (2026-09-30), only MULTI-premise live chains mint imp nodes // (this fixture's two single-premise chains collapse to direct // arrows — zero imp nodes here). const stored = graphStore.readChains(); const live = new Set(snap.propositions.map((n) => n.id)); const impChains = stored.filter( (c) => c.premises.length >= 2 && live.has(c.conclusion) && c.premises.every((p) => live.has(p)), ); assert.ok(snap.propositions.every((n) => !n.id.startsWith("arg_")), "the stored-truth list never carries imp nodes"); assert.equal(snap.nodes.length, snap.propositions.length + impChains.length, "image = truth + one imp node per MULTI-premise live chain"); const imp = snap.nodes.filter((n) => n.id.startsWith("arg_")); assert.ok(imp.length === impChains.length && imp.every((n) => snap.propositions.every((p) => p.id !== n.id)), "the extra nodes are exactly the derived implication nodes"); assert.equal(imp.length, 0, "this fixture's chains are single-premise — all collapsed to direct arrows"); }); it("derives the sessions index in graphSnapshot", () => { const snap = graphSnapshot(graphDeps); const idByStatement = new Map(snap.nodes.map((n) => [n.statement, n.id])); // No node-state classes (2026-09-08) and no understanding // observations (2026-09-27 cleanup): the snapshot carries only the // objective graph + sessions. assert.equal("nodeStates" in snap, false); assert.equal("nodeObservations" in snap, false); assert.equal(snap.sessions[chat1.id], "Graph fixture"); assert.equal(snap.sessions[chat2Id], "Graph fixture 2"); assert.deepEqual( (snap.nodeSessions[idByStatement.get("Alpha intuition")!] ?? []).sort(), [chat1.id, chat2Id].sort(), ); // Gamma was only ever touched by chat1. assert.deepEqual(snap.nodeSessions[idByStatement.get("Gamma application")!], [chat1.id]); }); it("never string-matches without a verdict — an identical statement without linkTo is a NEW node", () => { const chat3 = fixtureChat("Graph fixture 3", [user("u1", "third")].flat()); chat3Id = chat3.id; const stats = mergeFindings( chat3.id, { propositions: [ { id: "r1", name: "Alpha", statement: "Alpha intuition", // IDENTICAL to the existing node's statement aliases: [], }, ], chains: [], }, // empty verdicts — identity is the auditor's call alone { links: [] }, graphDeps, sessionSource(chat3.id), ); assert.equal(stats.nodes, 1, "created — the merger does not match strings"); assert.equal(getGraph(graphStore).nodes.filter((n) => n.statement === "Alpha intuition").length, 2); }); it("merges the notes front door: source id as chatId, checkpoint at import time", () => { // Raw personal notes carry no transcript — no message anchors; the // file is the provenance (and no events exist to build, 2026-09-27). const stats = mergeFindings( "src_notesfixture", { propositions: [ { id: "p1", name: "Vim normal mode", statement: "Vim starts in Normal mode, where keys are commands.", aliases: [], }, ], chains: [], }, { links: [] }, graphDeps, { foldedAt: "2026-09-13T00:00:00.000Z" }, ); assert.deepEqual(stats, { nodes: 1, chains: 0 }); const node = getGraph(graphStore).nodes.find((n) => n.statement.startsWith("Vim starts"))!; assert.deepEqual(node.provenance, [{ chatId: "src_notesfixture", messageId: "" }], "one chat-level point — the source key, no message anchors"); // The checkpoint stamps the import time. assert.equal(graphStore.readCheckpoints().find((c) => c.chatId === "src_notesfixture")?.foldedAt, "2026-09-13T00:00:00.000Z"); }); }); // ─── store primitives ──────────────────────────────────────────────────────── describe("graph ledger store", () => { it("round-trips lines and skips corrupt / foreign-shaped lines (strict reads)", () => { const node = { id: "n_storetest", name: "Store test", statement: "Store test, elaborated.", aliases: [] as string[], createdAt: "2026-08-22T00:00:00.000Z", provenance: [{ chatId: "chat_c", messageId: "m1" }], }; graphStore.appendNode(node); // A torn append and a pre-name-pivot node (old schema: description, no // name) — both skipped by the strict guard. fs.appendFileSync( LEDGER_FILES.nodes, `{not json}\n${JSON.stringify({ id: "legacy", statement: "Legacy shape", description: "Old schema.", aliases: [], createdAt: "2026-08-22T00:00:00.000Z", provenance: [] })}\n`, "utf-8", ); const nodes = graphStore.readNodes().filter((n) => n.id === "n_storetest" || n.id === "legacy"); assert.equal(nodes.length, 1); assert.equal(nodes[0]!.name, "Store test"); assert.equal(nodes[0]!.statement, "Store test, elaborated."); assert.deepEqual(nodes[0]!.provenance, [{ chatId: "chat_c", messageId: "m1" }]); }); it("returns RAW node lines — repeated ids (link-appends) are each their own line; getGraph merges", () => { const line = (msgId: string) => JSON.stringify({ id: "n_linktest", name: "Link test", statement: `Phrasing ${msgId}`, aliases: [], createdAt: "2026-08-22T00:00:00.000Z", provenance: [{ chatId: "chat_c", messageId: msgId }], }); fs.appendFileSync(LEDGER_FILES.nodes, `${line("m1")}\n${line("m2")}\n`, "utf-8"); const lines = graphStore.readNodes().filter((n) => n.id === "n_linktest"); assert.equal(lines.length, 2, "the store returns raw lines, one per append"); const merged = getGraph(graphStore).nodes.find((n) => n.id === "n_linktest")!; assert.equal(merged.statement, "Phrasing m1", "the FIRST line defines the node"); assert.ok(merged.aliases.includes("Phrasing m2"), "later phrasings join the aliases"); assert.deepEqual(merged.provenance.map((p) => p.messageId), ["m1", "m2"]); }); }); // ─── session deletion (wave 6 — the first destructive ledger operation) ───── import { deleteChatTraces, type ChatDeletionStats } from "../src/core/graph-deletion.ts"; import { deleteChatSession, sessionCoverage } from "../src/server/chats.ts"; import { beginTurn, endTurn } from "../src/server/turn-liveness.ts"; import { jobStore } from "../src/store/jobs.ts"; import { deleteNodeTraces, type NodeDeletionStats, } from "../src/core/graph-deletion.ts"; import { deleteGraphNode, graphRevision } from "../src/server/graph.ts"; describe("session deletion (deleteChatTraces + deleteChatSession, wave 6)", () => { /** Two-session scenario: dA creates the shared node X + the orphan Y and * asserts X→Y; dB links X (its own phrasings), creates Z, asserts X→Z. * Deleting dA must: keep X (dB's link line survives, dA's create-line * aliases stripped — the identity stays), kill Y (orphan), keep Z and * dB's edge, kill dA's coverage/checkpoints. */ function buildTwoSessionScenario() { const dA = fixtureChat("Deletion session A", [ user("du1", "teach me the deletion topic"), assistant("da1", [ quizPart( "d-call-1", { question: "DQ1", options: [{ label: "a" }, { label: "b" }], correctAnswer: "a", explanation: "e" }, answer({ questionText: "DQ1 text", correct: true, answeredAt: "2026-09-23T00:00:00.000Z" }), ), ]), ].flat()); const findingsA: SessionFindings = { propositions: [ { id: "p1", name: "Shared core", statement: "Shared core statement", aliases: ["shared feel"], }, { id: "p2", name: "Solo fact", statement: "Solo fact statement", aliases: ["solo feel"], }, ], chains: [{ premises: ["p1"], conclusion: "p2", }], }; mergeFindings(dA.id, findingsA, { links: [] }, graphDeps, sessionSource(dA.id)); // Resolve through THIS session's provenance — the shared ledger // holds lookalike statements from earlier tests, so scope by chat. const bornOf = (chatId: string, statement: string): string => getGraph(graphStore).nodes.find((n) => n.statement === statement && n.provenance.some((pt) => pt.chatId === chatId))!.id; const xId = bornOf(dA.id, "Shared core statement"); const yId = bornOf(dA.id, "Solo fact statement"); const dB = fixtureChat("Deletion session B", [ user("eu1", "more on the shared core"), assistant("eb1", [ quizPart( "e-call-1", { question: "EQ1", options: [{ label: "a" }, { label: "b" }], correctAnswer: "a", explanation: "e" }, answer({ questionText: "EQ1 text", correct: false, answeredAt: "2026-09-23T00:01:00.000Z" }), ), ]), ].flat()); const findingsB: SessionFindings = { propositions: [ { id: "q1", name: "Shared again", statement: "Shared core, rephrased", aliases: ["B phrasing"] }, { id: "q2", name: "B extra", statement: "B extra statement", aliases: ["b extra feel"], }, ], chains: [{ premises: ["q1"], conclusion: "q2", }], }; mergeFindings(dB.id, findingsB, { links: [{ id: "q1", linkTo: xId }] }, graphDeps, sessionSource(dB.id)); const zId = bornOf(dB.id, "B extra statement"); // Coverage rows (both chats) + positions garnish — the deletion // prunes both ledgers. for (const chat of [dA, dB]) { for (let i = 0; i < 2; i++) { graphStore.appendCoverage({ chatId: chat.id, fp: `${chat.id}-${i}`, tokens: 10, foldedAt: "2026-09-23T00:02:00.000Z" }); } } graphStore.writePositions({ ...graphStore.readPositions(), [xId]: { x: 1, y: 1 }, [yId]: { x: 2, y: 2 }, [zId]: { x: 3, y: 3 } }); return { dA, dB, xId, yId, zId }; } it("delete-nodes: the shared node survives with the other session's content; the orphan dies; the creator's aliases are stripped (owner ruling 2026-09-23)", () => { const { dA, dB, xId, yId, zId } = buildTwoSessionScenario(); const zLineBefore = JSON.stringify(graphStore.readNodes().find((n) => n.id === zId)); const stats = deleteChatTraces(graphStore, dA.id, "delete-nodes"); assert.deepEqual(stats, { nodesRemoved: 1, chainsRemoved: 1, coverageRemoved: 2, checkpointsRemoved: 1, } satisfies ChatDeletionStats); const graph = getGraph(graphStore); // X survives: identity (name/statement/createdAt from the create // line) intact, dA's aliases + provenance gone, dB's phrasings in. const x = graph.nodes.find((n) => n.id === xId)!; assert.equal(x.statement, "Shared core statement", "the shared identity survives"); assert.equal(x.name, "Shared core"); assert.ok(!x.aliases.includes("shared feel"), "the deleted creator's phrasings are stripped (owner ruling)"); assert.ok(x.aliases.includes("B phrasing") && x.aliases.includes("Shared core, rephrased")); assert.deepEqual(x.provenance, [{ chatId: dB.id, messageId: "" }], "only dB's provenance remains"); // Y (the orphan) is gone entirely. assert.equal(graph.nodes.some((n) => n.id === yId), false); assert.equal(graphStore.readNodes().some((n) => n.id === yId), false); // Z (dB-only) is untouched, byte-identical. assert.equal(JSON.stringify(graphStore.readNodes().find((n) => n.id === zId)), zLineBefore); // Chains: dA's argument X⇒Y died (Y died); dB's X⇒Z survived. const scoped = scopedGraph([dA.id, dB.id]); assert.equal(scoped.chains.length, 1); assert.deepEqual(scoped.chains[0]!.premises, [xId]); assert.equal(scoped.chains[0]!.conclusion, zId); assert.deepEqual(scoped.chains[0]!.provenance, [{ chatId: dB.id, messageId: "" }]); // Positions: the orphan pruned. const positions = graphStore.readPositions(); assert.equal(positions[yId], undefined); assert.deepEqual(positions[xId], { x: 1, y: 1 }); // The snapshot resolves X to dB only — the deleted chat left no ghost. const snapshot = graphSnapshot(graphDeps); assert.deepEqual(snapshot.nodeSessions[xId], [dB.id]); assert.ok(snapshot.sessions[dB.id] && !snapshot.sessions[dA.id]); // Atomic rewrites left no temp files, and appends still work. assert.equal(fs.readdirSync(PATHS.graph).filter((f) => f.includes(".tmp-")).length, 0); const nodesBefore = graphStore.readNodes().length; // Foreign provenance: the probe is another chat's data, so later // deletions must leave it untouched (the foreign-data doctrine). graphStore.appendNode({ id: "n_del_append_probe", name: "Probe", statement: "Probe statement", aliases: [], createdAt: "2026-09-23T00:04:00.000Z", provenance: [{ chatId: "chat_foreign_probe", messageId: "" }] }); assert.equal(graphStore.readNodes().length, nodesBefore + 1); // Idempotent: a second run finds nothing. assert.deepEqual(deleteChatTraces(graphStore, dA.id, "delete-nodes"), { ...stats, nodesRemoved: 0, chainsRemoved: 0, coverageRemoved: 0, checkpointsRemoved: 0 } satisfies ChatDeletionStats); }); it("preserve-graph: only the extraction bookkeeping dies — the graph ledgers are byte-identical", () => { const { dA, dB, xId, yId, zId } = buildTwoSessionScenario(); const before = { nodes: graphStore.readNodes(), chains: graphStore.readChains(), positions: graphStore.readPositions(), }; const stats = deleteChatTraces(graphStore, dA.id, "preserve-graph"); assert.deepEqual(stats, { nodesRemoved: 0, chainsRemoved: 0, coverageRemoved: 2, checkpointsRemoved: 1, } satisfies ChatDeletionStats); assert.deepEqual(graphStore.readNodes(), before.nodes); assert.deepEqual(graphStore.readChains(), before.chains); assert.deepEqual(graphStore.readPositions(), before.positions); assert.equal(graphStore.readCoverage().some((row) => row.chatId === dA.id), false); assert.equal(graphStore.readCoverage().some((row) => row.chatId === dB.id), true); void xId; void yId; void zId; }); it("deleteChatSession: the orchestration's gates and the sync block", async () => { // 404 — unknown chat. assert.deepEqual(await deleteChatSession("chat_missing_delete", "delete-nodes"), { ok: false, status: 404, code: "not_found", error: "No such session" }); const { dA } = buildTwoSessionScenario(); // 409 — a turn in flight. beginTurn(dA.id); const turnedAway = await deleteChatSession(dA.id, "delete-nodes"); assert.deepEqual(turnedAway, { ok: false, status: 409, code: "turn_in_flight", error: "A turn is running in this session — try again when it finishes", jobIds: [] }); endTurn(dA.id); // 409 — running background jobs. const job = jobStore.createJob({ kind: "research", chatId: dA.id, toolCallId: "del-call-1" }); const jobsBlocked = await deleteChatSession(dA.id, "delete-nodes"); assert.ok(!jobsBlocked.ok && jobsBlocked.status === 409, "refused with 409"); if (jobsBlocked.code === "jobs_running") assert.deepEqual(jobsBlocked.jobIds, [job.id]); assert.equal(jobStore.deleteJobsForChat(dA.id), 1, "test cleanup — the job file is gone"); // Success — a terminal job rides along; the chat record dies last. const doneJob = jobStore.createJob({ kind: "research", chatId: dA.id, toolCallId: "del-call-2" }); jobStore.updateJob(doneJob.id, { status: "done", activity: "delivered" }); const outcome = await deleteChatSession(dA.id, "delete-nodes"); assert.equal(outcome.ok, true); if (outcome.ok) { assert.equal(outcome.mode, "delete-nodes"); assert.equal(outcome.stats.nodesRemoved, 1); assert.equal(outcome.jobsRemoved, 1); assert.ok(outcome.graphRevision > 0, "the version stamp moved"); } assert.equal(chatStore.getChat(dA.id), null, "the chat record is gone"); assert.equal(jobStore.getJob(doneJob.id), null, "the chat's job records are gone"); // And a second call is an honest 404. assert.deepEqual(await deleteChatSession(dA.id, "delete-nodes"), { ok: false, status: 404, code: "not_found", error: "No such session" }); }); }); // ─── single-node deletion (node interlude, full death) ─────────────────────── describe("single-node deletion (deleteNodeTraces + deleteGraphNode, node interlude)", () => { /** The full-death scenario: node X is born in a notes file (EMPTY * provenance — a legacy line; the mappings anchor is gone, owner * 2026-09-29), re-encountered by a chat (link line: alias + * provenance), and asserted in chains by two sessions. */ function buildNodeScenario() { // Clean slate per test: each test in this describe builds its own // scenario from empty ledgers (the suite's isolation covers the // whole file; this covers describe-internal stacking). graphStore.rewriteLedgers({ nodes: [], chains: [] }); graphStore.writePositions({}); graphStore.appendNode({ id: "n_dead", name: "Doomed", statement: "Doomed statement", aliases: [], createdAt: "2026-09-23T00:00:00.000Z", provenance: [], }); // The chat's re-encounter: a link line (alias + its own provenance). graphStore.appendNode({ id: "n_dead", name: "Doomed", statement: "Doomed statement", aliases: ["doomed, rephrased"], createdAt: "2026-09-23T00:00:00.000Z", provenance: [{ chatId: "chat_node_a", messageId: "m1" }], }); // A neighbor + two edges: only the one touching X dies. graphStore.appendNode({ id: "n_keep", name: "Keeper", statement: "Keeper statement", aliases: [], createdAt: "2026-09-23T00:00:00.000Z", provenance: [{ chatId: "chat_node_a", messageId: "m2" }], }); graphStore.appendChain({ id: "arg_dead_keep", premises: ["n_dead"], conclusion: "n_keep", createdAt: "2026-09-23T00:00:00.000Z", provenance: [{ chatId: "chat_node_a", messageId: "m1" }] }); graphStore.appendChain({ id: "arg_keep_dead", premises: ["n_keep"], conclusion: "n_dead", createdAt: "2026-09-23T00:00:00.000Z", provenance: [{ chatId: "chat_node_b", messageId: "m3" }] }); // A FOREIGN chain the deletion must not touch (destructive rewriting // may not exceed the blast radius — foreign data rides untouched). graphStore.appendChain({ id: "arg_keep_other", premises: ["n_keep"], conclusion: "n_other", createdAt: "2026-09-23T00:00:00.000Z", provenance: [{ chatId: "chat_node_b", messageId: "m3" }] }); // Resting positions for both nodes and both dying chains' imp nodes. graphStore.writePositions({ n_dead: { x: 1, y: 1 }, n_keep: { x: 2, y: 2 }, arg_dead_keep: { x: 1.5, y: 1.5 }, arg_keep_dead: { x: 2.5, y: 2.5 } }); } it("deleteNodeTraces: FULL DEATH — the node, its edges, its evidence, its anchors, its position", () => { buildNodeScenario(); const keepLineBefore = JSON.stringify(graphStore.readNodes().find((n) => n.id === "n_keep")); const stats = deleteNodeTraces(graphStore, "n_dead"); assert.deepEqual(stats, { chainsRemoved: 2 } satisfies NodeDeletionStats); // The node's EVERY line is gone; the neighbor is byte-identical // (full death is node-scoped — other nodes' sessions keep their // aliases and provenance). assert.equal(graphStore.readNodes().some((n) => n.id === "n_dead"), false); assert.equal( JSON.stringify(graphStore.readNodes().find((n) => n.id === "n_keep")), keepLineBefore, "the untouched node is byte-identical", ); // Only the chains referencing X died; the foreign chain stays. assert.deepEqual( graphStore.readChains().map((c) => [c.premises, c.conclusion]), [[["n_keep"], "n_other"]], ); // The resting position died with the node. const positions = graphStore.readPositions(); assert.equal(positions["n_dead"], undefined); assert.deepEqual(positions["n_keep"], { x: 2, y: 2 }); assert.equal(positions["arg_dead_keep"], undefined, "the dying chains' imp-node positions die too"); assert.equal(positions["arg_keep_dead"], undefined); // Atomic rewrites left no temp files. assert.equal(fs.readdirSync(PATHS.graph).filter((f) => f.includes(".tmp-")).length, 0); // Idempotent: a second run finds no node — null. assert.equal(deleteNodeTraces(graphStore, "n_dead"), null); }); it("deleteNodeTraces: a node nothing references still dies, and only its file moves", () => { graphStore.appendNode({ id: "n_solo", name: "Solo", statement: "Solo statement", aliases: [], createdAt: "2026-09-23T00:00:00.000Z", provenance: [{ chatId: "chat_node_solo", messageId: "m1" }], }); const stats = deleteNodeTraces(graphStore, "n_solo"); assert.deepEqual(stats, { chainsRemoved: 0 } satisfies NodeDeletionStats); assert.equal(graphStore.readNodes().some((n) => n.id === "n_solo"), false); }); it("deleteGraphNode: the orchestration — extraction gate, 404, success", () => { // 404 — unknown node. assert.deepEqual(deleteGraphNode("n_missing_node"), { ok: false, status: 404, code: "not_found", error: "No such node", }); // 409 — ANY registered extraction run: a mid-flight run could // re-reference the dying node; the run is never aborted (its spend // belongs to another session), the caller retries. The registry is // the pipeline's globalThis store — a fake entry is the honest way // to pin the gate without staging a real run. const g = globalThis as { __lhExtractionRuns?: unknown }; const realRuns = g.__lhExtractionRuns; g.__lhExtractionRuns = { running: new Map([ ["chat_busy", { chatId: "chat_busy", kind: "chat", phase: "extracting", startedAt: 1, usage: {}, controller: new AbortController() }], ]), inFlight: new Set(), lastStartedAt: 0, }; try { assert.deepEqual(deleteGraphNode("n_gate_probe"), { ok: false, status: 409, code: "extraction_running", error: "An extraction is running — try again when it finishes", }); } finally { g.__lhExtractionRuns = realRuns; } // Success — the node dies, the version stamp moves. graphStore.appendNode({ id: "n_orch", name: "Orchestrated", statement: "Orchestrated statement", aliases: [], createdAt: "2026-09-23T00:00:00.000Z", provenance: [{ chatId: "chat_node_c", messageId: "m1" }], }); const revisionBefore = graphRevision(); const outcome = deleteGraphNode("n_orch"); assert.ok(outcome.ok); assert.deepEqual(outcome.stats, { chainsRemoved: 0 }); assert.ok(outcome.graphRevision > 0); assert.ok(outcome.graphRevision >= revisionBefore, "the version stamp moved"); assert.equal(graphStore.readNodes().some((n) => n.id === "n_orch"), false); // And a second call is an honest 404. assert.deepEqual(deleteGraphNode("n_orch"), { ok: false, status: 404, code: "not_found", error: "No such node" }); }); }); describe("session coverage read (extraction-UX redesign, 2026-09-24)", () => { it("one session's block: derived uncovered, the newest fold, honest nulls", () => { // Empty coverage: everything uncovered, no fold yet, not running. // Teacher prose only (owner, 2026-09-28): coverage slots are the // teacher's text blocks, so the fixture is all-teacher. const chat = fixtureChat("coverage read", [ teacher("cov_t1", "tell me about coverage reads"), teacher("cov_t2", "and about per-session blocks"), teacher("cov_t3", "a third distinct message"), ].flat()); const empty = sessionCoverage(chat.id)!; assert.ok(empty); assert.equal(empty.totalMessages, 3); assert.equal(empty.coveredCount, 0); assert.equal(empty.uncoveredCount, 3); assert.equal(empty.coveredTokens, 0); assert.ok(empty.uncoveredTokens > 0); assert.equal(empty.running, false); assert.equal(empty.lastFoldedAt, null, "no fold yet"); // Fold the first two messages: the read derives the split + the // newest fold timestamp from the ledger rows. const slots = coverageSlots(chatStore.getChat(chat.id)!.messages); graphStore.appendCoverage({ chatId: chat.id, fp: slots[0]!.fp, tokens: slots[0]!.tokens, foldedAt: "2026-09-24T10:00:00.000Z" }); graphStore.appendCoverage({ chatId: chat.id, fp: slots[1]!.fp, tokens: slots[1]!.tokens, foldedAt: "2026-09-24T11:30:00.000Z" }); // Another session's row must not leak into this read. graphStore.appendCoverage({ chatId: "chat_other", fp: slots[2]!.fp, tokens: slots[2]!.tokens, foldedAt: "2026-09-24T23:00:00.000Z" }); const cov = sessionCoverage(chat.id)!; assert.equal(cov.totalMessages, 3); assert.equal(cov.coveredCount, 2); assert.equal(cov.uncoveredCount, 1); assert.equal(cov.coveredTokens, slots[0]!.tokens + slots[1]!.tokens); assert.equal(cov.uncoveredTokens, slots[2]!.tokens); assert.equal(cov.lastFoldedAt, "2026-09-24T11:30:00.000Z", "the NEWEST fold, and scoped to this session's rows"); }); it("running: true only for THIS session's chat-kind run (the registry pin)", () => { const chat = fixtureChat("coverage running", [user("cov_r1", "running pin")].flat()); const g = globalThis as { __lhExtractionRuns?: unknown }; const realRuns = g.__lhExtractionRuns; try { g.__lhExtractionRuns = { running: new Map([ // a notes run for the same id is NOT this session's chat run ["src_notes", { chatId: "src_notes", kind: "notes", phase: "extracting", startedAt: 1, usage: {}, controller: new AbortController() }], ["other_chat", { chatId: "other_chat", kind: "chat", phase: "auditing", startedAt: 2, usage: {}, controller: new AbortController() }], ]), inFlight: new Set(), lastStartedAt: 0, }; assert.equal(sessionCoverage(chat.id)!.running, false, "no chat-kind run for this id"); g.__lhExtractionRuns = { running: new Map([ [chat.id, { chatId: chat.id, kind: "chat", phase: "extracting", startedAt: 3, usage: {}, controller: new AbortController() }], ]), inFlight: new Set(), lastStartedAt: 0, }; assert.equal(sessionCoverage(chat.id)!.running, true); } finally { g.__lhExtractionRuns = realRuns; } }); it("unknown chat → null (the caller owns the 404)", () => { assert.equal(sessionCoverage("chat_never_was"), null); }); }); // ─── deriveView (the rendering arc, owner 2026-09-30) ──────────────────────── describe("deriveView (the argument's geometry)", () => { const prop = (id: string): GraphNode => ({ id, name: id.toUpperCase(), statement: `${id} statement`, aliases: [], createdAt: "2026-09-30T00:00:00.000Z", provenance: [], }); const chain = (id: string, premises: string[], conclusion: string): GraphChain => ({ id, premises, conclusion, provenance: [], createdAt: "2026-09-30T00:00:00.000Z", }); it("a SINGLE-premise chain collapses to ONE direct arrow — no imp node", () => { const view = deriveView({ nodes: [prop("a"), prop("b")], chains: [chain("arg_ab", ["a"], "b")] }); assert.deepEqual(view.nodes.map((n) => n.id), ["a", "b"], "no arg_ node minted"); assert.deepEqual(view.edges, [{ from: "a", to: "b" }], "the argument IS a plain arrow"); }); it("a MULTI-premise chain keeps the imp node + fan (premises in, conclusion out)", () => { const view = deriveView({ nodes: [prop("a"), prop("b"), prop("c")], chains: [chain("arg_ab", ["a", "b"], "c")], }); assert.deepEqual(view.nodes.map((n) => n.id).sort(), ["a", "arg_ab", "b", "c"]); assert.deepEqual( [...view.edges].sort((x, y) => (x.from < y.from ? -1 : x.from > y.from ? 1 : x.to < y.to ? -1 : 1)), [ { from: "a", to: "arg_ab" }, { from: "arg_ab", to: "c" }, { from: "b", to: "arg_ab" }, ], ); const imp = view.nodes.find((n) => n.id === "arg_ab")!; assert.equal(imp.name, "\u27f9"); }); it("two chains SHARING a conclusion stay distinct — two geometry points, never a unioned fan", () => { const view = deriveView({ nodes: [prop("a"), prop("b"), prop("c"), prop("d"), prop("e")], chains: [chain("arg_e1", ["a", "b"], "e"), chain("arg_e2", ["c", "d"], "e")], }); assert.deepEqual( view.nodes.map((n) => n.id).sort(), ["a", "arg_e1", "arg_e2", "b", "c", "d", "e"], ); assert.ok(view.edges.some((x) => x.from === "arg_e1" && x.to === "e")); assert.ok(view.edges.some((x) => x.from === "arg_e2" && x.to === "e")); }); it("dangling chains drop (missing member — the honest belt)", () => { const view = deriveView({ nodes: [prop("a")], chains: [chain("arg_ghost", ["a"], "gone"), chain("arg_gone", ["ghost"], "a")] }); assert.deepEqual(view.nodes.map((n) => n.id), ["a"]); assert.deepEqual(view.edges, []); }); it("LOGICAL edges: every chain contracts to direct premise→conclusion arrows (all chains, deduped)", () => { const view = deriveView({ nodes: [prop("a"), prop("b"), prop("c")], chains: [chain("arg_ab", ["a", "b"], "c"), chain("arg_ac", ["a"], "c")], }); // arg_ab: a→c AND b→c; arg_ac: a→c again → deduped to one arrow. assert.deepEqual( [...view.logicalEdges].sort((x, y) => (x.from < y.from ? -1 : x.from > y.from ? 1 : x.to < y.to ? -1 : 1)), [ { from: "a", to: "c" }, { from: "b", to: "c" }, ], ); // Proposition ids only — no arg_ endpoint ever rides the logical set. assert.ok(view.logicalEdges.every((e) => !e.from.startsWith("arg_") && !e.to.startsWith("arg_"))); }); it("impLinks: one linkage per MULTI-premise chain — the depth pass's midpoint input", () => { const view = deriveView({ nodes: [prop("a"), prop("b"), prop("c")], chains: [chain("arg_ab", ["a", "b"], "c"), chain("arg_ac", ["a"], "c")], }); assert.deepEqual(view.impLinks, [{ id: "arg_ab", premises: ["a", "b"], conclusion: "c" }]); }); });