@chankov/agent-fleet 0.0.9 → 0.0.11
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/.claude/commands/doctor-agent-fleet.md +12 -7
- package/.claude/commands/setup-agent-fleet.md +7 -15
- package/.opencode/commands/af-doctor-agent-fleet.md +12 -7
- package/.opencode/commands/af-setup-agent-fleet.md +8 -6
- package/.pi/extensions/agent-fleet-update-check/README.md +2 -3
- package/.pi/extensions/btw/README.md +5 -4
- package/.pi/extensions/chrome-devtools-mcp/README.md +3 -6
- package/.pi/extensions/compact-and-continue/README.md +3 -3
- package/.pi/extensions/mcp-bridge/README.md +1 -1
- package/.pi/extensions/pi-voice-stt/README.md +3 -0
- package/.pi/harnesses/agent-hub/README.md +142 -10
- package/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.pi/harnesses/agent-hub/index.ts +448 -39
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.pi/harnesses/agent-hub/run-budget.js +302 -4
- package/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/prompts/af-doctor-agent-fleet.md +13 -6
- package/.pi/prompts/af-setup-agent-fleet.md +7 -15
- package/.versions/0.0.10/.claude/commands/build.md +44 -0
- package/.versions/0.0.10/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.10/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.10/.claude/commands/doctor-agent-fleet.md +22 -0
- package/.versions/0.0.10/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.10/.claude/commands/plan.md +16 -0
- package/.versions/0.0.10/.claude/commands/prime.md +22 -0
- package/.versions/0.0.10/.claude/commands/review.md +16 -0
- package/.versions/0.0.10/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.10/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.versions/0.0.10/.claude/commands/setup-agent-fleet.md +17 -0
- package/.versions/0.0.10/.claude/commands/ship.md +72 -0
- package/.versions/0.0.10/.claude/commands/spec.md +15 -0
- package/.versions/0.0.10/.claude/commands/test.md +19 -0
- package/.versions/0.0.10/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.10/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.10/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.10/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.10/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.10/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.10/.opencode/commands/af-doctor-agent-fleet.md +22 -0
- package/.versions/0.0.10/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.10/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.10/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.10/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.10/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.10/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.10/.opencode/commands/af-setup-agent-fleet.md +17 -0
- package/.versions/0.0.10/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.10/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.10/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.10/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.10/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.10/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.10/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/0.0.10/.pi/agents/peers.yaml +142 -0
- package/.versions/0.0.10/.pi/agents/teams.yaml +41 -0
- package/.versions/0.0.10/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.10/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/0.0.10/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.10/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.10/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.10/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.10/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.10/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.10/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/0.0.10/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.10/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.10/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.10/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.10/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.10/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.10/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.10/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.10/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.10/.pi/extensions/package.json +9 -0
- package/.versions/0.0.10/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.10/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.10/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.10/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.10/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.10/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.10/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/README.md +1001 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/footer.ts +31 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/helpers.ts +248 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/index.ts +9111 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/run-budget.js +479 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/0.0.10/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/0.0.10/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.10/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.10/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.10/.pi/harnesses/coms/README.md +100 -0
- package/.versions/0.0.10/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/0.0.10/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.10/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/0.0.10/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/0.0.10/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.10/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.10/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/0.0.10/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/0.0.10/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.10/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/0.0.10/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.10/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/0.0.10/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.10/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.10/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.10/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.10/.pi/prompts/af-doctor-agent-fleet.md +22 -0
- package/.versions/0.0.10/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.10/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.10/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.10/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.10/.pi/prompts/af-setup-agent-fleet.md +19 -0
- package/.versions/0.0.10/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.10/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.10/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.10/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.10/.version +1 -0
- package/.versions/0.0.10/agents/architect.md +24 -0
- package/.versions/0.0.10/agents/bowser.md +27 -0
- package/.versions/0.0.10/agents/builder.md +54 -0
- package/.versions/0.0.10/agents/code-reviewer.md +208 -0
- package/.versions/0.0.10/agents/deep-researcher.md +32 -0
- package/.versions/0.0.10/agents/documenter.md +18 -0
- package/.versions/0.0.10/agents/orchestrator.md +72 -0
- package/.versions/0.0.10/agents/plan-reviewer.md +83 -0
- package/.versions/0.0.10/agents/planner.md +70 -0
- package/.versions/0.0.10/agents/releaser.md +24 -0
- package/.versions/0.0.10/agents/researcher.md +28 -0
- package/.versions/0.0.10/agents/security-auditor.md +167 -0
- package/.versions/0.0.10/agents/test-engineer.md +153 -0
- package/.versions/0.0.10/agents/web-debugger.md +43 -0
- package/.versions/0.0.10/agents/web-performance-auditor.md +193 -0
- package/.versions/0.0.10/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.10/docs/ARCHITECTURE.md +303 -0
- package/.versions/0.0.10/docs/agent-fleet-setup.md +377 -0
- package/.versions/0.0.10/docs/claude-code-coms-bridge.md +109 -0
- package/.versions/0.0.10/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.10/docs/coms-hermes-bridge.md +189 -0
- package/.versions/0.0.10/docs/getting-started.md +254 -0
- package/.versions/0.0.10/docs/npm-install.md +514 -0
- package/.versions/0.0.10/docs/opencode-setup.md +281 -0
- package/.versions/0.0.10/docs/pi-extensions.md +363 -0
- package/.versions/0.0.10/docs/pi-setup.md +571 -0
- package/.versions/0.0.10/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.10/hermes/README.md +347 -0
- package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.10/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/0.0.10/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.10/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.10/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.10/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/0.0.10/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/0.0.10/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.10/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/0.0.10/hooks/hooks.json +14 -0
- package/.versions/0.0.10/hooks/session-start.sh +74 -0
- package/.versions/0.0.10/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.10/install-manifest.json +3615 -0
- package/.versions/0.0.10/justfile +254 -0
- package/.versions/0.0.10/manifest-meta.json +472 -0
- package/.versions/0.0.10/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.10/references/definition-of-done.md +67 -0
- package/.versions/0.0.10/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.10/references/observability-checklist.md +91 -0
- package/.versions/0.0.10/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.10/references/performance-checklist.md +153 -0
- package/.versions/0.0.10/references/prompting-patterns.md +380 -0
- package/.versions/0.0.10/references/security-checklist.md +179 -0
- package/.versions/0.0.10/references/testing-patterns.md +236 -0
- package/.versions/0.0.10/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.10/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.10/scripts/coms-claude-bridge.ts +401 -0
- package/.versions/0.0.10/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.10/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.10/scripts/fleet.ts +168 -0
- package/.versions/0.0.10/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.10/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/0.0.10/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/0.0.10/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/0.0.10/scripts/lib/claude-bridge-core.ts +165 -0
- package/.versions/0.0.10/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.10/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.10/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/0.0.10/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.10/scripts/lib/fleet-command.ts +111 -0
- package/.versions/0.0.10/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/0.0.10/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.10/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/0.0.10/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.10/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.10/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.10/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.10/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.10/scripts/lib/monitor-env.ts +120 -0
- package/.versions/0.0.10/scripts/lib/peer-launch.ts +314 -0
- package/.versions/0.0.10/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.10/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.10/scripts/lib/team-project.ts +193 -0
- package/.versions/0.0.10/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.10/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.10/scripts/peer-launch.ts +259 -0
- package/.versions/0.0.10/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.10/scripts/team-up.ts +360 -0
- package/.versions/0.0.10/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.10/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/0.0.10/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.10/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.10/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.10/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.10/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.10/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.10/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.10/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.10/skills/guided-workspace-setup/SKILL.md +226 -0
- package/.versions/0.0.10/skills/guided-workspace-setup/companion-manifest.json +38 -0
- package/.versions/0.0.10/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.10/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.10/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.10/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.10/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.10/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.10/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.10/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.10/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.10/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.10/skills/planning-and-task-breakdown/SKILL.md +254 -0
- package/.versions/0.0.10/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.10/skills/spec-driven-development/SKILL.md +257 -0
- package/.versions/0.0.10/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.10/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.10/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/.versions/0.0.11/.claude/commands/build.md +44 -0
- package/.versions/0.0.11/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.11/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.11/.claude/commands/doctor-agent-fleet.md +22 -0
- package/.versions/0.0.11/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.11/.claude/commands/plan.md +16 -0
- package/.versions/0.0.11/.claude/commands/prime.md +22 -0
- package/.versions/0.0.11/.claude/commands/review.md +16 -0
- package/.versions/0.0.11/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.11/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.versions/0.0.11/.claude/commands/setup-agent-fleet.md +17 -0
- package/.versions/0.0.11/.claude/commands/ship.md +72 -0
- package/.versions/0.0.11/.claude/commands/spec.md +15 -0
- package/.versions/0.0.11/.claude/commands/test.md +19 -0
- package/.versions/0.0.11/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.11/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.11/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.11/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.11/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.11/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.11/.opencode/commands/af-doctor-agent-fleet.md +22 -0
- package/.versions/0.0.11/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.11/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.11/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.11/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.11/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.11/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.11/.opencode/commands/af-setup-agent-fleet.md +17 -0
- package/.versions/0.0.11/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.11/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.11/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.11/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.11/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.11/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.11/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/0.0.11/.pi/agents/peers.yaml +142 -0
- package/.versions/0.0.11/.pi/agents/teams.yaml +41 -0
- package/.versions/0.0.11/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.11/.pi/extensions/btw/README.md +119 -0
- package/.versions/0.0.11/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.11/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.11/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.11/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/0.0.11/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.11/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.11/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.11/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.11/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.11/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.11/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.11/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.11/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.11/.pi/extensions/package.json +9 -0
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/README.md +204 -0
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.11/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/README.md +1004 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/footer.ts +31 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/helpers.ts +248 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/index.ts +9111 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/run-budget.js +479 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/0.0.11/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/0.0.11/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.11/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.11/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.11/.pi/harnesses/coms/README.md +100 -0
- package/.versions/0.0.11/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/0.0.11/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.11/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/0.0.11/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/0.0.11/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.11/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.11/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/0.0.11/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/0.0.11/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.11/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/0.0.11/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.11/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/0.0.11/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.11/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.11/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.11/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.11/.pi/prompts/af-doctor-agent-fleet.md +22 -0
- package/.versions/0.0.11/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.11/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.11/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.11/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.11/.pi/prompts/af-setup-agent-fleet.md +19 -0
- package/.versions/0.0.11/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.11/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.11/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.11/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.11/.version +1 -0
- package/.versions/0.0.11/agents/architect.md +24 -0
- package/.versions/0.0.11/agents/bowser.md +27 -0
- package/.versions/0.0.11/agents/builder.md +54 -0
- package/.versions/0.0.11/agents/code-reviewer.md +208 -0
- package/.versions/0.0.11/agents/deep-researcher.md +32 -0
- package/.versions/0.0.11/agents/documenter.md +18 -0
- package/.versions/0.0.11/agents/orchestrator.md +72 -0
- package/.versions/0.0.11/agents/plan-reviewer.md +83 -0
- package/.versions/0.0.11/agents/planner.md +70 -0
- package/.versions/0.0.11/agents/releaser.md +24 -0
- package/.versions/0.0.11/agents/researcher.md +28 -0
- package/.versions/0.0.11/agents/security-auditor.md +167 -0
- package/.versions/0.0.11/agents/test-engineer.md +153 -0
- package/.versions/0.0.11/agents/web-debugger.md +43 -0
- package/.versions/0.0.11/agents/web-performance-auditor.md +193 -0
- package/.versions/0.0.11/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.11/docs/ARCHITECTURE.md +303 -0
- package/.versions/0.0.11/docs/agent-fleet-setup.md +377 -0
- package/.versions/0.0.11/docs/claude-code-coms-bridge.md +109 -0
- package/.versions/0.0.11/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.11/docs/coms-hermes-bridge.md +189 -0
- package/.versions/0.0.11/docs/getting-started.md +254 -0
- package/.versions/0.0.11/docs/npm-install.md +514 -0
- package/.versions/0.0.11/docs/opencode-setup.md +281 -0
- package/.versions/0.0.11/docs/pi-extensions.md +368 -0
- package/.versions/0.0.11/docs/pi-setup.md +571 -0
- package/.versions/0.0.11/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.11/hermes/README.md +347 -0
- package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.11/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/0.0.11/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.11/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.11/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.11/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/0.0.11/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/0.0.11/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.11/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/0.0.11/hooks/hooks.json +14 -0
- package/.versions/0.0.11/hooks/session-start.sh +74 -0
- package/.versions/0.0.11/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.11/install-manifest.json +3615 -0
- package/.versions/0.0.11/justfile +254 -0
- package/.versions/0.0.11/manifest-meta.json +472 -0
- package/.versions/0.0.11/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.11/references/definition-of-done.md +67 -0
- package/.versions/0.0.11/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.11/references/observability-checklist.md +91 -0
- package/.versions/0.0.11/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.11/references/performance-checklist.md +153 -0
- package/.versions/0.0.11/references/prompting-patterns.md +380 -0
- package/.versions/0.0.11/references/security-checklist.md +179 -0
- package/.versions/0.0.11/references/testing-patterns.md +236 -0
- package/.versions/0.0.11/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.11/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.11/scripts/coms-claude-bridge.ts +401 -0
- package/.versions/0.0.11/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.11/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.11/scripts/fleet.ts +168 -0
- package/.versions/0.0.11/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.11/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/0.0.11/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/0.0.11/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/0.0.11/scripts/lib/claude-bridge-core.ts +165 -0
- package/.versions/0.0.11/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.11/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.11/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/0.0.11/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.11/scripts/lib/fleet-command.ts +111 -0
- package/.versions/0.0.11/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/0.0.11/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.11/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/0.0.11/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.11/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.11/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.11/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.11/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.11/scripts/lib/monitor-env.ts +134 -0
- package/.versions/0.0.11/scripts/lib/peer-launch.ts +314 -0
- package/.versions/0.0.11/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.11/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.11/scripts/lib/team-project.ts +193 -0
- package/.versions/0.0.11/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.11/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.11/scripts/peer-launch.ts +259 -0
- package/.versions/0.0.11/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.11/scripts/team-up.ts +360 -0
- package/.versions/0.0.11/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.11/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/0.0.11/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.11/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.11/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.11/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.11/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.11/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.11/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.11/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.11/skills/guided-workspace-setup/SKILL.md +226 -0
- package/.versions/0.0.11/skills/guided-workspace-setup/companion-manifest.json +38 -0
- package/.versions/0.0.11/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.11/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.11/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.11/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.11/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.11/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.11/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.11/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.11/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.11/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.11/skills/planning-and-task-breakdown/SKILL.md +254 -0
- package/.versions/0.0.11/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.11/skills/spec-driven-development/SKILL.md +257 -0
- package/.versions/0.0.11/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.11/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.11/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +110 -0
- package/README.md +22 -5
- package/agents/code-reviewer.md +4 -0
- package/agents/orchestrator.md +7 -1
- package/agents/plan-reviewer.md +22 -1
- package/bin/build-manifest.js +68 -0
- package/bin/cli.js +679 -49
- package/bin/lib/apply.js +641 -0
- package/bin/lib/manifest.js +731 -0
- package/bin/lib/merge-forms.js +106 -0
- package/bin/lib/plan.js +569 -0
- package/bin/lib/state.js +213 -0
- package/bin/lib/verify.js +576 -0
- package/bin/snapshot-version.js +5 -0
- package/docs/ARCHITECTURE.md +52 -11
- package/docs/agent-fleet-setup.md +59 -48
- package/docs/getting-started.md +29 -6
- package/docs/npm-install.md +208 -31
- package/docs/opencode-setup.md +32 -0
- package/docs/pi-extensions.md +22 -10
- package/docs/pi-setup.md +164 -69
- package/install-manifest.json +3615 -0
- package/manifest-meta.json +472 -0
- package/package.json +8 -3
- package/scripts/lib/monitor-env.ts +15 -1
- package/skills/browser-testing-with-devtools/SKILL.md +3 -4
- package/skills/guided-workspace-setup/SKILL.md +172 -490
- package/skills/planning-and-task-breakdown/SKILL.md +18 -0
- package/skills/spec-driven-development/SKILL.md +12 -0
|
@@ -0,0 +1,514 @@
|
|
|
1
|
+
# npm install path
|
|
2
|
+
|
|
3
|
+
The `@chankov/agent-fleet` package ships every skill, persona, slash command,
|
|
4
|
+
and pi extension as installable content, plus the CLI that installs them. The
|
|
5
|
+
CLI is the whole installer: it decides paths, computes per-item state, performs
|
|
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.
|
|
10
|
+
|
|
11
|
+
## Package name vs CLI name
|
|
12
|
+
|
|
13
|
+
| | Name |
|
|
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 |
|
|
239
|
+
|
|
240
|
+
```bash
|
|
241
|
+
npx @chankov/agent-fleet install --agent pi --profile recommended --yes
|
|
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
|
|
247
|
+
```
|
|
248
|
+
|
|
249
|
+
Installing into a brand-new repository takes one command and no LLM:
|
|
250
|
+
|
|
251
|
+
```bash
|
|
252
|
+
npx @chankov/agent-fleet@latest install --agent pi --profile recommended --yes
|
|
253
|
+
```
|
|
254
|
+
|
|
255
|
+
Run it without `--profile`, `--items`, or `--yes` in a terminal and it asks
|
|
256
|
+
which profile to use; piped or scripted, it requires the flags rather than
|
|
257
|
+
guessing a catalogue for you.
|
|
258
|
+
|
|
259
|
+
Profiles available: `minimal`, `recommended`, `full`, `pi-fleet-core`,
|
|
260
|
+
`hermes-plugins`, `codex-bridge`.
|
|
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`.
|
|
268
|
+
|
|
269
|
+
Files shared with you — the `justfile` managed region and `.claude/settings.json`
|
|
270
|
+
— are only partly ours. Recipes outside the `agent-fleet:harnesses` sentinels
|
|
271
|
+
and settings keys we did not write are never read as drift and never rewritten.
|
|
272
|
+
|
|
273
|
+
A selection never removes anything — installing a narrower profile keeps what is
|
|
274
|
+
already there. Upgrade never widens the install either; newly catalogued
|
|
275
|
+
artifacts are counted as available and added only by an explicit `install`.
|
|
276
|
+
|
|
277
|
+
**Artifacts are installed as copies, always.** `--method symlink` is accepted only when the
|
|
278
|
+
workspace is itself an agent-fleet checkout (its `package.json` names `@chankov/agent-fleet`) —
|
|
279
|
+
the one place where editing an installed artifact is *meant* to edit the source. Anywhere else a
|
|
280
|
+
symlink install is a trap: the link target can never move again, an npx cache clean breaks every
|
|
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.
|
|
284
|
+
|
|
285
|
+
A workspace that recorded `symlink` before this restriction is not left half-supported: `verify`
|
|
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`:
|
|
307
|
+
|
|
308
|
+
```bash
|
|
309
|
+
npx @chankov/agent-fleet install --agent pi --profile hermes-plugins --dry-run
|
|
310
|
+
npx @chankov/agent-fleet install --agent pi --profile codex-bridge --dry-run
|
|
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`.
|
|
332
|
+
|
|
333
|
+
```bash
|
|
334
|
+
# Upgrade the package itself first, then check the delta:
|
|
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.
|
|
338
|
+
```
|
|
339
|
+
|
|
340
|
+
### `npx @chankov/agent-fleet transform-persona`
|
|
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`.
|
|
350
|
+
|
|
351
|
+
| Flag | Default | Purpose |
|
|
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 |
|
|
358
|
+
|
|
359
|
+
```bash
|
|
360
|
+
npx @chankov/agent-fleet transform-persona --list --agent claude-code
|
|
361
|
+
npx @chankov/agent-fleet transform-persona --agent claude-code code-reviewer
|
|
362
|
+
npx @chankov/agent-fleet transform-persona --agent opencode --all --workspace .
|
|
363
|
+
```
|
|
364
|
+
|
|
365
|
+
## Versioning
|
|
366
|
+
|
|
367
|
+
The package follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html):
|
|
368
|
+
|
|
369
|
+
| Change | Bump |
|
|
370
|
+
|---|---|
|
|
371
|
+
| Skill removed, renamed, or its documented workflow changes; persona retired; command removed; install-record schema breakage | **major** |
|
|
372
|
+
| New skill, new persona, new command, new option in an existing skill | **minor** |
|
|
373
|
+
| Wording fix, doctor scan improvement, CLI bug fix | **patch** |
|
|
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`:
|
|
379
|
+
|
|
380
|
+
```bash
|
|
381
|
+
npm install --save-dev @chankov/agent-fleet@0.0.1
|
|
382
|
+
npx agent-fleet init # resolves to the pinned 0.0.1
|
|
383
|
+
```
|
|
384
|
+
|
|
385
|
+
Or pin globally:
|
|
386
|
+
|
|
387
|
+
```bash
|
|
388
|
+
npm install -g @chankov/agent-fleet@0.0.1
|
|
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
|
|
491
|
+
```
|
|
492
|
+
|
|
493
|
+
### Forcing a manual check
|
|
494
|
+
|
|
495
|
+
```bash
|
|
496
|
+
# Block on a single registry fetch; print the banner if outdated
|
|
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
|
+
```
|
|
503
|
+
|
|
504
|
+
## Troubleshooting
|
|
505
|
+
|
|
506
|
+
- **"Could not auto-detect your coding agent."** Pass `--agent` or run
|
|
507
|
+
`init` from a workspace that already has one of `.claude/`, `.opencode/`,
|
|
508
|
+
or `.pi/`.
|
|
509
|
+
- **`update` says "no install record".** Run `init` once first; the install
|
|
510
|
+
record is what `update` reads.
|
|
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.
|