@chankov/agent-fleet 0.0.5 → 0.0.7
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/set-hermes-watchdog.md +6 -0
- package/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.pi/extensions/agent-fleet-update-check/README.md +4 -4
- package/.pi/extensions/btw/README.md +10 -10
- package/.pi/extensions/btw/index.ts +11 -11
- package/.pi/extensions/chrome-devtools-mcp/README.md +2 -2
- package/.pi/extensions/chrome-devtools-mcp/index.ts +1 -0
- package/.pi/extensions/compact-and-continue/README.md +2 -2
- package/.pi/extensions/pi-voice-stt/README.md +7 -7
- package/.pi/extensions/pi-voice-stt/index.ts +4 -4
- package/.pi/harnesses/agent-hub/README.md +133 -74
- package/.pi/harnesses/agent-hub/artifacts.js +56 -2
- package/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.pi/harnesses/agent-hub/backend-policy.js +1 -1
- package/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.pi/harnesses/agent-hub/delegate.ts +61 -12
- package/.pi/harnesses/agent-hub/drift-watchdog.js +55 -9
- package/.pi/harnesses/agent-hub/helpers.ts +34 -0
- package/.pi/harnesses/agent-hub/index.ts +970 -406
- package/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +2 -2
- package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -11
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.pi/harnesses/agent-hub/return-contract.js +78 -0
- package/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.pi/harnesses/agent-hub/run-budget.js +30 -4
- package/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.pi/harnesses/agent-hub/spawn.ts +109 -1
- package/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
- package/.pi/harnesses/coms/README.md +6 -5
- package/.pi/harnesses/coms/index.ts +92 -70
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/README.md +9 -9
- package/.pi/harnesses/damage-control-continue/index.ts +11 -11
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.pi/harnesses/lib/herdr-client.ts +7 -2
- package/.pi/harnesses/lib/herdr-presence.ts +141 -30
- package/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.pi/harnesses/lib/hermes-monitor-registry.ts +1 -1
- package/.pi/harnesses/lib/hermes-monitor-socket.ts +47 -2
- package/.pi/prompts/{doctor-agent-fleet.md → af-doctor-agent-fleet.md} +1 -1
- package/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.pi/prompts/{setup-agent-fleet.md → af-setup-agent-fleet.md} +1 -1
- package/.versions/0.0.6/.claude/commands/build.md +44 -0
- package/.versions/0.0.6/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.6/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.6/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.6/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.6/.claude/commands/plan.md +16 -0
- package/.versions/0.0.6/.claude/commands/prime.md +22 -0
- package/.versions/0.0.6/.claude/commands/review.md +16 -0
- package/.versions/0.0.6/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.6/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.6/.claude/commands/ship.md +72 -0
- package/.versions/0.0.6/.claude/commands/spec.md +15 -0
- package/.versions/0.0.6/.claude/commands/test.md +19 -0
- package/.versions/0.0.6/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.6/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.6/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.6/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.6/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.6/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.6/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.6/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.6/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.6/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.6/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.6/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.6/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.6/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.6/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.6/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.6/.pi/extensions/package.json +9 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/README.md +798 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/delegate.ts +386 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/helpers.ts +214 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/index.ts +8045 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/run-budget.js +155 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/spawn.ts +246 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.6/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.6/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.6/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.6/.pi/harnesses/coms/README.md +92 -0
- package/.versions/0.0.6/.pi/harnesses/coms/index.ts +1745 -0
- package/.versions/0.0.6/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.6/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.6/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.versions/0.0.6/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.6/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.6/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.6/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.6/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.6/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.6/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.6/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.6/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.6/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.6/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.6/.version +1 -0
- package/.versions/0.0.6/agents/architect.md +23 -0
- package/.versions/0.0.6/agents/bowser.md +26 -0
- package/.versions/0.0.6/agents/builder.md +53 -0
- package/.versions/0.0.6/agents/code-reviewer.md +205 -0
- package/.versions/0.0.6/agents/deep-researcher.md +31 -0
- package/.versions/0.0.6/agents/documenter.md +18 -0
- package/.versions/0.0.6/agents/orchestrator.md +54 -0
- package/.versions/0.0.6/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.6/agents/planner.md +69 -0
- package/.versions/0.0.6/agents/releaser.md +24 -0
- package/.versions/0.0.6/agents/researcher.md +28 -0
- package/.versions/0.0.6/agents/security-auditor.md +166 -0
- package/.versions/0.0.6/agents/test-engineer.md +151 -0
- package/.versions/0.0.6/agents/web-debugger.md +42 -0
- package/.versions/0.0.6/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.6/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.6/docs/ARCHITECTURE.md +210 -0
- package/.versions/0.0.6/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.6/docs/claude-code-coms-bridge.md +103 -0
- package/.versions/0.0.6/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.6/docs/coms-hermes-bridge.md +179 -0
- package/.versions/0.0.6/docs/getting-started.md +183 -0
- package/.versions/0.0.6/docs/npm-install.md +337 -0
- package/.versions/0.0.6/docs/opencode-setup.md +249 -0
- package/.versions/0.0.6/docs/pi-extensions.md +293 -0
- package/.versions/0.0.6/docs/pi-setup.md +476 -0
- package/.versions/0.0.6/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.6/hermes/README.md +231 -0
- package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.6/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.6/hooks/coms-stop-hook.mjs +73 -0
- package/.versions/0.0.6/hooks/hooks.json +14 -0
- package/.versions/0.0.6/hooks/session-start.sh +74 -0
- package/.versions/0.0.6/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.6/justfile +245 -0
- package/.versions/0.0.6/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.6/references/definition-of-done.md +67 -0
- package/.versions/0.0.6/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.6/references/observability-checklist.md +91 -0
- package/.versions/0.0.6/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.6/references/performance-checklist.md +153 -0
- package/.versions/0.0.6/references/prompting-patterns.md +380 -0
- package/.versions/0.0.6/references/security-checklist.md +179 -0
- package/.versions/0.0.6/references/testing-patterns.md +236 -0
- package/.versions/0.0.6/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.6/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.6/scripts/coms-claude-bridge.ts +286 -0
- package/.versions/0.0.6/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.6/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.6/scripts/fleet.ts +141 -0
- package/.versions/0.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.6/scripts/hermes-monitor-scenario.ts +7 -0
- package/.versions/0.0.6/scripts/lib/claude-bridge-core.ts +100 -0
- package/.versions/0.0.6/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.6/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.6/scripts/lib/coms-envelope.ts +539 -0
- package/.versions/0.0.6/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.6/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.6/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.6/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.6/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.6/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.6/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.6/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.6/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.6/scripts/team-up.ts +351 -0
- package/.versions/0.0.6/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.6/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.6/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.6/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.6/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.6/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +544 -0
- package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +35 -0
- package/.versions/0.0.6/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.6/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.6/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.6/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.6/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.6/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.6/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.6/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.6/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.6/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.6/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.6/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.6/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.6/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/.versions/0.0.7/.claude/commands/build.md +44 -0
- package/.versions/0.0.7/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.7/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.7/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.7/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.7/.claude/commands/plan.md +16 -0
- package/.versions/0.0.7/.claude/commands/prime.md +22 -0
- package/.versions/0.0.7/.claude/commands/review.md +16 -0
- package/.versions/0.0.7/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.7/.claude/commands/ship.md +72 -0
- package/.versions/0.0.7/.claude/commands/spec.md +15 -0
- package/.versions/0.0.7/.claude/commands/test.md +19 -0
- package/.versions/0.0.7/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.7/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.7/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.7/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.7/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.7/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.7/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.7/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.7/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.7/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.7/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.7/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.7/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.7/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.7/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.7/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.7/.pi/extensions/package.json +9 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/README.md +857 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/helpers.ts +248 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/index.ts +8609 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/run-budget.js +181 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.7/.pi/harnesses/coms/README.md +93 -0
- package/.versions/0.0.7/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/0.0.7/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/0.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.7/.pi/harnesses/lib/herdr-client.ts +463 -0
- package/.versions/0.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.7/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.7/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.7/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.7/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.7/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.7/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.7/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.7/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.7/.version +1 -0
- package/.versions/0.0.7/agents/architect.md +23 -0
- package/.versions/0.0.7/agents/bowser.md +26 -0
- package/.versions/0.0.7/agents/builder.md +53 -0
- package/.versions/0.0.7/agents/code-reviewer.md +205 -0
- package/.versions/0.0.7/agents/deep-researcher.md +31 -0
- package/.versions/0.0.7/agents/documenter.md +18 -0
- package/.versions/0.0.7/agents/orchestrator.md +65 -0
- package/.versions/0.0.7/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.7/agents/planner.md +69 -0
- package/.versions/0.0.7/agents/releaser.md +24 -0
- package/.versions/0.0.7/agents/researcher.md +28 -0
- package/.versions/0.0.7/agents/security-auditor.md +166 -0
- package/.versions/0.0.7/agents/test-engineer.md +151 -0
- package/.versions/0.0.7/agents/web-debugger.md +42 -0
- package/.versions/0.0.7/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.7/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.7/docs/ARCHITECTURE.md +262 -0
- package/.versions/0.0.7/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.7/docs/claude-code-coms-bridge.md +109 -0
- package/.versions/0.0.7/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.7/docs/coms-hermes-bridge.md +189 -0
- package/.versions/0.0.7/docs/getting-started.md +231 -0
- package/.versions/0.0.7/docs/npm-install.md +337 -0
- package/.versions/0.0.7/docs/opencode-setup.md +249 -0
- package/.versions/0.0.7/docs/pi-extensions.md +293 -0
- package/.versions/0.0.7/docs/pi-setup.md +476 -0
- package/.versions/0.0.7/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.7/hermes/README.md +347 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.7/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/0.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.7/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/0.0.7/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/0.0.7/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.7/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/0.0.7/hooks/hooks.json +14 -0
- package/.versions/0.0.7/hooks/session-start.sh +74 -0
- package/.versions/0.0.7/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.7/justfile +245 -0
- package/.versions/0.0.7/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.7/references/definition-of-done.md +67 -0
- package/.versions/0.0.7/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.7/references/observability-checklist.md +91 -0
- package/.versions/0.0.7/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.7/references/performance-checklist.md +153 -0
- package/.versions/0.0.7/references/prompting-patterns.md +380 -0
- package/.versions/0.0.7/references/security-checklist.md +179 -0
- package/.versions/0.0.7/references/testing-patterns.md +236 -0
- package/.versions/0.0.7/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.7/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.7/scripts/coms-claude-bridge.ts +401 -0
- package/.versions/0.0.7/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.7/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.7/scripts/fleet.ts +149 -0
- package/.versions/0.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.7/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/0.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/0.0.7/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/0.0.7/scripts/lib/claude-bridge-core.ts +165 -0
- package/.versions/0.0.7/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.7/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.7/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/0.0.7/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.7/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.7/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.7/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.7/scripts/lib/monitor-env.ts +120 -0
- package/.versions/0.0.7/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.7/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.7/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.7/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.7/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.7/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.7/scripts/team-up.ts +360 -0
- package/.versions/0.0.7/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.7/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.7/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.7/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.7/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.7/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +544 -0
- package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +35 -0
- package/.versions/0.0.7/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.7/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.7/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.7/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.7/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.7/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.7/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.7/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.7/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.7/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.7/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.7/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.7/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.7/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +140 -0
- package/README.md +198 -40
- package/agents/code-reviewer.md +2 -2
- package/agents/documenter.md +1 -1
- package/agents/orchestrator.md +11 -0
- package/agents/plan-reviewer.md +1 -1
- package/agents/planner.md +1 -1
- package/agents/releaser.md +1 -1
- package/agents/security-auditor.md +1 -1
- package/bin/cli.js +60 -21
- package/bin/lib/bootstrap.js +16 -16
- package/bin/lib/doctor.js +1 -1
- package/bin/lib/hermes-profile-artifact.js +144 -0
- package/bin/lib/set-hermes-watchdog.js +173 -0
- package/bin/set-hermes-watchdog.js +26 -0
- package/docs/ARCHITECTURE.md +67 -15
- package/docs/agent-fleet-setup.md +13 -13
- package/docs/claude-code-coms-bridge.md +7 -1
- package/docs/coms-hermes-bridge.md +18 -8
- package/docs/getting-started.md +48 -0
- package/docs/hermes-watchdog-supervisor.md +140 -0
- package/docs/npm-install.md +21 -21
- package/docs/pi-extensions.md +7 -7
- package/docs/pi-setup.md +51 -47
- package/hermes/README.md +135 -19
- package/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +10 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/hooks/coms-stop-hook.mjs +12 -1
- package/package.json +11 -2
- package/references/fleet-coordination-patterns.md +2 -2
- package/scripts/coms-claude-bridge.ts +154 -39
- package/scripts/fleet.ts +9 -1
- package/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/scripts/lib/claude-bridge-core.ts +65 -0
- package/scripts/lib/coms-envelope.ts +44 -1
- package/scripts/lib/hermes-monitor-events.ts +1 -0
- package/scripts/lib/monitor-env.ts +120 -0
- package/scripts/team-snapshot.ts +1 -1
- package/scripts/team-up.ts +10 -1
- package/skills/browser-testing-with-devtools/SKILL.md +1 -1
- package/skills/compound-learning/SKILL.md +3 -3
- package/skills/guided-workspace-setup/SKILL.md +16 -14
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
- /package/.pi/prompts/{build.md → af-build.md} +0 -0
- /package/.pi/prompts/{code-simplify.md → af-code-simplify.md} +0 -0
- /package/.pi/prompts/{plan.md → af-plan.md} +0 -0
- /package/.pi/prompts/{review.md → af-review.md} +0 -0
- /package/.pi/prompts/{set-hermes-telegram.md → af-set-hermes-telegram.md} +0 -0
- /package/.pi/prompts/{ship.md → af-ship.md} +0 -0
- /package/.pi/prompts/{spec.md → af-spec.md} +0 -0
- /package/.pi/prompts/{test.md → af-test.md} +0 -0
package/docs/npm-install.md
CHANGED
|
@@ -32,12 +32,13 @@ So:
|
|
|
32
32
|
```bash
|
|
33
33
|
# In the workspace you want to configure:
|
|
34
34
|
npx @chankov/agent-fleet init
|
|
35
|
-
# Then open your coding agent in this directory and run:
|
|
36
|
-
# /setup-agent-fleet
|
|
35
|
+
# Then open your coding agent in this directory and run the command it prints:
|
|
36
|
+
# Claude Code: /setup-agent-fleet
|
|
37
|
+
# Pi/OpenCode: /af-setup-agent-fleet
|
|
37
38
|
```
|
|
38
39
|
|
|
39
40
|
That's it. `npx` fetches the package, the CLI detects your coding agent and
|
|
40
|
-
prints the
|
|
41
|
+
prints the runtime-appropriate command, which runs the full guided install
|
|
41
42
|
inside your agent.
|
|
42
43
|
|
|
43
44
|
### First-class pi package
|
|
@@ -63,27 +64,28 @@ The package also ships assets for the **experimental Linux Codex Remote-Control
|
|
|
63
64
|
### `npx @chankov/agent-fleet init`
|
|
64
65
|
|
|
65
66
|
Materializes the package, **bootstraps the installer artifacts** into the
|
|
66
|
-
workspace
|
|
67
|
-
and
|
|
67
|
+
workspace, and hands off to the runtime's Agent Fleet setup command. Claude Code
|
|
68
|
+
uses unprefixed installer commands; Pi and OpenCode use `/af-setup-agent-fleet`
|
|
69
|
+
and `/af-doctor-agent-fleet`.
|
|
68
70
|
|
|
69
71
|
What `init` writes per agent:
|
|
70
72
|
|
|
71
73
|
| Agent | Files written to the workspace |
|
|
72
74
|
|---|---|
|
|
73
75
|
| `claude-code` | `.claude/commands/setup-agent-fleet.md`, `.claude/commands/doctor-agent-fleet.md`, `.claude/skills/guided-workspace-setup/SKILL.md` |
|
|
74
|
-
| `pi` | `.pi/prompts/setup-agent-fleet.md`, `.pi/prompts/doctor-agent-fleet.md`, `.pi/skills/guided-workspace-setup/SKILL.md` |
|
|
76
|
+
| `pi` | `.pi/prompts/af-setup-agent-fleet.md`, `.pi/prompts/af-doctor-agent-fleet.md`, `.pi/skills/guided-workspace-setup/SKILL.md` |
|
|
75
77
|
| `opencode` | `.opencode/commands/af-setup-agent-fleet.md`, `.opencode/commands/af-doctor-agent-fleet.md`, `.opencode/skills/guided-workspace-setup/SKILL.md` |
|
|
76
78
|
|
|
77
79
|
These are **just the plumbing** — the slash commands, plus the skill they
|
|
78
80
|
invoke. The actual catalogue (spec-driven-development, code-reviewer,
|
|
79
|
-
test-engineer, pi extensions, …) is picked by you inside
|
|
81
|
+
test-engineer, pi extensions, …) is picked by you inside the setup workflow. Re-run
|
|
80
82
|
`init` to refresh the plumbing after a package upgrade; bootstrap files
|
|
81
83
|
are always overwritten because they're scaffolding, not user data.
|
|
82
84
|
|
|
83
|
-
After
|
|
85
|
+
After the setup workflow finishes its install pass, **the bootstrap files
|
|
84
86
|
are removed by default** so they don't clutter your agent's slash-command
|
|
85
|
-
list. Re-run `npx @chankov/agent-fleet init` whenever you want
|
|
86
|
-
|
|
87
|
+
list. Re-run `npx @chankov/agent-fleet init` whenever you want the runtime's
|
|
88
|
+
setup command back. To keep them in place across runs, reply `keep`
|
|
87
89
|
to the Step 9 confirmation prompt — the skill will record
|
|
88
90
|
`keep-installer: true` in `.ai/agent-fleet-setup.md`.
|
|
89
91
|
|
|
@@ -102,7 +104,7 @@ This is the **authoritative** record of where the npm package lives:
|
|
|
102
104
|
}
|
|
103
105
|
```
|
|
104
106
|
|
|
105
|
-
When
|
|
107
|
+
When the Agent Fleet setup command runs inside your agent, it reads this marker
|
|
106
108
|
*first* to find the source package. This matters on dev machines where you
|
|
107
109
|
may also have a git clone of `agent-fleet` elsewhere — the marker prevents
|
|
108
110
|
the skill from accidentally using that clone instead of the version the
|
|
@@ -133,7 +135,7 @@ npx @chankov/agent-fleet init --workspace ~/projects/foo --method symlink
|
|
|
133
135
|
|
|
134
136
|
Deterministic preflight scan — walks every install-target directory, lists
|
|
135
137
|
broken symlinks and stale persona references, and offers fixes. Same scan
|
|
136
|
-
that
|
|
138
|
+
that the runtime's Agent Fleet doctor command runs inside the agent.
|
|
137
139
|
|
|
138
140
|
| Flag | Default | Purpose |
|
|
139
141
|
|------|---------|---------|
|
|
@@ -150,11 +152,11 @@ npx @chankov/agent-fleet doctor -y
|
|
|
150
152
|
|
|
151
153
|
Reads the workspace's `.ai/agent-fleet-setup.md`, compares the recorded
|
|
152
154
|
package version against the installed package version, and **re-installs the
|
|
153
|
-
|
|
155
|
+
runtime's setup command** so it is always available after an update.
|
|
154
156
|
`guided-workspace-setup` removes the installer command at the end of a run by
|
|
155
157
|
default (Step 10b), so a workspace that has completed setup once would
|
|
156
158
|
otherwise have no command to hand off to. The actual diff-aware refresh then
|
|
157
|
-
runs inside the coding agent via
|
|
159
|
+
runs inside the coding agent via that command.
|
|
158
160
|
|
|
159
161
|
The agent and install method are recovered from the bootstrap marker written
|
|
160
162
|
at init time; if that marker was cleaned up too, `update` auto-detects the
|
|
@@ -165,8 +167,7 @@ Override with `--agent` / `--method`, or preview with `--dry-run`.
|
|
|
165
167
|
# Upgrade the package itself first, then check the delta:
|
|
166
168
|
npm install -g @chankov/agent-fleet@latest
|
|
167
169
|
npx agent-fleet update --workspace .
|
|
168
|
-
#
|
|
169
|
-
# it to review per-artifact diffs.
|
|
170
|
+
# The setup command is now back — run the command printed by update to review diffs.
|
|
170
171
|
```
|
|
171
172
|
|
|
172
173
|
### `npx @chankov/agent-fleet transform-persona`
|
|
@@ -177,8 +178,7 @@ Generates per-agent subagent definitions from the canonical personas in
|
|
|
177
178
|
vocabulary (`read→Read`, `find/ls→Glob`, `claude-opus-*→opus`, …; `mode:
|
|
178
179
|
subagent` + tool denials for OpenCode), agent-hub-only frontmatter dropped,
|
|
179
180
|
body untouched. pi-only personas (`bowser`, `orchestrator`) are refused for
|
|
180
|
-
other agents. This is what
|
|
181
|
-
`/setup-agent-fleet` runs during apply; transformed installs are always
|
|
181
|
+
other agents. This is what the Agent Fleet setup workflow runs during apply; transformed installs are always
|
|
182
182
|
copies (never symlinks), recorded with `transformed: true`.
|
|
183
183
|
|
|
184
184
|
| Flag | Default | Purpose |
|
|
@@ -245,7 +245,7 @@ npm is the recommended path for most users. The other two stay supported:
|
|
|
245
245
|
- **[Claude Code plugin marketplace](../README.md#quick-start)** — best UX
|
|
246
246
|
inside Claude Code. Same skills, marketplace-managed updates.
|
|
247
247
|
- **Git clone + symlinks** — best for skill authors and contributors. Clone
|
|
248
|
-
the repo, run
|
|
248
|
+
the repo, run the setup command for your runtime, and choose `symlink` in Step 8. Updates
|
|
249
249
|
flow through `git pull`. Symlinks need Developer Mode on Windows.
|
|
250
250
|
|
|
251
251
|
All three paths converge on the same `guided-workspace-setup` skill — the
|
|
@@ -261,7 +261,7 @@ npx --yes @chankov/agent-fleet@latest init --agent claude-code --method copy --w
|
|
|
261
261
|
```
|
|
262
262
|
|
|
263
263
|
`doctor` accepts `--yes` for non-interactive repair. Note that the
|
|
264
|
-
LLM-driven
|
|
264
|
+
LLM-driven setup flow is not CI-runnable by design — confirmation gates
|
|
265
265
|
exist precisely so a human approves every write.
|
|
266
266
|
|
|
267
267
|
## Receiving update notifications
|
|
@@ -298,7 +298,7 @@ is available; want me to apply it via `/setup-agent-fleet`?"*
|
|
|
298
298
|
|
|
299
299
|
### 3. pi extension (`agent-fleet-update-check`)
|
|
300
300
|
|
|
301
|
-
When installed
|
|
301
|
+
When installed from the Pi setup flow, the extension fires on the
|
|
302
302
|
first `agent_start` event of each pi session and emits a `ctx.ui.notify`
|
|
303
303
|
message in the pi UI if a newer version is published. Reads the same cache
|
|
304
304
|
as the CLI — no double-fetching.
|
package/docs/pi-extensions.md
CHANGED
|
@@ -26,7 +26,7 @@ conventions. Runtime design specs for the imported harnesses live in `docs/pi-sp
|
|
|
26
26
|
`chrome-devtools-mcp`, `compact-and-continue`, `agent-fleet-update-check`, `btw`, and
|
|
27
27
|
`pi-voice-stt`. pi
|
|
28
28
|
auto-discovers that directory, so they layer onto every session. `btw` adds a
|
|
29
|
-
`/btw <task>` prompt command (plus an `Alt+'` shortcut) that forks the current session
|
|
29
|
+
`/af-btw <task>` prompt command (plus an `Alt+'` shortcut) that forks the current session
|
|
30
30
|
into an in-process sub-session and opens a live modal over it — full context, same
|
|
31
31
|
cwd, follow-up composer, with a compact result card landing in the main transcript at
|
|
32
32
|
idle. See [.pi/extensions/btw/README.md](../.pi/extensions/btw/README.md).
|
|
@@ -37,7 +37,7 @@ Azure Speech (REST short-audio, with optional per-phrase language identification
|
|
|
37
37
|
OpenAI Whisper (Azure AI Foundry). Alt+S toggles record→insert; Enter-while-recording
|
|
38
38
|
transcribes and sends; Esc cancels. It is **gated**: the hotkey binds only once a provider is
|
|
39
39
|
configured (project-local `.ai/stt.json`, the global `~/.pi/agent/stt.json`, or `PI_STT_CONFIG`),
|
|
40
|
-
so an unconfigured session is a no-op. `/stt doctor`
|
|
40
|
+
so an unconfigured session is a no-op. `/af-stt doctor`
|
|
41
41
|
checks the setup. A simplified port of [`cgarrot/pi-voice-stt`](https://github.com/cgarrot/pi-voice-stt);
|
|
42
42
|
see [.pi/extensions/pi-voice-stt/README.md](../.pi/extensions/pi-voice-stt/README.md).
|
|
43
43
|
|
|
@@ -92,7 +92,7 @@ inside the package. The `@mariozechner/pi-*` packages are provided by the pi run
|
|
|
92
92
|
|
|
93
93
|
| Extension | Category | What it does | Run |
|
|
94
94
|
|-----------|----------|--------------|-----|
|
|
95
|
-
| [agent-hub](../.pi/harnesses/agent-hub/README.md) | Orchestration | Supported multi-agent hub: Fleet Core guardrails, dispatcher grid, specialist delegation, research helpers, persona gate, embedded coms, `/handoff`, peer-as-subagent, and footer `v<version> · <model><thinking> · <team>` — plus, inside a [herdr](https://herdr.dev) pane, fleet tools (`herdr_spawn_peer` / `herdr_read_pane` / `herdr_close_pane` with human confirmation / `herdr_notify`) | `just fleet hub` |
|
|
95
|
+
| [agent-hub](../.pi/harnesses/agent-hub/README.md) | Orchestration | Supported multi-agent hub: Fleet Core guardrails, dispatcher grid, specialist delegation, research helpers, persona gate, embedded coms, `/af-handoff`, peer-as-subagent, and footer `v<version> · <model><thinking> · <team>` — plus, inside a [herdr](https://herdr.dev) pane, fleet tools (`herdr_spawn_peer` / `herdr_read_pane` / `herdr_close_pane` with human confirmation / `herdr_notify`) | `just fleet hub` |
|
|
96
96
|
| [ask-user-remote](../.pi/harnesses/ask-user-remote/README.md) | Orchestration | Captures stock `pi-ask-user` and registers the default `ask_user`; with `user-remote` live it races local UI against the Hermes bridge, otherwise it is stock local behavior | Fleet Core (`just fleet`) |
|
|
97
97
|
| [damage-control-continue](../.pi/harnesses/damage-control-continue/README.md) | Safety | Fleet Core safety harness; guards default Pi, Hub, native children, and Herdr Pi peers. Blocks feed back without aborting the turn; protected paths support explicit approval, while dangerous command patterns remain non-exemptible | `just fleet` |
|
|
98
98
|
| [coms](../.pi/harnesses/coms/README.md) | Messaging | Peer-to-peer messaging between agents on one machine, composed with Fleet Core safety and utilities | `just fleet peer <name>` |
|
|
@@ -139,7 +139,7 @@ harnesses:
|
|
|
139
139
|
- **Dispatcher grid** — fixed specialists from `.pi/agents/teams.yaml`, shown in a live dashboard
|
|
140
140
|
with compact/full view toggling.
|
|
141
141
|
- **Specialist delegation** — `dispatch_agent` for writable child-agent work and
|
|
142
|
-
`spawn_research` / `/research` for read-only investigation.
|
|
142
|
+
`spawn_research` / `/af-research` for read-only investigation.
|
|
143
143
|
- **Verification Contract** — the dispatcher owns a ledger of checkable acceptance assertions
|
|
144
144
|
built before any builder runs, via the `set_assertions` / `update_assertion` tools. Each
|
|
145
145
|
assertion is tagged (`test` | `runtime-ui` | `code-grep` | `manual`) and advanced only on
|
|
@@ -152,20 +152,20 @@ harnesses:
|
|
|
152
152
|
dispatch refusal).
|
|
153
153
|
- **Persona gate** — requires an orchestrator persona at startup unless disabled in the local
|
|
154
154
|
override file; the chosen persona also feeds the coms purpose when no explicit `--purpose` is set.
|
|
155
|
-
- **Operator controls** — `/zoom` timeline inspection plus child-agent kill/restart controls.
|
|
155
|
+
- **Operator controls** — `/af-zoom` timeline inspection plus child-agent kill/restart controls.
|
|
156
156
|
- **Damage-control + ask_user by default** — `just fleet hub` and `just fleet hub --solo` load the
|
|
157
157
|
`damage-control-continue` safety harness and `ask-user-remote` before `agent-hub`, so the
|
|
158
158
|
dispatcher's tool calls are checked against the rules file and the `askUserAvailable` probe sees
|
|
159
159
|
`ask_user`. A blocked call feeds back and the turn keeps going rather than aborting. `agent-hub` also
|
|
160
160
|
re-loads `damage-control-continue` into every native specialist, research helper, and nested
|
|
161
161
|
delegate (via an explicit `-e` that survives `--no-extensions`). Protected-path access can be
|
|
162
|
-
granted at runtime: `/allow <pattern> [turn|session]` in the hub pre-authorizes, a parent-session
|
|
162
|
+
granted at runtime: `/af-allow <pattern> [turn|session]` in the hub pre-authorizes, a parent-session
|
|
163
163
|
block opens an approval dialog, and a headless child escalates to the hub. Protected deletion
|
|
164
164
|
offers only deny/once; other protected paths may be scoped to an agent or session. Denial and
|
|
165
165
|
timeout fail closed without aborting the child turn. Destructive bash patterns are never exemptible,
|
|
166
166
|
and a missing continue harness refuses child dispatch.
|
|
167
167
|
- **Embedded coms** — peer discovery, `coms_list` / `coms_send` / `coms_get` / `coms_await`,
|
|
168
|
-
`/handoff`, and peer-as-subagent flows.
|
|
168
|
+
`/af-handoff`, and peer-as-subagent flows.
|
|
169
169
|
- **Solo mode** — `just fleet hub --solo` keeps the dispatcher grid, delegation, research helpers, persona
|
|
170
170
|
gate, and controls, but starts without the embedded coms layer.
|
|
171
171
|
- **Optional Hermes local monitor transport** — uses `AGENT_FLEET_PROFILE_ID`, the absolute
|
package/docs/pi-setup.md
CHANGED
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
|
|
3
3
|
This guide explains how to use Agent Fleet with [pi](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent) — the terminal coding agent from `pi-mono`. Unlike some harnesses, pi has a **native Agent Fleet implementation**, so no prompt hacks are needed for skills: this repo drops in directly. Optional `pi-codex-image-gen` support is credited to <https://github.com/jvm/pi-mono>.
|
|
4
4
|
|
|
5
|
-
This repo also ships pi-native **prompt templates** for the lifecycle slash commands (`/spec`, `/plan`, `/build`, `/test`, `/review`, `/code-simplify`, `/ship`). These commands add workflow orchestration on top of the underlying skills.
|
|
5
|
+
This repo also ships pi-native **prompt templates** for the lifecycle slash commands (`/af-spec`, `/af-plan`, `/af-build`, `/af-test`, `/af-review`, `/af-code-simplify`, `/af-ship`). These commands add workflow orchestration on top of the underlying skills.
|
|
6
6
|
|
|
7
|
-
The specialist **personas** in `agents/` — including `web-performance-auditor` — are available to pi as well and are invoked directly as subagents. Note that `/webperf`
|
|
7
|
+
The specialist **personas** in `agents/` — including `web-performance-auditor` — are available to pi as well and are invoked directly as subagents. Note that `/webperf` on Claude Code (`/af-webperf` on OpenCode) does not have a Pi `.pi/prompts` equivalent; on pi you run the same audit by invoking the `web-performance-auditor` persona.
|
|
8
8
|
|
|
9
9
|
## Overview
|
|
10
10
|
|
|
@@ -21,10 +21,14 @@ This means you get near-parity with Claude Code:
|
|
|
21
21
|
- Skills are selected automatically based on intent
|
|
22
22
|
- Workflows are enforced via `AGENTS.md`
|
|
23
23
|
- Users can explicitly trigger any skill with `/skill:<name>`
|
|
24
|
-
- Users can start lifecycle workflows with `/spec`, `/plan`, `/build`, `/test`, `/review`, `/code-simplify`, and `/ship`
|
|
24
|
+
- Users can start lifecycle workflows with `/af-spec`, `/af-plan`, `/af-build`, `/af-test`, `/af-review`, `/af-code-simplify`, and `/af-ship`
|
|
25
25
|
|
|
26
26
|
No plugin, wrapper, or custom system prompt is required for the core workflow.
|
|
27
27
|
|
|
28
|
+
### Slash-command namespace
|
|
29
|
+
|
|
30
|
+
Agent Fleet owns the lowercase `/af-*` namespace on Pi. This keeps its prompt-template and harness commands distinct from Pi built-ins such as `/model` and `/settings`, skill invocations under `/skill:<name>`, and commands contributed by other installed packages. Examples: `/af-spec`, `/af-agents-list`, and `/af-allow`.
|
|
31
|
+
|
|
28
32
|
**Recommended companion packages:** [`pi-ask-user`](https://github.com/edlsh/pi-ask-user) adds an interactive `ask_user` tool and bundles an `ask-user` skill. It is bundled automatically when you install `@chankov/agent-fleet` as a pi package; clone/symlink setups should install it separately. `pi-codex-image-gen` is an optional suggested npm/pi extension for image generation; guided setup can offer it when package installation is available, but it is not bundled or required.
|
|
29
33
|
|
|
30
34
|
**Experimental phone conductor:** Linux users may pair Codex CLI `0.144.x` with ChatGPT Android to perform human-confirmed outbound delegation to live coms peers. Guided setup installs the repository assets when pi harnesses are selected, but deliberately never changes systemd, Codex auth/config, pairing, or service state. Host setup remains an explicit operator flow; see [Codex Remote-Control Conductor](codex-remote-conductor.md).
|
|
@@ -84,25 +88,25 @@ ln -s /path/to/agent-fleet/.pi/prompts .pi/prompts
|
|
|
84
88
|
This exposes:
|
|
85
89
|
|
|
86
90
|
```text
|
|
87
|
-
/spec
|
|
88
|
-
/plan
|
|
89
|
-
/build
|
|
90
|
-
/test
|
|
91
|
-
/review
|
|
92
|
-
/code-simplify
|
|
93
|
-
/ship
|
|
91
|
+
/af-spec
|
|
92
|
+
/af-plan
|
|
93
|
+
/af-build
|
|
94
|
+
/af-test
|
|
95
|
+
/af-review
|
|
96
|
+
/af-code-simplify
|
|
97
|
+
/af-ship
|
|
94
98
|
```
|
|
95
99
|
|
|
96
100
|
If `.pi/prompts` already exists as a real directory, keep it and symlink the individual command files instead:
|
|
97
101
|
|
|
98
102
|
```bash
|
|
99
|
-
ln -s /path/to/agent-fleet/.pi/prompts/spec.md .pi/prompts/spec.md
|
|
100
|
-
ln -s /path/to/agent-fleet/.pi/prompts/plan.md .pi/prompts/plan.md
|
|
101
|
-
ln -s /path/to/agent-fleet/.pi/prompts/build.md .pi/prompts/build.md
|
|
102
|
-
ln -s /path/to/agent-fleet/.pi/prompts/test.md .pi/prompts/test.md
|
|
103
|
-
ln -s /path/to/agent-fleet/.pi/prompts/review.md .pi/prompts/review.md
|
|
104
|
-
ln -s /path/to/agent-fleet/.pi/prompts/code-simplify.md .pi/prompts/code-simplify.md
|
|
105
|
-
ln -s /path/to/agent-fleet/.pi/prompts/ship.md .pi/prompts/ship.md
|
|
103
|
+
ln -s /path/to/agent-fleet/.pi/prompts/af-spec.md .pi/prompts/af-spec.md
|
|
104
|
+
ln -s /path/to/agent-fleet/.pi/prompts/af-plan.md .pi/prompts/af-plan.md
|
|
105
|
+
ln -s /path/to/agent-fleet/.pi/prompts/af-build.md .pi/prompts/af-build.md
|
|
106
|
+
ln -s /path/to/agent-fleet/.pi/prompts/af-test.md .pi/prompts/af-test.md
|
|
107
|
+
ln -s /path/to/agent-fleet/.pi/prompts/af-review.md .pi/prompts/af-review.md
|
|
108
|
+
ln -s /path/to/agent-fleet/.pi/prompts/af-code-simplify.md .pi/prompts/af-code-simplify.md
|
|
109
|
+
ln -s /path/to/agent-fleet/.pi/prompts/af-ship.md .pi/prompts/af-ship.md
|
|
106
110
|
```
|
|
107
111
|
|
|
108
112
|
4. Install the recommended `pi-ask-user` pi package separately (clone/symlink setup only):
|
|
@@ -135,7 +139,7 @@ pi
|
|
|
135
139
|
|
|
136
140
|
# then type:
|
|
137
141
|
/
|
|
138
|
-
# pi should autocomplete /spec, /plan, /build, /test, /review, /code-simplify, and /ship
|
|
142
|
+
# pi should autocomplete /af-spec, /af-plan, /af-build, /af-test, /af-review, /af-code-simplify, and /af-ship
|
|
139
143
|
```
|
|
140
144
|
|
|
141
145
|
That's it. `AGENTS.md` is already at the repo root and is auto-loaded when pi starts.
|
|
@@ -148,9 +152,9 @@ The always-on utilities:
|
|
|
148
152
|
|
|
149
153
|
- `mcp-bridge/` — a reusable factory that turns any stdio MCP server into a pi extension. This is a library consumed by wrapper extensions. Symlink it alongside wrappers so relative imports resolve; when pi discovers it directly, it intentionally registers no tools or commands by itself.
|
|
150
154
|
- `chrome-devtools-mcp/` — bridges the [`chrome-devtools-mcp`](https://www.npmjs.com/package/chrome-devtools-mcp) server into pi as native tools, unlocking the `browser-testing-with-devtools` skill on pi.
|
|
151
|
-
- `compact-and-continue/` — registers the `request_compaction` tool that queues pi context compaction to run after the current agent turn ends, optionally resuming work from a self-contained continuation prompt. Used by `/build` to offer a "Compact & continue" option at slice-approval time.
|
|
155
|
+
- `compact-and-continue/` — registers the `request_compaction` tool that queues pi context compaction to run after the current agent turn ends, optionally resuming work from a self-contained continuation prompt. Used by `/af-build` to offer a "Compact & continue" option at slice-approval time.
|
|
152
156
|
- `agent-fleet-update-check/` — surfaces an "update available" banner once per session when `@chankov/agent-fleet` has a newer published version than the one recorded in `.ai/agent-fleet-setup.md`. Never blocks startup (soft 3s check); honors `AGENT_SKILLS_NO_UPDATE_CHECK` / `NO_UPDATE_NOTIFIER` / `CI` opt-outs.
|
|
153
|
-
- `btw/` — adds the `/btw <task>` prompt command (and `Alt+'` shortcut): forks the current session into an in-process sub-session that inherits the full conversation as context, runs in the same cwd, and streams into a live modal with a follow-up composer. A compact result card lands in the main transcript at idle (kept out of the main agent's LLM context). See [.pi/extensions/btw/README.md](../.pi/extensions/btw/README.md).
|
|
157
|
+
- `btw/` — adds the `/af-btw <task>` prompt command (and `Alt+'` shortcut): forks the current session into an in-process sub-session that inherits the full conversation as context, runs in the same cwd, and streams into a live modal with a follow-up composer. A compact result card lands in the main transcript at idle (kept out of the main agent's LLM context). See [.pi/extensions/btw/README.md](../.pi/extensions/btw/README.md).
|
|
154
158
|
|
|
155
159
|
To install, symlink the directories into your project's `.pi/extensions/`:
|
|
156
160
|
|
|
@@ -173,7 +177,7 @@ npm ci
|
|
|
173
177
|
|
|
174
178
|
Because the project extensions are symlinks into the clone, these dependencies are reused by every project that links the same extension directories.
|
|
175
179
|
|
|
176
|
-
Verify by starting `pi` and running `/chrome_devtools-status` — expect `Chrome DevTools MCP connected. Registered N tool(s).`
|
|
180
|
+
Verify by starting `pi` and running `/af-chrome_devtools-status` — expect `Chrome DevTools MCP connected. Registered N tool(s).`
|
|
177
181
|
|
|
178
182
|
#### Extension harnesses — orchestration, safety, messaging
|
|
179
183
|
|
|
@@ -284,8 +288,8 @@ pi also searches for prompt templates in:
|
|
|
284
288
|
Each Markdown file becomes a slash command by filename. For example:
|
|
285
289
|
|
|
286
290
|
```
|
|
287
|
-
.pi/prompts/spec.md → /spec
|
|
288
|
-
.pi/prompts/code-simplify.md → /code-simplify
|
|
291
|
+
.pi/prompts/af-spec.md → /af-spec
|
|
292
|
+
.pi/prompts/af-code-simplify.md → /af-code-simplify
|
|
289
293
|
```
|
|
290
294
|
|
|
291
295
|
These lifecycle commands are not replacements for skills. They are workflow entry points that add orchestration and tell the agent which skills to load and follow for the current phase.
|
|
@@ -295,20 +299,20 @@ These lifecycle commands are not replacements for skills. They are workflow entr
|
|
|
295
299
|
Three ways to trigger the workflow:
|
|
296
300
|
|
|
297
301
|
- **Explicit skill:** type `/skill:<name>` (e.g. `/skill:spec-driven-development`)
|
|
298
|
-
- **Lifecycle command:** type `/spec`, `/plan`, `/build`, `/test`, `/review`, `/code-simplify`, or `/ship`
|
|
302
|
+
- **Lifecycle command:** type `/af-spec`, `/af-plan`, `/af-build`, `/af-test`, `/af-review`, `/af-code-simplify`, or `/af-ship`
|
|
299
303
|
- **Automatic:** describe intent in natural language — the model reads `AGENTS.md` and loads the matching skill
|
|
300
304
|
|
|
301
305
|
### 5. Lifecycle Mapping
|
|
302
306
|
|
|
303
307
|
The development lifecycle is encoded in both `AGENTS.md` and the pi prompt templates:
|
|
304
308
|
|
|
305
|
-
- DEFINE → `/spec` → `spec-driven-development`
|
|
306
|
-
- PLAN → `/plan` → `planning-and-task-breakdown`
|
|
307
|
-
- BUILD → `/build` → `incremental-implementation` + `test-driven-development`
|
|
308
|
-
- VERIFY → `/test` → `test-driven-development`; use `debugging-and-error-recovery` when tests or builds fail
|
|
309
|
-
- REVIEW → `/review` → `code-review-and-quality`
|
|
310
|
-
- SIMPLIFY → `/code-simplify` → `code-simplification`
|
|
311
|
-
- SHIP → `/ship` → `shipping-and-launch`
|
|
309
|
+
- DEFINE → `/af-spec` → `spec-driven-development`
|
|
310
|
+
- PLAN → `/af-plan` → `planning-and-task-breakdown`
|
|
311
|
+
- BUILD → `/af-build` → `incremental-implementation` + `test-driven-development`
|
|
312
|
+
- VERIFY → `/af-test` → `test-driven-development`; use `debugging-and-error-recovery` when tests or builds fail
|
|
313
|
+
- REVIEW → `/af-review` → `code-review-and-quality`
|
|
314
|
+
- SIMPLIFY → `/af-code-simplify` → `code-simplification`
|
|
315
|
+
- SHIP → `/af-ship` → `shipping-and-launch`
|
|
312
316
|
|
|
313
317
|
---
|
|
314
318
|
|
|
@@ -329,7 +333,7 @@ pi behavior:
|
|
|
329
333
|
|
|
330
334
|
Equivalent explicit forms:
|
|
331
335
|
```
|
|
332
|
-
/spec Add authentication to this app
|
|
336
|
+
/af-spec Add authentication to this app
|
|
333
337
|
/skill:spec-driven-development
|
|
334
338
|
```
|
|
335
339
|
|
|
@@ -348,7 +352,7 @@ pi behavior:
|
|
|
348
352
|
|
|
349
353
|
Equivalent explicit forms:
|
|
350
354
|
```
|
|
351
|
-
/test This endpoint is returning 500 errors
|
|
355
|
+
/af-test This endpoint is returning 500 errors
|
|
352
356
|
/skill:debugging-and-error-recovery
|
|
353
357
|
```
|
|
354
358
|
|
|
@@ -367,7 +371,7 @@ pi behavior:
|
|
|
367
371
|
|
|
368
372
|
Equivalent explicit forms:
|
|
369
373
|
```
|
|
370
|
-
/review
|
|
374
|
+
/af-review
|
|
371
375
|
/skill:code-review-and-quality
|
|
372
376
|
```
|
|
373
377
|
|
|
@@ -392,16 +396,16 @@ After installing, confirm the integration works:
|
|
|
392
396
|
|
|
393
397
|
1. Run `pi` from inside the repo (or any subdirectory).
|
|
394
398
|
2. Type `/skill:` and confirm the skill list autocompletes with entries like `spec-driven-development`, `incremental-implementation`, `code-review-and-quality`, and `ask-user`.
|
|
395
|
-
3. Type `/` and confirm the lifecycle commands autocomplete: `/spec`, `/plan`, `/build`, `/test`, `/review`, `/code-simplify`, and `/ship`.
|
|
396
|
-
4. Run `/spec design a new feature for X` — confirm pi expands the command and invokes `spec-driven-development`.
|
|
397
|
-
5. Ask: *"fix this bug"* — confirm pi invokes `debugging-and-error-recovery`, or run `/test` to start a TDD/debugging workflow explicitly.
|
|
399
|
+
3. Type `/` and confirm the lifecycle commands autocomplete: `/af-spec`, `/af-plan`, `/af-build`, `/af-test`, `/af-review`, `/af-code-simplify`, and `/af-ship`.
|
|
400
|
+
4. Run `/af-spec design a new feature for X` — confirm pi expands the command and invokes `spec-driven-development`.
|
|
401
|
+
5. Ask: *"fix this bug"* — confirm pi invokes `debugging-and-error-recovery`, or run `/af-test` to start a TDD/debugging workflow explicitly.
|
|
398
402
|
6. Give pi an ambiguous or high-stakes request and confirm it can use the `ask_user` tool / `ask-user` skill to request an explicit decision.
|
|
399
403
|
|
|
400
404
|
If skill autocomplete is empty, check that `.agents/skills` points to a directory containing `<skill-name>/SKILL.md` files and that pi was not started with `--no-skills`.
|
|
401
405
|
|
|
402
406
|
If lifecycle command autocomplete is empty, check that `.pi/prompts` points to a directory containing the command Markdown files and run `/reload` or restart pi.
|
|
403
407
|
|
|
404
|
-
If `/chrome_devtools-status` reports `Cannot find module '@modelcontextprotocol/sdk/client/index.js'`, the MCP extension loaded but its runtime initialization failed. An `[Extensions]` startup entry alone does not prove its tools registered.
|
|
408
|
+
If `/af-chrome_devtools-status` reports `Cannot find module '@modelcontextprotocol/sdk/client/index.js'`, the MCP extension loaded but its runtime initialization failed. An `[Extensions]` startup entry alone does not prove its tools registered.
|
|
405
409
|
|
|
406
410
|
For a cloned or copied install, run:
|
|
407
411
|
|
|
@@ -410,7 +414,7 @@ cd /path/to/agent-fleet/.pi/extensions
|
|
|
410
414
|
npm ci
|
|
411
415
|
```
|
|
412
416
|
|
|
413
|
-
For extensions symlinked into a published `@chankov/agent-fleet` package, update to a package version that declares the extension dependencies at its root, then restart/reload pi. Do not rely on installing only the target workspace's `.pi/extensions/node_modules`: Node may resolve the symlink to the package's real path. Verify the repair with `/chrome_devtools-status`; it must report `connected` and a non-zero registered tool count.
|
|
417
|
+
For extensions symlinked into a published `@chankov/agent-fleet` package, update to a package version that declares the extension dependencies at its root, then restart/reload pi. Do not rely on installing only the target workspace's `.pi/extensions/node_modules`: Node may resolve the symlink to the package's real path. Verify the repair with `/af-chrome_devtools-status`; it must report `connected` and a non-zero registered tool count.
|
|
414
418
|
|
|
415
419
|
The harnesses install separately — if a harness reports `Cannot find module 'yaml'` or `'@sinclair/typebox'`, run `npm ci` in `.pi/harnesses/` as well (or `just install` from the clone, which does both).
|
|
416
420
|
|
|
@@ -439,13 +443,13 @@ Just use natural language:
|
|
|
439
443
|
|
|
440
444
|
Or invoke lifecycle commands when you want the full workflow prompt:
|
|
441
445
|
|
|
442
|
-
- `/spec`
|
|
443
|
-
- `/plan`
|
|
444
|
-
- `/build`
|
|
445
|
-
- `/test`
|
|
446
|
-
- `/review`
|
|
447
|
-
- `/code-simplify`
|
|
448
|
-
- `/ship`
|
|
446
|
+
- `/af-spec`
|
|
447
|
+
- `/af-plan`
|
|
448
|
+
- `/af-build`
|
|
449
|
+
- `/af-test`
|
|
450
|
+
- `/af-review`
|
|
451
|
+
- `/af-code-simplify`
|
|
452
|
+
- `/af-ship`
|
|
449
453
|
|
|
450
454
|
Or invoke individual skills directly when you want precise control:
|
|
451
455
|
|
|
@@ -465,7 +469,7 @@ pi integration works by leveraging pi's **native** Agent Fleet and prompt-templa
|
|
|
465
469
|
- Symlink `.pi/prompts/` into the target project's `.pi/prompts/`
|
|
466
470
|
- Install `@chankov/agent-fleet` as a pi package for bundled `ask_user`, or install `pi-ask-user` separately for clone/symlink setup
|
|
467
471
|
- Let pi auto-load `AGENTS.md` from the repo root
|
|
468
|
-
- Use `/skill:<name>`, lifecycle commands like `/spec`, or natural language to trigger workflows
|
|
472
|
+
- Use `/skill:<name>`, lifecycle commands like `/af-spec`, or natural language to trigger workflows
|
|
469
473
|
|
|
470
474
|
Guided setup can additionally offer the optional `pi-codex-image-gen` package when pi package installation is available, but it is not part of the minimal path.
|
|
471
475
|
|
package/hermes/README.md
CHANGED
|
@@ -1,6 +1,61 @@
|
|
|
1
1
|
# Hermes artifacts
|
|
2
2
|
|
|
3
|
-
This directory
|
|
3
|
+
This directory holds the in-repository Hermes surfaces of Agent Fleet: the
|
|
4
|
+
**Desktop plugin** that shows the live fleet, and the **skills** behind the
|
|
5
|
+
coms ⇄ Hermes question bridge. They are source artifacts, installed into a
|
|
6
|
+
profile explicitly — nothing here is published to npm and nothing writes to
|
|
7
|
+
`~/.hermes` unless you run an installer.
|
|
8
|
+
|
|
9
|
+
Two distinct integrations, easy to conflate:
|
|
10
|
+
|
|
11
|
+
| | What it does | Direction | Entry point |
|
|
12
|
+
|---|---|---|---|
|
|
13
|
+
| **Desktop plugin** (`agent-fleet-herdr`) | Shows every live Agent Fleet session, its state, what it is doing, and which agent is blocked on you | Hermes reads the fleet | [docs/hermes-desktop-plugins.md](../docs/hermes-desktop-plugins.md) |
|
|
14
|
+
| **Question bridge** (`hub-liaison`) | Relays an agent's `ask_user` question to Telegram and races your answer against a local one | The fleet asks you | [docs/coms-hermes-bridge.md](../docs/coms-hermes-bridge.md) |
|
|
15
|
+
|
|
16
|
+
## Desktop plugins
|
|
17
|
+
|
|
18
|
+
`desktop-plugins/<id>/` and `plugins/<id>/` are the two halves of a Hermes
|
|
19
|
+
plugin — the Electron pane and the FastAPI backend it calls. They are installed
|
|
20
|
+
into a profile with `scripts/install-hermes-plugin.sh`, never published to npm.
|
|
21
|
+
The contract, the install runbook, and the failure modes that look identical
|
|
22
|
+
from the outside are documented in
|
|
23
|
+
[docs/hermes-desktop-plugins.md](../docs/hermes-desktop-plugins.md).
|
|
24
|
+
|
|
25
|
+
- `agent-fleet-herdr` — read-only panel of live Agent Fleet sessions grouped by
|
|
26
|
+
project, flagging the ones waiting for a human.
|
|
27
|
+
- `agent-fleet-monitor` — the separate agent-hub task view (leases, generations,
|
|
28
|
+
output cursors) over the local monitor transport described below. Its own
|
|
29
|
+
Desktop panel is deliberately left uninstalled: the subagent tree is rendered
|
|
30
|
+
inside `agent-fleet-herdr`'s session modal instead, so a human never has to
|
|
31
|
+
know which pane to open.
|
|
32
|
+
|
|
33
|
+
### Install the fleet panel
|
|
34
|
+
|
|
35
|
+
Needs Hermes v0.19.0+ with the Desktop app, this checkout, and a fleet that has
|
|
36
|
+
run at least once (so `~/.pi/coms/projects/` exists). herdr is optional —
|
|
37
|
+
without it rows read `unknown` instead of a live state.
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
scripts/install-hermes-plugin.sh agent-fleet-herdr # --profile / --copy / --dry-run / --uninstall
|
|
41
|
+
# then restart the Hermes DESKTOP APP (its gateway is the one that mounts the routes),
|
|
42
|
+
# start a fleet, and open the "Agent Fleet" tab:
|
|
43
|
+
just fleet team default
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+

|
|
47
|
+
|
|
48
|
+
Selecting a row opens a modal with that agent's purpose, model, context, queue,
|
|
49
|
+
uptime and heartbeat, a live tail of what it is doing read from its own
|
|
50
|
+
transcript, the subagents it is running with their stdout and a Cancel each, and
|
|
51
|
+
`Focus pane` to bring its workspace to the front.
|
|
52
|
+
|
|
53
|
+

|
|
54
|
+
|
|
55
|
+
Prerequisites in full, the API, the join rules, the failure modes and the
|
|
56
|
+
deliberate limits: [docs/hermes-desktop-plugins.md](../docs/hermes-desktop-plugins.md).
|
|
57
|
+
|
|
58
|
+
`skills/hub-watchdog/` is an optional foreground, fail-closed monitor consumer. It is packaged source, not an installed or enabled profile skill. Its profile-aware lifecycle is documented in [the watchdog runbook](../docs/hermes-watchdog-supervisor.md): no installer starts/stops a gateway or changes tools, and Gate O has no checked-in live origin proof. The supported posture is journal-only/dormant; it must not deliver, steer, cancel, recover, wake a chat, or choose a fallback route.
|
|
4
59
|
|
|
5
60
|
## Skills
|
|
6
61
|
|
|
@@ -20,7 +75,7 @@ agent-fleet set-hermes-telegram install --profile default --force
|
|
|
20
75
|
agent-fleet set-hermes-telegram install --profile default --force --restart
|
|
21
76
|
```
|
|
22
77
|
|
|
23
|
-
|
|
78
|
+
Pi and OpenCode use `/af-set-hermes-telegram`; Claude Code uses `/set-hermes-telegram`. The installer resolves the real profile path via `hermes profile show`, refuses drift without `--force`, backs up forced replacements, copies atomically, and verifies skill/tool/gateway readiness. It never sends a test Telegram message and never starts a stopped gateway. See [the bridge runbook](../docs/coms-hermes-bridge.md#telegram-bridge-control-command).
|
|
24
79
|
|
|
25
80
|
The current `hermes skills install` CLI documents registry identifiers and direct HTTP(S) `SKILL.md` URLs, not local directories, so `hermes skills install hermes/skills/hub-liaison` is not the supported local installation path.
|
|
26
81
|
|
|
@@ -37,10 +92,11 @@ separate from the Telegram/coms bridge:
|
|
|
37
92
|
- The monitor transport exposes dispatcher and specialist state through owner-only discovery,
|
|
38
93
|
a token file, and a Unix domain socket (UDS).
|
|
39
94
|
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
95
|
+
A Hermes UI, operator tool, or other local client may consume the transport contract described
|
|
96
|
+
below, but it owns its own presentation and lifecycle. The hub remains the source of truth for
|
|
97
|
+
task state and cancellation. Source artifacts being present in this repository or its package do
|
|
98
|
+
not install, enable, or prove a live Hermes client. In particular, monitor cursor/discovery
|
|
99
|
+
fields and local tests are not proof of a Hermes origin identity or watcher delivery route.
|
|
44
100
|
|
|
45
101
|
### Integration in action
|
|
46
102
|
|
|
@@ -58,24 +114,33 @@ transport described below.
|
|
|
58
114
|
|
|
59
115
|
### Start a monitored hub
|
|
60
116
|
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
`HERDR_PANE_ID`; the normal `hub-team` recipe supplies the Herdr environment.
|
|
117
|
+
Nothing to set up. A Herdr-backed hub is required because the stable hub identity includes
|
|
118
|
+
`HERDR_WORKSPACE_ID` and `HERDR_PANE_ID`, so use a team recipe:
|
|
64
119
|
|
|
65
120
|
```bash
|
|
66
|
-
|
|
67
|
-
|
|
121
|
+
just fleet team default
|
|
122
|
+
```
|
|
68
123
|
|
|
69
|
-
|
|
70
|
-
|
|
124
|
+
[scripts/lib/monitor-env.ts](../scripts/lib/monitor-env.ts) picks the profile ID (`dev`) and the
|
|
125
|
+
runtime directory (`$XDG_RUNTIME_DIR/agent-fleet-monitor`, created mode 0700) and the launchers
|
|
126
|
+
export both. Watch the tasks in the **agent-fleet-herdr** pane: select the hub's row, and its
|
|
127
|
+
subagents are a section of the modal with their live output and a Cancel each.
|
|
71
128
|
|
|
72
|
-
|
|
129
|
+
To point a hub at a different profile, or to turn the monitor off, set the variables yourself —
|
|
130
|
+
an existing value is never overwritten:
|
|
131
|
+
|
|
132
|
+
```bash
|
|
133
|
+
AGENT_FLEET_PROFILE_ID=prod just fleet team default # a different Hermes profile
|
|
134
|
+
AGENT_FLEET_MONITOR=0 just fleet team default # unmonitored
|
|
73
135
|
```
|
|
74
136
|
|
|
75
|
-
If either monitor variable is
|
|
76
|
-
monitor stays disabled while normal agent-hub
|
|
77
|
-
with an alphanumeric character and may contain
|
|
78
|
-
rejected
|
|
137
|
+
If either monitor variable is invalid, if the runtime directory cannot be made mode 0700, or if
|
|
138
|
+
the hub lacks stable Herdr identity, the monitor stays disabled while normal agent-hub
|
|
139
|
+
orchestration continues. The profile ID must start with an alphanumeric character and may contain
|
|
140
|
+
only alphanumerics, `.`, `_`, or `-`; `..` is rejected — the same class
|
|
141
|
+
`hermes/plugins/agent-fleet-monitor/dashboard/adapter.py` enforces when it reads the directory
|
|
142
|
+
back, because a value one end accepts and the other rejects is an empty listing with no error
|
|
143
|
+
anywhere.
|
|
79
144
|
|
|
80
145
|
### Discover the local endpoint
|
|
81
146
|
|
|
@@ -192,9 +257,60 @@ const cancelled = await monitorRequest(socketPath, {
|
|
|
192
257
|
|
|
193
258
|
A native specialist cancellation targets only the hub-owned process generation and validates its
|
|
194
259
|
process identity before signalling it. Cancelling a coms-backed run abandons the hub's local wait;
|
|
195
|
-
the remote peer may continue
|
|
260
|
+
the remote peer may continue, so it is never an automatic recovery target and the watchdog must not
|
|
261
|
+
retry or re-dispatch it. Neither operation creates, focuses, closes, or otherwise controls a
|
|
196
262
|
Herdr pane or workspace.
|
|
197
263
|
|
|
264
|
+
### Additive `events` and `invoke` requests
|
|
265
|
+
|
|
266
|
+
Two request types extend the same socket. A hub that does not implement them answers `unsupported`,
|
|
267
|
+
so a snapshot/output/cancel consumer keeps working unchanged.
|
|
268
|
+
|
|
269
|
+
`events` replays a bounded journal from a cursor the consumer holds. Set a read timeout that covers
|
|
270
|
+
the `waitMs` window you ask the hub to hold, or every quiet poll expires locally and looks like an
|
|
271
|
+
outage:
|
|
272
|
+
|
|
273
|
+
```js
|
|
274
|
+
const batch = await monitorRequest(socketPath, {
|
|
275
|
+
type: "events",
|
|
276
|
+
token,
|
|
277
|
+
afterSequence: 0,
|
|
278
|
+
limit: 50, // 1–100
|
|
279
|
+
waitMs: 2000 // 0–25000 long-poll window
|
|
280
|
+
});
|
|
281
|
+
// { ok: true, events: { firstAvailableSequence, latestSequence, items: [...], timedOut } }
|
|
282
|
+
```
|
|
283
|
+
|
|
284
|
+
A cursor older than the retained window is refused rather than silently skipped. Reconcile from a
|
|
285
|
+
fresh snapshot and resume from sequence 0:
|
|
286
|
+
|
|
287
|
+
```json
|
|
288
|
+
{"ok": false, "error": "cursor_too_old", "snapshotRequired": true, "firstAvailableSequence": 9, "latestSequence": 12}
|
|
289
|
+
```
|
|
290
|
+
|
|
291
|
+
`invoke` submits one typed request and returns an admission status — never a result of work:
|
|
292
|
+
|
|
293
|
+
```js
|
|
294
|
+
const admitted = await monitorRequest(socketPath, {
|
|
295
|
+
type: "invoke",
|
|
296
|
+
token,
|
|
297
|
+
requestId: "request-a",
|
|
298
|
+
taskId: "builder:1",
|
|
299
|
+
generation: 1,
|
|
300
|
+
action: "request_status",
|
|
301
|
+
parameters: { assertionIds: [], evidenceEventIds: ["hub:1"] },
|
|
302
|
+
basis: { deviation: "stalled_progress", judgment: "confirmed" }
|
|
303
|
+
});
|
|
304
|
+
// { ok: true, result: { status: "accepted" } }
|
|
305
|
+
```
|
|
306
|
+
|
|
307
|
+
`status` is one of `accepted`, `duplicate`, `queue_full`, `stale_generation`, `owner_changed`,
|
|
308
|
+
`already_terminal`, `idempotency_conflict`, `unsupported`, or `rejected`. `accepted` means the hub
|
|
309
|
+
queued a visible follow-up for its operator; it does not mean anything ran. Reusing a `requestId`
|
|
310
|
+
returns `duplicate` and adds no second follow-up; reusing it with different parameters returns
|
|
311
|
+
`idempotency_conflict`. The action set is closed — there is no shell, tool, Herdr, or free-text
|
|
312
|
+
surface.
|
|
313
|
+
|
|
198
314
|
### Failure and reconnect behavior
|
|
199
315
|
|
|
200
316
|
- `{"ok":false,"error":"unauthorized"}` means the token does not match current ownership.
|