@chankov/agent-fleet 2.0.7 → 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/{hermes → .pi/agent-fleet/hermes}/README.md +7 -7
- package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/activity.py +2 -2
- package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/coms_registry.py +2 -2
- package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/coms_send.py +1 -1
- package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/watch.py +2 -2
- package/{hermes → .pi/agent-fleet/hermes}/skills/hub-conductor/SKILL.md +1 -1
- package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/SKILL.md +3 -3
- package/{hooks → .pi/agent-fleet/hooks}/coms-stop-hook.mjs +2 -2
- package/{scripts → .pi/agent-fleet/scripts}/claude-code-preflight.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/coms-claude-bridge.ts +6 -6
- package/{scripts → .pi/agent-fleet/scripts}/coms-cli.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/coms-hermes-bridge.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/fleet-codex-read.py +5 -3
- package/{scripts → .pi/agent-fleet/scripts}/fleet.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/flow.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/lib/claude-bridge-core.ts +2 -2
- package/{scripts → .pi/agent-fleet/scripts}/lib/coms-envelope.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-transport.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/lib/herdr-layout.ts +3 -3
- package/{scripts → .pi/agent-fleet/scripts}/lib/hermes-bridge-core.ts +1 -1
- 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/{scripts → .pi/agent-fleet/scripts}/lib/hermes-monitor-model.ts +1 -1
- 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/{scripts → .pi/agent-fleet/scripts}/lib/monitor-env.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/lib/peer-launch.ts +3 -3
- package/{scripts → .pi/agent-fleet/scripts}/lib/persona-banner.ts +1 -1
- package/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
- package/{scripts → .pi/agent-fleet/scripts}/lib/runtime-dependencies.js +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/lib/spawn-stagger.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/lib/team-project.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/lib/team-snapshot.ts +2 -2
- package/{scripts → .pi/agent-fleet/scripts}/peer-banner.ts +5 -4
- package/{scripts → .pi/agent-fleet/scripts}/peer-launch.ts +7 -9
- package/{scripts → .pi/agent-fleet/scripts}/team-snapshot.ts +5 -5
- package/{scripts → .pi/agent-fleet/scripts}/team-up.ts +6 -6
- package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/agent-phase.ts +3 -3
- package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/envelopes.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/model-profile.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/personas.ts +2 -2
- package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/trace.ts +1 -1
- 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/package.json +1 -1
- package/.pi/harnesses/lib/spawned-peers.js +1 -1
- package/.pi/prompts/af-constraints.md +31 -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 +39 -0
- package/README.md +10 -9
- package/bin/catalog/harness-runtime-closure.json +23 -22
- package/bin/cli.js +24 -1
- package/bin/lib/apply.js +6 -2
- package/bin/lib/detect-agent.js +1 -1
- package/bin/lib/doctor.js +3 -3
- 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/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/verify.js +43 -5
- 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 +30 -1
- package/docs/pi-extensions.md +6 -6
- package/docs/workflows.md +9 -5
- package/install-manifest.json +202 -97
- package/justfile +19 -19
- package/manifest-meta.json +50 -38
- 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/scripts/lib/hermes-monitor-events.ts +0 -1
- package/scripts/lib/hermes-monitor-herdr.ts +0 -2
- package/scripts/lib/hermes-monitor-registry.ts +0 -2
- package/scripts/lib/hermes-monitor-socket.ts +0 -2
- package/scripts/lib/hermes-monitor-store.ts +0 -2
- /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
|
@@ -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
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: designing-agents
|
|
3
|
-
description: Designs and writes a focused artifact another agent runs — an agent persona in agents/, a workflow skill in skills/, or a pi session harness in .pi/harnesses/. Use when authoring a reviewer or specialist persona, a repeatable process skill, or a pi extension that reshapes a session — or when rewriting one that is under-specified, overlapping, or being ignored.
|
|
3
|
+
description: Designs and writes a focused artifact another agent runs — an agent persona in .pi/agents/personas/, a workflow skill in skills/, or a pi session harness in .pi/harnesses/. Use when authoring a reviewer or specialist persona, a repeatable process skill, or a pi extension that reshapes a session — or when rewriting one that is under-specified, overlapping, or being ignored.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Designing Agents
|
|
@@ -9,7 +9,7 @@ description: Designs and writes a focused artifact another agent runs — an age
|
|
|
9
9
|
|
|
10
10
|
This repo has three kinds of artifacts that shape how an agent works. Each is authored, versioned, and invoked deliberately:
|
|
11
11
|
|
|
12
|
-
- **Agent personas** live in
|
|
12
|
+
- **Agent personas** live in `.pi/agents/personas/<name>.md`. They define a *role* another agent adopts when it needs specialized review, audit, or analysis. Example: `code-reviewer`, `security-auditor`, `test-engineer`.
|
|
13
13
|
- **Skills** live in `skills/<name>/SKILL.md`. They define a *workflow* — a repeatable process with gated steps, anti-rationalization guardrails, and verification. Example: `spec-driven-development`, `test-driven-development`, `context-engineering`.
|
|
14
14
|
- **pi harnesses** live in `.pi/harnesses/<name>/`. They define a *session environment* — a TypeScript pi extension that reshapes the whole session: setting UI surfaces, gating tool calls, registering new tools or commands, or orchestrating sub-agents. Example: `agent-hub`, `damage-control-continue`, `coms`.
|
|
15
15
|
|
|
@@ -17,7 +17,7 @@ Personas and skills are prose that change an agent's *judgment*. A harness is co
|
|
|
17
17
|
|
|
18
18
|
## When to Use
|
|
19
19
|
|
|
20
|
-
- Creating a new persona file in
|
|
20
|
+
- Creating a new persona file in `.pi/agents/personas/` (reviewer, auditor, domain specialist)
|
|
21
21
|
- Creating a new skill directory in `skills/` (a process, checklist, or workflow)
|
|
22
22
|
- Creating a new pi harness in `.pi/harnesses/` (a footer, focus gate, safety check, orchestrator, or messaging layer)
|
|
23
23
|
- An existing persona, skill, or harness is vague, overlaps another, or is being ignored in practice
|
|
@@ -32,7 +32,7 @@ Personas and skills are prose that change an agent's *judgment*. A harness is co
|
|
|
32
32
|
|
|
33
33
|
## The Workflow
|
|
34
34
|
|
|
35
|
-
This workflow is abstracted from the three reference personas (`
|
|
35
|
+
This workflow is abstracted from the three reference personas (`code-reviewer`, `security-auditor`, `test-engineer`), from `docs/skill-anatomy.md`, and from the ported harnesses under `.pi/harnesses/` (catalogued in `docs/pi-extensions.md`). Do not advance to the next step until the current one is settled.
|
|
36
36
|
|
|
37
37
|
### 1. Choose the target type
|
|
38
38
|
|
|
@@ -40,7 +40,7 @@ Ask: is this a *role* the agent should adopt, a *process* it should follow, or a
|
|
|
40
40
|
|
|
41
41
|
| Target | Choose when | Output |
|
|
42
42
|
|---|---|---|
|
|
43
|
-
| Persona | The agent needs to evaluate or review through a specific lens (correctness, security, test strategy, accessibility, migration safety…) |
|
|
43
|
+
| Persona | The agent needs to evaluate or review through a specific lens (correctness, security, test strategy, accessibility, migration safety…) | `.pi/agents/personas/<name>.md` |
|
|
44
44
|
| Skill | The agent needs to follow a repeatable process with gated steps, verification, and anti-rationalization guards | `skills/<name>/SKILL.md` |
|
|
45
45
|
| pi harness | The session itself must change — footer, status, a blocking gate on tool calls, a new tool or `/command`, or sub-agent orchestration | `.pi/harnesses/<name>/` (a directory) |
|
|
46
46
|
|
|
@@ -59,7 +59,7 @@ Do not proceed until the one-sentence purpose is locked. If the requester cannot
|
|
|
59
59
|
### 3. Scan for overlap
|
|
60
60
|
|
|
61
61
|
Read every existing artifact of the target type:
|
|
62
|
-
- For a persona: every file
|
|
62
|
+
- For a persona: every persona file already in the workspace.
|
|
63
63
|
- For a skill: every `skills/*/SKILL.md` (start with the Quick Reference table in `skills/using-agent-skills/SKILL.md`).
|
|
64
64
|
- For a harness: the catalog table in `docs/pi-extensions.md`, then the `README.md` of each `.pi/harnesses/*` that looks close.
|
|
65
65
|
|
|
@@ -103,7 +103,7 @@ This step branches by target type.
|
|
|
103
103
|
|
|
104
104
|
#### 6a. Persona body (four-block structure)
|
|
105
105
|
|
|
106
|
-
Used by every persona
|
|
106
|
+
Used by every installed persona. See the Persona Template below.
|
|
107
107
|
|
|
108
108
|
```markdown
|
|
109
109
|
# <Role Heading>
|
|
@@ -165,7 +165,7 @@ A harness also has wiring steps that personas and skills do not — step 9 cover
|
|
|
165
165
|
|
|
166
166
|
### 7. Apply prompting-patterns
|
|
167
167
|
|
|
168
|
-
Before finalizing, read
|
|
168
|
+
Before finalizing, read `../../references/prompting-patterns.md` and check the artifact against these sections. This applies to all three types — for a harness, to the prose it injects (system-prompt text, tool descriptions, block reasons), not the TypeScript itself.
|
|
169
169
|
|
|
170
170
|
- **§2.2** — Positive instructions, not prohibitions. Rewrite every "don't do X" as "do Y".
|
|
171
171
|
- **§2.3** — Explain *why* for any non-obvious rule. One short clause is enough.
|
|
@@ -185,7 +185,7 @@ Cut every sentence that does not change behavior. Read each rule and ask: "If I
|
|
|
185
185
|
|
|
186
186
|
### 9. Write the file(s)
|
|
187
187
|
|
|
188
|
-
- Persona →
|
|
188
|
+
- Persona → `.pi/agents/personas/<name>.md`.
|
|
189
189
|
- Skill → `skills/<name>/SKILL.md` (create the directory; supporting files only if the skill exceeds ~300 lines or needs separate reference material).
|
|
190
190
|
- Harness → `.pi/harnesses/<name>/` with `index.ts`, `package.json`, and `README.md`. Then add a `just ext-<name>` recipe to the `justfile` under the matching category header, add a catalog row to `docs/pi-extensions.md`, and add any new runtime dependency to `.pi/harnesses/package.json`. Never place a harness under `.pi/extensions/` — pi auto-discovers that directory and would load every harness at once.
|
|
191
191
|
|
|
@@ -321,7 +321,7 @@ A harness is a directory, not a single file. The `ExtensionAPI` surface, the `in
|
|
|
321
321
|
| "I'll skip the harness README and catalog row — `index.ts` is the real artifact" | A harness with no row in `docs/pi-extensions.md` is undiscoverable; no agent will load it. The README is its discovery surface — the same role frontmatter plays for a skill. |
|
|
322
322
|
| "I'll copy an existing artifact and tweak it" | For prose artifacts, copy-paste creates silent duplication and drift — read the existing files to learn the pattern, then write fresh. For a harness, copying the nearest `index.ts` *is* the recommended start; just rename it cleanly and cut what you don't use. |
|
|
323
323
|
| "I don't need to read prompting-patterns, I know how to write prompts" | Every author thinks this. The reference exists because recurring, measurable mistakes happen anyway. Spend 3 minutes skimming §2 and §6. |
|
|
324
|
-
| "I'll add every tool and capability — flexibility is good" |
|
|
324
|
+
| "I'll add every tool and capability — flexibility is good" | Agent Fleet's own personas don't declare tools at all; scope creep happens through the prompt body. Skills and harnesses that try to cover many domains lose their force. Bloated artifacts get skimmed. |
|
|
325
325
|
| "The purpose is hard to state in one sentence because it covers a lot" | If you cannot state it in one sentence, the artifact covers too much. Split it or scope it down. |
|
|
326
326
|
| "I'll leave the rules/steps section light so the artifact can be flexible" | Empty Rules or vague steps become empty behavior. The specifics are what differentiate this artifact from a general agent. |
|
|
327
327
|
| "My skill is mostly reference material — I'll inline a 200-line checklist" | Reference material belongs in `references/`. Skills are workflows, not reference docs. Move the long content out and cite it. |
|
|
@@ -360,13 +360,13 @@ A harness is a directory, not a single file. The `ExtensionAPI` surface, the `in
|
|
|
360
360
|
|
|
361
361
|
- [ ] Name is kebab-case and matches the file/directory, the `name` field (frontmatter or `package.json`), and the H1 title.
|
|
362
362
|
- [ ] The discovery surface (description, or README + catalog row) is action-oriented and ends with a concrete trigger.
|
|
363
|
-
- [ ] Cross-checked against
|
|
363
|
+
- [ ] Cross-checked against `../../references/prompting-patterns.md` §2.2, §2.3, §2.4, §2.5, §3.1, §6.4 — no prohibitions, no contradictions, no ALL-CAPS, role/overview is specific.
|
|
364
364
|
- [ ] Scanned against existing files of the same type — no >30% overlap.
|
|
365
365
|
- [ ] Every sentence, if removed, would visibly change the artifact's behavior.
|
|
366
366
|
|
|
367
367
|
### Persona-specific checklist
|
|
368
368
|
|
|
369
|
-
- [ ] File exists at
|
|
369
|
+
- [ ] File exists at `.pi/agents/personas/<name>.md`.
|
|
370
370
|
- [ ] Body has: Role opening paragraph, Framework/Approach, Output Format, Rules.
|
|
371
371
|
- [ ] Output Format contains a concrete markdown template, not a description of one.
|
|
372
372
|
- [ ] If the persona classifies findings (Critical / High / etc.), the severity table is present with explicit criteria and required action.
|
|
@@ -11,7 +11,7 @@ Draft code-owned workflows by copying a proven flow shape, then edit only the de
|
|
|
11
11
|
|
|
12
12
|
## When to Use
|
|
13
13
|
|
|
14
|
-
- Creating a new
|
|
14
|
+
- Creating a new `.pi/agent-fleet/scripts/workflows/wf-*.ts` flow.
|
|
15
15
|
- Changing a flow's phase order, gates, retries, or acceptance rule.
|
|
16
16
|
- Translating an operator request into a prompt for an agent phase.
|
|
17
17
|
|
|
@@ -21,7 +21,7 @@ Do not use this skill to improvise an interactive hub dispatch. `just fleet` rem
|
|
|
21
21
|
|
|
22
22
|
### 1. Map, list, and stop
|
|
23
23
|
|
|
24
|
-
Read the managed workflow map in `.pi/agent-fleet/docs/workflows.md`, then list every available
|
|
24
|
+
Read the managed workflow map in `.pi/agent-fleet/docs/workflows.md`, then list every available `.pi/agent-fleet/scripts/workflows/wf-*.ts` with exactly one line containing its name and `Phases:` shape. **Stop and wait for the operator to select or describe the desired flow.**
|
|
25
25
|
|
|
26
26
|
At this point:
|
|
27
27
|
|
|
@@ -79,7 +79,7 @@ The draft marks only three classes of decisions:
|
|
|
79
79
|
|
|
80
80
|
Edit the copied phase bodies so the declared shape is real. Remove each TODO only after making that decision. Do not add TODOs for imports, envelope wiring, trace calls, dry-run stubs, or other boilerplate.
|
|
81
81
|
|
|
82
|
-
For the complete contracts, read
|
|
82
|
+
For the complete contracts, read `../../references/workflow-authoring.md`.
|
|
83
83
|
|
|
84
84
|
### 6. Keep the envelope triad synchronized
|
|
85
85
|
|
|
@@ -96,9 +96,9 @@ Use existing return-contract vocabulary. A parsed envelope with `status: "fail"`
|
|
|
96
96
|
The generator refuses handoff unless both gates pass:
|
|
97
97
|
|
|
98
98
|
```bash
|
|
99
|
-
npx tsc -p scripts/workflows/tsconfig.json --noEmit
|
|
99
|
+
npx tsc -p .pi/agent-fleet/scripts/workflows/tsconfig.json --noEmit
|
|
100
100
|
node --experimental-strip-types skills/drafting-workflows/scripts/make-workflow.ts \
|
|
101
|
-
--verify-draft scripts/workflows/wf-<name>.ts
|
|
101
|
+
--verify-draft .pi/agent-fleet/scripts/workflows/wf-<name>.ts
|
|
102
102
|
```
|
|
103
103
|
|
|
104
104
|
The second command resolves the exact `wf-<name>.ts` entry export used by the flow registry, then executes it with stubbed agent phases and `dryRun: true`; it makes no model call. If either gate fails, the generator deletes the draft and reports the exact failure. Repair the source decision or rerun the generator—never bypass either gate. A handed-off draft is immediately reachable as `just flow <name>`; no central registry edit is required.
|
|
@@ -138,6 +138,6 @@ Before presenting a workflow draft, confirm:
|
|
|
138
138
|
- [ ] Every agent phase has an explicit persona or call-site writes policy; omission is a startup error, never unrestricted by accident.
|
|
139
139
|
- [ ] Writes policy and protected paths are enforced around agent phases.
|
|
140
140
|
- [ ] The generated export is uniquely named for the file and resolves through `just flow <name>`.
|
|
141
|
-
- [ ] `npx tsc -p scripts/workflows/tsconfig.json --noEmit` passes.
|
|
141
|
+
- [ ] `npx tsc -p .pi/agent-fleet/scripts/workflows/tsconfig.json --noEmit` passes.
|
|
142
142
|
- [ ] The generated workflow's stubbed dry run is accepted with zero model calls.
|
|
143
143
|
- [ ] The exact commands and outcomes are included in the handoff.
|
|
@@ -73,7 +73,7 @@ function editDistance(left: PhaseKind[], right: PhaseKind[]): number {
|
|
|
73
73
|
}
|
|
74
74
|
|
|
75
75
|
export function selectNearestWorkflow(shapes: WorkflowShape[], requestedPhases: string[]): WorkflowShape {
|
|
76
|
-
if (!shapes.length) throw new Error("No scripts/workflows/wf-*.ts sources were found.");
|
|
76
|
+
if (!shapes.length) throw new Error("No .pi/agent-fleet/scripts/workflows/wf-*.ts sources were found.");
|
|
77
77
|
const requestedKinds = requestedPhases.map(phaseKind);
|
|
78
78
|
return [...shapes].sort((left, right) => {
|
|
79
79
|
const leftScore = editDistance(left.kinds, requestedKinds) * 100 + Math.abs(left.kinds.length - requestedKinds.length) * 10;
|
|
@@ -118,7 +118,7 @@ export function makeWorkflow(options: {
|
|
|
118
118
|
}): { outputPath: string; sourcePath: string; phases: string[] } {
|
|
119
119
|
if (!SAFE_NAME.test(options.name)) throw new Error(`Invalid workflow name: ${options.name}`);
|
|
120
120
|
if (RESERVED_FLOW_NAMES.has(options.name)) throw new Error(`Workflow name is reserved for maintenance: ${options.name}`);
|
|
121
|
-
const workflowsDir = resolve(options.workflowsDir ?? resolve(options.cwd, "scripts/workflows"));
|
|
121
|
+
const workflowsDir = resolve(options.workflowsDir ?? resolve(options.cwd, ".pi/agent-fleet/scripts/workflows"));
|
|
122
122
|
const outputPath = resolve(workflowsDir, `wf-${options.name}.ts`);
|
|
123
123
|
if (existsSync(outputPath)) throw new Error(`Refusing to overwrite existing workflow: ${outputPath}`);
|
|
124
124
|
const nearest = selectNearestWorkflow(readWorkflowShapes(workflowsDir), options.phases);
|
|
@@ -141,7 +141,7 @@ export function makeWorkflow(options: {
|
|
|
141
141
|
export async function verifyDraft(path: string, cwd = process.cwd()): Promise<void> {
|
|
142
142
|
const resolvedPath = resolve(path);
|
|
143
143
|
const workflowName = basename(resolvedPath).replace(/^wf-/, "").replace(/\.ts$/, "");
|
|
144
|
-
const flowModulePath = resolve(cwd, "scripts/flow.ts");
|
|
144
|
+
const flowModulePath = resolve(cwd, ".pi/agent-fleet/scripts/flow.ts");
|
|
145
145
|
const { resolveWorkflow } = await import(`${pathToFileURL(flowModulePath).href}?verify=${Date.now()}`) as {
|
|
146
146
|
resolveWorkflow(name: string, workflowsDir?: string): Promise<{ run: (run: unknown, input: { args: string[]; dryRun: boolean; cwd: string }) => Promise<{ accepted: boolean }> } | undefined>;
|
|
147
147
|
};
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: frontend-ui-engineering
|
|
3
|
-
description: Builds production-quality UIs. Use when building or modifying
|
|
3
|
+
description: Builds production-quality, accessible, responsive user-facing UIs. Use when building or modifying interfaces and pages, creating components, implementing layouts, meeting WCAG accessibility requirements, managing state, or when the output needs to look and feel production-quality rather than AI-generated.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Frontend UI Engineering
|
|
@@ -294,7 +294,7 @@ function useToggleTask() {
|
|
|
294
294
|
|
|
295
295
|
## See Also
|
|
296
296
|
|
|
297
|
-
For detailed accessibility requirements and testing tools, see
|
|
297
|
+
For detailed accessibility requirements and testing tools, see `../../references/accessibility-checklist.md`.
|
|
298
298
|
|
|
299
299
|
## Common Rationalizations
|
|
300
300
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: git-workflow-and-versioning
|
|
3
|
-
description: Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, or when you need to organize work across multiple parallel streams.
|
|
3
|
+
description: Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, splitting uncommitted work in a messy working tree into clean atomic commits, opening or reviewing a pull request (PR), pushing to a remote, or when you need to organize work across multiple parallel streams.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Git Workflow and Versioning
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: incremental-implementation
|
|
3
|
-
description: Delivers changes incrementally and grills unspecified forks instead of silently picking among them. Use when implementing any feature or change that touches more than one file. Use when you're about to write a large amount of code at once, or when a task feels too big to land in one step.
|
|
3
|
+
description: Delivers changes incrementally in thin, verifiable slices and grills unspecified forks instead of silently picking among them. Use when implementing any feature or change that touches more than one file, or when picking up the next task from a plan. Use when rolling a change out behind a feature flag, when you're about to write a large amount of code at once, or when a task feels too big to land in one step.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Incremental Implementation
|
|
@@ -226,8 +226,8 @@ When directing an agent to implement incrementally:
|
|
|
226
226
|
Start with just the database schema change and the API endpoint.
|
|
227
227
|
Don't touch the UI yet — we'll do that in the next increment.
|
|
228
228
|
|
|
229
|
-
After implementing, run
|
|
230
|
-
nothing is broken, then present the Standard Slice Summary and
|
|
229
|
+
After implementing, run the repository's test and build commands to
|
|
230
|
+
verify nothing is broken, then present the Standard Slice Summary and
|
|
231
231
|
wait for my approval before the next slice. Do not stage or
|
|
232
232
|
commit — I'll handle git manually after reviewing."
|
|
233
233
|
```
|
|
@@ -236,13 +236,17 @@ Be explicit about what's in scope and what's NOT in scope for each increment.
|
|
|
236
236
|
|
|
237
237
|
## Increment Checklist
|
|
238
238
|
|
|
239
|
-
After each increment, verify
|
|
239
|
+
After each increment, verify with the repository's own commands. **Where the project
|
|
240
|
+
defines `quality:` under `## workflows` in `.ai/agent-fleet-overrides.md`, that command
|
|
241
|
+
*is* the verification — run it rather than guessing.** Only outside a configured project
|
|
242
|
+
should you discover the stack yourself (see the `test-driven-development` skill's
|
|
243
|
+
*Discover the Stack First* section). Never fall back to an assumed `npm test`.
|
|
240
244
|
|
|
241
245
|
- [ ] The change does one thing and does it completely
|
|
242
|
-
- [ ] All existing tests still pass (`npm test`)
|
|
243
|
-
- [ ] The build succeeds (
|
|
244
|
-
- [ ] Type checking passes (`npx tsc --noEmit`)
|
|
245
|
-
- [ ] Linting passes (
|
|
246
|
+
- [ ] All existing tests still pass (the project's `quality:` command, or the repository's test command: `npm test`, `./gradlew test`, `pytest`, ...)
|
|
247
|
+
- [ ] The build succeeds (the repository's build command)
|
|
248
|
+
- [ ] Type checking passes, where the stack has one (`npx tsc --noEmit`, `mypy`, ...)
|
|
249
|
+
- [ ] Linting passes (the repository's lint command)
|
|
246
250
|
- [ ] The new functionality works as expected
|
|
247
251
|
- [ ] Unspecified load-bearing forks were grilled (or grilling found none); already-stated requirements were not re-asked
|
|
248
252
|
- [ ] The Standard Slice Summary was presented to the user
|
|
@@ -295,4 +299,4 @@ After completing all increments for a task:
|
|
|
295
299
|
|
|
296
300
|
## See Also
|
|
297
301
|
|
|
298
|
-
Per-increment verification is the local check. Before declaring a task done, apply the project-wide Definition of Done as the final gate, the standing bar every increment clears regardless of the task. See
|
|
302
|
+
Per-increment verification is the local check. Before declaring a task done, apply the project-wide Definition of Done as the final gate, the standing bar every increment clears regardless of the task. See `../../references/definition-of-done.md`.
|
|
@@ -30,14 +30,14 @@ yourself** — pane lifecycle (herdr) belongs to the orchestrator and the human.
|
|
|
30
30
|
**Discover** who is alive (name, model, purpose):
|
|
31
31
|
|
|
32
32
|
```bash
|
|
33
|
-
node --experimental-strip-types scripts/coms-cli.ts list
|
|
33
|
+
node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts list
|
|
34
34
|
```
|
|
35
35
|
|
|
36
36
|
**Ask and wait** (blocking round trip — usually what you want; generous timeout, peers
|
|
37
37
|
run real turns):
|
|
38
38
|
|
|
39
39
|
```bash
|
|
40
|
-
node --experimental-strip-types scripts/coms-cli.ts send researcher \
|
|
40
|
+
node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts send researcher \
|
|
41
41
|
"Where is the retry logic for outbound webhooks? file:line please" \
|
|
42
42
|
--await --timeout 300000
|
|
43
43
|
```
|
|
@@ -45,9 +45,9 @@ node --experimental-strip-types scripts/coms-cli.ts send researcher \
|
|
|
45
45
|
**Fire-and-collect** (returns a `msg_id` immediately; a detached waiter holds the reply):
|
|
46
46
|
|
|
47
47
|
```bash
|
|
48
|
-
node --experimental-strip-types scripts/coms-cli.ts send documenter "Draft a README section on X"
|
|
48
|
+
node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts send documenter "Draft a README section on X"
|
|
49
49
|
# … keep working …
|
|
50
|
-
node --experimental-strip-types scripts/coms-cli.ts await <msg_id> --timeout 300000
|
|
50
|
+
node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts await <msg_id> --timeout 300000
|
|
51
51
|
```
|
|
52
52
|
|
|
53
53
|
**Answer inbound prompts** by simply replying in the conversation — your final message
|