@sanqianx/project-knowledge 5.0.18 → 5.0.20-rc.1

package/_site/_test/fixtures/make-git-repos.js

@@ -1,92 +1,92 @@
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { execFileSync } = require('child_process');
-
-function parseArgs(input) {
-  if (Array.isArray(input)) return input.map(String);
-  const out = [];
-  const re = /"([^"]*)"|'([^']*)'|(\S+)/g;
-  let match;
-  while ((match = re.exec(String(input || '')))) {
-    out.push(match[1] != null ? match[1] : match[2] != null ? match[2] : match[3]);
-  }
-  return out;
-}
-
-function git(cwd, args) {
-  const argv = ['-C', cwd, ...parseArgs(args)];
-  return execFileSync('git', argv, { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'] }).trim();
-}
-
-function write(filePath, content) {
-  fs.mkdirSync(path.dirname(filePath), { recursive: true });
-  fs.writeFileSync(filePath, content);
-}
-
-function commit(repoPath, message) {
-  git(repoPath, ['add', '.']);
-  git(repoPath, ['commit', '-q', '-m', message]);
-  const hash = git(repoPath, ['rev-parse', 'HEAD']);
-  return {
-    hash,
-    short: hash.slice(0, 7),
-    date: git(repoPath, ['show', '-s', '--format=%ad', '--date=short', 'HEAD']),
-    author: git(repoPath, ['show', '-s', '--format=%an', 'HEAD']),
-    subject: message,
-  };
-}
-
-function initRepo(repoPath) {
-  git(repoPath, ['init', '-q', '-b', 'main']);
-  git(repoPath, ['config', 'user.name', 'Project Knowledge Test']);
-  git(repoPath, ['config', 'user.email', 'project-knowledge-test@example.local']);
-  git(repoPath, ['config', 'commit.gpgsign', 'false']);
-}
-
-function makeRepo({ kind = 'one-commit' } = {}) {
-  const repoPath = fs.mkdtempSync(path.join(os.tmpdir(), `kb-fixture-${kind}-${process.pid}-`));
-  const commits = [];
-  const cleanup = () => {
-    if (path.dirname(repoPath) !== path.resolve(os.tmpdir()) || !path.basename(repoPath).startsWith(`kb-fixture-${kind}-${process.pid}-`)) throw new Error('Unsafe fixture cleanup');
-    if (fs.existsSync(repoPath)) fs.rmSync(repoPath, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
-  };
-
-  if (kind === 'not-git') {
-    write(path.join(repoPath, 'README.md'), '# not git\n');
-    return { path: repoPath, commits, headCommit: null, cleanup };
-  }
-
-  initRepo(repoPath);
-
-  if (kind === 'empty') {
-    return { path: repoPath, commits, headCommit: null, cleanup };
-  }
-
-  write(path.join(repoPath, 'README.md'), `# ${kind}\n`);
-  commits.push(commit(repoPath, 'chore: initial commit'));
-
-  if (kind === 'one-commit') {
-    return { path: repoPath, commits, headCommit: commits[commits.length - 1].hash, cleanup };
-  }
-
-  if (kind === 'feature-commit') {
-    write(path.join(repoPath, 'src', 'feature.ts'), 'export const feature = true;\n');
-    commits.push(commit(repoPath, 'feat: add feature module'));
-  } else if (kind === 'multi-commit') {
-    write(path.join(repoPath, 'src', 'a.ts'), 'export const a = 1;\n');
-    commits.push(commit(repoPath, 'feat: add a module'));
-    write(path.join(repoPath, 'src', 'b.ts'), 'export const b = 2;\n');
-    commits.push(commit(repoPath, 'fix: add b module'));
-  } else if (kind === 'binary-commit') {
-    fs.writeFileSync(path.join(repoPath, 'big.bin'), Buffer.alloc(256 * 1024, 7));
-    commits.push(commit(repoPath, 'feat: add binary fixture'));
-  } else {
-    cleanup();
-    throw new Error(`unknown fixture kind: ${kind}`);
-  }
-
-  return { path: repoPath, commits, headCommit: commits[commits.length - 1].hash, cleanup };
-}
-
-module.exports = { makeRepo, git };
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { execFileSync } = require('child_process');
+
+function parseArgs(input) {
+  if (Array.isArray(input)) return input.map(String);
+  const out = [];
+  const re = /"([^"]*)"|'([^']*)'|(\S+)/g;
+  let match;
+  while ((match = re.exec(String(input || '')))) {
+    out.push(match[1] != null ? match[1] : match[2] != null ? match[2] : match[3]);
+  }
+  return out;
+}
+
+function git(cwd, args) {
+  const argv = ['-C', cwd, ...parseArgs(args)];
+  return execFileSync('git', argv, { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'] }).trim();
+}
+
+function write(filePath, content) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, content);
+}
+
+function commit(repoPath, message) {
+  git(repoPath, ['add', '.']);
+  git(repoPath, ['commit', '-q', '-m', message]);
+  const hash = git(repoPath, ['rev-parse', 'HEAD']);
+  return {
+    hash,
+    short: hash.slice(0, 7),
+    date: git(repoPath, ['show', '-s', '--format=%ad', '--date=short', 'HEAD']),
+    author: git(repoPath, ['show', '-s', '--format=%an', 'HEAD']),
+    subject: message,
+  };
+}
+
+function initRepo(repoPath) {
+  git(repoPath, ['init', '-q', '-b', 'main']);
+  git(repoPath, ['config', 'user.name', 'Project Knowledge Test']);
+  git(repoPath, ['config', 'user.email', 'project-knowledge-test@example.local']);
+  git(repoPath, ['config', 'commit.gpgsign', 'false']);
+}
+
+function makeRepo({ kind = 'one-commit' } = {}) {
+  const repoPath = fs.mkdtempSync(path.join(os.tmpdir(), `kb-fixture-${kind}-${process.pid}-`));
+  const commits = [];
+  const cleanup = () => {
+    if (path.dirname(repoPath) !== path.resolve(os.tmpdir()) || !path.basename(repoPath).startsWith(`kb-fixture-${kind}-${process.pid}-`)) throw new Error('Unsafe fixture cleanup');
+    if (fs.existsSync(repoPath)) fs.rmSync(repoPath, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
+  };
+
+  if (kind === 'not-git') {
+    write(path.join(repoPath, 'README.md'), '# not git\n');
+    return { path: repoPath, commits, headCommit: null, cleanup };
+  }
+
+  initRepo(repoPath);
+
+  if (kind === 'empty') {
+    return { path: repoPath, commits, headCommit: null, cleanup };
+  }
+
+  write(path.join(repoPath, 'README.md'), `# ${kind}\n`);
+  commits.push(commit(repoPath, 'chore: initial commit'));
+
+  if (kind === 'one-commit') {
+    return { path: repoPath, commits, headCommit: commits[commits.length - 1].hash, cleanup };
+  }
+
+  if (kind === 'feature-commit') {
+    write(path.join(repoPath, 'src', 'feature.ts'), 'export const feature = true;\n');
+    commits.push(commit(repoPath, 'feat: add feature module'));
+  } else if (kind === 'multi-commit') {
+    write(path.join(repoPath, 'src', 'a.ts'), 'export const a = 1;\n');
+    commits.push(commit(repoPath, 'feat: add a module'));
+    write(path.join(repoPath, 'src', 'b.ts'), 'export const b = 2;\n');
+    commits.push(commit(repoPath, 'fix: add b module'));
+  } else if (kind === 'binary-commit') {
+    fs.writeFileSync(path.join(repoPath, 'big.bin'), Buffer.alloc(256 * 1024, 7));
+    commits.push(commit(repoPath, 'feat: add binary fixture'));
+  } else {
+    cleanup();
+    throw new Error(`unknown fixture kind: ${kind}`);
+  }
+
+  return { path: repoPath, commits, headCommit: commits[commits.length - 1].hash, cleanup };
+}
+
+module.exports = { makeRepo, git };

package/_site/_test/fixtures/retrieval-gold-queries.json

@@ -0,0 +1,32 @@
+[
+  {"id":"S01","kind":"semantic","project":"product","query":"默认监听地址被别的程序占用后，模块如何避让并确认服务身份？","entry":"changes/c4afa63fa1ca.md","fact":"dynamic"},
+  {"id":"S02","kind":"semantic","project":"product","query":"桌面窗口怎样复用网页后台并在退出时处理自己启动的进程？","entry":"changes/6ea83d5c4e59.md","fact":"后台"},
+  {"id":"S03","kind":"semantic","project":"product","query":"客户端检测尚未结束时，为什么不能记录用户已移除接入？","entry":"changes/155e3bf3bb5f.md","fact":"扫描"},
+  {"id":"S04","kind":"semantic","project":"product","query":"外部开发工具的接入开关怎样记住用户选择并在启动时修复？","entry":"changes/b2da6dd5d6fd.md","fact":"意图"},
+  {"id":"S05","kind":"semantic","project":"product","query":"正式网页版本完成响应性和完整对话历史验收后怎样推进发布？","entry":"changes/7fac75f63bca.md","fact":"5.0.17"},
+  {"id":"S06","kind":"semantic","project":"workbench","query":"相同项目的嵌入消息反复到达，为何不应作废正在创建的会话？","entry":"changes/29e2cf932e08.md","fact":"selectionEpoch"},
+  {"id":"S07","kind":"semantic","project":"workbench","query":"实时缓存被截断以后，如何继续向前读取保存过的完整对话？","entry":"changes/c0ad1f4439cf.md","fact":"history"},
+  {"id":"S08","kind":"semantic","project":"workbench","query":"会话完成一轮输出后，列表上的最近活动时间为何仍停在创建时？","entry":"changes/b79e8bb03b48.md","fact":"updatedAt"},
+  {"id":"S09","kind":"semantic","project":"workbench","query":"保存模型供应商后，怎样避免复用保存之前仍在途的旧目录请求？","entry":"changes/3e8c9924e673.md","fact":"afterMutation"},
+  {"id":"S10","kind":"semantic","project":"workbench","query":"异步查找客户端期间任务已取消，如何阻止迟到的初始化再启动进程？","entry":"changes/1b028da75b0b.md","fact":"sdkTurnGeneration"},
+  {"id":"E01","kind":"exact","project":"product","query":"提交 c4afa63fa1ca 的端口扫描耗尽错误是什么？","entry":"changes/c4afa63fa1ca.md","fact":"NO_FREE_MODULE_PORT"},
+  {"id":"E02","kind":"exact","project":"product","query":"提交 155e3bf3bb5f 如何处理尚未落定的扫描？","entry":"changes/155e3bf3bb5f.md","fact":"扫描"},
+  {"id":"E03","kind":"exact","project":"workbench","query":"提交 b79e8bb03b48 的 updatedAt 修改涉及什么驱动？","entry":"changes/b79e8bb03b48.md","fact":"updatedAt"},
+  {"id":"E04","kind":"exact","project":"workbench","query":"提交 29e2cf932e08 如何保护新会话创建？","entry":"changes/29e2cf932e08.md","fact":"selectionEpoch"},
+  {"id":"E05","kind":"exact","project":"workbench","query":"提交 3e8c9924e673 的 afterMutation 机制是什么？","entry":"changes/3e8c9924e673.md","fact":"afterMutation"},
+  {"id":"I01","kind":"isolation","project":"product","query":"会话创建 selectionEpoch 如何处理？"},
+  {"id":"I02","kind":"isolation","project":"workbench","query":"模块默认端口全被占用时如何处理？"},
+  {"id":"I03","kind":"isolation","project":"engine","query":"桌面窗口退出如何保留网页后台？","empty":true},
+  {"id":"I04","kind":"isolation","project":"engine","query":"供应商保存后 afterMutation 如何处理？","empty":true},
+  {"id":"I05","kind":"isolation","project":"product","query":"从未维护的项目完整历史分页怎么加载？"},
+  {"id":"D01","kind":"stale","project":"product","query":"c4afa63fa1ca 动态端口","entry":"changes/c4afa63fa1ca.md"},
+  {"id":"D02","kind":"stale","project":"product","query":"6ea83d5c4e59 桌面薄壳","entry":"changes/6ea83d5c4e59.md"},
+  {"id":"D03","kind":"stale","project":"product","query":"155e3bf3bb5f 意图迁移","entry":"changes/155e3bf3bb5f.md"},
+  {"id":"D04","kind":"stale","project":"workbench","query":"29e2cf932e08 会话创建","entry":"changes/29e2cf932e08.md"},
+  {"id":"D05","kind":"stale","project":"workbench","query":"b79e8bb03b48 最近活动时间","entry":"changes/b79e8bb03b48.md"},
+  {"id":"N01","kind":"unsupported","project":"product","query":"当前项目 PostgreSQL 主从故障切换与 WAL 归档策略是什么？","empty":true},
+  {"id":"N02","kind":"unsupported","project":"product","query":"当前项目 OpenTelemetry 追踪数据上报到哪里？","empty":true},
+  {"id":"N03","kind":"unsupported","project":"workbench","query":"当前项目 ElasticSearch 搜索集群如何备份？","empty":true},
+  {"id":"N04","kind":"unsupported","project":"workbench","query":"当前项目 TensorFlow 模型训练批次如何配置？","empty":true},
+  {"id":"N05","kind":"unsupported","project":"product","query":"当前项目 ClickHouse 分片副本如何部署？","empty":true}
+]

package/_site/_test/fresh-hook-reimport-test.js

@@ -1,53 +1,53 @@
-const assert = require('assert/strict');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { execFileSync } = require('child_process');
-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 { ProjectLifecycleService } = require('../lib/project-lifecycle-service');
-const hooks = require('../lib/hook-manager');
-
-(async () => {
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'kb-fresh-hook-'));
-  const layout = new StorageLayout({ dataDir: path.join(root, 'fresh') });
-  const settingsStore = new SettingsStore({ layout });
-  const registryStore = new ProjectRegistryStore({ layout });
-  const projectStore = new ProjectStore({ layout });
-  const triggerScriptPath = path.resolve(__dirname, '../scripts/hook-trigger.js');
-  await settingsStore.initialize({ knowledge: { rootPath: path.join(root, 'knowledge') } });
-  await registryStore.initialize();
-  const options = { layout, settingsStore, registryStore, projectStore, triggerScriptPath };
-  const lifecycle = new ProjectLifecycleService(options);
-  const repo = path.join(root, '中文 项目'); fs.mkdirSync(repo);
-  const git = args => execFileSync('git', args, { cwd: repo, windowsHide: true, encoding: 'utf8' }).trim();
-  git(['init', '-q']); git(['config', 'user.name', 'Fresh Test']); git(['config', 'user.email', 'fresh@example.invalid']);
-  fs.writeFileSync(path.join(repo, 'user-code.txt'), 'unchanged'); git(['add', '.']); git(['commit', '-qm', 'baseline']);
-  const old = hooks.installHook({ repoPath: repo, projectId: 'project-old', triggerScriptPath, dataDir: path.join(root, 'old') });
-  const oldBytes = fs.readFileSync(old.hookPath, 'utf8');
-  const input = { localPath: repo, projectId: 'project-new', storageName: 'new' };
-  const preflight = await lifecycle.preflightImport(input);
-  assert.equal(preflight.checks.hook.replacementProjectId, 'project-old');
-  for (const confirmation of [undefined, 'project-wrong']) {
-    await assert.rejects(lifecycle.importProject({ ...input, replaceManagedHookProjectId: confirmation }), { code: 'HOOK_CONFLICT' });
-    assert.equal(fs.readFileSync(old.hookPath, 'utf8'), oldBytes);
-    assert.equal(registryStore.listIds().length, 0);
-  }
-  const brokenRegistry = Object.create(registryStore);
-  brokenRegistry.add = async () => { throw new Error('registry write failed'); };
-  await assert.rejects(new ProjectLifecycleService({ ...options, registryStore: brokenRegistry }).importProject({ ...input, replaceManagedHookProjectId: 'project-old' }));
-  assert.equal(fs.readFileSync(old.hookPath, 'utf8'), oldBytes, 'failed import restores the old managed hook');
-  const result = await lifecycle.importProject({ ...input, replaceManagedHookProjectId: 'project-old' });
-  assert.equal(hooks.readHookStatus({ repoPath: repo }).projectId, 'project-new');
-  assert.equal(result.state.lastAnalyzedCommit, null);
-  assert.equal(result.state.trackingStartCommit, git(['rev-parse', 'HEAD']));
-  assert.deepEqual(fs.readdirSync(result.config.knowledgePath), []);
-  assert.equal(fs.readFileSync(path.join(repo, 'user-code.txt'), 'utf8'), 'unchanged');
-  await lifecycle.deleteProject('project-new');
-  const thirdParty = '#!/bin/sh\necho third-party\n'; fs.writeFileSync(old.hookPath, thirdParty);
-  await assert.rejects(lifecycle.importProject({ ...input, replaceManagedHookProjectId: 'project-old' }), { code: 'HOOK_CONFLICT' });
-  assert.equal(fs.readFileSync(old.hookPath, 'utf8'), thirdParty);
-  console.log('PASS explicit fresh Hook replacement, rollback, baseline, third-party protection');
-})().catch(error => { console.error(error); process.exitCode = 1; });
+const assert = require('assert/strict');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { execFileSync } = require('child_process');
+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 { ProjectLifecycleService } = require('../lib/project-lifecycle-service');
+const hooks = require('../lib/hook-manager');
+
+(async () => {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'kb-fresh-hook-'));
+  const layout = new StorageLayout({ dataDir: path.join(root, 'fresh') });
+  const settingsStore = new SettingsStore({ layout });
+  const registryStore = new ProjectRegistryStore({ layout });
+  const projectStore = new ProjectStore({ layout });
+  const triggerScriptPath = path.resolve(__dirname, '../scripts/hook-trigger.js');
+  await settingsStore.initialize({ knowledge: { rootPath: path.join(root, 'knowledge') } });
+  await registryStore.initialize();
+  const options = { layout, settingsStore, registryStore, projectStore, triggerScriptPath };
+  const lifecycle = new ProjectLifecycleService(options);
+  const repo = path.join(root, '中文 项目'); fs.mkdirSync(repo);
+  const git = args => execFileSync('git', args, { cwd: repo, windowsHide: true, encoding: 'utf8' }).trim();
+  git(['init', '-q']); git(['config', 'user.name', 'Fresh Test']); git(['config', 'user.email', 'fresh@example.invalid']);
+  fs.writeFileSync(path.join(repo, 'user-code.txt'), 'unchanged'); git(['add', '.']); git(['commit', '-qm', 'baseline']);
+  const old = hooks.installHook({ repoPath: repo, projectId: 'project-old', triggerScriptPath, dataDir: path.join(root, 'old') });
+  const oldBytes = fs.readFileSync(old.hookPath, 'utf8');
+  const input = { localPath: repo, projectId: 'project-new', storageName: 'new' };
+  const preflight = await lifecycle.preflightImport(input);
+  assert.equal(preflight.checks.hook.replacementProjectId, 'project-old');
+  for (const confirmation of [undefined, 'project-wrong']) {
+    await assert.rejects(lifecycle.importProject({ ...input, replaceManagedHookProjectId: confirmation }), { code: 'HOOK_CONFLICT' });
+    assert.equal(fs.readFileSync(old.hookPath, 'utf8'), oldBytes);
+    assert.equal(registryStore.listIds().length, 0);
+  }
+  const brokenRegistry = Object.create(registryStore);
+  brokenRegistry.add = async () => { throw new Error('registry write failed'); };
+  await assert.rejects(new ProjectLifecycleService({ ...options, registryStore: brokenRegistry }).importProject({ ...input, replaceManagedHookProjectId: 'project-old' }));
+  assert.equal(fs.readFileSync(old.hookPath, 'utf8'), oldBytes, 'failed import restores the old managed hook');
+  const result = await lifecycle.importProject({ ...input, replaceManagedHookProjectId: 'project-old' });
+  assert.equal(hooks.readHookStatus({ repoPath: repo }).projectId, 'project-new');
+  assert.equal(result.state.lastAnalyzedCommit, null);
+  assert.equal(result.state.trackingStartCommit, git(['rev-parse', 'HEAD']));
+  assert.deepEqual(fs.readdirSync(result.config.knowledgePath), []);
+  assert.equal(fs.readFileSync(path.join(repo, 'user-code.txt'), 'utf8'), 'unchanged');
+  await lifecycle.deleteProject('project-new');
+  const thirdParty = '#!/bin/sh\necho third-party\n'; fs.writeFileSync(old.hookPath, thirdParty);
+  await assert.rejects(lifecycle.importProject({ ...input, replaceManagedHookProjectId: 'project-old' }), { code: 'HOOK_CONFLICT' });
+  assert.equal(fs.readFileSync(old.hookPath, 'utf8'), thirdParty);
+  console.log('PASS explicit fresh Hook replacement, rollback, baseline, third-party protection');
+})().catch(error => { console.error(error); process.exitCode = 1; });

package/_site/_test/fresh-product-data-test.js

@@ -1,56 +1,56 @@
-const assert = require('assert/strict');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { initializeProductData, DATA_SCHEMA } = require('../lib/product-data');
-const { resolveDataDirPath } = require('../lib/data-dir');
-const { connectEngine } = require('../lib/engine-connection');
-
-(async () => {
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'kb-fresh-product-'));
-  assert.equal(resolveDataDirPath({ dataDir: '', homeDir: root }), path.join(root, '.project-knowledge-v5'));
-  const old = path.join(root, 'old'); fs.mkdirSync(old);
-  const bytes = JSON.stringify({ projects: ['old-project'], activeClaim: 'old-claim' });
-  fs.writeFileSync(path.join(old, 'projects.json'), bytes);
-  assert.throws(() => initializeProductData(old), { code: 'SCHEMA_UNSUPPORTED' });
-  assert.equal(fs.readFileSync(path.join(old, 'projects.json'), 'utf8'), bytes);
-  const fresh = path.join(root, 'fresh'); initializeProductData(fresh); initializeProductData(fresh);
-  assert.equal(JSON.parse(fs.readFileSync(path.join(fresh, 'product-data.json'))).schema, DATA_SCHEMA);
-  const auxiliary = path.join(root, 'auxiliary');
-  const session = path.join(auxiliary, 'runtime', 'claude-sessions', 'unregistered-test', 'session.json');
-  fs.mkdirSync(path.dirname(session), { recursive: true });
-  fs.writeFileSync(session, 'untouched abandoned chat');
-  fs.writeFileSync(path.join(auxiliary, 'launcher.log'), 'old startup failure');
-  initializeProductData(auxiliary);
-  assert.equal(fs.readFileSync(session, 'utf8'), 'untouched abandoned chat');
-  for (const entry of ['claims', 'runs', 'promotions', 'transactions', 'unknown-business-state']) {
-    const pending = path.join(root, entry);
-    fs.mkdirSync(path.join(pending, 'runtime', entry), { recursive: true });
-    fs.writeFileSync(path.join(pending, 'runtime', entry, 'record.json'), '{}');
-    assert.throws(() => initializeProductData(pending), error => error.code === 'SCHEMA_UNSUPPORTED' && error.message.includes(`runtime/${entry}`));
-    assert.equal(fs.existsSync(path.join(pending, 'product-data.json')), false);
-  }
-  const paths = [];
-  let activationStatus = 403;
-  const logs = [];
-  const runtime = {
-    analysisOwner: 'engine', registryStore: { listIds: () => [] }, logger: { warn: async (...args) => logs.push(args) },
-    moduleBridge: { engineUrl: 'http://engine.invalid', runtimeToken: 'private-local-token', syncEngineConfiguration: async () => {}, _fetch: async url => {
-      paths.push(url);
-      if (url.endsWith('/api/health')) return { ok: true, status: 200, json: async () => ({ name: 'knowledge-engine', version: '0.2.0', dataSchemaVersion: 3 }) };
-      if (url.endsWith('/api/runtime-auth')) return { ok: true, status: 200 };
-      return { ok: activationStatus === 200, status: activationStatus };
-    } },
-  };
-  await connectEngine(runtime);
-  assert.equal(runtime.ownership.ready, false);
-  assert.equal(runtime.ownership.error.code, 'RUNTIME_AUTH_REQUIRED');
-  assert.equal(runtime.ownership.error.step, 'engine-activation');
-  assert.ok(!JSON.stringify(logs).includes('private-local-token'));
-  assert.ok(paths.every(url => !url.includes('migrate')));
-  await connectEngine(runtime);
-  assert.equal(logs.length, 1, 'identical connection failures are not repeatedly logged');
-  activationStatus = 200; await connectEngine(runtime);
-  assert.deepEqual(runtime.ownership, { owner: 'engine', ready: true });
-  console.log('PASS fresh data isolation, legacy rejection, precise connection failure, recovery without migration');
-})().catch(error => { console.error(error); process.exitCode = 1; });
+const assert = require('assert/strict');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { initializeProductData, DATA_SCHEMA } = require('../lib/product-data');
+const { resolveDataDirPath } = require('../lib/data-dir');
+const { connectEngine } = require('../lib/engine-connection');
+
+(async () => {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'kb-fresh-product-'));
+  assert.equal(resolveDataDirPath({ dataDir: '', homeDir: root }), path.join(root, '.project-knowledge-v5'));
+  const old = path.join(root, 'old'); fs.mkdirSync(old);
+  const bytes = JSON.stringify({ projects: ['old-project'], activeClaim: 'old-claim' });
+  fs.writeFileSync(path.join(old, 'projects.json'), bytes);
+  assert.throws(() => initializeProductData(old), { code: 'SCHEMA_UNSUPPORTED' });
+  assert.equal(fs.readFileSync(path.join(old, 'projects.json'), 'utf8'), bytes);
+  const fresh = path.join(root, 'fresh'); initializeProductData(fresh); initializeProductData(fresh);
+  assert.equal(JSON.parse(fs.readFileSync(path.join(fresh, 'product-data.json'))).schema, DATA_SCHEMA);
+  const auxiliary = path.join(root, 'auxiliary');
+  const session = path.join(auxiliary, 'runtime', 'claude-sessions', 'unregistered-test', 'session.json');
+  fs.mkdirSync(path.dirname(session), { recursive: true });
+  fs.writeFileSync(session, 'untouched abandoned chat');
+  fs.writeFileSync(path.join(auxiliary, 'launcher.log'), 'old startup failure');
+  initializeProductData(auxiliary);
+  assert.equal(fs.readFileSync(session, 'utf8'), 'untouched abandoned chat');
+  for (const entry of ['claims', 'runs', 'promotions', 'transactions', 'unknown-business-state']) {
+    const pending = path.join(root, entry);
+    fs.mkdirSync(path.join(pending, 'runtime', entry), { recursive: true });
+    fs.writeFileSync(path.join(pending, 'runtime', entry, 'record.json'), '{}');
+    assert.throws(() => initializeProductData(pending), error => error.code === 'SCHEMA_UNSUPPORTED' && error.message.includes(`runtime/${entry}`));
+    assert.equal(fs.existsSync(path.join(pending, 'product-data.json')), false);
+  }
+  const paths = [];
+  let activationStatus = 403;
+  const logs = [];
+  const runtime = {
+    analysisOwner: 'engine', registryStore: { listIds: () => [] }, logger: { warn: async (...args) => logs.push(args) },
+    moduleBridge: { engineUrl: 'http://engine.invalid', runtimeToken: 'private-local-token', syncEngineConfiguration: async () => {}, _fetch: async url => {
+      paths.push(url);
+      if (url.endsWith('/api/health')) return { ok: true, status: 200, json: async () => ({ name: 'knowledge-engine', version: '0.2.0', dataSchemaVersion: 3 }) };
+      if (url.endsWith('/api/runtime-auth')) return { ok: true, status: 200 };
+      return { ok: activationStatus === 200, status: activationStatus };
+    } },
+  };
+  await connectEngine(runtime);
+  assert.equal(runtime.ownership.ready, false);
+  assert.equal(runtime.ownership.error.code, 'RUNTIME_AUTH_REQUIRED');
+  assert.equal(runtime.ownership.error.step, 'engine-activation');
+  assert.ok(!JSON.stringify(logs).includes('private-local-token'));
+  assert.ok(paths.every(url => !url.includes('migrate')));
+  await connectEngine(runtime);
+  assert.equal(logs.length, 1, 'identical connection failures are not repeatedly logged');
+  activationStatus = 200; await connectEngine(runtime);
+  assert.deepEqual(runtime.ownership, { owner: 'engine', ready: true });
+  console.log('PASS fresh data isolation, legacy rejection, precise connection failure, recovery without migration');
+})().catch(error => { console.error(error); process.exitCode = 1; });

package/_site/_test/git-path-compatibility-test.js

@@ -1,80 +1,80 @@
-const assert = require('assert/strict');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { spawnSync } = require('child_process');
-const { resolveGitPath } = require('../lib/git-path');
-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 { ProjectLifecycleService } = require('../lib/project-lifecycle-service');
-const { BridgeAdapter } = require('../lib/bridge-adapter');
-const { Logger, LogRepository } = require('../lib/structured-logger');
-const hooks = require('../lib/hook-manager');
-
-(async () => {
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'kb-git-path-'));
-  const repo = path.join(root, '中文 空格项目'); fs.mkdirSync(repo);
-  const git = (args, cwd = repo) => {
-    const result = spawnSync('git', args, { cwd, encoding: 'utf8', windowsHide: true });
-    assert.equal(result.status, 0, result.stderr); return result.stdout.trim();
-  };
-  for (const invalid of ['', '--path-format=absolute\n.git/hooks', '.git/hooks\nother', '--unsupported', '\0']) {
-    assert.throws(() => resolveGitPath(repo, invalid), { code: 'INVALID_ARGUMENT' });
-  }
-  assert.equal(resolveGitPath(repo, '.git/hooks\r\n'), path.join(repo, '.git', 'hooks'));
-  git(['init', '-q']); git(['config', 'user.name', 'Git Compatibility']); git(['config', 'user.email', 'git-compat@example.invalid']);
-  fs.writeFileSync(path.join(repo, 'README.md'), '# baseline\n'); git(['add', '.']); git(['commit', '-qm', 'baseline']);
-  const layout = new StorageLayout({ dataDir: path.join(root, 'data') });
-  const settingsStore = new SettingsStore({ layout });
-  const registryStore = new ProjectRegistryStore({ layout });
-  const projectStore = new ProjectStore({ layout });
-  await settingsStore.initialize({ knowledge: { rootPath: path.join(root, 'knowledge') } });
-  await registryStore.initialize();
-  const bridgeAdapter = new BridgeAdapter({ dataDir: layout.getDataDir(), bridgeHomeDir: path.join(root, 'bridge') });
-  assert.ok(bridgeAdapter.isAvailable());
-  const logger = new Logger({ layout });
-  const triggerScriptPath = path.resolve(__dirname, '../scripts/hook-trigger.js');
-  const options = { layout, settingsStore, registryStore, projectStore, bridgeAdapter, logger, triggerScriptPath };
-  const lifecycle = new ProjectLifecycleService(options);
-  const input = { localPath: repo, knowledgePath: path.join(root, 'knowledge', 'fresh'), projectId: 'project-git-compat' };
-  const preflight = await lifecycle.preflightImport(input);
-  assert.equal(preflight.ready, true);
-  assert.equal(preflight.checks.git.commonDir, path.join(repo, '.git'));
-  const imported = await lifecycle.importProject(input);
-  assert.equal(imported.hook.hookPath, path.join(repo, '.git', 'hooks', 'post-commit'));
-  assert.equal(imported.config.repoIdentity.commonDir, path.join(repo, '.git'));
-  const nested = path.join(repo, 'src'); fs.mkdirSync(nested);
-  assert.equal((await bridgeAdapter.resolveRepoIdentity(nested)).repoIdentity.commonDir, imported.config.repoIdentity.commonDir);
-  fs.appendFileSync(path.join(repo, 'README.md'), 'commit after import\n'); git(['add', '.']); git(['commit', '-qm', 'captured update']);
-  const sha = git(['rev-parse', 'HEAD']);
-  const journal = await bridgeAdapter.readEvents({ after: 0, limit: 100 });
-  const boundary = journal.events.find(event => event.commitSha === sha && event.schema === 'git-commit-boundary/v1');
-  assert.ok(boundary, 'real Git post-commit Hook must append a durable boundary');
-  assert.equal(boundary.repoIdentity.commonDir, path.join(repo, '.git'));
-  assert.equal(boundary.projectId, input.projectId);
-  await lifecycle.deleteProject(input.projectId);
-  const brokenRegistry = Object.create(registryStore);
-  brokenRegistry.add = async () => { throw new Error('diagnostic registry failure'); };
-  await assert.rejects(new ProjectLifecycleService({ ...options, registryStore: brokenRegistry }).importProject(input), /Project import failed/);
-  const failed = new LogRepository({ layout }).query({ event: 'project.import.failed' }).entries[0];
-  assert.equal(failed.error.message, 'diagnostic registry failure');
-  assert.equal(failed.phase, 'hook-verified');
-  const transaction = JSON.parse(fs.readFileSync(lifecycle.transactionPath(failed.operationId), 'utf8'));
-  assert.equal(transaction.phase, 'failed'); assert.equal(transaction.failurePhase, 'hook-verified');
-  assert.equal(hooks.readHookStatus({ repoPath: repo }).installed, false);
-  const worktree = path.join(root, '关联 工作树'); git(['worktree', 'add', '-qb', 'linked', worktree]);
-  const sharedHook = hooks.installHook({ repoPath: worktree, projectId: 'project-worktree', triggerScriptPath });
-  assert.equal(path.dirname(sharedHook.hookPath), path.join(repo, '.git', 'hooks'));
-  hooks.uninstallHook({ repoPath: worktree, projectId: 'project-worktree' });
-  for (const custom of ['.custom hooks', path.join(root, '绝对 hooks')]) {
-    git(['config', 'core.hooksPath', custom], worktree);
-    const installed = hooks.installHook({ repoPath: worktree, projectId: 'project-worktree', triggerScriptPath });
-    assert.equal(path.dirname(installed.hookPath), path.resolve(worktree, custom));
-    assert.equal(hooks.readHookStatus({ repoPath: worktree }).installed, true);
-    hooks.uninstallHook({ repoPath: worktree, projectId: 'project-worktree' });
-  }
-  await logger.close();
-  console.log(`git-path-compatibility-test PASS (${git(['--version'])}; import → real Hook → journal; worktrees/custom hooks; diagnostic phase)`);
-})().catch(error => { console.error(error.stack || error.message); process.exitCode = 1; });
+const assert = require('assert/strict');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+const { resolveGitPath } = require('../lib/git-path');
+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 { ProjectLifecycleService } = require('../lib/project-lifecycle-service');
+const { BridgeAdapter } = require('../lib/bridge-adapter');
+const { Logger, LogRepository } = require('../lib/structured-logger');
+const hooks = require('../lib/hook-manager');
+
+(async () => {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'kb-git-path-'));
+  const repo = path.join(root, '中文 空格项目'); fs.mkdirSync(repo);
+  const git = (args, cwd = repo) => {
+    const result = spawnSync('git', args, { cwd, encoding: 'utf8', windowsHide: true });
+    assert.equal(result.status, 0, result.stderr); return result.stdout.trim();
+  };
+  for (const invalid of ['', '--path-format=absolute\n.git/hooks', '.git/hooks\nother', '--unsupported', '\0']) {
+    assert.throws(() => resolveGitPath(repo, invalid), { code: 'INVALID_ARGUMENT' });
+  }
+  assert.equal(resolveGitPath(repo, '.git/hooks\r\n'), path.join(repo, '.git', 'hooks'));
+  git(['init', '-q']); git(['config', 'user.name', 'Git Compatibility']); git(['config', 'user.email', 'git-compat@example.invalid']);
+  fs.writeFileSync(path.join(repo, 'README.md'), '# baseline\n'); git(['add', '.']); git(['commit', '-qm', 'baseline']);
+  const layout = new StorageLayout({ dataDir: path.join(root, 'data') });
+  const settingsStore = new SettingsStore({ layout });
+  const registryStore = new ProjectRegistryStore({ layout });
+  const projectStore = new ProjectStore({ layout });
+  await settingsStore.initialize({ knowledge: { rootPath: path.join(root, 'knowledge') } });
+  await registryStore.initialize();
+  const bridgeAdapter = new BridgeAdapter({ dataDir: layout.getDataDir(), bridgeHomeDir: path.join(root, 'bridge') });
+  assert.ok(bridgeAdapter.isAvailable());
+  const logger = new Logger({ layout });
+  const triggerScriptPath = path.resolve(__dirname, '../scripts/hook-trigger.js');
+  const options = { layout, settingsStore, registryStore, projectStore, bridgeAdapter, logger, triggerScriptPath };
+  const lifecycle = new ProjectLifecycleService(options);
+  const input = { localPath: repo, knowledgePath: path.join(root, 'knowledge', 'fresh'), projectId: 'project-git-compat' };
+  const preflight = await lifecycle.preflightImport(input);
+  assert.equal(preflight.ready, true);
+  assert.equal(preflight.checks.git.commonDir, path.join(repo, '.git'));
+  const imported = await lifecycle.importProject(input);
+  assert.equal(imported.hook.hookPath, path.join(repo, '.git', 'hooks', 'post-commit'));
+  assert.equal(imported.config.repoIdentity.commonDir, path.join(repo, '.git'));
+  const nested = path.join(repo, 'src'); fs.mkdirSync(nested);
+  assert.equal((await bridgeAdapter.resolveRepoIdentity(nested)).repoIdentity.commonDir, imported.config.repoIdentity.commonDir);
+  fs.appendFileSync(path.join(repo, 'README.md'), 'commit after import\n'); git(['add', '.']); git(['commit', '-qm', 'captured update']);
+  const sha = git(['rev-parse', 'HEAD']);
+  const journal = await bridgeAdapter.readEvents({ after: 0, limit: 100 });
+  const boundary = journal.events.find(event => event.commitSha === sha && event.schema === 'git-commit-boundary/v1');
+  assert.ok(boundary, 'real Git post-commit Hook must append a durable boundary');
+  assert.equal(boundary.repoIdentity.commonDir, path.join(repo, '.git'));
+  assert.equal(boundary.projectId, input.projectId);
+  await lifecycle.deleteProject(input.projectId);
+  const brokenRegistry = Object.create(registryStore);
+  brokenRegistry.add = async () => { throw new Error('diagnostic registry failure'); };
+  await assert.rejects(new ProjectLifecycleService({ ...options, registryStore: brokenRegistry }).importProject(input), /Project import failed/);
+  const failed = new LogRepository({ layout }).query({ event: 'project.import.failed' }).entries[0];
+  assert.equal(failed.error.message, 'diagnostic registry failure');
+  assert.equal(failed.phase, 'hook-verified');
+  const transaction = JSON.parse(fs.readFileSync(lifecycle.transactionPath(failed.operationId), 'utf8'));
+  assert.equal(transaction.phase, 'failed'); assert.equal(transaction.failurePhase, 'hook-verified');
+  assert.equal(hooks.readHookStatus({ repoPath: repo }).installed, false);
+  const worktree = path.join(root, '关联 工作树'); git(['worktree', 'add', '-qb', 'linked', worktree]);
+  const sharedHook = hooks.installHook({ repoPath: worktree, projectId: 'project-worktree', triggerScriptPath });
+  assert.equal(path.dirname(sharedHook.hookPath), path.join(repo, '.git', 'hooks'));
+  hooks.uninstallHook({ repoPath: worktree, projectId: 'project-worktree' });
+  for (const custom of ['.custom hooks', path.join(root, '绝对 hooks')]) {
+    git(['config', 'core.hooksPath', custom], worktree);
+    const installed = hooks.installHook({ repoPath: worktree, projectId: 'project-worktree', triggerScriptPath });
+    assert.equal(path.dirname(installed.hookPath), path.resolve(worktree, custom));
+    assert.equal(hooks.readHookStatus({ repoPath: worktree }).installed, true);
+    hooks.uninstallHook({ repoPath: worktree, projectId: 'project-worktree' });
+  }
+  await logger.close();
+  console.log(`git-path-compatibility-test PASS (${git(['--version'])}; import → real Hook → journal; worktrees/custom hooks; diagnostic phase)`);
+})().catch(error => { console.error(error.stack || error.message); process.exitCode = 1; });