@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,456 +0,0 @@
1
- /**
2
- * generate-plists.test.mjs — Coverage for scripts/local-triggers/generate-plists.sh
3
- *
4
- * Builds a fixture agent repo (minimal config/agent.ts + script tree),
5
- * runs the generator, and asserts every emitted plist matches the
6
- * cadence-bus architecture marker and never references the legacy
7
- * run-trigger.sh spawn-per-tick pattern.
8
- */
9
-
10
- import { test } from "node:test";
11
- import assert from "node:assert/strict";
12
- import { promises as fsp } from "fs";
13
- import { readFileSync, readdirSync, writeFileSync, mkdirSync, copyFileSync, existsSync } from "node:fs";
14
- import { tmpdir } from "os";
15
- import { join, resolve, dirname } from "path";
16
- import { fileURLToPath } from "node:url";
17
- import { spawnSync } from "node:child_process";
18
-
19
- const __dirname = dirname(fileURLToPath(import.meta.url));
20
- const MAESTRO_ROOT = resolve(__dirname, "..", "..");
21
- const GENERATOR = resolve(__dirname, "generate-plists.sh");
22
-
23
- async function makeAgent(firstName) {
24
- const root = join(
25
- tmpdir(),
26
- `plist-test-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`
27
- );
28
- await fsp.mkdir(root, { recursive: true });
29
-
30
- // Minimal agent identity.
31
- await fsp.mkdir(join(root, "config"), { recursive: true });
32
- writeFileSync(
33
- join(root, "config/agent.ts"),
34
- `export const AGENT = { firstName: '${firstName}', lastName: 'Tester' };\n`
35
- );
36
- writeFileSync(join(root, "package.json"), '{"name":"t"}');
37
-
38
- // Copy the scripts the generator references.
39
- await fsp.mkdir(join(root, "scripts/local-triggers"), { recursive: true });
40
- await fsp.mkdir(join(root, "scripts/daemon"), { recursive: true });
41
- await fsp.mkdir(join(root, "scripts/cadence"), { recursive: true });
42
- // The generator now derives the standard cadence set from the canonical
43
- // STANDARD_CADENCES in lib/cadences.mjs (SoT), so the fixture needs the
44
- // module + its local import chain (capability → archetype).
45
- await fsp.mkdir(join(root, "lib"), { recursive: true });
46
- for (const m of ["lib/cadences.mjs", "lib/capability.mjs", "lib/archetype.mjs"]) {
47
- copyFileSync(join(MAESTRO_ROOT, m), join(root, m));
48
- }
49
- copyFileSync(GENERATOR, join(root, "scripts/local-triggers/generate-plists.sh"));
50
- copyFileSync(
51
- join(MAESTRO_ROOT, "scripts/local-triggers/run-trigger.sh"),
52
- join(root, "scripts/local-triggers/run-trigger.sh"),
53
- );
54
- copyFileSync(
55
- join(MAESTRO_ROOT, "scripts/daemon/launchd-wrapper.sh"),
56
- join(root, "scripts/daemon/launchd-wrapper.sh"),
57
- );
58
- copyFileSync(
59
- join(MAESTRO_ROOT, "scripts/daemon/launchd-wrapper-generic.sh"),
60
- join(root, "scripts/daemon/launchd-wrapper-generic.sh"),
61
- );
62
- copyFileSync(
63
- join(MAESTRO_ROOT, "scripts/cadence/launchd-cadence-wrapper.sh"),
64
- join(root, "scripts/cadence/launchd-cadence-wrapper.sh"),
65
- );
66
- copyFileSync(
67
- join(MAESTRO_ROOT, "scripts/cadence/launchd-socket-mode-wrapper.sh"),
68
- join(root, "scripts/cadence/launchd-socket-mode-wrapper.sh"),
69
- );
70
- copyFileSync(
71
- join(MAESTRO_ROOT, "scripts/cadence/enqueue-cadence-tick.mjs"),
72
- join(root, "scripts/cadence/enqueue-cadence-tick.mjs"),
73
- );
74
-
75
- // Make scripts executable.
76
- for (const p of [
77
- "scripts/local-triggers/generate-plists.sh",
78
- "scripts/local-triggers/run-trigger.sh",
79
- "scripts/daemon/launchd-wrapper.sh",
80
- "scripts/daemon/launchd-wrapper-generic.sh",
81
- "scripts/cadence/launchd-cadence-wrapper.sh",
82
- "scripts/cadence/launchd-socket-mode-wrapper.sh",
83
- ]) {
84
- await fsp.chmod(join(root, p), 0o755);
85
- }
86
- return root;
87
- }
88
-
89
- async function rmRoot(path) {
90
- try { await fsp.rm(path, { recursive: true, force: true }); } catch { /* */ }
91
- }
92
-
93
- function runGenerator(agentRoot) {
94
- return spawnSync("/bin/bash", [join(agentRoot, "scripts/local-triggers/generate-plists.sh")], {
95
- cwd: agentRoot,
96
- encoding: "utf-8",
97
- env: { ...process.env },
98
- });
99
- }
100
-
101
- function listPlists(agentRoot) {
102
- const dir = join(agentRoot, "scripts/local-triggers/plists");
103
- return readdirSync(dir).filter((n) => n.endsWith(".plist"));
104
- }
105
-
106
- // ---------------------------------------------------------------------------
107
- // Tests
108
- // ---------------------------------------------------------------------------
109
-
110
- test("generator emits 25 standard plists with the agent's first name", async () => {
111
- // Standard inventory (cadence-bus v1 + slack-socket-mode v1), with NO
112
- // config/.cadence-plists.tsv present (no archetype cadences):
113
- // daemon, session, poll-relay, slack-socket, autoupdate (5 infra), PLUS one trigger plist per
114
- // STANDARD_CADENCES entry in lib/cadences.mjs (the SoT):
115
- // inbox-processor, backlog-executor, meeting-prep, meeting-action-capture,
116
- // daily-morning-brief, daily-midday-sweep, daily-evening-wrap,
117
- // quarterly-self-assessment, org-pulse, skill-curator (10), PLUS the
118
- // economics/scheduling cadences nightly-cost-reconcile, fleet-cost-digest,
119
- // org-cost-sync, monitoring-alerts, dynamic-jobs (5), PLUS the SP10
120
- // messaging-inbound cadence (1), PLUS the 2026-07 Directory & Design
121
- // stewards directory-hygiene + brand-steward (2), PLUS the D3 self-directed
122
- // loop goal-steward (1), PLUS the 2026-08 DR cadence nightly-backup (1).
123
- // = 5 infra + 20 trigger = 25 total. (The `session` job — the front-door
124
- // Claude Code session under scripts/session/supervisor.sh — joined the
125
- // infra set 2026-09-08; see docs/superpowers/specs/2026-09-08-front-door-session-design.md §3.1.)
126
- // org-pulse used to be declared standard but was OMITTED by the old hardcoded
127
- // list (it never got a plist); deriving from the SoT fixes that drift.
128
- // The former weekly-* cadences are still ARCHETYPE-DRIVEN (function × altitude),
129
- // emitted from config/.cadence-plists.tsv (scripts/setup/generate-cadences.mjs).
130
- const root = await makeAgent("alice");
131
- try {
132
- const r = runGenerator(root);
133
- assert.equal(r.status, 0, r.stderr);
134
- const plists = listPlists(root);
135
- assert.equal(plists.length, 25, `expected 25 standard plists; got ${plists.join(",")}`);
136
- assert.ok(plists.includes("ai.maestro.alice-session.plist"),
137
- `session (front-door) plist missing; got ${plists.join(",")}`);
138
- assert.ok(plists.includes("ai.maestro.alice-autoupdate.plist"),
139
- `autoupdate plist missing; got ${plists.join(",")}`);
140
- assert.ok(plists.includes("ai.maestro.alice-messaging-inbound.plist"),
141
- "messaging-inbound (SP10 standard cadence) must get a SoT-derived plist");
142
- assert.ok(plists.includes("ai.maestro.alice-nightly-backup.plist"),
143
- "nightly-backup (the DR cadence) must be scheduled, not left to a human to remember");
144
- for (const id of ["directory-hygiene", "brand-steward"]) {
145
- assert.ok(plists.includes(`ai.maestro.alice-${id}.plist`),
146
- `Directory/Design steward "${id}" must get a SoT-derived plist; got ${plists.join(",")}`);
147
- }
148
- assert.ok(plists.includes("ai.maestro.alice-org-pulse.plist"),
149
- "org-pulse (declared standard) must get a plist now it's SoT-derived");
150
- // The newly-wired economics/scheduling cadences each get a plist.
151
- for (const id of ["nightly-cost-reconcile", "fleet-cost-digest", "org-cost-sync", "dynamic-jobs"]) {
152
- assert.ok(plists.includes(`ai.maestro.alice-${id}.plist`),
153
- `economics cadence "${id}" must get a SoT-derived plist; got ${plists.join(",")}`);
154
- }
155
- for (const p of plists) {
156
- assert.match(p, /^ai\.maestro\.alice-/);
157
- }
158
- } finally { await rmRoot(root); }
159
- });
160
-
161
- test("every cadence resolved by resolveCadences() gets a generated plist (incl. org-pulse)", async () => {
162
- // Single-source-of-truth guarantee: the launchd plist set is derived from the
163
- // canonical cadence resolution, so a cadence declared in lib/cadences.mjs can
164
- // never silently lack a job (the org-pulse-never-fires class of bug).
165
- const root = await makeAgent("hana");
166
- try {
167
- // Drive the archetype TSV too, so we cover standard + archetype in one pass.
168
- const { resolveCadences } = await import(join(MAESTRO_ROOT, "lib/cadences.mjs"));
169
- const cadences = await resolveCadences({ function: "technical-leader", altitude: "c-suite" });
170
- // Emit the archetype (non-standard) cadences via the TSV, exactly as
171
- // generate-cadences.mjs does (id|interval| / id||base64(sched)).
172
- const tsvLines = [];
173
- for (const c of cadences) {
174
- if (c.scope === "standard") continue;
175
- if (typeof c.interval === "number") tsvLines.push(`${c.id}|${c.interval}|`);
176
- else if (c.calendar) {
177
- const cal = c.calendar;
178
- let x = "";
179
- if (cal.weekday != null) x += ` <key>Weekday</key>\n <integer>${cal.weekday}</integer>\n`;
180
- if (cal.day != null) x += ` <key>Day</key>\n <integer>${cal.day}</integer>\n`;
181
- x += ` <key>Hour</key>\n <integer>${cal.hour ?? 9}</integer>\n <key>Minute</key>\n <integer>${cal.minute ?? 0}</integer>`;
182
- tsvLines.push(`${c.id}||${Buffer.from(x, "utf-8").toString("base64")}`);
183
- }
184
- }
185
- writeFileSync(join(root, "config/.cadence-plists.tsv"), tsvLines.join("\n") + (tsvLines.length ? "\n" : ""));
186
-
187
- const r = runGenerator(root);
188
- assert.equal(r.status, 0, r.stderr);
189
- const plists = new Set(listPlists(root));
190
- for (const c of cadences) {
191
- // skill-curator has a calendar; every resolved cadence here has a
192
- // schedule, so each must produce exactly one trigger plist.
193
- const label = `ai.maestro.hana-${c.id}.plist`;
194
- assert.ok(plists.has(label), `resolved cadence "${c.id}" (${c.scope}) has no plist; got ${[...plists].join(",")}`);
195
- }
196
- // Spot-check the specific regression: org-pulse is standard and present.
197
- assert.ok(plists.has("ai.maestro.hana-org-pulse.plist"), "org-pulse must be present");
198
- } finally { await rmRoot(root); }
199
- });
200
-
201
- test("archetype cadences from config/.cadence-plists.tsv emit extra trigger plists", async () => {
202
- const root = await makeAgent("erin");
203
- try {
204
- const calXml = " <key>Weekday</key>\n <integer>3</integer>\n <key>Hour</key>\n <integer>10</integer>\n <key>Minute</key>\n <integer>0</integer>";
205
- const tsv =
206
- `engineering-health||${Buffer.from(calXml, "utf-8").toString("base64")}\n` +
207
- `quality-pulse|1800|\n`;
208
- writeFileSync(join(root, "config/.cadence-plists.tsv"), tsv);
209
- const r = runGenerator(root);
210
- assert.equal(r.status, 0, r.stderr);
211
- const plists = listPlists(root);
212
- assert.equal(plists.length, 27, `expected 25 standard + 2 archetype; got ${plists.join(",")}`);
213
- const dir = join(root, "scripts/local-triggers/plists");
214
- const eng = readFileSync(join(dir, "ai.maestro.erin-engineering-health.plist"), "utf-8");
215
- assert.match(eng, /<key>Weekday<\/key>\s*<integer>3<\/integer>/); // base64 schedule decoded
216
- assert.match(eng, /enqueue-cadence-tick\.mjs/);
217
- const qp = readFileSync(join(dir, "ai.maestro.erin-quality-pulse.plist"), "utf-8");
218
- assert.match(qp, /<integer>1800<\/integer>/); // interval path
219
- } finally { await rmRoot(root); }
220
- });
221
-
222
- test("every trigger plist carries the cadence-bus architecture marker", async () => {
223
- const root = await makeAgent("bob");
224
- try {
225
- runGenerator(root);
226
- const dir = join(root, "scripts/local-triggers/plists");
227
- for (const name of listPlists(root)) {
228
- const body = readFileSync(join(dir, name), "utf-8");
229
- assert.match(body, /maestro-plist-arch: cadence-bus/, `${name} missing arch marker`);
230
- }
231
- } finally { await rmRoot(root); }
232
- });
233
-
234
- test("NO trigger plist invokes run-trigger.sh", async () => {
235
- const root = await makeAgent("carol");
236
- try {
237
- runGenerator(root);
238
- const dir = join(root, "scripts/local-triggers/plists");
239
- for (const name of listPlists(root)) {
240
- const body = readFileSync(join(dir, name), "utf-8");
241
- // Exception: the daemon/session/poll-relay/slack-socket/autoupdate plists
242
- // don't run cadence triggers at all (daemon + session + slack-socket are
243
- // KeepAlive workers; poll-relay is a 5s poller; autoupdate is an hourly SDK
244
- // self-updater). The trigger plists must invoke enqueue-cadence-tick.mjs.
245
- if (name.endsWith("-daemon.plist") || name.endsWith("-session.plist") ||
246
- name.endsWith("-poll-relay.plist") ||
247
- name.endsWith("-slack-socket.plist") || name.endsWith("-autoupdate.plist")) {
248
- continue;
249
- }
250
- assert.ok(!body.includes("run-trigger.sh"),
251
- `${name} still references run-trigger.sh:\n${body}`);
252
- assert.ok(body.includes("enqueue-cadence-tick.mjs"),
253
- `${name} should invoke enqueue script`);
254
- }
255
- } finally { await rmRoot(root); }
256
- });
257
-
258
- test("trigger plists pass --source=launchd to the enqueue script", async () => {
259
- const root = await makeAgent("dana");
260
- try {
261
- runGenerator(root);
262
- const dir = join(root, "scripts/local-triggers/plists");
263
- const triggerPlist = join(dir, "ai.maestro.dana-inbox-processor.plist");
264
- const body = readFileSync(triggerPlist, "utf-8");
265
- assert.match(body, /<string>--source=launchd<\/string>/);
266
- assert.match(body, /<string>inbox-processor<\/string>/);
267
- // StartInterval 300 (every 5 min).
268
- assert.match(body, /<integer>300<\/integer>/);
269
- } finally { await rmRoot(root); }
270
- });
271
-
272
- test("interval trigger plists pass --interval=<seconds> for the at-most-once gate (WS4)", async () => {
273
- const root = await makeAgent("gita");
274
- try {
275
- runGenerator(root);
276
- const dir = join(root, "scripts/local-triggers/plists");
277
- // StartInterval cadence: --interval mirrors the interval seconds.
278
- const inbox = readFileSync(join(dir, "ai.maestro.gita-inbox-processor.plist"), "utf-8");
279
- assert.match(inbox, /<string>--interval=300<\/string>/);
280
- // Calendar cadence (daily): carries a daily catch-up interval so an outage
281
- // spanning the trigger time fast-forwards to exactly one catch-up tick.
282
- const morning = readFileSync(join(dir, "ai.maestro.gita-daily-morning-brief.plist"), "utf-8");
283
- assert.match(morning, /<string>--interval=86400<\/string>/);
284
- // Still a StartCalendarInterval-driven plist (wall-clock trigger unchanged).
285
- assert.match(morning, /<key>StartCalendarInterval<\/key>/);
286
- } finally { await rmRoot(root); }
287
- });
288
-
289
- test("economics/scheduling cadences emit plists with the right schedule + enqueue wiring", async () => {
290
- const root = await makeAgent("nadia");
291
- try {
292
- runGenerator(root);
293
- const dir = join(root, "scripts/local-triggers/plists");
294
- // nightly-cost-reconcile: calendar 03:30, daily catch-up, enqueue wiring.
295
- const reconcile = readFileSync(join(dir, "ai.maestro.nadia-nightly-cost-reconcile.plist"), "utf-8");
296
- assert.match(reconcile, /<key>StartCalendarInterval<\/key>/);
297
- assert.match(reconcile, /<key>Hour<\/key>\s*<integer>3<\/integer>/);
298
- assert.match(reconcile, /<key>Minute<\/key>\s*<integer>30<\/integer>/);
299
- assert.match(reconcile, /<string>--interval=86400<\/string>/); // daily catch-up
300
- assert.match(reconcile, /enqueue-cadence-tick\.mjs/);
301
- assert.match(reconcile, /<string>nightly-cost-reconcile<\/string>/);
302
- // fleet-cost-digest: calendar 07:00.
303
- const digest = readFileSync(join(dir, "ai.maestro.nadia-fleet-cost-digest.plist"), "utf-8");
304
- assert.match(digest, /<key>Hour<\/key>\s*<integer>7<\/integer>/);
305
- // org-cost-sync: hourly StartInterval.
306
- const sync = readFileSync(join(dir, "ai.maestro.nadia-org-cost-sync.plist"), "utf-8");
307
- assert.match(sync, /<key>StartInterval<\/key>\s*<integer>3600<\/integer>/);
308
- assert.match(sync, /<string>--interval=3600<\/string>/);
309
- // dynamic-jobs: 60s StartInterval.
310
- const jobs = readFileSync(join(dir, "ai.maestro.nadia-dynamic-jobs.plist"), "utf-8");
311
- assert.match(jobs, /<key>StartInterval<\/key>\s*<integer>60<\/integer>/);
312
- assert.match(jobs, /<string>--interval=60<\/string>/);
313
- } finally { await rmRoot(root); }
314
- });
315
-
316
- test("daemon plist remains a KeepAlive job (not a cadence enqueue)", async () => {
317
- const root = await makeAgent("erin");
318
- try {
319
- runGenerator(root);
320
- const path = join(root, "scripts/local-triggers/plists/ai.maestro.erin-daemon.plist");
321
- const body = readFileSync(path, "utf-8");
322
- // KeepAlive switched 1.9.2 from plain `<true/>` to a dict with
323
- // SuccessfulExit:false / Crashed:true so emergency-stop doesn't trigger
324
- // a restart treadmill but real crashes still do.
325
- assert.match(body, /<key>KeepAlive<\/key>/);
326
- assert.match(body, /<key>SuccessfulExit<\/key>\s*<false\/>/);
327
- assert.match(body, /<key>Crashed<\/key>\s*<true\/>/);
328
- assert.match(body, /launchd-wrapper\.sh/);
329
- assert.ok(!body.includes("enqueue-cadence-tick.mjs"),
330
- "daemon plist should not enqueue ticks — it IS the consumer");
331
- } finally { await rmRoot(root); }
332
- });
333
-
334
- test("session plist is a KeepAlive job running scripts/session/supervisor.sh with its own log paths", async () => {
335
- // The front-door session (design §3.1): launchd keeps the supervisor alive
336
- // with the same SuccessfulExit:false / Crashed:true semantics as the daemon
337
- // — a clean exit 0 (second supervisor, emergency-stop) is NOT restarted, a
338
- // crash or the supervisor's deliberate exit 75 IS, throttled to 30s so a
339
- // broken transcript cannot thrash launchd. Logs go to logs/session/ so the
340
- // session's launchd output never interleaves with the daemon's.
341
- const root = await makeAgent("ivy");
342
- try {
343
- runGenerator(root);
344
- const path = join(root, "scripts/local-triggers/plists/ai.maestro.ivy-session.plist");
345
- const body = readFileSync(path, "utf-8");
346
- assert.match(body, /<key>Label<\/key>\s*<string>ai\.maestro\.ivy-session<\/string>/);
347
- assert.match(body, new RegExp(`<string>${root.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}/scripts/session/supervisor\\.sh</string>`),
348
- "ProgramArguments must run scripts/session/supervisor.sh from the agent dir");
349
- assert.match(body, /<key>KeepAlive<\/key>/);
350
- assert.match(body, /<key>SuccessfulExit<\/key>\s*<false\/>/);
351
- assert.match(body, /<key>Crashed<\/key>\s*<true\/>/);
352
- assert.match(body, /<key>RunAtLoad<\/key>\s*<true\/>/);
353
- assert.match(body, /<key>ThrottleInterval<\/key>\s*<integer>30<\/integer>/);
354
- assert.match(body, /<key>StandardOutPath<\/key>\s*<string>[^<]*\/logs\/session\/launchd-stdout\.log<\/string>/);
355
- assert.match(body, /<key>StandardErrorPath<\/key>\s*<string>[^<]*\/logs\/session\/launchd-stderr\.log<\/string>/);
356
- assert.ok(!body.includes("logs/daemon/"), "session plist must not log into the daemon's log dir");
357
- assert.ok(!body.includes("enqueue-cadence-tick.mjs"), "session plist is a worker, not a cadence enqueue");
358
- assert.ok(!body.includes("boot-claude-session"), "the Terminal.app boot script is retired");
359
- // launchd creates the log file but not its directory: the generator must.
360
- assert.ok(existsSync(join(root, "logs", "session")), "logs/session/ must exist after generation");
361
- // The daemon plist is untouched by the addition.
362
- const daemon = readFileSync(join(root, "scripts/local-triggers/plists/ai.maestro.ivy-daemon.plist"), "utf-8");
363
- assert.match(daemon, /logs\/daemon\/launchd-stdout\.log/);
364
- } finally { await rmRoot(root); }
365
- });
366
-
367
- test("generator reads firstName from agent.json when agent.ts is type-only (SOT layout)", async () => {
368
- // Reproduce the SOT layout where agent.ts only declares interfaces
369
- // (containing `firstName: string;` as a type, not a value) and the
370
- // actual identity lives in agent.json. The legacy resolver matched the
371
- // interface line and produced labels like
372
- // `ai.maestro. firstname: string;-…` — guard against regression.
373
- const root = join(
374
- tmpdir(),
375
- `plist-sot-test-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`
376
- );
377
- await fsp.mkdir(root, { recursive: true });
378
- // Manually wire the same fixture-builder used by other tests, except
379
- // overwrite agent.ts to look like a type-only TypeScript file and add
380
- // a real agent.json.
381
- await fsp.mkdir(join(root, "config"), { recursive: true });
382
- writeFileSync(
383
- join(root, "config/agent.ts"),
384
- `// Type declarations only — value lives in agent.json
385
- export interface PrincipalConfig { firstName: string; }
386
- export interface AgentConfig { firstName: string; }
387
- `,
388
- );
389
- writeFileSync(
390
- join(root, "config/agent.json"),
391
- JSON.stringify({ firstName: "Sigrid", lastName: "Test" }) + "\n",
392
- );
393
- writeFileSync(join(root, "package.json"), '{"name":"t"}');
394
-
395
- await fsp.mkdir(join(root, "scripts/local-triggers"), { recursive: true });
396
- await fsp.mkdir(join(root, "scripts/daemon"), { recursive: true });
397
- await fsp.mkdir(join(root, "scripts/cadence"), { recursive: true });
398
- // Same set of helper scripts as makeAgent().
399
- const { copyFileSync } = await import("node:fs");
400
- copyFileSync(GENERATOR, join(root, "scripts/local-triggers/generate-plists.sh"));
401
- copyFileSync(
402
- join(MAESTRO_ROOT, "scripts/local-triggers/run-trigger.sh"),
403
- join(root, "scripts/local-triggers/run-trigger.sh"),
404
- );
405
- copyFileSync(
406
- join(MAESTRO_ROOT, "scripts/daemon/launchd-wrapper.sh"),
407
- join(root, "scripts/daemon/launchd-wrapper.sh"),
408
- );
409
- copyFileSync(
410
- join(MAESTRO_ROOT, "scripts/daemon/launchd-wrapper-generic.sh"),
411
- join(root, "scripts/daemon/launchd-wrapper-generic.sh"),
412
- );
413
- copyFileSync(
414
- join(MAESTRO_ROOT, "scripts/cadence/launchd-cadence-wrapper.sh"),
415
- join(root, "scripts/cadence/launchd-cadence-wrapper.sh"),
416
- );
417
- copyFileSync(
418
- join(MAESTRO_ROOT, "scripts/cadence/launchd-socket-mode-wrapper.sh"),
419
- join(root, "scripts/cadence/launchd-socket-mode-wrapper.sh"),
420
- );
421
- copyFileSync(
422
- join(MAESTRO_ROOT, "scripts/cadence/enqueue-cadence-tick.mjs"),
423
- join(root, "scripts/cadence/enqueue-cadence-tick.mjs"),
424
- );
425
- await fsp.chmod(join(root, "scripts/local-triggers/generate-plists.sh"), 0o755);
426
-
427
- try {
428
- const r = runGenerator(root);
429
- assert.equal(r.status, 0, r.stderr);
430
- const plists = listPlists(root);
431
- assert.ok(plists.length >= 1);
432
- for (const p of plists) {
433
- assert.match(p, /^ai\.maestro\.sigrid-/, `expected "sigrid" label, got: ${p}`);
434
- assert.ok(!p.includes("string"),
435
- `label leaked the TypeScript type: ${p}`);
436
- }
437
- } finally { await rmRoot(root); }
438
- });
439
-
440
- test("regeneration clears stale plists", async () => {
441
- const root = await makeAgent("frank");
442
- try {
443
- // Plant a stale plist for a long-gone agent — intentionally using the legacy
444
- // ai.adaptic.* namespace to confirm pre-rename plists are also cleared on regen.
445
- const dir = join(root, "scripts/local-triggers/plists");
446
- mkdirSync(dir, { recursive: true });
447
- writeFileSync(join(dir, "ai.adaptic.OLD-AGENT-stale.plist"), "<plist/>");
448
- runGenerator(root);
449
- const remaining = listPlists(root);
450
- assert.ok(!remaining.includes("ai.adaptic.OLD-AGENT-stale.plist"),
451
- "generator must clear stale plists");
452
- for (const p of remaining) {
453
- assert.match(p, /^ai\.maestro\.frank-/);
454
- }
455
- } finally { await rmRoot(root); }
456
- });
@@ -1,135 +0,0 @@
1
- /**
2
- * brand-clause.test.mjs — generated imagery must not be branded for a company
3
- * that does not exist.
4
- *
5
- * WHAT BROKE
6
- * `buildDefaultPrompt()` appended, to EVERY illustration prompt on EVERY
7
- * deployment: "IMPORTANT: This is for <one fictional company>, an
8
- * institutional-grade AI asset management platform." — while `spec.style`,
9
- * `spec.mood` and `spec.colorPalette` three lines above were already
10
- * parameterised correctly. `gemini-image-client.mjs` then closed every
11
- * refinement pass with "... and <that company>'s brand aesthetic
12
- * requirements", re-asserting a brand the module cannot know.
13
- *
14
- * WHAT THESE TESTS PIN
15
- * 1. GROUNDED — the brand sentence is built from config/company.json (name,
16
- * tagline, description, industry) and config/brand-assets.yaml
17
- * (usage_rules), which bin/maestro.mjs generates per agent.
18
- * 2. EMPTY — nothing configured ⇒ NO brand clause is emitted at all. The
19
- * craft direction (which names no company) survives, because it is true on
20
- * any deployment. An unbranded illustration is a correct outcome.
21
- *
22
- * HOW IT RUNS
23
- * generate-assets.mjs imports "dotenv/config" and gemini-image-client.mjs
24
- * imports "@google/genai" — neither is a dependency of this package, so
25
- * neither module can be imported in-process. The renderers are pure, so we
26
- * lift their REAL source and evaluate it.
27
- *
28
- * Run: node --test scripts/media-generation/brand-clause.test.mjs
29
- */
30
-
31
- "use strict";
32
-
33
- import { test } from "node:test";
34
- import assert from "node:assert/strict";
35
- import { readFileSync } from "node:fs";
36
-
37
- const ASSETS_SRC = readFileSync(new URL("./generate-assets.mjs", import.meta.url), "utf8");
38
- const GEMINI_SRC = readFileSync(new URL("./gemini-image-client.mjs", import.meta.url), "utf8");
39
-
40
- function extractFunction(src, name, file) {
41
- const re = new RegExp(`(?:export\\s+)?function\\s+${name}\\s*\\(`);
42
- const m = re.exec(src);
43
- assert.ok(m, `${file} no longer defines ${name}() — update this test deliberately`);
44
- const open = src.indexOf("{", m.index + m[0].length - 1);
45
- let depth = 0;
46
- for (let i = open; i < src.length; i++) {
47
- if (src[i] === "{") depth++;
48
- else if (src[i] === "}" && --depth === 0) return src.slice(m.index, i + 1).replace(/^export\s+/, "");
49
- }
50
- throw new Error(`unbalanced braces extracting ${name}`);
51
- }
52
-
53
- const assetNames = ["configuredStr", "buildBrandClause", "buildDefaultPrompt"];
54
- const assets = new Function(
55
- `${assetNames.map((n) => extractFunction(ASSETS_SRC, n, "generate-assets.mjs")).join("\n\n")}\n` +
56
- `return { ${assetNames.join(", ")} };`,
57
- )();
58
- const gemini = new Function(
59
- `${extractFunction(GEMINI_SRC, "buildRefinementPrompt", "gemini-image-client.mjs")}\nreturn { buildRefinementPrompt };`,
60
- )();
61
-
62
- const { buildBrandClause, buildDefaultPrompt } = assets;
63
- const { buildRefinementPrompt } = gemini;
64
-
65
- const SPEC = { title: "Depot network", purpose: "Board deck cover", elements: ["a map"] };
66
-
67
- // ── GROUNDED ────────────────────────────────────────────────────────────────
68
-
69
- test("grounded: the brand sentence is built from config/company.json", () => {
70
- const clause = buildBrandClause(
71
- { name: "Meridian Freight", tagline: "Cold chain, unbroken", industry: "Logistics" },
72
- {},
73
- );
74
- assert.equal(clause, "This is for Meridian Freight — Cold chain, unbroken.");
75
- });
76
-
77
- test("grounded: description or industry stands in when there is no tagline", () => {
78
- assert.match(buildBrandClause({ name: "Meridian Freight", description: "Regional logistics." }, {}), /— Regional logistics\./);
79
- assert.match(buildBrandClause({ name: "Meridian Freight", industry: "Logistics" }, {}), /— Logistics\./);
80
- assert.equal(buildBrandClause({ name: "Meridian Freight" }, {}), "This is for Meridian Freight.");
81
- });
82
-
83
- test("grounded: config/brand-assets.yaml usage_rules pass through verbatim", () => {
84
- const clause = buildBrandClause(
85
- { name: "Meridian Freight" },
86
- { usage_rules: { never: "stretch, rotate, recolour, or modify the assets" } },
87
- );
88
- assert.match(clause, /Never stretch, rotate, recolour, or modify the assets\./);
89
- });
90
-
91
- test("grounded: the brand clause reaches the prompt", () => {
92
- const prompt = buildDefaultPrompt(SPEC, "This is for Meridian Freight — Cold chain, unbroken.");
93
- assert.match(prompt, /IMPORTANT: This is for Meridian Freight — Cold chain, unbroken\./);
94
- assert.match(prompt, /premium, restrained, and sophisticated/, "craft direction survives");
95
- });
96
-
97
- // ── EMPTY — no config, no brand claim ───────────────────────────────────────
98
-
99
- test("empty: the scaffold's UNCONFIGURED company yields NO brand clause", () => {
100
- assert.equal(buildBrandClause({ name: "UNCONFIGURED", tagline: "", description: "", industry: "" }, {}), "");
101
- });
102
-
103
- test("empty: a missing/garbage config yields NO brand clause", () => {
104
- assert.equal(buildBrandClause({}, {}), "");
105
- assert.equal(buildBrandClause(null, null), "");
106
- assert.equal(buildBrandClause(undefined, undefined), "");
107
- });
108
-
109
- test("empty: with no brand clause the prompt names NO company at all", () => {
110
- const prompt = buildDefaultPrompt(SPEC, "");
111
- assert.doesNotMatch(prompt, /This is for/);
112
- assert.doesNotMatch(prompt, /UNCONFIGURED/);
113
- // The company-agnostic craft direction is still stated — it is true anywhere.
114
- assert.match(prompt, /IMPORTANT: The illustration must feel premium, restrained, and sophisticated\./);
115
- assert.match(prompt, /Create an illustration for: Depot network/);
116
- });
117
-
118
- test("empty: buildDefaultPrompt defaults to no brand clause when called with one argument", () => {
119
- assert.doesNotMatch(buildDefaultPrompt(SPEC), /This is for/);
120
- });
121
-
122
- // ── The refinement pass re-asserts nothing ──────────────────────────────────
123
-
124
- test("the refinement prompt preserves the brand STATED ABOVE, it does not name one", () => {
125
- const out = buildRefinementPrompt("ORIGINAL PROMPT BODY", "fix the horizon line");
126
- assert.match(out, /ORIGINAL PROMPT BODY/);
127
- assert.match(out, /fix the horizon line/);
128
- assert.match(out, /every brand and style requirement stated above/);
129
- });
130
-
131
- test("neither media-generation source carries a hardcoded brand", () => {
132
- assert.doesNotMatch(ASSETS_SRC, /\bNorthwind\b/i);
133
- assert.doesNotMatch(GEMINI_SRC, /\bNorthwind\b/i);
134
- assert.doesNotMatch(ASSETS_SRC, /institutional-grade AI asset management/i);
135
- });