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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (431) hide show
  1. package/README.md +120 -3
  2. package/bin/commhub.ts +93 -9
  3. package/build-info.json +7 -0
  4. package/package.json +10 -8
  5. package/src/ack-create-request-transport.test.ts +182 -0
  6. package/src/ack-create-request.test.ts +52 -8
  7. package/src/admin-delete-network-http.test.ts +228 -0
  8. package/src/admin-networks-http.test.ts +88 -0
  9. package/src/adoption-candidates-http.test.ts +140 -0
  10. package/src/adoption-candidates.ts +158 -0
  11. package/src/agent-access-batch.test.ts +210 -0
  12. package/src/agent-access.ts +487 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +680 -0
  15. package/src/agent-acl-slice3-http.test.ts +885 -0
  16. package/src/agent-department-http.test.ts +215 -0
  17. package/src/agent-groups-perf.test.ts +223 -0
  18. package/src/agent-notice.ts +48 -0
  19. package/src/agent-team-whoami-http.test.ts +98 -0
  20. package/src/agent-teams-http.test.ts +330 -0
  21. package/src/agent-teams.ts +244 -0
  22. package/src/alias-baseline-2571.test.ts +162 -0
  23. package/src/alias-baseline.ts +113 -0
  24. package/src/alias-filter.test.ts +72 -0
  25. package/src/alias-filter.ts +42 -0
  26. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  27. package/src/api-host-supervisors-fallback.test.ts +6 -7
  28. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  29. package/src/api-nodes-shape.test.ts +131 -4
  30. package/src/auth-abuse-counters.test.ts +144 -0
  31. package/src/auth-abuse-counters.ts +122 -0
  32. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  33. package/src/auth-sessions-http.test.ts +260 -0
  34. package/src/auth-validate.test.ts +5 -1
  35. package/src/auth-weak-password-login.test.ts +176 -0
  36. package/src/auth.ts +609 -56
  37. package/src/backfill-node-ids-2664.test.ts +128 -0
  38. package/src/binding-generation-http.test.ts +141 -0
  39. package/src/blocked-exit-on-reply.test.ts +122 -0
  40. package/src/broadcast-fanout-2721.test.ts +149 -0
  41. package/src/broadcast-fanout.ts +117 -0
  42. package/src/build-commit-report-http.test.ts +128 -0
  43. package/src/build-info.test.ts +60 -0
  44. package/src/build-info.ts +85 -0
  45. package/src/chain-attempt-dedup.test.ts +447 -0
  46. package/src/clip.test.ts +36 -0
  47. package/src/clip.ts +48 -0
  48. package/src/clone-node.test.ts +269 -0
  49. package/src/clone-node.ts +289 -0
  50. package/src/codex-config-flags.ts +77 -0
  51. package/src/codex-fork-contract.ts +23 -0
  52. package/src/codex-fork-migration.test.ts +38 -0
  53. package/src/commhub-bin-args.test.ts +85 -0
  54. package/src/config-apply-validate.test.ts +188 -1
  55. package/src/config-apply-validate.ts +222 -3
  56. package/src/cors-origins.test.ts +73 -0
  57. package/src/create-node-blocked-gate.test.ts +365 -0
  58. package/src/create-node-error-domain.test.ts +127 -0
  59. package/src/create-node-network-id.test.ts +91 -0
  60. package/src/create-node-tool-schema.test.ts +49 -0
  61. package/src/create-node-unicode-name.test.ts +126 -0
  62. package/src/create-node-validate.test.ts +199 -7
  63. package/src/create-node-validate.ts +232 -15
  64. package/src/create-node-workdir.test.ts +298 -0
  65. package/src/create-node.ts +88 -23
  66. package/src/daemon-provider-snapshots.test.ts +453 -0
  67. package/src/daemon-provider-snapshots.ts +327 -0
  68. package/src/daemon-token-owner-http.test.ts +346 -0
  69. package/src/dashboard-slash-routing-http.test.ts +109 -0
  70. package/src/db-adapter-guard.test.ts +148 -0
  71. package/src/db-adapter-translate.test.ts +128 -0
  72. package/src/db-adapter.ts +377 -91
  73. package/src/db-timestamp.test.ts +38 -0
  74. package/src/db-timestamp.ts +15 -0
  75. package/src/db.ts +1269 -153
  76. package/src/delivered-without-push.test.ts +140 -0
  77. package/src/department-groups-http.test.ts +209 -0
  78. package/src/department-groups-sync-http.test.ts +328 -0
  79. package/src/department-groups.ts +434 -0
  80. package/src/department-heads-http.test.ts +350 -0
  81. package/src/department-heads.ts +226 -0
  82. package/src/departments-agent-count.test.ts +139 -0
  83. package/src/departments-http.test.ts +185 -0
  84. package/src/departments-mcp-error-domain.test.ts +135 -0
  85. package/src/departments-mcp.test.ts +128 -0
  86. package/src/departments.ts +318 -0
  87. package/src/desktop-message-seam.test.ts +150 -0
  88. package/src/desktop-message.test.ts +368 -0
  89. package/src/dm-file-scope-http.test.ts +178 -0
  90. package/src/empty-node-sweeper.test.ts +104 -0
  91. package/src/empty-node-sweeper.ts +88 -0
  92. package/src/env-transport-gate-http.test.ts +240 -0
  93. package/src/env-transport-gate.ts +80 -0
  94. package/src/env-transport-policy.ts +56 -0
  95. package/src/etag-of.test.ts +57 -0
  96. package/src/event-loop-lag.test.ts +180 -0
  97. package/src/event-loop-lag.ts +201 -0
  98. package/src/expiry-counters.test.ts +187 -0
  99. package/src/expiry-counters.ts +227 -0
  100. package/src/expiry-evidence-db.test.ts +103 -0
  101. package/src/ext-token-shared.test.ts +60 -0
  102. package/src/ext-validation-regression.test.ts +10 -17
  103. package/src/external-schedule-edits-http.test.ts +321 -0
  104. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  105. package/src/external-schedule-edits.ts +327 -0
  106. package/src/file-download-authz-dev-open.test.ts +1 -1
  107. package/src/file-download-authz.test.ts +25 -4
  108. package/src/file-download-date-bucket.test.ts +1 -1
  109. package/src/file-network-scope-dev-open.test.ts +1 -1
  110. package/src/file-network-scope.test.ts +7 -6
  111. package/src/group-membership-events-http.test.ts +264 -0
  112. package/src/group-messages-http.test.ts +483 -0
  113. package/src/group-messages.ts +297 -0
  114. package/src/health-anon-readers.ts +67 -0
  115. package/src/health-host-disk-2756.test.ts +71 -0
  116. package/src/health-redaction.test.ts +1576 -7
  117. package/src/host-supervisor-identity-http.test.ts +152 -0
  118. package/src/host-supervisor-identity.ts +92 -0
  119. package/src/host-supervisors-daemon-version.test.ts +137 -0
  120. package/src/http-gzip.test.ts +94 -0
  121. package/src/http-gzip.ts +112 -0
  122. package/src/hub-catalog-read-http.test.ts +641 -0
  123. package/src/hub-provider-config.test.ts +166 -0
  124. package/src/hub-provider-config.ts +202 -0
  125. package/src/hub-timestamp.test.ts +38 -0
  126. package/src/hub-timestamp.ts +27 -0
  127. package/src/human-dm.ts +215 -0
  128. package/src/human-inbox.ts +42 -0
  129. package/src/inbox-caller.ts +49 -0
  130. package/src/inbox-count-sse.test.ts +318 -0
  131. package/src/inbox-count.ts +29 -0
  132. package/src/index.ts +6 -2
  133. package/src/license-state.test.ts +56 -0
  134. package/src/license-state.ts +48 -0
  135. package/src/lifecycle-error-domain.test.ts +149 -0
  136. package/src/list-ack-error-domain.test.ts +108 -0
  137. package/src/list-host-supervisors.test.ts +15 -4
  138. package/src/mcp-context-cost-http.test.ts +127 -0
  139. package/src/mcp-inflight.test.ts +92 -0
  140. package/src/mcp-inflight.ts +38 -0
  141. package/src/mcp-projects-events-http.test.ts +168 -0
  142. package/src/mcp-route-label-http.test.ts +120 -0
  143. package/src/mcp-write-network-resolution.test.ts +21 -0
  144. package/src/member-audit-network-id-http.test.ts +93 -0
  145. package/src/member-presence-http.test.ts +210 -0
  146. package/src/messages-ack-by-agent-http.test.ts +142 -0
  147. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  148. package/src/migrate-sqlite-to-pg.ts +263 -0
  149. package/src/model-auth-notify-http.test.ts +181 -0
  150. package/src/model-auth-notify.ts +116 -0
  151. package/src/network-name-http.test.ts +75 -0
  152. package/src/network-rules-http.test.ts +169 -0
  153. package/src/network-rules.ts +129 -0
  154. package/src/network-scope.ts +222 -3
  155. package/src/network-token-membership-http.test.ts +186 -0
  156. package/src/node-alias-control.ts +12 -0
  157. package/src/node-attrs.test.ts +47 -2
  158. package/src/node-caller-identity-http.test.ts +1108 -0
  159. package/src/node-create-request-status-http.test.ts +105 -0
  160. package/src/node-daemon-bindings.test.ts +142 -0
  161. package/src/node-daemon-bindings.ts +135 -0
  162. package/src/node-failure-alert.test.ts +150 -0
  163. package/src/node-failure-alert.ts +177 -0
  164. package/src/node-files-transport.test.ts +350 -0
  165. package/src/node-health-codex-login.test.ts +120 -0
  166. package/src/node-health-dispatch-http.test.ts +373 -0
  167. package/src/node-health-guard.ts +121 -0
  168. package/src/node-health-passthrough.test.ts +115 -0
  169. package/src/node-health-store.ts +101 -0
  170. package/src/node-id-alias.test.ts +190 -0
  171. package/src/node-identity-conflict-http.test.ts +269 -0
  172. package/src/node-identity-conflict.ts +142 -0
  173. package/src/node-identity-mismatch.test.ts +74 -0
  174. package/src/node-in-flight-tasks.ts +31 -0
  175. package/src/node-lifecycle-controllable.test.ts +64 -0
  176. package/src/node-lifecycle-controllable.ts +53 -0
  177. package/src/node-lifecycle-read-http.test.ts +257 -0
  178. package/src/node-lifecycle-read.ts +124 -0
  179. package/src/node-logs-transport.test.ts +266 -0
  180. package/src/node-peer-allowlist.test.ts +114 -0
  181. package/src/node-permissions-http.test.ts +728 -0
  182. package/src/node-permissions.ts +494 -0
  183. package/src/node-request-retention.test.ts +281 -0
  184. package/src/node-request-retention.ts +120 -0
  185. package/src/node-secret-rest-http.test.ts +190 -0
  186. package/src/node-security-write-gate.test.ts +72 -0
  187. package/src/node-serviceability.test.ts +86 -0
  188. package/src/node-serviceability.ts +124 -0
  189. package/src/node-session-control-http.test.ts +310 -0
  190. package/src/node-session-control.ts +258 -0
  191. package/src/node-skills-transport.test.ts +212 -0
  192. package/src/node-token-identity.ts +35 -0
  193. package/src/node-token-ownership.ts +51 -0
  194. package/src/node-token-privilege-http.test.ts +158 -0
  195. package/src/not-found-api-http.test.ts +67 -0
  196. package/src/observer-avatar-http.test.ts +103 -10
  197. package/src/observer-push.test.ts +76 -0
  198. package/src/opencode-catalog-report-http.test.ts +139 -0
  199. package/src/opencode-v2-catalog.test.ts +268 -0
  200. package/src/opencode-v2-catalog.ts +356 -0
  201. package/src/package-version-consistency.test.ts +25 -0
  202. package/src/parent-infer.test.ts +82 -0
  203. package/src/parent-infer.ts +110 -0
  204. package/src/parent-source-marker.test.ts +70 -0
  205. package/src/password-network-tokens.ts +25 -0
  206. package/src/peer-reply-atomic.test.ts +462 -0
  207. package/src/peer-reply-capability.test.ts +70 -0
  208. package/src/pg-worker.ts +87 -0
  209. package/src/poll-pacing.test.ts +74 -0
  210. package/src/poll-pacing.ts +123 -0
  211. package/src/probe-provider-error-domain.test.ts +145 -0
  212. package/src/project-dir-warn-clear-http.test.ts +132 -0
  213. package/src/project-viewer-can-http.test.ts +116 -0
  214. package/src/provider-skill-error-domain.test.ts +130 -0
  215. package/src/provider-tools-shape.test.ts +165 -0
  216. package/src/push.test.ts +20 -10
  217. package/src/push.ts +373 -9
  218. package/src/redact-tokens.test.ts +86 -0
  219. package/src/redact-tokens.ts +43 -0
  220. package/src/rejection-counters.test.ts +72 -0
  221. package/src/rejection-counters.ts +173 -0
  222. package/src/rename.ts +38 -10
  223. package/src/reply-target-derivation.test.ts +96 -0
  224. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  225. package/src/report-status-host-schema.test.ts +235 -0
  226. package/src/report-status-resume-id-handover.test.ts +184 -0
  227. package/src/report-status-secret-keys.test.ts +140 -0
  228. package/src/require-explicit-test-db.ts +9 -0
  229. package/src/requirement-due-reminders-http.test.ts +620 -0
  230. package/src/requirement-due-reminders.ts +416 -0
  231. package/src/requirement-events-http.test.ts +318 -0
  232. package/src/requirement-events.test.ts +45 -0
  233. package/src/requirement-events.ts +144 -0
  234. package/src/requirement-notify.ts +165 -0
  235. package/src/requirement-participant-notify-http.test.ts +313 -0
  236. package/src/requirement-tag-ops-http.test.ts +454 -0
  237. package/src/requirement-tag-tree-http.test.ts +275 -0
  238. package/src/requirement-tag-tree.ts +127 -0
  239. package/src/requirement-tags.ts +102 -0
  240. package/src/requirements-abandoned-http.test.ts +236 -0
  241. package/src/requirements-assignee-drift.test.ts +154 -0
  242. package/src/requirements-comment-http.test.ts +174 -0
  243. package/src/requirements-completed-at-migration.test.ts +70 -0
  244. package/src/requirements-errors-mcp-http.test.ts +164 -0
  245. package/src/requirements-errors.ts +158 -0
  246. package/src/requirements-etag-http.test.ts +91 -0
  247. package/src/requirements-http.test.ts +709 -0
  248. package/src/requirements-last-event-http.test.ts +349 -0
  249. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  250. package/src/requirements-list-slim-http.test.ts +324 -0
  251. package/src/requirements-mcp.test.ts +180 -0
  252. package/src/requirements-migrate.ts +283 -0
  253. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  254. package/src/requirements-people-http.test.ts +114 -0
  255. package/src/requirements-people-mcp-http.test.ts +231 -0
  256. package/src/requirements-people.ts +196 -0
  257. package/src/requirements-priority-lowest.test.ts +114 -0
  258. package/src/requirements-projects-network-echo.test.ts +57 -0
  259. package/src/requirements-projects-parent-http.test.ts +123 -0
  260. package/src/requirements-search-http.test.ts +182 -0
  261. package/src/requirements-search.test.ts +32 -0
  262. package/src/requirements-search.ts +145 -0
  263. package/src/requirements-seq-http.test.ts +193 -0
  264. package/src/requirements-seq-migration.test.ts +63 -0
  265. package/src/requirements-start-date.test.ts +125 -0
  266. package/src/requirements-stats-http.test.ts +357 -0
  267. package/src/requirements-stats.ts +195 -0
  268. package/src/requirements-status-participants-http.test.ts +222 -0
  269. package/src/requirements-upgrade-e2e.test.ts +126 -0
  270. package/src/requirements-upgrade-migration.test.ts +98 -0
  271. package/src/requirements.ts +2205 -0
  272. package/src/resolve-port.test.ts +57 -0
  273. package/src/resolve-port.ts +44 -0
  274. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  275. package/src/rest-alias-network-fallback.test.ts +60 -0
  276. package/src/rest-alias-network-fallback.ts +65 -0
  277. package/src/rest-explicit-columns-http.test.ts +266 -0
  278. package/src/rest-identity.test.ts +130 -0
  279. package/src/rest-identity.ts +141 -0
  280. package/src/rest-projections.ts +72 -0
  281. package/src/rest-read-network-real-chain.test.ts +97 -0
  282. package/src/rest-write-network-resolution.test.ts +133 -0
  283. package/src/restart-readiness-http.test.ts +121 -0
  284. package/src/restricted-files.ts +76 -0
  285. package/src/retention-first-sweep-quiet.test.ts +31 -0
  286. package/src/retention.test.ts +100 -40
  287. package/src/retention.ts +423 -104
  288. package/src/route-callers-http.test.ts +120 -0
  289. package/src/route-timing.test.ts +218 -0
  290. package/src/route-timing.ts +262 -0
  291. package/src/rules-file-duplicate-alias.test.ts +234 -0
  292. package/src/rules-file-session-target.test.ts +207 -0
  293. package/src/rules-file-transport.test.ts +271 -0
  294. package/src/runtime-label.test.ts +22 -0
  295. package/src/runtime-label.ts +21 -0
  296. package/src/runtime-readiness.ts +90 -0
  297. package/src/schedule-agent-mcp-http.test.ts +486 -0
  298. package/src/schedule-agent.ts +252 -0
  299. package/src/schedule-starved.test.ts +92 -0
  300. package/src/schedule-starved.ts +114 -0
  301. package/src/scheduled-backoff-http.test.ts +203 -0
  302. package/src/scheduled-backoff.ts +64 -0
  303. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  304. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  305. package/src/scheduled-failure-code.test.ts +73 -0
  306. package/src/scheduled-failure-code.ts +105 -0
  307. package/src/scheduled-failures-http.test.ts +279 -0
  308. package/src/scheduled-failures.ts +425 -0
  309. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  310. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  311. package/src/scheduled-offline.test.ts +131 -0
  312. package/src/scheduled-offline.ts +66 -0
  313. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  314. package/src/scheduled-outcome-guidance.ts +9 -0
  315. package/src/scheduled-reply-unread-http.test.ts +212 -0
  316. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  317. package/src/scheduled-requirement-wake.ts +125 -0
  318. package/src/scheduled-run-terminal.test.ts +290 -0
  319. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  320. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  321. package/src/scheduled-stuck-http.test.ts +316 -0
  322. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  323. package/src/scheduled-stuck.ts +219 -0
  324. package/src/scheduled-tasks-http.test.ts +679 -0
  325. package/src/scheduled-tasks.ts +959 -0
  326. package/src/scheduled-work-outcome-http.test.ts +154 -0
  327. package/src/scheduled-work-outcome.ts +50 -0
  328. package/src/scoped-secrets.ts +141 -0
  329. package/src/secret-echo-negative-control.test.ts +118 -0
  330. package/src/send-dedup-request-id.test.ts +229 -0
  331. package/src/send-reply-agent-warning.test.ts +38 -38
  332. package/src/send-reply-alias-optional.test.ts +131 -0
  333. package/src/send-reply-attachments.test.ts +28 -7
  334. package/src/send_dedup.test.ts +54 -0
  335. package/src/send_dedup.ts +52 -6
  336. package/src/serve-error.test.ts +73 -0
  337. package/src/serve-error.ts +56 -0
  338. package/src/server.ts +4846 -325
  339. package/src/session-task-on-dispatch.ts +14 -0
  340. package/src/session-token-ownership-http.test.ts +122 -0
  341. package/src/shared/codex-inventory.ts +41 -0
  342. package/src/shared/daemon-provider-login.ts +31 -0
  343. package/src/shared/daemon-provider-snapshot.ts +52 -0
  344. package/src/shared/external-schedule-contract.ts +60 -0
  345. package/src/shared/node-name.test.ts +62 -0
  346. package/src/shared/node-name.ts +161 -0
  347. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  348. package/src/shared/provider-application.ts +29 -0
  349. package/src/shared/provider-collection.ts +14 -0
  350. package/src/shared/provider-initialization.ts +8 -0
  351. package/src/shared/reserved-env-drift.test.ts +10 -0
  352. package/src/shared/scoped-secret-contract.ts +5 -0
  353. package/src/shared/task-content-limit-drift.test.ts +28 -0
  354. package/src/shared/task-content-limit.ts +25 -0
  355. package/src/side-thread-command-transport.test.ts +312 -0
  356. package/src/side-thread-command-transport.ts +318 -0
  357. package/src/side-thread-http-integration.test.ts +233 -0
  358. package/src/side-thread-http.ts +504 -0
  359. package/src/side-thread-production.test.ts +72 -0
  360. package/src/side-thread-production.ts +118 -0
  361. package/src/side-thread.test.ts +1067 -0
  362. package/src/side-thread.ts +2499 -0
  363. package/src/skillhub-http.test.ts +144 -0
  364. package/src/sqlite-close-checkpoint.test.ts +78 -0
  365. package/src/start-node.test.ts +265 -0
  366. package/src/start-request-error-domain.test.ts +182 -0
  367. package/src/start-skill-error-domain.test.ts +122 -0
  368. package/src/stats-versions-http.test.ts +65 -0
  369. package/src/status-alias-filter-http.test.ts +106 -0
  370. package/src/status-alias-resolver-http.test.ts +163 -0
  371. package/src/status-alias-resolver.ts +19 -0
  372. package/src/status-node-id-filter-http.test.ts +161 -0
  373. package/src/status-read-cache-http.test.ts +229 -0
  374. package/src/status-read-cache.ts +129 -0
  375. package/src/stop-delete-node.test.ts +567 -1
  376. package/src/task-access-http.test.ts +402 -0
  377. package/src/task-access.ts +420 -0
  378. package/src/task-activity.ts +60 -0
  379. package/src/task-auth-origin-http.test.ts +93 -0
  380. package/src/task-auth-origin.test.ts +24 -0
  381. package/src/task-auth-origin.ts +7 -0
  382. package/src/task-consumption.test.ts +508 -0
  383. package/src/task-diagnostic-http.test.ts +149 -0
  384. package/src/task-diagnostic.test.ts +115 -0
  385. package/src/task-diagnostic.ts +118 -0
  386. package/src/task-expiry-notice-http.test.ts +298 -0
  387. package/src/task-expiry-notice.ts +318 -0
  388. package/src/task-idempotency-mcp.test.ts +148 -0
  389. package/src/task-idempotency.test.ts +76 -0
  390. package/src/task-idempotency.ts +81 -0
  391. package/src/task-late-replies.ts +54 -0
  392. package/src/task-late-reply-http.test.ts +227 -0
  393. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  394. package/src/task-lifecycle-watcher.test.ts +209 -0
  395. package/src/task-lifecycle-watcher.ts +109 -0
  396. package/src/task-network-resolution-http.test.ts +140 -0
  397. package/src/task-not-found-error-domain.test.ts +114 -0
  398. package/src/task-offline-delivery-2668.test.ts +119 -0
  399. package/src/task-offline-delivery.ts +81 -0
  400. package/src/task-orphan-http.test.ts +287 -0
  401. package/src/task-orphan.ts +119 -0
  402. package/src/task-queue-ahead-http.test.ts +309 -0
  403. package/src/task-queue-ahead-scale.test.ts +236 -0
  404. package/src/task-queue-ahead.ts +186 -0
  405. package/src/task-rejection-log-http.test.ts +160 -0
  406. package/src/task-rejection-log.ts +61 -0
  407. package/src/task-sender-http.test.ts +143 -0
  408. package/src/task-stale-open-http.test.ts +292 -0
  409. package/src/task-stale-open.ts +103 -0
  410. package/src/tasks-pagination-http.test.ts +141 -0
  411. package/src/team-rules-status-http.test.ts +90 -0
  412. package/src/team-rules-status.test.ts +59 -0
  413. package/src/team-rules-status.ts +72 -0
  414. package/src/tmux-allowlist.test.ts +48 -0
  415. package/src/tool-audience-http.test.ts +248 -0
  416. package/src/tool-audience.ts +127 -0
  417. package/src/tools-list-json-schema.test.ts +94 -0
  418. package/src/tools.ts +4229 -397
  419. package/src/update-node-config-error-domain.test.ts +107 -0
  420. package/src/uploads-http.test.ts +6 -4
  421. package/src/uploads.ts +23 -4
  422. package/src/user-avatar-http.test.ts +74 -0
  423. package/src/user-avatar-image.ts +160 -0
  424. package/src/user-avatar-migration.test.ts +25 -0
  425. package/src/user-avatar-upload-http.test.ts +348 -0
  426. package/src/user-inbox-by-agent-http.test.ts +165 -0
  427. package/src/user-inbox-netid-notnull.test.ts +122 -0
  428. package/src/user-inbox-read-http.test.ts +223 -0
  429. package/src/user-inbox-schema.test.ts +54 -0
  430. package/src/version-stats.test.ts +66 -0
  431. package/src/version-stats.ts +109 -0
@@ -0,0 +1,38 @@
1
+ // #2363 —— MCP 在飞计数(先只观测,不拦请求)。
2
+ //
3
+ // 为什么需要它:隔离 Hub 上用**生产库副本**实测,RSS 与“同时在飞的 MCP 请求数”
4
+ // 成正比(≈1.2–1.4 MB/条;`send_message` 与 `get_inbox` 同形),而与吞吐无关——
5
+ // 顺序发 3,255 条/60s(≈54 条/秒)时 RSS 稳定在 151–156 MB,而 50/100/200 并发
6
+ // 的峰值是 249/446/689 MB。`/health` 里的 `sse_connections` 只反映长连接,看不到
7
+ // 这个量,所以生产上“为什么 RSS 突然抬到 450 MB”一直只能事后猜。
8
+ //
9
+ // 本模块只做计数与峰值,**不拒绝、不排队、不改任何响应**——限流(有界队列 + 429)
10
+ // 是另一步,需要先有一天的真实分布再定上限。见 docs/runbooks/hub-memory-and-sse.md。
11
+
12
+ let inflight = 0;
13
+ let peak = 0;
14
+
15
+ /** /mcp 进入时调用(在任何 await 之前,保证计入请求体解析阶段)。 */
16
+ export function enterMcpInflight(): void {
17
+ inflight += 1;
18
+ if (inflight > peak) peak = inflight;
19
+ }
20
+
21
+ /** /mcp 结束时调用(响应对象产出且 MCP server 已关闭);重复调用安全。 */
22
+ export function leaveMcpInflight(): void {
23
+ if (inflight > 0) inflight -= 1;
24
+ }
25
+
26
+ /**
27
+ * 当前在飞数与**自上次 reset 以来的峰值**。
28
+ * 峰值是“滚动高水位”,不会自己回落——运维看它判断是否撞到过悬崖,
29
+ * 看 `inflight` 判断现在是否还在里面。
30
+ */
31
+ export function getMcpInflightStats(): { inflight: number; peak: number } {
32
+ return { inflight, peak };
33
+ }
34
+
35
+ /** 把峰值重置为当前在飞数(运维定位完一次尖峰后调用,或测试用)。 */
36
+ export function resetMcpInflightPeak(): void {
37
+ peak = inflight;
38
+ }
@@ -0,0 +1,168 @@
1
+ // MCP projects_create / projects_update / requirements_events(app 任务页审计 2026-10-02 M3:Agent 能做人能做的)。
2
+ // HTTP 集成测试(真实 Bun.serve,私有端口,临时库)。三个工具都走 app 用的同一套 REST 处理(handleRequirementsRequest),
3
+ // 所以这里不另抄一份权限规则:对每类调用者(网络 owner、全部任务成员、仅相关任务成员、viewer、节点令牌)都同时调
4
+ // MCP 和 REST,断言状态码 / 结果逐项一致。再钉住正向行为(建 / 改名 / 归档 / 取消归档、读流水、"#N")和工具出现在 tools/list 里。
5
+
6
+ import { describe, expect, test, beforeAll, afterAll } from "bun:test";
7
+ import { mkdtempSync, rmSync } from "fs";
8
+ import { join } from "path";
9
+ import { tmpdir } from "os";
10
+ import { register, createNetworkTokenForNode } from "./auth.js";
11
+ import { db } from "./db.js";
12
+
13
+ const DIR = mkdtempSync(join(tmpdir(), "anet-mcp-projects-events-"));
14
+ let BASE = "";
15
+ let hub: any = null;
16
+ const PW = "McpProjectsEventsPassw0rd!x";
17
+ let NET = "";
18
+ const U: Record<string, { token: string; id: string }> = {};
19
+
20
+ async function rest(token: string, method: string, path: string, body?: unknown) {
21
+ const res = await fetch(`${BASE}${path}`, { method, headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" }, body: body === undefined ? undefined : JSON.stringify(body) });
22
+ const text = await res.text();
23
+ let json: any = null;
24
+ try { json = JSON.parse(text); } catch {}
25
+ return { status: res.status, body: json };
26
+ }
27
+ async function rpc(token: string, method: string, params?: unknown): Promise<any> {
28
+ const res = await fetch(`${BASE}/mcp`, {
29
+ method: "POST",
30
+ headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json", Accept: "application/json, text/event-stream", "MCP-Protocol-Version": "2025-03-26" },
31
+ body: JSON.stringify({ jsonrpc: "2.0", id: 1, method, ...(params === undefined ? {} : { params }) }),
32
+ });
33
+ const raw = await res.text();
34
+ const lines = raw.split("\n").filter(x => x.startsWith("data:"));
35
+ return lines.length ? JSON.parse(lines.at(-1)!.slice(5).trim()) : JSON.parse(raw);
36
+ }
37
+ async function mcp(token: string, name: string, args: Record<string, unknown>): Promise<any> {
38
+ const out = await rpc(token, "tools/call", { name, arguments: args });
39
+ return JSON.parse(out.result.content[0].text);
40
+ }
41
+ // MCP error bodies from the REST handler carry its status (requirementsCall). Anything else that isn't ok (e.g. a tool-level
42
+ // gate) is NOT a success — a body without `status` must never be read as the 2xx (that hid a gate in the first draft).
43
+ const mcpStatus = (r: any, okStatus: number) => (r?.ok === true || (r && r.ok === undefined && (r.project || r.events)) ? okStatus : typeof r?.status === "number" ? r.status : -1);
44
+
45
+ beforeAll(async () => {
46
+ process.env.COMMHUB_DB ||= join(DIR, "hub.db");
47
+ process.env.COMMHUB_UPLOADS_DIR = join(DIR, "uploads");
48
+ process.env.HOST = "127.0.0.1";
49
+ const a = register(`mpe_owner_${Date.now()}`, PW, undefined, "Owner");
50
+ expect(a.ok).toBe(true);
51
+ U.owner = { token: a.token!, id: a.user!.user_id };
52
+ NET = a.network_id!;
53
+ db.run("UPDATE users SET role = 'admin' WHERE user_id = ?1", [U.owner.id]);
54
+ const mod: any = await import("./server.js");
55
+ hub = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
56
+ BASE = `http://127.0.0.1:${hub.port}`;
57
+ const mk = async (username: string, role: string) => {
58
+ expect((await rest(U.owner.token, "POST", "/api/admin/users", { username, password: PW, network_id: NET, role })).status).toBe(200);
59
+ const login = await rest("", "POST", "/api/auth/login", { username, password: PW });
60
+ expect(login.status).toBe(200);
61
+ return { token: login.body.token as string, id: login.body.user.user_id as string };
62
+ };
63
+ const stamp = Date.now();
64
+ U.member = await mk(`mpe_member_${stamp}`, "member");
65
+ U.scoped = await mk(`mpe_scoped_${stamp}`, "member");
66
+ U.viewer = await mk(`mpe_viewer_${stamp}`, "viewer");
67
+ db.run("UPDATE network_members SET task_access = 'all' WHERE network_id = ?1 AND user_id = ?2", [NET, U.member.id]);
68
+ expect((await rest(U.owner.token, "PUT", `/api/networks/${NET}/members/${U.scoped.id}/task-grants`, { task_access: "scoped", project_grants: [] })).status).toBe(200);
69
+ const node = createNetworkTokenForNode(U.owner.id, NET, "mpe-node", "node_mpe");
70
+ U.node = { token: node.token!, id: "node_mpe" };
71
+ }, 30_000);
72
+
73
+ afterAll(() => {
74
+ try { hub?.stop?.(true); } catch {}
75
+ try { rmSync(DIR, { recursive: true, force: true }); } catch {}
76
+ });
77
+
78
+ describe("discoverable", () => {
79
+ test("tools/list carries the three tools with descriptions", async () => {
80
+ const list = await rpc(U.owner.token, "tools/list");
81
+ const byName = new Map((list.result.tools as any[]).map(t => [t.name, t]));
82
+ for (const n of ["projects_create", "projects_update", "requirements_events"]) {
83
+ expect(byName.has(n)).toBe(true);
84
+ expect(String(byName.get(n).description).length).toBeGreaterThan(40);
85
+ }
86
+ expect(String(byName.get("projects_list").description)).toContain("projects_create");
87
+ });
88
+ });
89
+
90
+ describe("projects_create / projects_update", () => {
91
+ test("owner: create, rename, recolour, archive, unarchive — same rows the app sees", async () => {
92
+ const created = await mcp(U.owner.token, "projects_create", { network_id: NET, name: "mpe-项目甲" });
93
+ // #3275 批次 4 —— projects_create 与 projects_update 同形({ok, project}):
94
+ // 「写项目」这一族回**实体**,不回集合。两个工具各自钉,不互相代言。
95
+ expect(Object.keys(created).sort()).toEqual(["ok", "project"]);
96
+ expect(created.ok).toBe(true);
97
+ const id = created.project.id as string;
98
+ expect(created.project.name).toBe("mpe-项目甲");
99
+ const renamed = await mcp(U.owner.token, "projects_update", { network_id: NET, id, name: "mpe-项目乙", color: "#16a34a" });
100
+ // 2026-10-31 —— **精确键集**(#3171):项目更新回执是 `{ok, project}` 两键;
101
+ // 多给一格(比如回显整个项目集合)会让「一次更新」变成「一次列表」。
102
+ expect(Object.keys(renamed).sort()).toEqual(["ok", "project"]);
103
+ expect(renamed.project.name).toBe("mpe-项目乙");
104
+ expect(renamed.project.color).toBe("#16a34a");
105
+ expect((await mcp(U.owner.token, "projects_update", { network_id: NET, id, archived: true })).project.archived).toBe(true);
106
+ const seen = await rest(U.owner.token, "GET", `/api/requirements/projects?network_id=${NET}`);
107
+ expect(seen.body.projects.find((p: any) => p.id === id).archived).toBe(true);
108
+ expect((await mcp(U.owner.token, "projects_update", { network_id: NET, id, archived: false })).project.archived).toBe(false);
109
+ });
110
+
111
+ test("validation comes from the REST handler: duplicate name 409, unknown id 404", async () => {
112
+ await mcp(U.owner.token, "projects_create", { network_id: NET, name: "mpe-重名" });
113
+ const dup = await mcp(U.owner.token, "projects_create", { network_id: NET, name: "mpe-重名" });
114
+ expect(dup.ok).toBe(false);
115
+ expect(dup.status).toBe(409);
116
+ const missing = await mcp(U.owner.token, "projects_update", { network_id: NET, id: "proj_nobody", name: "x" });
117
+ expect(missing.status).toBe(404);
118
+ });
119
+
120
+ test("permission parity with the app's REST path, for every kind of caller", async () => {
121
+ const results: Record<string, { mcp: number; rest: number }> = {};
122
+ for (const who of ["owner", "member", "scoped", "viewer", "node"]) {
123
+ const name = `mpe-parity-${who}`;
124
+ const viaMcp = await mcp(U[who].token, "projects_create", { network_id: NET, name: `${name}-mcp` });
125
+ const viaRest = await rest(U[who].token, "POST", `/api/requirements/projects?network_id=${NET}`, { name: `${name}-rest` });
126
+ results[who] = { mcp: mcpStatus(viaMcp, 201), rest: viaRest.status };
127
+ }
128
+ for (const r of Object.values(results)) expect(r.mcp).toBe(r.rest);
129
+ // the rule itself (RFC-038 §9): task-scoped members and viewers can't manage projects; the others can
130
+ expect(results.owner.rest).toBe(201);
131
+ expect(results.member.rest).toBe(201);
132
+ expect(results.scoped.rest).toBe(403);
133
+ expect(results.viewer.rest).toBe(403);
134
+ });
135
+ });
136
+
137
+ describe("requirements_events", () => {
138
+ test("one task's timeline by id and by #N, same rows as GET /api/requirements/events", async () => {
139
+ const card = await rest(U.owner.token, "POST", "/api/requirements", { network_id: NET, name: "mpe-流水示例" });
140
+ expect(card.status).toBe(201);
141
+ const id = card.body.requirement.id as string, seq = card.body.requirement.seq as number;
142
+ expect((await rest(U.owner.token, "PATCH", `/api/requirements/${id}?network_id=${NET}`, { priority: "high" })).status).toBe(200);
143
+ const viaMcp = await mcp(U.owner.token, "requirements_events", { network_id: NET, requirement_id: id });
144
+ const viaRest = await rest(U.owner.token, "GET", `/api/requirements/events?network_id=${NET}&requirement_id=${id}`);
145
+ expect(viaMcp.ok).toBe(true);
146
+ expect(viaMcp.events.length).toBeGreaterThan(0);
147
+ expect(viaMcp.events.map((e: any) => e.id)).toEqual(viaRest.body.events.map((e: any) => e.id));
148
+ expect(viaMcp.events.every((e: any) => e.requirement_id === id)).toBe(true);
149
+ const bySeq = await mcp(U.owner.token, "requirements_events", { network_id: NET, requirement_id: `#${seq}` });
150
+ expect(bySeq.events.map((e: any) => e.id)).toEqual(viaMcp.events.map((e: any) => e.id));
151
+ // paging / bad input come from the REST handler too
152
+ expect((await mcp(U.owner.token, "requirements_events", { network_id: NET, since: "not-a-date" })).status).toBe(400);
153
+ expect((await mcp(U.owner.token, "requirements_events", { network_id: NET, requirement_id: "#999999" })).status).toBe(404);
154
+ });
155
+
156
+ test("visibility parity: a task-scoped member doesn't get events for a task they can't see", async () => {
157
+ const hidden = await rest(U.owner.token, "POST", "/api/requirements", { network_id: NET, name: "mpe-看不见的" });
158
+ const id = hidden.body.requirement.id as string;
159
+ await rest(U.owner.token, "PATCH", `/api/requirements/${id}?network_id=${NET}`, { priority: "low" });
160
+ for (const who of ["scoped", "member", "node"]) {
161
+ const viaMcp = await mcp(U[who].token, "requirements_events", { network_id: NET, requirement_id: id });
162
+ const viaRest = await rest(U[who].token, "GET", `/api/requirements/events?network_id=${NET}&requirement_id=${id}`);
163
+ expect((viaMcp.events ?? []).map((e: any) => e.id)).toEqual((viaRest.body?.events ?? []).map((e: any) => e.id));
164
+ }
165
+ expect((await mcp(U.scoped.token, "requirements_events", { network_id: NET, requirement_id: id })).events ?? []).toHaveLength(0);
166
+ expect((await mcp(U.member.token, "requirements_events", { network_id: NET, requirement_id: id })).events.length).toBeGreaterThan(0);
167
+ });
168
+ });
@@ -0,0 +1,120 @@
1
+ // POST /mcp in /api/stats/routes carries the JSON-RPC method and, for tools/call, the tool name
2
+ // ("POST /mcp tools/call report_status"). Production showed POST /mcp as the biggest route (15 req/s,
3
+ // ~13% of a core) with no way to tell which tool. This suite pins, over real HTTP:
4
+ // - the labels (tools/call <name>, tools/list, batch) and that MCP responses are unchanged in kind;
5
+ // - arguments never reach the stats (a marker in arguments / a hostile tool name never shows up);
6
+ // - odd bodies still get the transport's own answers (invalid JSON → -32700, oversized → parsed by
7
+ // the transport itself) and are labelled "?";
8
+ // - unauthenticated /mcp stays plain "POST /mcp" (the body is never read before auth).
9
+
10
+ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
11
+ import { mkdtempSync, rmSync } from "node:fs";
12
+ import { tmpdir } from "node:os";
13
+ import { join } from "node:path";
14
+
15
+ const DIR = mkdtempSync(join(tmpdir(), "anet-mcp-route-label-"));
16
+ process.env.COMMHUB_DB ||= join(DIR, "hub.db");
17
+ process.env.COMMHUB_UPLOADS_DIR = join(DIR, "uploads");
18
+
19
+ const PW = "McpRouteLabelPassw0rd!";
20
+ const MARKER = "zz-argument-marker-7f3a";
21
+ let BASE = "";
22
+ let hub: any = null;
23
+ let admin = "";
24
+
25
+ const MCP_HEADERS = { "Content-Type": "application/json", Accept: "application/json, text/event-stream", "MCP-Protocol-Version": "2025-03-26" };
26
+ async function mcpRaw(token: string, body: string): Promise<{ status: number; text: string }> {
27
+ const res = await fetch(`${BASE}/mcp`, { method: "POST", headers: { ...(token ? { Authorization: `Bearer ${token}` } : {}), ...MCP_HEADERS }, body });
28
+ return { status: res.status, text: await res.text() };
29
+ }
30
+ function rpc(text: string): any {
31
+ const lines = text.split("\n").filter(x => x.startsWith("data:"));
32
+ return lines.length ? JSON.parse(lines.at(-1)!.slice(5).trim()) : JSON.parse(text);
33
+ }
34
+ async function routes(): Promise<{ text: string; keys: string[]; rows: any[] }> {
35
+ const res = await fetch(`${BASE}/api/stats/routes?minutes=5`, { headers: { Authorization: `Bearer ${admin}` } });
36
+ const text = await res.text();
37
+ const rows = JSON.parse(text).routes as any[];
38
+ return { text, keys: rows.map(r => r.route), rows };
39
+ }
40
+
41
+ beforeAll(async () => {
42
+ process.env.HOST = "127.0.0.1";
43
+ const { register } = await import("./auth.js");
44
+ const { db } = await import("./db.js");
45
+ const a = register(`mrl_admin_${Date.now()}`, PW);
46
+ admin = a.token!;
47
+ db.run("UPDATE users SET role = 'admin' WHERE user_id = ?1", [a.user!.user_id]);
48
+ const mod: any = await import("./server.js");
49
+ hub = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
50
+ BASE = `http://127.0.0.1:${hub.port}`;
51
+ }, 30_000);
52
+
53
+ afterAll(() => {
54
+ try { hub?.stop?.(true); } catch {}
55
+ try { rmSync(DIR, { recursive: true, force: true }); } catch {}
56
+ });
57
+
58
+ describe("POST /mcp route label", () => {
59
+ test("tools/call is labelled with the tool name and still answers normally", async () => {
60
+ const r = await mcpRaw(admin, JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: { name: "get_all_status", arguments: { note: MARKER } } }));
61
+ expect(r.status).toBe(200);
62
+ expect(rpc(r.text).result).toBeDefined();
63
+ const { keys } = await routes();
64
+ expect(keys).toContain("POST /mcp tools/call get_all_status");
65
+ });
66
+
67
+ test("tools/list and a batch get their own labels", async () => {
68
+ const list = await mcpRaw(admin, JSON.stringify({ jsonrpc: "2.0", id: 2, method: "tools/list" }));
69
+ expect(list.status).toBe(200);
70
+ expect(rpc(list.text).result.tools.length).toBeGreaterThan(10);
71
+ await mcpRaw(admin, JSON.stringify([{ jsonrpc: "2.0", id: 3, method: "tools/list" }]));
72
+ const { keys } = await routes();
73
+ expect(keys).toContain("POST /mcp tools/list");
74
+ expect(keys).toContain("POST /mcp batch");
75
+ });
76
+
77
+ test("arguments and hostile tool names never reach the stats", async () => {
78
+ await mcpRaw(admin, JSON.stringify({ jsonrpc: "2.0", id: 4, method: "tools/call", params: { name: `x ${MARKER}`, arguments: { a: MARKER } } }));
79
+ await mcpRaw(admin, JSON.stringify({ jsonrpc: "2.0", id: 5, method: "tools/call", params: { name: "n".repeat(500), arguments: {} } }));
80
+ await mcpRaw(admin, JSON.stringify({ jsonrpc: "2.0", id: 6, method: `tools/${MARKER} with spaces` }));
81
+ const { text, keys } = await routes();
82
+ expect(text).not.toContain(MARKER);
83
+ expect(text).not.toContain("n".repeat(65));
84
+ expect(keys).toContain("POST /mcp tools/call ?");
85
+ expect(keys).toContain("POST /mcp ?");
86
+ for (const k of keys) expect(k.length).toBeLessThan(200);
87
+ });
88
+
89
+ test("invalid JSON still gets the transport's parse error, labelled ?", async () => {
90
+ const r = await mcpRaw(admin, `{"jsonrpc":"2.0","method":"tools/list",`);
91
+ expect(r.status).toBe(400);
92
+ expect(rpc(r.text).error.code).toBe(-32700);
93
+ expect(rpc(r.text).error.message).toBe("Parse error: Invalid JSON");
94
+ const notRpc = await mcpRaw(admin, "null");
95
+ expect(notRpc.status).toBe(400);
96
+ expect(rpc(notRpc.text).error.code).toBe(-32700);
97
+ });
98
+
99
+ test("a body over the label limit is left to the transport and still works, labelled ?", async () => {
100
+ const { __resetRouteTimingForTest } = await import("./route-timing.js");
101
+ __resetRouteTimingForTest();
102
+ const padded = JSON.stringify({ jsonrpc: "2.0", id: 7, method: "tools/list" }).replace("{", "{" + " ".repeat(1024 * 1024 + 10));
103
+ const r = await mcpRaw(admin, padded);
104
+ expect(r.status).toBe(200);
105
+ expect(rpc(r.text).result.tools.length).toBeGreaterThan(10);
106
+ const { keys } = await routes();
107
+ expect(keys).toContain("POST /mcp ?");
108
+ expect(keys).not.toContain("POST /mcp tools/list");
109
+ });
110
+
111
+ test("unauthenticated /mcp is refused as before and not labelled", async () => {
112
+ const { __resetRouteTimingForTest } = await import("./route-timing.js");
113
+ __resetRouteTimingForTest();
114
+ const r = await mcpRaw("", JSON.stringify({ jsonrpc: "2.0", id: 8, method: "tools/list" }));
115
+ expect(r.status).toBe(401);
116
+ const { keys } = await routes();
117
+ expect(keys).toContain("POST /mcp");
118
+ expect(keys.filter(k => k.startsWith("POST /mcp "))).toEqual([]);
119
+ });
120
+ });
@@ -163,6 +163,12 @@ describe("utok single-network auto-resolve (no network_id argument)", () => {
163
163
  test("send_task resolves to the only membership", async () => {
164
164
  const { tools } = buildHandlers({ userId: U_SINGLE });
165
165
  const r = await call(tools["send_task"], { alias: A1, task: "x517 g1 send_task", priority: "normal" });
166
+ // #3275 批次 2 —— 同变量口径:`send_task` 的成功回执是 7 键(实测,不是推断)。
167
+ // 这七格里 queue_ahead / target_busy / est_wait_minutes 是「建议」:
168
+ // 少一个,调用方就不知道排在第几位;多一个,客户端会多一条没人写过的分支。
169
+ expect(Object.keys(r).sort()).toEqual([
170
+ "actual_to", "est_wait_minutes", "message_id", "ok", "queue_ahead", "session_status", "target_busy",
171
+ ]);
166
172
  expect(r.ok).toBe(true);
167
173
  expect(taskRow("x517 g1 send_task")?.network_id).toBe(NET_A);
168
174
  });
@@ -170,6 +176,8 @@ describe("utok single-network auto-resolve (no network_id argument)", () => {
170
176
  test("send_message resolves to the only membership", async () => {
171
177
  const { tools } = buildHandlers({ userId: U_SINGLE });
172
178
  const r = await call(tools["send_message"], { alias: A1, message: "x517 g1 send_message" });
179
+ // #3275 批次 2 —— send_message 外层闭集(实测)
180
+ expect(Object.keys(r).sort()).toEqual(["message_id", "ok", "session_status"]);
173
181
  expect(r.ok).toBe(true);
174
182
  expect(inboxRow("x517 g1 send_message")?.network_id).toBe(NET_A);
175
183
  });
@@ -194,6 +202,9 @@ describe("utok single-network auto-resolve (no network_id argument)", () => {
194
202
  const { tools } = buildHandlers({ userId: U_SINGLE });
195
203
  const t = makeTask(A1, "delivered", "x517 g1 send_ack");
196
204
  const r = await call(tools["send_ack"], { task_id: t });
205
+ // #3275 批次 2 —— send_ack 外层闭集(实测):`updated` 是**这次是否真的改了状态**,
206
+ // 与 ok 不同(ok=调用成功);少了它,客户端分不清「已 ack」与「早就是 ack 状态」。
207
+ expect(Object.keys(r).sort()).toEqual(["ok", "task_id", "updated"]);
197
208
  expect(r.ok).toBe(true);
198
209
  expect(taskById(t)?.status).toBe("acked");
199
210
  });
@@ -211,6 +222,9 @@ describe("utok single-network auto-resolve (no network_id argument)", () => {
211
222
  const t = makeTask(A1, "delivered", "x517 g1 cancel_task");
212
223
  const r = await call(tools["cancel_task"], { task_id: t });
213
224
  expect(r.ok).toBe(true);
225
+ // 2026-10-31 —— **同变量口径的精确键集**(#3171):这条断言绑的是本次调用的结果变量 r。
226
+ // 实际三键(我第一版只写了 ok —— 断言当场纠正)。
227
+ expect(Object.keys(r).sort()).toEqual(["cancelled", "ok", "task_id"]);
214
228
  expect(taskById(t)?.status).toBe("cancelled");
215
229
  });
216
230
 
@@ -218,6 +232,10 @@ describe("utok single-network auto-resolve (no network_id argument)", () => {
218
232
  const { tools } = buildHandlers({ userId: U_SINGLE });
219
233
  const t = makeTask(A1, "delivered", "x517 g1 reassign_task");
220
234
  const r = await call(tools["reassign_task"], { task_id: t, new_alias: A2 });
235
+ // #3275 批次 2 —— 同变量口径,形状由一次真实调用给出(不是按源码推断):
236
+ // 回执带**两端**(reassigned_from / reassigned_to)。少一个,调用方就不知道它是从哪来的;
237
+ // 而这两端正是「改派」与「新建」在回执上唯一可分的地方。
238
+ expect(Object.keys(r).sort()).toEqual(["ok", "reassigned_from", "reassigned_to", "task_id"]);
221
239
  expect(r.ok).toBe(true);
222
240
  expect(taskById(t)?.to_name).toBe(A2);
223
241
  });
@@ -259,6 +277,9 @@ describe("utok multi-network", () => {
259
277
 
260
278
  test("ack_inbox threads explicit network_id", async () => {
261
279
  const { tools } = buildHandlers({ userId: U_MULTI });
280
+ // This tests network selection with an authorized recipient. Acting as
281
+ // another owner's recipient is covered by the HTTP identity suite.
282
+ db.run("UPDATE nodes SET owner_user_id = ?1 WHERE alias = ?2 AND network_id = ?3", [U_MULTI, A1, NET_A]);
262
283
  const ib = makeInbox(A1, "x517 g2 ack_inbox");
263
284
  const r = await call(tools["ack_inbox"], { alias: A1, message_id: ib, network_id: NET_A });
264
285
  expect(r.ok).toBe(true);
@@ -0,0 +1,93 @@
1
+ // 成员增 / 改角色 / 移出 的审计行必须带 network_id —— HTTP 集成测试(真实 Bun.serve,私有端口,临时库)。
2
+ //
3
+ // 之前这三条 logAudit 没传 networkId,audit_log.network_id 恒为 NULL:
4
+ // 按网络归属审计时它们整批丢失,而同一组路由里的 member_agent_grants_changed 一直带着。
5
+
6
+ import { describe, expect, test, beforeAll, afterAll } from "bun:test";
7
+ import { mkdtempSync, rmSync } from "fs";
8
+ import { join } from "path";
9
+ import { tmpdir } from "os";
10
+ import { register } from "./auth.js";
11
+ import { db } from "./db.js";
12
+
13
+ const DIR = mkdtempSync(join(tmpdir(), "anet-member-audit-"));
14
+ let BASE = "";
15
+ let hub: any = null;
16
+
17
+ const PW = "AuditTestPassw0rd!x";
18
+ let ownerToken = "";
19
+ let NET = "";
20
+ let bobId = "";
21
+
22
+ async function send(token: string, method: string, path: string, payload?: unknown): Promise<{ status: number; body: any }> {
23
+ const res = await fetch(`${BASE}${path}`, {
24
+ method,
25
+ headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
26
+ body: payload === undefined ? undefined : JSON.stringify(payload),
27
+ });
28
+ const text = await res.text();
29
+ let body: any = null;
30
+ try { body = JSON.parse(text); } catch {}
31
+ return { status: res.status, body };
32
+ }
33
+
34
+ const auditRow = (action: string) =>
35
+ db.get("SELECT network_id, target_id FROM audit_log WHERE action = ?1 ORDER BY id DESC LIMIT 1", action) as
36
+ { network_id: string | null; target_id: string | null } | null;
37
+
38
+ beforeAll(async () => {
39
+ process.env.COMMHUB_DB ||= join(DIR, "hub.db");
40
+ process.env.COMMHUB_UPLOADS_DIR = join(DIR, "uploads");
41
+ process.env.HOST = "127.0.0.1";
42
+
43
+ const owner = register(`audit_owner_${Date.now()}`, PW, undefined, "Owner");
44
+ expect(owner.ok).toBe(true);
45
+ ownerToken = owner.token!;
46
+ NET = owner.network_id!;
47
+ const bob = register(`audit_bob_${Date.now()}`, PW, undefined, "Bob");
48
+ expect(bob.ok).toBe(true);
49
+ bobId = bob.user!.user_id;
50
+
51
+ const mod: any = await import("./server.js");
52
+ hub = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
53
+ BASE = `http://127.0.0.1:${hub.port}`;
54
+ }, 30_000);
55
+
56
+ afterAll(() => {
57
+ try { hub?.stop?.(true); } catch {}
58
+ try { rmSync(DIR, { recursive: true, force: true }); } catch {}
59
+ });
60
+
61
+ describe("成员审计行带 network_id", () => {
62
+ test("member_added", async () => {
63
+ const r = await send(ownerToken, "POST", `/api/networks/${NET}/members`, { user_id: bobId, role: "member" });
64
+ expect(r.status).toBe(200);
65
+ const row = auditRow("member_added");
66
+ expect(row).toBeTruthy();
67
+ expect(row!.network_id).toBe(NET);
68
+ });
69
+
70
+ test("member_role_changed", async () => {
71
+ const r = await send(ownerToken, "PUT", `/api/networks/${NET}/members/${bobId}`, { role: "viewer" });
72
+ expect(r.status).toBe(200);
73
+ const row = auditRow("member_role_changed");
74
+ expect(row).toBeTruthy();
75
+ expect(row!.network_id).toBe(NET);
76
+ });
77
+
78
+ test("member_removed", async () => {
79
+ const r = await send(ownerToken, "DELETE", `/api/networks/${NET}/members/${bobId}`);
80
+ expect(r.status).toBe(200);
81
+ const row = auditRow("member_removed");
82
+ expect(row).toBeTruthy();
83
+ expect(row!.network_id).toBe(NET);
84
+ });
85
+
86
+ test("GET /api/audit-log(本人的审计)里这三条的 network_id 都是该网络", async () => {
87
+ const r = await send(ownerToken, "GET", "/api/audit-log?limit=200");
88
+ expect(r.status).toBe(200);
89
+ const mine = (r.body.logs as any[]).filter(e => ["member_added", "member_role_changed", "member_removed"].includes(e.action));
90
+ expect(mine.map(e => e.action).sort()).toEqual(["member_added", "member_removed", "member_role_changed"]);
91
+ for (const e of mine) expect(e.network_id).toBe(NET);
92
+ });
93
+ });