@chankov/agent-fleet 1.0.0 → 1.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.pi/agents/model-profiles.yaml +2 -2
- package/.pi/extensions/package-lock.json +77 -45
- package/.pi/harnesses/agent-hub/README.md +116 -16
- package/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
- package/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.pi/harnesses/agent-hub/hub-state-audit.js +73 -0
- package/.pi/harnesses/agent-hub/index.ts +1095 -465
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/posture.ts +72 -17
- package/.pi/harnesses/agent-hub/run-budget.js +73 -13
- package/.pi/harnesses/agent-hub/spawn.ts +14 -2
- package/.pi/harnesses/ask-user-remote/index.ts +59 -4
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
- package/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
- package/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.pi/harnesses/lib/fleet-dashboard-ops.ts +37 -0
- package/.pi/harnesses/lib/fleet-detail-view.ts +92 -2
- package/.pi/harnesses/package-lock.json +73 -80
- package/.versions/1.0.1/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/1.0.1/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/1.0.1/.pi/agents/peers.yaml +142 -0
- package/.versions/1.0.1/.pi/agents/teams.yaml +41 -0
- package/.versions/1.0.1/.pi/damage-control-rules.yaml +297 -0
- package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/btw/README.md +120 -0
- package/.versions/1.0.1/.pi/extensions/btw/index.ts +914 -0
- package/.versions/1.0.1/.pi/extensions/btw/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/btw/state.js +179 -0
- package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/1.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/1.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/1.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/1.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/package-lock.json +1143 -0
- package/.versions/1.0.1/.pi/extensions/package.json +9 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/README.md +1065 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/footer.ts +35 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/hub-state-audit.js +55 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/index.ts +9343 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/posture.ts +103 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/run-budget.js +540 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/1.0.1/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/1.0.1/.pi/harnesses/ask-user-remote/index.ts +477 -0
- package/.versions/1.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/1.0.1/.pi/harnesses/coms/README.md +100 -0
- package/.versions/1.0.1/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/1.0.1/.pi/harnesses/coms/package.json +7 -0
- package/.versions/1.0.1/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/1.0.1/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/1.0.1/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/1.0.1/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/1.0.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/1.0.1/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/1.0.1/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/1.0.1/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/1.0.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/1.0.1/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/1.0.1/.pi/harnesses/package-lock.json +2046 -0
- package/.versions/1.0.1/.pi/harnesses/package.json +10 -0
- package/.versions/1.0.1/.pi/prompts/af-build.md +24 -0
- package/.versions/1.0.1/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/1.0.1/.pi/prompts/af-plan.md +16 -0
- package/.versions/1.0.1/.pi/prompts/af-review.md +16 -0
- package/.versions/1.0.1/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/1.0.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/1.0.1/.pi/prompts/af-ship.md +17 -0
- package/.versions/1.0.1/.pi/prompts/af-spec.md +15 -0
- package/.versions/1.0.1/.pi/prompts/af-test.md +19 -0
- package/.versions/1.0.1/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/1.0.1/.version +1 -0
- package/.versions/1.0.1/agents/architect.md +24 -0
- package/.versions/1.0.1/agents/bowser.md +27 -0
- package/.versions/1.0.1/agents/builder.md +54 -0
- package/.versions/1.0.1/agents/code-reviewer.md +208 -0
- package/.versions/1.0.1/agents/deep-researcher.md +32 -0
- package/.versions/1.0.1/agents/documenter.md +18 -0
- package/.versions/1.0.1/agents/orchestrator.md +72 -0
- package/.versions/1.0.1/agents/plan-reviewer.md +83 -0
- package/.versions/1.0.1/agents/planner.md +70 -0
- package/.versions/1.0.1/agents/releaser.md +24 -0
- package/.versions/1.0.1/agents/researcher.md +28 -0
- package/.versions/1.0.1/agents/security-auditor.md +167 -0
- package/.versions/1.0.1/agents/test-engineer.md +153 -0
- package/.versions/1.0.1/agents/web-debugger.md +43 -0
- package/.versions/1.0.1/agents/web-performance-auditor.md +193 -0
- package/.versions/1.0.1/bin/catalog/harness-runtime-closure.json +38 -0
- package/.versions/1.0.1/codex/CONDUCTOR.md +148 -0
- package/.versions/1.0.1/docs/ARCHITECTURE.md +337 -0
- package/.versions/1.0.1/docs/agent-fleet-setup.md +437 -0
- package/.versions/1.0.1/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/1.0.1/docs/codex-remote-conductor.md +170 -0
- package/.versions/1.0.1/docs/coms-hermes-bridge.md +189 -0
- package/.versions/1.0.1/docs/getting-started.md +98 -0
- package/.versions/1.0.1/docs/npm-install.md +292 -0
- package/.versions/1.0.1/docs/pi-extensions.md +412 -0
- package/.versions/1.0.1/docs/pi-setup.md +74 -0
- package/.versions/1.0.1/docs/skill-anatomy.md +150 -0
- package/.versions/1.0.1/hermes/README.md +347 -0
- package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/1.0.1/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/1.0.1/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/1.0.1/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/1.0.1/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/1.0.1/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/1.0.1/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/1.0.1/install-manifest.json +2745 -0
- package/.versions/1.0.1/justfile +272 -0
- package/.versions/1.0.1/manifest-meta.json +882 -0
- package/.versions/1.0.1/references/accessibility-checklist.md +160 -0
- package/.versions/1.0.1/references/definition-of-done.md +67 -0
- package/.versions/1.0.1/references/fleet-coordination-patterns.md +151 -0
- package/.versions/1.0.1/references/observability-checklist.md +91 -0
- package/.versions/1.0.1/references/orchestration-patterns.md +370 -0
- package/.versions/1.0.1/references/performance-checklist.md +153 -0
- package/.versions/1.0.1/references/prompting-patterns.md +380 -0
- package/.versions/1.0.1/references/security-checklist.md +179 -0
- package/.versions/1.0.1/references/testing-patterns.md +236 -0
- package/.versions/1.0.1/scripts/codex-conductor.ts +41 -0
- package/.versions/1.0.1/scripts/codex-remote-control.ts +167 -0
- package/.versions/1.0.1/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/1.0.1/scripts/coms-cli.ts +484 -0
- package/.versions/1.0.1/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/1.0.1/scripts/fleet.ts +185 -0
- package/.versions/1.0.1/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/1.0.1/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/1.0.1/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/1.0.1/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/1.0.1/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/1.0.1/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/1.0.1/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/1.0.1/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/1.0.1/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/1.0.1/scripts/lib/fleet-command.ts +266 -0
- package/.versions/1.0.1/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/1.0.1/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/1.0.1/scripts/lib/monitor-env.ts +146 -0
- package/.versions/1.0.1/scripts/lib/peer-launch.ts +318 -0
- package/.versions/1.0.1/scripts/lib/persona-banner.ts +62 -0
- package/.versions/1.0.1/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/1.0.1/scripts/lib/team-project.ts +213 -0
- package/.versions/1.0.1/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/1.0.1/scripts/peer-banner.ts +40 -0
- package/.versions/1.0.1/scripts/peer-launch.ts +259 -0
- package/.versions/1.0.1/scripts/team-snapshot.ts +237 -0
- package/.versions/1.0.1/scripts/team-up.ts +406 -0
- package/.versions/1.0.1/skills/_internal/grilling.md +11 -0
- package/.versions/1.0.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/1.0.1/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/1.0.1/skills/compound-learning/SKILL.md +137 -0
- package/.versions/1.0.1/skills/context-engineering/SKILL.md +291 -0
- package/.versions/1.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/1.0.1/skills/designing-agents/SKILL.md +394 -0
- package/.versions/1.0.1/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/1.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/1.0.1/skills/idea-refine/SKILL.md +182 -0
- package/.versions/1.0.1/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.1/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.1/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.1/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/1.0.1/skills/interview-me/SKILL.md +226 -0
- package/.versions/1.0.1/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/1.0.1/skills/peer-coms/SKILL.md +90 -0
- package/.versions/1.0.1/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.1/skills/planning-and-task-breakdown/SKILL.md +254 -0
- package/.versions/1.0.1/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/1.0.1/skills/spec-driven-development/SKILL.md +257 -0
- package/.versions/1.0.1/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/1.0.1/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/.versions/1.0.2/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/1.0.2/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/1.0.2/.pi/agents/peers.yaml +142 -0
- package/.versions/1.0.2/.pi/agents/teams.yaml +41 -0
- package/.versions/1.0.2/.pi/damage-control-rules.yaml +297 -0
- package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/1.0.2/.pi/extensions/btw/README.md +120 -0
- package/.versions/1.0.2/.pi/extensions/btw/index.ts +914 -0
- package/.versions/1.0.2/.pi/extensions/btw/package.json +6 -0
- package/.versions/1.0.2/.pi/extensions/btw/state.js +179 -0
- package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/1.0.2/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/1.0.2/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/1.0.2/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/1.0.2/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/1.0.2/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/1.0.2/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/1.0.2/.pi/extensions/package-lock.json +1175 -0
- package/.versions/1.0.2/.pi/extensions/package.json +9 -0
- package/.versions/1.0.2/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/1.0.2/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/1.0.2/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/1.0.2/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/1.0.2/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/1.0.2/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/1.0.2/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/README.md +1156 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/footer.ts +35 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/hub-state-audit.js +73 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/index.ts +9909 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/posture.ts +158 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/run-budget.js +539 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/spawn.ts +366 -0
- package/.versions/1.0.2/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/1.0.2/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/1.0.2/.pi/harnesses/ask-user-remote/index.ts +532 -0
- package/.versions/1.0.2/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/1.0.2/.pi/harnesses/coms/README.md +100 -0
- package/.versions/1.0.2/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/1.0.2/.pi/harnesses/coms/package.json +7 -0
- package/.versions/1.0.2/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/1.0.2/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/1.0.2/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/1.0.2/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/1.0.2/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/1.0.2/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/1.0.2/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
- package/.versions/1.0.2/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
- package/.versions/1.0.2/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/1.0.2/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/1.0.2/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fleet-detail-view.ts +133 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/1.0.2/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/1.0.2/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/1.0.2/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/1.0.2/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/1.0.2/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/1.0.2/.pi/harnesses/package.json +10 -0
- package/.versions/1.0.2/.pi/prompts/af-build.md +24 -0
- package/.versions/1.0.2/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/1.0.2/.pi/prompts/af-plan.md +16 -0
- package/.versions/1.0.2/.pi/prompts/af-review.md +16 -0
- package/.versions/1.0.2/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/1.0.2/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/1.0.2/.pi/prompts/af-ship.md +17 -0
- package/.versions/1.0.2/.pi/prompts/af-spec.md +15 -0
- package/.versions/1.0.2/.pi/prompts/af-test.md +19 -0
- package/.versions/1.0.2/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/1.0.2/.version +1 -0
- package/.versions/1.0.2/agents/architect.md +24 -0
- package/.versions/1.0.2/agents/bowser.md +27 -0
- package/.versions/1.0.2/agents/builder.md +54 -0
- package/.versions/1.0.2/agents/code-reviewer.md +208 -0
- package/.versions/1.0.2/agents/deep-researcher.md +32 -0
- package/.versions/1.0.2/agents/documenter.md +18 -0
- package/.versions/1.0.2/agents/orchestrator.md +20 -0
- package/.versions/1.0.2/agents/plan-reviewer.md +83 -0
- package/.versions/1.0.2/agents/planner.md +70 -0
- package/.versions/1.0.2/agents/releaser.md +24 -0
- package/.versions/1.0.2/agents/researcher.md +28 -0
- package/.versions/1.0.2/agents/security-auditor.md +167 -0
- package/.versions/1.0.2/agents/test-engineer.md +153 -0
- package/.versions/1.0.2/agents/web-debugger.md +43 -0
- package/.versions/1.0.2/agents/web-performance-auditor.md +193 -0
- package/.versions/1.0.2/bin/catalog/harness-runtime-closure.json +38 -0
- package/.versions/1.0.2/codex/CONDUCTOR.md +148 -0
- package/.versions/1.0.2/docs/ARCHITECTURE.md +369 -0
- package/.versions/1.0.2/docs/agent-fleet-setup.md +468 -0
- package/.versions/1.0.2/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/1.0.2/docs/codex-remote-conductor.md +170 -0
- package/.versions/1.0.2/docs/coms-hermes-bridge.md +189 -0
- package/.versions/1.0.2/docs/getting-started.md +98 -0
- package/.versions/1.0.2/docs/npm-install.md +292 -0
- package/.versions/1.0.2/docs/pi-extensions.md +439 -0
- package/.versions/1.0.2/docs/pi-setup.md +74 -0
- package/.versions/1.0.2/docs/skill-anatomy.md +150 -0
- package/.versions/1.0.2/hermes/README.md +347 -0
- package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/1.0.2/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/1.0.2/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/1.0.2/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/1.0.2/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/1.0.2/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/1.0.2/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/1.0.2/install-manifest.json +2745 -0
- package/.versions/1.0.2/justfile +272 -0
- package/.versions/1.0.2/manifest-meta.json +882 -0
- package/.versions/1.0.2/references/accessibility-checklist.md +160 -0
- package/.versions/1.0.2/references/definition-of-done.md +67 -0
- package/.versions/1.0.2/references/fleet-coordination-patterns.md +151 -0
- package/.versions/1.0.2/references/observability-checklist.md +91 -0
- package/.versions/1.0.2/references/orchestration-patterns.md +370 -0
- package/.versions/1.0.2/references/performance-checklist.md +153 -0
- package/.versions/1.0.2/references/prompting-patterns.md +380 -0
- package/.versions/1.0.2/references/security-checklist.md +179 -0
- package/.versions/1.0.2/references/testing-patterns.md +236 -0
- package/.versions/1.0.2/scripts/codex-conductor.ts +41 -0
- package/.versions/1.0.2/scripts/codex-remote-control.ts +167 -0
- package/.versions/1.0.2/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/1.0.2/scripts/coms-cli.ts +484 -0
- package/.versions/1.0.2/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/1.0.2/scripts/fleet.ts +185 -0
- package/.versions/1.0.2/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/1.0.2/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/1.0.2/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/1.0.2/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/1.0.2/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/1.0.2/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/1.0.2/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/1.0.2/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/1.0.2/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/1.0.2/scripts/lib/fleet-command.ts +266 -0
- package/.versions/1.0.2/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/1.0.2/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/1.0.2/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/1.0.2/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/1.0.2/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/1.0.2/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/1.0.2/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/1.0.2/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/1.0.2/scripts/lib/monitor-env.ts +146 -0
- package/.versions/1.0.2/scripts/lib/peer-launch.ts +318 -0
- package/.versions/1.0.2/scripts/lib/persona-banner.ts +62 -0
- package/.versions/1.0.2/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/1.0.2/scripts/lib/team-project.ts +213 -0
- package/.versions/1.0.2/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/1.0.2/scripts/peer-banner.ts +40 -0
- package/.versions/1.0.2/scripts/peer-launch.ts +259 -0
- package/.versions/1.0.2/scripts/team-snapshot.ts +237 -0
- package/.versions/1.0.2/scripts/team-up.ts +406 -0
- package/.versions/1.0.2/skills/_internal/grilling.md +11 -0
- package/.versions/1.0.2/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/1.0.2/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/1.0.2/skills/compound-learning/SKILL.md +137 -0
- package/.versions/1.0.2/skills/context-engineering/SKILL.md +291 -0
- package/.versions/1.0.2/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/1.0.2/skills/designing-agents/SKILL.md +394 -0
- package/.versions/1.0.2/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/1.0.2/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.2/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/1.0.2/skills/idea-refine/SKILL.md +182 -0
- package/.versions/1.0.2/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.2/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.2/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.2/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.2/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/1.0.2/skills/interview-me/SKILL.md +226 -0
- package/.versions/1.0.2/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/1.0.2/skills/peer-coms/SKILL.md +90 -0
- package/.versions/1.0.2/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.2/skills/planning-and-task-breakdown/SKILL.md +254 -0
- package/.versions/1.0.2/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/1.0.2/skills/spec-driven-development/SKILL.md +257 -0
- package/.versions/1.0.2/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/1.0.2/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/1.0.2/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +15 -0
- package/README.md +4 -2
- package/agents/code-reviewer.md +1 -1
- package/agents/deep-researcher.md +1 -1
- package/agents/orchestrator.md +4 -56
- package/agents/plan-reviewer.md +1 -1
- package/agents/planner.md +1 -1
- package/agents/security-auditor.md +1 -1
- package/agents/test-engineer.md +1 -1
- package/docs/ARCHITECTURE.md +48 -16
- package/docs/agent-fleet-setup.md +33 -2
- package/docs/pi-extensions.md +29 -2
- package/install-manifest.json +2 -2
- package/package.json +2 -2
|
@@ -0,0 +1,437 @@
|
|
|
1
|
+
# Agent Fleet — Project Files
|
|
2
|
+
|
|
3
|
+
agent-fleet keeps a few small files in a project's `.ai/` directory. They have
|
|
4
|
+
different readers and different lifetimes, so they are kept separate.
|
|
5
|
+
|
|
6
|
+
| File | Read by | When |
|
|
7
|
+
|------|---------|------|
|
|
8
|
+
| `.ai/agent-fleet-overrides.md` | `spec-driven-development`, `planning-and-task-breakdown`, `browser-testing-with-devtools`, `git-workflow-and-versioning`, `compound-learning` (the `rules:`/`docs:` keys of `## agent-hub`), `agent-hub` pi harness | Every run of those skills / every session start of the harness |
|
|
9
|
+
| `.ai/agent-fleet.json` | the deterministic `agent-fleet` lifecycle (`setup`) — human-owned desired state (preset/features); intended to be committed | Every setup plan; created/updated when setup persists desired state or migrates legacy installs |
|
|
10
|
+
| `.ai/agent-fleet-state.json` | the deterministic `agent-fleet` lifecycle (`setup`, `doctor`, `uninstall`) | Every lifecycle plan and apply |
|
|
11
|
+
| `.ai/agent-fleet-setup.md` | humans — rendered from the state file, never parsed back | Rewritten on every setup apply |
|
|
12
|
+
| `.ai/agent-fleet-transaction.json` | the deterministic lifecycle (`setup`, `doctor --fix`) — crash-recovery journal for in-flight file transactions | Written during apply; recovered or discarded by setup/doctor; removed when the transaction commits or is cleaned up |
|
|
13
|
+
| `.ai/stt.json` *(optional)* | `pi-voice-stt` extension | Every pi session start, when the extension is installed |
|
|
14
|
+
|
|
15
|
+
The `.ai/stt.json` file is present only when the optional `pi-voice-stt` voice-dictation
|
|
16
|
+
extension has been configured (by deterministic setup or by hand). Like the overrides file it holds
|
|
17
|
+
**no secrets** — it names the env vars (`apiKeyEnv`, plus the Azure endpoint var) whose values
|
|
18
|
+
live in a gitignored root `.env`. See [pi-voice-stt config](#ai-sttjson) below.
|
|
19
|
+
|
|
20
|
+
Keep them split: the overrides file is loaded into context constantly, so it
|
|
21
|
+
must stay minimal; the install record is read only by the CLI, so it can be
|
|
22
|
+
large.
|
|
23
|
+
|
|
24
|
+
## Unified Fleet runtime configuration
|
|
25
|
+
|
|
26
|
+
A Pi workspace has one public runtime entry point. Bare Fleet loads Fleet Core
|
|
27
|
+
plus Agent Hub in **operator** posture, in the current terminal, with no native
|
|
28
|
+
specialists active:
|
|
29
|
+
|
|
30
|
+
```bash
|
|
31
|
+
just fleet
|
|
32
|
+
just fleet --project af
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Posture, native roster, and peer topology are separate controls:
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
# Direct tools plus an available native roster.
|
|
39
|
+
just fleet --posture operator --agents frontend --project af
|
|
40
|
+
|
|
41
|
+
# A roster implies orchestrator when posture is not explicit.
|
|
42
|
+
just fleet --agents frontend --project af
|
|
43
|
+
|
|
44
|
+
# Herdr Hub-only and Hub-plus-peer topologies.
|
|
45
|
+
just fleet --herdr --project af
|
|
46
|
+
just fleet --agents frontend --peers frontend --project af
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
Startup precedence is deterministic: explicit `--posture` wins; otherwise an
|
|
50
|
+
explicit `--agents` roster implies `orchestrator`; otherwise posture is
|
|
51
|
+
`operator`. An orchestrator startup must name a roster. `--herdr` affects only
|
|
52
|
+
placement, while `--peers <preset>` implies Herdr and starts the selected peer
|
|
53
|
+
preset. Neither topology option selects a native roster.
|
|
54
|
+
|
|
55
|
+
`--project <name>` selects one coms namespace for the Hub and every standing or
|
|
56
|
+
dynamically spawned peer. Dynamic peer tools deliberately expose no project
|
|
57
|
+
override, so an agent cannot cross that boundary. The default project is
|
|
58
|
+
`default`; use an explicit project when multiple fleets share a machine.
|
|
59
|
+
|
|
60
|
+
The configuration files have distinct ownership:
|
|
61
|
+
|
|
62
|
+
| File | Controls |
|
|
63
|
+
| --- | --- |
|
|
64
|
+
| `.pi/agents/teams.yaml` | Named **native rosters** of Pi personas available to `dispatch_agent`. Bare Fleet ignores YAML ordering and starts empty; select one with `--agents`, `/af-agents-team`, or add individuals with `/af-agents-add`. |
|
|
65
|
+
| `.pi/agents/peers.yaml` | Named **standing peer presets** and each peer's runner (`pi` or `claude-code`), persona, model, extensions, and optional declared `env_file`. Select a preset with `--peers`; dynamic `herdr_spawn_peer` uses the same declaration resolver. |
|
|
66
|
+
| `.pi/agents/dispatch-policy.yaml` | Routing used only when `dispatch_agent.backend` is `auto`: native/coms preference, fallback, grace period, and peer reply timeout. |
|
|
67
|
+
| `.ai/agent-fleet-overrides.md` (`## agent-hub`) | Project-specific Hub language, model overrides, rule/doc roots, budgets, mode, watchdog, and related execution policy. It does not choose startup posture or topology. |
|
|
68
|
+
|
|
69
|
+
For deterministic routing, `backend: "native"` always starts the local Pi
|
|
70
|
+
specialist even if a same-name peer is visible. `backend: "coms"` requires a
|
|
71
|
+
visible same-name peer and refuses without native fallback. The default
|
|
72
|
+
`backend: "auto"` follows `dispatch-policy.yaml` and preserves its configured
|
|
73
|
+
fallback behavior.
|
|
74
|
+
|
|
75
|
+
Capability flags and runtime gates fail closed:
|
|
76
|
+
|
|
77
|
+
- `--no-coms` keeps operator direct tools and native dispatch available, but
|
|
78
|
+
peer dispatch, `coms_send`/`coms_await`, and `/af-handoff` refuse actionably.
|
|
79
|
+
- `--herdr` and `--peers` require a running [Herdr](https://herdr.dev) server.
|
|
80
|
+
Without Herdr, bare Fleet still works and dynamic pane tools stay inactive.
|
|
81
|
+
- `--browser` adds the browser extension surface and `--all-extensions` opts
|
|
82
|
+
into the complete approved extension set. Missing optional dependencies do
|
|
83
|
+
not grant tools merely because a flag was supplied.
|
|
84
|
+
- Hub-owned slash commands remain registered in both postures. A missing coms
|
|
85
|
+
runtime, Herdr connection, target peer, or native roster produces a
|
|
86
|
+
capability refusal rather than a missing command.
|
|
87
|
+
|
|
88
|
+
During the migration release, `just fleet hub`, `just fleet team <preset>`,
|
|
89
|
+
`just fleet team <preset> --no-hub`, and `--solo` remain accepted and print a
|
|
90
|
+
canonical replacement. New automation should use `just fleet` with
|
|
91
|
+
`--agents`, `--peers`, `--herdr`, and `--no-coms`; compatibility does not imply
|
|
92
|
+
that the deprecated grammar will remain indefinitely.
|
|
93
|
+
|
|
94
|
+
## The overrides file — `.ai/agent-fleet-overrides.md`
|
|
95
|
+
|
|
96
|
+
Some skills and pi harnesses need facts specific to each project — where specs
|
|
97
|
+
and plans are saved, how to start a dev server, whether the agent may create
|
|
98
|
+
branches, or which user-facing language a dispatcher should use. Each reader
|
|
99
|
+
ships a sensible **default**; a project that needs something different declares
|
|
100
|
+
it here, and the reader picks it up.
|
|
101
|
+
|
|
102
|
+
- **Location:** `.ai/agent-fleet-overrides.md` at the project root.
|
|
103
|
+
- **Format:** Markdown. One `## <section-name>` section per skill or harness reader, with terse
|
|
104
|
+
`key: value` lines. Block values use the `key: |` multi-line form. No prose
|
|
105
|
+
and no install detail — readers parse it by key and load it on every run/session start.
|
|
106
|
+
- **Commit it.** Shared project configuration belongs in version control. Make
|
|
107
|
+
sure no `.gitignore` rule (for example a broad `.env*` pattern) excludes it.
|
|
108
|
+
- **No secrets.** For anything sensitive (test-account credentials), reference
|
|
109
|
+
the **name** of an environment variable; the real value lives in a gitignored
|
|
110
|
+
`.env`.
|
|
111
|
+
- If the file is absent, or a reader has no section in it, that reader uses its
|
|
112
|
+
built-in default.
|
|
113
|
+
- **Validation.** Because an unknown section or key silently falls back to the
|
|
114
|
+
default, typos are invisible at runtime. `agent-fleet doctor` (and the
|
|
115
|
+
runtime's Agent Fleet doctor command) validates the file — unknown sections,
|
|
116
|
+
unknown keys in known sections, invalid values for the mechanically parsed
|
|
117
|
+
`agent-hub` keys, missing `rules:` folders, and unset `## env` vars — as
|
|
118
|
+
**advisory, warn-only findings**; it never edits the file.
|
|
119
|
+
|
|
120
|
+
### `spec-driven-development`
|
|
121
|
+
|
|
122
|
+
| Key | Default | Meaning |
|
|
123
|
+
|-----|---------|---------|
|
|
124
|
+
| `spec-dir` | `docs/prds/{area}` | Directory specs are written to |
|
|
125
|
+
| `naming` | `PRD{n}-{topic}` | File name pattern; `{n}` = next free PRD number, `{topic}` = kebab-case slug |
|
|
126
|
+
|
|
127
|
+
Default output: `docs/prds/{area}/PRD{n}-{topic}.md`.
|
|
128
|
+
|
|
129
|
+
### `planning-and-task-breakdown`
|
|
130
|
+
|
|
131
|
+
| Key | Default | Meaning |
|
|
132
|
+
|-----|---------|---------|
|
|
133
|
+
| `plan-dir` | `docs/plans/{area}` | Directory plans are written to |
|
|
134
|
+
| `naming` | `PLAN-{prd-name}-{phase}` | File name pattern; `{phase}` suffix only when a plan spans multiple files |
|
|
135
|
+
| `todo` | `embedded` | `embedded` keeps the task list inside the plan; `separate` writes a standalone `todo.md` |
|
|
136
|
+
|
|
137
|
+
Default output: `docs/plans/{area}/PLAN-{prd-name}-{phase}.md`, task list embedded.
|
|
138
|
+
|
|
139
|
+
### `browser-testing-with-devtools`
|
|
140
|
+
|
|
141
|
+
This skill has **no default** — the section is required for browser testing,
|
|
142
|
+
because dev-server commands and login flows cannot be guessed.
|
|
143
|
+
|
|
144
|
+
| Key | Meaning |
|
|
145
|
+
|-----|---------|
|
|
146
|
+
| `dev-server` | Command to start the local dev server |
|
|
147
|
+
| `ready-check` | How to confirm the server is up |
|
|
148
|
+
| `base-url` | Root URL for navigation |
|
|
149
|
+
| `auth-flow` | Steps to log in (multi-line `|` block) |
|
|
150
|
+
| `roles` | Test account per privilege level, referenced by env-var name |
|
|
151
|
+
| `notes` | Anything else the agent should know (certs, seed data, ...) |
|
|
152
|
+
|
|
153
|
+
### `git-workflow-and-versioning`
|
|
154
|
+
|
|
155
|
+
| Key | Default | Meaning |
|
|
156
|
+
|-----|---------|---------|
|
|
157
|
+
| `branching` | `never` | `never` = agent works in the current branch and never creates or switches branches; `allow` = agent may create feature branches |
|
|
158
|
+
|
|
159
|
+
### `agent-hub`
|
|
160
|
+
|
|
161
|
+
Read by the `.pi/harnesses/agent-hub/` pi harness on every session start. The canonical
|
|
162
|
+
section name is `## agent-hub`; the harness also accepts the legacy `## agent-team` name
|
|
163
|
+
(from before the standalone `agent-team` harness was retired), so existing project
|
|
164
|
+
override files keep working unchanged. When both sections are present their keys merge,
|
|
165
|
+
with later lines winning.
|
|
166
|
+
|
|
167
|
+
The `rules:` and `docs:` keys are also read outside the harness: the `compound-learning`
|
|
168
|
+
skill (and the `/af-compound` agent-hub command built on it) resolves them as the
|
|
169
|
+
targets an end-of-session compound pass writes lessons to.
|
|
170
|
+
|
|
171
|
+
| Key | Default | Meaning |
|
|
172
|
+
|-----|---------|---------|
|
|
173
|
+
| `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. |
|
|
174
|
+
| `persona-gate` | `off` | When `on`, blocks input at session start until an orchestrator persona is picked. |
|
|
175
|
+
| `model.<persona>` | persona frontmatter `model:` | Replaces the named persona's default model for this project (a full pi model spec). If the override reports a model/provider error or aborted request before producing text or starting a tool (including a local-model memory-limit failure), agent-hub restores the child session and retries once with the original frontmatter model; it does not fallback after work starts, cancellation, timeout, drift stop, or process-spawn failure. |
|
|
176
|
+
| `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). |
|
|
177
|
+
| `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. |
|
|
178
|
+
| `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. Existing roles retain their original frontmatter model as the same one-shot, pre-work-only runtime fallback; model-only overrides retain the declared tool cap. |
|
|
179
|
+
| `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. |
|
|
180
|
+
| `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. |
|
|
181
|
+
| `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. |
|
|
182
|
+
| `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. |
|
|
183
|
+
| `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. |
|
|
184
|
+
| `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`. |
|
|
185
|
+
| `max-dispatches-per-turn` | mode default (2/8/24) | `dispatch_agent` calls allowed per user turn. Positive integer or `off` (unlimited). |
|
|
186
|
+
| `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`. |
|
|
187
|
+
| `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`. |
|
|
188
|
+
| `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`. |
|
|
189
|
+
| `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). |
|
|
190
|
+
| `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. |
|
|
191
|
+
| `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. |
|
|
192
|
+
|
|
193
|
+
Example — switch the dispatcher to Bulgarian, pin the builder to sonnet, raise the
|
|
194
|
+
code-reviewer's thinking level, move the code-reviewer's docs sub-reviewer to a
|
|
195
|
+
different model, and point the team at the project's rule folders and doc entry
|
|
196
|
+
points:
|
|
197
|
+
|
|
198
|
+
```markdown
|
|
199
|
+
## agent-hub
|
|
200
|
+
language: Bulgarian
|
|
201
|
+
model.builder: github-copilot/claude-sonnet-4.6
|
|
202
|
+
models.builder: github-copilot/claude-sonnet-4.6, github-copilot/claude-haiku-4.5
|
|
203
|
+
thinking.code-reviewer: xhigh
|
|
204
|
+
subagents.code-reviewer.docs: github-copilot/claude-sonnet-4.6, tools=read,grep
|
|
205
|
+
delegate-depth.code-reviewer: 1
|
|
206
|
+
recon-search-timeout-s: 120 # or off to disable the per-tool watchdog
|
|
207
|
+
rules: docs/rules, .ai/rules
|
|
208
|
+
docs: Docs/AGENTS.md, Docs/architecture/ARCHITECTURE_OVERVIEW.md
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
### `env` (optional, read by the doctor)
|
|
212
|
+
|
|
213
|
+
The overrides file references environment variables by **name** — test-account
|
|
214
|
+
credentials for `browser-testing-with-devtools`, the `pi-voice-stt` API key —
|
|
215
|
+
while the values live in a gitignored root `.env`. The optional `## env`
|
|
216
|
+
section declares which names the project's readers expect, so a fresh clone
|
|
217
|
+
can find out what's missing *before* a skill fails mid-run:
|
|
218
|
+
|
|
219
|
+
| Key | Meaning |
|
|
220
|
+
|-----|---------|
|
|
221
|
+
| `required` | Comma-separated env-var **names** (never values) the project's sections reference |
|
|
222
|
+
|
|
223
|
+
```markdown
|
|
224
|
+
## env
|
|
225
|
+
required: APP_TEST_ADMIN_USER, APP_TEST_ADMIN_PASS, AZURE_SPEECH_KEY
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
No skill or harness loads this section. Its only reader is `agent-fleet doctor`
|
|
229
|
+
(and the runtime's Agent Fleet doctor command), which warns when a declared name is neither set in
|
|
230
|
+
the environment nor declared in the workspace root `.env`.
|
|
231
|
+
|
|
232
|
+
### Per-peer env files (`env_file:` in peers.yaml)
|
|
233
|
+
|
|
234
|
+
Fleet peers spawned through `--peers`, `just fleet peer`, or the Hub's
|
|
235
|
+
constrained dynamic peer tool can carry their own environment: an `env_file:`
|
|
236
|
+
entry in `.pi/agents/peers.yaml` names a
|
|
237
|
+
**repo-relative** KEY=VALUE file (same format as `.env`, no shell evaluation)
|
|
238
|
+
that herdr injects into the peer's pane before the command runs — no `source`,
|
|
239
|
+
no leaking into sibling panes. The file must exist at spawn (team-up refuses
|
|
240
|
+
otherwise, never mid-run), and its **values never appear in `--dry-run`
|
|
241
|
+
output** — only the path. Keep these files gitignored exactly like the root
|
|
242
|
+
`.env` this section describes.
|
|
243
|
+
|
|
244
|
+
## The install record — `.ai/agent-fleet-state.json` and `.ai/agent-fleet-setup.md`
|
|
245
|
+
|
|
246
|
+
Two files, one source of truth. `.ai/agent-fleet-state.json` is what the
|
|
247
|
+
installer writes and the only thing it reads back: agent, method, package
|
|
248
|
+
version, source root, and one entry per installed item with a per-file sha256
|
|
249
|
+
(or, in symlink mode, the resolved link target). `.ai/agent-fleet-setup.md` is
|
|
250
|
+
**rendered from it** on every apply and never parsed back, so the two cannot
|
|
251
|
+
disagree — it exists for humans and for older readers that still look for
|
|
252
|
+
`version:` and `agent:`.
|
|
253
|
+
|
|
254
|
+
Ownership is the point of the state file. An entry means "agent-fleet installed
|
|
255
|
+
this"; anything not listed is never removed or overwritten. That lookup is what
|
|
256
|
+
replaced the prose ownership rule the setup skill used to carry.
|
|
257
|
+
|
|
258
|
+
| State-file field | Meaning |
|
|
259
|
+
|---|---|
|
|
260
|
+
| `agent`, `method`, `sourceRoot` | How and from where this workspace was installed |
|
|
261
|
+
| `packageVersion` | The version that performed the last apply — provenance for reconciliation and legacy three-way compatibility |
|
|
262
|
+
| `items` | One entry per installed artifact: strategy, method, files with hashes, JSON key paths |
|
|
263
|
+
| `externalPackages` | Packages the user was told to install; recorded, never installed for them |
|
|
264
|
+
| `events` | Last few applies (verb, version, action count, conflicts) |
|
|
265
|
+
|
|
266
|
+
**No secrets, ever.** Only env-var *names* may appear — for example in the
|
|
267
|
+
`pi-voice-stt` record. A test asserts nothing value-shaped is persisted.
|
|
268
|
+
|
|
269
|
+
### The recorded version and the three-way merge
|
|
270
|
+
|
|
271
|
+
The recorded `packageVersion` gives every comparison a baseline. For each
|
|
272
|
+
recorded artifact, the engine compares *source@recorded* from the package's
|
|
273
|
+
`.versions/<x.y.z>/` snapshot tree, the installed copy on disk, and
|
|
274
|
+
*source@current*. Deterministic `setup` is the public reconciliation command.
|
|
275
|
+
|
|
276
|
+
| Outcome | What `setup` does |
|
|
277
|
+
|---|---|
|
|
278
|
+
| Neither moved | Kept |
|
|
279
|
+
| Only the source moved | Clean refresh |
|
|
280
|
+
| Only your copy moved | **Refreshed — your edit is overwritten.** Reported in the plan as *"locally modified — selecting it overwrites your edits"*, so `--dry-run` shows it before it happens |
|
|
281
|
+
| Both moved, to different content | **Conflict**: the run exits `3` before writing anything. Resolve with `--on-conflict theirs` or `--on-conflict ours` |
|
|
282
|
+
| Retired upstream | Kept by `setup`; the deprecated `upgrade` proposes removal by name, subject to the ownership rule |
|
|
283
|
+
|
|
284
|
+
Reconciling toward the package is the point of `setup`: the workspace is meant
|
|
285
|
+
to match the version it records. That is why editing a shipped artifact in place
|
|
286
|
+
is not a supported customization route — use `.ai/agent-fleet-overrides.md`, add
|
|
287
|
+
artifacts under names Agent Fleet does not ship, or leave the item out of the
|
|
288
|
+
selection (`setup` never removes what it does not select, so an unselected item
|
|
289
|
+
stays installed and frozen). The deprecated `upgrade` verb preserves local edits
|
|
290
|
+
instead of overwriting them; if you have relied on that, it is the behavioural
|
|
291
|
+
difference to plan for.
|
|
292
|
+
|
|
293
|
+
If the snapshot is missing (an unpublished local build, or a version older than
|
|
294
|
+
`.versions/` retention), the comparison degrades to two-way, the installed copy
|
|
295
|
+
is treated as canonical, and the read-only auxiliary `verify` command reports it
|
|
296
|
+
as an advisory finding rather than pretending a diff exists.
|
|
297
|
+
|
|
298
|
+
### Pre-engine workspaces
|
|
299
|
+
|
|
300
|
+
A workspace with only `.ai/agent-fleet-setup.md` and no state file predates the
|
|
301
|
+
installer engine. `setup --migrate --dry-run` previews what it can infer from
|
|
302
|
+
that markdown (`agent:`, `version:`) without adopting unrecorded paths. To
|
|
303
|
+
mutate a legacy workspace, use `setup --migrate` with an explicit preset,
|
|
304
|
+
features, and `--yes`. A workspace with no `version:` at all has no recorded
|
|
305
|
+
baseline, so no three-way merge is attempted.
|
|
306
|
+
|
|
307
|
+
Commit these files if the team should share install state — keep paths relative
|
|
308
|
+
so they stay portable. A self-referencing checkout (agent-fleet itself) may
|
|
309
|
+
instead `.gitignore` them, since their recorded paths are local to one machine.
|
|
310
|
+
|
|
311
|
+
## Coms-backed team members
|
|
312
|
+
|
|
313
|
+
A team member the `agent-hub` harness dispatches (`.pi/agents/teams.yaml`) can be
|
|
314
|
+
served by a live coms peer of the same name instead of a freshly spawned native
|
|
315
|
+
subagent. With the default `backend: "auto"`,
|
|
316
|
+
`.pi/agents/dispatch-policy.yaml` decides that per member at dispatch time;
|
|
317
|
+
explicit `native` bypasses substitution, while explicit `coms` requires the
|
|
318
|
+
peer and never falls back. `.pi/agents/peers.yaml` decides *how* each peer runs.
|
|
319
|
+
A peer with `runner: claude-code` is an interactive Claude Code pane plus its
|
|
320
|
+
bridge — the one way Claude Code takes part in a fleet. See
|
|
321
|
+
[claude-code-coms-bridge.md](claude-code-coms-bridge.md).
|
|
322
|
+
|
|
323
|
+
Installing `skill:peer-coms` pulls `hook:coms-stop-hook` in as a companion, which
|
|
324
|
+
is what gives a bridged pane exact turn text instead of scraped output.
|
|
325
|
+
Registering that hook in `.claude/settings.json` stays the user's step — the
|
|
326
|
+
installer writes files, and another tool's settings file is not its to merge.
|
|
327
|
+
|
|
328
|
+
## Templates
|
|
329
|
+
|
|
330
|
+
### `.ai/agent-fleet-overrides.md`
|
|
331
|
+
|
|
332
|
+
Copy this in and delete the sections you don't need — anything absent falls
|
|
333
|
+
back to that reader's default.
|
|
334
|
+
|
|
335
|
+
```markdown
|
|
336
|
+
# Agent Fleet — Project Overrides
|
|
337
|
+
#
|
|
338
|
+
# Each section is applied ON TOP of the skill's built-in defaults.
|
|
339
|
+
# Keys not listed keep the default. Absent file/section → pure defaults.
|
|
340
|
+
|
|
341
|
+
## spec-driven-development
|
|
342
|
+
spec-dir: docs/prds/{area}
|
|
343
|
+
naming: PRD{n}-{topic}
|
|
344
|
+
|
|
345
|
+
## planning-and-task-breakdown
|
|
346
|
+
plan-dir: docs/plans/{area}
|
|
347
|
+
naming: PLAN-{prd-name}-{phase}
|
|
348
|
+
todo: embedded
|
|
349
|
+
|
|
350
|
+
## browser-testing-with-devtools
|
|
351
|
+
dev-server: <command to start the local dev server>
|
|
352
|
+
ready-check: <url or check that confirms the server is up>
|
|
353
|
+
base-url: <root url>
|
|
354
|
+
auth-flow: |
|
|
355
|
+
1. Navigate to <login url>
|
|
356
|
+
2. Submit credentials for the role needed by the screen under test
|
|
357
|
+
roles:
|
|
358
|
+
admin: env APP_TEST_ADMIN_USER / APP_TEST_ADMIN_PASS
|
|
359
|
+
player: env APP_TEST_PLAYER_USER / APP_TEST_PLAYER_PASS
|
|
360
|
+
notes: |
|
|
361
|
+
<anything else: self-signed certs, required seed data, ...>
|
|
362
|
+
|
|
363
|
+
## git-workflow-and-versioning
|
|
364
|
+
branching: never
|
|
365
|
+
|
|
366
|
+
# Optional for pi agent-hub; omit this section to keep default English.
|
|
367
|
+
# (`## agent-team` is still accepted as a legacy alias for this section.)
|
|
368
|
+
## agent-hub
|
|
369
|
+
language: <language name>
|
|
370
|
+
rules: <repo-relative rule folder>[, <another folder>]
|
|
371
|
+
docs: <repo-relative doc entry point>[, <another file or folder>]
|
|
372
|
+
|
|
373
|
+
# Optional; names (never values) of env vars the sections above reference.
|
|
374
|
+
# Only `agent-fleet doctor` reads this — it warns when one is unset.
|
|
375
|
+
## env
|
|
376
|
+
required: <ENV_VAR_NAME>[, <ANOTHER_NAME>]
|
|
377
|
+
```
|
|
378
|
+
|
|
379
|
+
### `.ai/agent-fleet-setup.md`
|
|
380
|
+
|
|
381
|
+
Rendered from `.ai/agent-fleet-state.json` by every apply, for humans to read.
|
|
382
|
+
Edit the workspace, not this file — the next apply overwrites it.
|
|
383
|
+
|
|
384
|
+
```markdown
|
|
385
|
+
# Agent Fleet — Workspace Setup
|
|
386
|
+
#
|
|
387
|
+
# Generated from .ai/agent-fleet-state.json by `agent-fleet setup`.
|
|
388
|
+
# Edit the workspace, not this file: it is rewritten on every apply.
|
|
389
|
+
|
|
390
|
+
## workspace-summary
|
|
391
|
+
agent: pi
|
|
392
|
+
method: copy
|
|
393
|
+
version: 1.4.2
|
|
394
|
+
source: /home/you/.npm/_npx/<hash>/node_modules/@chankov/agent-fleet
|
|
395
|
+
|
|
396
|
+
## install-status
|
|
397
|
+
skills: [spec-driven-development, test-driven-development, code-review-and-quality]
|
|
398
|
+
commands: [spec, plan, build]
|
|
399
|
+
personas: [code-reviewer]
|
|
400
|
+
extensions: []
|
|
401
|
+
harnesses: []
|
|
402
|
+
companions: [skills-internal-grilling]
|
|
403
|
+
external: []
|
|
404
|
+
updated: 2026-05-22
|
|
405
|
+
|
|
406
|
+
## verification
|
|
407
|
+
- 21 item(s) recorded; run `agent-fleet doctor` for diagnostics.
|
|
408
|
+
- No secrets are stored in this file or in .ai/agent-fleet-state.json.
|
|
409
|
+
```
|
|
410
|
+
|
|
411
|
+
### `.ai/stt.json`
|
|
412
|
+
|
|
413
|
+
Optional. Present only when the `pi-voice-stt` extension is installed and configured. Read by
|
|
414
|
+
the extension on every pi session start, ahead of the global `~/.pi/agent/stt.json`. Holds the
|
|
415
|
+
non-secret provider config; the API key (and Azure endpoint) live in a gitignored root `.env`
|
|
416
|
+
as named env vars, which the `justfile`'s `dotenv-load` exposes to the session.
|
|
417
|
+
|
|
418
|
+
```json
|
|
419
|
+
{
|
|
420
|
+
"language": "bg-BG",
|
|
421
|
+
"provider": {
|
|
422
|
+
"type": "azure",
|
|
423
|
+
"apiKeyEnv": "AZURE_SPEECH_KEY",
|
|
424
|
+
"locales": ["bg-BG", "en-US"]
|
|
425
|
+
}
|
|
426
|
+
}
|
|
427
|
+
```
|
|
428
|
+
|
|
429
|
+
Corresponding gitignored `.env` at the repo root:
|
|
430
|
+
|
|
431
|
+
```sh
|
|
432
|
+
AZURE_SPEECH_ENDPOINT=https://<resource>.cognitiveservices.azure.com
|
|
433
|
+
AZURE_SPEECH_KEY=<your-resource-key>
|
|
434
|
+
```
|
|
435
|
+
|
|
436
|
+
For the OpenAI-compatible backend, `provider.type` is `openai` with `baseUrl` / `model` and an
|
|
437
|
+
`OPENAI_API_KEY` env var instead. Full schema: [.pi/extensions/pi-voice-stt/README.md](../.pi/extensions/pi-voice-stt/README.md).
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
# Claude Code as a coms peer — the bridge
|
|
2
|
+
|
|
3
|
+
Makes an interactive Claude Code (terminal CLI) a **first-class, bidirectional peer** in
|
|
4
|
+
the local coms pool: pi agents reach it with plain `coms_send`/`coms_await`, and Claude
|
|
5
|
+
Code itself asks pi peers questions mid-task via `coms-cli`. Requires a running
|
|
6
|
+
[herdr](https://herdr.dev) server (the bridge drives the Claude pane through herdr's
|
|
7
|
+
socket API).
|
|
8
|
+
|
|
9
|
+
> **This is the only role Claude Code has in Agent Fleet.** It is not a coding-agent
|
|
10
|
+
> install target: deterministic `agent-fleet setup` targets pi and nothing else, there are no
|
|
11
|
+
> `.claude/` skills, commands, or personas, and no Claude Code plugin. What a bridged
|
|
12
|
+
> pane gets is what this page describes — the `peer-coms` skill and the Stop hook,
|
|
13
|
+
> both installed under the pi agent because the *fleet* is what needs them. A Claude
|
|
14
|
+
> Code peer contributes review, research, and analysis turns over coms; it does not run
|
|
15
|
+
> the lifecycle commands or orchestrate anything.
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
pi hub ── coms envelope ──▶ coms-claude-bridge ── pane.send_text ──▶ Claude Code (pane)
|
|
19
|
+
pi hub ◀── response ─────── coms-claude-bridge ◀── Stop hook file ─── (turn ends)
|
|
20
|
+
Claude Code ── Bash: coms-cli send/await ──▶ any pi peer (outbound asks)
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## Pieces
|
|
24
|
+
|
|
25
|
+
| Piece | File | Role |
|
|
26
|
+
|---|---|---|
|
|
27
|
+
| Bridge daemon | `scripts/coms-claude-bridge.ts` | One per Claude pane. Registers coms peer `<name>`, serializes inbound prompts, types them into the pane (+ Enter separately — TUI quirk), captures the reply, sends the response envelope. |
|
|
28
|
+
| 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`. |
|
|
29
|
+
| 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. |
|
|
30
|
+
| 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. |
|
|
31
|
+
| 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`. |
|
|
32
|
+
|
|
33
|
+
## Setup
|
|
34
|
+
|
|
35
|
+
The stable `claude-bridge` setup feature selects `peer-coms` and its
|
|
36
|
+
`coms-stop-hook` companion. Use `agent-fleet setup --preset default --features
|
|
37
|
+
claude-bridge --yes` (or select it interactively); it puts both halves in place:
|
|
38
|
+
`.pi/skills/peer-coms/` and `.claude/hooks/coms-stop-hook.mjs`. The hook file lands under
|
|
39
|
+
`.claude/` deliberately — that is where the Claude Code process in the pane looks for it.
|
|
40
|
+
|
|
41
|
+
**Registering the hook stays a manual step.** The installer writes the file; it does not
|
|
42
|
+
touch `.claude/settings.json`, because that file is the user's own Claude Code
|
|
43
|
+
configuration and merging into it is not something a pi install should decide.
|
|
44
|
+
|
|
45
|
+
1. **Hook (recommended):** add to the project's (or user's) Claude Code `settings.json`:
|
|
46
|
+
|
|
47
|
+
```json
|
|
48
|
+
{
|
|
49
|
+
"hooks": {
|
|
50
|
+
"Stop": [{ "hooks": [{ "type": "command",
|
|
51
|
+
"command": "node /path/to/agent-fleet/hooks/coms-stop-hook.mjs" }] }]
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
Without the hook the bridge falls back to asking Claude for a
|
|
57
|
+
`<<COMS_DONE:msg_id>>` sentinel and scraping the pane — it works, but replies can
|
|
58
|
+
carry TUI noise (tool-status lines). The hook returns exact text.
|
|
59
|
+
|
|
60
|
+
2. **Skill:** install `peer-coms` so the bridged session knows it is a peer and how to
|
|
61
|
+
use `coms-cli`. Point Claude Code at it the way you normally load project skills —
|
|
62
|
+
a `CLAUDE.md` reference to `.pi/skills/peer-coms/SKILL.md` is enough.
|
|
63
|
+
|
|
64
|
+
3. **Spawn:** either add a `runner: claude-code` peer to a peers.yaml team and
|
|
65
|
+
`just fleet team <team> --no-hub`, or attach a bridge to an existing Herdr Claude pane:
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
node --experimental-strip-types scripts/coms-claude-bridge.ts --name claude-main
|
|
69
|
+
# (inside the pane: HERDR_PANE_ID is inherited; or pass --pane <id>)
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
## Demo scenario (verified live)
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
just fleet team docs --no-hub # Pi peers up
|
|
76
|
+
# pane with: bridge (claude-main) + claude
|
|
77
|
+
just fleet hub # in another pane: the orchestrator
|
|
78
|
+
# from the hub (or any shell):
|
|
79
|
+
node --experimental-strip-types scripts/coms-cli.ts send claude-main \
|
|
80
|
+
"Summarize the failing test output in artifacts/test.log" --await --timeout 300000
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
And the reverse — Claude Code, mid-task, asking a pi peer:
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
node --experimental-strip-types scripts/coms-cli.ts send researcher \
|
|
87
|
+
"Where is the retry logic for webhooks? file:line" --await --timeout 300000
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
## Serving team dispatches (coms-backed dispatch)
|
|
91
|
+
|
|
92
|
+
A bridge peer that shares a name with an agent-hub team member (e.g. `code-reviewer`,
|
|
93
|
+
`plan-reviewer` in the shipped `peers.yaml`) can serve that member's `dispatch_agent`
|
|
94
|
+
calls transparently: `.pi/agents/dispatch-policy.yaml` marks the member `prefer: coms`,
|
|
95
|
+
and the hub routes the dispatch to the live peer instead of spawning a native subagent —
|
|
96
|
+
same return contract, ASK_USER handling, and history. The standing Claude session keeps
|
|
97
|
+
its context across review rounds, which is the point for code/plan review. See
|
|
98
|
+
"Coms-backed dispatch" in `.pi/harnesses/agent-hub/README.md`.
|
|
99
|
+
|
|
100
|
+
## Migrating legacy CLI spools
|
|
101
|
+
|
|
102
|
+
Current releases isolate CLI queues by project at:
|
|
103
|
+
|
|
104
|
+
```text
|
|
105
|
+
~/.pi/coms/cli/projects/<project>/<name>/
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
Older releases used the ambiguous name-only path `~/.pi/coms/cli/<name>/`. If that legacy directory exists, `send`, `await`, `reply`, and listener operations fail closed rather than assigning queued messages to whichever project runs first. Before upgrading, stop commands using that CLI identity, inspect its `pending`, `responses`, and `inbound` files, determine the owning project, and move the complete `<name>` directory to `cli/projects/<project>/<name>`. Do not merge two queues or delete pending data merely to clear the error. The name `projects` is reserved for the namespace and cannot be used as a coms identity.
|
|
109
|
+
|
|
110
|
+
## Behavior notes
|
|
111
|
+
|
|
112
|
+
- **Serialization:** one prompt at a time per pane; queue depth shows in the peer's
|
|
113
|
+
agent card and the herdr sidebar (`q<depth>`).
|
|
114
|
+
- **Presence:** the bridge annotates its pane through the shared `HerdrPresence`
|
|
115
|
+
(same dialect negotiation as pi peers — `tokens` on herdr >= 0.7.4, one latched
|
|
116
|
+
fallback to `custom_status`), so the pane carries `coms`/`proj` and the fleet panel
|
|
117
|
+
can join it to the registry entry. It writes the annotation ONLY, never
|
|
118
|
+
`pane.report_agent`: the pane's `agent_status` is herdr's own Claude detection and
|
|
119
|
+
the bridge polls it back as its turn-completion signal.
|
|
120
|
+
- **Blocked panes:** a Claude waiting on a permission prompt returns a readable error
|
|
121
|
+
envelope ("blocked on a permission prompt — a human must approve it") instead of
|
|
122
|
+
hanging until timeout.
|
|
123
|
+
- **Busy panes:** a prompt arriving while Claude is mid-turn errors immediately
|
|
124
|
+
("mid-turn — try again shortly") rather than typing into a running turn.
|
|
125
|
+
- **Restarts:** the bridge is bound to the pane id, not the Claude process — restart
|
|
126
|
+
Claude in the pane and the bridge keeps working.
|
|
127
|
+
- **Fleet safety:** the bridge and skill never create or close panes; herdr driving
|
|
128
|
+
stays with the orchestrator (see `.pi/damage-control-rules.yaml`).
|