@chankov/agent-fleet 0.0.3 → 0.0.4
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/setup-agent-fleet.md +1 -1
- package/.opencode/commands/af-setup-agent-fleet.md +1 -1
- package/.pi/harnesses/agent-hub/README.md +199 -16
- 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 +1033 -242
- 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/coms/README.md +10 -0
- 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 +32 -31
- 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/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/CHANGELOG.md +53 -0
- package/README.md +3 -3
- 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/lib/validate-overrides.js +19 -0
- package/bin/sync-harness-versions.js +94 -0
- package/docs/ARCHITECTURE.md +46 -1
- package/docs/agent-fleet-setup.md +10 -0
- package/docs/pi-extensions.md +49 -14
- package/docs/pi-setup.md +10 -4
- package/hermes/README.md +180 -0
- package/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +10 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
- package/justfile +6 -10
- package/package.json +9 -4
- package/scripts/lib/fake-herdr-server.ts +88 -0
- package/scripts/lib/hermes-monitor-herdr.ts +28 -0
- package/scripts/lib/hermes-monitor-model.ts +9 -0
- package/scripts/lib/hermes-monitor-registry.ts +6 -0
- package/scripts/lib/hermes-monitor-socket.ts +118 -0
- package/scripts/lib/hermes-monitor-store.ts +31 -0
- 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 +11 -8
- package/.pi/harnesses/damage-control/README.md +0 -65
- package/.pi/harnesses/damage-control/index.ts +0 -250
|
@@ -0,0 +1,286 @@
|
|
|
1
|
+
// scripts/coms-claude-bridge.ts
|
|
2
|
+
//
|
|
3
|
+
// The Claude Code ↔ coms bridge: one bridge per Claude Code pane, launched
|
|
4
|
+
// next to it (the `_claude-peer` recipe backgrounds the bridge in the same
|
|
5
|
+
// herdr pane). It makes an interactive Claude Code a first-class coms peer:
|
|
6
|
+
//
|
|
7
|
+
// (a) binds a coms endpoint + registry entry under --name, so the Claude
|
|
8
|
+
// pane appears in every pool widget and is addressable via coms_send;
|
|
9
|
+
// (b) inbound prompt envelope → pane.send_text into the Claude pane
|
|
10
|
+
// (+ Enter as a separate send — spike quirk);
|
|
11
|
+
// (c) completion, primary path: the Claude Code Stop hook
|
|
12
|
+
// (hooks/coms-stop-hook.mjs) writes the turn's last message to
|
|
13
|
+
// ~/.pi/coms/claude-bridge/<pane>/last-message.json; fallback when no
|
|
14
|
+
// hook has ever fired for this pane: a <<COMS_DONE:msg_id>> sentinel is
|
|
15
|
+
// requested in the prompt and scraped via pane.read after herdr reports
|
|
16
|
+
// the agent done;
|
|
17
|
+
// (d) sends the response envelope back to the sender;
|
|
18
|
+
// (e) a `blocked` agent status returns a readable error envelope instead of
|
|
19
|
+
// hanging until timeout;
|
|
20
|
+
// (f) prompts are strictly serialized per pane; queue depth is reported in
|
|
21
|
+
// the agent card + herdr custom_status.
|
|
22
|
+
//
|
|
23
|
+
// usage: coms-claude-bridge.ts --name <peer-name> [--pane <pane_id>]
|
|
24
|
+
// [--project <p>] [--reply-timeout <ms>]
|
|
25
|
+
// --pane defaults to HERDR_PANE_ID (set inside every herdr pane).
|
|
26
|
+
|
|
27
|
+
import * as fs from "node:fs";
|
|
28
|
+
import * as os from "node:os";
|
|
29
|
+
import * as path from "node:path";
|
|
30
|
+
import { fileURLToPath } from "node:url";
|
|
31
|
+
|
|
32
|
+
import {
|
|
33
|
+
bindEndpoint,
|
|
34
|
+
ensureComsDirs,
|
|
35
|
+
isPromptEnvelope,
|
|
36
|
+
makeConnHandler,
|
|
37
|
+
makeEndpoint,
|
|
38
|
+
makeResponseEnvelope,
|
|
39
|
+
nowIso,
|
|
40
|
+
removeRegistryEntry,
|
|
41
|
+
resolveUniqueName,
|
|
42
|
+
sendEnvelope,
|
|
43
|
+
ulid,
|
|
44
|
+
writeAck,
|
|
45
|
+
writeNack,
|
|
46
|
+
writeRegistryAtomic,
|
|
47
|
+
type AgentCard,
|
|
48
|
+
type PromptEnvelope,
|
|
49
|
+
type RegistryEntry,
|
|
50
|
+
type SenderIdentity,
|
|
51
|
+
} from "./lib/coms-envelope.ts";
|
|
52
|
+
import {
|
|
53
|
+
extractSentinelReply,
|
|
54
|
+
formatPanePrompt,
|
|
55
|
+
parseHookRecord,
|
|
56
|
+
PromptQueue,
|
|
57
|
+
} from "./lib/claude-bridge-core.ts";
|
|
58
|
+
import { herdr, requireHerdr, HerdrUnavailableError } from "../.pi/harnesses/lib/herdr-client.ts";
|
|
59
|
+
|
|
60
|
+
const KEEPALIVE_MS = 30_000;
|
|
61
|
+
const ENTER_DELAY_MS = 1_500;
|
|
62
|
+
const POLL_MS = 1_000;
|
|
63
|
+
const DEFAULT_REPLY_TIMEOUT_MS = 600_000;
|
|
64
|
+
const COLOR = "#FF8B39";
|
|
65
|
+
|
|
66
|
+
function flagValue(argv: string[], flag: string): string | null {
|
|
67
|
+
const i = argv.indexOf(flag);
|
|
68
|
+
return i >= 0 && i + 1 < argv.length ? argv[i + 1] : null;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
function die(msg: string): never {
|
|
72
|
+
console.error(`coms-claude-bridge: ${msg}`);
|
|
73
|
+
process.exit(1);
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
export function hookWatchDir(paneId: string): string {
|
|
77
|
+
return path.join(os.homedir(), ".pi", "coms", "claude-bridge", paneId.replace(/[^A-Za-z0-9_-]/g, "_"));
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
async function main(): Promise<void> {
|
|
81
|
+
const argv = process.argv.slice(2);
|
|
82
|
+
const name = flagValue(argv, "--name") ?? die("--name <peer-name> is required");
|
|
83
|
+
const project = flagValue(argv, "--project") ?? "default";
|
|
84
|
+
const paneId = flagValue(argv, "--pane") ?? process.env.HERDR_PANE_ID ?? die("--pane <pane_id> required (or run inside a herdr pane)");
|
|
85
|
+
const replyTimeoutMs = Number(flagValue(argv, "--reply-timeout") ?? DEFAULT_REPLY_TIMEOUT_MS);
|
|
86
|
+
|
|
87
|
+
try {
|
|
88
|
+
await requireHerdr();
|
|
89
|
+
} catch (err) {
|
|
90
|
+
if (err instanceof HerdrUnavailableError) die(err.message);
|
|
91
|
+
throw err;
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
// ── identity ──
|
|
95
|
+
ensureComsDirs(project);
|
|
96
|
+
const sessionId = ulid();
|
|
97
|
+
const uniqueName = resolveUniqueName(project, name);
|
|
98
|
+
const id: SenderIdentity = {
|
|
99
|
+
session_id: sessionId,
|
|
100
|
+
name: uniqueName,
|
|
101
|
+
endpoint: makeEndpoint(sessionId),
|
|
102
|
+
cwd: process.cwd(),
|
|
103
|
+
};
|
|
104
|
+
const queue = new PromptQueue<PromptEnvelope>();
|
|
105
|
+
const purpose = "Claude Code (bridged pane)";
|
|
106
|
+
|
|
107
|
+
function registryEntry(): RegistryEntry {
|
|
108
|
+
return {
|
|
109
|
+
session_id: sessionId,
|
|
110
|
+
name: uniqueName,
|
|
111
|
+
purpose,
|
|
112
|
+
model: "claude-code",
|
|
113
|
+
color: COLOR,
|
|
114
|
+
pid: process.pid,
|
|
115
|
+
endpoint: id.endpoint,
|
|
116
|
+
cwd: id.cwd,
|
|
117
|
+
started_at: nowIso(),
|
|
118
|
+
explicit: false,
|
|
119
|
+
version: 1,
|
|
120
|
+
context_used_pct: 0,
|
|
121
|
+
queue_depth: queue.depth,
|
|
122
|
+
heartbeat_at: nowIso(),
|
|
123
|
+
};
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
const hookDir = hookWatchDir(paneId);
|
|
127
|
+
fs.mkdirSync(hookDir, { recursive: true });
|
|
128
|
+
const hookFile = path.join(hookDir, "last-message.json");
|
|
129
|
+
// Hook mode flips on permanently the first time the Stop hook writes for
|
|
130
|
+
// this pane; until then prompts carry the sentinel instruction.
|
|
131
|
+
let hookSeen = fs.existsSync(hookFile);
|
|
132
|
+
|
|
133
|
+
// ── envelope server ──
|
|
134
|
+
const server = await bindEndpoint(
|
|
135
|
+
id.endpoint,
|
|
136
|
+
makeConnHandler((env, socket) => {
|
|
137
|
+
if (isPromptEnvelope(env)) {
|
|
138
|
+
if (env.hops >= 5) {
|
|
139
|
+
writeNack(socket, env.msg_id, "hops exceeded");
|
|
140
|
+
return;
|
|
141
|
+
}
|
|
142
|
+
queue.push(env);
|
|
143
|
+
writeAck(socket, env.msg_id);
|
|
144
|
+
void pump();
|
|
145
|
+
} else if ((env as { type?: string }).type === "ping") {
|
|
146
|
+
const card: AgentCard = {
|
|
147
|
+
name: uniqueName,
|
|
148
|
+
purpose,
|
|
149
|
+
model: "claude-code",
|
|
150
|
+
color: COLOR,
|
|
151
|
+
context_used_pct: 0,
|
|
152
|
+
queue_depth: queue.depth,
|
|
153
|
+
};
|
|
154
|
+
try {
|
|
155
|
+
socket.write(JSON.stringify({ type: "pong", msg_id: (env as { msg_id?: string }).msg_id ?? "", agent_card: card }) + "\n");
|
|
156
|
+
} catch { /* ignore */ }
|
|
157
|
+
try { socket.end(); } catch { /* ignore */ }
|
|
158
|
+
} else {
|
|
159
|
+
writeNack(socket, (env as { msg_id?: string }).msg_id ?? "", "bridge accepts prompts and pings");
|
|
160
|
+
}
|
|
161
|
+
}),
|
|
162
|
+
);
|
|
163
|
+
writeRegistryAtomic(registryEntry(), project);
|
|
164
|
+
console.error(`coms-claude-bridge: ${uniqueName}@${project} bridging pane ${paneId}`);
|
|
165
|
+
|
|
166
|
+
// ── presence ──
|
|
167
|
+
async function reportPresence(): Promise<void> {
|
|
168
|
+
try {
|
|
169
|
+
await herdr.paneReportMetadata({
|
|
170
|
+
pane_id: paneId,
|
|
171
|
+
source: `coms-bridge:${sessionId}`,
|
|
172
|
+
agent: "claude",
|
|
173
|
+
custom_status: `${uniqueName} q${queue.depth}`.slice(0, 32),
|
|
174
|
+
ttl_ms: 90_000,
|
|
175
|
+
});
|
|
176
|
+
} catch { /* best-effort */ }
|
|
177
|
+
}
|
|
178
|
+
const keepalive = setInterval(() => {
|
|
179
|
+
try {
|
|
180
|
+
writeRegistryAtomic(registryEntry(), project);
|
|
181
|
+
} catch { /* best-effort */ }
|
|
182
|
+
void reportPresence();
|
|
183
|
+
}, KEEPALIVE_MS);
|
|
184
|
+
keepalive.unref?.();
|
|
185
|
+
void reportPresence();
|
|
186
|
+
|
|
187
|
+
// ── prompt processing (strictly serial) ──
|
|
188
|
+
async function pump(): Promise<void> {
|
|
189
|
+
const item = queue.take();
|
|
190
|
+
if (!item) return;
|
|
191
|
+
const env = item.envelope;
|
|
192
|
+
try {
|
|
193
|
+
const reply = await driveClaude(env);
|
|
194
|
+
await sendEnvelope(env.sender_endpoint, makeResponseEnvelope(id, env.msg_id, reply));
|
|
195
|
+
} catch (err) {
|
|
196
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
197
|
+
try {
|
|
198
|
+
await sendEnvelope(env.sender_endpoint, makeResponseEnvelope(id, env.msg_id, null, message));
|
|
199
|
+
} catch {
|
|
200
|
+
console.error(`coms-claude-bridge: could not deliver error for ${env.msg_id}: ${message}`);
|
|
201
|
+
}
|
|
202
|
+
} finally {
|
|
203
|
+
queue.done();
|
|
204
|
+
void reportPresence();
|
|
205
|
+
void pump(); // next in line
|
|
206
|
+
}
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
async function paneStatus(): Promise<string> {
|
|
210
|
+
try {
|
|
211
|
+
const { pane } = await herdr.paneGet(paneId);
|
|
212
|
+
return (pane.agent_status as string) ?? "unknown";
|
|
213
|
+
} catch {
|
|
214
|
+
return "unknown";
|
|
215
|
+
}
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
async function driveClaude(env: PromptEnvelope): Promise<string> {
|
|
219
|
+
const sentinelMode = !hookSeen;
|
|
220
|
+
const hookMtimeBefore = fs.existsSync(hookFile) ? fs.statSync(hookFile).mtimeMs : 0;
|
|
221
|
+
|
|
222
|
+
// Claude Code must be idle-ish before we type into its input box.
|
|
223
|
+
const before = await paneStatus();
|
|
224
|
+
if (before === "working") {
|
|
225
|
+
throw new Error(`Claude Code in pane ${paneId} is mid-turn (working) — try again shortly`);
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
await herdr.paneSendText(paneId, formatPanePrompt(env, sentinelMode));
|
|
229
|
+
await new Promise((r) => setTimeout(r, ENTER_DELAY_MS));
|
|
230
|
+
await herdr.paneSendKeys(paneId, ["enter"]);
|
|
231
|
+
|
|
232
|
+
const deadline = Date.now() + replyTimeoutMs;
|
|
233
|
+
let sawWorking = false;
|
|
234
|
+
while (Date.now() < deadline) {
|
|
235
|
+
await new Promise((r) => setTimeout(r, POLL_MS));
|
|
236
|
+
|
|
237
|
+
// primary: Stop hook wrote a new record
|
|
238
|
+
if (fs.existsSync(hookFile)) {
|
|
239
|
+
const mtime = fs.statSync(hookFile).mtimeMs;
|
|
240
|
+
if (mtime > hookMtimeBefore) {
|
|
241
|
+
const rec = parseHookRecord(fs.readFileSync(hookFile, "utf-8"));
|
|
242
|
+
if (rec) {
|
|
243
|
+
hookSeen = true;
|
|
244
|
+
return rec.text;
|
|
245
|
+
}
|
|
246
|
+
}
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
const status = await paneStatus();
|
|
250
|
+
if (status === "working") sawWorking = true;
|
|
251
|
+
if (status === "blocked") {
|
|
252
|
+
throw new Error(
|
|
253
|
+
`Claude Code in pane ${paneId} is blocked on a permission prompt — a human must approve it in the pane`,
|
|
254
|
+
);
|
|
255
|
+
}
|
|
256
|
+
// fallback: turn ended without a hook record → scrape the sentinel
|
|
257
|
+
if (sentinelMode && sawWorking && (status === "done" || status === "idle")) {
|
|
258
|
+
const read = await herdr.paneRead({ pane_id: paneId, source: "recent", lines: 200 });
|
|
259
|
+
const reply = extractSentinelReply(read.read.text, env.msg_id);
|
|
260
|
+
if (reply) return reply;
|
|
261
|
+
// sentinel not visible yet — keep polling until deadline
|
|
262
|
+
}
|
|
263
|
+
}
|
|
264
|
+
throw new Error(
|
|
265
|
+
`no reply from Claude Code within ${replyTimeoutMs}ms` +
|
|
266
|
+
(sentinelMode ? " (Stop hook not installed? see hooks/coms-stop-hook.mjs)" : ""),
|
|
267
|
+
);
|
|
268
|
+
}
|
|
269
|
+
|
|
270
|
+
// ── shutdown ──
|
|
271
|
+
let shuttingDown = false;
|
|
272
|
+
function shutdown(): void {
|
|
273
|
+
if (shuttingDown) return;
|
|
274
|
+
shuttingDown = true;
|
|
275
|
+
clearInterval(keepalive);
|
|
276
|
+
try { server.close(); } catch { /* ignore */ }
|
|
277
|
+
try { fs.unlinkSync(id.endpoint); } catch { /* ignore */ }
|
|
278
|
+
removeRegistryEntry(project, uniqueName);
|
|
279
|
+
process.exit(0);
|
|
280
|
+
}
|
|
281
|
+
process.on("SIGTERM", shutdown);
|
|
282
|
+
process.on("SIGINT", shutdown);
|
|
283
|
+
}
|
|
284
|
+
|
|
285
|
+
const isEntry = process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
|
|
286
|
+
if (isEntry) void main();
|