@sanqianx/project-knowledge 5.0.19 → 5.0.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (200) hide show
  1. package/.agents/plugins/marketplace.json +3 -3
  2. package/.claude-plugin/marketplace.json +1 -1
  3. package/CHANGELOG.md +5 -0
  4. package/LICENSE +201 -201
  5. package/NOTICE +5 -5
  6. package/README.md +349 -349
  7. package/_modules/knowledge-engine/README.md +4 -0
  8. package/_modules/knowledge-engine/src/analysis-failures.js +39 -0
  9. package/_modules/knowledge-engine/src/analysis-worker.js +6 -2
  10. package/_modules/knowledge-engine/src/coordinator.js +7 -0
  11. package/_modules/knowledge-engine/src/headless-analyzer.js +2 -1
  12. package/_modules/knowledge-engine/src/server.js +1 -1
  13. package/_site/_test/agent-capture-mcp-ui-test.js +67 -67
  14. package/_site/_test/ai-profile-test.js +75 -75
  15. package/_site/_test/ai-vendor-presets-test.js +91 -91
  16. package/_site/_test/automatic-context-test.js +70 -70
  17. package/_site/_test/bin-cli-test.js +230 -230
  18. package/_site/_test/bridge-adapter-test.js +95 -95
  19. package/_site/_test/bridge-consumer-service-test.js +310 -310
  20. package/_site/_test/candidate-bin-content-test.js +35 -35
  21. package/_site/_test/candidate-product-assets-test.js +13 -13
  22. package/_site/_test/candidate-release-contract-test.js +14 -14
  23. package/_site/_test/capture-hook-dedup-test.js +158 -158
  24. package/_site/_test/claude-executable-discovery-test.js +28 -28
  25. package/_site/_test/claude-session-lifecycle-sweep-test.js +252 -252
  26. package/_site/_test/cli-instance-management-test.js +62 -62
  27. package/_site/_test/client-capture-restart-e2e-test.js +189 -189
  28. package/_site/_test/codex-conversation-projection-test.js +60 -60
  29. package/_site/_test/codex-marketplace-scoped-path-test.js +186 -186
  30. package/_site/_test/codex-notify-capture-e2e-test.js +101 -101
  31. package/_site/_test/codex-notify-fanout-test.js +134 -134
  32. package/_site/_test/codex-notify-upgrade-test.js +253 -253
  33. package/_site/_test/commit-boundary-freeze-test.js +147 -147
  34. package/_site/_test/commit-conversation-binding-test.js +4 -4
  35. package/_site/_test/configuration-generation-test.js +22 -22
  36. package/_site/_test/context-pack-test.js +200 -200
  37. package/_site/_test/conversation-api-test.js +10 -10
  38. package/_site/_test/conversation-origin-test.js +15 -15
  39. package/_site/_test/cross-repo-isolation-e2e-test.js +187 -187
  40. package/_site/_test/embedding-config-test.js +32 -32
  41. package/_site/_test/fixtures/fake-browser-exit.js +10 -10
  42. package/_site/_test/fixtures/fake-browser-hang.js +10 -10
  43. package/_site/_test/fixtures/integration-busy-worker.cjs +6 -6
  44. package/_site/_test/fixtures/make-git-repos.js +92 -92
  45. package/_site/_test/fixtures/retrieval-gold-queries.json +32 -32
  46. package/_site/_test/fresh-hook-reimport-test.js +53 -53
  47. package/_site/_test/fresh-product-data-test.js +56 -56
  48. package/_site/_test/git-path-compatibility-test.js +80 -80
  49. package/_site/_test/git-validation-test.js +81 -81
  50. package/_site/_test/hook-worktree-test.js +42 -42
  51. package/_site/_test/index-builder-test.js +41 -41
  52. package/_site/_test/index-error-display-contract-test.js +10 -10
  53. package/_site/_test/integration-adapters-test.js +67 -67
  54. package/_site/_test/integration-capture-setup-test.js +118 -118
  55. package/_site/_test/integration-runtime-binding-a2-test.js +566 -566
  56. package/_site/_test/integration-runtime-binding-a3-test.js +227 -227
  57. package/_site/_test/integration-runtime-binding-test.js +473 -473
  58. package/_site/_test/integration-status-scan-test.js +29 -29
  59. package/_site/_test/kb-framework-test.js +57 -57
  60. package/_site/_test/kbpath-follow-test.js +63 -63
  61. package/_site/_test/knowledge-db-test.js +144 -144
  62. package/_site/_test/knowledge-engine-client-test.js +109 -109
  63. package/_site/_test/knowledge-maintenance-test.js +40 -40
  64. package/_site/_test/knowledge-panel-ui-contract-test.js +112 -0
  65. package/_site/_test/knowledge-scopes-test.js +37 -37
  66. package/_site/_test/knowledge-storage-location-test.js +28 -28
  67. package/_site/_test/launcher-readiness-test.js +80 -80
  68. package/_site/_test/legacy-claude-session-alias-test.js +106 -106
  69. package/_site/_test/legacy-routes-removed-test.js +47 -47
  70. package/_site/_test/legacy-workbench-exclusion-test.js +92 -92
  71. package/_site/_test/live-gateway-test.js +48 -48
  72. package/_site/_test/local-marketplace-test.js +16 -16
  73. package/_site/_test/log-redaction-test.js +58 -58
  74. package/_site/_test/markdown-maintenance-test.js +11 -11
  75. package/_site/_test/model-context-windows-test.js +89 -89
  76. package/_site/_test/module-agent-start-proxy-test.js +65 -65
  77. package/_site/_test/module-artifact-integrity-test.js +27 -27
  78. package/_site/_test/module-boundary-test.js +30 -30
  79. package/_site/_test/module-bridge-eventbridge-test.js +202 -202
  80. package/_site/_test/module-dynamic-port-test.js +118 -118
  81. package/_site/_test/module-index-proxy-test.js +33 -33
  82. package/_site/_test/module-model-configuration-test.js +44 -44
  83. package/_site/_test/module-process-lifecycle-test.js +35 -35
  84. package/_site/_test/module-stream-proxy-test.js +34 -34
  85. package/_site/_test/module-terminal-restart-test.js +63 -63
  86. package/_site/_test/module-wiring-unbind-race-test.js +59 -59
  87. package/_site/_test/native-context-integrations-test.js +86 -86
  88. package/_site/_test/orphaned-claim-recovery-test.js +80 -80
  89. package/_site/_test/package-boundary-test.js +43 -42
  90. package/_site/_test/package-startup-test.js +56 -56
  91. package/_site/_test/packaged-ui-smoke-test.js +88 -88
  92. package/_site/_test/pr-consumer-contract-test.js +55 -55
  93. package/_site/_test/product-brand-contract-test.js +25 -25
  94. package/_site/_test/product-diagnostics-ui-test.js +93 -93
  95. package/_site/_test/product-import-ui-test.js +104 -104
  96. package/_site/_test/product-progress-status-test.js +12 -1
  97. package/_site/_test/project-remove-running-guard-test.js +79 -79
  98. package/_site/_test/project-store-test.js +90 -90
  99. package/_site/_test/registry-events-test.js +38 -38
  100. package/_site/_test/release-version-sync-test.js +115 -115
  101. package/_site/_test/requirement-binding-test.js +113 -113
  102. package/_site/_test/runtime-endpoint-test.js +64 -64
  103. package/_site/_test/scanner-test.js +83 -83
  104. package/_site/_test/server-security-test.js +96 -96
  105. package/_site/_test/sessions-stream-test.js +93 -93
  106. package/_site/_test/shared-scope-root-binding-test.js +67 -67
  107. package/_site/_test/simple-import-test.js +98 -98
  108. package/_site/_test/startup-analysis-disabled-test.js +6 -6
  109. package/_site/_test/team-knowledge-store-sparse-checkout-test.js +196 -196
  110. package/_site/_test/team-knowledge-store-test.js +132 -132
  111. package/_site/_test/test-server-cleanup-test.js +35 -35
  112. package/_site/_test/test-server-module-isolation-test.js +37 -37
  113. package/_site/_test/tracking-start-test.js +35 -35
  114. package/_site/_test/workbench-context-receipts-test.js +22 -22
  115. package/_site/_test/workspace-ui-contract-test.js +31 -31
  116. package/_site/_test/zcode-capture-integration-test.js +108 -108
  117. package/_site/lib/ai-vendor-presets.js +83 -83
  118. package/_site/lib/ai-workspace.js +3 -3
  119. package/_site/lib/atomic-file.js +204 -204
  120. package/_site/lib/bridge-adapter.js +260 -260
  121. package/_site/lib/capture-hook-config.js +108 -108
  122. package/_site/lib/claude-cli-runner.js +89 -89
  123. package/_site/lib/cli-instances.js +43 -43
  124. package/_site/lib/codex-context-status.js +17 -17
  125. package/_site/lib/codex-notify-config.js +193 -193
  126. package/_site/lib/commit-conversation-binder.js +12 -12
  127. package/_site/lib/commit-reconciler.js +38 -38
  128. package/_site/lib/context-pack-builder.js +299 -299
  129. package/_site/lib/conversation-exclusions.js +204 -204
  130. package/_site/lib/conversation-query-service.js +17 -17
  131. package/_site/lib/data-dir.js +13 -13
  132. package/_site/lib/embedding-service.js +85 -85
  133. package/_site/lib/engine-connection.js +93 -93
  134. package/_site/lib/engine-knowledge-client.js +72 -72
  135. package/_site/lib/folder-picker-output.js +3 -3
  136. package/_site/lib/git-path.js +14 -14
  137. package/_site/lib/github-team-store.js +3 -3
  138. package/_site/lib/index-builder.js +157 -157
  139. package/_site/lib/integration-status-scan.js +99 -99
  140. package/_site/lib/integration-status-worker.js +14 -14
  141. package/_site/lib/kb-framework.js +15 -15
  142. package/_site/lib/knowledge-db.js +363 -363
  143. package/_site/lib/knowledge-schema.js +121 -121
  144. package/_site/lib/live-gateway.js +78 -78
  145. package/_site/lib/llm-client.js +12 -12
  146. package/_site/lib/model-context-windows.js +82 -82
  147. package/_site/lib/module-bridge.js +874 -874
  148. package/_site/lib/module-port-resolver.js +57 -57
  149. package/_site/lib/post-commit-automation.js +54 -54
  150. package/_site/lib/product-data.js +35 -35
  151. package/_site/lib/project-lifecycle-service.js +14 -14
  152. package/_site/lib/project-registry-store.js +129 -129
  153. package/_site/lib/prompt-registry.js +148 -148
  154. package/_site/lib/registry-events.js +16 -16
  155. package/_site/lib/requirement-adapters.js +10 -10
  156. package/_site/lib/requirement-binder.js +112 -112
  157. package/_site/lib/runtime-control.js +89 -89
  158. package/_site/lib/runtime-endpoint.js +5 -5
  159. package/_site/lib/zcode-context-integration.js +60 -60
  160. package/_site/scripts/codex-notify-fanout.cjs +95 -95
  161. package/_site/scripts/install-module-candidates.js +69 -69
  162. package/_site/scripts/pack-module-candidates.js +89 -89
  163. package/_site/scripts/sync-product-content.js +28 -28
  164. package/_site/scripts/sync-release-version.js +164 -164
  165. package/_site/scripts/vendor-modules.js +49 -49
  166. package/_site/scripts/verify-module-runtime.js +50 -50
  167. package/_site/scripts/verify-product-runtime.js +36 -36
  168. package/_site/scripts/verify-retrieval-gold.js +83 -83
  169. package/_site/server.js +15 -15
  170. package/_site/start.bat +26 -26
  171. package/_site/stop.bat +11 -11
  172. package/bin/project-knowledge-integrations.js +254 -254
  173. package/bin/project-knowledge-kb.js +67 -67
  174. package/bin/project-knowledge-mcp.js +8 -8
  175. package/bin/project-knowledge.js +170 -170
  176. package/claude-prompts.json +21 -21
  177. package/docs/README.zh-CN.md +205 -205
  178. package/docs/assets/architecture.svg +181 -181
  179. package/docs/assets/logo.svg +49 -49
  180. package/docs/fresh-v5-start.md +42 -42
  181. package/docs/leader-glm-workbench-playbook.md +122 -122
  182. package/docs/project-registry-schema.md +11 -11
  183. package/docs/release-5.0.16-acceptance.md +176 -176
  184. package/docs/release-5.0.17-acceptance.md +117 -117
  185. package/docs/release-5.0.19-acceptance.md +39 -25
  186. package/docs/team-knowledge-mode-a-plan.md +73 -73
  187. package/module-runtime-manifest.json +53 -33
  188. package/package.json +3 -2
  189. package/plugins/project-knowledge/.claude-plugin/plugin.json +1 -1
  190. package/plugins/project-knowledge/.codex-plugin/plugin.json +1 -1
  191. package/plugins/project-knowledge/.mcp.json +1 -1
  192. package/plugins/project-knowledge/opencode/project-knowledge.md +3 -3
  193. package/plugins/project-knowledge/skills/project-knowledge/SKILL.md +28 -28
  194. package/templates/change.md +30 -30
  195. package/templates/project-readme.md +18 -18
  196. package/ui/index.html +1 -1
  197. package/ui/knowledge-panel.html +118 -0
  198. package/ui/product.css +8 -0
  199. package/ui/product.js +146 -4
  200. package/vendor-manifest.json +55 -54
package/ui/product.js CHANGED
@@ -11,13 +11,20 @@
11
11
  eventBridge: { id: 'bridgeFrame', url: '/modules/eventbridge/?embed=1&apiBase=/api/eventbridge', view: 'activity', ready: false },
12
12
  engine: { id: 'engineFrame', url: '/modules/engine/?embed=1&apiBase=/api/engine', ready: false },
13
13
  };
14
+ // K1 knowledge panel: once the terminal reports kb:ready, the shell registers
15
+ // a same-origin iframe provider and streams structured references into it.
16
+ // The fixed knowledge column stays the fallback - it folds only after the
17
+ // workbench confirms the panel rendered the matching content version.
18
+ const knowledgePanel = { providerId: 'kb.knowledge.references', version: 0, registered: false, registering: false, failed: false, panelId: '', pending: null, collapsed: false };
19
+ const panelRequests = new Map();
20
+ let panelRequestSeq = 0;
14
21
  const state = { brain: { id: 'brain-default', name: '我的智脑', domains: [] }, root: '', projects: [], projectId: localStorage.getItem('kb.project') || '', view: 'home', scope: 'project', memoryTab: 'confirmed', activityTab: 'updates', health: {}, snapshot: { projects: [], runs: [], events: [], memories: [] }, engineAvailable: false, epoch: 0, contexts: new Map(), stream: null, refreshing: false, importId: '', preflight: null, preflightEpoch: 0 };
15
22
  const esc = value => String(value ?? '').replace(/[&<>"']/g, c => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[c]));
16
23
  const activeProject = () => state.projects.find(p => p.projectId === state.projectId);
17
24
  const domainName = id => state.brain.domains.find(d => d.id === id)?.name || '未分组';
18
25
  const projectName = id => state.projects.find(p => p.projectId === id)?.name || id;
19
26
  const time = value => value ? new Date(value).toLocaleString('zh-CN', { month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit' }) : '—';
20
- const label = run => ({ queued: '排队', running: '维护中', succeeded: '已更新 · 可检索', 'index-pending': '知识已更新 · 索引待修复', failed: '维护失败', cancelled: '已取消' })[run.state] || run.state;
27
+ const label = run => run.state === 'failed' && run.error?.code === 'MODEL_QUOTA_EXHAUSTED' ? '额度不足 · 待重试' : run.state === 'queued' && run.phase === 'waiting-previous' ? '等待前一条提交恢复' : ({ queued: '排队', running: '维护中', succeeded: '已更新 · 可检索', 'index-pending': '知识已更新 · 索引待修复', failed: '维护失败', cancelled: '已取消' })[run.state] || run.state;
21
28
  const badge = (text, status = '') => `<span class="status ${esc(status)}">${esc(text)}</span>`;
22
29
  let toastTimer, refreshTimer, preflightTimer, editingMemoryId, logStream, logEpoch = 0, referenceEpoch = 0, snapshotEpoch = 0, registryEpoch = 0, registryPromise = null, resumeImport = false, unbindProjectId = '', unbinding = false;
23
30
  let captureEpoch = 0, captureBusy = false;
@@ -56,6 +63,101 @@
56
63
  post(key, { type: 'kb:select-project', project: ref || '', projectId: project?.projectId || '', requestId: frame.requestId });
57
64
  post(key, { type: 'kb:visibility', visible: frameVisible(key) });
58
65
  }
66
+ function panelNotice(text) { $('panelNotice').textContent = text; $('panelNotice').hidden = !text; }
67
+ function setKnowledgeCollapsed(collapsed) {
68
+ knowledgePanel.collapsed = collapsed;
69
+ $('workLayout').classList.toggle('kb-panel-collapsed', collapsed);
70
+ }
71
+ // Any failure (register/open/relay/ack) restores the original full-width
72
+ // column with a non-blocking notice; drafts, events and tasks are untouched.
73
+ function knowledgePanelFailed(reason) {
74
+ if (knowledgePanel.pending) { clearTimeout(knowledgePanel.pending.timer); knowledgePanel.pending = null; }
75
+ knowledgePanel.failed = true;
76
+ knowledgePanel.registered = false;
77
+ setKnowledgeCollapsed(false);
78
+ panelNotice(`知识面板不可用(${reason}),已恢复固定知识栏。`);
79
+ }
80
+ function panelRequest(type, payload, timeoutMs = 6000) {
81
+ if (!frames.terminal.ready) return Promise.resolve({ ok: false, code: 'NOT_READY', error: '终端尚未就绪' });
82
+ return new Promise(resolve => {
83
+ const requestId = `kpanel-${++panelRequestSeq}`;
84
+ const timer = setTimeout(() => { if (panelRequests.has(requestId)) { panelRequests.delete(requestId); resolve({ ok: false, code: 'TIMEOUT', error: '面板响应超时' }); } }, timeoutMs);
85
+ panelRequests.set(requestId, reply => { clearTimeout(timer); resolve(reply); });
86
+ post('terminal', { type, requestId, ...payload });
87
+ });
88
+ }
89
+ // Plain JSON only: bounded strings, ≤50 references - the panel renders
90
+ // textContent and never interprets strings as markup.
91
+ function knowledgePayload(projectId) {
92
+ const context = state.contexts.get(projectId);
93
+ return {
94
+ title: '本次知识引用', projectId: String(projectId || ''),
95
+ status: context?.status || 'not-retrieved',
96
+ references: (context?.references || []).slice(0, 50).map(r => ({
97
+ entryId: String(r.entryId || ''), title: String(r.title || r.entryId || ''),
98
+ text: String(r.text || '').slice(0, 800), source: `${r.projectId ? projectName(r.projectId) : ''} / ${r.entryId || ''}`,
99
+ })),
100
+ };
101
+ }
102
+ // kb:ready (re)fires whenever the terminal frame loads: the workbench-side
103
+ // registry starts empty, so registration restarts from zero each time.
104
+ async function resetKnowledgePanel() {
105
+ if (knowledgePanel.registering) return;
106
+ knowledgePanel.registering = true;
107
+ knowledgePanel.registered = false; knowledgePanel.failed = false;
108
+ knowledgePanel.panelId = ''; knowledgePanel.version = 0;
109
+ if (knowledgePanel.pending) { clearTimeout(knowledgePanel.pending.timer); knowledgePanel.pending = null; }
110
+ setKnowledgeCollapsed(false);
111
+ try {
112
+ const reply = await panelRequest('kb:panel/register', { panel: {
113
+ providerId: knowledgePanel.providerId, panelType: 'knowledge', title: '本次知识引用',
114
+ url: '/knowledge-panel.html', capabilities: ['read-only'], multiInstance: 'single', appliesTo: { projects: '*' },
115
+ } });
116
+ if (reply.ok) { knowledgePanel.registered = true; panelNotice(''); void pushKnowledgeToPanel(); }
117
+ else if (!knowledgePanel.failed) knowledgePanelFailed('注册被拒绝');
118
+ } catch (error) { if (!knowledgePanel.failed) knowledgePanelFailed(error.message); }
119
+ finally { knowledgePanel.registering = false; }
120
+ }
121
+ async function pushKnowledgeToPanel(projectId = state.projectId) {
122
+ if (!knowledgePanel.registered || knowledgePanel.failed || !projectId) return;
123
+ const opened = await panelRequest('kb:panel/open', { providerId: knowledgePanel.providerId });
124
+ if (!opened.ok) { knowledgePanelFailed('面板无法打开'); return; }
125
+ if (opened.panelId) knowledgePanel.panelId = opened.panelId;
126
+ const version = ++knowledgePanel.version;
127
+ const relayed = await panelRequest('kb:panel/content', { panelId: knowledgePanel.panelId, providerId: knowledgePanel.providerId, version, content: knowledgePayload(projectId) });
128
+ if (!relayed.ok) { knowledgePanelFailed('内容投递失败'); return; }
129
+ const timer = setTimeout(() => {
130
+ if (knowledgePanel.pending && knowledgePanel.pending.version === version) {
131
+ knowledgePanel.pending = null; knowledgePanelFailed('面板未确认内容');
132
+ }
133
+ }, 8000);
134
+ knowledgePanel.pending = { version, projectId, timer };
135
+ }
136
+ function handlePanelState(message) {
137
+ const panel = (message.panels || []).find(p => p.providerId === knowledgePanel.providerId);
138
+ if (!panel) {
139
+ // The panel view was closed or the provider unregistered: the fixed
140
+ // column is the only knowledge surface again and must come back.
141
+ if (knowledgePanel.collapsed) setKnowledgeCollapsed(false);
142
+ if (knowledgePanel.pending) { clearTimeout(knowledgePanel.pending.timer); knowledgePanel.pending = null; }
143
+ return;
144
+ }
145
+ if (!knowledgePanel.pending) return;
146
+ if (panel.panelId) knowledgePanel.panelId = panel.panelId;
147
+ const pending = knowledgePanel.pending;
148
+ const ack = panel.content?.ack;
149
+ if (ack && String(ack.version) === String(pending.version)) {
150
+ clearTimeout(pending.timer);
151
+ knowledgePanel.pending = null;
152
+ // Fold the fallback column only for a version-matched, error-free ack.
153
+ if (ack.ok && !panel.error) { setKnowledgeCollapsed(true); panelNotice(''); }
154
+ else knowledgePanelFailed(ack.error || '面板渲染失败');
155
+ } else if (panel.error && panel.error !== 'CONTENT_ACK_ERROR') {
156
+ clearTimeout(pending.timer);
157
+ knowledgePanel.pending = null;
158
+ knowledgePanelFailed('面板加载失败');
159
+ }
160
+ }
59
161
  function setView(view) {
60
162
  if (!titles[view]) view = 'home';
61
163
  const changed = state.view !== view;
@@ -83,6 +185,10 @@
83
185
  localStorage.setItem('kb.project', id);
84
186
  $('projectSelect').value = id;
85
187
  Object.keys(frames).forEach(frameContext);
188
+ // A project switch re-scopes both surfaces: the fixed column expands again
189
+ // and the panel re-receives the new project's content before folding.
190
+ setKnowledgeCollapsed(false);
191
+ if (knowledgePanel.registered && !knowledgePanel.failed && frames.terminal.ready) void pushKnowledgeToPanel(id);
86
192
  render(); setView(state.view);
87
193
  }
88
194
  function renderProjectOptions() {
@@ -103,6 +209,7 @@
103
209
  if (state.view === 'memory') renderMemories();
104
210
  if (state.view === 'activity') renderActivity();
105
211
  renderContext();
212
+ renderSystem();
106
213
  }
107
214
  function renderHome(candidates) {
108
215
  if (!state.projectsLoaded) { $('homeContent').innerHTML = state.projectsError ? '<div class="empty">项目登记读取失败,未把失败当作空知识库。<button data-action="refresh">重试读取</button></div>' : '<div class="empty">正在读取项目登记…</div>'; return; }
@@ -176,12 +283,37 @@
176
283
  $('memoryFeedback').hidden = true; $('saveMemoryCandidate').hidden = true; $('confirmMemory').textContent = '确认并保存';
177
284
  $('memoryDialog').showModal(); $('memoryText').focus();
178
285
  }
286
+ function maintenanceWarning() {
287
+ const status = state.snapshot.maintenance;
288
+ if (!status || !state.engineAvailable) return null;
289
+ if (Object.hasOwn(status, 'projectId') && status.projectId !== (state.projectId || null)) return null;
290
+ if (status.journal?.error) return { title: '提交事件消费受阻', message: '部分提交可能尚未生成分析任务,请查看诊断日志并恢复事件消费。', failures: status.journal.failures || [] };
291
+ if (status.executionEnabled === false || status.consuming === false) return { title: '提交维护尚未启用', message: '请在系统状态中检查项目接线;事件消费恢复后,已捕获的提交才能进入分析队列。', failures: [] };
292
+ return null;
293
+ }
179
294
  function renderActivity() {
180
295
  all('[data-activity-tab]').forEach(button => button.classList.toggle('active', button.dataset.activityTab === state.activityTab));
181
296
  $('activityUpdates').hidden = state.activityTab !== 'updates'; $('activitySessions').hidden = state.activityTab !== 'sessions';
182
297
  const runs = (state.activityProject === state.projectId ? state.activityPage?.runs || [] : state.snapshot.runs).filter(r => r.projectId === state.projectId).map(r => ({ ...state.runDetails?.get(r.runId), ...r }));
183
298
  const open = new Set(all('.run[open]').map(d => d.dataset.runId));
184
299
  $('activityUpdates').innerHTML = state.engineAvailable ? runs.map(r => `<details class="run" data-run-id="${esc(r.runId)}" ${open.has(r.runId) ? 'open' : ''}><summary><time>${time(r.startedAt)}</time><strong>${esc(projectName(r.projectId))} · ${esc(r.commitSha.slice(0, 8))}</strong>${badge(label(r), ['failed', 'index-pending'].includes(r.state) ? 'issue' : r.state === 'succeeded' ? 'up' : '')}</summary><div><p>提交:${esc(r.commitSha)}<br>阶段:${esc(r.phase)} · 入口:${esc(r.trigger)}<br>知识晋升:${time(r.promotedAt)} · 索引:${esc(r.indexState)}</p>${r.memoryCapture?.rejected?.length ? `<p>记忆候选:${esc(r.memoryCapture.rejected.length)} 条依据无效,未纳入候选箱;有效知识已保留。可在诊断日志中查看原因。</p>` : ''}${r.error ? `<p class="error">${esc(r.error.message)} (${esc(r.error.code)})</p>${r.error.details ? `<p>失败原因:${esc(r.error.details.upstreamMessage)}<br>类别:${esc(r.error.details.failureKind)} · HTTP:${esc(r.error.details.httpStatus ?? '—')} · 上游代码:${esc(r.error.details.upstreamCode)}<br>请求标识:${esc(r.error.details.requestId || '—')} · 尝试:${esc(r.error.details.attempt)} · 耗时:${esc(r.error.details.durationMs ?? '—')} ms</p>` : ''}` : ''}${(r.staging?.operations || []).map(op => `<div class="operation">${esc(op.operation)} · ${esc(op.path)}<br>${esc(op.reason)}</div>`).join('')}${['failed', 'index-pending'].includes(r.state) ? `<button data-retry-run="${esc(r.runId)}">重试失败阶段</button>` : ''}</div></details>`).join('') || '<div class="empty">当前项目还没有知识维护记录。</div>' : '<div class="empty">知识引擎离线。记录仍保留在本机,连接恢复后自动读取。</div>';
300
+ renderMaintenanceWarning();
301
+ }
302
+ function renderMaintenanceWarning() {
303
+ const warning = maintenanceWarning();
304
+ if (warning) {
305
+ if (!all('#activityUpdates .run').length) $('activityUpdates').replaceChildren();
306
+ const notice = document.createElement('div'); notice.className = 'empty error';
307
+ const title = document.createElement('strong'); title.textContent = warning.title;
308
+ const message = document.createElement('p'); message.textContent = warning.message;
309
+ notice.append(title, message);
310
+ for (const failure of warning.failures) {
311
+ const detail = document.createElement('small');
312
+ detail.textContent = `${failure.code} · ${failure.journalId}${failure.sequence === null ? '' : ` · 事件 ${failure.sequence}`}`;
313
+ notice.append(detail);
314
+ }
315
+ $('activityUpdates').prepend(notice);
316
+ }
185
317
  }
186
318
  function renderActivityNavigation() {
187
319
  if (state.activityProject !== state.projectId || !state.engineAvailable) return;
@@ -301,6 +433,8 @@
301
433
  if (state.snapshotStale) { $('systemDot').className = 'dot issue'; $('systemTitle').textContent = '知识状态刷新未完成'; $('systemDetail').textContent = '保留上次有效内容,连接恢复后自动更新。'; }
302
434
  if (storagePending && !pending && !down.length) { $('systemDot').className = 'dot issue'; $('systemTitle').textContent = '索引目录接线待恢复'; $('systemDetail').textContent = `目标目录:${state.indexStorage.expectedPath}。请在系统状态中修复接线。`; }
303
435
  if (state.root && state.scopeStatus?.status === 'pending' && !pending && !down.length) { $('systemDot').className = 'dot issue'; $('systemTitle').textContent = '共享知识接线待恢复'; $('systemDetail').textContent = '已有知识与长期记忆保留,请在系统状态中修复接线。'; }
436
+ const maintenance = maintenanceWarning();
437
+ if (maintenance && state.health.engine?.up && !pending) { $('systemDot').className = 'dot issue'; $('systemTitle').textContent = maintenance.title; $('systemDetail').textContent = maintenance.message; }
304
438
  $('moduleHealth').innerHTML = Object.entries(modules).map(([key, name]) => `<div class="row"><div><b>${esc(name)}</b><small>${esc(state.health[key]?.url || '')}</small></div>${badge(state.health[key]?.up ? '在线' : '离线', state.health[key]?.up ? 'up' : 'issue')}</div>`).join('');
305
439
  if (!navigator.onLine) {
306
440
  $('systemDot').className = 'dot issue'; $('systemTitle').textContent = '网页连接中断';
@@ -534,11 +668,19 @@
534
668
  const key = Object.keys(frames).find(k => $(frames[k].id).contentWindow === event.source); if (!key) return;
535
669
  const message = event.data;
536
670
  if (message.type === 'kb:open-integrations' && key === 'eventBridge') { openSystem().then(() => $('agentCaptureSection').scrollIntoView({ block: 'start' })).catch(error => toast(error.message)); return; }
537
- if (message.type === 'kb:ready') { frames[key].ready = true; frameContext(key); if (frames[key].openSettings) { post(key, { type: 'kb:open-settings' }); frames[key].openSettings = false; } }
671
+ if (message.type === 'kb:ready') { frames[key].ready = true; frameContext(key); if (key === 'terminal') void resetKnowledgePanel(); if (frames[key].openSettings) { post(key, { type: 'kb:open-settings' }); frames[key].openSettings = false; } }
672
+ // Panel protocol traffic carries its own request ids and never falls into
673
+ // the frame-context staleness drop below.
674
+ if (key === 'terminal' && typeof message.type === 'string' && message.type.startsWith('kb:panel/')) {
675
+ if (message.type === 'kb:panel/state') { handlePanelState(message); return; }
676
+ const settle = panelRequests.get(message.requestId);
677
+ if (settle) { panelRequests.delete(message.requestId); settle(message); }
678
+ return;
679
+ }
538
680
  if (message.requestId && message.requestId !== frames[key].requestId) return;
539
681
  if (message.type === 'kb:knowledge' && key === 'terminal') {
540
682
  const project = state.projects.find(p => p.modules.terminal.projectId === message.projectId);
541
- if (project) { state.contexts.set(project.projectId, message.knowledge); if (project.projectId === state.projectId) renderContext(); }
683
+ if (project) { state.contexts.set(project.projectId, message.knowledge); if (project.projectId === state.projectId) { renderContext(); void pushKnowledgeToPanel(project.projectId); } }
542
684
  }
543
685
  });
544
686
  on('projectSelect', 'change', e => selectProject(e.target.value));
@@ -605,7 +747,7 @@
605
747
  state.contexts.delete(projectId);
606
748
  state.projects = state.projects.filter(project => project.projectId !== projectId);
607
749
  if (state.projectId === projectId) { state.projectId = state.projects[0]?.projectId || ''; state.epoch++; }
608
- renderProjectOptions(); render(); Object.keys(frames).forEach(frameContext);
750
+ renderProjectOptions(); setKnowledgeCollapsed(false); render(); Object.keys(frames).forEach(frameContext);
609
751
  $('unbindDialog').close(); unbindProjectId = '';
610
752
  // A late read started before DELETE cannot restore the removed project.
611
753
  await refreshRegistry(true); localStorage.setItem('kb.project', state.projectId);
@@ -1,54 +1,55 @@
1
- {
2
- "schema": "project-knowledge/vendor-runtime/v1",
3
- "modules": {
4
- "knowledge-engine": {
5
- "name": "@sanqianx/ai-coding-knowledge-engine",
6
- "version": "0.2.7-rc.10",
7
- "root": "_modules/knowledge-engine",
8
- "files": {
9
- "README.md": "677a7aaf8f6ae06477423be871306297ccfe9c3a39fa71d87cbfdbb3b83f5b7e",
10
- "package.json": "2e24f8fc1ac3269bdcbd9b7179edf3eff31758545e970c689ab5ae3cb1c49c41",
11
- "src/analysis-contract.js": "6d4b9fde0e05d9a80d43e96d0c27febf082ecdb19312faf0280d6c9b16ac71b1",
12
- "src/analysis-output.js": "95a3c19dcc9ab85d1dba7fee5b9aec80f9c000dfba89da3fd0be25a81e2fb680",
13
- "src/analysis-worker.js": "a105cabe6e1573b2d986b1e7a5aaf615e2fb53524156fc8e4e2c0a71f2c97e55",
14
- "src/bin.js": "22208907431d0f3a971a669c7e5eb44b3b7af9bbb36fd7ba17c3b90c4288bd70",
15
- "src/bridge-client.js": "ae0dba21e4286694bcd9e064ca36564ec997969ae1eb1ce4f8a6665e447cbffe",
16
- "src/context.js": "edd9d4942f6039dd4aaadec88533042ae130f1b80d935d87f61b071904a6688c",
17
- "src/coordinator.js": "1fa012d7872e1375012ec3dcddfb6279de406529593eeb49deaa0be180eaff5b",
18
- "src/diagnostics.js": "f7b516ace61a1e9faaa6876930b9e2e258499a25857d1203f4e53d28bfd0fa1a",
19
- "src/headless-analyzer.js": "e01f81b8f24a4423c19dd8893be8c702a85edbdbb644322e3acab96c3ebaac7d",
20
- "src/index-request.js": "78f26b872299005499fff4f2d1f9e8f986784f2ff36a5cf2be2b1e7b7c7d9378",
21
- "src/knowledge-targets.js": "aa44ec285d16d7b1c0b63bf084058a1d6f867fa9929c753b6b0cbb24f7b20ee2",
22
- "src/memories.js": "7ad6701033c9a98a0d918b9745c012f9e90b8de6db6e1d870e2ebf77000a1aac",
23
- "src/memory-eligibility.js": "48af31f23f81140dbc706ff83a39ba9f411314d87d01e5accfaf419c7a74e0ea",
24
- "src/retrieval-policy.json": "3205fb4eb114a839a74f902e6fae6a61e1460958e5a9d7e29add32b60ba4e05a",
25
- "src/retrieval-ranking.js": "061b64f5bffec3269851830b30ab51abc3260274e5207ea4864ae33d9cb22809",
26
- "src/retrieval.js": "32f17494eb838cc6b209df35dbe33a155c1728420c9e501a4974c4f2a1b33ceb",
27
- "src/runtime/README.md": "9be676eca76a7857b34d7357194e6f0ee733c22e61d962d53984715dbec7f673",
28
- "src/runtime/atomic-file.js": "9846b4b69db5ded811acf19a1181ef93615d93efaa542b858e552a7f3124ad23",
29
- "src/runtime/automation-config.js": "6498c5397be12b155829740595a1553d4dcd6eaa7db6ced3ef88fdc60218f00e",
30
- "src/runtime/commit-conversation-binder.js": "1b3539d9218cfb9867feec3c60b5632403b73433698fc96c61418a84fe83625a",
31
- "src/runtime/commit-processing-ledger.js": "455aa1ac4e212c0b63d9df99e49aa94703cd24145e41aa9794f16274b2ec2e18",
32
- "src/runtime/commit-prompt.js": "db7b6942fc1a1a561c88b901075ccc2015e5cb4c2c3c673d62ac329459968494",
33
- "src/runtime/commit-reconciler.js": "41d0bafe43692cf37ac4e9c4b81a8bcfd828ca849cbe20d9fede237b6d001c69",
34
- "src/runtime/content-hash.js": "201ee7dcc054310f14097a00058cf9b28fa913367eef616e0fdd8facbf3c6c41",
35
- "src/runtime/contracts.js": "1088fd8bb36a5dc32a52496d54a6c7c5255c53ca5ff1fe90e42cfeb276e99044",
36
- "src/runtime/conversation-exclusions.js": "ef8545034b862d384fb460140490bb531b58d94992f5e2222ebaaa079b44fa63",
37
- "src/runtime/conversation-store.js": "9bdfab167e2803d14cc16e66bf253e13d67d2f85d567faec8a8b08fd9f9aafd0",
38
- "src/runtime/evidence-bundle.js": "33d4614849d5e1d69aba8b75c3a43c18b7b6f94e5c78654c82ef631331cc94cc",
39
- "src/runtime/git-runner.js": "b74fe197bd4dcf3e70635ef7b1f2615edf965c1d9a3ffe5406aabd41b76d74a9",
40
- "src/runtime/knowledge-promotion.js": "62fbd8282f83d666f0cae9c39c97a9a9b0175473356a0da0aa3805c757b0a9c1",
41
- "src/runtime/knowledge-retrieval-service.js": "161917638f518d9436024c7a0960a5b38619e397af91099c01a0232bbd6b6a43",
42
- "src/runtime/layout.js": "e47fe54c605218493ce46f6289798d9db2a3ecec95089d288ed03d3b75cf871a",
43
- "src/runtime/markdown-knowledge-indexer.js": "f771afcc1a08bf0c6456d6756c8e04885fac15bc700a86ab0114853ac662727e",
44
- "src/runtime/scanner.js": "d99fa8d74a6fbbaae75ca49f62127e14cf9e48b1404e4b4d597ef39df5441410",
45
- "src/server.js": "07ecdf2bc8edc2535f185eaedd932ce3e1d18f1a1e54eed4ba36c9060874a902",
46
- "src/store.js": "8fe9c415c845feefab3e2129b5850686747a880c827189026e3eb6295b158c0a",
47
- "ui/app.css": "7ad370c269e60a7b5ec907d81a607b2d16bd07b2d7c22a81f102dab51eeb2889",
48
- "ui/app.js": "33a2ba38f0dafbbb2e30a1eb3fc93476bfcaf528e124e1a9b2edd2fb69221e9e",
49
- "ui/index.html": "ce3565cfefd4838b11d37a91a906ef26ca5a1834844fe3f7c897b56851a3c418"
50
- },
51
- "sourceCommit": "1bfa9a5a7be2719935295bd243d994ebf6c51226"
52
- }
53
- }
54
- }
1
+ {
2
+ "schema": "project-knowledge/vendor-runtime/v1",
3
+ "modules": {
4
+ "knowledge-engine": {
5
+ "name": "@sanqianx/ai-coding-knowledge-engine",
6
+ "version": "0.2.7-rc.10",
7
+ "root": "_modules/knowledge-engine",
8
+ "files": {
9
+ "README.md": "27236264aa40ca3abd12a82d779120410d09507c0b0ad8d3f16896a03ae363ee",
10
+ "package.json": "2e24f8fc1ac3269bdcbd9b7179edf3eff31758545e970c689ab5ae3cb1c49c41",
11
+ "src/analysis-contract.js": "6d4b9fde0e05d9a80d43e96d0c27febf082ecdb19312faf0280d6c9b16ac71b1",
12
+ "src/analysis-failures.js": "eb1e5a476b1e3e3c87dfd9955707c85151707799883595bcb5e9cc3e26a991c4",
13
+ "src/analysis-output.js": "95a3c19dcc9ab85d1dba7fee5b9aec80f9c000dfba89da3fd0be25a81e2fb680",
14
+ "src/analysis-worker.js": "a0bae40784c690ac68a174cb6d98fbb21dbdb69becfd27eee316ba17de544de9",
15
+ "src/bin.js": "22208907431d0f3a971a669c7e5eb44b3b7af9bbb36fd7ba17c3b90c4288bd70",
16
+ "src/bridge-client.js": "ae0dba21e4286694bcd9e064ca36564ec997969ae1eb1ce4f8a6665e447cbffe",
17
+ "src/context.js": "edd9d4942f6039dd4aaadec88533042ae130f1b80d935d87f61b071904a6688c",
18
+ "src/coordinator.js": "6ced0a3b6314a72f40e9fd9b285916d15554130f02ba04faafb52b0f2b3a8fd2",
19
+ "src/diagnostics.js": "f7b516ace61a1e9faaa6876930b9e2e258499a25857d1203f4e53d28bfd0fa1a",
20
+ "src/headless-analyzer.js": "df570864136981cf98f3f69d047fa5729fbbfdeeaee0c6bfad26dab941dbbdae",
21
+ "src/index-request.js": "78f26b872299005499fff4f2d1f9e8f986784f2ff36a5cf2be2b1e7b7c7d9378",
22
+ "src/knowledge-targets.js": "aa44ec285d16d7b1c0b63bf084058a1d6f867fa9929c753b6b0cbb24f7b20ee2",
23
+ "src/memories.js": "7ad6701033c9a98a0d918b9745c012f9e90b8de6db6e1d870e2ebf77000a1aac",
24
+ "src/memory-eligibility.js": "48af31f23f81140dbc706ff83a39ba9f411314d87d01e5accfaf419c7a74e0ea",
25
+ "src/retrieval-policy.json": "3205fb4eb114a839a74f902e6fae6a61e1460958e5a9d7e29add32b60ba4e05a",
26
+ "src/retrieval-ranking.js": "061b64f5bffec3269851830b30ab51abc3260274e5207ea4864ae33d9cb22809",
27
+ "src/retrieval.js": "32f17494eb838cc6b209df35dbe33a155c1728420c9e501a4974c4f2a1b33ceb",
28
+ "src/runtime/README.md": "9be676eca76a7857b34d7357194e6f0ee733c22e61d962d53984715dbec7f673",
29
+ "src/runtime/atomic-file.js": "9846b4b69db5ded811acf19a1181ef93615d93efaa542b858e552a7f3124ad23",
30
+ "src/runtime/automation-config.js": "6498c5397be12b155829740595a1553d4dcd6eaa7db6ced3ef88fdc60218f00e",
31
+ "src/runtime/commit-conversation-binder.js": "1b3539d9218cfb9867feec3c60b5632403b73433698fc96c61418a84fe83625a",
32
+ "src/runtime/commit-processing-ledger.js": "455aa1ac4e212c0b63d9df99e49aa94703cd24145e41aa9794f16274b2ec2e18",
33
+ "src/runtime/commit-prompt.js": "db7b6942fc1a1a561c88b901075ccc2015e5cb4c2c3c673d62ac329459968494",
34
+ "src/runtime/commit-reconciler.js": "41d0bafe43692cf37ac4e9c4b81a8bcfd828ca849cbe20d9fede237b6d001c69",
35
+ "src/runtime/content-hash.js": "201ee7dcc054310f14097a00058cf9b28fa913367eef616e0fdd8facbf3c6c41",
36
+ "src/runtime/contracts.js": "1088fd8bb36a5dc32a52496d54a6c7c5255c53ca5ff1fe90e42cfeb276e99044",
37
+ "src/runtime/conversation-exclusions.js": "ef8545034b862d384fb460140490bb531b58d94992f5e2222ebaaa079b44fa63",
38
+ "src/runtime/conversation-store.js": "9bdfab167e2803d14cc16e66bf253e13d67d2f85d567faec8a8b08fd9f9aafd0",
39
+ "src/runtime/evidence-bundle.js": "33d4614849d5e1d69aba8b75c3a43c18b7b6f94e5c78654c82ef631331cc94cc",
40
+ "src/runtime/git-runner.js": "b74fe197bd4dcf3e70635ef7b1f2615edf965c1d9a3ffe5406aabd41b76d74a9",
41
+ "src/runtime/knowledge-promotion.js": "62fbd8282f83d666f0cae9c39c97a9a9b0175473356a0da0aa3805c757b0a9c1",
42
+ "src/runtime/knowledge-retrieval-service.js": "161917638f518d9436024c7a0960a5b38619e397af91099c01a0232bbd6b6a43",
43
+ "src/runtime/layout.js": "e47fe54c605218493ce46f6289798d9db2a3ecec95089d288ed03d3b75cf871a",
44
+ "src/runtime/markdown-knowledge-indexer.js": "f771afcc1a08bf0c6456d6756c8e04885fac15bc700a86ab0114853ac662727e",
45
+ "src/runtime/scanner.js": "d99fa8d74a6fbbaae75ca49f62127e14cf9e48b1404e4b4d597ef39df5441410",
46
+ "src/server.js": "4bb07e1538c70ee53f2238be29f8452f11c2ddf87725c4e063d7999765a8082c",
47
+ "src/store.js": "8fe9c415c845feefab3e2129b5850686747a880c827189026e3eb6295b158c0a",
48
+ "ui/app.css": "7ad370c269e60a7b5ec907d81a607b2d16bd07b2d7c22a81f102dab51eeb2889",
49
+ "ui/app.js": "33a2ba38f0dafbbb2e30a1eb3fc93476bfcaf528e124e1a9b2edd2fb69221e9e",
50
+ "ui/index.html": "ce3565cfefd4838b11d37a91a906ef26ca5a1834844fe3f7c897b56851a3c418"
51
+ },
52
+ "sourceCommit": "85c618f4f0bc94c67e16a544c9f20d5c796cfa15"
53
+ }
54
+ }
55
+ }