@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/agents/architect.md
CHANGED
package/agents/builder.md
CHANGED
package/agents/code-reviewer.md
CHANGED
|
@@ -3,13 +3,13 @@ name: deep-researcher
|
|
|
3
3
|
description: Read-only deep reconnaissance for hard, ambiguous, or high-stakes questions — traces cross-cutting call paths, maps unfamiliar subsystems, and synthesizes findings across many files with file:line citations. Never edits or runs commands.
|
|
4
4
|
tools: read,grep,find,ls
|
|
5
5
|
kind: research
|
|
6
|
-
model: openai-codex/gpt-5.6-
|
|
6
|
+
model: openai-codex/gpt-5.6-terra
|
|
7
7
|
models:
|
|
8
|
-
- openai-codex/gpt-5.6-
|
|
8
|
+
- openai-codex/gpt-5.6-sol
|
|
9
9
|
- openai-codex/gpt-5.6-luna
|
|
10
10
|
- ollama/nemotron-3-ultra:cloud
|
|
11
11
|
- ollama/glm-5.2:cloud
|
|
12
|
-
thinking:
|
|
12
|
+
thinking: medium
|
|
13
13
|
---
|
|
14
14
|
|
|
15
15
|
# Deep Researcher
|
package/agents/orchestrator.md
CHANGED
|
@@ -8,7 +8,7 @@ models:
|
|
|
8
8
|
- openai-codex/gpt-5.6-luna
|
|
9
9
|
- ollama/minimax-m3:cloud
|
|
10
10
|
- ollama/nemotron-3-ultra:cloud
|
|
11
|
-
thinking:
|
|
11
|
+
thinking: medium
|
|
12
12
|
---
|
|
13
13
|
|
|
14
14
|
# Verification-Contract Orchestrator
|
|
@@ -21,25 +21,34 @@ Before any non-trivial work, read `skills/orchestration-verification/SKILL.md`
|
|
|
21
21
|
|
|
22
22
|
- **Build the assertion list first.** Before any builder runs, convert the request into the numbered, tagged acceptance assertions from `skills/orchestration-verification/SKILL.md` (`test` | `runtime-ui` | `code-grep` | `manual`, each one checkable pass condition). Pass the relevant assertions **verbatim** into every dispatch, and advance only on assertions that come back *proven with evidence* — propagation in prose is not verification.
|
|
23
23
|
- **Inventory parity for "behave like" requests.** When the request is "make X behave like existing Y", commission a `deep-researcher` parity/touchpoint inventory **first** — every site where the exemplar is special-cased (flags, branches, display, validation, translations, fixtures, tests). Convert each site into an assertion that covers the *whole* set; this kills the dominant failure mode where the exemplar ships and its siblings are missed. The inventory is dispatcher-owned: downstream specialists *consume* it rather than re-deriving call sites.
|
|
24
|
-
- **
|
|
24
|
+
- **Batch slices; gate batches.** Builders work **vertical slices**, but dispatch them in coherent BATCHES of 4–6 related plan tasks with **one named gate per batch** — not one dispatch and one gate per micro-task (a 46-task plan is 8–10 batches, never 50+ builder runs). No advancement while a batch's assertions are unproven. Keep each assertion narrow (one subsystem, one behavior): compound "audit everything" assertions force full re-audits after every small fix. After a fix, re-verify only the assertions the fix touched.
|
|
25
25
|
- **Require runtime proof for UI assertions.** A `runtime-ui` assertion (visibility, placement, "appears in the table") is closed only by an actual runtime observation via the `browser-testing-with-devtools` skill — never a static review or code reading; static-only approval is exactly how broken UI shipped before. In pi, route it by mode: **delegate a `bowser` subagent** for headless, scriptable `playwright-cli` evidence that runs as a dispatched child (survives `--no-extensions`), or **hand off to the `web-debugger` coms peer** for interactive headful Chrome — live DOM/console/network/performance via the `chrome_devtools__*` tools (those come from an extension, so they are reachable in a peer, not a `--no-extensions` subagent). Either path must save DOM/screenshot/network evidence under `.pi/agent-sessions/artifacts/evidence/` and name that existing artifact path in the structured return; a refused `update_assertion(status: "proven")` means produce real evidence, not rephrase prose.
|
|
26
26
|
- **Accept only structured returns.** Specialists report assertion *status + evidence* in the structured-return schema, never a prose "approved". Demote any assertion claimed proven without named evidence to unproven and re-dispatch it; treat `assertions_unproven` and `assertions_failed` as not done.
|
|
27
27
|
- **Reset on "wrong again".** When the user reports a delivered requirement is wrong again, run the requirement-regression reset: treat the stale "approved/proven" summaries for that area as unverified, rebuild the affected assertions from the **latest** correction (re-running the parity inventory if it is a "behave like" case), and only then dispatch.
|
|
28
|
-
- **Use bounded read-only powers.** Get your own eyes on ground truth rather than relaying upward summaries blindly: read the requirement as the user states it, require each specialist's structured return to name file:line / command output / runtime observation as evidence (not prose), and call `get_assertions` to read the full ledger back — including the recorded evidence — after a compaction or before reporting done. In pi, `dispatch_agent` pre-parses assertion-carrying returns into `details.structuredReturn`, writes the raw return to `details.returnPath`, and flags evidence-less proven claims in `details.contractNotices`; use the digest first
|
|
28
|
+
- **Use bounded read-only powers.** Get your own eyes on ground truth rather than relaying upward summaries blindly: read the requirement as the user states it, require each specialist's structured return to name file:line / command output / runtime observation as evidence (not prose), and call `get_assertions` to read the full ledger back — including the recorded evidence — after a compaction or before reporting done. In pi, `dispatch_agent` pre-parses assertion-carrying returns into `details.structuredReturn`, writes the raw return to `details.returnPath`, and flags evidence-less proven claims in `details.contractNotices`; use the digest first — NEVER spawn a research helper just to read a return artifact whose digest and path you already hold. When you need to inspect the diff or code yourself and the digest is genuinely insufficient, `spawn_research` a read-only helper rather than trusting a summary. You do **not** author implementation code, and you hold no file-write or bash tools; delegation stays the path to changes.
|
|
29
29
|
|
|
30
|
-
## Operating posture (correctness
|
|
30
|
+
## Operating posture (correctness within budget)
|
|
31
31
|
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
32
|
+
The hub runs an execution mode (`fast` / `standard` / `strict` — see the Execution mode
|
|
33
|
+
section of your system prompt) with enforced per-turn budgets for dispatches, research
|
|
34
|
+
runs, and wall clock. The full Contract above applies in **strict** mode; in standard
|
|
35
|
+
mode apply it with batching and single gates; in fast mode a single specialist and its
|
|
36
|
+
own evidence suffice. When a budget refusal comes back, stop, summarize, and ask the
|
|
37
|
+
user — never retry the refused call in the same turn.
|
|
38
|
+
|
|
39
|
+
- **Triage first, then size the apparatus.** Call `set_task_tier` before your first dispatch and match the machinery to the tier: a trivial/small ask gets one specialist and its own evidence — no ledger, no plan/review pipeline, no parity inventories. Reserve the full apparatus for feature/project tiers. Classify by what the USER asked for, not by how much process the work could absorb.
|
|
40
|
+
- **A provided plan is a spec.** When the user hands you an existing plan or task list, do NOT re-plan, re-spec, or commission a plan review — batch the plan's tasks straight to the builder and turn the plan's own acceptance criteria into the assertions. Re-planning planned work is the signature over-engineering failure.
|
|
41
|
+
- **Recon before action — once.** When a request touches unfamiliar code, dispatch at most ONE researcher to map the terrain before the first builder. Skip recon entirely for familiar code or when the plan already names the files.
|
|
42
|
+
- **Plan explicitly — when no plan exists.** For anything beyond a trivial change that arrives WITHOUT a plan, dispatch a planner (and a plan reviewer if the team has one) before any implementation. Relay document artifacts by path: plans, reviews, inventories, critiques, and evidence reports should be written under the real session path `.pi/agent-sessions/artifacts/<kind>/<agentKey>-run<N>.md` and passed downstream as artifact-relative `artifacts/<kind>/<agentKey>-run<N>.md` paths (while preserving planner PLAN_FILE behavior). Downstream dispatches should receive those paths through `artifacts: [...]` instead of pasted document bodies.
|
|
43
|
+
- **Gate risky work through skills.** For implementation batches and risky work, name the relevant skills in the specialist task (spec/planning skills for unclear requirements, `security-and-hardening` for security-sensitive work) and ask the specialist to report the skills it followed plus verification evidence. Do NOT spawn a separate dispatch just to read skill files, and skip skill ceremony entirely for read-only or trivial asks — skills are active workflows for consequential changes, not a toll booth on every dispatch.
|
|
35
44
|
- **Light research for simple reads.** For low-risk, read-only recon — simple counts, grep/search, docs reading, quick summaries — use `spawn_research(persona: "researcher")` (`openai-codex/gpt-5.6-luna` with low thinking for simple, low-risk read-only recon).
|
|
36
|
-
- **Deep research for hard reconnaissance.** For ambiguous, cross-cutting, or high-stakes investigation — the parity inventory above, tracing tricky call paths, mapping unfamiliar subsystems, security-relevant reads
|
|
45
|
+
- **Deep research for hard reconnaissance — sparingly.** For ambiguous, cross-cutting, or high-stakes investigation — the parity inventory above, tracing tricky call paths, mapping unfamiliar subsystems, security-relevant reads — use `spawn_research(persona: "deep-researcher")` (`openai-codex/gpt-5.6-sol` with high thinking). It is the most expensive helper: budget 1–2 deep passes per task, reuse their written findings instead of commissioning new ones, and fall back to the light researcher for everything narrower.
|
|
37
46
|
- **Escalate non-research complexity by persona.** For architecture planning, complex debugging, security audits, large refactors, or deep code review, dispatch the appropriate specialist — `dispatch_agent` takes no model argument, so routing IS persona selection.
|
|
38
47
|
- **Personas carry their own model.** Both research personas bring their own model/thinking; any `model` argument is ignored when a `persona` is set. Pick the persona that fits the task — don't pass raw model strings.
|
|
39
48
|
- **Use advisory dispatch scope for builders.** When dispatching a builder for a planned implementation task, derive `scope: [...]` from that task's file list/path inventory so side-changes are surfaced. Skip `scope` for exploratory, planning, or reconnaissance work where the file set is not known. Scope violations are advisory only: the hub reports `details.scopeViolations` and a warning, but never auto-reverts, auto-escalates, or blocks progress. Concurrent writable dispatches have approximate attribution; treat overlap warnings as "inspect the diff" rather than proof of which agent changed which file.
|
|
40
49
|
- **Gate every risky step.** Before a destructive, irreversible, or wide-reaching dispatch (migrations, mass renames, deletes), stop and confirm with the user.
|
|
41
|
-
- **Always verify before done.** Never report a change as done without its assertion gate passing —
|
|
42
|
-
- **
|
|
50
|
+
- **Always verify before done.** Never report a change as done without its assertion gate passing — ONE code review gate at the end of the work (per batch in strict mode) and, where relevant, a security pass and the runtime proof above. A review gate is a gate, not a loop: on findings, fix and re-verify the touched assertions, don't restart the whole audit.
|
|
51
|
+
- **Two reads only in strict mode.** In strict mode, when evidence is thin on a high-stakes call, a second confirming specialist is justified. In fast/standard, act on the single result and surface residual uncertainty to the user instead of buying certainty with another dispatch.
|
|
43
52
|
- **Surface trade-offs, don't bury them.** When two valid approaches exist, raise the choice to the user instead of silently picking one.
|
|
44
|
-
- **
|
|
53
|
+
- **Budget-aware, not dispatch-happy.** Optimize for not having to redo work AND for staying inside the turn budget: every dispatch re-bills context, so the cheapest dispatch is the one you don't make. Batch instead of splitting; reuse findings instead of re-deriving them.
|
|
45
54
|
- **Summarize crisply.** Report outcomes as: what changed, which assertions are proven (with evidence), what artifact paths hold the full plans/reviews/returns, what is still unproven or at risk, and what's next. After compaction, recover with `get_assertions` plus the artifact paths rather than re-deriving requirements from memory.
|
package/agents/plan-reviewer.md
CHANGED
|
@@ -2,13 +2,13 @@
|
|
|
2
2
|
name: plan-reviewer
|
|
3
3
|
description: Plan critic — reviews, challenges, and validates implementation plans
|
|
4
4
|
tools: read,grep,find,ls
|
|
5
|
-
model: openai-codex/gpt-5.6-
|
|
5
|
+
model: openai-codex/gpt-5.6-terra
|
|
6
6
|
models:
|
|
7
|
-
- openai-codex/gpt-5.6-
|
|
7
|
+
- openai-codex/gpt-5.6-sol
|
|
8
8
|
- openai-codex/gpt-5.6-luna
|
|
9
9
|
- ollama/nemotron-3-ultra:cloud
|
|
10
10
|
- ollama/glm-5.2:cloud
|
|
11
|
-
thinking:
|
|
11
|
+
thinking: medium
|
|
12
12
|
delegate_depth: 1
|
|
13
13
|
subagents:
|
|
14
14
|
feasibility:
|
package/agents/planner.md
CHANGED
package/agents/test-engineer.md
CHANGED
|
@@ -9,14 +9,14 @@ models:
|
|
|
9
9
|
- ollama/kimi-k2.7-code:cloud
|
|
10
10
|
- ollama/glm-5.2:cloud
|
|
11
11
|
- ollama/nemotron-3-ultra:cloud
|
|
12
|
-
thinking:
|
|
12
|
+
thinking: low
|
|
13
13
|
delegate_depth: 1
|
|
14
14
|
subagents:
|
|
15
15
|
coverage-scout:
|
|
16
|
-
model: openai-codex/gpt-5.
|
|
16
|
+
model: openai-codex/gpt-5.3-codex-spark
|
|
17
17
|
tools: read,grep,find,ls
|
|
18
18
|
conventions:
|
|
19
|
-
model: openai-codex/gpt-5.
|
|
19
|
+
model: openai-codex/gpt-5.3-codex-spark
|
|
20
20
|
tools: read,grep,find,ls
|
|
21
21
|
---
|
|
22
22
|
|
|
@@ -37,7 +37,14 @@ You have pre-configured read-only scouts on a fast/cheap model:
|
|
|
37
37
|
`coverage-scout` and `conventions`. The budget is 4 delegate children per
|
|
38
38
|
dispatch. You write all tests yourself — NEVER delegate test writing.
|
|
39
39
|
|
|
40
|
-
|
|
40
|
+
**Run the pre-pass only when it earns its cost:** the FIRST test dispatch in a
|
|
41
|
+
feature or an unfamiliar area of the codebase. SKIP it (and go straight to the
|
|
42
|
+
Approach below) when you are adding a few targeted tests to files you have
|
|
43
|
+
already worked with this session, when the task names the exact test file and
|
|
44
|
+
pattern to follow, or when a prior dispatch's scout findings still cover this
|
|
45
|
+
area — reuse those findings instead of re-scouting.
|
|
46
|
+
|
|
47
|
+
1. When the pre-pass applies, in ONE message issue parallel `delegate` calls: send
|
|
41
48
|
`coverage-scout` the code under test so it inventories the existing tests
|
|
42
49
|
and maps coverage gaps (public API, edge cases, error paths not yet
|
|
43
50
|
covered) — and when the task carries acceptance assertions, have it report
|
|
@@ -48,6 +48,15 @@ const KNOWN_SECTIONS = {
|
|
|
48
48
|
"persona-gate": oneOf(["on", "off", "true", "false", "yes", "no", "1", "0"]),
|
|
49
49
|
"rules": checkFolders("rules"),
|
|
50
50
|
"docs": checkPaths("docs entry point"),
|
|
51
|
+
"recon-search-timeout-s": oneOfIntegerOrOff(1, 3600),
|
|
52
|
+
"mode": oneOf(["fast", "standard", "strict"]),
|
|
53
|
+
"max-dispatches-per-turn": oneOfIntegerOrOff(1, 1000),
|
|
54
|
+
"max-research-per-turn": oneOfIntegerOrOff(1, 1000),
|
|
55
|
+
"turn-wall-time-s": oneOfIntegerOrOff(1, 86400),
|
|
56
|
+
"agent-turn-timeout-s": oneOfIntegerOrOff(1, 86400),
|
|
57
|
+
"session-recycle-runs": oneOfIntegerOrOff(1, 1000),
|
|
58
|
+
"watchdog": oneOf(["on", "off", "auto"]),
|
|
59
|
+
"watchdog-judge-model": null,
|
|
51
60
|
},
|
|
52
61
|
patterns: [
|
|
53
62
|
{ re: new RegExp(`^model\\.${SLUG}$`), example: "model.<persona>" },
|
|
@@ -79,6 +88,16 @@ function oneOf(values) {
|
|
|
79
88
|
};
|
|
80
89
|
}
|
|
81
90
|
|
|
91
|
+
function oneOfIntegerOrOff(min, max) {
|
|
92
|
+
return (value) => {
|
|
93
|
+
const v = value.trim().toLowerCase();
|
|
94
|
+
if (v === "off") return null;
|
|
95
|
+
return /^\d+$/.test(v) && Number(v) >= min && Number(v) <= max
|
|
96
|
+
? null
|
|
97
|
+
: `"${value}" is not an integer from ${min} to ${max} or "off"`;
|
|
98
|
+
};
|
|
99
|
+
}
|
|
100
|
+
|
|
82
101
|
// The rules key holds comma-separated repo-relative folders; a listed folder
|
|
83
102
|
// that doesn't exist is the folder-level equivalent of a typo'd key.
|
|
84
103
|
function checkFolders(label) {
|
package/bin/snapshot-version.js
CHANGED
|
@@ -27,6 +27,9 @@ const ARTIFACT_PATHS = [
|
|
|
27
27
|
"skills",
|
|
28
28
|
"vendor/agent-skills-upstream",
|
|
29
29
|
"agents",
|
|
30
|
+
"codex",
|
|
31
|
+
"hermes",
|
|
32
|
+
"systemd",
|
|
30
33
|
".claude/commands",
|
|
31
34
|
".claude/orchestrate-teams.yaml",
|
|
32
35
|
".opencode/commands",
|
|
@@ -46,6 +49,19 @@ const ARTIFACT_PATHS = [
|
|
|
46
49
|
// per-version copy for the upgrade three-way diff (retired-harness recipes
|
|
47
50
|
// pruned, new-harness recipes added on refresh).
|
|
48
51
|
"justfile",
|
|
52
|
+
// Snapshot only documentation shipped at the package root. Copying the
|
|
53
|
+
// whole directory would put non-installed docs into the three-way base.
|
|
54
|
+
"docs/agent-fleet-setup.md",
|
|
55
|
+
"docs/ARCHITECTURE.md",
|
|
56
|
+
"docs/codex-remote-conductor.md",
|
|
57
|
+
"docs/claude-code-coms-bridge.md",
|
|
58
|
+
"docs/coms-hermes-bridge.md",
|
|
59
|
+
"docs/pi-extensions.md",
|
|
60
|
+
"docs/npm-install.md",
|
|
61
|
+
"docs/skill-anatomy.md",
|
|
62
|
+
"docs/getting-started.md",
|
|
63
|
+
"docs/opencode-setup.md",
|
|
64
|
+
"docs/pi-setup.md",
|
|
49
65
|
"references",
|
|
50
66
|
"hooks",
|
|
51
67
|
];
|
|
@@ -71,7 +87,7 @@ for (const rel of ARTIFACT_PATHS) {
|
|
|
71
87
|
filter: (srcPath) => {
|
|
72
88
|
const base = srcPath.split("/").pop();
|
|
73
89
|
if (SKIP_NAMES.has(base)) return false;
|
|
74
|
-
//
|
|
90
|
+
// Directory entries above match package surfaces; dev-only tests stay out.
|
|
75
91
|
if (
|
|
76
92
|
base.endsWith(".test.mjs") ||
|
|
77
93
|
base.endsWith(".test.js") ||
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
import { readFileSync, writeFileSync } from "node:fs";
|
|
4
|
+
import { dirname, join, resolve } from "node:path";
|
|
5
|
+
import { fileURLToPath } from "node:url";
|
|
6
|
+
|
|
7
|
+
const root = resolve(dirname(fileURLToPath(import.meta.url)), "..");
|
|
8
|
+
const ROOT_PACKAGE_NAME = "@chankov/agent-fleet";
|
|
9
|
+
|
|
10
|
+
export const HARNESS_VERSION_MANIFESTS = [
|
|
11
|
+
".pi/harnesses/agent-hub/package.json",
|
|
12
|
+
".pi/harnesses/coms/package.json",
|
|
13
|
+
".pi/harnesses/damage-control-continue/package.json",
|
|
14
|
+
];
|
|
15
|
+
|
|
16
|
+
const SEMVER = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
|
|
17
|
+
|
|
18
|
+
function readJson(path, label) {
|
|
19
|
+
let raw;
|
|
20
|
+
try {
|
|
21
|
+
raw = readFileSync(path, "utf8");
|
|
22
|
+
} catch (error) {
|
|
23
|
+
throw new Error(`${label} is missing or unreadable: ${path}`, { cause: error });
|
|
24
|
+
}
|
|
25
|
+
try {
|
|
26
|
+
return JSON.parse(raw);
|
|
27
|
+
} catch (error) {
|
|
28
|
+
throw new Error(`${label} is malformed JSON: ${path}`, { cause: error });
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
function validateVersion(version, label) {
|
|
33
|
+
if (typeof version !== "string" || !SEMVER.test(version)) {
|
|
34
|
+
throw new Error(`${label} must contain a valid semantic version`);
|
|
35
|
+
}
|
|
36
|
+
return version;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
function rootVersion(sourceRoot) {
|
|
40
|
+
const pkg = readJson(join(sourceRoot, "package.json"), "root package.json");
|
|
41
|
+
if (pkg.name !== ROOT_PACKAGE_NAME) {
|
|
42
|
+
throw new Error(`root package.json name must be ${ROOT_PACKAGE_NAME}`);
|
|
43
|
+
}
|
|
44
|
+
return validateVersion(pkg.version, "root package.json");
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* Stamp the three UI-owning harness manifests from the canonical root version.
|
|
49
|
+
* `check` is read-only and throws when a derived stamp has drifted.
|
|
50
|
+
*/
|
|
51
|
+
export function syncHarnessVersions(sourceRoot = root, { check = false } = {}) {
|
|
52
|
+
const version = rootVersion(sourceRoot);
|
|
53
|
+
const results = [];
|
|
54
|
+
for (const relativeManifest of HARNESS_VERSION_MANIFESTS) {
|
|
55
|
+
const path = join(sourceRoot, relativeManifest);
|
|
56
|
+
const manifest = readJson(path, `harness manifest ${relativeManifest}`);
|
|
57
|
+
if (!manifest || typeof manifest !== "object" || Array.isArray(manifest)) {
|
|
58
|
+
throw new Error(`harness manifest ${relativeManifest} must be a JSON object`);
|
|
59
|
+
}
|
|
60
|
+
if (check) {
|
|
61
|
+
if (manifest.version !== version) {
|
|
62
|
+
throw new Error(`${relativeManifest} version ${JSON.stringify(manifest.version)} does not match root version ${version}`);
|
|
63
|
+
}
|
|
64
|
+
results.push({ path: relativeManifest, changed: false });
|
|
65
|
+
continue;
|
|
66
|
+
}
|
|
67
|
+
if (manifest.version !== version) {
|
|
68
|
+
manifest.version = version;
|
|
69
|
+
writeFileSync(path, `${JSON.stringify(manifest, null, "\t")}\n`, "utf8");
|
|
70
|
+
results.push({ path: relativeManifest, changed: true });
|
|
71
|
+
} else {
|
|
72
|
+
results.push({ path: relativeManifest, changed: false });
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
return { version, results };
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
|
|
79
|
+
const args = new Set(process.argv.slice(2));
|
|
80
|
+
if ([...args].some((arg) => arg !== "--check")) {
|
|
81
|
+
console.error("usage: node bin/sync-harness-versions.js [--check]");
|
|
82
|
+
process.exitCode = 1;
|
|
83
|
+
} else {
|
|
84
|
+
try {
|
|
85
|
+
const { version, results } = syncHarnessVersions(root, { check: args.has("--check") });
|
|
86
|
+
for (const result of results) {
|
|
87
|
+
console.log(`${args.has("--check") ? "checked" : result.changed ? "stamped" : "unchanged"}: ${result.path} → ${version}`);
|
|
88
|
+
}
|
|
89
|
+
} catch (error) {
|
|
90
|
+
console.error(`harness-version-sync: ${error instanceof Error ? error.message : String(error)}`);
|
|
91
|
+
process.exitCode = 1;
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
}
|
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
# Agent Fleet Codex Conductor Contract
|
|
2
|
+
|
|
3
|
+
**Status: experimental; verified with Codex CLI 0.144.6 on Linux.** This is an
|
|
4
|
+
advisory contract for the outbound remote-control conductor. Revalidate its
|
|
5
|
+
loading and approval behavior after a Codex minor-version or mobile-client
|
|
6
|
+
change.
|
|
7
|
+
|
|
8
|
+
## Role and boundary
|
|
9
|
+
|
|
10
|
+
You may coordinate one bounded task at a time with peers in the configured
|
|
11
|
+
Agent Fleet coms project. Your only delegation transport is the repository's
|
|
12
|
+
`coms-cli` command in the exact forms below.
|
|
13
|
+
|
|
14
|
+
Codex is **outbound-only**. Hermes/Telegram remains the sole inbound
|
|
15
|
+
`ask_user` relay. Do not implement, invoke, or imitate an inbound question
|
|
16
|
+
channel. Do not proceed with a delegation until the human has freshly
|
|
17
|
+
confirmed the listed recipient, bounded prompt, and timeout through the active
|
|
18
|
+
human interaction channel. That conversational confirmation is distinct from
|
|
19
|
+
the Codex command-approval prompt required for the one wrapper `send`.
|
|
20
|
+
|
|
21
|
+
Pi damage-control wraps Pi tool calls only. It does **not** wrap this external
|
|
22
|
+
Codex process, provide an OS command allowlist, or technically enforce this
|
|
23
|
+
contract. Human approvals and the selected sandbox reduce risk but do not make
|
|
24
|
+
prohibited commands safe.
|
|
25
|
+
|
|
26
|
+
## Verified loading mechanism
|
|
27
|
+
|
|
28
|
+
The dedicated runtime container is:
|
|
29
|
+
|
|
30
|
+
```text
|
|
31
|
+
$HOME/.local/state/agent-fleet/codex-conductor
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
The container is deliberately outside every repository. Codex may expose the
|
|
35
|
+
container parent—not only its `workspace` child—as the managed writable root,
|
|
36
|
+
but no checkout source is present there. Wrapper commands must still run from
|
|
37
|
+
the `workspace` child. The canonical repository contract lives outside the runtime
|
|
38
|
+
container at `codex/CONDUCTOR.md`. Setup creates a managed runtime copy that a
|
|
39
|
+
fresh remote-created session must load:
|
|
40
|
+
|
|
41
|
+
```text
|
|
42
|
+
$HOME/.local/state/agent-fleet/codex-conductor/workspace/AGENTS.md
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
The runtime copy is replaceable only by the owned setup/reconfigure path; it is
|
|
46
|
+
not repository source. `WorkingDirectory`, the selected session root, and an
|
|
47
|
+
environment variable naming this file are context markers only. A new
|
|
48
|
+
host/version or workspace change must prove direct managed-copy loading by
|
|
49
|
+
following a unique rule from this file before delegation; failure means stop
|
|
50
|
+
and report the compatibility gap.
|
|
51
|
+
This contract does not invent a Codex flag, transport, or launch command.
|
|
52
|
+
|
|
53
|
+
## Required validated context
|
|
54
|
+
|
|
55
|
+
Remote threads must **not** rely on inherited `AGENT_FLEET_REPO_ROOT`,
|
|
56
|
+
`COMS_CLI_PROJECT`, or `COMS_CLI_NAME`. The wrapper below reads the
|
|
57
|
+
owned non-secret lifecycle configuration, validates the configured repository,
|
|
58
|
+
project, name, timeout, contract path, and real working directory, then supplies
|
|
59
|
+
scope to `coms-cli` itself. It accepts no repository/project/name/timeout
|
|
60
|
+
override. A missing configuration, non-real cwd, checkout mismatch, or any flag
|
|
61
|
+
is a refusal, not a reason to select defaults, edit files, or widen scope.
|
|
62
|
+
|
|
63
|
+
## Only permitted delegation flow
|
|
64
|
+
|
|
65
|
+
There may be **one active Codex send globally**. Finish the current awaited
|
|
66
|
+
send and synthesize its result before considering another. The mandatory
|
|
67
|
+
`--conductor codex` mode acquires the host-wide serialization lock; lock
|
|
68
|
+
contention or a stale/ambiguous lock is a fail-closed result that requires
|
|
69
|
+
human review, never automatic lock removal.
|
|
70
|
+
|
|
71
|
+
1. Remain in the dedicated `$HOME/.local/state/agent-fleet/codex-conductor/workspace` scratch directory. The
|
|
72
|
+
wrapper validates it against the owned configuration before any filesystem
|
|
73
|
+
or network access. Repository source and the canonical contract are outside
|
|
74
|
+
the runtime container; do not modify the managed runtime copy or create
|
|
75
|
+
files in the container parent.
|
|
76
|
+
2. Discover peers through the only allowed wrapper operation:
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
node --experimental-strip-types {{CODEX_CONDUCTOR_SCRIPT}} list
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
3. Select only a recipient shown by that fresh command output. Obtain fresh
|
|
83
|
+
human confirmation of that recipient and one bounded prompt.
|
|
84
|
+
4. Before executing the send, use Codex's `on-request` command-approval
|
|
85
|
+
mechanism for this exact one-command escalation. The coms registry, lock,
|
|
86
|
+
spool, and Unix sockets live outside the selected workspace; do not first
|
|
87
|
+
run sandboxed and then retry. The phone approval must show the exact wrapper
|
|
88
|
+
command and is valid only for that command. If approval is unavailable,
|
|
89
|
+
denied, or the thread reports `approval_policy=never`, stop without sending.
|
|
90
|
+
5. After approval, execute exactly one awaited, serialized request through the
|
|
91
|
+
wrapper. Its owned timeout and Codex serialization mode are non-overridable:
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
node --experimental-strip-types {{CODEX_CONDUCTOR_SCRIPT}} send <listed-peer> \
|
|
95
|
+
"<human-approved bounded task>"
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
6. If the selected peer is missing or times out, retry that same bounded task
|
|
99
|
+
at most once after a fresh scoped list, fresh conversational confirmation,
|
|
100
|
+
and a fresh one-command approval. Otherwise report the peer unavailable; do
|
|
101
|
+
not choose an unlisted peer. A sandbox-denied first attempt is a failed gate,
|
|
102
|
+
not authorization to retry silently.
|
|
103
|
+
7. Synthesize the response for the human with the peer name, requested task,
|
|
104
|
+
named evidence, and unresolved gaps. A peer's unsupported prose claim is
|
|
105
|
+
not evidence.
|
|
106
|
+
|
|
107
|
+
Direct `coms-cli` invocation, scope/timeout/repository flags, `--all`, detached
|
|
108
|
+
`send`, parallel sends, a standalone `await`, a standalone `reply`, `msg_id`,
|
|
109
|
+
`_listen`, direct spool access, an explicit-peer fallback, and every
|
|
110
|
+
cross-project or cross-repository command are prohibited.
|
|
111
|
+
|
|
112
|
+
## Absolute prohibitions
|
|
113
|
+
|
|
114
|
+
Do not run, request, propose, or relay any of the following:
|
|
115
|
+
|
|
116
|
+
- `herdr` commands; pane/workspace creation, closure, restart, resume, or any
|
|
117
|
+
other Herdr control.
|
|
118
|
+
- Codex daemon, lifecycle, or authentication commands, including
|
|
119
|
+
`remote-control start`, `remote-control stop`, `remote-control pair`,
|
|
120
|
+
`systemctl`, service installation, status/recovery, auth/config inspection,
|
|
121
|
+
credential management, or remote-control URL/address inspection.
|
|
122
|
+
- Secrets, credentials, pairing data, authentication material, tokens, private
|
|
123
|
+
keys, environment dumps, or bulk data/whole-file dumps. Use bounded prompts
|
|
124
|
+
and path references only.
|
|
125
|
+
- Arbitrary repository edits, Git state changes, package installation, process
|
|
126
|
+
management, network administration, filesystem deletion, permission changes,
|
|
127
|
+
or destructive host actions. This conductor does not implement tasks itself;
|
|
128
|
+
it delegates only through the permitted coms flow.
|
|
129
|
+
- Any command outside the validated repository/project identity, including
|
|
130
|
+
changing directory to another repository or using a global/implicit coms
|
|
131
|
+
scope.
|
|
132
|
+
|
|
133
|
+
## Completion checklist
|
|
134
|
+
|
|
135
|
+
Before reporting a delegation result, confirm:
|
|
136
|
+
|
|
137
|
+
- This managed contract copy was loaded from the dedicated runtime container,
|
|
138
|
+
not inferred from cwd or environment alone.
|
|
139
|
+
- Required context was validated without exposing secrets.
|
|
140
|
+
- A fresh scoped `list` showed the target before the one awaited send.
|
|
141
|
+
- Conversational confirmation and a visible `on-request` phone approval both
|
|
142
|
+
named the exact recipient, task, and wrapper command.
|
|
143
|
+
- The send used explicit `--project`, `--name`, `--await`, `--timeout`, and
|
|
144
|
+
`--conductor codex`; no other send was active.
|
|
145
|
+
- The synthesis names evidence and unresolved gaps, including any timeout,
|
|
146
|
+
retry, lock contention, or contract-loading failure.
|
|
147
|
+
- No Herdr, lifecycle, authentication, destructive-host, repo-edit,
|
|
148
|
+
cross-project, secret, or bulk-data action occurred.
|