@chankov/agent-fleet 0.0.11 → 1.0.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 (494) hide show
  1. package/.pi/extensions/agent-fleet-update-check/README.md +4 -4
  2. package/.pi/extensions/btw/README.md +26 -25
  3. package/.pi/extensions/btw/index.ts +80 -83
  4. package/.pi/extensions/pi-voice-stt/README.md +4 -3
  5. package/.pi/extensions/pi-voice-stt/config.ts +1 -1
  6. package/.pi/harnesses/agent-hub/README.md +106 -54
  7. package/.pi/harnesses/agent-hub/backend-policy.js +25 -4
  8. package/.pi/harnesses/agent-hub/footer.ts +4 -0
  9. package/.pi/harnesses/agent-hub/helpers.ts +18 -0
  10. package/.pi/harnesses/agent-hub/index.ts +537 -369
  11. package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +10 -1
  12. package/.pi/harnesses/agent-hub/package.json +1 -1
  13. package/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  14. package/.pi/harnesses/agent-hub/posture.ts +103 -0
  15. package/.pi/harnesses/ask-user-remote/README.md +37 -3
  16. package/.pi/harnesses/ask-user-remote/index.ts +173 -17
  17. package/.pi/harnesses/coms/package.json +1 -1
  18. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  19. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +118 -0
  20. package/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  21. package/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
  22. package/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  23. package/.pi/harnesses/lib/fleet-panel.ts +34 -0
  24. package/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  25. package/.pi/harnesses/lib/fleet-selection.ts +24 -0
  26. package/.pi/harnesses/package-lock.json +2011 -0
  27. package/.pi/harnesses/package.json +1 -0
  28. package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/README.md +4 -4
  29. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/README.md +4 -3
  30. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/config.ts +1 -1
  31. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +10 -1
  32. package/.versions/0.0.11/.pi/harnesses/ask-user-remote/README.md +37 -3
  33. package/.versions/0.0.11/.pi/harnesses/ask-user-remote/index.ts +173 -17
  34. package/.versions/0.0.11/.pi/harnesses/package-lock.json +2011 -0
  35. package/.versions/0.0.11/.pi/harnesses/package.json +1 -0
  36. package/.versions/0.0.11/docs/ARCHITECTURE.md +6 -8
  37. package/.versions/0.0.11/docs/agent-fleet-setup.md +17 -43
  38. package/.versions/0.0.11/docs/claude-code-coms-bridge.md +20 -2
  39. package/.versions/0.0.11/docs/coms-hermes-bridge.md +1 -1
  40. package/.versions/0.0.11/docs/getting-started.md +26 -237
  41. package/.versions/0.0.11/docs/npm-install.md +60 -478
  42. package/.versions/0.0.11/docs/pi-extensions.md +4 -4
  43. package/.versions/0.0.11/docs/pi-setup.md +37 -551
  44. package/.versions/0.0.11/hermes/README.md +1 -1
  45. package/.versions/0.0.11/install-manifest.json +375 -1247
  46. package/.versions/0.0.11/justfile +13 -6
  47. package/.versions/0.0.11/manifest-meta.json +543 -134
  48. package/.versions/0.0.11/scripts/lib/fleet-command.ts +8 -0
  49. package/.versions/0.0.11/scripts/lib/monitor-env.ts +18 -6
  50. package/.versions/0.0.11/skills/designing-agents/SKILL.md +1 -1
  51. package/.versions/0.0.11/skills/designing-agents/pi-harness-authoring.md +1 -1
  52. package/.versions/1.0.0/.pi/agents/dispatch-policy.yaml +32 -0
  53. package/.versions/1.0.0/.pi/agents/model-profiles.yaml +27 -0
  54. package/.versions/1.0.0/.pi/agents/peers.yaml +142 -0
  55. package/.versions/1.0.0/.pi/agents/teams.yaml +41 -0
  56. package/.versions/1.0.0/.pi/damage-control-rules.yaml +297 -0
  57. package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  58. package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  59. package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  60. package/.versions/1.0.0/.pi/extensions/btw/README.md +120 -0
  61. package/.versions/1.0.0/.pi/extensions/btw/index.ts +914 -0
  62. package/.versions/1.0.0/.pi/extensions/btw/package.json +6 -0
  63. package/.versions/1.0.0/.pi/extensions/btw/state.js +179 -0
  64. package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  65. package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  66. package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  67. package/.versions/1.0.0/.pi/extensions/compact-and-continue/README.md +42 -0
  68. package/.versions/1.0.0/.pi/extensions/compact-and-continue/index.ts +120 -0
  69. package/.versions/1.0.0/.pi/extensions/compact-and-continue/package.json +6 -0
  70. package/.versions/1.0.0/.pi/extensions/mcp-bridge/README.md +46 -0
  71. package/.versions/1.0.0/.pi/extensions/mcp-bridge/index.ts +206 -0
  72. package/.versions/1.0.0/.pi/extensions/mcp-bridge/package.json +6 -0
  73. package/.versions/1.0.0/.pi/extensions/package-lock.json +1143 -0
  74. package/.versions/1.0.0/.pi/extensions/package.json +9 -0
  75. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/README.md +205 -0
  76. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/config.ts +198 -0
  77. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  78. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
  79. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/package.json +6 -0
  80. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  81. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  82. package/.versions/1.0.0/.pi/harnesses/agent-hub/README.md +1056 -0
  83. package/.versions/1.0.0/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  84. package/.versions/1.0.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
  85. package/.versions/1.0.0/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  86. package/.versions/1.0.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  87. package/.versions/1.0.0/.pi/harnesses/agent-hub/context-window.js +106 -0
  88. package/.versions/1.0.0/.pi/harnesses/agent-hub/delegate.ts +435 -0
  89. package/.versions/1.0.0/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  90. package/.versions/1.0.0/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  91. package/.versions/1.0.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  92. package/.versions/1.0.0/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  93. package/.versions/1.0.0/.pi/harnesses/agent-hub/footer.ts +35 -0
  94. package/.versions/1.0.0/.pi/harnesses/agent-hub/helpers.ts +266 -0
  95. package/.versions/1.0.0/.pi/harnesses/agent-hub/index.ts +9279 -0
  96. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  97. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  98. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  99. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  100. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  101. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  102. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  103. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  104. package/.versions/1.0.0/.pi/harnesses/agent-hub/package.json +7 -0
  105. package/.versions/1.0.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  106. package/.versions/1.0.0/.pi/harnesses/agent-hub/posture.ts +103 -0
  107. package/.versions/1.0.0/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  108. package/.versions/1.0.0/.pi/harnesses/agent-hub/research-retention.js +34 -0
  109. package/.versions/1.0.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  110. package/.versions/1.0.0/.pi/harnesses/agent-hub/return-contract.js +293 -0
  111. package/.versions/1.0.0/.pi/harnesses/agent-hub/return-extract.js +75 -0
  112. package/.versions/1.0.0/.pi/harnesses/agent-hub/review-findings.js +102 -0
  113. package/.versions/1.0.0/.pi/harnesses/agent-hub/run-budget.js +479 -0
  114. package/.versions/1.0.0/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  115. package/.versions/1.0.0/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  116. package/.versions/1.0.0/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  117. package/.versions/1.0.0/.pi/harnesses/agent-hub/session-health.js +110 -0
  118. package/.versions/1.0.0/.pi/harnesses/agent-hub/spawn.ts +354 -0
  119. package/.versions/1.0.0/.pi/harnesses/agent-hub/version.ts +42 -0
  120. package/.versions/1.0.0/.pi/harnesses/ask-user-remote/README.md +53 -0
  121. package/.versions/1.0.0/.pi/harnesses/ask-user-remote/index.ts +477 -0
  122. package/.versions/1.0.0/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  123. package/.versions/1.0.0/.pi/harnesses/coms/README.md +100 -0
  124. package/.versions/1.0.0/.pi/harnesses/coms/index.ts +1767 -0
  125. package/.versions/1.0.0/.pi/harnesses/coms/package.json +7 -0
  126. package/.versions/1.0.0/.pi/harnesses/coms/version.ts +42 -0
  127. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/README.md +124 -0
  128. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/index.ts +536 -0
  129. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/package.json +7 -0
  130. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
  131. package/.versions/1.0.0/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  132. package/.versions/1.0.0/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  133. package/.versions/1.0.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +118 -0
  134. package/.versions/1.0.0/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  135. package/.versions/1.0.0/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
  136. package/.versions/1.0.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  137. package/.versions/1.0.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
  138. package/.versions/1.0.0/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  139. package/.versions/1.0.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
  140. package/.versions/1.0.0/.pi/harnesses/lib/herdr-client.ts +472 -0
  141. package/.versions/1.0.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
  142. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  143. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  144. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  145. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  146. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  147. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  148. package/.versions/1.0.0/.pi/harnesses/lib/spawned-peers.js +190 -0
  149. package/.versions/1.0.0/.pi/harnesses/package-lock.json +2046 -0
  150. package/.versions/1.0.0/.pi/harnesses/package.json +10 -0
  151. package/.versions/1.0.0/.pi/prompts/af-build.md +24 -0
  152. package/{.claude/commands/code-simplify.md → .versions/1.0.0/.pi/prompts/af-code-simplify.md} +3 -3
  153. package/{.claude/commands/plan.md → .versions/1.0.0/.pi/prompts/af-plan.md} +1 -1
  154. package/.versions/{0.0.11/.claude/commands/review.md → 1.0.0/.pi/prompts/af-review.md} +3 -3
  155. package/.versions/1.0.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  156. package/.versions/1.0.0/.pi/prompts/af-ship.md +17 -0
  157. package/.versions/{0.0.11/.claude/commands/spec.md → 1.0.0/.pi/prompts/af-spec.md} +1 -1
  158. package/.versions/{0.0.11/.claude/commands/test.md → 1.0.0/.pi/prompts/af-test.md} +2 -2
  159. package/.versions/1.0.0/.pi/skills/bowser/SKILL.md +145 -0
  160. package/.versions/1.0.0/.version +1 -0
  161. package/.versions/1.0.0/agents/architect.md +24 -0
  162. package/.versions/1.0.0/agents/bowser.md +27 -0
  163. package/.versions/1.0.0/agents/builder.md +54 -0
  164. package/.versions/1.0.0/agents/code-reviewer.md +208 -0
  165. package/.versions/1.0.0/agents/deep-researcher.md +32 -0
  166. package/.versions/1.0.0/agents/documenter.md +18 -0
  167. package/.versions/1.0.0/agents/orchestrator.md +72 -0
  168. package/.versions/1.0.0/agents/plan-reviewer.md +83 -0
  169. package/.versions/1.0.0/agents/planner.md +70 -0
  170. package/.versions/1.0.0/agents/releaser.md +24 -0
  171. package/.versions/1.0.0/agents/researcher.md +28 -0
  172. package/.versions/1.0.0/agents/security-auditor.md +167 -0
  173. package/.versions/1.0.0/agents/test-engineer.md +153 -0
  174. package/.versions/1.0.0/agents/web-debugger.md +43 -0
  175. package/.versions/1.0.0/agents/web-performance-auditor.md +193 -0
  176. package/.versions/1.0.0/codex/CONDUCTOR.md +148 -0
  177. package/.versions/1.0.0/docs/ARCHITECTURE.md +337 -0
  178. package/.versions/1.0.0/docs/agent-fleet-setup.md +437 -0
  179. package/.versions/1.0.0/docs/claude-code-coms-bridge.md +128 -0
  180. package/.versions/1.0.0/docs/codex-remote-conductor.md +170 -0
  181. package/.versions/1.0.0/docs/coms-hermes-bridge.md +189 -0
  182. package/.versions/1.0.0/docs/getting-started.md +98 -0
  183. package/.versions/1.0.0/docs/npm-install.md +292 -0
  184. package/.versions/1.0.0/docs/pi-extensions.md +412 -0
  185. package/.versions/1.0.0/docs/pi-setup.md +74 -0
  186. package/.versions/1.0.0/docs/skill-anatomy.md +150 -0
  187. package/.versions/1.0.0/hermes/README.md +347 -0
  188. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  189. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  190. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  191. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  192. package/.versions/1.0.0/hermes/gates/gate-o-capability.md +8 -0
  193. package/.versions/1.0.0/hermes/gates/gate-o-validator-fixtures.json +1 -0
  194. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  195. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  196. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  197. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  198. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  199. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  200. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  201. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  202. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  203. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  204. package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  205. package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  206. package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  207. package/.versions/1.0.0/hermes/skills/hub-conductor/SKILL.md +84 -0
  208. package/.versions/1.0.0/hermes/skills/hub-liaison/SKILL.md +84 -0
  209. package/.versions/1.0.0/hermes/skills/hub-watchdog/SKILL.md +76 -0
  210. package/.versions/1.0.0/hermes/skills/hub-watchdog/manifest.json +1 -0
  211. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  212. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  213. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  214. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  215. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  216. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  217. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  218. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  219. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  220. package/.versions/1.0.0/hermes/watchdog-tests/__init__.py +0 -0
  221. package/.versions/1.0.0/hooks/coms-stop-hook.mjs +84 -0
  222. package/.versions/1.0.0/install-manifest.json +2745 -0
  223. package/.versions/1.0.0/justfile +272 -0
  224. package/.versions/1.0.0/manifest-meta.json +882 -0
  225. package/.versions/1.0.0/references/accessibility-checklist.md +160 -0
  226. package/.versions/1.0.0/references/definition-of-done.md +67 -0
  227. package/.versions/1.0.0/references/fleet-coordination-patterns.md +151 -0
  228. package/.versions/1.0.0/references/observability-checklist.md +91 -0
  229. package/.versions/1.0.0/references/orchestration-patterns.md +370 -0
  230. package/.versions/1.0.0/references/performance-checklist.md +153 -0
  231. package/.versions/1.0.0/references/prompting-patterns.md +380 -0
  232. package/.versions/1.0.0/references/security-checklist.md +179 -0
  233. package/.versions/1.0.0/references/testing-patterns.md +236 -0
  234. package/.versions/1.0.0/scripts/codex-conductor.ts +41 -0
  235. package/.versions/1.0.0/scripts/codex-remote-control.ts +167 -0
  236. package/.versions/1.0.0/scripts/coms-claude-bridge.ts +411 -0
  237. package/.versions/1.0.0/scripts/coms-cli.ts +484 -0
  238. package/.versions/1.0.0/scripts/coms-hermes-bridge.ts +413 -0
  239. package/.versions/1.0.0/scripts/fleet.ts +185 -0
  240. package/.versions/1.0.0/scripts/hermes-monitor-capability-runner.ts +25 -0
  241. package/.versions/1.0.0/scripts/hermes-monitor-scenario.ts +474 -0
  242. package/.versions/1.0.0/scripts/hermes-watchdog-capability-probe.ts +45 -0
  243. package/.versions/1.0.0/scripts/install-hermes-plugin.sh +180 -0
  244. package/.versions/1.0.0/scripts/lib/claude-bridge-core.ts +210 -0
  245. package/.versions/1.0.0/scripts/lib/codex-conductor.ts +88 -0
  246. package/.versions/1.0.0/scripts/lib/codex-remote-control.ts +480 -0
  247. package/.versions/1.0.0/scripts/lib/coms-envelope.ts +582 -0
  248. package/.versions/1.0.0/scripts/lib/fake-herdr-server.ts +88 -0
  249. package/.versions/1.0.0/scripts/lib/fleet-command.ts +266 -0
  250. package/.versions/1.0.0/scripts/lib/herdr-layout.ts +281 -0
  251. package/.versions/1.0.0/scripts/lib/hermes-bridge-core.ts +241 -0
  252. package/.versions/1.0.0/scripts/lib/hermes-monitor-events.ts +1 -0
  253. package/.versions/1.0.0/scripts/lib/hermes-monitor-herdr.ts +2 -0
  254. package/.versions/1.0.0/scripts/lib/hermes-monitor-model.ts +3 -0
  255. package/.versions/1.0.0/scripts/lib/hermes-monitor-registry.ts +2 -0
  256. package/.versions/1.0.0/scripts/lib/hermes-monitor-socket.ts +2 -0
  257. package/.versions/1.0.0/scripts/lib/hermes-monitor-store.ts +2 -0
  258. package/.versions/1.0.0/scripts/lib/monitor-env.ts +146 -0
  259. package/.versions/1.0.0/scripts/lib/peer-launch.ts +318 -0
  260. package/.versions/1.0.0/scripts/lib/persona-banner.ts +62 -0
  261. package/.versions/1.0.0/scripts/lib/spawn-stagger.ts +101 -0
  262. package/.versions/1.0.0/scripts/lib/team-project.ts +213 -0
  263. package/.versions/1.0.0/scripts/lib/team-snapshot.ts +147 -0
  264. package/.versions/1.0.0/scripts/peer-banner.ts +40 -0
  265. package/.versions/1.0.0/scripts/peer-launch.ts +259 -0
  266. package/.versions/1.0.0/scripts/team-snapshot.ts +237 -0
  267. package/.versions/1.0.0/scripts/team-up.ts +406 -0
  268. package/.versions/1.0.0/skills/_internal/grilling.md +11 -0
  269. package/.versions/1.0.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
  270. package/.versions/1.0.0/skills/code-review-and-quality/SKILL.md +381 -0
  271. package/.versions/1.0.0/skills/compound-learning/SKILL.md +137 -0
  272. package/.versions/1.0.0/skills/context-engineering/SKILL.md +291 -0
  273. package/.versions/1.0.0/skills/deprecation-and-migration/SKILL.md +206 -0
  274. package/.versions/1.0.0/skills/designing-agents/SKILL.md +394 -0
  275. package/.versions/1.0.0/skills/designing-agents/pi-harness-authoring.md +222 -0
  276. package/.versions/1.0.0/skills/frontend-ui-engineering/SKILL.md +328 -0
  277. package/.versions/1.0.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
  278. package/.versions/1.0.0/skills/idea-refine/SKILL.md +182 -0
  279. package/.versions/1.0.0/skills/idea-refine/examples.md +238 -0
  280. package/.versions/1.0.0/skills/idea-refine/frameworks.md +99 -0
  281. package/.versions/1.0.0/skills/idea-refine/refinement-criteria.md +113 -0
  282. package/.versions/1.0.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
  283. package/.versions/1.0.0/skills/incremental-implementation/SKILL.md +287 -0
  284. package/.versions/1.0.0/skills/interview-me/SKILL.md +226 -0
  285. package/.versions/1.0.0/skills/orchestration-verification/SKILL.md +181 -0
  286. package/.versions/1.0.0/skills/peer-coms/SKILL.md +90 -0
  287. package/.versions/1.0.0/skills/performance-optimization/SKILL.md +350 -0
  288. package/.versions/1.0.0/skills/planning-and-task-breakdown/SKILL.md +254 -0
  289. package/.versions/1.0.0/skills/security-and-hardening/SKILL.md +461 -0
  290. package/.versions/1.0.0/skills/spec-driven-development/SKILL.md +257 -0
  291. package/.versions/1.0.0/skills/using-agent-skills/SKILL.md +199 -0
  292. package/.versions/1.0.0/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  293. package/.versions/1.0.0/vendor/agent-skills-upstream/LICENSE +21 -0
  294. package/.versions/1.0.0/vendor/agent-skills-upstream/README.md +11 -0
  295. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  296. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  297. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  298. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  299. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  300. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  301. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  302. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  303. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  304. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  305. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  306. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  307. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  308. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  309. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  310. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  311. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  312. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  313. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  314. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  315. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  316. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  317. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  318. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  319. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  320. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  321. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  322. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  323. package/CHANGELOG.md +142 -0
  324. package/README.md +117 -79
  325. package/agents/orchestrator.md +1 -1
  326. package/bin/cli.js +289 -359
  327. package/bin/force-patch-changesets.js +18 -2
  328. package/bin/lib/apply.js +86 -32
  329. package/bin/lib/desired.js +87 -0
  330. package/bin/lib/detect-agent.js +22 -38
  331. package/bin/lib/doctor.js +283 -33
  332. package/bin/lib/features.js +78 -0
  333. package/bin/lib/manifest.js +127 -48
  334. package/bin/lib/overrides.js +35 -0
  335. package/bin/lib/personas.js +37 -0
  336. package/bin/lib/plan.js +18 -9
  337. package/bin/lib/purge.js +11 -0
  338. package/bin/lib/reconcile.js +68 -0
  339. package/bin/lib/scan.js +24 -0
  340. package/bin/lib/state.js +25 -1
  341. package/bin/lib/stt-wizard.js +33 -0
  342. package/bin/lib/transaction.js +149 -0
  343. package/bin/lib/tui.js +71 -0
  344. package/bin/lib/verify.js +9 -26
  345. package/bin/snapshot-version.js +3 -6
  346. package/docs/ARCHITECTURE.md +55 -21
  347. package/docs/MIGRATION-agent-fleet.md +222 -0
  348. package/docs/agent-fleet-setup.md +124 -64
  349. package/docs/claude-code-coms-bridge.md +21 -2
  350. package/docs/coms-hermes-bridge.md +1 -1
  351. package/docs/getting-started.md +61 -217
  352. package/docs/npm-install.md +207 -429
  353. package/docs/pi-extensions.md +85 -41
  354. package/docs/pi-setup.md +48 -545
  355. package/hermes/README.md +1 -1
  356. package/install-manifest.json +385 -1255
  357. package/justfile +45 -27
  358. package/manifest-meta.json +544 -134
  359. package/node_modules/pi-ask-user/README.md +43 -5
  360. package/node_modules/pi-ask-user/index.ts +630 -75
  361. package/node_modules/pi-ask-user/package.json +1 -1
  362. package/package.json +5 -11
  363. package/scripts/coms-claude-bridge.ts +10 -0
  364. package/scripts/fleet.ts +107 -90
  365. package/scripts/lib/claude-bridge-core.ts +45 -0
  366. package/scripts/lib/fleet-command.ts +170 -15
  367. package/scripts/lib/monitor-env.ts +18 -6
  368. package/scripts/lib/peer-launch.ts +6 -2
  369. package/scripts/lib/team-project.ts +24 -4
  370. package/scripts/team-up.ts +57 -11
  371. package/skills/designing-agents/SKILL.md +1 -1
  372. package/skills/designing-agents/pi-harness-authoring.md +3 -3
  373. package/.claude/commands/build.md +0 -44
  374. package/.claude/commands/design-agent.md +0 -14
  375. package/.claude/commands/doctor-agent-fleet.md +0 -22
  376. package/.claude/commands/orchestrate.md +0 -112
  377. package/.claude/commands/prime.md +0 -22
  378. package/.claude/commands/review.md +0 -16
  379. package/.claude/commands/set-hermes-telegram.md +0 -15
  380. package/.claude/commands/set-hermes-watchdog.md +0 -6
  381. package/.claude/commands/setup-agent-fleet.md +0 -17
  382. package/.claude/commands/ship.md +0 -72
  383. package/.claude/commands/spec.md +0 -15
  384. package/.claude/commands/test.md +0 -19
  385. package/.claude/commands/webperf.md +0 -32
  386. package/.claude/orchestrate-teams.yaml +0 -24
  387. package/.opencode/commands/af-build.md +0 -17
  388. package/.opencode/commands/af-code-simplify.md +0 -16
  389. package/.opencode/commands/af-compound.md +0 -16
  390. package/.opencode/commands/af-design-agent.md +0 -15
  391. package/.opencode/commands/af-doctor-agent-fleet.md +0 -22
  392. package/.opencode/commands/af-orchestrate.md +0 -112
  393. package/.opencode/commands/af-plan.md +0 -16
  394. package/.opencode/commands/af-prime.md +0 -22
  395. package/.opencode/commands/af-review.md +0 -15
  396. package/.opencode/commands/af-set-hermes-watchdog.md +0 -6
  397. package/.opencode/commands/af-setup-agent-fleet.md +0 -17
  398. package/.opencode/commands/af-ship.md +0 -16
  399. package/.opencode/commands/af-spec.md +0 -16
  400. package/.opencode/commands/af-test.md +0 -21
  401. package/.opencode/commands/af-webperf.md +0 -32
  402. package/.opencode/orchestrate-teams.yaml +0 -24
  403. package/.pi/prompts/af-doctor-agent-fleet.md +0 -22
  404. package/.pi/prompts/af-setup-agent-fleet.md +0 -19
  405. package/.versions/0.0.1/.opencode/commands/af-doctor-agent-fleet.md +0 -15
  406. package/.versions/0.0.1/.opencode/commands/af-setup-agent-fleet.md +0 -15
  407. package/.versions/0.0.1/skills/guided-workspace-setup/SKILL.md +0 -506
  408. package/.versions/0.0.10/.opencode/commands/af-doctor-agent-fleet.md +0 -22
  409. package/.versions/0.0.10/.opencode/commands/af-setup-agent-fleet.md +0 -17
  410. package/.versions/0.0.10/.pi/prompts/af-doctor-agent-fleet.md +0 -22
  411. package/.versions/0.0.10/.pi/prompts/af-setup-agent-fleet.md +0 -19
  412. package/.versions/0.0.10/skills/guided-workspace-setup/SKILL.md +0 -226
  413. package/.versions/0.0.11/.claude/commands/build.md +0 -44
  414. package/.versions/0.0.11/.claude/commands/code-simplify.md +0 -22
  415. package/.versions/0.0.11/.claude/commands/design-agent.md +0 -14
  416. package/.versions/0.0.11/.claude/commands/doctor-agent-fleet.md +0 -22
  417. package/.versions/0.0.11/.claude/commands/orchestrate.md +0 -112
  418. package/.versions/0.0.11/.claude/commands/plan.md +0 -16
  419. package/.versions/0.0.11/.claude/commands/prime.md +0 -22
  420. package/.versions/0.0.11/.claude/commands/set-hermes-telegram.md +0 -15
  421. package/.versions/0.0.11/.claude/commands/set-hermes-watchdog.md +0 -6
  422. package/.versions/0.0.11/.claude/commands/setup-agent-fleet.md +0 -17
  423. package/.versions/0.0.11/.claude/commands/ship.md +0 -72
  424. package/.versions/0.0.11/.claude/commands/webperf.md +0 -32
  425. package/.versions/0.0.11/.claude/orchestrate-teams.yaml +0 -24
  426. package/.versions/0.0.11/.opencode/commands/af-build.md +0 -17
  427. package/.versions/0.0.11/.opencode/commands/af-code-simplify.md +0 -16
  428. package/.versions/0.0.11/.opencode/commands/af-compound.md +0 -16
  429. package/.versions/0.0.11/.opencode/commands/af-design-agent.md +0 -15
  430. package/.versions/0.0.11/.opencode/commands/af-doctor-agent-fleet.md +0 -22
  431. package/.versions/0.0.11/.opencode/commands/af-orchestrate.md +0 -112
  432. package/.versions/0.0.11/.opencode/commands/af-plan.md +0 -16
  433. package/.versions/0.0.11/.opencode/commands/af-prime.md +0 -22
  434. package/.versions/0.0.11/.opencode/commands/af-review.md +0 -15
  435. package/.versions/0.0.11/.opencode/commands/af-set-hermes-telegram.md +0 -15
  436. package/.versions/0.0.11/.opencode/commands/af-set-hermes-watchdog.md +0 -6
  437. package/.versions/0.0.11/.opencode/commands/af-setup-agent-fleet.md +0 -17
  438. package/.versions/0.0.11/.opencode/commands/af-ship.md +0 -16
  439. package/.versions/0.0.11/.opencode/commands/af-spec.md +0 -16
  440. package/.versions/0.0.11/.opencode/commands/af-test.md +0 -21
  441. package/.versions/0.0.11/.opencode/commands/af-webperf.md +0 -32
  442. package/.versions/0.0.11/.opencode/orchestrate-teams.yaml +0 -24
  443. package/.versions/0.0.11/.pi/prompts/af-doctor-agent-fleet.md +0 -22
  444. package/.versions/0.0.11/.pi/prompts/af-setup-agent-fleet.md +0 -19
  445. package/.versions/0.0.11/docs/opencode-setup.md +0 -281
  446. package/.versions/0.0.11/hooks/SIMPLIFY-IGNORE.md +0 -90
  447. package/.versions/0.0.11/hooks/hooks.json +0 -14
  448. package/.versions/0.0.11/hooks/session-start.sh +0 -74
  449. package/.versions/0.0.11/hooks/simplify-ignore.sh +0 -302
  450. package/.versions/0.0.11/skills/guided-workspace-setup/SKILL.md +0 -226
  451. package/.versions/0.0.4/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  452. package/.versions/0.0.4/.opencode/commands/af-setup-agent-fleet.md +0 -15
  453. package/.versions/0.0.4/skills/guided-workspace-setup/SKILL.md +0 -535
  454. package/.versions/0.0.4/skills/guided-workspace-setup/companion-manifest.json +0 -33
  455. package/.versions/0.0.5/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  456. package/.versions/0.0.5/.opencode/commands/af-setup-agent-fleet.md +0 -15
  457. package/.versions/0.0.5/skills/guided-workspace-setup/SKILL.md +0 -542
  458. package/.versions/0.0.5/skills/guided-workspace-setup/companion-manifest.json +0 -35
  459. package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  460. package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +0 -15
  461. package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  462. package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +0 -27
  463. package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +0 -544
  464. package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +0 -35
  465. package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  466. package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +0 -15
  467. package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  468. package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +0 -27
  469. package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +0 -544
  470. package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +0 -35
  471. package/.versions/0.0.8/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  472. package/.versions/0.0.8/.opencode/commands/af-setup-agent-fleet.md +0 -15
  473. package/.versions/0.0.8/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  474. package/.versions/0.0.8/.pi/prompts/af-setup-agent-fleet.md +0 -27
  475. package/.versions/0.0.8/skills/guided-workspace-setup/SKILL.md +0 -544
  476. package/.versions/0.0.8/skills/guided-workspace-setup/companion-manifest.json +0 -36
  477. package/.versions/0.0.9/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  478. package/.versions/0.0.9/.opencode/commands/af-setup-agent-fleet.md +0 -15
  479. package/.versions/0.0.9/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  480. package/.versions/0.0.9/.pi/prompts/af-setup-agent-fleet.md +0 -27
  481. package/.versions/0.0.9/skills/guided-workspace-setup/SKILL.md +0 -544
  482. package/bin/lib/bootstrap.js +0 -323
  483. package/bin/lib/transform-persona.js +0 -180
  484. package/docs/opencode-setup.md +0 -281
  485. package/hooks/SIMPLIFY-IGNORE.md +0 -90
  486. package/hooks/hooks.json +0 -14
  487. package/hooks/session-start.sh +0 -74
  488. package/hooks/simplify-ignore.sh +0 -302
  489. package/skills/guided-workspace-setup/SKILL.md +0 -226
  490. /package/.versions/0.0.10/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
  491. /package/.versions/0.0.11/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
  492. /package/{.opencode/commands → .versions/1.0.0/.pi/prompts}/af-set-hermes-telegram.md +0 -0
  493. /package/.versions/{0.0.9/skills/guided-workspace-setup/companion-manifest.json → 1.0.0/bin/catalog/harness-runtime-closure.json} +0 -0
  494. /package/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
@@ -0,0 +1,480 @@
1
+ // Validated, non-secret lifecycle helpers for the experimental Codex user unit.
2
+ // `active (exited)` is only systemd's requested state; it is never health.
3
+
4
+ import { spawnSync } from "node:child_process";
5
+ import * as fs from "node:fs";
6
+ import * as os from "node:os";
7
+ import * as path from "node:path";
8
+ import { fileURLToPath } from "node:url";
9
+
10
+ export const UNIT_NAME = "agent-fleet-codex-remote-control.service";
11
+ export const CONFIG_MARKER = "agent-fleet-codex-remote-control-v1";
12
+ export const UNIT_MARKER = "# Managed by agent-fleet codex remote-control";
13
+ export const EMERGENCY_STOP_CONFIRMATION = "emergency-stop-confirmed";
14
+ export const CODEX_CONTRACT_IDENTITY = "agent-fleet-codex-conductor-pilot-v1";
15
+ const WORKSPACE_CONTRACT_MARKER = "<!-- Managed by agent-fleet Codex conductor -->";
16
+ const RECOVERY_CONFIRMATION = "operator-confirmed";
17
+ const MAX_TIMEOUT_MS = 0x7fffffff;
18
+ // Observed remote-control teardown needs a bounded settle period before a
19
+ // fresh daemon start; this is not a health probe or a transport assumption.
20
+ const RESTART_SETTLE_MS = 8_000;
21
+ const NAME_SAFE = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
22
+ const PROJECT_SAFE = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
23
+
24
+ export interface CommandResult {
25
+ code: number;
26
+ stdout: string;
27
+ stderr: string;
28
+ }
29
+
30
+ export interface CommandOptions {
31
+ stdio?: "inherit";
32
+ env?: Record<string, string | undefined>;
33
+ }
34
+
35
+ export type CommandRunner = (file: string, args: string[], options?: CommandOptions) => CommandResult;
36
+
37
+ export interface LifecycleConfig {
38
+ marker: typeof CONFIG_MARKER;
39
+ codexBin: string;
40
+ repoRoot: string;
41
+ runtimeDir?: string;
42
+ comsDir: string;
43
+ project: string;
44
+ team: string;
45
+ name: string;
46
+ timeoutMs: number;
47
+ }
48
+
49
+ export interface LifecyclePaths {
50
+ configPath: string;
51
+ unitPath: string;
52
+ runtimeDir: string;
53
+ }
54
+
55
+ export interface RenderOptions {
56
+ nodeBin: string;
57
+ scriptPath: string;
58
+ configPath: string;
59
+ }
60
+
61
+ function fail(message: string): never {
62
+ throw new Error(message);
63
+ }
64
+
65
+ function runOrFail(run: CommandRunner, file: string, args: string[], options?: CommandOptions): CommandResult {
66
+ const result = run(file, args, options);
67
+ if (result.code !== 0) fail(`${file} ${args.join(" ")} failed (${result.code}): ${result.stderr.trim()}`);
68
+ return result;
69
+ }
70
+
71
+ export const systemRunner: CommandRunner = (file, args, options = {}) => {
72
+ const result = spawnSync(file, args, {
73
+ encoding: "utf8",
74
+ stdio: options.stdio === "inherit" ? "inherit" : "pipe",
75
+ env: options.env ? { ...process.env, ...options.env } : process.env,
76
+ });
77
+ if (result.error) throw result.error;
78
+ return {
79
+ code: result.status ?? 1,
80
+ stdout: typeof result.stdout === "string" ? result.stdout : "",
81
+ stderr: typeof result.stderr === "string" ? result.stderr : "",
82
+ };
83
+ };
84
+
85
+ function absoluteFile(value: string, label: string): string {
86
+ if (typeof value !== "string" || !path.isAbsolute(value)) fail(`${label} must be an absolute path`);
87
+ try {
88
+ return fs.realpathSync(value);
89
+ } catch {
90
+ fail(`${label} must resolve to an existing path: ${value}`);
91
+ }
92
+ }
93
+
94
+ function absoluteLocation(value: unknown, label: string): string {
95
+ if (typeof value !== "string" || !path.isAbsolute(value) || value.includes("\0")) {
96
+ fail(`${label} must be an absolute path`);
97
+ }
98
+ const normalized = path.resolve(value);
99
+ if (normalized !== value) fail(`${label} must be normalized`);
100
+ try { return fs.realpathSync(value); } catch { return normalized; }
101
+ }
102
+
103
+ function pathContains(parent: string, child: string): boolean {
104
+ const relative = path.relative(parent, child);
105
+ return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
106
+ }
107
+
108
+ function safeValue(value: unknown, label: string, safe: RegExp): string {
109
+ if (typeof value !== "string" || !safe.test(value) || value.includes("..")) {
110
+ fail(`Invalid ${label}: ${JSON.stringify(value)}`);
111
+ }
112
+ return value;
113
+ }
114
+
115
+ export function validateConfig(input: LifecycleConfig): LifecycleConfig {
116
+ if (!input || input.marker !== CONFIG_MARKER) fail("Codex lifecycle config is not owned by agent-fleet");
117
+ const codexBin = absoluteFile(input.codexBin, "codexBin");
118
+ const repoRoot = absoluteFile(input.repoRoot, "repoRoot");
119
+ if (!fs.statSync(repoRoot).isDirectory()) fail("repoRoot must be a directory");
120
+ const runtimeDir = absoluteLocation(input.runtimeDir ?? lifecyclePaths().runtimeDir, "runtimeDir");
121
+ if (pathContains(repoRoot, runtimeDir)) fail("runtimeDir must be outside repoRoot");
122
+ // `comsDir` was added after the first pilot config was installed. Loading an
123
+ // owned v1 config may derive the same user-scoped default once, while every
124
+ // newly written config persists the validated absolute path explicitly.
125
+ const comsDir = absoluteFile(input.comsDir ?? path.join(os.homedir(), ".pi", "coms"), "comsDir");
126
+ if (!fs.statSync(comsDir).isDirectory()) fail("comsDir must be a directory");
127
+ const project = safeValue(input.project, "project", PROJECT_SAFE);
128
+ const team = safeValue(input.team, "team", NAME_SAFE);
129
+ const name = safeValue(input.name, "name", NAME_SAFE);
130
+ if (!Number.isSafeInteger(input.timeoutMs) || input.timeoutMs <= 0 || input.timeoutMs > MAX_TIMEOUT_MS) {
131
+ fail(`Invalid timeoutMs: ${JSON.stringify(input.timeoutMs)}`);
132
+ }
133
+ return { marker: CONFIG_MARKER, codexBin, repoRoot, runtimeDir, comsDir, project, team, name, timeoutMs: input.timeoutMs };
134
+ }
135
+
136
+ function capability(run: CommandRunner, bin: string, command: "start" | "stop" | "pair"): void {
137
+ const result = run(bin, ["remote-control", command, "--help"]);
138
+ if (result.code !== 0) fail(`Missing required Codex capability: remote-control ${command}`);
139
+ }
140
+
141
+ function requireGlobalOnRequest(run: CommandRunner, bin: string): void {
142
+ const output = runOrFail(run, bin, ["doctor", "--json"]).stdout;
143
+ let policy: unknown;
144
+ try {
145
+ const report = JSON.parse(output) as {
146
+ checks?: Record<string, { details?: Record<string, unknown> }>;
147
+ };
148
+ policy = report.checks?.["sandbox.helpers"]?.details?.["approval policy"];
149
+ } catch {
150
+ fail("Unable to parse redacted Codex doctor output while checking approval policy");
151
+ }
152
+ if (policy !== "OnRequest") {
153
+ fail(`Codex global approval_policy must be on-request for mobile approvals (doctor reported ${JSON.stringify(policy)})`);
154
+ }
155
+ }
156
+
157
+ /** Non-mutating compatibility gate for every normal start/setup lifecycle path. */
158
+ export function preflight(input: LifecycleConfig, run: CommandRunner = systemRunner): LifecycleConfig {
159
+ const config = validateConfig(input);
160
+ const version = runOrFail(run, config.codexBin, ["--version"]).stdout.trim();
161
+ if (!/^codex-cli 0\.144\.\d+(?:\s|$)/.test(version)) {
162
+ fail(`Unsupported Codex CLI version: ${JSON.stringify(version)}; only codex-cli 0.144.x is supported`);
163
+ }
164
+ requireGlobalOnRequest(run, config.codexBin);
165
+ const remoteHelp = runOrFail(run, config.codexBin, ["remote-control", "--help"]).stdout;
166
+ for (const command of ["start", "stop", "pair"] as const) {
167
+ if (!new RegExp(`(?:^|\\s)${command}(?:\\s|$)`, "m").test(remoteHelp)) {
168
+ fail(`Missing required Codex capability: remote-control ${command}`);
169
+ }
170
+ capability(run, config.codexBin, command);
171
+ }
172
+ return config;
173
+ }
174
+
175
+ /** The sole version-drift exception: prove only the exact stop command, then run it. */
176
+ export function verifyEmergencyStopCapability(input: LifecycleConfig, run: CommandRunner = systemRunner, confirmation?: string): LifecycleConfig {
177
+ if (confirmation !== EMERGENCY_STOP_CONFIRMATION) fail("Emergency stop requires explicit operator confirmation");
178
+ const config = validateConfig(input);
179
+ const remoteHelp = runOrFail(run, config.codexBin, ["remote-control", "--help"]).stdout;
180
+ if (!/(?:^|\s)stop(?:\s|$)/m.test(remoteHelp)) fail("Missing required Codex stop capability");
181
+ const stopHelp = run(config.codexBin, ["remote-control", "stop", "--help"]);
182
+ if (stopHelp.code !== 0) fail("Missing required Codex stop capability");
183
+ return config;
184
+ }
185
+
186
+ export function emergencyStop(input: LifecycleConfig, run: CommandRunner = systemRunner, confirmation?: string): void {
187
+ const config = verifyEmergencyStopCapability(input, run, confirmation);
188
+ runOrFail(run, config.codexBin, ["remote-control", "stop"]);
189
+ }
190
+
191
+ export function remoteThreadEnv(input: LifecycleConfig): Record<string, string> {
192
+ const config = validateConfig(input);
193
+ const contractPath = path.join(conductorWorkspacePath(config.runtimeDir!), "AGENTS.md");
194
+ if (absoluteFile(contractPath, "contractPath") !== contractPath) {
195
+ fail("Managed Codex workspace contract path must be a real path under runtimeDir");
196
+ }
197
+ return {
198
+ AGENT_FLEET_REPO_ROOT: config.repoRoot,
199
+ PI_COMS_DIR: config.comsDir,
200
+ COMS_CLI_PROJECT: config.project,
201
+ COMS_CLI_NAME: config.name,
202
+ COMS_CLI_TIMEOUT_MS: String(config.timeoutMs),
203
+ AGENT_FLEET_CODEX_CONTRACT_PATH: contractPath,
204
+ AGENT_FLEET_CODEX_CONTRACT_IDENTITY: CODEX_CONTRACT_IDENTITY,
205
+ AGENT_FLEET_CONDUCTOR_BACKEND: "codex",
206
+ };
207
+ }
208
+
209
+ export function remoteControlStartArgs(input: LifecycleConfig): string[] {
210
+ const config = validateConfig(input);
211
+ return [
212
+ "remote-control", "start",
213
+ "-c", 'approval_policy="on-request"',
214
+ "-c", 'sandbox_mode="workspace-write"',
215
+ "-c", `sandbox_workspace_write.writable_roots=${JSON.stringify([config.comsDir])}`,
216
+ ];
217
+ }
218
+
219
+ /** Used by ExecStart, so direct systemctl starts cannot skip the verified posture. */
220
+ export function unitStart(input: LifecycleConfig, run: CommandRunner = systemRunner): void {
221
+ const config = preflight(input, run);
222
+ runOrFail(run, config.codexBin, remoteControlStartArgs(config), { env: remoteThreadEnv(config) });
223
+ }
224
+
225
+ /** Used by ExecStop. It intentionally supports only the checked emergency-stop path. */
226
+ export function unitStop(input: LifecycleConfig, run: CommandRunner = systemRunner): void {
227
+ emergencyStop(input, run, EMERGENCY_STOP_CONFIRMATION);
228
+ }
229
+
230
+ export function assertConductorContext(
231
+ input: LifecycleConfig,
232
+ expected: { repoRoot: string; project: string; team: string; name: string; timeoutMs: number; contractPath: string; contractIdentity: string },
233
+ ): LifecycleConfig {
234
+ const config = validateConfig(input);
235
+ if (
236
+ config.repoRoot !== expected.repoRoot ||
237
+ config.project !== expected.project ||
238
+ config.team !== expected.team ||
239
+ config.name !== expected.name ||
240
+ config.timeoutMs !== expected.timeoutMs ||
241
+ expected.contractIdentity !== CODEX_CONTRACT_IDENTITY
242
+ ) {
243
+ fail("Configured Codex conductor context does not match the requested repository/project/conductor identity");
244
+ }
245
+ const expectedContract = path.join(conductorWorkspacePath(config.runtimeDir!), "AGENTS.md");
246
+ if (expected.contractPath !== expectedContract || absoluteFile(expected.contractPath, "contractPath") !== expectedContract) {
247
+ fail("Configured Codex contract path does not match the managed workspace contract");
248
+ }
249
+ return config;
250
+ }
251
+
252
+ export function lifecyclePaths(home = os.homedir()): LifecyclePaths {
253
+ return {
254
+ configPath: path.join(home, ".config", "agent-fleet", "codex-remote-control.json"),
255
+ unitPath: path.join(home, ".config", "systemd", "user", UNIT_NAME),
256
+ runtimeDir: path.join(home, ".local", "state", "agent-fleet", "codex-conductor"),
257
+ };
258
+ }
259
+
260
+ export function conductorWorkspacePath(runtimeDir: string): string {
261
+ return path.join(runtimeDir, "workspace");
262
+ }
263
+
264
+ function installWorkspaceContract(config: LifecycleConfig): void {
265
+ const workspacePath = conductorWorkspacePath(config.runtimeDir!);
266
+ fs.mkdirSync(workspacePath, { recursive: true, mode: 0o700 });
267
+ fs.chmodSync(workspacePath, 0o700);
268
+ const sourcePath = path.join(config.repoRoot, "codex", "CONDUCTOR.md");
269
+ const targetPath = path.join(workspacePath, "AGENTS.md");
270
+ if (fs.existsSync(targetPath) && !fs.readFileSync(targetPath, "utf8").startsWith(WORKSPACE_CONTRACT_MARKER)) {
271
+ fail(`Refusing to replace workspace contract not owned by agent-fleet: ${targetPath}`);
272
+ }
273
+ const source = fs.readFileSync(absoluteFile(sourcePath, "source contract"), "utf8");
274
+ if (!source.includes("{{CODEX_CONDUCTOR_SCRIPT}}")) fail("Canonical conductor contract is missing its managed script placeholder");
275
+ const scriptPath = absoluteFile(path.join(config.repoRoot, "scripts", "codex-conductor.ts"), "conductor script");
276
+ const rendered = source.replaceAll("{{CODEX_CONDUCTOR_SCRIPT}}", JSON.stringify(scriptPath));
277
+ writeAtomic(targetPath, `${WORKSPACE_CONTRACT_MARKER}\n${rendered}`, 0o600);
278
+ }
279
+
280
+ /** Escape one value embedded inside a double-quoted systemd unit token. */
281
+ function unitEscape(value: string): string {
282
+ return value
283
+ .replace(/\\/g, "\\\\")
284
+ .replace(/"/g, "\\\"")
285
+ .replace(/\n/g, "\\n")
286
+ .replace(/\r/g, "\\r")
287
+ .replace(/\t/g, "\\t")
288
+ .replace(/%/g, "%%");
289
+ }
290
+
291
+ /** WorkingDirectory uses path syntax rather than quoted Exec/Environment item syntax. */
292
+ function unitPathEscape(value: string): string {
293
+ return unitEscape(value).replace(/ /g, "\\x20");
294
+ }
295
+
296
+ function sourceTemplatePath(): string {
297
+ return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "systemd", "user", "agent-fleet-codex-remote-control.service.in");
298
+ }
299
+
300
+ export function renderUnit(input: LifecycleConfig, options: RenderOptions): string {
301
+ const config = validateConfig(input);
302
+ for (const [label, value] of Object.entries(options)) {
303
+ if (!path.isAbsolute(value)) fail(`${label} must be an absolute path`);
304
+ }
305
+ const template = fs.readFileSync(sourceTemplatePath(), "utf8");
306
+ const environment = remoteThreadEnv(config);
307
+ const values: Record<string, string> = {
308
+ "{{WORKING_DIRECTORY}}": unitPathEscape(conductorWorkspacePath(config.runtimeDir!)),
309
+ "{{NODE_BIN}}": unitEscape(options.nodeBin),
310
+ "{{SCRIPT_PATH}}": unitEscape(options.scriptPath),
311
+ "{{CONFIG_PATH}}": unitEscape(options.configPath),
312
+ "{{AGENT_FLEET_REPO_ROOT}}": unitEscape(environment.AGENT_FLEET_REPO_ROOT),
313
+ "{{PI_COMS_DIR}}": unitEscape(environment.PI_COMS_DIR),
314
+ "{{COMS_CLI_PROJECT}}": unitEscape(environment.COMS_CLI_PROJECT),
315
+ "{{COMS_CLI_NAME}}": unitEscape(environment.COMS_CLI_NAME),
316
+ "{{COMS_CLI_TIMEOUT_MS}}": unitEscape(environment.COMS_CLI_TIMEOUT_MS),
317
+ "{{AGENT_FLEET_CODEX_CONTRACT_PATH}}": unitEscape(environment.AGENT_FLEET_CODEX_CONTRACT_PATH),
318
+ "{{AGENT_FLEET_CODEX_CONTRACT_IDENTITY}}": unitEscape(environment.AGENT_FLEET_CODEX_CONTRACT_IDENTITY),
319
+ "{{AGENT_FLEET_CONDUCTOR_BACKEND}}": unitEscape(environment.AGENT_FLEET_CONDUCTOR_BACKEND),
320
+ };
321
+ return Object.entries(values).reduce((rendered, [token, value]) => rendered.replaceAll(token, value), template);
322
+ }
323
+
324
+ function writeAtomic(filePath: string, contents: string, mode: number): void {
325
+ fs.mkdirSync(path.dirname(filePath), { recursive: true, mode: 0o700 });
326
+ const temporary = path.join(path.dirname(filePath), `.${path.basename(filePath)}.${process.pid}.tmp`);
327
+ fs.writeFileSync(temporary, contents, { mode });
328
+ fs.chmodSync(temporary, mode);
329
+ fs.renameSync(temporary, filePath);
330
+ }
331
+
332
+ export function loadOwnedConfig(configPath: string): LifecycleConfig {
333
+ let parsed: unknown;
334
+ try {
335
+ parsed = JSON.parse(fs.readFileSync(configPath, "utf8"));
336
+ } catch {
337
+ fail(`Unable to read owned Codex lifecycle config: ${configPath}`);
338
+ }
339
+ return validateConfig(parsed as LifecycleConfig);
340
+ }
341
+
342
+ function unitOwned(unitPath: string): boolean {
343
+ try { return fs.readFileSync(unitPath, "utf8").startsWith(UNIT_MARKER); } catch { return false; }
344
+ }
345
+
346
+ function assertNoForeignFiles(paths: LifecyclePaths, reconfigure: boolean): void {
347
+ if (fs.existsSync(paths.configPath)) {
348
+ loadOwnedConfig(paths.configPath);
349
+ if (!reconfigure) fail(`Owned Codex lifecycle config already exists; use reconfigure instead of setup`);
350
+ }
351
+ if (fs.existsSync(paths.unitPath) && !unitOwned(paths.unitPath)) fail(`Refusing to replace unit not owned by agent-fleet: ${paths.unitPath}`);
352
+ }
353
+
354
+ export function setup(input: LifecycleConfig, run: CommandRunner = systemRunner, options: Partial<RenderOptions & { home: string; reconfigure: boolean }> = {}): LifecyclePaths {
355
+ const config = preflight(input, run);
356
+ const paths = lifecyclePaths(options.home);
357
+ assertNoForeignFiles(paths, options.reconfigure === true);
358
+ const nodeBin = options.nodeBin ?? process.execPath;
359
+ const scriptPath = options.scriptPath ?? path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "codex-remote-control.ts");
360
+ installWorkspaceContract(config);
361
+ writeAtomic(paths.configPath, `${JSON.stringify(config, null, "\t")}\n`, 0o600);
362
+ writeAtomic(paths.unitPath, renderUnit(config, { nodeBin, scriptPath, configPath: paths.configPath }), 0o644);
363
+ runOrFail(run, "systemctl", ["--user", "daemon-reload"]);
364
+ runOrFail(run, "systemctl", ["--user", "enable", UNIT_NAME]);
365
+ return paths;
366
+ }
367
+
368
+ export interface RequestedState { active: string; sub: string; }
369
+
370
+ export function requestedState(run: CommandRunner = systemRunner): RequestedState {
371
+ const output = runOrFail(run, "systemctl", ["--user", "show", UNIT_NAME, "--property=ActiveState", "--property=SubState"]).stdout;
372
+ const values = Object.fromEntries(output.split("\n").flatMap((line) => {
373
+ const index = line.indexOf("=");
374
+ return index < 0 ? [] : [[line.slice(0, index), line.slice(index + 1)]];
375
+ }));
376
+ return { active: values.ActiveState ?? "unknown", sub: values.SubState ?? "unknown" };
377
+ }
378
+
379
+ export function status(run: CommandRunner = systemRunner): string {
380
+ const state = requestedState(run);
381
+ return `requested systemd state: ${state.active} (${state.sub}); this is not daemon health`;
382
+ }
383
+
384
+ function resetFailed(run: CommandRunner): void {
385
+ runOrFail(run, "systemctl", ["--user", "reset-failed", UNIT_NAME]);
386
+ }
387
+
388
+ function stopFailedUnit(run: CommandRunner): void {
389
+ runOrFail(run, "systemctl", ["--user", "stop", UNIT_NAME]);
390
+ resetFailed(run);
391
+ }
392
+
393
+ export function start(input: LifecycleConfig, run: CommandRunner = systemRunner): "started" | "already-active" {
394
+ preflight(input, run);
395
+ const state = requestedState(run);
396
+ if (state.active === "active" && state.sub === "exited") return "already-active";
397
+ if (state.active === "failed") {
398
+ fail(`Refusing start from requested systemd state ${state.active} (${state.sub}); run recover or uninstall with operator confirmation`);
399
+ }
400
+ if (state.active !== "inactive" || state.sub !== "dead") fail(`Refusing start from requested systemd state ${state.active} (${state.sub})`);
401
+ runOrFail(run, "systemctl", ["--user", "start", UNIT_NAME]);
402
+ return "started";
403
+ }
404
+
405
+ export function stop(input: LifecycleConfig, run: CommandRunner = systemRunner): "stopped" | "already-inactive" {
406
+ preflight(input, run);
407
+ const state = requestedState(run);
408
+ if (state.active === "inactive" && state.sub === "dead") return "already-inactive";
409
+ if (state.active === "failed") {
410
+ stopFailedUnit(run);
411
+ return "stopped";
412
+ }
413
+ if (state.active !== "active" || state.sub !== "exited") fail(`Refusing stop from requested systemd state ${state.active} (${state.sub})`);
414
+ runOrFail(run, "systemctl", ["--user", "stop", UNIT_NAME]);
415
+ return "stopped";
416
+ }
417
+
418
+ /** Operator-facing drift exception: systemd remains the sole service owner. */
419
+ export function emergencySystemdStop(input: LifecycleConfig, run: CommandRunner = systemRunner, confirmation?: string): "stopped" | "already-inactive" {
420
+ verifyEmergencyStopCapability(input, run, confirmation);
421
+ const state = requestedState(run);
422
+ if (state.active === "inactive" && state.sub === "dead") return "already-inactive";
423
+ if (state.active === "failed") {
424
+ stopFailedUnit(run);
425
+ return "stopped";
426
+ }
427
+ if (state.active !== "active" || state.sub !== "exited") fail(`Refusing emergency stop from requested systemd state ${state.active} (${state.sub})`);
428
+ runOrFail(run, "systemctl", ["--user", "stop", UNIT_NAME]);
429
+ return "stopped";
430
+ }
431
+
432
+ export function restart(input: LifecycleConfig, run: CommandRunner = systemRunner, confirmation?: string): "restarted" {
433
+ if (confirmation !== RECOVERY_CONFIRMATION) fail("Recovery requires explicit operator confirmation");
434
+ const config = preflight(input, run);
435
+ const state = requestedState(run);
436
+ if (state.active === "active" && state.sub === "exited") {
437
+ runOrFail(run, "systemctl", ["--user", "stop", UNIT_NAME]);
438
+ } else if (state.active === "failed") {
439
+ stopFailedUnit(run);
440
+ } else {
441
+ fail(`Refusing recovery from requested systemd state ${state.active} (${state.sub})`);
442
+ }
443
+ // Test runners are synchronous mocks; only the real lifecycle needs the
444
+ // bounded teardown interval observed on the authorized host.
445
+ if (run === systemRunner) Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, RESTART_SETTLE_MS);
446
+ preflight(config, run);
447
+ runOrFail(run, "systemctl", ["--user", "start", UNIT_NAME]);
448
+ return "restarted";
449
+ }
450
+
451
+ export function uninstall(paths: LifecyclePaths, run: CommandRunner = systemRunner, options: { confirmation?: string; emergencyConfirmation?: string } = {}): void {
452
+ if (options.confirmation !== RECOVERY_CONFIRMATION) fail("Uninstall requires explicit operator confirmation");
453
+ if (!unitOwned(paths.unitPath)) fail(`Refusing to remove unit not owned by agent-fleet: ${paths.unitPath}`);
454
+ const config = loadOwnedConfig(paths.configPath);
455
+ try {
456
+ preflight(config, run);
457
+ } catch (error) {
458
+ if (options.emergencyConfirmation !== EMERGENCY_STOP_CONFIRMATION) throw error;
459
+ // Drift-safe removal is allowed only after the exact current stop command is proved.
460
+ verifyEmergencyStopCapability(config, run, options.emergencyConfirmation);
461
+ }
462
+ const state = requestedState(run);
463
+ if (state.active === "active" && state.sub === "exited") runOrFail(run, "systemctl", ["--user", "stop", UNIT_NAME]);
464
+ else if (state.active === "failed") runOrFail(run, "systemctl", ["--user", "stop", UNIT_NAME]);
465
+ else if (state.active !== "inactive" || state.sub !== "dead") fail(`Refusing uninstall from requested systemd state ${state.active} (${state.sub})`);
466
+ // Clear the manager's loaded state while the owned unit still exists. After
467
+ // unlink + daemon-reload, reset-failed correctly returns "unit not loaded".
468
+ resetFailed(run);
469
+ runOrFail(run, "systemctl", ["--user", "disable", UNIT_NAME]);
470
+ fs.unlinkSync(paths.unitPath);
471
+ fs.unlinkSync(paths.configPath);
472
+ runOrFail(run, "systemctl", ["--user", "daemon-reload"]);
473
+ const workspacePath = conductorWorkspacePath(config.runtimeDir!);
474
+ const workspaceContract = path.join(workspacePath, "AGENTS.md");
475
+ try {
476
+ if (fs.readFileSync(workspaceContract, "utf8").startsWith(WORKSPACE_CONTRACT_MARKER)) fs.unlinkSync(workspaceContract);
477
+ } catch { /* absent or operator-owned: retain it */ }
478
+ try { fs.rmdirSync(workspacePath); } catch { /* retain non-empty scratch data */ }
479
+ try { fs.rmdirSync(config.runtimeDir!); } catch { /* retain non-empty runtime data */ }
480
+ }