@chankov/agent-fleet 0.0.3 → 0.0.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/commands/set-hermes-telegram.md +15 -0
- package/.claude/commands/setup-agent-fleet.md +1 -1
- package/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.opencode/commands/af-setup-agent-fleet.md +1 -1
- package/.pi/agents/dispatch-policy.yaml +1 -1
- package/.pi/agents/peers.yaml +4 -4
- package/.pi/extensions/chrome-devtools-mcp/README.md +1 -1
- package/.pi/extensions/mcp-bridge/README.md +1 -1
- package/.pi/harnesses/agent-hub/README.md +223 -40
- package/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.pi/harnesses/agent-hub/delegate.ts +32 -9
- package/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
- package/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.pi/harnesses/agent-hub/helpers.ts +49 -0
- package/.pi/harnesses/agent-hub/index.ts +1037 -246
- package/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
- package/.pi/harnesses/agent-hub/package.json +5 -4
- package/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.pi/harnesses/agent-hub/run-budget.js +155 -0
- package/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.pi/harnesses/agent-hub/spawn.ts +161 -94
- package/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.pi/harnesses/ask-user-remote/README.md +1 -0
- package/.pi/harnesses/ask-user-remote/index.ts +36 -8
- package/.pi/harnesses/coms/README.md +15 -5
- package/.pi/harnesses/coms/index.ts +2 -0
- package/.pi/harnesses/coms/package.json +5 -4
- package/.pi/harnesses/coms/version.ts +18 -0
- package/.pi/harnesses/damage-control-continue/README.md +36 -35
- package/.pi/harnesses/damage-control-continue/index.ts +23 -9
- package/.pi/harnesses/damage-control-continue/package.json +5 -4
- package/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.pi/harnesses/{damage-control/shared.ts → lib/damage-control-shared.ts} +20 -6
- package/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
- package/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.pi/prompts/set-hermes-telegram.md +15 -0
- package/.pi/prompts/setup-agent-fleet.md +1 -1
- package/.versions/0.0.4/.claude/commands/build.md +44 -0
- package/.versions/0.0.4/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.4/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.4/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.4/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.4/.claude/commands/plan.md +16 -0
- package/.versions/0.0.4/.claude/commands/prime.md +22 -0
- package/.versions/0.0.4/.claude/commands/review.md +16 -0
- package/.versions/0.0.4/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.4/.claude/commands/ship.md +72 -0
- package/.versions/0.0.4/.claude/commands/spec.md +15 -0
- package/.versions/0.0.4/.claude/commands/test.md +19 -0
- package/.versions/0.0.4/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.4/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.4/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.4/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.4/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.4/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.4/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.4/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.4/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.4/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.4/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.4/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.4/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.4/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.4/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.4/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.4/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.4/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.4/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.4/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.4/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.4/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.4/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.4/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/{.pi/harnesses/damage-control → .versions/0.0.4/.pi/extensions/agent-fleet-update-check}/package.json +1 -1
- package/.versions/0.0.4/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.4/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.4/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.4/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
- package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.4/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.4/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.4/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.4/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.4/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.4/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.4/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.4/.pi/extensions/package.json +9 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/README.md +798 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/delegate.ts +386 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/helpers.ts +214 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/index.ts +8045 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/run-budget.js +155 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/spawn.ts +246 -0
- package/.versions/0.0.4/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.4/.pi/harnesses/ask-user-remote/README.md +18 -0
- package/.versions/0.0.4/.pi/harnesses/ask-user-remote/index.ts +293 -0
- package/.versions/0.0.4/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.4/.pi/harnesses/coms/README.md +92 -0
- package/.versions/0.0.4/.pi/harnesses/coms/index.ts +1745 -0
- package/.versions/0.0.4/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.4/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.4/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.4/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.4/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.4/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.4/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.4/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.versions/0.0.4/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.versions/0.0.4/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.4/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.4/.pi/prompts/build.md +24 -0
- package/.versions/0.0.4/.pi/prompts/code-simplify.md +22 -0
- package/.versions/0.0.4/.pi/prompts/doctor-agent-fleet.md +15 -0
- package/.versions/0.0.4/.pi/prompts/plan.md +16 -0
- package/.versions/0.0.4/.pi/prompts/review.md +16 -0
- package/.versions/0.0.4/.pi/prompts/setup-agent-fleet.md +27 -0
- package/.versions/0.0.4/.pi/prompts/ship.md +17 -0
- package/.versions/0.0.4/.pi/prompts/spec.md +15 -0
- package/.versions/0.0.4/.pi/prompts/test.md +19 -0
- package/.versions/0.0.4/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.4/.version +1 -0
- package/.versions/0.0.4/agents/architect.md +23 -0
- package/.versions/0.0.4/agents/bowser.md +26 -0
- package/.versions/0.0.4/agents/builder.md +53 -0
- package/.versions/0.0.4/agents/code-reviewer.md +205 -0
- package/.versions/0.0.4/agents/deep-researcher.md +31 -0
- package/.versions/0.0.4/agents/documenter.md +18 -0
- package/.versions/0.0.4/agents/orchestrator.md +54 -0
- package/.versions/0.0.4/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.4/agents/planner.md +69 -0
- package/.versions/0.0.4/agents/releaser.md +24 -0
- package/.versions/0.0.4/agents/researcher.md +28 -0
- package/.versions/0.0.4/agents/security-auditor.md +166 -0
- package/.versions/0.0.4/agents/test-engineer.md +151 -0
- package/.versions/0.0.4/agents/web-debugger.md +42 -0
- package/.versions/0.0.4/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.4/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.4/docs/ARCHITECTURE.md +210 -0
- package/.versions/0.0.4/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.4/docs/claude-code-coms-bridge.md +103 -0
- package/.versions/0.0.4/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.4/docs/coms-hermes-bridge.md +121 -0
- package/.versions/0.0.4/docs/getting-started.md +183 -0
- package/.versions/0.0.4/docs/npm-install.md +337 -0
- package/.versions/0.0.4/docs/opencode-setup.md +248 -0
- package/.versions/0.0.4/docs/pi-extensions.md +288 -0
- package/.versions/0.0.4/docs/pi-setup.md +463 -0
- package/.versions/0.0.4/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.4/hermes/README.md +228 -0
- package/.versions/0.0.4/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.4/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
- package/.versions/0.0.4/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.4/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.4/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.4/hooks/coms-stop-hook.mjs +73 -0
- package/.versions/0.0.4/hooks/hooks.json +14 -0
- package/.versions/0.0.4/hooks/session-start.sh +74 -0
- package/.versions/0.0.4/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.4/justfile +256 -0
- package/.versions/0.0.4/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.4/references/definition-of-done.md +67 -0
- package/.versions/0.0.4/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.4/references/observability-checklist.md +91 -0
- package/.versions/0.0.4/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.4/references/performance-checklist.md +153 -0
- package/.versions/0.0.4/references/prompting-patterns.md +380 -0
- package/.versions/0.0.4/references/security-checklist.md +179 -0
- package/.versions/0.0.4/references/testing-patterns.md +236 -0
- package/.versions/0.0.4/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.4/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.4/scripts/coms-claude-bridge.ts +286 -0
- package/.versions/0.0.4/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.4/scripts/coms-hermes-bridge.ts +403 -0
- package/.versions/0.0.4/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.4/scripts/hermes-monitor-scenario.ts +7 -0
- package/.versions/0.0.4/scripts/lib/claude-bridge-core.ts +100 -0
- package/.versions/0.0.4/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.4/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.4/scripts/lib/coms-envelope.ts +539 -0
- package/.versions/0.0.4/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.4/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.4/scripts/lib/hermes-bridge-core.ts +238 -0
- package/.versions/0.0.4/scripts/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.4/scripts/lib/hermes-monitor-model.ts +9 -0
- package/.versions/0.0.4/scripts/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.4/scripts/lib/hermes-monitor-socket.ts +118 -0
- package/.versions/0.0.4/scripts/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.4/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.4/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.4/scripts/lib/team-project.ts +184 -0
- package/.versions/0.0.4/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.4/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.4/scripts/team-snapshot.ts +238 -0
- package/.versions/0.0.4/scripts/team-up.ts +333 -0
- package/.versions/0.0.4/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.4/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.4/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.4/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.4/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.4/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.4/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.4/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.4/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.4/skills/guided-workspace-setup/SKILL.md +535 -0
- package/.versions/0.0.4/skills/guided-workspace-setup/companion-manifest.json +33 -0
- package/.versions/0.0.4/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.4/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.4/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.4/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.4/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.4/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.4/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.4/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.4/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.4/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.4/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.4/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.4/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.4/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/.versions/0.0.5/.claude/commands/build.md +44 -0
- package/.versions/0.0.5/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.5/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.5/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.5/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.5/.claude/commands/plan.md +16 -0
- package/.versions/0.0.5/.claude/commands/prime.md +22 -0
- package/.versions/0.0.5/.claude/commands/review.md +16 -0
- package/.versions/0.0.5/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.5/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.5/.claude/commands/ship.md +72 -0
- package/.versions/0.0.5/.claude/commands/spec.md +15 -0
- package/.versions/0.0.5/.claude/commands/test.md +19 -0
- package/.versions/0.0.5/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.5/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.5/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.5/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.5/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.5/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.5/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.5/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.5/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.5/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.5/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.5/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.5/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.5/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.5/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.5/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.5/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.5/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.5/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.5/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.5/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.5/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.5/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.5/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.5/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
- package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.5/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.5/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.5/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.5/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.5/.pi/extensions/package.json +9 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.5/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/README.md +798 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/delegate.ts +386 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/helpers.ts +214 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/index.ts +8045 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/run-budget.js +155 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/spawn.ts +246 -0
- package/.versions/0.0.5/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.5/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.5/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.5/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.5/.pi/harnesses/coms/README.md +92 -0
- package/.versions/0.0.5/.pi/harnesses/coms/index.ts +1745 -0
- package/.versions/0.0.5/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.5/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.5/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.5/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.5/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.5/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.5/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.5/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.versions/0.0.5/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
- package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.5/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.5/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.5/.pi/prompts/build.md +24 -0
- package/.versions/0.0.5/.pi/prompts/code-simplify.md +22 -0
- package/.versions/0.0.5/.pi/prompts/doctor-agent-fleet.md +15 -0
- package/.versions/0.0.5/.pi/prompts/plan.md +16 -0
- package/.versions/0.0.5/.pi/prompts/review.md +16 -0
- package/.versions/0.0.5/.pi/prompts/set-hermes-telegram.md +15 -0
- package/.versions/0.0.5/.pi/prompts/setup-agent-fleet.md +27 -0
- package/.versions/0.0.5/.pi/prompts/ship.md +17 -0
- package/.versions/0.0.5/.pi/prompts/spec.md +15 -0
- package/.versions/0.0.5/.pi/prompts/test.md +19 -0
- package/.versions/0.0.5/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.5/.version +1 -0
- package/.versions/0.0.5/agents/architect.md +23 -0
- package/.versions/0.0.5/agents/bowser.md +26 -0
- package/.versions/0.0.5/agents/builder.md +53 -0
- package/.versions/0.0.5/agents/code-reviewer.md +205 -0
- package/.versions/0.0.5/agents/deep-researcher.md +31 -0
- package/.versions/0.0.5/agents/documenter.md +18 -0
- package/.versions/0.0.5/agents/orchestrator.md +54 -0
- package/.versions/0.0.5/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.5/agents/planner.md +69 -0
- package/.versions/0.0.5/agents/releaser.md +24 -0
- package/.versions/0.0.5/agents/researcher.md +28 -0
- package/.versions/0.0.5/agents/security-auditor.md +166 -0
- package/.versions/0.0.5/agents/test-engineer.md +151 -0
- package/.versions/0.0.5/agents/web-debugger.md +42 -0
- package/.versions/0.0.5/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.5/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.5/docs/ARCHITECTURE.md +210 -0
- package/.versions/0.0.5/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.5/docs/claude-code-coms-bridge.md +103 -0
- package/.versions/0.0.5/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.5/docs/coms-hermes-bridge.md +179 -0
- package/.versions/0.0.5/docs/getting-started.md +183 -0
- package/.versions/0.0.5/docs/npm-install.md +337 -0
- package/.versions/0.0.5/docs/opencode-setup.md +249 -0
- package/.versions/0.0.5/docs/pi-extensions.md +293 -0
- package/.versions/0.0.5/docs/pi-setup.md +472 -0
- package/.versions/0.0.5/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.5/hermes/README.md +231 -0
- package/.versions/0.0.5/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.5/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
- package/.versions/0.0.5/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.5/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.5/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.5/hooks/coms-stop-hook.mjs +73 -0
- package/.versions/0.0.5/hooks/hooks.json +14 -0
- package/.versions/0.0.5/hooks/session-start.sh +74 -0
- package/.versions/0.0.5/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.5/justfile +245 -0
- package/.versions/0.0.5/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.5/references/definition-of-done.md +67 -0
- package/.versions/0.0.5/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.5/references/observability-checklist.md +91 -0
- package/.versions/0.0.5/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.5/references/performance-checklist.md +153 -0
- package/.versions/0.0.5/references/prompting-patterns.md +380 -0
- package/.versions/0.0.5/references/security-checklist.md +179 -0
- package/.versions/0.0.5/references/testing-patterns.md +236 -0
- package/.versions/0.0.5/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.5/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.5/scripts/coms-claude-bridge.ts +286 -0
- package/.versions/0.0.5/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.5/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.5/scripts/fleet.ts +141 -0
- package/.versions/0.0.5/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.5/scripts/hermes-monitor-scenario.ts +7 -0
- package/.versions/0.0.5/scripts/lib/claude-bridge-core.ts +100 -0
- package/.versions/0.0.5/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.5/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.5/scripts/lib/coms-envelope.ts +539 -0
- package/.versions/0.0.5/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.5/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.5/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.5/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.5/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.5/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.5/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.5/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.5/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.5/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.5/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.5/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.5/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.5/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.5/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.5/scripts/team-up.ts +351 -0
- package/.versions/0.0.5/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.5/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.5/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.5/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.5/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.5/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.5/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.5/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.5/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.5/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.5/skills/guided-workspace-setup/SKILL.md +542 -0
- package/.versions/0.0.5/skills/guided-workspace-setup/companion-manifest.json +35 -0
- package/.versions/0.0.5/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.5/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.5/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.5/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.5/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.5/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.5/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.5/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.5/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.5/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.5/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.5/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.5/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.5/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.5/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.5/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +62 -0
- package/README.md +17 -16
- package/agents/builder.md +1 -1
- package/agents/code-reviewer.md +1 -1
- package/agents/deep-researcher.md +3 -3
- package/agents/orchestrator.md +20 -11
- package/agents/plan-reviewer.md +3 -3
- package/agents/test-engineer.md +11 -4
- package/bin/cli.js +83 -1
- package/bin/lib/set-hermes-telegram.js +323 -0
- package/bin/lib/validate-overrides.js +19 -0
- package/bin/sync-harness-versions.js +94 -0
- package/docs/ARCHITECTURE.md +49 -4
- package/docs/agent-fleet-setup.md +11 -1
- package/docs/claude-code-coms-bridge.md +4 -4
- package/docs/codex-remote-conductor.md +12 -12
- package/docs/coms-hermes-bridge.md +62 -4
- package/docs/getting-started.md +4 -4
- package/docs/opencode-setup.md +1 -0
- package/docs/pi-extensions.md +73 -33
- package/docs/pi-setup.md +23 -8
- package/hermes/README.md +191 -8
- package/justfile +143 -158
- package/package.json +13 -5
- package/references/fleet-coordination-patterns.md +1 -1
- package/scripts/coms-hermes-bridge.ts +18 -8
- package/scripts/fleet.ts +141 -0
- package/scripts/lib/fake-herdr-server.ts +88 -0
- package/scripts/lib/fleet-command.ts +109 -0
- package/scripts/lib/hermes-bridge-core.ts +5 -2
- package/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/scripts/lib/hermes-monitor-model.ts +3 -0
- package/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/scripts/lib/hermes-monitor-store.ts +2 -0
- package/scripts/lib/team-project.ts +10 -3
- package/scripts/team-snapshot.ts +4 -5
- package/scripts/team-up.ts +24 -6
- package/skills/designing-agents/SKILL.md +2 -2
- package/skills/designing-agents/pi-harness-authoring.md +26 -13
- package/skills/guided-workspace-setup/SKILL.md +22 -12
- package/skills/guided-workspace-setup/companion-manifest.json +3 -1
- package/skills/peer-coms/SKILL.md +1 -1
- package/.pi/harnesses/damage-control/README.md +0 -65
- package/.pi/harnesses/damage-control/index.ts +0 -250
package/scripts/fleet.ts
ADDED
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
// Unified `just fleet` command dispatcher. Parsing is kept pure and tested in
|
|
2
|
+
// scripts/lib/fleet-command.test.ts; this entrypoint only hands the resolved
|
|
3
|
+
// recipe back to Just so existing compatibility recipes remain one source of truth.
|
|
4
|
+
|
|
5
|
+
import { spawnSync } from "node:child_process";
|
|
6
|
+
import { parseFleetCommand } from "./lib/fleet-command.ts";
|
|
7
|
+
|
|
8
|
+
const HELP = `Agent Fleet — unified Pi runtime
|
|
9
|
+
|
|
10
|
+
QUICK START
|
|
11
|
+
just fleet
|
|
12
|
+
Start the default guarded Pi session with Fleet Core.
|
|
13
|
+
|
|
14
|
+
just fleet hub --project af
|
|
15
|
+
Start Agent Hub with specialists, research, Verification Contract, and coms.
|
|
16
|
+
|
|
17
|
+
just fleet team frontend --project af
|
|
18
|
+
Start a guarded Hub plus the frontend peer team in one Herdr workspace.
|
|
19
|
+
|
|
20
|
+
FLEET CORE — loaded in every Pi mode
|
|
21
|
+
Damage Control Continue · local/remote ask_user · Speech-to-Text (Alt+S)
|
|
22
|
+
Compact & Continue · BTW side sessions · update checker
|
|
23
|
+
|
|
24
|
+
SESSION MODES
|
|
25
|
+
just fleet [PI_ARGS...]
|
|
26
|
+
Safe interactive Pi without Hub or a coms identity.
|
|
27
|
+
Example: just fleet --model openai-codex/gpt-5.6-terra
|
|
28
|
+
|
|
29
|
+
just fleet peer <name> [PI_ARGS...]
|
|
30
|
+
Safe interactive Pi registered as an addressable coms peer.
|
|
31
|
+
Example: just fleet peer architect --project af
|
|
32
|
+
|
|
33
|
+
just fleet hub [--solo] [PI_ARGS...]
|
|
34
|
+
Agent Hub dispatcher. Embedded coms is on unless --solo is supplied.
|
|
35
|
+
Examples:
|
|
36
|
+
just fleet hub --project af
|
|
37
|
+
just fleet hub --solo
|
|
38
|
+
|
|
39
|
+
TEAM MODES — presets: base, full, web, docs, default, debug, frontend,
|
|
40
|
+
security, hotfix, release, info, review, plan
|
|
41
|
+
just fleet team <preset> [TEAM_ARGS...]
|
|
42
|
+
Guarded Hub plus guarded reusable peers in one Herdr workspace.
|
|
43
|
+
Example: just fleet team security --project af
|
|
44
|
+
|
|
45
|
+
just fleet team <preset> --no-hub [TEAM_ARGS...]
|
|
46
|
+
Guarded reusable peers only; no Hub pane.
|
|
47
|
+
Example: just fleet team docs --no-hub --project af
|
|
48
|
+
|
|
49
|
+
just fleet team <preset> [--no-hub] --dry-run [TEAM_ARGS...]
|
|
50
|
+
Print the resolved workspace, panes, and commands without changing Herdr.
|
|
51
|
+
Example: just fleet team frontend --dry-run --project af
|
|
52
|
+
|
|
53
|
+
TEAM LIFECYCLE
|
|
54
|
+
just fleet snapshot <preset> [--project <name>]
|
|
55
|
+
Save session references while the workspace keeps running.
|
|
56
|
+
|
|
57
|
+
just fleet down <preset> [--project <name>]
|
|
58
|
+
Snapshot and cleanly close the workspace.
|
|
59
|
+
|
|
60
|
+
just fleet resume <preset> [--project <name>]
|
|
61
|
+
Rebuild the workspace and resume available Pi/Claude sessions.
|
|
62
|
+
|
|
63
|
+
Examples:
|
|
64
|
+
just fleet snapshot docs --project af
|
|
65
|
+
just fleet down docs --project af
|
|
66
|
+
just fleet resume docs --project af
|
|
67
|
+
|
|
68
|
+
HERMES CONDUCTOR
|
|
69
|
+
just fleet conductor hermes [preset] [--dry-run] [TEAM_ARGS...]
|
|
70
|
+
Start Hermes with a peer team, or preview the layout with --dry-run.
|
|
71
|
+
Example: just fleet conductor hermes docs --project af
|
|
72
|
+
|
|
73
|
+
CODEX REMOTE-CONTROL CONDUCTOR
|
|
74
|
+
just fleet conductor codex <setup|reconfigure> [preset] [ARGS...]
|
|
75
|
+
just fleet conductor codex <pair|start|status|stop|recover|uninstall>
|
|
76
|
+
just fleet conductor codex [preset] [--dry-run] [TEAM_ARGS...]
|
|
77
|
+
|
|
78
|
+
Typical flow:
|
|
79
|
+
just fleet conductor codex setup docs --project af
|
|
80
|
+
just fleet conductor codex pair
|
|
81
|
+
just fleet conductor codex start
|
|
82
|
+
just fleet conductor codex docs --project af
|
|
83
|
+
just fleet conductor codex status
|
|
84
|
+
just fleet conductor codex stop
|
|
85
|
+
|
|
86
|
+
CAPABILITY FLAGS
|
|
87
|
+
--browser
|
|
88
|
+
Add interactive Chrome DevTools MCP tools to the main Pi/Hub process.
|
|
89
|
+
Example: just fleet hub --browser --project af
|
|
90
|
+
|
|
91
|
+
--all-extensions
|
|
92
|
+
Also auto-load arbitrary project/global extensions outside Fleet Core.
|
|
93
|
+
Example: just fleet peer debugger --all-extensions --project af
|
|
94
|
+
|
|
95
|
+
SETUP
|
|
96
|
+
just fleet install
|
|
97
|
+
Install only .pi/extensions and .pi/harnesses Node dependencies.
|
|
98
|
+
Does not launch Pi, configure STT, install ffmpeg/Herdr, or pair Codex.
|
|
99
|
+
|
|
100
|
+
HELP
|
|
101
|
+
just Show this complete command guide.
|
|
102
|
+
just fleet help Show this complete command guide.
|
|
103
|
+
just --list Show the intentionally small public recipe surface.
|
|
104
|
+
|
|
105
|
+
Configuration:
|
|
106
|
+
Teams: .pi/agents/peers.yaml
|
|
107
|
+
Hub teams: .pi/agents/teams.yaml
|
|
108
|
+
Overrides: .ai/agent-fleet-overrides.md
|
|
109
|
+
STT: .ai/stt.json or ~/.pi/agent/stt.json
|
|
110
|
+
Safety: .pi/damage-control-rules.yaml
|
|
111
|
+
Full docs: docs/pi-extensions.md and docs/pi-setup.md
|
|
112
|
+
`;
|
|
113
|
+
|
|
114
|
+
function main(): void {
|
|
115
|
+
const argv = process.argv.slice(2);
|
|
116
|
+
if (argv[0] === "help" || argv[0] === "--help" || argv[0] === "-h") {
|
|
117
|
+
process.stdout.write(HELP);
|
|
118
|
+
return;
|
|
119
|
+
}
|
|
120
|
+
let invocation;
|
|
121
|
+
try {
|
|
122
|
+
invocation = parseFleetCommand(argv);
|
|
123
|
+
} catch (err) {
|
|
124
|
+
console.error(`fleet: ${err instanceof Error ? err.message : String(err)}\n`);
|
|
125
|
+
process.stderr.write(HELP);
|
|
126
|
+
process.exitCode = 2;
|
|
127
|
+
return;
|
|
128
|
+
}
|
|
129
|
+
const result = spawnSync("just", [invocation.recipe, ...invocation.args], {
|
|
130
|
+
stdio: "inherit",
|
|
131
|
+
env: process.env,
|
|
132
|
+
});
|
|
133
|
+
if (result.error) {
|
|
134
|
+
console.error(`fleet: could not run just: ${result.error.message}`);
|
|
135
|
+
process.exitCode = 1;
|
|
136
|
+
return;
|
|
137
|
+
}
|
|
138
|
+
process.exitCode = result.status ?? 1;
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
main();
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
import * as fs from "node:fs";
|
|
2
|
+
import * as net from "node:net";
|
|
3
|
+
import { mkdtempSync } from "node:fs";
|
|
4
|
+
import { tmpdir } from "node:os";
|
|
5
|
+
import { join } from "node:path";
|
|
6
|
+
|
|
7
|
+
export interface FakeHerdrRequest {
|
|
8
|
+
id: string;
|
|
9
|
+
method: string;
|
|
10
|
+
params: Record<string, unknown>;
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
export class FakeHerdrServer {
|
|
14
|
+
public readonly requests: FakeHerdrRequest[] = [];
|
|
15
|
+
public readonly socketPath: string;
|
|
16
|
+
private readonly subscribers = new Set<net.Socket>();
|
|
17
|
+
private readonly server: net.Server;
|
|
18
|
+
private readonly root: string;
|
|
19
|
+
private workspaceId: string;
|
|
20
|
+
private readonly paneId: string;
|
|
21
|
+
private readonly resyncOutput: { sequence: number; text: string };
|
|
22
|
+
|
|
23
|
+
private constructor(socketPath: string, server: net.Server, root: string, paneId: string, workspaceId: string, resyncOutput: { sequence: number; text: string }) {
|
|
24
|
+
this.socketPath = socketPath;
|
|
25
|
+
this.server = server;
|
|
26
|
+
this.root = root;
|
|
27
|
+
this.paneId = paneId;
|
|
28
|
+
this.workspaceId = workspaceId;
|
|
29
|
+
this.resyncOutput = resyncOutput;
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
static async start(values: { paneId: string; workspaceId: string; resyncOutput?: { sequence: number; text: string } }): Promise<FakeHerdrServer> {
|
|
33
|
+
const root = mkdtempSync(join(tmpdir(), "fake-herdr-"));
|
|
34
|
+
const socketPath = join(root, "s");
|
|
35
|
+
let fake: FakeHerdrServer;
|
|
36
|
+
const server = net.createServer((socket) => {
|
|
37
|
+
let buffer = "";
|
|
38
|
+
socket.on("data", (chunk) => {
|
|
39
|
+
buffer += chunk.toString("utf8");
|
|
40
|
+
let newline: number;
|
|
41
|
+
while ((newline = buffer.indexOf("\n")) >= 0) {
|
|
42
|
+
const line = buffer.slice(0, newline);
|
|
43
|
+
buffer = buffer.slice(newline + 1);
|
|
44
|
+
if (!line) continue;
|
|
45
|
+
const request = JSON.parse(line) as FakeHerdrRequest;
|
|
46
|
+
fake.requests.push(request);
|
|
47
|
+
if (request.method === "events.subscribe") {
|
|
48
|
+
fake.subscribers.add(socket);
|
|
49
|
+
socket.write(JSON.stringify({ id: request.id, result: { type: "subscription_started" } }) + "\n");
|
|
50
|
+
continue;
|
|
51
|
+
}
|
|
52
|
+
const result = request.method === "pane.get"
|
|
53
|
+
? { pane: { pane_id: fake.paneId, workspace_id: fake.workspaceId, monitor_resync_output: fake.resyncOutput } }
|
|
54
|
+
: request.method === "ping"
|
|
55
|
+
? { type: "pong", version: "fake", protocol: 14 }
|
|
56
|
+
: {};
|
|
57
|
+
socket.end(JSON.stringify({ id: request.id, result }) + "\n");
|
|
58
|
+
}
|
|
59
|
+
});
|
|
60
|
+
socket.on("close", () => fake.subscribers.delete(socket));
|
|
61
|
+
});
|
|
62
|
+
fake = new FakeHerdrServer(socketPath, server, root, values.paneId, values.workspaceId, values.resyncOutput ?? { sequence: 0, text: "" });
|
|
63
|
+
await new Promise<void>((resolve, reject) => server.listen(socketPath, resolve).once("error", reject));
|
|
64
|
+
return fake;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
setWorkspaceId(workspaceId: string): void {
|
|
68
|
+
this.workspaceId = workspaceId;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
emitStatus(): void {
|
|
72
|
+
for (const socket of this.subscribers) socket.write(JSON.stringify({ event: "pane.agent_status_changed", data: { pane_id: this.paneId } }) + "\n");
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
disconnectSubscribers(): void {
|
|
76
|
+
for (const socket of this.subscribers) socket.destroy();
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
subscriptionCount(): number {
|
|
80
|
+
return this.requests.filter((request) => request.method === "events.subscribe").length;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
async close(): Promise<void> {
|
|
84
|
+
this.disconnectSubscribers();
|
|
85
|
+
await new Promise<void>((resolve) => this.server.close(() => resolve()));
|
|
86
|
+
fs.rmSync(this.root, { recursive: true, force: true });
|
|
87
|
+
}
|
|
88
|
+
}
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
export interface FleetInvocation {
|
|
2
|
+
recipe: string;
|
|
3
|
+
args: string[];
|
|
4
|
+
}
|
|
5
|
+
|
|
6
|
+
interface Capabilities {
|
|
7
|
+
browser: boolean;
|
|
8
|
+
allExtensions: boolean;
|
|
9
|
+
rest: string[];
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
function capabilities(args: string[]): Capabilities {
|
|
13
|
+
const rest: string[] = [];
|
|
14
|
+
let browser = false;
|
|
15
|
+
let allExtensions = false;
|
|
16
|
+
for (const arg of args) {
|
|
17
|
+
if (arg === "--browser") browser = true;
|
|
18
|
+
else if (arg === "--all-extensions") allExtensions = true;
|
|
19
|
+
else rest.push(arg);
|
|
20
|
+
}
|
|
21
|
+
return { browser, allExtensions, rest };
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
function bool(value: boolean): string {
|
|
25
|
+
return value ? "true" : "false";
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
function requireValue(value: string | undefined, message: string): string {
|
|
29
|
+
if (!value || value.startsWith("--")) throw new Error(message);
|
|
30
|
+
return value;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
function withoutFlag(args: string[], flag: string): { present: boolean; rest: string[] } {
|
|
34
|
+
return { present: args.includes(flag), rest: args.filter((arg) => arg !== flag) };
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
const CODEX_LIFECYCLE = new Set(["setup", "reconfigure", "pair", "start", "status", "stop", "recover", "uninstall"]);
|
|
38
|
+
|
|
39
|
+
export function parseFleetCommand(argv: string[]): FleetInvocation {
|
|
40
|
+
if (argv.length === 0 || argv[0].startsWith("--")) {
|
|
41
|
+
const c = capabilities(argv);
|
|
42
|
+
return { recipe: "_fleet-core", args: [bool(c.browser), bool(c.allExtensions), ...c.rest] };
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
const [mode, ...tail] = argv;
|
|
46
|
+
if (mode === "install") return { recipe: "_fleet-install", args: tail };
|
|
47
|
+
|
|
48
|
+
if (mode === "peer") {
|
|
49
|
+
const name = requireValue(tail[0], "fleet peer requires a peer name");
|
|
50
|
+
const c = capabilities(tail.slice(1));
|
|
51
|
+
return { recipe: "_fleet-peer", args: [name, bool(c.browser), bool(c.allExtensions), ...c.rest] };
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
if (mode === "hub") {
|
|
55
|
+
const solo = withoutFlag(tail, "--solo");
|
|
56
|
+
const c = capabilities(solo.rest);
|
|
57
|
+
return { recipe: "_fleet-hub", args: [bool(solo.present), bool(c.browser), bool(c.allExtensions), ...c.rest] };
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
if (mode === "team") {
|
|
61
|
+
const team = requireValue(tail[0], "fleet team requires a team preset");
|
|
62
|
+
const noHub = withoutFlag(tail.slice(1), "--no-hub");
|
|
63
|
+
const dry = withoutFlag(noHub.rest, "--dry-run");
|
|
64
|
+
const c = capabilities(dry.rest);
|
|
65
|
+
if (noHub.present && (c.browser || c.allExtensions)) {
|
|
66
|
+
throw new Error("--browser/--all-extensions requires the hub; peer capabilities belong in .pi/agents/peers.yaml");
|
|
67
|
+
}
|
|
68
|
+
const recipe = noHub.present
|
|
69
|
+
? dry.present ? "_fleet-team-up-dry" : "_fleet-team-up"
|
|
70
|
+
: dry.present ? "_fleet-hub-team-dry" : "_fleet-hub-team";
|
|
71
|
+
const forwarded = [...c.rest];
|
|
72
|
+
if (c.browser) forwarded.push("--browser");
|
|
73
|
+
if (c.allExtensions) forwarded.push("--all-extensions");
|
|
74
|
+
return { recipe, args: [team, ...forwarded] };
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
if (mode === "snapshot" || mode === "down" || mode === "resume") {
|
|
78
|
+
const team = requireValue(tail[0], `fleet ${mode} requires a team preset`);
|
|
79
|
+
return { recipe: `_fleet-team-${mode === "snapshot" ? "snapshot" : mode}`, args: [team, ...tail.slice(1)] };
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
if (mode === "conductor") {
|
|
83
|
+
const backend = requireValue(tail[0], "fleet conductor requires hermes or codex");
|
|
84
|
+
if (backend !== "hermes" && backend !== "codex") throw new Error(`Unknown conductor backend: ${backend}`);
|
|
85
|
+
const rest = tail.slice(1);
|
|
86
|
+
if (backend === "hermes") {
|
|
87
|
+
const team = rest[0] && !rest[0].startsWith("--") ? rest[0] : "full";
|
|
88
|
+
const afterTeam = rest[0] === team ? rest.slice(1) : rest;
|
|
89
|
+
const dry = withoutFlag(afterTeam, "--dry-run");
|
|
90
|
+
return { recipe: dry.present ? "_fleet-conductor-dry" : "_fleet-conductor", args: [team, ...dry.rest] };
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
const action = rest[0];
|
|
94
|
+
if (action && CODEX_LIFECYCLE.has(action)) {
|
|
95
|
+
if (action === "setup" || action === "reconfigure") {
|
|
96
|
+
const team = rest[1] && !rest[1].startsWith("--") ? rest[1] : "full";
|
|
97
|
+
const afterTeam = rest[1] === team ? rest.slice(2) : rest.slice(1);
|
|
98
|
+
return { recipe: `_fleet-conductor-codex-${action}`, args: [team, ...afterTeam] };
|
|
99
|
+
}
|
|
100
|
+
return { recipe: `_fleet-conductor-codex-${action}`, args: rest.slice(1) };
|
|
101
|
+
}
|
|
102
|
+
const team = action && !action.startsWith("--") ? action : "full";
|
|
103
|
+
const afterTeam = action === team ? rest.slice(1) : rest;
|
|
104
|
+
const dry = withoutFlag(afterTeam, "--dry-run");
|
|
105
|
+
return { recipe: dry.present ? "_fleet-conductor-codex-dry" : "_fleet-conductor-codex", args: [team, ...dry.rest] };
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
throw new Error(`Unknown fleet mode: ${mode}`);
|
|
109
|
+
}
|
|
@@ -33,6 +33,7 @@ export interface QuestionOption {
|
|
|
33
33
|
|
|
34
34
|
export interface HermesBridgeQuestion {
|
|
35
35
|
qid: string;
|
|
36
|
+
project: string;
|
|
36
37
|
question: string;
|
|
37
38
|
context?: string;
|
|
38
39
|
options?: QuestionOption[];
|
|
@@ -117,13 +118,15 @@ export function formatTelegramQuestion(input: HermesBridgeQuestion, limit = TELE
|
|
|
117
118
|
if (!isValidQid(input.qid)) throw new Error("qid must be a 26-character Crockford ULID");
|
|
118
119
|
const options = input.options ?? [];
|
|
119
120
|
const header = `❓ [${HUB_Q_PREFIX}:${input.qid}] ${input.question}`;
|
|
121
|
+
const project = truncateUtf16(input.project.replace(/\s+/g, " ").trim() || "default", 128);
|
|
122
|
+
const projectBlock = `\n\n📁 Project: ${project}`;
|
|
120
123
|
const optionsBlock = options.length > 0 ? `\n\nOptions:\n${formatOptions(options)}` : "";
|
|
121
124
|
const instruction = `\n\n↩ Reply to this message, or type: ${HUB_Q_PREFIX}:${input.qid}: <answer>`;
|
|
122
125
|
const contextPrefix = input.context ? "\n\nContext: " : "";
|
|
123
|
-
const fixedLength = header.length + contextPrefix.length + optionsBlock.length + instruction.length;
|
|
126
|
+
const fixedLength = header.length + projectBlock.length + contextPrefix.length + optionsBlock.length + instruction.length;
|
|
124
127
|
const contextBudget = Math.max(0, limit - fixedLength);
|
|
125
128
|
const context = input.context ? truncateUtf16(input.context, contextBudget) : "";
|
|
126
|
-
return truncateUtf16(`${header}${contextPrefix}${context}${optionsBlock}${instruction}`, limit);
|
|
129
|
+
return truncateUtf16(`${header}${projectBlock}${contextPrefix}${context}${optionsBlock}${instruction}`, limit);
|
|
127
130
|
}
|
|
128
131
|
|
|
129
132
|
export function mapAnswerToAskResponse(answer: string, options: QuestionOption[] = []): AskResponse {
|
|
@@ -93,7 +93,7 @@ export function parseProjectFlag(argv: string[]): string {
|
|
|
93
93
|
|
|
94
94
|
// Workspace label = <worktree-tag>-<mode>-<team>, with a `--project.<name>`
|
|
95
95
|
// suffix when the coms project is non-default. The worktree tag keys the label
|
|
96
|
-
// to the checkout, so `just
|
|
96
|
+
// to the checkout, so `just fleet team <team>` from two repos/worktrees yields
|
|
97
97
|
// distinct labels (e.g. `wt2-hub-plan` vs `end2-hub-plan`) instead of colliding
|
|
98
98
|
// on a shared `pi-hub-<team>`. Pass `tag` from worktreeTag(REPO_ROOT); it
|
|
99
99
|
// defaults to "repo" only for callers that have no checkout in hand.
|
|
@@ -109,9 +109,16 @@ export function teamWorkspaceLabel(
|
|
|
109
109
|
return project === DEFAULT_PROJECT ? base : `${base}--project.${project}`;
|
|
110
110
|
}
|
|
111
111
|
|
|
112
|
-
export function hubCommand(
|
|
112
|
+
export function hubCommand(
|
|
113
|
+
project = DEFAULT_PROJECT,
|
|
114
|
+
capabilities: { browser?: boolean; allExtensions?: boolean } = {},
|
|
115
|
+
): string[] {
|
|
113
116
|
validateProject(project);
|
|
114
|
-
|
|
117
|
+
const command = ["just", "fleet", "hub"];
|
|
118
|
+
if (capabilities.browser) command.push("--browser");
|
|
119
|
+
if (capabilities.allExtensions) command.push("--all-extensions");
|
|
120
|
+
if (project !== DEFAULT_PROJECT) command.push("--project", project);
|
|
121
|
+
return command;
|
|
115
122
|
}
|
|
116
123
|
|
|
117
124
|
export function conductorCommand(): string[] {
|
package/scripts/team-snapshot.ts
CHANGED
|
@@ -1,8 +1,7 @@
|
|
|
1
1
|
// scripts/team-snapshot.ts
|
|
2
2
|
//
|
|
3
3
|
// Fleet resume (B5): snapshot / tear down / rebuild a running peer team.
|
|
4
|
-
// Backs
|
|
5
|
-
// recipes. herdr is a hard dependency (requireHerdr refuses readably).
|
|
4
|
+
// Backs `just fleet snapshot`, `just fleet down`, and `just fleet resume`. herdr is a hard dependency (requireHerdr refuses readably).
|
|
6
5
|
//
|
|
7
6
|
// snapshot <team> — capture peers + per-peer session refs to
|
|
8
7
|
// ~/.pi/team-snapshots/<team>.json (team keeps running)
|
|
@@ -88,7 +87,7 @@ async function captureSnapshot(client: Client, team: string, project = DEFAULT_P
|
|
|
88
87
|
const projectArgs = project === DEFAULT_PROJECT ? "" : ` --project ${project}`;
|
|
89
88
|
die(
|
|
90
89
|
`No running workspace "${peersLabel}" or "${hubLabel}" found.\n` +
|
|
91
|
-
`Start one with: just team
|
|
90
|
+
`Start one with: just fleet team ${team}${projectArgs} (or add --no-hub for peers only)`,
|
|
92
91
|
);
|
|
93
92
|
}
|
|
94
93
|
if (!fs.existsSync(PEERS_YAML)) die(`peers.yaml not found at ${PEERS_YAML}`);
|
|
@@ -129,7 +128,7 @@ async function cmdDown(team: string, project = DEFAULT_PROJECT): Promise<void> {
|
|
|
129
128
|
if (ws) {
|
|
130
129
|
await client.herdr.workspaceClose(ws.workspace_id);
|
|
131
130
|
const projectArgs = project === DEFAULT_PROJECT ? "" : ` --project ${project}`;
|
|
132
|
-
console.log(`Closed workspace ${ws.workspace_id} ("${ws.label}"). Resume with: just
|
|
131
|
+
console.log(`Closed workspace ${ws.workspace_id} ("${ws.label}"). Resume with: just fleet resume ${team}${projectArgs}`);
|
|
133
132
|
}
|
|
134
133
|
}
|
|
135
134
|
|
|
@@ -137,7 +136,7 @@ async function cmdResume(team: string, project = DEFAULT_PROJECT): Promise<void>
|
|
|
137
136
|
const file = snapshotPath(team, project);
|
|
138
137
|
if (!fs.existsSync(file)) {
|
|
139
138
|
const projectArgs = project === DEFAULT_PROJECT ? "" : ` --project ${project}`;
|
|
140
|
-
die(`No snapshot at ${file}.\nTake one while the team runs: just
|
|
139
|
+
die(`No snapshot at ${file}.\nTake one while the team runs: just fleet snapshot ${team}${projectArgs} (or just fleet down ${team}${projectArgs}).`);
|
|
141
140
|
}
|
|
142
141
|
const snap = parseSnapshot(fs.readFileSync(file, "utf-8"));
|
|
143
142
|
try {
|
package/scripts/team-up.ts
CHANGED
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
//
|
|
3
3
|
// Spawn a team of reusable coms peers (from .pi/agents/peers.yaml) into a
|
|
4
4
|
// herdr workspace — one pane per peer in a tiled BSP layout, each running the
|
|
5
|
-
// hidden `just _peer …` helper.
|
|
6
|
-
// `just
|
|
5
|
+
// hidden `just _peer …` helper. Public use is through `just fleet team` and
|
|
6
|
+
// `just fleet conductor`; all backing recipes remain private. Herdr is a hard
|
|
7
7
|
// dependency for fleet spawning: without a running server the recipes refuse
|
|
8
8
|
// with an actionable message.
|
|
9
9
|
//
|
|
@@ -207,6 +207,11 @@ async function main(): Promise<void> {
|
|
|
207
207
|
}
|
|
208
208
|
const dryRun = argv.includes("--dry-run");
|
|
209
209
|
const hub = argv.includes("--hub");
|
|
210
|
+
const hubBrowser = argv.includes("--browser");
|
|
211
|
+
const hubAllExtensions = argv.includes("--all-extensions");
|
|
212
|
+
if (!hub && (hubBrowser || hubAllExtensions)) {
|
|
213
|
+
die("--browser/--all-extensions apply to the hub pane and therefore require --hub");
|
|
214
|
+
}
|
|
210
215
|
let conductor: ConductorBackend | null;
|
|
211
216
|
try {
|
|
212
217
|
conductor = parseConductorBackend(argv);
|
|
@@ -245,7 +250,11 @@ async function main(): Promise<void> {
|
|
|
245
250
|
die(err instanceof Error ? err.message : String(err));
|
|
246
251
|
}
|
|
247
252
|
const rootPane = hub
|
|
248
|
-
? {
|
|
253
|
+
? {
|
|
254
|
+
command: hubCommand(project, { browser: hubBrowser, allExtensions: hubAllExtensions }),
|
|
255
|
+
label: "hub",
|
|
256
|
+
ratio: HUB_RATIO,
|
|
257
|
+
}
|
|
249
258
|
: spec
|
|
250
259
|
? { command: spec.command, label: spec.paneLabel, ratio: spec.ratio, cwd: spec.cwd, env: spec.env }
|
|
251
260
|
: undefined;
|
|
@@ -281,8 +290,15 @@ async function main(): Promise<void> {
|
|
|
281
290
|
} catch (err) {
|
|
282
291
|
if (err instanceof HerdrUnavailableError) {
|
|
283
292
|
console.error(err.message);
|
|
284
|
-
const
|
|
285
|
-
|
|
293
|
+
const projectArgs = project === DEFAULT_PROJECT ? "" : ` --project ${project}`;
|
|
294
|
+
const dryCommand = mode === "hub"
|
|
295
|
+
? `just fleet team ${team} --dry-run${projectArgs}`
|
|
296
|
+
: spec?.backend === "codex"
|
|
297
|
+
? `just fleet conductor codex ${team} --dry-run${projectArgs}`
|
|
298
|
+
: mode === "conductor"
|
|
299
|
+
? `just fleet conductor hermes ${team} --dry-run${projectArgs}`
|
|
300
|
+
: `just fleet team ${team} --no-hub --dry-run${projectArgs}`;
|
|
301
|
+
console.error(`(dry run still works: ${dryCommand})`);
|
|
286
302
|
process.exit(1);
|
|
287
303
|
}
|
|
288
304
|
throw err;
|
|
@@ -315,7 +331,9 @@ async function main(): Promise<void> {
|
|
|
315
331
|
console.log(
|
|
316
332
|
`Launched ${launchedPrefix}${peers.length} peer(s) for team "${team}" in herdr workspace "${label}" (${wsId}):`,
|
|
317
333
|
);
|
|
318
|
-
if (mode === "hub")
|
|
334
|
+
if (mode === "hub") {
|
|
335
|
+
console.log(` • hub (${hubCommand(project, { browser: hubBrowser, allExtensions: hubAllExtensions }).join(" ")} — guarded dispatcher)`);
|
|
336
|
+
}
|
|
319
337
|
if (spec) console.log(` • ${spec.paneLabel} (${spec.command.join(" ")} — ${spec.displayText})`);
|
|
320
338
|
if (spec?.backend === "codex") console.log(" • Closing this workspace does not stop the enabled Codex user service; stop it explicitly.");
|
|
321
339
|
for (const p of peers) console.log(` • ${p.name}`);
|
|
@@ -11,7 +11,7 @@ This repo has three kinds of artifacts that shape how an agent works. Each is au
|
|
|
11
11
|
|
|
12
12
|
- **Agent personas** live in `agents/<name>.md`. They define a *role* another agent adopts when it needs specialized review, audit, or analysis. Example: `code-reviewer`, `security-auditor`, `test-engineer`.
|
|
13
13
|
- **Skills** live in `skills/<name>/SKILL.md`. They define a *workflow* — a repeatable process with gated steps, anti-rationalization guardrails, and verification. Example: `spec-driven-development`, `test-driven-development`, `context-engineering`.
|
|
14
|
-
- **pi harnesses** live in `.pi/harnesses/<name>/`. They define a *session environment* — a TypeScript pi extension that reshapes the whole session: setting UI surfaces, gating tool calls, registering new tools or commands, or orchestrating sub-agents. Example: `agent-hub`, `damage-control`, `coms`.
|
|
14
|
+
- **pi harnesses** live in `.pi/harnesses/<name>/`. They define a *session environment* — a TypeScript pi extension that reshapes the whole session: setting UI surfaces, gating tool calls, registering new tools or commands, or orchestrating sub-agents. Example: `agent-hub`, `damage-control-continue`, `coms`.
|
|
15
15
|
|
|
16
16
|
Personas and skills are prose that change an agent's *judgment*. A harness is code that changes the agent's *environment* — what it can do and what it sees. All three fail the same way: a persona that reads like general advice gets cited but ignored; a skill that skips its guardrails becomes a suggestion; a harness built without studying the existing ones collides with pi's auto-discovery or fights another extension. This skill is the workflow for authoring any of the three so the result measurably changes behavior.
|
|
17
17
|
|
|
@@ -316,7 +316,7 @@ A harness is a directory, not a single file. The `ExtensionAPI` surface, the `in
|
|
|
316
316
|
| "I'll skip the Output Format section — the agent will figure it out" (persona) | Without a template, outputs drift across invocations and become uncomparable. Reviewers cannot triage findings that don't share a shape. |
|
|
317
317
|
| "I'll skip the Common Rationalizations table — the steps are obvious" (skill) | Every step that gets skipped had an excuse attached. The table is the only place in the skill that directly blocks those excuses. Skipping it is how skills become suggestions. |
|
|
318
318
|
| "I'll skip the Verification checklist — the user will know when it's done" (skill) | Without evidence requirements, 'seems right' becomes the completion signal. The checklist is what forces proof. |
|
|
319
|
-
| "I'll drop the harness in `.pi/extensions/` so it loads automatically" | pi auto-discovers `.pi/extensions/` and loads everything there at once. Most harnesses are mutually exclusive — footers fight, duplicate CLI flags abort startup. Harnesses live in `.pi/harnesses/` and load explicitly; the supported stack
|
|
319
|
+
| "I'll drop the harness in `.pi/extensions/` so it loads automatically" | pi auto-discovers `.pi/extensions/` and loads everything there at once. Most harnesses are mutually exclusive — footers fight, duplicate CLI flags abort startup. Harnesses live in `.pi/harnesses/` and load explicitly; the supported stack loads `damage-control-continue` before `agent-hub`. |
|
|
320
320
|
| "I'll write the harness `index.ts` from memory — I've seen the pattern" | The `ExtensionAPI` surface is specific and unforgiving; a misspelled event name fails silently. Read `pi-harness-authoring.md` and copy the closest existing harness. |
|
|
321
321
|
| "I'll skip the harness README and catalog row — `index.ts` is the real artifact" | A harness with no row in `docs/pi-extensions.md` is undiscoverable; no agent will load it. The README is its discovery surface — the same role frontmatter plays for a skill. |
|
|
322
322
|
| "I'll copy an existing artifact and tweak it" | For prose artifacts, copy-paste creates silent duplication and drift — read the existing files to learn the pattern, then write fresh. For a harness, copying the nearest `index.ts` *is* the recommended start; just rename it cleanly and cut what you don't use. |
|
|
@@ -9,8 +9,8 @@ A pi harness is a TypeScript pi extension that reshapes a whole session. The har
|
|
|
9
9
|
in `.pi/harnesses/` were ported from `disler/pi-vs-claude-code`; `docs/pi-extensions.md`
|
|
10
10
|
is their catalog. A harness can:
|
|
11
11
|
|
|
12
|
-
- set status, widgets, or overlays — `agent-hub`, `damage-control`
|
|
13
|
-
- gate every tool call and block or confirm it — `damage-control`
|
|
12
|
+
- set status, widgets, or overlays — `agent-hub`, `damage-control-continue`
|
|
13
|
+
- gate every tool call and block or confirm it — `damage-control-continue`
|
|
14
14
|
- register a new tool or `/command` — `agent-hub`, `coms`
|
|
15
15
|
- inject text into the system prompt — `agent-hub`
|
|
16
16
|
- orchestrate sub-agents — `agent-hub`
|
|
@@ -23,37 +23,47 @@ pi auto-discovers and loads **every** directory under `.pi/extensions/`. The thr
|
|
|
23
23
|
coexist. Harnesses are different: most are **mutually exclusive** — two that both replace
|
|
24
24
|
the footer fight, two that register the same CLI flag abort startup. So harnesses live in
|
|
25
25
|
`.pi/harnesses/`, which pi does **not** auto-discover, and load explicitly via `pi -e <path>`
|
|
26
|
-
or the `justfile`. The supported stack is `damage-control` before `agent-hub`; never put a
|
|
26
|
+
or the `justfile`. The supported stack is `damage-control-continue` before `agent-hub`; never put a
|
|
27
27
|
harness under `.pi/extensions/`.
|
|
28
28
|
|
|
29
29
|
## Directory anatomy
|
|
30
30
|
|
|
31
|
-
Every harness
|
|
31
|
+
Every harness has these three required baseline files:
|
|
32
32
|
|
|
33
33
|
```
|
|
34
34
|
.pi/harnesses/<name>/
|
|
35
35
|
index.ts # the extension
|
|
36
|
-
package.json #
|
|
36
|
+
package.json # shared manifest fields; persistent-UI targets add a version stamp
|
|
37
37
|
README.md # the discovery surface
|
|
38
38
|
```
|
|
39
39
|
|
|
40
|
+
Persistent-UI targets may additionally include a local `version.ts` provenance reader beside
|
|
41
|
+
their adjacent stamped `package.json`; do not describe those target harnesses as having exactly
|
|
42
|
+
three files.
|
|
43
|
+
|
|
40
44
|
### package.json
|
|
41
45
|
|
|
42
|
-
|
|
46
|
+
Every harness manifest shares the same base shape (only `name` changes). Persistent-UI targets
|
|
47
|
+
add a root-derived `version` stamp:
|
|
43
48
|
|
|
44
49
|
```json
|
|
45
50
|
{
|
|
46
51
|
"name": "agent-fleet-pi-<name>",
|
|
47
52
|
"private": true,
|
|
48
53
|
"type": "module",
|
|
49
|
-
"main": "index.ts"
|
|
54
|
+
"main": "index.ts",
|
|
55
|
+
"version": "<root package version>"
|
|
50
56
|
}
|
|
51
57
|
```
|
|
52
58
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
59
|
+
The root `package.json` is canonical; `bin/sync-harness-versions.js` synchronizes the adjacent
|
|
60
|
+
harness stamps. A persistent-UI harness may keep a local provenance reader beside that manifest
|
|
61
|
+
so a copied or symlinked directory resolves its adjacent stamp, not the launch cwd. This does
|
|
62
|
+
**not** make it dependency-free. Runtime dependencies remain in `.pi/harnesses/package.json` and
|
|
63
|
+
are installed once by `just install`; copied/symlinked target harnesses still need that full
|
|
64
|
+
harness dependency installation. The `@mariozechner/pi-*` packages are provided by the pi runtime.
|
|
65
|
+
If a harness needs a new dependency, add it to `.pi/harnesses/package.json`, not the per-harness
|
|
66
|
+
file.
|
|
57
67
|
|
|
58
68
|
## The ExtensionAPI surface
|
|
59
69
|
|
|
@@ -107,7 +117,10 @@ Handlers are `async (event, ctx) => …`.
|
|
|
107
117
|
- `ctx.sessionManager.getBranch()` — session entries, for state reconstruction
|
|
108
118
|
- `ctx.abort()` — abort the current turn
|
|
109
119
|
- `ctx.hasUI` — false in headless runs; guard UI-only commands with it
|
|
110
|
-
- `ctx.ui.setFooter(fn)` / `setWidget(id, fn, opts)` / `setStatus(
|
|
120
|
+
- `ctx.ui.setFooter(fn)` / `setWidget(id, fn, opts)` / `setStatus(key, text)` — UI surfaces.
|
|
121
|
+
Use a stable, namespaced status key per concern. Stack-wide data such as the harness version
|
|
122
|
+
uses one shared key so stacked harnesses deduplicate `v<version>`; mutable status (for example,
|
|
123
|
+
Damage-Control activity or violations) uses its own key and must not overwrite that version.
|
|
111
124
|
- `ctx.ui.notify(text, level)` — transient message (`info` | `warning` | `error` | `success`)
|
|
112
125
|
- `ctx.ui.confirm(title, body, opts)` — yes/no dialog
|
|
113
126
|
- `ctx.ui.select(title, options)` — pick-one dialog
|
|
@@ -148,7 +161,7 @@ Do not write from scratch. Pick the nearest pattern and adapt it:
|
|
|
148
161
|
|
|
149
162
|
| If the harness… | Study | Approx. lines |
|
|
150
163
|
|---|---|---|
|
|
151
|
-
| Blocks tool calls from a rules file | `damage-control` |
|
|
164
|
+
| Blocks tool calls from a rules file | `damage-control-continue` | ~530 |
|
|
152
165
|
| Sets widgets/status or registers orchestration commands/tools | `agent-hub` | large |
|
|
153
166
|
| Orchestrates sub-agents | `agent-hub` | large |
|
|
154
167
|
| Adds local cross-agent messaging | `coms`, `agent-hub` | large |
|