@chankov/agent-fleet 1.0.3 → 2.0.0
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/.pi/harnesses/agent-hub/README.md +82 -77
- package/.pi/harnesses/agent-hub/capability-packs.ts +4 -4
- package/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/context.ts +39 -0
- package/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.pi/harnesses/agent-hub/config/agents.ts +171 -0
- package/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
- package/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
- package/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
- package/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.pi/harnesses/agent-hub/delegate.ts +14 -3
- package/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
- package/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
- package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
- package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
- package/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
- package/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
- package/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
- package/.pi/harnesses/agent-hub/drift-watchdog.js +3 -3
- package/.pi/harnesses/agent-hub/footer.ts +3 -9
- package/.pi/harnesses/agent-hub/helpers.ts +2 -2
- package/.pi/harnesses/agent-hub/index.ts +1327 -9476
- package/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
- package/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
- package/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/policy/models.ts +126 -0
- package/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
- package/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
- package/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
- package/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
- package/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
- package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
- package/.pi/harnesses/agent-hub/research/controls.ts +75 -0
- package/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
- package/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
- package/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.pi/harnesses/agent-hub/spawn.ts +25 -3
- package/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
- package/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.pi/harnesses/agent-hub/tools/context.ts +132 -0
- package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
- package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
- package/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
- package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
- package/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
- package/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
- package/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
- package/.pi/harnesses/agent-hub/types.ts +60 -0
- package/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
- package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
- package/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
- package/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.pi/harnesses/agent-hub/work-mode.ts +167 -0
- package/.pi/harnesses/coms/index.ts +139 -1630
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.pi/harnesses/lib/context-budget-hub-prompt.ts +3 -5
- package/.pi/harnesses/lib/fleet-dashboard-ops.ts +2 -2
- package/.pi/harnesses/lib/fleet-detail-view.ts +95 -16
- package/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.pi/prompts/af-plan.md +6 -5
- package/.versions/1.0.4/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/1.0.4/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/1.0.4/.pi/agents/peers.yaml +142 -0
- package/.versions/1.0.4/.pi/agents/teams.yaml +41 -0
- package/.versions/1.0.4/.pi/damage-control-rules.yaml +297 -0
- package/.versions/1.0.4/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/1.0.4/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/1.0.4/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/1.0.4/.pi/extensions/btw/README.md +120 -0
- package/.versions/1.0.4/.pi/extensions/btw/index.ts +914 -0
- package/.versions/1.0.4/.pi/extensions/btw/package.json +6 -0
- package/.versions/1.0.4/.pi/extensions/btw/state.js +179 -0
- package/.versions/1.0.4/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/1.0.4/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/1.0.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/1.0.4/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/1.0.4/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/1.0.4/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/1.0.4/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/1.0.4/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/1.0.4/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/1.0.4/.pi/extensions/package-lock.json +1175 -0
- package/.versions/1.0.4/.pi/extensions/package.json +9 -0
- package/.versions/1.0.4/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/1.0.4/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/1.0.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/1.0.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/1.0.4/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/1.0.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/1.0.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/README.md +1170 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/delegate.ts +446 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/footer.ts +36 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/index.ts +10171 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/spawn.ts +388 -0
- package/.versions/1.0.4/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/1.0.4/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/1.0.4/.pi/harnesses/ask-user-remote/index.ts +532 -0
- package/.versions/1.0.4/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/1.0.4/.pi/harnesses/coms/README.md +100 -0
- package/.versions/1.0.4/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/1.0.4/.pi/harnesses/coms/package.json +7 -0
- package/.versions/1.0.4/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/1.0.4/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/1.0.4/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/1.0.4/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/1.0.4/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/1.0.4/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/1.0.4/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
- package/.versions/1.0.4/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
- package/.versions/1.0.4/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/1.0.4/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/1.0.4/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/1.0.4/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/1.0.4/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/1.0.4/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/1.0.4/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/1.0.4/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/1.0.4/.pi/harnesses/package.json +10 -0
- package/.versions/1.0.4/.pi/prompts/af-build.md +24 -0
- package/.versions/1.0.4/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/1.0.4/.pi/prompts/af-plan.md +17 -0
- package/.versions/1.0.4/.pi/prompts/af-review.md +16 -0
- package/.versions/1.0.4/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/1.0.4/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/1.0.4/.pi/prompts/af-ship.md +17 -0
- package/.versions/1.0.4/.pi/prompts/af-spec.md +15 -0
- package/.versions/1.0.4/.pi/prompts/af-test.md +19 -0
- package/.versions/1.0.4/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/1.0.4/.version +1 -0
- package/.versions/1.0.4/agents/architect.md +25 -0
- package/.versions/1.0.4/agents/bowser.md +28 -0
- package/.versions/1.0.4/agents/builder.md +56 -0
- package/.versions/1.0.4/agents/code-reviewer.md +209 -0
- package/.versions/1.0.4/agents/deep-researcher.md +33 -0
- package/.versions/1.0.4/agents/documenter.md +19 -0
- package/.versions/1.0.4/agents/orchestrator.md +21 -0
- package/.versions/1.0.4/agents/plan-reviewer.md +84 -0
- package/.versions/1.0.4/agents/planner.md +71 -0
- package/.versions/1.0.4/agents/releaser.md +25 -0
- package/.versions/1.0.4/agents/researcher.md +29 -0
- package/.versions/1.0.4/agents/security-auditor.md +168 -0
- package/.versions/1.0.4/agents/test-engineer.md +154 -0
- package/.versions/1.0.4/agents/web-debugger.md +44 -0
- package/.versions/1.0.4/agents/web-performance-auditor.md +194 -0
- package/.versions/1.0.4/bin/catalog/harness-runtime-closure.json +38 -0
- package/.versions/1.0.4/codex/CONDUCTOR.md +148 -0
- package/.versions/1.0.4/docs/ARCHITECTURE.md +375 -0
- package/.versions/1.0.4/docs/agent-fleet-setup.md +468 -0
- package/.versions/1.0.4/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/1.0.4/docs/codex-remote-conductor.md +170 -0
- package/.versions/1.0.4/docs/coms-hermes-bridge.md +189 -0
- package/.versions/1.0.4/docs/getting-started.md +98 -0
- package/.versions/1.0.4/docs/npm-install.md +292 -0
- package/.versions/1.0.4/docs/pi-extensions.md +441 -0
- package/.versions/1.0.4/docs/pi-setup.md +74 -0
- package/.versions/1.0.4/docs/skill-anatomy.md +150 -0
- package/.versions/1.0.4/hermes/README.md +347 -0
- package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/1.0.4/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/1.0.4/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/1.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/1.0.4/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/1.0.4/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/1.0.4/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/1.0.4/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/1.0.4/install-manifest.json +2745 -0
- package/.versions/1.0.4/justfile +272 -0
- package/.versions/1.0.4/manifest-meta.json +882 -0
- package/.versions/1.0.4/references/accessibility-checklist.md +160 -0
- package/.versions/1.0.4/references/definition-of-done.md +67 -0
- package/.versions/1.0.4/references/fleet-coordination-patterns.md +151 -0
- package/.versions/1.0.4/references/observability-checklist.md +91 -0
- package/.versions/1.0.4/references/orchestration-patterns.md +370 -0
- package/.versions/1.0.4/references/performance-checklist.md +153 -0
- package/.versions/1.0.4/references/prompting-patterns.md +380 -0
- package/.versions/1.0.4/references/security-checklist.md +179 -0
- package/.versions/1.0.4/references/testing-patterns.md +236 -0
- package/.versions/1.0.4/scripts/codex-conductor.ts +41 -0
- package/.versions/1.0.4/scripts/codex-remote-control.ts +167 -0
- package/.versions/1.0.4/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/1.0.4/scripts/coms-cli.ts +484 -0
- package/.versions/1.0.4/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/1.0.4/scripts/fleet.ts +185 -0
- package/.versions/1.0.4/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/1.0.4/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/1.0.4/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/1.0.4/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/1.0.4/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/1.0.4/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/1.0.4/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/1.0.4/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/1.0.4/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/1.0.4/scripts/lib/fleet-command.ts +266 -0
- package/.versions/1.0.4/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/1.0.4/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/1.0.4/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/1.0.4/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/1.0.4/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/1.0.4/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/1.0.4/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/1.0.4/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/1.0.4/scripts/lib/monitor-env.ts +146 -0
- package/.versions/1.0.4/scripts/lib/peer-launch.ts +318 -0
- package/.versions/1.0.4/scripts/lib/persona-banner.ts +62 -0
- package/.versions/1.0.4/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/1.0.4/scripts/lib/team-project.ts +213 -0
- package/.versions/1.0.4/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/1.0.4/scripts/peer-banner.ts +40 -0
- package/.versions/1.0.4/scripts/peer-launch.ts +259 -0
- package/.versions/1.0.4/scripts/team-snapshot.ts +237 -0
- package/.versions/1.0.4/scripts/team-up.ts +406 -0
- package/.versions/1.0.4/skills/_internal/grilling.md +59 -0
- package/.versions/1.0.4/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/1.0.4/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/1.0.4/skills/compound-learning/SKILL.md +137 -0
- package/.versions/1.0.4/skills/context-engineering/SKILL.md +291 -0
- package/.versions/1.0.4/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/1.0.4/skills/designing-agents/SKILL.md +394 -0
- package/.versions/1.0.4/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/1.0.4/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/1.0.4/skills/idea-refine/SKILL.md +182 -0
- package/.versions/1.0.4/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.4/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.4/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.4/skills/incremental-implementation/SKILL.md +298 -0
- package/.versions/1.0.4/skills/interview-me/SKILL.md +226 -0
- package/.versions/1.0.4/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/1.0.4/skills/peer-coms/SKILL.md +90 -0
- package/.versions/1.0.4/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.4/skills/planning-and-task-breakdown/SKILL.md +263 -0
- package/.versions/1.0.4/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/1.0.4/skills/spec-driven-development/SKILL.md +256 -0
- package/.versions/1.0.4/skills/using-agent-skills/SKILL.md +197 -0
- package/.versions/1.0.4/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/1.0.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/.versions/2.0.0/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.0/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/2.0.0/.pi/agents/peers.yaml +142 -0
- package/.versions/2.0.0/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.0/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/2.0.0/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.0/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.0/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.0/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.0/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.0/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.0/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.0/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.0/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.0/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.0/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.0/.pi/extensions/package.json +9 -0
- package/.versions/2.0.0/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/2.0.0/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.0/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/README.md +1161 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/context.ts +39 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/config/agents.ts +171 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/delegate.ts +446 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/fixtures/registration-surface.json +53 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/index.ts +1850 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/models.ts +126 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/research/controls.ts +75 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/spawn.ts +388 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/context.ts +132 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/types.ts +60 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.0/.pi/harnesses/agent-hub/work-mode.ts +167 -0
- package/.versions/2.0.0/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/2.0.0/.pi/harnesses/ask-user-remote/index.ts +532 -0
- package/.versions/2.0.0/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/2.0.0/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.0/.pi/harnesses/coms/index.ts +276 -0
- package/.versions/2.0.0/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.0/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.0/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/2.0.0/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/2.0.0/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.0/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.0/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.0/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.0/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
- package/.versions/2.0.0/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.0/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.0/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.0/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.0/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.0/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.0/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/2.0.0/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.0/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.0/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.0/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.0/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.0/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.0/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.0/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.0/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.0/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.0/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.0/.version +1 -0
- package/.versions/2.0.0/agents/architect.md +25 -0
- package/.versions/2.0.0/agents/bowser.md +28 -0
- package/.versions/2.0.0/agents/builder.md +56 -0
- package/.versions/2.0.0/agents/code-reviewer.md +209 -0
- package/.versions/2.0.0/agents/deep-researcher.md +33 -0
- package/.versions/2.0.0/agents/documenter.md +19 -0
- package/.versions/2.0.0/agents/orchestrator.md +23 -0
- package/.versions/2.0.0/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.0/agents/planner.md +71 -0
- package/.versions/2.0.0/agents/releaser.md +25 -0
- package/.versions/2.0.0/agents/researcher.md +29 -0
- package/.versions/2.0.0/agents/security-auditor.md +168 -0
- package/.versions/2.0.0/agents/test-engineer.md +154 -0
- package/.versions/2.0.0/agents/web-debugger.md +44 -0
- package/.versions/2.0.0/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.0/bin/catalog/harness-runtime-closure.json +38 -0
- package/.versions/2.0.0/codex/CONDUCTOR.md +148 -0
- package/.versions/2.0.0/docs/ARCHITECTURE.md +404 -0
- package/.versions/2.0.0/docs/agent-fleet-setup.md +468 -0
- package/.versions/2.0.0/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/2.0.0/docs/codex-remote-conductor.md +170 -0
- package/.versions/2.0.0/docs/coms-hermes-bridge.md +189 -0
- package/.versions/2.0.0/docs/getting-started.md +98 -0
- package/.versions/2.0.0/docs/npm-install.md +292 -0
- package/.versions/2.0.0/docs/pi-extensions.md +439 -0
- package/.versions/2.0.0/docs/pi-setup.md +74 -0
- package/.versions/2.0.0/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.0/hermes/README.md +347 -0
- package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.0/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.0/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.0/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.0/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.0/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.0/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.0/install-manifest.json +2745 -0
- package/.versions/2.0.0/justfile +272 -0
- package/.versions/2.0.0/manifest-meta.json +882 -0
- package/.versions/2.0.0/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.0/references/definition-of-done.md +67 -0
- package/.versions/2.0.0/references/fleet-coordination-patterns.md +151 -0
- package/.versions/2.0.0/references/observability-checklist.md +91 -0
- package/.versions/2.0.0/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.0/references/performance-checklist.md +153 -0
- package/.versions/2.0.0/references/prompting-patterns.md +380 -0
- package/.versions/2.0.0/references/security-checklist.md +179 -0
- package/.versions/2.0.0/references/testing-patterns.md +236 -0
- package/.versions/2.0.0/scripts/codex-conductor.ts +41 -0
- package/.versions/2.0.0/scripts/codex-remote-control.ts +167 -0
- package/.versions/2.0.0/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.0/scripts/coms-cli.ts +484 -0
- package/.versions/2.0.0/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.0/scripts/fleet.ts +185 -0
- package/.versions/2.0.0/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.0/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.0/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.0/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.0/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.0/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/2.0.0/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/2.0.0/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.0/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.0/scripts/lib/fleet-command.ts +270 -0
- package/.versions/2.0.0/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.0/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.0/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.0/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.0/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.0/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.0/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.0/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.0/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.0/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.0/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.0/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.0/scripts/lib/team-project.ts +213 -0
- package/.versions/2.0.0/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.0/scripts/peer-banner.ts +40 -0
- package/.versions/2.0.0/scripts/peer-launch.ts +259 -0
- package/.versions/2.0.0/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.0/scripts/team-up.ts +406 -0
- package/.versions/2.0.0/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.0/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/2.0.0/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.0/skills/context-engineering/SKILL.md +291 -0
- package/.versions/2.0.0/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/2.0.0/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.0/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.0/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.0/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.0/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.0/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.0/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.0/skills/incremental-implementation/SKILL.md +298 -0
- package/.versions/2.0.0/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.0/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/2.0.0/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.0/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.0/skills/planning-and-task-breakdown/SKILL.md +263 -0
- package/.versions/2.0.0/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/2.0.0/skills/spec-driven-development/SKILL.md +256 -0
- package/.versions/2.0.0/skills/using-agent-skills/SKILL.md +197 -0
- package/.versions/2.0.0/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/2.0.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +40 -0
- package/README.md +5 -5
- package/agents/builder.md +1 -0
- package/agents/orchestrator.md +3 -1
- package/agents/planner.md +1 -1
- package/bin/lib/overrides.js +2 -0
- package/bin/lib/validate-overrides.js +1 -1
- package/docs/ARCHITECTURE.md +42 -13
- package/docs/MIGRATION-agent-fleet.md +4 -4
- package/docs/agent-fleet-setup.md +15 -15
- package/docs/npm-install.md +1 -1
- package/docs/pi-extensions.md +16 -18
- package/install-manifest.json +3 -3
- package/justfile +2 -2
- package/package.json +3 -2
- package/scripts/fleet.ts +10 -10
- package/scripts/lib/fleet-command.ts +15 -11
- package/scripts/lib/team-project.ts +2 -2
- package/scripts/team-up.ts +10 -10
- package/skills/_internal/grilling.md +53 -5
- package/skills/idea-refine/SKILL.md +2 -2
- package/skills/incremental-implementation/SKILL.md +12 -1
- package/skills/planning-and-task-breakdown/SKILL.md +14 -5
- package/skills/spec-driven-development/SKILL.md +10 -11
- package/skills/using-agent-skills/SKILL.md +13 -15
- /package/{.pi → .versions/1.0.4/.pi}/harnesses/agent-hub/execution-profile.ts +0 -0
- /package/{.pi → .versions/1.0.4/.pi}/harnesses/agent-hub/posture.ts +0 -0
|
@@ -0,0 +1,191 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: using-agent-skills
|
|
3
|
+
description: Discovers and invokes agent skills. Use when starting a session or when you need to discover which skill applies to the current task. This is the meta-skill that governs how all other skills are discovered and invoked.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Using Agent Skills
|
|
7
|
+
|
|
8
|
+
## Overview
|
|
9
|
+
|
|
10
|
+
Agent Skills is a collection of engineering workflow skills organized by development phase. Each skill encodes a specific process that senior engineers follow. This meta-skill helps you discover and apply the right skill for your current task.
|
|
11
|
+
|
|
12
|
+
## Skill Discovery
|
|
13
|
+
|
|
14
|
+
When a task arrives, identify the development phase and apply the corresponding skill:
|
|
15
|
+
|
|
16
|
+
```
|
|
17
|
+
Task arrives
|
|
18
|
+
│
|
|
19
|
+
├── Don't know what you want yet? ──────→ interview-me
|
|
20
|
+
├── Have a rough concept, need variants? → idea-refine
|
|
21
|
+
├── New project/feature/change? ──→ spec-driven-development
|
|
22
|
+
├── Have a spec, need tasks? ──────→ planning-and-task-breakdown
|
|
23
|
+
├── Implementing code? ────────────→ incremental-implementation
|
|
24
|
+
│ ├── UI work? ─────────────────→ frontend-ui-engineering
|
|
25
|
+
│ ├── API work? ────────────────→ api-and-interface-design
|
|
26
|
+
│ ├── Need better context? ─────→ context-engineering
|
|
27
|
+
│ ├── Need doc-verified code? ───→ source-driven-development
|
|
28
|
+
│ └── Stakes high / unfamiliar code? ──→ doubt-driven-development
|
|
29
|
+
├── Writing/running tests? ────────→ test-driven-development
|
|
30
|
+
│ └── Browser-based? ───────────→ browser-testing-with-devtools
|
|
31
|
+
├── Something broke? ──────────────→ debugging-and-error-recovery
|
|
32
|
+
├── Reviewing code? ───────────────→ code-review-and-quality
|
|
33
|
+
│ ├── Too complex? ─────────────→ code-simplification
|
|
34
|
+
│ ├── Security concerns? ───────→ security-and-hardening
|
|
35
|
+
│ └── Performance concerns? ────→ performance-optimization
|
|
36
|
+
├── Committing/branching? ─────────→ git-workflow-and-versioning
|
|
37
|
+
├── CI/CD pipeline work? ──────────→ ci-cd-and-automation
|
|
38
|
+
├── Deprecating/migrating? ────────→ deprecation-and-migration
|
|
39
|
+
├── Writing docs/ADRs? ───────────→ documentation-and-adrs
|
|
40
|
+
├── Adding logs/metrics/alerts? ───→ observability-and-instrumentation
|
|
41
|
+
└── Deploying/launching? ─────────→ shipping-and-launch
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
## Core Operating Behaviors
|
|
45
|
+
|
|
46
|
+
These behaviors apply at all times, across all skills. They are non-negotiable.
|
|
47
|
+
|
|
48
|
+
### 1. Surface Assumptions
|
|
49
|
+
|
|
50
|
+
Before implementing anything non-trivial, explicitly state your assumptions:
|
|
51
|
+
|
|
52
|
+
```
|
|
53
|
+
ASSUMPTIONS I'M MAKING:
|
|
54
|
+
1. [assumption about requirements]
|
|
55
|
+
2. [assumption about architecture]
|
|
56
|
+
3. [assumption about scope]
|
|
57
|
+
→ Correct me now or I'll proceed with these.
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
Don't silently fill in ambiguous requirements. The most common failure mode is making wrong assumptions and running with them unchecked. Surface uncertainty early — it's cheaper than rework.
|
|
61
|
+
|
|
62
|
+
### 2. Manage Confusion Actively
|
|
63
|
+
|
|
64
|
+
When you encounter inconsistencies, conflicting requirements, or unclear specifications:
|
|
65
|
+
|
|
66
|
+
1. **STOP.** Do not proceed with a guess.
|
|
67
|
+
2. Name the specific confusion.
|
|
68
|
+
3. Present the tradeoff or ask the clarifying question.
|
|
69
|
+
4. Wait for resolution before continuing.
|
|
70
|
+
|
|
71
|
+
**Bad:** Silently picking one interpretation and hoping it's right.
|
|
72
|
+
**Good:** "I see X in the spec but Y in the existing code. Which takes precedence?"
|
|
73
|
+
|
|
74
|
+
### 3. Push Back When Warranted
|
|
75
|
+
|
|
76
|
+
You are not a yes-machine. When an approach has clear problems:
|
|
77
|
+
|
|
78
|
+
- Point out the issue directly
|
|
79
|
+
- Explain the concrete downside (quantify when possible — "this adds ~200ms latency" not "this might be slower")
|
|
80
|
+
- Propose an alternative
|
|
81
|
+
- Accept the human's decision if they override with full information
|
|
82
|
+
|
|
83
|
+
Sycophancy is a failure mode. "Of course!" followed by implementing a bad idea helps no one. Honest technical disagreement is more valuable than false agreement.
|
|
84
|
+
|
|
85
|
+
### 4. Enforce Simplicity
|
|
86
|
+
|
|
87
|
+
Your natural tendency is to overcomplicate. Actively resist it.
|
|
88
|
+
|
|
89
|
+
Before finishing any implementation, ask:
|
|
90
|
+
- Can this be done in fewer lines?
|
|
91
|
+
- Are these abstractions earning their complexity?
|
|
92
|
+
- Would a staff engineer look at this and say "why didn't you just..."?
|
|
93
|
+
|
|
94
|
+
If you build 1000 lines and 100 would suffice, you have failed. Prefer the boring, obvious solution. Cleverness is expensive.
|
|
95
|
+
|
|
96
|
+
### 5. Maintain Scope Discipline
|
|
97
|
+
|
|
98
|
+
Touch only what you're asked to touch.
|
|
99
|
+
|
|
100
|
+
Do NOT:
|
|
101
|
+
- Remove comments you don't understand
|
|
102
|
+
- "Clean up" code orthogonal to the task
|
|
103
|
+
- Refactor adjacent systems as a side effect
|
|
104
|
+
- Delete code that seems unused without explicit approval
|
|
105
|
+
- Add features not in the spec because they "seem useful"
|
|
106
|
+
|
|
107
|
+
Your job is surgical precision, not unsolicited renovation.
|
|
108
|
+
|
|
109
|
+
### 6. Verify, Don't Assume
|
|
110
|
+
|
|
111
|
+
Every skill includes a verification step. A task is not complete until verification passes. "Seems right" is never sufficient — there must be evidence (passing tests, build output, runtime data).
|
|
112
|
+
|
|
113
|
+
Per-skill verification is the local check. The project-wide bar that applies to *every* change, regardless of which skill is active, is the Definition of Done: tests pass, no regressions, behavior verified at runtime, docs updated. See `references/definition-of-done.md`. It complements each task's acceptance criteria rather than replacing them.
|
|
114
|
+
|
|
115
|
+
## Failure Modes to Avoid
|
|
116
|
+
|
|
117
|
+
These are the subtle errors that look like productivity but create problems:
|
|
118
|
+
|
|
119
|
+
1. Making wrong assumptions without checking
|
|
120
|
+
2. Not managing your own confusion — plowing ahead when lost
|
|
121
|
+
3. Not surfacing inconsistencies you notice
|
|
122
|
+
4. Not presenting tradeoffs on non-obvious decisions
|
|
123
|
+
5. Being sycophantic ("Of course!") to approaches with clear problems
|
|
124
|
+
6. Overcomplicating code and APIs
|
|
125
|
+
7. Modifying code or comments orthogonal to the task
|
|
126
|
+
8. Removing things you don't fully understand
|
|
127
|
+
9. Building without a spec because "it's obvious"
|
|
128
|
+
10. Skipping verification because "it looks right"
|
|
129
|
+
|
|
130
|
+
## Skill Rules
|
|
131
|
+
|
|
132
|
+
1. **Check for an applicable skill before starting work.** Skills encode processes that prevent common mistakes.
|
|
133
|
+
|
|
134
|
+
2. **Skills are workflows, not suggestions.** Follow the steps in order. Don't skip verification steps.
|
|
135
|
+
|
|
136
|
+
3. **Multiple skills can apply.** A feature implementation might involve `idea-refine` → `spec-driven-development` → `planning-and-task-breakdown` → `incremental-implementation` → `test-driven-development` → `code-review-and-quality` → `code-simplification` → `shipping-and-launch` in sequence.
|
|
137
|
+
|
|
138
|
+
4. **When in doubt, start with a spec.** If the task is non-trivial and there's no spec, begin with `spec-driven-development`.
|
|
139
|
+
|
|
140
|
+
## Lifecycle Sequence
|
|
141
|
+
|
|
142
|
+
For a complete feature, the typical skill sequence is:
|
|
143
|
+
|
|
144
|
+
```
|
|
145
|
+
1. interview-me → Extract what the user actually wants
|
|
146
|
+
2. idea-refine → Refine vague ideas
|
|
147
|
+
3. spec-driven-development → Define what we're building
|
|
148
|
+
4. planning-and-task-breakdown → Break into verifiable chunks
|
|
149
|
+
5. context-engineering → Load the right context
|
|
150
|
+
6. source-driven-development → Verify against official docs
|
|
151
|
+
7. incremental-implementation → Build slice by slice
|
|
152
|
+
8. observability-and-instrumentation → Instrument as you build (runs parallel with 7-9, not after)
|
|
153
|
+
9. doubt-driven-development → Cross-examine non-trivial decisions in-flight
|
|
154
|
+
10. test-driven-development → Prove each slice works
|
|
155
|
+
11. code-review-and-quality → Review before merge
|
|
156
|
+
12. code-simplification → Reduce unnecessary complexity while preserving behavior
|
|
157
|
+
13. git-workflow-and-versioning → Clean commit history
|
|
158
|
+
14. documentation-and-adrs → Document decisions
|
|
159
|
+
15. deprecation-and-migration → Retire old systems and move users safely when needed
|
|
160
|
+
16. shipping-and-launch → Deploy safely
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
Not every task needs every skill. A bug fix might only need: `debugging-and-error-recovery` → `test-driven-development` → `code-review-and-quality`.
|
|
164
|
+
|
|
165
|
+
## Quick Reference
|
|
166
|
+
|
|
167
|
+
| Phase | Skill | One-Line Summary |
|
|
168
|
+
|-------|-------|-----------------|
|
|
169
|
+
| Define | interview-me | Surface what the user actually wants before any plan, spec, or code exists |
|
|
170
|
+
| Define | idea-refine | Refine ideas through structured divergent and convergent thinking |
|
|
171
|
+
| Define | spec-driven-development | Requirements and acceptance criteria before code |
|
|
172
|
+
| Plan | planning-and-task-breakdown | Decompose into small, verifiable tasks |
|
|
173
|
+
| Build | incremental-implementation | Thin vertical slices, test each before expanding |
|
|
174
|
+
| Build | source-driven-development | Verify against official docs before implementing |
|
|
175
|
+
| Build | doubt-driven-development | Adversarial fresh-context review of every non-trivial decision |
|
|
176
|
+
| Build | context-engineering | Right context at the right time |
|
|
177
|
+
| Build | frontend-ui-engineering | Production-quality UI with accessibility |
|
|
178
|
+
| Build | api-and-interface-design | Stable interfaces with clear contracts |
|
|
179
|
+
| Verify | test-driven-development | Failing test first, then make it pass |
|
|
180
|
+
| Verify | browser-testing-with-devtools | Chrome DevTools MCP for runtime verification |
|
|
181
|
+
| Verify | debugging-and-error-recovery | Reproduce → localize → fix → guard |
|
|
182
|
+
| Review | code-review-and-quality | Five-axis review with quality gates |
|
|
183
|
+
| Review | code-simplification | Preserve behavior while reducing unnecessary complexity |
|
|
184
|
+
| Review | security-and-hardening | OWASP prevention, input validation, least privilege |
|
|
185
|
+
| Review | performance-optimization | Measure first, optimize only what matters |
|
|
186
|
+
| Ship | git-workflow-and-versioning | Atomic commits, clean history |
|
|
187
|
+
| Ship | ci-cd-and-automation | Automated quality gates on every change |
|
|
188
|
+
| Ship | deprecation-and-migration | Remove old systems and migrate users safely |
|
|
189
|
+
| Ship | documentation-and-adrs | Document the why, not just the what |
|
|
190
|
+
| Ship | observability-and-instrumentation | Structured logs, RED metrics, traces, symptom-based alerts |
|
|
191
|
+
| Ship | shipping-and-launch | Pre-launch checklist, monitoring, rollback plan |
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,45 @@
|
|
|
1
1
|
# Agent Fleet changelog
|
|
2
2
|
|
|
3
|
+
## 2.0.0
|
|
4
|
+
|
|
5
|
+
### Major Changes
|
|
6
|
+
|
|
7
|
+
- 3492f8d: Remove the manual research lifecycle slash commands `/af-research`, `/af-research-cont`, `/af-research-rm`, `/af-research-clear`, and `/af-agents-cont`. Read-only reconnaissance now enters through the dispatcher's bounded `spawn_research` tool or the automatic specialist `NEEDS_RESEARCH:` pipe; the existing add/drop, kill, and restart controls remain available.
|
|
8
|
+
- 1fae5d7: Consolidate Fleet execution controls under Work Mode. Keep `/af-work-mode`, `Alt+M`, and `--work-mode`; remove `/af-posture`, `--posture`, and the deprecated fast/standard/strict mode aliases. Rename the runtime types, state, UI, tests, and documentation while retaining read-only compatibility for legacy persisted posture entries.
|
|
9
|
+
- 6793d7e: Remove `/af-persona` and the `persona-gate` override. The hub dispatcher is the generated Fleet prompt using the Work Mode selected through `/af-work-mode`; leftover `persona-gate` keys are ignored and flagged by doctor. `agents/orchestrator.md` remains as the catalog description of that role.
|
|
10
|
+
|
|
11
|
+
### Patch Changes
|
|
12
|
+
|
|
13
|
+
- 196b2ec: Extract Agent Hub configuration and full session lifecycle orchestration so index.ts is a bounded composition root while preserving startup and shutdown order.
|
|
14
|
+
|
|
15
|
+
Closeout measurements:
|
|
16
|
+
|
|
17
|
+
- `wc -l .pi/harnesses/agent-hub/index.ts` → 1,850 lines.
|
|
18
|
+
- Unicode character count (`len(Path(...).read_text())`) → 99,182 characters; plan estimate `/ 4` → 24,795.5 tokens.
|
|
19
|
+
- Phase 6 production modules remain below 600 lines and extracted functions below 200 lines; registration remains 16 tools / 21 commands / 8 flags.
|
|
20
|
+
|
|
21
|
+
- d3d6cd1: Extract the 21 agent-hub slash command registrars into dedicated command modules while preserving the existing command surface and behavior.
|
|
22
|
+
- 196b2ec: Extract Agent Hub fleet dashboard, detail panel, and context-budget projections into bounded UI modules.
|
|
23
|
+
- 65dfe30: Extract Agent Hub dispatch orchestration, grid and overlay UI, and execution-history state into explicit typed modules while preserving behavior and the registered surface.
|
|
24
|
+
- 196b2ec: Extract Agent Hub pool presentation, shortcuts, completions, and research controls into explicit modules.
|
|
25
|
+
- 196b2ec: Extract Agent Hub roster, model substitution, capability, and work-mode policy into typed policy modules.
|
|
26
|
+
- 71ce9ef: Extract Agent Hub system-prompt templates and ordered session-start orchestration into explicit typed modules while preserving prompt text, startup behavior, and the registered surface.
|
|
27
|
+
- 196b2ec: Extract Agent Hub research creation, retention, streaming, guarded spawn, and completion delivery into a typed research runtime.
|
|
28
|
+
- 196b2ec: Extract Agent Hub mutable state, budget, assertion, artifact, and archive APIs behind explicit root-owned context ports.
|
|
29
|
+
- 196b2ec: Extract Agent Hub dispatch and research tool execution orchestration behind narrow typed executor ports.
|
|
30
|
+
- 27a0b61: Extract all 16 Agent Hub tool registrations into typed registrar modules while preserving the existing tool schemas and behavior.
|
|
31
|
+
- 196b2ec: Extract Agent Hub context-pressure, compaction, deferred-input, and ordered turn lifecycle handlers behind explicit ports.
|
|
32
|
+
- 74265fa: Add a registration-surface regression fixture and exclude generated version snapshots from code search results before decomposing the agent-hub entry point.
|
|
33
|
+
- 5486704: `agent-fleet setup` no longer overwrites an existing `.ai/agent-fleet-overrides.md`.
|
|
34
|
+
- 626a7bb: Deduplicate the standalone coms harness and Agent Hub by routing registry, transport, presence, discovery, messaging, and shutdown behavior through one shared coms core.
|
|
35
|
+
|
|
36
|
+
## 1.0.4
|
|
37
|
+
|
|
38
|
+
### Patch Changes
|
|
39
|
+
|
|
40
|
+
- 7730d44: Add Compact/Verbose Fleet Detail logs with immediate event-driven refresh and a two-second recovery ticker. Local specialists, research helpers, and delegate children now expose wrapped assistant output, provider-emitted thinking, tool arguments, complete textual tool results, status, and duration. Per-run JSONL transcripts are owner-only, bounded in live memory, and redact common secret formats before persistence and display.
|
|
41
|
+
- 6885455: Make grilling of unspecified design forks mandatory during planning, spec writing, and implementation. Already-stated requirements in chat, prompts, PRDs, and rules are not re-asked; remaining multiple-valid-way, contradiction, and competing-code-pattern choices wait for an explicit decision.
|
|
42
|
+
|
|
3
43
|
## 1.0.3
|
|
4
44
|
|
|
5
45
|
### Patch Changes
|
package/README.md
CHANGED
|
@@ -312,7 +312,7 @@ Lifecycle, approval flow, examples, recovery, and security boundaries: **[Codex
|
|
|
312
312
|
|
|
313
313
|
## agent-hub: a thin-context dispatcher for pi
|
|
314
314
|
|
|
315
|
-
Every public Pi Fleet session is now one `agent-hub` runtime with two
|
|
315
|
+
Every public Pi Fleet session is now one `agent-hub` runtime with two work modes. Bare `just fleet` starts in **operator** work mode: direct `read`/`bash`/`edit`/`write`, orchestration tools, embedded `coms`, and an empty native roster. **Orchestrator** work mode removes direct coding tools and drives specialist subagents — planner, builder, reviewer, test-engineer, documenter — under the Verification Contract. Both work modes keep the same Hub commands, research helpers, peer collaboration, and `damage-control-continue` guardrails.
|
|
316
316
|
|
|
317
317
|

|
|
318
318
|
|
|
@@ -329,13 +329,13 @@ What makes it different is what it **doesn't** put in front of the dispatcher LL
|
|
|
329
329
|
```bash
|
|
330
330
|
just fleet # operator; empty native roster
|
|
331
331
|
just fleet --agents frontend # native roster; orchestrator inferred
|
|
332
|
-
just fleet --
|
|
332
|
+
just fleet --work-mode operator --agents frontend # direct work plus the same roster
|
|
333
333
|
just fleet --no-coms # direct/native work; no peer messaging
|
|
334
334
|
|
|
335
|
-
# live
|
|
335
|
+
# live work mode and roster changes preserve the session
|
|
336
336
|
/af-agents-add code-reviewer
|
|
337
337
|
/af-work-mode orchestrator # Alt+M picker
|
|
338
|
-
/af-
|
|
338
|
+
/af-work-mode operator
|
|
339
339
|
|
|
340
340
|
# Herdr topology (requires a running server — https://herdr.dev)
|
|
341
341
|
just fleet --herdr --project af
|
|
@@ -344,7 +344,7 @@ just fleet --agents frontend --peers frontend --project af
|
|
|
344
344
|
|
|
345
345
|
Native specialists are local headless Pi subprocesses; standing peers are separate Pi or Claude Code processes in sibling Herdr panes. They can share a name without ambiguity: `dispatch_agent(..., backend: "native")` always starts the local Pi specialist, `backend: "coms"` requires the live peer, and `backend: "auto"` follows `.pi/agents/dispatch-policy.yaml`.
|
|
346
346
|
|
|
347
|
-
From a Hub pane, add a declared Claude reviewer with `herdr_spawn_peer({ name: "code-reviewer" })`, then use `coms_send` + `coms_await`; the peer is locked to the Hub's project. `/af-handoff code-reviewer` works in either
|
|
347
|
+
From a Hub pane, add a declared Claude reviewer with `herdr_spawn_peer({ name: "code-reviewer" })`, then use `coms_send` + `coms_await`; the peer is locked to the Hub's project. `/af-handoff code-reviewer` works in either work mode when that peer is visible in the coms pool. Herdr operations require a live Herdr server; peer messaging/handoff require coms readiness. All Hub slash commands remain registered in both work modes and unavailable capabilities refuse with remediation instead of disappearing.
|
|
348
348
|
|
|
349
349
|
Compatibility forms (`just fleet hub`, `just fleet team <preset>`, and `--solo`) remain accepted during migration and print canonical replacements; use `--no-coms` instead of `--solo`.
|
|
350
350
|
|
package/agents/builder.md
CHANGED
|
@@ -29,6 +29,7 @@ You are a builder agent. Implement the requested changes thoroughly. Write clean
|
|
|
29
29
|
- If the task carries acceptance assertions (`A1`, `A2`, …) or a parity/touchpoint inventory, treat them as the definition of done and keep them verbatim — they come from the dispatcher; implement against every listed site, not just the exemplar one with fixtures.
|
|
30
30
|
- When you report back, use the structured-return schema in `skills/orchestration-verification/SKILL.md` if it exists: list `assertions_proven` (each with named evidence — test name, command output, or file:line), `assertions_unproven`, and `assertions_failed`. Report what you could not prove honestly rather than declaring "done"; an unproven assertion is not done, and naming it lets the dispatcher gate on it. Never mark an assertion proven without naming its evidence.
|
|
31
31
|
- If you lack information your own tools cannot answer, do not guess — pause per the research protocol with `NEEDS_RESEARCH: <one specific, self-contained question>` lines (nothing after them); you will be resumed in the same session with findings file paths to read.
|
|
32
|
+
- If implementation requires a choice not already settled in the task, plan, PRD, chat, prompt, or rules (multiple valid approaches, contradiction, competing code patterns), do not pick silently. Follow `skills/_internal/grilling.md` if it exists and pause with `ASK_USER: <question>` (one focused question, 2–4 options plus a recommended choice). Already-stated requirements are not re-asked. Do not continue the slice in the same turn as an `ASK_USER` request.
|
|
32
33
|
|
|
33
34
|
## Delegation pre-pass (when a `delegate` tool is available)
|
|
34
35
|
|
package/agents/orchestrator.md
CHANGED
|
@@ -14,7 +14,9 @@ thinking: medium
|
|
|
14
14
|
|
|
15
15
|
# Verification-Contract Orchestrator
|
|
16
16
|
|
|
17
|
-
|
|
17
|
+
This file documents the agent-hub dispatcher role. The live session uses the Hub-generated system prompt and the work mode selected through `/af-work-mode`; this persona is not selected at runtime.
|
|
18
|
+
|
|
19
|
+
The active Hub work mode and generated system prompt are authoritative. In orchestrator work mode delegate implementation; in operator work mode direct tools are available. Follow `skills/orchestration-verification/SKILL.md` for assertion format, parity inventories, structured returns, and regression resets; do not restate that protocol here.
|
|
18
20
|
|
|
19
21
|
Before consequential work, use the Hub's tier and budget tools. Treat a provided plan as the specification: execute only the requested batch, preserve its assertions verbatim, and do not re-plan it. Keep dispatch scopes narrow, use artifact paths rather than pasted documents, and stop on budget, safety, ambiguity, or external-blocker refusals rather than retrying around them.
|
|
20
22
|
|
package/agents/planner.md
CHANGED
|
@@ -68,4 +68,4 @@ of the Process below.
|
|
|
68
68
|
- Resolve the plan directory from `.ai/agent-fleet-overrides.md` → `## planning-and-task-breakdown` → `plan-dir`; default `docs/plans/{area}`. Name the file per the `naming` key (default `PLAN-{prd-name}.md`; add the `-{phase}` suffix only when the plan is deliberately split across multiple files). Embed the task list in the plan as a `## Task List` section unless the override says `todo: separate`.
|
|
69
69
|
- Write the plan file, then end your final response with `PLAN_FILE: <repo-relative path>` on its own line, so the result can be handed to an implementer.
|
|
70
70
|
- If you lack information that your read-only tools cannot answer, do not guess — pause for research. End your turn with one or more lines of the form `NEEDS_RESEARCH: <one specific, self-contained question>` and nothing after them (mirror of the ASK_USER protocol). Your session pauses there; read-only research helpers are spawned for you and you are resumed **in the same session** with the paths of their findings files — read them and continue planning from where you left off. Do not produce a partial or speculative plan in the same turn as a `NEEDS_RESEARCH` request.
|
|
71
|
-
-
|
|
71
|
+
- Before writing tasks, follow `skills/_internal/grilling.md` if it exists. Do **not** re-ask points already explicit in chat, prompt, PRD, spec, or rules. For every remaining unspecified fork (multiple valid approaches, contradiction, competing code patterns), do not invent an answer — ask via `ASK_USER: <question>` (one focused question, 2–4 options plus a recommended choice) rather than produce a speculative plan. Do not write the plan file in the same turn as an `ASK_USER` request. If grilling finds no open forks, say so briefly and write the plan.
|
package/bin/lib/overrides.js
CHANGED
|
@@ -30,6 +30,8 @@ export function mergeOverrides(existing, scan) {
|
|
|
30
30
|
export function planOverrides(workspace, scan) {
|
|
31
31
|
const path = join(workspace, OVERRIDES_REL_PATH);
|
|
32
32
|
const existing = existsSync(path) ? readFileSync(path, "utf8") : "";
|
|
33
|
+
// A configured overrides file is human-owned; setup must never touch it.
|
|
34
|
+
if (existing.trim() !== "") return { path, text: existing, write: false };
|
|
33
35
|
const text = mergeOverrides(existing, scan);
|
|
34
36
|
return { path, text, write: text !== existing };
|
|
35
37
|
}
|
|
@@ -45,7 +45,7 @@ const KNOWN_SECTIONS = {
|
|
|
45
45
|
"agent-hub": {
|
|
46
46
|
keys: {
|
|
47
47
|
"language": null,
|
|
48
|
-
"persona-gate":
|
|
48
|
+
"persona-gate": (value) => `ignored — dispatcher persona selection was removed; use /af-work-mode for operator|orchestrator work mode. Remove this key (was "${value}")`,
|
|
49
49
|
"rules": checkFolders("rules"),
|
|
50
50
|
"docs": checkPaths("docs entry point"),
|
|
51
51
|
"recon-search-timeout-s": oneOfIntegerOrOff(1, 3600),
|
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -10,7 +10,7 @@ the runtime responsibilities and where each module lives in the repository.
|
|
|
10
10
|
| **Pi Coding Agent** | Primary local runtime — runs the dispatcher and specialist subagents | `.pi/harnesses/`, `.pi/extensions/`, `.pi/agents/`, `.pi/prompts/` |
|
|
11
11
|
| **agent-hub** | Thin-context multi-agent harness: dispatcher + specialists + research helpers + Verification Contract | `.pi/harnesses/agent-hub/` |
|
|
12
12
|
| **Herdr** | Fleet/workspace control plane — spawns peer teams as tiled workspaces, presence via push events, snapshot/resume | [herdr.dev](https://herdr.dev); client in `.pi/harnesses/lib/herdr-client.ts`, layout in `scripts/lib/herdr-layout.ts` |
|
|
13
|
-
| **coms** | Peer communication protocol/data plane — envelope-based P2P messaging between agents | `.pi/harnesses/coms
|
|
13
|
+
| **coms** | Peer communication protocol/data plane — envelope-based P2P messaging between agents | Shared peer lifecycle in `.pi/harnesses/lib/coms-core.ts` and `coms-core-io.ts`; Pi registrations in `.pi/harnesses/coms/` and `agent-hub/`; wire helpers in `scripts/lib/coms-envelope.ts` and `scripts/coms-cli.ts` |
|
|
14
14
|
| **Claude Code bridge** | Makes an interactive Claude Code pane a bidirectional coms peer | `scripts/coms-claude-bridge.ts`, `hooks/coms-stop-hook.mjs`, `skills/peer-coms/` — see [claude-code-coms-bridge.md](claude-code-coms-bridge.md) |
|
|
15
15
|
| **Hermes bridge** | Remote human control — relays hub questions to Telegram, races phone vs. local answers, conductor/liaison skills | `scripts/coms-hermes-bridge.ts`, `.pi/harnesses/ask-user-remote/`, `hermes/skills/` — see [coms-hermes-bridge.md](coms-hermes-bridge.md) |
|
|
16
16
|
| **Hermes local monitor transport** | Local, authenticated monitor contract for Hub-owned task generations; consumers supply their own presentation | `.pi/harnesses/agent-hub/monitor-*.ts`, `.pi/harnesses/lib/hermes-monitor-{model,store,registry,socket}.ts` (with compatibility re-exports under `scripts/lib/`) — see [Hermes artifacts](../hermes/README.md#local-agent-hub-monitor-integration) and [watchdog limits](hermes-watchdog-supervisor.md) |
|
|
@@ -26,20 +26,20 @@ harness. Three independent choices shape that runtime:
|
|
|
26
26
|
|
|
27
27
|
| Axis | Choices | What it controls |
|
|
28
28
|
| --- | --- | --- |
|
|
29
|
-
| **
|
|
30
|
-
| **Native roster** | empty or one entry from `.pi/agents/teams.yaml` | Which in-process Pi specialist personas `dispatch_agent` may start. Roster changes do not change
|
|
31
|
-
| **Peer topology** | current terminal, Hub-only Herdr workspace, or Hub plus a `.pi/agents/peers.yaml` preset | Which separate, addressable Pi/Claude processes occupy sibling panes. Starting or spawning peers does not change
|
|
29
|
+
| **Work Mode** | `operator`, `orchestrator` | Whether the main agent may use direct coding tools. Operator retains the captured `read`/`bash`/`edit`/`write` and approved extension surface; orchestrator removes direct coding tools and keeps dispatch, research, assertions, `ask_user`, and available coms/Herdr tools. `/af-work-mode` and **Alt+M** switch this axis. |
|
|
30
|
+
| **Native roster** | empty or one entry from `.pi/agents/teams.yaml` | Which in-process Pi specialist personas `dispatch_agent` may start. Roster changes do not change work mode in a live session. |
|
|
31
|
+
| **Peer topology** | current terminal, Hub-only Herdr workspace, or Hub plus a `.pi/agents/peers.yaml` preset | Which separate, addressable Pi/Claude processes occupy sibling panes. Starting or spawning peers does not change work mode or the native roster. |
|
|
32
32
|
|
|
33
|
-
Bare `just fleet` therefore means operator
|
|
34
|
-
the current terminal. At startup an explicit `--
|
|
33
|
+
Bare `just fleet` therefore means operator work mode, an empty native roster, and
|
|
34
|
+
the current terminal. At startup an explicit `--work-mode` wins; otherwise
|
|
35
35
|
`--agents <roster>` implies orchestrator; otherwise operator is used. An
|
|
36
|
-
orchestrator startup requires a roster. `/af-
|
|
37
|
-
|
|
36
|
+
orchestrator startup requires a roster. `/af-work-mode` and **Alt+M** switch
|
|
37
|
+
only work mode in the live session, and `/af-agents-*` changes
|
|
38
38
|
only the native roster. Dispatch, research, nested delegation, and Verification
|
|
39
39
|
Contract rigor follow the **task tier** (`trivial`/`small`/`feature`/`project`),
|
|
40
40
|
not a session execution mode.
|
|
41
41
|
|
|
42
|
-
All Hub-owned slash commands remain registered in both
|
|
42
|
+
All Hub-owned slash commands remain registered in both work modes. Capability packs are resolved automatically from explicit task intent, work mode, tier, pending work, and compaction state—there is no activation command. Runtime **readiness** (a coms or Herdr connection) is not model-visible capability: ready-but-unrequested peer/workspace packs remain inactive. Ambiguous fleet, peer, and workspace requests are provisionally visible but require one `ask_user` confirmation before their first side effect; a rejection removes the provisional pack. Task packs persist across follow-ups and reset only through `set_task_tier(new_task: true)`, while mandatory work mode and pending-operation leases remain.
|
|
43
43
|
|
|
44
44
|
`/af-context` is a standalone, read-only full-screen budget diagnostic; it separates stable prompt cost, volatile state, active schemas, and zero-cost inactive/loaded-excluded inputs. Provider totals and cache read/write fields are authoritative where Pi supplies them; it never fabricates provider usage or combines capacity percentages across Hub, child, and peer planes. Managed specialists and research children use explicit replacement prompts/context manifests with selected persona, policy, and skill paths instead of inherited global skills/context files. Runtime gates control whether an action can proceed: without coms, Herdr, a visible target, or an active roster, the corresponding command refuses with an actionable message rather than disappearing. `--browser` and `--all-extensions` expand the captured operator surface only when those optional extensions are installed.
|
|
45
45
|
|
|
@@ -61,9 +61,9 @@ error bodies, or summaries.
|
|
|
61
61
|
|
|
62
62
|
A persisted native roster is also metadata, not copied configuration: only its team name is stored
|
|
63
63
|
and it is re-resolved against current teams and persona definitions. A stale or absent roster in a
|
|
64
|
-
resumed orchestrator session fails closed—
|
|
64
|
+
resumed orchestrator session fails closed—work mode remains orchestrator, direct tools remain removed,
|
|
65
65
|
and model input is blocked until `/af-agents-team`, an explicit `--agent-team <name>` restart, or an
|
|
66
|
-
explicit operator selection resolves it. Explicit CLI
|
|
66
|
+
explicit operator selection resolves it. Explicit CLI work mode and roster selections retain
|
|
67
67
|
precedence.
|
|
68
68
|
|
|
69
69
|
Pi's session JSONL is the authoritative append-only record for rebuilding a session, including
|
|
@@ -92,7 +92,7 @@ flowchart TD
|
|
|
92
92
|
You(["You · Hermes inbound relay · Codex outbound conductor on your phone"])
|
|
93
93
|
|
|
94
94
|
subgraph HUBL["HUB — guarded runtime (bare just fleet)"]
|
|
95
|
-
Hub["agent-hub harness<br/>operator or orchestrator
|
|
95
|
+
Hub["agent-hub harness<br/>operator or orchestrator work mode · routes tasks<br/>owns the Verification Contract on disk · keeps research dumps out of its own context"]
|
|
96
96
|
end
|
|
97
97
|
|
|
98
98
|
subgraph TEAML["OPTIONAL NATIVE ROSTER (.pi/agents/teams.yaml)"]
|
|
@@ -222,7 +222,7 @@ observed in-flight from the JSON event stream — deterministic rules (out-of-sc
|
|
|
222
222
|
against the declared `scope` globs, tool-call loops, consecutive failures, tool-call cap)
|
|
223
223
|
escalate to a one-shot cheap LLM judge whose DRIFTING/STUCK verdict terminates the run as
|
|
224
224
|
`drift_stop` (exit 125, partial output preserved); enabled per hub/agent/dispatch
|
|
225
|
-
(`watchdog` key, `/af-watchdog`, `watchdog` param). Orchestrator
|
|
225
|
+
(`watchdog` key, `/af-watchdog`, `watchdog` param). Orchestrator work mode auto-arms the
|
|
226
226
|
watchdog when the hub setting is `auto`/`on`; a dispatch `watchdog: false` cannot disarm it
|
|
227
227
|
there. Hub or per-agent `off` remains the opt-out. Two rules about scope: the session's
|
|
228
228
|
own `artifacts/`, `findings/`, and `delegations/` subtrees are implicitly in scope (the
|
|
@@ -265,6 +265,35 @@ These are the external systems Agent Fleet assumes or integrates with — not np
|
|
|
265
265
|
|
|
266
266
|
## Repository module map
|
|
267
267
|
|
|
268
|
+
### Agent Hub composition
|
|
269
|
+
|
|
270
|
+
`.pi/harnesses/agent-hub/index.ts` owns mutable Hub state and composes the extracted concerns without merging their context contracts:
|
|
271
|
+
|
|
272
|
+
```text
|
|
273
|
+
agent-hub/
|
|
274
|
+
├── index.ts # bounded composition root; constructs root-owned mutable ports
|
|
275
|
+
├── types.ts # shared Hub agent/state contracts
|
|
276
|
+
├── config/ # agent/frontmatter, teams, profiles, dispatch policy, overrides
|
|
277
|
+
├── context/ # state, budgets, assertions/artifacts, session-health factories
|
|
278
|
+
├── commands/ # 21 typed /af-* command registrars
|
|
279
|
+
├── tools/ # 16 tools plus dispatch/research execution orchestration
|
|
280
|
+
├── dispatch-core.ts # facade over native, coms, and observability dispatch
|
|
281
|
+
├── dispatch-*.ts # native preparation/spawn/completion and backend adapters
|
|
282
|
+
├── policy/ # model, roster, capability, and work-mode decisions
|
|
283
|
+
├── research/ # helper runtime, spawn transitions, and controls
|
|
284
|
+
├── ui/ # grid, dashboard, detail, context, pool, zoom, and history
|
|
285
|
+
├── input/ # shortcuts and completion derivation
|
|
286
|
+
├── lifecycle/ # turn, pressure, monitor, session, and shutdown orchestration
|
|
287
|
+
├── prompts/ # data-oriented system/session templates + HubPromptContext
|
|
288
|
+
├── session-start.ts # typed ordered session_start step runner
|
|
289
|
+
├── presentation.ts # marker, name, thinking, and delegate-path helpers
|
|
290
|
+
├── timeline.ts # bounded transcript/timeline append helpers
|
|
291
|
+
├── monitor-*.ts # local monitor transport and recovery primitives
|
|
292
|
+
└── *.test.{ts,js} # registration, loader, parity, and behavior contracts
|
|
293
|
+
```
|
|
294
|
+
|
|
295
|
+
Cross-harness coms lifecycle remains shared in `.pi/harnesses/lib/coms-core.ts` and `coms-core-io.ts`; it is not owned by the Hub composition root.
|
|
296
|
+
|
|
268
297
|
```text
|
|
269
298
|
.pi/ # Pi runtime: harnesses, extensions, agents config, prompts
|
|
270
299
|
skills/ # Agent Fleet-native skills (shadow vendored names)
|
|
@@ -180,21 +180,21 @@ each past release actually shipped, and reconciliation diffs against them.
|
|
|
180
180
|
## 4. One unified `just fleet` runtime
|
|
181
181
|
|
|
182
182
|
Pi Fleet startup is now a single guarded Agent Hub runtime. Bare `just fleet`
|
|
183
|
-
loads Fleet Core plus Agent Hub in **operator**
|
|
184
|
-
preserved, native roster empty.
|
|
183
|
+
loads Fleet Core plus Agent Hub in **operator** work mode: direct coding tools
|
|
184
|
+
preserved, native roster empty. Work Mode, native specialists, workspace
|
|
185
185
|
topology, project scope, and communication capabilities are now selected
|
|
186
186
|
independently:
|
|
187
187
|
|
|
188
188
|
```bash
|
|
189
189
|
just fleet # operator, empty native roster
|
|
190
190
|
just fleet --agents frontend # native roster; orchestrator inferred
|
|
191
|
-
just fleet --
|
|
191
|
+
just fleet --work-mode operator --agents frontend # direct work plus the same roster
|
|
192
192
|
just fleet --no-coms # direct/native work, no peer messaging
|
|
193
193
|
just fleet --herdr --project af # one Hub pane, no standing peers
|
|
194
194
|
just fleet --agents frontend --peers frontend --project af
|
|
195
195
|
```
|
|
196
196
|
|
|
197
|
-
New in the same change: live `/af-
|
|
197
|
+
New in the same change: live `/af-work-mode` switching, on-demand native roster
|
|
198
198
|
growth (`/af-agents-add`), deterministic `dispatch_agent` routing through
|
|
199
199
|
`backend: auto|native|coms`, and same-project dynamic Pi or Claude Code peer
|
|
200
200
|
spawning through Herdr.
|
|
@@ -24,7 +24,7 @@ large.
|
|
|
24
24
|
## Unified Fleet runtime configuration
|
|
25
25
|
|
|
26
26
|
A Pi workspace has one public runtime entry point. Bare Fleet loads Fleet Core
|
|
27
|
-
plus Agent Hub in **operator**
|
|
27
|
+
plus Agent Hub in **operator** work mode, in the current terminal, with no native
|
|
28
28
|
specialists active:
|
|
29
29
|
|
|
30
30
|
```bash
|
|
@@ -32,13 +32,13 @@ just fleet
|
|
|
32
32
|
just fleet --project af
|
|
33
33
|
```
|
|
34
34
|
|
|
35
|
-
|
|
35
|
+
Work mode, native roster, and peer topology are separate controls:
|
|
36
36
|
|
|
37
37
|
```bash
|
|
38
38
|
# Direct tools plus an available native roster.
|
|
39
|
-
just fleet --
|
|
39
|
+
just fleet --work-mode operator --agents frontend --project af
|
|
40
40
|
|
|
41
|
-
# A roster implies orchestrator when
|
|
41
|
+
# A roster implies orchestrator when work mode is not explicit.
|
|
42
42
|
just fleet --agents frontend --project af
|
|
43
43
|
|
|
44
44
|
# Herdr Hub-only and Hub-plus-peer topologies.
|
|
@@ -46,8 +46,8 @@ just fleet --herdr --project af
|
|
|
46
46
|
just fleet --agents frontend --peers frontend --project af
|
|
47
47
|
```
|
|
48
48
|
|
|
49
|
-
Startup precedence is deterministic: explicit `--
|
|
50
|
-
explicit `--agents` roster implies `orchestrator`; otherwise
|
|
49
|
+
Startup precedence is deterministic: explicit `--work-mode` wins; otherwise an
|
|
50
|
+
explicit `--agents` roster implies `orchestrator`; otherwise work mode is
|
|
51
51
|
`operator`. An orchestrator startup must name a roster. `--herdr` affects only
|
|
52
52
|
placement, while `--peers <preset>` implies Herdr and starts the selected peer
|
|
53
53
|
preset. Neither topology option selects a native roster.
|
|
@@ -64,7 +64,7 @@ The configuration files have distinct ownership:
|
|
|
64
64
|
| `.pi/agents/teams.yaml` | Named **native rosters** of Pi personas available to `dispatch_agent`. Bare Fleet ignores YAML ordering and starts empty; select one with `--agents`, `/af-agents-team`, or add individuals with `/af-agents-add`. |
|
|
65
65
|
| `.pi/agents/peers.yaml` | Named **standing peer presets** and each peer's runner (`pi` or `claude-code`), persona, model, extensions, and optional declared `env_file`. Select a preset with `--peers`; dynamic `herdr_spawn_peer` uses the same declaration resolver. |
|
|
66
66
|
| `.pi/agents/dispatch-policy.yaml` | Routing used only when `dispatch_agent.backend` is `auto`: native/coms preference, fallback, grace period, and peer reply timeout. |
|
|
67
|
-
| `.ai/agent-fleet-overrides.md` (`## agent-hub`) | Project-specific Hub language, model overrides, rule/doc roots, budget ceilings, watchdog, and related execution policy. It does not choose startup
|
|
67
|
+
| `.ai/agent-fleet-overrides.md` (`## agent-hub`) | Project-specific Hub language, model overrides, rule/doc roots, budget ceilings, watchdog, and related execution policy. It does not choose startup work mode or topology. |
|
|
68
68
|
|
|
69
69
|
For deterministic routing, `backend: "native"` always starts the local Pi
|
|
70
70
|
specialist even if a same-name peer is visible. `backend: "coms"` requires a
|
|
@@ -83,7 +83,7 @@ Capability flags and runtime gates fail closed:
|
|
|
83
83
|
- `--browser` adds the browser extension surface and `--all-extensions` opts
|
|
84
84
|
into the complete approved extension set. Missing optional dependencies do
|
|
85
85
|
not grant tools merely because a flag was supplied.
|
|
86
|
-
- Hub-owned slash commands remain registered in both
|
|
86
|
+
- Hub-owned slash commands remain registered in both work modes. A missing coms
|
|
87
87
|
runtime, Herdr connection, target peer, or native roster produces a
|
|
88
88
|
capability refusal rather than a missing command.
|
|
89
89
|
|
|
@@ -116,10 +116,10 @@ synthetic entries to recover from context pressure.
|
|
|
116
116
|
|
|
117
117
|
A resumed orchestrator session may instead be blocked because its persisted team name no longer
|
|
118
118
|
resolves against the current `.pi/agents/teams.yaml` and persona files. This is a fail-closed roster
|
|
119
|
-
recovery gate: orchestrator
|
|
119
|
+
recovery gate: orchestrator work mode and its direct-tool restrictions remain in force. Choose a valid
|
|
120
120
|
team with `/af-agents-team`, restart publicly with `just fleet --agents <name>`, or explicitly choose
|
|
121
|
-
operator
|
|
122
|
-
use `--agent-team <name>` or `--
|
|
121
|
+
operator work mode with `/af-work-mode operator` / `just fleet --work-mode operator`. Direct Pi launches
|
|
122
|
+
use `--agent-team <name>` or `--work-mode operator`. Explicit startup flags win over persisted state;
|
|
123
123
|
fix missing or renamed team/persona declarations before selecting them.
|
|
124
124
|
|
|
125
125
|
## The overrides file — `.ai/agent-fleet-overrides.md`
|
|
@@ -202,7 +202,7 @@ targets an end-of-session compound pass writes lessons to.
|
|
|
202
202
|
| Key | Default | Meaning |
|
|
203
203
|
|-----|---------|---------|
|
|
204
204
|
| `language` | `English` | User-facing language the dispatcher uses for every `ask_user` question, every `context` field, and every summary. Specialist task strings always stay in English regardless. |
|
|
205
|
-
| `persona-gate` |
|
|
205
|
+
| `persona-gate` | — | **Removed.** Ignored with a doctor warning; dispatcher flavor is no longer selectable. Use `/af-work-mode` for operator vs orchestrator. Delete the key. |
|
|
206
206
|
| `model.<persona>` | persona frontmatter `model:` | Replaces the named persona's default model for this project (a full pi model spec). If the override reports a model/provider error or aborted request before producing text or starting a tool (including a local-model memory-limit failure), agent-hub restores the child session and retries once with the original frontmatter model; it does not fallback after work starts, cancellation, timeout, drift stop, or process-spawn failure. |
|
|
207
207
|
| `models.<persona>` | persona frontmatter `models:` | Replaces the named persona's model-candidate list for `/af-agent-model` and `/af-models` profiles (comma-separated pi model specs). |
|
|
208
208
|
| `thinking.<persona>` | persona frontmatter `thinking:` | Replaces the named persona's pi `--thinking` reasoning level for this project: one of `off`, `minimal`, `low`, `medium`, `high`, `xhigh`. Switchable at runtime with `/af-agent-model-thinking <persona>`. An invalid value is ignored with a session-start warning. |
|
|
@@ -210,15 +210,15 @@ targets an end-of-session compound pass writes lessons to.
|
|
|
210
210
|
| `delegate-depth.<persona>` | persona frontmatter `delegate_depth:` (default/max 1) | Replaces the persona's delegation depth budget: `0` makes its delegate tool refuse (delegation off for this project), `1` lets it spawn terminal children. Values above 1 are clamped to 1; children at remaining depth 0 do not receive delegate tooling. |
|
|
211
211
|
| `rules` | none | Comma-separated repo-relative folders holding the project's own rule files (HOW — implementation patterns the work must comply with). Resolution is **index-first**: when a folder has a top-level `README.md`/`index.md`, personas read it first and follow its loading manifest (session bundles, conditional-load lists) instead of bulk-reading the tree; a folder without an index is searched **recursively** through all subfolders. The harness tells every dispatched specialist where the rules live and how to resolve them; the planner and code-reviewer personas read the relevant rules, validate their subject against them, and pass them on (cited in plan acceptance criteria / handed to delegate sub-reviewers). Missing folders produce a session-start warning. |
|
|
212
212
|
| `docs` | none | Comma-separated repo-relative documentation **entry points** (WHAT/WHY — architecture, standards, decisions): canonical files (e.g. `Docs/AGENTS.md`) or doc folders (personas start from a folder's `README.md`/index). Unlike `rules`, docs orient rather than bind: every dispatched specialist and research helper is told to read the entry points relevant to its task and follow their links instead of bulk-reading doc trees; the code-reviewer flags changes that alter documented behavior without a doc update; the documenter treats the entry points and the trees they link as the docs it maintains. Missing paths produce a session-start warning. |
|
|
213
|
-
| `research-keep` | `4` | How many **finished**
|
|
213
|
+
| `research-keep` | `4` | How many **finished** durable/persona research helpers the hub retains (LRU by finish time) for dashboard inspection or a fresh `/af-agents-restart rN`; older ones are pruned along with their session files. `all` disables the cap. Auto-research pipe helpers (spawned for `NEEDS_RESEARCH:` pauses) are always pruned as soon as they finish — their findings persist as files under `.pi/agent-sessions/findings/`. Running helpers are never pruned. An invalid value is ignored with a session-start warning. |
|
|
214
214
|
| `recon-search-timeout-s` | `120` | Parent-side deadline, in seconds, for each `read`, `grep`, `find`, or `ls` call made by a native research helper or nested delegate child. Accepts an integer `1`–`3600` or `off`; invalid input warns and falls back to `120`. This is **not** an agent/turn deadline: non-tool work can run indefinitely. On timeout the hub returns `tool_timeout` with call metadata, sends SIGTERM to its owned process group, escalates to SIGKILL after a finite grace period, and settles even if the child never closes or a descendant holds a pipe. If that bounded cleanup cannot confirm child/process-group death, the metadata reports `terminationConfirmed: false`; this prevents a parent hang but may indicate an uninterruptible OS-level process needing operator attention. |
|
|
215
215
|
| `mode` | — | **Removed.** Ignored with a warning; budgets follow task tier. Delete the key. |
|
|
216
216
|
| `max-dispatches-per-turn` | tier default (1/2/8/12) | Ceiling on `dispatch_agent` calls per user turn (`min` with the task-tier envelope). Positive integer or `off` (stays at the tier). |
|
|
217
|
-
| `max-research-per-turn` | tier default (1/2/4/6) | Ceiling on `spawn_research` calls per user turn
|
|
217
|
+
| `max-research-per-turn` | tier default (1/2/4/6) | Ceiling on dispatcher-initiated `spawn_research` calls per user turn. The automatic `NEEDS_RESEARCH:` pipe is exempt from the turn budget but still counts against the task research envelope. Positive integer or `off` (stays at the tier). |
|
|
218
218
|
| `turn-wall-time-s` | tier default (900/900/3600/5400) | Active-time ceiling, in seconds, per user turn; time blocked in `ask_user` is excluded. Once exceeded, further dispatch/research calls refuse until the one-click continuation is accepted or a new user turn begins. Positive integer or `off` (stays at the tier). |
|
|
219
219
|
| `agent-turn-timeout-s` | tier default (600/600/1800/1800) | Whole-run deadline, in seconds, for each spawned specialist, research helper, and nested delegate child (unlike `recon-search-timeout-s`, this bounds the entire run). On expiry the run terminates as `turn_timeout` (exit 124) with partial output preserved. Positive integer or `off` (stays at the tier). |
|
|
220
220
|
| `session-recycle-runs` | tier default (3/3/5/5) | Recycle a specialist's accumulated session (fresh spawn instead of `-c` resume) after this many resumed runs. Context is also always recycled at ≥60% measured context (input + cacheRead + cacheWrite). Positive integer or `off` (stays at the tier recycle count; context threshold still applies). |
|
|
221
|
-
| `watchdog` | `auto` | Drift watchdog default for dispatched specialists: `auto`/`on` arm the in-flight rules (out-of-scope writes, tool-call loops, repeated failures, tool-call cap) with LLM-judge escalation; `off` disarms. Orchestrator
|
|
221
|
+
| `watchdog` | `auto` | Drift watchdog default for dispatched specialists: `auto`/`on` arm the in-flight rules (out-of-scope writes, tool-call loops, repeated failures, tool-call cap) with LLM-judge escalation; `off` disarms. Orchestrator work mode auto-arms when the setting is `auto`/`on` and ignores a dispatch `watchdog: false`. Overridable live per hub (`/af-watchdog on\|off\|auto`) and per agent (`/af-watchdog <agent> on\|off\|clear`). A DRIFTING/STUCK verdict terminates the run as `drift_stop` (exit 125) with partial output preserved. |
|
|
222
222
|
| `watchdog-judge-model` | researcher persona's model | pi model spec for the one-shot drift judge (e.g. `openai-codex/gpt-5.3-codex-spark`). Falls back to the researcher persona's resolved model, then the dispatcher's. |
|
|
223
223
|
|
|
224
224
|
Example — switch the dispatcher to Bulgarian, pin the builder to sonnet, raise the
|
package/docs/npm-install.md
CHANGED
|
@@ -63,7 +63,7 @@ just fleet doctor # confirm the workspace is whole
|
|
|
63
63
|
|
|
64
64
|
```bash
|
|
65
65
|
just fleet doctor # exit 0 = nothing to repair, 2 = repairable findings
|
|
66
|
-
just fleet # Hub in operator
|
|
66
|
+
just fleet # Hub in operator work mode, empty native roster
|
|
67
67
|
```
|
|
68
68
|
|
|
69
69
|
From here on `just fleet setup`, `just fleet doctor`, and `just fleet uninstall`
|