@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
|
@@ -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
|
+
}
|
|
@@ -0,0 +1,263 @@
|
|
|
1
|
+
// scripts/lib/herdr-layout.ts
|
|
2
|
+
//
|
|
3
|
+
// Pure logic for the herdr fleet recipes: peers.yaml parsing, peer→command
|
|
4
|
+
// construction, and peers.yaml team → herdr declarative layout tree (BSP
|
|
5
|
+
// splits, one pane per peer). No pi imports, no sockets, no process.exit —
|
|
6
|
+
// everything throws plain Errors so callers decide how to die. Testable
|
|
7
|
+
// under node --test; the wiring (requireHerdr, workspace.create,
|
|
8
|
+
// layout.apply) lives in scripts/team-up.ts.
|
|
9
|
+
|
|
10
|
+
import { resolve as resolvePath } from "node:path";
|
|
11
|
+
|
|
12
|
+
import type { LayoutNode } from "../../.pi/harnesses/lib/herdr-client.ts";
|
|
13
|
+
import { STAGGER_ENV_VAR } from "./spawn-stagger.ts";
|
|
14
|
+
import { DEFAULT_PROJECT, validateProject } from "./team-project.ts";
|
|
15
|
+
|
|
16
|
+
export type { LayoutNode };
|
|
17
|
+
|
|
18
|
+
// Safe charset for any value spliced into a command line or layout — the
|
|
19
|
+
// peers.yaml file is user-edited, so every manifest value is validated.
|
|
20
|
+
export const SAFE = /^[A-Za-z0-9._/,-]+$/;
|
|
21
|
+
|
|
22
|
+
export interface Peer {
|
|
23
|
+
name?: string;
|
|
24
|
+
persona?: string;
|
|
25
|
+
model?: string;
|
|
26
|
+
// Optional comma-separated extension names under .pi/extensions/ to load into
|
|
27
|
+
// this peer (routes it through `just _peer-plus` instead of `just _peer`).
|
|
28
|
+
extensions?: string;
|
|
29
|
+
// Optional repo-relative KEY=VALUE file injected as the pane's env at spawn
|
|
30
|
+
// (herdr injects it before the command runs — no shell `source`).
|
|
31
|
+
env_file?: string;
|
|
32
|
+
// Optional runner. Default (absent) is a pi peer via `_peer`/`_peer-plus`;
|
|
33
|
+
// "claude-code" spawns an interactive Claude Code plus its coms bridge in
|
|
34
|
+
// the pane via `_claude-peer` (model → `claude --model`).
|
|
35
|
+
runner?: string;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
function stripQuotes(v: string): string {
|
|
39
|
+
if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'"))) {
|
|
40
|
+
return v.slice(1, -1);
|
|
41
|
+
}
|
|
42
|
+
return v;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
// Minimal parser for the specific peers.yaml shape (team → list of {name,persona,model}).
|
|
46
|
+
// Not a general YAML parser; tolerant of comments and blank lines only.
|
|
47
|
+
export function parsePeersYaml(raw: string): Record<string, Peer[]> {
|
|
48
|
+
const teams: Record<string, Peer[]> = {};
|
|
49
|
+
let currentTeam: string | null = null;
|
|
50
|
+
let currentPeer: Peer | null = null;
|
|
51
|
+
|
|
52
|
+
for (const rawLine of raw.split("\n")) {
|
|
53
|
+
const line = rawLine.replace(/\s+$/, "");
|
|
54
|
+
if (line.trim() === "" || /^\s*#/.test(line)) continue;
|
|
55
|
+
const indent = line.length - line.trimStart().length;
|
|
56
|
+
const content = line.trim();
|
|
57
|
+
|
|
58
|
+
if (indent === 0) {
|
|
59
|
+
const m = content.match(/^([A-Za-z0-9_-]+):\s*$/);
|
|
60
|
+
if (m) {
|
|
61
|
+
currentTeam = m[1];
|
|
62
|
+
teams[currentTeam] = [];
|
|
63
|
+
currentPeer = null;
|
|
64
|
+
}
|
|
65
|
+
continue;
|
|
66
|
+
}
|
|
67
|
+
if (!currentTeam) continue;
|
|
68
|
+
|
|
69
|
+
const itemM = content.match(/^-\s*([A-Za-z0-9_]+):\s*(.+)$/);
|
|
70
|
+
if (itemM) {
|
|
71
|
+
currentPeer = {};
|
|
72
|
+
teams[currentTeam].push(currentPeer);
|
|
73
|
+
(currentPeer as Record<string, string>)[itemM[1]] = stripQuotes(itemM[2]);
|
|
74
|
+
continue;
|
|
75
|
+
}
|
|
76
|
+
const fieldM = content.match(/^([A-Za-z0-9_]+):\s*(.+)$/);
|
|
77
|
+
if (fieldM && currentPeer) {
|
|
78
|
+
(currentPeer as Record<string, string>)[fieldM[1]] = stripQuotes(fieldM[2]);
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
return teams;
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
// Validate a peer's fields and build its launch argv. `just` recipe params are
|
|
85
|
+
// POSITIONAL (persona name model session) — bare positional args, never
|
|
86
|
+
// key=value. A peer with `extensions:` routes through `_peer-plus
|
|
87
|
+
// <extensions> <persona> <name> [<model>] [<session>]`; otherwise plain
|
|
88
|
+
// `_peer <persona> <name> [<model>] [<session>]`. `resumeRef` (a pi session
|
|
89
|
+
// path for `pi --session`) fills the trailing session positional — when the
|
|
90
|
+
// peer has no model, an empty-string placeholder keeps the positions aligned.
|
|
91
|
+
export function peerCommand(p: Peer, team: string, resumeRef?: string, project = DEFAULT_PROJECT): string[] {
|
|
92
|
+
validateProject(project);
|
|
93
|
+
if (p.runner !== undefined && p.runner !== "claude-code") {
|
|
94
|
+
throw new Error(`Unknown runner "${p.runner}" for peer "${p.name}" in team "${team}" (supported: claude-code).`);
|
|
95
|
+
}
|
|
96
|
+
if (!p.persona && p.runner !== "claude-code") {
|
|
97
|
+
throw new Error(`Peer "${p.name ?? "(unnamed)"}" in team "${team}" is missing a persona.`);
|
|
98
|
+
}
|
|
99
|
+
if (!p.name) {
|
|
100
|
+
throw new Error(`Peer with persona "${p.persona}" in team "${team}" is missing a name.`);
|
|
101
|
+
}
|
|
102
|
+
for (const [k, v] of Object.entries(p)) {
|
|
103
|
+
// Only string fields can reach a command line; extra non-string fields
|
|
104
|
+
// (e.g. a snapshot's `resume` object) are never spliced into argv.
|
|
105
|
+
if (typeof v === "string" && !SAFE.test(v)) {
|
|
106
|
+
throw new Error(`Unsafe value for ${k} in team "${team}": ${JSON.stringify(v)} (allowed: ${SAFE})`);
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
if (resumeRef !== undefined && !SAFE.test(resumeRef)) {
|
|
110
|
+
throw new Error(`Unsafe resume ref for ${p.name}: ${JSON.stringify(resumeRef)} (allowed: ${SAFE})`);
|
|
111
|
+
}
|
|
112
|
+
if (p.runner === "claude-code" && p.extensions) {
|
|
113
|
+
throw new Error(`Peer "${p.name}": extensions: are pi-only and cannot combine with runner: claude-code.`);
|
|
114
|
+
}
|
|
115
|
+
const parts =
|
|
116
|
+
p.runner === "claude-code"
|
|
117
|
+
? ["just", "_claude-peer", p.name]
|
|
118
|
+
: p.extensions
|
|
119
|
+
? ["just", "_peer-plus", p.extensions, p.persona, p.name]
|
|
120
|
+
: ["just", "_peer", p.persona, p.name];
|
|
121
|
+
if (p.model) parts.push(p.model);
|
|
122
|
+
if (resumeRef !== undefined) {
|
|
123
|
+
if (!p.model) parts.push(""); // keep the model positional aligned
|
|
124
|
+
parts.push(resumeRef);
|
|
125
|
+
}
|
|
126
|
+
if (project !== DEFAULT_PROJECT) {
|
|
127
|
+
if (!p.model && resumeRef === undefined) parts.push("");
|
|
128
|
+
if (resumeRef === undefined) parts.push("");
|
|
129
|
+
parts.push(project);
|
|
130
|
+
}
|
|
131
|
+
return parts;
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
// Parse a KEY=VALUE env file (B3): no shell evaluation, no expansion.
|
|
135
|
+
// Blank lines and #-comments are skipped; values may be single- or
|
|
136
|
+
// double-quoted (quotes stripped, contents taken literally).
|
|
137
|
+
export function parseEnvFile(raw: string, sourceName = "env file"): Record<string, string> {
|
|
138
|
+
const env: Record<string, string> = {};
|
|
139
|
+
const lines = raw.split("\n");
|
|
140
|
+
for (let i = 0; i < lines.length; i++) {
|
|
141
|
+
const line = lines[i].trim();
|
|
142
|
+
if (line === "" || line.startsWith("#")) continue;
|
|
143
|
+
const m = line.match(/^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)=(.*)$/);
|
|
144
|
+
if (!m) {
|
|
145
|
+
throw new Error(`${sourceName}:${i + 1}: not a KEY=VALUE line: ${JSON.stringify(line)}`);
|
|
146
|
+
}
|
|
147
|
+
env[m[1]] = stripQuotes(m[2].trim());
|
|
148
|
+
}
|
|
149
|
+
return env;
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
// Resolve a peer's env_file to an absolute path inside the repo. The SAFE
|
|
153
|
+
// charset (enforced on every peer field) already excludes shell metacharacters;
|
|
154
|
+
// this adds the traversal guard: repo-relative, no escaping the repo root.
|
|
155
|
+
export function resolveEnvFilePath(envFile: string, repoRoot: string): string {
|
|
156
|
+
if (!SAFE.test(envFile)) {
|
|
157
|
+
throw new Error(`Unsafe env_file path: ${JSON.stringify(envFile)} (allowed: ${SAFE})`);
|
|
158
|
+
}
|
|
159
|
+
if (envFile.startsWith("/")) {
|
|
160
|
+
throw new Error(`env_file must be repo-relative, got absolute path: ${envFile}`);
|
|
161
|
+
}
|
|
162
|
+
const abs = resolvePath(repoRoot, envFile);
|
|
163
|
+
if (abs !== repoRoot && !abs.startsWith(repoRoot + "/")) {
|
|
164
|
+
throw new Error(`env_file escapes the repo root: ${envFile}`);
|
|
165
|
+
}
|
|
166
|
+
return abs;
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
export interface TeamLayoutOptions {
|
|
170
|
+
team: string;
|
|
171
|
+
peers: Peer[];
|
|
172
|
+
repoRoot: string;
|
|
173
|
+
// B3 hook: resolve a peer's extra env (e.g. from its env_file). Returning
|
|
174
|
+
// undefined means no extra env for that peer.
|
|
175
|
+
envForPeer?: (peer: Peer) => Record<string, string> | undefined;
|
|
176
|
+
// B5 hook: resume ref (pi session path) for a peer being restored from a
|
|
177
|
+
// team snapshot. Returning undefined starts the peer fresh.
|
|
178
|
+
resumeForPeer?: (peer: Peer) => string | undefined;
|
|
179
|
+
// Pre-warm/stagger hook (see spawn-stagger.ts): seconds this pane should
|
|
180
|
+
// sleep before launching pi, injected as AGENT_FLEET_SPAWN_DELAY in the
|
|
181
|
+
// pane env. undefined or 0 launches immediately.
|
|
182
|
+
delayForPeer?: (peer: Peer) => number | undefined;
|
|
183
|
+
// B2 hook: when set, the hub occupies a larger root pane (ratio of the
|
|
184
|
+
// horizontal split) and the team tiles in the remaining space.
|
|
185
|
+
// Coms project scope shared by all panes in this layout. The default keeps
|
|
186
|
+
// existing argv shapes; non-default projects are appended to hidden recipe
|
|
187
|
+
// positional args after model/session.
|
|
188
|
+
project?: string;
|
|
189
|
+
hub?: { command: string[]; label: string; ratio?: number; cwd?: string; env?: Record<string, string> };
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
function paneNode(
|
|
193
|
+
peer: Peer,
|
|
194
|
+
team: string,
|
|
195
|
+
repoRoot: string,
|
|
196
|
+
envForPeer?: TeamLayoutOptions["envForPeer"],
|
|
197
|
+
resumeForPeer?: TeamLayoutOptions["resumeForPeer"],
|
|
198
|
+
project = DEFAULT_PROJECT,
|
|
199
|
+
delayForPeer?: TeamLayoutOptions["delayForPeer"],
|
|
200
|
+
): LayoutNode {
|
|
201
|
+
validateProject(project);
|
|
202
|
+
const env = { ...envForPeer?.(peer) };
|
|
203
|
+
const delay = delayForPeer?.(peer);
|
|
204
|
+
if (delay !== undefined) {
|
|
205
|
+
if (!Number.isFinite(delay) || delay < 0) {
|
|
206
|
+
throw new Error(`Invalid spawn delay for peer "${peer.name}": ${delay}`);
|
|
207
|
+
}
|
|
208
|
+
if (delay > 0) env[STAGGER_ENV_VAR] = String(Math.round(delay));
|
|
209
|
+
}
|
|
210
|
+
return {
|
|
211
|
+
type: "pane",
|
|
212
|
+
command: peerCommand(peer, team, resumeForPeer?.(peer), project),
|
|
213
|
+
cwd: repoRoot,
|
|
214
|
+
label: peer.name as string,
|
|
215
|
+
...(Object.keys(env).length > 0 ? { env } : {}),
|
|
216
|
+
};
|
|
217
|
+
}
|
|
218
|
+
|
|
219
|
+
// Balanced BSP over a list of panes: split the list in half, alternating
|
|
220
|
+
// split direction by depth — the herdr equivalent of tmux's tiled layout.
|
|
221
|
+
function bsp(nodes: LayoutNode[], depth: number): LayoutNode {
|
|
222
|
+
if (nodes.length === 1) return nodes[0];
|
|
223
|
+
const mid = Math.ceil(nodes.length / 2);
|
|
224
|
+
return {
|
|
225
|
+
type: "split",
|
|
226
|
+
direction: depth % 2 === 0 ? "right" : "down",
|
|
227
|
+
ratio: mid / nodes.length,
|
|
228
|
+
first: bsp(nodes.slice(0, mid), depth + 1),
|
|
229
|
+
second: bsp(nodes.slice(mid), depth + 1),
|
|
230
|
+
};
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
// peers.yaml team → herdr layout tree for layout.apply.
|
|
234
|
+
export function buildTeamLayout(opts: TeamLayoutOptions): LayoutNode {
|
|
235
|
+
const { team, peers, repoRoot, envForPeer, resumeForPeer, delayForPeer, hub, project = DEFAULT_PROJECT } = opts;
|
|
236
|
+
validateProject(project);
|
|
237
|
+
if (peers.length === 0) {
|
|
238
|
+
if (!hub) throw new Error(`Team "${team}" has no peers.`);
|
|
239
|
+
return {
|
|
240
|
+
type: "pane",
|
|
241
|
+
command: hub.command,
|
|
242
|
+
cwd: hub.cwd ?? repoRoot,
|
|
243
|
+
label: hub.label,
|
|
244
|
+
...(hub.env && Object.keys(hub.env).length > 0 ? { env: hub.env } : {}),
|
|
245
|
+
};
|
|
246
|
+
}
|
|
247
|
+
const panes = peers.map((p) => paneNode(p, team, repoRoot, envForPeer, resumeForPeer, project, delayForPeer));
|
|
248
|
+
const grid = bsp(panes, hub ? 1 : 0);
|
|
249
|
+
if (!hub) return grid;
|
|
250
|
+
return {
|
|
251
|
+
type: "split",
|
|
252
|
+
direction: "right",
|
|
253
|
+
ratio: hub.ratio ?? 0.4,
|
|
254
|
+
first: {
|
|
255
|
+
type: "pane",
|
|
256
|
+
command: hub.command,
|
|
257
|
+
cwd: hub.cwd ?? repoRoot,
|
|
258
|
+
label: hub.label,
|
|
259
|
+
...(hub.env && Object.keys(hub.env).length > 0 ? { env: hub.env } : {}),
|
|
260
|
+
},
|
|
261
|
+
second: grid,
|
|
262
|
+
};
|
|
263
|
+
}
|
|
@@ -0,0 +1,241 @@
|
|
|
1
|
+
// scripts/lib/hermes-bridge-core.ts
|
|
2
|
+
//
|
|
3
|
+
// Pure logic for the Hermes ⇄ coms bridge: qid correlation, Telegram
|
|
4
|
+
// formatting, answer-file validation, answer mapping, timeout outcomes,
|
|
5
|
+
// state transitions, and ndjson log records. No sockets, no fs, no Hermes CLI.
|
|
6
|
+
|
|
7
|
+
import * as os from "node:os";
|
|
8
|
+
import * as path from "node:path";
|
|
9
|
+
|
|
10
|
+
export const QID_RE = /^[0-9A-HJKMNP-TV-Z]{26}$/;
|
|
11
|
+
export const TELEGRAM_TEXT_LIMIT = 4096;
|
|
12
|
+
export const DEFAULT_REMOTE_TIMEOUT_MS = 1_800_000;
|
|
13
|
+
export const HUB_Q_PREFIX = "HUB-Q";
|
|
14
|
+
export const ANSWER_FILE_SUFFIX = ".answer.json";
|
|
15
|
+
|
|
16
|
+
export const BRIDGE_EVENT_NAMES = [
|
|
17
|
+
"question_received",
|
|
18
|
+
"delivered",
|
|
19
|
+
"delivery_error",
|
|
20
|
+
"answered",
|
|
21
|
+
"cancelled",
|
|
22
|
+
"timeout",
|
|
23
|
+
"late_answer",
|
|
24
|
+
] as const;
|
|
25
|
+
|
|
26
|
+
export type BridgeEventName = (typeof BRIDGE_EVENT_NAMES)[number];
|
|
27
|
+
export type QuestionState = "pending" | "delivered" | "answered" | "cancelled" | "timeout";
|
|
28
|
+
|
|
29
|
+
export interface QuestionOption {
|
|
30
|
+
title: string;
|
|
31
|
+
description?: string;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
export interface HermesBridgeQuestion {
|
|
35
|
+
qid: string;
|
|
36
|
+
project: string;
|
|
37
|
+
question: string;
|
|
38
|
+
context?: string;
|
|
39
|
+
options?: QuestionOption[];
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
export interface HermesAnswerFile {
|
|
43
|
+
qid: string;
|
|
44
|
+
answer: string;
|
|
45
|
+
answered_by: string;
|
|
46
|
+
at: string;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
export type AskResponse =
|
|
50
|
+
| { kind: "selection"; selections: string[]; comment?: string }
|
|
51
|
+
| { kind: "freeform"; text: string };
|
|
52
|
+
|
|
53
|
+
export type AnswerRejectReason =
|
|
54
|
+
| "invalid_path"
|
|
55
|
+
| "invalid_qid"
|
|
56
|
+
| "foreign_qid"
|
|
57
|
+
| "invalid_json"
|
|
58
|
+
| "invalid_schema"
|
|
59
|
+
| "qid_mismatch";
|
|
60
|
+
|
|
61
|
+
export type AnswerFileValidation =
|
|
62
|
+
| { ok: true; qid: string; answer: HermesAnswerFile }
|
|
63
|
+
| { ok: false; reason: AnswerRejectReason; qid?: string; detail?: string };
|
|
64
|
+
|
|
65
|
+
export type StateTransition =
|
|
66
|
+
| { ok: true; state: QuestionState | null }
|
|
67
|
+
| { ok: false; reason: "unsupported_transition"; state: QuestionState | null; event: BridgeEventName };
|
|
68
|
+
|
|
69
|
+
export interface LogRecord {
|
|
70
|
+
at: string;
|
|
71
|
+
qid: string;
|
|
72
|
+
event: BridgeEventName;
|
|
73
|
+
detail?: unknown;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
export function hermesBridgeDir(home = os.homedir()): string {
|
|
77
|
+
return path.join(home, ".pi", "coms", "hermes-bridge");
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
export function questionsDir(home = os.homedir()): string {
|
|
81
|
+
return path.join(hermesBridgeDir(home), "questions");
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
export function logPath(home = os.homedir()): string {
|
|
85
|
+
return path.join(hermesBridgeDir(home), "log.ndjson");
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
export function answerFilePath(qid: string, dir = questionsDir()): string {
|
|
89
|
+
return path.join(dir, `${qid}${ANSWER_FILE_SUFFIX}`);
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
export function isValidQid(qid: unknown): qid is string {
|
|
93
|
+
return typeof qid === "string" && QID_RE.test(qid);
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
export function qidFromPromptEnvelope(env: { msg_id?: unknown }): string {
|
|
97
|
+
if (!isValidQid(env.msg_id)) throw new Error("prompt msg_id must be a 26-character Crockford ULID qid");
|
|
98
|
+
return env.msg_id;
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
function truncateUtf16(text: string, limit: number): string {
|
|
102
|
+
if (text.length <= limit) return text;
|
|
103
|
+
if (limit <= 0) return "";
|
|
104
|
+
if (limit === 1) return "…";
|
|
105
|
+
return `${text.slice(0, limit - 1)}…`;
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
function formatOptions(options: QuestionOption[]): string {
|
|
109
|
+
return options
|
|
110
|
+
.map((option, index) => {
|
|
111
|
+
const desc = option.description ? ` — ${option.description}` : "";
|
|
112
|
+
return `${index + 1}. ${option.title}${desc}`;
|
|
113
|
+
})
|
|
114
|
+
.join("\n");
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
export function formatTelegramQuestion(input: HermesBridgeQuestion, limit = TELEGRAM_TEXT_LIMIT): string {
|
|
118
|
+
if (!isValidQid(input.qid)) throw new Error("qid must be a 26-character Crockford ULID");
|
|
119
|
+
const options = input.options ?? [];
|
|
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}`;
|
|
123
|
+
const optionsBlock = options.length > 0 ? `\n\nOptions:\n${formatOptions(options)}` : "";
|
|
124
|
+
const instruction = `\n\n↩ Reply to this message, or type: ${HUB_Q_PREFIX}:${input.qid}: <answer>`;
|
|
125
|
+
const contextPrefix = input.context ? "\n\nContext: " : "";
|
|
126
|
+
const fixedLength = header.length + projectBlock.length + contextPrefix.length + optionsBlock.length + instruction.length;
|
|
127
|
+
const contextBudget = Math.max(0, limit - fixedLength);
|
|
128
|
+
const context = input.context ? truncateUtf16(input.context, contextBudget) : "";
|
|
129
|
+
return truncateUtf16(`${header}${projectBlock}${contextPrefix}${context}${optionsBlock}${instruction}`, limit);
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
export function mapAnswerToAskResponse(answer: string, options: QuestionOption[] = []): AskResponse {
|
|
133
|
+
const text = answer.trim();
|
|
134
|
+
if (options.length > 0) {
|
|
135
|
+
if (/^\d+$/.test(text)) {
|
|
136
|
+
const index = Number(text) - 1;
|
|
137
|
+
const option = options[index];
|
|
138
|
+
if (option) return { kind: "selection", selections: [option.title] };
|
|
139
|
+
}
|
|
140
|
+
const byTitle = options.find((option) => option.title.toLowerCase() === text.toLowerCase());
|
|
141
|
+
if (byTitle) return { kind: "selection", selections: [byTitle.title] };
|
|
142
|
+
}
|
|
143
|
+
return { kind: "freeform", text };
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
function qidFromAnswerPath(filePath: string): { ok: true; qid: string } | { ok: false; reason: AnswerRejectReason } {
|
|
147
|
+
const base = path.basename(filePath);
|
|
148
|
+
if (!base.endsWith(ANSWER_FILE_SUFFIX)) return { ok: false, reason: "invalid_path" };
|
|
149
|
+
const qid = base.slice(0, -ANSWER_FILE_SUFFIX.length);
|
|
150
|
+
if (!isValidQid(qid)) return { ok: false, reason: "invalid_qid" };
|
|
151
|
+
return { ok: true, qid };
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
function isIsoTimestamp(value: string): boolean {
|
|
155
|
+
return !Number.isNaN(Date.parse(value));
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
function schemaValid(value: unknown): value is HermesAnswerFile {
|
|
159
|
+
const rec = value as HermesAnswerFile;
|
|
160
|
+
return (
|
|
161
|
+
!!rec &&
|
|
162
|
+
typeof rec === "object" &&
|
|
163
|
+
isValidQid(rec.qid) &&
|
|
164
|
+
typeof rec.answer === "string" &&
|
|
165
|
+
typeof rec.answered_by === "string" &&
|
|
166
|
+
rec.answered_by.length > 0 &&
|
|
167
|
+
typeof rec.at === "string" &&
|
|
168
|
+
isIsoTimestamp(rec.at)
|
|
169
|
+
);
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
export function validateAnswerFile(
|
|
173
|
+
raw: string,
|
|
174
|
+
filePath: string,
|
|
175
|
+
livePendingQids: Iterable<string>,
|
|
176
|
+
): AnswerFileValidation {
|
|
177
|
+
const pathQid = qidFromAnswerPath(filePath);
|
|
178
|
+
if (!pathQid.ok) return { ok: false, reason: pathQid.reason };
|
|
179
|
+
const pending = new Set(livePendingQids);
|
|
180
|
+
if (!pending.has(pathQid.qid)) return { ok: false, reason: "foreign_qid", qid: pathQid.qid };
|
|
181
|
+
|
|
182
|
+
let parsed: unknown;
|
|
183
|
+
try {
|
|
184
|
+
parsed = JSON.parse(raw);
|
|
185
|
+
} catch (err) {
|
|
186
|
+
return { ok: false, reason: "invalid_json", qid: pathQid.qid, detail: err instanceof Error ? err.message : String(err) };
|
|
187
|
+
}
|
|
188
|
+
if (!schemaValid(parsed)) return { ok: false, reason: "invalid_schema", qid: pathQid.qid };
|
|
189
|
+
if (parsed.qid !== pathQid.qid) return { ok: false, reason: "qid_mismatch", qid: pathQid.qid };
|
|
190
|
+
return { ok: true, qid: pathQid.qid, answer: parsed };
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
export function timeoutMsFromEnv(env: Pick<NodeJS.ProcessEnv, "PI_COMS_TIMEOUT_MS"> = process.env): number {
|
|
194
|
+
const raw = env.PI_COMS_TIMEOUT_MS;
|
|
195
|
+
if (!raw) return DEFAULT_REMOTE_TIMEOUT_MS;
|
|
196
|
+
const n = Number(raw);
|
|
197
|
+
return Number.isFinite(n) && n > 0 ? n : DEFAULT_REMOTE_TIMEOUT_MS;
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
export function timeoutErrorMessage(timeoutMs: number): string {
|
|
201
|
+
return `no remote answer within ${timeoutMs}ms`;
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
export function timeoutTelegramNote(qid: string, timeoutMs: number): string {
|
|
205
|
+
return `⌛ [${HUB_Q_PREFIX}:${qid}] The question timed out after ${timeoutMs}ms.`;
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
export function timeoutOutcome(qid: string, timeoutMs = timeoutMsFromEnv()): {
|
|
209
|
+
response: null;
|
|
210
|
+
error: string;
|
|
211
|
+
telegramNote: string;
|
|
212
|
+
} {
|
|
213
|
+
return {
|
|
214
|
+
response: null,
|
|
215
|
+
error: timeoutErrorMessage(timeoutMs),
|
|
216
|
+
telegramNote: timeoutTelegramNote(qid, timeoutMs),
|
|
217
|
+
};
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
export function transitionState(state: QuestionState | null, event: BridgeEventName): StateTransition {
|
|
221
|
+
if (state === null && event === "question_received") return { ok: true, state: "pending" };
|
|
222
|
+
if (state === "pending" && event === "delivered") return { ok: true, state: "delivered" };
|
|
223
|
+
if (state === "pending" && event === "delivery_error") return { ok: true, state: null };
|
|
224
|
+
if ((state === "pending" || state === "delivered") && event === "cancelled") return { ok: true, state: "cancelled" };
|
|
225
|
+
if ((state === "pending" || state === "delivered") && event === "timeout") return { ok: true, state: "timeout" };
|
|
226
|
+
if (state === "delivered" && event === "answered") return { ok: true, state: "answered" };
|
|
227
|
+
if ((state === "answered" || state === "cancelled" || state === "timeout") && event === "late_answer") {
|
|
228
|
+
return { ok: true, state };
|
|
229
|
+
}
|
|
230
|
+
return { ok: false, reason: "unsupported_transition", state, event };
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
export function makeLogRecord(qid: string, event: BridgeEventName, detail?: unknown, at = new Date().toISOString()): LogRecord {
|
|
234
|
+
if (!isValidQid(qid)) throw new Error("qid must be a 26-character Crockford ULID");
|
|
235
|
+
if (!BRIDGE_EVENT_NAMES.includes(event)) throw new Error(`unsupported bridge event: ${event}`);
|
|
236
|
+
return detail === undefined ? { at, qid, event } : { at, qid, event, detail };
|
|
237
|
+
}
|
|
238
|
+
|
|
239
|
+
export function renderLogRecord(record: LogRecord): string {
|
|
240
|
+
return `${JSON.stringify(record)}\n`;
|
|
241
|
+
}
|