@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
package/justfile
CHANGED
|
@@ -22,7 +22,7 @@ set dotenv-load := true
|
|
|
22
22
|
|
|
23
23
|
# How recipes run the fleet TS scripts. The preserve-symlinks flags matter for
|
|
24
24
|
# symlink installs (`agent-fleet setup --method symlink`): there
|
|
25
|
-
# scripts/*.ts are links whose realpath sits under .pi/npm/node_modules/, and
|
|
25
|
+
# .pi/agent-fleet/scripts/*.ts are links whose realpath sits under .pi/npm/node_modules/, and
|
|
26
26
|
# Node refuses --experimental-strip-types for anything under node_modules once
|
|
27
27
|
# paths are realpath'd. Keeping symlink paths avoids that; copy installs are
|
|
28
28
|
# unaffected (the fleet scripts import only relative paths + node builtins).
|
|
@@ -110,12 +110,12 @@ default:
|
|
|
110
110
|
#
|
|
111
111
|
# Unified guarded Pi, Hub, peers, teams, lifecycle, and conductor entry point.
|
|
112
112
|
fleet *args:
|
|
113
|
-
@{{node_ts}} scripts/fleet.ts {{args}}
|
|
113
|
+
@{{node_ts}} .pi/agent-fleet/scripts/fleet.ts {{args}}
|
|
114
114
|
|
|
115
115
|
# Headless workflows plus `flow cleanup` / `flow merge` Worktrunk branch maintenance.
|
|
116
116
|
# Exits 0 accepted/success; 1 rejected/failed; 2 invalid/unknown; 3 refused start.
|
|
117
117
|
flow *args:
|
|
118
|
-
@{{node_ts}} scripts/flow.ts {{args}}
|
|
118
|
+
@{{node_ts}} .pi/agent-fleet/scripts/flow.ts {{args}}
|
|
119
119
|
|
|
120
120
|
# Hidden Fleet Core launcher. Positional booleans are emitted only by fleet.ts.
|
|
121
121
|
_fleet-core browser="false" voice="false" all_extensions="false" *args:
|
|
@@ -126,7 +126,7 @@ _fleet-core browser="false" voice="false" all_extensions="false" *args:
|
|
|
126
126
|
# in a pane of its own — splitting the current pane inside herdr, else creating a
|
|
127
127
|
# one-pane workspace. `--here` runs it in the calling terminal instead.
|
|
128
128
|
_fleet-peer-launch *args:
|
|
129
|
-
{{node_ts}} scripts/peer-launch.ts {{args}}
|
|
129
|
+
{{node_ts}} .pi/agent-fleet/scripts/peer-launch.ts {{args}}
|
|
130
130
|
|
|
131
131
|
# Hidden guarded peer launcher for an interactive, addressable Fleet node with no
|
|
132
132
|
# persona: Fleet Core + coms under `--name`, plus raw pi arguments. Reached via
|
|
@@ -138,7 +138,7 @@ _fleet-peer name browser="false" all_extensions="false" *args:
|
|
|
138
138
|
# specialist, researcher, and nested delegate even though children use
|
|
139
139
|
# --no-extensions. `solo=true` disables only the embedded coms layer.
|
|
140
140
|
_fleet-hub solo="false" browser="false" voice="false" all_extensions="false" *args:
|
|
141
|
-
discovery="--no-extensions"; if [ "{{all_extensions}}" = "true" ]; then discovery=""; fi; browser_ext=""; if [ "{{browser}}" = "true" ]; then browser_ext="{{fleet_browser_extension}}"; fi; voice_ext=""; if [ "{{voice}}" = "true" ]; then voice_ext="{{fleet_voice_extension}}"; fi; solo_flag=""; if [ "{{solo}}" = "true" ]; then solo_flag="--solo"; fi; persona=""; if [ -f
|
|
141
|
+
discovery="--no-extensions"; if [ "{{all_extensions}}" = "true" ]; then discovery=""; fi; browser_ext=""; if [ "{{browser}}" = "true" ]; then browser_ext="{{fleet_browser_extension}}"; fi; voice_ext=""; if [ "{{voice}}" = "true" ]; then voice_ext="{{fleet_voice_extension}}"; fi; solo_flag=""; if [ "{{solo}}" = "true" ]; then solo_flag="--solo"; fi; persona=""; for pd in agents .claude/agents .pi/agents/personas .pi/agents; do if [ -f "$pd/orchestrator.md" ]; then persona="--append-system-prompt $pd/orchestrator.md"; break; fi; done; pi $discovery {{fleet_core_extensions}} -e .pi/harnesses/agent-hub/index.ts $browser_ext $voice_ext $solo_flag $persona {{args}}
|
|
142
142
|
|
|
143
143
|
# Hidden dependency installer used by `just fleet deps`.
|
|
144
144
|
# It installs only Node runtime dependencies. It does NOT launch Pi, activate a
|
|
@@ -146,7 +146,7 @@ _fleet-hub solo="false" browser="false" voice="false" all_extensions="false" *ar
|
|
|
146
146
|
_fleet-deps:
|
|
147
147
|
npm install --prefix .pi/extensions
|
|
148
148
|
npm install --prefix .pi/harnesses
|
|
149
|
-
npm install --prefix scripts
|
|
149
|
+
npm install --prefix .pi/agent-fleet/scripts
|
|
150
150
|
|
|
151
151
|
# Deterministic lifecycle CLI. `setup` always resolves the published latest
|
|
152
152
|
# package; it needs registry access unless the matching npm cache entry exists.
|
|
@@ -162,7 +162,7 @@ _fleet-lifecycle command *args:
|
|
|
162
162
|
# AGENT_FLEET_SPAWN_DELAY lets one pane refresh a stale shared OAuth token before
|
|
163
163
|
# sibling Pi processes start. Hidden recipes (`_...`) do not appear in --list.
|
|
164
164
|
_peer persona name="" model="" session="" project="default":
|
|
165
|
-
d="${AGENT_FLEET_SPAWN_DELAY:-0}"; if [ "$d" != "0" ]; then echo "⏳ waiting ${d}s for the pi auth pre-warm (stale OAuth token)"; sleep "$d"; fi; {{node_ts}} scripts/peer-banner.ts {{persona}} {{name}} 2>/dev/null || true; persona_path="agents/{{persona}}.md"; if [
|
|
165
|
+
d="${AGENT_FLEET_SPAWN_DELAY:-0}"; if [ "$d" != "0" ]; then echo "⏳ waiting ${d}s for the pi auth pre-warm (stale OAuth token)"; sleep "$d"; fi; {{node_ts}} .pi/agent-fleet/scripts/peer-banner.ts {{persona}} {{name}} 2>/dev/null || true; persona_path=""; for pd in agents .claude/agents .pi/agents/personas .pi/agents; do if [ -f "$pd/{{persona}}.md" ]; then persona_path="$pd/{{persona}}.md"; break; fi; done; if [ -z "$persona_path" ]; then persona_path=".pi/agents/personas/{{persona}}.md"; fi; pi --no-extensions {{fleet_core_extensions}} -e .pi/harnesses/coms/index.ts --project {{project}} --append-system-prompt "$persona_path" {{ if name != "" { "--name " + name } else { "" } }} {{ if model != "" { "--model " + model } else { "" } }} {{ if session != "" { "--session " + session } else { "" } }}
|
|
166
166
|
|
|
167
167
|
# Guarded peer plus comma-separated explicit extras from .pi/extensions/.
|
|
168
168
|
# Example peers.yaml entry:
|
|
@@ -170,14 +170,14 @@ _peer persona name="" model="" session="" project="default":
|
|
|
170
170
|
# The extra tools stay in this reusable peer; Hub's headless specialists still
|
|
171
171
|
# run --no-extensions and therefore cannot accidentally inherit them.
|
|
172
172
|
_peer-plus extensions persona name="" model="" session="" project="default":
|
|
173
|
-
d="${AGENT_FLEET_SPAWN_DELAY:-0}"; if [ "$d" != "0" ]; then echo "⏳ waiting ${d}s for the pi auth pre-warm (stale OAuth token)"; sleep "$d"; fi; {{node_ts}} scripts/peer-banner.ts {{persona}} {{name}} 2>/dev/null || true; persona_path="agents/{{persona}}.md"; if [
|
|
173
|
+
d="${AGENT_FLEET_SPAWN_DELAY:-0}"; if [ "$d" != "0" ]; then echo "⏳ waiting ${d}s for the pi auth pre-warm (stale OAuth token)"; sleep "$d"; fi; {{node_ts}} .pi/agent-fleet/scripts/peer-banner.ts {{persona}} {{name}} 2>/dev/null || true; persona_path=""; for pd in agents .claude/agents .pi/agents/personas .pi/agents; do if [ -f "$pd/{{persona}}.md" ]; then persona_path="$pd/{{persona}}.md"; break; fi; done; if [ -z "$persona_path" ]; then persona_path=".pi/agents/personas/{{persona}}.md"; fi; extra=""; old_ifs="$IFS"; IFS=','; for x in {{extensions}}; do x="$(echo "$x" | xargs)"; if [ -n "$x" ]; then extra="$extra -e .pi/extensions/$x/index.ts"; fi; done; IFS="$old_ifs"; pi --no-extensions {{fleet_core_extensions}} -e .pi/harnesses/coms/index.ts $extra --project {{project}} --append-system-prompt "$persona_path" {{ if name != "" { "--name " + name } else { "" } }} {{ if model != "" { "--model " + model } else { "" } }} {{ if session != "" { "--session " + session } else { "" } }}
|
|
174
174
|
|
|
175
175
|
# Internal team helper for a `runner: claude-code` peer — interactive
|
|
176
|
-
# Claude Code plus its coms bridge (scripts/coms-claude-bridge.ts) in ONE pane.
|
|
176
|
+
# Claude Code plus its coms bridge (.pi/agent-fleet/scripts/coms-claude-bridge.ts) in ONE pane.
|
|
177
177
|
# The bridge registers the pane as coms peer <name>; the trailing session
|
|
178
178
|
# positional maps to `claude --resume <id>` for `just fleet resume`.
|
|
179
179
|
_claude-peer name model="" session="" project="default":
|
|
180
|
-
{{node_ts}} scripts/claude-code-preflight.ts || exit $?; {{node_ts}} scripts/coms-claude-bridge.ts --name {{name}} --project {{project}} & bridge_pid=$!; trap 'kill $bridge_pid 2>/dev/null' EXIT; claude {{ if model != "" { "--model " + model } else { "" } }} {{ if session != "" { "--resume " + session } else { "" } }}
|
|
180
|
+
{{node_ts}} .pi/agent-fleet/scripts/claude-code-preflight.ts || exit $?; {{node_ts}} .pi/agent-fleet/scripts/coms-claude-bridge.ts --name {{name}} --project {{project}} & bridge_pid=$!; trap 'kill $bridge_pid 2>/dev/null' EXIT; claude {{ if model != "" { "--model " + model } else { "" } }} {{ if session != "" { "--resume " + session } else { "" } }}
|
|
181
181
|
|
|
182
182
|
# The hidden team implementations take the team as a positional arg (default "full")
|
|
183
183
|
# and pass everything after it straight to the script.
|
|
@@ -202,46 +202,46 @@ _claude-peer name model="" session="" project="default":
|
|
|
202
202
|
# just fleet team full --no-hub
|
|
203
203
|
# just fleet team review --no-hub --project af
|
|
204
204
|
_fleet-team-up team="full" *args:
|
|
205
|
-
{{node_ts}} scripts/team-up.ts --team {{team}} {{args}}
|
|
205
|
+
{{node_ts}} .pi/agent-fleet/scripts/team-up.ts --team {{team}} {{args}}
|
|
206
206
|
|
|
207
207
|
# Peers-only dry run:
|
|
208
208
|
# just fleet team review --no-hub --dry-run --project af
|
|
209
209
|
_fleet-team-up-dry team="full" *args:
|
|
210
|
-
{{node_ts}} scripts/team-up.ts --team {{team}} --dry-run {{args}}
|
|
210
|
+
{{node_ts}} .pi/agent-fleet/scripts/team-up.ts --team {{team}} --dry-run {{args}}
|
|
211
211
|
|
|
212
212
|
# Default team mode: guarded Fleet Hub in the main pane plus guarded peers.
|
|
213
213
|
# just fleet team docs
|
|
214
214
|
# just fleet team review --project af
|
|
215
215
|
_fleet-hub-team team="full" *args:
|
|
216
|
-
{{node_ts}} scripts/team-up.ts --team {{team}} --hub {{args}}
|
|
216
|
+
{{node_ts}} .pi/agent-fleet/scripts/team-up.ts --team {{team}} --hub {{args}}
|
|
217
217
|
|
|
218
218
|
# Hub + team preview without touching Herdr:
|
|
219
219
|
# just fleet team review --dry-run --project af
|
|
220
220
|
_fleet-hub-team-dry team="full" *args:
|
|
221
|
-
{{node_ts}} scripts/team-up.ts --team {{team}} --hub --dry-run {{args}}
|
|
221
|
+
{{node_ts}} .pi/agent-fleet/scripts/team-up.ts --team {{team}} --hub --dry-run {{args}}
|
|
222
222
|
|
|
223
223
|
# Hermes conductor + team:
|
|
224
224
|
# just fleet conductor hermes docs --project af
|
|
225
225
|
_fleet-conductor team="full" *args:
|
|
226
|
-
{{node_ts}} scripts/team-up.ts --team {{team}} --conductor {{args}}
|
|
226
|
+
{{node_ts}} .pi/agent-fleet/scripts/team-up.ts --team {{team}} --conductor {{args}}
|
|
227
227
|
|
|
228
228
|
# Hermes conductor preview:
|
|
229
229
|
# just fleet conductor hermes docs --dry-run --project af
|
|
230
230
|
_fleet-conductor-dry team="full" *args:
|
|
231
|
-
{{node_ts}} scripts/team-up.ts --team {{team}} --conductor --dry-run {{args}}
|
|
231
|
+
{{node_ts}} .pi/agent-fleet/scripts/team-up.ts --team {{team}} --conductor --dry-run {{args}}
|
|
232
232
|
|
|
233
233
|
# Save session refs while the team keeps running:
|
|
234
234
|
# just fleet snapshot review --project af
|
|
235
235
|
_fleet-team-snapshot team="full" *args:
|
|
236
|
-
{{node_ts}} scripts/team-snapshot.ts snapshot {{team}} {{args}}
|
|
236
|
+
{{node_ts}} .pi/agent-fleet/scripts/team-snapshot.ts snapshot {{team}} {{args}}
|
|
237
237
|
|
|
238
238
|
# Snapshot and close cleanly:
|
|
239
239
|
# just fleet down review --project af
|
|
240
240
|
_fleet-team-down team="full" *args:
|
|
241
|
-
{{node_ts}} scripts/team-snapshot.ts down {{team}} {{args}}
|
|
241
|
+
{{node_ts}} .pi/agent-fleet/scripts/team-snapshot.ts down {{team}} {{args}}
|
|
242
242
|
|
|
243
243
|
# Rebuild from snapshot; missing session refs start fresh:
|
|
244
244
|
# just fleet resume review --project af
|
|
245
245
|
_fleet-team-resume team="full" *args:
|
|
246
|
-
{{node_ts}} scripts/team-snapshot.ts resume {{team}} {{args}}
|
|
246
|
+
{{node_ts}} .pi/agent-fleet/scripts/team-snapshot.ts resume {{team}} {{args}}
|
|
247
247
|
# <<< agent-fleet:harnesses <<<
|
package/manifest-meta.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 2,
|
|
3
|
-
"_comment": "Curated metadata for install-manifest.json. Everything mechanical (which artifacts exist, which agent has a source) is derived from the tree by bin/build-manifest.js
|
|
3
|
+
"_comment": "Curated metadata for install-manifest.json. Everything mechanical (which artifacts exist, which agent has a source) is derived from the tree by bin/build-manifest.js \u2014 only judgement lives here: grouping, recommendations, consent class, companion wiring, and profiles. Run `node bin/build-manifest.js` after editing.",
|
|
4
4
|
"groups": [
|
|
5
5
|
{
|
|
6
6
|
"id": "skills",
|
|
@@ -213,6 +213,7 @@
|
|
|
213
213
|
"skill:idea-refine": "define",
|
|
214
214
|
"skill:interview-me": "define",
|
|
215
215
|
"skill:planning-and-task-breakdown": "plan",
|
|
216
|
+
"skill:constraint-driven-development": "plan",
|
|
216
217
|
"skill:incremental-implementation": "build",
|
|
217
218
|
"skill:test-driven-development": "build",
|
|
218
219
|
"skill:context-engineering": "build",
|
|
@@ -276,6 +277,11 @@
|
|
|
276
277
|
"companion:skills-internal-grilling"
|
|
277
278
|
]
|
|
278
279
|
},
|
|
280
|
+
"skill:constraint-driven-development": {
|
|
281
|
+
"companions": [
|
|
282
|
+
"reference:definition-of-done"
|
|
283
|
+
]
|
|
284
|
+
},
|
|
279
285
|
"skill:planning-and-task-breakdown": {
|
|
280
286
|
"companions": [
|
|
281
287
|
"companion:skills-internal-grilling",
|
|
@@ -283,7 +289,7 @@
|
|
|
283
289
|
"reference:communication-contract"
|
|
284
290
|
]
|
|
285
291
|
},
|
|
286
|
-
"_references_comment": "A reference is the long-form half of a skill that cites it by path
|
|
292
|
+
"_references_comment": "A reference is the long-form half of a skill that cites it by path \u2014 never a standalone choice. Declaring it here as a companion means selecting the skill brings its checklists, and uninstall refuses to strand a skill without them. Keep this in step with the `references/\u2026` citations in the SKILL.md bodies (both skills/ and the vendored copies under vendor/agent-skills-upstream/).",
|
|
287
293
|
"skill:using-agent-skills": {
|
|
288
294
|
"companions": [
|
|
289
295
|
"reference:definition-of-done"
|
|
@@ -353,7 +359,7 @@
|
|
|
353
359
|
"reference:performance-checklist"
|
|
354
360
|
]
|
|
355
361
|
},
|
|
356
|
-
"_coms_bridge_comment": "Claude Code is not an install target
|
|
362
|
+
"_coms_bridge_comment": "Claude Code is not an install target \u2014 it joins the fleet only as a coms peer, driven by .pi/agent-fleet/scripts/coms-claude-bridge.ts. Both halves of that bridge live in one group: the skill the bridged pane reads, and the Stop hook it writes its turn output through. See docs/claude-code-coms-bridge.md.",
|
|
357
363
|
"skill:peer-coms": {
|
|
358
364
|
"group": "coms-bridge",
|
|
359
365
|
"companions": [
|
|
@@ -397,7 +403,7 @@
|
|
|
397
403
|
"external:playwright-cli"
|
|
398
404
|
]
|
|
399
405
|
},
|
|
400
|
-
"_fleet_core_comment": "Fleet Core is the set the justfile's `fleet_core_extensions` loads into every pi session and every Herdr peer: two harnesses (damage-control-continue, ask-user-remote) plus compact-and-continue and btw. The package update check is not a standalone extension; damage-control-continue runs `.pi/harnesses/lib/update-check.ts` once per session. The launcher set is encoded twice on purpose
|
|
406
|
+
"_fleet_core_comment": "Fleet Core is the set the justfile's `fleet_core_extensions` loads into every pi session and every Herdr peer: two harnesses (damage-control-continue, ask-user-remote) plus compact-and-continue and btw. The package update check is not a standalone extension; damage-control-continue runs `.pi/harnesses/lib/update-check.ts` once per session. The launcher set is encoded twice on purpose \u2014 `requires`, so installing any harness pulls the whole set, and `pinnedBy`, so uninstall refuses to break a harness by taking a member out from under it. Keep it in step with the `fleet_core_extensions` line in the justfile; bin/test/damage-control-unification.test.js asserts the two agree.",
|
|
401
407
|
"pi-extension:mcp-bridge": {
|
|
402
408
|
"companions": [
|
|
403
409
|
"companion:pi-extension-manifests",
|
|
@@ -511,26 +517,26 @@
|
|
|
511
517
|
"pi-harness:ask-user-remote"
|
|
512
518
|
]
|
|
513
519
|
},
|
|
514
|
-
"_operator_comment": "operatorSteps are printed verbatim by `install --profile hermes-plugins|codex-bridge`. These artifacts install into a Hermes profile or user systemd
|
|
520
|
+
"_operator_comment": "operatorSteps are printed verbatim by `install --profile hermes-plugins|codex-bridge`. These artifacts install into a Hermes profile or user systemd \u2014 outside the workspace the engine is allowed to write to \u2014 so the engine names the commands and performs none of them. <profile> is the operator's Hermes profile.",
|
|
515
521
|
"hermes-plugin:agent-fleet-herdr": {
|
|
516
522
|
"operatorSteps": [
|
|
517
|
-
"clone agent-fleet
|
|
518
|
-
"scripts/install-hermes-plugin.sh agent-fleet-herdr --profile <profile>",
|
|
519
|
-
"restart the Hermes Desktop app
|
|
523
|
+
"clone agent-fleet \u2014 .pi/agent-fleet/scripts/install-hermes-plugin.sh is repo-only, not shipped on npm",
|
|
524
|
+
".pi/agent-fleet/scripts/install-hermes-plugin.sh agent-fleet-herdr --profile <profile>",
|
|
525
|
+
"restart the Hermes Desktop app \u2014 plugin routers mount only when its gateway boots",
|
|
520
526
|
"hermes --profile <profile> gateway restart # only if the web dashboard/TUI needs the routes"
|
|
521
527
|
]
|
|
522
528
|
},
|
|
523
529
|
"hermes-plugin:agent-fleet-monitor": {
|
|
524
530
|
"operatorSteps": [
|
|
525
|
-
"clone agent-fleet
|
|
526
|
-
"scripts/install-hermes-plugin.sh agent-fleet-monitor --profile <profile>",
|
|
527
|
-
"restart the Hermes Desktop app
|
|
531
|
+
"clone agent-fleet \u2014 .pi/agent-fleet/scripts/install-hermes-plugin.sh is repo-only, not shipped on npm",
|
|
532
|
+
".pi/agent-fleet/scripts/install-hermes-plugin.sh agent-fleet-monitor --profile <profile>",
|
|
533
|
+
"restart the Hermes Desktop app \u2014 plugin routers mount only when its gateway boots",
|
|
528
534
|
"hermes --profile <profile> gateway restart # only if the web dashboard/TUI needs the routes"
|
|
529
535
|
]
|
|
530
536
|
},
|
|
531
537
|
"hermes-skill:hub-conductor": {
|
|
532
538
|
"operatorSteps": [
|
|
533
|
-
"copy hermes/skills/hub-conductor into <hermes-profile>/skills/hub-conductor",
|
|
539
|
+
"copy .pi/agent-fleet/hermes/skills/hub-conductor into <hermes-profile>/skills/hub-conductor",
|
|
534
540
|
"hermes --profile <profile> skills config # enable hub-conductor",
|
|
535
541
|
"hermes --profile <profile> gateway restart"
|
|
536
542
|
]
|
|
@@ -685,12 +691,19 @@
|
|
|
685
691
|
"agents": {
|
|
686
692
|
"pi": {
|
|
687
693
|
"source": [
|
|
688
|
-
".pi/agents"
|
|
694
|
+
".pi/agents/dispatch-policy.yaml",
|
|
695
|
+
".pi/agents/model-profiles.yaml",
|
|
696
|
+
".pi/agents/peers.yaml",
|
|
697
|
+
".pi/agents/teams.yaml",
|
|
698
|
+
".pi/agents/voices.yaml"
|
|
689
699
|
],
|
|
690
|
-
"
|
|
700
|
+
"sourceMode": "all",
|
|
701
|
+
"preserveLayout": true,
|
|
702
|
+
"target": null,
|
|
691
703
|
"strategy": "copy-tree"
|
|
692
704
|
}
|
|
693
|
-
}
|
|
705
|
+
},
|
|
706
|
+
"_comment": "Declared file by file, not as the .pi/agents tree. The installed personas live in .pi/agents/personas/, and a whole-directory binding would own that subtree too \u2014 under --method symlink it would make .pi/agents itself a link into the package, so writing a persona would escape the workspace and apply() (correctly) refuses. bin/test/manifest.test.js asserts every .pi/agents/*.yaml in the package is listed here."
|
|
694
707
|
},
|
|
695
708
|
"companion:damage-control-rules": {
|
|
696
709
|
"title": ".pi/damage-control-rules.yaml",
|
|
@@ -707,7 +720,7 @@
|
|
|
707
720
|
},
|
|
708
721
|
"companion:stt-config": {
|
|
709
722
|
"title": ".ai/stt.json",
|
|
710
|
-
"summary": "Non-secret voice provider config; keys stay in .env
|
|
723
|
+
"summary": "Non-secret voice provider config; keys stay in .env \u2014 asked for, never generated",
|
|
711
724
|
"agents": {
|
|
712
725
|
"pi": {
|
|
713
726
|
"source": [],
|
|
@@ -717,9 +730,9 @@
|
|
|
717
730
|
},
|
|
718
731
|
"consent": "operator",
|
|
719
732
|
"operatorSteps": [
|
|
720
|
-
"pick a provider and write .ai/stt.json
|
|
733
|
+
"pick a provider and write .ai/stt.json \u2014 see docs/pi-extensions.md",
|
|
721
734
|
"put the API key in a gitignored .env under the env-var name stt.json references; never in stt.json itself",
|
|
722
|
-
"the extension binds Alt+S only once a provider resolves
|
|
735
|
+
"the extension binds Alt+S only once a provider resolves \u2014 until then it is a no-op"
|
|
723
736
|
]
|
|
724
737
|
},
|
|
725
738
|
"companion:workflow-guide": {
|
|
@@ -741,12 +754,12 @@
|
|
|
741
754
|
"agents": {
|
|
742
755
|
"pi": {
|
|
743
756
|
"source": [
|
|
744
|
-
"scripts/flow.ts",
|
|
745
|
-
"scripts/package.json",
|
|
746
|
-
"scripts/package-lock.json",
|
|
747
|
-
"scripts/lib/flow-command.ts",
|
|
748
|
-
"scripts/lib/flow-maintenance.ts",
|
|
749
|
-
"scripts/workflows"
|
|
757
|
+
".pi/agent-fleet/scripts/flow.ts",
|
|
758
|
+
".pi/agent-fleet/scripts/package.json",
|
|
759
|
+
".pi/agent-fleet/scripts/package-lock.json",
|
|
760
|
+
".pi/agent-fleet/scripts/lib/flow-command.ts",
|
|
761
|
+
".pi/agent-fleet/scripts/lib/flow-maintenance.ts",
|
|
762
|
+
".pi/agent-fleet/scripts/workflows"
|
|
750
763
|
],
|
|
751
764
|
"sourceMode": "all",
|
|
752
765
|
"preserveLayout": true,
|
|
@@ -771,7 +784,7 @@
|
|
|
771
784
|
"args": [
|
|
772
785
|
"ci",
|
|
773
786
|
"--prefix",
|
|
774
|
-
"scripts"
|
|
787
|
+
".pi/agent-fleet/scripts"
|
|
775
788
|
],
|
|
776
789
|
"cwd": "."
|
|
777
790
|
}
|
|
@@ -783,20 +796,19 @@
|
|
|
783
796
|
"agents": {
|
|
784
797
|
"pi": {
|
|
785
798
|
"source": [
|
|
786
|
-
"scripts/fleet-codex-client.ts",
|
|
787
|
-
"scripts/fleet-codex-read.py",
|
|
788
|
-
"scripts/package.json",
|
|
789
|
-
"scripts/lib/fleet-codex-session.ts",
|
|
790
|
-
"scripts/lib/fleet-codex-operations.ts",
|
|
791
|
-
"scripts/lib/fleet-codex-transport.ts",
|
|
792
|
-
"scripts/lib/fleet-codex-catalog.ts",
|
|
793
|
-
"scripts/lib/coms-envelope.ts",
|
|
799
|
+
".pi/agent-fleet/scripts/fleet-codex-client.ts",
|
|
800
|
+
".pi/agent-fleet/scripts/fleet-codex-read.py",
|
|
801
|
+
".pi/agent-fleet/scripts/package.json",
|
|
802
|
+
".pi/agent-fleet/scripts/lib/fleet-codex-session.ts",
|
|
803
|
+
".pi/agent-fleet/scripts/lib/fleet-codex-operations.ts",
|
|
804
|
+
".pi/agent-fleet/scripts/lib/fleet-codex-transport.ts",
|
|
805
|
+
".pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts",
|
|
806
|
+
".pi/agent-fleet/scripts/lib/coms-envelope.ts",
|
|
794
807
|
".pi/harnesses/lib/herdr-client.ts",
|
|
795
|
-
"hermes/plugins/agent-fleet-herdr/dashboard/activity.py",
|
|
796
|
-
"hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py",
|
|
797
|
-
"hermes/skills/hub-watchdog/scripts/watchdog_transport.py",
|
|
798
|
-
"hermes/skills/hub-watchdog/scripts/watchdog_contract.py"
|
|
799
|
-
"docs/codex-session-bridge.md"
|
|
808
|
+
".pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py",
|
|
809
|
+
".pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py",
|
|
810
|
+
".pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py",
|
|
811
|
+
".pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py"
|
|
800
812
|
],
|
|
801
813
|
"sourceMode": "all",
|
|
802
814
|
"preserveLayout": true,
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@chankov/agent-fleet",
|
|
3
|
-
"version": "2.0.
|
|
3
|
+
"version": "2.0.8",
|
|
4
4
|
"description": "Multi-agent fleet orchestration for coding agents. Pi as the primary runtime, Herdr as the workspace control plane, coms as the peer data plane, and Hermes for remote control — plus skills, personas, harnesses, and a guided setup CLI.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"ai",
|
|
@@ -52,31 +52,31 @@
|
|
|
52
52
|
".pi/skills/",
|
|
53
53
|
".pi/agents/",
|
|
54
54
|
".pi/damage-control-rules.yaml",
|
|
55
|
-
"scripts/*.ts",
|
|
56
|
-
"scripts/package.json",
|
|
57
|
-
"scripts/package-lock.json",
|
|
58
|
-
"scripts/workflows/*.ts",
|
|
59
|
-
"scripts/workflows/lib/*.ts",
|
|
60
|
-
"scripts/workflows/tsconfig.json",
|
|
61
|
-
"
|
|
62
|
-
"
|
|
63
|
-
"
|
|
64
|
-
"
|
|
65
|
-
"scripts/lib/*.ts",
|
|
66
|
-
"scripts/lib/*.js",
|
|
55
|
+
".pi/agent-fleet/scripts/*.ts",
|
|
56
|
+
".pi/agent-fleet/scripts/package.json",
|
|
57
|
+
".pi/agent-fleet/scripts/package-lock.json",
|
|
58
|
+
".pi/agent-fleet/scripts/workflows/*.ts",
|
|
59
|
+
".pi/agent-fleet/scripts/workflows/lib/*.ts",
|
|
60
|
+
".pi/agent-fleet/scripts/workflows/tsconfig.json",
|
|
61
|
+
"!.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts",
|
|
62
|
+
"!.pi/agent-fleet/scripts/hermes-monitor-capability-runner.test.ts",
|
|
63
|
+
"!.pi/agent-fleet/scripts/hermes-monitor-scenario.ts",
|
|
64
|
+
"!.pi/agent-fleet/scripts/hermes-monitor-scenario.test.ts",
|
|
65
|
+
".pi/agent-fleet/scripts/lib/*.ts",
|
|
66
|
+
".pi/agent-fleet/scripts/lib/*.js",
|
|
67
67
|
"codex/",
|
|
68
|
-
"hermes/README.md",
|
|
69
|
-
"hermes/skills/",
|
|
70
|
-
"hermes/plugins/",
|
|
71
|
-
"hermes/desktop-plugins/",
|
|
72
|
-
"
|
|
73
|
-
"
|
|
74
|
-
"
|
|
68
|
+
".pi/agent-fleet/hermes/README.md",
|
|
69
|
+
".pi/agent-fleet/hermes/skills/",
|
|
70
|
+
".pi/agent-fleet/hermes/plugins/",
|
|
71
|
+
".pi/agent-fleet/hermes/desktop-plugins/",
|
|
72
|
+
"!.pi/agent-fleet/hermes/watchdog-tests/",
|
|
73
|
+
"!.pi/agent-fleet/hermes/**/__pycache__/",
|
|
74
|
+
"!.pi/agent-fleet/hermes/**/*.pyc",
|
|
75
75
|
"justfile",
|
|
76
76
|
"install-manifest.json",
|
|
77
77
|
"manifest-meta.json",
|
|
78
78
|
"references/",
|
|
79
|
-
"hooks/",
|
|
79
|
+
".pi/agent-fleet/hooks/",
|
|
80
80
|
"docs/agent-fleet-setup.md",
|
|
81
81
|
"docs/MIGRATION-agent-fleet.md",
|
|
82
82
|
"docs/ARCHITECTURE.md",
|
|
@@ -105,7 +105,7 @@
|
|
|
105
105
|
"!**/*-test.sh",
|
|
106
106
|
"!**/.DS_Store",
|
|
107
107
|
"!docs/plans/**",
|
|
108
|
-
"scripts/fleet-codex-read.py",
|
|
108
|
+
".pi/agent-fleet/scripts/fleet-codex-read.py",
|
|
109
109
|
"docs/codex-session-bridge.md"
|
|
110
110
|
],
|
|
111
111
|
"engines": {
|
|
@@ -115,16 +115,16 @@
|
|
|
115
115
|
"access": "public"
|
|
116
116
|
},
|
|
117
117
|
"scripts": {
|
|
118
|
-
"test": "npm run typecheck:workflows && node bin/cli.js --version && node bin/cli.js --help && node --test --test-concurrency=4 --test-timeout=120000 \"bin/test/*.test.js\" scripts/agent-hub-helpers.test.mjs scripts/agent-hub-spawn.test.mjs scripts/agent-hub-delegate.test.mjs scripts/agent-hub-research.test.mjs .pi/harnesses/lib/herdr-client.test.ts .pi/harnesses/lib/herdr-presence.test.ts .pi/harnesses/lib/coms-registry-entry.test.ts .pi/harnesses/lib/coms-core.test.ts .pi/harnesses/lib/fleet-overlay.test.ts .pi/harnesses/lib/fleet-selection.test.ts .pi/harnesses/lib/fleet-panel.test.ts .pi/harnesses/lib/context-budget.test.ts .pi/harnesses/lib/context-budget-view.test.ts .pi/harnesses/lib/context-budget-hub-prompt.test.ts .pi/harnesses/lib/context-budget-child-prompt.test.ts .pi/harnesses/agent-hub/prompts/system-prompt.test.ts .pi/harnesses/agent-hub/prompts/session-start.test.ts .pi/harnesses/agent-hub/session-start.test.ts .pi/harnesses/agent-hub/context-budget-snapshot.test.ts .pi/harnesses/agent-hub/context-budget.integration.test.ts .pi/harnesses/agent-hub/context-pressure.test.ts .pi/harnesses/agent-hub/capability-packs.test.ts .pi/harnesses/agent-hub/capability-confirmation.test.ts .pi/harnesses/agent-hub/capability-matrix.test.ts .pi/harnesses/lib/fleet-read-model.test.ts .pi/harnesses/lib/fleet-dashboard-view.test.ts .pi/harnesses/lib/fleet-dashboard-ops.test.ts .pi/harnesses/lib/fleet-detail-view.test.ts .pi/harnesses/lib/fleet-transcript-store.test.ts .pi/harnesses/agent-hub/fleet-dashboard.integration.test.ts scripts/coms-cli.test.ts scripts/fleet-codex-client.test.ts scripts/fleet-codex-transport.test.ts scripts/fleet-codex-questions.test.ts scripts/lib/fleet-command.test.ts scripts/lib/flow-command.test.ts scripts/lib/flow-maintenance.test.ts scripts/workflows/lib/env.test.ts scripts/workflows/lib/git.test.ts scripts/workflows/lib/run.test.ts scripts/workflows/lib/quality.test.ts scripts/workflows/lib/changes.test.ts scripts/workflows/lib/gates.test.ts scripts/workflows/lib/permissions.test.ts scripts/workflows/lib/envelopes.test.ts scripts/workflows/lib/agent-phase.test.ts scripts/workflows/lib/envelopes-triad.test.ts scripts/workflows/lib/voices.test.ts scripts/workflows/lib/model-visibility.test.ts scripts/workflows/lib/poll.test.ts scripts/workflows/lib/merge.test.ts scripts/workflows/lib/debate.test.ts scripts/workflows/lib/writer-lease.test.ts scripts/workflows/wf-scout.test.ts scripts/workflows/wf-build-test.test.ts scripts/workflows/wf-document.test.ts scripts/workflows/wf-poll.test.ts scripts/workflows/wf-debate.test.ts skills/drafting-workflows/scripts/make-workflow.test.ts scripts/lib/team-project.test.ts scripts/lib/herdr-layout.test.ts scripts/lib/peer-launch.test.ts scripts/lib/spawn-stagger.test.ts scripts/lib/monitor-env.test.ts scripts/lib/fleet-extras.test.ts scripts/lib/team-snapshot.test.ts scripts/team-snapshot.command.test.ts scripts/lib/coms-envelope.test.ts scripts/lib/claude-bridge-core.test.ts scripts/lib/hermes-bridge-core.test.ts scripts/coms-hermes-bridge.test.ts .pi/harnesses/ask-user-remote/race-core.test.js .pi/harnesses/ask-user-remote/questions.test.ts .pi/harnesses/ask-user-remote/index.test.ts .pi/harnesses/agent-hub/extension-loader.test.ts .pi/harnesses/agent-hub/registration-surface.test.ts .pi/harnesses/agent-hub/poll-command.test.ts .pi/harnesses/agent-hub/debate-command.test.ts .pi/harnesses/agent-hub/delegate-thinking.test.ts .pi/harnesses/agent-hub/backend-routing.integration.test.ts .pi/harnesses/agent-hub/dispatch-core.test.ts .pi/extensions/btw/state.test.js .pi/extensions/btw/index.test.ts .pi/harnesses/agent-hub/work-mode.test.ts .pi/harnesses/agent-hub/work-mode-controls.test.ts .pi/harnesses/agent-hub/work-mode-integration.test.ts .pi/harnesses/agent-hub/footer.test.ts .pi/harnesses/agent-hub/view-default.test.ts .pi/harnesses/agent-hub/overlay-migration.test.ts .pi/harnesses/agent-hub/safety-routing.test.ts .pi/harnesses/agent-hub/approval-routing.integration.test.ts .pi/harnesses/agent-hub/run-budget.test.js .pi/harnesses/agent-hub/budget-continuation.test.ts .pi/harnesses/agent-hub/budget-continuation.integration.test.ts .pi/harnesses/agent-hub/budget-recovery.test.ts .pi/harnesses/agent-hub/evidence-retention.test.ts .pi/harnesses/agent-hub/no-progress.test.ts .pi/harnesses/agent-hub/acceptance.test.ts .pi/harnesses/agent-hub/tools/dispatch-execution.test.ts .pi/harnesses/agent-hub/context/budgets.test.ts .pi/harnesses/agent-hub/lifecycle/lifecycle.test.ts .pi/harnesses/ask-user-remote/runtime-ask.test.ts .pi/harnesses/agent-hub/hub-state-audit.test.js .pi/harnesses/agent-hub/docs-lane.test.js .pi/harnesses/agent-hub/external-blocker.test.js .pi/harnesses/agent-hub/run-namespace.test.js .pi/harnesses/agent-hub/review-findings.test.js .pi/harnesses/agent-hub/assertion-ledger.test.js .pi/harnesses/agent-hub/provider-semaphore.test.js .pi/harnesses/lib/spawned-peers.test.js .pi/harnesses/agent-hub/context-window.test.js .pi/harnesses/agent-hub/drift-watchdog.test.js .pi/harnesses/agent-hub/session-health.test.js .pi/harnesses/agent-hub/return-contract.test.js .pi/harnesses/agent-hub/return-extract.test.js .pi/harnesses/agent-hub/backend-policy.test.js .pi/harnesses/agent-hub/artifacts.test.js .pi/harnesses/agent-hub/scope-gate.test.js .pi/harnesses/agent-hub/evidence-rules.test.js .pi/harnesses/agent-hub/research/runtime.test.ts .pi/harnesses/agent-hub/research/controls.test.ts .pi/harnesses/agent-hub/ui/running-strip.test.ts .pi/harnesses/agent-hub/ui/grid.test.ts .pi/harnesses/agent-hub/ui/fleet-dashboard.test.ts .pi/harnesses/agent-hub/input/presentation.test.ts .pi/harnesses/agent-hub/config/overrides.test.ts .pi/harnesses/lib/damage-control-shared.test.ts .pi/harnesses/lib/update-check.test.ts .pi/harnesses/damage-control-continue/herdr-rules.test.js .pi/harnesses/damage-control-continue/exemptions.test.js scripts/lib/hermes-monitor-model.test.ts scripts/lib/hermes-monitor-events.test.ts scripts/lib/hermes-monitor-store.test.ts scripts/lib/hermes-monitor-retention.integration.test.ts scripts/lib/hermes-monitor-registry.test.ts scripts/lib/hermes-monitor-socket.test.ts scripts/lib/hermes-monitor-data-path.test.ts scripts/lib/hermes-monitor-slice7-9-backend.test.ts scripts/lib/hermes-monitor-control-socket.test.ts scripts/lib/hermes-monitor-e2e.test.ts scripts/lib/hermes-monitor-plugin-handshake.test.ts scripts/hermes-monitor-capability-runner.test.ts scripts/hermes-monitor-scenario.test.ts scripts/hermes-watchdog-capability-probe.test.ts .pi/harnesses/agent-hub/monitor-invoke.test.ts .pi/harnesses/agent-hub/monitor-invoke-journal.test.ts .pi/harnesses/agent-hub/monitor-control.test.ts .pi/harnesses/agent-hub/monitor-live-bridge-gaps.test.ts .pi/harnesses/agent-hub/monitor-review-live-wiring.red.test.ts .pi/harnesses/agent-hub/monitor-runtime.test.ts .pi/harnesses/agent-hub/monitor-bridge-runtime.test.ts .pi/harnesses/agent-hub/monitor-reconcile.test.ts .pi/harnesses/agent-hub/monitor-recovery.test.ts .pi/harnesses/agent-hub/monitor-lifecycle-lease.test.ts .pi/harnesses/agent-hub/monitor-session-bridge-race.test.ts .pi/harnesses/agent-hub/monitor-session-bridge.test.ts .pi/harnesses/agent-hub/monitor-cancel-race.test.ts .pi/harnesses/agent-hub/monitor-wait-only.test.ts .pi/harnesses/agent-hub/monitor-publisher.test.ts .pi/harnesses/agent-hub/monitor-index.integration.test.ts .pi/harnesses/agent-hub/monitor-coms-turn.test.ts hermes/desktop-plugins/agent-fleet-herdr/presentation.test.js .pi/harnesses/agent-hub/config/model-profiles.test.ts .pi/harnesses/agent-hub/policy/models.test.ts .pi/harnesses/agent-hub/policy/profile-activation.test.ts .pi/harnesses/agent-hub/profile-execution.test.ts scripts/docs-links.test.mjs && npm run test:watchdog-py",
|
|
119
|
-
"typecheck:workflows": "tsc -p scripts/workflows/tsconfig.json --noEmit",
|
|
120
|
-
"test:watchdog-py": "PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s hermes/watchdog-tests -p 'test_*.py'",
|
|
118
|
+
"test": "npm run typecheck:workflows && node bin/cli.js --version && node bin/cli.js --help && node --test --test-concurrency=4 --test-timeout=120000 \"bin/test/*.test.js\" .pi/agent-fleet/scripts/agent-hub-helpers.test.mjs .pi/agent-fleet/scripts/agent-hub-spawn.test.mjs .pi/agent-fleet/scripts/agent-hub-delegate.test.mjs .pi/agent-fleet/scripts/agent-hub-research.test.mjs .pi/harnesses/lib/herdr-client.test.ts .pi/harnesses/lib/herdr-presence.test.ts .pi/harnesses/lib/coms-registry-entry.test.ts .pi/harnesses/lib/coms-core.test.ts .pi/harnesses/lib/fleet-overlay.test.ts .pi/harnesses/lib/fleet-selection.test.ts .pi/harnesses/lib/fleet-panel.test.ts .pi/harnesses/lib/context-budget.test.ts .pi/harnesses/lib/context-budget-view.test.ts .pi/harnesses/lib/context-budget-hub-prompt.test.ts .pi/harnesses/lib/context-budget-child-prompt.test.ts .pi/harnesses/agent-hub/prompts/system-prompt.test.ts .pi/harnesses/agent-hub/prompts/session-start.test.ts .pi/harnesses/agent-hub/session-start.test.ts .pi/harnesses/agent-hub/context-budget-snapshot.test.ts .pi/harnesses/agent-hub/context-budget.integration.test.ts .pi/harnesses/agent-hub/context-pressure.test.ts .pi/harnesses/agent-hub/capability-packs.test.ts .pi/harnesses/agent-hub/capability-confirmation.test.ts .pi/harnesses/agent-hub/capability-matrix.test.ts .pi/harnesses/lib/fleet-read-model.test.ts .pi/harnesses/lib/fleet-dashboard-view.test.ts .pi/harnesses/lib/fleet-dashboard-ops.test.ts .pi/harnesses/lib/fleet-detail-view.test.ts .pi/harnesses/lib/fleet-transcript-store.test.ts .pi/harnesses/agent-hub/fleet-dashboard.integration.test.ts .pi/agent-fleet/scripts/coms-cli.test.ts .pi/agent-fleet/scripts/fleet-codex-client.test.ts .pi/agent-fleet/scripts/fleet-codex-transport.test.ts .pi/agent-fleet/scripts/fleet-codex-questions.test.ts .pi/agent-fleet/scripts/lib/fleet-command.test.ts .pi/agent-fleet/scripts/lib/flow-command.test.ts .pi/agent-fleet/scripts/lib/flow-maintenance.test.ts .pi/agent-fleet/scripts/workflows/lib/env.test.ts .pi/agent-fleet/scripts/workflows/lib/git.test.ts .pi/agent-fleet/scripts/workflows/lib/run.test.ts .pi/agent-fleet/scripts/workflows/lib/quality.test.ts .pi/agent-fleet/scripts/workflows/lib/changes.test.ts .pi/agent-fleet/scripts/workflows/lib/gates.test.ts .pi/agent-fleet/scripts/workflows/lib/permissions.test.ts .pi/agent-fleet/scripts/workflows/lib/envelopes.test.ts .pi/agent-fleet/scripts/workflows/lib/agent-phase.test.ts .pi/agent-fleet/scripts/workflows/lib/envelopes-triad.test.ts .pi/agent-fleet/scripts/workflows/lib/voices.test.ts .pi/agent-fleet/scripts/workflows/lib/model-visibility.test.ts .pi/agent-fleet/scripts/workflows/lib/poll.test.ts .pi/agent-fleet/scripts/workflows/lib/merge.test.ts .pi/agent-fleet/scripts/workflows/lib/debate.test.ts .pi/agent-fleet/scripts/workflows/lib/writer-lease.test.ts .pi/agent-fleet/scripts/workflows/wf-scout.test.ts .pi/agent-fleet/scripts/workflows/wf-build-test.test.ts .pi/agent-fleet/scripts/workflows/wf-document.test.ts .pi/agent-fleet/scripts/workflows/wf-poll.test.ts .pi/agent-fleet/scripts/workflows/wf-debate.test.ts skills/drafting-workflows/scripts/make-workflow.test.ts .pi/agent-fleet/scripts/lib/team-project.test.ts .pi/agent-fleet/scripts/lib/herdr-layout.test.ts .pi/agent-fleet/scripts/lib/peer-launch.test.ts .pi/agent-fleet/scripts/lib/spawn-stagger.test.ts .pi/agent-fleet/scripts/lib/monitor-env.test.ts .pi/agent-fleet/scripts/lib/fleet-extras.test.ts .pi/agent-fleet/scripts/lib/team-snapshot.test.ts .pi/agent-fleet/scripts/team-snapshot.command.test.ts .pi/agent-fleet/scripts/lib/coms-envelope.test.ts .pi/agent-fleet/scripts/lib/claude-bridge-core.test.ts .pi/agent-fleet/scripts/lib/hermes-bridge-core.test.ts .pi/agent-fleet/scripts/coms-hermes-bridge.test.ts .pi/harnesses/ask-user-remote/race-core.test.js .pi/harnesses/ask-user-remote/questions.test.ts .pi/harnesses/ask-user-remote/index.test.ts .pi/harnesses/agent-hub/extension-loader.test.ts .pi/harnesses/agent-hub/registration-surface.test.ts .pi/harnesses/agent-hub/poll-command.test.ts .pi/harnesses/agent-hub/debate-command.test.ts .pi/harnesses/agent-hub/delegate-thinking.test.ts .pi/harnesses/agent-hub/backend-routing.integration.test.ts .pi/harnesses/agent-hub/dispatch-core.test.ts .pi/extensions/btw/state.test.js .pi/extensions/btw/index.test.ts .pi/harnesses/agent-hub/work-mode.test.ts .pi/harnesses/agent-hub/work-mode-controls.test.ts .pi/harnesses/agent-hub/work-mode-integration.test.ts .pi/harnesses/agent-hub/footer.test.ts .pi/harnesses/agent-hub/view-default.test.ts .pi/harnesses/agent-hub/overlay-migration.test.ts .pi/harnesses/agent-hub/safety-routing.test.ts .pi/harnesses/agent-hub/approval-routing.integration.test.ts .pi/harnesses/agent-hub/run-budget.test.js .pi/harnesses/agent-hub/budget-continuation.test.ts .pi/harnesses/agent-hub/budget-continuation.integration.test.ts .pi/harnesses/agent-hub/budget-recovery.test.ts .pi/harnesses/agent-hub/evidence-retention.test.ts .pi/harnesses/agent-hub/no-progress.test.ts .pi/harnesses/agent-hub/acceptance.test.ts .pi/harnesses/agent-hub/tools/dispatch-execution.test.ts .pi/harnesses/agent-hub/context/budgets.test.ts .pi/harnesses/agent-hub/lifecycle/lifecycle.test.ts .pi/harnesses/ask-user-remote/runtime-ask.test.ts .pi/harnesses/agent-hub/hub-state-audit.test.js .pi/harnesses/agent-hub/docs-lane.test.js .pi/harnesses/agent-hub/external-blocker.test.js .pi/harnesses/agent-hub/run-namespace.test.js .pi/harnesses/agent-hub/review-findings.test.js .pi/harnesses/agent-hub/assertion-ledger.test.js .pi/harnesses/agent-hub/provider-semaphore.test.js .pi/harnesses/lib/spawned-peers.test.js .pi/harnesses/agent-hub/context-window.test.js .pi/harnesses/agent-hub/drift-watchdog.test.js .pi/harnesses/agent-hub/session-health.test.js .pi/harnesses/agent-hub/return-contract.test.js .pi/harnesses/agent-hub/return-extract.test.js .pi/harnesses/agent-hub/backend-policy.test.js .pi/harnesses/agent-hub/artifacts.test.js .pi/harnesses/agent-hub/scope-gate.test.js .pi/harnesses/agent-hub/evidence-rules.test.js .pi/harnesses/agent-hub/research/runtime.test.ts .pi/harnesses/agent-hub/research/controls.test.ts .pi/harnesses/agent-hub/ui/running-strip.test.ts .pi/harnesses/agent-hub/ui/grid.test.ts .pi/harnesses/agent-hub/ui/fleet-dashboard.test.ts .pi/harnesses/agent-hub/input/presentation.test.ts .pi/harnesses/agent-hub/config/overrides.test.ts .pi/harnesses/lib/damage-control-shared.test.ts .pi/harnesses/lib/update-check.test.ts .pi/harnesses/damage-control-continue/herdr-rules.test.js .pi/harnesses/damage-control-continue/exemptions.test.js .pi/agent-fleet/scripts/lib/hermes-monitor-model.test.ts .pi/agent-fleet/scripts/lib/hermes-monitor-events.test.ts .pi/agent-fleet/scripts/lib/hermes-monitor-store.test.ts .pi/agent-fleet/scripts/lib/hermes-monitor-retention.integration.test.ts .pi/agent-fleet/scripts/lib/hermes-monitor-registry.test.ts .pi/agent-fleet/scripts/lib/hermes-monitor-socket.test.ts .pi/agent-fleet/scripts/lib/hermes-monitor-data-path.test.ts .pi/agent-fleet/scripts/lib/hermes-monitor-slice7-9-backend.test.ts .pi/agent-fleet/scripts/lib/hermes-monitor-control-socket.test.ts .pi/agent-fleet/scripts/lib/hermes-monitor-e2e.test.ts .pi/agent-fleet/scripts/lib/hermes-monitor-plugin-handshake.test.ts .pi/agent-fleet/scripts/hermes-monitor-capability-runner.test.ts .pi/agent-fleet/scripts/hermes-monitor-scenario.test.ts .pi/agent-fleet/scripts/hermes-watchdog-capability-probe.test.ts .pi/harnesses/agent-hub/monitor-invoke.test.ts .pi/harnesses/agent-hub/monitor-invoke-journal.test.ts .pi/harnesses/agent-hub/monitor-control.test.ts .pi/harnesses/agent-hub/monitor-live-bridge-gaps.test.ts .pi/harnesses/agent-hub/monitor-review-live-wiring.red.test.ts .pi/harnesses/agent-hub/monitor-runtime.test.ts .pi/harnesses/agent-hub/monitor-bridge-runtime.test.ts .pi/harnesses/agent-hub/monitor-reconcile.test.ts .pi/harnesses/agent-hub/monitor-recovery.test.ts .pi/harnesses/agent-hub/monitor-lifecycle-lease.test.ts .pi/harnesses/agent-hub/monitor-session-bridge-race.test.ts .pi/harnesses/agent-hub/monitor-session-bridge.test.ts .pi/harnesses/agent-hub/monitor-cancel-race.test.ts .pi/harnesses/agent-hub/monitor-wait-only.test.ts .pi/harnesses/agent-hub/monitor-publisher.test.ts .pi/harnesses/agent-hub/monitor-index.integration.test.ts .pi/harnesses/agent-hub/monitor-coms-turn.test.ts .pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.test.js .pi/harnesses/agent-hub/config/model-profiles.test.ts .pi/harnesses/agent-hub/policy/models.test.ts .pi/harnesses/agent-hub/policy/profile-activation.test.ts .pi/harnesses/agent-hub/profile-execution.test.ts .pi/agent-fleet/scripts/docs-links.test.mjs && npm run test:watchdog-py",
|
|
119
|
+
"typecheck:workflows": "tsc -p .pi/agent-fleet/scripts/workflows/tsconfig.json --noEmit",
|
|
120
|
+
"test:watchdog-py": "PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s .pi/agent-fleet/hermes/watchdog-tests -p 'test_*.py'",
|
|
121
121
|
"pack:dry": "npm pack --dry-run",
|
|
122
122
|
"changeset": "changeset",
|
|
123
123
|
"build:manifest": "node bin/build-manifest.js",
|
|
124
124
|
"check:manifest": "node bin/build-manifest.js --check",
|
|
125
125
|
"version:changeset": "node bin/force-patch-changesets.js && changeset version && node bin/sync-harness-versions.js && npm install --package-lock-only --ignore-scripts --no-audit --no-fund && node bin/build-manifest.js && node bin/snapshot-version.js",
|
|
126
126
|
"release": "changeset publish",
|
|
127
|
-
"test:fleet-client": "node --test scripts/fleet-codex-client.test.ts scripts/fleet-codex-transport.test.ts scripts/fleet-codex-questions.test.ts && PYTHONDONTWRITEBYTECODE=1 python3 scripts/fleet-codex-read.test.py"
|
|
127
|
+
"test:fleet-client": "node --test .pi/agent-fleet/scripts/fleet-codex-client.test.ts .pi/agent-fleet/scripts/fleet-codex-transport.test.ts .pi/agent-fleet/scripts/fleet-codex-questions.test.ts && PYTHONDONTWRITEBYTECODE=1 python3 .pi/agent-fleet/scripts/fleet-codex-read.test.py"
|
|
128
128
|
},
|
|
129
129
|
"devDependencies": {
|
|
130
130
|
"@changesets/cli": "^2.27.1",
|
|
@@ -26,6 +26,7 @@ Telemetry without a question is noise. Before instrumenting anything:
|
|
|
26
26
|
- [ ] Logs are structured (JSON) with stable event names — not free-form strings
|
|
27
27
|
- [ ] Every log line carries a correlation/request ID, generated or accepted at the system boundary
|
|
28
28
|
- [ ] Correlation ID is propagated on every outbound call and async boundary (HTTP headers, queue metadata)
|
|
29
|
+
- [ ] Any log stream written by more than one entry point (scheduler, replay endpoint, manual run) carries an entry-point field, set where the run starts and propagated alongside the correlation ID
|
|
29
30
|
- [ ] Log levels are consistent: `error` = invariant broken, someone may act; `warn` = degraded but handled; `info` = significant business event; `debug` = off in production
|
|
30
31
|
- [ ] No secrets, tokens, passwords, or unredacted PII in any log line (hard rule from `security-and-hardening`)
|
|
31
32
|
- [ ] Fields are allowlisted — no whole request/response bodies, no auth headers
|
|
@@ -8,6 +8,7 @@ Quick reference checklist for web application performance. Use alongside the `pe
|
|
|
8
8
|
- [TTFB Diagnosis](#ttfb-diagnosis)
|
|
9
9
|
- [Frontend Checklist](#frontend-checklist)
|
|
10
10
|
- [Backend Checklist](#backend-checklist)
|
|
11
|
+
- [Caching Strategies](#caching-strategies)
|
|
11
12
|
- [Measurement Commands](#measurement-commands)
|
|
12
13
|
- [Common Anti-Patterns](#common-anti-patterns)
|
|
13
14
|
|
|
@@ -92,6 +93,30 @@ When TTFB is slow (> 800ms), check each component in DevTools Network waterfall:
|
|
|
92
93
|
- [ ] Connection pooling configured
|
|
93
94
|
- [ ] Slow query logging enabled
|
|
94
95
|
|
|
96
|
+
#### Query plans
|
|
97
|
+
- [ ] `EXPLAIN ANALYZE` captured **before** the fix, not just after — it is the baseline
|
|
98
|
+
- [ ] `Seq Scan` on a large table understood: index missing, unusable, or genuinely not worth it
|
|
99
|
+
- [ ] Estimated vs actual `rows=` within an order of magnitude (if not, refresh statistics before touching indexes)
|
|
100
|
+
- [ ] No `Sort` node that a composite index could absorb
|
|
101
|
+
- [ ] Plan re-checked after the change — an index that did not change the plan gets reverted
|
|
102
|
+
|
|
103
|
+
#### Index strategy
|
|
104
|
+
- [ ] Composite index column order is equality first, then range/sort
|
|
105
|
+
- [ ] Index covers the query shape (filter + sort), not just one column in isolation
|
|
106
|
+
- [ ] Covering index considered for hot read paths (index-only scan avoids the heap fetch)
|
|
107
|
+
- [ ] Not indexing low-selectivity columns *for the dominant value*; a partial index still serves the rare-value query (`WHERE status = 'failed'`)
|
|
108
|
+
- [ ] Expression index used where the query applies a function (`lower(email)`)
|
|
109
|
+
- [ ] Full-text or trigram index used for leading-wildcard search, not a B-tree
|
|
110
|
+
- [ ] Write cost measured on write-heavy tables (every index taxes every `INSERT`/`UPDATE`)
|
|
111
|
+
- [ ] Unused and duplicate indexes dropped (they cost writes and buy nothing)
|
|
112
|
+
|
|
113
|
+
#### Connection pooling
|
|
114
|
+
- [ ] One pool per process, not per request or per module
|
|
115
|
+
- [ ] `instances × pool max` stays under the database's `max_connections`
|
|
116
|
+
- [ ] `connectionTimeoutMillis` set so exhaustion fails fast instead of queueing forever
|
|
117
|
+
- [ ] Exhaustion diagnosed before resizing: find what holds connections (long transactions, missing `await`, leaked clients)
|
|
118
|
+
- [ ] Serverless / autoscaling fronted by a multiplexing proxy (pgbouncer, RDS Proxy) rather than a larger pool
|
|
119
|
+
|
|
95
120
|
### API
|
|
96
121
|
- [ ] Response times < 200ms (p95)
|
|
97
122
|
- [ ] No synchronous heavy computation in request handlers
|
|
@@ -105,6 +130,58 @@ When TTFB is slow (> 800ms), check each component in DevTools Network waterfall:
|
|
|
105
130
|
- [ ] Horizontal scaling configured (if needed)
|
|
106
131
|
- [ ] Health check endpoint for load balancer
|
|
107
132
|
|
|
133
|
+
## Caching Strategies
|
|
134
|
+
|
|
135
|
+
The decision material (which layer, which invalidation strategy, what never to cache) lives in the `performance-optimization` skill. This section covers the read/write patterns and the checklist.
|
|
136
|
+
|
|
137
|
+
### Read and write patterns
|
|
138
|
+
|
|
139
|
+
| Pattern | How it works | Use when | Watch out for |
|
|
140
|
+
|---|---|---|---|
|
|
141
|
+
| **Cache-aside** (lazy) | App checks cache, on miss reads origin and populates | Default choice; read-heavy, tolerant of a cold first hit | Every miss hits the origin, so it needs stampede protection |
|
|
142
|
+
| **Read-through** | Cache layer itself loads on miss | You want the load path in one place, not at every call site | Hides origin latency; a slow origin looks like a slow cache |
|
|
143
|
+
| **Write-through** | Write goes to cache and origin together, synchronously | Reads must never see a stale value after a write | Adds cache latency to every write |
|
|
144
|
+
| **Write-behind** (write-back) | Write hits cache, origin updated asynchronously | Write-heavy, and the origin is the bottleneck | Data loss window if the cache dies before the flush. Needs durability you can defend |
|
|
145
|
+
|
|
146
|
+
### Negative caching
|
|
147
|
+
|
|
148
|
+
Cache the *absence* of a result too. A key that misses on every lookup (a nonexistent user ID probed in a loop, a 404 asset) sends every request to the origin, which is a cache that only protects the happy path.
|
|
149
|
+
|
|
150
|
+
- Store an explicit "not found" sentinel with a **shorter** TTL than positive entries
|
|
151
|
+
- Keep the negative TTL short enough that a newly created record appears promptly
|
|
152
|
+
- Never let an origin *error* become a negative cache entry, or one failing minute becomes many
|
|
153
|
+
|
|
154
|
+
### Request coalescing (stampede protection)
|
|
155
|
+
|
|
156
|
+
One recompute, N waiters. Prevents a hot key's expiry from delivering the full concurrent load to the origin:
|
|
157
|
+
|
|
158
|
+
```typescript
|
|
159
|
+
const inFlight = new Map<string, Promise<unknown>>();
|
|
160
|
+
|
|
161
|
+
function loadOnce<T>(key: string, fetcher: () => Promise<T>): Promise<T> {
|
|
162
|
+
const existing = inFlight.get(key) as Promise<T> | undefined;
|
|
163
|
+
if (existing) return existing;
|
|
164
|
+
const p = fetcher().finally(() => inFlight.delete(key));
|
|
165
|
+
inFlight.set(key, p);
|
|
166
|
+
return p;
|
|
167
|
+
}
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
For a shared cache, the same idea needs a distributed lock, or `stale-while-revalidate` so waiters serve the stale value instead of blocking.
|
|
171
|
+
|
|
172
|
+
### Cache checklist
|
|
173
|
+
- [ ] The cached call was measured as expensive first (caching a fast call adds a hop and buys nothing)
|
|
174
|
+
- [ ] Read/write ratio justifies the cache (re-read far more often than written)
|
|
175
|
+
- [ ] Cache key includes every input the response varies on: tenant, viewer, locale, permissions, feature flags
|
|
176
|
+
- [ ] No per-user data cached under a key that does not identify the user
|
|
177
|
+
- [ ] One invalidation strategy chosen (TTL, event/tag, or versioned keys), not an accidental mix
|
|
178
|
+
- [ ] Acceptable staleness window written down, not implied by whatever TTL was typed
|
|
179
|
+
- [ ] Stampede protection on hot keys (coalescing, lock, or `stale-while-revalidate`)
|
|
180
|
+
- [ ] Negative results cached with a shorter TTL; origin errors never cached
|
|
181
|
+
- [ ] Eviction policy and memory ceiling set (an unbounded cache is a memory leak)
|
|
182
|
+
- [ ] Hit rate monitored — a cache nobody measures is an assumption, and a low hit rate is pure overhead
|
|
183
|
+
- [ ] Nothing cached whose staleness is a correctness bug (balances, permissions, inventory at checkout)
|
|
184
|
+
|
|
108
185
|
## Measurement Commands
|
|
109
186
|
|
|
110
187
|
### INP field data and DevTools workflow
|
|
@@ -146,6 +223,12 @@ onINP(({ value, attribution }) => {
|
|
|
146
223
|
| N+1 queries | Linear DB load growth | Use joins, includes, or batch loading |
|
|
147
224
|
| Unbounded queries | Memory exhaustion, timeouts | Always paginate, add LIMIT |
|
|
148
225
|
| Missing indexes | Slow reads as data grows | Add indexes for filtered/sorted columns |
|
|
226
|
+
| Indexing without reading the plan | Write cost paid, read gain unproven | `EXPLAIN ANALYZE` before and after; revert if the plan is unchanged |
|
|
227
|
+
| Redundant / unused indexes | Every write pays for them | Audit usage stats, drop what nothing reads |
|
|
228
|
+
| Connection pool per request | Exhausts `max_connections` under load | One pool per process; proxy for serverless |
|
|
229
|
+
| Cache key missing the viewer | One user's data served to another | Key on tenant, viewer, locale, permissions |
|
|
230
|
+
| Unbounded cache | Memory leak wearing an optimization's clothing | Set eviction policy and a memory ceiling |
|
|
231
|
+
| Cache stampede on a hot key | Origin takes full concurrent load at expiry | Coalesce misses, or `stale-while-revalidate` |
|
|
149
232
|
| Layout thrashing | Jank, dropped frames | Batch DOM reads, then batch writes |
|
|
150
233
|
| Unoptimized images | Slow LCP, wasted bandwidth | Use WebP, responsive sizes, lazy load |
|
|
151
234
|
| Large bundles | Slow Time to Interactive | Code split, tree shake, audit deps |
|
|
@@ -6,7 +6,7 @@ Consolidated prompt-engineering best practices for authoring instructions that c
|
|
|
6
6
|
|
|
7
7
|
Three primary audiences:
|
|
8
8
|
|
|
9
|
-
1. **Persona authors** writing files under
|
|
9
|
+
1. **Persona authors** writing files under `.pi/agents/personas/` — check sections 1-3, 6, 7, 12 before writing.
|
|
10
10
|
2. **Skill authors** writing files under `skills/` — check sections 1, 2, 4, 6.4, 7, 12 before writing.
|
|
11
11
|
3. **Rule-file authors** writing project rules (CLAUDE.md, AGENTS.md, or supplementary rule files) — check sections 1.4, 2, 9, 11, 12.
|
|
12
12
|
|