@sleep2agi/commhub-server 0.9.0-preview.25 → 0.9.0-preview.251

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 (417) hide show
  1. package/README.md +129 -9
  2. package/bin/commhub.ts +93 -9
  3. package/build-info.json +7 -0
  4. package/package.json +10 -8
  5. package/src/ack-create-request-transport.test.ts +182 -0
  6. package/src/ack-create-request.test.ts +52 -8
  7. package/src/admin-delete-network-http.test.ts +228 -0
  8. package/src/admin-networks-http.test.ts +88 -0
  9. package/src/adoption-candidates-http.test.ts +140 -0
  10. package/src/adoption-candidates.ts +158 -0
  11. package/src/agent-access-batch.test.ts +210 -0
  12. package/src/agent-access.ts +487 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +675 -0
  15. package/src/agent-acl-slice3-http.test.ts +717 -0
  16. package/src/agent-department-http.test.ts +215 -0
  17. package/src/agent-groups-perf.test.ts +223 -0
  18. package/src/agent-notice.ts +48 -0
  19. package/src/agent-team-whoami-http.test.ts +98 -0
  20. package/src/agent-teams-http.test.ts +330 -0
  21. package/src/agent-teams.ts +244 -0
  22. package/src/alias-baseline-2571.test.ts +162 -0
  23. package/src/alias-baseline.ts +113 -0
  24. package/src/alias-filter.test.ts +72 -0
  25. package/src/alias-filter.ts +42 -0
  26. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  27. package/src/api-host-supervisors-fallback.test.ts +6 -7
  28. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  29. package/src/api-nodes-shape.test.ts +95 -4
  30. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  31. package/src/auth-sessions-http.test.ts +260 -0
  32. package/src/auth-validate.test.ts +5 -1
  33. package/src/auth-weak-password-login.test.ts +176 -0
  34. package/src/auth.ts +609 -51
  35. package/src/avatar-validate.test.ts +52 -2
  36. package/src/avatar-validate.ts +35 -1
  37. package/src/backfill-node-ids-2664.test.ts +128 -0
  38. package/src/binding-generation-http.test.ts +132 -0
  39. package/src/blocked-exit-on-reply.test.ts +122 -0
  40. package/src/broadcast-fanout-2721.test.ts +149 -0
  41. package/src/broadcast-fanout.ts +117 -0
  42. package/src/build-info.test.ts +60 -0
  43. package/src/build-info.ts +85 -0
  44. package/src/chain-attempt-dedup.test.ts +447 -0
  45. package/src/clip.test.ts +36 -0
  46. package/src/clip.ts +48 -0
  47. package/src/clone-node.test.ts +262 -0
  48. package/src/clone-node.ts +289 -0
  49. package/src/codex-config-flags.ts +77 -0
  50. package/src/codex-fork-contract.ts +23 -0
  51. package/src/codex-fork-migration.test.ts +38 -0
  52. package/src/commhub-bin-args.test.ts +85 -0
  53. package/src/config-apply-validate.test.ts +188 -1
  54. package/src/config-apply-validate.ts +222 -3
  55. package/src/cors-origins.test.ts +73 -0
  56. package/src/create-node-blocked-gate.test.ts +356 -0
  57. package/src/create-node-network-id.test.ts +91 -0
  58. package/src/create-node-tool-schema.test.ts +49 -0
  59. package/src/create-node-unicode-name.test.ts +126 -0
  60. package/src/create-node-validate.test.ts +199 -7
  61. package/src/create-node-validate.ts +232 -15
  62. package/src/create-node-workdir.test.ts +298 -0
  63. package/src/create-node.ts +88 -23
  64. package/src/daemon-provider-snapshots.test.ts +445 -0
  65. package/src/daemon-provider-snapshots.ts +327 -0
  66. package/src/daemon-token-owner-http.test.ts +292 -0
  67. package/src/dashboard-slash-routing-http.test.ts +109 -0
  68. package/src/db-adapter-guard.test.ts +148 -0
  69. package/src/db-adapter-translate.test.ts +128 -0
  70. package/src/db-adapter.ts +377 -91
  71. package/src/db-timestamp.test.ts +38 -0
  72. package/src/db-timestamp.ts +15 -0
  73. package/src/db.ts +1264 -153
  74. package/src/delivered-without-push.test.ts +140 -0
  75. package/src/department-groups-http.test.ts +209 -0
  76. package/src/department-groups-sync-http.test.ts +328 -0
  77. package/src/department-groups.ts +434 -0
  78. package/src/department-heads-http.test.ts +350 -0
  79. package/src/department-heads.ts +226 -0
  80. package/src/departments-agent-count.test.ts +132 -0
  81. package/src/departments-http.test.ts +185 -0
  82. package/src/departments-mcp.test.ts +128 -0
  83. package/src/departments.ts +318 -0
  84. package/src/desktop-message-seam.test.ts +150 -0
  85. package/src/desktop-message.test.ts +368 -0
  86. package/src/dm-file-scope-http.test.ts +178 -0
  87. package/src/empty-node-sweeper.test.ts +104 -0
  88. package/src/empty-node-sweeper.ts +88 -0
  89. package/src/env-transport-gate-http.test.ts +240 -0
  90. package/src/env-transport-gate.ts +80 -0
  91. package/src/env-transport-policy.ts +56 -0
  92. package/src/etag-of.test.ts +57 -0
  93. package/src/event-loop-lag.test.ts +180 -0
  94. package/src/event-loop-lag.ts +201 -0
  95. package/src/expiry-counters.test.ts +141 -0
  96. package/src/expiry-counters.ts +112 -0
  97. package/src/ext-token-shared.test.ts +60 -0
  98. package/src/ext-validation-regression.test.ts +131 -0
  99. package/src/external-schedule-edits-http.test.ts +321 -0
  100. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  101. package/src/external-schedule-edits.ts +327 -0
  102. package/src/file-download-authz-dev-open.test.ts +1 -1
  103. package/src/file-download-authz.test.ts +75 -20
  104. package/src/file-download-date-bucket.test.ts +8 -26
  105. package/src/file-network-scope-dev-open.test.ts +97 -0
  106. package/src/file-network-scope.test.ts +732 -0
  107. package/src/group-membership-events-http.test.ts +264 -0
  108. package/src/group-messages-http.test.ts +483 -0
  109. package/src/group-messages.ts +297 -0
  110. package/src/health-anon-readers.ts +60 -0
  111. package/src/health-host-disk-2756.test.ts +71 -0
  112. package/src/health-redaction.test.ts +1541 -7
  113. package/src/host-supervisor-identity-http.test.ts +152 -0
  114. package/src/host-supervisor-identity.ts +92 -0
  115. package/src/host-supervisors-daemon-version.test.ts +137 -0
  116. package/src/http-gzip.test.ts +94 -0
  117. package/src/http-gzip.ts +112 -0
  118. package/src/hub-catalog-read-http.test.ts +641 -0
  119. package/src/hub-provider-config.test.ts +166 -0
  120. package/src/hub-provider-config.ts +202 -0
  121. package/src/hub-timestamp.test.ts +38 -0
  122. package/src/hub-timestamp.ts +27 -0
  123. package/src/human-dm.ts +215 -0
  124. package/src/human-inbox.ts +42 -0
  125. package/src/inbox-caller.ts +49 -0
  126. package/src/inbox-count-sse.test.ts +310 -0
  127. package/src/inbox-count.ts +29 -0
  128. package/src/index.ts +6 -2
  129. package/src/license-state.test.ts +56 -0
  130. package/src/license-state.ts +48 -0
  131. package/src/list-host-supervisors.test.ts +15 -4
  132. package/src/mcp-context-cost-http.test.ts +127 -0
  133. package/src/mcp-inflight.test.ts +92 -0
  134. package/src/mcp-inflight.ts +38 -0
  135. package/src/mcp-projects-events-http.test.ts +165 -0
  136. package/src/mcp-route-label-http.test.ts +120 -0
  137. package/src/mcp-write-network-resolution.test.ts +435 -0
  138. package/src/member-audit-network-id-http.test.ts +93 -0
  139. package/src/member-presence-http.test.ts +210 -0
  140. package/src/messages-ack-by-agent-http.test.ts +142 -0
  141. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  142. package/src/migrate-sqlite-to-pg.ts +263 -0
  143. package/src/model-auth-notify-http.test.ts +181 -0
  144. package/src/model-auth-notify.ts +116 -0
  145. package/src/network-name-http.test.ts +75 -0
  146. package/src/network-rules-http.test.ts +169 -0
  147. package/src/network-rules.ts +129 -0
  148. package/src/network-scope.ts +276 -0
  149. package/src/network-token-membership-http.test.ts +186 -0
  150. package/src/node-alias-control.ts +12 -0
  151. package/src/node-attrs.test.ts +47 -2
  152. package/src/node-caller-identity-http.test.ts +1108 -0
  153. package/src/node-create-request-status-http.test.ts +105 -0
  154. package/src/node-daemon-bindings.test.ts +132 -0
  155. package/src/node-daemon-bindings.ts +135 -0
  156. package/src/node-failure-alert.test.ts +150 -0
  157. package/src/node-failure-alert.ts +177 -0
  158. package/src/node-files-transport.test.ts +347 -0
  159. package/src/node-health-codex-login.test.ts +120 -0
  160. package/src/node-health-dispatch-http.test.ts +373 -0
  161. package/src/node-health-guard.ts +121 -0
  162. package/src/node-health-passthrough.test.ts +115 -0
  163. package/src/node-health-store.ts +101 -0
  164. package/src/node-id-alias.test.ts +190 -0
  165. package/src/node-identity-conflict-http.test.ts +269 -0
  166. package/src/node-identity-conflict.ts +142 -0
  167. package/src/node-identity-mismatch.test.ts +74 -0
  168. package/src/node-in-flight-tasks.ts +31 -0
  169. package/src/node-lifecycle-controllable.test.ts +64 -0
  170. package/src/node-lifecycle-controllable.ts +53 -0
  171. package/src/node-lifecycle-read-http.test.ts +257 -0
  172. package/src/node-lifecycle-read.ts +124 -0
  173. package/src/node-logs-transport.test.ts +263 -0
  174. package/src/node-peer-allowlist.test.ts +114 -0
  175. package/src/node-permissions-http.test.ts +728 -0
  176. package/src/node-permissions.ts +494 -0
  177. package/src/node-request-retention.test.ts +281 -0
  178. package/src/node-request-retention.ts +120 -0
  179. package/src/node-secret-rest-http.test.ts +190 -0
  180. package/src/node-serviceability.test.ts +86 -0
  181. package/src/node-serviceability.ts +124 -0
  182. package/src/node-session-control-http.test.ts +310 -0
  183. package/src/node-session-control.ts +258 -0
  184. package/src/node-skills-transport.test.ts +212 -0
  185. package/src/node-token-identity.ts +35 -0
  186. package/src/node-token-ownership.ts +51 -0
  187. package/src/node-token-privilege-http.test.ts +158 -0
  188. package/src/not-found-api-http.test.ts +67 -0
  189. package/src/observer-avatar-http.test.ts +103 -10
  190. package/src/observer-push.test.ts +76 -0
  191. package/src/opencode-catalog-report-http.test.ts +139 -0
  192. package/src/opencode-v2-catalog.test.ts +268 -0
  193. package/src/opencode-v2-catalog.ts +356 -0
  194. package/src/package-version-consistency.test.ts +25 -0
  195. package/src/parent-source-marker.test.ts +50 -0
  196. package/src/password-network-tokens.ts +25 -0
  197. package/src/peer-reply-atomic.test.ts +462 -0
  198. package/src/peer-reply-capability.test.ts +70 -0
  199. package/src/pg-worker.ts +87 -0
  200. package/src/poll-pacing.test.ts +74 -0
  201. package/src/poll-pacing.ts +123 -0
  202. package/src/project-dir-warn-clear-http.test.ts +132 -0
  203. package/src/project-viewer-can-http.test.ts +116 -0
  204. package/src/provider-tools-shape.test.ts +150 -0
  205. package/src/push.test.ts +20 -10
  206. package/src/push.ts +373 -9
  207. package/src/redact-tokens.test.ts +86 -0
  208. package/src/redact-tokens.ts +43 -0
  209. package/src/rejection-counters.test.ts +72 -0
  210. package/src/rejection-counters.ts +173 -0
  211. package/src/rename.ts +38 -10
  212. package/src/reply-target-derivation.test.ts +96 -0
  213. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  214. package/src/report-status-host-schema.test.ts +235 -0
  215. package/src/report-status-resume-id-handover.test.ts +184 -0
  216. package/src/report-status-secret-keys.test.ts +140 -0
  217. package/src/require-explicit-test-db.ts +9 -0
  218. package/src/requirement-due-reminders-http.test.ts +620 -0
  219. package/src/requirement-due-reminders.ts +416 -0
  220. package/src/requirement-events-http.test.ts +318 -0
  221. package/src/requirement-events.test.ts +45 -0
  222. package/src/requirement-events.ts +144 -0
  223. package/src/requirement-notify.ts +165 -0
  224. package/src/requirement-participant-notify-http.test.ts +309 -0
  225. package/src/requirement-tag-ops-http.test.ts +454 -0
  226. package/src/requirement-tag-tree-http.test.ts +275 -0
  227. package/src/requirement-tag-tree.ts +127 -0
  228. package/src/requirement-tags.ts +102 -0
  229. package/src/requirements-abandoned-http.test.ts +236 -0
  230. package/src/requirements-assignee-drift.test.ts +154 -0
  231. package/src/requirements-comment-http.test.ts +174 -0
  232. package/src/requirements-completed-at-migration.test.ts +70 -0
  233. package/src/requirements-errors-mcp-http.test.ts +164 -0
  234. package/src/requirements-errors.ts +158 -0
  235. package/src/requirements-etag-http.test.ts +91 -0
  236. package/src/requirements-http.test.ts +709 -0
  237. package/src/requirements-last-event-http.test.ts +349 -0
  238. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  239. package/src/requirements-list-slim-http.test.ts +324 -0
  240. package/src/requirements-mcp.test.ts +164 -0
  241. package/src/requirements-migrate.ts +283 -0
  242. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  243. package/src/requirements-people-http.test.ts +114 -0
  244. package/src/requirements-people-mcp-http.test.ts +231 -0
  245. package/src/requirements-people.ts +196 -0
  246. package/src/requirements-priority-lowest.test.ts +114 -0
  247. package/src/requirements-projects-network-echo.test.ts +57 -0
  248. package/src/requirements-projects-parent-http.test.ts +123 -0
  249. package/src/requirements-search-http.test.ts +182 -0
  250. package/src/requirements-search.test.ts +32 -0
  251. package/src/requirements-search.ts +145 -0
  252. package/src/requirements-seq-http.test.ts +193 -0
  253. package/src/requirements-seq-migration.test.ts +63 -0
  254. package/src/requirements-start-date.test.ts +125 -0
  255. package/src/requirements-stats-http.test.ts +357 -0
  256. package/src/requirements-stats.ts +195 -0
  257. package/src/requirements-status-participants-http.test.ts +222 -0
  258. package/src/requirements-upgrade-e2e.test.ts +126 -0
  259. package/src/requirements-upgrade-migration.test.ts +98 -0
  260. package/src/requirements.ts +2205 -0
  261. package/src/resolve-port.test.ts +57 -0
  262. package/src/resolve-port.ts +44 -0
  263. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  264. package/src/rest-alias-network-fallback.test.ts +60 -0
  265. package/src/rest-alias-network-fallback.ts +65 -0
  266. package/src/rest-explicit-columns-http.test.ts +266 -0
  267. package/src/rest-identity.test.ts +130 -0
  268. package/src/rest-identity.ts +141 -0
  269. package/src/rest-projections.ts +72 -0
  270. package/src/rest-read-network-real-chain.test.ts +97 -0
  271. package/src/rest-write-network-resolution.test.ts +133 -0
  272. package/src/restart-readiness-http.test.ts +121 -0
  273. package/src/restricted-files.ts +76 -0
  274. package/src/retention-first-sweep-quiet.test.ts +31 -0
  275. package/src/retention.test.ts +100 -40
  276. package/src/retention.ts +423 -104
  277. package/src/route-callers-http.test.ts +120 -0
  278. package/src/route-timing.test.ts +218 -0
  279. package/src/route-timing.ts +262 -0
  280. package/src/rules-file-duplicate-alias.test.ts +234 -0
  281. package/src/rules-file-session-target.test.ts +207 -0
  282. package/src/rules-file-transport.test.ts +237 -0
  283. package/src/runtime-label.test.ts +22 -0
  284. package/src/runtime-label.ts +21 -0
  285. package/src/runtime-readiness.ts +90 -0
  286. package/src/schedule-agent-mcp-http.test.ts +475 -0
  287. package/src/schedule-agent.ts +252 -0
  288. package/src/schedule-starved.test.ts +92 -0
  289. package/src/schedule-starved.ts +114 -0
  290. package/src/scheduled-backoff-http.test.ts +203 -0
  291. package/src/scheduled-backoff.ts +64 -0
  292. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  293. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  294. package/src/scheduled-failure-code.test.ts +73 -0
  295. package/src/scheduled-failure-code.ts +105 -0
  296. package/src/scheduled-failures-http.test.ts +279 -0
  297. package/src/scheduled-failures.ts +425 -0
  298. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  299. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  300. package/src/scheduled-offline.test.ts +131 -0
  301. package/src/scheduled-offline.ts +66 -0
  302. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  303. package/src/scheduled-outcome-guidance.ts +9 -0
  304. package/src/scheduled-reply-unread-http.test.ts +212 -0
  305. package/src/scheduled-requirement-wake-http.test.ts +285 -0
  306. package/src/scheduled-requirement-wake.ts +125 -0
  307. package/src/scheduled-run-terminal.test.ts +290 -0
  308. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  309. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  310. package/src/scheduled-stuck-http.test.ts +316 -0
  311. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  312. package/src/scheduled-stuck.ts +219 -0
  313. package/src/scheduled-tasks-http.test.ts +679 -0
  314. package/src/scheduled-tasks.ts +959 -0
  315. package/src/scheduled-work-outcome-http.test.ts +154 -0
  316. package/src/scheduled-work-outcome.ts +50 -0
  317. package/src/scoped-secrets.ts +141 -0
  318. package/src/secret-echo-negative-control.test.ts +118 -0
  319. package/src/send-dedup-request-id.test.ts +229 -0
  320. package/src/send-reply-agent-warning.test.ts +38 -38
  321. package/src/send-reply-alias-optional.test.ts +131 -0
  322. package/src/send-reply-attachments.test.ts +458 -0
  323. package/src/send_dedup.test.ts +54 -0
  324. package/src/send_dedup.ts +52 -6
  325. package/src/serve-error.test.ts +73 -0
  326. package/src/serve-error.ts +56 -0
  327. package/src/server.ts +5134 -503
  328. package/src/session-task-on-dispatch.ts +14 -0
  329. package/src/session-token-ownership-http.test.ts +122 -0
  330. package/src/shared/codex-inventory.ts +41 -0
  331. package/src/shared/daemon-provider-login.ts +31 -0
  332. package/src/shared/daemon-provider-snapshot.ts +52 -0
  333. package/src/shared/external-schedule-contract.ts +60 -0
  334. package/src/shared/node-name.test.ts +62 -0
  335. package/src/shared/node-name.ts +161 -0
  336. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  337. package/src/shared/provider-application.ts +29 -0
  338. package/src/shared/provider-collection.ts +14 -0
  339. package/src/shared/provider-initialization.ts +8 -0
  340. package/src/shared/reserved-env-drift.test.ts +10 -0
  341. package/src/shared/scoped-secret-contract.ts +5 -0
  342. package/src/shared/task-content-limit-drift.test.ts +28 -0
  343. package/src/shared/task-content-limit.ts +25 -0
  344. package/src/side-thread-command-transport.test.ts +312 -0
  345. package/src/side-thread-command-transport.ts +318 -0
  346. package/src/side-thread-http-integration.test.ts +233 -0
  347. package/src/side-thread-http.ts +504 -0
  348. package/src/side-thread-production.test.ts +72 -0
  349. package/src/side-thread-production.ts +118 -0
  350. package/src/side-thread.test.ts +1067 -0
  351. package/src/side-thread.ts +2499 -0
  352. package/src/skillhub-http.test.ts +142 -0
  353. package/src/sqlite-close-checkpoint.test.ts +78 -0
  354. package/src/start-node.test.ts +265 -0
  355. package/src/stats-versions-http.test.ts +65 -0
  356. package/src/status-alias-filter-http.test.ts +106 -0
  357. package/src/status-alias-resolver-http.test.ts +163 -0
  358. package/src/status-alias-resolver.ts +19 -0
  359. package/src/status-node-id-filter-http.test.ts +161 -0
  360. package/src/status-read-cache-http.test.ts +229 -0
  361. package/src/status-read-cache.ts +129 -0
  362. package/src/stop-delete-node.test.ts +567 -1
  363. package/src/task-access-http.test.ts +402 -0
  364. package/src/task-access.ts +420 -0
  365. package/src/task-activity.ts +60 -0
  366. package/src/task-auth-origin-http.test.ts +93 -0
  367. package/src/task-auth-origin.test.ts +24 -0
  368. package/src/task-auth-origin.ts +7 -0
  369. package/src/task-consumption.test.ts +498 -0
  370. package/src/task-diagnostic-http.test.ts +149 -0
  371. package/src/task-diagnostic.test.ts +115 -0
  372. package/src/task-diagnostic.ts +118 -0
  373. package/src/task-expiry-notice-http.test.ts +298 -0
  374. package/src/task-expiry-notice.ts +318 -0
  375. package/src/task-idempotency-mcp.test.ts +142 -0
  376. package/src/task-idempotency.test.ts +76 -0
  377. package/src/task-idempotency.ts +81 -0
  378. package/src/task-late-replies.ts +54 -0
  379. package/src/task-late-reply-http.test.ts +227 -0
  380. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  381. package/src/task-lifecycle-watcher.test.ts +209 -0
  382. package/src/task-lifecycle-watcher.ts +109 -0
  383. package/src/task-network-resolution-http.test.ts +140 -0
  384. package/src/task-offline-delivery-2668.test.ts +119 -0
  385. package/src/task-offline-delivery.ts +81 -0
  386. package/src/task-orphan-http.test.ts +287 -0
  387. package/src/task-orphan.ts +119 -0
  388. package/src/task-queue-ahead-http.test.ts +309 -0
  389. package/src/task-queue-ahead-scale.test.ts +236 -0
  390. package/src/task-queue-ahead.ts +186 -0
  391. package/src/task-rejection-log-http.test.ts +160 -0
  392. package/src/task-rejection-log.ts +61 -0
  393. package/src/task-sender-http.test.ts +143 -0
  394. package/src/task-stale-open-http.test.ts +292 -0
  395. package/src/task-stale-open.ts +103 -0
  396. package/src/tasks-pagination-http.test.ts +141 -0
  397. package/src/team-rules-status-http.test.ts +90 -0
  398. package/src/team-rules-status.test.ts +59 -0
  399. package/src/team-rules-status.ts +72 -0
  400. package/src/tmux-allowlist.test.ts +48 -0
  401. package/src/tool-audience-http.test.ts +230 -0
  402. package/src/tool-audience.ts +127 -0
  403. package/src/tools-list-json-schema.test.ts +94 -0
  404. package/src/tools.ts +4326 -420
  405. package/src/upload-early-reject-guard.test.ts +155 -0
  406. package/src/uploads-http.test.ts +86 -7
  407. package/src/uploads.ts +38 -4
  408. package/src/user-avatar-http.test.ts +74 -0
  409. package/src/user-avatar-image.ts +160 -0
  410. package/src/user-avatar-migration.test.ts +25 -0
  411. package/src/user-avatar-upload-http.test.ts +348 -0
  412. package/src/user-inbox-by-agent-http.test.ts +165 -0
  413. package/src/user-inbox-netid-notnull.test.ts +122 -0
  414. package/src/user-inbox-read-http.test.ts +223 -0
  415. package/src/user-inbox-schema.test.ts +54 -0
  416. package/src/version-stats.test.ts +66 -0
  417. package/src/version-stats.ts +109 -0
@@ -0,0 +1,117 @@
1
+ // #2721 —— 广播扇出:把「一条广播 = 几百次同步写 + 同一秒全员唤醒」摊开。
2
+ //
3
+ // 现场(2026-10-27 07:10–07:15,生产 `.165`,触发者是我自己的一条广播):
4
+ // 一条广播 → 384 行 inbox(每行一次 autocommit INSERT)
5
+ // → 07:11:16 起连续四次 timer 饥饿:3.5s / 20.0s / **143.9s** / 10.0s
6
+ // → RSS 639MB → 979MB → 2507MB → 2910MB,3 分钟后自行排空
7
+ // → `requests_since_last_tick` 分别是 145 / 123 / **1175** / 294
8
+ // ⇒ 当时的循环是**被打满**(8 req/s 持续),不是被阻塞。
9
+ //
10
+ // 这里只改**节奏**,不改语义:仍然逐行入库、仍然给每个收件人推事件,
11
+ // 但每 50 个收件人一批、批间让出事件循环,把「同一毫秒 384 次 commit」
12
+ // 变成「8 批、每批一次事务」。
13
+ //
14
+ // 2026-10-30 补下半句:**通知(SSE 推送)也必须在批内**。
15
+ // 上半句只摊开了入库,通知仍是「所有批次之后一次性循环」——
16
+ // 于是 384 个 agent 还是在同一个 tick 里被唤醒。入库摊开对客户端几乎无感,
17
+ // 唤醒摊开才是「随机大停顿」的解法。
18
+ //
19
+ // 为什么有用:真正的负载大头是收件 agent 随后各自的 report_status/get_inbox/send_reply
20
+ // (实测一条广播 ≈ 500+ 次调用)。把入库摊开几百毫秒,能让唤醒时刻自然分散,
21
+ // 而不是让 384 个 agent 在同一秒同时醒来。
22
+
23
+ import { db } from "./db.js";
24
+
25
+ /** 一批多少个收件人。50 是“一次事务不至于太长、又明显少于一次全量”的折中。 */
26
+ export const BROADCAST_CHUNK = 50;
27
+
28
+ /**
29
+ * #2721 —— 最近一次广播的「事后可对上时间的」记录。
30
+ *
31
+ * 为什么要有:07:11 那次事故里,我花了不少时间才把“143.9 秒停顿”与“07:10 那条广播”
32
+ * 对上 —— 因为停顿记录(`event_loop.recent_stalls`)里只有时间与 RSS,没有“当时发生了什么”。
33
+ * 广播是唯一一种能一次性唤醒几百个 agent 的动作,值得在 `/health` 里留一格。
34
+ */
35
+ export type BroadcastRecord = {
36
+ at: string;
37
+ recipients: number;
38
+ chunks: number;
39
+ took_ms: number;
40
+ };
41
+
42
+ let lastBroadcast: BroadcastRecord | null = null;
43
+
44
+ export function broadcastRecentState(): BroadcastRecord | null {
45
+ return lastBroadcast;
46
+ }
47
+
48
+ export type BroadcastTarget = { alias: string; node_id: string | null; network_id: string | null };
49
+ export type BroadcastDelivered = { alias: string; netId: string | null };
50
+
51
+ export type BroadcastDeps = {
52
+ /** RFC-027 §2.3:非 active 的收件人静默跳过(广播是 best-effort)。 */
53
+ isActive: (alias: string, netId: string | null) => boolean;
54
+ /** 入库之后给该收件人推一次事件(原实现用 pushEvent + pendingInboxCount)。 */
55
+ notify: (alias: string, netId: string | null) => void;
56
+ /** 测试缝:批间的让出动作。 */
57
+ yieldBetweenChunks?: () => Promise<void>;
58
+ chunkSize?: number;
59
+ };
60
+
61
+ export async function enqueueBroadcast(
62
+ targets: readonly BroadcastTarget[],
63
+ message: string,
64
+ fromSession: string,
65
+ effectiveNetId: string | null,
66
+ deps: BroadcastDeps,
67
+ ): Promise<{ ids: string[]; delivered: BroadcastDelivered[] }> {
68
+ const startedMs = Date.now();
69
+ const chunk = deps.chunkSize && deps.chunkSize > 0 ? deps.chunkSize : BROADCAST_CHUNK;
70
+ const ids: string[] = [];
71
+ const delivered: BroadcastDelivered[] = [];
72
+ const yieldNow = deps.yieldBetweenChunks ?? (() => Bun.sleep(0));
73
+
74
+ for (let i = 0; i < targets.length; i += chunk) {
75
+ const slice = targets.slice(i, i + chunk);
76
+ const batch: BroadcastDelivered[] = [];
77
+ // 一批一个事务:把 N 次 autocommit 变成 1 次,既快又不会长时间占写锁。
78
+ db.transaction(() => {
79
+ for (const t of slice) {
80
+ const netId = effectiveNetId ?? t.network_id ?? null;
81
+ if (!deps.isActive(t.alias, netId)) continue;
82
+ const id = crypto.randomUUID();
83
+ db.run(
84
+ `INSERT INTO inbox (id, session_name, node_id, type, priority, content, from_session, network_id)
85
+ VALUES (?1, ?2, ?3, 'broadcast', 'normal', ?4, ?5, ?6)`,
86
+ [id, t.alias, t.node_id ?? null, message, fromSession, netId],
87
+ );
88
+ ids.push(id);
89
+ const d = { alias: t.alias, netId };
90
+ delivered.push(d);
91
+ batch.push(d);
92
+ }
93
+ });
94
+ // #2721 下半 —— 通知也必须在批内做。
95
+ // 原来这句循环在**所有批次之后**:入库摊开了,但 384 次 SSE 推送又落回同一个 tick,
96
+ // 于是「同一秒全员唤醒」这个真正的问题一点没变 —— 只是把 INSERT 挪开了。
97
+ // 推送失败绝不能中断后续批次:原来通知在所有入库之后,抛错时「入库已全」;
98
+ // 现在挪进批内,一次推送异常会让剩下的人**收不到广播**。这里逐条兜住。
99
+ for (const d of batch) {
100
+ try {
101
+ deps.notify(d.alias, d.netId);
102
+ } catch (e) {
103
+ console.error(`[broadcast] notify failed alias=${d.alias}: ${(e as Error).message}`);
104
+ }
105
+ }
106
+ // 批间让出:没有这一句,384 行仍然是在同一个 tick 里写完的。
107
+ await yieldNow();
108
+ }
109
+
110
+ lastBroadcast = {
111
+ at: new Date().toISOString(),
112
+ recipients: delivered.length,
113
+ chunks: Math.ceil(targets.length / chunk),
114
+ took_ms: Date.now() - startedMs,
115
+ };
116
+ return { ids, delivered };
117
+ }
@@ -0,0 +1,60 @@
1
+ // #3177 —— 构建期注入的构建标识:**读取三态**(present / absent / invalid)。
2
+ //
3
+ // 为什么这三态必须分开(这是本文件存在的理由):
4
+ // 部署形态(npm install 出来的 runtime)里没有 .git ⇒ 运行期 git rev-parse 拿不到东西 ⇒
5
+ // 生产 /health 的 build_identified 恒为 false(实测:部署 .246 之后仍为 false)。
6
+ // 于是「注入写坏了」与「还没注入」会读成同一个东西 —— 而后者是正常状态、前者是缺陷。
7
+ // ⇒ absent 是正常的;invalid 必须能被单独看见。
8
+ import { describe, expect, test } from "bun:test";
9
+ import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
10
+ import { tmpdir } from "node:os";
11
+ import { join } from "node:path";
12
+ import { BUILD_INFO_FILE, readBuildInfo, validateBuildInfo } from "./build-info";
13
+
14
+ const SHA = "a".repeat(40);
15
+ const GOOD = { schema: 1, commit: SHA, dirty: false, built_at: "2026-10-31T17:00:00Z" };
16
+
17
+ function inTemp(fn: (dir: string) => void): void {
18
+ const dir = mkdtempSync(join(tmpdir(), "build-info-"));
19
+ try { fn(dir); } finally { rmSync(dir, { recursive: true, force: true }); }
20
+ }
21
+
22
+ describe("#3177 build-info 读取", () => {
23
+ test("absent:目录里没有文件 —— 这是**正常状态**(部署形态没注入),不是缺陷", () => {
24
+ inTemp((dir) => expect(readBuildInfo(dir)).toEqual({ kind: "absent" }));
25
+ });
26
+
27
+ test("present:格式正确就原样读出(含可选 source)", () => {
28
+ inTemp((dir) => {
29
+ writeFileSync(join(dir, BUILD_INFO_FILE), JSON.stringify({ ...GOOD, source: "release.yml" }));
30
+ expect(readBuildInfo(dir)).toEqual({ kind: "present", info: { ...GOOD, source: "release.yml" } });
31
+ });
32
+ });
33
+
34
+ test("invalid:文件在但形状不对 ⇒ 与 absent **分开报**", () => {
35
+ inTemp((dir) => {
36
+ writeFileSync(join(dir, BUILD_INFO_FILE), "{ not json");
37
+ expect(readBuildInfo(dir)).toEqual({ kind: "invalid", error: "invalid_json" });
38
+ writeFileSync(join(dir, BUILD_INFO_FILE), JSON.stringify({ ...GOOD, commit: "short" }));
39
+ expect(readBuildInfo(dir)).toEqual({ kind: "invalid", error: "invalid_shape" });
40
+ });
41
+ });
42
+
43
+ test("严格校验:这几个都不接受(每一个都是真实会写错的形态)", () => {
44
+ expect(validateBuildInfo(null)).toBeNull();
45
+ expect(validateBuildInfo([])).toBeNull();
46
+ expect(validateBuildInfo({ ...GOOD, schema: "1" })).toBeNull(); // 字符串 schema
47
+ expect(validateBuildInfo({ ...GOOD, commit: "A".repeat(40) })).toBeNull(); // 大写 hex
48
+ expect(validateBuildInfo({ ...GOOD, commit: "a".repeat(39) })).toBeNull();
49
+ expect(validateBuildInfo({ ...GOOD, dirty: "false" })).toBeNull(); // 字符串布尔
50
+ expect(validateBuildInfo({ ...GOOD, built_at: "2026-10-31 17:00:00" })).toBeNull(); // 非 ISO-Z
51
+ expect(validateBuildInfo({ ...GOOD, built_at: "yesterday" })).toBeNull();
52
+ expect(validateBuildInfo({ ...GOOD, source: 42 })).toBeNull();
53
+ });
54
+
55
+ test("脏树可以注入,但读数里必须看得见 dirty —— 否则「脏树构建」会被当成提交", () => {
56
+ const dirty = validateBuildInfo({ ...GOOD, dirty: true });
57
+ expect(dirty?.dirty).toBe(true);
58
+ expect(dirty?.commit).toBe(SHA);
59
+ });
60
+ });
@@ -0,0 +1,85 @@
1
+ /**
2
+ * 2026-10-31 —— **构建期注入的构建标识**(#3177)。
3
+ *
4
+ * 为什么需要它:`detectBootGitIdentity()` 是**运行期** `git rev-parse` 从 module_dir 向上找 `.git`。
5
+ * 而生产的部署形态是 `npm install --prefix ~/.commhub/runtime-…` 的产物 —— **没有 .git**。
6
+ * 实测(部署 .246 之后):`/health` 的 `build_identified = false`。
7
+ * ⇒ 同一版本号、不同字节,在生产上**无法分辨**;而 runtime 读 git 这条路在部署形态上不存在。
8
+ *
9
+ * 所以标识必须由**构建时**写下来,运行期只负责读,并且**读不到要能与「没有标识」区分**。
10
+ *
11
+ * 本模块只做读取与**严格校验**:形状不对就返回 null,绝不猜、绝不抛。
12
+ * 判据:一个坏掉的 build-info.json 与「没有这个文件」是两件事,
13
+ * 但两者都不能变成「看起来有标识」—— 所以校验失败一律 null,由调用方的 reason 去说明。
14
+ */
15
+ import { readFileSync } from "node:fs";
16
+ import { join } from "node:path";
17
+
18
+ export type BuildInfo = {
19
+ schema: 1;
20
+ /** 40 位小写十六进制;构建时的 HEAD。 */
21
+ commit: string;
22
+ /** 构建时工作树是否脏。脏的 commit 只能当「自称」用。 */
23
+ dirty: boolean;
24
+ /** 构建时刻(ISO 8601,UTC)。 */
25
+ built_at: string;
26
+ /** 可选:谁写的(例如 "release.yml")。仅用于人读。 */
27
+ source?: string;
28
+ };
29
+
30
+ export const BUILD_INFO_FILE = "build-info.json";
31
+
32
+ const SHA40 = /^[0-9a-f]{40}$/;
33
+
34
+ function isIsoUtc(s: unknown): s is string {
35
+ if (typeof s !== "string" || s.length < 20) return false;
36
+ const ms = Date.parse(s);
37
+ return Number.isFinite(ms) && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?Z$/.test(s);
38
+ }
39
+
40
+ /** 校验一份 build-info 载荷;形状不对返回 null(不抛)。 */
41
+ export function validateBuildInfo(raw: unknown): BuildInfo | null {
42
+ if (!raw || typeof raw !== "object" || Array.isArray(raw)) return null;
43
+ const o = raw as Record<string, unknown>;
44
+ if (o.schema !== 1) return null;
45
+ if (typeof o.commit !== "string" || !SHA40.test(o.commit)) return null;
46
+ if (typeof o.dirty !== "boolean") return null;
47
+ if (!isIsoUtc(o.built_at)) return null;
48
+ if (o.source !== undefined && typeof o.source !== "string") return null;
49
+ const out: BuildInfo = { schema: 1, commit: o.commit, dirty: o.dirty, built_at: o.built_at };
50
+ if (typeof o.source === "string") out.source = o.source;
51
+ return out;
52
+ }
53
+
54
+ /**
55
+ * 从某个目录读 build-info.json。
56
+ *
57
+ * 返回**两态**而不是一态:
58
+ * `{ kind: "present", info }` —— 读到且通过校验
59
+ * `{ kind: "absent" }` —— 文件不存在(部署形态没注入)
60
+ * `{ kind: "invalid", error }` —— 文件在但形状不对(这是**缺陷**,不是「没有」)
61
+ * 第三种必须与第二种分开:否则「注入写坏了」会读成「还没注入」,而后者是正常状态。
62
+ */
63
+ export type BuildInfoRead =
64
+ | { kind: "present"; info: BuildInfo }
65
+ | { kind: "absent" }
66
+ | { kind: "invalid"; error: string };
67
+
68
+ export function readBuildInfo(dir: string): BuildInfoRead {
69
+ const path = join(dir, BUILD_INFO_FILE);
70
+ let text: string;
71
+ try {
72
+ text = readFileSync(path, "utf8");
73
+ } catch (e: any) {
74
+ if (e && (e.code === "ENOENT" || e.code === "ENOTDIR")) return { kind: "absent" };
75
+ return { kind: "invalid", error: `unreadable:${e?.code ?? "unknown"}` };
76
+ }
77
+ let parsed: unknown;
78
+ try {
79
+ parsed = JSON.parse(text);
80
+ } catch {
81
+ return { kind: "invalid", error: "invalid_json" };
82
+ }
83
+ const info = validateBuildInfo(parsed);
84
+ return info ? { kind: "present", info } : { kind: "invalid", error: "invalid_shape" };
85
+ }