@chankov/agent-fleet 2.0.2 → 2.0.3
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.
- package/.pi/harnesses/agent-hub/README.md +26 -31
- package/.pi/harnesses/agent-hub/commands/agents-restart.ts +1 -1
- package/.pi/harnesses/agent-hub/config/overrides.ts +2 -7
- package/.pi/harnesses/agent-hub/index.ts +14 -25
- package/.pi/harnesses/agent-hub/input/completions.ts +2 -2
- package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +0 -2
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/prompts/session-start.ts +1 -1
- package/.pi/harnesses/agent-hub/research/controls.ts +15 -16
- package/.pi/harnesses/agent-hub/research/runtime.ts +30 -39
- package/.pi/harnesses/agent-hub/research/spawn-run.ts +108 -111
- package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +2 -3
- package/.pi/harnesses/agent-hub/ui/detail-panel.ts +3 -3
- package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +0 -7
- package/.pi/harnesses/agent-hub/ui/grid.ts +21 -183
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/fleet-dashboard-ops.ts +23 -12
- package/.versions/2.0.3/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.3/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/2.0.3/.pi/agents/peers.yaml +142 -0
- package/.versions/2.0.3/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.3/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.3/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.3/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/2.0.3/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/2.0.3/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/2.0.3/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.3/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.3/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.3/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.3/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.3/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.3/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.3/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.3/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.3/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.3/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.3/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.3/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.3/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.3/.pi/extensions/package.json +9 -0
- package/.versions/2.0.3/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/2.0.3/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.3/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.3/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.3/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.3/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.3/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/README.md +1158 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/context.ts +41 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/config/agents.ts +180 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/delegate.ts +446 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/fixtures/registration-surface.json +55 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/index.ts +2036 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +141 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/policy/models.ts +126 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/research/runtime.ts +175 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/research/spawn-run.ts +143 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/spawn.ts +388 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/context.ts +132 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +199 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/types.ts +61 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +123 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/grid.ts +144 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.3/.pi/harnesses/agent-hub/work-mode.ts +167 -0
- package/.versions/2.0.3/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/2.0.3/.pi/harnesses/ask-user-remote/index.ts +532 -0
- package/.versions/2.0.3/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/2.0.3/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.3/.pi/harnesses/coms/index.ts +276 -0
- package/.versions/2.0.3/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.3/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.3/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/2.0.3/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/2.0.3/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.3/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.3/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.3/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.3/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.3/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
- package/.versions/2.0.3/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.3/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.3/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.3/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fleet-dashboard-ops.ts +166 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.3/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.3/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.3/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.3/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.3/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/2.0.3/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.3/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.3/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.3/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.3/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.3/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.3/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.3/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.3/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.3/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.3/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.3/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.3/.version +1 -0
- package/.versions/2.0.3/agents/architect.md +25 -0
- package/.versions/2.0.3/agents/bowser.md +28 -0
- package/.versions/2.0.3/agents/builder.md +56 -0
- package/.versions/2.0.3/agents/code-reviewer.md +210 -0
- package/.versions/2.0.3/agents/deep-researcher.md +33 -0
- package/.versions/2.0.3/agents/documenter.md +22 -0
- package/.versions/2.0.3/agents/orchestrator.md +23 -0
- package/.versions/2.0.3/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.3/agents/planner.md +105 -0
- package/.versions/2.0.3/agents/releaser.md +25 -0
- package/.versions/2.0.3/agents/researcher.md +31 -0
- package/.versions/2.0.3/agents/security-auditor.md +168 -0
- package/.versions/2.0.3/agents/test-engineer.md +154 -0
- package/.versions/2.0.3/agents/web-debugger.md +44 -0
- package/.versions/2.0.3/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.3/bin/catalog/harness-runtime-closure.json +34 -0
- package/.versions/2.0.3/codex/CONDUCTOR.md +148 -0
- package/.versions/2.0.3/docs/ARCHITECTURE.md +407 -0
- package/.versions/2.0.3/docs/agent-fleet-setup.md +473 -0
- package/.versions/2.0.3/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/2.0.3/docs/codex-remote-conductor.md +170 -0
- package/.versions/2.0.3/docs/coms-hermes-bridge.md +189 -0
- package/.versions/2.0.3/docs/getting-started.md +119 -0
- package/.versions/2.0.3/docs/npm-install.md +292 -0
- package/.versions/2.0.3/docs/pi-extensions.md +447 -0
- package/.versions/2.0.3/docs/pi-setup.md +74 -0
- package/.versions/2.0.3/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.3/hermes/README.md +347 -0
- package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.3/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.3/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.3/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.3/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.3/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.3/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.3/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.3/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.3/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.3/install-manifest.json +2940 -0
- package/.versions/2.0.3/justfile +289 -0
- package/.versions/2.0.3/manifest-meta.json +969 -0
- package/.versions/2.0.3/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.3/references/communication-contract.md +26 -0
- package/.versions/2.0.3/references/definition-of-done.md +67 -0
- package/.versions/2.0.3/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.3/references/observability-checklist.md +91 -0
- package/.versions/2.0.3/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.3/references/performance-checklist.md +153 -0
- package/.versions/2.0.3/references/prompting-patterns.md +380 -0
- package/.versions/2.0.3/references/security-checklist.md +179 -0
- package/.versions/2.0.3/references/testing-patterns.md +236 -0
- package/.versions/2.0.3/references/workflow-authoring.md +304 -0
- package/.versions/2.0.3/scripts/codex-conductor.ts +41 -0
- package/.versions/2.0.3/scripts/codex-remote-control.ts +167 -0
- package/.versions/2.0.3/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.3/scripts/coms-cli.ts +484 -0
- package/.versions/2.0.3/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.3/scripts/fleet.ts +199 -0
- package/.versions/2.0.3/scripts/flow.ts +137 -0
- package/.versions/2.0.3/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.3/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.3/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.3/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.3/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.3/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/2.0.3/scripts/lib/codex-remote-control.ts +482 -0
- package/.versions/2.0.3/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.3/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.3/scripts/lib/fleet-command.ts +270 -0
- package/.versions/2.0.3/scripts/lib/flow-command.ts +93 -0
- package/.versions/2.0.3/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.3/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.3/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.3/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.3/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.3/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.3/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.3/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.3/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.3/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.3/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.3/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.3/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.3/scripts/lib/team-project.ts +213 -0
- package/.versions/2.0.3/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.3/scripts/package-lock.json +35 -0
- package/.versions/2.0.3/scripts/package.json +9 -0
- package/.versions/2.0.3/scripts/peer-banner.ts +40 -0
- package/.versions/2.0.3/scripts/peer-launch.ts +259 -0
- package/.versions/2.0.3/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.3/scripts/team-up.ts +406 -0
- package/.versions/2.0.3/scripts/workflows/lib/agent-phase.ts +132 -0
- package/.versions/2.0.3/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.3/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.3/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.3/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.3/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.3/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.3/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.3/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.3/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.3/scripts/workflows/lib/personas.ts +54 -0
- package/.versions/2.0.3/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.3/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.3/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.3/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.3/scripts/workflows/lib/voices.ts +125 -0
- package/.versions/2.0.3/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.3/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.3/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.3/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.3/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.3/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.3/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.3/scripts/workflows/wf-scout.ts +38 -0
- package/.versions/2.0.3/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.3/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.3/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/2.0.3/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.3/skills/context-engineering/SKILL.md +291 -0
- package/.versions/2.0.3/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/2.0.3/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.3/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.3/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.3/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.3/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.3/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.3/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.3/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.3/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.3/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.3/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.3/skills/incremental-implementation/SKILL.md +298 -0
- package/.versions/2.0.3/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.3/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/2.0.3/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.3/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.3/skills/planning-and-task-breakdown/SKILL.md +265 -0
- package/.versions/2.0.3/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/2.0.3/skills/spec-driven-development/SKILL.md +256 -0
- package/.versions/2.0.3/skills/using-agent-skills/SKILL.md +197 -0
- package/.versions/2.0.3/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/2.0.3/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +7 -0
- package/README.md +2 -2
- package/bin/lib/doctor.js +1 -1
- package/bin/lib/model-visibility.js +64 -0
- package/docs/agent-fleet-setup.md +1 -1
- package/docs/getting-started.md +2 -2
- package/docs/npm-install.md +1 -1
- package/docs/pi-extensions.md +13 -10
- package/install-manifest.json +36 -1
- package/justfile +1 -0
- package/manifest-meta.json +25 -1
- package/package.json +4 -2
- package/scripts/fleet.ts +1 -1
- package/scripts/package-lock.json +35 -0
- package/scripts/package.json +9 -0
- package/.pi/harnesses/agent-hub/research-retention.js +0 -34
|
@@ -0,0 +1,259 @@
|
|
|
1
|
+
// scripts/peer-launch.ts
|
|
2
|
+
//
|
|
3
|
+
// `just fleet peer <name>` — launch ONE coms peer (pi persona, personaless
|
|
4
|
+
// Fleet Core pi, or Claude Code) without declaring it in a peers.yaml team.
|
|
5
|
+
//
|
|
6
|
+
// Placement:
|
|
7
|
+
// • default, inside a herdr pane (HERDR_ENV=1) → split THIS pane, so the peer
|
|
8
|
+
// lands next to the session that asked for it;
|
|
9
|
+
// • default, outside herdr → create a single-pane workspace labelled
|
|
10
|
+
// <worktree-tag>-peer-<name>, refusing to clobber an existing one;
|
|
11
|
+
// • --here → run in the CALLING terminal, which is what this command did
|
|
12
|
+
// before pane placement existed.
|
|
13
|
+
//
|
|
14
|
+
// Hard rules (same as team-up.ts, for the same reasons):
|
|
15
|
+
// - Entrypoint guard: importing this module must NOT spawn anything.
|
|
16
|
+
// - peers.yaml + the repo root resolve relative to THIS file, not the caller's cwd.
|
|
17
|
+
// - --dry-run prints the plan and exits WITHOUT touching herdr, and never reads
|
|
18
|
+
// env_file values — secrets stay out of terminals and logs.
|
|
19
|
+
// - A split pane gets its argv TYPED at the shell prompt: herdr's pane.split
|
|
20
|
+
// takes no command and silently ignores one (see spawned-peers.js).
|
|
21
|
+
|
|
22
|
+
import { spawnSync } from "node:child_process";
|
|
23
|
+
import * as fs from "node:fs";
|
|
24
|
+
import * as path from "node:path";
|
|
25
|
+
import { fileURLToPath } from "node:url";
|
|
26
|
+
|
|
27
|
+
import { launchPeerInPane, PANE_PROMPT_TIMEOUT_MS, PEER_READY_TIMEOUT_MS, peerReadyDelayMs } from "../.pi/harnesses/lib/spawned-peers.js";
|
|
28
|
+
import { pruneDeadEntries } from "./lib/coms-envelope.ts";
|
|
29
|
+
import { parseEnvFile, resolveEnvFilePath, type LayoutNode } from "./lib/herdr-layout.ts";
|
|
30
|
+
import { buildPeerLaunchPlan, parsePeerArgs, type PeerLaunchPlan } from "./lib/peer-launch.ts";
|
|
31
|
+
import { worktreeTag } from "./lib/team-project.ts";
|
|
32
|
+
|
|
33
|
+
const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
|
|
34
|
+
const REPO_ROOT = fs.realpathSync(path.resolve(SCRIPT_DIR, ".."));
|
|
35
|
+
const PEERS_YAML = path.join(REPO_ROOT, ".pi", "agents", "peers.yaml");
|
|
36
|
+
|
|
37
|
+
const USAGE =
|
|
38
|
+
"usage: just fleet peer <name> [--runner pi|claude-code] [--persona <p>] [--model <m>] [--project <p>]\n" +
|
|
39
|
+
" [--extensions a,b] [--browser] [--all-extensions]\n" +
|
|
40
|
+
" [--direction right|down] [--here] [--dry-run] [-- PI_ARGS…]";
|
|
41
|
+
|
|
42
|
+
function die(msg: string): never {
|
|
43
|
+
console.error(msg);
|
|
44
|
+
process.exit(1);
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
function personaExists(persona: string): boolean {
|
|
48
|
+
return (
|
|
49
|
+
fs.existsSync(path.join(REPO_ROOT, "agents", `${persona}.md`)) ||
|
|
50
|
+
fs.existsSync(path.join(REPO_ROOT, ".pi", "agents", `${persona}.md`))
|
|
51
|
+
);
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
function readIfPresent(file: string): string {
|
|
55
|
+
try {
|
|
56
|
+
return fs.readFileSync(file, "utf-8");
|
|
57
|
+
} catch {
|
|
58
|
+
return "";
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
/** The pane's extra env: only the declaration's env_file, never on the dry-run path. */
|
|
63
|
+
function paneEnv(plan: PeerLaunchPlan): Record<string, string> {
|
|
64
|
+
if (!plan.envFile) return {};
|
|
65
|
+
const abs = resolveEnvFilePath(plan.envFile, REPO_ROOT);
|
|
66
|
+
if (!fs.existsSync(abs)) die(`Peer "${plan.name}": env_file not found: ${plan.envFile} (resolved: ${abs})`);
|
|
67
|
+
return parseEnvFile(fs.readFileSync(abs, "utf-8"), plan.envFile);
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
/** Poll the coms registry until the peer registers, or the budget runs out. */
|
|
71
|
+
async function waitForRegistration(plan: PeerLaunchPlan): Promise<{ found: boolean; waitedMs: number }> {
|
|
72
|
+
const wanted = plan.name.toLowerCase();
|
|
73
|
+
const started = Date.now();
|
|
74
|
+
for (let attempt = 0; ; attempt++) {
|
|
75
|
+
let live: { name: string }[] = [];
|
|
76
|
+
try {
|
|
77
|
+
live = pruneDeadEntries(plan.project);
|
|
78
|
+
} catch {
|
|
79
|
+
// Registry not readable yet; the timeout below bounds the wait.
|
|
80
|
+
}
|
|
81
|
+
if (live.some((entry) => entry.name.toLowerCase() === wanted)) {
|
|
82
|
+
return { found: true, waitedMs: Date.now() - started };
|
|
83
|
+
}
|
|
84
|
+
const remaining = PEER_READY_TIMEOUT_MS - (Date.now() - started);
|
|
85
|
+
if (remaining <= 0) return { found: false, waitedMs: Date.now() - started };
|
|
86
|
+
await new Promise((r) => setTimeout(r, Math.min(peerReadyDelayMs(attempt), remaining)));
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
async function main(): Promise<void> {
|
|
91
|
+
let args;
|
|
92
|
+
try {
|
|
93
|
+
args = parsePeerArgs(process.argv.slice(2));
|
|
94
|
+
} catch (err) {
|
|
95
|
+
console.error(`fleet peer: ${err instanceof Error ? err.message : String(err)}`);
|
|
96
|
+
console.error(USAGE);
|
|
97
|
+
process.exit(2);
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
let plan: PeerLaunchPlan;
|
|
101
|
+
try {
|
|
102
|
+
plan = buildPeerLaunchPlan(args, {
|
|
103
|
+
peersYaml: readIfPresent(args.peersYaml ?? PEERS_YAML),
|
|
104
|
+
personaExists,
|
|
105
|
+
worktreeTag: worktreeTag(REPO_ROOT),
|
|
106
|
+
});
|
|
107
|
+
} catch (err) {
|
|
108
|
+
die(`fleet peer: ${err instanceof Error ? err.message : String(err)}`);
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
const inPane = process.env.HERDR_ENV === "1" ? process.env.HERDR_PANE_ID || null : null;
|
|
112
|
+
|
|
113
|
+
if (args.dryRun) {
|
|
114
|
+
// No herdr calls and no env_file reads on this path.
|
|
115
|
+
const placement =
|
|
116
|
+
plan.placement === "here"
|
|
117
|
+
? "this terminal"
|
|
118
|
+
: inPane
|
|
119
|
+
? `split of pane ${inPane} (${plan.direction})`
|
|
120
|
+
: `new workspace "${plan.workspaceLabel}"`;
|
|
121
|
+
const envNote = plan.envFile ? ` [env_file: ${plan.envFile} — values redacted]` : "";
|
|
122
|
+
const source = plan.declared ? "peers.yaml declaration + flags" : "flags only";
|
|
123
|
+
console.log(`# fleet peer (dry run) — "${plan.name}" [${plan.kind}], project "${plan.project}", ${source}`);
|
|
124
|
+
console.log(`# placement: ${placement}`);
|
|
125
|
+
console.log(`${plan.name}\t${plan.command.join(" ")}${envNote}`);
|
|
126
|
+
console.log(JSON.stringify(plan, null, 2));
|
|
127
|
+
return;
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
// --here: become the peer in this terminal. The env_file is applied to our
|
|
131
|
+
// own child rather than to a pane, and there is nothing to wait for — the
|
|
132
|
+
// peer is the foreground process.
|
|
133
|
+
if (plan.placement === "here") {
|
|
134
|
+
const [bin, ...rest] = plan.command;
|
|
135
|
+
const result = spawnSync(bin, rest, {
|
|
136
|
+
stdio: "inherit",
|
|
137
|
+
cwd: REPO_ROOT,
|
|
138
|
+
env: { ...process.env, ...paneEnv(plan) },
|
|
139
|
+
});
|
|
140
|
+
if (result.error) die(`fleet peer: could not run ${bin}: ${result.error.message}`);
|
|
141
|
+
process.exitCode = result.status ?? 1;
|
|
142
|
+
return;
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
const env = paneEnv(plan);
|
|
146
|
+
|
|
147
|
+
// Import lazily so --dry-run and --here never touch the client (or the socket).
|
|
148
|
+
const { herdr, requireHerdr, HerdrUnavailableError } = await import("../.pi/harnesses/lib/herdr-client.ts");
|
|
149
|
+
try {
|
|
150
|
+
await requireHerdr();
|
|
151
|
+
} catch (err) {
|
|
152
|
+
if (err instanceof HerdrUnavailableError) {
|
|
153
|
+
console.error(err.message);
|
|
154
|
+
console.error(`(no herdr? run it in this terminal instead: just fleet peer ${plan.name} --here)`);
|
|
155
|
+
process.exit(1);
|
|
156
|
+
}
|
|
157
|
+
throw err;
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
let paneId: string;
|
|
161
|
+
if (inPane) {
|
|
162
|
+
const { pane } = await herdr.paneSplit({
|
|
163
|
+
target_pane_id: inPane,
|
|
164
|
+
direction: plan.direction,
|
|
165
|
+
cwd: REPO_ROOT,
|
|
166
|
+
...(Object.keys(env).length > 0 ? { env } : {}),
|
|
167
|
+
focus: false,
|
|
168
|
+
});
|
|
169
|
+
paneId = pane.pane_id;
|
|
170
|
+
try {
|
|
171
|
+
await herdr.paneRename(paneId, plan.name);
|
|
172
|
+
} catch {
|
|
173
|
+
// non-fatal: an unlabelled pane is cosmetic
|
|
174
|
+
}
|
|
175
|
+
// pane.split opens a bare shell — the argv has to be typed into it.
|
|
176
|
+
const launch = await launchPeerInPane(herdr, paneId, plan.command);
|
|
177
|
+
if (!launch.promptSeen) {
|
|
178
|
+
console.error(`⚠ pane ${paneId} showed no shell prompt within ${Math.round(PANE_PROMPT_TIMEOUT_MS / 1000)}s; the command was sent anyway.`);
|
|
179
|
+
}
|
|
180
|
+
console.log(`Launched ${plan.name} [${plan.kind}] in pane ${paneId}: ${plan.command.join(" ")}`);
|
|
181
|
+
} else {
|
|
182
|
+
const { workspaces } = await herdr.workspaceList();
|
|
183
|
+
const existing = workspaces.find((w) => w.label === plan.workspaceLabel);
|
|
184
|
+
if (existing) {
|
|
185
|
+
console.error(`herdr workspace "${plan.workspaceLabel}" already exists (${existing.workspace_id}).`);
|
|
186
|
+
console.error(` focus: herdr workspace focus ${existing.workspace_id}`);
|
|
187
|
+
console.error(` close: herdr workspace close ${existing.workspace_id}`);
|
|
188
|
+
process.exit(1);
|
|
189
|
+
}
|
|
190
|
+
const created = await herdr.workspaceCreate({ label: plan.workspaceLabel, cwd: REPO_ROOT, focus: false });
|
|
191
|
+
const wsId = created.workspace.workspace_id;
|
|
192
|
+
const initialTab = created.workspace.active_tab_id ?? created.tab?.tab_id;
|
|
193
|
+
// layout.apply pane nodes DO carry an argv, so no prompt-typing here.
|
|
194
|
+
const root: LayoutNode = {
|
|
195
|
+
type: "pane",
|
|
196
|
+
command: plan.command,
|
|
197
|
+
cwd: REPO_ROOT,
|
|
198
|
+
label: plan.name,
|
|
199
|
+
...(Object.keys(env).length > 0 ? { env } : {}),
|
|
200
|
+
};
|
|
201
|
+
await herdr.layoutApply({ workspace_id: wsId, root });
|
|
202
|
+
if (initialTab) {
|
|
203
|
+
try {
|
|
204
|
+
await herdr.tabClose(initialTab);
|
|
205
|
+
} catch {
|
|
206
|
+
// non-fatal: an extra empty tab is cosmetic
|
|
207
|
+
}
|
|
208
|
+
}
|
|
209
|
+
// layout.apply assigns the pane id; resolve it by label so the readiness
|
|
210
|
+
// report can quote the pane's own output when the peer never registers.
|
|
211
|
+
paneId = await paneIdByLabel(herdr, wsId, plan.name);
|
|
212
|
+
console.log(`Launched ${plan.name} [${plan.kind}] in herdr workspace "${plan.workspaceLabel}" (${wsId}): ${plan.command.join(" ")}`);
|
|
213
|
+
console.log(`Focus: herdr workspace focus ${wsId}`);
|
|
214
|
+
console.log(`Close: herdr workspace close ${wsId}`);
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
// A peer that never registers is a FAILED start, not a slow one — say so
|
|
218
|
+
// rather than leaving the caller to guess from a pane id.
|
|
219
|
+
const { found, waitedMs } = await waitForRegistration(plan);
|
|
220
|
+
if (found) {
|
|
221
|
+
console.log(
|
|
222
|
+
`Peer "${plan.name}" is ready in pane ${paneId} after ${Math.round(waitedMs / 1000)}s — ` +
|
|
223
|
+
`address it with: node --experimental-strip-types scripts/coms-cli.ts send ${plan.name} "…" --project ${plan.project} --name <you>\n` +
|
|
224
|
+
"It boots idle and does no work until you send.",
|
|
225
|
+
);
|
|
226
|
+
return;
|
|
227
|
+
}
|
|
228
|
+
const tail = (await paneTail(herdr, paneId)).trim();
|
|
229
|
+
console.error(
|
|
230
|
+
`Peer "${plan.name}" did not register in the coms pool within ${Math.round(PEER_READY_TIMEOUT_MS / 1000)}s — ` +
|
|
231
|
+
"assume it failed to start rather than that it is slow. Do not send to it." +
|
|
232
|
+
(tail ? `\n\nLast output of pane ${paneId}:\n${tail}` : ""),
|
|
233
|
+
);
|
|
234
|
+
process.exitCode = 1;
|
|
235
|
+
}
|
|
236
|
+
|
|
237
|
+
/** Pane id of the pane labelled `label` in a workspace; "?" when unresolvable. */
|
|
238
|
+
async function paneIdByLabel(client: { paneList(p: { workspace_id?: string }): Promise<{ panes: { pane_id: string; label?: string }[] }> }, workspaceId: string, label: string): Promise<string> {
|
|
239
|
+
try {
|
|
240
|
+
const { panes } = await client.paneList({ workspace_id: workspaceId });
|
|
241
|
+
return panes.find((p) => p.label === label)?.pane_id ?? panes[0]?.pane_id ?? "?";
|
|
242
|
+
} catch {
|
|
243
|
+
return "?";
|
|
244
|
+
}
|
|
245
|
+
}
|
|
246
|
+
|
|
247
|
+
/** Last lines of a pane, for reporting why a launch failed. Never throws. */
|
|
248
|
+
async function paneTail(client: { paneRead(p: { pane_id: string; lines: number }): Promise<{ read: { text?: string } }> }, paneId: string, lines = 12): Promise<string> {
|
|
249
|
+
if (paneId === "?") return "";
|
|
250
|
+
try {
|
|
251
|
+
const { read } = await client.paneRead({ pane_id: paneId, lines });
|
|
252
|
+
return read?.text ?? "";
|
|
253
|
+
} catch {
|
|
254
|
+
return "";
|
|
255
|
+
}
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
const isEntry = process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
|
|
259
|
+
if (isEntry) void main();
|
|
@@ -0,0 +1,237 @@
|
|
|
1
|
+
// scripts/team-snapshot.ts
|
|
2
|
+
//
|
|
3
|
+
// Fleet resume (B5): snapshot / tear down / rebuild a running peer team.
|
|
4
|
+
// Backs `just fleet snapshot`, `just fleet down`, and `just fleet resume`. herdr is a hard dependency (requireHerdr refuses readably).
|
|
5
|
+
//
|
|
6
|
+
// snapshot <team> — capture peers + per-peer session refs to
|
|
7
|
+
// ~/.pi/team-snapshots/<team>.json (team keeps running)
|
|
8
|
+
// down <team> — snapshot, then workspace.close (peers get SIGTERM →
|
|
9
|
+
// coms clean shutdown removes their registry entries)
|
|
10
|
+
// resume <team> — rebuild the workspace from the snapshot; every pi peer
|
|
11
|
+
// relaunches with `--session <ref>` and continues its
|
|
12
|
+
// conversation; peers whose ref is gone start fresh with
|
|
13
|
+
// a warning
|
|
14
|
+
//
|
|
15
|
+
// Snapshots live OUTSIDE the repo (~/.pi/team-snapshots/) because
|
|
16
|
+
// .pi/agent-sessions/ is wiped at hub session start. Pure logic in
|
|
17
|
+
// scripts/lib/team-snapshot.ts; entrypoint-guarded like team-up.
|
|
18
|
+
|
|
19
|
+
import * as fs from "node:fs";
|
|
20
|
+
import * as os from "node:os";
|
|
21
|
+
import * as path from "node:path";
|
|
22
|
+
import { fileURLToPath } from "node:url";
|
|
23
|
+
|
|
24
|
+
import { buildTeamLayout, parsePeersYaml, type Peer } from "./lib/herdr-layout.ts";
|
|
25
|
+
import { planSpawnDelays } from "./lib/spawn-stagger.ts";
|
|
26
|
+
import { DEFAULT_PROJECT, hubCommand, parseProjectFlag, teamSnapshotPath, teamWorkspaceLabel, validateTeamName, worktreeTag } from "./lib/team-project.ts";
|
|
27
|
+
import {
|
|
28
|
+
assertSnapshotProject,
|
|
29
|
+
buildSnapshot,
|
|
30
|
+
parseSnapshot,
|
|
31
|
+
resumeRefForPeer,
|
|
32
|
+
type PeerSnapshot,
|
|
33
|
+
type TeamSnapshot,
|
|
34
|
+
} from "./lib/team-snapshot.ts";
|
|
35
|
+
|
|
36
|
+
const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
|
|
37
|
+
const REPO_ROOT = path.resolve(SCRIPT_DIR, "..");
|
|
38
|
+
// Must match team-up's tag so down/resume target the workspace it created.
|
|
39
|
+
const WORKTREE_TAG = worktreeTag(REPO_ROOT);
|
|
40
|
+
const PEERS_YAML = path.join(REPO_ROOT, ".pi", "agents", "peers.yaml");
|
|
41
|
+
const SNAPSHOT_DIR = path.join(os.homedir(), ".pi", "team-snapshots");
|
|
42
|
+
|
|
43
|
+
function die(msg: string): never {
|
|
44
|
+
console.error(msg);
|
|
45
|
+
process.exit(1);
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
function snapshotPath(team: string, project = DEFAULT_PROJECT): string {
|
|
49
|
+
try {
|
|
50
|
+
return teamSnapshotPath(SNAPSHOT_DIR, team, project);
|
|
51
|
+
} catch (err) {
|
|
52
|
+
die(err instanceof Error ? err.message : String(err));
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
async function requireClient() {
|
|
57
|
+
const client = await import("../.pi/harnesses/lib/herdr-client.ts");
|
|
58
|
+
try {
|
|
59
|
+
await client.requireHerdr();
|
|
60
|
+
} catch (err) {
|
|
61
|
+
if (err instanceof client.HerdrUnavailableError) die(err.message);
|
|
62
|
+
throw err;
|
|
63
|
+
}
|
|
64
|
+
return client;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
type Client = Awaited<ReturnType<typeof requireClient>>;
|
|
68
|
+
|
|
69
|
+
async function findTeamWorkspace(client: Client, team: string, project = DEFAULT_PROJECT) {
|
|
70
|
+
let peersLabel: string;
|
|
71
|
+
let hubLabel: string;
|
|
72
|
+
try {
|
|
73
|
+
peersLabel = teamWorkspaceLabel("peers", team, project, WORKTREE_TAG);
|
|
74
|
+
hubLabel = teamWorkspaceLabel("hub", team, project, WORKTREE_TAG);
|
|
75
|
+
} catch (err) {
|
|
76
|
+
die(err instanceof Error ? err.message : String(err));
|
|
77
|
+
}
|
|
78
|
+
const { workspaces } = await client.herdr.workspaceList();
|
|
79
|
+
return workspaces.find((w) => w.label === peersLabel) ?? workspaces.find((w) => w.label === hubLabel) ?? null;
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
async function captureSnapshot(client: Client, team: string, project = DEFAULT_PROJECT): Promise<TeamSnapshot> {
|
|
83
|
+
const peersLabel = teamWorkspaceLabel("peers", team, project, WORKTREE_TAG);
|
|
84
|
+
const hubLabel = teamWorkspaceLabel("hub", team, project, WORKTREE_TAG);
|
|
85
|
+
const ws = await findTeamWorkspace(client, team, project);
|
|
86
|
+
if (!ws) {
|
|
87
|
+
const projectArgs = project === DEFAULT_PROJECT ? "" : ` --project ${project}`;
|
|
88
|
+
die(
|
|
89
|
+
`No running workspace "${peersLabel}" or "${hubLabel}" found.\n` +
|
|
90
|
+
`Start one with: just fleet team ${team}${projectArgs} (or add --no-hub for peers only)`,
|
|
91
|
+
);
|
|
92
|
+
}
|
|
93
|
+
if (!fs.existsSync(PEERS_YAML)) die(`peers.yaml not found at ${PEERS_YAML}`);
|
|
94
|
+
const teams = parsePeersYaml(fs.readFileSync(PEERS_YAML, "utf-8"));
|
|
95
|
+
const peers = teams[team];
|
|
96
|
+
if (!peers) die(`Team "${team}" not found in peers.yaml.`);
|
|
97
|
+
|
|
98
|
+
const { panes } = await client.herdr.paneList({ workspace_id: ws.workspace_id });
|
|
99
|
+
const { agents } = await client.herdr.agentList();
|
|
100
|
+
const inWorkspace = agents.filter((a) => (a as { workspace_id?: string }).workspace_id === ws.workspace_id);
|
|
101
|
+
|
|
102
|
+
const snap = buildSnapshot({
|
|
103
|
+
team,
|
|
104
|
+
project,
|
|
105
|
+
hub: ws.label === hubLabel,
|
|
106
|
+
peers,
|
|
107
|
+
panes,
|
|
108
|
+
agents: inWorkspace as Parameters<typeof buildSnapshot>[0]["agents"],
|
|
109
|
+
tag: WORKTREE_TAG,
|
|
110
|
+
});
|
|
111
|
+
const file = snapshotPath(team, project);
|
|
112
|
+
fs.mkdirSync(path.dirname(file), { recursive: true });
|
|
113
|
+
fs.writeFileSync(file, JSON.stringify(snap, null, 2) + "\n");
|
|
114
|
+
const withRef = snap.peers.filter((p) => p.resume).length;
|
|
115
|
+
console.log(`Snapshot: ${file} — ${snap.peers.length} peer(s), ${withRef} with a session ref.`);
|
|
116
|
+
return snap;
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
async function cmdSnapshot(team: string, project = DEFAULT_PROJECT): Promise<void> {
|
|
120
|
+
const client = await requireClient();
|
|
121
|
+
await captureSnapshot(client, team, project);
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
async function cmdDown(team: string, project = DEFAULT_PROJECT): Promise<void> {
|
|
125
|
+
const client = await requireClient();
|
|
126
|
+
await captureSnapshot(client, team, project);
|
|
127
|
+
const ws = await findTeamWorkspace(client, team, project);
|
|
128
|
+
if (ws) {
|
|
129
|
+
await client.herdr.workspaceClose(ws.workspace_id);
|
|
130
|
+
const projectArgs = project === DEFAULT_PROJECT ? "" : ` --project ${project}`;
|
|
131
|
+
console.log(`Closed workspace ${ws.workspace_id} ("${ws.label}"). Resume with: just fleet resume ${team}${projectArgs}`);
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
async function cmdResume(team: string, project = DEFAULT_PROJECT): Promise<void> {
|
|
136
|
+
const file = snapshotPath(team, project);
|
|
137
|
+
if (!fs.existsSync(file)) {
|
|
138
|
+
const projectArgs = project === DEFAULT_PROJECT ? "" : ` --project ${project}`;
|
|
139
|
+
die(`No snapshot at ${file}.\nTake one while the team runs: just fleet snapshot ${team}${projectArgs} (or just fleet down ${team}${projectArgs}).`);
|
|
140
|
+
}
|
|
141
|
+
const snap = parseSnapshot(fs.readFileSync(file, "utf-8"));
|
|
142
|
+
try {
|
|
143
|
+
assertSnapshotProject(snap, project);
|
|
144
|
+
if (snap.team !== team) throw new Error(`Snapshot team mismatch: snapshot is ${JSON.stringify(snap.team)}, requested ${JSON.stringify(team)}.`);
|
|
145
|
+
} catch (err) {
|
|
146
|
+
die(err instanceof Error ? err.message : String(err));
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
const client = await requireClient();
|
|
150
|
+
const existing = await findTeamWorkspace(client, team, project);
|
|
151
|
+
if (existing) {
|
|
152
|
+
die(
|
|
153
|
+
`Workspace "${existing.label}" (${existing.workspace_id}) is already running.\n` +
|
|
154
|
+
` focus: herdr workspace focus ${existing.workspace_id}\n` +
|
|
155
|
+
` close: herdr workspace close ${existing.workspace_id}`,
|
|
156
|
+
);
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
const resumedNames = new Set<string>();
|
|
160
|
+
const resumeFor = (peer: Peer): string | undefined => {
|
|
161
|
+
const ref = resumeRefForPeer(
|
|
162
|
+
peer as PeerSnapshot,
|
|
163
|
+
// path refs must still exist on disk; id refs (claude-code) cannot
|
|
164
|
+
// be pre-checked and are handed to `claude --resume` as-is
|
|
165
|
+
(r) => (r.kind === "id" ? true : fs.existsSync(r.value)),
|
|
166
|
+
(p, reason) => console.warn(` ⚠ ${p.name}: ${reason}`),
|
|
167
|
+
);
|
|
168
|
+
if (ref && peer.name) resumedNames.add(peer.name);
|
|
169
|
+
return ref;
|
|
170
|
+
};
|
|
171
|
+
const workspaceLabel = teamWorkspaceLabel(snap.hub ? "hub" : "peers", snap.team, project, WORKTREE_TAG);
|
|
172
|
+
// Resume relaunches every pane simultaneously, so it needs the same
|
|
173
|
+
// pre-warm/stagger as team-up (see scripts/lib/spawn-stagger.ts).
|
|
174
|
+
let authRaw: string | undefined;
|
|
175
|
+
try {
|
|
176
|
+
authRaw = fs.readFileSync(path.join(os.homedir(), ".pi", "agent", "auth.json"), "utf-8");
|
|
177
|
+
} catch {
|
|
178
|
+
authRaw = undefined;
|
|
179
|
+
}
|
|
180
|
+
const { needed: staggerNeeded, delayForPeer } = planSpawnDelays(snap.peers, snap.hub, authRaw);
|
|
181
|
+
if (staggerNeeded) {
|
|
182
|
+
console.log("Stale pi OAuth token detected — staggering pane starts so one pane can refresh it first.");
|
|
183
|
+
}
|
|
184
|
+
const layout = buildTeamLayout({
|
|
185
|
+
team: snap.team,
|
|
186
|
+
peers: snap.peers,
|
|
187
|
+
repoRoot: REPO_ROOT,
|
|
188
|
+
resumeForPeer: resumeFor,
|
|
189
|
+
delayForPeer,
|
|
190
|
+
project,
|
|
191
|
+
...(snap.hub ? { hub: { command: hubCommand(project), label: "hub", ratio: 0.4 } } : {}),
|
|
192
|
+
});
|
|
193
|
+
|
|
194
|
+
const created = await client.herdr.workspaceCreate({
|
|
195
|
+
label: workspaceLabel,
|
|
196
|
+
cwd: REPO_ROOT,
|
|
197
|
+
focus: false,
|
|
198
|
+
});
|
|
199
|
+
const wsId = created.workspace.workspace_id;
|
|
200
|
+
const initialTab = created.workspace.active_tab_id ?? created.tab?.tab_id;
|
|
201
|
+
await client.herdr.layoutApply({ workspace_id: wsId, root: layout });
|
|
202
|
+
if (initialTab) {
|
|
203
|
+
try {
|
|
204
|
+
await client.herdr.tabClose(initialTab);
|
|
205
|
+
} catch {
|
|
206
|
+
// cosmetic
|
|
207
|
+
}
|
|
208
|
+
}
|
|
209
|
+
console.log(`Resumed team "${snap.team}" in workspace "${workspaceLabel}" (${wsId}):`);
|
|
210
|
+
for (const p of snap.peers) {
|
|
211
|
+
console.log(` • ${p.name}${p.name && resumedNames.has(p.name) ? " (session resumed)" : " (fresh)"}`);
|
|
212
|
+
}
|
|
213
|
+
console.log(`Focus: herdr workspace focus ${wsId}`);
|
|
214
|
+
}
|
|
215
|
+
|
|
216
|
+
async function main(): Promise<void> {
|
|
217
|
+
const argv = process.argv.slice(2);
|
|
218
|
+
const [cmd, team] = argv;
|
|
219
|
+
if (!cmd || !team) {
|
|
220
|
+
console.error("usage: team-snapshot.ts <snapshot|down|resume> <team> [--project <name>]");
|
|
221
|
+
process.exit(2);
|
|
222
|
+
}
|
|
223
|
+
let project = DEFAULT_PROJECT;
|
|
224
|
+
try {
|
|
225
|
+
validateTeamName(team);
|
|
226
|
+
project = parseProjectFlag(argv.slice(2));
|
|
227
|
+
} catch (err) {
|
|
228
|
+
die(err instanceof Error ? err.message : String(err));
|
|
229
|
+
}
|
|
230
|
+
if (cmd === "snapshot") return cmdSnapshot(team, project);
|
|
231
|
+
if (cmd === "down") return cmdDown(team, project);
|
|
232
|
+
if (cmd === "resume") return cmdResume(team, project);
|
|
233
|
+
die(`Unknown command "${cmd}" (want snapshot | down | resume).`);
|
|
234
|
+
}
|
|
235
|
+
|
|
236
|
+
const isEntry = process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
|
|
237
|
+
if (isEntry) void main();
|