@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,332 @@
1
+ /**
2
+ * Reads the coordination roster on a git ref, as three outcomes (#77).
3
+ *
4
+ * The roster decides which team identity may fetch a token from the dev vault
5
+ * (`coordination-token.ts:75,80,234-243`). Two committed artifacts hold it, and
6
+ * a team is registered only when BOTH do:
7
+ *
8
+ * - `coordination-service/src/config/rosters.ts`, the single source, compiled
9
+ * into the service. Editing it and deploying is what makes the service
10
+ * accept the team's messages.
11
+ * - `mx-agent-system/agent-config/coordination-rosters.generated.json`, the
12
+ * offline file the CLI token gate and the session-start hook read from the
13
+ * calling worktree's checkout. Regenerating it is a manual two-command step
14
+ * (`generate-rosters.ts:10-11`).
15
+ *
16
+ * This module READS both on a ref. It writes nothing, edits no roster, mints
17
+ * nothing, and makes no network call: the ref is local, updated by the fetch the
18
+ * caller already ran. Neither read can tell whether the service was redeployed
19
+ * after the roster changed, and the row that prints these answers says so.
20
+ *
21
+ * `unresolvable` is its own answer, not a synonym for `absent`, for the reason
22
+ * `catalogEntryOnOriginMain` states: a failed fetch leaves a remote-tracking ref
23
+ * of unknown age, so an entry merged since would read as missing and the
24
+ * operator would be told to make an edit that is already on the base branch
25
+ * (`mx-agent-system/standards/fail-loud-standard.md`).
26
+ */
27
+ import { spawnSync } from 'child_process';
28
+ import { isReadableCatalogRef } from './catalog.js';
29
+ import { refExists } from './worktree.js';
30
+ /** The offline roster file, `/`-separated because a git object path always is. */
31
+ export const ROSTER_JSON_PATH = 'mx-agent-system/agent-config/coordination-rosters.generated.json';
32
+ /** The single-source roster module, compiled into the coordination service. */
33
+ export const ROSTER_SOURCE_PATH = 'mx-agent-system/coordination-service/src/config/rosters.ts';
34
+ /**
35
+ * The map both reads consult: the token-provisioned roster per project, which is
36
+ * the set serialized into the offline file (`rosters.ts:166-174`,
37
+ * `serializeProvisionedRosters`). The enqueue-target map `SERVICE_ROSTERS` is a
38
+ * different set and is not what the token gate reads.
39
+ */
40
+ const PROVISIONED_ROSTERS_EXPORT = 'PROVISIONED_ROSTERS';
41
+ /**
42
+ * Read one path at one ref. `undefined` means the read could not be performed;
43
+ * `null` means the ref resolved and holds no such path.
44
+ *
45
+ * Both git invocations pipe their output, so a git message never reaches the
46
+ * transcript, and nothing read here is interpolated into a caller-facing string.
47
+ */
48
+ function showAtRef(projectRoot, ref, path) {
49
+ try {
50
+ // The two accepted forms, for the reason `catalogEntryOnRef` states: the ref
51
+ // is interpolated into a revision string, and `HEAD` or `origin/<name>` is
52
+ // the whole of what these callers need.
53
+ if (!isReadableCatalogRef(ref))
54
+ return undefined;
55
+ if (!refExists(ref, projectRoot))
56
+ return undefined;
57
+ const r = spawnSync('git', ['show', '--end-of-options', `${ref}:${path}`], {
58
+ cwd: projectRoot,
59
+ stdio: 'pipe',
60
+ encoding: 'utf-8',
61
+ maxBuffer: 4 * 1024 * 1024,
62
+ });
63
+ // A git that could not run at all is not evidence about the file.
64
+ if (r.error || r.status === null)
65
+ return undefined;
66
+ // The ref resolved above, so a non-zero exit here is "no such path in this
67
+ // tree". That is an answer about the roster: the file is not on the base
68
+ // branch, so the roster does not hold the team.
69
+ if (r.status !== 0)
70
+ return null;
71
+ return typeof r.stdout === 'string' ? r.stdout : undefined;
72
+ }
73
+ catch {
74
+ return undefined;
75
+ }
76
+ }
77
+ /**
78
+ * Whether the generated offline roster file on `origin/<base>` lists the slug
79
+ * under the project.
80
+ *
81
+ * `present` means the CLI token gate in a checkout of that ref would accept the
82
+ * identity. It does NOT mean the service was redeployed, and it does not mean a
83
+ * token exists: those are the deploy and the mint, neither of which this read
84
+ * can see.
85
+ */
86
+ export function rosterEntryOnRef(projectRoot, slug, opts) {
87
+ // A failed fetch settles the answer before any ref is read.
88
+ if (opts.fetchOk !== true)
89
+ return 'unresolvable';
90
+ const ref = `origin/${opts.baseBranch?.trim() || 'main'}`;
91
+ const raw = showAtRef(projectRoot, ref, ROSTER_JSON_PATH);
92
+ if (raw === undefined)
93
+ return 'unresolvable';
94
+ // No roster file on the base branch: the project has no offline roster, so it
95
+ // registers no team. That is absent, and the remedy is the same edit.
96
+ if (raw === null)
97
+ return 'absent';
98
+ let parsed;
99
+ try {
100
+ parsed = JSON.parse(raw);
101
+ }
102
+ catch {
103
+ return 'unresolvable';
104
+ }
105
+ const projects = parsed?.projects;
106
+ // A file that parsed but holds no `projects` map is not a roster this code
107
+ // understands. Reporting `absent` would name an edit that may already be made.
108
+ if (!projects || typeof projects !== 'object' || Array.isArray(projects))
109
+ return 'unresolvable';
110
+ const teams = projects[opts.project];
111
+ if (teams === undefined)
112
+ return 'absent';
113
+ if (!Array.isArray(teams))
114
+ return 'unresolvable';
115
+ return teams.includes(slug) ? 'present' : 'absent';
116
+ }
117
+ /**
118
+ * Whether the roster SOURCE on `origin/<base>` lists the slug under the project.
119
+ *
120
+ * Answers the state between "nothing was done" and "everything was done": the
121
+ * array in `rosters.ts` was edited and the generated file was not regenerated.
122
+ * The service would accept the team once redeployed while every CLI reading the
123
+ * offline file still refuses it, which is exactly the drift
124
+ * `roster-source.test.ts` exists to catch in CI, after a commit.
125
+ *
126
+ * Comments are removed from the whole file BEFORE any declaration is located,
127
+ * and only then is the export found and its array read. Order matters both ways.
128
+ * A commented-out `export const PROVISIONED_ROSTERS = [` would otherwise shadow
129
+ * the real declaration and answer for it (security review, Should Fix 2). And
130
+ * `rosters.ts:100-107` holds the slug `platform` in prose, including "is still
131
+ * NOT an enqueue target", which a whole-file substring read reports as
132
+ * membership.
133
+ *
134
+ * String contents survive the strip, so a `//` or a `]` inside a quoted slug is
135
+ * read as text rather than as a comment or as the end of the array.
136
+ *
137
+ * The file is parsed as text. Nothing in it is evaluated, imported or executed.
138
+ */
139
+ export function rosterSourceHasSlug(projectRoot, slug, project, opts = {}) {
140
+ if (opts.fetchOk !== true)
141
+ return 'unresolvable';
142
+ const ref = `origin/${opts.baseBranch?.trim() || 'main'}`;
143
+ const raw = showAtRef(projectRoot, ref, ROSTER_SOURCE_PATH);
144
+ if (raw === undefined)
145
+ return 'unresolvable';
146
+ if (raw === null)
147
+ return 'absent';
148
+ return sourceRosterMembership(raw, slug, project);
149
+ }
150
+ /**
151
+ * The parse, separate from the read so every shape it refuses is testable
152
+ * without a git fixture. Exported for that test.
153
+ */
154
+ export function sourceRosterMembership(source, slug, project) {
155
+ // Once, before anything is located. Every lookup below reads this text.
156
+ const code = stripComments(source);
157
+ const constName = provisionedRosterConstFor(code, project);
158
+ if (constName === 'unresolvable')
159
+ return 'unresolvable';
160
+ if (constName === null)
161
+ return 'absent';
162
+ const teams = arrayLiteralStrings(code, constName);
163
+ if (teams === null)
164
+ return 'unresolvable';
165
+ return teams.includes(slug) ? 'present' : 'absent';
166
+ }
167
+ /**
168
+ * Which `readonly string[]` const the project's provisioned roster is, read from
169
+ * the `PROVISIONED_ROSTERS` object literal.
170
+ *
171
+ * `null`: the map parsed and holds no entry for this project. `'unresolvable'`:
172
+ * the map is absent, or an entry's key is an identifier this file does not
173
+ * define, so an absent answer would be a guess. `DEFAULT_PROJECT` is imported
174
+ * from `../types.js` and is one such identifier, which is why an unresolved key
175
+ * refuses rather than reporting `absent`.
176
+ */
177
+ function provisionedRosterConstFor(source, project) {
178
+ const body = objectLiteralBody(source, PROVISIONED_ROSTERS_EXPORT);
179
+ if (body === null)
180
+ return 'unresolvable';
181
+ let sawUnresolvedKey = false;
182
+ for (const line of body.split('\n')) {
183
+ const m = line.match(/^\s*(?:\[\s*([A-Za-z_$][\w$]*)\s*\]|'([^']+)'|"([^"]+)"|([A-Za-z_$][\w$]*))\s*:\s*([A-Za-z_$][\w$]*)\s*,?\s*$/);
184
+ if (!m)
185
+ continue;
186
+ const [, keyIdent, keySingle, keyDouble, keyBare, valueIdent] = m;
187
+ let key = keySingle ?? keyDouble ?? keyBare ?? null;
188
+ if (keyIdent)
189
+ key = constStringValue(source, keyIdent);
190
+ if (key === null) {
191
+ sawUnresolvedKey = true;
192
+ continue;
193
+ }
194
+ if (key === project)
195
+ return valueIdent;
196
+ }
197
+ return sawUnresolvedKey ? 'unresolvable' : null;
198
+ }
199
+ /**
200
+ * The text between the braces of `export const <name> ... = { ... };`, or null.
201
+ *
202
+ * `source` is comment-free code: `sourceRosterMembership` strips first, so a
203
+ * declaration inside a comment cannot be found here at all.
204
+ */
205
+ function objectLiteralBody(source, name) {
206
+ const re = new RegExp(`export\\s+const\\s+${name}\\b[^=]*=\\s*\\{`);
207
+ const m = re.exec(source);
208
+ if (!m)
209
+ return null;
210
+ const open = m.index + m[0].length - 1;
211
+ const close = matchingIndex(source, open, '{', '}');
212
+ return close === -1 ? null : source.slice(open + 1, close);
213
+ }
214
+ /**
215
+ * The quoted strings of `export const <name> ... = [ ... ];`, or null when the
216
+ * export is absent.
217
+ *
218
+ * Read from the `[` to its matching `]`, not to the first `]`, because both
219
+ * shapes exist in the real file: `MX_AGENT_TEAMS` is one line (`rosters.ts:122`)
220
+ * and `DEFAULT_TEAMS`, `MEMNEXUS_PROVISIONED_TEAMS` and
221
+ * `SPEARMINT_PRIVATE_TEAMS` span many (`:29`, `:53`, `:76`).
222
+ */
223
+ function arrayLiteralStrings(source, name) {
224
+ const re = new RegExp(`export\\s+const\\s+${name}\\b[^=]*=\\s*\\[`);
225
+ const m = re.exec(source);
226
+ if (!m)
227
+ return null;
228
+ const open = m.index + m[0].length - 1;
229
+ const close = matchingIndex(source, open, '[', ']');
230
+ if (close === -1)
231
+ return null;
232
+ const items = [];
233
+ for (const item of source.slice(open + 1, close).matchAll(/'([^']*)'|"([^"]*)"/g)) {
234
+ items.push(item[1] ?? item[2] ?? '');
235
+ }
236
+ return items;
237
+ }
238
+ /** The value of `export const <name> ... = '<value>';`, or null. */
239
+ function constStringValue(source, name) {
240
+ const re = new RegExp(`export\\s+const\\s+${name}\\b[^=]*=\\s*['"]([^'"]+)['"]`);
241
+ const m = re.exec(source);
242
+ return m ? m[1] : null;
243
+ }
244
+ /**
245
+ * The index of the bracket matching the one at `openIndex`, or -1.
246
+ *
247
+ * String literals are skipped, so a `]` inside a quoted slug does not close the
248
+ * array and a `}` inside a quoted description does not close the map.
249
+ */
250
+ function matchingIndex(source, openIndex, open, close) {
251
+ let depth = 0;
252
+ let quote = '';
253
+ for (let i = openIndex; i < source.length; i++) {
254
+ const c = source[i];
255
+ if (quote) {
256
+ if (c === '\\')
257
+ i++;
258
+ else if (c === quote)
259
+ quote = '';
260
+ continue;
261
+ }
262
+ if (c === "'" || c === '"' || c === '`') {
263
+ quote = c;
264
+ continue;
265
+ }
266
+ if (c === open)
267
+ depth++;
268
+ else if (c === close) {
269
+ depth--;
270
+ if (depth === 0)
271
+ return i;
272
+ }
273
+ }
274
+ return -1;
275
+ }
276
+ /**
277
+ * The source with every comment replaced by spaces, and every string literal
278
+ * left as it is.
279
+ *
280
+ * Run BEFORE any declaration is located. A block comment holding
281
+ * `export const PROVISIONED_ROSTERS = [` would otherwise be found by the regex
282
+ * and read as the roster, and a stripper that ran afterwards could not undo
283
+ * that (security review, Should Fix 2).
284
+ *
285
+ * Newlines survive, so line structure and offsets are unchanged. A `//` inside
286
+ * a quoted string is text, not a comment: the scan tracks quotes, which is what
287
+ * the earlier regex form could not do.
288
+ */
289
+ function stripComments(source) {
290
+ const out = [];
291
+ let quote = '';
292
+ for (let i = 0; i < source.length; i++) {
293
+ const c = source[i];
294
+ const next = source[i + 1];
295
+ if (quote) {
296
+ out.push(c);
297
+ if (c === '\\' && i + 1 < source.length) {
298
+ out.push(next);
299
+ i++;
300
+ }
301
+ else if (c === quote) {
302
+ quote = '';
303
+ }
304
+ continue;
305
+ }
306
+ if (c === "'" || c === '"' || c === '`') {
307
+ quote = c;
308
+ out.push(c);
309
+ continue;
310
+ }
311
+ if (c === '/' && next === '/') {
312
+ while (i < source.length && source[i] !== '\n') {
313
+ out.push(' ');
314
+ i++;
315
+ }
316
+ if (i < source.length)
317
+ out.push('\n');
318
+ continue;
319
+ }
320
+ if (c === '/' && next === '*') {
321
+ const end = source.indexOf('*/', i + 2);
322
+ const stop = end === -1 ? source.length : end + 2;
323
+ for (; i < stop; i++)
324
+ out.push(source[i] === '\n' ? '\n' : ' ');
325
+ i--;
326
+ continue;
327
+ }
328
+ out.push(c);
329
+ }
330
+ return out.join('');
331
+ }
332
+ //# sourceMappingURL=roster.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"roster.js","sourceRoot":"","sources":["../../src/lib/roster.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * The two roster reads on a ref (#77), against a real git fixture.
3
+ *
4
+ * Row 9 of the completion contract decides whether a creation reports a team as
5
+ * registered on the coordination queue, so what these functions answer decides
6
+ * whether `provision` exits 0. The fixture is a real repository chain — a bare
7
+ * clone as the remote and a clone of it — not a spy on `spawnSync`, because the
8
+ * question is what `git show` returns at `origin/<base>`.
9
+ *
10
+ * Three outcomes throughout. `unresolvable` is the one the tests are here for: a
11
+ * read that could not be performed must never report the roster as missing, or
12
+ * the operator is told to make an edit that may already be merged.
13
+ */
14
+ export {};
15
+ //# sourceMappingURL=roster.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"roster.test.d.ts","sourceRoot":"","sources":["../../src/lib/roster.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}
@@ -0,0 +1,299 @@
1
+ /**
2
+ * The two roster reads on a ref (#77), against a real git fixture.
3
+ *
4
+ * Row 9 of the completion contract decides whether a creation reports a team as
5
+ * registered on the coordination queue, so what these functions answer decides
6
+ * whether `provision` exits 0. The fixture is a real repository chain — a bare
7
+ * clone as the remote and a clone of it — not a spy on `spawnSync`, because the
8
+ * question is what `git show` returns at `origin/<base>`.
9
+ *
10
+ * Three outcomes throughout. `unresolvable` is the one the tests are here for: a
11
+ * read that could not be performed must never report the roster as missing, or
12
+ * the operator is told to make an edit that may already be merged.
13
+ */
14
+ import { describe, it, expect, afterEach } from 'vitest';
15
+ import { spawnSync } from 'child_process';
16
+ import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'fs';
17
+ import { dirname, join } from 'path';
18
+ import { tmpdir } from 'os';
19
+ import { fileURLToPath } from 'url';
20
+ import { rosterEntryOnRef, rosterSourceHasSlug, sourceRosterMembership, ROSTER_JSON_PATH, ROSTER_SOURCE_PATH, } from './roster.js';
21
+ const SLUG = 'scratchteam';
22
+ const PROJECT = 'mx-agent';
23
+ const roots = [];
24
+ function git(args, cwd) {
25
+ const r = spawnSync('git', args, { cwd, encoding: 'utf-8' });
26
+ if (r.status !== 0)
27
+ throw new Error(`git ${args.join(' ')} exited ${r.status}: ${r.stderr}`);
28
+ }
29
+ function identify(repo) {
30
+ git(['config', 'user.email', 'fixture@example.invalid'], repo);
31
+ git(['config', 'user.name', 'fixture'], repo);
32
+ git(['config', 'commit.gpgsign', 'false'], repo);
33
+ }
34
+ function write(root, path, content) {
35
+ const full = join(root, path);
36
+ mkdirSync(dirname(full), { recursive: true });
37
+ writeFileSync(full, content);
38
+ }
39
+ /** A generated offline roster file listing `teams` under `mx-agent`. */
40
+ function generatedJson(teams) {
41
+ return JSON.stringify({ version: 1, projects: { memnexus: ['product'], 'mx-agent': teams } }, null, 2) + '\n';
42
+ }
43
+ /**
44
+ * A roster source in the shape of the real one: the project slug consts, the
45
+ * arrays, the `PROVISIONED_ROSTERS` map, and the prose line that names a slug
46
+ * which is NOT a member. A whole-file substring read passes on that line, which
47
+ * is the read this parse must not be.
48
+ */
49
+ function sourceTs(teams) {
50
+ return [
51
+ "import { DEFAULT_PROJECT } from '../types.js';",
52
+ '',
53
+ 'export const MEMNEXUS_PROVISIONED_TEAMS: readonly string[] = [',
54
+ " 'product',",
55
+ '];',
56
+ '',
57
+ "export const MX_AGENT_PROJECT = 'mx-agent';",
58
+ '',
59
+ '/**',
60
+ ' * `platform` is still NOT an enqueue target: it was retired 2026-08-21.',
61
+ ' */',
62
+ `export const MX_AGENT_TEAMS: readonly string[] = [${teams.map((t) => `'${t}'`).join(', ')}];`,
63
+ '',
64
+ 'export const PROVISIONED_ROSTERS: Readonly<Record<string, readonly string[]>> = {',
65
+ ' [DEFAULT_PROJECT]: MEMNEXUS_PROVISIONED_TEAMS,',
66
+ ' // [MX_AGENT_PROJECT]: A_COMMENTED_OUT_ROSTER,',
67
+ ' [MX_AGENT_PROJECT]: MX_AGENT_TEAMS,',
68
+ '};',
69
+ '',
70
+ ].join('\n');
71
+ }
72
+ /** A bare remote holding `main`, and a clone of it as the calling checkout. */
73
+ function makeFixture(files) {
74
+ const base = mkdtempSync(join(tmpdir(), 'mx-roster-'));
75
+ roots.push(base);
76
+ const seed = join(base, 'seed');
77
+ mkdirSync(seed);
78
+ git(['init', '-b', 'main'], seed);
79
+ identify(seed);
80
+ write(seed, 'README.md', '# fixture\n');
81
+ for (const [path, content] of Object.entries(files))
82
+ write(seed, path, content);
83
+ git(['add', '-A'], seed);
84
+ git(['commit', '-m', 'init'], seed);
85
+ const origin = join(base, 'origin.git');
86
+ git(['clone', '--bare', seed, origin], base);
87
+ const clone = join(base, 'clone');
88
+ git(['clone', origin, clone], base);
89
+ identify(clone);
90
+ return clone;
91
+ }
92
+ afterEach(() => {
93
+ while (roots.length > 0)
94
+ rmSync(roots.pop(), { recursive: true, force: true });
95
+ });
96
+ describe('rosterEntryOnRef: the generated offline roster file', () => {
97
+ it('answers present when origin/main lists the slug under the project', () => {
98
+ const clone = makeFixture({ [ROSTER_JSON_PATH]: generatedJson(['product', SLUG]) });
99
+ expect(rosterEntryOnRef(clone, SLUG, { project: PROJECT, fetchOk: true })).toBe('present');
100
+ });
101
+ it('answers absent when the file lists the project without the slug', () => {
102
+ const clone = makeFixture({ [ROSTER_JSON_PATH]: generatedJson(['product']) });
103
+ expect(rosterEntryOnRef(clone, SLUG, { project: PROJECT, fetchOk: true })).toBe('absent');
104
+ });
105
+ it('answers absent for a project the file does not key', () => {
106
+ const clone = makeFixture({ [ROSTER_JSON_PATH]: generatedJson(['product', SLUG]) });
107
+ expect(rosterEntryOnRef(clone, SLUG, { project: 'some-other-project', fetchOk: true })).toBe('absent');
108
+ });
109
+ it('answers absent when the ref resolves and holds no roster file', () => {
110
+ const clone = makeFixture({});
111
+ expect(rosterEntryOnRef(clone, SLUG, { project: PROJECT, fetchOk: true })).toBe('absent');
112
+ });
113
+ it('answers unresolvable when the fetch failed, whatever the ref holds', () => {
114
+ // The ref holds the entry. A stale ref of unknown age is not evidence, and
115
+ // reporting `present` off it is the failure this guard exists for.
116
+ const clone = makeFixture({ [ROSTER_JSON_PATH]: generatedJson([SLUG]) });
117
+ expect(rosterEntryOnRef(clone, SLUG, { project: PROJECT, fetchOk: false })).toBe('unresolvable');
118
+ expect(rosterEntryOnRef(clone, SLUG, { project: PROJECT })).toBe('unresolvable');
119
+ });
120
+ it('answers unresolvable for a base branch that does not resolve', () => {
121
+ const clone = makeFixture({ [ROSTER_JSON_PATH]: generatedJson([SLUG]) });
122
+ expect(rosterEntryOnRef(clone, SLUG, { project: PROJECT, baseBranch: 'no-such-branch', fetchOk: true }))
123
+ .toBe('unresolvable');
124
+ });
125
+ it('answers unresolvable for a base branch holding revision syntax', () => {
126
+ const clone = makeFixture({ [ROSTER_JSON_PATH]: generatedJson([SLUG]) });
127
+ for (const branch of ['main:..', 'main^', 'main@{1}', '../etc']) {
128
+ expect(rosterEntryOnRef(clone, SLUG, { project: PROJECT, baseBranch: branch, fetchOk: true }))
129
+ .toBe('unresolvable');
130
+ }
131
+ });
132
+ it('answers unresolvable for a corrupt roster file rather than absent', () => {
133
+ const clone = makeFixture({ [ROSTER_JSON_PATH]: '{ "version": 1, "projects": ' });
134
+ expect(rosterEntryOnRef(clone, SLUG, { project: PROJECT, fetchOk: true })).toBe('unresolvable');
135
+ });
136
+ it('answers unresolvable for a file that parses but holds no projects map', () => {
137
+ const clone = makeFixture({ [ROSTER_JSON_PATH]: '{ "version": 1 }\n' });
138
+ expect(rosterEntryOnRef(clone, SLUG, { project: PROJECT, fetchOk: true })).toBe('unresolvable');
139
+ });
140
+ it('answers unresolvable when the project maps to something that is not an array', () => {
141
+ const clone = makeFixture({ [ROSTER_JSON_PATH]: '{ "version": 1, "projects": { "mx-agent": "product" } }\n' });
142
+ expect(rosterEntryOnRef(clone, SLUG, { project: PROJECT, fetchOk: true })).toBe('unresolvable');
143
+ });
144
+ it('answers unresolvable in a directory that is no repository', () => {
145
+ const dir = mkdtempSync(join(tmpdir(), 'mx-roster-bare-'));
146
+ roots.push(dir);
147
+ expect(rosterEntryOnRef(dir, SLUG, { project: PROJECT, fetchOk: true })).toBe('unresolvable');
148
+ });
149
+ });
150
+ describe('rosterSourceHasSlug: the single-source roster module', () => {
151
+ it('answers present when the project array on origin/main holds the slug', () => {
152
+ const clone = makeFixture({ [ROSTER_SOURCE_PATH]: sourceTs(['product', SLUG]) });
153
+ expect(rosterSourceHasSlug(clone, SLUG, PROJECT, { fetchOk: true })).toBe('present');
154
+ });
155
+ it('answers absent when the project array does not hold the slug', () => {
156
+ const clone = makeFixture({ [ROSTER_SOURCE_PATH]: sourceTs(['product']) });
157
+ expect(rosterSourceHasSlug(clone, SLUG, PROJECT, { fetchOk: true })).toBe('absent');
158
+ });
159
+ it('does not count a slug that only appears in prose', () => {
160
+ // `platform` is named in a comment, including the line saying it is NOT a
161
+ // target. A whole-file substring read answers present here.
162
+ const clone = makeFixture({ [ROSTER_SOURCE_PATH]: sourceTs(['product']) });
163
+ expect(rosterSourceHasSlug(clone, 'platform', PROJECT, { fetchOk: true })).toBe('absent');
164
+ });
165
+ it('does not count a commented-out roster entry', () => {
166
+ const source = sourceTs(['product']).replace(" [MX_AGENT_PROJECT]: MX_AGENT_TEAMS,", " // [MX_AGENT_PROJECT]: MX_AGENT_TEAMS,");
167
+ const clone = makeFixture({ [ROSTER_SOURCE_PATH]: source });
168
+ // The map now resolves DEFAULT_PROJECT only, which this file does not
169
+ // define, so the answer is could-not-run rather than a guess.
170
+ expect(rosterSourceHasSlug(clone, SLUG, PROJECT, { fetchOk: true })).toBe('unresolvable');
171
+ });
172
+ it('answers unresolvable when the fetch failed', () => {
173
+ const clone = makeFixture({ [ROSTER_SOURCE_PATH]: sourceTs([SLUG]) });
174
+ expect(rosterSourceHasSlug(clone, SLUG, PROJECT, { fetchOk: false })).toBe('unresolvable');
175
+ expect(rosterSourceHasSlug(clone, SLUG, PROJECT)).toBe('unresolvable');
176
+ });
177
+ it('answers unresolvable for a base branch that does not resolve', () => {
178
+ const clone = makeFixture({ [ROSTER_SOURCE_PATH]: sourceTs([SLUG]) });
179
+ expect(rosterSourceHasSlug(clone, SLUG, PROJECT, { baseBranch: 'nope', fetchOk: true })).toBe('unresolvable');
180
+ });
181
+ it('answers absent when the ref holds no roster module', () => {
182
+ const clone = makeFixture({});
183
+ expect(rosterSourceHasSlug(clone, SLUG, PROJECT, { fetchOk: true })).toBe('absent');
184
+ });
185
+ });
186
+ describe('sourceRosterMembership: the parse, without a fixture', () => {
187
+ it('reads the repository own rosters.ts: bootstrap is a member, platform is not', () => {
188
+ // The real file, not a copy of its shape. `platform` appears in it six times
189
+ // in prose (`rosters.ts:100-107`) and in `DEFAULT_TEAMS`, and in neither
190
+ // place is it a member of the mx-agent provisioned roster.
191
+ const real = join(dirname(fileURLToPath(import.meta.url)), '..', '..', '..', 'coordination-service', 'src', 'config', 'rosters.ts');
192
+ const source = readFileSync(real, 'utf-8');
193
+ expect(sourceRosterMembership(source, 'bootstrap', 'mx-agent')).toBe('present');
194
+ expect(sourceRosterMembership(source, 'product', 'mx-agent')).toBe('present');
195
+ expect(sourceRosterMembership(source, 'platform', 'mx-agent')).toBe('absent');
196
+ expect(sourceRosterMembership(source, 'scratchteam', 'mx-agent')).toBe('absent');
197
+ });
198
+ it('refuses a project whose key is an identifier this file does not define', () => {
199
+ // `DEFAULT_PROJECT` is imported from ../types.js. Reporting `absent` for
200
+ // memnexus would name an edit that is already made.
201
+ const real = join(dirname(fileURLToPath(import.meta.url)), '..', '..', '..', 'coordination-service', 'src', 'config', 'rosters.ts');
202
+ const source = readFileSync(real, 'utf-8');
203
+ expect(sourceRosterMembership(source, 'product', 'memnexus')).toBe('unresolvable');
204
+ });
205
+ it('answers unresolvable when the map is absent and when the array is', () => {
206
+ expect(sourceRosterMembership('export const OTHER = {};\n', SLUG, PROJECT)).toBe('unresolvable');
207
+ expect(sourceRosterMembership("export const MX_AGENT_PROJECT = 'mx-agent';\nexport const PROVISIONED_ROSTERS = {\n [MX_AGENT_PROJECT]: MISSING_CONST,\n};\n", SLUG, PROJECT)).toBe('unresolvable');
208
+ });
209
+ it('reads a multi-line array literal, comments and prose included', () => {
210
+ // Both shapes exist in the real file: one line (`rosters.ts:122`) and many
211
+ // (`:29`, `:53`, `:76`). A parse that stops at the first `]` or reads only
212
+ // one line answers absent for every team below the first.
213
+ const source = [
214
+ "export const MX_AGENT_PROJECT = 'mx-agent';",
215
+ '/**',
216
+ ' * `platform` is still NOT an enqueue target.',
217
+ ' */',
218
+ 'export const MX_AGENT_TEAMS: readonly string[] = [',
219
+ " 'product',",
220
+ " // 'platform', retired 2026-08-21",
221
+ " 'bootstrap',",
222
+ ` '${SLUG}',`,
223
+ '];',
224
+ 'export const PROVISIONED_ROSTERS: Readonly<Record<string, readonly string[]>> = {',
225
+ ' [MX_AGENT_PROJECT]: MX_AGENT_TEAMS,',
226
+ '};',
227
+ ].join('\n');
228
+ expect(sourceRosterMembership(source, SLUG, PROJECT)).toBe('present');
229
+ expect(sourceRosterMembership(source, 'bootstrap', PROJECT)).toBe('present');
230
+ expect(sourceRosterMembership(source, 'platform', PROJECT)).toBe('absent');
231
+ });
232
+ it('reads a multi-line array from the real file: the memnexus provisioned roster', () => {
233
+ // `MEMNEXUS_PROVISIONED_TEAMS` (`rosters.ts:53`) is the multi-line shape.
234
+ // Read through the parse rather than through the project map, whose
235
+ // `DEFAULT_PROJECT` key this file does not define.
236
+ const real = join(dirname(fileURLToPath(import.meta.url)), '..', '..', '..', 'coordination-service', 'src', 'config', 'rosters.ts');
237
+ const source = readFileSync(real, 'utf-8')
238
+ .replace('export const PROVISIONED_ROSTERS', 'export const UNUSED_ROSTERS')
239
+ + "\nexport const PROVISIONED_ROSTERS = {\n 'memnexus': MEMNEXUS_PROVISIONED_TEAMS,\n};\n";
240
+ expect(sourceRosterMembership(source, 'platform', 'memnexus')).toBe('present');
241
+ expect(sourceRosterMembership(source, 'product', 'memnexus')).toBe('present');
242
+ expect(sourceRosterMembership(source, 'bootstrap', 'memnexus')).toBe('absent');
243
+ });
244
+ it('a commented-out declaration never shadows the real one', () => {
245
+ // The strip runs before the regex looks for the export. A block comment
246
+ // holding a roster declaration would otherwise be found first and answer
247
+ // for the real one (security review, Should Fix 2).
248
+ const source = [
249
+ "export const MX_AGENT_PROJECT = 'mx-agent';",
250
+ '/*',
251
+ "export const MX_AGENT_TEAMS: readonly string[] = ['evil'];",
252
+ '*/',
253
+ "// export const MX_AGENT_TEAMS: readonly string[] = ['evil'];",
254
+ 'export const MX_AGENT_TEAMS: readonly string[] = [',
255
+ " // 'evil',",
256
+ " 'bootstrap',",
257
+ '];',
258
+ '/*',
259
+ "export const PROVISIONED_ROSTERS = { [MX_AGENT_PROJECT]: EVIL_TEAMS };",
260
+ '*/',
261
+ 'export const PROVISIONED_ROSTERS: Readonly<Record<string, readonly string[]>> = {',
262
+ ' [MX_AGENT_PROJECT]: MX_AGENT_TEAMS,',
263
+ '};',
264
+ ].join('\n');
265
+ expect(sourceRosterMembership(source, 'evil', PROJECT)).toBe('absent');
266
+ expect(sourceRosterMembership(source, 'bootstrap', PROJECT)).toBe('present');
267
+ });
268
+ it('reads a slug holding // or ] as text, not as a comment or an array end', () => {
269
+ // The strip tracks quotes, and the bracket scan skips string literals. A
270
+ // slug is never either of these shapes, and a parse that gets it wrong
271
+ // truncates the array and answers absent for every member after it.
272
+ const source = [
273
+ "export const MX_AGENT_PROJECT = 'mx-agent';",
274
+ 'export const MX_AGENT_TEAMS: readonly string[] = [',
275
+ " 'odd//name]',",
276
+ " 'bootstrap',",
277
+ ` '${SLUG}',`,
278
+ '];',
279
+ 'export const PROVISIONED_ROSTERS = {',
280
+ ' [MX_AGENT_PROJECT]: MX_AGENT_TEAMS,',
281
+ '};',
282
+ ].join('\n');
283
+ expect(sourceRosterMembership(source, 'odd//name]', PROJECT)).toBe('present');
284
+ expect(sourceRosterMembership(source, 'bootstrap', PROJECT)).toBe('present');
285
+ expect(sourceRosterMembership(source, SLUG, PROJECT)).toBe('present');
286
+ expect(sourceRosterMembership(source, 'evil', PROJECT)).toBe('absent');
287
+ });
288
+ it('reads a string-literal key as well as a const one', () => {
289
+ const source = [
290
+ "export const MX_AGENT_TEAMS: readonly string[] = ['product', 'scratchteam'];",
291
+ 'export const PROVISIONED_ROSTERS = {',
292
+ " 'mx-agent': MX_AGENT_TEAMS,",
293
+ '};',
294
+ ].join('\n');
295
+ expect(sourceRosterMembership(source, SLUG, PROJECT)).toBe('present');
296
+ expect(sourceRosterMembership(source, 'nobody', PROJECT)).toBe('absent');
297
+ });
298
+ });
299
+ //# sourceMappingURL=roster.test.js.map