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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (482) hide show
  1. package/README.md +120 -3
  2. package/bin/commhub.ts +93 -9
  3. package/build-info.json +7 -0
  4. package/package.json +10 -8
  5. package/src/ack-create-request-transport.test.ts +182 -0
  6. package/src/ack-create-request.test.ts +52 -8
  7. package/src/admin-delete-network-http.test.ts +229 -0
  8. package/src/admin-networks-http.test.ts +88 -0
  9. package/src/adoption-candidates-http.test.ts +140 -0
  10. package/src/adoption-candidates.ts +158 -0
  11. package/src/agent-access-batch.test.ts +215 -0
  12. package/src/agent-access.ts +585 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +691 -0
  15. package/src/agent-acl-slice3-http.test.ts +888 -0
  16. package/src/agent-department-grants.test.ts +129 -0
  17. package/src/agent-department-http.test.ts +215 -0
  18. package/src/agent-groups-perf.test.ts +228 -0
  19. package/src/agent-notice.ts +48 -0
  20. package/src/agent-team-whoami-http.test.ts +98 -0
  21. package/src/agent-teams-http.test.ts +330 -0
  22. package/src/agent-teams.ts +244 -0
  23. package/src/alias-baseline-2571.test.ts +162 -0
  24. package/src/alias-baseline.ts +113 -0
  25. package/src/alias-filter.test.ts +72 -0
  26. package/src/alias-filter.ts +42 -0
  27. package/src/all-status-cache.test.ts +31 -0
  28. package/src/all-status-cache.ts +37 -0
  29. package/src/anet-variant-real-daemon-http.test.ts +185 -0
  30. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  31. package/src/api-host-supervisors-fallback.test.ts +6 -7
  32. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  33. package/src/api-nodes-shape.test.ts +131 -4
  34. package/src/auth-abuse-counters.test.ts +144 -0
  35. package/src/auth-abuse-counters.ts +122 -0
  36. package/src/auth-layer-shape.test.ts +105 -0
  37. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  38. package/src/auth-sessions-http.test.ts +260 -0
  39. package/src/auth-validate.test.ts +5 -1
  40. package/src/auth-weak-password-login.test.ts +176 -0
  41. package/src/auth.ts +641 -68
  42. package/src/backfill-node-ids-2664.test.ts +128 -0
  43. package/src/binding-generation-http.test.ts +141 -0
  44. package/src/blocked-exit-on-reply.test.ts +122 -0
  45. package/src/broadcast-fanout-2721.test.ts +149 -0
  46. package/src/broadcast-fanout.ts +117 -0
  47. package/src/build-commit-report-http.test.ts +219 -0
  48. package/src/build-info.test.ts +60 -0
  49. package/src/build-info.ts +85 -0
  50. package/src/chain-attempt-dedup.test.ts +447 -0
  51. package/src/clip.test.ts +36 -0
  52. package/src/clip.ts +48 -0
  53. package/src/clone-node.test.ts +269 -0
  54. package/src/clone-node.ts +289 -0
  55. package/src/codex-config-flags.ts +77 -0
  56. package/src/codex-fork-contract.ts +23 -0
  57. package/src/codex-fork-migration.test.ts +38 -0
  58. package/src/commhub-bin-args.test.ts +85 -0
  59. package/src/config-apply-sec1.test.ts +37 -0
  60. package/src/config-apply-validate.test.ts +188 -1
  61. package/src/config-apply-validate.ts +226 -3
  62. package/src/contracts/session-project-create.ts +14 -0
  63. package/src/contracts/session-source-delivery.ts +16 -0
  64. package/src/contracts/session-source-directory.ts +54 -0
  65. package/src/contracts/session-source-evidence.ts +72 -0
  66. package/src/contracts/session-source-execution.ts +24 -0
  67. package/src/contracts/session-source-transport.ts +18 -0
  68. package/src/cors-origins.test.ts +73 -0
  69. package/src/create-node-blocked-gate.test.ts +365 -0
  70. package/src/create-node-error-domain.test.ts +127 -0
  71. package/src/create-node-network-id.test.ts +91 -0
  72. package/src/create-node-tool-schema.test.ts +59 -0
  73. package/src/create-node-unicode-name.test.ts +126 -0
  74. package/src/create-node-validate.test.ts +199 -7
  75. package/src/create-node-validate.ts +232 -15
  76. package/src/create-node-workdir.test.ts +298 -0
  77. package/src/create-node.ts +88 -23
  78. package/src/daemon-provider-snapshots.test.ts +453 -0
  79. package/src/daemon-provider-snapshots.ts +327 -0
  80. package/src/daemon-token-owner-http.test.ts +346 -0
  81. package/src/dashboard-slash-routing-http.test.ts +109 -0
  82. package/src/db-adapter-guard.test.ts +148 -0
  83. package/src/db-adapter-translate.test.ts +128 -0
  84. package/src/db-adapter.ts +377 -91
  85. package/src/db-timestamp.test.ts +38 -0
  86. package/src/db-timestamp.ts +15 -0
  87. package/src/db.ts +1334 -154
  88. package/src/delivered-without-push.test.ts +140 -0
  89. package/src/department-groups-http.test.ts +209 -0
  90. package/src/department-groups-sync-http.test.ts +328 -0
  91. package/src/department-groups.ts +434 -0
  92. package/src/department-heads-http.test.ts +350 -0
  93. package/src/department-heads.ts +226 -0
  94. package/src/departments-agent-count.test.ts +139 -0
  95. package/src/departments-http.test.ts +185 -0
  96. package/src/departments-mcp-error-domain.test.ts +135 -0
  97. package/src/departments-mcp.test.ts +128 -0
  98. package/src/departments.ts +318 -0
  99. package/src/desktop-message-seam.test.ts +150 -0
  100. package/src/desktop-message.test.ts +368 -0
  101. package/src/dm-file-scope-http.test.ts +227 -0
  102. package/src/empty-node-sweeper.test.ts +104 -0
  103. package/src/empty-node-sweeper.ts +88 -0
  104. package/src/env-transport-gate-http.test.ts +240 -0
  105. package/src/env-transport-gate.ts +80 -0
  106. package/src/env-transport-policy.ts +56 -0
  107. package/src/etag-of.test.ts +57 -0
  108. package/src/event-loop-lag.test.ts +180 -0
  109. package/src/event-loop-lag.ts +201 -0
  110. package/src/expiry-counters.test.ts +187 -0
  111. package/src/expiry-counters.ts +227 -0
  112. package/src/expiry-evidence-db.test.ts +103 -0
  113. package/src/ext-token-shared.test.ts +60 -0
  114. package/src/ext-validation-regression.test.ts +10 -17
  115. package/src/external-schedule-edits-http.test.ts +321 -0
  116. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  117. package/src/external-schedule-edits.ts +327 -0
  118. package/src/file-download-authz-dev-open.test.ts +1 -1
  119. package/src/file-download-authz.test.ts +25 -4
  120. package/src/file-download-date-bucket.test.ts +1 -1
  121. package/src/file-network-scope-dev-open.test.ts +1 -1
  122. package/src/file-network-scope.test.ts +7 -6
  123. package/src/group-membership-events-http.test.ts +264 -0
  124. package/src/group-messages-http.test.ts +483 -0
  125. package/src/group-messages.ts +297 -0
  126. package/src/health-anon-readers.ts +67 -0
  127. package/src/health-host-disk-2756.test.ts +71 -0
  128. package/src/health-identity-root.test.ts +98 -0
  129. package/src/health-redaction.test.ts +1603 -7
  130. package/src/health-status-reasons.test.ts +84 -0
  131. package/src/host-supervisor-identity-http.test.ts +152 -0
  132. package/src/host-supervisor-identity.ts +92 -0
  133. package/src/host-supervisors-daemon-version.test.ts +137 -0
  134. package/src/http-gzip.test.ts +94 -0
  135. package/src/http-gzip.ts +112 -0
  136. package/src/hub-catalog-read-http.test.ts +664 -0
  137. package/src/hub-provider-config.test.ts +166 -0
  138. package/src/hub-provider-config.ts +202 -0
  139. package/src/hub-timestamp.test.ts +38 -0
  140. package/src/hub-timestamp.ts +27 -0
  141. package/src/human-dm.ts +215 -0
  142. package/src/human-inbox.ts +42 -0
  143. package/src/inbox-caller.ts +49 -0
  144. package/src/inbox-count-sse.test.ts +318 -0
  145. package/src/inbox-count.ts +29 -0
  146. package/src/index.ts +6 -2
  147. package/src/launched-by-cli-report-http.test.ts +155 -0
  148. package/src/license-state.test.ts +105 -0
  149. package/src/license-state.ts +48 -0
  150. package/src/lifecycle-error-domain.test.ts +149 -0
  151. package/src/list-ack-error-domain.test.ts +108 -0
  152. package/src/list-host-supervisors.test.ts +15 -4
  153. package/src/list-tasks-omit-default.test.ts +84 -0
  154. package/src/list-tasks-since-last.test.ts +100 -0
  155. package/src/list-tasks-since.test.ts +104 -0
  156. package/src/mcp-context-cost-http.test.ts +127 -0
  157. package/src/mcp-inflight.test.ts +92 -0
  158. package/src/mcp-inflight.ts +38 -0
  159. package/src/mcp-projects-events-http.test.ts +168 -0
  160. package/src/mcp-route-label-http.test.ts +120 -0
  161. package/src/mcp-write-network-resolution.test.ts +21 -0
  162. package/src/member-audit-network-id-http.test.ts +93 -0
  163. package/src/member-presence-http.test.ts +210 -0
  164. package/src/messages-ack-by-agent-http.test.ts +142 -0
  165. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  166. package/src/migrate-sqlite-to-pg.ts +263 -0
  167. package/src/model-auth-notify-http.test.ts +181 -0
  168. package/src/model-auth-notify.ts +116 -0
  169. package/src/network-name-http.test.ts +75 -0
  170. package/src/network-quota-config.test.ts +100 -0
  171. package/src/network-rules-http.test.ts +169 -0
  172. package/src/network-rules.ts +129 -0
  173. package/src/network-scope.ts +222 -3
  174. package/src/network-token-membership-http.test.ts +186 -0
  175. package/src/node-alias-control.ts +12 -0
  176. package/src/node-attrs.test.ts +47 -2
  177. package/src/node-caller-identity-http.test.ts +1108 -0
  178. package/src/node-config-last-update.test.ts +126 -0
  179. package/src/node-config-last-update.ts +107 -0
  180. package/src/node-create-request-status-http.test.ts +105 -0
  181. package/src/node-daemon-bindings.test.ts +142 -0
  182. package/src/node-daemon-bindings.ts +135 -0
  183. package/src/node-failure-alert.test.ts +150 -0
  184. package/src/node-failure-alert.ts +177 -0
  185. package/src/node-files-transport.test.ts +350 -0
  186. package/src/node-health-codex-login.test.ts +120 -0
  187. package/src/node-health-dispatch-http.test.ts +373 -0
  188. package/src/node-health-guard-origin.test.ts +98 -0
  189. package/src/node-health-guard.ts +121 -0
  190. package/src/node-health-passthrough.test.ts +115 -0
  191. package/src/node-health-store.ts +101 -0
  192. package/src/node-id-alias.test.ts +190 -0
  193. package/src/node-identity-conflict-http.test.ts +269 -0
  194. package/src/node-identity-conflict.ts +142 -0
  195. package/src/node-identity-mismatch.test.ts +74 -0
  196. package/src/node-in-flight-tasks.ts +31 -0
  197. package/src/node-inbox-allowlist-http.test.ts +320 -0
  198. package/src/node-lifecycle-controllable.test.ts +64 -0
  199. package/src/node-lifecycle-controllable.ts +53 -0
  200. package/src/node-lifecycle-read-http.test.ts +257 -0
  201. package/src/node-lifecycle-read.ts +126 -0
  202. package/src/node-logs-transport.test.ts +266 -0
  203. package/src/node-peer-allowlist.test.ts +114 -0
  204. package/src/node-permissions-http.test.ts +901 -0
  205. package/src/node-permissions.ts +627 -0
  206. package/src/node-request-retention.test.ts +281 -0
  207. package/src/node-request-retention.ts +120 -0
  208. package/src/node-secret-rest-http.test.ts +190 -0
  209. package/src/node-secret-vault-inject.test.ts +132 -0
  210. package/src/node-security-write-gate.test.ts +72 -0
  211. package/src/node-serviceability.test.ts +86 -0
  212. package/src/node-serviceability.ts +124 -0
  213. package/src/node-session-control-http.test.ts +398 -0
  214. package/src/node-session-control.ts +316 -0
  215. package/src/node-skills-transport.test.ts +212 -0
  216. package/src/node-token-identity.ts +35 -0
  217. package/src/node-token-ownership.ts +51 -0
  218. package/src/node-token-privilege-http.test.ts +224 -0
  219. package/src/node-token-usage.test.ts +128 -0
  220. package/src/node-token-usage.ts +228 -0
  221. package/src/not-found-api-http.test.ts +67 -0
  222. package/src/observer-avatar-http.test.ts +103 -10
  223. package/src/observer-push.test.ts +76 -0
  224. package/src/opencode-catalog-report-http.test.ts +139 -0
  225. package/src/opencode-v2-catalog.test.ts +282 -0
  226. package/src/opencode-v2-catalog.ts +357 -0
  227. package/src/package-self-contained.test.ts +32 -0
  228. package/src/package-version-consistency.test.ts +25 -0
  229. package/src/parent-infer.test.ts +82 -0
  230. package/src/parent-infer.ts +110 -0
  231. package/src/parent-source-marker.test.ts +70 -0
  232. package/src/parent-source-orphan.test.ts +121 -0
  233. package/src/password-network-tokens.ts +25 -0
  234. package/src/peer-reply-atomic.test.ts +462 -0
  235. package/src/peer-reply-capability.test.ts +70 -0
  236. package/src/pg-worker.ts +87 -0
  237. package/src/poll-pacing.test.ts +74 -0
  238. package/src/poll-pacing.ts +123 -0
  239. package/src/probe-provider-error-domain.test.ts +145 -0
  240. package/src/project-dir-warn-clear-http.test.ts +132 -0
  241. package/src/project-viewer-can-http.test.ts +116 -0
  242. package/src/provider-skill-error-domain.test.ts +130 -0
  243. package/src/provider-tools-shape.test.ts +165 -0
  244. package/src/push.test.ts +20 -10
  245. package/src/push.ts +373 -9
  246. package/src/redact-tokens.test.ts +86 -0
  247. package/src/redact-tokens.ts +43 -0
  248. package/src/rejection-counters.test.ts +72 -0
  249. package/src/rejection-counters.ts +173 -0
  250. package/src/rename.ts +38 -10
  251. package/src/reply-target-derivation.test.ts +96 -0
  252. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  253. package/src/report-status-host-schema.test.ts +272 -0
  254. package/src/report-status-resume-id-handover.test.ts +184 -0
  255. package/src/report-status-secret-keys.test.ts +140 -0
  256. package/src/require-explicit-test-db.ts +9 -0
  257. package/src/requirement-due-reminders-http.test.ts +620 -0
  258. package/src/requirement-due-reminders.ts +416 -0
  259. package/src/requirement-events-http.test.ts +318 -0
  260. package/src/requirement-events.test.ts +45 -0
  261. package/src/requirement-events.ts +144 -0
  262. package/src/requirement-notify.ts +165 -0
  263. package/src/requirement-participant-notify-http.test.ts +313 -0
  264. package/src/requirement-tag-ops-http.test.ts +454 -0
  265. package/src/requirement-tag-tree-http.test.ts +275 -0
  266. package/src/requirement-tag-tree.ts +127 -0
  267. package/src/requirement-tags.ts +102 -0
  268. package/src/requirements-abandoned-http.test.ts +236 -0
  269. package/src/requirements-assignee-drift.test.ts +154 -0
  270. package/src/requirements-comment-http.test.ts +174 -0
  271. package/src/requirements-completed-at-migration.test.ts +70 -0
  272. package/src/requirements-errors-mcp-http.test.ts +164 -0
  273. package/src/requirements-errors.ts +158 -0
  274. package/src/requirements-etag-http.test.ts +91 -0
  275. package/src/requirements-http.test.ts +709 -0
  276. package/src/requirements-last-event-http.test.ts +349 -0
  277. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  278. package/src/requirements-list-slim-http.test.ts +324 -0
  279. package/src/requirements-mcp.test.ts +180 -0
  280. package/src/requirements-migrate.ts +283 -0
  281. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  282. package/src/requirements-people-http.test.ts +114 -0
  283. package/src/requirements-people-mcp-http.test.ts +231 -0
  284. package/src/requirements-people.ts +196 -0
  285. package/src/requirements-priority-lowest.test.ts +114 -0
  286. package/src/requirements-projects-network-echo.test.ts +57 -0
  287. package/src/requirements-projects-parent-http.test.ts +123 -0
  288. package/src/requirements-search-http.test.ts +182 -0
  289. package/src/requirements-search.test.ts +32 -0
  290. package/src/requirements-search.ts +145 -0
  291. package/src/requirements-seq-http.test.ts +193 -0
  292. package/src/requirements-seq-migration.test.ts +63 -0
  293. package/src/requirements-start-date.test.ts +125 -0
  294. package/src/requirements-stats-http.test.ts +357 -0
  295. package/src/requirements-stats.ts +195 -0
  296. package/src/requirements-status-participants-http.test.ts +222 -0
  297. package/src/requirements-upgrade-e2e.test.ts +126 -0
  298. package/src/requirements-upgrade-migration.test.ts +98 -0
  299. package/src/requirements.ts +2205 -0
  300. package/src/resolve-port.test.ts +57 -0
  301. package/src/resolve-port.ts +44 -0
  302. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  303. package/src/rest-alias-network-fallback.test.ts +60 -0
  304. package/src/rest-alias-network-fallback.ts +65 -0
  305. package/src/rest-explicit-columns-http.test.ts +266 -0
  306. package/src/rest-identity.test.ts +130 -0
  307. package/src/rest-identity.ts +141 -0
  308. package/src/rest-projections.ts +72 -0
  309. package/src/rest-read-network-real-chain.test.ts +97 -0
  310. package/src/rest-write-network-resolution.test.ts +133 -0
  311. package/src/restart-readiness-http.test.ts +121 -0
  312. package/src/restricted-files.ts +76 -0
  313. package/src/retention-first-sweep-quiet.test.ts +31 -0
  314. package/src/retention.test.ts +100 -40
  315. package/src/retention.ts +423 -104
  316. package/src/route-callers-http.test.ts +120 -0
  317. package/src/route-timing.test.ts +218 -0
  318. package/src/route-timing.ts +262 -0
  319. package/src/rules-file-duplicate-alias.test.ts +234 -0
  320. package/src/rules-file-session-target.test.ts +207 -0
  321. package/src/rules-file-transport.test.ts +280 -0
  322. package/src/runtime-label.test.ts +22 -0
  323. package/src/runtime-label.ts +21 -0
  324. package/src/runtime-readiness.ts +90 -0
  325. package/src/schedule-agent-mcp-http.test.ts +486 -0
  326. package/src/schedule-agent.ts +252 -0
  327. package/src/schedule-starved.test.ts +92 -0
  328. package/src/schedule-starved.ts +114 -0
  329. package/src/scheduled-backoff-http.test.ts +203 -0
  330. package/src/scheduled-backoff.ts +64 -0
  331. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  332. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  333. package/src/scheduled-failure-code.test.ts +73 -0
  334. package/src/scheduled-failure-code.ts +105 -0
  335. package/src/scheduled-failures-http.test.ts +279 -0
  336. package/src/scheduled-failures.ts +425 -0
  337. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  338. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  339. package/src/scheduled-offline.test.ts +131 -0
  340. package/src/scheduled-offline.ts +66 -0
  341. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  342. package/src/scheduled-outcome-guidance.ts +9 -0
  343. package/src/scheduled-reply-unread-http.test.ts +212 -0
  344. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  345. package/src/scheduled-requirement-wake.ts +125 -0
  346. package/src/scheduled-run-terminal.test.ts +290 -0
  347. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  348. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  349. package/src/scheduled-stuck-http.test.ts +316 -0
  350. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  351. package/src/scheduled-stuck.ts +219 -0
  352. package/src/scheduled-tasks-http.test.ts +679 -0
  353. package/src/scheduled-tasks.ts +980 -0
  354. package/src/scheduled-work-outcome-http.test.ts +154 -0
  355. package/src/scheduled-work-outcome.ts +50 -0
  356. package/src/scoped-secrets.ts +167 -0
  357. package/src/secret-echo-negative-control.test.ts +118 -0
  358. package/src/send-dedup-request-id.test.ts +229 -0
  359. package/src/send-reply-agent-warning.test.ts +38 -38
  360. package/src/send-reply-alias-optional.test.ts +131 -0
  361. package/src/send-reply-attachments.test.ts +28 -7
  362. package/src/send_dedup.test.ts +54 -0
  363. package/src/send_dedup.ts +52 -6
  364. package/src/serve-error.test.ts +73 -0
  365. package/src/serve-error.ts +56 -0
  366. package/src/server.ts +5103 -377
  367. package/src/session-fork-store.test.ts +43 -0
  368. package/src/session-fork-store.ts +51 -0
  369. package/src/session-project-attach-migration.test.ts +23 -0
  370. package/src/session-project-attach-native.test.ts +123 -0
  371. package/src/session-project-create-http.test.ts +408 -0
  372. package/src/session-project-create-native.test.ts +292 -0
  373. package/src/session-project-create.ts +159 -0
  374. package/src/session-source-admission-store.ts +58 -0
  375. package/src/session-source-create.test.ts +155 -0
  376. package/src/session-source-create.ts +97 -0
  377. package/src/session-source-delivery.ts +114 -0
  378. package/src/session-source-directory-http.test.ts +196 -0
  379. package/src/session-source-evidence.test.ts +905 -0
  380. package/src/session-source-evidence.ts +191 -0
  381. package/src/session-source-execution.ts +87 -0
  382. package/src/session-source-grant.test.ts +117 -0
  383. package/src/session-source-grant.ts +78 -0
  384. package/src/session-source-issuer.test.ts +250 -0
  385. package/src/session-source-issuer.ts +164 -0
  386. package/src/session-source-transport.ts +381 -0
  387. package/src/session-task-on-dispatch.ts +14 -0
  388. package/src/session-token-ownership-http.test.ts +122 -0
  389. package/src/shared/codex-inventory.ts +41 -0
  390. package/src/shared/daemon-provider-login.ts +31 -0
  391. package/src/shared/daemon-provider-snapshot.ts +52 -0
  392. package/src/shared/external-schedule-contract.ts +60 -0
  393. package/src/shared/node-name.test.ts +62 -0
  394. package/src/shared/node-name.ts +161 -0
  395. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  396. package/src/shared/provider-application.ts +29 -0
  397. package/src/shared/provider-collection.ts +14 -0
  398. package/src/shared/provider-initialization.ts +8 -0
  399. package/src/shared/reserved-env-drift.test.ts +10 -0
  400. package/src/shared/scoped-secret-contract.ts +5 -0
  401. package/src/shared/task-content-limit-drift.test.ts +28 -0
  402. package/src/shared/task-content-limit.ts +25 -0
  403. package/src/side-thread-command-transport.test.ts +312 -0
  404. package/src/side-thread-command-transport.ts +318 -0
  405. package/src/side-thread-http-integration.test.ts +233 -0
  406. package/src/side-thread-http.ts +504 -0
  407. package/src/side-thread-production.test.ts +72 -0
  408. package/src/side-thread-production.ts +118 -0
  409. package/src/side-thread.test.ts +1067 -0
  410. package/src/side-thread.ts +2499 -0
  411. package/src/skillhub-http.test.ts +144 -0
  412. package/src/sqlite-close-checkpoint.test.ts +78 -0
  413. package/src/start-node.test.ts +265 -0
  414. package/src/start-request-error-domain.test.ts +182 -0
  415. package/src/start-skill-error-domain.test.ts +122 -0
  416. package/src/stats-versions-http.test.ts +65 -0
  417. package/src/status-alias-filter-http.test.ts +106 -0
  418. package/src/status-alias-resolver-http.test.ts +163 -0
  419. package/src/status-alias-resolver.ts +19 -0
  420. package/src/status-node-id-filter-http.test.ts +161 -0
  421. package/src/status-node-secrets-capable-http.test.ts +44 -0
  422. package/src/status-read-cache-http.test.ts +229 -0
  423. package/src/status-read-cache.ts +129 -0
  424. package/src/stop-delete-node.test.ts +567 -1
  425. package/src/task-access-http.test.ts +407 -0
  426. package/src/task-access.ts +420 -0
  427. package/src/task-activity.ts +60 -0
  428. package/src/task-auth-origin-http.test.ts +93 -0
  429. package/src/task-auth-origin.test.ts +24 -0
  430. package/src/task-auth-origin.ts +7 -0
  431. package/src/task-consumption.test.ts +512 -0
  432. package/src/task-diagnostic-http.test.ts +149 -0
  433. package/src/task-diagnostic.test.ts +115 -0
  434. package/src/task-diagnostic.ts +118 -0
  435. package/src/task-expiry-notice-http.test.ts +298 -0
  436. package/src/task-expiry-notice.ts +318 -0
  437. package/src/task-idempotency-mcp.test.ts +148 -0
  438. package/src/task-idempotency.test.ts +76 -0
  439. package/src/task-idempotency.ts +81 -0
  440. package/src/task-late-replies.ts +54 -0
  441. package/src/task-late-reply-http.test.ts +227 -0
  442. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  443. package/src/task-lifecycle-watcher.test.ts +209 -0
  444. package/src/task-lifecycle-watcher.ts +109 -0
  445. package/src/task-network-resolution-http.test.ts +140 -0
  446. package/src/task-not-found-error-domain.test.ts +117 -0
  447. package/src/task-offline-delivery-2668.test.ts +119 -0
  448. package/src/task-offline-delivery.ts +81 -0
  449. package/src/task-orphan-http.test.ts +287 -0
  450. package/src/task-orphan.ts +119 -0
  451. package/src/task-queue-ahead-http.test.ts +309 -0
  452. package/src/task-queue-ahead-scale.test.ts +236 -0
  453. package/src/task-queue-ahead.ts +186 -0
  454. package/src/task-rejection-log-http.test.ts +160 -0
  455. package/src/task-rejection-log.ts +61 -0
  456. package/src/task-sender-http.test.ts +143 -0
  457. package/src/task-stale-open-http.test.ts +292 -0
  458. package/src/task-stale-open.ts +103 -0
  459. package/src/tasks-pagination-http.test.ts +141 -0
  460. package/src/team-rules-status-http.test.ts +90 -0
  461. package/src/team-rules-status.test.ts +59 -0
  462. package/src/team-rules-status.ts +72 -0
  463. package/src/test-work-root.ts +18 -0
  464. package/src/tmux-allowlist.test.ts +48 -0
  465. package/src/token-usage-http.test.ts +156 -0
  466. package/src/tool-audience-http.test.ts +266 -0
  467. package/src/tool-audience.ts +130 -0
  468. package/src/tools-list-json-schema.test.ts +94 -0
  469. package/src/tools.ts +4557 -472
  470. package/src/update-node-config-error-domain.test.ts +107 -0
  471. package/src/uploads-http.test.ts +6 -4
  472. package/src/uploads.ts +23 -4
  473. package/src/user-avatar-http.test.ts +74 -0
  474. package/src/user-avatar-image.ts +160 -0
  475. package/src/user-avatar-migration.test.ts +25 -0
  476. package/src/user-avatar-upload-http.test.ts +353 -0
  477. package/src/user-inbox-by-agent-http.test.ts +189 -0
  478. package/src/user-inbox-netid-notnull.test.ts +122 -0
  479. package/src/user-inbox-read-http.test.ts +223 -0
  480. package/src/user-inbox-schema.test.ts +54 -0
  481. package/src/version-stats.test.ts +66 -0
  482. package/src/version-stats.ts +109 -0
@@ -0,0 +1,320 @@
1
+ // 收件白名单(接收侧)—— 节点的主人限定「谁能给它派活 / 发消息」。全部经真实 HTTP 入口(bootServer + REST / /mcp)。
2
+ //
3
+ // 钉住:
4
+ // 1. PUT /api/nodes/:id/inbox-allowlist 与 peer-allowlist 同形:{ senders } / 200 回 { ok, node_id, senders } /
5
+ // [] 拒收 / 非数组 400 / 超 200 条 400 / 普通成员 403 且行没变 / 节点令牌 403 / 不存在 404 / null 清空 / 审计一行。
6
+ // 2. GET /api/nodes 读回 inbox_allowlist;/health 的 capabilities 带 node_inbox_allowlist。
7
+ // 3. 节点发件人按 alias / node_id 匹配;不在名单 ⇒ node_permission_denied + sender_not_allowed + hint,
8
+ // 覆盖 MCP send_task / send_message / retry_task / reassign_task 与 REST POST /api/task;开关 off 也照拒(显式原因)。
9
+ // 4. 人类发件人按 user:<username> / user:<user_id> / user:* 匹配;节点主人、网络 owner/admin 隐式放行,!strict 关掉隐式放行。
10
+ // 5. 发给自己永远放行(含 !strict)。6. 广播跳过不收的收件人并在 inbox_skipped 里报告(没人被跳过时没有这个键),不让整条广播失败。
11
+ //
12
+ // 跑法:COMMHUB_DB=/tmp/x.db bun test server/src/node-inbox-allowlist-http.test.ts
13
+ import { afterAll, afterEach, beforeAll, describe, expect, test } from "bun:test";
14
+ import { addNetworkMember, createNetworkTokenForNode, register } from "./auth.js";
15
+ import { db } from "./db.js";
16
+ import { inboxAllows } from "./node-permissions.js";
17
+
18
+ const activeDbPath = process.env.COMMHUB_DB ?? (process.env.COMMHUB_TEST_PG_URL ? "postgres" : undefined);
19
+ if (!activeDbPath) throw new Error("node-inbox-allowlist requires COMMHUB_DB (or COMMHUB_TEST_PG_URL) before module import");
20
+
21
+ const stamp = Date.now();
22
+ const PW = "InboxAllow123!";
23
+ let server: any, base = "", net = "";
24
+ const user: Record<string, { id: string; name: string; token: string }> = {};
25
+ const node: Record<string, { id: string; alias: string; token: string }> = {};
26
+
27
+ async function call(token: string, method: string, path: string, body?: unknown) {
28
+ const r = await fetch(`${base}${path}`, {
29
+ method, headers: { Authorization: `Bearer ${token}`, ...(body === undefined ? {} : { "Content-Type": "application/json" }) },
30
+ body: body === undefined ? undefined : JSON.stringify(body),
31
+ });
32
+ const text = await r.text();
33
+ let json: any = null; try { json = JSON.parse(text); } catch {}
34
+ return { status: r.status, body: json, text };
35
+ }
36
+ async function mcp(token: string, name: string, args: Record<string, unknown>): Promise<any> {
37
+ const r = await fetch(`${base}/mcp`, {
38
+ method: "POST",
39
+ headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json", Accept: "application/json, text/event-stream" },
40
+ body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: { name, arguments: args } }),
41
+ });
42
+ const text = await r.text();
43
+ const data = text.split("\n").find((l) => l.startsWith("data: "));
44
+ const msg = JSON.parse(data ? data.slice(6) : text);
45
+ const inner = msg.result?.content?.[0]?.text;
46
+ try { return JSON.parse(inner); } catch { return { raw: inner ?? msg }; }
47
+ }
48
+ const setInbox = (list: string[] | null) =>
49
+ db.run("UPDATE nodes SET inbox_allowlist = ?1 WHERE node_id = ?2", [list ? JSON.stringify(list) : null, node.tgt.id]);
50
+ const storedInbox = () => db.get<{ v: string | null }>("SELECT inbox_allowlist AS v FROM nodes WHERE node_id = ?1", node.tgt.id)!.v;
51
+ const inboxRowsFor = (alias: string) => Number(db.get<{ n: number | string }>(
52
+ "SELECT COUNT(*) AS n FROM inbox WHERE session_name = ?1 AND network_id = ?2", alias, net)!.n);
53
+ const expectSenderDenied = (body: any, sender: string) => {
54
+ expect(body.ok).toBe(false);
55
+ expect(body.error).toBe("node_permission_denied");
56
+ expect(body.reason).toBe("sender_not_allowed");
57
+ expect(typeof body.hint).toBe("string");
58
+ expect(body.hint).toContain("inbox allowlist");
59
+ expect(body.target).toBe(node.tgt.alias);
60
+ expect(body.sender).toBe(sender);
61
+ };
62
+
63
+ beforeAll(async () => {
64
+ const boss = register(`ia_boss_${stamp}`, PW);
65
+ net = boss.network_id!;
66
+ user.boss = { id: boss.user!.user_id, name: `ia_boss_${stamp}`, token: boss.token! };
67
+ for (const [k, role] of [["own", "member"], ["adm", "admin"], ["mem", "member"], ["out", null]] as const) {
68
+ const name = `ia_${k}_${stamp}`;
69
+ const u = register(name, PW);
70
+ user[k] = { id: u.user!.user_id, name, token: u.token! };
71
+ if (role) expect(addNetworkMember(net, user[k].id, role, user.boss.id, { agentAccess: "all" }).ok).toBe(true);
72
+ }
73
+ // tgt 的主人是普通成员 own(不是网络 owner),这样「节点主人放行」与「网络 owner 放行」能分开测。
74
+ for (const [key, owner] of [["tgt", "own"], ["a", "boss"], ["b", "boss"], ["c", "boss"]] as const) {
75
+ const alias = `ia-${key}-${stamp}`, id = `n_ia_${key}_${stamp}`;
76
+ const t = createNetworkTokenForNode(user[owner].id, net, alias, id);
77
+ expect(t.ok).toBe(true);
78
+ node[key] = { id, alias, token: t.token! };
79
+ db.run("INSERT INTO sessions (resume_id, alias, status, node_id, network_id) VALUES (?1, ?2, 'idle', ?3, ?4)", [`r_${id}`, alias, id, net]);
80
+ }
81
+ const mod: any = await import("./server.js");
82
+ server = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
83
+ base = `http://127.0.0.1:${server.port}`;
84
+ }, 60_000);
85
+ afterEach(() => { delete process.env.COMMHUB_NODE_PERMISSIONS; setInbox(null); });
86
+ afterAll(() => { server?.stop?.(true); });
87
+
88
+ describe("PUT /api/nodes/:id/inbox-allowlist —— 与 peer-allowlist 同形", () => {
89
+ const put = (token: string, body: unknown, nodeId = node.tgt.id) => call(token, "PUT", `/api/nodes/${nodeId}/inbox-allowlist`, body);
90
+
91
+ test("节点主人设 → 200 { ok, node_id, senders },GET 读回,审计一行 {from,to}", async () => {
92
+ const r = await put(user.own.token, { senders: [node.a.alias, " user:" + user.mem.name + " "] });
93
+ expect(r.status).toBe(200);
94
+ expect(r.body).toEqual({ ok: true, node_id: node.tgt.id, senders: [node.a.alias, `user:${user.mem.name}`] });
95
+ const g = await call(user.boss.token, "GET", `/api/nodes?network_id=${net}&node_id=${node.tgt.id}`);
96
+ expect(g.body.nodes[0].inbox_allowlist).toEqual([node.a.alias, `user:${user.mem.name}`]);
97
+ const audit = db.get<{ detail: string | null; user_id: string | null }>(
98
+ "SELECT detail, user_id FROM audit_log WHERE action = 'node_inbox_allowlist_changed' AND target_id = ?1 ORDER BY id DESC LIMIT 1", node.tgt.id);
99
+ expect(audit?.user_id).toBe(user.own.id);
100
+ expect(JSON.parse(audit!.detail!)).toEqual({ from: null, to: JSON.stringify([node.a.alias, `user:${user.mem.name}`]) });
101
+ });
102
+
103
+ test("网络 owner / admin 也能设;null 清空 → GET 读回 null", async () => {
104
+ expect((await put(user.boss.token, { senders: ["x"] })).status).toBe(200);
105
+ expect((await put(user.adm.token, { senders: ["y"] })).body.senders).toEqual(["y"]);
106
+ const cleared = await put(user.adm.token, { senders: null });
107
+ expect(cleared.status).toBe(200);
108
+ expect(cleared.body.senders).toBeNull();
109
+ expect(storedInbox()).toBeNull();
110
+ const g = await call(user.boss.token, "GET", `/api/nodes?network_id=${net}&node_id=${node.tgt.id}`);
111
+ expect(g.body.nodes[0].inbox_allowlist).toBeNull();
112
+ });
113
+
114
+ test("普通成员 403 且行没变;主人 200 且行真的变(镜像)", async () => {
115
+ setInbox(["keep"]);
116
+ const denied = await put(user.mem.token, { senders: ["sneak"] });
117
+ expect(denied.status).toBe(403);
118
+ expect(denied.body.error).toBe("permission_denied");
119
+ expect(storedInbox()).toBe(JSON.stringify(["keep"]));
120
+ expect((await put(user.own.token, { senders: ["changed"] })).status).toBe(200);
121
+ expect(storedInbox()).toBe(JSON.stringify(["changed"]));
122
+ });
123
+
124
+ test("错误形状:[] / 非数组 / 超 200 条 / 坏 JSON → 400,库没变", async () => {
125
+ setInbox(["keep"]);
126
+ const empty = await put(user.own.token, { senders: [] });
127
+ expect(empty.status).toBe(400);
128
+ expect(empty.body.error).toBe("empty_allowlist_ambiguous");
129
+ expect((await put(user.own.token, { senders: "a" })).body.error).toBe("invalid_senders");
130
+ const many = await put(user.own.token, { senders: Array.from({ length: 201 }, (_, i) => `s${i}`) });
131
+ expect(many.status).toBe(400);
132
+ expect(many.body.error).toBe("too_many_senders");
133
+ const bad = await fetch(`${base}/api/nodes/${node.tgt.id}/inbox-allowlist`, {
134
+ method: "PUT", headers: { Authorization: `Bearer ${user.own.token}`, "Content-Type": "application/json" }, body: "{",
135
+ });
136
+ expect(bad.status).toBe(400);
137
+ expect(storedInbox()).toBe(JSON.stringify(["keep"]));
138
+ });
139
+
140
+ test("节点令牌 403 user_token_required;网络外的人 / 不存在的节点 404;无令牌 401", async () => {
141
+ const asNode = await put(node.tgt.token, { senders: ["x"] });
142
+ expect(asNode.status).toBe(403);
143
+ expect(asNode.body.error).toBe("user_token_required");
144
+ expect((await put(user.out.token, { senders: ["x"] })).status).toBe(404);
145
+ expect((await put(user.boss.token, { senders: ["x"] }, "n_does_not_exist")).status).toBe(404);
146
+ const anon = await fetch(`${base}/api/nodes/${node.tgt.id}/inbox-allowlist`, { method: "PUT", headers: { "Content-Type": "application/json" }, body: "{}" });
147
+ expect(anon.status).toBe(401);
148
+ expect(storedInbox()).toBeNull();
149
+ });
150
+
151
+ test("/health 宣告 node_inbox_allowlist", async () => {
152
+ const r = await fetch(`${base}/health`);
153
+ expect((await r.json()).capabilities).toContain("node_inbox_allowlist");
154
+ });
155
+ });
156
+
157
+ describe("节点发件人 —— alias / node_id 匹配,显式原因", () => {
158
+ test("null = 谁都能发(与今天一致)", async () => {
159
+ expect((await mcp(node.b.token, "send_task", { alias: node.tgt.alias, task: "open inbox" })).ok).toBe(true);
160
+ });
161
+
162
+ test("MCP send_task:名单上的(alias)放行,不在名单上的拒并记在目标节点名下,且不入库", async () => {
163
+ setInbox([node.a.alias]);
164
+ expect((await mcp(node.a.token, "send_task", { alias: node.tgt.alias, task: "from a" })).ok).toBe(true);
165
+ const before = inboxRowsFor(node.tgt.alias);
166
+ const denied = await mcp(node.b.token, "send_task", { alias: node.tgt.alias, task: "from b" });
167
+ expectSenderDenied(denied, node.b.alias);
168
+ expect(denied.route).toBe("mcp:send_task");
169
+ expect(inboxRowsFor(node.tgt.alias)).toBe(before);
170
+ const row = db.get<{ hits: number | string; sample: string | null }>(
171
+ "SELECT hits, sample FROM node_permission_log WHERE network_id = ?1 AND node_id = ?2 AND reason = 'sender_not_allowed' AND route = 'mcp:send_task'", net, node.tgt.id);
172
+ expect(Number(row?.hits)).toBeGreaterThan(0);
173
+ expect(row?.sample).toBe(node.b.alias);
174
+ });
175
+
176
+ test("按 node_id 写也命中", async () => {
177
+ setInbox([node.b.id]);
178
+ expect((await mcp(node.b.token, "send_task", { alias: node.tgt.alias, task: "by id" })).ok).toBe(true);
179
+ });
180
+
181
+ test("显式原因:COMMHUB_NODE_PERMISSIONS=off 也照拒", async () => {
182
+ process.env.COMMHUB_NODE_PERMISSIONS = "off";
183
+ setInbox([node.a.alias]);
184
+ expectSenderDenied(await mcp(node.b.token, "send_task", { alias: node.tgt.alias, task: "off" }), node.b.alias);
185
+ });
186
+
187
+ test("MCP send_message / retry_task / reassign_task 同样拒", async () => {
188
+ setInbox([node.a.alias]);
189
+ expectSenderDenied(await mcp(node.b.token, "send_message", { alias: node.tgt.alias, message: "hi" }), node.b.alias);
190
+
191
+ setInbox(null);
192
+ const t = await mcp(node.a.token, "send_task", { alias: node.tgt.alias, task: "to retry" });
193
+ expect(t.ok).toBe(true);
194
+ db.run("UPDATE tasks SET status = 'failed' WHERE task_id = ?1", [t.message_id]);
195
+ setInbox([node.a.alias]);
196
+ const retry = await mcp(node.b.token, "retry_task", { task_id: t.message_id });
197
+ expectSenderDenied(retry, node.b.alias);
198
+ expect(retry.route).toBe("mcp:retry_task");
199
+ expect(db.get<{ status: string }>("SELECT status FROM tasks WHERE task_id = ?1", t.message_id)!.status).toBe("failed");
200
+
201
+ const r = await mcp(node.a.token, "send_task", { alias: node.c.alias, task: "to reassign" });
202
+ expect(r.ok).toBe(true);
203
+ const re = await mcp(node.b.token, "reassign_task", { task_id: r.message_id, new_alias: node.tgt.alias });
204
+ expectSenderDenied(re, node.b.alias);
205
+ expect(db.get<{ to_name: string }>("SELECT to_name FROM tasks WHERE task_id = ?1", r.message_id)!.to_name).toBe(node.c.alias);
206
+ });
207
+
208
+ test("REST POST /api/task(节点令牌)→ 403 同一形状", async () => {
209
+ setInbox([node.a.alias]);
210
+ const r = await call(node.b.token, "POST", "/api/task", { alias: node.tgt.alias, task: "rest from b", network_id: net });
211
+ expect(r.status).toBe(403);
212
+ expectSenderDenied(r.body, node.b.alias);
213
+ expect(r.body.route).toBe("POST /api/task");
214
+ expect((await call(node.a.token, "POST", "/api/task", { alias: node.tgt.alias, task: "rest from a", network_id: net })).status).toBe(200);
215
+ });
216
+
217
+ test("发给自己永远放行(含 !strict)", async () => {
218
+ setInbox(["!strict"]);
219
+ expect((await mcp(node.tgt.token, "send_task", { alias: node.tgt.alias, task: "note to self" })).ok).toBe(true);
220
+ });
221
+ });
222
+
223
+ describe("人类发件人 —— user:<username|user_id> / user:*,主人与管理员隐式放行", () => {
224
+ const send = (who: string, task = "hello") =>
225
+ call(user[who].token, "POST", "/api/task", { alias: node.tgt.alias, task: `${task} ${who} ${Math.random()}`, network_id: net });
226
+
227
+ test("名单只有节点 ⇒ 普通成员被拒;节点主人、网络 owner、网络 admin 照常能发", async () => {
228
+ setInbox([node.a.alias]);
229
+ const denied = await send("mem");
230
+ expect(denied.status).toBe(403);
231
+ expectSenderDenied(denied.body, `user:${user.mem.name}`);
232
+ for (const who of ["own", "boss", "adm"]) expect((await send(who)).status).toBe(200);
233
+ });
234
+
235
+ test("user:<username>、user:<user_id>、user:* 都命中", async () => {
236
+ for (const entry of [`user:${user.mem.name}`, `user:${user.mem.id}`, "user:*"]) {
237
+ setInbox([node.a.alias, entry]);
238
+ expect((await send("mem")).status).toBe(200);
239
+ }
240
+ });
241
+
242
+ test("!strict 关掉隐式放行:主人与网络 owner 也必须在名单上", async () => {
243
+ setInbox([node.a.alias, "!strict"]);
244
+ expect((await send("own")).status).toBe(403);
245
+ expect((await send("boss")).status).toBe(403);
246
+ setInbox([node.a.alias, "!strict", `user:${user.own.name}`]);
247
+ expect((await send("own")).status).toBe(200);
248
+ });
249
+
250
+ test("MCP 用户令牌同一口径", async () => {
251
+ setInbox([node.a.alias]);
252
+ expectSenderDenied(await mcp(user.mem.token, "send_task", { alias: node.tgt.alias, task: "mcp human", network_id: net }), `user:${user.mem.name}`);
253
+ expect((await mcp(user.own.token, "send_task", { alias: node.tgt.alias, task: "mcp owner", network_id: net })).ok).toBe(true);
254
+ });
255
+ });
256
+
257
+ describe("广播 —— 跳过不收的收件人,报告而不失败", () => {
258
+ test("REST /api/broadcast:tgt 被跳过并出现在 inbox_skipped,其他人照收", async () => {
259
+ setInbox([node.a.alias]);
260
+ const before = { tgt: inboxRowsFor(node.tgt.alias), c: inboxRowsFor(node.c.alias) };
261
+ const r = await call(user.mem.token, "POST", `/api/broadcast?network_id=${net}`, { message: `bc ${stamp}`, network_id: net });
262
+ expect(r.status).toBe(200);
263
+ expect(r.body.ok).toBe(true);
264
+ expect(r.body.inbox_skipped).toEqual([{ alias: node.tgt.alias, node_id: node.tgt.id, reason: "sender_not_allowed" }]);
265
+ expect(inboxRowsFor(node.tgt.alias)).toBe(before.tgt);
266
+ expect(inboxRowsFor(node.c.alias)).toBe(before.c + 1);
267
+ });
268
+
269
+ test("MCP broadcast(节点令牌)同样跳过;没人被跳过时回执恰好三键、没有 inbox_skipped", async () => {
270
+ const open = await mcp(node.b.token, "broadcast", { message: `open ${stamp}` });
271
+ expect(open.ok).toBe(true);
272
+ expect(Object.keys(open).sort()).toEqual(["message_ids", "ok", "recipients"]);
273
+ setInbox([node.a.alias]);
274
+ const r = await mcp(node.b.token, "broadcast", { message: `mcp bc ${stamp}` });
275
+ expect(r.ok).toBe(true);
276
+ expect(r.inbox_skipped.map((s: any) => s.alias)).toEqual([node.tgt.alias]);
277
+ expect(r.recipients).toBe(open.recipients - 1);
278
+ });
279
+ });
280
+
281
+ describe("排程 —— 每次触发按建排程的人现判", () => {
282
+ test("普通成员建的排程:名单不收他 ⇒ 这次运行 failed / sender_not_allowed,不建任务;收他 ⇒ 照常派发", async () => {
283
+ const { dispatchScheduledOccurrence } = await import("./scheduled-tasks.js");
284
+ const schedule = (suffix: string) => {
285
+ const id = `sched_ia_${suffix}_${stamp}`;
286
+ db.run(
287
+ `INSERT INTO scheduled_tasks (schedule_id, network_id, created_by, name, target_node_id, target_alias, task_content, schedule_type, schedule_json, next_run_at)
288
+ VALUES (?1, ?2, ?3, 'n', ?4, ?5, 'scheduled work', 'interval', '{"type":"interval","minutes":60}', datetime('now'))`,
289
+ [id, net, user.mem.id, node.tgt.id, node.tgt.alias],
290
+ );
291
+ return db.get<any>("SELECT * FROM scheduled_tasks WHERE schedule_id = ?1", id);
292
+ };
293
+ setInbox([node.a.alias]);
294
+ const denied = dispatchScheduledOccurrence(schedule("deny"), new Date().toISOString(), false);
295
+ expect(denied.status).toBe("failed");
296
+ expect(denied.taskId).toBeUndefined();
297
+ expect(db.get<{ error_code: string }>("SELECT error_code FROM scheduled_task_runs WHERE run_id = ?1", denied.runId)?.error_code).toBe("sender_not_allowed");
298
+ setInbox([node.a.alias, `user:${user.mem.name}`]);
299
+ const ok = dispatchScheduledOccurrence(schedule("allow"), new Date().toISOString(), false);
300
+ expect(ok.taskId).toBeTruthy();
301
+ });
302
+ });
303
+
304
+ describe("inboxAllows —— 纯判定", () => {
305
+ const ctx = { targetNodeId: "n_t", targetAlias: "t", ownerUserId: "u_owner", networkId: null };
306
+ test("null 放行一切;legacy 默认放行,!strict 拒", () => {
307
+ expect(inboxAllows(null, { kind: "legacy" }, ctx)).toBe(true);
308
+ expect(inboxAllows(["x"], { kind: "legacy" }, ctx)).toBe(true);
309
+ expect(inboxAllows(["x", "!strict"], { kind: "legacy" }, ctx)).toBe(false);
310
+ });
311
+ test("Hub 管理员隐式放行;!strict 下不放行", () => {
312
+ const admin = { kind: "user" as const, userId: "u_admin", username: "root", isHubAdmin: true };
313
+ expect(inboxAllows(["x"], admin, ctx)).toBe(true);
314
+ expect(inboxAllows(["x", "!strict"], admin, ctx)).toBe(false);
315
+ });
316
+ test("节点条目不会匹配到同名的人(user: 前缀才是人)", () => {
317
+ expect(inboxAllows(["alice"], { kind: "user", userId: "u_a", username: "alice" }, ctx)).toBe(false);
318
+ expect(inboxAllows(["user:*"], { kind: "node", nodeId: "n_x", aliases: ["x"] }, ctx)).toBe(false);
319
+ });
320
+ });
@@ -0,0 +1,64 @@
1
+ import { describe, expect, test } from "bun:test";
2
+ import {
3
+ childNodeIdForCreateRequest,
4
+ buildControllableMap,
5
+ isLifecycleControllable,
6
+ } from "./node-lifecycle-controllable.js";
7
+
8
+ // app#196 —— 桌面端对 218 个节点里的 207 个(95%)显示了「停止/重启/删除」,
9
+ // 而那三个工具的 schema 是 regex(/^node_[a-z0-9_-]+$/),那 207 个是 n_ 开头,
10
+ // 点下去只会看到一段 zod 正则原文。
11
+ describe("childNodeIdForCreateRequest —— 推导规则", () => {
12
+ test("cr_ 前缀 → node_ 前缀,其余部分逐字保留", () => {
13
+ // 🔴 这一对是 2026-08-28 生产 hub 日志里真实的 create-node finalize 行,
14
+ // 不是我按注释造的。
15
+ expect(childNodeIdForCreateRequest("cr_59723b24-8372-4270-9b3c-1552e592a09f"))
16
+ .toBe("node_59723b24-8372-4270-9b3c-1552e592a09f");
17
+ });
18
+ test("不是 cr_ 开头的一律 null —— 不猜、不截断", () => {
19
+ expect(childNodeIdForCreateRequest("node_abc")).toBeNull();
20
+ expect(childNodeIdForCreateRequest("n_abc")).toBeNull();
21
+ expect(childNodeIdForCreateRequest("abc")).toBeNull();
22
+ expect(childNodeIdForCreateRequest("cr_")).toBeNull(); // 只有前缀,没有主体
23
+ });
24
+ test("非字符串输入不抛,返回 null", () => {
25
+ for (const v of [undefined, null, 123, {}, []]) {
26
+ expect(childNodeIdForCreateRequest(v as any)).toBeNull();
27
+ }
28
+ });
29
+ });
30
+
31
+ describe("isLifecycleControllable —— 判据不是 id 前缀", () => {
32
+ const map = buildControllableMap([
33
+ { request_id: "cr_aaa", daemon_node_id: "node_daemon_x" },
34
+ { request_id: "cr_bbb", daemon_node_id: "node_daemon_y" },
35
+ { request_id: "not-a-request", daemon_node_id: "node_daemon_z" }, // 应被丢弃
36
+ ]);
37
+
38
+ test("有创建记录的 → 可控", () => {
39
+ expect(isLifecycleControllable("node_aaa", null, map)).toBe(true);
40
+ expect(map.get("node_aaa")).toBe("node_daemon_x");
41
+ });
42
+
43
+ test("🔴 光有 node_ 前缀但没有创建记录 → 不可控", () => {
44
+ // 这条是本模块存在的理由:前缀是实现细节,不是判据。
45
+ expect(isLifecycleControllable("node_never_created", null, map)).toBe(false);
46
+ });
47
+
48
+ test("手工起的 n_ 节点 → 不可控(那 207 个)", () => {
49
+ expect(isLifecycleControllable("n_22b777bf", null, map)).toBe(false);
50
+ });
51
+
52
+ test("🔴 daemon 自己可控 —— 它在 node_create_requests 里没有记录", () => {
53
+ // 漏掉这条会把 3 个 daemon 从可控名单里误删。
54
+ expect(isLifecycleControllable("node_daemon_39bd1eeae3ee", "host_supervisor", map)).toBe(true);
55
+ // 正控:同一个 id 但 role 不是 host_supervisor ⇒ 仍不可控,
56
+ // 证明上面那条过是因为 role,不是因为 id 恰好带 node_ 前缀。
57
+ expect(isLifecycleControllable("node_daemon_39bd1eeae3ee", null, map)).toBe(false);
58
+ });
59
+
60
+ test("坏的 request_id 不会污染映射", () => {
61
+ expect(map.has("node_not-a-request")).toBe(false);
62
+ expect(map.size).toBe(2);
63
+ });
64
+ });
@@ -0,0 +1,53 @@
1
+ /**
2
+ * app#196 —— 哪些节点能走 stop_node / restart_node / delete_node。
3
+ *
4
+ * 抽成独立模块而不是写在 /api/nodes 的路由里,因为路由里的内联逻辑测不到 ——
5
+ * 现有的 api-nodes-shape.test.ts 是直跑 handler 的 SQL,拿不到映射步骤。
6
+ * 🔴 「不可测」本身就是一个设计信号,不是测试的问题。
7
+ */
8
+
9
+ /** 子节点 id 由创建请求 id 确定性推导。
10
+ *
11
+ * 🔴 这条规则我用真实一对验过,不是只读注释:
12
+ * cr_59723b24-8372-4270-9b3c-1552e592a09f → node_59723b24-8372-4270-9b3c-…
13
+ * (2026-08-28 生产 hub 日志的 `create-node finalize` 行)
14
+ *
15
+ * 非 `cr_` 开头的一律返回 null —— 不猜,不截断。 */
16
+ export function childNodeIdForCreateRequest(requestId: unknown): string | null {
17
+ if (typeof requestId !== "string") return null;
18
+ if (!requestId.startsWith("cr_")) return null;
19
+ const rest = requestId.slice(3);
20
+ if (!rest) return null;
21
+ return `node_${rest}`;
22
+ }
23
+
24
+ /** 由创建记录建出「child node_id → daemon node_id」的映射。 */
25
+ export function buildControllableMap(
26
+ createRequests: Array<{ request_id?: unknown; daemon_node_id?: unknown }>,
27
+ bindings: Array<{ node_id: string; daemon_node_id: string }> = [],
28
+ ): Map<string, string> {
29
+ const m = new Map<string, string>();
30
+ for (const binding of bindings) m.set(binding.node_id, binding.daemon_node_id);
31
+ for (const cr of createRequests) {
32
+ const child = childNodeIdForCreateRequest(cr?.request_id);
33
+ if (!child) continue;
34
+ m.set(child, typeof cr?.daemon_node_id === "string" ? cr.daemon_node_id : "");
35
+ }
36
+ return m;
37
+ }
38
+
39
+ /** 一个节点能不能走生命周期操作。
40
+ *
41
+ * 🔴 判据**不是 id 前缀**。前缀是实现细节;判据是 node_create_requests 里真有创建记录。
42
+ *
43
+ * 例外:daemon 自己(role=host_supervisor)也能被 restart/stop,而它在
44
+ * node_create_requests 里**没有**记录(它不是被别的 daemon 创建的)—— 单独放行。
45
+ * 漏掉这一条会把可控的 daemon 判成不可控。 */
46
+ export function isLifecycleControllable(
47
+ nodeId: unknown,
48
+ role: unknown,
49
+ controllable: Map<string, string>,
50
+ ): boolean {
51
+ if (role === "host_supervisor") return true;
52
+ return typeof nodeId === "string" && controllable.has(nodeId);
53
+ }