@sanqianx/project-knowledge 5.0.24 → 5.0.26

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 -1353
  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 +68 -65
  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,186 +1,186 @@
1
- 'use strict';
2
- // Red-first regression (Q7): Codex CLI 0.137 rejects
3
- // `plugin marketplace add <SOURCE>` with
4
- // "Error: --ref is only supported for git marketplace sources"
5
- // whenever the SOURCE string contains '@', which every scoped npm root
6
- // (node_modules/@sanqianx/project-knowledge) does. Running the same add from
7
- // the package directory's own cwd with SOURCE '.' avoids the '@' entirely.
8
- // ensureCodexMarketplace() must use that form for the target add and for the
9
- // rollback re-add of a previous scoped root, while non-'@' absolute paths keep
10
- // the original invocation and third-party same-name sources stay untouched.
11
- const assert = require('node:assert/strict');
12
- const fs = require('node:fs');
13
- const os = require('node:os');
14
- const path = require('node:path');
15
- const { IntegrationManager } = require('../lib/integration-installer');
16
-
17
- const TEMP_BASE = fs.mkdtempSync(path.join(os.tmpdir(), 'codex-marketplace-scoped-path-'));
18
- const TEST_HOME = path.join(TEMP_BASE, 'home');
19
- const MARKETPLACE = 'project-knowledge';
20
- const REF_ERROR = 'Error: --ref is only supported for git marketplace sources';
21
- const NEW_ROOT = path.join(TEMP_BASE, 'new-root', '@sanqianx', 'project-knowledge');
22
- const OLD_ROOT = path.join(TEMP_BASE, 'old-root', '@sanqianx-previous', 'project-knowledge');
23
- const PLAIN_ROOT = path.join(TEMP_BASE, 'plain-root', 'project-knowledge');
24
- const THIRD_PARTY_ROOT = path.join(TEMP_BASE, 'third-party', 'marketplace');
25
-
26
- function writePackage(directory, name, version) {
27
- fs.mkdirSync(directory, { recursive: true });
28
- fs.writeFileSync(path.join(directory, 'package.json'), JSON.stringify({ name, version }, null, 2));
29
- }
30
-
31
- // Native-style in-memory codex CLI mirroring 0.137 marketplace semantics:
32
- // a marketplace add SOURCE containing '@' is parsed as <repo>@<ref> and
33
- // rejected; SOURCE '.' resolves against runnerOptions.cwd.
34
- function createCodexCli() {
35
- const state = { marketplaces: new Map(), calls: [], addCalls: [], removeCalls: [], failAddDirs: new Set() };
36
- const runner = (command, args, runnerOptions = {}) => {
37
- state.calls.push({ command, args: [...args], cwd: runnerOptions.cwd || null });
38
- if (args[0] !== 'plugin' || args[1] !== 'marketplace') {
39
- return { status: 1, stdout: '', stderr: `fake codex CLI: unsupported command: ${args.join(' ')}` };
40
- }
41
- if (args[2] === 'list') {
42
- const lines = [...state.marketplaces].map(([name, source]) => `${name} ${source}`);
43
- return { status: 0, stdout: lines.length ? `${lines.join('\n')}\n` : '', stderr: '' };
44
- }
45
- if (args[2] === 'remove') {
46
- state.marketplaces.delete(args[3]);
47
- state.removeCalls.push(args[3]);
48
- return { status: 0, stdout: '', stderr: '' };
49
- }
50
- if (args[2] === 'add') {
51
- const source = String(args[3]);
52
- const resolved = path.resolve(String(runnerOptions.cwd || process.cwd()), source);
53
- state.addCalls.push({ source, cwd: runnerOptions.cwd || null, resolved });
54
- if (source.includes('@')) return { status: 1, stdout: '', stderr: REF_ERROR };
55
- if (state.failAddDirs.has(resolved)) return { status: 1, stdout: '', stderr: 'forced marketplace add failure (test)' };
56
- let stat = null;
57
- try { stat = fs.statSync(resolved); } catch { /* missing source handled below */ }
58
- if (!stat || !stat.isDirectory()) return { status: 1, stdout: '', stderr: `Error: marketplace source not found: ${source}` };
59
- state.marketplaces.set(MARKETPLACE, resolved);
60
- return { status: 0, stdout: '', stderr: '' };
61
- }
62
- return { status: 1, stdout: '', stderr: `fake codex CLI: unsupported marketplace command: ${args.join(' ')}` };
63
- };
64
- return { runner, state };
65
- }
66
-
67
- function createManager(cli, rootDir) {
68
- return new IntegrationManager({
69
- rootDir,
70
- homeDir: TEST_HOME,
71
- bridgeHomeDir: path.join(TEMP_BASE, 'bridge'),
72
- env: {},
73
- commandResolver: name => `fake-${name}`,
74
- runner: cli.runner,
75
- });
76
- }
77
-
78
- function registeredSource(cli) {
79
- const line = [...cli.state.marketplaces].map(([name, source]) => `${name} ${source}`)
80
- .find(item => item.startsWith(`${MARKETPLACE} `));
81
- return line ? line.slice(MARKETPLACE.length).trim() : null;
82
- }
83
-
84
- function lastAdd(cli) {
85
- assert.ok(cli.state.addCalls.length, 'expected at least one marketplace add call');
86
- return cli.state.addCalls[cli.state.addCalls.length - 1];
87
- }
88
-
89
- function assertDotAdd(add, expectedRoot, label) {
90
- assert.equal(add.source, '.', `${label}: scoped root must be added via the "." source, not an "@"-containing path`);
91
- assert.equal(path.resolve(add.cwd || ''), expectedRoot, `${label}: "." must resolve against the package directory's own cwd`);
92
- }
93
-
94
- function main() {
95
- writePackage(NEW_ROOT, '@sanqianx/project-knowledge', '5.0.16');
96
- writePackage(OLD_ROOT, '@sanqianx/project-knowledge', '5.0.15');
97
- writePackage(PLAIN_ROOT, '@sanqianx/project-knowledge', '5.0.16');
98
- writePackage(THIRD_PARTY_ROOT, 'third-party-market', '1.0.0');
99
-
100
- const results = [];
101
- const scenario = (name, fn) => {
102
- try { fn(); results.push({ name, ok: true }); }
103
- catch (error) { results.push({ name, ok: false, error: String((error && error.message) || error) }); }
104
- };
105
-
106
- scenario('fresh: scoped npm root installs via "." from its own cwd', () => {
107
- const cli = createCodexCli();
108
- createManager(cli, NEW_ROOT).ensureCodexMarketplace();
109
- assert.equal(registeredSource(cli), NEW_ROOT, 'fresh install must register the scoped npm root');
110
- assertDotAdd(lastAdd(cli), NEW_ROOT, 'fresh install');
111
- assert.equal(cli.state.removeCalls.length, 0, 'fresh install must not remove anything');
112
- });
113
-
114
- scenario('switch: replacing a previous scoped root registers the new root', () => {
115
- const cli = createCodexCli();
116
- cli.state.marketplaces.set(MARKETPLACE, OLD_ROOT);
117
- createManager(cli, NEW_ROOT).ensureCodexMarketplace();
118
- assert.ok(cli.state.removeCalls.includes(MARKETPLACE), 'switch must remove the previous marketplace first');
119
- assert.equal(registeredSource(cli), NEW_ROOT, 'switch must end registered on the new scoped root');
120
- assertDotAdd(lastAdd(cli), NEW_ROOT, 'switch');
121
- assert.ok(cli.state.addCalls.every(add => !add.source.includes('@')), 'no add may pass an "@"-containing source');
122
- });
123
-
124
- scenario('rollback: failed switch restores the old scoped root', () => {
125
- const cli = createCodexCli();
126
- cli.state.marketplaces.set(MARKETPLACE, OLD_ROOT);
127
- cli.state.failAddDirs.add(NEW_ROOT);
128
- assert.throws(() => createManager(cli, NEW_ROOT).ensureCodexMarketplace(), /已恢复原市场来源/);
129
- assert.equal(registeredSource(cli), OLD_ROOT, 'rollback must restore the previous scoped root');
130
- assertDotAdd(lastAdd(cli), OLD_ROOT, 'rollback');
131
- assert.ok(cli.state.addCalls.every(add => !add.source.includes('@')), 'rollback add must also avoid "@" in the source');
132
- });
133
-
134
- scenario('plain path: non-"@" absolute source keeps the original invocation', () => {
135
- const cli = createCodexCli();
136
- createManager(cli, PLAIN_ROOT).ensureCodexMarketplace();
137
- assert.equal(registeredSource(cli), PLAIN_ROOT);
138
- const add = lastAdd(cli);
139
- assert.equal(add.source, PLAIN_ROOT, 'non-scoped absolute path must keep being passed as the add source');
140
- assert.notEqual(add.source, '.', 'the "." form is reserved for "@"-containing paths');
141
- });
142
-
143
- scenario('third-party: same-name marketplace is never overwritten', () => {
144
- const cli = createCodexCli();
145
- cli.state.marketplaces.set(MARKETPLACE, THIRD_PARTY_ROOT);
146
- assert.throws(() => createManager(cli, NEW_ROOT).ensureCodexMarketplace(), /未覆盖第三方来源/);
147
- assert.equal(cli.state.addCalls.length, 0, 'third-party source must not be replaced');
148
- assert.equal(cli.state.removeCalls.length, 0, 'third-party source must not be removed');
149
- assert.equal(registeredSource(cli), THIRD_PARTY_ROOT, 'third-party registration must be untouched');
150
- });
151
-
152
- scenario('allowed failure keeps operation linkage and a safe diagnostic code', () => {
153
- const cli = createCodexCli();
154
- const logs = [];
155
- const manager = createManager(cli, NEW_ROOT);
156
- manager.operationId = 'op-native-source-test';
157
- manager.logger = Object.fromEntries(['info', 'warn', 'error'].map(level => [level, (event, message, meta) => logs.push({ event, message, meta })]));
158
- manager.execute('codex', ['plugin', 'marketplace', 'add', NEW_ROOT], { allowFailure: true });
159
- const failure = logs.find(log => log.event === 'integration.command_failed');
160
- assert.ok(failure, 'a tolerated CLI failure must not be logged as success');
161
- assert.equal(failure.meta.operationId, 'op-native-source-test');
162
- assert.equal(failure.meta.error.code, 'CODEX_LOCAL_SOURCE_REF');
163
- assert.equal(failure.meta.context.status, 1);
164
- assert.ok(!JSON.stringify(logs).includes(REF_ERROR), 'never save raw CLI output');
165
- });
166
-
167
- assert.equal(path.dirname(TEMP_BASE), path.resolve(os.tmpdir()));
168
- assert.equal(fs.lstatSync(TEMP_BASE).isSymbolicLink(), false);
169
- fs.rmSync(TEMP_BASE, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
170
-
171
- const failed = results.filter(item => !item.ok);
172
- for (const item of results) console.log(`${item.ok ? 'PASS' : 'FAIL'} ${item.name}${item.ok ? '' : ` :: ${item.error}`}`);
173
- if (failed.length) {
174
- console.error(`codex-marketplace-scoped-path-test: ${failed.length} of ${results.length} case(s) failed.`);
175
- process.exitCode = 1;
176
- return;
177
- }
178
- console.log('codex-marketplace-scoped-path-test passed.');
179
- }
180
-
181
- try {
182
- main();
183
- } catch (error) {
184
- console.error(error);
185
- process.exitCode = 1;
186
- }
1
+ 'use strict';
2
+ // Red-first regression (Q7): Codex CLI 0.137 rejects
3
+ // `plugin marketplace add <SOURCE>` with
4
+ // "Error: --ref is only supported for git marketplace sources"
5
+ // whenever the SOURCE string contains '@', which every scoped npm root
6
+ // (node_modules/@sanqianx/project-knowledge) does. Running the same add from
7
+ // the package directory's own cwd with SOURCE '.' avoids the '@' entirely.
8
+ // ensureCodexMarketplace() must use that form for the target add and for the
9
+ // rollback re-add of a previous scoped root, while non-'@' absolute paths keep
10
+ // the original invocation and third-party same-name sources stay untouched.
11
+ const assert = require('node:assert/strict');
12
+ const fs = require('node:fs');
13
+ const os = require('node:os');
14
+ const path = require('node:path');
15
+ const { IntegrationManager } = require('../lib/integration-installer');
16
+
17
+ const TEMP_BASE = fs.mkdtempSync(path.join(os.tmpdir(), 'codex-marketplace-scoped-path-'));
18
+ const TEST_HOME = path.join(TEMP_BASE, 'home');
19
+ const MARKETPLACE = 'project-knowledge';
20
+ const REF_ERROR = 'Error: --ref is only supported for git marketplace sources';
21
+ const NEW_ROOT = path.join(TEMP_BASE, 'new-root', '@sanqianx', 'project-knowledge');
22
+ const OLD_ROOT = path.join(TEMP_BASE, 'old-root', '@sanqianx-previous', 'project-knowledge');
23
+ const PLAIN_ROOT = path.join(TEMP_BASE, 'plain-root', 'project-knowledge');
24
+ const THIRD_PARTY_ROOT = path.join(TEMP_BASE, 'third-party', 'marketplace');
25
+
26
+ function writePackage(directory, name, version) {
27
+ fs.mkdirSync(directory, { recursive: true });
28
+ fs.writeFileSync(path.join(directory, 'package.json'), JSON.stringify({ name, version }, null, 2));
29
+ }
30
+
31
+ // Native-style in-memory codex CLI mirroring 0.137 marketplace semantics:
32
+ // a marketplace add SOURCE containing '@' is parsed as <repo>@<ref> and
33
+ // rejected; SOURCE '.' resolves against runnerOptions.cwd.
34
+ function createCodexCli() {
35
+ const state = { marketplaces: new Map(), calls: [], addCalls: [], removeCalls: [], failAddDirs: new Set() };
36
+ const runner = (command, args, runnerOptions = {}) => {
37
+ state.calls.push({ command, args: [...args], cwd: runnerOptions.cwd || null });
38
+ if (args[0] !== 'plugin' || args[1] !== 'marketplace') {
39
+ return { status: 1, stdout: '', stderr: `fake codex CLI: unsupported command: ${args.join(' ')}` };
40
+ }
41
+ if (args[2] === 'list') {
42
+ const lines = [...state.marketplaces].map(([name, source]) => `${name} ${source}`);
43
+ return { status: 0, stdout: lines.length ? `${lines.join('\n')}\n` : '', stderr: '' };
44
+ }
45
+ if (args[2] === 'remove') {
46
+ state.marketplaces.delete(args[3]);
47
+ state.removeCalls.push(args[3]);
48
+ return { status: 0, stdout: '', stderr: '' };
49
+ }
50
+ if (args[2] === 'add') {
51
+ const source = String(args[3]);
52
+ const resolved = path.resolve(String(runnerOptions.cwd || process.cwd()), source);
53
+ state.addCalls.push({ source, cwd: runnerOptions.cwd || null, resolved });
54
+ if (source.includes('@')) return { status: 1, stdout: '', stderr: REF_ERROR };
55
+ if (state.failAddDirs.has(resolved)) return { status: 1, stdout: '', stderr: 'forced marketplace add failure (test)' };
56
+ let stat = null;
57
+ try { stat = fs.statSync(resolved); } catch { /* missing source handled below */ }
58
+ if (!stat || !stat.isDirectory()) return { status: 1, stdout: '', stderr: `Error: marketplace source not found: ${source}` };
59
+ state.marketplaces.set(MARKETPLACE, resolved);
60
+ return { status: 0, stdout: '', stderr: '' };
61
+ }
62
+ return { status: 1, stdout: '', stderr: `fake codex CLI: unsupported marketplace command: ${args.join(' ')}` };
63
+ };
64
+ return { runner, state };
65
+ }
66
+
67
+ function createManager(cli, rootDir) {
68
+ return new IntegrationManager({
69
+ rootDir,
70
+ homeDir: TEST_HOME,
71
+ bridgeHomeDir: path.join(TEMP_BASE, 'bridge'),
72
+ env: {},
73
+ commandResolver: name => `fake-${name}`,
74
+ runner: cli.runner,
75
+ });
76
+ }
77
+
78
+ function registeredSource(cli) {
79
+ const line = [...cli.state.marketplaces].map(([name, source]) => `${name} ${source}`)
80
+ .find(item => item.startsWith(`${MARKETPLACE} `));
81
+ return line ? line.slice(MARKETPLACE.length).trim() : null;
82
+ }
83
+
84
+ function lastAdd(cli) {
85
+ assert.ok(cli.state.addCalls.length, 'expected at least one marketplace add call');
86
+ return cli.state.addCalls[cli.state.addCalls.length - 1];
87
+ }
88
+
89
+ function assertDotAdd(add, expectedRoot, label) {
90
+ assert.equal(add.source, '.', `${label}: scoped root must be added via the "." source, not an "@"-containing path`);
91
+ assert.equal(path.resolve(add.cwd || ''), expectedRoot, `${label}: "." must resolve against the package directory's own cwd`);
92
+ }
93
+
94
+ function main() {
95
+ writePackage(NEW_ROOT, '@sanqianx/project-knowledge', '5.0.16');
96
+ writePackage(OLD_ROOT, '@sanqianx/project-knowledge', '5.0.15');
97
+ writePackage(PLAIN_ROOT, '@sanqianx/project-knowledge', '5.0.16');
98
+ writePackage(THIRD_PARTY_ROOT, 'third-party-market', '1.0.0');
99
+
100
+ const results = [];
101
+ const scenario = (name, fn) => {
102
+ try { fn(); results.push({ name, ok: true }); }
103
+ catch (error) { results.push({ name, ok: false, error: String((error && error.message) || error) }); }
104
+ };
105
+
106
+ scenario('fresh: scoped npm root installs via "." from its own cwd', () => {
107
+ const cli = createCodexCli();
108
+ createManager(cli, NEW_ROOT).ensureCodexMarketplace();
109
+ assert.equal(registeredSource(cli), NEW_ROOT, 'fresh install must register the scoped npm root');
110
+ assertDotAdd(lastAdd(cli), NEW_ROOT, 'fresh install');
111
+ assert.equal(cli.state.removeCalls.length, 0, 'fresh install must not remove anything');
112
+ });
113
+
114
+ scenario('switch: replacing a previous scoped root registers the new root', () => {
115
+ const cli = createCodexCli();
116
+ cli.state.marketplaces.set(MARKETPLACE, OLD_ROOT);
117
+ createManager(cli, NEW_ROOT).ensureCodexMarketplace();
118
+ assert.ok(cli.state.removeCalls.includes(MARKETPLACE), 'switch must remove the previous marketplace first');
119
+ assert.equal(registeredSource(cli), NEW_ROOT, 'switch must end registered on the new scoped root');
120
+ assertDotAdd(lastAdd(cli), NEW_ROOT, 'switch');
121
+ assert.ok(cli.state.addCalls.every(add => !add.source.includes('@')), 'no add may pass an "@"-containing source');
122
+ });
123
+
124
+ scenario('rollback: failed switch restores the old scoped root', () => {
125
+ const cli = createCodexCli();
126
+ cli.state.marketplaces.set(MARKETPLACE, OLD_ROOT);
127
+ cli.state.failAddDirs.add(NEW_ROOT);
128
+ assert.throws(() => createManager(cli, NEW_ROOT).ensureCodexMarketplace(), /已恢复原市场来源/);
129
+ assert.equal(registeredSource(cli), OLD_ROOT, 'rollback must restore the previous scoped root');
130
+ assertDotAdd(lastAdd(cli), OLD_ROOT, 'rollback');
131
+ assert.ok(cli.state.addCalls.every(add => !add.source.includes('@')), 'rollback add must also avoid "@" in the source');
132
+ });
133
+
134
+ scenario('plain path: non-"@" absolute source keeps the original invocation', () => {
135
+ const cli = createCodexCli();
136
+ createManager(cli, PLAIN_ROOT).ensureCodexMarketplace();
137
+ assert.equal(registeredSource(cli), PLAIN_ROOT);
138
+ const add = lastAdd(cli);
139
+ assert.equal(add.source, PLAIN_ROOT, 'non-scoped absolute path must keep being passed as the add source');
140
+ assert.notEqual(add.source, '.', 'the "." form is reserved for "@"-containing paths');
141
+ });
142
+
143
+ scenario('third-party: same-name marketplace is never overwritten', () => {
144
+ const cli = createCodexCli();
145
+ cli.state.marketplaces.set(MARKETPLACE, THIRD_PARTY_ROOT);
146
+ assert.throws(() => createManager(cli, NEW_ROOT).ensureCodexMarketplace(), /未覆盖第三方来源/);
147
+ assert.equal(cli.state.addCalls.length, 0, 'third-party source must not be replaced');
148
+ assert.equal(cli.state.removeCalls.length, 0, 'third-party source must not be removed');
149
+ assert.equal(registeredSource(cli), THIRD_PARTY_ROOT, 'third-party registration must be untouched');
150
+ });
151
+
152
+ scenario('allowed failure keeps operation linkage and a safe diagnostic code', () => {
153
+ const cli = createCodexCli();
154
+ const logs = [];
155
+ const manager = createManager(cli, NEW_ROOT);
156
+ manager.operationId = 'op-native-source-test';
157
+ manager.logger = Object.fromEntries(['info', 'warn', 'error'].map(level => [level, (event, message, meta) => logs.push({ event, message, meta })]));
158
+ manager.execute('codex', ['plugin', 'marketplace', 'add', NEW_ROOT], { allowFailure: true });
159
+ const failure = logs.find(log => log.event === 'integration.command_failed');
160
+ assert.ok(failure, 'a tolerated CLI failure must not be logged as success');
161
+ assert.equal(failure.meta.operationId, 'op-native-source-test');
162
+ assert.equal(failure.meta.error.code, 'CODEX_LOCAL_SOURCE_REF');
163
+ assert.equal(failure.meta.context.status, 1);
164
+ assert.ok(!JSON.stringify(logs).includes(REF_ERROR), 'never save raw CLI output');
165
+ });
166
+
167
+ assert.equal(path.dirname(TEMP_BASE), path.resolve(os.tmpdir()));
168
+ assert.equal(fs.lstatSync(TEMP_BASE).isSymbolicLink(), false);
169
+ fs.rmSync(TEMP_BASE, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
170
+
171
+ const failed = results.filter(item => !item.ok);
172
+ for (const item of results) console.log(`${item.ok ? 'PASS' : 'FAIL'} ${item.name}${item.ok ? '' : ` :: ${item.error}`}`);
173
+ if (failed.length) {
174
+ console.error(`codex-marketplace-scoped-path-test: ${failed.length} of ${results.length} case(s) failed.`);
175
+ process.exitCode = 1;
176
+ return;
177
+ }
178
+ console.log('codex-marketplace-scoped-path-test passed.');
179
+ }
180
+
181
+ try {
182
+ main();
183
+ } catch (error) {
184
+ console.error(error);
185
+ process.exitCode = 1;
186
+ }
@@ -1,101 +1,101 @@
1
- // Run: node _site/_test/codex-notify-capture-e2e-test.js
2
- 'use strict';
3
-
4
- const assert = require('assert');
5
- const fs = require('fs');
6
- const os = require('os');
7
- const path = require('path');
8
- const { spawnSync } = require('child_process');
9
- const { IntegrationManager } = require('../lib/integration-installer');
10
- const bridge = require('@sanqianx/ai-coding-event-bridge-console/src/bridge');
11
-
12
- const ROOT = path.resolve(__dirname, '..', '..');
13
- const TEMP = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-codex-notify-e2e-'));
14
- const repoPath = path.join(TEMP, '中文 project');
15
- const bridgeHomeDir = path.join(TEMP, 'bridge home');
16
- const sessionsRoot = path.join(TEMP, 'isolated sessions');
17
- const configFile = path.join(TEMP, 'home', '.codex', 'config.toml');
18
- const radarFile = path.join(TEMP, 'tools', 'devtask-radar', 'connectors', 'codex', 'notify-hook.js');
19
- const receivedFile = path.join(TEMP, 'third-party-payload.json');
20
- const sessionId = 'local-notify-e2e-session';
21
-
22
- async function waitFor(check, label) {
23
- for (let attempt = 0; attempt < 200; attempt++) {
24
- try { if (check()) return; } catch {}
25
- await new Promise(resolve => setTimeout(resolve, 20));
26
- }
27
- throw new Error(`Timed out: ${label}`);
28
- }
29
-
30
- function readEvents(file) {
31
- return fs.existsSync(file) ? fs.readFileSync(file, 'utf8').split(/\r?\n/).filter(Boolean).map(line => JSON.parse(line)) : [];
32
- }
33
-
34
- function invokeNotify(notify, payload) {
35
- const env = { ...process.env, CODEX_SESSIONS_ROOT: sessionsRoot };
36
- // A fresh client does not inherit the shell's Bridge-home override. The
37
- // installed shim must resolve its own target directory from its location.
38
- delete env.AI_CODING_EVENT_BRIDGE_HOME;
39
- const result = spawnSync(notify[0], [...notify.slice(1), payload], { env, cwd: repoPath, encoding: 'utf8', windowsHide: true, timeout: 5000 });
40
- assert.strictEqual(result.status, 0, result.stderr || result.error?.message);
41
- }
42
-
43
- async function main() {
44
- fs.mkdirSync(repoPath, { recursive: true });
45
- const initialized = spawnSync('git', ['init', '-q'], { cwd: repoPath, encoding: 'utf8', windowsHide: true });
46
- assert.strictEqual(initialized.status, 0, initialized.stderr);
47
- fs.mkdirSync(path.dirname(configFile), { recursive: true });
48
- fs.mkdirSync(path.dirname(radarFile), { recursive: true });
49
- fs.writeFileSync(radarFile, `require('fs').writeFileSync(${JSON.stringify(receivedFile)}, JSON.stringify(process.argv.slice(2)));`);
50
- fs.writeFileSync(configFile, `notify = ${JSON.stringify(['node', radarFile])}\n`);
51
- const manager = new IntegrationManager({ rootDir: ROOT, homeDir: path.join(TEMP, 'home'), env: {}, bridgeHomeDir, codexConfigFile: configFile });
52
- const result = await manager.installCaptureCodex();
53
- assert(result.installed && !result.conflict);
54
- const registered = await bridge.projectRegistry.addProject({ home: bridgeHomeDir, path: repoPath, store: path.join(TEMP, 'project event store') });
55
- const eventsFile = path.join(registered.store, 'journal', 'events.jsonl');
56
- const cursorFile = path.join(bridgeHomeDir, 'cursors', 'codex', `${sessionId}.json`);
57
- fs.mkdirSync(sessionsRoot, { recursive: true });
58
- const record = (type, payload) => JSON.stringify({ timestamp: new Date().toISOString(), type, payload });
59
- const messages = [
60
- record('session_meta', { id: sessionId, cwd: repoPath }),
61
- record('response_item', { type: 'message', role: 'user', internal_chat_message_metadata_passthrough: { turn_id: 'turn-local-1' }, content: [{ type: 'input_text', text: '隔离采集验证:用户原始请求' }] }),
62
- record('response_item', { type: 'message', role: 'assistant', phase: 'final_answer', internal_chat_message_metadata_passthrough: { turn_id: 'turn-local-1' }, content: [{ type: 'output_text', text: '隔离采集验证:rollout 原始回答' }] }),
63
- ];
64
- fs.writeFileSync(path.join(sessionsRoot, `rollout-${sessionId}.jsonl`), messages.join('\n') + '\n');
65
- const notify = JSON.parse(fs.readFileSync(configFile, 'utf8').split(/\r?\n/).find(line => /^notify\s*=/.test(line)).replace(/^notify\s*=\s*/, ''));
66
- const payload = '{ "type": "agent-turn-complete", "thread-id": "local-notify-e2e-session", "turn-id": "turn-local-1", "last-assistant-message": "NOT-EVIDENCE: do not use the notification summary" }';
67
- invokeNotify(notify, payload);
68
- await waitFor(() => fs.existsSync(cursorFile) && fs.existsSync(receivedFile) && readEvents(eventsFile).length === 2, 'official notify → real runtime → project journal');
69
- assert.deepStrictEqual(JSON.parse(fs.readFileSync(receivedFile, 'utf8')), [payload], 'third party receives unchanged JSON argv');
70
- const captured = readEvents(eventsFile);
71
- assert.deepStrictEqual(captured.map(event => event.content), ['隔离采集验证:用户原始请求', '隔离采集验证:rollout 原始回答']);
72
- assert(captured.every(event => event.source === 'codex' && event.sessionId === sessionId && event.turnId === 'turn-local-1'));
73
- assert(captured.every(event => event.repoIdentity.workspaceId === registered.id && path.resolve(event.projectPath).toLowerCase() === path.resolve(repoPath).toLowerCase()), 'workspace comes from rollout metadata, not the notification or server cwd');
74
- assert(!JSON.stringify(captured).includes('NOT-EVIDENCE'), 'notification summaries are never captured as conversation facts');
75
-
76
- const beforeRepeat = JSON.parse(fs.readFileSync(cursorFile, 'utf8')).updatedAt;
77
- await new Promise(resolve => setTimeout(resolve, 25));
78
- invokeNotify(notify, payload);
79
- // Filesystems may coalesce mtime; the durable cursor timestamp proves that
80
- // the reader completed another pass rather than merely touching a file.
81
- await waitFor(() => JSON.parse(fs.readFileSync(cursorFile, 'utf8')).updatedAt !== beforeRepeat, 'second notification reaches the real cursor reader');
82
- assert.strictEqual(readEvents(eventsFile).length, 2, 'duplicate notify cannot duplicate captured evidence');
83
-
84
- invokeNotify(notify, JSON.stringify({ type: 'agent-turn-complete', 'thread-id': 'missing-session-e2e', 'last-assistant-message': 'must not be fabricated' }));
85
- const gapsFile = path.join(bridgeHomeDir, 'journal', 'capture-gaps.jsonl');
86
- await waitFor(() => readEvents(gapsFile).some(item => item.sessionId === 'missing-session-e2e' && item.reason === 'session-file-not-found'), 'missing rollout is an explicit capture gap');
87
- assert.strictEqual(readEvents(eventsFile).length, 2, 'missing session cannot be guessed from the newest rollout');
88
-
89
- await manager.uninstallCaptureCodex();
90
- assert.deepStrictEqual(JSON.parse(fs.readFileSync(configFile, 'utf8').split(/\r?\n/).find(line => /^notify\s*=/.test(line)).replace(/^notify\s*=\s*/, '')), ['node', radarFile]);
91
- assert.strictEqual(readEvents(eventsFile).length, 2, 'uninstall retains existing evidence');
92
- console.log('codex-notify-capture-e2e-test PASS (real Git, installed Bridge runtime and project journal; fixture rollout, no LLM calls)');
93
- }
94
-
95
- module.exports = main().catch(error => {
96
- console.error(error.stack || error.message);
97
- process.exitCode = 1;
98
- }).finally(() => {
99
- assert(path.resolve(TEMP).startsWith(`${path.resolve(os.tmpdir())}${path.sep}`));
100
- fs.rmSync(TEMP, { recursive: true, force: true, maxRetries: 3, retryDelay: 50 });
101
- });
1
+ // Run: node _site/_test/codex-notify-capture-e2e-test.js
2
+ 'use strict';
3
+
4
+ const assert = require('assert');
5
+ const fs = require('fs');
6
+ const os = require('os');
7
+ const path = require('path');
8
+ const { spawnSync } = require('child_process');
9
+ const { IntegrationManager } = require('../lib/integration-installer');
10
+ const bridge = require('@sanqianx/ai-coding-event-bridge-console/src/bridge');
11
+
12
+ const ROOT = path.resolve(__dirname, '..', '..');
13
+ const TEMP = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-codex-notify-e2e-'));
14
+ const repoPath = path.join(TEMP, '中文 project');
15
+ const bridgeHomeDir = path.join(TEMP, 'bridge home');
16
+ const sessionsRoot = path.join(TEMP, 'isolated sessions');
17
+ const configFile = path.join(TEMP, 'home', '.codex', 'config.toml');
18
+ const radarFile = path.join(TEMP, 'tools', 'devtask-radar', 'connectors', 'codex', 'notify-hook.js');
19
+ const receivedFile = path.join(TEMP, 'third-party-payload.json');
20
+ const sessionId = 'local-notify-e2e-session';
21
+
22
+ async function waitFor(check, label) {
23
+ for (let attempt = 0; attempt < 200; attempt++) {
24
+ try { if (check()) return; } catch {}
25
+ await new Promise(resolve => setTimeout(resolve, 20));
26
+ }
27
+ throw new Error(`Timed out: ${label}`);
28
+ }
29
+
30
+ function readEvents(file) {
31
+ return fs.existsSync(file) ? fs.readFileSync(file, 'utf8').split(/\r?\n/).filter(Boolean).map(line => JSON.parse(line)) : [];
32
+ }
33
+
34
+ function invokeNotify(notify, payload) {
35
+ const env = { ...process.env, CODEX_SESSIONS_ROOT: sessionsRoot };
36
+ // A fresh client does not inherit the shell's Bridge-home override. The
37
+ // installed shim must resolve its own target directory from its location.
38
+ delete env.AI_CODING_EVENT_BRIDGE_HOME;
39
+ const result = spawnSync(notify[0], [...notify.slice(1), payload], { env, cwd: repoPath, encoding: 'utf8', windowsHide: true, timeout: 5000 });
40
+ assert.strictEqual(result.status, 0, result.stderr || result.error?.message);
41
+ }
42
+
43
+ async function main() {
44
+ fs.mkdirSync(repoPath, { recursive: true });
45
+ const initialized = spawnSync('git', ['init', '-q'], { cwd: repoPath, encoding: 'utf8', windowsHide: true });
46
+ assert.strictEqual(initialized.status, 0, initialized.stderr);
47
+ fs.mkdirSync(path.dirname(configFile), { recursive: true });
48
+ fs.mkdirSync(path.dirname(radarFile), { recursive: true });
49
+ fs.writeFileSync(radarFile, `require('fs').writeFileSync(${JSON.stringify(receivedFile)}, JSON.stringify(process.argv.slice(2)));`);
50
+ fs.writeFileSync(configFile, `notify = ${JSON.stringify(['node', radarFile])}\n`);
51
+ const manager = new IntegrationManager({ rootDir: ROOT, homeDir: path.join(TEMP, 'home'), env: {}, bridgeHomeDir, codexConfigFile: configFile });
52
+ const result = await manager.installCaptureCodex();
53
+ assert(result.installed && !result.conflict);
54
+ const registered = await bridge.projectRegistry.addProject({ home: bridgeHomeDir, path: repoPath, store: path.join(TEMP, 'project event store') });
55
+ const eventsFile = path.join(registered.store, 'journal', 'events.jsonl');
56
+ const cursorFile = path.join(bridgeHomeDir, 'cursors', 'codex', `${sessionId}.json`);
57
+ fs.mkdirSync(sessionsRoot, { recursive: true });
58
+ const record = (type, payload) => JSON.stringify({ timestamp: new Date().toISOString(), type, payload });
59
+ const messages = [
60
+ record('session_meta', { id: sessionId, cwd: repoPath }),
61
+ record('response_item', { type: 'message', role: 'user', internal_chat_message_metadata_passthrough: { turn_id: 'turn-local-1' }, content: [{ type: 'input_text', text: '隔离采集验证:用户原始请求' }] }),
62
+ record('response_item', { type: 'message', role: 'assistant', phase: 'final_answer', internal_chat_message_metadata_passthrough: { turn_id: 'turn-local-1' }, content: [{ type: 'output_text', text: '隔离采集验证:rollout 原始回答' }] }),
63
+ ];
64
+ fs.writeFileSync(path.join(sessionsRoot, `rollout-${sessionId}.jsonl`), messages.join('\n') + '\n');
65
+ const notify = JSON.parse(fs.readFileSync(configFile, 'utf8').split(/\r?\n/).find(line => /^notify\s*=/.test(line)).replace(/^notify\s*=\s*/, ''));
66
+ const payload = '{ "type": "agent-turn-complete", "thread-id": "local-notify-e2e-session", "turn-id": "turn-local-1", "last-assistant-message": "NOT-EVIDENCE: do not use the notification summary" }';
67
+ invokeNotify(notify, payload);
68
+ await waitFor(() => fs.existsSync(cursorFile) && fs.existsSync(receivedFile) && readEvents(eventsFile).length === 2, 'official notify → real runtime → project journal');
69
+ assert.deepStrictEqual(JSON.parse(fs.readFileSync(receivedFile, 'utf8')), [payload], 'third party receives unchanged JSON argv');
70
+ const captured = readEvents(eventsFile);
71
+ assert.deepStrictEqual(captured.map(event => event.content), ['隔离采集验证:用户原始请求', '隔离采集验证:rollout 原始回答']);
72
+ assert(captured.every(event => event.source === 'codex' && event.sessionId === sessionId && event.turnId === 'turn-local-1'));
73
+ assert(captured.every(event => event.repoIdentity.workspaceId === registered.id && path.resolve(event.projectPath).toLowerCase() === path.resolve(repoPath).toLowerCase()), 'workspace comes from rollout metadata, not the notification or server cwd');
74
+ assert(!JSON.stringify(captured).includes('NOT-EVIDENCE'), 'notification summaries are never captured as conversation facts');
75
+
76
+ const beforeRepeat = JSON.parse(fs.readFileSync(cursorFile, 'utf8')).updatedAt;
77
+ await new Promise(resolve => setTimeout(resolve, 25));
78
+ invokeNotify(notify, payload);
79
+ // Filesystems may coalesce mtime; the durable cursor timestamp proves that
80
+ // the reader completed another pass rather than merely touching a file.
81
+ await waitFor(() => JSON.parse(fs.readFileSync(cursorFile, 'utf8')).updatedAt !== beforeRepeat, 'second notification reaches the real cursor reader');
82
+ assert.strictEqual(readEvents(eventsFile).length, 2, 'duplicate notify cannot duplicate captured evidence');
83
+
84
+ invokeNotify(notify, JSON.stringify({ type: 'agent-turn-complete', 'thread-id': 'missing-session-e2e', 'last-assistant-message': 'must not be fabricated' }));
85
+ const gapsFile = path.join(bridgeHomeDir, 'journal', 'capture-gaps.jsonl');
86
+ await waitFor(() => readEvents(gapsFile).some(item => item.sessionId === 'missing-session-e2e' && item.reason === 'session-file-not-found'), 'missing rollout is an explicit capture gap');
87
+ assert.strictEqual(readEvents(eventsFile).length, 2, 'missing session cannot be guessed from the newest rollout');
88
+
89
+ await manager.uninstallCaptureCodex();
90
+ assert.deepStrictEqual(JSON.parse(fs.readFileSync(configFile, 'utf8').split(/\r?\n/).find(line => /^notify\s*=/.test(line)).replace(/^notify\s*=\s*/, '')), ['node', radarFile]);
91
+ assert.strictEqual(readEvents(eventsFile).length, 2, 'uninstall retains existing evidence');
92
+ console.log('codex-notify-capture-e2e-test PASS (real Git, installed Bridge runtime and project journal; fixture rollout, no LLM calls)');
93
+ }
94
+
95
+ module.exports = main().catch(error => {
96
+ console.error(error.stack || error.message);
97
+ process.exitCode = 1;
98
+ }).finally(() => {
99
+ assert(path.resolve(TEMP).startsWith(`${path.resolve(os.tmpdir())}${path.sep}`));
100
+ fs.rmSync(TEMP, { recursive: true, force: true, maxRetries: 3, retryDelay: 50 });
101
+ });