@sleep2agi/commhub-server 0.9.0-preview.26 → 0.9.0-preview.261

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 (431) 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 +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 +680 -0
  15. package/src/agent-acl-slice3-http.test.ts +885 -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 +131 -4
  30. package/src/auth-abuse-counters.test.ts +144 -0
  31. package/src/auth-abuse-counters.ts +122 -0
  32. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  33. package/src/auth-sessions-http.test.ts +260 -0
  34. package/src/auth-validate.test.ts +5 -1
  35. package/src/auth-weak-password-login.test.ts +176 -0
  36. package/src/auth.ts +609 -56
  37. package/src/backfill-node-ids-2664.test.ts +128 -0
  38. package/src/binding-generation-http.test.ts +141 -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-commit-report-http.test.ts +128 -0
  43. package/src/build-info.test.ts +60 -0
  44. package/src/build-info.ts +85 -0
  45. package/src/chain-attempt-dedup.test.ts +447 -0
  46. package/src/clip.test.ts +36 -0
  47. package/src/clip.ts +48 -0
  48. package/src/clone-node.test.ts +269 -0
  49. package/src/clone-node.ts +289 -0
  50. package/src/codex-config-flags.ts +77 -0
  51. package/src/codex-fork-contract.ts +23 -0
  52. package/src/codex-fork-migration.test.ts +38 -0
  53. package/src/commhub-bin-args.test.ts +85 -0
  54. package/src/config-apply-validate.test.ts +188 -1
  55. package/src/config-apply-validate.ts +222 -3
  56. package/src/cors-origins.test.ts +73 -0
  57. package/src/create-node-blocked-gate.test.ts +365 -0
  58. package/src/create-node-error-domain.test.ts +127 -0
  59. package/src/create-node-network-id.test.ts +91 -0
  60. package/src/create-node-tool-schema.test.ts +49 -0
  61. package/src/create-node-unicode-name.test.ts +126 -0
  62. package/src/create-node-validate.test.ts +199 -7
  63. package/src/create-node-validate.ts +232 -15
  64. package/src/create-node-workdir.test.ts +298 -0
  65. package/src/create-node.ts +88 -23
  66. package/src/daemon-provider-snapshots.test.ts +453 -0
  67. package/src/daemon-provider-snapshots.ts +327 -0
  68. package/src/daemon-token-owner-http.test.ts +346 -0
  69. package/src/dashboard-slash-routing-http.test.ts +109 -0
  70. package/src/db-adapter-guard.test.ts +148 -0
  71. package/src/db-adapter-translate.test.ts +128 -0
  72. package/src/db-adapter.ts +377 -91
  73. package/src/db-timestamp.test.ts +38 -0
  74. package/src/db-timestamp.ts +15 -0
  75. package/src/db.ts +1269 -153
  76. package/src/delivered-without-push.test.ts +140 -0
  77. package/src/department-groups-http.test.ts +209 -0
  78. package/src/department-groups-sync-http.test.ts +328 -0
  79. package/src/department-groups.ts +434 -0
  80. package/src/department-heads-http.test.ts +350 -0
  81. package/src/department-heads.ts +226 -0
  82. package/src/departments-agent-count.test.ts +139 -0
  83. package/src/departments-http.test.ts +185 -0
  84. package/src/departments-mcp-error-domain.test.ts +135 -0
  85. package/src/departments-mcp.test.ts +128 -0
  86. package/src/departments.ts +318 -0
  87. package/src/desktop-message-seam.test.ts +150 -0
  88. package/src/desktop-message.test.ts +368 -0
  89. package/src/dm-file-scope-http.test.ts +178 -0
  90. package/src/empty-node-sweeper.test.ts +104 -0
  91. package/src/empty-node-sweeper.ts +88 -0
  92. package/src/env-transport-gate-http.test.ts +240 -0
  93. package/src/env-transport-gate.ts +80 -0
  94. package/src/env-transport-policy.ts +56 -0
  95. package/src/etag-of.test.ts +57 -0
  96. package/src/event-loop-lag.test.ts +180 -0
  97. package/src/event-loop-lag.ts +201 -0
  98. package/src/expiry-counters.test.ts +187 -0
  99. package/src/expiry-counters.ts +227 -0
  100. package/src/expiry-evidence-db.test.ts +103 -0
  101. package/src/ext-token-shared.test.ts +60 -0
  102. package/src/ext-validation-regression.test.ts +10 -17
  103. package/src/external-schedule-edits-http.test.ts +321 -0
  104. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  105. package/src/external-schedule-edits.ts +327 -0
  106. package/src/file-download-authz-dev-open.test.ts +1 -1
  107. package/src/file-download-authz.test.ts +25 -4
  108. package/src/file-download-date-bucket.test.ts +1 -1
  109. package/src/file-network-scope-dev-open.test.ts +1 -1
  110. package/src/file-network-scope.test.ts +7 -6
  111. package/src/group-membership-events-http.test.ts +264 -0
  112. package/src/group-messages-http.test.ts +483 -0
  113. package/src/group-messages.ts +297 -0
  114. package/src/health-anon-readers.ts +67 -0
  115. package/src/health-host-disk-2756.test.ts +71 -0
  116. package/src/health-redaction.test.ts +1576 -7
  117. package/src/host-supervisor-identity-http.test.ts +152 -0
  118. package/src/host-supervisor-identity.ts +92 -0
  119. package/src/host-supervisors-daemon-version.test.ts +137 -0
  120. package/src/http-gzip.test.ts +94 -0
  121. package/src/http-gzip.ts +112 -0
  122. package/src/hub-catalog-read-http.test.ts +641 -0
  123. package/src/hub-provider-config.test.ts +166 -0
  124. package/src/hub-provider-config.ts +202 -0
  125. package/src/hub-timestamp.test.ts +38 -0
  126. package/src/hub-timestamp.ts +27 -0
  127. package/src/human-dm.ts +215 -0
  128. package/src/human-inbox.ts +42 -0
  129. package/src/inbox-caller.ts +49 -0
  130. package/src/inbox-count-sse.test.ts +318 -0
  131. package/src/inbox-count.ts +29 -0
  132. package/src/index.ts +6 -2
  133. package/src/license-state.test.ts +56 -0
  134. package/src/license-state.ts +48 -0
  135. package/src/lifecycle-error-domain.test.ts +149 -0
  136. package/src/list-ack-error-domain.test.ts +108 -0
  137. package/src/list-host-supervisors.test.ts +15 -4
  138. package/src/mcp-context-cost-http.test.ts +127 -0
  139. package/src/mcp-inflight.test.ts +92 -0
  140. package/src/mcp-inflight.ts +38 -0
  141. package/src/mcp-projects-events-http.test.ts +168 -0
  142. package/src/mcp-route-label-http.test.ts +120 -0
  143. package/src/mcp-write-network-resolution.test.ts +21 -0
  144. package/src/member-audit-network-id-http.test.ts +93 -0
  145. package/src/member-presence-http.test.ts +210 -0
  146. package/src/messages-ack-by-agent-http.test.ts +142 -0
  147. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  148. package/src/migrate-sqlite-to-pg.ts +263 -0
  149. package/src/model-auth-notify-http.test.ts +181 -0
  150. package/src/model-auth-notify.ts +116 -0
  151. package/src/network-name-http.test.ts +75 -0
  152. package/src/network-rules-http.test.ts +169 -0
  153. package/src/network-rules.ts +129 -0
  154. package/src/network-scope.ts +222 -3
  155. package/src/network-token-membership-http.test.ts +186 -0
  156. package/src/node-alias-control.ts +12 -0
  157. package/src/node-attrs.test.ts +47 -2
  158. package/src/node-caller-identity-http.test.ts +1108 -0
  159. package/src/node-create-request-status-http.test.ts +105 -0
  160. package/src/node-daemon-bindings.test.ts +142 -0
  161. package/src/node-daemon-bindings.ts +135 -0
  162. package/src/node-failure-alert.test.ts +150 -0
  163. package/src/node-failure-alert.ts +177 -0
  164. package/src/node-files-transport.test.ts +350 -0
  165. package/src/node-health-codex-login.test.ts +120 -0
  166. package/src/node-health-dispatch-http.test.ts +373 -0
  167. package/src/node-health-guard.ts +121 -0
  168. package/src/node-health-passthrough.test.ts +115 -0
  169. package/src/node-health-store.ts +101 -0
  170. package/src/node-id-alias.test.ts +190 -0
  171. package/src/node-identity-conflict-http.test.ts +269 -0
  172. package/src/node-identity-conflict.ts +142 -0
  173. package/src/node-identity-mismatch.test.ts +74 -0
  174. package/src/node-in-flight-tasks.ts +31 -0
  175. package/src/node-lifecycle-controllable.test.ts +64 -0
  176. package/src/node-lifecycle-controllable.ts +53 -0
  177. package/src/node-lifecycle-read-http.test.ts +257 -0
  178. package/src/node-lifecycle-read.ts +124 -0
  179. package/src/node-logs-transport.test.ts +266 -0
  180. package/src/node-peer-allowlist.test.ts +114 -0
  181. package/src/node-permissions-http.test.ts +728 -0
  182. package/src/node-permissions.ts +494 -0
  183. package/src/node-request-retention.test.ts +281 -0
  184. package/src/node-request-retention.ts +120 -0
  185. package/src/node-secret-rest-http.test.ts +190 -0
  186. package/src/node-security-write-gate.test.ts +72 -0
  187. package/src/node-serviceability.test.ts +86 -0
  188. package/src/node-serviceability.ts +124 -0
  189. package/src/node-session-control-http.test.ts +310 -0
  190. package/src/node-session-control.ts +258 -0
  191. package/src/node-skills-transport.test.ts +212 -0
  192. package/src/node-token-identity.ts +35 -0
  193. package/src/node-token-ownership.ts +51 -0
  194. package/src/node-token-privilege-http.test.ts +158 -0
  195. package/src/not-found-api-http.test.ts +67 -0
  196. package/src/observer-avatar-http.test.ts +103 -10
  197. package/src/observer-push.test.ts +76 -0
  198. package/src/opencode-catalog-report-http.test.ts +139 -0
  199. package/src/opencode-v2-catalog.test.ts +268 -0
  200. package/src/opencode-v2-catalog.ts +356 -0
  201. package/src/package-version-consistency.test.ts +25 -0
  202. package/src/parent-infer.test.ts +82 -0
  203. package/src/parent-infer.ts +110 -0
  204. package/src/parent-source-marker.test.ts +70 -0
  205. package/src/password-network-tokens.ts +25 -0
  206. package/src/peer-reply-atomic.test.ts +462 -0
  207. package/src/peer-reply-capability.test.ts +70 -0
  208. package/src/pg-worker.ts +87 -0
  209. package/src/poll-pacing.test.ts +74 -0
  210. package/src/poll-pacing.ts +123 -0
  211. package/src/probe-provider-error-domain.test.ts +145 -0
  212. package/src/project-dir-warn-clear-http.test.ts +132 -0
  213. package/src/project-viewer-can-http.test.ts +116 -0
  214. package/src/provider-skill-error-domain.test.ts +130 -0
  215. package/src/provider-tools-shape.test.ts +165 -0
  216. package/src/push.test.ts +20 -10
  217. package/src/push.ts +373 -9
  218. package/src/redact-tokens.test.ts +86 -0
  219. package/src/redact-tokens.ts +43 -0
  220. package/src/rejection-counters.test.ts +72 -0
  221. package/src/rejection-counters.ts +173 -0
  222. package/src/rename.ts +38 -10
  223. package/src/reply-target-derivation.test.ts +96 -0
  224. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  225. package/src/report-status-host-schema.test.ts +235 -0
  226. package/src/report-status-resume-id-handover.test.ts +184 -0
  227. package/src/report-status-secret-keys.test.ts +140 -0
  228. package/src/require-explicit-test-db.ts +9 -0
  229. package/src/requirement-due-reminders-http.test.ts +620 -0
  230. package/src/requirement-due-reminders.ts +416 -0
  231. package/src/requirement-events-http.test.ts +318 -0
  232. package/src/requirement-events.test.ts +45 -0
  233. package/src/requirement-events.ts +144 -0
  234. package/src/requirement-notify.ts +165 -0
  235. package/src/requirement-participant-notify-http.test.ts +313 -0
  236. package/src/requirement-tag-ops-http.test.ts +454 -0
  237. package/src/requirement-tag-tree-http.test.ts +275 -0
  238. package/src/requirement-tag-tree.ts +127 -0
  239. package/src/requirement-tags.ts +102 -0
  240. package/src/requirements-abandoned-http.test.ts +236 -0
  241. package/src/requirements-assignee-drift.test.ts +154 -0
  242. package/src/requirements-comment-http.test.ts +174 -0
  243. package/src/requirements-completed-at-migration.test.ts +70 -0
  244. package/src/requirements-errors-mcp-http.test.ts +164 -0
  245. package/src/requirements-errors.ts +158 -0
  246. package/src/requirements-etag-http.test.ts +91 -0
  247. package/src/requirements-http.test.ts +709 -0
  248. package/src/requirements-last-event-http.test.ts +349 -0
  249. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  250. package/src/requirements-list-slim-http.test.ts +324 -0
  251. package/src/requirements-mcp.test.ts +180 -0
  252. package/src/requirements-migrate.ts +283 -0
  253. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  254. package/src/requirements-people-http.test.ts +114 -0
  255. package/src/requirements-people-mcp-http.test.ts +231 -0
  256. package/src/requirements-people.ts +196 -0
  257. package/src/requirements-priority-lowest.test.ts +114 -0
  258. package/src/requirements-projects-network-echo.test.ts +57 -0
  259. package/src/requirements-projects-parent-http.test.ts +123 -0
  260. package/src/requirements-search-http.test.ts +182 -0
  261. package/src/requirements-search.test.ts +32 -0
  262. package/src/requirements-search.ts +145 -0
  263. package/src/requirements-seq-http.test.ts +193 -0
  264. package/src/requirements-seq-migration.test.ts +63 -0
  265. package/src/requirements-start-date.test.ts +125 -0
  266. package/src/requirements-stats-http.test.ts +357 -0
  267. package/src/requirements-stats.ts +195 -0
  268. package/src/requirements-status-participants-http.test.ts +222 -0
  269. package/src/requirements-upgrade-e2e.test.ts +126 -0
  270. package/src/requirements-upgrade-migration.test.ts +98 -0
  271. package/src/requirements.ts +2205 -0
  272. package/src/resolve-port.test.ts +57 -0
  273. package/src/resolve-port.ts +44 -0
  274. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  275. package/src/rest-alias-network-fallback.test.ts +60 -0
  276. package/src/rest-alias-network-fallback.ts +65 -0
  277. package/src/rest-explicit-columns-http.test.ts +266 -0
  278. package/src/rest-identity.test.ts +130 -0
  279. package/src/rest-identity.ts +141 -0
  280. package/src/rest-projections.ts +72 -0
  281. package/src/rest-read-network-real-chain.test.ts +97 -0
  282. package/src/rest-write-network-resolution.test.ts +133 -0
  283. package/src/restart-readiness-http.test.ts +121 -0
  284. package/src/restricted-files.ts +76 -0
  285. package/src/retention-first-sweep-quiet.test.ts +31 -0
  286. package/src/retention.test.ts +100 -40
  287. package/src/retention.ts +423 -104
  288. package/src/route-callers-http.test.ts +120 -0
  289. package/src/route-timing.test.ts +218 -0
  290. package/src/route-timing.ts +262 -0
  291. package/src/rules-file-duplicate-alias.test.ts +234 -0
  292. package/src/rules-file-session-target.test.ts +207 -0
  293. package/src/rules-file-transport.test.ts +271 -0
  294. package/src/runtime-label.test.ts +22 -0
  295. package/src/runtime-label.ts +21 -0
  296. package/src/runtime-readiness.ts +90 -0
  297. package/src/schedule-agent-mcp-http.test.ts +486 -0
  298. package/src/schedule-agent.ts +252 -0
  299. package/src/schedule-starved.test.ts +92 -0
  300. package/src/schedule-starved.ts +114 -0
  301. package/src/scheduled-backoff-http.test.ts +203 -0
  302. package/src/scheduled-backoff.ts +64 -0
  303. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  304. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  305. package/src/scheduled-failure-code.test.ts +73 -0
  306. package/src/scheduled-failure-code.ts +105 -0
  307. package/src/scheduled-failures-http.test.ts +279 -0
  308. package/src/scheduled-failures.ts +425 -0
  309. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  310. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  311. package/src/scheduled-offline.test.ts +131 -0
  312. package/src/scheduled-offline.ts +66 -0
  313. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  314. package/src/scheduled-outcome-guidance.ts +9 -0
  315. package/src/scheduled-reply-unread-http.test.ts +212 -0
  316. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  317. package/src/scheduled-requirement-wake.ts +125 -0
  318. package/src/scheduled-run-terminal.test.ts +290 -0
  319. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  320. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  321. package/src/scheduled-stuck-http.test.ts +316 -0
  322. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  323. package/src/scheduled-stuck.ts +219 -0
  324. package/src/scheduled-tasks-http.test.ts +679 -0
  325. package/src/scheduled-tasks.ts +959 -0
  326. package/src/scheduled-work-outcome-http.test.ts +154 -0
  327. package/src/scheduled-work-outcome.ts +50 -0
  328. package/src/scoped-secrets.ts +141 -0
  329. package/src/secret-echo-negative-control.test.ts +118 -0
  330. package/src/send-dedup-request-id.test.ts +229 -0
  331. package/src/send-reply-agent-warning.test.ts +38 -38
  332. package/src/send-reply-alias-optional.test.ts +131 -0
  333. package/src/send-reply-attachments.test.ts +28 -7
  334. package/src/send_dedup.test.ts +54 -0
  335. package/src/send_dedup.ts +52 -6
  336. package/src/serve-error.test.ts +73 -0
  337. package/src/serve-error.ts +56 -0
  338. package/src/server.ts +4846 -325
  339. package/src/session-task-on-dispatch.ts +14 -0
  340. package/src/session-token-ownership-http.test.ts +122 -0
  341. package/src/shared/codex-inventory.ts +41 -0
  342. package/src/shared/daemon-provider-login.ts +31 -0
  343. package/src/shared/daemon-provider-snapshot.ts +52 -0
  344. package/src/shared/external-schedule-contract.ts +60 -0
  345. package/src/shared/node-name.test.ts +62 -0
  346. package/src/shared/node-name.ts +161 -0
  347. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  348. package/src/shared/provider-application.ts +29 -0
  349. package/src/shared/provider-collection.ts +14 -0
  350. package/src/shared/provider-initialization.ts +8 -0
  351. package/src/shared/reserved-env-drift.test.ts +10 -0
  352. package/src/shared/scoped-secret-contract.ts +5 -0
  353. package/src/shared/task-content-limit-drift.test.ts +28 -0
  354. package/src/shared/task-content-limit.ts +25 -0
  355. package/src/side-thread-command-transport.test.ts +312 -0
  356. package/src/side-thread-command-transport.ts +318 -0
  357. package/src/side-thread-http-integration.test.ts +233 -0
  358. package/src/side-thread-http.ts +504 -0
  359. package/src/side-thread-production.test.ts +72 -0
  360. package/src/side-thread-production.ts +118 -0
  361. package/src/side-thread.test.ts +1067 -0
  362. package/src/side-thread.ts +2499 -0
  363. package/src/skillhub-http.test.ts +144 -0
  364. package/src/sqlite-close-checkpoint.test.ts +78 -0
  365. package/src/start-node.test.ts +265 -0
  366. package/src/start-request-error-domain.test.ts +182 -0
  367. package/src/start-skill-error-domain.test.ts +122 -0
  368. package/src/stats-versions-http.test.ts +65 -0
  369. package/src/status-alias-filter-http.test.ts +106 -0
  370. package/src/status-alias-resolver-http.test.ts +163 -0
  371. package/src/status-alias-resolver.ts +19 -0
  372. package/src/status-node-id-filter-http.test.ts +161 -0
  373. package/src/status-read-cache-http.test.ts +229 -0
  374. package/src/status-read-cache.ts +129 -0
  375. package/src/stop-delete-node.test.ts +567 -1
  376. package/src/task-access-http.test.ts +402 -0
  377. package/src/task-access.ts +420 -0
  378. package/src/task-activity.ts +60 -0
  379. package/src/task-auth-origin-http.test.ts +93 -0
  380. package/src/task-auth-origin.test.ts +24 -0
  381. package/src/task-auth-origin.ts +7 -0
  382. package/src/task-consumption.test.ts +508 -0
  383. package/src/task-diagnostic-http.test.ts +149 -0
  384. package/src/task-diagnostic.test.ts +115 -0
  385. package/src/task-diagnostic.ts +118 -0
  386. package/src/task-expiry-notice-http.test.ts +298 -0
  387. package/src/task-expiry-notice.ts +318 -0
  388. package/src/task-idempotency-mcp.test.ts +148 -0
  389. package/src/task-idempotency.test.ts +76 -0
  390. package/src/task-idempotency.ts +81 -0
  391. package/src/task-late-replies.ts +54 -0
  392. package/src/task-late-reply-http.test.ts +227 -0
  393. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  394. package/src/task-lifecycle-watcher.test.ts +209 -0
  395. package/src/task-lifecycle-watcher.ts +109 -0
  396. package/src/task-network-resolution-http.test.ts +140 -0
  397. package/src/task-not-found-error-domain.test.ts +114 -0
  398. package/src/task-offline-delivery-2668.test.ts +119 -0
  399. package/src/task-offline-delivery.ts +81 -0
  400. package/src/task-orphan-http.test.ts +287 -0
  401. package/src/task-orphan.ts +119 -0
  402. package/src/task-queue-ahead-http.test.ts +309 -0
  403. package/src/task-queue-ahead-scale.test.ts +236 -0
  404. package/src/task-queue-ahead.ts +186 -0
  405. package/src/task-rejection-log-http.test.ts +160 -0
  406. package/src/task-rejection-log.ts +61 -0
  407. package/src/task-sender-http.test.ts +143 -0
  408. package/src/task-stale-open-http.test.ts +292 -0
  409. package/src/task-stale-open.ts +103 -0
  410. package/src/tasks-pagination-http.test.ts +141 -0
  411. package/src/team-rules-status-http.test.ts +90 -0
  412. package/src/team-rules-status.test.ts +59 -0
  413. package/src/team-rules-status.ts +72 -0
  414. package/src/tmux-allowlist.test.ts +48 -0
  415. package/src/tool-audience-http.test.ts +248 -0
  416. package/src/tool-audience.ts +127 -0
  417. package/src/tools-list-json-schema.test.ts +94 -0
  418. package/src/tools.ts +4229 -397
  419. package/src/update-node-config-error-domain.test.ts +107 -0
  420. package/src/uploads-http.test.ts +6 -4
  421. package/src/uploads.ts +23 -4
  422. package/src/user-avatar-http.test.ts +74 -0
  423. package/src/user-avatar-image.ts +160 -0
  424. package/src/user-avatar-migration.test.ts +25 -0
  425. package/src/user-avatar-upload-http.test.ts +348 -0
  426. package/src/user-inbox-by-agent-http.test.ts +165 -0
  427. package/src/user-inbox-netid-notnull.test.ts +122 -0
  428. package/src/user-inbox-read-http.test.ts +223 -0
  429. package/src/user-inbox-schema.test.ts +54 -0
  430. package/src/version-stats.test.ts +66 -0
  431. package/src/version-stats.ts +109 -0
@@ -0,0 +1,252 @@
1
+ // Board #733 — Agents manage Hub scheduled tasks over MCP (schedule_* tools in tools.ts).
2
+ //
3
+ // REST /api/scheduled-tasks stays people-only (node tokens → 403 user_token_required). This module is the
4
+ // agent surface; every validation / write goes through the same helpers as REST (scheduled-tasks.ts).
5
+ //
6
+ // Permission model (node token = one bound node in one network):
7
+ // • Scope: only schedules in the token's network that TARGET this node or that this node CREATED
8
+ // (created_by_node_id). Anything else reads as schedule_not_found (no existence probe).
9
+ // • Write gate: the owner must be able to write in the network (same canWrite as send_task), and a
10
+ // read-only node (permission_mode=readonly) cannot mutate schedules at all.
11
+ // • Target gate: a schedule (create, retarget, update, run-now) aimed at another node needs exactly the
12
+ // verdict send_task gets for that target (node-permissions.ts dispatchVerdict, owner's Agent grants +
13
+ // the node's mode). Stricter than send_task in one way: the verdict is enforced even under
14
+ // COMMHUB_NODE_PERMISSIONS=log, because the scheduler would refuse the run later anyway.
15
+ // • Mutations (update / pause / resume / cancel / run_now) only on schedules THIS node created
16
+ // (created_by_node_id = self). A person's schedule that targets the node is read-only for it.
17
+ // • created_by = the node's owner user id (the identity send_task's dispatchVerdict checks), so the
18
+ // scheduler's per-run canMessageAgent(created_by, …) keeps re-checking the owner's grants on every run.
19
+ // A node without a known owner cannot create schedules (a NULL created_by would skip that re-check).
20
+ // • Quota: ≤ COMMHUB_AGENT_SCHEDULE_QUOTA (default 20) active/paused schedules created per node.
21
+ // Minimum cadence is the shared parseScheduleSpec rule (interval ≥ 60 s), the same as REST.
22
+
23
+ import { db } from "./db.js";
24
+ import {
25
+ cancelSchedule, decodeRowForAgent, dispatchScheduledOccurrence, getScheduleRow, insertSchedule, patchSchedule,
26
+ scheduleRuns, ScheduleInputError, validateScheduleCreate, parseScheduleSpec, type ScheduledRow,
27
+ } from "./scheduled-tasks.js";
28
+ import { SCHEDULED_TASK_STORAGE_SELECT } from "./rest-projections.js";
29
+ import { dispatchVerdict, nodePermissionDeniedBody, recordNodePermission, type NodeIdentity } from "./node-permissions.js";
30
+
31
+ export type AgentScheduleResult = Record<string, unknown> & { ok: boolean };
32
+
33
+ export function agentScheduleQuota(): number {
34
+ const n = Number(process.env.COMMHUB_AGENT_SCHEDULE_QUOTA);
35
+ return Number.isSafeInteger(n) && n > 0 ? n : 20;
36
+ }
37
+
38
+ const fail = (error: string, extra: Record<string, unknown> = {}): AgentScheduleResult => ({ ok: false, error, ...extra });
39
+
40
+ /** The scope rule. Exported so the mutation tests can pin it. */
41
+ export function nodeMaySeeSchedule(id: NodeIdentity, row: ScheduledRow): boolean {
42
+ if (!id.nodeId || row.network_id !== id.networkId) return false;
43
+ return row.target_node_id === id.nodeId || row.created_by_node_id === id.nodeId;
44
+ }
45
+
46
+ function visibleRow(id: NodeIdentity, scheduleId: string): ScheduledRow | null {
47
+ const row = getScheduleRow(scheduleId);
48
+ return row && nodeMaySeeSchedule(id, row) ? row : null;
49
+ }
50
+
51
+ /** Visible AND created by this node; else the error to return. Exported for the mutation tests. */
52
+ export function nodeMayMutateSchedule(id: NodeIdentity, row: ScheduledRow): boolean {
53
+ return !!id.nodeId && row.created_by_node_id === id.nodeId;
54
+ }
55
+ function ownRow(id: NodeIdentity, scheduleId: string): ScheduledRow | AgentScheduleResult {
56
+ const row = visibleRow(id, scheduleId);
57
+ if (!row) return fail("schedule_not_found");
58
+ if (!nodeMayMutateSchedule(id, row)) return fail("not_schedule_creator", { message: "only schedules this node created can be changed" });
59
+ return row;
60
+ }
61
+ const isRow = (r: ScheduledRow | AgentScheduleResult): r is ScheduledRow => typeof (r as ScheduledRow).schedule_id === "string";
62
+
63
+ /** send_task's verdict for this target, always enforced (see header). null = allowed. */
64
+ function targetDenied(id: NodeIdentity, route: string, target: { node_id: string; alias: string }): AgentScheduleResult | null {
65
+ const verdict = dispatchVerdict(id, { alias: target.alias, nodeId: target.node_id });
66
+ if (!verdict) return null;
67
+ recordNodePermission(id, route, verdict.reason, verdict.sample);
68
+ return { ...nodePermissionDeniedBody(verdict.reason, route) };
69
+ }
70
+
71
+ function writeGate(id: NodeIdentity, canWrite: boolean, route: string): AgentScheduleResult | null {
72
+ if (!id.nodeId) return fail("node_identity_unbound");
73
+ if (!canWrite) return fail("permission_denied", { message: "this node's owner cannot write in this network" });
74
+ if (id.mode === "readonly") return { ...nodePermissionDeniedBody("mode_readonly", route) };
75
+ return null;
76
+ }
77
+
78
+ function inputError(e: any): AgentScheduleResult {
79
+ if (e instanceof ScheduleInputError) return fail(e.code, e.extra);
80
+ return fail(String(e?.message || "invalid_schedule"));
81
+ }
82
+
83
+ export function agentListSchedules(id: NodeIdentity, status?: string): AgentScheduleResult {
84
+ if (!id.nodeId) return fail("node_identity_unbound");
85
+ const params: unknown[] = [id.networkId, id.nodeId];
86
+ let sql = `SELECT ${SCHEDULED_TASK_STORAGE_SELECT} FROM scheduled_tasks WHERE network_id = ?1 AND (target_node_id = ?2 OR created_by_node_id = ?2)`;
87
+ if (status) { sql += " AND status = ?3"; params.push(status); }
88
+ sql += " ORDER BY updated_at DESC LIMIT 200";
89
+ const rows = db.all<ScheduledRow>(sql, ...params).map(decodeRowForAgent);
90
+ // #2935 —— 「周期比单轮工作耗时短」的排程会**永久 skip**:退避只会让它更稀疏,追不上。
91
+ // 数据是现成的(scheduled_task_runs 的 completed_at - created_at),只是以前没人给出来。
92
+ // 这里只**报数**,不改任何调度行为。
93
+ for (const row of rows) {
94
+ const scheduleId = String((row as Record<string, unknown>).schedule_id ?? "");
95
+ if (!scheduleId) continue;
96
+ const period = intervalSecondsOf(row);
97
+ const p50 = medianRunSeconds(scheduleId);
98
+ const r = row as Record<string, unknown>;
99
+ r.observed_run_seconds_p50 = p50;
100
+ if (period !== null && p50 !== null) {
101
+ r.period_shorter_than_run = period < p50;
102
+ r.suggested_every_seconds = period < p50 ? Math.max(period, Math.round(p50)) : null;
103
+ } else {
104
+ r.period_shorter_than_run = null;
105
+ r.suggested_every_seconds = null;
106
+ }
107
+ }
108
+ return { ok: true, schedules: rows };
109
+ }
110
+
111
+ /** 从 schedule_json 里取 interval 秒数;非 interval 类型返回 null。 */
112
+ function intervalSecondsOf(row: unknown): number | null {
113
+ const spec = (row as Record<string, unknown>)?.schedule;
114
+ const m = /"every_seconds"\s*:\s*(\d+)/.exec(JSON.stringify(spec ?? ""));
115
+ return m ? Number(m[1]) : null;
116
+ }
117
+
118
+ /**
119
+ * 近 7 天该排程「完成一轮」耗时的中位数(秒)。样本 < 3 返回 null(不够判断)。
120
+ *
121
+ * 🔴 不在 SQL 里算时长:`julianday()` 是 SQLite 专有,PostgreSQL 没有。
122
+ * test2123-hub-postgres-ladder 实测报错:`PG: function datetime(unknown, text) does not exist`。
123
+ * 两列都是 Hub 的 TEXT UTC 时间戳,取回来在 JS 里减最稳 —— 两边方言都不用碰。
124
+ */
125
+ function medianRunSeconds(scheduleId: string): number | null {
126
+ const parse = (t: string | null): number | null => {
127
+ if (!t) return null;
128
+ const iso = /[zZ]|[+-]\d\d:?\d\d$/.test(t) ? t : `${t.replace(" ", "T")}Z`;
129
+ const ms = Date.parse(iso);
130
+ return Number.isFinite(ms) ? ms : null;
131
+ };
132
+ const rows = db.all<{ created_at: string | null; completed_at: string | null }>(
133
+ `SELECT created_at, completed_at FROM scheduled_task_runs
134
+ WHERE schedule_id = ?1 AND status = 'replied' AND completed_at IS NOT NULL
135
+ AND created_at >= datetime('now','-7 day')
136
+ ORDER BY created_at DESC LIMIT 200`,
137
+ scheduleId,
138
+ );
139
+ const secs = rows
140
+ .map((r) => {
141
+ const a = parse(r.created_at), b = parse(r.completed_at);
142
+ return a === null || b === null ? null : (b - a) / 1000;
143
+ })
144
+ .filter((n): n is number => n !== null && Number.isFinite(n) && n >= 0)
145
+ .sort((x, y) => x - y);
146
+ if (secs.length < 3) return null;
147
+ const mid = Math.floor(secs.length / 2);
148
+ const median = secs.length % 2 ? secs[mid] : (secs[mid - 1] + secs[mid]) / 2;
149
+ return Math.round(median);
150
+ }
151
+
152
+ export function agentGetSchedule(id: NodeIdentity, scheduleId: string): AgentScheduleResult {
153
+ const row = visibleRow(id, scheduleId);
154
+ return row ? { ok: true, schedule: decodeRowForAgent(row) } : fail("schedule_not_found");
155
+ }
156
+
157
+ export function agentScheduleRuns(id: NodeIdentity, scheduleId: string, limit?: number): AgentScheduleResult {
158
+ const row = visibleRow(id, scheduleId);
159
+ if (!row) return fail("schedule_not_found");
160
+ return { ok: true, ...scheduleRuns(row, Math.max(1, Math.min(200, Math.floor(Number(limit)) || 50))) };
161
+ }
162
+
163
+ export function agentCreateSchedule(id: NodeIdentity, canWrite: boolean, body: Record<string, unknown>): AgentScheduleResult {
164
+ const route = "mcp:schedule_create";
165
+ const gate = writeGate(id, canWrite, route);
166
+ if (gate) return gate;
167
+ if (!id.ownerUserId) return { ...nodePermissionDeniedBody("owner_unknown", route) };
168
+ const input = { ...body, target_node_id: body.target_node_id ?? id.nodeId };
169
+ let v: ReturnType<typeof validateScheduleCreate>;
170
+ try { v = validateScheduleCreate(id.networkId, input); } catch (e) { return inputError(e); }
171
+ const denied = targetDenied(id, route, v.target);
172
+ if (denied) return denied;
173
+ const quota = agentScheduleQuota();
174
+ const used = Number(db.get<{ n: number | string }>(
175
+ "SELECT COUNT(*) AS n FROM scheduled_tasks WHERE network_id = ?1 AND created_by_node_id = ?2 AND status IN ('active', 'paused')",
176
+ id.networkId, id.nodeId,
177
+ )?.n ?? 0);
178
+ if (used >= quota) return fail("schedule_quota_exceeded", { quota, active: used, message: "cancel one of this node's schedules first" });
179
+ const row = insertSchedule(id.networkId, id.ownerUserId, id.nodeId, v);
180
+ return { ok: true, schedule: decodeRowForAgent(row) };
181
+ }
182
+
183
+ export function agentUpdateSchedule(id: NodeIdentity, canWrite: boolean, scheduleId: string, body: Record<string, unknown>): AgentScheduleResult {
184
+ const route = "mcp:schedule_update";
185
+ const gate = writeGate(id, canWrite, route);
186
+ if (gate) return gate;
187
+ const row = ownRow(id, scheduleId);
188
+ if (!isRow(row)) return row;
189
+ if (body.base_revision !== undefined && Number(body.base_revision) !== row.revision) {
190
+ return fail("revision_conflict", { current_revision: row.revision });
191
+ }
192
+ const retarget = body.target_node_id !== undefined && body.target_node_id !== row.target_node_id;
193
+ let target = { node_id: row.target_node_id, alias: row.target_alias };
194
+ if (retarget) {
195
+ const node = db.get<{ node_id: string; alias: string | null }>(
196
+ "SELECT node_id, alias FROM nodes WHERE node_id = ?1 AND network_id = ?2", String(body.target_node_id), row.network_id);
197
+ if (!node?.alias) return fail("target_node_not_found");
198
+ target = { node_id: node.node_id, alias: node.alias };
199
+ }
200
+ const denied = targetDenied(id, route, target);
201
+ if (denied) return denied;
202
+ try {
203
+ const patched = patchSchedule(row, { ...body, revision: body.revision ?? row.revision }, id.ownerUserId);
204
+ return { ok: true, schedule: decodeRowForAgent(patched) };
205
+ } catch (e) { return inputError(e); }
206
+ }
207
+
208
+ /** #816: partial success, one result per distinct ID; no change to existing write authority. */
209
+ export function agentBatchScheduleInterval(id: NodeIdentity, canWrite: boolean, scheduleIds: string[], everySeconds: number): AgentScheduleResult {
210
+ const gate = writeGate(id, canWrite, "mcp:schedule_batch_interval");
211
+ if (gate) return gate;
212
+ const schedule = { type: "interval", every_seconds: everySeconds };
213
+ try { parseScheduleSpec(schedule, "UTC"); } catch (e) { return inputError(e); }
214
+ const results = [...new Set(scheduleIds)].map(schedule_id => {
215
+ const row = ownRow(id, schedule_id);
216
+ if (!isRow(row)) return { schedule_id, ...row };
217
+ if (row.schedule_type !== "interval") return { schedule_id, ok: false, error: "not_interval_schedule" };
218
+ const result = agentUpdateSchedule(id, canWrite, schedule_id, { schedule, base_revision: row.revision });
219
+ if (!result.ok) return { schedule_id, ...result };
220
+ const updated = result.schedule as ReturnType<typeof decodeRowForAgent>;
221
+ return { schedule_id, ok: true, every_seconds: everySeconds, next_run_at: updated.next_run_at, status: updated.status, revision: updated.revision };
222
+ });
223
+ const updated = results.filter(r => r.ok).length;
224
+ return { ok: updated === results.length, updated, failed: results.length - updated, results };
225
+ }
226
+
227
+ export function agentCancelSchedule(id: NodeIdentity, canWrite: boolean, scheduleId: string): AgentScheduleResult {
228
+ const gate = writeGate(id, canWrite, "mcp:schedule_cancel");
229
+ if (gate) return gate;
230
+ const row = ownRow(id, scheduleId);
231
+ if (!isRow(row)) return row;
232
+ cancelSchedule(row);
233
+ return { ok: true, status: "cancelled" };
234
+ }
235
+
236
+ export function agentRunScheduleNow(id: NodeIdentity, canWrite: boolean, scheduleId: string): AgentScheduleResult {
237
+ const route = "mcp:schedule_run_now";
238
+ const gate = writeGate(id, canWrite, route);
239
+ if (gate) return gate;
240
+ const row = ownRow(id, scheduleId);
241
+ if (!isRow(row)) return row;
242
+ if (row.status === "cancelled") return fail("schedule_cancelled");
243
+ const denied = targetDenied(id, route, { node_id: row.target_node_id, alias: row.target_alias });
244
+ if (denied) return denied;
245
+ try {
246
+ const result = dispatchScheduledOccurrence(row, new Date().toISOString(), false);
247
+ const { event: _event, ...rest } = result;
248
+ return { ok: result.status !== "failed", ...rest };
249
+ } catch (e: any) {
250
+ return fail("dispatch_failed", { message: String(e?.message || e).slice(0, 500) });
251
+ }
252
+ }
@@ -0,0 +1,92 @@
1
+ // #2880 —— 空转排程:默认只记录,开启开关才真暂停。
2
+ import { describe, expect, test, beforeAll, afterAll } from "bun:test";
3
+ import { db } from "./db.js";
4
+ import { isStarved, scanStarvedSchedules, autopauseEnabled } from "./schedule-starved.js";
5
+
6
+ const NET = "net_starved";
7
+ const USER = "u_starved";
8
+
9
+ function mkSchedule(id: string, name: string): void {
10
+ db.run(
11
+ `INSERT INTO scheduled_tasks (schedule_id, network_id, created_by, name, target_node_id, target_alias, task_content, priority, schedule_type, schedule_json, timezone, overlap_policy, status, next_run_at)
12
+ VALUES (?1, ?2, ?3, ?4, 'busy-node', 'busy-node', 'x', 'normal', 'interval', '{"type":"interval","every_seconds":180}', 'Asia/Shanghai', 'skip', 'active', datetime('now'))`,
13
+ [id, NET, USER, name],
14
+ );
15
+ }
16
+
17
+ function mkRuns(scheduleId: string, total: number, replied: number): void {
18
+ for (let i = 0; i < total; i++) {
19
+ const status = i < replied ? "replied" : "skipped";
20
+ db.run(
21
+ // scheduled_for 上有 UNIQUE(schedule_id, scheduled_for):每行错开一分钟
22
+ `INSERT INTO scheduled_task_runs (run_id, schedule_id, network_id, scheduled_for, status, error_code, created_at)
23
+ VALUES (?1, ?2, ?3, datetime('now', ?5), ?4, 'previous_run_active', datetime('now'))`,
24
+ [`run_${scheduleId}_${i}`, scheduleId, NET, status, `-${i} minutes`],
25
+ );
26
+ }
27
+ }
28
+
29
+ describe("空转排程判定与自动暂停", () => {
30
+ beforeAll(() => {
31
+ db.run("DELETE FROM scheduled_task_runs WHERE network_id = ?1", [NET]);
32
+ db.run("DELETE FROM scheduled_tasks WHERE network_id = ?1", [NET]);
33
+ db.run("DELETE FROM user_inbox WHERE network_id = ?1", [NET]);
34
+ });
35
+ afterAll(() => {
36
+ db.run("DELETE FROM scheduled_task_runs WHERE network_id = ?1", [NET]);
37
+ db.run("DELETE FROM scheduled_tasks WHERE network_id = ?1", [NET]);
38
+ db.run("DELETE FROM user_inbox WHERE network_id = ?1", [NET]);
39
+ delete process.env.COMMHUB_SCHEDULE_STARVED_AUTOPAUSE;
40
+ });
41
+
42
+ test("纯判定:次数够且 0 成功才算空转", () => {
43
+ expect(isStarved({ total: 20, replied: 0 }, 20)).toBe(true);
44
+ expect(isStarved({ total: 19, replied: 0 }, 20)).toBe(false); // 次数不够:一天一次的排程不会误伤
45
+ expect(isStarved({ total: 129, replied: 1 }, 20)).toBe(false); // 只要成功过一次就不算
46
+ });
47
+
48
+ // 2026-10-28 生产实测:6 个候选里 4 个的 79 次运行全是 target_offline ——
49
+ // 它们在等节点回来,暂停它们反而要多一次人工恢复。
50
+ test("目标离线占比过高 ⇒ 不算空转(那是在等节点,不是排程有问题)", () => {
51
+ expect(isStarved({ total: 79, replied: 0, offline_skips: 79 }, 20)).toBe(false); // 100% 离线
52
+ expect(isStarved({ total: 100, replied: 0, offline_skips: 91 }, 20)).toBe(false); // >90%
53
+ expect(isStarved({ total: 100, replied: 0, offline_skips: 89 }, 20)).toBe(true); // <90% 仍算空转
54
+ expect(isStarved({ total: 94, replied: 0, offline_skips: 0 }, 20)).toBe(true); // 纯 busy/失败型
55
+ });
56
+
57
+ test("默认关闭:只报候选,不改排程状态", () => {
58
+ delete process.env.COMMHUB_SCHEDULE_STARVED_AUTOPAUSE;
59
+ mkSchedule("sched_starved_a", "空转A");
60
+ mkRuns("sched_starved_a", 25, 0);
61
+ expect(autopauseEnabled()).toBe(false);
62
+ const r = scanStarvedSchedules();
63
+ expect(r.enabled).toBe(false);
64
+ expect(r.paused).toEqual([]);
65
+ expect(r.candidates).toContain("sched_starved_a");
66
+ const st = db.get<{ status: string }>("SELECT status FROM scheduled_tasks WHERE schedule_id = 'sched_starved_a'");
67
+ expect(st?.status).toBe("active"); // 没有被动过
68
+ });
69
+
70
+ test("开启开关后才暂停,并且只停空转的那个", () => {
71
+ process.env.COMMHUB_SCHEDULE_STARVED_AUTOPAUSE = "1";
72
+ mkSchedule("sched_starved_b", "空转B");
73
+ mkRuns("sched_starved_b", 30, 0);
74
+ mkSchedule("sched_healthy_b", "健康B");
75
+ mkRuns("sched_healthy_b", 30, 12);
76
+ const r = scanStarvedSchedules();
77
+ expect(r.enabled).toBe(true);
78
+ expect(r.paused).toContain("sched_starved_b");
79
+ expect(r.paused).not.toContain("sched_healthy_b");
80
+ expect(db.get<{ status: string }>("SELECT status FROM scheduled_tasks WHERE schedule_id = 'sched_starved_b'")?.status).toBe("paused");
81
+ expect(db.get<{ status: string }>("SELECT status FROM scheduled_tasks WHERE schedule_id = 'sched_healthy_b'")?.status).toBe("active");
82
+ });
83
+
84
+ test("已暂停的不会再被处理(重复扫描无副作用)", () => {
85
+ process.env.COMMHUB_SCHEDULE_STARVED_AUTOPAUSE = "1";
86
+ const before = db.get<{ n: number }>("SELECT COUNT(*) AS n FROM user_inbox WHERE network_id = ?1", [NET])?.n ?? 0;
87
+ const r = scanStarvedSchedules();
88
+ expect(r.paused).not.toContain("sched_starved_b");
89
+ const after = db.get<{ n: number }>("SELECT COUNT(*) AS n FROM user_inbox WHERE network_id = ?1", [NET])?.n ?? 0;
90
+ expect(after).toBe(before); // 不会补发第二条通知
91
+ });
92
+ });
@@ -0,0 +1,114 @@
1
+ // #2880 / #2881 —— 「空转排程」:先记录,默认**不**自动暂停。
2
+ //
3
+ // 现场(2026-10-28 生产只读):
4
+ // · TMA云盘欧 24h 接 44 单 **0 成功**,两个 180s 排程各跳过 147 / 68 次,占用 ~30.9h/天
5
+ // · 另有若干排程 24h 内 129 次执行 / 129 次跳过 / 0 次成功
6
+ // · 这些排程的 schedule_stuck 通知 7 天 1162 条(单个排程 220 条)⇒ 没人再看(#3161 正在限流)
7
+ //
8
+ // 治本不是「再多发一条通知」,而是让一直产不出东西的排程**停下来**。
9
+ // 但「自动停别人的排程」是行为变更,必须由人开启 —— 所以这里做成**默认关闭**的开关,
10
+ // 并在关闭状态下照样把「本来会被暂停哪些」打进日志:先让人看见候选,再决定要不要动手。
11
+ //
12
+ // COMMHUB_SCHEDULE_STARVED_AUTOPAUSE=1 开启真正的暂停(默认关)
13
+ // COMMHUB_SCHEDULE_STARVED_MIN_RUNS=20 窗口内至少这么多次执行才判定(默认 20)
14
+ // COMMHUB_SCHEDULE_STARVED_WINDOW_HOURS=24 统计窗口(默认 24)
15
+ //
16
+ // 判据只用「窗口内执行次数 ≥ N 且成功 0 次」——不参杂跳过比例:
17
+ // 一个真在干活的排程不会 20 次全不成功;而「一天只跑一次且失败」的排程达不到 20,不会误伤。
18
+ import { db } from "./db.js";
19
+ import { sendAgentNotice } from "./agent-notice.js";
20
+
21
+ export const SCHEDULE_STARVED_KIND = "schedule_starved_paused";
22
+
23
+ function envInt(name: string, fallback: number, min: number): number {
24
+ const raw = process.env[name];
25
+ if (raw === undefined || raw.trim() === "") return fallback;
26
+ const n = Number(raw);
27
+ return Number.isFinite(n) && n >= min ? Math.floor(n) : fallback;
28
+ }
29
+
30
+ export function autopauseEnabled(): boolean {
31
+ return String(process.env.COMMHUB_SCHEDULE_STARVED_AUTOPAUSE ?? "").trim() === "1";
32
+ }
33
+ export function starvedMinRuns(): number { return envInt("COMMHUB_SCHEDULE_STARVED_MIN_RUNS", 20, 1); }
34
+ export function starvedWindowHours(): number { return envInt("COMMHUB_SCHEDULE_STARVED_WINDOW_HOURS", 24, 1); }
35
+
36
+ export type ScheduleStats = { schedule_id: string; total: number; replied: number; offline_skips: number };
37
+
38
+ /** 目标不可达占比超过这个比例 ⇒ 不算空转(是在等节点回来,不是排程有问题)。 */
39
+ export const OFFLINE_SKIP_RATIO_MAX = 0.9;
40
+
41
+ /**
42
+ * 纯函数:是否判定为空转。便于单测,不做任何 IO。
43
+ *
44
+ * 🔴 2026-10-28 生产实测修正:只看「执行≥N 且成功=0」会把「等离线节点」误判成空转。
45
+ * 那天 6 个候选里 4 个的 79 次运行**全部是 skipped/target_offline** —— 它们没建过任务、
46
+ * 没浪费等待,节点一回来就会自己接着跑。把它们暂停,反而要多一次人工恢复。
47
+ * ⇒ target_offline 占比 > 90% 视为「目标不可达」,不算空转。
48
+ */
49
+ export function isStarved(
50
+ s: { total: number; replied: number; offline_skips?: number },
51
+ minRuns = starvedMinRuns(),
52
+ ): boolean {
53
+ if (s.total < minRuns || s.replied !== 0) return false;
54
+ const offline = s.offline_skips ?? 0;
55
+ return offline <= s.total * OFFLINE_SKIP_RATIO_MAX;
56
+ }
57
+
58
+ export type StarvedScanResult = { paused: string[]; candidates: string[]; enabled: boolean };
59
+
60
+ /**
61
+ * 扫一遍窗口内的排程产出。开启开关才真暂停;未开启只返回候选(供日志观察)。
62
+ * 纯读 + 可选的一次状态写 + 一条通知,不改任务。
63
+ */
64
+ export function scanStarvedSchedules(now = new Date()): StarvedScanResult {
65
+ const windowHours = starvedWindowHours();
66
+ const since = new Date(now.getTime() - windowHours * 3_600_000).toISOString().slice(0, 19).replace("T", " ");
67
+ const rows = db.all<ScheduleStats>(
68
+ `SELECT schedule_id,
69
+ COUNT(*) AS total,
70
+ SUM(CASE WHEN status = 'replied' THEN 1 ELSE 0 END) AS replied,
71
+ SUM(CASE WHEN status = 'skipped' AND error_code = 'target_offline' THEN 1 ELSE 0 END) AS offline_skips
72
+ FROM scheduled_task_runs
73
+ WHERE created_at >= ?1
74
+ GROUP BY schedule_id`,
75
+ since,
76
+ );
77
+ const candidates = rows.filter((r) => isStarved(r)).map((r) => r.schedule_id);
78
+ if (!autopauseEnabled() || candidates.length === 0) {
79
+ return { paused: [], candidates, enabled: autopauseEnabled() };
80
+ }
81
+ const paused: string[] = [];
82
+ for (const scheduleId of candidates) {
83
+ const info = db.get<{ network_id: string; created_by: string | null; name: string; target_alias: string | null }>(
84
+ `SELECT network_id, created_by, name, target_alias FROM scheduled_tasks
85
+ WHERE schedule_id = ?1 AND status = 'active'`,
86
+ scheduleId,
87
+ );
88
+ if (!info) continue; // 已暂停/已完成/已取消:不重复处理
89
+ const stats = rows.find((r) => r.schedule_id === scheduleId)!;
90
+ db.run("UPDATE scheduled_tasks SET status = 'paused', updated_at = datetime('now') WHERE schedule_id = ?1", [scheduleId]);
91
+ console.log(`[commhub schedule-starved] paused ${scheduleId} (${info.name}) — ${stats.total} 次执行 / 0 成功 in ${windowHours}h`);
92
+ if (info.created_by) {
93
+ try {
94
+ sendAgentNotice({
95
+ networkId: info.network_id,
96
+ userId: info.created_by,
97
+ fromAlias: info.target_alias ?? "hub",
98
+ kind: SCHEDULE_STARVED_KIND,
99
+ title: "定时任务已自动暂停(一直产不出结果)",
100
+ text:
101
+ `定时任务「${info.name}」在最近 ${windowHours} 小时内执行了 ${stats.total} 次,**没有一次成功**,已自动暂停。\n\n`
102
+ + `常见原因:目标节点被人的 TUI 长期占着,任务根本没提交上去。\n`
103
+ + `处理:确认节点可用后在排程页恢复;如果确实不需要了,直接停用。\n\n`
104
+ + `(此动作由 COMMHUB_SCHEDULE_STARVED_AUTOPAUSE=1 开启;不设该变量时只记录不暂停。)`,
105
+ severity: "warning",
106
+ meta: { schedule_starved: { schedule_id: scheduleId, total: stats.total, replied: 0, window_hours: windowHours } },
107
+ idPrefix: "dm_sstarved_",
108
+ });
109
+ } catch { /* 通知失败不影响已做出的暂停决定 */ }
110
+ }
111
+ paused.push(scheduleId);
112
+ }
113
+ return { paused, candidates, enabled: true };
114
+ }