@chankov/agent-fleet 2.0.7 → 2.0.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/{hermes → .pi/agent-fleet/hermes}/README.md +7 -7
- package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/activity.py +2 -2
- package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/coms_registry.py +2 -2
- package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/coms_send.py +1 -1
- package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/watch.py +2 -2
- package/{hermes → .pi/agent-fleet/hermes}/skills/hub-conductor/SKILL.md +1 -1
- package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/SKILL.md +3 -3
- package/{hooks → .pi/agent-fleet/hooks}/coms-stop-hook.mjs +2 -2
- package/{scripts → .pi/agent-fleet/scripts}/claude-code-preflight.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/coms-claude-bridge.ts +6 -6
- package/{scripts → .pi/agent-fleet/scripts}/coms-cli.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/coms-hermes-bridge.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/fleet-codex-read.py +5 -3
- package/{scripts → .pi/agent-fleet/scripts}/fleet.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/flow.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/lib/claude-bridge-core.ts +2 -2
- package/{scripts → .pi/agent-fleet/scripts}/lib/coms-envelope.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-transport.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/lib/herdr-layout.ts +3 -3
- package/{scripts → .pi/agent-fleet/scripts}/lib/hermes-bridge-core.ts +1 -1
- package/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/{scripts → .pi/agent-fleet/scripts}/lib/hermes-monitor-model.ts +1 -1
- package/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
- package/{scripts → .pi/agent-fleet/scripts}/lib/monitor-env.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/lib/peer-launch.ts +3 -3
- package/{scripts → .pi/agent-fleet/scripts}/lib/persona-banner.ts +1 -1
- package/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
- package/{scripts → .pi/agent-fleet/scripts}/lib/runtime-dependencies.js +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/lib/spawn-stagger.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/lib/team-project.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/lib/team-snapshot.ts +2 -2
- package/{scripts → .pi/agent-fleet/scripts}/peer-banner.ts +5 -4
- package/{scripts → .pi/agent-fleet/scripts}/peer-launch.ts +7 -9
- package/{scripts → .pi/agent-fleet/scripts}/team-snapshot.ts +5 -5
- package/{scripts → .pi/agent-fleet/scripts}/team-up.ts +6 -6
- package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/agent-phase.ts +3 -3
- package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/envelopes.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/model-profile.ts +1 -1
- package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/personas.ts +2 -2
- package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/trace.ts +1 -1
- package/.pi/agents/peers.yaml +3 -1
- package/.pi/harnesses/agent-hub/README.md +1 -1
- package/.pi/harnesses/agent-hub/config/agents.ts +5 -1
- package/.pi/harnesses/agent-hub/debate-command.ts +1 -1
- package/.pi/harnesses/agent-hub/index.ts +19 -19
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/peer-spawn-plan.ts +1 -1
- package/.pi/harnesses/agent-hub/tools/fleet-tools.ts +3 -5
- package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +2 -2
- package/.pi/harnesses/ask-user-remote/index.ts +2 -2
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/spawned-peers.js +1 -1
- package/.pi/prompts/af-constraints.md +31 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/README.md +347 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.8/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.8/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/fleet.ts +216 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/flow.ts +137 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/package-lock.json +35 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/package.json +9 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/team-up.ts +378 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +133 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-scout.ts +38 -0
- package/.versions/2.0.8/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.8/.pi/agents/model-profiles.yaml +83 -0
- package/.versions/2.0.8/.pi/agents/peers.yaml +147 -0
- package/.versions/2.0.8/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.8/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.8/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.8/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.8/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.8/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.8/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.8/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.8/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.8/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.8/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.8/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.8/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.8/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.8/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.8/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.8/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.8/.pi/extensions/package.json +9 -0
- package/.versions/2.0.8/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/2.0.8/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.8/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.8/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.8/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.8/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.8/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/README.md +1203 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/acceptance.ts +62 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/context.ts +43 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/config/agents.ts +177 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/delegate.ts +446 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/index.ts +2151 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/no-progress.ts +76 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/scope-gate.js +123 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/spawn.ts +404 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/context.ts +134 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/types.ts +63 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.8/.pi/harnesses/agent-hub/work-mode.ts +167 -0
- package/.versions/2.0.8/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.8/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.8/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.8/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.8/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
- package/.versions/2.0.8/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.8/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.8/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.8/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.8/.pi/harnesses/damage-control-continue/README.md +135 -0
- package/.versions/2.0.8/.pi/harnesses/damage-control-continue/index.ts +541 -0
- package/.versions/2.0.8/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.8/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.8/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.8/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.8/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.8/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
- package/.versions/2.0.8/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.8/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.8/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.8/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.8/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.8/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.8/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.8/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/2.0.8/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.8/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.8/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.8/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.8/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.8/.pi/prompts/af-constraints.md +31 -0
- package/.versions/2.0.8/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.8/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.8/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.8/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.8/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.8/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.8/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.8/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.8/.version +1 -0
- package/.versions/2.0.8/agents/architect.md +25 -0
- package/.versions/2.0.8/agents/bowser.md +28 -0
- package/.versions/2.0.8/agents/builder.md +56 -0
- package/.versions/2.0.8/agents/code-reviewer.md +210 -0
- package/.versions/2.0.8/agents/deep-researcher.md +33 -0
- package/.versions/2.0.8/agents/documenter.md +23 -0
- package/.versions/2.0.8/agents/orchestrator.md +23 -0
- package/.versions/2.0.8/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.8/agents/planner.md +106 -0
- package/.versions/2.0.8/agents/releaser.md +25 -0
- package/.versions/2.0.8/agents/researcher.md +31 -0
- package/.versions/2.0.8/agents/security-auditor.md +168 -0
- package/.versions/2.0.8/agents/test-engineer.md +154 -0
- package/.versions/2.0.8/agents/web-debugger.md +44 -0
- package/.versions/2.0.8/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.8/bin/catalog/harness-runtime-closure.json +32 -0
- package/.versions/2.0.8/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.8/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.8/docs/ARCHITECTURE.md +416 -0
- package/.versions/2.0.8/docs/agent-fleet-setup.md +568 -0
- package/.versions/2.0.8/docs/claude-code-coms-bridge.md +134 -0
- package/.versions/2.0.8/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.8/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.8/docs/getting-started.md +126 -0
- package/.versions/2.0.8/docs/npm-install.md +356 -0
- package/.versions/2.0.8/docs/pi-extensions.md +446 -0
- package/.versions/2.0.8/docs/pi-setup.md +76 -0
- package/.versions/2.0.8/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.8/install-manifest.json +2991 -0
- package/.versions/2.0.8/justfile +247 -0
- package/.versions/2.0.8/manifest-meta.json +970 -0
- package/.versions/2.0.8/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.8/references/communication-contract.md +26 -0
- package/.versions/2.0.8/references/definition-of-done.md +67 -0
- package/.versions/2.0.8/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.8/references/observability-checklist.md +92 -0
- package/.versions/2.0.8/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.8/references/performance-checklist.md +236 -0
- package/.versions/2.0.8/references/prompting-patterns.md +380 -0
- package/.versions/2.0.8/references/security-checklist.md +245 -0
- package/.versions/2.0.8/references/testing-patterns.md +235 -0
- package/.versions/2.0.8/references/workflow-authoring.md +304 -0
- package/.versions/2.0.8/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.8/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.8/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.8/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.8/skills/constraint-driven-development/SKILL.md +338 -0
- package/.versions/2.0.8/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.8/skills/context-engineering/SKILL.md +341 -0
- package/.versions/2.0.8/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.8/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.8/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.8/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.8/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.8/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.8/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.8/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.8/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.8/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.8/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.8/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.8/skills/incremental-implementation/SKILL.md +302 -0
- package/.versions/2.0.8/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.8/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/2.0.8/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.8/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.8/skills/planning-and-task-breakdown/SKILL.md +289 -0
- package/.versions/2.0.8/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.8/skills/spec-driven-development/SKILL.md +295 -0
- package/.versions/2.0.8/skills/using-agent-skills/SKILL.md +198 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/README.md +430 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
- package/.versions/2.0.8/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
- package/CHANGELOG.md +39 -0
- package/README.md +10 -9
- package/bin/catalog/harness-runtime-closure.json +23 -22
- package/bin/cli.js +24 -1
- package/bin/lib/apply.js +6 -2
- package/bin/lib/detect-agent.js +1 -1
- package/bin/lib/doctor.js +3 -3
- package/bin/lib/manifest.js +23 -16
- package/bin/lib/path-boundaries.js +96 -0
- package/bin/lib/personas.js +15 -2
- package/bin/lib/set-hermes-telegram.js +2 -2
- package/bin/lib/set-hermes-watchdog.js +1 -1
- package/bin/lib/state.js +5 -1
- package/bin/lib/verify.js +43 -5
- package/bin/snapshot-version.js +6 -6
- package/codex/fleet-session-client/SKILL.md +3 -3
- package/docs/ARCHITECTURE.md +29 -20
- package/docs/MIGRATION-agent-fleet.md +11 -7
- package/docs/agent-fleet-setup.md +9 -2
- package/docs/claude-code-coms-bridge.md +10 -9
- package/docs/codex-session-bridge.md +18 -18
- package/docs/coms-hermes-bridge.md +6 -6
- package/docs/hermes-watchdog-supervisor.md +1 -1
- package/docs/npm-install.md +30 -1
- package/docs/pi-extensions.md +6 -6
- package/docs/workflows.md +9 -5
- package/install-manifest.json +202 -97
- package/justfile +19 -19
- package/manifest-meta.json +50 -38
- package/package.json +26 -26
- package/references/observability-checklist.md +1 -0
- package/references/performance-checklist.md +83 -0
- package/references/prompting-patterns.md +1 -1
- package/references/security-checklist.md +85 -19
- package/references/testing-patterns.md +12 -13
- package/references/workflow-authoring.md +5 -5
- package/skills/code-review-and-quality/SKILL.md +17 -2
- package/skills/constraint-driven-development/SKILL.md +338 -0
- package/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/skills/context-engineering/SKILL.md +52 -2
- package/skills/deprecation-and-migration/SKILL.md +42 -1
- package/skills/designing-agents/SKILL.md +12 -12
- package/skills/drafting-workflows/SKILL.md +6 -6
- package/skills/drafting-workflows/scripts/make-workflow.ts +3 -3
- package/skills/frontend-ui-engineering/SKILL.md +2 -2
- package/skills/git-workflow-and-versioning/SKILL.md +1 -1
- package/skills/incremental-implementation/SKILL.md +13 -9
- package/skills/peer-coms/SKILL.md +4 -4
- package/skills/performance-optimization/SKILL.md +152 -6
- package/skills/planning-and-task-breakdown/SKILL.md +32 -8
- package/skills/security-and-hardening/SKILL.md +84 -21
- package/skills/spec-driven-development/SKILL.md +41 -2
- package/skills/using-agent-skills/SKILL.md +3 -2
- package/vendor/agent-skills-upstream/README.md +427 -8
- package/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +73 -0
- package/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +2 -2
- package/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
- package/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +49 -1
- package/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +4 -4
- package/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +1 -1
- package/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +12 -2
- package/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +3 -3
- package/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +1 -1
- package/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +1 -1
- package/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +9 -9
- package/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +36 -1
- package/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +151 -5
- package/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +32 -9
- package/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +64 -7
- package/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +26 -6
- package/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +23 -1
- package/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +42 -3
- package/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +18 -3
- package/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +3 -2
- package/scripts/lib/hermes-monitor-events.ts +0 -1
- package/scripts/lib/hermes-monitor-herdr.ts +0 -2
- package/scripts/lib/hermes-monitor-registry.ts +0 -2
- package/scripts/lib/hermes-monitor-socket.ts +0 -2
- package/scripts/lib/hermes-monitor-store.ts +0 -2
- /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-herdr/plugin.js +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-herdr/presentation.js +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-monitor/plugin.js +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-monitor/state.js +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/herdr_source.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/manifest.json +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/plugin_api.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/sessions.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/tasks.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/plugin.yaml +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/adapter.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/dist/index.js +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/manifest.json +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/plugin_api.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-liaison/SKILL.md +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/manifest.json +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_actions.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_contract.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_delivery.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_engine.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_judgment.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_recovery.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_state.py +0 -0
- /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_transport.py +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/fleet-codex-client.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/hermes-watchdog-capability-probe.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/lib/fake-herdr-server.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-catalog.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-operations.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-session.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-command.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/lib/flow-command.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/lib/flow-maintenance.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/package-lock.json +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/package.json +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/changes.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/debate.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/env.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/gates.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/git.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/merge.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/model-visibility.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/permissions.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/poll.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/quality.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/run.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/voices.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/writer-lease.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/tsconfig.json +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-build-test.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-debate.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-document.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-poll.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-quality.ts +0 -0
- /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-scout.ts +0 -0
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
// path-boundaries.js — the guard that makes a directory move finishable.
|
|
2
|
+
//
|
|
3
|
+
// Moving `scripts/`, `hermes/` and `hooks/` under `.pi/agent-fleet/` broke two
|
|
4
|
+
// classes of reference that nothing else in the repository was watching:
|
|
5
|
+
//
|
|
6
|
+
// 1. Relative import specifiers crossing the boundary. `.pi/harnesses/**`
|
|
7
|
+
// does not move and imports into the fleet runtime that does. Those
|
|
8
|
+
// imports are lazy — `just fleet` starts fine and the failure surfaces
|
|
9
|
+
// only when an operator runs `/debate` or spawns a peer. `tsc` cannot
|
|
10
|
+
// stand in for this: the harness packages are not installed at the
|
|
11
|
+
// repository root, so its resolution errors are all about npm packages.
|
|
12
|
+
//
|
|
13
|
+
// 2. Workspace paths written as text — in the justfile, in the catalogue, in
|
|
14
|
+
// agent-readable markdown. A stale path in a reference file never throws;
|
|
15
|
+
// it just teaches the next agent to write to `agents/` again, and the
|
|
16
|
+
// footprint grows back a session at a time.
|
|
17
|
+
//
|
|
18
|
+
// Both are pure functions over a file list so the test can state the rule and
|
|
19
|
+
// the CLI can reuse it.
|
|
20
|
+
|
|
21
|
+
import { existsSync, readFileSync } from "node:fs";
|
|
22
|
+
import { dirname, join, normalize, relative, resolve } from "node:path";
|
|
23
|
+
|
|
24
|
+
/** Directories that no longer exist at a workspace root. */
|
|
25
|
+
export const RETIRED_ROOTS = Object.freeze(["scripts", "hermes", "hooks"]);
|
|
26
|
+
|
|
27
|
+
/** Where each retired root lives now — used only for the failure message. */
|
|
28
|
+
export const MOVED_TO = Object.freeze({
|
|
29
|
+
scripts: ".pi/agent-fleet/scripts",
|
|
30
|
+
hermes: ".pi/agent-fleet/hermes",
|
|
31
|
+
hooks: ".pi/agent-fleet/hooks",
|
|
32
|
+
agents: ".pi/agents/personas",
|
|
33
|
+
});
|
|
34
|
+
|
|
35
|
+
const SPECIFIER = /(?:\bfrom|\bimport|\brequire)\s*\(?\s*["'](\.\.?\/[^"']+)["']|new URL\(\s*["'](\.\.?[^"']*)["']/g;
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* Relative specifiers in `source` that do not resolve to a file on disk.
|
|
39
|
+
*
|
|
40
|
+
* `.js` is accepted for a `.ts` file: that is the NodeNext spelling the
|
|
41
|
+
* harnesses already use, and Node strips types at runtime.
|
|
42
|
+
*/
|
|
43
|
+
export function unresolvedSpecifiers({ root, file, source }) {
|
|
44
|
+
const dir = dirname(join(root, file));
|
|
45
|
+
const out = [];
|
|
46
|
+
for (const match of source.matchAll(SPECIFIER)) {
|
|
47
|
+
const spec = match[1] ?? match[2];
|
|
48
|
+
const target = resolve(dir, spec);
|
|
49
|
+
if (existsSync(target)) continue;
|
|
50
|
+
if (target.endsWith(".js") && existsSync(`${target.slice(0, -3)}.ts`)) continue;
|
|
51
|
+
out.push({ file, specifier: spec, resolved: relative(root, target) });
|
|
52
|
+
}
|
|
53
|
+
return out;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/**
|
|
57
|
+
* Workspace-relative mentions of a retired root.
|
|
58
|
+
*
|
|
59
|
+
* Matched only at a path boundary, so a skill's own `scripts/` directory
|
|
60
|
+
* (`skills/drafting-workflows/scripts/`), `.claude/hooks/` and the npm scope
|
|
61
|
+
* `@hermes/plugin-sdk` are not hits.
|
|
62
|
+
*/
|
|
63
|
+
export function retiredRootMentions({ file, source, roots = RETIRED_ROOTS }) {
|
|
64
|
+
const pattern = new RegExp(String.raw`(^|[^A-Za-z0-9_./\-@])(${roots.join("|")})/`, "gm");
|
|
65
|
+
const out = [];
|
|
66
|
+
source.split("\n").forEach((line, index) => {
|
|
67
|
+
pattern.lastIndex = 0;
|
|
68
|
+
for (const match of line.matchAll(pattern)) {
|
|
69
|
+
out.push({ file, line: index + 1, root: match[2], text: line.trim().slice(0, 120) });
|
|
70
|
+
}
|
|
71
|
+
});
|
|
72
|
+
return out;
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/** Every `.md` file an item installs into a workspace, as repo-relative paths. */
|
|
76
|
+
export function installedMarkdown({ root, manifest, walk }) {
|
|
77
|
+
const files = new Set();
|
|
78
|
+
for (const item of manifest.items ?? []) {
|
|
79
|
+
for (const binding of Object.values(item.agents ?? {})) {
|
|
80
|
+
if (!binding.target) continue; // operator/external items install nothing
|
|
81
|
+
for (const rel of binding.source ?? []) {
|
|
82
|
+
const abs = join(root, rel);
|
|
83
|
+
if (!existsSync(abs)) continue;
|
|
84
|
+
if (rel.endsWith(".md")) { files.add(normalize(rel)); continue; }
|
|
85
|
+
for (const leaf of walk(abs)) {
|
|
86
|
+
if (leaf.endsWith(".md")) files.add(normalize(`${rel}/${leaf}`));
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
return [...files].sort();
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
export function readSource(root, file) {
|
|
95
|
+
return readFileSync(join(root, file), "utf8");
|
|
96
|
+
}
|
package/bin/lib/personas.js
CHANGED
|
@@ -1,7 +1,10 @@
|
|
|
1
1
|
// personas.js — the canonical persona catalogue.
|
|
2
2
|
//
|
|
3
3
|
// `agents/*.md` is written in pi's own frontmatter dialect, so installing a
|
|
4
|
-
// persona is a plain file copy: source and target carry identical bytes.
|
|
4
|
+
// persona is a plain file copy: source and target carry identical bytes. The
|
|
5
|
+
// package keeps its own personas in `agents/`; a workspace receives them under
|
|
6
|
+
// `.pi/agents/personas/` so the repository root stays clean (the YAML fleet
|
|
7
|
+
// configuration owns `.pi/agents/` itself, hence the subdirectory).
|
|
5
8
|
// There is no per-agent frontmatter translation any more — the `transform-persona`
|
|
6
9
|
// CLI subcommand and its mapping table went away with Claude Code as an
|
|
7
10
|
// install target (docs/claude-code-coms-bridge.md explains what remains).
|
|
@@ -13,7 +16,17 @@ import { join } from "node:path";
|
|
|
13
16
|
|
|
14
17
|
/** Install path for a persona, relative to the workspace root. */
|
|
15
18
|
export function targetRelPath(name) {
|
|
16
|
-
return join("agents", `${name}.md`);
|
|
19
|
+
return join(".pi", "agents", "personas", `${name}.md`);
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
/**
|
|
23
|
+
* Where the installer used to write this persona. Declared on every persona
|
|
24
|
+
* binding so `verify` reports a surviving `agents/<name>.md` instead of letting
|
|
25
|
+
* `scanAgentDirs` silently prefer it over the installed copy — it scans
|
|
26
|
+
* `agents/` first and keeps the first definition per name.
|
|
27
|
+
*/
|
|
28
|
+
export function legacyTargetRelPaths(name) {
|
|
29
|
+
return [join("agents", `${name}.md`)];
|
|
17
30
|
}
|
|
18
31
|
|
|
19
32
|
/**
|
|
@@ -164,7 +164,7 @@ async function resolveHermesProfile(requestedProfile, hermes) {
|
|
|
164
164
|
export async function inspectHermesTelegram(options) {
|
|
165
165
|
const hermes = options.hermes ?? (async (args) => runHermesCommand(args));
|
|
166
166
|
const resolvedProfile = await resolveHermesProfile(options.profile, hermes);
|
|
167
|
-
const sourceDir = options.skillSourceDir ?? join(options.packageRoot, "hermes", "skills", LIAISON_SKILL);
|
|
167
|
+
const sourceDir = options.skillSourceDir ?? join(options.packageRoot, ".pi", "agent-fleet", "hermes", "skills", LIAISON_SKILL);
|
|
168
168
|
const installedDir = join(resolvedProfile.profilePath, "skills", LIAISON_SKILL);
|
|
169
169
|
const skill = skillState(sourceDir, installedDir);
|
|
170
170
|
const [skillsOutput, toolsOutput] = await Promise.all([
|
|
@@ -299,7 +299,7 @@ async function controlBridge(options, parsed) {
|
|
|
299
299
|
await herdr(["pane", "rename", paneId, BRIDGE_LABEL]);
|
|
300
300
|
const command = [
|
|
301
301
|
shellQuote(process.execPath), "--experimental-strip-types",
|
|
302
|
-
shellQuote(join(options.packageRoot, "scripts", "coms-hermes-bridge.ts")),
|
|
302
|
+
shellQuote(join(options.packageRoot, ".pi", "agent-fleet", "scripts", "coms-hermes-bridge.ts")),
|
|
303
303
|
"--project", shellQuote(project), "--hermes-profile", shellQuote(hermesProfile),
|
|
304
304
|
"--timeout", "1800000", "--to", shellQuote(parsed.target),
|
|
305
305
|
].join(" ");
|
|
@@ -60,7 +60,7 @@ function receiptState(receipt, installedFingerprint) {
|
|
|
60
60
|
/** Read-only inspection: two Hermes reads, no profile, service, or tool mutation. */
|
|
61
61
|
export async function inspectHermesWatchdog(options) {
|
|
62
62
|
const resolved = await resolveHermesProfile(options.profile, options.hermes);
|
|
63
|
-
const sourceDir = options.skillSourceDir ?? join(options.packageRoot, "hermes", "skills", NAME);
|
|
63
|
+
const sourceDir = options.skillSourceDir ?? join(options.packageRoot, ".pi", "agent-fleet", "hermes", "skills", NAME);
|
|
64
64
|
const installedDir = join(resolved.profilePath, "skills", NAME);
|
|
65
65
|
const receipt = join(resolved.profilePath, "agent-fleet", `${NAME}.receipt.json`);
|
|
66
66
|
const skill = artifactState(sourceDir, installedDir);
|
package/bin/lib/state.js
CHANGED
|
@@ -18,7 +18,11 @@ import { createHash } from "node:crypto";
|
|
|
18
18
|
import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, lstatSync, realpathSync } from "node:fs";
|
|
19
19
|
import { dirname, join, relative, resolve, sep } from "node:path";
|
|
20
20
|
|
|
21
|
-
|
|
21
|
+
// 2 — the .pi/agent-fleet relocation. The file's shape did not change; the
|
|
22
|
+
// paths recorded in it did, and a workspace still reading 1 is one whose
|
|
23
|
+
// `scripts/`, `hermes/`, `hooks/` and `agents/` copies have not been retired
|
|
24
|
+
// yet. `verify` says so, and the next `setup` re-stamps this on the way out.
|
|
25
|
+
export const STATE_SCHEMA_VERSION = 2;
|
|
22
26
|
export const STATE_REL_PATH = join(".ai", "agent-fleet-state.json");
|
|
23
27
|
export const LEGACY_RECORD_REL_PATH = join(".ai", "agent-fleet-setup.md");
|
|
24
28
|
|
package/bin/lib/verify.js
CHANGED
|
@@ -41,6 +41,9 @@ export const BROKEN_STATES = new Set(["missing", "broken-link", "foreign-link",
|
|
|
41
41
|
// but they never fail the run — a workspace installed before `.versions/`
|
|
42
42
|
// retention, or one carrying a hand-edited overrides file, is not broken.
|
|
43
43
|
export const ADVISORY_FINDINGS = new Set([
|
|
44
|
+
// A relocation is a normal upgrade, not a broken install: the next setup
|
|
45
|
+
// cleans it up, and the item states already carry the severity.
|
|
46
|
+
"relocated-artifacts",
|
|
44
47
|
"base-snapshot-missing",
|
|
45
48
|
"source-root-volatile",
|
|
46
49
|
"symlink-retired",
|
|
@@ -105,7 +108,7 @@ export async function runVerify({
|
|
|
105
108
|
type: "state-schema",
|
|
106
109
|
path: STATE_REL_PATH,
|
|
107
110
|
issue: `state schemaVersion ${state.schemaVersion}, this build speaks ${STATE_SCHEMA_VERSION}`,
|
|
108
|
-
fix: "
|
|
111
|
+
fix: "run `agent-fleet setup` to reconcile the workspace and re-stamp the state file",
|
|
109
112
|
});
|
|
110
113
|
}
|
|
111
114
|
if (state?.sourceRoot && !existsSync(state.sourceRoot)) {
|
|
@@ -154,6 +157,25 @@ export async function runVerify({
|
|
|
154
157
|
});
|
|
155
158
|
}
|
|
156
159
|
|
|
160
|
+
// One relocation finding for the whole pass. A release that moves a tree
|
|
161
|
+
// produces an obsolete path per file — ninety of them for the .pi/agent-fleet
|
|
162
|
+
// move — and ninety findings is noise, not a report. The per-item lists stay
|
|
163
|
+
// in `items[].obsoleteFiles` for anything that wants to expand them.
|
|
164
|
+
const relocated = items.filter((entry) => (entry.obsoleteFiles ?? []).length > 0);
|
|
165
|
+
if (relocated.length > 0) {
|
|
166
|
+
const all = relocated.flatMap((entry) => entry.obsoleteFiles);
|
|
167
|
+
const kept = all.filter((file) => file.retained).length;
|
|
168
|
+
findings.push({
|
|
169
|
+
type: "relocated-artifacts",
|
|
170
|
+
path: STATE_REL_PATH,
|
|
171
|
+
issue: `${relocated.length} item(s) moved: ${all.length - kept} old file(s) to remove` +
|
|
172
|
+
(kept > 0 ? `, ${kept} kept (locally modified)` : "") +
|
|
173
|
+
` — ${relocated.map((entry) => entry.id).slice(0, 3).join(", ")}` +
|
|
174
|
+
(relocated.length > 3 ? `, +${relocated.length - 3} more` : ""),
|
|
175
|
+
fix: "re-run setup to retire them (edited files are preserved); `verify --json` lists every path under items[].obsoleteFiles",
|
|
176
|
+
});
|
|
177
|
+
}
|
|
178
|
+
|
|
157
179
|
for (const entry of items) {
|
|
158
180
|
for (const rel of entry.legacyTargets ?? []) {
|
|
159
181
|
findings.push({
|
|
@@ -331,9 +353,15 @@ function evaluateItem({ item, binding, workspace, sourceRoot, baseRoot, recorded
|
|
|
331
353
|
if (recorded?.method === "symlink" || !pair.isDir) expectedPaths.add(pair.targetRel);
|
|
332
354
|
else for (const rel of walkTree(pair.sourceAbs)) expectedPaths.add(`${pair.targetRel}/${rel}`);
|
|
333
355
|
}
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
356
|
+
// `retained` mirrors apply()'s ownership rule: a byte-identical copy is ours
|
|
357
|
+
// to retire, an edited one becomes the user's and is left alone. Deciding it
|
|
358
|
+
// here means `verify` can say how many of the old paths will actually go.
|
|
359
|
+
const obsoleteFiles = (recorded?.files ?? [])
|
|
360
|
+
.filter((file) => !expectedPaths.has(file.path) && inspectPath(join(workspace, file.path)).kind !== "absent")
|
|
361
|
+
.map((file) => ({
|
|
362
|
+
path: file.path,
|
|
363
|
+
retained: Boolean(file.sha256) && hashFile(join(workspace, file.path)) !== file.sha256,
|
|
364
|
+
}));
|
|
337
365
|
|
|
338
366
|
const recordedHashes = new Map((recorded?.files ?? []).map((f) => [f.path, f.sha256]));
|
|
339
367
|
const agent = agentOf(item, binding);
|
|
@@ -384,6 +412,16 @@ function evaluateItem({ item, binding, workspace, sourceRoot, baseRoot, recorded
|
|
|
384
412
|
recorded: recordedHashes.get(pair.targetRel) ?? null,
|
|
385
413
|
})];
|
|
386
414
|
|
|
415
|
+
// A directory target can exist because a *different* item writes inside it
|
|
416
|
+
// — `.pi/agents/` holds both the fleet YAML and the installed personas. An
|
|
417
|
+
// item we never installed, none of whose leaves are present, is absent, not
|
|
418
|
+
// half-broken; only a recorded item can go missing.
|
|
419
|
+
const allLeavesMissing = files.length > 0 && files.every((f) => f.state === "missing");
|
|
420
|
+
if (pair.isDir && !recorded && allLeavesMissing) {
|
|
421
|
+
results.push({ state: "absent" });
|
|
422
|
+
continue;
|
|
423
|
+
}
|
|
424
|
+
|
|
387
425
|
results.push({ state: worstOf(files.map((f) => f.state)) ?? "up-to-date", fileCount: files.length });
|
|
388
426
|
changed.push(...files.filter((f) => f.state !== "up-to-date"));
|
|
389
427
|
}
|
|
@@ -408,7 +446,7 @@ function evaluateItem({ item, binding, workspace, sourceRoot, baseRoot, recorded
|
|
|
408
446
|
changedCount: changed.length + obsoleteFiles.length,
|
|
409
447
|
};
|
|
410
448
|
if (obsoleteFiles.length > 0) {
|
|
411
|
-
out.obsoleteFiles = obsoleteFiles.map((file) => ({ path: file.path }));
|
|
449
|
+
out.obsoleteFiles = obsoleteFiles.map((file) => ({ path: file.path, retained: file.retained }));
|
|
412
450
|
out.detail = `${obsoleteFiles.length} previously managed path(s) are no longer in the current binding`;
|
|
413
451
|
}
|
|
414
452
|
// A path this item used to install to that is still occupied. The runtime
|
package/bin/snapshot-version.js
CHANGED
|
@@ -28,17 +28,17 @@ const ARTIFACT_PATHS = [
|
|
|
28
28
|
"vendor/agent-skills-upstream",
|
|
29
29
|
"agents",
|
|
30
30
|
"codex",
|
|
31
|
-
"hermes",
|
|
31
|
+
".pi/agent-fleet/hermes",
|
|
32
32
|
".pi/prompts",
|
|
33
33
|
".pi/extensions",
|
|
34
34
|
".pi/harnesses",
|
|
35
35
|
".pi/skills",
|
|
36
36
|
".pi/agents",
|
|
37
37
|
".pi/damage-control-rules.yaml",
|
|
38
|
-
// scripts/ ships runtime helpers like team-up.ts that the
|
|
39
|
-
// recipes shell out to. Test files stay out (filtered below) —
|
|
40
|
-
// dev-only.
|
|
41
|
-
"scripts",
|
|
38
|
+
// .pi/agent-fleet/scripts/ ships runtime helpers like team-up.ts that the
|
|
39
|
+
// pi harness recipes shell out to. Test files stay out (filtered below) —
|
|
40
|
+
// they're dev-only.
|
|
41
|
+
".pi/agent-fleet/scripts",
|
|
42
42
|
// justfile carries the pi harness launch recipes. It is a companion of the
|
|
43
43
|
// harness group in the deterministic installer, so the snapshot must hold a
|
|
44
44
|
// per-version copy for the upgrade three-way diff (retired-harness recipes
|
|
@@ -57,7 +57,7 @@ const ARTIFACT_PATHS = [
|
|
|
57
57
|
"docs/getting-started.md",
|
|
58
58
|
"docs/pi-setup.md",
|
|
59
59
|
"references",
|
|
60
|
-
"hooks",
|
|
60
|
+
".pi/agent-fleet/hooks",
|
|
61
61
|
// The generated catalogue. The upgrade three-way merge needs the *recorded
|
|
62
62
|
// version's* manifest, not just its files: an item that existed then and is
|
|
63
63
|
// retired now is only resolvable from the base catalogue.
|
|
@@ -5,14 +5,14 @@ description: Connect a ChatGPT Desktop or Android conversation to an existing Ag
|
|
|
5
5
|
|
|
6
6
|
# Fleet session client
|
|
7
7
|
|
|
8
|
-
Use the installed
|
|
8
|
+
Use the installed `.pi/agent-fleet/scripts/fleet-codex-client.ts` from the workspace root, or its absolute path in an Agent Fleet checkout. Read `docs/codex-session-bridge.md` there for troubleshooting. Requires Node 22.18+ and Python 3.10+, with access to the same local user's existing Pi/herdr sockets. Android supplies human messages through the same ChatGPT conversation; tools execute on its connected desktop host.
|
|
9
9
|
|
|
10
10
|
## Workflow
|
|
11
11
|
|
|
12
|
-
- Start with `node scripts/fleet-codex-client.ts --help` for the versioned JSON operation contract. Use `describe` for current per-operation availability and reasons. Both describe supported parameters, remote/local effects and limits; `describe` uses read-only probes and does not update observations or receipts. Availability is a point-in-time prerequisite check, not authorization or guaranteed future acceptance.
|
|
12
|
+
- Start with `node .pi/agent-fleet/scripts/fleet-codex-client.ts --help` for the versioned JSON operation contract. Use `describe` for current per-operation availability and reasons. Both describe supported parameters, remote/local effects and limits; `describe` uses read-only probes and does not update observations or receipts. Availability is a point-in-time prerequisite check, not authorization or guaranteed future acceptance.
|
|
13
13
|
- Fleet/Hub commands remain documented in the workspace `.pi/harnesses/agent-hub/README.md`, `docs/agents.md` and the repository README. Consult those sources when available; do not maintain another copied slash-command list or assume `send` executes Hub slash commands.
|
|
14
14
|
|
|
15
|
-
- Discover with `node scripts/fleet-codex-client.ts sessions --project <project>`. Resolve ambiguous project/peer choices with the user; never select only by cwd. Select explicitly with `select --project <project> --peer <peer>`.
|
|
15
|
+
- Discover with `node .pi/agent-fleet/scripts/fleet-codex-client.ts sessions --project <project>`. Resolve ambiguous project/peer choices with the user; never select only by cwd. Select explicitly with `select --project <project> --peer <peer>`.
|
|
16
16
|
- Keep `CODEX_THREAD_ID` supplied by the execution environment. Never fabricate or override it. `status` shows selected identity, registry freshness and a separate `questionState`; `summary` reads current sources. Presence alone does not mean working or done.
|
|
17
17
|
- For a human-authorized instruction, write its exact text to a private temporary file. Use `send --id <unique-id> --text-file <path> --wait-ms 1000`. Reuse that same ID after an uncertain tool outcome; a new ID means a new instruction. Never resend automatically under another ID. Remove the temporary text file afterward.
|
|
18
18
|
- `submitted`/`queued` mean accepted as a Pi follow-up. They do not prove final completion or immediate steering of the active child. `result` is a correlated coms reply. `unknown` requires source inspection, never an automatic retry. Pi retains budgets, permissions and orchestration.
|
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -9,16 +9,16 @@ the runtime responsibilities and where each module lives in the repository.
|
|
|
9
9
|
| --- | --- | --- |
|
|
10
10
|
| **Pi Coding Agent** | Primary local runtime — runs the dispatcher and specialist subagents | `.pi/harnesses/`, `.pi/extensions/`, `.pi/agents/`, `.pi/prompts/` |
|
|
11
11
|
| **agent-hub** | Thin-context multi-agent harness: dispatcher + specialists + research helpers + Verification Contract | `.pi/harnesses/agent-hub/` |
|
|
12
|
-
| **Workflows** | Headless, code-owned phase order, retries, gates, writes enforcement, and acceptance through `just flow` |
|
|
13
|
-
| **Herdr** | Fleet/workspace control plane — spawns peer teams as tiled workspaces, presence via push events, snapshot/resume | [herdr.dev](https://herdr.dev); client in `.pi/harnesses/lib/herdr-client.ts`, layout in
|
|
14
|
-
| **coms** | Peer communication protocol/data plane — envelope-based P2P messaging between agents | Shared peer lifecycle in `.pi/harnesses/lib/coms-core.ts` and `coms-core-io.ts`; Pi registrations in `.pi/harnesses/coms/` and `agent-hub/`; wire helpers in
|
|
15
|
-
| **Claude Code bridge** | Makes an interactive Claude Code pane a bidirectional coms peer |
|
|
16
|
-
| **Hermes bridge** | Remote human control — relays hub questions to Telegram, races phone vs. local answers, conductor/liaison skills |
|
|
17
|
-
| **Hermes local monitor transport** | Local, authenticated monitor contract for Hub-owned task generations; consumers supply their own presentation | `.pi/harnesses/agent-hub/monitor-*.ts`, `.pi/harnesses/lib/hermes-monitor-{model,store,registry,socket}.ts` (with compatibility re-exports under
|
|
18
|
-
| **Hermes Desktop plugin** (`agent-fleet-herdr`) | Fleet observability surface — read-only panel of every live session joined from the coms registry, herdr presence, agent transcripts, and the monitor transport; `focus` and subagent `cancel` are its only write doors |
|
|
19
|
-
| **ChatGPT Fleet session client** | Experimental ChatGPT-initiated client for an existing Pi session; no daemon or idle wake |
|
|
12
|
+
| **Workflows** | Headless, code-owned phase order, retries, gates, writes enforcement, and acceptance through `just flow` | `.pi/agent-fleet/scripts/flow.ts`, `.pi/agent-fleet/scripts/workflows/` — see [workflows.md](workflows.md) |
|
|
13
|
+
| **Herdr** | Fleet/workspace control plane — spawns peer teams as tiled workspaces, presence via push events, snapshot/resume | [herdr.dev](https://herdr.dev); client in `.pi/harnesses/lib/herdr-client.ts`, layout in `.pi/agent-fleet/scripts/lib/herdr-layout.ts` |
|
|
14
|
+
| **coms** | Peer communication protocol/data plane — envelope-based P2P messaging between agents | Shared peer lifecycle in `.pi/harnesses/lib/coms-core.ts` and `coms-core-io.ts`; Pi registrations in `.pi/harnesses/coms/` and `agent-hub/`; wire helpers in `.pi/agent-fleet/scripts/lib/coms-envelope.ts` and `.pi/agent-fleet/scripts/coms-cli.ts` |
|
|
15
|
+
| **Claude Code bridge** | Makes an interactive Claude Code pane a bidirectional coms peer | `.pi/agent-fleet/scripts/coms-claude-bridge.ts`, `.pi/agent-fleet/hooks/coms-stop-hook.mjs`, `skills/peer-coms/` — see [claude-code-coms-bridge.md](claude-code-coms-bridge.md) |
|
|
16
|
+
| **Hermes bridge** | Remote human control — relays hub questions to Telegram, races phone vs. local answers, conductor/liaison skills | `.pi/agent-fleet/scripts/coms-hermes-bridge.ts`, `.pi/harnesses/ask-user-remote/`, `.pi/agent-fleet/hermes/skills/` — see [coms-hermes-bridge.md](coms-hermes-bridge.md) |
|
|
17
|
+
| **Hermes local monitor transport** | Local, authenticated monitor contract for Hub-owned task generations; consumers supply their own presentation | `.pi/harnesses/agent-hub/monitor-*.ts`, `.pi/harnesses/lib/hermes-monitor-{model,store,registry,socket}.ts` (with compatibility re-exports under `.pi/agent-fleet/scripts/lib/`) — see [Hermes artifacts](../.pi/agent-fleet/hermes/README.md#local-agent-hub-monitor-integration) and [watchdog limits](hermes-watchdog-supervisor.md) |
|
|
18
|
+
| **Hermes Desktop plugin** (`agent-fleet-herdr`) | Fleet observability surface — read-only panel of every live session joined from the coms registry, herdr presence, agent transcripts, and the monitor transport; `focus` and subagent `cancel` are its only write doors | `.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/` (Electron pane), `.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/` (FastAPI backend), installed by `.pi/agent-fleet/scripts/install-hermes-plugin.sh` — see [hermes-desktop-plugins.md](hermes-desktop-plugins.md) |
|
|
19
|
+
| **ChatGPT Fleet session client** | Experimental ChatGPT-initiated client for an existing Pi session; no daemon or idle wake | `.pi/agent-fleet/scripts/fleet-codex-client.ts`, `.pi/agent-fleet/scripts/lib/fleet-codex-*`, opt-in feature `chatgpt-client` — see [codex-session-bridge.md](codex-session-bridge.md) |
|
|
20
20
|
| **Skill library** | Lifecycle workflows and quality gates every agent follows | `skills/` (native) + `vendor/agent-skills-upstream/skills/` (vendored) — see [UPSTREAM-SKILLS.md](UPSTREAM-SKILLS.md) |
|
|
21
|
-
| **Personas** | Reusable specialist definitions, installed verbatim | `agents
|
|
21
|
+
| **Personas** | Reusable specialist definitions, installed verbatim | `agents/` in the package → `.pi/agents/personas/` in a workspace; `bin/lib/personas.js` |
|
|
22
22
|
|
|
23
23
|
## One Hub runtime, independent axes
|
|
24
24
|
|
|
@@ -118,7 +118,7 @@ flowchart TD
|
|
|
118
118
|
Hub -.->|"one status line: Assertions: 2✓ 1○ 1✗"| You
|
|
119
119
|
```
|
|
120
120
|
|
|
121
|
-
Every specialist session is one persona from [`agents/`](../agents/) — *skills* tell each agent **how** to work; *personas* define **who** they are (see [agents.md](agents.md)).
|
|
121
|
+
Every specialist session is one persona from [`agents/`](../agents/) (installed to `.pi/agents/personas/`) — *skills* tell each agent **how** to work; *personas* define **who** they are (see [agents.md](agents.md)).
|
|
122
122
|
|
|
123
123
|
The same idea as a tree:
|
|
124
124
|
|
|
@@ -297,20 +297,29 @@ Cross-harness coms lifecycle remains shared in `.pi/harnesses/lib/coms-core.ts`
|
|
|
297
297
|
|
|
298
298
|
```text
|
|
299
299
|
.pi/ # Pi runtime: harnesses, extensions, agents config, prompts
|
|
300
|
+
.pi/agent-fleet/ # The fleet runtime, mirrored verbatim into a workspace:
|
|
301
|
+
scripts/ # CLI helpers, bridges, team + one-off peer launchers (pure logic in scripts/lib/)
|
|
302
|
+
scripts/workflows/ # deterministic flow graphs + phase/gate/permission/quality runtime
|
|
303
|
+
hermes/ # Hermes-facing skills/integration assets
|
|
304
|
+
hooks/ # the coms bridge Stop hook
|
|
305
|
+
docs/ # the one doc that installs into a workspace (workflows.md)
|
|
300
306
|
skills/ # Agent Fleet-native skills (shadow vendored names)
|
|
301
|
-
agents/ # Personas/subagents
|
|
302
|
-
scripts/ # CLI helpers, bridges, team + one-off peer launchers (pure logic in scripts/lib/)
|
|
303
|
-
scripts/workflows/ # deterministic flow graphs + phase/gate/permission/quality runtime
|
|
304
|
-
hermes/ # Hermes-facing skills/integration assets
|
|
307
|
+
agents/ # Personas/subagents; installed to a workspace's .pi/agents/personas/
|
|
305
308
|
codex/ # Canonical Codex conductor contract (runtime copy lives outside checkout)
|
|
306
309
|
systemd/user/ # Owned user-unit template for Codex remote control
|
|
307
310
|
vendor/agent-skills-upstream/ # Manually imported upstream skills (pinned SHA)
|
|
308
311
|
bin/ # npm CLI: init/update/doctor + the installer engine
|
|
309
|
-
hooks/ # The coms bridge Stop hook
|
|
310
312
|
references/ # Supplementary checklists, installed with the skills that cite them
|
|
311
313
|
docs/ # This file, setup guides, bridge references, vendoring policy
|
|
312
314
|
```
|
|
313
315
|
|
|
316
|
+
The fleet runtime keeps its *source* layout identical to its *installed* layout.
|
|
317
|
+
That is not cosmetic: `companion:harness-runtime-closure` and its siblings copy
|
|
318
|
+
with `preserveLayout`, so a relative import written here resolves the same way in
|
|
319
|
+
a workspace — including the ones reaching from the stationary `.pi/harnesses/`
|
|
320
|
+
into the movable `.pi/agent-fleet/scripts/`. `bin/test/path-boundaries.test.js`
|
|
321
|
+
holds that invariant.
|
|
322
|
+
|
|
314
323
|
Reserved for future modules (do not repurpose these paths):
|
|
315
324
|
|
|
316
325
|
```text
|
|
@@ -377,8 +386,8 @@ packages/hermes-bridge/ # future Hermes integration package
|
|
|
377
386
|
tests are not proof of a durable external identity or live delivery contract. `invoke`, where
|
|
378
387
|
available, is Hub-owned and queues dispatcher work rather than exposing tools directly.
|
|
379
388
|
- **Packaged Hermes source is opt-in, never auto-installed.** The npm tarball carries the
|
|
380
|
-
`hub-watchdog` skill (
|
|
381
|
-
(
|
|
389
|
+
`hub-watchdog` skill (`.pi/agent-fleet/hermes/skills/`) plus the backend and Desktop monitor plugin source
|
|
390
|
+
(`.pi/agent-fleet/hermes/plugins/`, `.pi/agent-fleet/hermes/desktop-plugins/`) as runtime-only source. Shipping that source
|
|
382
391
|
makes it available to an operator; installing it into a Hermes profile is always an explicit
|
|
383
392
|
action through `agent-fleet set-hermes-watchdog` (skill) or the consumer's own flow (plugins).
|
|
384
393
|
Nothing is enabled, launched, or configured by installing the package.
|
|
@@ -402,6 +411,6 @@ packages/hermes-bridge/ # future Hermes integration package
|
|
|
402
411
|
Agent Fleet began as a fork of `addyosmani/agent-skills` and was split into a
|
|
403
412
|
standalone repository in July 2026, with upstream demoted to vendored content.
|
|
404
413
|
The one-time migration record, including the history-filtering commands, lives
|
|
405
|
-
in [MIGRATION-agent-fleet.md](MIGRATION-agent-fleet.md)
|
|
406
|
-
requirements that drove the split are
|
|
407
|
-
|
|
414
|
+
in [MIGRATION-agent-fleet.md](MIGRATION-agent-fleet.md). The product
|
|
415
|
+
requirements that drove the split were a one-off planning document and are no
|
|
416
|
+
longer maintained.
|
|
@@ -111,12 +111,14 @@ is never asked for. References moved from `.claude/references/` to
|
|
|
111
111
|
brings `security-checklist.md` and `performance-checklist.md` with it, and
|
|
112
112
|
uninstall refuses to strand a skill without its checklists. A new `coms-bridge`
|
|
113
113
|
manifest group holds `skill:peer-coms` and its companion `hook:coms-stop-hook`;
|
|
114
|
-
the hook
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
114
|
+
the hook installs under the **pi** agent like everything else — 2.0 wrote it to
|
|
115
|
+
`.claude/hooks/`, and the runtime relocation moved it to
|
|
116
|
+
`.pi/agent-fleet/hooks/coms-stop-hook.mjs`, which `setup` reconciles for you.
|
|
117
|
+
Registering it in `.claude/settings.json` remains a manual step — see
|
|
118
|
+
[claude-code-coms-bridge.md](claude-code-coms-bridge.md).
|
|
119
|
+
|
|
120
|
+
**Unchanged:** the bridge itself — `.pi/agent-fleet/scripts/coms-claude-bridge.ts`,
|
|
121
|
+
`.pi/agent-fleet/scripts/lib/claude-bridge-core.ts`, `skills/peer-coms/`, the `_claude-peer`
|
|
120
122
|
recipe, `runner: claude-code` peers in `.pi/agents/peers.yaml`, and the
|
|
121
123
|
`dispatch-policy.yaml` routing that lets a bridged pane serve a team member's
|
|
122
124
|
dispatch. Cross-model review through a standing Claude session works as before.
|
|
@@ -136,7 +138,9 @@ just fleet deps
|
|
|
136
138
|
just fleet doctor
|
|
137
139
|
|
|
138
140
|
# 3. Remove the orphaned Claude Code install by hand, after reviewing it.
|
|
139
|
-
#
|
|
141
|
+
# The coms-bridge Stop hook now lives in .pi/agent-fleet/hooks/, so a
|
|
142
|
+
# leftover .claude/hooks/coms-stop-hook.mjs is safe to drop once
|
|
143
|
+
# .claude/settings.json points at the new path.
|
|
140
144
|
rm -rf .claude/commands .claude/skills .claude/agents .claude/references
|
|
141
145
|
rm -f .claude/orchestrate-teams.yaml
|
|
142
146
|
rm -rf .claude-plugin
|
|
@@ -358,8 +358,15 @@ bridge — the one way Claude Code takes part in a fleet. See
|
|
|
358
358
|
|
|
359
359
|
Installing `skill:peer-coms` pulls `hook:coms-stop-hook` in as a companion, which
|
|
360
360
|
is what gives a bridged pane exact turn text instead of scraped output.
|
|
361
|
-
|
|
362
|
-
|
|
361
|
+
The hook installs to `.pi/agent-fleet/hooks/coms-stop-hook.mjs` with the rest
|
|
362
|
+
of the fleet runtime. Registering it in `.claude/settings.json` stays the
|
|
363
|
+
user's step — the installer writes files, and another tool's settings file is
|
|
364
|
+
not its to merge. `setup` prints this snippet when the hook is applied:
|
|
365
|
+
|
|
366
|
+
```json
|
|
367
|
+
{ "hooks": { "Stop": [{ "hooks": [{ "type": "command",
|
|
368
|
+
"command": "node $CLAUDE_PROJECT_DIR/.pi/agent-fleet/hooks/coms-stop-hook.mjs" }] }] } }
|
|
369
|
+
```
|
|
363
370
|
|
|
364
371
|
## Templates
|
|
365
372
|
|
|
@@ -24,9 +24,9 @@ Claude Code ── Bash: coms-cli send/await ──▶ any pi peer (o
|
|
|
24
24
|
|
|
25
25
|
| Piece | File | Role |
|
|
26
26
|
|---|---|---|
|
|
27
|
-
| Bridge daemon |
|
|
28
|
-
| Envelope CLI |
|
|
29
|
-
| Stop hook |
|
|
27
|
+
| Bridge daemon | `.pi/agent-fleet/scripts/coms-claude-bridge.ts` | One per Claude pane. Registers coms peer `<name>`, serializes inbound prompts, types them into the pane (+ Enter separately — TUI quirk), captures the reply, sends the response envelope. |
|
|
28
|
+
| Envelope CLI | `.pi/agent-fleet/scripts/coms-cli.ts` | `list` / `send` / `await` / `reply` — any process becomes a coms participant. `send --await` is a blocking round trip; plain `send` prints a `msg_id` and a detached waiter holds the reply for `await`. |
|
|
29
|
+
| Stop hook | `.pi/agent-fleet/hooks/coms-stop-hook.mjs` | PRIMARY completion path: writes each turn's final assistant message to `~/.pi/coms/claude-bridge/<pane>/last-message.json` (keyed by `HERDR_PANE_ID`). Exact text, no scraping. |
|
|
30
30
|
| Skill | `skills/peer-coms/SKILL.md` | Teaches Claude Code its peer role: discover with `coms-cli list`, ask with `send --await`, answer inbound prompts normally, never drive panes itself. |
|
|
31
31
|
| Runner | `runner: claude-code` in `.pi/agents/peers.yaml` | `just fleet team` spawns the Claude CLI + its bridge in one pane (`_claude-peer` internally); `model:` maps to `claude --model`, and `just fleet resume` maps the Herdr-captured session id to `claude --resume`. |
|
|
32
32
|
|
|
@@ -35,8 +35,9 @@ Claude Code ── Bash: coms-cli send/await ──▶ any pi peer (o
|
|
|
35
35
|
The stable `claude-bridge` setup feature selects `peer-coms` and its
|
|
36
36
|
`coms-stop-hook` companion. Use `agent-fleet setup --preset default --features
|
|
37
37
|
claude-bridge --yes` (or select it interactively); it puts both halves in place:
|
|
38
|
-
`.pi/skills/peer-coms/` and `.
|
|
39
|
-
|
|
38
|
+
`.pi/skills/peer-coms/` and `.pi/agent-fleet/hooks/coms-stop-hook.mjs`. The hook ships with
|
|
39
|
+
the rest of the fleet runtime; Claude Code reaches it through `.claude/settings.json`,
|
|
40
|
+
which is the one place it looks for hooks.
|
|
40
41
|
|
|
41
42
|
**Registering the hook stays a manual step.** The installer writes the file; it does not
|
|
42
43
|
touch `.claude/settings.json`, because that file is the user's own Claude Code
|
|
@@ -48,7 +49,7 @@ configuration and merging into it is not something a pi install should decide.
|
|
|
48
49
|
{
|
|
49
50
|
"hooks": {
|
|
50
51
|
"Stop": [{ "hooks": [{ "type": "command",
|
|
51
|
-
"command": "node /
|
|
52
|
+
"command": "node $CLAUDE_PROJECT_DIR/.pi/agent-fleet/hooks/coms-stop-hook.mjs" }] }]
|
|
52
53
|
}
|
|
53
54
|
}
|
|
54
55
|
```
|
|
@@ -65,7 +66,7 @@ configuration and merging into it is not something a pi install should decide.
|
|
|
65
66
|
`just fleet team <team> --no-hub`, or attach a bridge to an existing Herdr Claude pane:
|
|
66
67
|
|
|
67
68
|
```bash
|
|
68
|
-
node --experimental-strip-types scripts/coms-claude-bridge.ts --name claude-main
|
|
69
|
+
node --experimental-strip-types .pi/agent-fleet/scripts/coms-claude-bridge.ts --name claude-main
|
|
69
70
|
# (inside the pane: HERDR_PANE_ID is inherited; or pass --pane <id>)
|
|
70
71
|
```
|
|
71
72
|
|
|
@@ -76,14 +77,14 @@ just fleet team docs --no-hub # Pi peers up
|
|
|
76
77
|
# pane with: bridge (claude-main) + claude
|
|
77
78
|
just fleet hub # in another pane: the orchestrator
|
|
78
79
|
# from the hub (or any shell):
|
|
79
|
-
node --experimental-strip-types scripts/coms-cli.ts send claude-main \
|
|
80
|
+
node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts send claude-main \
|
|
80
81
|
"Summarize the failing test output in artifacts/test.log" --await --timeout 300000
|
|
81
82
|
```
|
|
82
83
|
|
|
83
84
|
And the reverse — Claude Code, mid-task, asking a pi peer:
|
|
84
85
|
|
|
85
86
|
```bash
|
|
86
|
-
node --experimental-strip-types scripts/coms-cli.ts send researcher \
|
|
87
|
+
node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts send researcher \
|
|
87
88
|
"Where is the retry logic for webhooks? file:line" --await --timeout 300000
|
|
88
89
|
```
|
|
89
90
|
|
|
@@ -29,17 +29,17 @@ Remove `chatgpt-client` from the workspace's desired features as well if it was
|
|
|
29
29
|
Run commands from the workspace root, or use an absolute client path:
|
|
30
30
|
|
|
31
31
|
```sh
|
|
32
|
-
node scripts/fleet-codex-client.ts doctor
|
|
33
|
-
node scripts/fleet-codex-client.ts sessions --project af
|
|
34
|
-
node scripts/fleet-codex-client.ts select --project af --peer orchestrator
|
|
35
|
-
node scripts/fleet-codex-client.ts status
|
|
36
|
-
node scripts/fleet-codex-client.ts summary
|
|
37
|
-
node scripts/fleet-codex-client.ts send --id task-001 --text-file /private/tmp/instruction.txt --wait-ms 1000
|
|
38
|
-
node scripts/fleet-codex-client.ts watch --seconds 30
|
|
39
|
-
node scripts/fleet-codex-client.ts resync
|
|
40
|
-
node scripts/fleet-codex-client.ts replay
|
|
41
|
-
node scripts/fleet-codex-client.ts receipts
|
|
42
|
-
node scripts/fleet-codex-client.ts detach
|
|
32
|
+
node .pi/agent-fleet/scripts/fleet-codex-client.ts doctor
|
|
33
|
+
node .pi/agent-fleet/scripts/fleet-codex-client.ts sessions --project af
|
|
34
|
+
node .pi/agent-fleet/scripts/fleet-codex-client.ts select --project af --peer orchestrator
|
|
35
|
+
node .pi/agent-fleet/scripts/fleet-codex-client.ts status
|
|
36
|
+
node .pi/agent-fleet/scripts/fleet-codex-client.ts summary
|
|
37
|
+
node .pi/agent-fleet/scripts/fleet-codex-client.ts send --id task-001 --text-file /private/tmp/instruction.txt --wait-ms 1000
|
|
38
|
+
node .pi/agent-fleet/scripts/fleet-codex-client.ts watch --seconds 30
|
|
39
|
+
node .pi/agent-fleet/scripts/fleet-codex-client.ts resync
|
|
40
|
+
node .pi/agent-fleet/scripts/fleet-codex-client.ts replay
|
|
41
|
+
node .pi/agent-fleet/scripts/fleet-codex-client.ts receipts
|
|
42
|
+
node .pi/agent-fleet/scripts/fleet-codex-client.ts detach
|
|
43
43
|
```
|
|
44
44
|
|
|
45
45
|
Create the instruction file privately, preserving the human's exact text, and remove it after sending. The client accepts 1–16000 bytes. Do not put literal user text into a shell command. Use a distinct command ID for each new instruction, and reuse the same ID after an uncertain tool outcome. The same ID with different text or target is refused. `--wait-ms` accepts 100–60000; the default is 1000. The local reply listener exists only for that invocation.
|
|
@@ -51,8 +51,8 @@ Create the instruction file privately, preserving the human's exact text, and re
|
|
|
51
51
|
## Machine-readable operations (T14)
|
|
52
52
|
|
|
53
53
|
```sh
|
|
54
|
-
node scripts/fleet-codex-client.ts --help
|
|
55
|
-
node scripts/fleet-codex-client.ts describe
|
|
54
|
+
node .pi/agent-fleet/scripts/fleet-codex-client.ts --help
|
|
55
|
+
node .pi/agent-fleet/scripts/fleet-codex-client.ts describe
|
|
56
56
|
```
|
|
57
57
|
|
|
58
58
|
Both commands return JSON with `schemaVersion:1`, the client name, and 16 operation descriptors. Each descriptor includes `name`, `description`, generated `usage`, `inputSchema` (properties, required flags, numeric ranges/defaults and ID patterns), `effects.remote`, `effects.local`, `requirements`, and `limitations`. The descriptor module drives help and CLI flag validation, including required flags, unknown/duplicate flags and numeric limits. Operation-specific checks such as file ownership and current question flags still run at execution.
|
|
@@ -68,11 +68,11 @@ For Fleet/Hub commands, use the existing [Hub documentation](../.pi/harnesses/ag
|
|
|
68
68
|
The client can explicitly read and answer the selected Pi peer's pending `ask_user` calls when that peer runs the updated `ask-user-remote` wrapper and coms/Hub harness. These requests use the existing session-specific coms socket and bypass the LLM instruction queue. An older runtime reports `unsupported`; updating client files alone does not update a running Pi process.
|
|
69
69
|
|
|
70
70
|
```sh
|
|
71
|
-
node scripts/fleet-codex-client.ts questions
|
|
72
|
-
node scripts/fleet-codex-client.ts questions --after <nextCursor>
|
|
73
|
-
node scripts/fleet-codex-client.ts answer --id answer-001 --question <question-id> --answer-file /private/tmp/answer.json
|
|
74
|
-
node scripts/fleet-codex-client.ts cancel-question --id cancel-001 --question <question-id>
|
|
75
|
-
node scripts/fleet-codex-client.ts receipts
|
|
71
|
+
node .pi/agent-fleet/scripts/fleet-codex-client.ts questions
|
|
72
|
+
node .pi/agent-fleet/scripts/fleet-codex-client.ts questions --after <nextCursor>
|
|
73
|
+
node .pi/agent-fleet/scripts/fleet-codex-client.ts answer --id answer-001 --question <question-id> --answer-file /private/tmp/answer.json
|
|
74
|
+
node .pi/agent-fleet/scripts/fleet-codex-client.ts cancel-question --id cancel-001 --question <question-id>
|
|
75
|
+
node .pi/agent-fleet/scripts/fleet-codex-client.ts receipts
|
|
76
76
|
```
|
|
77
77
|
|
|
78
78
|
The private JSON file must use the exact human response: `{"kind":"selection","selections":["BG"]}` or `{"kind":"freeform","text":"Human text"}`. Selection may include `comment` only when permitted. Effective `allowMultiple`, `allowFreeform` and `allowComment` are returned with the question and checked in Pi. Use `cancel-question` for an explicit human refusal; never translate refusal into an arbitrary option. File ownership, symlink and size checks are the same as instruction files. Remove the private file after use.
|