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

package/_site/_test/ai-profile-test.js

@@ -1,75 +1,75 @@
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { spawnServer } = require('./helpers/spawn-server');
-
-const ROOT = path.resolve(__dirname, '..', '..');
-const PORT = 7795;
-const BASE = `http://127.0.0.1:${PORT}`;
-const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pkb-ai-v2-'));
-
-async function request(method, pathname, body) {
-  const response = await fetch(`${BASE}${pathname}`, {
-    method,
-    headers: body === undefined ? undefined : { 'content-type': 'application/json' },
-    body: body === undefined ? undefined : JSON.stringify(body),
-  });
-  return { status: response.status, text: await response.text() };
-}
-
-async function json(method, pathname, body) {
-  const result = await request(method, pathname, body);
-  return { ...result, data: JSON.parse(result.text || '{}') };
-}
-
-async function waitForServer() {
-  for (let attempt = 0; attempt < 100; attempt += 1) {
-    try { if ((await fetch(`${BASE}/api/health`)).ok) return; } catch {}
-    await new Promise(resolve => setTimeout(resolve, 100));
-  }
-  throw new Error('server did not start');
-}
-
-(async () => {
-  const spawned = spawnServer({ root: ROOT, port: PORT, dataDir, tag: 'ai-profile-v2', extraEnv: { KB_SKIP_MIGRATION: '1' } });
-  try {
-    await waitForServer();
-    let result = await json('PUT', '/api/ai-profiles', {
-      schema: 'ai-profiles/v1', defaultProfileId: 'secure', profiles: [{
-        id: 'secure', name: 'Secure', enabled: true, implementation: 'claude-code-agent', apiKeyUpdate: { mode: 'replace', value: 'sk-secret-1234' },
-      }],
-    });
-    assert.strictEqual(result.status, 200, result.text);
-    assert.strictEqual(result.data.config.profiles[0].hasApiKey, true);
-    assert.strictEqual(result.data.config.profiles[0].apiKeyMasked, '****1234');
-    assert(!result.text.includes('sk-secret-1234'));
-
-    result = await json('GET', '/api/ai-profiles');
-    assert.strictEqual(result.status, 200);
-    assert(!result.text.includes('sk-secret-1234'));
-    assert(!/"apiKey"\s*:/.test(result.text));
-
-    result = await json('PUT', '/api/ai-profiles', {
-      schema: 'ai-profiles/v1', defaultProfileId: 'secure', profiles: [{ id: 'secure', name: 'Renamed', enabled: true, implementation: 'claude-code-agent', apiKeyUpdate: { mode: 'preserve' } }],
-    });
-    assert.strictEqual(result.status, 200);
-    let settings = JSON.parse(fs.readFileSync(path.join(dataDir, 'settings.json'), 'utf8'));
-    assert.strictEqual(settings.ai.profiles[0].apiKey, 'sk-secret-1234');
-
-    result = await json('PUT', '/api/ai-profiles', {
-      schema: 'ai-profiles/v1', defaultProfileId: 'secure', profiles: [{ id: 'secure', name: 'Renamed', enabled: true, implementation: 'claude-code-agent', apiKeyUpdate: { mode: 'clear' } }],
-    });
-    assert.strictEqual(result.status, 200);
-    settings = JSON.parse(fs.readFileSync(path.join(dataDir, 'settings.json'), 'utf8'));
-    assert(!Object.prototype.hasOwnProperty.call(settings.ai.profiles[0], 'apiKey'));
-
-    result = await json('PUT', '/api/ai-profiles', { profiles: [{ id: '../bad', apiKeyUpdate: { mode: 'clear' } }] });
-    assert.strictEqual(result.status, 400);
-    assert.strictEqual(result.data.error.code, 'INVALID_ARGUMENT');
-    assert(!Object.prototype.hasOwnProperty.call(result.data.error, 'stack'));
-    console.log('ai-profile-test PASS');
-  } finally {
-    await spawned.cleanup();
-  }
-})().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 { spawnServer } = require('./helpers/spawn-server');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const PORT = 7795;
+const BASE = `http://127.0.0.1:${PORT}`;
+const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pkb-ai-v2-'));
+
+async function request(method, pathname, body) {
+  const response = await fetch(`${BASE}${pathname}`, {
+    method,
+    headers: body === undefined ? undefined : { 'content-type': 'application/json' },
+    body: body === undefined ? undefined : JSON.stringify(body),
+  });
+  return { status: response.status, text: await response.text() };
+}
+
+async function json(method, pathname, body) {
+  const result = await request(method, pathname, body);
+  return { ...result, data: JSON.parse(result.text || '{}') };
+}
+
+async function waitForServer() {
+  for (let attempt = 0; attempt < 100; attempt += 1) {
+    try { if ((await fetch(`${BASE}/api/health`)).ok) return; } catch {}
+    await new Promise(resolve => setTimeout(resolve, 100));
+  }
+  throw new Error('server did not start');
+}
+
+(async () => {
+  const spawned = spawnServer({ root: ROOT, port: PORT, dataDir, tag: 'ai-profile-v2', extraEnv: { KB_SKIP_MIGRATION: '1' } });
+  try {
+    await waitForServer();
+    let result = await json('PUT', '/api/ai-profiles', {
+      schema: 'ai-profiles/v1', defaultProfileId: 'secure', profiles: [{
+        id: 'secure', name: 'Secure', enabled: true, implementation: 'claude-code-agent', apiKeyUpdate: { mode: 'replace', value: 'sk-secret-1234' },
+      }],
+    });
+    assert.strictEqual(result.status, 200, result.text);
+    assert.strictEqual(result.data.config.profiles[0].hasApiKey, true);
+    assert.strictEqual(result.data.config.profiles[0].apiKeyMasked, '****1234');
+    assert(!result.text.includes('sk-secret-1234'));
+
+    result = await json('GET', '/api/ai-profiles');
+    assert.strictEqual(result.status, 200);
+    assert(!result.text.includes('sk-secret-1234'));
+    assert(!/"apiKey"\s*:/.test(result.text));
+
+    result = await json('PUT', '/api/ai-profiles', {
+      schema: 'ai-profiles/v1', defaultProfileId: 'secure', profiles: [{ id: 'secure', name: 'Renamed', enabled: true, implementation: 'claude-code-agent', apiKeyUpdate: { mode: 'preserve' } }],
+    });
+    assert.strictEqual(result.status, 200);
+    let settings = JSON.parse(fs.readFileSync(path.join(dataDir, 'settings.json'), 'utf8'));
+    assert.strictEqual(settings.ai.profiles[0].apiKey, 'sk-secret-1234');
+
+    result = await json('PUT', '/api/ai-profiles', {
+      schema: 'ai-profiles/v1', defaultProfileId: 'secure', profiles: [{ id: 'secure', name: 'Renamed', enabled: true, implementation: 'claude-code-agent', apiKeyUpdate: { mode: 'clear' } }],
+    });
+    assert.strictEqual(result.status, 200);
+    settings = JSON.parse(fs.readFileSync(path.join(dataDir, 'settings.json'), 'utf8'));
+    assert(!Object.prototype.hasOwnProperty.call(settings.ai.profiles[0], 'apiKey'));
+
+    result = await json('PUT', '/api/ai-profiles', { profiles: [{ id: '../bad', apiKeyUpdate: { mode: 'clear' } }] });
+    assert.strictEqual(result.status, 400);
+    assert.strictEqual(result.data.error.code, 'INVALID_ARGUMENT');
+    assert(!Object.prototype.hasOwnProperty.call(result.data.error, 'stack'));
+    console.log('ai-profile-test PASS');
+  } finally {
+    await spawned.cleanup();
+  }
+})().catch(error => { console.error(error); process.exitCode = 1; });

package/_site/_test/ai-vendor-presets-test.js

@@ -1,91 +1,91 @@
-// Tests for ai-vendor-presets: 4 vendors with full fields, name/id lookup.
-
-const { AI_VENDOR_PRESETS, listVendorPresetNames, findVendorPresetByName } = require('../lib/ai-vendor-presets');
-
-function assert(cond, msg) { if (!cond) throw new Error(msg); }
-
-(() => {
-  try {
-    // 1. Exactly 4 vendors
-    assert(Array.isArray(AI_VENDOR_PRESETS), 'AI_VENDOR_PRESETS should be an array');
-    assert(AI_VENDOR_PRESETS.length === 4, `expected 4 vendors, got ${AI_VENDOR_PRESETS.length}`);
-
-    // 2. IDs unique and match the expected set
-    const ids = AI_VENDOR_PRESETS.map(v => v.id).sort();
-    assert(JSON.stringify(ids) === JSON.stringify(['anthropic', 'deepseek', 'minimax', 'zhipu']),
-      `vendor ids should be anthropic/deepseek/minimax/zhipu, got ${JSON.stringify(ids)}`);
-
-    // 3. Every preset has the required fields
-    const required = ['id', 'name', 'baseUrl', 'mainModel', 'thinkingModel',
-                      'haikuModel', 'sonnetModel', 'opusModel', 'contextWindow', 'website'];
-    for (const v of AI_VENDOR_PRESETS) {
-      for (const f of required) {
-        assert(v[f] !== undefined && v[f] !== null && v[f] !== '',
-          `vendor ${v.id} missing or empty field: ${f}`);
-      }
-    }
-
-    // 4. baseUrl: https://, no trailing slash
-    for (const v of AI_VENDOR_PRESETS) {
-      assert(/^https?:\/\//.test(v.baseUrl), `${v.id} baseUrl must start with http(s)://`);
-      assert(!/\/$/.test(v.baseUrl), `${v.id} baseUrl must NOT have trailing slash`);
-    }
-
-    // 5. contextWindow is a positive integer
-    for (const v of AI_VENDOR_PRESETS) {
-      assert(Number.isInteger(v.contextWindow) && v.contextWindow > 0,
-        `${v.id} contextWindow must be a positive integer, got ${v.contextWindow}`);
-    }
-
-    // 6. Specific known values
-    const minimax = findVendorPresetByName('MiniMax');
-    assert(minimax && minimax.baseUrl === 'https://api.minimaxi.com/anthropic',
-      `minimax baseUrl wrong: ${minimax && minimax.baseUrl}`);
-    assert(minimax && minimax.mainModel === 'MiniMax-M3',
-      `minimax mainModel wrong: ${minimax && minimax.mainModel}`);
-    assert(minimax && minimax.contextWindow === 1048576,
-      `minimax contextWindow should be 1M`);
-
-    const anthropic = findVendorPresetByName('Anthropic Claude');
-    assert(anthropic && anthropic.baseUrl === 'https://api.anthropic.com',
-      `anthropic baseUrl wrong`);
-    assert(anthropic && anthropic.contextWindow === 200000,
-      `anthropic contextWindow should be 200K`);
-
-    const zhipu = findVendorPresetByName('智谱 GLM');
-    assert(zhipu && zhipu.baseUrl === 'https://open.bigmodel.cn/api/anthropic',
-      `zhipu baseUrl wrong: ${zhipu && zhipu.baseUrl}`);
-
-    const deepseek = findVendorPresetByName('DeepSeek');
-    assert(deepseek && deepseek.baseUrl === 'https://api.deepseek.com/anthropic',
-      `deepseek baseUrl wrong: ${deepseek && deepseek.baseUrl}`);
-    assert(deepseek && deepseek.mainModel === 'deepseek-chat',
-      `deepseek mainModel wrong`);
-    assert(deepseek && deepseek.thinkingModel === 'deepseek-reasoner',
-      `deepseek thinkingModel wrong`);
-
-    // 7. Case-insensitive lookup by name
-    assert(findVendorPresetByName('minimax').id === 'minimax', 'lowercase name lookup');
-    assert(findVendorPresetByName('MINIMAX').id === 'minimax', 'uppercase name lookup');
-
-    // 8. Lookup by id also works
-    assert(findVendorPresetByName('minimax').id === 'minimax', 'id lookup');
-
-    // 9. Unknown / empty / null returns null (no false positive)
-    assert(findVendorPresetByName('Totally Unknown Vendor') === null, 'unknown vendor → null');
-    assert(findVendorPresetByName('') === null, 'empty name → null');
-    assert(findVendorPresetByName(null) === null, 'null name → null');
-    assert(findVendorPresetByName(undefined) === null, 'undefined name → null');
-
-    // 10. listVendorPresetNames returns all 4 names in stable order
-    const names = listVendorPresetNames();
-    assert(names.length === 4, `expected 4 names, got ${names.length}`);
-    assert(names.every(n => typeof n === 'string' && n.length > 0),
-      'all names should be non-empty strings');
-
-    console.log('ai-vendor-presets test passed');
-  } catch (e) {
-    console.error('ai-vendor-presets test failed:', e.message);
-    process.exitCode = 1;
-  }
-})();
+// Tests for ai-vendor-presets: 4 vendors with full fields, name/id lookup.
+
+const { AI_VENDOR_PRESETS, listVendorPresetNames, findVendorPresetByName } = require('../lib/ai-vendor-presets');
+
+function assert(cond, msg) { if (!cond) throw new Error(msg); }
+
+(() => {
+  try {
+    // 1. Exactly 4 vendors
+    assert(Array.isArray(AI_VENDOR_PRESETS), 'AI_VENDOR_PRESETS should be an array');
+    assert(AI_VENDOR_PRESETS.length === 4, `expected 4 vendors, got ${AI_VENDOR_PRESETS.length}`);
+
+    // 2. IDs unique and match the expected set
+    const ids = AI_VENDOR_PRESETS.map(v => v.id).sort();
+    assert(JSON.stringify(ids) === JSON.stringify(['anthropic', 'deepseek', 'minimax', 'zhipu']),
+      `vendor ids should be anthropic/deepseek/minimax/zhipu, got ${JSON.stringify(ids)}`);
+
+    // 3. Every preset has the required fields
+    const required = ['id', 'name', 'baseUrl', 'mainModel', 'thinkingModel',
+                      'haikuModel', 'sonnetModel', 'opusModel', 'contextWindow', 'website'];
+    for (const v of AI_VENDOR_PRESETS) {
+      for (const f of required) {
+        assert(v[f] !== undefined && v[f] !== null && v[f] !== '',
+          `vendor ${v.id} missing or empty field: ${f}`);
+      }
+    }
+
+    // 4. baseUrl: https://, no trailing slash
+    for (const v of AI_VENDOR_PRESETS) {
+      assert(/^https?:\/\//.test(v.baseUrl), `${v.id} baseUrl must start with http(s)://`);
+      assert(!/\/$/.test(v.baseUrl), `${v.id} baseUrl must NOT have trailing slash`);
+    }
+
+    // 5. contextWindow is a positive integer
+    for (const v of AI_VENDOR_PRESETS) {
+      assert(Number.isInteger(v.contextWindow) && v.contextWindow > 0,
+        `${v.id} contextWindow must be a positive integer, got ${v.contextWindow}`);
+    }
+
+    // 6. Specific known values
+    const minimax = findVendorPresetByName('MiniMax');
+    assert(minimax && minimax.baseUrl === 'https://api.minimaxi.com/anthropic',
+      `minimax baseUrl wrong: ${minimax && minimax.baseUrl}`);
+    assert(minimax && minimax.mainModel === 'MiniMax-M3',
+      `minimax mainModel wrong: ${minimax && minimax.mainModel}`);
+    assert(minimax && minimax.contextWindow === 1048576,
+      `minimax contextWindow should be 1M`);
+
+    const anthropic = findVendorPresetByName('Anthropic Claude');
+    assert(anthropic && anthropic.baseUrl === 'https://api.anthropic.com',
+      `anthropic baseUrl wrong`);
+    assert(anthropic && anthropic.contextWindow === 200000,
+      `anthropic contextWindow should be 200K`);
+
+    const zhipu = findVendorPresetByName('智谱 GLM');
+    assert(zhipu && zhipu.baseUrl === 'https://open.bigmodel.cn/api/anthropic',
+      `zhipu baseUrl wrong: ${zhipu && zhipu.baseUrl}`);
+
+    const deepseek = findVendorPresetByName('DeepSeek');
+    assert(deepseek && deepseek.baseUrl === 'https://api.deepseek.com/anthropic',
+      `deepseek baseUrl wrong: ${deepseek && deepseek.baseUrl}`);
+    assert(deepseek && deepseek.mainModel === 'deepseek-chat',
+      `deepseek mainModel wrong`);
+    assert(deepseek && deepseek.thinkingModel === 'deepseek-reasoner',
+      `deepseek thinkingModel wrong`);
+
+    // 7. Case-insensitive lookup by name
+    assert(findVendorPresetByName('minimax').id === 'minimax', 'lowercase name lookup');
+    assert(findVendorPresetByName('MINIMAX').id === 'minimax', 'uppercase name lookup');
+
+    // 8. Lookup by id also works
+    assert(findVendorPresetByName('minimax').id === 'minimax', 'id lookup');
+
+    // 9. Unknown / empty / null returns null (no false positive)
+    assert(findVendorPresetByName('Totally Unknown Vendor') === null, 'unknown vendor → null');
+    assert(findVendorPresetByName('') === null, 'empty name → null');
+    assert(findVendorPresetByName(null) === null, 'null name → null');
+    assert(findVendorPresetByName(undefined) === null, 'undefined name → null');
+
+    // 10. listVendorPresetNames returns all 4 names in stable order
+    const names = listVendorPresetNames();
+    assert(names.length === 4, `expected 4 names, got ${names.length}`);
+    assert(names.every(n => typeof n === 'string' && n.length > 0),
+      'all names should be non-empty strings');
+
+    console.log('ai-vendor-presets test passed');
+  } catch (e) {
+    console.error('ai-vendor-presets test failed:', e.message);
+    process.exitCode = 1;
+  }
+})();

package/_site/_test/automatic-context-test.js

@@ -1,70 +1,70 @@
-'use strict';
-const assert = require('node:assert/strict');
-const fs = require('node:fs');
-const os = require('node:os');
-const path = require('node:path');
-const { IntegrationManager } = require('../lib/integration-installer');
-const { run, writeOutput } = require('../../plugins/project-knowledge/scripts/context-hook.cjs');
-
-async function main() {
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'automatic-context-'));
-  try {
-    const endpoint = { schema: 'project-knowledge/runtime-endpoint/v1', host: '127.0.0.1', pid: process.pid, port: 23456, startedAt: 'now' };
-    fs.writeFileSync(path.join(root, 'runtime-endpoint.json'), JSON.stringify(endpoint));
-    const payload = { cwd: root, session_id: 'session-a', hook_event_name: 'UserPromptSubmit', prompt: 'Develop export normally' };
-    const env = { KB_DATA_DIR: root }, calls = [];
-    const identity = { ...endpoint, schema: 'project-knowledge/runtime-control/v1', name: 'project-knowledge', dataDir: root };
-    const fetchImpl = async (url, options) => {
-      calls.push({ url: String(url), options });
-      if (String(url).endsWith('/identity')) return Response.json(identity);
-      const input = JSON.parse(options.body);
-      return Response.json({ ok: true, requestId: input.requestId, projectId: 'project-a', status: 'ready', memoryStatus: 'ready', prompt: '<knowledge_context>export revision 37</knowledge_context>', facts: [{}], memories: [{}], references: [{}] });
-    };
-    const output = await run(payload, { env, fetchImpl });
-    assert.match(output.hookSpecificOutput.additionalContext, /revision 37/); assert.equal(calls.length, 2);
-    assert.equal(JSON.parse(calls[1].options.body).query, payload.prompt);
-    assert.ok(!JSON.stringify(output).includes('receipt')); assert.ok(!fs.existsSync(path.join(root, 'logs')));
-    await writeOutput(output, { write: (text, callback) => { assert.ok(!text.includes('receipt')); callback(); } });
-    const logDir = path.join(root, 'logs/projects/project-a'); const logText = fs.readFileSync(path.join(logDir, fs.readdirSync(logDir)[0]), 'utf8');
-    assert.ok(!logText.includes(payload.prompt)); assert.ok(!logText.includes('revision 37')); assert.ok(logText.includes('agent.context.output'));
-    calls.length = 0;
-    assert.deepEqual(await run(payload, { env: { ...env, KB_KNOWLEDGE_CONTEXT: '0' }, fetchImpl }), {}); assert.equal(calls.length, 0);
-    assert.deepEqual(await run({ ...payload, hook_event_name: 'Stop' }, { env, fetchImpl }), {});
-    const mismatch = await run(payload, { env, fetchImpl: async () => Response.json({ ...identity, dataDir: path.join(root, 'other') }) });
-    assert.match(mismatch.systemMessage, /CONTEXT_IDENTITY_MISMATCH/);
-    const unknown = await run(payload, { env, fetchImpl: async url => String(url).endsWith('/identity') ? Response.json(identity) : Response.json({ ok: false, error: 'PROJECT_NOT_FOUND' }, { status: 404 }) });
-    assert.match(unknown.systemMessage, /未识别到当前代码目录/);
-    assert.match(unknown.hookSpecificOutput.additionalContext, /不代表知识库为空/);
-    const offline = await run(payload, { env, fetchImpl: async () => { throw new Error('sensitive untrusted upstream text'); } });
-    assert.match(offline.systemMessage, /可继续开发/); assert.ok(!JSON.stringify(offline).includes('sensitive'));
-    const slow = await run(payload, { env, timeoutMs: 30, fetchImpl: (url, options) => new Promise((resolve, reject) => options.signal.addEventListener('abort', () => reject(new Error('aborted')), { once: true })) });
-    assert.match(slow.systemMessage, /CONTEXT_TIMEOUT/);
-    let version = '4.2.16'; const commandCalls = [];
-    const manager = new IntegrationManager({ homeDir: root, commandResolver: name => name, runner: (command, args) => {
-      commandCalls.push(args.join(' '));
-      if (args.join(' ') === 'plugin list --json') return { status: 0, stdout: JSON.stringify([{ id: 'project-knowledge@project-knowledge', version, enabled: true }]) };
-      if (args.join(' ') === 'plugin marketplace list --json') return { status: 0, stdout: JSON.stringify([{ name: 'project-knowledge' }]) };
-      if (args.slice(0, 2).join(' ') === 'plugin update') {
-        version = manager.version;
-        const source = path.resolve(__dirname, '../../plugins/project-knowledge'), cache = path.join(root, '.claude/plugins/cache/project-knowledge/project-knowledge', version);
-        fs.mkdirSync(cache, { recursive: true }); fs.cpSync(source, cache, { recursive: true });
-      }
-      return { status: 0, stdout: '' };
-    } });
-    const knownMarketplaces = path.join(root, '.claude/plugins/known_marketplaces.json');
-    fs.mkdirSync(path.dirname(knownMarketplaces), { recursive: true });
-    fs.writeFileSync(knownMarketplaces, JSON.stringify({ 'project-knowledge': { source: { source: 'directory', path: manager.rootDir } } }));
-    assert.equal(manager.statusClaude().state, 'needs-update');
-    manager.installClaude();
-    assert.ok(commandCalls.includes('plugin marketplace update project-knowledge'));
-    assert.ok(commandCalls.includes('plugin update project-knowledge@project-knowledge --scope user'));
-    assert.equal(manager.statusClaude().state, 'installed');
-    const cacheRoot = path.join(root, '.claude/plugins/cache/project-knowledge/project-knowledge', manager.version);
-    for (const file of ['hooks/claude.json', 'scripts/context-hook.cjs']) fs.writeFileSync(path.join(cacheRoot, file), fs.readFileSync(path.join(cacheRoot, file), 'utf8').replace(/\r?\n/g, '\r\n'));
-    assert.equal(manager.automaticContextStatus('claude', manager.statusClaude()).configured, true, 'Git CRLF checkout and npm LF are the same client integration');
-    const before = commandCalls.filter(c => c.startsWith('plugin update')).length; manager.installClaude();
-    assert.equal(commandCalls.filter(c => c.startsWith('plugin update')).length, before);
-    console.log('Automatic context protocol, fail-open safety and stale-plugin upgrade passed.');
-  } finally { fs.rmSync(root, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 }); }
-}
-main().catch(error => { console.error(error); 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 { IntegrationManager } = require('../lib/integration-installer');
+const { run, writeOutput } = require('../../plugins/project-knowledge/scripts/context-hook.cjs');
+
+async function main() {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'automatic-context-'));
+  try {
+    const endpoint = { schema: 'project-knowledge/runtime-endpoint/v1', host: '127.0.0.1', pid: process.pid, port: 23456, startedAt: 'now' };
+    fs.writeFileSync(path.join(root, 'runtime-endpoint.json'), JSON.stringify(endpoint));
+    const payload = { cwd: root, session_id: 'session-a', hook_event_name: 'UserPromptSubmit', prompt: 'Develop export normally' };
+    const env = { KB_DATA_DIR: root }, calls = [];
+    const identity = { ...endpoint, schema: 'project-knowledge/runtime-control/v1', name: 'project-knowledge', dataDir: root };
+    const fetchImpl = async (url, options) => {
+      calls.push({ url: String(url), options });
+      if (String(url).endsWith('/identity')) return Response.json(identity);
+      const input = JSON.parse(options.body);
+      return Response.json({ ok: true, requestId: input.requestId, projectId: 'project-a', status: 'ready', memoryStatus: 'ready', prompt: '<knowledge_context>export revision 37</knowledge_context>', facts: [{}], memories: [{}], references: [{}] });
+    };
+    const output = await run(payload, { env, fetchImpl });
+    assert.match(output.hookSpecificOutput.additionalContext, /revision 37/); assert.equal(calls.length, 2);
+    assert.equal(JSON.parse(calls[1].options.body).query, payload.prompt);
+    assert.ok(!JSON.stringify(output).includes('receipt')); assert.ok(!fs.existsSync(path.join(root, 'logs')));
+    await writeOutput(output, { write: (text, callback) => { assert.ok(!text.includes('receipt')); callback(); } });
+    const logDir = path.join(root, 'logs/projects/project-a'); const logText = fs.readFileSync(path.join(logDir, fs.readdirSync(logDir)[0]), 'utf8');
+    assert.ok(!logText.includes(payload.prompt)); assert.ok(!logText.includes('revision 37')); assert.ok(logText.includes('agent.context.output'));
+    calls.length = 0;
+    assert.deepEqual(await run(payload, { env: { ...env, KB_KNOWLEDGE_CONTEXT: '0' }, fetchImpl }), {}); assert.equal(calls.length, 0);
+    assert.deepEqual(await run({ ...payload, hook_event_name: 'Stop' }, { env, fetchImpl }), {});
+    const mismatch = await run(payload, { env, fetchImpl: async () => Response.json({ ...identity, dataDir: path.join(root, 'other') }) });
+    assert.match(mismatch.systemMessage, /CONTEXT_IDENTITY_MISMATCH/);
+    const unknown = await run(payload, { env, fetchImpl: async url => String(url).endsWith('/identity') ? Response.json(identity) : Response.json({ ok: false, error: 'PROJECT_NOT_FOUND' }, { status: 404 }) });
+    assert.match(unknown.systemMessage, /未识别到当前代码目录/);
+    assert.match(unknown.hookSpecificOutput.additionalContext, /不代表知识库为空/);
+    const offline = await run(payload, { env, fetchImpl: async () => { throw new Error('sensitive untrusted upstream text'); } });
+    assert.match(offline.systemMessage, /可继续开发/); assert.ok(!JSON.stringify(offline).includes('sensitive'));
+    const slow = await run(payload, { env, timeoutMs: 30, fetchImpl: (url, options) => new Promise((resolve, reject) => options.signal.addEventListener('abort', () => reject(new Error('aborted')), { once: true })) });
+    assert.match(slow.systemMessage, /CONTEXT_TIMEOUT/);
+    let version = '4.2.16'; const commandCalls = [];
+    const manager = new IntegrationManager({ homeDir: root, commandResolver: name => name, runner: (command, args) => {
+      commandCalls.push(args.join(' '));
+      if (args.join(' ') === 'plugin list --json') return { status: 0, stdout: JSON.stringify([{ id: 'project-knowledge@project-knowledge', version, enabled: true }]) };
+      if (args.join(' ') === 'plugin marketplace list --json') return { status: 0, stdout: JSON.stringify([{ name: 'project-knowledge' }]) };
+      if (args.slice(0, 2).join(' ') === 'plugin update') {
+        version = manager.version;
+        const source = path.resolve(__dirname, '../../plugins/project-knowledge'), cache = path.join(root, '.claude/plugins/cache/project-knowledge/project-knowledge', version);
+        fs.mkdirSync(cache, { recursive: true }); fs.cpSync(source, cache, { recursive: true });
+      }
+      return { status: 0, stdout: '' };
+    } });
+    const knownMarketplaces = path.join(root, '.claude/plugins/known_marketplaces.json');
+    fs.mkdirSync(path.dirname(knownMarketplaces), { recursive: true });
+    fs.writeFileSync(knownMarketplaces, JSON.stringify({ 'project-knowledge': { source: { source: 'directory', path: manager.rootDir } } }));
+    assert.equal(manager.statusClaude().state, 'needs-update');
+    manager.installClaude();
+    assert.ok(commandCalls.includes('plugin marketplace update project-knowledge'));
+    assert.ok(commandCalls.includes('plugin update project-knowledge@project-knowledge --scope user'));
+    assert.equal(manager.statusClaude().state, 'installed');
+    const cacheRoot = path.join(root, '.claude/plugins/cache/project-knowledge/project-knowledge', manager.version);
+    for (const file of ['hooks/claude.json', 'scripts/context-hook.cjs']) fs.writeFileSync(path.join(cacheRoot, file), fs.readFileSync(path.join(cacheRoot, file), 'utf8').replace(/\r?\n/g, '\r\n'));
+    assert.equal(manager.automaticContextStatus('claude', manager.statusClaude()).configured, true, 'Git CRLF checkout and npm LF are the same client integration');
+    const before = commandCalls.filter(c => c.startsWith('plugin update')).length; manager.installClaude();
+    assert.equal(commandCalls.filter(c => c.startsWith('plugin update')).length, before);
+    console.log('Automatic context protocol, fail-open safety and stale-plugin upgrade passed.');
+  } finally { fs.rmSync(root, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 }); }
+}
+main().catch(error => { console.error(error); process.exitCode = 1; });