@chankov/agent-fleet 0.0.8 → 0.0.9
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/model-profiles.yaml +9 -2
- package/.pi/agents/peers.yaml +12 -16
- package/.pi/agents/teams.yaml +4 -2
- package/.pi/harnesses/agent-hub/README.md +20 -5
- package/.pi/harnesses/agent-hub/footer.ts +4 -2
- package/.pi/harnesses/agent-hub/index.ts +104 -11
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/version.ts +25 -1
- package/.pi/harnesses/coms/README.md +8 -1
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/coms/version.ts +25 -1
- package/.pi/harnesses/damage-control-continue/README.md +8 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/version.ts +25 -1
- package/.pi/harnesses/lib/herdr-client.ts +10 -1
- package/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/0.0.9/.claude/commands/build.md +44 -0
- package/.versions/0.0.9/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.9/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.9/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.9/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.9/.claude/commands/plan.md +16 -0
- package/.versions/0.0.9/.claude/commands/prime.md +22 -0
- package/.versions/0.0.9/.claude/commands/review.md +16 -0
- package/.versions/0.0.9/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.9/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.versions/0.0.9/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.9/.claude/commands/ship.md +72 -0
- package/.versions/0.0.9/.claude/commands/spec.md +15 -0
- package/.versions/0.0.9/.claude/commands/test.md +19 -0
- package/.versions/0.0.9/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.9/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.9/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.9/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.9/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.9/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.9/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.9/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.9/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.9/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.9/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.9/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.9/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.9/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.9/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.9/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.9/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.9/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.9/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.9/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.9/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/0.0.9/.pi/agents/peers.yaml +142 -0
- package/.versions/0.0.9/.pi/agents/teams.yaml +41 -0
- package/.versions/0.0.9/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.9/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.9/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.9/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.9/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.9/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.9/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.9/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.9/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.9/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.9/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.9/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.9/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.9/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.9/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.9/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.9/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.9/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.9/.pi/extensions/package.json +9 -0
- package/.versions/0.0.9/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.9/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.9/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.9/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.9/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.9/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.9/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/README.md +872 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/footer.ts +31 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/helpers.ts +248 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/index.ts +8702 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/run-budget.js +181 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/0.0.9/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.9/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.9/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.9/.pi/harnesses/coms/README.md +100 -0
- package/.versions/0.0.9/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/0.0.9/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.9/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/0.0.9/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/0.0.9/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.9/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.9/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/0.0.9/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/0.0.9/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.9/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/0.0.9/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.9/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/0.0.9/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.9/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.9/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.9/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.9/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.9/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.9/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.9/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.9/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.9/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.9/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.9/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.9/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.9/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.9/.version +1 -0
- package/.versions/0.0.9/agents/architect.md +24 -0
- package/.versions/0.0.9/agents/bowser.md +27 -0
- package/.versions/0.0.9/agents/builder.md +54 -0
- package/.versions/0.0.9/agents/code-reviewer.md +204 -0
- package/.versions/0.0.9/agents/deep-researcher.md +32 -0
- package/.versions/0.0.9/agents/documenter.md +18 -0
- package/.versions/0.0.9/agents/orchestrator.md +66 -0
- package/.versions/0.0.9/agents/plan-reviewer.md +62 -0
- package/.versions/0.0.9/agents/planner.md +70 -0
- package/.versions/0.0.9/agents/releaser.md +24 -0
- package/.versions/0.0.9/agents/researcher.md +28 -0
- package/.versions/0.0.9/agents/security-auditor.md +167 -0
- package/.versions/0.0.9/agents/test-engineer.md +153 -0
- package/.versions/0.0.9/agents/web-debugger.md +43 -0
- package/.versions/0.0.9/agents/web-performance-auditor.md +193 -0
- package/.versions/0.0.9/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.9/docs/ARCHITECTURE.md +262 -0
- package/.versions/0.0.9/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.9/docs/claude-code-coms-bridge.md +109 -0
- package/.versions/0.0.9/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.9/docs/coms-hermes-bridge.md +189 -0
- package/.versions/0.0.9/docs/getting-started.md +231 -0
- package/.versions/0.0.9/docs/npm-install.md +337 -0
- package/.versions/0.0.9/docs/opencode-setup.md +249 -0
- package/.versions/0.0.9/docs/pi-extensions.md +356 -0
- package/.versions/0.0.9/docs/pi-setup.md +476 -0
- package/.versions/0.0.9/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.9/hermes/README.md +347 -0
- package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.9/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/0.0.9/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.9/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.9/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/0.0.9/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/0.0.9/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.9/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/0.0.9/hooks/hooks.json +14 -0
- package/.versions/0.0.9/hooks/session-start.sh +74 -0
- package/.versions/0.0.9/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.9/justfile +254 -0
- package/.versions/0.0.9/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.9/references/definition-of-done.md +67 -0
- package/.versions/0.0.9/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.9/references/observability-checklist.md +91 -0
- package/.versions/0.0.9/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.9/references/performance-checklist.md +153 -0
- package/.versions/0.0.9/references/prompting-patterns.md +380 -0
- package/.versions/0.0.9/references/security-checklist.md +179 -0
- package/.versions/0.0.9/references/testing-patterns.md +236 -0
- package/.versions/0.0.9/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.9/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.9/scripts/coms-claude-bridge.ts +401 -0
- package/.versions/0.0.9/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.9/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.9/scripts/fleet.ts +168 -0
- package/.versions/0.0.9/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.9/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/0.0.9/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/0.0.9/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/0.0.9/scripts/lib/claude-bridge-core.ts +165 -0
- package/.versions/0.0.9/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.9/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.9/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/0.0.9/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.9/scripts/lib/fleet-command.ts +111 -0
- package/.versions/0.0.9/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/0.0.9/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.9/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/0.0.9/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.9/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.9/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.9/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.9/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.9/scripts/lib/monitor-env.ts +120 -0
- package/.versions/0.0.9/scripts/lib/peer-launch.ts +314 -0
- package/.versions/0.0.9/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.9/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.9/scripts/lib/team-project.ts +193 -0
- package/.versions/0.0.9/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.9/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.9/scripts/peer-launch.ts +259 -0
- package/.versions/0.0.9/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.9/scripts/team-up.ts +360 -0
- package/.versions/0.0.9/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.9/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.9/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.9/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.9/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.9/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.9/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.9/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.9/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.9/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.9/skills/guided-workspace-setup/SKILL.md +544 -0
- package/.versions/0.0.9/skills/guided-workspace-setup/companion-manifest.json +38 -0
- package/.versions/0.0.9/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.9/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.9/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.9/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.9/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.9/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.9/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.9/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.9/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.9/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.9/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.9/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.9/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.9/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.9/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +38 -0
- package/agents/architect.md +1 -0
- package/agents/bowser.md +1 -0
- package/agents/builder.md +1 -0
- package/agents/code-reviewer.md +4 -5
- package/agents/deep-researcher.md +2 -1
- package/agents/orchestrator.md +1 -0
- package/agents/plan-reviewer.md +3 -1
- package/agents/planner.md +3 -2
- package/agents/security-auditor.md +1 -0
- package/agents/test-engineer.md +3 -1
- package/agents/web-debugger.md +1 -0
- package/agents/web-performance-auditor.md +1 -0
- package/docs/ARCHITECTURE.md +1 -1
- package/docs/pi-extensions.md +66 -3
- package/justfile +10 -1
- package/package.json +2 -2
- package/scripts/fleet.ts +22 -3
- package/scripts/lib/fleet-command.ts +5 -3
- package/scripts/lib/herdr-layout.ts +18 -0
- package/scripts/lib/peer-launch.ts +314 -0
- package/scripts/lib/team-project.ts +3 -1
- package/scripts/peer-launch.ts +259 -0
- package/skills/guided-workspace-setup/companion-manifest.json +2 -0
- package/.pi/harnesses/agent-hub/spawned-peers.js +0 -74
|
@@ -81,6 +81,24 @@ export function parsePeersYaml(raw: string): Record<string, Peer[]> {
|
|
|
81
81
|
return teams;
|
|
82
82
|
}
|
|
83
83
|
|
|
84
|
+
/**
|
|
85
|
+
* The peers.yaml declaration for a peer name, searched across every team
|
|
86
|
+
* (first match wins; the same name in two teams is the same peer). Used by
|
|
87
|
+
* one-off spawns that are handed only a name — without this they would ignore
|
|
88
|
+
* `runner:`/`extensions:`/`env_file:` and launch a bare pi peer under a name
|
|
89
|
+
* the fleet defines as something else (e.g. a `runner: claude-code` reviewer).
|
|
90
|
+
*/
|
|
91
|
+
export function findPeerByName(teams: Record<string, Peer[]>, name: string): Peer | undefined {
|
|
92
|
+
const wanted = String(name ?? "").toLowerCase();
|
|
93
|
+
if (!wanted) return undefined;
|
|
94
|
+
for (const peers of Object.values(teams)) {
|
|
95
|
+
for (const peer of peers) {
|
|
96
|
+
if (String(peer.name ?? "").toLowerCase() === wanted) return peer;
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
return undefined;
|
|
100
|
+
}
|
|
101
|
+
|
|
84
102
|
// Validate a peer's fields and build its launch argv. `just` recipe params are
|
|
85
103
|
// POSITIONAL (persona name model session) — bare positional args, never
|
|
86
104
|
// key=value. A peer with `extensions:` routes through `_peer-plus
|
|
@@ -0,0 +1,314 @@
|
|
|
1
|
+
// scripts/lib/peer-launch.ts
|
|
2
|
+
//
|
|
3
|
+
// Pure logic for `just fleet peer <name>` — ONE addressable coms peer, in its
|
|
4
|
+
// own herdr pane by default, with no peers.yaml team involved.
|
|
5
|
+
//
|
|
6
|
+
// One verb, three shapes of peer, two placements:
|
|
7
|
+
//
|
|
8
|
+
// runner: claude-code → `just _claude-peer …` (Claude + its coms bridge)
|
|
9
|
+
// runner: pi, persona resolved → `just _peer[-plus] …` (guarded reusable persona peer)
|
|
10
|
+
// runner: pi, no persona → `just _fleet-peer …` (Fleet Core + coms, no persona)
|
|
11
|
+
//
|
|
12
|
+
// default → the command runs in a pane of its own
|
|
13
|
+
// --here → the command takes over the CALLING terminal
|
|
14
|
+
//
|
|
15
|
+
// The third shape is what `just fleet peer <name>` meant before pane placement
|
|
16
|
+
// existed, so `--here` reproduces the old behavior exactly while the same
|
|
17
|
+
// invocation without it now opens a pane.
|
|
18
|
+
//
|
|
19
|
+
// Resolution order for every field: explicit CLI flag → the peers.yaml
|
|
20
|
+
// declaration for that NAME (searched across all teams, see findPeerByName) →
|
|
21
|
+
// a convention default. So `just fleet peer code-reviewer` gets the
|
|
22
|
+
// `runner: claude-code` the fleet declares, and `--runner claude-code` needs no
|
|
23
|
+
// manifest entry at all.
|
|
24
|
+
//
|
|
25
|
+
// No sockets, no process.exit, no fs — callers supply the manifest text and a
|
|
26
|
+
// persona-existence probe, and every failure is a plain Error.
|
|
27
|
+
|
|
28
|
+
import { findPeerByName, parsePeersYaml, peerCommand, type Peer } from "./herdr-layout.ts";
|
|
29
|
+
import { DEFAULT_PROJECT, teamWorkspaceLabel, validateProject } from "./team-project.ts";
|
|
30
|
+
|
|
31
|
+
/** Synthetic team name used in peerCommand errors for a peer that has no team. */
|
|
32
|
+
export const ADHOC_TEAM = "ad-hoc";
|
|
33
|
+
|
|
34
|
+
/** The extension `--browser` adds to a pi persona peer (the `_peer-plus` route). */
|
|
35
|
+
export const BROWSER_EXTENSION = "chrome-devtools-mcp";
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* Pane label + coms identity charset. Stricter than herdr-layout's SAFE, which
|
|
39
|
+
* also permits `.`, `/` and `,` — fine inside a model spec, wrong for a name
|
|
40
|
+
* that becomes a pane label, a workspace label segment, and a coms address.
|
|
41
|
+
*/
|
|
42
|
+
export const PEER_NAME_SAFE = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
|
|
43
|
+
|
|
44
|
+
export type PeerRunner = "pi" | "claude-code";
|
|
45
|
+
/** Which hidden recipe launches this peer — see the header table. */
|
|
46
|
+
export type PeerKind = "persona-peer" | "core-peer" | "claude-peer";
|
|
47
|
+
|
|
48
|
+
export interface PeerLaunchOptions {
|
|
49
|
+
name: string;
|
|
50
|
+
/** --runner; omit to inherit the peers.yaml declaration, else defaults to pi. */
|
|
51
|
+
runner?: string;
|
|
52
|
+
/** --persona; omit to inherit the declaration, else the same-named persona. */
|
|
53
|
+
persona?: string;
|
|
54
|
+
/**
|
|
55
|
+
* --no-persona: force the identity-only Fleet Core peer even when the name
|
|
56
|
+
* resolves to a persona. The escape hatch for raw pi arguments and
|
|
57
|
+
* --all-extensions under a name that happens to match `agents/<name>.md`.
|
|
58
|
+
*/
|
|
59
|
+
noPersona?: boolean;
|
|
60
|
+
model?: string;
|
|
61
|
+
project?: string;
|
|
62
|
+
extensions?: string;
|
|
63
|
+
/** --browser: an extra extension for a persona peer, a capability flag for a core peer. */
|
|
64
|
+
browser?: boolean;
|
|
65
|
+
/** --all-extensions: core peers only — persona peers are deliberately deterministic. */
|
|
66
|
+
allExtensions?: boolean;
|
|
67
|
+
/** Raw pi arguments after `--`; core peers only. */
|
|
68
|
+
piArgs?: string[];
|
|
69
|
+
direction?: "right" | "down";
|
|
70
|
+
/** --here: run in the calling terminal instead of a pane. */
|
|
71
|
+
here?: boolean;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
export interface PeerLaunchContext {
|
|
75
|
+
/** Raw .pi/agents/peers.yaml, or "" when the repo has none. */
|
|
76
|
+
peersYaml: string;
|
|
77
|
+
/** True when `agents/<persona>.md` or `.pi/agents/<persona>.md` exists. */
|
|
78
|
+
personaExists(persona: string): boolean;
|
|
79
|
+
/** worktreeTag(REPO_ROOT) — scopes the standalone workspace label. */
|
|
80
|
+
worktreeTag: string;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
export interface PeerLaunchPlan {
|
|
84
|
+
name: string;
|
|
85
|
+
runner: PeerRunner;
|
|
86
|
+
kind: PeerKind;
|
|
87
|
+
persona?: string;
|
|
88
|
+
model?: string;
|
|
89
|
+
extensions?: string;
|
|
90
|
+
/** Repo-relative env_file inherited from the declaration, if any. */
|
|
91
|
+
envFile?: string;
|
|
92
|
+
project: string;
|
|
93
|
+
/** argv for the pane (or for this terminal under --here). */
|
|
94
|
+
command: string[];
|
|
95
|
+
placement: "pane" | "here";
|
|
96
|
+
direction: "right" | "down";
|
|
97
|
+
/** Workspace label used only when launching a pane outside a herdr pane. */
|
|
98
|
+
workspaceLabel: string;
|
|
99
|
+
/** True when peers.yaml declares this name (its fields seeded the plan). */
|
|
100
|
+
declared: boolean;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
function validateName(name: string): string {
|
|
104
|
+
if (!PEER_NAME_SAFE.test(name)) {
|
|
105
|
+
throw new Error(
|
|
106
|
+
`Invalid peer name: ${JSON.stringify(name)} (letters, numbers, underscores and hyphens; must start alphanumeric)`,
|
|
107
|
+
);
|
|
108
|
+
}
|
|
109
|
+
return name;
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
function normalizeRunner(runner: string | undefined, source: string): PeerRunner | undefined {
|
|
113
|
+
if (runner === undefined) return undefined;
|
|
114
|
+
if (runner === "pi" || runner === "claude-code") return runner;
|
|
115
|
+
throw new Error(`Unknown runner ${JSON.stringify(runner)} from ${source} (supported: pi, claude-code)`);
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
function mergeExtensions(...values: (string | undefined)[]): string | undefined {
|
|
119
|
+
const names = values
|
|
120
|
+
.flatMap((v) => (v ?? "").split(","))
|
|
121
|
+
.map((v) => v.trim())
|
|
122
|
+
.filter((v) => v !== "");
|
|
123
|
+
return names.length > 0 ? [...new Set(names)].join(",") : undefined;
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
/**
|
|
127
|
+
* The pre-pane-placement `just fleet peer <name>` command: Fleet Core + coms
|
|
128
|
+
* under the given identity, with no persona and arbitrary pi arguments. Its
|
|
129
|
+
* positionals are `<name> <browser> <all_extensions>` followed by raw pi args,
|
|
130
|
+
* so `--project` travels as an ordinary pi flag rather than a placeholder slot.
|
|
131
|
+
*/
|
|
132
|
+
function corePeerCommand(name: string, opts: PeerLaunchOptions, project: string): string[] {
|
|
133
|
+
const command = ["just", "_fleet-peer", name, opts.browser ? "true" : "false", opts.allExtensions ? "true" : "false"];
|
|
134
|
+
if (project !== DEFAULT_PROJECT) command.push("--project", project);
|
|
135
|
+
for (const arg of opts.piArgs ?? []) {
|
|
136
|
+
// A pane launch types this argv at a shell prompt one line at a time, so
|
|
137
|
+
// an embedded newline would execute half of it as a separate command.
|
|
138
|
+
if (/[\r\n]/.test(arg)) throw new Error(`pi argument contains a line break: ${JSON.stringify(arg)}`);
|
|
139
|
+
command.push(arg);
|
|
140
|
+
}
|
|
141
|
+
return command;
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
/**
|
|
145
|
+
* Merge CLI options with the peers.yaml declaration for the same name and
|
|
146
|
+
* produce the launch argv. Nothing is silently dropped: a flag that cannot
|
|
147
|
+
* apply to the resolved runner is an error, not a no-op.
|
|
148
|
+
*/
|
|
149
|
+
export function buildPeerLaunchPlan(opts: PeerLaunchOptions, ctx: PeerLaunchContext): PeerLaunchPlan {
|
|
150
|
+
const name = validateName(opts.name);
|
|
151
|
+
const project = validateProject(opts.project ?? DEFAULT_PROJECT);
|
|
152
|
+
const teams = ctx.peersYaml ? parsePeersYaml(ctx.peersYaml) : {};
|
|
153
|
+
const declared: Peer | undefined = findPeerByName(teams, name);
|
|
154
|
+
|
|
155
|
+
const runner =
|
|
156
|
+
normalizeRunner(opts.runner, "--runner") ??
|
|
157
|
+
normalizeRunner(declared?.runner, `peers.yaml peer "${name}"`) ??
|
|
158
|
+
"pi";
|
|
159
|
+
|
|
160
|
+
const model = opts.model ?? declared?.model;
|
|
161
|
+
const common = {
|
|
162
|
+
name,
|
|
163
|
+
runner,
|
|
164
|
+
...(model ? { model } : {}),
|
|
165
|
+
...(declared?.env_file ? { envFile: declared.env_file } : {}),
|
|
166
|
+
project,
|
|
167
|
+
placement: (opts.here ? "here" : "pane") as "here" | "pane",
|
|
168
|
+
direction: opts.direction ?? ("right" as const),
|
|
169
|
+
workspaceLabel: teamWorkspaceLabel("peer", name, project, ctx.worktreeTag),
|
|
170
|
+
declared: declared !== undefined,
|
|
171
|
+
};
|
|
172
|
+
|
|
173
|
+
if (runner === "claude-code") {
|
|
174
|
+
if (opts.persona) throw new Error("--persona is pi-only; a claude-code peer carries no pi persona.");
|
|
175
|
+
if (opts.extensions || opts.browser || opts.allExtensions) {
|
|
176
|
+
throw new Error("--extensions/--browser/--all-extensions are pi-only and cannot combine with --runner claude-code.");
|
|
177
|
+
}
|
|
178
|
+
if (opts.piArgs?.length) throw new Error("arguments after `--` are pi arguments and cannot combine with --runner claude-code.");
|
|
179
|
+
return {
|
|
180
|
+
...common,
|
|
181
|
+
kind: "claude-peer",
|
|
182
|
+
command: peerCommand({ name, ...(model ? { model } : {}), runner }, ADHOC_TEAM, undefined, project),
|
|
183
|
+
};
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
if (opts.noPersona && opts.persona) throw new Error("--no-persona and --persona are contradictory.");
|
|
187
|
+
const persona = opts.noPersona
|
|
188
|
+
? undefined
|
|
189
|
+
: opts.persona ?? declared?.persona ?? (ctx.personaExists(name) ? name : undefined);
|
|
190
|
+
|
|
191
|
+
// No persona anywhere → the identity-only Fleet Core peer, which is exactly
|
|
192
|
+
// what this command did before pane placement existed. Not an error: it is
|
|
193
|
+
// the third shape of peer, and the only one that takes raw pi arguments.
|
|
194
|
+
if (!persona) {
|
|
195
|
+
if (opts.extensions) {
|
|
196
|
+
throw new Error(
|
|
197
|
+
`--extensions needs a persona peer. Pass --persona <name>, add agents/${name}.md, ` +
|
|
198
|
+
"or use --all-extensions / raw pi flags after `--`.",
|
|
199
|
+
);
|
|
200
|
+
}
|
|
201
|
+
return { ...common, kind: "core-peer", command: corePeerCommand(name, opts, project) };
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
if (!ctx.personaExists(persona)) throw new Error(`Persona "${persona}" not found under agents/ or .pi/agents/.`);
|
|
205
|
+
if (opts.allExtensions) {
|
|
206
|
+
throw new Error(
|
|
207
|
+
`--all-extensions is not available to persona peer "${name}": reusable peers load a deterministic set. ` +
|
|
208
|
+
"Use --extensions <names>, declare extensions: in .pi/agents/peers.yaml, or --no-persona for a plain Fleet Core peer.",
|
|
209
|
+
);
|
|
210
|
+
}
|
|
211
|
+
if (opts.piArgs?.length) {
|
|
212
|
+
throw new Error(
|
|
213
|
+
`arguments after \`--\` need a personaless core peer; persona peer "${name}" builds its own pi command line. ` +
|
|
214
|
+
`Add --no-persona to launch "${name}" as a plain Fleet Core peer instead.`,
|
|
215
|
+
);
|
|
216
|
+
}
|
|
217
|
+
const extensions = mergeExtensions(opts.extensions ?? declared?.extensions, opts.browser ? BROWSER_EXTENSION : undefined);
|
|
218
|
+
|
|
219
|
+
return {
|
|
220
|
+
...common,
|
|
221
|
+
kind: "persona-peer",
|
|
222
|
+
persona,
|
|
223
|
+
...(extensions ? { extensions } : {}),
|
|
224
|
+
command: peerCommand(
|
|
225
|
+
{ name, persona, ...(model ? { model } : {}), ...(extensions ? { extensions } : {}) },
|
|
226
|
+
ADHOC_TEAM,
|
|
227
|
+
undefined,
|
|
228
|
+
project,
|
|
229
|
+
),
|
|
230
|
+
};
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
export interface ParsedPeerArgs extends PeerLaunchOptions {
|
|
234
|
+
dryRun: boolean;
|
|
235
|
+
/** --peers: alternate manifest path (tests use it). */
|
|
236
|
+
peersYaml?: string;
|
|
237
|
+
}
|
|
238
|
+
|
|
239
|
+
function takeValue(argv: string[], i: number, flag: string): string {
|
|
240
|
+
const value = argv[i + 1];
|
|
241
|
+
if (value === undefined || value.startsWith("--")) throw new Error(`${flag} requires a value`);
|
|
242
|
+
return value;
|
|
243
|
+
}
|
|
244
|
+
|
|
245
|
+
/**
|
|
246
|
+
* `<name> [--runner r] [--persona p|--no-persona] [--model m] [--project p]
|
|
247
|
+
* [--extensions a,b] [--browser] [--all-extensions] [--direction right|down]
|
|
248
|
+
* [--here] [--dry-run] [--peers path] [-- PI_ARGS…]`
|
|
249
|
+
*
|
|
250
|
+
* The peer name is the only positional and everything after `--` goes to pi
|
|
251
|
+
* verbatim. An unrecognized flag BEFORE `--` is an error rather than silently
|
|
252
|
+
* dropped argv — the failure mode `project=af` already taught this fleet about.
|
|
253
|
+
*/
|
|
254
|
+
export function parsePeerArgs(argv: string[]): ParsedPeerArgs {
|
|
255
|
+
const out: ParsedPeerArgs = { name: "", dryRun: false };
|
|
256
|
+
let name: string | undefined;
|
|
257
|
+
for (let i = 0; i < argv.length; i++) {
|
|
258
|
+
const arg = argv[i];
|
|
259
|
+
if (arg === "--") {
|
|
260
|
+
out.piArgs = argv.slice(i + 1);
|
|
261
|
+
break;
|
|
262
|
+
}
|
|
263
|
+
switch (arg) {
|
|
264
|
+
case "--dry-run":
|
|
265
|
+
out.dryRun = true;
|
|
266
|
+
break;
|
|
267
|
+
case "--here":
|
|
268
|
+
out.here = true;
|
|
269
|
+
break;
|
|
270
|
+
case "--browser":
|
|
271
|
+
out.browser = true;
|
|
272
|
+
break;
|
|
273
|
+
case "--all-extensions":
|
|
274
|
+
out.allExtensions = true;
|
|
275
|
+
break;
|
|
276
|
+
case "--runner":
|
|
277
|
+
out.runner = takeValue(argv, i++, arg);
|
|
278
|
+
break;
|
|
279
|
+
case "--persona":
|
|
280
|
+
out.persona = takeValue(argv, i++, arg);
|
|
281
|
+
break;
|
|
282
|
+
case "--no-persona":
|
|
283
|
+
out.noPersona = true;
|
|
284
|
+
break;
|
|
285
|
+
case "--model":
|
|
286
|
+
out.model = takeValue(argv, i++, arg);
|
|
287
|
+
break;
|
|
288
|
+
case "--project":
|
|
289
|
+
out.project = takeValue(argv, i++, arg);
|
|
290
|
+
break;
|
|
291
|
+
case "--extensions":
|
|
292
|
+
out.extensions = takeValue(argv, i++, arg);
|
|
293
|
+
break;
|
|
294
|
+
case "--peers":
|
|
295
|
+
out.peersYaml = takeValue(argv, i++, arg);
|
|
296
|
+
break;
|
|
297
|
+
case "--direction": {
|
|
298
|
+
const value = takeValue(argv, i++, arg);
|
|
299
|
+
if (value !== "right" && value !== "down") throw new Error(`--direction expects right or down, got ${JSON.stringify(value)}`);
|
|
300
|
+
out.direction = value;
|
|
301
|
+
break;
|
|
302
|
+
}
|
|
303
|
+
default:
|
|
304
|
+
if (arg.startsWith("-")) {
|
|
305
|
+
throw new Error(`Unknown flag: ${arg} — pass pi flags after \`--\` (e.g. just fleet peer ${name ?? "<name>"} -- ${arg})`);
|
|
306
|
+
}
|
|
307
|
+
if (name !== undefined) throw new Error(`fleet peer takes one peer name, got ${JSON.stringify(name)} and ${JSON.stringify(arg)}`);
|
|
308
|
+
name = arg;
|
|
309
|
+
}
|
|
310
|
+
}
|
|
311
|
+
if (!name) throw new Error("fleet peer requires a peer name");
|
|
312
|
+
out.name = name;
|
|
313
|
+
return out;
|
|
314
|
+
}
|
|
@@ -18,7 +18,9 @@ export const CODEX_CONTRACT_IDENTITY = "agent-fleet-codex-conductor-pilot-v1";
|
|
|
18
18
|
export const DEFAULT_CODEX_TIMEOUT_MS = 300_000;
|
|
19
19
|
|
|
20
20
|
export type ConductorBackend = "hermes" | "codex";
|
|
21
|
-
|
|
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";
|
|
22
24
|
|
|
23
25
|
export interface ConductorSpec {
|
|
24
26
|
backend: ConductorBackend;
|
|
@@ -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();
|
|
@@ -18,6 +18,7 @@
|
|
|
18
18
|
"scripts/coms-hermes-bridge.ts",
|
|
19
19
|
"scripts/fleet.ts",
|
|
20
20
|
"scripts/peer-banner.ts",
|
|
21
|
+
"scripts/peer-launch.ts",
|
|
21
22
|
"scripts/team-snapshot.ts",
|
|
22
23
|
"scripts/team-up.ts",
|
|
23
24
|
"scripts/lib/claude-bridge-core.ts",
|
|
@@ -28,6 +29,7 @@
|
|
|
28
29
|
"scripts/lib/herdr-layout.ts",
|
|
29
30
|
"scripts/lib/hermes-bridge-core.ts",
|
|
30
31
|
"scripts/lib/monitor-env.ts",
|
|
32
|
+
"scripts/lib/peer-launch.ts",
|
|
31
33
|
"scripts/lib/persona-banner.ts",
|
|
32
34
|
"scripts/lib/spawn-stagger.ts",
|
|
33
35
|
"scripts/lib/team-project.ts",
|