@sanqianx/project-knowledge 5.0.18-rc.4 → 5.0.18

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
   "plugins": [
     {
       "name": "project-knowledge",
-      "version": "5.0.18-rc.4",
+      "version": "5.0.18",
       "source": "./plugins/project-knowledge",
       "description": "Search durable project decisions and implementation history through MCP."
     }

package/_site/_test/cdp-browser-failure-test.js

@@ -1,100 +1,103 @@
-// Regression test for CDP browser launch failures (T00):
-// - browser that exits immediately must fail fast with exit/stderr diagnostics
-// - browser that stays alive but never exposes CDP must hit the launch timeout,
-//   then be killed and cleaned up
-// - in both cases: no child process remains alive, profile dir is removed.
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { isWindowsChromeLauncher, platformLaunchArgs, launchCdpBrowser } = require('./helpers/cdp-browser');
-
-const FIXTURE_EXIT = path.join(__dirname, 'fixtures', 'fake-browser-exit.js');
-const FIXTURE_HANG = path.join(__dirname, 'fixtures', 'fake-browser-hang.js');
-const FAST_FAIL_BUDGET_MS = 5000;
-
-function isPidAlive(pid) {
-  try { process.kill(pid, 0); return true; }
-  catch (error) { return error.code === 'EPERM'; }
-}
-
-async function waitForPidExit(pid, timeoutMs = 8000) {
-  const deadline = Date.now() + timeoutMs;
-  while (Date.now() < deadline) {
-    if (!isPidAlive(pid)) return false;
-    await new Promise(resolve => setTimeout(resolve, 100));
-  }
-  return isPidAlive(pid);
-}
-
-async function expectLaunchFailure(scenario) {
-  const pidFile = path.join(os.tmpdir(), `pk-cdp-failure-${scenario}-pid-${process.pid}.txt`);
-  const profileDir = path.join(os.tmpdir(), `pk-cdp-failure-${scenario}-profile-${process.pid}`);
-  process.env.KB_FAKE_BROWSER_PIDFILE = pidFile;
-  try {
-    const start = Date.now();
-    let error = null;
-    try {
-      await launchCdpBrowser(scenario.options(profileDir));
-    } catch (caught) {
-      error = caught;
-    }
-    const durationMs = Date.now() - start;
-    assert(error, `${scenario.name}: launchCdpBrowser must reject`);
-    assert(durationMs < FAST_FAIL_BUDGET_MS, `${scenario.name}: must fail fast, took ${durationMs}ms`);
-    const message = error.message;
-    assert(message.includes(process.execPath), `${scenario.name}: error must include executable path, got: ${message}`);
-    assert(message.includes(profileDir), `${scenario.name}: error must include user-data-dir, got: ${message}`);
-    scenario.assertions(message, durationMs);
-    assert(!fs.existsSync(profileDir), `${scenario.name}: profile dir must be cleaned after failed launch`);
-    assert(fs.existsSync(pidFile), `${scenario.name}: fixture pid file missing; cannot verify cleanup`);
-    const pid = Number.parseInt(fs.readFileSync(pidFile, 'utf8').trim(), 10);
-    const stillAlive = await waitForPidExit(pid);
-    assert(!stillAlive, `${scenario.name}: spawned child pid ${pid} still alive after failure cleanup`);
-    return durationMs;
-  } finally {
-    delete process.env.KB_FAKE_BROWSER_PIDFILE;
-    try { fs.rmSync(pidFile, { force: true }); } catch {}
-    try { fs.rmSync(profileDir, { recursive: true, force: true }); } catch {}
-  }
-}
-
-(async () => {
-  assert.strictEqual(isWindowsChromeLauncher('C:/Program Files/Google/Chrome/Application/chrome.exe'), process.platform === 'win32');
-  assert.strictEqual(isWindowsChromeLauncher(process.execPath), false);
-  assert.deepStrictEqual(platformLaunchArgs('linux'), ['--disable-dev-shm-usage', '--no-sandbox']);
-  assert.deepStrictEqual(platformLaunchArgs('win32'), []);
-  const exitDuration = await expectLaunchFailure({
-    name: 'immediate-exit',
-    options: profileDir => ({
-      chrome: process.execPath,
-      prependArgs: [FIXTURE_EXIT],
-      profileDir,
-      url: 'http://127.0.0.1:1/',
-    }),
-    assertions(message) {
-      assert(message.includes('exit code: 3'), `immediate-exit: error must contain exit code, got: ${message}`);
-      assert(message.includes('fake-browser-exit stderr: simulated browser crash before CDP'), `immediate-exit: error must contain stderr tail, got: ${message}`);
-    },
-  });
-  console.log(`cdp-browser immediate-exit failure test PASS (${exitDuration}ms)`);
-
-  const hangDuration = await expectLaunchFailure({
-    name: 'hang-timeout',
-    options: profileDir => ({
-      chrome: process.execPath,
-      prependArgs: [FIXTURE_HANG],
-      profileDir,
-      url: 'http://127.0.0.1:1/',
-      launchTimeoutMs: 1500,
-    }),
-    assertions(message, durationMs) {
-      assert(message.includes('DevToolsActivePort'), `hang-timeout: error must mention DevToolsActivePort wait, got: ${message}`);
-      assert(durationMs < FAST_FAIL_BUDGET_MS, `hang-timeout: bounded duration, took ${durationMs}ms`);
-    },
-  });
-  console.log(`cdp-browser hang-timeout failure test PASS (${hangDuration}ms)`);
-})().catch(error => {
-  console.error(error.stack || error.message);
-  process.exitCode = 1;
-});
+// Regression test for CDP browser launch failures (T00):
+// - browser that exits immediately must fail fast with exit/stderr diagnostics
+// - browser that stays alive but never exposes CDP must hit the launch timeout,
+//   then be killed and cleaned up
+// - in both cases: no child process remains alive, profile dir is removed.
+const assert = require('assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { isWindowsChromeLauncher, platformLaunchArgs, launchCdpBrowser } = require('./helpers/cdp-browser');
+
+const FIXTURE_EXIT = path.join(__dirname, 'fixtures', 'fake-browser-exit.js');
+const FIXTURE_HANG = path.join(__dirname, 'fixtures', 'fake-browser-hang.js');
+const FAST_FAIL_BUDGET_MS = 5000;
+
+function isPidAlive(pid) {
+  try { process.kill(pid, 0); return true; }
+  catch (error) { return error.code === 'EPERM'; }
+}
+
+async function waitForPidExit(pid, timeoutMs = 8000) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    if (!isPidAlive(pid)) return false;
+    await new Promise(resolve => setTimeout(resolve, 100));
+  }
+  return isPidAlive(pid);
+}
+
+async function expectLaunchFailure(scenario) {
+  const pidFile = path.join(os.tmpdir(), `pk-cdp-failure-${scenario}-pid-${process.pid}.txt`);
+  const profileDir = path.join(os.tmpdir(), `pk-cdp-failure-${scenario}-profile-${process.pid}`);
+  process.env.KB_FAKE_BROWSER_PIDFILE = pidFile;
+  try {
+    const start = Date.now();
+    let error = null;
+    try {
+      await launchCdpBrowser(scenario.options(profileDir));
+    } catch (caught) {
+      error = caught;
+    }
+    const durationMs = Date.now() - start;
+    assert(error, `${scenario.name}: launchCdpBrowser must reject`);
+    assert(durationMs < FAST_FAIL_BUDGET_MS, `${scenario.name}: must fail fast, took ${durationMs}ms`);
+    const message = error.message;
+    assert(message.includes(process.execPath), `${scenario.name}: error must include executable path, got: ${message}`);
+    assert(message.includes(profileDir), `${scenario.name}: error must include user-data-dir, got: ${message}`);
+    scenario.assertions(message, durationMs);
+    assert(!fs.existsSync(profileDir), `${scenario.name}: profile dir must be cleaned after failed launch`);
+    assert(fs.existsSync(pidFile), `${scenario.name}: fixture pid file missing; cannot verify cleanup`);
+    const pid = Number.parseInt(fs.readFileSync(pidFile, 'utf8').trim(), 10);
+    const stillAlive = await waitForPidExit(pid);
+    assert(!stillAlive, `${scenario.name}: spawned child pid ${pid} still alive after failure cleanup`);
+    return durationMs;
+  } finally {
+    delete process.env.KB_FAKE_BROWSER_PIDFILE;
+    try { fs.rmSync(pidFile, { force: true }); } catch {}
+    try { fs.rmSync(profileDir, { recursive: true, force: true }); } catch {}
+  }
+}
+
+(async () => {
+  assert.strictEqual(isWindowsChromeLauncher('C:/Program Files/Google/Chrome/Application/chrome.exe'), process.platform === 'win32');
+  assert.strictEqual(isWindowsChromeLauncher(process.execPath), false);
+  assert.deepStrictEqual(platformLaunchArgs('linux'), ['--disable-dev-shm-usage', '--no-sandbox']);
+  assert.deepStrictEqual(platformLaunchArgs('win32'), []);
+  const exitDuration = await expectLaunchFailure({
+    name: 'immediate-exit',
+    options: profileDir => ({
+      chrome: process.execPath,
+      prependArgs: [FIXTURE_EXIT],
+      profileDir,
+      url: 'http://127.0.0.1:1/',
+    }),
+    assertions(message) {
+      assert(message.includes('exit code: 3'), `immediate-exit: error must contain exit code, got: ${message}`);
+      assert(message.includes('fake-browser-exit stderr: simulated browser crash before CDP'), `immediate-exit: error must contain stderr tail, got: ${message}`);
+    },
+  });
+  console.log(`cdp-browser immediate-exit failure test PASS (${exitDuration}ms)`);
+
+  const hangDuration = await expectLaunchFailure({
+    name: 'hang-timeout',
+    options: profileDir => ({
+      chrome: process.execPath,
+      prependArgs: [FIXTURE_HANG],
+      profileDir,
+      url: 'http://127.0.0.1:1/',
+      launchTimeoutMs: 1500,
+      // Single attempt keeps this scenario a bounded fast-failure check; the
+      // production default retries transient stalls (see launchCdpBrowser).
+      launchAttempts: 1,
+    }),
+    assertions(message, durationMs) {
+      assert(message.includes('DevToolsActivePort'), `hang-timeout: error must mention DevToolsActivePort wait, got: ${message}`);
+      assert(durationMs < FAST_FAIL_BUDGET_MS, `hang-timeout: bounded duration, took ${durationMs}ms`);
+    },
+  });
+  console.log(`cdp-browser hang-timeout failure test PASS (${hangDuration}ms)`);
+})().catch(error => {
+  console.error(error.stack || error.message);
+  process.exitCode = 1;
+});

package/module-runtime-manifest.json

@@ -9,9 +9,9 @@
     "plugins/project-knowledge/hooks/codex.json": "216e03c07295606ef6ebb2c4f669ad0d790b5e7c4f3f34600488033db75e4239",
     "plugins/project-knowledge/scripts/context-hook.cjs": "da666153ad5723592cce42d25337ae649f7d93e43fab76b3c6d1263933de063f",
     "plugins/project-knowledge/scripts/mcp-launcher.cjs": "7c68830b5c73eb53ef030756a4de33987f7eab6b1a6cc15602835aac3f954893",
-    "plugins/project-knowledge/.claude-plugin/plugin.json": "9d62789c8928d1ba03770fe6baeeb3c8d78148917cbb919113a29d5213ac2dab",
-    "plugins/project-knowledge/.codex-plugin/plugin.json": "ada70f6fdc68f254239d68e41572a7615e08dc1780c1ad86fb64c5c1cd5abeb6",
-    "plugins/project-knowledge/.mcp.json": "8774ced0ad45fceee59721002a195062f2c1a2bee0c9f78c47dc10cf10971547",
+    "plugins/project-knowledge/.claude-plugin/plugin.json": "40a10c34cbc5adb4a6a8a2d5f2d9ecad81705a23b884ae5fb0c3d86e75d7b1c8",
+    "plugins/project-knowledge/.codex-plugin/plugin.json": "6be99f95fb81d225d07ba76c08af8f0dcc12d0eb705b105e38178e530fca076e",
+    "plugins/project-knowledge/.mcp.json": "c6077d29401f0f85b19830358e5be2f4667b100834ec265b0f39b96049b87e1e",
     "ui/live-client.js": "0d81fa894c629bb839e1931fc3c5ebad4d831aae8232d6ce8c0f542e9e3559e8"
   },
   "modules": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanqianx/project-knowledge",
-  "version": "5.0.18-rc.4",
+  "version": "5.0.18",
   "description": "Knowledge base manager with Git integration, AI-driven analysis, and bilingual (zh-CN/en-US) knowledge output",
   "main": "_site/server.js",
   "scripts": {

package/plugins/project-knowledge/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "project-knowledge",
   "hooks": "./hooks/claude.json",
-  "version": "5.0.18-rc.4",
+  "version": "5.0.18",
   "description": "Read durable project decisions and implementation history from Project Knowledge.",
   "author": {
     "name": "SanQianX",

package/plugins/project-knowledge/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "project-knowledge",
-  "version": "5.0.18-rc.4",
+  "version": "5.0.18",
   "description": "Read durable project decisions and implementation history from Project Knowledge.",
   "author": {
     "name": "SanQianX",

package/plugins/project-knowledge/.mcp.json

@@ -8,7 +8,7 @@
         "const fs=require('fs'),path=require('path'),os=require('os');const PKG='@sanqianx/project-knowledge',SC='project-knowledge/integration-runtime/v1';let f='';const root=process.env.CLAUDE_PLUGIN_ROOT||process.env.PLUGIN_ROOT;if(root){f=path.join(root,'scripts','mcp-launcher.cjs');if(!fs.existsSync(f))f=''}if(!f){const dd=process.env.KB_DATA_DIR||path.join(os.homedir(),'.project-knowledge-v5');try{const bp=path.join(dd,'integration-runtime.json');const st=fs.statSync(bp);if(st.isFile()&&st.size<=32768){const b=JSON.parse(fs.readFileSync(bp,'utf8'));if(b&&b.schema===SC&&b.packageName===PKG&&typeof b.packageRoot==='string'&&path.isAbsolute(b.packageRoot)){const c=path.join(b.packageRoot,'plugins','project-knowledge','scripts','mcp-launcher.cjs');const rr=fs.realpathSync(b.packageRoot),cr=fs.realpathSync(c);const rel=path.relative(rr,cr);if(rel&&rel!=='..'&&!rel.startsWith('..'+path.sep)&&!path.isAbsolute(rel)&&fs.statSync(cr).isFile())f=cr}}}catch(e){}}if(!f){console.error('[project-knowledge-mcp] 未能通过受信任插件根或已验证的安装绑定定位启动器，已停止；不访问网络，也不加载工作目录源码。');process.exit(127)}require(f);"
       ],
       "env": {
-        "KB_PLUGIN_VERSION": "5.0.18-rc.4"
+        "KB_PLUGIN_VERSION": "5.0.18"
       }
     }
   }