@sleep2agi/commhub-server 0.9.0-preview.28 → 0.9.0-preview.281

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 (482) hide show
  1. package/README.md +120 -3
  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 +229 -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 +215 -0
  12. package/src/agent-access.ts +585 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +691 -0
  15. package/src/agent-acl-slice3-http.test.ts +888 -0
  16. package/src/agent-department-grants.test.ts +129 -0
  17. package/src/agent-department-http.test.ts +215 -0
  18. package/src/agent-groups-perf.test.ts +228 -0
  19. package/src/agent-notice.ts +48 -0
  20. package/src/agent-team-whoami-http.test.ts +98 -0
  21. package/src/agent-teams-http.test.ts +330 -0
  22. package/src/agent-teams.ts +244 -0
  23. package/src/alias-baseline-2571.test.ts +162 -0
  24. package/src/alias-baseline.ts +113 -0
  25. package/src/alias-filter.test.ts +72 -0
  26. package/src/alias-filter.ts +42 -0
  27. package/src/all-status-cache.test.ts +31 -0
  28. package/src/all-status-cache.ts +37 -0
  29. package/src/anet-variant-real-daemon-http.test.ts +185 -0
  30. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  31. package/src/api-host-supervisors-fallback.test.ts +6 -7
  32. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  33. package/src/api-nodes-shape.test.ts +131 -4
  34. package/src/auth-abuse-counters.test.ts +144 -0
  35. package/src/auth-abuse-counters.ts +122 -0
  36. package/src/auth-layer-shape.test.ts +105 -0
  37. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  38. package/src/auth-sessions-http.test.ts +260 -0
  39. package/src/auth-validate.test.ts +5 -1
  40. package/src/auth-weak-password-login.test.ts +176 -0
  41. package/src/auth.ts +641 -68
  42. package/src/backfill-node-ids-2664.test.ts +128 -0
  43. package/src/binding-generation-http.test.ts +141 -0
  44. package/src/blocked-exit-on-reply.test.ts +122 -0
  45. package/src/broadcast-fanout-2721.test.ts +149 -0
  46. package/src/broadcast-fanout.ts +117 -0
  47. package/src/build-commit-report-http.test.ts +219 -0
  48. package/src/build-info.test.ts +60 -0
  49. package/src/build-info.ts +85 -0
  50. package/src/chain-attempt-dedup.test.ts +447 -0
  51. package/src/clip.test.ts +36 -0
  52. package/src/clip.ts +48 -0
  53. package/src/clone-node.test.ts +269 -0
  54. package/src/clone-node.ts +289 -0
  55. package/src/codex-config-flags.ts +77 -0
  56. package/src/codex-fork-contract.ts +23 -0
  57. package/src/codex-fork-migration.test.ts +38 -0
  58. package/src/commhub-bin-args.test.ts +85 -0
  59. package/src/config-apply-sec1.test.ts +37 -0
  60. package/src/config-apply-validate.test.ts +188 -1
  61. package/src/config-apply-validate.ts +226 -3
  62. package/src/contracts/session-project-create.ts +14 -0
  63. package/src/contracts/session-source-delivery.ts +16 -0
  64. package/src/contracts/session-source-directory.ts +54 -0
  65. package/src/contracts/session-source-evidence.ts +72 -0
  66. package/src/contracts/session-source-execution.ts +24 -0
  67. package/src/contracts/session-source-transport.ts +18 -0
  68. package/src/cors-origins.test.ts +73 -0
  69. package/src/create-node-blocked-gate.test.ts +365 -0
  70. package/src/create-node-error-domain.test.ts +127 -0
  71. package/src/create-node-network-id.test.ts +91 -0
  72. package/src/create-node-tool-schema.test.ts +59 -0
  73. package/src/create-node-unicode-name.test.ts +126 -0
  74. package/src/create-node-validate.test.ts +199 -7
  75. package/src/create-node-validate.ts +232 -15
  76. package/src/create-node-workdir.test.ts +298 -0
  77. package/src/create-node.ts +88 -23
  78. package/src/daemon-provider-snapshots.test.ts +453 -0
  79. package/src/daemon-provider-snapshots.ts +327 -0
  80. package/src/daemon-token-owner-http.test.ts +346 -0
  81. package/src/dashboard-slash-routing-http.test.ts +109 -0
  82. package/src/db-adapter-guard.test.ts +148 -0
  83. package/src/db-adapter-translate.test.ts +128 -0
  84. package/src/db-adapter.ts +377 -91
  85. package/src/db-timestamp.test.ts +38 -0
  86. package/src/db-timestamp.ts +15 -0
  87. package/src/db.ts +1334 -154
  88. package/src/delivered-without-push.test.ts +140 -0
  89. package/src/department-groups-http.test.ts +209 -0
  90. package/src/department-groups-sync-http.test.ts +328 -0
  91. package/src/department-groups.ts +434 -0
  92. package/src/department-heads-http.test.ts +350 -0
  93. package/src/department-heads.ts +226 -0
  94. package/src/departments-agent-count.test.ts +139 -0
  95. package/src/departments-http.test.ts +185 -0
  96. package/src/departments-mcp-error-domain.test.ts +135 -0
  97. package/src/departments-mcp.test.ts +128 -0
  98. package/src/departments.ts +318 -0
  99. package/src/desktop-message-seam.test.ts +150 -0
  100. package/src/desktop-message.test.ts +368 -0
  101. package/src/dm-file-scope-http.test.ts +227 -0
  102. package/src/empty-node-sweeper.test.ts +104 -0
  103. package/src/empty-node-sweeper.ts +88 -0
  104. package/src/env-transport-gate-http.test.ts +240 -0
  105. package/src/env-transport-gate.ts +80 -0
  106. package/src/env-transport-policy.ts +56 -0
  107. package/src/etag-of.test.ts +57 -0
  108. package/src/event-loop-lag.test.ts +180 -0
  109. package/src/event-loop-lag.ts +201 -0
  110. package/src/expiry-counters.test.ts +187 -0
  111. package/src/expiry-counters.ts +227 -0
  112. package/src/expiry-evidence-db.test.ts +103 -0
  113. package/src/ext-token-shared.test.ts +60 -0
  114. package/src/ext-validation-regression.test.ts +10 -17
  115. package/src/external-schedule-edits-http.test.ts +321 -0
  116. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  117. package/src/external-schedule-edits.ts +327 -0
  118. package/src/file-download-authz-dev-open.test.ts +1 -1
  119. package/src/file-download-authz.test.ts +25 -4
  120. package/src/file-download-date-bucket.test.ts +1 -1
  121. package/src/file-network-scope-dev-open.test.ts +1 -1
  122. package/src/file-network-scope.test.ts +7 -6
  123. package/src/group-membership-events-http.test.ts +264 -0
  124. package/src/group-messages-http.test.ts +483 -0
  125. package/src/group-messages.ts +297 -0
  126. package/src/health-anon-readers.ts +67 -0
  127. package/src/health-host-disk-2756.test.ts +71 -0
  128. package/src/health-identity-root.test.ts +98 -0
  129. package/src/health-redaction.test.ts +1603 -7
  130. package/src/health-status-reasons.test.ts +84 -0
  131. package/src/host-supervisor-identity-http.test.ts +152 -0
  132. package/src/host-supervisor-identity.ts +92 -0
  133. package/src/host-supervisors-daemon-version.test.ts +137 -0
  134. package/src/http-gzip.test.ts +94 -0
  135. package/src/http-gzip.ts +112 -0
  136. package/src/hub-catalog-read-http.test.ts +664 -0
  137. package/src/hub-provider-config.test.ts +166 -0
  138. package/src/hub-provider-config.ts +202 -0
  139. package/src/hub-timestamp.test.ts +38 -0
  140. package/src/hub-timestamp.ts +27 -0
  141. package/src/human-dm.ts +215 -0
  142. package/src/human-inbox.ts +42 -0
  143. package/src/inbox-caller.ts +49 -0
  144. package/src/inbox-count-sse.test.ts +318 -0
  145. package/src/inbox-count.ts +29 -0
  146. package/src/index.ts +6 -2
  147. package/src/launched-by-cli-report-http.test.ts +155 -0
  148. package/src/license-state.test.ts +105 -0
  149. package/src/license-state.ts +48 -0
  150. package/src/lifecycle-error-domain.test.ts +149 -0
  151. package/src/list-ack-error-domain.test.ts +108 -0
  152. package/src/list-host-supervisors.test.ts +15 -4
  153. package/src/list-tasks-omit-default.test.ts +84 -0
  154. package/src/list-tasks-since-last.test.ts +100 -0
  155. package/src/list-tasks-since.test.ts +104 -0
  156. package/src/mcp-context-cost-http.test.ts +127 -0
  157. package/src/mcp-inflight.test.ts +92 -0
  158. package/src/mcp-inflight.ts +38 -0
  159. package/src/mcp-projects-events-http.test.ts +168 -0
  160. package/src/mcp-route-label-http.test.ts +120 -0
  161. package/src/mcp-write-network-resolution.test.ts +21 -0
  162. package/src/member-audit-network-id-http.test.ts +93 -0
  163. package/src/member-presence-http.test.ts +210 -0
  164. package/src/messages-ack-by-agent-http.test.ts +142 -0
  165. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  166. package/src/migrate-sqlite-to-pg.ts +263 -0
  167. package/src/model-auth-notify-http.test.ts +181 -0
  168. package/src/model-auth-notify.ts +116 -0
  169. package/src/network-name-http.test.ts +75 -0
  170. package/src/network-quota-config.test.ts +100 -0
  171. package/src/network-rules-http.test.ts +169 -0
  172. package/src/network-rules.ts +129 -0
  173. package/src/network-scope.ts +222 -3
  174. package/src/network-token-membership-http.test.ts +186 -0
  175. package/src/node-alias-control.ts +12 -0
  176. package/src/node-attrs.test.ts +47 -2
  177. package/src/node-caller-identity-http.test.ts +1108 -0
  178. package/src/node-config-last-update.test.ts +126 -0
  179. package/src/node-config-last-update.ts +107 -0
  180. package/src/node-create-request-status-http.test.ts +105 -0
  181. package/src/node-daemon-bindings.test.ts +142 -0
  182. package/src/node-daemon-bindings.ts +135 -0
  183. package/src/node-failure-alert.test.ts +150 -0
  184. package/src/node-failure-alert.ts +177 -0
  185. package/src/node-files-transport.test.ts +350 -0
  186. package/src/node-health-codex-login.test.ts +120 -0
  187. package/src/node-health-dispatch-http.test.ts +373 -0
  188. package/src/node-health-guard-origin.test.ts +98 -0
  189. package/src/node-health-guard.ts +121 -0
  190. package/src/node-health-passthrough.test.ts +115 -0
  191. package/src/node-health-store.ts +101 -0
  192. package/src/node-id-alias.test.ts +190 -0
  193. package/src/node-identity-conflict-http.test.ts +269 -0
  194. package/src/node-identity-conflict.ts +142 -0
  195. package/src/node-identity-mismatch.test.ts +74 -0
  196. package/src/node-in-flight-tasks.ts +31 -0
  197. package/src/node-inbox-allowlist-http.test.ts +320 -0
  198. package/src/node-lifecycle-controllable.test.ts +64 -0
  199. package/src/node-lifecycle-controllable.ts +53 -0
  200. package/src/node-lifecycle-read-http.test.ts +257 -0
  201. package/src/node-lifecycle-read.ts +126 -0
  202. package/src/node-logs-transport.test.ts +266 -0
  203. package/src/node-peer-allowlist.test.ts +114 -0
  204. package/src/node-permissions-http.test.ts +901 -0
  205. package/src/node-permissions.ts +627 -0
  206. package/src/node-request-retention.test.ts +281 -0
  207. package/src/node-request-retention.ts +120 -0
  208. package/src/node-secret-rest-http.test.ts +190 -0
  209. package/src/node-secret-vault-inject.test.ts +132 -0
  210. package/src/node-security-write-gate.test.ts +72 -0
  211. package/src/node-serviceability.test.ts +86 -0
  212. package/src/node-serviceability.ts +124 -0
  213. package/src/node-session-control-http.test.ts +398 -0
  214. package/src/node-session-control.ts +316 -0
  215. package/src/node-skills-transport.test.ts +212 -0
  216. package/src/node-token-identity.ts +35 -0
  217. package/src/node-token-ownership.ts +51 -0
  218. package/src/node-token-privilege-http.test.ts +224 -0
  219. package/src/node-token-usage.test.ts +128 -0
  220. package/src/node-token-usage.ts +228 -0
  221. package/src/not-found-api-http.test.ts +67 -0
  222. package/src/observer-avatar-http.test.ts +103 -10
  223. package/src/observer-push.test.ts +76 -0
  224. package/src/opencode-catalog-report-http.test.ts +139 -0
  225. package/src/opencode-v2-catalog.test.ts +282 -0
  226. package/src/opencode-v2-catalog.ts +357 -0
  227. package/src/package-self-contained.test.ts +32 -0
  228. package/src/package-version-consistency.test.ts +25 -0
  229. package/src/parent-infer.test.ts +82 -0
  230. package/src/parent-infer.ts +110 -0
  231. package/src/parent-source-marker.test.ts +70 -0
  232. package/src/parent-source-orphan.test.ts +121 -0
  233. package/src/password-network-tokens.ts +25 -0
  234. package/src/peer-reply-atomic.test.ts +462 -0
  235. package/src/peer-reply-capability.test.ts +70 -0
  236. package/src/pg-worker.ts +87 -0
  237. package/src/poll-pacing.test.ts +74 -0
  238. package/src/poll-pacing.ts +123 -0
  239. package/src/probe-provider-error-domain.test.ts +145 -0
  240. package/src/project-dir-warn-clear-http.test.ts +132 -0
  241. package/src/project-viewer-can-http.test.ts +116 -0
  242. package/src/provider-skill-error-domain.test.ts +130 -0
  243. package/src/provider-tools-shape.test.ts +165 -0
  244. package/src/push.test.ts +20 -10
  245. package/src/push.ts +373 -9
  246. package/src/redact-tokens.test.ts +86 -0
  247. package/src/redact-tokens.ts +43 -0
  248. package/src/rejection-counters.test.ts +72 -0
  249. package/src/rejection-counters.ts +173 -0
  250. package/src/rename.ts +38 -10
  251. package/src/reply-target-derivation.test.ts +96 -0
  252. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  253. package/src/report-status-host-schema.test.ts +272 -0
  254. package/src/report-status-resume-id-handover.test.ts +184 -0
  255. package/src/report-status-secret-keys.test.ts +140 -0
  256. package/src/require-explicit-test-db.ts +9 -0
  257. package/src/requirement-due-reminders-http.test.ts +620 -0
  258. package/src/requirement-due-reminders.ts +416 -0
  259. package/src/requirement-events-http.test.ts +318 -0
  260. package/src/requirement-events.test.ts +45 -0
  261. package/src/requirement-events.ts +144 -0
  262. package/src/requirement-notify.ts +165 -0
  263. package/src/requirement-participant-notify-http.test.ts +313 -0
  264. package/src/requirement-tag-ops-http.test.ts +454 -0
  265. package/src/requirement-tag-tree-http.test.ts +275 -0
  266. package/src/requirement-tag-tree.ts +127 -0
  267. package/src/requirement-tags.ts +102 -0
  268. package/src/requirements-abandoned-http.test.ts +236 -0
  269. package/src/requirements-assignee-drift.test.ts +154 -0
  270. package/src/requirements-comment-http.test.ts +174 -0
  271. package/src/requirements-completed-at-migration.test.ts +70 -0
  272. package/src/requirements-errors-mcp-http.test.ts +164 -0
  273. package/src/requirements-errors.ts +158 -0
  274. package/src/requirements-etag-http.test.ts +91 -0
  275. package/src/requirements-http.test.ts +709 -0
  276. package/src/requirements-last-event-http.test.ts +349 -0
  277. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  278. package/src/requirements-list-slim-http.test.ts +324 -0
  279. package/src/requirements-mcp.test.ts +180 -0
  280. package/src/requirements-migrate.ts +283 -0
  281. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  282. package/src/requirements-people-http.test.ts +114 -0
  283. package/src/requirements-people-mcp-http.test.ts +231 -0
  284. package/src/requirements-people.ts +196 -0
  285. package/src/requirements-priority-lowest.test.ts +114 -0
  286. package/src/requirements-projects-network-echo.test.ts +57 -0
  287. package/src/requirements-projects-parent-http.test.ts +123 -0
  288. package/src/requirements-search-http.test.ts +182 -0
  289. package/src/requirements-search.test.ts +32 -0
  290. package/src/requirements-search.ts +145 -0
  291. package/src/requirements-seq-http.test.ts +193 -0
  292. package/src/requirements-seq-migration.test.ts +63 -0
  293. package/src/requirements-start-date.test.ts +125 -0
  294. package/src/requirements-stats-http.test.ts +357 -0
  295. package/src/requirements-stats.ts +195 -0
  296. package/src/requirements-status-participants-http.test.ts +222 -0
  297. package/src/requirements-upgrade-e2e.test.ts +126 -0
  298. package/src/requirements-upgrade-migration.test.ts +98 -0
  299. package/src/requirements.ts +2205 -0
  300. package/src/resolve-port.test.ts +57 -0
  301. package/src/resolve-port.ts +44 -0
  302. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  303. package/src/rest-alias-network-fallback.test.ts +60 -0
  304. package/src/rest-alias-network-fallback.ts +65 -0
  305. package/src/rest-explicit-columns-http.test.ts +266 -0
  306. package/src/rest-identity.test.ts +130 -0
  307. package/src/rest-identity.ts +141 -0
  308. package/src/rest-projections.ts +72 -0
  309. package/src/rest-read-network-real-chain.test.ts +97 -0
  310. package/src/rest-write-network-resolution.test.ts +133 -0
  311. package/src/restart-readiness-http.test.ts +121 -0
  312. package/src/restricted-files.ts +76 -0
  313. package/src/retention-first-sweep-quiet.test.ts +31 -0
  314. package/src/retention.test.ts +100 -40
  315. package/src/retention.ts +423 -104
  316. package/src/route-callers-http.test.ts +120 -0
  317. package/src/route-timing.test.ts +218 -0
  318. package/src/route-timing.ts +262 -0
  319. package/src/rules-file-duplicate-alias.test.ts +234 -0
  320. package/src/rules-file-session-target.test.ts +207 -0
  321. package/src/rules-file-transport.test.ts +280 -0
  322. package/src/runtime-label.test.ts +22 -0
  323. package/src/runtime-label.ts +21 -0
  324. package/src/runtime-readiness.ts +90 -0
  325. package/src/schedule-agent-mcp-http.test.ts +486 -0
  326. package/src/schedule-agent.ts +252 -0
  327. package/src/schedule-starved.test.ts +92 -0
  328. package/src/schedule-starved.ts +114 -0
  329. package/src/scheduled-backoff-http.test.ts +203 -0
  330. package/src/scheduled-backoff.ts +64 -0
  331. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  332. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  333. package/src/scheduled-failure-code.test.ts +73 -0
  334. package/src/scheduled-failure-code.ts +105 -0
  335. package/src/scheduled-failures-http.test.ts +279 -0
  336. package/src/scheduled-failures.ts +425 -0
  337. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  338. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  339. package/src/scheduled-offline.test.ts +131 -0
  340. package/src/scheduled-offline.ts +66 -0
  341. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  342. package/src/scheduled-outcome-guidance.ts +9 -0
  343. package/src/scheduled-reply-unread-http.test.ts +212 -0
  344. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  345. package/src/scheduled-requirement-wake.ts +125 -0
  346. package/src/scheduled-run-terminal.test.ts +290 -0
  347. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  348. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  349. package/src/scheduled-stuck-http.test.ts +316 -0
  350. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  351. package/src/scheduled-stuck.ts +219 -0
  352. package/src/scheduled-tasks-http.test.ts +679 -0
  353. package/src/scheduled-tasks.ts +980 -0
  354. package/src/scheduled-work-outcome-http.test.ts +154 -0
  355. package/src/scheduled-work-outcome.ts +50 -0
  356. package/src/scoped-secrets.ts +167 -0
  357. package/src/secret-echo-negative-control.test.ts +118 -0
  358. package/src/send-dedup-request-id.test.ts +229 -0
  359. package/src/send-reply-agent-warning.test.ts +38 -38
  360. package/src/send-reply-alias-optional.test.ts +131 -0
  361. package/src/send-reply-attachments.test.ts +28 -7
  362. package/src/send_dedup.test.ts +54 -0
  363. package/src/send_dedup.ts +52 -6
  364. package/src/serve-error.test.ts +73 -0
  365. package/src/serve-error.ts +56 -0
  366. package/src/server.ts +5103 -377
  367. package/src/session-fork-store.test.ts +43 -0
  368. package/src/session-fork-store.ts +51 -0
  369. package/src/session-project-attach-migration.test.ts +23 -0
  370. package/src/session-project-attach-native.test.ts +123 -0
  371. package/src/session-project-create-http.test.ts +408 -0
  372. package/src/session-project-create-native.test.ts +292 -0
  373. package/src/session-project-create.ts +159 -0
  374. package/src/session-source-admission-store.ts +58 -0
  375. package/src/session-source-create.test.ts +155 -0
  376. package/src/session-source-create.ts +97 -0
  377. package/src/session-source-delivery.ts +114 -0
  378. package/src/session-source-directory-http.test.ts +196 -0
  379. package/src/session-source-evidence.test.ts +905 -0
  380. package/src/session-source-evidence.ts +191 -0
  381. package/src/session-source-execution.ts +87 -0
  382. package/src/session-source-grant.test.ts +117 -0
  383. package/src/session-source-grant.ts +78 -0
  384. package/src/session-source-issuer.test.ts +250 -0
  385. package/src/session-source-issuer.ts +164 -0
  386. package/src/session-source-transport.ts +381 -0
  387. package/src/session-task-on-dispatch.ts +14 -0
  388. package/src/session-token-ownership-http.test.ts +122 -0
  389. package/src/shared/codex-inventory.ts +41 -0
  390. package/src/shared/daemon-provider-login.ts +31 -0
  391. package/src/shared/daemon-provider-snapshot.ts +52 -0
  392. package/src/shared/external-schedule-contract.ts +60 -0
  393. package/src/shared/node-name.test.ts +62 -0
  394. package/src/shared/node-name.ts +161 -0
  395. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  396. package/src/shared/provider-application.ts +29 -0
  397. package/src/shared/provider-collection.ts +14 -0
  398. package/src/shared/provider-initialization.ts +8 -0
  399. package/src/shared/reserved-env-drift.test.ts +10 -0
  400. package/src/shared/scoped-secret-contract.ts +5 -0
  401. package/src/shared/task-content-limit-drift.test.ts +28 -0
  402. package/src/shared/task-content-limit.ts +25 -0
  403. package/src/side-thread-command-transport.test.ts +312 -0
  404. package/src/side-thread-command-transport.ts +318 -0
  405. package/src/side-thread-http-integration.test.ts +233 -0
  406. package/src/side-thread-http.ts +504 -0
  407. package/src/side-thread-production.test.ts +72 -0
  408. package/src/side-thread-production.ts +118 -0
  409. package/src/side-thread.test.ts +1067 -0
  410. package/src/side-thread.ts +2499 -0
  411. package/src/skillhub-http.test.ts +144 -0
  412. package/src/sqlite-close-checkpoint.test.ts +78 -0
  413. package/src/start-node.test.ts +265 -0
  414. package/src/start-request-error-domain.test.ts +182 -0
  415. package/src/start-skill-error-domain.test.ts +122 -0
  416. package/src/stats-versions-http.test.ts +65 -0
  417. package/src/status-alias-filter-http.test.ts +106 -0
  418. package/src/status-alias-resolver-http.test.ts +163 -0
  419. package/src/status-alias-resolver.ts +19 -0
  420. package/src/status-node-id-filter-http.test.ts +161 -0
  421. package/src/status-node-secrets-capable-http.test.ts +44 -0
  422. package/src/status-read-cache-http.test.ts +229 -0
  423. package/src/status-read-cache.ts +129 -0
  424. package/src/stop-delete-node.test.ts +567 -1
  425. package/src/task-access-http.test.ts +407 -0
  426. package/src/task-access.ts +420 -0
  427. package/src/task-activity.ts +60 -0
  428. package/src/task-auth-origin-http.test.ts +93 -0
  429. package/src/task-auth-origin.test.ts +24 -0
  430. package/src/task-auth-origin.ts +7 -0
  431. package/src/task-consumption.test.ts +512 -0
  432. package/src/task-diagnostic-http.test.ts +149 -0
  433. package/src/task-diagnostic.test.ts +115 -0
  434. package/src/task-diagnostic.ts +118 -0
  435. package/src/task-expiry-notice-http.test.ts +298 -0
  436. package/src/task-expiry-notice.ts +318 -0
  437. package/src/task-idempotency-mcp.test.ts +148 -0
  438. package/src/task-idempotency.test.ts +76 -0
  439. package/src/task-idempotency.ts +81 -0
  440. package/src/task-late-replies.ts +54 -0
  441. package/src/task-late-reply-http.test.ts +227 -0
  442. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  443. package/src/task-lifecycle-watcher.test.ts +209 -0
  444. package/src/task-lifecycle-watcher.ts +109 -0
  445. package/src/task-network-resolution-http.test.ts +140 -0
  446. package/src/task-not-found-error-domain.test.ts +117 -0
  447. package/src/task-offline-delivery-2668.test.ts +119 -0
  448. package/src/task-offline-delivery.ts +81 -0
  449. package/src/task-orphan-http.test.ts +287 -0
  450. package/src/task-orphan.ts +119 -0
  451. package/src/task-queue-ahead-http.test.ts +309 -0
  452. package/src/task-queue-ahead-scale.test.ts +236 -0
  453. package/src/task-queue-ahead.ts +186 -0
  454. package/src/task-rejection-log-http.test.ts +160 -0
  455. package/src/task-rejection-log.ts +61 -0
  456. package/src/task-sender-http.test.ts +143 -0
  457. package/src/task-stale-open-http.test.ts +292 -0
  458. package/src/task-stale-open.ts +103 -0
  459. package/src/tasks-pagination-http.test.ts +141 -0
  460. package/src/team-rules-status-http.test.ts +90 -0
  461. package/src/team-rules-status.test.ts +59 -0
  462. package/src/team-rules-status.ts +72 -0
  463. package/src/test-work-root.ts +18 -0
  464. package/src/tmux-allowlist.test.ts +48 -0
  465. package/src/token-usage-http.test.ts +156 -0
  466. package/src/tool-audience-http.test.ts +266 -0
  467. package/src/tool-audience.ts +130 -0
  468. package/src/tools-list-json-schema.test.ts +94 -0
  469. package/src/tools.ts +4557 -472
  470. package/src/update-node-config-error-domain.test.ts +107 -0
  471. package/src/uploads-http.test.ts +6 -4
  472. package/src/uploads.ts +23 -4
  473. package/src/user-avatar-http.test.ts +74 -0
  474. package/src/user-avatar-image.ts +160 -0
  475. package/src/user-avatar-migration.test.ts +25 -0
  476. package/src/user-avatar-upload-http.test.ts +353 -0
  477. package/src/user-inbox-by-agent-http.test.ts +189 -0
  478. package/src/user-inbox-netid-notnull.test.ts +122 -0
  479. package/src/user-inbox-read-http.test.ts +223 -0
  480. package/src/user-inbox-schema.test.ts +54 -0
  481. package/src/version-stats.test.ts +66 -0
  482. package/src/version-stats.ts +109 -0
@@ -0,0 +1,132 @@
1
+ // #3148 —— 保险库的值要能**流向**真正要用的那个进程,但任何人仍然**读不出来**。
2
+ //
3
+ // admin 2026-11-01 在客户端里撞到的死结:
4
+ // 密钥已经在保险库里了,可没有任何路径把它送到目标节点;
5
+ // 于是人只能把明文再复制一遍,或者写进工作区文件 —— 两条都比保险库更差。
6
+ //
7
+ // 本文件的判据分两半,缺一半就只是「加了个功能」:
8
+ // ① 流向成立:owner/admin 只给键名,节点真的收到值(用节点侧 pull 来验,不靠内部字段)
9
+ // ② 读权不成立:任何读接口都不回值(getScopedSecrets / ack 回来的 snapshot / 响应体本身)
10
+ import './require-explicit-test-db';
11
+ import { afterAll, beforeEach, describe, expect, test } from 'bun:test';
12
+ import { db } from './db';
13
+ import { getScopedSecrets, pullNodeSecrets, ackNodeSecrets, requestNodeSecrets } from './scoped-secrets';
14
+ import { vaultUpsert, vaultListKeys, vaultDelete } from './vault';
15
+
16
+ const net = 'net_vaultinject';
17
+ const baseNode = 'n_vaultinject';
18
+ let node = baseNode;
19
+ const owner = 'u_vaultinject_owner';
20
+ const member = 'u_vaultinject_member';
21
+ const KEY = 'TMPAT';
22
+ const VALUE = 'pat-value-that-must-never-be-readable-0123456789';
23
+
24
+ function cleanup() {
25
+ db.run('DELETE FROM nodes WHERE network_id=?1', [net]);
26
+ db.run('DELETE FROM network_members WHERE network_id=?1', [net]);
27
+ db.run('DELETE FROM networks WHERE network_id=?1', [net]);
28
+ db.run('DELETE FROM users WHERE user_id IN (?1, ?2)', [owner, member]);
29
+ for (const k of vaultListKeys(net)) vaultDelete(net, k);
30
+ }
31
+
32
+ function makeNode(name: string) {
33
+ node = name;
34
+ db.run('INSERT INTO nodes(node_id,node_name,alias,network_id,config_snapshot) VALUES(?1,?1,?1,?2,?3)',
35
+ [node, net, JSON.stringify({ node_secrets_capable: true })]);
36
+ return node;
37
+ }
38
+
39
+ beforeEach(() => {
40
+ cleanup();
41
+ node = baseNode;
42
+ process.env.ANET_HUB_SECRET_VAULT_KEY = '43'.repeat(32);
43
+ db.run("INSERT INTO users(user_id,username,password_hash,role) VALUES(?1,?1,'x','user')", [owner]);
44
+ db.run("INSERT INTO users(user_id,username,password_hash,role) VALUES(?1,?1,'x','user')", [member]);
45
+ db.run('INSERT INTO networks(network_id,network_name,owner_id) VALUES(?1,?1,?2)', [net, owner]);
46
+ db.run("INSERT INTO network_members(user_id,network_id,role) VALUES(?1,?2,'owner')", [owner, net]);
47
+ db.run("INSERT INTO network_members(user_id,network_id,role) VALUES(?1,?2,'member')", [member, net]);
48
+ vaultUpsert(net, KEY, VALUE);
49
+ });
50
+ afterAll(cleanup);
51
+
52
+ const human = (userId: string) => ({ userId, isNode: false, networkId: net });
53
+ // 必须是函数:node 每个用例都不同,写成常量会把第一个用例的节点名焊死。
54
+ const asDaemon = () => ({ ok: true as const, networkId: net, daemonNodeId: node, daemonAlias: node });
55
+
56
+ /** 节点侧真正会收到的那个请求(不是内部字段:走 pullNodeSecrets 这条公开路径)。 */
57
+ function pulledFor(requestId: string) {
58
+ const pulled = pullNodeSecrets(asDaemon()) as any;
59
+ expect(pulled.ok).toBe(true);
60
+ return (pulled.requests as any[]).find((r) => r.request_id === requestId);
61
+ }
62
+
63
+ describe("#3148 保险库 → 节点:值能流过去,但读不回来", () => {
64
+ test("① 流向:owner 只给键名(from_vault),节点 pull 到的那条请求里带着保险库的值", () => {
65
+ makeNode("n_vi_flow");
66
+ const created = requestNodeSecrets(human(owner), node, 'put', KEY, undefined, 0, true) as any;
67
+ expect(created.ok).toBe(true);
68
+ const pulled = pulledFor(created.request_id);
69
+ expect(pulled).toBeDefined();
70
+ expect(pulled.action).toBe('put');
71
+ expect(pulled.key).toBe(KEY);
72
+ // 这一条是「值真的到了目标进程手上」——流向成立。
73
+ expect(pulled.value).toBe(VALUE);
74
+ });
75
+
76
+ test("② 读权:ack 回来的回执里只有键名与来源,没有任何值", () => {
77
+ makeNode("n_vi_ack");
78
+ const created = requestNodeSecrets(human(owner), node, 'put', KEY, undefined, 0, true) as any;
79
+ pulledFor(created.request_id);
80
+ const ack = ackNodeSecrets(asDaemon(), created.request_id, {
81
+ network_id: net, daemon_node_id: null, node_id: node, revision: 1, activation: 'next_start',
82
+ keys: [{ key: KEY, source: 'node' }],
83
+ }) as any;
84
+ expect(ack.ok).toBe(true);
85
+ expect(JSON.stringify(ack)).not.toContain(VALUE);
86
+ });
87
+
88
+ test("② 镜像否定:getScopedSecrets 的回执里没有值,也没有请求体里的明文", () => {
89
+ makeNode("n_vi_noread");
90
+ const created = requestNodeSecrets(human(owner), node, 'put', KEY, undefined, 0, true) as any;
91
+ const got = getScopedSecrets(human(owner), created.request_id) as any;
92
+ expect(got.ok).toBe(true);
93
+ expect(JSON.stringify(got)).not.toContain(VALUE);
94
+ expect(JSON.stringify(got)).not.toContain('"value"');
95
+ });
96
+
97
+ test("保险库里没有这个键 ⇒ vault_key_missing(不许回一个看起来成功的请求)", () => {
98
+ makeNode("n_vi_missing");
99
+ expect(requestNodeSecrets(human(owner), node, 'put', 'NOT_THERE', undefined, 0, true)).toEqual({
100
+ ok: false, error: 'vault_key_missing',
101
+ });
102
+ });
103
+
104
+ test("from_vault 只对 put 有意义:list / delete 用它是无效输入", () => {
105
+ makeNode("n_vi_list");
106
+ expect((requestNodeSecrets(human(owner), node, 'list', KEY, undefined, 0, true) as any).error).toBe('invalid_secret_input');
107
+ expect((requestNodeSecrets(human(owner), node, 'delete', KEY, undefined, 0, true) as any).error).toBe('invalid_secret_input');
108
+ });
109
+
110
+ test("同时给 value 与 from_vault ⇒ 无效输入(两种来源不许混用,否则说不清写进去的是哪一个)", () => {
111
+ makeNode("n_vi_mix");
112
+ expect((requestNodeSecrets(human(owner), node, 'put', KEY, 'another-value', 0, true) as any).error).toBe('invalid_secret_input');
113
+ });
114
+
115
+ test("普通成员用 from_vault ⇒ secret_admin_required(这是权限边界,不是能力边界)", () => {
116
+ makeNode("n_vi_member");
117
+ expect((requestNodeSecrets(human(member), node, 'put', KEY, undefined, 0, true) as any).error).toBe('secret_admin_required');
118
+ });
119
+
120
+ test("节点令牌(isNode)自己调 ⇒ user_token_required(机器不能给自己发密钥)", () => {
121
+ makeNode("n_vi_nodetoken");
122
+ expect((requestNodeSecrets({ userId: null, isNode: true, networkId: net }, node, 'put', KEY, undefined, 0, true) as any)
123
+ .error).toBe('user_token_required');
124
+ });
125
+
126
+ test("不支持的节点 ⇒ node_secrets_upgrade_required(先升级,不是先提权)", () => {
127
+ makeNode("n_vi_oldnode");
128
+ db.run('UPDATE nodes SET config_snapshot=?1 WHERE node_id=?2', [JSON.stringify({}), node]);
129
+ expect((requestNodeSecrets(human(owner), node, 'put', KEY, undefined, 0, true) as any).error)
130
+ .toBe('node_secrets_upgrade_required');
131
+ });
132
+ });
@@ -0,0 +1,72 @@
1
+ // #3314 — 「改节点安全配置」的授权判据必须是**一个具名函数**,并且比
2
+ // 「往网络里写」更严(member 不行)。
3
+ //
4
+ // 为什么需要这条测试:这两件事在调用点长得一样(都是 `if (!<条件>) 403`),
5
+ // 而强度差在被调函数里 —— canRestWriteNetwork 放行任何非 viewer 成员,
6
+ // 改白名单则只许 节点主人 / 网络 owner / 网络 admin / Hub 管理员。
7
+ // 一旦有人为了「统一写法」把它们合并,方向是**放宽**,而放宽不会让任何
8
+ // 现有测试变红:现有夹具全是 owner / admin 探针。
9
+ //
10
+ // 所以这里直接钉两件事:
11
+ // 1. 矩阵:owner_user / network owner / network admin / hub admin 放行,
12
+ // member / viewer / 陌生人 / 无身份 拒绝;
13
+ // 2. 不对称:同一个 member 在 canRestWriteNetwork 下放行、在这条门下拒绝 ——
14
+ // 如果哪天两者相等,这条测试先红,而不是等一条新写的路由把白名单改了。
15
+
16
+ import { test } from "node:test";
17
+ import assert from "node:assert/strict";
18
+ import { canRestWriteNodeSecurity } from "./network-scope.js";
19
+
20
+ const OWNER_ID = "u-node-owner";
21
+ const ADMIN_ID = "u-node-admin";
22
+ const MEMBER_ID = "u-member";
23
+ const VIEWER_ID = "u-viewer";
24
+ const STRANGER_ID = "u-stranger";
25
+
26
+ function ctx(userId: string) {
27
+ return { userId };
28
+ }
29
+
30
+ test("node security gate: 节点主人可以改", () => {
31
+ assert.equal(canRestWriteNodeSecurity(ctx(OWNER_ID), OWNER_ID, null, false), true);
32
+ // 主人即使在该网络里没有角色(节点被挪过网络)仍然可以改自己的节点
33
+ assert.equal(canRestWriteNodeSecurity(ctx(OWNER_ID), OWNER_ID, "member", false), true);
34
+ });
35
+
36
+ test("node security gate: 网络 owner / admin 可以改别人的节点", () => {
37
+ assert.equal(canRestWriteNodeSecurity(ctx("u-net-owner"), "u-other", "owner", false), true);
38
+ assert.equal(canRestWriteNodeSecurity(ctx("u-net-admin"), "u-other", "admin", false), true);
39
+ });
40
+
41
+ test("node security gate: Hub 管理员可以改(且不依赖任何角色)", () => {
42
+ assert.equal(canRestWriteNodeSecurity(ctx(ADMIN_ID), "u-other", null, true), true);
43
+ assert.equal(canRestWriteNodeSecurity(ctx(ADMIN_ID), null, null, true), true);
44
+ });
45
+
46
+ test("node security gate: 普通成员 / viewer / 陌生人 / 无身份 全部拒绝", () => {
47
+ assert.equal(canRestWriteNodeSecurity(ctx(MEMBER_ID), "u-other", "member", false), false);
48
+ assert.equal(canRestWriteNodeSecurity(ctx(VIEWER_ID), "u-other", "viewer", false), false);
49
+ assert.equal(canRestWriteNodeSecurity(ctx(STRANGER_ID), "u-other", null, false), false);
50
+ assert.equal(canRestWriteNodeSecurity(null, "u-other", "owner", false), false);
51
+ });
52
+
53
+ test("node security gate: 孤儿节点(owner_user_id 为 null)不会被任何人「顺走」", () => {
54
+ // 没有主人的节点只能由网络 owner/admin 或 Hub 管理员改;
55
+ // 否则任意登录用户都能认领一台陌生节点的安全配置。
56
+ assert.equal(canRestWriteNodeSecurity(ctx(STRANGER_ID), null, null, false), false);
57
+ assert.equal(canRestWriteNodeSecurity(ctx("u-net-admin"), null, "admin", false), true);
58
+ });
59
+
60
+ test("node security gate 比 canRestWriteNetwork 更严:member 是分界线", async () => {
61
+ // 这条断言的意义不是「两个函数都写对了」,而是「它们**不允许**相等」。
62
+ // 若有人把它们合并成一个,下面两行里必然有一行红。
63
+ const { canRestWriteNetworkAsHuman } = await import("./network-scope.js");
64
+ // canRestWriteNetworkAsHuman 对 member 放行(!== viewer),对 stranger 拒绝。
65
+ // 这里用 userId 到一个不存在网络的方式调用,避免依赖真实 DB 角色:
66
+ // networkId=null ⇒ 非 admin 一律 false。所以真正的不对称要在有角色的网络里比,
67
+ // 那需要 DB 夹具;本测试只钉住「两者不是同一个函数」这个形状。
68
+ assert.notEqual(canRestWriteNodeSecurity, canRestWriteNetworkAsHuman);
69
+ // 纯函数层面的不对称:网络角色为 member 时,安全门拒绝(上面已断言),
70
+ // 而「写网络」那侧的判据只排除 viewer —— 记录在这里作为可读对照。
71
+ assert.equal(canRestWriteNodeSecurity(ctx(MEMBER_ID), "u-other", "member", false), false);
72
+ });
@@ -0,0 +1,86 @@
1
+ // #2880 —— 节点级「不可服务」检测(默认关闭,只记录)。
2
+ import { describe, expect, test, beforeAll, afterAll } from "bun:test";
3
+ import { db } from "./db.js";
4
+ import { isNotServing, scanNodeBusyCircuit, nodeCanAcceptDispatch, circuitEnabled } from "./node-serviceability.js";
5
+
6
+ const NET = "net_circuit";
7
+
8
+ // 🔴 scheduled_task_runs 上有 UNIQUE(schedule_id, scheduled_for):
9
+ // 用 INSERT OR REPLACE 且 scheduled_for 相同 ⇒ 后一行会**替换**前一行,
10
+ // 于是 6 条「忙类失败」最后只剩 1 条,判据永远不成立。每条用不同的 minute 偏移。
11
+ function mkTaskAndRun(taskId: string, alias: string, status: string, result: string | null, runStatus: string, errorCode: string | null, minuteOffset = 0) {
12
+ db.run(
13
+ `INSERT OR REPLACE INTO tasks (task_id, content, from_name, to_name, network_id, status, result, created_at, completed_at)
14
+ VALUES (?1, 'x', 'hub', ?2, ?3, ?4, ?5, datetime('now'), datetime('now'))`,
15
+ [taskId, alias, NET, status, result],
16
+ );
17
+ db.run(
18
+ `INSERT OR REPLACE INTO scheduled_task_runs (run_id, schedule_id, network_id, scheduled_for, task_id, status, error_code, created_at)
19
+ VALUES (?1, 'sched_x', ?2, datetime('now', ?3), ?4, ?5, ?6, datetime('now'))`,
20
+ [`run_${taskId}`, NET, `-${minuteOffset + 1} minutes`, taskId, runStatus, errorCode],
21
+ );
22
+ }
23
+
24
+ const BUSY = "[n] opencode 任务未提交:共享会话在 30 分钟 内一直处于忙碌状态";
25
+
26
+ describe("节点忙熔断:三项判据", () => {
27
+ beforeAll(() => {
28
+ db.run("DELETE FROM scheduled_task_runs WHERE network_id = ?1", [NET]);
29
+ db.run("DELETE FROM tasks WHERE network_id = ?1", [NET]);
30
+ });
31
+ afterAll(() => {
32
+ db.run("DELETE FROM scheduled_task_runs WHERE network_id = ?1", [NET]);
33
+ db.run("DELETE FROM tasks WHERE network_id = ?1", [NET]);
34
+ delete process.env.COMMHUB_NODE_BUSY_CIRCUIT;
35
+ });
36
+
37
+ test("纯判定:忙类失败够多 + 零成功 + 有投递 ⇒ 不可服务", () => {
38
+ expect(isNotServing({ delivered: 10, replied: 0, busy_failed: 5 }, 5)).toBe(true);
39
+ expect(isNotServing({ delivered: 10, replied: 1, busy_failed: 9 }, 5)).toBe(false); // 成功过 = 等得到
40
+ expect(isNotServing({ delivered: 4, replied: 0, busy_failed: 4 }, 5)).toBe(false); // 证据不够
41
+ expect(isNotServing({ delivered: 0, replied: 0, busy_failed: 0 }, 5)).toBe(false); // 没投递过 ≠ 不可服务
42
+ });
43
+
44
+ test("扫描能把「零产出节点」挑出来,且有成功的节点不受影响", () => {
45
+ for (let i = 0; i < 6; i++) mkTaskAndRun(`t_bh_${i}`, "黑洞节点", "failed", BUSY, "failed", null, i);
46
+ for (let i = 0; i < 6; i++) mkTaskAndRun(`t_ok_${i}`, "正常节点", i < 3 ? "replied" : "failed", i < 3 ? "done" : BUSY, i < 3 ? "replied" : "failed", null, i + 10);
47
+ const r = scanNodeBusyCircuit();
48
+ expect(r.tripped).toContain("黑洞节点");
49
+ expect(r.tripped).not.toContain("正常节点");
50
+ expect(r.enabled).toBe(false); // 默认关闭
51
+ });
52
+
53
+ // 熔断后不能「永不投递」:否则节点拿不到成功记录 ⇒ 永远解不开(死锁)。
54
+ test("熔断期间按探针间隔放行一条(自愈通道)", () => {
55
+ process.env.COMMHUB_NODE_BUSY_CIRCUIT = "1";
56
+ // 黑洞节点:刚投递过 ⇒ 拦
57
+ db.run(`INSERT INTO tasks (task_id, content, from_name, to_name, network_id, status, created_at)
58
+ VALUES ('t_probe_now','x','hub','黑洞节点',?1,'failed',datetime('now'))`, [NET]);
59
+ const blocked = nodeCanAcceptDispatch("黑洞节点", NET);
60
+ expect(blocked.ok).toBe(false);
61
+ expect(blocked.probe).toBeUndefined();
62
+ // 把最近投递推到 2 小时前(默认探针间隔 1h)⇒ 放行,且标记 probe
63
+ // 注意:前面的用例也给这个节点插过 created_at=now 的任务,MAX(created_at) 会取到它们
64
+ db.run("UPDATE tasks SET created_at = datetime('now','-2 hours') WHERE to_name = '黑洞节点'");
65
+ const probe = nodeCanAcceptDispatch("黑洞节点", NET);
66
+ expect(probe.ok).toBe(true);
67
+ expect(probe.probe).toBe(true);
68
+ // 还原,避免影响后续用例(它们依赖「最近刚投递过」这个前态)
69
+ db.run("UPDATE tasks SET created_at = datetime('now') WHERE to_name = '黑洞节点'");
70
+ });
71
+
72
+ test("默认关闭时投递判断恒放行(不改任何既有行为)", () => {
73
+ delete process.env.COMMHUB_NODE_BUSY_CIRCUIT;
74
+ expect(circuitEnabled()).toBe(false);
75
+ expect(nodeCanAcceptDispatch("黑洞节点", NET).ok).toBe(true);
76
+ });
77
+
78
+ test("开启后才拦:黑洞节点被拒,正常节点仍放行", () => {
79
+ process.env.COMMHUB_NODE_BUSY_CIRCUIT = "1";
80
+ const bad = nodeCanAcceptDispatch("黑洞节点", NET);
81
+ expect(bad.ok).toBe(false);
82
+ expect(bad.reason ?? "").toContain("忙类失败");
83
+ expect(nodeCanAcceptDispatch("正常节点", NET).ok).toBe(true);
84
+ expect(nodeCanAcceptDispatch("不存在的节点", NET).ok).toBe(true); // 没数据就不拦
85
+ });
86
+ });
@@ -0,0 +1,124 @@
1
+ // #2880 —— 节点级「不可服务」检测。
2
+ //
3
+ // 生产 24h(2026-10-28 按节点统计定时任务产出):
4
+ // TMA云盘欧 ok= 0 busy=35 ← 全天零产出
5
+ // 通信客户端欧 ok= 22 busy=17 ← 等得到
6
+ // TMA需求欧 ok=140 busy=13 ← 等得到
7
+ // 通信欧 ok=192 busy= 0
8
+ //
9
+ // 结论:**「忙就快速失败」不能全局开**(会打掉别人等得到的那批成功),
10
+ // 但**节点级**的判断是安全的 —— 一个节点在窗口内「忙类失败很多、成功为零」,
11
+ // 才是「现在投进去必然白等 30 分钟」。
12
+ //
13
+ // 判据(三项同时成立,缺一不可):
14
+ // 1. 窗口内忙类失败 >= MIN_FAILS(默认 5)—— 证据量够
15
+ // 2. 窗口内成功 == 0 —— 不是「忙但能干成」
16
+ // 3. 窗口内至少有一次投递 —— 不会把「今天没排程」误判成不可服务
17
+ //
18
+ // 默认只记录(不改变任何派发行为)。开启 COMMHUB_NODE_BUSY_CIRCUIT=1 才把
19
+ // 「暂不投递」用于排程派发 —— 这一步是行为变更,所以留给人开。
20
+ import { db } from "./db.js";
21
+
22
+ function envInt(name: string, fallback: number, min: number): number {
23
+ const raw = process.env[name];
24
+ if (raw === undefined || raw.trim() === "") return fallback;
25
+ const n = Number(raw);
26
+ return Number.isFinite(n) && n >= min ? Math.floor(n) : fallback;
27
+ }
28
+
29
+ export function circuitEnabled(): boolean {
30
+ return String(process.env.COMMHUB_NODE_BUSY_CIRCUIT ?? "").trim() === "1";
31
+ }
32
+ export function circuitWindowHours(): number { return envInt("COMMHUB_NODE_BUSY_CIRCUIT_HOURS", 6, 1); }
33
+ export function circuitMinFails(): number { return envInt("COMMHUB_NODE_BUSY_CIRCUIT_FAILS", 5, 1); }
34
+ /**
35
+ * 熔断期间**放探针**的间隔(小时)。
36
+ *
37
+ * 🔴 为什么必须有:熔断后完全不再投递 ⇒ 节点永远拿不到成功记录 ⇒ 永远解不开(死锁)。
38
+ * 所以每 N 小时放一条探针任务:它若成功,replied 计数不再为 0,熔断自动解除。
39
+ */
40
+ export function circuitProbeHours(): number { return envInt("COMMHUB_NODE_BUSY_CIRCUIT_PROBE_HOURS", 1, 1); }
41
+
42
+ /** 该节点最近一次**被投递**的时刻(ms)。没有投递过返回 null。 */
43
+ function lastDeliveryMs(alias: string, networkId: string | null): number | null {
44
+ try {
45
+ const row = db.get<{ t: string | null }>(
46
+ "SELECT MAX(created_at) AS t FROM tasks WHERE to_name = ?1 AND (?2 IS NULL OR network_id = ?2)",
47
+ alias, networkId,
48
+ );
49
+ if (!row?.t) return null;
50
+ const ms = Date.parse(String(row.t).replace(" ", "T") + "Z");
51
+ return Number.isFinite(ms) ? ms : null;
52
+ } catch {
53
+ return null;
54
+ }
55
+ }
56
+
57
+ export type NodeServingStats = { alias: string; network_id: string | null; delivered: number; replied: number; busy_failed: number };
58
+
59
+ /** 纯函数:三项判据同时成立才算「不可服务」。 */
60
+ export function isNotServing(
61
+ s: { delivered: number; replied: number; busy_failed: number },
62
+ minFails = circuitMinFails(),
63
+ ): boolean {
64
+ return s.busy_failed >= minFails && s.replied === 0 && s.delivered > 0;
65
+ }
66
+
67
+ export type CircuitScanResult = { tripped: string[]; enabled: boolean; windowHours: number };
68
+
69
+ export function scanNodeBusyCircuit(now = new Date()): CircuitScanResult {
70
+ const windowHours = circuitWindowHours();
71
+ const since = new Date(now.getTime() - windowHours * 3_600_000).toISOString().slice(0, 19).replace("T", " ");
72
+ const rows = db.all<{ alias: string; network_id: string | null; delivered: number; replied: number; busy_failed: number }>(
73
+ `SELECT t.to_name AS alias,
74
+ t.network_id AS network_id,
75
+ COUNT(*) AS delivered,
76
+ SUM(CASE WHEN r.status = 'replied' THEN 1 ELSE 0 END) AS replied,
77
+ SUM(CASE WHEN r.status = 'failed'
78
+ AND (r.error_code = 'task_failed_busy' OR t.result LIKE '%共享会话%')
79
+ THEN 1 ELSE 0 END) AS busy_failed
80
+ FROM scheduled_task_runs r
81
+ JOIN tasks t ON t.task_id = r.task_id
82
+ WHERE r.created_at >= ?1 AND t.to_name IS NOT NULL
83
+ GROUP BY t.to_name, t.network_id`,
84
+ since,
85
+ );
86
+ const tripped = rows.filter((r) => isNotServing(r)).map((r) => r.alias);
87
+ return { tripped, enabled: circuitEnabled(), windowHours };
88
+ }
89
+
90
+ /**
91
+ * 这个节点现在能不能投递。默认永远 true(未开启 = 不拦截)。
92
+ * 供排程派发判断;纯读,不改任何状态。
93
+ */
94
+ export function nodeCanAcceptDispatch(alias: string, networkId: string | null): { ok: boolean; reason?: string; busy_failed?: number; probe?: boolean } {
95
+ if (!circuitEnabled()) return { ok: true };
96
+ const windowHours = circuitWindowHours();
97
+ const since = new Date(Date.now() - windowHours * 3_600_000).toISOString().slice(0, 19).replace("T", " ");
98
+ const row = db.get<{ delivered: number; replied: number; busy_failed: number }>(
99
+ `SELECT COUNT(*) AS delivered,
100
+ SUM(CASE WHEN r.status = 'replied' THEN 1 ELSE 0 END) AS replied,
101
+ SUM(CASE WHEN r.status = 'failed'
102
+ AND (r.error_code = 'task_failed_busy' OR t.result LIKE '%共享会话%')
103
+ THEN 1 ELSE 0 END) AS busy_failed
104
+ FROM scheduled_task_runs r
105
+ JOIN tasks t ON t.task_id = r.task_id
106
+ WHERE r.created_at >= ?1 AND t.to_name = ?2
107
+ AND (?3 IS NULL OR t.network_id = ?3)`,
108
+ since, alias, networkId,
109
+ );
110
+ if (!row) return { ok: true };
111
+ const stats = { delivered: Number(row.delivered ?? 0), replied: Number(row.replied ?? 0), busy_failed: Number(row.busy_failed ?? 0) };
112
+ if (!isNotServing(stats)) return { ok: true };
113
+ // 熔断期间每 N 小时放一条探针,否则节点永远拿不到成功记录、永远解不开。
114
+ const probeHours = circuitProbeHours();
115
+ const last = lastDeliveryMs(alias, networkId);
116
+ if (last === null || Date.now() - last >= probeHours * 3_600_000) {
117
+ return { ok: true, probe: true, busy_failed: stats.busy_failed };
118
+ }
119
+ return {
120
+ ok: false,
121
+ reason: `节点近 ${windowHours}h 内 ${stats.busy_failed} 次忙类失败、0 次成功(投递也只会白等),已跳过`,
122
+ busy_failed: stats.busy_failed,
123
+ };
124
+ }