@chankov/agent-fleet 0.0.5 → 0.0.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.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 +58 -58
- package/.pi/harnesses/agent-hub/backend-policy.js +1 -1
- package/.pi/harnesses/agent-hub/delegate.ts +3 -3
- package/.pi/harnesses/agent-hub/drift-watchdog.js +1 -1
- package/.pi/harnesses/agent-hub/index.ts +248 -248
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/run-budget.js +1 -1
- package/.pi/harnesses/coms/README.md +2 -2
- package/.pi/harnesses/coms/index.ts +13 -13
- 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/prompts/{doctor-agent-fleet.md → af-doctor-agent-fleet.md} +1 -1
- 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-cap.test.py +15 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
- package/.versions/0.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.6/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.6/hooks/coms-stop-hook.mjs +73 -0
- package/.versions/0.0.6/hooks/hooks.json +14 -0
- package/.versions/0.0.6/hooks/session-start.sh +74 -0
- package/.versions/0.0.6/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.6/justfile +245 -0
- package/.versions/0.0.6/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.6/references/definition-of-done.md +67 -0
- package/.versions/0.0.6/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.6/references/observability-checklist.md +91 -0
- package/.versions/0.0.6/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.6/references/performance-checklist.md +153 -0
- package/.versions/0.0.6/references/prompting-patterns.md +380 -0
- package/.versions/0.0.6/references/security-checklist.md +179 -0
- package/.versions/0.0.6/references/testing-patterns.md +236 -0
- package/.versions/0.0.6/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.6/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.6/scripts/coms-claude-bridge.ts +286 -0
- package/.versions/0.0.6/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.6/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.6/scripts/fleet.ts +141 -0
- package/.versions/0.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.6/scripts/hermes-monitor-scenario.ts +7 -0
- package/.versions/0.0.6/scripts/lib/claude-bridge-core.ts +100 -0
- package/.versions/0.0.6/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.6/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.6/scripts/lib/coms-envelope.ts +539 -0
- package/.versions/0.0.6/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.6/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.6/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.6/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.6/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.6/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.6/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.6/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.6/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.6/scripts/team-up.ts +351 -0
- package/.versions/0.0.6/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.6/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.6/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.6/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.6/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.6/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +544 -0
- package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +35 -0
- package/.versions/0.0.6/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.6/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.6/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.6/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.6/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.6/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.6/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.6/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.6/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.6/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.6/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.6/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.6/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.6/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +6 -0
- package/README.md +24 -23
- package/agents/documenter.md +1 -1
- package/agents/releaser.md +1 -1
- package/bin/cli.js +20 -20
- package/bin/lib/bootstrap.js +16 -16
- package/bin/lib/doctor.js +1 -1
- package/docs/ARCHITECTURE.md +4 -4
- package/docs/agent-fleet-setup.md +11 -11
- package/docs/coms-hermes-bridge.md +8 -8
- 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 +1 -1
- package/package.json +1 -1
- package/references/fleet-coordination-patterns.md +2 -2
- 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/.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 @@ A pi extension that surfaces an "update available" banner once per session when
|
|
|
6
6
|
|
|
7
7
|
On the first `agent_start` event of a pi session, the extension:
|
|
8
8
|
|
|
9
|
-
1. Reads `version:` from `.ai/agent-fleet-setup.md` in the current working directory. If the record is missing (workspace was never set up via `/setup-agent-fleet`), the check is skipped.
|
|
9
|
+
1. Reads `version:` from `.ai/agent-fleet-setup.md` in the current working directory. If the record is missing (workspace was never set up via `/af-setup-agent-fleet`), the check is skipped.
|
|
10
10
|
2. Reads the cached latest version from `$XDG_CACHE_HOME/agent-fleet/latest-version.json` (falling back to `~/.cache/agent-fleet/`).
|
|
11
11
|
3. If the cache is older than 24 hours or absent, fetches the latest version from the npm registry with a 3-second timeout.
|
|
12
12
|
4. If the published version is greater than the recorded version, emits an `info`-level notification via `ctx.ui.notify`.
|
|
@@ -16,7 +16,7 @@ The check runs **once per session** and is bounded to a single network call. It
|
|
|
16
16
|
## When the banner fires
|
|
17
17
|
|
|
18
18
|
```
|
|
19
|
-
agent-fleet update available: 0.1.0 → 0.2.0. Run "npx @chankov/agent-fleet@latest update" then /setup-agent-fleet to apply.
|
|
19
|
+
agent-fleet update available: 0.1.0 → 0.2.0. Run "npx @chankov/agent-fleet@latest update" then /af-setup-agent-fleet to apply.
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
The banner appears in pi's UI notification area — the same surface used by other extensions for non-fatal status. It does not block, prompt, or modify any file. The user decides when to act on it.
|
|
@@ -33,7 +33,7 @@ Every error path silently aborts. Update checks must never disrupt a session.
|
|
|
33
33
|
|
|
34
34
|
## Install
|
|
35
35
|
|
|
36
|
-
Installed via `/setup-agent-fleet` as part of Group 10 — pi extensions. Or symlink manually:
|
|
36
|
+
Installed via `/af-setup-agent-fleet` as part of Group 10 — pi extensions. Or symlink manually:
|
|
37
37
|
|
|
38
38
|
```bash
|
|
39
39
|
ln -s /path/to/@chankov/agent-fleet/.pi/extensions/agent-fleet-update-check \
|
|
@@ -54,5 +54,5 @@ The check honours three environment variables (any of them disables it):
|
|
|
54
54
|
|
|
55
55
|
- The check runs once per pi session; restarting pi triggers a new check.
|
|
56
56
|
- The cache file is shared with the CLI (`agent-fleet check-update`) so both update paths benefit from a single fetch per 24h window.
|
|
57
|
-
- If the install record is *pre-versioning* (no `version:` line), the check is skipped — there's no recorded baseline to compare against. Run `/setup-agent-fleet` once to stamp the current version.
|
|
57
|
+
- If the install record is *pre-versioning* (no `version:` line), the check is skipped — there's no recorded baseline to compare against. Run `/af-setup-agent-fleet` once to stamp the current version.
|
|
58
58
|
- The extension only reads; it never writes the install record itself.
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
# btw
|
|
2
2
|
|
|
3
|
-
A pi extension that adds a single prompt command, `/btw`, plus an `Alt+'`
|
|
3
|
+
A pi extension that adds a single prompt command, `/af-btw`, plus an `Alt+'`
|
|
4
4
|
shortcut, for spinning off a **side task** that inherits the full context of the
|
|
5
5
|
current session and streams into a live modal — modeled on Claude Code's `/btw`.
|
|
6
6
|
|
|
7
7
|
## What it does
|
|
8
8
|
|
|
9
|
-
`/btw <task>` forks the current session into an **in-process sub-session** and
|
|
9
|
+
`/af-btw <task>` forks the current session into an **in-process sub-session** and
|
|
10
10
|
opens a modal over it:
|
|
11
11
|
|
|
12
12
|
1. **Forks the session** — `SessionManager.forkFrom` writes the current
|
|
@@ -28,13 +28,13 @@ opens a modal over it:
|
|
|
28
28
|
|
|
29
29
|
## Command & shortcut
|
|
30
30
|
|
|
31
|
-
- **`/btw <task>`** — start a side task and open its modal.
|
|
32
|
-
- **`/btw`** (no args) — reopen the modal on the last-viewed (or most recent) thread.
|
|
31
|
+
- **`/af-btw <task>`** — start a side task and open its modal.
|
|
32
|
+
- **`/af-btw`** (no args) — reopen the modal on the last-viewed (or most recent) thread.
|
|
33
33
|
- **`Alt+'`** — reopen the modal. (Chosen because it doesn't collide with a pi
|
|
34
34
|
composer motion the way `Alt+B` does — that's the editor's cursor-word-left. Pick
|
|
35
35
|
another binding in `index.ts` if your terminal swallows `Alt+'`.)
|
|
36
36
|
|
|
37
|
-
Once any `/btw` command or `Alt+'` has run in a session, the **agent-hub** harness
|
|
37
|
+
Once any `/af-btw` command or `Alt+'` has run in a session, the **agent-hub** harness
|
|
38
38
|
footer surfaces an `Alt+' btw` hint next to its `Alt+A view:` hint (via a
|
|
39
39
|
`globalThis.__btwActivated` flag).
|
|
40
40
|
|
|
@@ -43,13 +43,13 @@ footer surfaces an `Alt+' btw` hint next to its `Alt+A view:` hint (via a
|
|
|
43
43
|
- **Type + Enter** — send a follow-up. Mid-run it *steers* the active turn; when the
|
|
44
44
|
task is idle it starts a fresh turn.
|
|
45
45
|
- **Esc** — hide the modal. The task keeps running; you are returned to the main
|
|
46
|
-
session. Reopen with `Alt+'` or `/btw`.
|
|
46
|
+
session. Reopen with `Alt+'` or `/af-btw`.
|
|
47
47
|
- **↑ / ↓** — scroll the transcript (the selected entry expands; tail-follows the
|
|
48
48
|
newest until you scroll up).
|
|
49
49
|
- **← / →** — switch between concurrent threads (when more than one is running).
|
|
50
50
|
- **Ctrl+C** — copy the selected transcript entry.
|
|
51
51
|
|
|
52
|
-
`/btw` and `Alt+'` are the entire surface — no model-callable tool, no subcommands.
|
|
52
|
+
`/af-btw` and `Alt+'` are the entire surface — no model-callable tool, no subcommands.
|
|
53
53
|
The agent cannot trigger it; only you can.
|
|
54
54
|
|
|
55
55
|
## Design constraints (intentional)
|
|
@@ -63,7 +63,7 @@ The agent cannot trigger it; only you can.
|
|
|
63
63
|
or any other extension. No recursion, no double-bound MCP servers — the same
|
|
64
64
|
guarantee the old `--no-extensions` child gave.
|
|
65
65
|
- **Available even while the main agent is streaming.** pi executes extension
|
|
66
|
-
commands immediately in `prompt()`, *before* the streaming queue, so `/btw` never
|
|
66
|
+
commands immediately in `prompt()`, *before* the streaming queue, so `/af-btw` never
|
|
67
67
|
waits for the current turn to finish, and the modal opens right away.
|
|
68
68
|
- **Never steals the main session's focus.** The modal is a non-capturing overlay
|
|
69
69
|
that you focus on open and release on `Esc`. Task completion only fires a toast — it
|
|
@@ -104,14 +104,14 @@ packages, so no additional `npm install` is needed.
|
|
|
104
104
|
`error` toast; the transcript shows the error inline.
|
|
105
105
|
- **Shutdown.** Running threads are `abort()`ed when the main pi session shuts down —
|
|
106
106
|
side tasks do not outlive their parent.
|
|
107
|
-
- **Concurrency.** Multiple `/btw` runs can be in flight at once; the footer shows
|
|
107
|
+
- **Concurrency.** Multiple `/af-btw` runs can be in flight at once; the footer shows
|
|
108
108
|
`btw: N running` and `← / →` switches the modal between them.
|
|
109
109
|
- **Shared process group.** In-process bash from a side task competes with the main
|
|
110
110
|
session for CPU — heavy side tasks will be felt by the main turn.
|
|
111
111
|
|
|
112
112
|
## Focused smoke checklist
|
|
113
113
|
|
|
114
|
-
- Start `/btw <task>`, confirm the modal opens immediately and elapsed time counts the current turn.
|
|
114
|
+
- Start `/af-btw <task>`, confirm the modal opens immediately and elapsed time counts the current turn.
|
|
115
115
|
- Send a mid-run follow-up, confirm it steers the same turn and produces only one card.
|
|
116
116
|
- After completion, send an idle follow-up, confirm elapsed time resets and a new card is produced.
|
|
117
117
|
- Complete more than 12 side-task threads, confirm only terminal history is evicted and running threads remain.
|
|
@@ -1,15 +1,15 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* btw — in-process side tasks for pi with a live modal, modeled on Claude Code's `/btw`.
|
|
2
|
+
* btw — in-process side tasks for pi with a live modal, modeled on Claude Code's `/af-btw`.
|
|
3
3
|
*
|
|
4
|
-
* `/btw <task>` forks the CURRENT session into an in-process sub-session
|
|
4
|
+
* `/af-btw <task>` forks the CURRENT session into an in-process sub-session
|
|
5
5
|
* (`createAgentSession`) that inherits the full conversation as context, works the
|
|
6
6
|
* side task in the same cwd, and streams into a modal overlay with its own
|
|
7
7
|
* transcript + follow-up composer. A compact result card lands in the main
|
|
8
8
|
* transcript when the session next goes idle.
|
|
9
9
|
*
|
|
10
10
|
* Design constraints (all intentional — see .pi/extensions/btw/README.md):
|
|
11
|
-
* - Command-only surface. No model-callable tool, no subcommands. `/btw <task>`
|
|
12
|
-
* starts a task and opens the modal; `/btw` (no args) or `Alt+'` reopens it.
|
|
11
|
+
* - Command-only surface. No model-callable tool, no subcommands. `/af-btw <task>`
|
|
12
|
+
* starts a task and opens the modal; `/af-btw` (no args) or `Alt+'` reopens it.
|
|
13
13
|
* - In-process sub-session, NOT a child `pi` process. The fork is a real
|
|
14
14
|
* `AgentSession` with fixed built-in tools and NO extensions/custom tools (the
|
|
15
15
|
* sub-session loads no extension runtime → no recursion, mirroring the old
|
|
@@ -149,7 +149,7 @@ export default function btwExtension(pi: ExtensionAPI) {
|
|
|
149
149
|
// the modal always have a live handle after the original command returned.
|
|
150
150
|
let latestCtx: ExtensionContext | undefined;
|
|
151
151
|
// Modal lifecycle: guard against double-open, remember last-viewed thread, and
|
|
152
|
-
// expose a handle so a fresh /btw can retarget an already-open modal.
|
|
152
|
+
// expose a handle so a fresh /af-btw can retarget an already-open modal.
|
|
153
153
|
let modalOpen = false;
|
|
154
154
|
let lastViewedId: string | undefined;
|
|
155
155
|
let currentModal: CurrentModalHandle | undefined;
|
|
@@ -725,7 +725,7 @@ export default function btwExtension(pi: ExtensionAPI) {
|
|
|
725
725
|
}
|
|
726
726
|
const initial = resolveThreadId(startId, order) ?? mostRecentId();
|
|
727
727
|
if (!initial) {
|
|
728
|
-
ctx.ui.notify("No btw side tasks yet — /btw <task> to start one.", "info");
|
|
728
|
+
ctx.ui.notify("No btw side tasks yet — /af-btw <task> to start one.", "info");
|
|
729
729
|
return;
|
|
730
730
|
}
|
|
731
731
|
modalOpen = true;
|
|
@@ -758,7 +758,7 @@ export default function btwExtension(pi: ExtensionAPI) {
|
|
|
758
758
|
};
|
|
759
759
|
bindRender();
|
|
760
760
|
|
|
761
|
-
// Let a fresh /btw retarget this open modal and keep selection valid when
|
|
761
|
+
// Let a fresh /af-btw retarget this open modal and keep selection valid when
|
|
762
762
|
// retention/pruning changes the backing thread list.
|
|
763
763
|
currentModal = {
|
|
764
764
|
show: (id: string) => {
|
|
@@ -811,8 +811,8 @@ export default function btwExtension(pi: ExtensionAPI) {
|
|
|
811
811
|
}
|
|
812
812
|
}
|
|
813
813
|
|
|
814
|
-
pi.registerCommand("btw", {
|
|
815
|
-
description: "Start a side task in a live modal (full session context), or reopen the modal. Usage: /btw [task]",
|
|
814
|
+
pi.registerCommand("af-btw", {
|
|
815
|
+
description: "Start a side task in a live modal (full session context), or reopen the modal. Usage: /af-btw [task]",
|
|
816
816
|
handler: async (args: string, ctx: ExtensionCommandContext) => {
|
|
817
817
|
latestCtx = ctx;
|
|
818
818
|
markBtwActivated();
|
|
@@ -821,7 +821,7 @@ export default function btwExtension(pi: ExtensionAPI) {
|
|
|
821
821
|
if (threads.size > 0) {
|
|
822
822
|
await openModal(ctx, lastViewedId);
|
|
823
823
|
} else {
|
|
824
|
-
ctx.ui.notify("Usage: /btw <task> — runs a side task with this session's full context.", "warning");
|
|
824
|
+
ctx.ui.notify("Usage: /af-btw <task> — runs a side task with this session's full context.", "warning");
|
|
825
825
|
}
|
|
826
826
|
return;
|
|
827
827
|
}
|
|
@@ -838,7 +838,7 @@ export default function btwExtension(pi: ExtensionAPI) {
|
|
|
838
838
|
latestCtx = ctx;
|
|
839
839
|
markBtwActivated();
|
|
840
840
|
if (threads.size === 0) {
|
|
841
|
-
ctx.ui.notify("No btw side tasks yet — /btw <task> to start one.", "info");
|
|
841
|
+
ctx.ui.notify("No btw side tasks yet — /af-btw <task> to start one.", "info");
|
|
842
842
|
return;
|
|
843
843
|
}
|
|
844
844
|
await openModal(ctx, lastViewedId);
|
|
@@ -6,7 +6,7 @@ Built on top of `../mcp-bridge/` — this file is a thin wrapper that supplies C
|
|
|
6
6
|
|
|
7
7
|
## What you get
|
|
8
8
|
|
|
9
|
-
After installing, pi exposes the full Chrome DevTools MCP toolset under the `chrome_devtools__` prefix (e.g. `chrome_devtools__navigate`, `chrome_devtools__click`, etc.). A status command `/
|
|
9
|
+
After installing, pi exposes the full Chrome DevTools MCP toolset under the `chrome_devtools__` prefix (e.g. `chrome_devtools__navigate`, `chrome_devtools__click`, etc.). A status command `/af-chrome-devtools-status` reports whether the bridge connected.
|
|
10
10
|
|
|
11
11
|
This unlocks the workflow described in `skills/browser-testing-with-devtools/` for pi users.
|
|
12
12
|
|
|
@@ -46,7 +46,7 @@ ln -s /path/to/agent-fleet/.pi/extensions/chrome-devtools-mcp .pi/extensions/chr
|
|
|
46
46
|
Run `pi` from the project, then:
|
|
47
47
|
|
|
48
48
|
```
|
|
49
|
-
/
|
|
49
|
+
/af-chrome-devtools-status
|
|
50
50
|
```
|
|
51
51
|
|
|
52
52
|
Expect: `Chrome DevTools MCP connected. Registered N tool(s).`
|
|
@@ -16,13 +16,13 @@ This keeps the user in control: compaction never interrupts a tool call mid-flig
|
|
|
16
16
|
| `reason` | string | no | Short explanation recorded in tool details. |
|
|
17
17
|
| `continuationPrompt` | string | no | Self-contained summary of the remaining plan. If provided, pi auto-resumes from this message after compaction. **Do not copy the original prompt verbatim** — restate the next concrete actions. |
|
|
18
18
|
|
|
19
|
-
The tool does not ask for confirmation. Workflows that need confirmation (e.g. `/build`) must ask the user **before** calling it.
|
|
19
|
+
The tool does not ask for confirmation. Workflows that need confirmation (e.g. `/af-build`) must ask the user **before** calling it.
|
|
20
20
|
|
|
21
21
|
## When to use
|
|
22
22
|
|
|
23
23
|
Use only when explicitly requested by the user, a skill, or a prompt template. Do not call it pre-emptively or on a hunch that context is "getting long" — pi has its own autocompaction for that.
|
|
24
24
|
|
|
25
|
-
The canonical usage point in this repo is `/build`: at slice-approval time, the user can pick "Compact & continue" to compact between slices and resume from a summarized remaining plan. See `.pi/prompts/build.md` and `skills/incremental-implementation/SKILL.md`.
|
|
25
|
+
The canonical usage point in this repo is `/af-build`: at slice-approval time, the user can pick "Compact & continue" to compact between slices and resume from a summarized remaining plan. See `.pi/prompts/af-build.md` and `skills/incremental-implementation/SKILL.md`.
|
|
26
26
|
|
|
27
27
|
## Install
|
|
28
28
|
|
|
@@ -19,15 +19,15 @@ dependency and no build step — pi loads the TypeScript directly.
|
|
|
19
19
|
| **Alt+S** | Start recording; press again to **transcribe and insert** into the prompt |
|
|
20
20
|
| **Enter** (while recording) | Transcribe and **send** immediately |
|
|
21
21
|
| **Esc** (while recording) | Cancel — discard the recording |
|
|
22
|
-
| `/stt status` | Show config + current state |
|
|
23
|
-
| `/stt doctor` | Check `ffmpeg`, provider, and API key |
|
|
24
|
-
| `/stt start` · `stop` · `send` · `cancel` | Drive the state machine without the hotkey |
|
|
22
|
+
| `/af-stt status` | Show config + current state |
|
|
23
|
+
| `/af-stt doctor` | Check `ffmpeg`, provider, and API key |
|
|
24
|
+
| `/af-stt start` · `stop` · `send` · `cancel` | Drive the state machine without the hotkey |
|
|
25
25
|
|
|
26
26
|
While recording, a `● REC m:ss` indicator animates in the status bar; during transcription
|
|
27
27
|
it shows a moving `transcribing…` dot.
|
|
28
28
|
|
|
29
29
|
> The hotkey is bound **only when a provider is configured**. Until then the extension is a
|
|
30
|
-
> silent no-op — `/stt doctor` still works to guide setup.
|
|
30
|
+
> silent no-op — `/af-stt doctor` still works to guide setup.
|
|
31
31
|
|
|
32
32
|
## Requirements
|
|
33
33
|
|
|
@@ -48,7 +48,7 @@ key is read from the process environment — a gitignored `.env` at the repo roo
|
|
|
48
48
|
the `justfile`'s `dotenv-load`. See [`examples/stt.json`](examples/stt.json).
|
|
49
49
|
|
|
50
50
|
> **Guided setup** can write the `.ai/stt.json` + `.env` for you — pick `pi-voice-stt` in
|
|
51
|
-
> `/setup-agent-fleet` and answer the provider prompts. See
|
|
51
|
+
> `/af-setup-agent-fleet` and answer the provider prompts. See
|
|
52
52
|
> [docs/agent-fleet-setup.md](../../../docs/agent-fleet-setup.md).
|
|
53
53
|
|
|
54
54
|
### Option 1 — Generic OpenAI-compatible endpoint
|
|
@@ -97,7 +97,7 @@ export AZURE_SPEECH_KEY="<your-resource-key>"
|
|
|
97
97
|
```
|
|
98
98
|
|
|
99
99
|
The request posts the WAV to
|
|
100
|
-
`{endpoint}/stt/speech/recognition/conversation/cognitiveservices/v1?language=<lang>&format=<format>`
|
|
100
|
+
`{endpoint}/af-stt/speech/recognition/conversation/cognitiveservices/v1?language=<lang>&format=<format>`
|
|
101
101
|
with the `Ocp-Apim-Subscription-Key` header. `format: "detailed"` returns the best
|
|
102
102
|
`NBest[0].Display`; `"simple"` returns `DisplayText`.
|
|
103
103
|
|
|
@@ -178,7 +178,7 @@ can be raised.
|
|
|
178
178
|
|
|
179
179
|
## Troubleshooting
|
|
180
180
|
|
|
181
|
-
- **`/stt doctor` says ffmpeg not found** — install ffmpeg or set `capture.ffmpegPath`.
|
|
181
|
+
- **`/af-stt doctor` says ffmpeg not found** — install ffmpeg or set `capture.ffmpegPath`.
|
|
182
182
|
- **Linux: no audio** — ensure PulseAudio/PipeWire is running; try `capture.input` of a
|
|
183
183
|
specific source name from `pactl list sources short`.
|
|
184
184
|
- **Azure `NoMatch`** — the spoken language doesn't match `language`; fix the locale.
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
// Press Alt+S to start recording, Alt+S again to transcribe and insert the text
|
|
4
4
|
// into the prompt. While recording, Enter transcribes and sends immediately, and
|
|
5
5
|
// Esc cancels. The extension is a silent no-op until a provider is configured —
|
|
6
|
-
// see README.md and `/stt doctor`.
|
|
6
|
+
// see README.md and `/af-stt doctor`.
|
|
7
7
|
|
|
8
8
|
import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext } from "@mariozechner/pi-coding-agent";
|
|
9
9
|
import { matchesKey } from "@mariozechner/pi-tui";
|
|
@@ -67,7 +67,7 @@ export default function voiceSttExtension(pi: ExtensionAPI): void {
|
|
|
67
67
|
function startRecording(ctx: ExtensionContext): void {
|
|
68
68
|
if (state !== "idle") return;
|
|
69
69
|
if (!isConfigured(config)) {
|
|
70
|
-
ctx.ui.notify("Voice STT is not configured — run /stt doctor for setup help.", "warning");
|
|
70
|
+
ctx.ui.notify("Voice STT is not configured — run /af-stt doctor for setup help.", "warning");
|
|
71
71
|
return;
|
|
72
72
|
}
|
|
73
73
|
|
|
@@ -142,7 +142,7 @@ export default function voiceSttExtension(pi: ExtensionAPI): void {
|
|
|
142
142
|
|
|
143
143
|
// ---- commands ----------------------------------------------------------
|
|
144
144
|
|
|
145
|
-
pi.registerCommand("stt", {
|
|
145
|
+
pi.registerCommand("af-stt", {
|
|
146
146
|
description: "Voice dictation: status | doctor | start | stop | send | cancel",
|
|
147
147
|
handler: async (args: string, ctx: ExtensionCommandContext) => {
|
|
148
148
|
const sub = args.trim().split(/\s+/)[0]?.toLowerCase() || "status";
|
|
@@ -167,7 +167,7 @@ export default function voiceSttExtension(pi: ExtensionAPI): void {
|
|
|
167
167
|
else cancel(ctx);
|
|
168
168
|
return;
|
|
169
169
|
default:
|
|
170
|
-
ctx.ui.notify(`Unknown /stt subcommand: ${sub}`, "warning");
|
|
170
|
+
ctx.ui.notify(`Unknown /af-stt subcommand: ${sub}`, "warning");
|
|
171
171
|
}
|
|
172
172
|
},
|
|
173
173
|
});
|
|
@@ -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
|
|
@@ -87,7 +87,7 @@ Every borrowed idea from another harness passes one test before it lands: *does
|
|
|
87
87
|
to `.pi/agent-sessions/artifacts/returns/<agentKey>-run<N>.md`, surfaces only a compact
|
|
88
88
|
`details.structuredReturn` digest plus `details.returnPath`, and marks contract notices such as
|
|
89
89
|
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
|
|
90
|
+
tool text). `details.fullOutput` remains for `/af-zoom`/compatibility, but dispatcher-visible text is
|
|
91
91
|
digest + path oriented. `update_assertion(status: "proven")` validates evidence by assertion tag:
|
|
92
92
|
test evidence needs a command/test and outcome, `code-grep` needs pattern plus result sample,
|
|
93
93
|
manual needs user/`ask_user` confirmation, and `runtime-ui` needs an existing artifact path under
|
|
@@ -114,49 +114,49 @@ Every borrowed idea from another harness passes one test before it lands: *does
|
|
|
114
114
|
notice. This is advisory only: the hub never blocks completion, reverts files, or escalates
|
|
115
115
|
automatically. Known limitation: concurrent writable dispatches can only be attributed
|
|
116
116
|
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
|
|
117
|
+
- **Agent controls** — `/af-zoom` inspects a live agent timeline; `/af-agents-history` replays the run as a
|
|
118
118
|
timeline (orchestrator turns, dispatches, research helpers) with per-agent durations, parallel-run
|
|
119
119
|
markers, and a grand total; kill/restart controls manage running child agents; per-agent `model:`
|
|
120
120
|
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
|
|
121
|
+
team specialists by persona name, research helpers by `rN` handle (mirroring `/af-zoom`):
|
|
122
|
+
`/af-agents-kill <name|rN|all>` SIGTERMs a specialist (keeping its standing card), while on a
|
|
123
123
|
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`.
|
|
124
|
+
(`all` clears every helper); `/af-agents-restart <name|rN>` re-runs the last task fresh (a research
|
|
125
|
+
helper must be finished first); `/af-agents-cont rN <prompt>` resumes a finished helper's session.
|
|
126
|
+
The old `/af-research-rm` and `/af-research-clear` spellings remain as aliases of the kill semantics,
|
|
127
|
+
`/af-research-cont` of `/af-agents-cont`.
|
|
128
128
|
Restartable team specialists at or above 70% context render
|
|
129
129
|
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,
|
|
130
|
+
`dispatch_agent` result adds a `/af-agents-restart <persona>` hint. Research helpers are not warned,
|
|
131
131
|
and the hub never restarts specialists automatically.
|
|
132
132
|
- **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;
|
|
133
|
+
(the default `model:` is implicitly a candidate). `/af-agent-model <persona>` picks from that list;
|
|
134
134
|
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
|
|
135
|
+
(`/af-agents-restart <persona>` applies it immediately). The dot form
|
|
136
|
+
`/af-agent-model <persona>.<role>` switches a delegate sub-role's model instead — its candidates are
|
|
137
137
|
the role's declared default plus the parent persona's own candidate list; the switch is applied
|
|
138
138
|
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
|
|
139
|
+
children inherit it). `/af-models [profile]` applies a named profile
|
|
140
140
|
from `.pi/agents/model-profiles.yaml` — a macro over the same declared candidates, validated at
|
|
141
141
|
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
|
|
142
|
+
error); profiles never touch sub-role models — only `/af-agent-model` reaches those. Nothing
|
|
143
143
|
outside the declared lists is ever selectable. Per project,
|
|
144
144
|
`model.<persona>:` / `models.<persona>:` keys under `## agent-hub` in
|
|
145
145
|
`.ai/agent-fleet-overrides.md` replace a persona's default model / candidate list.
|
|
146
146
|
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
|
|
147
|
+
way — `/af-agent-model <persona>` and `/af-agent-model-thinking <persona>` accept them alongside team
|
|
148
|
+
members. Since research helpers are spawned fresh on each `/af-research` / `spawn_research`, the
|
|
149
|
+
switch lands on their next spawn (there is no running instance to `/af-agents-restart`).
|
|
150
|
+
`/af-agent-models-substitute <source> <target>` is the global one-shot form: walks every loaded
|
|
151
151
|
persona (team + research + orchestrator), and for each whose **current effective model** is
|
|
152
152
|
`<source>` and whose declared candidates include `<target>`, sets the session override to
|
|
153
153
|
`<target>`. One-step flow — the dry-run summary (affected vs skipped, with reasons) is shown
|
|
154
154
|
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.
|
|
155
|
+
(`/af-agents-restart` to apply now). It never touches the dispatcher or delegate sub-roles.
|
|
156
156
|
- **Thinking levels** — each persona's frontmatter `thinking:` sets its pi `--thinking`
|
|
157
|
-
reasoning effort (`off` · `minimal` · `low` · `medium` · `high` · `xhigh`). `/agent-model-thinking
|
|
157
|
+
reasoning effort (`off` · `minimal` · `low` · `medium` · `high` · `xhigh`). `/af-agent-model-thinking
|
|
158
158
|
<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
|
|
159
|
+
on the persona's next dispatch (`/af-agents-restart <persona>` applies it now), and selecting the
|
|
160
160
|
frontmatter default clears the override. The level shows as a short badge after the model
|
|
161
161
|
everywhere a model is rendered — `gpt-5.5 (xh)` in the dashboard cards and the compact below-editor
|
|
162
162
|
view (`min`/`low`/`med`/`hi`/`xh`; `off` shows no badge). Per project, a `thinking.<persona>:` key
|
|
@@ -175,13 +175,13 @@ Every borrowed idea from another harness passes one test before it lands: *does
|
|
|
175
175
|
Concurrent children are always forced read-only. Children stream timeline events through
|
|
176
176
|
`.pi/agent-sessions/delegations/<persona>/events.jsonl`; the hub tails it and renders nested rows
|
|
177
177
|
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
|
|
178
|
+
each openable with `/af-zoom <child-id>`. Each child also writes its full final output to
|
|
179
179
|
`.pi/agent-sessions/delegations/<persona>/results/<childId>.md`; the parent receives only status,
|
|
180
180
|
a required final `DIGEST:` section (≤30 lines with path:line citations), and the result-file path.
|
|
181
181
|
If a child omits `DIGEST:`, the parent gets the first ~30 lines plus a no-DIGEST warning and the
|
|
182
182
|
result path. Spend rolls up: every child row and the parent's subtree
|
|
183
183
|
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
|
|
184
|
+
`/af-agents-kill` on the parent SIGTERMs its whole process group, so the delegation tree dies with
|
|
185
185
|
it. `context: fork` is accepted but treated as a summary brief in v1. Per project,
|
|
186
186
|
`subagents.<persona>.<role>:` and `delegate-depth.<persona>:` keys under `## agent-hub` in
|
|
187
187
|
`.ai/agent-fleet-overrides.md` replace individual sub-roles / the depth budget. Six personas
|
|
@@ -217,14 +217,14 @@ Every borrowed idea from another harness passes one test before it lands: *does
|
|
|
217
217
|
`agent-hub` (or plain `coms`) sessions on the same box find each other through per-project registry
|
|
218
218
|
files and exchange messages over a unix socket (named pipe on Windows).
|
|
219
219
|
|
|
220
|
-
Inherited `/zoom` behavior in this harness expands the latest event by default. Use `Space` or
|
|
220
|
+
Inherited `/af-zoom` behavior in this harness expands the latest event by default. Use `Space` or
|
|
221
221
|
`Ctrl+C` to copy the selected row content, and `Q` or `Esc` to close the overlay. The overlay sizes
|
|
222
222
|
to the terminal and keeps the selected (and last) entry fully visible while you navigate with
|
|
223
223
|
`↑/↓`.
|
|
224
224
|
|
|
225
|
-
### `/agents-history`
|
|
225
|
+
### `/af-agents-history`
|
|
226
226
|
|
|
227
|
-
`/agents-history` opens a read-only overlay (same chrome as `/zoom`) that replays the session as an
|
|
227
|
+
`/af-agents-history` opens a read-only overlay (same chrome as `/af-zoom`) that replays the session as an
|
|
228
228
|
execution **tree**:
|
|
229
229
|
|
|
230
230
|
- **Orchestrator turns** — each dispatcher turn that actually dispatched something is a depth-0 row
|
|
@@ -286,11 +286,11 @@ the single model line. Press **`Alt+S`** to start/stop dictation as in a normal
|
|
|
286
286
|
|
|
287
287
|
In **compact view**, the running-subagents list below the input doubles as a switcher. **`Alt+]`**
|
|
288
288
|
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
|
|
289
|
+
opens the read-only `/af-zoom` overlay on the marked one (`Q`/`Esc` to close). This only changes what
|
|
290
290
|
you *view* — **the input box always prompts the main session**, and `main` is never a marker target
|
|
291
291
|
(it is the session under the input, not a subagent). There is no transcript takeover: a subagent's
|
|
292
292
|
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).
|
|
293
|
+
are inert in dashboard mode (use `/af-zoom <name>` there).
|
|
294
294
|
|
|
295
295
|
> Terminal note: `Alt+[` emits `ESC [` (a CSI prefix) and may be swallowed by some terminals'
|
|
296
296
|
> escape parsers; `Alt+]` and `Alt+\` are the reliable pair. `Alt+↑/↓/←/→` are reserved by the pi
|
|
@@ -400,7 +400,7 @@ task, most of it re-billed stale specialist context).
|
|
|
400
400
|
|
|
401
401
|
When a budget is exhausted, `dispatch_agent`/`spawn_research` **refuse** with instructions
|
|
402
402
|
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);
|
|
403
|
+
live with `/af-hub-mode fast|standard|strict` (no argument shows the current mode and usage);
|
|
404
404
|
set the project default and per-axis overrides in the overrides file:
|
|
405
405
|
|
|
406
406
|
```markdown
|
|
@@ -437,7 +437,7 @@ The system prompt ties the tier to the anti-over-engineering rules: a provided p
|
|
|
437
437
|
spec (no re-planning), assertions stay ≤3 for trivial/small asks, and "using every persona"
|
|
438
438
|
is called out as a smell. Two hygiene guards are enforced in code, not prose: a
|
|
439
439
|
**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`.
|
|
440
|
+
task inside one turn, and every budget/duplicate refusal is counted in `/af-hub-report`.
|
|
441
441
|
|
|
442
442
|
### Drift watchdog (in-flight observation)
|
|
443
443
|
|
|
@@ -456,8 +456,8 @@ drives the cards — not post-hoc:
|
|
|
456
456
|
corrected, narrowed task — never the same task unchanged.
|
|
457
457
|
|
|
458
458
|
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
|
|
459
|
+
single `dispatch_agent` call → a per-agent override (`/af-watchdog builder on|off|clear`) →
|
|
460
|
+
the hub-wide setting (`/af-watchdog on|off|auto`, default `auto`, project default via the
|
|
461
461
|
`watchdog:` overrides key). Read-only research helpers are not monitored — they already
|
|
462
462
|
run under the per-tool watchdog + turn deadline and cannot write.
|
|
463
463
|
|
|
@@ -465,15 +465,15 @@ run under the per-tool watchdog + turn deadline and cannot write.
|
|
|
465
465
|
|
|
466
466
|
Rosters start from `.pi/agents/teams.yaml` but are not frozen there:
|
|
467
467
|
|
|
468
|
-
- `/agents-add <persona>…` / `/agents-drop <persona>…` — restructure the ACTIVE team
|
|
468
|
+
- `/af-agents-add <persona>…` / `/af-agents-drop <persona>…` — restructure the ACTIVE team
|
|
469
469
|
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
|
|
470
|
+
- `/af-agents-save <name>` — persist the current roster as a named team back into
|
|
471
471
|
`teams.yaml` (targeted block upsert; comments and other teams untouched).
|
|
472
472
|
- `team_adjust` — the dispatcher itself may add/drop a persona **with a stated reason**;
|
|
473
473
|
disabled in fast mode, capped at 8 roster members, and every change is notified to the
|
|
474
474
|
human. The system prompt is rebuilt each turn, so changes take effect immediately.
|
|
475
475
|
|
|
476
|
-
### `/hub-report`
|
|
476
|
+
### `/af-hub-report`
|
|
477
477
|
|
|
478
478
|
Per-turn cost accounting: dispatches (agent, status, elapsed, billed/output tokens),
|
|
479
479
|
research runs, session recycles, drift stops, and budget/duplicate refusals — for the
|
|
@@ -529,19 +529,19 @@ Each session registers a coms identity at start-up, resolved in this precedence
|
|
|
529
529
|
|
|
530
530
|
Names are de-duplicated per project (`resolveUniqueName`), so two hubs that both want `architect`
|
|
531
531
|
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`
|
|
532
|
+
pool by default, so it is neither listed nor reachable until a human opts in with `/af-coms --all`
|
|
533
533
|
(see [Pool scope is the reach boundary](#pool-scope-is-the-reach-boundary)). The registry lives
|
|
534
534
|
under `~/.pi/coms/projects/<project>/agents/<name>.json` and is created at runtime.
|
|
535
535
|
|
|
536
536
|
### Commands & tools (local dispatcher plus coms)
|
|
537
537
|
|
|
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
|
|
538
|
+
- `/af-coms` — coms control surface (peer list / status)
|
|
539
|
+
- `/af-handoff <peer>` — hand the whole session off to a coms peer (see [Handoff](#handoff))
|
|
540
|
+
- `/af-compound [focus]` — end-of-session **compound-learning pass**: the dispatcher composes a
|
|
541
541
|
candidate-lessons brief from the session (corrections, recurring findings, root causes),
|
|
542
542
|
confirms it with the user, then dispatches the `documenter` to land the approved lessons as
|
|
543
543
|
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.
|
|
544
|
+
Requires the `documenter` persona in the active team; run it before `/af-handoff` or session end.
|
|
545
545
|
- `coms_list` — discover the peers in your pool: names, models, live context usage, purpose. Scoped
|
|
546
546
|
to your project and excluding private peers; the LLM cannot widen it (see
|
|
547
547
|
[Pool scope is the reach boundary](#pool-scope-is-the-reach-boundary)).
|
|
@@ -550,19 +550,19 @@ under `~/.pi/coms/projects/<project>/agents/<name>.json` and is created at runti
|
|
|
550
550
|
`PI_COMS_TIMEOUT_MS`)
|
|
551
551
|
- `coms_get` — **non-blocking** poll of a `msg_id` (status `pending|complete|error`)
|
|
552
552
|
|
|
553
|
-
`/coms` and `/handoff` tab-complete live peer names **in your pool**.
|
|
553
|
+
`/af-coms` and `/af-handoff` tab-complete live peer names **in your pool**.
|
|
554
554
|
|
|
555
555
|
### Pool scope is the reach boundary
|
|
556
556
|
|
|
557
557
|
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
|
|
558
|
+
is in your pool.** `coms_list`, `coms_send`, and `/af-handoff` all resolve targets through the same
|
|
559
559
|
`peersInScope()` helper, so the dispatcher can never message a peer it cannot see. Two knobs define
|
|
560
560
|
the pool, and **both are human-only** — the LLM cannot widen scope to reach more peers:
|
|
561
561
|
|
|
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
|
|
562
|
+
- **Project** — defaults to your own `identity.project`. A human can retarget with `/af-coms --project
|
|
563
|
+
<name>` (one project) or `/af-coms --all` (every project). `coms_list`'s own parameters cannot
|
|
564
564
|
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.
|
|
565
|
+
- **Explicit (private) peers** — excluded from every pool by default. `/af-coms --all` opts them in.
|
|
566
566
|
|
|
567
567
|
This closes a cross-project leak where a peer reachable through the mesh was *not* shown in the
|
|
568
568
|
default project-scoped pool — so it could be messaged without being "connected." Now the reachable
|
|
@@ -614,12 +614,12 @@ Semantics:
|
|
|
614
614
|
- **Standing context is the point.** Re-dispatches (ASK_USER answers, research resumes) go back to
|
|
615
615
|
the same peer session, so a Claude Code reviewer keeps its review context across rounds.
|
|
616
616
|
- **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
|
|
617
|
+
annotated `(coms)`, and `/af-dispatch-policy` prints the resolved routing per member with live-peer
|
|
618
618
|
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 —
|
|
619
|
+
- **Limitations.** `/af-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 (`/af-agents-restart` abandons, then
|
|
621
|
+
re-dispatches). `/af-zoom` shows only the final reply (there is no stream), tool counts stay 0, and
|
|
622
|
+
context% is a registry snapshot. `/af-agent-model` overrides apply only to native(-fallback) runs —
|
|
623
623
|
the peer's model is set in `peers.yaml`.
|
|
624
624
|
|
|
625
625
|
Missing file = everything native. HOW a peer runs (persona, model, `runner: claude-code`, env) stays
|
|
@@ -627,7 +627,7 @@ in `peers.yaml`; this file only decides WHEN the hub prefers a peer over a nativ
|
|
|
627
627
|
|
|
628
628
|
### Handoff
|
|
629
629
|
|
|
630
|
-
`/handoff <peer>` transfers the session to another **main** agent. Following the plan's
|
|
630
|
+
`/af-handoff <peer>` transfers the session to another **main** agent. Following the plan's
|
|
631
631
|
**decision G1**, it does *not* try to extract a compaction summary; instead it asks the dispatcher
|
|
632
632
|
LLM to compose a **self-contained brief** ("everything the target needs, assume no shared history"),
|
|
633
633
|
then `coms_send`s that brief to the peer, `coms_await`s the reply, and relays it back — in the
|
|
@@ -636,7 +636,7 @@ sections after the LLM brief: `## Verification ledger (verbatim, machine-appende
|
|
|
636
636
|
assertion in canonical ledger form, and `## Artifact index` with artifact paths plus first headings.
|
|
637
637
|
The target peer must treat the machine-appended ledger as the contract, not the paraphrased brief.
|
|
638
638
|
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
|
|
639
|
+
aren't portable between live agents). The target must be a peer in your pool — `/af-handoff` resolves
|
|
640
640
|
through the same [scope boundary](#pool-scope-is-the-reach-boundary) as `coms_send`, so you cannot
|
|
641
641
|
hand a session to a peer you cannot see.
|
|
642
642
|
|
|
@@ -652,13 +652,13 @@ The dispatcher persona gate fires *after* coms init, so the identity's `purpose`
|
|
|
652
652
|
flag/frontmatter/default and is then reconciled to the chosen persona: `syncComsPurpose()` maps the
|
|
653
653
|
selected `kind: orchestrator` persona to `"<Name> — <description>"` and re-writes the live registry
|
|
654
654
|
entry — **unless** `--purpose` was passed explicitly (an explicit flag always wins). Switching or
|
|
655
|
-
resetting the persona via `/persona` re-syncs.
|
|
655
|
+
resetting the persona via `/af-persona` re-syncs.
|
|
656
656
|
|
|
657
657
|
### Graceful degradation
|
|
658
658
|
|
|
659
659
|
If the coms socket can't bind at start-up (`comsReady` stays `false`), the session degrades to a
|
|
660
660
|
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.
|
|
661
|
+
`/af-handoff` command refuses with a notice, and the "Peer agents (coms)" prompt section is omitted.
|
|
662
662
|
Orchestration, research helpers, and the grid keep working.
|
|
663
663
|
|
|
664
664
|
### Tool surface
|
|
@@ -793,6 +793,6 @@ coms purpose/color.
|
|
|
793
793
|
`spawn_research` (+ `ask_user`); the system prompt gains a "Peer agents (coms)" section when coms
|
|
794
794
|
is ready. The persona's `description` drives the coms `purpose` (decision 6 / Phase 6 peer
|
|
795
795
|
mapping) instead of a static `--purpose`.
|
|
796
|
-
- **`/handoff` uses an LLM-composed brief**, not a compaction-summary extraction (decision G1).
|
|
796
|
+
- **`/af-handoff` uses an LLM-composed brief**, not a compaction-summary extraction (decision G1).
|
|
797
797
|
- **Clean shutdown** SIGTERMs any running specialist/research children, clears the coms pool
|
|
798
798
|
widget, and removes the registry entry on `session_shutdown` / SIGINT / SIGTERM.
|
|
@@ -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
|
}
|