@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
|
@@ -0,0 +1,235 @@
|
|
|
1
|
+
# Testing Patterns Reference (JavaScript/TypeScript)
|
|
2
|
+
|
|
3
|
+
Quick reference of JavaScript/TypeScript testing patterns — Jest, React Testing Library, Supertest, and Playwright — illustrating the universal principles from the `test-driven-development` skill. The principles (Arrange-Act-Assert, naming, mock discipline, anti-patterns) apply in any ecosystem; the syntax and tooling shown here are JS/TS-specific. In another stack, follow the same principles with the repository's own test framework and commands.
|
|
4
|
+
|
|
5
|
+
## Table of Contents
|
|
6
|
+
|
|
7
|
+
- [Test Structure (Arrange-Act-Assert)](#test-structure-arrange-act-assert)
|
|
8
|
+
- [Test Naming Conventions](#test-naming-conventions)
|
|
9
|
+
- [Common Assertions](#common-assertions)
|
|
10
|
+
- [Mocking Patterns](#mocking-patterns)
|
|
11
|
+
- [React/Component Testing](#reactcomponent-testing)
|
|
12
|
+
- [API / Integration Testing](#api--integration-testing)
|
|
13
|
+
- [E2E Testing (Playwright)](#e2e-testing-playwright)
|
|
14
|
+
- [Test Anti-Patterns](#test-anti-patterns)
|
|
15
|
+
|
|
16
|
+
## Test Structure (Arrange-Act-Assert)
|
|
17
|
+
|
|
18
|
+
```typescript
|
|
19
|
+
it('describes expected behavior', () => {
|
|
20
|
+
// Arrange: Set up test data and preconditions
|
|
21
|
+
const input = { title: 'Test Task', priority: 'high' };
|
|
22
|
+
|
|
23
|
+
// Act: Perform the action being tested
|
|
24
|
+
const result = createTask(input);
|
|
25
|
+
|
|
26
|
+
// Assert: Verify the outcome
|
|
27
|
+
expect(result.title).toBe('Test Task');
|
|
28
|
+
expect(result.priority).toBe('high');
|
|
29
|
+
expect(result.status).toBe('pending');
|
|
30
|
+
});
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Test Naming Conventions
|
|
34
|
+
|
|
35
|
+
```typescript
|
|
36
|
+
// Pattern: [unit] [expected behavior] [condition]
|
|
37
|
+
describe('TaskService.createTask', () => {
|
|
38
|
+
it('creates a task with default pending status', () => {});
|
|
39
|
+
it('throws ValidationError when title is empty', () => {});
|
|
40
|
+
it('trims whitespace from title', () => {});
|
|
41
|
+
it('generates a unique ID for each task', () => {});
|
|
42
|
+
});
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## Common Assertions
|
|
46
|
+
|
|
47
|
+
```typescript
|
|
48
|
+
// Equality
|
|
49
|
+
expect(result).toBe(expected); // Strict equality (===)
|
|
50
|
+
expect(result).toEqual(expected); // Deep equality (objects/arrays)
|
|
51
|
+
expect(result).toStrictEqual(expected); // Deep equality + type matching
|
|
52
|
+
|
|
53
|
+
// Truthiness
|
|
54
|
+
expect(result).toBeTruthy();
|
|
55
|
+
expect(result).toBeFalsy();
|
|
56
|
+
expect(result).toBeNull();
|
|
57
|
+
expect(result).toBeDefined();
|
|
58
|
+
expect(result).toBeUndefined();
|
|
59
|
+
|
|
60
|
+
// Numbers
|
|
61
|
+
expect(result).toBeGreaterThan(5);
|
|
62
|
+
expect(result).toBeLessThanOrEqual(10);
|
|
63
|
+
expect(result).toBeCloseTo(0.3, 5); // Floating point
|
|
64
|
+
|
|
65
|
+
// Strings
|
|
66
|
+
expect(result).toMatch(/pattern/);
|
|
67
|
+
expect(result).toContain('substring');
|
|
68
|
+
|
|
69
|
+
// Arrays / Objects
|
|
70
|
+
expect(array).toContain(item);
|
|
71
|
+
expect(array).toHaveLength(3);
|
|
72
|
+
expect(object).toHaveProperty('key', 'value');
|
|
73
|
+
|
|
74
|
+
// Errors
|
|
75
|
+
expect(() => fn()).toThrow();
|
|
76
|
+
expect(() => fn()).toThrow(ValidationError);
|
|
77
|
+
expect(() => fn()).toThrow('specific message');
|
|
78
|
+
|
|
79
|
+
// Async
|
|
80
|
+
await expect(asyncFn()).resolves.toBe(value);
|
|
81
|
+
await expect(asyncFn()).rejects.toThrow(Error);
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
## Mocking Patterns
|
|
85
|
+
|
|
86
|
+
### Mock Functions
|
|
87
|
+
|
|
88
|
+
```typescript
|
|
89
|
+
const mockFn = jest.fn();
|
|
90
|
+
mockFn.mockReturnValue(42);
|
|
91
|
+
mockFn.mockResolvedValue({ data: 'test' });
|
|
92
|
+
mockFn.mockImplementation((x) => x * 2);
|
|
93
|
+
|
|
94
|
+
expect(mockFn).toHaveBeenCalled();
|
|
95
|
+
expect(mockFn).toHaveBeenCalledWith('arg1', 'arg2');
|
|
96
|
+
expect(mockFn).toHaveBeenCalledTimes(3);
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
### Mock Modules
|
|
100
|
+
|
|
101
|
+
```typescript
|
|
102
|
+
// Mock an entire module
|
|
103
|
+
jest.mock('./database', () => ({
|
|
104
|
+
query: jest.fn().mockResolvedValue([{ id: 1, title: 'Test' }]),
|
|
105
|
+
}));
|
|
106
|
+
|
|
107
|
+
// Mock specific exports
|
|
108
|
+
jest.mock('./utils', () => ({
|
|
109
|
+
...jest.requireActual('./utils'),
|
|
110
|
+
generateId: jest.fn().mockReturnValue('test-id'),
|
|
111
|
+
}));
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
### Mock at Boundaries Only
|
|
115
|
+
|
|
116
|
+
```
|
|
117
|
+
Mock these: Don't mock these:
|
|
118
|
+
├── Database calls ├── Internal utility functions
|
|
119
|
+
├── HTTP requests ├── Business logic
|
|
120
|
+
├── File system operations ├── Data transformations
|
|
121
|
+
├── External API calls ├── Validation functions
|
|
122
|
+
└── Time/Date (when needed) └── Pure functions
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
## React/Component Testing
|
|
126
|
+
|
|
127
|
+
```tsx
|
|
128
|
+
import { render, screen, fireEvent, waitFor } from '@testing-library/react';
|
|
129
|
+
|
|
130
|
+
describe('TaskForm', () => {
|
|
131
|
+
it('submits the form with entered data', async () => {
|
|
132
|
+
const onSubmit = jest.fn();
|
|
133
|
+
render(<TaskForm onSubmit={onSubmit} />);
|
|
134
|
+
|
|
135
|
+
// Find elements by accessible role/label (not test IDs)
|
|
136
|
+
await screen.findByRole('textbox', { name: /title/i });
|
|
137
|
+
fireEvent.change(screen.getByRole('textbox', { name: /title/i }), {
|
|
138
|
+
target: { value: 'New Task' },
|
|
139
|
+
});
|
|
140
|
+
fireEvent.click(screen.getByRole('button', { name: /create/i }));
|
|
141
|
+
|
|
142
|
+
await waitFor(() => {
|
|
143
|
+
expect(onSubmit).toHaveBeenCalledWith({ title: 'New Task' });
|
|
144
|
+
});
|
|
145
|
+
});
|
|
146
|
+
|
|
147
|
+
it('shows validation error for empty title', async () => {
|
|
148
|
+
render(<TaskForm onSubmit={jest.fn()} />);
|
|
149
|
+
|
|
150
|
+
fireEvent.click(screen.getByRole('button', { name: /create/i }));
|
|
151
|
+
|
|
152
|
+
expect(await screen.findByText(/title is required/i)).toBeInTheDocument();
|
|
153
|
+
});
|
|
154
|
+
});
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
## API / Integration Testing
|
|
158
|
+
|
|
159
|
+
```typescript
|
|
160
|
+
import request from 'supertest';
|
|
161
|
+
import { app } from '../src/app';
|
|
162
|
+
|
|
163
|
+
describe('POST /api/tasks', () => {
|
|
164
|
+
it('creates a task and returns 201', async () => {
|
|
165
|
+
const response = await request(app)
|
|
166
|
+
.post('/api/tasks')
|
|
167
|
+
.send({ title: 'Test Task' })
|
|
168
|
+
.set('Authorization', `Bearer ${testToken}`)
|
|
169
|
+
.expect(201);
|
|
170
|
+
|
|
171
|
+
expect(response.body).toMatchObject({
|
|
172
|
+
id: expect.any(String),
|
|
173
|
+
title: 'Test Task',
|
|
174
|
+
status: 'pending',
|
|
175
|
+
});
|
|
176
|
+
});
|
|
177
|
+
|
|
178
|
+
it('returns 422 for invalid input', async () => {
|
|
179
|
+
const response = await request(app)
|
|
180
|
+
.post('/api/tasks')
|
|
181
|
+
.send({ title: '' })
|
|
182
|
+
.set('Authorization', `Bearer ${testToken}`)
|
|
183
|
+
.expect(422);
|
|
184
|
+
|
|
185
|
+
expect(response.body.error.code).toBe('VALIDATION_ERROR');
|
|
186
|
+
});
|
|
187
|
+
|
|
188
|
+
it('returns 401 without authentication', async () => {
|
|
189
|
+
await request(app)
|
|
190
|
+
.post('/api/tasks')
|
|
191
|
+
.send({ title: 'Test' })
|
|
192
|
+
.expect(401);
|
|
193
|
+
});
|
|
194
|
+
});
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
## E2E Testing (Playwright)
|
|
198
|
+
|
|
199
|
+
```typescript
|
|
200
|
+
import { test, expect } from '@playwright/test';
|
|
201
|
+
|
|
202
|
+
test('user can create and complete a task', async ({ page }) => {
|
|
203
|
+
// Navigate and authenticate
|
|
204
|
+
await page.goto('/');
|
|
205
|
+
await page.getByRole('textbox', { name: /email/i }).fill('test@example.com');
|
|
206
|
+
await page.getByLabel(/password/i).fill('testpass123');
|
|
207
|
+
await page.getByRole('button', { name: /log in/i }).click();
|
|
208
|
+
|
|
209
|
+
// Create a task
|
|
210
|
+
await page.getByRole('button', { name: /new task/i }).click();
|
|
211
|
+
await page.getByRole('textbox', { name: /title/i }).fill('Buy groceries');
|
|
212
|
+
await page.getByRole('button', { name: /create/i }).click();
|
|
213
|
+
|
|
214
|
+
// Verify task appears
|
|
215
|
+
const task = page.getByRole('listitem', { name: /buy groceries/i });
|
|
216
|
+
await expect(task).toBeVisible();
|
|
217
|
+
|
|
218
|
+
// Complete the task
|
|
219
|
+
await task.getByRole('checkbox', { name: /complete buy groceries/i }).check();
|
|
220
|
+
await expect(task).toHaveCSS('text-decoration-line', 'line-through');
|
|
221
|
+
});
|
|
222
|
+
```
|
|
223
|
+
|
|
224
|
+
## Test Anti-Patterns
|
|
225
|
+
|
|
226
|
+
| Anti-Pattern | Problem | Better Approach |
|
|
227
|
+
|---|---|---|
|
|
228
|
+
| Testing implementation details | Breaks on refactor | Test inputs/outputs |
|
|
229
|
+
| Snapshot everything | No one reviews snapshot diffs | Assert specific values |
|
|
230
|
+
| Shared mutable state | Tests pollute each other | Setup/teardown per test |
|
|
231
|
+
| Testing third-party code | Wastes time, not your bug | Mock the boundary |
|
|
232
|
+
| Skipping tests to pass CI | Hides real bugs | Fix or delete the test |
|
|
233
|
+
| Using `test.skip` permanently | Dead code | Remove or fix it |
|
|
234
|
+
| Overly broad assertions | Doesn't catch regressions | Be specific |
|
|
235
|
+
| No async error handling | Swallowed errors, false passes | Always `await` async tests |
|
|
@@ -0,0 +1,304 @@
|
|
|
1
|
+
# Workflow Authoring Reference
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
|
|
5
|
+
This is the deep contract for deterministic workflows launched by `just flow`.
|
|
6
|
+
It complements the procedural `drafting-workflows` skill.
|
|
7
|
+
A workflow is code-owned orchestration: code fixes order, retries, permissions, gates, and acceptance.
|
|
8
|
+
Agents appear only at phases that require judgment.
|
|
9
|
+
The interactive `just fleet` hub remains independent and unchanged.
|
|
10
|
+
|
|
11
|
+
## Public contract
|
|
12
|
+
|
|
13
|
+
The only public recipe is:
|
|
14
|
+
|
|
15
|
+
```text
|
|
16
|
+
just flow <name> [args] [--allow-dirty] [--run-id <id>] [--dry-run]
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
The equivalent raw entry point is:
|
|
20
|
+
|
|
21
|
+
```text
|
|
22
|
+
node --experimental-strip-types .pi/agent-fleet/scripts/flow.ts <name> [args]
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
The script loads the repository `.env` without replacing variables already present in `process.env`.
|
|
26
|
+
The command is headless, has no TUI, and requires no human interaction after launch.
|
|
27
|
+
Exit `0` means accepted.
|
|
28
|
+
Exit `1` means a phase failed or the completed work was not accepted.
|
|
29
|
+
Exit `2` means invalid arguments or an unknown flow.
|
|
30
|
+
Exit `3` means startup was refused before side effects.
|
|
31
|
+
Signals finalize the trace and use the conventional `128 + signal` exit code.
|
|
32
|
+
|
|
33
|
+
## Startup safety
|
|
34
|
+
|
|
35
|
+
A normal run requires a clean working tree.
|
|
36
|
+
`--allow-dirty` is the explicit exception.
|
|
37
|
+
All refusal checks run before trace creation or branch creation.
|
|
38
|
+
A run creates `flow/<name>-<runId>` from the current HEAD.
|
|
39
|
+
The repository baseline is captured before an agent can write.
|
|
40
|
+
Runtime files live under `.pi/flow-sessions/<runId>/`.
|
|
41
|
+
That runtime directory is gitignored and never shares hub session storage.
|
|
42
|
+
The trace records pid and command before the first phase.
|
|
43
|
+
|
|
44
|
+
## Phase primitive
|
|
45
|
+
|
|
46
|
+
Every phase declares:
|
|
47
|
+
|
|
48
|
+
- `name`: stable machine-readable phase name;
|
|
49
|
+
- `kind`: `engineer`, `agent`, or `code`;
|
|
50
|
+
- `owner`: operator, persona, or deterministic subsystem;
|
|
51
|
+
- `description`: one sentence explaining why the phase exists;
|
|
52
|
+
- `retries`: optional bounded correction rounds.
|
|
53
|
+
|
|
54
|
+
A description cannot be empty.
|
|
55
|
+
A description cannot merely reformat the phase name.
|
|
56
|
+
A phase starts with `status: "fail"`.
|
|
57
|
+
A clean return changes it to `success`.
|
|
58
|
+
A thrown error leaves it failed and propagates.
|
|
59
|
+
A failed phase finalizes the run as failed.
|
|
60
|
+
Phase success says the phase body executed correctly; it does not imply acceptance.
|
|
61
|
+
|
|
62
|
+
## Kinds and ownership
|
|
63
|
+
|
|
64
|
+
Use `engineer` for operator-owned input or decisions already supplied to the run.
|
|
65
|
+
Use `agent` only where interpretation or implementation judgment is required.
|
|
66
|
+
Use `code` for known commands, git calculations, validation, commits, and other deterministic work.
|
|
67
|
+
Do not dispatch an agent to rediscover `npm test`.
|
|
68
|
+
Do not hide a judgment call in a code phase.
|
|
69
|
+
Keep phase order visible in the `/** Phases: ... */` docstring.
|
|
70
|
+
The docstring is the generator's shape map and must match runtime order.
|
|
71
|
+
|
|
72
|
+
## Finish and acceptance
|
|
73
|
+
|
|
74
|
+
Call `run.finish()` exactly once.
|
|
75
|
+
Pass `accepted: true` only when the workflow's explicit acceptance rule is satisfied.
|
|
76
|
+
Pass a reason when acceptance is false.
|
|
77
|
+
`finish()` owns the exit code, final trace status, and terminal banner together.
|
|
78
|
+
No caller may calculate those three results independently.
|
|
79
|
+
A red quality command may be a successfully executed code phase while making the run unaccepted.
|
|
80
|
+
A second `finish()` call is an error.
|
|
81
|
+
|
|
82
|
+
## Trace semantics
|
|
83
|
+
|
|
84
|
+
The JSONL trace contains `run_start`, `phase_start`, `phase_end`, `log`, `error`, `gate_report`, `agent_process`, and `run_end` evidence.
|
|
85
|
+
Each event carries timestamp and run id.
|
|
86
|
+
Phase descriptions are the durable intent shown in traces.
|
|
87
|
+
Do not put credentials or complete model transcripts in trace data.
|
|
88
|
+
Command logs and agent session files belong below the run directory.
|
|
89
|
+
An interrupted run must not remain marked `running`.
|
|
90
|
+
|
|
91
|
+
## Agent phase construction
|
|
92
|
+
|
|
93
|
+
Resolve personas through the existing agent scanner.
|
|
94
|
+
Use the persona model, fallback model, thinking level, tools, system prompt, and additive `writes` declaration.
|
|
95
|
+
Build a replacement specialist prompt and context manifest.
|
|
96
|
+
Do not inherit the hub prompt.
|
|
97
|
+
Spawn through `spawnPiAgentWithModelFallback` with detached process-group ownership.
|
|
98
|
+
Load `damage-control-continue` for the child.
|
|
99
|
+
Keep the tool watchdog and whole-turn deadline enabled.
|
|
100
|
+
Store each persona session at `.pi/flow-sessions/<runId>/<agentKey>/session.json`.
|
|
101
|
+
Resume the same session for corrections.
|
|
102
|
+
Recycle before spawn when projected prompt use exceeds the resolved context window.
|
|
103
|
+
|
|
104
|
+
## Typed envelopes
|
|
105
|
+
|
|
106
|
+
Schemas use TypeBox.
|
|
107
|
+
The base fields are `status`, `summary`, `artifacts`, and `notes_for_next_agent`.
|
|
108
|
+
Plan adds `commit_message`.
|
|
109
|
+
Build adds `changed_files` and `commit_message`.
|
|
110
|
+
Review adds `approved`, assertion status arrays, risks, and user decisions.
|
|
111
|
+
Scout adds `findings`.
|
|
112
|
+
Document adds `document_path`, `documented_files`, and `commit_message`.
|
|
113
|
+
All array and string fields are explicit; defaults are not a substitute for an emitted contract.
|
|
114
|
+
The existing hub return parser is the first parser, not the final validator.
|
|
115
|
+
TypeBox validation decides whether the flow envelope is acceptable.
|
|
116
|
+
Unexpected fields are refused.
|
|
117
|
+
A valid envelope with `status: "fail"` fails the phase.
|
|
118
|
+
|
|
119
|
+
## Envelope triad
|
|
120
|
+
|
|
121
|
+
For every agent phase, synchronize:
|
|
122
|
+
|
|
123
|
+
1. the TypeBox schema in `lib/envelopes.ts`;
|
|
124
|
+
2. the JSON example included in the phase prompt;
|
|
125
|
+
3. the `envelope:` name at the workflow call site.
|
|
126
|
+
|
|
127
|
+
`envelopes-triad.test.ts` guards this relationship.
|
|
128
|
+
A schema-only edit is incomplete.
|
|
129
|
+
A prompt-only edit is incomplete.
|
|
130
|
+
A call-site-only edit is incomplete.
|
|
131
|
+
Personas keep the shared return-contract vocabulary and need no flow-only rewrite.
|
|
132
|
+
|
|
133
|
+
## Correction loop
|
|
134
|
+
|
|
135
|
+
Invalid output is corrected in the same Pi session.
|
|
136
|
+
The correction names every missing or invalid field.
|
|
137
|
+
The agent re-emits only Report JSON.
|
|
138
|
+
JSON correction is bounded by `JSON_FIX_ATTEMPTS`.
|
|
139
|
+
Gate correction is separately bounded by the phase retry policy.
|
|
140
|
+
The hub's second-model return extractor is never used by flows.
|
|
141
|
+
Exhausted correction attempts fail the phase with the envelope type named.
|
|
142
|
+
A declared `status: "fail"` is terminal and is not negotiated into success.
|
|
143
|
+
Permission breaches are terminal and are never sent back as a correction prompt.
|
|
144
|
+
|
|
145
|
+
## Executable gates
|
|
146
|
+
|
|
147
|
+
A gate receives an envelope and the active run.
|
|
148
|
+
A `GateReport` records one check for every inspected item.
|
|
149
|
+
A green report must say what it checked.
|
|
150
|
+
`artifactsExist` stats each declared artifact and records its size.
|
|
151
|
+
`filesNonEmpty` requires a real size greater than zero.
|
|
152
|
+
`jsonParses` performs `JSON.parse` on declared JSON artifacts.
|
|
153
|
+
`diffMatchesClaims` checks every `changed_files` path on disk.
|
|
154
|
+
`testsPass(argv)` executes the argv without a shell and includes bounded red output.
|
|
155
|
+
`verdictConsistent` rejects approval with blocking findings.
|
|
156
|
+
It also rejects disapproval that names no problem.
|
|
157
|
+
Gates verify claims; they do not replace envelope validation.
|
|
158
|
+
|
|
159
|
+
## Writes boundary
|
|
160
|
+
|
|
161
|
+
Persona `writes` is additive frontmatter and remains ignored by the hub.
|
|
162
|
+
A flow agent phase must have either persona `writes` or an explicit call-site permission policy; omission is refused before spawn.
|
|
163
|
+
Use `writes: []` for repository read-only.
|
|
164
|
+
A non-empty list is an allowlist; use an explicit `writes: ["**"]` call-site policy when a workflow intentionally permits repository-wide changes.
|
|
165
|
+
Runtime session files are always writable.
|
|
166
|
+
`protectedGlobs` reject a path only when no `writes` glob matches it; therefore a broad `writes: ["**"]` policy also permits protected paths.
|
|
167
|
+
The glob implementation is owned by the workflow layer.
|
|
168
|
+
`*` does not cross `/`; `**` does.
|
|
169
|
+
|
|
170
|
+
Enforcement compares repository snapshots before and after an agent phase.
|
|
171
|
+
Snapshots include tracked numstat state and untracked files.
|
|
172
|
+
A path changed, created, deleted, or restored to HEAD is detected.
|
|
173
|
+
Changes introduced outside policy are rolled back and the phase fails.
|
|
174
|
+
A path already dirty before the run is not reconstructed or destroyed.
|
|
175
|
+
A dirty path restored by an agent is still reported as a change.
|
|
176
|
+
Clean-tree startup makes rollback safe in the normal case.
|
|
177
|
+
The hub's advisory scope behavior is not changed by this enforcement.
|
|
178
|
+
|
|
179
|
+
## Quality blocks
|
|
180
|
+
|
|
181
|
+
Quality configuration comes from `## workflows` in `.ai/agent-fleet-overrides.md`.
|
|
182
|
+
There is no fallback: the section must contain a non-empty `quality:` value (for example, `quality: npm test`) or startup refuses with an actionable exit-`3` error.
|
|
183
|
+
The value is split into argv with simple shell-style quote handling; it is not a JSON-array setting and is never run through a shell.
|
|
184
|
+
Bare executable names inherit the operator environment.
|
|
185
|
+
A missing executable returns a real `127` result and diagnostic.
|
|
186
|
+
Stdout and stderr are persisted to `command.log`.
|
|
187
|
+
The runtime currently uses its explicit 1,800-second default timeout; `timeout-seconds:` is not a supported workflow override.
|
|
188
|
+
`asEnvelope` lets repair logic consume deterministic quality output like reviewer evidence.
|
|
189
|
+
No placeholder command may manufacture a green result.
|
|
190
|
+
|
|
191
|
+
## Change capture
|
|
192
|
+
|
|
193
|
+
`resolveBase` records both the selected diff base and the reason.
|
|
194
|
+
When HEAD is ahead, capture the branch plus working tree.
|
|
195
|
+
When at base with dirty state, capture the uncommitted tree.
|
|
196
|
+
When at base and clean, fall back to `HEAD~1`.
|
|
197
|
+
Name untracked files explicitly because `git diff` omits them.
|
|
198
|
+
Bound diff text with `maxDiffLines`.
|
|
199
|
+
Record how many lines were hidden.
|
|
200
|
+
The reason belongs in the trace and in the documenter's context.
|
|
201
|
+
|
|
202
|
+
## Commit placement
|
|
203
|
+
|
|
204
|
+
Commit only after deterministic verification succeeds.
|
|
205
|
+
A build-test flow commits once after the suite is green.
|
|
206
|
+
An exhausted repair loop commits nothing.
|
|
207
|
+
A document flow commits only gated documentation.
|
|
208
|
+
Commit only changes introduced after the recorded baseline and allowed by persona policy.
|
|
209
|
+
The commit message comes from the validated envelope.
|
|
210
|
+
A no-change result is logged and is not an error.
|
|
211
|
+
|
|
212
|
+
## Dry-run semantics
|
|
213
|
+
|
|
214
|
+
`--dry-run` executes the entire graph.
|
|
215
|
+
Agent phases return fixed schema-valid envelopes.
|
|
216
|
+
Code phases skip external side effects and return representative green results.
|
|
217
|
+
Commit phases log that commit was skipped.
|
|
218
|
+
No model is called.
|
|
219
|
+
The same phase order, envelope parsing, and finish rule still execute.
|
|
220
|
+
Dry-run is an authoring gate, not a substitute for focused unit tests.
|
|
221
|
+
|
|
222
|
+
## Generator contract
|
|
223
|
+
|
|
224
|
+
`make-workflow.ts` reads every `wf-*.ts` phase docstring.
|
|
225
|
+
It classifies explicit `engineer(...)`, `agent(...)`, and `code(...)` kinds.
|
|
226
|
+
It parses separators only at parenthesis depth zero, so annotations such as `agent(builder-fix, bounded)` remain one phase.
|
|
227
|
+
It computes deterministic edit distance over the resulting phase-kind sequences.
|
|
228
|
+
Length difference participates in scoring after edit distance.
|
|
229
|
+
Workflow name breaks exact score ties.
|
|
230
|
+
The selected workflow is copied in full.
|
|
231
|
+
The phase docstring block is replaced and workflow/preflight symbols are renamed from the source identity to the unique camel-cased identity derived from the new file name.
|
|
232
|
+
For `wf-plan-build-review.ts`, the required entry is `planBuildReviewWorkflow` (and optional `planBuildReviewWorkflowPreflight`).
|
|
233
|
+
Built-in flows are listed in `.pi/agent-fleet/scripts/flow.ts`; for a non-built-in name, the dispatcher discovers `wf-<name>.ts` on demand by this exact export convention. A successful draft is therefore immediately reachable through `just flow <name>` without editing the built-in map.
|
|
234
|
+
The generator never overwrites an existing workflow.
|
|
235
|
+
|
|
236
|
+
Generated TODOs are limited to actual judgment:
|
|
237
|
+
|
|
238
|
+
- executable gate selection;
|
|
239
|
+
- bounded retry policy;
|
|
240
|
+
- final acceptance semantics.
|
|
241
|
+
|
|
242
|
+
There are no TODOs for imports, exports, trace calls, envelopes, or dry-run boilerplate.
|
|
243
|
+
Before returning a path, the generator runs scoped TypeScript compilation.
|
|
244
|
+
It then resolves the generated workflow by the exact export convention used by the dispatcher and executes it with stubbed agent phases.
|
|
245
|
+
A failed typecheck deletes the draft.
|
|
246
|
+
A failed dry-run deletes the draft.
|
|
247
|
+
A successful handoff names both the generated file and copied source.
|
|
248
|
+
|
|
249
|
+
## Scoped TypeScript
|
|
250
|
+
|
|
251
|
+
`.pi/agent-fleet/scripts/workflows/tsconfig.json` includes only workflow production TypeScript.
|
|
252
|
+
Workflow imports of hub seams cross typed dynamic boundaries so the compiler does not absorb the hub program.
|
|
253
|
+
Tests remain checked by Node's runtime test execution rather than expanding the scoped project.
|
|
254
|
+
The project emits nothing.
|
|
255
|
+
Node and TypeBox types are available through pinned development tooling.
|
|
256
|
+
No typecheck failure requires edits under `.pi/harnesses/**`.
|
|
257
|
+
The canonical command is:
|
|
258
|
+
|
|
259
|
+
```text
|
|
260
|
+
npx tsc -p .pi/agent-fleet/scripts/workflows/tsconfig.json --noEmit
|
|
261
|
+
```
|
|
262
|
+
|
|
263
|
+
## Package and install surface
|
|
264
|
+
|
|
265
|
+
The npm package includes `.pi/agent-fleet/scripts/flow.ts`, `.pi/agent-fleet/scripts/lib/flow-command.ts`, `.pi/agent-fleet/scripts/workflows/*.ts`, `.pi/agent-fleet/scripts/workflows/lib/*.ts`, and the scoped tsconfig.
|
|
266
|
+
It also includes the complete `skills/` and `references/` trees. The installer maps the workflow guide to `.pi/agent-fleet/docs/workflows.md`, so the drafting skill, generator, authoring reference, and managed guide are packaged without adding product documentation to the target repository's `docs/` tree.
|
|
267
|
+
The install manifest is generated from `manifest-meta.json` and the repository tree.
|
|
268
|
+
Workflow runtime files use preserved repository-relative paths because the justfile recipe imports them there.
|
|
269
|
+
The drafting skill brings the authoring reference as a companion.
|
|
270
|
+
Never hand-edit `install-manifest.json`.
|
|
271
|
+
Run manifest validation and `pack:dry` before release.
|
|
272
|
+
The tarball must be inspected for every required surface, not merely for a successful npm exit code.
|
|
273
|
+
|
|
274
|
+
## `run_flow` design note (D8)
|
|
275
|
+
|
|
276
|
+
A future hub tool may call the same flow dispatcher module directly.
|
|
277
|
+
It must not shell through `just`.
|
|
278
|
+
It should pass validated arguments to the exported execution function and preserve the same exit, trace, startup, and signal semantics.
|
|
279
|
+
The hub tool will need an explicit budget and cancellation contract before implementation.
|
|
280
|
+
It must not bypass clean-tree or permission enforcement.
|
|
281
|
+
It must not translate flow acceptance into advisory assertion status.
|
|
282
|
+
`run_flow` is design-only in this release: no tool is registered and no hub file is changed.
|
|
283
|
+
|
|
284
|
+
## Author verification checklist
|
|
285
|
+
|
|
286
|
+
- Phase docstring equals runtime order.
|
|
287
|
+
- Every phase description explains why.
|
|
288
|
+
- Agent prompts preserve exact operator intent.
|
|
289
|
+
- Every agent call uses the intended envelope.
|
|
290
|
+
- Envelope triad tests pass.
|
|
291
|
+
- Gates perform real checks and report each item.
|
|
292
|
+
- Retry loops are bounded.
|
|
293
|
+
- Permission breaches terminate.
|
|
294
|
+
- Quality commands use argv and real exits.
|
|
295
|
+
- Acceptance is separate from phase success.
|
|
296
|
+
- `finish()` is called exactly once.
|
|
297
|
+
- Dry-run makes zero model calls.
|
|
298
|
+
- Scoped TypeScript passes.
|
|
299
|
+
- Focused workflow tests pass.
|
|
300
|
+
- Full repository tests pass.
|
|
301
|
+
- Manifest check passes.
|
|
302
|
+
- Package dry-run contains all workflow and authoring files.
|
|
303
|
+
- `.pi/flow-sessions/` remains ignored.
|
|
304
|
+
- `.pi/harnesses/**` remains unmodified.
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
# Grilling (Internal Helper)
|
|
2
|
+
|
|
3
|
+
Use this helper from a parent skill whenever a plan, spec, design, or
|
|
4
|
+
implementation must take a decision. Explicit invocation ("grill this",
|
|
5
|
+
"stress-test this") still triggers it; so does any unspecified fork. Do not
|
|
6
|
+
wait for the user to ask.
|
|
7
|
+
|
|
8
|
+
Interview until each **open** decision is explicitly accepted, rejected, or
|
|
9
|
+
deferred. Walk the design tree one dependency at a time: choose the next
|
|
10
|
+
question from prior answers, and skip questions made irrelevant by earlier
|
|
11
|
+
decisions.
|
|
12
|
+
|
|
13
|
+
## Do not re-ask what is already settled
|
|
14
|
+
|
|
15
|
+
Do **not** grill a point that is already explicit in any of:
|
|
16
|
+
|
|
17
|
+
- the current chat, user prompt, or spoken/written instruction
|
|
18
|
+
- a PRD, spec, plan, ticket, or other written requirement
|
|
19
|
+
- a project rule, skill, or standing instruction
|
|
20
|
+
|
|
21
|
+
Treat those as accepted. Re-asking wastes attention and implies the agent did
|
|
22
|
+
not read the source of truth.
|
|
23
|
+
|
|
24
|
+
## Must grill — unspecified forks
|
|
25
|
+
|
|
26
|
+
Grill every remaining point that is load-bearing and still open:
|
|
27
|
+
|
|
28
|
+
- **Multiple valid ways** — architecture, library, naming, scope cut, data
|
|
29
|
+
model, error behavior, where two or more approaches would all work and the
|
|
30
|
+
trade-off is preference-dependent
|
|
31
|
+
- **Doubt or contradiction** — sources disagree (chat vs code, spec vs tests,
|
|
32
|
+
two rules, two existing implementations)
|
|
33
|
+
- **Code variants** — the codebase already has several patterns and one must
|
|
34
|
+
be chosen for this change; propose one recommended option among them
|
|
35
|
+
|
|
36
|
+
If a question can be answered by reading the codebase, docs, tests, or runtime
|
|
37
|
+
evidence, investigate first and ask only about the remaining decision.
|
|
38
|
+
|
|
39
|
+
If grilling produces **zero** questions (everything load-bearing was already
|
|
40
|
+
settled), say so briefly and proceed. Do not invent questions to look thorough.
|
|
41
|
+
|
|
42
|
+
## How to ask
|
|
43
|
+
|
|
44
|
+
Ask one focused question at a time. Offer 2-4 concrete options plus your
|
|
45
|
+
recommended answer and a brief reason, then wait for the user's decision
|
|
46
|
+
before continuing. This should feel like guided architectural interrogation,
|
|
47
|
+
not a questionnaire dump.
|
|
48
|
+
|
|
49
|
+
## When it applies
|
|
50
|
+
|
|
51
|
+
Planning, spec writing, **and implementation** — whenever a decision must be
|
|
52
|
+
taken. A plan that silently picks a library, and an implementer that silently
|
|
53
|
+
picks among existing code patterns, are the same failure.
|
|
54
|
+
|
|
55
|
+
Keep grilling until shared understanding is strong enough to write or revise
|
|
56
|
+
the downstream artifact. Record each accepted, rejected, or deferred choice in
|
|
57
|
+
that artifact (Architecture Decisions, Boundaries, or the slice summary).
|
|
58
|
+
When review exposes gaps later, convert each gap into one targeted follow-up
|
|
59
|
+
question.
|