@cohortapp/agent-sdk 2.17.0 → 2.18.4

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 (526) hide show
  1. package/.claude/settings.json +18 -0
  2. package/.env.example +18 -5
  3. package/README.md +1 -0
  4. package/bin/maestro.mjs +62 -0
  5. package/docs/guides/billing-console-keys.md +60 -0
  6. package/docs/guides/front-door-session.md +54 -9
  7. package/docs/guides/mac-mini.md +20 -25
  8. package/docs/guides/setup-wizard.md +1 -1
  9. package/docs/runbooks/fleet-rollout.md +156 -0
  10. package/docs/runbooks/mac-mini-bootstrap.md +12 -14
  11. package/lib/action-executor.js +19 -3
  12. package/lib/budget-guard.mjs +279 -3
  13. package/lib/channels/base-adapter.mjs +3 -1
  14. package/lib/channels/contract.mjs +2 -1
  15. package/lib/channels/inbox-item.mjs +8 -0
  16. package/lib/claude-bin.mjs +5 -6
  17. package/lib/cli/doctor-checks.mjs +141 -10
  18. package/lib/cli/global-setup-extras.mjs +5 -1
  19. package/lib/cli/inbox.mjs +100 -15
  20. package/lib/cli/seat-auth.mjs +463 -0
  21. package/lib/cli/session.mjs +80 -12
  22. package/lib/collective/capture.mjs +8 -6
  23. package/lib/collective/global-config.mjs +63 -1
  24. package/lib/collective/presence.mjs +142 -5
  25. package/lib/comms/send-gate.mjs +559 -1
  26. package/lib/diagnostics/alerts.mjs +49 -0
  27. package/lib/diagnostics/cadence-output-freshness.mjs +288 -0
  28. package/lib/engine/agents/definitions.mjs +343 -0
  29. package/lib/engine/agents/persist.mjs +275 -0
  30. package/lib/engine/agents/runtime.mjs +748 -0
  31. package/lib/engine/agents/usage.mjs +95 -0
  32. package/lib/engine/auth-status.mjs +139 -0
  33. package/lib/engine/budget.mjs +194 -0
  34. package/lib/engine/cli.mjs +1204 -0
  35. package/lib/engine/commands/index.mjs +269 -0
  36. package/lib/engine/context/budget.mjs +219 -0
  37. package/lib/engine/context/cache.mjs +125 -0
  38. package/lib/engine/context/child-env.mjs +215 -0
  39. package/lib/engine/context/compaction.mjs +342 -0
  40. package/lib/engine/context/images.mjs +90 -0
  41. package/lib/engine/context/instructions.mjs +327 -0
  42. package/lib/engine/context/lazy-instructions.mjs +169 -0
  43. package/lib/engine/context/manager.mjs +182 -0
  44. package/lib/engine/context/real-path.mjs +91 -0
  45. package/lib/engine/context/secret-values.mjs +163 -0
  46. package/lib/engine/context/settings.mjs +274 -0
  47. package/lib/engine/context/stream-input.mjs +159 -0
  48. package/lib/engine/guard.mjs +152 -0
  49. package/lib/engine/hooks.mjs +713 -0
  50. package/lib/engine/loop.mjs +560 -0
  51. package/lib/engine/mcp/client.mjs +254 -0
  52. package/lib/engine/mcp/config.mjs +301 -0
  53. package/lib/engine/mcp/http.mjs +201 -0
  54. package/lib/engine/mcp/index.mjs +146 -0
  55. package/lib/engine/mcp/jsonrpc.mjs +147 -0
  56. package/lib/engine/mcp/naming.mjs +66 -0
  57. package/lib/engine/mcp/resources.mjs +89 -0
  58. package/lib/engine/mcp/results.mjs +133 -0
  59. package/lib/engine/mcp/stdio.mjs +137 -0
  60. package/lib/engine/mcp/supervisor.mjs +116 -0
  61. package/lib/engine/messages.mjs +104 -0
  62. package/lib/engine/output/json.mjs +164 -0
  63. package/lib/engine/output/stream-json.mjs +266 -0
  64. package/lib/engine/permissions.mjs +845 -0
  65. package/lib/engine/process-identity.mjs +164 -0
  66. package/lib/engine/process-tree.mjs +551 -0
  67. package/lib/engine/prompt.mjs +60 -0
  68. package/lib/engine/session/store.mjs +299 -0
  69. package/lib/engine/session-runtime/args.mjs +97 -0
  70. package/lib/engine/session-runtime/host.mjs +143 -0
  71. package/lib/engine/session-runtime/inbox.mjs +122 -0
  72. package/lib/engine/session-runtime/notifications.mjs +129 -0
  73. package/lib/engine/session-runtime/registry.mjs +328 -0
  74. package/lib/engine/session-runtime/runner.mjs +344 -0
  75. package/lib/engine/session-runtime/socket.mjs +212 -0
  76. package/lib/engine/session-runtime/wakeup.mjs +115 -0
  77. package/lib/engine/skills/index.mjs +321 -0
  78. package/lib/engine/tools/bash-background.mjs +533 -0
  79. package/lib/engine/tools/bash.mjs +216 -0
  80. package/lib/engine/tools/edit.mjs +97 -0
  81. package/lib/engine/tools/glob.mjs +81 -0
  82. package/lib/engine/tools/grep.mjs +224 -0
  83. package/lib/engine/tools/index.mjs +84 -0
  84. package/lib/engine/tools/list-agents.mjs +32 -0
  85. package/lib/engine/tools/ls.mjs +127 -0
  86. package/lib/engine/tools/monitor.mjs +82 -0
  87. package/lib/engine/tools/notebook-edit.mjs +218 -0
  88. package/lib/engine/tools/read.mjs +103 -0
  89. package/lib/engine/tools/schedule-wakeup.mjs +45 -0
  90. package/lib/engine/tools/schema.mjs +144 -0
  91. package/lib/engine/tools/send-message.mjs +77 -0
  92. package/lib/engine/tools/session.mjs +70 -0
  93. package/lib/engine/tools/todo.mjs +144 -0
  94. package/lib/engine/tools/toolsearch.mjs +217 -0
  95. package/lib/engine/tools/walk.mjs +193 -0
  96. package/lib/engine/tools/web-switch.mjs +31 -0
  97. package/lib/engine/tools/webfetch-html.mjs +387 -0
  98. package/lib/engine/tools/webfetch-net.mjs +340 -0
  99. package/lib/engine/tools/webfetch.mjs +198 -0
  100. package/lib/engine/tools/websearch.mjs +91 -0
  101. package/lib/engine/tools/workflow.mjs +95 -0
  102. package/lib/engine/tools/write.mjs +76 -0
  103. package/lib/engine/tui/line-editor.mjs +137 -0
  104. package/lib/engine/tui/render.mjs +86 -0
  105. package/lib/engine/tui/tui.mjs +274 -0
  106. package/lib/engine/wire/anthropic-messages.mjs +263 -0
  107. package/lib/engine/wire/effort.mjs +36 -0
  108. package/lib/engine/wire/errors.mjs +496 -0
  109. package/lib/engine/wire/http.mjs +441 -0
  110. package/lib/engine/wire/index.mjs +76 -0
  111. package/lib/engine/wire/openai-chat.mjs +332 -0
  112. package/lib/engine/wire/prompt-cache.mjs +79 -0
  113. package/lib/engine/wire/search.mjs +140 -0
  114. package/lib/engine/wire/sse.mjs +114 -0
  115. package/lib/engine/wire/stall.mjs +349 -0
  116. package/lib/engine/wire/token-provider.mjs +175 -0
  117. package/lib/engine/wire/usage.mjs +192 -0
  118. package/lib/engine/workflow/host.mjs +524 -0
  119. package/lib/engine/workflow/journal.mjs +188 -0
  120. package/lib/engine/workflow/json-schema.mjs +171 -0
  121. package/lib/engine/workflow/meta.mjs +329 -0
  122. package/lib/engine/workflow/notifications.mjs +52 -0
  123. package/lib/engine/workflow/runtime.mjs +447 -0
  124. package/lib/engine/workflow/sandbox.mjs +534 -0
  125. package/lib/engine/workflow/worker.mjs +141 -0
  126. package/lib/engine/workflow/worktree.mjs +74 -0
  127. package/lib/execution/disposition.mjs +1 -1
  128. package/lib/execution/intake.mjs +10 -0
  129. package/lib/execution/surface-policy.mjs +15 -0
  130. package/lib/learning/curator.mjs +8 -6
  131. package/lib/learning/reflect.mjs +8 -6
  132. package/lib/model-router/catalog/cohort.yaml +137 -0
  133. package/lib/model-router/catalog.mjs +118 -1
  134. package/lib/model-router/failover.mjs +67 -16
  135. package/lib/model-router/llm-task.mjs +39 -3
  136. package/lib/model-router/resolve.mjs +89 -3
  137. package/lib/model-router/spawn.mjs +46 -47
  138. package/lib/model-router/taxonomy.mjs +126 -4
  139. package/lib/org/cost-sync.mjs +141 -11
  140. package/lib/org/inbound/broadcast.mjs +289 -0
  141. package/lib/org/inbound/collective.mjs +375 -0
  142. package/lib/org/inbound/directedness.mjs +96 -8
  143. package/lib/org/inbound/facts.mjs +78 -2
  144. package/lib/org/inbound/project.mjs +22 -0
  145. package/lib/org/inbound/surfaces.mjs +14 -0
  146. package/lib/org/llm-token.mjs +879 -0
  147. package/lib/org/mesh.mjs +61 -0
  148. package/lib/org/messaging.mjs +3 -1
  149. package/lib/org/protocol.checksum +1 -1
  150. package/lib/org/protocol.mjs +15 -0
  151. package/lib/org/quota.mjs +520 -0
  152. package/lib/org/tool-surface.mjs +104 -16
  153. package/lib/org/ui-parity.mjs +16 -1
  154. package/lib/org/work-ledger.mjs +37 -6
  155. package/lib/rate-guard.mjs +114 -1
  156. package/lib/resource-governor.mjs +41 -6
  157. package/lib/runtime/adapter.mjs +823 -0
  158. package/lib/runtime/child-env.mjs +191 -0
  159. package/lib/runtime/legacy-shell-guard.mjs +97 -0
  160. package/lib/runtime/seat-engine.mjs +162 -0
  161. package/lib/session/ask-ledger.mjs +271 -0
  162. package/lib/session/current-work.mjs +676 -0
  163. package/lib/session/feed-core.mjs +40 -3
  164. package/lib/session/launch-args.mjs +56 -4
  165. package/lib/session/status-summary.mjs +26 -9
  166. package/lib/session/upgrade-notice.mjs +42 -0
  167. package/lib/setup/claude-probe.mjs +117 -13
  168. package/lib/setup/enrich.mjs +13 -10
  169. package/lib/setup/sections/model.mjs +39 -13
  170. package/lib/telemetry/collect.mjs +208 -9
  171. package/lib/upgrade/ignored-drift.mjs +105 -0
  172. package/lib/voice/post-call-brief.mjs +30 -17
  173. package/package.json +13 -3
  174. package/plugins/maestro-skills/skills/board-work.md +5 -0
  175. package/plugins/maestro-skills/skills/inbound-triage.md +56 -15
  176. package/plugins/maestro-skills/skills/main-session.md +18 -7
  177. package/scripts/ci/check-tarball-fidelity.mjs +126 -2
  178. package/scripts/ci/run-tests.mjs +47 -19
  179. package/scripts/cohort-llm/api-key-helper.mjs +92 -0
  180. package/scripts/collective/hook-runner.mjs +29 -2
  181. package/scripts/continuous-monitor.sh +13 -0
  182. package/scripts/cost/track-claude-usage.mjs +15 -0
  183. package/scripts/daemon/agent-daemon.mjs +408 -20
  184. package/scripts/daemon/assurance.mjs +48 -12
  185. package/scripts/daemon/cadence-consumer.mjs +218 -68
  186. package/scripts/daemon/cadence-handlers.mjs +73 -4
  187. package/scripts/daemon/classifier.mjs +75 -26
  188. package/scripts/daemon/context-compiler.mjs +51 -37
  189. package/scripts/daemon/deliver.mjs +30 -1
  190. package/scripts/daemon/dispatcher.mjs +595 -149
  191. package/scripts/daemon/health.mjs +14 -1
  192. package/scripts/daemon/maestro-daemon.mjs +11 -0
  193. package/scripts/daemon/prompt-builder.mjs +24 -0
  194. package/scripts/daemon/responder.mjs +246 -79
  195. package/scripts/daemon/sdk-version.mjs +98 -16
  196. package/scripts/eval/probe-gateway.mjs +635 -0
  197. package/scripts/eval/replay/extract.mjs +270 -0
  198. package/scripts/eval/replay/grade.mjs +260 -0
  199. package/scripts/eval/replay/lib/config.mjs +50 -0
  200. package/scripts/eval/replay/lib/effects.mjs +65 -0
  201. package/scripts/eval/replay/lib/fixture.mjs +188 -0
  202. package/scripts/eval/replay/lib/judge.mjs +72 -0
  203. package/scripts/eval/replay/lib/redact.mjs +136 -0
  204. package/scripts/eval/replay/lib/sandbox.mjs +170 -0
  205. package/scripts/eval/replay/lib/schema-check.mjs +63 -0
  206. package/scripts/eval/replay/lib/transcript.mjs +76 -0
  207. package/scripts/eval/replay/mcp-replay-stub.mjs +101 -0
  208. package/scripts/eval/replay/report.mjs +185 -0
  209. package/scripts/eval/replay/run.mjs +404 -0
  210. package/scripts/fleet/rollout.mjs +1094 -0
  211. package/scripts/hooks/pre-send-audit.sh +36 -245
  212. package/scripts/hooks/pre-write-yaml-validate.mjs +275 -0
  213. package/scripts/hooks/validate-state-yaml.sh +190 -0
  214. package/scripts/huddle/huddle-llm.mjs +361 -0
  215. package/scripts/huddle/huddle-server.mjs +46 -121
  216. package/scripts/local-triggers/autoupdate.sh +448 -78
  217. package/scripts/local-triggers/run-trigger.sh +13 -0
  218. package/scripts/maintenance/pin-integrity.mjs +364 -0
  219. package/scripts/poll-slack-events.sh +41 -9
  220. package/scripts/poller/slack-socket-mode.mjs +28 -3
  221. package/scripts/session/supervisor.mjs +80 -13
  222. package/scripts/spawn-session.sh +13 -0
  223. package/bin/maestro.test.mjs +0 -1574
  224. package/lib/action-executor.test.mjs +0 -871
  225. package/lib/archetype.test.mjs +0 -132
  226. package/lib/assurance/plan-note.test.mjs +0 -234
  227. package/lib/assurance/room-budget.test.mjs +0 -486
  228. package/lib/assurance/tier.test.mjs +0 -174
  229. package/lib/autonomy.test.mjs +0 -66
  230. package/lib/backlog.test.mjs +0 -302
  231. package/lib/backup/policy.test.mjs +0 -305
  232. package/lib/budget-escalate.test.mjs +0 -232
  233. package/lib/budget-guard.envelope.test.mjs +0 -476
  234. package/lib/budget-guard.test.mjs +0 -427
  235. package/lib/cadence-bus-requeue.test.mjs +0 -83
  236. package/lib/cadence-bus-schedule.test.mjs +0 -194
  237. package/lib/cadence-bus.test.mjs +0 -720
  238. package/lib/cadences.test.mjs +0 -230
  239. package/lib/capability/inventory.test.mjs +0 -232
  240. package/lib/capability.test.mjs +0 -78
  241. package/lib/channels/base-adapter.test.mjs +0 -590
  242. package/lib/channels/channels.test.mjs +0 -371
  243. package/lib/channels/contract.test.mjs +0 -162
  244. package/lib/channels/inbox-item.test.mjs +0 -368
  245. package/lib/channels/orgmail/adapter.test.mjs +0 -448
  246. package/lib/channels/pairing.test.mjs +0 -270
  247. package/lib/channels/repeat-suppressor.test.mjs +0 -134
  248. package/lib/channels/slack-adapter.test.mjs +0 -212
  249. package/lib/channels/telegram-adapter.test.mjs +0 -306
  250. package/lib/channels/voice/adapter.test.mjs +0 -278
  251. package/lib/channels/whatsapp/adapter-baileys.test.mjs +0 -359
  252. package/lib/channels/whatsapp/baileys-typing.test.mjs +0 -154
  253. package/lib/charter.test.mjs +0 -89
  254. package/lib/claude-bin.test.mjs +0 -131
  255. package/lib/cli/board.test.mjs +0 -227
  256. package/lib/cli/design.test.mjs +0 -270
  257. package/lib/cli/doctor-checks.test.mjs +0 -336
  258. package/lib/cli/global-setup-extras.test.mjs +0 -462
  259. package/lib/cli/inbox.test.mjs +0 -230
  260. package/lib/cli/session-ack.test.mjs +0 -63
  261. package/lib/cli/session.test.mjs +0 -613
  262. package/lib/collective/capture.test.mjs +0 -121
  263. package/lib/collective/cards.test.mjs +0 -114
  264. package/lib/collective/config.test.mjs +0 -123
  265. package/lib/collective/global-config.test.mjs +0 -220
  266. package/lib/collective/global-skills.test.mjs +0 -126
  267. package/lib/collective/presence.test.mjs +0 -95
  268. package/lib/collective/recall.test.mjs +0 -116
  269. package/lib/collective/vendor-skills.test.mjs +0 -306
  270. package/lib/comms/send-gate.test.mjs +0 -770
  271. package/lib/comms.test.mjs +0 -41
  272. package/lib/context/budget.test.mjs +0 -252
  273. package/lib/context/history-scope.test.mjs +0 -79
  274. package/lib/cost/ledger-row.test.mjs +0 -183
  275. package/lib/design/design-md.test.mjs +0 -318
  276. package/lib/design/fixtures/DESIGN.golden.md +0 -238
  277. package/lib/design/fixtures/PRODUCT.golden.md +0 -67
  278. package/lib/design/fixtures/foundation.json +0 -133
  279. package/lib/design/refresh-gate.test.mjs +0 -144
  280. package/lib/design/write.test.mjs +0 -241
  281. package/lib/diagnostics/alerts.test.mjs +0 -318
  282. package/lib/diagnostics/backup-freshness.test.mjs +0 -185
  283. package/lib/diagnostics/counters.test.mjs +0 -206
  284. package/lib/diagnostics/events.test.mjs +0 -290
  285. package/lib/diagnostics/otel.test.mjs +0 -196
  286. package/lib/diagnostics/trace.test.mjs +0 -251
  287. package/lib/env-compat.test.mjs +0 -104
  288. package/lib/execution/disposition.test.mjs +0 -553
  289. package/lib/execution/drive.test.mjs +0 -270
  290. package/lib/execution/effects.test.mjs +0 -344
  291. package/lib/execution/intake.test.mjs +0 -389
  292. package/lib/execution/journal.test.mjs +0 -261
  293. package/lib/execution/match.test.mjs +0 -235
  294. package/lib/execution/pipeline.test.mjs +0 -392
  295. package/lib/execution/route.test.mjs +0 -186
  296. package/lib/execution/surface-policy.test.mjs +0 -162
  297. package/lib/fs-atomic.test.mjs +0 -72
  298. package/lib/fs-ownership.test.mjs +0 -158
  299. package/lib/goals/admission.test.mjs +0 -164
  300. package/lib/goals/classify.test.mjs +0 -167
  301. package/lib/goals/collaborate.test.mjs +0 -336
  302. package/lib/goals/gaps.test.mjs +0 -284
  303. package/lib/goals/loop.test.mjs +0 -845
  304. package/lib/hooks/bus.test.mjs +0 -387
  305. package/lib/identity/persona.test.mjs +0 -142
  306. package/lib/kpi-sensors.test.mjs +0 -278
  307. package/lib/kpi.test.mjs +0 -244
  308. package/lib/learning/config.test.mjs +0 -75
  309. package/lib/learning/counters.test.mjs +0 -69
  310. package/lib/learning/curator-consolidate.test.mjs +0 -238
  311. package/lib/learning/curator.test.mjs +0 -106
  312. package/lib/learning/reflect.test.mjs +0 -0
  313. package/lib/learning/session-index.test.mjs +0 -125
  314. package/lib/learning/skill-writer.test.mjs +0 -210
  315. package/lib/mandate/audit.test.mjs +0 -195
  316. package/lib/mandate/contract.test.mjs +0 -185
  317. package/lib/mandate/derive.test.mjs +0 -274
  318. package/lib/mandate/model.test.mjs +0 -164
  319. package/lib/mandate/refresh.test.mjs +0 -389
  320. package/lib/mcp/server.test.mjs +0 -426
  321. package/lib/model-router/auth-profiles.test.mjs +0 -580
  322. package/lib/model-router/catalog.test.mjs +0 -385
  323. package/lib/model-router/economics.test.mjs +0 -438
  324. package/lib/model-router/failover.test.mjs +0 -439
  325. package/lib/model-router/health.test.mjs +0 -338
  326. package/lib/model-router/integration-coverage.test.mjs +0 -831
  327. package/lib/model-router/integration.test.mjs +0 -564
  328. package/lib/model-router/ledger.test.mjs +0 -415
  329. package/lib/model-router/llm-task.test.mjs +0 -392
  330. package/lib/model-router/org-credentials.test.mjs +0 -265
  331. package/lib/model-router/pricing-refresh.test.mjs +0 -286
  332. package/lib/model-router/reconcile.test.mjs +0 -316
  333. package/lib/model-router/repair.test.mjs +0 -180
  334. package/lib/model-router/spawn.test.mjs +0 -446
  335. package/lib/model-router/taxonomy.test.mjs +0 -410
  336. package/lib/model-router.test.mjs +0 -1207
  337. package/lib/org/activity.test.mjs +0 -134
  338. package/lib/org/approvals.test.mjs +0 -216
  339. package/lib/org/awareness.test.mjs +0 -159
  340. package/lib/org/board-mine-cache.test.mjs +0 -53
  341. package/lib/org/board.test.mjs +0 -187
  342. package/lib/org/bootstrap-context.test.mjs +0 -153
  343. package/lib/org/client.test.mjs +0 -1206
  344. package/lib/org/cohort-client.test.mjs +0 -126
  345. package/lib/org/cost-sync.test.mjs +0 -153
  346. package/lib/org/doctor.test.mjs +0 -346
  347. package/lib/org/engagement-ledger.test.mjs +0 -112
  348. package/lib/org/engagement.test.mjs +0 -739
  349. package/lib/org/handoff.test.mjs +0 -269
  350. package/lib/org/inbound/directedness.test.mjs +0 -668
  351. package/lib/org/inbound/facts.test.mjs +0 -471
  352. package/lib/org/inbound/hydrate.test.mjs +0 -908
  353. package/lib/org/inbound/index.test.mjs +0 -429
  354. package/lib/org/inbound/project.test.mjs +0 -287
  355. package/lib/org/integration-tools.test.mjs +0 -160
  356. package/lib/org/keys.test.mjs +0 -92
  357. package/lib/org/knowledge.test.mjs +0 -326
  358. package/lib/org/leases.test.mjs +0 -235
  359. package/lib/org/mesh-directives.test.mjs +0 -110
  360. package/lib/org/mesh-integration.test.mjs +0 -127
  361. package/lib/org/mesh.test.mjs +0 -400
  362. package/lib/org/messaging.test.mjs +0 -471
  363. package/lib/org/param-contract.test.mjs +0 -477
  364. package/lib/org/policy.test.mjs +0 -237
  365. package/lib/org/protocol.checksum.test.mjs +0 -90
  366. package/lib/org/protocol.test.mjs +0 -323
  367. package/lib/org/push.test.mjs +0 -792
  368. package/lib/org/registry.test.mjs +0 -100
  369. package/lib/org/resource-tools.test.mjs +0 -361
  370. package/lib/org/tool-access.test.mjs +0 -144
  371. package/lib/org/tool-surface-integration.test.mjs +0 -120
  372. package/lib/org/tool-surface.test.mjs +0 -1268
  373. package/lib/org/typing.test.mjs +0 -291
  374. package/lib/org/ui-parity.test.mjs +0 -560
  375. package/lib/org/verify.test.mjs +0 -194
  376. package/lib/org/work-ledger.test.mjs +0 -273
  377. package/lib/plan/adoption-e2e.test.mjs +0 -366
  378. package/lib/plan/budget-enforcement.test.mjs +0 -400
  379. package/lib/plan/compile.test.mjs +0 -382
  380. package/lib/plan/emit.test.mjs +0 -269
  381. package/lib/plan/explain.test.mjs +0 -188
  382. package/lib/prompts/parallelism.test.mjs +0 -177
  383. package/lib/rag/rag.test.mjs +0 -505
  384. package/lib/rate-guard.test.mjs +0 -272
  385. package/lib/reactive-gate.test.mjs +0 -57
  386. package/lib/render.test.mjs +0 -68
  387. package/lib/resource-governor.test.mjs +0 -488
  388. package/lib/scheduling/dynamic-jobs.test.mjs +0 -344
  389. package/lib/scheduling/jitter.test.mjs +0 -140
  390. package/lib/secrets/broker.test.mjs +0 -280
  391. package/lib/secrets/providers.test.mjs +0 -274
  392. package/lib/security/audit-engine.test.mjs +0 -424
  393. package/lib/security/coerce-args.test.mjs +0 -281
  394. package/lib/security/dangerous-tools.test.mjs +0 -68
  395. package/lib/security/external-content.test.mjs +0 -84
  396. package/lib/security/redact.test.mjs +0 -441
  397. package/lib/security/secret-equal.test.mjs +0 -55
  398. package/lib/session/config.test.mjs +0 -92
  399. package/lib/session/feed-core.test.mjs +0 -198
  400. package/lib/session/first-run.test.mjs +0 -121
  401. package/lib/session/frontdoor.test.mjs +0 -205
  402. package/lib/session/handoffs.test.mjs +0 -183
  403. package/lib/session/identity.test.mjs +0 -180
  404. package/lib/session/inbox-claims.test.mjs +0 -286
  405. package/lib/session/launch-args.test.mjs +0 -157
  406. package/lib/session/liveness.test.mjs +0 -100
  407. package/lib/session/status-summary.test.mjs +0 -118
  408. package/lib/session-permissions.test.mjs +0 -120
  409. package/lib/setup/claude-probe.test.mjs +0 -187
  410. package/lib/setup/completeness.test.mjs +0 -110
  411. package/lib/setup/context-pack.test.mjs +0 -89
  412. package/lib/setup/enrich.test.mjs +0 -115
  413. package/lib/setup/enroll-from-cohort.test.mjs +0 -300
  414. package/lib/setup/integration.test.mjs +0 -162
  415. package/lib/setup/io.test.mjs +0 -77
  416. package/lib/setup/runner.test.mjs +0 -132
  417. package/lib/setup/sections/identity.test.mjs +0 -234
  418. package/lib/setup/sections/inventory.test.mjs +0 -198
  419. package/lib/setup/sections/learning.test.mjs +0 -81
  420. package/lib/setup/sections/mandate.test.mjs +0 -388
  421. package/lib/setup/sections/messaging.test.mjs +0 -127
  422. package/lib/setup/sections/model.test.mjs +0 -240
  423. package/lib/setup/sections/org.test.mjs +0 -346
  424. package/lib/setup/sections/orgmail.test.mjs +0 -118
  425. package/lib/setup/sections/recovery.test.mjs +0 -98
  426. package/lib/setup/sections/subagents.test.mjs +0 -429
  427. package/lib/setup/sections/verify.test.mjs +0 -175
  428. package/lib/setup/sot.test.mjs +0 -81
  429. package/lib/setup/state.test.mjs +0 -115
  430. package/lib/singleton.test.mjs +0 -151
  431. package/lib/subagents/cli.test.mjs +0 -389
  432. package/lib/subagents/client.test.mjs +0 -309
  433. package/lib/subagents/gap.test.mjs +0 -234
  434. package/lib/subagents/lock.test.mjs +0 -248
  435. package/lib/subagents/manifest.test.mjs +0 -175
  436. package/lib/subagents/refs.test.mjs +0 -204
  437. package/lib/subagents/resolve.test.mjs +0 -422
  438. package/lib/subagents/schema.test.mjs +0 -328
  439. package/lib/telemetry/alerts.test.mjs +0 -109
  440. package/lib/telemetry/collect.test.mjs +0 -1274
  441. package/lib/tool-definitions-integration.test.mjs +0 -83
  442. package/lib/tool-definitions.test.mjs +0 -437
  443. package/lib/upgrade/global-refresh.test.mjs +0 -65
  444. package/lib/upgrade/launchd-reconcile.test.mjs +0 -272
  445. package/lib/upgrade/post-steps.test.mjs +0 -200
  446. package/lib/upgrade/verify.test.mjs +0 -164
  447. package/lib/util/fetch-timeout.test.mjs +0 -202
  448. package/lib/util/reconnect.test.mjs +0 -369
  449. package/lib/util/unhandled.test.mjs +0 -216
  450. package/lib/voice/outbound.test.mjs +0 -69
  451. package/lib/voice/session-rotation.test.mjs +0 -114
  452. package/lib/voice/stt.test.mjs +0 -226
  453. package/lib/voice/voice.test.mjs +0 -990
  454. package/scripts/cadence/enqueue-cadence-tick.test.mjs +0 -187
  455. package/scripts/ci/check-docs-accuracy.test.mjs +0 -409
  456. package/scripts/ci/check-durable-write-seam.test.mjs +0 -90
  457. package/scripts/ci/check-no-build-artifacts.test.mjs +0 -71
  458. package/scripts/ci/check-no-residual-identity.test.mjs +0 -202
  459. package/scripts/ci/check-skill-packs.test.mjs +0 -495
  460. package/scripts/ci/check-subagent-frontmatter.test.mjs +0 -124
  461. package/scripts/ci/check.test.mjs +0 -194
  462. package/scripts/ci/conformance-org-api.test.mjs +0 -425
  463. package/scripts/cloud-relay/voice/relay-identity.test.mjs +0 -96
  464. package/scripts/collective/hook-runner.test.mjs +0 -173
  465. package/scripts/cost/fleet-digest.test.mjs +0 -207
  466. package/scripts/cost/track-claude-usage-pricing.test.mjs +0 -183
  467. package/scripts/cost/track-claude-usage.test.mjs +0 -148
  468. package/scripts/daemon/agent-daemon-board-mine.test.mjs +0 -96
  469. package/scripts/daemon/agent-daemon-design.test.mjs +0 -238
  470. package/scripts/daemon/agent-daemon-frontdoor.test.mjs +0 -60
  471. package/scripts/daemon/agent-daemon.test.mjs +0 -995
  472. package/scripts/daemon/assurance-e2e.test.mjs +0 -613
  473. package/scripts/daemon/assurance.test.mjs +0 -1791
  474. package/scripts/daemon/board-mirror.test.mjs +0 -165
  475. package/scripts/daemon/cadence-consumer-frontdoor.test.mjs +0 -393
  476. package/scripts/daemon/cadence-consumer-governance.test.mjs +0 -276
  477. package/scripts/daemon/cadence-consumer.test.mjs +0 -776
  478. package/scripts/daemon/cadence-handlers.test.mjs +0 -837
  479. package/scripts/daemon/classifier-identity.test.mjs +0 -137
  480. package/scripts/daemon/classifier.test.mjs +0 -266
  481. package/scripts/daemon/classify-kind.test.mjs +0 -40
  482. package/scripts/daemon/context-compiler.test.mjs +0 -406
  483. package/scripts/daemon/deliver.test.mjs +0 -564
  484. package/scripts/daemon/dispatcher-cooldown.test.mjs +0 -122
  485. package/scripts/daemon/dispatcher-governance.test.mjs +0 -1013
  486. package/scripts/daemon/dispatcher-resume.test.mjs +0 -166
  487. package/scripts/daemon/dispatcher-session-continuity.test.mjs +0 -365
  488. package/scripts/daemon/execution-ladder.test.mjs +0 -470
  489. package/scripts/daemon/goal-steward-cadence.test.mjs +0 -312
  490. package/scripts/daemon/inbox-deferral-session.test.mjs +0 -49
  491. package/scripts/daemon/inbox-deferral.test.mjs +0 -336
  492. package/scripts/daemon/inbox-wake.test.mjs +0 -199
  493. package/scripts/daemon/integration.test.mjs +0 -149
  494. package/scripts/daemon/lib/self-echo.test.mjs +0 -153
  495. package/scripts/daemon/lib/session-router.test.mjs +0 -554
  496. package/scripts/daemon/prompt-builder-preamble.test.mjs +0 -210
  497. package/scripts/daemon/prompt-builder.test.mjs +0 -556
  498. package/scripts/daemon/responder-cost.test.mjs +0 -68
  499. package/scripts/daemon/responder-history.test.mjs +0 -221
  500. package/scripts/daemon/sdk-version.test.mjs +0 -31
  501. package/scripts/daemon/session-lock.test.mjs +0 -252
  502. package/scripts/daemon/session-outcomes.test.mjs +0 -533
  503. package/scripts/daemon/typing-registry.test.mjs +0 -102
  504. package/scripts/hooks/pre-send-audit.test.mjs +0 -354
  505. package/scripts/huddle/huddle-prompt.test.mjs +0 -176
  506. package/scripts/local-triggers/autoupdate.test.mjs +0 -518
  507. package/scripts/local-triggers/generate-plists.test.mjs +0 -456
  508. package/scripts/media-generation/brand-clause.test.mjs +0 -135
  509. package/scripts/org/send-orgmail.first-contact.test.mjs +0 -102
  510. package/scripts/poller/inbox-privilege-injection.test.mjs +0 -167
  511. package/scripts/poller/inbox-scan-poller.test.mjs +0 -295
  512. package/scripts/poller/lib/cloud-relay-dedup.test.mjs +0 -133
  513. package/scripts/poller/slack-socket-mode.test.mjs +0 -805
  514. package/scripts/poller-launchd/install.test.mjs +0 -243
  515. package/scripts/restore-from-backup.test.mjs +0 -181
  516. package/scripts/session/feed.test.mjs +0 -196
  517. package/scripts/session/supervisor-sh.test.mjs +0 -218
  518. package/scripts/session/supervisor.test.mjs +0 -482
  519. package/scripts/setup/configure-macos.test.mjs +0 -306
  520. package/scripts/setup/gen-subagent-manifest.test.mjs +0 -124
  521. package/scripts/setup/generate-agent-package-json.test.mjs +0 -143
  522. package/scripts/setup/generate-capability.test.mjs +0 -134
  523. package/scripts/setup/init-agent.test.mjs +0 -370
  524. package/scripts/setup/init-skill-marketplace.test.mjs +0 -193
  525. package/scripts/vendor/sync-skill-packs.test.mjs +0 -103
  526. package/scripts/watchdog/memory-watchdog.test.mjs +0 -64
@@ -1,613 +0,0 @@
1
- /**
2
- * assurance-e2e.test.mjs — the owner's four scenarios, end to end, through the
3
- * REAL daemon.
4
- *
5
- * Run: node --test scripts/daemon/assurance-e2e.test.mjs
6
- * Read the story: ASSURANCE_TRANSCRIPT=1 node --test scripts/daemon/assurance-e2e.test.mjs
7
- *
8
- * This drives `agent-daemon.processItem` itself — the real classifier gate, the
9
- * real acknowledgement decision, the real obligation ledger, the real
10
- * settle-on-close logic, the real sweep. Only the two things that would cost
11
- * money or touch a live workspace are injected fakes:
12
- *
13
- * * `dispatch` — instead of spawning a `claude` child, the fake invokes
14
- * `onClose` with the exit code the scenario is about.
15
- * * transport — instead of posting to Cohort/Slack, it appends to a
16
- * transcript so the test can assert on the exact words a
17
- * human would read.
18
- *
19
- * NOTHING here posts to the live workspace, spawns a model, or writes to the
20
- * database. The four scenarios are the four the brief names: a fast ask, a slow
21
- * ask, a timing-out session, and a crashing session — plus the one the old code
22
- * could not even detect, a session that exits 0 having said nothing.
23
- */
24
-
25
- import { test, before, after } from "node:test";
26
- import assert from "node:assert/strict";
27
- import { register } from "node:module";
28
- import { mkdtempSync, mkdirSync, writeFileSync, rmSync } from "node:fs";
29
- import { join } from "node:path";
30
- import { tmpdir } from "node:os";
31
-
32
- // The daemon statically pulls in the agent-only `imapflow` dep via the gmail
33
- // poller; stub it so the real daemon module can be imported in CI.
34
- const loaderSrc = `
35
- export async function resolve(specifier, context, next) {
36
- if (specifier === "imapflow") return { url: "imapflow-stub:main", shortCircuit: true };
37
- return next(specifier, context);
38
- }
39
- export async function load(url, context, next) {
40
- if (url === "imapflow-stub:main") return { format: "module", shortCircuit: true, source: "export class ImapFlow {}" };
41
- return next(url, context);
42
- }
43
- `;
44
- register(`data:text/javascript,${encodeURIComponent(loaderSrc)}`);
45
-
46
- const AGENT_DIR = mkdtempSync(join(tmpdir(), "maestro-assurance-e2e-"));
47
- process.env.AGENT_DIR = AGENT_DIR;
48
- process.env.AGENT_ROOT = AGENT_DIR;
49
- process.env.MAESTRO_DAEMON_NO_AUTOSTART = "1";
50
- // HERMETICITY. `receipts.recordOutbound` attributes a send to an obligation and
51
- // a session from AMBIENT ENV when the caller does not name them — the seam that
52
- // lets a CLI send lane inside a spawned session attribute itself. Run this file
53
- // from inside a live maestro session and those variables are inherited, so the
54
- // receipt SCENARIO 2 writes to prove "the session answered" is stamped with a
55
- // DIFFERENT debt's key and reads back as `attributed-elsewhere`. The scenario
56
- // then fails on a real machine and passes on a bare CI runner, which is the
57
- // wrong way round for a test to be environment-sensitive.
58
- delete process.env.MAESTRO_OBLIGATION_KEY;
59
- delete process.env.MAESTRO_SESSION_ID;
60
- delete process.env.AGENT_SESSION_ID;
61
-
62
- let daemon, assurance, receipts;
63
-
64
- before(async () => {
65
- mkdirSync(join(AGENT_DIR, "state", "inbox", "cohort"), { recursive: true });
66
- mkdirSync(join(AGENT_DIR, "state", "sessions", "locks"), { recursive: true });
67
- daemon = await import("./agent-daemon.mjs");
68
- assurance = await import("./assurance.mjs");
69
- receipts = await import("../../lib/comms/receipts.mjs");
70
- });
71
-
72
- after(() => { try { rmSync(AGENT_DIR, { recursive: true, force: true }); } catch { /* */ } });
73
-
74
- // ---------------------------------------------------------------------------
75
- // Transcript: what the human sees, and when
76
- // ---------------------------------------------------------------------------
77
-
78
- const SHOW = process.env.ASSURANCE_TRANSCRIPT === "1";
79
- let transcript = [];
80
- let t0 = 0;
81
-
82
- function beginScenario(title, ask) {
83
- transcript = [];
84
- t0 = Date.now();
85
- if (SHOW) {
86
- console.log(`\n${"═".repeat(78)}\n ${title}\n${"═".repeat(78)}`);
87
- console.log(` [ 0.00s] OWNER → ${ask}`);
88
- }
89
- }
90
-
91
- /** Record a message the human would receive, at a stated virtual offset. */
92
- function heard(kind, text, virtualMs = null) {
93
- const realMs = Date.now() - t0;
94
- transcript.push({ kind, text, ms: realMs, virtualMs });
95
- if (SHOW) {
96
- const stamp = virtualMs != null
97
- ? `+${(virtualMs / 60000).toFixed(1)}min`
98
- : `${(realMs / 1000).toFixed(2)}s`;
99
- console.log(` [${String(stamp).padStart(8)}] ISLA → ${text.replace(/\n/g, "\n ")}`);
100
- }
101
- }
102
-
103
- function note(text, virtualMs = null) {
104
- if (!SHOW) return;
105
- const stamp = virtualMs != null ? `+${(virtualMs / 60000).toFixed(1)}min` : `${((Date.now() - t0) / 1000).toFixed(2)}s`;
106
- console.log(` [${String(stamp).padStart(8)}] ····· (${text})`);
107
- }
108
-
109
- /** A transport fake that feeds the transcript. Never touches a network. */
110
- function transport(virtualClock = () => null) {
111
- return async (item, text, o = {}) => {
112
- heard(o.kind || "reply", text, virtualClock());
113
- return { sent: true, via: "fake", channel: item.channel_id || item.channel };
114
- };
115
- }
116
-
117
- /** The daemon's ack seam, shaped exactly like responder.sendHoldingMessage:
118
- * the line is GENERATED (here through the REAL generateAck with an injected
119
- * runner — no spawn in tests), and a failed generation means silence, never
120
- * a canned fallback. */
121
- function ackSeam(runImpl) {
122
- return async (item, classResult) => {
123
- const text = await assurance.generateAck(item, classResult, {
124
- runImpl: runImpl || (async () => "Taking the git fixes now — push coming shortly."),
125
- });
126
- if (text == null) return { sent: false, holdingText: null, error: "ack_generation_failed", genFailed: true };
127
- heard("ack", text);
128
- return { sent: true, holdingText: text, via: "fake" };
129
- };
130
- }
131
-
132
- /**
133
- * Each scenario gets its OWN channel id. The daemon's per-thread lock and
134
- * request-claim would otherwise (correctly) suppress the second and subsequent
135
- * asks as duplicates of a conversation already in flight — real behaviour, but
136
- * orthogonal to what these scenarios are proving.
137
- */
138
- function makeItem(id, content) {
139
- const channelId = `CDM-${id}`;
140
- const item = {
141
- id,
142
- raw_ref: `cohort:${channelId}:${id}`,
143
- message_id: id,
144
- service: "cohort",
145
- channel: "dm/owner",
146
- channel_id: channelId,
147
- is_dm: true,
148
- sender: "the owner",
149
- content,
150
- };
151
- // The poll filter expects a live inbox file for markProcessed to act on.
152
- writeFileSync(join(AGENT_DIR, "state", "inbox", "cohort", `${id}.yaml`), `id: ${id}\n`);
153
- return item;
154
- }
155
-
156
- /**
157
- * Every scenario injects both seams that would otherwise spawn: `dispatch` (no
158
- * child process) and `sendHoldingMessage` (the ack line comes from an injected
159
- * runner). No scenario in this file ever needs the real `claude` binary.
160
- *
161
- * The daemon's ack path is nevertheless gated on `claudeAvailable()` — a
162
- * NECESSARY production fail-safe (never post "on it" when the CLI that would
163
- * answer cannot start). Left to the real probe, that gate reads a fact about
164
- * the MACHINE, not about the scenario: these tests pass on a developer box with
165
- * the CLI installed and suppress every acknowledgement on a CI runner without
166
- * it. That is precisely how SCENARIOS 2, 3 and 6 came to be red on main and
167
- * green everywhere they were written. The premise is declared here instead.
168
- *
169
- * The gate's false branch is not untested by this — see "the ack is suppressed
170
- * when the CLI is unavailable" at the end of this file.
171
- */
172
- const CLI_PRESENT = () => true;
173
-
174
- const COMPLEX = {
175
- priority: "critical", action: "respond", model: "opus", category: "action_required",
176
- directed_at_agent: true, summary: "Fix the issues you just noted and push the fixes to git",
177
- };
178
-
179
- // ===========================================================================
180
- // SCENARIO 1 — A FAST ASK. Answered directly. No "let me look into it".
181
- // ===========================================================================
182
-
183
- test("SCENARIO 1 — a fast ask gets a direct answer, with no pointless holding message", async () => {
184
- const ask = "what time is the board call on Thursday?";
185
- beginScenario("SCENARIO 1 — FAST ASK", ask);
186
- const item = makeItem("FAST-1", ask);
187
-
188
- let holdingCalls = 0;
189
- await daemon.processItem(item, "cohort", {
190
- claudeAvailable: CLI_PRESENT,
191
- classify: async () => ({ priority: "normal", action: "respond", model: "sonnet", category: "question", directed_at_agent: true, summary: "board call time" }),
192
- isQuickReply: () => true,
193
- sendQuickResponse: async (it) => {
194
- heard("reply", "Thursday's board call is at 14:00 UK — calendar invite went out last week.");
195
- return { sent: true, text: "…", channel: it.channel_id };
196
- },
197
- sendHoldingMessage: async () => { holdingCalls++; return { sent: true, holdingText: "x" }; },
198
- dispatch: () => { throw new Error("a fast ask must not spawn a session"); },
199
- });
200
-
201
- assert.equal(holdingCalls, 0, "a simple ask must NOT be told 'I'll look into it' before its answer");
202
- assert.equal(transcript.length, 1, "exactly one message: the answer");
203
- assert.equal(transcript[0].kind, "reply");
204
- assert.ok(transcript[0].ms < 1000, `answered in ${transcript[0].ms}ms`);
205
- assert.equal(assurance.openObligations().length, 0, "nothing is owed — the ask is already discharged");
206
- note("no obligation opened: the answer already went out");
207
- });
208
-
209
- // ===========================================================================
210
- // SCENARIO 2 — A SLOW ASK. Silent for ninety seconds, one line, then answered.
211
- //
212
- // WHY THIS SCENARIO CHANGED ON 2026-09-12, AND WHY THE PROGRESS PING IS GONE
213
- //
214
- // It used to assert an acknowledgement at t≈0 and EXACTLY ONE progress ping at
215
- // six minutes. Both assertions were faithful to the code and both encoded the
216
- // defect that code had become.
217
- //
218
- // Measured over fourteen days in org_default_adaptic: 10,667 agent messages, of
219
- // which 3,069 (28.8%) were opening acknowledgements and 961 (9.0%) were progress
220
- // nags — 37.8% of everything this fleet said carried no content at all. 272 of
221
- // those acknowledgements were never followed by a substantive reply inside an
222
- // hour, i.e. the promise in them ("I'll come back as soon as I've got
223
- // something") was simply not kept. Agent-to-human volume went from 2:1 to 158:1
224
- // in a fortnight, and 9,187 of ~11,400 messages in 21 days landed in ONE
225
- // channel from eight agents, ~45% of them exact duplicates. Sampled live at
226
- // 06:32Z: "Still on this — 5 minutes in" beside "Still going — 15 minutes in"
227
- // at the SAME timestamp, two independent per-obligation timers narrating one
228
- // piece of overlapping work.
229
- //
230
- // The progress ping could not have been better written. `composeProgress` was a
231
- // pure function of `now - openedAt`; nothing read the session's stdout, its
232
- // tool calls or its partial findings, so the message could not contain anything
233
- // a reader could not already see on the clock. A message that says only what
234
- // the timestamp says is not an update. It is deleted, and this scenario now
235
- // asserts that NONE is emitted — not because the assertion was wrong about the
236
- // code, but because the behaviour it pinned was the bug.
237
- //
238
- // What replaces it: silence below ACK_AFTER_MS (the typing indicator is the
239
- // acknowledgement), then AT MOST ONE bespoke line, and only if the room has not
240
- // already heard one inside its budget window. Beyond that the agent either says
241
- // something with content in it — the plan the session itself stated — or it says
242
- // nothing and lets the answer be the answer.
243
- // ===========================================================================
244
-
245
- test("SCENARIO 2 — a slow ask is silent, then gets ONE line, then the answer — and no progress nag", async () => {
246
- const ask = "with that in mind, fix these issues you just noted please and push their fixes to git";
247
- beginScenario("SCENARIO 2 — SLOW ASK (the owner's actual message)", ask);
248
- const item = makeItem("SLOW-1", ask);
249
-
250
- let onCloseHook = null;
251
- await daemon.processItem(item, "cohort", {
252
- claudeAvailable: CLI_PRESENT,
253
- classify: async () => COMPLEX,
254
- isQuickReply: () => false,
255
- sendHoldingMessage: ackSeam(),
256
- dispatch: (_p, _it, _cr, _s, opts) => { onCloseHook = opts.onClose; },
257
- });
258
-
259
- assert.equal(transcript.length, 0, "NOTHING at t=0 — the reflex ack is what 3,069 content-free messages were");
260
- const key = assurance.openObligations()[0].key;
261
- assert.equal(assurance.readObligation(key).state, "open", "the DEBT is opened all the same: silence about timing is not silence about outcome");
262
- note("obligation opened, nothing said; session running");
263
-
264
- // ── Thirty seconds in: still nothing. Below ACK_AFTER_MS the typing
265
- // indicator is the acknowledgement.
266
- let virtual = 30_000;
267
- const clock = () => virtual;
268
- const deps = () => ({
269
- deliverImpl: transport(clock),
270
- spokeSinceImpl: () => false,
271
- generateAckImpl: async () => "Taking the git fixes now — push coming.",
272
- });
273
- let stats = await assurance.sweepObligations({ now: Date.now() + virtual, deps: deps() });
274
- assert.equal(stats.acked, 0);
275
- assert.equal(transcript.length, 0, "under ninety seconds, silence is the right answer");
276
-
277
- // ── Two minutes in: ONE line, specific to the ask.
278
- virtual = 2 * 60_000;
279
- stats = await assurance.sweepObligations({ now: Date.now() + virtual, deps: deps() });
280
- assert.equal(stats.acked, 1, "past ACK_AFTER_MS the human gets exactly one line");
281
- const ack = transcript.find((m) => m.kind === "ack");
282
- assert.ok(ack, "…and it is that line");
283
- assert.match(ack.text, /git fixes/i, "bespoke to the actual ask, not a rotation pick");
284
- assert.doesNotMatch(ack.text, /^(on it|looking now|checking|one moment|got it|will do)\b/i, "never a generic opener — the sanitiser now enforces the prompt");
285
- assert.ok(ack.text.length <= 120, "one short human line, not a templated paragraph");
286
-
287
- // ── Six minutes in — where the progress ping used to land. NOTHING.
288
- virtual = 6 * 60_000;
289
- stats = await assurance.sweepObligations({ now: Date.now() + virtual, deps: deps() });
290
- assert.equal(stats.acked, 0);
291
- const progressish = transcript.filter((m) => /still (on this|going)/i.test(m.text));
292
- assert.equal(progressish.length, 0, "a message that is a pure function of elapsed minutes cannot carry progress");
293
-
294
- // ── Sixteen minutes: and still nothing, however long it runs.
295
- virtual = 16 * 60_000;
296
- await assurance.sweepObligations({ now: Date.now() + virtual, deps: deps() });
297
- assert.equal(transcript.length, 1, `the whole wait costs the human ONE message, got ${transcript.length}`);
298
-
299
- // ── 17 minutes: the session finally answers the human itself.
300
- virtual = 17 * 60_000;
301
- receipts.recordOutbound({ service: "cohort", channel: "CDM-SLOW-1", kind: "session", via: "messaging_send", agentRoot: AGENT_DIR });
302
- heard("reply", "Done — all three issues fixed and pushed (commit a41f0c9). The flaky test was a race in the poller; I've pinned it and re-run CI twice, green both times.", virtual);
303
- onCloseHook({ ok: true, code: 0, sessionId: "s-e2e-2", stdout: "" });
304
- await new Promise((r) => setImmediate(r));
305
-
306
- const rec = assurance.readObligation(key);
307
- assert.equal(rec.state, "answered", "the debt is discharged by evidence of a delivered reply");
308
- assert.equal(transcript.filter((m) => m.kind === "ack").length, 1, "acknowledge once, never twice");
309
- assert.equal(transcript.filter((m) => m.kind === "progress").length, 0, "and never a progress ping — the branch that emitted them is deleted");
310
- note("obligation discharged by receipt — the daemon added nothing on top of the session's own answer", virtual);
311
- });
312
-
313
- // ===========================================================================
314
- // SCENARIO 3 — A TIMING-OUT SESSION. SIGTERM at the 45-minute cap.
315
- // ===========================================================================
316
-
317
- test("SCENARIO 3 — a timing-out session tells the human what happened and that a retry is running", async () => {
318
- const ask = "can you reconcile the July spend against the forecast and tell me where we're over?";
319
- beginScenario("SCENARIO 3 — SESSION TIMES OUT (exit 143 / SIGTERM)", ask);
320
- const item = makeItem("TIMEOUT-1", ask);
321
-
322
- let onCloseHook = null;
323
- await daemon.processItem(item, "cohort", {
324
- claudeAvailable: CLI_PRESENT,
325
- classify: async () => ({ ...COMPLEX, summary: "Reconcile July spend against forecast" }),
326
- isQuickReply: () => false,
327
- sendHoldingMessage: ackSeam(),
328
- dispatch: (_p, _it, _cr, _s, opts) => { onCloseHook = opts.onClose; },
329
- });
330
- const key = assurance.openObligations().find((o) => o.key === item.raw_ref).key;
331
- // Nothing has been said yet — the ask is 45 minutes old in VIRTUAL time only,
332
- // and the sweep has not run. What matters for this scenario is that the debt
333
- // exists, so the failure has somewhere to be reported from.
334
- assert.equal(transcript.length, 0, "silence is the default; the failure notice below is the first thing this human hears");
335
-
336
- // 45 minutes in, the dispatcher's SIGTERM lands and the session closes 143.
337
- const virtual = { v: 45 * 60_000 };
338
- const r = await assurance.settleSession({
339
- key, ok: false, code: 143, error: "session_close exit 143", sessionId: "s-e2e-3",
340
- deps: { deliverImpl: transport(() => virtual.v), spokeSinceImpl: () => false },
341
- });
342
-
343
- assert.equal(r.willRetry, true, "a timeout is transient — it earns one retry");
344
- const failure = transcript.filter((m) => m.kind === "failure").at(-1);
345
- assert.ok(failure, "the human MUST be told; the old code emitted telemetry and nothing else");
346
- assert.match(failure.text, /ran past its time limit/i);
347
- assert.match(failure.text, /retrying now/i);
348
- assert.equal(assurance.readObligation(key).state, "open", "still owed until the retry resolves");
349
- note("item left un-processed for redelivery; the debt stays open so the retry is covered too", virtual.v);
350
- });
351
-
352
- // ===========================================================================
353
- // SCENARIO 4 — A CRASHING SESSION. Nothing to retry; say so and escalate.
354
- // ===========================================================================
355
-
356
- test("SCENARIO 4 — a crashing session tells the human it failed, stops, and escalates", async () => {
357
- const ask = "pull the Q3 pipeline and draft the investor update";
358
- beginScenario("SCENARIO 4 — SESSION CRASHES (unrecoverable)", ask);
359
- const item = makeItem("CRASH-1", ask);
360
-
361
- let onCloseHook = null;
362
- await daemon.processItem(item, "cohort", {
363
- claudeAvailable: CLI_PRESENT,
364
- classify: async () => ({ ...COMPLEX, summary: "Draft the Q3 investor update" }),
365
- isQuickReply: () => false,
366
- sendHoldingMessage: ackSeam(),
367
- dispatch: (_p, _it, _cr, _s, opts) => { onCloseHook = opts.onClose; },
368
- });
369
- const key = item.raw_ref;
370
-
371
- const r = await assurance.settleSession({
372
- key, ok: false, code: 1, error: "claude CLI spawn error: ENOENT", sessionId: "s-e2e-4",
373
- deps: { deliverImpl: transport(() => 90_000), spokeSinceImpl: () => false },
374
- });
375
-
376
- assert.equal(r.willRetry, false, "a spawn failure is permanent — retrying burns another 45 minutes for the same outcome");
377
- const failure = transcript.filter((m) => m.kind === "failure").at(-1);
378
- assert.match(failure.text, /couldn't finish this/i);
379
- assert.match(failure.text, /stopped retrying/i);
380
- assert.match(failure.text, /flagged it so it isn't lost/i);
381
- assert.match(failure.text, /\?\s*$/, "a dead end ends in a question, so the human has a move");
382
- assert.equal(assurance.readObligation(key).state, "failed");
383
- note("durable needs-attention record written to state/obligations/needs-attention/", 90_000);
384
- });
385
-
386
- // ===========================================================================
387
- // SCENARIO 5 — EXIT ZERO, NOTHING SAID. The silent death the old code called
388
- // a success, marked processed forever, and emitted as `sent`.
389
- // ===========================================================================
390
-
391
- test("SCENARIO 5 — a session that exits 0 without replying no longer passes as a success", async () => {
392
- const ask = "did the migration land cleanly?";
393
- beginScenario("SCENARIO 5 — SESSION EXITS 0 HAVING SAID NOTHING", ask);
394
- const item = makeItem("SILENT-1", ask);
395
-
396
- let onCloseHook = null;
397
- await daemon.processItem(item, "cohort", {
398
- claudeAvailable: CLI_PRESENT,
399
- classify: async () => ({ ...COMPLEX, summary: "Check whether the migration landed cleanly" }),
400
- isQuickReply: () => false,
401
- sendHoldingMessage: ackSeam(),
402
- dispatch: (_p, _it, _cr, _s, opts) => { onCloseHook = opts.onClose; },
403
- });
404
- const key = item.raw_ref;
405
-
406
- // The real shape: exit 0, real work done, final text admitting nothing was sent.
407
- const stdout = JSON.stringify({
408
- type: "result",
409
- result: "Checked the migration: it applied cleanly on the primary, but the read replica is 4 minutes behind and still catching up. No action needed unless it stalls. Nothing was sent.",
410
- });
411
- const r = await assurance.settleSession({
412
- key, ok: true, code: 0, stdout, sessionId: "s-e2e-5",
413
- deps: { deliverImpl: transport(() => 4 * 60_000), spokeSinceImpl: () => false },
414
- });
415
-
416
- assert.equal(r.verdict, "silent-success");
417
- const rescued = transcript.at(-1);
418
- assert.match(rescued.text, /didn't get a reply out to you/i);
419
- assert.match(rescued.text, /read replica is 4 minutes behind/, "the work the session actually did reaches the human");
420
- note("previously: marked processed, emitted `sent`, human heard nothing — forever", 4 * 60_000);
421
- });
422
-
423
- // ===========================================================================
424
- // SCENARIO 6 — THE DAEMON ITSELF DIES MID-SESSION.
425
- // ===========================================================================
426
-
427
- test("SCENARIO 6 — a debt orphaned by a daemon restart is spoken to on the next start", async () => {
428
- const ask = "sort out the DNS on the staging domain";
429
- beginScenario("SCENARIO 6 — THE DAEMON DIES MID-SESSION", ask);
430
- const item = makeItem("ORPHAN-1", ask);
431
-
432
- await daemon.processItem(item, "cohort", {
433
- claudeAvailable: CLI_PRESENT,
434
- classify: async () => ({ ...COMPLEX, summary: "Fix DNS on the staging domain" }),
435
- isQuickReply: () => false,
436
- sendHoldingMessage: ackSeam(),
437
- dispatch: () => { /* the daemon dies here — onClose is never called */ },
438
- });
439
-
440
- // Rewrite the record as a previous process's, exactly as a restart would find it.
441
- const rec = assurance.readObligation(item.raw_ref);
442
- rec.daemonPid = process.pid + 12345;
443
- writeFileSync(join(AGENT_DIR, "state", "obligations", `${assurance.sanitiseKey(item.raw_ref)}.json`), JSON.stringify(rec));
444
- note("daemon process dies; obligation file survives on disk");
445
-
446
- // The sweep must PROVE the owning process is gone before it says this — a bare
447
- // pid mismatch is also what a second daemon on the same AGENT_DIR looks like,
448
- // and telling a requester their running work was interrupted is its own bug.
449
- const stats = await assurance.sweepObligations({
450
- now: Date.now() + assurance.INTERRUPT_GRACE_MS + 30_000,
451
- deps: { deliverImpl: transport(() => 30_000), spokeSinceImpl: () => false, isPidAliveImpl: () => false },
452
- });
453
- assert.equal(stats.interrupted, 1);
454
- assert.match(transcript.at(-1).text, /was interrupted before it finished/i);
455
- note("previously: the typing dot stopped and that was the last the human ever heard", 30_000);
456
- });
457
-
458
- // ===========================================================================
459
- // SCENARIO 6b — A PEER AGENT'S ACK ARRIVES AS INBOUND. The dispatch gate reads
460
- // it, and NEITHER an ack goes out NOR a session spawns — the machinery half of
461
- // the 25/27/30 Aug loop, closed at the gate.
462
- // ===========================================================================
463
-
464
- test("SCENARIO 6b — an ack-shaped one-liner from a peer agent seat spawns nothing and acks nothing", async () => {
465
- const echoAck = "On it — taking a look now.";
466
- beginScenario("SCENARIO 6b — PEER AGENT ACK (emitter-class inbound)", echoAck);
467
- const item = {
468
- id: "PEER-ACK-1",
469
- raw_ref: "cohort:dm-a016-a039:PEER-ACK-1",
470
- message_id: "PEER-ACK-1",
471
- service: "cohort",
472
- channel: "dm-a016-a039", // an agent↔agent DM — the structural seat signal
473
- channel_id: "CDM-PEER-ACK-1",
474
- is_dm: true,
475
- sender: "Piotr Novak",
476
- sender_id: "A039",
477
- content: echoAck,
478
- };
479
- writeFileSync(join(AGENT_DIR, "state", "inbox", "cohort", "PEER-ACK-1.yaml"), "id: PEER-ACK-1\n");
480
-
481
- let holdingCalls = 0;
482
- let dispatched = 0;
483
- await daemon.processItem(item, "cohort", {
484
- claudeAvailable: CLI_PRESENT,
485
- classify: async () => ({ ...COMPLEX, summary: "peer says it's on it" }),
486
- isQuickReply: () => false,
487
- sendHoldingMessage: async () => { holdingCalls++; return { sent: true, holdingText: "x" }; },
488
- dispatch: () => { dispatched++; },
489
- });
490
-
491
- assert.equal(holdingCalls, 0, "no acknowledgement at machinery");
492
- assert.equal(dispatched, 0, "and no session burned answering a reflex");
493
- assert.equal(transcript.length, 0, "the peer seat hears nothing");
494
- assert.ok(!assurance.openObligations().some((o) => o.key === item.raw_ref), "no debt opened for emitter-class inbound");
495
- // The refusal is on the audit trail — same log family as the self-echo drops.
496
- const { readFileSync } = await import("node:fs");
497
- const drops = readFileSync(join(AGENT_DIR, "logs", "daemon", "dispatch-gate-drops.jsonl"), "utf-8")
498
- .split("\n").filter(Boolean).map((l) => JSON.parse(l));
499
- const drop = drops.find((d) => d.raw_ref === item.raw_ref);
500
- assert.ok(drop, "the gate refusal is audited");
501
- assert.equal(drop.reason, "peer-ack-shaped");
502
- note("gate refusal audited to logs/daemon/dispatch-gate-drops.jsonl; item retired");
503
-
504
- // The CONTRAST: the same shape from a human sender still gets the full path.
505
- const humanItem = makeItem("HUMAN-TERSE-1", "On it — will do.");
506
- let humanDispatched = 0;
507
- await daemon.processItem(humanItem, "cohort", {
508
- claudeAvailable: CLI_PRESENT,
509
- classify: async () => COMPLEX,
510
- isQuickReply: () => false,
511
- sendHoldingMessage: ackSeam(async () => "Got it — I'll pick this up now."),
512
- dispatch: () => { humanDispatched++; },
513
- });
514
- assert.equal(humanDispatched, 1, "a human's terse line is still worked on");
515
- });
516
-
517
- // ===========================================================================
518
- // SCENARIO 7 — TWO ASKS, ONE ROOM. The owner sends a second thing before the
519
- // first is done. One session answers; the other exits 0 in silence.
520
- // ===========================================================================
521
-
522
- test("SCENARIO 7 — a second ask in the same DM is not discharged by the first one's answer", async () => {
523
- const askA = "what's our runway at the current burn?";
524
- const askB = "also please fix the flaky poller test and push it";
525
- beginScenario("SCENARIO 7 — TWO ASKS IN ONE DM", `${askA}\n [ 0.00s] OWNER → ${askB}`);
526
-
527
- // ONE room, two messages — which is simply what a DM with the owner is.
528
- const room = "CDM-BOTH";
529
- const mk = (id, content) => {
530
- const item = {
531
- id, raw_ref: `cohort:${room}:${id}`, message_id: id, service: "cohort",
532
- channel: "dm/owner", channel_id: room, is_dm: true, sender: "the owner", content,
533
- };
534
- writeFileSync(join(AGENT_DIR, "state", "inbox", "cohort", `${id}.yaml`), `id: ${id}\n`);
535
- return item;
536
- };
537
- const a = mk("BOTH-A", askA);
538
- const b = mk("BOTH-B", askB);
539
-
540
- const openA = await assurance.openAndAcknowledge({
541
- item: a, classResult: { ...COMPLEX, summary: "work out the runway" },
542
- deps: { ackSender: ackSeam() },
543
- });
544
- const openB = await assurance.openAndAcknowledge({
545
- item: b, classResult: { ...COMPLEX, summary: "fix the flaky poller test" },
546
- deps: { ackSender: ackSeam() },
547
- });
548
- assurance.noteSession(openA.key, "s-both-A");
549
- assurance.noteSession(openB.key, "s-both-B");
550
- note("two debts open, one room");
551
-
552
- // Session A answers, through the CLI lane, stamped with the debt it was
553
- // spawned for — exactly what the dispatcher's env now makes possible.
554
- receipts.recordOutbound({
555
- service: "cohort", channel: room, kind: "session", via: "slack-send.sh",
556
- obligationKey: openA.key, sessionId: "s-both-A", agentRoot: AGENT_DIR,
557
- });
558
- heard("reply", "Runway is 14 months at the current burn — the July infra overage is the only thing moving it.", 8 * 60_000);
559
-
560
- const settledA = await assurance.settleSession({
561
- key: openA.key, ok: true, code: 0, sessionId: "s-both-A",
562
- deps: { deliverImpl: transport(() => 8 * 60_000) },
563
- });
564
- assert.equal(settledA.verdict, "answered-by-session");
565
- assert.equal(settledA.basis, "obligation-keyed", "the receipt names the debt it discharged");
566
-
567
- // Session B exits 0 having said NOTHING. Keyed on the room alone — which is
568
- // what shipped — A's receipt closed B too, and this ask vanished in silence.
569
- const settledB = await assurance.settleSession({
570
- key: openB.key, ok: true, code: 0, sessionId: "s-both-B",
571
- stdout: JSON.stringify({ type: "result", result: "The flake is a race between the poller's lock release and the next tick. I've pinned the ordering but not pushed it yet." }),
572
- deps: { deliverImpl: transport(() => 9 * 60_000) },
573
- });
574
- assert.equal(settledB.verdict, "silent-success", "the unanswered ask must NOT ride on the other one's receipt");
575
- const rescue = transcript.at(-1);
576
- assert.match(rescue.text, /didn't get a reply out to you/i);
577
- assert.match(rescue.text, /race between the poller's lock release/, "and B's actual work reaches the human");
578
- note("previously: B closed as `answered` on A's receipt — zero messages, ask gone");
579
- });
580
-
581
- // ===========================================================================
582
- // THE GATE'S OTHER SIDE — the fail-safe every scenario above suppresses.
583
- // ===========================================================================
584
-
585
- /**
586
- * Mutation proof for `CLI_PRESENT`. Every scenario above declares the CLI
587
- * present so that the ack path is exercised rather than skipped; this asserts
588
- * the branch they are stepping over still behaves. Flip `CLI_PRESENT` to
589
- * `() => false` and the scenarios go red; delete the `claudeAvailable` seam
590
- * from THIS test and it goes red on any box with the CLI installed.
591
- */
592
- test("the ack is suppressed when the CLI is unavailable — but the debt is still opened", async () => {
593
- const ask = "rebuild the index and tell me when it's done";
594
- beginScenario("CLI UNAVAILABLE — silence with a tracked debt, never a promise", ask);
595
- const item = makeItem("NO-CLI-1", ask);
596
-
597
- let dispatched = 0;
598
- await daemon.processItem(item, "cohort", {
599
- claudeAvailable: () => false,
600
- classify: async () => COMPLEX,
601
- isQuickReply: () => false,
602
- sendHoldingMessage: ackSeam(),
603
- dispatch: () => { dispatched++; },
604
- });
605
-
606
- assert.equal(transcript.filter((m) => m.kind === "ack").length, 0,
607
- "never promise a reply the CLI that would write it cannot start");
608
- const rec = assurance.openObligations().find((o) => o.key === item.raw_ref);
609
- assert.ok(rec, "the debt is opened anyway — silence is compensated by the sweep, not forgotten");
610
- assert.equal(rec.state, "open");
611
- assert.equal(dispatched, 1, "the work is still attempted; only the promise is withheld");
612
- note("no ack, obligation open: the assurance sweep owns the compensation");
613
- });