@chankov/agent-fleet 0.0.5 → 0.0.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.pi/extensions/agent-fleet-update-check/README.md +4 -4
- package/.pi/extensions/btw/README.md +10 -10
- package/.pi/extensions/btw/index.ts +11 -11
- package/.pi/extensions/chrome-devtools-mcp/README.md +2 -2
- package/.pi/extensions/chrome-devtools-mcp/index.ts +1 -0
- package/.pi/extensions/compact-and-continue/README.md +2 -2
- package/.pi/extensions/pi-voice-stt/README.md +7 -7
- package/.pi/extensions/pi-voice-stt/index.ts +4 -4
- package/.pi/harnesses/agent-hub/README.md +133 -74
- package/.pi/harnesses/agent-hub/artifacts.js +56 -2
- package/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.pi/harnesses/agent-hub/backend-policy.js +1 -1
- package/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.pi/harnesses/agent-hub/delegate.ts +61 -12
- package/.pi/harnesses/agent-hub/drift-watchdog.js +55 -9
- package/.pi/harnesses/agent-hub/helpers.ts +34 -0
- package/.pi/harnesses/agent-hub/index.ts +970 -406
- package/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +2 -2
- package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -11
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.pi/harnesses/agent-hub/return-contract.js +78 -0
- package/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.pi/harnesses/agent-hub/run-budget.js +30 -4
- package/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.pi/harnesses/agent-hub/spawn.ts +109 -1
- package/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
- package/.pi/harnesses/coms/README.md +6 -5
- package/.pi/harnesses/coms/index.ts +92 -70
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/README.md +9 -9
- package/.pi/harnesses/damage-control-continue/index.ts +11 -11
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.pi/harnesses/lib/herdr-client.ts +7 -2
- package/.pi/harnesses/lib/herdr-presence.ts +141 -30
- package/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.pi/harnesses/lib/hermes-monitor-registry.ts +1 -1
- package/.pi/harnesses/lib/hermes-monitor-socket.ts +47 -2
- package/.pi/prompts/{doctor-agent-fleet.md → af-doctor-agent-fleet.md} +1 -1
- package/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.pi/prompts/{setup-agent-fleet.md → af-setup-agent-fleet.md} +1 -1
- package/.versions/0.0.6/.claude/commands/build.md +44 -0
- package/.versions/0.0.6/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.6/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.6/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.6/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.6/.claude/commands/plan.md +16 -0
- package/.versions/0.0.6/.claude/commands/prime.md +22 -0
- package/.versions/0.0.6/.claude/commands/review.md +16 -0
- package/.versions/0.0.6/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.6/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.6/.claude/commands/ship.md +72 -0
- package/.versions/0.0.6/.claude/commands/spec.md +15 -0
- package/.versions/0.0.6/.claude/commands/test.md +19 -0
- package/.versions/0.0.6/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.6/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.6/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.6/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.6/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.6/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.6/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.6/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.6/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.6/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.6/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.6/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.6/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.6/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.6/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.6/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.6/.pi/extensions/package.json +9 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/README.md +798 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/delegate.ts +386 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/helpers.ts +214 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/index.ts +8045 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/run-budget.js +155 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/spawn.ts +246 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.6/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.6/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.6/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.6/.pi/harnesses/coms/README.md +92 -0
- package/.versions/0.0.6/.pi/harnesses/coms/index.ts +1745 -0
- package/.versions/0.0.6/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.6/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.6/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.versions/0.0.6/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.6/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.6/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.6/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.6/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.6/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.6/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.6/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.6/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.6/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.6/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.6/.version +1 -0
- package/.versions/0.0.6/agents/architect.md +23 -0
- package/.versions/0.0.6/agents/bowser.md +26 -0
- package/.versions/0.0.6/agents/builder.md +53 -0
- package/.versions/0.0.6/agents/code-reviewer.md +205 -0
- package/.versions/0.0.6/agents/deep-researcher.md +31 -0
- package/.versions/0.0.6/agents/documenter.md +18 -0
- package/.versions/0.0.6/agents/orchestrator.md +54 -0
- package/.versions/0.0.6/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.6/agents/planner.md +69 -0
- package/.versions/0.0.6/agents/releaser.md +24 -0
- package/.versions/0.0.6/agents/researcher.md +28 -0
- package/.versions/0.0.6/agents/security-auditor.md +166 -0
- package/.versions/0.0.6/agents/test-engineer.md +151 -0
- package/.versions/0.0.6/agents/web-debugger.md +42 -0
- package/.versions/0.0.6/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.6/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.6/docs/ARCHITECTURE.md +210 -0
- package/.versions/0.0.6/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.6/docs/claude-code-coms-bridge.md +103 -0
- package/.versions/0.0.6/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.6/docs/coms-hermes-bridge.md +179 -0
- package/.versions/0.0.6/docs/getting-started.md +183 -0
- package/.versions/0.0.6/docs/npm-install.md +337 -0
- package/.versions/0.0.6/docs/opencode-setup.md +249 -0
- package/.versions/0.0.6/docs/pi-extensions.md +293 -0
- package/.versions/0.0.6/docs/pi-setup.md +476 -0
- package/.versions/0.0.6/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.6/hermes/README.md +231 -0
- package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.6/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.6/hooks/coms-stop-hook.mjs +73 -0
- package/.versions/0.0.6/hooks/hooks.json +14 -0
- package/.versions/0.0.6/hooks/session-start.sh +74 -0
- package/.versions/0.0.6/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.6/justfile +245 -0
- package/.versions/0.0.6/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.6/references/definition-of-done.md +67 -0
- package/.versions/0.0.6/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.6/references/observability-checklist.md +91 -0
- package/.versions/0.0.6/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.6/references/performance-checklist.md +153 -0
- package/.versions/0.0.6/references/prompting-patterns.md +380 -0
- package/.versions/0.0.6/references/security-checklist.md +179 -0
- package/.versions/0.0.6/references/testing-patterns.md +236 -0
- package/.versions/0.0.6/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.6/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.6/scripts/coms-claude-bridge.ts +286 -0
- package/.versions/0.0.6/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.6/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.6/scripts/fleet.ts +141 -0
- package/.versions/0.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.6/scripts/hermes-monitor-scenario.ts +7 -0
- package/.versions/0.0.6/scripts/lib/claude-bridge-core.ts +100 -0
- package/.versions/0.0.6/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.6/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.6/scripts/lib/coms-envelope.ts +539 -0
- package/.versions/0.0.6/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.6/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.6/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.6/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.6/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.6/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.6/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.6/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.6/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.6/scripts/team-up.ts +351 -0
- package/.versions/0.0.6/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.6/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.6/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.6/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.6/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.6/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +544 -0
- package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +35 -0
- package/.versions/0.0.6/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.6/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.6/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.6/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.6/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.6/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.6/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.6/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.6/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.6/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.6/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.6/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.6/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.6/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/.versions/0.0.7/.claude/commands/build.md +44 -0
- package/.versions/0.0.7/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.7/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.7/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.7/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.7/.claude/commands/plan.md +16 -0
- package/.versions/0.0.7/.claude/commands/prime.md +22 -0
- package/.versions/0.0.7/.claude/commands/review.md +16 -0
- package/.versions/0.0.7/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.7/.claude/commands/ship.md +72 -0
- package/.versions/0.0.7/.claude/commands/spec.md +15 -0
- package/.versions/0.0.7/.claude/commands/test.md +19 -0
- package/.versions/0.0.7/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.7/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.7/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.7/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.7/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.7/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.7/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.7/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.7/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.7/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.7/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.7/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.7/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.7/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.7/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.7/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.7/.pi/extensions/package.json +9 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/README.md +857 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/helpers.ts +248 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/index.ts +8609 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/run-budget.js +181 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.7/.pi/harnesses/coms/README.md +93 -0
- package/.versions/0.0.7/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/0.0.7/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/0.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.7/.pi/harnesses/lib/herdr-client.ts +463 -0
- package/.versions/0.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.7/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.7/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.7/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.7/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.7/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.7/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.7/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.7/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.7/.version +1 -0
- package/.versions/0.0.7/agents/architect.md +23 -0
- package/.versions/0.0.7/agents/bowser.md +26 -0
- package/.versions/0.0.7/agents/builder.md +53 -0
- package/.versions/0.0.7/agents/code-reviewer.md +205 -0
- package/.versions/0.0.7/agents/deep-researcher.md +31 -0
- package/.versions/0.0.7/agents/documenter.md +18 -0
- package/.versions/0.0.7/agents/orchestrator.md +65 -0
- package/.versions/0.0.7/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.7/agents/planner.md +69 -0
- package/.versions/0.0.7/agents/releaser.md +24 -0
- package/.versions/0.0.7/agents/researcher.md +28 -0
- package/.versions/0.0.7/agents/security-auditor.md +166 -0
- package/.versions/0.0.7/agents/test-engineer.md +151 -0
- package/.versions/0.0.7/agents/web-debugger.md +42 -0
- package/.versions/0.0.7/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.7/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.7/docs/ARCHITECTURE.md +262 -0
- package/.versions/0.0.7/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.7/docs/claude-code-coms-bridge.md +109 -0
- package/.versions/0.0.7/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.7/docs/coms-hermes-bridge.md +189 -0
- package/.versions/0.0.7/docs/getting-started.md +231 -0
- package/.versions/0.0.7/docs/npm-install.md +337 -0
- package/.versions/0.0.7/docs/opencode-setup.md +249 -0
- package/.versions/0.0.7/docs/pi-extensions.md +293 -0
- package/.versions/0.0.7/docs/pi-setup.md +476 -0
- package/.versions/0.0.7/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.7/hermes/README.md +347 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.7/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/0.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.7/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/0.0.7/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/0.0.7/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.7/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/0.0.7/hooks/hooks.json +14 -0
- package/.versions/0.0.7/hooks/session-start.sh +74 -0
- package/.versions/0.0.7/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.7/justfile +245 -0
- package/.versions/0.0.7/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.7/references/definition-of-done.md +67 -0
- package/.versions/0.0.7/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.7/references/observability-checklist.md +91 -0
- package/.versions/0.0.7/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.7/references/performance-checklist.md +153 -0
- package/.versions/0.0.7/references/prompting-patterns.md +380 -0
- package/.versions/0.0.7/references/security-checklist.md +179 -0
- package/.versions/0.0.7/references/testing-patterns.md +236 -0
- package/.versions/0.0.7/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.7/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.7/scripts/coms-claude-bridge.ts +401 -0
- package/.versions/0.0.7/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.7/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.7/scripts/fleet.ts +149 -0
- package/.versions/0.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.7/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/0.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/0.0.7/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/0.0.7/scripts/lib/claude-bridge-core.ts +165 -0
- package/.versions/0.0.7/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.7/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.7/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/0.0.7/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.7/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.7/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.7/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.7/scripts/lib/monitor-env.ts +120 -0
- package/.versions/0.0.7/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.7/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.7/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.7/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.7/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.7/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.7/scripts/team-up.ts +360 -0
- package/.versions/0.0.7/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.7/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.7/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.7/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.7/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.7/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +544 -0
- package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +35 -0
- package/.versions/0.0.7/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.7/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.7/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.7/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.7/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.7/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.7/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.7/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.7/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.7/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.7/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.7/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.7/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.7/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +140 -0
- package/README.md +198 -40
- package/agents/code-reviewer.md +2 -2
- package/agents/documenter.md +1 -1
- package/agents/orchestrator.md +11 -0
- package/agents/plan-reviewer.md +1 -1
- package/agents/planner.md +1 -1
- package/agents/releaser.md +1 -1
- package/agents/security-auditor.md +1 -1
- package/bin/cli.js +60 -21
- package/bin/lib/bootstrap.js +16 -16
- package/bin/lib/doctor.js +1 -1
- package/bin/lib/hermes-profile-artifact.js +144 -0
- package/bin/lib/set-hermes-watchdog.js +173 -0
- package/bin/set-hermes-watchdog.js +26 -0
- package/docs/ARCHITECTURE.md +67 -15
- package/docs/agent-fleet-setup.md +13 -13
- package/docs/claude-code-coms-bridge.md +7 -1
- package/docs/coms-hermes-bridge.md +18 -8
- package/docs/getting-started.md +48 -0
- package/docs/hermes-watchdog-supervisor.md +140 -0
- package/docs/npm-install.md +21 -21
- package/docs/pi-extensions.md +7 -7
- package/docs/pi-setup.md +51 -47
- package/hermes/README.md +135 -19
- package/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +10 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/hooks/coms-stop-hook.mjs +12 -1
- package/package.json +11 -2
- package/references/fleet-coordination-patterns.md +2 -2
- package/scripts/coms-claude-bridge.ts +154 -39
- package/scripts/fleet.ts +9 -1
- package/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/scripts/lib/claude-bridge-core.ts +65 -0
- package/scripts/lib/coms-envelope.ts +44 -1
- package/scripts/lib/hermes-monitor-events.ts +1 -0
- package/scripts/lib/monitor-env.ts +120 -0
- package/scripts/team-snapshot.ts +1 -1
- package/scripts/team-up.ts +10 -1
- package/skills/browser-testing-with-devtools/SKILL.md +1 -1
- package/skills/compound-learning/SKILL.md +3 -3
- package/skills/guided-workspace-setup/SKILL.md +16 -14
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
- /package/.pi/prompts/{build.md → af-build.md} +0 -0
- /package/.pi/prompts/{code-simplify.md → af-code-simplify.md} +0 -0
- /package/.pi/prompts/{plan.md → af-plan.md} +0 -0
- /package/.pi/prompts/{review.md → af-review.md} +0 -0
- /package/.pi/prompts/{set-hermes-telegram.md → af-set-hermes-telegram.md} +0 -0
- /package/.pi/prompts/{ship.md → af-ship.md} +0 -0
- /package/.pi/prompts/{spec.md → af-spec.md} +0 -0
- /package/.pi/prompts/{test.md → af-test.md} +0 -0
|
@@ -6,7 +6,7 @@ first: [`damage-control-continue`](../damage-control-continue/README.md),
|
|
|
6
6
|
[`ask-user-remote`](../ask-user-remote/README.md), STT, Compact & Continue, BTW, and the
|
|
7
7
|
update checker. The dispatcher therefore has guardrails and an `ask_user` handoff tool
|
|
8
8
|
before `agent-hub` starts. It combines local specialist
|
|
9
|
-
orchestration (fixed specialist grid, read-only research helpers, `/zoom`, kill/restart, per-agent
|
|
9
|
+
orchestration (fixed specialist grid, read-only research helpers, `/af-zoom`, kill/restart, per-agent
|
|
10
10
|
model, dispatcher persona gate) with peer-to-peer collaboration: it can **hand a session off to
|
|
11
11
|
another main agent** and **use a coms peer as a subagent**.
|
|
12
12
|
|
|
@@ -50,14 +50,14 @@ Every borrowed idea from another harness passes one test before it lands: *does
|
|
|
50
50
|
|
|
51
51
|
- **Dispatcher grid** — a live dashboard of fixed specialists from `.pi/agents/teams.yaml`.
|
|
52
52
|
- **Specialist delegation** — `dispatch_agent` sends writable tasks to configured specialists.
|
|
53
|
-
- **Research helpers** — `spawn_research` and `/research` launch read-only helper agents. Two
|
|
53
|
+
- **Research helpers** — `spawn_research` and `/af-research` launch read-only helper agents. Two
|
|
54
54
|
`kind: research` personas ship by default: `researcher` (fast `gpt-5.3-codex-spark`) for simple
|
|
55
55
|
reads and `deep-researcher` (`gpt-5.5` / xhigh) for hard, cross-cutting investigation. The
|
|
56
56
|
orchestrator routes by persona; each persona's model + thinking level is shown in its catalog.
|
|
57
57
|
Finished helpers are **auto-pruned** so the research row doesn't grow without bound: auto-research
|
|
58
58
|
pipe helpers disappear as soon as they finish (their findings persist as `findings/*.md` files and
|
|
59
59
|
their handles are never resumed), while manual/persona helpers keep only the `research-keep` most
|
|
60
|
-
recently finished (default 4 — resumable via `/agents-cont rN`; older cards, and their session
|
|
60
|
+
recently finished (default 4 — resumable via `/af-agents-cont rN`; older cards, and their session
|
|
61
61
|
files, are dropped oldest-first). Set `research-keep: <n>|all` in the overrides file to change
|
|
62
62
|
the cap. Running helpers are never pruned and `rN` handles are never reused.
|
|
63
63
|
- **Human handoff path** — `ask_user` is exposed by the `ask-user-remote` wrapper (capturing stock
|
|
@@ -72,7 +72,8 @@ Every borrowed idea from another harness passes one test before it lands: *does
|
|
|
72
72
|
- **Verification Contract (assertion ledger)** — the dispatcher owns a ledger of checkable
|
|
73
73
|
acceptance assertions built from the request *before* any builder runs, so a clearly stated
|
|
74
74
|
requirement is never silently dropped. `set_assertions` records the numbered, tagged assertions
|
|
75
|
-
(`test` | `runtime-ui` | `code-grep` | `manual`, one pass condition each
|
|
75
|
+
(`test` | `runtime-ui` | `code-grep` | `manual`, one pass condition each, plus a required
|
|
76
|
+
`source` naming where the requirement comes from) and rebuilds the whole
|
|
76
77
|
ledger on a "wrong again" regression reset; `update_assertion` marks each one proven (named
|
|
77
78
|
evidence required), unproven, or failed after a verification gate; `get_assertions` reads the
|
|
78
79
|
full ledger (ids, tags, pass conditions, evidence) back. The hub persists the ledger to
|
|
@@ -87,16 +88,25 @@ Every borrowed idea from another harness passes one test before it lands: *does
|
|
|
87
88
|
to `.pi/agent-sessions/artifacts/returns/<agentKey>-run<N>.md`, surfaces only a compact
|
|
88
89
|
`details.structuredReturn` digest plus `details.returnPath`, and marks contract notices such as
|
|
89
90
|
missing assertion ids or evidence-less `assertions_proven` entries (demoted to unproven in the
|
|
90
|
-
tool text). `details.fullOutput` remains for `/zoom`/compatibility, but dispatcher-visible text is
|
|
91
|
+
tool text). `details.fullOutput` remains for `/af-zoom`/compatibility, but dispatcher-visible text is
|
|
91
92
|
digest + path oriented. `update_assertion(status: "proven")` validates evidence by assertion tag:
|
|
92
93
|
test evidence needs a command/test and outcome, `code-grep` needs pattern plus result sample,
|
|
93
94
|
manual needs user/`ask_user` confirmation, and `runtime-ui` needs an existing artifact path under
|
|
94
95
|
`.pi/agent-sessions/artifacts/evidence/`. **Advisory by design** (PRD open question 2): status is
|
|
95
96
|
surfaced and "proven" requires named evidence, but a dispatch is never hard-refused on an unproven
|
|
96
|
-
assertion — code-enforcement is the Checkpoint A decision.
|
|
97
|
+
assertion — code-enforcement is the Checkpoint A decision. Two contract rules ARE enforced at the
|
|
98
|
+
tool: a batch with any sourceless assertion is refused with the offending ids named (a specialist
|
|
99
|
+
told to prove `A9` must be able to read its origin instead of spending a dispatch and an ASK_USER
|
|
100
|
+
cycle asking where `A9` was defined), and a batch over **8** open assertions is accepted with a
|
|
101
|
+
warning suggesting the split — declare the batch the next dispatches actually prove, and
|
|
102
|
+
`set_assertions` the next one when it starts.
|
|
97
103
|
- **Artifact bus** — session handoffs live under `.pi/agent-sessions/artifacts/` with conventional
|
|
98
|
-
`returns/`, `plans/`, `reviews/`, `inventories/`, and `evidence/` subdirectories, all
|
|
99
|
-
recreated at session start like `findings/`. `
|
|
104
|
+
`returns/`, `failures/`, `plans/`, `reviews/`, `inventories/`, and `evidence/` subdirectories, all
|
|
105
|
+
wiped and recreated at session start like `findings/`. `failures/` is separate on purpose: a run
|
|
106
|
+
that errored or timed out produced no specialist result, so its output goes there and the dispatch
|
|
107
|
+
result names it a **delivery failure** carrying no assertion evidence. Filing a 142-byte coms error
|
|
108
|
+
stub as `returns/code-reviewer-run4.md` once cost a 103-second dispatch investigating a review that
|
|
109
|
+
had in fact succeeded — only its reply was lost. `dispatch_agent` and `spawn_research` accept optional
|
|
100
110
|
`artifacts: string[]` paths (repo-relative or session-artifact-relative); the hub validates that
|
|
101
111
|
they stay inside the repo/session roots and injects only the path plus first heading/one-line
|
|
102
112
|
preview, never file bodies. Document-producing specialists are instructed to write plans, reviews,
|
|
@@ -114,49 +124,59 @@ Every borrowed idea from another harness passes one test before it lands: *does
|
|
|
114
124
|
notice. This is advisory only: the hub never blocks completion, reverts files, or escalates
|
|
115
125
|
automatically. Known limitation: concurrent writable dispatches can only be attributed
|
|
116
126
|
approximately, so overlapping runs are flagged in the notice.
|
|
117
|
-
- **Agent controls** — `/zoom` inspects a live agent timeline; `/agents-history` replays the run as a
|
|
127
|
+
- **Agent controls** — `/af-zoom` inspects a live agent timeline; `/af-agents-history` replays the run as a
|
|
118
128
|
timeline (orchestrator turns, dispatches, research helpers) with per-agent durations, parallel-run
|
|
119
129
|
markers, and a grand total; kill/restart controls manage running child agents; per-agent `model:`
|
|
120
130
|
fields select models from team config. The `agents-*` commands address **both target kinds** —
|
|
121
|
-
team specialists by persona name, research helpers by `rN` handle (mirroring `/zoom`):
|
|
122
|
-
`/agents-kill <name|rN|all>` SIGTERMs a specialist (keeping its standing card), while on a
|
|
131
|
+
team specialists by persona name, research helpers by `rN` handle (mirroring `/af-zoom`):
|
|
132
|
+
`/af-agents-kill <name|rN|all>` SIGTERMs a specialist (keeping its standing card), while on a
|
|
123
133
|
research helper it kills **and removes** the card + session — helpers are disposable by design
|
|
124
|
-
(`all` clears every helper); `/agents-restart <name|rN>` re-runs the last task fresh (a research
|
|
125
|
-
helper must be finished first); `/agents-cont rN <prompt>` resumes a finished helper's session.
|
|
126
|
-
The old `/research-rm` and `/research-clear` spellings remain as aliases of the kill semantics,
|
|
127
|
-
`/research-cont` of `/agents-cont`.
|
|
134
|
+
(`all` clears every helper); `/af-agents-restart <name|rN>` re-runs the last task fresh (a research
|
|
135
|
+
helper must be finished first); `/af-agents-cont rN <prompt>` resumes a finished helper's session.
|
|
136
|
+
The old `/af-research-rm` and `/af-research-clear` spellings remain as aliases of the kill semantics,
|
|
137
|
+
`/af-research-cont` of `/af-agents-cont`.
|
|
128
138
|
Restartable team specialists at or above 70% context render
|
|
129
139
|
their context percentage with a warning marker/color in dashboard and compact views, and their next
|
|
130
|
-
`dispatch_agent` result adds a `/agents-restart <persona>` hint. Research helpers are not warned,
|
|
140
|
+
`dispatch_agent` result adds a `/af-agents-restart <persona>` hint. Research helpers are not warned,
|
|
131
141
|
and the hub never restarts specialists automatically.
|
|
132
142
|
- **Model switching** — a persona's frontmatter `models:` list declares the models it may switch to
|
|
133
|
-
(the default `model:` is implicitly a candidate). `/agent-model <persona>` picks from that list;
|
|
143
|
+
(the default `model:` is implicitly a candidate). `/af-agent-model <persona>` picks from that list;
|
|
134
144
|
the choice lasts for the session and takes effect on the persona's next dispatch
|
|
135
|
-
(`/agents-restart <persona>` applies it immediately). The dot form
|
|
136
|
-
`/agent-model <persona>.<role>` switches a delegate sub-role's model instead — its candidates are
|
|
145
|
+
(`/af-agents-restart <persona>` applies it immediately). The dot form
|
|
146
|
+
`/af-agent-model <persona>.<role>` switches a delegate sub-role's model instead — its candidates are
|
|
137
147
|
the role's declared default plus the parent persona's own candidate list; the switch is applied
|
|
138
148
|
when the parent is next dispatched (it lands in the serialized delegate config, so nested
|
|
139
|
-
children inherit it). `/models [profile]` applies a named profile
|
|
149
|
+
children inherit it). `/af-models [profile]` applies a named profile
|
|
140
150
|
from `.pi/agents/model-profiles.yaml` — a macro over the same declared candidates, validated at
|
|
141
151
|
session start (a profile with any entry outside a persona's candidates is dropped whole, with an
|
|
142
|
-
error); profiles never touch sub-role models — only `/agent-model` reaches those. Nothing
|
|
143
|
-
outside the declared lists is ever selectable.
|
|
152
|
+
error); profiles never touch sub-role models — only `/af-agent-model` reaches those. Nothing
|
|
153
|
+
outside the declared lists is ever selectable. When an effective project or session override
|
|
154
|
+
fails with a model/provider error or aborted request before work begins (including local-model
|
|
155
|
+
memory-limit failures), the hub retries once with the model originally declared in the persona
|
|
156
|
+
frontmatter. For **write-capable** runs this is pre-work only: no fallback occurs after text
|
|
157
|
+
output, a tool call, cancellation, timeout, drift stop, or a Pi process-spawn failure, avoiding
|
|
158
|
+
duplicate writes. **Read-only children and research helpers** (tools limited to
|
|
159
|
+
`read,grep,find,ls`) also retry once when the provider fails *mid-run* — re-running a reader
|
|
160
|
+
repeats nothing, and those are exactly the children that exist to protect their parent's context,
|
|
161
|
+
so losing one to a local-endpoint OOM halfway through discards work for no safety gain. A
|
|
162
|
+
terminated run (watchdog, deadline, cancellation) never retries either way: that is a verdict on
|
|
163
|
+
the work, not a provider outage. The failed attempt is removed from the child session before retry. Per project,
|
|
144
164
|
`model.<persona>:` / `models.<persona>:` keys under `## agent-hub` in
|
|
145
165
|
`.ai/agent-fleet-overrides.md` replace a persona's default model / candidate list.
|
|
146
166
|
Research personas (`researcher` / `deep-researcher`, `kind: research`) are switchable the same
|
|
147
|
-
way — `/agent-model <persona>` and `/agent-model-thinking <persona>` accept them alongside team
|
|
148
|
-
members. Since research helpers are spawned fresh on each `/research` / `spawn_research`, the
|
|
149
|
-
switch lands on their next spawn (there is no running instance to `/agents-restart`).
|
|
150
|
-
`/agent-models-substitute <source> <target>` is the global one-shot form: walks every loaded
|
|
167
|
+
way — `/af-agent-model <persona>` and `/af-agent-model-thinking <persona>` accept them alongside team
|
|
168
|
+
members. Since research helpers are spawned fresh on each `/af-research` / `spawn_research`, the
|
|
169
|
+
switch lands on their next spawn (there is no running instance to `/af-agents-restart`).
|
|
170
|
+
`/af-agent-models-substitute <source> <target>` is the global one-shot form: walks every loaded
|
|
151
171
|
persona (team + research + orchestrator), and for each whose **current effective model** is
|
|
152
172
|
`<source>` and whose declared candidates include `<target>`, sets the session override to
|
|
153
173
|
`<target>`. One-step flow — the dry-run summary (affected vs skipped, with reasons) is shown
|
|
154
174
|
inline, then the swap is applied immediately and takes effect on each persona's next dispatch
|
|
155
|
-
(`/agents-restart` to apply now). It never touches the dispatcher or delegate sub-roles.
|
|
175
|
+
(`/af-agents-restart` to apply now). It never touches the dispatcher or delegate sub-roles.
|
|
156
176
|
- **Thinking levels** — each persona's frontmatter `thinking:` sets its pi `--thinking`
|
|
157
|
-
reasoning effort (`off` · `minimal` · `low` · `medium` · `high` · `xhigh`). `/agent-model-thinking
|
|
177
|
+
reasoning effort (`off` · `minimal` · `low` · `medium` · `high` · `xhigh`). `/af-agent-model-thinking
|
|
158
178
|
<persona>` switches it among those six levels for the session; like a model switch it takes effect
|
|
159
|
-
on the persona's next dispatch (`/agents-restart <persona>` applies it now), and selecting the
|
|
179
|
+
on the persona's next dispatch (`/af-agents-restart <persona>` applies it now), and selecting the
|
|
160
180
|
frontmatter default clears the override. The level shows as a short badge after the model
|
|
161
181
|
everywhere a model is rendered — `gpt-5.5 (xh)` in the dashboard cards and the compact below-editor
|
|
162
182
|
view (`min`/`low`/`med`/`hi`/`xh`; `off` shows no badge). Per project, a `thinking.<persona>:` key
|
|
@@ -175,17 +195,19 @@ Every borrowed idea from another harness passes one test before it lands: *does
|
|
|
175
195
|
Concurrent children are always forced read-only. Children stream timeline events through
|
|
176
196
|
`.pi/agent-sessions/delegations/<persona>/events.jsonl`; the hub tails it and renders nested rows
|
|
177
197
|
under the parent's card (child id, model, tokens, status),
|
|
178
|
-
each openable with `/zoom <child-id>`. Each child also writes its full final output to
|
|
198
|
+
each openable with `/af-zoom <child-id>`. Each child also writes its full final output to
|
|
179
199
|
`.pi/agent-sessions/delegations/<persona>/results/<childId>.md`; the parent receives only status,
|
|
180
200
|
a required final `DIGEST:` section (≤30 lines with path:line citations), and the result-file path.
|
|
181
201
|
If a child omits `DIGEST:`, the parent gets the first ~30 lines plus a no-DIGEST warning and the
|
|
182
202
|
result path. Spend rolls up: every child row and the parent's subtree
|
|
183
203
|
total show tokens, and a session-wide `Δ delegated` counter sits in the status line.
|
|
184
|
-
`/agents-kill` on the parent SIGTERMs its whole process group, so the delegation tree dies with
|
|
204
|
+
`/af-agents-kill` on the parent SIGTERMs its whole process group, so the delegation tree dies with
|
|
185
205
|
it. `context: fork` is accepted but treated as a summary brief in v1. Per project,
|
|
186
206
|
`subagents.<persona>.<role>:` and `delegate-depth.<persona>:` keys under `## agent-hub` in
|
|
187
|
-
`.ai/agent-fleet-overrides.md` replace individual sub-roles / the depth budget.
|
|
188
|
-
|
|
207
|
+
`.ai/agent-fleet-overrides.md` replace individual sub-roles / the depth budget. An overridden
|
|
208
|
+
role retains its frontmatter model as a one-shot fallback under the same pre-work-only safety
|
|
209
|
+
rule; delegate cards and results show the model that ultimately ran. Six personas ship with
|
|
210
|
+
declared sub-roles, on a three-tier OpenAI model ladder — `gpt-5.3-codex-spark` for
|
|
189
211
|
recon/grep sweeps, `gpt-5.4` for analysis sweeps, the `gpt-5.5` (or opus) parent reserved for
|
|
190
212
|
synthesis and verdicts:
|
|
191
213
|
- `code-reviewer` — `preflight`+`docs` (spark), `quality`+`perf` (gpt-5.4); its first delegate
|
|
@@ -217,14 +239,14 @@ Every borrowed idea from another harness passes one test before it lands: *does
|
|
|
217
239
|
`agent-hub` (or plain `coms`) sessions on the same box find each other through per-project registry
|
|
218
240
|
files and exchange messages over a unix socket (named pipe on Windows).
|
|
219
241
|
|
|
220
|
-
Inherited `/zoom` behavior in this harness expands the latest event by default. Use `Space` or
|
|
242
|
+
Inherited `/af-zoom` behavior in this harness expands the latest event by default. Use `Space` or
|
|
221
243
|
`Ctrl+C` to copy the selected row content, and `Q` or `Esc` to close the overlay. The overlay sizes
|
|
222
244
|
to the terminal and keeps the selected (and last) entry fully visible while you navigate with
|
|
223
245
|
`↑/↓`.
|
|
224
246
|
|
|
225
|
-
### `/agents-history`
|
|
247
|
+
### `/af-agents-history`
|
|
226
248
|
|
|
227
|
-
`/agents-history` opens a read-only overlay (same chrome as `/zoom`) that replays the session as an
|
|
249
|
+
`/af-agents-history` opens a read-only overlay (same chrome as `/af-zoom`) that replays the session as an
|
|
228
250
|
execution **tree**:
|
|
229
251
|
|
|
230
252
|
- **Orchestrator turns** — each dispatcher turn that actually dispatched something is a depth-0 row
|
|
@@ -250,12 +272,12 @@ execution **tree**:
|
|
|
250
272
|
Navigate with `↑/↓`, press `G` to jump back to the live tail, and `Q`/`Esc` to close. The log resets
|
|
251
273
|
on each session start.
|
|
252
274
|
|
|
253
|
-
|
|
254
|
-
*
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
(`Alt+A view:
|
|
275
|
+
The agent view starts in **compact** mode, showing one line per *running* agent —
|
|
276
|
+
`name · context% · state` — *below* the input box, just above pi's status bar. Idle and done agents
|
|
277
|
+
are hidden, and the coms pool widget collapses too, so an idle session collapses to just the prompt
|
|
278
|
+
and footer. Press **`Alt+A`** to toggle to the full **dashboard** (bordered card grid drawn *above*
|
|
279
|
+
the input box) and back. The current mode and binding are shown in the footer
|
|
280
|
+
(`Alt+A view:compact` / `Alt+A view:dashboard`).
|
|
259
281
|
|
|
260
282
|
### Version footer
|
|
261
283
|
|
|
@@ -286,11 +308,11 @@ the single model line. Press **`Alt+S`** to start/stop dictation as in a normal
|
|
|
286
308
|
|
|
287
309
|
In **compact view**, the running-subagents list below the input doubles as a switcher. **`Alt+]`**
|
|
288
310
|
and **`Alt+[`** move a marker (`›` + highlight) to the next/previous running subagent; **`Alt+\`**
|
|
289
|
-
opens the read-only `/zoom` overlay on the marked one (`Q`/`Esc` to close). This only changes what
|
|
311
|
+
opens the read-only `/af-zoom` overlay on the marked one (`Q`/`Esc` to close). This only changes what
|
|
290
312
|
you *view* — **the input box always prompts the main session**, and `main` is never a marker target
|
|
291
313
|
(it is the session under the input, not a subagent). There is no transcript takeover: a subagent's
|
|
292
314
|
stream is surfaced through the modal zoom overlay, never by replacing the main scrollback. The keys
|
|
293
|
-
are inert in dashboard mode (use `/zoom <name>` there).
|
|
315
|
+
are inert in dashboard mode (use `/af-zoom <name>` there).
|
|
294
316
|
|
|
295
317
|
> Terminal note: `Alt+[` emits `ESC [` (a CSI prefix) and may be swallowed by some terminals'
|
|
296
318
|
> escape parsers; `Alt+]` and `Alt+\` are the reliable pair. `Alt+↑/↓/←/→` are reserved by the pi
|
|
@@ -400,7 +422,7 @@ task, most of it re-billed stale specialist context).
|
|
|
400
422
|
|
|
401
423
|
When a budget is exhausted, `dispatch_agent`/`spawn_research` **refuse** with instructions
|
|
402
424
|
to summarize and ask the user; the next user message opens a fresh window. Switch modes
|
|
403
|
-
live with `/hub-mode fast|standard|strict` (no argument shows the current mode and usage);
|
|
425
|
+
live with `/af-hub-mode fast|standard|strict` (no argument shows the current mode and usage);
|
|
404
426
|
set the project default and per-axis overrides in the overrides file:
|
|
405
427
|
|
|
406
428
|
```markdown
|
|
@@ -421,6 +443,36 @@ or its measured context passes 60%. The dispatch result notes the recycle so the
|
|
|
421
443
|
knows the specialist starts without session memory — task text and `artifacts:` paths must
|
|
422
444
|
carry the state, which the deliverable-to-file protocol already ensures.
|
|
423
445
|
|
|
446
|
+
Context is measured against **that agent's own** model window, resolved from pi's model
|
|
447
|
+
registry (`ctx.modelRegistry.find`) with the source recorded on every resolution. Dividing a
|
|
448
|
+
49k local model's usage by the dispatcher's window is what produced unactionable readings
|
|
449
|
+
like `⚠ Planner context at 315%`; a reading above 100% now emits a one-time diagnostic that
|
|
450
|
+
names the window and where the number came from, so a mis-resolved window is distinguishable
|
|
451
|
+
from a genuine overflow. Two recycle rules follow from it: a session at or past a **full**
|
|
452
|
+
window is recycled unconditionally (no threshold override keeps it alive), and a resumed
|
|
453
|
+
session whose *projected* prompt — prior tokens plus this task — would overflow is recycled
|
|
454
|
+
**before** the spawn instead of after the run.
|
|
455
|
+
|
|
456
|
+
#### Per-provider concurrency
|
|
457
|
+
|
|
458
|
+
A dispatch may fan out to four delegate children at once and several specialists can be
|
|
459
|
+
mid-run, with nothing bounding how many requests land on one provider. That is fine against
|
|
460
|
+
a hosted endpoint and not against a local one. Requests are capped per process — **2 in
|
|
461
|
+
flight for `custom/*` by default, unlimited elsewhere**:
|
|
462
|
+
|
|
463
|
+
```bash
|
|
464
|
+
AGENT_HUB_PROVIDER_LIMITS="custom=4" # raise the local cap
|
|
465
|
+
AGENT_HUB_PROVIDER_LIMITS="custom=off" # disable it
|
|
466
|
+
AGENT_HUB_PROVIDER_LIMITS="custom=2,ollama=1"
|
|
467
|
+
```
|
|
468
|
+
|
|
469
|
+
Queued runs still execute — they wait for a permit, and the wait is announced rather than
|
|
470
|
+
looking like a hang. The cap applies per **level** of the delegation tree (each pi process
|
|
471
|
+
runs its own semaphore over the children it spawns), and a nested spawn reuses its parent's
|
|
472
|
+
permit, so a child can never wait on its own ancestor. The drift judge and the return
|
|
473
|
+
extractor are deliberately ungated: both run while a specialist holds a permit, so queueing
|
|
474
|
+
them behind it would stall the watchdog meant to stop it.
|
|
475
|
+
|
|
424
476
|
The per-run deadline lands as `turn_timeout` (exit 124) with partial output preserved, for
|
|
425
477
|
dispatched specialists, research helpers, and nested delegate children alike — a hung child
|
|
426
478
|
can no longer hold its parent for hours.
|
|
@@ -437,7 +489,7 @@ The system prompt ties the tier to the anti-over-engineering rules: a provided p
|
|
|
437
489
|
spec (no re-planning), assertions stay ≤3 for trivial/small asks, and "using every persona"
|
|
438
490
|
is called out as a smell. Two hygiene guards are enforced in code, not prose: a
|
|
439
491
|
**duplicate-dispatch guard** refuses re-dispatching the same agent with a near-identical
|
|
440
|
-
task inside one turn, and every budget/duplicate refusal is counted in `/hub-report`.
|
|
492
|
+
task inside one turn, and every budget/duplicate refusal is counted in `/af-hub-report`.
|
|
441
493
|
|
|
442
494
|
### Drift watchdog (in-flight observation)
|
|
443
495
|
|
|
@@ -456,8 +508,8 @@ drives the cards — not post-hoc:
|
|
|
456
508
|
corrected, narrowed task — never the same task unchanged.
|
|
457
509
|
|
|
458
510
|
Enablement is dynamic, precedence top to bottom: the `watchdog: true|false` param on a
|
|
459
|
-
single `dispatch_agent` call → a per-agent override (`/watchdog builder on|off|clear`) →
|
|
460
|
-
the hub-wide setting (`/watchdog on|off|auto`, default `auto`, project default via the
|
|
511
|
+
single `dispatch_agent` call → a per-agent override (`/af-watchdog builder on|off|clear`) →
|
|
512
|
+
the hub-wide setting (`/af-watchdog on|off|auto`, default `auto`, project default via the
|
|
461
513
|
`watchdog:` overrides key). Read-only research helpers are not monitored — they already
|
|
462
514
|
run under the per-tool watchdog + turn deadline and cannot write.
|
|
463
515
|
|
|
@@ -465,15 +517,15 @@ run under the per-tool watchdog + turn deadline and cannot write.
|
|
|
465
517
|
|
|
466
518
|
Rosters start from `.pi/agents/teams.yaml` but are not frozen there:
|
|
467
519
|
|
|
468
|
-
- `/agents-add <persona>…` / `/agents-drop <persona>…` — restructure the ACTIVE team
|
|
520
|
+
- `/af-agents-add <persona>…` / `/af-agents-drop <persona>…` — restructure the ACTIVE team
|
|
469
521
|
live (drop refuses running or last members; session files are kept for re-adding).
|
|
470
|
-
- `/agents-save <name>` — persist the current roster as a named team back into
|
|
522
|
+
- `/af-agents-save <name>` — persist the current roster as a named team back into
|
|
471
523
|
`teams.yaml` (targeted block upsert; comments and other teams untouched).
|
|
472
524
|
- `team_adjust` — the dispatcher itself may add/drop a persona **with a stated reason**;
|
|
473
525
|
disabled in fast mode, capped at 8 roster members, and every change is notified to the
|
|
474
526
|
human. The system prompt is rebuilt each turn, so changes take effect immediately.
|
|
475
527
|
|
|
476
|
-
### `/hub-report`
|
|
528
|
+
### `/af-hub-report`
|
|
477
529
|
|
|
478
530
|
Per-turn cost accounting: dispatches (agent, status, elapsed, billed/output tokens),
|
|
479
531
|
research runs, session recycles, drift stops, and budget/duplicate refusals — for the
|
|
@@ -496,9 +548,13 @@ Inside a [herdr](https://herdr.dev) pane with a live server, the dispatcher's to
|
|
|
496
548
|
surface additionally gets (absent otherwise, like coms):
|
|
497
549
|
|
|
498
550
|
- `herdr_spawn_peer` — stand up a persona peer (joins the coms pool via `just _peer`) or a
|
|
499
|
-
raw command pane in the current workspace
|
|
551
|
+
raw command pane in the current workspace. A persona peer **boots idle** and does nothing until
|
|
552
|
+
a `coms_send` reaches it, so the call waits (bounded, ~45s) for it to register and returns
|
|
553
|
+
`peer_ready` plus its coms name instead of a bare pane id. Peers spawned but never addressed are
|
|
554
|
+
named at turn end and in `/af-hub-report` with a close suggestion — closing stays the human's call
|
|
500
555
|
- `herdr_read_pane` — bounded `pane.read` (≤200 lines), read-to-decide on workers/tools;
|
|
501
|
-
messaging still goes through coms
|
|
556
|
+
messaging still goes through coms, and peer busy state comes from `coms_list`, not from
|
|
557
|
+
reading the screen
|
|
502
558
|
- `herdr_close_pane` — kills a pane; **asks the human to confirm every call**; the
|
|
503
559
|
bash-level `herdr pane close`/`workspace close`/`server stop` verbs are hard-blocked
|
|
504
560
|
for spawned specialists by `.pi/damage-control-rules.yaml`
|
|
@@ -529,20 +585,23 @@ Each session registers a coms identity at start-up, resolved in this precedence
|
|
|
529
585
|
|
|
530
586
|
Names are de-duplicated per project (`resolveUniqueName`), so two hubs that both want `architect`
|
|
531
587
|
become `architect` and `architect-2`. `--explicit` marks a **private** peer — kept out of every
|
|
532
|
-
pool by default, so it is neither listed nor reachable until a human opts in with `/coms --all`
|
|
588
|
+
pool by default, so it is neither listed nor reachable until a human opts in with `/af-coms --all`
|
|
533
589
|
(see [Pool scope is the reach boundary](#pool-scope-is-the-reach-boundary)). The registry lives
|
|
534
590
|
under `~/.pi/coms/projects/<project>/agents/<name>.json` and is created at runtime.
|
|
535
591
|
|
|
536
592
|
### Commands & tools (local dispatcher plus coms)
|
|
537
593
|
|
|
538
|
-
- `/coms` — coms control surface (peer list / status)
|
|
539
|
-
- `/handoff <peer>` — hand the whole session off to a coms peer (see [Handoff](#handoff))
|
|
540
|
-
- `/compound [focus]` — end-of-session **compound-learning pass**: the dispatcher composes a
|
|
594
|
+
- `/af-coms` — coms control surface (peer list / status)
|
|
595
|
+
- `/af-handoff <peer>` — hand the whole session off to a coms peer (see [Handoff](#handoff))
|
|
596
|
+
- `/af-compound [focus]` — end-of-session **compound-learning pass**: the dispatcher composes a
|
|
541
597
|
candidate-lessons brief from the session (corrections, recurring findings, root causes),
|
|
542
598
|
confirms it with the user, then dispatches the `documenter` to land the approved lessons as
|
|
543
599
|
minimal diffs on the project's `rules:`/`docs:` targets per `skills/compound-learning/SKILL.md`.
|
|
544
|
-
Requires the `documenter` persona in the active team; run it before `/handoff` or session end.
|
|
545
|
-
- `coms_list` — discover the peers in your pool: names, models, live context usage, purpose
|
|
600
|
+
Requires the `documenter` persona in the active team; run it before `/af-handoff` or session end.
|
|
601
|
+
- `coms_list` — discover the peers in your pool: names, models, live context usage, purpose,
|
|
602
|
+
`pane_id`, and `status` (`idle` | `working` | `booting`). Check status before sending: `working`
|
|
603
|
+
means your send waits behind the peer's current turn, `booting` means it is not addressable yet.
|
|
604
|
+
This is the field whose absence drove 127 `herdr_read_pane` calls in one session. Scoped
|
|
546
605
|
to your project and excluding private peers; the LLM cannot widen it (see
|
|
547
606
|
[Pool scope is the reach boundary](#pool-scope-is-the-reach-boundary)).
|
|
548
607
|
- `coms_send` — send a prompt to a peer **in your pool**; returns a `msg_id`
|
|
@@ -550,19 +609,19 @@ under `~/.pi/coms/projects/<project>/agents/<name>.json` and is created at runti
|
|
|
550
609
|
`PI_COMS_TIMEOUT_MS`)
|
|
551
610
|
- `coms_get` — **non-blocking** poll of a `msg_id` (status `pending|complete|error`)
|
|
552
611
|
|
|
553
|
-
`/coms` and `/handoff` tab-complete live peer names **in your pool**.
|
|
612
|
+
`/af-coms` and `/af-handoff` tab-complete live peer names **in your pool**.
|
|
554
613
|
|
|
555
614
|
### Pool scope is the reach boundary
|
|
556
615
|
|
|
557
616
|
The set of peers shown in the pool widget is the security boundary: **a peer is reachable only if it
|
|
558
|
-
is in your pool.** `coms_list`, `coms_send`, and `/handoff` all resolve targets through the same
|
|
617
|
+
is in your pool.** `coms_list`, `coms_send`, and `/af-handoff` all resolve targets through the same
|
|
559
618
|
`peersInScope()` helper, so the dispatcher can never message a peer it cannot see. Two knobs define
|
|
560
619
|
the pool, and **both are human-only** — the LLM cannot widen scope to reach more peers:
|
|
561
620
|
|
|
562
|
-
- **Project** — defaults to your own `identity.project`. A human can retarget with `/coms --project
|
|
563
|
-
<name>` (one project) or `/coms --all` (every project). `coms_list`'s own parameters cannot
|
|
621
|
+
- **Project** — defaults to your own `identity.project`. A human can retarget with `/af-coms --project
|
|
622
|
+
<name>` (one project) or `/af-coms --all` (every project). `coms_list`'s own parameters cannot
|
|
564
623
|
override this; an LLM request for a wider project is clamped back to the current pool and flagged.
|
|
565
|
-
- **Explicit (private) peers** — excluded from every pool by default. `/coms --all` opts them in.
|
|
624
|
+
- **Explicit (private) peers** — excluded from every pool by default. `/af-coms --all` opts them in.
|
|
566
625
|
|
|
567
626
|
This closes a cross-project leak where a peer reachable through the mesh was *not* shown in the
|
|
568
627
|
default project-scoped pool — so it could be messaged without being "connected." Now the reachable
|
|
@@ -614,12 +673,12 @@ Semantics:
|
|
|
614
673
|
- **Standing context is the point.** Re-dispatches (ASK_USER answers, research resumes) go back to
|
|
615
674
|
the same peer session, so a Claude Code reviewer keeps its review context across rounds.
|
|
616
675
|
- **Visibility.** The member's grid card shows a `⇄coms <peer-model>` badge, history entries are
|
|
617
|
-
annotated `(coms)`, and `/dispatch-policy` prints the resolved routing per member with live-peer
|
|
676
|
+
annotated `(coms)`, and `/af-dispatch-policy` prints the resolved routing per member with live-peer
|
|
618
677
|
status.
|
|
619
|
-
- **Limitations.** `/agents-kill` on a coms-backed run only abandons the wait — the peer keeps
|
|
620
|
-
running in its own pane and cannot be killed from the hub (`/agents-restart` abandons, then
|
|
621
|
-
re-dispatches). `/zoom` shows only the final reply (there is no stream), tool counts stay 0, and
|
|
622
|
-
context% is a registry snapshot. `/agent-model` overrides apply only to native(-fallback) runs —
|
|
678
|
+
- **Limitations.** `/af-agents-kill` on a coms-backed run only abandons the wait — the peer keeps
|
|
679
|
+
running in its own pane and cannot be killed from the hub (`/af-agents-restart` abandons, then
|
|
680
|
+
re-dispatches). `/af-zoom` shows only the final reply (there is no stream), tool counts stay 0, and
|
|
681
|
+
context% is a registry snapshot. `/af-agent-model` overrides apply only to native(-fallback) runs —
|
|
623
682
|
the peer's model is set in `peers.yaml`.
|
|
624
683
|
|
|
625
684
|
Missing file = everything native. HOW a peer runs (persona, model, `runner: claude-code`, env) stays
|
|
@@ -627,7 +686,7 @@ in `peers.yaml`; this file only decides WHEN the hub prefers a peer over a nativ
|
|
|
627
686
|
|
|
628
687
|
### Handoff
|
|
629
688
|
|
|
630
|
-
`/handoff <peer>` transfers the session to another **main** agent. Following the plan's
|
|
689
|
+
`/af-handoff <peer>` transfers the session to another **main** agent. Following the plan's
|
|
631
690
|
**decision G1**, it does *not* try to extract a compaction summary; instead it asks the dispatcher
|
|
632
691
|
LLM to compose a **self-contained brief** ("everything the target needs, assume no shared history"),
|
|
633
692
|
then `coms_send`s that brief to the peer, `coms_await`s the reply, and relays it back — in the
|
|
@@ -636,7 +695,7 @@ sections after the LLM brief: `## Verification ledger (verbatim, machine-appende
|
|
|
636
695
|
assertion in canonical ledger form, and `## Artifact index` with artifact paths plus first headings.
|
|
637
696
|
The target peer must treat the machine-appended ledger as the contract, not the paraphrased brief.
|
|
638
697
|
The target peer takes over; the source relays the result. There is no raw session copy (pi sessions
|
|
639
|
-
aren't portable between live agents). The target must be a peer in your pool — `/handoff` resolves
|
|
698
|
+
aren't portable between live agents). The target must be a peer in your pool — `/af-handoff` resolves
|
|
640
699
|
through the same [scope boundary](#pool-scope-is-the-reach-boundary) as `coms_send`, so you cannot
|
|
641
700
|
hand a session to a peer you cannot see.
|
|
642
701
|
|
|
@@ -652,13 +711,13 @@ The dispatcher persona gate fires *after* coms init, so the identity's `purpose`
|
|
|
652
711
|
flag/frontmatter/default and is then reconciled to the chosen persona: `syncComsPurpose()` maps the
|
|
653
712
|
selected `kind: orchestrator` persona to `"<Name> — <description>"` and re-writes the live registry
|
|
654
713
|
entry — **unless** `--purpose` was passed explicitly (an explicit flag always wins). Switching or
|
|
655
|
-
resetting the persona via `/persona` re-syncs.
|
|
714
|
+
resetting the persona via `/af-persona` re-syncs.
|
|
656
715
|
|
|
657
716
|
### Graceful degradation
|
|
658
717
|
|
|
659
718
|
If the coms socket can't bind at start-up (`comsReady` stays `false`), the session degrades to a
|
|
660
719
|
local dispatcher without coms: the `coms_*` tools are withheld from `setActiveTools`, the
|
|
661
|
-
`/handoff` command refuses with a notice, and the "Peer agents (coms)" prompt section is omitted.
|
|
720
|
+
`/af-handoff` command refuses with a notice, and the "Peer agents (coms)" prompt section is omitted.
|
|
662
721
|
Orchestration, research helpers, and the grid keep working.
|
|
663
722
|
|
|
664
723
|
### Tool surface
|
|
@@ -793,6 +852,6 @@ coms purpose/color.
|
|
|
793
852
|
`spawn_research` (+ `ask_user`); the system prompt gains a "Peer agents (coms)" section when coms
|
|
794
853
|
is ready. The persona's `description` drives the coms `purpose` (decision 6 / Phase 6 peer
|
|
795
854
|
mapping) instead of a static `--purpose`.
|
|
796
|
-
- **`/handoff` uses an LLM-composed brief**, not a compaction-summary extraction (decision G1).
|
|
855
|
+
- **`/af-handoff` uses an LLM-composed brief**, not a compaction-summary extraction (decision G1).
|
|
797
856
|
- **Clean shutdown** SIGTERMs any running specialist/research children, clears the coms pool
|
|
798
857
|
widget, and removes the registry entry on `session_shutdown` / SIGINT / SIGTERM.
|
|
@@ -1,6 +1,11 @@
|
|
|
1
1
|
import { isAbsolute, relative, resolve, sep } from "node:path";
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
// `failures` is deliberately its own kind, not a flavour of `returns`: a run
|
|
4
|
+
// that errored or timed out produced no specialist result, and storing its error
|
|
5
|
+
// text as a return is the most expensive artifact in the system — a 142-byte
|
|
6
|
+
// coms error stub written to returns/code-reviewer-run4.md cost a full dispatch
|
|
7
|
+
// investigating a review that had in fact succeeded, only its reply was lost.
|
|
8
|
+
export const ARTIFACT_KINDS = ["returns", "failures", "plans", "reviews", "inventories", "evidence"];
|
|
4
9
|
|
|
5
10
|
const SESSION_RELATIVE_PREFIXES = new Set(["artifacts", "findings", "delegations"]);
|
|
6
11
|
const PREVIEW_LIMIT = 180;
|
|
@@ -44,14 +49,63 @@ export function resolveArtifactPath(inputPath, options) {
|
|
|
44
49
|
}
|
|
45
50
|
|
|
46
51
|
const exists = typeof options.exists === "function" ? options.exists : () => true;
|
|
47
|
-
const
|
|
52
|
+
const found = valid.find((candidate) => exists(candidate.target));
|
|
53
|
+
if (found) {
|
|
54
|
+
return {
|
|
55
|
+
input: raw,
|
|
56
|
+
path: found.target,
|
|
57
|
+
displayPath: displayPath(found.target, found.displayBase, found.prefix),
|
|
58
|
+
resolvedFromKind: null,
|
|
59
|
+
};
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
// Nothing at the requested path. The hub writes EVERY auto-return under
|
|
63
|
+
// `returns/`, while the deliverable protocol teaches dispatchers that documents
|
|
64
|
+
// live in `artifacts/<kind>/` — so `reviews/code-reviewer-run1.md` is the
|
|
65
|
+
// natural and wrong guess for a file that is sitting in `returns/`. Look for
|
|
66
|
+
// the same name under the other kinds instead of reporting a missing file.
|
|
67
|
+
const requested = matchKindPath(normalized);
|
|
68
|
+
if (requested) {
|
|
69
|
+
const hits = ARTIFACT_KINDS
|
|
70
|
+
.filter((kind) => kind !== requested.kind)
|
|
71
|
+
.map((kind) => ({ kind, target: resolve(artifactRoot, `${kind}/${requested.rest}`) }))
|
|
72
|
+
.filter((candidate) => isWithin(artifactRoot, candidate.target) && exists(candidate.target));
|
|
73
|
+
if (hits.length === 1) {
|
|
74
|
+
return {
|
|
75
|
+
input: raw,
|
|
76
|
+
path: hits[0].target,
|
|
77
|
+
displayPath: displayPath(hits[0].target, artifactRoot, "artifacts"),
|
|
78
|
+
resolvedFromKind: hits[0].kind,
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
// Never guess between kinds: two files with the same name are two documents.
|
|
82
|
+
if (hits.length > 1) {
|
|
83
|
+
throw new Error(
|
|
84
|
+
`Ambiguous artifact ${raw}: "${requested.rest}" exists under ${hits.map((h) => `${h.kind}/`).join(" and ")}. ` +
|
|
85
|
+
"Name the kind explicitly.",
|
|
86
|
+
);
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
const picked = valid[0];
|
|
48
91
|
return {
|
|
49
92
|
input: raw,
|
|
50
93
|
path: picked.target,
|
|
51
94
|
displayPath: displayPath(picked.target, picked.displayBase, picked.prefix),
|
|
95
|
+
resolvedFromKind: null,
|
|
52
96
|
};
|
|
53
97
|
}
|
|
54
98
|
|
|
99
|
+
/** `reviews/x.md` / `artifacts/reviews/x.md` → `{ kind: "reviews", rest: "x.md" }`. */
|
|
100
|
+
function matchKindPath(normalized) {
|
|
101
|
+
const parts = String(normalized || "").split("/").filter(Boolean);
|
|
102
|
+
const offset = parts[0] === "artifacts" ? 1 : 0;
|
|
103
|
+
const kind = parts[offset];
|
|
104
|
+
if (!ARTIFACT_KINDS.includes(kind)) return null;
|
|
105
|
+
const rest = parts.slice(offset + 1).join("/");
|
|
106
|
+
return rest ? { kind, rest } : null;
|
|
107
|
+
}
|
|
108
|
+
|
|
55
109
|
export function resolveArtifactPaths(paths, options) {
|
|
56
110
|
return (paths || []).map((p) => resolveArtifactPath(p, options));
|
|
57
111
|
}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
// Assertion-ledger contract — pure validation for the `set_assertions` tool.
|
|
2
|
+
//
|
|
3
|
+
// Two rules, both drawn from the post-mortem of the hub sessions that declared
|
|
4
|
+
// 30 assertions (GO1–GO5, A1–A25) in one call and then spent a dispatch plus an
|
|
5
|
+
// ASK_USER cycle answering "where were A9–A16 defined?":
|
|
6
|
+
//
|
|
7
|
+
// 1. Every assertion names its origin, so an id can always be traced back to
|
|
8
|
+
// the plan/spec line it came from. Refused when missing — a sourceless id
|
|
9
|
+
// is exactly the failure that cost the cycle.
|
|
10
|
+
// 2. The open ledger is capped at MAX_OPEN_ASSERTIONS per batch. Warned, not
|
|
11
|
+
// refused: a large task legitimately has many assertions, they just should
|
|
12
|
+
// not all be open at once. Declare the rest when their batch starts.
|
|
13
|
+
|
|
14
|
+
export const MAX_OPEN_ASSERTIONS = 8;
|
|
15
|
+
|
|
16
|
+
const str = (v) => String(v ?? "").trim();
|
|
17
|
+
|
|
18
|
+
/**
|
|
19
|
+
* Validate + normalize one `set_assertions` batch.
|
|
20
|
+
* Returns { ok, refusal?, warning, assertions } — `assertions` is empty on a
|
|
21
|
+
* refusal so a rejected batch can never half-replace the live ledger.
|
|
22
|
+
*/
|
|
23
|
+
export function validateAssertionBatch(input) {
|
|
24
|
+
const batch = Array.isArray(input) ? input : [];
|
|
25
|
+
|
|
26
|
+
const sourceless = batch
|
|
27
|
+
.map((a, i) => (str(a?.source) === "" ? str(a?.id) || `#${i + 1}` : null))
|
|
28
|
+
.filter((label) => label !== null);
|
|
29
|
+
|
|
30
|
+
if (sourceless.length > 0) {
|
|
31
|
+
return {
|
|
32
|
+
ok: false,
|
|
33
|
+
refusal:
|
|
34
|
+
`Ledger unchanged: ${sourceless.length} assertion(s) declare no source — ${sourceless.join(", ")}. ` +
|
|
35
|
+
"Every assertion must name where it comes from (e.g. source: \"PLAN-x.md:585-595\", " +
|
|
36
|
+
"\"user request\", \"review finding F3\") so a specialist asked to prove it can read the origin " +
|
|
37
|
+
"instead of asking. Re-send the batch with a source on each.",
|
|
38
|
+
warning: null,
|
|
39
|
+
assertions: [],
|
|
40
|
+
};
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
const assertions = batch.map((a) => ({
|
|
44
|
+
id: str(a?.id),
|
|
45
|
+
tag: str(a?.tag),
|
|
46
|
+
text: str(a?.text),
|
|
47
|
+
source: str(a?.source),
|
|
48
|
+
}));
|
|
49
|
+
|
|
50
|
+
const warning =
|
|
51
|
+
assertions.length > MAX_OPEN_ASSERTIONS
|
|
52
|
+
? `⚠ ${assertions.length} assertions are open at once (soft cap ${MAX_OPEN_ASSERTIONS}). ` +
|
|
53
|
+
"Keep this batch to the assertions the next dispatches actually prove and defer the rest — " +
|
|
54
|
+
"declare them with a fresh set_assertions when their batch starts. Accepted as-is."
|
|
55
|
+
: null;
|
|
56
|
+
|
|
57
|
+
return { ok: true, warning, assertions };
|
|
58
|
+
}
|
|
@@ -147,7 +147,7 @@ export function comsRequiredRefusal(agentName, graceS) {
|
|
|
147
147
|
return (
|
|
148
148
|
`"${agentName}" is configured as coms-required (fallback: none) but no live peer named ` +
|
|
149
149
|
`"${String(agentName).toLowerCase()}" appeared in the pool within ${graceS}s. ` +
|
|
150
|
-
"Start it with `just hub-team <team>` / `just team-up <team>`, widen the pool with /coms, " +
|
|
150
|
+
"Start it with `just hub-team <team>` / `just team-up <team>`, widen the pool with /af-coms, " +
|
|
151
151
|
"or set `fallback: native` in .pi/agents/dispatch-policy.yaml."
|
|
152
152
|
);
|
|
153
153
|
}
|