@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
|
@@ -0,0 +1,338 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: constraint-driven-development
|
|
3
|
+
description: Establishes a project's quality bar as a written contract and stops agents quietly lowering it. Interviews the user on which dimensions matter, supplies sane default thresholds when they have no number in mind, records everything in CONSTRAINTS.md, and watches the diff for a weakened bar — new @ts-ignore or eslint-disable suppressions, skipped or deleted tests, assertions stripped out, unimplemented stubs, thresholds edited down. Use when no quality bar is written down, when the user says "set up constraints" or "define our standards", when the user wants dimensions they care about — accessibility, web performance, coverage — set up as enforced constraints, when an agent keeps silencing checks or skipping tests to get to green, when you need a coverage or performance threshold and don't know what number to pick, or when an agent writes more code than anyone will read.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Constraint-Driven Development
|
|
7
|
+
|
|
8
|
+
## Overview
|
|
9
|
+
|
|
10
|
+
Other skills in this pack describe what good looks like. `code-review-and-quality` gives you five axes. `test-driven-development` gives you a cycle. `security-and-hardening` gives you a threat list. All of that lives in prose the agent reads and may or may not follow, and none of it survives the end of the session.
|
|
11
|
+
|
|
12
|
+
This skill produces something different: a written record of **this project's** bar, with numbers, that outlives the conversation and can be checked mechanically.
|
|
13
|
+
|
|
14
|
+
The reason matters. When you wrote the code, reading it told you whether it was any good. An agent writes more in an afternoon than you will read that week, so the judgement moves out of your head and into checks that run around the loop. Those checks need to exist, they need numbers you actually chose, and they need to fire close enough to the work that the agent fixes its own output.
|
|
15
|
+
|
|
16
|
+
Spec-driven development says what to build. Test-driven development proves it works. Constraint-driven development defines what "good enough to ship" means, before anyone argues about it in a pull request.
|
|
17
|
+
|
|
18
|
+
## When to Use
|
|
19
|
+
|
|
20
|
+
Apply this skill when:
|
|
21
|
+
|
|
22
|
+
- Starting a project or a significant feature and no quality bar is written down
|
|
23
|
+
- The user asks to "set up constraints", "add quality gates", "define our standards", or "stop the agent shipping junk"
|
|
24
|
+
- An agent is producing volume nobody is reading line by line
|
|
25
|
+
- CI has checks but nobody can say which ones block a merge and which ones are decoration
|
|
26
|
+
- Coverage, performance, or accessibility numbers get argued about per-PR instead of decided once
|
|
27
|
+
- You're about to run `/build auto` or any autonomous loop, and the only thing standing between it and main is a test suite the agent also wrote
|
|
28
|
+
|
|
29
|
+
**When NOT to use:**
|
|
30
|
+
|
|
31
|
+
- The project already has a `CONSTRAINTS.md` and the user isn't changing it — read it and follow it instead
|
|
32
|
+
- One-off scripts, spikes, throwaway prototypes
|
|
33
|
+
- The user wants a code review right now (`code-review-and-quality`) or a CI pipeline built (`ci-cd-and-automation`)
|
|
34
|
+
- Pre-product-market-fit code with a two-week expected lifetime — the floor below is still worth it, the rest isn't
|
|
35
|
+
|
|
36
|
+
## Loading Constraints
|
|
37
|
+
|
|
38
|
+
The interview needs a live user. **Don't run it in non-interactive contexts** — CI, a headless `just flow` run, or any autonomous loop. If constraints are missing and you're in one of those, apply the Floor below, note that you did, and flag the rest for a human.
|
|
39
|
+
|
|
40
|
+
## The Process
|
|
41
|
+
|
|
42
|
+
### Step 1: Detect before you ask
|
|
43
|
+
|
|
44
|
+
Never ask what you can read. Before the first question, gather:
|
|
45
|
+
|
|
46
|
+
| What | Where to look |
|
|
47
|
+
|------|---------------|
|
|
48
|
+
| Language and stack | `package.json`, `pyproject.toml`, `go.mod`, `Cargo.toml` |
|
|
49
|
+
| Test runner | dev dependencies, `test` script, existing test files |
|
|
50
|
+
| Existing linters | `eslint.config.*`, `biome.json`, `.ruff.toml` |
|
|
51
|
+
| Coverage today | `coverage/` output, or run the suite once |
|
|
52
|
+
| CI | `.github/workflows/`, `.gitlab-ci.yml` |
|
|
53
|
+
| Existing Fleet gate | `quality:` under `## workflows` in `.ai/agent-fleet-overrides.md` |
|
|
54
|
+
| Agent harness | `.pi/`, `.ai/agent-fleet-overrides.md`, `AGENTS.md` |
|
|
55
|
+
|
|
56
|
+
Report what you found in two lines, then ask only what's left.
|
|
57
|
+
|
|
58
|
+
### Step 2: Four questions, each with a default
|
|
59
|
+
|
|
60
|
+
Follow the one-question-at-a-time discipline from `interview-me`, with one change: every question here has a default, so "I don't know" is a complete answer that still produces a working config.
|
|
61
|
+
|
|
62
|
+
```
|
|
63
|
+
Q1: Beyond the floor, which of these do you want enforced?
|
|
64
|
+
(a) Test coverage on new code
|
|
65
|
+
(b) Security scanning
|
|
66
|
+
(c) Performance budgets
|
|
67
|
+
(d) Accessibility
|
|
68
|
+
(e) Architecture boundaries
|
|
69
|
+
GUESS: (a) and (b) — you have a test runner already and you're handling user input.
|
|
70
|
+
DEFAULT if unsure: (a) and (b).
|
|
71
|
+
Say what each pick costs: (c) and (d) need a running URL, (e) needs a rules file written.
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
```
|
|
75
|
+
Q2: When a check fails while the agent is mid-task, should it block or warn?
|
|
76
|
+
GUESS: Block. You're running agents unattended and a warning nobody reads is a warning.
|
|
77
|
+
DEFAULT if unsure: Block on the floor, warn on everything else for the first two weeks.
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
```
|
|
81
|
+
Q3: Do you have target numbers in mind, or should I measure where you are today and hold that line?
|
|
82
|
+
GUESS: Measure. Most teams don't have a number, and an invented one gets ignored.
|
|
83
|
+
DEFAULT if unsure: Measure and hold. See "Ratchets" below.
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
```
|
|
87
|
+
Q4: What's the slowest check you'll tolerate before the agent hands work back?
|
|
88
|
+
GUESS: About 90 seconds. Longer and you'll stop running it.
|
|
89
|
+
DEFAULT if unsure: 90 seconds at task end, unlimited in CI.
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
Stop at four. A twelve-question intake produces a config nobody understands and a user who regrets starting.
|
|
93
|
+
|
|
94
|
+
### Step 3: Write CONSTRAINTS.md
|
|
95
|
+
|
|
96
|
+
One file at the repo root. Any agent on any harness can read it, and a change to it shows up in review where it belongs.
|
|
97
|
+
|
|
98
|
+
> **In a Fleet project the two halves live apart, on purpose.** `CONSTRAINTS.md` carries
|
|
99
|
+
> the *dimensions, the numbers, and the reason for each number* — it is what a human reads
|
|
100
|
+
> and what review diffs. The *executable gate* is `quality:` under `## workflows` in
|
|
101
|
+
> `.ai/agent-fleet-overrides.md`, which is the one command `just flow` runs; there is no
|
|
102
|
+
> implicit fallback, and a missing or empty value is a startup refusal (exit `3`). Write
|
|
103
|
+
> the command in `quality:` and cite it from the `Checked by` column. Never let
|
|
104
|
+
> `CONSTRAINTS.md` name a gate command that `quality:` does not run — that is the drift
|
|
105
|
+
> this split exists to prevent.
|
|
106
|
+
|
|
107
|
+
```markdown
|
|
108
|
+
# Constraints
|
|
109
|
+
|
|
110
|
+
Last reviewed: 2026-08-08 by @addy
|
|
111
|
+
|
|
112
|
+
## Floor (always enforced, no setup required)
|
|
113
|
+
|
|
114
|
+
- No new suppression comments: `@ts-ignore`, `eslint-disable`, `# noqa`, `# type: ignore`
|
|
115
|
+
- No unimplemented stubs: `throw new Error("Not implemented")`, empty `catch {}`
|
|
116
|
+
- No skipped or deleted tests without a reason in the commit message
|
|
117
|
+
- No secrets in source
|
|
118
|
+
- This file does not get weakened to make a change pass
|
|
119
|
+
|
|
120
|
+
## Enforced with numbers
|
|
121
|
+
|
|
122
|
+
| Dimension | Rule | Checked by | Runs at |
|
|
123
|
+
|-----------|------|-----------|---------|
|
|
124
|
+
| Types | Zero type errors | `tsc --noEmit` | every edit |
|
|
125
|
+
| Lint | Zero errors from our config | `biome check` | every edit |
|
|
126
|
+
| Secrets | No secrets in source | `gitleaks detect --redact` | every edit |
|
|
127
|
+
| Coverage | Changed lines ≥ 80% covered | `vitest run --coverage` + git diff | task end, CI |
|
|
128
|
+
| Security: code | No high findings | `semgrep scan --config p/default` | CI |
|
|
129
|
+
| Security: deps | Nothing at high or above | `osv-scanner scan source -r .` | CI |
|
|
130
|
+
| Accessibility | Zero critical or serious | `axe $PREVIEW_URL --tags wcag2a,wcag2aa,wcag21aa` | preview deploy |
|
|
131
|
+
| Performance | LCP ≤ 2500ms, CLS ≤ 0.1 | `lighthouse $PREVIEW_URL --output=json` | preview deploy |
|
|
132
|
+
|
|
133
|
+
Every row names the command that produces the verdict. A dimension with a
|
|
134
|
+
number and no command in this column is an aspiration, not a constraint.
|
|
135
|
+
|
|
136
|
+
## Measured, not yet enforced
|
|
137
|
+
|
|
138
|
+
| Metric | Today | Direction |
|
|
139
|
+
|--------|-------|-----------|
|
|
140
|
+
| Project coverage | 62.4% | must not fall |
|
|
141
|
+
| Bundle size (main) | 184 kB | must not grow |
|
|
142
|
+
|
|
143
|
+
## Exceptions
|
|
144
|
+
|
|
145
|
+
| ID | Rule | Path | Reason | Owner | Expires |
|
|
146
|
+
|----|------|------|--------|-------|---------|
|
|
147
|
+
| W1 | `no-explicit-any` | `src/legacy/**` | Rewrite tracked in ENG-441 | @addy | 2026-11-01 |
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
Then make the file discoverable. In a Fleet project the agent-facing pointer belongs in
|
|
151
|
+
`.ai/agent-fleet-overrides.md` — the harnesses already read it and the deterministic CLI
|
|
152
|
+
owns it. Adding the same line to a human-owned `AGENTS.md` or `CLAUDE.md` is optional and
|
|
153
|
+
needs the user's say-so first; never edit those two silently.
|
|
154
|
+
|
|
155
|
+
```
|
|
156
|
+
Read CONSTRAINTS.md before writing code. Do not weaken it to make a change pass.
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
### Step 4: Install what each dimension needs
|
|
160
|
+
|
|
161
|
+
Picking a dimension means installing something. Don't leave the user with a number and no mechanism, and don't invent your own checker when a de facto one exists — these tools are listed because their rule formats and thresholds are what everything else in the ecosystem targets, so the team's existing config keeps working.
|
|
162
|
+
|
|
163
|
+
| Dimension | Tool | Install | Run | Gate on |
|
|
164
|
+
|-----------|------|---------|-----|---------|
|
|
165
|
+
| Types (TS) | tsc | already there | `tsc --noEmit` | any error |
|
|
166
|
+
| Types (Python) | mypy | `pip install mypy` | `mypy .` | any error |
|
|
167
|
+
| Lint | your existing config | already there | `eslint .` / `biome check` / `ruff check` | any error |
|
|
168
|
+
| Coverage (JS) | your test runner | already there | `vitest run --coverage` (or `jest --coverage`) | coverage of changed lines |
|
|
169
|
+
| Coverage (Python) | pytest-cov | `pip install pytest-cov` | `pytest --cov --cov-report=lcov` | same |
|
|
170
|
+
| Security: code | Semgrep | `pipx install semgrep` | `semgrep scan --config p/default --config p/owasp-top-ten` | any high finding |
|
|
171
|
+
| Security: secrets | gitleaks | `brew install gitleaks` | `gitleaks detect --redact --no-banner` | any finding |
|
|
172
|
+
| Security: dependencies | osv-scanner | `brew install osv-scanner` | `osv-scanner scan source -r .` | high or above |
|
|
173
|
+
| Performance: page | Lighthouse | `npm i -D lighthouse` | `lighthouse $URL --output=json --quiet` | LCP, CLS, performance score |
|
|
174
|
+
| Performance: bundle | size-limit | `npm i -D size-limit` | `size-limit --json` | per-entry byte budget |
|
|
175
|
+
| Accessibility | axe-core | `npm i -D @axe-core/cli` | `axe $URL --tags wcag2a,wcag2aa,wcag21aa` | zero critical or serious |
|
|
176
|
+
| Architecture | dependency-cruiser | `npm i -D dependency-cruiser` | `depcruise --validate src` | any violation |
|
|
177
|
+
| Assertion quality | Stryker | `npm i -D @stryker-mutator/core` | `stryker run --mutate <changed files>` | mutation score |
|
|
178
|
+
|
|
179
|
+
Five things that will bite you if you skip them:
|
|
180
|
+
|
|
181
|
+
1. **`--redact` on gitleaks is not optional.** Without it the matched secret lands in the agent's transcript, which is how a leaked key ends up in a log, a summary, or a commit message. Report the rule and the location, never the value.
|
|
182
|
+
2. **Lighthouse and axe need a URL.** They only work against a running app, so they belong in the runtime stage against a preview deploy or a local server you start first. If the project has no URL to hit — a CLI, a library, a desktop app — say so and drop the dimension rather than inventing a check that can't run.
|
|
183
|
+
3. **Scope the expensive ones to the diff.** `stryker run --mutate` on the whole repo takes hours and gets turned off; on the files a change touched it takes under a minute. Same for Semgrep, which takes a path list.
|
|
184
|
+
4. **Coverage needs no second test run.** Read the lcov your suite already writes and intersect it with `git diff`. Running the suite twice to get a number is the fastest way to make people hate this.
|
|
185
|
+
5. **Semgrep's registry rules are free to run; check the licence before redistributing them.** `opengrep` is a drop-in fork with the same rule format and JSON output if that matters to your legal team.
|
|
186
|
+
|
|
187
|
+
Add each one to the project's own script so it's reproducible without an agent:
|
|
188
|
+
|
|
189
|
+
```json
|
|
190
|
+
{
|
|
191
|
+
"scripts": {
|
|
192
|
+
"check:fast": "tsc --noEmit && eslint . && gitleaks detect --redact --no-banner",
|
|
193
|
+
"check:task": "npm run check:fast && vitest run --coverage",
|
|
194
|
+
"check:full": "npm run check:task && semgrep scan --config p/default && osv-scanner scan source -r ."
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
```
|
|
198
|
+
|
|
199
|
+
That mapping matters more than the tools. `check:fast` is what runs after an edit, `check:task` when the agent thinks it's done, `check:full` in CI.
|
|
200
|
+
|
|
201
|
+
**In a Fleet project, `quality:` points at the task-end script.** Set
|
|
202
|
+
`quality: npm run check:task` (or whatever the project's equivalent is) under
|
|
203
|
+
`## workflows` in `.ai/agent-fleet-overrides.md`. That is what `just flow` executes, so it
|
|
204
|
+
is the one command that actually blocks a flow from being accepted.
|
|
205
|
+
|
|
206
|
+
The commands now live in two places — the `Checked by` column in `CONSTRAINTS.md` and these scripts. `CONSTRAINTS.md` is the canonical source *for the reasoning*: it carries why each number is what it is, and it shows up in review. The scripts are the mechanism, and `quality:` is the one the runtime obeys. If the file and the scripts drift, the file wins and the scripts get fixed.
|
|
207
|
+
|
|
208
|
+
### Step 5: Wire it to the lifecycle
|
|
209
|
+
|
|
210
|
+
The single biggest mistake is running everything everywhere. A check that stalls the agent gets switched off, and a gate people switched off is worse than no gate, because the bar still looks like it exists.
|
|
211
|
+
|
|
212
|
+
| Phase | Command | What runs | Budget |
|
|
213
|
+
|-------|---------|-----------|--------|
|
|
214
|
+
| BUILD | `/af-build` | Types, lint, secrets, the floor | under 5s, changed file only |
|
|
215
|
+
| VERIFY | `/af-test` | Related tests, coverage on changed lines | under 90s |
|
|
216
|
+
| REVIEW | `/af-review` | Everything, plus the guards below | minutes |
|
|
217
|
+
| SHIP | `/af-ship` | Direction checks, no regressions | CI |
|
|
218
|
+
| FLOW | `just flow` | Whatever `quality:` names — the gate that decides acceptance | per flow |
|
|
219
|
+
|
|
220
|
+
Two rules that keep this tolerable:
|
|
221
|
+
|
|
222
|
+
1. **Scope to the diff.** Check the lines this change touched, not the whole repo. Coverage of changed lines is a number the agent can move; project coverage is one it inherited.
|
|
223
|
+
2. **Cost decides placement.** Anything over a few seconds moves out of the edit loop. Mutation testing on a whole repo takes hours; on the files a change touched it takes under a minute, which is the difference between a check people run and one they don't.
|
|
224
|
+
|
|
225
|
+
### Step 6: Guard the bar itself
|
|
226
|
+
|
|
227
|
+
Someone will point out that if the agent writes the code and the checks, the checks prove nothing. Half right, and worth engineering around.
|
|
228
|
+
|
|
229
|
+
Agents don't craft clever loopholes. They hit a red check and take the cheapest road to green. Watch for these five moves in the diff, at review time:
|
|
230
|
+
|
|
231
|
+
1. **The threshold moved.** A budget lowered, a severity dropped, a check removed from the fast stage. Compare `CONSTRAINTS.md` against its state at the branch point.
|
|
232
|
+
2. **A test got easier.** `.skip` added, a test file deleted, assertions pulled out of tests that stayed.
|
|
233
|
+
3. **A checker got silenced.** New `@ts-ignore` or `eslint-disable`. Four suppressions deserve special attention because they switch off a check you're relying on: `istanbul ignore` drops code from coverage instead of testing it, `Stryker disable` hides a surviving mutant, `nosemgrep` and `gitleaks:allow` do it for security findings.
|
|
234
|
+
4. **Work is unfinished.** A stub that throws, an empty `catch` turning a failure into silence, a `TODO` standing where the implementation should be.
|
|
235
|
+
5. **An exception appeared.** A new row in the Exceptions table nobody discussed.
|
|
236
|
+
|
|
237
|
+
None of this needs tooling beyond `git diff`. Tightening the bar should be silent; loosening it should be loud.
|
|
238
|
+
|
|
239
|
+
Unlike the numbered dimensions, the floor has no de facto tool of its own, so an agent asked to enforce it tends to write a checker from scratch, and two agents write two different ones. A reference implementation of these five checks ships with this skill in [references/floor-guard.md](references/floor-guard.md) (diff-scoped, exit `0`/`1`/`2`, patterns adaptable per ecosystem). Adapt that rather than reinventing it, for the same reason every dimension names a de facto tool: so the mechanism is the same across runs and stacks.
|
|
240
|
+
|
|
241
|
+
**Not all checks are equally circular.** Rank them by one question: can the agent make this pass by writing code that doesn't work?
|
|
242
|
+
|
|
243
|
+
- **External** — axe-core encodes WCAG, `osv-scanner` reads a vulnerability database, Lighthouse measures a real browser. The agent can't argue with these.
|
|
244
|
+
- **Project** — your lint rules, your layer boundaries. A human owns the file.
|
|
245
|
+
- **Suite** — your own tests. Most useful, and the only genuinely circular one.
|
|
246
|
+
|
|
247
|
+
A bar made entirely of the third kind is worth less than one with an outside opinion in it. Check that at least one external constraint is present.
|
|
248
|
+
|
|
249
|
+
### Step 7: Ratchets, when you don't have a number
|
|
250
|
+
|
|
251
|
+
Set 80% coverage on a codebase at 62% and you get a red build forever, then a team that learns to ignore red builds.
|
|
252
|
+
|
|
253
|
+
The alternative asks for no decision: record where you are, then refuse to get worse. Put it in the "Measured, not yet enforced" table with today's number and a direction. Every check compares against the recorded value, not an aspiration. When a number improves, update it; when it drops, that's the finding.
|
|
254
|
+
|
|
255
|
+
This also answers a fair objection to training. Models are rewarded for passing tests, which you can evaluate in seconds. Architectural rot shows up over months and never reaches the weights. A ratchet is the missing penalty, written down where the build can see it.
|
|
256
|
+
|
|
257
|
+
## Sane Defaults
|
|
258
|
+
|
|
259
|
+
When the user has no opinion, use these. They're chosen to be met by most codebases on day one.
|
|
260
|
+
|
|
261
|
+
| Constraint | Default | Why this number |
|
|
262
|
+
|------------|---------|-----------------|
|
|
263
|
+
| Coverage of changed lines | ≥ 80% | High enough to force a test, low enough to allow a config line |
|
|
264
|
+
| Project coverage | today's value, must not fall | No argument needed to adopt |
|
|
265
|
+
| Mutation score (if used) | ≥ 60% to start | Typical for a suite never mutated before; 80% is mature |
|
|
266
|
+
| Dependency vulnerabilities | nothing at high or above | Below that is mostly noise |
|
|
267
|
+
| LCP | ≤ 2500 ms | Core Web Vitals "good" threshold |
|
|
268
|
+
| CLS | ≤ 0.1 | Same |
|
|
269
|
+
| Accessibility | zero critical or serious axe violations | Moderate and minor are often debatable |
|
|
270
|
+
| Exception lifetime | 90 days | Long enough to plan the fix, short enough to remember |
|
|
271
|
+
| Ratchet tolerance | 0.5% | Absorbs drift when an unrelated file moves the number |
|
|
272
|
+
|
|
273
|
+
State the number and the reason together. A threshold without a rationale gets deleted by the next person who hits it.
|
|
274
|
+
|
|
275
|
+
## Escalation Path
|
|
276
|
+
|
|
277
|
+
Constraints work at three levels of teeth. Start at the first.
|
|
278
|
+
|
|
279
|
+
1. **Written only.** `CONSTRAINTS.md` exists and agents read it. Costs nothing, catches the honest mistakes, relies on the agent complying.
|
|
280
|
+
2. **Scripted.** An `npm run check` (or `make check`) that runs the fast checks, wired into your agent's post-edit hook and your CI. Deterministic, no new dependency.
|
|
281
|
+
3. **Tool-backed.** A dedicated runner that handles diff scoping, budgets, ratchets, and the guard checks. Use when the config outgrows a shell script. The floor-guard reference in [references/floor-guard.md](references/floor-guard.md) is the starting point for the guard-checks half of this.
|
|
282
|
+
|
|
283
|
+
Most projects should stop at 2. Move to 3 when you're maintaining more than about thirty lines of check-running shell.
|
|
284
|
+
|
|
285
|
+
**A first run can be floor-only.** The floor guard is diff-only and needs no installs, so you can enforce the floor on day one and add numbered dimensions as you install each tool, rather than standing up every checker before the first commit is protected. Security tools that install machine-wide (gitleaks, osv-scanner) can also run CI-only if you'd rather keep laptops clean; declare where each dimension runs in the `Runs at` column.
|
|
286
|
+
|
|
287
|
+
## Common Rationalizations
|
|
288
|
+
|
|
289
|
+
| Excuse | Reality |
|
|
290
|
+
|--------|---------|
|
|
291
|
+
| "We'll add constraints once the code settles" | Code settles around whatever was allowed while it was moving |
|
|
292
|
+
| "The tests are the constraints" | Tests you wrote prove you agree with yourself; they say nothing about coverage of new code, dependency risk, or bundle growth |
|
|
293
|
+
| "We can't hit 80% coverage" | Then don't set 80%. Set today's number and hold it |
|
|
294
|
+
| "This will slow the agent down" | Only if you put slow checks in the fast loop. That's a placement error, not an argument against constraints |
|
|
295
|
+
| "I'll remember what our standards are" | The agent won't, and it's writing most of the code |
|
|
296
|
+
| "Constraints will block us shipping" | An exception with an owner and a date unblocks you. Deleting the constraint unblocks everyone forever |
|
|
297
|
+
|
|
298
|
+
## Red Flags
|
|
299
|
+
|
|
300
|
+
Stop and reconsider if you notice:
|
|
301
|
+
|
|
302
|
+
- The interview ran past four questions, or produced a config the user can't explain
|
|
303
|
+
- A budget was set that the codebase fails today, with no plan to reach it
|
|
304
|
+
- A dimension was written into CONSTRAINTS.md with a number but no tool behind it
|
|
305
|
+
- A checker was hand-rolled when a de facto one exists, so the team's existing config is ignored
|
|
306
|
+
- Every constraint is checked by the project's own test suite, with no external opinion
|
|
307
|
+
- `CONSTRAINTS.md` changed in the same commit as the feature that was failing
|
|
308
|
+
- An exception has no owner, or an expiry more than a year out
|
|
309
|
+
- The agent proposed relaxing a threshold instead of fixing the code
|
|
310
|
+
- Slow checks landed in the edit loop and someone has started passing `--no-verify`
|
|
311
|
+
- Nobody has opened `CONSTRAINTS.md` since it was written
|
|
312
|
+
|
|
313
|
+
## Verification
|
|
314
|
+
|
|
315
|
+
The skill was applied correctly when:
|
|
316
|
+
|
|
317
|
+
- [ ] `CONSTRAINTS.md` exists, and every number in it has a stated reason
|
|
318
|
+
- [ ] The floor is enforced and passes on the current codebase without changes
|
|
319
|
+
- [ ] Every dimension the user picked has a tool installed and a command that runs today
|
|
320
|
+
- [ ] Each constraint says where it runs, and the fast stage stays under a few seconds
|
|
321
|
+
- [ ] At least one constraint is external (not judged by this project's own tests)
|
|
322
|
+
- [ ] Measured-only metrics record today's value and a direction
|
|
323
|
+
- [ ] Exceptions have an owner and an expiry date
|
|
324
|
+
- [ ] `AGENTS.md` or `CLAUDE.md` points at the file
|
|
325
|
+
- [ ] A trial run on the current branch produces no failures the user disagrees with
|
|
326
|
+
|
|
327
|
+
## See Also
|
|
328
|
+
|
|
329
|
+
- `interview-me` — the one-question-at-a-time discipline this skill's intake borrows
|
|
330
|
+
- `code-review-and-quality` — how to review; this skill decides what the review enforces
|
|
331
|
+
- `ci-cd-and-automation` — building the pipeline these constraints run in
|
|
332
|
+
- `test-driven-development` — the suite that coverage and mutation constraints measure
|
|
333
|
+
- `security-and-hardening` — what the security dimension should contain
|
|
334
|
+
- `performance-optimization` — where the performance numbers come from
|
|
335
|
+
|
|
336
|
+
## See Also
|
|
337
|
+
|
|
338
|
+
Constraints are the *numbers* layered on top of the project-wide Definition of Done — the standing, unnumbered bar every change clears regardless of task. This skill does not restate it; see [`../../references/definition-of-done.md`](../../references/definition-of-done.md). The floor below duplicates none of it: the Definition of Done says the work is finished, the floor says the bar was not quietly lowered to get there.
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
# Floor guard: reference implementation
|
|
2
|
+
|
|
3
|
+
Every numbered dimension in `CONSTRAINTS.md` maps to a de facto tool (Step 4). The **floor** does not: it is a diff-scoped check for the five moves in Step 6, and without a shipped reference every agent invents its own, so two runs (or a Python repo and a Go one) produce two different guards. That is the exact non-determinism this skill exists to remove.
|
|
4
|
+
|
|
5
|
+
This is the reference. Adapt the patterns to your stack; keep the contract identical.
|
|
6
|
+
|
|
7
|
+
## Contract
|
|
8
|
+
|
|
9
|
+
- **Input:** the diff between the merge base and the working tree (added *and* removed lines, plus untracked files). A guard that reads only `git diff` misses new files and staged-but-uncommitted work.
|
|
10
|
+
- **Detects the five Step 6 moves:** a weakened threshold in `CONSTRAINTS.md`, a test made easier (`.skip`, a deleted test file, an assertion removed from a test that stayed), a silenced checker (a new suppression comment), unfinished work (a stub or empty `catch`), a new Exceptions row.
|
|
11
|
+
- **Exit codes:** `0` clean, `1` at least one floor violation (block the change), `2` the guard could not run (no merge base, not a git repo). Never let a `2` read as a `0`.
|
|
12
|
+
- **Reports the rule and the location, never the matched secret value.** Redaction is not optional (Step 4).
|
|
13
|
+
- **Tightening is silent, loosening is loud:** only surfaces moves that lower the bar.
|
|
14
|
+
|
|
15
|
+
## Reference (Node, ~stack-agnostic patterns)
|
|
16
|
+
|
|
17
|
+
```js
|
|
18
|
+
#!/usr/bin/env node
|
|
19
|
+
// floor-guard.mjs — diff-scoped enforcement of the CONSTRAINTS.md floor.
|
|
20
|
+
// Usage: node floor-guard.mjs [--base <ref>] (default base: origin/main)
|
|
21
|
+
import { execFileSync } from 'node:child_process';
|
|
22
|
+
|
|
23
|
+
const base = (() => {
|
|
24
|
+
const i = process.argv.indexOf('--base');
|
|
25
|
+
return i > -1 ? process.argv[i + 1] : 'origin/main';
|
|
26
|
+
})();
|
|
27
|
+
|
|
28
|
+
const git = (args) => {
|
|
29
|
+
try { return execFileSync('git', args, { encoding: 'utf8' }); }
|
|
30
|
+
catch { return null; }
|
|
31
|
+
};
|
|
32
|
+
|
|
33
|
+
// Merge base; bail to exit 2 rather than pretending a shallow/rootless clone is clean.
|
|
34
|
+
const mergeBase = git(['merge-base', base, 'HEAD'])?.trim();
|
|
35
|
+
if (!mergeBase) { console.error('floor-guard: no merge base against ' + base); process.exit(2); }
|
|
36
|
+
|
|
37
|
+
// Unified diff plus untracked files (git diff alone cannot see new files).
|
|
38
|
+
const tracked = git(['diff', '--unified=0', mergeBase, '--']) ?? '';
|
|
39
|
+
const untracked = (git(['ls-files', '--others', '--exclude-standard']) ?? '')
|
|
40
|
+
.split('\n').filter(Boolean)
|
|
41
|
+
.map((f) => git(['diff', '--no-index', '--unified=0', '/dev/null', f]) ?? '')
|
|
42
|
+
.join('\n');
|
|
43
|
+
const diff = tracked + '\n' + untracked;
|
|
44
|
+
|
|
45
|
+
const added = [], removed = [];
|
|
46
|
+
let file = '';
|
|
47
|
+
for (const line of diff.split('\n')) {
|
|
48
|
+
if (line.startsWith('+++ ')) file = line.slice(6);
|
|
49
|
+
else if (line.startsWith('+') && !line.startsWith('+++')) added.push({ file, text: line.slice(1) });
|
|
50
|
+
else if (line.startsWith('-') && !line.startsWith('---')) removed.push({ file, text: line.slice(1) });
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
const findings = [];
|
|
54
|
+
const flag = (rule, f, text) => findings.push({ rule, file: f, text: text.trim().slice(0, 120) });
|
|
55
|
+
|
|
56
|
+
// 1. Silenced checker — extend this list for your ecosystem.
|
|
57
|
+
const SUPPRESSIONS = /@ts-ignore|@ts-nocheck|eslint-disable|biome-ignore|# *noqa|# *type: *ignore|istanbul ignore|nosemgrep|gitleaks:allow|Stryker disable/;
|
|
58
|
+
// 4. Unfinished work.
|
|
59
|
+
const STUBS = /throw new (Error|NotImplemented).*[Nn]ot implemented|catch\s*\(\w*\)\s*\{\s*\}|catch\s*\{\s*\}|\bTODO\b|\bpass\s*# *stub/;
|
|
60
|
+
// 2. A test made easier (added skips).
|
|
61
|
+
const SKIPS = /\.(skip|todo)\b|\bxit\(|\bxdescribe\(|@pytest\.mark\.skip|t\.Skip\(/;
|
|
62
|
+
|
|
63
|
+
for (const { file, text } of added) {
|
|
64
|
+
if (SUPPRESSIONS.test(text)) flag('silenced-checker', file, text);
|
|
65
|
+
if (STUBS.test(text)) flag('unfinished-work', file, text);
|
|
66
|
+
if (SKIPS.test(text)) flag('test-made-easier', file, text);
|
|
67
|
+
if (/CONSTRAINTS\.md$/.test(file) && /^\| *(W|E)\d+ *\|/.test(text)) flag('new-exception', file, text);
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
// 2b. Assertion removed from a test file that still exists.
|
|
71
|
+
for (const { file, text } of removed) {
|
|
72
|
+
if (/\.(test|spec)\.|_test\.|test_/.test(file) && /\b(expect|assert|should)\b/.test(text)) {
|
|
73
|
+
flag('assertion-removed', file, text);
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
// 1b/2c. Weakened threshold: a number in CONSTRAINTS.md that went down, or a floor bullet deleted.
|
|
78
|
+
const nums = (s) => (s.match(/\d+(\.\d+)?/g) || []).map(Number);
|
|
79
|
+
const removedConstraints = removed.filter((l) => /CONSTRAINTS\.md$/.test(l.file));
|
|
80
|
+
const addedConstraints = added.filter((l) => /CONSTRAINTS\.md$/.test(l.file));
|
|
81
|
+
for (const r of removedConstraints) {
|
|
82
|
+
const a = addedConstraints.find((x) => x.text.split(/[|:]/)[0] === r.text.split(/[|:]/)[0]);
|
|
83
|
+
if (a && nums(a.text).some((n, i) => nums(r.text)[i] !== undefined && n < nums(r.text)[i])) {
|
|
84
|
+
flag('threshold-lowered', r.file, r.text + ' -> ' + a.text);
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
if (findings.length === 0) { console.log('floor-guard: clean'); process.exit(0); }
|
|
89
|
+
console.error('floor-guard: ' + findings.length + ' floor violation(s):');
|
|
90
|
+
for (const f of findings) console.error(` [${f.rule}] ${f.file}: ${f.text}`);
|
|
91
|
+
console.error('\nEach is a move that lowers the bar. Fix the code, or route it through a tracked exception.');
|
|
92
|
+
process.exit(1);
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
## Adapting it
|
|
96
|
+
|
|
97
|
+
- **Patterns are the only stack-specific part.** Add your language's suppression and stub forms to the three regexes; the diff plumbing, the CONSTRAINTS.md checks, and the exit codes stay as-is.
|
|
98
|
+
- **A `.constraintsignore`** (one glob per line) lets you exempt a path the guard would otherwise flag; check each added line's file against it before flagging, so a genuine exception is a tracked file rather than a loosened rule.
|
|
99
|
+
- **This is a starting point, not a finished tool.** It is deliberately regex-shallow: it catches the cheap-road-to-green moves agents actually make, not a determined human hiding a change. That is the right trade for a check that runs on every diff. Once you outgrow it, move to a real runner (Escalation Path level 3).
|
|
@@ -39,7 +39,7 @@ Structure context from most persistent to most transient:
|
|
|
39
39
|
|
|
40
40
|
Create a rules file that persists across sessions. This is the highest-leverage context you can provide.
|
|
41
41
|
|
|
42
|
-
When phrasing rules, agent prompts, or any instruction an agent will read, consult
|
|
42
|
+
When phrasing rules, agent prompts, or any instruction an agent will read, consult `../../references/prompting-patterns.md` before writing — it captures Anthropic and OpenAI guidance on positive instructions, explaining *why*, eliminating contradictions, and avoiding aggressive emphasis.
|
|
43
43
|
|
|
44
44
|
**CLAUDE.md** (for Claude Code):
|
|
45
45
|
```markdown
|
|
@@ -120,6 +120,8 @@ Long conversations accumulate stale context. Manage this:
|
|
|
120
120
|
- **Summarize progress** when context is getting long: "So far we've completed X, Y, Z. Now working on W."
|
|
121
121
|
- **Compact deliberately** — if the tool supports it, compact/summarize before critical work
|
|
122
122
|
|
|
123
|
+
For the proactive discipline that makes these last resorts unnecessary — what to cut first, what to protect, and when to start — see **Context Budget Management** below.
|
|
124
|
+
|
|
123
125
|
## Context Packing Strategies
|
|
124
126
|
|
|
125
127
|
### The Brain Dump
|
|
@@ -179,6 +181,51 @@ Key files: validation.ts, errors.ts, db.ts
|
|
|
179
181
|
|
|
180
182
|
Load only the relevant section when working on a specific area.
|
|
181
183
|
|
|
184
|
+
## Context Budget Management
|
|
185
|
+
|
|
186
|
+
The context window is not a filing cabinet — it's a working desk. As a session runs, conversation history, tool output, and exploration accumulate. Most of it becomes deadweight. Budget proactively: waiting until the window is full causes abrupt quality drops; managing regularly keeps the agent coherent through long tasks.
|
|
187
|
+
|
|
188
|
+
**Start trimming at 75% capacity, not 100%.** By the time the window is genuinely full, the model's attention is already fragmented across too many signals. The 75% threshold gives room to compress gracefully rather than cut desperately mid-task.
|
|
189
|
+
|
|
190
|
+
> In a Fleet session the `compact-and-continue` pi extension performs the mechanical half of this automatically. It does not decide *what* is worth keeping — the judgement below still belongs to the agent.
|
|
191
|
+
|
|
192
|
+
### What to cut first
|
|
193
|
+
|
|
194
|
+
| Content | When to cut |
|
|
195
|
+
|---|---|
|
|
196
|
+
| Past failed attempts and their error output | Once you've moved past them — keep the conclusion, not the journey |
|
|
197
|
+
| Verbose tool output (long `find` results, full file listings) | After you've extracted what you needed |
|
|
198
|
+
| Conversational back-and-forth | As soon as the decision is reached |
|
|
199
|
+
| Earlier drafts of code that were replaced | Immediately on replacement — the current file is the record |
|
|
200
|
+
|
|
201
|
+
### What to protect until the end
|
|
202
|
+
|
|
203
|
+
- The original task definition and key constraints
|
|
204
|
+
- The current error message or failing test output you are actively debugging
|
|
205
|
+
- The file currently being edited, or its most recent version
|
|
206
|
+
- Any hard constraints the agent has been asked to enforce (auth rules, naming conventions, etc.)
|
|
207
|
+
|
|
208
|
+
### Compress before dropping
|
|
209
|
+
|
|
210
|
+
Summarizing beats deleting. Before removing a long stretch of exploration, reduce it to one sentence capturing the conclusion:
|
|
211
|
+
|
|
212
|
+
```
|
|
213
|
+
Before: [8 messages debugging a failing import — various attempts, error logs, dead ends]
|
|
214
|
+
After: "Import issue traced to a circular dependency in src/lib/db.ts —
|
|
215
|
+
resolved by moving the shared type to src/types/index.ts."
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
The detail is gone; the decision is preserved. If the detail turns out to matter, the summary is a breadcrumb for re-investigation.
|
|
219
|
+
|
|
220
|
+
### Order for recency
|
|
221
|
+
|
|
222
|
+
Put the most task-critical content **last** in context. Models recall content at the start and end of the window more reliably than the middle (the lost-in-the-middle effect — Liu et al., 2023). Keep stable rules and specs at the start; put the active task material last, closest to the generation point:
|
|
223
|
+
|
|
224
|
+
```
|
|
225
|
+
← session start generation point →
|
|
226
|
+
[background: rules, specs, architecture] [working: current file, error, task]
|
|
227
|
+
```
|
|
228
|
+
|
|
182
229
|
## MCP Integrations
|
|
183
230
|
|
|
184
231
|
For richer context, use Model Context Protocol servers:
|
|
@@ -262,6 +309,7 @@ This catches wrong directions before you've built on them. It's a 30-second inve
|
|
|
262
309
|
| Missing examples | Agent invents a new style instead of following yours | Include one example of the pattern to follow |
|
|
263
310
|
| Implicit knowledge | Agent doesn't know project-specific rules | Write it down in rules files — if it's not written, it doesn't exist |
|
|
264
311
|
| Silent confusion | Agent guesses when it should ask | Surface ambiguity explicitly using the confusion management patterns above |
|
|
312
|
+
| Context cliff | Waiting until the window is full before managing it — attention fragments and output quality drops abruptly at the limit | Start trimming at 75% capacity; compress rather than cut |
|
|
265
313
|
|
|
266
314
|
## Common Rationalizations
|
|
267
315
|
|
|
@@ -277,7 +325,7 @@ This catches wrong directions before you've built on them. It's a 30-second inve
|
|
|
277
325
|
- Agent output doesn't match project conventions
|
|
278
326
|
- Agent invents APIs or imports that don't exist
|
|
279
327
|
- Agent re-implements utilities that already exist in the codebase
|
|
280
|
-
- Agent quality degrades as the conversation
|
|
328
|
+
- Agent quality degrades mid-task as the conversation grows — failed attempts, replaced drafts, and verbose tool output are not being trimmed
|
|
281
329
|
- No rules file exists in the project
|
|
282
330
|
- External data files or config treated as trusted instructions without verification
|
|
283
331
|
|
|
@@ -289,3 +337,5 @@ After setting up context, confirm:
|
|
|
289
337
|
- [ ] Agent output follows the patterns shown in the rules file
|
|
290
338
|
- [ ] Agent references actual project files and APIs (not hallucinated ones)
|
|
291
339
|
- [ ] Context is refreshed when switching between major tasks
|
|
340
|
+
- [ ] During long sessions, context is actively managed: failed attempts and replaced drafts removed, live error and task definition protected
|
|
341
|
+
- [ ] Task-critical content (current error, active constraint) is positioned last in context, not buried under background material
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: deprecation-and-migration
|
|
3
|
-
description: Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code.
|
|
3
|
+
description: Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Deprecation and Migration
|
|
@@ -161,6 +161,34 @@ function getTaskService(userId: string): TaskService {
|
|
|
161
161
|
}
|
|
162
162
|
```
|
|
163
163
|
|
|
164
|
+
### Database Schema Migrations (Expand/Contract)
|
|
165
|
+
|
|
166
|
+
A schema change is the riskiest migration because the data is the one thing you cannot roll back by reverting a deploy. The failure mode is coupling the schema change to the code change: rename a column in the same release that starts using the new name, and during the rollout window — when old and new code run at once — one of them is querying a column that doesn't exist. The fix is to **never change a column in place**. Migrate in additive phases so old and new code are both valid at every step.
|
|
167
|
+
|
|
168
|
+
```
|
|
169
|
+
EXPAND ──────────────→ MIGRATE ──────────────→ CONTRACT
|
|
170
|
+
add the new column, backfill existing rows, once no code reads the
|
|
171
|
+
nullable, alongside dual-write old+new from old column, drop it in
|
|
172
|
+
the old one the app a later, separate deploy
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
**Worked example — renaming `name` to `full_name`:**
|
|
176
|
+
|
|
177
|
+
1. **Expand.** Add `full_name` as nullable. Deploy. (Old code ignores it; nothing breaks.)
|
|
178
|
+
2. **Dual-write.** App writes both `name` and `full_name` on every insert/update. Deploy.
|
|
179
|
+
3. **Backfill.** Copy `name → full_name` for existing rows, in batches, so you don't lock the table.
|
|
180
|
+
4. **Switch reads.** Point the app at `full_name`, keep writing both. Deploy and bake.
|
|
181
|
+
5. **Contract.** Stop writing `name`, then — in a *separate, later* deploy — drop the column.
|
|
182
|
+
|
|
183
|
+
Each step is independently deployable and reversible: if step 4 misbehaves, roll the code back and `full_name` is still being populated. Treat each phase as a thin vertical slice — see the `incremental-implementation` skill.
|
|
184
|
+
|
|
185
|
+
**Rules:**
|
|
186
|
+
- **Additive first, destructive last and alone.** Adds (new nullable column, new table, new index) are safe in any deploy; drops and renames get their own deploy *after* no code references the old shape.
|
|
187
|
+
- **Every migration has a tested down path.** A migration you can't reverse is a deploy you can't roll back. Write and run the `down` before merging.
|
|
188
|
+
- **Backfill in batches, off the hot path.** A single `UPDATE` over millions of rows locks the table; chunk it and throttle.
|
|
189
|
+
- **Build large indexes without blocking writes** (e.g. Postgres `CREATE INDEX CONCURRENTLY`).
|
|
190
|
+
- **Decouple from code by feature flag** when the cutover is risky, exactly as in the Feature Flag Migration pattern above.
|
|
191
|
+
|
|
164
192
|
## Zombie Code
|
|
165
193
|
|
|
166
194
|
Zombie code is code that nobody owns but everybody depends on. It's not actively maintained, has no clear owner, and accumulates security vulnerabilities and compatibility issues. Signs:
|
|
@@ -183,6 +211,9 @@ Zombie code is code that nobody owns but everybody depends on. It's not actively
|
|
|
183
211
|
| "We'll deprecate it after we finish the new system" | Deprecation planning starts at design time. By the time the new system is done, you'll have new priorities. Plan now. |
|
|
184
212
|
| "Users will migrate on their own" | They won't. Provide tooling, documentation, and incentives — or do the migration yourself (the Churn Rule). |
|
|
185
213
|
| "We can maintain both systems indefinitely" | Two systems doing the same thing is double the maintenance, testing, documentation, and onboarding cost. |
|
|
214
|
+
| "Just rename the column, it's one line" | During the rollout, old and new code run together — one will query a column that no longer exists. Expand/contract, never rename in place. |
|
|
215
|
+
| "I'll add the column and drop the old one in the same migration" | That couples a safe add to a destructive drop. Drops get their own deploy, after no code references the old shape. |
|
|
216
|
+
| "We'll write the rollback if we need it" | A migration with no down path is a deploy you can't reverse. Write and run the `down` before merging. |
|
|
186
217
|
|
|
187
218
|
## Red Flags
|
|
188
219
|
|
|
@@ -193,6 +224,9 @@ Zombie code is code that nobody owns but everybody depends on. It's not actively
|
|
|
193
224
|
- New features added to a deprecated system (invest in the replacement instead)
|
|
194
225
|
- Deprecation without measuring current usage
|
|
195
226
|
- Removing code without verifying zero active consumers
|
|
227
|
+
- A schema change and the code that depends on it shipped in the same deploy
|
|
228
|
+
- A column renamed or dropped in place rather than via expand/contract
|
|
229
|
+
- A migration merged with no tested down path, or a backfill that locks the table
|
|
196
230
|
|
|
197
231
|
## Verification
|
|
198
232
|
|
|
@@ -204,3 +238,10 @@ After completing a deprecation:
|
|
|
204
238
|
- [ ] Old code, tests, documentation, and configuration are fully removed
|
|
205
239
|
- [ ] No references to the deprecated system remain in the codebase
|
|
206
240
|
- [ ] Deprecation notices are removed (they served their purpose)
|
|
241
|
+
|
|
242
|
+
After a database schema migration:
|
|
243
|
+
|
|
244
|
+
- [ ] The change ships in additive phases (expand → backfill → contract), not a single in-place edit
|
|
245
|
+
- [ ] Old and new code are both valid against the schema at every deploy step
|
|
246
|
+
- [ ] Each migration has a tested down path; backfills run in throttled batches
|
|
247
|
+
- [ ] Destructive steps (drop/rename) ship in their own deploy after no code references the old shape
|