@sleep2agi/commhub-server 0.9.0-preview.27 → 0.9.0-preview.270

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 (444) 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 +210 -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 +885 -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 +223 -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/api-host-supervisors-can-create-nodes.test.ts +350 -0
  28. package/src/api-host-supervisors-fallback.test.ts +6 -7
  29. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  30. package/src/api-nodes-shape.test.ts +131 -4
  31. package/src/auth-abuse-counters.test.ts +144 -0
  32. package/src/auth-abuse-counters.ts +122 -0
  33. package/src/auth-layer-shape.test.ts +105 -0
  34. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  35. package/src/auth-sessions-http.test.ts +260 -0
  36. package/src/auth-validate.test.ts +5 -1
  37. package/src/auth-weak-password-login.test.ts +176 -0
  38. package/src/auth.ts +641 -68
  39. package/src/backfill-node-ids-2664.test.ts +128 -0
  40. package/src/binding-generation-http.test.ts +141 -0
  41. package/src/blocked-exit-on-reply.test.ts +122 -0
  42. package/src/broadcast-fanout-2721.test.ts +149 -0
  43. package/src/broadcast-fanout.ts +117 -0
  44. package/src/build-commit-report-http.test.ts +128 -0
  45. package/src/build-info.test.ts +60 -0
  46. package/src/build-info.ts +85 -0
  47. package/src/chain-attempt-dedup.test.ts +447 -0
  48. package/src/clip.test.ts +36 -0
  49. package/src/clip.ts +48 -0
  50. package/src/clone-node.test.ts +269 -0
  51. package/src/clone-node.ts +289 -0
  52. package/src/codex-config-flags.ts +77 -0
  53. package/src/codex-fork-contract.ts +23 -0
  54. package/src/codex-fork-migration.test.ts +38 -0
  55. package/src/commhub-bin-args.test.ts +85 -0
  56. package/src/config-apply-validate.test.ts +188 -1
  57. package/src/config-apply-validate.ts +222 -3
  58. package/src/cors-origins.test.ts +73 -0
  59. package/src/create-node-blocked-gate.test.ts +365 -0
  60. package/src/create-node-error-domain.test.ts +127 -0
  61. package/src/create-node-network-id.test.ts +91 -0
  62. package/src/create-node-tool-schema.test.ts +49 -0
  63. package/src/create-node-unicode-name.test.ts +126 -0
  64. package/src/create-node-validate.test.ts +199 -7
  65. package/src/create-node-validate.ts +232 -15
  66. package/src/create-node-workdir.test.ts +298 -0
  67. package/src/create-node.ts +88 -23
  68. package/src/daemon-provider-snapshots.test.ts +453 -0
  69. package/src/daemon-provider-snapshots.ts +327 -0
  70. package/src/daemon-token-owner-http.test.ts +346 -0
  71. package/src/dashboard-slash-routing-http.test.ts +109 -0
  72. package/src/db-adapter-guard.test.ts +148 -0
  73. package/src/db-adapter-translate.test.ts +128 -0
  74. package/src/db-adapter.ts +377 -91
  75. package/src/db-timestamp.test.ts +38 -0
  76. package/src/db-timestamp.ts +15 -0
  77. package/src/db.ts +1298 -153
  78. package/src/delivered-without-push.test.ts +140 -0
  79. package/src/department-groups-http.test.ts +209 -0
  80. package/src/department-groups-sync-http.test.ts +328 -0
  81. package/src/department-groups.ts +434 -0
  82. package/src/department-heads-http.test.ts +350 -0
  83. package/src/department-heads.ts +226 -0
  84. package/src/departments-agent-count.test.ts +139 -0
  85. package/src/departments-http.test.ts +185 -0
  86. package/src/departments-mcp-error-domain.test.ts +135 -0
  87. package/src/departments-mcp.test.ts +128 -0
  88. package/src/departments.ts +318 -0
  89. package/src/desktop-message-seam.test.ts +150 -0
  90. package/src/desktop-message.test.ts +368 -0
  91. package/src/dm-file-scope-http.test.ts +227 -0
  92. package/src/empty-node-sweeper.test.ts +104 -0
  93. package/src/empty-node-sweeper.ts +88 -0
  94. package/src/env-transport-gate-http.test.ts +240 -0
  95. package/src/env-transport-gate.ts +80 -0
  96. package/src/env-transport-policy.ts +56 -0
  97. package/src/etag-of.test.ts +57 -0
  98. package/src/event-loop-lag.test.ts +180 -0
  99. package/src/event-loop-lag.ts +201 -0
  100. package/src/expiry-counters.test.ts +187 -0
  101. package/src/expiry-counters.ts +227 -0
  102. package/src/expiry-evidence-db.test.ts +103 -0
  103. package/src/ext-token-shared.test.ts +60 -0
  104. package/src/ext-validation-regression.test.ts +10 -17
  105. package/src/external-schedule-edits-http.test.ts +321 -0
  106. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  107. package/src/external-schedule-edits.ts +327 -0
  108. package/src/file-download-authz-dev-open.test.ts +1 -1
  109. package/src/file-download-authz.test.ts +25 -4
  110. package/src/file-download-date-bucket.test.ts +1 -1
  111. package/src/file-network-scope-dev-open.test.ts +1 -1
  112. package/src/file-network-scope.test.ts +7 -6
  113. package/src/group-membership-events-http.test.ts +264 -0
  114. package/src/group-messages-http.test.ts +483 -0
  115. package/src/group-messages.ts +297 -0
  116. package/src/health-anon-readers.ts +67 -0
  117. package/src/health-host-disk-2756.test.ts +71 -0
  118. package/src/health-identity-root.test.ts +98 -0
  119. package/src/health-redaction.test.ts +1599 -7
  120. package/src/health-status-reasons.test.ts +84 -0
  121. package/src/host-supervisor-identity-http.test.ts +152 -0
  122. package/src/host-supervisor-identity.ts +92 -0
  123. package/src/host-supervisors-daemon-version.test.ts +137 -0
  124. package/src/http-gzip.test.ts +94 -0
  125. package/src/http-gzip.ts +112 -0
  126. package/src/hub-catalog-read-http.test.ts +664 -0
  127. package/src/hub-provider-config.test.ts +166 -0
  128. package/src/hub-provider-config.ts +202 -0
  129. package/src/hub-timestamp.test.ts +38 -0
  130. package/src/hub-timestamp.ts +27 -0
  131. package/src/human-dm.ts +215 -0
  132. package/src/human-inbox.ts +42 -0
  133. package/src/inbox-caller.ts +49 -0
  134. package/src/inbox-count-sse.test.ts +318 -0
  135. package/src/inbox-count.ts +29 -0
  136. package/src/index.ts +6 -2
  137. package/src/license-state.test.ts +105 -0
  138. package/src/license-state.ts +48 -0
  139. package/src/lifecycle-error-domain.test.ts +149 -0
  140. package/src/list-ack-error-domain.test.ts +108 -0
  141. package/src/list-host-supervisors.test.ts +15 -4
  142. package/src/list-tasks-omit-default.test.ts +84 -0
  143. package/src/list-tasks-since-last.test.ts +100 -0
  144. package/src/list-tasks-since.test.ts +104 -0
  145. package/src/mcp-context-cost-http.test.ts +127 -0
  146. package/src/mcp-inflight.test.ts +92 -0
  147. package/src/mcp-inflight.ts +38 -0
  148. package/src/mcp-projects-events-http.test.ts +168 -0
  149. package/src/mcp-route-label-http.test.ts +120 -0
  150. package/src/mcp-write-network-resolution.test.ts +21 -0
  151. package/src/member-audit-network-id-http.test.ts +93 -0
  152. package/src/member-presence-http.test.ts +210 -0
  153. package/src/messages-ack-by-agent-http.test.ts +142 -0
  154. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  155. package/src/migrate-sqlite-to-pg.ts +263 -0
  156. package/src/model-auth-notify-http.test.ts +181 -0
  157. package/src/model-auth-notify.ts +116 -0
  158. package/src/network-name-http.test.ts +75 -0
  159. package/src/network-quota-config.test.ts +100 -0
  160. package/src/network-rules-http.test.ts +169 -0
  161. package/src/network-rules.ts +129 -0
  162. package/src/network-scope.ts +222 -3
  163. package/src/network-token-membership-http.test.ts +186 -0
  164. package/src/node-alias-control.ts +12 -0
  165. package/src/node-attrs.test.ts +47 -2
  166. package/src/node-caller-identity-http.test.ts +1108 -0
  167. package/src/node-config-last-update.test.ts +126 -0
  168. package/src/node-config-last-update.ts +107 -0
  169. package/src/node-create-request-status-http.test.ts +105 -0
  170. package/src/node-daemon-bindings.test.ts +142 -0
  171. package/src/node-daemon-bindings.ts +135 -0
  172. package/src/node-failure-alert.test.ts +150 -0
  173. package/src/node-failure-alert.ts +177 -0
  174. package/src/node-files-transport.test.ts +350 -0
  175. package/src/node-health-codex-login.test.ts +120 -0
  176. package/src/node-health-dispatch-http.test.ts +373 -0
  177. package/src/node-health-guard-origin.test.ts +98 -0
  178. package/src/node-health-guard.ts +121 -0
  179. package/src/node-health-passthrough.test.ts +115 -0
  180. package/src/node-health-store.ts +101 -0
  181. package/src/node-id-alias.test.ts +190 -0
  182. package/src/node-identity-conflict-http.test.ts +269 -0
  183. package/src/node-identity-conflict.ts +142 -0
  184. package/src/node-identity-mismatch.test.ts +74 -0
  185. package/src/node-in-flight-tasks.ts +31 -0
  186. package/src/node-lifecycle-controllable.test.ts +64 -0
  187. package/src/node-lifecycle-controllable.ts +53 -0
  188. package/src/node-lifecycle-read-http.test.ts +257 -0
  189. package/src/node-lifecycle-read.ts +124 -0
  190. package/src/node-logs-transport.test.ts +266 -0
  191. package/src/node-peer-allowlist.test.ts +114 -0
  192. package/src/node-permissions-http.test.ts +901 -0
  193. package/src/node-permissions.ts +494 -0
  194. package/src/node-request-retention.test.ts +281 -0
  195. package/src/node-request-retention.ts +120 -0
  196. package/src/node-secret-rest-http.test.ts +190 -0
  197. package/src/node-secret-vault-inject.test.ts +132 -0
  198. package/src/node-security-write-gate.test.ts +72 -0
  199. package/src/node-serviceability.test.ts +86 -0
  200. package/src/node-serviceability.ts +124 -0
  201. package/src/node-session-control-http.test.ts +310 -0
  202. package/src/node-session-control.ts +258 -0
  203. package/src/node-skills-transport.test.ts +212 -0
  204. package/src/node-token-identity.ts +35 -0
  205. package/src/node-token-ownership.ts +51 -0
  206. package/src/node-token-privilege-http.test.ts +224 -0
  207. package/src/not-found-api-http.test.ts +67 -0
  208. package/src/observer-avatar-http.test.ts +103 -10
  209. package/src/observer-push.test.ts +76 -0
  210. package/src/opencode-catalog-report-http.test.ts +139 -0
  211. package/src/opencode-v2-catalog.test.ts +268 -0
  212. package/src/opencode-v2-catalog.ts +356 -0
  213. package/src/package-version-consistency.test.ts +25 -0
  214. package/src/parent-infer.test.ts +82 -0
  215. package/src/parent-infer.ts +110 -0
  216. package/src/parent-source-marker.test.ts +70 -0
  217. package/src/parent-source-orphan.test.ts +121 -0
  218. package/src/password-network-tokens.ts +25 -0
  219. package/src/peer-reply-atomic.test.ts +462 -0
  220. package/src/peer-reply-capability.test.ts +70 -0
  221. package/src/pg-worker.ts +87 -0
  222. package/src/poll-pacing.test.ts +74 -0
  223. package/src/poll-pacing.ts +123 -0
  224. package/src/probe-provider-error-domain.test.ts +145 -0
  225. package/src/project-dir-warn-clear-http.test.ts +132 -0
  226. package/src/project-viewer-can-http.test.ts +116 -0
  227. package/src/provider-skill-error-domain.test.ts +130 -0
  228. package/src/provider-tools-shape.test.ts +165 -0
  229. package/src/push.test.ts +20 -10
  230. package/src/push.ts +373 -9
  231. package/src/redact-tokens.test.ts +86 -0
  232. package/src/redact-tokens.ts +43 -0
  233. package/src/rejection-counters.test.ts +72 -0
  234. package/src/rejection-counters.ts +173 -0
  235. package/src/rename.ts +38 -10
  236. package/src/reply-target-derivation.test.ts +96 -0
  237. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  238. package/src/report-status-host-schema.test.ts +235 -0
  239. package/src/report-status-resume-id-handover.test.ts +184 -0
  240. package/src/report-status-secret-keys.test.ts +140 -0
  241. package/src/require-explicit-test-db.ts +9 -0
  242. package/src/requirement-due-reminders-http.test.ts +620 -0
  243. package/src/requirement-due-reminders.ts +416 -0
  244. package/src/requirement-events-http.test.ts +318 -0
  245. package/src/requirement-events.test.ts +45 -0
  246. package/src/requirement-events.ts +144 -0
  247. package/src/requirement-notify.ts +165 -0
  248. package/src/requirement-participant-notify-http.test.ts +313 -0
  249. package/src/requirement-tag-ops-http.test.ts +454 -0
  250. package/src/requirement-tag-tree-http.test.ts +275 -0
  251. package/src/requirement-tag-tree.ts +127 -0
  252. package/src/requirement-tags.ts +102 -0
  253. package/src/requirements-abandoned-http.test.ts +236 -0
  254. package/src/requirements-assignee-drift.test.ts +154 -0
  255. package/src/requirements-comment-http.test.ts +174 -0
  256. package/src/requirements-completed-at-migration.test.ts +70 -0
  257. package/src/requirements-errors-mcp-http.test.ts +164 -0
  258. package/src/requirements-errors.ts +158 -0
  259. package/src/requirements-etag-http.test.ts +91 -0
  260. package/src/requirements-http.test.ts +709 -0
  261. package/src/requirements-last-event-http.test.ts +349 -0
  262. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  263. package/src/requirements-list-slim-http.test.ts +324 -0
  264. package/src/requirements-mcp.test.ts +180 -0
  265. package/src/requirements-migrate.ts +283 -0
  266. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  267. package/src/requirements-people-http.test.ts +114 -0
  268. package/src/requirements-people-mcp-http.test.ts +231 -0
  269. package/src/requirements-people.ts +196 -0
  270. package/src/requirements-priority-lowest.test.ts +114 -0
  271. package/src/requirements-projects-network-echo.test.ts +57 -0
  272. package/src/requirements-projects-parent-http.test.ts +123 -0
  273. package/src/requirements-search-http.test.ts +182 -0
  274. package/src/requirements-search.test.ts +32 -0
  275. package/src/requirements-search.ts +145 -0
  276. package/src/requirements-seq-http.test.ts +193 -0
  277. package/src/requirements-seq-migration.test.ts +63 -0
  278. package/src/requirements-start-date.test.ts +125 -0
  279. package/src/requirements-stats-http.test.ts +357 -0
  280. package/src/requirements-stats.ts +195 -0
  281. package/src/requirements-status-participants-http.test.ts +222 -0
  282. package/src/requirements-upgrade-e2e.test.ts +126 -0
  283. package/src/requirements-upgrade-migration.test.ts +98 -0
  284. package/src/requirements.ts +2205 -0
  285. package/src/resolve-port.test.ts +57 -0
  286. package/src/resolve-port.ts +44 -0
  287. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  288. package/src/rest-alias-network-fallback.test.ts +60 -0
  289. package/src/rest-alias-network-fallback.ts +65 -0
  290. package/src/rest-explicit-columns-http.test.ts +266 -0
  291. package/src/rest-identity.test.ts +130 -0
  292. package/src/rest-identity.ts +141 -0
  293. package/src/rest-projections.ts +72 -0
  294. package/src/rest-read-network-real-chain.test.ts +97 -0
  295. package/src/rest-write-network-resolution.test.ts +133 -0
  296. package/src/restart-readiness-http.test.ts +121 -0
  297. package/src/restricted-files.ts +76 -0
  298. package/src/retention-first-sweep-quiet.test.ts +31 -0
  299. package/src/retention.test.ts +100 -40
  300. package/src/retention.ts +423 -104
  301. package/src/route-callers-http.test.ts +120 -0
  302. package/src/route-timing.test.ts +218 -0
  303. package/src/route-timing.ts +262 -0
  304. package/src/rules-file-duplicate-alias.test.ts +234 -0
  305. package/src/rules-file-session-target.test.ts +207 -0
  306. package/src/rules-file-transport.test.ts +271 -0
  307. package/src/runtime-label.test.ts +22 -0
  308. package/src/runtime-label.ts +21 -0
  309. package/src/runtime-readiness.ts +90 -0
  310. package/src/schedule-agent-mcp-http.test.ts +486 -0
  311. package/src/schedule-agent.ts +252 -0
  312. package/src/schedule-starved.test.ts +92 -0
  313. package/src/schedule-starved.ts +114 -0
  314. package/src/scheduled-backoff-http.test.ts +203 -0
  315. package/src/scheduled-backoff.ts +64 -0
  316. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  317. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  318. package/src/scheduled-failure-code.test.ts +73 -0
  319. package/src/scheduled-failure-code.ts +105 -0
  320. package/src/scheduled-failures-http.test.ts +279 -0
  321. package/src/scheduled-failures.ts +425 -0
  322. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  323. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  324. package/src/scheduled-offline.test.ts +131 -0
  325. package/src/scheduled-offline.ts +66 -0
  326. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  327. package/src/scheduled-outcome-guidance.ts +9 -0
  328. package/src/scheduled-reply-unread-http.test.ts +212 -0
  329. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  330. package/src/scheduled-requirement-wake.ts +125 -0
  331. package/src/scheduled-run-terminal.test.ts +290 -0
  332. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  333. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  334. package/src/scheduled-stuck-http.test.ts +316 -0
  335. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  336. package/src/scheduled-stuck.ts +219 -0
  337. package/src/scheduled-tasks-http.test.ts +679 -0
  338. package/src/scheduled-tasks.ts +959 -0
  339. package/src/scheduled-work-outcome-http.test.ts +154 -0
  340. package/src/scheduled-work-outcome.ts +50 -0
  341. package/src/scoped-secrets.ts +167 -0
  342. package/src/secret-echo-negative-control.test.ts +118 -0
  343. package/src/send-dedup-request-id.test.ts +229 -0
  344. package/src/send-reply-agent-warning.test.ts +38 -38
  345. package/src/send-reply-alias-optional.test.ts +131 -0
  346. package/src/send-reply-attachments.test.ts +28 -7
  347. package/src/send_dedup.test.ts +54 -0
  348. package/src/send_dedup.ts +52 -6
  349. package/src/serve-error.test.ts +73 -0
  350. package/src/serve-error.ts +56 -0
  351. package/src/server.ts +4930 -377
  352. package/src/session-task-on-dispatch.ts +14 -0
  353. package/src/session-token-ownership-http.test.ts +122 -0
  354. package/src/shared/codex-inventory.ts +41 -0
  355. package/src/shared/daemon-provider-login.ts +31 -0
  356. package/src/shared/daemon-provider-snapshot.ts +52 -0
  357. package/src/shared/external-schedule-contract.ts +60 -0
  358. package/src/shared/node-name.test.ts +62 -0
  359. package/src/shared/node-name.ts +161 -0
  360. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  361. package/src/shared/provider-application.ts +29 -0
  362. package/src/shared/provider-collection.ts +14 -0
  363. package/src/shared/provider-initialization.ts +8 -0
  364. package/src/shared/reserved-env-drift.test.ts +10 -0
  365. package/src/shared/scoped-secret-contract.ts +5 -0
  366. package/src/shared/task-content-limit-drift.test.ts +28 -0
  367. package/src/shared/task-content-limit.ts +25 -0
  368. package/src/side-thread-command-transport.test.ts +312 -0
  369. package/src/side-thread-command-transport.ts +318 -0
  370. package/src/side-thread-http-integration.test.ts +233 -0
  371. package/src/side-thread-http.ts +504 -0
  372. package/src/side-thread-production.test.ts +72 -0
  373. package/src/side-thread-production.ts +118 -0
  374. package/src/side-thread.test.ts +1067 -0
  375. package/src/side-thread.ts +2499 -0
  376. package/src/skillhub-http.test.ts +144 -0
  377. package/src/sqlite-close-checkpoint.test.ts +78 -0
  378. package/src/start-node.test.ts +265 -0
  379. package/src/start-request-error-domain.test.ts +182 -0
  380. package/src/start-skill-error-domain.test.ts +122 -0
  381. package/src/stats-versions-http.test.ts +65 -0
  382. package/src/status-alias-filter-http.test.ts +106 -0
  383. package/src/status-alias-resolver-http.test.ts +163 -0
  384. package/src/status-alias-resolver.ts +19 -0
  385. package/src/status-node-id-filter-http.test.ts +161 -0
  386. package/src/status-read-cache-http.test.ts +229 -0
  387. package/src/status-read-cache.ts +129 -0
  388. package/src/stop-delete-node.test.ts +567 -1
  389. package/src/task-access-http.test.ts +407 -0
  390. package/src/task-access.ts +420 -0
  391. package/src/task-activity.ts +60 -0
  392. package/src/task-auth-origin-http.test.ts +93 -0
  393. package/src/task-auth-origin.test.ts +24 -0
  394. package/src/task-auth-origin.ts +7 -0
  395. package/src/task-consumption.test.ts +508 -0
  396. package/src/task-diagnostic-http.test.ts +149 -0
  397. package/src/task-diagnostic.test.ts +115 -0
  398. package/src/task-diagnostic.ts +118 -0
  399. package/src/task-expiry-notice-http.test.ts +298 -0
  400. package/src/task-expiry-notice.ts +318 -0
  401. package/src/task-idempotency-mcp.test.ts +148 -0
  402. package/src/task-idempotency.test.ts +76 -0
  403. package/src/task-idempotency.ts +81 -0
  404. package/src/task-late-replies.ts +54 -0
  405. package/src/task-late-reply-http.test.ts +227 -0
  406. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  407. package/src/task-lifecycle-watcher.test.ts +209 -0
  408. package/src/task-lifecycle-watcher.ts +109 -0
  409. package/src/task-network-resolution-http.test.ts +140 -0
  410. package/src/task-not-found-error-domain.test.ts +114 -0
  411. package/src/task-offline-delivery-2668.test.ts +119 -0
  412. package/src/task-offline-delivery.ts +81 -0
  413. package/src/task-orphan-http.test.ts +287 -0
  414. package/src/task-orphan.ts +119 -0
  415. package/src/task-queue-ahead-http.test.ts +309 -0
  416. package/src/task-queue-ahead-scale.test.ts +236 -0
  417. package/src/task-queue-ahead.ts +186 -0
  418. package/src/task-rejection-log-http.test.ts +160 -0
  419. package/src/task-rejection-log.ts +61 -0
  420. package/src/task-sender-http.test.ts +143 -0
  421. package/src/task-stale-open-http.test.ts +292 -0
  422. package/src/task-stale-open.ts +103 -0
  423. package/src/tasks-pagination-http.test.ts +141 -0
  424. package/src/team-rules-status-http.test.ts +90 -0
  425. package/src/team-rules-status.test.ts +59 -0
  426. package/src/team-rules-status.ts +72 -0
  427. package/src/tmux-allowlist.test.ts +48 -0
  428. package/src/tool-audience-http.test.ts +248 -0
  429. package/src/tool-audience.ts +127 -0
  430. package/src/tools-list-json-schema.test.ts +94 -0
  431. package/src/tools.ts +4314 -392
  432. package/src/update-node-config-error-domain.test.ts +107 -0
  433. package/src/uploads-http.test.ts +6 -4
  434. package/src/uploads.ts +23 -4
  435. package/src/user-avatar-http.test.ts +74 -0
  436. package/src/user-avatar-image.ts +160 -0
  437. package/src/user-avatar-migration.test.ts +25 -0
  438. package/src/user-avatar-upload-http.test.ts +353 -0
  439. package/src/user-inbox-by-agent-http.test.ts +189 -0
  440. package/src/user-inbox-netid-notnull.test.ts +122 -0
  441. package/src/user-inbox-read-http.test.ts +223 -0
  442. package/src/user-inbox-schema.test.ts +54 -0
  443. package/src/version-stats.test.ts +66 -0
  444. package/src/version-stats.ts +109 -0
@@ -0,0 +1,236 @@
1
+ // 任务状态「废弃」(abandoned)—— HTTP 集成测试(真实 Bun.serve,私有端口,临时库)。
2
+ // test2123 在真实 PostgreSQL 上原样再跑一遍(COMMHUB_TEST_PG_URL)。
3
+ //
4
+ // 废弃是关闭态(同 done):不算开着、不逾期、不发到期提醒、不记完成时间;改进 / 改出都记动态;能改回 pool / doing。
5
+ // 旧 App(desktop ≤ 0.2.220)把不认识的状态当 pool —— 所以没声明 `X-Anet-Accept-Columns: abandoned`
6
+ // (或 `accept_columns=abandoned`)的调用者看到的是 done;MCP 总是声明,看到真值。
7
+ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
8
+ import { mkdtempSync, rmSync } from "node:fs";
9
+ import { tmpdir } from "node:os";
10
+ import { join } from "node:path";
11
+
12
+ const DIR = mkdtempSync(join(tmpdir(), "anet-req-abandoned-"));
13
+ process.env.COMMHUB_DB ||= join(DIR, "hub.db");
14
+ process.env.COMMHUB_UPLOADS_DIR = join(DIR, "uploads");
15
+ process.env.HOST = "127.0.0.1";
16
+ for (const k of ["COMMHUB_DUE_REMINDER_TZ", "COMMHUB_DUE_OVERDUE_MAX_DAYS", "COMMHUB_DUE_REMINDER_NETWORKS", "COMMHUB_DUE_REMINDERS", "COMMHUB_DUE_REMINDERS_NETWORKS", "COMMHUB_DUE_REMINDERS_EXCLUDE_NETWORKS", "COMMHUB_DUE_REMINDERS_OWNERS"]) delete process.env[k];
17
+ const PW = "AbandonedPassw0rd!x";
18
+ const T0 = Date.UTC(2026, 9, 10, 2, 0, 0);
19
+ const DAY = 86_400_000;
20
+ const AWARE = { "X-Anet-Accept-Columns": "abandoned" };
21
+
22
+ let BASE = "";
23
+ let hub: any = null;
24
+ let NET = "";
25
+ let TOKEN = "";
26
+ let OWNER = "";
27
+ let db: any;
28
+ let due: typeof import("./requirement-due-reminders.js");
29
+
30
+ type R = { status: number; body: any };
31
+ async function send(method: string, path: string, payload?: unknown, headers: Record<string, string> = {}): Promise<R> {
32
+ const res = await fetch(`${BASE}${path}`, {
33
+ method,
34
+ headers: { Authorization: `Bearer ${TOKEN}`, "Content-Type": "application/json", ...headers },
35
+ body: payload === undefined ? undefined : JSON.stringify(payload),
36
+ }, 60_000);
37
+ const text = await res.text();
38
+ let body: any = null;
39
+ try { body = JSON.parse(text); } catch {}
40
+ return { status: res.status, body };
41
+ }
42
+ async function mcp(name: string, args: Record<string, unknown>): Promise<any> {
43
+ const res = await fetch(`${BASE}/mcp`, {
44
+ method: "POST",
45
+ headers: { Authorization: `Bearer ${TOKEN}`, "Content-Type": "application/json", Accept: "application/json, text/event-stream", "MCP-Protocol-Version": "2025-03-26" },
46
+ body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: { name, arguments: args } }),
47
+ }, 60_000);
48
+ const raw = await res.text();
49
+ const lines = raw.split("\n").filter(x => x.startsWith("data:"));
50
+ const payload = lines.length ? JSON.parse(lines.at(-1)!.slice(5).trim()) : JSON.parse(raw);
51
+ return JSON.parse(payload.result.content[0].text);
52
+ }
53
+ async function card(name: string, extra: Record<string, unknown> = {}): Promise<string> {
54
+ const r = await send("POST", "/api/requirements", { network_id: NET, name, owner: { kind: "user", id: OWNER }, ...extra });
55
+ expect(r.status).toBe(201);
56
+ return r.body.requirement.id as string;
57
+ }
58
+ const get = (id: string, headers: Record<string, string> = {}) => send("GET", `/api/requirements/${id}?network_id=${NET}`, undefined, headers);
59
+ const patch = (id: string, body: Record<string, unknown>, headers: Record<string, string> = {}) => send("PATCH", `/api/requirements/${id}?network_id=${NET}`, body, headers);
60
+ const list = (qs = "", headers: Record<string, string> = {}) => send("GET", `/api/requirements?network_id=${NET}${qs}`, undefined, headers);
61
+ const ids = (r: R) => (r.body.requirements as any[]).map(x => x.id);
62
+ const columnIn = (r: R, id: string) => (r.body.requirements as any[]).find(x => x.id === id)?.column;
63
+ const sentFor = (out: Array<{ requirement_id: string; kind: string }>, id: string) => out.filter(x => x.requirement_id === id).map(x => x.kind);
64
+ const columnEvents = async (id: string) => ((await send("GET", `/api/requirements/events?network_id=${NET}&requirement_id=${id}`, undefined, AWARE)).body.events as any[])
65
+ .filter(e => e.kind === "changed" && e.field === "column").map(e => [e.old, e.new]).reverse();
66
+
67
+ beforeAll(async () => {
68
+ ({ db } = await import("./db.js"));
69
+ const { register } = await import("./auth.js");
70
+ const r = register(`ab_owner_${Date.now()}`, PW);
71
+ expect(r.ok).toBe(true);
72
+ TOKEN = r.token!;
73
+ OWNER = r.user!.user_id;
74
+ NET = r.network_id!;
75
+ due = await import("./requirement-due-reminders.js");
76
+ const mod: any = await import("./server.js");
77
+ hub = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
78
+ BASE = `http://127.0.0.1:${hub.port}`;
79
+ due.runDueReminders({ now: T0 - 30 * DAY }); // 到期提醒基线(同 requirement-due-reminders-http.test.ts)
80
+ }, 30_000);
81
+
82
+ afterAll(() => {
83
+ try { hub?.stop?.(true); } catch {}
84
+ try { rmSync(DIR, { recursive: true, force: true }); } catch {}
85
+ });
86
+
87
+ describe("abandoned column", () => {
88
+ test("schema accepts abandoned; the legacy CHECK migration is idempotent (SQLite rebuild / PG constraint swap)", async () => {
89
+ const { migrateRequirementColumnCheck } = await import("./requirements-migrate.js");
90
+ if (db.dialect === "postgres") {
91
+ // 模拟旧 PG 库:换回旧约束,迁移后 abandoned 能写,再跑一次照样不报错。
92
+ db.exec("ALTER TABLE requirements DROP CONSTRAINT IF EXISTS requirements_column_name_check");
93
+ db.exec("ALTER TABLE requirements ADD CONSTRAINT requirements_column_name_check CHECK(column_name IN ('pool', 'doing', 'done'))");
94
+ expect(migrateRequirementColumnCheck(db).rebuilt).toBe(true);
95
+ // 已经认识 abandoned:不再动表(不是每次启动都删了重加)
96
+ expect(migrateRequirementColumnCheck(db).rebuilt).toBe(false);
97
+ // 加约束失败要响亮地失败,而且是一条语句:旧约束原样留着,不会落到「没约束」
98
+ db.exec("ALTER TABLE requirements DROP CONSTRAINT IF EXISTS requirements_column_name_check");
99
+ db.exec("ALTER TABLE requirements ADD CONSTRAINT requirements_column_name_check CHECK(column_name IN ('pool', 'doing', 'done', 'bogus'))");
100
+ db.run("INSERT INTO requirements (requirement_id, network_id, title, column_name) VALUES ('req_ab_bogus', ?1, 'bogus', 'bogus')", [NET]);
101
+ expect(() => migrateRequirementColumnCheck(db)).toThrow();
102
+ const def = (db.get("SELECT pg_get_constraintdef(c.oid) AS def FROM pg_constraint c JOIN pg_class t ON t.oid = c.conrelid WHERE t.relname = 'requirements' AND c.conname = 'requirements_column_name_check'") as any)?.def ?? "";
103
+ expect(def).toContain("'bogus'");
104
+ db.run("DELETE FROM requirements WHERE requirement_id = 'req_ab_bogus'");
105
+ expect(migrateRequirementColumnCheck(db).rebuilt).toBe(true);
106
+ } else {
107
+ expect(migrateRequirementColumnCheck(db).rebuilt).toBe(false);
108
+ }
109
+ const id = await card("ab-schema");
110
+ expect((await patch(id, { column: "abandoned" }, AWARE)).status).toBe(200);
111
+ expect((await patch(id, { column: "cancelled" }, AWARE)).body.error).toBe("invalid_column");
112
+ expect((await list()).body.capabilities).toContain("column_abandoned");
113
+ }, 60_000);
114
+
115
+ test("set and restore: events recorded each way, no completedAt, restorable to pool and doing", async () => {
116
+ const id = await card("ab-set");
117
+ const a = await patch(id, { column: "abandoned" }, AWARE);
118
+ expect(a.status).toBe(200);
119
+ expect(a.body.requirement.column).toBe("abandoned");
120
+ expect(a.body.requirement.completedAt).toBeNull();
121
+ expect((await patch(id, { column: "doing" }, AWARE)).body.requirement.column).toBe("doing");
122
+ expect((await patch(id, { column: "abandoned" }, AWARE)).body.requirement.column).toBe("abandoned");
123
+ expect((await patch(id, { column: "pool" }, AWARE)).body.requirement.column).toBe("pool");
124
+ expect(await columnEvents(id)).toEqual([["pool", "abandoned"], ["abandoned", "doing"], ["doing", "abandoned"], ["abandoned", "pool"]]);
125
+ // 直接建在废弃列(带声明)也行
126
+ const created = await send("POST", "/api/requirements", { network_id: NET, name: "ab-born", column: "abandoned" }, AWARE);
127
+ expect(created.body.requirement.column).toBe("abandoned");
128
+ }, 60_000);
129
+
130
+ test("closed like done: not overdue, no due reminder, not counted as open in stats; restoring reopens it", async () => {
131
+ // id:到期提醒用假时钟 T0(10-10),到期 10-07 = 逾期 3 天;old:列表的 overdue 筛选用真时钟,到期给一个早就过了的日子。
132
+ const id = await card("ab-overdue", { due: "2026-10-07", column: "doing" });
133
+ const old = await card("ab-overdue-list", { due: "2020-01-01", column: "doing" });
134
+ expect(ids(await list("&overdue=1"))).toContain(old);
135
+ await patch(id, { column: "abandoned" }, AWARE);
136
+ await patch(old, { column: "abandoned" }, AWARE);
137
+ expect(ids(await list("&overdue=1"))).not.toContain(old);
138
+ expect(ids(await list("&overdue=0"))).toContain(old);
139
+ expect(sentFor(due.runDueReminders({ now: T0 }), id)).toEqual([]);
140
+ const stats = (await send("GET", `/api/requirements/stats?network_id=${NET}`)).body.totals;
141
+ const raw = db.all("SELECT column_name FROM requirements WHERE network_id = ?1 AND COALESCE(archived, 0) = 0", NET) as any[];
142
+ const n = (c: string) => raw.filter(r => r.column_name === c).length;
143
+ expect(stats.doing).toBe(n("doing"));
144
+ expect(stats.pool).toBe(n("pool"));
145
+ expect(stats.abandoned).toBe(n("abandoned"));
146
+ expect(n("abandoned")).toBeGreaterThan(0);
147
+ // 子任务进度不把废弃的子任务算进去
148
+ const parent = await card("ab-parent");
149
+ const kid = await card("ab-kid", { parent_id: parent });
150
+ await card("ab-kid2", { parent_id: parent });
151
+ await patch(kid, { column: "abandoned" }, AWARE);
152
+ // 声明了:废弃的子需求不算进度;没声明(旧 App 把它当 done 列出来):算进总数、算作完成,和它看到的列表对得上
153
+ expect((await get(parent, AWARE)).body.requirement.children).toEqual({ total: 1, done: 0 });
154
+ expect((await get(parent)).body.requirement.children).toEqual({ total: 2, done: 1 });
155
+ expect(columnIn(await list("&parent_id=" + parent), kid)).toBe("done");
156
+ // 改回 doing:又逾期、又提醒
157
+ await patch(id, { column: "doing" }, AWARE);
158
+ await patch(old, { column: "doing" }, AWARE);
159
+ expect(ids(await list("&overdue=1"))).toContain(old);
160
+ expect(sentFor(due.runDueReminders({ now: T0 }), id)).toEqual(["overdue"]);
161
+ }, 60_000);
162
+
163
+ test("old clients (no declaration) see abandoned as done; their writes cannot un-abandon it by echo", async () => {
164
+ const id = await card("ab-legacy");
165
+ await patch(id, { column: "abandoned" }, AWARE);
166
+ expect((await get(id)).body.requirement.column).toBe("done");
167
+ expect((await get(id, AWARE)).body.requirement.column).toBe("abandoned");
168
+ expect((await send("GET", `/api/requirements/${id}?network_id=${NET}&accept_columns=abandoned`)).body.requirement.column).toBe("abandoned");
169
+ expect(columnIn(await list(), id)).toBe("done");
170
+ expect(columnIn(await list("&view=summary"), id)).toBe("done");
171
+ expect(columnIn(await list("", AWARE), id)).toBe("abandoned");
172
+ // 列表缓存按声明分开:同一个查询串,先旧后新,不串值
173
+ expect(columnIn(await list(), id)).toBe("done");
174
+ expect(columnIn(await list("", AWARE), id)).toBe("abandoned");
175
+ // 旧客户端按 done 筛:带上废弃的(它眼里就是 done)
176
+ expect(ids(await list("&status=done"))).toContain(id);
177
+ expect(ids(await list("&status=done", AWARE))).not.toContain(id);
178
+ expect(ids(await list("&status=abandoned", AWARE))).toContain(id);
179
+ // 旧客户端改别的字段 / 回传它看到的 done:仍是废弃;响应里仍是 done
180
+ const p1 = await patch(id, { priority: "high" });
181
+ expect(p1.body.requirement.column).toBe("done");
182
+ const p2 = await patch(id, { column: "done" });
183
+ expect(p2.body.requirement.column).toBe("done");
184
+ expect((await get(id, AWARE)).body.requirement.column).toBe("abandoned");
185
+ // 旧客户端明确改回 pool:照办
186
+ expect((await patch(id, { column: "pool" })).body.requirement.column).toBe("pool");
187
+ // 新客户端从 abandoned 改成 done:真的完成
188
+ await patch(id, { column: "abandoned" }, AWARE);
189
+ const done = await patch(id, { column: "done" }, AWARE);
190
+ expect(done.body.requirement.column).toBe("done");
191
+ expect(done.body.requirement.completedAt).not.toBeNull();
192
+ }, 60_000);
193
+
194
+ test("events and last_event: undeclared callers see the projected column; done ↔ abandoned disappears for them", async () => {
195
+ const id = await card("ab-events");
196
+ await patch(id, { column: "abandoned" }, AWARE);
197
+ await patch(id, { column: "done" }, AWARE);
198
+ await patch(id, { column: "abandoned" }, AWARE);
199
+ const evs = async (headers: Record<string, string> = {}) => ((await send("GET", `/api/requirements/events?network_id=${NET}&requirement_id=${id}`, undefined, headers)).body.events as any[])
200
+ .filter(e => e.kind === "changed" && e.field === "column").map(e => [e.old, e.new]).reverse();
201
+ expect(await evs(AWARE)).toEqual([["pool", "abandoned"], ["abandoned", "done"], ["done", "abandoned"]]);
202
+ expect(await evs()).toEqual([["pool", "done"]]);
203
+ const legacyRaw = JSON.stringify((await send("GET", `/api/requirements/events?network_id=${NET}`)).body.events);
204
+ expect(legacyRaw).not.toContain("abandoned");
205
+ // 每行的 last_event:最新一条是 done → abandoned,旧客户端那里投影后前后一样 → 不给字段 / 摘要
206
+ const legacyRow = (await list()).body.requirements.find((r: any) => r.id === id);
207
+ expect(legacyRow.last_event.field).toBeNull();
208
+ expect(legacyRow.last_event.summary).toBeUndefined();
209
+ const awareRow = (await list("", AWARE)).body.requirements.find((r: any) => r.id === id);
210
+ expect(awareRow.last_event).toMatchObject({ field: "column", summary: "done → abandoned" });
211
+ await patch(id, { column: "doing" }, AWARE);
212
+ const back = (await list()).body.requirements.find((r: any) => r.id === id);
213
+ expect(back.last_event).toMatchObject({ field: "column", summary: "done → doing" });
214
+ expect(JSON.stringify((await list()).body.requirements)).not.toContain("abandoned");
215
+ }, 60_000);
216
+
217
+ test("checklist toggle response is projected for undeclared callers", async () => {
218
+ const id = await card("ab-check", { checklist: [{ id: "c1", text: "one" }] });
219
+ await patch(id, { column: "abandoned" }, AWARE);
220
+ const legacy = await send("PATCH", `/api/requirements/${id}/checklist/c1?network_id=${NET}`, { done: true });
221
+ expect(legacy.status).toBe(200);
222
+ expect(legacy.body.requirement.column).toBe("done");
223
+ const aware = await send("PATCH", `/api/requirements/${id}/checklist/c1?network_id=${NET}`, { done: false }, AWARE);
224
+ expect(aware.body.requirement.column).toBe("abandoned");
225
+ }, 60_000);
226
+
227
+ test("MCP declares support: requirements_update / get / list carry the real value", async () => {
228
+ const id = await card("ab-mcp");
229
+ const up = await mcp("requirements_update", { id, network_id: NET, status: "abandoned" });
230
+ expect(up.requirement.column).toBe("abandoned");
231
+ expect((await mcp("requirements_get", { id, network_id: NET })).requirement.column).toBe("abandoned");
232
+ const l = await mcp("requirements_list", { network_id: NET, status: "abandoned" });
233
+ expect(l.requirements.map((x: any) => x.id)).toContain(id);
234
+ expect((await mcp("requirements_update", { id, network_id: NET, column: "doing" })).requirement.column).toBe("doing");
235
+ }, 60_000);
236
+ });
@@ -0,0 +1,154 @@
1
+ // 2026-10-31 —— #3270:`assignee` 是派生展示字段,但它有自己的旧写入路径,会停在旧值。
2
+ //
3
+ // 实测(ANet 项目 archived=0,1105 张):25 张与 owner/agent_owner 不一致,
4
+ // 其中 22 张「有 assignee 但既无 owner 也无 agent_owner」。
5
+ // 读的人看的是 assignee ⇒「有人负责」这句话可以比事实晚很久。
6
+ //
7
+ // 修法(读侧,引用优先):
8
+ // agent_owner(node alias) > owner(username) > 自由文本 assignee
9
+ // 判据:owner/agent_owner 是**写入时被校验过的引用**;assignee 是自由文本。
10
+ // 两者冲突时以引用为准;没有引用时保留自由文本(它可能是系统外的人,删掉等于丢信息)。
11
+ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
12
+ import { mkdtempSync, rmSync } from "node:fs";
13
+ import { tmpdir } from "node:os";
14
+ import { join } from "node:path";
15
+
16
+ const DIR = mkdtempSync(join(tmpdir(), "anet-assignee-"));
17
+ process.env.COMMHUB_DB ||= join(DIR, "hub.db");
18
+ process.env.COMMHUB_UPLOADS_DIR = join(DIR, "uploads");
19
+ process.env.HOST = "127.0.0.1";
20
+ for (const k of ["COMMHUB_DUE_REMINDER_TZ", "COMMHUB_DUE_OVERDUE_MAX_DAYS", "COMMHUB_DUE_REMINDER_NETWORKS", "COMMHUB_DUE_REMINDERS", "COMMHUB_DUE_REMINDERS_NETWORKS", "COMMHUB_DUE_REMINDERS_EXCLUDE_NETWORKS", "COMMHUB_DUE_REMINDERS_OWNERS"]) delete process.env[k];
21
+
22
+ const PW = "AssigneePassw0rd!x";
23
+ let BASE = "";
24
+ let hub: any = null;
25
+ let NET = "";
26
+ let TOKEN = "";
27
+ let USER_ID = "";
28
+ let db: any;
29
+
30
+ async function send(method: string, path: string, payload?: unknown): Promise<{ status: number; body: any }> {
31
+ const res = await fetch(`${BASE}${path}`, {
32
+ method,
33
+ headers: { Authorization: `Bearer ${TOKEN}`, "Content-Type": "application/json" },
34
+ body: payload === undefined ? undefined : JSON.stringify(payload),
35
+ });
36
+ const text = await res.text();
37
+ let body: any = null;
38
+ try { body = JSON.parse(text); } catch {}
39
+ return { status: res.status, body };
40
+ }
41
+
42
+ beforeAll(async () => {
43
+ db = (await import("./db.js")).db;
44
+ const { register } = await import("./auth.js");
45
+ const stamp = Date.now();
46
+ const reg = register(`asg_${stamp}`, PW);
47
+ expect(reg.ok).toBe(true);
48
+ TOKEN = reg.token!;
49
+ NET = reg.network_id!;
50
+ USER_ID = db.get<{ user_id: string }>("SELECT user_id FROM users WHERE username = ?1", `asg_${stamp}`)!.user_id;
51
+ // 一个可解析的 node(agent_owner 必须是本网络 node)
52
+ db.run(`INSERT OR REPLACE INTO nodes (node_id, node_name, network_id, alias, created_at, updated_at)
53
+ VALUES ('n_asg_probe', 'asg-probe', ?1, 'asg-probe', ?2, ?2)`, [NET, Date.now()]);
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
+ }, 60_000);
58
+
59
+ afterAll(() => { try { hub?.stop?.(); } catch {} rmSync(DIR, { recursive: true, force: true }); });
60
+
61
+ describe("assignee never contradicts a validated owner/agent_owner reference", () => {
62
+ test("陈旧自由文本被引用覆盖(agent_owner 优先 > owner > 文本)", async () => {
63
+ const { displayAssignee, refDisplayName } = await import("./requirements.js").catch(
64
+ () => ({ displayAssignee: null as any, refDisplayName: null as any })) as any;
65
+ if (typeof refDisplayName !== "function") throw new Error("refDisplayName 未导出");
66
+ if (typeof displayAssignee !== "function") {
67
+ // 函数未导出时的退路:直接验证读取路径(下面两条 HTTP 用例已经覆盖),
68
+ // 这里不静默通过 —— 明确记录「没有读数」的边界。
69
+ throw new Error("displayAssignee 未导出:本文件需要它导出才能做单元级断言(见 #3270)");
70
+ }
71
+ const row = {
72
+ assignee: "ANet基建",
73
+ owner_json: JSON.stringify({ kind: "user", username: "王工" }),
74
+ agent_owner_json: JSON.stringify({ kind: "node", id: "n_x", alias: "通信欧" }),
75
+ };
76
+ // 读侧:只回显存下来的自由文本(不从引用推导 —— 无法区分「没设过」与「显式清空」)
77
+ expect(displayAssignee({ assignee: "ANet基建" })).toBe("ANet基建");
78
+ expect(displayAssignee({ assignee: "" })).toBe("");
79
+ // 写侧回填用的名字解析:引用 → 人名(node 用 alias,user 用 username)
80
+ expect(refDisplayName(JSON.stringify({ kind: "node", id: "n_x", alias: "通信欧" }))).toBe("通信欧");
81
+ expect(refDisplayName(JSON.stringify({ kind: "user", username: "王工" }))).toBe("王工");
82
+ expect(refDisplayName("")).toBe("");
83
+ // 没有引用时保留自由文本(系统外的人,删掉等于丢信息)
84
+ expect(displayAssignee({ assignee: " 王工 ", owner_json: null, agent_owner_json: null })).toBe("王工");
85
+ // 全是空 ⇒ 空串,不是 "undefined"/"null"
86
+ expect(displayAssignee({ assignee: null, owner_json: null, agent_owner_json: null })).toBe("");
87
+ });
88
+
89
+ test("写侧对账:设 agent_owner 时旧 assignee 被回填为引用(不再累积分叉)", async () => {
90
+ const created = await send("POST", `/api/requirements?network_id=${NET}`, {
91
+ name: "assignee 写侧对账",
92
+ column: "pool",
93
+ assignee: "ANet基建", // 旧值(看起来有人、其实解析不到)
94
+ });
95
+ expect(created.status).toBe(201);
96
+ const id = created.body.requirement.id as string;
97
+ expect(created.body.requirement.assignee).toBe("ANet基建");
98
+
99
+ // 只改 agent_owner,不显式给 assignee ⇒ 回填为 node alias
100
+ const patched = await send("PATCH", `/api/requirements/${id}?network_id=${NET}`, {
101
+ agent_owner: { kind: "node", alias: "asg-probe" },
102
+ });
103
+ expect(patched.status).toBe(200);
104
+ expect(patched.body.requirement.assignee).toBe("asg-probe");
105
+
106
+ // 显式给 assignee 且**没有引用** ⇒ 自由文本就是唯一事实(系统外的人,例如「王工」)
107
+ const other = await send("POST", `/api/requirements?network_id=${NET}`, { name: "无引用的卡", column: "pool" });
108
+ expect(other.status).toBe(201);
109
+ const manual = await send("PATCH", `/api/requirements/${other.body.requirement.id}?network_id=${NET}`, { assignee: "王工" });
110
+ expect(manual.status).toBe(200);
111
+ expect(manual.body.requirement.assignee).toBe("王工");
112
+
113
+ // 2026-10-31 —— **双向可测**(外部复核 ④:
114
+ // 「改粒度维度 ⇒ 结果变(确实相关);改其它维度 ⇒ 结果不变(确实无关)。
115
+ // 只做前一向时,一个『什么都相关』的模型也能满足它。」)
116
+ // 第一向(相关)上面已经有了:改 agent_owner ⇒ assignee 跟着变。
117
+ // 这一向(无关):改一个**不相干**的字段(name),assignee 必须**不变**。
118
+ const renamed = await send("PATCH", `/api/requirements/${id}?network_id=${NET}`, { name: "改个名字而已" });
119
+ expect(renamed.status).toBe(200);
120
+ expect(renamed.body.requirement.name).toBe("改个名字而已");
121
+ expect(renamed.body.requirement.assignee).toBe("asg-probe"); // 与上面那条同一张卡
122
+
123
+ // 两者**同时存在**时,读侧以**显式自由文本**为准(既有契约:调用方给的 assignee 不被覆盖)。
124
+ // 漂移的修法在写侧:设引用而**没显式给** assignee 时回填 —— 上面那条已经证明了这一点。
125
+ const both = await send("PATCH", `/api/requirements/${id}?network_id=${NET}`, { assignee: "王工" });
126
+ expect(both.status).toBe(200);
127
+ expect(both.body.requirement.assignee).toBe("王工");
128
+ });
129
+ });
130
+
131
+ describe("#3277 — deleting a node clears the cards that referenced it", () => {
132
+ test("agent_owner 被置空、participants 被摘掉,卡本身保留", async () => {
133
+ const { clearNodeFromRequirements } = await import("./requirements.js");
134
+ const created = await send("POST", `/api/requirements?network_id=${NET}`, {
135
+ name: "引用一个即将被删的节点",
136
+ column: "pool",
137
+ agent_owner: { kind: "node", alias: "asg-probe" },
138
+ participants: [{ kind: "node", alias: "asg-probe" }],
139
+ });
140
+ expect(created.status).toBe(201);
141
+ const id = created.body.requirement.id as string;
142
+
143
+ const res = clearNodeFromRequirements("n_asg_probe");
144
+ expect(res.agentOwnerCleared).toBeGreaterThan(0);
145
+ expect(res.participantsTouched).toBeGreaterThan(0);
146
+
147
+ const after = await send("GET", `/api/requirements/${id}?network_id=${NET}`);
148
+ expect(after.status).toBe(200);
149
+ // 卡还在,但不再指向一个不存在的节点
150
+ expect(after.body.requirement.agent_owner ?? null).toBeNull();
151
+ const parts = after.body.requirement.participants ?? [];
152
+ expect(parts.some((p: any) => p?.kind === "node" && p?.id === "n_asg_probe")).toBe(false);
153
+ });
154
+ });
@@ -0,0 +1,174 @@
1
+ // #474(MCP 任务生命周期测试报告问题 5)—— 评论 / 进展:只追加,进「动态」(requirement_events kind=comment),
2
+ // 不改任务本身。钉住:
3
+ // - Agent(节点令牌)经 MCP、人经 REST 都能评论,署名是调用者;description / updated_at 一个字节都不动;
4
+ // - requirements_events 里是 kind=comment、new.text 全文,单任务的动态体积可控;
5
+ // - 看不见这张卡的人评论 = 404(和读一样),只读角色 = 403,空 / 超长 = 400 + 提示;
6
+ // - 只追加:没有改 / 删评论的路由。
7
+ import { describe, expect, test, beforeAll, afterAll } from "bun:test";
8
+ import { mkdtempSync, rmSync } from "fs";
9
+ import { join } from "path";
10
+ import { tmpdir } from "os";
11
+ import { register, createNetworkTokenForNode } from "./auth.js";
12
+ import { db } from "./db.js";
13
+ import { COMMENT_MAX_CHARS } from "./requirements.js";
14
+
15
+ const DIR = mkdtempSync(join(tmpdir(), "anet-req-comment-"));
16
+ let BASE = "";
17
+ let hub: any = null;
18
+ const PW = "ReqCommentPassw0rd!xyz";
19
+ let NET = "";
20
+ const U: Record<string, { token: string; id: string }> = {};
21
+ let card = { id: "", seq: 0 };
22
+
23
+ async function rest(token: string, method: string, path: string, body?: unknown) {
24
+ const res = await fetch(`${BASE}${path}`, { method, headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" }, body: body === undefined ? undefined : JSON.stringify(body) });
25
+ const text = await res.text();
26
+ let json: any = null;
27
+ try { json = JSON.parse(text); } catch {}
28
+ return { status: res.status, body: json, bytes: text.length };
29
+ }
30
+ async function rpc(token: string, name: string, args: Record<string, unknown>): Promise<{ data: any; raw: any; bytes: number }> {
31
+ const res = await fetch(`${BASE}/mcp`, {
32
+ method: "POST",
33
+ headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json", Accept: "application/json, text/event-stream", "MCP-Protocol-Version": "2025-03-26" },
34
+ body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: { name, arguments: args } }),
35
+ });
36
+ const raw = await res.text();
37
+ const lines = raw.split("\n").filter(x => x.startsWith("data:"));
38
+ const out = lines.length ? JSON.parse(lines.at(-1)!.slice(5).trim()) : JSON.parse(raw);
39
+ const text = out.result?.content?.[0]?.text ?? "";
40
+ let data: any = null;
41
+ try { data = JSON.parse(text); } catch { data = text; }
42
+ return { data, raw: out, bytes: text.length };
43
+ }
44
+ const mcp = async (token: string, name: string, args: Record<string, unknown>) => (await rpc(token, name, args)).data;
45
+ const cardRow = (id: string) => db.get<{ description: string | null; updated_at: string | null; updated_by_json: string | null }>("SELECT description, updated_at, updated_by_json FROM requirements WHERE requirement_id = ?1", id)!;
46
+
47
+ beforeAll(async () => {
48
+ process.env.COMMHUB_DB ||= join(DIR, "hub.db");
49
+ process.env.COMMHUB_UPLOADS_DIR = join(DIR, "uploads");
50
+ process.env.HOST = "127.0.0.1";
51
+ const a = register(`cmt_owner_${Date.now()}`, PW, undefined, "Owner");
52
+ U.owner = { token: a.token!, id: a.user!.user_id };
53
+ NET = a.network_id!;
54
+ db.run("UPDATE users SET role = 'admin' WHERE user_id = ?1", [U.owner.id]);
55
+ const mod: any = await import("./server.js");
56
+ hub = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
57
+ BASE = `http://127.0.0.1:${hub.port}`;
58
+ const mk = async (username: string, role: string) => {
59
+ expect((await rest(U.owner.token, "POST", "/api/admin/users", { username, password: PW, network_id: NET, role })).status).toBe(200);
60
+ const login = await rest("", "POST", "/api/auth/login", { username, password: PW });
61
+ // #746 起新成员默认 scoped;这里的 member / viewer 模拟老成员('all'),scoped 那位下面再收窄。
62
+ expect((await rest(U.owner.token, "PUT", `/api/networks/${NET}/members/${login.body.user.user_id}/task-grants`, { task_access: "all" })).status).toBe(200);
63
+ return { token: login.body.token as string, id: login.body.user.user_id as string };
64
+ };
65
+ const stamp = Date.now();
66
+ U.member = await mk(`cmt_member_${stamp}`, "member");
67
+ U.viewer = await mk(`cmt_viewer_${stamp}`, "viewer");
68
+ U.scoped = await mk(`cmt_scoped_${stamp}`, "member");
69
+ expect((await rest(U.owner.token, "PUT", `/api/networks/${NET}/members/${U.scoped.id}/task-grants`, { task_access: "scoped", project_grants: [] })).status).toBe(200);
70
+ U.nodeA = { token: createNetworkTokenForNode(U.owner.id, NET, "示例-甲", "node_cmt_a").token!, id: "node_cmt_a" };
71
+ const created = (await mcp(U.nodeA.token, "requirements_create", { name: "示例任务:评论", description: "## 背景\n原文。" })).requirement;
72
+ card = { id: created.id, seq: created.seq };
73
+ }, 30_000);
74
+
75
+ afterAll(() => {
76
+ try { hub?.stop?.(true); } catch {}
77
+ try { rmSync(DIR, { recursive: true, force: true }); } catch {}
78
+ });
79
+
80
+ describe("requirements_comment", () => {
81
+ test("an Agent comments over MCP (#N): one comment event, attributed to the node; the task itself is untouched", async () => {
82
+ const before = cardRow(card.id);
83
+ const r = await mcp(U.nodeA.token, "requirements_comment", { id: `#${card.seq}`, text: "进展:示例草稿已写完,等人看。" });
84
+ expect(r.ok).toBe(true);
85
+ // 2026-10-31 —— #3275:requirements_comment 的形状(此前只有值断言)。
86
+ // 事件对象的键集由真实调用给出;`old`/`field` 对 comment 是**空占位**(注释不是字段改动),
87
+ // 但它们在键集里 ⇒ 客户端可以统一用「字段改动」的渲染器读注释事件。
88
+ expect(Object.keys(r).sort()).toEqual(["event", "ok"]);
89
+ expect(Object.keys(r.event).sort()).toEqual([
90
+ "actor", "at", "field", "id", "kind", "new", "old", "requirement_id", "seq", "title",
91
+ ]);
92
+ expect(r.event.kind).toBe("comment");
93
+ expect(r.event.field).toBeNull();
94
+ expect(r.event.new).toEqual({ text: "进展:示例草稿已写完,等人看。" });
95
+ expect(r.event.actor).toEqual({ kind: "node", id: "node_cmt_a" });
96
+ expect(r.event.requirement_id).toBe(card.id);
97
+ const after = cardRow(card.id);
98
+ expect(after).toEqual(before); // description, updated_at, updated_by all unchanged
99
+ });
100
+
101
+ test("a person comments over REST; both show in requirements_events with the full text, newest first", async () => {
102
+ const r = await rest(U.member.token, "POST", `/api/requirements/${card.id}/comments`, { text: " 好的,我下午看。 " });
103
+ expect(r.status).toBe(201);
104
+ expect(r.body.event.new.text).toBe("好的,我下午看。"); // trimmed
105
+ expect(r.body.event.actor).toEqual({ kind: "user", id: U.member.id });
106
+ const ev = await rpc(U.nodeA.token, "requirements_events", { requirement_id: `#${card.seq}` });
107
+ const comments = ev.data.events.filter((e: any) => e.kind === "comment");
108
+ expect(comments.map((e: any) => e.new.text)).toEqual(["好的,我下午看。", "进展:示例草稿已写完,等人看。"]);
109
+ expect(ev.data.events.at(-1).kind).toBe("created");
110
+ });
111
+
112
+ test("full text up to the cap, and the timeline stays small", async () => {
113
+ const long = "长".repeat(COMMENT_MAX_CHARS);
114
+ const r = await mcp(U.nodeA.token, "requirements_comment", { id: card.id, text: long });
115
+ expect(r.ok).toBe(true);
116
+ expect(r.event.new.text.length).toBe(COMMENT_MAX_CHARS);
117
+ const ev = await rpc(U.nodeA.token, "requirements_events", { requirement_id: card.id });
118
+ // 1 created + 3 comments (one of them 4000 chars): well under 20 KB.
119
+ expect(ev.bytes).toBeLessThan(20_000);
120
+ expect(ev.data.events.some((e: any) => e.kind === "comment" && e.new.text === long)).toBe(true);
121
+ });
122
+
123
+ test("bad input: empty → invalid_comment, over the cap → comment_too_long (REST), MCP schema → -32602; both with hints", async () => {
124
+ const empty = await rest(U.member.token, "POST", `/api/requirements/${card.id}/comments`, { text: " " });
125
+ expect(empty.status).toBe(400);
126
+ expect(empty.body.error).toBe("invalid_comment");
127
+ expect(empty.body.field).toBe("text");
128
+ const tooLong = await rest(U.member.token, "POST", `/api/requirements/${card.id}/comments`, { text: "x".repeat(COMMENT_MAX_CHARS + 1) });
129
+ expect(tooLong.status).toBe(400);
130
+ expect(tooLong.body.error).toBe("comment_too_long");
131
+ expect(tooLong.body.hint).toContain("Split");
132
+ const viaMcp = await rpc(U.nodeA.token, "requirements_comment", { id: card.id, text: "x".repeat(COMMENT_MAX_CHARS + 1) });
133
+ expect(String(viaMcp.raw.error?.code ?? viaMcp.raw.result?.content?.[0]?.text)).toMatch(/-32602|too big|Too big/i);
134
+ });
135
+
136
+ test("permissions: a non-reader gets 404 (like reading), a read-only role 403; neither writes anything", async () => {
137
+ const count = () => db.get<{ n: number }>("SELECT COUNT(*) AS n FROM requirement_events WHERE requirement_id = ?1 AND kind = 'comment'", card.id)!.n;
138
+ const n = count();
139
+ // scoped member with no grant cannot see the task → cannot read it → cannot comment on it.
140
+ expect((await rest(U.scoped.token, "GET", `/api/requirements/${card.id}`)).status).toBe(404);
141
+ const scoped = await rest(U.scoped.token, "POST", `/api/requirements/${card.id}/comments`, { text: "看不见也想评论" });
142
+ expect(scoped.status).toBe(404);
143
+ expect(scoped.body.error).toBe("requirement_not_found");
144
+ const viewer = await rest(U.viewer.token, "POST", `/api/requirements/${card.id}/comments`, { text: "只读角色" });
145
+ expect(viewer.status).toBe(403);
146
+ expect(viewer.body.error).toBe("permission_denied");
147
+ expect(count()).toBe(n);
148
+ // …and the scoped member does not see the comments in the network timeline either.
149
+ const ev = await rest(U.scoped.token, "GET", `/api/requirements/events?network_id=${NET}`);
150
+ expect((ev.body.events ?? []).some((e: any) => e.requirement_id === card.id)).toBe(false);
151
+ });
152
+
153
+ test("append-only: no route edits or deletes a comment; unknown task → requirement_not_found with a hint", async () => {
154
+ expect((await rest(U.owner.token, "PATCH", `/api/requirements/${card.id}/comments`, { text: "改" })).status).toBe(404);
155
+ expect((await rest(U.owner.token, "DELETE", `/api/requirements/${card.id}/comments`)).status).toBe(404);
156
+ const missing = await mcp(U.nodeA.token, "requirements_comment", { id: "#9999", text: "没有这张卡" });
157
+ expect(missing.error).toBe("requirement_not_found");
158
+ expect(missing.hint).toContain("requirements_list");
159
+ });
160
+
161
+ test("discoverable: tools/list carries requirements_comment, and requirements_events mentions comments", async () => {
162
+ const res = await fetch(`${BASE}/mcp`, {
163
+ method: "POST",
164
+ headers: { Authorization: `Bearer ${U.nodeA.token}`, "Content-Type": "application/json", Accept: "application/json, text/event-stream", "MCP-Protocol-Version": "2025-03-26" },
165
+ body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/list" }),
166
+ });
167
+ const raw = await res.text();
168
+ const lines = raw.split("\n").filter(x => x.startsWith("data:"));
169
+ const tools = (lines.length ? JSON.parse(lines.at(-1)!.slice(5).trim()) : JSON.parse(raw)).result.tools as any[];
170
+ const byName = new Map(tools.map(t => [t.name, t]));
171
+ expect(String(byName.get("requirements_comment")?.description)).toContain("append-only");
172
+ expect(String(byName.get("requirements_events")?.description)).toContain("kind=comment");
173
+ });
174
+ });
@@ -0,0 +1,70 @@
1
+ // 完成时间的启动迁移(requirements-migrate.ts ensureRequirementCompletedAt):用加完成时间之前的表结构建库、塞行,
2
+ // 再 import db.ts + requirements.ts(真实启动路径)。覆盖:两种旧时间形状、没有 updated_at 的行、
3
+ // 回滚到旧 Hub 期间「移出完成」留下的残值被清掉、「移进完成」的卡被补上,以及重复执行不再改任何东西。
4
+ import { afterAll, expect, test } from "bun:test";
5
+ import { Database } from "bun:sqlite";
6
+ import { mkdtempSync, rmSync } from "node:fs";
7
+ import { tmpdir } from "node:os";
8
+ import { join } from "node:path";
9
+
10
+ const dir = mkdtempSync(join(tmpdir(), "anet-req-completed-at-"));
11
+ const file = join(dir, "hub.db");
12
+ process.env.COMMHUB_DB = file;
13
+
14
+ const legacy = new Database(file);
15
+ legacy.exec(`CREATE TABLE requirements (
16
+ requirement_id TEXT PRIMARY KEY, network_id TEXT NOT NULL, title TEXT NOT NULL,
17
+ column_name TEXT NOT NULL DEFAULT 'pool' CHECK(column_name IN ('pool', 'doing', 'done')), priority TEXT NOT NULL DEFAULT 'normal', due_on TEXT, assignee TEXT,
18
+ client_id TEXT, issues_json TEXT, created_by TEXT,
19
+ created_at TEXT NOT NULL DEFAULT (datetime('now')), updated_at TEXT NOT NULL DEFAULT (datetime('now')),
20
+ owner_json TEXT, participants_json TEXT NOT NULL DEFAULT '[]', updated_by_json TEXT)`);
21
+ const seed: [string, string, string, string][] = [
22
+ // id, column, created_at, updated_at
23
+ ["r_done_sqlite_ts", "done", "2026-08-01 08:00:00", "2026-09-01 10:00:00"],
24
+ ["r_done_iso", "done", "2026-08-02T00:00:00.000Z", "2026-09-02T03:04:05.678Z"],
25
+ ["r_done_bad_updated", "done", "2026-08-03T00:00:00.000Z", "not a time"],
26
+ ["r_doing", "doing", "2026-08-04T00:00:00.000Z", "2026-09-04T00:00:00.000Z"],
27
+ ["r_pool", "pool", "2026-08-05T00:00:00.000Z", "2026-09-05T00:00:00.000Z"],
28
+ ];
29
+ for (const [id, column, createdAt, updatedAt] of seed) {
30
+ legacy.run("INSERT INTO requirements (requirement_id, network_id, title, column_name, created_at, updated_at, updated_by_json) VALUES (?1, 'net', ?1, ?2, ?3, ?4, ?5)",
31
+ [id, column, createdAt, updatedAt, JSON.stringify({ kind: "user", id: "u_last_editor" })]);
32
+ }
33
+ legacy.close();
34
+
35
+ afterAll(() => { try { rmSync(dir, { recursive: true, force: true }); } catch {} });
36
+
37
+ const read = (db: any) => Object.fromEntries((db.all("SELECT requirement_id, column_name, updated_at, completed_at, completed_by_json, completed_at_approx FROM requirements") as any[]).map(r => [r.requirement_id, r]));
38
+
39
+ test("backfill: done rows get an approximate ISO completed_at from updated_at; others stay empty; idempotent", async () => {
40
+ const { db } = await import("./db.js");
41
+ await import("./requirements.js");
42
+ const { ensureRequirementCompletedAt } = await import("./requirements-migrate.js");
43
+ const by = read(db);
44
+ expect(by.r_done_sqlite_ts.completed_at).toBe("2026-09-01T10:00:00.000Z");
45
+ expect(by.r_done_iso.completed_at).toBe("2026-09-02T03:04:05.678Z");
46
+ // updated_at 读不懂 → 退到 created_at,而不是留空(留空的完成卡在仪表盘上就「没完成过」)
47
+ expect(by.r_done_bad_updated.completed_at).toBe("2026-08-03T00:00:00.000Z");
48
+ for (const id of ["r_done_sqlite_ts", "r_done_iso", "r_done_bad_updated"]) {
49
+ expect(by[id].completed_at_approx).toBe(1);
50
+ // 最后改的人不是「完成的人」:近似值不猜完成者
51
+ expect(by[id].completed_by_json).toBeNull();
52
+ // 补值不碰 updated_at
53
+ expect(by[id].updated_at).toBe(seed.find(s => s[0] === id)![3]);
54
+ }
55
+ for (const id of ["r_doing", "r_pool"]) expect([by[id].completed_at, by[id].completed_by_json, by[id].completed_at_approx]).toEqual([null, null, 0]);
56
+
57
+ // 下次启动:什么都不动
58
+ expect(ensureRequirementCompletedAt(db)).toEqual({ backfilled: 0, cleared: 0 });
59
+ expect(read(db)).toEqual(by);
60
+
61
+ // 回滚到旧 Hub 期间:旧 Hub 不认识这三列 —— 把一张完成的卡移出(列留着旧值)、把一张卡移进完成(列是空的)。
62
+ db.run("UPDATE requirements SET column_name = 'doing' WHERE requirement_id = 'r_done_iso'");
63
+ db.run("UPDATE requirements SET column_name = 'done', updated_at = '2026-09-06T00:00:00.000Z' WHERE requirement_id = 'r_pool'");
64
+ expect(ensureRequirementCompletedAt(db)).toEqual({ backfilled: 1, cleared: 1 });
65
+ const after = read(db);
66
+ expect([after.r_done_iso.completed_at, after.r_done_iso.completed_by_json, after.r_done_iso.completed_at_approx]).toEqual([null, null, 0]);
67
+ expect([after.r_pool.completed_at, after.r_pool.completed_at_approx]).toEqual(["2026-09-06T00:00:00.000Z", 1]);
68
+ expect(after.r_done_sqlite_ts).toEqual(by.r_done_sqlite_ts);
69
+ expect(ensureRequirementCompletedAt(db)).toEqual({ backfilled: 0, cleared: 0 });
70
+ });