@sleep2agi/commhub-server 0.9.0-preview.21 → 0.9.0-preview.211

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 (397) hide show
  1. package/README.md +130 -10
  2. package/bin/commhub.ts +99 -11
  3. package/package.json +7 -7
  4. package/src/ack-create-request-transport.test.ts +182 -0
  5. package/src/ack-create-request.test.ts +50 -7
  6. package/src/admin-delete-network-http.test.ts +228 -0
  7. package/src/admin-networks-http.test.ts +88 -0
  8. package/src/adoption-candidates-http.test.ts +137 -0
  9. package/src/adoption-candidates.ts +158 -0
  10. package/src/agent-access-batch.test.ts +210 -0
  11. package/src/agent-access.ts +487 -0
  12. package/src/agent-acl-groups-http.test.ts +247 -0
  13. package/src/agent-acl-http.test.ts +659 -0
  14. package/src/agent-acl-slice3-http.test.ts +267 -0
  15. package/src/agent-department-http.test.ts +215 -0
  16. package/src/agent-groups-perf.test.ts +223 -0
  17. package/src/agent-notice.ts +48 -0
  18. package/src/agent-team-whoami-http.test.ts +98 -0
  19. package/src/agent-teams-http.test.ts +330 -0
  20. package/src/agent-teams.ts +244 -0
  21. package/src/alias-baseline-2571.test.ts +162 -0
  22. package/src/alias-baseline.ts +113 -0
  23. package/src/alias-filter.test.ts +72 -0
  24. package/src/alias-filter.ts +42 -0
  25. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  26. package/src/api-host-supervisors-fallback.test.ts +21 -12
  27. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  28. package/src/api-nodes-shape.test.ts +120 -13
  29. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  30. package/src/auth-sessions-http.test.ts +250 -0
  31. package/src/auth-validate.test.ts +5 -1
  32. package/src/auth-weak-password-login.test.ts +176 -0
  33. package/src/auth.ts +609 -51
  34. package/src/avatar-validate.test.ts +163 -0
  35. package/src/avatar-validate.ts +103 -0
  36. package/src/backfill-node-ids-2664.test.ts +128 -0
  37. package/src/binding-generation-http.test.ts +121 -0
  38. package/src/blocked-exit-on-reply.test.ts +122 -0
  39. package/src/boot-side-effect.test.ts +124 -0
  40. package/src/broadcast-fanout-2721.test.ts +118 -0
  41. package/src/broadcast-fanout.ts +98 -0
  42. package/src/chain-attempt-dedup.test.ts +447 -0
  43. package/src/clone-node.test.ts +248 -0
  44. package/src/clone-node.ts +289 -0
  45. package/src/codex-config-flags.ts +77 -0
  46. package/src/codex-fork-contract.ts +23 -0
  47. package/src/codex-fork-migration.test.ts +38 -0
  48. package/src/commhub-bin-args.test.ts +85 -0
  49. package/src/config-apply-validate.test.ts +42 -1
  50. package/src/config-apply-validate.ts +30 -2
  51. package/src/create-node-blocked-gate.test.ts +356 -0
  52. package/src/create-node-network-id.test.ts +79 -0
  53. package/src/create-node-tool-schema.test.ts +49 -0
  54. package/src/create-node-unicode-name.test.ts +120 -0
  55. package/src/create-node-validate.test.ts +199 -7
  56. package/src/create-node-validate.ts +232 -15
  57. package/src/create-node-workdir.test.ts +289 -0
  58. package/src/create-node.ts +88 -23
  59. package/src/daemon-provider-snapshots.test.ts +421 -0
  60. package/src/daemon-provider-snapshots.ts +327 -0
  61. package/src/daemon-token-owner-http.test.ts +236 -0
  62. package/src/dashboard-slash-routing-http.test.ts +109 -0
  63. package/src/db-adapter-guard.test.ts +148 -0
  64. package/src/db-adapter-translate.test.ts +128 -0
  65. package/src/db-adapter.ts +377 -91
  66. package/src/db-timestamp.test.ts +38 -0
  67. package/src/db-timestamp.ts +15 -0
  68. package/src/db.ts +1306 -153
  69. package/src/delivered-without-push.test.ts +140 -0
  70. package/src/department-groups-http.test.ts +209 -0
  71. package/src/department-groups-sync-http.test.ts +328 -0
  72. package/src/department-groups.ts +434 -0
  73. package/src/department-heads-http.test.ts +330 -0
  74. package/src/department-heads.ts +226 -0
  75. package/src/departments-agent-count.test.ts +129 -0
  76. package/src/departments-http.test.ts +185 -0
  77. package/src/departments-mcp.test.ts +128 -0
  78. package/src/departments.ts +318 -0
  79. package/src/desktop-message-seam.test.ts +150 -0
  80. package/src/desktop-message.test.ts +368 -0
  81. package/src/dm-file-scope-http.test.ts +178 -0
  82. package/src/empty-node-sweeper.test.ts +104 -0
  83. package/src/empty-node-sweeper.ts +88 -0
  84. package/src/env-transport-gate-http.test.ts +240 -0
  85. package/src/env-transport-gate.ts +80 -0
  86. package/src/env-transport-policy.ts +56 -0
  87. package/src/event-loop-lag.test.ts +180 -0
  88. package/src/event-loop-lag.ts +181 -0
  89. package/src/ext-token-shared.test.ts +60 -0
  90. package/src/ext-validation-regression.test.ts +131 -0
  91. package/src/external-schedule-edits-http.test.ts +321 -0
  92. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  93. package/src/external-schedule-edits.ts +327 -0
  94. package/src/file-download-authz-dev-open.test.ts +135 -0
  95. package/src/file-download-authz.test.ts +404 -0
  96. package/src/file-download-date-bucket.test.ts +436 -0
  97. package/src/file-network-scope-dev-open.test.ts +97 -0
  98. package/src/file-network-scope.test.ts +732 -0
  99. package/src/group-membership-events-http.test.ts +264 -0
  100. package/src/group-messages-http.test.ts +482 -0
  101. package/src/group-messages.ts +297 -0
  102. package/src/health-host-disk-2756.test.ts +49 -0
  103. package/src/health-redaction.test.ts +685 -0
  104. package/src/host-supervisor-identity-http.test.ts +152 -0
  105. package/src/host-supervisor-identity.ts +92 -0
  106. package/src/host-supervisors-daemon-version.test.ts +137 -0
  107. package/src/http-gzip.test.ts +94 -0
  108. package/src/http-gzip.ts +112 -0
  109. package/src/hub-catalog-read-http.test.ts +187 -0
  110. package/src/hub-provider-config.test.ts +139 -0
  111. package/src/hub-provider-config.ts +105 -0
  112. package/src/hub-timestamp.test.ts +38 -0
  113. package/src/hub-timestamp.ts +27 -0
  114. package/src/human-dm.ts +215 -0
  115. package/src/human-inbox.ts +42 -0
  116. package/src/inbox-caller.ts +49 -0
  117. package/src/inbox-count-sse.test.ts +310 -0
  118. package/src/inbox-count.ts +29 -0
  119. package/src/index.ts +15 -2385
  120. package/src/list-host-supervisors.test.ts +5 -4
  121. package/src/mcp-context-cost-http.test.ts +127 -0
  122. package/src/mcp-inflight.test.ts +92 -0
  123. package/src/mcp-inflight.ts +38 -0
  124. package/src/mcp-projects-events-http.test.ts +162 -0
  125. package/src/mcp-route-label-http.test.ts +120 -0
  126. package/src/mcp-write-network-resolution.test.ts +432 -0
  127. package/src/member-audit-network-id-http.test.ts +93 -0
  128. package/src/member-presence-http.test.ts +210 -0
  129. package/src/messages-ack-by-agent-http.test.ts +142 -0
  130. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  131. package/src/migrate-sqlite-to-pg.ts +263 -0
  132. package/src/model-auth-notify-http.test.ts +181 -0
  133. package/src/model-auth-notify.ts +116 -0
  134. package/src/network-name-http.test.ts +75 -0
  135. package/src/network-rules-http.test.ts +169 -0
  136. package/src/network-rules.ts +129 -0
  137. package/src/network-scope.ts +276 -0
  138. package/src/network-token-membership-http.test.ts +139 -0
  139. package/src/node-alias-control.ts +12 -0
  140. package/src/node-attrs-validate.ts +88 -0
  141. package/src/node-attrs.test.ts +258 -0
  142. package/src/node-caller-identity-http.test.ts +1083 -0
  143. package/src/node-create-request-status-http.test.ts +105 -0
  144. package/src/node-daemon-bindings.test.ts +132 -0
  145. package/src/node-daemon-bindings.ts +135 -0
  146. package/src/node-failure-alert.test.ts +150 -0
  147. package/src/node-failure-alert.ts +177 -0
  148. package/src/node-files-transport.test.ts +344 -0
  149. package/src/node-health-codex-login.test.ts +120 -0
  150. package/src/node-health-dispatch-http.test.ts +279 -0
  151. package/src/node-health-guard.ts +105 -0
  152. package/src/node-health-passthrough.test.ts +115 -0
  153. package/src/node-health-store.ts +101 -0
  154. package/src/node-id-alias.test.ts +190 -0
  155. package/src/node-identity-conflict-http.test.ts +269 -0
  156. package/src/node-identity-conflict.ts +142 -0
  157. package/src/node-identity-mismatch.test.ts +74 -0
  158. package/src/node-in-flight-tasks.ts +31 -0
  159. package/src/node-lifecycle-controllable.test.ts +64 -0
  160. package/src/node-lifecycle-controllable.ts +53 -0
  161. package/src/node-lifecycle-read-http.test.ts +250 -0
  162. package/src/node-lifecycle-read.ts +124 -0
  163. package/src/node-logs-transport.test.ts +263 -0
  164. package/src/node-peer-allowlist.test.ts +114 -0
  165. package/src/node-permissions-http.test.ts +648 -0
  166. package/src/node-permissions.ts +494 -0
  167. package/src/node-request-retention.test.ts +281 -0
  168. package/src/node-request-retention.ts +120 -0
  169. package/src/node-secret-rest-http.test.ts +190 -0
  170. package/src/node-serviceability.test.ts +86 -0
  171. package/src/node-serviceability.ts +124 -0
  172. package/src/node-session-control-http.test.ts +310 -0
  173. package/src/node-session-control.ts +258 -0
  174. package/src/node-skills-transport.test.ts +209 -0
  175. package/src/node-token-identity.ts +35 -0
  176. package/src/node-token-ownership.ts +51 -0
  177. package/src/node-token-privilege-http.test.ts +158 -0
  178. package/src/not-found-api-http.test.ts +67 -0
  179. package/src/observer-avatar-http.test.ts +442 -0
  180. package/src/observer-push.test.ts +252 -0
  181. package/src/opencode-catalog-report-http.test.ts +139 -0
  182. package/src/opencode-v2-catalog.test.ts +268 -0
  183. package/src/opencode-v2-catalog.ts +352 -0
  184. package/src/package-version-consistency.test.ts +25 -0
  185. package/src/parent-source-marker.test.ts +50 -0
  186. package/src/password-network-tokens.ts +25 -0
  187. package/src/peer-reply-atomic.test.ts +455 -0
  188. package/src/peer-reply-capability.test.ts +70 -0
  189. package/src/pg-worker.ts +87 -0
  190. package/src/project-dir-warn-clear-http.test.ts +132 -0
  191. package/src/project-viewer-can-http.test.ts +116 -0
  192. package/src/push.test.ts +20 -10
  193. package/src/push.ts +466 -13
  194. package/src/redact-tokens.test.ts +65 -0
  195. package/src/redact-tokens.ts +40 -0
  196. package/src/rename.ts +38 -10
  197. package/src/reply-target-derivation.test.ts +96 -0
  198. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  199. package/src/report-status-host-schema.test.ts +235 -0
  200. package/src/report-status-resume-id-handover.test.ts +184 -0
  201. package/src/report-status-secret-keys.test.ts +140 -0
  202. package/src/require-explicit-test-db.ts +9 -0
  203. package/src/requirement-due-reminders-http.test.ts +620 -0
  204. package/src/requirement-due-reminders.ts +416 -0
  205. package/src/requirement-events-http.test.ts +268 -0
  206. package/src/requirement-events.test.ts +45 -0
  207. package/src/requirement-events.ts +144 -0
  208. package/src/requirement-notify.ts +165 -0
  209. package/src/requirement-participant-notify-http.test.ts +309 -0
  210. package/src/requirement-tag-ops-http.test.ts +425 -0
  211. package/src/requirement-tag-tree-http.test.ts +275 -0
  212. package/src/requirement-tag-tree.ts +127 -0
  213. package/src/requirement-tags.ts +102 -0
  214. package/src/requirements-abandoned-http.test.ts +236 -0
  215. package/src/requirements-comment-http.test.ts +167 -0
  216. package/src/requirements-completed-at-migration.test.ts +70 -0
  217. package/src/requirements-errors-mcp-http.test.ts +164 -0
  218. package/src/requirements-errors.ts +158 -0
  219. package/src/requirements-etag-http.test.ts +91 -0
  220. package/src/requirements-http.test.ts +709 -0
  221. package/src/requirements-last-event-http.test.ts +349 -0
  222. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  223. package/src/requirements-list-slim-http.test.ts +324 -0
  224. package/src/requirements-mcp.test.ts +163 -0
  225. package/src/requirements-migrate.ts +283 -0
  226. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  227. package/src/requirements-people-http.test.ts +114 -0
  228. package/src/requirements-people-mcp-http.test.ts +231 -0
  229. package/src/requirements-people.ts +196 -0
  230. package/src/requirements-priority-lowest.test.ts +114 -0
  231. package/src/requirements-projects-parent-http.test.ts +123 -0
  232. package/src/requirements-search-http.test.ts +182 -0
  233. package/src/requirements-search.test.ts +32 -0
  234. package/src/requirements-search.ts +145 -0
  235. package/src/requirements-seq-http.test.ts +193 -0
  236. package/src/requirements-seq-migration.test.ts +63 -0
  237. package/src/requirements-start-date.test.ts +125 -0
  238. package/src/requirements-stats-http.test.ts +357 -0
  239. package/src/requirements-stats.ts +195 -0
  240. package/src/requirements-status-participants-http.test.ts +222 -0
  241. package/src/requirements-upgrade-e2e.test.ts +126 -0
  242. package/src/requirements-upgrade-migration.test.ts +98 -0
  243. package/src/requirements.ts +2027 -0
  244. package/src/resolve-port.test.ts +57 -0
  245. package/src/resolve-port.ts +44 -0
  246. package/src/response-charset.test.ts +130 -0
  247. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  248. package/src/rest-alias-network-fallback.test.ts +60 -0
  249. package/src/rest-alias-network-fallback.ts +65 -0
  250. package/src/rest-explicit-columns-http.test.ts +266 -0
  251. package/src/rest-identity.test.ts +130 -0
  252. package/src/rest-identity.ts +141 -0
  253. package/src/rest-projections.ts +72 -0
  254. package/src/rest-read-network-real-chain.test.ts +97 -0
  255. package/src/rest-write-network-resolution.test.ts +133 -0
  256. package/src/restart-readiness-http.test.ts +121 -0
  257. package/src/restricted-files.ts +76 -0
  258. package/src/retention-first-sweep-quiet.test.ts +31 -0
  259. package/src/retention.test.ts +100 -40
  260. package/src/retention.ts +423 -104
  261. package/src/route-callers-http.test.ts +120 -0
  262. package/src/route-timing.test.ts +218 -0
  263. package/src/route-timing.ts +262 -0
  264. package/src/rules-file-duplicate-alias.test.ts +234 -0
  265. package/src/rules-file-session-target.test.ts +207 -0
  266. package/src/rules-file-transport.test.ts +237 -0
  267. package/src/runtime-label.test.ts +22 -0
  268. package/src/runtime-label.ts +21 -0
  269. package/src/runtime-readiness.ts +90 -0
  270. package/src/schedule-agent-mcp-http.test.ts +432 -0
  271. package/src/schedule-agent.ts +252 -0
  272. package/src/schedule-starved.test.ts +92 -0
  273. package/src/schedule-starved.ts +114 -0
  274. package/src/scheduled-backoff-http.test.ts +193 -0
  275. package/src/scheduled-backoff.ts +64 -0
  276. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  277. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  278. package/src/scheduled-failure-code.test.ts +73 -0
  279. package/src/scheduled-failure-code.ts +105 -0
  280. package/src/scheduled-failures-http.test.ts +279 -0
  281. package/src/scheduled-failures.ts +425 -0
  282. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  283. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  284. package/src/scheduled-offline.test.ts +131 -0
  285. package/src/scheduled-offline.ts +66 -0
  286. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  287. package/src/scheduled-outcome-guidance.ts +9 -0
  288. package/src/scheduled-reply-unread-http.test.ts +212 -0
  289. package/src/scheduled-requirement-wake-http.test.ts +279 -0
  290. package/src/scheduled-requirement-wake.ts +125 -0
  291. package/src/scheduled-run-terminal.test.ts +268 -0
  292. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  293. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  294. package/src/scheduled-stuck-http.test.ts +312 -0
  295. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  296. package/src/scheduled-stuck.ts +219 -0
  297. package/src/scheduled-tasks-http.test.ts +679 -0
  298. package/src/scheduled-tasks.ts +959 -0
  299. package/src/scheduled-work-outcome-http.test.ts +154 -0
  300. package/src/scheduled-work-outcome.ts +50 -0
  301. package/src/scoped-secrets.ts +141 -0
  302. package/src/send-dedup-request-id.test.ts +229 -0
  303. package/src/send-reply-agent-warning.test.ts +202 -0
  304. package/src/send-reply-alias-optional.test.ts +131 -0
  305. package/src/send-reply-attachments.test.ts +458 -0
  306. package/src/send_dedup.test.ts +54 -0
  307. package/src/send_dedup.ts +52 -6
  308. package/src/serve-error.test.ts +38 -0
  309. package/src/serve-error.ts +27 -0
  310. package/src/server.ts +6220 -0
  311. package/src/session-task-on-dispatch.ts +14 -0
  312. package/src/session-token-ownership-http.test.ts +122 -0
  313. package/src/shared/codex-inventory.ts +41 -0
  314. package/src/shared/daemon-provider-login.ts +31 -0
  315. package/src/shared/daemon-provider-snapshot.ts +52 -0
  316. package/src/shared/external-schedule-contract.ts +60 -0
  317. package/src/shared/node-name.test.ts +62 -0
  318. package/src/shared/node-name.ts +161 -0
  319. package/src/shared/provider-application.ts +29 -0
  320. package/src/shared/provider-collection.ts +14 -0
  321. package/src/shared/provider-initialization.ts +8 -0
  322. package/src/shared/reserved-env-drift.test.ts +10 -0
  323. package/src/shared/scoped-secret-contract.ts +5 -0
  324. package/src/shared/task-content-limit-drift.test.ts +28 -0
  325. package/src/shared/task-content-limit.ts +25 -0
  326. package/src/side-thread-command-transport.test.ts +312 -0
  327. package/src/side-thread-command-transport.ts +318 -0
  328. package/src/side-thread-http-integration.test.ts +233 -0
  329. package/src/side-thread-http.ts +504 -0
  330. package/src/side-thread-production.test.ts +72 -0
  331. package/src/side-thread-production.ts +118 -0
  332. package/src/side-thread.test.ts +1067 -0
  333. package/src/side-thread.ts +2499 -0
  334. package/src/skillhub-http.test.ts +108 -0
  335. package/src/sqlite-close-checkpoint.test.ts +78 -0
  336. package/src/start-node.test.ts +264 -0
  337. package/src/status-alias-filter-http.test.ts +106 -0
  338. package/src/status-alias-resolver-http.test.ts +163 -0
  339. package/src/status-alias-resolver.ts +19 -0
  340. package/src/status-node-id-filter-http.test.ts +161 -0
  341. package/src/status-read-cache-http.test.ts +229 -0
  342. package/src/status-read-cache.ts +122 -0
  343. package/src/stop-delete-node.test.ts +567 -1
  344. package/src/task-access-http.test.ts +402 -0
  345. package/src/task-access.ts +420 -0
  346. package/src/task-activity.ts +60 -0
  347. package/src/task-auth-origin-http.test.ts +93 -0
  348. package/src/task-auth-origin.test.ts +24 -0
  349. package/src/task-auth-origin.ts +7 -0
  350. package/src/task-consumption.test.ts +490 -0
  351. package/src/task-diagnostic-http.test.ts +149 -0
  352. package/src/task-diagnostic.test.ts +115 -0
  353. package/src/task-diagnostic.ts +118 -0
  354. package/src/task-expiry-notice-http.test.ts +287 -0
  355. package/src/task-expiry-notice.ts +315 -0
  356. package/src/task-idempotency-mcp.test.ts +142 -0
  357. package/src/task-idempotency.test.ts +76 -0
  358. package/src/task-idempotency.ts +81 -0
  359. package/src/task-late-replies.ts +54 -0
  360. package/src/task-late-reply-http.test.ts +152 -0
  361. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  362. package/src/task-lifecycle-watcher.test.ts +204 -0
  363. package/src/task-lifecycle-watcher.ts +109 -0
  364. package/src/task-network-resolution-http.test.ts +140 -0
  365. package/src/task-offline-delivery-2668.test.ts +119 -0
  366. package/src/task-offline-delivery.ts +81 -0
  367. package/src/task-orphan-http.test.ts +287 -0
  368. package/src/task-orphan.ts +119 -0
  369. package/src/task-queue-ahead-http.test.ts +309 -0
  370. package/src/task-queue-ahead-scale.test.ts +236 -0
  371. package/src/task-queue-ahead.ts +186 -0
  372. package/src/task-rejection-log-http.test.ts +160 -0
  373. package/src/task-rejection-log.ts +49 -0
  374. package/src/task-sender-http.test.ts +143 -0
  375. package/src/task-stale-open-http.test.ts +290 -0
  376. package/src/task-stale-open.ts +103 -0
  377. package/src/tasks-pagination-http.test.ts +141 -0
  378. package/src/team-rules-status-http.test.ts +90 -0
  379. package/src/team-rules-status.test.ts +59 -0
  380. package/src/team-rules-status.ts +72 -0
  381. package/src/tool-audience-http.test.ts +230 -0
  382. package/src/tool-audience.ts +120 -0
  383. package/src/tools-list-json-schema.test.ts +94 -0
  384. package/src/tools.ts +4130 -391
  385. package/src/upload-early-reject-guard.test.ts +155 -0
  386. package/src/uploads-http.test.ts +97 -15
  387. package/src/uploads.ts +103 -6
  388. package/src/user-avatar-http.test.ts +74 -0
  389. package/src/user-avatar-image.ts +160 -0
  390. package/src/user-avatar-migration.test.ts +25 -0
  391. package/src/user-avatar-upload-http.test.ts +348 -0
  392. package/src/user-inbox-by-agent-http.test.ts +161 -0
  393. package/src/user-inbox-netid-notnull.test.ts +122 -0
  394. package/src/user-inbox-read-http.test.ts +223 -0
  395. package/src/user-inbox-schema.test.ts +54 -0
  396. package/src/version-stats.test.ts +66 -0
  397. package/src/version-stats.ts +109 -0
@@ -0,0 +1,181 @@
1
+ // #2614 —— 事件循环停顿监测(只观测,不改任何行为)。
2
+ //
3
+ // 背景:2026-10-26 21:55–22:12 生产 Hub 出现两次内存尖峰(RSS 3.6 → 4.5 GB),
4
+ // 伴随机 `mcp_inflight` 387 → 807。事后看日志才发现**同一时刻日志静默 14–47 秒**
5
+ // ——Hub 是单线程(Bun + 同步 SQLite),日志静默就等于事件循环被阻塞。
6
+ //
7
+ // 现有 `/api/stats/routes` 只能告诉我们“哪个请求**受害**了”(它的耗时包含了排队时间),
8
+ // 不能告诉我们“当时**谁**在阻塞”。缺的就是停顿本身的时间序列。
9
+ //
10
+ // 这个模块补上这一格:每 `intervalMs` 醒一次,量 `now - lastTick`;
11
+ // 正常情况 ≈ interval,超出 `thresholdMs` 的部分就是一次真实停顿。
12
+ // 停顿会:① 计数/留档(`/health` 的 `event_loop` 字段可读);
13
+ // ② 打一行日志(带当时的 RSS,方便和内存曲线对齐)。
14
+ //
15
+ // 注意:`setInterval` 自己也会被阻塞 —— 这正是我们要测量的东西。
16
+ // 停顿结束后第一次 tick 的 gap 就是停顿长度,不需要外部进程配合。
17
+
18
+ export type EventLoopStall = {
19
+ /** 这个间隔里处理完的请求数:0 = 真的没推进;>0 = 循环在干活,只是 timer 被饿住。 */
20
+ /** ISO 时间(停顿**结束**的时刻,即这次 tick 的时间)。 */
21
+ at: string;
22
+ /** 距上次 tick 的实际间隔(毫秒)。等于 interval + 停顿。 */
23
+ gap_ms: number;
24
+ /** 停顿量 = gap - interval。 */
25
+ stall_ms: number;
26
+ /** 停顿结束时的进程 RSS(MB),用于和内存尖峰对齐。 */
27
+ rss_mb: number;
28
+ requests_since_last_tick?: number;
29
+ };
30
+
31
+ const KEEP_STALLS = 20;
32
+
33
+ /**
34
+ * #2614(第二轮)—— 2026-10-27 00:39 线上出现 gap 84887ms,但**同一时段日志在正常写**
35
+ * (00:38:52 / 00:38:58 / 00:39:08 …),而且 `/api/stats/routes` 里最慢的请求只有 2.4s。
36
+ * 也就是说:事件循环**没有被阻塞 84 秒**,是 **timer 回调被 I/O 队列饿住**了。
37
+ * 只看 tick 间隔会把这两种情况混成一条“卡了 84 秒”的假结论。
38
+ *
39
+ * 区分办法:数一下这个间隔里**服务了多少请求**。
40
+ * requests_since_last_tick > 0 ⇒ 循环在干活 ⇒ 这是 timer 饥饿(高负载/大批回调)
41
+ * requests_since_last_tick = 0 ⇒ 真的没有推进任何请求 ⇒ 才可能是同步阻塞
42
+ */
43
+ let servedSinceTick = 0;
44
+
45
+ /** 请求处理完成时调用(route-timing 里)。只计数,不参与任何决策。 */
46
+ export function noteRequestServed(): void {
47
+ servedSinceTick++;
48
+ }
49
+
50
+ let maxGapMs = 0;
51
+ let lastGapMs = 0;
52
+ let stallCount = 0;
53
+ let lastStallAt: string | null = null;
54
+ let lastStallMs = 0;
55
+ const stalls: EventLoopStall[] = [];
56
+
57
+ /** 记录一次 tick 间隔。返回这次 tick 的停顿量(毫秒,可为负→归零)。 */
58
+ export function recordGap(
59
+ gapMs: number,
60
+ opts: { intervalMs?: number; thresholdMs?: number; rssMb?: number; now?: number; served?: number } = {},
61
+ ): number {
62
+ const interval = opts.intervalMs ?? 250;
63
+ const threshold = opts.thresholdMs ?? 2000;
64
+ lastGapMs = gapMs;
65
+ if (gapMs > maxGapMs) maxGapMs = gapMs;
66
+ const stallMs = Math.max(0, gapMs - interval);
67
+ if (stallMs < threshold) return stallMs;
68
+ const at = new Date(opts.now ?? Date.now()).toISOString();
69
+ stallCount++;
70
+ lastStallAt = at;
71
+ lastStallMs = stallMs;
72
+ stalls.push({
73
+ at,
74
+ gap_ms: Math.round(gapMs),
75
+ stall_ms: Math.round(stallMs),
76
+ rss_mb: opts.rssMb ?? 0,
77
+ requests_since_last_tick: opts.served ?? 0,
78
+ });
79
+ while (stalls.length > KEEP_STALLS) stalls.shift();
80
+ return stallMs;
81
+ }
82
+
83
+ export function eventLoopStats(): {
84
+ max_gap_ms: number;
85
+ last_gap_ms: number;
86
+ stall_count: number;
87
+ last_stall_ms: number;
88
+ last_stall_at: string | null;
89
+ recent_stalls: EventLoopStall[];
90
+ } {
91
+ return {
92
+ max_gap_ms: Math.round(maxGapMs),
93
+ last_gap_ms: Math.round(lastGapMs),
94
+ stall_count: stallCount,
95
+ last_stall_ms: Math.round(lastStallMs),
96
+ last_stall_at: lastStallAt,
97
+ recent_stalls: [...stalls].reverse(),
98
+ };
99
+ }
100
+
101
+ /** 只给测试用:清空累计状态。 */
102
+ export function resetEventLoopLagForTests(): void {
103
+ maxGapMs = 0;
104
+ lastGapMs = 0;
105
+ stallCount = 0;
106
+ lastStallAt = null;
107
+ lastStallMs = 0;
108
+ stalls.length = 0;
109
+ }
110
+
111
+ function envMs(name: string, fallback: number): number {
112
+ const raw = Number(process.env[name]);
113
+ return Number.isFinite(raw) && raw >= 0 ? raw : fallback;
114
+ }
115
+
116
+ /**
117
+ * 启动监测。返回 timer(调用方负责 clearInterval)。
118
+ * - `COMMHUB_STALL_LOG_MS`:停顿日志阈值,默认 2000 ms,设 0 关闭日志(仍计数);
119
+ * - `COMMHUB_STALL_TICK_MS`:采样间隔,默认 250 ms。
120
+ */
121
+ export function startEventLoopLagMonitor(opts: {
122
+ intervalMs?: number;
123
+ thresholdMs?: number;
124
+ log?: (msg: string) => void;
125
+ rssMb?: () => number;
126
+ /**
127
+ * #2721 —— 启动期的 tick gap 不算停顿。判据是**进程启动多久了**,不是第几个 tick。
128
+ *
129
+ * 事故形状:进程 22:21:06 启动,14:21:09.835Z 记到 gap 2972ms —— 启动后 3 秒。
130
+ * 那段 gap 度量的是「监控开始 → 第一次 tick」被模块加载/开库/迁移占满的时间。
131
+ *
132
+ * 两版错误实现(都试过,都被既有测试抓住):
133
+ * ① 10 秒**时间窗** → 监控在前 10 秒什么都不记,「阈值 40ms + spin 120ms 应打日志」直接吞掉
134
+ * ② 只跳**第一个 tick** → 测试里的 spin 恰好落在第一个 tick,同样吞掉
135
+ *
136
+ * 真正的区别不是「第几个 tick」,而是**这段时间里进程有没有可能还在启动**。
137
+ * 所以:只有当 tick 到来时进程 uptime 仍小于 bootGraceMs,才把 gap 当作启动尖峰。
138
+ * 启动 20 秒之后的第一条 gap 依旧照常记录 —— 那时候它不可能是启动耗时。
139
+ */
140
+ bootGraceMs?: number;
141
+ /** 测试注入:返回进程已运行的毫秒数(默认 process.uptime())。 */
142
+ uptimeMs?: () => number;
143
+ } = {}): ReturnType<typeof setInterval> {
144
+ const intervalMs = opts.intervalMs ?? Math.max(50, envMs("COMMHUB_STALL_TICK_MS", 250));
145
+ const thresholdMs = opts.thresholdMs ?? envMs("COMMHUB_STALL_LOG_MS", 2000);
146
+ const log = opts.log ?? ((m: string) => console.log(m));
147
+ const rssMb = opts.rssMb ?? (() => Math.round(process.memoryUsage().rss / 1048576));
148
+ let last = performance.now();
149
+ const startedAt = last;
150
+ // #2721 —— 启动预热不算停顿。
151
+ // 实测:2026-10-29 这次进程 22:21:06 起来,14:21:09.835Z 记到一次 gap 2972ms,
152
+ // 也就是**启动后 3 秒**。那段时间在做模块加载 / 打开 DB / 迁移,第一个 tick 必然偏大。
153
+ // 不排除它的后果是:每次部署都会在 `/health` 里留一条「停顿」,而它和线上真实卡顿长得一模一样。
154
+ const bootGraceMs = opts.bootGraceMs ?? envMs("COMMHUB_STALL_BOOT_GRACE_MS", 15_000);
155
+ const uptimeMs = opts.uptimeMs ?? (() => process.uptime() * 1000);
156
+ let firstTick = true;
157
+ const timer = setInterval(() => {
158
+ const now = performance.now();
159
+ const gap = now - last;
160
+ last = now;
161
+ const rss = rssMb();
162
+ const served = servedSinceTick;
163
+ servedSinceTick = 0;
164
+ // 启动尖峰:只可能是**第一个** tick,且到来时进程才刚起来。
165
+ // 两个条件缺一不可 —— 只看「第一个 tick」会吞掉运行中立刻发生的真实停顿。
166
+ if (firstTick) {
167
+ firstTick = false;
168
+ if (uptimeMs() < bootGraceMs) return;
169
+ }
170
+ const stall = recordGap(gap, { intervalMs, thresholdMs, rssMb: rss, served });
171
+ if (thresholdMs > 0 && stall >= thresholdMs) {
172
+ // 和 retention/slow-sql 的日志同一前缀,方便 grep。
173
+ // `served` 是判据的关键:它非零就说明循环在干活,这段“gap”是 timer 被饿住,不是阻塞。
174
+ log(`[commhub stall] loop idle ~${Math.round(stall)}ms (tick gap ${Math.round(gap)}ms, rss ${rss} MB, served ${served} req)`);
175
+ }
176
+ }, intervalMs);
177
+ // 监测不该拖住进程退出。
178
+ (timer as unknown as { unref?: () => void }).unref?.();
179
+ last = performance.now();
180
+ return timer;
181
+ }
@@ -0,0 +1,60 @@
1
+ import { describe, expect, test } from "bun:test";
2
+ import {
3
+ buildStoragePath,
4
+ pathForExistingBlob,
5
+ validateIndexEntry,
6
+ } from "./uploads.js";
7
+
8
+ const fileId = "0123456789abcdef0123456789abcdef";
9
+ const dateBucket = "2026-08-09";
10
+ const uploadsRoot = "/srv/uploads";
11
+
12
+ const malicious = [
13
+ "../x",
14
+ "/abs/x",
15
+ ".png/../../y",
16
+ ".p ng",
17
+ ".p\0ng",
18
+ ".\\..\\x",
19
+ "." + "a".repeat(17),
20
+ ".tar.gz",
21
+ ];
22
+
23
+ const legal = ["", ".png", ".PNG", ".mp4", "." + "a".repeat(16)];
24
+
25
+ describe("#527 shared extension-token invariant", () => {
26
+ test("new-upload path rejects every malformed token and accepts the shared legal set", () => {
27
+ for (const ext of malicious) {
28
+ expect(() => buildStoragePath(fileId, ext, { uploadsRoot })).toThrow(/ext .* is invalid/);
29
+ }
30
+ for (const ext of legal) {
31
+ expect(buildStoragePath(fileId, ext, { uploadsRoot }).ext).toBe(ext);
32
+ }
33
+ });
34
+
35
+ test("existing-blob path rejects every malformed token and accepts the shared legal set", () => {
36
+ for (const ext of malicious) {
37
+ expect(() => pathForExistingBlob(dateBucket, fileId, ext, { uploadsRoot })).toThrow(/ext .* is invalid/);
38
+ }
39
+ for (const ext of legal) {
40
+ expect(pathForExistingBlob(dateBucket, fileId, ext, { uploadsRoot }).ext).toBe(ext);
41
+ }
42
+ });
43
+
44
+ test("stored-index gate rejects every malformed token and accepts the shared legal set", () => {
45
+ for (const ext of malicious) {
46
+ expect(validateIndexEntry({ file_id: fileId, date_bucket: dateBucket, ext, size: 0 })).toBe(false);
47
+ }
48
+ for (const ext of legal) {
49
+ expect(validateIndexEntry({ file_id: fileId, date_bucket: dateBucket, ext, size: 0 })).toBe(true);
50
+ }
51
+ });
52
+
53
+ test("all three boundaries fail closed on non-string runtime values", () => {
54
+ for (const ext of [undefined, null, 7, {}, []]) {
55
+ expect(() => buildStoragePath(fileId, ext as never, { uploadsRoot })).toThrow(/ext .* is invalid/);
56
+ expect(() => pathForExistingBlob(dateBucket, fileId, ext as never, { uploadsRoot })).toThrow(/ext .* is invalid/);
57
+ expect(validateIndexEntry({ file_id: fileId, date_bucket: dateBucket, ext, size: 0 })).toBe(false);
58
+ }
59
+ });
60
+ });
@@ -0,0 +1,131 @@
1
+ // Task #25 — regression pins for ext validation in validateIndexEntry.
2
+ //
3
+ // 🔴 SCOPE: this suite exercises the stored-index boundary through
4
+ // `validateIndexEntry`. Issue #527 removed the three independent copies
5
+ // of the stored extension-token grammar: buildStoragePath,
6
+ // pathForExistingBlob and validateIndexEntry now use one shared private
7
+ // validator. `ext-token-shared.test.ts` separately pins all three call
8
+ // sites. sanitizeExt remains intentionally independent because it parses
9
+ // a client filename rather than validating an already-extracted token.
10
+ //
11
+ // Background (通信龙 d01bb8ce): the stored extension-token grammar
12
+ // `/^\.[A-Za-z0-9]{1,16}$/` correctly rejects 11 known malicious ext
13
+ // values (path-escape, traversal, absolute paths, doubles, NUL bytes,
14
+ // backslash forms, over-length, whitespace). Verified via real-run on
15
+ // origin/main by lead — 11/11 malicious values → false.
16
+ //
17
+ // But NO test locked that behavior. Anyone who widens the regex in the
18
+ // future (accidentally or on purpose) would not hit a red test — the
19
+ // live protection would degrade silently. This suite pins current
20
+ // behavior in two directions:
21
+ //
22
+ // 1. SAFETY (欠修 direction) — 11 malicious values → false, one row
23
+ // per value with the exact literal. If regex is widened to accept
24
+ // any of them, that row turns red.
25
+ // 2. NON-REGRESSION (过修 direction) — a set of common legitimate
26
+ // extensions → true. If regex is tightened to reject any of them
27
+ // (e.g. someone locks down to a whitelist), that row turns red.
28
+ //
29
+ // Witnessed-red for the SAFETY rows: temporarily widen the regex to
30
+ // `/./` (or comment it out) in validateIndexEntry, run this suite,
31
+ // confirm all 11 malicious rows turn red, then revert. The mutation
32
+ // itself is not committed; the assertion IS the mutation-red proof
33
+ // for the reader. Recording the mutation output in the followup PR
34
+ // body (per Constraint 3 discipline established in #503).
35
+ //
36
+ // Pure unit test — no server setup, no DB, no filesystem. The regex
37
+ // lives in a pure function, so the guard is testable at that level.
38
+
39
+ import { describe, expect, test } from "bun:test";
40
+ import { validateIndexEntry } from "./uploads.js";
41
+
42
+ // A structurally-valid base entry — file_id / date_bucket / size all
43
+ // pass their own checks — so `ext` is the only field a test row varies.
44
+ // This isolates the ext regex as the deciding factor.
45
+ const validBase = {
46
+ file_id: "0123456789abcdef0123456789abcdef",
47
+ date_bucket: "2026-07-30",
48
+ size: 0,
49
+ };
50
+
51
+ describe("Task #25 (#503 followup) — ext validation regression pins", () => {
52
+ describe("SAFETY: the 11 malicious ext values from lead d01bb8ce all return false", () => {
53
+ // Each row uses the exact literal from lead's verification list so
54
+ // a widening regex catches on the same value the manual audit did.
55
+ const malicious: Array<{ label: string; ext: string }> = [
56
+ { label: "path-escape prefix", ext: "../x" },
57
+ { label: "deep traversal to /etc", ext: "../../etc/passwd" },
58
+ { label: "absolute path", ext: "/abs/x" },
59
+ { label: "double-dot alone", ext: ".." },
60
+ { label: "single-dot alone", ext: "." },
61
+ { label: "chained after legit prefix", ext: ".png/../../y" },
62
+ { label: "embedded whitespace", ext: ".p ng" },
63
+ { label: "over-length (>16 chars)", ext: "." + "a".repeat(17) },
64
+ { label: "embedded NUL byte", ext: ".p\x00ng" },
65
+ { label: "backslash traversal", ext: ".\\..\\x" },
66
+ { label: "double-backslash prefix", ext: "..\\x" },
67
+ ];
68
+ for (const { label, ext } of malicious) {
69
+ test(`rejects: ${label} — ext=${JSON.stringify(ext)}`, () => {
70
+ expect(validateIndexEntry({ ...validBase, ext })).toBe(false);
71
+ });
72
+ }
73
+
74
+ test("precondition: 11 malicious cases enumerated (defends against silent test-shrink)", () => {
75
+ // If someone deletes rows from the malicious list, this fails
76
+ // instead of the deletion silently narrowing the guard. Number
77
+ // matches lead's verification list — bump only when lead adds a
78
+ // case and confirms it via real-run.
79
+ expect(malicious.length).toBe(11);
80
+ });
81
+ });
82
+
83
+ describe("NON-REGRESSION: common legitimate extensions all return true (防过修)", () => {
84
+ // These are the extensions the live upload path actually produces
85
+ // via sanitizeExt / mime-typed multipart uploads. If someone
86
+ // tightens the regex to a stricter whitelist, any of these turning
87
+ // red flags a break in a normal user path.
88
+ const legal = [".png", ".pdf", ".pptx", ".jpg", ".jpeg", ".txt", ".mp4", ".zip", ".json", ".md"];
89
+ for (const ext of legal) {
90
+ test(`accepts: ext=${JSON.stringify(ext)}`, () => {
91
+ expect(validateIndexEntry({ ...validBase, ext })).toBe(true);
92
+ });
93
+ }
94
+
95
+ test("empty ext is accepted (file with no extension is a legitimate upload)", () => {
96
+ expect(validateIndexEntry({ ...validBase, ext: "" })).toBe(true);
97
+ });
98
+
99
+ test("precondition: at least 10 legitimate ext values pinned", () => {
100
+ // Same discipline as the malicious side — reject silent shrink.
101
+ expect(legal.length).toBeGreaterThanOrEqual(10);
102
+ });
103
+ });
104
+
105
+ describe("regex shape assumptions (documented, not enforced by the function)", () => {
106
+ // These rows document facts the current regex enforces beyond the
107
+ // 11 malicious literals. They are close to the boundary and would
108
+ // be the first things to move if someone reworked the regex.
109
+ test("upper-case extensions accepted (regex is case-insensitive by [A-Za-z])", () => {
110
+ expect(validateIndexEntry({ ...validBase, ext: ".PNG" })).toBe(true);
111
+ });
112
+ test("mixed-case extensions accepted", () => {
113
+ expect(validateIndexEntry({ ...validBase, ext: ".PdF" })).toBe(true);
114
+ });
115
+ test("digits after dot accepted (e.g. .mp4, .mp3)", () => {
116
+ expect(validateIndexEntry({ ...validBase, ext: ".mp4" })).toBe(true);
117
+ });
118
+ test("exactly 16 chars after dot is accepted (upper bound of {1,16})", () => {
119
+ expect(validateIndexEntry({ ...validBase, ext: "." + "a".repeat(16) })).toBe(true);
120
+ });
121
+ test("exactly 17 chars after dot is rejected (immediately past upper bound)", () => {
122
+ expect(validateIndexEntry({ ...validBase, ext: "." + "a".repeat(17) })).toBe(false);
123
+ });
124
+ test("compound extensions like .tar.gz are rejected (contains inner dot)", () => {
125
+ // Documented: the current regex does not support compound
126
+ // extensions. If we ever want .tar.gz support, it needs its
127
+ // own explicit design + this row updated with lead sign-off.
128
+ expect(validateIndexEntry({ ...validBase, ext: ".tar.gz" })).toBe(false);
129
+ });
130
+ });
131
+ });