@chankov/agent-fleet 2.0.11 → 2.0.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +1 -1
- package/.pi/agent-fleet/scripts/lib/herdr-layout.ts +3 -3
- package/.pi/harnesses/agent-hub/README.md +63 -6
- package/.pi/harnesses/agent-hub/budget-recovery.ts +24 -1
- package/.pi/harnesses/agent-hub/capability-packs.ts +2 -1
- package/.pi/harnesses/agent-hub/commands/context.ts +1 -0
- package/.pi/harnesses/agent-hub/commands/recover.ts +52 -0
- package/.pi/harnesses/agent-hub/commands/retry.ts +1 -1
- package/.pi/harnesses/agent-hub/config/overrides.ts +8 -1
- package/.pi/harnesses/agent-hub/context-budget-snapshot.ts +1 -1
- package/.pi/harnesses/agent-hub/context-window.js +2 -0
- package/.pi/harnesses/agent-hub/delegate.ts +3 -1
- package/.pi/harnesses/agent-hub/dispatch-coms.ts +20 -5
- package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +9 -3
- package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +56 -51
- package/.pi/harnesses/agent-hub/dispatch-native-types.ts +8 -2
- package/.pi/harnesses/agent-hub/dispatch-native.ts +1 -1
- package/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
- package/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
- package/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
- package/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
- package/.pi/harnesses/agent-hub/drift-watchdog.js +140 -9
- package/.pi/harnesses/agent-hub/index.ts +81 -43
- package/.pi/harnesses/agent-hub/input/completions.ts +8 -2
- package/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +4 -2
- package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +1 -1
- package/.pi/harnesses/agent-hub/no-progress.ts +169 -16
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/policy/work-mode.ts +2 -2
- package/.pi/harnesses/agent-hub/prompts/context.ts +1 -1
- package/.pi/harnesses/agent-hub/prompts/session-start.ts +2 -2
- package/.pi/harnesses/agent-hub/reconcile.ts +26 -0
- package/.pi/harnesses/agent-hub/recover-policy.ts +27 -0
- package/.pi/harnesses/agent-hub/recover-state.ts +104 -0
- package/.pi/harnesses/agent-hub/recovery-contract.ts +3 -1
- package/.pi/harnesses/agent-hub/research/controls.ts +1 -1
- package/.pi/harnesses/agent-hub/research/runtime.ts +1 -1
- package/.pi/harnesses/agent-hub/research/spawn-run.ts +1 -1
- package/.pi/harnesses/agent-hub/return-extract.js +3 -1
- package/.pi/harnesses/agent-hub/review-findings.js +2 -0
- package/.pi/harnesses/agent-hub/run-budget.js +6 -1
- package/.pi/harnesses/agent-hub/run-namespace.js +6 -0
- package/.pi/harnesses/agent-hub/session-audit.ts +68 -3
- package/.pi/harnesses/agent-hub/spawn.ts +76 -8
- package/.pi/harnesses/agent-hub/system1-activity.ts +443 -0
- package/.pi/harnesses/agent-hub/system1-report.ts +84 -0
- package/.pi/harnesses/agent-hub/system1-runtime.ts +273 -0
- package/.pi/harnesses/agent-hub/timeline.ts +23 -5
- package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +14 -1
- package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +2 -2
- package/.pi/harnesses/agent-hub/types.ts +1 -0
- package/.pi/harnesses/agent-hub/ui/activity-dots.ts +12 -3
- package/.pi/harnesses/agent-hub/ui/context-budget.ts +4 -3
- package/.pi/harnesses/agent-hub/ui/detail-panel.ts +11 -18
- package/.pi/harnesses/agent-hub/ui/fleet-actions.ts +3 -1
- package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +2 -2
- package/.pi/harnesses/agent-hub/ui/fleet-source.ts +14 -1
- package/.pi/harnesses/agent-hub/ui/grid.ts +6 -6
- package/.pi/harnesses/agent-hub/ui/pool.ts +1 -1
- package/.pi/harnesses/agent-hub/ui/zoom.ts +5 -3
- package/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/coms-core.ts +1 -1
- package/.pi/harnesses/lib/context-budget.ts +1 -1
- package/.pi/harnesses/lib/fleet-dashboard-view.ts +3 -1
- package/.pi/harnesses/lib/fleet-detail-view.ts +35 -4
- package/.pi/harnesses/lib/fleet-read-model.ts +206 -14
- package/.pi/harnesses/lib/fleet-strip-view.ts +17 -5
- package/.pi/harnesses/lib/hermes-monitor-registry.ts +1 -1
- package/.pi/harnesses/lib/spawned-peers.js +1 -0
- package/.pi/harnesses/lib/system1/config.js +61 -0
- package/.pi/harnesses/lib/system1/contracts.ts +152 -0
- package/.pi/harnesses/lib/system1/demo.ts +106 -0
- package/.pi/harnesses/lib/system1/jev.ts +503 -0
- package/.pi/harnesses/lib/system1/service.ts +245 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/README.md +347 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.12/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.12/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/fleet.ts +216 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/flow.ts +155 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/package-lock.json +35 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/package.json +9 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/team-up.ts +378 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +177 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
- package/.versions/2.0.12/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.12/.pi/agents/model-profiles.yaml +83 -0
- package/.versions/2.0.12/.pi/agents/peers.yaml +147 -0
- package/.versions/2.0.12/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.12/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.12/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.12/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.12/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.12/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.12/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.12/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.12/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.12/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.12/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.12/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.12/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.12/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.12/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.12/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.12/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.12/.pi/extensions/package.json +9 -0
- package/.versions/2.0.12/.pi/extensions/pi-voice-stt/README.md +224 -0
- package/.versions/2.0.12/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.12/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.12/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.12/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.12/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.12/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/README.md +1309 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/acceptance.ts +199 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/context.ts +45 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/recover.ts +52 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/config/agents.ts +178 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/config/model-profiles.ts +235 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/config/overrides.ts +160 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/context/budgets.ts +204 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/context-window.js +108 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/delegate.ts +465 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-native-complete.ts +169 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +223 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +202 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-native-types.ts +251 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-native.ts +226 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/fixtures/registration-surface.json +61 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/helpers.ts +270 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/index.ts +2301 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/input/completions.ts +82 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +125 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/no-progress.ts +359 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/policy/work-mode.ts +126 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/prompts/context.ts +51 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/prompts/fragments.ts +118 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/reconcile.ts +26 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/recover-policy.ts +27 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/recover-state.ts +104 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/recovery-contract.ts +80 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/research/runtime.ts +193 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/research/spawn-run.ts +171 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/return-contract.js +327 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/return-extract.js +77 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/review-findings.js +104 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/run-budget.js +542 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/run-namespace.js +93 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/scope-gate.js +123 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/session-audit.ts +226 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/spawn.ts +526 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/system1-activity.ts +443 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/system1-report.ts +84 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/system1-runtime.ts +273 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/timeline.ts +72 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/action-executors.ts +185 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/context.ts +142 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +498 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/run-flow.ts +122 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/tsconfig.json +22 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/types.ts +66 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/detail-panel.ts +171 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +99 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/fleet-source.ts +170 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/grid.ts +154 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/work-mode.ts +173 -0
- package/.versions/2.0.12/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
- package/.versions/2.0.12/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.12/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.12/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.12/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.12/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
- package/.versions/2.0.12/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.12/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.12/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.12/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.12/.pi/harnesses/damage-control-continue/README.md +135 -0
- package/.versions/2.0.12/.pi/harnesses/damage-control-continue/index.ts +550 -0
- package/.versions/2.0.12/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.12/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.12/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
- package/.versions/2.0.12/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.12/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.12/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.12/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
- package/.versions/2.0.12/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.12/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.12/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.12/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.12/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fleet-dashboard-view.ts +136 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fleet-detail-view.ts +278 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fleet-read-model.ts +405 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fleet-strip-view.ts +144 -0
- package/.versions/2.0.12/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.12/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.12/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.12/.pi/harnesses/lib/spawned-peers.js +191 -0
- package/.versions/2.0.12/.pi/harnesses/lib/system1/config.js +61 -0
- package/.versions/2.0.12/.pi/harnesses/lib/system1/contracts.ts +152 -0
- package/.versions/2.0.12/.pi/harnesses/lib/system1/demo.ts +106 -0
- package/.versions/2.0.12/.pi/harnesses/lib/system1/jev.ts +503 -0
- package/.versions/2.0.12/.pi/harnesses/lib/system1/service.ts +245 -0
- package/.versions/2.0.12/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.12/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.12/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.12/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.12/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.12/.pi/prompts/af-constraints.md +31 -0
- package/.versions/2.0.12/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.12/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.12/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.12/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.12/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.12/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.12/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.12/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.12/.version +1 -0
- package/.versions/2.0.12/agents/architect.md +25 -0
- package/.versions/2.0.12/agents/bowser.md +28 -0
- package/.versions/2.0.12/agents/builder.md +56 -0
- package/.versions/2.0.12/agents/code-reviewer.md +210 -0
- package/.versions/2.0.12/agents/deep-researcher.md +33 -0
- package/.versions/2.0.12/agents/documenter.md +23 -0
- package/.versions/2.0.12/agents/orchestrator.md +23 -0
- package/.versions/2.0.12/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.12/agents/planner.md +106 -0
- package/.versions/2.0.12/agents/releaser.md +25 -0
- package/.versions/2.0.12/agents/researcher.md +31 -0
- package/.versions/2.0.12/agents/security-auditor.md +168 -0
- package/.versions/2.0.12/agents/test-engineer.md +154 -0
- package/.versions/2.0.12/agents/web-debugger.md +44 -0
- package/.versions/2.0.12/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.12/bin/catalog/harness-runtime-closure.json +61 -0
- package/.versions/2.0.12/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.12/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.12/docs/ARCHITECTURE.md +705 -0
- package/.versions/2.0.12/docs/agent-fleet-setup.md +682 -0
- package/.versions/2.0.12/docs/claude-code-coms-bridge.md +134 -0
- package/.versions/2.0.12/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.12/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.12/docs/getting-started.md +126 -0
- package/.versions/2.0.12/docs/npm-install.md +468 -0
- package/.versions/2.0.12/docs/pi-extensions.md +449 -0
- package/.versions/2.0.12/docs/pi-setup.md +92 -0
- package/.versions/2.0.12/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.12/install-manifest.json +3053 -0
- package/.versions/2.0.12/justfile +247 -0
- package/.versions/2.0.12/manifest-meta.json +995 -0
- package/.versions/2.0.12/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.12/references/communication-contract.md +26 -0
- package/.versions/2.0.12/references/definition-of-done.md +67 -0
- package/.versions/2.0.12/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.12/references/observability-checklist.md +92 -0
- package/.versions/2.0.12/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.12/references/performance-checklist.md +236 -0
- package/.versions/2.0.12/references/prompting-patterns.md +380 -0
- package/.versions/2.0.12/references/security-checklist.md +245 -0
- package/.versions/2.0.12/references/testing-patterns.md +235 -0
- package/.versions/2.0.12/references/workflow-authoring.md +304 -0
- package/.versions/2.0.12/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.12/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.12/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.12/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.12/skills/constraint-driven-development/SKILL.md +338 -0
- package/.versions/2.0.12/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.12/skills/context-engineering/SKILL.md +341 -0
- package/.versions/2.0.12/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.12/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.12/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.12/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.12/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.12/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.12/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.12/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.12/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.12/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.12/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.12/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.12/skills/incremental-implementation/SKILL.md +302 -0
- package/.versions/2.0.12/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.12/skills/orchestration-verification/SKILL.md +182 -0
- package/.versions/2.0.12/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.12/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.12/skills/planning-and-task-breakdown/SKILL.md +289 -0
- package/.versions/2.0.12/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.12/skills/spec-driven-development/SKILL.md +295 -0
- package/.versions/2.0.12/skills/using-agent-skills/SKILL.md +198 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/README.md +430 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
- package/.versions/2.0.12/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
- package/CHANGELOG.md +10 -0
- package/bin/cli.js +3 -3
- package/bin/lib/doctor.js +63 -1
- package/docs/ARCHITECTURE.md +113 -3
- package/docs/agent-fleet-setup.md +96 -0
- package/docs/npm-install.md +87 -2
- package/install-manifest.json +34 -1
- package/manifest-meta.json +25 -0
- package/package.json +6 -2
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: using-agent-skills
|
|
3
|
+
description: Discovers and invokes agent skills. Use when starting a session, or when you need to decide which skill or workflow applies to the piece of work at hand. This is the meta-skill that governs how all other skills are discovered and invoked.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Using Agent Skills
|
|
7
|
+
|
|
8
|
+
## Overview
|
|
9
|
+
|
|
10
|
+
Agent Skills is a collection of engineering workflow skills organized by development phase. Each skill encodes a specific process that senior engineers follow. This meta-skill helps you discover and apply the right skill for your current task.
|
|
11
|
+
|
|
12
|
+
## Skill Discovery
|
|
13
|
+
|
|
14
|
+
When a task arrives, identify the development phase and apply the corresponding skill:
|
|
15
|
+
|
|
16
|
+
```
|
|
17
|
+
Task arrives
|
|
18
|
+
│
|
|
19
|
+
├── Don't know what you want yet? ──────→ interview-me
|
|
20
|
+
├── Have a rough concept, need variants? → idea-refine
|
|
21
|
+
├── New project/feature/change? ──→ spec-driven-development
|
|
22
|
+
├── No quality bar written down? ──→ constraint-driven-development
|
|
23
|
+
├── Have a spec, need tasks? ──────→ planning-and-task-breakdown
|
|
24
|
+
├── Implementing code? ────────────→ incremental-implementation
|
|
25
|
+
│ ├── UI work? ─────────────────→ frontend-ui-engineering
|
|
26
|
+
│ ├── API work? ────────────────→ api-and-interface-design
|
|
27
|
+
│ ├── Need better context? ─────→ context-engineering
|
|
28
|
+
│ ├── Need doc-verified code? ───→ source-driven-development
|
|
29
|
+
│ └── Stakes high / unfamiliar code? ──→ doubt-driven-development
|
|
30
|
+
├── Writing/running tests? ────────→ test-driven-development
|
|
31
|
+
│ └── Browser-based? ───────────→ browser-testing-with-devtools
|
|
32
|
+
├── Something broke? ──────────────→ debugging-and-error-recovery
|
|
33
|
+
├── Reviewing code? ───────────────→ code-review-and-quality
|
|
34
|
+
│ ├── Too complex? ─────────────→ code-simplification
|
|
35
|
+
│ ├── Security concerns? ───────→ security-and-hardening
|
|
36
|
+
│ └── Performance concerns? ────→ performance-optimization
|
|
37
|
+
├── Committing/branching? ─────────→ git-workflow-and-versioning
|
|
38
|
+
├── CI/CD pipeline work? ──────────→ ci-cd-and-automation
|
|
39
|
+
├── Deprecating/migrating? ────────→ deprecation-and-migration
|
|
40
|
+
├── Writing docs/ADRs? ───────────→ documentation-and-adrs
|
|
41
|
+
├── Adding logs/metrics/alerts? ───→ observability-and-instrumentation
|
|
42
|
+
└── Deploying/launching? ─────────→ shipping-and-launch
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## Core Operating Behaviors
|
|
46
|
+
|
|
47
|
+
These behaviors apply at all times, across all skills. They are non-negotiable.
|
|
48
|
+
|
|
49
|
+
### 1. Surface Assumptions
|
|
50
|
+
|
|
51
|
+
Before implementing anything non-trivial, explicitly state your assumptions:
|
|
52
|
+
|
|
53
|
+
```
|
|
54
|
+
ASSUMPTIONS I'M MAKING:
|
|
55
|
+
1. [assumption about requirements]
|
|
56
|
+
2. [assumption about architecture]
|
|
57
|
+
3. [assumption about scope]
|
|
58
|
+
→ Correct me now or I'll proceed with these.
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
Don't silently fill in ambiguous requirements. The most common failure mode is making wrong assumptions and running with them unchecked. Surface uncertainty early — it's cheaper than rework.
|
|
62
|
+
|
|
63
|
+
### 2. Manage Confusion Actively
|
|
64
|
+
|
|
65
|
+
When you encounter inconsistencies, conflicting requirements, or unclear specifications:
|
|
66
|
+
|
|
67
|
+
1. **STOP.** Do not proceed with a guess.
|
|
68
|
+
2. Name the specific confusion.
|
|
69
|
+
3. Present the tradeoff or ask the clarifying question.
|
|
70
|
+
4. Wait for resolution before continuing.
|
|
71
|
+
|
|
72
|
+
**Bad:** Silently picking one interpretation and hoping it's right.
|
|
73
|
+
**Good:** "I see X in the spec but Y in the existing code. Which takes precedence?"
|
|
74
|
+
|
|
75
|
+
### 3. Push Back When Warranted
|
|
76
|
+
|
|
77
|
+
You are not a yes-machine. When an approach has clear problems:
|
|
78
|
+
|
|
79
|
+
- Point out the issue directly
|
|
80
|
+
- Explain the concrete downside (quantify when possible — "this adds ~200ms latency" not "this might be slower")
|
|
81
|
+
- Propose an alternative
|
|
82
|
+
- Accept the human's decision if they override with full information
|
|
83
|
+
|
|
84
|
+
Sycophancy is a failure mode. "Of course!" followed by implementing a bad idea helps no one. Honest technical disagreement is more valuable than false agreement.
|
|
85
|
+
|
|
86
|
+
### 4. Enforce Simplicity
|
|
87
|
+
|
|
88
|
+
Your natural tendency is to overcomplicate. Actively resist it.
|
|
89
|
+
|
|
90
|
+
Before finishing any implementation, ask:
|
|
91
|
+
- Can this be done in fewer lines?
|
|
92
|
+
- Are these abstractions earning their complexity?
|
|
93
|
+
- Would a staff engineer look at this and say "why didn't you just..."?
|
|
94
|
+
|
|
95
|
+
If you build 1000 lines and 100 would suffice, you have failed. Prefer the boring, obvious solution. Cleverness is expensive.
|
|
96
|
+
|
|
97
|
+
### 5. Maintain Scope Discipline
|
|
98
|
+
|
|
99
|
+
Touch only what you're asked to touch.
|
|
100
|
+
|
|
101
|
+
Do NOT:
|
|
102
|
+
- Remove comments you don't understand
|
|
103
|
+
- "Clean up" code orthogonal to the task
|
|
104
|
+
- Refactor adjacent systems as a side effect
|
|
105
|
+
- Delete code that seems unused without explicit approval
|
|
106
|
+
- Add features not in the spec because they "seem useful"
|
|
107
|
+
|
|
108
|
+
Your job is surgical precision, not unsolicited renovation.
|
|
109
|
+
|
|
110
|
+
### 6. Verify, Don't Assume
|
|
111
|
+
|
|
112
|
+
Every skill includes a verification step. A task is not complete until verification passes. "Seems right" is never sufficient — there must be evidence (passing tests, build output, runtime data).
|
|
113
|
+
|
|
114
|
+
Per-skill verification is the local check. The project-wide bar that applies to *every* change, regardless of which skill is active, is the Definition of Done: tests pass, no regressions, behavior verified at runtime, docs updated. See `../../references/definition-of-done.md`. It complements each task's acceptance criteria rather than replacing them.
|
|
115
|
+
|
|
116
|
+
## Failure Modes to Avoid
|
|
117
|
+
|
|
118
|
+
These are the subtle errors that look like productivity but create problems:
|
|
119
|
+
|
|
120
|
+
1. Making wrong assumptions without checking
|
|
121
|
+
2. Not managing your own confusion — plowing ahead when lost
|
|
122
|
+
3. Not surfacing inconsistencies you notice
|
|
123
|
+
4. Not presenting tradeoffs on non-obvious decisions
|
|
124
|
+
5. Being sycophantic ("Of course!") to approaches with clear problems
|
|
125
|
+
6. Overcomplicating code and APIs
|
|
126
|
+
7. Modifying code or comments orthogonal to the task
|
|
127
|
+
8. Removing things you don't fully understand
|
|
128
|
+
9. Building without a spec because "it's obvious"
|
|
129
|
+
10. Skipping verification because "it looks right"
|
|
130
|
+
|
|
131
|
+
## Skill Rules
|
|
132
|
+
|
|
133
|
+
1. **Check for an applicable skill before starting work.** Skills encode processes that prevent common mistakes.
|
|
134
|
+
|
|
135
|
+
2. **Skills are workflows, not suggestions.** Follow the steps in order. Don't skip verification steps.
|
|
136
|
+
|
|
137
|
+
3. **Multiple skills can apply.** A feature implementation might involve `idea-refine` → `spec-driven-development` → `planning-and-task-breakdown` → `incremental-implementation` → `test-driven-development` → `code-review-and-quality` → `code-simplification` → `shipping-and-launch` in sequence.
|
|
138
|
+
|
|
139
|
+
4. **When in doubt, start with a spec.** If the task is non-trivial and there's no spec, begin with `spec-driven-development`.
|
|
140
|
+
|
|
141
|
+
## Lifecycle Sequence
|
|
142
|
+
|
|
143
|
+
For a complete feature, the typical skill sequence is:
|
|
144
|
+
|
|
145
|
+
```
|
|
146
|
+
1. interview-me → Extract what the user actually wants
|
|
147
|
+
2. idea-refine → Refine vague ideas
|
|
148
|
+
3. spec-driven-development → Define what we're building
|
|
149
|
+
4. planning-and-task-breakdown → Break into verifiable chunks
|
|
150
|
+
5. context-engineering → Load the right context
|
|
151
|
+
6. source-driven-development → Verify against official docs
|
|
152
|
+
7. incremental-implementation → Build slice by slice
|
|
153
|
+
8. observability-and-instrumentation → Instrument as you build (runs parallel with 7-9, not after)
|
|
154
|
+
9. doubt-driven-development → Cross-examine non-trivial decisions in-flight
|
|
155
|
+
10. test-driven-development → Prove each slice works
|
|
156
|
+
11. code-review-and-quality → Review before merge
|
|
157
|
+
12. code-simplification → Reduce unnecessary complexity while preserving behavior
|
|
158
|
+
13. git-workflow-and-versioning → Clean commit history
|
|
159
|
+
14. documentation-and-adrs → Document decisions
|
|
160
|
+
15. deprecation-and-migration → Retire old systems and move users safely when needed
|
|
161
|
+
16. shipping-and-launch → Deploy safely
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
Not every task needs every skill. A bug fix might only need: `debugging-and-error-recovery` → `test-driven-development` → `code-review-and-quality`.
|
|
165
|
+
|
|
166
|
+
## Quick Reference
|
|
167
|
+
|
|
168
|
+
| Phase | Skill | One-Line Summary |
|
|
169
|
+
|-------|-------|-----------------|
|
|
170
|
+
| Define | interview-me | Surface what the user actually wants before any plan, spec, or code exists |
|
|
171
|
+
| Define | idea-refine | Refine ideas through structured divergent and convergent thinking |
|
|
172
|
+
| Define | spec-driven-development | Requirements and acceptance criteria before code |
|
|
173
|
+
| Plan | planning-and-task-breakdown | Decompose into small, verifiable tasks |
|
|
174
|
+
| Build | incremental-implementation | Thin vertical slices, test each before expanding |
|
|
175
|
+
| Build | source-driven-development | Verify against official docs before implementing |
|
|
176
|
+
| Build | doubt-driven-development | Adversarial fresh-context review of every non-trivial decision |
|
|
177
|
+
| Build | context-engineering | Right context at the right time |
|
|
178
|
+
| Build | frontend-ui-engineering | Production-quality UI with accessibility |
|
|
179
|
+
| Build | api-and-interface-design | Stable interfaces with clear contracts |
|
|
180
|
+
| Verify | test-driven-development | Failing test first, then make it pass |
|
|
181
|
+
| Verify | browser-testing-with-devtools | Chrome DevTools MCP for runtime verification |
|
|
182
|
+
| Verify | debugging-and-error-recovery | Reproduce → localize → fix → guard |
|
|
183
|
+
| Review | code-review-and-quality | Five-axis review with quality gates |
|
|
184
|
+
| Review | code-simplification | Preserve behavior while reducing unnecessary complexity |
|
|
185
|
+
| Review | security-and-hardening | OWASP prevention, input validation, least privilege |
|
|
186
|
+
| Review | performance-optimization | Measure first, optimize only what matters |
|
|
187
|
+
| Ship | git-workflow-and-versioning | Atomic commits, clean history |
|
|
188
|
+
| Ship | ci-cd-and-automation | Automated quality gates on every change |
|
|
189
|
+
| Ship | deprecation-and-migration | Remove old systems and migrate users safely |
|
|
190
|
+
| Ship | documentation-and-adrs | Document the why, not just the what |
|
|
191
|
+
| Ship | observability-and-instrumentation | Structured logs, RED metrics, traces, symptom-based alerts |
|
|
192
|
+
| Ship | shipping-and-launch | Pre-launch checklist, monitoring, rollback plan |
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,15 @@
|
|
|
1
1
|
# Agent Fleet changelog
|
|
2
2
|
|
|
3
|
+
## 2.0.12
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- be06772: Add the opt-in experimental System 1 foundation with a provider-neutral judgment contract, a pinned TypeSafe Jev adapter, advisory offline diagnostics, and an explicit synthetic live demo.
|
|
8
|
+
|
|
9
|
+
The `system1` feature remains outside automatic Full selection and uses human-owned version-1 `.ai/system1.json` configuration. It does not integrate with Watchdog, install local models, or promise child-environment credential isolation.
|
|
10
|
+
|
|
11
|
+
- d7a15e2: Add opt-in System 1 observations for native drift watchdog checks, safe trace/UI reporting, bounded recovery after an unavailable LLM judge, and an explicitly opted-in experimental active shortcut for advisory scope only (Jev 0.95/0.05). Active is not G2-validated; the default remains off and terminal rules retain the LLM judge.
|
|
12
|
+
|
|
3
13
|
## 2.0.11
|
|
4
14
|
|
|
5
15
|
### Patch Changes
|
package/bin/cli.js
CHANGED
|
@@ -381,7 +381,7 @@ async function cmdDoctor() {
|
|
|
381
381
|
catch (err) { fail(`cannot recover pending transaction: ${err.message}`); }
|
|
382
382
|
}
|
|
383
383
|
|
|
384
|
-
const ADVISORY_FINDING_TYPES = new Set(["overrides", "yaml-shape"]);
|
|
384
|
+
const ADVISORY_FINDING_TYPES = new Set(["overrides", "yaml-shape", "system1"]);
|
|
385
385
|
// These findings affect launch readiness and the doctor exit code, but npm
|
|
386
386
|
// execution remains behind its dedicated explicit-consent commands.
|
|
387
387
|
const MANUAL_FINDING_TYPES = new Set(["runtime-dependencies", "manifest-tool"]);
|
|
@@ -399,7 +399,7 @@ async function cmdDoctor() {
|
|
|
399
399
|
const enginePaths = new Set(
|
|
400
400
|
repairs.flatMap((a) => [a.target, ...(a.files ?? []).map((f) => f.path)]).filter(Boolean),
|
|
401
401
|
);
|
|
402
|
-
const findings = (await runDoctor({ workspace, sourceRoot: pkgRoot }))
|
|
402
|
+
const findings = (await runDoctor({ workspace, sourceRoot: pkgRoot, env: process.env }))
|
|
403
403
|
.filter((f) => !(f.type === "broken-symlink" && enginePaths.has(f.path)));
|
|
404
404
|
for (const tool of preflight.tools.filter((item) => item.status === "missing")) findings.push({
|
|
405
405
|
type: "manifest-tool", path: tool.itemId, issue: `required manifest tool ${tool.probe} is missing`,
|
|
@@ -465,7 +465,7 @@ async function cmdDoctor() {
|
|
|
465
465
|
let scanRepair = null;
|
|
466
466
|
if (willFix) {
|
|
467
467
|
if (repairs.length > 0) applied = applyPlan({ plan, manifest: loadManifest(pkgRoot) });
|
|
468
|
-
if (fixable.length > 0) scanRepair = await runDoctor({ workspace, sourceRoot: pkgRoot, apply: true });
|
|
468
|
+
if (fixable.length > 0) scanRepair = await runDoctor({ workspace, sourceRoot: pkgRoot, apply: true, env: process.env });
|
|
469
469
|
}
|
|
470
470
|
|
|
471
471
|
const runtimeRepairOutput = (line) => (opts.json ? console.error : console.log)(`exec: ${line}`);
|
package/bin/lib/doctor.js
CHANGED
|
@@ -26,6 +26,9 @@
|
|
|
26
26
|
// 8. Manifest preflight — selected exact files and declared package probes are
|
|
27
27
|
// reported as environment readiness, with platform unknown/unavailable kept
|
|
28
28
|
// distinct from missing installation. Inspection never installs or repairs.
|
|
29
|
+
// 9. System 1 readiness — explicit feature selection, human configuration,
|
|
30
|
+
// .env declaration and current environment presence. Advisory and read-only;
|
|
31
|
+
// API validity is never inferred or probed.
|
|
29
32
|
//
|
|
30
33
|
// For each broken link we look up a canonical replacement in the source
|
|
31
34
|
// `agents/` or `skills/` tree (many breakages are stale names from the
|
|
@@ -38,6 +41,7 @@ import { parse as parseYaml } from "yaml";
|
|
|
38
41
|
import { validateOverrides } from "./validate-overrides.js";
|
|
39
42
|
import { readState, STATE_REL_PATH } from "./state.js";
|
|
40
43
|
import { runtimeDependencyFindings } from "../../.pi/agent-fleet/scripts/lib/runtime-dependencies.js";
|
|
44
|
+
import { resolveSystem1Readiness } from "../../.pi/harnesses/lib/system1/config.js";
|
|
41
45
|
|
|
42
46
|
export const AGENT_FLEET_PACKAGE_NAME = "@chankov/agent-fleet";
|
|
43
47
|
const AGENT_FLEET_PACKAGE_PATTERN = /(^|[/:])@chankov\/agent-fleet(@[^/]*)?$/;
|
|
@@ -85,7 +89,7 @@ const YAML_REFS = [
|
|
|
85
89
|
* @param {boolean} [opts.apply] If true, apply suggested fixes; otherwise just report
|
|
86
90
|
* @returns {Array|object} Findings array (apply=false) or {repaired,deleted,skipped} (apply=true)
|
|
87
91
|
*/
|
|
88
|
-
export async function runDoctor({ workspace, sourceRoot, apply = false, checkVisibility, checkDependencies } = {}) {
|
|
92
|
+
export async function runDoctor({ workspace, sourceRoot, apply = false, checkVisibility, checkDependencies, env = process.env } = {}) {
|
|
89
93
|
const findings = [];
|
|
90
94
|
|
|
91
95
|
// 1. Broken symlinks in install-target directories.
|
|
@@ -173,6 +177,10 @@ export async function runDoctor({ workspace, sourceRoot, apply = false, checkVis
|
|
|
173
177
|
// Node module resolution cannot borrow a sibling root's node_modules.
|
|
174
178
|
findings.push(...runtimeDependencyFindings({ workspace, run: checkDependencies }));
|
|
175
179
|
|
|
180
|
+
// 9. Optional System 1 readiness. This reads local declarations only; it does
|
|
181
|
+
// not load .env, create a provider, or contact the API.
|
|
182
|
+
findings.push(...scanSystem1Readiness({ workspace, env }));
|
|
183
|
+
|
|
176
184
|
if (!apply) return findings;
|
|
177
185
|
|
|
178
186
|
// ── Apply ──────────────────────────────────────────────────────────────
|
|
@@ -208,6 +216,60 @@ export async function runDoctor({ workspace, sourceRoot, apply = false, checkVis
|
|
|
208
216
|
return { repaired, deleted, skipped, findings };
|
|
209
217
|
}
|
|
210
218
|
|
|
219
|
+
export function scanSystem1Readiness({ workspace, env = process.env }) {
|
|
220
|
+
const desiredPath = join(workspace, ".ai", "agent-fleet.json");
|
|
221
|
+
let selected = false;
|
|
222
|
+
if (existsSync(desiredPath)) {
|
|
223
|
+
try {
|
|
224
|
+
const desired = JSON.parse(readFileSync(desiredPath, "utf8"));
|
|
225
|
+
selected = desired?.features?.system1 === true;
|
|
226
|
+
} catch {
|
|
227
|
+
// A malformed desired-state file is handled by the installer lifecycle;
|
|
228
|
+
// without a trustworthy explicit selection System 1 remains inactive.
|
|
229
|
+
}
|
|
230
|
+
}
|
|
231
|
+
if (!selected) return [];
|
|
232
|
+
|
|
233
|
+
const configPath = join(workspace, ".ai", "system1.json");
|
|
234
|
+
let config;
|
|
235
|
+
if (existsSync(configPath)) {
|
|
236
|
+
try { config = JSON.parse(readFileSync(configPath, "utf8")); }
|
|
237
|
+
catch { config = null; }
|
|
238
|
+
}
|
|
239
|
+
const readiness = resolveSystem1Readiness({ selected, config, env });
|
|
240
|
+
const envPath = join(workspace, ".env");
|
|
241
|
+
let envDeclared = false;
|
|
242
|
+
if (existsSync(envPath)) {
|
|
243
|
+
try {
|
|
244
|
+
envDeclared = /^(?:\s*export\s+)?\s*TYPESAFE_API_KEY\s*=/m.test(readFileSync(envPath, "utf8"));
|
|
245
|
+
} catch { /* Unreadable declarations remain absent. */ }
|
|
246
|
+
}
|
|
247
|
+
const environmentPresent = typeof env.TYPESAFE_API_KEY === "string" && env.TYPESAFE_API_KEY.trim().length > 0;
|
|
248
|
+
const readinessName = readiness.status === "ready" ? "ready" : readiness.reason;
|
|
249
|
+
const detail = {
|
|
250
|
+
disabled: "configuration mode is off; other fields were not validated",
|
|
251
|
+
missing_config: ".ai/system1.json is absent",
|
|
252
|
+
missing_key: envDeclared
|
|
253
|
+
? "TYPESAFE_API_KEY is declared in .env but is not present in the current process environment; .env was not loaded"
|
|
254
|
+
: "TYPESAFE_API_KEY is not present in the current process environment",
|
|
255
|
+
invalid_config: ".ai/system1.json is invalid",
|
|
256
|
+
ready: "configuration and current environment are locally ready",
|
|
257
|
+
}[readinessName];
|
|
258
|
+
return [{
|
|
259
|
+
type: "system1",
|
|
260
|
+
path: ".ai/system1.json",
|
|
261
|
+
issue: `System 1: ${detail}; API validity is unverified`,
|
|
262
|
+
fix: readinessName === "ready" || readinessName === "disabled"
|
|
263
|
+
? "no automatic action"
|
|
264
|
+
: "review the operator-owned System 1 configuration and process environment",
|
|
265
|
+
classification: "advisory",
|
|
266
|
+
readiness: readinessName,
|
|
267
|
+
envDeclared,
|
|
268
|
+
environmentPresent,
|
|
269
|
+
apiValidity: "unverified",
|
|
270
|
+
}];
|
|
271
|
+
}
|
|
272
|
+
|
|
211
273
|
function escapeRe(s) {
|
|
212
274
|
return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
|
|
213
275
|
}
|
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -21,6 +21,7 @@ this page describes the current architecture.
|
|
|
21
21
|
| **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) |
|
|
22
22
|
| **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) |
|
|
23
23
|
| **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) |
|
|
24
|
+
| **System 1 foundation** | Experimental, opt-in provider-neutral structured judgments; currently TypeSafe Jev only, with a separate off-by-default native watchdog shadow consumer and closed active gate | `.pi/harnesses/lib/system1/`, feature `system1`, human-owned `.ai/system1.json` |
|
|
24
25
|
| **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) |
|
|
25
26
|
| **Personas** | Reusable specialist definitions, installed verbatim | `agents/` in the package → `.pi/agents/personas/` in a workspace; `bin/lib/personas.js` |
|
|
26
27
|
|
|
@@ -287,8 +288,17 @@ T5 does not consume `assist.write-isolation`; the separate T6c native launch bou
|
|
|
287
288
|
|
|
288
289
|
Recovery remains the single T1 contract: no automatic retry, queue, model fallback, or new
|
|
289
290
|
numeric allowance. Busy work is refused before execution accounting or history mutation and is
|
|
290
|
-
not recorded as no-progress failure
|
|
291
|
-
|
|
291
|
+
not recorded as no-progress failure. A settled indeterminate failure permits at most one
|
|
292
|
+
explicit, warned, human-authorized retry per logical operation after the prior process is
|
|
293
|
+
confirmed finished and the executor is idle; partial side effects may be duplicated. Neither
|
|
294
|
+
`/af-recover retry <operationId> <attemptId>` nor legacy `/af-retry <dispatchId>` executes work:
|
|
295
|
+
both use the same authorization lane and offer a stored original-contract invocation for a
|
|
296
|
+
separate explicit tool call under unchanged budgets and safety gates. Pending/unknown process,
|
|
297
|
+
second grant, stale IDs, and missing original contract fail closed. `/af-recover inspect` is
|
|
298
|
+
read-only; `reconcile` clears only a technical block when independent current-revision
|
|
299
|
+
readback and nonblocking reviewer evidence cover the failed attempt, leaving the immutable
|
|
300
|
+
failure and open T2/T11 requirements intact; `abandon` never satisfies dependent work.
|
|
301
|
+
Operator cancellation fences the same agent identity until a fresh, one-use authorization is consumed.
|
|
292
302
|
Other agent identities—including the anonymous, read-only research actor—remain independent,
|
|
293
303
|
and a task reset does not erase the cancellation fence. Native session reuse is bound to an exact,
|
|
294
304
|
normalized current-task contract (task identity, instructions, scope, deliverables, input artifacts,
|
|
@@ -439,6 +449,106 @@ These are the external systems Agent Fleet assumes or integrates with — not np
|
|
|
439
449
|
|
|
440
450
|
The existing `agent-fleet doctor` command also performs a read-only manifest preflight. It reports exact selected installation files and manifest-declared tool probes as environment readiness, distinguishes missing installation from unknown or unavailable platforms, and names the existing explicit remediation path. Bare doctor never repairs or installs; `doctor --fix` remains the only repair activation, and package/tool installation remains behind its existing explicit consent path.
|
|
441
451
|
|
|
452
|
+
### System 1 watchdog consumer (off by default)
|
|
453
|
+
|
|
454
|
+
The native specialist Layer 1 drift watchdog can use the shared System 1 runtime
|
|
455
|
+
only after explicit `watchdog-system1: shadow` in `## agent-hub`, feature selection,
|
|
456
|
+
valid provider configuration, an available key and an armed watchdog. It takes a
|
|
457
|
+
session snapshot; setup and doctor do not infer. Shadow starts the LLM judge at
|
|
458
|
+
once and separately observes the same bounded state with Jev. Only the LLM
|
|
459
|
+
verdict may terminate a child; an unavailable LLM judge is recorded as
|
|
460
|
+
`judge_unavailable` and gets one revalidated retry at 5 s, not a successful
|
|
461
|
+
90 s cooldown. Successful decisions keep 90 s. Every physical attempt has
|
|
462
|
+
separate identities; D1 retries create a new snapshot and do not reuse or
|
|
463
|
+
repeat the previous System 1 evaluation.
|
|
464
|
+
|
|
465
|
+
The state carries a redacted task, relative scope/paths, up to 40 structured
|
|
466
|
+
kinds/outcomes/repeat counts, rule facts and coverage, not raw arguments,
|
|
467
|
+
commands, edit bodies or outputs. This limit applies to System 1 only: the
|
|
468
|
+
existing parallel LLM judge prompt contains the original task, scope and a
|
|
469
|
+
recent trail with up to 120 characters of raw tool arguments per call. Use
|
|
470
|
+
only reviewed nonsecret pilot inputs; manual review does not rule out
|
|
471
|
+
unexpected agent actions. The native spawn boundary removes
|
|
472
|
+
`TYPESAFE_API_KEY` after env overrides. This cannot prevent file reads or
|
|
473
|
+
requests from other launchers. The append-only session watchdog trace stores
|
|
474
|
+
only safe metadata, with explicit unknown usage and interrupted readback.
|
|
475
|
+
The below-chat Fleet strip and `/af-agents` owner detail share a projection;
|
|
476
|
+
`/af-watchdog` shows readiness/active blocking, `/af-hub-report` separates
|
|
477
|
+
watchdog checks, S1 evaluations and LLM attempts, and `/af-audit` lists safe
|
|
478
|
+
read-only lifecycle outcomes. UI/trace failure does not change judgment.
|
|
479
|
+
|
|
480
|
+
`watchdog-system1: active` explicitly opts into an **uncalibrated experimental**
|
|
481
|
+
shortcut available in installed workspaces: only advisory `scope` may skip LLM
|
|
482
|
+
when Jev `jev-1.13.0` reports provider on-track with confidence and on-track
|
|
483
|
+
distribution ≥0.95 and all three contradiction probabilities ≤0.05. Terminal
|
|
484
|
+
rules always use the LLM; System 1 cannot stop a child. The watchdog status
|
|
485
|
+
labels the mode `experimental: scope only; G2 not validated`; default remains
|
|
486
|
+
off and production approved profiles remain empty. Human snapshot labels,
|
|
487
|
+
session-separated held-out measurement and independent maintainer G2 approval
|
|
488
|
+
are still required before calling this calibrated or expanding its authority. Offline tests and installed-package checks do not
|
|
489
|
+
constitute a live pilot (G1) or active approval (G2). Roll back with
|
|
490
|
+
`watchdog-system1: off` and restart Hub; cancel the current run if needed.
|
|
491
|
+
|
|
492
|
+
### Experimental System 1 foundation
|
|
493
|
+
|
|
494
|
+
System 1 is a shared Fleet library for bounded structured judgments, not a Pi
|
|
495
|
+
model and not a workflow stage. Its provider-neutral contract exposes
|
|
496
|
+
`choice`, `predicate`, and `ordinal` questions with explicit `ok`, `skipped`,
|
|
497
|
+
`unavailable`, `unsupported`, and `cancelled` outcomes. A valid judgment never
|
|
498
|
+
grants action authority. The contract retains distributions, predicate
|
|
499
|
+
probabilities, and provider confidence when supplied and required, but never
|
|
500
|
+
invents missing uncertainty or treats provider confidence as universal
|
|
501
|
+
calibration.
|
|
502
|
+
|
|
503
|
+
The experimental `system1` feature must be named explicitly in the human-owned
|
|
504
|
+
`.ai/agent-fleet.json`; automatic Full excludes it. Provider configuration is a
|
|
505
|
+
separate human-owned `.ai/system1.json` with exactly this version-1 contract:
|
|
506
|
+
|
|
507
|
+
```json
|
|
508
|
+
{
|
|
509
|
+
"version": 1,
|
|
510
|
+
"mode": "auto",
|
|
511
|
+
"provider": "typesafe",
|
|
512
|
+
"model": "jev-1.13.0",
|
|
513
|
+
"apiKeyEnv": "TYPESAFE_API_KEY"
|
|
514
|
+
}
|
|
515
|
+
```
|
|
516
|
+
|
|
517
|
+
Selection, valid `mode: "auto"` configuration, and a nonempty key in the
|
|
518
|
+
caller's environment are all required. `mode: "off"` wins, and key presence by
|
|
519
|
+
itself never activates the service. The runtime and imports do not load `.env`
|
|
520
|
+
or mutate global environment. Managed `just` launches may load the workspace
|
|
521
|
+
root `.env`; direct Node launches must export or inject the key themselves.
|
|
522
|
+
|
|
523
|
+
The only phase-0 production adapter uses the fixed official TypeSafe endpoint
|
|
524
|
+
and pinned `jev-1.13.0` model. It has a 2,000 ms total deadline, including body
|
|
525
|
+
collection and at most one budget-fitting retry for 429/529, rejects redirects,
|
|
526
|
+
and bounds request and response bodies at 1 MiB without truncation. Cancellation
|
|
527
|
+
prevents retry and late-result use; a 401 latches that service instance. Normal
|
|
528
|
+
failures return structured, sanitized outcomes rather than raw response bodies.
|
|
529
|
+
There is no arbitrary endpoint, SDK dependency, Pi/local-model fallback, daemon,
|
|
530
|
+
or local-model installation.
|
|
531
|
+
|
|
532
|
+
Doctor reuses the shared configuration validator and is advisory, read-only,
|
|
533
|
+
and offline—even with `--fix`. It distinguishes an `.env` declaration from a
|
|
534
|
+
nonempty key in its own process but cannot prove API validity. The standalone
|
|
535
|
+
demo is also offline by default; only explicit `--live` sends its embedded
|
|
536
|
+
synthetic Bulgarian/English examples. Public setup and commands are documented
|
|
537
|
+
in [Install and lifecycle](npm-install.md#experimental-system-1-foundation).
|
|
538
|
+
|
|
539
|
+
This foundation has no Watchdog integration or other action consumer. It also
|
|
540
|
+
makes no child-environment isolation promise: existing Fleet children may
|
|
541
|
+
inherit caller environment. A future consumer must own field allowlisting,
|
|
542
|
+
credential filtering, policy, thresholds, and calibration for its provider,
|
|
543
|
+
model, question version, domain, and language. Synthetic success is not
|
|
544
|
+
Watchdog accuracy.
|
|
545
|
+
|
|
546
|
+
Evidence remains split by boundary. Offline contract and extracted-package
|
|
547
|
+
checks passed on Node 25.2.1. A real-provider smoke was not executed because
|
|
548
|
+
`TYPESAFE_API_KEY` was absent, packaged doctor execution on Node 18 remains
|
|
549
|
+
unverified because no Node 18 runtime was available, and final maintainer review
|
|
550
|
+
is pending. None of those open items is implied by fixtures or readiness output.
|
|
551
|
+
|
|
442
552
|
## Repository module map
|
|
443
553
|
|
|
444
554
|
### Agent Hub composition
|
|
@@ -451,7 +561,7 @@ agent-hub/
|
|
|
451
561
|
├── types.ts # shared Hub agent/state contracts
|
|
452
562
|
├── config/ # agent/frontmatter, teams, profiles, dispatch policy, overrides
|
|
453
563
|
├── context/ # state, budgets, assertions/artifacts, session-health factories
|
|
454
|
-
├── commands/ #
|
|
564
|
+
├── commands/ # 27 typed /af-* command registrars
|
|
455
565
|
├── tools/ # 16 tools plus dispatch/research execution orchestration
|
|
456
566
|
├── dispatch-core.ts # facade over native, coms, and observability dispatch
|
|
457
567
|
├── dispatch-*.ts # native preparation/spawn/completion and backend adapters
|
|
@@ -11,6 +11,12 @@ different readers and different lifetimes, so they are kept separate.
|
|
|
11
11
|
| `.ai/agent-fleet-setup.md` | humans — rendered from the state file, never parsed back | Rewritten on every setup apply |
|
|
12
12
|
| `.ai/agent-fleet-transaction.json` | the deterministic lifecycle (`setup`, `doctor --fix`) — crash-recovery journal for in-flight file transactions | Written during apply; recovered or discarded by setup/doctor; removed when the transaction commits or is cleaned up |
|
|
13
13
|
| `.ai/stt.json` *(optional)* | `pi-voice-stt` extension | Every pi session start, when the extension is installed |
|
|
14
|
+
| `.ai/system1.json` *(optional)* | System 1 shared runtime and doctor | When the experimental `system1` feature is explicitly selected |
|
|
15
|
+
|
|
16
|
+
The `.ai/system1.json` file is human-owned, non-secret provider configuration.
|
|
17
|
+
Setup prints its required shape but does not create or overwrite it. Its
|
|
18
|
+
`apiKeyEnv` field names a caller-environment variable; it never contains the
|
|
19
|
+
credential itself. See [System 1 configuration](#system-1-configuration).
|
|
14
20
|
|
|
15
21
|
The `.ai/stt.json` file is present only when the optional `pi-voice-stt` voice-dictation
|
|
16
22
|
extension has been configured (by deterministic setup or by hand). Like the overrides file it holds
|
|
@@ -122,6 +128,95 @@ operator work mode with `/af-work-mode operator` / `just fleet --work-mode opera
|
|
|
122
128
|
use `--agent-team <name>` or `--work-mode operator`. Explicit startup flags win over persisted state;
|
|
123
129
|
fix missing or renamed team/persona declarations before selecting them.
|
|
124
130
|
|
|
131
|
+
## System 1 configuration
|
|
132
|
+
|
|
133
|
+
System 1 is an experimental named feature and is excluded from automatic
|
|
134
|
+
Default/Full selection. Select it explicitly and persist that desired state when
|
|
135
|
+
needed:
|
|
136
|
+
|
|
137
|
+
```bash
|
|
138
|
+
npx @chankov/agent-fleet@latest setup \
|
|
139
|
+
--preset default --features system1 --save-desired --yes
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
Then create the human-owned `.ai/system1.json` with exactly these version-1
|
|
143
|
+
fields and values:
|
|
144
|
+
|
|
145
|
+
```json
|
|
146
|
+
{
|
|
147
|
+
"version": 1,
|
|
148
|
+
"mode": "auto",
|
|
149
|
+
"provider": "typesafe",
|
|
150
|
+
"model": "jev-1.13.0",
|
|
151
|
+
"apiKeyEnv": "TYPESAFE_API_KEY"
|
|
152
|
+
}
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
`mode: "off"` disables the service even when a key exists. Selection plus
|
|
156
|
+
`mode: "auto"` still requires the valid configuration and a nonempty
|
|
157
|
+
`TYPESAFE_API_KEY` in the caller environment. Key presence alone never enables
|
|
158
|
+
System 1. The runtime does not execute `.env`: the managed `just` launcher can
|
|
159
|
+
load the root `.env`, while a direct Node invocation must receive an exported or
|
|
160
|
+
otherwise injected variable.
|
|
161
|
+
|
|
162
|
+
`agent-fleet doctor` reads the desired state and configuration as data. Its
|
|
163
|
+
System 1 result is advisory and read-only, including with `--fix`; it performs
|
|
164
|
+
no provider request and does not validate the key. A declaration in `.env` is
|
|
165
|
+
reported separately from a value present in doctor's current environment.
|
|
166
|
+
|
|
167
|
+
The installed demo is offline unless `--live` is supplied. Both forms require a
|
|
168
|
+
Node runtime supporting `--experimental-strip-types`:
|
|
169
|
+
|
|
170
|
+
```bash
|
|
171
|
+
# Readiness only; no provider call.
|
|
172
|
+
node --experimental-strip-types --preserve-symlinks --preserve-symlinks-main \
|
|
173
|
+
.pi/harnesses/lib/system1/demo.ts
|
|
174
|
+
|
|
175
|
+
# Explicit live request using only embedded synthetic Bulgarian/English data.
|
|
176
|
+
node --experimental-strip-types --preserve-symlinks --preserve-symlinks-main \
|
|
177
|
+
.pi/harnesses/lib/system1/demo.ts --live
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
The only phase-0 production provider/model is TypeSafe Jev `jev-1.13.0` at its
|
|
181
|
+
fixed official endpoint. No local model is installed and no fallback model is
|
|
182
|
+
selected. Outputs preserve available uncertainty but do not establish truth,
|
|
183
|
+
action authority, or calibration for a particular domain/language. The native specialist drift watchdog has a separate **consumer opt-in**:
|
|
184
|
+
`watchdog-system1: off|shadow|active` in `## agent-hub` (default `off`).
|
|
185
|
+
It also requires an armed watchdog, explicit feature selection, valid shared
|
|
186
|
+
configuration and a key. `off` makes no System 1 evaluation. `shadow` runs the
|
|
187
|
+
LLM judge immediately and System 1 in parallel; only the LLM can stop a child.
|
|
188
|
+
`active` is an **uncalibrated, explicitly opted-in experiment**: only the
|
|
189
|
+
advisory `scope` rule may skip LLM when Jev `jev-1.13.0` returns provider
|
|
190
|
+
`on_track` with confidence and on-track distribution ≥0.95 and all three
|
|
191
|
+
contradiction probabilities ≤0.05. Terminal `loop`, `failures`, and `toolcap`
|
|
192
|
+
always use LLM. `/af-watchdog` labels this `experimental: scope only; G2 not
|
|
193
|
+
validated`. This can miss a scope advisory; it is not G2 approval. Missing or
|
|
194
|
+
mismatched provider/config returns to LLM; default consumer mode remains off. Restart Hub to apply a
|
|
195
|
+
consumer mode/config snapshot; `/af-watchdog on|off|auto` changes Layer 1 arming,
|
|
196
|
+
not the System 1 consumer mode. For rollback set `watchdog-system1: off` for the
|
|
197
|
+
next session (cancel the current run if needed).
|
|
198
|
+
|
|
199
|
+
**System 1 outbound state** is limited to a redacted task, normalized relative
|
|
200
|
+
scope/paths, 40 structured tool events without commands, bodies, arguments or
|
|
201
|
+
outputs, rule facts, coverage and counters (32 KiB maximum). This does **not**
|
|
202
|
+
limit the existing parallel LLM judge prompt: it includes the original task,
|
|
203
|
+
scope and a recent trail with up to 120 characters of raw tool arguments per
|
|
204
|
+
call. Both paths can reveal data. For a future pilot, review the tasks, files
|
|
205
|
+
and likely tool arguments; never use client/production data or secrets. Manual
|
|
206
|
+
review cannot guarantee that an agent will not produce unexpected arguments.
|
|
207
|
+
The final native spawn env removes `TYPESAFE_API_KEY`; this does not protect
|
|
208
|
+
against file reads or other launchers. Trace (`<sessionDir>/artifacts/watchdog/events.jsonl`)
|
|
209
|
+
records only allowlisted metadata. `/af-watchdog` shows readiness/checks, the
|
|
210
|
+
strip under chat and `/af-agents` show owner badges and detail history;
|
|
211
|
+
`/af-hub-report` counts evaluations/LLM attempts separately; `/af-audit`
|
|
212
|
+
shows read-only decision status including `judge_unavailable`. Missing usage
|
|
213
|
+
is unknown, not zero. A failed judge gets one live, revalidated retry after 5 s
|
|
214
|
+
rather than the 90 s success cooldown. Offline report code and mock tests are
|
|
215
|
+
not a real shadow pilot. G1 requires manual/outbound review; G2 additionally
|
|
216
|
+
requires independent human labels identifying the snapshot **and LLM attempt**,
|
|
217
|
+
held-out session evaluation and an explicit maintainer-approved profile. Older
|
|
218
|
+
labels without an LLM attempt ID cannot qualify. No gate is inferred from doctor readiness.
|
|
219
|
+
|
|
125
220
|
## The overrides file — `.ai/agent-fleet-overrides.md`
|
|
126
221
|
|
|
127
222
|
Some skills and pi harnesses need facts specific to each project — where specs
|
|
@@ -220,6 +315,7 @@ targets an end-of-session compound pass writes lessons to.
|
|
|
220
315
|
| `agent-turn-timeout-s` | tier default (600/600/1800/1800) | Whole-run deadline, in seconds, for each spawned specialist, research helper, and nested delegate child (unlike `recon-search-timeout-s`, this bounds the entire run). On expiry the run terminates as `turn_timeout` (exit 124) with partial output preserved. Positive integer or `off` (stays at the tier). |
|
|
221
316
|
| `session-recycle-runs` | tier default (3/3/5/5) | Recycle a specialist's accumulated session (fresh spawn instead of `-c` resume) after this many resumed runs. Context is also always recycled at ≥60% measured context (input + cacheRead + cacheWrite). Positive integer or `off` (stays at the tier recycle count; context threshold still applies). |
|
|
222
317
|
| `watchdog` | `auto` | Drift watchdog default for dispatched specialists: `auto`/`on` arm the in-flight rules (out-of-scope writes, tool-call loops, repeated failures, tool-call cap) with LLM-judge escalation; `off` disarms. Orchestrator work mode auto-arms when the setting is `auto`/`on` and ignores a dispatch `watchdog: false`. Overridable live per hub (`/af-watchdog on\|off\|auto`) and per agent (`/af-watchdog <agent> on\|off\|clear`). A DRIFTING/STUCK verdict terminates the run as `drift_stop` (exit 125) with partial output preserved. |
|
|
318
|
+
| `watchdog-system1` | `off` | Native specialist consumer only: `off`, `shadow`, or explicitly opted-in experimental `active` for advisory `scope` only (0.95/0.05; not G2-validated). Requires the separate selected feature and shared config; no automatic outbound request from setup/doctor. |
|
|
223
319
|
| `watchdog-judge-model` | researcher persona's model | pi model spec for the one-shot drift judge (e.g. `openai-codex/gpt-5.3-codex-spark`). Falls back to the researcher persona's resolved model, then the dispatcher's. |
|
|
224
320
|
| `poll-panel` | none | Default panel name for `/af-poll` when `--panel` is omitted. Must match a panel in `.pi/agents/voices.yaml` when that file exists. Missing `--panel` and missing this key is a refusal. |
|
|
225
321
|
| `append-prompt` | none | Comma-separated repo-relative files appended to the system prompt of every dispatched persona. Listed files must exist. Enable the communication contract with `append-prompt: references/communication-contract.md`. |
|