@chankov/agent-fleet 0.0.7 → 0.0.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.pi/agents/model-profiles.yaml +9 -2
- package/.pi/agents/peers.yaml +12 -16
- package/.pi/agents/teams.yaml +4 -2
- package/.pi/harnesses/agent-hub/README.md +20 -5
- package/.pi/harnesses/agent-hub/footer.ts +4 -2
- package/.pi/harnesses/agent-hub/index.ts +104 -11
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/version.ts +25 -1
- package/.pi/harnesses/coms/README.md +8 -1
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/coms/version.ts +25 -1
- package/.pi/harnesses/damage-control-continue/README.md +8 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/version.ts +25 -1
- package/.pi/harnesses/lib/herdr-client.ts +10 -1
- package/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/0.0.8/.claude/commands/build.md +44 -0
- package/.versions/0.0.8/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.8/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.8/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.8/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.8/.claude/commands/plan.md +16 -0
- package/.versions/0.0.8/.claude/commands/prime.md +22 -0
- package/.versions/0.0.8/.claude/commands/review.md +16 -0
- package/.versions/0.0.8/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.8/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.versions/0.0.8/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.8/.claude/commands/ship.md +72 -0
- package/.versions/0.0.8/.claude/commands/spec.md +15 -0
- package/.versions/0.0.8/.claude/commands/test.md +19 -0
- package/.versions/0.0.8/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.8/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.8/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.8/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.8/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.8/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.8/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.8/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.8/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.8/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.8/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.8/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.8/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.8/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.8/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.8/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.8/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.8/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.8/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.8/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.8/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.8/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.8/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.8/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.8/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.8/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.8/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.8/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.8/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.8/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.8/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.8/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.8/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.8/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.8/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.8/.pi/extensions/package.json +9 -0
- package/.versions/0.0.8/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.8/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.8/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.8/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.8/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.8/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.8/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/README.md +857 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/helpers.ts +248 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/index.ts +8609 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/run-budget.js +181 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.8/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.8/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.8/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.8/.pi/harnesses/coms/README.md +93 -0
- package/.versions/0.0.8/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/0.0.8/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.8/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.8/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.8/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.8/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.8/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.8/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/0.0.8/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.8/.pi/harnesses/lib/herdr-client.ts +463 -0
- package/.versions/0.0.8/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.8/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.8/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.8/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.8/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.8/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.8/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.8/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.8/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.8/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.8/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.8/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.8/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.8/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.8/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.8/.version +1 -0
- package/.versions/0.0.8/agents/architect.md +23 -0
- package/.versions/0.0.8/agents/bowser.md +26 -0
- package/.versions/0.0.8/agents/builder.md +53 -0
- package/.versions/0.0.8/agents/code-reviewer.md +205 -0
- package/.versions/0.0.8/agents/deep-researcher.md +31 -0
- package/.versions/0.0.8/agents/documenter.md +18 -0
- package/.versions/0.0.8/agents/orchestrator.md +65 -0
- package/.versions/0.0.8/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.8/agents/planner.md +69 -0
- package/.versions/0.0.8/agents/releaser.md +24 -0
- package/.versions/0.0.8/agents/researcher.md +28 -0
- package/.versions/0.0.8/agents/security-auditor.md +166 -0
- package/.versions/0.0.8/agents/test-engineer.md +151 -0
- package/.versions/0.0.8/agents/web-debugger.md +42 -0
- package/.versions/0.0.8/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.8/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.8/docs/ARCHITECTURE.md +262 -0
- package/.versions/0.0.8/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.8/docs/claude-code-coms-bridge.md +109 -0
- package/.versions/0.0.8/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.8/docs/coms-hermes-bridge.md +189 -0
- package/.versions/0.0.8/docs/getting-started.md +231 -0
- package/.versions/0.0.8/docs/npm-install.md +337 -0
- package/.versions/0.0.8/docs/opencode-setup.md +249 -0
- package/.versions/0.0.8/docs/pi-extensions.md +293 -0
- package/.versions/0.0.8/docs/pi-setup.md +476 -0
- package/.versions/0.0.8/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.8/hermes/README.md +347 -0
- package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.8/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/0.0.8/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.8/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.8/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/0.0.8/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/0.0.8/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.8/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/0.0.8/hooks/hooks.json +14 -0
- package/.versions/0.0.8/hooks/session-start.sh +74 -0
- package/.versions/0.0.8/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.8/justfile +245 -0
- package/.versions/0.0.8/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.8/references/definition-of-done.md +67 -0
- package/.versions/0.0.8/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.8/references/observability-checklist.md +91 -0
- package/.versions/0.0.8/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.8/references/performance-checklist.md +153 -0
- package/.versions/0.0.8/references/prompting-patterns.md +380 -0
- package/.versions/0.0.8/references/security-checklist.md +179 -0
- package/.versions/0.0.8/references/testing-patterns.md +236 -0
- package/.versions/0.0.8/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.8/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.8/scripts/coms-claude-bridge.ts +401 -0
- package/.versions/0.0.8/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.8/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.8/scripts/fleet.ts +149 -0
- package/.versions/0.0.8/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.8/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/0.0.8/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/0.0.8/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/0.0.8/scripts/lib/claude-bridge-core.ts +165 -0
- package/.versions/0.0.8/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.8/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.8/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/0.0.8/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.8/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.8/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.8/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.8/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/0.0.8/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.8/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.8/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.8/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.8/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.8/scripts/lib/monitor-env.ts +120 -0
- package/.versions/0.0.8/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.8/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.8/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.8/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.8/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.8/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.8/scripts/team-up.ts +360 -0
- package/.versions/0.0.8/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.8/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.8/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.8/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.8/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.8/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.8/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.8/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.8/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.8/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.8/skills/guided-workspace-setup/SKILL.md +544 -0
- package/.versions/0.0.8/skills/guided-workspace-setup/companion-manifest.json +36 -0
- package/.versions/0.0.8/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.8/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.8/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.8/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.8/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.8/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.8/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.8/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.8/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.8/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.8/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.8/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.8/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.8/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.8/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.8/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 +44 -0
- package/agents/architect.md +1 -0
- package/agents/bowser.md +1 -0
- package/agents/builder.md +1 -0
- package/agents/code-reviewer.md +4 -5
- package/agents/deep-researcher.md +2 -1
- package/agents/orchestrator.md +1 -0
- package/agents/plan-reviewer.md +3 -1
- package/agents/planner.md +3 -2
- package/agents/security-auditor.md +1 -0
- package/agents/test-engineer.md +3 -1
- package/agents/web-debugger.md +1 -0
- package/agents/web-performance-auditor.md +1 -0
- package/docs/ARCHITECTURE.md +1 -1
- package/docs/pi-extensions.md +66 -3
- package/justfile +10 -1
- package/package.json +2 -2
- package/scripts/fleet.ts +22 -3
- package/scripts/lib/fleet-command.ts +5 -3
- package/scripts/lib/herdr-layout.ts +18 -0
- package/scripts/lib/peer-launch.ts +314 -0
- package/scripts/lib/team-project.ts +3 -1
- package/scripts/peer-launch.ts +259 -0
- package/skills/guided-workspace-setup/companion-manifest.json +3 -0
- /package/{.pi → .versions/0.0.8/.pi}/harnesses/agent-hub/spawned-peers.js +0 -0
|
@@ -0,0 +1,189 @@
|
|
|
1
|
+
# coms Hermes bridge
|
|
2
|
+
|
|
3
|
+
> The optional `hub-watchdog` is not this bridge and is not a coms conductor. It has no
|
|
4
|
+
> Herdr, shell, direct-tool, peer-delegation, service, or gateway authority. `hermes send --to`
|
|
5
|
+
> is an explicit destination mechanism, never origin-route evidence. Gate O has no checked-in
|
|
6
|
+
> live proof, so the supported watchdog posture is journal-only/dormant: no delivery,
|
|
7
|
+
> steering, cancellation, or recovery. It must not send an out-of-turn update, wake a chat, or
|
|
8
|
+
> fall back to another route. See [the watchdog runbook](hermes-watchdog-supervisor.md).
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
Protocol contract for the Hermes ⇄ pi `coms` bridge. The first implemented daemon is `scripts/coms-hermes-bridge.ts`, which registers a `user-remote` peer and turns coms prompt envelopes into Hermes/Telegram questions.
|
|
12
|
+
|
|
13
|
+
## Pieces
|
|
14
|
+
|
|
15
|
+
| Piece | Role |
|
|
16
|
+
| --- | --- |
|
|
17
|
+
| `scripts/coms-hermes-bridge.ts` | Daemon peer, default name `user-remote`, purpose `Remote human via Hermes/Telegram`. Accepts prompt, cancel, and ping envelopes. |
|
|
18
|
+
| `scripts/lib/hermes-bridge-core.ts` | Pure contract logic: qid validation, Telegram formatting, answer-file validation, answer mapping, timeout outcome, state transitions, and log records. |
|
|
19
|
+
| `scripts/lib/coms-envelope.ts` | Shared non-pi envelope wire shapes, including additive `cancel` envelopes. |
|
|
20
|
+
| `~/.pi/coms/hermes-bridge/questions/` | Private answer-file wire written by the Hermes gateway/liaison. |
|
|
21
|
+
| `~/.pi/coms/hermes-bridge/log.ndjson` | Bridge observability log. |
|
|
22
|
+
|
|
23
|
+
## user-remote topology
|
|
24
|
+
|
|
25
|
+
1. A pi peer sends a coms `prompt` envelope to `user-remote`.
|
|
26
|
+
2. The bridge derives `qid` from `prompt.msg_id`, formats the question, and runs `hermes send --to <target> <message>` (`<target>` defaults to `telegram`). For a topic, copy the target accepted by `hermes send --list telegram`; depending on the Hermes output format, its `id` may already contain the `:<thread_id>` suffix, so do not append the thread twice.
|
|
27
|
+
3. The human replies in Telegram; the Hermes gateway/liaison writes the answer file.
|
|
28
|
+
4. The bridge polls the questions directory, validates the file, maps the answer, sends a coms `response` envelope, and removes the answer file.
|
|
29
|
+
|
|
30
|
+
## Protocol contract v1
|
|
31
|
+
|
|
32
|
+
### qid and correlation
|
|
33
|
+
|
|
34
|
+
`qid` is exactly the prompt envelope's `msg_id`. It must match the 26-character Crockford ULID regex `^[0-9A-HJKMNP-TV-Z]{26}$`. The same `qid` is the only correlation key across coms, Telegram, answer files, state, and logs.
|
|
35
|
+
|
|
36
|
+
### Telegram question format
|
|
37
|
+
|
|
38
|
+
`formatTelegramQuestion` emits UTF-16 text capped at 4096 code units:
|
|
39
|
+
|
|
40
|
+
```text
|
|
41
|
+
❓ [HUB-Q:<qid>] <question>
|
|
42
|
+
|
|
43
|
+
📁 Project: <coms-project>
|
|
44
|
+
|
|
45
|
+
Context: <context, truncated if needed>
|
|
46
|
+
|
|
47
|
+
Options:
|
|
48
|
+
1. <title> — <description>
|
|
49
|
+
...
|
|
50
|
+
|
|
51
|
+
↩ Reply to this message, or type: HUB-Q:<qid>: <answer>
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
`Project:` is always present and comes from the bridge's validated `--project` scope, making simultaneous questions from different pools distinguishable. `Context:` is omitted when absent. `Options:` is omitted when no options are supplied. Context receives the remaining budget after the header, project, options, and reply instruction.
|
|
55
|
+
|
|
56
|
+
### Answer-file path, schema, and validation
|
|
57
|
+
|
|
58
|
+
The private wire path is:
|
|
59
|
+
|
|
60
|
+
```text
|
|
61
|
+
~/.pi/coms/hermes-bridge/questions/<qid>.answer.json
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
Schema:
|
|
65
|
+
|
|
66
|
+
```json
|
|
67
|
+
{
|
|
68
|
+
"qid": "<26-character Crockford ULID>",
|
|
69
|
+
"answer": "<text>",
|
|
70
|
+
"answered_by": "telegram:<user>",
|
|
71
|
+
"at": "<ISO timestamp>"
|
|
72
|
+
}
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
Validation rejects and ignores files unless all conditions hold: filename ends in `.answer.json`; filename qid is valid; filename qid is currently pending; JSON parses; object fields match the schema; `at` parses as a timestamp; and body `qid` equals the filename qid. Rejection reasons are `invalid_path`, `invalid_qid`, `foreign_qid`, `invalid_json`, `invalid_schema`, and `qid_mismatch`; the daemon logs rejected files as `answer_rejected` and removes them. Exception: an `invalid_json` file is treated as a possible partial write and left in place for a short grace window (`max(2 × poll interval, 1s)` from first sighting); it is rejected and removed only if it still fails to parse after the grace expires.
|
|
76
|
+
|
|
77
|
+
### Answer mapping
|
|
78
|
+
|
|
79
|
+
If options exist and the trimmed answer is a 1-based number for an option, the response is `{ "kind": "selection", "selections": ["<option title>"] }`. If options exist and the trimmed answer case-insensitively equals an option title, it maps to the same selection shape. All other answers map to `{ "kind": "freeform", "text": "<trimmed answer>" }`.
|
|
80
|
+
|
|
81
|
+
### Cancel semantics
|
|
82
|
+
|
|
83
|
+
`cancel` is an additive coms envelope with shape `{ "type": "cancel", "msg_id", "from", "to", "created_at", "ref_msg_id" }`; `ref_msg_id` is the target `qid`. The bridge acks well-formed cancel envelopes before handling them.
|
|
84
|
+
|
|
85
|
+
For a pending qid, cancel clears the timeout, removes the pending question, records terminal state `cancelled`, appends a `cancelled` log event, and sends a Telegram note: `✖ [HUB-Q:<qid>] The question was cancelled — it was answered from the console.` Cancel for a non-pending or invalid qid is a no-op after the envelope ack. A later answer file for a closed qid is treated as `late_answer`: logged, removed, and answered in Telegram with a polite ignored note; no response envelope is sent.
|
|
86
|
+
|
|
87
|
+
**Cancellation is local wait abandonment.** Cancelling a coms-backed run ends only this side's wait. The remote peer is not signalled and may keep working, so a `cancelled` state here is a statement about the local wait, never about the remote task. It follows that watchdog auto-recovery is forbidden for coms runs: no automatic retry, re-dispatch, retarget, or recovery invoke may follow a coms cancellation, and a cancelled coms run is never a recovery target. An explicit `hermes send --to <destination>` remains a destination-only mechanism chosen by a human; it is not evidence of an origin route and must not be used to "reply" to a cancelled run.
|
|
88
|
+
|
|
89
|
+
### Timeouts
|
|
90
|
+
|
|
91
|
+
The per-question remote timeout defaults to `PI_COMS_TIMEOUT_MS`, or `1800000` ms when unset/invalid; `--timeout <ms>` overrides it. On timeout, the bridge removes the pending question, records terminal state `timeout`, logs `timeout`, sends the Telegram note `⌛ [HUB-Q:<qid>] The question timed out after <ms>ms.`, and sends an error response envelope with error `no remote answer within <ms>ms` and `response: null`.
|
|
92
|
+
|
|
93
|
+
### States
|
|
94
|
+
|
|
95
|
+
Question states are in-memory per qid: `pending`, `delivered`, `answered`, `cancelled`, and `timeout`. Implemented transitions are: `null + question_received → pending`; `pending + delivered → delivered`; `pending + delivery_error → null`; `pending|delivered + answered → answered` (the daemon currently answers from delivered or pending if the file arrives quickly); `pending|delivered + cancelled → cancelled`; `pending|delivered + timeout → timeout`; and terminal `answered|cancelled|timeout + late_answer` remains terminal.
|
|
96
|
+
|
|
97
|
+
### ndjson logging
|
|
98
|
+
|
|
99
|
+
The bridge appends one JSON object per line to `~/.pi/coms/hermes-bridge/log.ndjson`. Core log records have shape `{ "at": "<ISO>", "qid": "<qid>", "event": "<event>", "detail"?: <value> }`. Contract events are `question_received`, `delivered`, `delivery_error`, `answered`, `cancelled`, `timeout`, and `late_answer`; the daemon also writes `answer_rejected` for invalid answer files. Ping agent cards report `queue_depth` as the current number of pending questions.
|
|
100
|
+
|
|
101
|
+
## Hermes as conductor
|
|
102
|
+
|
|
103
|
+
Hermes can also act as the conductor without this daemon: use `coms-cli list` to discover peers and `coms-cli send --await --timeout <ms>` to delegate to hub-team pi peers, then synthesize the results for the human. This conductor topology uses the existing coms CLI as the bridge; no standing Hermes peer is required.
|
|
104
|
+
|
|
105
|
+
Launch a visible conductor workspace with:
|
|
106
|
+
|
|
107
|
+
```bash
|
|
108
|
+
just fleet conductor hermes docs # live conductor + team workspace
|
|
109
|
+
just fleet conductor hermes docs --dry-run # preview; no Herdr calls
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
The live recipe reuses `scripts/team-up.ts --conductor`: it creates a normal herdr workspace labeled `<worktree-tag>-conductor-<team>` (the tag is the last dot-segment of the checkout's basename, so the same team from a different worktree gets its own workspace), places a `conductor` pane running `hermes -p dev`, and tiles the chosen team beside it. Team peers keep their normal coms harness and herdr presence reporting, so they continue to show agent state in the sidebar; Hermes' own herdr-agent-state plugin is responsible for the conductor pane's state.
|
|
113
|
+
|
|
114
|
+
### Telegram bridge control command
|
|
115
|
+
|
|
116
|
+
The outbound `hermes send` path needs a configured Telegram channel but no skill. Full reply round-trip additionally needs Agent Fleet's `hub-liaison` skill in the profile that owns the running Telegram gateway. Pi and OpenCode use the namespaced command:
|
|
117
|
+
|
|
118
|
+
```text
|
|
119
|
+
/af-set-hermes-telegram status --profile default
|
|
120
|
+
/af-set-hermes-telegram install --profile default
|
|
121
|
+
/af-set-hermes-telegram install --profile default --force --restart
|
|
122
|
+
/af-set-hermes-telegram on 7883056502:1735 --profile default
|
|
123
|
+
/af-set-hermes-telegram off 7883056502:1735
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
Claude Code exposes the unprefixed `/set-hermes-telegram`; the arguments and backend are identical. The deterministic CLI can also be called directly with `agent-fleet set-hermes-telegram ...`.
|
|
127
|
+
|
|
128
|
+
#### `status` and profile resolution
|
|
129
|
+
|
|
130
|
+
`status` is read-only. It verifies the Hermes executable/profile, compares the complete installed `hub-liaison` tree to the version packaged with Agent Fleet, asks Hermes whether the skill is enabled, checks `terminal` and `file` toolsets for the `telegram` platform, and reports gateway state. `--profile <name>` is recommended. Without it the controller selects a profile only when `hermes gateway list` reports exactly one running gateway; zero or multiple running gateways fail closed and require an explicit profile.
|
|
131
|
+
|
|
132
|
+
#### `install`
|
|
133
|
+
|
|
134
|
+
`install` writes to `<Hermes-profile-path>/skills/hub-liaison`, where the profile path comes from `hermes profile show <name>` (important because the `default` profile is normally `~/.hermes`, while named profiles normally live below `~/.hermes/profiles/`). Installation behavior is:
|
|
135
|
+
|
|
136
|
+
- missing skill: copied atomically from the packaged Agent Fleet source;
|
|
137
|
+
- byte-identical tree: no-op;
|
|
138
|
+
- differing tree: refused unless `--force` is explicit;
|
|
139
|
+
- forced replacement: the previous tree is moved first to `<profile>/backups/agent-fleet/hub-liaison-<timestamp>`;
|
|
140
|
+
- symlinks or unsupported filesystem entries in either skill tree are refused;
|
|
141
|
+
- the installed tree is fingerprinted again, then `hermes --profile <name> skills list --enabled-only` and `tools list --platform telegram` are run for verification.
|
|
142
|
+
|
|
143
|
+
The command does not silently broaden Telegram tool permissions. If `terminal` or `file` is disabled, it prints the explicit remediation:
|
|
144
|
+
|
|
145
|
+
```bash
|
|
146
|
+
hermes --profile <name> tools enable --platform telegram terminal file
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
If the skill itself is disabled, use `hermes --profile <name> skills config`. A running gateway is restarted only with explicit `--restart`; otherwise the command prints the required restart command. A stopped gateway is never started as a side effect. No install/status/on/off action sends a test Telegram message.
|
|
150
|
+
|
|
151
|
+
#### `on` and `off`
|
|
152
|
+
|
|
153
|
+
`on` fails before touching Herdr unless the selected gateway is running, `hub-liaison` is current and enabled, and both required Telegram toolsets are enabled. It then closes any existing pane labeled `hermes-bridge` in the current workspace, creates a new right-hand pane in that **same Herdr workspace**, labels it `hermes-bridge`, and starts the daemon with `telegram:<id>` as its exact target. The selected profile is forwarded as `--hermes-profile`, so every question, timeout, cancel, and late-answer send executes as `hermes --profile <name> send ...` rather than silently falling back to Hermes' sticky default. `off` remains available even when Hermes readiness is broken, closes the bridge pane, creates nothing, and is idempotent.
|
|
154
|
+
|
|
155
|
+
The Telegram destination must contain digits only (`<chat_id>`) or two digit groups separated by one colon (`<chat_id>:<topic_id>`). Values such as `telegram:123`, `123:`, `123:456:789`, spaces, signs, and letters are rejected. The controller infers the coms project independently from the current hub process's explicit `--project`, then `PI_COMS_PROJECT`, then `default`.
|
|
156
|
+
|
|
157
|
+
The manual equivalent is:
|
|
158
|
+
|
|
159
|
+
```bash
|
|
160
|
+
node --experimental-strip-types scripts/coms-hermes-bridge.ts \
|
|
161
|
+
--project af \
|
|
162
|
+
--hermes-profile default \
|
|
163
|
+
--timeout 1800000 \
|
|
164
|
+
--to 'telegram:<chat_id>:<thread_id>'
|
|
165
|
+
just fleet team docs --project af
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
Repeated value flags such as two `--to` arguments are rejected at startup rather than silently selecting one destination. The `ask-user-remote` wrapper resolves the explicit Pi `--project` flag when the tool executes, so non-default hubs discover `user-remote` in their own pool.
|
|
169
|
+
|
|
170
|
+
Hard boundary: the Hermes conductor must not run `herdr` commands, drive panes, create/kill workspaces, or manage fleet lifecycle. Herdr driving stays with the human/orchestrator so the damage-control model remains intact; see `.pi/damage-control-rules.yaml` for the authoritative no-herdr boundary. Hermes may only operate inside the project coms pool through the documented coms CLI commands.
|
|
171
|
+
|
|
172
|
+
## Hermes and the experimental Codex conductor
|
|
173
|
+
|
|
174
|
+
Hermes/Telegram remains the **inbound** human `ask_user` complement to the
|
|
175
|
+
experimental Codex remote-control conductor. Codex is outbound-initiated,
|
|
176
|
+
approval-gated, and serialized; it is not an inbound question channel. The Codex user service and control-pane lifecycle are
|
|
177
|
+
separate from Hermes. See the [experimental Codex operator runbook](codex-remote-conductor.md).
|
|
178
|
+
|
|
179
|
+
Both conductor contracts are advisory outside Pi damage-control: Pi wraps Pi
|
|
180
|
+
tool calls, not Hermes or Codex, and neither has an OS command allowlist.
|
|
181
|
+
Human confirmation, approvals, and sandboxing reduce risk but do not
|
|
182
|
+
technically enforce either external contract.
|
|
183
|
+
|
|
184
|
+
## Deferred
|
|
185
|
+
|
|
186
|
+
- Standing conductor peer for pi → Hermes inbound messages.
|
|
187
|
+
- Telegram-driven conductor profile.
|
|
188
|
+
- Group/multi-recipient questions and non-text answers.
|
|
189
|
+
- Kanban-driven orchestration on top of the same conductor contract.
|
|
@@ -0,0 +1,231 @@
|
|
|
1
|
+
# Getting Started with agent-fleet
|
|
2
|
+
|
|
3
|
+
agent-fleet works with any AI coding agent that accepts Markdown instructions. This guide covers the universal approach. For tool-specific setup, see the dedicated guides.
|
|
4
|
+
|
|
5
|
+
## How Skills Work
|
|
6
|
+
|
|
7
|
+
Each skill is a Markdown file (`SKILL.md`) that describes a specific engineering workflow. When loaded into an agent's context, the agent follows the workflow — including verification steps, anti-patterns to avoid, and exit criteria.
|
|
8
|
+
|
|
9
|
+
**Skills are not reference docs.** They're step-by-step processes the agent follows.
|
|
10
|
+
|
|
11
|
+
## Install path — which one fits you?
|
|
12
|
+
|
|
13
|
+
| Audience | Path | Why |
|
|
14
|
+
|---|---|---|
|
|
15
|
+
| **Most users** — you want to use the skills in your projects | `npx @chankov/agent-fleet init` | One command; semver updates; cross-platform; no source dir to babysit. See [docs/npm-install.md](npm-install.md). |
|
|
16
|
+
| **Claude Code users** — you live in Claude Code and want plugin-managed updates | `/plugin marketplace add chankov/agent-fleet` | Best UX inside Claude Code; marketplace handles the lifecycle. |
|
|
17
|
+
| **Skill authors / contributors** — you want to edit the skills and have changes flow into every connected workspace | `git clone` + `symlink` mode in `/setup-agent-fleet` | Edit-in-place; every connected workspace sees the change instantly. |
|
|
18
|
+
|
|
19
|
+
All three converge on the same `guided-workspace-setup` skill — they only differ in how the source files reach your workspace. None is being deprecated.
|
|
20
|
+
|
|
21
|
+
## Optional: see the fleet in Hermes Desktop
|
|
22
|
+
|
|
23
|
+
Once you are running more than one or two agents, `agent-fleet-herdr` gives you
|
|
24
|
+
a live panel of every Agent Fleet session — grouped by project, sorted so the
|
|
25
|
+
agent blocked on a human is at the top, with a toast when one gets stuck or
|
|
26
|
+
dies mid-work.
|
|
27
|
+
|
|
28
|
+
**You need:** Hermes v0.19.0+ with the Desktop app (`hermes` on `PATH`), this
|
|
29
|
+
repo checked out, and a fleet that has run at least once so
|
|
30
|
+
`~/.pi/coms/projects/` exists. [herdr](https://herdr.dev) is optional; without
|
|
31
|
+
it every row reads `unknown` instead of a live state.
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
# 1. link both halves into the profile and open the enable gate
|
|
35
|
+
scripts/install-hermes-plugin.sh agent-fleet-herdr # --profile dev / --copy / --dry-run
|
|
36
|
+
|
|
37
|
+
# 2. restart the HERMES DESKTOP APP
|
|
38
|
+
# (not `hermes gateway restart` — the pane talks to the gateway Desktop spawns for itself,
|
|
39
|
+
# and backend routes only mount when that app starts)
|
|
40
|
+
|
|
41
|
+
# 3. start a fleet and open the "Agent Fleet" tab
|
|
42
|
+
just fleet team default
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
Nothing about how you launch a fleet changes: the panel reads what the fleet
|
|
46
|
+
already writes (the coms registry, herdr presence, and each agent's own
|
|
47
|
+
transcript). It is read-only apart from `Focus pane` and cancelling a hub's
|
|
48
|
+
subagent. Uninstall with `scripts/install-hermes-plugin.sh agent-fleet-herdr
|
|
49
|
+
--uninstall`.
|
|
50
|
+
|
|
51
|
+

|
|
52
|
+
|
|
53
|
+
Full runbook — prerequisites, API, join rules, event kinds, the optional
|
|
54
|
+
Telegram fan-out, and the failure modes that all look like an empty panel:
|
|
55
|
+
**[hermes-desktop-plugins.md](hermes-desktop-plugins.md)**.
|
|
56
|
+
|
|
57
|
+
Separately, the [coms ⇄ Hermes bridge](coms-hermes-bridge.md) relays an agent's
|
|
58
|
+
`ask_user` question to Telegram and races your phone's answer against a local
|
|
59
|
+
one. The two are independent; you can run either without the other.
|
|
60
|
+
|
|
61
|
+
## Optional experimental Android conductor
|
|
62
|
+
|
|
63
|
+
Linux/pi fleet users can pair Codex Remote Control with ChatGPT Android and delegate one approval-gated task at a time to peers already running in a coms project. It is optional, supports only Codex CLI `0.144.x`, requires Node `22.6+` and user systemd, and does not replace Hermes as the inbound `ask_user` route.
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
cd /path/to/agent-fleet
|
|
67
|
+
just fleet conductor codex setup docs --project af
|
|
68
|
+
just fleet conductor codex pair
|
|
69
|
+
just fleet conductor codex start
|
|
70
|
+
just fleet team docs --project af
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
The runtime contract is generated under `$HOME/.local/state/agent-fleet/codex-conductor/`, outside the checkout. Pairing is interactive secret-bearing output and must never be captured. Read the complete [Codex conductor runbook](codex-remote-conductor.md) before enabling the service.
|
|
74
|
+
|
|
75
|
+
## Quick Start (Any Agent)
|
|
76
|
+
|
|
77
|
+
### 1. Clone the repository
|
|
78
|
+
|
|
79
|
+
```bash
|
|
80
|
+
git clone https://github.com/chankov/agent-fleet.git
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
> Skip this step if you installed via npm — the package contents are already
|
|
84
|
+
> in `node_modules/agent-fleet/`. Use that path wherever this guide refers to
|
|
85
|
+
> "the agent-fleet repo."
|
|
86
|
+
|
|
87
|
+
### 2. Choose a skill
|
|
88
|
+
|
|
89
|
+
Browse the `skills/` directory. Each subdirectory contains a `SKILL.md` with:
|
|
90
|
+
- **When to use** — triggers that indicate this skill applies
|
|
91
|
+
- **Process** — step-by-step workflow
|
|
92
|
+
- **Verification** — how to confirm the work is done
|
|
93
|
+
- **Common rationalizations** — excuses the agent might use to skip steps
|
|
94
|
+
- **Red flags** — signs the skill is being violated
|
|
95
|
+
|
|
96
|
+
### 3. Load the skill into your agent
|
|
97
|
+
|
|
98
|
+
Copy the relevant `SKILL.md` content into your agent's system prompt, rules file, or conversation. The most common approaches:
|
|
99
|
+
|
|
100
|
+
**System prompt:** Paste the skill content at the start of the session.
|
|
101
|
+
|
|
102
|
+
**Rules file:** Add skill content to your project's rules file (CLAUDE.md, AGENTS.md, etc.).
|
|
103
|
+
|
|
104
|
+
**Conversation:** Reference the skill when giving instructions: "Follow the test-driven-development process for this change."
|
|
105
|
+
|
|
106
|
+
### 4. Use the meta-skill for discovery
|
|
107
|
+
|
|
108
|
+
Start with the `using-agent-skills` skill loaded. It contains a flowchart that maps task types to the appropriate skill.
|
|
109
|
+
|
|
110
|
+
## Recommended Setup
|
|
111
|
+
|
|
112
|
+
### Minimal (Start here)
|
|
113
|
+
|
|
114
|
+
Load three essential skills into your rules file:
|
|
115
|
+
|
|
116
|
+
1. **spec-driven-development** — For defining what to build
|
|
117
|
+
2. **test-driven-development** — For proving it works
|
|
118
|
+
3. **code-review-and-quality** — For verifying quality before merge
|
|
119
|
+
|
|
120
|
+
These three cover the most critical quality gaps in AI-assisted development.
|
|
121
|
+
|
|
122
|
+
### Full Lifecycle
|
|
123
|
+
|
|
124
|
+
For comprehensive coverage, load skills by phase:
|
|
125
|
+
|
|
126
|
+
```
|
|
127
|
+
Starting a project: spec-driven-development → planning-and-task-breakdown
|
|
128
|
+
During development: incremental-implementation + test-driven-development
|
|
129
|
+
Before merge: code-review-and-quality + security-and-hardening
|
|
130
|
+
Before deploy: shipping-and-launch
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
### Context-Aware Loading
|
|
134
|
+
|
|
135
|
+
Don't load all skills at once — it wastes context. Load skills relevant to the current task:
|
|
136
|
+
|
|
137
|
+
- Working on UI? Load `frontend-ui-engineering`
|
|
138
|
+
- Debugging? Load `debugging-and-error-recovery`
|
|
139
|
+
- Setting up CI? Load `ci-cd-and-automation`
|
|
140
|
+
|
|
141
|
+
## Skill Anatomy
|
|
142
|
+
|
|
143
|
+
Every skill follows the same structure:
|
|
144
|
+
|
|
145
|
+
```
|
|
146
|
+
YAML frontmatter (name, description)
|
|
147
|
+
├── Overview — What this skill does
|
|
148
|
+
├── When to Use — Triggers and conditions
|
|
149
|
+
├── Core Process — Step-by-step workflow
|
|
150
|
+
├── Examples — Code samples and patterns
|
|
151
|
+
├── Common Rationalizations — Excuses and rebuttals
|
|
152
|
+
├── Red Flags — Signs the skill is being violated
|
|
153
|
+
└── Verification — Exit criteria checklist
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
See [skill-anatomy.md](skill-anatomy.md) for the full specification.
|
|
157
|
+
|
|
158
|
+
## Using Agents
|
|
159
|
+
|
|
160
|
+
The `agents/` directory contains pre-configured agent personas:
|
|
161
|
+
|
|
162
|
+
| Agent | Purpose |
|
|
163
|
+
|-------|---------|
|
|
164
|
+
| `code-reviewer.md` | Five-axis code review (read-only) |
|
|
165
|
+
| `test-engineer.md` | Test strategy and writing |
|
|
166
|
+
| `security-auditor.md` | Vulnerability detection (read-only) |
|
|
167
|
+
| `web-performance-auditor.md` | Core Web Vitals & performance audit (read-only, via `/webperf`) |
|
|
168
|
+
| `planner.md` | Numbered implementation plans (read-only) |
|
|
169
|
+
| `plan-reviewer.md` | Critiques and validates plans (read-only) |
|
|
170
|
+
| `builder.md` | Implements an approved plan |
|
|
171
|
+
| `documenter.md` | READMEs and inline docs |
|
|
172
|
+
|
|
173
|
+
Load an agent definition when you need specialized review. For example, ask your coding agent to "review this change using the code-reviewer agent persona" and provide the agent definition.
|
|
174
|
+
|
|
175
|
+
## Using Commands
|
|
176
|
+
|
|
177
|
+
The `.claude/commands/` directory contains slash commands for Claude Code:
|
|
178
|
+
|
|
179
|
+
| Command | Skill Invoked |
|
|
180
|
+
|---------|---------------|
|
|
181
|
+
| `/setup-agent-fleet` | guided-workspace-setup |
|
|
182
|
+
| `/spec` | spec-driven-development |
|
|
183
|
+
| `/plan` | planning-and-task-breakdown |
|
|
184
|
+
| `/build` | incremental-implementation + test-driven-development |
|
|
185
|
+
| `/build auto` | planning-and-task-breakdown → incremental-implementation + test-driven-development (whole plan, one approval) |
|
|
186
|
+
| `/test` | test-driven-development |
|
|
187
|
+
| `/review` | code-review-and-quality |
|
|
188
|
+
| `/code-simplify` | code-simplification |
|
|
189
|
+
| `/ship` | shipping-and-launch |
|
|
190
|
+
| `/webperf` | web-performance-auditor (specialist agent, web apps only) |
|
|
191
|
+
|
|
192
|
+
## Using References
|
|
193
|
+
|
|
194
|
+
The `references/` directory contains supplementary checklists:
|
|
195
|
+
|
|
196
|
+
| Reference | Use With |
|
|
197
|
+
|-----------|----------|
|
|
198
|
+
| `testing-patterns.md` | test-driven-development |
|
|
199
|
+
| `performance-checklist.md` | performance-optimization |
|
|
200
|
+
| `security-checklist.md` | security-and-hardening |
|
|
201
|
+
| `accessibility-checklist.md` | frontend-ui-engineering |
|
|
202
|
+
| `definition-of-done.md` | incremental-implementation, planning-and-task-breakdown |
|
|
203
|
+
| `observability-checklist.md` | observability-and-instrumentation |
|
|
204
|
+
| `orchestration-patterns.md` | orchestration-verification, designing-agents |
|
|
205
|
+
| `prompting-patterns.md` | context-engineering |
|
|
206
|
+
|
|
207
|
+
Load a reference when you need detailed patterns beyond what the skill covers.
|
|
208
|
+
|
|
209
|
+
## Spec and task artifacts
|
|
210
|
+
|
|
211
|
+
The `/spec` and `/plan` commands create working artifacts (`SPEC.md`, `tasks/plan.md`, `tasks/todo.md`). Treat them as **living documents** while the work is in progress:
|
|
212
|
+
|
|
213
|
+
- Keep them in version control during development so the human and the agent have a shared source of truth.
|
|
214
|
+
- Update them when scope or decisions change.
|
|
215
|
+
- If your repo doesn’t want these files long‑term, delete them before merge or add the folder to `.gitignore` — the workflow doesn’t require them to be permanent.
|
|
216
|
+
|
|
217
|
+
## Contributor verification
|
|
218
|
+
|
|
219
|
+
The live Agent Fleet hub delegation smoke is intentionally outside the default unit suite. It uses the current checkout's `HEAD` and a deterministic local Pi fixture (no network/model call):
|
|
220
|
+
|
|
221
|
+
```bash
|
|
222
|
+
node --test scripts/agent-fleet-head-count-smoke.test.mjs
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
## Tips
|
|
226
|
+
|
|
227
|
+
1. **Start with spec-driven-development** for any non-trivial work
|
|
228
|
+
2. **Always load test-driven-development** when writing code
|
|
229
|
+
3. **Don't skip verification steps** — they're the whole point
|
|
230
|
+
4. **Load skills selectively** — more context isn't always better
|
|
231
|
+
5. **Use the agents for review** — different perspectives catch different issues
|