@sanqianx/project-knowledge 5.0.12-rc.2 → 5.0.12-rc.3

package/.claude-plugin/marketplace.json

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

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [5.0.12-rc.3] - 2026-10-12
+
+- 修复点名源文件的需求被相似历史向量结果挤出的情况；已有文件标识先匹配知识依据，新文件名仍可检索相似背景。
+- 修复 ZCode 安装目录变化时残留旧上下文入口；只替换明确属于本产品的脚本，去除重复入口，保留第三方 Hook、采集及模型。
+- 保留真实模型首轮失败和再次验证记录，未完成 Codex 原生信任审核前不提升 latest。
+
 ## [5.0.12-rc.2] - 2026-10-12
 
 - 修正自动上下文的当前记忆与历史事实边界，保留编辑时间及项目、领域、全局的适用优先级。

package/_modules/knowledge-engine/README.md

@@ -77,6 +77,8 @@ node src/bin.js serve [--port 5790] [--host 127.0.0.1] [--data DIR]
 
 上下文明确区分当前已确认记忆与历史事实：项目约定优先于领域，领域优先于全局；同范围冲突参考记忆的更新时间。历史提交中的旧实现、偏好描述不能覆盖本次下发的现行记忆；记忆也不扩大当前用户授权或替代安全限制。保留旧事实及其提交依据，不删除历史来制造新记忆生效的结果。
 
+检索中明确命名且当前知识已有依据的源文件与 commit 标识优先做身份匹配，再进行语义排序，避免重复历史范例挤出指定文件。尚无知识依据的新文件名仍允许检索相似背景；不把没有范围授权的项目或原始会话当作匹配来源。
+
 - journal 游标按来源隔离；证据投影及可恢复任务先落盘，再 ACK。不等待模型才能消费下一条事件。
 - 会话来源接受 bridge 的四客户端契约（Claude Code、Codex、OpenCode、ZCode）。单个 journal 的非法证据不被跳过或 ACK，但不阻塞其他项目；失败位置和错误码写入日志，健康接口提供 `journal.failures`，重复轮询不刷屏，恢复后续接原游标。
 - 不同项目最多并发 2 个分析，同项目按提交顺序执行。未晋升的失败提交会阻挡本项目后续提交，不阻挡其他项目。

package/_modules/knowledge-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanqianx/ai-coding-knowledge-engine",
-  "version": "0.2.5-rc.2",
+  "version": "0.2.5-rc.3",
   "description": "Knowledge engine module for project-knowledge: commit-boundary triggered knowledge analysis/generation (trigger plane) and retrieval for development assistants (retrieval plane).",
   "license": "Apache-2.0",
   "main": "src/server.js",

package/_modules/knowledge-engine/src/retrieval.js

@@ -4,6 +4,8 @@ const path = require('node:path');
 const { KnowledgeRetrievalService } = require('./runtime/knowledge-retrieval-service');
 const { listMarkdownFiles, isExcludedKnowledgePath } = require('./runtime/markdown-knowledge-indexer');
 const { DomainError } = require('./runtime/contracts');
+const fileNames = query => [...new Set((String(query).match(/[\p{L}\p{N}_./\\-]+\.(?:cjs|mjs|js|jsx|ts|tsx|py|cs|cpp|c|h|hpp|rs|go|html|css|scss|json|ya?ml|toml|md|txt|sh|ps1)\b/giu) || []).map(value => path.posix.basename(value.replace(/\\/g, '/')).toLowerCase()))].slice(0, 20);
+const mentionsFile = (candidate, name) => new RegExp(`(?<![\\p{L}\\p{N}_-])${name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}(?![\\p{L}\\p{N}_.-])`, 'iu').test([candidate.entryId, candidate.title, candidate.chunkText, ...(candidate.metadata?.sourcePaths || [])].join('\n'));
 
 class EngineRetrieval extends KnowledgeRetrievalService {
   constructor(options) { super(options); this.store = options.store; this.memories = options.memories; this.vectorUrl = options.vectorUrl || 'http://127.0.0.1:8787'; }
@@ -24,7 +26,10 @@ class EngineRetrieval extends KnowledgeRetrievalService {
       const result = super.score(candidate, signals);
       return { score: Math.max(1, result.score), selectionSignals: [...result.selectionSignals, 'exact-commit'] };
     }
-    return super.score(candidate, signals);
+    if (candidate.knownFileQuery && !candidate.fileReferences.length) return { score: 0, selectionSignals: [] };
+    const result = super.score(candidate, signals);
+    if (candidate.fileReferences?.length) return { score: Math.max(1, result.score), selectionSignals: [...result.selectionSignals, ...candidate.fileReferences.map(name => `exact-source-file:${name}`)] };
+    return result;
   }
   resolve(input = {}) {
     let project = this.store.getProject(input.projectId || input.projectSlug || input.project);
@@ -68,6 +73,10 @@ class EngineRetrieval extends KnowledgeRetrievalService {
   }
   async recallIndex(scopes, query, current, health) {
     if (!query) { health.index = 'unavailable'; return; }
+    // File identifiers, like commit IDs, select current facts before semantic
+    // ranking. A not-yet-known filename still permits analogous background.
+    const named = fileNames(query), known = named.filter(name => [...current.values()].some(candidate => mentionsFile(candidate, name)));
+    for (const candidate of current.values()) { candidate.knownFileQuery = known.length > 0; candidate.fileReferences = known.filter(name => mentionsFile(candidate, name)); }
     const mappings = scopes.map(s => ({ scope: s, registration: this.store.getProject(s.projectId) || (() => { const shared = this.store.state.sharedScopes.find(p => p.id === s.projectId); return shared ? { vectorProjectId: `scope-${shared.kind}-${shared.id}` } : null; })() })).filter(m => m.registration);
     try {
       const url = new URL('/api/search', this.vectorUrl);

package/_site/_test/native-context-integrations-test.js

@@ -45,6 +45,22 @@ async function main() {
     current.hooks.enabled = false; fs.writeFileSync(configFile, JSON.stringify(current)); assert.equal(manager.statusZCode().state, 'disabled'); assert.throws(() => manager.installZCode(), /禁用/);
     current.hooks.enabled = true; fs.writeFileSync(configFile, JSON.stringify(current)); manager.uninstallZCode();
     assert.deepEqual(JSON.parse(fs.readFileSync(configFile)), before, 'remove only the owned context entry, not capture or user config');
+    const oldScript = path.join(root, 'old-prefix/node_modules/@sanqianx/project-knowledge/plugins/project-knowledge/scripts/context-hook.cjs');
+    const oldOwned = { type: 'process', command: 'node', args: [oldScript, '--client', 'zcode'], timeoutMs: 12000 };
+    const similarThirdParty = { type: 'process', command: 'node', args: [path.join(root, 'custom/project-knowledge/scripts/context-hook.cjs'), '--client', 'zcode'] };
+    fs.writeFileSync(configFile, JSON.stringify({ ...before, hooks: { ...before.hooks, events: { ...before.hooks.events, UserPromptSubmit: [{ note: 'preserve group metadata', hooks: [thirdParty, oldOwned, similarThirdParty] }, { hooks: [oldOwned] }] } } }));
+    assert.equal(manager.statusZCode().installed, false, 'an old prefix is not current readiness');
+    manager.installZCode(); manager.installZCode();
+    const rewired = JSON.parse(fs.readFileSync(configFile));
+    const entries = rewired.hooks.events.UserPromptSubmit.flatMap(g => g.hooks);
+    assert.ok(!entries.some(h => h.args?.[0] === oldScript), 'an old managed npm path must not survive a new-prefix install');
+    assert.equal(entries.filter(h => h.args?.[0] === path.join(manager.rootDir, 'plugins/project-knowledge/scripts/context-hook.cjs')).length, 1, 'old duplicate managed entries collapse to one');
+    assert.ok(entries.some(h => JSON.stringify(h) === JSON.stringify(similarThirdParty)), 'similar third-party scripts are not owned');
+    assert.equal(rewired.hooks.events.UserPromptSubmit[0].note, 'preserve group metadata');
+    assert.deepEqual(rewired.hooks.events.Stop, before.hooks.events.Stop);
+    assert.equal(rewired.model, before.model); assert.deepEqual(rewired.env, before.env);
+    manager.uninstallZCode();
+    assert.deepEqual(JSON.parse(fs.readFileSync(configFile)).hooks.events.UserPromptSubmit[0].hooks, [thirdParty, similarThirdParty]);
     fs.writeFileSync(configFile, '{invalid'); assert.throws(() => manager.installZCode(), /JSON/); assert.equal(fs.readFileSync(configFile, 'utf8'), '{invalid');
     const endpoint = { schema: 'project-knowledge/runtime-endpoint/v1', host: '127.0.0.1', pid: process.pid, port: 12345, startedAt: 'test' }; fs.writeFileSync(path.join(root, 'runtime-endpoint.json'), JSON.stringify(endpoint));
     for (const client of ['codex', 'zcode']) {

package/_site/lib/zcode-context-integration.js

@@ -12,13 +12,18 @@ function configuration(file) {
 const scriptFor = root => path.join(root, 'plugins/project-knowledge/scripts/context-hook.cjs');
 const normalize = file => { const value = path.resolve(file).replace(/\\/g, '/'); return process.platform === 'win32' ? value.toLowerCase() : value; };
 function owned(hook, root) {
-  return hook?.type === 'process' && hook.command === 'node' && Array.isArray(hook.args) && hook.args.length === 3 && typeof hook.args[0] === 'string' && normalize(hook.args[0]) === normalize(scriptFor(root)) && hook.args[1] === '--client' && hook.args[2] === 'zcode';
+  if (hook?.type !== 'process' || hook.command !== 'node' || !Array.isArray(hook.args) || hook.args.length !== 3 || typeof hook.args[0] !== 'string' || !path.isAbsolute(hook.args[0]) || hook.args[1] !== '--client' || hook.args[2] !== 'zcode') return false;
+  const file = normalize(hook.args[0]);
+  // Only the exact current script or a canonical managed npm installation is
+  // ours. An unrelated script with a similar basename remains untouched.
+  return file === normalize(scriptFor(root)) || /\/node_modules\/(?:@sanqianx\/)?project-knowledge\/plugins\/project-knowledge\/scripts\/context-hook\.cjs$/i.test(file);
 }
 function status({ configFile, rootDir }) {
   const config = configuration(configFile);
-  const installed = (config.hooks?.events?.UserPromptSubmit || []).some(g => Array.isArray(g?.hooks) && g.hooks.some(h => owned(h, rootDir))) && fs.existsSync(scriptFor(rootDir));
+  const entries = (config.hooks?.events?.UserPromptSubmit || []).flatMap(g => Array.isArray(g?.hooks) ? g.hooks.filter(h => owned(h, rootDir)) : []);
+  const installed = entries.length === 1 && normalize(entries[0].args[0]) === normalize(scriptFor(rootDir)) && fs.existsSync(scriptFor(rootDir));
   const disabled = config.hooks?.enabled === false;
-  return { state: disabled ? 'disabled' : installed && config.hooks?.enabled === true ? 'installed' : 'not-installed', supported: true, installed: installed && !disabled && config.hooks?.enabled === true, detail: disabled ? 'ZCode 配置 Hook 已被用户禁用，未擅自启用。' : installed ? '原生 UserPromptSubmit 只读上下文入口已配置；MCP 插件状态不作已安装承诺。' : '开发前知识读取尚未接入；与会话采集独立。' };
+  return { state: disabled ? 'disabled' : installed && config.hooks?.enabled === true ? 'installed' : entries.length ? 'needs-repair' : 'not-installed', supported: true, installed: installed && !disabled && config.hooks?.enabled === true, detail: disabled ? 'ZCode 配置 Hook 已被用户禁用，未擅自启用。' : installed ? '原生 UserPromptSubmit 只读上下文入口已配置；MCP 插件状态不作已安装承诺。' : entries.length ? '知识读取入口仍指向旧安装或重复配置，请接入/修复；未误报就绪。' : '开发前知识读取尚未接入；与会话采集独立。' };
 }
 function install({ configFile, rootDir, dryRun }) {
   const config = configuration(configFile);
@@ -32,9 +37,13 @@ function install({ configFile, rootDir, dryRun }) {
     if (!Array.isArray(groups)) throw new Error('ZCode UserPromptSubmit 配置格式无效，未覆盖。');
     const hook = { type: 'process', command: 'node', args: [scriptFor(rootDir), '--client', 'zcode'], timeoutMs: 12000 };
     let found = false;
-    for (const group of groups) if (Array.isArray(group?.hooks)) group.hooks = group.hooks.map(h => { if (!owned(h, rootDir)) return h; found = true; return hook; });
-    if (!found) groups.push({ hooks: [hook] });
-    config.hooks.events.UserPromptSubmit = groups; config.hooks.enabled = true;
+    const updated = groups.map(group => {
+      if (!Array.isArray(group?.hooks)) return group;
+      const hooks = group.hooks.flatMap(h => { if (!owned(h, rootDir)) return [h]; if (found) return []; found = true; return [hook]; });
+      return hooks.length || !group.hooks.length ? { ...group, hooks } : null;
+    }).filter(Boolean);
+    if (!found) updated.push({ hooks: [hook] });
+    config.hooks.events.UserPromptSubmit = updated; config.hooks.enabled = true;
     AtomicFile.writeJsonAtomic(configFile, config);
   }
   return { state: dryRun ? 'planned' : 'installed', supported: true, installed: !dryRun, detail: 'ZCode 原生前置读取已配置，保留原模型、第三方 Hook 与采集入口；请重新打开会话。' };

package/module-runtime-manifest.json

@@ -7,10 +7,10 @@
     "ui/favicon.svg": "c48be946b224112ebb0238b44263f7a61bda31e531afa895c2e9801c0ff24f32",
     "plugins/project-knowledge/hooks/claude.json": "d61510327e3e1facbb4c645228e9f50cad05a88b33d80c4c22e5ba9f8b9f5359",
     "plugins/project-knowledge/scripts/context-hook.cjs": "b138fab6d8fcb35f8101ccfda565ccec694acb888f94347c5864c804ebb5e1a0",
-    "plugins/project-knowledge/.claude-plugin/plugin.json": "f7072dc643fcef385fbaa32f1266bb1321497fe3d2c7bf2b24a2da0643b4dfae",
-    "plugins/project-knowledge/.mcp.json": "7e6dcf1b813dfbf381c2237315267fe17d336a25c25b67272ddd56fadbadc546",
+    "plugins/project-knowledge/.claude-plugin/plugin.json": "2c832fe322ccd16e6086e972df5044dd31551c6f8cb85523d9ca3242d2472f00",
+    "plugins/project-knowledge/.mcp.json": "d0d898b3e9d89d29ed141b9161c2875d1d474d8bd35edeee3380687969f3b757",
     "plugins/project-knowledge/hooks/codex.json": "216e03c07295606ef6ebb2c4f669ad0d790b5e7c4f3f34600488033db75e4239",
-    "plugins/project-knowledge/.codex-plugin/plugin.json": "dd998b1ff5cd66fd86508ae68e39e70761657614ef73755ce757915079282997"
+    "plugins/project-knowledge/.codex-plugin/plugin.json": "bf1ae88a4f595bea78d651294575d951e79dc49b2935a5a79dadd76830b73967"
   },
   "modules": {
     "terminal": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanqianx/project-knowledge",
-  "version": "5.0.12-rc.2",
+  "version": "5.0.12-rc.3",
   "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.12-rc.2",
+  "version": "5.0.12-rc.3",
   "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.12-rc.2",
+  "version": "5.0.12-rc.3",
   "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.12-rc.2",
+        "@sanqianx/project-knowledge@5.0.12-rc.3",
         "project-knowledge-mcp"
       ]
     }

package/vendor-manifest.json

@@ -3,11 +3,11 @@
   "modules": {
     "knowledge-engine": {
       "name": "@sanqianx/ai-coding-knowledge-engine",
-      "version": "0.2.5-rc.2",
+      "version": "0.2.5-rc.3",
       "root": "_modules/knowledge-engine",
       "files": {
-        "README.md": "6196d476afa5180476f299f0c502258a93a4e6da55650999a6ca8d29ea569439",
-        "package.json": "eb6c04af2136c50d8e0d6c4c70a955a056130c59ea222846d6835108219ed25a",
+        "README.md": "62f620325d7776952fdd3d0c0a7ca9e4f6b95719533a83ca635077c0d9ed32d5",
+        "package.json": "5355d1f9f9703601241b29eabf16072e4295cc860668cc2730d6a7f0591637fa",
         "src/analysis-contract.js": "913a63b63fb4a4a9df071f95bbeb8f8c40ef87e2f8445ab0742086ced70ffbf7",
         "src/analysis-output.js": "95a3c19dcc9ab85d1dba7fee5b9aec80f9c000dfba89da3fd0be25a81e2fb680",
         "src/analysis-worker.js": "a105cabe6e1573b2d986b1e7a5aaf615e2fb53524156fc8e4e2c0a71f2c97e55",
@@ -20,7 +20,7 @@
         "src/index-request.js": "78f26b872299005499fff4f2d1f9e8f986784f2ff36a5cf2be2b1e7b7c7d9378",
         "src/knowledge-targets.js": "aa44ec285d16d7b1c0b63bf084058a1d6f867fa9929c753b6b0cbb24f7b20ee2",
         "src/memories.js": "6623fd27d45e297384082d078844aebd55bd0326bd657baae5919e85f9802d28",
-        "src/retrieval.js": "629c454f9ba63c56db0484c0b35486d17238e57ebf18463f6cc679e1a99e3471",
+        "src/retrieval.js": "2049f9a4d4ce2d8fb4ccf72a4420ec842b94a5a45936ec83a0a3091b92d9ef13",
         "src/runtime/README.md": "9be676eca76a7857b34d7357194e6f0ee733c22e61d962d53984715dbec7f673",
         "src/runtime/atomic-file.js": "9846b4b69db5ded811acf19a1181ef93615d93efaa542b858e552a7f3124ad23",
         "src/runtime/automation-config.js": "6498c5397be12b155829740595a1553d4dcd6eaa7db6ced3ef88fdc60218f00e",
@@ -45,7 +45,7 @@
         "ui/app.js": "33a2ba38f0dafbbb2e30a1eb3fc93476bfcaf528e124e1a9b2edd2fb69221e9e",
         "ui/index.html": "ce3565cfefd4838b11d37a91a906ef26ca5a1834844fe3f7c897b56851a3c418"
       },
-      "sourceCommit": "ab052860da449f6e1d94f51df431619a082634ec"
+      "sourceCommit": "c0d2a46d9a985c4093e23e080789afe012ed526e"
     }
   }
 }