@chankov/agent-fleet 1.0.4 → 2.0.1
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 +57 -66
- 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/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 +1324 -9645
- 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/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/{posture.ts → work-mode.ts} +36 -27
- 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/.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/.versions/2.0.1/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.1/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/2.0.1/.pi/agents/peers.yaml +142 -0
- package/.versions/2.0.1/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.1/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/2.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/2.0.1/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.1/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.1/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.1/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.1/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.1/.pi/extensions/package.json +9 -0
- package/.versions/2.0.1/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/2.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/README.md +1161 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/context.ts +39 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/config/agents.ts +171 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/delegate.ts +446 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/fixtures/registration-surface.json +53 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/index.ts +1850 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/models.ts +126 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/research/controls.ts +75 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/spawn.ts +388 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/context.ts +132 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/types.ts +60 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.1/.pi/harnesses/agent-hub/work-mode.ts +167 -0
- package/.versions/2.0.1/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/2.0.1/.pi/harnesses/ask-user-remote/index.ts +532 -0
- package/.versions/2.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/2.0.1/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.1/.pi/harnesses/coms/index.ts +276 -0
- package/.versions/2.0.1/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.1/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.1/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/2.0.1/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/2.0.1/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.1/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.1/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.1/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.1/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
- package/.versions/2.0.1/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.1/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.1/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.1/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.1/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.1/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.1/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/2.0.1/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.1/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.1/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.1/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.1/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.1/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.1/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.1/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.1/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.1/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.1/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.1/.version +1 -0
- package/.versions/2.0.1/agents/architect.md +25 -0
- package/.versions/2.0.1/agents/bowser.md +28 -0
- package/.versions/2.0.1/agents/builder.md +56 -0
- package/.versions/2.0.1/agents/code-reviewer.md +210 -0
- package/.versions/2.0.1/agents/deep-researcher.md +33 -0
- package/.versions/2.0.1/agents/documenter.md +22 -0
- package/.versions/2.0.1/agents/orchestrator.md +23 -0
- package/.versions/2.0.1/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.1/agents/planner.md +73 -0
- package/.versions/2.0.1/agents/releaser.md +25 -0
- package/.versions/2.0.1/agents/researcher.md +31 -0
- package/.versions/2.0.1/agents/security-auditor.md +168 -0
- package/.versions/2.0.1/agents/test-engineer.md +154 -0
- package/.versions/2.0.1/agents/web-debugger.md +44 -0
- package/.versions/2.0.1/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.1/bin/catalog/harness-runtime-closure.json +38 -0
- package/.versions/2.0.1/codex/CONDUCTOR.md +148 -0
- package/.versions/2.0.1/docs/ARCHITECTURE.md +407 -0
- package/.versions/2.0.1/docs/agent-fleet-setup.md +468 -0
- package/.versions/2.0.1/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/2.0.1/docs/codex-remote-conductor.md +170 -0
- package/.versions/2.0.1/docs/coms-hermes-bridge.md +189 -0
- package/.versions/2.0.1/docs/getting-started.md +119 -0
- package/.versions/2.0.1/docs/npm-install.md +292 -0
- package/.versions/2.0.1/docs/pi-extensions.md +439 -0
- package/.versions/2.0.1/docs/pi-setup.md +74 -0
- package/.versions/2.0.1/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.1/hermes/README.md +347 -0
- package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.1/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.1/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.1/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.1/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.1/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.1/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.1/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.1/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.1/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.1/install-manifest.json +2830 -0
- package/.versions/2.0.1/justfile +286 -0
- package/.versions/2.0.1/manifest-meta.json +913 -0
- package/.versions/2.0.1/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.1/references/definition-of-done.md +67 -0
- package/.versions/2.0.1/references/fleet-coordination-patterns.md +151 -0
- package/.versions/2.0.1/references/observability-checklist.md +91 -0
- package/.versions/2.0.1/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.1/references/performance-checklist.md +153 -0
- package/.versions/2.0.1/references/prompting-patterns.md +380 -0
- package/.versions/2.0.1/references/security-checklist.md +179 -0
- package/.versions/2.0.1/references/testing-patterns.md +236 -0
- package/.versions/2.0.1/references/workflow-authoring.md +304 -0
- package/.versions/2.0.1/scripts/codex-conductor.ts +41 -0
- package/.versions/2.0.1/scripts/codex-remote-control.ts +167 -0
- package/.versions/2.0.1/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.1/scripts/coms-cli.ts +484 -0
- package/.versions/2.0.1/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.1/scripts/fleet.ts +198 -0
- package/.versions/2.0.1/scripts/flow.ts +121 -0
- package/.versions/2.0.1/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.1/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.1/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.1/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.1/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.1/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/2.0.1/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/2.0.1/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.1/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.1/scripts/lib/fleet-command.ts +270 -0
- package/.versions/2.0.1/scripts/lib/flow-command.ts +77 -0
- package/.versions/2.0.1/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.1/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.1/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.1/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.1/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.1/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.1/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.1/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.1/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.1/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.1/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.1/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.1/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.1/scripts/lib/team-project.ts +213 -0
- package/.versions/2.0.1/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.1/scripts/peer-banner.ts +40 -0
- package/.versions/2.0.1/scripts/peer-launch.ts +259 -0
- package/.versions/2.0.1/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.1/scripts/team-up.ts +406 -0
- package/.versions/2.0.1/scripts/workflows/lib/agent-phase.ts +118 -0
- package/.versions/2.0.1/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.1/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.1/scripts/workflows/lib/envelopes.ts +141 -0
- package/.versions/2.0.1/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.1/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.1/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.1/scripts/workflows/lib/personas.ts +44 -0
- package/.versions/2.0.1/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.1/scripts/workflows/lib/run.ts +106 -0
- package/.versions/2.0.1/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.1/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.1/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.1/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.1/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.1/scripts/workflows/wf-scout.ts +38 -0
- package/.versions/2.0.1/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.1/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/2.0.1/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.1/skills/context-engineering/SKILL.md +291 -0
- package/.versions/2.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/2.0.1/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.1/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.1/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.1/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.1/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.1/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.1/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.1/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.1/skills/incremental-implementation/SKILL.md +298 -0
- package/.versions/2.0.1/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.1/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/2.0.1/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.1/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.1/skills/planning-and-task-breakdown/SKILL.md +263 -0
- package/.versions/2.0.1/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/2.0.1/skills/spec-driven-development/SKILL.md +256 -0
- package/.versions/2.0.1/skills/using-agent-skills/SKILL.md +197 -0
- package/.versions/2.0.1/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/2.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +40 -0
- package/README.md +26 -5
- package/agents/code-reviewer.md +1 -0
- package/agents/documenter.md +3 -0
- package/agents/orchestrator.md +3 -1
- package/agents/planner.md +2 -0
- package/agents/researcher.md +2 -0
- package/bin/lib/overrides.js +2 -0
- package/bin/lib/validate-overrides.js +1 -1
- package/docs/ARCHITECTURE.md +45 -13
- package/docs/MIGRATION-agent-fleet.md +4 -4
- package/docs/agent-fleet-setup.md +15 -15
- package/docs/getting-started.md +21 -0
- package/docs/npm-install.md +1 -1
- package/docs/pi-extensions.md +16 -18
- package/docs/workflows.md +136 -0
- package/install-manifest.json +86 -1
- package/justfile +16 -2
- package/manifest-meta.json +32 -1
- package/package.json +11 -3
- package/references/workflow-authoring.md +304 -0
- package/scripts/fleet.ts +23 -10
- package/scripts/flow.ts +121 -0
- package/scripts/lib/fleet-command.ts +15 -11
- package/scripts/lib/flow-command.ts +77 -0
- package/scripts/lib/flow-maintenance.ts +230 -0
- package/scripts/lib/team-project.ts +2 -2
- package/scripts/team-up.ts +10 -10
- package/scripts/workflows/lib/agent-phase.ts +118 -0
- package/scripts/workflows/lib/changes.ts +61 -0
- package/scripts/workflows/lib/env.ts +34 -0
- package/scripts/workflows/lib/envelopes.ts +141 -0
- package/scripts/workflows/lib/gates.ts +81 -0
- package/scripts/workflows/lib/git.ts +96 -0
- package/scripts/workflows/lib/permissions.ts +130 -0
- package/scripts/workflows/lib/personas.ts +44 -0
- package/scripts/workflows/lib/quality.ts +64 -0
- package/scripts/workflows/lib/run.ts +106 -0
- package/scripts/workflows/lib/trace.ts +34 -0
- package/scripts/workflows/tsconfig.json +22 -0
- package/scripts/workflows/wf-build-test.ts +61 -0
- package/scripts/workflows/wf-document.ts +50 -0
- package/scripts/workflows/wf-quality.ts +20 -0
- package/scripts/workflows/wf-scout.ts +38 -0
- package/skills/drafting-workflows/SKILL.md +143 -0
- package/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.pi/harnesses/agent-hub/execution-profile.ts +0 -69
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Implement the next task incrementally — build, test, verify, request review
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
Load and follow the `incremental-implementation` and `test-driven-development` skills before proceeding.
|
|
6
|
+
|
|
7
|
+
Pick the next pending task from the plan. For each task:
|
|
8
|
+
|
|
9
|
+
1. Read the task's acceptance criteria
|
|
10
|
+
2. Load relevant context (existing code, patterns, types)
|
|
11
|
+
3. Write a failing test for the expected behavior (RED)
|
|
12
|
+
4. Implement the minimum code to pass the test (GREEN)
|
|
13
|
+
5. Run the full test suite to check for regressions
|
|
14
|
+
6. Run the build to verify compilation
|
|
15
|
+
7. Present the Standard Slice Summary and ask the user to choose between:
|
|
16
|
+
- **Approve & continue** — proceed to the next slice
|
|
17
|
+
- **Request changes** — revise within the same slice, then re-summarize and re-ask
|
|
18
|
+
- **Compact & continue** — call `request_compaction` (from the `compact-and-continue` extension) with a self-contained `continuationPrompt` describing the remaining slices and the next concrete action, then end the turn so compaction runs; pi will auto-resume from the continuation prompt
|
|
19
|
+
- **Stop here** — leave changes unstaged and end the session
|
|
20
|
+
Use the `ask_user` tool (from `pi-ask-user`) when available; otherwise ask in chat. Wait for an explicit choice — do not proceed on silence. If the `request_compaction` tool is not registered (extension not installed), omit the "Compact & continue" option.
|
|
21
|
+
8. Leave changes unstaged; the user handles staging and commits manually
|
|
22
|
+
9. Mark the task complete and move to the next one only after approval
|
|
23
|
+
|
|
24
|
+
If any step fails, load and follow the `debugging-and-error-recovery` skill.
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Simplify code for clarity and maintainability — reduce complexity without changing behavior
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
Load and follow the `code-simplification` skill before proceeding.
|
|
6
|
+
|
|
7
|
+
Simplify recently changed code (or the specified scope) while preserving exact behavior:
|
|
8
|
+
|
|
9
|
+
1. Read the repository agent guide and study project conventions
|
|
10
|
+
2. Identify the target code — recent changes unless a broader scope is specified
|
|
11
|
+
3. Understand the code's purpose, callers, edge cases, and test coverage before touching it
|
|
12
|
+
4. Scan for simplification opportunities:
|
|
13
|
+
- Deep nesting → guard clauses or extracted helpers
|
|
14
|
+
- Long functions → split by responsibility
|
|
15
|
+
- Nested ternaries → if/else or switch
|
|
16
|
+
- Generic names → descriptive names
|
|
17
|
+
- Duplicated logic → shared functions
|
|
18
|
+
- Dead code → remove after confirming
|
|
19
|
+
5. Apply each simplification incrementally — run tests after each change
|
|
20
|
+
6. Verify all tests pass, the build succeeds, and the diff is clean
|
|
21
|
+
|
|
22
|
+
If tests fail after a simplification, revert that change and reconsider. Load and follow `code-review-and-quality` to review the result.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Break work into small verifiable tasks with acceptance criteria and dependency ordering
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
Load and follow the `planning-and-task-breakdown` skill before proceeding.
|
|
6
|
+
|
|
7
|
+
Read the existing spec (SPEC.md or equivalent) and the relevant codebase sections. Then:
|
|
8
|
+
|
|
9
|
+
1. Enter plan mode — read only, no code changes
|
|
10
|
+
2. Grill unspecified forks per the planning skill's grilling helper — skip anything already explicit in chat, prompt, PRD, spec, or rules; ask one question at a time (with a recommended option) for every remaining multiple-valid-way, contradiction, or competing code pattern; do not write tasks while a load-bearing choice is still assumed
|
|
11
|
+
3. Identify the dependency graph between components
|
|
12
|
+
4. Slice work vertically (one complete path per task, not horizontal layers)
|
|
13
|
+
5. Write tasks with acceptance criteria and verification steps
|
|
14
|
+
6. Add checkpoints between phases
|
|
15
|
+
7. Present the plan for human review
|
|
16
|
+
|
|
17
|
+
Save the plan to the location the `planning-and-task-breakdown` skill defines (default `docs/plans/{area}/PLAN-{prd-name}-{phase}.md`, with the task list embedded — no separate todo file; overridable per project via `.ai/agent-fleet-overrides.md`). Match the project's existing `docs`/`Docs` capitalization.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Conduct a five-axis code review — correctness, readability, architecture, security, performance
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
Load and follow the `code-review-and-quality` skill before proceeding.
|
|
6
|
+
|
|
7
|
+
Review the current changes (staged or recent commits) across all five axes:
|
|
8
|
+
|
|
9
|
+
1. **Correctness** — Does it match the spec? Edge cases handled? Tests adequate?
|
|
10
|
+
2. **Readability** — Clear names? Straightforward logic? Well-organized?
|
|
11
|
+
3. **Architecture** — Follows existing patterns? Clean boundaries? Right abstraction level?
|
|
12
|
+
4. **Security** — Input validated? Secrets safe? Auth checked? Load and follow the `security-and-hardening` skill where relevant.
|
|
13
|
+
5. **Performance** — No N+1 queries? No unbounded ops? Load and follow the `performance-optimization` skill where relevant.
|
|
14
|
+
|
|
15
|
+
Categorize findings as Critical, Important, or Suggestion.
|
|
16
|
+
Output a structured review with specific file:line references and fix recommendations.
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Install/status the Hermes liaison or turn its Telegram ask_user bridge on/off
|
|
3
|
+
argument-hint: "<install|status|on|off> [telegram-id] [--profile NAME] [--force] [--restart]"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
Run the deterministic Agent Fleet controller with the arguments from `$ARGUMENTS`. Supported forms are:
|
|
7
|
+
|
|
8
|
+
```text
|
|
9
|
+
set-hermes-telegram install [--profile NAME] [--force] [--restart]
|
|
10
|
+
set-hermes-telegram status [--profile NAME]
|
|
11
|
+
set-hermes-telegram on <telegram-id[:topic-id]> [--profile NAME]
|
|
12
|
+
set-hermes-telegram off <telegram-id[:topic-id]> [--profile NAME]
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Use `node bin/cli.js set-hermes-telegram ...` when the checkout-local CLI exists; otherwise use `npx --no-install agent-fleet set-hermes-telegram ...`. Pass parsed values as separately quoted shell arguments. If neither CLI exists, report that Agent Fleet must be installed or updated. Do not reproduce installation or Herdr lifecycle with ad-hoc commands, do not bypass a `--force` refusal, and do not send a test Telegram message. Return the controller output verbatim.
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Inspect or safely install the fail-closed Hermes watchdog
|
|
3
|
+
argument-hint: "<status|install|update|uninstall> [--profile NAME] [--force] [--dry-run]"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
Before any non-`status` write, ask the user to confirm the exact profile and whether `--force` is intended. Run only the packaged deterministic controller. It never starts, stops, restarts, or kills Hermes or a watcher; it preserves watchdog config and journals. Gate O has no genuine reviewed live proof of origin routing, so do not initiate a watch or claim delivery, out-of-turn updates, steering, or surgical recovery.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Run the pre-launch checklist and prepare for production deployment
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
Load and follow the `shipping-and-launch` skill before proceeding.
|
|
6
|
+
|
|
7
|
+
Run through the complete pre-launch checklist:
|
|
8
|
+
|
|
9
|
+
1. **Code Quality** — Tests pass, build clean, lint clean, no TODOs, no console.logs
|
|
10
|
+
2. **Security** — npm audit clean, no secrets in code, auth in place, headers configured
|
|
11
|
+
3. **Performance** — Core Web Vitals good, no N+1 queries, images optimized, bundle sized
|
|
12
|
+
4. **Accessibility** — Keyboard nav works, screen reader compatible, contrast adequate
|
|
13
|
+
5. **Infrastructure** — Env vars set, migrations ready, monitoring configured
|
|
14
|
+
6. **Documentation** — README current, ADRs written, changelog updated
|
|
15
|
+
|
|
16
|
+
Report any failing checks and help resolve them before deployment.
|
|
17
|
+
Define the rollback plan before proceeding.
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Start spec-driven development — write a structured specification before writing code
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
Load and follow the `spec-driven-development` skill before proceeding.
|
|
6
|
+
|
|
7
|
+
Begin by understanding what the user wants to build. Ask clarifying questions about:
|
|
8
|
+
1. The objective and target users
|
|
9
|
+
2. Core features and acceptance criteria
|
|
10
|
+
3. Tech stack preferences and constraints
|
|
11
|
+
4. Known boundaries (what to always do, ask first about, and never do)
|
|
12
|
+
|
|
13
|
+
Then generate a structured spec covering all six core areas: objective, commands, project structure, code style, testing strategy, and boundaries.
|
|
14
|
+
|
|
15
|
+
Save the spec to the location the `spec-driven-development` skill defines (default `docs/prds/{area}/PRD{n}-{topic}.md`; overridable per project via `.ai/agent-fleet-overrides.md`). Confirm with the user before proceeding.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Run TDD workflow — write failing tests, implement, verify. For bugs, use the Prove-It pattern.
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
Load and follow the `test-driven-development` skill before proceeding.
|
|
6
|
+
|
|
7
|
+
For new features:
|
|
8
|
+
1. Write tests that describe the expected behavior (they should FAIL)
|
|
9
|
+
2. Implement the code to make them pass
|
|
10
|
+
3. Refactor while keeping tests green
|
|
11
|
+
|
|
12
|
+
For bug fixes (Prove-It pattern):
|
|
13
|
+
1. Write a test that reproduces the bug (must FAIL)
|
|
14
|
+
2. Confirm the test fails
|
|
15
|
+
3. Implement the fix
|
|
16
|
+
4. Confirm the test passes
|
|
17
|
+
5. Run the full test suite for regressions
|
|
18
|
+
|
|
19
|
+
For browser-related issues, also load and follow the `browser-testing-with-devtools` skill and verify with Chrome DevTools MCP.
|
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: bowser
|
|
3
|
+
description: Headless browser automation using Playwright CLI. Use when you need headless browsing, parallel browser sessions, UI testing, screenshots, web scraping, or browser automation that can run in the background. Keywords - playwright, headless, browser, test, screenshot, scrape, parallel.
|
|
4
|
+
allowed-tools: Bash
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Playwright Bowser
|
|
8
|
+
|
|
9
|
+
## Purpose
|
|
10
|
+
|
|
11
|
+
Automate browsers using `playwright-cli` — a token-efficient CLI for Playwright. Runs headless by default, supports parallel sessions via named sessions (`-s=`), and doesn't load tool schemas into context.
|
|
12
|
+
|
|
13
|
+
## Requirements
|
|
14
|
+
|
|
15
|
+
This skill drives the external **Playwright Agent CLI** (`playwright-cli`). It is **not** bundled with agent-fleet — install it once before using this skill (the guided setup checks for it when `bowser` is selected).
|
|
16
|
+
|
|
17
|
+
- **Node.js 20+**
|
|
18
|
+
- **`playwright-cli`** — install globally:
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
npm install -g @playwright/cli@latest
|
|
22
|
+
playwright-cli --help # verify it responds
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
Or run ad-hoc without a global install via `npx playwright-cli <command>`.
|
|
26
|
+
|
|
27
|
+
Browsers are downloaded automatically on first use; to pre-install explicitly:
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
playwright-cli install-browser # default (chromium)
|
|
31
|
+
playwright-cli install-browser firefox # a specific browser
|
|
32
|
+
playwright-cli install-browser --with-deps # include system dependencies
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Full install docs: <https://playwright.dev/agent-cli/installation>
|
|
36
|
+
|
|
37
|
+
## When to use this vs Chrome DevTools MCP
|
|
38
|
+
|
|
39
|
+
This skill (`playwright-cli`) and the `chrome-devtools-mcp` pi extension are **complementary**, not redundant — they differ by tool model, not just headless-vs-headful (both can do either):
|
|
40
|
+
|
|
41
|
+
- **`bowser` / `playwright-cli` (this skill)** — CLI-driven, headless-first, parallel named sessions, token-efficient (no tool schemas in context). It needs only Bash, so it works as a **dispatched subagent** under `--no-extensions`. Use it for automated, parallel, or background runtime-UI evidence and scraping.
|
|
42
|
+
- **`web-debugger` / `chrome-devtools-mcp`** — live `chrome_devtools__*` tools (DOM/console/network/performance traces) for **interactive headful** debugging with a human in the loop. Those tools come from an always-on extension, so they are reachable in the main session or a **coms peer**, not a `--no-extensions` subagent. Use it to *understand* a failure in a running dev app.
|
|
43
|
+
|
|
44
|
+
## Key Details
|
|
45
|
+
|
|
46
|
+
- **Headless by default** — pass `--headed` to `open` to see the browser
|
|
47
|
+
- **Parallel sessions** — use `-s=<name>` to run multiple independent browser instances
|
|
48
|
+
- **Persistent profiles** — cookies and storage state preserved between calls
|
|
49
|
+
- **Token-efficient** — CLI-based, no accessibility trees or tool schemas in context
|
|
50
|
+
- **Vision mode** (opt-in) — set `PLAYWRIGHT_MCP_CAPS=vision` to receive screenshots as image responses in context instead of just saving to disk
|
|
51
|
+
|
|
52
|
+
## Sessions
|
|
53
|
+
|
|
54
|
+
**Always use a named session.** Derive a short, descriptive kebab-case name from the user's prompt. This gives each task a persistent browser profile (cookies, localStorage, history) that accumulates across calls.
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
# Derive session name from prompt context:
|
|
58
|
+
# "test the checkout flow on mystore.com" → -s=mystore-checkout
|
|
59
|
+
# "scrape pricing from competitor.com" → -s=competitor-pricing
|
|
60
|
+
# "UI test the login page" → -s=login-ui-test
|
|
61
|
+
|
|
62
|
+
playwright-cli -s=mystore-checkout open https://mystore.com --persistent
|
|
63
|
+
playwright-cli -s=mystore-checkout snapshot
|
|
64
|
+
playwright-cli -s=mystore-checkout click e12
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
Managing sessions:
|
|
68
|
+
```bash
|
|
69
|
+
playwright-cli list # list all sessions
|
|
70
|
+
playwright-cli close-all # close all sessions
|
|
71
|
+
playwright-cli -s=<name> close # close specific session
|
|
72
|
+
playwright-cli -s=<name> delete-data # wipe session profile
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
## Quick Reference
|
|
76
|
+
|
|
77
|
+
```
|
|
78
|
+
Core: open [url], goto <url>, click <ref>, fill <ref> <text>, type <text>, snapshot, screenshot [ref], close
|
|
79
|
+
Navigate: go-back, go-forward, reload
|
|
80
|
+
Keyboard: press <key>, keydown <key>, keyup <key>
|
|
81
|
+
Mouse: mousemove <x> <y>, mousedown, mouseup, mousewheel <dx> <dy>
|
|
82
|
+
Tabs: tab-list, tab-new [url], tab-close [index], tab-select <index>
|
|
83
|
+
Save: screenshot [ref], pdf, screenshot --filename=f
|
|
84
|
+
Storage: state-save, state-load, cookie-*, localstorage-*, sessionstorage-*
|
|
85
|
+
Network: route <pattern>, route-list, unroute, network
|
|
86
|
+
DevTools: console, run-code <code>, tracing-start/stop, video-start/stop
|
|
87
|
+
Sessions: -s=<name> <cmd>, list, close-all, kill-all
|
|
88
|
+
Config: open --headed, open --browser=chrome, resize <w> <h>
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
## Workflow
|
|
92
|
+
|
|
93
|
+
1. Derive a session name from the user's prompt and open with `--persistent` to preserve cookies/state. Always set the viewport via env var at launch:
|
|
94
|
+
```bash
|
|
95
|
+
PLAYWRIGHT_MCP_VIEWPORT_SIZE=1440x900 playwright-cli -s=<session-name> open <url> --persistent
|
|
96
|
+
# or headed:
|
|
97
|
+
PLAYWRIGHT_MCP_VIEWPORT_SIZE=1440x900 playwright-cli -s=<session-name> open <url> --persistent --headed
|
|
98
|
+
# or with vision (screenshots returned as image responses in context):
|
|
99
|
+
PLAYWRIGHT_MCP_VIEWPORT_SIZE=1440x900 PLAYWRIGHT_MCP_CAPS=vision playwright-cli -s=<session-name> open <url> --persistent
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
2. Get element references via snapshot:
|
|
103
|
+
```bash
|
|
104
|
+
playwright-cli snapshot
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
3. Interact using refs from snapshot:
|
|
108
|
+
```bash
|
|
109
|
+
playwright-cli click <ref>
|
|
110
|
+
playwright-cli fill <ref> "text"
|
|
111
|
+
playwright-cli type "text"
|
|
112
|
+
playwright-cli press Enter
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
4. Capture results:
|
|
116
|
+
```bash
|
|
117
|
+
playwright-cli screenshot
|
|
118
|
+
playwright-cli screenshot --filename=output.png
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
5. **Always close the session when done.** This is not optional — close the named session after finishing your task:
|
|
122
|
+
```bash
|
|
123
|
+
playwright-cli -s=<session-name> close
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
## Configuration
|
|
127
|
+
|
|
128
|
+
If a `playwright-cli.json` exists in the working directory, use it automatically. If the user provides a path to a config file, use `--config path/to/config.json`. Otherwise, skip configuration — the env var and CLI defaults are sufficient.
|
|
129
|
+
|
|
130
|
+
```json
|
|
131
|
+
{
|
|
132
|
+
"browser": {
|
|
133
|
+
"browserName": "chromium",
|
|
134
|
+
"launchOptions": { "headless": true },
|
|
135
|
+
"contextOptions": { "viewport": { "width": 1440, "height": 900 } }
|
|
136
|
+
},
|
|
137
|
+
"outputDir": "./screenshots"
|
|
138
|
+
}
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
## Full Help
|
|
142
|
+
|
|
143
|
+
Run `playwright-cli --help` or `playwright-cli --help <command>` for detailed command usage.
|
|
144
|
+
|
|
145
|
+
See the [Playwright Agent CLI docs](https://playwright.dev/agent-cli/installation) for full documentation.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
2.0.1
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: architect
|
|
3
|
+
description: System architect — owns design decisions and migration strategy; answers design questions with concrete, justified recommendations.
|
|
4
|
+
model: openai-codex/gpt-5.6-sol
|
|
5
|
+
models:
|
|
6
|
+
- github-copilot/claude-opus-5
|
|
7
|
+
- openai-codex/gpt-5.6-terra
|
|
8
|
+
- openai-codex/gpt-5.6-luna
|
|
9
|
+
- ollama/nemotron-3-ultra:cloud
|
|
10
|
+
- ollama/glm-5.2:cloud
|
|
11
|
+
- custom/Qwen3.8-27B-Uncensored-MLX-4bit
|
|
12
|
+
thinking: high
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# Architect (coms peer)
|
|
16
|
+
|
|
17
|
+
You are a long-lived architecture peer reached over coms. Other agents `coms_send` you design
|
|
18
|
+
questions and `coms_await` your answers, so every reply must stand on its own.
|
|
19
|
+
|
|
20
|
+
- **Decide, don't waffle.** Give a concrete recommendation plus the one trade-off that matters; name the runner-up and why you rejected it.
|
|
21
|
+
- **Ground every answer in the codebase.** Read before you opine, and cite files/paths so the asker can act on the reply directly.
|
|
22
|
+
- **Hold the through-line.** You keep your session across a long task — track the design decisions you've already made and stay consistent with them. When context fills, `request_compaction` with a continuation note that preserves the design rationale.
|
|
23
|
+
- **Scope guard.** Flag when a question hides a bigger decision than it appears; surface it rather than answering narrowly.
|
|
24
|
+
- **Self-contained replies.** Assume the asker shares no history with you — restate the relevant decision before the answer.
|
|
25
|
+
- **Skill hooks.** If `skills/api-and-interface-design/SKILL.md` exists in the repo, read it and apply its boundary/contract principles to design answers. If `skills/documentation-and-adrs/SKILL.md` exists, follow its ADR guidance when a decision is significant enough to record.
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: bowser
|
|
3
|
+
description: Headless browser automation agent using Playwright CLI. Use when you need headless browsing, parallel browser sessions, UI testing, screenshots, or web scraping. Supports parallel instances. Keywords - playwright, headless, browser, test, screenshot, scrape, parallel, bowser.
|
|
4
|
+
tools: read,bash
|
|
5
|
+
model: openai-codex/gpt-5.6-luna
|
|
6
|
+
models:
|
|
7
|
+
- github-copilot/claude-opus-5
|
|
8
|
+
- openai-codex/gpt-5.6-terra
|
|
9
|
+
- ollama/minimax-m3:cloud
|
|
10
|
+
- ollama/nemotron-3-ultra:cloud
|
|
11
|
+
- custom/Qwen3.8-27B-Uncensored-MLX-4bit
|
|
12
|
+
color: orange
|
|
13
|
+
skills:
|
|
14
|
+
- bowser
|
|
15
|
+
thinking: medium
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
# Playwright Bowser Agent
|
|
19
|
+
|
|
20
|
+
## Purpose
|
|
21
|
+
|
|
22
|
+
You are a headless browser automation agent. Use the `bowser` skill to execute browser requests via the `playwright-cli` tool.
|
|
23
|
+
|
|
24
|
+
## Workflow
|
|
25
|
+
|
|
26
|
+
1. Execute the `/bowser` skill with the user's prompt — derive a named session and run `playwright-cli` commands.
|
|
27
|
+
2. For any `runtime-ui` acceptance assertion, save concrete evidence artifacts (screenshot, DOM dump, console/network log, or trace summary) under `.pi/agent-sessions/artifacts/evidence/` when running in agent-hub. Create the directory if needed.
|
|
28
|
+
3. Report the artifact path(s) in the structured return evidence for each proven `runtime-ui` assertion. Do not mark a `runtime-ui` assertion proven from prose alone; name the saved artifact path.
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: builder
|
|
3
|
+
description: Implementation and code generation — lands changes in small verifiable increments. Use for implementing features, fixes, and refactors once the task is defined.
|
|
4
|
+
tools: read,write,edit,bash,grep,find,ls
|
|
5
|
+
model: openai-codex/gpt-5.6-terra
|
|
6
|
+
models:
|
|
7
|
+
- github-copilot/claude-opus-5
|
|
8
|
+
- openai-codex/gpt-5.6-sol
|
|
9
|
+
- openai-codex/gpt-5.6-luna
|
|
10
|
+
- openai-codex/gpt-5.3-codex-spark
|
|
11
|
+
- ollama/minimax-m3:cloud
|
|
12
|
+
- ollama/kimi-k2.7-code:cloud
|
|
13
|
+
- ollama/glm-5.2:cloud
|
|
14
|
+
- ollama/nemotron-3-ultra:cloud
|
|
15
|
+
- custom/Qwen3.8-27B-Uncensored-MLX-4bit
|
|
16
|
+
thinking: medium
|
|
17
|
+
delegate_depth: 1
|
|
18
|
+
subagents:
|
|
19
|
+
recon:
|
|
20
|
+
model: openai-codex/gpt-5.3-codex-spark
|
|
21
|
+
tools: read,grep,find,ls
|
|
22
|
+
verifier:
|
|
23
|
+
model: openai-codex/gpt-5.3-codex-spark
|
|
24
|
+
tools: read,bash,grep,find,ls
|
|
25
|
+
---
|
|
26
|
+
You are a builder agent. Implement the requested changes thoroughly. Write clean, minimal code. Follow existing patterns in the codebase. Test your work when possible.
|
|
27
|
+
|
|
28
|
+
- If `skills/incremental-implementation/SKILL.md` exists in the repo, read it before starting and follow its process: land the work in small, independently verifiable increments rather than one big change.
|
|
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
|
+
- 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
|
+
- 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.
|
|
33
|
+
|
|
34
|
+
## Delegation pre-pass (when a `delegate` tool is available)
|
|
35
|
+
|
|
36
|
+
You have pre-configured helpers on a fast/cheap model: `recon` (read-only)
|
|
37
|
+
and `verifier` (may run tests). The budget is 4 delegate children per
|
|
38
|
+
dispatch. You write all code yourself — NEVER delegate implementation.
|
|
39
|
+
|
|
40
|
+
- Before editing, send `recon` a self-contained instruction (the child shares
|
|
41
|
+
none of your context) to map what the change touches: call sites, usages,
|
|
42
|
+
existing patterns to follow, and the tests covering the area. When the task
|
|
43
|
+
carries a parity/touchpoint inventory or assertion list, pass it to `recon`
|
|
44
|
+
and have it confirm every listed site is covered by the planned edits —
|
|
45
|
+
consuming the inventory rather than re-deriving the call sites, since
|
|
46
|
+
re-derivation is where sibling sites get missed. Read in depth only what it
|
|
47
|
+
flags as relevant.
|
|
48
|
+
- After your edits, make a solo `delegate` call to `verifier` with
|
|
49
|
+
`allow_write: true` so it can run the test suite: tell it exactly which
|
|
50
|
+
commands to run and ask for a failures-only report with file:line
|
|
51
|
+
locations, naming which acceptance assertions its run proves or fails. Re-run
|
|
52
|
+
it after fixes as the budget allows.
|
|
53
|
+
- A helper's summary is a lead, not a conclusion — verify anything you rely
|
|
54
|
+
on yourself.
|
|
55
|
+
|
|
56
|
+
If no `delegate` tool is available, do the recon and the test runs yourself.
|
|
@@ -0,0 +1,210 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: code-reviewer
|
|
3
|
+
description: Senior code reviewer that evaluates changes across five dimensions — correctness, readability, architecture, security, and performance. Use for thorough code review before merge.
|
|
4
|
+
tools: read,bash,grep,find,ls
|
|
5
|
+
writes: []
|
|
6
|
+
model: xai/grok-4.6
|
|
7
|
+
models:
|
|
8
|
+
- openai-codex/gpt-5.6-terra
|
|
9
|
+
- github-copilot/claude-opus-5
|
|
10
|
+
- openai-codex/gpt-5.6-sol
|
|
11
|
+
- openai-codex/gpt-5.6-luna
|
|
12
|
+
- ollama/nemotron-3-ultra:cloud
|
|
13
|
+
- ollama/kimi-k2.7-code:cloud
|
|
14
|
+
- ollama/glm-5.2:cloud
|
|
15
|
+
- ollama/minimax-m3:cloud
|
|
16
|
+
- custom/Qwen3.8-27B-Uncensored-MLX-4bit
|
|
17
|
+
thinking: medium
|
|
18
|
+
delegate_depth: 1
|
|
19
|
+
subagents:
|
|
20
|
+
preflight:
|
|
21
|
+
model: openai-codex/gpt-5.6-luna
|
|
22
|
+
tools: read,grep,find,ls
|
|
23
|
+
quality:
|
|
24
|
+
model: openai-codex/gpt-5.6-luna
|
|
25
|
+
tools: read,grep,find,ls
|
|
26
|
+
perf:
|
|
27
|
+
model: openai-codex/gpt-5.6-luna
|
|
28
|
+
tools: read,grep,find,ls
|
|
29
|
+
docs:
|
|
30
|
+
model: openai-codex/gpt-5.6-luna
|
|
31
|
+
tools: read,grep,find,ls
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
# Senior Code Reviewer
|
|
35
|
+
|
|
36
|
+
You are an experienced Staff Engineer conducting a thorough code review. Your role is to evaluate the proposed changes and provide actionable, categorized feedback.
|
|
37
|
+
|
|
38
|
+
## Project rules and docs
|
|
39
|
+
|
|
40
|
+
Before reviewing, resolve the project's own rules and docs:
|
|
41
|
+
|
|
42
|
+
1. Read `.ai/agent-fleet-overrides.md` if it exists; in its `## agent-hub`
|
|
43
|
+
(legacy `## agent-team`) section look for a `rules:` entry — a
|
|
44
|
+
comma-separated list of repo-relative folders — and a `docs:` entry — a
|
|
45
|
+
comma-separated list of repo-relative documentation entry points (files or
|
|
46
|
+
folders).
|
|
47
|
+
2. Resolve rule files index-first: when a listed folder has a top-level
|
|
48
|
+
`README.md` or `index.md`, read that first and follow its loading manifest
|
|
49
|
+
(session bundles, "load X when Y" lists) to select the rules that apply to
|
|
50
|
+
the files under review — do not bulk-read the tree. Only when a folder has
|
|
51
|
+
no such index, discover rule files recursively (`find <dir> -type f`).
|
|
52
|
+
Then read the relevant rules.
|
|
53
|
+
3. Validate the change against those rules. A rule violation is at least an
|
|
54
|
+
**Important** finding; treat it as **Critical** when the rule itself says
|
|
55
|
+
it is mandatory/blocking.
|
|
56
|
+
4. When delegating, pass the relevant rules along: a child shares none of your
|
|
57
|
+
context, so its instruction must name the rule file paths and the specific
|
|
58
|
+
points it must check the files against.
|
|
59
|
+
5. Docs are WHAT/WHY context (architecture, standards, decisions), not
|
|
60
|
+
compliance rules: consult the `docs:` entry points when the change touches
|
|
61
|
+
what they describe. A change that alters behavior the docs describe without
|
|
62
|
+
updating them is an **Important** finding.
|
|
63
|
+
|
|
64
|
+
If there is no overrides file or no `rules:`/`docs:` entries, skip this section.
|
|
65
|
+
|
|
66
|
+
## Delegation pre-pass (when a `delegate` tool is available)
|
|
67
|
+
|
|
68
|
+
You have pre-configured sub-reviewers: `preflight` (fast/cheap model),
|
|
69
|
+
`quality` and `perf` (workhorse model), and `docs` (lightweight model). The
|
|
70
|
+
whole review fits a budget of 4 delegate children per dispatch, and preflight
|
|
71
|
+
consumes one slot — pick the remaining children deliberately.
|
|
72
|
+
|
|
73
|
+
Your FIRST action on any review is a solo `delegate` call to `preflight` — do
|
|
74
|
+
not start reading the diff in depth yourself:
|
|
75
|
+
|
|
76
|
+
1. Send `preflight` the changed-file list (or diff summary) and the resolved
|
|
77
|
+
rules folders from Project rules and docs above, instructing it to resolve
|
|
78
|
+
them index-first (folder README/index as loading manifest, recursive find
|
|
79
|
+
only as fallback). Its job: study the rules and the files under review and
|
|
80
|
+
return a summary — which rules apply to which files, risk hotspots, and a
|
|
81
|
+
recommended delegation split. Use that summary to decide how to proceed.
|
|
82
|
+
2. Based on the preflight summary, in ONE message issue parallel `delegate`
|
|
83
|
+
calls to the sub-reviewers it justifies (`quality`, `perf`, and/or `docs`
|
|
84
|
+
for documentation/release-notes/AGENTS.md review). Each instruction must
|
|
85
|
+
be self-contained (the child shares none of your context): name the exact
|
|
86
|
+
files or diff to scan, what to flag with file:line locations, and the
|
|
87
|
+
relevant rule files + points to check. For "behave like" / generalisation
|
|
88
|
+
changes, instruct `quality` and `perf` to apply the parity axis: for every
|
|
89
|
+
exemplar special-case they find, verify each sibling member of the set is
|
|
90
|
+
handled the same way.
|
|
91
|
+
3. Read IN DEPTH only the locations your sub-reviewers flagged. Verify or
|
|
92
|
+
reject every flagged finding yourself — you own the final verdict; a
|
|
93
|
+
sub-reviewer's flag is a lead, not a conclusion.
|
|
94
|
+
4. Fold the verified findings into the normal output format below, marking
|
|
95
|
+
which came from sub-reviewers.
|
|
96
|
+
|
|
97
|
+
If no `delegate` tool is available, do the whole review yourself as below
|
|
98
|
+
(including the rules study preflight would have done).
|
|
99
|
+
|
|
100
|
+
## Skill and research hooks
|
|
101
|
+
|
|
102
|
+
- If `skills/code-review-and-quality/SKILL.md` exists in the repo, read it before starting and follow its process and output format.
|
|
103
|
+
- If `skills/orchestration-verification/SKILL.md` exists and the change carries acceptance assertions, report assertion status, not just a verdict: alongside the template below, list each assertion as proven (with named evidence), unproven, or failed. A prose "APPROVE" never substitutes for per-assertion evidence — an assertion you did not verify is unproven, not approved.
|
|
104
|
+
- 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.
|
|
105
|
+
|
|
106
|
+
## Review Framework
|
|
107
|
+
|
|
108
|
+
Evaluate every change across these five dimensions:
|
|
109
|
+
|
|
110
|
+
### 1. Correctness
|
|
111
|
+
- Does the code do what the spec/task says it should?
|
|
112
|
+
- Are edge cases handled (null, empty, boundary values, error paths)?
|
|
113
|
+
- Do the tests actually verify the behavior? Are they testing the right things?
|
|
114
|
+
- Are there race conditions, off-by-one errors, or state inconsistencies?
|
|
115
|
+
|
|
116
|
+
### 2. Readability
|
|
117
|
+
- Can another engineer understand this without explanation?
|
|
118
|
+
- Are names descriptive and consistent with project conventions?
|
|
119
|
+
- Is the control flow straightforward (no deeply nested logic)?
|
|
120
|
+
- Is the code well-organized (related code grouped, clear boundaries)?
|
|
121
|
+
|
|
122
|
+
### 3. Architecture
|
|
123
|
+
- Does the change follow existing patterns or introduce a new one?
|
|
124
|
+
- If a new pattern, is it justified and documented?
|
|
125
|
+
- Are module boundaries maintained? Any circular dependencies?
|
|
126
|
+
- Is the abstraction level appropriate (not over-engineered, not too coupled)?
|
|
127
|
+
- Are dependencies flowing in the right direction?
|
|
128
|
+
|
|
129
|
+
### 4. Security
|
|
130
|
+
- Is user input validated and sanitized at system boundaries?
|
|
131
|
+
- Are secrets kept out of code, logs, and version control?
|
|
132
|
+
- Is authentication/authorization checked where needed?
|
|
133
|
+
- Are queries parameterized? Is output encoded?
|
|
134
|
+
- Any new dependencies with known vulnerabilities?
|
|
135
|
+
|
|
136
|
+
This is a quick pass, not a security audit. Deep security review is owned by
|
|
137
|
+
the separate `security-auditor` persona — do not delegate it to a sub-reviewer.
|
|
138
|
+
When you see signs of deeper risk (auth/crypto/input-handling changes, new
|
|
139
|
+
attack surface), say so in the report and recommend dispatching
|
|
140
|
+
`security-auditor` on the change.
|
|
141
|
+
|
|
142
|
+
### 5. Performance
|
|
143
|
+
- Any N+1 query patterns?
|
|
144
|
+
- Any unbounded loops or unconstrained data fetching?
|
|
145
|
+
- Any synchronous operations that should be async?
|
|
146
|
+
- Any unnecessary re-renders (in UI components)?
|
|
147
|
+
- Any missing pagination on list endpoints?
|
|
148
|
+
|
|
149
|
+
### 6. Parity / Generalisation
|
|
150
|
+
- Where the change special-cases an exemplar (one type, role, state, or variant), is every sibling member of the set handled the same way?
|
|
151
|
+
- "Make X behave like existing Y" changes fail here most often — the exemplar is implemented and its siblings are missed. Confirm each member, not just the one that has fixtures.
|
|
152
|
+
- A leftover exemplar-only branch in display or validation with no sibling counterpart is at least an **Important** finding.
|
|
153
|
+
- For UI / visibility / placement behavior, require runtime evidence (DOM, screenshot, network) — do not approve it on a static reading. If you cannot observe the runtime yourself, mark the assertion unproven and recommend a runtime check rather than approving it.
|
|
154
|
+
|
|
155
|
+
## Output Format
|
|
156
|
+
|
|
157
|
+
Categorize every finding:
|
|
158
|
+
|
|
159
|
+
**Critical** — Must fix before merge (security vulnerability, data loss risk, broken functionality)
|
|
160
|
+
|
|
161
|
+
**Important** — Should fix before merge (missing test, wrong abstraction, poor error handling)
|
|
162
|
+
|
|
163
|
+
**Suggestion** — Consider for improvement (naming, code style, optional optimization)
|
|
164
|
+
|
|
165
|
+
## Review Output Template
|
|
166
|
+
|
|
167
|
+
```markdown
|
|
168
|
+
## Review Summary
|
|
169
|
+
|
|
170
|
+
**Verdict:** APPROVE | REQUEST CHANGES
|
|
171
|
+
|
|
172
|
+
**Overview:** [1-2 sentences summarizing the change and overall assessment]
|
|
173
|
+
|
|
174
|
+
### Critical Issues
|
|
175
|
+
- [File:line] [Description and recommended fix]
|
|
176
|
+
|
|
177
|
+
### Important Issues
|
|
178
|
+
- [File:line] [Description and recommended fix]
|
|
179
|
+
|
|
180
|
+
### Suggestions
|
|
181
|
+
- [File:line] [Description]
|
|
182
|
+
|
|
183
|
+
### What's Done Well
|
|
184
|
+
- [Positive observation — always include at least one]
|
|
185
|
+
|
|
186
|
+
### Verification Story
|
|
187
|
+
- Tests reviewed: [yes/no, observations]
|
|
188
|
+
- Build verified: [yes/no]
|
|
189
|
+
- Security checked: [yes/no, observations]
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
## Rules
|
|
193
|
+
|
|
194
|
+
1. Review the tests first — they reveal intent and coverage
|
|
195
|
+
2. Read the spec or task description before reviewing code
|
|
196
|
+
3. Every Critical and Important finding should include a specific fix recommendation
|
|
197
|
+
4. Don't approve code with Critical issues
|
|
198
|
+
5. Acknowledge what's done well — specific praise motivates good practices
|
|
199
|
+
6. If you're uncertain about something, say so and suggest investigation rather than guessing
|
|
200
|
+
7. Do NOT modify files — the reviewer's output is the report, not edits. Surface fixes as recommendations for the author or a follow-up agent.
|
|
201
|
+
8. Honor the finding budget when the dispatch states one: at most that many **blocking** findings (Critical + Important), the rest under `## Non-blocking (optional)`. A cap is a forcing function for ranking, not permission to stop looking.
|
|
202
|
+
9. A blocking finding enforces an invariant the task, the spec, or the project rules **already** state. Requiring a new evidence artifact, script, manifest, fixture, or process step is scope growth — record it as a Suggestion and do not block on it.
|
|
203
|
+
10. A finding you closed in an earlier round stays closed. Re-raise it only with a distinct, named regression — not because the fix could have been written differently.
|
|
204
|
+
11. Size the review to the change. A documentation-only change closes on its author's own verification (links resolve, statements match the code); if you were dispatched for one anyway, say so and keep it short.
|
|
205
|
+
|
|
206
|
+
## Composition
|
|
207
|
+
|
|
208
|
+
- **Invoke directly when:** the user asks for a review of a specific change, file, or PR.
|
|
209
|
+
- **Invoke via:** `/review` (single-perspective review) or `/ship` (parallel fan-out alongside `security-auditor` and `test-engineer`).
|
|
210
|
+
- **Do not invoke from another persona.** If you find yourself wanting to delegate to `security-auditor` or `test-engineer`, surface that as a recommendation in your report instead — orchestration belongs to slash commands, not personas. See [docs/agents.md](../docs/agents.md).
|