@sanqianx/project-knowledge 5.0.19 → 5.0.20

package/_site/lib/capture-hook-config.js

@@ -1,108 +1,108 @@
-'use strict';
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const crypto = require('crypto');
-const { writeFileAtomic } = require('./atomic-file');
-
-const EVENTS = ['UserPromptSubmit', 'Stop'];
-function normalized(file) {
-  const value = path.resolve(file).replace(/\\/g, '/');
-  return process.platform === 'win32' ? value.toLowerCase() : value;
-}
-function nodeCommand(command) { return /(?:^|[\\/])node(?:\.exe)?$/i.test(command || ''); }
-
-// Only exact, known Bridge invocations are ours. A shell wrapper, extra
-// argument or a lookalike filename never authorizes removing a user hook.
-function bridgeBinding(args, options) {
-  if (!Array.isArray(args) || typeof args[0] !== 'string' || !nodeCommand(args[0]) || typeof args[1] !== 'string') return '';
-  if (args.length !== 2 && !(args.length === 4 && args[2] === '--source' && ['claude-code', 'claude', 'zcode', 'codex', 'opencode'].includes(args[3]))) return '';
-  const actual = normalized(args[1]);
-  const current = normalized(path.join(options.bridgeHomeDir, 'bin', 'bridge-hook.cjs'));
-  const legacy = normalized(path.join(options.homeDir || os.homedir(), '.ai-coding-event-bridge', 'bin', 'bridge-hook.cjs'));
-  return actual === current ? 'current' : actual === legacy ? 'legacy' : '';
-}
-
-function hookArgs(hook) {
-  if (!hook || typeof hook !== 'object') return null;
-  if (hook.type === 'process' && Array.isArray(hook.args)) return [hook.command, ...hook.args];
-  if (hook.type !== 'command' || typeof hook.command !== 'string') return null;
-  const match = hook.command.trim().match(/^(?:"([^"]+)"|'([^']+)'|(\S+))\s+(?:"([^"]+)"|'([^']+)'|(\S+))(?:\s+--source\s+(claude-code|claude|zcode|codex|opencode))?$/);
-  return match ? [match[1] || match[2] || match[3], match[4] || match[5] || match[6], ...(match[7] ? ['--source', match[7]] : [])] : null;
-}
-
-function configuration(file) {
-  const source = fs.existsSync(file) ? fs.readFileSync(file, 'utf8') : '';
-  let config;
-  try { config = source ? JSON.parse(source) : {}; } catch { throw new Error('Agent 配置不是有效 JSON，未修改。'); }
-  if (!config || typeof config !== 'object' || Array.isArray(config)) throw new Error('Agent 配置必须是 JSON 对象，未修改。');
-  return { source, config };
-}
-
-function planCaptureHooks(file, client, options, removeCurrent = false) {
-  if (!['claude', 'zcode'].includes(client)) throw new Error('不支持的采集配置类型。');
-  const { source, config } = configuration(file);
-  const hooks = config.hooks;
-  if (hooks != null && (typeof hooks !== 'object' || Array.isArray(hooks))) throw new Error('Agent hooks 配置格式异常，未修改。');
-  const events = client === 'zcode' ? hooks?.events : hooks;
-  if (events != null && (typeof events !== 'object' || Array.isArray(events))) throw new Error('Agent 事件配置格式异常，未修改。');
-  const removed = [], counts = {};
-  for (const event of EVENTS) {
-    const groups = events?.[event];
-    if (groups == null) { counts[event] = { current: 0, legacy: 0 }; continue; }
-    if (!Array.isArray(groups)) throw new Error('Agent 事件列表格式异常，未修改。');
-    const count = { current: 0, legacy: 0 };
-    for (const group of groups) {
-      if (group?.hooks != null && !Array.isArray(group.hooks)) throw new Error('Agent Hook 列表格式异常，未修改。');
-      for (const hook of group?.hooks || []) { const binding = bridgeBinding(hookArgs(hook), options); if (binding) count[binding]++; }
-    }
-    counts[event] = count;
-    // Materialize the replacement first; never remove the only working old
-    // capture when installing the new runtime has failed.
-    if (!count.current) continue;
-    let keptCurrent = false;
-    const removedGroup = Symbol('empty-owned-group');
-    events[event] = groups.map((group, groupIndex) => {
-      if (!Array.isArray(group?.hooks)) return group;
-      const kept = group.hooks.filter((hook, hookIndex) => {
-        const binding = bridgeBinding(hookArgs(hook), options);
-        if (!binding) return true;
-        if (removeCurrent && binding === 'legacy') return true;
-        if (!removeCurrent && binding === 'current' && !keptCurrent) { keptCurrent = true; return true; }
-        // Back up only owned invocation fields, never unrelated config/env.
-        const saved = Object.fromEntries(['type', 'command', 'args', 'timeout', 'timeoutMs'].filter(key => hook[key] !== undefined).map(key => [key, hook[key]]));
-        removed.push({ event, groupIndex, hookIndex, hook: saved, binding });
-        return false;
-      });
-      return kept.length === group.hooks.length ? group : kept.length ? { ...group, hooks: kept } : removedGroup;
-    }).filter(group => group !== removedGroup);
-  }
-  return { source, config, counts, removed, repairNeeded: Object.values(counts).some(count => count.legacy > 0 || count.current > 1) };
-}
-
-function writePlan(file, client, plan) {
-  if (!plan.removed.length) return { changed: false, removedLegacy: 0, removedDuplicates: 0 };
-  const assertUnchanged = () => {
-    if (fs.readFileSync(file, 'utf8') !== plan.source) throw Object.assign(new Error('Agent 配置已被其他程序修改，请重试接入。'), { code: 'CONFIG_CHANGED' });
-  };
-  assertUnchanged();
-  const backupFile = `${file}.project-knowledge-capture-${Date.now()}-${crypto.randomBytes(4).toString('hex')}.bak`;
-  writeFileAtomic(backupFile, JSON.stringify({ schema: 'project-knowledge/capture-backup/v1', client, removed: plan.removed }, null, 2) + '\n');
-  const eol = plan.source.includes('\r\n') ? '\r\n' : '\n';
-  writeFileAtomic(file, (JSON.stringify(plan.config, null, 2) + '\n').replace(/\n/g, eol), { beforeRename: assertUnchanged });
-  return { changed: true, backupFile, removedLegacy: plan.removed.filter(row => row.binding === 'legacy').length, removedDuplicates: plan.removed.filter(row => row.binding === 'current').length };
-}
-
-function repairCaptureHooks(file, client, options) {
-  const plan = planCaptureHooks(file, client, options);
-  if (EVENTS.some(event => !plan.counts[event].current)) throw new Error('当前 Bridge 入口未完整建立，保留旧采集接线。');
-  if (!fs.existsSync(path.join(options.bridgeHomeDir, 'bin', 'bridge-hook.cjs'))) throw new Error('当前 Bridge 运行入口缺失，保留旧采集接线。');
-  return writePlan(file, client, plan);
-}
-
-function removeCaptureHooks(file, client, options) {
-  return writePlan(file, client, planCaptureHooks(file, client, options, true));
-}
-
-module.exports = { bridgeBinding, planCaptureHooks, repairCaptureHooks, removeCaptureHooks };
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const crypto = require('crypto');
+const { writeFileAtomic } = require('./atomic-file');
+
+const EVENTS = ['UserPromptSubmit', 'Stop'];
+function normalized(file) {
+  const value = path.resolve(file).replace(/\\/g, '/');
+  return process.platform === 'win32' ? value.toLowerCase() : value;
+}
+function nodeCommand(command) { return /(?:^|[\\/])node(?:\.exe)?$/i.test(command || ''); }
+
+// Only exact, known Bridge invocations are ours. A shell wrapper, extra
+// argument or a lookalike filename never authorizes removing a user hook.
+function bridgeBinding(args, options) {
+  if (!Array.isArray(args) || typeof args[0] !== 'string' || !nodeCommand(args[0]) || typeof args[1] !== 'string') return '';
+  if (args.length !== 2 && !(args.length === 4 && args[2] === '--source' && ['claude-code', 'claude', 'zcode', 'codex', 'opencode'].includes(args[3]))) return '';
+  const actual = normalized(args[1]);
+  const current = normalized(path.join(options.bridgeHomeDir, 'bin', 'bridge-hook.cjs'));
+  const legacy = normalized(path.join(options.homeDir || os.homedir(), '.ai-coding-event-bridge', 'bin', 'bridge-hook.cjs'));
+  return actual === current ? 'current' : actual === legacy ? 'legacy' : '';
+}
+
+function hookArgs(hook) {
+  if (!hook || typeof hook !== 'object') return null;
+  if (hook.type === 'process' && Array.isArray(hook.args)) return [hook.command, ...hook.args];
+  if (hook.type !== 'command' || typeof hook.command !== 'string') return null;
+  const match = hook.command.trim().match(/^(?:"([^"]+)"|'([^']+)'|(\S+))\s+(?:"([^"]+)"|'([^']+)'|(\S+))(?:\s+--source\s+(claude-code|claude|zcode|codex|opencode))?$/);
+  return match ? [match[1] || match[2] || match[3], match[4] || match[5] || match[6], ...(match[7] ? ['--source', match[7]] : [])] : null;
+}
+
+function configuration(file) {
+  const source = fs.existsSync(file) ? fs.readFileSync(file, 'utf8') : '';
+  let config;
+  try { config = source ? JSON.parse(source) : {}; } catch { throw new Error('Agent 配置不是有效 JSON，未修改。'); }
+  if (!config || typeof config !== 'object' || Array.isArray(config)) throw new Error('Agent 配置必须是 JSON 对象，未修改。');
+  return { source, config };
+}
+
+function planCaptureHooks(file, client, options, removeCurrent = false) {
+  if (!['claude', 'zcode'].includes(client)) throw new Error('不支持的采集配置类型。');
+  const { source, config } = configuration(file);
+  const hooks = config.hooks;
+  if (hooks != null && (typeof hooks !== 'object' || Array.isArray(hooks))) throw new Error('Agent hooks 配置格式异常，未修改。');
+  const events = client === 'zcode' ? hooks?.events : hooks;
+  if (events != null && (typeof events !== 'object' || Array.isArray(events))) throw new Error('Agent 事件配置格式异常，未修改。');
+  const removed = [], counts = {};
+  for (const event of EVENTS) {
+    const groups = events?.[event];
+    if (groups == null) { counts[event] = { current: 0, legacy: 0 }; continue; }
+    if (!Array.isArray(groups)) throw new Error('Agent 事件列表格式异常，未修改。');
+    const count = { current: 0, legacy: 0 };
+    for (const group of groups) {
+      if (group?.hooks != null && !Array.isArray(group.hooks)) throw new Error('Agent Hook 列表格式异常，未修改。');
+      for (const hook of group?.hooks || []) { const binding = bridgeBinding(hookArgs(hook), options); if (binding) count[binding]++; }
+    }
+    counts[event] = count;
+    // Materialize the replacement first; never remove the only working old
+    // capture when installing the new runtime has failed.
+    if (!count.current) continue;
+    let keptCurrent = false;
+    const removedGroup = Symbol('empty-owned-group');
+    events[event] = groups.map((group, groupIndex) => {
+      if (!Array.isArray(group?.hooks)) return group;
+      const kept = group.hooks.filter((hook, hookIndex) => {
+        const binding = bridgeBinding(hookArgs(hook), options);
+        if (!binding) return true;
+        if (removeCurrent && binding === 'legacy') return true;
+        if (!removeCurrent && binding === 'current' && !keptCurrent) { keptCurrent = true; return true; }
+        // Back up only owned invocation fields, never unrelated config/env.
+        const saved = Object.fromEntries(['type', 'command', 'args', 'timeout', 'timeoutMs'].filter(key => hook[key] !== undefined).map(key => [key, hook[key]]));
+        removed.push({ event, groupIndex, hookIndex, hook: saved, binding });
+        return false;
+      });
+      return kept.length === group.hooks.length ? group : kept.length ? { ...group, hooks: kept } : removedGroup;
+    }).filter(group => group !== removedGroup);
+  }
+  return { source, config, counts, removed, repairNeeded: Object.values(counts).some(count => count.legacy > 0 || count.current > 1) };
+}
+
+function writePlan(file, client, plan) {
+  if (!plan.removed.length) return { changed: false, removedLegacy: 0, removedDuplicates: 0 };
+  const assertUnchanged = () => {
+    if (fs.readFileSync(file, 'utf8') !== plan.source) throw Object.assign(new Error('Agent 配置已被其他程序修改，请重试接入。'), { code: 'CONFIG_CHANGED' });
+  };
+  assertUnchanged();
+  const backupFile = `${file}.project-knowledge-capture-${Date.now()}-${crypto.randomBytes(4).toString('hex')}.bak`;
+  writeFileAtomic(backupFile, JSON.stringify({ schema: 'project-knowledge/capture-backup/v1', client, removed: plan.removed }, null, 2) + '\n');
+  const eol = plan.source.includes('\r\n') ? '\r\n' : '\n';
+  writeFileAtomic(file, (JSON.stringify(plan.config, null, 2) + '\n').replace(/\n/g, eol), { beforeRename: assertUnchanged });
+  return { changed: true, backupFile, removedLegacy: plan.removed.filter(row => row.binding === 'legacy').length, removedDuplicates: plan.removed.filter(row => row.binding === 'current').length };
+}
+
+function repairCaptureHooks(file, client, options) {
+  const plan = planCaptureHooks(file, client, options);
+  if (EVENTS.some(event => !plan.counts[event].current)) throw new Error('当前 Bridge 入口未完整建立，保留旧采集接线。');
+  if (!fs.existsSync(path.join(options.bridgeHomeDir, 'bin', 'bridge-hook.cjs'))) throw new Error('当前 Bridge 运行入口缺失，保留旧采集接线。');
+  return writePlan(file, client, plan);
+}
+
+function removeCaptureHooks(file, client, options) {
+  return writePlan(file, client, planCaptureHooks(file, client, options, true));
+}
+
+module.exports = { bridgeBinding, planCaptureHooks, repairCaptureHooks, removeCaptureHooks };

package/_site/lib/claude-cli-runner.js

@@ -188,12 +188,12 @@ function toPersistedSession(session) {
     aiProfileId: session.aiProfileId || null,
     claudeSessionId: session.claudeSessionId,
     source: session.source || 'manual',
-    automation: !!session.automation,
-    automationRunId: session.automationRunId || null,
-    metadata: session.metadata || {},
-    legacyProjectSlug: session.legacyProjectSlug || null,
-    legacySource: session.legacySource === true,
-    permissionMode: session.permissionMode || 'default',
+    automation: !!session.automation,
+    automationRunId: session.automationRunId || null,
+    metadata: session.metadata || {},
+    legacyProjectSlug: session.legacyProjectSlug || null,
+    legacySource: session.legacySource === true,
+    permissionMode: session.permissionMode || 'default',
     startedAt: session.startedAt,
     endedAt: session.endedAt,
     exitCode: session.exitCode,
@@ -229,63 +229,63 @@ function readPersistedRecord(file) {
   return null;
 }
 
-function scanPersistedRecords(projectSlug = null) {
-  let projectDirs = [];
-  try {
-    const registry = projectRegistryStore.read({ allowMissing: true });
-    projectDirs = registry.projectOrder
-      .filter(projectId => !projectSlug || projectId === projectSlug)
-      .map(projectId => {
-        const config = projectStore.readConfig(projectId);
-        const legacySlug = config.legacyExtensions && typeof config.legacyExtensions.slug === 'string'
-          ? config.legacyExtensions.slug.trim()
-          : '';
-        return {
-          name: projectId,
-          kbPath: config.knowledgePath,
-          legacySlugs: legacySlug && legacySlug !== projectId ? [legacySlug] : [],
-        };
-      });
-  } catch { return []; }
-  const records = new Map();
-  for (const entry of projectDirs) {
-    const dirs = [
-      { path: storageLayout.getRuntimePath('claude-sessions', entry.name), legacySlug: null },
-      { path: path.join(entry.kbPath, '_ai', WORKBENCH_DIR), legacySlug: null },
-    ];
-    try { dirs.push({ path: path.join(aiWorkspace.projectAIPath(entry.name), WORKBENCH_DIR), legacySlug: null }); } catch {
-      // The legacy workspace location is optional during v2 session discovery.
-    }
-    for (const legacySlug of entry.legacySlugs) {
-      try { dirs.push({ path: path.join(aiWorkspace.projectAIPath(legacySlug), WORKBENCH_DIR), legacySlug }); } catch {
-        // Invalid migration metadata is ignored without hiding canonical v2 sessions.
-      }
-    }
-    const visited = new Set();
-    for (const source of dirs) {
-      const dir = path.resolve(source.path);
-      if (visited.has(dir)) continue;
-      visited.add(dir);
-      let files = [];
-      try { files = fs.readdirSync(dir); } catch { continue; }
-      for (const file of files) {
-        if (!file.endsWith('.json')) continue;
-        const record = readPersistedRecord(path.join(dir, file));
-        if (!record || records.has(record.sessionId)) continue;
-        const acceptedSlugs = new Set([entry.name, ...entry.legacySlugs]);
-        if (record.projectSlug && !acceptedSlugs.has(record.projectSlug)) continue;
-        const originalProjectSlug = record.projectSlug || '';
-        records.set(record.sessionId, {
-          ...record,
-          projectSlug: entry.name,
-          legacyProjectSlug: source.legacySlug || (originalProjectSlug !== entry.name ? originalProjectSlug : '') || record.legacyProjectSlug || null,
-          legacySource: source.legacySlug != null || originalProjectSlug !== entry.name || record.legacySource === true,
-        });
-      }
-    }
-  }
-  return [...records.values()].sort((a, b) => String(b.updatedAt || b.startedAt || '').localeCompare(String(a.updatedAt || a.startedAt || '')));
-}
+function scanPersistedRecords(projectSlug = null) {
+  let projectDirs = [];
+  try {
+    const registry = projectRegistryStore.read({ allowMissing: true });
+    projectDirs = registry.projectOrder
+      .filter(projectId => !projectSlug || projectId === projectSlug)
+      .map(projectId => {
+        const config = projectStore.readConfig(projectId);
+        const legacySlug = config.legacyExtensions && typeof config.legacyExtensions.slug === 'string'
+          ? config.legacyExtensions.slug.trim()
+          : '';
+        return {
+          name: projectId,
+          kbPath: config.knowledgePath,
+          legacySlugs: legacySlug && legacySlug !== projectId ? [legacySlug] : [],
+        };
+      });
+  } catch { return []; }
+  const records = new Map();
+  for (const entry of projectDirs) {
+    const dirs = [
+      { path: storageLayout.getRuntimePath('claude-sessions', entry.name), legacySlug: null },
+      { path: path.join(entry.kbPath, '_ai', WORKBENCH_DIR), legacySlug: null },
+    ];
+    try { dirs.push({ path: path.join(aiWorkspace.projectAIPath(entry.name), WORKBENCH_DIR), legacySlug: null }); } catch {
+      // The legacy workspace location is optional during v2 session discovery.
+    }
+    for (const legacySlug of entry.legacySlugs) {
+      try { dirs.push({ path: path.join(aiWorkspace.projectAIPath(legacySlug), WORKBENCH_DIR), legacySlug }); } catch {
+        // Invalid migration metadata is ignored without hiding canonical v2 sessions.
+      }
+    }
+    const visited = new Set();
+    for (const source of dirs) {
+      const dir = path.resolve(source.path);
+      if (visited.has(dir)) continue;
+      visited.add(dir);
+      let files = [];
+      try { files = fs.readdirSync(dir); } catch { continue; }
+      for (const file of files) {
+        if (!file.endsWith('.json')) continue;
+        const record = readPersistedRecord(path.join(dir, file));
+        if (!record || records.has(record.sessionId)) continue;
+        const acceptedSlugs = new Set([entry.name, ...entry.legacySlugs]);
+        if (record.projectSlug && !acceptedSlugs.has(record.projectSlug)) continue;
+        const originalProjectSlug = record.projectSlug || '';
+        records.set(record.sessionId, {
+          ...record,
+          projectSlug: entry.name,
+          legacyProjectSlug: source.legacySlug || (originalProjectSlug !== entry.name ? originalProjectSlug : '') || record.legacyProjectSlug || null,
+          legacySource: source.legacySlug != null || originalProjectSlug !== entry.name || record.legacySource === true,
+        });
+      }
+    }
+  }
+  return [...records.values()].sort((a, b) => String(b.updatedAt || b.startedAt || '').localeCompare(String(a.updatedAt || a.startedAt || '')));
+}
 
 function findPersistedRecord(sessionId) {
   return scanPersistedRecords().find(record => record.sessionId === sessionId) || null;
@@ -343,13 +343,13 @@ function restoreSessionFromDisk(sessionId) {
     pendingToolApproval: null,
     restored: true,
     historyCleared: !inheritConversation,
-    source: record.source || 'manual',
-    metadata: record.metadata || {},
-    automation: !!record.automation,
-    automationRunId: record.automationRunId || null,
-    legacyProjectSlug: record.legacyProjectSlug || null,
-    legacySource: record.legacySource === true,
-    permissionMode: record.permissionMode || 'default',
+    source: record.source || 'manual',
+    metadata: record.metadata || {},
+    automation: !!record.automation,
+    automationRunId: record.automationRunId || null,
+    legacyProjectSlug: record.legacyProjectSlug || null,
+    legacySource: record.legacySource === true,
+    permissionMode: record.permissionMode || 'default',
     safetyPolicy: null,
   };
   sessions.set(sessionId, session);
@@ -491,12 +491,12 @@ function sessionSummary(s) {
     model: s.model,
     aiProfileId: s.aiProfileId || null,
     claudeSessionId: s.claudeSessionId,
-    source: s.source || 'manual',
-    automation: !!s.automation,
-    automationRunId: s.automationRunId || null,
-    legacyProjectSlug: s.legacyProjectSlug || null,
-    legacySource: s.legacySource === true,
-    permissionMode: s.permissionMode || 'default',
+    source: s.source || 'manual',
+    automation: !!s.automation,
+    automationRunId: s.automationRunId || null,
+    legacyProjectSlug: s.legacyProjectSlug || null,
+    legacySource: s.legacySource === true,
+    permissionMode: s.permissionMode || 'default',
     startedAt: s.startedAt,
     endedAt: s.endedAt,
     exitCode: s.exitCode,
@@ -1325,12 +1325,12 @@ function getState(sessionId) {
     model: s.model,
     aiProfileId: s.aiProfileId || null,
     claudeSessionId: s.claudeSessionId,
-    source: s.source || 'manual',
-    automation: !!s.automation,
-    automationRunId: s.automationRunId || null,
-    legacyProjectSlug: s.legacyProjectSlug || null,
-    legacySource: s.legacySource === true,
-    permissionMode: s.permissionMode || 'default',
+    source: s.source || 'manual',
+    automation: !!s.automation,
+    automationRunId: s.automationRunId || null,
+    legacyProjectSlug: s.legacyProjectSlug || null,
+    legacySource: s.legacySource === true,
+    permissionMode: s.permissionMode || 'default',
     startedAt: s.startedAt,
     endedAt: s.endedAt,
     exitCode: s.exitCode,
@@ -1506,13 +1506,13 @@ function demoteStaleActiveSessions(opts = {}) {
       pendingToolApproval: null,
       restored: true,
       historyCleared: true,
-      source: record.source || 'manual',
-      metadata: record.metadata || {},
-      automation: !!record.automation,
-      automationRunId: record.automationRunId || null,
-      legacyProjectSlug: record.legacyProjectSlug || null,
-      legacySource: record.legacySource === true,
-      permissionMode: record.permissionMode || 'default',
+      source: record.source || 'manual',
+      metadata: record.metadata || {},
+      automation: !!record.automation,
+      automationRunId: record.automationRunId || null,
+      legacyProjectSlug: record.legacyProjectSlug || null,
+      legacySource: record.legacySource === true,
+      permissionMode: record.permissionMode || 'default',
       safetyPolicy: null,
     };
     sessions.set(record.sessionId, rehydrated);

package/_site/lib/cli-instances.js

@@ -1,43 +1,43 @@
-'use strict';
-const path = require('node:path');
-const { execFileSync } = require('node:child_process');
-const control = require('./runtime-control');
-
-function url(info) { return `http://${info.host === '::1' ? '[::1]' : info.host}:${info.port}`; }
-async function current(dataDir) {
-  try { const response = await control.request(dataDir, { action: 'status' }, 1500); return { ...response.instance, status: response.status }; }
-  catch (error) { if (['ENOENT', 'ECONNREFUSED', 'EPIPE'].includes(error.code)) return null; throw error; }
-}
-async function atPort(port) {
-  const response = await fetch(`http://127.0.0.1:${port}/api/runtime/identity`, { signal: AbortSignal.timeout(1200), headers: { Connection: 'close' } });
-  if (!response.ok) throw new Error(`端口 ${port} 不是可控制的知识库实例（HTTP ${response.status}）。`);
-  const info = await response.json();
-  if (info.schema !== control.SCHEMA || info.name !== 'project-knowledge' || info.port !== port || !path.isAbsolute(info.dataDir || '')) throw new Error(`端口 ${port} 的实例身份无效，已拒绝控制。`);
-  const verified = await current(info.dataDir);
-  if (!verified || verified.pid !== info.pid || verified.port !== port || verified.startedAt !== info.startedAt) throw new Error(`端口 ${port} 的实例已变化，已拒绝控制。`);
-  return verified;
-}
-function listeningPorts() {
-  let output;
-  if (process.platform === 'win32') {
-    output = execFileSync('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', "Get-NetTCPConnection -State Listen -ErrorAction Stop | Where-Object { $_.LocalAddress -in @('127.0.0.1','0.0.0.0','::1','::') } | Select-Object -ExpandProperty LocalPort -Unique"], { encoding: 'utf8', windowsHide: true, timeout: 10000 });
-    return [...new Set(output.split(/\s+/).map(Number).filter(n => Number.isInteger(n) && n > 0 && n <= 65535))];
-  }
-  if (process.platform === 'darwin') output = execFileSync('lsof', ['-nP', '-iTCP', '-sTCP:LISTEN', '-Fn'], { encoding: 'utf8', timeout: 5000 });
-  else output = execFileSync('ss', ['-tlnH'], { encoding: 'utf8', timeout: 5000 });
-  return [...new Set([...output.matchAll(/:(\d+)(?:\s|$)/gm)].map(match => Number(match[1])))];
-}
-async function all() {
-  const ports = listeningPorts(), instances = [], seen = new Set();
-  // Bounded read-only probes; no PID is ever killed by inventory discovery.
-  for (let i = 0; i < ports.length; i += 8) {
-    const found = await Promise.all(ports.slice(i, i + 8).map(port => atPort(port).catch(() => null)));
-    for (const info of found) if (info && !seen.has(info.pid + ':' + info.port)) { seen.add(info.pid + ':' + info.port); instances.push(info); }
-  }
-  return instances.sort((a, b) => a.port - b.port);
-}
-async function stop(info) {
-  const result = await control.request(info.dataDir, { action: 'stop', pid: info.pid, port: info.port, startedAt: info.startedAt });
-  if (result.status !== 'stopped') throw new Error('停止尚未确认。');
-}
-module.exports = { current, atPort, all, stop, url };
+'use strict';
+const path = require('node:path');
+const { execFileSync } = require('node:child_process');
+const control = require('./runtime-control');
+
+function url(info) { return `http://${info.host === '::1' ? '[::1]' : info.host}:${info.port}`; }
+async function current(dataDir) {
+  try { const response = await control.request(dataDir, { action: 'status' }, 1500); return { ...response.instance, status: response.status }; }
+  catch (error) { if (['ENOENT', 'ECONNREFUSED', 'EPIPE'].includes(error.code)) return null; throw error; }
+}
+async function atPort(port) {
+  const response = await fetch(`http://127.0.0.1:${port}/api/runtime/identity`, { signal: AbortSignal.timeout(1200), headers: { Connection: 'close' } });
+  if (!response.ok) throw new Error(`端口 ${port} 不是可控制的知识库实例（HTTP ${response.status}）。`);
+  const info = await response.json();
+  if (info.schema !== control.SCHEMA || info.name !== 'project-knowledge' || info.port !== port || !path.isAbsolute(info.dataDir || '')) throw new Error(`端口 ${port} 的实例身份无效，已拒绝控制。`);
+  const verified = await current(info.dataDir);
+  if (!verified || verified.pid !== info.pid || verified.port !== port || verified.startedAt !== info.startedAt) throw new Error(`端口 ${port} 的实例已变化，已拒绝控制。`);
+  return verified;
+}
+function listeningPorts() {
+  let output;
+  if (process.platform === 'win32') {
+    output = execFileSync('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', "Get-NetTCPConnection -State Listen -ErrorAction Stop | Where-Object { $_.LocalAddress -in @('127.0.0.1','0.0.0.0','::1','::') } | Select-Object -ExpandProperty LocalPort -Unique"], { encoding: 'utf8', windowsHide: true, timeout: 10000 });
+    return [...new Set(output.split(/\s+/).map(Number).filter(n => Number.isInteger(n) && n > 0 && n <= 65535))];
+  }
+  if (process.platform === 'darwin') output = execFileSync('lsof', ['-nP', '-iTCP', '-sTCP:LISTEN', '-Fn'], { encoding: 'utf8', timeout: 5000 });
+  else output = execFileSync('ss', ['-tlnH'], { encoding: 'utf8', timeout: 5000 });
+  return [...new Set([...output.matchAll(/:(\d+)(?:\s|$)/gm)].map(match => Number(match[1])))];
+}
+async function all() {
+  const ports = listeningPorts(), instances = [], seen = new Set();
+  // Bounded read-only probes; no PID is ever killed by inventory discovery.
+  for (let i = 0; i < ports.length; i += 8) {
+    const found = await Promise.all(ports.slice(i, i + 8).map(port => atPort(port).catch(() => null)));
+    for (const info of found) if (info && !seen.has(info.pid + ':' + info.port)) { seen.add(info.pid + ':' + info.port); instances.push(info); }
+  }
+  return instances.sort((a, b) => a.port - b.port);
+}
+async function stop(info) {
+  const result = await control.request(info.dataDir, { action: 'stop', pid: info.pid, port: info.port, startedAt: info.startedAt });
+  if (result.status !== 'stopped') throw new Error('停止尚未确认。');
+}
+module.exports = { current, atPort, all, stop, url };

package/_site/lib/codex-context-status.js

@@ -1,17 +1,17 @@
-'use strict';
-
-// Native read-only discovery, never trust-file edits or bypass flags. Reuse
-// the module's verified stdio transport rather than a second RPC lifecycle.
-async function readCodexHooks({ command, env, cwd }) {
-  const { createAppServerBridge } = require('claude-ai-workbench/packages/server/lib/bridges/app-server-bridge');
-  const { resolveCliInvocation } = require('claude-ai-workbench/packages/server/lib/drivers/cli-json-runner');
-  const bridge = createAppServerBridge({ command, args: ['app-server'], env, cwd, resolveInvocation: resolveCliInvocation, maxRestarts: 0, idleTimeoutMs: 0, requestTimeoutMs: 10000 });
-  try {
-    await bridge.start();
-    await bridge.request('initialize', { clientInfo: { name: 'project-knowledge-hook-status', version: '1' }, capabilities: { experimentalApi: true } });
-    await bridge.notify('initialized');
-    return await bridge.request('hooks/list', { cwds: [cwd] });
-  } finally { await bridge.close(); }
-}
-
-module.exports = { readCodexHooks };
+'use strict';
+
+// Native read-only discovery, never trust-file edits or bypass flags. Reuse
+// the module's verified stdio transport rather than a second RPC lifecycle.
+async function readCodexHooks({ command, env, cwd }) {
+  const { createAppServerBridge } = require('claude-ai-workbench/packages/server/lib/bridges/app-server-bridge');
+  const { resolveCliInvocation } = require('claude-ai-workbench/packages/server/lib/drivers/cli-json-runner');
+  const bridge = createAppServerBridge({ command, args: ['app-server'], env, cwd, resolveInvocation: resolveCliInvocation, maxRestarts: 0, idleTimeoutMs: 0, requestTimeoutMs: 10000 });
+  try {
+    await bridge.start();
+    await bridge.request('initialize', { clientInfo: { name: 'project-knowledge-hook-status', version: '1' }, capabilities: { experimentalApi: true } });
+    await bridge.notify('initialized');
+    return await bridge.request('hooks/list', { cwds: [cwd] });
+  } finally { await bridge.close(); }
+}
+
+module.exports = { readCodexHooks };