@chankov/agent-fleet 2.0.6 → 2.0.8
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/agent-fleet/hermes/README.md +347 -0
- package/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
- package/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
- package/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
- package/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
- package/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
- package/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
- package/.pi/agent-fleet/scripts/fleet.ts +216 -0
- package/.pi/agent-fleet/scripts/flow.ts +137 -0
- package/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
- package/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
- package/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
- package/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
- package/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
- package/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
- package/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
- package/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
- package/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
- package/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
- package/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
- package/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
- package/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
- package/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
- package/.pi/agent-fleet/scripts/team-up.ts +378 -0
- package/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +133 -0
- package/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
- package/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
- package/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
- package/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
- package/.pi/agents/peers.yaml +3 -1
- package/.pi/harnesses/agent-hub/README.md +1 -1
- package/.pi/harnesses/agent-hub/config/agents.ts +5 -1
- package/.pi/harnesses/agent-hub/debate-command.ts +1 -1
- package/.pi/harnesses/agent-hub/index.ts +19 -19
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/peer-spawn-plan.ts +1 -1
- package/.pi/harnesses/agent-hub/tools/fleet-tools.ts +3 -5
- package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +2 -2
- package/.pi/harnesses/ask-user-remote/index.ts +2 -2
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/README.md +11 -0
- package/.pi/harnesses/damage-control-continue/index.ts +5 -0
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/spawned-peers.js +1 -1
- package/.pi/harnesses/lib/update-check.ts +222 -0
- package/.pi/prompts/af-constraints.md +31 -0
- package/.versions/2.0.7/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.7/.pi/agents/model-profiles.yaml +83 -0
- package/.versions/2.0.7/.pi/agents/peers.yaml +145 -0
- package/.versions/2.0.7/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.7/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.7/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.7/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.7/.pi/extensions/btw/index.ts +914 -0
- package/{.pi/extensions/agent-fleet-update-check → .versions/2.0.7/.pi/extensions/btw}/package.json +1 -1
- package/.versions/2.0.7/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.7/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.7/.pi/extensions/package.json +9 -0
- package/.versions/2.0.7/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/2.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/README.md +1203 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/acceptance.ts +62 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/context.ts +43 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/config/agents.ts +173 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/delegate.ts +446 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/index.ts +2151 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/no-progress.ts +76 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/scope-gate.js +123 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/spawn.ts +404 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/context.ts +134 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/types.ts +63 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/work-mode.ts +167 -0
- package/.versions/2.0.7/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.7/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.7/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.7/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.7/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
- package/.versions/2.0.7/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.7/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.7/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.7/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.7/.pi/harnesses/damage-control-continue/README.md +135 -0
- package/.versions/2.0.7/.pi/harnesses/damage-control-continue/index.ts +541 -0
- package/.versions/2.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.7/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.7/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.7/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.7/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
- package/.versions/2.0.7/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.7/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.7/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.7/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.7/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/2.0.7/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.7/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.7/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.7/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.7/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.7/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.7/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.7/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.7/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.7/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.7/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.7/.version +1 -0
- package/.versions/2.0.7/agents/architect.md +25 -0
- package/.versions/2.0.7/agents/bowser.md +28 -0
- package/.versions/2.0.7/agents/builder.md +56 -0
- package/.versions/2.0.7/agents/code-reviewer.md +210 -0
- package/.versions/2.0.7/agents/deep-researcher.md +33 -0
- package/.versions/2.0.7/agents/documenter.md +23 -0
- package/.versions/2.0.7/agents/orchestrator.md +23 -0
- package/.versions/2.0.7/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.7/agents/planner.md +106 -0
- package/.versions/2.0.7/agents/releaser.md +25 -0
- package/.versions/2.0.7/agents/researcher.md +31 -0
- package/.versions/2.0.7/agents/security-auditor.md +168 -0
- package/.versions/2.0.7/agents/test-engineer.md +154 -0
- package/.versions/2.0.7/agents/web-debugger.md +44 -0
- package/.versions/2.0.7/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.7/bin/catalog/harness-runtime-closure.json +31 -0
- package/.versions/2.0.7/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.7/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.7/docs/ARCHITECTURE.md +407 -0
- package/.versions/2.0.7/docs/agent-fleet-setup.md +561 -0
- package/.versions/2.0.7/docs/claude-code-coms-bridge.md +133 -0
- package/.versions/2.0.7/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.7/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.7/docs/getting-started.md +126 -0
- package/.versions/2.0.7/docs/npm-install.md +327 -0
- package/.versions/2.0.7/docs/pi-extensions.md +446 -0
- package/.versions/2.0.7/docs/pi-setup.md +76 -0
- package/.versions/2.0.7/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.7/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.7/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.7/install-manifest.json +2886 -0
- package/.versions/2.0.7/justfile +247 -0
- package/.versions/2.0.7/manifest-meta.json +958 -0
- package/.versions/2.0.7/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.7/references/communication-contract.md +26 -0
- package/.versions/2.0.7/references/definition-of-done.md +67 -0
- package/.versions/2.0.7/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.7/references/observability-checklist.md +91 -0
- package/.versions/2.0.7/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.7/references/performance-checklist.md +153 -0
- package/.versions/2.0.7/references/prompting-patterns.md +380 -0
- package/.versions/2.0.7/references/security-checklist.md +179 -0
- package/.versions/2.0.7/references/testing-patterns.md +236 -0
- package/.versions/2.0.7/references/workflow-authoring.md +304 -0
- package/.versions/2.0.7/scripts/fleet-codex-client.ts +69 -0
- package/{scripts → .versions/2.0.7/scripts}/fleet.ts +1 -1
- package/.versions/2.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.7/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.7/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.7/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.7/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.7/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.7/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.7/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.7/scripts/lib/flow-command.ts +93 -0
- package/.versions/2.0.7/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.7/scripts/package-lock.json +35 -0
- package/.versions/2.0.7/scripts/package.json +9 -0
- package/.versions/2.0.7/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.7/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.7/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.7/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.7/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.7/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.7/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.7/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.7/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.7/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.7/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.7/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.7/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.7/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.7/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.7/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.7/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.7/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.7/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.7/scripts/workflows/wf-scout.ts +38 -0
- package/.versions/2.0.7/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.7/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.7/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/2.0.7/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.7/skills/context-engineering/SKILL.md +291 -0
- package/.versions/2.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/2.0.7/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.7/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.7/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.7/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.7/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.7/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.7/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.7/skills/incremental-implementation/SKILL.md +298 -0
- package/.versions/2.0.7/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.7/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/2.0.7/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.7/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.7/skills/planning-and-task-breakdown/SKILL.md +265 -0
- package/.versions/2.0.7/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/2.0.7/skills/spec-driven-development/SKILL.md +256 -0
- package/.versions/2.0.7/skills/using-agent-skills/SKILL.md +197 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/README.md +347 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.8/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/fleet.ts +216 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/flow.ts +137 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/package-lock.json +35 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/package.json +9 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/team-up.ts +378 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +133 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-scout.ts +38 -0
- package/.versions/2.0.8/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.8/.pi/agents/model-profiles.yaml +83 -0
- package/.versions/2.0.8/.pi/agents/peers.yaml +147 -0
- package/.versions/2.0.8/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.8/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.8/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.8/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.8/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.8/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.8/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.8/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.8/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.8/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.8/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.8/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.8/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.8/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.8/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.8/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.8/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.8/.pi/extensions/package.json +9 -0
- package/.versions/2.0.8/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/2.0.8/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.8/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.8/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.8/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.8/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.8/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/README.md +1203 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/acceptance.ts +62 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/context.ts +43 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/config/agents.ts +177 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/delegate.ts +446 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/index.ts +2151 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/no-progress.ts +76 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/scope-gate.js +123 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/spawn.ts +404 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/context.ts +134 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/types.ts +63 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/work-mode.ts +167 -0
- package/.versions/2.0.8/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.8/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.8/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.8/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.8/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
- package/.versions/2.0.8/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.8/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.8/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.8/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.8/.pi/harnesses/damage-control-continue/README.md +135 -0
- package/.versions/2.0.8/.pi/harnesses/damage-control-continue/index.ts +541 -0
- package/.versions/2.0.8/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.8/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.8/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.8/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.8/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.8/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
- package/.versions/2.0.8/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.8/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.8/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.8/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.8/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.8/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.8/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/2.0.8/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.8/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.8/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.8/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.8/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.8/.pi/prompts/af-constraints.md +31 -0
- package/.versions/2.0.8/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.8/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.8/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.8/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.8/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.8/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.8/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.8/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.8/.version +1 -0
- package/.versions/2.0.8/agents/architect.md +25 -0
- package/.versions/2.0.8/agents/bowser.md +28 -0
- package/.versions/2.0.8/agents/builder.md +56 -0
- package/.versions/2.0.8/agents/code-reviewer.md +210 -0
- package/.versions/2.0.8/agents/deep-researcher.md +33 -0
- package/.versions/2.0.8/agents/documenter.md +23 -0
- package/.versions/2.0.8/agents/orchestrator.md +23 -0
- package/.versions/2.0.8/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.8/agents/planner.md +106 -0
- package/.versions/2.0.8/agents/releaser.md +25 -0
- package/.versions/2.0.8/agents/researcher.md +31 -0
- package/.versions/2.0.8/agents/security-auditor.md +168 -0
- package/.versions/2.0.8/agents/test-engineer.md +154 -0
- package/.versions/2.0.8/agents/web-debugger.md +44 -0
- package/.versions/2.0.8/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.8/bin/catalog/harness-runtime-closure.json +32 -0
- package/.versions/2.0.8/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.8/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.8/docs/ARCHITECTURE.md +416 -0
- package/.versions/2.0.8/docs/agent-fleet-setup.md +568 -0
- package/.versions/2.0.8/docs/claude-code-coms-bridge.md +134 -0
- package/.versions/2.0.8/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.8/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.8/docs/getting-started.md +126 -0
- package/.versions/2.0.8/docs/npm-install.md +356 -0
- package/.versions/2.0.8/docs/pi-extensions.md +446 -0
- package/.versions/2.0.8/docs/pi-setup.md +76 -0
- package/.versions/2.0.8/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.8/install-manifest.json +2991 -0
- package/.versions/2.0.8/justfile +247 -0
- package/.versions/2.0.8/manifest-meta.json +970 -0
- package/.versions/2.0.8/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.8/references/communication-contract.md +26 -0
- package/.versions/2.0.8/references/definition-of-done.md +67 -0
- package/.versions/2.0.8/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.8/references/observability-checklist.md +92 -0
- package/.versions/2.0.8/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.8/references/performance-checklist.md +236 -0
- package/.versions/2.0.8/references/prompting-patterns.md +380 -0
- package/.versions/2.0.8/references/security-checklist.md +245 -0
- package/.versions/2.0.8/references/testing-patterns.md +235 -0
- package/.versions/2.0.8/references/workflow-authoring.md +304 -0
- package/.versions/2.0.8/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.8/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.8/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.8/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.8/skills/constraint-driven-development/SKILL.md +338 -0
- package/.versions/2.0.8/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.8/skills/context-engineering/SKILL.md +341 -0
- package/.versions/2.0.8/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.8/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.8/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.8/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.8/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.8/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.8/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.8/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.8/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.8/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.8/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.8/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.8/skills/incremental-implementation/SKILL.md +302 -0
- package/.versions/2.0.8/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.8/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/2.0.8/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.8/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.8/skills/planning-and-task-breakdown/SKILL.md +289 -0
- package/.versions/2.0.8/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.8/skills/spec-driven-development/SKILL.md +295 -0
- package/.versions/2.0.8/skills/using-agent-skills/SKILL.md +198 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/README.md +430 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
- package/CHANGELOG.md +47 -0
- package/README.md +24 -16
- package/bin/catalog/harness-runtime-closure.json +23 -22
- package/bin/cli.js +173 -79
- package/bin/lib/apply.js +59 -64
- package/bin/lib/detect-agent.js +1 -1
- package/bin/lib/doctor.js +3 -3
- package/bin/lib/features.js +2 -2
- package/bin/lib/manifest.js +23 -16
- package/bin/lib/path-boundaries.js +96 -0
- package/bin/lib/personas.js +15 -2
- package/bin/lib/public-plan.js +17 -0
- package/bin/lib/purge.js +9 -3
- package/bin/lib/reconcile.js +4 -10
- package/bin/lib/repair-desired.js +73 -0
- package/bin/lib/set-hermes-telegram.js +2 -2
- package/bin/lib/set-hermes-watchdog.js +1 -1
- package/bin/lib/state.js +5 -1
- package/bin/lib/stt-wizard.js +25 -11
- package/bin/lib/transaction.js +118 -108
- package/bin/lib/tui.js +70 -65
- package/bin/lib/update-notifier.js +2 -2
- package/bin/lib/verify.js +43 -5
- package/bin/lib/workspace-safety.js +72 -0
- package/bin/snapshot-version.js +6 -6
- package/codex/fleet-session-client/SKILL.md +3 -3
- package/docs/ARCHITECTURE.md +29 -20
- package/docs/MIGRATION-agent-fleet.md +11 -7
- package/docs/agent-fleet-setup.md +9 -2
- package/docs/claude-code-coms-bridge.md +10 -9
- package/docs/codex-session-bridge.md +18 -18
- package/docs/coms-hermes-bridge.md +6 -6
- package/docs/hermes-watchdog-supervisor.md +1 -1
- package/docs/npm-install.md +71 -16
- package/docs/pi-extensions.md +9 -9
- package/docs/pi-setup.md +2 -2
- package/docs/workflows.md +9 -5
- package/install-manifest.json +202 -135
- package/justfile +22 -22
- package/manifest-meta.json +51 -57
- package/package.json +26 -26
- package/references/observability-checklist.md +1 -0
- package/references/performance-checklist.md +83 -0
- package/references/prompting-patterns.md +1 -1
- package/references/security-checklist.md +85 -19
- package/references/testing-patterns.md +12 -13
- package/references/workflow-authoring.md +5 -5
- package/skills/code-review-and-quality/SKILL.md +17 -2
- package/skills/constraint-driven-development/SKILL.md +338 -0
- package/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/skills/context-engineering/SKILL.md +52 -2
- package/skills/deprecation-and-migration/SKILL.md +42 -1
- package/skills/designing-agents/SKILL.md +12 -12
- package/skills/drafting-workflows/SKILL.md +6 -6
- package/skills/drafting-workflows/scripts/make-workflow.ts +3 -3
- package/skills/frontend-ui-engineering/SKILL.md +2 -2
- package/skills/git-workflow-and-versioning/SKILL.md +1 -1
- package/skills/incremental-implementation/SKILL.md +13 -9
- package/skills/peer-coms/SKILL.md +4 -4
- package/skills/performance-optimization/SKILL.md +152 -6
- package/skills/planning-and-task-breakdown/SKILL.md +32 -8
- package/skills/security-and-hardening/SKILL.md +84 -21
- package/skills/spec-driven-development/SKILL.md +41 -2
- package/skills/using-agent-skills/SKILL.md +3 -2
- package/vendor/agent-skills-upstream/README.md +427 -8
- package/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +73 -0
- package/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +2 -2
- package/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
- package/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +49 -1
- package/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +4 -4
- package/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +1 -1
- package/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +12 -2
- package/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +3 -3
- package/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +1 -1
- package/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +1 -1
- package/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +9 -9
- package/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +36 -1
- package/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +151 -5
- package/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +32 -9
- package/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +64 -7
- package/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +26 -6
- package/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +23 -1
- package/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +42 -3
- package/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +18 -3
- package/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +3 -2
- package/.pi/extensions/agent-fleet-update-check/README.md +0 -57
- package/.pi/extensions/agent-fleet-update-check/index.ts +0 -161
- /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-herdr/plugin.js +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-herdr/presentation.js +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-monitor/plugin.js +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-monitor/state.js +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/herdr_source.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/manifest.json +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/plugin_api.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/sessions.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/tasks.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/plugin.yaml +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/adapter.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/dist/index.js +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/manifest.json +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/plugin_api.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-liaison/SKILL.md +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/manifest.json +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_actions.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_contract.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_delivery.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_engine.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_judgment.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_recovery.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_state.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_transport.py +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/fleet-codex-client.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/hermes-watchdog-capability-probe.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/lib/fake-herdr-server.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-catalog.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-operations.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-session.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-command.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/lib/flow-command.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/lib/flow-maintenance.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/package-lock.json +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/package.json +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/changes.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/debate.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/env.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/gates.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/git.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/merge.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/model-visibility.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/permissions.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/poll.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/quality.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/run.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/voices.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/writer-lease.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/tsconfig.json +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-build-test.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-debate.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-document.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-poll.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-quality.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-scout.ts +0 -0
- /package/{hermes → .versions/2.0.7/hermes}/README.md +0 -0
- /package/{hermes → .versions/2.0.7/hermes}/plugins/agent-fleet-herdr/dashboard/activity.py +0 -0
- /package/{hermes → .versions/2.0.7/hermes}/plugins/agent-fleet-herdr/dashboard/coms_registry.py +0 -0
- /package/{hermes → .versions/2.0.7/hermes}/plugins/agent-fleet-herdr/dashboard/coms_send.py +0 -0
- /package/{hermes → .versions/2.0.7/hermes}/plugins/agent-fleet-herdr/dashboard/watch.py +0 -0
- /package/{hermes → .versions/2.0.7/hermes}/skills/hub-conductor/SKILL.md +0 -0
- /package/{hermes → .versions/2.0.7/hermes}/skills/hub-watchdog/SKILL.md +0 -0
- /package/{hooks → .versions/2.0.7/hooks}/coms-stop-hook.mjs +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/claude-code-preflight.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/coms-claude-bridge.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/coms-cli.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/coms-hermes-bridge.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/fleet-codex-read.py +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/flow.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/lib/claude-bridge-core.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/lib/coms-envelope.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/lib/fleet-codex-transport.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/lib/herdr-layout.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/lib/hermes-bridge-core.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/lib/hermes-monitor-events.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/lib/hermes-monitor-herdr.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/lib/hermes-monitor-model.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/lib/hermes-monitor-registry.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/lib/hermes-monitor-socket.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/lib/hermes-monitor-store.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/lib/monitor-env.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/lib/peer-launch.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/lib/persona-banner.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/lib/runtime-dependencies.js +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/lib/spawn-stagger.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/lib/team-project.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/lib/team-snapshot.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/peer-banner.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/peer-launch.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/team-snapshot.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/team-up.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/workflows/lib/agent-phase.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/workflows/lib/envelopes.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/workflows/lib/model-profile.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/workflows/lib/personas.ts +0 -0
- /package/{scripts → .versions/2.0.7/scripts}/workflows/lib/trace.ts +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: designing-agents
|
|
3
|
-
description: Designs and writes a focused artifact another agent runs — an agent persona in agents/, a workflow skill in skills/, or a pi session harness in .pi/harnesses/. Use when authoring a reviewer or specialist persona, a repeatable process skill, or a pi extension that reshapes a session — or when rewriting one that is under-specified, overlapping, or being ignored.
|
|
3
|
+
description: Designs and writes a focused artifact another agent runs — an agent persona in .pi/agents/personas/, a workflow skill in skills/, or a pi session harness in .pi/harnesses/. Use when authoring a reviewer or specialist persona, a repeatable process skill, or a pi extension that reshapes a session — or when rewriting one that is under-specified, overlapping, or being ignored.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Designing Agents
|
|
@@ -9,7 +9,7 @@ description: Designs and writes a focused artifact another agent runs — an age
|
|
|
9
9
|
|
|
10
10
|
This repo has three kinds of artifacts that shape how an agent works. Each is authored, versioned, and invoked deliberately:
|
|
11
11
|
|
|
12
|
-
- **Agent personas** live in
|
|
12
|
+
- **Agent personas** live in `.pi/agents/personas/<name>.md`. They define a *role* another agent adopts when it needs specialized review, audit, or analysis. Example: `code-reviewer`, `security-auditor`, `test-engineer`.
|
|
13
13
|
- **Skills** live in `skills/<name>/SKILL.md`. They define a *workflow* — a repeatable process with gated steps, anti-rationalization guardrails, and verification. Example: `spec-driven-development`, `test-driven-development`, `context-engineering`.
|
|
14
14
|
- **pi harnesses** live in `.pi/harnesses/<name>/`. They define a *session environment* — a TypeScript pi extension that reshapes the whole session: setting UI surfaces, gating tool calls, registering new tools or commands, or orchestrating sub-agents. Example: `agent-hub`, `damage-control-continue`, `coms`.
|
|
15
15
|
|
|
@@ -17,7 +17,7 @@ Personas and skills are prose that change an agent's *judgment*. A harness is co
|
|
|
17
17
|
|
|
18
18
|
## When to Use
|
|
19
19
|
|
|
20
|
-
- Creating a new persona file in
|
|
20
|
+
- Creating a new persona file in `.pi/agents/personas/` (reviewer, auditor, domain specialist)
|
|
21
21
|
- Creating a new skill directory in `skills/` (a process, checklist, or workflow)
|
|
22
22
|
- Creating a new pi harness in `.pi/harnesses/` (a footer, focus gate, safety check, orchestrator, or messaging layer)
|
|
23
23
|
- An existing persona, skill, or harness is vague, overlaps another, or is being ignored in practice
|
|
@@ -32,7 +32,7 @@ Personas and skills are prose that change an agent's *judgment*. A harness is co
|
|
|
32
32
|
|
|
33
33
|
## The Workflow
|
|
34
34
|
|
|
35
|
-
This workflow is abstracted from the three reference personas (`
|
|
35
|
+
This workflow is abstracted from the three reference personas (`code-reviewer`, `security-auditor`, `test-engineer`), from `docs/skill-anatomy.md`, and from the ported harnesses under `.pi/harnesses/` (catalogued in `docs/pi-extensions.md`). Do not advance to the next step until the current one is settled.
|
|
36
36
|
|
|
37
37
|
### 1. Choose the target type
|
|
38
38
|
|
|
@@ -40,7 +40,7 @@ Ask: is this a *role* the agent should adopt, a *process* it should follow, or a
|
|
|
40
40
|
|
|
41
41
|
| Target | Choose when | Output |
|
|
42
42
|
|---|---|---|
|
|
43
|
-
| Persona | The agent needs to evaluate or review through a specific lens (correctness, security, test strategy, accessibility, migration safety…) |
|
|
43
|
+
| Persona | The agent needs to evaluate or review through a specific lens (correctness, security, test strategy, accessibility, migration safety…) | `.pi/agents/personas/<name>.md` |
|
|
44
44
|
| Skill | The agent needs to follow a repeatable process with gated steps, verification, and anti-rationalization guards | `skills/<name>/SKILL.md` |
|
|
45
45
|
| pi harness | The session itself must change — footer, status, a blocking gate on tool calls, a new tool or `/command`, or sub-agent orchestration | `.pi/harnesses/<name>/` (a directory) |
|
|
46
46
|
|
|
@@ -59,7 +59,7 @@ Do not proceed until the one-sentence purpose is locked. If the requester cannot
|
|
|
59
59
|
### 3. Scan for overlap
|
|
60
60
|
|
|
61
61
|
Read every existing artifact of the target type:
|
|
62
|
-
- For a persona: every file
|
|
62
|
+
- For a persona: every persona file already in the workspace.
|
|
63
63
|
- For a skill: every `skills/*/SKILL.md` (start with the Quick Reference table in `skills/using-agent-skills/SKILL.md`).
|
|
64
64
|
- For a harness: the catalog table in `docs/pi-extensions.md`, then the `README.md` of each `.pi/harnesses/*` that looks close.
|
|
65
65
|
|
|
@@ -103,7 +103,7 @@ This step branches by target type.
|
|
|
103
103
|
|
|
104
104
|
#### 6a. Persona body (four-block structure)
|
|
105
105
|
|
|
106
|
-
Used by every persona
|
|
106
|
+
Used by every installed persona. See the Persona Template below.
|
|
107
107
|
|
|
108
108
|
```markdown
|
|
109
109
|
# <Role Heading>
|
|
@@ -165,7 +165,7 @@ A harness also has wiring steps that personas and skills do not — step 9 cover
|
|
|
165
165
|
|
|
166
166
|
### 7. Apply prompting-patterns
|
|
167
167
|
|
|
168
|
-
Before finalizing, read
|
|
168
|
+
Before finalizing, read `../../references/prompting-patterns.md` and check the artifact against these sections. This applies to all three types — for a harness, to the prose it injects (system-prompt text, tool descriptions, block reasons), not the TypeScript itself.
|
|
169
169
|
|
|
170
170
|
- **§2.2** — Positive instructions, not prohibitions. Rewrite every "don't do X" as "do Y".
|
|
171
171
|
- **§2.3** — Explain *why* for any non-obvious rule. One short clause is enough.
|
|
@@ -185,7 +185,7 @@ Cut every sentence that does not change behavior. Read each rule and ask: "If I
|
|
|
185
185
|
|
|
186
186
|
### 9. Write the file(s)
|
|
187
187
|
|
|
188
|
-
- Persona →
|
|
188
|
+
- Persona → `.pi/agents/personas/<name>.md`.
|
|
189
189
|
- Skill → `skills/<name>/SKILL.md` (create the directory; supporting files only if the skill exceeds ~300 lines or needs separate reference material).
|
|
190
190
|
- Harness → `.pi/harnesses/<name>/` with `index.ts`, `package.json`, and `README.md`. Then add a `just ext-<name>` recipe to the `justfile` under the matching category header, add a catalog row to `docs/pi-extensions.md`, and add any new runtime dependency to `.pi/harnesses/package.json`. Never place a harness under `.pi/extensions/` — pi auto-discovers that directory and would load every harness at once.
|
|
191
191
|
|
|
@@ -321,7 +321,7 @@ A harness is a directory, not a single file. The `ExtensionAPI` surface, the `in
|
|
|
321
321
|
| "I'll skip the harness README and catalog row — `index.ts` is the real artifact" | A harness with no row in `docs/pi-extensions.md` is undiscoverable; no agent will load it. The README is its discovery surface — the same role frontmatter plays for a skill. |
|
|
322
322
|
| "I'll copy an existing artifact and tweak it" | For prose artifacts, copy-paste creates silent duplication and drift — read the existing files to learn the pattern, then write fresh. For a harness, copying the nearest `index.ts` *is* the recommended start; just rename it cleanly and cut what you don't use. |
|
|
323
323
|
| "I don't need to read prompting-patterns, I know how to write prompts" | Every author thinks this. The reference exists because recurring, measurable mistakes happen anyway. Spend 3 minutes skimming §2 and §6. |
|
|
324
|
-
| "I'll add every tool and capability — flexibility is good" |
|
|
324
|
+
| "I'll add every tool and capability — flexibility is good" | Agent Fleet's own personas don't declare tools at all; scope creep happens through the prompt body. Skills and harnesses that try to cover many domains lose their force. Bloated artifacts get skimmed. |
|
|
325
325
|
| "The purpose is hard to state in one sentence because it covers a lot" | If you cannot state it in one sentence, the artifact covers too much. Split it or scope it down. |
|
|
326
326
|
| "I'll leave the rules/steps section light so the artifact can be flexible" | Empty Rules or vague steps become empty behavior. The specifics are what differentiate this artifact from a general agent. |
|
|
327
327
|
| "My skill is mostly reference material — I'll inline a 200-line checklist" | Reference material belongs in `references/`. Skills are workflows, not reference docs. Move the long content out and cite it. |
|
|
@@ -360,13 +360,13 @@ A harness is a directory, not a single file. The `ExtensionAPI` surface, the `in
|
|
|
360
360
|
|
|
361
361
|
- [ ] Name is kebab-case and matches the file/directory, the `name` field (frontmatter or `package.json`), and the H1 title.
|
|
362
362
|
- [ ] The discovery surface (description, or README + catalog row) is action-oriented and ends with a concrete trigger.
|
|
363
|
-
- [ ] Cross-checked against
|
|
363
|
+
- [ ] Cross-checked against `../../references/prompting-patterns.md` §2.2, §2.3, §2.4, §2.5, §3.1, §6.4 — no prohibitions, no contradictions, no ALL-CAPS, role/overview is specific.
|
|
364
364
|
- [ ] Scanned against existing files of the same type — no >30% overlap.
|
|
365
365
|
- [ ] Every sentence, if removed, would visibly change the artifact's behavior.
|
|
366
366
|
|
|
367
367
|
### Persona-specific checklist
|
|
368
368
|
|
|
369
|
-
- [ ] File exists at
|
|
369
|
+
- [ ] File exists at `.pi/agents/personas/<name>.md`.
|
|
370
370
|
- [ ] Body has: Role opening paragraph, Framework/Approach, Output Format, Rules.
|
|
371
371
|
- [ ] Output Format contains a concrete markdown template, not a description of one.
|
|
372
372
|
- [ ] If the persona classifies findings (Critical / High / etc.), the severity table is present with explicit criteria and required action.
|
|
@@ -11,7 +11,7 @@ Draft code-owned workflows by copying a proven flow shape, then edit only the de
|
|
|
11
11
|
|
|
12
12
|
## When to Use
|
|
13
13
|
|
|
14
|
-
- Creating a new
|
|
14
|
+
- Creating a new `.pi/agent-fleet/scripts/workflows/wf-*.ts` flow.
|
|
15
15
|
- Changing a flow's phase order, gates, retries, or acceptance rule.
|
|
16
16
|
- Translating an operator request into a prompt for an agent phase.
|
|
17
17
|
|
|
@@ -21,7 +21,7 @@ Do not use this skill to improvise an interactive hub dispatch. `just fleet` rem
|
|
|
21
21
|
|
|
22
22
|
### 1. Map, list, and stop
|
|
23
23
|
|
|
24
|
-
Read the managed workflow map in `.pi/agent-fleet/docs/workflows.md`, then list every available
|
|
24
|
+
Read the managed workflow map in `.pi/agent-fleet/docs/workflows.md`, then list every available `.pi/agent-fleet/scripts/workflows/wf-*.ts` with exactly one line containing its name and `Phases:` shape. **Stop and wait for the operator to select or describe the desired flow.**
|
|
25
25
|
|
|
26
26
|
At this point:
|
|
27
27
|
|
|
@@ -79,7 +79,7 @@ The draft marks only three classes of decisions:
|
|
|
79
79
|
|
|
80
80
|
Edit the copied phase bodies so the declared shape is real. Remove each TODO only after making that decision. Do not add TODOs for imports, envelope wiring, trace calls, dry-run stubs, or other boilerplate.
|
|
81
81
|
|
|
82
|
-
For the complete contracts, read
|
|
82
|
+
For the complete contracts, read `../../references/workflow-authoring.md`.
|
|
83
83
|
|
|
84
84
|
### 6. Keep the envelope triad synchronized
|
|
85
85
|
|
|
@@ -96,9 +96,9 @@ Use existing return-contract vocabulary. A parsed envelope with `status: "fail"`
|
|
|
96
96
|
The generator refuses handoff unless both gates pass:
|
|
97
97
|
|
|
98
98
|
```bash
|
|
99
|
-
npx tsc -p scripts/workflows/tsconfig.json --noEmit
|
|
99
|
+
npx tsc -p .pi/agent-fleet/scripts/workflows/tsconfig.json --noEmit
|
|
100
100
|
node --experimental-strip-types skills/drafting-workflows/scripts/make-workflow.ts \
|
|
101
|
-
--verify-draft scripts/workflows/wf-<name>.ts
|
|
101
|
+
--verify-draft .pi/agent-fleet/scripts/workflows/wf-<name>.ts
|
|
102
102
|
```
|
|
103
103
|
|
|
104
104
|
The second command resolves the exact `wf-<name>.ts` entry export used by the flow registry, then executes it with stubbed agent phases and `dryRun: true`; it makes no model call. If either gate fails, the generator deletes the draft and reports the exact failure. Repair the source decision or rerun the generator—never bypass either gate. A handed-off draft is immediately reachable as `just flow <name>`; no central registry edit is required.
|
|
@@ -138,6 +138,6 @@ Before presenting a workflow draft, confirm:
|
|
|
138
138
|
- [ ] Every agent phase has an explicit persona or call-site writes policy; omission is a startup error, never unrestricted by accident.
|
|
139
139
|
- [ ] Writes policy and protected paths are enforced around agent phases.
|
|
140
140
|
- [ ] The generated export is uniquely named for the file and resolves through `just flow <name>`.
|
|
141
|
-
- [ ] `npx tsc -p scripts/workflows/tsconfig.json --noEmit` passes.
|
|
141
|
+
- [ ] `npx tsc -p .pi/agent-fleet/scripts/workflows/tsconfig.json --noEmit` passes.
|
|
142
142
|
- [ ] The generated workflow's stubbed dry run is accepted with zero model calls.
|
|
143
143
|
- [ ] The exact commands and outcomes are included in the handoff.
|
|
@@ -73,7 +73,7 @@ function editDistance(left: PhaseKind[], right: PhaseKind[]): number {
|
|
|
73
73
|
}
|
|
74
74
|
|
|
75
75
|
export function selectNearestWorkflow(shapes: WorkflowShape[], requestedPhases: string[]): WorkflowShape {
|
|
76
|
-
if (!shapes.length) throw new Error("No scripts/workflows/wf-*.ts sources were found.");
|
|
76
|
+
if (!shapes.length) throw new Error("No .pi/agent-fleet/scripts/workflows/wf-*.ts sources were found.");
|
|
77
77
|
const requestedKinds = requestedPhases.map(phaseKind);
|
|
78
78
|
return [...shapes].sort((left, right) => {
|
|
79
79
|
const leftScore = editDistance(left.kinds, requestedKinds) * 100 + Math.abs(left.kinds.length - requestedKinds.length) * 10;
|
|
@@ -118,7 +118,7 @@ export function makeWorkflow(options: {
|
|
|
118
118
|
}): { outputPath: string; sourcePath: string; phases: string[] } {
|
|
119
119
|
if (!SAFE_NAME.test(options.name)) throw new Error(`Invalid workflow name: ${options.name}`);
|
|
120
120
|
if (RESERVED_FLOW_NAMES.has(options.name)) throw new Error(`Workflow name is reserved for maintenance: ${options.name}`);
|
|
121
|
-
const workflowsDir = resolve(options.workflowsDir ?? resolve(options.cwd, "scripts/workflows"));
|
|
121
|
+
const workflowsDir = resolve(options.workflowsDir ?? resolve(options.cwd, ".pi/agent-fleet/scripts/workflows"));
|
|
122
122
|
const outputPath = resolve(workflowsDir, `wf-${options.name}.ts`);
|
|
123
123
|
if (existsSync(outputPath)) throw new Error(`Refusing to overwrite existing workflow: ${outputPath}`);
|
|
124
124
|
const nearest = selectNearestWorkflow(readWorkflowShapes(workflowsDir), options.phases);
|
|
@@ -141,7 +141,7 @@ export function makeWorkflow(options: {
|
|
|
141
141
|
export async function verifyDraft(path: string, cwd = process.cwd()): Promise<void> {
|
|
142
142
|
const resolvedPath = resolve(path);
|
|
143
143
|
const workflowName = basename(resolvedPath).replace(/^wf-/, "").replace(/\.ts$/, "");
|
|
144
|
-
const flowModulePath = resolve(cwd, "scripts/flow.ts");
|
|
144
|
+
const flowModulePath = resolve(cwd, ".pi/agent-fleet/scripts/flow.ts");
|
|
145
145
|
const { resolveWorkflow } = await import(`${pathToFileURL(flowModulePath).href}?verify=${Date.now()}`) as {
|
|
146
146
|
resolveWorkflow(name: string, workflowsDir?: string): Promise<{ run: (run: unknown, input: { args: string[]; dryRun: boolean; cwd: string }) => Promise<{ accepted: boolean }> } | undefined>;
|
|
147
147
|
};
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: frontend-ui-engineering
|
|
3
|
-
description: Builds production-quality UIs. Use when building or modifying
|
|
3
|
+
description: Builds production-quality, accessible, responsive user-facing UIs. Use when building or modifying interfaces and pages, creating components, implementing layouts, meeting WCAG accessibility requirements, managing state, or when the output needs to look and feel production-quality rather than AI-generated.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Frontend UI Engineering
|
|
@@ -294,7 +294,7 @@ function useToggleTask() {
|
|
|
294
294
|
|
|
295
295
|
## See Also
|
|
296
296
|
|
|
297
|
-
For detailed accessibility requirements and testing tools, see
|
|
297
|
+
For detailed accessibility requirements and testing tools, see `../../references/accessibility-checklist.md`.
|
|
298
298
|
|
|
299
299
|
## Common Rationalizations
|
|
300
300
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: git-workflow-and-versioning
|
|
3
|
-
description: Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, or when you need to organize work across multiple parallel streams.
|
|
3
|
+
description: Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, splitting uncommitted work in a messy working tree into clean atomic commits, opening or reviewing a pull request (PR), pushing to a remote, or when you need to organize work across multiple parallel streams.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Git Workflow and Versioning
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: incremental-implementation
|
|
3
|
-
description: Delivers changes incrementally and grills unspecified forks instead of silently picking among them. Use when implementing any feature or change that touches more than one file. Use when you're about to write a large amount of code at once, or when a task feels too big to land in one step.
|
|
3
|
+
description: Delivers changes incrementally in thin, verifiable slices and grills unspecified forks instead of silently picking among them. Use when implementing any feature or change that touches more than one file, or when picking up the next task from a plan. Use when rolling a change out behind a feature flag, when you're about to write a large amount of code at once, or when a task feels too big to land in one step.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Incremental Implementation
|
|
@@ -226,8 +226,8 @@ When directing an agent to implement incrementally:
|
|
|
226
226
|
Start with just the database schema change and the API endpoint.
|
|
227
227
|
Don't touch the UI yet — we'll do that in the next increment.
|
|
228
228
|
|
|
229
|
-
After implementing, run
|
|
230
|
-
nothing is broken, then present the Standard Slice Summary and
|
|
229
|
+
After implementing, run the repository's test and build commands to
|
|
230
|
+
verify nothing is broken, then present the Standard Slice Summary and
|
|
231
231
|
wait for my approval before the next slice. Do not stage or
|
|
232
232
|
commit — I'll handle git manually after reviewing."
|
|
233
233
|
```
|
|
@@ -236,13 +236,17 @@ Be explicit about what's in scope and what's NOT in scope for each increment.
|
|
|
236
236
|
|
|
237
237
|
## Increment Checklist
|
|
238
238
|
|
|
239
|
-
After each increment, verify
|
|
239
|
+
After each increment, verify with the repository's own commands. **Where the project
|
|
240
|
+
defines `quality:` under `## workflows` in `.ai/agent-fleet-overrides.md`, that command
|
|
241
|
+
*is* the verification — run it rather than guessing.** Only outside a configured project
|
|
242
|
+
should you discover the stack yourself (see the `test-driven-development` skill's
|
|
243
|
+
*Discover the Stack First* section). Never fall back to an assumed `npm test`.
|
|
240
244
|
|
|
241
245
|
- [ ] The change does one thing and does it completely
|
|
242
|
-
- [ ] All existing tests still pass (`npm test`)
|
|
243
|
-
- [ ] The build succeeds (
|
|
244
|
-
- [ ] Type checking passes (`npx tsc --noEmit`)
|
|
245
|
-
- [ ] Linting passes (
|
|
246
|
+
- [ ] All existing tests still pass (the project's `quality:` command, or the repository's test command: `npm test`, `./gradlew test`, `pytest`, ...)
|
|
247
|
+
- [ ] The build succeeds (the repository's build command)
|
|
248
|
+
- [ ] Type checking passes, where the stack has one (`npx tsc --noEmit`, `mypy`, ...)
|
|
249
|
+
- [ ] Linting passes (the repository's lint command)
|
|
246
250
|
- [ ] The new functionality works as expected
|
|
247
251
|
- [ ] Unspecified load-bearing forks were grilled (or grilling found none); already-stated requirements were not re-asked
|
|
248
252
|
- [ ] The Standard Slice Summary was presented to the user
|
|
@@ -295,4 +299,4 @@ After completing all increments for a task:
|
|
|
295
299
|
|
|
296
300
|
## See Also
|
|
297
301
|
|
|
298
|
-
Per-increment verification is the local check. Before declaring a task done, apply the project-wide Definition of Done as the final gate, the standing bar every increment clears regardless of the task. See
|
|
302
|
+
Per-increment verification is the local check. Before declaring a task done, apply the project-wide Definition of Done as the final gate, the standing bar every increment clears regardless of the task. See `../../references/definition-of-done.md`.
|
|
@@ -30,14 +30,14 @@ yourself** — pane lifecycle (herdr) belongs to the orchestrator and the human.
|
|
|
30
30
|
**Discover** who is alive (name, model, purpose):
|
|
31
31
|
|
|
32
32
|
```bash
|
|
33
|
-
node --experimental-strip-types scripts/coms-cli.ts list
|
|
33
|
+
node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts list
|
|
34
34
|
```
|
|
35
35
|
|
|
36
36
|
**Ask and wait** (blocking round trip — usually what you want; generous timeout, peers
|
|
37
37
|
run real turns):
|
|
38
38
|
|
|
39
39
|
```bash
|
|
40
|
-
node --experimental-strip-types scripts/coms-cli.ts send researcher \
|
|
40
|
+
node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts send researcher \
|
|
41
41
|
"Where is the retry logic for outbound webhooks? file:line please" \
|
|
42
42
|
--await --timeout 300000
|
|
43
43
|
```
|
|
@@ -45,9 +45,9 @@ node --experimental-strip-types scripts/coms-cli.ts send researcher \
|
|
|
45
45
|
**Fire-and-collect** (returns a `msg_id` immediately; a detached waiter holds the reply):
|
|
46
46
|
|
|
47
47
|
```bash
|
|
48
|
-
node --experimental-strip-types scripts/coms-cli.ts send documenter "Draft a README section on X"
|
|
48
|
+
node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts send documenter "Draft a README section on X"
|
|
49
49
|
# … keep working …
|
|
50
|
-
node --experimental-strip-types scripts/coms-cli.ts await <msg_id> --timeout 300000
|
|
50
|
+
node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts await <msg_id> --timeout 300000
|
|
51
51
|
```
|
|
52
52
|
|
|
53
53
|
**Answer inbound prompts** by simply replying in the conversation — your final message
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: performance-optimization
|
|
3
|
-
description: Optimizes application performance. Use when performance requirements exist, when you suspect performance regressions,
|
|
3
|
+
description: Optimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Performance Optimization
|
|
@@ -33,7 +33,7 @@ Measure before optimizing. Performance work without measurement is guessing —
|
|
|
33
33
|
1. MEASURE → Establish baseline with real data
|
|
34
34
|
2. IDENTIFY → Find the actual bottleneck (not assumed)
|
|
35
35
|
3. FIX → Address the specific bottleneck
|
|
36
|
-
4. VERIFY → Measure again
|
|
36
|
+
4. VERIFY → Measure again; keep or revert
|
|
37
37
|
5. GUARD → Add monitoring or tests to prevent regression
|
|
38
38
|
```
|
|
39
39
|
|
|
@@ -149,6 +149,58 @@ const tasks = await db.tasks.findMany({
|
|
|
149
149
|
});
|
|
150
150
|
```
|
|
151
151
|
|
|
152
|
+
#### Queries That Ignore Their Index
|
|
153
|
+
|
|
154
|
+
"Add an index" is the guess. The query plan is the measurement:
|
|
155
|
+
|
|
156
|
+
```sql
|
|
157
|
+
EXPLAIN ANALYZE
|
|
158
|
+
SELECT id, title FROM tasks
|
|
159
|
+
WHERE owner_id = 42 ORDER BY created_at DESC LIMIT 20;
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
Three things in the output decide the fix:
|
|
163
|
+
|
|
164
|
+
| What you see | What it means |
|
|
165
|
+
|---|---|
|
|
166
|
+
| `Seq Scan` on a large table where you expected an index | No usable index for this predicate |
|
|
167
|
+
| Estimated `rows=` off from actual by an order of magnitude | Stale statistics; the planner is choosing on bad information |
|
|
168
|
+
| A `Sort` node above the scan | The index covers the filter but not the `ORDER BY` |
|
|
169
|
+
|
|
170
|
+
Index for the **shape of the query**, not the column in isolation. In a composite index, equality columns come first, then the range or sort column:
|
|
171
|
+
|
|
172
|
+
```sql
|
|
173
|
+
CREATE INDEX idx_tasks_owner_created ON tasks (owner_id, created_at DESC);
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
**When an index will not help:**
|
|
177
|
+
|
|
178
|
+
| Situation | Why |
|
|
179
|
+
|---|---|
|
|
180
|
+
| Low selectivity, querying the dominant value (a `status` column that is 95% `active`, filtered on `active`) | A sequential scan is genuinely cheaper; the planner will ignore the index. Filtering on the rare value is the opposite case, and a partial index serves it well |
|
|
181
|
+
| Leading wildcard (`LIKE '%term'`) | A B-tree cannot seek without a prefix; needs trigram or full-text |
|
|
182
|
+
| Function on the column (`WHERE lower(email) = ?`) | The plain column index is unusable; index the expression instead |
|
|
183
|
+
| Write-heavy table | Every index is a tax on every `INSERT`/`UPDATE`; measure the write cost, not just the read gain |
|
|
184
|
+
|
|
185
|
+
Re-run `EXPLAIN ANALYZE` after. An index that did not change the plan is a revert (Step 4), and it is not free: it still costs on every write.
|
|
186
|
+
|
|
187
|
+
#### Connection Pool Exhaustion
|
|
188
|
+
|
|
189
|
+
The signature is distinctive: **every** endpoint slows at once, the slow time is spent waiting for a connection rather than executing, and the database reports mostly idle sessions.
|
|
190
|
+
|
|
191
|
+
```typescript
|
|
192
|
+
// BAD: a pool per request or per module — under serverless this multiplies
|
|
193
|
+
// by instance count and exhausts the database's connection limit
|
|
194
|
+
// GOOD: one pool per process, sized against the database's ceiling
|
|
195
|
+
const pool = new Pool({
|
|
196
|
+
max: 10, // instances × max must stay under max_connections
|
|
197
|
+
idleTimeoutMillis: 30_000,
|
|
198
|
+
connectionTimeoutMillis: 5_000, // fail fast instead of queueing forever
|
|
199
|
+
});
|
|
200
|
+
```
|
|
201
|
+
|
|
202
|
+
**Bigger is not faster.** A pool larger than what the database can execute concurrently just relocates the queue from your app to the database, where it is harder to see. When instance count is unbounded (serverless, autoscaling), a proxy that multiplexes connections (pgbouncer, RDS Proxy) is the fix, not a higher `max`.
|
|
203
|
+
|
|
152
204
|
#### Missing Image Optimization (Frontend)
|
|
153
205
|
|
|
154
206
|
```html
|
|
@@ -264,6 +316,16 @@ function App() {
|
|
|
264
316
|
|
|
265
317
|
#### Missing Caching (Backend)
|
|
266
318
|
|
|
319
|
+
Cache what is expensive to produce and read far more often than it changes. Caching a query that was already fast adds a network hop, a staleness bug, and an eviction policy to maintain, in exchange for nothing.
|
|
320
|
+
|
|
321
|
+
**Pick the layer deliberately:**
|
|
322
|
+
|
|
323
|
+
| Layer | Visible to | Use when | Cost |
|
|
324
|
+
|---|---|---|---|
|
|
325
|
+
| In-process (`Map`, LRU) | One instance | Small, hot, per-instance staleness is acceptable | Each instance drifts independently; invalidation reaches only one |
|
|
326
|
+
| Shared (Redis, Memcached) | All instances | Instances must agree, or the value is expensive to recompute | A network hop, and another service to run and monitor |
|
|
327
|
+
| CDN / edge | Everyone, per URL | Responses are public and identical for a given key | Invalidation is the hard part; assume you cannot recall a bad response quickly |
|
|
328
|
+
|
|
267
329
|
```typescript
|
|
268
330
|
// Cache frequently-read, rarely-changed data
|
|
269
331
|
const CACHE_TTL = 5 * 60 * 1000; // 5 minutes
|
|
@@ -289,9 +351,73 @@ app.use('/static', express.static('public', {
|
|
|
289
351
|
res.set('Cache-Control', 'public, max-age=300'); // 5 minutes
|
|
290
352
|
```
|
|
291
353
|
|
|
292
|
-
|
|
354
|
+
**Key design decides correctness.** Every input that changes the response belongs in the key: tenant, locale, permissions, feature flags. A key that omits the viewer is how one user's data gets served to another, and that ships as a performance win.
|
|
355
|
+
|
|
356
|
+
**Choose one invalidation strategy, not three:**
|
|
357
|
+
|
|
358
|
+
| Strategy | Trade-off |
|
|
359
|
+
|---|---|
|
|
360
|
+
| TTL | Simplest. You accept staleness up to the TTL, so state the acceptable window explicitly |
|
|
361
|
+
| Event or tag based | Fresh on write, but writers now have to know the cache topology |
|
|
362
|
+
| Versioned keys (`user:42:profile:v7`) | Never invalidate, just stop reading old keys. Costs memory until eviction |
|
|
363
|
+
|
|
364
|
+
**Guard against the stampede.** A hot key expires, every concurrent request misses together, and the origin takes the full load at once, which is how a cache turns into an outage instead of preventing one. Serve stale while a single request recomputes (`stale-while-revalidate`), or coalesce concurrent misses behind one in-flight promise so N waiters cause one recompute.
|
|
365
|
+
|
|
366
|
+
**Do not cache:** anything whose staleness is a correctness bug (balances, permissions, inventory at checkout), or per-user data under a key that does not identify the user. See `../../references/performance-checklist.md` for request coalescing, write strategies, negative caching, and the cache checklist.
|
|
367
|
+
|
|
368
|
+
### Step 4: Verify (Keep or Revert)
|
|
369
|
+
|
|
370
|
+
A fix is a hypothesis until you re-measure. This step decides whether it survives.
|
|
371
|
+
|
|
372
|
+
**Re-measure the way you measured the baseline:** same command, same conditions, same fixed budget (wall-clock, sample count, or request count). A baseline taken on a cold cache against a result taken on a warm one measures the cache, not your change.
|
|
373
|
+
|
|
374
|
+
**Change one thing at a time.** Three optimizations landed together produce one number, and you cannot attribute it. If they must ship together, measure each in isolation first.
|
|
375
|
+
|
|
376
|
+
**Beat the noise, not just the mean.** Repeat the measurement and compare the delta against run-to-run variance. A 3% gain inside ±5% variance is not a gain; it is a different sample.
|
|
377
|
+
|
|
378
|
+
Then decide, strictly:
|
|
379
|
+
|
|
380
|
+
| Result vs. baseline | Action |
|
|
381
|
+
|---|---|
|
|
382
|
+
| Past the threshold, tests green | **Keep.** Commit with the before/after numbers in the message. |
|
|
383
|
+
| Within noise (no measurable change) | **Revert.** |
|
|
384
|
+
| Worse | **Revert.** |
|
|
385
|
+
| Improved, but a test went red | **Revert.** A regression wearing a win's clothing. |
|
|
386
|
+
|
|
387
|
+
**"Neutral" is a revert, not a keep.** This is the step teams skip: the change is already written, throwing it away feels wasteful, so it lands unmeasured, and the codebase accretes complexity that never bought anything. Code you keep, you maintain forever. Make it pay for itself.
|
|
388
|
+
|
|
389
|
+
**Correctness gates the metric.** The suite stays green *and* the number moves. An "optimization" that wins by dropping work the product needed (skipping a validation, caching something that must be fresh, removing an `await` that was load-bearing) is a regression, not a win.
|
|
390
|
+
|
|
391
|
+
#### Log every attempt, including the reverted ones
|
|
392
|
+
|
|
393
|
+
Reverted work leaves no trace in git history, which is exactly why the same dead idea gets tried again next quarter. Keep a short ledger so a discarded idea stays discarded:
|
|
394
|
+
|
|
395
|
+
| Idea | Baseline → Result | Verdict | Why |
|
|
396
|
+
|---|---|---|---|
|
|
397
|
+
| Memoize the row component | INP 240ms → 235ms | reverted | Inside noise (±15ms). Rows weren't the bottleneck. |
|
|
398
|
+
| Virtualize the list | INP 240ms → 90ms | kept | Long tasks gone from the trace. |
|
|
399
|
+
| Preconnect to the API origin | LCP 2.8s → 2.8s | reverted | Already same-origin. |
|
|
400
|
+
|
|
401
|
+
A section in the PR description or a `PERF.md` in the repo both work. What matters is that the next person (or the next agent) reads it before proposing an experiment, and doesn't re-run one that already failed.
|
|
402
|
+
|
|
403
|
+
### Step 5: Guard Against Regression
|
|
404
|
+
|
|
405
|
+
Guard the metric the user actually feels, not every available number. Use the
|
|
406
|
+
same LCP, INP, p95 latency, or other primary metric that justified the fix.
|
|
407
|
+
|
|
408
|
+
Use two complementary layers when the surface is user-facing:
|
|
409
|
+
|
|
410
|
+
- **Synthetic CI gate:** Catch reproducible regressions before merge with a
|
|
411
|
+
performance budget. Repeat noisy measurements or compare a median/trend so
|
|
412
|
+
normal run-to-run variance does not turn the gate into a flaky check.
|
|
413
|
+
- **Field monitoring:** Alert on a meaningful p75 movement in RUM data. Use
|
|
414
|
+
attributed `web-vitals` data to locate the cause; treat CrUX's rolling window
|
|
415
|
+
as confirmation rather than an immediate alert.
|
|
416
|
+
|
|
417
|
+
When either guard fires, return to Step 1 and establish a fresh baseline before
|
|
418
|
+
proposing another fix.
|
|
293
419
|
|
|
294
|
-
Set budgets and enforce them
|
|
420
|
+
**Set budgets and enforce them:**
|
|
295
421
|
|
|
296
422
|
```
|
|
297
423
|
JavaScript bundle: < 200KB gzipped (initial load)
|
|
@@ -314,7 +440,7 @@ npx lhci autorun
|
|
|
314
440
|
|
|
315
441
|
## See Also
|
|
316
442
|
|
|
317
|
-
For detailed performance checklists, optimization commands, and anti-pattern reference, see
|
|
443
|
+
For detailed performance checklists, optimization commands, and anti-pattern reference, see `../../references/performance-checklist.md`.
|
|
318
444
|
|
|
319
445
|
|
|
320
446
|
## Common Rationalizations
|
|
@@ -326,25 +452,45 @@ For detailed performance checklists, optimization commands, and anti-pattern ref
|
|
|
326
452
|
| "This optimization is obvious" | If you didn't measure, you don't know. Profile first. |
|
|
327
453
|
| "Users won't notice 100ms" | Research shows 100ms delays impact conversion rates. Users notice more than you think. |
|
|
328
454
|
| "The framework handles performance" | Frameworks prevent some issues but can't fix N+1 queries or oversized bundles. |
|
|
455
|
+
| "The query is slow, add an index" | Read the plan first. The index may already exist and be unusable, and every index taxes writes forever. |
|
|
456
|
+
| "Just cache it" | Caching an already-cheap call buys nothing and adds a staleness bug. Cache what is expensive *and* re-read far more than written. |
|
|
457
|
+
| "Raise the pool size, we're running out of connections" | A pool bigger than the database can serve moves the queue somewhere less visible. Find what holds connections. |
|
|
458
|
+
| "It didn't help much, but it doesn't hurt" | Neutral changes are a revert. You pay maintenance on them forever and got nothing back. |
|
|
459
|
+
| "We already wrote it, may as well keep it" | Sunk cost. The measurement doesn't care how long the change took to write. |
|
|
460
|
+
| "The improvement is obvious, no need to re-measure" | Then re-measuring is cheap and proves it. Unmeasured wins are how neutral complexity lands. |
|
|
329
461
|
|
|
330
462
|
## Red Flags
|
|
331
463
|
|
|
332
464
|
- Optimization without profiling data to justify it
|
|
333
465
|
- N+1 query patterns in data fetching
|
|
466
|
+
- An index added without a query plan before and after to justify it
|
|
467
|
+
- A cache key that omits an input the response depends on (tenant, locale, viewer)
|
|
468
|
+
- A cache with no stated staleness window and no invalidation strategy
|
|
469
|
+
- Connection pool size raised in response to exhaustion, without finding what holds connections
|
|
334
470
|
- List endpoints without pagination
|
|
335
471
|
- Images without dimensions, lazy loading, or responsive sizes
|
|
336
472
|
- Bundle size growing without review
|
|
337
473
|
- No performance monitoring in production
|
|
338
474
|
- `React.memo` and `useMemo` everywhere (overusing is as bad as underusing)
|
|
475
|
+
- Optimizations kept without a re-measurement that justifies them
|
|
476
|
+
- Several optimizations bundled into one measurement, so no single change can be attributed
|
|
477
|
+
- A "win" that required a test to be changed, skipped, or deleted
|
|
478
|
+
- The same failed optimization attempted more than once because nobody recorded the first attempt
|
|
339
479
|
|
|
340
480
|
## Verification
|
|
341
481
|
|
|
342
482
|
After any performance-related change:
|
|
343
483
|
|
|
344
484
|
- [ ] Before and after measurements exist (specific numbers)
|
|
485
|
+
- [ ] The result was re-measured the same way as the baseline (same command, same conditions)
|
|
486
|
+
- [ ] The improvement exceeds run-to-run variance, not just the mean
|
|
487
|
+
- [ ] Changes that didn't beat the baseline were reverted, not kept as neutral
|
|
488
|
+
- [ ] Attempts are logged, kept and reverted alike, so a dead idea isn't re-run
|
|
345
489
|
- [ ] The specific bottleneck is identified and addressed
|
|
346
490
|
- [ ] Core Web Vitals are within "Good" thresholds
|
|
347
491
|
- [ ] Bundle size hasn't increased significantly
|
|
348
492
|
- [ ] No N+1 queries in new data fetching code
|
|
349
|
-
- [ ]
|
|
493
|
+
- [ ] Any new index is justified by a query plan before and after, and its write cost was considered
|
|
494
|
+
- [ ] Any new cache states what it keys on and how it goes stale
|
|
495
|
+
- [ ] The measured user-facing metric has a synthetic budget or field monitor that can detect regression
|
|
350
496
|
- [ ] Existing tests still pass (optimization didn't break behavior)
|
|
@@ -51,7 +51,24 @@ The task list is **embedded** in the plan file as the `## Task List` section. Do
|
|
|
51
51
|
|
|
52
52
|
Match the project's existing `docs` vs `Docs` capitalization, and create the directory if it does not exist.
|
|
53
53
|
|
|
54
|
-
**Project overrides:** if `.ai/agent-fleet-overrides.md` has a `## planning-and-task-breakdown` section, its keys (`plan-dir`, `naming`, `todo`) override these defaults — `todo: separate` restores a standalone `todo.md
|
|
54
|
+
**Project overrides:** if `.ai/agent-fleet-overrides.md` has a `## planning-and-task-breakdown` section, its keys (`plan-dir`, `naming`, `todo`) override these defaults — `todo: separate` restores a standalone `todo.md`, and `todo: tracker` routes tasks to an external issue tracker (below). See [docs/agent-fleet-setup.md](../../docs/agent-fleet-setup.md).
|
|
55
|
+
|
|
56
|
+
### Task List Target
|
|
57
|
+
|
|
58
|
+
The **task list target** is where tasks and checkpoints are recorded. It is defined once, here; every other reference in this skill defers to it.
|
|
59
|
+
|
|
60
|
+
- **Default (`todo: embedded`)** — the `## Task List` section of the plan file itself. No separate file.
|
|
61
|
+
- **`todo: separate`** — a standalone checklist-style `todo.md` next to the plan.
|
|
62
|
+
- **`todo: tracker`** — one item per task in the designated issue tracker (GitHub Issues, Jira, Linear, `bd`/beads). Map the Step 4 structure onto the tracker's fields: acceptance criteria and verification steps in the item body, dependencies via the tracker's linking mechanism (`bd dep add`, "blocked by", etc.). Record Step 5 checkpoints as tracker items too, or keep them as a checklist in the plan document if the tracker has no natural equivalent.
|
|
63
|
+
|
|
64
|
+
With a tracker, name it in the plan (e.g. "Tasks tracked in Linear project FOO") so downstream steps and future sessions know where to look, and keep the plan's `## Task List` section as an ordered index of tracker item IDs or links rather than a duplicate checklist.
|
|
65
|
+
|
|
66
|
+
**Never overwrite an incomplete plan.** Before writing the resolved plan path, check whether it already exists and still contains unchecked tasks:
|
|
67
|
+
|
|
68
|
+
- Same work being replanned (the user asked to revise or extend this plan) → update the existing file in place.
|
|
69
|
+
- Different work → **stop and ask.** The unchecked tasks may be mid-build in another session or another flow worktree. Do not delete, overwrite, or rename the existing plan on your own; present the conflict and let the user decide (finish the old plan first, explicitly discard it, or say where the new plan should go).
|
|
70
|
+
|
|
71
|
+
The same rule applies to a tracker target: never bulk-close or delete another plan's open items to make room for new ones.
|
|
55
72
|
|
|
56
73
|
## The Planning Process
|
|
57
74
|
|
|
@@ -64,11 +81,11 @@ Before writing any code, operate in read-only mode:
|
|
|
64
81
|
- Map dependencies between components
|
|
65
82
|
- Note risks and unknowns
|
|
66
83
|
|
|
67
|
-
**Do NOT write code during planning.** The output is a plan document, not implementation.
|
|
84
|
+
**Do NOT write code during planning.** The output is a plan document and a task list recorded in the task list target (see Output Location), not implementation.
|
|
68
85
|
|
|
69
86
|
**Grilling (required before writing tasks):** Read the shared internal helper at [`../_internal/grilling.md`](../_internal/grilling.md). Inventory load-bearing decisions. Skip anything already explicit in chat, prompt, PRD, spec, or rules. Grill every remaining fork (multiple valid ways, contradiction, competing code patterns) one question at a time, with a recommended option. Do not write tasks while a load-bearing choice is still silently assumed. Update Architecture Decisions, Risks, and Open Questions with accepted, rejected, or deferred choices. If nothing is open, note that grilling found no unspecified forks and continue.
|
|
70
87
|
|
|
71
|
-
**Model poll (planner, when `delegate` is available):** On an unresolved architectural fork at task tier `feature` or `project`, run `voice-1`, `voice-2`, and `voice-3` **after** recon (`scout`/`rules`), never in the same message, with a character-for-character identical instruction. Do not poll on `trivial`/`small` (delegation is off) and do not invent a poll if `delegate` is missing. Agreement becomes an accepted architectural decision in the plan, naming the voices; write a `POLL-{prd-name}.md` digest next to the plan and cite it. Divergence becomes one `ASK_USER:` question with one option per position plus a recommendation and reason — do not write the plan in that same turn. The optional communication contract at [
|
|
88
|
+
**Model poll (planner, when `delegate` is available):** On an unresolved architectural fork at task tier `feature` or `project`, run `voice-1`, `voice-2`, and `voice-3` **after** recon (`scout`/`rules`), never in the same message, with a character-for-character identical instruction. Do not poll on `trivial`/`small` (delegation is off) and do not invent a poll if `delegate` is missing. Agreement becomes an accepted architectural decision in the plan, naming the voices; write a `POLL-{prd-name}.md` digest next to the plan and cite it. Divergence becomes one `ASK_USER:` question with one option per position plus a recommendation and reason — do not write the plan in that same turn. The optional communication contract at [`../../references/communication-contract.md`](../../references/communication-contract.md) is not loaded automatically; enable it with `append-prompt: references/communication-contract.md` in `## agent-hub`.
|
|
72
89
|
|
|
73
90
|
### Step 2: Identify the Dependency Graph
|
|
74
91
|
|
|
@@ -116,7 +133,7 @@ Each vertical slice delivers working, testable functionality.
|
|
|
116
133
|
|
|
117
134
|
### Step 4: Write Tasks
|
|
118
135
|
|
|
119
|
-
Each task follows this structure:
|
|
136
|
+
Each task follows this structure, whether it lands in the plan's `## Task List`, a standalone `todo.md`, or an external tracker item (see Output Location):
|
|
120
137
|
|
|
121
138
|
```markdown
|
|
122
139
|
## Task [N]: [Short descriptive title]
|
|
@@ -128,8 +145,8 @@ Each task follows this structure:
|
|
|
128
145
|
- [ ] [Specific, testable condition]
|
|
129
146
|
|
|
130
147
|
**Verification:**
|
|
131
|
-
- [ ] Tests pass: `
|
|
132
|
-
- [ ] Build succeeds:
|
|
148
|
+
- [ ] Tests pass: [the project's `quality:` command, or the repository's focused-test command]
|
|
149
|
+
- [ ] Build succeeds: [the repository's build command]
|
|
133
150
|
- [ ] Manual check: [description of what to verify]
|
|
134
151
|
|
|
135
152
|
**Dependencies:** [Task numbers this depends on, or "None"]
|
|
@@ -148,7 +165,7 @@ Arrange tasks so that:
|
|
|
148
165
|
3. Verification checkpoints occur after every 2-3 tasks
|
|
149
166
|
4. High-risk tasks are early (fail fast)
|
|
150
167
|
|
|
151
|
-
Add explicit checkpoints:
|
|
168
|
+
Add explicit checkpoints to the task list target:
|
|
152
169
|
|
|
153
170
|
```markdown
|
|
154
171
|
## Checkpoint: After Tasks 1-3
|
|
@@ -213,6 +230,8 @@ If a task is 5-8 files (Multi-component feature , such as Search with filtering
|
|
|
213
230
|
- [Question needing human input]
|
|
214
231
|
```
|
|
215
232
|
|
|
233
|
+
When tasks live in an external tracker, keep the Task List section above as an ordered index of tracker item IDs or links instead of a duplicate checklist.
|
|
234
|
+
|
|
216
235
|
## Parallelization Opportunities
|
|
217
236
|
|
|
218
237
|
When multiple agents or sessions are available:
|
|
@@ -229,6 +248,7 @@ When multiple agents or sessions are available:
|
|
|
229
248
|
| "The tasks are obvious" | Write them down anyway. Explicit tasks surface hidden dependencies and forgotten edge cases. |
|
|
230
249
|
| "Planning is overhead" | Planning is the task. Implementation without a plan is just typing. |
|
|
231
250
|
| "I can hold it all in my head" | Context windows are finite. Written plans survive session boundaries and compaction. |
|
|
251
|
+
| "The old plan is stale, I'll just replace it" | Unchecked tasks may be mid-build in another session or flow worktree. Overwriting them destroys work state that exists nowhere else. Stop and ask. |
|
|
232
252
|
| "The PRD already covers everything, no need to grill" | Then grilling produces zero questions. Still run the inventory so silent forks do not slip through. |
|
|
233
253
|
| "I'll pick the obvious variant and note it in Architecture Decisions" | If more than one variant exists and none was mandated, it is not obvious to the programmer who was not in the room. Ask, then record the choice. |
|
|
234
254
|
| "Re-confirming the PRD points shows thoroughness" | Re-asking settled requirements wastes the user and implies the agent did not read them. Skip them. |
|
|
@@ -236,6 +256,8 @@ When multiple agents or sessions are available:
|
|
|
236
256
|
## Red Flags
|
|
237
257
|
|
|
238
258
|
- Starting implementation without a written task list
|
|
259
|
+
- Overwriting a plan that still has unchecked tasks for different work, without asking
|
|
260
|
+
- Writing a `todo.md` when the project has designated an external tracker (or scattering tasks across both)
|
|
239
261
|
- Tasks that say "implement the feature" without acceptance criteria
|
|
240
262
|
- No verification steps in the plan
|
|
241
263
|
- All tasks touches more than 8+ files
|
|
@@ -252,6 +274,8 @@ Before starting implementation, confirm:
|
|
|
252
274
|
- [ ] Every task has acceptance criteria
|
|
253
275
|
- [ ] Every task has a verification step
|
|
254
276
|
- [ ] Task dependencies are identified and ordered correctly
|
|
277
|
+
- [ ] Tasks are recorded in the task list target resolved from `todo` (default: the plan's `## Task List`)
|
|
278
|
+
- [ ] No pre-existing incomplete plan was overwritten without explicit user confirmation
|
|
255
279
|
- [ ] No task touches more than ~5 files
|
|
256
280
|
- [ ] Checkpoints exist between major phases
|
|
257
281
|
- [ ] The human has reviewed and approved the plan
|
|
@@ -262,4 +286,4 @@ Before starting implementation, confirm:
|
|
|
262
286
|
|
|
263
287
|
## See Also
|
|
264
288
|
|
|
265
|
-
Acceptance criteria are per-task and answer "did we build the right thing?". They sit on top of the project-wide Definition of Done, the standing bar every task clears before it counts as done. See
|
|
289
|
+
Acceptance criteria are per-task and answer "did we build the right thing?". They sit on top of the project-wide Definition of Done, the standing bar every task clears before it counts as done. See `../../references/definition-of-done.md`.
|