@memnexus-ai/mx-agent-cli 0.1.294 → 0.1.295-next.0

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 (637) hide show
  1. package/dist/__tests__/agents-md-canonicalization.test.js +31 -1
  2. package/dist/__tests__/agents-md-canonicalization.test.js.map +1 -1
  3. package/dist/__tests__/behavioral-extraction.test.js +50 -0
  4. package/dist/__tests__/behavioral-extraction.test.js.map +1 -1
  5. package/dist/__tests__/bootstrap-behavioral-contract.test.js +6 -3
  6. package/dist/__tests__/bootstrap-behavioral-contract.test.js.map +1 -1
  7. package/dist/__tests__/bundle-config.test.js +28 -2
  8. package/dist/__tests__/bundle-config.test.js.map +1 -1
  9. package/dist/__tests__/catalog-interaction.test.d.ts +25 -0
  10. package/dist/__tests__/catalog-interaction.test.d.ts.map +1 -0
  11. package/dist/__tests__/catalog-interaction.test.js +269 -0
  12. package/dist/__tests__/catalog-interaction.test.js.map +1 -0
  13. package/dist/__tests__/catalog-named-memories.test.d.ts +2 -0
  14. package/dist/__tests__/catalog-named-memories.test.d.ts.map +1 -0
  15. package/dist/__tests__/catalog-named-memories.test.js +204 -0
  16. package/dist/__tests__/catalog-named-memories.test.js.map +1 -0
  17. package/dist/__tests__/catalog-origin-main.test.d.ts +15 -0
  18. package/dist/__tests__/catalog-origin-main.test.d.ts.map +1 -0
  19. package/dist/__tests__/catalog-origin-main.test.js +296 -0
  20. package/dist/__tests__/catalog-origin-main.test.js.map +1 -0
  21. package/dist/__tests__/catalog.test.d.ts +2 -0
  22. package/dist/__tests__/catalog.test.d.ts.map +1 -0
  23. package/dist/__tests__/catalog.test.js +131 -0
  24. package/dist/__tests__/catalog.test.js.map +1 -0
  25. package/dist/__tests__/cli-build-integration.test.d.ts +2 -0
  26. package/dist/__tests__/cli-build-integration.test.d.ts.map +1 -0
  27. package/dist/__tests__/cli-build-integration.test.js +64 -0
  28. package/dist/__tests__/cli-build-integration.test.js.map +1 -0
  29. package/dist/__tests__/cli-build.test.d.ts +2 -0
  30. package/dist/__tests__/cli-build.test.d.ts.map +1 -0
  31. package/dist/__tests__/cli-build.test.js +640 -0
  32. package/dist/__tests__/cli-build.test.js.map +1 -0
  33. package/dist/__tests__/codex-deploy-config.test.js +60 -0
  34. package/dist/__tests__/codex-deploy-config.test.js.map +1 -1
  35. package/dist/__tests__/completion-rows-discriminate.test.d.ts +20 -0
  36. package/dist/__tests__/completion-rows-discriminate.test.d.ts.map +1 -0
  37. package/dist/__tests__/completion-rows-discriminate.test.js +481 -0
  38. package/dist/__tests__/completion-rows-discriminate.test.js.map +1 -0
  39. package/dist/__tests__/config-fidelity-archived-symlinks.test.d.ts +2 -0
  40. package/dist/__tests__/config-fidelity-archived-symlinks.test.d.ts.map +1 -0
  41. package/dist/__tests__/config-fidelity-archived-symlinks.test.js +127 -0
  42. package/dist/__tests__/config-fidelity-archived-symlinks.test.js.map +1 -0
  43. package/dist/__tests__/config-fidelity-display.test.d.ts +2 -0
  44. package/dist/__tests__/config-fidelity-display.test.d.ts.map +1 -0
  45. package/dist/__tests__/config-fidelity-display.test.js +77 -0
  46. package/dist/__tests__/config-fidelity-display.test.js.map +1 -0
  47. package/dist/__tests__/config-fidelity.test.js +166 -33
  48. package/dist/__tests__/config-fidelity.test.js.map +1 -1
  49. package/dist/__tests__/config-generation-gate.test.js +78 -0
  50. package/dist/__tests__/config-generation-gate.test.js.map +1 -1
  51. package/dist/__tests__/config-sync.test.js +89 -1
  52. package/dist/__tests__/config-sync.test.js.map +1 -1
  53. package/dist/__tests__/coordination-401-production-wiring.test.js +12 -7
  54. package/dist/__tests__/coordination-401-production-wiring.test.js.map +1 -1
  55. package/dist/__tests__/coordination-401-recovery.test.js +39 -32
  56. package/dist/__tests__/coordination-401-recovery.test.js.map +1 -1
  57. package/dist/__tests__/coordination-brief-pin.test.js +21 -8
  58. package/dist/__tests__/coordination-brief-pin.test.js.map +1 -1
  59. package/dist/__tests__/coordination-client.test.js +227 -3
  60. package/dist/__tests__/coordination-client.test.js.map +1 -1
  61. package/dist/__tests__/coordination-credential-endpoint.test.d.ts +24 -0
  62. package/dist/__tests__/coordination-credential-endpoint.test.d.ts.map +1 -0
  63. package/dist/__tests__/coordination-credential-endpoint.test.js +1230 -0
  64. package/dist/__tests__/coordination-credential-endpoint.test.js.map +1 -0
  65. package/dist/__tests__/coordination-memory.test.js +20 -4
  66. package/dist/__tests__/coordination-memory.test.js.map +1 -1
  67. package/dist/__tests__/coordination-provision.test.js +22 -14
  68. package/dist/__tests__/coordination-provision.test.js.map +1 -1
  69. package/dist/__tests__/coordination-status-registration.test.d.ts +16 -0
  70. package/dist/__tests__/coordination-status-registration.test.d.ts.map +1 -0
  71. package/dist/__tests__/coordination-status-registration.test.js +480 -0
  72. package/dist/__tests__/coordination-status-registration.test.js.map +1 -0
  73. package/dist/__tests__/coordination-token-multitenant.test.js +11 -11
  74. package/dist/__tests__/coordination-token-multitenant.test.js.map +1 -1
  75. package/dist/__tests__/coordination-token.test.js +35 -28
  76. package/dist/__tests__/coordination-token.test.js.map +1 -1
  77. package/dist/__tests__/creation-pr-class-check.test.d.ts +17 -0
  78. package/dist/__tests__/creation-pr-class-check.test.d.ts.map +1 -0
  79. package/dist/__tests__/creation-pr-class-check.test.js +346 -0
  80. package/dist/__tests__/creation-pr-class-check.test.js.map +1 -0
  81. package/dist/__tests__/decision-check.test.d.ts +2 -0
  82. package/dist/__tests__/decision-check.test.d.ts.map +1 -0
  83. package/dist/__tests__/decision-check.test.js +105 -0
  84. package/dist/__tests__/decision-check.test.js.map +1 -0
  85. package/dist/__tests__/digest-team-omission.test.d.ts +15 -0
  86. package/dist/__tests__/digest-team-omission.test.d.ts.map +1 -0
  87. package/dist/__tests__/digest-team-omission.test.js +247 -0
  88. package/dist/__tests__/digest-team-omission.test.js.map +1 -0
  89. package/dist/__tests__/doctor-worktree-path.test.d.ts +17 -0
  90. package/dist/__tests__/doctor-worktree-path.test.d.ts.map +1 -0
  91. package/dist/__tests__/doctor-worktree-path.test.js +158 -0
  92. package/dist/__tests__/doctor-worktree-path.test.js.map +1 -0
  93. package/dist/__tests__/fleet-data.test.js +40 -7
  94. package/dist/__tests__/fleet-data.test.js.map +1 -1
  95. package/dist/__tests__/fleet-tmux.test.js +2 -2
  96. package/dist/__tests__/fleet-tmux.test.js.map +1 -1
  97. package/dist/__tests__/generate-claude.test.js +137 -3
  98. package/dist/__tests__/generate-claude.test.js.map +1 -1
  99. package/dist/__tests__/git-env.test.d.ts +14 -0
  100. package/dist/__tests__/git-env.test.d.ts.map +1 -0
  101. package/dist/__tests__/git-env.test.js +131 -0
  102. package/dist/__tests__/git-env.test.js.map +1 -0
  103. package/dist/__tests__/git-identity-isolation.test.d.ts +33 -0
  104. package/dist/__tests__/git-identity-isolation.test.d.ts.map +1 -0
  105. package/dist/__tests__/git-identity-isolation.test.js +626 -0
  106. package/dist/__tests__/git-identity-isolation.test.js.map +1 -0
  107. package/dist/__tests__/harness-extract.test.d.ts +19 -0
  108. package/dist/__tests__/harness-extract.test.d.ts.map +1 -0
  109. package/dist/__tests__/harness-extract.test.js +566 -0
  110. package/dist/__tests__/harness-extract.test.js.map +1 -0
  111. package/dist/__tests__/harness-wiring.test.d.ts +16 -0
  112. package/dist/__tests__/harness-wiring.test.d.ts.map +1 -0
  113. package/dist/__tests__/harness-wiring.test.js +469 -0
  114. package/dist/__tests__/harness-wiring.test.js.map +1 -0
  115. package/dist/__tests__/hook-heal.test.js +17 -0
  116. package/dist/__tests__/hook-heal.test.js.map +1 -1
  117. package/dist/__tests__/init-coordination-url.test.d.ts +11 -0
  118. package/dist/__tests__/init-coordination-url.test.d.ts.map +1 -0
  119. package/dist/__tests__/init-coordination-url.test.js +114 -0
  120. package/dist/__tests__/init-coordination-url.test.js.map +1 -0
  121. package/dist/__tests__/memory-autocreate.test.js +574 -8
  122. package/dist/__tests__/memory-autocreate.test.js.map +1 -1
  123. package/dist/__tests__/memory-log-result.test.d.ts +13 -0
  124. package/dist/__tests__/memory-log-result.test.d.ts.map +1 -0
  125. package/dist/__tests__/memory-log-result.test.js +113 -0
  126. package/dist/__tests__/memory-log-result.test.js.map +1 -0
  127. package/dist/__tests__/memory-named-exists.test.d.ts +16 -0
  128. package/dist/__tests__/memory-named-exists.test.d.ts.map +1 -0
  129. package/dist/__tests__/memory-named-exists.test.js +288 -0
  130. package/dist/__tests__/memory-named-exists.test.js.map +1 -0
  131. package/dist/__tests__/mx-agent-cli-pin-validation.test.js +23 -47
  132. package/dist/__tests__/mx-agent-cli-pin-validation.test.js.map +1 -1
  133. package/dist/__tests__/mx-agent-cli-version-pin.test.js +34 -88
  134. package/dist/__tests__/mx-agent-cli-version-pin.test.js.map +1 -1
  135. package/dist/__tests__/new-project-first-team.test.d.ts +15 -0
  136. package/dist/__tests__/new-project-first-team.test.d.ts.map +1 -0
  137. package/dist/__tests__/new-project-first-team.test.js +263 -0
  138. package/dist/__tests__/new-project-first-team.test.js.map +1 -0
  139. package/dist/__tests__/otel-env.test.d.ts +2 -0
  140. package/dist/__tests__/otel-env.test.d.ts.map +1 -0
  141. package/dist/__tests__/otel-env.test.js +127 -0
  142. package/dist/__tests__/otel-env.test.js.map +1 -0
  143. package/dist/__tests__/project-config.test.js +283 -1
  144. package/dist/__tests__/project-config.test.js.map +1 -1
  145. package/dist/__tests__/provision-behavioral-contract.test.js +96 -4
  146. package/dist/__tests__/provision-behavioral-contract.test.js.map +1 -1
  147. package/dist/__tests__/provision-catalog-precondition.test.d.ts +26 -0
  148. package/dist/__tests__/provision-catalog-precondition.test.d.ts.map +1 -0
  149. package/dist/__tests__/provision-catalog-precondition.test.js +620 -0
  150. package/dist/__tests__/provision-catalog-precondition.test.js.map +1 -0
  151. package/dist/__tests__/provision-completion-rows.test.d.ts +17 -0
  152. package/dist/__tests__/provision-completion-rows.test.d.ts.map +1 -0
  153. package/dist/__tests__/provision-completion-rows.test.js +3095 -0
  154. package/dist/__tests__/provision-completion-rows.test.js.map +1 -0
  155. package/dist/__tests__/provision-identity-gate.test.d.ts +20 -0
  156. package/dist/__tests__/provision-identity-gate.test.d.ts.map +1 -0
  157. package/dist/__tests__/provision-identity-gate.test.js +600 -0
  158. package/dist/__tests__/provision-identity-gate.test.js.map +1 -0
  159. package/dist/__tests__/provision-resume.test.d.ts +26 -0
  160. package/dist/__tests__/provision-resume.test.d.ts.map +1 -0
  161. package/dist/__tests__/provision-resume.test.js +1164 -0
  162. package/dist/__tests__/provision-resume.test.js.map +1 -0
  163. package/dist/__tests__/provision-roleguide-anchors.test.d.ts +27 -0
  164. package/dist/__tests__/provision-roleguide-anchors.test.d.ts.map +1 -0
  165. package/dist/__tests__/provision-roleguide-anchors.test.js +747 -0
  166. package/dist/__tests__/provision-roleguide-anchors.test.js.map +1 -0
  167. package/dist/__tests__/provision-skeleton-fill.test.d.ts +16 -0
  168. package/dist/__tests__/provision-skeleton-fill.test.d.ts.map +1 -0
  169. package/dist/__tests__/provision-skeleton-fill.test.js +488 -0
  170. package/dist/__tests__/provision-skeleton-fill.test.js.map +1 -0
  171. package/dist/__tests__/provision-teambuilder-flow.test.js +93 -7
  172. package/dist/__tests__/provision-teambuilder-flow.test.js.map +1 -1
  173. package/dist/__tests__/repo-guard-wiring.test.d.ts +21 -0
  174. package/dist/__tests__/repo-guard-wiring.test.d.ts.map +1 -0
  175. package/dist/__tests__/repo-guard-wiring.test.js +638 -0
  176. package/dist/__tests__/repo-guard-wiring.test.js.map +1 -0
  177. package/dist/__tests__/report-format.test.d.ts +2 -0
  178. package/dist/__tests__/report-format.test.d.ts.map +1 -0
  179. package/dist/__tests__/report-format.test.js +219 -0
  180. package/dist/__tests__/report-format.test.js.map +1 -0
  181. package/dist/__tests__/runtime-codex-gateway-pilot.test.d.ts +2 -0
  182. package/dist/__tests__/runtime-codex-gateway-pilot.test.d.ts.map +1 -0
  183. package/dist/__tests__/runtime-codex-gateway-pilot.test.js +309 -0
  184. package/dist/__tests__/runtime-codex-gateway-pilot.test.js.map +1 -0
  185. package/dist/__tests__/runtime-codex-gateway-provider.test.d.ts +2 -0
  186. package/dist/__tests__/runtime-codex-gateway-provider.test.d.ts.map +1 -0
  187. package/dist/__tests__/runtime-codex-gateway-provider.test.js +163 -0
  188. package/dist/__tests__/runtime-codex-gateway-provider.test.js.map +1 -0
  189. package/dist/__tests__/runtime-identity.test.d.ts +2 -0
  190. package/dist/__tests__/runtime-identity.test.d.ts.map +1 -0
  191. package/dist/__tests__/runtime-identity.test.js +117 -0
  192. package/dist/__tests__/runtime-identity.test.js.map +1 -0
  193. package/dist/__tests__/session-pause-provisioning.test.js +6 -1
  194. package/dist/__tests__/session-pause-provisioning.test.js.map +1 -1
  195. package/dist/__tests__/session-record-disclosure.test.d.ts +24 -0
  196. package/dist/__tests__/session-record-disclosure.test.d.ts.map +1 -0
  197. package/dist/__tests__/session-record-disclosure.test.js +494 -0
  198. package/dist/__tests__/session-record-disclosure.test.js.map +1 -0
  199. package/dist/__tests__/session.test.js +35 -0
  200. package/dist/__tests__/session.test.js.map +1 -1
  201. package/dist/__tests__/slug-validation.test.js +27 -21
  202. package/dist/__tests__/slug-validation.test.js.map +1 -1
  203. package/dist/__tests__/standards-injection.test.d.ts +2 -0
  204. package/dist/__tests__/standards-injection.test.d.ts.map +1 -0
  205. package/dist/__tests__/standards-injection.test.js +179 -0
  206. package/dist/__tests__/standards-injection.test.js.map +1 -0
  207. package/dist/__tests__/start-interactive-role.test.d.ts +22 -0
  208. package/dist/__tests__/start-interactive-role.test.d.ts.map +1 -0
  209. package/dist/__tests__/start-interactive-role.test.js +204 -0
  210. package/dist/__tests__/start-interactive-role.test.js.map +1 -0
  211. package/dist/__tests__/start-team-identity.test.d.ts +25 -0
  212. package/dist/__tests__/start-team-identity.test.d.ts.map +1 -0
  213. package/dist/__tests__/start-team-identity.test.js +307 -0
  214. package/dist/__tests__/start-team-identity.test.js.map +1 -0
  215. package/dist/__tests__/team-memory-commands.test.js +142 -19
  216. package/dist/__tests__/team-memory-commands.test.js.map +1 -1
  217. package/dist/__tests__/template-sync.test.d.ts +19 -0
  218. package/dist/__tests__/template-sync.test.d.ts.map +1 -0
  219. package/dist/__tests__/template-sync.test.js +270 -0
  220. package/dist/__tests__/template-sync.test.js.map +1 -0
  221. package/dist/__tests__/test-project.test.d.ts +18 -0
  222. package/dist/__tests__/test-project.test.d.ts.map +1 -0
  223. package/dist/__tests__/test-project.test.js +465 -0
  224. package/dist/__tests__/test-project.test.js.map +1 -0
  225. package/dist/__tests__/usage-per-call-grouping.test.d.ts +25 -0
  226. package/dist/__tests__/usage-per-call-grouping.test.d.ts.map +1 -0
  227. package/dist/__tests__/usage-per-call-grouping.test.js +952 -0
  228. package/dist/__tests__/usage-per-call-grouping.test.js.map +1 -0
  229. package/dist/__tests__/verify-hooks-check-all.test.d.ts +32 -0
  230. package/dist/__tests__/verify-hooks-check-all.test.d.ts.map +1 -0
  231. package/dist/__tests__/verify-hooks-check-all.test.js +553 -0
  232. package/dist/__tests__/verify-hooks-check-all.test.js.map +1 -0
  233. package/dist/__tests__/worktree-sync-fixture.test.d.ts +17 -0
  234. package/dist/__tests__/worktree-sync-fixture.test.d.ts.map +1 -0
  235. package/dist/__tests__/worktree-sync-fixture.test.js +519 -0
  236. package/dist/__tests__/worktree-sync-fixture.test.js.map +1 -0
  237. package/dist/__tests__/worktree-sync-hardening.test.d.ts +13 -0
  238. package/dist/__tests__/worktree-sync-hardening.test.d.ts.map +1 -0
  239. package/dist/__tests__/worktree-sync-hardening.test.js +919 -0
  240. package/dist/__tests__/worktree-sync-hardening.test.js.map +1 -0
  241. package/dist/__tests__/worktree-sync-shell-free.test.d.ts +25 -0
  242. package/dist/__tests__/worktree-sync-shell-free.test.d.ts.map +1 -0
  243. package/dist/__tests__/worktree-sync-shell-free.test.js +185 -0
  244. package/dist/__tests__/worktree-sync-shell-free.test.js.map +1 -0
  245. package/dist/__tests__/worktree.test.js +75 -1
  246. package/dist/__tests__/worktree.test.js.map +1 -1
  247. package/dist/agent-config/.mx-config-generation.json +2 -2
  248. package/dist/agent-config/AGENTS.md.template +2 -2
  249. package/dist/agent-config/agents/bar-raiser.md +34 -1
  250. package/dist/agent-config/agents/red-team.md +34 -1
  251. package/dist/agent-config/agents/security-reviewer.md +22 -1
  252. package/dist/agent-config/claude-md/CLAUDE.core.md +6 -1
  253. package/dist/agent-config/claude-md/CLAUDE.overlay.memnexus.md +1 -3
  254. package/dist/agent-config/coordination-rosters.generated.json +10 -0
  255. package/dist/agent-config/hooks/HOOK-TIMEOUTS.md +27 -1
  256. package/dist/agent-config/hooks/OR-TRUE-AUDIT.md +8 -8
  257. package/dist/agent-config/hooks/auto-capture-precompact.sh +180 -83
  258. package/dist/agent-config/hooks/auto-capture-session-end.sh +216 -87
  259. package/dist/agent-config/hooks/auto-checkpoint.sh +75 -5
  260. package/dist/agent-config/hooks/coordination-brief.sh +290 -245
  261. package/dist/agent-config/hooks/deploy-verification-reminder.sh +359 -22
  262. package/dist/agent-config/hooks/git-mutation-guard.sh +85 -13
  263. package/dist/agent-config/hooks/observability-sync.sh +46 -9
  264. package/dist/agent-config/hooks/session-idle-gate.sh +177 -12
  265. package/dist/agent-config/hooks/subagent-write-guard.sh +670 -0
  266. package/dist/agent-config/hooks/worktree-guard.sh +36 -7
  267. package/dist/agent-config/settings.json +15 -2
  268. package/dist/agent-config/shared/creation-pr-review-checklist.md +317 -0
  269. package/dist/commands/bootstrap.d.ts.map +1 -1
  270. package/dist/commands/bootstrap.js +22 -10
  271. package/dist/commands/bootstrap.js.map +1 -1
  272. package/dist/commands/config-sync.d.ts +37 -0
  273. package/dist/commands/config-sync.d.ts.map +1 -1
  274. package/dist/commands/config-sync.js +36 -18
  275. package/dist/commands/config-sync.js.map +1 -1
  276. package/dist/commands/config.d.ts.map +1 -1
  277. package/dist/commands/config.js +28 -1
  278. package/dist/commands/config.js.map +1 -1
  279. package/dist/commands/coordination.d.ts +150 -8
  280. package/dist/commands/coordination.d.ts.map +1 -1
  281. package/dist/commands/coordination.js +519 -25
  282. package/dist/commands/coordination.js.map +1 -1
  283. package/dist/commands/create.d.ts +913 -1
  284. package/dist/commands/create.d.ts.map +1 -1
  285. package/dist/commands/create.js +4879 -345
  286. package/dist/commands/create.js.map +1 -1
  287. package/dist/commands/dashboard.d.ts.map +1 -1
  288. package/dist/commands/dashboard.js +10 -2
  289. package/dist/commands/dashboard.js.map +1 -1
  290. package/dist/commands/decision.d.ts +20 -0
  291. package/dist/commands/decision.d.ts.map +1 -0
  292. package/dist/commands/decision.js +54 -0
  293. package/dist/commands/decision.js.map +1 -0
  294. package/dist/commands/digest.d.ts.map +1 -1
  295. package/dist/commands/digest.js +91 -7
  296. package/dist/commands/digest.js.map +1 -1
  297. package/dist/commands/fleet-tmux.js +1 -1
  298. package/dist/commands/fleet-tmux.js.map +1 -1
  299. package/dist/commands/init.d.ts +8 -0
  300. package/dist/commands/init.d.ts.map +1 -1
  301. package/dist/commands/init.js +26 -1
  302. package/dist/commands/init.js.map +1 -1
  303. package/dist/commands/list.d.ts +32 -1
  304. package/dist/commands/list.d.ts.map +1 -1
  305. package/dist/commands/list.js +98 -5
  306. package/dist/commands/list.js.map +1 -1
  307. package/dist/commands/monitor.d.ts.map +1 -1
  308. package/dist/commands/monitor.js +8 -2
  309. package/dist/commands/monitor.js.map +1 -1
  310. package/dist/commands/new.d.ts +2 -0
  311. package/dist/commands/new.d.ts.map +1 -1
  312. package/dist/commands/new.js +114 -21
  313. package/dist/commands/new.js.map +1 -1
  314. package/dist/commands/report.d.ts +33 -0
  315. package/dist/commands/report.d.ts.map +1 -0
  316. package/dist/commands/report.js +73 -0
  317. package/dist/commands/report.js.map +1 -0
  318. package/dist/commands/session.js +1 -1
  319. package/dist/commands/session.js.map +1 -1
  320. package/dist/commands/start.d.ts +42 -0
  321. package/dist/commands/start.d.ts.map +1 -1
  322. package/dist/commands/start.js +177 -8
  323. package/dist/commands/start.js.map +1 -1
  324. package/dist/commands/sync.d.ts +57 -0
  325. package/dist/commands/sync.d.ts.map +1 -1
  326. package/dist/commands/sync.js +117 -3
  327. package/dist/commands/sync.js.map +1 -1
  328. package/dist/commands/update.d.ts +13 -1
  329. package/dist/commands/update.d.ts.map +1 -1
  330. package/dist/commands/update.js +50 -1
  331. package/dist/commands/update.js.map +1 -1
  332. package/dist/commands/usage.d.ts +64 -0
  333. package/dist/commands/usage.d.ts.map +1 -1
  334. package/dist/commands/usage.js +96 -3
  335. package/dist/commands/usage.js.map +1 -1
  336. package/dist/commands/verify-hooks.d.ts +37 -1
  337. package/dist/commands/verify-hooks.d.ts.map +1 -1
  338. package/dist/commands/verify-hooks.js +114 -2
  339. package/dist/commands/verify-hooks.js.map +1 -1
  340. package/dist/commands/window.d.ts +10 -0
  341. package/dist/commands/window.d.ts.map +1 -0
  342. package/dist/commands/window.js +265 -0
  343. package/dist/commands/window.js.map +1 -0
  344. package/dist/commands/worktree-sync.d.ts +54 -0
  345. package/dist/commands/worktree-sync.d.ts.map +1 -0
  346. package/dist/commands/worktree-sync.js +135 -0
  347. package/dist/commands/worktree-sync.js.map +1 -0
  348. package/dist/index.d.ts.map +1 -1
  349. package/dist/index.js +189 -14
  350. package/dist/index.js.map +1 -1
  351. package/dist/lib/agent-session.d.ts +12 -0
  352. package/dist/lib/agent-session.d.ts.map +1 -1
  353. package/dist/lib/agent-session.js +189 -42
  354. package/dist/lib/agent-session.js.map +1 -1
  355. package/dist/lib/catalog.d.ts +321 -2
  356. package/dist/lib/catalog.d.ts.map +1 -1
  357. package/dist/lib/catalog.js +490 -11
  358. package/dist/lib/catalog.js.map +1 -1
  359. package/dist/lib/claude.d.ts +65 -23
  360. package/dist/lib/claude.d.ts.map +1 -1
  361. package/dist/lib/claude.js +335 -19
  362. package/dist/lib/claude.js.map +1 -1
  363. package/dist/lib/cli-build.d.ts +172 -0
  364. package/dist/lib/cli-build.d.ts.map +1 -0
  365. package/dist/lib/cli-build.js +654 -0
  366. package/dist/lib/cli-build.js.map +1 -0
  367. package/dist/lib/code-context-file.d.ts +109 -0
  368. package/dist/lib/code-context-file.d.ts.map +1 -0
  369. package/dist/lib/code-context-file.js +219 -0
  370. package/dist/lib/code-context-file.js.map +1 -0
  371. package/dist/lib/code-context-file.test.d.ts +19 -0
  372. package/dist/lib/code-context-file.test.d.ts.map +1 -0
  373. package/dist/lib/code-context-file.test.js +202 -0
  374. package/dist/lib/code-context-file.test.js.map +1 -0
  375. package/dist/lib/config-fidelity.d.ts +40 -20
  376. package/dist/lib/config-fidelity.d.ts.map +1 -1
  377. package/dist/lib/config-fidelity.js +144 -56
  378. package/dist/lib/config-fidelity.js.map +1 -1
  379. package/dist/lib/coordination-client.d.ts +73 -0
  380. package/dist/lib/coordination-client.d.ts.map +1 -1
  381. package/dist/lib/coordination-client.js +180 -8
  382. package/dist/lib/coordination-client.js.map +1 -1
  383. package/dist/lib/coordination-token.d.ts +304 -6
  384. package/dist/lib/coordination-token.d.ts.map +1 -1
  385. package/dist/lib/coordination-token.js +851 -52
  386. package/dist/lib/coordination-token.js.map +1 -1
  387. package/dist/lib/decision-check.d.ts +48 -0
  388. package/dist/lib/decision-check.d.ts.map +1 -0
  389. package/dist/lib/decision-check.js +149 -0
  390. package/dist/lib/decision-check.js.map +1 -0
  391. package/dist/lib/fleet-data.d.ts +34 -0
  392. package/dist/lib/fleet-data.d.ts.map +1 -1
  393. package/dist/lib/fleet-data.js +37 -9
  394. package/dist/lib/fleet-data.js.map +1 -1
  395. package/dist/lib/fleet-render.js +1 -1
  396. package/dist/lib/fleet-render.js.map +1 -1
  397. package/dist/lib/git-identity.d.ts +302 -0
  398. package/dist/lib/git-identity.d.ts.map +1 -0
  399. package/dist/lib/git-identity.js +546 -0
  400. package/dist/lib/git-identity.js.map +1 -0
  401. package/dist/lib/harness/console/announce.d.ts +45 -0
  402. package/dist/lib/harness/console/announce.d.ts.map +1 -0
  403. package/dist/lib/harness/console/announce.js +48 -0
  404. package/dist/lib/harness/console/announce.js.map +1 -0
  405. package/dist/lib/harness/console/announce.test.d.ts +2 -0
  406. package/dist/lib/harness/console/announce.test.d.ts.map +1 -0
  407. package/dist/lib/harness/console/announce.test.js +104 -0
  408. package/dist/lib/harness/console/announce.test.js.map +1 -0
  409. package/dist/lib/harness/console/by-session.d.ts +50 -0
  410. package/dist/lib/harness/console/by-session.d.ts.map +1 -0
  411. package/dist/lib/harness/console/by-session.js +83 -0
  412. package/dist/lib/harness/console/by-session.js.map +1 -0
  413. package/dist/lib/harness/console/by-session.test.d.ts +2 -0
  414. package/dist/lib/harness/console/by-session.test.d.ts.map +1 -0
  415. package/dist/lib/harness/console/by-session.test.js +86 -0
  416. package/dist/lib/harness/console/by-session.test.js.map +1 -0
  417. package/dist/lib/harness/console/console.d.ts +67 -0
  418. package/dist/lib/harness/console/console.d.ts.map +1 -0
  419. package/dist/lib/harness/console/console.js +373 -0
  420. package/dist/lib/harness/console/console.js.map +1 -0
  421. package/dist/lib/harness/console/console.test.d.ts +2 -0
  422. package/dist/lib/harness/console/console.test.d.ts.map +1 -0
  423. package/dist/lib/harness/console/console.test.js +269 -0
  424. package/dist/lib/harness/console/console.test.js.map +1 -0
  425. package/dist/lib/harness/console/decision-request.d.ts +32 -0
  426. package/dist/lib/harness/console/decision-request.d.ts.map +1 -0
  427. package/dist/lib/harness/console/decision-request.js +112 -0
  428. package/dist/lib/harness/console/decision-request.js.map +1 -0
  429. package/dist/lib/harness/console/decision-request.test.d.ts +2 -0
  430. package/dist/lib/harness/console/decision-request.test.d.ts.map +1 -0
  431. package/dist/lib/harness/console/decision-request.test.js +75 -0
  432. package/dist/lib/harness/console/decision-request.test.js.map +1 -0
  433. package/dist/lib/harness/console/fixtures.d.ts +16 -0
  434. package/dist/lib/harness/console/fixtures.d.ts.map +1 -0
  435. package/dist/lib/harness/console/fixtures.js +49 -0
  436. package/dist/lib/harness/console/fixtures.js.map +1 -0
  437. package/dist/lib/harness/console/index.d.ts +15 -0
  438. package/dist/lib/harness/console/index.d.ts.map +1 -0
  439. package/dist/lib/harness/console/index.js +14 -0
  440. package/dist/lib/harness/console/index.js.map +1 -0
  441. package/dist/lib/harness/console/rank.d.ts +73 -0
  442. package/dist/lib/harness/console/rank.d.ts.map +1 -0
  443. package/dist/lib/harness/console/rank.js +113 -0
  444. package/dist/lib/harness/console/rank.js.map +1 -0
  445. package/dist/lib/harness/console/rank.test.d.ts +2 -0
  446. package/dist/lib/harness/console/rank.test.d.ts.map +1 -0
  447. package/dist/lib/harness/console/rank.test.js +124 -0
  448. package/dist/lib/harness/console/rank.test.js.map +1 -0
  449. package/dist/lib/harness/console/render.d.ts +22 -0
  450. package/dist/lib/harness/console/render.d.ts.map +1 -0
  451. package/dist/lib/harness/console/render.js +65 -0
  452. package/dist/lib/harness/console/render.js.map +1 -0
  453. package/dist/lib/harness/console/render.test.d.ts +2 -0
  454. package/dist/lib/harness/console/render.test.d.ts.map +1 -0
  455. package/dist/lib/harness/console/render.test.js +96 -0
  456. package/dist/lib/harness/console/render.test.js.map +1 -0
  457. package/dist/lib/harness/console/replay-cli.test.d.ts +2 -0
  458. package/dist/lib/harness/console/replay-cli.test.d.ts.map +1 -0
  459. package/dist/lib/harness/console/replay-cli.test.js +96 -0
  460. package/dist/lib/harness/console/replay-cli.test.js.map +1 -0
  461. package/dist/lib/harness/console/replay.d.ts +36 -0
  462. package/dist/lib/harness/console/replay.d.ts.map +1 -0
  463. package/dist/lib/harness/console/replay.js +59 -0
  464. package/dist/lib/harness/console/replay.js.map +1 -0
  465. package/dist/lib/harness/console/replay.test.d.ts +2 -0
  466. package/dist/lib/harness/console/replay.test.d.ts.map +1 -0
  467. package/dist/lib/harness/console/replay.test.js +81 -0
  468. package/dist/lib/harness/console/replay.test.js.map +1 -0
  469. package/dist/lib/harness/console/turn-reader.d.ts +50 -0
  470. package/dist/lib/harness/console/turn-reader.d.ts.map +1 -0
  471. package/dist/lib/harness/console/turn-reader.js +184 -0
  472. package/dist/lib/harness/console/turn-reader.js.map +1 -0
  473. package/dist/lib/harness/console/turn-reader.test.d.ts +2 -0
  474. package/dist/lib/harness/console/turn-reader.test.d.ts.map +1 -0
  475. package/dist/lib/harness/console/turn-reader.test.js +108 -0
  476. package/dist/lib/harness/console/turn-reader.test.js.map +1 -0
  477. package/dist/lib/harness/console/types.d.ts +109 -0
  478. package/dist/lib/harness/console/types.d.ts.map +1 -0
  479. package/dist/lib/harness/console/types.js +2 -0
  480. package/dist/lib/harness/console/types.js.map +1 -0
  481. package/dist/lib/harness/contract.d.ts +229 -0
  482. package/dist/lib/harness/contract.d.ts.map +1 -0
  483. package/dist/lib/harness/contract.js +22 -0
  484. package/dist/lib/harness/contract.js.map +1 -0
  485. package/dist/lib/harness/credential.d.ts +23 -0
  486. package/dist/lib/harness/credential.d.ts.map +1 -0
  487. package/dist/lib/harness/credential.js +81 -0
  488. package/dist/lib/harness/credential.js.map +1 -0
  489. package/dist/lib/harness/credential.test.d.ts +2 -0
  490. package/dist/lib/harness/credential.test.d.ts.map +1 -0
  491. package/dist/lib/harness/credential.test.js +74 -0
  492. package/dist/lib/harness/credential.test.js.map +1 -0
  493. package/dist/lib/harness/evaluate.d.ts +390 -0
  494. package/dist/lib/harness/evaluate.d.ts.map +1 -0
  495. package/dist/lib/harness/evaluate.js +988 -0
  496. package/dist/lib/harness/evaluate.js.map +1 -0
  497. package/dist/lib/harness/evaluate.test.d.ts +2 -0
  498. package/dist/lib/harness/evaluate.test.d.ts.map +1 -0
  499. package/dist/lib/harness/evaluate.test.js +621 -0
  500. package/dist/lib/harness/evaluate.test.js.map +1 -0
  501. package/dist/lib/harness/extract.d.ts +152 -0
  502. package/dist/lib/harness/extract.d.ts.map +1 -0
  503. package/dist/lib/harness/extract.js +1601 -0
  504. package/dist/lib/harness/extract.js.map +1 -0
  505. package/dist/lib/harness/gate.d.ts +48 -0
  506. package/dist/lib/harness/gate.d.ts.map +1 -0
  507. package/dist/lib/harness/gate.js +60 -0
  508. package/dist/lib/harness/gate.js.map +1 -0
  509. package/dist/lib/harness/gate.test.d.ts +2 -0
  510. package/dist/lib/harness/gate.test.d.ts.map +1 -0
  511. package/dist/lib/harness/gate.test.js +111 -0
  512. package/dist/lib/harness/gate.test.js.map +1 -0
  513. package/dist/lib/harness/self-check.d.ts +59 -0
  514. package/dist/lib/harness/self-check.d.ts.map +1 -0
  515. package/dist/lib/harness/self-check.js +56 -0
  516. package/dist/lib/harness/self-check.js.map +1 -0
  517. package/dist/lib/harness/self-check.test.d.ts +2 -0
  518. package/dist/lib/harness/self-check.test.d.ts.map +1 -0
  519. package/dist/lib/harness/self-check.test.js +43 -0
  520. package/dist/lib/harness/self-check.test.js.map +1 -0
  521. package/dist/lib/harness/transcript.d.ts +65 -0
  522. package/dist/lib/harness/transcript.d.ts.map +1 -0
  523. package/dist/lib/harness/transcript.js +144 -0
  524. package/dist/lib/harness/transcript.js.map +1 -0
  525. package/dist/lib/harness/transcript.test.d.ts +2 -0
  526. package/dist/lib/harness/transcript.test.d.ts.map +1 -0
  527. package/dist/lib/harness/transcript.test.js +118 -0
  528. package/dist/lib/harness/transcript.test.js.map +1 -0
  529. package/dist/lib/harness-wiring.d.ts +145 -0
  530. package/dist/lib/harness-wiring.d.ts.map +1 -0
  531. package/dist/lib/harness-wiring.js +280 -0
  532. package/dist/lib/harness-wiring.js.map +1 -0
  533. package/dist/lib/hook-staleness.d.ts +95 -0
  534. package/dist/lib/hook-staleness.d.ts.map +1 -0
  535. package/dist/lib/hook-staleness.js +304 -0
  536. package/dist/lib/hook-staleness.js.map +1 -0
  537. package/dist/lib/jsonl.d.ts +270 -2
  538. package/dist/lib/jsonl.d.ts.map +1 -1
  539. package/dist/lib/jsonl.js +472 -76
  540. package/dist/lib/jsonl.js.map +1 -1
  541. package/dist/lib/memory.d.ts +350 -23
  542. package/dist/lib/memory.d.ts.map +1 -1
  543. package/dist/lib/memory.js +751 -38
  544. package/dist/lib/memory.js.map +1 -1
  545. package/dist/lib/otel-env.d.ts +90 -0
  546. package/dist/lib/otel-env.d.ts.map +1 -0
  547. package/dist/lib/otel-env.js +98 -0
  548. package/dist/lib/otel-env.js.map +1 -0
  549. package/dist/lib/project-config.d.ts +167 -0
  550. package/dist/lib/project-config.d.ts.map +1 -1
  551. package/dist/lib/project-config.js +321 -5
  552. package/dist/lib/project-config.js.map +1 -1
  553. package/dist/lib/projects-registry.d.ts +82 -0
  554. package/dist/lib/projects-registry.d.ts.map +1 -0
  555. package/dist/lib/projects-registry.js +145 -0
  556. package/dist/lib/projects-registry.js.map +1 -0
  557. package/dist/lib/projects-registry.test.d.ts +2 -0
  558. package/dist/lib/projects-registry.test.d.ts.map +1 -0
  559. package/dist/lib/projects-registry.test.js +176 -0
  560. package/dist/lib/projects-registry.test.js.map +1 -0
  561. package/dist/lib/repo-guard-scope.d.ts +126 -0
  562. package/dist/lib/repo-guard-scope.d.ts.map +1 -0
  563. package/dist/lib/repo-guard-scope.js +249 -0
  564. package/dist/lib/repo-guard-scope.js.map +1 -0
  565. package/dist/lib/report-format.d.ts +132 -0
  566. package/dist/lib/report-format.d.ts.map +1 -0
  567. package/dist/lib/report-format.js +317 -0
  568. package/dist/lib/report-format.js.map +1 -0
  569. package/dist/lib/roster.d.ts +87 -0
  570. package/dist/lib/roster.d.ts.map +1 -0
  571. package/dist/lib/roster.js +332 -0
  572. package/dist/lib/roster.js.map +1 -0
  573. package/dist/lib/roster.test.d.ts +15 -0
  574. package/dist/lib/roster.test.d.ts.map +1 -0
  575. package/dist/lib/roster.test.js +299 -0
  576. package/dist/lib/roster.test.js.map +1 -0
  577. package/dist/lib/runtime/codex-adapter.d.ts.map +1 -1
  578. package/dist/lib/runtime/codex-adapter.js +5 -0
  579. package/dist/lib/runtime/codex-adapter.js.map +1 -1
  580. package/dist/lib/runtime/codex-config.d.ts +129 -0
  581. package/dist/lib/runtime/codex-config.d.ts.map +1 -1
  582. package/dist/lib/runtime/codex-config.js +225 -0
  583. package/dist/lib/runtime/codex-config.js.map +1 -1
  584. package/dist/lib/runtime/identity.d.ts +72 -0
  585. package/dist/lib/runtime/identity.d.ts.map +1 -0
  586. package/dist/lib/runtime/identity.js +128 -0
  587. package/dist/lib/runtime/identity.js.map +1 -0
  588. package/dist/lib/standards.d.ts +99 -0
  589. package/dist/lib/standards.d.ts.map +1 -0
  590. package/dist/lib/standards.js +201 -0
  591. package/dist/lib/standards.js.map +1 -0
  592. package/dist/lib/team-identity.d.ts +134 -0
  593. package/dist/lib/team-identity.d.ts.map +1 -0
  594. package/dist/lib/team-identity.js +193 -0
  595. package/dist/lib/team-identity.js.map +1 -0
  596. package/dist/lib/templates.d.ts +29 -2
  597. package/dist/lib/templates.d.ts.map +1 -1
  598. package/dist/lib/templates.js +1042 -82
  599. package/dist/lib/templates.js.map +1 -1
  600. package/dist/lib/terminal-ui.d.ts.map +1 -1
  601. package/dist/lib/terminal-ui.js +12 -1
  602. package/dist/lib/terminal-ui.js.map +1 -1
  603. package/dist/lib/test-project.d.ts +95 -0
  604. package/dist/lib/test-project.d.ts.map +1 -0
  605. package/dist/lib/test-project.js +103 -0
  606. package/dist/lib/test-project.js.map +1 -0
  607. package/dist/lib/vault.d.ts +60 -0
  608. package/dist/lib/vault.d.ts.map +1 -0
  609. package/dist/lib/vault.js +102 -0
  610. package/dist/lib/vault.js.map +1 -0
  611. package/dist/lib/vault.test.d.ts +17 -0
  612. package/dist/lib/vault.test.d.ts.map +1 -0
  613. package/dist/lib/vault.test.js +169 -0
  614. package/dist/lib/vault.test.js.map +1 -0
  615. package/dist/lib/window-view.d.ts +63 -0
  616. package/dist/lib/window-view.d.ts.map +1 -0
  617. package/dist/lib/window-view.js +217 -0
  618. package/dist/lib/window-view.js.map +1 -0
  619. package/dist/lib/window-view.test.d.ts +2 -0
  620. package/dist/lib/window-view.test.d.ts.map +1 -0
  621. package/dist/lib/window-view.test.js +168 -0
  622. package/dist/lib/window-view.test.js.map +1 -0
  623. package/dist/lib/worktree-sync.d.ts +439 -0
  624. package/dist/lib/worktree-sync.d.ts.map +1 -0
  625. package/dist/lib/worktree-sync.js +1167 -0
  626. package/dist/lib/worktree-sync.js.map +1 -0
  627. package/dist/lib/worktree.d.ts +58 -1
  628. package/dist/lib/worktree.d.ts.map +1 -1
  629. package/dist/lib/worktree.js +91 -4
  630. package/dist/lib/worktree.js.map +1 -1
  631. package/dist/standards/decision-request.md +98 -0
  632. package/dist/standards/fail-loud-standard.md +495 -0
  633. package/dist/standards/po-communication-standard.md +126 -0
  634. package/dist/standards/report-format.md +128 -0
  635. package/dist/standards/writing-standard.md +382 -0
  636. package/package.json +3 -2
  637. package/scripts/generate-claude.mjs +119 -46
@@ -0,0 +1,169 @@
1
+ /**
2
+ * The Key Vault probe behind row 10 (#77), through an injected spawn.
3
+ *
4
+ * Two properties are pinned here, and the first is a security property. The
5
+ * argv never asks for a secret VALUE: `az keyvault secret show` fetches the
6
+ * bundle including the value and filters client-side, so the token would reach
7
+ * this machine; `list-versions` calls GetSecretVersions, which returns metadata
8
+ * only (security ruling, 2026-08-22).
9
+ *
10
+ * The second is the three outcomes. A 403 or an expired login must answer
11
+ * `unresolvable`, never `absent`: absent tells the operator to mint a token, and
12
+ * minting on the evidence of a permission error is the wrong act.
13
+ *
14
+ * No test here runs `az`. Every outcome comes from the injected spawn.
15
+ */
16
+ import { describe, it, expect } from 'vitest';
17
+ import { vaultTokenPresent, vaultProbeArgv, VAULT_NAME } from './vault.js';
18
+ import { KEYVAULT_NAME, kvSecretName } from './coordination-token.js';
19
+ const PROJECT = 'mx-agent';
20
+ const SLUG = 'scratchteam';
21
+ /** A spawn that records what it was called with and returns a fixed result. */
22
+ function recorder(result) {
23
+ const calls = [];
24
+ const spawn = (command, args) => {
25
+ calls.push({ command, args });
26
+ return result;
27
+ };
28
+ return { calls, spawn };
29
+ }
30
+ describe('vaultProbeArgv: what the probe is allowed to ask for', () => {
31
+ it('lists versions and never shows, downloads or sets a secret', () => {
32
+ const argv = vaultProbeArgv(PROJECT, SLUG);
33
+ expect(argv).toContain('list-versions');
34
+ expect(argv).not.toContain('show');
35
+ expect(argv).not.toContain('download');
36
+ expect(argv).not.toContain('set');
37
+ expect(argv).not.toContain('--debug');
38
+ expect(argv).not.toContain('--verbose');
39
+ });
40
+ it('queries the enabled-version count, never the value', () => {
41
+ const argv = vaultProbeArgv(PROJECT, SLUG);
42
+ const query = argv[argv.indexOf('--query') + 1];
43
+ expect(query).toBe('length([?attributes.enabled])');
44
+ expect(argv.join(' ')).not.toContain('--query value');
45
+ expect(argv.join(' ')).not.toMatch(/\bvalue\b/);
46
+ });
47
+ it('names the vault from coordination-token.ts and the secret from kvSecretName', () => {
48
+ const argv = vaultProbeArgv(PROJECT, SLUG);
49
+ expect(argv[argv.indexOf('--vault-name') + 1]).toBe(KEYVAULT_NAME);
50
+ expect(argv[argv.indexOf('--name') + 1]).toBe(kvSecretName(PROJECT, SLUG));
51
+ expect(VAULT_NAME).toBe(KEYVAULT_NAME);
52
+ });
53
+ it('passes both slugs as single argv elements, with no shell', () => {
54
+ const { calls, spawn } = recorder({ status: 0, stdout: '1\n', stderr: '' });
55
+ vaultTokenPresent(PROJECT, SLUG, spawn);
56
+ expect(calls).toHaveLength(1);
57
+ expect(calls[0].command).toBe('az');
58
+ expect(calls[0].args).toEqual(vaultProbeArgv(PROJECT, SLUG));
59
+ expect(calls[0].args).toContain(`coordination-token--${PROJECT}--${SLUG}`);
60
+ });
61
+ });
62
+ describe('vaultTokenPresent: three outcomes', () => {
63
+ it('answers present for exit 0 and an enabled-version count of 1', () => {
64
+ const { spawn } = recorder({ status: 0, stdout: '1\n', stderr: '' });
65
+ expect(vaultTokenPresent(PROJECT, SLUG, spawn)).toBe('present');
66
+ });
67
+ it('answers present for more than one enabled version', () => {
68
+ const { spawn } = recorder({ status: 0, stdout: '3\n', stderr: '' });
69
+ expect(vaultTokenPresent(PROJECT, SLUG, spawn)).toBe('present');
70
+ });
71
+ it('answers absent for exit 0 and a count of 0', () => {
72
+ // The name exists with every version disabled. The mint is still the fix.
73
+ const { spawn } = recorder({ status: 0, stdout: '0\n', stderr: '' });
74
+ expect(vaultTokenPresent(PROJECT, SLUG, spawn)).toBe('absent');
75
+ });
76
+ it('answers absent for exit 0 and an empty or non-integer answer', () => {
77
+ for (const stdout of ['', '\n', 'null\n', 'true\n']) {
78
+ const { spawn } = recorder({ status: 0, stdout, stderr: '' });
79
+ expect(vaultTokenPresent(PROJECT, SLUG, spawn)).toBe('absent');
80
+ }
81
+ });
82
+ it('answers absent for the CLI not-found error', () => {
83
+ for (const stderr of [
84
+ "ERROR: (SecretNotFound) A secret with (name/id) coordination-token--mx-agent--scratchteam was not found in this key vault.\n",
85
+ 'ERROR: Secret scratchteam was not found in this key vault\n',
86
+ ]) {
87
+ const { spawn } = recorder({ status: 3, stdout: '', stderr });
88
+ expect(vaultTokenPresent(PROJECT, SLUG, spawn)).toBe('absent');
89
+ }
90
+ });
91
+ it('answers unresolvable for a permission failure, never absent', () => {
92
+ const { spawn } = recorder({
93
+ status: 1,
94
+ stdout: '',
95
+ stderr: "ERROR: (Forbidden) The user, group or application does not have secrets list permission on key vault 'mx-dev-eastus2-kv-001'. Status code: 403\n",
96
+ });
97
+ expect(vaultTokenPresent(PROJECT, SLUG, spawn)).toBe('unresolvable');
98
+ });
99
+ it('answers unresolvable when the login has expired', () => {
100
+ const { spawn } = recorder({
101
+ status: 1,
102
+ stdout: '',
103
+ stderr: "ERROR: Please run 'az login' to setup account.\n",
104
+ });
105
+ expect(vaultTokenPresent(PROJECT, SLUG, spawn)).toBe('unresolvable');
106
+ });
107
+ it('answers unresolvable when az is not installed (ENOENT)', () => {
108
+ const enoent = Object.assign(new Error('spawnSync az ENOENT'), { code: 'ENOENT' });
109
+ const { spawn } = recorder({ status: null, error: enoent });
110
+ expect(vaultTokenPresent(PROJECT, SLUG, spawn)).toBe('unresolvable');
111
+ });
112
+ it('answers unresolvable when the call timed out or overran its buffer', () => {
113
+ for (const error of [new Error('ETIMEDOUT'), new Error('ENOBUFS')]) {
114
+ const { spawn } = recorder({ status: null, stdout: '', stderr: '', error });
115
+ expect(vaultTokenPresent(PROJECT, SLUG, spawn)).toBe('unresolvable');
116
+ }
117
+ });
118
+ it('answers unresolvable when the spawn itself throws', () => {
119
+ const throwing = () => {
120
+ throw new Error('spawn refused');
121
+ };
122
+ expect(vaultTokenPresent(PROJECT, SLUG, throwing)).toBe('unresolvable');
123
+ });
124
+ });
125
+ describe('vaultTokenPresent: nothing the vault says reaches a returned string', () => {
126
+ it('returns one of three words whatever stdout and stderr hold', () => {
127
+ // If a secret value ever did reach stdout, it must not reach a caller. The
128
+ // return type is the whole answer: three words, no detail field.
129
+ const leak = 'sk-live-000000000000000000000000';
130
+ const cases = [
131
+ { status: 0, stdout: `${leak}\n`, stderr: leak },
132
+ { status: 1, stdout: leak, stderr: `ERROR: (SecretNotFound) ${leak}\n` },
133
+ { status: 1, stdout: leak, stderr: leak },
134
+ ];
135
+ for (const result of cases) {
136
+ const { spawn } = recorder(result);
137
+ const answer = vaultTokenPresent(PROJECT, SLUG, spawn);
138
+ expect(['present', 'absent', 'unresolvable']).toContain(answer);
139
+ expect(answer).not.toContain(leak);
140
+ expect(answer.length).toBeLessThan('unresolvable'.length + 1);
141
+ }
142
+ });
143
+ });
144
+ describe('the Key Vault path is kept, not deleted (#288)', () => {
145
+ it('still names the dev vault and the ND-1 secret name, for every project', () => {
146
+ // #288 moved `mx-agent` off this path and left every other project on it.
147
+ // Deleting KEYVAULT_NAME, the `az` invocation and the KV secret-name helpers
148
+ // is a LATER iteration, after the other projects migrate or the product owner
149
+ // rules they will not. Until then this module must keep working unchanged,
150
+ // and it is asked here for a credential-endpoint project and a Key Vault one
151
+ // alike: the switch lives in coordination-token.ts, not in this module, so a
152
+ // probe that reached here is a probe the caller decided to make.
153
+ for (const project of ['mx-agent', 'memnexus', 'spearmint-private']) {
154
+ const argv = vaultProbeArgv(project, SLUG);
155
+ expect(argv).toContain(KEYVAULT_NAME);
156
+ expect(argv).toContain(kvSecretName(project, SLUG));
157
+ expect(argv).toContain('list-versions');
158
+ expect(argv).not.toContain('show');
159
+ }
160
+ expect(VAULT_NAME).toBe(KEYVAULT_NAME);
161
+ });
162
+ it('takes no user key, no service URL, and no identity', () => {
163
+ // A guard against the credential path bleeding into the vault probe. This
164
+ // module's whole input is (project, slug) plus an injectable spawn.
165
+ expect(vaultProbeArgv(PROJECT, SLUG).join(' ')).not.toMatch(/user-key|credential|api[-_]?key/i);
166
+ expect(vaultProbeArgv(PROJECT, SLUG).join(' ')).not.toMatch(/https?:/i);
167
+ });
168
+ });
169
+ //# sourceMappingURL=vault.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vault.test.js","sourceRoot":"","sources":["../../src/lib/vault.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,63 @@
1
+ import type { FleetSnapshot, TeamSnapshot } from './fleet-data.js';
2
+ /**
3
+ * How a value should read, not what colour it is. A renderer maps these to
4
+ * colours, weights or nothing at all.
5
+ */
6
+ export type Tone = 'ok' | 'warn' | 'bad' | 'info' | 'dim';
7
+ /** One field of a head. `note` explains a value the operator should not trust. */
8
+ export interface HeadField {
9
+ label: string;
10
+ value: string;
11
+ tone: Tone;
12
+ note?: string;
13
+ }
14
+ export interface TeamHead {
15
+ team: string;
16
+ displayName: string;
17
+ /** Status marker. Same glyph the terminal prints. */
18
+ mark: string;
19
+ markTone: Tone;
20
+ /** True when this team should outrank the quiet ones. */
21
+ needsPerson: boolean;
22
+ /** The four questions, in the order `docs/legibility-plan.md` asks them. */
23
+ fields: HeadField[];
24
+ /** Named memory the leader state resolved from, or null. */
25
+ provenance: string | null;
26
+ /** One line per source that failed for this team. Never silently dropped. */
27
+ problems: string[];
28
+ }
29
+ export interface WindowView {
30
+ /** When the snapshot was taken (ISO-8601), and how old that is now. */
31
+ takenAt: string;
32
+ ageSeconds: number;
33
+ ageText: string;
34
+ /**
35
+ * True when the reading is old enough that the operator should not treat it
36
+ * as current. The page keeps showing the last good snapshot and says so,
37
+ * because blanking the screen loses information a stale reading still holds.
38
+ */
39
+ stale: boolean;
40
+ projectSlug: string;
41
+ teams: TeamHead[];
42
+ /** Fleet-level source failures. */
43
+ problems: string[];
44
+ /** Any source failed anywhere, so this view is not the whole picture. */
45
+ partial: boolean;
46
+ totals: {
47
+ teams: number;
48
+ live: number;
49
+ needsAttention: number;
50
+ costToday: number | null;
51
+ costText: string;
52
+ };
53
+ }
54
+ /** A snapshot older than this is not a current answer. */
55
+ export declare const STALE_SNAPSHOT_SECONDS = 90;
56
+ /**
57
+ * `≈` marks a total that includes a model with no pricing row, the same way the
58
+ * terminal marks it. A fallback estimate never renders as a quote.
59
+ */
60
+ export declare function costText(today: number | null, unpriced: boolean): string;
61
+ export declare function toTeamHead(team: TeamSnapshot): TeamHead;
62
+ export declare function toWindowView(snapshot: FleetSnapshot, now?: Date): WindowView;
63
+ //# sourceMappingURL=window-view.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"window-view.d.ts","sourceRoot":"","sources":["../../src/lib/window-view.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAe,aAAa,EAAmB,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGjG;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AAoC1D,kFAAkF;AAClF,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,IAAI,CAAC;IACf,yDAAyD;IACzD,WAAW,EAAE,OAAO,CAAC;IACrB,4EAA4E;IAC5E,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,yEAAyE;IACzE,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAoBzC;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAGxE;AAMD,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CAsGvD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,GAAE,IAAiB,GAAG,UAAU,CAwBxF"}
@@ -0,0 +1,217 @@
1
+ /**
2
+ * window-view.ts — a fleet snapshot as standing state, ready for any renderer.
3
+ *
4
+ * Pure. Takes a `FleetSnapshot` and a clock, returns plain data. No colour, no
5
+ * HTML, no padding. `commands/window.ts` renders it as a page and a test reads
6
+ * it as an object, which is the split `product/mx-agent-prd.md` requires of the
7
+ * operating surface: anything the surface shows has to be computable by a
8
+ * command, from the same function.
9
+ *
10
+ * WHAT THIS ANSWERS. `docs/legibility-plan.md` names four questions a person
11
+ * running several teams asks continuously. A stream answers none of them
12
+ * without being read, and a team working on the wrong thing emits nothing to
13
+ * read. So each head states all four, and states plainly when a question has no
14
+ * answer rather than leaving the row blank.
15
+ *
16
+ * All four now have a source. The goal comes from the team's catalog definition
17
+ * and the last finding from the `Last finding:` line the report format requires
18
+ * in leader state; both shipped reading `no source yet`, which was true when the
19
+ * screen was built and is the reason it said so. An unanswered question now
20
+ * names what would answer it — a line to add, or a state that was unreadable —
21
+ * because "not stated" and "not readable" send the operator to different places
22
+ * and a single grey dash sends them nowhere.
23
+ *
24
+ * WHAT IT REFUSES TO DO. `fleet-data.ts` fails soft: a source that is down
25
+ * becomes a null field plus an `errors` entry. That contract only helps if the
26
+ * renderer keeps it, so nothing here turns a missing value into a healthy one.
27
+ * A team whose leader state could not be read is `unknown`, never `ok`, and a
28
+ * snapshot with any failed source is marked partial.
29
+ */
30
+ import { formatStatusWithAge } from './fleet-render.js';
31
+ import { needsAttention, sortTeamsByAttention, summarize } from './fleet-data.js';
32
+ /** The marker set `fleet-render.ts` already prints, so both surfaces agree. */
33
+ const MARK = {
34
+ ok: '●',
35
+ 'needs-human': '⚠',
36
+ blocked: '⚠',
37
+ 'needs-external': '◖',
38
+ unknown: '?',
39
+ };
40
+ const STATUS_TONE = {
41
+ ok: 'ok',
42
+ 'needs-human': 'bad',
43
+ blocked: 'bad',
44
+ 'needs-external': 'info',
45
+ unknown: 'warn',
46
+ };
47
+ /** What the operator is told when no session is running for a team. */
48
+ const LIVENESS_TEXT = {
49
+ live: 'running',
50
+ 'stale-lock': 'lock held by nothing',
51
+ indeterminate: 'cannot tell',
52
+ none: 'no session',
53
+ unknown: 'unknown',
54
+ };
55
+ const LIVENESS_TONE = {
56
+ live: 'ok',
57
+ 'stale-lock': 'warn',
58
+ indeterminate: 'warn',
59
+ none: 'dim',
60
+ unknown: 'warn',
61
+ };
62
+ /** A snapshot older than this is not a current answer. */
63
+ export const STALE_SNAPSHOT_SECONDS = 90;
64
+ function ageText(seconds) {
65
+ if (seconds < 5)
66
+ return 'just now';
67
+ if (seconds < 60)
68
+ return `${seconds}s ago`;
69
+ const minutes = Math.floor(seconds / 60);
70
+ if (minutes < 60)
71
+ return `${minutes}m ago`;
72
+ return `${Math.floor(minutes / 60)}h ago`;
73
+ }
74
+ /** Seconds to a coarse duration. Long enough is all the operator needs. */
75
+ function durationText(seconds) {
76
+ if (seconds < 60)
77
+ return `${seconds}s`;
78
+ const minutes = Math.floor(seconds / 60);
79
+ if (minutes < 60)
80
+ return `${minutes}m`;
81
+ const hours = Math.floor(minutes / 60);
82
+ if (hours < 48)
83
+ return `${hours}h ${minutes % 60}m`;
84
+ return `${Math.floor(hours / 24)}d`;
85
+ }
86
+ /**
87
+ * `≈` marks a total that includes a model with no pricing row, the same way the
88
+ * terminal marks it. A fallback estimate never renders as a quote.
89
+ */
90
+ export function costText(today, unpriced) {
91
+ if (today === null)
92
+ return 'not readable';
93
+ return `${unpriced ? '≈' : ''}$${today.toFixed(2)}`;
94
+ }
95
+ function problemLines(errors) {
96
+ return Object.entries(errors).map(([source, reason]) => `${source}: ${reason}`);
97
+ }
98
+ export function toTeamHead(team) {
99
+ const { leader, cost } = team;
100
+ const fields = [];
101
+ // 1. What is this team trying to achieve. The source is the team's catalog
102
+ // definition rather than its leader state, because a goal kept in the
103
+ // memory a team rewrites each iteration drifts with the work, and drift is
104
+ // the thing this question is asked to catch. A definition that states no
105
+ // goal names the file to put one in: the gap is now one line of markdown
106
+ // rather than a missing mechanism, and a head that cannot say so sends the
107
+ // operator looking for a feature that already exists.
108
+ fields.push(team.goal
109
+ ? { label: 'goal', value: team.goal, tone: 'info' }
110
+ : {
111
+ label: 'goal',
112
+ value: 'not stated',
113
+ tone: 'dim',
114
+ note: `add a Goal: line to the team definition for ${team.team}`,
115
+ });
116
+ // 2. What is it doing right now.
117
+ fields.push(leader.iteration
118
+ ? { label: 'on', value: leader.iteration, tone: 'ok' }
119
+ : { label: 'on', value: 'nothing recorded', tone: 'dim' });
120
+ // How long, and what the status is. Age travels with the status everywhere,
121
+ // because `ok` read from a quarter-old memory is not the claim `ok` today is.
122
+ const forParts = [];
123
+ if (team.liveness === 'live' && team.lockAgeSeconds !== null) {
124
+ forParts.push(durationText(team.lockAgeSeconds));
125
+ }
126
+ forParts.push(formatStatusWithAge(leader));
127
+ fields.push({
128
+ label: 'for',
129
+ value: forParts.join(' · '),
130
+ tone: leader.stale ? 'warn' : STATUS_TONE[leader.status],
131
+ note: leader.stale ? 'this reading is old enough to be about a different day' : undefined,
132
+ });
133
+ // 3. What is it stuck on.
134
+ let waits;
135
+ if (leader.decision) {
136
+ waits = { label: 'waits', value: leader.decision, tone: 'bad' };
137
+ }
138
+ else if (leader.status === 'needs-external') {
139
+ waits = { label: 'waits', value: 'another team', tone: 'info' };
140
+ }
141
+ else if (leader.status === 'unknown') {
142
+ waits = { label: 'waits', value: 'not readable', tone: 'warn' };
143
+ }
144
+ else {
145
+ waits = { label: 'waits', value: 'nothing', tone: 'dim' };
146
+ }
147
+ fields.push(waits);
148
+ // 4. Is its last finding true. The claim itself is all a head can carry; what
149
+ // makes it challengeable is that the report format requires the command,
150
+ // file or query behind it, and `provenance` names the memory holding both.
151
+ // A finding read out of a stale leader state is a stale finding, so it
152
+ // carries the same warning the status does rather than reading as current.
153
+ if (leader.finding) {
154
+ fields.push({
155
+ label: 'last',
156
+ value: leader.finding,
157
+ tone: leader.stale ? 'warn' : 'info',
158
+ note: leader.stale ? 'from the same old reading as the status above' : undefined,
159
+ });
160
+ }
161
+ else {
162
+ fields.push({
163
+ label: 'last',
164
+ value: 'none stated',
165
+ tone: 'dim',
166
+ note: leader.status === 'unknown'
167
+ ? 'leader state was not readable, so this is unknown rather than empty'
168
+ : 'a report states one; leader state carries it as Last finding:',
169
+ });
170
+ }
171
+ fields.push({
172
+ label: 'today',
173
+ value: costText(cost.today, cost.unpricedModel),
174
+ tone: cost.today === null ? 'warn' : 'dim',
175
+ note: cost.unpricedModel ? 'includes a model with no pricing row' : undefined,
176
+ });
177
+ fields.push({
178
+ label: 'session',
179
+ value: LIVENESS_TEXT[team.liveness],
180
+ tone: LIVENESS_TONE[team.liveness],
181
+ });
182
+ return {
183
+ team: team.team,
184
+ displayName: team.displayName,
185
+ mark: team.hasWorktree ? MARK[leader.status] : '○',
186
+ markTone: team.hasWorktree ? STATUS_TONE[leader.status] : 'dim',
187
+ needsPerson: needsAttention(team),
188
+ fields,
189
+ provenance: leader.source,
190
+ problems: problemLines(team.errors),
191
+ };
192
+ }
193
+ export function toWindowView(snapshot, now = new Date()) {
194
+ const totals = summarize(snapshot);
195
+ const takenMs = Date.parse(snapshot.takenAt);
196
+ const ageSeconds = Number.isFinite(takenMs)
197
+ ? Math.max(0, Math.floor((now.getTime() - takenMs) / 1000))
198
+ : 0;
199
+ return {
200
+ takenAt: snapshot.takenAt,
201
+ ageSeconds,
202
+ ageText: ageText(ageSeconds),
203
+ stale: ageSeconds > STALE_SNAPSHOT_SECONDS,
204
+ projectSlug: snapshot.session.projectSlug,
205
+ teams: sortTeamsByAttention(snapshot.teams).map(toTeamHead),
206
+ problems: problemLines(snapshot.errors),
207
+ partial: totals.partial,
208
+ totals: {
209
+ teams: totals.teams,
210
+ live: totals.live,
211
+ needsAttention: totals.needsAttention,
212
+ costToday: totals.costToday,
213
+ costText: totals.costToday === null ? 'not readable' : `$${totals.costToday.toFixed(2)}`,
214
+ },
215
+ };
216
+ }
217
+ //# sourceMappingURL=window-view.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"window-view.js","sourceRoot":"","sources":["../../src/lib/window-view.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=window-view.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"window-view.test.d.ts","sourceRoot":"","sources":["../../src/lib/window-view.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,168 @@
1
+ import { describe, it, expect } from 'vitest';
2
+ import { toWindowView, toTeamHead, costText, STALE_SNAPSHOT_SECONDS } from './window-view.js';
3
+ const NOW = new Date('2026-08-20T14:32:00.000Z');
4
+ function team(over = {}) {
5
+ return {
6
+ team: 'retrieval',
7
+ displayName: 'Retrieval',
8
+ worktreePath: '/w/retrieval',
9
+ hasWorktree: true,
10
+ goal: 'answer a retrieval query correctly the first time',
11
+ leader: {
12
+ status: 'ok',
13
+ decision: null,
14
+ iteration: 'building the confusion matrix',
15
+ finding: 'exact-anchor beats hybrid on 41 of 60 eval queries (npm run eval:anchors)',
16
+ source: 'retrieval-leader-state',
17
+ validFrom: '2026-08-20T11:00:00.000Z',
18
+ ageDays: 0,
19
+ stale: false,
20
+ },
21
+ cost: { today: 4.12, unpricedModel: false, models: ['sonnet'] },
22
+ liveness: 'live',
23
+ lockAgeSeconds: 11520,
24
+ errors: {},
25
+ ...over,
26
+ };
27
+ }
28
+ function snapshot(over = {}) {
29
+ return {
30
+ takenAt: '2026-08-20T14:31:45.000Z',
31
+ session: { projectRoot: '/p/memnexus', projectSlug: 'memnexus' },
32
+ teams: [team()],
33
+ coordination: [],
34
+ errors: {},
35
+ ...over,
36
+ };
37
+ }
38
+ const fieldValue = (head, label) => head.fields.find((f) => f.label === label)?.value ?? '';
39
+ const fieldTone = (head, label) => head.fields.find((f) => f.label === label)?.tone ?? '';
40
+ describe('toTeamHead', () => {
41
+ it('answers the four questions from a source', () => {
42
+ const head = toTeamHead(team());
43
+ const labels = head.fields.map((f) => f.label);
44
+ expect(labels).toEqual(['goal', 'on', 'for', 'waits', 'last', 'today', 'session']);
45
+ expect(fieldValue(head, 'goal')).toBe('answer a retrieval query correctly the first time');
46
+ expect(fieldValue(head, 'on')).toBe('building the confusion matrix');
47
+ expect(fieldValue(head, 'last')).toContain('exact-anchor beats hybrid');
48
+ // No field still reads as a missing mechanism. That was the milestone's
49
+ // second done condition, and a regression here is worth failing over.
50
+ expect(head.fields.map((f) => f.value)).not.toContain('no source yet');
51
+ });
52
+ it('a team definition with no goal names the file to add one to', () => {
53
+ const head = toTeamHead(team({ goal: null }));
54
+ expect(fieldValue(head, 'goal')).toBe('not stated');
55
+ expect(fieldTone(head, 'goal')).toBe('dim');
56
+ // The remedy, not just the absence. "not stated" with nowhere to go is the
57
+ // same dead end as "no source yet".
58
+ expect(head.fields.find((f) => f.label === 'goal')?.note).toContain('retrieval');
59
+ });
60
+ it('tells an unstated finding apart from an unreadable one', () => {
61
+ const quiet = toTeamHead(team({ leader: { ...team().leader, finding: null } }));
62
+ expect(fieldValue(quiet, 'last')).toBe('none stated');
63
+ expect(quiet.fields.find((f) => f.label === 'last')?.note).toContain('Last finding:');
64
+ const unreadable = toTeamHead(team({
65
+ leader: { status: 'unknown', decision: null, iteration: null, finding: null,
66
+ source: null, validFrom: null, ageDays: null, stale: false },
67
+ }));
68
+ expect(unreadable.fields.find((f) => f.label === 'last')?.note).toContain('not readable');
69
+ });
70
+ it('a finding from a stale leader state is marked stale, not current', () => {
71
+ const head = toTeamHead(team({ leader: { ...team().leader, ageDays: 31, stale: true } }));
72
+ expect(fieldTone(head, 'last')).toBe('warn');
73
+ expect(head.fields.find((f) => f.label === 'last')?.note).toContain('old reading');
74
+ });
75
+ it('never renders an unreadable leader state as ok', () => {
76
+ const head = toTeamHead(team({
77
+ leader: { status: 'unknown', decision: null, iteration: null, finding: null,
78
+ source: null, validFrom: null, ageDays: null, stale: false },
79
+ errors: { leaderState: 'timeout' },
80
+ }));
81
+ expect(head.mark).toBe('?');
82
+ expect(head.markTone).toBe('warn');
83
+ expect(fieldValue(head, 'waits')).toBe('not readable');
84
+ expect(head.problems).toContain('leaderState: timeout');
85
+ });
86
+ it('a source that failed is never dropped silently', () => {
87
+ const head = toTeamHead(team({ errors: { cost: 'no pricing row', liveness: 'timeout' } }));
88
+ expect(head.problems).toHaveLength(2);
89
+ });
90
+ it('a stale reading is warned about even when the status itself reads healthy', () => {
91
+ const head = toTeamHead(team({
92
+ leader: { status: 'ok', decision: null, iteration: 'x', finding: null, source: 's',
93
+ validFrom: '2026-05-21T00:00:00.000Z', ageDays: 91, stale: true },
94
+ }));
95
+ expect(fieldValue(head, 'for')).toContain('91d, STALE');
96
+ expect(fieldTone(head, 'for')).toBe('warn');
97
+ });
98
+ it('a team with no worktree reads as absent rather than as a status', () => {
99
+ const head = toTeamHead(team({ hasWorktree: false, liveness: 'none' }));
100
+ expect(head.mark).toBe('○');
101
+ expect(fieldValue(head, 'session')).toBe('no session');
102
+ });
103
+ it('surfaces a decision the team is waiting on, and flags it', () => {
104
+ const head = toTeamHead(team({
105
+ leader: { status: 'needs-human', decision: 'branch protection on main',
106
+ iteration: 'x', finding: null, source: 's', validFrom: null, ageDays: 0, stale: false },
107
+ }));
108
+ expect(head.needsPerson).toBe(true);
109
+ expect(fieldValue(head, 'waits')).toBe('branch protection on main');
110
+ expect(fieldTone(head, 'waits')).toBe('bad');
111
+ });
112
+ it('keeps the provenance of the reading', () => {
113
+ expect(toTeamHead(team()).provenance).toBe('retrieval-leader-state');
114
+ });
115
+ });
116
+ describe('costText', () => {
117
+ it('marks a total that includes a model with no pricing row', () => {
118
+ expect(costText(7.4, true)).toBe('≈$7.40');
119
+ expect(costText(7.4, false)).toBe('$7.40');
120
+ });
121
+ it('says a missing cost is missing rather than zero', () => {
122
+ expect(costText(null, false)).toBe('not readable');
123
+ expect(costText(null, false)).not.toContain('0.00');
124
+ });
125
+ });
126
+ describe('toWindowView', () => {
127
+ it('ranks the teams that need a person above the quiet ones', () => {
128
+ const view = toWindowView(snapshot({
129
+ teams: [
130
+ team({ team: 'quiet' }),
131
+ team({
132
+ team: 'blocked-one',
133
+ leader: { status: 'blocked', decision: 'a rule refuses the push', iteration: null,
134
+ finding: null, source: 's', validFrom: null, ageDays: 0, stale: false },
135
+ }),
136
+ ],
137
+ }), NOW);
138
+ expect(view.teams[0].team).toBe('blocked-one');
139
+ expect(view.totals.needsAttention).toBe(1);
140
+ });
141
+ it('marks the view partial when any source failed anywhere', () => {
142
+ expect(toWindowView(snapshot(), NOW).partial).toBe(false);
143
+ expect(toWindowView(snapshot({ errors: { coordination: 'unavailable' } }), NOW).partial).toBe(true);
144
+ expect(toWindowView(snapshot({ teams: [team({ errors: { cost: 'x' } })] }), NOW).partial).toBe(true);
145
+ });
146
+ it('reports the age of the reading, and calls an old one stale', () => {
147
+ const fresh = toWindowView(snapshot(), NOW);
148
+ expect(fresh.ageSeconds).toBe(15);
149
+ expect(fresh.stale).toBe(false);
150
+ const old = toWindowView(snapshot({ takenAt: new Date(NOW.getTime() - (STALE_SNAPSHOT_SECONDS + 30) * 1000).toISOString() }), NOW);
151
+ expect(old.stale).toBe(true);
152
+ });
153
+ it('says a fleet cost is unreadable rather than reporting zero', () => {
154
+ const view = toWindowView(snapshot({ teams: [team({ cost: { today: null, unpricedModel: false, models: [] } })] }), NOW);
155
+ expect(view.totals.costToday).toBeNull();
156
+ expect(view.totals.costText).toBe('not readable');
157
+ });
158
+ it('renders every status the fleet can report', () => {
159
+ const statuses = ['ok', 'needs-human', 'needs-external', 'blocked', 'unknown'];
160
+ for (const status of statuses) {
161
+ const head = toTeamHead(team({ leader: { status, decision: null, iteration: null, finding: null,
162
+ source: null, validFrom: null, ageDays: 0, stale: false } }));
163
+ expect(head.mark).toBeTruthy();
164
+ expect(head.fields).toHaveLength(7);
165
+ }
166
+ });
167
+ });
168
+ //# sourceMappingURL=window-view.test.js.map