@sanqianx/project-knowledge 5.0.19 → 5.0.20-rc.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; });

package/_site/_test/git-validation-test.js

@@ -1,81 +1,81 @@
-// Git status remains a read-only v2 API; manual validation/state mutation is removed.
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { execFileSync } = require('child_process');
-const { spawnServer } = require('./helpers/spawn-server');
-const { makeRepo } = require('./fixtures/make-git-repos');
-
-const ROOT = path.resolve(__dirname, '..', '..');
-const DATA_DIR = fs.mkdtempSync(path.join(os.tmpdir(), `kb-data-git-validation-${process.pid}-`));
-const PORT = Number(process.env.KB_GIT_TEST_PORT || 7792);
-const BASE_URL = `http://127.0.0.1:${PORT}`;
-const PROJECT_ID = 'task-002-temp';
-
-async function waitForServer() {
-  for (let attempt = 0; attempt < 100; attempt += 1) {
-    try { if ((await fetch(`${BASE_URL}/api/health`)).ok) return; } catch {}
-    await new Promise(resolve => setTimeout(resolve, 100));
-  }
-  throw new Error('server did not start');
-}
-
-async function json(method, route, body) {
-  const response = await fetch(`${BASE_URL}${route}`, {
-    method,
-    headers: body ? { 'Content-Type': 'application/json' } : undefined,
-    body: body ? JSON.stringify(body) : undefined,
-  });
-  return { response, body: await response.json() };
-}
-
-(async () => {
-  const repo = makeRepo({ kind: 'one-commit' });
-  const spawned = spawnServer({ root: ROOT, port: PORT, dataDir: DATA_DIR, tag: 'git-validation', extraEnv: { KB_AUTOMATION_FAKE_CLAUDE: '1' } });
-  let output = '';
-  spawned.child.stdout.on('data', chunk => { output += chunk; });
-  spawned.child.stderr.on('data', chunk => { output += chunk; });
-  try {
-    await waitForServer();
-    let result = await json('PATCH', '/api/settings', { knowledge: { rootPath: path.join(DATA_DIR, 'knowledge') } });
-    assert(result.response.ok, JSON.stringify(result.body));
-    result = await json('POST', '/api/projects/import', { projectId: PROJECT_ID, localPath: repo.path, displayName: 'Git status fixture' });
-    assert(result.response.status === 201, JSON.stringify(result.body));
-
-    const statePath = path.join(DATA_DIR, 'projects', PROJECT_ID, 'state.json');
-    const stateBefore = fs.readFileSync(statePath, 'utf8');
-    result = await json('GET', `/api/projects/${PROJECT_ID}/git-status`);
-    assert(result.response.ok, JSON.stringify(result.body));
-    assert.strictEqual(result.body.repoStatus, 'ok');
-    assert.strictEqual(result.body.branch, 'main');
-    assert.strictEqual(result.body.dirty, false);
-    assert.match(result.body.headCommit, /^[a-f0-9]{40}$/i);
-    assert.strictEqual(fs.readFileSync(statePath, 'utf8'), stateBefore, 'read-only status must not mutate project state');
-
-    fs.writeFileSync(path.join(repo.path, 'untracked.txt'), 'working tree change\n', 'utf8');
-    result = await json('GET', `/api/projects/${PROJECT_ID}/git-status`);
-    assert.strictEqual(result.body.dirty, true);
-    assert(result.body.changes.some(line => line.includes('untracked.txt')));
-
-    execFileSync('git', ['add', 'untracked.txt'], { cwd: repo.path });
-    execFileSync('git', ['commit', '-m', 'status fixture'], { cwd: repo.path });
-    result = await json('GET', `/api/projects/${PROJECT_ID}/git-status`);
-    assert.strictEqual(result.body.repoStatus, 'ok');
-    assert.strictEqual(result.body.dirty, false);
-
-    result = await json('POST', `/api/projects/${PROJECT_ID}/validate-git`, {});
-    assert.strictEqual(result.response.status, 404, 'manual validation route must remain deleted');
-    result = await json('GET', '/api/projects/%5Ebad/git-status');
-    assert.strictEqual(result.response.status, 400);
-    result = await json('GET', '/api/projects/project-missing/git-status');
-    assert.strictEqual(result.response.status, 404);
-    console.log('TASK-002 git validation test passed');
-  } catch (error) {
-    if (output) process.stderr.write(output);
-    throw error;
-  } finally {
-    await spawned.cleanup();
-    repo.cleanup();
-  }
-})().catch(error => { console.error(error); process.exitCode = 1; });
+// Git status remains a read-only v2 API; manual validation/state mutation is removed.
+const assert = require('assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { execFileSync } = require('child_process');
+const { spawnServer } = require('./helpers/spawn-server');
+const { makeRepo } = require('./fixtures/make-git-repos');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const DATA_DIR = fs.mkdtempSync(path.join(os.tmpdir(), `kb-data-git-validation-${process.pid}-`));
+const PORT = Number(process.env.KB_GIT_TEST_PORT || 7792);
+const BASE_URL = `http://127.0.0.1:${PORT}`;
+const PROJECT_ID = 'task-002-temp';
+
+async function waitForServer() {
+  for (let attempt = 0; attempt < 100; attempt += 1) {
+    try { if ((await fetch(`${BASE_URL}/api/health`)).ok) return; } catch {}
+    await new Promise(resolve => setTimeout(resolve, 100));
+  }
+  throw new Error('server did not start');
+}
+
+async function json(method, route, body) {
+  const response = await fetch(`${BASE_URL}${route}`, {
+    method,
+    headers: body ? { 'Content-Type': 'application/json' } : undefined,
+    body: body ? JSON.stringify(body) : undefined,
+  });
+  return { response, body: await response.json() };
+}
+
+(async () => {
+  const repo = makeRepo({ kind: 'one-commit' });
+  const spawned = spawnServer({ root: ROOT, port: PORT, dataDir: DATA_DIR, tag: 'git-validation', extraEnv: { KB_AUTOMATION_FAKE_CLAUDE: '1' } });
+  let output = '';
+  spawned.child.stdout.on('data', chunk => { output += chunk; });
+  spawned.child.stderr.on('data', chunk => { output += chunk; });
+  try {
+    await waitForServer();
+    let result = await json('PATCH', '/api/settings', { knowledge: { rootPath: path.join(DATA_DIR, 'knowledge') } });
+    assert(result.response.ok, JSON.stringify(result.body));
+    result = await json('POST', '/api/projects/import', { projectId: PROJECT_ID, localPath: repo.path, displayName: 'Git status fixture' });
+    assert(result.response.status === 201, JSON.stringify(result.body));
+
+    const statePath = path.join(DATA_DIR, 'projects', PROJECT_ID, 'state.json');
+    const stateBefore = fs.readFileSync(statePath, 'utf8');
+    result = await json('GET', `/api/projects/${PROJECT_ID}/git-status`);
+    assert(result.response.ok, JSON.stringify(result.body));
+    assert.strictEqual(result.body.repoStatus, 'ok');
+    assert.strictEqual(result.body.branch, 'main');
+    assert.strictEqual(result.body.dirty, false);
+    assert.match(result.body.headCommit, /^[a-f0-9]{40}$/i);
+    assert.strictEqual(fs.readFileSync(statePath, 'utf8'), stateBefore, 'read-only status must not mutate project state');
+
+    fs.writeFileSync(path.join(repo.path, 'untracked.txt'), 'working tree change\n', 'utf8');
+    result = await json('GET', `/api/projects/${PROJECT_ID}/git-status`);
+    assert.strictEqual(result.body.dirty, true);
+    assert(result.body.changes.some(line => line.includes('untracked.txt')));
+
+    execFileSync('git', ['add', 'untracked.txt'], { cwd: repo.path });
+    execFileSync('git', ['commit', '-m', 'status fixture'], { cwd: repo.path });
+    result = await json('GET', `/api/projects/${PROJECT_ID}/git-status`);
+    assert.strictEqual(result.body.repoStatus, 'ok');
+    assert.strictEqual(result.body.dirty, false);
+
+    result = await json('POST', `/api/projects/${PROJECT_ID}/validate-git`, {});
+    assert.strictEqual(result.response.status, 404, 'manual validation route must remain deleted');
+    result = await json('GET', '/api/projects/%5Ebad/git-status');
+    assert.strictEqual(result.response.status, 400);
+    result = await json('GET', '/api/projects/project-missing/git-status');
+    assert.strictEqual(result.response.status, 404);
+    console.log('TASK-002 git validation test passed');
+  } catch (error) {
+    if (output) process.stderr.write(output);
+    throw error;
+  } finally {
+    await spawned.cleanup();
+    repo.cleanup();
+  }
+})().catch(error => { console.error(error); process.exitCode = 1; });

package/_site/_test/hook-worktree-test.js

@@ -1,42 +1,42 @@
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { spawnSync } = require('child_process');
-const { installHook, readHookStatus, migrateManagedHook, LEGACY_HOOK_MARKER } = require('../lib/hook-manager');
-
-const ROOT = path.resolve(__dirname, '..', '..');
-const TRIGGER = path.join(ROOT, '_site', 'scripts', 'hook-trigger.js');
-
-function git(repo, args) {
-  const result = spawnSync('git', ['-C', repo, ...args], { encoding: 'utf8', windowsHide: true, env: { ...process.env, GIT_TERMINAL_PROMPT: '0' } });
-  if (result.status !== 0) throw new Error(result.stderr || `git ${args.join(' ')} failed`);
-  return String(result.stdout || '').trim();
-}
-
-const base = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-hook-worktree-'));
-const main = path.join(base, 'main repo');
-const linked = path.join(base, 'linked worktree');
-fs.mkdirSync(main, { recursive: true });
-git(main, ['init', '--initial-branch=main']);
-git(main, ['config', 'user.email', 'hook@example.invalid']);
-git(main, ['config', 'user.name', 'Hook Test']);
-fs.writeFileSync(path.join(main, 'README.md'), '# main\n');
-git(main, ['add', 'README.md']);
-git(main, ['commit', '-m', 'initial']);
-git(main, ['worktree', 'add', '-b', 'linked', linked]);
-
-git(linked, ['config', 'core.hooksPath', '.custom-hooks']);
-const installed = installHook({ repoPath: linked, projectId: 'project-worktree', triggerScriptPath: TRIGGER });
-const authoritativeHooks = git(linked, ['rev-parse', '--path-format=absolute', '--git-path', 'hooks']);
-assert.strictEqual(path.resolve(path.dirname(installed.hookPath)), path.resolve(authoritativeHooks));
-assert.strictEqual(readHookStatus({ repoPath: linked, projectId: 'project-worktree' }).installed, true);
-
-fs.writeFileSync(installed.hookPath, `#!/bin/sh\n${LEGACY_HOOK_MARKER} — old\nexit 0\n`);
-const migrated = migrateManagedHook({ repoPath: linked, projectId: 'project-worktree', triggerScriptPath: TRIGGER });
-assert.strictEqual(migrated.migrated, true);
-const second = migrateManagedHook({ repoPath: linked, projectId: 'project-worktree', triggerScriptPath: TRIGGER });
-assert.strictEqual(second.migrated, false);
-assert.strictEqual(second.reason, 'current');
-
-console.log('hook-worktree-test PASS');
+const assert = require('assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+const { installHook, readHookStatus, migrateManagedHook, LEGACY_HOOK_MARKER } = require('../lib/hook-manager');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const TRIGGER = path.join(ROOT, '_site', 'scripts', 'hook-trigger.js');
+
+function git(repo, args) {
+  const result = spawnSync('git', ['-C', repo, ...args], { encoding: 'utf8', windowsHide: true, env: { ...process.env, GIT_TERMINAL_PROMPT: '0' } });
+  if (result.status !== 0) throw new Error(result.stderr || `git ${args.join(' ')} failed`);
+  return String(result.stdout || '').trim();
+}
+
+const base = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-hook-worktree-'));
+const main = path.join(base, 'main repo');
+const linked = path.join(base, 'linked worktree');
+fs.mkdirSync(main, { recursive: true });
+git(main, ['init', '--initial-branch=main']);
+git(main, ['config', 'user.email', 'hook@example.invalid']);
+git(main, ['config', 'user.name', 'Hook Test']);
+fs.writeFileSync(path.join(main, 'README.md'), '# main\n');
+git(main, ['add', 'README.md']);
+git(main, ['commit', '-m', 'initial']);
+git(main, ['worktree', 'add', '-b', 'linked', linked]);
+
+git(linked, ['config', 'core.hooksPath', '.custom-hooks']);
+const installed = installHook({ repoPath: linked, projectId: 'project-worktree', triggerScriptPath: TRIGGER });
+const authoritativeHooks = git(linked, ['rev-parse', '--path-format=absolute', '--git-path', 'hooks']);
+assert.strictEqual(path.resolve(path.dirname(installed.hookPath)), path.resolve(authoritativeHooks));
+assert.strictEqual(readHookStatus({ repoPath: linked, projectId: 'project-worktree' }).installed, true);
+
+fs.writeFileSync(installed.hookPath, `#!/bin/sh\n${LEGACY_HOOK_MARKER} — old\nexit 0\n`);
+const migrated = migrateManagedHook({ repoPath: linked, projectId: 'project-worktree', triggerScriptPath: TRIGGER });
+assert.strictEqual(migrated.migrated, true);
+const second = migrateManagedHook({ repoPath: linked, projectId: 'project-worktree', triggerScriptPath: TRIGGER });
+assert.strictEqual(second.migrated, false);
+assert.strictEqual(second.reason, 'current');
+
+console.log('hook-worktree-test PASS');

package/_site/_test/index-builder-test.js

@@ -1,41 +1,41 @@
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { regenerateIndexes } = require('../lib/index-builder');
-
-const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'index-builder-test-'));
-
-try {
-  const modules = path.join(temp, 'modules');
-  const changes = path.join(temp, 'changes');
-  fs.mkdirSync(modules, { recursive: true });
-  fs.mkdirSync(changes, { recursive: true });
-
-  const manyTags = Array.from({ length: 40 }, (_, index) => `tag-${index}`);
-  fs.writeFileSync(path.join(modules, 'core.md'), `---\ntitle: Core | API\ntags: [${manyTags.join(', ')}]\nsourcePaths: [${manyTags.map(tag => `src/${tag}.js`).join(', ')}]\nsymbols: [${manyTags.map(tag => `symbol-${tag}`).join(', ')}]\n---\n# Core\n`, 'utf8');
-
-  for (let index = 0; index < 105; index++) {
-    const day = String((index % 28) + 1).padStart(2, '0');
-    fs.writeFileSync(path.join(changes, `change-${String(index).padStart(3, '0')}.md`), `---\ntitle: Change ${index}\ntags: [${manyTags.join(', ')}]\naffectedModules: [core, api, ui, worker, storage, release]\nupdatedAt: 2026-07-${day}\ndevelopmentIntent: ${'Long intent '.repeat(80)}\n---\n# Change ${index}\n`, 'utf8');
-  }
-
-  regenerateIndexes(temp);
-  const moduleIndex = fs.readFileSync(path.join(modules, '00-index.md'), 'utf8');
-  const changeIndex = fs.readFileSync(path.join(changes, '00-index.md'), 'utf8');
-
-  assert(!/^Tags:/m.test(moduleIndex), 'module index must not aggregate all tags');
-  assert(!/^Tags:/m.test(changeIndex), 'change index must not aggregate all tags');
-  assert(moduleIndex.startsWith('<!-- Generated by project-knowledge.'), 'generated indexes should identify themselves as derived files');
-  assert(moduleIndex.includes('[Core \\| API](./core.md)'), 'Markdown table links should escape title separators');
-  assert(moduleIndex.includes('tag-0, tag-1, tag-2, tag-3 (+36)'), 'tags should be capped with a remainder count');
-  assert(changeIndex.includes('Items: 105 (showing 40;'), 'large change indexes should be bounded');
-  assert.equal((changeIndex.match(/^\| \[/gm) || []).length, 40, 'only the most recent 40 entries should be listed');
-  assert(Buffer.byteLength(changeIndex, 'utf8') < 30000, 'large generated indexes should stay below 30 KiB');
-  assert(Math.max(...moduleIndex.split(/\r?\n/).map(line => line.length)) < 900, 'module index lines should stay compact');
-  assert(Math.max(...changeIndex.split(/\r?\n/).map(line => line.length)) < 900, 'change index lines should stay compact');
-
-  console.log('index-builder-test: PASS');
-} finally {
-  fs.rmSync(temp, { recursive: true, force: true });
-}
+const assert = require('assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { regenerateIndexes } = require('../lib/index-builder');
+
+const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'index-builder-test-'));
+
+try {
+  const modules = path.join(temp, 'modules');
+  const changes = path.join(temp, 'changes');
+  fs.mkdirSync(modules, { recursive: true });
+  fs.mkdirSync(changes, { recursive: true });
+
+  const manyTags = Array.from({ length: 40 }, (_, index) => `tag-${index}`);
+  fs.writeFileSync(path.join(modules, 'core.md'), `---\ntitle: Core | API\ntags: [${manyTags.join(', ')}]\nsourcePaths: [${manyTags.map(tag => `src/${tag}.js`).join(', ')}]\nsymbols: [${manyTags.map(tag => `symbol-${tag}`).join(', ')}]\n---\n# Core\n`, 'utf8');
+
+  for (let index = 0; index < 105; index++) {
+    const day = String((index % 28) + 1).padStart(2, '0');
+    fs.writeFileSync(path.join(changes, `change-${String(index).padStart(3, '0')}.md`), `---\ntitle: Change ${index}\ntags: [${manyTags.join(', ')}]\naffectedModules: [core, api, ui, worker, storage, release]\nupdatedAt: 2026-07-${day}\ndevelopmentIntent: ${'Long intent '.repeat(80)}\n---\n# Change ${index}\n`, 'utf8');
+  }
+
+  regenerateIndexes(temp);
+  const moduleIndex = fs.readFileSync(path.join(modules, '00-index.md'), 'utf8');
+  const changeIndex = fs.readFileSync(path.join(changes, '00-index.md'), 'utf8');
+
+  assert(!/^Tags:/m.test(moduleIndex), 'module index must not aggregate all tags');
+  assert(!/^Tags:/m.test(changeIndex), 'change index must not aggregate all tags');
+  assert(moduleIndex.startsWith('<!-- Generated by project-knowledge.'), 'generated indexes should identify themselves as derived files');
+  assert(moduleIndex.includes('[Core \\| API](./core.md)'), 'Markdown table links should escape title separators');
+  assert(moduleIndex.includes('tag-0, tag-1, tag-2, tag-3 (+36)'), 'tags should be capped with a remainder count');
+  assert(changeIndex.includes('Items: 105 (showing 40;'), 'large change indexes should be bounded');
+  assert.equal((changeIndex.match(/^\| \[/gm) || []).length, 40, 'only the most recent 40 entries should be listed');
+  assert(Buffer.byteLength(changeIndex, 'utf8') < 30000, 'large generated indexes should stay below 30 KiB');
+  assert(Math.max(...moduleIndex.split(/\r?\n/).map(line => line.length)) < 900, 'module index lines should stay compact');
+  assert(Math.max(...changeIndex.split(/\r?\n/).map(line => line.length)) < 900, 'change index lines should stay compact');
+
+  console.log('index-builder-test: PASS');
+} finally {
+  fs.rmSync(temp, { recursive: true, force: true });
+}

package/_site/_test/index-error-display-contract-test.js

@@ -1,10 +1,10 @@
-'use strict';
-const assert = require('node:assert/strict');
-const fs = require('node:fs');
-const path = require('node:path');
-const source = fs.readFileSync(path.resolve(__dirname, '../../ui/product.js'), 'utf8');
-for (const field of ['upstreamMessage', 'failureKind', 'upstreamCode', 'requestId', 'attempt', 'httpStatus', 'durationMs']) {
-  assert.ok(source.includes(`esc(r.error.details.${field}`), `index detail must be escaped: ${field}`);
-}
-assert.ok(source.includes("['failed', 'index-pending'].includes(r.state)"));
-console.log('index-error-display-contract-test PASS (real rendering/export covered by engine test:web:faults)');
+'use strict';
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+const source = fs.readFileSync(path.resolve(__dirname, '../../ui/product.js'), 'utf8');
+for (const field of ['upstreamMessage', 'failureKind', 'upstreamCode', 'requestId', 'attempt', 'httpStatus', 'durationMs']) {
+  assert.ok(source.includes(`esc(r.error.details.${field}`), `index detail must be escaped: ${field}`);
+}
+assert.ok(source.includes("['failed', 'index-pending'].includes(r.state)"));
+console.log('index-error-display-contract-test PASS (real rendering/export covered by engine test:web:faults)');