@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,227 @@
1
+ // 2026-10-31 —— **「这条任务到死都没被取走」要有计数**(#3271 的直接产物)。
2
+ //
3
+ // 现场:一台节点上有 4 条任务,一次又一次「等满 60 分钟 ⇒ expired」,而**积压数两次读数都是 4**。
4
+ // 「又过期了一条」是可见的(Hub 会发通知),但「这台节点连续 N 次一次都没取走」没有任何读数 ——
5
+ // 于是派单方只能靠人记住「这台不行」。
6
+ //
7
+ // 与 rejection-counters.ts 同一套约束:
8
+ // ① 按**节点**分桶,不是只有一个总数(要回答「是哪一台」)
9
+ // ② 窗口必须与 startedAt 一起读(进程重启归零,而「归零」与「没发生」同值)
10
+ // ③ 键必须有限:node id 来自我们自己的节点表,不随请求内容膨胀
11
+ //
12
+ // 🔴 最要紧的一条区分:**「过期时已经被取走过」不算「never picked up」**。
13
+ // server.ts 的 patrol 里那条注释(#500)已经写过:consumed_at < expires_at 的任务
14
+ // 只是「还没回报完成」,不是「没人取」。把它们算进来,计数就变成「过期了多少条」,
15
+ // 而那是另一个(更没用的)数。
16
+ //
17
+ // 本计数器属于「只有异常路径能让它 +1」那一类 ⇒ 必须有 must-fire:
18
+ // 注入一条真实过期(未消费)看它跳没跳,且**再注入一条已消费后过期的看它跳不跳**(负数用例)。
19
+ export type NeverConsumedExpiryCounters = {
20
+ /** 统计窗口左端(进程启动时刻,ISO)。与「归零」区分必需。 */
21
+ since: string;
22
+ /** 累计「过期且从未被取走」的任务数(所有节点)。 */
23
+ total: number;
24
+ /** 按节点分桶;键是 node alias(可读),值是计数。空桶不出现。 */
25
+ by_node: Record<string, number>;
26
+ /** 每个节点最近一次「从未取走」的时刻(ISO)。**光有计数会永久拉黑一台恢复了的节点。** */
27
+ last_at: Record<string, string>;
28
+ };
29
+
30
+ type Bucket = { count: number; lastAt: number };
31
+ const counters = new Map<string, Bucket>();
32
+ let since = new Date().toISOString();
33
+
34
+ /** 记一次「过期且从未取走」。node 名用别名(人读),没有别名时退回 node id。 */
35
+ export function noteNeverConsumedExpiry(node: string, now = Date.now()): void {
36
+ const key = node || "(unknown)";
37
+ const prev = counters.get(key);
38
+ counters.set(key, { count: (prev?.count ?? 0) + 1, lastAt: now });
39
+ }
40
+
41
+ export function neverConsumedExpiryCounters(): NeverConsumedExpiryCounters {
42
+ let total = 0;
43
+ const by_node: Record<string, number> = {};
44
+ const last_at: Record<string, string> = {};
45
+ for (const [k, v] of [...counters.entries()].sort(([a], [b]) => a.localeCompare(b))) {
46
+ by_node[k] = v.count;
47
+ last_at[k] = new Date(v.lastAt).toISOString();
48
+ total += v.count;
49
+ }
50
+ return { since, total, by_node, last_at };
51
+ }
52
+
53
+ /** 仅测试用:清零并重置窗口。 */
54
+ export function resetNeverConsumedExpiryCountersForTest(now = new Date()): void {
55
+ counters.clear();
56
+ since = now.toISOString();
57
+ }
58
+
59
+ /**
60
+ * #3271 —— 派单侧的**硬闸**判据(纯函数,便于单测)。
61
+ *
62
+ * 起因:一台节点连续 9 次「等满 60 分钟未取走」,而每一次都只是「又过期了一条」的通知。
63
+ * 派单方只能靠人记住。⇒ 这里把它变成一个**在派单那一刻就拒绝**的判据,并留一个显式出口。
64
+ *
65
+ * 三条设计选择:
66
+ * ① 阈值取「本进程窗口内 ≥3 次」——一次两次可能是宿主重启,三次已经是形态。
67
+ * ② 出口是 `force`,且**只有人**能用(节点令牌不能自己给自己放行)——与既有的
68
+ * `assertNodeHealthy(force, forceAllowed)` 同一条规矩。
69
+ * ③ 拒绝体给全:alias / expiries / window_since / 下一步。只说 "refused" 会让调用方去猜。
70
+ */
71
+ export const NEVER_CONSUME_LIMIT = 3;
72
+ /** 「最近一次从未取走」超过这个时长 ⇒ 不再拒发(节点可能已经恢复;计数仍留在读数里)。 */
73
+ export const NEVER_CONSUME_STALE_MS = 2 * 60 * 60_000;
74
+
75
+ /**
76
+ * #3271 🔴 2026-10-31 修 —— 这道闸原来**只读进程内计数器**,而计数器随部署归零。
77
+ *
78
+ * 实测打脸:`.254` 部署(22:39)之后我给 TM官网运维 派了一条自检任务,
79
+ * 它明明已经 10 次「到死没被取走」,闸却 `ok:true` 放行了 —— 因为计数器在重启时被清空。
80
+ * ⇒ **证据的生命期比故障短**:故障以「周」计,计数器以「本次进程」计。
81
+ * 一条只在本次进程内有效的判据,会被每一次发版重置,而发版比故障频繁得多。
82
+ *
83
+ * 所以判据必须有一个**持久**来源:tasks 表里已经写着每一条过期的 `status='expired'` 与
84
+ * `consumed_at IS NULL` —— 那是过期发生时就落库的事实,不随重启消失。
85
+ *
86
+ * 两个来源**取并集**(不是二选一):
87
+ * · 进程内计数器:本次进程内发生的最新鲜的那几条(可能在 tasks 行写之前就有)
88
+ * · tasks 表:跨重启的历史(窗口由调用方给,默认 7 天 —— 与「节点可能恢复」同一个取舍)
89
+ */
90
+ export interface PersistentExpiryEvidence {
91
+ /** 「最后一次成功回复之后」仍过期且无回复的条数。 */
92
+ expiries: number;
93
+ /** 这些过期里最近的一条(用于读数,不用于时效判断)。 */
94
+ last_at: string | null;
95
+ /** 该节点最后一次成功回复的时间;null = 从来没有回复过(那才是真正的「从未消费」)。 */
96
+ last_reply_at: string | null;
97
+ }
98
+
99
+ export const NEVER_CONSUME_LOOKBACK_MS = 7 * 24 * 60 * 60_000;
100
+
101
+ /**
102
+ * #3271 🔴 2026-10-31 第二次修正 —— 判据的**语义**错了,不只是寿命。
103
+ *
104
+ * 第一次修正(内存 ∪ tasks 表)解决的是「部署清空计数器」,但生产实测仍然放行,查库后发现:
105
+ *
106
+ * tasks WHERE to_name='TM官网运维'
107
+ * replied 252 条 ← 它其实会干活
108
+ * status='expired' 37 条 且 consumed_at 全为 NULL
109
+ * 全库 consumed_at 非空 83,332 条(这个字段是被正常使用的)
110
+ *
111
+ * ⇒ **`consumed_at IS NULL` 不等于「从未取走」**:这台节点回复过 252 条,只是从不写这个字段。
112
+ * 计数器叫「从未取走」,量的却是「没写 consumed_at」—— 我把字段名当成了行为名。
113
+ *
114
+ * 所以判据改为**以「最后一次成功回复」为界**:
115
+ * 「在你最后一次回复之后,又有多少条过期且没人回」= 它到底还在不在服务。
116
+ * 之后已经回复过 ⇒ 放行(它是活的,只是某几条没接)。
117
+ *
118
+ * 这也让固定 TTL 变得不必要:DB 这条路自带边界(回复时间),
119
+ * 而固定 TTL 是凭直觉定的 —— 实测那台节点的故障节律是「天」,我给的是「2 小时」。
120
+ */
121
+ export function persistentNeverConsumedExpiries(
122
+ db: { get<T = any>(sql: string, ...params: any[]): T | null },
123
+ alias: string,
124
+ networkId: string | null,
125
+ opts: { now?: number; lookbackMs?: number } = {},
126
+ ): PersistentExpiryEvidence {
127
+ const since = new Date((opts.now ?? Date.now()) - (opts.lookbackMs ?? NEVER_CONSUME_LOOKBACK_MS))
128
+ .toISOString().replace("T", " ").slice(0, 19);
129
+
130
+ // ① 最后一次成功回复(replied / completed 都算「还活着」的证据)
131
+ const reply = networkId
132
+ ? db.get<{ last: string | null }>(
133
+ `SELECT MAX(COALESCE(completed_at, created_at)) AS last FROM tasks
134
+ WHERE to_name = ?1 AND network_id = ?2 AND status IN ('replied','completed')`,
135
+ alias, networkId)
136
+ : db.get<{ last: string | null }>(
137
+ `SELECT MAX(COALESCE(completed_at, created_at)) AS last FROM tasks
138
+ WHERE to_name = ?1 AND status IN ('replied','completed')`,
139
+ alias);
140
+ const lastReplyAt = reply?.last ?? null;
141
+
142
+ // ② 它之后仍「过期且无回复」的条数
143
+ const boundary = lastReplyAt && lastReplyAt > since ? lastReplyAt : since;
144
+ const row = networkId
145
+ ? db.get<{ n: number; last: string | null }>(
146
+ `SELECT COUNT(*) AS n, MAX(created_at) AS last FROM tasks
147
+ WHERE to_name = ?1 AND network_id = ?2 AND status = 'expired' AND result IS NULL
148
+ AND created_at > ?3
149
+ -- #3271 后续 —— **诊断探针不算证据**:我自己派去测「它到底消不消费」的 probe,
150
+ -- 过期后与「一条真活没人接」在表里同形;用它去证明节点不行,是自证。
151
+ AND COALESCE(meta_json, '') NOT LIKE '%"probe"%'`,
152
+ alias, networkId, boundary)
153
+ : db.get<{ n: number; last: string | null }>(
154
+ `SELECT COUNT(*) AS n, MAX(created_at) AS last FROM tasks
155
+ WHERE to_name = ?1 AND status = 'expired' AND result IS NULL
156
+ AND created_at > ?2
157
+ AND COALESCE(meta_json, '') NOT LIKE '%"probe"%'`,
158
+ alias, boundary);
159
+
160
+ return {
161
+ expiries: Number(row?.n ?? 0),
162
+ last_at: row?.last ?? null,
163
+ last_reply_at: lastReplyAt,
164
+ };
165
+ }
166
+
167
+ export type NeverConsumeGate =
168
+ | { ok: true }
169
+ | { ok: false; error: "target_never_consumes"; alias: string; expiries: number; window_since: string; message: string };
170
+
171
+ export function neverConsumeGate(input: {
172
+ alias: string;
173
+ counters: NeverConsumedExpiryCounters;
174
+ force: boolean;
175
+ /** 人令牌才能用 force;节点令牌传 false。 */
176
+ forceAllowed: boolean;
177
+ limit?: number;
178
+ /** 「最近一次」的时效:超过它就不再拒发(节点可能已经恢复)。 */
179
+ staleAfterMs?: number;
180
+ now?: number;
181
+ /** tasks 表里的历史(跨重启)。与进程内计数器**取并集**,见 persistentNeverConsumedExpiries 的注释。 */
182
+ persistent?: PersistentExpiryEvidence;
183
+ }): NeverConsumeGate {
184
+ const limit = input.limit ?? NEVER_CONSUME_LIMIT;
185
+ const fromMemory = input.counters.by_node[input.alias] ?? 0;
186
+ const fromDb = input.persistent?.expiries ?? 0;
187
+ const expiries = Math.max(fromMemory, fromDb);
188
+ if (expiries < limit) return { ok: true };
189
+ // DB 证据**自带边界**(「最后一次回复之后」),所以它不需要固定 TTL —— 那个 TTL 是我拍的。
190
+ // 只有「纯内存计数」这条路才需要时效:它没有回复时间可比,只能靠时长兜底。
191
+ if (fromDb >= limit) {
192
+ if (input.force && input.forceAllowed) return { ok: true };
193
+ return {
194
+ ok: false,
195
+ error: "target_never_consumes",
196
+ alias: input.alias,
197
+ expiries,
198
+ window_since: input.counters.since,
199
+ message:
200
+ `this target has ${fromDb} expired task(s) with no reply since its last reply`
201
+ + `${input.persistent?.last_reply_at ? ` (${input.persistent.last_reply_at})` : " (it has never replied)"}; `
202
+ + `nothing will queue correctly here until it replies again — pass force:true (user tokens) if you know it recovered`,
203
+ };
204
+ }
205
+ // 2026-10-31 —— **只数不衰减会把恢复了的节点永久拉黑**。
206
+ // 实测的教训来自另一台机(TM中转运维):连「抑制了多少」这个数本身都在被环缓冲淘汰,
207
+ // 所以任何「累计」都只在它的窗口内可引用;这里把窗口写进判据:最近一次过期超过 TTL ⇒ 放行。
208
+ const lastAt = [input.counters.last_at?.[input.alias], input.persistent?.last_at ?? undefined]
209
+ .filter((x): x is string => typeof x === "string")
210
+ .sort()
211
+ .pop();
212
+ if (lastAt) {
213
+ const age = (input.now ?? Date.now()) - Date.parse(lastAt);
214
+ if (Number.isFinite(age) && age > (input.staleAfterMs ?? NEVER_CONSUME_STALE_MS)) return { ok: true };
215
+ }
216
+ if (input.force && input.forceAllowed) return { ok: true };
217
+ return {
218
+ ok: false,
219
+ error: "target_never_consumes",
220
+ alias: input.alias,
221
+ expiries,
222
+ window_since: input.counters.since,
223
+ message:
224
+ `this target has expired ${expiries} task(s) without ever taking one (window since ${input.counters.since}); `
225
+ + `nothing will queue correctly here until it consumes again — pass force:true (user tokens) if you know it recovered`,
226
+ };
227
+ }
@@ -0,0 +1,103 @@
1
+ // #3271 第二次修正的**数据层**判据:证据必须以「最后一次成功回复」为界。
2
+ //
3
+ // 为什么这条要有 DB 级测试:边界逻辑在 SQL 里(`created_at > MAX(COALESCE(completed_at, created_at))`),
4
+ // 纯函数测试用假的 get() 喂数据只能证明「我按我想的组装了」,证明不了「SQL 真的这么筛」。
5
+ //
6
+ // 现场(2026-10-31 生产实测):
7
+ // TM官网运维 replied 252 条、expired 37 条,而 consumed_at 全为 NULL
8
+ // ⇒「consumed_at IS NULL」被当成了「从未取走」,然而它明明会回。
9
+ import { afterAll, beforeEach, describe, expect, test } from "bun:test";
10
+ import { db } from "./db.js";
11
+ import { persistentNeverConsumedExpiries } from "./expiry-counters.js";
12
+
13
+ const NET = "net_expiry_evidence";
14
+ const ALIAS = "ghost-node";
15
+
16
+ function task(id: string, status: string, createdAt: string, extra: { result?: string | null; completed_at?: string | null; consumed_at?: string | null } = {}) {
17
+ db.run(
18
+ `INSERT INTO tasks (task_id, to_name, status, content, network_id, created_at, result, completed_at, consumed_at)
19
+ VALUES (?1, ?2, ?3, 'probe', ?4, ?5, ?6, ?7, ?8)`,
20
+ [id, ALIAS, status, NET, createdAt, extra.result ?? null, extra.completed_at ?? null, extra.consumed_at ?? null],
21
+ );
22
+ }
23
+
24
+ beforeEach(() => {
25
+ db.run("DELETE FROM tasks WHERE network_id = ?1", [NET]);
26
+ });
27
+
28
+ afterAll(() => {
29
+ db.run("DELETE FROM tasks WHERE network_id = ?1", [NET]);
30
+ });
31
+
32
+ describe("#3271 持久证据:以「最后一次回复」为界", () => {
33
+ test("🔴 回复之后的过期才算数:回复之前的过期不计入", () => {
34
+ const now = Date.parse("2026-10-31T22:00:00.000Z");
35
+ // 两次过期在回复之前 —— 那说明它当时还在服务,不该算作「之后没回」
36
+ task("t_old1", "expired", "2026-10-30 10:00:00");
37
+ task("t_old2", "expired", "2026-10-30 11:00:00");
38
+ // 一次成功回复(completed_at 比 created_at 晚)
39
+ task("t_reply", "replied", "2026-10-30 12:00:00", { result: "ok", completed_at: "2026-10-30 12:05:00" });
40
+ const ev = persistentNeverConsumedExpiries(db, ALIAS, NET, { now });
41
+ expect(ev.last_reply_at).toBe("2026-10-30 12:05:00");
42
+ expect(ev.expiries).toBe(0);
43
+ });
44
+
45
+ test("🔴 回复之后又连续过期 ⇒ 计数(这才是「它没在服务」)", () => {
46
+ const now = Date.parse("2026-10-31T22:00:00.000Z");
47
+ task("t_reply", "replied", "2026-10-29 12:00:00", { result: "ok", completed_at: "2026-10-29 12:05:00" });
48
+ task("t_e1", "expired", "2026-10-31 09:00:00");
49
+ task("t_e2", "expired", "2026-10-31 10:00:00");
50
+ task("t_e3", "expired", "2026-10-31 11:00:00");
51
+ const ev = persistentNeverConsumedExpiries(db, ALIAS, NET, { now });
52
+ expect(ev.expiries).toBe(3);
53
+ expect(ev.last_at).toBe("2026-10-31 11:00:00");
54
+ expect(ev.last_reply_at).toBe("2026-10-29 12:05:00");
55
+ });
56
+
57
+ test("「过期但有回复」不算:那是失败,不是没人接", () => {
58
+ const now = Date.parse("2026-10-31T22:00:00.000Z");
59
+ task("t_e1", "expired", "2026-10-31 09:00:00", { result: "回过了但还是被判过期" });
60
+ const ev = persistentNeverConsumedExpiries(db, ALIAS, NET, { now });
61
+ expect(ev.expiries).toBe(0);
62
+ });
63
+
64
+ test("从来没有回复过 ⇒ last_reply_at 为 null(那才是真正的「从未消费」)", () => {
65
+ const now = Date.parse("2026-10-31T22:00:00.000Z");
66
+ task("t_e1", "expired", "2026-10-31 09:00:00");
67
+ task("t_e2", "expired", "2026-10-31 10:00:00");
68
+ const ev = persistentNeverConsumedExpiries(db, ALIAS, NET, { now });
69
+ expect(ev.last_reply_at).toBeNull();
70
+ expect(ev.expiries).toBe(2);
71
+ });
72
+
73
+ test("窗口外的旧账不算:lookback 之外的不再计入", () => {
74
+ const now = Date.parse("2026-10-31T22:00:00.000Z");
75
+ task("t_ancient", "expired", "2026-01-01 00:00:00");
76
+ const ev = persistentNeverConsumedExpiries(db, ALIAS, NET, { now });
77
+ expect(ev.expiries).toBe(0);
78
+ });
79
+
80
+ // #3271 后续 —— 诊断探针不算证据。
81
+ // 现场:我给一台节点派了 3 条 probe 去测「它到底消不消费」,其中 2 条过期 ⇒
82
+ // 「回复后无回复过期 = 2」,再涨一条就会触发闸 —— 而那一条也会是我的 probe。
83
+ // **用自己的探针去证明节点不行,是自证。** ⇒ meta_json 里带 `"probe"` 的行不参与计数。
84
+ test("🔴 meta_json 里带 probe 的过期不计入(诊断流量不是证据)", () => {
85
+ const now = Date.parse("2026-10-31T22:00:00.000Z");
86
+ db.run(
87
+ `INSERT INTO tasks (task_id, to_name, status, content, network_id, created_at, meta_json)
88
+ VALUES ('t_probe', ?1, 'expired', 'probe', ?2, '2026-10-31 09:00:00', '{"probe":true}')`,
89
+ [ALIAS, NET]);
90
+ task("t_real", "expired", "2026-10-31 10:00:00");
91
+ const ev = persistentNeverConsumedExpiries(db, ALIAS, NET, { now });
92
+ expect(ev.expiries).toBe(1); // 只剩那条真活
93
+ });
94
+
95
+ test("别的节点的账不串台", () => {
96
+ const now = Date.parse("2026-10-31T22:00:00.000Z");
97
+ db.run(
98
+ `INSERT INTO tasks (task_id, to_name, status, content, network_id, created_at)
99
+ VALUES ('t_other', 'someone-else', 'expired', 'probe', ?1, '2026-10-31 09:00:00')`, [NET]);
100
+ expect(persistentNeverConsumedExpiries(db, ALIAS, NET, { now }).expiries).toBe(0);
101
+ expect(persistentNeverConsumedExpiries(db, "someone-else", NET, { now }).expiries).toBe(1);
102
+ });
103
+ });
@@ -0,0 +1,60 @@
1
+ import { describe, expect, test } from "bun:test";
2
+ import {
3
+ buildStoragePath,
4
+ pathForExistingBlob,
5
+ validateIndexEntry,
6
+ } from "./uploads.js";
7
+
8
+ const fileId = "0123456789abcdef0123456789abcdef";
9
+ const dateBucket = "2026-08-09";
10
+ const uploadsRoot = "/srv/uploads";
11
+
12
+ const malicious = [
13
+ "../x",
14
+ "/abs/x",
15
+ ".png/../../y",
16
+ ".p ng",
17
+ ".p\0ng",
18
+ ".\\..\\x",
19
+ "." + "a".repeat(17),
20
+ ".tar.gz",
21
+ ];
22
+
23
+ const legal = ["", ".png", ".PNG", ".mp4", "." + "a".repeat(16)];
24
+
25
+ describe("#527 shared extension-token invariant", () => {
26
+ test("new-upload path rejects every malformed token and accepts the shared legal set", () => {
27
+ for (const ext of malicious) {
28
+ expect(() => buildStoragePath(fileId, ext, { uploadsRoot })).toThrow(/ext .* is invalid/);
29
+ }
30
+ for (const ext of legal) {
31
+ expect(buildStoragePath(fileId, ext, { uploadsRoot }).ext).toBe(ext);
32
+ }
33
+ });
34
+
35
+ test("existing-blob path rejects every malformed token and accepts the shared legal set", () => {
36
+ for (const ext of malicious) {
37
+ expect(() => pathForExistingBlob(dateBucket, fileId, ext, { uploadsRoot })).toThrow(/ext .* is invalid/);
38
+ }
39
+ for (const ext of legal) {
40
+ expect(pathForExistingBlob(dateBucket, fileId, ext, { uploadsRoot }).ext).toBe(ext);
41
+ }
42
+ });
43
+
44
+ test("stored-index gate rejects every malformed token and accepts the shared legal set", () => {
45
+ for (const ext of malicious) {
46
+ expect(validateIndexEntry({ file_id: fileId, date_bucket: dateBucket, ext, size: 0 })).toBe(false);
47
+ }
48
+ for (const ext of legal) {
49
+ expect(validateIndexEntry({ file_id: fileId, date_bucket: dateBucket, ext, size: 0 })).toBe(true);
50
+ }
51
+ });
52
+
53
+ test("all three boundaries fail closed on non-string runtime values", () => {
54
+ for (const ext of [undefined, null, 7, {}, []]) {
55
+ expect(() => buildStoragePath(fileId, ext as never, { uploadsRoot })).toThrow(/ext .* is invalid/);
56
+ expect(() => pathForExistingBlob(dateBucket, fileId, ext as never, { uploadsRoot })).toThrow(/ext .* is invalid/);
57
+ expect(validateIndexEntry({ file_id: fileId, date_bucket: dateBucket, ext, size: 0 })).toBe(false);
58
+ }
59
+ });
60
+ });
@@ -1,23 +1,16 @@
1
1
  // Task #25 — regression pins for ext validation in validateIndexEntry.
2
2
  //
3
- // 🔴 SCOPE (lead d505179d): this suite covers ONLY the ext regex copy
4
- // inside `validateIndexEntry` (uploads.ts). The same-shape regex has
5
- // FOUR copies in this file:
6
- // • L93 sanitizeExt /\.([A-Za-z0-9]{1,16})$/ (client-name parse; no leading-dot anchor, captures group)
7
- // • L141 buildStoragePath /^\.[A-Za-z0-9]{1,16}$/ (upload-path build)
8
- // • L165 pathForExistingBlob /^\.[A-Za-z0-9]{1,16}$/ (download-path build)
9
- // • L219 validateIndexEntry /^\.[A-Za-z0-9]{1,16}$/ ← THIS SUITE
10
- // Mutation reversal proved the other three copies get ZERO coverage
11
- // from this suite (each was widened to `/./` in turn — this suite still
12
- // passed 30/0). See docs/tests/p-25-ext-regression/mutation-red.txt.
13
- // Do NOT read the file name "ext validation regression" as "the ext
14
- // validation is regression-protected" — the ext validation exists in
15
- // four independent copies and only ONE is pinned here.
16
- // Follow-up issue tracks the dedup/alignment evaluation (see PR body).
3
+ // 🔴 SCOPE: this suite exercises the stored-index boundary through
4
+ // `validateIndexEntry`. Issue #527 removed the three independent copies
5
+ // of the stored extension-token grammar: buildStoragePath,
6
+ // pathForExistingBlob and validateIndexEntry now use one shared private
7
+ // validator. `ext-token-shared.test.ts` separately pins all three call
8
+ // sites. sanitizeExt remains intentionally independent because it parses
9
+ // a client filename rather than validating an already-extracted token.
17
10
  //
18
- // Background (通信龙 d01bb8ce): the current regex `/^\.[A-Za-z0-9]{1,16}$/`
19
- // in validateIndexEntry (uploads.ts) correctly rejects 11 known malicious
20
- // ext values (path-escape, traversal, absolute paths, doubles, NUL bytes,
11
+ // Background (通信龙 d01bb8ce): the stored extension-token grammar
12
+ // `/^\.[A-Za-z0-9]{1,16}$/` correctly rejects 11 known malicious ext
13
+ // values (path-escape, traversal, absolute paths, doubles, NUL bytes,
21
14
  // backslash forms, over-length, whitespace). Verified via real-run on
22
15
  // origin/main by lead — 11/11 malicious values → false.
23
16
  //