@sanqianx/project-knowledge 5.0.24 → 5.0.26

package/_site/_test/pending-sweep-test.js

@@ -1,9 +1,9 @@
-const assert = require('assert');
-const automation = require('../lib/post-commit-automation');
-
-// Pending repository scans are not a recovery mechanism. A Hook event is the
-// only authority that can request analysis.
-assert.equal(Object.hasOwn(automation, 'dispatchPendingAutomations'), false);
-assert.equal(Object.hasOwn(automation, 'getQueueSize'), false);
-assert.equal(Object.hasOwn(automation, 'drainQueue'), false);
-console.log('pending-sweep-test PASS');
+const assert = require('assert');
+const automation = require('../lib/post-commit-automation');
+
+// Pending repository scans are not a recovery mechanism. A Hook event is the
+// only authority that can request analysis.
+assert.equal(Object.hasOwn(automation, 'dispatchPendingAutomations'), false);
+assert.equal(Object.hasOwn(automation, 'getQueueSize'), false);
+assert.equal(Object.hasOwn(automation, 'drainQueue'), false);
+console.log('pending-sweep-test PASS');

package/_site/_test/post-commit-automation-test.js

@@ -1,87 +1,87 @@
-// Run: node _site/_test/post-commit-automation-test.js
-
-const assert = require('assert');
-const fs = require('fs');
-const path = require('path');
-const automationConfig = require('../lib/automation-config');
-const automation = require('../lib/post-commit-automation');
-const { REQUIREMENT_UNAVAILABLE, renderCommitPrompt } = require('../lib/commit-prompt');
-
-(() => {
-  const normalized = automationConfig.normalizeAutomationConfig({
-    enabled: true,
-    hookPromptTemplate: 'Legacy instruction for {{commitHash}}.',
-    initPromptTemplate: 'must be ignored',
-    postCommitEnabled: true,
-    allowReadOnlyBash: true,
-  });
-  assert.strictEqual(normalized.commitPromptTemplate, 'Legacy instruction for {{commitHash}}.', 'legacy Hook prompt should be a read-only compatibility override');
-  assert.strictEqual(normalized.legacyPromptOverride, true);
-  assert(!Object.hasOwn(normalized, 'hookPromptTemplate'));
-  assert(!Object.hasOwn(normalized, 'initPromptTemplate'));
-  assert(!Object.hasOwn(normalized, 'postCommitEnabled'));
-  assert(!Object.hasOwn(normalized, 'allowReadOnlyBash'));
-  assert(!Object.hasOwn(automationConfig, 'DEFAULT_INIT_PROMPT_TEMPLATE'), 'init prompt constant must not be exported');
-  assert(!Object.hasOwn(automation, 'dispatchProjectInit'), 'project init dispatch must not be public');
-  assert(!Object.hasOwn(automation, 'dispatchAutomation'), 'generic automation dispatch must not be public');
-
-  const staging = path.resolve('runtime', 'staging', 'run-test');
-  const evidenceRoot = path.resolve('runtime', 'runs', 'run-test', 'input', 'evidence');
-  const policy = automationConfig.buildAutomationToolPolicy({ stagingPath: staging, evidenceRoot });
-  assert.strictEqual(policy.canWriteKb, false, 'AI must never write final knowledge directly');
-  assert.strictEqual(policy.canWriteStaging, true);
-  assert(!policy.allowedTools.includes('Bash'), 'generic Bash must not be available to analysis');
-  assert.strictEqual(automationConfig.evaluateAutomationToolUse(policy, 'Write', { file_path: path.join(staging, 'manifest.json') }).behavior, 'allow');
-  assert.strictEqual(automationConfig.evaluateAutomationToolUse(policy, 'Write', { file_path: path.resolve('source.js') }).behavior, 'deny');
-  assert.strictEqual(automationConfig.evaluateAutomationToolUse(policy, 'Read', { file_path: path.join(evidenceRoot, 'patch-manifest.json') }).behavior, 'allow');
-  assert.strictEqual(automationConfig.evaluateAutomationToolUse(policy, 'Write', { file_path: path.join(evidenceRoot, 'patches', '000001.patch') }).behavior, 'deny');
-  assert.strictEqual(automationConfig.evaluateAutomationToolUse(policy, 'Read', { file_path: path.resolve('repo', 'source.js') }).behavior, 'deny');
-  assert.strictEqual(automationConfig.evaluateAutomationToolUse(policy, 'Bash', { command: 'git show' }).behavior, 'deny');
-
-  const evidence = {
-    commitSha: 'a'.repeat(40),
-    parents: ['b'.repeat(40)],
-    author: 'Test Author',
-    date: '2026-08-17T00:00:00Z',
-    subject: 'feat: exact evidence',
-    branch: 'main',
-    patchMode: 'parent',
-    patchHash: 'sha256:patch',
-    patchBytes: 42,
-    patchOmitted: false,
-    patch: 'diff --git a/a.js b/a.js\n+implemented\n',
-    files: [{ status: 'M', path: 'a.js', oldPath: null, binary: false, added: 1, deleted: 0 }],
-  };
-  const config = {
-    projectId: 'project-test',
-    displayName: 'Prompt Test',
-    repoPath: path.resolve('repo'),
-    knowledgePath: path.resolve('knowledge'),
-    automation: { commitPromptTemplate: automationConfig.DEFAULT_COMMIT_PROMPT_TEMPLATE },
-  };
-  const missing = renderCommitPrompt({ config, evidence, requirements: [], existingKnowledge: { entries: [], omitted: [] } });
-  assert(missing.prompt.includes(REQUIREMENT_UNAVAILABLE), 'unavailable requirement must use the fixed non-guessing text');
-  assert(missing.prompt.includes(evidence.patch), 'prompt must contain the actual patch');
-  assert(missing.prompt.includes('现有相关知识'), 'prompt must contain existing knowledge section');
-  assert(missing.prompt.includes('新增、更新或删除'), 'prompt must ask for add/update/delete decisions');
-  assert(!missing.prompt.includes('git-hook') && !missing.prompt.includes('startup'), 'trigger must not affect prompt content');
-
-  const requirement = { id: 'req-1', client: 'codex', sessionId: 'session-1', ts: '2026-08-17T00:00:00Z', requirement: 'Implement the exact feature.' };
-  const fromHook = renderCommitPrompt({ config, evidence, requirements: [requirement], existingKnowledge: { entries: [] } });
-  const fromStartup = renderCommitPrompt({ config, evidence, requirements: [requirement], existingKnowledge: { entries: [] } });
-  assert.strictEqual(fromHook.promptHash, fromStartup.promptHash, 'Hook and startup must render the identical prompt hash');
-  assert(fromHook.prompt.includes('Implement the exact feature.'), 'recorded user requirement must be present');
-
-  const legacy = renderCommitPrompt({
-    config: { ...config, automation: { hookPromptTemplate: 'Legacy {{commitHash}}' } },
-    evidence,
-    requirements: [],
-    existingKnowledge: { entries: [] },
-  });
-  assert(legacy.prompt.includes('Legacy ' + evidence.commitSha), 'legacy Hook prompt override should still render');
-  assert(legacy.prompt.includes(REQUIREMENT_UNAVAILABLE) && legacy.prompt.includes(evidence.patch), 'mandatory evidence sections must be appended to incomplete legacy templates');
-
-  const source = fs.readFileSync(path.join(__dirname, '..', 'lib', 'post-commit-automation.js'), 'utf8');
-  assert(!/dispatchProjectInit|renderProjectInitPrompt|project-init|startup-recovery/.test(source), 'automation source must not retain init or a third trigger name');
-  console.log('post-commit-automation-test PASS');
-})();
+// Run: node _site/_test/post-commit-automation-test.js
+
+const assert = require('assert');
+const fs = require('fs');
+const path = require('path');
+const automationConfig = require('../lib/automation-config');
+const automation = require('../lib/post-commit-automation');
+const { REQUIREMENT_UNAVAILABLE, renderCommitPrompt } = require('../lib/commit-prompt');
+
+(() => {
+  const normalized = automationConfig.normalizeAutomationConfig({
+    enabled: true,
+    hookPromptTemplate: 'Legacy instruction for {{commitHash}}.',
+    initPromptTemplate: 'must be ignored',
+    postCommitEnabled: true,
+    allowReadOnlyBash: true,
+  });
+  assert.strictEqual(normalized.commitPromptTemplate, 'Legacy instruction for {{commitHash}}.', 'legacy Hook prompt should be a read-only compatibility override');
+  assert.strictEqual(normalized.legacyPromptOverride, true);
+  assert(!Object.hasOwn(normalized, 'hookPromptTemplate'));
+  assert(!Object.hasOwn(normalized, 'initPromptTemplate'));
+  assert(!Object.hasOwn(normalized, 'postCommitEnabled'));
+  assert(!Object.hasOwn(normalized, 'allowReadOnlyBash'));
+  assert(!Object.hasOwn(automationConfig, 'DEFAULT_INIT_PROMPT_TEMPLATE'), 'init prompt constant must not be exported');
+  assert(!Object.hasOwn(automation, 'dispatchProjectInit'), 'project init dispatch must not be public');
+  assert(!Object.hasOwn(automation, 'dispatchAutomation'), 'generic automation dispatch must not be public');
+
+  const staging = path.resolve('runtime', 'staging', 'run-test');
+  const evidenceRoot = path.resolve('runtime', 'runs', 'run-test', 'input', 'evidence');
+  const policy = automationConfig.buildAutomationToolPolicy({ stagingPath: staging, evidenceRoot });
+  assert.strictEqual(policy.canWriteKb, false, 'AI must never write final knowledge directly');
+  assert.strictEqual(policy.canWriteStaging, true);
+  assert(!policy.allowedTools.includes('Bash'), 'generic Bash must not be available to analysis');
+  assert.strictEqual(automationConfig.evaluateAutomationToolUse(policy, 'Write', { file_path: path.join(staging, 'manifest.json') }).behavior, 'allow');
+  assert.strictEqual(automationConfig.evaluateAutomationToolUse(policy, 'Write', { file_path: path.resolve('source.js') }).behavior, 'deny');
+  assert.strictEqual(automationConfig.evaluateAutomationToolUse(policy, 'Read', { file_path: path.join(evidenceRoot, 'patch-manifest.json') }).behavior, 'allow');
+  assert.strictEqual(automationConfig.evaluateAutomationToolUse(policy, 'Write', { file_path: path.join(evidenceRoot, 'patches', '000001.patch') }).behavior, 'deny');
+  assert.strictEqual(automationConfig.evaluateAutomationToolUse(policy, 'Read', { file_path: path.resolve('repo', 'source.js') }).behavior, 'deny');
+  assert.strictEqual(automationConfig.evaluateAutomationToolUse(policy, 'Bash', { command: 'git show' }).behavior, 'deny');
+
+  const evidence = {
+    commitSha: 'a'.repeat(40),
+    parents: ['b'.repeat(40)],
+    author: 'Test Author',
+    date: '2026-08-17T00:00:00Z',
+    subject: 'feat: exact evidence',
+    branch: 'main',
+    patchMode: 'parent',
+    patchHash: 'sha256:patch',
+    patchBytes: 42,
+    patchOmitted: false,
+    patch: 'diff --git a/a.js b/a.js\n+implemented\n',
+    files: [{ status: 'M', path: 'a.js', oldPath: null, binary: false, added: 1, deleted: 0 }],
+  };
+  const config = {
+    projectId: 'project-test',
+    displayName: 'Prompt Test',
+    repoPath: path.resolve('repo'),
+    knowledgePath: path.resolve('knowledge'),
+    automation: { commitPromptTemplate: automationConfig.DEFAULT_COMMIT_PROMPT_TEMPLATE },
+  };
+  const missing = renderCommitPrompt({ config, evidence, requirements: [], existingKnowledge: { entries: [], omitted: [] } });
+  assert(missing.prompt.includes(REQUIREMENT_UNAVAILABLE), 'unavailable requirement must use the fixed non-guessing text');
+  assert(missing.prompt.includes(evidence.patch), 'prompt must contain the actual patch');
+  assert(missing.prompt.includes('现有相关知识'), 'prompt must contain existing knowledge section');
+  assert(missing.prompt.includes('新增、更新或删除'), 'prompt must ask for add/update/delete decisions');
+  assert(!missing.prompt.includes('git-hook') && !missing.prompt.includes('startup'), 'trigger must not affect prompt content');
+
+  const requirement = { id: 'req-1', client: 'codex', sessionId: 'session-1', ts: '2026-08-17T00:00:00Z', requirement: 'Implement the exact feature.' };
+  const fromHook = renderCommitPrompt({ config, evidence, requirements: [requirement], existingKnowledge: { entries: [] } });
+  const fromStartup = renderCommitPrompt({ config, evidence, requirements: [requirement], existingKnowledge: { entries: [] } });
+  assert.strictEqual(fromHook.promptHash, fromStartup.promptHash, 'Hook and startup must render the identical prompt hash');
+  assert(fromHook.prompt.includes('Implement the exact feature.'), 'recorded user requirement must be present');
+
+  const legacy = renderCommitPrompt({
+    config: { ...config, automation: { hookPromptTemplate: 'Legacy {{commitHash}}' } },
+    evidence,
+    requirements: [],
+    existingKnowledge: { entries: [] },
+  });
+  assert(legacy.prompt.includes('Legacy ' + evidence.commitSha), 'legacy Hook prompt override should still render');
+  assert(legacy.prompt.includes(REQUIREMENT_UNAVAILABLE) && legacy.prompt.includes(evidence.patch), 'mandatory evidence sections must be appended to incomplete legacy templates');
+
+  const source = fs.readFileSync(path.join(__dirname, '..', 'lib', 'post-commit-automation.js'), 'utf8');
+  assert(!/dispatchProjectInit|renderProjectInitPrompt|project-init|startup-recovery/.test(source), 'automation source must not retain init or a third trigger name');
+  console.log('post-commit-automation-test PASS');
+})();

package/_site/_test/pr-consumer-contract-test.js

@@ -1,55 +1,55 @@
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('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 { KnowledgeToolRuntime } = require('../lib/knowledge-tool-runtime');
-const { validateKb, buildPrContextPack } = require('../lib/kb-validator');
-const { regenerateIndexes } = require('../lib/index-builder');
-
-const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'pkb-pr-v2-'));
-const knowledgePath = path.join(temp, 'knowledge');
-
-function writeKnowledge() {
-  fs.mkdirSync(path.join(knowledgePath, 'modules'), { recursive: true });
-  fs.mkdirSync(path.join(knowledgePath, 'changes'), { recursive: true });
-  fs.writeFileSync(path.join(knowledgePath, 'README.md'), '# Test KB\n');
-  fs.writeFileSync(path.join(knowledgePath, 'GOAL.md'), '# Goal\n');
-  fs.writeFileSync(path.join(knowledgePath, 'ARCHITECTURE.md'), '# Architecture\n');
-  fs.writeFileSync(path.join(knowledgePath, 'modules', 'api.md'), '---\ntags: [api]\nsourcePaths: [src/api.js]\n---\n# API\n');
-  fs.writeFileSync(path.join(knowledgePath, 'changes', 'api-change.md'), '---\ntags: [api]\naffectedModules: [api]\ndevelopmentIntent: Add API memory.\n---\n# API change\n\n## Development Intent\nAdd API memory.\n\n## Implementation Result\nDone.\n\n## Evidence\n- src/api.js\n');
-  regenerateIndexes(knowledgePath);
-}
-
-(async () => {
-  try {
-    writeKnowledge();
-    const validation = validateKb(knowledgePath);
-    assert(validation.ok, JSON.stringify(validation.errors));
-    const pack = buildPrContextPack(knowledgePath);
-    assert(pack.ok);
-    assert.strictEqual(pack.pack.schema, 'pr-context-pack/v1');
-    assert(pack.pack.trustedKnowledge.some(item => item.path === 'modules/api.md'));
-    assert(!JSON.stringify(pack.pack).includes('_ai/'));
-
-    const layout = new StorageLayout({ dataDir: path.join(temp, 'data') });
-    const settingsStore = new SettingsStore({ layout });
-    const registryStore = new ProjectRegistryStore({ layout });
-    const projectStore = new ProjectStore({ layout });
-    await settingsStore.initialize({ knowledge: { rootPath: path.join(temp, 'future') } });
-    await registryStore.initialize();
-    await projectStore.create('project-consumer', { displayName: 'Consumer', storageName: 'consumer', repoPath: temp, knowledgePath }, { index: { dirty: true, generation: 1 } });
-    await registryStore.add('project-consumer', { displayNameSnapshot: 'Consumer' });
-    const runtime = new KnowledgeToolRuntime({ layout, settingsStore, registryStore, projectStore, cwd: temp });
-    const entry = await runtime.get({ projectId: 'project-consumer', entry: 'modules/api.md' });
-    assert.match(entry.chunks[0].chunk_text, /# API/);
-    await assert.rejects(runtime.get({ projectId: 'project-consumer', entry: '../settings.json' }), error => error.code === 'PATH_OUTSIDE_ROOT');
-    await runtime.close();
-    console.log('pr-consumer-contract-test PASS');
-  } finally {
-    fs.rmSync(temp, { recursive: true, force: true });
-  }
-})().catch(error => { console.error(error); process.exitCode = 1; });
+const assert = require('assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('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 { KnowledgeToolRuntime } = require('../lib/knowledge-tool-runtime');
+const { validateKb, buildPrContextPack } = require('../lib/kb-validator');
+const { regenerateIndexes } = require('../lib/index-builder');
+
+const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'pkb-pr-v2-'));
+const knowledgePath = path.join(temp, 'knowledge');
+
+function writeKnowledge() {
+  fs.mkdirSync(path.join(knowledgePath, 'modules'), { recursive: true });
+  fs.mkdirSync(path.join(knowledgePath, 'changes'), { recursive: true });
+  fs.writeFileSync(path.join(knowledgePath, 'README.md'), '# Test KB\n');
+  fs.writeFileSync(path.join(knowledgePath, 'GOAL.md'), '# Goal\n');
+  fs.writeFileSync(path.join(knowledgePath, 'ARCHITECTURE.md'), '# Architecture\n');
+  fs.writeFileSync(path.join(knowledgePath, 'modules', 'api.md'), '---\ntags: [api]\nsourcePaths: [src/api.js]\n---\n# API\n');
+  fs.writeFileSync(path.join(knowledgePath, 'changes', 'api-change.md'), '---\ntags: [api]\naffectedModules: [api]\ndevelopmentIntent: Add API memory.\n---\n# API change\n\n## Development Intent\nAdd API memory.\n\n## Implementation Result\nDone.\n\n## Evidence\n- src/api.js\n');
+  regenerateIndexes(knowledgePath);
+}
+
+(async () => {
+  try {
+    writeKnowledge();
+    const validation = validateKb(knowledgePath);
+    assert(validation.ok, JSON.stringify(validation.errors));
+    const pack = buildPrContextPack(knowledgePath);
+    assert(pack.ok);
+    assert.strictEqual(pack.pack.schema, 'pr-context-pack/v1');
+    assert(pack.pack.trustedKnowledge.some(item => item.path === 'modules/api.md'));
+    assert(!JSON.stringify(pack.pack).includes('_ai/'));
+
+    const layout = new StorageLayout({ dataDir: path.join(temp, 'data') });
+    const settingsStore = new SettingsStore({ layout });
+    const registryStore = new ProjectRegistryStore({ layout });
+    const projectStore = new ProjectStore({ layout });
+    await settingsStore.initialize({ knowledge: { rootPath: path.join(temp, 'future') } });
+    await registryStore.initialize();
+    await projectStore.create('project-consumer', { displayName: 'Consumer', storageName: 'consumer', repoPath: temp, knowledgePath }, { index: { dirty: true, generation: 1 } });
+    await registryStore.add('project-consumer', { displayNameSnapshot: 'Consumer' });
+    const runtime = new KnowledgeToolRuntime({ layout, settingsStore, registryStore, projectStore, cwd: temp });
+    const entry = await runtime.get({ projectId: 'project-consumer', entry: 'modules/api.md' });
+    assert.match(entry.chunks[0].chunk_text, /# API/);
+    await assert.rejects(runtime.get({ projectId: 'project-consumer', entry: '../settings.json' }), error => error.code === 'PATH_OUTSIDE_ROOT');
+    await runtime.close();
+    console.log('pr-consumer-contract-test PASS');
+  } finally {
+    fs.rmSync(temp, { recursive: true, force: true });
+  }
+})().catch(error => { console.error(error); process.exitCode = 1; });

package/_site/_test/product-brand-contract-test.js

@@ -1,25 +1,25 @@
-'use strict';
-
-const assert = require('node:assert/strict');
-const fs = require('node:fs');
-const path = require('node:path');
-
-const ui = path.resolve(__dirname, '../../ui');
-const html = fs.readFileSync(path.join(ui, 'index.html'), 'utf8');
-const css = fs.readFileSync(path.join(ui, 'product.css'), 'utf8');
-const mark = fs.readFileSync(path.join(ui, 'favicon.svg'), 'utf8');
-const favicon = html.match(/<link\b(?=[^>]*\brel="icon")[^>]*\bhref="([^"]+)"/);
-const sidebar = html.match(/<img\b(?=[^>]*\bclass="brand-mark")[^>]*\bsrc="([^"]+)"/);
-
-assert(favicon, 'Product needs an SVG favicon.');
-assert(sidebar, 'Sidebar must use the product mark, not a second drawn icon.');
-assert.equal(sidebar[1], favicon[1], 'Favicon and sidebar must share the exact asset URL.');
-assert.equal(favicon[1].split('?')[0], '/favicon.svg');
-assert.match(favicon[1], /\?v=/, 'Brand changes need a new browser cache identity.');
-assert.match(mark, /viewBox="0 0 64 64"/);
-assert.match(mark, /fill="#516f89"/);
-assert.equal((mark.match(/<path\b/g) || []).length, 1, 'Keep one geometric silhouette.');
-assert.doesNotMatch(mark, /<(?:script|image|text|filter|linearGradient|radialGradient)\b/i);
-assert.doesNotMatch(html, /<span class="brand-mark">知<\/span>/);
-assert.match(css, /\.brand-mark\{[^}]*width:32px;[^}]*height:32px;[^}]*flex:none/);
-console.log('PASS product brand: shared SVG, cache identity, fixed-size layout, no decorative dependencies');
+'use strict';
+
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+
+const ui = path.resolve(__dirname, '../../ui');
+const html = fs.readFileSync(path.join(ui, 'index.html'), 'utf8');
+const css = fs.readFileSync(path.join(ui, 'product.css'), 'utf8');
+const mark = fs.readFileSync(path.join(ui, 'favicon.svg'), 'utf8');
+const favicon = html.match(/<link\b(?=[^>]*\brel="icon")[^>]*\bhref="([^"]+)"/);
+const sidebar = html.match(/<img\b(?=[^>]*\bclass="brand-mark")[^>]*\bsrc="([^"]+)"/);
+
+assert(favicon, 'Product needs an SVG favicon.');
+assert(sidebar, 'Sidebar must use the product mark, not a second drawn icon.');
+assert.equal(sidebar[1], favicon[1], 'Favicon and sidebar must share the exact asset URL.');
+assert.equal(favicon[1].split('?')[0], '/favicon.svg');
+assert.match(favicon[1], /\?v=/, 'Brand changes need a new browser cache identity.');
+assert.match(mark, /viewBox="0 0 64 64"/);
+assert.match(mark, /fill="#516f89"/);
+assert.equal((mark.match(/<path\b/g) || []).length, 1, 'Keep one geometric silhouette.');
+assert.doesNotMatch(mark, /<(?:script|image|text|filter|linearGradient|radialGradient)\b/i);
+assert.doesNotMatch(html, /<span class="brand-mark">知<\/span>/);
+assert.match(css, /\.brand-mark\{[^}]*width:32px;[^}]*height:32px;[^}]*flex:none/);
+console.log('PASS product brand: shared SVG, cache identity, fixed-size layout, no decorative dependencies');

package/_site/_test/product-diagnostics-ui-test.js

@@ -1,93 +1,93 @@
-'use strict';
-const assert = require('node:assert/strict');
-const fs = require('node:fs');
-const os = require('node:os');
-const path = require('node:path');
-const http = require('node:http');
-const { spawnServer } = require('./helpers/spawn-server');
-const { findChrome } = require('./helpers/find-chrome');
-const { launchCdpBrowser, waitFor } = require('./helpers/cdp-browser');
-const { createLoggingUiFixture } = require('./helpers/logging-ui-fixture');
-const { Logger } = require('../lib/structured-logger');
-const { StorageLayout } = require('../lib/storage-layout');
-const ROOT = path.resolve(__dirname, '../..');
-
-async function main() {
-  const fixture = await createLoggingUiFixture({ totalLogs: 240, freshProduct: true });
-  const logger = new Logger({ layout: new StorageLayout({ dataDir: fixture.dataDir }) });
-  await logger.error('project.import.failed', 'Import failed for an unregistered project', {
-    projectId: 'project-import-not-registered', operationId: 'op-import-diagnostic',
-    error: Object.assign(new Error('Git Hook path resolution failed'), { code: 'ENOENT' })
-  });
-  const offline = http.createServer((req, res) => { res.writeHead(503, { 'content-type': 'application/json' }); res.end(JSON.stringify({ ok: false, error: { message: '验收中的离线模块' } })); });
-  await new Promise(resolve => offline.listen(0, '127.0.0.1', resolve));
-  const offlineUrl = `http://127.0.0.1:${offline.address().port}`;
-  const port = 8050 + process.pid % 200;
-  const base = `http://127.0.0.1:${port}`;
-  const server = spawnServer({ root: ROOT, port, dataDir: fixture.dataDir, tag: 'product-diagnostics-ui', analysisOwner: 'engine', extraEnv: {
-    KB_TERMINAL_URL: offlineUrl, KB_VECTORHUB_URL: offlineUrl, KB_EVENTBRIDGE_URL: offlineUrl, KB_KNOWLEDGE_ENGINE_URL: offlineUrl,
-  } });
-  let browser;
-  try {
-    await waitFor(async () => { try { return (await fetch(base + '/api/health')).ok; } catch { return false; } }, 'web shell', 20000);
-    browser = await launchCdpBrowser({ chrome: findChrome(), profileDir: path.join(fixture.dataDir, 'browser'), url: base, width: 1920, height: 1080 });
-    await browser.setViewport(1920, 1080);
-    const run = expression => browser.evaluate(expression);
-    const click = selector => run(`document.querySelector(${JSON.stringify(selector)}).click()`);
-    await waitFor(() => run(`document.getElementById('projectSelect').value === ${JSON.stringify(fixture.projectId)}`), 'registry projection');
-    for (const view of ['home', 'memory', 'projects', 'activity']) {
-      await click(`[data-view="${view}"]`); assert.equal(await run('document.documentElement.scrollWidth > innerWidth'), false, view);
-    }
-    assert.ok(await run("document.getElementById('projectDetail').textContent.includes('视觉检测知识库')"));
-    assert.ok(await run("document.getElementById('activityUpdates').textContent.includes('离线')"), 'offline cannot masquerade as empty/success');
-    await click('#openSystem'); await click('#openLogs');
-    await waitFor(() => run("document.querySelectorAll('#logsContent .log-entry').length === 100"), 'bounded diagnostic rendering');
-    assert.equal(await run("document.getElementById('logsScope').value"), 'all');
-    await run("document.getElementById('logsSearch').value='op-import-diagnostic'"); await click('#loadLogs');
-    await waitFor(() => run("document.getElementById('logsContent').textContent.includes('ENOENT')"), 'unregistered import visible despite active project');
-    await run("document.getElementById('logsScope').value='project'; document.getElementById('logsScope').dispatchEvent(new Event('change'))");
-    await waitFor(() => run("document.querySelectorAll('#logsContent .log-entry').length === 0"), 'current project excludes failed new import');
-    await run("document.getElementById('logsScope').value='all'; document.getElementById('logsScope').dispatchEvent(new Event('change'))");
-    await waitFor(() => run("document.getElementById('logsContent').textContent.includes('op-import-diagnostic')"), 'global diagnostic scope restored');
-    assert.equal(await run("document.querySelectorAll('#logsDialog img, #logsDialog script').length"), 0);
-    await run("document.getElementById('logsSearch').value='<img src=x onerror=window.__xss=1>'"); await click('#loadLogs');
-    await waitFor(() => run("document.querySelectorAll('#logsContent .log-entry').length === 1"), 'real server query filter');
-    assert.equal(await run('window.__xss'), undefined);
-    await run("document.getElementById('logsSearch').value='模型输出校验失败'"); await click('#loadLogs');
-    await waitFor(() => run("document.querySelectorAll('#logsContent .log-entry').length === 1 && document.getElementById('logsContent').textContent.includes('VALIDATION_FAILED')"), 'retained error detail');
-    await click('#logsContent summary');
-    assert.equal(await run("document.querySelector('#logsContent details').open"), true);
-    assert.ok(await run("document.querySelector('#logsContent .log-detail').textContent.includes('promotionStep')"), 'failure stack remains diagnosable');
-    assert.equal(await run('window.__xss'), undefined);
-    await browser.send('Page.setDownloadBehavior', { behavior: 'allow', downloadPath: fixture.dataDir });
-    await click('#exportLogs');
-    const exportFile = path.join(fixture.dataDir, 'knowledge-diagnostics.jsonl');
-    await waitFor(() => fs.existsSync(exportFile), 'UI diagnostic export');
-    const entries = fs.readFileSync(exportFile, 'utf8').trim().split(/\r?\n/).map(line => JSON.parse(line));
-    assert.equal(entries.length, 1); assert.equal(entries[0].projectId, fixture.projectId);
-    await click('[data-close="logsDialog"]'); await click('#themeToggle');
-    await browser.send('Page.navigate', { url: base + '/#projects' });
-    await waitFor(() => run("document.getElementById('projectDetail').textContent.includes('视觉检测知识库')"), 'reload');
-    assert.equal(await run('document.documentElement.dataset.theme'), 'dark');
-    const codeFiles = fs.readdirSync(fixture.repo.path);
-    // The registry does not own knowledge bytes. Use its actual double-directory binding.
-    const project = (await (await fetch(base + '/api/projects/aggregated')).json()).projects[0];
-    const retained = path.join(project.knowledgePath, 'keep.md'); fs.writeFileSync(retained, '# 保留知识\n');
-    await click('[data-action="unbind"]'); await click('#confirmUnbind');
-    await waitFor(() => run("document.getElementById('unbindFeedback').textContent.includes('无法安全停止写入')"), 'offline writer prevents unsafe unbind');
-    assert.equal((await (await fetch(base + '/api/projects/aggregated')).json()).projects.length, 1);
-    assert.deepEqual(fs.readdirSync(fixture.repo.path), codeFiles); assert.ok(fs.existsSync(retained));
-    assert.equal(browser.exceptions.length, 0, JSON.stringify(browser.exceptions));
-    console.log('product-diagnostics-ui-test PASS (1920x1080; XSS/filter/expanded failure/export/theme/offline writer protection)');
-  } catch (error) {
-    if (browser) console.error(await browser.evaluate("JSON.stringify({ toast:document.getElementById('toast').textContent, project:document.getElementById('projectSelect').value, detail:document.getElementById('projectDetail').textContent })"));
-    throw error;
-  } finally {
-    try { await browser?.close(); }
-    finally {
-      try { await server.cleanup(); }
-      finally { offline.closeAllConnections(); await new Promise(resolve => offline.close(resolve)); fixture.cleanup(); }
-    }
-  }
-}
-main().catch(error => { console.error(error.stack || error.message); 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 http = require('node:http');
+const { spawnServer } = require('./helpers/spawn-server');
+const { findChrome } = require('./helpers/find-chrome');
+const { launchCdpBrowser, waitFor } = require('./helpers/cdp-browser');
+const { createLoggingUiFixture } = require('./helpers/logging-ui-fixture');
+const { Logger } = require('../lib/structured-logger');
+const { StorageLayout } = require('../lib/storage-layout');
+const ROOT = path.resolve(__dirname, '../..');
+
+async function main() {
+  const fixture = await createLoggingUiFixture({ totalLogs: 240, freshProduct: true });
+  const logger = new Logger({ layout: new StorageLayout({ dataDir: fixture.dataDir }) });
+  await logger.error('project.import.failed', 'Import failed for an unregistered project', {
+    projectId: 'project-import-not-registered', operationId: 'op-import-diagnostic',
+    error: Object.assign(new Error('Git Hook path resolution failed'), { code: 'ENOENT' })
+  });
+  const offline = http.createServer((req, res) => { res.writeHead(503, { 'content-type': 'application/json' }); res.end(JSON.stringify({ ok: false, error: { message: '验收中的离线模块' } })); });
+  await new Promise(resolve => offline.listen(0, '127.0.0.1', resolve));
+  const offlineUrl = `http://127.0.0.1:${offline.address().port}`;
+  const port = 8050 + process.pid % 200;
+  const base = `http://127.0.0.1:${port}`;
+  const server = spawnServer({ root: ROOT, port, dataDir: fixture.dataDir, tag: 'product-diagnostics-ui', analysisOwner: 'engine', extraEnv: {
+    KB_TERMINAL_URL: offlineUrl, KB_VECTORHUB_URL: offlineUrl, KB_EVENTBRIDGE_URL: offlineUrl, KB_KNOWLEDGE_ENGINE_URL: offlineUrl,
+  } });
+  let browser;
+  try {
+    await waitFor(async () => { try { return (await fetch(base + '/api/health')).ok; } catch { return false; } }, 'web shell', 20000);
+    browser = await launchCdpBrowser({ chrome: findChrome(), profileDir: path.join(fixture.dataDir, 'browser'), url: base, width: 1920, height: 1080 });
+    await browser.setViewport(1920, 1080);
+    const run = expression => browser.evaluate(expression);
+    const click = selector => run(`document.querySelector(${JSON.stringify(selector)}).click()`);
+    await waitFor(() => run(`document.getElementById('projectSelect').value === ${JSON.stringify(fixture.projectId)}`), 'registry projection');
+    for (const view of ['home', 'memory', 'projects', 'activity']) {
+      await click(`[data-view="${view}"]`); assert.equal(await run('document.documentElement.scrollWidth > innerWidth'), false, view);
+    }
+    assert.ok(await run("document.getElementById('projectDetail').textContent.includes('视觉检测知识库')"));
+    assert.ok(await run("document.getElementById('activityUpdates').textContent.includes('离线')"), 'offline cannot masquerade as empty/success');
+    await click('#openSystem'); await click('#openLogs');
+    await waitFor(() => run("document.querySelectorAll('#logsContent .log-entry').length === 100"), 'bounded diagnostic rendering');
+    assert.equal(await run("document.getElementById('logsScope').value"), 'all');
+    await run("document.getElementById('logsSearch').value='op-import-diagnostic'"); await click('#loadLogs');
+    await waitFor(() => run("document.getElementById('logsContent').textContent.includes('ENOENT')"), 'unregistered import visible despite active project');
+    await run("document.getElementById('logsScope').value='project'; document.getElementById('logsScope').dispatchEvent(new Event('change'))");
+    await waitFor(() => run("document.querySelectorAll('#logsContent .log-entry').length === 0"), 'current project excludes failed new import');
+    await run("document.getElementById('logsScope').value='all'; document.getElementById('logsScope').dispatchEvent(new Event('change'))");
+    await waitFor(() => run("document.getElementById('logsContent').textContent.includes('op-import-diagnostic')"), 'global diagnostic scope restored');
+    assert.equal(await run("document.querySelectorAll('#logsDialog img, #logsDialog script').length"), 0);
+    await run("document.getElementById('logsSearch').value='<img src=x onerror=window.__xss=1>'"); await click('#loadLogs');
+    await waitFor(() => run("document.querySelectorAll('#logsContent .log-entry').length === 1"), 'real server query filter');
+    assert.equal(await run('window.__xss'), undefined);
+    await run("document.getElementById('logsSearch').value='模型输出校验失败'"); await click('#loadLogs');
+    await waitFor(() => run("document.querySelectorAll('#logsContent .log-entry').length === 1 && document.getElementById('logsContent').textContent.includes('VALIDATION_FAILED')"), 'retained error detail');
+    await click('#logsContent summary');
+    assert.equal(await run("document.querySelector('#logsContent details').open"), true);
+    assert.ok(await run("document.querySelector('#logsContent .log-detail').textContent.includes('promotionStep')"), 'failure stack remains diagnosable');
+    assert.equal(await run('window.__xss'), undefined);
+    await browser.send('Page.setDownloadBehavior', { behavior: 'allow', downloadPath: fixture.dataDir });
+    await click('#exportLogs');
+    const exportFile = path.join(fixture.dataDir, 'knowledge-diagnostics.jsonl');
+    await waitFor(() => fs.existsSync(exportFile), 'UI diagnostic export');
+    const entries = fs.readFileSync(exportFile, 'utf8').trim().split(/\r?\n/).map(line => JSON.parse(line));
+    assert.equal(entries.length, 1); assert.equal(entries[0].projectId, fixture.projectId);
+    await click('[data-close="logsDialog"]'); await click('#themeToggle');
+    await browser.send('Page.navigate', { url: base + '/#projects' });
+    await waitFor(() => run("document.getElementById('projectDetail').textContent.includes('视觉检测知识库')"), 'reload');
+    assert.equal(await run('document.documentElement.dataset.theme'), 'dark');
+    const codeFiles = fs.readdirSync(fixture.repo.path);
+    // The registry does not own knowledge bytes. Use its actual double-directory binding.
+    const project = (await (await fetch(base + '/api/projects/aggregated')).json()).projects[0];
+    const retained = path.join(project.knowledgePath, 'keep.md'); fs.writeFileSync(retained, '# 保留知识\n');
+    await click('[data-action="unbind"]'); await click('#confirmUnbind');
+    await waitFor(() => run("document.getElementById('unbindFeedback').textContent.includes('无法安全停止写入')"), 'offline writer prevents unsafe unbind');
+    assert.equal((await (await fetch(base + '/api/projects/aggregated')).json()).projects.length, 1);
+    assert.deepEqual(fs.readdirSync(fixture.repo.path), codeFiles); assert.ok(fs.existsSync(retained));
+    assert.equal(browser.exceptions.length, 0, JSON.stringify(browser.exceptions));
+    console.log('product-diagnostics-ui-test PASS (1920x1080; XSS/filter/expanded failure/export/theme/offline writer protection)');
+  } catch (error) {
+    if (browser) console.error(await browser.evaluate("JSON.stringify({ toast:document.getElementById('toast').textContent, project:document.getElementById('projectSelect').value, detail:document.getElementById('projectDetail').textContent })"));
+    throw error;
+  } finally {
+    try { await browser?.close(); }
+    finally {
+      try { await server.cleanup(); }
+      finally { offline.closeAllConnections(); await new Promise(resolve => offline.close(resolve)); fixture.cleanup(); }
+    }
+  }
+}
+main().catch(error => { console.error(error.stack || error.message); process.exitCode = 1; });