@chankov/agent-fleet 0.0.11 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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 +106 -54
- 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/index.ts +537 -369
- 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/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 +118 -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/CHANGELOG.md +142 -0
- package/README.md +117 -79
- package/agents/orchestrator.md +1 -1
- 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/review.md +0 -16
- 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/spec.md +0 -15
- package/.claude/commands/test.md +0 -19
- 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/code-simplify.md +0 -22
- 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/plan.md +0 -16
- 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-telegram.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/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
|
@@ -1,514 +1,96 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Install and lifecycle
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
the three-way merge, and does every write, so a complete install needs no coding
|
|
7
|
-
agent and no model. The `guided-workspace-setup` skill is a conversational
|
|
8
|
-
front-end over it — it asks which artifacts a project wants and drafts the
|
|
9
|
-
overrides file; the CLI does the rest.
|
|
3
|
+
`@chankov/agent-fleet` is a deterministic pi workspace installer. It needs no
|
|
4
|
+
coding agent or model: `setup`, `doctor`, and `uninstall` are the public
|
|
5
|
+
lifecycle commands.
|
|
10
6
|
|
|
11
|
-
##
|
|
7
|
+
## First install
|
|
12
8
|
|
|
13
|
-
|
|
14
|
-
|---|---|
|
|
15
|
-
| **npm package** (use this for `npm install` and the first `npx`) | `@chankov/agent-fleet` |
|
|
16
|
-
| **CLI binary** (the command the package ships) | `agent-fleet` |
|
|
17
|
-
|
|
18
|
-
The package is published under the `@chankov` npm scope to guarantee identity —
|
|
19
|
-
only [Nikolay Chankov](https://www.npmjs.com/~chankov) can publish to that
|
|
20
|
-
scope. The CLI binary stays the short name `agent-fleet` because that's what
|
|
21
|
-
goes on `PATH` after install.
|
|
22
|
-
|
|
23
|
-
So:
|
|
24
|
-
|
|
25
|
-
- First time / one-shot: `npx @chankov/agent-fleet <cmd>` — npx resolves the
|
|
26
|
-
scoped package and runs its bin.
|
|
27
|
-
- After a project / global install: `npx agent-fleet <cmd>` works too,
|
|
28
|
-
because the bin is named `agent-fleet`.
|
|
29
|
-
|
|
30
|
-
## Quick start
|
|
31
|
-
|
|
32
|
-
### Guided workspace setup
|
|
33
|
-
|
|
34
|
-
```bash
|
|
35
|
-
# In the workspace you want to configure:
|
|
36
|
-
npx @chankov/agent-fleet init
|
|
37
|
-
# Then open your coding agent in this directory and run the command it prints:
|
|
38
|
-
# Claude Code: /setup-agent-fleet
|
|
39
|
-
# Pi/OpenCode: /af-setup-agent-fleet
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
That's it. `npx` fetches the package, the CLI detects your coding agent and
|
|
43
|
-
prints the runtime-appropriate command, which runs the full guided install
|
|
44
|
-
inside your agent.
|
|
45
|
-
|
|
46
|
-
### First-class pi package
|
|
47
|
-
|
|
48
|
-
For pi users who want package-native loading instead of copied setup artifacts:
|
|
49
|
-
|
|
50
|
-
```bash
|
|
51
|
-
# Project-scoped; writes .pi/settings.json
|
|
52
|
-
pi install -l npm:@chankov/agent-fleet
|
|
53
|
-
|
|
54
|
-
# Or global for every pi session
|
|
55
|
-
pi install npm:@chankov/agent-fleet
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
The pi package manifest exposes this repo's skills, pi runtime skills, lifecycle prompts, and bundled `pi-ask-user` resources. The bundled companion provides the `ask_user` tool and `ask-user` skill without a separate `pi-ask-user` install.
|
|
59
|
-
|
|
60
|
-
It intentionally does not auto-expose this repo's own `.pi/extensions` or harness directories; install those through guided setup or the pi setup docs so their runtime dependencies are handled explicitly. `pi-codex-image-gen` is also not bundled or required; guided setup may offer it as an optional suggested external npm/pi package when package installation is available, and installs it only if selected (`pi install -l npm:pi-codex-image-gen`). Minimal setup works without it.
|
|
61
|
-
|
|
62
|
-
The package also ships assets for the **experimental Linux Codex Remote-Control conductor** (`codex/`, `systemd/`, lifecycle/wrapper scripts, recipes, and runbook). Guided setup copies those assets with selected pi harnesses but never enables systemd, edits Codex config, starts a service, or pairs a phone. Those remain explicit operator actions and support only Codex CLI `0.144.x`; see [codex-remote-conductor.md](codex-remote-conductor.md). Its managed runtime contract is created later under `$HOME/.local/state/agent-fleet/codex-conductor/`, not inside the npm package or target checkout.
|
|
63
|
-
|
|
64
|
-
## Commands
|
|
65
|
-
|
|
66
|
-
### `npx @chankov/agent-fleet init`
|
|
67
|
-
|
|
68
|
-
Materializes the package, **bootstraps the installer artifacts** into the
|
|
69
|
-
workspace, and hands off to the runtime's Agent Fleet setup command. Claude Code
|
|
70
|
-
uses unprefixed installer commands; Pi and OpenCode use `/af-setup-agent-fleet`
|
|
71
|
-
and `/af-doctor-agent-fleet`.
|
|
72
|
-
|
|
73
|
-
What `init` writes per agent:
|
|
74
|
-
|
|
75
|
-
| Agent | Files written to the workspace |
|
|
76
|
-
|---|---|
|
|
77
|
-
| `claude-code` | `.claude/commands/setup-agent-fleet.md`, `.claude/commands/doctor-agent-fleet.md`, `.claude/skills/guided-workspace-setup/SKILL.md` |
|
|
78
|
-
| `pi` | `.pi/prompts/af-setup-agent-fleet.md`, `.pi/prompts/af-doctor-agent-fleet.md`, `.pi/skills/guided-workspace-setup/SKILL.md` |
|
|
79
|
-
| `opencode` | `.opencode/commands/af-setup-agent-fleet.md`, `.opencode/commands/af-doctor-agent-fleet.md`, `.opencode/skills/guided-workspace-setup/SKILL.md` |
|
|
80
|
-
|
|
81
|
-
These are **just the plumbing** — the slash commands, plus the skill they
|
|
82
|
-
invoke. The actual catalogue (spec-driven-development, code-reviewer,
|
|
83
|
-
test-engineer, pi extensions, …) is picked by you inside the setup workflow. Re-run
|
|
84
|
-
`init` to refresh the plumbing after a package upgrade; bootstrap files
|
|
85
|
-
are always overwritten because they're scaffolding, not user data.
|
|
86
|
-
|
|
87
|
-
After the setup workflow finishes its install pass, **the bootstrap files
|
|
88
|
-
are removed by default** so they don't clutter your agent's slash-command
|
|
89
|
-
list. Re-run `npx @chankov/agent-fleet init` whenever you want the runtime's
|
|
90
|
-
setup command back, or pick the "keep the installer commands" option at the
|
|
91
|
-
setup flow's confirmation to leave them in place.
|
|
92
|
-
|
|
93
|
-
### How the skill finds the source package
|
|
94
|
-
|
|
95
|
-
`init` writes one extra file alongside the bootstrap: `.ai/.agent-fleet-bootstrap.json`.
|
|
96
|
-
This is the **authoritative** record of where the npm package lives:
|
|
97
|
-
|
|
98
|
-
```json
|
|
99
|
-
{
|
|
100
|
-
"sourceRoot": "/home/you/.npm/_npx/<hash>/node_modules/@chankov/agent-fleet",
|
|
101
|
-
"version": "0.3.0",
|
|
102
|
-
"agent": "pi",
|
|
103
|
-
"method": "copy",
|
|
104
|
-
"bootstrappedAt": "2026-05-24T..."
|
|
105
|
-
}
|
|
106
|
-
```
|
|
107
|
-
|
|
108
|
-
When the Agent Fleet setup command runs inside your agent, it reads this marker
|
|
109
|
-
*first* to find the source package. This matters on dev machines where you
|
|
110
|
-
may also have a git clone of `agent-fleet` elsewhere — the marker prevents
|
|
111
|
-
the skill from accidentally using that clone instead of the version the
|
|
112
|
-
user just installed via npm.
|
|
113
|
-
|
|
114
|
-
If the marker is missing or its `sourceRoot` no longer exists (e.g. npx
|
|
115
|
-
cleaned its cache), the skill **asks you explicitly** for the path. It
|
|
116
|
-
never scans your filesystem for other agent-fleet repos — that would
|
|
117
|
-
silently pick up forks, stale checkouts, or dev clones that aren't what
|
|
118
|
-
you installed.
|
|
119
|
-
|
|
120
|
-
The marker is removed by the same end-of-setup cleanup that removes the
|
|
121
|
-
slash commands (`agent-fleet cleanup-installer`).
|
|
122
|
-
|
|
123
|
-
| Flag | Default | Purpose |
|
|
124
|
-
|------|---------|---------|
|
|
125
|
-
| `--agent <claude-code\|opencode\|pi>` | auto-detect | Skip the agent prompt |
|
|
126
|
-
| `--workspace <path>` | `cwd` | Target workspace |
|
|
127
|
-
| `--launch` | off | Shell into the coding agent after init (best effort) |
|
|
128
|
-
|
|
129
|
-
```bash
|
|
130
|
-
npx @chankov/agent-fleet init --agent claude-code
|
|
131
|
-
npx @chankov/agent-fleet init --workspace ~/projects/foo
|
|
132
|
-
```
|
|
133
|
-
|
|
134
|
-
### `npx @chankov/agent-fleet doctor`
|
|
135
|
-
|
|
136
|
-
Finds and repairs breakage. Two sources, one report:
|
|
137
|
-
|
|
138
|
-
- **Recorded items** that are missing, dangling, or linked outside the source
|
|
139
|
-
root. These are repaired through the *same* `apply()` path `install` writes
|
|
140
|
-
with — a repaired file is byte-identical to a freshly installed one, which is
|
|
141
|
-
the structural reason setup and repair cannot drift apart.
|
|
142
|
-
- **The scan**, for what the install record cannot own: broken symlinks in a
|
|
143
|
-
pre-engine workspace, and stale persona names in `.pi/agents/*.yaml`
|
|
144
|
-
(`reviewer` → `code-reviewer`, `red-team` → `security-auditor`).
|
|
145
|
-
|
|
146
|
-
Overrides problems and malformed `peers.yaml` entries are **advisory** —
|
|
147
|
-
reported, never auto-fixed, because the fix is always a hand edit.
|
|
148
|
-
|
|
149
|
-
| Flag | Default | Purpose |
|
|
150
|
-
|------|---------|---------|
|
|
151
|
-
| `--workspace <path>` | `cwd` | Target workspace |
|
|
152
|
-
| `--agent <name>` | recorded → detected | Override the agent whose targets are checked |
|
|
153
|
-
| `--fix` | off | Apply the repairs without prompting |
|
|
154
|
-
| `--dry-run` | off | Report only; never write, never prompt |
|
|
155
|
-
| `--json` | off | Emit the machine report on stdout |
|
|
156
|
-
| `--yes` / `-y` | off | Alias for `--fix` |
|
|
157
|
-
|
|
158
|
-
| Exit code | Meaning |
|
|
159
|
-
|-----------|---------|
|
|
160
|
-
| `0` | nothing to repair |
|
|
161
|
-
| `1` | could not run |
|
|
162
|
-
| `2` | repairable issues found, advisories present, or a repair failed |
|
|
163
|
-
|
|
164
|
-
```bash
|
|
165
|
-
npx @chankov/agent-fleet doctor --workspace ~/projects/foo --dry-run
|
|
166
|
-
npx @chankov/agent-fleet doctor --fix
|
|
167
|
-
```
|
|
168
|
-
|
|
169
|
-
### `npx @chankov/agent-fleet verify`
|
|
170
|
-
|
|
171
|
-
Read-only report of the workspace against `install-manifest.json` — the
|
|
172
|
-
generated catalogue of every installable artifact. Compares three things per
|
|
173
|
-
item: what `.ai/agent-fleet-state.json` records, what is on disk, and what the
|
|
174
|
-
current package ships. Writes nothing and fixes nothing.
|
|
175
|
-
|
|
176
|
-
| Flag | Default | Purpose |
|
|
177
|
-
|------|---------|---------|
|
|
178
|
-
| `--workspace <path>` | `cwd` | Target workspace |
|
|
179
|
-
| `--agent <name>` | recorded → detected | Override the agent whose targets are checked |
|
|
180
|
-
| `--json` | off | Emit the machine report on stdout |
|
|
181
|
-
| `--no-doctor` | off | Skip the symlink/persona/overrides scan |
|
|
182
|
-
|
|
183
|
-
| Exit code | Meaning |
|
|
184
|
-
|-----------|---------|
|
|
185
|
-
| `0` | no broken items, no problem findings |
|
|
186
|
-
| `1` | could not run (bad flags, missing manifest, unreadable workspace) |
|
|
187
|
-
| `2` | problem findings, or items in a broken state |
|
|
188
|
-
|
|
189
|
-
Item states: `absent`, `linked`, `up-to-date`, `outdated`, `modified`,
|
|
190
|
-
`partial`, `conflict`, `missing`, `broken-link`, `foreign-link`, `gone`.
|
|
191
|
-
An available upgrade (`outdated`) and a deliberate local edit (`modified`) are
|
|
192
|
-
reported but do **not** fail the run — neither is a broken workspace.
|
|
193
|
-
Findings are likewise split into `problem` and `advisory`; only problems
|
|
194
|
-
affect the exit code.
|
|
195
|
-
|
|
196
|
-
```bash
|
|
197
|
-
npx @chankov/agent-fleet verify
|
|
198
|
-
npx @chankov/agent-fleet verify --agent pi --json
|
|
199
|
-
```
|
|
200
|
-
|
|
201
|
-
`--json` is also the interface `guided-workspace-setup` builds its menu from:
|
|
202
|
-
the report carries `groups` (agent-filtered headings), `profiles` (the
|
|
203
|
-
shortcuts), and per-item `subcategory`, `title`, `summary`, `recommended`,
|
|
204
|
-
`owned`, and `state` — everything a selection screen needs, from one command.
|
|
205
|
-
|
|
206
|
-
The manifest itself is generated from the repository tree, never hand-written:
|
|
207
|
-
|
|
208
|
-
```bash
|
|
209
|
-
node bin/build-manifest.js # regenerate install-manifest.json
|
|
210
|
-
node bin/build-manifest.js --check # fail if the committed copy is stale
|
|
211
|
-
```
|
|
212
|
-
|
|
213
|
-
### `npx @chankov/agent-fleet install` / `upgrade` / `uninstall`
|
|
214
|
-
|
|
215
|
-
Three verbs over the same manifest, differing only in which action classes they
|
|
216
|
-
admit. `install` acts on a selection you name; `upgrade` acts on whatever the
|
|
217
|
-
workspace already has; `uninstall` removes what the state file records.
|
|
218
|
-
|
|
219
|
-
All three write the machine state file `.ai/agent-fleet-state.json` and render
|
|
220
|
-
`.ai/agent-fleet-setup.md` from it. No coding agent and no model is involved at
|
|
221
|
-
any point.
|
|
222
|
-
|
|
223
|
-
| Flag | Applies to | Purpose |
|
|
224
|
-
|------|-----------|---------|
|
|
225
|
-
| `--profile <name[,name]>` | install | Named selections, unioned |
|
|
226
|
-
| `--items <id[,id]>` | install, uninstall | Explicit item ids |
|
|
227
|
-
| `--all` | uninstall | Remove everything the state file records |
|
|
228
|
-
| `-y, --yes` | all | Apply without the confirmation prompt |
|
|
229
|
-
| `--allow-exec` | install, upgrade | Include items that run a command |
|
|
230
|
-
| `--accept-theirs` / `--accept-ours` | install, upgrade | Resolve conflicts non-interactively |
|
|
231
|
-
| `--dry-run` | all | Print the plan, write nothing |
|
|
232
|
-
| `--json` | all | Emit the machine plan/result on stdout (needs `--yes` or `--dry-run`) |
|
|
233
|
-
|
|
234
|
-
| Exit code | Meaning |
|
|
235
|
-
|-----------|---------|
|
|
236
|
-
| `0` | applied, or nothing to do |
|
|
237
|
-
| `1` | could not plan, or a step failed partway |
|
|
238
|
-
| `3` | conflicts — changed both locally and upstream |
|
|
9
|
+
Interactive use tracks the newest release:
|
|
239
10
|
|
|
240
11
|
```bash
|
|
241
|
-
npx @chankov/agent-fleet
|
|
242
|
-
npx @chankov/agent-fleet install --items skill:test-driven-development --dry-run
|
|
243
|
-
npx @chankov/agent-fleet upgrade --dry-run
|
|
244
|
-
npx @chankov/agent-fleet upgrade --yes --accept-ours
|
|
245
|
-
npx @chankov/agent-fleet uninstall --items skill:peer-coms --yes
|
|
246
|
-
npx @chankov/agent-fleet uninstall --all --dry-run
|
|
12
|
+
npx @chankov/agent-fleet@latest setup
|
|
247
13
|
```
|
|
248
14
|
|
|
249
|
-
|
|
15
|
+
For repeatable automation, pin the exact major/minor/patch and state the
|
|
16
|
+
selection explicitly:
|
|
250
17
|
|
|
251
18
|
```bash
|
|
252
|
-
npx @chankov/agent-fleet@
|
|
19
|
+
npx @chankov/agent-fleet@1.0.0 setup --preset default --features none --yes
|
|
20
|
+
npx @chankov/agent-fleet@1.0.0 setup --preset full --features none --yes
|
|
253
21
|
```
|
|
254
22
|
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
**The two verbs treat a local edit differently, on purpose.** Selecting an item
|
|
263
|
-
in `install` is your consent to overwrite your edits to it — those items are
|
|
264
|
-
listed as `overwrites` in the plan. `upgrade` carries no such consent, so a file
|
|
265
|
-
you edited is preserved (`keep`) whenever the source did not also move. When
|
|
266
|
-
*both* changed, it is a conflict: the incoming version is written beside yours
|
|
267
|
-
as `<file>.new`, your file is left exactly as it is, and the run exits `3`.
|
|
23
|
+
**Default** is the launchable, stable Fleet Core and creates neither `.claude/`
|
|
24
|
+
nor voice configuration. **Full** selects every stable, platform-applicable
|
|
25
|
+
catalogue root; it may install the recorded Claude Code coms bridge. Features
|
|
26
|
+
are additive named capabilities, not an arbitrary package-entry mode. Use
|
|
27
|
+
`setup --help` to see feature names. Experimental Codex Remote remains opt-in
|
|
28
|
+
and operator-applied.
|
|
268
29
|
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
and settings keys we did not write are never read as drift and never rewritten.
|
|
30
|
+
`init`, `install`, `upgrade`, and `update` are compatibility aliases for
|
|
31
|
+
`setup`; new scripts should use `setup`.
|
|
272
32
|
|
|
273
|
-
|
|
274
|
-
already there. Upgrade never widens the install either; newly catalogued
|
|
275
|
-
artifacts are counted as available and added only by an explicit `install`.
|
|
33
|
+
## Desired state and migration
|
|
276
34
|
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
link at once, a `git pull` in the source silently rewrites artifacts the workspace never agreed to
|
|
282
|
-
change, and Windows needs Developer Mode. A copy plus `agent-fleet upgrade` gives the same
|
|
283
|
-
freshness with a real three-way merge behind it.
|
|
35
|
+
The desired selection lives in `.ai/agent-fleet.json`. Command-line preset and
|
|
36
|
+
feature flags are ephemeral over an existing file unless `--save-desired` is
|
|
37
|
+
passed. When the file is missing, setup writes the selected desired state in
|
|
38
|
+
the same transaction as its artifacts.
|
|
284
39
|
|
|
285
|
-
|
|
286
|
-
reports it as an advisory finding, and the next `install` or `upgrade` re-materialises every
|
|
287
|
-
linked item as a real file and flips the recorded method to `copy`. An explicit
|
|
288
|
-
`--method symlink` outside a checkout is refused rather than silently downgraded.
|
|
289
|
-
|
|
290
|
-
**`uninstall` is bound by the ownership rule.** Only paths recorded in
|
|
291
|
-
`.ai/agent-fleet-state.json` are eligible, and a recorded file whose bytes no
|
|
292
|
-
longer match what we wrote is kept and listed as skipped. Removing an item takes
|
|
293
|
-
its companions with it *unless* another installed item still needs them, and an
|
|
294
|
-
item another installed item pins is refused by name — so removing one pi
|
|
295
|
-
extension cannot delete the `package.json` five others run from, and removing
|
|
296
|
-
`damage-control-continue` while `agent-hub` is installed is refused rather than
|
|
297
|
-
silently leaving the hub without its safety harness. Removing the last pi
|
|
298
|
-
harness strips the `agent-fleet:harnesses` region from the `justfile` and leaves
|
|
299
|
-
the rest of the file alone.
|
|
300
|
-
|
|
301
|
-
**Some items the engine will not apply, by design.** Each carries a `consent`
|
|
302
|
-
class: `file` (plain writes, covered by `--yes`), `exec` (runs a command,
|
|
303
|
-
requires `--allow-exec`), `external` (a package you install yourself), and
|
|
304
|
-
`operator` (a Hermes profile, a user systemd unit, device pairing). Operator and
|
|
305
|
-
external items print their declared steps in the plan and are never performed —
|
|
306
|
-
including by `--yes`:
|
|
40
|
+
The first major-release migration is deliberately strict:
|
|
307
41
|
|
|
308
42
|
```bash
|
|
309
|
-
|
|
310
|
-
npx @chankov/agent-fleet
|
|
311
|
-
```
|
|
312
|
-
|
|
313
|
-
Both print the exact command list for a human to run and touch nothing. Their
|
|
314
|
-
targets are outside the workspace, which is the one place the engine is allowed
|
|
315
|
-
to write — so they stay reported rather than automated, and no out-of-workspace
|
|
316
|
-
path ever enters the state file.
|
|
317
|
-
|
|
318
|
-
### `npx @chankov/agent-fleet update`
|
|
319
|
-
|
|
320
|
-
Reads the workspace's `.ai/agent-fleet-setup.md`, compares the recorded
|
|
321
|
-
package version against the installed package version, and **re-installs the
|
|
322
|
-
runtime's setup command** so it is always available after an update.
|
|
323
|
-
`guided-workspace-setup` removes the installer command at the end of a run by
|
|
324
|
-
default, so a workspace that has completed setup once would otherwise have no
|
|
325
|
-
command to hand off to. The actual refresh then runs inside the coding agent via
|
|
326
|
-
that command — or, with no agent at all, via `upgrade`.
|
|
327
|
-
|
|
328
|
-
The agent and install method are recovered from the bootstrap marker written
|
|
329
|
-
at init time; if that marker was cleaned up too, `update` auto-detects the
|
|
330
|
-
agent (and prompts only when the workspace has more than one agent dir).
|
|
331
|
-
Override with `--agent` / `--method`, or preview with `--dry-run`.
|
|
43
|
+
# Preview is safe and does not require consent.
|
|
44
|
+
npx @chankov/agent-fleet@1.0.0 setup --migrate --dry-run
|
|
332
45
|
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
npm install -g @chankov/agent-fleet@latest
|
|
336
|
-
npx agent-fleet update --workspace .
|
|
337
|
-
# The setup command is now back — run the command printed by update to review diffs.
|
|
46
|
+
# Automation must name the desired state and explicitly consent to migration.
|
|
47
|
+
npx @chankov/agent-fleet@1.0.0 setup --migrate --preset default --features none --yes
|
|
338
48
|
```
|
|
339
49
|
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
Generates per-agent subagent definitions from the canonical personas in
|
|
343
|
-
`agents/*.md`. `pi` gets the canonical file unchanged; `claude-code` and
|
|
344
|
-
`opencode` get a transformed copy — `tools`/`model` translated to the target's
|
|
345
|
-
vocabulary (`read→Read`, `find/ls→Glob`, `claude-opus-*→opus`, …; `mode:
|
|
346
|
-
subagent` + tool denials for OpenCode), agent-hub-only frontmatter dropped,
|
|
347
|
-
body untouched. pi-only personas (`bowser`, `orchestrator`) are refused for
|
|
348
|
-
other agents. This is what the Agent Fleet setup workflow runs during apply; transformed installs are always
|
|
349
|
-
copies (never symlinks), recorded with `transformed: true`.
|
|
50
|
+
Migration lists each exact removal before consent and removes only unchanged,
|
|
51
|
+
state-owned legacy artifacts. Foreign or locally modified files survive.
|
|
350
52
|
|
|
351
|
-
|
|
352
|
-
|------|---------|---------|
|
|
353
|
-
| `--agent <claude-code\|opencode\|pi>` | — (required) | Target agent |
|
|
354
|
-
| `--list` | off | Print the availability matrix (persona → target path) |
|
|
355
|
-
| `--all` | off | Transform every available persona |
|
|
356
|
-
| `--workspace <path>` | — | Write into `<path>`; omit to print to stdout |
|
|
357
|
-
| `--dry-run` | off | With `--workspace`: show what would be written |
|
|
53
|
+
## Doctor and uninstall
|
|
358
54
|
|
|
359
55
|
```bash
|
|
360
|
-
npx @chankov/agent-fleet
|
|
361
|
-
npx @chankov/agent-fleet
|
|
362
|
-
npx @chankov/agent-fleet
|
|
56
|
+
npx @chankov/agent-fleet doctor # read-only; never prompts
|
|
57
|
+
npx @chankov/agent-fleet doctor --fix
|
|
58
|
+
npx @chankov/agent-fleet uninstall --all --yes
|
|
59
|
+
npx @chankov/agent-fleet uninstall --all --purge-config --yes
|
|
363
60
|
```
|
|
364
61
|
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
62
|
+
Uninstall removes only paths recorded in `.ai/agent-fleet-state.json` and
|
|
63
|
+
preserves modified recorded paths. It also preserves human configuration by
|
|
64
|
+
default: `.ai/agent-fleet.json`, `.ai/agent-fleet-overrides.md`, `.ai/stt.json`,
|
|
65
|
+
and environment files. `--purge-config` is the separate destructive gate for
|
|
66
|
+
the three human config files; environment files are never removed.
|
|
368
67
|
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
### Pinning
|
|
376
|
-
|
|
377
|
-
To pin a workspace to a specific version, install the package as a project
|
|
378
|
-
dependency instead of using `npx`:
|
|
68
|
+
A self-hosted workspace may use `just fleet uninstall --yes`. It removes ordinary
|
|
69
|
+
owned artifacts first, then the managed justfile region and launcher scripts,
|
|
70
|
+
and finally lifecycle state/journal data; the already-running command prints its
|
|
71
|
+
final report from memory. Because that removes `just fleet`, reinstall with the
|
|
72
|
+
package CLI, then use `just fleet` again:
|
|
379
73
|
|
|
380
74
|
```bash
|
|
381
|
-
|
|
382
|
-
|
|
75
|
+
npx @chankov/agent-fleet@latest setup --preset default --features none --yes
|
|
76
|
+
just fleet doctor
|
|
383
77
|
```
|
|
384
78
|
|
|
385
|
-
|
|
79
|
+
## Package-native pi install
|
|
386
80
|
|
|
387
81
|
```bash
|
|
388
|
-
|
|
389
|
-
```
|
|
390
|
-
|
|
391
|
-
### What "update" actually changes
|
|
392
|
-
|
|
393
|
-
The package update is just `npm`'s usual upgrade. The interesting part runs
|
|
394
|
-
inside the agent: `guided-workspace-setup` reads the `version:` line from
|
|
395
|
-
`.ai/agent-fleet-setup.md`, computes the delta against the current package
|
|
396
|
-
version, and surfaces per-artifact `Status` based on a three-way diff:
|
|
397
|
-
|
|
398
|
-
| Status | Means |
|
|
399
|
-
|---|---|
|
|
400
|
-
| `installed · upgrade available` | Source changed upstream; user copy still matches the old source → clean refresh |
|
|
401
|
-
| `installed · conflicting upgrade` | Source changed upstream AND user modified the copy → three-way diff shown, write requires explicit consent |
|
|
402
|
-
| `installed · removed upstream` | Artifact gone in the new version → proposed for deletion (subject to the removal-scope rule) |
|
|
403
|
-
| `not installed · new in this version` | New artifact added in the new version → offered, marked `★` if recommended |
|
|
404
|
-
|
|
405
|
-
The diff is sourced from `.versions/<recorded-version>/` inside the package —
|
|
406
|
-
a snapshot the release pipeline writes for every published version.
|
|
407
|
-
|
|
408
|
-
## Other install paths
|
|
409
|
-
|
|
410
|
-
npm is the recommended path for most users. The other two stay supported:
|
|
411
|
-
|
|
412
|
-
- **[Claude Code plugin marketplace](../README.md#quick-start)** — best UX
|
|
413
|
-
inside Claude Code. Same skills, marketplace-managed updates.
|
|
414
|
-
- **Git clone** — best for skill authors and contributors. Clone the repo and
|
|
415
|
-
work in it directly; inside an agent-fleet checkout `--method symlink` is
|
|
416
|
-
available, so an edit to an installed artifact edits the source. For any other
|
|
417
|
-
workspace, install copies and run `agent-fleet upgrade` after a `git pull`.
|
|
418
|
-
|
|
419
|
-
All three paths converge on the same `guided-workspace-setup` skill — the
|
|
420
|
-
difference is only in how the source files reach the workspace.
|
|
421
|
-
|
|
422
|
-
## CI usage
|
|
423
|
-
|
|
424
|
-
Every verb is scriptable, and a complete install needs no agent and no model:
|
|
425
|
-
|
|
426
|
-
```bash
|
|
427
|
-
mkdir fresh-repo && cd fresh-repo && git init
|
|
428
|
-
npx --yes @chankov/agent-fleet@latest install --agent pi --profile recommended --yes
|
|
429
|
-
npx --yes @chankov/agent-fleet@latest verify
|
|
430
|
-
```
|
|
431
|
-
|
|
432
|
-
Gate on the exit codes: `verify` exits `2` on drift or problem findings,
|
|
433
|
-
`upgrade` exits `3` when a file changed both locally and upstream, and `doctor`
|
|
434
|
-
exits `2` when anything repairable is left. `--json` puts the machine report on
|
|
435
|
-
stdout and nothing else.
|
|
436
|
-
|
|
437
|
-
Running the same install twice produces zero actions on the second run — that
|
|
438
|
-
is asserted by test, not left to discipline.
|
|
439
|
-
|
|
440
|
-
The conversational flow (`init` → the runtime's setup command) stays interactive
|
|
441
|
-
by design; its confirmation gates exist so a human approves every write. Pass
|
|
442
|
-
`--agent` explicitly to `init` in CI so it never prompts.
|
|
443
|
-
|
|
444
|
-
## Receiving update notifications
|
|
445
|
-
|
|
446
|
-
Three independent mechanisms surface "a new version is published" without
|
|
447
|
-
you having to remember to check. All three share a single cache at
|
|
448
|
-
`$XDG_CACHE_HOME/agent-fleet/latest-version.json` (24h TTL) so the
|
|
449
|
-
registry is hit at most once per day.
|
|
450
|
-
|
|
451
|
-
### 1. CLI update-notifier (always on)
|
|
452
|
-
|
|
453
|
-
Every `npx @chankov/agent-fleet <cmd>` invocation runs a fast cache read
|
|
454
|
-
on entry. If the cached latest version exceeds the running CLI version, a
|
|
455
|
-
banner prints to stderr before the command output:
|
|
456
|
-
|
|
457
|
-
```
|
|
458
|
-
┌──────────────────────────────────────────────────────────────┐
|
|
459
|
-
│ agent-fleet update available: 0.1.0 → 0.2.0 │
|
|
460
|
-
│ Run: npx @chankov/agent-fleet@latest update │
|
|
461
|
-
│ Releases: https://github.com/chankov/agent-fleet/releases │
|
|
462
|
-
└──────────────────────────────────────────────────────────────┘
|
|
463
|
-
```
|
|
464
|
-
|
|
465
|
-
If the cache is stale, a detached background process refreshes it for the
|
|
466
|
-
*next* invocation — the current run is never blocked.
|
|
467
|
-
|
|
468
|
-
### 2. Claude Code session-start hook
|
|
469
|
-
|
|
470
|
-
When `hooks/session-start.sh` is installed (offered in Group 18 of `/setup-agent-fleet`),
|
|
471
|
-
every new Claude Code session runs the check with a 3-second wall-clock cap.
|
|
472
|
-
If an upgrade is available, the banner is injected into the session context
|
|
473
|
-
so Claude can mention it on its first turn — e.g. *"Note: agent-fleet 0.2.0
|
|
474
|
-
is available; want me to apply it via `/setup-agent-fleet`?"*
|
|
475
|
-
|
|
476
|
-
### 3. pi extension (`agent-fleet-update-check`)
|
|
477
|
-
|
|
478
|
-
When installed from the Pi setup flow, the extension fires on the
|
|
479
|
-
first `agent_start` event of each pi session and emits a `ctx.ui.notify`
|
|
480
|
-
message in the pi UI if a newer version is published. Reads the same cache
|
|
481
|
-
as the CLI — no double-fetching.
|
|
482
|
-
|
|
483
|
-
### Opting out
|
|
484
|
-
|
|
485
|
-
Any of these environment variables disables all three:
|
|
486
|
-
|
|
487
|
-
```bash
|
|
488
|
-
export AGENT_SKILLS_NO_UPDATE_CHECK=1 # agent-fleet-specific
|
|
489
|
-
export NO_UPDATE_NOTIFIER=1 # conventional, also honoured
|
|
490
|
-
# CI=true is auto-detected — banners never appear in CI logs
|
|
82
|
+
pi install -l npm:@chankov/agent-fleet
|
|
491
83
|
```
|
|
492
84
|
|
|
493
|
-
|
|
494
|
-
|
|
495
|
-
|
|
496
|
-
|
|
497
|
-
npx @chankov/agent-fleet check-update
|
|
498
|
-
|
|
499
|
-
# Bypass the cache entirely
|
|
500
|
-
rm ~/.cache/agent-fleet/latest-version.json
|
|
501
|
-
npx @chankov/agent-fleet check-update
|
|
502
|
-
```
|
|
85
|
+
This exposes package-native skills and prompts. Do not also copy the same skills
|
|
86
|
+
and prompts into `.pi/`; `doctor` reports that ownership overlap. Harness-only
|
|
87
|
+
composition is supported: package-native skills/prompts with copied Fleet Core
|
|
88
|
+
harnesses.
|
|
503
89
|
|
|
504
|
-
##
|
|
90
|
+
## Safety contract
|
|
505
91
|
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
- **The version-aware menu shows `(snapshot missing)`.** The recorded version
|
|
512
|
-
is older than the snapshot retention in this package. The skill falls back
|
|
513
|
-
to "treat installed copy as canonical" — refresh manually if you want to
|
|
514
|
-
reset the baseline.
|
|
92
|
+
All lifecycle commands support `--dry-run`; JSON output requires either
|
|
93
|
+
`--dry-run` or `--yes`. Exit `0` means success/no-op, `1` failure, `2` doctor
|
|
94
|
+
findings, and `3` unresolved merge conflicts. Files outside state ownership are
|
|
95
|
+
never adopted for removal. See [Migration](MIGRATION-agent-fleet.md) for the
|
|
96
|
+
full major-release matrix.
|
|
@@ -49,8 +49,8 @@ see [.pi/extensions/pi-voice-stt/README.md](../.pi/extensions/pi-voice-stt/READM
|
|
|
49
49
|
The documented harnesses below are different: each is a **session harness**. They
|
|
50
50
|
reshape the whole pi session — some set orchestration/UI surfaces and some gate every
|
|
51
51
|
tool call. The unified `just fleet` entry point composes them with a deterministic
|
|
52
|
-
Fleet Core: `damage-control-continue`, `ask-user-remote`,
|
|
53
|
-
BTW, and the update checker. `just fleet hub` adds `agent-hub`; `just fleet peer`
|
|
52
|
+
Fleet Core: `damage-control-continue`, `ask-user-remote`, Compact & Continue,
|
|
53
|
+
BTW, and the update checker. Voice is an optional feature, not Default Fleet Core. `just fleet hub` adds `agent-hub`; `just fleet peer`
|
|
54
54
|
adds standalone coms. Harnesses live in **`.pi/harnesses/`** — a directory pi does
|
|
55
55
|
*not* auto-discover — so a plain `pi` run still loads no safety/orchestration harness.
|
|
56
56
|
|
|
@@ -116,7 +116,7 @@ surface, requirements, and per-extension upstream changes.
|
|
|
116
116
|
### Migration: retired hard-stop harness
|
|
117
117
|
|
|
118
118
|
The former `.pi/harnesses/damage-control/` hard-stop harness and its standalone recipe
|
|
119
|
-
are retired. Refresh pi harnesses with `agent-fleet
|
|
119
|
+
are retired. Refresh pi harnesses with `agent-fleet setup` (which
|
|
120
120
|
calls it): removal is bound by the ownership rule, so only an unchanged, recorded copy
|
|
121
121
|
goes — user-modified and unowned copies are preserved, and the managed `justfile` region
|
|
122
122
|
is refreshed without touching recipes outside the sentinels. Use `damage-control-continue` for standalone and
|
|
@@ -329,7 +329,7 @@ These ported files are runtime dependencies of the extensions above:
|
|
|
329
329
|
automation, used by the `bowser` agent persona. Kept separate from the core
|
|
330
330
|
engineering `skills/`. It drives the external **Playwright Agent CLI**
|
|
331
331
|
(`playwright-cli`), which is **not** bundled — install it once with
|
|
332
|
-
`npm install -g @playwright/cli@latest` (
|
|
332
|
+
`npm install -g @playwright/cli@latest` (deterministic setup checks for it when
|
|
333
333
|
`bowser` is selected). Docs: <https://playwright.dev/agent-cli/installation>.
|
|
334
334
|
- **`docs/pi-specs/`** — the original design specifications: `agent-forge` (now consolidated
|
|
335
335
|
into `agent-hub`), `agent-workflow` (retired `agent-chain`), and `damage-control`.
|