@sanqianx/project-knowledge 5.0.24 → 5.0.26

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

@@ -1,85 +1,85 @@
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { spawnSync } = require('child_process');
-const {
-  HOOK_MARKER,
-  installHook,
-  uninstallHook,
-  readHookStatus,
-  parseManagedMarker,
-} = 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();
-}
-
-function makeRepo() {
-  const repo = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-hook-v2-repo-'));
-  git(repo, ['init', '--initial-branch=main']);
-  git(repo, ['config', 'user.email', 'hook@example.invalid']);
-  git(repo, ['config', 'user.name', 'Hook Test']);
-  fs.writeFileSync(path.join(repo, 'README.md'), '# hook\n');
-  git(repo, ['add', 'README.md']);
-  git(repo, ['commit', '-m', 'initial']);
-  return repo;
-}
-
-const repo = makeRepo();
-const claudePath = path.join(repo, 'CLAUDE.md');
-fs.writeFileSync(claudePath, '# user-owned\n');
-const projectId = 'project-hook-test';
-
-const installed = installHook({ repoPath: repo, projectId, triggerScriptPath: TRIGGER });
-assert.strictEqual(installed.ok, true);
-assert(fs.existsSync(installed.hookPath));
-const body = fs.readFileSync(installed.hookPath, 'utf8');
-assert(body.includes(HOOK_MARKER));
-assert(body.includes('--project-id'));
-assert(body.includes('--repo-root "$REPO_ROOT"'));
-assert(body.includes('git rev-parse --show-toplevel'));
-assert(!body.includes(repo.replace(/\\/g, '/')), 'managed hook must not embed the imported repo path');
-assert.strictEqual(parseManagedMarker(body).projectId, projectId);
-assert.strictEqual(fs.readFileSync(claudePath, 'utf8'), '# user-owned\n', 'Hook install must not modify CLAUDE.md');
-
-const repeated = installHook({ repoPath: repo, projectId, triggerScriptPath: TRIGGER });
-assert.strictEqual(repeated.updated, false);
-assert.strictEqual(fs.readFileSync(installed.hookPath, 'utf8'), body);
-assert.strictEqual(readHookStatus({ repoPath: repo, projectId }).installed, true);
-
-const removed = uninstallHook({ repoPath: repo, projectId });
-assert.strictEqual(removed.removed, true);
-assert.strictEqual(fs.readFileSync(claudePath, 'utf8'), '# user-owned\n', 'Hook uninstall must not modify CLAUDE.md');
-
-fs.writeFileSync(installed.hookPath, '#!/bin/sh\necho user-hook\n');
-assert.throws(() => installHook({ repoPath: repo, projectId, triggerScriptPath: TRIGGER }), error => error.code === 'HOOK_CONFLICT');
-assert.throws(() => uninstallHook({ repoPath: repo, projectId }), error => error.code === 'HOOK_CONFLICT');
-assert(fs.readFileSync(installed.hookPath, 'utf8').includes('user-hook'));
-
-const offlineData = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-hook-offline-'));
-const offlineBridgeHome = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-hook-offline-bridge-'));
-const offline = spawnSync(process.execPath, [TRIGGER, '--project-id', projectId, '--repo-root', repo, '--port', '65530'], {
-  encoding: 'utf8',
-  timeout: 10_000,
-  env: { ...process.env, KB_DATA_DIR: offlineData, KB_SKIP_MIGRATION: '1', AI_CODING_EVENT_BRIDGE_HOME: offlineBridgeHome },
-});
-assert.strictEqual(offline.status, 0, offline.stderr);
-const hooksLogDir = path.join(offlineData, 'logs', 'projects', projectId);
-assert(fs.existsSync(hooksLogDir));
-const lines = fs.readdirSync(hooksLogDir).flatMap(file => fs.readFileSync(path.join(hooksLogDir, file), 'utf8').trim().split(/\r?\n/).filter(Boolean).map(JSON.parse));
-assert(lines.some(line => line.schema === 'log/v2' && line.event === 'hook.notification.degraded'));
-assert(lines.some(line => line.schema === 'log/v2' && line.event === 'hook.boundary.captured'), 'boundary is durably captured even when the server is offline');
-const boundaryLines = fs.readFileSync(path.join(offlineBridgeHome, 'journal', 'events.jsonl'), 'utf8').trim().split(/\r?\n/).map(JSON.parse);
-assert(boundaryLines.some(record =>
-  record.schema === 'git-commit-boundary/v1' &&
-  record.projectId === projectId &&
-  record.repoIdentity && record.repoIdentity.schema === 'repo-identity/v1' &&
-  typeof record.repoIdentity.workspaceId === 'string'), 'boundary carries a canonical v1 workspace identity in the isolated Bridge journal');
-
-console.log('hook-trigger-test PASS');
+const assert = require('assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+const {
+  HOOK_MARKER,
+  installHook,
+  uninstallHook,
+  readHookStatus,
+  parseManagedMarker,
+} = 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();
+}
+
+function makeRepo() {
+  const repo = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-hook-v2-repo-'));
+  git(repo, ['init', '--initial-branch=main']);
+  git(repo, ['config', 'user.email', 'hook@example.invalid']);
+  git(repo, ['config', 'user.name', 'Hook Test']);
+  fs.writeFileSync(path.join(repo, 'README.md'), '# hook\n');
+  git(repo, ['add', 'README.md']);
+  git(repo, ['commit', '-m', 'initial']);
+  return repo;
+}
+
+const repo = makeRepo();
+const claudePath = path.join(repo, 'CLAUDE.md');
+fs.writeFileSync(claudePath, '# user-owned\n');
+const projectId = 'project-hook-test';
+
+const installed = installHook({ repoPath: repo, projectId, triggerScriptPath: TRIGGER });
+assert.strictEqual(installed.ok, true);
+assert(fs.existsSync(installed.hookPath));
+const body = fs.readFileSync(installed.hookPath, 'utf8');
+assert(body.includes(HOOK_MARKER));
+assert(body.includes('--project-id'));
+assert(body.includes('--repo-root "$REPO_ROOT"'));
+assert(body.includes('git rev-parse --show-toplevel'));
+assert(!body.includes(repo.replace(/\\/g, '/')), 'managed hook must not embed the imported repo path');
+assert.strictEqual(parseManagedMarker(body).projectId, projectId);
+assert.strictEqual(fs.readFileSync(claudePath, 'utf8'), '# user-owned\n', 'Hook install must not modify CLAUDE.md');
+
+const repeated = installHook({ repoPath: repo, projectId, triggerScriptPath: TRIGGER });
+assert.strictEqual(repeated.updated, false);
+assert.strictEqual(fs.readFileSync(installed.hookPath, 'utf8'), body);
+assert.strictEqual(readHookStatus({ repoPath: repo, projectId }).installed, true);
+
+const removed = uninstallHook({ repoPath: repo, projectId });
+assert.strictEqual(removed.removed, true);
+assert.strictEqual(fs.readFileSync(claudePath, 'utf8'), '# user-owned\n', 'Hook uninstall must not modify CLAUDE.md');
+
+fs.writeFileSync(installed.hookPath, '#!/bin/sh\necho user-hook\n');
+assert.throws(() => installHook({ repoPath: repo, projectId, triggerScriptPath: TRIGGER }), error => error.code === 'HOOK_CONFLICT');
+assert.throws(() => uninstallHook({ repoPath: repo, projectId }), error => error.code === 'HOOK_CONFLICT');
+assert(fs.readFileSync(installed.hookPath, 'utf8').includes('user-hook'));
+
+const offlineData = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-hook-offline-'));
+const offlineBridgeHome = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-hook-offline-bridge-'));
+const offline = spawnSync(process.execPath, [TRIGGER, '--project-id', projectId, '--repo-root', repo, '--port', '65530'], {
+  encoding: 'utf8',
+  timeout: 10_000,
+  env: { ...process.env, KB_DATA_DIR: offlineData, KB_SKIP_MIGRATION: '1', AI_CODING_EVENT_BRIDGE_HOME: offlineBridgeHome },
+});
+assert.strictEqual(offline.status, 0, offline.stderr);
+const hooksLogDir = path.join(offlineData, 'logs', 'projects', projectId);
+assert(fs.existsSync(hooksLogDir));
+const lines = fs.readdirSync(hooksLogDir).flatMap(file => fs.readFileSync(path.join(hooksLogDir, file), 'utf8').trim().split(/\r?\n/).filter(Boolean).map(JSON.parse));
+assert(lines.some(line => line.schema === 'log/v2' && line.event === 'hook.notification.degraded'));
+assert(lines.some(line => line.schema === 'log/v2' && line.event === 'hook.boundary.captured'), 'boundary is durably captured even when the server is offline');
+const boundaryLines = fs.readFileSync(path.join(offlineBridgeHome, 'journal', 'events.jsonl'), 'utf8').trim().split(/\r?\n/).map(JSON.parse);
+assert(boundaryLines.some(record =>
+  record.schema === 'git-commit-boundary/v1' &&
+  record.projectId === projectId &&
+  record.repoIdentity && record.repoIdentity.schema === 'repo-identity/v1' &&
+  typeof record.repoIdentity.workspaceId === 'string'), 'boundary carries a canonical v1 workspace identity in the isolated Bridge journal');
+
+console.log('hook-trigger-test PASS');

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');