@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,404 +1,313 @@
1
- 'use strict';
2
- // GLM independent QA for the web part of docs/plans/ui-refresh-electron-plan-2026-10-13.md.
3
- // Node/HTTP/VM only: no browser, no CDP; stubs listen on 127.0.0.1:0; no product process.
4
- // Temp data stays in .local-test-data/ui-refresh-2026-10-15/ and is never deleted here.
5
- //
6
- // Every risk is probed twice: baseline = the pre-fix sources from git HEAD (first-failure
7
- // evidence), current = the working tree (post-fix verification, the Leader is fixing
8
- // production code concurrently). Gates encode the plan's desired behavior.
9
- // A first screen / B slow module / C engine takeover / D config sync / E 8-tab SSE.
10
-
11
- const assert = require('node:assert/strict');
12
- const fs = require('node:fs');
13
- const path = require('node:path');
14
- const http = require('node:http');
15
- const vm = require('node:vm');
16
- const { execFileSync } = require('node:child_process');
17
-
18
- const ROOT = path.resolve(__dirname, '../..');
19
- const { ModuleBridge } = require('../lib/module-bridge');
20
- const { connectEngine } = require('../lib/engine-connection');
21
-
22
- const TEMP_DATA = path.join(ROOT, '.local-test-data', 'ui-refresh-2026-10-15');
23
- fs.mkdirSync(TEMP_DATA, { recursive: true });
24
-
25
- const allServers = [];
26
- const sleep = ms => new Promise(resolve => setTimeout(resolve, ms));
27
- const gates = [];
28
-
29
- async function gate(section, name, run) {
30
- try { await run(); gates.push({ section, name, ok: true }); console.log('[PASS] ' + section + ' ' + name); }
31
- catch (error) { gates.push({ section, name, ok: false, message: error && error.message }); console.log('[FAIL] ' + section + ' ' + name + ' :: ' + (error && error.message)); }
32
- }
33
-
34
- const BASELINE_COMMIT = '55e162762950a069cf00e826c9f9b8eea5c768e5';
35
- // CI checks out with actions/checkout's default fetch-depth=1, so the pinned
36
- // baseline commit may not exist there. Baseline gates are first-failure
37
- // evidence already recorded with the plan review; when the commit is absent
38
- // they degrade to a skip instead of crashing the whole run.
39
- let baselineReady = true;
40
- try { execFileSync('git', ['cat-file', '-e', `${BASELINE_COMMIT}^{commit}`], { cwd: ROOT, stdio: 'ignore' }); }
41
- catch { baselineReady = false; }
42
-
43
- function headSource(relPath) {
44
- return execFileSync('git', ['show', BASELINE_COMMIT + ':' + relPath], { encoding: 'utf8', cwd: ROOT, maxBuffer: 16 * 1024 * 1024 });
45
- }
46
-
47
- const headModuleCache = new Map();
48
- function loadHeadModule(relPath) {
49
- if (headModuleCache.has(relPath)) return headModuleCache.get(relPath);
50
- const moduleObject = { exports: {} };
51
- const directory = path.dirname(path.join(ROOT, relPath));
52
- const sandboxRequire = request => require(request.startsWith('.') ? path.join(directory, request) : request);
53
- const sandbox = {
54
- require: sandboxRequire, module: moduleObject, exports: moduleObject.exports,
55
- fetch, AbortController, setTimeout, clearTimeout, setInterval, clearInterval, Buffer, URL, URLSearchParams, console,
56
- process: { env: {}, versions: { node: process.versions.node }, platform: process.platform },
57
- };
58
- sandbox.globalThis = sandbox;
59
- vm.runInNewContext(headSource(relPath), sandbox, { filename: relPath });
60
- headModuleCache.set(relPath, moduleObject.exports);
61
- return moduleObject.exports;
62
- }
63
-
64
- function startStub(routes) {
65
- const counters = {};
66
- const server = http.createServer((req, res) => {
67
- let body = '';
68
- req.on('data', chunk => { body += chunk; });
69
- req.on('end', () => {
70
- const cleanPath = req.url.split('?')[0];
71
- const route = routes.find(r => (r.method === 'ANY' || r.method === req.method) && r.path.test(cleanPath));
72
- if (!route) { res.writeHead(404, { 'Content-Type': 'application/json' }); res.end('{}'); return; }
73
- if (route.hang) return; // accepted the socket and never responds: the hung module
74
- counters[route.name] = (counters[route.name] || 0) + 1;
75
- if (route.countWith) { const key = route.countWith(body); if (key) counters[key] = (counters[key] || 0) + 1; }
76
- let payload = {};
77
- let status = route.status || 200;
78
- if (route.handle) {
79
- payload = route.handle(cleanPath, body);
80
- if (payload && payload.__status) { status = payload.__status; delete payload.__status; }
81
- }
82
- res.writeHead(status, { 'Content-Type': 'application/json' });
83
- res.end(JSON.stringify(payload));
84
- });
85
- });
86
- allServers.push(server);
87
- return new Promise(resolve => server.listen(0, '127.0.0.1', () => resolve({ server, url: 'http://127.0.0.1:' + server.address().port, counters })));
88
- }
89
-
90
- async function makeEnv(options = {}) {
91
- const failProjects = options.engineFailProjects || [];
92
- const BridgeClass = options.baseline ? loadHeadModule('_site/lib/module-bridge.js').ModuleBridge : ModuleBridge;
93
- const connect = options.baseline ? loadHeadModule('_site/lib/engine-connection.js').connectEngine : connectEngine;
94
- const terminal = await startStub([
95
- { method: 'GET', path: /\/projects\/?$/, name: 'terminal-list', handle: () => ({ projects: options.terminalProjects || [] }) },
96
- { method: 'POST', path: /\/claude-workbench\/v1\/projects\/?$/, name: 'terminal-register', handle: () => ({ id: 't1' }) },
97
- { method: 'POST', path: /internal\/maintenance-config$/, name: 'terminal-maintenance', status: 500, handle: () => ({}) },
98
- { method: 'POST', path: /internal\/embedding-config$/, name: 'terminal-embedding', status: 500, handle: () => ({}) },
99
- ]);
100
- const vectorHub = await startStub([
101
- { method: 'GET', path: /^\/api\/projects\/?$/, name: 'vector-list', hang: !!options.vectorHubHung, handle: () => ({ projects: [] }) },
102
- { method: 'GET', path: /^\/api\/health\/?$/, name: 'vector-health', hang: !!options.vectorHubHung, handle: () => ({ ok: true }) },
103
- { method: 'POST', path: /^\/api\/import$/, name: 'vector-import', handle: () => ({ ok: true }) },
104
- { method: 'POST', path: /^\/api\/internal\/runtime-config$/, name: 'vector-runtime-config', handle: () => ({ rootPath: null }) },
105
- ]);
106
- const eventBridge = await startStub([
107
- { method: 'GET', path: /^\/api\/projects\/?$/, name: 'bridge-list', handle: () => ({ projects: [] }) },
108
- { method: 'POST', path: /^\/api\/projects\/?$/, name: 'bridge-register', handle: () => ({ project: { id: 'eb1' } }) },
109
- { method: 'GET', path: /^\/api\/journal\/high-watermark$/, name: 'bridge-watermark', handle: () => ({ sequence: 0 }) },
110
- ]);
111
- const registered = [...(options.engineProjects || [])];
112
- const engine = await startStub([
113
- { method: 'GET', path: /^\/api\/health\/?$/, name: 'engine-health', handle: () => ({ name: 'knowledge-engine', dataSchemaVersion: 3 }) },
114
- { method: 'ANY', path: /^\/api\/runtime-auth\/?$/, name: 'engine-auth', handle: () => ({ ok: true }) },
115
- { method: 'GET', path: /^\/api\/projects\/?$/, name: 'engine-list', handle: () => ({ projects: registered }) },
116
- { method: 'POST', path: /^\/api\/projects\/?$/, name: 'engine-register', countWith: body => { try { return 'engine-register:' + JSON.parse(body).projectId; } catch { return null; } }, handle: (cleanPath, body) => { try { const parsed = JSON.parse(body); if (failProjects.includes(parsed.projectId)) return { __status: 500, ok: false, failed: parsed.projectId }; registered.push({ projectId: parsed.projectId, repoPath: parsed.repoPath, knowledgePath: parsed.knowledgePath }); } catch {} return { ok: true }; } },
117
- { method: 'GET', path: /^\/api\/snapshot\/?$/, name: 'engine-snapshot', handle: () => ({ sharedScopes: [] }) },
118
- { method: 'POST', path: /^\/api\/scopes\/?$/, name: 'engine-scopes', handle: () => ({ ok: true }) },
119
- { method: 'POST', path: /^\/api\/runtime-config\/?$/, name: 'engine-runtime-config', handle: () => ({ ok: true }) },
120
- { method: 'POST', path: /^\/api\/control\/?$/, name: 'engine-control', handle: () => ({ ok: true }) },
121
- ]);
122
- const projectIds = options.projectIds || [];
123
- const configs = new Map(projectIds.map(id => [id, { displayName: id, repoPath: 'D:/qa/' + id, knowledgePath: 'D:/qa/knowledge/' + id, brainId: 'brain-default', domainId: null }]));
124
- const states = new Map(projectIds.map(id => [id, {}]));
125
- const registryStore = { listIds: () => [...projectIds], readDisplaySnapshot: id => projectIds.includes(id) ? { displayName: id } : null };
126
- const projectStore = { readConfig: id => configs.get(id), readState: id => states.get(id) || {}, updateState: async (id, mutator) => { const state = states.get(id) || {}; mutator(state); states.set(id, state); } };
127
- const settings = { brain: { id: 'brain-default', name: 'QA-Brain', domains: [] }, knowledge: { rootPath: path.join(TEMP_DATA, 'qa-knowledge-root') } };
128
- const settingsStore = { read: () => settings, bindSharedKnowledgePaths: async () => {} };
129
- const bridge = new BridgeClass({
130
- terminalUrl: terminal.url, vectorHubUrl: vectorHub.url, eventBridgeUrl: eventBridge.url, engineUrl: engine.url,
131
- registryStore, projectStore, settingsStore, dataDir: path.join(TEMP_DATA, 'qa-data-dir'),
132
- logger: { info() {}, warn() {}, error() {} },
133
- });
134
- const makeRuntime = () => ({ analysisOwner: 'engine', moduleBridge: bridge, registryStore, projectStore, logger: { info() {}, warn() {}, error() {} }, ownership: { owner: 'engine', ready: false } });
135
- return { bridge, connect, makeRuntime, stubs: { terminal, vectorHub, eventBridge, engine } };
136
- }
137
-
138
- async function sectionA() {
139
- const makeElement = () => {
140
- const el = { textContent: '', innerHTML: '', hidden: false, disabled: false, value: '', className: '', open: false, dataset: {}, childElementCount: 0, firstElementChild: null };
141
- el.classList = { toggle() {}, add() {}, remove() {}, contains() { return false; } };
142
- el.addEventListener = () => {}; el.removeEventListener = () => {}; el.append = () => {}; el.replaceChildren = () => {};
143
- el.reset = () => {}; el.focus = () => {}; el.select = () => {}; el.close = () => {}; el.showModal = () => {}; el.scrollIntoView = () => {};
144
- el.dispatchEvent = () => true; el.parentElement = el; el.contentWindow = null;
145
- el.elements = { confirmGitInit: { checked: false }, confirmReplaceHook: { checked: false } };
146
- return el;
147
- };
148
- const jsonOk = payload => Promise.resolve({ ok: true, status: 200, json: async () => payload, headers: { get: () => null } });
149
- const brainPayload = { ok: true, brain: { id: 'brain-default', name: 'QA-Brain', domains: [] }, knowledgeRoot: 'D:/qa/root', indexStoragePath: 'D:/qa/idx' };
150
- const healthPayload = { ok: true, modules: { terminal: { up: true }, vectorHub: { up: true }, eventBridge: { up: true }, engine: { up: true } } };
151
- const projectsPayload = { ok: true, projects: [{ projectId: 'p1', name: 'P1', workspacePath: 'D:/qa/p1', knowledgePath: 'D:/qa/knowledge/p1', brainId: 'brain-default', domainId: null, modules: { terminal: { registered: true }, vectorHub: { registered: true }, eventBridge: { registered: true }, engine: { registered: true } } }] };
152
- const runScenario = async (source, fetchImpl) => {
153
- const elements = new Map();
154
- const timers = new Set();
155
- const get = id => { if (!elements.has(id)) elements.set(id, makeElement()); return elements.get(id); };
156
- const document = { getElementById: get, querySelectorAll: () => [], createElement: makeElement, addEventListener: () => {}, body: makeElement(), documentElement: { dataset: {} }, hidden: false };
157
- class EventSourceStub { constructor() { this.readyState = 0; } addEventListener() {} close() {} }
158
- const sandbox = {
159
- document, navigator: { onLine: true }, location: { origin: 'http://vm.local', hash: '' }, history: { replaceState() {} },
160
- addEventListener() {}, removeEventListener() {}, dispatchEvent() {},
161
- localStorage: { getItem: () => null, setItem() {} }, EventSource: EventSourceStub, fetch: fetchImpl, AbortController,
162
- URLSearchParams, URL, crypto: require('node:crypto').webcrypto,
163
- setTimeout: (fn, ms, ...rest) => { const timer = setTimeout(fn, ms, ...rest); timers.add(timer); return timer; },
164
- clearTimeout: timer => { timers.delete(timer); clearTimeout(timer); },
165
- setInterval: () => 0, clearInterval: () => {},
166
- };
167
- sandbox.window = sandbox; sandbox.globalThis = sandbox;
168
- vm.runInNewContext(source, sandbox, { filename: 'product.js' });
169
- await sleep(2500);
170
- for (const timer of timers) clearTimeout(timer);
171
- return id => (elements.has(id) ? elements.get(id).textContent : undefined);
172
- };
173
- const hungFetch = url => {
174
- const target = String(url);
175
- if (target.includes('/api/projects/aggregated') || target.includes('/api/projects/projection')) return new Promise(() => {});
176
- if (target.includes('/api/modules/health')) return jsonOk(healthPayload);
177
- if (target.includes('/api/brain')) return jsonOk(brainPayload);
178
- if (target.includes('/api/engine/snapshot')) return jsonOk({ projects: [], runs: [], events: [], memories: [] });
179
- return jsonOk({ ok: true });
180
- };
181
- const fastFetch = url => {
182
- const target = String(url);
183
- if (target.includes('/api/projects/aggregated') || target.includes('/api/projects/projection')) return jsonOk(projectsPayload);
184
- if (target.includes('/api/modules/health')) return jsonOk(healthPayload);
185
- if (target.includes('/api/brain')) return jsonOk(brainPayload);
186
- if (target.includes('/api/engine/snapshot')) return jsonOk({ projects: [], runs: [], events: [], memories: [] });
187
- return jsonOk({ ok: true });
188
- };
189
- if (baselineReady) {
190
- const readBaseline = await runScenario(headSource('ui/product.js'), hungFetch);
191
- console.log(' baseline(HEAD) systemTitle after 2.5s with a hanging projects read: ' + JSON.stringify(readBaseline('systemTitle')));
192
- await gate('A', 'A1 baseline(HEAD): health region renders while the projects read hangs', async () => {
193
- const value = readBaseline('systemTitle');
194
- assert.ok(value !== undefined && value !== '' && value !== '正在检查系统', 'systemTitle never updated: the first screen is one Promise.all behind the slowest read (refreshRegistry), so brain/health regions cannot render');
195
- });
196
- }
197
- const currentSource = fs.readFileSync(path.join(ROOT, 'ui', 'product.js'), 'utf8');
198
- const readCurrent = await runScenario(currentSource, hungFetch);
199
- console.log(' current systemTitle after 2.5s with a hanging projects read: ' + JSON.stringify(readCurrent('systemTitle')));
200
- await gate('A', 'A2 current: health region renders while the projects read hangs', async () => {
201
- const value = readCurrent('systemTitle');
202
- assert.ok(value !== undefined && value !== '' && value !== '正在检查系统', 'post-fix frontend still gates the health region behind the hanging projects read');
203
- });
204
- const readControl = await runScenario(currentSource, fastFetch);
205
- await gate('A', 'A3 control: current frontend renders system status when all reads are fast', async () => {
206
- assert.strictEqual(readControl('systemTitle'), '系统连接正常', 'control scenario failed to render the health region');
207
- });
208
- }
209
-
210
- async function sectionB() {
211
- const hungOptions = {
212
- vectorHubHung: true,
213
- projectIds: ['p1'],
214
- terminalProjects: [{ id: 't0', rootPath: 'D:/qa/p1' }],
215
- engineProjects: [{ projectId: 'p1', repoPath: 'D:/qa/p1', knowledgePath: 'D:/qa/knowledge/p1' }],
216
- };
217
- if (baselineReady) {
218
- const baseline = await makeEnv({ ...hungOptions, baseline: true });
219
- const baselineStarted = Date.now();
220
- await baseline.bridge.aggregatedProjects();
221
- const baselineMs = Date.now() - baselineStarted;
222
- console.log(' baseline(HEAD) aggregatedProjects() with one hung module: ' + baselineMs + 'ms');
223
- await gate('B', 'B1 baseline(HEAD): aggregated read within 3.5s despite one hung module', async () => {
224
- assert.ok(baselineMs <= 3500, 'baseline took ' + baselineMs + 'ms (10s list timeout + sequential 2s availability probes): one slow module stalls the whole first screen');
225
- });
226
- }
227
- const current = await makeEnv(hungOptions);
228
- const currentStarted = Date.now();
229
- const aggregated = await current.bridge.aggregatedProjects();
230
- const currentMs = Date.now() - currentStarted;
231
- console.log(' current aggregatedProjects() with one hung module: ' + currentMs + 'ms');
232
- await gate('B', 'B2 current: aggregated read within 3.5s despite one hung module', async () => {
233
- assert.ok(currentMs <= 3500, 'aggregatedProjects() took ' + currentMs + 'ms with one hung module; plan requires a 3s-class budget');
234
- });
235
- await gate('B', 'B3 current: aggregated read keeps the registry spine (no false "no projects")', async () => {
236
- assert.strictEqual(aggregated.projects.length, 1, 'aggregated projection must keep the registry spine even when a module is unreachable');
237
- });
238
- const healthStarted = Date.now();
239
- await current.bridge.modulesHealth();
240
- const healthMs = Date.now() - healthStarted;
241
- console.log(' current modulesHealth() with one hung module: ' + healthMs + 'ms');
242
- await gate('B', 'B4 current: modulesHealth within 2.5s (parallel probes)', async () => {
243
- assert.ok(healthMs <= 2500, 'modulesHealth() took ' + healthMs + 'ms');
244
- });
245
- }
246
-
247
- async function sectionC() {
248
- if (baselineReady) {
249
- const baseline = await makeEnv({ baseline: true, projectIds: ['proj-bad', 'proj-good'], engineFailProjects: ['proj-bad'] });
250
- const baselineRuntime = baseline.makeRuntime();
251
- await baseline.connect(baselineRuntime);
252
- console.log(' baseline(HEAD) engine counters with one failing project: ' + JSON.stringify(baseline.stubs.engine.counters));
253
- await gate('C', 'C1 baseline(HEAD): healthy project is wired when another project fails', async () => {
254
- assert.ok((baseline.stubs.engine.counters['engine-register:proj-good'] || 0) >= 1, 'proj-good never reached engine POST /api/projects: sequential wiring aborted at proj-bad');
255
- });
256
- await gate('C', 'C2 baseline(HEAD): ownership not globally pending because of one project', async () => {
257
- assert.ok(baselineRuntime.ownership.ready, 'ownership stayed not-ready (' + JSON.stringify(baselineRuntime.ownership.error || null) + '): one failing project keeps the whole product in global "待恢复"');
258
- });
259
- await gate('C', 'C3 baseline(HEAD): engine activation happens with one failing project', async () => {
260
- assert.ok((baseline.stubs.engine.counters['engine-control'] || 0) >= 1, 'engine POST /api/control never happened: activation is gated behind all-project wiring');
261
- });
262
- }
263
- const current = await makeEnv({ projectIds: ['proj-bad', 'proj-good'], engineFailProjects: ['proj-bad'] });
264
- const currentRuntime = current.makeRuntime();
265
- await current.connect(currentRuntime);
266
- console.log(' current engine counters with one failing project: ' + JSON.stringify(current.stubs.engine.counters));
267
- console.log(' current ownership: ' + JSON.stringify(currentRuntime.ownership));
268
- await gate('C', 'C4 current: healthy project is wired when another project fails', async () => {
269
- assert.ok((current.stubs.engine.counters['engine-register:proj-good'] || 0) >= 1, 'proj-good still not wired when proj-bad fails');
270
- });
271
- await gate('C', 'C5 current: ownership not globally pending because of one project', async () => {
272
- assert.ok(currentRuntime.ownership.ready, 'ownership still not-ready globally');
273
- });
274
- await gate('C', 'C6 current: engine activation happens with one failing project', async () => {
275
- assert.ok((current.stubs.engine.counters['engine-control'] || 0) >= 1, 'engine POST /api/control still gated behind all-project wiring');
276
- });
277
- }
278
-
279
- async function sectionC4() {
280
- if (baselineReady) {
281
- const baseline = await makeEnv({ baseline: true, projectIds: ['p-a', 'p-b'] });
282
- await baseline.connect(baseline.makeRuntime());
283
- await baseline.connect(baseline.makeRuntime());
284
- console.log(' baseline(HEAD) counters after two takeover passes: ' + JSON.stringify(baseline.stubs.engine.counters));
285
- await gate('C', 'C7 baseline(HEAD): healthy projects are not re-registered on a repeat takeover pass', async () => {
286
- assert.strictEqual(baseline.stubs.engine.counters['engine-register:p-a'] || 0, 1, 'every takeover pass re-POSTs every healthy project (no remote-list/fingerprint dedupe)');
287
- });
288
- await gate('C', 'C8 baseline(HEAD): unchanged configuration is not re-pushed on a repeat takeover pass', async () => {
289
- assert.strictEqual(baseline.stubs.engine.counters['engine-scopes'] || 0, 1, 'unchanged scopes are re-pushed on every pass (no change detection)');
290
- });
291
- }
292
- const current = await makeEnv({ projectIds: ['p-a', 'p-b'] });
293
- const currentRuntime = current.makeRuntime();
294
- await current.connect(currentRuntime);
295
- await current.connect(currentRuntime);
296
- console.log(' current counters after two takeover passes: ' + JSON.stringify(current.stubs.engine.counters));
297
- await gate('C', 'C9 current: healthy projects are not re-registered on a repeat takeover pass', async () => {
298
- assert.strictEqual(current.stubs.engine.counters['engine-register:p-a'] || 0, 1, 'healthy project re-registered on a repeat pass');
299
- });
300
- await gate('C', 'C10 current: unchanged configuration is not re-pushed on a repeat takeover pass', async () => {
301
- assert.strictEqual(current.stubs.engine.counters['engine-scopes'] || 0, 1, 'unchanged scopes re-pushed on a repeat pass');
302
- });
303
- }
304
-
305
- async function sectionD() {
306
- if (baselineReady) {
307
- const baseline = await makeEnv({ baseline: true, projectIds: ['p1'] });
308
- await Promise.all([baseline.bridge.syncEngineConfiguration(), baseline.bridge.syncEngineConfiguration(), baseline.bridge.syncEngineConfiguration()]);
309
- console.log(' baseline(HEAD) engine counters after 3 concurrent syncs: ' + JSON.stringify(baseline.stubs.engine.counters));
310
- await gate('D', 'D1 baseline(HEAD): concurrent duplicate config syncs are merged into one push', async () => {
311
- assert.strictEqual(baseline.stubs.engine.counters['engine-scopes'] || 0, 1, 'single-flight chains a full re-run per concurrent caller: 3 callers produced ' + (baseline.stubs.engine.counters['engine-scopes'] || 0) + ' scope pushes');
312
- });
313
- await baseline.bridge.syncEngineConfiguration();
314
- console.log(' baseline(HEAD) engine counters after a fourth unchanged sync: ' + JSON.stringify(baseline.stubs.engine.counters));
315
- await gate('D', 'D2 baseline(HEAD): unchanged configuration is not re-pushed on the next sync', async () => {
316
- assert.strictEqual(baseline.stubs.engine.counters['engine-scopes'] || 0, 1, 'a completed sync with unchanged settings still re-pushes scopes');
317
- });
318
- }
319
- const current = await makeEnv({ projectIds: ['p1'] });
320
- await Promise.all([current.bridge.syncEngineConfiguration(), current.bridge.syncEngineConfiguration(), current.bridge.syncEngineConfiguration()]);
321
- console.log(' current engine counters after 3 concurrent syncs: ' + JSON.stringify(current.stubs.engine.counters));
322
- await gate('D', 'D3 current: concurrent duplicate config syncs are merged into one push', async () => {
323
- assert.strictEqual(current.stubs.engine.counters['engine-scopes'] || 0, 1, 'concurrent syncs were not merged');
324
- });
325
- await current.bridge.syncEngineConfiguration();
326
- console.log(' current engine counters after a fourth unchanged sync: ' + JSON.stringify(current.stubs.engine.counters));
327
- await gate('D', 'D4 current: unchanged configuration is not re-pushed on the next sync', async () => {
328
- assert.strictEqual(current.stubs.engine.counters['engine-scopes'] || 0, 1, 'unchanged settings re-pushed');
329
- });
330
- }
331
-
332
- async function sectionE() {
333
- let upstreamOpen = 0;
334
- const upstream = http.createServer((req, res) => {
335
- if (!req.url.includes('/api/events/stream')) { res.writeHead(404); res.end(); return; }
336
- upstreamOpen++;
337
- res.writeHead(200, { 'Content-Type': 'text/event-stream', 'Cache-Control': 'no-cache' });
338
- res.write('event: snapshot\ndata: {"n":1}\n\n');
339
- const keepAlive = setInterval(() => { try { res.write('event: tick\ndata: {}\n\n'); } catch {} }, 200);
340
- req.on('close', () => { upstreamOpen--; clearInterval(keepAlive); });
341
- });
342
- allServers.push(upstream);
343
- await new Promise(resolve => upstream.listen(0, '127.0.0.1', resolve));
344
- const upstreamUrl = 'http://127.0.0.1:' + upstream.address().port;
345
- const env = await makeEnv({ projectIds: [] });
346
- const shell = http.createServer((req, res) => { env.bridge.proxy(req, res, upstreamUrl + '/api/events/stream').catch(() => {}); });
347
- allServers.push(shell);
348
- await new Promise(resolve => shell.listen(0, '127.0.0.1', resolve));
349
- const shellUrl = 'http://127.0.0.1:' + shell.address().port;
350
- const clients = [];
351
- try {
352
- for (let i = 0; i < 8; i++) {
353
- const controller = new AbortController();
354
- const got = { firstMs: null, startedAt: Date.now() };
355
- clients.push({ controller, got });
356
- fetch(shellUrl + '/stream', { signal: controller.signal, headers: { Accept: 'text/event-stream' } })
357
- .then(response => {
358
- got.firstMs = Date.now() - got.startedAt;
359
- const reader = response.body.getReader();
360
- const pump = () => reader.read().then(({ done }) => { if (!done) pump(); }).catch(() => {});
361
- pump();
362
- })
363
- .catch(() => {});
364
- }
365
- await sleep(1500);
366
- await gate('E', 'E1 current: 8 concurrent SSE clients each get their first event within 3s', async () => {
367
- assert.strictEqual(clients.filter(c => c.got.firstMs !== null).length, 8, 'not all 8 clients received a response within 1.5s');
368
- assert.strictEqual(upstreamOpen, 8, 'expected 8 independent upstream connections, saw ' + upstreamOpen);
369
- });
370
- for (const client of clients.slice(0, 4)) client.controller.abort();
371
- await sleep(1000);
372
- console.log(' upstream connections after aborting 4 of 8 clients: ' + upstreamOpen);
373
- await gate('E', 'E2 current: aborting 4 clients releases exactly their 4 upstream connections', async () => {
374
- assert.strictEqual(upstreamOpen, 4, 'aborting clients did not release their upstream connections (leak/block): ' + upstreamOpen + ' still open');
375
- });
376
- } finally {
377
- for (const client of clients) client.controller.abort();
378
- }
379
- }
380
-
381
- async function main() {
382
- if (!baselineReady) console.log(' baseline(HEAD) commit ' + BASELINE_COMMIT.slice(0, 7) + ' unavailable in this checkout (shallow clone); running current-behavior gates only.');
383
- await sectionA();
384
- await sectionB();
385
- await sectionC();
386
- await sectionC4();
387
- await sectionD();
388
- await sectionE();
389
- const failed = gates.filter(g => !g.ok);
390
- console.log('');
391
- console.log('glm-ui-refresh-review-test summary: ' + (gates.length - failed.length) + '/' + gates.length + ' gates passed');
392
- if (failed.length) {
393
- console.log('failed gates (baseline(HEAD) failures = first-failure evidence; current failures = regressions):');
394
- for (const g of failed) console.log(' [' + g.section + '] ' + g.name + ' :: ' + g.message);
395
- }
396
- const baseline = gates.filter(g => g.name.includes('baseline(HEAD)'));
397
- const regressions = failed.filter(g => !g.name.includes('baseline(HEAD)'));
398
- console.log(`Current: ${gates.length - baseline.length - regressions.length}/${gates.length - baseline.length}; baseline expected failures: ${baseline.filter(g => !g.ok).length}/${baseline.length}`);
399
- process.exitCode = regressions.length || baseline.some(g => g.ok) ? 1 : 0;
400
- }
401
-
402
- main().catch(error => { console.error(error); process.exitCode = 1; }).finally(() => {
403
- for (const server of allServers) { server.close(); server.closeAllConnections?.(); }
404
- });
1
+ 'use strict';
2
+ // GLM QA regression for the web part of docs/plans/ui-refresh-electron-plan-2026-10-13.md.
3
+ // Node/HTTP/VM only: no browser, no CDP; stubs listen on 127.0.0.1:0; no product process.
4
+ //
5
+ // Current-behavior regression only. The 2026-10-15 baseline-vs-current comparison
6
+ // experiment (git-show 55e1627 baseline gates + first-failure summary) has
7
+ // concluded; its full history stays recoverable from Git (as of 9ddf0db) and from
8
+ // the verified external backup recorded in docs/ci-maintenance-20261025.md. Gate
9
+ // names (A2..E2) are kept unchanged for traceability with that record.
10
+ // A first screen / B slow module / C engine takeover + dedupe / D config sync / E 8-tab SSE.
11
+ // Temp data lives in an exclusive os.tmpdir() mkdtemp per run; real homes are never touched.
12
+
13
+ const assert = require('node:assert/strict');
14
+ const fs = require('node:fs');
15
+ const os = require('node:os');
16
+ const path = require('node:path');
17
+ const http = require('node:http');
18
+ const vm = require('node:vm');
19
+
20
+ const ROOT = path.resolve(__dirname, '../..');
21
+ const { ModuleBridge } = require('../lib/module-bridge');
22
+ const { connectEngine } = require('../lib/engine-connection');
23
+
24
+ const TEMP_DATA = fs.mkdtempSync(path.join(os.tmpdir(), 'glm-ui-refresh-current-'));
25
+
26
+ const allServers = [];
27
+ const sleep = ms => new Promise(resolve => setTimeout(resolve, ms));
28
+ const gates = [];
29
+
30
+ async function gate(section, name, run) {
31
+ try { await run(); gates.push({ section, name, ok: true }); console.log('[PASS] ' + section + ' ' + name); }
32
+ catch (error) { gates.push({ section, name, ok: false, message: error && error.message }); console.log('[FAIL] ' + section + ' ' + name + ' :: ' + (error && error.message)); }
33
+ }
34
+
35
+ function startStub(routes) {
36
+ const counters = {};
37
+ const server = http.createServer((req, res) => {
38
+ let body = '';
39
+ req.on('data', chunk => { body += chunk; });
40
+ req.on('end', () => {
41
+ const cleanPath = req.url.split('?')[0];
42
+ const route = routes.find(r => (r.method === 'ANY' || r.method === req.method) && r.path.test(cleanPath));
43
+ if (!route) { res.writeHead(404, { 'Content-Type': 'application/json' }); res.end('{}'); return; }
44
+ if (route.hang) return; // accepted the socket and never responds: the hung module
45
+ counters[route.name] = (counters[route.name] || 0) + 1;
46
+ if (route.countWith) { const key = route.countWith(body); if (key) counters[key] = (counters[key] || 0) + 1; }
47
+ let payload = {};
48
+ let status = route.status || 200;
49
+ if (route.handle) {
50
+ payload = route.handle(cleanPath, body);
51
+ if (payload && payload.__status) { status = payload.__status; delete payload.__status; }
52
+ }
53
+ res.writeHead(status, { 'Content-Type': 'application/json' });
54
+ res.end(JSON.stringify(payload));
55
+ });
56
+ });
57
+ allServers.push(server);
58
+ return new Promise(resolve => server.listen(0, '127.0.0.1', () => resolve({ server, url: 'http://127.0.0.1:' + server.address().port, counters })));
59
+ }
60
+
61
+ async function makeEnv(options = {}) {
62
+ const failProjects = options.engineFailProjects || [];
63
+ const BridgeClass = ModuleBridge;
64
+ const connect = connectEngine;
65
+ const terminal = await startStub([
66
+ { method: 'GET', path: /\/projects\/?$/, name: 'terminal-list', handle: () => ({ projects: options.terminalProjects || [] }) },
67
+ { method: 'POST', path: /\/claude-workbench\/v1\/projects\/?$/, name: 'terminal-register', handle: () => ({ id: 't1' }) },
68
+ { method: 'POST', path: /internal\/maintenance-config$/, name: 'terminal-maintenance', status: 500, handle: () => ({}) },
69
+ { method: 'POST', path: /internal\/embedding-config$/, name: 'terminal-embedding', status: 500, handle: () => ({}) },
70
+ ]);
71
+ const vectorHub = await startStub([
72
+ { method: 'GET', path: /^\/api\/projects\/?$/, name: 'vector-list', hang: !!options.vectorHubHung, handle: () => ({ projects: [] }) },
73
+ { method: 'GET', path: /^\/api\/health\/?$/, name: 'vector-health', hang: !!options.vectorHubHung, handle: () => ({ ok: true }) },
74
+ { method: 'POST', path: /^\/api\/import$/, name: 'vector-import', handle: () => ({ ok: true }) },
75
+ { method: 'POST', path: /^\/api\/internal\/runtime-config$/, name: 'vector-runtime-config', handle: () => ({ rootPath: null }) },
76
+ ]);
77
+ const eventBridge = await startStub([
78
+ { method: 'GET', path: /^\/api\/projects\/?$/, name: 'bridge-list', handle: () => ({ projects: [] }) },
79
+ { method: 'POST', path: /^\/api\/projects\/?$/, name: 'bridge-register', handle: () => ({ project: { id: 'eb1' } }) },
80
+ { method: 'GET', path: /^\/api\/journal\/high-watermark$/, name: 'bridge-watermark', handle: () => ({ sequence: 0 }) },
81
+ ]);
82
+ const registered = [...(options.engineProjects || [])];
83
+ const engine = await startStub([
84
+ { method: 'GET', path: /^\/api\/health\/?$/, name: 'engine-health', handle: () => ({ name: 'knowledge-engine', dataSchemaVersion: 3 }) },
85
+ { method: 'ANY', path: /^\/api\/runtime-auth\/?$/, name: 'engine-auth', handle: () => ({ ok: true }) },
86
+ { method: 'GET', path: /^\/api\/projects\/?$/, name: 'engine-list', handle: () => ({ projects: registered }) },
87
+ { method: 'POST', path: /^\/api\/projects\/?$/, name: 'engine-register', countWith: body => { try { return 'engine-register:' + JSON.parse(body).projectId; } catch { return null; } }, handle: (cleanPath, body) => { try { const parsed = JSON.parse(body); if (failProjects.includes(parsed.projectId)) return { __status: 500, ok: false, failed: parsed.projectId }; registered.push({ projectId: parsed.projectId, repoPath: parsed.repoPath, knowledgePath: parsed.knowledgePath }); } catch {} return { ok: true }; } },
88
+ { method: 'GET', path: /^\/api\/snapshot\/?$/, name: 'engine-snapshot', handle: () => ({ sharedScopes: [] }) },
89
+ { method: 'POST', path: /^\/api\/scopes\/?$/, name: 'engine-scopes', handle: () => ({ ok: true }) },
90
+ { method: 'POST', path: /^\/api\/runtime-config\/?$/, name: 'engine-runtime-config', handle: () => ({ ok: true }) },
91
+ { method: 'POST', path: /^\/api\/control\/?$/, name: 'engine-control', handle: () => ({ ok: true }) },
92
+ ]);
93
+ const projectIds = options.projectIds || [];
94
+ const configs = new Map(projectIds.map(id => [id, { displayName: id, repoPath: 'D:/qa/' + id, knowledgePath: 'D:/qa/knowledge/' + id, brainId: 'brain-default', domainId: null }]));
95
+ const states = new Map(projectIds.map(id => [id, {}]));
96
+ const registryStore = { listIds: () => [...projectIds], readDisplaySnapshot: id => projectIds.includes(id) ? { displayName: id } : null };
97
+ const projectStore = { readConfig: id => configs.get(id), readState: id => states.get(id) || {}, updateState: async (id, mutator) => { const state = states.get(id) || {}; mutator(state); states.set(id, state); } };
98
+ const settings = { brain: { id: 'brain-default', name: 'QA-Brain', domains: [] }, knowledge: { rootPath: path.join(TEMP_DATA, 'qa-knowledge-root') } };
99
+ const settingsStore = { read: () => settings, bindSharedKnowledgePaths: async () => {} };
100
+ const bridge = new BridgeClass({
101
+ terminalUrl: terminal.url, vectorHubUrl: vectorHub.url, eventBridgeUrl: eventBridge.url, engineUrl: engine.url,
102
+ registryStore, projectStore, settingsStore, dataDir: path.join(TEMP_DATA, 'qa-data-dir'),
103
+ logger: { info() {}, warn() {}, error() {} },
104
+ });
105
+ const makeRuntime = () => ({ analysisOwner: 'engine', moduleBridge: bridge, registryStore, projectStore, logger: { info() {}, warn() {}, error() {} }, ownership: { owner: 'engine', ready: false } });
106
+ return { bridge, connect, makeRuntime, stubs: { terminal, vectorHub, eventBridge, engine } };
107
+ }
108
+
109
+ async function sectionA() {
110
+ const makeElement = () => {
111
+ const el = { textContent: '', innerHTML: '', hidden: false, disabled: false, value: '', className: '', open: false, dataset: {}, childElementCount: 0, firstElementChild: null };
112
+ el.classList = { toggle() {}, add() {}, remove() {}, contains() { return false; } };
113
+ el.addEventListener = () => {}; el.removeEventListener = () => {}; el.append = () => {}; el.replaceChildren = () => {};
114
+ el.reset = () => {}; el.focus = () => {}; el.select = () => {}; el.close = () => {}; el.showModal = () => {}; el.scrollIntoView = () => {};
115
+ el.dispatchEvent = () => true; el.parentElement = el; el.contentWindow = null;
116
+ el.elements = { confirmGitInit: { checked: false }, confirmReplaceHook: { checked: false } };
117
+ return el;
118
+ };
119
+ const jsonOk = payload => Promise.resolve({ ok: true, status: 200, json: async () => payload, headers: { get: () => null } });
120
+ const brainPayload = { ok: true, brain: { id: 'brain-default', name: 'QA-Brain', domains: [] }, knowledgeRoot: 'D:/qa/root', indexStoragePath: 'D:/qa/idx' };
121
+ const healthPayload = { ok: true, modules: { terminal: { up: true }, vectorHub: { up: true }, eventBridge: { up: true }, engine: { up: true } } };
122
+ const projectsPayload = { ok: true, projects: [{ projectId: 'p1', name: 'P1', workspacePath: 'D:/qa/p1', knowledgePath: 'D:/qa/knowledge/p1', brainId: 'brain-default', domainId: null, modules: { terminal: { registered: true }, vectorHub: { registered: true }, eventBridge: { registered: true }, engine: { registered: true } } }] };
123
+ const runScenario = async (source, fetchImpl) => {
124
+ const elements = new Map();
125
+ const timers = new Set();
126
+ const get = id => { if (!elements.has(id)) elements.set(id, makeElement()); return elements.get(id); };
127
+ const document = { getElementById: get, querySelectorAll: () => [], createElement: makeElement, addEventListener: () => {}, body: makeElement(), documentElement: { dataset: {} }, hidden: false };
128
+ class EventSourceStub { constructor() { this.readyState = 0; } addEventListener() {} close() {} }
129
+ const sandbox = {
130
+ document, navigator: { onLine: true }, location: { origin: 'http://vm.local', hash: '' }, history: { replaceState() {} },
131
+ addEventListener() {}, removeEventListener() {}, dispatchEvent() {},
132
+ localStorage: { getItem: () => null, setItem() {} }, EventSource: EventSourceStub, fetch: fetchImpl, AbortController,
133
+ URLSearchParams, URL, crypto: require('node:crypto').webcrypto,
134
+ setTimeout: (fn, ms, ...rest) => { const timer = setTimeout(fn, ms, ...rest); timers.add(timer); return timer; },
135
+ clearTimeout: timer => { timers.delete(timer); clearTimeout(timer); },
136
+ setInterval: () => 0, clearInterval: () => {},
137
+ };
138
+ sandbox.window = sandbox; sandbox.globalThis = sandbox;
139
+ vm.runInNewContext(source, sandbox, { filename: 'product.js' });
140
+ await sleep(2500);
141
+ for (const timer of timers) clearTimeout(timer);
142
+ return id => (elements.has(id) ? elements.get(id).textContent : undefined);
143
+ };
144
+ const hungFetch = url => {
145
+ const target = String(url);
146
+ if (target.includes('/api/projects/aggregated') || target.includes('/api/projects/projection')) return new Promise(() => {});
147
+ if (target.includes('/api/modules/health')) return jsonOk(healthPayload);
148
+ if (target.includes('/api/brain')) return jsonOk(brainPayload);
149
+ if (target.includes('/api/engine/snapshot')) return jsonOk({ projects: [], runs: [], events: [], memories: [] });
150
+ return jsonOk({ ok: true });
151
+ };
152
+ const fastFetch = url => {
153
+ const target = String(url);
154
+ if (target.includes('/api/projects/aggregated') || target.includes('/api/projects/projection')) return jsonOk(projectsPayload);
155
+ if (target.includes('/api/modules/health')) return jsonOk(healthPayload);
156
+ if (target.includes('/api/brain')) return jsonOk(brainPayload);
157
+ if (target.includes('/api/engine/snapshot')) return jsonOk({ projects: [], runs: [], events: [], memories: [] });
158
+ return jsonOk({ ok: true });
159
+ };
160
+ const currentSource = fs.readFileSync(path.join(ROOT, 'ui', 'product.js'), 'utf8');
161
+ const readCurrent = await runScenario(currentSource, hungFetch);
162
+ console.log(' current systemTitle after 2.5s with a hanging projects read: ' + JSON.stringify(readCurrent('systemTitle')));
163
+ await gate('A', 'A2 current: health region renders while the projects read hangs', async () => {
164
+ const value = readCurrent('systemTitle');
165
+ assert.ok(value !== undefined && value !== '' && value !== '正在检查系统', 'post-fix frontend still gates the health region behind the hanging projects read');
166
+ });
167
+ const readControl = await runScenario(currentSource, fastFetch);
168
+ await gate('A', 'A3 control: current frontend renders system status when all reads are fast', async () => {
169
+ assert.strictEqual(readControl('systemTitle'), '系统连接正常', 'control scenario failed to render the health region');
170
+ });
171
+ }
172
+
173
+ async function sectionB() {
174
+ const hungOptions = {
175
+ vectorHubHung: true,
176
+ projectIds: ['p1'],
177
+ terminalProjects: [{ id: 't0', rootPath: 'D:/qa/p1' }],
178
+ engineProjects: [{ projectId: 'p1', repoPath: 'D:/qa/p1', knowledgePath: 'D:/qa/knowledge/p1' }],
179
+ };
180
+ const current = await makeEnv(hungOptions);
181
+ const currentStarted = Date.now();
182
+ const aggregated = await current.bridge.aggregatedProjects();
183
+ const currentMs = Date.now() - currentStarted;
184
+ console.log(' current aggregatedProjects() with one hung module: ' + currentMs + 'ms');
185
+ await gate('B', 'B2 current: aggregated read within 3.5s despite one hung module', async () => {
186
+ assert.ok(currentMs <= 3500, 'aggregatedProjects() took ' + currentMs + 'ms with one hung module; plan requires a 3s-class budget');
187
+ });
188
+ await gate('B', 'B3 current: aggregated read keeps the registry spine (no false "no projects")', async () => {
189
+ assert.strictEqual(aggregated.projects.length, 1, 'aggregated projection must keep the registry spine even when a module is unreachable');
190
+ });
191
+ const healthStarted = Date.now();
192
+ await current.bridge.modulesHealth();
193
+ const healthMs = Date.now() - healthStarted;
194
+ console.log(' current modulesHealth() with one hung module: ' + healthMs + 'ms');
195
+ await gate('B', 'B4 current: modulesHealth within 2.5s (parallel probes)', async () => {
196
+ assert.ok(healthMs <= 2500, 'modulesHealth() took ' + healthMs + 'ms');
197
+ });
198
+ }
199
+
200
+ async function sectionC() {
201
+ const current = await makeEnv({ projectIds: ['proj-bad', 'proj-good'], engineFailProjects: ['proj-bad'] });
202
+ const currentRuntime = current.makeRuntime();
203
+ await current.connect(currentRuntime);
204
+ console.log(' current engine counters with one failing project: ' + JSON.stringify(current.stubs.engine.counters));
205
+ console.log(' current ownership: ' + JSON.stringify(currentRuntime.ownership));
206
+ await gate('C', 'C4 current: healthy project is wired when another project fails', async () => {
207
+ assert.ok((current.stubs.engine.counters['engine-register:proj-good'] || 0) >= 1, 'proj-good still not wired when proj-bad fails');
208
+ });
209
+ await gate('C', 'C5 current: ownership not globally pending because of one project', async () => {
210
+ assert.ok(currentRuntime.ownership.ready, 'ownership still not-ready globally');
211
+ });
212
+ await gate('C', 'C6 current: engine activation happens with one failing project', async () => {
213
+ assert.ok((current.stubs.engine.counters['engine-control'] || 0) >= 1, 'engine POST /api/control still gated behind all-project wiring');
214
+ });
215
+ }
216
+
217
+ async function sectionC4() {
218
+ const current = await makeEnv({ projectIds: ['p-a', 'p-b'] });
219
+ const currentRuntime = current.makeRuntime();
220
+ await current.connect(currentRuntime);
221
+ await current.connect(currentRuntime);
222
+ console.log(' current counters after two takeover passes: ' + JSON.stringify(current.stubs.engine.counters));
223
+ await gate('C', 'C9 current: healthy projects are not re-registered on a repeat takeover pass', async () => {
224
+ assert.strictEqual(current.stubs.engine.counters['engine-register:p-a'] || 0, 1, 'healthy project re-registered on a repeat pass');
225
+ });
226
+ await gate('C', 'C10 current: unchanged configuration is not re-pushed on a repeat takeover pass', async () => {
227
+ assert.strictEqual(current.stubs.engine.counters['engine-scopes'] || 0, 1, 'unchanged scopes re-pushed on a repeat pass');
228
+ });
229
+ }
230
+
231
+ async function sectionD() {
232
+ const current = await makeEnv({ projectIds: ['p1'] });
233
+ await Promise.all([current.bridge.syncEngineConfiguration(), current.bridge.syncEngineConfiguration(), current.bridge.syncEngineConfiguration()]);
234
+ console.log(' current engine counters after 3 concurrent syncs: ' + JSON.stringify(current.stubs.engine.counters));
235
+ await gate('D', 'D3 current: concurrent duplicate config syncs are merged into one push', async () => {
236
+ assert.strictEqual(current.stubs.engine.counters['engine-scopes'] || 0, 1, 'concurrent syncs were not merged');
237
+ });
238
+ await current.bridge.syncEngineConfiguration();
239
+ console.log(' current engine counters after a fourth unchanged sync: ' + JSON.stringify(current.stubs.engine.counters));
240
+ await gate('D', 'D4 current: unchanged configuration is not re-pushed on the next sync', async () => {
241
+ assert.strictEqual(current.stubs.engine.counters['engine-scopes'] || 0, 1, 'unchanged settings re-pushed');
242
+ });
243
+ }
244
+
245
+ async function sectionE() {
246
+ let upstreamOpen = 0;
247
+ const upstream = http.createServer((req, res) => {
248
+ if (!req.url.includes('/api/events/stream')) { res.writeHead(404); res.end(); return; }
249
+ upstreamOpen++;
250
+ res.writeHead(200, { 'Content-Type': 'text/event-stream', 'Cache-Control': 'no-cache' });
251
+ res.write('event: snapshot\ndata: {"n":1}\n\n');
252
+ const keepAlive = setInterval(() => { try { res.write('event: tick\ndata: {}\n\n'); } catch {} }, 200);
253
+ req.on('close', () => { upstreamOpen--; clearInterval(keepAlive); });
254
+ });
255
+ allServers.push(upstream);
256
+ await new Promise(resolve => upstream.listen(0, '127.0.0.1', resolve));
257
+ const upstreamUrl = 'http://127.0.0.1:' + upstream.address().port;
258
+ const env = await makeEnv({ projectIds: [] });
259
+ const shell = http.createServer((req, res) => { env.bridge.proxy(req, res, upstreamUrl + '/api/events/stream').catch(() => {}); });
260
+ allServers.push(shell);
261
+ await new Promise(resolve => shell.listen(0, '127.0.0.1', resolve));
262
+ const shellUrl = 'http://127.0.0.1:' + shell.address().port;
263
+ const clients = [];
264
+ try {
265
+ for (let i = 0; i < 8; i++) {
266
+ const controller = new AbortController();
267
+ const got = { firstMs: null, startedAt: Date.now() };
268
+ clients.push({ controller, got });
269
+ fetch(shellUrl + '/stream', { signal: controller.signal, headers: { Accept: 'text/event-stream' } })
270
+ .then(response => {
271
+ got.firstMs = Date.now() - got.startedAt;
272
+ const reader = response.body.getReader();
273
+ const pump = () => reader.read().then(({ done }) => { if (!done) pump(); }).catch(() => {});
274
+ pump();
275
+ })
276
+ .catch(() => {});
277
+ }
278
+ await sleep(1500);
279
+ await gate('E', 'E1 current: 8 concurrent SSE clients each get their first event within 3s', async () => {
280
+ assert.strictEqual(clients.filter(c => c.got.firstMs !== null).length, 8, 'not all 8 clients received a response within 1.5s');
281
+ assert.strictEqual(upstreamOpen, 8, 'expected 8 independent upstream connections, saw ' + upstreamOpen);
282
+ });
283
+ for (const client of clients.slice(0, 4)) client.controller.abort();
284
+ await sleep(1000);
285
+ console.log(' upstream connections after aborting 4 of 8 clients: ' + upstreamOpen);
286
+ await gate('E', 'E2 current: aborting 4 clients releases exactly their 4 upstream connections', async () => {
287
+ assert.strictEqual(upstreamOpen, 4, 'aborting clients did not release their upstream connections (leak/block): ' + upstreamOpen + ' still open');
288
+ });
289
+ } finally {
290
+ for (const client of clients) client.controller.abort();
291
+ }
292
+ }
293
+
294
+ async function main() {
295
+ await sectionA();
296
+ await sectionB();
297
+ await sectionC();
298
+ await sectionC4();
299
+ await sectionD();
300
+ await sectionE();
301
+ const failed = gates.filter(g => !g.ok);
302
+ console.log('');
303
+ console.log('glm-ui-refresh-review-test summary: ' + (gates.length - failed.length) + '/' + gates.length + ' gates passed');
304
+ if (failed.length) {
305
+ console.log('failed gates (current regressions):');
306
+ for (const g of failed) console.log(' [' + g.section + '] ' + g.name + ' :: ' + g.message);
307
+ }
308
+ process.exitCode = failed.length ? 1 : 0;
309
+ }
310
+
311
+ main().catch(error => { console.error(error); process.exitCode = 1; }).finally(() => {
312
+ for (const server of allServers) { server.close(); server.closeAllConnections?.(); }
313
+ });