@sanqianx/project-knowledge 5.0.23 → 5.0.25

package/_site/_test/mcp-server-test.js

@@ -1,149 +1,149 @@
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { spawn, spawnSync } = require('child_process');
-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 { ConversationStore } = require('../lib/conversation-store');
-const { KnowledgeDatabase } = require('../lib/knowledge-db');
-const { EMBEDDING_DIMENSIONS } = require('../lib/knowledge-schema');
-
-const ROOT = path.resolve(__dirname, '..', '..');
-const MCP_BIN = path.join(ROOT, 'bin', 'project-knowledge-mcp.js');
-const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'pkb-mcp-v2-'));
-const dataDir = path.join(temp, 'data');
-const repo = path.join(temp, 'repo');
-const vectorRepo = path.join(temp, 'vector-repo');
-const markdownKb = path.join(temp, 'knowledge-markdown');
-const vectorKb = path.join(temp, 'knowledge-vector');
-
-function write(filePath, content) {
-  fs.mkdirSync(path.dirname(filePath), { recursive: true });
-  fs.writeFileSync(filePath, content, 'utf8');
-}
-
-function git(cwd, args) {
-  const result = spawnSync('git', args, { cwd, encoding: 'utf8' });
-  assert.strictEqual(result.status, 0, result.stderr);
-  return String(result.stdout || '').trim();
-}
-
-function fakeVector(text) {
-  const vector = new Array(EMBEDDING_DIMENSIONS).fill(0);
-  for (let index = 0; index < String(text).length; index += 1) vector[String(text).charCodeAt(index) % vector.length] += 1;
-  const norm = Math.sqrt(vector.reduce((sum, item) => sum + item * item, 0)) || 1;
-  return vector.map(item => item / norm);
-}
-
-async function createMcpClient() {
-  const child = spawn(process.execPath, [MCP_BIN], {
-    cwd: repo,
-    env: { ...process.env, KB_DATA_DIR: dataDir, KB_SKIP_MIGRATION: '1', KB_EMBEDDING_FAKE: '1' },
-    stdio: ['pipe', 'pipe', 'pipe'],
-    windowsHide: true,
-  });
-  let stderr = '';
-  let buffer = '';
-  let nextId = 1;
-  const pending = new Map();
-  child.stderr.on('data', chunk => { stderr += chunk; });
-  child.stdout.on('data', chunk => {
-    buffer += chunk;
-    let newline;
-    while ((newline = buffer.indexOf('\n')) >= 0) {
-      const line = buffer.slice(0, newline).trim();
-      buffer = buffer.slice(newline + 1);
-      if (!line) continue;
-      const message = JSON.parse(line);
-      const entry = pending.get(message.id);
-      if (entry) { entry(message); pending.delete(message.id); }
-    }
-  });
-  const request = (method, params = {}) => new Promise((resolve, reject) => {
-    const id = nextId++;
-    const timer = setTimeout(() => { pending.delete(id); reject(new Error(`MCP timeout: ${method}\n${stderr}`)); }, 15_000);
-    pending.set(id, message => { clearTimeout(timer); resolve(message); });
-    child.stdin.write(`${JSON.stringify({ jsonrpc: '2.0', id, method, params })}\n`);
-  });
-  await request('initialize', { protocolVersion: '2025-03-26', capabilities: {}, clientInfo: { name: 'test', version: '1' } });
-  child.stdin.write(`${JSON.stringify({ jsonrpc: '2.0', method: 'notifications/initialized', params: {} })}\n`);
-  return { child, request, stderr: () => stderr };
-}
-
-(async () => {
-  for (const cwd of [repo, vectorRepo]) {
-    fs.mkdirSync(cwd, { recursive: true });
-    git(cwd, ['init', '--initial-branch=main']);
-    git(cwd, ['config', 'user.email', 'mcp@example.test']);
-    git(cwd, ['config', 'user.name', 'MCP Test']);
-    write(path.join(cwd, 'README.md'), '# source\n');
-    git(cwd, ['add', 'README.md']);
-    git(cwd, ['commit', '-m', 'baseline']);
-  }
-  write(path.join(markdownKb, 'README.md'), '# Demo knowledge\n\nThis project uses rotating refresh tokens.\n');
-  write(path.join(markdownKb, 'modules', 'auth.md'), '# Authentication\n\nRefresh tokens rotate after every successful renewal.\n');
-  write(path.join(markdownKb, 'changes', 'auth.md'), '# Authentication update\n\nIntroduced rotating refresh tokens.\n');
-  write(path.join(vectorKb, 'modules', 'payments.md'), '# Payment tokens\n\nPayment tokens expire after fifteen minutes.\n');
-
-  const layout = new StorageLayout({ dataDir });
-  const settingsStore = new SettingsStore({ layout });
-  const registryStore = new ProjectRegistryStore({ layout });
-  const projectStore = new ProjectStore({ layout });
-  await settingsStore.initialize({ knowledge: { rootPath: path.join(temp, 'future-root') } });
-  await registryStore.initialize();
-  await projectStore.create('project-demo', { displayName: 'Demo', storageName: 'demo', repoPath: repo, knowledgePath: markdownKb, legacyExtensions: { slug: 'demo' } }, { trackingStartCommit: git(repo, ['rev-parse', 'HEAD']), index: { dirty: true, generation: 1 } });
-  await registryStore.add('project-demo', { displayNameSnapshot: 'Demo' });
-  await projectStore.create('project-vector', { displayName: 'Vector', storageName: 'vector', repoPath: vectorRepo, knowledgePath: vectorKb, legacyExtensions: { slug: 'vector' } }, { trackingStartCommit: git(vectorRepo, ['rev-parse', 'HEAD']) });
-  await registryStore.add('project-vector', { displayNameSnapshot: 'Vector' });
-
-  const database = new KnowledgeDatabase({ dbPath: layout.getIndexPath(), maintenancePath: layout.getRuntimePath('index-maintenance.json') });
-  await database.replaceEntry('project:project-vector', 'modules/payments.md', [{ chunkOrder: 0, title: 'Payment tokens', chunkText: 'Payment tokens expire after fifteen minutes.', vector: fakeVector('payment tokens'), sourceCommit: 'abc123' }]);
-  await database.ensureSearchIndexes();
-  await database.close();
-
-  const client = await createMcpClient();
-  try {
-    const listed = await client.request('tools/list');
-    assert.strictEqual(listed.result.tools.length, 6);
-    assert(listed.result.tools.some(tool => tool.name === 'project_knowledge_record_requirement'));
-
-    let response = await client.request('tools/call', { name: 'project_knowledge_resolve', arguments: { repoPath: repo } });
-    assert.strictEqual(response.result.structuredContent.projectId, 'project-demo');
-    assert.strictEqual(response.result.structuredContent.knowledgePath, markdownKb);
-    assert.strictEqual(response.result.structuredContent.indexPath, layout.getVectorRootPath(settingsStore.read()));
-
-    response = await client.request('tools/call', { name: 'project_knowledge_search', arguments: { projectId: 'project-demo', query: 'refresh tokens' } });
-    assert.strictEqual(response.result.structuredContent.source, 'knowledge-retrieval-service');
-    assert.strictEqual(response.result.structuredContent.backend, 'hybrid+markdown-truth');
-    assert.strictEqual(response.result.structuredContent.health.scopes[0].dirty, true);
-    assert(response.result.structuredContent.results.some(result => result.entry_id === 'modules/auth.md'));
-
-    response = await client.request('tools/call', { name: 'project_knowledge_search', arguments: { project: 'vector', query: 'payment tokens' } });
-    assert.strictEqual(response.result.structuredContent.source, 'knowledge-retrieval-service');
-    assert.strictEqual(response.result.structuredContent.backend, 'hybrid+markdown-truth');
-    assert(response.result.structuredContent.results.some(result => result.entry_id === 'modules/payments.md'));
-
-    response = await client.request('tools/call', { name: 'project_knowledge_get', arguments: { projectId: 'project-demo', entry: 'modules/auth.md' } });
-    assert.match(response.result.structuredContent.chunks[0].chunk_text, /rotate/i);
-    response = await client.request('tools/call', { name: 'project_knowledge_history', arguments: { projectId: 'project-demo' } });
-    assert.strictEqual(response.result.structuredContent.results[0].entry_id, 'changes/auth.md');
-
-    const stateBefore = fs.readFileSync(layout.getProjectStatePath('project-demo'), 'utf8');
-    response = await client.request('tools/call', { name: 'project_knowledge_record_requirement', arguments: { projectId: 'project-demo', repoPath: repo, client: 'codex', sessionId: 'session-mcp', text: 'Keep refresh token rotation documented.' } });
-    assert.strictEqual(response.result.structuredContent.projectId, 'project-demo');
-    assert.strictEqual(new ConversationStore({ layout, projectStore }).readEvents('project-demo').length, 1);
-    assert.strictEqual(fs.existsSync(layout.getProjectRequirementsPath('project-demo')), false, 'explicit MCP adapter must not create legacy requirements.jsonl');
-    assert.strictEqual(fs.readFileSync(layout.getProjectStatePath('project-demo'), 'utf8'), stateBefore, 'requirement tool must not trigger analysis or mutate state');
-    assert(!fs.existsSync(layout.getRuntimePath('staging')));
-
-    response = await client.request('tools/call', { name: 'project_knowledge_get', arguments: { projectId: 'project-demo', entry: '../settings.json' } });
-    assert.strictEqual(response.result.isError, true);
-    console.log('mcp-server-test PASS');
-  } finally {
-    client.child.stdin.end();
-    await new Promise(resolve => client.child.once('exit', resolve));
-  }
-})().catch(error => { console.error(error); process.exitCode = 1; }).finally(() => fs.rmSync(temp, { recursive: true, force: true }));
+const assert = require('assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawn, spawnSync } = require('child_process');
+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 { ConversationStore } = require('../lib/conversation-store');
+const { KnowledgeDatabase } = require('../lib/knowledge-db');
+const { EMBEDDING_DIMENSIONS } = require('../lib/knowledge-schema');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const MCP_BIN = path.join(ROOT, 'bin', 'project-knowledge-mcp.js');
+const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'pkb-mcp-v2-'));
+const dataDir = path.join(temp, 'data');
+const repo = path.join(temp, 'repo');
+const vectorRepo = path.join(temp, 'vector-repo');
+const markdownKb = path.join(temp, 'knowledge-markdown');
+const vectorKb = path.join(temp, 'knowledge-vector');
+
+function write(filePath, content) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, content, 'utf8');
+}
+
+function git(cwd, args) {
+  const result = spawnSync('git', args, { cwd, encoding: 'utf8' });
+  assert.strictEqual(result.status, 0, result.stderr);
+  return String(result.stdout || '').trim();
+}
+
+function fakeVector(text) {
+  const vector = new Array(EMBEDDING_DIMENSIONS).fill(0);
+  for (let index = 0; index < String(text).length; index += 1) vector[String(text).charCodeAt(index) % vector.length] += 1;
+  const norm = Math.sqrt(vector.reduce((sum, item) => sum + item * item, 0)) || 1;
+  return vector.map(item => item / norm);
+}
+
+async function createMcpClient() {
+  const child = spawn(process.execPath, [MCP_BIN], {
+    cwd: repo,
+    env: { ...process.env, KB_DATA_DIR: dataDir, KB_SKIP_MIGRATION: '1', KB_EMBEDDING_FAKE: '1' },
+    stdio: ['pipe', 'pipe', 'pipe'],
+    windowsHide: true,
+  });
+  let stderr = '';
+  let buffer = '';
+  let nextId = 1;
+  const pending = new Map();
+  child.stderr.on('data', chunk => { stderr += chunk; });
+  child.stdout.on('data', chunk => {
+    buffer += chunk;
+    let newline;
+    while ((newline = buffer.indexOf('\n')) >= 0) {
+      const line = buffer.slice(0, newline).trim();
+      buffer = buffer.slice(newline + 1);
+      if (!line) continue;
+      const message = JSON.parse(line);
+      const entry = pending.get(message.id);
+      if (entry) { entry(message); pending.delete(message.id); }
+    }
+  });
+  const request = (method, params = {}) => new Promise((resolve, reject) => {
+    const id = nextId++;
+    const timer = setTimeout(() => { pending.delete(id); reject(new Error(`MCP timeout: ${method}\n${stderr}`)); }, 15_000);
+    pending.set(id, message => { clearTimeout(timer); resolve(message); });
+    child.stdin.write(`${JSON.stringify({ jsonrpc: '2.0', id, method, params })}\n`);
+  });
+  await request('initialize', { protocolVersion: '2025-03-26', capabilities: {}, clientInfo: { name: 'test', version: '1' } });
+  child.stdin.write(`${JSON.stringify({ jsonrpc: '2.0', method: 'notifications/initialized', params: {} })}\n`);
+  return { child, request, stderr: () => stderr };
+}
+
+(async () => {
+  for (const cwd of [repo, vectorRepo]) {
+    fs.mkdirSync(cwd, { recursive: true });
+    git(cwd, ['init', '--initial-branch=main']);
+    git(cwd, ['config', 'user.email', 'mcp@example.test']);
+    git(cwd, ['config', 'user.name', 'MCP Test']);
+    write(path.join(cwd, 'README.md'), '# source\n');
+    git(cwd, ['add', 'README.md']);
+    git(cwd, ['commit', '-m', 'baseline']);
+  }
+  write(path.join(markdownKb, 'README.md'), '# Demo knowledge\n\nThis project uses rotating refresh tokens.\n');
+  write(path.join(markdownKb, 'modules', 'auth.md'), '# Authentication\n\nRefresh tokens rotate after every successful renewal.\n');
+  write(path.join(markdownKb, 'changes', 'auth.md'), '# Authentication update\n\nIntroduced rotating refresh tokens.\n');
+  write(path.join(vectorKb, 'modules', 'payments.md'), '# Payment tokens\n\nPayment tokens expire after fifteen minutes.\n');
+
+  const layout = new StorageLayout({ dataDir });
+  const settingsStore = new SettingsStore({ layout });
+  const registryStore = new ProjectRegistryStore({ layout });
+  const projectStore = new ProjectStore({ layout });
+  await settingsStore.initialize({ knowledge: { rootPath: path.join(temp, 'future-root') } });
+  await registryStore.initialize();
+  await projectStore.create('project-demo', { displayName: 'Demo', storageName: 'demo', repoPath: repo, knowledgePath: markdownKb, legacyExtensions: { slug: 'demo' } }, { trackingStartCommit: git(repo, ['rev-parse', 'HEAD']), index: { dirty: true, generation: 1 } });
+  await registryStore.add('project-demo', { displayNameSnapshot: 'Demo' });
+  await projectStore.create('project-vector', { displayName: 'Vector', storageName: 'vector', repoPath: vectorRepo, knowledgePath: vectorKb, legacyExtensions: { slug: 'vector' } }, { trackingStartCommit: git(vectorRepo, ['rev-parse', 'HEAD']) });
+  await registryStore.add('project-vector', { displayNameSnapshot: 'Vector' });
+
+  const database = new KnowledgeDatabase({ dbPath: layout.getIndexPath(), maintenancePath: layout.getRuntimePath('index-maintenance.json') });
+  await database.replaceEntry('project:project-vector', 'modules/payments.md', [{ chunkOrder: 0, title: 'Payment tokens', chunkText: 'Payment tokens expire after fifteen minutes.', vector: fakeVector('payment tokens'), sourceCommit: 'abc123' }]);
+  await database.ensureSearchIndexes();
+  await database.close();
+
+  const client = await createMcpClient();
+  try {
+    const listed = await client.request('tools/list');
+    assert.strictEqual(listed.result.tools.length, 6);
+    assert(listed.result.tools.some(tool => tool.name === 'project_knowledge_record_requirement'));
+
+    let response = await client.request('tools/call', { name: 'project_knowledge_resolve', arguments: { repoPath: repo } });
+    assert.strictEqual(response.result.structuredContent.projectId, 'project-demo');
+    assert.strictEqual(response.result.structuredContent.knowledgePath, markdownKb);
+    assert.strictEqual(response.result.structuredContent.indexPath, layout.getVectorRootPath(settingsStore.read()));
+
+    response = await client.request('tools/call', { name: 'project_knowledge_search', arguments: { projectId: 'project-demo', query: 'refresh tokens' } });
+    assert.strictEqual(response.result.structuredContent.source, 'knowledge-retrieval-service');
+    assert.strictEqual(response.result.structuredContent.backend, 'hybrid+markdown-truth');
+    assert.strictEqual(response.result.structuredContent.health.scopes[0].dirty, true);
+    assert(response.result.structuredContent.results.some(result => result.entry_id === 'modules/auth.md'));
+
+    response = await client.request('tools/call', { name: 'project_knowledge_search', arguments: { project: 'vector', query: 'payment tokens' } });
+    assert.strictEqual(response.result.structuredContent.source, 'knowledge-retrieval-service');
+    assert.strictEqual(response.result.structuredContent.backend, 'hybrid+markdown-truth');
+    assert(response.result.structuredContent.results.some(result => result.entry_id === 'modules/payments.md'));
+
+    response = await client.request('tools/call', { name: 'project_knowledge_get', arguments: { projectId: 'project-demo', entry: 'modules/auth.md' } });
+    assert.match(response.result.structuredContent.chunks[0].chunk_text, /rotate/i);
+    response = await client.request('tools/call', { name: 'project_knowledge_history', arguments: { projectId: 'project-demo' } });
+    assert.strictEqual(response.result.structuredContent.results[0].entry_id, 'changes/auth.md');
+
+    const stateBefore = fs.readFileSync(layout.getProjectStatePath('project-demo'), 'utf8');
+    response = await client.request('tools/call', { name: 'project_knowledge_record_requirement', arguments: { projectId: 'project-demo', repoPath: repo, client: 'codex', sessionId: 'session-mcp', text: 'Keep refresh token rotation documented.' } });
+    assert.strictEqual(response.result.structuredContent.projectId, 'project-demo');
+    assert.strictEqual(new ConversationStore({ layout, projectStore }).readEvents('project-demo').length, 1);
+    assert.strictEqual(fs.existsSync(layout.getProjectRequirementsPath('project-demo')), false, 'explicit MCP adapter must not create legacy requirements.jsonl');
+    assert.strictEqual(fs.readFileSync(layout.getProjectStatePath('project-demo'), 'utf8'), stateBefore, 'requirement tool must not trigger analysis or mutate state');
+    assert(!fs.existsSync(layout.getRuntimePath('staging')));
+
+    response = await client.request('tools/call', { name: 'project_knowledge_get', arguments: { projectId: 'project-demo', entry: '../settings.json' } });
+    assert.strictEqual(response.result.isError, true);
+    console.log('mcp-server-test PASS');
+  } finally {
+    client.child.stdin.end();
+    await new Promise(resolve => client.child.once('exit', resolve));
+  }
+})().catch(error => { console.error(error); process.exitCode = 1; }).finally(() => fs.rmSync(temp, { recursive: true, force: true }));

package/_site/_test/model-context-windows-test.js

@@ -1,89 +1,89 @@
-// Tests for model-context-windows: lookup table + resolution priority chain.
-//   profile.contextWindow (explicit override)
-//     → model name table (anthropic / minimax / glm / gpt / deepseek / qwen / gemini)
-//       → CLAUDE_CONTEXT_WINDOW env
-//         → 200000 fallback
-
-const { lookupContextWindow, resolveContextWindow } = require('../lib/model-context-windows');
-
-function assert(cond, msg) { if (!cond) throw new Error(msg); }
-
-(() => {
-  try {
-    // ---- lookupContextWindow: family prefix matching ----
-    assert(lookupContextWindow('claude-opus-4-7') === 200000, 'claude-opus-4-7 → 200000');
-    assert(lookupContextWindow('claude-sonnet-4-6') === 200000, 'claude-sonnet-4-6 → 200000');
-    assert(lookupContextWindow('claude-haiku-4-5') === 200000, 'claude-haiku-4-5 → 200000');
-    assert(lookupContextWindow('claude-3-5-sonnet-20241022') === 200000, 'claude-3-5 → 200000');
-
-    assert(lookupContextWindow('glm-5.2') === 1048576, 'glm-5.2 → 1M');
-    assert(lookupContextWindow('GLM-4.6') === 1048576, 'GLM-4.6 (uppercase) → 1M');
-    assert(lookupContextWindow('glm-4.5-air') === 128000, 'glm-4.5-air → 128000');
-    assert(lookupContextWindow('glm-4-plus') === 128000, 'glm-4-plus → 128000');
-
-    assert(lookupContextWindow('MiniMax-M3') === 1048576, 'MiniMax-M3 → 1M');
-    assert(lookupContextWindow('minimax-m2') === 1048576, 'minimax-m2 → 1M');
-
-    assert(lookupContextWindow('gpt-5-mini') === 200000, 'gpt-5-mini → 200000');
-    assert(lookupContextWindow('gpt-4o-2024-08-06') === 128000, 'gpt-4o → 128000');
-    assert(lookupContextWindow('gpt-4.1-2025-04-14') === 1047576, 'gpt-4.1 → 1047576');
-
-    assert(lookupContextWindow('deepseek-v3') === 128000, 'deepseek-v3 → 128000');
-    assert(lookupContextWindow('deepseek-r1') === 128000, 'deepseek-r1 → 128000');
-
-    assert(lookupContextWindow('qwen3-coder') === 131072, 'qwen3 → 131072');
-    assert(lookupContextWindow('gemini-2.5-pro') === 1048576, 'gemini-2.5 → 1M');
-
-    assert(lookupContextWindow('totally-unknown-model') === null, 'unknown → null');
-    assert(lookupContextWindow('') === null, 'empty → null');
-    assert(lookupContextWindow(null) === null, 'null → null');
-    assert(lookupContextWindow(undefined) === null, 'undefined → null');
-
-    // ---- resolveContextWindow: priority chain ----
-
-    // 1. profile.contextWindow wins over everything
-    assert(resolveContextWindow({ profileContextWindow: 500000, model: 'claude-opus-4' }) === 500000,
-      'explicit profileContextWindow must override table');
-
-    // 2. table wins when profile is empty
-    assert(resolveContextWindow({ model: 'glm-5.2' }) === 1048576,
-      'table hit should be used when profileContextWindow empty');
-
-    // 3. env wins when profile + table both miss
-    assert(resolveContextWindow({ model: 'unknown-model', env: { CLAUDE_CONTEXT_WINDOW: '99999' } }) === 99999,
-      'env should be used when table misses');
-
-    // 4. fallback (200000 default) when nothing matches
-    assert(resolveContextWindow({ model: 'unknown-model' }) === 200000,
-      'default fallback should be 200000');
-
-    // 5. profile.contextWindow = 0 / negative treated as unset
-    assert(resolveContextWindow({ profileContextWindow: 0, model: 'glm-5.2' }) === 1048576,
-      'profileContextWindow=0 should fall through to table');
-    assert(resolveContextWindow({ profileContextWindow: -1, model: 'glm-5.2' }) === 1048576,
-      'negative profileContextWindow should fall through to table');
-
-    // 6. non-finite profileContextWindow (NaN, string) ignored
-    assert(resolveContextWindow({ profileContextWindow: NaN, model: 'minimax-m3' }) === 1048576,
-      'NaN profileContextWindow should fall through');
-    assert(resolveContextWindow({ profileContextWindow: 'abc', model: 'minimax-m3' }) === 1048576,
-      'non-numeric string profileContextWindow should fall through');
-
-    // 7. custom fallback honored when nothing else matches
-    assert(resolveContextWindow({ model: 'unknown', fallback: 12345 }) === 12345,
-      'custom fallback should be respected');
-
-    // 8. no args at all → fallback
-    assert(resolveContextWindow() === 200000,
-      'no-args call should hit default fallback');
-
-    // 9. fractional context window floored
-    assert(resolveContextWindow({ profileContextWindow: 123456.789, model: 'x' }) === 123456,
-      'fractional contextWindow should be floored');
-
-    console.log('model-context-windows test passed');
-  } catch (e) {
-    console.error('model-context-windows test failed:', e.message);
-    process.exitCode = 1;
-  }
-})();
+// Tests for model-context-windows: lookup table + resolution priority chain.
+//   profile.contextWindow (explicit override)
+//     → model name table (anthropic / minimax / glm / gpt / deepseek / qwen / gemini)
+//       → CLAUDE_CONTEXT_WINDOW env
+//         → 200000 fallback
+
+const { lookupContextWindow, resolveContextWindow } = require('../lib/model-context-windows');
+
+function assert(cond, msg) { if (!cond) throw new Error(msg); }
+
+(() => {
+  try {
+    // ---- lookupContextWindow: family prefix matching ----
+    assert(lookupContextWindow('claude-opus-4-7') === 200000, 'claude-opus-4-7 → 200000');
+    assert(lookupContextWindow('claude-sonnet-4-6') === 200000, 'claude-sonnet-4-6 → 200000');
+    assert(lookupContextWindow('claude-haiku-4-5') === 200000, 'claude-haiku-4-5 → 200000');
+    assert(lookupContextWindow('claude-3-5-sonnet-20241022') === 200000, 'claude-3-5 → 200000');
+
+    assert(lookupContextWindow('glm-5.2') === 1048576, 'glm-5.2 → 1M');
+    assert(lookupContextWindow('GLM-4.6') === 1048576, 'GLM-4.6 (uppercase) → 1M');
+    assert(lookupContextWindow('glm-4.5-air') === 128000, 'glm-4.5-air → 128000');
+    assert(lookupContextWindow('glm-4-plus') === 128000, 'glm-4-plus → 128000');
+
+    assert(lookupContextWindow('MiniMax-M3') === 1048576, 'MiniMax-M3 → 1M');
+    assert(lookupContextWindow('minimax-m2') === 1048576, 'minimax-m2 → 1M');
+
+    assert(lookupContextWindow('gpt-5-mini') === 200000, 'gpt-5-mini → 200000');
+    assert(lookupContextWindow('gpt-4o-2024-08-06') === 128000, 'gpt-4o → 128000');
+    assert(lookupContextWindow('gpt-4.1-2025-04-14') === 1047576, 'gpt-4.1 → 1047576');
+
+    assert(lookupContextWindow('deepseek-v3') === 128000, 'deepseek-v3 → 128000');
+    assert(lookupContextWindow('deepseek-r1') === 128000, 'deepseek-r1 → 128000');
+
+    assert(lookupContextWindow('qwen3-coder') === 131072, 'qwen3 → 131072');
+    assert(lookupContextWindow('gemini-2.5-pro') === 1048576, 'gemini-2.5 → 1M');
+
+    assert(lookupContextWindow('totally-unknown-model') === null, 'unknown → null');
+    assert(lookupContextWindow('') === null, 'empty → null');
+    assert(lookupContextWindow(null) === null, 'null → null');
+    assert(lookupContextWindow(undefined) === null, 'undefined → null');
+
+    // ---- resolveContextWindow: priority chain ----
+
+    // 1. profile.contextWindow wins over everything
+    assert(resolveContextWindow({ profileContextWindow: 500000, model: 'claude-opus-4' }) === 500000,
+      'explicit profileContextWindow must override table');
+
+    // 2. table wins when profile is empty
+    assert(resolveContextWindow({ model: 'glm-5.2' }) === 1048576,
+      'table hit should be used when profileContextWindow empty');
+
+    // 3. env wins when profile + table both miss
+    assert(resolveContextWindow({ model: 'unknown-model', env: { CLAUDE_CONTEXT_WINDOW: '99999' } }) === 99999,
+      'env should be used when table misses');
+
+    // 4. fallback (200000 default) when nothing matches
+    assert(resolveContextWindow({ model: 'unknown-model' }) === 200000,
+      'default fallback should be 200000');
+
+    // 5. profile.contextWindow = 0 / negative treated as unset
+    assert(resolveContextWindow({ profileContextWindow: 0, model: 'glm-5.2' }) === 1048576,
+      'profileContextWindow=0 should fall through to table');
+    assert(resolveContextWindow({ profileContextWindow: -1, model: 'glm-5.2' }) === 1048576,
+      'negative profileContextWindow should fall through to table');
+
+    // 6. non-finite profileContextWindow (NaN, string) ignored
+    assert(resolveContextWindow({ profileContextWindow: NaN, model: 'minimax-m3' }) === 1048576,
+      'NaN profileContextWindow should fall through');
+    assert(resolveContextWindow({ profileContextWindow: 'abc', model: 'minimax-m3' }) === 1048576,
+      'non-numeric string profileContextWindow should fall through');
+
+    // 7. custom fallback honored when nothing else matches
+    assert(resolveContextWindow({ model: 'unknown', fallback: 12345 }) === 12345,
+      'custom fallback should be respected');
+
+    // 8. no args at all → fallback
+    assert(resolveContextWindow() === 200000,
+      'no-args call should hit default fallback');
+
+    // 9. fractional context window floored
+    assert(resolveContextWindow({ profileContextWindow: 123456.789, model: 'x' }) === 123456,
+      'fractional contextWindow should be floored');
+
+    console.log('model-context-windows test passed');
+  } catch (e) {
+    console.error('model-context-windows test failed:', e.message);
+    process.exitCode = 1;
+  }
+})();

package/_site/_test/module-agent-start-proxy-test.js

@@ -1,65 +1,65 @@
-'use strict';
-const assert = require('node:assert/strict');
-const http = require('node:http');
-const { Readable } = require('node:stream');
-const { EventEmitter } = require('node:events');
-const { ModuleBridge } = require('../lib/module-bridge');
-
-async function budget(method, pathname) {
-  const timers = [], originalTimer = global.setTimeout, originalFetch = global.fetch;
-  const req = Readable.from([]); req.method = method; req.headers = {};
-  const res = new EventEmitter();
-  res.writeHead = () => {}; res.end = () => { res.writableEnded = true; };
-  try {
-    global.setTimeout = (fn, ms, ...args) => { timers.push(ms); return originalTimer(fn, ms, ...args); };
-    global.fetch = async () => new Response('{}', { headers: { 'Content-Type': 'application/json' } });
-    await new ModuleBridge().proxy(req, res, 'http://127.0.0.1:5760' + pathname);
-    return timers[0];
-  } finally { global.setTimeout = originalTimer; global.fetch = originalFetch; }
-}
-
-(async () => {
-  const upstream = http.createServer((req, res) => {
-    const timer = setTimeout(() => { res.writeHead(200, { 'Content-Type': 'application/json' }); res.end('{"accepted":true}'); }, 11000);
-    res.on('close', () => clearTimeout(timer));
-  });
-  await new Promise(resolve => upstream.listen(0, '127.0.0.1', resolve));
-  const bridge = new ModuleBridge();
-  const target = `http://127.0.0.1:${upstream.address().port}/api/claude-workbench/v1/sessions/cold-client/input`;
-  const shell = http.createServer((req, res) => bridge.proxy(req, res, target));
-  await new Promise(resolve => shell.listen(0, '127.0.0.1', resolve));
-  try {
-    const response = await fetch(`http://127.0.0.1:${shell.address().port}/send`, { method: 'POST', body: '{}' });
-    assert.equal(response.status, 200, 'cold native client startup must not be reported as unreachable after ten seconds');
-    assert.equal((await response.json()).accepted, true);
-  } finally {
-    for (const server of [shell, upstream]) { server.closeAllConnections(); await new Promise(resolve => server.close(resolve)); }
-  }
-  assert.equal(await budget('POST', '/api/claude-workbench/v1/sessions'), 90000);
-  assert.equal(await budget('POST', '/api/claude-workbench/v1/sessions/cold-client/input?scope=project'), 90000);
-  for (const [method, route] of [
-    ['GET', '/api/claude-workbench/v1/sessions'],
-    ['POST', '/api/claude-workbench/v1/sessions/cold-client/abort'],
-    ['POST', '/api/claude-workbench/v1/sessions/cold-client/permission'],
-    ['POST', '/api/engine/runs'],
-    ['POST', '/api/sessions/cold-client/input'],
-  ]) assert.equal(await budget(method, route), 10000, 'unrelated APIs must keep their ordinary timeout');
-  assert.equal(await budget('POST', '/api/claude-workbench/v1/system/pick-folder'), 600000);
-  const originalFetch = global.fetch;
-  let warning, failure;
-  const request = Readable.from([]); request.method = 'GET'; request.headers = {};
-  const response = new EventEmitter(); response.writeHead = () => {};
-  response.end = bytes => { response.writableEnded = true; failure = JSON.parse(bytes); };
-  try {
-    global.fetch = async () => { throw new Error('upstream leaked credential: secret-proxy-fixture'); };
-    const safeBridge = new ModuleBridge({ logger: { warn(...args) { warning = args; } } });
-    await safeBridge.proxy(request, response, 'http://127.0.0.1:5760/api/health?apiKey=secret-proxy-fixture');
-    assert.equal(failure.error, 'MODULE_UNREACHABLE');
-    assert.equal(failure.details.failureKind, 'NETWORK_ERROR');
-    assert.equal(failure.details.timeoutMs, 10000);
-    assert.equal(warning[0], 'module.proxy.failed');
-    assert.equal(warning[2].context.path, '/api/health');
-    assert.ok(!JSON.stringify([failure, warning]).includes('secret-proxy-fixture'), 'diagnostics omit queries, raw errors and credentials');
-  } finally { global.fetch = originalFetch; }
-  console.log('module-agent-start-proxy-test PASS');
-})().catch(error => { console.error(error); process.exitCode = 1; });
+'use strict';
+const assert = require('node:assert/strict');
+const http = require('node:http');
+const { Readable } = require('node:stream');
+const { EventEmitter } = require('node:events');
+const { ModuleBridge } = require('../lib/module-bridge');
+
+async function budget(method, pathname) {
+  const timers = [], originalTimer = global.setTimeout, originalFetch = global.fetch;
+  const req = Readable.from([]); req.method = method; req.headers = {};
+  const res = new EventEmitter();
+  res.writeHead = () => {}; res.end = () => { res.writableEnded = true; };
+  try {
+    global.setTimeout = (fn, ms, ...args) => { timers.push(ms); return originalTimer(fn, ms, ...args); };
+    global.fetch = async () => new Response('{}', { headers: { 'Content-Type': 'application/json' } });
+    await new ModuleBridge().proxy(req, res, 'http://127.0.0.1:5760' + pathname);
+    return timers[0];
+  } finally { global.setTimeout = originalTimer; global.fetch = originalFetch; }
+}
+
+(async () => {
+  const upstream = http.createServer((req, res) => {
+    const timer = setTimeout(() => { res.writeHead(200, { 'Content-Type': 'application/json' }); res.end('{"accepted":true}'); }, 11000);
+    res.on('close', () => clearTimeout(timer));
+  });
+  await new Promise(resolve => upstream.listen(0, '127.0.0.1', resolve));
+  const bridge = new ModuleBridge();
+  const target = `http://127.0.0.1:${upstream.address().port}/api/claude-workbench/v1/sessions/cold-client/input`;
+  const shell = http.createServer((req, res) => bridge.proxy(req, res, target));
+  await new Promise(resolve => shell.listen(0, '127.0.0.1', resolve));
+  try {
+    const response = await fetch(`http://127.0.0.1:${shell.address().port}/send`, { method: 'POST', body: '{}' });
+    assert.equal(response.status, 200, 'cold native client startup must not be reported as unreachable after ten seconds');
+    assert.equal((await response.json()).accepted, true);
+  } finally {
+    for (const server of [shell, upstream]) { server.closeAllConnections(); await new Promise(resolve => server.close(resolve)); }
+  }
+  assert.equal(await budget('POST', '/api/claude-workbench/v1/sessions'), 90000);
+  assert.equal(await budget('POST', '/api/claude-workbench/v1/sessions/cold-client/input?scope=project'), 90000);
+  for (const [method, route] of [
+    ['GET', '/api/claude-workbench/v1/sessions'],
+    ['POST', '/api/claude-workbench/v1/sessions/cold-client/abort'],
+    ['POST', '/api/claude-workbench/v1/sessions/cold-client/permission'],
+    ['POST', '/api/engine/runs'],
+    ['POST', '/api/sessions/cold-client/input'],
+  ]) assert.equal(await budget(method, route), 10000, 'unrelated APIs must keep their ordinary timeout');
+  assert.equal(await budget('POST', '/api/claude-workbench/v1/system/pick-folder'), 600000);
+  const originalFetch = global.fetch;
+  let warning, failure;
+  const request = Readable.from([]); request.method = 'GET'; request.headers = {};
+  const response = new EventEmitter(); response.writeHead = () => {};
+  response.end = bytes => { response.writableEnded = true; failure = JSON.parse(bytes); };
+  try {
+    global.fetch = async () => { throw new Error('upstream leaked credential: secret-proxy-fixture'); };
+    const safeBridge = new ModuleBridge({ logger: { warn(...args) { warning = args; } } });
+    await safeBridge.proxy(request, response, 'http://127.0.0.1:5760/api/health?apiKey=secret-proxy-fixture');
+    assert.equal(failure.error, 'MODULE_UNREACHABLE');
+    assert.equal(failure.details.failureKind, 'NETWORK_ERROR');
+    assert.equal(failure.details.timeoutMs, 10000);
+    assert.equal(warning[0], 'module.proxy.failed');
+    assert.equal(warning[2].context.path, '/api/health');
+    assert.ok(!JSON.stringify([failure, warning]).includes('secret-proxy-fixture'), 'diagnostics omit queries, raw errors and credentials');
+  } finally { global.fetch = originalFetch; }
+  console.log('module-agent-start-proxy-test PASS');
+})().catch(error => { console.error(error); process.exitCode = 1; });