@chankov/agent-fleet 2.0.1 → 2.0.2
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/agents/voices.yaml +13 -0
- package/.pi/harnesses/agent-hub/README.md +3 -1
- package/.pi/harnesses/agent-hub/commands/context.ts +2 -0
- package/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.pi/harnesses/agent-hub/config/agents.ts +14 -5
- package/.pi/harnesses/agent-hub/config/overrides.ts +44 -4
- package/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.pi/harnesses/agent-hub/delegate.ts +2 -2
- package/.pi/harnesses/agent-hub/index.ts +197 -0
- package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +5 -1
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.pi/harnesses/agent-hub/prompts/session-start.ts +2 -0
- package/.pi/harnesses/agent-hub/types.ts +1 -0
- package/.pi/harnesses/ask-user-remote/README.md +1 -1
- package/.pi/harnesses/coms/README.md +1 -1
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.versions/2.0.2/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.2/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/2.0.2/.pi/agents/peers.yaml +142 -0
- package/.versions/2.0.2/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.2/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.2/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.2/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/2.0.2/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/2.0.2/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/2.0.2/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.2/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.2/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.2/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.2/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.2/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.2/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.2/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.2/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.2/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.2/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.2/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.2/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.2/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.2/.pi/extensions/package.json +9 -0
- package/.versions/2.0.2/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/2.0.2/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.2/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.2/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.2/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.2/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.2/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/README.md +1163 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/context.ts +41 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/config/agents.ts +180 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/config/overrides.ts +158 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/delegate.ts +446 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/fixtures/registration-surface.json +55 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/index.ts +2047 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/policy/models.ts +126 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/research/controls.ts +75 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/spawn.ts +388 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/context.ts +132 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/types.ts +61 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.2/.pi/harnesses/agent-hub/work-mode.ts +167 -0
- package/.versions/2.0.2/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/2.0.2/.pi/harnesses/ask-user-remote/index.ts +532 -0
- package/.versions/2.0.2/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/2.0.2/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.2/.pi/harnesses/coms/index.ts +276 -0
- package/.versions/2.0.2/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.2/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.2/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/2.0.2/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/2.0.2/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.2/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.2/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.2/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.2/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.2/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
- package/.versions/2.0.2/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.2/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.2/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.2/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.2/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.2/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.2/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.2/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.2/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.2/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.2/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.2/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.2/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.2/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/2.0.2/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.2/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.2/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.2/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.2/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.2/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.2/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.2/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.2/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.2/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.2/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.2/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.2/.version +1 -0
- package/.versions/2.0.2/agents/architect.md +25 -0
- package/.versions/2.0.2/agents/bowser.md +28 -0
- package/.versions/2.0.2/agents/builder.md +56 -0
- package/.versions/2.0.2/agents/code-reviewer.md +210 -0
- package/.versions/2.0.2/agents/deep-researcher.md +33 -0
- package/.versions/2.0.2/agents/documenter.md +22 -0
- package/.versions/2.0.2/agents/orchestrator.md +23 -0
- package/.versions/2.0.2/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.2/agents/planner.md +105 -0
- package/.versions/2.0.2/agents/releaser.md +25 -0
- package/.versions/2.0.2/agents/researcher.md +31 -0
- package/.versions/2.0.2/agents/security-auditor.md +168 -0
- package/.versions/2.0.2/agents/test-engineer.md +154 -0
- package/.versions/2.0.2/agents/web-debugger.md +44 -0
- package/.versions/2.0.2/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.2/bin/catalog/harness-runtime-closure.json +34 -0
- package/.versions/2.0.2/codex/CONDUCTOR.md +148 -0
- package/.versions/2.0.2/docs/ARCHITECTURE.md +407 -0
- package/.versions/2.0.2/docs/agent-fleet-setup.md +473 -0
- package/.versions/2.0.2/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/2.0.2/docs/codex-remote-conductor.md +170 -0
- package/.versions/2.0.2/docs/coms-hermes-bridge.md +189 -0
- package/.versions/2.0.2/docs/getting-started.md +119 -0
- package/.versions/2.0.2/docs/npm-install.md +292 -0
- package/.versions/2.0.2/docs/pi-extensions.md +444 -0
- package/.versions/2.0.2/docs/pi-setup.md +74 -0
- package/.versions/2.0.2/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.2/hermes/README.md +347 -0
- package/.versions/2.0.2/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.2/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.2/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.2/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.2/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.2/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.2/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.2/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.2/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.2/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.2/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.2/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.2/install-manifest.json +2905 -0
- package/.versions/2.0.2/justfile +288 -0
- package/.versions/2.0.2/manifest-meta.json +945 -0
- package/.versions/2.0.2/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.2/references/communication-contract.md +26 -0
- package/.versions/2.0.2/references/definition-of-done.md +67 -0
- package/.versions/2.0.2/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.2/references/observability-checklist.md +91 -0
- package/.versions/2.0.2/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.2/references/performance-checklist.md +153 -0
- package/.versions/2.0.2/references/prompting-patterns.md +380 -0
- package/.versions/2.0.2/references/security-checklist.md +179 -0
- package/.versions/2.0.2/references/testing-patterns.md +236 -0
- package/.versions/2.0.2/references/workflow-authoring.md +304 -0
- package/.versions/2.0.2/scripts/codex-conductor.ts +41 -0
- package/.versions/2.0.2/scripts/codex-remote-control.ts +167 -0
- package/.versions/2.0.2/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.2/scripts/coms-cli.ts +484 -0
- package/.versions/2.0.2/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.2/scripts/fleet.ts +199 -0
- package/.versions/2.0.2/scripts/flow.ts +137 -0
- package/.versions/2.0.2/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.2/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.2/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.2/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.2/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.2/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/2.0.2/scripts/lib/codex-remote-control.ts +482 -0
- package/.versions/2.0.2/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.2/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.2/scripts/lib/fleet-command.ts +270 -0
- package/.versions/2.0.2/scripts/lib/flow-command.ts +93 -0
- package/.versions/2.0.2/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.2/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.2/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.2/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.2/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.2/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.2/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.2/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.2/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.2/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.2/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.2/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.2/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.2/scripts/lib/team-project.ts +213 -0
- package/.versions/2.0.2/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.2/scripts/peer-banner.ts +40 -0
- package/.versions/2.0.2/scripts/peer-launch.ts +259 -0
- package/.versions/2.0.2/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.2/scripts/team-up.ts +406 -0
- package/.versions/2.0.2/scripts/workflows/lib/agent-phase.ts +132 -0
- package/.versions/2.0.2/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.2/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.2/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.2/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.2/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.2/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.2/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.2/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.2/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.2/scripts/workflows/lib/personas.ts +54 -0
- package/.versions/2.0.2/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.2/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.2/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.2/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.2/scripts/workflows/lib/voices.ts +125 -0
- package/.versions/2.0.2/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.2/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.2/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.2/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.2/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.2/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.2/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.2/scripts/workflows/wf-scout.ts +38 -0
- package/.versions/2.0.2/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.2/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.2/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/2.0.2/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.2/skills/context-engineering/SKILL.md +291 -0
- package/.versions/2.0.2/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/2.0.2/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.2/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.2/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.2/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.2/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.2/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.2/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.2/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.2/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.2/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.2/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.2/skills/incremental-implementation/SKILL.md +298 -0
- package/.versions/2.0.2/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.2/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/2.0.2/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.2/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.2/skills/planning-and-task-breakdown/SKILL.md +265 -0
- package/.versions/2.0.2/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/2.0.2/skills/spec-driven-development/SKILL.md +256 -0
- package/.versions/2.0.2/skills/using-agent-skills/SKILL.md +197 -0
- package/.versions/2.0.2/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/2.0.2/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +7 -0
- package/agents/planner.md +40 -8
- package/bin/catalog/harness-runtime-closure.json +0 -4
- package/bin/lib/apply.js +65 -2
- package/bin/lib/doctor.js +143 -1
- package/bin/lib/plan.js +2 -0
- package/bin/lib/transaction.js +14 -1
- package/bin/lib/validate-overrides.js +20 -0
- package/bin/lib/verify.js +22 -1
- package/codex/CONDUCTOR.md +1 -1
- package/docs/agent-fleet-setup.md +8 -3
- package/docs/codex-remote-conductor.md +3 -3
- package/docs/pi-extensions.md +5 -0
- package/docs/workflows.md +7 -0
- package/install-manifest.json +84 -9
- package/justfile +2 -0
- package/manifest-meta.json +37 -5
- package/node_modules/yaml/LICENSE +13 -0
- package/node_modules/yaml/README.md +172 -0
- package/node_modules/yaml/bin.mjs +11 -0
- package/node_modules/yaml/browser/dist/compose/compose-collection.js +88 -0
- package/node_modules/yaml/browser/dist/compose/compose-doc.js +43 -0
- package/node_modules/yaml/browser/dist/compose/compose-node.js +109 -0
- package/node_modules/yaml/browser/dist/compose/compose-scalar.js +86 -0
- package/node_modules/yaml/browser/dist/compose/composer.js +219 -0
- package/node_modules/yaml/browser/dist/compose/resolve-block-map.js +115 -0
- package/node_modules/yaml/browser/dist/compose/resolve-block-scalar.js +198 -0
- package/node_modules/yaml/browser/dist/compose/resolve-block-seq.js +49 -0
- package/node_modules/yaml/browser/dist/compose/resolve-end.js +37 -0
- package/node_modules/yaml/browser/dist/compose/resolve-flow-collection.js +207 -0
- package/node_modules/yaml/browser/dist/compose/resolve-flow-scalar.js +225 -0
- package/node_modules/yaml/browser/dist/compose/resolve-props.js +146 -0
- package/node_modules/yaml/browser/dist/compose/util-contains-newline.js +34 -0
- package/node_modules/yaml/browser/dist/compose/util-empty-scalar-position.js +26 -0
- package/node_modules/yaml/browser/dist/compose/util-flow-indent-check.js +15 -0
- package/node_modules/yaml/browser/dist/compose/util-map-includes.js +13 -0
- package/node_modules/yaml/browser/dist/doc/Document.js +335 -0
- package/node_modules/yaml/browser/dist/doc/anchors.js +71 -0
- package/node_modules/yaml/browser/dist/doc/applyReviver.js +55 -0
- package/node_modules/yaml/browser/dist/doc/createNode.js +88 -0
- package/node_modules/yaml/browser/dist/doc/directives.js +176 -0
- package/node_modules/yaml/browser/dist/errors.js +57 -0
- package/node_modules/yaml/browser/dist/index.js +17 -0
- package/node_modules/yaml/browser/dist/log.js +11 -0
- package/node_modules/yaml/browser/dist/nodes/Alias.js +116 -0
- package/node_modules/yaml/browser/dist/nodes/Collection.js +147 -0
- package/node_modules/yaml/browser/dist/nodes/Node.js +38 -0
- package/node_modules/yaml/browser/dist/nodes/Pair.js +36 -0
- package/node_modules/yaml/browser/dist/nodes/Scalar.js +24 -0
- package/node_modules/yaml/browser/dist/nodes/YAMLMap.js +144 -0
- package/node_modules/yaml/browser/dist/nodes/YAMLSeq.js +113 -0
- package/node_modules/yaml/browser/dist/nodes/addPairToJSMap.js +63 -0
- package/node_modules/yaml/browser/dist/nodes/identity.js +36 -0
- package/node_modules/yaml/browser/dist/nodes/toJS.js +37 -0
- package/node_modules/yaml/browser/dist/parse/cst-scalar.js +214 -0
- package/node_modules/yaml/browser/dist/parse/cst-stringify.js +61 -0
- package/node_modules/yaml/browser/dist/parse/cst-visit.js +97 -0
- package/node_modules/yaml/browser/dist/parse/cst.js +98 -0
- package/node_modules/yaml/browser/dist/parse/lexer.js +721 -0
- package/node_modules/yaml/browser/dist/parse/line-counter.js +39 -0
- package/node_modules/yaml/browser/dist/parse/parser.js +975 -0
- package/node_modules/yaml/browser/dist/public-api.js +102 -0
- package/node_modules/yaml/browser/dist/schema/Schema.js +37 -0
- package/node_modules/yaml/browser/dist/schema/common/map.js +17 -0
- package/node_modules/yaml/browser/dist/schema/common/null.js +15 -0
- package/node_modules/yaml/browser/dist/schema/common/seq.js +17 -0
- package/node_modules/yaml/browser/dist/schema/common/string.js +14 -0
- package/node_modules/yaml/browser/dist/schema/core/bool.js +19 -0
- package/node_modules/yaml/browser/dist/schema/core/float.js +43 -0
- package/node_modules/yaml/browser/dist/schema/core/int.js +38 -0
- package/node_modules/yaml/browser/dist/schema/core/schema.js +23 -0
- package/node_modules/yaml/browser/dist/schema/json/schema.js +62 -0
- package/node_modules/yaml/browser/dist/schema/tags.js +96 -0
- package/node_modules/yaml/browser/dist/schema/yaml-1.1/binary.js +58 -0
- package/node_modules/yaml/browser/dist/schema/yaml-1.1/bool.js +26 -0
- package/node_modules/yaml/browser/dist/schema/yaml-1.1/float.js +46 -0
- package/node_modules/yaml/browser/dist/schema/yaml-1.1/int.js +71 -0
- package/node_modules/yaml/browser/dist/schema/yaml-1.1/merge.js +67 -0
- package/node_modules/yaml/browser/dist/schema/yaml-1.1/omap.js +74 -0
- package/node_modules/yaml/browser/dist/schema/yaml-1.1/pairs.js +78 -0
- package/node_modules/yaml/browser/dist/schema/yaml-1.1/schema.js +39 -0
- package/node_modules/yaml/browser/dist/schema/yaml-1.1/set.js +93 -0
- package/node_modules/yaml/browser/dist/schema/yaml-1.1/timestamp.js +101 -0
- package/node_modules/yaml/browser/dist/stringify/foldFlowLines.js +146 -0
- package/node_modules/yaml/browser/dist/stringify/stringify.js +129 -0
- package/node_modules/yaml/browser/dist/stringify/stringifyCollection.js +153 -0
- package/node_modules/yaml/browser/dist/stringify/stringifyComment.js +20 -0
- package/node_modules/yaml/browser/dist/stringify/stringifyDocument.js +85 -0
- package/node_modules/yaml/browser/dist/stringify/stringifyNumber.js +25 -0
- package/node_modules/yaml/browser/dist/stringify/stringifyPair.js +150 -0
- package/node_modules/yaml/browser/dist/stringify/stringifyString.js +336 -0
- package/node_modules/yaml/browser/dist/util.js +11 -0
- package/node_modules/yaml/browser/dist/visit.js +233 -0
- package/node_modules/yaml/browser/index.js +5 -0
- package/node_modules/yaml/browser/package.json +3 -0
- package/node_modules/yaml/dist/cli.d.ts +8 -0
- package/node_modules/yaml/dist/cli.mjs +201 -0
- package/node_modules/yaml/dist/compose/compose-collection.d.ts +11 -0
- package/node_modules/yaml/dist/compose/compose-collection.js +90 -0
- package/node_modules/yaml/dist/compose/compose-doc.d.ts +7 -0
- package/node_modules/yaml/dist/compose/compose-doc.js +45 -0
- package/node_modules/yaml/dist/compose/compose-node.d.ts +29 -0
- package/node_modules/yaml/dist/compose/compose-node.js +112 -0
- package/node_modules/yaml/dist/compose/compose-scalar.d.ts +5 -0
- package/node_modules/yaml/dist/compose/compose-scalar.js +88 -0
- package/node_modules/yaml/dist/compose/composer.d.ts +63 -0
- package/node_modules/yaml/dist/compose/composer.js +224 -0
- package/node_modules/yaml/dist/compose/resolve-block-map.d.ts +6 -0
- package/node_modules/yaml/dist/compose/resolve-block-map.js +117 -0
- package/node_modules/yaml/dist/compose/resolve-block-scalar.d.ts +11 -0
- package/node_modules/yaml/dist/compose/resolve-block-scalar.js +200 -0
- package/node_modules/yaml/dist/compose/resolve-block-seq.d.ts +6 -0
- package/node_modules/yaml/dist/compose/resolve-block-seq.js +51 -0
- package/node_modules/yaml/dist/compose/resolve-end.d.ts +6 -0
- package/node_modules/yaml/dist/compose/resolve-end.js +39 -0
- package/node_modules/yaml/dist/compose/resolve-flow-collection.d.ts +7 -0
- package/node_modules/yaml/dist/compose/resolve-flow-collection.js +209 -0
- package/node_modules/yaml/dist/compose/resolve-flow-scalar.d.ts +10 -0
- package/node_modules/yaml/dist/compose/resolve-flow-scalar.js +227 -0
- package/node_modules/yaml/dist/compose/resolve-props.d.ts +23 -0
- package/node_modules/yaml/dist/compose/resolve-props.js +148 -0
- package/node_modules/yaml/dist/compose/util-contains-newline.d.ts +2 -0
- package/node_modules/yaml/dist/compose/util-contains-newline.js +36 -0
- package/node_modules/yaml/dist/compose/util-empty-scalar-position.d.ts +2 -0
- package/node_modules/yaml/dist/compose/util-empty-scalar-position.js +28 -0
- package/node_modules/yaml/dist/compose/util-flow-indent-check.d.ts +3 -0
- package/node_modules/yaml/dist/compose/util-flow-indent-check.js +17 -0
- package/node_modules/yaml/dist/compose/util-map-includes.d.ts +4 -0
- package/node_modules/yaml/dist/compose/util-map-includes.js +15 -0
- package/node_modules/yaml/dist/doc/Document.d.ts +141 -0
- package/node_modules/yaml/dist/doc/Document.js +337 -0
- package/node_modules/yaml/dist/doc/anchors.d.ts +24 -0
- package/node_modules/yaml/dist/doc/anchors.js +76 -0
- package/node_modules/yaml/dist/doc/applyReviver.d.ts +9 -0
- package/node_modules/yaml/dist/doc/applyReviver.js +57 -0
- package/node_modules/yaml/dist/doc/createNode.d.ts +17 -0
- package/node_modules/yaml/dist/doc/createNode.js +90 -0
- package/node_modules/yaml/dist/doc/directives.d.ts +49 -0
- package/node_modules/yaml/dist/doc/directives.js +178 -0
- package/node_modules/yaml/dist/errors.d.ts +21 -0
- package/node_modules/yaml/dist/errors.js +62 -0
- package/node_modules/yaml/dist/index.d.ts +25 -0
- package/node_modules/yaml/dist/index.js +50 -0
- package/node_modules/yaml/dist/log.d.ts +3 -0
- package/node_modules/yaml/dist/log.js +19 -0
- package/node_modules/yaml/dist/nodes/Alias.d.ts +29 -0
- package/node_modules/yaml/dist/nodes/Alias.js +118 -0
- package/node_modules/yaml/dist/nodes/Collection.d.ts +73 -0
- package/node_modules/yaml/dist/nodes/Collection.js +151 -0
- package/node_modules/yaml/dist/nodes/Node.d.ts +53 -0
- package/node_modules/yaml/dist/nodes/Node.js +40 -0
- package/node_modules/yaml/dist/nodes/Pair.d.ts +22 -0
- package/node_modules/yaml/dist/nodes/Pair.js +39 -0
- package/node_modules/yaml/dist/nodes/Scalar.d.ts +47 -0
- package/node_modules/yaml/dist/nodes/Scalar.js +27 -0
- package/node_modules/yaml/dist/nodes/YAMLMap.d.ts +53 -0
- package/node_modules/yaml/dist/nodes/YAMLMap.js +147 -0
- package/node_modules/yaml/dist/nodes/YAMLSeq.d.ts +60 -0
- package/node_modules/yaml/dist/nodes/YAMLSeq.js +115 -0
- package/node_modules/yaml/dist/nodes/addPairToJSMap.d.ts +4 -0
- package/node_modules/yaml/dist/nodes/addPairToJSMap.js +65 -0
- package/node_modules/yaml/dist/nodes/identity.d.ts +23 -0
- package/node_modules/yaml/dist/nodes/identity.js +53 -0
- package/node_modules/yaml/dist/nodes/toJS.d.ts +29 -0
- package/node_modules/yaml/dist/nodes/toJS.js +39 -0
- package/node_modules/yaml/dist/options.d.ts +350 -0
- package/node_modules/yaml/dist/parse/cst-scalar.d.ts +64 -0
- package/node_modules/yaml/dist/parse/cst-scalar.js +218 -0
- package/node_modules/yaml/dist/parse/cst-stringify.d.ts +8 -0
- package/node_modules/yaml/dist/parse/cst-stringify.js +63 -0
- package/node_modules/yaml/dist/parse/cst-visit.d.ts +39 -0
- package/node_modules/yaml/dist/parse/cst-visit.js +99 -0
- package/node_modules/yaml/dist/parse/cst.d.ts +109 -0
- package/node_modules/yaml/dist/parse/cst.js +112 -0
- package/node_modules/yaml/dist/parse/lexer.d.ts +87 -0
- package/node_modules/yaml/dist/parse/lexer.js +723 -0
- package/node_modules/yaml/dist/parse/line-counter.d.ts +22 -0
- package/node_modules/yaml/dist/parse/line-counter.js +41 -0
- package/node_modules/yaml/dist/parse/parser.d.ts +84 -0
- package/node_modules/yaml/dist/parse/parser.js +980 -0
- package/node_modules/yaml/dist/public-api.d.ts +44 -0
- package/node_modules/yaml/dist/public-api.js +107 -0
- package/node_modules/yaml/dist/schema/Schema.d.ts +17 -0
- package/node_modules/yaml/dist/schema/Schema.js +39 -0
- package/node_modules/yaml/dist/schema/common/map.d.ts +2 -0
- package/node_modules/yaml/dist/schema/common/map.js +19 -0
- package/node_modules/yaml/dist/schema/common/null.d.ts +4 -0
- package/node_modules/yaml/dist/schema/common/null.js +17 -0
- package/node_modules/yaml/dist/schema/common/seq.d.ts +2 -0
- package/node_modules/yaml/dist/schema/common/seq.js +19 -0
- package/node_modules/yaml/dist/schema/common/string.d.ts +2 -0
- package/node_modules/yaml/dist/schema/common/string.js +16 -0
- package/node_modules/yaml/dist/schema/core/bool.d.ts +4 -0
- package/node_modules/yaml/dist/schema/core/bool.js +21 -0
- package/node_modules/yaml/dist/schema/core/float.d.ts +4 -0
- package/node_modules/yaml/dist/schema/core/float.js +47 -0
- package/node_modules/yaml/dist/schema/core/int.d.ts +4 -0
- package/node_modules/yaml/dist/schema/core/int.js +42 -0
- package/node_modules/yaml/dist/schema/core/schema.d.ts +1 -0
- package/node_modules/yaml/dist/schema/core/schema.js +25 -0
- package/node_modules/yaml/dist/schema/json/schema.d.ts +2 -0
- package/node_modules/yaml/dist/schema/json/schema.js +64 -0
- package/node_modules/yaml/dist/schema/json-schema.d.ts +69 -0
- package/node_modules/yaml/dist/schema/tags.d.ts +48 -0
- package/node_modules/yaml/dist/schema/tags.js +99 -0
- package/node_modules/yaml/dist/schema/types.d.ts +92 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/binary.d.ts +2 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/binary.js +70 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/bool.d.ts +7 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/bool.js +29 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/float.d.ts +4 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/float.js +50 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/int.d.ts +5 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/int.js +76 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/merge.d.ts +9 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/merge.js +71 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/omap.d.ts +22 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/omap.js +77 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/pairs.d.ts +10 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/pairs.js +82 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/schema.d.ts +1 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/schema.js +41 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/set.d.ts +28 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/set.js +96 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/timestamp.d.ts +6 -0
- package/node_modules/yaml/dist/schema/yaml-1.1/timestamp.js +105 -0
- package/node_modules/yaml/dist/stringify/foldFlowLines.d.ts +34 -0
- package/node_modules/yaml/dist/stringify/foldFlowLines.js +151 -0
- package/node_modules/yaml/dist/stringify/stringify.d.ts +21 -0
- package/node_modules/yaml/dist/stringify/stringify.js +132 -0
- package/node_modules/yaml/dist/stringify/stringifyCollection.d.ts +17 -0
- package/node_modules/yaml/dist/stringify/stringifyCollection.js +155 -0
- package/node_modules/yaml/dist/stringify/stringifyComment.d.ts +10 -0
- package/node_modules/yaml/dist/stringify/stringifyComment.js +24 -0
- package/node_modules/yaml/dist/stringify/stringifyDocument.d.ts +4 -0
- package/node_modules/yaml/dist/stringify/stringifyDocument.js +87 -0
- package/node_modules/yaml/dist/stringify/stringifyNumber.d.ts +2 -0
- package/node_modules/yaml/dist/stringify/stringifyNumber.js +27 -0
- package/node_modules/yaml/dist/stringify/stringifyPair.d.ts +3 -0
- package/node_modules/yaml/dist/stringify/stringifyPair.js +152 -0
- package/node_modules/yaml/dist/stringify/stringifyString.d.ts +9 -0
- package/node_modules/yaml/dist/stringify/stringifyString.js +338 -0
- package/node_modules/yaml/dist/test-events.d.ts +4 -0
- package/node_modules/yaml/dist/test-events.js +134 -0
- package/node_modules/yaml/dist/util.d.ts +16 -0
- package/node_modules/yaml/dist/util.js +28 -0
- package/node_modules/yaml/dist/visit.d.ts +102 -0
- package/node_modules/yaml/dist/visit.js +236 -0
- package/node_modules/yaml/package.json +97 -0
- package/node_modules/yaml/util.js +2 -0
- package/package.json +4 -3
- package/references/communication-contract.md +26 -0
- package/references/fleet-coordination-patterns.md +20 -0
- package/references/orchestration-patterns.md +2 -2
- package/references/workflow-authoring.md +1 -1
- package/scripts/fleet.ts +2 -1
- package/scripts/flow.ts +23 -7
- package/scripts/lib/codex-remote-control.ts +3 -1
- package/scripts/lib/flow-command.ts +19 -3
- package/scripts/workflows/lib/agent-phase.ts +18 -4
- package/scripts/workflows/lib/debate.ts +149 -0
- package/scripts/workflows/lib/envelopes.ts +32 -4
- package/scripts/workflows/lib/merge.ts +95 -0
- package/scripts/workflows/lib/model-visibility.ts +92 -0
- package/scripts/workflows/lib/personas.ts +10 -0
- package/scripts/workflows/lib/poll.ts +86 -0
- package/scripts/workflows/lib/run.ts +2 -0
- package/scripts/workflows/lib/voices.ts +125 -0
- package/scripts/workflows/lib/writer-lease.ts +112 -0
- package/scripts/workflows/wf-debate.ts +87 -0
- package/scripts/workflows/wf-poll.ts +95 -0
- package/skills/drafting-workflows/SKILL.md +1 -1
- package/skills/planning-and-task-breakdown/SKILL.md +2 -0
|
@@ -0,0 +1,213 @@
|
|
|
1
|
+
// scripts/lib/team-project.ts
|
|
2
|
+
//
|
|
3
|
+
// Shared project scoping helpers for herdr team commands. The coms harness
|
|
4
|
+
// already isolates peers by --project; this file only keeps team workspace
|
|
5
|
+
// labels, snapshot files, and generated launch argv in sync with that scope.
|
|
6
|
+
|
|
7
|
+
import * as os from "node:os";
|
|
8
|
+
import * as path from "node:path";
|
|
9
|
+
|
|
10
|
+
export const DEFAULT_PROJECT = "default";
|
|
11
|
+
|
|
12
|
+
// Conservative project names: no empty string, path separators, traversal,
|
|
13
|
+
// whitespace, shell metacharacters, or glob stars. Dots are allowed for names
|
|
14
|
+
// like "acme.prod", but ".." is not allowed anywhere.
|
|
15
|
+
export const PROJECT_SAFE = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
|
|
16
|
+
export const TEAM_SAFE = /^[A-Za-z0-9_-]+$/;
|
|
17
|
+
export const CODEX_CONTRACT_IDENTITY = "agent-fleet-codex-conductor-pilot-v1";
|
|
18
|
+
export const DEFAULT_CODEX_TIMEOUT_MS = 300_000;
|
|
19
|
+
|
|
20
|
+
export type ConductorBackend = "hermes" | "codex";
|
|
21
|
+
// "peer" is the `just fleet peer <name>` workspace: a single pane for
|
|
22
|
+
// a single peer, labelled by the PEER name where the others use a team name.
|
|
23
|
+
export type WorkspaceMode = "peers" | "peer" | "hub" | "conductor-hermes" | "conductor-codex";
|
|
24
|
+
|
|
25
|
+
export interface ConductorSpec {
|
|
26
|
+
backend: ConductorBackend;
|
|
27
|
+
workspaceMode: Extract<WorkspaceMode, `conductor-${string}`>;
|
|
28
|
+
paneLabel: string;
|
|
29
|
+
command: string[];
|
|
30
|
+
cwd: string;
|
|
31
|
+
env: Record<string, string>;
|
|
32
|
+
ratio: number;
|
|
33
|
+
displayText: string;
|
|
34
|
+
expectedServiceScope: "none" | "agent-fleet-codex-remote-control.service";
|
|
35
|
+
conductorName: string;
|
|
36
|
+
team: string;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
function validateAbsoluteRepoRoot(repoRoot: string): string {
|
|
40
|
+
if (!path.isAbsolute(repoRoot) || path.resolve(repoRoot) !== repoRoot || repoRoot.includes("..")) {
|
|
41
|
+
throw new Error(`Invalid absolute repository root: ${JSON.stringify(repoRoot)}`);
|
|
42
|
+
}
|
|
43
|
+
return repoRoot;
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
export function validateProject(project: string): string {
|
|
47
|
+
if (
|
|
48
|
+
project.length === 0 ||
|
|
49
|
+
project === "." ||
|
|
50
|
+
project.includes("..") ||
|
|
51
|
+
project.includes("/") ||
|
|
52
|
+
project.includes("\\") ||
|
|
53
|
+
!PROJECT_SAFE.test(project)
|
|
54
|
+
) {
|
|
55
|
+
throw new Error(
|
|
56
|
+
`Invalid project name: ${JSON.stringify(project)} (use letters, numbers, dots, underscores, or hyphens; no '..')`,
|
|
57
|
+
);
|
|
58
|
+
}
|
|
59
|
+
return project;
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
export function validateTeamName(team: string): string {
|
|
63
|
+
if (!TEAM_SAFE.test(team)) throw new Error(`Invalid team name: ${JSON.stringify(team)}`);
|
|
64
|
+
return team;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
// The worktree/repo identity that scopes a workspace label so the same team
|
|
68
|
+
// launched from different checkouts never collides. It is the LAST dot-segment
|
|
69
|
+
// of the checkout directory's basename — the convention the fleet uses for
|
|
70
|
+
// git worktrees: `main.wt2` → `wt2`, `ringithub.end2` → `end2`, a plain
|
|
71
|
+
// `agent-fleet` checkout → `agent-fleet`. Sanitized to the label-safe charset;
|
|
72
|
+
// falls back to "repo" when nothing usable remains.
|
|
73
|
+
export function worktreeTag(repoRoot: string): string {
|
|
74
|
+
const base = path.basename(repoRoot);
|
|
75
|
+
const dot = base.lastIndexOf(".");
|
|
76
|
+
const seg = dot > 0 ? base.slice(dot + 1) : base;
|
|
77
|
+
const safe = seg.replace(/[^A-Za-z0-9_-]+/g, "-").replace(/^-+|-+$/g, "");
|
|
78
|
+
return safe || "repo";
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
export function parseProjectFlag(argv: string[]): string {
|
|
82
|
+
let project = DEFAULT_PROJECT;
|
|
83
|
+
let seen = false;
|
|
84
|
+
for (let i = 0; i < argv.length; i++) {
|
|
85
|
+
if (argv[i] !== "--project") continue;
|
|
86
|
+
if (seen) throw new Error("--project may only be provided once");
|
|
87
|
+
seen = true;
|
|
88
|
+
const value = argv[i + 1];
|
|
89
|
+
if (!value || value.startsWith("--")) throw new Error("--project requires a name");
|
|
90
|
+
project = value;
|
|
91
|
+
i++;
|
|
92
|
+
}
|
|
93
|
+
return validateProject(project);
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
// Workspace label = <worktree-tag>-<mode>-<team>, with a `--project.<name>`
|
|
97
|
+
// suffix when the coms project is non-default. The worktree tag keys the label
|
|
98
|
+
// to the checkout, so `just fleet team <team>` from two repos/worktrees yields
|
|
99
|
+
// distinct labels (e.g. `wt2-hub-plan` vs `end2-hub-plan`) instead of colliding
|
|
100
|
+
// on a shared `pi-hub-<team>`. Pass `tag` from worktreeTag(REPO_ROOT); it
|
|
101
|
+
// defaults to "repo" only for callers that have no checkout in hand.
|
|
102
|
+
export function teamWorkspaceLabel(
|
|
103
|
+
kind: WorkspaceMode,
|
|
104
|
+
team: string,
|
|
105
|
+
project = DEFAULT_PROJECT,
|
|
106
|
+
tag = "repo",
|
|
107
|
+
): string {
|
|
108
|
+
validateTeamName(team);
|
|
109
|
+
validateProject(project);
|
|
110
|
+
const base = `${tag}-${kind}-${team}`;
|
|
111
|
+
return project === DEFAULT_PROJECT ? base : `${base}--project.${project}`;
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
export interface HubCommandOptions {
|
|
115
|
+
workMode?: "operator" | "orchestrator";
|
|
116
|
+
agentTeam?: string;
|
|
117
|
+
noComs?: boolean;
|
|
118
|
+
browser?: boolean;
|
|
119
|
+
allExtensions?: boolean;
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
export function resolveLegacyAgentRoster(teams: Record<string, string[]>, requested: string): string {
|
|
123
|
+
validateTeamName(requested);
|
|
124
|
+
const wanted = requested.toLowerCase();
|
|
125
|
+
return Object.keys(teams).find(name => name.toLowerCase() === wanted)
|
|
126
|
+
?? Object.keys(teams).find(name => name.toLowerCase() === "default")
|
|
127
|
+
?? "default";
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
export function hubCommand(
|
|
131
|
+
project = DEFAULT_PROJECT,
|
|
132
|
+
options: HubCommandOptions = {},
|
|
133
|
+
): string[] {
|
|
134
|
+
validateProject(project);
|
|
135
|
+
if (options.agentTeam) validateTeamName(options.agentTeam);
|
|
136
|
+
const command = ["just", "fleet"];
|
|
137
|
+
if (options.workMode) command.push("--work-mode", options.workMode);
|
|
138
|
+
if (options.agentTeam) command.push("--agents", options.agentTeam);
|
|
139
|
+
if (options.noComs) command.push("--no-coms");
|
|
140
|
+
if (options.browser) command.push("--browser");
|
|
141
|
+
if (options.allExtensions) command.push("--all-extensions");
|
|
142
|
+
if (project !== DEFAULT_PROJECT) command.push("--project", project);
|
|
143
|
+
return command;
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
export function conductorCommand(): string[] {
|
|
147
|
+
return ["hermes", "-p", "dev"];
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
export function conductorSpec(
|
|
151
|
+
backend: ConductorBackend,
|
|
152
|
+
input: { repoRoot: string; runtimeDir?: string; team: string; project?: string; nodeBin?: string },
|
|
153
|
+
): ConductorSpec {
|
|
154
|
+
const repoRoot = validateAbsoluteRepoRoot(input.repoRoot);
|
|
155
|
+
const team = validateTeamName(input.team);
|
|
156
|
+
const project = validateProject(input.project ?? DEFAULT_PROJECT);
|
|
157
|
+
const conductorName = `${backend}-${team}-conductor`;
|
|
158
|
+
if (backend === "hermes") {
|
|
159
|
+
return {
|
|
160
|
+
backend,
|
|
161
|
+
workspaceMode: "conductor-hermes",
|
|
162
|
+
paneLabel: "conductor-hermes",
|
|
163
|
+
command: conductorCommand(),
|
|
164
|
+
cwd: repoRoot,
|
|
165
|
+
env: {},
|
|
166
|
+
ratio: 0.35,
|
|
167
|
+
displayText: "Hermes conductor; no herdr control",
|
|
168
|
+
expectedServiceScope: "none",
|
|
169
|
+
conductorName,
|
|
170
|
+
team,
|
|
171
|
+
};
|
|
172
|
+
}
|
|
173
|
+
const runtimeDir = input.runtimeDir ?? path.join(os.homedir(), ".local", "state", "agent-fleet", "codex-conductor");
|
|
174
|
+
if (!path.isAbsolute(runtimeDir) || path.resolve(runtimeDir) !== runtimeDir) {
|
|
175
|
+
throw new Error(`Codex conductor requires an absolute runtime directory: ${JSON.stringify(runtimeDir)}`);
|
|
176
|
+
}
|
|
177
|
+
const relativeRuntime = path.relative(repoRoot, runtimeDir);
|
|
178
|
+
if (relativeRuntime === "" || (!relativeRuntime.startsWith("..") && !path.isAbsolute(relativeRuntime))) {
|
|
179
|
+
throw new Error("Codex conductor requires a runtime directory outside repoRoot");
|
|
180
|
+
}
|
|
181
|
+
const workspaceDir = path.join(runtimeDir, "workspace");
|
|
182
|
+
const nodeBin = input.nodeBin ?? process.execPath;
|
|
183
|
+
if (!path.isAbsolute(nodeBin)) throw new Error(`Codex conductor requires an absolute Node binary path: ${JSON.stringify(nodeBin)}`);
|
|
184
|
+
return {
|
|
185
|
+
backend,
|
|
186
|
+
workspaceMode: "conductor-codex",
|
|
187
|
+
paneLabel: "conductor-codex-control",
|
|
188
|
+
command: [nodeBin, "--experimental-strip-types", path.join(repoRoot, "scripts", "codex-remote-control.ts"), "control-pane"],
|
|
189
|
+
cwd: workspaceDir,
|
|
190
|
+
env: {
|
|
191
|
+
AGENT_FLEET_REPO_ROOT: repoRoot,
|
|
192
|
+
COMS_CLI_PROJECT: project,
|
|
193
|
+
COMS_CLI_NAME: conductorName,
|
|
194
|
+
COMS_CLI_TIMEOUT_MS: String(DEFAULT_CODEX_TIMEOUT_MS),
|
|
195
|
+
AGENT_FLEET_CODEX_CONTRACT_PATH: path.join(workspaceDir, "AGENTS.md"),
|
|
196
|
+
AGENT_FLEET_CODEX_CONTRACT_IDENTITY: CODEX_CONTRACT_IDENTITY,
|
|
197
|
+
AGENT_FLEET_CONDUCTOR_BACKEND: "codex",
|
|
198
|
+
},
|
|
199
|
+
ratio: 0.35,
|
|
200
|
+
displayText: "Codex control pane; requested systemd state only",
|
|
201
|
+
expectedServiceScope: "agent-fleet-codex-remote-control.service",
|
|
202
|
+
conductorName,
|
|
203
|
+
team,
|
|
204
|
+
};
|
|
205
|
+
}
|
|
206
|
+
|
|
207
|
+
export function teamSnapshotPath(snapshotDir: string, team: string, project = DEFAULT_PROJECT): string {
|
|
208
|
+
validateTeamName(team);
|
|
209
|
+
validateProject(project);
|
|
210
|
+
return project === DEFAULT_PROJECT
|
|
211
|
+
? path.join(snapshotDir, `${team}.json`)
|
|
212
|
+
: path.join(snapshotDir, "projects", project, `${team}.json`);
|
|
213
|
+
}
|
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
// scripts/lib/team-snapshot.ts
|
|
2
|
+
//
|
|
3
|
+
// Pure logic for fleet resume (B5): snapshot a running team (peer manifest +
|
|
4
|
+
// per-peer session resume refs harvested from herdr) and rebuild it later.
|
|
5
|
+
// See docs/plans/herdr/b5-resume-notes.md for the decisions: pane exit closes
|
|
6
|
+
// the pane (nothing to re-attach), layout.export cannot target an unfocused
|
|
7
|
+
// workspace, so snapshots store peers + refs and the grid is regenerated with
|
|
8
|
+
// the same builder team-up uses.
|
|
9
|
+
//
|
|
10
|
+
// No sockets, no fs, no process.exit here — the wiring lives in
|
|
11
|
+
// scripts/team-snapshot.ts.
|
|
12
|
+
|
|
13
|
+
import type { Peer } from "./herdr-layout.ts";
|
|
14
|
+
import { DEFAULT_PROJECT, teamWorkspaceLabel, validateProject, validateTeamName } from "./team-project.ts";
|
|
15
|
+
|
|
16
|
+
// Shape of herdr's agent_session (agent.list): pi panes carry
|
|
17
|
+
// {kind:"path", value:<session .jsonl>}, claude panes {kind:"id", value:<uuid>}.
|
|
18
|
+
export interface ResumeRef {
|
|
19
|
+
kind: string;
|
|
20
|
+
value: string;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
export interface PeerSnapshot extends Peer {
|
|
24
|
+
resume: ResumeRef | null;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export interface TeamSnapshot {
|
|
28
|
+
version: 1;
|
|
29
|
+
team: string;
|
|
30
|
+
project: string;
|
|
31
|
+
hub: boolean;
|
|
32
|
+
workspace_label: string;
|
|
33
|
+
taken_at: string;
|
|
34
|
+
peers: PeerSnapshot[];
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
// Minimal shapes of the herdr responses the builder joins over.
|
|
38
|
+
export interface PaneLite {
|
|
39
|
+
pane_id: string;
|
|
40
|
+
label?: string;
|
|
41
|
+
[key: string]: unknown;
|
|
42
|
+
}
|
|
43
|
+
export interface AgentLite {
|
|
44
|
+
pane_id?: string;
|
|
45
|
+
agent?: string;
|
|
46
|
+
agent_session?: { kind?: string; value?: string };
|
|
47
|
+
[key: string]: unknown;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
// Join: peers.yaml manifest × pane labels (pane label = peer name, set by the
|
|
51
|
+
// layout) × agent sessions (keyed by pane_id). A peer whose pane or session
|
|
52
|
+
// is missing snapshots with resume: null — it will start fresh on resume.
|
|
53
|
+
export function buildSnapshot(opts: {
|
|
54
|
+
team: string;
|
|
55
|
+
hub: boolean;
|
|
56
|
+
peers: Peer[];
|
|
57
|
+
panes: PaneLite[];
|
|
58
|
+
agents: AgentLite[];
|
|
59
|
+
now?: Date;
|
|
60
|
+
project?: string;
|
|
61
|
+
tag?: string;
|
|
62
|
+
}): TeamSnapshot {
|
|
63
|
+
const { team, hub, peers, panes, agents, project = DEFAULT_PROJECT, tag } = opts;
|
|
64
|
+
validateTeamName(team);
|
|
65
|
+
validateProject(project);
|
|
66
|
+
const paneByLabel = new Map<string, string>();
|
|
67
|
+
for (const p of panes) {
|
|
68
|
+
if (p.label) paneByLabel.set(p.label, p.pane_id);
|
|
69
|
+
}
|
|
70
|
+
const sessionByPane = new Map<string, ResumeRef>();
|
|
71
|
+
for (const a of agents) {
|
|
72
|
+
const s = a.agent_session;
|
|
73
|
+
if (a.pane_id && s && typeof s.kind === "string" && typeof s.value === "string") {
|
|
74
|
+
sessionByPane.set(a.pane_id, { kind: s.kind, value: s.value });
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
return {
|
|
78
|
+
version: 1,
|
|
79
|
+
team,
|
|
80
|
+
project,
|
|
81
|
+
hub,
|
|
82
|
+
workspace_label: teamWorkspaceLabel(hub ? "hub" : "peers", team, project, tag),
|
|
83
|
+
taken_at: (opts.now ?? new Date()).toISOString(),
|
|
84
|
+
peers: peers.map((peer) => {
|
|
85
|
+
const paneId = peer.name ? paneByLabel.get(peer.name) : undefined;
|
|
86
|
+
const resume = paneId ? sessionByPane.get(paneId) ?? null : null;
|
|
87
|
+
return { ...peer, resume };
|
|
88
|
+
}),
|
|
89
|
+
};
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
// The resume ref usable by this peer's launch recipe, or undefined to start
|
|
93
|
+
// fresh. `refUsable` is injected (fs check for pi paths); refs of kinds the
|
|
94
|
+
// recipes cannot consume yet (e.g. claude ids before the Phase-4 runner
|
|
95
|
+
// lands) resolve undefined with a reason via `onSkip`.
|
|
96
|
+
export function resumeRefForPeer(
|
|
97
|
+
peer: PeerSnapshot,
|
|
98
|
+
refUsable: (ref: ResumeRef) => boolean,
|
|
99
|
+
onSkip?: (peer: PeerSnapshot, reason: string) => void,
|
|
100
|
+
): string | undefined {
|
|
101
|
+
if (!peer.resume) {
|
|
102
|
+
onSkip?.(peer, "no session ref in snapshot — starting fresh");
|
|
103
|
+
return undefined;
|
|
104
|
+
}
|
|
105
|
+
// pi peers resume by session file path; claude-code peers by session id
|
|
106
|
+
// (herdr reports {kind:"id"} for claude — `claude --resume <id>`).
|
|
107
|
+
const wantKind = peer.runner === "claude-code" ? "id" : "path";
|
|
108
|
+
if (peer.resume.kind !== wantKind) {
|
|
109
|
+
onSkip?.(peer, `unsupported resume kind "${peer.resume.kind}" — starting fresh`);
|
|
110
|
+
return undefined;
|
|
111
|
+
}
|
|
112
|
+
if (!refUsable(peer.resume)) {
|
|
113
|
+
onSkip?.(peer, `session file gone (${peer.resume.value}) — starting fresh`);
|
|
114
|
+
return undefined;
|
|
115
|
+
}
|
|
116
|
+
return peer.resume.value;
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
export function parseSnapshot(raw: string): TeamSnapshot {
|
|
120
|
+
let parsed: unknown;
|
|
121
|
+
try {
|
|
122
|
+
parsed = JSON.parse(raw);
|
|
123
|
+
} catch (err) {
|
|
124
|
+
throw new Error(`Snapshot is not valid JSON: ${err instanceof Error ? err.message : String(err)}`);
|
|
125
|
+
}
|
|
126
|
+
const s = parsed as TeamSnapshot;
|
|
127
|
+
if (!s || s.version !== 1 || typeof s.team !== "string" || !Array.isArray(s.peers)) {
|
|
128
|
+
throw new Error("Snapshot has an unexpected shape (want {version:1, team, peers[]}).");
|
|
129
|
+
}
|
|
130
|
+
validateTeamName(s.team);
|
|
131
|
+
if (!("project" in (s as Record<string, unknown>))) {
|
|
132
|
+
(s as { project: string }).project = DEFAULT_PROJECT;
|
|
133
|
+
} else if (typeof (s as { project?: unknown }).project !== "string") {
|
|
134
|
+
throw new Error("Snapshot has an unexpected shape (project must be a string when present).");
|
|
135
|
+
}
|
|
136
|
+
validateProject(s.project);
|
|
137
|
+
return s;
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
export function assertSnapshotProject(snap: TeamSnapshot, requestedProject: string): void {
|
|
141
|
+
validateProject(requestedProject);
|
|
142
|
+
if (snap.project !== requestedProject) {
|
|
143
|
+
throw new Error(
|
|
144
|
+
`Snapshot project mismatch: snapshot is ${JSON.stringify(snap.project)}, requested ${JSON.stringify(requestedProject)}.`,
|
|
145
|
+
);
|
|
146
|
+
}
|
|
147
|
+
}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
// scripts/peer-banner.ts
|
|
2
|
+
//
|
|
3
|
+
// Print a colored identity banner for a peer pane. Called by the hidden
|
|
4
|
+
// `just _peer`/`_peer-plus` recipes right before exec'ing pi, so every pane
|
|
5
|
+
// announces who lives in it. Never fails the recipe: any problem (missing
|
|
6
|
+
// persona, unreadable file) degrades to a plain banner and exit 0.
|
|
7
|
+
//
|
|
8
|
+
// usage: peer-banner.ts <persona> [<name>]
|
|
9
|
+
|
|
10
|
+
import * as fs from "node:fs";
|
|
11
|
+
import * as path from "node:path";
|
|
12
|
+
import { fileURLToPath } from "node:url";
|
|
13
|
+
|
|
14
|
+
import { parsePersonaFrontmatter, renderBanner } from "./lib/persona-banner.ts";
|
|
15
|
+
|
|
16
|
+
const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
|
|
17
|
+
const REPO_ROOT = path.resolve(SCRIPT_DIR, "..");
|
|
18
|
+
|
|
19
|
+
function main(): void {
|
|
20
|
+
const [persona, nameArg] = process.argv.slice(2);
|
|
21
|
+
if (!persona) return;
|
|
22
|
+
const name = nameArg || persona;
|
|
23
|
+
|
|
24
|
+
let meta = {};
|
|
25
|
+
for (const dir of ["agents", path.join(".pi", "agents")]) {
|
|
26
|
+
const p = path.join(REPO_ROOT, dir, `${persona}.md`);
|
|
27
|
+
try {
|
|
28
|
+
meta = parsePersonaFrontmatter(fs.readFileSync(p, "utf-8"));
|
|
29
|
+
break;
|
|
30
|
+
} catch {
|
|
31
|
+
// try the next location; fall through to a plain banner
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
const width = process.stdout.columns ? Math.min(process.stdout.columns, 100) : 60;
|
|
36
|
+
for (const line of renderBanner(name, meta, width)) console.log(line);
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
const isEntry = process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
|
|
40
|
+
if (isEntry) main();
|
|
@@ -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();
|