@sanqianx/project-knowledge 5.0.23 → 5.0.25

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 (401) hide show
  1. package/.agents/plugins/marketplace.json +20 -20
  2. package/.claude-plugin/marketplace.json +1 -1
  3. package/CHANGELOG.md +1361 -1346
  4. package/LICENSE +201 -201
  5. package/NOTICE +5 -5
  6. package/README.md +349 -349
  7. package/_modules/knowledge-engine/package.json +1 -1
  8. package/_modules/knowledge-engine/src/coordinator.js +48 -3
  9. package/_modules/knowledge-engine/src/runtime/automation-config.js +140 -140
  10. package/_modules/knowledge-engine/src/runtime/commit-conversation-binder.js +238 -238
  11. package/_modules/knowledge-engine/src/runtime/commit-processing-ledger.js +26 -26
  12. package/_modules/knowledge-engine/src/runtime/commit-prompt.js +193 -193
  13. package/_modules/knowledge-engine/src/runtime/commit-reconciler.js +394 -394
  14. package/_modules/knowledge-engine/src/runtime/contracts.js +282 -282
  15. package/_modules/knowledge-engine/src/runtime/conversation-store.js +389 -389
  16. package/_modules/knowledge-engine/src/runtime/evidence-bundle.js +228 -228
  17. package/_modules/knowledge-engine/src/runtime/git-runner.js +62 -62
  18. package/_modules/knowledge-engine/src/runtime/knowledge-promotion.js +505 -505
  19. package/_modules/knowledge-engine/src/runtime/knowledge-retrieval-service.js +400 -400
  20. package/_modules/knowledge-engine/src/runtime/markdown-knowledge-indexer.js +171 -171
  21. package/_modules/knowledge-engine/src/runtime/scanner.js +298 -298
  22. package/_modules/knowledge-engine/ui/app.js +23 -2
  23. package/_site/README.md +30 -30
  24. package/_site/_test/agent-capture-mcp-ui-test.js +68 -68
  25. package/_site/_test/agent-capture-ui-test.js +101 -101
  26. package/_site/_test/ai-profile-resolver-test.js +137 -137
  27. package/_site/_test/ai-profile-test.js +75 -75
  28. package/_site/_test/ai-vendor-presets-test.js +91 -91
  29. package/_site/_test/automatic-context-test.js +70 -70
  30. package/_site/_test/automation-queue-test.js +14 -14
  31. package/_site/_test/automation-ui-test.js +40 -40
  32. package/_site/_test/background-task-registry-test.js +43 -43
  33. package/_site/_test/baseline-schema-test.js +91 -91
  34. package/_site/_test/bin-cli-test.js +230 -230
  35. package/_site/_test/bridge-adapter-test.js +95 -95
  36. package/_site/_test/bridge-consumer-service-test.js +310 -310
  37. package/_site/_test/candidate-bin-content-test.js +35 -35
  38. package/_site/_test/candidate-product-assets-test.js +13 -13
  39. package/_site/_test/candidate-release-contract-test.js +14 -14
  40. package/_site/_test/capture-hook-dedup-test.js +158 -158
  41. package/_site/_test/cdp-browser-failure-test.js +103 -103
  42. package/_site/_test/chat-claudecodeui-match-test.js +92 -92
  43. package/_site/_test/claude-executable-discovery-test.js +90 -90
  44. package/_site/_test/claude-session-lifecycle-sweep-test.js +252 -252
  45. package/_site/_test/claude-workbench-test.js +174 -174
  46. package/_site/_test/cli-instance-management-test.js +62 -62
  47. package/_site/_test/client-capture-restart-e2e-test.js +189 -189
  48. package/_site/_test/codex-conversation-projection-test.js +60 -60
  49. package/_site/_test/codex-marketplace-scoped-path-test.js +186 -186
  50. package/_site/_test/codex-notify-capture-e2e-test.js +101 -101
  51. package/_site/_test/codex-notify-fanout-test.js +141 -134
  52. package/_site/_test/codex-notify-upgrade-test.js +253 -253
  53. package/_site/_test/commit-boundary-freeze-test.js +147 -147
  54. package/_site/_test/commit-conversation-binding-test.js +99 -99
  55. package/_site/_test/commit-evidence-test.js +110 -110
  56. package/_site/_test/configuration-generation-test.js +22 -22
  57. package/_site/_test/context-pack-test.js +200 -200
  58. package/_site/_test/conversation-api-test.js +119 -119
  59. package/_site/_test/conversation-origin-test.js +15 -15
  60. package/_site/_test/conversation-store-test.js +138 -138
  61. package/_site/_test/cross-repo-isolation-e2e-test.js +187 -187
  62. package/_site/_test/desktop-browser-compat-test.js +28 -28
  63. package/_site/_test/desktop-hook-runtime-regression-test.js +204 -204
  64. package/_site/_test/embedding-config-test.js +32 -32
  65. package/_site/_test/explicit-commit-processor-test.js +37 -37
  66. package/_site/_test/fixtures/fake-browser-exit.js +10 -10
  67. package/_site/_test/fixtures/fake-browser-hang.js +10 -10
  68. package/_site/_test/fixtures/integration-busy-worker.cjs +6 -6
  69. package/_site/_test/fixtures/make-git-repos.js +92 -92
  70. package/_site/_test/fixtures/retrieval-gold-queries.json +32 -32
  71. package/_site/_test/folder-picker-output-test.js +19 -19
  72. package/_site/_test/fresh-hook-reimport-test.js +53 -53
  73. package/_site/_test/fresh-product-data-test.js +56 -56
  74. package/_site/_test/full-integration-e2e-test.js +167 -167
  75. package/_site/_test/git-path-compatibility-test.js +80 -80
  76. package/_site/_test/git-validation-test.js +81 -81
  77. package/_site/_test/glm-ui-refresh-review-test.js +313 -404
  78. package/_site/_test/harness-isolation-test.js +138 -0
  79. package/_site/_test/helpers/cdp-browser.js +383 -0
  80. package/_site/_test/helpers/cdp-network-capture.js +66 -0
  81. package/_site/_test/helpers/find-chrome.js +34 -0
  82. package/_site/_test/helpers/free-port.js +8 -0
  83. package/_site/_test/helpers/logging-ui-fixture.js +131 -0
  84. package/_site/_test/helpers/module-fixture.js +282 -0
  85. package/_site/_test/helpers/parallel-engine-advanced-engine-child.js +45 -0
  86. package/_site/_test/helpers/parallel-engine-advanced-fault-writer.js +171 -0
  87. package/_site/_test/helpers/parallel-engine-advanced-harness.js +245 -0
  88. package/_site/_test/helpers/parallel-engine-advanced-standin-analyzer.js +80 -0
  89. package/_site/_test/helpers/parallel-engine-advanced-ui-host.js +177 -0
  90. package/_site/_test/helpers/parallel-engine-final-harness.js +314 -0
  91. package/_site/_test/helpers/parallel-engine-final-standin-analyzer.js +159 -0
  92. package/_site/_test/helpers/parallel-knowledge-fixture.js +255 -0
  93. package/_site/_test/helpers/parallel-logging-acceptance-fixture.js +111 -0
  94. package/_site/_test/helpers/parallel-logging-acceptance-proxy.js +106 -0
  95. package/_site/_test/helpers/parallel-logging-fix-r2-proxy.js +205 -0
  96. package/_site/_test/helpers/parallel-logging-integration-5025-env.js +432 -0
  97. package/_site/_test/helpers/parallel-memory-analyzer.js +81 -0
  98. package/_site/_test/helpers/parallel-memory-event-bridge.js +128 -0
  99. package/_site/_test/helpers/parallel-memory-shell.js +470 -0
  100. package/_site/_test/helpers/parallel-nav-isolation-env.js +389 -0
  101. package/_site/_test/helpers/parallel-nav-module-ui.js +186 -0
  102. package/_site/_test/helpers/parallel-nav-proxy.js +148 -0
  103. package/_site/_test/helpers/parallel-nav-shell.js +361 -0
  104. package/_site/_test/helpers/parallel-qa-engine-endpoint-guard.js +206 -0
  105. package/_site/_test/helpers/parallel-qa-engine-endpoint-isolate.js +257 -0
  106. package/_site/_test/helpers/parallel-retrieval-followup-corpus.js +293 -0
  107. package/_site/_test/helpers/parallel-retrieval-followup-next-session.js +70 -0
  108. package/_site/_test/helpers/parallel-retrieval-followup-r2-shell.js +737 -0
  109. package/_site/_test/helpers/parallel-retrieval-followup-r2-wb-host.js +82 -0
  110. package/_site/_test/helpers/parallel-retrieval-followup-shell.js +279 -0
  111. package/_site/_test/helpers/parallel-workbench-fixture.js +371 -0
  112. package/_site/_test/helpers/parallel-workbench-host.js +80 -0
  113. package/_site/_test/helpers/parallel-workbench-integration-5025-fixture.js +408 -0
  114. package/_site/_test/helpers/parallel-workbench-integration-5025-harness.js +593 -0
  115. package/_site/_test/helpers/parallel-workbench-integration-5025-host.js +70 -0
  116. package/_site/_test/helpers/parallel-workbench-integration-5025-launcher.js +240 -0
  117. package/_site/_test/helpers/parallel-workbench-integration-5025-runtime-harness.js +630 -0
  118. package/_site/_test/helpers/parallel-workbench-source-map.js +196 -0
  119. package/_site/_test/helpers/spawn-server.js +106 -0
  120. package/_site/_test/helpers/version-visibility-fixture.js +251 -0
  121. package/_site/_test/hook-runtime-endpoint-test.js +88 -88
  122. package/_site/_test/hook-status-repair-api-test.js +152 -152
  123. package/_site/_test/hook-trigger-test.js +85 -85
  124. package/_site/_test/hook-worktree-test.js +42 -42
  125. package/_site/_test/import-preflight-api-test.js +234 -234
  126. package/_site/_test/index-builder-test.js +41 -41
  127. package/_site/_test/index-error-display-contract-test.js +10 -10
  128. package/_site/_test/index-writer-concurrency-test.js +135 -135
  129. package/_site/_test/integration-adapters-test.js +262 -262
  130. package/_site/_test/integration-auto-repair-test.js +113 -113
  131. package/_site/_test/integration-capture-setup-test.js +118 -118
  132. package/_site/_test/integration-intent-test.js +81 -81
  133. package/_site/_test/integration-runtime-binding-a2-test.js +566 -566
  134. package/_site/_test/integration-runtime-binding-a3-test.js +227 -227
  135. package/_site/_test/integration-runtime-binding-test.js +473 -473
  136. package/_site/_test/integration-status-scan-test.js +29 -29
  137. package/_site/_test/integration-surface-coverage-test.js +164 -164
  138. package/_site/_test/kb-framework-test.js +57 -57
  139. package/_site/_test/kbpath-follow-test.js +63 -63
  140. package/_site/_test/knowledge-db-test.js +144 -144
  141. package/_site/_test/knowledge-engine-client-test.js +120 -109
  142. package/_site/_test/knowledge-language-control-test.js +170 -170
  143. package/_site/_test/knowledge-maintenance-test.js +40 -40
  144. package/_site/_test/knowledge-promotion-recovery-test.js +260 -260
  145. package/_site/_test/knowledge-query-test.js +54 -54
  146. package/_site/_test/knowledge-retrieval-service-test.js +77 -77
  147. package/_site/_test/knowledge-scopes-test.js +37 -37
  148. package/_site/_test/knowledge-storage-location-test.js +28 -28
  149. package/_site/_test/knowledge-storage-startup-test.js +52 -52
  150. package/_site/_test/knowledge-store-logs-supervision-test.js +89 -89
  151. package/_site/_test/launcher-readiness-test.js +80 -80
  152. package/_site/_test/legacy-claude-session-alias-test.js +106 -106
  153. package/_site/_test/legacy-routes-removed-test.js +47 -47
  154. package/_site/_test/legacy-workbench-exclusion-test.js +92 -92
  155. package/_site/_test/live-gateway-test.js +48 -48
  156. package/_site/_test/local-marketplace-test.js +16 -16
  157. package/_site/_test/log-redaction-test.js +58 -58
  158. package/_site/_test/logging-api-test.js +89 -89
  159. package/_site/_test/logging-sse-no-gap-test.js +88 -88
  160. package/_site/_test/logging-ui-test.js +107 -107
  161. package/_site/_test/markdown-delta-overlay-test.js +85 -85
  162. package/_site/_test/markdown-maintenance-api-test.js +75 -75
  163. package/_site/_test/markdown-maintenance-test.js +11 -11
  164. package/_site/_test/mcp-server-test.js +149 -149
  165. package/_site/_test/model-context-windows-test.js +89 -89
  166. package/_site/_test/module-agent-start-proxy-test.js +65 -65
  167. package/_site/_test/module-artifact-integrity-test.js +27 -27
  168. package/_site/_test/module-boundary-test.js +30 -30
  169. package/_site/_test/module-bridge-eventbridge-test.js +202 -202
  170. package/_site/_test/module-dynamic-port-test.js +118 -118
  171. package/_site/_test/module-index-proxy-test.js +33 -33
  172. package/_site/_test/module-model-configuration-test.js +44 -44
  173. package/_site/_test/module-process-lifecycle-test.js +35 -35
  174. package/_site/_test/module-stream-proxy-test.js +34 -34
  175. package/_site/_test/module-terminal-restart-test.js +63 -63
  176. package/_site/_test/module-wiring-unbind-race-test.js +59 -59
  177. package/_site/_test/native-context-integrations-test.js +86 -86
  178. package/_site/_test/non-release-ci-test.js +34 -34
  179. package/_site/_test/offline-boundary-isolation-test.js +32 -32
  180. package/_site/_test/orphaned-claim-recovery-test.js +80 -80
  181. package/_site/_test/package-boundary-test.js +43 -43
  182. package/_site/_test/package-startup-test.js +56 -56
  183. package/_site/_test/packaged-ui-smoke-test.js +88 -88
  184. package/_site/_test/parallel-ci-r9-posix-socket-budget-test.js +156 -0
  185. package/_site/_test/parallel-engine-advanced-eng005-test.js +136 -0
  186. package/_site/_test/parallel-engine-advanced-eng006-test.js +171 -0
  187. package/_site/_test/parallel-engine-advanced-eng007-reconcile-test.js +231 -0
  188. package/_site/_test/parallel-engine-advanced-eng009-test.js +208 -0
  189. package/_site/_test/parallel-engine-advanced-eng010-test.js +213 -0
  190. package/_site/_test/parallel-engine-advanced-eng011-ui-probe.js +459 -0
  191. package/_site/_test/parallel-engine-final-eng002-test.js +255 -0
  192. package/_site/_test/parallel-engine-final-eng007-test.js +269 -0
  193. package/_site/_test/parallel-engine-final-eng011-test.js +197 -0
  194. package/_site/_test/parallel-engine-final-eng012-test.js +354 -0
  195. package/_site/_test/parallel-knowledge-client-error-code-test.js +184 -0
  196. package/_site/_test/parallel-knowledge-engine-test.js +353 -0
  197. package/_site/_test/parallel-knowledge-retrieval-test.js +292 -0
  198. package/_site/_test/parallel-knowledge-vector-test.js +168 -0
  199. package/_site/_test/parallel-linux-ci-r7-log007-day-test.js +110 -0
  200. package/_site/_test/parallel-logging-acceptance-log003-test.js +224 -0
  201. package/_site/_test/parallel-logging-acceptance-log004-test.js +231 -0
  202. package/_site/_test/parallel-logging-acceptance-log005-test.js +208 -0
  203. package/_site/_test/parallel-logging-acceptance-log006-test.js +214 -0
  204. package/_site/_test/parallel-logging-acceptance-log007-test.js +223 -0
  205. package/_site/_test/parallel-logging-acceptance-log008-test.js +180 -0
  206. package/_site/_test/parallel-logging-fix-r2-crash-probe.js +271 -0
  207. package/_site/_test/parallel-logging-fix-r2-gap-test.js +294 -0
  208. package/_site/_test/parallel-logging-fix-r2-normalhook-test.js +330 -0
  209. package/_site/_test/parallel-logging-integration-5025-portability-test.js +554 -0
  210. package/_site/_test/parallel-memory-candidate-test.js +301 -0
  211. package/_site/_test/parallel-memory-manual-test.js +197 -0
  212. package/_site/_test/parallel-memory-scope-test.js +228 -0
  213. package/_site/_test/parallel-memory-source-test.js +227 -0
  214. package/_site/_test/parallel-memory-sync-test.js +238 -0
  215. package/_site/_test/parallel-memory-view-r8-reload-gate-test.js +123 -0
  216. package/_site/_test/parallel-nav-failure-test.js +119 -0
  217. package/_site/_test/parallel-nav-isolation-test.js +308 -0
  218. package/_site/_test/parallel-nav-isolation-vector-path-test.js +90 -0
  219. package/_site/_test/parallel-nav-offline-test.js +272 -0
  220. package/_site/_test/parallel-nav-operability-test.js +257 -0
  221. package/_site/_test/parallel-nav-switch-test.js +247 -0
  222. package/_site/_test/parallel-nav-theme-test.js +130 -0
  223. package/_site/_test/parallel-nav-viewport-test.js +310 -0
  224. package/_site/_test/parallel-qa-engine-endpoint-guard-test.js +273 -0
  225. package/_site/_test/parallel-retrieval-followup-citation-test.js +219 -0
  226. package/_site/_test/parallel-retrieval-followup-corpus-test.js +287 -0
  227. package/_site/_test/parallel-workbench-independent-host.js +262 -0
  228. package/_site/_test/parallel-workbench-integration-5025-abort-probe.js +340 -0
  229. package/_site/_test/parallel-workbench-integration-5025-drafts-probe.js +588 -0
  230. package/_site/_test/parallel-workbench-integration-5025-env-check.js +317 -0
  231. package/_site/_test/parallel-workbench-integration-5025-model-probe.js +342 -0
  232. package/_site/_test/parallel-workbench-integration-5025-ordering-probe.js +326 -0
  233. package/_site/_test/parallel-workbench-model-probe.js +336 -0
  234. package/_site/_test/parallel-workbench-offline-test.js +169 -0
  235. package/_site/_test/parallel-workbench-provenance-trace.js +134 -0
  236. package/_site/_test/parallel-workbench-source-match.js +206 -0
  237. package/_site/_test/parallel-workbench-standalone-turn.js +349 -0
  238. package/_site/_test/path-consistency-test.js +151 -151
  239. package/_site/_test/pending-sweep-test.js +9 -9
  240. package/_site/_test/post-commit-automation-test.js +87 -87
  241. package/_site/_test/pr-consumer-contract-test.js +55 -55
  242. package/_site/_test/product-brand-contract-test.js +25 -25
  243. package/_site/_test/product-diagnostics-ui-test.js +93 -93
  244. package/_site/_test/product-empty-state-test.js +148 -0
  245. package/_site/_test/product-import-ui-test.js +219 -104
  246. package/_site/_test/product-navigation-test.js +152 -0
  247. package/_site/_test/product-progress-status-test.js +84 -84
  248. package/_site/_test/project-delete-recovery-test.js +64 -64
  249. package/_site/_test/project-domain-create-test.js +91 -0
  250. package/_site/_test/project-domain-scope-retrieval-test.js +214 -0
  251. package/_site/_test/project-git-init-confirm-test.js +115 -0
  252. package/_site/_test/project-goal-editor-test.js +144 -144
  253. package/_site/_test/project-import-duplicate-alias-test.js +134 -0
  254. package/_site/_test/project-import-unicode-restart-test.js +140 -0
  255. package/_site/_test/project-lifecycle-transaction-test.js +106 -106
  256. package/_site/_test/project-module-partial-recovery-test.js +222 -0
  257. package/_site/_test/project-remove-running-guard-test.js +79 -79
  258. package/_site/_test/project-store-test.js +90 -90
  259. package/_site/_test/project-unbind-late-read-ui-test.js +250 -0
  260. package/_site/_test/project-unbind-writer-guard-test.js +231 -0
  261. package/_site/_test/prompt-settings-test.js +115 -115
  262. package/_site/_test/protected-architecture-gate-test.js +122 -122
  263. package/_site/_test/refactor-characterization-test.js +36 -36
  264. package/_site/_test/registry-events-test.js +38 -38
  265. package/_site/_test/release-version-sync-test.js +115 -115
  266. package/_site/_test/requirement-binding-test.js +113 -113
  267. package/_site/_test/requirement-recorder-test.js +173 -173
  268. package/_site/_test/run-all-tests.js +173 -161
  269. package/_site/_test/runtime-endpoint-test.js +64 -64
  270. package/_site/_test/scanner-test.js +83 -83
  271. package/_site/_test/server-security-test.js +96 -96
  272. package/_site/_test/sessions-stream-test.js +93 -93
  273. package/_site/_test/shared-contracts-test.js +58 -58
  274. package/_site/_test/shared-scope-root-binding-test.js +74 -67
  275. package/_site/_test/simple-import-test.js +98 -98
  276. package/_site/_test/startup-analysis-disabled-test.js +16 -16
  277. package/_site/_test/storage-foundation-test.js +78 -78
  278. package/_site/_test/structured-logger-test.js +101 -101
  279. package/_site/_test/t07b-cln-005-coverage-test.js +212 -0
  280. package/_site/_test/team-knowledge-store-sparse-checkout-test.js +196 -196
  281. package/_site/_test/team-knowledge-store-test.js +132 -132
  282. package/_site/_test/test-server-cleanup-test.js +35 -35
  283. package/_site/_test/test-server-module-isolation-test.js +37 -37
  284. package/_site/_test/tracking-start-test.js +144 -144
  285. package/_site/_test/vector-storage-root-test.js +75 -75
  286. package/_site/_test/version-visibility-browser-probe.js +249 -0
  287. package/_site/_test/version-visibility-test.js +92 -0
  288. package/_site/_test/workbench-context-receipts-test.js +22 -22
  289. package/_site/_test/workbench-permission-test.js +117 -117
  290. package/_site/_test/zcode-capture-integration-test.js +112 -112
  291. package/_site/lib/ai-profile-resolver.js +78 -78
  292. package/_site/lib/ai-vendor-presets.js +83 -83
  293. package/_site/lib/ai-workspace.js +104 -104
  294. package/_site/lib/atomic-file.js +204 -204
  295. package/_site/lib/automation-config.js +140 -140
  296. package/_site/lib/bridge-adapter.js +260 -260
  297. package/_site/lib/bridge-consumer-service.js +402 -402
  298. package/_site/lib/capture-hook-config.js +108 -108
  299. package/_site/lib/claude-cli-runner.js +1599 -1599
  300. package/_site/lib/cli-instances.js +43 -43
  301. package/_site/lib/codex-context-status.js +17 -17
  302. package/_site/lib/codex-notify-config.js +193 -193
  303. package/_site/lib/commit-conversation-binder.js +247 -247
  304. package/_site/lib/commit-processing-ledger.js +27 -27
  305. package/_site/lib/commit-prompt.js +202 -202
  306. package/_site/lib/commit-reconciler.js +444 -444
  307. package/_site/lib/context-pack-builder.js +299 -299
  308. package/_site/lib/contracts.js +291 -291
  309. package/_site/lib/conversation-exclusions.js +204 -204
  310. package/_site/lib/conversation-query-service.js +161 -161
  311. package/_site/lib/conversation-store.js +387 -387
  312. package/_site/lib/data-dir.js +13 -13
  313. package/_site/lib/embedding-service.js +85 -85
  314. package/_site/lib/engine-connection.js +93 -93
  315. package/_site/lib/engine-knowledge-client.js +76 -72
  316. package/_site/lib/evidence-bundle.js +228 -228
  317. package/_site/lib/folder-picker-output.js +24 -24
  318. package/_site/lib/git-path.js +14 -14
  319. package/_site/lib/git-runner.js +62 -62
  320. package/_site/lib/github-team-store.js +1175 -1175
  321. package/_site/lib/hook-manager.js +203 -203
  322. package/_site/lib/index-builder.js +157 -157
  323. package/_site/lib/index-service.js +173 -173
  324. package/_site/lib/integration-auto-repair.js +77 -77
  325. package/_site/lib/integration-installer.js +1240 -1240
  326. package/_site/lib/integration-intent.js +88 -88
  327. package/_site/lib/integration-status-scan.js +99 -99
  328. package/_site/lib/integration-status-worker.js +14 -14
  329. package/_site/lib/kb-framework.js +191 -191
  330. package/_site/lib/kb-validator.js +124 -124
  331. package/_site/lib/knowledge-db.js +363 -363
  332. package/_site/lib/knowledge-promotion.js +435 -435
  333. package/_site/lib/knowledge-retrieval-service.js +401 -401
  334. package/_site/lib/knowledge-schema.js +121 -121
  335. package/_site/lib/knowledge-tool-runtime.js +366 -366
  336. package/_site/lib/live-gateway.js +78 -78
  337. package/_site/lib/llm-client.js +173 -173
  338. package/_site/lib/markdown-knowledge-indexer.js +230 -230
  339. package/_site/lib/model-context-windows.js +82 -82
  340. package/_site/lib/module-bridge.js +874 -874
  341. package/_site/lib/module-port-resolver.js +57 -57
  342. package/_site/lib/post-commit-automation.js +141 -141
  343. package/_site/lib/product-data.js +35 -35
  344. package/_site/lib/project-lifecycle-service.js +554 -554
  345. package/_site/lib/project-registry-store.js +129 -129
  346. package/_site/lib/project-store.js +268 -268
  347. package/_site/lib/prompt-registry.js +148 -148
  348. package/_site/lib/public-version-info.js +37 -0
  349. package/_site/lib/registry-events.js +16 -16
  350. package/_site/lib/requirement-adapters.js +10 -10
  351. package/_site/lib/requirement-binder.js +112 -112
  352. package/_site/lib/requirement-recorder.js +278 -278
  353. package/_site/lib/runtime-control.js +89 -89
  354. package/_site/lib/runtime-endpoint.js +160 -160
  355. package/_site/lib/scanner.js +298 -298
  356. package/_site/lib/server-app.js +1672 -1664
  357. package/_site/lib/settings-store.js +153 -153
  358. package/_site/lib/storage-layout.js +166 -166
  359. package/_site/lib/structured-logger.js +574 -574
  360. package/_site/lib/zcode-context-integration.js +60 -60
  361. package/_site/scripts/codex-notify-fanout.cjs +95 -95
  362. package/_site/scripts/folder-picker.ps1 +156 -156
  363. package/_site/scripts/hook-trigger.js +158 -158
  364. package/_site/scripts/install-module-candidates.js +69 -69
  365. package/_site/scripts/pack-module-candidates.js +89 -89
  366. package/_site/scripts/sync-product-content.js +28 -28
  367. package/_site/scripts/sync-release-version.js +164 -164
  368. package/_site/scripts/vendor-modules.js +49 -49
  369. package/_site/scripts/verify-module-runtime.js +50 -50
  370. package/_site/scripts/verify-product-runtime.js +36 -36
  371. package/_site/scripts/verify-retrieval-gold.js +83 -83
  372. package/_site/server.js +15 -15
  373. package/_site/start.bat +26 -26
  374. package/_site/stop.bat +11 -11
  375. package/bin/project-knowledge-integrations.js +254 -254
  376. package/bin/project-knowledge-kb.js +67 -67
  377. package/bin/project-knowledge-mcp.js +201 -201
  378. package/bin/project-knowledge.js +269 -170
  379. package/claude-prompts.json +21 -21
  380. package/docs/README.zh-CN.md +207 -205
  381. package/docs/assets/architecture.svg +181 -181
  382. package/docs/assets/logo.svg +49 -49
  383. package/docs/fresh-v5-start.md +44 -44
  384. package/docs/leader-glm-workbench-playbook.md +122 -122
  385. package/docs/project-registry-schema.md +33 -33
  386. package/docs/release-5.0.16-acceptance.md +176 -176
  387. package/docs/release-5.0.17-acceptance.md +117 -117
  388. package/docs/release-5.0.19-acceptance.md +39 -39
  389. package/docs/team-knowledge-mode-a-plan.md +73 -73
  390. package/docs/testing-strategy.md +33 -33
  391. package/module-runtime-manifest.json +70 -67
  392. package/package.json +113 -110
  393. package/plugins/project-knowledge/.claude-plugin/plugin.json +1 -1
  394. package/plugins/project-knowledge/.codex-plugin/plugin.json +1 -1
  395. package/plugins/project-knowledge/.mcp.json +1 -1
  396. package/templates/change.md +30 -30
  397. package/templates/project-readme.md +52 -52
  398. package/ui/index.html +3 -2
  399. package/ui/version-info.css +44 -0
  400. package/ui/version-info.js +24 -0
  401. package/vendor-manifest.json +55 -55
@@ -1,35 +1,35 @@
1
- 'use strict';
2
- const assert = require('node:assert/strict');
3
- const fs = require('node:fs');
4
- const os = require('node:os');
5
- const path = require('node:path');
6
- const { spawnSync } = require('node:child_process');
7
- const { installedFileBytes } = require('../scripts/pack-module-candidates');
8
- const root = fs.mkdtempSync(path.join(os.tmpdir(), 'kb-bin-content-'));
9
- const npmCli = process.env.npm_execpath || path.join(path.dirname(process.execPath), 'node_modules/npm/bin/npm-cli.js');
10
- function npm(args, cwd) {
11
- const result = spawnSync(process.execPath, [npmCli, ...args], { cwd, encoding: 'utf8', windowsHide: true });
12
- assert.equal(result.status, 0, result.stderr);
13
- return result.stdout;
14
- }
15
- try {
16
- const source = path.join(root, 'source'), installed = path.join(root, 'installed');
17
- fs.mkdirSync(source); fs.mkdirSync(installed);
18
- const pkg = { name: 'kb-bin-content-fixture', version: '1.0.0', bin: { 'kb-content-fixture': './bin.js' }, files: ['bin.js', 'readme.txt'] };
19
- const bytes = Buffer.from('#!/usr/bin/env node\r\nconsole.log("安装验收");\r\n');
20
- fs.writeFileSync(path.join(source, 'package.json'), JSON.stringify(pkg));
21
- fs.writeFileSync(path.join(source, 'bin.js'), bytes);
22
- fs.writeFileSync(path.join(source, 'readme.txt'), bytes);
23
- assert.equal(typeof installedFileBytes, 'function', 'candidate hashes must model npm bin normalization');
24
- const packed = JSON.parse(npm(['pack', '--ignore-scripts', '--json', '--pack-destination', root], source))[0];
25
- fs.writeFileSync(path.join(installed, 'package.json'), JSON.stringify({ name: 'kb-bin-consumer', version: '1.0.0', private: true }));
26
- npm(['install', `file:${path.join(root, packed.filename)}`, '--ignore-scripts', '--no-audit', '--no-fund', '--package-lock=false'], installed);
27
- const actual = fs.readFileSync(path.join(installed, 'node_modules', pkg.name, 'bin.js'));
28
- assert.notDeepEqual(actual, bytes, 'npm changes a CRLF shebang on installation');
29
- assert.deepEqual(installedFileBytes(pkg, 'bin.js', bytes), actual, 'manifest bytes match actual npm installation');
30
- assert.deepEqual(installedFileBytes(pkg, 'readme.txt', bytes), bytes, 'ordinary files retain their exact bytes');
31
- assert.deepEqual(installedFileBytes({ bin: 'bin.js' }, 'bin.js', bytes), actual, 'string bin form is supported');
32
- assert.deepEqual(installedFileBytes(pkg, 'bin.js', actual), actual, 'an already normalized bin is unchanged');
33
- assert.ok(actual.includes(Buffer.from('验收");\r\n')), 'only the shebang is normalized');
34
- console.log('candidate-bin-content-test PASS');
35
- } finally { fs.rmSync(root, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 }); }
1
+ 'use strict';
2
+ const assert = require('node:assert/strict');
3
+ const fs = require('node:fs');
4
+ const os = require('node:os');
5
+ const path = require('node:path');
6
+ const { spawnSync } = require('node:child_process');
7
+ const { installedFileBytes } = require('../scripts/pack-module-candidates');
8
+ const root = fs.mkdtempSync(path.join(os.tmpdir(), 'kb-bin-content-'));
9
+ const npmCli = process.env.npm_execpath || path.join(path.dirname(process.execPath), 'node_modules/npm/bin/npm-cli.js');
10
+ function npm(args, cwd) {
11
+ const result = spawnSync(process.execPath, [npmCli, ...args], { cwd, encoding: 'utf8', windowsHide: true });
12
+ assert.equal(result.status, 0, result.stderr);
13
+ return result.stdout;
14
+ }
15
+ try {
16
+ const source = path.join(root, 'source'), installed = path.join(root, 'installed');
17
+ fs.mkdirSync(source); fs.mkdirSync(installed);
18
+ const pkg = { name: 'kb-bin-content-fixture', version: '1.0.0', bin: { 'kb-content-fixture': './bin.js' }, files: ['bin.js', 'readme.txt'] };
19
+ const bytes = Buffer.from('#!/usr/bin/env node\r\nconsole.log("安装验收");\r\n');
20
+ fs.writeFileSync(path.join(source, 'package.json'), JSON.stringify(pkg));
21
+ fs.writeFileSync(path.join(source, 'bin.js'), bytes);
22
+ fs.writeFileSync(path.join(source, 'readme.txt'), bytes);
23
+ assert.equal(typeof installedFileBytes, 'function', 'candidate hashes must model npm bin normalization');
24
+ const packed = JSON.parse(npm(['pack', '--ignore-scripts', '--json', '--pack-destination', root], source))[0];
25
+ fs.writeFileSync(path.join(installed, 'package.json'), JSON.stringify({ name: 'kb-bin-consumer', version: '1.0.0', private: true }));
26
+ npm(['install', `file:${path.join(root, packed.filename)}`, '--ignore-scripts', '--no-audit', '--no-fund', '--package-lock=false'], installed);
27
+ const actual = fs.readFileSync(path.join(installed, 'node_modules', pkg.name, 'bin.js'));
28
+ assert.notDeepEqual(actual, bytes, 'npm changes a CRLF shebang on installation');
29
+ assert.deepEqual(installedFileBytes(pkg, 'bin.js', bytes), actual, 'manifest bytes match actual npm installation');
30
+ assert.deepEqual(installedFileBytes(pkg, 'readme.txt', bytes), bytes, 'ordinary files retain their exact bytes');
31
+ assert.deepEqual(installedFileBytes({ bin: 'bin.js' }, 'bin.js', bytes), actual, 'string bin form is supported');
32
+ assert.deepEqual(installedFileBytes(pkg, 'bin.js', actual), actual, 'an already normalized bin is unchanged');
33
+ assert.ok(actual.includes(Buffer.from('验收");\r\n')), 'only the shebang is normalized');
34
+ console.log('candidate-bin-content-test PASS');
35
+ } finally { fs.rmSync(root, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 }); }
@@ -1,13 +1,13 @@
1
- 'use strict';
2
- const assert=require('node:assert/strict'),fs=require('node:fs'),path=require('node:path'),os=require('node:os'),crypto=require('node:crypto');
3
- const {productFiles}=require('../scripts/pack-module-candidates');
4
- const root=fs.mkdtempSync(path.join(os.tmpdir(),'kb-candidate-assets-'));
5
- try{
6
- const files=['ui/index.html','ui/knowledge-panel.html','ui/product.js','ui/live-client.js','ui/product.css','ui/favicon.svg','plugins/project-knowledge/scripts/context-hook.cjs'];
7
- for(const file of files){fs.mkdirSync(path.dirname(path.join(root,file)),{recursive:true});fs.writeFileSync(path.join(root,file),file+' changed');}
8
- fs.writeFileSync(path.join(root,'module-runtime-manifest.json'),JSON.stringify({productFiles:{[files.at(-1)]:'old-hash'}}));
9
- const result=productFiles(root);
10
- assert.equal(Object.keys(result).length,7);
11
- assert.equal(result[files.at(-1)],crypto.createHash('sha256').update(files.at(-1)+' changed').digest('hex'));
12
- console.log('candidate-product-assets-test PASS');
13
- }finally{fs.rmSync(root,{recursive:true,force:true,maxRetries:3,retryDelay:100});}
1
+ 'use strict';
2
+ const assert=require('node:assert/strict'),fs=require('node:fs'),path=require('node:path'),os=require('node:os'),crypto=require('node:crypto');
3
+ const {productFiles}=require('../scripts/pack-module-candidates');
4
+ const root=fs.mkdtempSync(path.join(os.tmpdir(),'kb-candidate-assets-'));
5
+ try{
6
+ const files=['ui/index.html','ui/knowledge-panel.html','ui/product.js','ui/live-client.js','ui/product.css','ui/favicon.svg','plugins/project-knowledge/scripts/context-hook.cjs'];
7
+ for(const file of files){fs.mkdirSync(path.dirname(path.join(root,file)),{recursive:true});fs.writeFileSync(path.join(root,file),file+' changed');}
8
+ fs.writeFileSync(path.join(root,'module-runtime-manifest.json'),JSON.stringify({productFiles:{[files.at(-1)]:'old-hash'}}));
9
+ const result=productFiles(root);
10
+ assert.equal(Object.keys(result).length,7);
11
+ assert.equal(result[files.at(-1)],crypto.createHash('sha256').update(files.at(-1)+' changed').digest('hex'));
12
+ console.log('candidate-product-assets-test PASS');
13
+ }finally{fs.rmSync(root,{recursive:true,force:true,maxRetries:3,retryDelay:100});}
@@ -1,14 +1,14 @@
1
- 'use strict';
2
- const assert = require('node:assert/strict');
3
- const fs = require('node:fs');
4
- const path = require('node:path');
5
- const { isPinnedModuleVersion } = require('../scripts/verify-module-runtime');
6
- for (const name of ['claude-ai-workbench', '@sanqianx/vector-hub', '@sanqianx/ai-coding-event-bridge-console']) {
7
- for (const version of ['1.2.3', '1.2.3-rc.1', '1.2.3-rc.12']) assert.ok(isPinnedModuleVersion(name, version));
8
- for (const version of ['latest', 'next', '^1.2.3', '~1.2.3', '>=1.2.3', 'file:../module', 'link:module', 'workspace:*', '1.2.3-beta.1', '1.2.3-rc', undefined]) assert.equal(isPinnedModuleVersion(name, version), false, String(version));
9
- }
10
- assert.ok(isPinnedModuleVersion('claude-ai-workbench', 'npm:@sanqianx/claude-ai-workbench@0.13.2-rc.1'));
11
- assert.equal(isPinnedModuleVersion('@sanqianx/vector-hub', 'npm:@sanqianx/claude-ai-workbench@0.13.2-rc.1'), false);
12
- const manifest = JSON.parse(fs.readFileSync(path.resolve(__dirname, '../../module-runtime-manifest.json')));
13
- for (const file of ['ui/index.html', 'ui/knowledge-panel.html', 'ui/product.js', 'ui/product.css', 'ui/favicon.svg']) assert.match(manifest.productFiles[file], /^[a-f0-9]{64}$/);
14
- console.log('candidate-release-contract-test PASS');
1
+ 'use strict';
2
+ const assert = require('node:assert/strict');
3
+ const fs = require('node:fs');
4
+ const path = require('node:path');
5
+ const { isPinnedModuleVersion } = require('../scripts/verify-module-runtime');
6
+ for (const name of ['claude-ai-workbench', '@sanqianx/vector-hub', '@sanqianx/ai-coding-event-bridge-console']) {
7
+ for (const version of ['1.2.3', '1.2.3-rc.1', '1.2.3-rc.12']) assert.ok(isPinnedModuleVersion(name, version));
8
+ for (const version of ['latest', 'next', '^1.2.3', '~1.2.3', '>=1.2.3', 'file:../module', 'link:module', 'workspace:*', '1.2.3-beta.1', '1.2.3-rc', undefined]) assert.equal(isPinnedModuleVersion(name, version), false, String(version));
9
+ }
10
+ assert.ok(isPinnedModuleVersion('claude-ai-workbench', 'npm:@sanqianx/claude-ai-workbench@0.13.2-rc.1'));
11
+ assert.equal(isPinnedModuleVersion('@sanqianx/vector-hub', 'npm:@sanqianx/claude-ai-workbench@0.13.2-rc.1'), false);
12
+ const manifest = JSON.parse(fs.readFileSync(path.resolve(__dirname, '../../module-runtime-manifest.json')));
13
+ for (const file of ['ui/index.html', 'ui/knowledge-panel.html', 'ui/product.js', 'ui/product.css', 'ui/favicon.svg']) assert.match(manifest.productFiles[file], /^[a-f0-9]{64}$/);
14
+ console.log('candidate-release-contract-test PASS');
@@ -1,158 +1,158 @@
1
- 'use strict';
2
-
3
- const assert = require('assert');
4
- const fs = require('fs');
5
- const os = require('os');
6
- const path = require('path');
7
- const { spawnSync } = require('child_process');
8
- const { IntegrationManager } = require(process.env.PK_TEST_INTEGRATION_ROOT
9
- ? path.join(process.env.PK_TEST_INTEGRATION_ROOT, '_site/lib/integration-installer') : '../lib/integration-installer');
10
- const { bridgeBinding, planCaptureHooks, repairCaptureHooks } = require('../lib/capture-hook-config');
11
- const bridge = require('@sanqianx/ai-coding-event-bridge-console/src/bridge');
12
- const ROOT = path.resolve(__dirname, '../..');
13
- const TEMP = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-capture-dedup-'));
14
- const HOME = path.join(TEMP, '用户 空格');
15
- const OLD = path.join(HOME, '.ai-coding-event-bridge');
16
- const CURRENT = path.join(HOME, '.project-knowledge-v5/events');
17
- const options = { homeDir: HOME, bridgeHomeDir: CURRENT };
18
- const shim = home => path.join(home, 'bin/bridge-hook.cjs');
19
- const cmd = home => ({ type: 'command', command: `node "${shim(home)}"` });
20
- const processHook = home => ({ type: 'process', command: 'node', args: [shim(home), '--source', 'zcode'], timeoutMs: 15000 });
21
- const events = ['UserPromptSubmit', 'Stop'];
22
- const read = file => JSON.parse(fs.readFileSync(file, 'utf8'));
23
- function write(file, object) { fs.mkdirSync(path.dirname(file), { recursive: true }); fs.writeFileSync(file, JSON.stringify(object, null, 2) + '\n'); }
24
- function manager(extra = {}) { return new IntegrationManager({ rootDir: ROOT, env: {}, ...options, ...extra }); }
25
-
26
- async function main() {
27
- const claude = path.join(HOME, '.claude/settings.json');
28
- const third = { type: 'command', command: 'node "notify-user.cjs"', timeout: 10 };
29
- const context = { type: 'command', command: 'node "context-hook.cjs" --client claude' };
30
- const lookalike = { type: 'command', command: `node "${shim(OLD)}" && echo keep-user-wrapper` };
31
- const customHome = path.join(HOME, 'independent-third-party-bridge');
32
- const unrelated = { model: 'user-model', env: { PRIVATE_TEST_TOKEN: 'do-not-back-up-unrelated-secret' } };
33
- write(claude, { ...unrelated, hooks: Object.fromEntries(events.map(event => [event, [
34
- { matcher: '*', hooks: [cmd(OLD), third, cmd(CURRENT)] },
35
- { matcher: '*', hooks: [cmd(OLD), cmd(CURRENT), context, lookalike, cmd(customHome)] },
36
- ]])) });
37
- const before = fs.readFileSync(claude, 'utf8');
38
- const logs = [];
39
- const item = manager({ logger: { info: (...args) => logs.push(args), error: (...args) => logs.push(args) } });
40
- assert.equal((await item.statusCaptureClaude()).state, 'needs-repair', 'duplicate capture cannot be reported healthy');
41
- assert.equal(fs.readFileSync(claude, 'utf8'), before, 'status is read-only');
42
- const installed = await item.captureOperation('install', 'claude');
43
- assert.equal(installed.removedLegacy, 4);
44
- assert.equal(installed.removedDuplicates, 2);
45
- assert(logs.some(row => row[2]?.context?.removedLegacy === 4 && row[2]?.context?.removedDuplicates === 2), 'repair counts are persisted without raw configuration');
46
- assert(!JSON.stringify(logs).includes('do-not-back-up-unrelated-secret'));
47
- let saved = read(claude);
48
- assert.equal(saved.model, unrelated.model); assert.deepEqual(saved.env, unrelated.env);
49
- for (const event of events) {
50
- const hooks = saved.hooks[event].flatMap(group => group.hooks);
51
- assert.equal(hooks.filter(hook => hook.command === cmd(CURRENT).command).length, 1);
52
- assert.equal(hooks.filter(hook => hook.command === cmd(OLD).command).length, 0);
53
- for (const keep of [third, context, lookalike, cmd(customHome)]) assert(hooks.some(hook => JSON.stringify(hook) === JSON.stringify(keep)), 'mixed-group third-party hooks survive');
54
- }
55
- assert(!fs.readFileSync(installed.backupFile, 'utf8').includes('do-not-back-up-unrelated-secret'), 'backup contains only removed owned invocations');
56
- assert.equal((await item.statusCaptureClaude()).state, 'installed');
57
- const after = fs.readFileSync(claude, 'utf8');
58
- assert.equal((await item.installCaptureClaude()).changed, false);
59
- assert.equal(fs.readFileSync(claude, 'utf8'), after, 'repeat repair is byte-idempotent');
60
- await item.uninstallCaptureClaude();
61
- saved = read(claude);
62
- for (const event of events) assert(saved.hooks[event].flatMap(group => group.hooks).some(hook => hook.command === third.command), 'uninstall keeps other hooks in the same group');
63
-
64
- const zcode = path.join(HOME, '.zcode/cli/config.json');
65
- const zContext = { type: 'process', command: 'node', args: ['context-hook.cjs', '--client', 'zcode'] };
66
- write(zcode, { ...unrelated, hooks: { enabled: true, events: Object.fromEntries(events.map(event => [event, [{ hooks: [processHook(OLD), third, processHook(CURRENT), processHook(CURRENT), zContext] }]])) } });
67
- assert.equal((await item.statusCaptureZCode()).state, 'needs-repair');
68
- const zInstalled = await item.installCaptureZCode();
69
- assert.equal(zInstalled.removedLegacy, 2); assert.equal(zInstalled.removedDuplicates, 2);
70
- const zBeforeRepeat = fs.readFileSync(zcode, 'utf8');
71
- await item.installCaptureZCode();
72
- assert.equal(fs.readFileSync(zcode, 'utf8'), zBeforeRepeat);
73
- await item.uninstallCaptureZCode();
74
- assert.deepEqual(read(zcode).env, unrelated.env);
75
- assert.deepEqual(read(zcode).hooks.events.UserPromptSubmit[0].hooks, [third, zContext]);
76
-
77
- write(claude, { hooks: Object.fromEntries(events.map(event => [event, [{ hooks: [cmd(OLD)] }]])) });
78
- const onlyLegacy = fs.readFileSync(claude, 'utf8');
79
- assert.throws(() => repairCaptureHooks(claude, 'claude', options), /入口未完整/);
80
- const failed = manager({ bridgeModule: { installers: { claudeCode: { installClaudeCodeHook: async () => { throw new Error('runtime materialization failed'); } } } } });
81
- await assert.rejects(failed.installCaptureClaude(), /materialization failed/);
82
- assert.equal(fs.readFileSync(claude, 'utf8'), onlyLegacy, 'failed runtime install cannot retire working old capture');
83
- const conflict = manager({ bridgeModule: { installers: { claudeCode: { installClaudeCodeHook: async () => ({ added: [], runtime: { conflict: true } }) } } } });
84
- await assert.rejects(conflict.installCaptureClaude(), /版本冲突/);
85
- assert.equal(fs.readFileSync(claude, 'utf8'), onlyLegacy, 'a runtime conflict cannot retire old capture');
86
- const dry = manager({ dryRun: true });
87
- await dry.installCaptureClaude(); await dry.uninstallCaptureClaude();
88
- assert.equal(fs.readFileSync(claude, 'utf8'), onlyLegacy);
89
- fs.writeFileSync(claude, '{invalid JSON');
90
- assert.throws(() => planCaptureHooks(claude, 'claude', options), /JSON/);
91
- assert.equal(fs.readFileSync(claude, 'utf8'), '{invalid JSON');
92
- assert.equal(bridgeBinding(['node', `${shim(OLD)}.user-script`], options), '');
93
- assert.equal(bridgeBinding(['node', shim(OLD), '--custom-argument'], options), '');
94
- assert.equal(bridgeBinding([['node'], shim(OLD)], options), '');
95
- write(claude, { hooks: { UserPromptSubmit: [null, { hooks: [cmd(OLD), cmd(CURRENT)] }], Stop: [{ hooks: [cmd(CURRENT)] }] } });
96
- repairCaptureHooks(claude, 'claude', options);
97
- assert.equal(read(claude).hooks.UserPromptSubmit[0], null, 'repair does not silently drop unrelated malformed groups');
98
- write(claude, { hooks: Object.fromEntries(events.map(event => [event, [{ hooks: [cmd(OLD), cmd(CURRENT)] }]])) });
99
- const originalRead = fs.readFileSync;
100
- let reads = 0;
101
- fs.readFileSync = function(file, ...args) {
102
- const value = originalRead.call(this, file, ...args);
103
- if (file === claude && ++reads === 2) write(claude, { ...JSON.parse(value), userConcurrentEdit: 'kept' });
104
- return value;
105
- };
106
- try { assert.throws(() => repairCaptureHooks(claude, 'claude', options), error => error.code === 'CONFIG_CHANGED'); }
107
- finally { fs.readFileSync = originalRead; }
108
- assert.equal(read(claude).userConcurrentEdit, 'kept', 'a concurrent user edit is never overwritten');
109
-
110
- // Real Git + real installed shims: the stale store is registered, but no
111
- // repaired client invocation recreates it or sends duplicate events.
112
- const repo = path.join(TEMP, '代码 中文 project');
113
- fs.mkdirSync(repo, { recursive: true });
114
- const git = spawnSync('git', ['init', '-q'], { cwd: repo, encoding: 'utf8', windowsHide: true });
115
- assert.equal(git.status, 0, git.stderr);
116
- const obsoleteStore = path.join(TEMP, 'knowledge/old-slug/dev-conversations');
117
- const canonicalStore = path.join(TEMP, 'knowledge/Canonical-abcdef/dev-conversations');
118
- await bridge.ensureRuntimeHome({ homeDir: OLD });
119
- await bridge.projectRegistry.addProject({ home: OLD, path: repo, store: obsoleteStore });
120
- await bridge.projectRegistry.addProject({ home: CURRENT, path: repo, store: canonicalStore });
121
- fs.rmSync(path.join(TEMP, 'knowledge/old-slug'), { recursive: true, force: true });
122
- write(claude, { hooks: Object.fromEntries(events.map(event => [event, [{ hooks: [cmd(OLD), cmd(CURRENT), cmd(CURRENT)] }]])) });
123
- await item.installCaptureClaude();
124
- const env = { ...process.env }; delete env.AI_CODING_EVENT_BRIDGE_HOME;
125
- for (const [event, payload] of [
126
- ['UserPromptSubmit', { prompt: 'isolated dedup test request' }],
127
- ['Stop', { last_assistant_message: 'isolated dedup test answer' }],
128
- ]) {
129
- const hooks = read(claude).hooks[event].flatMap(group => group.hooks);
130
- assert.equal(hooks.length, 1);
131
- const call = spawnSync(process.execPath, [shim(CURRENT)], { cwd: repo, env, input: JSON.stringify({ hook_event_name: event, cwd: repo, session_id: 'dedup-test', ...payload }), encoding: 'utf8', windowsHide: true, timeout: 10000 });
132
- assert.equal(call.status, 0, call.stderr);
133
- }
134
- const journal = path.join(canonicalStore, 'journal/events.jsonl');
135
- const captured = fs.readFileSync(journal, 'utf8').trim().split(/\r?\n/).map(line => JSON.parse(line));
136
- assert.deepEqual(captured.map(row => row.eventType), ['user_prompt', 'assistant_response']);
137
- assert(!fs.existsSync(obsoleteStore), 'the stale second directory is not recreated');
138
- write(zcode, { hooks: { enabled: true, events: Object.fromEntries(events.map(event => [event, [{ hooks: [processHook(OLD), processHook(CURRENT), processHook(CURRENT)] }]])) } });
139
- await item.installCaptureZCode();
140
- for (const [event, payload] of [
141
- ['UserPromptSubmit', { prompt: 'isolated zcode dedup request' }],
142
- ['Stop', { last_assistant_message: 'isolated zcode dedup answer' }],
143
- ]) {
144
- const hooks = read(zcode).hooks.events[event].flatMap(group => group.hooks);
145
- assert.equal(hooks.length, 1);
146
- const call = spawnSync(process.execPath, hooks[0].args, { cwd: repo, env, input: JSON.stringify({ hook_event_name: event, cwd: repo, session_id: 'zcode-dedup-test', ...payload }), encoding: 'utf8', windowsHide: true, timeout: 10000 });
147
- assert.equal(call.status, 0, call.stderr);
148
- }
149
- const afterZCode = fs.readFileSync(journal, 'utf8').trim().split(/\r?\n/).map(line => JSON.parse(line));
150
- assert.deepEqual(afterZCode.map(row => row.source), ['claude-code', 'claude-code', 'zcode', 'zcode']);
151
- assert(!fs.existsSync(obsoleteStore), 'ZCode also cannot recreate the old knowledge folder');
152
- console.log('capture-hook-dedup-test PASS (duplicate status, exact ownership, mixed-group preservation, idempotency, runtime failure and real journal capture)');
153
- }
154
-
155
- main().catch(error => { console.error(error.stack); process.exitCode = 1; }).finally(() => {
156
- assert(path.resolve(TEMP).startsWith(path.resolve(os.tmpdir()) + path.sep));
157
- fs.rmSync(TEMP, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 });
158
- });
1
+ 'use strict';
2
+
3
+ const assert = require('assert');
4
+ const fs = require('fs');
5
+ const os = require('os');
6
+ const path = require('path');
7
+ const { spawnSync } = require('child_process');
8
+ const { IntegrationManager } = require(process.env.PK_TEST_INTEGRATION_ROOT
9
+ ? path.join(process.env.PK_TEST_INTEGRATION_ROOT, '_site/lib/integration-installer') : '../lib/integration-installer');
10
+ const { bridgeBinding, planCaptureHooks, repairCaptureHooks } = require('../lib/capture-hook-config');
11
+ const bridge = require('@sanqianx/ai-coding-event-bridge-console/src/bridge');
12
+ const ROOT = path.resolve(__dirname, '../..');
13
+ const TEMP = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-capture-dedup-'));
14
+ const HOME = path.join(TEMP, '用户 空格');
15
+ const OLD = path.join(HOME, '.ai-coding-event-bridge');
16
+ const CURRENT = path.join(HOME, '.project-knowledge-v5/events');
17
+ const options = { homeDir: HOME, bridgeHomeDir: CURRENT };
18
+ const shim = home => path.join(home, 'bin/bridge-hook.cjs');
19
+ const cmd = home => ({ type: 'command', command: `node "${shim(home)}"` });
20
+ const processHook = home => ({ type: 'process', command: 'node', args: [shim(home), '--source', 'zcode'], timeoutMs: 15000 });
21
+ const events = ['UserPromptSubmit', 'Stop'];
22
+ const read = file => JSON.parse(fs.readFileSync(file, 'utf8'));
23
+ function write(file, object) { fs.mkdirSync(path.dirname(file), { recursive: true }); fs.writeFileSync(file, JSON.stringify(object, null, 2) + '\n'); }
24
+ function manager(extra = {}) { return new IntegrationManager({ rootDir: ROOT, env: {}, ...options, ...extra }); }
25
+
26
+ async function main() {
27
+ const claude = path.join(HOME, '.claude/settings.json');
28
+ const third = { type: 'command', command: 'node "notify-user.cjs"', timeout: 10 };
29
+ const context = { type: 'command', command: 'node "context-hook.cjs" --client claude' };
30
+ const lookalike = { type: 'command', command: `node "${shim(OLD)}" && echo keep-user-wrapper` };
31
+ const customHome = path.join(HOME, 'independent-third-party-bridge');
32
+ const unrelated = { model: 'user-model', env: { PRIVATE_TEST_TOKEN: 'do-not-back-up-unrelated-secret' } };
33
+ write(claude, { ...unrelated, hooks: Object.fromEntries(events.map(event => [event, [
34
+ { matcher: '*', hooks: [cmd(OLD), third, cmd(CURRENT)] },
35
+ { matcher: '*', hooks: [cmd(OLD), cmd(CURRENT), context, lookalike, cmd(customHome)] },
36
+ ]])) });
37
+ const before = fs.readFileSync(claude, 'utf8');
38
+ const logs = [];
39
+ const item = manager({ logger: { info: (...args) => logs.push(args), error: (...args) => logs.push(args) } });
40
+ assert.equal((await item.statusCaptureClaude()).state, 'needs-repair', 'duplicate capture cannot be reported healthy');
41
+ assert.equal(fs.readFileSync(claude, 'utf8'), before, 'status is read-only');
42
+ const installed = await item.captureOperation('install', 'claude');
43
+ assert.equal(installed.removedLegacy, 4);
44
+ assert.equal(installed.removedDuplicates, 2);
45
+ assert(logs.some(row => row[2]?.context?.removedLegacy === 4 && row[2]?.context?.removedDuplicates === 2), 'repair counts are persisted without raw configuration');
46
+ assert(!JSON.stringify(logs).includes('do-not-back-up-unrelated-secret'));
47
+ let saved = read(claude);
48
+ assert.equal(saved.model, unrelated.model); assert.deepEqual(saved.env, unrelated.env);
49
+ for (const event of events) {
50
+ const hooks = saved.hooks[event].flatMap(group => group.hooks);
51
+ assert.equal(hooks.filter(hook => hook.command === cmd(CURRENT).command).length, 1);
52
+ assert.equal(hooks.filter(hook => hook.command === cmd(OLD).command).length, 0);
53
+ for (const keep of [third, context, lookalike, cmd(customHome)]) assert(hooks.some(hook => JSON.stringify(hook) === JSON.stringify(keep)), 'mixed-group third-party hooks survive');
54
+ }
55
+ assert(!fs.readFileSync(installed.backupFile, 'utf8').includes('do-not-back-up-unrelated-secret'), 'backup contains only removed owned invocations');
56
+ assert.equal((await item.statusCaptureClaude()).state, 'installed');
57
+ const after = fs.readFileSync(claude, 'utf8');
58
+ assert.equal((await item.installCaptureClaude()).changed, false);
59
+ assert.equal(fs.readFileSync(claude, 'utf8'), after, 'repeat repair is byte-idempotent');
60
+ await item.uninstallCaptureClaude();
61
+ saved = read(claude);
62
+ for (const event of events) assert(saved.hooks[event].flatMap(group => group.hooks).some(hook => hook.command === third.command), 'uninstall keeps other hooks in the same group');
63
+
64
+ const zcode = path.join(HOME, '.zcode/cli/config.json');
65
+ const zContext = { type: 'process', command: 'node', args: ['context-hook.cjs', '--client', 'zcode'] };
66
+ write(zcode, { ...unrelated, hooks: { enabled: true, events: Object.fromEntries(events.map(event => [event, [{ hooks: [processHook(OLD), third, processHook(CURRENT), processHook(CURRENT), zContext] }]])) } });
67
+ assert.equal((await item.statusCaptureZCode()).state, 'needs-repair');
68
+ const zInstalled = await item.installCaptureZCode();
69
+ assert.equal(zInstalled.removedLegacy, 2); assert.equal(zInstalled.removedDuplicates, 2);
70
+ const zBeforeRepeat = fs.readFileSync(zcode, 'utf8');
71
+ await item.installCaptureZCode();
72
+ assert.equal(fs.readFileSync(zcode, 'utf8'), zBeforeRepeat);
73
+ await item.uninstallCaptureZCode();
74
+ assert.deepEqual(read(zcode).env, unrelated.env);
75
+ assert.deepEqual(read(zcode).hooks.events.UserPromptSubmit[0].hooks, [third, zContext]);
76
+
77
+ write(claude, { hooks: Object.fromEntries(events.map(event => [event, [{ hooks: [cmd(OLD)] }]])) });
78
+ const onlyLegacy = fs.readFileSync(claude, 'utf8');
79
+ assert.throws(() => repairCaptureHooks(claude, 'claude', options), /入口未完整/);
80
+ const failed = manager({ bridgeModule: { installers: { claudeCode: { installClaudeCodeHook: async () => { throw new Error('runtime materialization failed'); } } } } });
81
+ await assert.rejects(failed.installCaptureClaude(), /materialization failed/);
82
+ assert.equal(fs.readFileSync(claude, 'utf8'), onlyLegacy, 'failed runtime install cannot retire working old capture');
83
+ const conflict = manager({ bridgeModule: { installers: { claudeCode: { installClaudeCodeHook: async () => ({ added: [], runtime: { conflict: true } }) } } } });
84
+ await assert.rejects(conflict.installCaptureClaude(), /版本冲突/);
85
+ assert.equal(fs.readFileSync(claude, 'utf8'), onlyLegacy, 'a runtime conflict cannot retire old capture');
86
+ const dry = manager({ dryRun: true });
87
+ await dry.installCaptureClaude(); await dry.uninstallCaptureClaude();
88
+ assert.equal(fs.readFileSync(claude, 'utf8'), onlyLegacy);
89
+ fs.writeFileSync(claude, '{invalid JSON');
90
+ assert.throws(() => planCaptureHooks(claude, 'claude', options), /JSON/);
91
+ assert.equal(fs.readFileSync(claude, 'utf8'), '{invalid JSON');
92
+ assert.equal(bridgeBinding(['node', `${shim(OLD)}.user-script`], options), '');
93
+ assert.equal(bridgeBinding(['node', shim(OLD), '--custom-argument'], options), '');
94
+ assert.equal(bridgeBinding([['node'], shim(OLD)], options), '');
95
+ write(claude, { hooks: { UserPromptSubmit: [null, { hooks: [cmd(OLD), cmd(CURRENT)] }], Stop: [{ hooks: [cmd(CURRENT)] }] } });
96
+ repairCaptureHooks(claude, 'claude', options);
97
+ assert.equal(read(claude).hooks.UserPromptSubmit[0], null, 'repair does not silently drop unrelated malformed groups');
98
+ write(claude, { hooks: Object.fromEntries(events.map(event => [event, [{ hooks: [cmd(OLD), cmd(CURRENT)] }]])) });
99
+ const originalRead = fs.readFileSync;
100
+ let reads = 0;
101
+ fs.readFileSync = function(file, ...args) {
102
+ const value = originalRead.call(this, file, ...args);
103
+ if (file === claude && ++reads === 2) write(claude, { ...JSON.parse(value), userConcurrentEdit: 'kept' });
104
+ return value;
105
+ };
106
+ try { assert.throws(() => repairCaptureHooks(claude, 'claude', options), error => error.code === 'CONFIG_CHANGED'); }
107
+ finally { fs.readFileSync = originalRead; }
108
+ assert.equal(read(claude).userConcurrentEdit, 'kept', 'a concurrent user edit is never overwritten');
109
+
110
+ // Real Git + real installed shims: the stale store is registered, but no
111
+ // repaired client invocation recreates it or sends duplicate events.
112
+ const repo = path.join(TEMP, '代码 中文 project');
113
+ fs.mkdirSync(repo, { recursive: true });
114
+ const git = spawnSync('git', ['init', '-q'], { cwd: repo, encoding: 'utf8', windowsHide: true });
115
+ assert.equal(git.status, 0, git.stderr);
116
+ const obsoleteStore = path.join(TEMP, 'knowledge/old-slug/dev-conversations');
117
+ const canonicalStore = path.join(TEMP, 'knowledge/Canonical-abcdef/dev-conversations');
118
+ await bridge.ensureRuntimeHome({ homeDir: OLD });
119
+ await bridge.projectRegistry.addProject({ home: OLD, path: repo, store: obsoleteStore });
120
+ await bridge.projectRegistry.addProject({ home: CURRENT, path: repo, store: canonicalStore });
121
+ fs.rmSync(path.join(TEMP, 'knowledge/old-slug'), { recursive: true, force: true });
122
+ write(claude, { hooks: Object.fromEntries(events.map(event => [event, [{ hooks: [cmd(OLD), cmd(CURRENT), cmd(CURRENT)] }]])) });
123
+ await item.installCaptureClaude();
124
+ const env = { ...process.env }; delete env.AI_CODING_EVENT_BRIDGE_HOME;
125
+ for (const [event, payload] of [
126
+ ['UserPromptSubmit', { prompt: 'isolated dedup test request' }],
127
+ ['Stop', { last_assistant_message: 'isolated dedup test answer' }],
128
+ ]) {
129
+ const hooks = read(claude).hooks[event].flatMap(group => group.hooks);
130
+ assert.equal(hooks.length, 1);
131
+ const call = spawnSync(process.execPath, [shim(CURRENT)], { cwd: repo, env, input: JSON.stringify({ hook_event_name: event, cwd: repo, session_id: 'dedup-test', ...payload }), encoding: 'utf8', windowsHide: true, timeout: 10000 });
132
+ assert.equal(call.status, 0, call.stderr);
133
+ }
134
+ const journal = path.join(canonicalStore, 'journal/events.jsonl');
135
+ const captured = fs.readFileSync(journal, 'utf8').trim().split(/\r?\n/).map(line => JSON.parse(line));
136
+ assert.deepEqual(captured.map(row => row.eventType), ['user_prompt', 'assistant_response']);
137
+ assert(!fs.existsSync(obsoleteStore), 'the stale second directory is not recreated');
138
+ write(zcode, { hooks: { enabled: true, events: Object.fromEntries(events.map(event => [event, [{ hooks: [processHook(OLD), processHook(CURRENT), processHook(CURRENT)] }]])) } });
139
+ await item.installCaptureZCode();
140
+ for (const [event, payload] of [
141
+ ['UserPromptSubmit', { prompt: 'isolated zcode dedup request' }],
142
+ ['Stop', { last_assistant_message: 'isolated zcode dedup answer' }],
143
+ ]) {
144
+ const hooks = read(zcode).hooks.events[event].flatMap(group => group.hooks);
145
+ assert.equal(hooks.length, 1);
146
+ const call = spawnSync(process.execPath, hooks[0].args, { cwd: repo, env, input: JSON.stringify({ hook_event_name: event, cwd: repo, session_id: 'zcode-dedup-test', ...payload }), encoding: 'utf8', windowsHide: true, timeout: 10000 });
147
+ assert.equal(call.status, 0, call.stderr);
148
+ }
149
+ const afterZCode = fs.readFileSync(journal, 'utf8').trim().split(/\r?\n/).map(line => JSON.parse(line));
150
+ assert.deepEqual(afterZCode.map(row => row.source), ['claude-code', 'claude-code', 'zcode', 'zcode']);
151
+ assert(!fs.existsSync(obsoleteStore), 'ZCode also cannot recreate the old knowledge folder');
152
+ console.log('capture-hook-dedup-test PASS (duplicate status, exact ownership, mixed-group preservation, idempotency, runtime failure and real journal capture)');
153
+ }
154
+
155
+ main().catch(error => { console.error(error.stack); process.exitCode = 1; }).finally(() => {
156
+ assert(path.resolve(TEMP).startsWith(path.resolve(os.tmpdir()) + path.sep));
157
+ fs.rmSync(TEMP, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 });
158
+ });