@chankov/agent-fleet 0.0.8 → 0.0.10
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/agents/model-profiles.yaml +9 -2
- package/.pi/agents/peers.yaml +12 -16
- package/.pi/agents/teams.yaml +4 -2
- package/.pi/extensions/agent-fleet-update-check/README.md +2 -3
- package/.pi/extensions/btw/README.md +2 -2
- 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/harnesses/agent-hub/README.md +159 -15
- 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/footer.ts +4 -2
- package/.pi/harnesses/agent-hub/index.ts +552 -50
- 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/agent-hub/version.ts +25 -1
- package/.pi/harnesses/coms/README.md +8 -1
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/coms/version.ts +25 -1
- package/.pi/harnesses/damage-control-continue/README.md +8 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/version.ts +25 -1
- package/.pi/harnesses/lib/herdr-client.ts +10 -1
- package/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.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.9/.claude/commands/build.md +44 -0
- package/.versions/0.0.9/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.9/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.9/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.9/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.9/.claude/commands/plan.md +16 -0
- package/.versions/0.0.9/.claude/commands/prime.md +22 -0
- package/.versions/0.0.9/.claude/commands/review.md +16 -0
- package/.versions/0.0.9/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.9/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.versions/0.0.9/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.9/.claude/commands/ship.md +72 -0
- package/.versions/0.0.9/.claude/commands/spec.md +15 -0
- package/.versions/0.0.9/.claude/commands/test.md +19 -0
- package/.versions/0.0.9/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.9/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.9/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.9/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.9/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.9/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.9/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.9/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.9/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.9/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.9/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.9/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.9/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.9/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.9/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.9/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.9/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.9/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.9/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.9/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.9/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/0.0.9/.pi/agents/peers.yaml +142 -0
- package/.versions/0.0.9/.pi/agents/teams.yaml +41 -0
- package/.versions/0.0.9/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.9/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.9/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.9/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.9/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.9/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.9/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.9/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.9/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.9/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.9/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.9/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.9/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.9/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.9/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.9/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.9/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.9/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.9/.pi/extensions/package.json +9 -0
- package/.versions/0.0.9/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.9/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.9/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.9/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.9/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.9/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.9/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/README.md +872 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/footer.ts +31 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/helpers.ts +248 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/index.ts +8702 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/run-budget.js +181 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/0.0.9/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/0.0.9/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.9/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.9/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.9/.pi/harnesses/coms/README.md +100 -0
- package/.versions/0.0.9/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/0.0.9/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.9/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/0.0.9/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/0.0.9/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.9/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.9/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/0.0.9/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/0.0.9/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.9/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/0.0.9/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.9/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/0.0.9/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.9/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.9/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.9/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.9/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.9/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.9/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.9/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.9/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.9/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.9/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.9/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.9/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.9/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.9/.version +1 -0
- package/.versions/0.0.9/agents/architect.md +24 -0
- package/.versions/0.0.9/agents/bowser.md +27 -0
- package/.versions/0.0.9/agents/builder.md +54 -0
- package/.versions/0.0.9/agents/code-reviewer.md +204 -0
- package/.versions/0.0.9/agents/deep-researcher.md +32 -0
- package/.versions/0.0.9/agents/documenter.md +18 -0
- package/.versions/0.0.9/agents/orchestrator.md +66 -0
- package/.versions/0.0.9/agents/plan-reviewer.md +62 -0
- package/.versions/0.0.9/agents/planner.md +70 -0
- package/.versions/0.0.9/agents/releaser.md +24 -0
- package/.versions/0.0.9/agents/researcher.md +28 -0
- package/.versions/0.0.9/agents/security-auditor.md +167 -0
- package/.versions/0.0.9/agents/test-engineer.md +153 -0
- package/.versions/0.0.9/agents/web-debugger.md +43 -0
- package/.versions/0.0.9/agents/web-performance-auditor.md +193 -0
- package/.versions/0.0.9/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.9/docs/ARCHITECTURE.md +262 -0
- package/.versions/0.0.9/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.9/docs/claude-code-coms-bridge.md +109 -0
- package/.versions/0.0.9/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.9/docs/coms-hermes-bridge.md +189 -0
- package/.versions/0.0.9/docs/getting-started.md +231 -0
- package/.versions/0.0.9/docs/npm-install.md +337 -0
- package/.versions/0.0.9/docs/opencode-setup.md +249 -0
- package/.versions/0.0.9/docs/pi-extensions.md +356 -0
- package/.versions/0.0.9/docs/pi-setup.md +476 -0
- package/.versions/0.0.9/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.9/hermes/README.md +347 -0
- package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.9/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/0.0.9/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.9/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.9/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.9/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/0.0.9/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/0.0.9/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.9/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/0.0.9/hooks/hooks.json +14 -0
- package/.versions/0.0.9/hooks/session-start.sh +74 -0
- package/.versions/0.0.9/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.9/justfile +254 -0
- package/.versions/0.0.9/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.9/references/definition-of-done.md +67 -0
- package/.versions/0.0.9/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.9/references/observability-checklist.md +91 -0
- package/.versions/0.0.9/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.9/references/performance-checklist.md +153 -0
- package/.versions/0.0.9/references/prompting-patterns.md +380 -0
- package/.versions/0.0.9/references/security-checklist.md +179 -0
- package/.versions/0.0.9/references/testing-patterns.md +236 -0
- package/.versions/0.0.9/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.9/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.9/scripts/coms-claude-bridge.ts +401 -0
- package/.versions/0.0.9/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.9/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.9/scripts/fleet.ts +168 -0
- package/.versions/0.0.9/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.9/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/0.0.9/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/0.0.9/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/0.0.9/scripts/lib/claude-bridge-core.ts +165 -0
- package/.versions/0.0.9/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.9/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.9/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/0.0.9/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.9/scripts/lib/fleet-command.ts +111 -0
- package/.versions/0.0.9/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/0.0.9/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.9/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/0.0.9/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.9/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.9/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.9/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.9/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.9/scripts/lib/monitor-env.ts +120 -0
- package/.versions/0.0.9/scripts/lib/peer-launch.ts +314 -0
- package/.versions/0.0.9/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.9/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.9/scripts/lib/team-project.ts +193 -0
- package/.versions/0.0.9/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.9/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.9/scripts/peer-launch.ts +259 -0
- package/.versions/0.0.9/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.9/scripts/team-up.ts +360 -0
- package/.versions/0.0.9/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.9/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.9/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.9/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.9/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.9/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.9/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.9/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.9/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.9/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.9/skills/guided-workspace-setup/SKILL.md +544 -0
- package/.versions/0.0.9/skills/guided-workspace-setup/companion-manifest.json +38 -0
- package/.versions/0.0.9/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.9/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.9/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.9/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.9/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.9/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.9/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.9/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.9/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.9/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.9/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.9/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.9/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.9/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.9/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.9/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +141 -0
- package/README.md +22 -5
- package/agents/architect.md +1 -0
- package/agents/bowser.md +1 -0
- package/agents/builder.md +1 -0
- package/agents/code-reviewer.md +8 -5
- package/agents/deep-researcher.md +2 -1
- package/agents/orchestrator.md +8 -1
- package/agents/plan-reviewer.md +25 -2
- package/agents/planner.md +3 -2
- package/agents/security-auditor.md +1 -0
- package/agents/test-engineer.md +3 -1
- package/agents/web-debugger.md +1 -0
- package/agents/web-performance-auditor.md +1 -0
- package/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 +53 -12
- 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 +83 -13
- package/docs/pi-setup.md +164 -69
- package/install-manifest.json +3615 -0
- package/justfile +10 -1
- package/manifest-meta.json +472 -0
- package/package.json +8 -3
- package/scripts/fleet.ts +22 -3
- package/scripts/lib/fleet-command.ts +5 -3
- package/scripts/lib/herdr-layout.ts +18 -0
- package/scripts/lib/peer-launch.ts +314 -0
- package/scripts/lib/team-project.ts +3 -1
- package/scripts/peer-launch.ts +259 -0
- package/skills/browser-testing-with-devtools/SKILL.md +3 -4
- package/skills/guided-workspace-setup/SKILL.md +172 -490
- package/skills/guided-workspace-setup/companion-manifest.json +2 -0
- package/skills/planning-and-task-breakdown/SKILL.md +18 -0
- package/skills/spec-driven-development/SKILL.md +12 -0
- package/.pi/harnesses/agent-hub/spawned-peers.js +0 -74
package/bin/cli.js
CHANGED
|
@@ -22,6 +22,11 @@ import { createInterface } from "node:readline/promises";
|
|
|
22
22
|
import { stdin, stdout, exit } from "node:process";
|
|
23
23
|
|
|
24
24
|
import { runDoctor } from "./lib/doctor.js";
|
|
25
|
+
import { loadManifest } from "./lib/manifest.js";
|
|
26
|
+
import { runVerify, hasDrift } from "./lib/verify.js";
|
|
27
|
+
import { buildPlan, hasConflicts, isNoop } from "./lib/plan.js";
|
|
28
|
+
import { applyPlan } from "./lib/apply.js";
|
|
29
|
+
import { readState, readLegacyRecord, isAgentFleetCheckout, STATE_REL_PATH } from "./lib/state.js";
|
|
25
30
|
import { listPersonas, transformPersona } from "./lib/transform-persona.js";
|
|
26
31
|
import { detectAgent, agentLabel, AGENTS } from "./lib/detect-agent.js";
|
|
27
32
|
import { checkAndNotify } from "./lib/update-notifier.js";
|
|
@@ -61,6 +66,13 @@ const parsed = (() => {
|
|
|
61
66
|
force: { type: "boolean" },
|
|
62
67
|
restart: { type: "boolean" },
|
|
63
68
|
"dry-run": { type: "boolean" },
|
|
69
|
+
json: { type: "boolean" },
|
|
70
|
+
"no-doctor": { type: "boolean" },
|
|
71
|
+
items: { type: "string" },
|
|
72
|
+
"allow-exec": { type: "boolean" },
|
|
73
|
+
"accept-theirs": { type: "boolean" },
|
|
74
|
+
"accept-ours": { type: "boolean" },
|
|
75
|
+
fix: { type: "boolean" },
|
|
64
76
|
launch: { type: "boolean" },
|
|
65
77
|
all: { type: "boolean" },
|
|
66
78
|
list: { type: "boolean" },
|
|
@@ -86,13 +98,20 @@ if (opts.help) {
|
|
|
86
98
|
// the banner prints to stderr before the command output. If the cache is
|
|
87
99
|
// stale, a background fetch refreshes it for the next invocation.
|
|
88
100
|
// `update` skips this since it has its own version-delta reporting.
|
|
89
|
-
|
|
101
|
+
// `verify` stays out of it as well: it is a machine contract (exit codes +
|
|
102
|
+
// --json), and a banner racing onto the stream helps nobody scripting it.
|
|
103
|
+
// `install` and `upgrade` join it for the same reason.
|
|
104
|
+
if (!["update", "check-update", "verify", "install", "upgrade", "uninstall", "doctor"].includes(sub)) {
|
|
90
105
|
checkAndNotify(pkg.version);
|
|
91
106
|
}
|
|
92
107
|
|
|
93
108
|
switch (sub) {
|
|
94
109
|
case "init": await cmdInit(); break;
|
|
95
110
|
case "doctor": await cmdDoctor(); break;
|
|
111
|
+
case "verify": await cmdVerify(); break;
|
|
112
|
+
case "install": await cmdPlanVerb("install"); break;
|
|
113
|
+
case "upgrade": await cmdPlanVerb("upgrade"); break;
|
|
114
|
+
case "uninstall": await cmdPlanVerb("uninstall"); break;
|
|
96
115
|
case "update": await cmdUpdate(); break;
|
|
97
116
|
case "check-update": await cmdCheckUpdate(); break;
|
|
98
117
|
case "cleanup-installer": await cmdCleanupInstaller(); break;
|
|
@@ -177,10 +196,7 @@ async function cmdInit() {
|
|
|
177
196
|
const agent = await chooseAgent(opts.agent);
|
|
178
197
|
console.log(`Coding agent: ${agentLabel(agent)}`);
|
|
179
198
|
|
|
180
|
-
const method = opts.method
|
|
181
|
-
if (!["copy", "symlink"].includes(method)) {
|
|
182
|
-
fail(`--method must be "copy" or "symlink" (got "${method}")`);
|
|
183
|
-
}
|
|
199
|
+
const method = resolveMethod(opts.method);
|
|
184
200
|
|
|
185
201
|
// Bootstrap the installer artifacts (setup + doctor + the skill they invoke).
|
|
186
202
|
// Without this, the agent has no setup command to hand off to. The command itself
|
|
@@ -219,64 +235,571 @@ async function cmdInit() {
|
|
|
219
235
|
}
|
|
220
236
|
}
|
|
221
237
|
|
|
238
|
+
// Doctor has two repair sources, and the split is deliberate:
|
|
239
|
+
//
|
|
240
|
+
// • the engine — for every item the state file records. Repair is `plan()`
|
|
241
|
+
// narrowed to the three breakage states and `apply()` executing it, so a
|
|
242
|
+
// file the doctor restores is byte-identical to one `install` writes. That
|
|
243
|
+
// is the guarantee the whole plan exists for: setup and repair cannot drift.
|
|
244
|
+
// • the legacy scan — for what the state file cannot own: broken links in a
|
|
245
|
+
// pre-engine workspace, and stale persona names inside YAML the manifest
|
|
246
|
+
// does not manage. These need rename heuristics, not a manifest lookup.
|
|
247
|
+
//
|
|
248
|
+
// Everything else the scan reports (overrides problems, malformed peer entries)
|
|
249
|
+
// is advisory: printed, never auto-fixed, because the fix is always a hand edit.
|
|
222
250
|
async function cmdDoctor() {
|
|
223
251
|
await mustBeDirectory(workspace, "workspace");
|
|
224
252
|
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
253
|
+
const ADVISORY_FINDING_TYPES = new Set(["overrides", "yaml-shape"]);
|
|
254
|
+
const plan = buildRepairPlan();
|
|
255
|
+
const repairs = plan?.actions ?? [];
|
|
228
256
|
|
|
229
|
-
|
|
257
|
+
// The two scans overlap on a broken link that the state file also records.
|
|
258
|
+
// The engine's repair wins — it rebuilds the item in the exact form the
|
|
259
|
+
// manifest declares, where the scan can only guess a replacement from the
|
|
260
|
+
// filename. Letting both fire would have the second collide with the first.
|
|
261
|
+
const enginePaths = new Set(
|
|
262
|
+
repairs.flatMap((a) => [a.target, ...(a.files ?? []).map((f) => f.path)]).filter(Boolean),
|
|
263
|
+
);
|
|
264
|
+
const findings = (await runDoctor({ workspace, sourceRoot: pkgRoot }))
|
|
265
|
+
.filter((f) => !(f.type === "broken-symlink" && enginePaths.has(f.path)));
|
|
230
266
|
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
267
|
+
const fixable = findings.filter((f) => !ADVISORY_FINDING_TYPES.has(f.type));
|
|
268
|
+
const advisory = findings.length - fixable.length;
|
|
269
|
+
const outstanding = repairs.length + fixable.length;
|
|
270
|
+
|
|
271
|
+
// The report comes first, then the question. Asking "apply 7 fixes?" before
|
|
272
|
+
// naming them is asking for a blind yes.
|
|
273
|
+
if (!opts.json) {
|
|
274
|
+
printBanner(`agent-fleet v${pkg.version} — doctor`);
|
|
275
|
+
console.log(`Workspace: ${workspace}`);
|
|
276
|
+
if (!plan) console.log(`Recorded: ${repairPlanNote}`);
|
|
277
|
+
|
|
278
|
+
if (repairs.length > 0) {
|
|
279
|
+
printSection(`Recorded items to repair (${repairs.length})`);
|
|
280
|
+
for (const a of repairs) console.log(` ${a.id} — ${a.reason}`);
|
|
281
|
+
}
|
|
282
|
+
if (findings.length > 0) {
|
|
283
|
+
printSection(`Scan findings (${findings.length})`);
|
|
284
|
+
console.log(formatFindingsTable(findings));
|
|
285
|
+
if (advisory > 0) {
|
|
286
|
+
console.log(`\n(${advisory} advisory — fix by hand per the suggestions above; never auto-applied)`);
|
|
287
|
+
}
|
|
288
|
+
}
|
|
289
|
+
}
|
|
290
|
+
|
|
291
|
+
// --fix is the documented flag; -y stays an alias for the pre-engine muscle
|
|
292
|
+
// memory, and a bare interactive run still asks.
|
|
293
|
+
const wantsFix = Boolean(opts.fix || opts.yes);
|
|
294
|
+
const willFix = outstanding > 0 && !opts["dry-run"] &&
|
|
295
|
+
(wantsFix || (!opts.json && stdin.isTTY && await confirm(
|
|
296
|
+
`\nApply the ${outstanding} suggested fix(es) now? [y/N] `,
|
|
297
|
+
)));
|
|
298
|
+
|
|
299
|
+
let applied = null;
|
|
300
|
+
let scanRepair = null;
|
|
301
|
+
if (willFix) {
|
|
302
|
+
if (repairs.length > 0) applied = applyPlan({ plan, manifest: loadManifest(pkgRoot) });
|
|
303
|
+
if (fixable.length > 0) scanRepair = await runDoctor({ workspace, sourceRoot: pkgRoot, apply: true });
|
|
304
|
+
}
|
|
305
|
+
|
|
306
|
+
const report = {
|
|
307
|
+
schemaVersion: 1,
|
|
308
|
+
verb: "doctor",
|
|
309
|
+
workspace,
|
|
310
|
+
agent: plan?.agent ?? null,
|
|
311
|
+
packageVersion: pkg.version,
|
|
312
|
+
repairs,
|
|
313
|
+
findings,
|
|
314
|
+
planNote: plan ? null : repairPlanNote,
|
|
315
|
+
applied,
|
|
316
|
+
scanRepair: scanRepair && {
|
|
317
|
+
repaired: scanRepair.repaired, deleted: scanRepair.deleted, skipped: scanRepair.skipped,
|
|
318
|
+
},
|
|
319
|
+
summary: {
|
|
320
|
+
repairs: repairs.length,
|
|
321
|
+
fixable: fixable.length,
|
|
322
|
+
advisories: advisory,
|
|
323
|
+
fixed: willFix ? outstanding - (scanRepair?.skipped ?? 0) - (applied?.summary.failed ?? 0) : 0,
|
|
324
|
+
outstanding: willFix ? (scanRepair?.skipped ?? 0) + (applied?.summary.failed ?? 0) : outstanding,
|
|
325
|
+
},
|
|
326
|
+
};
|
|
327
|
+
|
|
328
|
+
if (opts.json) {
|
|
329
|
+
process.stdout.write(JSON.stringify(report, null, 2) + "\n");
|
|
330
|
+
exit(report.summary.outstanding > 0 ? 2 : 0);
|
|
331
|
+
}
|
|
332
|
+
|
|
333
|
+
if (outstanding === 0) {
|
|
334
|
+
console.log("\n✓ Nothing to repair: no broken recorded items, no broken symlinks, no stale persona references.");
|
|
335
|
+
exit(findings.length > 0 ? 2 : 0);
|
|
234
336
|
}
|
|
235
337
|
|
|
236
|
-
console.log(`Found ${findings.length} issue(s):\n`);
|
|
237
|
-
console.log(formatFindingsTable(findings));
|
|
238
338
|
console.log();
|
|
339
|
+
if (!willFix) {
|
|
340
|
+
console.log(
|
|
341
|
+
opts["dry-run"]
|
|
342
|
+
? `${outstanding} repairable issue(s) found (--dry-run: nothing was written).`
|
|
343
|
+
: `${outstanding} repairable issue(s) found. Re-run with --fix to apply them.`,
|
|
344
|
+
);
|
|
345
|
+
exit(2);
|
|
346
|
+
}
|
|
239
347
|
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
console.log(`(${advisory} advisory finding(s) — fix by hand per the suggestions above)`);
|
|
348
|
+
if (applied) {
|
|
349
|
+
printSection("Repaired");
|
|
350
|
+
for (const r of applied.results) {
|
|
351
|
+
console.log(` ${r.status.padEnd(8)} ${r.id}${r.detail ? ` — ${r.detail}` : ""}`);
|
|
352
|
+
}
|
|
353
|
+
console.log(` state: ${applied.statePath}`);
|
|
247
354
|
}
|
|
248
|
-
if (
|
|
249
|
-
|
|
355
|
+
if (scanRepair) {
|
|
356
|
+
console.log(
|
|
357
|
+
`\nScan fixes — repaired ${scanRepair.repaired}, deleted ${scanRepair.deleted}, skipped ${scanRepair.skipped}.`,
|
|
358
|
+
);
|
|
250
359
|
}
|
|
360
|
+
console.log(
|
|
361
|
+
report.summary.outstanding > 0
|
|
362
|
+
? `\n✗ ${report.summary.outstanding} issue(s) could not be repaired — see above.`
|
|
363
|
+
: "\n✓ Doctor finished. Run `agent-fleet verify` to confirm.",
|
|
364
|
+
);
|
|
365
|
+
exit(report.summary.outstanding > 0 ? 2 : 0);
|
|
366
|
+
}
|
|
251
367
|
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
368
|
+
let repairPlanNote = null;
|
|
369
|
+
|
|
370
|
+
/**
|
|
371
|
+
* The engine half of `doctor`. Returns null (with a note) rather than failing
|
|
372
|
+
* when there is nothing to plan against — a workspace with no install record is
|
|
373
|
+
* not broken, it is simply not ours, and the scan still has something to say.
|
|
374
|
+
*/
|
|
375
|
+
function buildRepairPlan() {
|
|
376
|
+
try {
|
|
377
|
+
return buildPlan({
|
|
378
|
+
workspace,
|
|
379
|
+
sourceRoot: pkgRoot,
|
|
380
|
+
packageVersion: pkg.version,
|
|
381
|
+
manifest: loadManifest(pkgRoot),
|
|
382
|
+
verb: "repair",
|
|
383
|
+
agent: opts.agent && AGENTS.includes(opts.agent) ? opts.agent : null,
|
|
384
|
+
});
|
|
385
|
+
} catch (err) {
|
|
386
|
+
repairPlanNote = err.message;
|
|
387
|
+
return null;
|
|
255
388
|
}
|
|
389
|
+
}
|
|
390
|
+
|
|
391
|
+
async function cmdVerify() {
|
|
392
|
+
// Read-only inspection: manifest × state × disk. Never writes, never fixes.
|
|
393
|
+
// Exit 0 = clean, 2 = findings or broken items, 1 = could not run.
|
|
394
|
+
await mustBeDirectory(workspace, "workspace");
|
|
256
395
|
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
396
|
+
let manifest;
|
|
397
|
+
try { manifest = loadManifest(pkgRoot); }
|
|
398
|
+
catch (err) { fail(err.message); }
|
|
260
399
|
|
|
261
|
-
if (!
|
|
262
|
-
|
|
263
|
-
exit(0);
|
|
400
|
+
if (opts.agent && !AGENTS.includes(opts.agent)) {
|
|
401
|
+
fail(`--agent must be one of: ${AGENTS.join(", ")} (got "${opts.agent}")`);
|
|
264
402
|
}
|
|
265
403
|
|
|
266
|
-
const
|
|
404
|
+
const agent = opts.agent
|
|
405
|
+
?? readState(workspace)?.agent
|
|
406
|
+
?? readLegacyRecord(workspace)?.agent
|
|
407
|
+
?? detectAgent({ workspace, env: process.env, preferWorkspaceHints: true })
|
|
408
|
+
?? null;
|
|
409
|
+
|
|
410
|
+
const report = await runVerify({
|
|
267
411
|
workspace,
|
|
268
412
|
sourceRoot: pkgRoot,
|
|
269
|
-
|
|
413
|
+
packageVersion: pkg.version,
|
|
414
|
+
manifest,
|
|
415
|
+
agent: AGENTS.includes(agent) ? agent : null,
|
|
416
|
+
includeDoctor: !opts["no-doctor"],
|
|
270
417
|
});
|
|
271
418
|
|
|
419
|
+
if (opts.json) {
|
|
420
|
+
process.stdout.write(JSON.stringify(report, null, 2) + "\n");
|
|
421
|
+
exit(hasDrift(report) ? 2 : 0);
|
|
422
|
+
}
|
|
423
|
+
|
|
424
|
+
printBanner(`agent-fleet v${pkg.version} — verify`);
|
|
425
|
+
console.log(`Workspace: ${report.workspace}`);
|
|
426
|
+
console.log(`Agent: ${report.agent ? agentLabel(report.agent) : "(unknown)"}`);
|
|
427
|
+
console.log(
|
|
428
|
+
`State: ${
|
|
429
|
+
report.stateSource === "state-file" ? `${STATE_REL_PATH} (recorded v${report.recordedVersion})`
|
|
430
|
+
: report.stateSource === "legacy-record" ? `.ai/agent-fleet-setup.md (pre-engine, recorded v${report.recordedVersion ?? "unknown"})`
|
|
431
|
+
: "none — this workspace has no agent-fleet install record"
|
|
432
|
+
}`,
|
|
433
|
+
);
|
|
434
|
+
|
|
435
|
+
const s = report.summary;
|
|
436
|
+
console.log(
|
|
437
|
+
`\nItems: ${s.total} catalogued · ${s.installed} recorded · ${s.present} present on disk` +
|
|
438
|
+
`${s.upgradable ? ` · ${s.upgradable} outdated` : ""}${s.broken ? ` · ${s.broken} broken` : ""}`,
|
|
439
|
+
);
|
|
440
|
+
|
|
441
|
+
const notable = report.items.filter(
|
|
442
|
+
(i) => !["absent", "not-applicable", "up-to-date", "linked", "unchecked"].includes(i.state),
|
|
443
|
+
);
|
|
444
|
+
if (notable.length > 0) {
|
|
445
|
+
printSection("Items needing attention");
|
|
446
|
+
const width = Math.max(...notable.map((i) => i.state.length));
|
|
447
|
+
for (const item of notable) {
|
|
448
|
+
// The per-file note is the specific one ("link target does not exist");
|
|
449
|
+
// the item note is the general one ("not recorded"). Specific wins.
|
|
450
|
+
const detail = item.files?.[0]?.detail
|
|
451
|
+
?? item.detail
|
|
452
|
+
?? (item.changedCount ? `${item.changedCount} file(s) differ` : null);
|
|
453
|
+
console.log(` ${item.state.padEnd(width)} ${item.id}${detail ? ` — ${detail}` : ""}`);
|
|
454
|
+
}
|
|
455
|
+
}
|
|
456
|
+
|
|
457
|
+
if (report.findings.length > 0) {
|
|
458
|
+
printSection(`Findings (${s.problems} problem(s), ${s.advisories} advisory)`);
|
|
459
|
+
console.log(formatFindingsTable(report.findings));
|
|
460
|
+
if (s.advisories > 0) {
|
|
461
|
+
console.log("\n(advisories are reported but never fail the run)");
|
|
462
|
+
}
|
|
463
|
+
}
|
|
464
|
+
|
|
465
|
+
if (s.versionDrift) {
|
|
466
|
+
console.log(
|
|
467
|
+
`\nRecorded v${report.recordedVersion} → package v${report.packageVersion}: an upgrade is available.`,
|
|
468
|
+
);
|
|
469
|
+
}
|
|
470
|
+
|
|
471
|
+
console.log();
|
|
472
|
+
if (hasDrift(report)) {
|
|
473
|
+
console.log(`✗ ${s.broken} broken item(s), ${s.problems} problem finding(s).`);
|
|
474
|
+
exit(2);
|
|
475
|
+
}
|
|
476
|
+
console.log(
|
|
477
|
+
s.advisories > 0
|
|
478
|
+
? `✓ No broken items and no problems (${s.advisories} advisory).`
|
|
479
|
+
: "✓ No broken items and no findings.",
|
|
480
|
+
);
|
|
481
|
+
}
|
|
482
|
+
|
|
483
|
+
// `install`, `upgrade`, and `uninstall` differ only in which action classes
|
|
484
|
+
// they admit, so they share one command: build a plan, show it, gate on one
|
|
485
|
+
// confirmation, apply it. Every difference between them lives in the planner's
|
|
486
|
+
// decision table, not here.
|
|
487
|
+
async function cmdPlanVerb(verb) {
|
|
488
|
+
await mustBeDirectory(workspace, "workspace");
|
|
489
|
+
|
|
490
|
+
let manifest;
|
|
491
|
+
try { manifest = loadManifest(pkgRoot); }
|
|
492
|
+
catch (err) { fail(err.message); }
|
|
493
|
+
|
|
494
|
+
if (opts.agent && !AGENTS.includes(opts.agent)) {
|
|
495
|
+
fail(`--agent must be one of: ${AGENTS.join(", ")} (got "${opts.agent}")`);
|
|
496
|
+
}
|
|
497
|
+
if (opts.method) resolveMethod(opts.method); // refuses symlink outside a checkout
|
|
498
|
+
if (opts["accept-theirs"] && opts["accept-ours"]) {
|
|
499
|
+
fail("--accept-theirs and --accept-ours are mutually exclusive");
|
|
500
|
+
}
|
|
501
|
+
if (verb === "upgrade" && (opts.profile || opts.items)) {
|
|
502
|
+
fail("upgrade acts on what is already installed — use `install` to add items");
|
|
503
|
+
}
|
|
504
|
+
if (verb === "uninstall" && opts.profile) {
|
|
505
|
+
fail("uninstall names items, not profiles — use --items <id[,id]> or --all");
|
|
506
|
+
}
|
|
507
|
+
|
|
508
|
+
let profiles = splitList(opts.profile);
|
|
509
|
+
const requested = splitList(opts.items);
|
|
510
|
+
if (verb === "uninstall" && requested.length === 0 && !opts.all) {
|
|
511
|
+
// Removal is the one verb where an empty selection could plausibly mean
|
|
512
|
+
// "everything". It must be said out loud.
|
|
513
|
+
fail("uninstall needs --items <id[,id]> or an explicit --all");
|
|
514
|
+
}
|
|
515
|
+
if (verb === "install" && profiles.length === 0 && requested.length === 0) {
|
|
516
|
+
// A terminal can be asked; a pipe cannot. Guessing a profile for someone
|
|
517
|
+
// scripting this would install a catalogue they never chose.
|
|
518
|
+
if (!stdin.isTTY || opts.yes || opts.json) {
|
|
519
|
+
fail(
|
|
520
|
+
"install needs a selection: --profile <name[,name]> or --items <id[,id]>.\n" +
|
|
521
|
+
`Available profiles: ${Object.keys(manifest.profiles ?? {}).join(", ")}`,
|
|
522
|
+
);
|
|
523
|
+
}
|
|
524
|
+
profiles = [await askProfile(manifest)];
|
|
525
|
+
}
|
|
526
|
+
|
|
527
|
+
const agent = opts.agent
|
|
528
|
+
?? readState(workspace)?.agent
|
|
529
|
+
?? readLegacyRecord(workspace)?.agent
|
|
530
|
+
?? detectAgent({ workspace, env: process.env, preferWorkspaceHints: true })
|
|
531
|
+
?? null;
|
|
532
|
+
|
|
533
|
+
let plan;
|
|
534
|
+
try {
|
|
535
|
+
plan = buildPlan({
|
|
536
|
+
workspace,
|
|
537
|
+
sourceRoot: pkgRoot,
|
|
538
|
+
packageVersion: pkg.version,
|
|
539
|
+
manifest,
|
|
540
|
+
verb,
|
|
541
|
+
agent: AGENTS.includes(agent) ? agent : null,
|
|
542
|
+
method: opts.method ?? null,
|
|
543
|
+
profiles,
|
|
544
|
+
items: requested,
|
|
545
|
+
all: Boolean(opts.all),
|
|
546
|
+
allowExec: Boolean(opts["allow-exec"]),
|
|
547
|
+
accept: opts["accept-theirs"] ? "theirs" : opts["accept-ours"] ? "ours" : null,
|
|
548
|
+
});
|
|
549
|
+
} catch (err) { fail(err.message); }
|
|
550
|
+
|
|
551
|
+
if (opts["dry-run"]) {
|
|
552
|
+
if (opts.json) {
|
|
553
|
+
process.stdout.write(JSON.stringify(plan, null, 2) + "\n");
|
|
554
|
+
exit(hasConflicts(plan) ? 3 : 0);
|
|
555
|
+
}
|
|
556
|
+
printPlan(plan);
|
|
557
|
+
exit(hasConflicts(plan) ? 3 : 0);
|
|
558
|
+
}
|
|
559
|
+
|
|
560
|
+
// Nothing to do is a success, not a prompt.
|
|
561
|
+
if (isNoop(plan)) {
|
|
562
|
+
if (opts.json) {
|
|
563
|
+
process.stdout.write(JSON.stringify({ plan, applied: null }, null, 2) + "\n");
|
|
564
|
+
exit(0);
|
|
565
|
+
}
|
|
566
|
+
printPlan(plan);
|
|
567
|
+
exit(0);
|
|
568
|
+
}
|
|
569
|
+
|
|
570
|
+
// The single gate. Past this point apply() runs straight through without
|
|
571
|
+
// asking again — the plan above is what the user is agreeing to.
|
|
572
|
+
if (!opts.yes) {
|
|
573
|
+
if (opts.json) fail("--json requires --yes (or --dry-run): there is nobody to answer the prompt");
|
|
574
|
+
printPlan(plan);
|
|
575
|
+
const overwrites = plan.summary.overwrites;
|
|
576
|
+
const ok = await confirm(
|
|
577
|
+
verb === "uninstall"
|
|
578
|
+
? `\nRemove ${plan.summary.remove} item(s)? Files you have edited are kept. [y/N] `
|
|
579
|
+
: `\nApply ${plan.summary.changes} change(s)` +
|
|
580
|
+
`${overwrites ? `, overwriting local edits in ${overwrites} item(s)` : ""}? [y/N] `,
|
|
581
|
+
);
|
|
582
|
+
if (!ok) { console.log("Aborted — nothing was written."); exit(0); }
|
|
583
|
+
}
|
|
584
|
+
|
|
585
|
+
const applied = applyPlan({ plan, manifest, allowExec: Boolean(opts["allow-exec"]) });
|
|
586
|
+
|
|
587
|
+
if (opts.json) {
|
|
588
|
+
process.stdout.write(JSON.stringify({ plan, applied }, null, 2) + "\n");
|
|
589
|
+
exit(applied.summary.failed ? 1 : hasConflicts(plan) ? 3 : 0);
|
|
590
|
+
}
|
|
591
|
+
|
|
592
|
+
printApplied(plan, applied);
|
|
593
|
+
exit(applied.summary.failed ? 1 : hasConflicts(plan) ? 3 : 0);
|
|
594
|
+
}
|
|
595
|
+
|
|
596
|
+
function printApplied(plan, applied) {
|
|
597
|
+
const s = applied.summary;
|
|
598
|
+
printBanner(`agent-fleet v${pkg.version} — ${plan.verb}`);
|
|
599
|
+
console.log(`Workspace: ${applied.workspace}`);
|
|
600
|
+
console.log(`Agent: ${agentLabel(applied.agent)} Method: ${applied.method}`);
|
|
601
|
+
|
|
602
|
+
const notable = applied.results.filter(
|
|
603
|
+
(r) => !["unchanged", "not-reached"].includes(r.status),
|
|
604
|
+
);
|
|
605
|
+
if (notable.length > 0) {
|
|
606
|
+
printSection("Applied");
|
|
607
|
+
const width = Math.max(...notable.map((r) => r.status.length));
|
|
608
|
+
for (const r of notable) {
|
|
609
|
+
console.log(` ${r.status.padEnd(width)} ${r.id}${r.detail ? ` — ${r.detail}` : ""}`);
|
|
610
|
+
}
|
|
611
|
+
}
|
|
612
|
+
|
|
613
|
+
if (applied.conflictFiles.length > 0) {
|
|
614
|
+
printSection("Conflicts — your files were NOT changed");
|
|
615
|
+
for (const path of applied.conflictFiles) console.log(` ${path}`);
|
|
616
|
+
console.log(
|
|
617
|
+
"\nEach `.new` file is the incoming version. Compare, merge what you want,\n" +
|
|
618
|
+
"delete the `.new`, or re-run with --accept-theirs / --accept-ours.",
|
|
619
|
+
);
|
|
620
|
+
}
|
|
621
|
+
|
|
622
|
+
printOperatorSteps(plan.actions);
|
|
623
|
+
|
|
624
|
+
printSection("Summary");
|
|
272
625
|
console.log(
|
|
273
|
-
|
|
626
|
+
` ${s.applied} applied · ${s.adopted} adopted · ${s.removed} removed · ` +
|
|
627
|
+
`${s.skipped} skipped · ${s.unchanged} unchanged`,
|
|
274
628
|
);
|
|
629
|
+
console.log(` State: ${applied.statePath}`);
|
|
630
|
+
console.log(` Record: ${applied.recordPath}`);
|
|
631
|
+
|
|
632
|
+
console.log();
|
|
633
|
+
if (applied.failure) {
|
|
634
|
+
console.log(
|
|
635
|
+
`✗ Stopped at ${applied.failure.id}: ${applied.failure.detail}\n` +
|
|
636
|
+
` ${s.notReached} action(s) not reached. What was applied is recorded — fix the cause and re-run.`,
|
|
637
|
+
);
|
|
638
|
+
return;
|
|
639
|
+
}
|
|
640
|
+
if (applied.conflictFiles.length > 0) {
|
|
641
|
+
console.log(`✓ Applied, with ${s.conflicts} conflict(s) left for you to resolve.`);
|
|
642
|
+
return;
|
|
643
|
+
}
|
|
644
|
+
console.log("✓ Applied. Run `agent-fleet verify` to confirm.");
|
|
645
|
+
}
|
|
646
|
+
|
|
647
|
+
function printPlan(plan) {
|
|
648
|
+
const s = plan.summary;
|
|
649
|
+
printBanner(`agent-fleet v${pkg.version} — ${plan.verb} (dry run)`);
|
|
650
|
+
console.log(`Workspace: ${plan.workspace}`);
|
|
651
|
+
console.log(`Agent: ${agentLabel(plan.agent)} Method: ${plan.method}`);
|
|
652
|
+
if (plan.verb === "install") {
|
|
653
|
+
const picked = [
|
|
654
|
+
plan.selection.profiles.length ? `profiles: ${plan.selection.profiles.join(", ")}` : null,
|
|
655
|
+
plan.selection.requested.length ? `items: ${plan.selection.requested.length}` : null,
|
|
656
|
+
].filter(Boolean).join(" ");
|
|
657
|
+
console.log(`Selection: ${picked} → ${plan.selection.resolved.length} item(s) after closure`);
|
|
658
|
+
} else if (plan.verb === "uninstall") {
|
|
659
|
+
console.log(
|
|
660
|
+
`Removing: ${plan.selection.resolved.length} recorded item(s)` +
|
|
661
|
+
`${plan.selection.requested.length ? "" : " (--all)"}`,
|
|
662
|
+
);
|
|
663
|
+
} else {
|
|
664
|
+
console.log(
|
|
665
|
+
`Version: recorded v${plan.recordedVersion ?? "unknown"} → package v${plan.packageVersion}` +
|
|
666
|
+
`${plan.baseAvailable ? "" : " (no merge base — two-way comparison)"}`,
|
|
667
|
+
);
|
|
668
|
+
}
|
|
669
|
+
|
|
670
|
+
if (plan.selection.unknown.length > 0) {
|
|
671
|
+
printSection("Unknown selectors (ignored)");
|
|
672
|
+
for (const id of plan.selection.unknown) console.log(` ${id}`);
|
|
673
|
+
}
|
|
674
|
+
|
|
675
|
+
for (const note of plan.notes) console.log(`\nNote: ${note.detail}`);
|
|
676
|
+
|
|
677
|
+
// Only the interesting half. A hundred `keep` lines buries the four that matter.
|
|
678
|
+
const shown = plan.actions.filter((a) => a.kind !== "keep");
|
|
679
|
+
if (shown.length > 0) {
|
|
680
|
+
printSection("Planned actions");
|
|
681
|
+
const width = Math.max(...shown.map((a) => a.kind.length));
|
|
682
|
+
for (const a of shown) {
|
|
683
|
+
console.log(` ${a.kind.padEnd(width)} ${a.id}${a.reason ? ` — ${a.reason}` : ""}`);
|
|
684
|
+
for (const f of a.files ?? []) console.log(` ${" ".repeat(width)} ${f.state}: ${f.path}`);
|
|
685
|
+
}
|
|
686
|
+
}
|
|
687
|
+
|
|
688
|
+
printOperatorSteps(plan.actions);
|
|
689
|
+
|
|
690
|
+
printSection("Summary");
|
|
691
|
+
console.log(
|
|
692
|
+
` ${s.changes} change(s): ${s.create} create · ${s.refresh} refresh · ` +
|
|
693
|
+
`${s.repair} repair · ${s.remove} remove`,
|
|
694
|
+
);
|
|
695
|
+
console.log(
|
|
696
|
+
` ${s.keep} kept${s.preserved ? ` (${s.preserved} local edit(s) preserved)` : ""}` +
|
|
697
|
+
`${s.overwrites ? ` · ${s.overwrites} overwrite local edits` : ""}`,
|
|
698
|
+
);
|
|
699
|
+
if (s.skip || s.exec || s.external || s.operator) {
|
|
700
|
+
console.log(
|
|
701
|
+
` not applied: ${s.skip} skipped · ${s.exec} exec · ` +
|
|
702
|
+
`${s.external} external · ${s.operator} operator`,
|
|
703
|
+
);
|
|
704
|
+
}
|
|
705
|
+
if (s.newAvailable > 0 && plan.verb !== "uninstall") {
|
|
706
|
+
console.log(` ${s.newAvailable} catalogued item(s) not selected — widen with --profile full`);
|
|
707
|
+
}
|
|
708
|
+
|
|
709
|
+
console.log();
|
|
710
|
+
if (hasConflicts(plan)) {
|
|
711
|
+
console.log(
|
|
712
|
+
`✗ ${plan.conflicts.length} conflict(s): changed both locally and upstream.\n` +
|
|
713
|
+
" Resolve with --accept-theirs (take the new version) or --accept-ours (keep yours).",
|
|
714
|
+
);
|
|
715
|
+
return;
|
|
716
|
+
}
|
|
275
717
|
console.log(
|
|
276
|
-
|
|
718
|
+
isNoop(plan)
|
|
719
|
+
? "✓ Nothing to do — the workspace already matches this plan."
|
|
720
|
+
: `✓ Plan is clean: ${s.changes} change(s), no conflicts.`,
|
|
277
721
|
);
|
|
278
722
|
}
|
|
279
723
|
|
|
724
|
+
/**
|
|
725
|
+
* The half of a plan the engine will not perform: Hermes profiles, user systemd
|
|
726
|
+
* units, packages that must be installed by hand. These items exist precisely
|
|
727
|
+
* because their targets sit outside the workspace the engine is allowed to
|
|
728
|
+
* write to, so the only useful thing to emit is the exact command list — which
|
|
729
|
+
* the manifest declares, so it cannot rot away from the artifact it describes.
|
|
730
|
+
*/
|
|
731
|
+
function printOperatorSteps(actions) {
|
|
732
|
+
const external = actions.filter((a) => a.kind === "external");
|
|
733
|
+
const operator = actions.filter((a) => a.kind === "operator");
|
|
734
|
+
if (external.length === 0 && operator.length === 0) return;
|
|
735
|
+
|
|
736
|
+
printSection("Do these yourself — the engine performs none of them");
|
|
737
|
+
for (const a of external) {
|
|
738
|
+
console.log(` ${a.id}`);
|
|
739
|
+
console.log(` install the package: ${a.packageSpec ?? "(unspecified)"}`);
|
|
740
|
+
}
|
|
741
|
+
for (const a of operator) {
|
|
742
|
+
console.log(` ${a.id}`);
|
|
743
|
+
for (const step of a.operatorSteps ?? []) console.log(` - ${step}`);
|
|
744
|
+
if ((a.operatorSteps ?? []).length === 0) console.log(" - (no steps declared)");
|
|
745
|
+
}
|
|
746
|
+
}
|
|
747
|
+
|
|
748
|
+
/**
|
|
749
|
+
* Validate `--method`, and refuse `symlink` outside an agent-fleet checkout.
|
|
750
|
+
*
|
|
751
|
+
* Symlinks are only sound where the source is meant to be edited in place —
|
|
752
|
+
* that is, in agent-fleet itself. Anywhere else the link target must never move
|
|
753
|
+
* again: an npx cache clean breaks every link at once, and a `git pull` in the
|
|
754
|
+
* source rewrites artifacts the workspace never agreed to change. A copy plus
|
|
755
|
+
* `agent-fleet upgrade` gives the same freshness with none of that.
|
|
756
|
+
*
|
|
757
|
+
* Explicit is refused rather than downgraded — a flag the user typed deserves
|
|
758
|
+
* an answer, not a silent substitution. Workspaces that merely *recorded*
|
|
759
|
+
* symlink from before are migrated to copies by the planner instead.
|
|
760
|
+
*
|
|
761
|
+
* @returns {"copy"|"symlink"} the method to use
|
|
762
|
+
*/
|
|
763
|
+
function resolveMethod(supplied, fallback = "copy") {
|
|
764
|
+
const method = supplied ?? fallback;
|
|
765
|
+
if (!["copy", "symlink"].includes(method)) {
|
|
766
|
+
fail(`--method must be "copy" or "symlink" (got "${method}")`);
|
|
767
|
+
}
|
|
768
|
+
if (method === "symlink" && !isAgentFleetCheckout(workspace)) {
|
|
769
|
+
if (supplied === "symlink") {
|
|
770
|
+
fail(
|
|
771
|
+
"--method symlink is supported only inside an agent-fleet checkout.\n" +
|
|
772
|
+
" Everywhere else it breaks as soon as the source moves or an npx cache is cleaned.\n" +
|
|
773
|
+
" Install with --method copy and keep it current with `agent-fleet upgrade`.",
|
|
774
|
+
);
|
|
775
|
+
}
|
|
776
|
+
return "copy"; // recorded from before the restriction — migrate quietly
|
|
777
|
+
}
|
|
778
|
+
return method;
|
|
779
|
+
}
|
|
780
|
+
|
|
781
|
+
function splitList(value) {
|
|
782
|
+
return (value ?? "").split(",").map((s) => s.trim()).filter(Boolean);
|
|
783
|
+
}
|
|
784
|
+
|
|
785
|
+
// A numbered list, not a TUI: this runs inside `npx` on machines whose terminal
|
|
786
|
+
// capabilities are unknown, and the flags remain the primary interface.
|
|
787
|
+
async function askProfile(manifest) {
|
|
788
|
+
const names = Object.keys(manifest.profiles ?? {});
|
|
789
|
+
if (names.length === 0) fail("the manifest declares no profiles");
|
|
790
|
+
|
|
791
|
+
printSection("Which set of artifacts?");
|
|
792
|
+
names.forEach((name, i) => {
|
|
793
|
+
console.log(` ${i + 1}) ${name.padEnd(16)} ${manifest.profiles[name].title ?? ""}`);
|
|
794
|
+
});
|
|
795
|
+
|
|
796
|
+
const answer = (await prompt(`\nProfile [1-${names.length}, or a name]: `)).trim();
|
|
797
|
+
const byIndex = names[Number(answer) - 1];
|
|
798
|
+
const chosen = byIndex ?? names.find((n) => n === answer);
|
|
799
|
+
if (!chosen) fail(`not a profile: "${answer}"`);
|
|
800
|
+
return chosen;
|
|
801
|
+
}
|
|
802
|
+
|
|
280
803
|
async function cmdUpdate() {
|
|
281
804
|
await mustBeDirectory(workspace, "workspace");
|
|
282
805
|
|
|
@@ -315,10 +838,7 @@ async function cmdUpdate() {
|
|
|
315
838
|
if (agent && !AGENTS.includes(agent)) agent = null;
|
|
316
839
|
if (!agent) agent = await chooseAgent(opts.agent);
|
|
317
840
|
|
|
318
|
-
const method = opts.method
|
|
319
|
-
if (!["copy", "symlink"].includes(method)) {
|
|
320
|
-
fail(`--method must be "copy" or "symlink" (got "${method}")`);
|
|
321
|
-
}
|
|
841
|
+
const method = resolveMethod(opts.method, marker?.method ?? "copy");
|
|
322
842
|
|
|
323
843
|
printSection("Refresh installer command");
|
|
324
844
|
const { written, skipped, removed, warnings } = bootstrap({
|
|
@@ -604,7 +1124,6 @@ function printHelp(sub) {
|
|
|
604
1124
|
|
|
605
1125
|
Options:
|
|
606
1126
|
--agent <claude-code|opencode|pi> Skip the agent auto-detection
|
|
607
|
-
--method <copy|symlink> Default install method (default: copy)
|
|
608
1127
|
--workspace <path> Target workspace (default: cwd)
|
|
609
1128
|
--launch Attempt to launch the coding agent after init
|
|
610
1129
|
-h, --help Show this help
|
|
@@ -614,13 +1133,116 @@ Options:
|
|
|
614
1133
|
if (sub === "doctor") {
|
|
615
1134
|
console.log(`agent-fleet doctor [options]
|
|
616
1135
|
|
|
617
|
-
|
|
1136
|
+
Find and repair breakage. Two sources, one report:
|
|
1137
|
+
|
|
1138
|
+
• recorded items that are missing, dangling, or linked outside the source
|
|
1139
|
+
root — repaired through the same apply() path \`install\` writes with, so
|
|
1140
|
+
a repaired file is byte-identical to a freshly installed one;
|
|
1141
|
+
• broken symlinks and stale persona names the install record cannot own
|
|
1142
|
+
(pre-engine workspaces, hand-edited .pi/agents/*.yaml).
|
|
1143
|
+
|
|
1144
|
+
Overrides problems and malformed peers.yaml entries are advisory: reported,
|
|
1145
|
+
never auto-fixed, because the fix is always a hand edit.
|
|
1146
|
+
|
|
1147
|
+
Options:
|
|
1148
|
+
--workspace <path> Target workspace (default: cwd)
|
|
1149
|
+
--agent <claude-code|opencode|pi> Override the recorded/detected agent
|
|
1150
|
+
--fix Apply the repairs without prompting
|
|
1151
|
+
--dry-run Report only; never write, never prompt
|
|
1152
|
+
--json Emit the machine report on stdout
|
|
1153
|
+
-y, --yes Alias for --fix
|
|
1154
|
+
-h, --help Show this help
|
|
1155
|
+
|
|
1156
|
+
Exit codes:
|
|
1157
|
+
0 nothing to repair
|
|
1158
|
+
1 could not run
|
|
1159
|
+
2 repairable issues found (or advisory findings), or a repair failed
|
|
1160
|
+
`);
|
|
1161
|
+
return;
|
|
1162
|
+
}
|
|
1163
|
+
if (sub === "uninstall") {
|
|
1164
|
+
console.log(`agent-fleet uninstall [options]
|
|
1165
|
+
|
|
1166
|
+
Remove artifacts agent-fleet installed. Bound by the ownership rule: only
|
|
1167
|
+
paths recorded in .ai/agent-fleet-state.json are eligible, and a recorded
|
|
1168
|
+
file whose bytes no longer match what we wrote is kept and listed as skipped.
|
|
1169
|
+
Nothing else in the workspace is ever touched.
|
|
1170
|
+
|
|
1171
|
+
Removing an item takes its companions with it, unless another installed item
|
|
1172
|
+
still needs them; an item another installed item pins is refused by name.
|
|
618
1173
|
|
|
619
1174
|
Options:
|
|
620
|
-
--workspace <path>
|
|
621
|
-
--
|
|
622
|
-
|
|
623
|
-
-
|
|
1175
|
+
--workspace <path> Target workspace (default: cwd)
|
|
1176
|
+
--items <id[,id]> Item ids to remove
|
|
1177
|
+
--all Remove everything the state file records
|
|
1178
|
+
--agent <claude-code|opencode|pi> Override the recorded agent
|
|
1179
|
+
--dry-run Print the plan, write nothing
|
|
1180
|
+
--json Emit the machine plan/result on stdout
|
|
1181
|
+
-y, --yes Skip the confirmation
|
|
1182
|
+
-h, --help Show this help
|
|
1183
|
+
|
|
1184
|
+
Exit codes:
|
|
1185
|
+
0 removed (or nothing to remove)
|
|
1186
|
+
1 could not plan (no install record, no selection, unknown agent)
|
|
1187
|
+
`);
|
|
1188
|
+
return;
|
|
1189
|
+
}
|
|
1190
|
+
if (sub === "verify") {
|
|
1191
|
+
console.log(`agent-fleet verify [options]
|
|
1192
|
+
|
|
1193
|
+
Read-only inspection of a workspace against the install manifest: what is
|
|
1194
|
+
recorded, what is on disk, what differs, and what is broken. Writes nothing.
|
|
1195
|
+
|
|
1196
|
+
Options:
|
|
1197
|
+
--workspace <path> Target workspace (default: cwd)
|
|
1198
|
+
--agent <claude-code|opencode|pi> Override the recorded/detected agent
|
|
1199
|
+
--json Emit the machine report on stdout
|
|
1200
|
+
--no-doctor Skip the symlink/persona/overrides scan
|
|
1201
|
+
-h, --help Show this help
|
|
1202
|
+
|
|
1203
|
+
Exit codes:
|
|
1204
|
+
0 no broken items and no findings
|
|
1205
|
+
1 could not run (bad flags, missing manifest, unreadable workspace)
|
|
1206
|
+
2 findings, or items in a broken state
|
|
1207
|
+
|
|
1208
|
+
An available upgrade (state "outdated") and a deliberate local edit (state
|
|
1209
|
+
"modified") are reported but do not fail the run.
|
|
1210
|
+
`);
|
|
1211
|
+
return;
|
|
1212
|
+
}
|
|
1213
|
+
if (sub === "install" || sub === "upgrade") {
|
|
1214
|
+
console.log(`agent-fleet ${sub} [options]
|
|
1215
|
+
|
|
1216
|
+
${sub === "install"
|
|
1217
|
+
? "Install the selected artifacts into a workspace."
|
|
1218
|
+
: "Upgrade what this workspace already has to the current package, with a\n three-way merge against the snapshot of the version it recorded."}
|
|
1219
|
+
|
|
1220
|
+
Options:
|
|
1221
|
+
--workspace <path> Target workspace (default: cwd)
|
|
1222
|
+
--agent <claude-code|opencode|pi> Override the recorded/detected agent${sub === "install" ? `
|
|
1223
|
+
--profile <name[,name]> Named selections, unioned
|
|
1224
|
+
--items <id[,id]> Explicit item ids, added to the profiles` : ""}
|
|
1225
|
+
--allow-exec Include items that run a command
|
|
1226
|
+
--accept-theirs Resolve conflicts by taking the new version
|
|
1227
|
+
--accept-ours Resolve conflicts by keeping the local copy
|
|
1228
|
+
--dry-run Print the plan, write nothing
|
|
1229
|
+
--json Emit the machine plan/result on stdout
|
|
1230
|
+
-y, --yes Skip the confirmation (required with --json)
|
|
1231
|
+
-h, --help Show this help
|
|
1232
|
+
|
|
1233
|
+
Exit codes:
|
|
1234
|
+
0 applied, or nothing to do
|
|
1235
|
+
1 could not plan, or a write failed partway
|
|
1236
|
+
3 conflicts — changed both locally and upstream, needs a decision
|
|
1237
|
+
|
|
1238
|
+
${sub === "install"
|
|
1239
|
+
? "A selection never removes anything: installing a narrower profile keeps what\nis already there. Local edits to a selected item ARE overwritten — selecting\nan item is the consent — and every such item is listed as `overwrites`."
|
|
1240
|
+
: "Upgrade never widens the install. Locally modified files are preserved, not\noverwritten; artifacts retired upstream are proposed for removal by name."}
|
|
1241
|
+
|
|
1242
|
+
Artifacts are installed as copies. --method symlink exists only inside an
|
|
1243
|
+
agent-fleet checkout, where editing an artifact is meant to edit the source; a
|
|
1244
|
+
workspace that recorded symlinks before that restriction is migrated to copies
|
|
1245
|
+
on the next install or upgrade.
|
|
624
1246
|
`);
|
|
625
1247
|
return;
|
|
626
1248
|
}
|
|
@@ -704,7 +1326,6 @@ Examples:
|
|
|
704
1326
|
|
|
705
1327
|
Options:
|
|
706
1328
|
--agent <claude-code|opencode|pi> Override the agent (default: marker → auto-detect)
|
|
707
|
-
--method <copy|symlink> Install method for the command (default: copy)
|
|
708
1329
|
--workspace <path> Target workspace (default: cwd)
|
|
709
1330
|
--dry-run Show what would be written; touch nothing
|
|
710
1331
|
-h, --help Show this help
|
|
@@ -722,7 +1343,11 @@ Usage:
|
|
|
722
1343
|
|
|
723
1344
|
Commands:
|
|
724
1345
|
init Bootstrap installer files + hand off to the setup workflow
|
|
725
|
-
doctor
|
|
1346
|
+
doctor Find and repair breakage (--fix); advisory findings listed
|
|
1347
|
+
verify Read-only report: manifest × install state × disk (--json)
|
|
1348
|
+
install Install from a profile or explicit item ids
|
|
1349
|
+
upgrade Upgrade what is installed, with a three-way merge
|
|
1350
|
+
uninstall Remove recorded artifacts (--items / --all)
|
|
726
1351
|
update Surface the version delta + hand off to the setup workflow
|
|
727
1352
|
check-update One-line registry check (used by session hooks; safe to script)
|
|
728
1353
|
cleanup-installer Remove the installer slash commands from a workspace (used
|
|
@@ -739,7 +1364,12 @@ Options:
|
|
|
739
1364
|
Examples:
|
|
740
1365
|
npx agent-fleet init
|
|
741
1366
|
npx agent-fleet init --agent claude-code --method copy
|
|
742
|
-
npx agent-fleet doctor --workspace ~/projects/foo
|
|
1367
|
+
npx agent-fleet doctor --workspace ~/projects/foo --fix
|
|
1368
|
+
npx agent-fleet verify --agent pi --json
|
|
1369
|
+
npx agent-fleet install --agent pi --profile recommended --yes
|
|
1370
|
+
npx agent-fleet install --agent pi --profile hermes-plugins --dry-run
|
|
1371
|
+
npx agent-fleet upgrade --accept-ours --yes
|
|
1372
|
+
npx agent-fleet uninstall --items skill:peer-coms --yes
|
|
743
1373
|
npx agent-fleet update
|
|
744
1374
|
npx agent-fleet set-hermes-telegram on 7883056502:1735
|
|
745
1375
|
npx agent-fleet set-hermes-watchdog status --profile default
|