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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (482) hide show
  1. package/README.md +120 -3
  2. package/bin/commhub.ts +93 -9
  3. package/build-info.json +7 -0
  4. package/package.json +10 -8
  5. package/src/ack-create-request-transport.test.ts +182 -0
  6. package/src/ack-create-request.test.ts +52 -8
  7. package/src/admin-delete-network-http.test.ts +229 -0
  8. package/src/admin-networks-http.test.ts +88 -0
  9. package/src/adoption-candidates-http.test.ts +140 -0
  10. package/src/adoption-candidates.ts +158 -0
  11. package/src/agent-access-batch.test.ts +215 -0
  12. package/src/agent-access.ts +585 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +691 -0
  15. package/src/agent-acl-slice3-http.test.ts +888 -0
  16. package/src/agent-department-grants.test.ts +129 -0
  17. package/src/agent-department-http.test.ts +215 -0
  18. package/src/agent-groups-perf.test.ts +228 -0
  19. package/src/agent-notice.ts +48 -0
  20. package/src/agent-team-whoami-http.test.ts +98 -0
  21. package/src/agent-teams-http.test.ts +330 -0
  22. package/src/agent-teams.ts +244 -0
  23. package/src/alias-baseline-2571.test.ts +162 -0
  24. package/src/alias-baseline.ts +113 -0
  25. package/src/alias-filter.test.ts +72 -0
  26. package/src/alias-filter.ts +42 -0
  27. package/src/all-status-cache.test.ts +31 -0
  28. package/src/all-status-cache.ts +37 -0
  29. package/src/anet-variant-real-daemon-http.test.ts +185 -0
  30. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  31. package/src/api-host-supervisors-fallback.test.ts +6 -7
  32. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  33. package/src/api-nodes-shape.test.ts +131 -4
  34. package/src/auth-abuse-counters.test.ts +144 -0
  35. package/src/auth-abuse-counters.ts +122 -0
  36. package/src/auth-layer-shape.test.ts +105 -0
  37. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  38. package/src/auth-sessions-http.test.ts +260 -0
  39. package/src/auth-validate.test.ts +5 -1
  40. package/src/auth-weak-password-login.test.ts +176 -0
  41. package/src/auth.ts +641 -68
  42. package/src/backfill-node-ids-2664.test.ts +128 -0
  43. package/src/binding-generation-http.test.ts +141 -0
  44. package/src/blocked-exit-on-reply.test.ts +122 -0
  45. package/src/broadcast-fanout-2721.test.ts +149 -0
  46. package/src/broadcast-fanout.ts +117 -0
  47. package/src/build-commit-report-http.test.ts +219 -0
  48. package/src/build-info.test.ts +60 -0
  49. package/src/build-info.ts +85 -0
  50. package/src/chain-attempt-dedup.test.ts +447 -0
  51. package/src/clip.test.ts +36 -0
  52. package/src/clip.ts +48 -0
  53. package/src/clone-node.test.ts +269 -0
  54. package/src/clone-node.ts +289 -0
  55. package/src/codex-config-flags.ts +77 -0
  56. package/src/codex-fork-contract.ts +23 -0
  57. package/src/codex-fork-migration.test.ts +38 -0
  58. package/src/commhub-bin-args.test.ts +85 -0
  59. package/src/config-apply-sec1.test.ts +37 -0
  60. package/src/config-apply-validate.test.ts +188 -1
  61. package/src/config-apply-validate.ts +226 -3
  62. package/src/contracts/session-project-create.ts +14 -0
  63. package/src/contracts/session-source-delivery.ts +16 -0
  64. package/src/contracts/session-source-directory.ts +54 -0
  65. package/src/contracts/session-source-evidence.ts +72 -0
  66. package/src/contracts/session-source-execution.ts +24 -0
  67. package/src/contracts/session-source-transport.ts +18 -0
  68. package/src/cors-origins.test.ts +73 -0
  69. package/src/create-node-blocked-gate.test.ts +365 -0
  70. package/src/create-node-error-domain.test.ts +127 -0
  71. package/src/create-node-network-id.test.ts +91 -0
  72. package/src/create-node-tool-schema.test.ts +59 -0
  73. package/src/create-node-unicode-name.test.ts +126 -0
  74. package/src/create-node-validate.test.ts +199 -7
  75. package/src/create-node-validate.ts +232 -15
  76. package/src/create-node-workdir.test.ts +298 -0
  77. package/src/create-node.ts +88 -23
  78. package/src/daemon-provider-snapshots.test.ts +453 -0
  79. package/src/daemon-provider-snapshots.ts +327 -0
  80. package/src/daemon-token-owner-http.test.ts +346 -0
  81. package/src/dashboard-slash-routing-http.test.ts +109 -0
  82. package/src/db-adapter-guard.test.ts +148 -0
  83. package/src/db-adapter-translate.test.ts +128 -0
  84. package/src/db-adapter.ts +377 -91
  85. package/src/db-timestamp.test.ts +38 -0
  86. package/src/db-timestamp.ts +15 -0
  87. package/src/db.ts +1334 -154
  88. package/src/delivered-without-push.test.ts +140 -0
  89. package/src/department-groups-http.test.ts +209 -0
  90. package/src/department-groups-sync-http.test.ts +328 -0
  91. package/src/department-groups.ts +434 -0
  92. package/src/department-heads-http.test.ts +350 -0
  93. package/src/department-heads.ts +226 -0
  94. package/src/departments-agent-count.test.ts +139 -0
  95. package/src/departments-http.test.ts +185 -0
  96. package/src/departments-mcp-error-domain.test.ts +135 -0
  97. package/src/departments-mcp.test.ts +128 -0
  98. package/src/departments.ts +318 -0
  99. package/src/desktop-message-seam.test.ts +150 -0
  100. package/src/desktop-message.test.ts +368 -0
  101. package/src/dm-file-scope-http.test.ts +227 -0
  102. package/src/empty-node-sweeper.test.ts +104 -0
  103. package/src/empty-node-sweeper.ts +88 -0
  104. package/src/env-transport-gate-http.test.ts +240 -0
  105. package/src/env-transport-gate.ts +80 -0
  106. package/src/env-transport-policy.ts +56 -0
  107. package/src/etag-of.test.ts +57 -0
  108. package/src/event-loop-lag.test.ts +180 -0
  109. package/src/event-loop-lag.ts +201 -0
  110. package/src/expiry-counters.test.ts +187 -0
  111. package/src/expiry-counters.ts +227 -0
  112. package/src/expiry-evidence-db.test.ts +103 -0
  113. package/src/ext-token-shared.test.ts +60 -0
  114. package/src/ext-validation-regression.test.ts +10 -17
  115. package/src/external-schedule-edits-http.test.ts +321 -0
  116. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  117. package/src/external-schedule-edits.ts +327 -0
  118. package/src/file-download-authz-dev-open.test.ts +1 -1
  119. package/src/file-download-authz.test.ts +25 -4
  120. package/src/file-download-date-bucket.test.ts +1 -1
  121. package/src/file-network-scope-dev-open.test.ts +1 -1
  122. package/src/file-network-scope.test.ts +7 -6
  123. package/src/group-membership-events-http.test.ts +264 -0
  124. package/src/group-messages-http.test.ts +483 -0
  125. package/src/group-messages.ts +297 -0
  126. package/src/health-anon-readers.ts +67 -0
  127. package/src/health-host-disk-2756.test.ts +71 -0
  128. package/src/health-identity-root.test.ts +98 -0
  129. package/src/health-redaction.test.ts +1603 -7
  130. package/src/health-status-reasons.test.ts +84 -0
  131. package/src/host-supervisor-identity-http.test.ts +152 -0
  132. package/src/host-supervisor-identity.ts +92 -0
  133. package/src/host-supervisors-daemon-version.test.ts +137 -0
  134. package/src/http-gzip.test.ts +94 -0
  135. package/src/http-gzip.ts +112 -0
  136. package/src/hub-catalog-read-http.test.ts +664 -0
  137. package/src/hub-provider-config.test.ts +166 -0
  138. package/src/hub-provider-config.ts +202 -0
  139. package/src/hub-timestamp.test.ts +38 -0
  140. package/src/hub-timestamp.ts +27 -0
  141. package/src/human-dm.ts +215 -0
  142. package/src/human-inbox.ts +42 -0
  143. package/src/inbox-caller.ts +49 -0
  144. package/src/inbox-count-sse.test.ts +318 -0
  145. package/src/inbox-count.ts +29 -0
  146. package/src/index.ts +6 -2
  147. package/src/launched-by-cli-report-http.test.ts +155 -0
  148. package/src/license-state.test.ts +105 -0
  149. package/src/license-state.ts +48 -0
  150. package/src/lifecycle-error-domain.test.ts +149 -0
  151. package/src/list-ack-error-domain.test.ts +108 -0
  152. package/src/list-host-supervisors.test.ts +15 -4
  153. package/src/list-tasks-omit-default.test.ts +84 -0
  154. package/src/list-tasks-since-last.test.ts +100 -0
  155. package/src/list-tasks-since.test.ts +104 -0
  156. package/src/mcp-context-cost-http.test.ts +127 -0
  157. package/src/mcp-inflight.test.ts +92 -0
  158. package/src/mcp-inflight.ts +38 -0
  159. package/src/mcp-projects-events-http.test.ts +168 -0
  160. package/src/mcp-route-label-http.test.ts +120 -0
  161. package/src/mcp-write-network-resolution.test.ts +21 -0
  162. package/src/member-audit-network-id-http.test.ts +93 -0
  163. package/src/member-presence-http.test.ts +210 -0
  164. package/src/messages-ack-by-agent-http.test.ts +142 -0
  165. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  166. package/src/migrate-sqlite-to-pg.ts +263 -0
  167. package/src/model-auth-notify-http.test.ts +181 -0
  168. package/src/model-auth-notify.ts +116 -0
  169. package/src/network-name-http.test.ts +75 -0
  170. package/src/network-quota-config.test.ts +100 -0
  171. package/src/network-rules-http.test.ts +169 -0
  172. package/src/network-rules.ts +129 -0
  173. package/src/network-scope.ts +222 -3
  174. package/src/network-token-membership-http.test.ts +186 -0
  175. package/src/node-alias-control.ts +12 -0
  176. package/src/node-attrs.test.ts +47 -2
  177. package/src/node-caller-identity-http.test.ts +1108 -0
  178. package/src/node-config-last-update.test.ts +126 -0
  179. package/src/node-config-last-update.ts +107 -0
  180. package/src/node-create-request-status-http.test.ts +105 -0
  181. package/src/node-daemon-bindings.test.ts +142 -0
  182. package/src/node-daemon-bindings.ts +135 -0
  183. package/src/node-failure-alert.test.ts +150 -0
  184. package/src/node-failure-alert.ts +177 -0
  185. package/src/node-files-transport.test.ts +350 -0
  186. package/src/node-health-codex-login.test.ts +120 -0
  187. package/src/node-health-dispatch-http.test.ts +373 -0
  188. package/src/node-health-guard-origin.test.ts +98 -0
  189. package/src/node-health-guard.ts +121 -0
  190. package/src/node-health-passthrough.test.ts +115 -0
  191. package/src/node-health-store.ts +101 -0
  192. package/src/node-id-alias.test.ts +190 -0
  193. package/src/node-identity-conflict-http.test.ts +269 -0
  194. package/src/node-identity-conflict.ts +142 -0
  195. package/src/node-identity-mismatch.test.ts +74 -0
  196. package/src/node-in-flight-tasks.ts +31 -0
  197. package/src/node-inbox-allowlist-http.test.ts +320 -0
  198. package/src/node-lifecycle-controllable.test.ts +64 -0
  199. package/src/node-lifecycle-controllable.ts +53 -0
  200. package/src/node-lifecycle-read-http.test.ts +257 -0
  201. package/src/node-lifecycle-read.ts +126 -0
  202. package/src/node-logs-transport.test.ts +266 -0
  203. package/src/node-peer-allowlist.test.ts +114 -0
  204. package/src/node-permissions-http.test.ts +901 -0
  205. package/src/node-permissions.ts +627 -0
  206. package/src/node-request-retention.test.ts +281 -0
  207. package/src/node-request-retention.ts +120 -0
  208. package/src/node-secret-rest-http.test.ts +190 -0
  209. package/src/node-secret-vault-inject.test.ts +132 -0
  210. package/src/node-security-write-gate.test.ts +72 -0
  211. package/src/node-serviceability.test.ts +86 -0
  212. package/src/node-serviceability.ts +124 -0
  213. package/src/node-session-control-http.test.ts +398 -0
  214. package/src/node-session-control.ts +316 -0
  215. package/src/node-skills-transport.test.ts +212 -0
  216. package/src/node-token-identity.ts +35 -0
  217. package/src/node-token-ownership.ts +51 -0
  218. package/src/node-token-privilege-http.test.ts +224 -0
  219. package/src/node-token-usage.test.ts +128 -0
  220. package/src/node-token-usage.ts +228 -0
  221. package/src/not-found-api-http.test.ts +67 -0
  222. package/src/observer-avatar-http.test.ts +103 -10
  223. package/src/observer-push.test.ts +76 -0
  224. package/src/opencode-catalog-report-http.test.ts +139 -0
  225. package/src/opencode-v2-catalog.test.ts +282 -0
  226. package/src/opencode-v2-catalog.ts +357 -0
  227. package/src/package-self-contained.test.ts +32 -0
  228. package/src/package-version-consistency.test.ts +25 -0
  229. package/src/parent-infer.test.ts +82 -0
  230. package/src/parent-infer.ts +110 -0
  231. package/src/parent-source-marker.test.ts +70 -0
  232. package/src/parent-source-orphan.test.ts +121 -0
  233. package/src/password-network-tokens.ts +25 -0
  234. package/src/peer-reply-atomic.test.ts +462 -0
  235. package/src/peer-reply-capability.test.ts +70 -0
  236. package/src/pg-worker.ts +87 -0
  237. package/src/poll-pacing.test.ts +74 -0
  238. package/src/poll-pacing.ts +123 -0
  239. package/src/probe-provider-error-domain.test.ts +145 -0
  240. package/src/project-dir-warn-clear-http.test.ts +132 -0
  241. package/src/project-viewer-can-http.test.ts +116 -0
  242. package/src/provider-skill-error-domain.test.ts +130 -0
  243. package/src/provider-tools-shape.test.ts +165 -0
  244. package/src/push.test.ts +20 -10
  245. package/src/push.ts +373 -9
  246. package/src/redact-tokens.test.ts +86 -0
  247. package/src/redact-tokens.ts +43 -0
  248. package/src/rejection-counters.test.ts +72 -0
  249. package/src/rejection-counters.ts +173 -0
  250. package/src/rename.ts +38 -10
  251. package/src/reply-target-derivation.test.ts +96 -0
  252. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  253. package/src/report-status-host-schema.test.ts +272 -0
  254. package/src/report-status-resume-id-handover.test.ts +184 -0
  255. package/src/report-status-secret-keys.test.ts +140 -0
  256. package/src/require-explicit-test-db.ts +9 -0
  257. package/src/requirement-due-reminders-http.test.ts +620 -0
  258. package/src/requirement-due-reminders.ts +416 -0
  259. package/src/requirement-events-http.test.ts +318 -0
  260. package/src/requirement-events.test.ts +45 -0
  261. package/src/requirement-events.ts +144 -0
  262. package/src/requirement-notify.ts +165 -0
  263. package/src/requirement-participant-notify-http.test.ts +313 -0
  264. package/src/requirement-tag-ops-http.test.ts +454 -0
  265. package/src/requirement-tag-tree-http.test.ts +275 -0
  266. package/src/requirement-tag-tree.ts +127 -0
  267. package/src/requirement-tags.ts +102 -0
  268. package/src/requirements-abandoned-http.test.ts +236 -0
  269. package/src/requirements-assignee-drift.test.ts +154 -0
  270. package/src/requirements-comment-http.test.ts +174 -0
  271. package/src/requirements-completed-at-migration.test.ts +70 -0
  272. package/src/requirements-errors-mcp-http.test.ts +164 -0
  273. package/src/requirements-errors.ts +158 -0
  274. package/src/requirements-etag-http.test.ts +91 -0
  275. package/src/requirements-http.test.ts +709 -0
  276. package/src/requirements-last-event-http.test.ts +349 -0
  277. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  278. package/src/requirements-list-slim-http.test.ts +324 -0
  279. package/src/requirements-mcp.test.ts +180 -0
  280. package/src/requirements-migrate.ts +283 -0
  281. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  282. package/src/requirements-people-http.test.ts +114 -0
  283. package/src/requirements-people-mcp-http.test.ts +231 -0
  284. package/src/requirements-people.ts +196 -0
  285. package/src/requirements-priority-lowest.test.ts +114 -0
  286. package/src/requirements-projects-network-echo.test.ts +57 -0
  287. package/src/requirements-projects-parent-http.test.ts +123 -0
  288. package/src/requirements-search-http.test.ts +182 -0
  289. package/src/requirements-search.test.ts +32 -0
  290. package/src/requirements-search.ts +145 -0
  291. package/src/requirements-seq-http.test.ts +193 -0
  292. package/src/requirements-seq-migration.test.ts +63 -0
  293. package/src/requirements-start-date.test.ts +125 -0
  294. package/src/requirements-stats-http.test.ts +357 -0
  295. package/src/requirements-stats.ts +195 -0
  296. package/src/requirements-status-participants-http.test.ts +222 -0
  297. package/src/requirements-upgrade-e2e.test.ts +126 -0
  298. package/src/requirements-upgrade-migration.test.ts +98 -0
  299. package/src/requirements.ts +2205 -0
  300. package/src/resolve-port.test.ts +57 -0
  301. package/src/resolve-port.ts +44 -0
  302. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  303. package/src/rest-alias-network-fallback.test.ts +60 -0
  304. package/src/rest-alias-network-fallback.ts +65 -0
  305. package/src/rest-explicit-columns-http.test.ts +266 -0
  306. package/src/rest-identity.test.ts +130 -0
  307. package/src/rest-identity.ts +141 -0
  308. package/src/rest-projections.ts +72 -0
  309. package/src/rest-read-network-real-chain.test.ts +97 -0
  310. package/src/rest-write-network-resolution.test.ts +133 -0
  311. package/src/restart-readiness-http.test.ts +121 -0
  312. package/src/restricted-files.ts +76 -0
  313. package/src/retention-first-sweep-quiet.test.ts +31 -0
  314. package/src/retention.test.ts +100 -40
  315. package/src/retention.ts +423 -104
  316. package/src/route-callers-http.test.ts +120 -0
  317. package/src/route-timing.test.ts +218 -0
  318. package/src/route-timing.ts +262 -0
  319. package/src/rules-file-duplicate-alias.test.ts +234 -0
  320. package/src/rules-file-session-target.test.ts +207 -0
  321. package/src/rules-file-transport.test.ts +280 -0
  322. package/src/runtime-label.test.ts +22 -0
  323. package/src/runtime-label.ts +21 -0
  324. package/src/runtime-readiness.ts +90 -0
  325. package/src/schedule-agent-mcp-http.test.ts +486 -0
  326. package/src/schedule-agent.ts +252 -0
  327. package/src/schedule-starved.test.ts +92 -0
  328. package/src/schedule-starved.ts +114 -0
  329. package/src/scheduled-backoff-http.test.ts +203 -0
  330. package/src/scheduled-backoff.ts +64 -0
  331. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  332. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  333. package/src/scheduled-failure-code.test.ts +73 -0
  334. package/src/scheduled-failure-code.ts +105 -0
  335. package/src/scheduled-failures-http.test.ts +279 -0
  336. package/src/scheduled-failures.ts +425 -0
  337. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  338. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  339. package/src/scheduled-offline.test.ts +131 -0
  340. package/src/scheduled-offline.ts +66 -0
  341. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  342. package/src/scheduled-outcome-guidance.ts +9 -0
  343. package/src/scheduled-reply-unread-http.test.ts +212 -0
  344. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  345. package/src/scheduled-requirement-wake.ts +125 -0
  346. package/src/scheduled-run-terminal.test.ts +290 -0
  347. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  348. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  349. package/src/scheduled-stuck-http.test.ts +316 -0
  350. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  351. package/src/scheduled-stuck.ts +219 -0
  352. package/src/scheduled-tasks-http.test.ts +679 -0
  353. package/src/scheduled-tasks.ts +980 -0
  354. package/src/scheduled-work-outcome-http.test.ts +154 -0
  355. package/src/scheduled-work-outcome.ts +50 -0
  356. package/src/scoped-secrets.ts +167 -0
  357. package/src/secret-echo-negative-control.test.ts +118 -0
  358. package/src/send-dedup-request-id.test.ts +229 -0
  359. package/src/send-reply-agent-warning.test.ts +38 -38
  360. package/src/send-reply-alias-optional.test.ts +131 -0
  361. package/src/send-reply-attachments.test.ts +28 -7
  362. package/src/send_dedup.test.ts +54 -0
  363. package/src/send_dedup.ts +52 -6
  364. package/src/serve-error.test.ts +73 -0
  365. package/src/serve-error.ts +56 -0
  366. package/src/server.ts +5103 -377
  367. package/src/session-fork-store.test.ts +43 -0
  368. package/src/session-fork-store.ts +51 -0
  369. package/src/session-project-attach-migration.test.ts +23 -0
  370. package/src/session-project-attach-native.test.ts +123 -0
  371. package/src/session-project-create-http.test.ts +408 -0
  372. package/src/session-project-create-native.test.ts +292 -0
  373. package/src/session-project-create.ts +159 -0
  374. package/src/session-source-admission-store.ts +58 -0
  375. package/src/session-source-create.test.ts +155 -0
  376. package/src/session-source-create.ts +97 -0
  377. package/src/session-source-delivery.ts +114 -0
  378. package/src/session-source-directory-http.test.ts +196 -0
  379. package/src/session-source-evidence.test.ts +905 -0
  380. package/src/session-source-evidence.ts +191 -0
  381. package/src/session-source-execution.ts +87 -0
  382. package/src/session-source-grant.test.ts +117 -0
  383. package/src/session-source-grant.ts +78 -0
  384. package/src/session-source-issuer.test.ts +250 -0
  385. package/src/session-source-issuer.ts +164 -0
  386. package/src/session-source-transport.ts +381 -0
  387. package/src/session-task-on-dispatch.ts +14 -0
  388. package/src/session-token-ownership-http.test.ts +122 -0
  389. package/src/shared/codex-inventory.ts +41 -0
  390. package/src/shared/daemon-provider-login.ts +31 -0
  391. package/src/shared/daemon-provider-snapshot.ts +52 -0
  392. package/src/shared/external-schedule-contract.ts +60 -0
  393. package/src/shared/node-name.test.ts +62 -0
  394. package/src/shared/node-name.ts +161 -0
  395. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  396. package/src/shared/provider-application.ts +29 -0
  397. package/src/shared/provider-collection.ts +14 -0
  398. package/src/shared/provider-initialization.ts +8 -0
  399. package/src/shared/reserved-env-drift.test.ts +10 -0
  400. package/src/shared/scoped-secret-contract.ts +5 -0
  401. package/src/shared/task-content-limit-drift.test.ts +28 -0
  402. package/src/shared/task-content-limit.ts +25 -0
  403. package/src/side-thread-command-transport.test.ts +312 -0
  404. package/src/side-thread-command-transport.ts +318 -0
  405. package/src/side-thread-http-integration.test.ts +233 -0
  406. package/src/side-thread-http.ts +504 -0
  407. package/src/side-thread-production.test.ts +72 -0
  408. package/src/side-thread-production.ts +118 -0
  409. package/src/side-thread.test.ts +1067 -0
  410. package/src/side-thread.ts +2499 -0
  411. package/src/skillhub-http.test.ts +144 -0
  412. package/src/sqlite-close-checkpoint.test.ts +78 -0
  413. package/src/start-node.test.ts +265 -0
  414. package/src/start-request-error-domain.test.ts +182 -0
  415. package/src/start-skill-error-domain.test.ts +122 -0
  416. package/src/stats-versions-http.test.ts +65 -0
  417. package/src/status-alias-filter-http.test.ts +106 -0
  418. package/src/status-alias-resolver-http.test.ts +163 -0
  419. package/src/status-alias-resolver.ts +19 -0
  420. package/src/status-node-id-filter-http.test.ts +161 -0
  421. package/src/status-node-secrets-capable-http.test.ts +44 -0
  422. package/src/status-read-cache-http.test.ts +229 -0
  423. package/src/status-read-cache.ts +129 -0
  424. package/src/stop-delete-node.test.ts +567 -1
  425. package/src/task-access-http.test.ts +407 -0
  426. package/src/task-access.ts +420 -0
  427. package/src/task-activity.ts +60 -0
  428. package/src/task-auth-origin-http.test.ts +93 -0
  429. package/src/task-auth-origin.test.ts +24 -0
  430. package/src/task-auth-origin.ts +7 -0
  431. package/src/task-consumption.test.ts +512 -0
  432. package/src/task-diagnostic-http.test.ts +149 -0
  433. package/src/task-diagnostic.test.ts +115 -0
  434. package/src/task-diagnostic.ts +118 -0
  435. package/src/task-expiry-notice-http.test.ts +298 -0
  436. package/src/task-expiry-notice.ts +318 -0
  437. package/src/task-idempotency-mcp.test.ts +148 -0
  438. package/src/task-idempotency.test.ts +76 -0
  439. package/src/task-idempotency.ts +81 -0
  440. package/src/task-late-replies.ts +54 -0
  441. package/src/task-late-reply-http.test.ts +227 -0
  442. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  443. package/src/task-lifecycle-watcher.test.ts +209 -0
  444. package/src/task-lifecycle-watcher.ts +109 -0
  445. package/src/task-network-resolution-http.test.ts +140 -0
  446. package/src/task-not-found-error-domain.test.ts +117 -0
  447. package/src/task-offline-delivery-2668.test.ts +119 -0
  448. package/src/task-offline-delivery.ts +81 -0
  449. package/src/task-orphan-http.test.ts +287 -0
  450. package/src/task-orphan.ts +119 -0
  451. package/src/task-queue-ahead-http.test.ts +309 -0
  452. package/src/task-queue-ahead-scale.test.ts +236 -0
  453. package/src/task-queue-ahead.ts +186 -0
  454. package/src/task-rejection-log-http.test.ts +160 -0
  455. package/src/task-rejection-log.ts +61 -0
  456. package/src/task-sender-http.test.ts +143 -0
  457. package/src/task-stale-open-http.test.ts +292 -0
  458. package/src/task-stale-open.ts +103 -0
  459. package/src/tasks-pagination-http.test.ts +141 -0
  460. package/src/team-rules-status-http.test.ts +90 -0
  461. package/src/team-rules-status.test.ts +59 -0
  462. package/src/team-rules-status.ts +72 -0
  463. package/src/test-work-root.ts +18 -0
  464. package/src/tmux-allowlist.test.ts +48 -0
  465. package/src/token-usage-http.test.ts +156 -0
  466. package/src/tool-audience-http.test.ts +266 -0
  467. package/src/tool-audience.ts +130 -0
  468. package/src/tools-list-json-schema.test.ts +94 -0
  469. package/src/tools.ts +4557 -472
  470. package/src/update-node-config-error-domain.test.ts +107 -0
  471. package/src/uploads-http.test.ts +6 -4
  472. package/src/uploads.ts +23 -4
  473. package/src/user-avatar-http.test.ts +74 -0
  474. package/src/user-avatar-image.ts +160 -0
  475. package/src/user-avatar-migration.test.ts +25 -0
  476. package/src/user-avatar-upload-http.test.ts +353 -0
  477. package/src/user-inbox-by-agent-http.test.ts +189 -0
  478. package/src/user-inbox-netid-notnull.test.ts +122 -0
  479. package/src/user-inbox-read-http.test.ts +223 -0
  480. package/src/user-inbox-schema.test.ts +54 -0
  481. package/src/version-stats.test.ts +66 -0
  482. package/src/version-stats.ts +109 -0
@@ -0,0 +1,357 @@
1
+ // 完成时间 completed_at 与仪表盘聚合 GET /api/requirements/stats —— HTTP 集成测试(真实 Bun.serve,私有端口,临时库)。
2
+ // test2123 在真实 PostgreSQL 上原样再跑一遍(COMMHUB_TEST_PG_URL)。
3
+ //
4
+ // 场景:Hub 管理员 admin 的网络 NET;节点令牌 bot(绑定一个节点);成员:
5
+ // alice —— 新建成员(经授权接口显式设成任务 scoped、Agent 受限):只看得见自己负责的卡;
6
+ // carol —— 任务 'all'、Agent 受限('granted' 且没授权 bot):卡全看得见,但 bot 不该以名字出现在统计里。
7
+ // 正向:移进完成记时刻与操作者、完成列里改别的不动、移出清空、再移进换新时刻;直接建在完成列;归档的卡照样计数;
8
+ // tz / days / from / to 的语义。
9
+ // 反向:scoped 成员的统计不含他看不见的卡;受限成员看不到隐藏节点的 id(计入 unattributed);非法参数 400。
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
+ import { createNetworkTokenForNode, register } from "./auth.js";
16
+ import { db } from "./db.js";
17
+ import { isAgentRestricted } from "./agent-access.js";
18
+ import { localDate } from "./requirements-stats.js";
19
+
20
+ const DIR = mkdtempSync(join(tmpdir(), "anet-req-stats-"));
21
+ const PW = "ReqStatsPassw0rd!x";
22
+ let BASE = "";
23
+ let hub: any = null;
24
+ let NET = "";
25
+ let admin = { token: "", id: "" };
26
+ let alice = { token: "", id: "" };
27
+ let carol = { token: "", id: "" };
28
+ let bot = { token: "", nodeId: "" };
29
+ let PROJ = "";
30
+ const C: Record<string, string> = {};
31
+
32
+ type R = { status: number; body: any; text: string };
33
+ async function send(token: string, method: string, path: string, payload?: unknown): Promise<R> {
34
+ const res = await fetch(`${BASE}${path}`, {
35
+ method,
36
+ headers: { ...(token ? { Authorization: `Bearer ${token}` } : {}), "Content-Type": "application/json" },
37
+ body: payload === undefined ? undefined : JSON.stringify(payload),
38
+ });
39
+ const text = await res.text();
40
+ let body: any = null;
41
+ try { body = JSON.parse(text); } catch {}
42
+ return { status: res.status, body, text };
43
+ }
44
+ const card = async (token: string, name: string, extra: Record<string, unknown> = {}) => {
45
+ const r = await send(token, "POST", "/api/requirements", { network_id: NET, name, ...extra });
46
+ expect(r.status).toBe(201);
47
+ C[name] = r.body.requirement.id;
48
+ return r.body.requirement;
49
+ };
50
+ const patch = async (token: string, name: string, body: Record<string, unknown>) => {
51
+ const r = await send(token, "PATCH", `/api/requirements/${C[name]}?network_id=${NET}`, body);
52
+ expect(r.status).toBe(200);
53
+ return r.body.requirement;
54
+ };
55
+ const stats = (token: string, qs = "") => send(token, "GET", `/api/requirements/stats?network_id=${NET}${qs}`);
56
+ const tick = () => new Promise(r => setTimeout(r, 5));
57
+
58
+ beforeAll(async () => {
59
+ process.env.COMMHUB_DB ||= join(DIR, "hub.db");
60
+ process.env.COMMHUB_UPLOADS_DIR = join(DIR, "uploads");
61
+ process.env.HOST = "127.0.0.1";
62
+ const a = register(`rs_admin_${Date.now()}`, PW, undefined, "Admin");
63
+ expect(a.ok).toBe(true);
64
+ admin = { token: a.token!, id: a.user!.user_id };
65
+ NET = a.network_id!;
66
+ db.run("UPDATE users SET role = 'admin' WHERE user_id = ?1", [admin.id]);
67
+ const mod: any = await import("./server.js");
68
+ hub = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
69
+ BASE = `http://127.0.0.1:${hub.port}`;
70
+
71
+ const mk = async (username: string) => {
72
+ const r = await send(admin.token, "POST", "/api/admin/users", { username, password: PW, network_id: NET, role: "member" });
73
+ expect(r.status).toBe(200);
74
+ const login = await send("", "POST", "/api/auth/login", { username, password: PW });
75
+ expect(login.status).toBe(200);
76
+ return { token: login.body.token as string, id: login.body.user.user_id as string };
77
+ };
78
+ const stamp = Date.now();
79
+ alice = await mk(`rs_alice_${stamp}`);
80
+ carol = await mk(`rs_carol_${stamp}`);
81
+ // #746 起新成员默认就是 scoped;这里仍显式设一次,不依赖默认值。
82
+ expect((await send(admin.token, "PUT", `/api/networks/${NET}/members/${alice.id}/task-grants`, { task_access: "scoped" })).status).toBe(200);
83
+ db.run("UPDATE network_members SET task_access = 'all' WHERE network_id = ?1 AND user_id = ?2", [NET, carol.id]);
84
+
85
+ const t = createNetworkTokenForNode(admin.id, NET, "rs-bot");
86
+ expect(t.token).toBeTruthy();
87
+ bot.token = t.token!;
88
+
89
+ const p = await send(admin.token, "POST", "/api/requirements/projects", { network_id: NET, name: "rs-P" });
90
+ expect(p.status).toBe(201);
91
+ PROJ = p.body.project.id;
92
+ }, 30_000);
93
+
94
+ afterAll(() => {
95
+ try { hub?.stop?.(true); } catch {}
96
+ try { rmSync(DIR, { recursive: true, force: true }); } catch {}
97
+ });
98
+
99
+ describe("completed_at 随列变化", () => {
100
+ test("不在完成列的卡:completedAt = null,approx = false;capability 广播 completed_at / stats", async () => {
101
+ const r = await card(admin.token, "rs-pool");
102
+ expect(r.completedAt).toBeNull();
103
+ expect(r.completedBy).toBeNull();
104
+ expect(r.completedAtApprox).toBe(false);
105
+ await card(admin.token, "rs-doing", { column: "doing" });
106
+ const list = await send(admin.token, "GET", `/api/requirements?network_id=${NET}`);
107
+ expect(list.body.capabilities).toContain("completed_at");
108
+ expect(list.body.capabilities).toContain("stats");
109
+ });
110
+
111
+ test("直接建在完成列:completedAt = createdAt,completedBy = 建卡的人", async () => {
112
+ const r = await card(admin.token, "rs-born-done", { column: "done", project_id: PROJ });
113
+ expect(r.completedAt).toBe(r.createdAt);
114
+ expect(r.completedBy).toEqual({ kind: "user", id: admin.id });
115
+ expect(r.completedAtApprox).toBe(false);
116
+ });
117
+
118
+ test("移进完成记时刻;完成列里改名 / 勾子任务不动它;移出清空;再移进是新时刻", async () => {
119
+ await card(admin.token, "rs-move", { checklist: [{ id: "i1", text: "x", done: false }] });
120
+ expect((await patch(admin.token, "rs-move", { column: "doing" })).completedAt).toBeNull();
121
+ const done1 = await patch(admin.token, "rs-move", { column: "done" });
122
+ expect(done1.completedAt).toBe(done1.updatedAt);
123
+ expect(done1.completedBy).toEqual({ kind: "user", id: admin.id });
124
+ await tick();
125
+ const renamed = await patch(admin.token, "rs-move", { name: "rs-move 改名" });
126
+ expect(renamed.updatedAt).not.toBe(done1.updatedAt);
127
+ expect(renamed.completedAt).toBe(done1.completedAt);
128
+ const again = await patch(admin.token, "rs-move", { column: "done" }); // done → done
129
+ expect(again.completedAt).toBe(done1.completedAt);
130
+ const ck = await send(admin.token, "PATCH", `/api/requirements/${C["rs-move"]}/checklist/i1?network_id=${NET}`, { done: true });
131
+ expect(ck.status).toBe(200);
132
+ expect(ck.body.requirement.completedAt).toBe(done1.completedAt);
133
+ const out = await patch(admin.token, "rs-move", { column: "pool" });
134
+ expect(out.completedAt).toBeNull();
135
+ expect(out.completedBy).toBeNull();
136
+ await tick();
137
+ const done2 = await patch(admin.token, "rs-move", { column: "done" });
138
+ expect(done2.completedAt).not.toBeNull();
139
+ expect(Date.parse(done2.completedAt)).toBeGreaterThan(Date.parse(done1.completedAt));
140
+ });
141
+
142
+ test("节点令牌移进完成:completedBy 是那个节点", async () => {
143
+ await card(bot.token, "rs-bot-card");
144
+ const done = await patch(bot.token, "rs-bot-card", { column: "done" });
145
+ expect(done.completedBy?.kind).toBe("node");
146
+ bot.nodeId = done.completedBy.id;
147
+ expect(bot.nodeId).toBeTruthy();
148
+ });
149
+
150
+ test("alice 负责的卡由 alice 移进完成;归档一张完成的卡", async () => {
151
+ await card(admin.token, "rs-alice", { owner: { kind: "user", id: alice.id } });
152
+ const done = await patch(alice.token, "rs-alice", { column: "done" });
153
+ expect(done.completedBy).toEqual({ kind: "user", id: alice.id });
154
+ await card(admin.token, "rs-archived", { column: "done" });
155
+ const arch = await patch(admin.token, "rs-archived", { archived: true });
156
+ expect(arch.archived).toBe(true);
157
+ expect(arch.completedAt).not.toBeNull(); // 归档不是移出完成列
158
+ });
159
+ });
160
+
161
+ describe("GET /api/requirements/stats", () => {
162
+ // 此时:done = born-done / move / bot-card / alice / archived(5);doing = rs-doing;pool = rs-pool;共 7 张。
163
+ test("管理员:总数、归档的完成卡照样计数、按项目 / 完成者、每日曲线", async () => {
164
+ const r = await stats(admin.token, "&tz=UTC");
165
+ expect(r.status).toBe(200);
166
+ const s = r.body;
167
+ expect(s.totals.done).toBe(5);
168
+ expect(s.totals.done_approx).toBe(0);
169
+ expect(s.totals.doing).toBe(1);
170
+ expect(s.totals.pool).toBe(1);
171
+ expect(s.totals.created).toBe(7);
172
+ expect(s.totals.created_done).toBe(5);
173
+ expect(s.totals.completion_rate).toBeCloseTo(5 / 7, 6);
174
+ // 列表默认不含归档的卡,统计含:这正是「完成的卡被归档后今天完成数偏少」的那一张。
175
+ const list = await send(admin.token, "GET", `/api/requirements?network_id=${NET}`);
176
+ expect((list.body.requirements as any[]).some(x => x.id === C["rs-archived"])).toBe(false);
177
+ expect(s.by_project).toEqual([{ project_id: null, n: 4 }, { project_id: PROJ, n: 1 }]);
178
+ const by = Object.fromEntries((s.by_completer as any[]).map(c => [`${c.kind}:${c.id}`, c]));
179
+ expect(by[`user:${admin.id}`].n).toBe(3);
180
+ expect(by[`user:${alice.id}`].n).toBe(1);
181
+ expect(by[`node:${bot.nodeId}`].n).toBe(1);
182
+ expect(by[`user:${admin.id}`].spark.length).toBe(14);
183
+ expect(s.unattributed).toBe(0);
184
+ expect(s.daily.length).toBe(30);
185
+ expect(s.daily.reduce((a: number, d: any) => a + d.n, 0)).toBe(5);
186
+ expect(s.daily.at(-1).date).toBe(localDate(Date.parse(s.range.to), "UTC"));
187
+ });
188
+
189
+ test("recent:最近完成的卡(新 → 旧),带短号 / 标题 / 完成者;recent=0 空;非法 400", async () => {
190
+ const r = await stats(admin.token, "&recent=3");
191
+ expect(r.status).toBe(200);
192
+ const rec = r.body.recent as any[];
193
+ expect(rec.map(x => x.name)).toEqual(["rs-archived", "rs-alice", "rs-bot-card"]);
194
+ expect(rec[0].archived).toBe(true);
195
+ expect(rec[1].completed_by).toEqual({ kind: "user", id: alice.id });
196
+ expect(rec[2].completed_by?.kind).toBe("node");
197
+ expect(typeof rec[0].seq).toBe("number");
198
+ for (let i = 1; i < rec.length; i++) expect(rec[i - 1].completed_at >= rec[i].completed_at).toBe(true);
199
+ expect((await stats(admin.token)).body.recent.length).toBe(5); // 缺省 10,只有 5 张完成
200
+ expect((await stats(admin.token, "&recent=0")).body.recent).toEqual([]);
201
+ for (const bad of ["-1", "51", "x"]) expect((await stats(admin.token, `&recent=${bad}`)).body.error).toBe("invalid_recent");
202
+ });
203
+
204
+ test("scoped 成员:统计只含他看得见的卡(反向:别人的卡、项目、完成者都不出现)", async () => {
205
+ const r = await stats(alice.token);
206
+ expect(r.status).toBe(200);
207
+ expect(r.body.totals.done).toBe(1);
208
+ expect(r.body.totals.doing).toBe(0);
209
+ expect(r.body.totals.pool).toBe(0);
210
+ expect(r.body.totals.created).toBe(1);
211
+ expect(r.body.by_project).toEqual([{ project_id: null, n: 1 }]);
212
+ expect(r.body.by_completer).toEqual([expect.objectContaining({ kind: "user", id: alice.id, n: 1 })]);
213
+ expect(r.text).not.toContain(admin.id);
214
+ expect((r.body.recent as any[]).map(x => x.name)).toEqual(["rs-alice"]);
215
+ expect(r.text).not.toContain(PROJ);
216
+ expect(r.text).not.toContain(bot.nodeId);
217
+ });
218
+
219
+ test("Agent 受限成员:隐藏节点完成的卡照样计数,但记在 unattributed,节点 id 不出现", async () => {
220
+ expect(isAgentRestricted(carol.id, NET)).toBe(true); // 前置:carol 确实受限,否则下面的断言恒真
221
+ const r = await stats(carol.token);
222
+ expect(r.status).toBe(200);
223
+ expect(r.body.totals.done).toBe(5);
224
+ expect(r.body.unattributed).toBe(1);
225
+ expect((r.body.by_completer as any[]).some(c => c.kind === "node")).toBe(false);
226
+ expect(r.text).not.toContain(bot.nodeId);
227
+ expect((r.body.recent as any[]).find(x => x.name === "rs-bot-card").completed_by).toBeNull();
228
+ // 卡片详情也藏掉 completedBy(与 updated_by 同一规则)
229
+ const one = await send(carol.token, "GET", `/api/requirements/${C["rs-bot-card"]}?network_id=${NET}`);
230
+ expect(one.status).toBe(200);
231
+ expect(one.body.requirement.completedBy).toBeNull();
232
+ });
233
+
234
+ test("节点令牌可以读统计", async () => {
235
+ const r = await stats(bot.token);
236
+ expect(r.status).toBe(200);
237
+ expect(r.body.totals.done).toBe(5);
238
+ });
239
+
240
+ test("from / to:范围外的完成不计入总数;daily 按自己的窗口", async () => {
241
+ const future = new Date(Date.now() + 86_400_000).toISOString();
242
+ const r1 = await stats(admin.token, `&from=${encodeURIComponent(future)}&to=${encodeURIComponent(new Date(Date.now() + 2 * 86_400_000).toISOString())}`);
243
+ expect(r1.status).toBe(200);
244
+ expect(r1.body.totals.done).toBe(0);
245
+ expect(r1.body.totals.created).toBe(0);
246
+ expect(r1.body.totals.completion_rate).toBeNull();
247
+ expect(r1.body.totals.doing).toBe(1); // 「进行中」是当前状态,不看范围
248
+ const past = new Date(Date.now() - 86_400_000).toISOString();
249
+ const r2 = await stats(admin.token, `&to=${encodeURIComponent(past)}`);
250
+ expect(r2.body.totals.done).toBe(0);
251
+ expect(r2.body.daily.reduce((a: number, d: any) => a + d.n, 0)).toBe(0);
252
+ });
253
+
254
+ test("tz:最后一天按调用方时区;UTC+14 与 UTC-12 相差一天", async () => {
255
+ const east = await stats(admin.token, "&tz=Pacific/Kiritimati&days=1");
256
+ const west = await stats(admin.token, "&tz=Etc/GMT%2B12&days=1");
257
+ expect(east.status).toBe(200);
258
+ expect(west.status).toBe(200);
259
+ const to = Date.parse(east.body.range.to);
260
+ expect(east.body.daily.at(-1).date).toBe(localDate(to, "Pacific/Kiritimati"));
261
+ expect(west.body.daily.at(-1).date).toBe(localDate(Date.parse(west.body.range.to), "Etc/GMT+12"));
262
+ expect(east.body.daily.at(-1).date > west.body.daily.at(-1).date).toBe(true);
263
+ // 今天刚完成的 5 张都落在「今天」这一格(两边各自的今天)
264
+ expect(east.body.daily.at(-1).n).toBe(5);
265
+ expect(west.body.daily.at(-1).n).toBe(5);
266
+ });
267
+
268
+ test("days=371 画一整年;非法参数 400", async () => {
269
+ const year = await stats(admin.token, "&days=371");
270
+ expect(year.body.daily.length).toBe(371);
271
+ for (const [qs, err] of [
272
+ ["&tz=Mars/Base", "invalid_tz"], ["&days=0", "invalid_days"], ["&days=372", "invalid_days"], ["&days=1.5", "invalid_days"],
273
+ ["&from=garbage", "invalid_from"], ["&to=nope", "invalid_to"],
274
+ [`&from=${encodeURIComponent(new Date(Date.now() + 86_400_000).toISOString())}&to=${encodeURIComponent(new Date().toISOString())}`, "invalid_range"],
275
+ ] as const) {
276
+ const r = await stats(admin.token, qs);
277
+ expect([qs, r.status, r.body?.error]).toEqual([qs, 400, err]);
278
+ }
279
+ });
280
+
281
+ test("不带令牌 401;不是 /:id(「stats」不会被当成卡号)", async () => {
282
+ const anon = await send("", "GET", `/api/requirements/stats?network_id=${NET}`);
283
+ expect(anon.status).toBe(401);
284
+ const r = await stats(admin.token);
285
+ expect(r.body.ok).toBe(true);
286
+ expect(r.body.requirement).toBeUndefined();
287
+ });
288
+ });
289
+
290
+ describe("tag_status current snapshot #1091", () => {
291
+ let project = "";
292
+ test("current unarchived four states, distinct memberships and separate null bucket", async () => {
293
+ const p = await send(admin.token, "POST", "/api/requirements/projects", { network_id: NET, name: "tag-status" });
294
+ expect(p.status).toBe(201); project = p.body.project.id;
295
+ const seed = (name: string, extra: Record<string, unknown>) => card(admin.token, name, { project_id: project, ...extra });
296
+ await seed("tag-pool", { tags: ["a", "b", "a"] });
297
+ await seed("tag-done", { tags: ["a", "b"], column: "done" });
298
+ await seed("tag-doing", { tags: ["b"], column: "doing" });
299
+ await seed("tag-abandoned", { column: "abandoned" });
300
+ await seed("tag-literal", { tags: ["无标签"] });
301
+ const invalid = await seed("tag-invalid-legacy", { column: "done" });
302
+ db.run("UPDATE requirements SET tags_json='invalid legacy json' WHERE requirement_id=?1", [invalid.id]);
303
+ await seed("tag-visible", { tags: ["visible"], column: "doing", owner: { kind: "user", id: alice.id } });
304
+ await seed("tag-secret", { tags: ["secret"], column: "done" });
305
+ const archived = await seed("tag-archived", { tags: ["archived-only"], column: "doing" });
306
+ expect((await send(admin.token, "PATCH", `/api/requirements/${archived.id}?network_id=${NET}`, { archived: true })).status).toBe(200);
307
+ const r = await stats(admin.token, `&project_id=${project}`);
308
+ expect(r.status).toBe(200);
309
+ expect(r.body.tag_status).toMatchObject({ basis: "current", complete: true, includes_archived: false, project_filter: project, total: 8 });
310
+ const buckets = new Map(r.body.tag_status.by_tag.map((x: any) => [x.tag, x]));
311
+ expect(buckets.get("a")).toEqual({ tag: "a", pool: 1, doing: 0, done: 1, abandoned: 0, total: 2 });
312
+ expect(buckets.get("b")).toEqual({ tag: "b", pool: 1, doing: 1, done: 1, abandoned: 0, total: 3 });
313
+ expect(buckets.get(null)).toEqual({ tag: null, pool: 0, doing: 0, done: 1, abandoned: 1, total: 2 });
314
+ expect(buckets.get("无标签")).toMatchObject({ pool: 1, total: 1 });
315
+ expect(buckets.has("archived-only")).toBe(false);
316
+ expect(r.body.tag_status.by_tag[0].tag).toBe("b");
317
+ expect(r.body.tag_status.by_tag.reduce((sum: number, x: any) => sum + x.total, 0)).toBe(10);
318
+ });
319
+ test("snapshot ignores time range; completion totals still follow it", async () => {
320
+ const future = new Date(Date.now() + 86_400_000).toISOString();
321
+ const r = await stats(admin.token, `&project_id=${project}&from=${encodeURIComponent(future)}&to=${encodeURIComponent(new Date(Date.now()+2*86_400_000).toISOString())}`);
322
+ expect(r.body.totals.done).toBe(0); expect(r.body.tag_status.total).toBe(8);
323
+ expect(r.body.tag_status.by_tag.find((x: any) => x.tag === "a").done).toBe(1);
324
+ });
325
+ test("same visibility scope hides inaccessible tags and project results", async () => {
326
+ const r = await stats(alice.token, `&project_id=${project}`);
327
+ expect(r.status).toBe(200); expect(r.body.tag_status.total).toBe(1);
328
+ expect(r.body.tag_status.by_tag).toEqual([{ tag: "visible", pool: 0, doing: 1, done: 0, abandoned: 0, total: 1 }]);
329
+ expect(r.text).not.toContain('"secret"'); expect(r.text).not.toContain('"archived-only"');
330
+ const empty = await stats(alice.token, `&project_id=${PROJ}`);
331
+ expect(empty.body.tag_status.total).toBe(0); expect(empty.body.tag_status.by_tag).toEqual([]);
332
+ });
333
+ test("project none, unknown project and invalid project query", async () => {
334
+ const r = await stats(admin.token, "&project_id=none");
335
+ expect(r.body.tag_status.project_filter).toBe("none");
336
+ expect(r.body.tag_status.by_tag.every((x: any) => x.tag === null)).toBe(true);
337
+ expect((await stats(admin.token, "&project_id=proj_missing")).body.tag_status).toMatchObject({ total: 0, by_tag: [] });
338
+ expect((await stats(admin.token, `&project_id=${"x".repeat(201)}`)).body.error).toBe("invalid_project_id");
339
+ const list = await send(admin.token, "GET", `/api/requirements?network_id=${NET}`);
340
+ expect(list.body.capabilities).toContain("tag_status_snapshot");
341
+ });
342
+ test("all visible rows counted beyond client 500 limit; another network excluded", async () => {
343
+ const p = await send(admin.token, "POST", "/api/requirements/projects", { network_id: NET, name: "large-tag-status" });
344
+ expect(p.status).toBe(201); const large = p.body.project.id;
345
+ const other = `net_tag_foreign_${Date.now()}`;
346
+ db.run("INSERT INTO networks(network_id,network_name,owner_id) VALUES(?1,'foreign',?2)", [other,admin.id]);
347
+ db.transaction(() => {
348
+ for (let i=0;i<502;i++) db.run(`INSERT INTO requirements(requirement_id,network_id,title,column_name,tags_json,project_id,archived,created_at,updated_at)
349
+ VALUES(?1,?2,'bulk','pool','["bulk"]',?3,0,datetime('now'),datetime('now'))`, [`req_tag_bulk_${large}_${i}`,i===501?other:NET,large]);
350
+ });
351
+ const r = await stats(admin.token, `&project_id=${large}&recent=0`);
352
+ expect(r.status).toBe(200); expect(r.body.tag_status.total).toBe(501);
353
+ expect(r.body.tag_status.by_tag).toEqual([{ tag: "bulk", pool: 501, doing: 0, done: 0, abandoned: 0, total: 501 }]);
354
+ const denied = await send(alice.token,"GET",`/api/requirements/stats?network_id=${other}`);
355
+ expect([403,404]).toContain(denied.status);
356
+ });
357
+ });
@@ -0,0 +1,195 @@
1
+ // 任务仪表盘的聚合(GET /api/requirements/stats)。纯函数:行由 requirements.ts 按调用者的可见范围读出来,
2
+ // 这里只按时间范围 / 时区分桶、按项目 / 完成者计数。放在 JS 里而不是 SQL:按 IANA 时区切「哪一天」在
3
+ // SQLite 和 PostgreSQL 上写法不同,而一个网络的卡片数是几百到几千,整表轻量列读一次就够。
4
+ import { isoInstant } from "./requirements-migrate.js";
5
+ import { storedTags } from "./requirement-tags.js";
6
+
7
+ export const STATS_DEFAULT_DAYS = 30;
8
+ export const STATS_MAX_DAYS = 371; // 53 周:够画一整年的贡献热力图
9
+ export const STATS_SPARK_DAYS = 14;
10
+ export const STATS_TOP_COMPLETERS = 20;
11
+ export const STATS_DEFAULT_RECENT = 10;
12
+ export const STATS_MAX_RECENT = 50;
13
+
14
+ export type StatsRow = {
15
+ requirement_id: string;
16
+ seq: number | null;
17
+ title: string;
18
+ project_id: string | null;
19
+ column_name: string;
20
+ archived: number | null;
21
+ created_at: string | null;
22
+ completed_at: string | null;
23
+ completed_at_approx: number | null;
24
+ completed_by_json: string | null;
25
+ tags_json?: string | null;
26
+ };
27
+
28
+ export type StatsQuery = { fromMs: number | null; toMs: number; tz: string; days: number; recent: number; projectId?: string | null };
29
+ type Ref = { kind: "user" | "node"; id: string };
30
+
31
+ /** 解析 from / to / tz / days。不合法 → 错误码(400)。to 缺省 = 现在;from 缺省 = 不设下限(全部)。 */
32
+ export function parseStatsQuery(q: URLSearchParams, nowMs: number): StatsQuery | { error: string } {
33
+ const instant = (name: string): number | null | { error: string } => {
34
+ const raw = q.get(name);
35
+ if (raw === null || raw === "") return null;
36
+ const ms = Date.parse(raw);
37
+ return Number.isFinite(ms) ? ms : { error: `invalid_${name}` };
38
+ };
39
+ const from = instant("from");
40
+ if (from !== null && typeof from === "object") return from;
41
+ const to = instant("to");
42
+ if (to !== null && typeof to === "object") return to;
43
+ const toMs = to ?? nowMs;
44
+ if (from !== null && from > toMs) return { error: "invalid_range" };
45
+ const tz = q.get("tz") || "UTC";
46
+ if (tz.length > 64 || !validTimeZone(tz)) return { error: "invalid_tz" };
47
+ const daysRaw = q.get("days");
48
+ const days = daysRaw === null || daysRaw === "" ? STATS_DEFAULT_DAYS : Number(daysRaw);
49
+ if (!Number.isInteger(days) || days < 1 || days > STATS_MAX_DAYS) return { error: "invalid_days" };
50
+ const recentRaw = q.get("recent");
51
+ const recent = recentRaw === null || recentRaw === "" ? STATS_DEFAULT_RECENT : Number(recentRaw);
52
+ if (!Number.isInteger(recent) || recent < 0 || recent > STATS_MAX_RECENT) return { error: "invalid_recent" };
53
+ const project = q.get("project_id");
54
+ if (project && (project.length > 200 || /[\u0000-\u001f\u007f]/u.test(project))) return { error: "invalid_project_id" };
55
+ return { fromMs: from, toMs, tz, days, recent,
56
+ ...(project ? { projectId: project === "none" ? null : project } : {}) };
57
+ }
58
+
59
+ function validTimeZone(tz: string): boolean {
60
+ try { new Intl.DateTimeFormat("en-CA", { timeZone: tz }); return true; } catch { return false; }
61
+ }
62
+
63
+ /** 某一时刻在 tz 里是哪一天(YYYY-MM-DD)。 */
64
+ export function localDate(ms: number, tz: string): string {
65
+ // en-CA 的日期格式就是 YYYY-MM-DD。
66
+ return new Intl.DateTimeFormat("en-CA", { timeZone: tz, year: "numeric", month: "2-digit", day: "2-digit" }).format(new Date(ms));
67
+ }
68
+
69
+ /** 以 lastDay(YYYY-MM-DD)结尾、往前数 n 天的日期列表(旧 → 新)。纯日历运算,与时区无关。 */
70
+ export function dayRange(lastDay: string, n: number): string[] {
71
+ const [y, m, d] = lastDay.split("-").map(Number);
72
+ const out: string[] = [];
73
+ for (let i = n - 1; i >= 0; i--) out.push(new Date(Date.UTC(y, m - 1, d - i)).toISOString().slice(0, 10));
74
+ return out;
75
+ }
76
+
77
+ const msOf = (v: string | null): number | null => {
78
+ const iso = isoInstant(v);
79
+ return iso === null ? null : Date.parse(iso);
80
+ };
81
+ const parseRef = (json: string | null): Ref | null => {
82
+ if (!json) return null;
83
+ try {
84
+ const r = JSON.parse(json);
85
+ return r && (r.kind === "user" || r.kind === "node") && typeof r.id === "string" ? { kind: r.kind, id: r.id } : null;
86
+ } catch { return null; }
87
+ };
88
+
89
+ /**
90
+ * hidden:受限成员看不见的节点(与列表里 hiddenNodeFilter 同一个判定)。这些节点完成的卡照样计数,
91
+ * 但归到 unattributed,不出现在 by_completer 里 —— 不给他留「那个节点做了几张」的探测口。
92
+ */
93
+ export function aggregateStats(rows: StatsRow[], q: StatsQuery, hidden: ((nodeId: string) => boolean) | null) {
94
+ if (q.projectId !== undefined) rows = rows.filter(row => row.project_id === q.projectId);
95
+ const inRange = (ms: number | null) => ms !== null && ms <= q.toMs && (q.fromMs === null || ms >= q.fromMs);
96
+ const days = dayRange(localDate(q.toMs, q.tz), q.days);
97
+ const firstDay = days[0];
98
+ const lastDay = days[days.length - 1];
99
+ const sparkDays = new Set(days.slice(-STATS_SPARK_DAYS));
100
+ const daily = new Map(days.map(d => [d, 0]));
101
+
102
+ let done = 0, approx = 0, created = 0, createdDone = 0, doing = 0, pool = 0, abandoned = 0, unattributed = 0;
103
+ const byProject = new Map<string | null, number>();
104
+ const byCompleter = new Map<string, { ref: Ref; n: number; spark: Map<string, number> }>();
105
+ const recent: { row: StatsRow; ms: number; by: Ref | null }[] = [];
106
+ const byTag = new Map<string | null, { tag: string | null; pool: number; doing: number; done: number; abandoned: number; total: number }>();
107
+ let snapshotTotal = 0;
108
+
109
+ for (const row of rows) {
110
+ if (!row.archived && ["pool", "doing", "done", "abandoned"].includes(row.column_name)) {
111
+ snapshotTotal++;
112
+ const tags: (string | null)[] = storedTags(row.tags_json ?? null);
113
+ if (!tags.length) tags.push(null);
114
+ for (const tag of tags) {
115
+ let bucket = byTag.get(tag);
116
+ if (!bucket) byTag.set(tag, bucket = { tag, pool: 0, doing: 0, done: 0, abandoned: 0, total: 0 });
117
+ bucket[row.column_name as "pool" | "doing" | "done" | "abandoned"]++;
118
+ bucket.total++;
119
+ }
120
+ }
121
+ // 当前还开着的卡(不看时间范围;归档的不算「进行中」)。
122
+ if (!row.archived && row.column_name === "doing") doing++;
123
+ if (!row.archived && row.column_name === "pool") pool++;
124
+ if (!row.archived && row.column_name === "abandoned") abandoned++;
125
+ const completedMs = row.column_name === "done" ? msOf(row.completed_at) : null;
126
+ const createdMs = msOf(row.created_at);
127
+ if (inRange(createdMs)) {
128
+ created++;
129
+ if (completedMs !== null) createdDone++;
130
+ }
131
+ if (completedMs === null) continue;
132
+ // 每日曲线按自己的 days 窗口算(与 from 无关),这样一次请求就能同时画 30 天柱图和一年热力图。
133
+ if (completedMs <= q.toMs) {
134
+ const day = localDate(completedMs, q.tz);
135
+ if (day >= firstDay && day <= lastDay) daily.set(day, (daily.get(day) ?? 0) + 1);
136
+ }
137
+ if (!inRange(completedMs)) continue;
138
+ const who = parseRef(row.completed_by_json);
139
+ recent.push({ row, ms: completedMs, by: who && !(who.kind === "node" && hidden?.(who.id)) ? who : null });
140
+ done++;
141
+ if (row.completed_at_approx) approx++;
142
+ byProject.set(row.project_id, (byProject.get(row.project_id) ?? 0) + 1);
143
+ const ref = parseRef(row.completed_by_json);
144
+ if (!ref || (ref.kind === "node" && hidden?.(ref.id))) { unattributed++; continue; }
145
+ const key = `${ref.kind}:${ref.id}`;
146
+ let c = byCompleter.get(key);
147
+ if (!c) byCompleter.set(key, c = { ref, n: 0, spark: new Map() });
148
+ c.n++;
149
+ const day = localDate(completedMs, q.tz);
150
+ if (sparkDays.has(day)) c.spark.set(day, (c.spark.get(day) ?? 0) + 1);
151
+ }
152
+
153
+ const spark = days.slice(-STATS_SPARK_DAYS);
154
+ return {
155
+ tag_status: {
156
+ basis: "current", complete: true, includes_archived: false,
157
+ project_filter: q.projectId === undefined ? null : q.projectId ?? "none",
158
+ total: snapshotTotal,
159
+ // Membership counts: a multi-tag card counts once in each distinct tag.
160
+ by_tag: [...byTag.values()].sort((a, b) =>
161
+ (b.pool + b.doing) - (a.pool + a.doing) || b.total - a.total ||
162
+ String(a.tag ?? "\uffff").localeCompare(String(b.tag ?? "\uffff"))),
163
+ },
164
+ range: { from: q.fromMs === null ? null : new Date(q.fromMs).toISOString(), to: new Date(q.toMs).toISOString(), tz: q.tz },
165
+ totals: {
166
+ done,
167
+ // 其中完成时刻是升级前按 updated_at 补的近似值的张数;界面据此标「近似」。
168
+ done_approx: approx,
169
+ created,
170
+ created_done: createdDone,
171
+ // 完成率 = 期内新建的卡里,现在已完成的比例;期内没有新建 → null(不是 0%)。
172
+ completion_rate: created ? createdDone / created : null,
173
+ doing,
174
+ pool,
175
+ // 废弃(关闭,不算开着也不算完成)。旧 App 忽略这个字段。
176
+ abandoned,
177
+ },
178
+ daily: days.map(date => ({ date, n: daily.get(date) ?? 0 })),
179
+ by_project: [...byProject].map(([project_id, n]) => ({ project_id, n })).sort((a, b) => b.n - a.n || String(a.project_id).localeCompare(String(b.project_id))),
180
+ by_completer: [...byCompleter.values()]
181
+ .sort((a, b) => b.n - a.n || `${a.ref.kind}:${a.ref.id}`.localeCompare(`${b.ref.kind}:${b.ref.id}`))
182
+ .slice(0, STATS_TOP_COMPLETERS)
183
+ .map(c => ({ ...c.ref, n: c.n, spark: spark.map(d => c.spark.get(d) ?? 0) })),
184
+ unattributed,
185
+ // 最近完成(新 → 旧):仪表盘的「最近完成」时间线和分享图的「今天完成的任务」。只含期内、调用者看得见的卡;
186
+ // 完成者是隐藏节点 → completed_by = null。
187
+ recent: recent
188
+ .sort((a, b) => b.ms - a.ms || (a.row.requirement_id < b.row.requirement_id ? 1 : -1))
189
+ .slice(0, q.recent)
190
+ .map(({ row, ms, by }) => ({
191
+ id: row.requirement_id, seq: row.seq == null ? null : Number(row.seq), name: row.title, project_id: row.project_id,
192
+ completed_at: new Date(ms).toISOString(), completed_at_approx: !!row.completed_at_approx, completed_by: by, archived: !!row.archived,
193
+ })),
194
+ };
195
+ }