@sanqianx/project-knowledge 5.0.23 → 5.0.25

package/_site/_test/automatic-context-test.js

@@ -1,70 +1,70 @@
-'use strict';
-const assert = require('node:assert/strict');
-const fs = require('node:fs');
-const os = require('node:os');
-const path = require('node:path');
-const { IntegrationManager } = require('../lib/integration-installer');
-const { run, writeOutput } = require('../../plugins/project-knowledge/scripts/context-hook.cjs');
-
-async function main() {
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'automatic-context-'));
-  try {
-    const endpoint = { schema: 'project-knowledge/runtime-endpoint/v1', host: '127.0.0.1', pid: process.pid, port: 23456, startedAt: 'now' };
-    fs.writeFileSync(path.join(root, 'runtime-endpoint.json'), JSON.stringify(endpoint));
-    const payload = { cwd: root, session_id: 'session-a', hook_event_name: 'UserPromptSubmit', prompt: 'Develop export normally' };
-    const env = { KB_DATA_DIR: root }, calls = [];
-    const identity = { ...endpoint, schema: 'project-knowledge/runtime-control/v1', name: 'project-knowledge', dataDir: root };
-    const fetchImpl = async (url, options) => {
-      calls.push({ url: String(url), options });
-      if (String(url).endsWith('/identity')) return Response.json(identity);
-      const input = JSON.parse(options.body);
-      return Response.json({ ok: true, requestId: input.requestId, projectId: 'project-a', status: 'ready', memoryStatus: 'ready', prompt: '<knowledge_context>export revision 37</knowledge_context>', facts: [{}], memories: [{}], references: [{}] });
-    };
-    const output = await run(payload, { env, fetchImpl });
-    assert.match(output.hookSpecificOutput.additionalContext, /revision 37/); assert.equal(calls.length, 2);
-    assert.equal(JSON.parse(calls[1].options.body).query, payload.prompt);
-    assert.ok(!JSON.stringify(output).includes('receipt')); assert.ok(!fs.existsSync(path.join(root, 'logs')));
-    await writeOutput(output, { write: (text, callback) => { assert.ok(!text.includes('receipt')); callback(); } });
-    const logDir = path.join(root, 'logs/projects/project-a'); const logText = fs.readFileSync(path.join(logDir, fs.readdirSync(logDir)[0]), 'utf8');
-    assert.ok(!logText.includes(payload.prompt)); assert.ok(!logText.includes('revision 37')); assert.ok(logText.includes('agent.context.output'));
-    calls.length = 0;
-    assert.deepEqual(await run(payload, { env: { ...env, KB_KNOWLEDGE_CONTEXT: '0' }, fetchImpl }), {}); assert.equal(calls.length, 0);
-    assert.deepEqual(await run({ ...payload, hook_event_name: 'Stop' }, { env, fetchImpl }), {});
-    const mismatch = await run(payload, { env, fetchImpl: async () => Response.json({ ...identity, dataDir: path.join(root, 'other') }) });
-    assert.match(mismatch.systemMessage, /CONTEXT_IDENTITY_MISMATCH/);
-    const unknown = await run(payload, { env, fetchImpl: async url => String(url).endsWith('/identity') ? Response.json(identity) : Response.json({ ok: false, error: 'PROJECT_NOT_FOUND' }, { status: 404 }) });
-    assert.match(unknown.systemMessage, /未识别到当前代码目录/);
-    assert.match(unknown.hookSpecificOutput.additionalContext, /不代表知识库为空/);
-    const offline = await run(payload, { env, fetchImpl: async () => { throw new Error('sensitive untrusted upstream text'); } });
-    assert.match(offline.systemMessage, /可继续开发/); assert.ok(!JSON.stringify(offline).includes('sensitive'));
-    const slow = await run(payload, { env, timeoutMs: 30, fetchImpl: (url, options) => new Promise((resolve, reject) => options.signal.addEventListener('abort', () => reject(new Error('aborted')), { once: true })) });
-    assert.match(slow.systemMessage, /CONTEXT_TIMEOUT/);
-    let version = '4.2.16'; const commandCalls = [];
-    const manager = new IntegrationManager({ homeDir: root, commandResolver: name => name, runner: (command, args) => {
-      commandCalls.push(args.join(' '));
-      if (args.join(' ') === 'plugin list --json') return { status: 0, stdout: JSON.stringify([{ id: 'project-knowledge@project-knowledge', version, enabled: true }]) };
-      if (args.join(' ') === 'plugin marketplace list --json') return { status: 0, stdout: JSON.stringify([{ name: 'project-knowledge' }]) };
-      if (args.slice(0, 2).join(' ') === 'plugin update') {
-        version = manager.version;
-        const source = path.resolve(__dirname, '../../plugins/project-knowledge'), cache = path.join(root, '.claude/plugins/cache/project-knowledge/project-knowledge', version);
-        fs.mkdirSync(cache, { recursive: true }); fs.cpSync(source, cache, { recursive: true });
-      }
-      return { status: 0, stdout: '' };
-    } });
-    const knownMarketplaces = path.join(root, '.claude/plugins/known_marketplaces.json');
-    fs.mkdirSync(path.dirname(knownMarketplaces), { recursive: true });
-    fs.writeFileSync(knownMarketplaces, JSON.stringify({ 'project-knowledge': { source: { source: 'directory', path: manager.rootDir } } }));
-    assert.equal(manager.statusClaude().state, 'needs-update');
-    manager.installClaude();
-    assert.ok(commandCalls.includes('plugin marketplace update project-knowledge'));
-    assert.ok(commandCalls.includes('plugin update project-knowledge@project-knowledge --scope user'));
-    assert.equal(manager.statusClaude().state, 'installed');
-    const cacheRoot = path.join(root, '.claude/plugins/cache/project-knowledge/project-knowledge', manager.version);
-    for (const file of ['hooks/claude.json', 'scripts/context-hook.cjs']) fs.writeFileSync(path.join(cacheRoot, file), fs.readFileSync(path.join(cacheRoot, file), 'utf8').replace(/\r?\n/g, '\r\n'));
-    assert.equal(manager.automaticContextStatus('claude', manager.statusClaude()).configured, true, 'Git CRLF checkout and npm LF are the same client integration');
-    const before = commandCalls.filter(c => c.startsWith('plugin update')).length; manager.installClaude();
-    assert.equal(commandCalls.filter(c => c.startsWith('plugin update')).length, before);
-    console.log('Automatic context protocol, fail-open safety and stale-plugin upgrade passed.');
-  } finally { fs.rmSync(root, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 }); }
-}
-main().catch(error => { console.error(error); process.exitCode = 1; });
+'use strict';
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const { IntegrationManager } = require('../lib/integration-installer');
+const { run, writeOutput } = require('../../plugins/project-knowledge/scripts/context-hook.cjs');
+
+async function main() {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'automatic-context-'));
+  try {
+    const endpoint = { schema: 'project-knowledge/runtime-endpoint/v1', host: '127.0.0.1', pid: process.pid, port: 23456, startedAt: 'now' };
+    fs.writeFileSync(path.join(root, 'runtime-endpoint.json'), JSON.stringify(endpoint));
+    const payload = { cwd: root, session_id: 'session-a', hook_event_name: 'UserPromptSubmit', prompt: 'Develop export normally' };
+    const env = { KB_DATA_DIR: root }, calls = [];
+    const identity = { ...endpoint, schema: 'project-knowledge/runtime-control/v1', name: 'project-knowledge', dataDir: root };
+    const fetchImpl = async (url, options) => {
+      calls.push({ url: String(url), options });
+      if (String(url).endsWith('/identity')) return Response.json(identity);
+      const input = JSON.parse(options.body);
+      return Response.json({ ok: true, requestId: input.requestId, projectId: 'project-a', status: 'ready', memoryStatus: 'ready', prompt: '<knowledge_context>export revision 37</knowledge_context>', facts: [{}], memories: [{}], references: [{}] });
+    };
+    const output = await run(payload, { env, fetchImpl });
+    assert.match(output.hookSpecificOutput.additionalContext, /revision 37/); assert.equal(calls.length, 2);
+    assert.equal(JSON.parse(calls[1].options.body).query, payload.prompt);
+    assert.ok(!JSON.stringify(output).includes('receipt')); assert.ok(!fs.existsSync(path.join(root, 'logs')));
+    await writeOutput(output, { write: (text, callback) => { assert.ok(!text.includes('receipt')); callback(); } });
+    const logDir = path.join(root, 'logs/projects/project-a'); const logText = fs.readFileSync(path.join(logDir, fs.readdirSync(logDir)[0]), 'utf8');
+    assert.ok(!logText.includes(payload.prompt)); assert.ok(!logText.includes('revision 37')); assert.ok(logText.includes('agent.context.output'));
+    calls.length = 0;
+    assert.deepEqual(await run(payload, { env: { ...env, KB_KNOWLEDGE_CONTEXT: '0' }, fetchImpl }), {}); assert.equal(calls.length, 0);
+    assert.deepEqual(await run({ ...payload, hook_event_name: 'Stop' }, { env, fetchImpl }), {});
+    const mismatch = await run(payload, { env, fetchImpl: async () => Response.json({ ...identity, dataDir: path.join(root, 'other') }) });
+    assert.match(mismatch.systemMessage, /CONTEXT_IDENTITY_MISMATCH/);
+    const unknown = await run(payload, { env, fetchImpl: async url => String(url).endsWith('/identity') ? Response.json(identity) : Response.json({ ok: false, error: 'PROJECT_NOT_FOUND' }, { status: 404 }) });
+    assert.match(unknown.systemMessage, /未识别到当前代码目录/);
+    assert.match(unknown.hookSpecificOutput.additionalContext, /不代表知识库为空/);
+    const offline = await run(payload, { env, fetchImpl: async () => { throw new Error('sensitive untrusted upstream text'); } });
+    assert.match(offline.systemMessage, /可继续开发/); assert.ok(!JSON.stringify(offline).includes('sensitive'));
+    const slow = await run(payload, { env, timeoutMs: 30, fetchImpl: (url, options) => new Promise((resolve, reject) => options.signal.addEventListener('abort', () => reject(new Error('aborted')), { once: true })) });
+    assert.match(slow.systemMessage, /CONTEXT_TIMEOUT/);
+    let version = '4.2.16'; const commandCalls = [];
+    const manager = new IntegrationManager({ homeDir: root, commandResolver: name => name, runner: (command, args) => {
+      commandCalls.push(args.join(' '));
+      if (args.join(' ') === 'plugin list --json') return { status: 0, stdout: JSON.stringify([{ id: 'project-knowledge@project-knowledge', version, enabled: true }]) };
+      if (args.join(' ') === 'plugin marketplace list --json') return { status: 0, stdout: JSON.stringify([{ name: 'project-knowledge' }]) };
+      if (args.slice(0, 2).join(' ') === 'plugin update') {
+        version = manager.version;
+        const source = path.resolve(__dirname, '../../plugins/project-knowledge'), cache = path.join(root, '.claude/plugins/cache/project-knowledge/project-knowledge', version);
+        fs.mkdirSync(cache, { recursive: true }); fs.cpSync(source, cache, { recursive: true });
+      }
+      return { status: 0, stdout: '' };
+    } });
+    const knownMarketplaces = path.join(root, '.claude/plugins/known_marketplaces.json');
+    fs.mkdirSync(path.dirname(knownMarketplaces), { recursive: true });
+    fs.writeFileSync(knownMarketplaces, JSON.stringify({ 'project-knowledge': { source: { source: 'directory', path: manager.rootDir } } }));
+    assert.equal(manager.statusClaude().state, 'needs-update');
+    manager.installClaude();
+    assert.ok(commandCalls.includes('plugin marketplace update project-knowledge'));
+    assert.ok(commandCalls.includes('plugin update project-knowledge@project-knowledge --scope user'));
+    assert.equal(manager.statusClaude().state, 'installed');
+    const cacheRoot = path.join(root, '.claude/plugins/cache/project-knowledge/project-knowledge', manager.version);
+    for (const file of ['hooks/claude.json', 'scripts/context-hook.cjs']) fs.writeFileSync(path.join(cacheRoot, file), fs.readFileSync(path.join(cacheRoot, file), 'utf8').replace(/\r?\n/g, '\r\n'));
+    assert.equal(manager.automaticContextStatus('claude', manager.statusClaude()).configured, true, 'Git CRLF checkout and npm LF are the same client integration');
+    const before = commandCalls.filter(c => c.startsWith('plugin update')).length; manager.installClaude();
+    assert.equal(commandCalls.filter(c => c.startsWith('plugin update')).length, before);
+    console.log('Automatic context protocol, fail-open safety and stale-plugin upgrade passed.');
+  } finally { fs.rmSync(root, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 }); }
+}
+main().catch(error => { console.error(error); process.exitCode = 1; });

package/_site/_test/automation-queue-test.js

@@ -1,14 +1,14 @@
-// Run: node _site/_test/automation-queue-test.js
-
-const assert = require('assert');
-const fs = require('fs');
-const path = require('path');
-const automation = require('../lib/post-commit-automation');
-
-(() => {
-  assert.strictEqual(fs.existsSync(path.join(__dirname, '..', 'lib', 'automation-queue.js')), false, 'legacy in-memory automation queue must be deleted');
-  assert.strictEqual(fs.existsSync(path.join(__dirname, '..', 'lib', 'commit-automation-store.js')), false, 'legacy commit automation state must not remain a second pending authority');
-  assert.strictEqual(typeof automation.reconcileProjectCommits, 'function', 'Git-backed reconciler should be the single automation authority');
-  assert.strictEqual(Object.hasOwn(automation, 'dispatchPendingAutomations'), false, 'startup must not dispatch pending commit analysis');
-  console.log('automation-queue-test PASS');
-})();
+// Run: node _site/_test/automation-queue-test.js
+
+const assert = require('assert');
+const fs = require('fs');
+const path = require('path');
+const automation = require('../lib/post-commit-automation');
+
+(() => {
+  assert.strictEqual(fs.existsSync(path.join(__dirname, '..', 'lib', 'automation-queue.js')), false, 'legacy in-memory automation queue must be deleted');
+  assert.strictEqual(fs.existsSync(path.join(__dirname, '..', 'lib', 'commit-automation-store.js')), false, 'legacy commit automation state must not remain a second pending authority');
+  assert.strictEqual(typeof automation.reconcileProjectCommits, 'function', 'Git-backed reconciler should be the single automation authority');
+  assert.strictEqual(Object.hasOwn(automation, 'dispatchPendingAutomations'), false, 'startup must not dispatch pending commit analysis');
+  console.log('automation-queue-test PASS');
+})();

package/_site/_test/automation-ui-test.js

@@ -1,40 +1,40 @@
-const assert = require('assert');
-const fs = require('fs');
-const path = require('path');
-
-const ROOT = path.resolve(__dirname, '..', '..');
-const html = fs.readFileSync(path.join(ROOT, 'ui', 'index.html'), 'utf8');
-const app = fs.readFileSync(path.join(ROOT, 'ui', 'product.js'), 'utf8');
-const server = fs.readFileSync(path.join(ROOT, '_site', 'lib', 'server-app.js'), 'utf8');
-
-assert.strictEqual((html.match(/class="app"/g) || []).length, 1, 'production UI must have one full product shell');
-assert.strictEqual((html.match(/id="logsDialog"/g) || []).length, 1, 'production UI must have one diagnostics section');
-assert(html.includes('id="view-work"') && html.includes('id="view-search"') && html.includes('id="importDialog"'), 'Work, Search and Import must remain reachable');
-
-const forbiddenUi = [
-  /\/api\/projects\/[^"' ]+\/hook/,
-  /\/api\/projects\/[^"' ]+\/analy/,
-  /\/api\/projects\/[^"' ]+\/scan/,
-  /\/api\/projects\/[^"' ]+\/init/,
-  /simulate/i,
-  /installHook\s*\(/,
-  /uninstallHook\s*\(/,
-  /reinstallHook\s*\(/,
-  /manual analysis/i,
-];
-for (const pattern of forbiddenUi) assert(!pattern.test(html + app), 'removed manual automation control/call remains: ' + pattern);
-
-for (const route of [
-  '/api/projects/:projectId/hook/install',
-  '/api/projects/:projectId/hook/uninstall',
-  '/api/projects/:projectId/analyze/initial',
-  '/api/projects/:projectId/analyze/incremental',
-  '/api/projects/:projectId/simulate',
-]) {
-  assert(!server.includes(route), 'removed backend route remains: ' + route);
-}
-
-assert(!html.includes('vue.global.prod.js'), 'product shell must not require the old Vue runtime');
-assert(!html.includes('tailwind-browser.js'), 'product shell must not require the old browser Tailwind runtime');
-
-console.log('automation UI test PASS');
+const assert = require('assert');
+const fs = require('fs');
+const path = require('path');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const html = fs.readFileSync(path.join(ROOT, 'ui', 'index.html'), 'utf8');
+const app = fs.readFileSync(path.join(ROOT, 'ui', 'product.js'), 'utf8');
+const server = fs.readFileSync(path.join(ROOT, '_site', 'lib', 'server-app.js'), 'utf8');
+
+assert.strictEqual((html.match(/class="app"/g) || []).length, 1, 'production UI must have one full product shell');
+assert.strictEqual((html.match(/id="logsDialog"/g) || []).length, 1, 'production UI must have one diagnostics section');
+assert(html.includes('id="view-work"') && html.includes('id="view-search"') && html.includes('id="importDialog"'), 'Work, Search and Import must remain reachable');
+
+const forbiddenUi = [
+  /\/api\/projects\/[^"' ]+\/hook/,
+  /\/api\/projects\/[^"' ]+\/analy/,
+  /\/api\/projects\/[^"' ]+\/scan/,
+  /\/api\/projects\/[^"' ]+\/init/,
+  /simulate/i,
+  /installHook\s*\(/,
+  /uninstallHook\s*\(/,
+  /reinstallHook\s*\(/,
+  /manual analysis/i,
+];
+for (const pattern of forbiddenUi) assert(!pattern.test(html + app), 'removed manual automation control/call remains: ' + pattern);
+
+for (const route of [
+  '/api/projects/:projectId/hook/install',
+  '/api/projects/:projectId/hook/uninstall',
+  '/api/projects/:projectId/analyze/initial',
+  '/api/projects/:projectId/analyze/incremental',
+  '/api/projects/:projectId/simulate',
+]) {
+  assert(!server.includes(route), 'removed backend route remains: ' + route);
+}
+
+assert(!html.includes('vue.global.prod.js'), 'product shell must not require the old Vue runtime');
+assert(!html.includes('tailwind-browser.js'), 'product shell must not require the old browser Tailwind runtime');
+
+console.log('automation UI test PASS');

package/_site/_test/background-task-registry-test.js

@@ -1,43 +1,43 @@
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { activeTaskPromises, isProjectBusy, taskForProject } = require('../lib/server-app');
-
-function deferred() {
-  let resolve;
-  let reject;
-  const promise = new Promise((yes, no) => { resolve = yes; reject = no; });
-  return { promise, resolve, reject };
-}
-
-(async () => {
-  const records = [];
-  const runtime = {
-    activeTasks: new Map(),
-    logger: {
-      async debug(event, message, context) { records.push({ level: 'debug', event, message, ...context }); },
-      async error(event, message, context) { records.push({ level: 'error', event, message, ...context }); },
-    },
-  };
-  const longGate = deferred();
-  const long = taskForProject(runtime, 'project-a', 'op-long', () => longGate.promise, 'startup');
-  const fast = taskForProject(runtime, 'project-a', 'op-fast', async () => { throw new Error('fast failure'); }, 'git-hook');
-  assert.strictEqual(runtime.activeTasks.get('project-a').size, 2, 'overlapping operations must both remain registered');
-  assert.strictEqual(activeTaskPromises(runtime.activeTasks).length, 2, 'shutdown snapshot must include every operation promise');
-  assert.strictEqual(isProjectBusy('project-a', { readState: () => ({ analysis: { activeClaim: null } }) }, runtime.activeTasks), true);
-  await assert.rejects(fast, /fast failure/);
-  assert.strictEqual(runtime.activeTasks.get('project-a').size, 1, 'fast terminal must remove only its own operation');
-  assert(runtime.activeTasks.get('project-a').has('op-long'));
-  assert.strictEqual(activeTaskPromises(runtime.activeTasks).length, 1);
-  longGate.resolve('done');
-  assert.strictEqual(await long, 'done');
-  assert.strictEqual(runtime.activeTasks.has('project-a'), false, 'empty project task map must be removed');
-  assert(records.some(record => record.event === 'background.operation_failed' && record.operationId === 'op-fast'));
-  assert(records.some(record => record.event === 'background.operation_completed' && record.operationId === 'op-long'));
-
-  console.log('background-task-registry-test PASS');
-})().catch(error => {
-  console.error(error.stack || error.message);
-  process.exitCode = 1;
-});
+const assert = require('assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { activeTaskPromises, isProjectBusy, taskForProject } = require('../lib/server-app');
+
+function deferred() {
+  let resolve;
+  let reject;
+  const promise = new Promise((yes, no) => { resolve = yes; reject = no; });
+  return { promise, resolve, reject };
+}
+
+(async () => {
+  const records = [];
+  const runtime = {
+    activeTasks: new Map(),
+    logger: {
+      async debug(event, message, context) { records.push({ level: 'debug', event, message, ...context }); },
+      async error(event, message, context) { records.push({ level: 'error', event, message, ...context }); },
+    },
+  };
+  const longGate = deferred();
+  const long = taskForProject(runtime, 'project-a', 'op-long', () => longGate.promise, 'startup');
+  const fast = taskForProject(runtime, 'project-a', 'op-fast', async () => { throw new Error('fast failure'); }, 'git-hook');
+  assert.strictEqual(runtime.activeTasks.get('project-a').size, 2, 'overlapping operations must both remain registered');
+  assert.strictEqual(activeTaskPromises(runtime.activeTasks).length, 2, 'shutdown snapshot must include every operation promise');
+  assert.strictEqual(isProjectBusy('project-a', { readState: () => ({ analysis: { activeClaim: null } }) }, runtime.activeTasks), true);
+  await assert.rejects(fast, /fast failure/);
+  assert.strictEqual(runtime.activeTasks.get('project-a').size, 1, 'fast terminal must remove only its own operation');
+  assert(runtime.activeTasks.get('project-a').has('op-long'));
+  assert.strictEqual(activeTaskPromises(runtime.activeTasks).length, 1);
+  longGate.resolve('done');
+  assert.strictEqual(await long, 'done');
+  assert.strictEqual(runtime.activeTasks.has('project-a'), false, 'empty project task map must be removed');
+  assert(records.some(record => record.event === 'background.operation_failed' && record.operationId === 'op-fast'));
+  assert(records.some(record => record.event === 'background.operation_completed' && record.operationId === 'op-long'));
+
+  console.log('background-task-registry-test PASS');
+})().catch(error => {
+  console.error(error.stack || error.message);
+  process.exitCode = 1;
+});

package/_site/_test/baseline-schema-test.js

@@ -1,91 +1,91 @@
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { spawnServer } = require('./helpers/spawn-server');
-const { makeRepo } = require('./fixtures/make-git-repos');
-
-const ROOT = path.resolve(__dirname, '..', '..');
-const PORT = 7791;
-const BASE = 'http://127.0.0.1:' + PORT;
-
-async function json(method, pathname, body) {
-  const response = await fetch(BASE + pathname, {
-    method,
-    headers: body === undefined ? undefined : { 'content-type': 'application/json' },
-    body: body === undefined ? undefined : JSON.stringify(body),
-  });
-  return { response, body: await response.json() };
-}
-
-async function waitForServer() {
-  for (let attempt = 0; attempt < 150; attempt += 1) {
-    try { if ((await fetch(BASE + '/api/health')).ok) return; } catch {}
-    await new Promise(resolve => setTimeout(resolve, 100));
-  }
-  throw new Error('v2 baseline server did not start');
-}
-
-(async () => {
-  const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-baseline-v2-'));
-  const knowledgeRoot = path.join(dataDir, 'knowledge-root');
-  const repo = makeRepo({ kind: 'one-commit' });
-  const spawned = spawnServer({ root: ROOT, port: PORT, dataDir, tag: 'baseline-v2', stdio: 'ignore' });
-  try {
-    await waitForServer();
-    let result = await json('GET', '/api/state');
-    assert.strictEqual(result.response.status, 200);
-    assert.strictEqual(result.body.schema, 'server-state/v2');
-    assert.strictEqual(result.body.settings.schema, 'settings/v2');
-    assert.deepStrictEqual(result.body.projects, []);
-
-    result = await json('PATCH', '/api/settings', { knowledge: { rootPath: knowledgeRoot } });
-    assert.strictEqual(result.response.status, 200);
-
-    result = await json('POST', '/api/projects/import', { localPath: repo.path, displayName: 'Baseline v2' });
-    assert.strictEqual(result.response.status, 201, JSON.stringify(result.body));
-    const projectId = result.body.projectId;
-    const project = result.body.project;
-    assert.strictEqual(project.config.schema, 'project-config/v2');
-    assert.strictEqual(project.state.schema, 'project-state/v2');
-    assert.strictEqual(project.config.projectId, projectId);
-    assert.strictEqual(project.state.trackingStartCommit, repo.headCommit);
-    assert.strictEqual(project.state.lastAnalyzedCommit, null);
-    assert.strictEqual(project.state.analysis.status, 'idle');
-    assert.strictEqual(project.state.hook.managedVersion, 2);
-    assert(path.isAbsolute(project.config.repoPath) && path.isAbsolute(project.config.knowledgePath));
-    assert(project.config.knowledgePath.startsWith(path.resolve(knowledgeRoot)));
-    assert.deepStrictEqual(fs.readdirSync(project.config.knowledgePath), []);
-
-    const registry = JSON.parse(fs.readFileSync(path.join(dataDir, 'projects.json'), 'utf8'));
-    assert.strictEqual(registry.schema, 'project-registry/v2');
-    assert.deepStrictEqual(registry.projectOrder, [projectId]);
-    assert.deepStrictEqual(Object.keys(registry.projects), [projectId]);
-    assert(!Object.prototype.hasOwnProperty.call(registry.projects[projectId], 'lastAnalyzedCommit'));
-
-    result = await json('GET', '/api/projects');
-    assert.strictEqual(result.response.status, 200);
-    assert.strictEqual(result.body.projects.length, 1);
-    assert.strictEqual(result.body.projects[0].projectId, projectId);
-
-    const htmlResponse = await fetch(BASE + '/');
-    const html = await htmlResponse.text();
-    assert.strictEqual(htmlResponse.status, 200);
-    assert.strictEqual((html.match(/class="app"/g) || []).length, 1);
-    assert.strictEqual((html.match(/id="logsDialog"/g) || []).length, 1);
-    assert(!html.includes('vue.global.prod.js'));
-
-    result = await json('DELETE', '/api/projects/' + encodeURIComponent(projectId), { deleteKnowledge: false });
-    assert.strictEqual(result.response.status, 200);
-    assert.strictEqual(fs.existsSync(project.config.knowledgePath), true, 'default delete must preserve external knowledge');
-    assert.strictEqual(fs.existsSync(path.join(repo.path, '.git', 'hooks', 'post-commit')), false);
-
-    console.log('baseline schema test PASS');
-  } finally {
-    await spawned.cleanup();
-    repo.cleanup();
-  }
-})().catch(error => {
-  console.error(error.stack || error.message);
-  process.exitCode = 1;
-});
+const assert = require('assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnServer } = require('./helpers/spawn-server');
+const { makeRepo } = require('./fixtures/make-git-repos');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const PORT = 7791;
+const BASE = 'http://127.0.0.1:' + PORT;
+
+async function json(method, pathname, body) {
+  const response = await fetch(BASE + pathname, {
+    method,
+    headers: body === undefined ? undefined : { 'content-type': 'application/json' },
+    body: body === undefined ? undefined : JSON.stringify(body),
+  });
+  return { response, body: await response.json() };
+}
+
+async function waitForServer() {
+  for (let attempt = 0; attempt < 150; attempt += 1) {
+    try { if ((await fetch(BASE + '/api/health')).ok) return; } catch {}
+    await new Promise(resolve => setTimeout(resolve, 100));
+  }
+  throw new Error('v2 baseline server did not start');
+}
+
+(async () => {
+  const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-baseline-v2-'));
+  const knowledgeRoot = path.join(dataDir, 'knowledge-root');
+  const repo = makeRepo({ kind: 'one-commit' });
+  const spawned = spawnServer({ root: ROOT, port: PORT, dataDir, tag: 'baseline-v2', stdio: 'ignore' });
+  try {
+    await waitForServer();
+    let result = await json('GET', '/api/state');
+    assert.strictEqual(result.response.status, 200);
+    assert.strictEqual(result.body.schema, 'server-state/v2');
+    assert.strictEqual(result.body.settings.schema, 'settings/v2');
+    assert.deepStrictEqual(result.body.projects, []);
+
+    result = await json('PATCH', '/api/settings', { knowledge: { rootPath: knowledgeRoot } });
+    assert.strictEqual(result.response.status, 200);
+
+    result = await json('POST', '/api/projects/import', { localPath: repo.path, displayName: 'Baseline v2' });
+    assert.strictEqual(result.response.status, 201, JSON.stringify(result.body));
+    const projectId = result.body.projectId;
+    const project = result.body.project;
+    assert.strictEqual(project.config.schema, 'project-config/v2');
+    assert.strictEqual(project.state.schema, 'project-state/v2');
+    assert.strictEqual(project.config.projectId, projectId);
+    assert.strictEqual(project.state.trackingStartCommit, repo.headCommit);
+    assert.strictEqual(project.state.lastAnalyzedCommit, null);
+    assert.strictEqual(project.state.analysis.status, 'idle');
+    assert.strictEqual(project.state.hook.managedVersion, 2);
+    assert(path.isAbsolute(project.config.repoPath) && path.isAbsolute(project.config.knowledgePath));
+    assert(project.config.knowledgePath.startsWith(path.resolve(knowledgeRoot)));
+    assert.deepStrictEqual(fs.readdirSync(project.config.knowledgePath), []);
+
+    const registry = JSON.parse(fs.readFileSync(path.join(dataDir, 'projects.json'), 'utf8'));
+    assert.strictEqual(registry.schema, 'project-registry/v2');
+    assert.deepStrictEqual(registry.projectOrder, [projectId]);
+    assert.deepStrictEqual(Object.keys(registry.projects), [projectId]);
+    assert(!Object.prototype.hasOwnProperty.call(registry.projects[projectId], 'lastAnalyzedCommit'));
+
+    result = await json('GET', '/api/projects');
+    assert.strictEqual(result.response.status, 200);
+    assert.strictEqual(result.body.projects.length, 1);
+    assert.strictEqual(result.body.projects[0].projectId, projectId);
+
+    const htmlResponse = await fetch(BASE + '/');
+    const html = await htmlResponse.text();
+    assert.strictEqual(htmlResponse.status, 200);
+    assert.strictEqual((html.match(/class="app"/g) || []).length, 1);
+    assert.strictEqual((html.match(/id="logsDialog"/g) || []).length, 1);
+    assert(!html.includes('vue.global.prod.js'));
+
+    result = await json('DELETE', '/api/projects/' + encodeURIComponent(projectId), { deleteKnowledge: false });
+    assert.strictEqual(result.response.status, 200);
+    assert.strictEqual(fs.existsSync(project.config.knowledgePath), true, 'default delete must preserve external knowledge');
+    assert.strictEqual(fs.existsSync(path.join(repo.path, '.git', 'hooks', 'post-commit')), false);
+
+    console.log('baseline schema test PASS');
+  } finally {
+    await spawned.cleanup();
+    repo.cleanup();
+  }
+})().catch(error => {
+  console.error(error.stack || error.message);
+  process.exitCode = 1;
+});