@chankov/agent-fleet 0.0.5 → 0.0.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.pi/extensions/agent-fleet-update-check/README.md +4 -4
- package/.pi/extensions/btw/README.md +10 -10
- package/.pi/extensions/btw/index.ts +11 -11
- package/.pi/extensions/chrome-devtools-mcp/README.md +2 -2
- package/.pi/extensions/chrome-devtools-mcp/index.ts +1 -0
- package/.pi/extensions/compact-and-continue/README.md +2 -2
- package/.pi/extensions/pi-voice-stt/README.md +7 -7
- package/.pi/extensions/pi-voice-stt/index.ts +4 -4
- package/.pi/harnesses/agent-hub/README.md +133 -74
- package/.pi/harnesses/agent-hub/artifacts.js +56 -2
- package/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.pi/harnesses/agent-hub/backend-policy.js +1 -1
- package/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.pi/harnesses/agent-hub/delegate.ts +61 -12
- package/.pi/harnesses/agent-hub/drift-watchdog.js +55 -9
- package/.pi/harnesses/agent-hub/helpers.ts +34 -0
- package/.pi/harnesses/agent-hub/index.ts +970 -406
- package/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +2 -2
- package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -11
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.pi/harnesses/agent-hub/return-contract.js +78 -0
- package/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.pi/harnesses/agent-hub/run-budget.js +30 -4
- package/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.pi/harnesses/agent-hub/spawn.ts +109 -1
- package/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
- package/.pi/harnesses/coms/README.md +6 -5
- package/.pi/harnesses/coms/index.ts +92 -70
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/README.md +9 -9
- package/.pi/harnesses/damage-control-continue/index.ts +11 -11
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.pi/harnesses/lib/herdr-client.ts +7 -2
- package/.pi/harnesses/lib/herdr-presence.ts +141 -30
- package/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.pi/harnesses/lib/hermes-monitor-registry.ts +1 -1
- package/.pi/harnesses/lib/hermes-monitor-socket.ts +47 -2
- package/.pi/prompts/{doctor-agent-fleet.md → af-doctor-agent-fleet.md} +1 -1
- package/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.pi/prompts/{setup-agent-fleet.md → af-setup-agent-fleet.md} +1 -1
- package/.versions/0.0.6/.claude/commands/build.md +44 -0
- package/.versions/0.0.6/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.6/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.6/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.6/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.6/.claude/commands/plan.md +16 -0
- package/.versions/0.0.6/.claude/commands/prime.md +22 -0
- package/.versions/0.0.6/.claude/commands/review.md +16 -0
- package/.versions/0.0.6/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.6/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.6/.claude/commands/ship.md +72 -0
- package/.versions/0.0.6/.claude/commands/spec.md +15 -0
- package/.versions/0.0.6/.claude/commands/test.md +19 -0
- package/.versions/0.0.6/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.6/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.6/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.6/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.6/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.6/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.6/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.6/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.6/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.6/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.6/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.6/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.6/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.6/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.6/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.6/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.6/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.6/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.6/.pi/extensions/package.json +9 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/README.md +798 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/delegate.ts +386 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/helpers.ts +214 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/index.ts +8045 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/run-budget.js +155 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/spawn.ts +246 -0
- package/.versions/0.0.6/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.6/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.6/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.6/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.6/.pi/harnesses/coms/README.md +92 -0
- package/.versions/0.0.6/.pi/harnesses/coms/index.ts +1745 -0
- package/.versions/0.0.6/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.6/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.6/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.6/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.versions/0.0.6/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
- package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.6/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.6/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.6/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.6/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.6/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.6/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.6/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.6/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.6/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.6/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.6/.version +1 -0
- package/.versions/0.0.6/agents/architect.md +23 -0
- package/.versions/0.0.6/agents/bowser.md +26 -0
- package/.versions/0.0.6/agents/builder.md +53 -0
- package/.versions/0.0.6/agents/code-reviewer.md +205 -0
- package/.versions/0.0.6/agents/deep-researcher.md +31 -0
- package/.versions/0.0.6/agents/documenter.md +18 -0
- package/.versions/0.0.6/agents/orchestrator.md +54 -0
- package/.versions/0.0.6/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.6/agents/planner.md +69 -0
- package/.versions/0.0.6/agents/releaser.md +24 -0
- package/.versions/0.0.6/agents/researcher.md +28 -0
- package/.versions/0.0.6/agents/security-auditor.md +166 -0
- package/.versions/0.0.6/agents/test-engineer.md +151 -0
- package/.versions/0.0.6/agents/web-debugger.md +42 -0
- package/.versions/0.0.6/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.6/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.6/docs/ARCHITECTURE.md +210 -0
- package/.versions/0.0.6/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.6/docs/claude-code-coms-bridge.md +103 -0
- package/.versions/0.0.6/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.6/docs/coms-hermes-bridge.md +179 -0
- package/.versions/0.0.6/docs/getting-started.md +183 -0
- package/.versions/0.0.6/docs/npm-install.md +337 -0
- package/.versions/0.0.6/docs/opencode-setup.md +249 -0
- package/.versions/0.0.6/docs/pi-extensions.md +293 -0
- package/.versions/0.0.6/docs/pi-setup.md +476 -0
- package/.versions/0.0.6/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.6/hermes/README.md +231 -0
- package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.6/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.6/hooks/coms-stop-hook.mjs +73 -0
- package/.versions/0.0.6/hooks/hooks.json +14 -0
- package/.versions/0.0.6/hooks/session-start.sh +74 -0
- package/.versions/0.0.6/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.6/justfile +245 -0
- package/.versions/0.0.6/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.6/references/definition-of-done.md +67 -0
- package/.versions/0.0.6/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.6/references/observability-checklist.md +91 -0
- package/.versions/0.0.6/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.6/references/performance-checklist.md +153 -0
- package/.versions/0.0.6/references/prompting-patterns.md +380 -0
- package/.versions/0.0.6/references/security-checklist.md +179 -0
- package/.versions/0.0.6/references/testing-patterns.md +236 -0
- package/.versions/0.0.6/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.6/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.6/scripts/coms-claude-bridge.ts +286 -0
- package/.versions/0.0.6/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.6/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.6/scripts/fleet.ts +141 -0
- package/.versions/0.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.6/scripts/hermes-monitor-scenario.ts +7 -0
- package/.versions/0.0.6/scripts/lib/claude-bridge-core.ts +100 -0
- package/.versions/0.0.6/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.6/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.6/scripts/lib/coms-envelope.ts +539 -0
- package/.versions/0.0.6/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.6/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.6/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.6/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.6/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.6/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.6/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.6/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.6/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.6/scripts/team-up.ts +351 -0
- package/.versions/0.0.6/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.6/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.6/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.6/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.6/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.6/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +544 -0
- package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +35 -0
- package/.versions/0.0.6/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.6/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.6/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.6/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.6/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.6/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.6/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.6/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.6/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.6/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.6/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.6/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.6/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.6/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/.versions/0.0.7/.claude/commands/build.md +44 -0
- package/.versions/0.0.7/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.7/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.7/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.7/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.7/.claude/commands/plan.md +16 -0
- package/.versions/0.0.7/.claude/commands/prime.md +22 -0
- package/.versions/0.0.7/.claude/commands/review.md +16 -0
- package/.versions/0.0.7/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.7/.claude/commands/ship.md +72 -0
- package/.versions/0.0.7/.claude/commands/spec.md +15 -0
- package/.versions/0.0.7/.claude/commands/test.md +19 -0
- package/.versions/0.0.7/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.7/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.7/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.7/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.7/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.7/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.7/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.7/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.7/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.7/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.7/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.7/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.7/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.7/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.7/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.7/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.7/.pi/extensions/package.json +9 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/README.md +857 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/helpers.ts +248 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/index.ts +8609 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/run-budget.js +181 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.7/.pi/harnesses/coms/README.md +93 -0
- package/.versions/0.0.7/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/0.0.7/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/0.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.7/.pi/harnesses/lib/herdr-client.ts +463 -0
- package/.versions/0.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.7/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.7/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.7/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.7/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.7/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.7/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.7/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.7/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.7/.version +1 -0
- package/.versions/0.0.7/agents/architect.md +23 -0
- package/.versions/0.0.7/agents/bowser.md +26 -0
- package/.versions/0.0.7/agents/builder.md +53 -0
- package/.versions/0.0.7/agents/code-reviewer.md +205 -0
- package/.versions/0.0.7/agents/deep-researcher.md +31 -0
- package/.versions/0.0.7/agents/documenter.md +18 -0
- package/.versions/0.0.7/agents/orchestrator.md +65 -0
- package/.versions/0.0.7/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.7/agents/planner.md +69 -0
- package/.versions/0.0.7/agents/releaser.md +24 -0
- package/.versions/0.0.7/agents/researcher.md +28 -0
- package/.versions/0.0.7/agents/security-auditor.md +166 -0
- package/.versions/0.0.7/agents/test-engineer.md +151 -0
- package/.versions/0.0.7/agents/web-debugger.md +42 -0
- package/.versions/0.0.7/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.7/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.7/docs/ARCHITECTURE.md +262 -0
- package/.versions/0.0.7/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.7/docs/claude-code-coms-bridge.md +109 -0
- package/.versions/0.0.7/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.7/docs/coms-hermes-bridge.md +189 -0
- package/.versions/0.0.7/docs/getting-started.md +231 -0
- package/.versions/0.0.7/docs/npm-install.md +337 -0
- package/.versions/0.0.7/docs/opencode-setup.md +249 -0
- package/.versions/0.0.7/docs/pi-extensions.md +293 -0
- package/.versions/0.0.7/docs/pi-setup.md +476 -0
- package/.versions/0.0.7/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.7/hermes/README.md +347 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.7/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/0.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.7/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/0.0.7/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/0.0.7/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.7/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/0.0.7/hooks/hooks.json +14 -0
- package/.versions/0.0.7/hooks/session-start.sh +74 -0
- package/.versions/0.0.7/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.7/justfile +245 -0
- package/.versions/0.0.7/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.7/references/definition-of-done.md +67 -0
- package/.versions/0.0.7/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.7/references/observability-checklist.md +91 -0
- package/.versions/0.0.7/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.7/references/performance-checklist.md +153 -0
- package/.versions/0.0.7/references/prompting-patterns.md +380 -0
- package/.versions/0.0.7/references/security-checklist.md +179 -0
- package/.versions/0.0.7/references/testing-patterns.md +236 -0
- package/.versions/0.0.7/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.7/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.7/scripts/coms-claude-bridge.ts +401 -0
- package/.versions/0.0.7/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.7/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.7/scripts/fleet.ts +149 -0
- package/.versions/0.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.7/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/0.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/0.0.7/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/0.0.7/scripts/lib/claude-bridge-core.ts +165 -0
- package/.versions/0.0.7/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.7/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.7/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/0.0.7/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.7/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.7/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.7/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.7/scripts/lib/monitor-env.ts +120 -0
- package/.versions/0.0.7/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.7/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.7/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.7/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.7/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.7/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.7/scripts/team-up.ts +360 -0
- package/.versions/0.0.7/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.7/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.7/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.7/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.7/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.7/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +544 -0
- package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +35 -0
- package/.versions/0.0.7/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.7/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.7/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.7/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.7/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.7/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.7/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.7/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.7/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.7/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.7/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.7/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.7/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.7/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +140 -0
- package/README.md +198 -40
- package/agents/code-reviewer.md +2 -2
- package/agents/documenter.md +1 -1
- package/agents/orchestrator.md +11 -0
- package/agents/plan-reviewer.md +1 -1
- package/agents/planner.md +1 -1
- package/agents/releaser.md +1 -1
- package/agents/security-auditor.md +1 -1
- package/bin/cli.js +60 -21
- package/bin/lib/bootstrap.js +16 -16
- package/bin/lib/doctor.js +1 -1
- package/bin/lib/hermes-profile-artifact.js +144 -0
- package/bin/lib/set-hermes-watchdog.js +173 -0
- package/bin/set-hermes-watchdog.js +26 -0
- package/docs/ARCHITECTURE.md +67 -15
- package/docs/agent-fleet-setup.md +13 -13
- package/docs/claude-code-coms-bridge.md +7 -1
- package/docs/coms-hermes-bridge.md +18 -8
- package/docs/getting-started.md +48 -0
- package/docs/hermes-watchdog-supervisor.md +140 -0
- package/docs/npm-install.md +21 -21
- package/docs/pi-extensions.md +7 -7
- package/docs/pi-setup.md +51 -47
- package/hermes/README.md +135 -19
- package/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -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-herdr/dashboard/activity.py +770 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -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.py +50 -0
- package/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/hooks/coms-stop-hook.mjs +12 -1
- package/package.json +11 -2
- package/references/fleet-coordination-patterns.md +2 -2
- package/scripts/coms-claude-bridge.ts +154 -39
- package/scripts/fleet.ts +9 -1
- package/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/scripts/lib/claude-bridge-core.ts +65 -0
- package/scripts/lib/coms-envelope.ts +44 -1
- package/scripts/lib/hermes-monitor-events.ts +1 -0
- package/scripts/lib/monitor-env.ts +120 -0
- package/scripts/team-snapshot.ts +1 -1
- package/scripts/team-up.ts +10 -1
- package/skills/browser-testing-with-devtools/SKILL.md +1 -1
- package/skills/compound-learning/SKILL.md +3 -3
- package/skills/guided-workspace-setup/SKILL.md +16 -14
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
- /package/.pi/prompts/{build.md → af-build.md} +0 -0
- /package/.pi/prompts/{code-simplify.md → af-code-simplify.md} +0 -0
- /package/.pi/prompts/{plan.md → af-plan.md} +0 -0
- /package/.pi/prompts/{review.md → af-review.md} +0 -0
- /package/.pi/prompts/{set-hermes-telegram.md → af-set-hermes-telegram.md} +0 -0
- /package/.pi/prompts/{ship.md → af-ship.md} +0 -0
- /package/.pi/prompts/{spec.md → af-spec.md} +0 -0
- /package/.pi/prompts/{test.md → af-test.md} +0 -0
|
@@ -7,6 +7,71 @@
|
|
|
7
7
|
|
|
8
8
|
export const SENTINEL_PREFIX = "<<COMS_DONE:";
|
|
9
9
|
|
|
10
|
+
// ── reply-timeout and idle-wait policy ──
|
|
11
|
+
//
|
|
12
|
+
// Two field failures live here. First, the bridge only ever read its own
|
|
13
|
+
// --reply-timeout: a caller that asked for 1_800_000ms was still told "no reply
|
|
14
|
+
// within 600000ms", so a review that honestly takes more than ten minutes could
|
|
15
|
+
// not succeed at all. Second, a pane that was mid-turn threw instantly, which
|
|
16
|
+
// turned every busy moment into a hard error — ten of eighteen coms_await calls
|
|
17
|
+
// in one session died that way, the caller hot-retried every few seconds, and
|
|
18
|
+
// then fell back to reading the pane 127 times to watch progress by hand.
|
|
19
|
+
|
|
20
|
+
/** No caller may hold a pane hostage indefinitely. */
|
|
21
|
+
export const REPLY_TIMEOUT_HARD_CAP_MS = 3_600_000;
|
|
22
|
+
|
|
23
|
+
/** Backoff while waiting for a busy pane, in ms; the last step repeats. */
|
|
24
|
+
export const IDLE_WAIT_BACKOFF_MS = [2_000, 4_000, 8_000, 15_000, 30_000];
|
|
25
|
+
|
|
26
|
+
/** Longest we will ever wait for a pane to go idle before giving up. */
|
|
27
|
+
export const IDLE_WAIT_CAP_MS = 120_000;
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* The caller's own deadline wins — it knows how long the work takes — falling
|
|
31
|
+
* back to the bridge's configured timeout and always clamped to the hard cap.
|
|
32
|
+
*/
|
|
33
|
+
export function resolveReplyTimeoutMs(requested: unknown, fallbackMs: number, capMs = REPLY_TIMEOUT_HARD_CAP_MS): number {
|
|
34
|
+
const asked = Number(requested);
|
|
35
|
+
const base = Number.isFinite(asked) && asked > 0 ? asked : fallbackMs;
|
|
36
|
+
return Math.max(1, Math.min(base, capMs));
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
/** One absolute deadline shared by idle waiting and reply collection. */
|
|
40
|
+
export function replyDeadlineAt(startedAtMs: number, timeoutMs: number): number {
|
|
41
|
+
return Number(startedAtMs) + Math.max(0, Number(timeoutMs) || 0);
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* The pane accepted the prompt but did not finish inside the caller's budget.
|
|
46
|
+
* This is deliberately not a response error: the work may still complete.
|
|
47
|
+
*/
|
|
48
|
+
export class ReplyPendingError extends Error {
|
|
49
|
+
readonly pending = true;
|
|
50
|
+
constructor(message: string) {
|
|
51
|
+
super(message);
|
|
52
|
+
this.name = "ReplyPendingError";
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
export function isReplyPendingError(error: unknown): error is ReplyPendingError {
|
|
57
|
+
return error instanceof ReplyPendingError || Boolean((error as { pending?: unknown } | null)?.pending);
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/** Backoff delay for the nth idle-wait attempt (0-based); the last step repeats. */
|
|
61
|
+
export function idleWaitDelayMs(attempt: number): number {
|
|
62
|
+
const i = Math.max(0, Math.min(Math.floor(attempt), IDLE_WAIT_BACKOFF_MS.length - 1));
|
|
63
|
+
return IDLE_WAIT_BACKOFF_MS[i];
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/**
|
|
67
|
+
* How long to wait for a busy pane. Never more than half the caller's reply
|
|
68
|
+
* budget — waiting to start must not consume the time meant for the answer.
|
|
69
|
+
*/
|
|
70
|
+
export function idleWaitBudgetMs(replyTimeoutMs: number, capMs = IDLE_WAIT_CAP_MS): number {
|
|
71
|
+
const half = Math.floor((Number(replyTimeoutMs) || 0) / 2);
|
|
72
|
+
return Math.max(0, Math.min(capMs, half));
|
|
73
|
+
}
|
|
74
|
+
|
|
10
75
|
export function completionSentinel(msgId: string): string {
|
|
11
76
|
return `${SENTINEL_PREFIX}${msgId}>>`;
|
|
12
77
|
}
|
|
@@ -63,6 +63,12 @@ export interface PromptEnvelope {
|
|
|
63
63
|
sender_cwd: string;
|
|
64
64
|
conversation_id?: string | null;
|
|
65
65
|
response_schema?: object | null;
|
|
66
|
+
/**
|
|
67
|
+
* How long the sender is prepared to wait, in ms. A receiver that drives an
|
|
68
|
+
* interactive agent uses this instead of its own default — otherwise a caller
|
|
69
|
+
* asking for 30 minutes is still failed at the bridge's 10-minute default.
|
|
70
|
+
*/
|
|
71
|
+
reply_timeout_ms?: number | null;
|
|
66
72
|
}
|
|
67
73
|
|
|
68
74
|
export interface ResponseEnvelope {
|
|
@@ -85,6 +91,38 @@ export interface CancelEnvelope {
|
|
|
85
91
|
ref_msg_id: string;
|
|
86
92
|
}
|
|
87
93
|
|
|
94
|
+
/**
|
|
95
|
+
* How addressable a peer is right now.
|
|
96
|
+
* idle — will pick up a `coms_send` immediately
|
|
97
|
+
* working — mid-turn (or blocked on its own permission prompt); a send waits
|
|
98
|
+
* booting — registered, but nothing has reported a live state yet
|
|
99
|
+
*
|
|
100
|
+
* Published so a sender can check before sending instead of screen-scraping the
|
|
101
|
+
* pane: the session behind this change issued 127 `herdr_read_pane` calls
|
|
102
|
+
* substituting for this one missing field.
|
|
103
|
+
*/
|
|
104
|
+
export type PeerStatus = "idle" | "working" | "booting";
|
|
105
|
+
|
|
106
|
+
const PANE_STATUS_WORKING = new Set(["working", "blocked"]);
|
|
107
|
+
const PANE_STATUS_IDLE = new Set(["idle", "done", "ready"]);
|
|
108
|
+
|
|
109
|
+
/**
|
|
110
|
+
* Map a herdr pane's `agent_status` onto a peer status. Anything unrecognised —
|
|
111
|
+
* including the "unknown" herdr reports for a pane whose agent has not checked
|
|
112
|
+
* in — is `booting`: not addressable yet, but not a failure either.
|
|
113
|
+
*/
|
|
114
|
+
export function paneAgentStatusToPeerStatus(agentStatus: string | null | undefined): PeerStatus {
|
|
115
|
+
const s = String(agentStatus ?? "").trim().toLowerCase();
|
|
116
|
+
if (PANE_STATUS_WORKING.has(s)) return "working";
|
|
117
|
+
if (PANE_STATUS_IDLE.has(s)) return "idle";
|
|
118
|
+
return "booting";
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
/** Display form; a peer that never answered the ping has no status of its own. */
|
|
122
|
+
export function peerStatusLabel(status: PeerStatus | null | undefined): string {
|
|
123
|
+
return status ?? "unreachable";
|
|
124
|
+
}
|
|
125
|
+
|
|
88
126
|
export interface AgentCard {
|
|
89
127
|
name: string;
|
|
90
128
|
purpose: string;
|
|
@@ -92,6 +130,10 @@ export interface AgentCard {
|
|
|
92
130
|
color: string;
|
|
93
131
|
context_used_pct: number;
|
|
94
132
|
queue_depth: number;
|
|
133
|
+
/** herdr pane hosting this peer, when it runs in one. */
|
|
134
|
+
pane_id?: string | null;
|
|
135
|
+
/** Addressability right now — see PeerStatus. Absent on pre-status peers. */
|
|
136
|
+
status?: PeerStatus;
|
|
95
137
|
}
|
|
96
138
|
|
|
97
139
|
export interface RegistryEntry {
|
|
@@ -161,7 +203,7 @@ export interface SenderIdentity {
|
|
|
161
203
|
export function makePromptEnvelope(
|
|
162
204
|
from: SenderIdentity,
|
|
163
205
|
prompt: string,
|
|
164
|
-
opts: { hops?: number; response_schema?: object | null } = {},
|
|
206
|
+
opts: { hops?: number; response_schema?: object | null; reply_timeout_ms?: number | null } = {},
|
|
165
207
|
): PromptEnvelope {
|
|
166
208
|
return {
|
|
167
209
|
type: "prompt",
|
|
@@ -175,6 +217,7 @@ export function makePromptEnvelope(
|
|
|
175
217
|
sender_cwd: from.cwd,
|
|
176
218
|
conversation_id: null,
|
|
177
219
|
response_schema: opts.response_schema ?? null,
|
|
220
|
+
reply_timeout_ms: opts.reply_timeout_ms ?? null,
|
|
178
221
|
};
|
|
179
222
|
}
|
|
180
223
|
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export * from "../../.pi/harnesses/lib/hermes-monitor-events.ts";
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The two variables that decide whether a hub is monitored at all.
|
|
3
|
+
*
|
|
4
|
+
* `monitorLifecycleConfig()` (.pi/harnesses/agent-hub/monitor-lifecycle.ts)
|
|
5
|
+
* returns `null` unless BOTH `AGENT_FLEET_PROFILE_ID` and an absolute
|
|
6
|
+
* `AGENT_FLEET_MONITOR_RUNTIME_DIR` are in the hub's environment. Until this
|
|
7
|
+
* module existed the only thing that set them was a manual `export` copied out
|
|
8
|
+
* of hermes/README.md, so in practice the monitor never started and its whole
|
|
9
|
+
* transport — task tree, live output, per-generation cancel — was dead code
|
|
10
|
+
* with a test suite.
|
|
11
|
+
*
|
|
12
|
+
* Two rules the rest of the file exists to hold:
|
|
13
|
+
*
|
|
14
|
+
* 1. An operator who already exported the variables wins. This never
|
|
15
|
+
* overwrites a value that is already set, so the README recipe and a
|
|
16
|
+
* systemd unit keep working exactly as documented.
|
|
17
|
+
* 2. A runtime directory we cannot make private is not used. The Python
|
|
18
|
+
* reader refuses any root that is not mode 0700 (adapter.py), and it is
|
|
19
|
+
* right to: the directory holds one bearer token per live hub. Rather
|
|
20
|
+
* than hand it a path it will reject, `resolveMonitorEnv` returns null
|
|
21
|
+
* and the hub runs unmonitored — the pre-existing behaviour, reached
|
|
22
|
+
* honestly.
|
|
23
|
+
*/
|
|
24
|
+
|
|
25
|
+
import * as fs from "node:fs";
|
|
26
|
+
import * as os from "node:os";
|
|
27
|
+
import * as path from "node:path";
|
|
28
|
+
|
|
29
|
+
/** Mirrors the profile-ID class in monitor-lifecycle.ts and adapter.py. All
|
|
30
|
+
* three must agree, because the runtime namespace is `sha256(profileId)` and a
|
|
31
|
+
* value one end accepts and another rejects is an empty directory listing with
|
|
32
|
+
* no error anywhere. */
|
|
33
|
+
export const PROFILE_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
|
|
34
|
+
|
|
35
|
+
/** The Hermes profile the fleet plugins are installed in. `dev` rather than
|
|
36
|
+
* `default` by the 2026-07-27 decision recorded in the observability plan —
|
|
37
|
+
* the panel is a dev-profile tool, and the monitor has to land in the same
|
|
38
|
+
* profile or the discovery glob looks in the wrong namespace. */
|
|
39
|
+
export const DEFAULT_PROFILE_ID = "dev";
|
|
40
|
+
|
|
41
|
+
export const RUNTIME_DIR_NAME = "agent-fleet-monitor";
|
|
42
|
+
|
|
43
|
+
export interface MonitorEnv {
|
|
44
|
+
AGENT_FLEET_PROFILE_ID: string;
|
|
45
|
+
AGENT_FLEET_MONITOR_RUNTIME_DIR: string;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/** Where the runtime root goes, before anything is created.
|
|
49
|
+
*
|
|
50
|
+
* `XDG_RUNTIME_DIR` is the right answer and the one the README documents: it
|
|
51
|
+
* is already per-user, already 0700, and already cleaned up at logout. The
|
|
52
|
+
* tmpdir fallback exists for the sessions that have no such variable (a bare
|
|
53
|
+
* ssh login, a container), and carries the uid in its name so two users on one
|
|
54
|
+
* machine never race for the same path. */
|
|
55
|
+
export function monitorRuntimeRoot(env: NodeJS.ProcessEnv = process.env): string {
|
|
56
|
+
const xdg = env.XDG_RUNTIME_DIR;
|
|
57
|
+
if (xdg && path.isAbsolute(xdg)) return path.join(xdg, RUNTIME_DIR_NAME);
|
|
58
|
+
const uid = typeof process.getuid === "function" ? process.getuid() : 0;
|
|
59
|
+
|
|
60
|
+
return path.join(os.tmpdir(), `${RUNTIME_DIR_NAME}-${uid}`);
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/** Create the runtime root 0700, or say why it cannot be trusted.
|
|
64
|
+
*
|
|
65
|
+
* The mode is re-asserted on a directory that already exists because the
|
|
66
|
+
* `mode` argument to mkdir is a no-op for an existing path and is masked by
|
|
67
|
+
* umask for a new one — checking after the fact is the only way to know. A
|
|
68
|
+
* symlink is refused outright rather than followed: the whole point of the
|
|
69
|
+
* directory is that its contents are only reachable by this user, and a
|
|
70
|
+
* symlink means somebody else chose the destination. */
|
|
71
|
+
export function ensureMonitorRuntimeDir(dir: string, io: {
|
|
72
|
+
mkdirSync?: typeof fs.mkdirSync;
|
|
73
|
+
lstatSync?: typeof fs.lstatSync;
|
|
74
|
+
chmodSync?: typeof fs.chmodSync;
|
|
75
|
+
} = {}): string | null {
|
|
76
|
+
const mkdir = io.mkdirSync ?? fs.mkdirSync;
|
|
77
|
+
const lstat = io.lstatSync ?? fs.lstatSync;
|
|
78
|
+
const chmod = io.chmodSync ?? fs.chmodSync;
|
|
79
|
+
if (!path.isAbsolute(dir)) return null;
|
|
80
|
+
try {
|
|
81
|
+
mkdir(dir, { recursive: true, mode: 0o700 });
|
|
82
|
+
const stat = lstat(dir);
|
|
83
|
+
if (stat.isSymbolicLink() || !stat.isDirectory()) return null;
|
|
84
|
+
if ((stat.mode & 0o777) !== 0o700) {
|
|
85
|
+
chmod(dir, 0o700);
|
|
86
|
+
if ((lstat(dir).mode & 0o777) !== 0o700) return null;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
return dir;
|
|
90
|
+
} catch {
|
|
91
|
+
return null;
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/** The variables to add to a hub's environment, or null to leave it unmonitored.
|
|
96
|
+
*
|
|
97
|
+
* Null is a normal outcome, not a failure: `AGENT_FLEET_MONITOR=0` is the
|
|
98
|
+
* documented opt-out, and an unusable runtime directory reaches the same
|
|
99
|
+
* result. Callers merge the answer and carry on either way — a hub that
|
|
100
|
+
* cannot be monitored still orchestrates. */
|
|
101
|
+
export function resolveMonitorEnv(
|
|
102
|
+
env: NodeJS.ProcessEnv = process.env,
|
|
103
|
+
ensure: (dir: string) => string | null = ensureMonitorRuntimeDir,
|
|
104
|
+
): MonitorEnv | null {
|
|
105
|
+
if (env.AGENT_FLEET_MONITOR === "0") return null;
|
|
106
|
+
|
|
107
|
+
const profileId = env.AGENT_FLEET_PROFILE_ID?.trim() || DEFAULT_PROFILE_ID;
|
|
108
|
+
if (!PROFILE_ID_RE.test(profileId) || profileId.includes("..")) return null;
|
|
109
|
+
|
|
110
|
+
const requested = env.AGENT_FLEET_MONITOR_RUNTIME_DIR?.trim();
|
|
111
|
+
// An explicit path is honoured as given — including a rejection, which is
|
|
112
|
+
// louder than silently relocating somebody's deliberate choice.
|
|
113
|
+
const root = requested ? (path.isAbsolute(requested) ? requested : null) : monitorRuntimeRoot(env);
|
|
114
|
+
if (!root) return null;
|
|
115
|
+
|
|
116
|
+
const runtimeDir = ensure(root);
|
|
117
|
+
if (!runtimeDir) return null;
|
|
118
|
+
|
|
119
|
+
return { AGENT_FLEET_PROFILE_ID: profileId, AGENT_FLEET_MONITOR_RUNTIME_DIR: runtimeDir };
|
|
120
|
+
}
|
package/scripts/team-snapshot.ts
CHANGED
|
@@ -93,7 +93,7 @@ async function captureSnapshot(client: Client, team: string, project = DEFAULT_P
|
|
|
93
93
|
if (!fs.existsSync(PEERS_YAML)) die(`peers.yaml not found at ${PEERS_YAML}`);
|
|
94
94
|
const teams = parsePeersYaml(fs.readFileSync(PEERS_YAML, "utf-8"));
|
|
95
95
|
const peers = teams[team];
|
|
96
|
-
if (!peers
|
|
96
|
+
if (!peers) die(`Team "${team}" not found in peers.yaml.`);
|
|
97
97
|
|
|
98
98
|
const { panes } = await client.herdr.paneList({ workspace_id: ws.workspace_id });
|
|
99
99
|
const { agents } = await client.herdr.agentList();
|
package/scripts/team-up.ts
CHANGED
|
@@ -34,6 +34,7 @@ import {
|
|
|
34
34
|
type LayoutNode,
|
|
35
35
|
type Peer,
|
|
36
36
|
} from "./lib/herdr-layout.ts";
|
|
37
|
+
import { resolveMonitorEnv } from "./lib/monitor-env.ts";
|
|
37
38
|
import { planSpawnDelays } from "./lib/spawn-stagger.ts";
|
|
38
39
|
import {
|
|
39
40
|
DEFAULT_PROJECT,
|
|
@@ -249,14 +250,22 @@ async function main(): Promise<void> {
|
|
|
249
250
|
} catch (err) {
|
|
250
251
|
die(err instanceof Error ? err.message : String(err));
|
|
251
252
|
}
|
|
253
|
+
// The hub pane is spawned BY herdr, whose daemon was started at some other
|
|
254
|
+
// time from some other shell — so unlike `just fleet hub`, it inherits
|
|
255
|
+
// nothing from this process. The monitor variables have to travel as pane
|
|
256
|
+
// env or the one launcher most likely to want a task tree is the one that
|
|
257
|
+
// never gets one. Peers deliberately do not receive them: only agent-hub
|
|
258
|
+
// reads them, and a peer is not a hub.
|
|
259
|
+
const monitorEnv = dryRun ? null : resolveMonitorEnv();
|
|
252
260
|
const rootPane = hub
|
|
253
261
|
? {
|
|
254
262
|
command: hubCommand(project, { browser: hubBrowser, allExtensions: hubAllExtensions }),
|
|
255
263
|
label: "hub",
|
|
256
264
|
ratio: HUB_RATIO,
|
|
265
|
+
...(monitorEnv ? { env: monitorEnv } : {}),
|
|
257
266
|
}
|
|
258
267
|
: spec
|
|
259
|
-
? { command: spec.command, label: spec.paneLabel, ratio: spec.ratio, cwd: spec.cwd, env: spec.env }
|
|
268
|
+
? { command: spec.command, label: spec.paneLabel, ratio: spec.ratio, cwd: spec.cwd, env: { ...spec.env, ...(monitorEnv ?? {}) } }
|
|
260
269
|
: undefined;
|
|
261
270
|
|
|
262
271
|
if (dryRun) {
|
|
@@ -75,7 +75,7 @@ ln -s /path/to/agent-fleet/.pi/extensions/mcp-bridge .pi/extensions/mcp
|
|
|
75
75
|
ln -s /path/to/agent-fleet/.pi/extensions/chrome-devtools-mcp .pi/extensions/chrome-devtools-mcp
|
|
76
76
|
```
|
|
77
77
|
|
|
78
|
-
After install, run `/
|
|
78
|
+
After install, run `/af-chrome-devtools-status` inside pi to confirm the bridge connected.
|
|
79
79
|
|
|
80
80
|
### Available Tools
|
|
81
81
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: compound-learning
|
|
3
|
-
description: Captures a finished session's lessons into the project's own rules and docs — extracts candidate lessons from session evidence, dedupes them against the existing rule tree, and lands them as minimal diffs on existing files. Use when a session ends with user corrections, recurring review findings, or debugging root causes worth keeping, when the user says "compound" or "capture the lessons", or as the documenter's process for a /compound dispatch.
|
|
3
|
+
description: Captures a finished session's lessons into the project's own rules and docs — extracts candidate lessons from session evidence, dedupes them against the existing rule tree, and lands them as minimal diffs on existing files. Use when a session ends with user corrections, recurring review findings, or debugging root causes worth keeping, when the user says "compound" or "capture the lessons", or as the documenter's process for a /compound or /af-compound dispatch.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Compound Learning
|
|
@@ -16,7 +16,7 @@ The enemy is not missing lessons — it is **bloat**. A rule tree that grows by
|
|
|
16
16
|
## When to Use
|
|
17
17
|
|
|
18
18
|
- A session is wrapping up and it contained at least one correction, recurring finding, or hard-won discovery.
|
|
19
|
-
- The user says "compound", "capture the lessons", "update the rules from this session", or runs a `/compound` command.
|
|
19
|
+
- The user says "compound", "capture the lessons", "update the rules from this session", or runs a `/compound` or `/af-compound` command.
|
|
20
20
|
- You are the `documenter` persona dispatched with a compound task by the agent-hub dispatcher.
|
|
21
21
|
- Periodically, as a **consolidation pass** over a rule tree that has accumulated additions (see Step 8).
|
|
22
22
|
|
|
@@ -32,7 +32,7 @@ The enemy is not missing lessons — it is **bloat**. A rule tree that grows by
|
|
|
32
32
|
| Session diff | `git diff` / `git log` for the session's commits |
|
|
33
33
|
| agent-hub artifacts | `.pi/agent-sessions/artifacts/{returns,reviews,plans,inventories,evidence}/` — specialist returns and review findings |
|
|
34
34
|
| agent-hub assertion ledger | `.pi/agent-sessions/assertions.json` — which assertions failed first and why |
|
|
35
|
-
| Dispatch brief | A `/compound` dispatch carries a candidate-lessons brief composed by the dispatcher — treat it as *candidates*, not conclusions |
|
|
35
|
+
| Dispatch brief | A `/compound` or `/af-compound` dispatch carries a candidate-lessons brief composed by the dispatcher — treat it as *candidates*, not conclusions |
|
|
36
36
|
|
|
37
37
|
**Targets** — from `.ai/agent-fleet-overrides.md`, section `## agent-hub` (legacy `## agent-team`):
|
|
38
38
|
|
|
@@ -67,7 +67,7 @@ Target map, relative to the workspace root:
|
|
|
67
67
|
|---|---|---|---|
|
|
68
68
|
| Skills | `.claude/skills/<name>/` | per `docs/opencode-setup.md` | `.pi/skills/<name>/` |
|
|
69
69
|
| Personas | `.claude/agents/<name>.md` *(generated)* | `.opencode/agent/<name>.md` *(generated)* | `agents/<name>.md` |
|
|
70
|
-
| Commands / prompts | `.claude/commands/<name>.md` | `.opencode/commands/af-<name>.md` | `.pi/prompts
|
|
70
|
+
| Commands / prompts | `.claude/commands/<name>.md` | `.opencode/commands/af-<name>.md` | `.pi/prompts/af-<name>.md` |
|
|
71
71
|
| `/orchestrate` team config *(companion of the `orchestrate` command)* | `.claude/orchestrate-teams.yaml` | `.opencode/orchestrate-teams.yaml` | — |
|
|
72
72
|
| References | `.claude/references/<name>.md` | per `docs/opencode-setup.md` | per `docs/pi-setup.md` |
|
|
73
73
|
| Hooks *(claude-code only)* | `.claude/hooks/<name>`, registered in `.claude/settings.json` | — | — |
|
|
@@ -134,7 +134,7 @@ Present the findings per the Step 1 interaction contract. **Widget mode:** print
|
|
|
134
134
|
|
|
135
135
|
Either way, apply only the picked fixes; record skipped items so the install menu can surface them again. Append a `## doctor-runs` line to `.ai/agent-fleet-setup.md` with the date, agent, phase (`preflight`), and `repaired` / `deleted` / `skipped` counts.
|
|
136
136
|
|
|
137
|
-
The doctor scan is also exposed standalone as `/doctor-agent-fleet` — running it outside a setup pass is this same scan-and-repair flow without the rest of the install menu.
|
|
137
|
+
The doctor scan is also exposed standalone as `/doctor-agent-fleet` on Claude Code or `/af-doctor-agent-fleet` on Pi/OpenCode — running it outside a setup pass is this same scan-and-repair flow without the rest of the install menu.
|
|
138
138
|
|
|
139
139
|
### 5b. Bootstrap `pi-ask-user` first (pi only)
|
|
140
140
|
|
|
@@ -150,7 +150,7 @@ From the Step 4 analysis, determine whether `pi-ask-user` is already available:
|
|
|
150
150
|
2. Ask for confirmation (this is the one pre-Step-9 write, per the gating exception). If declined, fall back to the tabular mode and continue to Step 6 in this same pass — do **not** force the install.
|
|
151
151
|
3. On confirm, run `pi install -l npm:pi-ask-user` (project-scoped). Mention `pi install npm:pi-ask-user` only if the user explicitly wants a global pin.
|
|
152
152
|
4. Record the package under the `external-pi-packages` / `project-packages` line in `.ai/agent-fleet-setup.md` (same convention as Step 6's external-package handling) — do not copy files from `node_modules`.
|
|
153
|
-
5. **Stop the pass here.** Print: *"`pi-ask-user` installed. Reload pi (restart the session or `/reload`), then re-run `/setup-agent-fleet` — the menu will then use native multi-select. Nothing else has been written to your workspace."* Do not continue to Step 6 on this pass: the tool only becomes callable after the reload.
|
|
153
|
+
5. **Stop the pass here.** Print: *"`pi-ask-user` installed. Reload pi (restart the session or `/reload`), then re-run `/af-setup-agent-fleet` — the menu will then use native multi-select. Nothing else has been written to your workspace."* Do not continue to Step 6 on this pass: the tool only becomes callable after the reload.
|
|
154
154
|
|
|
155
155
|
On the **re-run**, Step 4 finds `pi-ask-user` installed, this step is a no-op, and Step 6 runs on native `ask_user` screens. In Step 6's External-pi-packages group, the already-installed `pi-ask-user` simply counts toward `Keep as-is` (`installed · project package`) — the bootstrap is not repeated. Do **not** bootstrap other external pi packages here; optional suggestions such as `pi-codex-image-gen` are offered only in Group 7 and installed only when the user selects them.
|
|
156
156
|
|
|
@@ -201,13 +201,15 @@ Then ask a single-select with `displayMode: "inline"` (so the printed diff stays
|
|
|
201
201
|
|---|---|---|---|
|
|
202
202
|
| Skills | `skills/<name>/SKILL.md`, else `vendor/agent-skills-upstream/skills/<name>/SKILL.md` | `skills/<name>/SKILL.md`, else `vendor/agent-skills-upstream/skills/<name>/SKILL.md` | `skills/<name>/SKILL.md`, else `vendor/agent-skills-upstream/skills/<name>/SKILL.md` |
|
|
203
203
|
| Personas | `agents/<name>.md` | `agents/<name>.md` | `agents/<name>.md` |
|
|
204
|
-
| Commands / prompts | `.claude/commands/<name>.md` | `.opencode/commands/af-<name>.md` | `.pi/prompts
|
|
204
|
+
| Commands / prompts | `.claude/commands/<name>.md` | `.opencode/commands/af-<name>.md` | `.pi/prompts/af-<name>.md` |
|
|
205
205
|
| `/orchestrate` team config | `.claude/orchestrate-teams.yaml` | `.opencode/orchestrate-teams.yaml` | — |
|
|
206
206
|
| pi extensions / harnesses / runtime skills | — | — | `.pi/extensions/<name>/`, `.pi/harnesses/<name>/`, `.pi/skills/<name>/` |
|
|
207
207
|
| References | source files in `references/` (all agents) |
|
|
208
208
|
| Hooks | source files in `hooks/` | — | — |
|
|
209
209
|
|
|
210
|
-
If the per-agent source is missing, the row is **not shown** — never silently fall back to a different agent's tree (for example: do not symlink `.claude/commands/design-agent.md` from `.pi/prompts/design-agent.md` when the agent is `pi`). When the user explicitly asks for an item the source lacks for their agent, say so plainly and stop; the answer is to author the missing source file first, not to cross-link runtimes.
|
|
210
|
+
If the per-agent source is missing, the row is **not shown** — never silently fall back to a different agent's tree (for example: do not symlink `.claude/commands/design-agent.md` from `.pi/prompts/af-design-agent.md` when the agent is `pi`). When the user explicitly asks for an item the source lacks for their agent, say so plainly and stop; the answer is to author the missing source file first, not to cross-link runtimes.
|
|
211
|
+
|
|
212
|
+
**Pi `/af-*` migration.** Pi prompt templates formerly used unprefixed `.pi/prompts/<name>.md` targets. During status/apply, when a selected or recorded Agent Fleet command has that legacy target, migrate it to `.pi/prompts/af-<name>.md` and remove the old target only when it is recorded in `## install-status` and unchanged against the recorded-version snapshot, or is a symlink resolving into the Agent Fleet source. Preserve user-modified and unowned legacy files as conflicts/skips; never delete a same-named custom prompt merely to enforce the namespace. The bootstrap handles the same migration for its setup/doctor prompts before this skill runs.
|
|
211
213
|
|
|
212
214
|
Groups, in order. Groups 1–4 apply to every agent; groups 5–7 are shown **only when the agent is `pi`**.
|
|
213
215
|
|
|
@@ -218,7 +220,7 @@ Groups, in order. Groups 1–4 apply to every agent; groups 5–7 are shown **on
|
|
|
218
220
|
- *Review* — `code-review-and-quality` ★, `code-simplification`, `security-and-hardening`, `performance-optimization`
|
|
219
221
|
- *Ship* — `git-workflow-and-versioning` ★, `ci-cd-and-automation`, `deprecation-and-migration`, `documentation-and-adrs`, `shipping-and-launch`
|
|
220
222
|
- *Orchestrate* — `orchestration-verification` ★ *(the Verification Contract enforced by the `orchestrator` persona + agent-hub harness; also read by the `builder`/`test-engineer`/`code-reviewer` personas for their structured returns, so recommend it whenever any of those personas or the `orchestrate` command is selected)*
|
|
221
|
-
- *Learn* — `compound-learning` ★ *(the end-of-session compound pass — session lessons landed as deduped, capped diffs on the project's `rules:`/`docs:` targets; read by the `documenter` persona for `/compound` dispatches and by the `compound` command, so recommend it whenever either of those is selected)*
|
|
223
|
+
- *Learn* — `compound-learning` ★ *(the end-of-session compound pass — session lessons landed as deduped, capped diffs on the project's `rules:`/`docs:` targets; read by the `documenter` persona for `/compound` or `/af-compound` dispatches and by the `compound` command, so recommend it whenever either of those is selected)*
|
|
222
224
|
- *Meta* — `using-agent-skills` ★, `designing-agents` *(`guided-workspace-setup` is installer-only — never offered)*
|
|
223
225
|
|
|
224
226
|
**Internal skill companions.** `skills/_internal/grilling.md` is not a menu row and has no `SKILL.md`; it is a shared helper for `idea-refine`, `spec-driven-development`, and `planning-and-task-breakdown`. Whenever any of those three skills is installed, kept, refreshed, or removed, apply the helper as a sibling at `<skills-target>/_internal/grilling.md` using the same copy/symlink method, record it as a companion rather than a selected skill, and keep it while any installed parent skill still references it.
|
|
@@ -229,7 +231,7 @@ Groups, in order. Groups 1–4 apply to every agent; groups 5–7 are shown **on
|
|
|
229
231
|
- *pi-only* *(shown only when the agent is `pi`)* — `bowser`, `web-debugger`, `orchestrator`
|
|
230
232
|
|
|
231
233
|
For `claude-code`/`opencode`, installed rows are **generated artifacts** (see Step 3): record them with `transformed: true` in `## install-status`, and compute their status by comparing the installed file against `transform(current source)` — and for upgrades against `transform(.versions/<recorded>/agents/<name>.md)` — never against the raw canonical source, whose bytes legitimately differ from the generated output.
|
|
232
|
-
3. **Commands / prompts** *(single-type — no sub-category)* — mapped to the chosen agent; items without a per-agent source are filtered out, no cross-tool substitution. Full candidate list: `spec` ★, `plan` ★, `build` ★, `test` ★, `review` ★, `orchestrate` ★, `compound`, `code-simplify`, `ship`, `design-agent`, `prime`, `set-hermes-telegram`. The actual menu shows only items whose per-agent source file exists — for example, `.pi/prompts/design-agent.md` and `.pi/prompts/prime.md` are absent, so neither is offered when the agent is `pi`; and `orchestrate` has a source for `claude-code` (`.claude/commands/orchestrate.md`) and `opencode` (`.opencode/commands/af-orchestrate.md`) but **not** `pi` (no `.pi/prompts/orchestrate.md`), so the existing source-availability filter surfaces it for claude-code + opencode and hides it for pi automatically. `compound` follows the same pattern (`.claude/commands/compound.md` / `.opencode/commands/af-compound.md`, no pi prompt — the agent-hub harness ships its own `/compound` command); when `compound` is selected, recommend the `compound-learning` skill alongside it. *(`setup` and `doctor` are installer-only — never offered, since they live in the source agent-fleet repo and act on target workspaces from there.)*
|
|
234
|
+
3. **Commands / prompts** *(single-type — no sub-category)* — mapped to the chosen agent; items without a per-agent source are filtered out, no cross-tool substitution. Full candidate list: `spec` ★, `plan` ★, `build` ★, `test` ★, `review` ★, `orchestrate` ★, `compound`, `code-simplify`, `ship`, `design-agent`, `prime`, `set-hermes-telegram`. The actual menu shows only items whose per-agent source file exists — for example, `.pi/prompts/af-design-agent.md` and `.pi/prompts/af-prime.md` are absent, so neither is offered when the agent is `pi`; and `orchestrate` has a source for `claude-code` (`.claude/commands/orchestrate.md`) and `opencode` (`.opencode/commands/af-orchestrate.md`) but **not** `pi` (no `.pi/prompts/af-orchestrate.md`), so the existing source-availability filter surfaces it for claude-code + opencode and hides it for pi automatically. `compound` follows the same pattern (`.claude/commands/compound.md` / `.opencode/commands/af-compound.md`, no pi prompt — the agent-hub harness ships its own `/af-compound` command); when `compound` is selected, recommend the `compound-learning` skill alongside it. *(`setup` and `doctor` are installer-only — never offered, since they live in the source agent-fleet repo and act on target workspaces from there.)*
|
|
233
235
|
|
|
234
236
|
**`orchestrate` carries a team-config companion.** `orchestrate-teams.yaml` (the named-team roster the `/orchestrate` command reads) is not its own menu row — it is a companion of the `orchestrate` command (same idea as the pi harness `justfile` companion). Whenever `orchestrate` is installed/kept/removed, install/remove the agent's team config from source in the same pass — `.claude/orchestrate-teams.yaml` for claude-code, `.opencode/orchestrate-teams.yaml` for opencode. Treat it as a normal versioned artifact for the Step 6 status tokens: a user-edited copy is `mod`/`cflt` and gets the three-way-diff treatment, never a silent clobber of their team definitions. **Removal safety:** when `orchestrate` is removed, the team config is removed **only** if it still matches the shipped source (unedited); a user-edited `orchestrate-teams.yaml` is preserved and listed under "Skipped — user-modified" rather than deleted, so custom team definitions survive an uninstall.
|
|
235
237
|
4. **References & Hooks** *(sub-category = `reference` / `hook`)* — one group for the shared non-agent-specific artifacts:
|
|
@@ -356,7 +358,7 @@ Target paths are deterministic from the per-agent source map, so omit them from
|
|
|
356
358
|
|
|
357
359
|
**The confirm question.** Then confirm with **one single-select**, asked with `displayMode: "inline"` so the printed plan stays visible:
|
|
358
360
|
|
|
359
|
-
- `Apply — and remove the installer commands` *(the default; the installer files are `/setup-agent-fleet` and `/doctor-agent-fleet`
|
|
361
|
+
- `Apply — and remove the installer commands` *(the default; the installer files are `/setup-agent-fleet` and `/doctor-agent-fleet` on Claude Code, or the `/af-*` variants on Pi/OpenCode — plus the `guided-workspace-setup` skill body; they can be restored later with `npx @chankov/agent-fleet init`)*
|
|
360
362
|
- `Apply — keep the installer commands` *(records `keep-installer: true` in `## workspace-summary` and skips Step 10b)*
|
|
361
363
|
- `Adjust picks` *(the freeform reply names the group(s) to revisit; reopen only those quick screens, then re-print the plan and re-confirm)*
|
|
362
364
|
- `Cancel — write nothing`
|
|
@@ -395,7 +397,7 @@ Default behaviour:
|
|
|
395
397
|
| Agent | Files removed |
|
|
396
398
|
|---|---|
|
|
397
399
|
| `claude-code` | `.claude/commands/setup-agent-fleet.md`, `.claude/commands/doctor-agent-fleet.md`, `.claude/skills/guided-workspace-setup/SKILL.md` |
|
|
398
|
-
| `pi` | `.pi/prompts/setup-agent-fleet.md`, `.pi/prompts/doctor-agent-fleet.md`, `.pi/skills/guided-workspace-setup/SKILL.md` |
|
|
400
|
+
| `pi` | `.pi/prompts/af-setup-agent-fleet.md`, `.pi/prompts/af-doctor-agent-fleet.md`, `.pi/skills/guided-workspace-setup/SKILL.md` |
|
|
399
401
|
| `opencode` | `.opencode/commands/af-setup-agent-fleet.md`, `.opencode/commands/af-doctor-agent-fleet.md`, `.opencode/skills/guided-workspace-setup/SKILL.md` |
|
|
400
402
|
|
|
401
403
|
After deleting, prune any directories that were created solely for these files (e.g. `.claude/skills/guided-workspace-setup/`) — never prune a directory that contains other files.
|
|
@@ -406,12 +408,12 @@ If `cleanupInstaller` is available via the CLI (`npx @chankov/agent-fleet cleanu
|
|
|
406
408
|
|
|
407
409
|
### 11. Verify and report
|
|
408
410
|
|
|
409
|
-
Re-scan the install-target directories one more time and confirm: every selected artifact exists at its target path, every deselected one is gone, and zero broken symlinks remain. When pi extensions were touched, verify their runtime imports from the **real source path** (not only the target symlink path); when `chrome-devtools-mcp` is selected, launch/reload pi and require `/
|
|
411
|
+
Re-scan the install-target directories one more time and confirm: every selected artifact exists at its target path, every deselected one is gone, and zero broken symlinks remain. When pi extensions were touched, verify their runtime imports from the **real source path** (not only the target symlink path); when `chrome-devtools-mcp` is selected, launch/reload pi and require `/af-chrome-devtools-status` to report `connected` with a non-zero registered tool count. Merely listing the extension under `[Extensions]` is not proof that its asynchronous MCP initialization succeeded. When pi harnesses were touched, also confirm the `justfile` is consistent with the installed harness set: every installed harness has its launch recipe, and **no recipe points at a `.pi/harnesses/<name>/` that is not installed** (a leftover recipe for a retired harness is the regression this check catches). Also re-read `.ai/agent-fleet-setup.md` and verify the `version:` line matches the package version from Step 2 — a mismatch here means the apply pass did not stamp the new version, and must be corrected before the next re-run computes the wrong delta. If the post-apply scan surfaces any new breakage, treat it as a doctor finding and offer the same repair options as Step 5, then append a second `## doctor-runs` line with `phase: postflight`. List what changed, point the user at `.ai/agent-fleet-overrides.md` and `.ai/agent-fleet-setup.md`, and suggest loading `using-agent-skills` first in their next session.
|
|
410
412
|
|
|
411
413
|
Close the report with one line explaining the installer-cleanup outcome:
|
|
412
414
|
|
|
413
|
-
- If Step 10b ran: *"Installer slash commands removed from your workspace. Re-run `npx @chankov/agent-fleet init` if you need
|
|
414
|
-
- If Step 10b was skipped (`keep-installer: true`):
|
|
415
|
+
- If Step 10b ran: *"Installer slash commands removed from your workspace. Re-run `npx @chankov/agent-fleet init` if you need the setup command back."*
|
|
416
|
+
- If Step 10b was skipped (`keep-installer: true`): name the retained commands for the selected runtime — `/af-setup-agent-fleet` and `/af-doctor-agent-fleet` on pi/OpenCode, or the unprefixed Claude Code equivalents.
|
|
415
417
|
|
|
416
418
|
## Common Rationalizations
|
|
417
419
|
|
|
@@ -432,7 +434,7 @@ Close the report with one line explaining the installer-cleanup outcome:
|
|
|
432
434
|
| "There is no `*-setup.md` for this agent, so I'll guess the install paths." | Guessed paths put artifacts where the agent never loads them. Read the agent's setup doc, or use the built-in map — a location is never invented. |
|
|
433
435
|
| "The workspace already has a `.claude/` directory, so setup is done." | A directory existing is not install state. The `## install-status` section is the only record of what this skill installed; read it before deciding. |
|
|
434
436
|
| "An existing file differs from the source — I'll pause and ask the user mid-apply whether to overwrite." | Step 6 already surfaced `mod` with the warning that refreshing overwrites local edits. The user's selection is the consent. Mid-apply questions break the apply pass; they were replaced by the upfront status. |
|
|
435
|
-
| "`.pi/prompts/design-agent.md` doesn't exist, but `.claude/commands/design-agent.md` does — I'll symlink to the Claude file so the user gets the prompt." | That mixes runtimes silently and lets the source repo's claude-code tree drive a pi target. The source availability filter forbids it: items without a per-agent source are not offered at all. |
|
|
437
|
+
| "`.pi/prompts/af-design-agent.md` doesn't exist, but `.claude/commands/design-agent.md` does — I'll symlink to the Claude file so the user gets the prompt." | That mixes runtimes silently and lets the source repo's claude-code tree drive a pi target. The source availability filter forbids it: items without a per-agent source are not offered at all. |
|
|
436
438
|
| "The harness directories installed fine — the `justfile` is just launch shortcuts, I'll leave the existing one." | The `justfile` is how harnesses are launched; if it is not refreshed from the current source, retired-harness recipes linger (pointing at deleted `.pi/harnesses/<name>/` dirs) and newly added harnesses (for example `ask-user-remote` or the Hermes `conductor` recipe) have no recipe at all. It is a companion of the harness group and must be refreshed whenever any harness changes. |
|
|
437
439
|
| "I'll just copy the source `justfile` over the target's to refresh it." | A wholesale copy clobbers any recipes the user authored. Refresh only the managed region between the `agent-fleet:harnesses` sentinels; a user-edited `justfile` outside that region is `mod`/`cflt` and gets the three-way diff first — never a silent overwrite. |
|
|
438
440
|
| "The persona is just markdown — I'll copy it as-is for claude-code; the extra frontmatter keys are harmless." | The canonical frontmatter carries pi tool names (`find`, `ls`), pi model routes (`openai-codex/…`), and agent-hub keys the target cannot read. The `transform-persona` CLI exists so the installed file is correct and deterministic — raw copies and hand-transforms both drift. |
|
|
@@ -440,7 +442,7 @@ Close the report with one line explaining the installer-cleanup outcome:
|
|
|
440
442
|
| "I'll record the full install detail in the overrides file too — one place is simpler." | Other skills load the overrides file on every run. Install detail belongs only in `agent-fleet-setup.md`; padding the overrides file taxes every later session. |
|
|
441
443
|
| "There's an unfamiliar skill in `.claude/skills/` — the user must have forgotten to uncheck it, I'll remove it." | The removal scope rule exists exactly to prevent this. If the name is not in the agent-fleet inventory or not in `## install-status`, it is user-owned; leave it alone and log it as skipped. |
|
|
442
444
|
| "The user wants a clean workspace — I'll prune custom hooks and unrelated MCP entries from `settings.json` too." | Setting-file edits are limited to agent-fleet' own hook registrations. Touching anything else silently deletes work that does not belong to this skill. |
|
|
443
|
-
| "
|
|
445
|
+
| "The Agent Fleet setup and doctor commands are useful — I'll re-install them at the end of apply so the user can re-run them locally." | They are installer commands that the CLI bootstraps and the skill itself cleans up in Step 10b by default. Keeping them is opt-in via `keep` in Step 9. Re-installing them silently undoes the cleanup the user implicitly chose. |
|
|
444
446
|
| "The bootstrap marker is missing — I'll search the user's `~/repos/`, `~/projects/`, and `/media/` for any clone of `agent-fleet` to use as the source root." | Scanning the user's filesystem picks up dev clones, forks, half-edited working trees, and stale checkouts that are NOT the package the user installed from. The npm-installed copy is the only authoritative source after `init`. Without the marker, ask the user explicitly — never guess. |
|
|
445
447
|
| "This `SKILL.md` is two levels below the workspace's `.pi/skills/`, so the workspace root must be the source root." | Bootstrap copies `SKILL.md` into the workspace precisely so the slash command can load it. The workspace is the *target* of the install, not the source. Use the marker file to find the real source; resolving from `SKILL.md`'s workspace location always lies. |
|
|
446
448
|
| "The recorded version differs from the current — I'll just refresh everything to the new source without showing the diff." | Conflicting upgrades (user-modified copy + source changed upstream) require the three-way diff printed and the per-row inline question answered. Refreshing silently overwrites work the user did between versions. |
|
|
@@ -1,15 +0,0 @@
|
|
|
1
|
-
import json,socket,tempfile,threading,unittest
|
|
2
|
-
from pathlib import Path
|
|
3
|
-
from adapter import MonitorAdapter,MonitorUnavailable,MAX_SNAPSHOT_RESPONSE_BYTES
|
|
4
|
-
class CapTest(unittest.TestCase):
|
|
5
|
-
def request(self, frame):
|
|
6
|
-
with tempfile.TemporaryDirectory() as d:
|
|
7
|
-
p=str(Path(d)/'s');s=socket.socket(socket.AF_UNIX,socket.SOCK_STREAM);s.bind(p);s.listen(1)
|
|
8
|
-
def serve(): c,_=s.accept();c.recv(4096);c.sendall(frame);c.close();s.close()
|
|
9
|
-
t=threading.Thread(target=serve);t.start()
|
|
10
|
-
try:return MonitorAdapter(p,'t')._request({'type':'snapshot'})
|
|
11
|
-
finally:t.join()
|
|
12
|
-
def test_cap_excludes_one_ndjson_delimiter(self):
|
|
13
|
-
base=json.dumps({'x':''},separators=(',',':')).encode();frame=json.dumps({'x':'a'*(MAX_SNAPSHOT_RESPONSE_BYTES-len(base))},separators=(',',':')).encode();self.assertEqual(len(frame),MAX_SNAPSHOT_RESPONSE_BYTES);self.assertIsInstance(self.request(frame+b'\n'),dict)
|
|
14
|
-
with self.assertRaises(MonitorUnavailable):self.request(frame+b'a\n')
|
|
15
|
-
if __name__=='__main__':unittest.main()
|
package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py
DELETED
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
import json
|
|
2
|
-
import os
|
|
3
|
-
import tempfile
|
|
4
|
-
import unittest
|
|
5
|
-
from datetime import datetime, timedelta, timezone
|
|
6
|
-
from pathlib import Path
|
|
7
|
-
from adapter import MonitorAdapter
|
|
8
|
-
|
|
9
|
-
class AdapterDiscoveryTest(unittest.TestCase):
|
|
10
|
-
def test_discovers_local_socket_and_token_from_explicit_profile_runtime_environment(self):
|
|
11
|
-
with tempfile.TemporaryDirectory() as directory:
|
|
12
|
-
root=Path(directory)/"runtime"; root.mkdir(mode=0o700)
|
|
13
|
-
profile="a"*64; namespace=root/MonitorAdapter.canonical_profile_id(profile)/("b"*64); namespace.mkdir(parents=True, mode=0o700)
|
|
14
|
-
owner="00000000-0000-0000-0000-000000000000"; socket_id=__import__('hashlib').sha256(f"{MonitorAdapter.canonical_profile_id(profile)}:{__import__('hashlib').sha256(b'hub').hexdigest()}:{owner}".encode()).hexdigest()[:32]; token=namespace/f"token-{owner}"; token.write_text("secret"); os.chmod(token,0o600)
|
|
15
|
-
discovery=namespace/f"discovery-{owner}.json"; discovery.write_text(json.dumps({"owner":owner,"socket":f"@runtime/s/{socket_id}/s","token":f"token-{owner}","lease":{"hub":"hub","pid":1,"startedAt":"2020-01-01T00:00:00Z","expiresAt":(datetime.now(timezone.utc)+timedelta(minutes=1)).isoformat()}})); os.chmod(discovery,0o600)
|
|
16
|
-
adapter=MonitorAdapter.from_profile_environment({"AGENT_FLEET_PROFILE_ID":profile,"AGENT_FLEET_MONITOR_RUNTIME_DIR":str(root)})
|
|
17
|
-
self.assertEqual(adapter._socket_path,str(root/f"s/{socket_id}/s")); self.assertEqual(adapter._token,"secret")
|
|
18
|
-
|
|
19
|
-
if __name__ == "__main__": unittest.main()
|
package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py
DELETED
|
@@ -1,13 +0,0 @@
|
|
|
1
|
-
import socket,tempfile,threading,unittest
|
|
2
|
-
from pathlib import Path
|
|
3
|
-
from adapter import MonitorAdapter,MonitorUnavailable
|
|
4
|
-
class EnvelopeTest(unittest.TestCase):
|
|
5
|
-
def test_rejects_non_object_json_envelope(self):
|
|
6
|
-
with tempfile.TemporaryDirectory() as d:
|
|
7
|
-
p=str(Path(d)/'s'); server=socket.socket(socket.AF_UNIX,socket.SOCK_STREAM);server.bind(p);server.listen(1)
|
|
8
|
-
def serve():
|
|
9
|
-
c,_=server.accept();c.recv(4096);c.sendall(b'[]\n');c.close();server.close()
|
|
10
|
-
t=threading.Thread(target=serve);t.start()
|
|
11
|
-
with self.assertRaises(MonitorUnavailable): MonitorAdapter(p,'secret').snapshot()
|
|
12
|
-
t.join()
|
|
13
|
-
if __name__=='__main__':unittest.main()
|
package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py
DELETED
|
@@ -1,11 +0,0 @@
|
|
|
1
|
-
import json,os,tempfile,unittest
|
|
2
|
-
from datetime import datetime,timedelta,timezone
|
|
3
|
-
from pathlib import Path
|
|
4
|
-
from adapter import MonitorAdapter,MonitorUnavailable
|
|
5
|
-
class ForgedOwnerTest(unittest.TestCase):
|
|
6
|
-
def test_forged_cross_owner_expired_record_is_not_cleaned(self):
|
|
7
|
-
with tempfile.TemporaryDirectory() as d:
|
|
8
|
-
root=Path(d)/'r';root.mkdir(mode=0o700);p='p';ns=root/MonitorAdapter.canonical_profile_id(p)/('a'*64);ns.mkdir(parents=True,mode=0o700);owner='00000000-0000-0000-0000-000000000000';f=ns/f'discovery-{owner}.json';f.write_text(json.dumps({'owner':owner,'token':'token-11111111-1111-1111-1111-111111111111','socket':'@runtime/s/'+'a'*32+'/s','lease':{'hub':'hub','pid':1,'startedAt':'2020-01-01T00:00:00Z','expiresAt':'2020-01-01T00:00:01Z'}}));os.chmod(f,0o600)
|
|
9
|
-
with self.assertRaises(MonitorUnavailable):MonitorAdapter.from_profile_environment({'AGENT_FLEET_PROFILE_ID':p,'AGENT_FLEET_MONITOR_RUNTIME_DIR':str(root)})
|
|
10
|
-
self.assertTrue(f.exists())
|
|
11
|
-
if __name__=='__main__':unittest.main()
|
package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py
DELETED
|
@@ -1,9 +0,0 @@
|
|
|
1
|
-
import json,os,tempfile,unittest
|
|
2
|
-
from pathlib import Path
|
|
3
|
-
from adapter import MonitorAdapter,MonitorUnavailable
|
|
4
|
-
class LeaseListTest(unittest.TestCase):
|
|
5
|
-
def test_lease_list_is_unavailable(self):
|
|
6
|
-
with tempfile.TemporaryDirectory() as d:
|
|
7
|
-
root=Path(d)/'r';root.mkdir(mode=0o700); profile='p';ns=root/MonitorAdapter.canonical_profile_id(profile)/('a'*64);ns.mkdir(parents=True,mode=0o700);p=ns/'discovery-00000000-0000-0000-0000-000000000000.json';p.write_text(json.dumps({'lease':[]}));os.chmod(p,0o600)
|
|
8
|
-
with self.assertRaises(MonitorUnavailable):MonitorAdapter.from_profile_environment({'AGENT_FLEET_PROFILE_ID':profile,'AGENT_FLEET_MONITOR_RUNTIME_DIR':str(root)})
|
|
9
|
-
if __name__=='__main__':unittest.main()
|
package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py
DELETED
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
import unittest
|
|
2
|
-
from adapter import FleetMonitorAdapter, MonitorUnavailable
|
|
3
|
-
class Hub:
|
|
4
|
-
def __init__(self,name,fail=False): self.name=name;self.fail=fail;self.calls=[]
|
|
5
|
-
def snapshot(self):
|
|
6
|
-
if self.fail: raise MonitorUnavailable('down')
|
|
7
|
-
return {'tasks':[{'id':'same','generation':1}]}
|
|
8
|
-
def output(self,*v): self.calls.append(('output',v));return {'text':self.name}
|
|
9
|
-
def cancel(self,*v): self.calls.append(('cancel',v));return {'cancelled':True}
|
|
10
|
-
class MultiHubTest(unittest.TestCase):
|
|
11
|
-
def test_colliding_ids_are_annotated_and_route_to_owner(self):
|
|
12
|
-
a,b=Hub('a'),Hub('b'); f=FleetMonitorAdapter([('a',a),('b',b)])
|
|
13
|
-
self.assertEqual({x['hubInstanceId'] for x in f.snapshot()['tasks']},{'a','b'})
|
|
14
|
-
self.assertEqual(f.output('same',1,0,'b'),{'text':'b'}); self.assertEqual(b.calls,[('output',('same',1,0))]);self.assertEqual(a.calls,[])
|
|
15
|
-
def test_failed_hub_does_not_drop_healthy_tasks(self):
|
|
16
|
-
result=FleetMonitorAdapter([('a',Hub('a')),('b',Hub('b',True))]).snapshot();self.assertEqual(len(result['tasks']),1);self.assertEqual(result['hubs'][0]['hubInstanceId'],'b')
|
|
17
|
-
if __name__=='__main__': unittest.main()
|
|
@@ -1,34 +0,0 @@
|
|
|
1
|
-
import json
|
|
2
|
-
import socket
|
|
3
|
-
import tempfile
|
|
4
|
-
import threading
|
|
5
|
-
import unittest
|
|
6
|
-
from pathlib import Path
|
|
7
|
-
|
|
8
|
-
from adapter import MonitorAdapter
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
class AdapterOutputTest(unittest.TestCase):
|
|
12
|
-
def test_maps_typed_output_route_to_authenticated_uds_cursor_request(self):
|
|
13
|
-
with tempfile.TemporaryDirectory() as directory:
|
|
14
|
-
socket_path = str(Path(directory) / "monitor.sock")
|
|
15
|
-
server = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
|
|
16
|
-
server.bind(socket_path)
|
|
17
|
-
server.listen(1)
|
|
18
|
-
|
|
19
|
-
def serve():
|
|
20
|
-
client, _ = server.accept()
|
|
21
|
-
request = json.loads(client.recv(4096).decode())
|
|
22
|
-
self.assertEqual(request, {"type": "output", "token": "secret", "taskId": "task", "generation": 2, "afterSequence": 7})
|
|
23
|
-
client.sendall(b'{"ok":true,"output":{"text":"new","sequence":8,"firstSequence":8,"truncated":false}}\n')
|
|
24
|
-
client.close()
|
|
25
|
-
server.close()
|
|
26
|
-
|
|
27
|
-
thread = threading.Thread(target=serve)
|
|
28
|
-
thread.start()
|
|
29
|
-
self.assertEqual(MonitorAdapter(socket_path, "secret").output("task", 2, 7), {"text": "new", "sequence": 8, "firstSequence": 8, "truncated": False})
|
|
30
|
-
thread.join()
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
if __name__ == "__main__":
|
|
34
|
-
unittest.main()
|