@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,302 @@
|
|
|
1
|
+
#!/bin/bash
|
|
2
|
+
# simplify-ignore.sh — Hook for Read (PreToolUse), Edit|Write (PostToolUse), Stop
|
|
3
|
+
#
|
|
4
|
+
# PreToolUse Read → backs up file, replaces blocks with BLOCK_<hash> in-place
|
|
5
|
+
# PostToolUse Edit → expands placeholders, re-filters so file stays hidden
|
|
6
|
+
# PostToolUse Write → expands placeholders, re-filters so file stays hidden
|
|
7
|
+
# Stop → restores real file content from backup
|
|
8
|
+
#
|
|
9
|
+
# The file on disk ALWAYS has placeholders while the session is active.
|
|
10
|
+
# The real content (with model's changes applied) lives in the backup.
|
|
11
|
+
#
|
|
12
|
+
# Dependencies: jq, shasum or sha1sum (auto-detected)
|
|
13
|
+
|
|
14
|
+
set -euo pipefail
|
|
15
|
+
|
|
16
|
+
if ! command -v jq >/dev/null 2>&1; then
|
|
17
|
+
printf '%s\n' "error: missing jq" >&2; exit 1
|
|
18
|
+
fi
|
|
19
|
+
|
|
20
|
+
CACHE="${CLAUDE_PROJECT_DIR:-.}/.claude/.simplify-ignore-cache"
|
|
21
|
+
if [ -t 0 ]; then INPUT="{}"; else INPUT=$(cat); fi
|
|
22
|
+
|
|
23
|
+
# Parse hook input — trap errors explicitly so set -e doesn't cause
|
|
24
|
+
# a silent exit on malformed JSON, and surface a useful diagnostic.
|
|
25
|
+
parse_error=""
|
|
26
|
+
TOOL_NAME=$(printf '%s' "$INPUT" | jq -r '.tool_name // empty' 2>/dev/null) || {
|
|
27
|
+
parse_error="failed to parse .tool_name from hook input"
|
|
28
|
+
TOOL_NAME=""
|
|
29
|
+
}
|
|
30
|
+
FILE_PATH=$(printf '%s' "$INPUT" | jq -r '.tool_input.file_path // empty' 2>/dev/null) || {
|
|
31
|
+
parse_error="failed to parse .tool_input.file_path from hook input"
|
|
32
|
+
FILE_PATH=""
|
|
33
|
+
}
|
|
34
|
+
if [ -n "$parse_error" ]; then
|
|
35
|
+
printf 'Warning: %s (input: %.120s)\n' "$parse_error" "$INPUT" >&2
|
|
36
|
+
fi
|
|
37
|
+
|
|
38
|
+
hash_cmd() {
|
|
39
|
+
if command -v shasum >/dev/null 2>&1; then shasum
|
|
40
|
+
elif command -v sha1sum >/dev/null 2>&1; then sha1sum
|
|
41
|
+
else printf '%s\n' "error: missing shasum or sha1sum" >&2; exit 1; fi
|
|
42
|
+
}
|
|
43
|
+
file_id() { printf '%s' "$1" | hash_cmd | cut -c1-16; }
|
|
44
|
+
block_hash() { printf '%s' "$1" | hash_cmd | cut -c1-8; }
|
|
45
|
+
# Escape glob metacharacters so ${var/pattern/repl} treats pattern as literal.
|
|
46
|
+
# Needed for Bash 3.2 (macOS) where quotes don't suppress globbing in PE patterns.
|
|
47
|
+
escape_glob() {
|
|
48
|
+
local s="$1"
|
|
49
|
+
s="${s//\\/\\\\}"
|
|
50
|
+
s="${s//\*/\\*}"
|
|
51
|
+
s="${s//\?/\\?}"
|
|
52
|
+
s="${s//\[/\\[}"
|
|
53
|
+
printf '%s' "$s"
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
# ── filter_file: replace simplify-ignore blocks with BLOCK_<hash> placeholders ─
|
|
57
|
+
# Reads $1 (source), writes filtered version to $2 (dest), saves blocks to cache.
|
|
58
|
+
# Returns 0 if blocks were found, 1 if none.
|
|
59
|
+
filter_file() {
|
|
60
|
+
local src="$1" dest="$2" fid="$3"
|
|
61
|
+
: > "$dest"
|
|
62
|
+
rm -f "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
|
|
63
|
+
|
|
64
|
+
local count=0 in_block=0 buf="" reason="" prefix="" suffix=""
|
|
65
|
+
|
|
66
|
+
while IFS= read -r line || [ -n "$line" ]; do
|
|
67
|
+
# Check for start marker (no fork — uses bash case)
|
|
68
|
+
if [ $in_block -eq 0 ]; then
|
|
69
|
+
case "$line" in *simplify-ignore-start*)
|
|
70
|
+
in_block=1
|
|
71
|
+
buf="$line"
|
|
72
|
+
# Extract comment prefix/suffix to preserve language-appropriate syntax
|
|
73
|
+
prefix="${line%%simplify-ignore-start*}"
|
|
74
|
+
suffix=""
|
|
75
|
+
case "$line" in *'*/'*) suffix=" */" ;; *'-->'*) suffix=" -->" ;; esac
|
|
76
|
+
reason=$(printf '%s' "$line" | sed -n 's/.*simplify-ignore-start:[[:space:]]*//p' \
|
|
77
|
+
| sed 's/[[:space:]]*\*\/.*$//' | sed 's/[[:space:]]*-->.*$//' | sed 's/[[:space:]]*$//')
|
|
78
|
+
# Handle single-line block (start + end on same line)
|
|
79
|
+
case "$line" in *simplify-ignore-end*)
|
|
80
|
+
in_block=0
|
|
81
|
+
# Write single-line block immediately and skip to next line
|
|
82
|
+
# to avoid the end-marker check below firing again
|
|
83
|
+
local h; h=$(block_hash "$buf")
|
|
84
|
+
count=$((count + 1))
|
|
85
|
+
printf '%s' "$buf" > "$CACHE/${fid}.block.${h}"
|
|
86
|
+
[ -n "$reason" ] && printf '%s' "$reason" > "$CACHE/${fid}.reason.${h}"
|
|
87
|
+
printf '%s' "$prefix" > "$CACHE/${fid}.prefix.${h}"
|
|
88
|
+
printf '%s' "$suffix" > "$CACHE/${fid}.suffix.${h}"
|
|
89
|
+
if [ -n "$reason" ]; then
|
|
90
|
+
printf '%s\n' "${prefix}BLOCK_${h}: ${reason}${suffix}" >> "$dest"
|
|
91
|
+
else
|
|
92
|
+
printf '%s\n' "${prefix}BLOCK_${h}${suffix}" >> "$dest"
|
|
93
|
+
fi
|
|
94
|
+
buf=""; reason=""; prefix=""; suffix=""
|
|
95
|
+
continue
|
|
96
|
+
;; *)
|
|
97
|
+
continue
|
|
98
|
+
;;
|
|
99
|
+
esac
|
|
100
|
+
;; esac
|
|
101
|
+
fi
|
|
102
|
+
# Accumulate block content
|
|
103
|
+
if [ $in_block -eq 1 ]; then
|
|
104
|
+
buf="${buf}
|
|
105
|
+
${line}"
|
|
106
|
+
fi
|
|
107
|
+
# Check for end marker
|
|
108
|
+
case "$line" in *simplify-ignore-end*)
|
|
109
|
+
if [ $in_block -eq 1 ]; then
|
|
110
|
+
local h; h=$(block_hash "$buf")
|
|
111
|
+
count=$((count + 1))
|
|
112
|
+
printf '%s' "$buf" > "$CACHE/${fid}.block.${h}"
|
|
113
|
+
[ -n "$reason" ] && printf '%s' "$reason" > "$CACHE/${fid}.reason.${h}"
|
|
114
|
+
printf '%s' "$prefix" > "$CACHE/${fid}.prefix.${h}"
|
|
115
|
+
printf '%s' "$suffix" > "$CACHE/${fid}.suffix.${h}"
|
|
116
|
+
if [ -n "$reason" ]; then
|
|
117
|
+
printf '%s\n' "${prefix}BLOCK_${h}: ${reason}${suffix}" >> "$dest"
|
|
118
|
+
else
|
|
119
|
+
printf '%s\n' "${prefix}BLOCK_${h}${suffix}" >> "$dest"
|
|
120
|
+
fi
|
|
121
|
+
in_block=0; buf=""; reason=""; prefix=""; suffix=""
|
|
122
|
+
continue
|
|
123
|
+
fi
|
|
124
|
+
;;
|
|
125
|
+
esac
|
|
126
|
+
[ $in_block -eq 0 ] && printf '%s\n' "$line" >> "$dest"
|
|
127
|
+
done < "$src"
|
|
128
|
+
|
|
129
|
+
# Unclosed block → flush as-is
|
|
130
|
+
if [ $in_block -eq 1 ] && [ -n "$buf" ]; then
|
|
131
|
+
printf 'Warning: unclosed simplify-ignore-start in %s (block not hidden)\n' "$src" >&2
|
|
132
|
+
printf '%s\n' "$buf" >> "$dest"
|
|
133
|
+
fi
|
|
134
|
+
|
|
135
|
+
# Preserve trailing newline status of source
|
|
136
|
+
if [ -s "$dest" ] && [ -s "$src" ] && [ -n "$(tail -c 1 "$src")" ]; then
|
|
137
|
+
perl -pe 'chomp if eof' "$dest" > "${dest}.nnl" && \
|
|
138
|
+
cat "${dest}.nnl" > "$dest" && rm -f "${dest}.nnl"
|
|
139
|
+
fi
|
|
140
|
+
|
|
141
|
+
[ $count -gt 0 ] && return 0 || return 1
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
# ── Stop: restore all files from backup ───────────────────────────────────────
|
|
145
|
+
if [ -z "$TOOL_NAME" ]; then
|
|
146
|
+
[ -d "$CACHE" ] || exit 0
|
|
147
|
+
for bak in "$CACHE"/*.bak; do
|
|
148
|
+
[ -f "$bak" ] || continue
|
|
149
|
+
fid="${bak##*/}"; fid="${fid%.bak}"
|
|
150
|
+
pathfile="$CACHE/${fid}.path"
|
|
151
|
+
[ -f "$pathfile" ] || { rm -f "$bak"; continue; }
|
|
152
|
+
orig=$(cat "$pathfile")
|
|
153
|
+
if [ -f "$orig" ]; then
|
|
154
|
+
cat "$bak" > "$orig"
|
|
155
|
+
rm -f "$bak" "$pathfile" "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
|
|
156
|
+
rmdir "$CACHE/${fid}.lock" 2>/dev/null
|
|
157
|
+
else
|
|
158
|
+
# File was moved/deleted — save backup as .recovered, don't destroy it
|
|
159
|
+
mkdir -p "$(dirname "${orig}.recovered")"
|
|
160
|
+
mv "$bak" "${orig}.recovered"
|
|
161
|
+
rm -f "$pathfile" "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
|
|
162
|
+
rmdir "$CACHE/${fid}.lock" 2>/dev/null
|
|
163
|
+
printf 'Warning: %s was moved/deleted. Recovered original to %s.recovered\n' "$orig" "$orig" >&2
|
|
164
|
+
fi
|
|
165
|
+
done
|
|
166
|
+
# Clean orphan locks (created but crash before backup)
|
|
167
|
+
for lockdir in "$CACHE"/*.lock; do
|
|
168
|
+
[ -d "$lockdir" ] || continue
|
|
169
|
+
rmdir "$lockdir" 2>/dev/null
|
|
170
|
+
done
|
|
171
|
+
exit 0
|
|
172
|
+
fi
|
|
173
|
+
|
|
174
|
+
[ -z "$FILE_PATH" ] && exit 0
|
|
175
|
+
|
|
176
|
+
# ── PreToolUse Read: filter in-place ──────────────────────────────────────────
|
|
177
|
+
if [ "$TOOL_NAME" = "Read" ]; then
|
|
178
|
+
[ -f "$FILE_PATH" ] || exit 0
|
|
179
|
+
case "$(basename "$FILE_PATH")" in simplify-ignore*|SIMPLIFY-IGNORE*) exit 0 ;; esac
|
|
180
|
+
|
|
181
|
+
mkdir -p "$CACHE"
|
|
182
|
+
ID=$(file_id "$FILE_PATH")
|
|
183
|
+
|
|
184
|
+
# If backup exists, file is already filtered — skip
|
|
185
|
+
[ -f "$CACHE/${ID}.bak" ] && exit 0
|
|
186
|
+
|
|
187
|
+
grep -q 'simplify-ignore-start' -- "$FILE_PATH" || exit 0
|
|
188
|
+
|
|
189
|
+
# Atomic lock: mkdir fails if another session races us
|
|
190
|
+
if ! mkdir "$CACHE/${ID}.lock" 2>/dev/null; then
|
|
191
|
+
# Lock exists — reclaim only if stale (>60s old, no backup = crash leftover)
|
|
192
|
+
if [ ! -f "$CACHE/${ID}.bak" ] && \
|
|
193
|
+
[ -n "$(find "$CACHE/${ID}.lock" -maxdepth 0 -mmin +1 2>/dev/null)" ]; then
|
|
194
|
+
rmdir "$CACHE/${ID}.lock" 2>/dev/null || true
|
|
195
|
+
mkdir "$CACHE/${ID}.lock" 2>/dev/null || exit 0
|
|
196
|
+
else
|
|
197
|
+
exit 0
|
|
198
|
+
fi
|
|
199
|
+
fi
|
|
200
|
+
|
|
201
|
+
# Back up the original (preserve trailing newline status)
|
|
202
|
+
cp -p "$FILE_PATH" "$CACHE/${ID}.bak" 2>/dev/null || cp "$FILE_PATH" "$CACHE/${ID}.bak"
|
|
203
|
+
printf '%s' "$FILE_PATH" > "$CACHE/${ID}.path"
|
|
204
|
+
|
|
205
|
+
# Filter in-place (cat > preserves inode and permissions)
|
|
206
|
+
FILTERED="$CACHE/${ID}.$$.tmp"
|
|
207
|
+
rm -f "$FILTERED"
|
|
208
|
+
if filter_file "$FILE_PATH" "$FILTERED" "$ID"; then
|
|
209
|
+
cat "$FILTERED" > "$FILE_PATH"
|
|
210
|
+
rm -f "$FILTERED"
|
|
211
|
+
else
|
|
212
|
+
rm -f "$FILTERED" "$CACHE/${ID}.bak" "$CACHE/${ID}.path"
|
|
213
|
+
rmdir "$CACHE/${ID}.lock" 2>/dev/null
|
|
214
|
+
fi
|
|
215
|
+
exit 0
|
|
216
|
+
fi
|
|
217
|
+
|
|
218
|
+
# ── PostToolUse Edit|Write: expand, then re-filter ────────────────────────────
|
|
219
|
+
if [ "$TOOL_NAME" = "Edit" ] || [ "$TOOL_NAME" = "Write" ]; then
|
|
220
|
+
ID=$(file_id "$FILE_PATH")
|
|
221
|
+
[ -f "$CACHE/${ID}.bak" ] || exit 0
|
|
222
|
+
ls "$CACHE/${ID}".block.* >/dev/null 2>&1 || exit 0
|
|
223
|
+
|
|
224
|
+
# Expand placeholders, preserving any inline code the model added around them
|
|
225
|
+
EXPANDED="$CACHE/${ID}.$$.expanded"
|
|
226
|
+
rm -f "$EXPANDED"
|
|
227
|
+
while IFS= read -r line || [ -n "$line" ]; do
|
|
228
|
+
case "$line" in *BLOCK_*)
|
|
229
|
+
# Expand all placeholders on this line (supports multiple per line)
|
|
230
|
+
for bf in "$CACHE/${ID}".block.*; do
|
|
231
|
+
[ -f "$bf" ] || continue
|
|
232
|
+
h="${bf##*.}"
|
|
233
|
+
case "$line" in *"BLOCK_${h}"*)
|
|
234
|
+
# Reconstruct the exact placeholder pattern
|
|
235
|
+
bp=""; bs=""; br=""
|
|
236
|
+
[ -f "$CACHE/${ID}.prefix.${h}" ] && bp=$(cat "$CACHE/${ID}.prefix.${h}")
|
|
237
|
+
[ -f "$CACHE/${ID}.suffix.${h}" ] && bs=$(cat "$CACHE/${ID}.suffix.${h}")
|
|
238
|
+
[ -f "$CACHE/${ID}.reason.${h}" ] && br=$(cat "$CACHE/${ID}.reason.${h}")
|
|
239
|
+
if [ -n "$br" ]; then
|
|
240
|
+
placeholder="${bp}BLOCK_${h}: ${br}${bs}"
|
|
241
|
+
else
|
|
242
|
+
placeholder="${bp}BLOCK_${h}${bs}"
|
|
243
|
+
fi
|
|
244
|
+
block_content=$(cat "$bf"; printf x); block_content="${block_content%x}"
|
|
245
|
+
# Escape glob metacharacters (* ? [ \) in the pattern
|
|
246
|
+
esc_placeholder=$(escape_glob "$placeholder")
|
|
247
|
+
# Bash native substitution (// = global replace): replace placeholder, keep surrounding code
|
|
248
|
+
line="${line//$esc_placeholder/$block_content}"
|
|
249
|
+
# Fallback: if model altered the reason text, try without reason
|
|
250
|
+
# (only trigger if BLOCK_hash is still present AND wasn't in the original block content)
|
|
251
|
+
case "$block_content" in *"BLOCK_${h}"*) ;; *)
|
|
252
|
+
case "$line" in *"BLOCK_${h}"*)
|
|
253
|
+
printf 'Warning: placeholder BLOCK_%s was modified by model, using fuzzy match\n' "$h" >&2
|
|
254
|
+
esc_fuzzy=$(escape_glob "${bp}BLOCK_${h}${bs}")
|
|
255
|
+
line="${line//$esc_fuzzy/$block_content}"
|
|
256
|
+
# Last resort: match just the hash token
|
|
257
|
+
case "$line" in *"BLOCK_${h}"*)
|
|
258
|
+
line="${line//BLOCK_${h}/$block_content}"
|
|
259
|
+
;; esac
|
|
260
|
+
;; esac
|
|
261
|
+
;; esac
|
|
262
|
+
;; esac
|
|
263
|
+
done
|
|
264
|
+
;; esac
|
|
265
|
+
printf '%s\n' "$line" >> "$EXPANDED"
|
|
266
|
+
done < "$FILE_PATH"
|
|
267
|
+
# Preserve trailing newline status
|
|
268
|
+
if [ -s "$EXPANDED" ] && [ -s "$FILE_PATH" ] && [ -n "$(tail -c 1 "$FILE_PATH")" ]; then
|
|
269
|
+
perl -pe 'chomp if eof' "$EXPANDED" > "${EXPANDED}.nnl" && \
|
|
270
|
+
cat "${EXPANDED}.nnl" > "$EXPANDED" && rm -f "${EXPANDED}.nnl"
|
|
271
|
+
fi
|
|
272
|
+
# Warn if model deleted a protected block entirely
|
|
273
|
+
for bf in "$CACHE/${ID}".block.*; do
|
|
274
|
+
[ -f "$bf" ] || continue
|
|
275
|
+
bh="${bf##*.}"
|
|
276
|
+
# After expansion, blocks appear as original code (simplify-ignore-start).
|
|
277
|
+
# If neither the expanded code nor the placeholder is in EXPANDED, it was deleted.
|
|
278
|
+
if ! grep -qF "BLOCK_${bh}" "$EXPANDED" 2>/dev/null; then
|
|
279
|
+
# Get first line of block to check if it was expanded back
|
|
280
|
+
first_line=$(head -1 "$bf")
|
|
281
|
+
if ! grep -qF "$first_line" "$EXPANDED" 2>/dev/null; then
|
|
282
|
+
printf 'Warning: protected block BLOCK_%s was deleted by model\n' "$bh" >&2
|
|
283
|
+
fi
|
|
284
|
+
fi
|
|
285
|
+
done
|
|
286
|
+
# Preserve inode and permissions
|
|
287
|
+
cat "$EXPANDED" > "$FILE_PATH"
|
|
288
|
+
rm -f "$EXPANDED"
|
|
289
|
+
|
|
290
|
+
# Save expanded version as new backup (this is the "real" file with model's changes)
|
|
291
|
+
cp "$FILE_PATH" "$CACHE/${ID}.bak"
|
|
292
|
+
|
|
293
|
+
# Re-filter in-place so the file on disk stays with placeholders
|
|
294
|
+
FILTERED="$CACHE/${ID}.$$.tmp"
|
|
295
|
+
rm -f "$FILTERED"
|
|
296
|
+
if filter_file "$FILE_PATH" "$FILTERED" "$ID"; then
|
|
297
|
+
cat "$FILTERED" > "$FILE_PATH"
|
|
298
|
+
rm -f "$FILTERED"
|
|
299
|
+
fi
|
|
300
|
+
|
|
301
|
+
exit 0
|
|
302
|
+
fi
|
|
@@ -0,0 +1,256 @@
|
|
|
1
|
+
# Justfile — pi extension harnesses
|
|
2
|
+
#
|
|
3
|
+
# Recipes to launch pi with the harness extensions under .pi/harnesses/.
|
|
4
|
+
# Ported and adapted from disler/pi-vs-claude-code (MIT) — https://github.com/disler/pi-vs-claude-code
|
|
5
|
+
# See docs/pi-extensions.md for the full catalog and the selective-load model.
|
|
6
|
+
#
|
|
7
|
+
# Why .pi/harnesses/ and not .pi/extensions/: pi auto-discovers EVERY directory
|
|
8
|
+
# under .pi/extensions/, so anything placed there loads on every plain `pi` run.
|
|
9
|
+
# Most harnesses are mutually exclusive — they live in .pi/harnesses/ (which pi
|
|
10
|
+
# does NOT auto-discover) and are loaded via `pi -e` below. The supported stack
|
|
11
|
+
# loads damage-control-continue before agent-hub, so hub sessions and all native
|
|
12
|
+
# children run with guardrails by default.
|
|
13
|
+
#
|
|
14
|
+
# Everything between the two `agent-fleet:harnesses` sentinels below is a
|
|
15
|
+
# MANAGED REGION: guided-workspace-setup regenerates it from the installed
|
|
16
|
+
# package whenever pi harnesses are installed, refreshed, or retired — so edits
|
|
17
|
+
# inside it are overwritten on upgrade. Put your own recipes OUTSIDE the
|
|
18
|
+
# sentinels (above the opening marker or below the closing one) to keep them.
|
|
19
|
+
|
|
20
|
+
# >>> agent-fleet:harnesses — managed region (regenerated on upgrade; edits inside are overwritten) >>>
|
|
21
|
+
set dotenv-load := true
|
|
22
|
+
|
|
23
|
+
# How recipes run the fleet TS scripts. The preserve-symlinks flags matter for
|
|
24
|
+
# symlink installs (guided-workspace-setup's `symlink` method): there
|
|
25
|
+
# scripts/*.ts are links whose realpath sits under .pi/npm/node_modules/, and
|
|
26
|
+
# Node refuses --experimental-strip-types for anything under node_modules once
|
|
27
|
+
# paths are realpath'd. Keeping symlink paths avoids that; copy installs are
|
|
28
|
+
# unaffected (the fleet scripts import only relative paths + node builtins).
|
|
29
|
+
node_ts := "node --experimental-strip-types --preserve-symlinks --preserve-symlinks-main"
|
|
30
|
+
|
|
31
|
+
# List all recipes
|
|
32
|
+
default:
|
|
33
|
+
@just --list
|
|
34
|
+
|
|
35
|
+
# ---------------------------------------------------------------- setup
|
|
36
|
+
|
|
37
|
+
# Install the shared runtime dependencies for the pi extensions + harnesses
|
|
38
|
+
install:
|
|
39
|
+
npm install --prefix .pi/extensions
|
|
40
|
+
npm install --prefix .pi/harnesses
|
|
41
|
+
|
|
42
|
+
# Default pi — only the always-on utilities auto-load, no harness
|
|
43
|
+
pi:
|
|
44
|
+
pi
|
|
45
|
+
|
|
46
|
+
# ---------------------------------------------------------------- safety
|
|
47
|
+
|
|
48
|
+
# Damage-control: blocks deliver feedback so the agent adapts and keeps working
|
|
49
|
+
# instead of aborting the turn. Default guardrail for the hub and native children.
|
|
50
|
+
ext-damage-control-continue:
|
|
51
|
+
pi -e .pi/harnesses/damage-control-continue/index.ts
|
|
52
|
+
|
|
53
|
+
# ---------------------------------------------------------------- orchestration
|
|
54
|
+
|
|
55
|
+
# Accepts coms identity flags: --name --purpose --project --color --explicit.
|
|
56
|
+
# Loads the orchestrator persona by default (the Verification-Contract dispatcher that owns
|
|
57
|
+
# the acceptance assertions — see skills/orchestration-verification); it is appended only if
|
|
58
|
+
# agents/orchestrator.md is installed, so the hub still launches when it is absent. Override
|
|
59
|
+
# with your own --system-prompt <persona>.md passed after `just hub`.
|
|
60
|
+
# Guarded agent hub: damage-control-continue + remote-capable ask_user + dispatcher grid + research helpers + embedded coms + orchestrator.
|
|
61
|
+
# The main session and every native child use the continue guardrail; blocked calls
|
|
62
|
+
# feed back so the agent can report or safely adapt without aborting its turn.
|
|
63
|
+
hub *args:
|
|
64
|
+
persona=""; if [ -f agents/orchestrator.md ]; then persona="--append-system-prompt agents/orchestrator.md"; fi; pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/ask-user-remote/index.ts -e .pi/harnesses/agent-hub/index.ts $persona {{args}}
|
|
65
|
+
|
|
66
|
+
# Agent hub (solo): guarded hub without the coms layer — fixed specialists + research only.
|
|
67
|
+
# Same orchestrator-persona default, remote-capable ask_user, and continue-guardrail main session as `just hub`.
|
|
68
|
+
hub-solo *args:
|
|
69
|
+
persona=""; if [ -f agents/orchestrator.md ]; then persona="--append-system-prompt agents/orchestrator.md"; fi; pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/ask-user-remote/index.ts -e .pi/harnesses/agent-hub/index.ts --solo $persona {{args}}
|
|
70
|
+
|
|
71
|
+
# Internal helper for team-up: launch a reusable coms peer (coms + compact-and-continue + a persona).
|
|
72
|
+
# Prints a colored identity banner (peer name + persona purpose) before pi starts,
|
|
73
|
+
# so every pane announces who lives in it — works in any terminal, herdr or not.
|
|
74
|
+
# AGENT_FLEET_SPAWN_DELAY (set per pane by team-up when the stored pi OAuth token
|
|
75
|
+
# is stale) delays this pi's boot so a sibling pane can refresh the token first —
|
|
76
|
+
# simultaneous boots race on the auth.json lock and lose their logins.
|
|
77
|
+
# Hidden from `just --list` because recipes prefixed with `_` are private.
|
|
78
|
+
_peer persona name="" model="" session="" project="default":
|
|
79
|
+
d="${AGENT_FLEET_SPAWN_DELAY:-0}"; if [ "$d" != "0" ]; then echo "⏳ waiting ${d}s for the pi auth pre-warm (stale OAuth token)"; sleep "$d"; fi; {{node_ts}} scripts/peer-banner.ts {{persona}} {{name}} 2>/dev/null || true; persona_path="agents/{{persona}}.md"; if [ ! -f "$persona_path" ]; then persona_path=".pi/agents/{{persona}}.md"; fi; pi -e .pi/harnesses/coms/index.ts -e .pi/extensions/compact-and-continue/index.ts --project {{project}} --append-system-prompt "$persona_path" {{ if name != "" { "--name " + name } else { "" } }} {{ if model != "" { "--model " + model } else { "" } }} {{ if session != "" { "--session " + session } else { "" } }}
|
|
80
|
+
|
|
81
|
+
# Like _peer, but also loads extra always-on extensions (comma-separated names under
|
|
82
|
+
# .pi/extensions/) into the peer process — e.g. a chrome-devtools-mcp browser-debug peer
|
|
83
|
+
# whose `chrome_devtools__*` tools a normal --no-extensions subagent could not get.
|
|
84
|
+
_peer-plus extensions persona name="" model="" session="" project="default":
|
|
85
|
+
d="${AGENT_FLEET_SPAWN_DELAY:-0}"; if [ "$d" != "0" ]; then echo "⏳ waiting ${d}s for the pi auth pre-warm (stale OAuth token)"; sleep "$d"; fi; {{node_ts}} scripts/peer-banner.ts {{persona}} {{name}} 2>/dev/null || true; persona_path="agents/{{persona}}.md"; if [ ! -f "$persona_path" ]; then persona_path=".pi/agents/{{persona}}.md"; fi; extra=""; old_ifs="$IFS"; IFS=','; for x in {{extensions}}; do x="$(echo "$x" | xargs)"; if [ -n "$x" ]; then extra="$extra -e .pi/extensions/$x/index.ts"; fi; done; IFS="$old_ifs"; pi -e .pi/harnesses/coms/index.ts -e .pi/extensions/compact-and-continue/index.ts $extra --project {{project}} --append-system-prompt "$persona_path" {{ if name != "" { "--name " + name } else { "" } }} {{ if model != "" { "--model " + model } else { "" } }} {{ if session != "" { "--session " + session } else { "" } }}
|
|
86
|
+
|
|
87
|
+
# Internal helper for team-up: a `runner: claude-code` peer — interactive
|
|
88
|
+
# Claude Code plus its coms bridge (scripts/coms-claude-bridge.ts) in ONE pane.
|
|
89
|
+
# The bridge registers the pane as coms peer <name>; the trailing session
|
|
90
|
+
# positional maps to `claude --resume <id>` for team-resume.
|
|
91
|
+
_claude-peer name model="" session="" project="default":
|
|
92
|
+
{{node_ts}} scripts/coms-claude-bridge.ts --name {{name}} --project {{project}} & bridge_pid=$!; trap 'kill $bridge_pid 2>/dev/null' EXIT; claude {{ if model != "" { "--model " + model } else { "" } }} {{ if session != "" { "--resume " + session } else { "" } }}
|
|
93
|
+
|
|
94
|
+
# The team recipes below take the team as a positional arg (defaults to "full")
|
|
95
|
+
# and pass everything after it straight to the script.
|
|
96
|
+
#
|
|
97
|
+
# Herdr workspace labels are auto-scoped to the CHECKOUT: <worktree-tag>-<mode>-<team>
|
|
98
|
+
# where the tag is the last dot-segment of this directory's basename (main.wt2 →
|
|
99
|
+
# wt2, ringithub.end2 → end2, plain agent-fleet → agent-fleet). So the same team
|
|
100
|
+
# launched from different repos/worktrees gets its own workspace (wt2-hub-plan vs
|
|
101
|
+
# end2-hub-plan) instead of colliding on a shared label. This is not global
|
|
102
|
+
# uniqueness: unrelated checkouts with the same basename/final dot-segment can
|
|
103
|
+
# still collide. Existing-workspace refusal prevents clobbering; it does not
|
|
104
|
+
# prove the labels are unique.
|
|
105
|
+
#
|
|
106
|
+
# `--project <name>` is a SEPARATE axis: it scopes the coms peer POOL. Without it
|
|
107
|
+
# every peer lands in the shared "default" pool, where teams launched from OTHER
|
|
108
|
+
# repos collide (name suffixing like code-reviewer2, dispatches routed to the
|
|
109
|
+
# wrong repo's pane). IMPORTANT: the flag form is `--project af`; `project=af` is
|
|
110
|
+
# NOT a flag — just treats bare key=value args as variable overrides, so it is
|
|
111
|
+
# silently ignored and the team still joins the "default" pool.
|
|
112
|
+
|
|
113
|
+
# Team up: spawn every peer of a team from .pi/agents/peers.yaml into a herdr
|
|
114
|
+
# workspace (one tiled pane per peer). Requires a running herdr server.
|
|
115
|
+
# e.g. just team-up full
|
|
116
|
+
# just team-up review --project af
|
|
117
|
+
team-up team="full" *args:
|
|
118
|
+
{{node_ts}} scripts/team-up.ts --team {{team}} {{args}}
|
|
119
|
+
|
|
120
|
+
# Team up (dry run): print the resolved layout + per-peer commands without touching herdr.
|
|
121
|
+
# e.g. just team-up-dry full
|
|
122
|
+
# just team-up-dry review --project af
|
|
123
|
+
team-up-dry team="full" *args:
|
|
124
|
+
{{node_ts}} scripts/team-up.ts --team {{team}} --dry-run {{args}}
|
|
125
|
+
|
|
126
|
+
# Hub + team in ONE herdr workspace: the guarded hub (`just hub`) in a larger
|
|
127
|
+
# main pane, the team's peers tiled beside it.
|
|
128
|
+
# e.g. just hub-team docs
|
|
129
|
+
# just hub-team review --project af
|
|
130
|
+
hub-team team="full" *args:
|
|
131
|
+
{{node_ts}} scripts/team-up.ts --team {{team}} --hub {{args}}
|
|
132
|
+
|
|
133
|
+
# Hub + team (dry run): print the combined layout without touching herdr.
|
|
134
|
+
# e.g. just hub-team-dry review --project af
|
|
135
|
+
hub-team-dry team="full" *args:
|
|
136
|
+
{{node_ts}} scripts/team-up.ts --team {{team}} --hub --dry-run {{args}}
|
|
137
|
+
|
|
138
|
+
# Hermes conductor + team in ONE herdr workspace: Hermes dev profile in a conductor pane,
|
|
139
|
+
# the team's peers tiled beside it. Hermes delegates via coms-cli and never drives herdr.
|
|
140
|
+
# e.g. just conductor docs --project af
|
|
141
|
+
conductor team="full" *args:
|
|
142
|
+
{{node_ts}} scripts/team-up.ts --team {{team}} --conductor {{args}}
|
|
143
|
+
|
|
144
|
+
# Hermes conductor + team (dry run): print the combined layout without touching herdr.
|
|
145
|
+
# e.g. just conductor-dry docs --project af
|
|
146
|
+
conductor-dry team="full" *args:
|
|
147
|
+
{{node_ts}} scripts/team-up.ts --team {{team}} --conductor --dry-run {{args}}
|
|
148
|
+
|
|
149
|
+
# Experimental Codex remote-control conductor lifecycle (verified with CLI
|
|
150
|
+
# 0.144.x). Pairing stays interactive and its short-lived code must never be
|
|
151
|
+
# captured. The user service is singleton across repos/projects.
|
|
152
|
+
# e.g. just conductor-codex-setup docs --project af
|
|
153
|
+
conductor-codex-setup team="full" *args:
|
|
154
|
+
{{node_ts}} scripts/codex-remote-control.ts setup-conductor --codex-bin "$(command -v codex)" --repo-root "$(pwd -P)" --coms-dir "$HOME/.pi/coms" --team "{{team}}" --timeout 300000 {{args}}
|
|
155
|
+
|
|
156
|
+
conductor-codex-reconfigure team="full" *args:
|
|
157
|
+
{{node_ts}} scripts/codex-remote-control.ts reconfigure-conductor --codex-bin "$(command -v codex)" --repo-root "$(pwd -P)" --coms-dir "$HOME/.pi/coms" --team "{{team}}" --timeout 300000 {{args}}
|
|
158
|
+
|
|
159
|
+
conductor-codex-pair:
|
|
160
|
+
{{node_ts}} scripts/codex-remote-control.ts pair
|
|
161
|
+
|
|
162
|
+
conductor-codex-start:
|
|
163
|
+
{{node_ts}} scripts/codex-remote-control.ts start
|
|
164
|
+
|
|
165
|
+
conductor-codex-status:
|
|
166
|
+
{{node_ts}} scripts/codex-remote-control.ts status
|
|
167
|
+
|
|
168
|
+
conductor-codex-stop:
|
|
169
|
+
{{node_ts}} scripts/codex-remote-control.ts stop
|
|
170
|
+
|
|
171
|
+
conductor-codex-recover:
|
|
172
|
+
{{node_ts}} scripts/codex-remote-control.ts recover --confirm operator-confirmed
|
|
173
|
+
|
|
174
|
+
conductor-codex-uninstall:
|
|
175
|
+
{{node_ts}} scripts/codex-remote-control.ts uninstall --confirm operator-confirmed
|
|
176
|
+
|
|
177
|
+
# Codex conductor + team in one workspace. The root is a requested-state
|
|
178
|
+
# control pane; systemd owns the remote-control daemon.
|
|
179
|
+
# e.g. just conductor-codex docs --project af
|
|
180
|
+
conductor-codex team="full" *args:
|
|
181
|
+
{{node_ts}} scripts/team-up.ts --team {{team}} --conductor codex {{args}}
|
|
182
|
+
|
|
183
|
+
conductor-codex-dry team="full" *args:
|
|
184
|
+
{{node_ts}} scripts/team-up.ts --team {{team}} --conductor codex --dry-run {{args}}
|
|
185
|
+
|
|
186
|
+
# Legacy pilot aliases retained for the 0.144.x experimental rollout.
|
|
187
|
+
# Setup/reconfigure resolve the selected binary and persist one validated
|
|
188
|
+
# repo/project/team/coms context.
|
|
189
|
+
# e.g. just conductor-codex-pilot-setup docs --project af
|
|
190
|
+
conductor-codex-pilot-setup team="full" *args:
|
|
191
|
+
{{node_ts}} scripts/codex-remote-control.ts setup-pilot --codex-bin "$(command -v codex)" --repo-root "$(pwd -P)" --coms-dir "$HOME/.pi/coms" --team "{{team}}" --timeout 300000 {{args}}
|
|
192
|
+
|
|
193
|
+
conductor-codex-pilot-reconfigure team="full" *args:
|
|
194
|
+
{{node_ts}} scripts/codex-remote-control.ts reconfigure-pilot --codex-bin "$(command -v codex)" --repo-root "$(pwd -P)" --coms-dir "$HOME/.pi/coms" --team "{{team}}" --timeout 300000 {{args}}
|
|
195
|
+
|
|
196
|
+
conductor-codex-pilot-pair:
|
|
197
|
+
{{node_ts}} scripts/codex-remote-control.ts pair
|
|
198
|
+
|
|
199
|
+
conductor-codex-pilot-start:
|
|
200
|
+
{{node_ts}} scripts/codex-remote-control.ts start
|
|
201
|
+
|
|
202
|
+
conductor-codex-pilot-status:
|
|
203
|
+
{{node_ts}} scripts/codex-remote-control.ts status
|
|
204
|
+
|
|
205
|
+
conductor-codex-pilot-stop:
|
|
206
|
+
{{node_ts}} scripts/codex-remote-control.ts stop
|
|
207
|
+
|
|
208
|
+
conductor-codex-pilot-recover:
|
|
209
|
+
{{node_ts}} scripts/codex-remote-control.ts recover --confirm operator-confirmed
|
|
210
|
+
|
|
211
|
+
conductor-codex-pilot-uninstall:
|
|
212
|
+
{{node_ts}} scripts/codex-remote-control.ts uninstall --confirm operator-confirmed
|
|
213
|
+
|
|
214
|
+
# Legacy pilot live aliases use the same verified implementation. The root pane
|
|
215
|
+
# is the lifecycle helper's foreground control pane, never a daemon command.
|
|
216
|
+
# e.g. just conductor-codex-pilot docs --project af
|
|
217
|
+
conductor-codex-pilot team="full" *args:
|
|
218
|
+
{{node_ts}} scripts/team-up.ts --team {{team}} --conductor codex {{args}}
|
|
219
|
+
|
|
220
|
+
# Legacy pilot dry-run alias.
|
|
221
|
+
# e.g. just conductor-codex-pilot-dry docs --project af
|
|
222
|
+
conductor-codex-pilot-dry team="full" *args:
|
|
223
|
+
{{node_ts}} scripts/team-up.ts --team {{team}} --conductor codex --dry-run {{args}}
|
|
224
|
+
|
|
225
|
+
# Snapshot a RUNNING team's session refs to ~/.pi/team-snapshots/<team>.json
|
|
226
|
+
# (team keeps running — take one proactively so a crash is resumable).
|
|
227
|
+
# A team launched with --project must snapshot with the same --project.
|
|
228
|
+
# e.g. just team-snapshot review --project af
|
|
229
|
+
team-snapshot team="full" *args:
|
|
230
|
+
{{node_ts}} scripts/team-snapshot.ts snapshot {{team}} {{args}}
|
|
231
|
+
|
|
232
|
+
# Snapshot, then close the team workspace cleanly (peers get SIGTERM).
|
|
233
|
+
# e.g. just team-down review --project af
|
|
234
|
+
team-down team="full" *args:
|
|
235
|
+
{{node_ts}} scripts/team-snapshot.ts down {{team}} {{args}}
|
|
236
|
+
|
|
237
|
+
# Rebuild a team from its snapshot — each pi peer resumes its previous
|
|
238
|
+
# conversation (`pi --session <ref>`); peers whose ref is gone start fresh.
|
|
239
|
+
# e.g. just team-resume review --project af
|
|
240
|
+
team-resume team="full" *args:
|
|
241
|
+
{{node_ts}} scripts/team-snapshot.ts resume {{team}} {{args}}
|
|
242
|
+
|
|
243
|
+
# ---------------------------------------------------------------- coms (Pi-to-Pi messaging)
|
|
244
|
+
|
|
245
|
+
# Safe coms: a FULL pi (all auto-discovered local .pi/extensions/ + global extensions and
|
|
246
|
+
# commands) plus damage-control-continue guardrails and the coms peer layer, under a chosen name.
|
|
247
|
+
# Unlike `just hub`, this does NOT pass --no-extensions, so every local-only extension (MCP
|
|
248
|
+
# bridges like chrome-devtools-mcp, project-specific extensions, …) loads into THIS process.
|
|
249
|
+
# Use it as the agent-hub dispatcher/orchestrator peer that needs those local tools: spawned
|
|
250
|
+
# specialists run --no-extensions, so the tools stay scoped here and never leak into subagents.
|
|
251
|
+
# The required `name` becomes this peer's coms identity (--name), so it is discoverable
|
|
252
|
+
# under exactly that name to other coms peers in the project pool.
|
|
253
|
+
# e.g. just safe-coms orchestrator --project proj
|
|
254
|
+
safe-coms name *args:
|
|
255
|
+
pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/coms/index.ts --name {{name}} {{args}}
|
|
256
|
+
# <<< agent-fleet:harnesses <<<
|