@chankov/agent-fleet 0.0.2 → 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/doctor-agent-fleet.md +1 -1
- package/.claude/commands/setup-agent-fleet.md +5 -5
- package/.opencode/commands/af-doctor-agent-fleet.md +2 -0
- package/.opencode/commands/af-setup-agent-fleet.md +1 -1
- package/.pi/agents/peers.yaml +4 -0
- package/.pi/agents/teams.yaml +2 -2
- package/.pi/harnesses/agent-hub/README.md +254 -18
- 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 +1269 -322
- 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-retention.js +34 -0
- 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 +2 -0
- package/.pi/harnesses/coms/README.md +21 -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/doctor-agent-fleet.md +1 -1
- package/.pi/prompts/setup-agent-fleet.md +5 -5
- 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 +103 -541
- package/agents/architect.md +1 -1
- 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/planner.md +1 -1
- package/agents/security-auditor.md +1 -1
- package/agents/test-engineer.md +11 -4
- package/bin/lib/validate-overrides.js +19 -0
- package/bin/snapshot-version.js +17 -1
- package/bin/sync-harness-versions.js +94 -0
- package/codex/CONDUCTOR.md +148 -0
- package/docs/ARCHITECTURE.md +210 -0
- package/docs/agent-fleet-setup.md +11 -0
- package/docs/claude-code-coms-bridge.md +10 -0
- package/docs/codex-remote-conductor.md +170 -0
- package/docs/coms-hermes-bridge.md +121 -0
- package/docs/getting-started.md +14 -0
- package/docs/npm-install.md +2 -0
- package/docs/pi-extensions.md +49 -14
- package/docs/pi-setup.md +12 -4
- package/hermes/README.md +228 -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/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/justfile +106 -23
- package/package.json +17 -5
- package/scripts/codex-conductor.ts +41 -0
- package/scripts/codex-remote-control.ts +167 -0
- package/scripts/coms-cli.ts +311 -199
- package/scripts/coms-hermes-bridge.ts +2 -2
- package/scripts/lib/codex-conductor.ts +88 -0
- package/scripts/lib/codex-remote-control.ts +480 -0
- package/scripts/lib/coms-envelope.ts +51 -6
- package/scripts/lib/fake-herdr-server.ts +88 -0
- package/scripts/lib/herdr-layout.ts +18 -3
- package/scripts/lib/hermes-bridge-core.ts +4 -4
- 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/scripts/lib/team-project.ts +85 -1
- package/scripts/team-up.ts +77 -18
- 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 +131 -102
- package/skills/guided-workspace-setup/companion-manifest.json +33 -0
- package/skills/peer-coms/SKILL.md +9 -0
- package/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.pi/harnesses/damage-control/README.md +0 -65
- package/.pi/harnesses/damage-control/index.ts +0 -250
package/scripts/team-up.ts
CHANGED
|
@@ -35,10 +35,20 @@ import {
|
|
|
35
35
|
type Peer,
|
|
36
36
|
} from "./lib/herdr-layout.ts";
|
|
37
37
|
import { planSpawnDelays } from "./lib/spawn-stagger.ts";
|
|
38
|
-
import {
|
|
38
|
+
import {
|
|
39
|
+
DEFAULT_PROJECT,
|
|
40
|
+
conductorSpec,
|
|
41
|
+
hubCommand,
|
|
42
|
+
parseProjectFlag,
|
|
43
|
+
teamWorkspaceLabel,
|
|
44
|
+
validateTeamName,
|
|
45
|
+
worktreeTag,
|
|
46
|
+
type ConductorBackend,
|
|
47
|
+
type ConductorSpec,
|
|
48
|
+
} from "./lib/team-project.ts";
|
|
39
49
|
|
|
40
50
|
const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
|
|
41
|
-
const REPO_ROOT = path.resolve(SCRIPT_DIR, "..");
|
|
51
|
+
const REPO_ROOT = fs.realpathSync(path.resolve(SCRIPT_DIR, ".."));
|
|
42
52
|
// Scopes the workspace label to this checkout so the same team from another
|
|
43
53
|
// repo/worktree gets its own workspace instead of colliding (see worktreeTag).
|
|
44
54
|
const WORKTREE_TAG = worktreeTag(REPO_ROOT);
|
|
@@ -47,7 +57,6 @@ const DEFAULT_PEERS_YAML = path.join(REPO_ROOT, ".pi", "agents", "peers.yaml");
|
|
|
47
57
|
// The guarded hub or Hermes conductor occupies this share of the workspace in
|
|
48
58
|
// --hub/--conductor mode; the team tiles in the rest.
|
|
49
59
|
const HUB_RATIO = 0.4;
|
|
50
|
-
const CONDUCTOR_RATIO = 0.35;
|
|
51
60
|
|
|
52
61
|
function flagValue(argv: string[], flag: string): string | null {
|
|
53
62
|
const i = argv.indexOf(flag);
|
|
@@ -62,6 +71,16 @@ function die(msg: string): never {
|
|
|
62
71
|
process.exit(1);
|
|
63
72
|
}
|
|
64
73
|
|
|
74
|
+
function parseConductorBackend(argv: string[]): ConductorBackend | null {
|
|
75
|
+
const indexes = argv.flatMap((value, index) => value === "--conductor" ? [index] : []);
|
|
76
|
+
if (indexes.length > 1) throw new Error("--conductor may only be provided once");
|
|
77
|
+
if (indexes.length === 0) return null;
|
|
78
|
+
const value = argv[indexes[0] + 1];
|
|
79
|
+
if (!value || value.startsWith("--")) return "hermes"; // legacy bare --conductor
|
|
80
|
+
if (value === "hermes" || value === "codex") return value;
|
|
81
|
+
throw new Error(`Unknown conductor backend: ${JSON.stringify(value)} (expected hermes or codex)`);
|
|
82
|
+
}
|
|
83
|
+
|
|
65
84
|
function loadTeam(team: string, peersYaml: string): Peer[] {
|
|
66
85
|
if (!fs.existsSync(peersYaml)) die(`peers.yaml not found at ${peersYaml}`);
|
|
67
86
|
const teams = parsePeersYaml(fs.readFileSync(peersYaml, "utf-8"));
|
|
@@ -70,7 +89,6 @@ function loadTeam(team: string, peersYaml: string): Peer[] {
|
|
|
70
89
|
const names = Object.keys(teams).join(", ") || "(none)";
|
|
71
90
|
die(`Unknown team "${team}". Available teams: ${names}`);
|
|
72
91
|
}
|
|
73
|
-
if (peers.length === 0) die(`Team "${team}" has no peers.`);
|
|
74
92
|
return peers;
|
|
75
93
|
}
|
|
76
94
|
|
|
@@ -128,20 +146,38 @@ function makeDelayLoader(peers: Peer[], mode: "peers" | "hub" | "conductor"): (p
|
|
|
128
146
|
return delayForPeer;
|
|
129
147
|
}
|
|
130
148
|
|
|
149
|
+
async function validateCodexLaunchOrDie(spec: ConductorSpec, project: string): Promise<void> {
|
|
150
|
+
try {
|
|
151
|
+
const { assertConductorContext, lifecyclePaths, loadOwnedConfig, preflight, requestedState } = await import("./lib/codex-remote-control.ts");
|
|
152
|
+
const config = loadOwnedConfig(lifecyclePaths().configPath);
|
|
153
|
+
assertConductorContext(config, {
|
|
154
|
+
repoRoot: REPO_ROOT,
|
|
155
|
+
project,
|
|
156
|
+
team: spec.team,
|
|
157
|
+
name: spec.conductorName,
|
|
158
|
+
timeoutMs: Number(spec.env.COMS_CLI_TIMEOUT_MS),
|
|
159
|
+
contractPath: String(spec.env.AGENT_FLEET_CODEX_CONTRACT_PATH),
|
|
160
|
+
contractIdentity: String(spec.env.AGENT_FLEET_CODEX_CONTRACT_IDENTITY),
|
|
161
|
+
});
|
|
162
|
+
preflight(config);
|
|
163
|
+
const state = requestedState();
|
|
164
|
+
if (state.active !== "active" || state.sub !== "exited") {
|
|
165
|
+
throw new Error(`Codex user service is not in requested active (exited) state: ${state.active} (${state.sub})`);
|
|
166
|
+
}
|
|
167
|
+
} catch (err) {
|
|
168
|
+
die(`Codex launch refused before Herdr: ${err instanceof Error ? err.message : String(err)}`);
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
|
|
131
172
|
function buildLayoutOrDie(
|
|
132
173
|
team: string,
|
|
133
174
|
peers: Peer[],
|
|
134
175
|
envForPeer: (p: Peer) => Record<string, string> | undefined,
|
|
135
|
-
mode: "peers" | "hub" | "conductor",
|
|
136
176
|
project: string,
|
|
177
|
+
rootPane?: { command: string[]; label: string; ratio: number; cwd?: string; env?: Record<string, string> },
|
|
137
178
|
delayForPeer?: (p: Peer) => number | undefined,
|
|
138
179
|
): LayoutNode {
|
|
139
180
|
try {
|
|
140
|
-
const rootPane = mode === "hub"
|
|
141
|
-
? { command: hubCommand(project), label: "hub", ratio: HUB_RATIO }
|
|
142
|
-
: mode === "conductor"
|
|
143
|
-
? { command: conductorCommand(), label: "conductor", ratio: CONDUCTOR_RATIO }
|
|
144
|
-
: undefined;
|
|
145
181
|
return buildTeamLayout({
|
|
146
182
|
team,
|
|
147
183
|
peers,
|
|
@@ -171,7 +207,12 @@ async function main(): Promise<void> {
|
|
|
171
207
|
}
|
|
172
208
|
const dryRun = argv.includes("--dry-run");
|
|
173
209
|
const hub = argv.includes("--hub");
|
|
174
|
-
|
|
210
|
+
let conductor: ConductorBackend | null;
|
|
211
|
+
try {
|
|
212
|
+
conductor = parseConductorBackend(argv);
|
|
213
|
+
} catch (err) {
|
|
214
|
+
die(err instanceof Error ? err.message : String(err));
|
|
215
|
+
}
|
|
175
216
|
if (hub && conductor) die("--hub and --conductor are mutually exclusive");
|
|
176
217
|
const mode: "peers" | "hub" | "conductor" = hub ? "hub" : conductor ? "conductor" : "peers";
|
|
177
218
|
|
|
@@ -186,19 +227,35 @@ async function main(): Promise<void> {
|
|
|
186
227
|
die(err instanceof Error ? err.message : String(err));
|
|
187
228
|
}
|
|
188
229
|
const peers = loadTeam(team, peersYaml);
|
|
230
|
+
if (peers.length === 0 && mode === "peers") {
|
|
231
|
+
die(`Team "${team}" has no peers. Empty teams require --hub or --conductor.`);
|
|
232
|
+
}
|
|
233
|
+
let spec: ConductorSpec | undefined;
|
|
189
234
|
let label: string;
|
|
190
235
|
try {
|
|
191
|
-
|
|
236
|
+
spec = conductor ? conductorSpec(conductor, {
|
|
237
|
+
repoRoot: REPO_ROOT,
|
|
238
|
+
runtimeDir: path.join(os.homedir(), ".local", "state", "agent-fleet", "codex-conductor"),
|
|
239
|
+
team,
|
|
240
|
+
project,
|
|
241
|
+
nodeBin: process.execPath,
|
|
242
|
+
}) : undefined;
|
|
243
|
+
label = teamWorkspaceLabel(spec?.workspaceMode ?? (hub ? "hub" : "peers"), team, project, WORKTREE_TAG);
|
|
192
244
|
} catch (err) {
|
|
193
245
|
die(err instanceof Error ? err.message : String(err));
|
|
194
246
|
}
|
|
247
|
+
const rootPane = hub
|
|
248
|
+
? { command: hubCommand(project), label: "hub", ratio: HUB_RATIO }
|
|
249
|
+
: spec
|
|
250
|
+
? { command: spec.command, label: spec.paneLabel, ratio: spec.ratio, cwd: spec.cwd, env: spec.env }
|
|
251
|
+
: undefined;
|
|
195
252
|
|
|
196
253
|
if (dryRun) {
|
|
197
254
|
// No herdr calls and no env_file reads on this path — must work with no
|
|
198
255
|
// herdr installed, and secrets never reach the output.
|
|
199
|
-
const layout = buildLayoutOrDie(team, peers, makeEnvLoader(peers, true),
|
|
256
|
+
const layout = buildLayoutOrDie(team, peers, makeEnvLoader(peers, true), project, rootPane);
|
|
200
257
|
const projectNote = project === DEFAULT_PROJECT ? "" : `, project "${project}"`;
|
|
201
|
-
const extra = mode === "hub" ? " + hub" :
|
|
258
|
+
const extra = mode === "hub" ? " + hub" : spec ? ` + ${spec.backend === "codex" ? "Codex conductor" : "Hermes conductor"}` : "";
|
|
202
259
|
console.log(
|
|
203
260
|
`# team-up (dry run) — team "${team}"${projectNote}, ${peers.length} peer(s)${extra}, herdr workspace "${label}"`,
|
|
204
261
|
);
|
|
@@ -211,7 +268,8 @@ async function main(): Promise<void> {
|
|
|
211
268
|
return;
|
|
212
269
|
}
|
|
213
270
|
|
|
214
|
-
|
|
271
|
+
if (spec?.backend === "codex") await validateCodexLaunchOrDie(spec, project);
|
|
272
|
+
const layout = buildLayoutOrDie(team, peers, makeEnvLoader(peers, false), project, rootPane, makeDelayLoader(peers, mode));
|
|
215
273
|
|
|
216
274
|
// Import lazily so --dry-run never touches the client (or the socket).
|
|
217
275
|
const { herdr, requireHerdr, HerdrUnavailableError } = await import(
|
|
@@ -223,7 +281,7 @@ async function main(): Promise<void> {
|
|
|
223
281
|
} catch (err) {
|
|
224
282
|
if (err instanceof HerdrUnavailableError) {
|
|
225
283
|
console.error(err.message);
|
|
226
|
-
const dryRecipe = mode === "hub" ? "hub-team-dry" : mode === "conductor" ? "conductor-dry" : "team-up-dry";
|
|
284
|
+
const dryRecipe = mode === "hub" ? "hub-team-dry" : spec?.backend === "codex" ? "conductor-codex-dry" : mode === "conductor" ? "conductor-dry" : "team-up-dry";
|
|
227
285
|
console.error(`(dry run still works: just ${dryRecipe} ${team}${project === DEFAULT_PROJECT ? "" : ` --project ${project}`})`);
|
|
228
286
|
process.exit(1);
|
|
229
287
|
}
|
|
@@ -253,12 +311,13 @@ async function main(): Promise<void> {
|
|
|
253
311
|
}
|
|
254
312
|
}
|
|
255
313
|
|
|
256
|
-
const launchedPrefix = mode === "hub" ? "hub + " :
|
|
314
|
+
const launchedPrefix = mode === "hub" ? "hub + " : spec ? `${spec.backend} conductor + ` : "";
|
|
257
315
|
console.log(
|
|
258
316
|
`Launched ${launchedPrefix}${peers.length} peer(s) for team "${team}" in herdr workspace "${label}" (${wsId}):`,
|
|
259
317
|
);
|
|
260
318
|
if (mode === "hub") console.log(` • hub (${hubCommand(project).join(" ")} — guarded dispatcher)`);
|
|
261
|
-
if (
|
|
319
|
+
if (spec) console.log(` • ${spec.paneLabel} (${spec.command.join(" ")} — ${spec.displayText})`);
|
|
320
|
+
if (spec?.backend === "codex") console.log(" • Closing this workspace does not stop the enabled Codex user service; stop it explicitly.");
|
|
262
321
|
for (const p of peers) console.log(` • ${p.name}`);
|
|
263
322
|
console.log(`Focus: herdr workspace focus ${wsId}`);
|
|
264
323
|
console.log(`Close: herdr workspace close ${wsId}`);
|
|
@@ -11,7 +11,7 @@ This repo has three kinds of artifacts that shape how an agent works. Each is au
|
|
|
11
11
|
|
|
12
12
|
- **Agent personas** live in `agents/<name>.md`. They define a *role* another agent adopts when it needs specialized review, audit, or analysis. Example: `code-reviewer`, `security-auditor`, `test-engineer`.
|
|
13
13
|
- **Skills** live in `skills/<name>/SKILL.md`. They define a *workflow* — a repeatable process with gated steps, anti-rationalization guardrails, and verification. Example: `spec-driven-development`, `test-driven-development`, `context-engineering`.
|
|
14
|
-
- **pi harnesses** live in `.pi/harnesses/<name>/`. They define a *session environment* — a TypeScript pi extension that reshapes the whole session: setting UI surfaces, gating tool calls, registering new tools or commands, or orchestrating sub-agents. Example: `agent-hub`, `damage-control`, `coms`.
|
|
14
|
+
- **pi harnesses** live in `.pi/harnesses/<name>/`. They define a *session environment* — a TypeScript pi extension that reshapes the whole session: setting UI surfaces, gating tool calls, registering new tools or commands, or orchestrating sub-agents. Example: `agent-hub`, `damage-control-continue`, `coms`.
|
|
15
15
|
|
|
16
16
|
Personas and skills are prose that change an agent's *judgment*. A harness is code that changes the agent's *environment* — what it can do and what it sees. All three fail the same way: a persona that reads like general advice gets cited but ignored; a skill that skips its guardrails becomes a suggestion; a harness built without studying the existing ones collides with pi's auto-discovery or fights another extension. This skill is the workflow for authoring any of the three so the result measurably changes behavior.
|
|
17
17
|
|
|
@@ -316,7 +316,7 @@ A harness is a directory, not a single file. The `ExtensionAPI` surface, the `in
|
|
|
316
316
|
| "I'll skip the Output Format section — the agent will figure it out" (persona) | Without a template, outputs drift across invocations and become uncomparable. Reviewers cannot triage findings that don't share a shape. |
|
|
317
317
|
| "I'll skip the Common Rationalizations table — the steps are obvious" (skill) | Every step that gets skipped had an excuse attached. The table is the only place in the skill that directly blocks those excuses. Skipping it is how skills become suggestions. |
|
|
318
318
|
| "I'll skip the Verification checklist — the user will know when it's done" (skill) | Without evidence requirements, 'seems right' becomes the completion signal. The checklist is what forces proof. |
|
|
319
|
-
| "I'll drop the harness in `.pi/extensions/` so it loads automatically" | pi auto-discovers `.pi/extensions/` and loads everything there at once. Most harnesses are mutually exclusive — footers fight, duplicate CLI flags abort startup. Harnesses live in `.pi/harnesses/` and load explicitly; the supported stack
|
|
319
|
+
| "I'll drop the harness in `.pi/extensions/` so it loads automatically" | pi auto-discovers `.pi/extensions/` and loads everything there at once. Most harnesses are mutually exclusive — footers fight, duplicate CLI flags abort startup. Harnesses live in `.pi/harnesses/` and load explicitly; the supported stack loads `damage-control-continue` before `agent-hub`. |
|
|
320
320
|
| "I'll write the harness `index.ts` from memory — I've seen the pattern" | The `ExtensionAPI` surface is specific and unforgiving; a misspelled event name fails silently. Read `pi-harness-authoring.md` and copy the closest existing harness. |
|
|
321
321
|
| "I'll skip the harness README and catalog row — `index.ts` is the real artifact" | A harness with no row in `docs/pi-extensions.md` is undiscoverable; no agent will load it. The README is its discovery surface — the same role frontmatter plays for a skill. |
|
|
322
322
|
| "I'll copy an existing artifact and tweak it" | For prose artifacts, copy-paste creates silent duplication and drift — read the existing files to learn the pattern, then write fresh. For a harness, copying the nearest `index.ts` *is* the recommended start; just rename it cleanly and cut what you don't use. |
|
|
@@ -9,8 +9,8 @@ A pi harness is a TypeScript pi extension that reshapes a whole session. The har
|
|
|
9
9
|
in `.pi/harnesses/` were ported from `disler/pi-vs-claude-code`; `docs/pi-extensions.md`
|
|
10
10
|
is their catalog. A harness can:
|
|
11
11
|
|
|
12
|
-
- set status, widgets, or overlays — `agent-hub`, `damage-control`
|
|
13
|
-
- gate every tool call and block or confirm it — `damage-control`
|
|
12
|
+
- set status, widgets, or overlays — `agent-hub`, `damage-control-continue`
|
|
13
|
+
- gate every tool call and block or confirm it — `damage-control-continue`
|
|
14
14
|
- register a new tool or `/command` — `agent-hub`, `coms`
|
|
15
15
|
- inject text into the system prompt — `agent-hub`
|
|
16
16
|
- orchestrate sub-agents — `agent-hub`
|
|
@@ -23,37 +23,47 @@ pi auto-discovers and loads **every** directory under `.pi/extensions/`. The thr
|
|
|
23
23
|
coexist. Harnesses are different: most are **mutually exclusive** — two that both replace
|
|
24
24
|
the footer fight, two that register the same CLI flag abort startup. So harnesses live in
|
|
25
25
|
`.pi/harnesses/`, which pi does **not** auto-discover, and load explicitly via `pi -e <path>`
|
|
26
|
-
or the `justfile`. The supported stack is `damage-control` before `agent-hub`; never put a
|
|
26
|
+
or the `justfile`. The supported stack is `damage-control-continue` before `agent-hub`; never put a
|
|
27
27
|
harness under `.pi/extensions/`.
|
|
28
28
|
|
|
29
29
|
## Directory anatomy
|
|
30
30
|
|
|
31
|
-
Every harness
|
|
31
|
+
Every harness has these three required baseline files:
|
|
32
32
|
|
|
33
33
|
```
|
|
34
34
|
.pi/harnesses/<name>/
|
|
35
35
|
index.ts # the extension
|
|
36
|
-
package.json #
|
|
36
|
+
package.json # shared manifest fields; persistent-UI targets add a version stamp
|
|
37
37
|
README.md # the discovery surface
|
|
38
38
|
```
|
|
39
39
|
|
|
40
|
+
Persistent-UI targets may additionally include a local `version.ts` provenance reader beside
|
|
41
|
+
their adjacent stamped `package.json`; do not describe those target harnesses as having exactly
|
|
42
|
+
three files.
|
|
43
|
+
|
|
40
44
|
### package.json
|
|
41
45
|
|
|
42
|
-
|
|
46
|
+
Every harness manifest shares the same base shape (only `name` changes). Persistent-UI targets
|
|
47
|
+
add a root-derived `version` stamp:
|
|
43
48
|
|
|
44
49
|
```json
|
|
45
50
|
{
|
|
46
51
|
"name": "agent-fleet-pi-<name>",
|
|
47
52
|
"private": true,
|
|
48
53
|
"type": "module",
|
|
49
|
-
"main": "index.ts"
|
|
54
|
+
"main": "index.ts",
|
|
55
|
+
"version": "<root package version>"
|
|
50
56
|
}
|
|
51
57
|
```
|
|
52
58
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
59
|
+
The root `package.json` is canonical; `bin/sync-harness-versions.js` synchronizes the adjacent
|
|
60
|
+
harness stamps. A persistent-UI harness may keep a local provenance reader beside that manifest
|
|
61
|
+
so a copied or symlinked directory resolves its adjacent stamp, not the launch cwd. This does
|
|
62
|
+
**not** make it dependency-free. Runtime dependencies remain in `.pi/harnesses/package.json` and
|
|
63
|
+
are installed once by `just install`; copied/symlinked target harnesses still need that full
|
|
64
|
+
harness dependency installation. The `@mariozechner/pi-*` packages are provided by the pi runtime.
|
|
65
|
+
If a harness needs a new dependency, add it to `.pi/harnesses/package.json`, not the per-harness
|
|
66
|
+
file.
|
|
57
67
|
|
|
58
68
|
## The ExtensionAPI surface
|
|
59
69
|
|
|
@@ -107,7 +117,10 @@ Handlers are `async (event, ctx) => …`.
|
|
|
107
117
|
- `ctx.sessionManager.getBranch()` — session entries, for state reconstruction
|
|
108
118
|
- `ctx.abort()` — abort the current turn
|
|
109
119
|
- `ctx.hasUI` — false in headless runs; guard UI-only commands with it
|
|
110
|
-
- `ctx.ui.setFooter(fn)` / `setWidget(id, fn, opts)` / `setStatus(
|
|
120
|
+
- `ctx.ui.setFooter(fn)` / `setWidget(id, fn, opts)` / `setStatus(key, text)` — UI surfaces.
|
|
121
|
+
Use a stable, namespaced status key per concern. Stack-wide data such as the harness version
|
|
122
|
+
uses one shared key so stacked harnesses deduplicate `v<version>`; mutable status (for example,
|
|
123
|
+
Damage-Control activity or violations) uses its own key and must not overwrite that version.
|
|
111
124
|
- `ctx.ui.notify(text, level)` — transient message (`info` | `warning` | `error` | `success`)
|
|
112
125
|
- `ctx.ui.confirm(title, body, opts)` — yes/no dialog
|
|
113
126
|
- `ctx.ui.select(title, options)` — pick-one dialog
|
|
@@ -148,7 +161,7 @@ Do not write from scratch. Pick the nearest pattern and adapt it:
|
|
|
148
161
|
|
|
149
162
|
| If the harness… | Study | Approx. lines |
|
|
150
163
|
|---|---|---|
|
|
151
|
-
| Blocks tool calls from a rules file | `damage-control` |
|
|
164
|
+
| Blocks tool calls from a rules file | `damage-control-continue` | ~530 |
|
|
152
165
|
| Sets widgets/status or registers orchestration commands/tools | `agent-hub` | large |
|
|
153
166
|
| Orchestrates sub-agents | `agent-hub` | large |
|
|
154
167
|
| Adds local cross-agent messaging | `coms`, `agent-hub` | large |
|