@sanqianx/project-knowledge 4.6.1 → 4.8.0

package/_site/_test/commit-evidence-test.js

@@ -1,110 +1,110 @@
-// Run: node _site/_test/commit-evidence-test.js
-
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { spawnSync } = require('child_process');
-const { CommitScanner, TrustedGitReader, EMPTY_TREE_SHA, sha256 } = require('../lib/scanner');
-
-const temp = fs.mkdtempSync(path.join(os.tmpdir(), `kb-commit-evidence-${process.pid}-`));
-const repo = path.join(temp, 'repo');
-
-function git(args) {
-  const result = spawnSync('git', ['-C', repo, ...args], { encoding: 'utf8', windowsHide: true, maxBuffer: 16 * 1024 * 1024 });
-  if (result.status !== 0) throw new Error(result.stderr || `git ${args.join(' ')} failed`);
-  return String(result.stdout || '').trim();
-}
-
-function gitRaw(args) {
-  const result = spawnSync('git', ['-C', repo, ...args], { encoding: 'utf8', windowsHide: true, maxBuffer: 16 * 1024 * 1024 });
-  if (result.status !== 0) throw new Error(result.stderr || `git ${args.join(' ')} failed`);
-  return String(result.stdout || '');
-}
-
-function commitFile(name, content, message) {
-  fs.mkdirSync(path.dirname(path.join(repo, name)), { recursive: true });
-  fs.writeFileSync(path.join(repo, name), content);
-  git(['add', name]);
-  git(['commit', '-m', message]);
-  return git(['rev-parse', 'HEAD']);
-}
-
-(async () => {
-  fs.mkdirSync(repo, { recursive: true });
-  git(['init', '--initial-branch=main']);
-  git(['config', 'user.email', 'evidence@example.test']);
-  git(['config', 'user.name', 'Evidence Test']);
-  const rootCommit = commitFile('src/root.txt', 'root\n', 'root commit');
-  const binaryCommit = commitFile('assets/sample.bin', Buffer.from([0, 1, 2, 3, 255]), 'add binary');
-
-  git(['checkout', '-b', 'feature']);
-  const featureCommit = commitFile('src/feature.txt', 'feature\n', 'feature side');
-  git(['checkout', 'main']);
-  const mainCommit = commitFile('src/main.txt', 'main\n', 'main side');
-  git(['merge', '--no-ff', 'feature', '-m', 'merge feature']);
-  const mergeCommit = git(['rev-parse', 'HEAD']);
-
-  const scanner = new CommitScanner({ batchSize: 2 });
-  const firstBatch = await scanner.scan({ repoPath: repo }, {
-    trackingMode: 'normal', trackingStartCommit: rootCommit, lastAnalyzedCommit: null,
-  });
-  assert.strictEqual(firstBatch.status, 'ok');
-  assert.strictEqual(firstBatch.commits.length, 2, 'batch limit should return a bounded first page');
-  assert(firstBatch.continuation && firstBatch.continuation.remaining === 2, 'continuation must expose remaining work');
-  const all = await new TrustedGitReader().listCommits(repo, rootCommit, mergeCommit);
-  assert.deepStrictEqual(all, [binaryCommit, mainCommit, featureCommit, mergeCommit], 'reverse topo order must include both branch commits and the merge commit');
-
-  const rootEvidence = await scanner.collectEvidence({ repoPath: repo }, rootCommit, { branch: 'main' });
-  assert.strictEqual(rootEvidence.patchMode, 'root-empty-tree');
-  assert.strictEqual(rootEvidence.patchBase, EMPTY_TREE_SHA);
-  assert(rootEvidence.patch.includes('src/root.txt'), 'root evidence must contain a real empty-tree patch');
-
-  const binaryEvidence = await scanner.collectEvidence({ repoPath: repo }, binaryCommit, { branch: 'main' });
-  assert(binaryEvidence.files.some(file => file.path === 'assets/sample.bin' && file.binary), 'name-status manifest should identify binary files');
-  assert(binaryEvidence.patch.includes('GIT binary patch'), 'binary patch evidence should be preserved');
-
-  const mergeEvidence = await scanner.collectEvidence({ repoPath: repo }, mergeCommit, { branch: 'main' });
-  assert.strictEqual(mergeEvidence.parents.length, 2, 'merge metadata should include every parent');
-  assert.strictEqual(mergeEvidence.patchMode, 'merge-first-parent');
-  assert.strictEqual(mergeEvidence.patchBase, mainCommit, 'merge patch must compare against the first parent');
-  assert(mergeEvidence.patch.includes('src/feature.txt'), 'first-parent merge patch should show the introduced feature side');
-
-  git(['mv', 'src/root.txt', 'src/renamed.txt']);
-  git(['commit', '-m', 'rename root evidence']);
-  const renameCommit = git(['rev-parse', 'HEAD']);
-  const renameEvidence = await scanner.collectEvidence({ repoPath: repo }, renameCommit, { branch: 'main' });
-  assert(renameEvidence.files.some(file => file.oldPath === 'src/root.txt' && file.path === 'src/renamed.txt'), 'rename evidence must retain old and new paths');
-
-  const largeContent = Array.from({ length: 42000 }, (_, index) => `${String(index).padStart(6, '0')} ${'exact-evidence-'.repeat(5)}\n`).join('');
-  const largeCommit = commitFile('src/large.txt', largeContent, 'large exact evidence');
-  const evidenceRoot = path.join(temp, 'run', 'input', 'evidence');
-  const largeReader = new TrustedGitReader({ maxPatchBytes: 2 * 1024 * 1024, maxChunkBytes: 128 * 1024 });
-  const large = await largeReader.collectEvidence(repo, largeCommit, { branch: 'main', evidenceRoot });
-  assert(large.patchBytes > 2 * 1024 * 1024, 'fixture must cross the production inline threshold');
-  assert.strictEqual(large.patch, null, 'large patch should be referenced by exact chunks instead of prompt inline text');
-  assert.strictEqual(large.patchChunked, true);
-  assert.strictEqual(large.patchOmitted, false, 'exact chunk evidence must not be represented as omitted');
-  assert(large.evidenceBundle.chunkCount > 1, 'large patch should be split into ordered chunks');
-  const manifest = largeReader.verifyEvidence(large);
-  assert.deepStrictEqual(manifest.chunks.map(chunk => chunk.sequence), manifest.chunks.map((_, index) => index + 1));
-  assert(manifest.chunks.every(chunk => chunk.sha256.startsWith('sha256:') && chunk.bytes > 0 && chunk.sourcePaths.includes('src/large.txt')));
-  const reconstructed = manifest.chunks.map(chunk => fs.readFileSync(path.join(evidenceRoot, ...chunk.path.split('/')))).join('');
-  const exactGitPatch = gitRaw(['diff', '--no-ext-diff', '--binary', '--find-renames', '--unified=3', renameCommit, largeCommit]);
-  assert.strictEqual(Buffer.byteLength(reconstructed), Buffer.byteLength(exactGitPatch));
-  assert.strictEqual(sha256(reconstructed), large.patchHash, 'ordered chunks must exactly reconstruct the full Git diff hash');
-
-  const corruptPath = path.join(evidenceRoot, ...manifest.chunks[0].path.split('/'));
-  fs.appendFileSync(corruptPath, 'corrupt');
-  assert.throws(() => largeReader.verifyEvidence(large), error => error.code === 'EVIDENCE_INTEGRITY_FAILED', 'corrupt chunks must fail with a typed evidence error');
-
-  const missingRootReader = new TrustedGitReader({ maxPatchBytes: 8 });
-  await assert.rejects(missingRootReader.collectEvidence(repo, mergeCommit, { branch: 'main' }), error => error.code === 'EVIDENCE_INTEGRITY_FAILED');
-
-  console.log('commit-evidence-test PASS');
-})().catch(error => {
-  console.error(error.stack || error.message);
-  process.exitCode = 1;
-}).finally(() => {
-  fs.rmSync(temp, { recursive: true, force: true });
-});
+// Run: node _site/_test/commit-evidence-test.js
+
+const assert = require('assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+const { CommitScanner, TrustedGitReader, EMPTY_TREE_SHA, sha256 } = require('../lib/scanner');
+
+const temp = fs.mkdtempSync(path.join(os.tmpdir(), `kb-commit-evidence-${process.pid}-`));
+const repo = path.join(temp, 'repo');
+
+function git(args) {
+  const result = spawnSync('git', ['-C', repo, ...args], { encoding: 'utf8', windowsHide: true, maxBuffer: 16 * 1024 * 1024 });
+  if (result.status !== 0) throw new Error(result.stderr || `git ${args.join(' ')} failed`);
+  return String(result.stdout || '').trim();
+}
+
+function gitRaw(args) {
+  const result = spawnSync('git', ['-C', repo, ...args], { encoding: 'utf8', windowsHide: true, maxBuffer: 16 * 1024 * 1024 });
+  if (result.status !== 0) throw new Error(result.stderr || `git ${args.join(' ')} failed`);
+  return String(result.stdout || '');
+}
+
+function commitFile(name, content, message) {
+  fs.mkdirSync(path.dirname(path.join(repo, name)), { recursive: true });
+  fs.writeFileSync(path.join(repo, name), content);
+  git(['add', name]);
+  git(['commit', '-m', message]);
+  return git(['rev-parse', 'HEAD']);
+}
+
+(async () => {
+  fs.mkdirSync(repo, { recursive: true });
+  git(['init', '--initial-branch=main']);
+  git(['config', 'user.email', 'evidence@example.test']);
+  git(['config', 'user.name', 'Evidence Test']);
+  const rootCommit = commitFile('src/root.txt', 'root\n', 'root commit');
+  const binaryCommit = commitFile('assets/sample.bin', Buffer.from([0, 1, 2, 3, 255]), 'add binary');
+
+  git(['checkout', '-b', 'feature']);
+  const featureCommit = commitFile('src/feature.txt', 'feature\n', 'feature side');
+  git(['checkout', 'main']);
+  const mainCommit = commitFile('src/main.txt', 'main\n', 'main side');
+  git(['merge', '--no-ff', 'feature', '-m', 'merge feature']);
+  const mergeCommit = git(['rev-parse', 'HEAD']);
+
+  const scanner = new CommitScanner({ batchSize: 2 });
+  const firstBatch = await scanner.scan({ repoPath: repo }, {
+    trackingMode: 'normal', trackingStartCommit: rootCommit, lastAnalyzedCommit: null,
+  });
+  assert.strictEqual(firstBatch.status, 'ok');
+  assert.strictEqual(firstBatch.commits.length, 2, 'batch limit should return a bounded first page');
+  assert(firstBatch.continuation && firstBatch.continuation.remaining === 2, 'continuation must expose remaining work');
+  const all = await new TrustedGitReader().listCommits(repo, rootCommit, mergeCommit);
+  assert.deepStrictEqual(all, [binaryCommit, mainCommit, featureCommit, mergeCommit], 'reverse topo order must include both branch commits and the merge commit');
+
+  const rootEvidence = await scanner.collectEvidence({ repoPath: repo }, rootCommit, { branch: 'main' });
+  assert.strictEqual(rootEvidence.patchMode, 'root-empty-tree');
+  assert.strictEqual(rootEvidence.patchBase, EMPTY_TREE_SHA);
+  assert(rootEvidence.patch.includes('src/root.txt'), 'root evidence must contain a real empty-tree patch');
+
+  const binaryEvidence = await scanner.collectEvidence({ repoPath: repo }, binaryCommit, { branch: 'main' });
+  assert(binaryEvidence.files.some(file => file.path === 'assets/sample.bin' && file.binary), 'name-status manifest should identify binary files');
+  assert(binaryEvidence.patch.includes('GIT binary patch'), 'binary patch evidence should be preserved');
+
+  const mergeEvidence = await scanner.collectEvidence({ repoPath: repo }, mergeCommit, { branch: 'main' });
+  assert.strictEqual(mergeEvidence.parents.length, 2, 'merge metadata should include every parent');
+  assert.strictEqual(mergeEvidence.patchMode, 'merge-first-parent');
+  assert.strictEqual(mergeEvidence.patchBase, mainCommit, 'merge patch must compare against the first parent');
+  assert(mergeEvidence.patch.includes('src/feature.txt'), 'first-parent merge patch should show the introduced feature side');
+
+  git(['mv', 'src/root.txt', 'src/renamed.txt']);
+  git(['commit', '-m', 'rename root evidence']);
+  const renameCommit = git(['rev-parse', 'HEAD']);
+  const renameEvidence = await scanner.collectEvidence({ repoPath: repo }, renameCommit, { branch: 'main' });
+  assert(renameEvidence.files.some(file => file.oldPath === 'src/root.txt' && file.path === 'src/renamed.txt'), 'rename evidence must retain old and new paths');
+
+  const largeContent = Array.from({ length: 42000 }, (_, index) => `${String(index).padStart(6, '0')} ${'exact-evidence-'.repeat(5)}\n`).join('');
+  const largeCommit = commitFile('src/large.txt', largeContent, 'large exact evidence');
+  const evidenceRoot = path.join(temp, 'run', 'input', 'evidence');
+  const largeReader = new TrustedGitReader({ maxPatchBytes: 2 * 1024 * 1024, maxChunkBytes: 128 * 1024 });
+  const large = await largeReader.collectEvidence(repo, largeCommit, { branch: 'main', evidenceRoot });
+  assert(large.patchBytes > 2 * 1024 * 1024, 'fixture must cross the production inline threshold');
+  assert.strictEqual(large.patch, null, 'large patch should be referenced by exact chunks instead of prompt inline text');
+  assert.strictEqual(large.patchChunked, true);
+  assert.strictEqual(large.patchOmitted, false, 'exact chunk evidence must not be represented as omitted');
+  assert(large.evidenceBundle.chunkCount > 1, 'large patch should be split into ordered chunks');
+  const manifest = largeReader.verifyEvidence(large);
+  assert.deepStrictEqual(manifest.chunks.map(chunk => chunk.sequence), manifest.chunks.map((_, index) => index + 1));
+  assert(manifest.chunks.every(chunk => chunk.sha256.startsWith('sha256:') && chunk.bytes > 0 && chunk.sourcePaths.includes('src/large.txt')));
+  const reconstructed = manifest.chunks.map(chunk => fs.readFileSync(path.join(evidenceRoot, ...chunk.path.split('/')))).join('');
+  const exactGitPatch = gitRaw(['diff', '--no-ext-diff', '--binary', '--find-renames', '--unified=3', renameCommit, largeCommit]);
+  assert.strictEqual(Buffer.byteLength(reconstructed), Buffer.byteLength(exactGitPatch));
+  assert.strictEqual(sha256(reconstructed), large.patchHash, 'ordered chunks must exactly reconstruct the full Git diff hash');
+
+  const corruptPath = path.join(evidenceRoot, ...manifest.chunks[0].path.split('/'));
+  fs.appendFileSync(corruptPath, 'corrupt');
+  assert.throws(() => largeReader.verifyEvidence(large), error => error.code === 'EVIDENCE_INTEGRITY_FAILED', 'corrupt chunks must fail with a typed evidence error');
+
+  const missingRootReader = new TrustedGitReader({ maxPatchBytes: 8 });
+  await assert.rejects(missingRootReader.collectEvidence(repo, mergeCommit, { branch: 'main' }), error => error.code === 'EVIDENCE_INTEGRITY_FAILED');
+
+  console.log('commit-evidence-test PASS');
+})().catch(error => {
+  console.error(error.stack || error.message);
+  process.exitCode = 1;
+}).finally(() => {
+  fs.rmSync(temp, { recursive: true, force: true });
+});

package/_site/_test/conversation-api-test.js

@@ -1,119 +1,119 @@
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { spawnServer } = require('./helpers/spawn-server');
-const { StorageLayout } = require('../lib/storage-layout');
-const { SettingsStore } = require('../lib/settings-store');
-const { ProjectRegistryStore } = require('../lib/project-registry-store');
-const { ProjectStore } = require('../lib/project-store');
-const { ConversationStore } = require('../lib/conversation-store');
-const { localDate } = require('../lib/conversation-query-service');
-
-const ROOT = path.resolve(__dirname, '..', '..');
-const PORT = 8250 + (process.pid % 300);
-const BASE = `http://127.0.0.1:${PORT}`;
-
-async function waitForServer() {
-  for (let attempt = 0; attempt < 100; attempt += 1) {
-    try { if ((await fetch(`${BASE}/api/health`)).ok) return; } catch {}
-    await new Promise(resolve => setTimeout(resolve, 100));
-  }
-  throw new Error('server did not start');
-}
-
-(async () => {
-  const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-conversation-api-'));
-  const layout = new StorageLayout({ dataDir });
-  const settings = new SettingsStore({ layout });
-  const registry = new ProjectRegistryStore({ layout });
-  const projects = new ProjectStore({ layout });
-  await settings.initialize({ knowledge: { rootPath: path.join(dataDir, 'knowledge') } });
-  await registry.initialize();
-  const projectId = 'project-conversation-api';
-  const repoPath = path.join(dataDir, 'repo');
-  const knowledgePath = path.join(dataDir, 'knowledge', projectId);
-  fs.mkdirSync(repoPath, { recursive: true });
-  fs.mkdirSync(knowledgePath, { recursive: true });
-  await projects.create(projectId, {
-    displayName: 'Conversation API', storageName: 'conversation-api', repoPath, knowledgePath,
-  }, { conversationBaselineCursor: 0, conversation: { lastConsumedCursor: 0, captureStatus: 'captured' } });
-  await registry.add(projectId, { displayNameSnapshot: 'Conversation API' });
-  const store = new ConversationStore({ layout, projectStore: projects });
-  const repoIdentity = { repoId: 'conversation-api-repo' };
-  const unsafePrompt = '<script>alert("conversation-body")</script> Keep this as plain text.';
-  async function append(eventId, sequence, turnId, role, content, capturedAt) {
-    return (await store.appendEvent(projectId, {
-      eventId, sequence, source: 'codex', eventType: role === 'user' ? 'user_prompt' : 'assistant_response', role, content,
-      sessionId: 'session-api', turnId, repoIdentity, projectPath: repoPath, branch: 'main', headAtCapture: '0'.repeat(40),
-      capturedAt, identityConfidence: 'high', captureStatus: 'captured',
-    })).event;
-  }
-  const r1 = await append('r1', 1, 'turn-1', 'user', unsafePrompt, '2026-08-18T01:00:00.000Z');
-  const a1 = await append('a1', 2, 'turn-1', 'assistant', 'Rendered only as plain assistant text.', '2026-08-18T01:01:00.000Z');
-  const r2 = await append('r2', 3, 'turn-2', 'user', 'Second prompt.', '2026-08-18T02:00:00.000Z');
+const assert = require('assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnServer } = require('./helpers/spawn-server');
+const { StorageLayout } = require('../lib/storage-layout');
+const { SettingsStore } = require('../lib/settings-store');
+const { ProjectRegistryStore } = require('../lib/project-registry-store');
+const { ProjectStore } = require('../lib/project-store');
+const { ConversationStore } = require('../lib/conversation-store');
+const { localDate } = require('../lib/conversation-query-service');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const PORT = 8250 + (process.pid % 300);
+const BASE = `http://127.0.0.1:${PORT}`;
+
+async function waitForServer() {
+  for (let attempt = 0; attempt < 100; attempt += 1) {
+    try { if ((await fetch(`${BASE}/api/health`)).ok) return; } catch {}
+    await new Promise(resolve => setTimeout(resolve, 100));
+  }
+  throw new Error('server did not start');
+}
+
+(async () => {
+  const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-conversation-api-'));
+  const layout = new StorageLayout({ dataDir });
+  const settings = new SettingsStore({ layout });
+  const registry = new ProjectRegistryStore({ layout });
+  const projects = new ProjectStore({ layout });
+  await settings.initialize({ knowledge: { rootPath: path.join(dataDir, 'knowledge') } });
+  await registry.initialize();
+  const projectId = 'project-conversation-api';
+  const repoPath = path.join(dataDir, 'repo');
+  const knowledgePath = path.join(dataDir, 'knowledge', projectId);
+  fs.mkdirSync(repoPath, { recursive: true });
+  fs.mkdirSync(knowledgePath, { recursive: true });
+  await projects.create(projectId, {
+    displayName: 'Conversation API', storageName: 'conversation-api', repoPath, knowledgePath,
+  }, { conversationBaselineCursor: 0, conversation: { lastConsumedCursor: 0, captureStatus: 'captured' } });
+  await registry.add(projectId, { displayNameSnapshot: 'Conversation API' });
+  const store = new ConversationStore({ layout, projectStore: projects });
+  const repoIdentity = { repoId: 'conversation-api-repo' };
+  const unsafePrompt = '<script>alert("conversation-body")</script> Keep this as plain text.';
+  async function append(eventId, sequence, turnId, role, content, capturedAt) {
+    return (await store.appendEvent(projectId, {
+      eventId, sequence, source: 'codex', eventType: role === 'user' ? 'user_prompt' : 'assistant_response', role, content,
+      sessionId: 'session-api', turnId, repoIdentity, projectPath: repoPath, branch: 'main', headAtCapture: '0'.repeat(40),
+      capturedAt, identityConfidence: 'high', captureStatus: 'captured',
+    })).event;
+  }
+  const r1 = await append('r1', 1, 'turn-1', 'user', unsafePrompt, '2026-08-18T01:00:00.000Z');
+  const a1 = await append('a1', 2, 'turn-1', 'assistant', 'Rendered only as plain assistant text.', '2026-08-18T01:01:00.000Z');
+  const r2 = await append('r2', 3, 'turn-2', 'user', 'Second prompt.', '2026-08-18T02:00:00.000Z');
   const a2 = await append('a2', 4, 'turn-2', 'assistant', 'Second reply.', '2026-08-18T02:01:00.000Z');
   await append('r3', 5, 'turn-3', 'user', 'Third prompt.', '2026-08-18T03:00:00.000Z');
-  await append('r4', 6, 'turn-other-date', 'user', 'Other date prompt.', '2026-08-19T03:00:00.000Z');
-  const projectEvent = event => ({ eventId: event.eventId, sequence: event.sequence, content: event.content, contentHash: event.contentHash, capturedAt: event.capturedAt });
+  await append('r4', 6, 'turn-other-date', 'user', 'Other date prompt.', '2026-08-19T03:00:00.000Z');
+  const projectEvent = event => ({ eventId: event.eventId, sequence: event.sequence, content: event.content, contentHash: event.contentHash, capturedAt: event.capturedAt });
   store.writeSnapshot(projectId, {
-    commitSha: '1'.repeat(40), repoIdentity, parentSha: null, boundaryStartCursor: 0, boundaryEndCursor: 2, status: 'available',
-    turns: [{ turnId: 'turn-1', source: 'codex', sessionId: 'session-api', bindingKind: 'direct', userEvents: [projectEvent(r1)], assistantEvents: [projectEvent(a1)] }],
+    commitSha: '1'.repeat(40), repoIdentity, parentSha: null, boundaryStartCursor: 0, boundaryEndCursor: 2, status: 'available',
+    turns: [{ turnId: 'turn-1', source: 'codex', sessionId: 'session-api', bindingKind: 'direct', userEvents: [projectEvent(r1)], assistantEvents: [projectEvent(a1)] }],
   });
   store.writeSnapshot(projectId, {
     commitSha: '3'.repeat(40), repoIdentity, parentSha: '2'.repeat(40), boundaryStartCursor: 5, boundaryEndCursor: 5, status: 'available',
     turns: [{ turnId: 'turn-2', source: 'codex', sessionId: 'session-api', bindingKind: 'shared-spanning', userEvents: [projectEvent(r2)], assistantEvents: [projectEvent(a2)] }],
   });
-  store.writeSnapshot(projectId, {
-    commitSha: '2'.repeat(40), repoIdentity, parentSha: '1'.repeat(40), boundaryStartCursor: 2, boundaryEndCursor: 4, status: 'available',
-    turns: [{ turnId: 'turn-2', source: 'codex', sessionId: 'session-api', bindingKind: 'shared-spanning', userEvents: [projectEvent(r2)], assistantEvents: [projectEvent(a2)] }],
-  });
-
-  const spawned = spawnServer({ root: ROOT, port: PORT, dataDir, tag: 'conversation-api', extraEnv: { KB_SKIP_MIGRATION: '1' } });
-  try {
-    await waitForServer();
-    let response = await fetch(`${BASE}/api/conversations/projects`);
-    let body = await response.json();
-    assert.strictEqual(response.status, 200);
-    assert.deepStrictEqual(body.projects.map(project => project.projectId), [projectId]);
-    assert.strictEqual(Object.hasOwn(body.projects[0], 'repoPath'), false, 'project picker payload must not expose raw repository paths');
-
-    const date = localDate(r1.capturedAt);
-    response = await fetch(`${BASE}/api/conversations/turns?projectId=${projectId}&date=${date}&limit=2`);
-    body = await response.json();
-    assert.strictEqual(response.status, 200, JSON.stringify(body));
-    assert.strictEqual(body.turns.length, 2);
-    assert(body.nextCursor && body.hasMore);
-    const firstPage = body.turns;
-    response = await fetch(`${BASE}/api/conversations/turns?projectId=${projectId}&date=${date}&limit=2&cursor=${encodeURIComponent(body.nextCursor)}`);
-    const secondPage = await response.json();
-    assert.strictEqual(secondPage.turns.length, 1);
-    const allTurns = [...firstPage, ...secondPage.turns];
-    const turn1 = allTurns.find(turn => turn.turnId === 'turn-1');
-    const turn2 = allTurns.find(turn => turn.turnId === 'turn-2');
-    const turn3 = allTurns.find(turn => turn.turnId === 'turn-3');
-    assert.strictEqual(turn1.userPrompt, unsafePrompt, 'conversation body should remain exact business data');
-    assert.strictEqual(turn1.renderAs, 'plain-text', 'payload must instruct hosts to avoid HTML interpretation');
-    assert.strictEqual(turn1.annotation.status, 'committed');
-    assert.strictEqual(turn1.annotation.commits[0].shortSha, '1111111');
+  store.writeSnapshot(projectId, {
+    commitSha: '2'.repeat(40), repoIdentity, parentSha: '1'.repeat(40), boundaryStartCursor: 2, boundaryEndCursor: 4, status: 'available',
+    turns: [{ turnId: 'turn-2', source: 'codex', sessionId: 'session-api', bindingKind: 'shared-spanning', userEvents: [projectEvent(r2)], assistantEvents: [projectEvent(a2)] }],
+  });
+
+  const spawned = spawnServer({ root: ROOT, port: PORT, dataDir, tag: 'conversation-api', extraEnv: { KB_SKIP_MIGRATION: '1' } });
+  try {
+    await waitForServer();
+    let response = await fetch(`${BASE}/api/conversations/projects`);
+    let body = await response.json();
+    assert.strictEqual(response.status, 200);
+    assert.deepStrictEqual(body.projects.map(project => project.projectId), [projectId]);
+    assert.strictEqual(Object.hasOwn(body.projects[0], 'repoPath'), false, 'project picker payload must not expose raw repository paths');
+
+    const date = localDate(r1.capturedAt);
+    response = await fetch(`${BASE}/api/conversations/turns?projectId=${projectId}&date=${date}&limit=2`);
+    body = await response.json();
+    assert.strictEqual(response.status, 200, JSON.stringify(body));
+    assert.strictEqual(body.turns.length, 2);
+    assert(body.nextCursor && body.hasMore);
+    const firstPage = body.turns;
+    response = await fetch(`${BASE}/api/conversations/turns?projectId=${projectId}&date=${date}&limit=2&cursor=${encodeURIComponent(body.nextCursor)}`);
+    const secondPage = await response.json();
+    assert.strictEqual(secondPage.turns.length, 1);
+    const allTurns = [...firstPage, ...secondPage.turns];
+    const turn1 = allTurns.find(turn => turn.turnId === 'turn-1');
+    const turn2 = allTurns.find(turn => turn.turnId === 'turn-2');
+    const turn3 = allTurns.find(turn => turn.turnId === 'turn-3');
+    assert.strictEqual(turn1.userPrompt, unsafePrompt, 'conversation body should remain exact business data');
+    assert.strictEqual(turn1.renderAs, 'plain-text', 'payload must instruct hosts to avoid HTML interpretation');
+    assert.strictEqual(turn1.annotation.status, 'committed');
+    assert.strictEqual(turn1.annotation.commits[0].shortSha, '1111111');
     assert.strictEqual(turn2.annotation.status, 'associated');
     assert.deepStrictEqual(turn2.annotation.commits.map(commit => commit.shortSha), ['2222222'], 'stale shared-spanning annotations after the next user turn are hidden');
-    assert.strictEqual(turn3.annotation.status, 'uncommitted');
-    assert(allTurns.every(turn => turn.date === date));
-
-    response = await fetch(`${BASE}/api/conversations/turns?projectId=${projectId}&date=2026-08-19&cursor=${encodeURIComponent(body.nextCursor)}`);
-    assert.strictEqual(response.status, 409, 'cursor must be bound to one project/date query');
-    response = await fetch(`${BASE}/api/conversations/sessions?projectId=${projectId}`);
-    assert.strictEqual(response.status, 404, 'default product API must not expose source/session diagnostic routes');
-
-    response = await fetch(`${BASE}/api/logs/export`);
-    const exportedLogs = await response.text();
-    assert(!exportedLogs.includes('conversation-body'), 'conversation content must never leak into structured logs or export');
-    console.log('conversation-api-test PASS');
-  } finally {
-    await spawned.cleanup();
-  }
-})().catch(error => {
-  console.error(error.stack || error.message);
-  process.exitCode = 1;
-});
+    assert.strictEqual(turn3.annotation.status, 'uncommitted');
+    assert(allTurns.every(turn => turn.date === date));
+
+    response = await fetch(`${BASE}/api/conversations/turns?projectId=${projectId}&date=2026-08-19&cursor=${encodeURIComponent(body.nextCursor)}`);
+    assert.strictEqual(response.status, 409, 'cursor must be bound to one project/date query');
+    response = await fetch(`${BASE}/api/conversations/sessions?projectId=${projectId}`);
+    assert.strictEqual(response.status, 404, 'default product API must not expose source/session diagnostic routes');
+
+    response = await fetch(`${BASE}/api/logs/export`);
+    const exportedLogs = await response.text();
+    assert(!exportedLogs.includes('conversation-body'), 'conversation content must never leak into structured logs or export');
+    console.log('conversation-api-test PASS');
+  } finally {
+    await spawned.cleanup();
+  }
+})().catch(error => {
+  console.error(error.stack || error.message);
+  process.exitCode = 1;
+});