@sanqianx/project-knowledge 5.0.23 → 5.0.25

package/bin/project-knowledge.js

@@ -1,170 +1,269 @@
-#!/usr/bin/env node
-'use strict';
-const path = require('node:path');
-const fs = require('node:fs');
-const net = require('node:net');
-const { spawn, spawnSync, exec } = require('node:child_process');
-const { resolveDataDirPath } = require('../_site/lib/data-dir');
-const endpoint = require('../_site/lib/runtime-endpoint');
-const instances = require('../_site/lib/cli-instances');
-const pkg = require('../package.json');
-
-function help() {
-  console.log(`project-knowledge ${pkg.version}
-
-Usage:
-  project-knowledge [start]      Start in background and open the UI
-  project-knowledge --fg         Start in foreground
-  project-knowledge stop         Stop this data directory and its owned modules
-  project-knowledge status       Show this data directory's instance
-  project-knowledge status --all List controllable local knowledge instances
-  project-knowledge stop --port 5804
-                                Stop the verified instance on this port
-  project-knowledge install|update|uninstall|integrations
-                                Manage coding-agent integrations
-
-Options:
-  -p, --port <port>  Port (default: 5757, startup auto-fallback +19)
-      --data <dir>   Select data directory (default: ~/.project-knowledge-v5)
-      --host <host>  Bind host (default: 127.0.0.1)
-      --no-open      Do not open browser
-      --fg           Run in foreground
-  -v, --version      Print version
-  -h, --help         Show help
-
-Commands are case-insensitive. Unknown commands never start a service.`);
-}
-function parse(args) {
-  const commands = new Set(['start', 'stop', 'status', 'install', 'update', 'uninstall', 'integrations']);
-  let command = 'start';
-  if (args[0] && !args[0].startsWith('-')) {
-    command = args.shift().toLowerCase();
-    if (!commands.has(command)) throw new Error(`Unknown command: ${command}. Run project-knowledge --help.`);
-  }
-  if (['install', 'update', 'uninstall', 'integrations'].includes(command)) return { command, forwarded: args };
-  const options = { command, port: Number(process.env.KB_SITE_PORT || 5757), host: '127.0.0.1', open: true };
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (arg === '--help' || arg === '-h') options.help = true;
-    else if (arg === '--version' || arg === '-v') options.version = true;
-    else if (['--port', '-p', '--host', '--data'].includes(arg)) {
-      const value = args[++i];
-      if (!value || value.startsWith('-')) throw new Error(`Missing value for ${arg}.`);
-      if (arg === '--port' || arg === '-p') { options.port = Number(value); options.portExplicit = true; }
-      else if (arg === '--data') options.dataDir = value;
-      else options.host = value;
-    } else if (arg === '--no-open') options.open = false;
-    else if (arg === '--fg') options.foreground = true;
-    else if (arg === '--all') options.all = true;
-    else throw new Error(`${arg.startsWith('-') ? 'Unknown option' : 'Unexpected argument'}: ${arg}.`);
-  }
-  if (!Number.isInteger(options.port) || options.port < 1 || options.port > 65535) throw new Error('Port must be an integer from 1 to 65535.');
-  if (options.all && (command !== 'status' || options.portExplicit)) throw new Error('--all is only supported by status, without --port.');
-  if (command !== 'start' && (options.foreground || !options.open || options.host !== '127.0.0.1')) throw new Error('Startup options cannot be used with stop/status.');
-  return options;
-}
-function openBrowser(url) {
-  const command = process.platform === 'win32' ? `start "" "${url}"` : process.platform === 'darwin' ? `open "${url}"` : `xdg-open "${url}"`;
-  exec(command, () => {});
-}
-function notify(message) { if (process.connected) process.send(message, () => {}); }
-function waitForStartup(child, log) {
-  return new Promise((resolve, reject) => {
-    const finish = (error, value) => {
-      clearTimeout(timer); child.removeAllListeners('message'); child.removeAllListeners('exit');
-      if (child.connected) child.disconnect();
-      if (error) reject(error); else resolve(value);
-    };
-    const timer = setTimeout(() => finish(new Error(`启动尚未完成，请运行 project-knowledge status 并查看 ${log}`)), 45000);
-    child.on('message', message => {
-      if (message?.type === 'kb:launcher-ready') finish(null, message);
-      else if (message?.type === 'kb:launcher-failed') finish(new Error(message.message));
-    });
-    child.once('error', error => finish(error));
-    child.once('exit', code => finish(new Error(`后台进程在启动完成前退出（${code}），请查看 ${log}`)));
-  });
-}
-function portFree(port, host) {
-  return new Promise(resolve => {
-    const tester = net.createServer();
-    let done = false;
-    const timer = setTimeout(() => finish(false), 3000);
-    function finish(free) {
-      if (done) return; done = true; clearTimeout(timer); tester.close(() => resolve(free));
-    }
-    tester.once('error', () => finish(false)); tester.once('listening', () => finish(true)); tester.listen(port, host);
-  });
-}
-async function freePort(port, host) {
-  for (let offset = 0; offset < 20 && port + offset <= 65535; offset++) if (await portFree(port + offset, host)) return port + offset;
-  throw new Error(`No free port found near ${port}.`);
-}
-function show(info) { console.log(`project-knowledge is ${info.status === 'stopping' ? 'stopping' : 'running'} (PID ${info.pid}) at ${instances.url(info)} [${info.version}]\nData dir: ${info.dataDir}`); }
-
-async function main() {
-  const options = parse(process.argv.slice(2));
-  if (options.help) { help(); return; }
-  if (options.version) { console.log(pkg.version); return; }
-  if (options.forwarded) {
-    const args = options.command === 'integrations' ? (options.forwarded.length ? options.forwarded : ['status']) : [options.command, ...options.forwarded];
-    const result = spawnSync(process.execPath, [path.join(__dirname, 'project-knowledge-integrations.js'), ...args], { stdio: 'inherit', windowsHide: true });
-    process.exitCode = result.status ?? 1; return;
-  }
-  const dataDir = resolveDataDirPath({ dataDir: options.dataDir });
-  process.env.KB_DATA_DIR = dataDir;
-  if (options.all) {
-    const found = await instances.all();
-    if (!found.length) console.log('No controllable project-knowledge instances found.');
-    for (const info of found) show(info);
-    return;
-  }
-  const existing = options.command !== 'start' && options.portExplicit ? await instances.atPort(options.port) : await instances.current(dataDir);
-  const unverified = !existing && endpoint.readLiveEndpoint(dataDir, { removeStale: false });
-  if (unverified) throw new Error(`数据目录已有实例记录（PID ${unverified.pid}，端口 ${unverified.port}），但控制通道不可用。请先确认该实例，不会重复启动、误停止或报告已停止。`);
-  if (existing && options.dataDir && options.command !== 'start' && path.resolve(existing.dataDir).toLowerCase() !== dataDir.toLowerCase()) throw new Error('指定端口不属于指定数据目录，已拒绝控制。');
-  if (options.command === 'status') {
-    if (existing) show(existing);
-    else console.log(`project-knowledge is not running for ${dataDir}.\nUse "project-knowledge status --all" to inspect other data directories.`);
-    return;
-  }
-  if (options.command === 'stop') {
-    if (!existing) { console.log(`No background process found for ${dataDir}.`); return; }
-    await instances.stop(existing);
-    console.log(`project-knowledge stopped (PID ${existing.pid}) at ${instances.url(existing)}.\nData dir: ${existing.dataDir}`);
-    return;
-  }
-  if (existing) {
-    if (existing.status === 'stopping') throw new Error('实例正在停止，请稍后再启动。');
-    const url = instances.url(existing); console.log(`Already running (PID ${existing.pid}) at ${url}\nData dir: ${existing.dataDir}`);
-    notify({ type: 'kb:launcher-ready', url }); if (options.open) openBrowser(url); return;
-  }
-  // A live claim with no control channel is starting, legacy, or unverified.
-  // Never trust a reused/shared PID as proof or kill it to make room.
-  if (!options.foreground) {
-    fs.mkdirSync(dataDir, { recursive: true });
-    const log = path.join(dataDir, 'launcher.log'), fd = fs.openSync(log, 'a');
-    const child = spawn(process.execPath, [...process.argv.slice(1), '--fg'], { detached: true, stdio: ['ignore', fd, fd, 'ipc'], windowsHide: true });
-    fs.closeSync(fd); child.unref();
-    console.log(`project-knowledge starting in background\nDiagnostics: ${log}`);
-    const ready = await waitForStartup(child, log);
-    console.log(`project-knowledge is ready at ${ready.url}\nUse "project-knowledge status" to check, "project-knowledge stop" to stop.`);
-    return;
-  }
-  const port = options.portExplicit ? options.port : await freePort(options.port, options.host);
-  process.env.KB_SITE_HOST = options.host; process.env.KB_SITE_PORT = String(port);
-  console.log(`project-knowledge ${pkg.version}\nData dir: ${dataDir}`);
-  if (port !== options.port) console.log(`(Port ${options.port} was busy, using ${port} instead)`);
-  const { startServer, installProcessHandlers } = require('../_site/lib/server-app');
-  const promise = startServer(); installProcessHandlers(promise);
-  const instance = await promise;
-  if (process.platform === 'win32') process.once('SIGBREAK', () => instance.stop('SIGBREAK'));
-  const url = instances.url({ host: options.host, port });
-  console.log(`Listening at ${url}`); notify({ type: 'kb:launcher-ready', url });
-  if (options.open) setTimeout(() => openBrowser(url), 500);
-}
-main().catch(error => {
-  const control = ['stop', 'status'].includes(process.argv[2]?.toLowerCase());
-  console.error(process.argv.includes('--fg') ? `[project-knowledge] startup failed: ${error.message}` : `${control ? '控制失败' : '启动失败'}：${error.message}`);
-  notify({ type: 'kb:launcher-failed', message: error.message });
-  process.exitCode = 1;
-});
+#!/usr/bin/env node
+'use strict';
+const path = require('node:path');
+const fs = require('node:fs');
+const net = require('node:net');
+const { spawn, spawnSync, exec } = require('node:child_process');
+const { resolveDataDirPath } = require('../_site/lib/data-dir');
+const endpoint = require('../_site/lib/runtime-endpoint');
+const instances = require('../_site/lib/cli-instances');
+const pkg = require('../package.json');
+
+function help() {
+  console.log(`project-knowledge ${pkg.version}
+
+Usage:
+  project-knowledge [start]      Start in background and open the UI
+  project-knowledge --fg         Start in foreground
+  project-knowledge stop         Stop this data directory and its owned modules
+  project-knowledge status       Show this data directory's instance
+  project-knowledge status --all List controllable local knowledge instances
+  project-knowledge stop --port 5804
+                                Stop the verified instance on this port
+  project-knowledge install|update|uninstall|integrations
+                                Manage coding-agent integrations
+
+Options:
+  -p, --port <port>  Port (default: 5757, startup auto-fallback +19)
+      --data <dir>   Select data directory (default: ~/.project-knowledge-v5)
+      --host <host>  Bind host (default: 127.0.0.1)
+      --no-open      Do not open browser
+      --fg           Run in foreground
+  -v, --version      Print version
+  -h, --help         Show help
+
+Commands are case-insensitive. Unknown commands never start a service.`);
+}
+function parse(args) {
+  const commands = new Set(['start', 'stop', 'status', 'install', 'update', 'uninstall', 'integrations']);
+  let command = 'start';
+  if (args[0] && !args[0].startsWith('-')) {
+    command = args.shift().toLowerCase();
+    if (!commands.has(command)) throw new Error(`Unknown command: ${command}. Run project-knowledge --help.`);
+  }
+  if (['install', 'update', 'uninstall', 'integrations'].includes(command)) return { command, forwarded: args };
+  const options = { command, port: Number(process.env.KB_SITE_PORT || 5757), host: '127.0.0.1', open: true };
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === '--help' || arg === '-h') options.help = true;
+    else if (arg === '--version' || arg === '-v') options.version = true;
+    else if (['--port', '-p', '--host', '--data'].includes(arg)) {
+      const value = args[++i];
+      if (!value || value.startsWith('-')) throw new Error(`Missing value for ${arg}.`);
+      if (arg === '--port' || arg === '-p') { options.port = Number(value); options.portExplicit = true; }
+      else if (arg === '--data') options.dataDir = value;
+      else options.host = value;
+    } else if (arg === '--no-open') options.open = false;
+    else if (arg === '--fg') options.foreground = true;
+    else if (arg === '--all') options.all = true;
+    else throw new Error(`${arg.startsWith('-') ? 'Unknown option' : 'Unexpected argument'}: ${arg}.`);
+  }
+  if (!Number.isInteger(options.port) || options.port < 1 || options.port > 65535) throw new Error('Port must be an integer from 1 to 65535.');
+  if (options.all && (command !== 'status' || options.portExplicit)) throw new Error('--all is only supported by status, without --port.');
+  if (command !== 'start' && (options.foreground || !options.open || options.host !== '127.0.0.1')) throw new Error('Startup options cannot be used with stop/status.');
+  return options;
+}
+function openBrowser(url) {
+  const command = process.platform === 'win32' ? `start "" "${url}"` : process.platform === 'darwin' ? `open "${url}"` : `xdg-open "${url}"`;
+  exec(command, () => {});
+}
+function notify(message) { if (process.connected) process.send(message, () => {}); }
+// Patience knobs must never produce NaN/Infinity budgets (a NaN comparison
+// is always false, which silently disables the deadline and loops forever).
+// Invalid or missing values fall back; absurd values clamp to one hour.
+function parsePatienceMs(raw, fallbackMs) {
+  const value = Number(raw);
+  if (!Number.isFinite(value) || value <= 0) return fallbackMs;
+  return Math.min(value, 3600000);
+}
+function waitForStartup(child, log, options = {}) {
+  return new Promise((resolve, reject) => {
+    const initialBudgetMs = options.initialBudgetMs ?? 45000;
+    const progressIntervalMs = options.progressIntervalMs ?? 15000;
+    const patienceMs = options.patienceMs !== undefined
+      ? parsePatienceMs(options.patienceMs, 300000)
+      : parsePatienceMs(process.env.KB_LAUNCHER_STARTUP_PATIENCE_MS, 300000);
+    const startedAt = Date.now();
+    let timer = null;
+    const finish = (error, value) => {
+      clearTimeout(timer); child.removeAllListeners('message'); child.removeAllListeners('exit');
+      if (child.connected) child.disconnect();
+      if (error) reject(error); else resolve(value);
+    };
+    // R10: a slow init is STARTING, not a failure. The old fixed 45s budget
+    // reported 启动失败 while the detached backend kept initializing and
+    // opened the browser minutes later. Keep waiting (with progress lines)
+    // while the child lives; only a child exit or a real launcher-failed
+    // message is definitive. The patience cap stays an honest give-up-waiting
+    // report that explicitly does not claim the backend failed; R12: the
+    // schedule honors a patience deadline BELOW the first checkpoint (the cap
+    // fires at min(checkpoint, patience)) and the cap error is TYPED so the
+    // CLI reports it as still-starting instead of 启动失败.
+    const onBudget = () => {
+      const elapsed = Date.now() - startedAt;
+      if (child.exitCode !== null) return;
+      if (elapsed >= patienceMs) {
+        finish(Object.assign(new Error(`启动仍在进行：后台进程存活但 ${Math.round(elapsed / 1000)}s 内未就绪（未判定失败）。请运行 project-knowledge status 并查看 ${log}`), { code: 'KB_STARTUP_STILL_STARTING' }));
+        return;
+      }
+      console.log(`仍在启动（已等待 ${Math.round(elapsed / 1000)}s，进程存活）…诊断: ${log}`);
+      timer = setTimeout(onBudget, Math.max(50, Math.min(progressIntervalMs, patienceMs - elapsed)));
+    };
+    timer = setTimeout(onBudget, Math.max(50, Math.min(initialBudgetMs, patienceMs)));
+    child.on('message', message => {
+      if (message?.type === 'kb:launcher-ready') finish(null, message);
+      else if (message?.type === 'kb:launcher-failed') finish(new Error(message.message));
+    });
+    child.once('error', error => finish(error));
+    child.once('exit', code => finish(new Error(`后台进程在启动完成前退出（${code}），请查看 ${log}`)));
+  });
+}
+function portFree(port, host) {
+  return new Promise(resolve => {
+    const tester = net.createServer();
+    let done = false;
+    const timer = setTimeout(() => finish(false), 3000);
+    function finish(free) {
+      if (done) return; done = true; clearTimeout(timer); tester.close(() => resolve(free));
+    }
+    tester.once('error', () => finish(false)); tester.once('listening', () => finish(true)); tester.listen(port, host);
+  });
+}
+async function freePort(port, host) {
+  for (let offset = 0; offset < 20 && port + offset <= 65535; offset++) if (await portFree(port + offset, host)) return port + offset;
+  throw new Error(`No free port found near ${port}.`);
+}
+function show(info) { console.log(`project-knowledge is ${info.status === 'stopping' ? 'stopping' : 'running'} (PID ${info.pid}) at ${instances.url(info)} [${info.version}]\nData dir: ${info.dataDir}`); }
+function isRetryableProbeError(error) {
+  if (!error) return false;
+  if (['ETIMEDOUT', 'ECONNRESET', 'EAGAIN'].includes(error.code)) return true;
+  if (error.code) return false;
+  return /超时|断开连接/.test(String(error.message || ''));
+}
+// R10: `start` must not report 启动失败 while an existing instance is alive
+// but its control channel is stalled (large-data busy windows exceed the
+// short probe budget, and a timeout error carries no code). Retry while the
+// endpoint PID lives; a dead record falls through to a normal spawn.
+async function resolveExistingForStart(dataDir) {
+  const patienceMs = parsePatienceMs(process.env.KB_LAUNCHER_CONNECT_PATIENCE_MS, 300000);
+  const startedAt = Date.now();
+  while (true) {
+    let current = null;
+    let answered = false; // the probe definitively reported "no control channel"
+    try { current = await instances.current(dataDir); answered = true; }
+    catch (error) { if (!isRetryableProbeError(error)) throw error; }
+    if (current) return { instance: current };
+    const live = endpoint.readLiveEndpoint(dataDir, { removeStale: false });
+    if (!live || !endpoint.isProcessAlive(live.pid)) return { instance: null };
+    // R13: the live writer ALWAYS stamps startedAt (writeEndpoint/claimEndpoint
+    // default it). A live PID behind an unstamped record while the probe
+    // answered a definitive refusal (ENOENT/ECONNREFUSED/EPIPE, not a busy
+    // timeout) is a legacy or hand-written claim, not a busy window: refuse
+    // fast like stop/status instead of trusting the unverified PID through the
+    // whole patience budget. A stalled-but-present channel (retryable timeout)
+    // keeps the honest retry below.
+    if (answered && !live.startedAt) return { unverified: live };
+    if (Date.now() - startedAt >= patienceMs) return { busy: live };
+    await new Promise(resolve => setTimeout(resolve, 500));
+  }
+}
+
+async function main() {
+  const options = parse(process.argv.slice(2));
+  if (options.help) { help(); return; }
+  if (options.version) { console.log(pkg.version); return; }
+  if (options.forwarded) {
+    const args = options.command === 'integrations' ? (options.forwarded.length ? options.forwarded : ['status']) : [options.command, ...options.forwarded];
+    const result = spawnSync(process.execPath, [path.join(__dirname, 'project-knowledge-integrations.js'), ...args], { stdio: 'inherit', windowsHide: true });
+    process.exitCode = result.status ?? 1; return;
+  }
+  const dataDir = resolveDataDirPath({ dataDir: options.dataDir });
+  process.env.KB_DATA_DIR = dataDir;
+  if (options.all) {
+    const found = await instances.all();
+    if (!found.length) console.log('No controllable project-knowledge instances found.');
+    for (const info of found) show(info);
+    return;
+  }
+  let existing;
+  if (options.command === 'start') {
+    // R10: live-but-busy instance → honest retry, never 启动失败 and never a
+    // second spawn. stop/status keep their strict refusal semantics below.
+    const resolved = await resolveExistingForStart(dataDir);
+    if (resolved.unverified) {
+      const info = resolved.unverified;
+      throw new Error(`数据目录已有实例记录（PID ${info.pid}，端口 ${info.port}），但该记录缺少 startedAt 启动标识且控制通道无响应（未验证的遗留记录）。已拒绝启动：不会重复启动、误停止或报告已停止。`);
+    }
+    if (resolved.busy) {
+      const info = resolved.busy;
+      console.log(`现有实例（PID ${info.pid}，端口 ${info.port}）正在启动或繁忙，控制通道暂未响应（未判定失败，未重复启动）。` +
+        `\n可稍后重试，或直接访问 ${instances.url(info)}`);
+      return;
+    }
+    existing = resolved.instance;
+  } else {
+    existing = options.portExplicit ? await instances.atPort(options.port) : await instances.current(dataDir);
+    const unverified = !existing && endpoint.readLiveEndpoint(dataDir, { removeStale: false });
+    if (unverified) throw new Error(`数据目录已有实例记录（PID ${unverified.pid}，端口 ${unverified.port}），但控制通道不可用。请先确认该实例，不会重复启动、误停止或报告已停止。`);
+  }
+  if (existing && options.dataDir && options.command !== 'start' && path.resolve(existing.dataDir).toLowerCase() !== dataDir.toLowerCase()) throw new Error('指定端口不属于指定数据目录，已拒绝控制。');
+  if (options.command === 'status') {
+    if (existing) show(existing);
+    else console.log(`project-knowledge is not running for ${dataDir}.\nUse "project-knowledge status --all" to inspect other data directories.`);
+    return;
+  }
+  if (options.command === 'stop') {
+    if (!existing) { console.log(`No background process found for ${dataDir}.`); return; }
+    await instances.stop(existing);
+    console.log(`project-knowledge stopped (PID ${existing.pid}) at ${instances.url(existing)}.\nData dir: ${existing.dataDir}`);
+    return;
+  }
+  if (existing) {
+    if (existing.status === 'stopping') throw new Error('实例正在停止，请稍后再启动。');
+    const url = instances.url(existing); console.log(`Already running (PID ${existing.pid}) at ${url}\nData dir: ${existing.dataDir}`);
+    notify({ type: 'kb:launcher-ready', url }); if (options.open) openBrowser(url); return;
+  }
+  // A live claim with no control channel is starting, legacy, or unverified.
+  // Never trust a reused/shared PID as proof or kill it to make room.
+  if (!options.foreground) {
+    fs.mkdirSync(dataDir, { recursive: true });
+    const log = path.join(dataDir, 'launcher.log'), fd = fs.openSync(log, 'a');
+    const child = spawn(process.execPath, [...process.argv.slice(1), '--fg'], { detached: true, stdio: ['ignore', fd, fd, 'ipc'], windowsHide: true });
+    fs.closeSync(fd); child.unref();
+    console.log(`project-knowledge starting in background\nDiagnostics: ${log}`);
+    const ready = await waitForStartup(child, log).catch(error => {
+      // R12: the patience cap while the child lives is an honest
+      // still-starting report, never 启动失败 — the backend keeps booting.
+      if (error && error.code === 'KB_STARTUP_STILL_STARTING') {
+        console.log(`${error.message}\n后台进程将继续初始化（未重复启动，未判定失败）。`);
+        return null;
+      }
+      throw error;
+    });
+    if (!ready) return;
+    console.log(`project-knowledge is ready at ${ready.url}\nUse "project-knowledge status" to check, "project-knowledge stop" to stop.`);
+    return;
+  }
+  const port = options.portExplicit ? options.port : await freePort(options.port, options.host);
+  process.env.KB_SITE_HOST = options.host; process.env.KB_SITE_PORT = String(port);
+  console.log(`project-knowledge ${pkg.version}\nData dir: ${dataDir}`);
+  if (port !== options.port) console.log(`(Port ${options.port} was busy, using ${port} instead)`);
+  const { startServer, installProcessHandlers } = require('../_site/lib/server-app');
+  const promise = startServer(); installProcessHandlers(promise);
+  const instance = await promise;
+  if (process.platform === 'win32') process.once('SIGBREAK', () => instance.stop('SIGBREAK'));
+  const url = instances.url({ host: options.host, port });
+  console.log(`Listening at ${url}`); notify({ type: 'kb:launcher-ready', url });
+  if (options.open) setTimeout(() => openBrowser(url), 500);
+}
+// R12: the module doubles as the CLI entry AND a testable unit surface;
+// require() must never run the CLI.
+module.exports = { waitForStartup, parsePatienceMs };
+if (require.main === module) {
+  main().catch(error => {
+    const control = ['stop', 'status'].includes(process.argv[2]?.toLowerCase());
+    console.error(process.argv.includes('--fg') ? `[project-knowledge] startup failed: ${error.message}` : `${control ? '控制失败' : '启动失败'}：${error.message}`);
+    notify({ type: 'kb:launcher-failed', message: error.message });
+    process.exitCode = 1;
+  });
+}

package/claude-prompts.json

@@ -1,21 +1,21 @@
-{
-  "schema": "claude-prompts/v1",
-  "prompts": {
-    "initial-analysis": {
-      "description": "Initial project analysis. Claude runs from the KB workspace and reads the source project via PROJECT_PATH.",
-      "model": "sonnet",
-      "permissionMode": "bypassPermissions",
-      "allowedTools": ["Read", "Grep", "Glob"],
-      "systemPrompt": "You are an expert project analyst building a knowledge base. The current working directory is the knowledge-base workspace, not the source project. Read source code from PROJECT_PATH and treat KB_PATH as the write target for knowledge-base drafts and updates. Output STRICT JSON only: no prose and no markdown fences. The JSON must match this shape:\n\n{\n  \"goalDraft\": {\n    \"oneLine\": \"one-sentence description of what this project is\",\n    \"positioning\": \"paragraph describing the project's role and core value\",\n    \"coreValue\": [\"bullet points of core value to developers / teams\"],\n    \"painPoints\": [{\"pain\": \"...\", \"legacyApproach\": \"...\", \"projectApproach\": \"...\"}]\n  },\n  \"analysisDraft\": {\n    \"framework\": \"primary framework / language / stack\",\n    \"modules\": [{\"name\": \"...\", \"responsibility\": \"...\", \"keyFiles\": [\"path/to/file\"]}],\n    \"architecture\": \"paragraph describing the architecture and data flow\",\n    \"evidence\": [{\"claim\": \"...\", \"file\": \"path:line\"}]\n  },\n  \"features\": [{\"slug\": \"kebab-case-slug\", \"name\": \"...\", \"summary\": \"...\"}]\n}\n\nUse the Read, Grep, and Glob tools to investigate PROJECT_PATH. Cite real source file paths in evidence. Do not invent modules that do not exist. Do not modify the source project unless the user explicitly asks for source changes.",
-      "userPrompt": "Analyze the source project at PROJECT_PATH. The current working directory is KB_PATH.\n\nProject context:\n- Slug: {{SLUG}}\n- Source project path: {{PROJECT_PATH}}\n- Knowledge-base path: {{KB_PATH}}\n- Primary language: {{PRIMARY_LANGUAGE}}\n- Knowledge language: {{KNOWLEDGE_LANGUAGE}}\n\nTasks:\n1. Identify the framework, main tech stack, and language distribution.\n2. List the core modules / top-level directories and their responsibilities.\n3. Describe the architecture and data flow at a high level.\n4. Identify 3-6 user-facing features.\n5. Capture 4-8 evidence-backed claims with file:line citations.\n\nWrite the knowledge-base content in {{KNOWLEDGE_LANGUAGE}} where natural, but keep code identifiers, file paths, and JSON keys in English.\n\nReturn ONLY the JSON object described in the system prompt."
-    },
-    "commit-analysis": {
-      "description": "Batch analysis of one or more commits. Claude runs from the KB workspace and reads the source project via PROJECT_PATH.",
-      "model": "sonnet",
-      "permissionMode": "bypassPermissions",
-      "allowedTools": ["Read", "Grep", "Glob", "Bash"],
-      "systemPrompt": "You are a commit analyst building a knowledge base. The current working directory is the knowledge-base workspace, not the source project. Read source code from PROJECT_PATH and treat KB_PATH as the write target for knowledge-base drafts and updates. For each commit provided, output a structured change description. STRICT JSON only: no prose.\n\nOutput shape:\n{\n  \"changes\": [\n    {\n      \"hash\": \"<full-or-short-hash>\",\n      \"subject\": \"<original commit subject>\",\n      \"type\": \"feat|fix|refactor|docs|test|chore|infra\",\n      \"classification\": \"feature|bugfix|infrastructure|documentation|test\",\n      \"summary\": \"one-paragraph description of what changed and why\",\n      \"files\": [\"paths/touched\"],\n      \"evidence\": [{\"claim\": \"...\", \"file\": \"path:line\"}]\n    }\n  ]\n}\n\nUse git commands against PROJECT_PATH and Read for inspecting changed files. Cite real source file paths. Do not modify the source project unless the user explicitly asks for source changes.",
-      "userPrompt": "Analyze the following commits in the source project at PROJECT_PATH. The current working directory is KB_PATH.\n\nProject: {{SLUG}} ({{PROJECT_PATH}})\nKnowledge-base path: {{KB_PATH}}\nCommit range: {{COMMIT_RANGE}}\nCommits to analyze:\n{{COMMIT_HASHES}}\n\nFor each commit, produce one entry in the changes array. Use git commands against {{PROJECT_PATH}} and Read for inspecting changed source files. Summarize in {{KNOWLEDGE_LANGUAGE}}; keep identifiers and paths in English.\n\nReturn ONLY the JSON object."
-    }
-  }
-}
+{
+  "schema": "claude-prompts/v1",
+  "prompts": {
+    "initial-analysis": {
+      "description": "Initial project analysis. Claude runs from the KB workspace and reads the source project via PROJECT_PATH.",
+      "model": "sonnet",
+      "permissionMode": "bypassPermissions",
+      "allowedTools": ["Read", "Grep", "Glob"],
+      "systemPrompt": "You are an expert project analyst building a knowledge base. The current working directory is the knowledge-base workspace, not the source project. Read source code from PROJECT_PATH and treat KB_PATH as the write target for knowledge-base drafts and updates. Output STRICT JSON only: no prose and no markdown fences. The JSON must match this shape:\n\n{\n  \"goalDraft\": {\n    \"oneLine\": \"one-sentence description of what this project is\",\n    \"positioning\": \"paragraph describing the project's role and core value\",\n    \"coreValue\": [\"bullet points of core value to developers / teams\"],\n    \"painPoints\": [{\"pain\": \"...\", \"legacyApproach\": \"...\", \"projectApproach\": \"...\"}]\n  },\n  \"analysisDraft\": {\n    \"framework\": \"primary framework / language / stack\",\n    \"modules\": [{\"name\": \"...\", \"responsibility\": \"...\", \"keyFiles\": [\"path/to/file\"]}],\n    \"architecture\": \"paragraph describing the architecture and data flow\",\n    \"evidence\": [{\"claim\": \"...\", \"file\": \"path:line\"}]\n  },\n  \"features\": [{\"slug\": \"kebab-case-slug\", \"name\": \"...\", \"summary\": \"...\"}]\n}\n\nUse the Read, Grep, and Glob tools to investigate PROJECT_PATH. Cite real source file paths in evidence. Do not invent modules that do not exist. Do not modify the source project unless the user explicitly asks for source changes.",
+      "userPrompt": "Analyze the source project at PROJECT_PATH. The current working directory is KB_PATH.\n\nProject context:\n- Slug: {{SLUG}}\n- Source project path: {{PROJECT_PATH}}\n- Knowledge-base path: {{KB_PATH}}\n- Primary language: {{PRIMARY_LANGUAGE}}\n- Knowledge language: {{KNOWLEDGE_LANGUAGE}}\n\nTasks:\n1. Identify the framework, main tech stack, and language distribution.\n2. List the core modules / top-level directories and their responsibilities.\n3. Describe the architecture and data flow at a high level.\n4. Identify 3-6 user-facing features.\n5. Capture 4-8 evidence-backed claims with file:line citations.\n\nWrite the knowledge-base content in {{KNOWLEDGE_LANGUAGE}} where natural, but keep code identifiers, file paths, and JSON keys in English.\n\nReturn ONLY the JSON object described in the system prompt."
+    },
+    "commit-analysis": {
+      "description": "Batch analysis of one or more commits. Claude runs from the KB workspace and reads the source project via PROJECT_PATH.",
+      "model": "sonnet",
+      "permissionMode": "bypassPermissions",
+      "allowedTools": ["Read", "Grep", "Glob", "Bash"],
+      "systemPrompt": "You are a commit analyst building a knowledge base. The current working directory is the knowledge-base workspace, not the source project. Read source code from PROJECT_PATH and treat KB_PATH as the write target for knowledge-base drafts and updates. For each commit provided, output a structured change description. STRICT JSON only: no prose.\n\nOutput shape:\n{\n  \"changes\": [\n    {\n      \"hash\": \"<full-or-short-hash>\",\n      \"subject\": \"<original commit subject>\",\n      \"type\": \"feat|fix|refactor|docs|test|chore|infra\",\n      \"classification\": \"feature|bugfix|infrastructure|documentation|test\",\n      \"summary\": \"one-paragraph description of what changed and why\",\n      \"files\": [\"paths/touched\"],\n      \"evidence\": [{\"claim\": \"...\", \"file\": \"path:line\"}]\n    }\n  ]\n}\n\nUse git commands against PROJECT_PATH and Read for inspecting changed files. Cite real source file paths. Do not modify the source project unless the user explicitly asks for source changes.",
+      "userPrompt": "Analyze the following commits in the source project at PROJECT_PATH. The current working directory is KB_PATH.\n\nProject: {{SLUG}} ({{PROJECT_PATH}})\nKnowledge-base path: {{KB_PATH}}\nCommit range: {{COMMIT_RANGE}}\nCommits to analyze:\n{{COMMIT_HASHES}}\n\nFor each commit, produce one entry in the changes array. Use git commands against {{PROJECT_PATH}} and Read for inspecting changed source files. Summarize in {{KNOWLEDGE_LANGUAGE}}; keep identifiers and paths in English.\n\nReturn ONLY the JSON object."
+    }
+  }
+}