@chankov/agent-fleet 0.0.11 → 1.0.1
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 +2 -2
- package/.pi/extensions/agent-fleet-update-check/README.md +4 -4
- package/.pi/extensions/btw/README.md +26 -25
- package/.pi/extensions/btw/index.ts +80 -83
- package/.pi/extensions/pi-voice-stt/README.md +4 -3
- package/.pi/extensions/pi-voice-stt/config.ts +1 -1
- package/.pi/harnesses/agent-hub/README.md +118 -57
- package/.pi/harnesses/agent-hub/backend-policy.js +25 -4
- package/.pi/harnesses/agent-hub/footer.ts +4 -0
- package/.pi/harnesses/agent-hub/helpers.ts +18 -0
- package/.pi/harnesses/agent-hub/hub-state-audit.js +55 -0
- package/.pi/harnesses/agent-hub/index.ts +657 -425
- package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +10 -1
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.pi/harnesses/agent-hub/posture.ts +103 -0
- package/.pi/harnesses/agent-hub/run-budget.js +61 -0
- package/.pi/harnesses/ask-user-remote/README.md +37 -3
- package/.pi/harnesses/ask-user-remote/index.ts +173 -17
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
- package/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
- package/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
- package/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.pi/harnesses/package-lock.json +2011 -0
- package/.pi/harnesses/package.json +1 -0
- package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/README.md +4 -4
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/README.md +4 -3
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/config.ts +1 -1
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +10 -1
- package/.versions/0.0.11/.pi/harnesses/ask-user-remote/README.md +37 -3
- package/.versions/0.0.11/.pi/harnesses/ask-user-remote/index.ts +173 -17
- package/.versions/0.0.11/.pi/harnesses/package-lock.json +2011 -0
- package/.versions/0.0.11/.pi/harnesses/package.json +1 -0
- package/.versions/0.0.11/docs/ARCHITECTURE.md +6 -8
- package/.versions/0.0.11/docs/agent-fleet-setup.md +17 -43
- package/.versions/0.0.11/docs/claude-code-coms-bridge.md +20 -2
- package/.versions/0.0.11/docs/coms-hermes-bridge.md +1 -1
- package/.versions/0.0.11/docs/getting-started.md +26 -237
- package/.versions/0.0.11/docs/npm-install.md +60 -478
- package/.versions/0.0.11/docs/pi-extensions.md +4 -4
- package/.versions/0.0.11/docs/pi-setup.md +37 -551
- package/.versions/0.0.11/hermes/README.md +1 -1
- package/.versions/0.0.11/install-manifest.json +375 -1247
- package/.versions/0.0.11/justfile +13 -6
- package/.versions/0.0.11/manifest-meta.json +543 -134
- package/.versions/0.0.11/scripts/lib/fleet-command.ts +8 -0
- package/.versions/0.0.11/scripts/lib/monitor-env.ts +18 -6
- package/.versions/0.0.11/skills/designing-agents/SKILL.md +1 -1
- package/.versions/0.0.11/skills/designing-agents/pi-harness-authoring.md +1 -1
- package/.versions/1.0.0/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/1.0.0/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/1.0.0/.pi/agents/peers.yaml +142 -0
- package/.versions/1.0.0/.pi/agents/teams.yaml +41 -0
- package/.versions/1.0.0/.pi/damage-control-rules.yaml +297 -0
- package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/1.0.0/.pi/extensions/btw/README.md +120 -0
- package/.versions/1.0.0/.pi/extensions/btw/index.ts +914 -0
- package/.versions/1.0.0/.pi/extensions/btw/package.json +6 -0
- package/.versions/1.0.0/.pi/extensions/btw/state.js +179 -0
- package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/1.0.0/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/1.0.0/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/1.0.0/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/1.0.0/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/1.0.0/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/1.0.0/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/1.0.0/.pi/extensions/package-lock.json +1143 -0
- package/.versions/1.0.0/.pi/extensions/package.json +9 -0
- package/.versions/1.0.0/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/1.0.0/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/1.0.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/1.0.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/1.0.0/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/1.0.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/1.0.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/README.md +1056 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/footer.ts +35 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/index.ts +9279 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/posture.ts +103 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/run-budget.js +479 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/1.0.0/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/1.0.0/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/1.0.0/.pi/harnesses/ask-user-remote/index.ts +477 -0
- package/.versions/1.0.0/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/1.0.0/.pi/harnesses/coms/README.md +100 -0
- package/.versions/1.0.0/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/1.0.0/.pi/harnesses/coms/package.json +7 -0
- package/.versions/1.0.0/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/1.0.0/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/1.0.0/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/1.0.0/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/1.0.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/1.0.0/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/1.0.0/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/1.0.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +118 -0
- package/.versions/1.0.0/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
- package/.versions/1.0.0/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
- package/.versions/1.0.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/1.0.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/1.0.0/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/1.0.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/1.0.0/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/1.0.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/1.0.0/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/1.0.0/.pi/harnesses/package-lock.json +2046 -0
- package/.versions/1.0.0/.pi/harnesses/package.json +10 -0
- package/.versions/1.0.0/.pi/prompts/af-build.md +24 -0
- package/{.claude/commands/code-simplify.md → .versions/1.0.0/.pi/prompts/af-code-simplify.md} +3 -3
- package/{.claude/commands/plan.md → .versions/1.0.0/.pi/prompts/af-plan.md} +1 -1
- package/.versions/{0.0.11/.claude/commands/review.md → 1.0.0/.pi/prompts/af-review.md} +3 -3
- package/.versions/1.0.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/1.0.0/.pi/prompts/af-ship.md +17 -0
- package/.versions/{0.0.11/.claude/commands/spec.md → 1.0.0/.pi/prompts/af-spec.md} +1 -1
- package/.versions/{0.0.11/.claude/commands/test.md → 1.0.0/.pi/prompts/af-test.md} +2 -2
- package/.versions/1.0.0/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/1.0.0/.version +1 -0
- package/.versions/1.0.0/agents/architect.md +24 -0
- package/.versions/1.0.0/agents/bowser.md +27 -0
- package/.versions/1.0.0/agents/builder.md +54 -0
- package/.versions/1.0.0/agents/code-reviewer.md +208 -0
- package/.versions/1.0.0/agents/deep-researcher.md +32 -0
- package/.versions/1.0.0/agents/documenter.md +18 -0
- package/.versions/1.0.0/agents/orchestrator.md +72 -0
- package/.versions/1.0.0/agents/plan-reviewer.md +83 -0
- package/.versions/1.0.0/agents/planner.md +70 -0
- package/.versions/1.0.0/agents/releaser.md +24 -0
- package/.versions/1.0.0/agents/researcher.md +28 -0
- package/.versions/1.0.0/agents/security-auditor.md +167 -0
- package/.versions/1.0.0/agents/test-engineer.md +153 -0
- package/.versions/1.0.0/agents/web-debugger.md +43 -0
- package/.versions/1.0.0/agents/web-performance-auditor.md +193 -0
- package/.versions/1.0.0/codex/CONDUCTOR.md +148 -0
- package/.versions/1.0.0/docs/ARCHITECTURE.md +337 -0
- package/.versions/1.0.0/docs/agent-fleet-setup.md +437 -0
- package/.versions/1.0.0/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/1.0.0/docs/codex-remote-conductor.md +170 -0
- package/.versions/1.0.0/docs/coms-hermes-bridge.md +189 -0
- package/.versions/1.0.0/docs/getting-started.md +98 -0
- package/.versions/1.0.0/docs/npm-install.md +292 -0
- package/.versions/1.0.0/docs/pi-extensions.md +412 -0
- package/.versions/1.0.0/docs/pi-setup.md +74 -0
- package/.versions/1.0.0/docs/skill-anatomy.md +150 -0
- package/.versions/1.0.0/hermes/README.md +347 -0
- package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/1.0.0/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/1.0.0/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/1.0.0/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/1.0.0/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/1.0.0/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/1.0.0/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/1.0.0/install-manifest.json +2745 -0
- package/.versions/1.0.0/justfile +272 -0
- package/.versions/1.0.0/manifest-meta.json +882 -0
- package/.versions/1.0.0/references/accessibility-checklist.md +160 -0
- package/.versions/1.0.0/references/definition-of-done.md +67 -0
- package/.versions/1.0.0/references/fleet-coordination-patterns.md +151 -0
- package/.versions/1.0.0/references/observability-checklist.md +91 -0
- package/.versions/1.0.0/references/orchestration-patterns.md +370 -0
- package/.versions/1.0.0/references/performance-checklist.md +153 -0
- package/.versions/1.0.0/references/prompting-patterns.md +380 -0
- package/.versions/1.0.0/references/security-checklist.md +179 -0
- package/.versions/1.0.0/references/testing-patterns.md +236 -0
- package/.versions/1.0.0/scripts/codex-conductor.ts +41 -0
- package/.versions/1.0.0/scripts/codex-remote-control.ts +167 -0
- package/.versions/1.0.0/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/1.0.0/scripts/coms-cli.ts +484 -0
- package/.versions/1.0.0/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/1.0.0/scripts/fleet.ts +185 -0
- package/.versions/1.0.0/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/1.0.0/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/1.0.0/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/1.0.0/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/1.0.0/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/1.0.0/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/1.0.0/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/1.0.0/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/1.0.0/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/1.0.0/scripts/lib/fleet-command.ts +266 -0
- package/.versions/1.0.0/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/1.0.0/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/1.0.0/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/1.0.0/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/1.0.0/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/1.0.0/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/1.0.0/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/1.0.0/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/1.0.0/scripts/lib/monitor-env.ts +146 -0
- package/.versions/1.0.0/scripts/lib/peer-launch.ts +318 -0
- package/.versions/1.0.0/scripts/lib/persona-banner.ts +62 -0
- package/.versions/1.0.0/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/1.0.0/scripts/lib/team-project.ts +213 -0
- package/.versions/1.0.0/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/1.0.0/scripts/peer-banner.ts +40 -0
- package/.versions/1.0.0/scripts/peer-launch.ts +259 -0
- package/.versions/1.0.0/scripts/team-snapshot.ts +237 -0
- package/.versions/1.0.0/scripts/team-up.ts +406 -0
- package/.versions/1.0.0/skills/_internal/grilling.md +11 -0
- package/.versions/1.0.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/1.0.0/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/1.0.0/skills/compound-learning/SKILL.md +137 -0
- package/.versions/1.0.0/skills/context-engineering/SKILL.md +291 -0
- package/.versions/1.0.0/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/1.0.0/skills/designing-agents/SKILL.md +394 -0
- package/.versions/1.0.0/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/1.0.0/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/1.0.0/skills/idea-refine/SKILL.md +182 -0
- package/.versions/1.0.0/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.0/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.0/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.0/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/1.0.0/skills/interview-me/SKILL.md +226 -0
- package/.versions/1.0.0/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/1.0.0/skills/peer-coms/SKILL.md +90 -0
- package/.versions/1.0.0/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.0/skills/planning-and-task-breakdown/SKILL.md +254 -0
- package/.versions/1.0.0/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/1.0.0/skills/spec-driven-development/SKILL.md +257 -0
- package/.versions/1.0.0/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/1.0.0/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/1.0.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/.versions/1.0.1/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/1.0.1/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/1.0.1/.pi/agents/peers.yaml +142 -0
- package/.versions/1.0.1/.pi/agents/teams.yaml +41 -0
- package/.versions/1.0.1/.pi/damage-control-rules.yaml +297 -0
- package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/btw/README.md +120 -0
- package/.versions/1.0.1/.pi/extensions/btw/index.ts +914 -0
- package/.versions/1.0.1/.pi/extensions/btw/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/btw/state.js +179 -0
- package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/1.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/1.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/1.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/1.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/package-lock.json +1143 -0
- package/.versions/1.0.1/.pi/extensions/package.json +9 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/README.md +1065 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/footer.ts +35 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/hub-state-audit.js +55 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/index.ts +9343 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/posture.ts +103 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/run-budget.js +540 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/1.0.1/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/1.0.1/.pi/harnesses/ask-user-remote/index.ts +477 -0
- package/.versions/1.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/1.0.1/.pi/harnesses/coms/README.md +100 -0
- package/.versions/1.0.1/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/1.0.1/.pi/harnesses/coms/package.json +7 -0
- package/.versions/1.0.1/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/1.0.1/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/1.0.1/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/1.0.1/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/1.0.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/1.0.1/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/1.0.1/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/1.0.1/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/1.0.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/1.0.1/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/1.0.1/.pi/harnesses/package-lock.json +2046 -0
- package/.versions/1.0.1/.pi/harnesses/package.json +10 -0
- package/.versions/1.0.1/.pi/prompts/af-build.md +24 -0
- package/.versions/{0.0.11/.claude/commands/code-simplify.md → 1.0.1/.pi/prompts/af-code-simplify.md} +3 -3
- package/.versions/{0.0.11/.claude/commands/plan.md → 1.0.1/.pi/prompts/af-plan.md} +1 -1
- package/{.claude/commands/review.md → .versions/1.0.1/.pi/prompts/af-review.md} +3 -3
- package/.versions/1.0.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/1.0.1/.pi/prompts/af-ship.md +17 -0
- package/{.claude/commands/spec.md → .versions/1.0.1/.pi/prompts/af-spec.md} +1 -1
- package/{.claude/commands/test.md → .versions/1.0.1/.pi/prompts/af-test.md} +2 -2
- package/.versions/1.0.1/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/1.0.1/.version +1 -0
- package/.versions/1.0.1/agents/architect.md +24 -0
- package/.versions/1.0.1/agents/bowser.md +27 -0
- package/.versions/1.0.1/agents/builder.md +54 -0
- package/.versions/1.0.1/agents/code-reviewer.md +208 -0
- package/.versions/1.0.1/agents/deep-researcher.md +32 -0
- package/.versions/1.0.1/agents/documenter.md +18 -0
- package/.versions/1.0.1/agents/orchestrator.md +72 -0
- package/.versions/1.0.1/agents/plan-reviewer.md +83 -0
- package/.versions/1.0.1/agents/planner.md +70 -0
- package/.versions/1.0.1/agents/releaser.md +24 -0
- package/.versions/1.0.1/agents/researcher.md +28 -0
- package/.versions/1.0.1/agents/security-auditor.md +167 -0
- package/.versions/1.0.1/agents/test-engineer.md +153 -0
- package/.versions/1.0.1/agents/web-debugger.md +43 -0
- package/.versions/1.0.1/agents/web-performance-auditor.md +193 -0
- package/.versions/1.0.1/codex/CONDUCTOR.md +148 -0
- package/.versions/1.0.1/docs/ARCHITECTURE.md +337 -0
- package/.versions/1.0.1/docs/agent-fleet-setup.md +437 -0
- package/.versions/1.0.1/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/1.0.1/docs/codex-remote-conductor.md +170 -0
- package/.versions/1.0.1/docs/coms-hermes-bridge.md +189 -0
- package/.versions/1.0.1/docs/getting-started.md +98 -0
- package/.versions/1.0.1/docs/npm-install.md +292 -0
- package/.versions/1.0.1/docs/pi-extensions.md +412 -0
- package/.versions/1.0.1/docs/pi-setup.md +74 -0
- package/.versions/1.0.1/docs/skill-anatomy.md +150 -0
- package/.versions/1.0.1/hermes/README.md +347 -0
- package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/1.0.1/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/1.0.1/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/1.0.1/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/1.0.1/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/1.0.1/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/1.0.1/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/1.0.1/install-manifest.json +2745 -0
- package/.versions/1.0.1/justfile +272 -0
- package/.versions/1.0.1/manifest-meta.json +882 -0
- package/.versions/1.0.1/references/accessibility-checklist.md +160 -0
- package/.versions/1.0.1/references/definition-of-done.md +67 -0
- package/.versions/1.0.1/references/fleet-coordination-patterns.md +151 -0
- package/.versions/1.0.1/references/observability-checklist.md +91 -0
- package/.versions/1.0.1/references/orchestration-patterns.md +370 -0
- package/.versions/1.0.1/references/performance-checklist.md +153 -0
- package/.versions/1.0.1/references/prompting-patterns.md +380 -0
- package/.versions/1.0.1/references/security-checklist.md +179 -0
- package/.versions/1.0.1/references/testing-patterns.md +236 -0
- package/.versions/1.0.1/scripts/codex-conductor.ts +41 -0
- package/.versions/1.0.1/scripts/codex-remote-control.ts +167 -0
- package/.versions/1.0.1/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/1.0.1/scripts/coms-cli.ts +484 -0
- package/.versions/1.0.1/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/1.0.1/scripts/fleet.ts +185 -0
- package/.versions/1.0.1/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/1.0.1/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/1.0.1/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/1.0.1/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/1.0.1/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/1.0.1/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/1.0.1/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/1.0.1/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/1.0.1/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/1.0.1/scripts/lib/fleet-command.ts +266 -0
- package/.versions/1.0.1/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/1.0.1/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/1.0.1/scripts/lib/monitor-env.ts +146 -0
- package/.versions/1.0.1/scripts/lib/peer-launch.ts +318 -0
- package/.versions/1.0.1/scripts/lib/persona-banner.ts +62 -0
- package/.versions/1.0.1/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/1.0.1/scripts/lib/team-project.ts +213 -0
- package/.versions/1.0.1/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/1.0.1/scripts/peer-banner.ts +40 -0
- package/.versions/1.0.1/scripts/peer-launch.ts +259 -0
- package/.versions/1.0.1/scripts/team-snapshot.ts +237 -0
- package/.versions/1.0.1/scripts/team-up.ts +406 -0
- package/.versions/1.0.1/skills/_internal/grilling.md +11 -0
- package/.versions/1.0.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/1.0.1/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/1.0.1/skills/compound-learning/SKILL.md +137 -0
- package/.versions/1.0.1/skills/context-engineering/SKILL.md +291 -0
- package/.versions/1.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/1.0.1/skills/designing-agents/SKILL.md +394 -0
- package/.versions/1.0.1/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/1.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/1.0.1/skills/idea-refine/SKILL.md +182 -0
- package/.versions/1.0.1/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.1/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.1/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.1/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/1.0.1/skills/interview-me/SKILL.md +226 -0
- package/.versions/1.0.1/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/1.0.1/skills/peer-coms/SKILL.md +90 -0
- package/.versions/1.0.1/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.1/skills/planning-and-task-breakdown/SKILL.md +254 -0
- package/.versions/1.0.1/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/1.0.1/skills/spec-driven-development/SKILL.md +257 -0
- package/.versions/1.0.1/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/1.0.1/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +148 -0
- package/README.md +117 -79
- package/agents/code-reviewer.md +1 -1
- package/agents/deep-researcher.md +1 -1
- package/agents/orchestrator.md +1 -1
- package/agents/plan-reviewer.md +1 -1
- package/agents/planner.md +1 -1
- package/agents/security-auditor.md +1 -1
- package/agents/test-engineer.md +1 -1
- package/bin/catalog/harness-runtime-closure.json +38 -0
- package/bin/cli.js +289 -359
- package/bin/force-patch-changesets.js +18 -2
- package/bin/lib/apply.js +86 -32
- package/bin/lib/desired.js +87 -0
- package/bin/lib/detect-agent.js +22 -38
- package/bin/lib/doctor.js +283 -33
- package/bin/lib/features.js +78 -0
- package/bin/lib/manifest.js +127 -48
- package/bin/lib/overrides.js +35 -0
- package/bin/lib/personas.js +37 -0
- package/bin/lib/plan.js +18 -9
- package/bin/lib/purge.js +11 -0
- package/bin/lib/reconcile.js +68 -0
- package/bin/lib/scan.js +24 -0
- package/bin/lib/state.js +25 -1
- package/bin/lib/stt-wizard.js +33 -0
- package/bin/lib/transaction.js +149 -0
- package/bin/lib/tui.js +71 -0
- package/bin/lib/verify.js +9 -26
- package/bin/snapshot-version.js +3 -6
- package/docs/ARCHITECTURE.md +55 -21
- package/docs/MIGRATION-agent-fleet.md +222 -0
- package/docs/agent-fleet-setup.md +124 -64
- package/docs/claude-code-coms-bridge.md +21 -2
- package/docs/coms-hermes-bridge.md +1 -1
- package/docs/getting-started.md +61 -217
- package/docs/npm-install.md +207 -429
- package/docs/pi-extensions.md +85 -41
- package/docs/pi-setup.md +48 -545
- package/hermes/README.md +1 -1
- package/install-manifest.json +385 -1255
- package/justfile +45 -27
- package/manifest-meta.json +544 -134
- package/node_modules/pi-ask-user/README.md +43 -5
- package/node_modules/pi-ask-user/index.ts +630 -75
- package/node_modules/pi-ask-user/package.json +1 -1
- package/package.json +5 -11
- package/scripts/coms-claude-bridge.ts +10 -0
- package/scripts/fleet.ts +107 -90
- package/scripts/lib/claude-bridge-core.ts +45 -0
- package/scripts/lib/fleet-command.ts +170 -15
- package/scripts/lib/monitor-env.ts +18 -6
- package/scripts/lib/peer-launch.ts +6 -2
- package/scripts/lib/team-project.ts +24 -4
- package/scripts/team-up.ts +57 -11
- package/skills/designing-agents/SKILL.md +1 -1
- package/skills/designing-agents/pi-harness-authoring.md +3 -3
- package/.claude/commands/build.md +0 -44
- package/.claude/commands/design-agent.md +0 -14
- package/.claude/commands/doctor-agent-fleet.md +0 -22
- package/.claude/commands/orchestrate.md +0 -112
- package/.claude/commands/prime.md +0 -22
- package/.claude/commands/set-hermes-telegram.md +0 -15
- package/.claude/commands/set-hermes-watchdog.md +0 -6
- package/.claude/commands/setup-agent-fleet.md +0 -17
- package/.claude/commands/ship.md +0 -72
- package/.claude/commands/webperf.md +0 -32
- package/.claude/orchestrate-teams.yaml +0 -24
- package/.opencode/commands/af-build.md +0 -17
- package/.opencode/commands/af-code-simplify.md +0 -16
- package/.opencode/commands/af-compound.md +0 -16
- package/.opencode/commands/af-design-agent.md +0 -15
- package/.opencode/commands/af-doctor-agent-fleet.md +0 -22
- package/.opencode/commands/af-orchestrate.md +0 -112
- package/.opencode/commands/af-plan.md +0 -16
- package/.opencode/commands/af-prime.md +0 -22
- package/.opencode/commands/af-review.md +0 -15
- package/.opencode/commands/af-set-hermes-watchdog.md +0 -6
- package/.opencode/commands/af-setup-agent-fleet.md +0 -17
- package/.opencode/commands/af-ship.md +0 -16
- package/.opencode/commands/af-spec.md +0 -16
- package/.opencode/commands/af-test.md +0 -21
- package/.opencode/commands/af-webperf.md +0 -32
- package/.opencode/orchestrate-teams.yaml +0 -24
- package/.pi/prompts/af-doctor-agent-fleet.md +0 -22
- package/.pi/prompts/af-setup-agent-fleet.md +0 -19
- package/.versions/0.0.1/.opencode/commands/af-doctor-agent-fleet.md +0 -15
- package/.versions/0.0.1/.opencode/commands/af-setup-agent-fleet.md +0 -15
- package/.versions/0.0.1/skills/guided-workspace-setup/SKILL.md +0 -506
- package/.versions/0.0.10/.opencode/commands/af-doctor-agent-fleet.md +0 -22
- package/.versions/0.0.10/.opencode/commands/af-setup-agent-fleet.md +0 -17
- package/.versions/0.0.10/.pi/prompts/af-doctor-agent-fleet.md +0 -22
- package/.versions/0.0.10/.pi/prompts/af-setup-agent-fleet.md +0 -19
- package/.versions/0.0.10/skills/guided-workspace-setup/SKILL.md +0 -226
- package/.versions/0.0.11/.claude/commands/build.md +0 -44
- package/.versions/0.0.11/.claude/commands/design-agent.md +0 -14
- package/.versions/0.0.11/.claude/commands/doctor-agent-fleet.md +0 -22
- package/.versions/0.0.11/.claude/commands/orchestrate.md +0 -112
- package/.versions/0.0.11/.claude/commands/prime.md +0 -22
- package/.versions/0.0.11/.claude/commands/set-hermes-telegram.md +0 -15
- package/.versions/0.0.11/.claude/commands/set-hermes-watchdog.md +0 -6
- package/.versions/0.0.11/.claude/commands/setup-agent-fleet.md +0 -17
- package/.versions/0.0.11/.claude/commands/ship.md +0 -72
- package/.versions/0.0.11/.claude/commands/webperf.md +0 -32
- package/.versions/0.0.11/.claude/orchestrate-teams.yaml +0 -24
- package/.versions/0.0.11/.opencode/commands/af-build.md +0 -17
- package/.versions/0.0.11/.opencode/commands/af-code-simplify.md +0 -16
- package/.versions/0.0.11/.opencode/commands/af-compound.md +0 -16
- package/.versions/0.0.11/.opencode/commands/af-design-agent.md +0 -15
- package/.versions/0.0.11/.opencode/commands/af-doctor-agent-fleet.md +0 -22
- package/.versions/0.0.11/.opencode/commands/af-orchestrate.md +0 -112
- package/.versions/0.0.11/.opencode/commands/af-plan.md +0 -16
- package/.versions/0.0.11/.opencode/commands/af-prime.md +0 -22
- package/.versions/0.0.11/.opencode/commands/af-review.md +0 -15
- package/.versions/0.0.11/.opencode/commands/af-set-hermes-watchdog.md +0 -6
- package/.versions/0.0.11/.opencode/commands/af-setup-agent-fleet.md +0 -17
- package/.versions/0.0.11/.opencode/commands/af-ship.md +0 -16
- package/.versions/0.0.11/.opencode/commands/af-spec.md +0 -16
- package/.versions/0.0.11/.opencode/commands/af-test.md +0 -21
- package/.versions/0.0.11/.opencode/commands/af-webperf.md +0 -32
- package/.versions/0.0.11/.opencode/orchestrate-teams.yaml +0 -24
- package/.versions/0.0.11/.pi/prompts/af-doctor-agent-fleet.md +0 -22
- package/.versions/0.0.11/.pi/prompts/af-setup-agent-fleet.md +0 -19
- package/.versions/0.0.11/docs/opencode-setup.md +0 -281
- package/.versions/0.0.11/hooks/SIMPLIFY-IGNORE.md +0 -90
- package/.versions/0.0.11/hooks/hooks.json +0 -14
- package/.versions/0.0.11/hooks/session-start.sh +0 -74
- package/.versions/0.0.11/hooks/simplify-ignore.sh +0 -302
- package/.versions/0.0.11/skills/guided-workspace-setup/SKILL.md +0 -226
- package/.versions/0.0.4/.opencode/commands/af-doctor-agent-fleet.md +0 -17
- package/.versions/0.0.4/.opencode/commands/af-setup-agent-fleet.md +0 -15
- package/.versions/0.0.4/skills/guided-workspace-setup/SKILL.md +0 -535
- package/.versions/0.0.4/skills/guided-workspace-setup/companion-manifest.json +0 -33
- package/.versions/0.0.5/.opencode/commands/af-doctor-agent-fleet.md +0 -17
- package/.versions/0.0.5/.opencode/commands/af-setup-agent-fleet.md +0 -15
- package/.versions/0.0.5/skills/guided-workspace-setup/SKILL.md +0 -542
- package/.versions/0.0.5/skills/guided-workspace-setup/companion-manifest.json +0 -35
- package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +0 -17
- package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +0 -15
- package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +0 -15
- package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +0 -27
- package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +0 -544
- package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +0 -35
- package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +0 -17
- package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +0 -15
- package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +0 -15
- package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +0 -27
- package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +0 -544
- package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +0 -35
- package/.versions/0.0.8/.opencode/commands/af-doctor-agent-fleet.md +0 -17
- package/.versions/0.0.8/.opencode/commands/af-setup-agent-fleet.md +0 -15
- package/.versions/0.0.8/.pi/prompts/af-doctor-agent-fleet.md +0 -15
- package/.versions/0.0.8/.pi/prompts/af-setup-agent-fleet.md +0 -27
- package/.versions/0.0.8/skills/guided-workspace-setup/SKILL.md +0 -544
- package/.versions/0.0.8/skills/guided-workspace-setup/companion-manifest.json +0 -36
- package/.versions/0.0.9/.opencode/commands/af-doctor-agent-fleet.md +0 -17
- package/.versions/0.0.9/.opencode/commands/af-setup-agent-fleet.md +0 -15
- package/.versions/0.0.9/.pi/prompts/af-doctor-agent-fleet.md +0 -15
- package/.versions/0.0.9/.pi/prompts/af-setup-agent-fleet.md +0 -27
- package/.versions/0.0.9/skills/guided-workspace-setup/SKILL.md +0 -544
- package/bin/lib/bootstrap.js +0 -323
- package/bin/lib/transform-persona.js +0 -180
- package/docs/opencode-setup.md +0 -281
- package/hooks/SIMPLIFY-IGNORE.md +0 -90
- package/hooks/hooks.json +0 -14
- package/hooks/session-start.sh +0 -74
- package/hooks/simplify-ignore.sh +0 -302
- package/skills/guided-workspace-setup/SKILL.md +0 -226
- /package/.versions/0.0.10/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
- /package/.versions/0.0.11/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
- /package/{.opencode/commands → .versions/1.0.0/.pi/prompts}/af-set-hermes-telegram.md +0 -0
- /package/.versions/{0.0.9/skills/guided-workspace-setup/companion-manifest.json → 1.0.0/bin/catalog/harness-runtime-closure.json} +0 -0
- /package/.versions/{0.0.11/.opencode/commands → 1.0.1/.pi/prompts}/af-set-hermes-telegram.md +0 -0
- /package/{skills/guided-workspace-setup/companion-manifest.json → .versions/1.0.1/bin/catalog/harness-runtime-closure.json} +0 -0
|
@@ -0,0 +1,222 @@
|
|
|
1
|
+
# Major-release migration guide
|
|
2
|
+
|
|
3
|
+
This is a large major release. Four independent changes land together, and each
|
|
4
|
+
one breaks something different:
|
|
5
|
+
|
|
6
|
+
| # | Change | Who it breaks | Section |
|
|
7
|
+
|---|---|---|---|
|
|
8
|
+
| 1 | Guided LLM setup replaced by deterministic `setup`/`doctor`/`uninstall` | Anyone who installed or updated with the old guided flow | [Lifecycle](#1-the-lifecycle-is-deterministic-now) |
|
|
9
|
+
| 2 | Claude Code removed as a coding-agent install target | Workspaces installed with `--agent claude-code` | [Claude Code](#2-claude-code-is-a-coms-peer-only) |
|
|
10
|
+
| 3 | OpenCode support removed entirely | Workspaces installed with `--agent opencode` | [OpenCode](#3-opencode-is-gone) |
|
|
11
|
+
| 4 | Pi Fleet startup unified behind one guarded Agent Hub runtime | Scripts and habits built on `just fleet hub` / `just fleet team` | [Fleet runtime](#4-one-unified-just-fleet-runtime) |
|
|
12
|
+
|
|
13
|
+
If you read only one thing: **update with `just fleet setup --dry-run` first.**
|
|
14
|
+
The plan names every file it will overwrite, and this release changes enough
|
|
15
|
+
that reading it once is worth the minute.
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## 1. The lifecycle is deterministic now
|
|
20
|
+
|
|
21
|
+
The conversational setup layer is gone. `setup`, `doctor`, and `uninstall` are
|
|
22
|
+
the public commands, they need no coding agent or model, and every mutation is
|
|
23
|
+
planned before it is applied.
|
|
24
|
+
|
|
25
|
+
**What was removed:** the guided setup skill and its two prompts, the installer
|
|
26
|
+
self-removal command, and the raw `--items` / `--profile` selectors on `setup`
|
|
27
|
+
(use `--preset <default|full>` and `--features <name[,name]|none>`).
|
|
28
|
+
|
|
29
|
+
**Compatibility aliases:** `init` and `update` dispatch to `setup`. `install`
|
|
30
|
+
and `upgrade` keep their historical selection and three-way-merge semantics and
|
|
31
|
+
emit a deprecation warning — they are not replacements for deterministic
|
|
32
|
+
automation and do not restore retired prompt or skill surfaces.
|
|
33
|
+
|
|
34
|
+
### The command matrix
|
|
35
|
+
|
|
36
|
+
| Situation | Command | Result / gate |
|
|
37
|
+
| --- | --- | --- |
|
|
38
|
+
| **First install, any repository** | `npx @chankov/agent-fleet@latest setup` | Interactive in a TTY. A repository without Agent Fleet has no justfile — setup writes it — so `just fleet setup` is not available yet. |
|
|
39
|
+
| Fresh Default automation | `npx @chankov/agent-fleet@<exact-version> setup --preset default --features none --yes` | Reproducible stable Fleet Core, no voice configuration or `.claude/`. |
|
|
40
|
+
| Fresh Full automation | `npx @chankov/agent-fleet@<exact-version> setup --preset full --features none --yes` | All stable, platform-applicable catalogue roots; experimental Codex Remote stays excluded. |
|
|
41
|
+
| Finish the install | `just fleet deps` (or `setup --allow-exec`) | Setup writes files and runs no commands. The `npm` steps are planned as `skip`; the workspace is not launchable until they run. |
|
|
42
|
+
| **Routine update** | `just fleet setup --dry-run`, then `just fleet setup` | Reconciles to the desired state already in `.ai/agent-fleet.json`; no flags needed. |
|
|
43
|
+
| Stable features | `... setup --preset default --features voice,browser --yes` | `hermes`, `telegram` (requires `hermes`), and `claude-bridge` are stable; `codex-remote` is an explicit experimental opt-in. |
|
|
44
|
+
| Existing desired state | `... setup --preset full --features none --yes` | Flags are ephemeral; existing `.ai/agent-fleet.json` is unchanged. Add `--save-desired` to persist. |
|
|
45
|
+
| First legacy migration preview | `... setup --migrate --dry-run` | Lists exact state-owned removals; no consent or writes. |
|
|
46
|
+
| First legacy migration mutation | `... setup --migrate --preset default --features none --yes` | Automation requires all three gates: `--migrate`, explicit preset/features, and `--yes`; only unchanged owned extras are removed. |
|
|
47
|
+
| Legacy record without state | `... setup --migrate --dry-run` | Preview first; do not assume unrecorded files are owned or removable. |
|
|
48
|
+
| Conflict | `... setup --on-conflict theirs` or `--on-conflict ours` | Without a policy setup exits `3` before writes. `ours` keeps the local copy; `theirs` takes the package version. |
|
|
49
|
+
| Read-only diagnosis | `... doctor` | Never prompts or writes; actionable findings exit `2`, advisory-only output exits `0`. |
|
|
50
|
+
| Repair | `... doctor --fix` | Recovers interrupted transactions and pending runtime repairs. If a transaction backup was reaped, doctor reports the unrecoverable journal; `--fix` safely discards that installer-owned journal because restoration is impossible. |
|
|
51
|
+
| Normal removal | `... uninstall --all --yes` | Removes only recorded, unchanged artifacts; desired/override/STT configuration and environment files remain. |
|
|
52
|
+
| Config purge | `... uninstall --all --purge-config --yes` | The separate destructive gate removes desired/override/STT config; environment files remain. |
|
|
53
|
+
| Self-hosted removal | `just fleet uninstall --yes` | Removes ordinary content, then launcher/managed region, then state; its in-memory report still completes. |
|
|
54
|
+
| Self-hosted reinstall | `npx @chankov/agent-fleet@latest setup --preset default --features none --yes` | Restores `just fleet`; then run `just fleet doctor`. |
|
|
55
|
+
|
|
56
|
+
`just fleet install` was removed; use `just fleet setup` or `just fleet deps`.
|
|
57
|
+
`pi update --extensions` updates pi extensions only, never the npm installer.
|
|
58
|
+
Published-package commands use `npx`; source-checkout development uses
|
|
59
|
+
`node bin/cli.js setup` with equivalent flags.
|
|
60
|
+
|
|
61
|
+
### The behaviour change most likely to surprise you
|
|
62
|
+
|
|
63
|
+
`setup` reconciles the workspace **toward the package**. If you edited a shipped
|
|
64
|
+
artifact in place and upstream did not change it, `setup` refreshes the file and
|
|
65
|
+
your edit is gone — no conflict, no prompt. The old `upgrade` verb preserved
|
|
66
|
+
such edits; `setup` does not.
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
just fleet setup --dry-run
|
|
70
|
+
# refresh skill:code-review-and-quality
|
|
71
|
+
# locally modified — selecting it overwrites your edits ← your edit dies here
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
Customize through `.ai/agent-fleet-overrides.md` (human-owned, never touched by
|
|
75
|
+
any lifecycle command), through artifacts under names Agent Fleet does not ship,
|
|
76
|
+
or by leaving the item out of your selection — `setup` never removes what it
|
|
77
|
+
does not select, so an unselected item stays installed and frozen.
|
|
78
|
+
|
|
79
|
+
Full per-state table: [npm-install.md](npm-install.md#what-reconcile-does-to-each-file).
|
|
80
|
+
|
|
81
|
+
### Ownership and configuration rules
|
|
82
|
+
|
|
83
|
+
The state file is the only deletion authority. Unknown extensions, hooks,
|
|
84
|
+
settings, recipes, and files are not adopted. Desired state belongs to
|
|
85
|
+
`.ai/agent-fleet.json`; project overrides and STT configuration are human
|
|
86
|
+
configuration and survive a normal uninstall. Secrets are referenced by
|
|
87
|
+
environment-variable name only and are never written to state, journals, desired
|
|
88
|
+
state, or `.ai/stt.json`. The installer-owned `.ai/agent-fleet-transaction.json`
|
|
89
|
+
is a crash-recovery journal — removed on success or recovery, never a user
|
|
90
|
+
configuration file.
|
|
91
|
+
|
|
92
|
+
---
|
|
93
|
+
|
|
94
|
+
## 2. Claude Code is a coms peer only
|
|
95
|
+
|
|
96
|
+
pi is the only agent the installer writes for. Claude Code stays in the fleet as
|
|
97
|
+
a **coms peer** and nothing else.
|
|
98
|
+
|
|
99
|
+
**Gone:** `.claude/commands/` (15 slash commands, including `/orchestrate`) and
|
|
100
|
+
`.claude/orchestrate-teams.yaml`; `.claude-plugin/` — Agent Fleet is no longer
|
|
101
|
+
published as a Claude Code plugin, and npm is the only distribution channel;
|
|
102
|
+
`hooks/session-start.sh`, `hooks/simplify-ignore*.sh`, `hooks/SIMPLIFY-IGNORE.md`,
|
|
103
|
+
`hooks/hooks.json`; `agent-fleet transform-persona` and its install strategy; the
|
|
104
|
+
`references-hooks` manifest group; and the interactive "which coding agent?"
|
|
105
|
+
prompt.
|
|
106
|
+
|
|
107
|
+
**Replaced by:** `--agent` is still accepted and validated, defaults to `pi`, and
|
|
108
|
+
is never asked for. References moved from `.claude/references/` to
|
|
109
|
+
`.pi/references/` and are no longer a standalone menu section — each is a
|
|
110
|
+
**companion of the skills that cite it**, so installing `code-review-and-quality`
|
|
111
|
+
brings `security-checklist.md` and `performance-checklist.md` with it, and
|
|
112
|
+
uninstall refuses to strand a skill without its checklists. A new `coms-bridge`
|
|
113
|
+
manifest group holds `skill:peer-coms` and its companion `hook:coms-stop-hook`;
|
|
114
|
+
the hook still installs to `.claude/hooks/` under the **pi** agent, because the
|
|
115
|
+
pane reading it is a Claude Code process. Registering it in `.claude/settings.json`
|
|
116
|
+
remains a manual step — see [claude-code-coms-bridge.md](claude-code-coms-bridge.md).
|
|
117
|
+
|
|
118
|
+
**Unchanged:** the bridge itself — `scripts/coms-claude-bridge.ts`,
|
|
119
|
+
`scripts/lib/claude-bridge-core.ts`, `skills/peer-coms/`, the `_claude-peer`
|
|
120
|
+
recipe, `runner: claude-code` peers in `.pi/agents/peers.yaml`, and the
|
|
121
|
+
`dispatch-policy.yaml` routing that lets a bridged pane serve a team member's
|
|
122
|
+
dispatch. Cross-model review through a standing Claude session works as before.
|
|
123
|
+
|
|
124
|
+
### Migrating a `claude-code` workspace
|
|
125
|
+
|
|
126
|
+
Not automatic. Those `.claude/` artifacts left the catalogue, so `verify` will
|
|
127
|
+
not claim them and `uninstall` will not remove them — the ownership rule cuts
|
|
128
|
+
both ways.
|
|
129
|
+
|
|
130
|
+
```bash
|
|
131
|
+
# 1. Reinstall for pi.
|
|
132
|
+
npx @chankov/agent-fleet@latest setup --preset default --features none --yes
|
|
133
|
+
just fleet deps
|
|
134
|
+
|
|
135
|
+
# 2. See what the installer now considers yours.
|
|
136
|
+
just fleet doctor
|
|
137
|
+
|
|
138
|
+
# 3. Remove the orphaned Claude Code install by hand, after reviewing it.
|
|
139
|
+
# Keep .claude/hooks/ if you use the coms bridge.
|
|
140
|
+
rm -rf .claude/commands .claude/skills .claude/agents .claude/references
|
|
141
|
+
rm -f .claude/orchestrate-teams.yaml
|
|
142
|
+
rm -rf .claude-plugin
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
Review before deleting — `.claude/` may hold your own settings and hooks that
|
|
146
|
+
Agent Fleet never wrote.
|
|
147
|
+
|
|
148
|
+
---
|
|
149
|
+
|
|
150
|
+
## 3. OpenCode is gone
|
|
151
|
+
|
|
152
|
+
OpenCode is no longer a recognized agent for any skill, persona, command, or
|
|
153
|
+
harness. `--agent opencode` is rejected by every CLI verb, and the installer no
|
|
154
|
+
longer knows the `.opencode/` paths — so it can neither install into nor clean
|
|
155
|
+
up an OpenCode workspace.
|
|
156
|
+
|
|
157
|
+
`detect-agent`, `manifest`, `bootstrap`, and `doctor` dropped every `.opencode/`
|
|
158
|
+
target path and the OpenCode persona transform. `.opencode/` and
|
|
159
|
+
`docs/opencode-setup.md` left the package, and the `opencode` keyword left
|
|
160
|
+
`package.json`. `/compound` is gone as an installable command — it only ever
|
|
161
|
+
shipped as an OpenCode command file; pi keeps `/af-compound` via the `agent-hub`
|
|
162
|
+
harness.
|
|
163
|
+
|
|
164
|
+
### Migrating an OpenCode workspace
|
|
165
|
+
|
|
166
|
+
Delete it by hand **before** you upgrade, then install for pi:
|
|
167
|
+
|
|
168
|
+
```bash
|
|
169
|
+
rm -rf .opencode/agent .opencode/skills .opencode/commands
|
|
170
|
+
rm -f .opencode/orchestrate-teams.yaml
|
|
171
|
+
npx @chankov/agent-fleet@latest setup --preset default --features none --yes
|
|
172
|
+
just fleet deps
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
`.versions/<x.y.z>/` snapshots are left untouched — they are the record of what
|
|
176
|
+
each past release actually shipped, and reconciliation diffs against them.
|
|
177
|
+
|
|
178
|
+
---
|
|
179
|
+
|
|
180
|
+
## 4. One unified `just fleet` runtime
|
|
181
|
+
|
|
182
|
+
Pi Fleet startup is now a single guarded Agent Hub runtime. Bare `just fleet`
|
|
183
|
+
loads Fleet Core plus Agent Hub in **operator** posture: direct coding tools
|
|
184
|
+
preserved, native roster empty. Execution posture, native specialists, workspace
|
|
185
|
+
topology, project scope, and communication capabilities are now selected
|
|
186
|
+
independently:
|
|
187
|
+
|
|
188
|
+
```bash
|
|
189
|
+
just fleet # operator, empty native roster
|
|
190
|
+
just fleet --agents frontend # native roster; orchestrator inferred
|
|
191
|
+
just fleet --posture operator --agents frontend # direct work plus the same roster
|
|
192
|
+
just fleet --no-coms # direct/native work, no peer messaging
|
|
193
|
+
just fleet --herdr --project af # one Hub pane, no standing peers
|
|
194
|
+
just fleet --agents frontend --peers frontend --project af
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
New in the same change: live `/af-posture` switching, on-demand native roster
|
|
198
|
+
growth (`/af-agents-add`), deterministic `dispatch_agent` routing through
|
|
199
|
+
`backend: auto|native|coms`, and same-project dynamic Pi or Claude Code peer
|
|
200
|
+
spawning through Herdr.
|
|
201
|
+
|
|
202
|
+
### Deprecated forms — accepted for one migration release
|
|
203
|
+
|
|
204
|
+
| Old | New |
|
|
205
|
+
|---|---|
|
|
206
|
+
| `just fleet hub` | `just fleet` |
|
|
207
|
+
| `just fleet hub --solo` | `just fleet --no-coms` |
|
|
208
|
+
| `just fleet team <preset>` | `just fleet --agents <roster> --peers <preset>` |
|
|
209
|
+
| `just fleet team <preset> --no-hub` | legacy peers-only topology; no canonical replacement |
|
|
210
|
+
|
|
211
|
+
Each old form still runs and prints its canonical replacement. Legacy peer-only
|
|
212
|
+
presets (`full`, `web`, `docs`) retain the default native roster. Update scripts
|
|
213
|
+
during this release — the aliases are removed in the next one.
|
|
214
|
+
|
|
215
|
+
---
|
|
216
|
+
|
|
217
|
+
## Retired surfaces
|
|
218
|
+
|
|
219
|
+
The retired installer implementation and its two setup/doctor prompts are
|
|
220
|
+
intentionally absent. All other `af-*` lifecycle and operational prompts remain
|
|
221
|
+
public. Historical changelog and planning text may mention retired surfaces as
|
|
222
|
+
history only.
|
|
@@ -6,12 +6,14 @@ different readers and different lifetimes, so they are kept separate.
|
|
|
6
6
|
| File | Read by | When |
|
|
7
7
|
|------|---------|------|
|
|
8
8
|
| `.ai/agent-fleet-overrides.md` | `spec-driven-development`, `planning-and-task-breakdown`, `browser-testing-with-devtools`, `git-workflow-and-versioning`, `compound-learning` (the `rules:`/`docs:` keys of `## agent-hub`), `agent-hub` pi harness | Every run of those skills / every session start of the harness |
|
|
9
|
-
| `.ai/agent-fleet
|
|
10
|
-
| `.ai/agent-fleet-
|
|
9
|
+
| `.ai/agent-fleet.json` | the deterministic `agent-fleet` lifecycle (`setup`) — human-owned desired state (preset/features); intended to be committed | Every setup plan; created/updated when setup persists desired state or migrates legacy installs |
|
|
10
|
+
| `.ai/agent-fleet-state.json` | the deterministic `agent-fleet` lifecycle (`setup`, `doctor`, `uninstall`) | Every lifecycle plan and apply |
|
|
11
|
+
| `.ai/agent-fleet-setup.md` | humans — rendered from the state file, never parsed back | Rewritten on every setup apply |
|
|
12
|
+
| `.ai/agent-fleet-transaction.json` | the deterministic lifecycle (`setup`, `doctor --fix`) — crash-recovery journal for in-flight file transactions | Written during apply; recovered or discarded by setup/doctor; removed when the transaction commits or is cleaned up |
|
|
11
13
|
| `.ai/stt.json` *(optional)* | `pi-voice-stt` extension | Every pi session start, when the extension is installed |
|
|
12
14
|
|
|
13
15
|
The `.ai/stt.json` file is present only when the optional `pi-voice-stt` voice-dictation
|
|
14
|
-
extension has been configured (by
|
|
16
|
+
extension has been configured (by deterministic setup or by hand). Like the overrides file it holds
|
|
15
17
|
**no secrets** — it names the env vars (`apiKeyEnv`, plus the Azure endpoint var) whose values
|
|
16
18
|
live in a gitignored root `.env`. See [pi-voice-stt config](#ai-sttjson) below.
|
|
17
19
|
|
|
@@ -19,6 +21,76 @@ Keep them split: the overrides file is loaded into context constantly, so it
|
|
|
19
21
|
must stay minimal; the install record is read only by the CLI, so it can be
|
|
20
22
|
large.
|
|
21
23
|
|
|
24
|
+
## Unified Fleet runtime configuration
|
|
25
|
+
|
|
26
|
+
A Pi workspace has one public runtime entry point. Bare Fleet loads Fleet Core
|
|
27
|
+
plus Agent Hub in **operator** posture, in the current terminal, with no native
|
|
28
|
+
specialists active:
|
|
29
|
+
|
|
30
|
+
```bash
|
|
31
|
+
just fleet
|
|
32
|
+
just fleet --project af
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Posture, native roster, and peer topology are separate controls:
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
# Direct tools plus an available native roster.
|
|
39
|
+
just fleet --posture operator --agents frontend --project af
|
|
40
|
+
|
|
41
|
+
# A roster implies orchestrator when posture is not explicit.
|
|
42
|
+
just fleet --agents frontend --project af
|
|
43
|
+
|
|
44
|
+
# Herdr Hub-only and Hub-plus-peer topologies.
|
|
45
|
+
just fleet --herdr --project af
|
|
46
|
+
just fleet --agents frontend --peers frontend --project af
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
Startup precedence is deterministic: explicit `--posture` wins; otherwise an
|
|
50
|
+
explicit `--agents` roster implies `orchestrator`; otherwise posture is
|
|
51
|
+
`operator`. An orchestrator startup must name a roster. `--herdr` affects only
|
|
52
|
+
placement, while `--peers <preset>` implies Herdr and starts the selected peer
|
|
53
|
+
preset. Neither topology option selects a native roster.
|
|
54
|
+
|
|
55
|
+
`--project <name>` selects one coms namespace for the Hub and every standing or
|
|
56
|
+
dynamically spawned peer. Dynamic peer tools deliberately expose no project
|
|
57
|
+
override, so an agent cannot cross that boundary. The default project is
|
|
58
|
+
`default`; use an explicit project when multiple fleets share a machine.
|
|
59
|
+
|
|
60
|
+
The configuration files have distinct ownership:
|
|
61
|
+
|
|
62
|
+
| File | Controls |
|
|
63
|
+
| --- | --- |
|
|
64
|
+
| `.pi/agents/teams.yaml` | Named **native rosters** of Pi personas available to `dispatch_agent`. Bare Fleet ignores YAML ordering and starts empty; select one with `--agents`, `/af-agents-team`, or add individuals with `/af-agents-add`. |
|
|
65
|
+
| `.pi/agents/peers.yaml` | Named **standing peer presets** and each peer's runner (`pi` or `claude-code`), persona, model, extensions, and optional declared `env_file`. Select a preset with `--peers`; dynamic `herdr_spawn_peer` uses the same declaration resolver. |
|
|
66
|
+
| `.pi/agents/dispatch-policy.yaml` | Routing used only when `dispatch_agent.backend` is `auto`: native/coms preference, fallback, grace period, and peer reply timeout. |
|
|
67
|
+
| `.ai/agent-fleet-overrides.md` (`## agent-hub`) | Project-specific Hub language, model overrides, rule/doc roots, budgets, mode, watchdog, and related execution policy. It does not choose startup posture or topology. |
|
|
68
|
+
|
|
69
|
+
For deterministic routing, `backend: "native"` always starts the local Pi
|
|
70
|
+
specialist even if a same-name peer is visible. `backend: "coms"` requires a
|
|
71
|
+
visible same-name peer and refuses without native fallback. The default
|
|
72
|
+
`backend: "auto"` follows `dispatch-policy.yaml` and preserves its configured
|
|
73
|
+
fallback behavior.
|
|
74
|
+
|
|
75
|
+
Capability flags and runtime gates fail closed:
|
|
76
|
+
|
|
77
|
+
- `--no-coms` keeps operator direct tools and native dispatch available, but
|
|
78
|
+
peer dispatch, `coms_send`/`coms_await`, and `/af-handoff` refuse actionably.
|
|
79
|
+
- `--herdr` and `--peers` require a running [Herdr](https://herdr.dev) server.
|
|
80
|
+
Without Herdr, bare Fleet still works and dynamic pane tools stay inactive.
|
|
81
|
+
- `--browser` adds the browser extension surface and `--all-extensions` opts
|
|
82
|
+
into the complete approved extension set. Missing optional dependencies do
|
|
83
|
+
not grant tools merely because a flag was supplied.
|
|
84
|
+
- Hub-owned slash commands remain registered in both postures. A missing coms
|
|
85
|
+
runtime, Herdr connection, target peer, or native roster produces a
|
|
86
|
+
capability refusal rather than a missing command.
|
|
87
|
+
|
|
88
|
+
During the migration release, `just fleet hub`, `just fleet team <preset>`,
|
|
89
|
+
`just fleet team <preset> --no-hub`, and `--solo` remain accepted and print a
|
|
90
|
+
canonical replacement. New automation should use `just fleet` with
|
|
91
|
+
`--agents`, `--peers`, `--herdr`, and `--no-coms`; compatibility does not imply
|
|
92
|
+
that the deprecated grammar will remain indefinitely.
|
|
93
|
+
|
|
22
94
|
## The overrides file — `.ai/agent-fleet-overrides.md`
|
|
23
95
|
|
|
24
96
|
Some skills and pi harnesses need facts specific to each project — where specs
|
|
@@ -93,7 +165,7 @@ override files keep working unchanged. When both sections are present their keys
|
|
|
93
165
|
with later lines winning.
|
|
94
166
|
|
|
95
167
|
The `rules:` and `docs:` keys are also read outside the harness: the `compound-learning`
|
|
96
|
-
skill (and the `/
|
|
168
|
+
skill (and the `/af-compound` agent-hub command built on it) resolves them as the
|
|
97
169
|
targets an end-of-session compound pass writes lessons to.
|
|
98
170
|
|
|
99
171
|
| Key | Default | Meaning |
|
|
@@ -159,8 +231,9 @@ the environment nor declared in the workspace root `.env`.
|
|
|
159
231
|
|
|
160
232
|
### Per-peer env files (`env_file:` in peers.yaml)
|
|
161
233
|
|
|
162
|
-
Fleet peers spawned
|
|
163
|
-
environment: an `env_file:`
|
|
234
|
+
Fleet peers spawned through `--peers`, `just fleet peer`, or the Hub's
|
|
235
|
+
constrained dynamic peer tool can carry their own environment: an `env_file:`
|
|
236
|
+
entry in `.pi/agents/peers.yaml` names a
|
|
164
237
|
**repo-relative** KEY=VALUE file (same format as `.env`, no shell evaluation)
|
|
165
238
|
that herdr injects into the peer's pane before the command runs — no `source`,
|
|
166
239
|
no leaking into sibling panes. The file must exist at spawn (team-up refuses
|
|
@@ -185,7 +258,7 @@ replaced the prose ownership rule the setup skill used to carry.
|
|
|
185
258
|
| State-file field | Meaning |
|
|
186
259
|
|---|---|
|
|
187
260
|
| `agent`, `method`, `sourceRoot` | How and from where this workspace was installed |
|
|
188
|
-
| `packageVersion` | The version that performed the last apply —
|
|
261
|
+
| `packageVersion` | The version that performed the last apply — provenance for reconciliation and legacy three-way compatibility |
|
|
189
262
|
| `items` | One entry per installed artifact: strategy, method, files with hashes, JSON key paths |
|
|
190
263
|
| `externalPackages` | Packages the user was told to install; recorded, never installed for them |
|
|
191
264
|
| `events` | Last few applies (verb, version, action count, conflicts) |
|
|
@@ -195,75 +268,62 @@ replaced the prose ownership rule the setup skill used to carry.
|
|
|
195
268
|
|
|
196
269
|
### The recorded version and the three-way merge
|
|
197
270
|
|
|
198
|
-
`packageVersion`
|
|
199
|
-
|
|
200
|
-
snapshot tree, the installed copy on disk, and
|
|
271
|
+
The recorded `packageVersion` gives every comparison a baseline. For each
|
|
272
|
+
recorded artifact, the engine compares *source@recorded* from the package's
|
|
273
|
+
`.versions/<x.y.z>/` snapshot tree, the installed copy on disk, and
|
|
274
|
+
*source@current*. Deterministic `setup` is the public reconciliation command.
|
|
201
275
|
|
|
202
|
-
| Outcome | What
|
|
276
|
+
| Outcome | What `setup` does |
|
|
203
277
|
|---|---|
|
|
278
|
+
| Neither moved | Kept |
|
|
204
279
|
| Only the source moved | Clean refresh |
|
|
205
|
-
| Only your copy moved |
|
|
206
|
-
| Both moved, to different content | **Conflict**: the
|
|
207
|
-
| Retired upstream |
|
|
280
|
+
| Only your copy moved | **Refreshed — your edit is overwritten.** Reported in the plan as *"locally modified — selecting it overwrites your edits"*, so `--dry-run` shows it before it happens |
|
|
281
|
+
| Both moved, to different content | **Conflict**: the run exits `3` before writing anything. Resolve with `--on-conflict theirs` or `--on-conflict ours` |
|
|
282
|
+
| Retired upstream | Kept by `setup`; the deprecated `upgrade` proposes removal by name, subject to the ownership rule |
|
|
283
|
+
|
|
284
|
+
Reconciling toward the package is the point of `setup`: the workspace is meant
|
|
285
|
+
to match the version it records. That is why editing a shipped artifact in place
|
|
286
|
+
is not a supported customization route — use `.ai/agent-fleet-overrides.md`, add
|
|
287
|
+
artifacts under names Agent Fleet does not ship, or leave the item out of the
|
|
288
|
+
selection (`setup` never removes what it does not select, so an unselected item
|
|
289
|
+
stays installed and frozen). The deprecated `upgrade` verb preserves local edits
|
|
290
|
+
instead of overwriting them; if you have relied on that, it is the behavioural
|
|
291
|
+
difference to plan for.
|
|
208
292
|
|
|
209
293
|
If the snapshot is missing (an unpublished local build, or a version older than
|
|
210
294
|
`.versions/` retention), the comparison degrades to two-way, the installed copy
|
|
211
|
-
is treated as canonical, and `verify`
|
|
212
|
-
pretending a diff exists.
|
|
295
|
+
is treated as canonical, and the read-only auxiliary `verify` command reports it
|
|
296
|
+
as an advisory finding rather than pretending a diff exists.
|
|
213
297
|
|
|
214
298
|
### Pre-engine workspaces
|
|
215
299
|
|
|
216
300
|
A workspace with only `.ai/agent-fleet-setup.md` and no state file predates the
|
|
217
|
-
installer engine. `
|
|
218
|
-
`version:`)
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
301
|
+
installer engine. `setup --migrate --dry-run` previews what it can infer from
|
|
302
|
+
that markdown (`agent:`, `version:`) without adopting unrecorded paths. To
|
|
303
|
+
mutate a legacy workspace, use `setup --migrate` with an explicit preset,
|
|
304
|
+
features, and `--yes`. A workspace with no `version:` at all has no recorded
|
|
305
|
+
baseline, so no three-way merge is attempted.
|
|
222
306
|
|
|
223
307
|
Commit these files if the team should share install state — keep paths relative
|
|
224
308
|
so they stay portable. A self-referencing checkout (agent-fleet itself) may
|
|
225
309
|
instead `.gitignore` them, since their recorded paths are local to one machine.
|
|
226
310
|
|
|
227
|
-
##
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
`.
|
|
242
|
-
|
|
243
|
-
available). The reader differs by runtime: pi's harness parses its YAML, while
|
|
244
|
-
`/orchestrate` has the **command's instructions** read the YAML via the Read tool
|
|
245
|
-
(no harness runtime in claude-code/opencode):
|
|
246
|
-
|
|
247
|
-
| | Config file | Command |
|
|
248
|
-
|---|---|---|
|
|
249
|
-
| claude-code | `.claude/orchestrate-teams.yaml` | `/orchestrate` |
|
|
250
|
-
| opencode | `.opencode/orchestrate-teams.yaml` | `/af-orchestrate` |
|
|
251
|
-
| pi | `.pi/agents/teams.yaml` | via the `agent-hub` harness (no `/orchestrate`) |
|
|
252
|
-
|
|
253
|
-
Switch teams at runtime with `/orchestrate <team> "<task>"` (parallel of pi's
|
|
254
|
-
`/af-agents-team`); use `/orchestrate team=<name> <task>` to disambiguate when the
|
|
255
|
-
task text starts with a word that collides with a team key.
|
|
256
|
-
|
|
257
|
-
**Guided-setup behaviour.** `guided-workspace-setup` offers `/orchestrate`
|
|
258
|
-
**`★`-recommended** for claude-code + opencode (hidden for pi via the existing
|
|
259
|
-
source-availability filter — there is no `.pi/prompts/af-orchestrate.md`), and
|
|
260
|
-
installs the agent's `orchestrate-teams.yaml` as a **companion** of the command
|
|
261
|
-
(a user-edited config is preserved on uninstall, never silently clobbered).
|
|
262
|
-
Two artifacts stay **claude-only**: the lifecycle **hooks** (they register into
|
|
263
|
-
`.claude/settings.json`, which opencode/pi have no install path for) and the
|
|
264
|
-
**`AskUserQuestion` questionnaire menu mode** (the primary menu interaction on
|
|
265
|
-
claude-code). The orchestrate command and its team config are *not* claude-only —
|
|
266
|
-
they ship for opencode too.
|
|
311
|
+
## Coms-backed team members
|
|
312
|
+
|
|
313
|
+
A team member the `agent-hub` harness dispatches (`.pi/agents/teams.yaml`) can be
|
|
314
|
+
served by a live coms peer of the same name instead of a freshly spawned native
|
|
315
|
+
subagent. With the default `backend: "auto"`,
|
|
316
|
+
`.pi/agents/dispatch-policy.yaml` decides that per member at dispatch time;
|
|
317
|
+
explicit `native` bypasses substitution, while explicit `coms` requires the
|
|
318
|
+
peer and never falls back. `.pi/agents/peers.yaml` decides *how* each peer runs.
|
|
319
|
+
A peer with `runner: claude-code` is an interactive Claude Code pane plus its
|
|
320
|
+
bridge — the one way Claude Code takes part in a fleet. See
|
|
321
|
+
[claude-code-coms-bridge.md](claude-code-coms-bridge.md).
|
|
322
|
+
|
|
323
|
+
Installing `skill:peer-coms` pulls `hook:coms-stop-hook` in as a companion, which
|
|
324
|
+
is what gives a bridged pane exact turn text instead of scraped output.
|
|
325
|
+
Registering that hook in `.claude/settings.json` stays the user's step — the
|
|
326
|
+
installer writes files, and another tool's settings file is not its to merge.
|
|
267
327
|
|
|
268
328
|
## Templates
|
|
269
329
|
|
|
@@ -324,11 +384,11 @@ Edit the workspace, not this file — the next apply overwrites it.
|
|
|
324
384
|
```markdown
|
|
325
385
|
# Agent Fleet — Workspace Setup
|
|
326
386
|
#
|
|
327
|
-
# Generated from .ai/agent-fleet-state.json by `agent-fleet
|
|
387
|
+
# Generated from .ai/agent-fleet-state.json by `agent-fleet setup`.
|
|
328
388
|
# Edit the workspace, not this file: it is rewritten on every apply.
|
|
329
389
|
|
|
330
390
|
## workspace-summary
|
|
331
|
-
agent:
|
|
391
|
+
agent: pi
|
|
332
392
|
method: copy
|
|
333
393
|
version: 1.4.2
|
|
334
394
|
source: /home/you/.npm/_npx/<hash>/node_modules/@chankov/agent-fleet
|
|
@@ -344,7 +404,7 @@ external: []
|
|
|
344
404
|
updated: 2026-05-22
|
|
345
405
|
|
|
346
406
|
## verification
|
|
347
|
-
- 21 item(s) recorded; run `agent-fleet
|
|
407
|
+
- 21 item(s) recorded; run `agent-fleet doctor` for diagnostics.
|
|
348
408
|
- No secrets are stored in this file or in .ai/agent-fleet-state.json.
|
|
349
409
|
```
|
|
350
410
|
|
|
@@ -6,6 +6,14 @@ Code itself asks pi peers questions mid-task via `coms-cli`. Requires a running
|
|
|
6
6
|
[herdr](https://herdr.dev) server (the bridge drives the Claude pane through herdr's
|
|
7
7
|
socket API).
|
|
8
8
|
|
|
9
|
+
> **This is the only role Claude Code has in Agent Fleet.** It is not a coding-agent
|
|
10
|
+
> install target: deterministic `agent-fleet setup` targets pi and nothing else, there are no
|
|
11
|
+
> `.claude/` skills, commands, or personas, and no Claude Code plugin. What a bridged
|
|
12
|
+
> pane gets is what this page describes — the `peer-coms` skill and the Stop hook,
|
|
13
|
+
> both installed under the pi agent because the *fleet* is what needs them. A Claude
|
|
14
|
+
> Code peer contributes review, research, and analysis turns over coms; it does not run
|
|
15
|
+
> the lifecycle commands or orchestrate anything.
|
|
16
|
+
|
|
9
17
|
```
|
|
10
18
|
pi hub ── coms envelope ──▶ coms-claude-bridge ── pane.send_text ──▶ Claude Code (pane)
|
|
11
19
|
pi hub ◀── response ─────── coms-claude-bridge ◀── Stop hook file ─── (turn ends)
|
|
@@ -24,6 +32,16 @@ Claude Code ── Bash: coms-cli send/await ──▶ any pi peer (o
|
|
|
24
32
|
|
|
25
33
|
## Setup
|
|
26
34
|
|
|
35
|
+
The stable `claude-bridge` setup feature selects `peer-coms` and its
|
|
36
|
+
`coms-stop-hook` companion. Use `agent-fleet setup --preset default --features
|
|
37
|
+
claude-bridge --yes` (or select it interactively); it puts both halves in place:
|
|
38
|
+
`.pi/skills/peer-coms/` and `.claude/hooks/coms-stop-hook.mjs`. The hook file lands under
|
|
39
|
+
`.claude/` deliberately — that is where the Claude Code process in the pane looks for it.
|
|
40
|
+
|
|
41
|
+
**Registering the hook stays a manual step.** The installer writes the file; it does not
|
|
42
|
+
touch `.claude/settings.json`, because that file is the user's own Claude Code
|
|
43
|
+
configuration and merging into it is not something a pi install should decide.
|
|
44
|
+
|
|
27
45
|
1. **Hook (recommended):** add to the project's (or user's) Claude Code `settings.json`:
|
|
28
46
|
|
|
29
47
|
```json
|
|
@@ -39,8 +57,9 @@ Claude Code ── Bash: coms-cli send/await ──▶ any pi peer (o
|
|
|
39
57
|
`<<COMS_DONE:msg_id>>` sentinel and scraping the pane — it works, but replies can
|
|
40
58
|
carry TUI noise (tool-status lines). The hook returns exact text.
|
|
41
59
|
|
|
42
|
-
2. **Skill:** install `peer-coms`
|
|
43
|
-
|
|
60
|
+
2. **Skill:** install `peer-coms` so the bridged session knows it is a peer and how to
|
|
61
|
+
use `coms-cli`. Point Claude Code at it the way you normally load project skills —
|
|
62
|
+
a `CLAUDE.md` reference to `.pi/skills/peer-coms/SKILL.md` is enough.
|
|
44
63
|
|
|
45
64
|
3. **Spawn:** either add a `runner: claude-code` peer to a peers.yaml team and
|
|
46
65
|
`just fleet team <team> --no-hub`, or attach a bridge to an existing Herdr Claude pane:
|
|
@@ -113,7 +113,7 @@ The live recipe reuses `scripts/team-up.ts --conductor`: it creates a normal her
|
|
|
113
113
|
|
|
114
114
|
### Telegram bridge control command
|
|
115
115
|
|
|
116
|
-
The outbound `hermes send` path needs a configured Telegram channel but no skill. Full reply round-trip additionally needs Agent Fleet's `hub-liaison` skill in the profile that owns the running Telegram gateway. Pi
|
|
116
|
+
The outbound `hermes send` path needs a configured Telegram channel but no skill. Full reply round-trip additionally needs Agent Fleet's `hub-liaison` skill in the profile that owns the running Telegram gateway. Pi uses the namespaced command:
|
|
117
117
|
|
|
118
118
|
```text
|
|
119
119
|
/af-set-hermes-telegram status --profile default
|