@sanqianx/project-knowledge 5.0.18 → 5.0.19

package/package.json

@@ -1,108 +1,109 @@
-{
-  "name": "@sanqianx/project-knowledge",
-  "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": {
-    "start": "node _site/server.js",
-    "test": "node _site/_test/run-all-tests.js",
-    "release:sync": "node _site/scripts/sync-release-version.js --web-only",
-    "vendor:modules": "node _site/scripts/vendor-modules.js",
-    "runtime:verify": "node _site/scripts/verify-module-runtime.js --working-tree",
-    "release:verify": "node _site/scripts/sync-release-version.js --check --web-only && node _site/scripts/verify-module-runtime.js && node _site/scripts/verify-product-runtime.js && node _site/_test/integration-adapters-test.js",
-    "preversion": "npm run release:verify",
-    "version": "node _site/scripts/sync-release-version.js --stage --web-only",
-    "postversion": "npm run release:verify"
-  },
-  "bin": {
-    "project-knowledge": "bin/project-knowledge.js",
-    "project-knowledge-kb": "bin/project-knowledge-kb.js",
-    "project-knowledge-mcp": "bin/project-knowledge-mcp.js",
-    "project-knowledge-integrations": "bin/project-knowledge-integrations.js"
-  },
-  "engines": {
-    "node": ">=22"
-  },
-  "files": [
-    "_site/server.js",
-    "ui/index.html",
-    "ui/product.css",
-    "ui/product.js",
-    "ui/live-client.js",
-    "ui/favicon.svg",
-    "_site/lib/",
-    "_modules/knowledge-engine/",
-    "vendor-manifest.json",
-    "module-runtime-manifest.json",
-    "_site/scripts/",
-    "_site/_test/*.js",
-    "_site/_test/fixtures/",
-    "_site/start.bat",
-    "_site/stop.bat",
-    "claude-prompts.json",
-    "bin/",
-    "plugins/",
-    ".claude-plugin/",
-    ".agents/plugins/",
-    "templates/",
-    "docs/assets/",
-    "docs/README.zh-CN.md",
-    "docs/project-registry-schema.md",
-    "docs/team-knowledge-mode-a-plan.md",
-    "docs/testing-strategy.md",
-    "docs/leader-glm-workbench-playbook.md",
-    "docs/release-5.0.16-acceptance.md",
-    "docs/release-5.0.17-acceptance.md",
-    "docs/fresh-v5-start.md",
-    "README.md",
-    "NOTICE",
-    "CHANGELOG.md"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/SanQianX/project-knowledge-base.git"
-  },
-  "keywords": [
-    "knowledge-base",
-    "git",
-    "ai",
-    "claude",
-    "codex",
-    "opencode",
-    "mcp",
-    "documentation",
-    "scanner",
-    "context-pack",
-    "post-commit-hook"
-  ],
-  "author": "SanQianX",
-  "license": "Apache-2.0",
-  "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.2.141",
-    "@grpc/grpc-js": "^1.14.5",
-    "@grpc/proto-loader": "^0.8.1",
-    "@huggingface/transformers": "3.8.1",
-    "@lancedb/lancedb": "0.31.0",
-    "@modelcontextprotocol/sdk": "1.29.0",
-    "@sanqianx/ai-coding-event-bridge-console": "0.7.2",
-    "@sanqianx/vector-hub": "1.0.8-rc.8",
-    "buffer": "^6.0.3",
-    "cheerio": "^1.2.0",
-    "claude-ai-workbench": "npm:@sanqianx/claude-ai-workbench@0.13.2-rc.20",
-    "cross-spawn": "7.0.6",
-    "dotenv": "^17.4.2",
-    "gpt-tokenizer": "^3.4.0",
-    "http-proxy-agent": "7.0.2",
-    "https-proxy-agent": "7.0.6",
-    "json-colorizer": "^3.0.1",
-    "jsonc-parser": "3.3.1",
-    "openai": "^6.49.0",
-    "socks-proxy-agent": "8.0.5",
-    "turndown": "^7.2.4",
-    "uuid": "^13.0.2",
-    "wink-bm25-text-search": "^3.1.2",
-    "wink-nlp": "^2.4.0",
-    "ws": "^8.21.0",
-    "yargs": "^18.1.0"
-  }
-}
+{
+  "name": "@sanqianx/project-knowledge",
+  "version": "5.0.19",
+  "description": "Knowledge base manager with Git integration, AI-driven analysis, and bilingual (zh-CN/en-US) knowledge output",
+  "main": "_site/server.js",
+  "scripts": {
+    "start": "node _site/server.js",
+    "test": "node _site/_test/run-all-tests.js",
+    "release:sync": "node _site/scripts/sync-release-version.js --web-only",
+    "vendor:modules": "node _site/scripts/vendor-modules.js",
+    "runtime:verify": "node _site/scripts/verify-module-runtime.js --working-tree",
+    "release:verify": "node _site/scripts/sync-release-version.js --check --web-only && node _site/scripts/verify-module-runtime.js && node _site/scripts/verify-product-runtime.js && node _site/_test/integration-adapters-test.js",
+    "preversion": "npm run release:verify",
+    "version": "node _site/scripts/sync-release-version.js --stage --web-only",
+    "postversion": "npm run release:verify"
+  },
+  "bin": {
+    "project-knowledge": "bin/project-knowledge.js",
+    "project-knowledge-kb": "bin/project-knowledge-kb.js",
+    "project-knowledge-mcp": "bin/project-knowledge-mcp.js",
+    "project-knowledge-integrations": "bin/project-knowledge-integrations.js"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "_site/server.js",
+    "ui/index.html",
+    "ui/product.css",
+    "ui/product.js",
+    "ui/live-client.js",
+    "ui/favicon.svg",
+    "_site/lib/",
+    "_modules/knowledge-engine/",
+    "vendor-manifest.json",
+    "module-runtime-manifest.json",
+    "_site/scripts/",
+    "_site/_test/*.js",
+    "_site/_test/fixtures/",
+    "_site/start.bat",
+    "_site/stop.bat",
+    "claude-prompts.json",
+    "bin/",
+    "plugins/",
+    ".claude-plugin/",
+    ".agents/plugins/",
+    "templates/",
+    "docs/assets/",
+    "docs/README.zh-CN.md",
+    "docs/project-registry-schema.md",
+    "docs/team-knowledge-mode-a-plan.md",
+    "docs/testing-strategy.md",
+    "docs/leader-glm-workbench-playbook.md",
+    "docs/release-5.0.16-acceptance.md",
+    "docs/release-5.0.17-acceptance.md",
+    "docs/release-5.0.19-acceptance.md",
+    "docs/fresh-v5-start.md",
+    "README.md",
+    "NOTICE",
+    "CHANGELOG.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SanQianX/project-knowledge-base.git"
+  },
+  "keywords": [
+    "knowledge-base",
+    "git",
+    "ai",
+    "claude",
+    "codex",
+    "opencode",
+    "mcp",
+    "documentation",
+    "scanner",
+    "context-pack",
+    "post-commit-hook"
+  ],
+  "author": "SanQianX",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.141",
+    "@grpc/grpc-js": "^1.14.5",
+    "@grpc/proto-loader": "^0.8.1",
+    "@huggingface/transformers": "3.8.1",
+    "@lancedb/lancedb": "0.31.0",
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "@sanqianx/ai-coding-event-bridge-console": "0.7.2",
+    "@sanqianx/vector-hub": "1.0.8-rc.8",
+    "buffer": "^6.0.3",
+    "cheerio": "^1.2.0",
+    "claude-ai-workbench": "npm:@sanqianx/claude-ai-workbench@0.13.2-rc.21",
+    "cross-spawn": "7.0.6",
+    "dotenv": "^17.4.2",
+    "gpt-tokenizer": "^3.4.0",
+    "http-proxy-agent": "7.0.2",
+    "https-proxy-agent": "7.0.6",
+    "json-colorizer": "^3.0.1",
+    "jsonc-parser": "3.3.1",
+    "openai": "^6.49.0",
+    "socks-proxy-agent": "8.0.5",
+    "turndown": "^7.2.4",
+    "uuid": "^13.0.2",
+    "wink-bm25-text-search": "^3.1.2",
+    "wink-nlp": "^2.4.0",
+    "ws": "^8.21.0",
+    "yargs": "^18.1.0"
+  }
+}

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",
+  "version": "5.0.19",
   "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",
+  "version": "5.0.19",
   "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"
+        "KB_PLUGIN_VERSION": "5.0.19"
       }
     }
   }

package/ui/product.js

@@ -21,6 +21,7 @@
   const badge = (text, status = '') => `<span class="status ${esc(status)}">${esc(text)}</span>`;
   let toastTimer, refreshTimer, preflightTimer, editingMemoryId, logStream, logEpoch = 0, referenceEpoch = 0, snapshotEpoch = 0, registryEpoch = 0, registryPromise = null, resumeImport = false, unbindProjectId = '', unbinding = false;
   let captureEpoch = 0, captureBusy = false;
+  let registryStream = null, registryReceipt = null, registryRefreshTimer;
   async function api(url, options = {}) {
     const { allowNotReady, timeoutMs = (options.method || 'GET') === 'GET' && !url.includes('pick-folder') ? 3000 : 0, ...init } = options;
     if (init.body && typeof init.body !== 'string') init.body = JSON.stringify(init.body);
@@ -43,8 +44,12 @@
   function frameContext(key) {
     const project = activeProject();
     const frame = frames[key];
+    if (!frame.ready) return;
     const ref = key === 'terminal' ? project?.modules.terminal.projectId || project?.workspacePath : key === 'eventBridge' ? project?.modules.eventBridge.projectId || project?.workspacePath : project?.projectId;
     frame.requestId = `${state.epoch}:${key}`;
+    const signature = JSON.stringify([state.epoch, ref || '', state.scope, document.documentElement.dataset.theme, frameVisible(key)]);
+    if (frame.contextSignature === signature) return;
+    frame.contextSignature = signature;
     post(key, { type: 'kb:theme', theme: document.documentElement.dataset.theme });
     post(key, { type: 'kb:scope', scope: state.scope });
     post(key, { type: 'kb:sidebar', visible: key === 'terminal' });
@@ -148,7 +153,10 @@
     $('memoryText').value = memory.text; $('memoryScope').value = memory.scopeType || 'global';
     updateMemoryTarget($('memoryScope').value, memory.scopeId || memory.brainId);
     $('memoryOriginal').textContent = `原始总结：${memory.originalText || memory.text}`;
-    $('memoryEvidence').textContent = memory.evidence ? `${projectName(memory.evidence.projectId)} · ${memory.evidence.commitSha} / ${memory.evidence.entryId}` : '';
+    $('memoryEvidence').textContent = memory.evidence ? `${projectName(memory.evidence.projectId)} · ${memory.evidence.commitSha} / ${memory.evidence.entryId}${memory.sourceEventId || memory.evidence.sourceEventId ? ` · 用户事件 ${memory.sourceEventId || memory.evidence.sourceEventId}` : ''}` : '';
+    let eligibility = $('memoryEligibility');
+    if (!eligibility) { eligibility = document.createElement('p'); eligibility.id = 'memoryEligibility'; $('memoryEvidenceDetails').append(eligibility); }
+    eligibility.textContent = memory.eligibility ? `推荐理由：${memory.eligibility.reason || ''}\n范围依据：${memory.eligibility.scopeReason || ''}` : memory.status === 'candidate' ? '旧候选尚未按跨项目长期共识标准复核。' : '';
     $('memoryQuote').textContent = memory.evidence?.quote || '';
     $('memoryEvidenceDetails').hidden = memory.sourceType === 'manual'; $('manualMemoryHint').hidden = memory.sourceType !== 'manual';
     $('memoryFeedback').hidden = true; $('saveMemoryCandidate').hidden = memory.status !== 'candidate';
@@ -239,6 +247,21 @@
     stream.addEventListener('progress', () => { if (state.stream === stream) scheduleRefresh(); });
     stream.onerror = () => { if (state.stream === stream) $('activityConnection').textContent = '连接中断，正在恢复快照'; };
   }
+  function connectRegistryEvents() {
+    if (registryStream || !navigator.onLine) return;
+    const stream = registryStream = new ProgressSource('/api/registry/events');
+    const changed = event => {
+      if (registryStream !== stream) return;
+      let receipt; try { receipt = JSON.parse(event.data); } catch { return; }
+      const signature = `${receipt.instanceId}:${receipt.revision}`;
+      const previous = registryReceipt; registryReceipt = signature;
+      if (!previous || previous === signature) return;
+      clearTimeout(registryRefreshTimer);
+      registryRefreshTimer = setTimeout(() => { if (!document.hidden) void refreshRegistry(); }, 100);
+    };
+    stream.addEventListener('registry-snapshot', changed);
+    stream.addEventListener('registry-changed', changed);
+  }
   function refreshRegistry(force = false) {
     if (!navigator.onLine) return Promise.resolve();
     if (registryPromise && !force) return registryPromise;
@@ -612,19 +635,21 @@
   window.addEventListener('hashchange', () => setView(location.hash.slice(1)));
   window.addEventListener('offline', () => {
     snapshotEpoch++; clearTimeout(refreshTimer);
-    state.stream?.close(); state.stream = null; logStream?.close(); logStream = null; logEpoch++;
+    state.stream?.close(); state.stream = null; registryStream?.close(); registryStream = null; logStream?.close(); logStream = null; logEpoch++;
     state.engineAvailable = false; $('activityConnection').textContent = '连接中断，恢复后自动读取快照';
     renderSystem(); render();
   });
   window.addEventListener('online', () => {
+    connectRegistryEvents();
     $('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(); });
+  window.addEventListener('beforeunload', () => { state.stream?.close(); registryStream?.close(); clearTimeout(registryRefreshTimer); logStream?.close(); });
+  document.addEventListener('visibilitychange', () => { if (!document.hidden) { connectRegistryEvents(); void refreshRegistry(); } });
   document.addEventListener('keydown', e => { if (e.key === 'Escape') closeSystem(); });
   document.documentElement.dataset.theme = localStorage.getItem('kb.theme') === 'dark' ? 'dark' : 'light';
   all('[data-scope]').forEach(button => button.classList.toggle('active', button.dataset.scope === state.scope));
   state.view = titles[location.hash.slice(1)] ? location.hash.slice(1) : 'home';
   setView(state.view); refreshRegistry();
-  setInterval(() => { if (!document.hidden) refreshRegistry(); }, 30000);
+  connectRegistryEvents();
 })();

package/vendor-manifest.json

@@ -8,32 +8,33 @@
       "files": {
         "README.md": "677a7aaf8f6ae06477423be871306297ccfe9c3a39fa71d87cbfdbb3b83f5b7e",
         "package.json": "2e24f8fc1ac3269bdcbd9b7179edf3eff31758545e970c689ab5ae3cb1c49c41",
-        "src/analysis-contract.js": "913a63b63fb4a4a9df071f95bbeb8f8c40ef87e2f8445ab0742086ced70ffbf7",
+        "src/analysis-contract.js": "6d4b9fde0e05d9a80d43e96d0c27febf082ecdb19312faf0280d6c9b16ac71b1",
         "src/analysis-output.js": "95a3c19dcc9ab85d1dba7fee5b9aec80f9c000dfba89da3fd0be25a81e2fb680",
         "src/analysis-worker.js": "a105cabe6e1573b2d986b1e7a5aaf615e2fb53524156fc8e4e2c0a71f2c97e55",
         "src/bin.js": "22208907431d0f3a971a669c7e5eb44b3b7af9bbb36fd7ba17c3b90c4288bd70",
         "src/bridge-client.js": "ae0dba21e4286694bcd9e064ca36564ec997969ae1eb1ce4f8a6665e447cbffe",
         "src/context.js": "edd9d4942f6039dd4aaadec88533042ae130f1b80d935d87f61b071904a6688c",
-        "src/coordinator.js": "55cff6959c7ba068ea8f81dd26b57dd16ec72b7b91856a56b7fa07daea9a3c26",
+        "src/coordinator.js": "1fa012d7872e1375012ec3dcddfb6279de406529593eeb49deaa0be180eaff5b",
         "src/diagnostics.js": "f7b516ace61a1e9faaa6876930b9e2e258499a25857d1203f4e53d28bfd0fa1a",
         "src/headless-analyzer.js": "e01f81b8f24a4423c19dd8893be8c702a85edbdbb644322e3acab96c3ebaac7d",
         "src/index-request.js": "78f26b872299005499fff4f2d1f9e8f986784f2ff36a5cf2be2b1e7b7c7d9378",
         "src/knowledge-targets.js": "aa44ec285d16d7b1c0b63bf084058a1d6f867fa9929c753b6b0cbb24f7b20ee2",
-        "src/memories.js": "bba8e19380e906a80fd3e5d2a7f809d940466924578c8187d1f376f906f10f2b",
+        "src/memories.js": "7ad6701033c9a98a0d918b9745c012f9e90b8de6db6e1d870e2ebf77000a1aac",
+        "src/memory-eligibility.js": "48af31f23f81140dbc706ff83a39ba9f411314d87d01e5accfaf419c7a74e0ea",
         "src/retrieval-policy.json": "3205fb4eb114a839a74f902e6fae6a61e1460958e5a9d7e29add32b60ba4e05a",
-        "src/retrieval-ranking.js": "bc0ed48f6d1b4c8b9f8c7a0bb5a721ae3637a8b34efcd7c4c25356e46850a70d",
+        "src/retrieval-ranking.js": "061b64f5bffec3269851830b30ab51abc3260274e5207ea4864ae33d9cb22809",
         "src/retrieval.js": "32f17494eb838cc6b209df35dbe33a155c1728420c9e501a4974c4f2a1b33ceb",
         "src/runtime/README.md": "9be676eca76a7857b34d7357194e6f0ee733c22e61d962d53984715dbec7f673",
         "src/runtime/atomic-file.js": "9846b4b69db5ded811acf19a1181ef93615d93efaa542b858e552a7f3124ad23",
         "src/runtime/automation-config.js": "6498c5397be12b155829740595a1553d4dcd6eaa7db6ced3ef88fdc60218f00e",
-        "src/runtime/commit-conversation-binder.js": "4f5a7a13c3dfac3765ad70e54de351f5d81e0ed4b2b2d7ecb90ef77cb29e0c15",
+        "src/runtime/commit-conversation-binder.js": "1b3539d9218cfb9867feec3c60b5632403b73433698fc96c61418a84fe83625a",
         "src/runtime/commit-processing-ledger.js": "455aa1ac4e212c0b63d9df99e49aa94703cd24145e41aa9794f16274b2ec2e18",
-        "src/runtime/commit-prompt.js": "11856175a405c00514add6a540324a0efe3d7e5dd872c9e8a0b77f9f40abc551",
+        "src/runtime/commit-prompt.js": "db7b6942fc1a1a561c88b901075ccc2015e5cb4c2c3c673d62ac329459968494",
         "src/runtime/commit-reconciler.js": "41d0bafe43692cf37ac4e9c4b81a8bcfd828ca849cbe20d9fede237b6d001c69",
         "src/runtime/content-hash.js": "201ee7dcc054310f14097a00058cf9b28fa913367eef616e0fdd8facbf3c6c41",
         "src/runtime/contracts.js": "1088fd8bb36a5dc32a52496d54a6c7c5255c53ca5ff1fe90e42cfeb276e99044",
         "src/runtime/conversation-exclusions.js": "ef8545034b862d384fb460140490bb531b58d94992f5e2222ebaaa079b44fa63",
-        "src/runtime/conversation-store.js": "644318f9c04376a3317ced240dd94afa99a79631f0ecc394c5aa298ae2bc0474",
+        "src/runtime/conversation-store.js": "9bdfab167e2803d14cc16e66bf253e13d67d2f85d567faec8a8b08fd9f9aafd0",
         "src/runtime/evidence-bundle.js": "33d4614849d5e1d69aba8b75c3a43c18b7b6f94e5c78654c82ef631331cc94cc",
         "src/runtime/git-runner.js": "b74fe197bd4dcf3e70635ef7b1f2615edf965c1d9a3ffe5406aabd41b76d74a9",
         "src/runtime/knowledge-promotion.js": "62fbd8282f83d666f0cae9c39c97a9a9b0175473356a0da0aa3805c757b0a9c1",
@@ -47,7 +48,7 @@
         "ui/app.js": "33a2ba38f0dafbbb2e30a1eb3fc93476bfcaf528e124e1a9b2edd2fb69221e9e",
         "ui/index.html": "ce3565cfefd4838b11d37a91a906ef26ca5a1834844fe3f7c897b56851a3c418"
       },
-      "sourceCommit": "10c940a2425daaf27d24500c6f2ba21b79cb91d4"
+      "sourceCommit": "1bfa9a5a7be2719935295bd243d994ebf6c51226"
     }
   }
 }