@sanqianx/project-knowledge 5.0.24 → 5.0.26

package/_site/_test/knowledge-query-test.js

@@ -1,54 +1,54 @@
-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');
-
-(async () => {
-  const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'knowledge-query-v2-'));
-  const layout = new StorageLayout({ dataDir: path.join(temp, 'data') });
-  const settings = new SettingsStore({ layout });
-  const registry = new ProjectRegistryStore({ layout });
-  const projects = new ProjectStore({ layout });
-  await settings.initialize({ knowledge: { rootPath: path.join(temp, 'knowledge') } });
-  await registry.initialize();
-  const fixtures = [
-    ['project-api', 'API', 'API refresh tokens rotate after authentication.'],
-    ['project-web', 'Web', 'Web login keeps a short-lived browser session.'],
-    ['project-secret', 'Secret', 'This unrelated project must stay out of scope.'],
-  ];
-  for (const [projectId, title, content] of fixtures) {
-    const knowledgePath = path.join(temp, 'knowledge', projectId);
-    fs.mkdirSync(path.join(knowledgePath, 'changes'), { recursive: true });
-    fs.writeFileSync(path.join(knowledgePath, 'changes', 'decision.md'), `# ${title}\n\n${content}\n`, 'utf8');
-    await projects.create(projectId, {
-      displayName: title, storageName: projectId, repoPath: temp, knowledgePath,
-      relatedProjectIds: projectId === 'project-api' ? ['project-web'] : [],
-    }, { index: { dirty: true, generation: 1 } });
-    await registry.add(projectId, { displayNameSnapshot: title });
-  }
-  const runtime = new KnowledgeToolRuntime({ layout, settingsStore: settings, registryStore: registry, projectStore: projects });
-  try {
-    const search = await runtime.search({ projectId: 'project-api', query: 'login session tokens', limit: 10 });
-    assert.strictEqual(search.source, 'knowledge-retrieval-service');
-    assert.strictEqual(search.backend, 'markdown-hybrid-fallback');
-    assert(search.results.some(row => row.scope_project_id === 'project-api'));
-    assert(search.results.some(row => row.scope_project_id === 'project-web'));
-    assert(search.results.every(row => row.scope_project_id !== 'project-secret'));
-    const asked = await runtime.ask({ projectId: 'project-api', query: 'refresh tokens', limit: 5 });
-    assert(asked.citations.length > 0 && /refresh tokens/i.test(asked.answer));
-    const entry = await runtime.get({ projectId: 'project-api', entryId: 'changes/decision.md' });
-    assert.match(entry.chunks[0].chunk_text, /rotate after authentication/);
-    await assert.rejects(runtime.get({ projectId: 'project-api', entryId: '../project-secret/changes/decision.md' }), error => error.code === 'PATH_OUTSIDE_ROOT');
-    const history = await runtime.history({ projectId: 'project-api' });
-    assert.strictEqual(history.results[0].entry_id, 'changes/decision.md');
-    assert.strictEqual(fs.existsSync(path.join(layout.getDataDir(), 'knowledge-scopes.json')), false, 'read queries must not create a second scope registry');
-    console.log('knowledge-query-test: PASS');
-  } finally {
-    await runtime.close();
-  }
-})().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');
+
+(async () => {
+  const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'knowledge-query-v2-'));
+  const layout = new StorageLayout({ dataDir: path.join(temp, 'data') });
+  const settings = new SettingsStore({ layout });
+  const registry = new ProjectRegistryStore({ layout });
+  const projects = new ProjectStore({ layout });
+  await settings.initialize({ knowledge: { rootPath: path.join(temp, 'knowledge') } });
+  await registry.initialize();
+  const fixtures = [
+    ['project-api', 'API', 'API refresh tokens rotate after authentication.'],
+    ['project-web', 'Web', 'Web login keeps a short-lived browser session.'],
+    ['project-secret', 'Secret', 'This unrelated project must stay out of scope.'],
+  ];
+  for (const [projectId, title, content] of fixtures) {
+    const knowledgePath = path.join(temp, 'knowledge', projectId);
+    fs.mkdirSync(path.join(knowledgePath, 'changes'), { recursive: true });
+    fs.writeFileSync(path.join(knowledgePath, 'changes', 'decision.md'), `# ${title}\n\n${content}\n`, 'utf8');
+    await projects.create(projectId, {
+      displayName: title, storageName: projectId, repoPath: temp, knowledgePath,
+      relatedProjectIds: projectId === 'project-api' ? ['project-web'] : [],
+    }, { index: { dirty: true, generation: 1 } });
+    await registry.add(projectId, { displayNameSnapshot: title });
+  }
+  const runtime = new KnowledgeToolRuntime({ layout, settingsStore: settings, registryStore: registry, projectStore: projects });
+  try {
+    const search = await runtime.search({ projectId: 'project-api', query: 'login session tokens', limit: 10 });
+    assert.strictEqual(search.source, 'knowledge-retrieval-service');
+    assert.strictEqual(search.backend, 'markdown-hybrid-fallback');
+    assert(search.results.some(row => row.scope_project_id === 'project-api'));
+    assert(search.results.some(row => row.scope_project_id === 'project-web'));
+    assert(search.results.every(row => row.scope_project_id !== 'project-secret'));
+    const asked = await runtime.ask({ projectId: 'project-api', query: 'refresh tokens', limit: 5 });
+    assert(asked.citations.length > 0 && /refresh tokens/i.test(asked.answer));
+    const entry = await runtime.get({ projectId: 'project-api', entryId: 'changes/decision.md' });
+    assert.match(entry.chunks[0].chunk_text, /rotate after authentication/);
+    await assert.rejects(runtime.get({ projectId: 'project-api', entryId: '../project-secret/changes/decision.md' }), error => error.code === 'PATH_OUTSIDE_ROOT');
+    const history = await runtime.history({ projectId: 'project-api' });
+    assert.strictEqual(history.results[0].entry_id, 'changes/decision.md');
+    assert.strictEqual(fs.existsSync(path.join(layout.getDataDir(), 'knowledge-scopes.json')), false, 'read queries must not create a second scope registry');
+    console.log('knowledge-query-test: PASS');
+  } finally {
+    await runtime.close();
+  }
+})().catch(error => { console.error(error); process.exitCode = 1; });

package/_site/_test/knowledge-retrieval-service-test.js

@@ -1,77 +1,77 @@
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { StorageLayout } = require('../lib/storage-layout');
-const { ProjectRegistryStore } = require('../lib/project-registry-store');
-const { ProjectStore } = require('../lib/project-store');
-const { KnowledgeRetrievalService } = require('../lib/knowledge-retrieval-service');
-
-(async () => {
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-retrieval-'));
-  const layout = new StorageLayout({ dataDir: path.join(root, 'data') });
-  const registry = new ProjectRegistryStore({ layout });
-  const projects = new ProjectStore({ layout });
-  await registry.initialize();
-
-  async function addProject(projectId, relatedProjectIds = []) {
-    const knowledgePath = path.join(root, 'knowledge', projectId);
-    fs.mkdirSync(path.join(knowledgePath, 'modules'), { recursive: true });
-    await projects.create(projectId, {
-      displayName: projectId,
-      storageName: projectId,
-      repoPath: path.join(root, 'repos', projectId),
-      knowledgePath,
-      relatedProjectIds,
-    }, { index: { dirty: true, generation: 9 } });
-    await registry.add(projectId, { displayNameSnapshot: projectId });
-    return knowledgePath;
-  }
-
-  const primary = await addProject('project-primary', ['project-related']);
-  const related = await addProject('project-related');
-  const secret = await addProject('project-secret');
-  for (let index = 0; index < 146; index += 1) {
-    fs.writeFileSync(path.join(primary, 'modules', `distractor-${String(index).padStart(3, '0')}.md`), `# Distractor ${index}\n\nRefresh credential lifecycle notes repeated for semantic distraction.\n`, 'utf8');
-  }
-  fs.writeFileSync(path.join(primary, 'modules', 'zzzz-token-rotation.md'), `---\ntags: [auth]\nsourcePaths: [src/security/token-rotation.js]\nroutes: [/api/tokens]\nsymbols: [TokenRotator]\n---\n# Rotation invariants\n\nThe rotation invariant is authoritative.\n`, 'utf8');
-  fs.writeFileSync(path.join(primary, 'modules', 'symbol-only.md'), `---\nsymbols: [SessionEpoch]\n---\n# Epoch contract\n\nEpoch invalidation behavior.\n`, 'utf8');
-  fs.writeFileSync(path.join(primary, 'modules', 'route-only.md'), `---\nroutes: [/v2/device-sessions]\n---\n# Device route\n\nDevice session route behavior.\n`, 'utf8');
-  fs.writeFileSync(path.join(primary, 'modules', 'tag-only.md'), `---\ntags: [credential-audit]\n---\n# Audit tag\n\nAudit behavior.\n`, 'utf8');
-  fs.writeFileSync(path.join(related, 'modules', 'related-rotation.md'), `---\nsourcePaths: [src/security/token-rotation.js]\n---\n# Related rotation\n\nRelated project evidence.\n`, 'utf8');
-  fs.writeFileSync(path.join(secret, 'modules', 'secret-rotation.md'), `---\nsourcePaths: [src/security/token-rotation.js]\n---\n# Secret rotation\n\nThis project is outside the explicit scope.\n`, 'utf8');
-
-  const service = new KnowledgeRetrievalService({ layout, registryStore: registry, projectStore: projects });
-  const snapshot = {
-    turns: [{
-      userEvents: [{ content: 'Implement the refresh credential lifecycle and preserve credential-audit behavior.' }],
-      assistantEvents: [{ content: 'A secondary hint mentions device sessions.' }],
-    }],
-  };
-  const evidence = {
-    commitSha: 'a'.repeat(40),
-    subject: 'update TokenRotator SessionEpoch /v2/device-sessions',
-    files: [{ status: 'M', path: 'src/security/token-rotation.js' }],
-  };
-  const first = await service.retrieveForCommit({ projectId: 'project-primary', conversationSnapshot: snapshot, commitEvidence: evidence, contextBudget: 64 * 1024 });
-  const second = await service.retrieveForCommit({ projectId: 'project-primary', conversationSnapshot: snapshot, commitEvidence: evidence, contextBudget: 64 * 1024 });
-  assert.strictEqual(first.manifestHash, second.manifestHash, 'deterministic inputs must produce a stable retrieval manifest hash');
-  assert.strictEqual(first.manifest.backend, 'missing', 'missing index must use the safe current-Markdown fallback');
-  assert(first.manifest.currentChunkCount >= 150, 'fixture must exercise a 100-200 document knowledge base');
-  assert.strictEqual(first.entries[0].path, 'modules/zzzz-token-rotation.md', 'exact changed-path metadata must outrank high-semantic distractors and filename order');
-  assert(first.entries[0].selectionSignals.some(signal => signal.startsWith('exact-source-path:')));
-  assert(first.entries.some(entry => entry.path === 'modules/symbol-only.md' && entry.selectionSignals.some(signal => signal.startsWith('structured:'))), 'symbol metadata must participate in recall/rerank');
-  assert(first.entries.some(entry => entry.path === 'modules/route-only.md' && entry.selectionSignals.some(signal => signal.startsWith('structured:'))), 'route metadata must participate in recall/rerank');
-  assert(first.entries.some(entry => entry.path === 'modules/tag-only.md' && entry.selectionSignals.some(signal => signal.startsWith('structured:'))), 'tag metadata must participate in recall/rerank');
-  assert(first.entries.some(entry => entry.projectId === 'project-related'), 'explicit related project scope should be eligible at lower weight');
-  assert(first.entries.every(entry => entry.projectId !== 'project-secret'), 'unrelated projects must never enter the candidate set');
-  assert(first.manifest.selected.every(item => item.documentHash && item.contentHash && item.selectionSignals.length));
-
-  const searched = await service.search({ projectId: 'project-primary', query: 'TokenRotator', limit: 5 });
-  assert.strictEqual(searched.results[0].entry_id, 'modules/zzzz-token-rotation.md');
-  assert(searched.results.every(result => result.scope_project_id !== 'project-secret'));
-  console.log('knowledge-retrieval-service-test PASS');
-})().catch(error => {
-  console.error(error.stack || error.message);
-  process.exitCode = 1;
-});
+const assert = require('assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { StorageLayout } = require('../lib/storage-layout');
+const { ProjectRegistryStore } = require('../lib/project-registry-store');
+const { ProjectStore } = require('../lib/project-store');
+const { KnowledgeRetrievalService } = require('../lib/knowledge-retrieval-service');
+
+(async () => {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-retrieval-'));
+  const layout = new StorageLayout({ dataDir: path.join(root, 'data') });
+  const registry = new ProjectRegistryStore({ layout });
+  const projects = new ProjectStore({ layout });
+  await registry.initialize();
+
+  async function addProject(projectId, relatedProjectIds = []) {
+    const knowledgePath = path.join(root, 'knowledge', projectId);
+    fs.mkdirSync(path.join(knowledgePath, 'modules'), { recursive: true });
+    await projects.create(projectId, {
+      displayName: projectId,
+      storageName: projectId,
+      repoPath: path.join(root, 'repos', projectId),
+      knowledgePath,
+      relatedProjectIds,
+    }, { index: { dirty: true, generation: 9 } });
+    await registry.add(projectId, { displayNameSnapshot: projectId });
+    return knowledgePath;
+  }
+
+  const primary = await addProject('project-primary', ['project-related']);
+  const related = await addProject('project-related');
+  const secret = await addProject('project-secret');
+  for (let index = 0; index < 146; index += 1) {
+    fs.writeFileSync(path.join(primary, 'modules', `distractor-${String(index).padStart(3, '0')}.md`), `# Distractor ${index}\n\nRefresh credential lifecycle notes repeated for semantic distraction.\n`, 'utf8');
+  }
+  fs.writeFileSync(path.join(primary, 'modules', 'zzzz-token-rotation.md'), `---\ntags: [auth]\nsourcePaths: [src/security/token-rotation.js]\nroutes: [/api/tokens]\nsymbols: [TokenRotator]\n---\n# Rotation invariants\n\nThe rotation invariant is authoritative.\n`, 'utf8');
+  fs.writeFileSync(path.join(primary, 'modules', 'symbol-only.md'), `---\nsymbols: [SessionEpoch]\n---\n# Epoch contract\n\nEpoch invalidation behavior.\n`, 'utf8');
+  fs.writeFileSync(path.join(primary, 'modules', 'route-only.md'), `---\nroutes: [/v2/device-sessions]\n---\n# Device route\n\nDevice session route behavior.\n`, 'utf8');
+  fs.writeFileSync(path.join(primary, 'modules', 'tag-only.md'), `---\ntags: [credential-audit]\n---\n# Audit tag\n\nAudit behavior.\n`, 'utf8');
+  fs.writeFileSync(path.join(related, 'modules', 'related-rotation.md'), `---\nsourcePaths: [src/security/token-rotation.js]\n---\n# Related rotation\n\nRelated project evidence.\n`, 'utf8');
+  fs.writeFileSync(path.join(secret, 'modules', 'secret-rotation.md'), `---\nsourcePaths: [src/security/token-rotation.js]\n---\n# Secret rotation\n\nThis project is outside the explicit scope.\n`, 'utf8');
+
+  const service = new KnowledgeRetrievalService({ layout, registryStore: registry, projectStore: projects });
+  const snapshot = {
+    turns: [{
+      userEvents: [{ content: 'Implement the refresh credential lifecycle and preserve credential-audit behavior.' }],
+      assistantEvents: [{ content: 'A secondary hint mentions device sessions.' }],
+    }],
+  };
+  const evidence = {
+    commitSha: 'a'.repeat(40),
+    subject: 'update TokenRotator SessionEpoch /v2/device-sessions',
+    files: [{ status: 'M', path: 'src/security/token-rotation.js' }],
+  };
+  const first = await service.retrieveForCommit({ projectId: 'project-primary', conversationSnapshot: snapshot, commitEvidence: evidence, contextBudget: 64 * 1024 });
+  const second = await service.retrieveForCommit({ projectId: 'project-primary', conversationSnapshot: snapshot, commitEvidence: evidence, contextBudget: 64 * 1024 });
+  assert.strictEqual(first.manifestHash, second.manifestHash, 'deterministic inputs must produce a stable retrieval manifest hash');
+  assert.strictEqual(first.manifest.backend, 'missing', 'missing index must use the safe current-Markdown fallback');
+  assert(first.manifest.currentChunkCount >= 150, 'fixture must exercise a 100-200 document knowledge base');
+  assert.strictEqual(first.entries[0].path, 'modules/zzzz-token-rotation.md', 'exact changed-path metadata must outrank high-semantic distractors and filename order');
+  assert(first.entries[0].selectionSignals.some(signal => signal.startsWith('exact-source-path:')));
+  assert(first.entries.some(entry => entry.path === 'modules/symbol-only.md' && entry.selectionSignals.some(signal => signal.startsWith('structured:'))), 'symbol metadata must participate in recall/rerank');
+  assert(first.entries.some(entry => entry.path === 'modules/route-only.md' && entry.selectionSignals.some(signal => signal.startsWith('structured:'))), 'route metadata must participate in recall/rerank');
+  assert(first.entries.some(entry => entry.path === 'modules/tag-only.md' && entry.selectionSignals.some(signal => signal.startsWith('structured:'))), 'tag metadata must participate in recall/rerank');
+  assert(first.entries.some(entry => entry.projectId === 'project-related'), 'explicit related project scope should be eligible at lower weight');
+  assert(first.entries.every(entry => entry.projectId !== 'project-secret'), 'unrelated projects must never enter the candidate set');
+  assert(first.manifest.selected.every(item => item.documentHash && item.contentHash && item.selectionSignals.length));
+
+  const searched = await service.search({ projectId: 'project-primary', query: 'TokenRotator', limit: 5 });
+  assert.strictEqual(searched.results[0].entry_id, 'modules/zzzz-token-rotation.md');
+  assert(searched.results.every(result => result.scope_project_id !== 'project-secret'));
+  console.log('knowledge-retrieval-service-test PASS');
+})().catch(error => {
+  console.error(error.stack || error.message);
+  process.exitCode = 1;
+});

package/_site/_test/knowledge-scopes-test.js

@@ -1,37 +1,37 @@
-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');
-
-(async () => {
-  const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'knowledge-scopes-v2-'));
-  const layout = new StorageLayout({ dataDir: path.join(temp, 'data') });
-  const settings = new SettingsStore({ layout });
-  const registry = new ProjectRegistryStore({ layout });
-  const projects = new ProjectStore({ layout });
-  await settings.initialize({ knowledge: { rootPath: path.join(temp, 'knowledge') } });
-  await registry.initialize();
-  for (const projectId of ['project-api', 'project-web', 'project-transitive']) {
-    const knowledgePath = path.join(temp, 'knowledge', projectId);
-    fs.mkdirSync(knowledgePath, { recursive: true });
-    await projects.create(projectId, {
-      displayName: projectId, storageName: projectId, repoPath: path.join(temp, projectId), knowledgePath,
-      relatedProjectIds: projectId === 'project-api' ? ['project-web'] : projectId === 'project-web' ? ['project-transitive'] : [],
-    });
-    await registry.add(projectId, { displayNameSnapshot: projectId });
-  }
-  const runtime = new KnowledgeToolRuntime({ layout, settingsStore: settings, registryStore: registry, projectStore: projects });
-  const project = runtime.resolveProject({ projectId: 'project-api' });
-  const scopes = runtime.scopes(project);
-  assert.deepStrictEqual(scopes.map(scope => scope.spaceId), ['project:project-api', 'project:project-web']);
-  assert(!scopes.some(scope => scope.projectId === 'project-transitive'), 'related scopes must remain non-transitive');
-  assert.strictEqual(scopes[0].weight, 1);
-  assert.strictEqual(scopes[1].weight, 0.88);
-  assert(!fs.existsSync(path.join(layout.getDataDir(), 'knowledge-scopes.json')), 'scope resolution must derive from immutable project config without side effects');
-  console.log('knowledge-scopes-test PASS');
-})().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');
+
+(async () => {
+  const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'knowledge-scopes-v2-'));
+  const layout = new StorageLayout({ dataDir: path.join(temp, 'data') });
+  const settings = new SettingsStore({ layout });
+  const registry = new ProjectRegistryStore({ layout });
+  const projects = new ProjectStore({ layout });
+  await settings.initialize({ knowledge: { rootPath: path.join(temp, 'knowledge') } });
+  await registry.initialize();
+  for (const projectId of ['project-api', 'project-web', 'project-transitive']) {
+    const knowledgePath = path.join(temp, 'knowledge', projectId);
+    fs.mkdirSync(knowledgePath, { recursive: true });
+    await projects.create(projectId, {
+      displayName: projectId, storageName: projectId, repoPath: path.join(temp, projectId), knowledgePath,
+      relatedProjectIds: projectId === 'project-api' ? ['project-web'] : projectId === 'project-web' ? ['project-transitive'] : [],
+    });
+    await registry.add(projectId, { displayNameSnapshot: projectId });
+  }
+  const runtime = new KnowledgeToolRuntime({ layout, settingsStore: settings, registryStore: registry, projectStore: projects });
+  const project = runtime.resolveProject({ projectId: 'project-api' });
+  const scopes = runtime.scopes(project);
+  assert.deepStrictEqual(scopes.map(scope => scope.spaceId), ['project:project-api', 'project:project-web']);
+  assert(!scopes.some(scope => scope.projectId === 'project-transitive'), 'related scopes must remain non-transitive');
+  assert.strictEqual(scopes[0].weight, 1);
+  assert.strictEqual(scopes[1].weight, 0.88);
+  assert(!fs.existsSync(path.join(layout.getDataDir(), 'knowledge-scopes.json')), 'scope resolution must derive from immutable project config without side effects');
+  console.log('knowledge-scopes-test PASS');
+})().catch(error => { console.error(error); process.exitCode = 1; });

package/_site/_test/knowledge-storage-location-test.js

@@ -1,28 +1,28 @@
-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');
-
-(async () => {
-  const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'knowledge-storage-location-v2-'));
-  const dataDir = path.join(temp, 'data');
-  const rootA = path.join(temp, 'knowledge-a');
-  const rootB = path.join(temp, 'knowledge-b');
-  const layout = new StorageLayout({ dataDir });
-  const settings = new SettingsStore({ layout });
-  await settings.initialize({ knowledge: { rootPath: rootA } });
-  const indexPath = layout.getIndexPath();
-  fs.mkdirSync(indexPath, { recursive: true });
-  fs.writeFileSync(path.join(indexPath, 'sentinel'), 'derived-index', 'utf8');
-  await settings.updatePatch({ knowledge: { rootPath: rootB } });
-  assert.strictEqual(layout.getIndexPath(), indexPath, 'the internal index path must not follow the user knowledge root');
-  assert.strictEqual(fs.readFileSync(path.join(indexPath, 'sentinel'), 'utf8'), 'derived-index');
-  assert.strictEqual(layout.isPathInside(rootA, indexPath), false);
-  assert.strictEqual(layout.isPathInside(rootB, indexPath), false);
-  assert.strictEqual(layout.getKnowledgeRootPath(settings.read()), path.resolve(rootB));
-  assert(!fs.existsSync(path.join(rootA, '.project-knowledge')));
-  assert(!fs.existsSync(path.join(rootB, '.project-knowledge')));
-  console.log('knowledge-storage-location-test: PASS');
-})().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');
+
+(async () => {
+  const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'knowledge-storage-location-v2-'));
+  const dataDir = path.join(temp, 'data');
+  const rootA = path.join(temp, 'knowledge-a');
+  const rootB = path.join(temp, 'knowledge-b');
+  const layout = new StorageLayout({ dataDir });
+  const settings = new SettingsStore({ layout });
+  await settings.initialize({ knowledge: { rootPath: rootA } });
+  const indexPath = layout.getIndexPath();
+  fs.mkdirSync(indexPath, { recursive: true });
+  fs.writeFileSync(path.join(indexPath, 'sentinel'), 'derived-index', 'utf8');
+  await settings.updatePatch({ knowledge: { rootPath: rootB } });
+  assert.strictEqual(layout.getIndexPath(), indexPath, 'the internal index path must not follow the user knowledge root');
+  assert.strictEqual(fs.readFileSync(path.join(indexPath, 'sentinel'), 'utf8'), 'derived-index');
+  assert.strictEqual(layout.isPathInside(rootA, indexPath), false);
+  assert.strictEqual(layout.isPathInside(rootB, indexPath), false);
+  assert.strictEqual(layout.getKnowledgeRootPath(settings.read()), path.resolve(rootB));
+  assert(!fs.existsSync(path.join(rootA, '.project-knowledge')));
+  assert(!fs.existsSync(path.join(rootB, '.project-knowledge')));
+  console.log('knowledge-storage-location-test: PASS');
+})().catch(error => { console.error(error); process.exitCode = 1; });

package/_site/_test/knowledge-storage-startup-test.js

@@ -1,52 +1,52 @@
-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 { KnowledgeDatabase } = require('../lib/knowledge-db');
-const { EMBEDDING_DIMENSIONS } = require('../lib/knowledge-schema');
-const { spawnServer } = require('./helpers/spawn-server');
-
-const ROOT = path.resolve(__dirname, '..', '..');
-const PORT = 7931;
-const BASE_URL = `http://127.0.0.1:${PORT}`;
-
-async function get(route) {
-  const response = await fetch(`${BASE_URL}${route}`);
-  return { response, body: await response.json() };
-}
-
-(async () => {
-  const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'knowledge-storage-startup-v2-'));
-  const layout = new StorageLayout({ dataDir });
-  const configuredRoot = path.join(dataDir, 'selected-knowledge-root');
-  const settings = new SettingsStore({ layout });
-  await settings.initialize({ knowledge: { rootPath: configuredRoot } });
-  await new ProjectRegistryStore({ layout }).initialize();
-  const internalIndex = layout.getIndexPath();
-  const database = new KnowledgeDatabase({ dbPath: internalIndex });
-  const vector = new Array(EMBEDDING_DIMENSIONS).fill(0);
-  vector[4] = 1;
-  await database.replaceEntry('project:legacy', 'GOAL.md', [{ chunkOrder: 0, title: 'Legacy', chunkText: 'Fixed internal derived row.', vector }]);
-  await database.close();
-  const spawned = spawnServer({ root: ROOT, port: PORT, dataDir, tag: 'knowledge-storage-startup', extraEnv: { KB_EMBEDDING_FAKE: '1' } });
-  try {
-    let health;
-    for (let attempt = 0; attempt < 100; attempt += 1) {
-      try { health = await get('/api/health'); if (health.response.ok) break; } catch {}
-      await new Promise(resolve => setTimeout(resolve, 100));
-    }
-    assert(health && health.response.ok, 'server did not start');
-    const publicSettings = await get('/api/settings');
-    assert.strictEqual(publicSettings.body.settings.knowledge.rootPath, path.resolve(configuredRoot));
-    const maintenance = await get('/api/knowledge/maintenance');
-    assert.strictEqual(maintenance.body.indexPath, internalIndex);
-    assert(fs.existsSync(internalIndex), 'the derived index must remain under the internal data directory');
-    assert(!fs.existsSync(path.join(configuredRoot, '.project-knowledge')), 'the user knowledge root must not receive internal runtime data');
-    console.log('knowledge-storage-startup-test: PASS');
-  } finally {
-    spawned.child.kill();
-  }
-})().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 { KnowledgeDatabase } = require('../lib/knowledge-db');
+const { EMBEDDING_DIMENSIONS } = require('../lib/knowledge-schema');
+const { spawnServer } = require('./helpers/spawn-server');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const PORT = 7931;
+const BASE_URL = `http://127.0.0.1:${PORT}`;
+
+async function get(route) {
+  const response = await fetch(`${BASE_URL}${route}`);
+  return { response, body: await response.json() };
+}
+
+(async () => {
+  const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'knowledge-storage-startup-v2-'));
+  const layout = new StorageLayout({ dataDir });
+  const configuredRoot = path.join(dataDir, 'selected-knowledge-root');
+  const settings = new SettingsStore({ layout });
+  await settings.initialize({ knowledge: { rootPath: configuredRoot } });
+  await new ProjectRegistryStore({ layout }).initialize();
+  const internalIndex = layout.getIndexPath();
+  const database = new KnowledgeDatabase({ dbPath: internalIndex });
+  const vector = new Array(EMBEDDING_DIMENSIONS).fill(0);
+  vector[4] = 1;
+  await database.replaceEntry('project:legacy', 'GOAL.md', [{ chunkOrder: 0, title: 'Legacy', chunkText: 'Fixed internal derived row.', vector }]);
+  await database.close();
+  const spawned = spawnServer({ root: ROOT, port: PORT, dataDir, tag: 'knowledge-storage-startup', extraEnv: { KB_EMBEDDING_FAKE: '1' } });
+  try {
+    let health;
+    for (let attempt = 0; attempt < 100; attempt += 1) {
+      try { health = await get('/api/health'); if (health.response.ok) break; } catch {}
+      await new Promise(resolve => setTimeout(resolve, 100));
+    }
+    assert(health && health.response.ok, 'server did not start');
+    const publicSettings = await get('/api/settings');
+    assert.strictEqual(publicSettings.body.settings.knowledge.rootPath, path.resolve(configuredRoot));
+    const maintenance = await get('/api/knowledge/maintenance');
+    assert.strictEqual(maintenance.body.indexPath, internalIndex);
+    assert(fs.existsSync(internalIndex), 'the derived index must remain under the internal data directory');
+    assert(!fs.existsSync(path.join(configuredRoot, '.project-knowledge')), 'the user knowledge root must not receive internal runtime data');
+    console.log('knowledge-storage-startup-test: PASS');
+  } finally {
+    spawned.child.kill();
+  }
+})().catch(error => { console.error(error); process.exitCode = 1; });