@chankov/agent-fleet 0.0.4 → 0.0.6
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-telegram.md +15 -0
- package/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.pi/agents/dispatch-policy.yaml +1 -1
- package/.pi/agents/peers.yaml +4 -4
- 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 +3 -3
- package/.pi/extensions/chrome-devtools-mcp/index.ts +1 -0
- package/.pi/extensions/compact-and-continue/README.md +2 -2
- package/.pi/extensions/mcp-bridge/README.md +1 -1
- 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 +84 -84
- package/.pi/harnesses/agent-hub/backend-policy.js +1 -1
- package/.pi/harnesses/agent-hub/delegate.ts +3 -3
- package/.pi/harnesses/agent-hub/drift-watchdog.js +1 -1
- package/.pi/harnesses/agent-hub/index.ts +254 -254
- package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +1 -1
- package/.pi/harnesses/agent-hub/monitor-publisher.ts +3 -3
- package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +1 -1
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/run-budget.js +1 -1
- package/.pi/harnesses/ask-user-remote/README.md +1 -0
- package/.pi/harnesses/ask-user-remote/index.ts +36 -8
- package/.pi/harnesses/coms/README.md +7 -7
- package/.pi/harnesses/coms/index.ts +13 -13
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/README.md +16 -16
- package/.pi/harnesses/damage-control-continue/index.ts +11 -11
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
- package/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.5/.claude/commands/build.md +44 -0
- package/.versions/0.0.5/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.5/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.5/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.5/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.5/.claude/commands/plan.md +16 -0
- package/.versions/0.0.5/.claude/commands/prime.md +22 -0
- package/.versions/0.0.5/.claude/commands/review.md +16 -0
- package/.versions/0.0.5/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.5/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.5/.claude/commands/ship.md +72 -0
- package/.versions/0.0.5/.claude/commands/spec.md +15 -0
- package/.versions/0.0.5/.claude/commands/test.md +19 -0
- package/.versions/0.0.5/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.5/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.5/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.5/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.5/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.5/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.5/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.5/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.5/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.5/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.5/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.5/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.5/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.5/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.5/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.5/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.5/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.5/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.5/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.5/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.5/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.5/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.5/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.5/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.5/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
- package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.5/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.5/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.5/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.5/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.5/.pi/extensions/package.json +9 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/README.md +798 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/delegate.ts +386 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/helpers.ts +214 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/index.ts +8045 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/run-budget.js +155 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/spawn.ts +246 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.5/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.5/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.5/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.5/.pi/harnesses/coms/README.md +92 -0
- package/.versions/0.0.5/.pi/harnesses/coms/index.ts +1745 -0
- package/.versions/0.0.5/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.5/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.5/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.5/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.5/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.5/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.5/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.5/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.versions/0.0.5/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
- package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.5/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.5/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.5/.pi/prompts/build.md +24 -0
- package/.versions/0.0.5/.pi/prompts/code-simplify.md +22 -0
- package/.versions/0.0.5/.pi/prompts/plan.md +16 -0
- package/.versions/0.0.5/.pi/prompts/review.md +16 -0
- package/.versions/0.0.5/.pi/prompts/set-hermes-telegram.md +15 -0
- package/.versions/0.0.5/.pi/prompts/ship.md +17 -0
- package/.versions/0.0.5/.pi/prompts/spec.md +15 -0
- package/.versions/0.0.5/.pi/prompts/test.md +19 -0
- package/.versions/0.0.5/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.5/.version +1 -0
- package/.versions/0.0.5/agents/architect.md +23 -0
- package/.versions/0.0.5/agents/bowser.md +26 -0
- package/.versions/0.0.5/agents/builder.md +53 -0
- package/.versions/0.0.5/agents/code-reviewer.md +205 -0
- package/.versions/0.0.5/agents/deep-researcher.md +31 -0
- package/.versions/0.0.5/agents/documenter.md +18 -0
- package/.versions/0.0.5/agents/orchestrator.md +54 -0
- package/.versions/0.0.5/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.5/agents/planner.md +69 -0
- package/.versions/0.0.5/agents/releaser.md +24 -0
- package/.versions/0.0.5/agents/researcher.md +28 -0
- package/.versions/0.0.5/agents/security-auditor.md +166 -0
- package/.versions/0.0.5/agents/test-engineer.md +151 -0
- package/.versions/0.0.5/agents/web-debugger.md +42 -0
- package/.versions/0.0.5/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.5/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.5/docs/ARCHITECTURE.md +210 -0
- package/.versions/0.0.5/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.5/docs/claude-code-coms-bridge.md +103 -0
- package/.versions/0.0.5/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.5/docs/coms-hermes-bridge.md +179 -0
- package/.versions/0.0.5/docs/getting-started.md +183 -0
- package/.versions/0.0.5/docs/npm-install.md +337 -0
- package/.versions/0.0.5/docs/opencode-setup.md +249 -0
- package/.versions/0.0.5/docs/pi-extensions.md +293 -0
- package/.versions/0.0.5/docs/pi-setup.md +472 -0
- package/.versions/0.0.5/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.5/hermes/README.md +231 -0
- package/.versions/0.0.5/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.5/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.5/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.5/hooks/coms-stop-hook.mjs +73 -0
- package/.versions/0.0.5/hooks/hooks.json +14 -0
- package/.versions/0.0.5/hooks/session-start.sh +74 -0
- package/.versions/0.0.5/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.5/justfile +245 -0
- package/.versions/0.0.5/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.5/references/definition-of-done.md +67 -0
- package/.versions/0.0.5/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.5/references/observability-checklist.md +91 -0
- package/.versions/0.0.5/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.5/references/performance-checklist.md +153 -0
- package/.versions/0.0.5/references/prompting-patterns.md +380 -0
- package/.versions/0.0.5/references/security-checklist.md +179 -0
- package/.versions/0.0.5/references/testing-patterns.md +236 -0
- package/.versions/0.0.5/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.5/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.5/scripts/coms-claude-bridge.ts +286 -0
- package/.versions/0.0.5/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.5/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.5/scripts/fleet.ts +141 -0
- package/.versions/0.0.5/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.5/scripts/hermes-monitor-scenario.ts +7 -0
- package/.versions/0.0.5/scripts/lib/claude-bridge-core.ts +100 -0
- package/.versions/0.0.5/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.5/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.5/scripts/lib/coms-envelope.ts +539 -0
- package/.versions/0.0.5/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.5/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.5/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.5/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.5/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.5/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.5/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.5/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.5/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.5/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.5/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.5/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.5/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.5/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.5/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.5/scripts/team-up.ts +351 -0
- package/.versions/0.0.5/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.5/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.5/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.5/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.5/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.5/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.5/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.5/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.5/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.5/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.5/skills/guided-workspace-setup/SKILL.md +542 -0
- package/.versions/0.0.5/skills/guided-workspace-setup/companion-manifest.json +35 -0
- package/.versions/0.0.5/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.5/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.5/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.5/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.5/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.5/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.5/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.5/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.5/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.5/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.5/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.5/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.5/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.5/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.5/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- 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-cap.test.py +15 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -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/adapter.test.py +39 -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-validation.test.py +12 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -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/CHANGELOG.md +15 -0
- package/README.md +38 -36
- package/agents/documenter.md +1 -1
- package/agents/releaser.md +1 -1
- package/bin/cli.js +103 -21
- package/bin/lib/bootstrap.js +16 -16
- package/bin/lib/doctor.js +1 -1
- package/bin/lib/set-hermes-telegram.js +323 -0
- package/docs/ARCHITECTURE.md +8 -8
- package/docs/agent-fleet-setup.md +12 -12
- package/docs/claude-code-coms-bridge.md +4 -4
- package/docs/codex-remote-conductor.md +12 -12
- package/docs/coms-hermes-bridge.md +62 -4
- package/docs/getting-started.md +4 -4
- package/docs/npm-install.md +21 -21
- package/docs/opencode-setup.md +1 -0
- package/docs/pi-extensions.md +36 -31
- package/docs/pi-setup.md +66 -53
- package/hermes/README.md +14 -11
- package/justfile +141 -152
- package/package.json +6 -3
- package/references/fleet-coordination-patterns.md +3 -3
- package/scripts/coms-hermes-bridge.ts +18 -8
- package/scripts/fleet.ts +141 -0
- package/scripts/lib/fleet-command.ts +109 -0
- package/scripts/lib/hermes-bridge-core.ts +5 -2
- package/scripts/lib/hermes-monitor-herdr.ts +2 -28
- package/scripts/lib/hermes-monitor-model.ts +3 -9
- package/scripts/lib/hermes-monitor-registry.ts +2 -6
- package/scripts/lib/hermes-monitor-socket.ts +2 -118
- package/scripts/lib/hermes-monitor-store.ts +2 -31
- package/scripts/lib/team-project.ts +10 -3
- package/scripts/team-snapshot.ts +4 -5
- package/scripts/team-up.ts +24 -6
- 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 +27 -18
- package/skills/guided-workspace-setup/companion-manifest.json +3 -1
- package/skills/peer-coms/SKILL.md +1 -1
- package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +0 -10
- /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/{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/{.pi → .versions/0.0.5/.pi}/prompts/doctor-agent-fleet.md +0 -0
- /package/{.pi → .versions/0.0.5/.pi}/prompts/setup-agent-fleet.md +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/desktop-plugins/agent-fleet-monitor/plugin.js +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/desktop-plugins/agent-fleet-monitor/state.js +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/manifest.json +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/plugin_api.py +0 -0
- /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -0
package/bin/lib/bootstrap.js
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
// bootstrap.js — drop the minimum installer artifacts a coding agent needs
|
|
2
|
-
// to recognize
|
|
2
|
+
// to recognize Agent Fleet's setup and doctor slash commands.
|
|
3
3
|
//
|
|
4
4
|
// The CLI's `init` calls this before the handoff message. Without it, a
|
|
5
|
-
// fresh workspace has no `.claude/commands/setup-agent-fleet.md`,
|
|
6
|
-
// etc., so the agent has no
|
|
7
|
-
// breaks silently.
|
|
5
|
+
// fresh workspace has no `.claude/commands/setup-agent-fleet.md`,
|
|
6
|
+
// `.pi/prompts/af-setup-agent-fleet.md`, etc., so the agent has no setup
|
|
7
|
+
// entrypoint and the whole hand-off breaks silently.
|
|
8
8
|
//
|
|
9
9
|
// What we bootstrap (per agent):
|
|
10
10
|
// - The `setup` slash command (so the user can invoke it)
|
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
// What we do NOT bootstrap:
|
|
17
17
|
// - Any of the user-facing skills (spec-driven-development,
|
|
18
18
|
// test-driven-development, …). Those are picked by the user inside
|
|
19
|
-
//
|
|
19
|
+
// through the runtime's setup command, by design. The CLI never decides the workspace's catalogue
|
|
20
20
|
// for the user.
|
|
21
21
|
//
|
|
22
22
|
// Method:
|
|
@@ -93,10 +93,10 @@ function plan({ agent, sourceRoot, workspace }) {
|
|
|
93
93
|
|
|
94
94
|
case "pi":
|
|
95
95
|
return [
|
|
96
|
-
{ kind: "prompt", src: join(sourceRoot, ".pi/prompts/setup-agent-fleet.md"),
|
|
97
|
-
dest: join(workspace, ".pi/prompts/setup-agent-fleet.md") },
|
|
98
|
-
{ kind: "prompt", src: join(sourceRoot, ".pi/prompts/doctor-agent-fleet.md"),
|
|
99
|
-
dest: join(workspace, ".pi/prompts/doctor-agent-fleet.md") },
|
|
96
|
+
{ kind: "prompt", src: join(sourceRoot, ".pi/prompts/af-setup-agent-fleet.md"),
|
|
97
|
+
dest: join(workspace, ".pi/prompts/af-setup-agent-fleet.md") },
|
|
98
|
+
{ kind: "prompt", src: join(sourceRoot, ".pi/prompts/af-doctor-agent-fleet.md"),
|
|
99
|
+
dest: join(workspace, ".pi/prompts/af-doctor-agent-fleet.md") },
|
|
100
100
|
// pi auto-discovers skills from .pi/skills/ and .agents/skills/ —
|
|
101
101
|
// we use .pi/skills/ to avoid polluting a shared .agents/ dir if
|
|
102
102
|
// the user has other tools there.
|
|
@@ -124,9 +124,8 @@ function plan({ agent, sourceRoot, workspace }) {
|
|
|
124
124
|
}
|
|
125
125
|
}
|
|
126
126
|
|
|
127
|
-
//
|
|
128
|
-
//
|
|
129
|
-
// up with both the old and new slash commands.
|
|
127
|
+
// Previous bootstrap targets. Removed during bootstrap so upgrades do not
|
|
128
|
+
// leave both unprefixed and current slash commands in the workspace.
|
|
130
129
|
function legacyPaths({ agent, workspace }) {
|
|
131
130
|
switch (agent) {
|
|
132
131
|
case "claude-code":
|
|
@@ -138,6 +137,8 @@ function legacyPaths({ agent, workspace }) {
|
|
|
138
137
|
return [
|
|
139
138
|
join(workspace, ".pi/prompts/setup.md"),
|
|
140
139
|
join(workspace, ".pi/prompts/doctor.md"),
|
|
140
|
+
join(workspace, ".pi/prompts/setup-agent-fleet.md"),
|
|
141
|
+
join(workspace, ".pi/prompts/doctor-agent-fleet.md"),
|
|
141
142
|
];
|
|
142
143
|
case "opencode":
|
|
143
144
|
return [
|
|
@@ -173,8 +174,7 @@ export function bootstrap({ agent, sourceRoot, workspace, method, dryRun = false
|
|
|
173
174
|
);
|
|
174
175
|
}
|
|
175
176
|
|
|
176
|
-
// Clean up
|
|
177
|
-
// *-agent-fleet so they don't collide with other slash commands.
|
|
177
|
+
// Clean up superseded file names so old and current commands never coexist.
|
|
178
178
|
for (const oldPath of legacyPaths({ agent, workspace })) {
|
|
179
179
|
if (!existsSync(oldPath) && !isSymlink(oldPath)) continue;
|
|
180
180
|
if (dryRun) {
|
|
@@ -205,7 +205,7 @@ export function bootstrap({ agent, sourceRoot, workspace, method, dryRun = false
|
|
|
205
205
|
|
|
206
206
|
// Always replace — the bootstrap is installer scaffolding, not user
|
|
207
207
|
// data. If we left it stale, an upgraded package would still hand off
|
|
208
|
-
// to
|
|
208
|
+
// to an old setup command. Step 6 of guided-workspace-setup explicitly
|
|
209
209
|
// never offers these files in the install menu, so we are the only
|
|
210
210
|
// mechanism that refreshes them.
|
|
211
211
|
if (existsSync(item.dest) || isSymlink(item.dest)) {
|
|
@@ -248,7 +248,7 @@ export function bootstrap({ agent, sourceRoot, workspace, method, dryRun = false
|
|
|
248
248
|
* Remove every bootstrap artifact this module knows how to write. Called
|
|
249
249
|
* by guided-workspace-setup at the end of Step 10 unless the user chose
|
|
250
250
|
* to keep the installer commands. After cleanup, the only way back to
|
|
251
|
-
*
|
|
251
|
+
* the setup command is to re-run `npx @chankov/agent-fleet init`.
|
|
252
252
|
*
|
|
253
253
|
* The same `agent` value must be supplied that was used at bootstrap time —
|
|
254
254
|
* we don't have a tracking file, so we delete based on the plan map.
|
package/bin/lib/doctor.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
// Doctor scan — deterministic preflight extracted from
|
|
2
2
|
// guided-workspace-setup Step 5. Both `agent-fleet doctor` (CLI) and the
|
|
3
|
-
//
|
|
3
|
+
// Runtime-specific Agent Fleet doctor slash commands call into this so behaviour cannot drift.
|
|
4
4
|
//
|
|
5
5
|
// Three classes of findings:
|
|
6
6
|
// 1. Broken symlinks — links whose source has been moved, renamed, or deleted
|
|
@@ -0,0 +1,323 @@
|
|
|
1
|
+
import { createHash, randomUUID } from "node:crypto";
|
|
2
|
+
import { cpSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync } from "node:fs";
|
|
3
|
+
import { isAbsolute, join, relative, resolve } from "node:path";
|
|
4
|
+
import { spawnSync } from "node:child_process";
|
|
5
|
+
|
|
6
|
+
const TELEGRAM_ID_RE = /^\d+(?::\d+)?$/;
|
|
7
|
+
const SAFE_NAME_RE = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
|
|
8
|
+
const BRIDGE_LABEL = "hermes-bridge";
|
|
9
|
+
const LIAISON_SKILL = "hub-liaison";
|
|
10
|
+
|
|
11
|
+
function usageError(detail) {
|
|
12
|
+
return new Error(`${detail}\nUsage:\n agent-fleet set-hermes-telegram install [--profile NAME] [--force] [--restart]\n agent-fleet set-hermes-telegram status [--profile NAME]\n agent-fleet set-hermes-telegram <on|off> <telegram-id[:topic-id]> [--profile NAME]`);
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
export function parseSetHermesTelegramArgs(argv) {
|
|
16
|
+
const [action, telegramId, ...extra] = argv;
|
|
17
|
+
if (["install", "status"].includes(action) && telegramId === undefined && extra.length === 0) return { action };
|
|
18
|
+
if (!["on", "off"].includes(action) || telegramId === undefined || extra.length > 0) {
|
|
19
|
+
throw usageError("Expected install, status, or an on/off action with one Telegram ID.");
|
|
20
|
+
}
|
|
21
|
+
if (!TELEGRAM_ID_RE.test(telegramId)) {
|
|
22
|
+
throw usageError("Telegram ID must be digits, optionally followed by a colon and a numeric topic ID.");
|
|
23
|
+
}
|
|
24
|
+
return { action, telegramId, target: `telegram:${telegramId}` };
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
function validateSafeName(value, label) {
|
|
28
|
+
if (!SAFE_NAME_RE.test(value) || value === "." || value.includes("..")) {
|
|
29
|
+
throw new Error(`Invalid ${label}: ${JSON.stringify(value)}`);
|
|
30
|
+
}
|
|
31
|
+
return value;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
function validateProject(project) {
|
|
35
|
+
return validateSafeName(project, "project inferred from the current pane");
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
export function inferProjectFromProcessInfo(response, env = process.env) {
|
|
39
|
+
const processes = response?.result?.process_info?.foreground_processes ?? [];
|
|
40
|
+
for (const processInfo of processes) {
|
|
41
|
+
const argv = Array.isArray(processInfo?.argv) ? processInfo.argv : [];
|
|
42
|
+
for (let i = 0; i < argv.length; i++) {
|
|
43
|
+
if (argv[i] === "--project" && typeof argv[i + 1] === "string") return validateProject(argv[i + 1]);
|
|
44
|
+
if (typeof argv[i] === "string" && argv[i].startsWith("--project=")) {
|
|
45
|
+
return validateProject(argv[i].slice("--project=".length));
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
const envProject = env.PI_COMS_PROJECT?.trim();
|
|
50
|
+
return validateProject(envProject || "default");
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
function shellQuote(value) {
|
|
54
|
+
return `'${String(value).replaceAll("'", `'"'"'`)}'`;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
export function parseHerdrOutput(stdout) {
|
|
58
|
+
const text = stdout.trim();
|
|
59
|
+
if (!text) return { result: {} };
|
|
60
|
+
return JSON.parse(text);
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
function runCommand(command, args) {
|
|
64
|
+
const result = spawnSync(command, args, { encoding: "utf8" });
|
|
65
|
+
if (result.error) throw new Error(`failed to run ${command}: ${result.error.message}`);
|
|
66
|
+
if (result.status !== 0) throw new Error((result.stderr || result.stdout).trim() || `${command} ${args.join(" ")} failed`);
|
|
67
|
+
return { stdout: result.stdout, stderr: result.stderr };
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
export function runHerdrCommand(args) {
|
|
71
|
+
const result = runCommand("herdr", args);
|
|
72
|
+
try {
|
|
73
|
+
return parseHerdrOutput(result.stdout);
|
|
74
|
+
} catch {
|
|
75
|
+
throw new Error(`herdr returned invalid JSON for ${args.slice(0, 2).join(" ")}`);
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
export function runHermesCommand(args) {
|
|
80
|
+
return runCommand("hermes", args).stdout;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
function stripAnsi(text) {
|
|
84
|
+
return text.replace(/\x1B\[[0-?]*[ -/]*[@-~]/g, "");
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
export function parseRunningGatewayProfiles(output) {
|
|
88
|
+
const profiles = [];
|
|
89
|
+
for (const line of stripAnsi(output).split("\n")) {
|
|
90
|
+
const match = line.match(/^\s*✓\s+([A-Za-z0-9][A-Za-z0-9._-]*)(?:\s|$)/u);
|
|
91
|
+
if (match) profiles.push(match[1]);
|
|
92
|
+
}
|
|
93
|
+
return profiles;
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
export function parseProfilePath(output, expectedProfile) {
|
|
97
|
+
const clean = stripAnsi(output);
|
|
98
|
+
const profile = clean.match(/^Profile:\s*(\S+)\s*$/m)?.[1];
|
|
99
|
+
const profilePath = clean.match(/^Path:\s*(.+?)\s*$/m)?.[1];
|
|
100
|
+
if (profile !== expectedProfile || !profilePath || !isAbsolute(profilePath)) {
|
|
101
|
+
throw new Error(`Hermes returned an invalid profile description for ${expectedProfile}`);
|
|
102
|
+
}
|
|
103
|
+
return resolve(profilePath);
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
function directoryFingerprint(root) {
|
|
107
|
+
if (!existsSync(root)) return null;
|
|
108
|
+
const hash = createHash("sha256");
|
|
109
|
+
function visit(current) {
|
|
110
|
+
const stat = lstatSync(current);
|
|
111
|
+
if (stat.isSymbolicLink()) throw new Error(`refusing symlink in Hermes skill tree: ${current}`);
|
|
112
|
+
if (stat.isDirectory()) {
|
|
113
|
+
for (const name of readdirSync(current).sort()) visit(join(current, name));
|
|
114
|
+
return;
|
|
115
|
+
}
|
|
116
|
+
if (!stat.isFile()) throw new Error(`unsupported entry in Hermes skill tree: ${current}`);
|
|
117
|
+
const rel = relative(root, current);
|
|
118
|
+
hash.update(rel); hash.update("\0"); hash.update(readFileSync(current)); hash.update("\0");
|
|
119
|
+
}
|
|
120
|
+
visit(root);
|
|
121
|
+
return hash.digest("hex");
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
function skillState(sourceDir, installedDir) {
|
|
125
|
+
const sourceFingerprint = directoryFingerprint(sourceDir);
|
|
126
|
+
if (!sourceFingerprint) throw new Error(`packaged ${LIAISON_SKILL} source is missing: ${sourceDir}`);
|
|
127
|
+
const installedFingerprint = directoryFingerprint(installedDir);
|
|
128
|
+
return {
|
|
129
|
+
state: installedFingerprint === null ? "missing" : installedFingerprint === sourceFingerprint ? "current" : "drifted",
|
|
130
|
+
sourceFingerprint,
|
|
131
|
+
installedFingerprint,
|
|
132
|
+
};
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
function parseSkillEnabled(output) {
|
|
136
|
+
return stripAnsi(output).split("\n").some((line) => line.includes(LIAISON_SKILL) && /\benabled\b/i.test(line));
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
export function parseTelegramToolReadiness(output) {
|
|
140
|
+
const clean = stripAnsi(output);
|
|
141
|
+
const enabled = (name) => new RegExp(`^\\s*✓\\s+enabled\\s+${name}\\b`, "m").test(clean);
|
|
142
|
+
return { terminal: enabled("terminal"), file: enabled("file") };
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
async function resolveHermesProfile(requestedProfile, hermes) {
|
|
146
|
+
const gatewaysOutput = await hermes(["gateway", "list"]);
|
|
147
|
+
const runningProfiles = parseRunningGatewayProfiles(gatewaysOutput);
|
|
148
|
+
let profile = requestedProfile?.trim();
|
|
149
|
+
if (profile) validateSafeName(profile, "Hermes profile");
|
|
150
|
+
else {
|
|
151
|
+
if (runningProfiles.length !== 1) {
|
|
152
|
+
throw new Error(`cannot infer Hermes profile: expected exactly one running gateway, found ${runningProfiles.length}; pass --profile NAME`);
|
|
153
|
+
}
|
|
154
|
+
[profile] = runningProfiles;
|
|
155
|
+
}
|
|
156
|
+
const profileOutput = await hermes(["profile", "show", profile]);
|
|
157
|
+
const profilePath = parseProfilePath(profileOutput, profile);
|
|
158
|
+
if (!existsSync(profilePath) || !lstatSync(profilePath).isDirectory() || lstatSync(profilePath).isSymbolicLink()) {
|
|
159
|
+
throw new Error(`unsafe or missing Hermes profile directory: ${profilePath}`);
|
|
160
|
+
}
|
|
161
|
+
return { profile, profilePath, gatewayRunning: runningProfiles.includes(profile) };
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
export async function inspectHermesTelegram(options) {
|
|
165
|
+
const hermes = options.hermes ?? (async (args) => runHermesCommand(args));
|
|
166
|
+
const resolvedProfile = await resolveHermesProfile(options.profile, hermes);
|
|
167
|
+
const sourceDir = options.skillSourceDir ?? join(options.packageRoot, "hermes", "skills", LIAISON_SKILL);
|
|
168
|
+
const installedDir = join(resolvedProfile.profilePath, "skills", LIAISON_SKILL);
|
|
169
|
+
const skill = skillState(sourceDir, installedDir);
|
|
170
|
+
const [skillsOutput, toolsOutput] = await Promise.all([
|
|
171
|
+
hermes(["--profile", resolvedProfile.profile, "skills", "list", "--enabled-only"]),
|
|
172
|
+
hermes(["--profile", resolvedProfile.profile, "tools", "list", "--platform", "telegram"]),
|
|
173
|
+
]);
|
|
174
|
+
const tools = parseTelegramToolReadiness(toolsOutput);
|
|
175
|
+
const skillEnabled = parseSkillEnabled(skillsOutput);
|
|
176
|
+
return {
|
|
177
|
+
...resolvedProfile,
|
|
178
|
+
sourceDir,
|
|
179
|
+
installedDir,
|
|
180
|
+
skillState: skill.state,
|
|
181
|
+
skillEnabled,
|
|
182
|
+
tools,
|
|
183
|
+
ready: skill.state === "current" && skillEnabled && tools.terminal && tools.file && resolvedProfile.gatewayRunning,
|
|
184
|
+
};
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
function readinessError(status) {
|
|
188
|
+
const problems = [];
|
|
189
|
+
if (status.skillState !== "current") problems.push(`${LIAISON_SKILL} is ${status.skillState}`);
|
|
190
|
+
if (!status.skillEnabled) problems.push(`${LIAISON_SKILL} is not enabled`);
|
|
191
|
+
if (!status.tools.terminal || !status.tools.file) problems.push("Telegram terminal/file tools are not both enabled");
|
|
192
|
+
if (!status.gatewayRunning) problems.push(`gateway profile ${status.profile} is not running`);
|
|
193
|
+
return `${problems.join("; ")}. Run: agent-fleet set-hermes-telegram install --profile ${status.profile}${status.skillState === "drifted" ? " --force" : ""}`;
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
function backupName(now) {
|
|
197
|
+
return `${LIAISON_SKILL}-${now().toISOString().replace(/[:.]/g, "-")}`;
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
function ensurePlainDirectory(dir, parent) {
|
|
201
|
+
if (existsSync(dir)) {
|
|
202
|
+
const stat = lstatSync(dir);
|
|
203
|
+
if (stat.isSymbolicLink() || !stat.isDirectory()) throw new Error(`refusing unsafe Hermes directory: ${dir}`);
|
|
204
|
+
return;
|
|
205
|
+
}
|
|
206
|
+
if (parent) ensurePlainDirectory(parent);
|
|
207
|
+
mkdirSync(dir, { mode: 0o700 });
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
function atomicInstallSkill(sourceDir, installedDir, profilePath, now) {
|
|
211
|
+
const skillsDir = join(profilePath, "skills");
|
|
212
|
+
ensurePlainDirectory(skillsDir, profilePath);
|
|
213
|
+
const tempDir = join(skillsDir, `.${LIAISON_SKILL}.tmp-${process.pid}-${randomUUID()}`);
|
|
214
|
+
const backupRoot = join(profilePath, "backups", "agent-fleet");
|
|
215
|
+
let backupDir = null;
|
|
216
|
+
try {
|
|
217
|
+
cpSync(sourceDir, tempDir, { recursive: true, errorOnExist: true, force: false });
|
|
218
|
+
directoryFingerprint(tempDir);
|
|
219
|
+
if (existsSync(installedDir)) {
|
|
220
|
+
ensurePlainDirectory(join(profilePath, "backups"), profilePath);
|
|
221
|
+
ensurePlainDirectory(backupRoot, join(profilePath, "backups"));
|
|
222
|
+
backupDir = join(backupRoot, backupName(now));
|
|
223
|
+
renameSync(installedDir, backupDir);
|
|
224
|
+
}
|
|
225
|
+
renameSync(tempDir, installedDir);
|
|
226
|
+
return backupDir;
|
|
227
|
+
} catch (error) {
|
|
228
|
+
rmSync(tempDir, { recursive: true, force: true });
|
|
229
|
+
if (backupDir && existsSync(backupDir) && !existsSync(installedDir)) renameSync(backupDir, installedDir);
|
|
230
|
+
throw error;
|
|
231
|
+
}
|
|
232
|
+
}
|
|
233
|
+
|
|
234
|
+
export async function installHermesTelegram(options) {
|
|
235
|
+
const hermes = options.hermes ?? (async (args) => runHermesCommand(args));
|
|
236
|
+
const before = await inspectHermesTelegram({ ...options, hermes });
|
|
237
|
+
if (before.skillState === "drifted" && !options.force) {
|
|
238
|
+
throw new Error(`${LIAISON_SKILL} differs from the packaged Agent Fleet version in profile ${before.profile}; re-run with --force to back it up and replace it`);
|
|
239
|
+
}
|
|
240
|
+
let backupDir = null;
|
|
241
|
+
let changed = false;
|
|
242
|
+
if (before.skillState !== "current") {
|
|
243
|
+
backupDir = atomicInstallSkill(before.sourceDir, before.installedDir, before.profilePath, options.now ?? (() => new Date()));
|
|
244
|
+
changed = true;
|
|
245
|
+
}
|
|
246
|
+
const after = await inspectHermesTelegram({ ...options, profile: before.profile, hermes });
|
|
247
|
+
if (after.skillState !== "current") throw new Error(`${LIAISON_SKILL} verification failed after install`);
|
|
248
|
+
let restarted = false;
|
|
249
|
+
if (options.restart && after.gatewayRunning) {
|
|
250
|
+
await hermes(["--profile", after.profile, "gateway", "restart"]);
|
|
251
|
+
restarted = true;
|
|
252
|
+
}
|
|
253
|
+
return {
|
|
254
|
+
action: "install",
|
|
255
|
+
profile: after.profile,
|
|
256
|
+
profilePath: after.profilePath,
|
|
257
|
+
skillState: after.skillState,
|
|
258
|
+
skillEnabled: after.skillEnabled,
|
|
259
|
+
tools: after.tools,
|
|
260
|
+
gatewayRunning: after.gatewayRunning,
|
|
261
|
+
ready: after.skillEnabled && after.tools.terminal && after.tools.file && after.gatewayRunning,
|
|
262
|
+
changed,
|
|
263
|
+
backupDir,
|
|
264
|
+
restarted,
|
|
265
|
+
restartRequired: changed && after.gatewayRunning && !restarted,
|
|
266
|
+
};
|
|
267
|
+
}
|
|
268
|
+
|
|
269
|
+
async function controlBridge(options, parsed) {
|
|
270
|
+
const herdr = options.herdr ?? (async (args) => runHerdrCommand(args));
|
|
271
|
+
const currentPaneId = options.currentPaneId;
|
|
272
|
+
if (!currentPaneId) throw new Error("HERDR_PANE_ID is required; run this command inside a Herdr pane");
|
|
273
|
+
|
|
274
|
+
let hermesProfile = null;
|
|
275
|
+
if (parsed.action === "on") {
|
|
276
|
+
const status = await inspectHermesTelegram(options);
|
|
277
|
+
if (!status.ready) throw new Error(readinessError(status));
|
|
278
|
+
hermesProfile = status.profile;
|
|
279
|
+
}
|
|
280
|
+
|
|
281
|
+
const currentResponse = await herdr(["pane", "get", currentPaneId]);
|
|
282
|
+
const currentPane = currentResponse?.result?.pane;
|
|
283
|
+
if (!currentPane?.workspace_id) throw new Error(`cannot resolve workspace for current pane ${currentPaneId}`);
|
|
284
|
+
const workspaceId = currentPane.workspace_id;
|
|
285
|
+
const processInfo = await herdr(["pane", "process-info", "--pane", currentPaneId]);
|
|
286
|
+
const project = inferProjectFromProcessInfo(processInfo, options.env);
|
|
287
|
+
const list = await herdr(["pane", "list", "--workspace", workspaceId]);
|
|
288
|
+
const bridgePanes = (list?.result?.panes ?? []).filter((pane) => pane.label === BRIDGE_LABEL && pane.pane_id !== currentPaneId);
|
|
289
|
+
for (const pane of bridgePanes) await herdr(["pane", "close", pane.pane_id]);
|
|
290
|
+
|
|
291
|
+
if (parsed.action === "off") {
|
|
292
|
+
return { action: "off", closedPaneIds: bridgePanes.map((pane) => pane.pane_id), project, target: parsed.target, workspaceId };
|
|
293
|
+
}
|
|
294
|
+
|
|
295
|
+
const split = await herdr(["pane", "split", currentPaneId, "--direction", "right", "--ratio", "0.3", "--cwd", currentPane.cwd || process.cwd(), "--no-focus"]);
|
|
296
|
+
const paneId = split?.result?.pane?.pane_id;
|
|
297
|
+
if (!paneId) throw new Error("herdr did not return the new bridge pane ID");
|
|
298
|
+
try {
|
|
299
|
+
await herdr(["pane", "rename", paneId, BRIDGE_LABEL]);
|
|
300
|
+
const command = [
|
|
301
|
+
shellQuote(process.execPath), "--experimental-strip-types",
|
|
302
|
+
shellQuote(join(options.packageRoot, "scripts", "coms-hermes-bridge.ts")),
|
|
303
|
+
"--project", shellQuote(project), "--hermes-profile", shellQuote(hermesProfile),
|
|
304
|
+
"--timeout", "1800000", "--to", shellQuote(parsed.target),
|
|
305
|
+
].join(" ");
|
|
306
|
+
await herdr(["pane", "run", paneId, command]);
|
|
307
|
+
} catch (error) {
|
|
308
|
+
await herdr(["pane", "close", paneId]).catch(() => {});
|
|
309
|
+
throw error;
|
|
310
|
+
}
|
|
311
|
+
return { action: "on", hermesProfile, paneId, project, target: parsed.target, workspaceId };
|
|
312
|
+
}
|
|
313
|
+
|
|
314
|
+
export async function setHermesTelegram(options) {
|
|
315
|
+
const positionals = options.positionals ?? [options.action, options.telegramId].filter((value) => value !== undefined);
|
|
316
|
+
const parsed = parseSetHermesTelegramArgs(positionals);
|
|
317
|
+
if (parsed.action !== "install" && (options.force || options.restart)) {
|
|
318
|
+
throw usageError("--force and --restart are valid only with install.");
|
|
319
|
+
}
|
|
320
|
+
if (parsed.action === "status") return { action: "status", ...(await inspectHermesTelegram(options)) };
|
|
321
|
+
if (parsed.action === "install") return installHermesTelegram(options);
|
|
322
|
+
return controlBridge(options, parsed);
|
|
323
|
+
}
|
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -13,7 +13,7 @@ the runtime responsibilities and where each module lives in the repository.
|
|
|
13
13
|
| **coms** | Peer communication protocol/data plane — envelope-based P2P messaging between agents | `.pi/harnesses/coms/`, `scripts/lib/coms-envelope.ts`, `scripts/coms-cli.ts` |
|
|
14
14
|
| **Claude Code bridge** | Makes an interactive Claude Code pane a bidirectional coms peer | `scripts/coms-claude-bridge.ts`, `hooks/coms-stop-hook.mjs`, `skills/peer-coms/` — see [claude-code-coms-bridge.md](claude-code-coms-bridge.md) |
|
|
15
15
|
| **Hermes bridge** | Remote human control — relays hub questions to Telegram, races phone vs. local answers, conductor/liaison skills | `scripts/coms-hermes-bridge.ts`, `.pi/harnesses/ask-user-remote/`, `hermes/skills/` — see [coms-hermes-bridge.md](coms-hermes-bridge.md) |
|
|
16
|
-
| **Hermes local monitor transport** | Local, authenticated visibility/control contract for hub-owned task generations; presentation is supplied by an external consumer | `.pi/harnesses/agent-hub/monitor-*.ts`,
|
|
16
|
+
| **Hermes local monitor transport** | Local, authenticated visibility/control contract for hub-owned task generations; presentation is supplied by an external consumer | `.pi/harnesses/agent-hub/monitor-*.ts`, `.pi/harnesses/lib/hermes-monitor-{model,store,registry,socket}.ts` (with compatibility re-exports under `scripts/lib/`) — see [Hermes artifacts](../hermes/README.md#local-agent-hub-monitor-integration) |
|
|
17
17
|
| **Codex remote-control conductor** | Experimental outbound-only, user-systemd-managed Android conductor; verified on Codex CLI 0.144.x | `scripts/codex-remote-control.ts`, `scripts/codex-conductor.ts`, `codex/CONDUCTOR.md`, `systemd/user/`; runtime under `~/.local/state/agent-fleet/codex-conductor/` — see [codex-remote-conductor.md](codex-remote-conductor.md) |
|
|
18
18
|
| **Skill library** | Lifecycle workflows and quality gates every agent follows | `skills/` (native) + `vendor/agent-skills-upstream/skills/` (vendored) — see [UPSTREAM-SKILLS.md](UPSTREAM-SKILLS.md) |
|
|
19
19
|
| **Personas** | Reusable specialist definitions, transformed per harness | `agents/`, `bin/lib/transform-persona.js` |
|
|
@@ -26,7 +26,7 @@ Agent Fleet is layered on purpose. Work flows **down** (delegate); evidence and
|
|
|
26
26
|
flowchart TD
|
|
27
27
|
You(["You · Hermes inbound relay · Codex outbound conductor on your phone"])
|
|
28
28
|
|
|
29
|
-
subgraph HUBL["HUB — thin dispatcher (just hub · just
|
|
29
|
+
subgraph HUBL["HUB — thin dispatcher (just fleet hub · just fleet team)"]
|
|
30
30
|
Hub["agent-hub harness + orchestrator persona<br/>routes tasks · owns the Verification Contract on disk<br/>never swallows research dumps into its own context"]
|
|
31
31
|
end
|
|
32
32
|
|
|
@@ -101,7 +101,7 @@ sessions are recycled (fresh spawn instead of `-c` resume) after `session-recycl
|
|
|
101
101
|
or ≥60% measured context — resumed sessions otherwise re-bill their accumulated context on
|
|
102
102
|
every model call. Configured under `## agent-hub` (`mode`, `max-dispatches-per-turn`,
|
|
103
103
|
`max-research-per-turn`, `turn-wall-time-s`, `agent-turn-timeout-s`, `session-recycle-runs`);
|
|
104
|
-
switched live with `/hub-mode`.
|
|
104
|
+
switched live with `/af-hub-mode`.
|
|
105
105
|
|
|
106
106
|
On top of the mode sit three qualitative guardrails. **Task triage**: the dispatcher
|
|
107
107
|
classifies each turn via the `set_task_tier` tool (`trivial`/`small`/`feature`/`project`)
|
|
@@ -111,10 +111,10 @@ observed in-flight from the JSON event stream — deterministic rules (out-of-sc
|
|
|
111
111
|
against the declared `scope` globs, tool-call loops, consecutive failures, tool-call cap)
|
|
112
112
|
escalate to a one-shot cheap LLM judge whose DRIFTING/STUCK verdict terminates the run as
|
|
113
113
|
`drift_stop` (exit 125, partial output preserved); enabled per hub/agent/dispatch
|
|
114
|
-
(`watchdog` key, `/watchdog`, `watchdog` param). **Dynamic teams**: `/agents-add`,
|
|
115
|
-
`/agents-drop`, `/agents-save` restructure the roster live (the system prompt rebuilds
|
|
114
|
+
(`watchdog` key, `/af-watchdog`, `watchdog` param). **Dynamic teams**: `/af-agents-add`,
|
|
115
|
+
`/af-agents-drop`, `/af-agents-save` restructure the roster live (the system prompt rebuilds
|
|
116
116
|
every turn), and the gated `team_adjust` tool lets the dispatcher itself adjust the roster
|
|
117
|
-
outside fast mode, with user notification. `/hub-report` accounts each turn's dispatches,
|
|
117
|
+
outside fast mode, with user notification. `/af-hub-report` accounts each turn's dispatches,
|
|
118
118
|
tokens (billed = input + cacheRead + cacheWrite), recycles, drift stops, and refusals.
|
|
119
119
|
|
|
120
120
|
## Runtime stack (tools the fleet sits on)
|
|
@@ -136,8 +136,8 @@ These are the external systems Agent Fleet assumes or integrates with — not np
|
|
|
136
136
|
|
|
137
137
|
| Dependency | Role | Required? |
|
|
138
138
|
| --- | --- | --- |
|
|
139
|
-
| **[pi](https://github.com/badlogic/pi-mono)** (or your pi install) | Primary coding-agent runtime; loads harnesses, extensions, prompts, and personas | Yes for full fleet mode (`just hub`) |
|
|
140
|
-
| **[herdr](https://herdr.dev)** | Workspace control plane: tiled peer panes, presence push events, team snapshot/resume | Yes for
|
|
139
|
+
| **[pi](https://github.com/badlogic/pi-mono)** (or your pi install) | Primary coding-agent runtime; loads harnesses, extensions, prompts, and personas | Yes for full fleet mode (`just fleet hub`) |
|
|
140
|
+
| **[herdr](https://herdr.dev)** | Workspace control plane: tiled peer panes, presence push events, team snapshot/resume | Yes for team mode (`just fleet team`); optional for `just fleet hub` |
|
|
141
141
|
| **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** | First-class peer via the [coms bridge](claude-code-coms-bridge.md); also a supported install target for skills/personas | Optional peer / alternate harness |
|
|
142
142
|
| **[OpenCode](https://opencode.ai)** | Skill-driven execution target (`AGENTS.md` + `skill` tool); `af-*` slash commands | Optional alternate harness |
|
|
143
143
|
| **Hermes** | Remote human-in-the-loop (Telegram relay for hub questions) — [coms-hermes-bridge](coms-hermes-bridge.md) | Optional |
|
|
@@ -38,7 +38,7 @@ it here, and the reader picks it up.
|
|
|
38
38
|
built-in default.
|
|
39
39
|
- **Validation.** Because an unknown section or key silently falls back to the
|
|
40
40
|
default, typos are invisible at runtime. `agent-fleet doctor` (and the
|
|
41
|
-
|
|
41
|
+
runtime's Agent Fleet doctor command) validates the file — unknown sections,
|
|
42
42
|
unknown keys in known sections, invalid values for the mechanically parsed
|
|
43
43
|
`agent-hub` keys, missing `rules:` folders, and unset `## env` vars — as
|
|
44
44
|
**advisory, warn-only findings**; it never edits the file.
|
|
@@ -91,7 +91,7 @@ override files keep working unchanged. When both sections are present their keys
|
|
|
91
91
|
with later lines winning.
|
|
92
92
|
|
|
93
93
|
The `rules:` and `docs:` keys are also read outside the harness: the `compound-learning`
|
|
94
|
-
skill (and the `/compound`
|
|
94
|
+
skill (and the `/compound` Claude Code / `/af-compound` OpenCode commands built on it) resolves them as the
|
|
95
95
|
targets an end-of-session compound pass writes lessons to.
|
|
96
96
|
|
|
97
97
|
| Key | Default | Meaning |
|
|
@@ -99,21 +99,21 @@ targets an end-of-session compound pass writes lessons to.
|
|
|
99
99
|
| `language` | `English` | User-facing language the dispatcher uses for every `ask_user` question, every `context` field, and every summary. Specialist task strings always stay in English regardless. |
|
|
100
100
|
| `persona-gate` | `off` | When `on`, blocks input at session start until an orchestrator persona is picked. |
|
|
101
101
|
| `model.<persona>` | persona frontmatter `model:` | Replaces the named persona's default model for this project (a full pi model spec). |
|
|
102
|
-
| `models.<persona>` | persona frontmatter `models:` | Replaces the named persona's model-candidate list for `/agent-model` and `/models` profiles (comma-separated pi model specs). |
|
|
103
|
-
| `thinking.<persona>` | persona frontmatter `thinking:` | Replaces the named persona's pi `--thinking` reasoning level for this project: one of `off`, `minimal`, `low`, `medium`, `high`, `xhigh`. Switchable at runtime with `/agent-model-thinking <persona>`. An invalid value is ignored with a session-start warning. |
|
|
102
|
+
| `models.<persona>` | persona frontmatter `models:` | Replaces the named persona's model-candidate list for `/af-agent-model` and `/af-models` profiles (comma-separated pi model specs). |
|
|
103
|
+
| `thinking.<persona>` | persona frontmatter `thinking:` | Replaces the named persona's pi `--thinking` reasoning level for this project: one of `off`, `minimal`, `low`, `medium`, `high`, `xhigh`. Switchable at runtime with `/af-agent-model-thinking <persona>`. An invalid value is ignored with a session-start warning. |
|
|
104
104
|
| `subagents.<persona>.<role>` | persona frontmatter `subagents:` | Replaces or adds one delegate sub-role for this project: `<model>[, tools=<caps>]`. Other declared roles keep their frontmatter values. |
|
|
105
105
|
| `delegate-depth.<persona>` | persona frontmatter `delegate_depth:` (default/max 1) | Replaces the persona's delegation depth budget: `0` makes its delegate tool refuse (delegation off for this project), `1` lets it spawn terminal children. Values above 1 are clamped to 1; children at remaining depth 0 do not receive delegate tooling. |
|
|
106
106
|
| `rules` | none | Comma-separated repo-relative folders holding the project's own rule files (HOW — implementation patterns the work must comply with). Resolution is **index-first**: when a folder has a top-level `README.md`/`index.md`, personas read it first and follow its loading manifest (session bundles, conditional-load lists) instead of bulk-reading the tree; a folder without an index is searched **recursively** through all subfolders. The harness tells every dispatched specialist where the rules live and how to resolve them; the planner and code-reviewer personas read the relevant rules, validate their subject against them, and pass them on (cited in plan acceptance criteria / handed to delegate sub-reviewers). Missing folders produce a session-start warning. |
|
|
107
107
|
| `docs` | none | Comma-separated repo-relative documentation **entry points** (WHAT/WHY — architecture, standards, decisions): canonical files (e.g. `Docs/AGENTS.md`) or doc folders (personas start from a folder's `README.md`/index). Unlike `rules`, docs orient rather than bind: every dispatched specialist and research helper is told to read the entry points relevant to its task and follow their links instead of bulk-reading doc trees; the code-reviewer flags changes that alter documented behavior without a doc update; the documenter treats the entry points and the trees they link as the docs it maintains. Missing paths produce a session-start warning. |
|
|
108
|
-
| `research-keep` | `4` | How many **finished** manual/persona research helpers the hub retains (LRU by finish time) so they stay resumable via `/agents-cont rN`; older ones are pruned along with their session files. `all` disables the cap. Auto-research pipe helpers (spawned for `NEEDS_RESEARCH:` pauses) are always pruned as soon as they finish — their findings persist as files under `.pi/agent-sessions/findings/`. Running helpers are never pruned. An invalid value is ignored with a session-start warning. |
|
|
108
|
+
| `research-keep` | `4` | How many **finished** manual/persona research helpers the hub retains (LRU by finish time) so they stay resumable via `/af-agents-cont rN`; older ones are pruned along with their session files. `all` disables the cap. Auto-research pipe helpers (spawned for `NEEDS_RESEARCH:` pauses) are always pruned as soon as they finish — their findings persist as files under `.pi/agent-sessions/findings/`. Running helpers are never pruned. An invalid value is ignored with a session-start warning. |
|
|
109
109
|
| `recon-search-timeout-s` | `120` | Parent-side deadline, in seconds, for each `read`, `grep`, `find`, or `ls` call made by a native research helper or nested delegate child. Accepts an integer `1`–`3600` or `off`; invalid input warns and falls back to `120`. This is **not** an agent/turn deadline: non-tool work can run indefinitely. On timeout the hub returns `tool_timeout` with call metadata, sends SIGTERM to its owned process group, escalates to SIGKILL after a finite grace period, and settles even if the child never closes or a descendant holds a pipe. If that bounded cleanup cannot confirm child/process-group death, the metadata reports `terminationConfirmed: false`; this prevents a parent hang but may indicate an uninterruptible OS-level process needing operator attention. |
|
|
110
|
-
| `mode` | `standard` | Execution mode for the hub's per-turn budgets: `fast` (single-specialist path, no nested delegation, assertion ledger optional), `standard` (batched execution with moderate budgets), or `strict` (full Verification Contract with wide budgets). Budgets are per **user turn** — exhausted budgets make `dispatch_agent`/`spawn_research` refuse with "summarize and ask the user"; the next user message opens a fresh window. Switchable live with `/hub-mode`. |
|
|
110
|
+
| `mode` | `standard` | Execution mode for the hub's per-turn budgets: `fast` (single-specialist path, no nested delegation, assertion ledger optional), `standard` (batched execution with moderate budgets), or `strict` (full Verification Contract with wide budgets). Budgets are per **user turn** — exhausted budgets make `dispatch_agent`/`spawn_research` refuse with "summarize and ask the user"; the next user message opens a fresh window. Switchable live with `/af-hub-mode`. |
|
|
111
111
|
| `max-dispatches-per-turn` | mode default (2/8/24) | `dispatch_agent` calls allowed per user turn. Positive integer or `off` (unlimited). |
|
|
112
|
-
| `max-research-per-turn` | mode default (1/4/12) | `spawn_research` calls allowed per user turn (the auto-research pipe and the `/research` command are exempt). Positive integer or `off`. |
|
|
112
|
+
| `max-research-per-turn` | mode default (1/4/12) | `spawn_research` calls allowed per user turn (the auto-research pipe and the `/af-research` command are exempt). Positive integer or `off`. |
|
|
113
113
|
| `turn-wall-time-s` | mode default (900/3600/14400) | Wall-clock budget, in seconds, per user turn; once exceeded, further dispatch/research calls refuse. Positive integer or `off`. |
|
|
114
114
|
| `agent-turn-timeout-s` | mode default (600/1800/off) | Whole-run deadline, in seconds, for each spawned specialist, research helper, and nested delegate child (unlike `recon-search-timeout-s`, this bounds the entire run). On expiry the run terminates as `turn_timeout` (exit 124) with partial output preserved. Positive integer or `off`. |
|
|
115
115
|
| `session-recycle-runs` | mode default (3/5/5) | Recycle a specialist's accumulated session (fresh spawn instead of `-c` resume) after this many resumed runs. Context is also always recycled at ≥60% measured context (input + cacheRead + cacheWrite). Positive integer or `off` (context threshold still applies). |
|
|
116
|
-
| `watchdog` | `auto` | Drift watchdog default for dispatched specialists: `auto`/`on` arm the in-flight rules (out-of-scope writes, tool-call loops, repeated failures, tool-call cap) with LLM-judge escalation; `off` disarms. Overridable live per hub (`/watchdog on\|off\|auto`), per agent (`/watchdog <agent> on\|off\|clear`), and per dispatch (the `watchdog` param). A DRIFTING/STUCK verdict terminates the run as `drift_stop` (exit 125) with partial output preserved. |
|
|
116
|
+
| `watchdog` | `auto` | Drift watchdog default for dispatched specialists: `auto`/`on` arm the in-flight rules (out-of-scope writes, tool-call loops, repeated failures, tool-call cap) with LLM-judge escalation; `off` disarms. Overridable live per hub (`/af-watchdog on\|off\|auto`), per agent (`/af-watchdog <agent> on\|off\|clear`), and per dispatch (the `watchdog` param). A DRIFTING/STUCK verdict terminates the run as `drift_stop` (exit 125) with partial output preserved. |
|
|
117
117
|
| `watchdog-judge-model` | researcher persona's model | pi model spec for the one-shot drift judge (e.g. `openai-codex/gpt-5.3-codex-spark`). Falls back to the researcher persona's resolved model, then the dispatcher's. |
|
|
118
118
|
|
|
119
119
|
Example — switch the dispatcher to Bulgarian, pin the builder to sonnet, raise the
|
|
@@ -152,12 +152,12 @@ required: APP_TEST_ADMIN_USER, APP_TEST_ADMIN_PASS, AZURE_SPEECH_KEY
|
|
|
152
152
|
```
|
|
153
153
|
|
|
154
154
|
No skill or harness loads this section. Its only reader is `agent-fleet doctor`
|
|
155
|
-
(and
|
|
155
|
+
(and the runtime's Agent Fleet doctor command), which warns when a declared name is neither set in
|
|
156
156
|
the environment nor declared in the workspace root `.env`.
|
|
157
157
|
|
|
158
158
|
### Per-peer env files (`env_file:` in peers.yaml)
|
|
159
159
|
|
|
160
|
-
Fleet peers spawned by `just
|
|
160
|
+
Fleet peers spawned by `just fleet team` can carry their own
|
|
161
161
|
environment: an `env_file:` entry in `.pi/agents/peers.yaml` names a
|
|
162
162
|
**repo-relative** KEY=VALUE file (same format as `.env`, no shell evaluation)
|
|
163
163
|
that herdr injects into the peer's pane before the command runs — no `source`,
|
|
@@ -243,12 +243,12 @@ available). The reader differs by runtime: pi's harness parses its YAML, while
|
|
|
243
243
|
| pi | `.pi/agents/teams.yaml` | via the `agent-hub` harness (no `/orchestrate`) |
|
|
244
244
|
|
|
245
245
|
Switch teams at runtime with `/orchestrate <team> "<task>"` (parallel of pi's
|
|
246
|
-
`/agents-team`); use `/orchestrate team=<name> <task>` to disambiguate when the
|
|
246
|
+
`/af-agents-team`); use `/orchestrate team=<name> <task>` to disambiguate when the
|
|
247
247
|
task text starts with a word that collides with a team key.
|
|
248
248
|
|
|
249
249
|
**Guided-setup behaviour.** `guided-workspace-setup` offers `/orchestrate`
|
|
250
250
|
**`★`-recommended** for claude-code + opencode (hidden for pi via the existing
|
|
251
|
-
source-availability filter — there is no `.pi/prompts/orchestrate.md`), and
|
|
251
|
+
source-availability filter — there is no `.pi/prompts/af-orchestrate.md`), and
|
|
252
252
|
installs the agent's `orchestrate-teams.yaml` as a **companion** of the command
|
|
253
253
|
(a user-edited config is preserved on uninstall, never silently clobbered).
|
|
254
254
|
Two artifacts stay **claude-only**: the lifecycle **hooks** (they register into
|
|
@@ -20,7 +20,7 @@ Claude Code ── Bash: coms-cli send/await ──▶ any pi peer (o
|
|
|
20
20
|
| Envelope CLI | `scripts/coms-cli.ts` | `list` / `send` / `await` / `reply` — any process becomes a coms participant. `send --await` is a blocking round trip; plain `send` prints a `msg_id` and a detached waiter holds the reply for `await`. |
|
|
21
21
|
| Stop hook | `hooks/coms-stop-hook.mjs` | PRIMARY completion path: writes each turn's final assistant message to `~/.pi/coms/claude-bridge/<pane>/last-message.json` (keyed by `HERDR_PANE_ID`). Exact text, no scraping. |
|
|
22
22
|
| Skill | `skills/peer-coms/SKILL.md` | Teaches Claude Code its peer role: discover with `coms-cli list`, ask with `send --await`, answer inbound prompts normally, never drive panes itself. |
|
|
23
|
-
| Runner | `runner: claude-code` in `.pi/agents/peers.yaml` | `just team
|
|
23
|
+
| Runner | `runner: claude-code` in `.pi/agents/peers.yaml` | `just fleet team` spawns the Claude CLI + its bridge in one pane (`_claude-peer` internally); `model:` maps to `claude --model`, and `just fleet resume` maps the Herdr-captured session id to `claude --resume`. |
|
|
24
24
|
|
|
25
25
|
## Setup
|
|
26
26
|
|
|
@@ -43,7 +43,7 @@ Claude Code ── Bash: coms-cli send/await ──▶ any pi peer (o
|
|
|
43
43
|
is a peer and how to use `coms-cli`.
|
|
44
44
|
|
|
45
45
|
3. **Spawn:** either add a `runner: claude-code` peer to a peers.yaml team and
|
|
46
|
-
`just team
|
|
46
|
+
`just fleet team <team> --no-hub`, or attach a bridge to an existing Herdr Claude pane:
|
|
47
47
|
|
|
48
48
|
```bash
|
|
49
49
|
node --experimental-strip-types scripts/coms-claude-bridge.ts --name claude-main
|
|
@@ -53,9 +53,9 @@ Claude Code ── Bash: coms-cli send/await ──▶ any pi peer (o
|
|
|
53
53
|
## Demo scenario (verified live)
|
|
54
54
|
|
|
55
55
|
```bash
|
|
56
|
-
just team
|
|
56
|
+
just fleet team docs --no-hub # Pi peers up
|
|
57
57
|
# pane with: bridge (claude-main) + claude
|
|
58
|
-
just hub
|
|
58
|
+
just fleet hub # in another pane: the orchestrator
|
|
59
59
|
# from the hub (or any shell):
|
|
60
60
|
node --experimental-strip-types scripts/coms-cli.ts send claude-main \
|
|
61
61
|
"Summarize the failing test output in artifacts/test.log" --await --timeout 300000
|