@chankov/agent-fleet 2.0.12 → 2.0.13
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/flow.ts +5 -3
- package/.pi/agent-fleet/scripts/lib/flow-command.ts +9 -4
- package/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +3 -1
- package/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
- package/.pi/agents/model-profiles.yaml +80 -29
- package/.pi/agents/peers.yaml +18 -18
- package/.pi/agents/voices.yaml +2 -2
- package/.pi/harnesses/agent-hub/README.md +55 -4
- package/.pi/harnesses/agent-hub/commands/audit.ts +1 -1
- package/.pi/harnesses/agent-hub/commands/context.ts +1 -1
- package/.pi/harnesses/agent-hub/config/model-profiles.ts +1 -0
- package/.pi/harnesses/agent-hub/delegate.ts +5 -3
- package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +27 -2
- package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +29 -0
- package/.pi/harnesses/agent-hub/dispatch-native-types.ts +6 -0
- package/.pi/harnesses/agent-hub/index.ts +75 -40
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/policy/profile-activation.ts +2 -2
- package/.pi/harnesses/agent-hub/proactive-config.ts +40 -0
- package/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
- package/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
- package/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
- package/.pi/harnesses/agent-hub/proactive-local.ts +88 -0
- package/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
- package/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
- package/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
- package/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
- package/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
- package/.pi/harnesses/agent-hub/proactive-snapshot.ts +243 -0
- package/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
- package/.pi/harnesses/agent-hub/prompts/context.ts +2 -0
- package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +3 -0
- package/.pi/harnesses/agent-hub/research/runtime.ts +3 -1
- package/.pi/harnesses/agent-hub/research/spawn-run.ts +4 -1
- package/.pi/harnesses/agent-hub/return-extract.js +1 -1
- package/.pi/harnesses/agent-hub/session-audit.ts +6 -5
- package/.pi/harnesses/agent-hub/system1-activity.ts +67 -0
- package/.pi/harnesses/agent-hub/system1-report.ts +142 -1
- package/.pi/harnesses/agent-hub/system1-runtime.ts +3 -0
- package/.pi/harnesses/agent-hub/tools/run-flow.ts +16 -2
- package/.pi/harnesses/agent-hub/ui/detail-panel.ts +26 -5
- package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +30 -5
- package/.pi/harnesses/agent-hub/ui/fleet-source.ts +7 -2
- package/.pi/harnesses/agent-hub/ui/grid.ts +12 -7
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/context-budget-child-prompt.ts +41 -2
- package/.pi/harnesses/lib/context-budget-hub-prompt.ts +4 -2
- package/.pi/harnesses/lib/fleet-dashboard-view.ts +14 -3
- package/.pi/harnesses/lib/fleet-detail-view.ts +68 -7
- package/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.pi/harnesses/lib/fleet-strip-view.ts +44 -9
- package/.pi/prompts/af-setup-rules.md +20 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/README.md +347 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.13/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.13/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/fleet.ts +216 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/flow.ts +157 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/package-lock.json +35 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/package.json +9 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/team-up.ts +378 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
- package/.versions/2.0.13/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.13/.pi/agents/model-profiles.yaml +134 -0
- package/.versions/2.0.13/.pi/agents/peers.yaml +147 -0
- package/.versions/2.0.13/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.13/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.13/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.13/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.13/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.13/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.13/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.13/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.13/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.13/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.13/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.13/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.13/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.13/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.13/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.13/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.13/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.13/.pi/extensions/package.json +9 -0
- package/.versions/2.0.13/.pi/extensions/pi-voice-stt/README.md +224 -0
- package/.versions/2.0.13/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.13/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.13/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.13/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.13/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.13/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/README.md +1360 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/acceptance.ts +199 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/context.ts +45 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/recover.ts +52 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/config/agents.ts +178 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/config/overrides.ts +160 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/context/budgets.ts +204 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/context-window.js +108 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/delegate.ts +467 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-complete.ts +169 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +248 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +231 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-types.ts +257 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native.ts +226 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/fixtures/registration-surface.json +61 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/helpers.ts +270 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/index.ts +2336 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/input/completions.ts +82 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +125 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/no-progress.ts +359 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/work-mode.ts +126 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-config.ts +40 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-local.ts +88 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-snapshot.ts +243 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/context.ts +53 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/fragments.ts +118 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/system-prompt.ts +115 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/reconcile.ts +26 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/recover-policy.ts +27 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/recover-state.ts +104 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/recovery-contract.ts +80 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/research/runtime.ts +195 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/research/spawn-run.ts +174 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/return-contract.js +327 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/return-extract.js +77 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/review-findings.js +104 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/run-budget.js +542 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/run-namespace.js +93 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/scope-gate.js +123 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/session-audit.ts +227 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/spawn.ts +526 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/system1-activity.ts +510 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/system1-report.ts +225 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/system1-runtime.ts +276 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/timeline.ts +72 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/action-executors.ts +185 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/context.ts +142 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +498 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/tsconfig.json +22 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/types.ts +66 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +124 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-source.ts +175 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/work-mode.ts +173 -0
- package/.versions/2.0.13/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
- package/.versions/2.0.13/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.13/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.13/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.13/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.13/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
- package/.versions/2.0.13/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.13/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.13/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.13/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.13/.pi/harnesses/damage-control-continue/README.md +135 -0
- package/.versions/2.0.13/.pi/harnesses/damage-control-continue/index.ts +550 -0
- package/.versions/2.0.13/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.13/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.13/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
- package/.versions/2.0.13/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.13/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.13/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.13/.pi/harnesses/lib/context-budget-child-prompt.ts +219 -0
- package/.versions/2.0.13/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
- package/.versions/2.0.13/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.13/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.13/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.13/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fleet-dashboard-view.ts +147 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fleet-read-model.ts +536 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
- package/.versions/2.0.13/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.13/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.13/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.13/.pi/harnesses/lib/spawned-peers.js +191 -0
- package/.versions/2.0.13/.pi/harnesses/lib/system1/config.js +61 -0
- package/.versions/2.0.13/.pi/harnesses/lib/system1/contracts.ts +152 -0
- package/.versions/2.0.13/.pi/harnesses/lib/system1/demo.ts +106 -0
- package/.versions/2.0.13/.pi/harnesses/lib/system1/jev.ts +503 -0
- package/.versions/2.0.13/.pi/harnesses/lib/system1/service.ts +245 -0
- package/.versions/2.0.13/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.13/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.13/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.13/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.13/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.13/.pi/prompts/af-constraints.md +31 -0
- package/.versions/2.0.13/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.13/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.13/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.13/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.13/.pi/prompts/af-setup-rules.md +20 -0
- package/.versions/2.0.13/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.13/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.13/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.13/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.13/.version +1 -0
- package/.versions/2.0.13/agents/architect.md +24 -0
- package/.versions/2.0.13/agents/bowser.md +28 -0
- package/.versions/2.0.13/agents/builder.md +55 -0
- package/.versions/2.0.13/agents/code-reviewer.md +209 -0
- package/.versions/2.0.13/agents/deep-researcher.md +32 -0
- package/.versions/2.0.13/agents/documenter.md +22 -0
- package/.versions/2.0.13/agents/orchestrator.md +22 -0
- package/.versions/2.0.13/agents/plan-reviewer.md +83 -0
- package/.versions/2.0.13/agents/planner.md +105 -0
- package/.versions/2.0.13/agents/releaser.md +24 -0
- package/.versions/2.0.13/agents/researcher.md +30 -0
- package/.versions/2.0.13/agents/security-auditor.md +167 -0
- package/.versions/2.0.13/agents/test-engineer.md +153 -0
- package/.versions/2.0.13/agents/web-debugger.md +44 -0
- package/.versions/2.0.13/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.13/bin/catalog/harness-runtime-closure.json +73 -0
- package/.versions/2.0.13/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.13/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.13/docs/ARCHITECTURE.md +753 -0
- package/.versions/2.0.13/docs/agent-fleet-setup.md +900 -0
- package/.versions/2.0.13/docs/claude-code-coms-bridge.md +134 -0
- package/.versions/2.0.13/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.13/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.13/docs/getting-started.md +126 -0
- package/.versions/2.0.13/docs/npm-install.md +468 -0
- package/.versions/2.0.13/docs/pi-extensions.md +454 -0
- package/.versions/2.0.13/docs/pi-setup.md +92 -0
- package/.versions/2.0.13/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.13/install-manifest.json +3175 -0
- package/.versions/2.0.13/justfile +247 -0
- package/.versions/2.0.13/manifest-meta.json +1057 -0
- package/.versions/2.0.13/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.13/references/communication-contract.md +26 -0
- package/.versions/2.0.13/references/definition-of-done.md +67 -0
- package/.versions/2.0.13/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.13/references/observability-checklist.md +92 -0
- package/.versions/2.0.13/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.13/references/performance-checklist.md +236 -0
- package/.versions/2.0.13/references/prompting-patterns.md +380 -0
- package/.versions/2.0.13/references/security-checklist.md +245 -0
- package/.versions/2.0.13/references/testing-patterns.md +235 -0
- package/.versions/2.0.13/references/workflow-authoring.md +304 -0
- package/.versions/2.0.13/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.13/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.13/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.13/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.13/skills/constraint-driven-development/SKILL.md +338 -0
- package/.versions/2.0.13/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.13/skills/context-engineering/SKILL.md +341 -0
- package/.versions/2.0.13/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.13/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.13/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.13/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.13/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.13/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.13/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.13/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.13/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.13/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.13/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.13/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.13/skills/incremental-implementation/SKILL.md +302 -0
- package/.versions/2.0.13/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.13/skills/orchestration-verification/SKILL.md +182 -0
- package/.versions/2.0.13/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.13/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.13/skills/planning-and-task-breakdown/SKILL.md +289 -0
- package/.versions/2.0.13/skills/repository-ai-setup/SKILL.md +117 -0
- package/.versions/2.0.13/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
- package/.versions/2.0.13/skills/repository-ai-setup/references/apply-contract.md +74 -0
- package/.versions/2.0.13/skills/repository-ai-setup/references/provenance-template.md +16 -0
- package/.versions/2.0.13/skills/repository-ai-setup/references/setup-flow.md +108 -0
- package/.versions/2.0.13/skills/repository-ai-setup/references/verify-setup.md +20 -0
- package/.versions/2.0.13/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.13/skills/spec-driven-development/SKILL.md +295 -0
- package/.versions/2.0.13/skills/using-agent-skills/SKILL.md +198 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/README.md +430 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
- package/.versions/2.0.13/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
- package/CHANGELOG.md +10 -0
- package/README.md +3 -3
- package/agents/architect.md +2 -3
- package/agents/bowser.md +2 -2
- package/agents/builder.md +2 -3
- package/agents/code-reviewer.md +7 -8
- package/agents/deep-researcher.md +3 -4
- package/agents/documenter.md +2 -3
- package/agents/orchestrator.md +2 -3
- package/agents/plan-reviewer.md +5 -6
- package/agents/planner.md +5 -6
- package/agents/releaser.md +2 -3
- package/agents/researcher.md +4 -5
- package/agents/security-auditor.md +6 -7
- package/agents/test-engineer.md +3 -4
- package/agents/web-debugger.md +3 -3
- package/agents/web-performance-auditor.md +3 -3
- package/bin/catalog/harness-runtime-closure.json +30 -18
- package/bin/cli.js +47 -1
- package/bin/lib/apply.js +16 -0
- package/bin/lib/overrides.js +37 -1
- package/bin/lib/project-provenance.js +119 -0
- package/bin/lib/scan.js +1 -1
- package/bin/lib/transaction.js +1 -1
- package/bin/lib/validate-overrides.js +37 -3
- package/catalog/agent-prompts/README.md +12 -0
- package/catalog/agent-prompts/architecture-decision-author.md +24 -0
- package/catalog/agent-prompts/requirements-author.md +21 -0
- package/catalog/commands/README.md +13 -0
- package/catalog/commands/assess-change-impact.md +19 -0
- package/catalog/commands/audit-documentation.md +19 -0
- package/catalog/rules/README.md +33 -0
- package/catalog/rules/ai/policy-authoring.md +22 -0
- package/catalog/rules/architecture/behavior-preserving-refactoring.md +25 -0
- package/catalog/rules/architecture/public-contracts.md +22 -0
- package/catalog/rules/architecture/repository-boundaries.md +21 -0
- package/catalog/rules/architecture/structural-change-registration.md +25 -0
- package/catalog/rules/backend/notification-date-time.md +25 -0
- package/catalog/rules/bundles/README.md +16 -0
- package/catalog/rules/data/enum-semantics.md +25 -0
- package/catalog/rules/data/mixed-ownership-data.md +22 -0
- package/catalog/rules/data/reporting-queries.md +34 -0
- package/catalog/rules/docs/docs-maintenance.md +25 -0
- package/catalog/rules/frameworks/vue.md +25 -0
- package/catalog/rules/frontend/async-ui-states.md +26 -0
- package/catalog/rules/frontend/established-ui-primitives.md +25 -0
- package/catalog/rules/frontend/form-validation.md +26 -0
- package/catalog/rules/frontend/navigation-contracts.md +25 -0
- package/catalog/rules/languages/csharp.md +25 -0
- package/catalog/rules/languages/javascript.md +25 -0
- package/catalog/rules/languages/sql.md +24 -0
- package/catalog/rules/security/authorization-before-effects.md +26 -0
- package/catalog/rules/security/diagnostic-data-safety.md +22 -0
- package/catalog/rules/security/response-data-minimization.md +25 -0
- package/catalog/rules/security/trusted-tenant-scope.md +26 -0
- package/catalog/rules/testing/shared-package-consumers.md +25 -0
- package/catalog/rules/testing/verification-conventions.md +24 -0
- package/docs/ARCHITECTURE.md +50 -2
- package/docs/agent-fleet-setup.md +246 -28
- package/docs/codex-session-bridge.md +1 -1
- package/docs/pi-extensions.md +10 -5
- package/docs/workflows.md +4 -3
- package/install-manifest.json +125 -3
- package/manifest-meta.json +77 -15
- package/package.json +5 -3
- package/skills/repository-ai-setup/SKILL.md +117 -0
- package/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
- package/skills/repository-ai-setup/references/apply-contract.md +74 -0
- package/skills/repository-ai-setup/references/provenance-template.md +16 -0
- package/skills/repository-ai-setup/references/setup-flow.md +108 -0
- package/skills/repository-ai-setup/references/verify-setup.md +20 -0
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -47,7 +47,7 @@ not a session execution mode.
|
|
|
47
47
|
|
|
48
48
|
All Hub-owned slash commands remain registered in both work modes. Capability packs are resolved automatically from explicit task intent, work mode, tier, pending work, and compaction state—there is no activation command. Runtime **readiness** (a coms or Herdr connection) is not model-visible capability: ready-but-unrequested peer/workspace packs remain inactive. Ambiguous fleet, peer, and workspace requests are provisionally visible but require one `ask_user` confirmation before their first side effect; a rejection removes the provisional pack. Task packs persist across follow-ups and reset only through `set_task_tier(new_task: true)`, while mandatory work mode and pending-operation leases remain.
|
|
49
49
|
|
|
50
|
-
`/af-context` is a standalone, read-only full-screen budget diagnostic; it separates stable prompt cost, volatile state, active schemas, and zero-cost inactive/loaded-excluded inputs. Provider totals and cache read/write fields are authoritative where Pi supplies them; it never fabricates provider usage or combines capacity percentages across Hub, child, and peer planes. `/af-audit` is a separate read-only session audit over existing runtime-owned records: it reports allowlisted T1 recovery categories, T2 result states, T3 protocol failures, and T8 permission correlations while keeping root, child, compaction snapshot, and repeated-record identities distinct. It never copies prompts, model text, tool payloads, environment values, or transcript content, and unavailable evidence stays explicit rather than becoming a zero count. Managed specialists and research children use explicit replacement prompts/context manifests with selected persona, policy, and skill paths instead of inherited global skills/context files. Runtime gates control whether an action can proceed: without coms, Herdr, a visible target, or an active roster, the corresponding command refuses with an actionable message rather than disappearing. `--browser` and `--all-extensions` expand the captured operator surface only when those optional extensions are installed.
|
|
50
|
+
`/af-context` is a standalone, read-only full-screen budget diagnostic; it separates stable prompt cost, volatile state, active schemas, and zero-cost inactive/loaded-excluded inputs. Provider totals and cache read/write fields are authoritative where Pi supplies them; it never fabricates provider usage or combines capacity percentages across Hub, child, and peer planes. `/af-audit` is a separate read-only session audit over existing runtime-owned records: it reports allowlisted T1 recovery categories, T2 result states, T3 protocol failures, and T8 permission correlations while keeping root, child, compaction snapshot, and repeated-record identities distinct. It never copies prompts, model text, tool payloads, environment values, or transcript content, and unavailable evidence stays explicit rather than becoming a zero count. Managed specialists and research children use explicit replacement prompts/context manifests with selected persona, policy, and skill paths instead of inherited global skills/context files. Configured project rule and documentation pointers are rendered into the Hub prompt in both work modes and into native specialist, nested delegate, research, and coms handoffs. Files are read directly; folders are resolved index-first, with recursive rule discovery only when no index exists. The prompt carries pointers and selection instructions rather than bulk-injecting rule bodies, and the Hub ledger attributes that text as `hub/policy/project`. Runtime gates control whether an action can proceed: without coms, Herdr, a visible target, or an active roster, the corresponding command refuses with an actionable message rather than disappearing. `--browser` and `--all-extensions` expand the captured operator surface only when those optional extensions are installed.
|
|
51
51
|
|
|
52
52
|
T12 diagnostics have been withdrawn by user decision; there is no command, runner, or replacement entry point. Historical results and accounting remain unchanged. `diagnostic-series-budget.ts` retains the shared v2 ledger, stage/per-unit ceilings, conservative input preflight, migration refusal for ambiguous history, ownership locks, and cancellation fences used by benchmark consumers. `diagnostic-probe-extension.ts` is now a side-effect-free compatibility library exposing only provider/API output-cap mapping, its types, and the transport refusal exit constant. It preserves the reviewed 2048 cap and rejects unsupported payload semantics; it does not register an extension or tool. Existing sessions must be reloaded after updating. The installer retires unchanged managed command/runner files; user-modified obsolete files are preserved and reported for manual review, never deleted automatically. Such retained files are not imported by the current Hub.
|
|
53
53
|
|
|
@@ -489,6 +489,54 @@ are still required before calling this calibrated or expanding its authority. Of
|
|
|
489
489
|
constitute a live pilot (G1) or active approval (G2). Roll back with
|
|
490
490
|
`watchdog-system1: off` and restart Hub; cancel the current run if needed.
|
|
491
491
|
|
|
492
|
+
### Proactive turn review (separate opt-in consumer)
|
|
493
|
+
|
|
494
|
+
The Hub's `proactive-*` modules compose a separate, off-by-default consumer of the
|
|
495
|
+
existing shared System 1 library and its provider/key; they do not create another
|
|
496
|
+
provider owner or change watchdog authority. A human-owned per-repository
|
|
497
|
+
`.ai/proactive-review.json` selects `off`, `shadow`, or `advisory` and exact
|
|
498
|
+
repository-relative include scope. Missing/off means **zero proactive capture,
|
|
499
|
+
inference, and feedback**. Enabled config with `remoteContext: "disabled"` is
|
|
500
|
+
local-only: bounded source/rule capture and reviewed local validators may run,
|
|
501
|
+
but no semantic provider assessment. `selected-excerpts` separately permits
|
|
502
|
+
bounded selected source/assistant excerpts to the shared System 1 service when
|
|
503
|
+
it is ready; shadow records findings without delivery, advisory may deliver
|
|
504
|
+
feedback at the next *already-occurring* context hook for the same owner,
|
|
505
|
+
attempt, task, and bound rule/source revision. It never creates a turn, fixes
|
|
506
|
+
code, terminates work, changes acceptance gates, or suppresses the watchdog.
|
|
507
|
+
No activation, outbound transmission, or remote repository authorization is
|
|
508
|
+
conferred by installing this code or reading this documentation.
|
|
509
|
+
|
|
510
|
+
At `turn_start`/`turn_end`, Hub and supported native Pi specialists bind the
|
|
511
|
+
explicit task/plan and session rule catalog, collect bounded immutable
|
|
512
|
+
before/after worktree and text evidence, and retain private snapshots separately
|
|
513
|
+
from metadata-only finding/report projections. Source-backed rules come from
|
|
514
|
+
`rules:` folders in `## agent-hub` (legacy `## agent-team`), with index-first
|
|
515
|
+
Markdown discovery, explicit linked sections, and bounded fallback; discovery
|
|
516
|
+
is read-only and never executes rule instructions. Rule identity includes path,
|
|
517
|
+
heading occurrence and hash. Incomplete discovery, unselected sections,
|
|
518
|
+
unsupported Markdown, missing plan (`task_only`), concurrent edits, and
|
|
519
|
+
changed source stays partial, unsupported, uncertain or stale—not
|
|
520
|
+
confirmed passes. Rule references use the session-bound revision: on-disk rule
|
|
521
|
+
edits do not themselves stale a finding, and a restart is required to adopt them. Only explicitly reviewed bindings support deterministic
|
|
522
|
+
local link-form and new-file-placement checks; model findings remain
|
|
523
|
+
suspicions, not validated bugs. Rules are **bound per session**: editing a rule
|
|
524
|
+
in a running session does not reload it; restart to adopt edits. Research
|
|
525
|
+
helpers, nested delegates, coms peers and Hermes are not instrumented by this
|
|
526
|
+
consumer. Native observer hooks/integration were checked with repo-local Pi
|
|
527
|
+
0.84.2; Node 18 compatibility concerns the extracted installer CLI/doctor,
|
|
528
|
+
not running the TypeScript observer under Node 18.
|
|
529
|
+
|
|
530
|
+
Limits and exclusions, exact config, local report/labels usage, and consent
|
|
531
|
+
sequence are in [Project Files — Proactive turn review](agent-fleet-setup.md#proactive-turn-review-experimental).
|
|
532
|
+
Offline/installed tests and C5 operator visibility establish neither live-pilot
|
|
533
|
+
utility nor universal correctness. The finding-label source fix passed final independent source/docs review;
|
|
534
|
+
this establishes offline/package readiness, not human-labelled semantic acceptance. Only retained finding keys
|
|
535
|
+
are exposed for human labels: checked-clear units lack an operator-accessible
|
|
536
|
+
key, so miss/true-negative labeling and full recall evaluation are not operational.
|
|
537
|
+
C7 human acceptance and any release/deployment remain separate. Current caveats include
|
|
538
|
+
unknown native delivery without a receipt and a rare async-close error risk.
|
|
539
|
+
|
|
492
540
|
### Experimental System 1 foundation
|
|
493
541
|
|
|
494
542
|
System 1 is a shared Fleet library for bounded structured judgments, not a Pi
|
|
@@ -620,7 +668,7 @@ packages/hermes-bridge/ # future Hermes integration package
|
|
|
620
668
|
|
|
621
669
|
## Design rules
|
|
622
670
|
|
|
623
|
-
- **Workflow engine remains single-sourced.** `just flow` owns deterministic phase order, retries, executable gates, post-hoc writes enforcement, and one flow acceptance decision. It uses the clean spawn/context seams and keeps its
|
|
671
|
+
- **Workflow engine remains single-sourced.** `just flow` owns deterministic phase order, retries, executable gates, post-hoc writes enforcement, and one flow acceptance decision. It uses the clean spawn/context seams and keeps its clean-tree guard while staying on the current branch by default; creating a flow branch requires explicit `--branch`; normal traces live under `.pi/flow-sessions/`. Explicit flow branches retain source/result metadata, while reserved `cleanup` and `merge` delegate safe removal and squash integration to Worktrunk. The initial Hub `run_flow` adapter calls the same exported dispatcher directly and permits only read-only `scout`: it runs in a stable detached snapshot with no flow branch, stores trace/manifest in the current Hub session, and has one Hub budget/cancellation owner. Snapshot overlay operations validate plain parents before mutation and never follow a HEAD symlink leaf. The native process and descendants use `confineNativeChild`, with only the session-owned phase directory writable; the actual `read`/`grep`/`find`/`ls` data paths are separately limited to the snapshot while damage-control remains loaded. Runtime/model libraries and provider configuration remain readable for Pi startup, so this is intentionally not a global no-read claim. Duplicate identity is idempotent; stale/busy calls are uncharged. All setup/result exceptions settle as structured failures, release active ownership, and preserve honest charged/started state. Owned scout snapshots are cleaned on settlement, with visible cleanup status/errors; traces and explicit branches are retained. Flow acceptance never promotes parent assertions or closes T11 obligations. Writable/committing flows remain outside this adapter pending a separate review.
|
|
624
672
|
- **Thin dispatcher context.** Nothing lands persistently in the dispatcher's
|
|
625
673
|
context if it can live on disk or in a one-line status. Research findings,
|
|
626
674
|
the Verification Contract ledger, and team snapshots are all disk-first.
|
|
@@ -12,6 +12,7 @@ different readers and different lifetimes, so they are kept separate.
|
|
|
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
14
|
| `.ai/system1.json` *(optional)* | System 1 shared runtime and doctor | When the experimental `system1` feature is explicitly selected |
|
|
15
|
+
| `.ai/proactive-review.json` *(optional)* | Hub proactive turn review consumer | At Hub session start; missing means off |
|
|
15
16
|
|
|
16
17
|
The `.ai/system1.json` file is human-owned, non-secret provider configuration.
|
|
17
18
|
Setup prints its required shape but does not create or overwrite it. Its
|
|
@@ -217,6 +218,227 @@ requires independent human labels identifying the snapshot **and LLM attempt**,
|
|
|
217
218
|
held-out session evaluation and an explicit maintainer-approved profile. Older
|
|
218
219
|
labels without an LLM attempt ID cannot qualify. No gate is inferred from doctor readiness.
|
|
219
220
|
|
|
221
|
+
## Proactive turn review (experimental)
|
|
222
|
+
|
|
223
|
+
This is a **separate per-repository opt-in**, not a new provider or an installer
|
|
224
|
+
feature flag. The Hub/native consumer uses the existing shared System 1 service
|
|
225
|
+
(`system1` feature, `.ai/system1.json`, caller-owned key) only when selected
|
|
226
|
+
excerpts are explicitly permitted and the service is ready. Its config is
|
|
227
|
+
human-owned `.ai/proactive-review.json`; setup/doctor do not create or activate
|
|
228
|
+
it. Missing config or valid `{"version":1,"mode":"off"}` causes **zero
|
|
229
|
+
proactive capture, inference, and feedback**. Invalid configuration fails closed.
|
|
230
|
+
Nothing here authorizes a live pilot, client repository, ringithub, provider
|
|
231
|
+
request, release, deployment or active configuration change.
|
|
232
|
+
|
|
233
|
+
Modes: `shadow` records bounded local evidence/findings without feedback;
|
|
234
|
+
`advisory` additionally offers bounded feedback at the next **natural** turn,
|
|
235
|
+
never starting a turn itself. With `remoteContext: "disabled"` (the default),
|
|
236
|
+
either enabled mode is **local-only**: source-bound deterministic checks may
|
|
237
|
+
run, but no semantic model review; no finding does not mean reviewed. With
|
|
238
|
+
`remoteContext: "selected-excerpts"`, permitted included source/assistant
|
|
239
|
+
excerpts may be transmitted to the already configured System 1 provider for
|
|
240
|
+
semantic assessment. This is not a blanket secrecy guarantee: source is
|
|
241
|
+
selected within approved scope and bounded/excluded, but automatic comprehensive
|
|
242
|
+
redaction of unknown secrets is not established. Review the *exact outbound
|
|
243
|
+
payload* and scope before any real opt-in. No auto-fix, kill, blocking,
|
|
244
|
+
acceptance authority, watchdog override, or autonomous continuation follows a
|
|
245
|
+
finding. Feedback is restricted to the same owner/attempt/task and current
|
|
246
|
+
source hashes and the session-bound rule revision, once per finding revision, at an already-occurring context
|
|
247
|
+
hook; changed evidence is refused.
|
|
248
|
+
|
|
249
|
+
**Schema illustration only — NOT executed, NOT authorization or a recommended
|
|
250
|
+
repository scope:** after separate human approval of the exact repository,
|
|
251
|
+
paths, outbound categories, budget and payload, a human may choose values in
|
|
252
|
+
this shape; do not copy these example paths into active configuration:
|
|
253
|
+
|
|
254
|
+
```json
|
|
255
|
+
{
|
|
256
|
+
"version": 1,
|
|
257
|
+
"mode": "shadow",
|
|
258
|
+
"remoteContext": "selected-excerpts",
|
|
259
|
+
"include": ["src/**", "docs/**"],
|
|
260
|
+
"maxEvaluationsPerSession": 100
|
|
261
|
+
}
|
|
262
|
+
```
|
|
263
|
+
|
|
264
|
+
Only `version`, `mode`, `remoteContext`, `include`,
|
|
265
|
+
`maxEvaluationsPerSession`, `localBindings` are accepted. Version is `1`;
|
|
266
|
+
mode is `off|shadow|advisory`; remote context is
|
|
267
|
+
`disabled|selected-excerpts`. Enabled modes require a nonempty explicit
|
|
268
|
+
repository-relative `include` (≤32 distinct entries, ≤256 characters each;
|
|
269
|
+
no absolute/dot/traversal paths, hidden segments, backslashes, special
|
|
270
|
+
bracket/negation patterns or dependency/build/runtime directories). The
|
|
271
|
+
session evaluation budget is an integer 0–100, default 100 in enabled modes.
|
|
272
|
+
The optional `localBindings` (≤16) require reviewed source-bound Markdown
|
|
273
|
+
`rule` path/heading/positive occurrence/lowercase SHA-256 hash,
|
|
274
|
+
`applicability` paths and added/modified kinds, and explicit paths/legacy
|
|
275
|
+
exceptions; `new-file-placement` also needs an added-only prefix, while
|
|
276
|
+
`relative-markdown-links` checks link form/escape, **not target existence**.
|
|
277
|
+
These are not prose-rule compilation or a general Markdown/AST validator.
|
|
278
|
+
Off must not retain active includes, remote permission, bindings or explicit
|
|
279
|
+
nonzero budget: rollback uses the complete minimal off JSON above, then a
|
|
280
|
+
**new Hub session**. Cancel current work if immediate interruption is needed;
|
|
281
|
+
do not delete session evidence or user config as cleanup.
|
|
282
|
+
|
|
283
|
+
Rules come read-only from `rules:` roots in `## agent-hub` (legacy
|
|
284
|
+
`## agent-team`): index-first, literal Markdown links/references and bounded
|
|
285
|
+
recursive fallback. The catalog binds file/path, heading occurrence and hash
|
|
286
|
+
for the **session**; edits do not reload in-session, and a restart adopts them.
|
|
287
|
+
It cannot execute instructions in rules. Discovery has a 64-file/256 KiB
|
|
288
|
+
budget; selection at most 20 sections/32 KiB, with coverage gaps for missing,
|
|
289
|
+
unsafe, partial, unselected or unsupported sources. Only the explicit task
|
|
290
|
+
and explicitly supplied plan bind the review; absent plan is `task_only`, not
|
|
291
|
+
a search for the newest plan. Incomplete work, exceptions, parallel authorship
|
|
292
|
+
and same-turn rule edits can remain uncertain. No silence or skipped check is
|
|
293
|
+
proof of compliance. Hub and supported native specialists are covered;
|
|
294
|
+
research helpers, nested delegates, coms peers and Hermes are not.
|
|
295
|
+
|
|
296
|
+
Per turn: at most 20 source units, 256 KiB retained excerpts (64 KiB/file),
|
|
297
|
+
32 KiB evaluation state, 16 questions/batch, two calls/turn, one active
|
|
298
|
+
job/session, one pending/owner with backlog ≤8 and 5 s queue wait. Capture
|
|
299
|
+
phase has a 1 s deadline; evaluation job has a 2 s deadline. Feedback is
|
|
300
|
+
≤3 findings/1,500 characters; finding history/private snapshots are bounded
|
|
301
|
+
at 100, so readback/retention is **not** a complete session record. Captures
|
|
302
|
+
bind pre/post worktree bytes, hashes and offsets; private evidence can be
|
|
303
|
+
locally reopened with validated references, whereas trace/report summaries
|
|
304
|
+
contain metadata only. Exclude `.env`, credentials, `.git`, dependencies,
|
|
305
|
+
build/runtime/session/transcript trees, binaries and realpath escapes; never
|
|
306
|
+
assume redaction catches every secret. Review coverage can be `partial`, `not_checked`, `unsupported`, `stale`,
|
|
307
|
+
`unavailable` or `unknown` rather than a confirmed pass. Operator TUI/history retain a completed row briefly (10 s); metadata
|
|
308
|
+
readback persists within the bounded session record.
|
|
309
|
+
|
|
310
|
+
### Release readiness and evaluation limits
|
|
311
|
+
|
|
312
|
+
The opt-in runtime, native observer, local validators, advisory delivery, Fleet
|
|
313
|
+
history/evidence, reports and package installation are implemented and
|
|
314
|
+
independently reviewed. Offline integration uses repo-local Pi **0.84.2**;
|
|
315
|
+
Node 18 compatibility applies separately to the installed CLI/doctor, not the
|
|
316
|
+
Pi harness. Review history and evidence retain the dashboard's fixed-height
|
|
317
|
+
frame, including blank rows, rather than exposing dispatcher chat underneath.
|
|
318
|
+
|
|
319
|
+
A maintainer-authorized synthetic Jev smoke has verified real provider
|
|
320
|
+
communication and the evaluator path. It is **not** the planned 30-case
|
|
321
|
+
human-labelled semantic evaluation, nor evidence of general accuracy or recall.
|
|
322
|
+
That evaluation and final semantic acceptance remain outstanding; findings-only
|
|
323
|
+
label-key access also limits operational miss/true-negative evaluation.
|
|
324
|
+
|
|
325
|
+
A release installs the capability, **not its activation**. Setup does not create
|
|
326
|
+
`.ai/proactive-review.json`, and preserves an existing human-owned file. The
|
|
327
|
+
maintainer's active config and repo-specific rule catalog are not release
|
|
328
|
+
artifacts. Each target repository needs its own explicit scope, rules and
|
|
329
|
+
outbound-data consent. Configuration/rules are loaded at session start; start a
|
|
330
|
+
fresh Fleet session after changing them. When testing file placement, verify
|
|
331
|
+
that the file is really inside the configured repository include path, not a
|
|
332
|
+
session `artifacts/` directory with a similar relative suffix.
|
|
333
|
+
|
|
334
|
+
### Read-only reports and explicit human labels
|
|
335
|
+
|
|
336
|
+
`/af-hub-report` and `/af-audit` separate proactive and watchdog totals.
|
|
337
|
+
For measured comparison only, add `--labels /absolute/path/to/CURRENT_SESSION/artifacts/labels.json`
|
|
338
|
+
to **either** command. No default, file discovery, provider request or
|
|
339
|
+
automatic label inference occurs. The actual path must be an absolute regular
|
|
340
|
+
`.json` file below the *current* session's `artifacts/`, without symlink escape;
|
|
341
|
+
maximum 64 KiB and 320 labels. Only retained findings currently expose operator-readable label keys. In Fleet
|
|
342
|
+
Dashboard (**Alt+A**), open review history with **`p`**, select a finding with
|
|
343
|
+
**`n`**, then press **`e`** for its local captured evidence; alternatively open
|
|
344
|
+
the specialist detail, select a finding with **`n`**, and press **`e`**. Scroll
|
|
345
|
+
with ↑/↓ (or j/k), PgUp/PgDn, Home/End; Esc returns to the previous review-history or detail view. The evidence
|
|
346
|
+
view displays a JSON record with the exact `snapshotId`, slash-bearing catalog
|
|
347
|
+
`ruleId` (`path#heading@occurrence:hash`), session-bound `ruleHash`, and
|
|
348
|
+
`subject` for that finding. At narrow widths the JSON is wrapped into visual
|
|
349
|
+
chunks: remove one indentation column from each chunk and concatenate the
|
|
350
|
+
chunks to reconstruct the record. Unavailable evidence shows no template;
|
|
351
|
+
do not guess a key. Copy the reconstructed record into an explicit local
|
|
352
|
+
current-session artifacts `.json` array, leaving `expected` as `unknown` until
|
|
353
|
+
a human judges that finding (`violation` or `clean`). Never use raw
|
|
354
|
+
source/prompt payloads as label keys. This illustrative shape is not a
|
|
355
|
+
substitute for the evidence-view values:
|
|
356
|
+
|
|
357
|
+
```json
|
|
358
|
+
[
|
|
359
|
+
{
|
|
360
|
+
"snapshotId": "<actual lowercase 64-hex snapshot ID>",
|
|
361
|
+
"ruleId": "<actual evidence-view catalog rule ID, including path/slashes>",
|
|
362
|
+
"ruleHash": "<actual bound lowercase 64-hex rule hash>",
|
|
363
|
+
"subject": "src/example.ts",
|
|
364
|
+
"expected": "unknown"
|
|
365
|
+
}
|
|
366
|
+
]
|
|
367
|
+
```
|
|
368
|
+
|
|
369
|
+
Each object has **exactly** these five keys; `expected` is
|
|
370
|
+
`violation|clean|unknown`. Match snapshot, rule ID, session-bound rule hash and subject to retained
|
|
371
|
+
finding evidence; a valid unmatched label is `unchecked`, not a false
|
|
372
|
+
pass/miss. Report comparison can join checked-clear verdicts, but the operator
|
|
373
|
+
UI exposes keys only for retained findings, not checked-clear units. Human
|
|
374
|
+
miss/true-negative labels cannot currently be authored from this UI; absent
|
|
375
|
+
human labels remain `unknown`. This is a partial finding-backed workflow, not
|
|
376
|
+
fully operational misses or recall evaluation. Missing/invalid labels yield `unavailable` with null
|
|
377
|
+
measurement counts; empty valid array is not a precision/recall score.
|
|
378
|
+
Counts distinguish reviewed/partial/coverage-unknown/skipped, uncovered rules,
|
|
379
|
+
deterministic findings versus System 1 suspicions, unknown usage and unknown
|
|
380
|
+
native delivery (no receipt). Trace-only readback does not reconstruct missing
|
|
381
|
+
coverage or invent zeroes. Any precision or miss count describes only *labelled checked* evidence, not
|
|
382
|
+
unlabelled clear units or universal correctness.
|
|
383
|
+
|
|
384
|
+
### Offline installed-package runbook (not executed by this documentation change)
|
|
385
|
+
|
|
386
|
+
Use a fresh **temporary** directory/workspace, with Node supporting native
|
|
387
|
+
TypeScript for the observer, repo-local Pi 0.84.2, and existing dependencies;
|
|
388
|
+
Node 18 is checked separately for the extracted CLI. These are test-backed
|
|
389
|
+
instructions, **not** commands run by this documentation patch. From this
|
|
390
|
+
repository's root, the safest reproducible run is:
|
|
391
|
+
|
|
392
|
+
```sh
|
|
393
|
+
node --test .pi/agent-fleet/scripts/docs-links.test.mjs
|
|
394
|
+
# Supply an actual installed Node 18 executable; the test fails if unavailable.
|
|
395
|
+
AF_NODE18=/absolute/path/to/node18 node --test bin/test/proactive-installed.test.js
|
|
396
|
+
node --test --test-name-pattern='isolated tarball supports' bin/test/package-surfaces.test.js
|
|
397
|
+
```
|
|
398
|
+
|
|
399
|
+
The installed test packs with `npm pack --json --pack-destination <temp>`,
|
|
400
|
+
extracts with `tar -xzf <tarball> --strip-components=1 -C <temp>/package`,
|
|
401
|
+
and runs `node <temp>/package/bin/cli.js setup --workspace <temp>/installed
|
|
402
|
+
--preset default --features none --yes` under a scrubbed offline environment.
|
|
403
|
+
It checks the installed 12-file runtime closure and an offline fake-provider Pi
|
|
404
|
+
observer/capture, no auto `.ai/proactive-review.json` or proactive desired-state
|
|
405
|
+
key, preservation of a **test-only HUMAN fixture** across repeat setup and
|
|
406
|
+
`doctor`/`doctor --fix`, and extracted-CLI version/help/readonly doctor under
|
|
407
|
+
Node 18. Doctor may return 0 or findings exit 2. The smoke reuses existing
|
|
408
|
+
repository dependencies, not a fresh dependency install; its network guard is
|
|
409
|
+
limited and does not prove every step physically network-isolated. Do not
|
|
410
|
+
create the illustrative active config above in a real workspace while testing.
|
|
411
|
+
The operator must run the link test and installed test on the final changed
|
|
412
|
+
state; this document alone is not verification.
|
|
413
|
+
|
|
414
|
+
### Separate live pilot and acceptance
|
|
415
|
+
|
|
416
|
+
C5 operator visibility was human accepted, and the final post-fix source/docs
|
|
417
|
+
review accepted the C6 offline/package work. The later review-history overlay
|
|
418
|
+
fix is covered by fixed-frame and real Pi compositor regression tests; its
|
|
419
|
+
human visual retest is separate. Implemented/offline/installed evidence is not
|
|
420
|
+
live semantic accuracy. Explicit advisory activation in the maintainer's
|
|
421
|
+
repository and a synthetic Jev transport/evaluator smoke have occurred; neither
|
|
422
|
+
completes the planned human-labelled pilot or C7 semantic acceptance. For a new
|
|
423
|
+
repository, first review synthetic/offline evidence, then require **explicit
|
|
424
|
+
repo-specific shadow consent**, including exact include/exclusion paths,
|
|
425
|
+
reviewed bindings, session budget, outbound categories and representative
|
|
426
|
+
exact payload review; separate explicit consent is required for advisory.
|
|
427
|
+
There is no implied ringithub/customer repo authorization. A subsequent pilot
|
|
428
|
+
requires ≥30 **human-labelled** code/text assessments including ≥10 known
|
|
429
|
+
violations/deviations, BG/EN, legacy/new code, interim work, exceptions,
|
|
430
|
+
text-only and no-plan cases; manually review selector omissions and uncertain
|
|
431
|
+
cases. Measure finding-backed labelled precision and false alarms alongside coverage,
|
|
432
|
+
capture overhead, model p50/p95 latency, queue drops and known/unknown usage.
|
|
433
|
+
Miss/true-negative human-label keys for checked-clear units are not exposed;
|
|
434
|
+
report miss joins from synthetic/offline tests do not establish operational
|
|
435
|
+
miss/recall measurement. Record that gap explicitly in any pilot assessment
|
|
436
|
+
rather than treating unknown labels as negatives. Synthetic/offline success is not semantic or live
|
|
437
|
+
proof; no automatic mode promotion or invented accuracy threshold. C7 asks
|
|
438
|
+
the maintainer to accept limitations/evidence and explicitly choose each
|
|
439
|
+
repository's off/shadow/advisory state. No release or deployment follows from
|
|
440
|
+
these docs or C6.
|
|
441
|
+
|
|
220
442
|
## The overrides file — `.ai/agent-fleet-overrides.md`
|
|
221
443
|
|
|
222
444
|
Some skills and pi harnesses need facts specific to each project — where specs
|
|
@@ -236,6 +458,7 @@ it here, and the reader picks it up.
|
|
|
236
458
|
`.env`.
|
|
237
459
|
- If the file is absent, or a reader has no section in it, that reader uses its
|
|
238
460
|
built-in default.
|
|
461
|
+
- **Settings writer:** ordinary `agent-fleet setup` leaves non-empty overrides byte-identical. To add rule/doc roots explicitly, preview with `agent-fleet configure --rules .ai/rules --docs docs --dry-run --workspace <project>`; review `before`, `after`, and `expectedHash`, then apply with the same roots, `--expect-hash <expectedHash> --yes`. Omit a key to leave it unchanged. The CLI appends/deduplicates roots, keeps other sections/settings and the legacy `agent-team` section, and refuses duplicate/conflicting sections or keys for manual resolution. A changed setting takes effect in a new session; missing roots remain advisory. The interactive path is `/af-setup-rules` (the `repository-ai-setup` skill: discovery → proposal → grilling → diff → apply → verify); it hands accepted roots to this same CLI and never edits the file directly.
|
|
239
462
|
- **Validation.** Because an unknown section or key silently falls back to the
|
|
240
463
|
default, typos are invisible at runtime. `agent-fleet doctor` (and the
|
|
241
464
|
runtime's Agent Fleet doctor command) validates the file — unknown sections,
|
|
@@ -601,45 +824,40 @@ profile declares the whole execution model set independently of
|
|
|
601
824
|
`.ai/agent-fleet-overrides.md`:
|
|
602
825
|
|
|
603
826
|
```yaml
|
|
604
|
-
local-
|
|
827
|
+
local-full:
|
|
605
828
|
version: 2
|
|
606
829
|
defaults:
|
|
607
830
|
model: &qwen36 omlx/Qwen3.6-35B-A3B-4bit
|
|
608
831
|
thinking: off
|
|
609
832
|
allowed-models:
|
|
610
833
|
- *qwen36
|
|
611
|
-
- &qwen omlx/Qwen3.8-9B-heretic-uncensored-5bit-MLX
|
|
612
834
|
fallback: none
|
|
613
835
|
routing: native
|
|
614
836
|
dispatcher: *qwen36
|
|
615
837
|
agents:
|
|
616
|
-
|
|
617
|
-
# all other shipped personas inherit *qwen36 (see .pi/agents/model-profiles.yaml)
|
|
838
|
+
# Every shipped persona uses *qwen36 (see .pi/agents/model-profiles.yaml).
|
|
618
839
|
subagents:
|
|
619
|
-
|
|
620
|
-
docs: *qwen
|
|
621
|
-
plan-reviewer:
|
|
622
|
-
deps: *qwen
|
|
623
|
-
planner:
|
|
624
|
-
voice-2: *qwen
|
|
625
|
-
test-engineer:
|
|
626
|
-
conventions: *qwen
|
|
627
|
-
# recon, preflight, feasibility, scout, rules, sweeps, coverage stay on *qwen36
|
|
840
|
+
# Every declared child role uses *qwen36.
|
|
628
841
|
services:
|
|
629
842
|
watchdog: *qwen36
|
|
630
|
-
return-extractor: *
|
|
843
|
+
return-extractor: *qwen36
|
|
631
844
|
panel:
|
|
632
|
-
- { name:
|
|
633
|
-
- { name: qwen, model: *
|
|
845
|
+
- { name: qwen-a, model: *qwen36 }
|
|
846
|
+
- { name: qwen-b, model: *qwen36 }
|
|
847
|
+
- { name: qwen-integrator, model: *qwen36, integrator: true }
|
|
634
848
|
```
|
|
635
849
|
|
|
636
850
|
- `defaults` supplies **every persona and every declared child**, including future
|
|
637
851
|
personas, research helpers and team changes. `agents` and `subagents` contain
|
|
638
|
-
exceptions.
|
|
852
|
+
exceptions. To preserve a persona's existing selection, omit it from `agents`;
|
|
853
|
+
for example, `local-workers` leaves `orchestrator` out. Each selection accepts a
|
|
854
|
+
model string or `{model, thinking}`.
|
|
639
855
|
Unspecified thinking inherits defaults, then `off`. Tool caps and delegation
|
|
640
856
|
depth remain unchanged. Unknown persona/child names are rejected.
|
|
641
|
-
- `dispatcher` changes the current Pi session's model and thinking.
|
|
642
|
-
|
|
857
|
+
- `dispatcher` changes the current Pi session's model and thinking. When omitted,
|
|
858
|
+
the live dispatcher keeps its current selection and may use any Pi model, even
|
|
859
|
+
outside `allowed-models`; that list still applies to workers and peers. An
|
|
860
|
+
`orchestrator` persona entry alone is not the live dispatcher.
|
|
643
861
|
- `services` sets the watchdog and structured-return extractor independently;
|
|
644
862
|
unspecified services use defaults. `panel` supplies 2–5 poll/debate voices and
|
|
645
863
|
an optional single integrator. `/af-poll` and `/af-debate` select the active
|
|
@@ -658,7 +876,8 @@ local-duo:
|
|
|
658
876
|
- `fallback: none` (default) disables automatic original-model fallback, including
|
|
659
877
|
nested children and workflows. `declared` retains it. Optional `allowed-models`
|
|
660
878
|
is an exact provider/model allowlist checked before actual child spawns and
|
|
661
|
-
fallback attempts.
|
|
879
|
+
fallback attempts. Worker model pickers and session substitutions respect it;
|
|
880
|
+
the live dispatcher is checked only when `dispatcher` is explicit.
|
|
662
881
|
This governs Fleet model execution; it is not an OS/network sandbox for arbitrary
|
|
663
882
|
shell commands or unrelated applications.
|
|
664
883
|
|
|
@@ -672,11 +891,10 @@ next profile. A fresh Pi session clears the active profile; select it again ther
|
|
|
672
891
|
The profile is passed through the owned process tree. Workflow commands started
|
|
673
892
|
from that session inherit its persona models, thinking, panel and fallback policy.
|
|
674
893
|
Separately started fleet sessions/standing peers retain their own configuration.
|
|
675
|
-
The bundled `local-
|
|
676
|
-
no project model overrides.
|
|
677
|
-
|
|
678
|
-
|
|
679
|
-
|
|
680
|
-
in Pi and served locally by oMLX. Selecting a profile
|
|
681
|
-
|
|
682
|
-
`AGENT_HUB_PROVIDER_LIMITS` can override it if both weights should run in parallel.
|
|
894
|
+
The bundled `local-full` profile explicitly covers all shipped child roles and needs
|
|
895
|
+
no project model overrides. Every role, service and panel entry uses the single
|
|
896
|
+
`omlx/Qwen3.6-35B-A3B-4bit` model. The `local-workers` profile uses that same local
|
|
897
|
+
model for agents, subagents, services and panel voices, while leaving `orchestrator`
|
|
898
|
+
to inherit its current selection; its peer allowlist refuses non-local coms models.
|
|
899
|
+
The model must be registered in Pi and served locally by oMLX. Selecting a profile
|
|
900
|
+
does not download or register models.
|
|
@@ -181,7 +181,7 @@ The live process predated the T5 JavaScript race changes. Pi's independent jiti
|
|
|
181
181
|
|
|
182
182
|
For Android testing, keep the question/options in a normal final chat message and accept an ordinary chat reply. A transient widget/commentary alone is not evidence of durable delivery. T6's local implementation/tests are complete, but live human acceptance remains incomplete.
|
|
183
183
|
|
|
184
|
-
Authorized restart/retest: the human approved restarting Pi and repeating acceptance. PID 82128 was stopped, and PID 92987 resumed the exact saved Pi transcript `2026-09-08T12-58-39-500Z_01a08119-620a-70e7-8e41-60e68f700187.jsonl` in the same `w1:p24` pane with the same harnesses and grok-4.
|
|
184
|
+
Authorized restart/retest: the human approved restarting Pi and repeating acceptance. PID 82128 was stopped, and PID 92987 resumed the exact saved Pi transcript `2026-09-08T12-58-39-500Z_01a08119-620a-70e7-8e41-60e68f700187.jsonl` in the same `w1:p24` pane with the same harnesses and grok-4.7 model. New coms owner `01M20PCBPK0GGQDB36C5E2F6Z1`, started 14:22:32.661 UTC, was explicitly selected. At 14:23:24.241 UTC its question channel was available with no pending/old questions. A separately identified repeat instruction `t6-android-retest-0908` was submitted; the old selection is not automatically reused.
|
|
185
185
|
|
|
186
186
|
Repeat pending evidence: instruction wire `01M20PEC3EDDJRA57QYW7FQGAK`; question `19bf2e5b-4e86-47a0-9539-167a850bc1d7`, originating toolCallId `call-16ee291a-daa8-4096-9d12-d853e0e9291c-45|fc_43819906-6f3d-97f4-8983-97a6dc414ed9_0`, created 14:23:43.101 UTC and discovered automatically by status at 14:24:10.614 UTC. Question: “T6 повторен тест след рестарт: кой цвят избираш?” — Син / Зелен, single selection. Awaiting the human reply in ordinary chat text.
|
|
187
187
|
|
package/docs/pi-extensions.md
CHANGED
|
@@ -48,10 +48,15 @@ so an unconfigured session is a no-op. `/af-stt doctor`
|
|
|
48
48
|
checks the setup. A simplified port of [`cgarrot/pi-voice-stt`](https://github.com/cgarrot/pi-voice-stt);
|
|
49
49
|
see [.pi/extensions/pi-voice-stt/README.md](../.pi/extensions/pi-voice-stt/README.md).
|
|
50
50
|
|
|
51
|
-
> **macOS terminal note:** Option-to-Alt behavior belongs to the outer terminal, not macOS or
|
|
52
|
-
> If
|
|
53
|
-
>
|
|
54
|
-
>
|
|
51
|
+
> **macOS terminal note:** Option-to-Alt behavior belongs to the outer terminal, not macOS, Pi, or
|
|
52
|
+
> Herdr. If Option+M inserts `µ` (or another shortcut inserts a character) instead of activating the
|
|
53
|
+
> shortcut, the terminal is sending the keyboard-layout character rather than a Meta/Alt key event.
|
|
54
|
+
> In Terminal.app, open **Settings → Profiles → Keyboard** for the profile used by the window and
|
|
55
|
+
> enable **Use Option as Meta key**. In Zed, set `terminal.option_as_meta` to `true`. Then verify
|
|
56
|
+
> Option+M opens the Fleet work-mode picker; the terminal should send Meta/Alt chords as an Escape
|
|
57
|
+
> prefix (for example, ESC followed by `m`). This enables the existing shortcuts; it is not an
|
|
58
|
+
> OS-wide keybinding change. Command+M is separate: Terminal.app handles it as **Minimize**, so it
|
|
59
|
+
> does not reach Pi or Herdr as a Fleet shortcut.
|
|
55
60
|
|
|
56
61
|
The documented harnesses below are different: each is a **session harness**. They
|
|
57
62
|
reshape the whole pi session — some set orchestration/UI surfaces and some gate every
|
|
@@ -312,7 +317,7 @@ what you already have:
|
|
|
312
317
|
```bash
|
|
313
318
|
just fleet peer code-reviewer --project af # peers.yaml decides the runner
|
|
314
319
|
just fleet peer scratch-reviewer --runner claude-code --model opus --project af
|
|
315
|
-
just fleet peer researcher --model openai-codex/gpt-
|
|
320
|
+
just fleet peer researcher --model openai-codex/gpt-6-luna --project af
|
|
316
321
|
just fleet peer web-debugger --browser --project af # persona peer + devtools MCP
|
|
317
322
|
just fleet peer nick --here --project af # this terminal, not a pane
|
|
318
323
|
just fleet peer anything --runner claude-code --dry-run # print the plan, touch nothing
|
package/docs/workflows.md
CHANGED
|
@@ -23,6 +23,7 @@ Options:
|
|
|
23
23
|
|
|
24
24
|
- `--dry-run` executes the full graph with valid stub agent envelopes and no model calls.
|
|
25
25
|
- `--run-id <id>` assigns a trace id.
|
|
26
|
+
- `--branch` explicitly creates and switches to `flow/<name>-<runId>`; without it the flow stays on the current branch and creates no worktree. Writes and workflow commits therefore apply to the current branch.
|
|
26
27
|
- `--allow-dirty` explicitly bypasses the normal clean-tree refusal.
|
|
27
28
|
- `--panel <name>` selects a model panel from `.pi/agents/voices.yaml` (required for `poll` and `debate`).
|
|
28
29
|
- `--rounds <n>` sets debate rounds (default 3, minimum 2, maximum 5).
|
|
@@ -32,7 +33,7 @@ Exit codes are `0` accepted, `1` failed/unaccepted, `2` invalid arguments or unk
|
|
|
32
33
|
|
|
33
34
|
## Clean up and merge flow branches
|
|
34
35
|
|
|
35
|
-
|
|
36
|
+
Only runs explicitly started with `--branch` record their source branch and commit before creating `flow/<name>-<runId>`, then record whether the run was accepted or rejected. Current-branch runs create no flow branch or branch metadata. Explicit branches and their commits/dirty work are retained after success, failure or interruption; no automatic branch deletion is attempted. The reserved `cleanup` and `merge` subcommands use that metadata and [Worktrunk](https://worktrunk.dev) to manage completed branches.
|
|
36
37
|
|
|
37
38
|
List branches and open the numbered prompt in a terminal:
|
|
38
39
|
|
|
@@ -113,7 +114,7 @@ The runtime currently uses its 1,800-second default timeout; `timeout-seconds:`
|
|
|
113
114
|
|
|
114
115
|
## Safety and evidence
|
|
115
116
|
|
|
116
|
-
Normal runs require a clean tree and
|
|
117
|
+
Normal runs require a clean tree and stay on the current branch. Only `--branch` creates `flow/<name>-<runId>`. An explicitly requested branch stores its source branch, source commit, flow name, run id, and final acceptance as local Git metadata so maintenance can merge back without guessing. Every agent phase must receive an explicit writes policy from persona frontmatter or its call site; a missing policy is refused before spawn rather than silently treated as unrestricted. `writes: []` is repository read-only, and a non-empty list is an allowlist. Agent writes are checked after each phase against that policy and workflow `protectedGlobs`. `protectedGlobs` reject a path only when no `writes` glob matches it, so `writes: ["**"]` also permits a protected path. `*` stays within one path segment; `**` crosses directories. Out-of-policy changes introduced by the agent are rolled back and terminate the phase. Runtime reports remain writable even for repository-read-only agents. This enforcement exists only in flows; hub behavior is unchanged.
|
|
117
118
|
|
|
118
119
|
Every run writes JSONL under `.pi/flow-sessions/<runId>/trace.jsonl`; this directory is gitignored and separate from hub sessions. Phase success and work acceptance are separate. `run.finish()` produces the exit code, final trace status, and banner from one decision so they cannot disagree.
|
|
119
120
|
|
|
@@ -148,6 +149,6 @@ The Hub registers a typed `run_flow` surface for exactly one procedure: read-onl
|
|
|
148
149
|
|
|
149
150
|
Before the Hub charges one research operation, code validates the effective researcher model/profile/allowlist, fallback and exact `read,grep,find,ls`-only tool set, then builds a stable detached snapshot of the current working tree. The snapshot overlay excludes credential-shaped files and session/flow artifact recursion; validates plain source and destination parents before every create/copy/unlink; unlinks a HEAD symlink leaf rather than following it; rejects traversal, symlink parents/sources, and non-plain files; and records a read-only manifest bound to HEAD plus content hashes. A second source scan must match the first, so a concurrent source change refuses startup rather than producing a falsely coherent snapshot.
|
|
150
151
|
|
|
151
|
-
The scout's native process and descendants run through `confineNativeChild`: the snapshot is read-only at the OS layer, and only its session-owned phase directory is writable for Pi session/runtime support. A second, non-exemptible extension validates the actual declared `read`, `grep`, `find`, and `ls` data paths and patterns against the snapshot, denying original-worktree absolute paths, traversal, and symlink escape. Damage-control remains loaded and applies its `zeroAccessPaths` rules independently. The OS sandbox intentionally retains read access to model/runtime libraries and provider configuration required to start Pi; the DATA-read claim is limited to those four filesystem tools, not a global no-read claim. The flow runs in detached-HEAD, no-branch mode; trace and manifest live under the current Hub session, and the owned temporary workspace is
|
|
152
|
+
The scout's native process and descendants run through `confineNativeChild`: the snapshot is read-only at the OS layer, and only its session-owned phase directory is writable for Pi session/runtime support. A second, non-exemptible extension validates the actual declared `read`, `grep`, `find`, and `ls` data paths and patterns against the snapshot, denying original-worktree absolute paths, traversal, and symlink escape. Damage-control remains loaded and applies its `zeroAccessPaths` rules independently. The OS sandbox intentionally retains read access to model/runtime libraries and provider configuration required to start Pi; the DATA-read claim is limited to those four filesystem tools, not a global no-read claim. The flow runs in detached-HEAD, no-branch mode; trace and manifest live under the current Hub session, and cleanup of the owned temporary workspace is attempted after every settlement or setup failure. `snapshotCleanup.status` reports `removed`, `not-created` or `failed`; a failure returns a visible warning and retained path rather than silently claiming cleanup. Trace and manifest artifacts are kept. Abrupt process termination (for example SIGKILL or power loss) cannot guarantee cleanup; no startup sweep deletes unknown or active directories. It never restores, deletes, checks out, branches, or commits in the original worktree.
|
|
152
153
|
|
|
153
154
|
The Hub owns cancellation and the single budget charge. A duplicate `invocation_id` with identical inputs returns the existing promise/result; changed inputs under that id are stale and refused, and a distinct invocation while one is active is busy without charge. Flow acceptance is nested evidence only: `run_flow` returns parent acceptance as `not_accepted`, promotes no assertions, and retains open T11 obligations. Writable procedures—including `build-test` and its commit semantics—remain unavailable pending a separate reviewed slice.
|