@sanqianx/project-knowledge 5.0.9-rc.16 → 5.0.9-rc.18

package/.claude-plugin/marketplace.json

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

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [5.0.9-rc.18] - 2026-10-12
+
+- Project resolution for MCP and CLI now reports the vector-hub storage root
+  selected in settings, not the retired shell database path. A running tool
+  rereads root changes; resolution does not move files or rebuild indexes.
+- Preserve the reproduced rc.17 diagnostic mismatch and add Node 22/24
+  coverage for configured, changed and unset roots and MCP output.
+- Retain existing v5 data and all accepted module pins. Publish to next;
+  stable latest remains behind official-package and actual-user acceptance.
+
+## [5.0.9-rc.17] - 2026-10-11
+
+- Pin Workbench 0.13.2-rc.6. Repeated embedded notifications for the current
+  project no longer abandon a newly created session; real project changes and
+  late project lookups still preserve isolation and per-project drafts.
+- Keep a healthy progress stream labelled as connected on redundant online
+  events. Verify actual offline cleanup, snapshot recovery and exactly one
+  restored SSE connection with a real browser and HTTP proxy.
+- Preserve the rc.16 real Workbench failure and require official-package
+  streaming/citation acceptance before upgrading the actual user instance.
+- No data reset or third-party configuration overwrite. Stable latest remains
+  behind the full candidate and installed-product acceptance gates.
+
 ## [5.0.9-rc.16] - 2026-10-11
 
 - Pin Workbench 0.13.2-rc.5. Bound OpenCode's health request at both

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

@@ -113,7 +113,7 @@ async function createMcpClient() {
     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.getIndexPath());
+    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');

package/_site/_test/product-progress-status-test.js

@@ -0,0 +1,70 @@
+'use strict';
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const http = require('node:http');
+const { spawnServer } = require('./helpers/spawn-server');
+const { findChrome } = require('./helpers/find-chrome');
+const { launchCdpBrowser, waitFor } = require('./helpers/cdp-browser');
+
+const ROOT = path.resolve(__dirname, '../..');
+async function main() {
+  const fixture = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-product-progress-'));
+  const snapshot = { projects: [], runs: [], events: [], memories: [], sharedScopes: [] };
+  let connections = 0, snapshots = 0, healthRequests = 0;
+  const streams = new Set();
+  const upstream = http.createServer((req, res) => {
+    if (req.url === '/api/progress') {
+      connections++; streams.add(res); res.on('close', () => streams.delete(res));
+      res.writeHead(200, { 'Content-Type': 'text/event-stream', 'Cache-Control': 'no-cache' });
+      res.write(`event: snapshot\ndata: ${JSON.stringify(snapshot)}\n\n`);
+      return;
+    }
+    req.resume();
+    if (req.url === '/api/snapshot') snapshots++;
+    if (req.url.includes('/health')) healthRequests++;
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify(req.url === '/api/snapshot' ? snapshot : req.url === '/api/projects' ? { projects: [] } : { ok: true, name: 'knowledge-engine', dataSchemaVersion: 3 }));
+  });
+  await new Promise(resolve => upstream.listen(0, '127.0.0.1', resolve));
+  const moduleUrl = `http://127.0.0.1:${upstream.address().port}`;
+  const port = 8400 + process.pid % 200;
+  const base = `http://127.0.0.1:${port}`;
+  const server = spawnServer({ root: ROOT, port, dataDir: path.join(fixture, 'data'), analysisOwner: 'engine', tag: 'product-progress', extraEnv: {
+    KB_TERMINAL_URL: moduleUrl, KB_VECTORHUB_URL: moduleUrl,
+    KB_EVENTBRIDGE_URL: moduleUrl, KB_KNOWLEDGE_ENGINE_URL: moduleUrl,
+  } });
+  let browser;
+  try {
+    await waitFor(async () => { try { return (await fetch(base + '/api/health')).ok; } catch { return false; } }, 'isolated product', 20000);
+    browser = await launchCdpBrowser({ chrome: findChrome(), profileDir: path.join(fixture, 'browser'), url: base, width: 1920, height: 1080 });
+    await browser.setViewport(1920, 1080);
+    const run = expression => browser.evaluate(expression);
+    const status = () => run("document.getElementById('activityConnection').textContent");
+    await waitFor(async () => await status() === '已连接实时更新', 'initial SSE snapshot');
+    assert.equal(connections, 1);
+    for (let attempt = 0; attempt < 2; attempt++) {
+      const beforeHealth = healthRequests, beforeSnapshot = snapshots;
+      await run("window.dispatchEvent(new Event('online'))");
+      await waitFor(() => healthRequests > beforeHealth && snapshots > beforeSnapshot, 'online registry and snapshot refresh');
+      assert.equal(await status(), '已连接实时更新', 'a duplicate online event must not leave a healthy stream labelled as recovering');
+      assert.equal(connections, 1, 'a redundant online receipt cannot create another progress subscription');
+    }
+    await browser.send('Network.enable');
+    await browser.send('Network.emulateNetworkConditions', { offline: true, latency: 0, downloadThroughput: -1, uploadThroughput: -1 });
+    await waitFor(async () => (await status()).includes('连接中断'), 'genuine offline feedback');
+    await waitFor(() => streams.size === 0, 'offline closes the upstream stream');
+    await browser.send('Network.emulateNetworkConditions', { offline: false, latency: 0, downloadThroughput: -1, uploadThroughput: -1 });
+    await waitFor(async () => await status() === '已连接实时更新' && connections === 2, 'new snapshot and stream after real reconnection');
+    assert.equal(streams.size, 1);
+    assert.equal(browser.exceptions.length, 0);
+    console.log('product-progress-status-test PASS (real product/browser/proxy/SSE; duplicate online stays connected; real offline reconnects once)');
+  } finally {
+    await browser?.close(); await server.cleanup();
+    upstream.closeAllConnections(); await new Promise(resolve => upstream.close(resolve));
+    assert.equal(path.dirname(fixture), path.resolve(os.tmpdir())); assert.ok(path.basename(fixture).startsWith('pk-product-progress-'));
+    fs.rmSync(fixture, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 });
+  }
+}
+main().catch(error => { console.error(error.stack || error.message); process.exitCode = 1; });

package/_site/_test/vector-storage-root-test.js

@@ -3,11 +3,27 @@ const assert = require('node:assert/strict');
 const path = require('node:path');
 const { StorageLayout } = require('../lib/storage-layout');
 const { ModuleBridge } = require('../lib/module-bridge');
+const { KnowledgeToolRuntime } = require('../lib/knowledge-tool-runtime');
 const root = path.resolve('D:/knowledge storage 中文');
 const layout = new StorageLayout({ dataDir: path.resolve('D:/metadata') });
 assert.equal(layout.getVectorRootPath({ knowledge: { rootPath: root } }), path.join(root, '.indexes'));
 assert.equal(layout.getVectorRootPath({ knowledge: { rootPath: '' } }), path.join(layout.getDataDir(), 'vectorhub'));
 const settingsStore = { read: () => ({ knowledge: { rootPath: root }, brain: { id: 'brain-default', domains: [] } }) };
+let knowledgeRoot = root;
+const tools = new KnowledgeToolRuntime({
+  layout,
+  settingsStore: { read: () => ({ knowledge: { rootPath: knowledgeRoot } }) },
+  registryStore: { listIds: () => ['project-storage'] },
+  projectStore: {
+    readConfig: () => ({ displayName: 'Storage', repoPath: path.join(root, 'repo'), knowledgePath: path.join(root, 'project') }),
+    readState: () => ({ index: { generation: 3 } }),
+  },
+});
+assert.equal(tools.resolveProject({ projectId: 'project-storage' }).indexPath, path.join(root, '.indexes'), 'MCP/CLI resolution must report the vector-hub location, not the retired shell database');
+knowledgeRoot = path.join(root, 'changed root');
+assert.equal(tools.resolveProject({ projectId: 'project-storage' }).indexPath, path.join(knowledgeRoot, '.indexes'), 'a running MCP process must reread the selected knowledge root');
+knowledgeRoot = '';
+assert.equal(tools.resolveProject({ projectId: 'project-storage' }).indexPath, path.join(layout.getDataDir(), 'vectorhub'));
 const bridge = new ModuleBridge({ settingsStore, dataDir: layout.getDataDir() });
 const spec = bridge._supervisedSpecs().find(spec => spec.name === 'vector-hub');
 assert.equal(spec.env.VECTOR_HUB_ROOT, path.join(root, '.indexes'));

package/_site/lib/knowledge-tool-runtime.js

@@ -163,7 +163,7 @@ class KnowledgeToolRuntime {
       repoPath: path.resolve(resolvedRepoPath || config.repoPath),
       knowledgePath: path.resolve(config.knowledgePath),
       kbPath: path.resolve(config.knowledgePath),
-      indexPath: this.layout.getIndexPath(),
+      indexPath: this.layout.getVectorRootPath(this.settingsStore.read({ allowMissing: true })),
       primarySpaceId: `project:${projectId}`,
       relatedProjectIds: Array.isArray(config.relatedProjectIds) ? [...config.relatedProjectIds] : [],
       index: { ...state.index },

package/module-runtime-manifest.json

@@ -2,7 +2,7 @@
   "schema": "project-knowledge/module-content/v1",
   "productFiles": {
     "ui/index.html": "5cc3f9519a0671e7d5b24a94987a96b7ee81d3ed3367e3c02cd70934f08e64c8",
-    "ui/product.js": "714295970c175e4ada8155422dd3b1a013e9f452efc713f528373b36030ca26d",
+    "ui/product.js": "e7ac0fc1d1d515039f981ed8481155d112034dc4961a2e7259864720f54c83ea",
     "ui/product.css": "70547d3f2c53b6cc5c73cb95eb8cb3faf0dc8ccee7cd6b11a89a88885de7c3f8",
     "ui/favicon.svg": "c48be946b224112ebb0238b44263f7a61bda31e531afa895c2e9801c0ff24f32"
   },
@@ -10,12 +10,12 @@
     "terminal": {
       "name": "@sanqianx/claude-ai-workbench",
       "installName": "claude-ai-workbench",
-      "version": "0.13.2-rc.5",
+      "version": "0.13.2-rc.6",
       "files": {
         "LICENSE": "c1b9df1275e769f3dbab000d1e457a2d4b0f28eb5da6c77e48dc37eeba202ed7",
-        "README.md": "514097cc681e79b9e29c04fcd60cc567f5e896b6d8415fd1e643da0b18772b48",
+        "README.md": "5a382c531372deaa63b3e014f4dbd077d41ce02efee40347973463081848cb86",
         "apps/agent-terminal/app.css": "39cc65ac65bcb390f4aa21d9b783182ca229557f6bec15090f69598120161917",
-        "apps/agent-terminal/app.js": "2fedcc79f9515ebae89d1c7dc996d732aa1d0946038eaaa045438121bf27f551",
+        "apps/agent-terminal/app.js": "16486a5def42174f6ce75fcf3866b6eb965a56eae827b0b4f91882346ab6f1df",
         "apps/agent-terminal/index.html": "6a52ba210696c8aed99e2786e21d2771340070d51583199dd74c8da41edf0257",
         "apps/ai-profile-settings-host/index.html": "bc158f68954506d2b8e43c690f28dbe931eff9a02b1524855ac17e74ea4df736",
         "apps/ai-profile-settings-host/page.css": "8b75cbf7f1ea5aaa92f2889390720ece310a8fd4b9ca38c890fa447d4323a557",
@@ -27,20 +27,20 @@
         "apps/minimal-test-host/README.md": "fa73136f4ee3865c2d91eb97b2e8c03679aa4688e44c1e1c8ec6e27d604b0de5",
         "docs/sdk/FILE_LAYOUT.md": "17882f96505c8161bfb66876684b9d2d3f50021a111b8b844502d3cb4e97870a",
         "docs/sdk/INTEGRATION.md": "d4c0c80d2d2fc610205102d703a429bfaa20f9f3a48f1718f5bab02ee90138df",
-        "docs/sdk/openapi.yaml": "a8d38234527724917063bf48b90181d807d35fb69b0103d2dcab88d5bd355400",
+        "docs/sdk/openapi.yaml": "43f4476ce8511efb5668f3236cd3e27de890c171eedb2366670626754b9247e6",
         "docs/sdk/README.md": "7ab591d39c36a3b84cfdf487ff567040ec453975f3ef0fba86dc822094667b61",
-        "package.json": "35991e7dd59ed2e1ffce8187d6b6e8b569b645a5c573453d0aa0d2f87355bdfa",
+        "package.json": "34e4bf492c3095d74ed04d9e3d8c9d288e07f681566622ce12621a27e83533c1",
         "packages/client/index.d.ts": "fb66b7b21ac936cddcb7f74543cf4f3bb7e80c169534ec249ab8ef2356224162",
         "packages/client/index.js": "92fe5ddd32289d729f336f669e47bd9601e562f5a4309ee4fa7f7f15b567edc2",
-        "packages/client/package.json": "a91ce48904429c67c7f460d7e1cb424f52d36e784c3318677bea0a24beddd48f",
+        "packages/client/package.json": "287b0669ef32b04986596ef0fede6d3b07025814548127b9d1edda0dca9c6fc5",
         "packages/client/README.md": "342dff9b1dcbc85fccc9b980ed3e4e455aa71133af1d0805b8431ea2ac564ef8",
         "packages/contracts/index.d.ts": "edc717067bfb864c6c95df0c408a799fbf90b7552519131e6dc35af3f9eb9006",
         "packages/contracts/index.js": "565b4a88190dbb8994cd0a9309b30b00f64305d65505fff9fa360d7ce69dfb58",
-        "packages/contracts/package.json": "b70a3f0c47c6aeafc82c8095a0877fb2e5acb53dc9416924c93bb710d18d748f",
+        "packages/contracts/package.json": "0902c2cd6e262823d774d8d2cd07c0726680e8f26d4f06afc80aa385c9a4524b",
         "packages/contracts/README.md": "44d83a3cc508cec6c5c20dfa1f2c08d5ea03e3afb2853639fdc0a9cc8eb5b9c8",
         "packages/core/index.d.ts": "c95b24a13f8aeeb128497833cf298790563baca6036ea5d29a9d8daff53199d7",
         "packages/core/index.js": "5579ceb1a63d3f962f5656c75f82cf60cd834fd270b4aa95e581bf38e4432448",
-        "packages/core/package.json": "6014f4fa87dba65ccb98446b37b3f1178e6201025700adf5f3ac16176562bea3",
+        "packages/core/package.json": "0d4672540365af4a40028e0cd0f2f838e73936d4ae3d11fa71f7770289a36b38",
         "packages/core/README.md": "e222c546104a168f1038d95c6c4efb8e5603edd6145ab2cab79cab977fb710e5",
         "packages/server/bin/agent-terminal-server.js": "043dff4d76e3fd213b666a55e581ed1e72f9e5b8de6cb798fbf42bd39ed26861",
         "packages/server/bin/claude-workbench-server.js": "b03c730b6d86faf6974afea26c74109d59b1bbc1ecc656c1d6270258708694ac",
@@ -74,7 +74,7 @@
         "packages/server/lib/system-doctor.js": "2b0e858d69d8fb268eaed950c9883473ee9850684b532bc2db8e14674a974919",
         "packages/server/lib/ui-preferences-store.js": "e108cb22e7cc1f3438704913d5401e01de2c0e717eb2abd3bdc4727209393819",
         "packages/server/lib/workbench-service.js": "92b9323db8742bbdd69abd111c81cab86b225103596f6818b007fbfe2376fc6f",
-        "packages/server/package.json": "7b8f95ecb73936a377809dc95bf5210e04ffa708958f9a8d32bd867409791703",
+        "packages/server/package.json": "5d0256b88560fb71b7ed544d0799749e3bee3915326c3513a605a5574283b2b9",
         "packages/server/README.md": "a34cfaa4f4e859008b44e2be8e1aafb56e97fe83e6129c968a8562945fa843f3",
         "packages/ui/ai-profile-settings.d.ts": "0551b6c6eda6d18ea89a976daddf01b2161195f4874fe2d67a57cd9ecc6ce643",
         "packages/ui/ai-profile-settings.js": "e92bbac67a1199d473e4e44b32d1cc76c5b6c79306d4fef9d9067a1bb6ec42ca",
@@ -82,7 +82,7 @@
         "packages/ui/claude-terminal.js": "96bd217a4a7e4792ae3fbaaf46249ecee13b0f4e01fc6d25a1b8b22d8f8fe00c",
         "packages/ui/index.d.ts": "e547ab39640fe7519fb367b78442dc8a2c51b2efd17b66f8b0a003b154b36ead",
         "packages/ui/index.js": "f4394aabd395938f5c3fe587e430471d4033e83945a9b9c7e0149ad4040982c9",
-        "packages/ui/package.json": "de838d552b22a23dbfc1c426628953adc5f9f284a2b2a028b16a2061f8560e6d",
+        "packages/ui/package.json": "3710b0d80c29435e9845cea8e03ec056cee5818d360a653c2c6fbc9de47b7ab1",
         "packages/ui/README.md": "793c4a9c286fee23f39062a1976ca3afe9d2816dcdb55e156ba940e1ef514f89",
         "packages/ui/theme.css": "8f03a081272a7db11b196f7a70d0fafb1f8d954778f329f1ba53d110d9d5fd98",
         "src/assets/claude-prompts.json": "cb111f2e0a45afe8a31c251a504d1ab5375966ed61291660e61fd2efd77f6d9f",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanqianx/project-knowledge",
-  "version": "5.0.9-rc.16",
+  "version": "5.0.9-rc.18",
   "description": "Knowledge base manager with Git integration, AI-driven analysis, and bilingual (zh-CN/en-US) knowledge output",
   "main": "_site/server.js",
   "scripts": {
@@ -84,7 +84,7 @@
     "@sanqianx/vector-hub": "1.0.8-rc.3",
     "buffer": "^6.0.3",
     "cheerio": "^1.2.0",
-    "claude-ai-workbench": "npm:@sanqianx/claude-ai-workbench@0.13.2-rc.5",
+    "claude-ai-workbench": "npm:@sanqianx/claude-ai-workbench@0.13.2-rc.6",
     "cross-spawn": "7.0.6",
     "dotenv": "^17.4.2",
     "gpt-tokenizer": "^3.4.0",

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

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "project-knowledge",
-  "version": "5.0.9-rc.16",
+  "version": "5.0.9-rc.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.9-rc.16",
+  "version": "5.0.9-rc.18",
   "description": "Read durable project decisions and implementation history from Project Knowledge.",
   "author": {
     "name": "SanQianX",

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

@@ -6,7 +6,7 @@
       "args": [
         "-y",
         "--package",
-        "@sanqianx/project-knowledge@5.0.9-rc.16",
+        "@sanqianx/project-knowledge@5.0.9-rc.18",
         "project-knowledge-mcp"
       ]
     }

package/ui/product.js

@@ -451,7 +451,7 @@
     renderSystem(); render();
   });
   window.addEventListener('online', () => {
-    $('activityConnection').textContent = '正在恢复快照'; refreshRegistry();
+    $('activityConnection').textContent = state.engineAvailable && state.stream?.readyState === EventSource.OPEN ? '已连接实时更新' : '正在恢复快照'; refreshRegistry();
     if ($('logsDialog').open) loadLogs().catch(error => toast(error.message));
   });
   window.addEventListener('beforeunload', () => { state.stream?.close(); logStream?.close(); });