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

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 (479) 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 +184 -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 +218 -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 +1599 -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/license-state.test.ts +105 -0
  148. package/src/license-state.ts +48 -0
  149. package/src/lifecycle-error-domain.test.ts +149 -0
  150. package/src/list-ack-error-domain.test.ts +108 -0
  151. package/src/list-host-supervisors.test.ts +15 -4
  152. package/src/list-tasks-omit-default.test.ts +84 -0
  153. package/src/list-tasks-since-last.test.ts +100 -0
  154. package/src/list-tasks-since.test.ts +104 -0
  155. package/src/mcp-context-cost-http.test.ts +127 -0
  156. package/src/mcp-inflight.test.ts +92 -0
  157. package/src/mcp-inflight.ts +38 -0
  158. package/src/mcp-projects-events-http.test.ts +168 -0
  159. package/src/mcp-route-label-http.test.ts +120 -0
  160. package/src/mcp-write-network-resolution.test.ts +21 -0
  161. package/src/member-audit-network-id-http.test.ts +93 -0
  162. package/src/member-presence-http.test.ts +210 -0
  163. package/src/messages-ack-by-agent-http.test.ts +142 -0
  164. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  165. package/src/migrate-sqlite-to-pg.ts +263 -0
  166. package/src/model-auth-notify-http.test.ts +181 -0
  167. package/src/model-auth-notify.ts +116 -0
  168. package/src/network-name-http.test.ts +75 -0
  169. package/src/network-quota-config.test.ts +100 -0
  170. package/src/network-rules-http.test.ts +169 -0
  171. package/src/network-rules.ts +129 -0
  172. package/src/network-scope.ts +222 -3
  173. package/src/network-token-membership-http.test.ts +186 -0
  174. package/src/node-alias-control.ts +12 -0
  175. package/src/node-attrs.test.ts +47 -2
  176. package/src/node-caller-identity-http.test.ts +1108 -0
  177. package/src/node-config-last-update.test.ts +126 -0
  178. package/src/node-config-last-update.ts +107 -0
  179. package/src/node-create-request-status-http.test.ts +105 -0
  180. package/src/node-daemon-bindings.test.ts +142 -0
  181. package/src/node-daemon-bindings.ts +135 -0
  182. package/src/node-failure-alert.test.ts +150 -0
  183. package/src/node-failure-alert.ts +177 -0
  184. package/src/node-files-transport.test.ts +350 -0
  185. package/src/node-health-codex-login.test.ts +120 -0
  186. package/src/node-health-dispatch-http.test.ts +373 -0
  187. package/src/node-health-guard-origin.test.ts +98 -0
  188. package/src/node-health-guard.ts +121 -0
  189. package/src/node-health-passthrough.test.ts +115 -0
  190. package/src/node-health-store.ts +101 -0
  191. package/src/node-id-alias.test.ts +190 -0
  192. package/src/node-identity-conflict-http.test.ts +269 -0
  193. package/src/node-identity-conflict.ts +142 -0
  194. package/src/node-identity-mismatch.test.ts +74 -0
  195. package/src/node-in-flight-tasks.ts +31 -0
  196. package/src/node-lifecycle-controllable.test.ts +64 -0
  197. package/src/node-lifecycle-controllable.ts +53 -0
  198. package/src/node-lifecycle-read-http.test.ts +257 -0
  199. package/src/node-lifecycle-read.ts +126 -0
  200. package/src/node-logs-transport.test.ts +266 -0
  201. package/src/node-peer-allowlist.test.ts +114 -0
  202. package/src/node-permissions-http.test.ts +901 -0
  203. package/src/node-permissions.ts +496 -0
  204. package/src/node-request-retention.test.ts +281 -0
  205. package/src/node-request-retention.ts +120 -0
  206. package/src/node-secret-rest-http.test.ts +190 -0
  207. package/src/node-secret-vault-inject.test.ts +132 -0
  208. package/src/node-security-write-gate.test.ts +72 -0
  209. package/src/node-serviceability.test.ts +86 -0
  210. package/src/node-serviceability.ts +124 -0
  211. package/src/node-session-control-http.test.ts +398 -0
  212. package/src/node-session-control.ts +316 -0
  213. package/src/node-skills-transport.test.ts +212 -0
  214. package/src/node-token-identity.ts +35 -0
  215. package/src/node-token-ownership.ts +51 -0
  216. package/src/node-token-privilege-http.test.ts +224 -0
  217. package/src/node-token-usage.test.ts +128 -0
  218. package/src/node-token-usage.ts +228 -0
  219. package/src/not-found-api-http.test.ts +67 -0
  220. package/src/observer-avatar-http.test.ts +103 -10
  221. package/src/observer-push.test.ts +76 -0
  222. package/src/opencode-catalog-report-http.test.ts +139 -0
  223. package/src/opencode-v2-catalog.test.ts +282 -0
  224. package/src/opencode-v2-catalog.ts +357 -0
  225. package/src/package-self-contained.test.ts +32 -0
  226. package/src/package-version-consistency.test.ts +25 -0
  227. package/src/parent-infer.test.ts +82 -0
  228. package/src/parent-infer.ts +110 -0
  229. package/src/parent-source-marker.test.ts +70 -0
  230. package/src/parent-source-orphan.test.ts +121 -0
  231. package/src/password-network-tokens.ts +25 -0
  232. package/src/peer-reply-atomic.test.ts +462 -0
  233. package/src/peer-reply-capability.test.ts +70 -0
  234. package/src/pg-worker.ts +87 -0
  235. package/src/poll-pacing.test.ts +74 -0
  236. package/src/poll-pacing.ts +123 -0
  237. package/src/probe-provider-error-domain.test.ts +145 -0
  238. package/src/project-dir-warn-clear-http.test.ts +132 -0
  239. package/src/project-viewer-can-http.test.ts +116 -0
  240. package/src/provider-skill-error-domain.test.ts +130 -0
  241. package/src/provider-tools-shape.test.ts +165 -0
  242. package/src/push.test.ts +20 -10
  243. package/src/push.ts +373 -9
  244. package/src/redact-tokens.test.ts +86 -0
  245. package/src/redact-tokens.ts +43 -0
  246. package/src/rejection-counters.test.ts +72 -0
  247. package/src/rejection-counters.ts +173 -0
  248. package/src/rename.ts +38 -10
  249. package/src/reply-target-derivation.test.ts +96 -0
  250. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  251. package/src/report-status-host-schema.test.ts +272 -0
  252. package/src/report-status-resume-id-handover.test.ts +184 -0
  253. package/src/report-status-secret-keys.test.ts +140 -0
  254. package/src/require-explicit-test-db.ts +9 -0
  255. package/src/requirement-due-reminders-http.test.ts +620 -0
  256. package/src/requirement-due-reminders.ts +416 -0
  257. package/src/requirement-events-http.test.ts +318 -0
  258. package/src/requirement-events.test.ts +45 -0
  259. package/src/requirement-events.ts +144 -0
  260. package/src/requirement-notify.ts +165 -0
  261. package/src/requirement-participant-notify-http.test.ts +313 -0
  262. package/src/requirement-tag-ops-http.test.ts +454 -0
  263. package/src/requirement-tag-tree-http.test.ts +275 -0
  264. package/src/requirement-tag-tree.ts +127 -0
  265. package/src/requirement-tags.ts +102 -0
  266. package/src/requirements-abandoned-http.test.ts +236 -0
  267. package/src/requirements-assignee-drift.test.ts +154 -0
  268. package/src/requirements-comment-http.test.ts +174 -0
  269. package/src/requirements-completed-at-migration.test.ts +70 -0
  270. package/src/requirements-errors-mcp-http.test.ts +164 -0
  271. package/src/requirements-errors.ts +158 -0
  272. package/src/requirements-etag-http.test.ts +91 -0
  273. package/src/requirements-http.test.ts +709 -0
  274. package/src/requirements-last-event-http.test.ts +349 -0
  275. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  276. package/src/requirements-list-slim-http.test.ts +324 -0
  277. package/src/requirements-mcp.test.ts +180 -0
  278. package/src/requirements-migrate.ts +283 -0
  279. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  280. package/src/requirements-people-http.test.ts +114 -0
  281. package/src/requirements-people-mcp-http.test.ts +231 -0
  282. package/src/requirements-people.ts +196 -0
  283. package/src/requirements-priority-lowest.test.ts +114 -0
  284. package/src/requirements-projects-network-echo.test.ts +57 -0
  285. package/src/requirements-projects-parent-http.test.ts +123 -0
  286. package/src/requirements-search-http.test.ts +182 -0
  287. package/src/requirements-search.test.ts +32 -0
  288. package/src/requirements-search.ts +145 -0
  289. package/src/requirements-seq-http.test.ts +193 -0
  290. package/src/requirements-seq-migration.test.ts +63 -0
  291. package/src/requirements-start-date.test.ts +125 -0
  292. package/src/requirements-stats-http.test.ts +357 -0
  293. package/src/requirements-stats.ts +195 -0
  294. package/src/requirements-status-participants-http.test.ts +222 -0
  295. package/src/requirements-upgrade-e2e.test.ts +126 -0
  296. package/src/requirements-upgrade-migration.test.ts +98 -0
  297. package/src/requirements.ts +2205 -0
  298. package/src/resolve-port.test.ts +57 -0
  299. package/src/resolve-port.ts +44 -0
  300. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  301. package/src/rest-alias-network-fallback.test.ts +60 -0
  302. package/src/rest-alias-network-fallback.ts +65 -0
  303. package/src/rest-explicit-columns-http.test.ts +266 -0
  304. package/src/rest-identity.test.ts +130 -0
  305. package/src/rest-identity.ts +141 -0
  306. package/src/rest-projections.ts +72 -0
  307. package/src/rest-read-network-real-chain.test.ts +97 -0
  308. package/src/rest-write-network-resolution.test.ts +133 -0
  309. package/src/restart-readiness-http.test.ts +121 -0
  310. package/src/restricted-files.ts +76 -0
  311. package/src/retention-first-sweep-quiet.test.ts +31 -0
  312. package/src/retention.test.ts +100 -40
  313. package/src/retention.ts +423 -104
  314. package/src/route-callers-http.test.ts +120 -0
  315. package/src/route-timing.test.ts +218 -0
  316. package/src/route-timing.ts +262 -0
  317. package/src/rules-file-duplicate-alias.test.ts +234 -0
  318. package/src/rules-file-session-target.test.ts +207 -0
  319. package/src/rules-file-transport.test.ts +280 -0
  320. package/src/runtime-label.test.ts +22 -0
  321. package/src/runtime-label.ts +21 -0
  322. package/src/runtime-readiness.ts +90 -0
  323. package/src/schedule-agent-mcp-http.test.ts +486 -0
  324. package/src/schedule-agent.ts +252 -0
  325. package/src/schedule-starved.test.ts +92 -0
  326. package/src/schedule-starved.ts +114 -0
  327. package/src/scheduled-backoff-http.test.ts +203 -0
  328. package/src/scheduled-backoff.ts +64 -0
  329. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  330. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  331. package/src/scheduled-failure-code.test.ts +73 -0
  332. package/src/scheduled-failure-code.ts +105 -0
  333. package/src/scheduled-failures-http.test.ts +279 -0
  334. package/src/scheduled-failures.ts +425 -0
  335. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  336. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  337. package/src/scheduled-offline.test.ts +131 -0
  338. package/src/scheduled-offline.ts +66 -0
  339. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  340. package/src/scheduled-outcome-guidance.ts +9 -0
  341. package/src/scheduled-reply-unread-http.test.ts +212 -0
  342. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  343. package/src/scheduled-requirement-wake.ts +125 -0
  344. package/src/scheduled-run-terminal.test.ts +290 -0
  345. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  346. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  347. package/src/scheduled-stuck-http.test.ts +316 -0
  348. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  349. package/src/scheduled-stuck.ts +219 -0
  350. package/src/scheduled-tasks-http.test.ts +679 -0
  351. package/src/scheduled-tasks.ts +964 -0
  352. package/src/scheduled-work-outcome-http.test.ts +154 -0
  353. package/src/scheduled-work-outcome.ts +50 -0
  354. package/src/scoped-secrets.ts +167 -0
  355. package/src/secret-echo-negative-control.test.ts +118 -0
  356. package/src/send-dedup-request-id.test.ts +229 -0
  357. package/src/send-reply-agent-warning.test.ts +38 -38
  358. package/src/send-reply-alias-optional.test.ts +131 -0
  359. package/src/send-reply-attachments.test.ts +28 -7
  360. package/src/send_dedup.test.ts +54 -0
  361. package/src/send_dedup.ts +52 -6
  362. package/src/serve-error.test.ts +73 -0
  363. package/src/serve-error.ts +56 -0
  364. package/src/server.ts +5033 -377
  365. package/src/session-fork-store.test.ts +43 -0
  366. package/src/session-fork-store.ts +51 -0
  367. package/src/session-project-attach-migration.test.ts +22 -0
  368. package/src/session-project-attach-native.test.ts +121 -0
  369. package/src/session-project-create-http.test.ts +407 -0
  370. package/src/session-project-create-native.test.ts +290 -0
  371. package/src/session-project-create.ts +159 -0
  372. package/src/session-source-admission-store.ts +58 -0
  373. package/src/session-source-create.test.ts +155 -0
  374. package/src/session-source-create.ts +97 -0
  375. package/src/session-source-delivery.ts +109 -0
  376. package/src/session-source-directory-http.test.ts +192 -0
  377. package/src/session-source-evidence.test.ts +898 -0
  378. package/src/session-source-evidence.ts +191 -0
  379. package/src/session-source-execution.ts +87 -0
  380. package/src/session-source-grant.test.ts +117 -0
  381. package/src/session-source-grant.ts +78 -0
  382. package/src/session-source-issuer.test.ts +250 -0
  383. package/src/session-source-issuer.ts +164 -0
  384. package/src/session-source-transport.ts +375 -0
  385. package/src/session-task-on-dispatch.ts +14 -0
  386. package/src/session-token-ownership-http.test.ts +122 -0
  387. package/src/shared/codex-inventory.ts +41 -0
  388. package/src/shared/daemon-provider-login.ts +31 -0
  389. package/src/shared/daemon-provider-snapshot.ts +52 -0
  390. package/src/shared/external-schedule-contract.ts +60 -0
  391. package/src/shared/node-name.test.ts +62 -0
  392. package/src/shared/node-name.ts +161 -0
  393. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  394. package/src/shared/provider-application.ts +29 -0
  395. package/src/shared/provider-collection.ts +14 -0
  396. package/src/shared/provider-initialization.ts +8 -0
  397. package/src/shared/reserved-env-drift.test.ts +10 -0
  398. package/src/shared/scoped-secret-contract.ts +5 -0
  399. package/src/shared/task-content-limit-drift.test.ts +28 -0
  400. package/src/shared/task-content-limit.ts +25 -0
  401. package/src/side-thread-command-transport.test.ts +312 -0
  402. package/src/side-thread-command-transport.ts +318 -0
  403. package/src/side-thread-http-integration.test.ts +233 -0
  404. package/src/side-thread-http.ts +504 -0
  405. package/src/side-thread-production.test.ts +72 -0
  406. package/src/side-thread-production.ts +118 -0
  407. package/src/side-thread.test.ts +1067 -0
  408. package/src/side-thread.ts +2499 -0
  409. package/src/skillhub-http.test.ts +144 -0
  410. package/src/sqlite-close-checkpoint.test.ts +78 -0
  411. package/src/start-node.test.ts +265 -0
  412. package/src/start-request-error-domain.test.ts +182 -0
  413. package/src/start-skill-error-domain.test.ts +122 -0
  414. package/src/stats-versions-http.test.ts +65 -0
  415. package/src/status-alias-filter-http.test.ts +106 -0
  416. package/src/status-alias-resolver-http.test.ts +163 -0
  417. package/src/status-alias-resolver.ts +19 -0
  418. package/src/status-node-id-filter-http.test.ts +161 -0
  419. package/src/status-node-secrets-capable-http.test.ts +44 -0
  420. package/src/status-read-cache-http.test.ts +229 -0
  421. package/src/status-read-cache.ts +129 -0
  422. package/src/stop-delete-node.test.ts +567 -1
  423. package/src/task-access-http.test.ts +407 -0
  424. package/src/task-access.ts +420 -0
  425. package/src/task-activity.ts +60 -0
  426. package/src/task-auth-origin-http.test.ts +93 -0
  427. package/src/task-auth-origin.test.ts +24 -0
  428. package/src/task-auth-origin.ts +7 -0
  429. package/src/task-consumption.test.ts +512 -0
  430. package/src/task-diagnostic-http.test.ts +149 -0
  431. package/src/task-diagnostic.test.ts +115 -0
  432. package/src/task-diagnostic.ts +118 -0
  433. package/src/task-expiry-notice-http.test.ts +298 -0
  434. package/src/task-expiry-notice.ts +318 -0
  435. package/src/task-idempotency-mcp.test.ts +148 -0
  436. package/src/task-idempotency.test.ts +76 -0
  437. package/src/task-idempotency.ts +81 -0
  438. package/src/task-late-replies.ts +54 -0
  439. package/src/task-late-reply-http.test.ts +227 -0
  440. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  441. package/src/task-lifecycle-watcher.test.ts +209 -0
  442. package/src/task-lifecycle-watcher.ts +109 -0
  443. package/src/task-network-resolution-http.test.ts +140 -0
  444. package/src/task-not-found-error-domain.test.ts +117 -0
  445. package/src/task-offline-delivery-2668.test.ts +119 -0
  446. package/src/task-offline-delivery.ts +81 -0
  447. package/src/task-orphan-http.test.ts +287 -0
  448. package/src/task-orphan.ts +119 -0
  449. package/src/task-queue-ahead-http.test.ts +309 -0
  450. package/src/task-queue-ahead-scale.test.ts +236 -0
  451. package/src/task-queue-ahead.ts +186 -0
  452. package/src/task-rejection-log-http.test.ts +160 -0
  453. package/src/task-rejection-log.ts +61 -0
  454. package/src/task-sender-http.test.ts +143 -0
  455. package/src/task-stale-open-http.test.ts +292 -0
  456. package/src/task-stale-open.ts +103 -0
  457. package/src/tasks-pagination-http.test.ts +141 -0
  458. package/src/team-rules-status-http.test.ts +90 -0
  459. package/src/team-rules-status.test.ts +59 -0
  460. package/src/team-rules-status.ts +72 -0
  461. package/src/tmux-allowlist.test.ts +48 -0
  462. package/src/token-usage-http.test.ts +156 -0
  463. package/src/tool-audience-http.test.ts +266 -0
  464. package/src/tool-audience.ts +130 -0
  465. package/src/tools-list-json-schema.test.ts +94 -0
  466. package/src/tools.ts +4530 -471
  467. package/src/update-node-config-error-domain.test.ts +107 -0
  468. package/src/uploads-http.test.ts +6 -4
  469. package/src/uploads.ts +23 -4
  470. package/src/user-avatar-http.test.ts +74 -0
  471. package/src/user-avatar-image.ts +160 -0
  472. package/src/user-avatar-migration.test.ts +25 -0
  473. package/src/user-avatar-upload-http.test.ts +353 -0
  474. package/src/user-inbox-by-agent-http.test.ts +189 -0
  475. package/src/user-inbox-netid-notnull.test.ts +122 -0
  476. package/src/user-inbox-read-http.test.ts +223 -0
  477. package/src/user-inbox-schema.test.ts +54 -0
  478. package/src/version-stats.test.ts +66 -0
  479. package/src/version-stats.ts +109 -0
@@ -0,0 +1,38 @@
1
+ import { expect, test } from "bun:test";
2
+ import { Database } from "bun:sqlite";
3
+ import { execFileSync } from "node:child_process";
4
+ import { mkdtempSync, rmSync } from "node:fs";
5
+ import { tmpdir } from "node:os";
6
+ import { join } from "node:path";
7
+ import { fileURLToPath } from "node:url";
8
+
9
+ test("legacy start table upgrades twice without changing ordinary rows or losing fork receipts", () => {
10
+ const root = mkdtempSync(join(tmpdir(), "fork-migration-"));
11
+ const path = join(root, "legacy.db");
12
+ try {
13
+ let db = new Database(path);
14
+ db.exec(`CREATE TABLE node_start_requests (
15
+ request_id TEXT PRIMARY KEY, network_id TEXT NOT NULL, daemon_node_id TEXT NOT NULL,
16
+ child_node_id TEXT NOT NULL, child_alias TEXT NOT NULL, created_by_token TEXT NOT NULL,
17
+ status TEXT NOT NULL DEFAULT 'pending', error TEXT, child_pid INTEGER,
18
+ created_at INTEGER NOT NULL, delivered_at INTEGER, acked_at INTEGER);
19
+ INSERT INTO node_start_requests(request_id,network_id,daemon_node_id,child_node_id,child_alias,created_by_token,status,created_at)
20
+ VALUES('str_legacy','net_fixture','node_daemon','node_child','fixture','fixture','started',1);`);
21
+ db.close();
22
+ const migrate = () => execFileSync(process.execPath, ["-e",
23
+ `await import(${JSON.stringify(fileURLToPath(new URL("./db.ts", import.meta.url)))}); process.exit(0);`],
24
+ { env: { ...process.env, COMMHUB_DB: path }, timeout: 15_000, stdio: "pipe" });
25
+ migrate();
26
+ db = new Database(path);
27
+ expect(db.query("SELECT status,fork_recovery_json,fork_result_json FROM node_start_requests WHERE request_id='str_legacy'").get())
28
+ .toEqual({ status: "started", fork_recovery_json: null, fork_result_json: null });
29
+ const receipt = JSON.stringify({ state: "not_observed" });
30
+ db.query("UPDATE node_start_requests SET fork_result_json=? WHERE request_id='str_legacy'").run(receipt);
31
+ db.close();
32
+ migrate();
33
+ db = new Database(path);
34
+ expect(db.query("SELECT fork_result_json FROM node_start_requests WHERE request_id='str_legacy'").get())
35
+ .toEqual({ fork_result_json: receipt });
36
+ db.close();
37
+ } finally { rmSync(root, { recursive: true, force: true }); }
38
+ });
@@ -0,0 +1,85 @@
1
+ import { afterAll, describe, expect, test } from "bun:test";
2
+ import { existsSync, mkdtempSync, readFileSync, rmSync } from "node:fs";
3
+ import { tmpdir } from "node:os";
4
+ import { dirname, join } from "node:path";
5
+ import { fileURLToPath } from "node:url";
6
+
7
+ // commhub-server must refuse what it does not understand instead of starting a
8
+ // Hub on the defaults (the live ~/.commhub/commhub.db). Every child gets a
9
+ // throwaway HOME and a throwaway PORT, so even a regression binds nothing real.
10
+ const BIN = join(dirname(fileURLToPath(import.meta.url)), "..", "bin", "commhub.ts");
11
+ const PKG_VERSION = JSON.parse(readFileSync(join(dirname(BIN), "..", "package.json"), "utf8")).version as string;
12
+ const home = mkdtempSync(join(tmpdir(), "anet-bin-args-"));
13
+ const PORT = String(26000 + Math.floor(Math.random() * 3000));
14
+
15
+ afterAll(() => rmSync(home, { recursive: true, force: true }));
16
+
17
+ function run(args: string[], extraEnv: Record<string, string> = {}, timeoutMs = 15_000) {
18
+ const proc = Bun.spawnSync(["bun", BIN, ...args], {
19
+ env: { PATH: process.env.PATH ?? "", HOME: home, PORT, HOST: "127.0.0.1", ...extraEnv },
20
+ stdout: "pipe", stderr: "pipe", timeout: timeoutMs,
21
+ });
22
+ return { code: proc.exitCode, stdout: proc.stdout.toString(), stderr: proc.stderr.toString() };
23
+ }
24
+
25
+ async function listening(port: string): Promise<boolean> {
26
+ try { await fetch(`http://127.0.0.1:${port}/health`, { signal: AbortSignal.timeout(500) }); return true; } catch { return false; }
27
+ }
28
+
29
+ describe("commhub-server argument handling", () => {
30
+ for (const [args, message] of [
31
+ [["bogus"], "unknown command bogus"],
32
+ [["--port=29999"], "unknown option --port=29999"],
33
+ [["--bogus-flag"], "unknown option --bogus-flag"],
34
+ [["--port"], "--port needs a value"],
35
+ [["--db", "--dev-open"], "--db needs a value"],
36
+ ] as const) {
37
+ test(`${args.join(" ")} → exit 2, no database, nothing listening`, async () => {
38
+ const r = run([...args]);
39
+ expect(r.code).toBe(2);
40
+ expect(r.stderr).toContain(message);
41
+ expect(r.stderr).toContain("commhub-server --help");
42
+ expect(existsSync(join(home, ".commhub"))).toBe(false);
43
+ expect(await listening(PORT)).toBe(false);
44
+ });
45
+ }
46
+
47
+ test("migrate-to-pg with missing or unknown arguments exits 2 and starts nothing", async () => {
48
+ const missing = run(["migrate-to-pg", "--from", "/x.db"]);
49
+ expect(missing.code).toBe(2);
50
+ expect(missing.stdout).toContain("commhub-server migrate-to-pg --from <sqlite file> --to <postgres url>");
51
+ const unknown = run(["migrate-to-pg", "--from", "/x.db", "--to", "postgres://u@127.0.0.1/anet_x_test", "--bogus"]);
52
+ expect(unknown.code).toBe(2);
53
+ expect(unknown.stderr).toContain("unknown argument --bogus");
54
+ expect(existsSync(join(home, ".commhub"))).toBe(false);
55
+ expect(await listening(PORT)).toBe(false);
56
+ });
57
+
58
+ test("--help and --version exit 0 without starting", async () => {
59
+ const help = run(["--help"]);
60
+ expect(help.code).toBe(0);
61
+ expect(help.stdout).toContain("--port, -p <port>");
62
+ const version = run(["--version"]);
63
+ expect(version.code).toBe(0);
64
+ expect(version.stdout.trim()).toBe(PKG_VERSION);
65
+ expect(existsSync(join(home, ".commhub"))).toBe(false);
66
+ });
67
+
68
+ test("the known forms still start a Hub", async () => {
69
+ const db = join(home, "known.db");
70
+ const port = String(Number(PORT) + 1);
71
+ const child = Bun.spawn(["bun", BIN, "--port", port, "--host", "127.0.0.1", "--db", db, "--dev-open"], {
72
+ env: { PATH: process.env.PATH ?? "", HOME: home }, stdout: "pipe", stderr: "pipe",
73
+ });
74
+ try {
75
+ let up = false;
76
+ for (let i = 0; i < 100 && !up; i++) { up = await listening(port); if (!up) await Bun.sleep(100); }
77
+ expect(up).toBe(true);
78
+ expect(existsSync(db)).toBe(true);
79
+ expect(existsSync(join(home, ".commhub", "commhub.db"))).toBe(false);
80
+ } finally {
81
+ child.kill();
82
+ await child.exited;
83
+ }
84
+ }, 30_000);
85
+ });
@@ -47,6 +47,15 @@ beforeEach(() => {
47
47
  db.run("DELETE FROM nodes");
48
48
  });
49
49
 
50
+ test("variant updates cannot be finalized by a configured-model heartbeat", () => {
51
+ for (const variant of [null, "high"]) {
52
+ const node = insertNode({ alias: `variant-${variant}`, network_id: "netA" });
53
+ const update = insertUpdate({ node_id: node, network_id: "netA", patch: { model: "p/m", modelVariant: variant, flags: {} } });
54
+ expect(finalizePendingMatchingUpdates(node, { model: "p/m", flags: {} }).finalizedCount).toBe(0);
55
+ expect(db.get<{ status: string }>("SELECT status FROM node_config_updates WHERE update_id = ?1", update)?.status).toBe("pending");
56
+ }
57
+ });
58
+
50
59
  describe("SEC-1 — resolveTargetNode-equivalent SELECT respects network_id", () => {
51
60
  // This is the exact query update_node_config / restart_node run
52
61
  // to fetch the target node + check network match. Pinning the SQL
@@ -740,6 +749,34 @@ describe("finalizePendingMatchingUpdates — #260 P5 channels content-match", ()
740
749
  return id;
741
750
  }
742
751
 
752
+ test("variant-capable hot model-only update cannot finish from matching old heartbeat", () => {
753
+ const nid = insertNode({ alias: "n-variant-model-race", network_id: "netA" });
754
+ const uid = insertPendingUpdate({ node_id: nid, network_id: "netA", patch: { model: "fixture/model" }, apply_mode: "hot" });
755
+ const snapshot = { model: "fixture/model", modelVariant: "high", opencode_variant_config_capable: true, flags: {} };
756
+ expect(finalizePendingMatchingUpdates(nid, snapshot).finalizedCount).toBe(0);
757
+ expect(db.get<any>("SELECT status FROM node_config_updates WHERE update_id = ?1", uid).status).toBe("pending");
758
+ });
759
+
760
+ test("ordinary hot model update without variant capability retains content-match", () => {
761
+ const nid = insertNode({ alias: "n-ordinary-model", network_id: "netA" });
762
+ const uid = insertPendingUpdate({ node_id: nid, network_id: "netA", patch: { model: "fixture/model" }, apply_mode: "hot" });
763
+ expect(finalizePendingMatchingUpdates(nid, { model: "fixture/model", flags: {} }).finalizedIds).toContain(uid);
764
+ });
765
+
766
+ test("variant heartbeat match cannot finalize before explicit ack", () => {
767
+ const nid = insertNode({ alias: "n-variant-explicit-ack", network_id: "netA" });
768
+ const uid = insertPendingUpdate({ node_id: nid, network_id: "netA", patch: { modelVariant: "high" }, apply_mode: "hot" });
769
+ expect(finalizePendingMatchingUpdates(nid, { model: "fixture/model", modelVariant: "high", opencode_variant_config_capable: true }).finalizedCount).toBe(0);
770
+ expect(db.get<any>("SELECT status FROM node_config_updates WHERE update_id = ?1", uid).status).toBe("pending");
771
+ });
772
+
773
+ test("ack-required model operation stays pending when later capability readback is missing", () => {
774
+ const nid = insertNode({ alias: "n-variant-capability-lost", network_id: "netA" });
775
+ const uid = insertPendingUpdate({ node_id: nid, network_id: "netA", patch: { model: "fixture/model", _anet_variant_ack_required: true }, apply_mode: "hot" });
776
+ expect(finalizePendingMatchingUpdates(nid, { model: "fixture/model", flags: {} }).finalizedCount).toBe(0);
777
+ expect(db.get<any>("SELECT status FROM node_config_updates WHERE update_id = ?1", uid).status).toBe("pending");
778
+ });
779
+
743
780
  test("channels-only patch: snapshot BEFORE apply (first boot) must NOT finalize", () => {
744
781
  const nid = insertNode({ alias: "n-chan-1", network_id: "netA" });
745
782
  const uid = insertPendingUpdate({
@@ -12,6 +12,10 @@ import {
12
12
  EDITABLE_CHANNELS,
13
13
  isAllowedToChangeFlag,
14
14
  computeApplyMode,
15
+ readOpencodeSnapshotFlags,
16
+ readConfigUpdateCapable,
17
+ configUpdateCapabilityDivergence,
18
+ readSystemdSupervision,
15
19
  validatePatch,
16
20
  narrowChannelsPatch,
17
21
  } from "./config-apply-validate";
@@ -26,20 +30,28 @@ describe("ALLOWED_FLAGS — exact contract (no silent extension)", () => {
26
30
  // the BLOCKER 2 schema-mismatch issue. P2 to add a claude-code-cli
27
31
  // config-apply path.
28
32
  expect([...ALLOWED_FLAGS].sort()).toEqual([
33
+ "approvalPolicy",
29
34
  "budget",
35
+ "copresenceFullAccess",
30
36
  "dangerouslySkipPermissions",
31
37
  "maxTurns",
38
+ "modelReasoningEffort",
32
39
  "permissionMode",
40
+ "sandboxMode",
41
+ "skipGitRepoCheck",
33
42
  "timeout",
34
43
  ]);
35
44
  });
36
45
  });
37
46
 
38
47
  describe("SECURITY_SENSITIVE_FLAGS — privilege-elevation surface", () => {
39
- test("contains the 2 privilege-elevation flags (teammateMode dropped — see ALLOWED_FLAGS comment)", () => {
48
+ test("contains privilege-elevation flags (teammateMode dropped — see ALLOWED_FLAGS comment)", () => {
40
49
  expect([...SECURITY_SENSITIVE_FLAGS].sort()).toEqual([
50
+ "approvalPolicy",
51
+ "copresenceFullAccess",
41
52
  "dangerouslySkipPermissions",
42
53
  "permissionMode",
54
+ "sandboxMode",
43
55
  ]);
44
56
  });
45
57
 
@@ -161,6 +173,10 @@ describe("computeApplyMode — tier classifier (RFC-024 §4)", () => {
161
173
  expect(computeApplyMode("gpt-5", { maxTurns: 50 })).toBe("restart");
162
174
  });
163
175
 
176
+ test("modelReasoningEffort flag alone → restart tier", () => {
177
+ expect(computeApplyMode(undefined, { modelReasoningEffort: "medium" })).toBe("restart");
178
+ });
179
+
164
180
  test("mixed (only hot flags) → hot", () => {
165
181
  expect(computeApplyMode(undefined, { maxTurns: 50, budget: 100 })).toBe("hot");
166
182
  });
@@ -170,6 +186,67 @@ describe("computeApplyMode — tier classifier (RFC-024 §4)", () => {
170
186
  });
171
187
  });
172
188
 
189
+ // #3146 —— 客户端「切模型不必重启」。agent-node 从 OpenCode V2 共存起就能
190
+ // 在运行中的 TUI 会话里换模型,但 hub 把所有 `model` patch 一律判成
191
+ // restart,于是客户端显示「重启中」而节点永远不会重启。
192
+ describe("computeApplyMode — OpenCode V2 hot model switch (#3146)", () => {
193
+ const v2Copresence = {
194
+ runtime: "opencode-sdk",
195
+ opencodeGeneration: "v2" as const,
196
+ opencodeMode: "copresence",
197
+ };
198
+
199
+ test("model alone on an OpenCode V2 co-presence node → hot", () => {
200
+ expect(computeApplyMode("deepseek/deepseek-flash", {}, undefined, v2Copresence)).toBe("hot");
201
+ });
202
+
203
+ test("runtime spelling aliases all resolve to hot (opencode-cli / opencode / opencode-sdk)", () => {
204
+ for (const runtime of ["opencode-sdk", "opencode-cli", "opencode"]) {
205
+ expect(computeApplyMode("m", {}, undefined, { ...v2Copresence, runtime })).toBe("hot");
206
+ }
207
+ });
208
+
209
+ test("model alone without opts keeps the pre-#3146 restart answer", () => {
210
+ expect(computeApplyMode("deepseek/deepseek-flash", {})).toBe("restart");
211
+ });
212
+
213
+ test("v1 node → restart (no live V2 session to switch)", () => {
214
+ expect(computeApplyMode("m", {}, undefined, { ...v2Copresence, opencodeGeneration: "v1" })).toBe("restart");
215
+ });
216
+
217
+ test("unknown generation → restart", () => {
218
+ expect(computeApplyMode("m", {}, undefined, { ...v2Copresence, opencodeGeneration: null })).toBe("restart");
219
+ });
220
+
221
+ test("headless V2 node → restart (no co-presence session to drive)", () => {
222
+ expect(computeApplyMode("m", {}, undefined, { ...v2Copresence, opencodeMode: "headless" })).toBe("restart");
223
+ });
224
+
225
+ test("non-OpenCode runtime → restart", () => {
226
+ expect(computeApplyMode("m", {}, undefined, { ...v2Copresence, runtime: "codex-app-server-sdk" })).toBe("restart");
227
+ });
228
+
229
+ test("model + any flag → restart (mixed patch stays on the restart path)", () => {
230
+ expect(computeApplyMode("m", { maxTurns: 50 }, undefined, v2Copresence)).toBe("restart");
231
+ expect(computeApplyMode("m", { timeout: 60000 }, undefined, v2Copresence)).toBe("restart");
232
+ });
233
+
234
+ test("model + channels → restart", () => {
235
+ expect(computeApplyMode("m", {}, ["feishu"], v2Copresence)).toBe("restart");
236
+ });
237
+
238
+ test("readOpencodeSnapshotFlags parses text, object, and junk", () => {
239
+ expect(readOpencodeSnapshotFlags('{"flags":{"opencodeGeneration":"v2","opencodeMode":"copresence"}}'))
240
+ .toEqual({ opencodeGeneration: "v2", opencodeMode: "copresence" });
241
+ expect(readOpencodeSnapshotFlags({ flags: { opencodeGeneration: "v1" } }))
242
+ .toEqual({ opencodeGeneration: "v1", opencodeMode: null });
243
+ expect(readOpencodeSnapshotFlags("not json")).toEqual({ opencodeGeneration: null, opencodeMode: null });
244
+ expect(readOpencodeSnapshotFlags(null)).toEqual({ opencodeGeneration: null, opencodeMode: null });
245
+ expect(readOpencodeSnapshotFlags('{"flags":{"opencodeGeneration":"v9"}}'))
246
+ .toEqual({ opencodeGeneration: null, opencodeMode: null });
247
+ });
248
+ });
249
+
173
250
  describe("validatePatch — model field", () => {
174
251
  test("undefined model passes (no change)", () => {
175
252
  expect(validatePatch(undefined, {})).toBeNull();
@@ -249,6 +326,15 @@ describe("validatePatch — per-flag enum / range", () => {
249
326
  expect(validatePatch(undefined, { timeout: 3_600_001 })?.field).toBe("flags.timeout");
250
327
  expect(validatePatch(undefined, { timeout: 60.5 })?.field).toBe("flags.timeout");
251
328
  });
329
+ test("timeout: 0 = no limit; 1..999 is seconds-shaped and rejected (#605)", () => {
330
+ expect(validatePatch(undefined, { timeout: 0 })).toBeNull();
331
+ expect(validatePatch(undefined, { timeout: 1000 })).toBeNull();
332
+ for (const v of [1, 600, 999]) {
333
+ const r = validatePatch(undefined, { timeout: v });
334
+ expect(r?.field).toBe("flags.timeout");
335
+ expect(r?.reason).toContain("milliseconds");
336
+ }
337
+ });
252
338
  });
253
339
 
254
340
  describe("validatePatch — combinations", () => {
@@ -350,3 +436,104 @@ describe("validatePatch — channels defensive gate", () => {
350
436
  expect(r?.field).toBe("channels");
351
437
  });
352
438
  });
439
+
440
+ describe("Codex config flags (#815)", () => {
441
+ test("yolo bundle on codex-app-server passes", () => {
442
+ expect(validatePatch(undefined, {
443
+ approvalPolicy: "never",
444
+ sandboxMode: "danger-full-access",
445
+ skipGitRepoCheck: true,
446
+ copresenceFullAccess: true,
447
+ modelReasoningEffort: "low",
448
+ }, undefined, "codex-app-server")).toBeNull();
449
+ });
450
+ test("modelReasoningEffort invalid enum rejected", () => {
451
+ expect(validatePatch(undefined, { modelReasoningEffort: "max" }, undefined, "codex-app-server")?.field)
452
+ .toBe("flags.modelReasoningEffort");
453
+ });
454
+ test("codex flags on claude runtime rejected", () => {
455
+ expect(validatePatch(undefined, { modelReasoningEffort: "low" }, undefined, "claude-agent-sdk")?.field)
456
+ .toBe("flags.modelReasoningEffort");
457
+ });
458
+ });
459
+
460
+ // 裸起节点(无 supervisor)收到 restart-tier 变更会安静地死掉:
461
+ // 写配置 → ack restarting → exit 75 → 没人拉起 → 更新判 timeout,
462
+ // 而调用方只看到「超时」。这里锁住「把后果说在前面」的读法。
463
+ describe("readConfigUpdateCapable", () => {
464
+ test("true / false / absent / junk", () => {
465
+ expect(readConfigUpdateCapable('{"config_update_capable":true}')).toBe(true);
466
+ expect(readConfigUpdateCapable('{"config_update_capable":false}')).toBe(false);
467
+ expect(readConfigUpdateCapable('{"model":"x"}')).toBeNull();
468
+ expect(readConfigUpdateCapable("not json")).toBeNull();
469
+ expect(readConfigUpdateCapable(null)).toBeNull();
470
+ // 非布尔一律 unknown,不能当成 false —— 否则会给没上报的节点发警告
471
+ expect(readConfigUpdateCapable('{"config_update_capable":"false"}')).toBeNull();
472
+ });
473
+ });
474
+
475
+ describe("readConfigUpdateCapable — restart_supervised 优先", () => {
476
+ test("prefers the named key when both are present", () => {
477
+ expect(readConfigUpdateCapable('{"restart_supervised":true,"config_update_capable":false}')).toBe(true);
478
+ expect(readConfigUpdateCapable('{"restart_supervised":false,"config_update_capable":true}')).toBe(false);
479
+ });
480
+ test("falls back to the legacy key for old nodes", () => {
481
+ expect(readConfigUpdateCapable('{"config_update_capable":true}')).toBe(true);
482
+ });
483
+ test("non-boolean named value falls through to legacy, then unknown", () => {
484
+ expect(readConfigUpdateCapable('{"restart_supervised":"true","config_update_capable":false}')).toBe(false);
485
+ expect(readConfigUpdateCapable('{"restart_supervised":"true"}')).toBeNull();
486
+ });
487
+ });
488
+
489
+ // 2026-10-31 —— 「被遮住的值」必须能被看见。
490
+ // readConfigUpdateCapable 一旦选定 restart_supervised,config_update_capable 就再也读不到了;
491
+ // 而「两个一致」与「有一个被遮住了」在调用方看来完全一样 —— 这是隐式回退的通用形状。
492
+ describe("configUpdateCapabilityDivergence — 双写字段的分歧本身就是读数", () => {
493
+ test("reports both values when they disagree, in either direction", () => {
494
+ expect(configUpdateCapabilityDivergence('{"restart_supervised":true,"config_update_capable":false}'))
495
+ .toEqual({ named: true, legacy: false });
496
+ expect(configUpdateCapabilityDivergence('{"restart_supervised":false,"config_update_capable":true}'))
497
+ .toEqual({ named: false, legacy: true });
498
+ });
499
+ test("stays quiet when they agree — that is the documented normal case", () => {
500
+ expect(configUpdateCapabilityDivergence('{"restart_supervised":true,"config_update_capable":true}')).toBeNull();
501
+ expect(configUpdateCapabilityDivergence('{"restart_supervised":false,"config_update_capable":false}')).toBeNull();
502
+ });
503
+ test("no divergence to report when only one field is present or shapes are unusable", () => {
504
+ expect(configUpdateCapabilityDivergence('{"restart_supervised":true}')).toBeNull();
505
+ expect(configUpdateCapabilityDivergence('{"config_update_capable":true}')).toBeNull();
506
+ expect(configUpdateCapabilityDivergence('{"restart_supervised":"true","config_update_capable":false}')).toBeNull();
507
+ expect(configUpdateCapabilityDivergence("")).toBeNull();
508
+ expect(configUpdateCapabilityDivergence("not json")).toBeNull();
509
+ expect(configUpdateCapabilityDivergence(null)).toBeNull();
510
+ expect(configUpdateCapabilityDivergence(undefined)).toBeNull();
511
+ });
512
+ test("accepts an already-parsed object (nodes may hand us either form)", () => {
513
+ expect(configUpdateCapabilityDivergence({ restart_supervised: true, config_update_capable: false }))
514
+ .toEqual({ named: true, legacy: false });
515
+ });
516
+ });
517
+
518
+
519
+ // 2026-10-31 —— #3168:节点自报的三态托管判定。
520
+ // 「它说自己没人拉」与「它说有人拉」处置相反;而「不知道」两边都不能当。
521
+ describe("readSystemdSupervision", () => {
522
+ test("reads the three declared states verbatim", () => {
523
+ expect(readSystemdSupervision(JSON.stringify({ systemd_supervision: "supervised" }))).toBe("supervised");
524
+ expect(readSystemdSupervision('{"systemd_supervision":"not_supervised"}')).toBe("not_supervised");
525
+ expect(readSystemdSupervision({ systemd_supervision: "unknown" })).toBe("unknown");
526
+ });
527
+
528
+ test("missing field ⇒ null, which is NOT the same as unknown", () => {
529
+ // 缺失 = 这一版还不会报(老节点);unknown = 会报但这次判不出来。
530
+ expect(readSystemdSupervision('{"config_update_capable":false}')).toBeNull();
531
+ expect(readSystemdSupervision("")).toBeNull();
532
+ expect(readSystemdSupervision("not json")).toBeNull();
533
+ });
534
+
535
+ test("rejects values outside the declared set (a typo must not silently mean 'supervised')", () => {
536
+ expect(readSystemdSupervision('{"systemd_supervision":"yes"}')).toBeNull();
537
+ expect(readSystemdSupervision('{"systemd_supervision":true}')).toBeNull();
538
+ });
539
+ });