@chankov/agent-fleet 2.0.16 → 2.0.17
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/harnesses/agent-hub/README.md +4 -0
- package/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
- package/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
- package/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
- package/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
- package/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
- package/.pi/harnesses/agent-hub/agentic-sources.ts +50 -0
- package/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
- package/.pi/harnesses/agent-hub/index.ts +8 -2
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/peer-spawn-plan.ts +1 -1
- package/.pi/harnesses/agent-hub/policy/work-mode.ts +2 -1
- package/.pi/harnesses/agent-hub/proactive-snapshot.ts +9 -24
- package/.pi/harnesses/agent-hub/prompts/context.ts +2 -0
- package/.pi/harnesses/agent-hub/prompts/fragments.ts +7 -0
- package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +3 -1
- package/.pi/harnesses/agent-hub/system1-communication-store.ts +29 -7
- package/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
- package/.pi/harnesses/agent-hub/ui/system1-communication.ts +1 -1
- package/.pi/harnesses/agent-hub/work-mode.ts +6 -1
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/index.ts +6 -23
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/damage-control-shared.ts +29 -0
- package/.pi/harnesses/lib/safe-source-read.js +29 -0
- package/.pi/harnesses/lib/system1/config-agentic.js +14 -0
- package/.pi/harnesses/lib/system1/config-v2.js +6 -3
- package/.versions/2.0.17/.pi/agent-fleet/hermes/README.md +347 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.17/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.17/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/fleet.ts +217 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/flow.ts +157 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/package-lock.json +35 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/package.json +9 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/team-up.ts +378 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.17/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
- package/.versions/2.0.17/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.17/.pi/agents/model-profiles.yaml +134 -0
- package/.versions/2.0.17/.pi/agents/peers.yaml +147 -0
- package/.versions/2.0.17/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.17/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.17/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.17/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.17/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.17/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.17/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.17/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.17/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.17/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.17/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.17/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.17/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.17/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.17/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.17/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.17/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.17/.pi/extensions/package.json +9 -0
- package/.versions/2.0.17/.pi/extensions/pi-voice-stt/README.md +224 -0
- package/.versions/2.0.17/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.17/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.17/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.17/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.17/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.17/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/README.md +1456 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/acceptance.ts +199 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-sources.ts +50 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/context.ts +47 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/config/agents.ts +178 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/config/overrides.ts +155 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/context/budgets.ts +206 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/context-window.js +108 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/delegate.ts +467 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/deterministic-fs.ts +166 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +259 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +231 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-native-types.ts +260 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-native.ts +234 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/docs-lane.js +123 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/filesystem-tool.ts +137 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/fixtures/registration-surface.json +65 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/helpers.ts +270 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/index.ts +2607 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/input/completions.ts +82 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +133 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/no-progress.ts +563 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/orchestration-activation.ts +112 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/orchestration-route.ts +76 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/policy/work-mode.ts +136 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-config.ts +16 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-local.ts +71 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-snapshot.ts +228 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/process-obligations.ts +158 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/prompts/context.ts +56 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/prompts/fragments.ts +123 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/prompts/system-prompt.ts +124 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/reconcile.ts +26 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/recover-state.ts +104 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/recovery-contract.ts +150 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/research/runtime.ts +197 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/research/spawn-run.ts +183 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/return-contract.js +349 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/return-extract.js +77 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/review-closure.ts +43 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/review-findings.js +104 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/run-budget.js +554 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/run-namespace.js +93 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/scope-gate.js +144 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/session-audit.ts +313 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/spawn.ts +534 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/system1-communication-store.ts +151 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/system1-report.ts +275 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/system1-runtime.ts +258 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-authorization.ts +122 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-config.ts +29 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-obligations.ts +104 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-runtime.ts +125 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/timeline.ts +72 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/action-executors.ts +208 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/context.ts +144 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +558 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/tsconfig.json +22 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/types.ts +66 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/work-mode.ts +184 -0
- package/.versions/2.0.17/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
- package/.versions/2.0.17/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.17/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.17/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.17/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.17/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
- package/.versions/2.0.17/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.17/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.17/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.17/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.17/.pi/harnesses/damage-control-continue/README.md +135 -0
- package/.versions/2.0.17/.pi/harnesses/damage-control-continue/index.ts +533 -0
- package/.versions/2.0.17/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.17/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.17/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
- package/.versions/2.0.17/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.17/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.17/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.17/.pi/harnesses/lib/context-budget-child-prompt.ts +219 -0
- package/.versions/2.0.17/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
- package/.versions/2.0.17/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.17/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.17/.pi/harnesses/lib/damage-control-shared.ts +226 -0
- package/.versions/2.0.17/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fleet-read-model.ts +609 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
- package/.versions/2.0.17/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.17/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.17/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.17/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.17/.pi/harnesses/lib/safe-source-read.js +29 -0
- package/.versions/2.0.17/.pi/harnesses/lib/spawned-peers.js +191 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/config-agentic.js +14 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/config-json.js +37 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/config-loader.js +44 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/config-proactive.js +57 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/config-triage.js +42 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/config-v2.js +103 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/config.js +50 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/contracts.ts +154 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/demo.ts +95 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/jev.ts +503 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/selection.js +11 -0
- package/.versions/2.0.17/.pi/harnesses/lib/system1/service.ts +245 -0
- package/.versions/2.0.17/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.17/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.17/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.17/.pi/prompts/af-build.md +27 -0
- package/.versions/2.0.17/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.17/.pi/prompts/af-constraints.md +31 -0
- package/.versions/2.0.17/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.17/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.17/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.17/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.17/.pi/prompts/af-setup-rules.md +20 -0
- package/.versions/2.0.17/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.17/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.17/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.17/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.17/.version +1 -0
- package/.versions/2.0.17/agents/architect.md +24 -0
- package/.versions/2.0.17/agents/bowser.md +28 -0
- package/.versions/2.0.17/agents/builder.md +55 -0
- package/.versions/2.0.17/agents/code-reviewer.md +209 -0
- package/.versions/2.0.17/agents/deep-researcher.md +32 -0
- package/.versions/2.0.17/agents/documenter.md +22 -0
- package/.versions/2.0.17/agents/orchestrator.md +22 -0
- package/.versions/2.0.17/agents/plan-reviewer.md +83 -0
- package/.versions/2.0.17/agents/planner.md +105 -0
- package/.versions/2.0.17/agents/releaser.md +24 -0
- package/.versions/2.0.17/agents/researcher.md +30 -0
- package/.versions/2.0.17/agents/security-auditor.md +167 -0
- package/.versions/2.0.17/agents/test-engineer.md +153 -0
- package/.versions/2.0.17/agents/web-debugger.md +44 -0
- package/.versions/2.0.17/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.17/bin/catalog/harness-runtime-closure.json +73 -0
- package/.versions/2.0.17/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.17/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.17/docs/ARCHITECTURE.md +834 -0
- package/.versions/2.0.17/docs/agent-fleet-setup.md +1101 -0
- package/.versions/2.0.17/docs/claude-code-coms-bridge.md +134 -0
- package/.versions/2.0.17/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.17/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.17/docs/getting-started.md +126 -0
- package/.versions/2.0.17/docs/npm-install.md +530 -0
- package/.versions/2.0.17/docs/pi-extensions.md +454 -0
- package/.versions/2.0.17/docs/pi-setup.md +92 -0
- package/.versions/2.0.17/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.17/install-manifest.json +3193 -0
- package/.versions/2.0.17/justfile +247 -0
- package/.versions/2.0.17/manifest-meta.json +1071 -0
- package/.versions/2.0.17/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.17/references/communication-contract.md +26 -0
- package/.versions/2.0.17/references/definition-of-done.md +67 -0
- package/.versions/2.0.17/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.17/references/observability-checklist.md +92 -0
- package/.versions/2.0.17/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.17/references/performance-checklist.md +236 -0
- package/.versions/2.0.17/references/prompting-patterns.md +380 -0
- package/.versions/2.0.17/references/security-checklist.md +245 -0
- package/.versions/2.0.17/references/testing-patterns.md +235 -0
- package/.versions/2.0.17/references/workflow-authoring.md +304 -0
- package/.versions/2.0.17/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.17/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.17/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.17/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.17/skills/constraint-driven-development/SKILL.md +338 -0
- package/.versions/2.0.17/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.17/skills/context-engineering/SKILL.md +341 -0
- package/.versions/2.0.17/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.17/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.17/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.17/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.17/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.17/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.17/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.17/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.17/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.17/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.17/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.17/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.17/skills/incremental-implementation/SKILL.md +353 -0
- package/.versions/2.0.17/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.17/skills/orchestration-verification/SKILL.md +182 -0
- package/.versions/2.0.17/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.17/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.17/skills/planning-and-task-breakdown/SKILL.md +318 -0
- package/.versions/2.0.17/skills/repository-ai-setup/SKILL.md +117 -0
- package/.versions/2.0.17/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
- package/.versions/2.0.17/skills/repository-ai-setup/references/apply-contract.md +74 -0
- package/.versions/2.0.17/skills/repository-ai-setup/references/provenance-template.md +16 -0
- package/.versions/2.0.17/skills/repository-ai-setup/references/setup-flow.md +108 -0
- package/.versions/2.0.17/skills/repository-ai-setup/references/verify-setup.md +20 -0
- package/.versions/2.0.17/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.17/skills/spec-driven-development/SKILL.md +295 -0
- package/.versions/2.0.17/skills/using-agent-skills/SKILL.md +198 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/README.md +430 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
- package/.versions/2.0.17/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
- package/CHANGELOG.md +12 -0
- package/docs/system1-agentic.md +106 -0
- package/install-manifest.json +1 -1
- package/package.json +5 -2
|
@@ -0,0 +1,228 @@
|
|
|
1
|
+
import { safeSourceRead } from "../lib/safe-source-read.js";
|
|
2
|
+
import { execFileSync, fork } from "node:child_process";
|
|
3
|
+
import { createHash } from "node:crypto";
|
|
4
|
+
import { lstatSync, realpathSync } from "node:fs";
|
|
5
|
+
import { isAbsolute, join, relative, resolve } from "node:path";
|
|
6
|
+
import { fileURLToPath } from "node:url";
|
|
7
|
+
import { isCaptureEnabled, PROACTIVE_LIMITS } from "./proactive-config.ts";
|
|
8
|
+
import { checkScope } from "./scope-gate.js";
|
|
9
|
+
import type { ProactiveConfig, SourceExcerpt, TaskContext, TurnSnapshot, TurnUnit } from "./proactive-types.ts";
|
|
10
|
+
|
|
11
|
+
const hash = (value: Buffer | string) => createHash("sha256").update(value).digest("hex");
|
|
12
|
+
const forbidden = /^(?:\.env(?:\..*)?|\.git|\.pi|\.ssh|\.aws|\.npmrc|\.netrc|node_modules|vendor|dist|build|coverage|\.next|\.cache|artifacts|sessions?|transcripts?|credentials?(?:\..*)?|secrets?(?:\..*)?|id_(?:rsa|ed25519)|.*\.(?:pem|key|p12|pfx|sqlite|db|lock))$/i;
|
|
13
|
+
function allowed(root: string, path: string): string {
|
|
14
|
+
if (!path || isAbsolute(path) || path.includes("\\") || path.includes("\0") || path.split("/").some(s => !s || s === "." || s === ".." || forbidden.test(s))) throw new Error("forbidden_path");
|
|
15
|
+
const rootReal = realpathSync(root), full = resolve(rootReal, path);
|
|
16
|
+
const rel = relative(rootReal, full);
|
|
17
|
+
if (rel.startsWith("..") || isAbsolute(rel)) throw new Error("escape");
|
|
18
|
+
let cursor = rootReal;
|
|
19
|
+
for (const part of path.split("/")) {
|
|
20
|
+
cursor = join(cursor, part);
|
|
21
|
+
try { if (lstatSync(cursor).isSymbolicLink()) throw new Error("symlink"); }
|
|
22
|
+
catch (e) { if ((e as NodeJS.ErrnoException).code === "ENOENT") break; throw e; }
|
|
23
|
+
}
|
|
24
|
+
return full;
|
|
25
|
+
}
|
|
26
|
+
function remaining(start: number, now: () => number): number {
|
|
27
|
+
const ms = PROACTIVE_LIMITS.captureMs - (now() - start);
|
|
28
|
+
if (ms <= 0) throw new Error("capture_timeout");
|
|
29
|
+
return Math.min(300, Math.max(1, Math.floor(ms)));
|
|
30
|
+
}
|
|
31
|
+
function git(root: string, args: string[], start: number, now: () => number, maxBuffer = 1024 * 1024): Buffer {
|
|
32
|
+
remaining(start, now);
|
|
33
|
+
// The enclosing process-group deadline owns cancellation; this is only a backup.
|
|
34
|
+
const bytes = execFileSync("git", ["-C", root, ...args], { timeout: PROACTIVE_LIMITS.captureMs + 200, maxBuffer, stdio: ["ignore", "pipe", "pipe"] });
|
|
35
|
+
remaining(start, now);
|
|
36
|
+
return bytes;
|
|
37
|
+
}
|
|
38
|
+
function status(root: string, start: number, now: () => number): Set<string> {
|
|
39
|
+
const rows = git(root, ["status", "--porcelain", "-z", "--untracked-files=all"], start, now).toString("utf8").split("\0");
|
|
40
|
+
const paths = new Set<string>();
|
|
41
|
+
for (let i = 0; i < rows.length; i++) {
|
|
42
|
+
const row = rows[i]; if (!row) continue;
|
|
43
|
+
paths.add(row.slice(3));
|
|
44
|
+
if (/[RC]/.test(row.slice(0, 2)) && rows[i + 1]) paths.add(rows[++i]);
|
|
45
|
+
}
|
|
46
|
+
return paths;
|
|
47
|
+
}
|
|
48
|
+
function read(root: string, path: string, start: number, now: () => number, afterFirstRead?: () => void): Buffer | null {
|
|
49
|
+
const full = allowed(root, path);
|
|
50
|
+
try { return safeSourceRead(root, full, PROACTIVE_LIMITS.maxFileBytes, () => remaining(start, now), afterFirstRead); }
|
|
51
|
+
catch (error) {
|
|
52
|
+
if ((error as NodeJS.ErrnoException).code === "ENOENT") return null;
|
|
53
|
+
const reason = (error as Error).message;
|
|
54
|
+
throw new Error(({ source_changed: "unstable_snapshot", state_too_large: "oversized_or_nonfile", source_denied: "binary_or_invalid_utf8" } as Record<string,string>)[reason] ?? reason);
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
function excerpt(bytes: Buffer, secrets: readonly string[]): SourceExcerpt {
|
|
59
|
+
let text = bytes.toString("utf8");
|
|
60
|
+
for (const secret of secrets) if (secret) text = text.replaceAll(secret, "[REDACTED]");
|
|
61
|
+
const source = bytes.toString("utf8");
|
|
62
|
+
return Object.freeze({ hash: hash(text), offset: 0, endOffset: bytes.length, startLine: 1, endLine: Math.max(1, source.split("\n").length - (source.endsWith("\n") ? 1 : 0)), text, truncated: false });
|
|
63
|
+
}
|
|
64
|
+
export interface TurnBaseline {
|
|
65
|
+
readonly root: string;
|
|
66
|
+
readonly head: string;
|
|
67
|
+
readonly dirty: ReadonlyMap<string, Buffer | null>;
|
|
68
|
+
readonly initialPaths: ReadonlySet<string>;
|
|
69
|
+
readonly config: ProactiveConfig;
|
|
70
|
+
readonly turnId: string;
|
|
71
|
+
readonly context: TaskContext;
|
|
72
|
+
readonly gaps: readonly string[];
|
|
73
|
+
readonly startedAt: number;
|
|
74
|
+
}
|
|
75
|
+
const code = (e: unknown): string => {
|
|
76
|
+
const message = (e as Error)?.message;
|
|
77
|
+
return typeof message === "string" && ["capture_timeout", "forbidden_path", "escape", "symlink", "oversized_or_nonfile", "unstable_snapshot", "binary_or_invalid_utf8", "missing_baseline", "oversized_baseline"].includes(message) ? message : "read_unavailable";
|
|
78
|
+
};
|
|
79
|
+
/** Worker-only synchronous core. Never call on the agent's event loop. */
|
|
80
|
+
export function beginTurnCore(input: { root: string; config: ProactiveConfig; turnId: string; context: TaskContext; knownTargets?: readonly string[]; now?: () => number }): TurnBaseline | null {
|
|
81
|
+
if (!isCaptureEnabled(input.config)) return null;
|
|
82
|
+
const now = input.now ?? Date.now, startedAt = now();
|
|
83
|
+
let head = "";
|
|
84
|
+
let initialPaths = new Set<string>();
|
|
85
|
+
const dirty = new Map<string, Buffer | null>(), gaps: string[] = [];
|
|
86
|
+
try {
|
|
87
|
+
head = git(input.root, ["rev-parse", "HEAD"], startedAt, now).toString("utf8").trim();
|
|
88
|
+
initialPaths = status(input.root, startedAt, now);
|
|
89
|
+
} catch (e) { head = ""; gaps.push((e as Error).message === "capture_timeout" ? "capture_timeout" : "git_unavailable"); }
|
|
90
|
+
let retained = 0, count = 0;
|
|
91
|
+
for (const path of [...new Set([...initialPaths, ...(input.knownTargets ?? [])])].sort()) {
|
|
92
|
+
if (now() - startedAt >= PROACTIVE_LIMITS.captureMs) { gaps.push("capture_timeout"); break; }
|
|
93
|
+
if (!checkScope([path], input.config.include).inScope.length) continue;
|
|
94
|
+
if (!head) break;
|
|
95
|
+
if (count >= PROACTIVE_LIMITS.maxUnits || retained >= PROACTIVE_LIMITS.maxRetainedBytes) { gaps.push("baseline_limit"); break; }
|
|
96
|
+
try {
|
|
97
|
+
const bytes = read(input.root, path, startedAt, now);
|
|
98
|
+
if (retained + (bytes?.length ?? 0) > PROACTIVE_LIMITS.maxRetainedBytes) { gaps.push("baseline_limit"); break; }
|
|
99
|
+
dirty.set(path, bytes); retained += bytes?.length ?? 0; count++;
|
|
100
|
+
} catch (e) { gaps.push(code(e)); }
|
|
101
|
+
}
|
|
102
|
+
return { root: input.root, head, dirty, initialPaths, config: input.config, turnId: input.turnId, context: structuredClone(input.context), gaps, startedAt };
|
|
103
|
+
}
|
|
104
|
+
export function finishTurnCore(baseline: TurnBaseline | null, input: { assistantText?: string; knownTargets?: readonly string[]; secrets?: readonly string[]; overlap?: boolean; now?: () => number; afterFirstRead?: () => void } = {}): TurnSnapshot | null {
|
|
105
|
+
if (!baseline) return null;
|
|
106
|
+
const now = input.now ?? Date.now, started = now();
|
|
107
|
+
const gaps = [...baseline.gaps];
|
|
108
|
+
let current: Set<string>;
|
|
109
|
+
try {
|
|
110
|
+
current = status(baseline.root, started, now);
|
|
111
|
+
if (git(baseline.root, ["rev-parse", "HEAD"], started, now).toString("utf8").trim() !== baseline.head) gaps.push("head_changed");
|
|
112
|
+
} catch (e) { current = new Set(); gaps.push((e as Error).message === "capture_timeout" ? "capture_timeout" : "git_unavailable"); }
|
|
113
|
+
if (input.overlap) gaps.push("concurrent_writer_attribution_uncertain");
|
|
114
|
+
const paths = [...new Set([...baseline.initialPaths, ...current, ...baseline.dirty.keys(), ...(input.knownTargets ?? [])])].sort();
|
|
115
|
+
const units: TurnUnit[] = [];
|
|
116
|
+
let retained = 0, omitted = 0;
|
|
117
|
+
const secrets = input.secrets ?? [];
|
|
118
|
+
for (const path of paths) {
|
|
119
|
+
if (!checkScope([path], baseline.config.include).inScope.length) continue;
|
|
120
|
+
if (now() - started >= PROACTIVE_LIMITS.captureMs) { gaps.push("capture_timeout"); omitted++; continue; }
|
|
121
|
+
if (units.length >= PROACTIVE_LIMITS.maxUnits) { omitted++; continue; }
|
|
122
|
+
try {
|
|
123
|
+
// Deny both lexical and symlink/realpath escapes before path-specific Git reads.
|
|
124
|
+
allowed(baseline.root, path);
|
|
125
|
+
let before = baseline.dirty.get(path);
|
|
126
|
+
if (!baseline.dirty.has(path)) {
|
|
127
|
+
if (!baseline.head || baseline.initialPaths.has(path) || (input.knownTargets ?? []).includes(path)) throw new Error("missing_baseline");
|
|
128
|
+
// A clean tracked path can use HEAD; only a path absent from HEAD is a genuine addition.
|
|
129
|
+
const tracked = git(baseline.root, ["ls-tree", "-z", "--name-only", baseline.head, "--", path], started, now).length > 0;
|
|
130
|
+
before = tracked ? git(baseline.root, ["show", `${baseline.head}:${path}`], started, now, PROACTIVE_LIMITS.maxFileBytes + 1) : null;
|
|
131
|
+
if (before && before.length > PROACTIVE_LIMITS.maxFileBytes) throw new Error("oversized_baseline");
|
|
132
|
+
}
|
|
133
|
+
const after = read(baseline.root, path, started, now, input.afterFirstRead);
|
|
134
|
+
remaining(started, now);
|
|
135
|
+
if (before && (before.includes(0) || !new TextDecoder("utf-8", { fatal: true }).decode(before))) { if (before.length) throw new Error("binary_or_invalid_utf8"); }
|
|
136
|
+
if (before !== null && after !== null && before?.equals(after)) continue;
|
|
137
|
+
if (before == null && after == null) continue;
|
|
138
|
+
const prior = before == null ? undefined : excerpt(before, secrets);
|
|
139
|
+
const next = after == null ? undefined : excerpt(after, secrets);
|
|
140
|
+
const size = Buffer.byteLength(prior?.text ?? "") + Buffer.byteLength(next?.text ?? "");
|
|
141
|
+
remaining(started, now);
|
|
142
|
+
if (retained + size > PROACTIVE_LIMITS.maxRetainedBytes) { omitted++; continue; }
|
|
143
|
+
const unit: TurnUnit = Object.freeze({ id: hash(`${baseline.turnId}:${path}`), path, kind: before == null ? "added" : after == null ? "deleted" : "modified", before: prior, after: next, attribution: "uncertain" });
|
|
144
|
+
units.push(unit); retained += size;
|
|
145
|
+
} catch (e) { gaps.push(code(e)); omitted++; }
|
|
146
|
+
}
|
|
147
|
+
if (omitted) gaps.push(`omitted_paths:${omitted}`);
|
|
148
|
+
if (baseline.config.remoteContext === "selected-excerpts" && input.assistantText) {
|
|
149
|
+
const text = Buffer.from(input.assistantText);
|
|
150
|
+
const redacted = text.length <= PROACTIVE_LIMITS.maxFileBytes ? excerpt(text, secrets) : null;
|
|
151
|
+
const size = Buffer.byteLength(redacted?.text ?? "");
|
|
152
|
+
if (units.length >= PROACTIVE_LIMITS.maxUnits || !redacted || retained + size > PROACTIVE_LIMITS.maxRetainedBytes) gaps.push("assistant_text_omitted");
|
|
153
|
+
else { units.push(Object.freeze({ id: hash(`${baseline.turnId}:assistant`), path: "assistant", kind: "text", after: redacted, attribution: "observed_only" })); retained += size; }
|
|
154
|
+
}
|
|
155
|
+
const statusValue = gaps.some(g => g.includes("unstable_snapshot")) ? "unstable_snapshot" : gaps.length ? "partial" : "complete";
|
|
156
|
+
const snapshotId = hash(JSON.stringify([baseline.turnId, baseline.head, baseline.context, units.map(u => [u.id, u.before?.hash, u.after?.hash]), gaps]));
|
|
157
|
+
const context = structuredClone(baseline.context);
|
|
158
|
+
Object.freeze(context.task);
|
|
159
|
+
if (context.plan) Object.freeze(context.plan);
|
|
160
|
+
for (const rule of context.rules) Object.freeze(rule);
|
|
161
|
+
Object.freeze(context.rules); Object.freeze(context.exceptions); Object.freeze(context);
|
|
162
|
+
return Object.freeze({ snapshotId, turnId: baseline.turnId, head: baseline.head, context, planStatus: baseline.context.plan ? "bound" : "task_only", status: statusValue, gaps: Object.freeze(gaps), units: Object.freeze(units), observedPaths: paths.length, coverage: Object.freeze({ retainedUnits: units.length, omittedPaths: omitted, retainedBytes: retained }) });
|
|
163
|
+
}
|
|
164
|
+
/** Immutable in-memory readback: never opens the source path. */
|
|
165
|
+
export function readSnapshotUnit(snapshot: TurnSnapshot, snapshotId: string, unitId: string, contentHash: string): string | null {
|
|
166
|
+
if (snapshot.snapshotId !== snapshotId) return null;
|
|
167
|
+
const unit = snapshot.units.find(u => u.id === unitId);
|
|
168
|
+
const excerpt = [unit?.before, unit?.after].find(e => e?.hash === contentHash);
|
|
169
|
+
return excerpt?.text ?? null;
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
/** Each phase runs in a disposable process group. The parent fences IPC after deadline
|
|
173
|
+
* and kills the entire group (including any Git descendants) before settling. */
|
|
174
|
+
function capture<T>(phase: "begin" | "finish", payload: unknown): Promise<T> {
|
|
175
|
+
return new Promise((resolve, reject) => {
|
|
176
|
+
const child = fork(fileURLToPath(new URL("./proactive-snapshot-worker.mjs", import.meta.url)), [], {
|
|
177
|
+
detached: true, stdio: ["ignore", "ignore", "ignore", "ipc"], serialization: "advanced", execArgv: [],
|
|
178
|
+
});
|
|
179
|
+
let settled = false;
|
|
180
|
+
const killGroup = () => {
|
|
181
|
+
if (child.pid) {
|
|
182
|
+
try { process.kill(-child.pid, "SIGKILL"); } catch { /* exited */ }
|
|
183
|
+
try { child.kill("SIGKILL"); } catch { /* exited */ }
|
|
184
|
+
}
|
|
185
|
+
};
|
|
186
|
+
const settle = (error?: Error, result?: T) => {
|
|
187
|
+
if (settled) return;
|
|
188
|
+
settled = true;
|
|
189
|
+
clearTimeout(timer);
|
|
190
|
+
killGroup();
|
|
191
|
+
if (error) reject(error); else resolve(result as T);
|
|
192
|
+
};
|
|
193
|
+
const timer = setTimeout(() => settle(new Error("capture_timeout")), PROACTIVE_LIMITS.captureMs);
|
|
194
|
+
child.on("message", (message: { ok?: boolean; result?: T; code?: string }) => {
|
|
195
|
+
if (!message?.ok) settle(new Error(message?.code === "capture_timeout" ? "capture_timeout" : "capture_unavailable"));
|
|
196
|
+
else settle(undefined, message.result);
|
|
197
|
+
});
|
|
198
|
+
child.on("error", () => settle(new Error("capture_unavailable")));
|
|
199
|
+
// Let a queued IPC result win if the process exits immediately after sending.
|
|
200
|
+
child.on("exit", () => setImmediate(() => settle(new Error("capture_unavailable"))));
|
|
201
|
+
child.send({ phase, payload }, error => { if (error) settle(new Error("capture_unavailable")); });
|
|
202
|
+
});
|
|
203
|
+
}
|
|
204
|
+
export function beginTurn(input: Parameters<typeof beginTurnCore>[0]): Promise<TurnBaseline | null> {
|
|
205
|
+
if (!isCaptureEnabled(input.config)) return Promise.resolve(null);
|
|
206
|
+
const { now: _now, ...payload } = input;
|
|
207
|
+
return capture<TurnBaseline | null>("begin", payload).then(baseline => {
|
|
208
|
+
if (baseline) {
|
|
209
|
+
Object.freeze(baseline.context.task); if (baseline.context.plan) Object.freeze(baseline.context.plan);
|
|
210
|
+
for (const rule of baseline.context.rules) Object.freeze(rule);
|
|
211
|
+
Object.freeze(baseline.context.rules); Object.freeze(baseline.context.exceptions); Object.freeze(baseline.context);
|
|
212
|
+
}
|
|
213
|
+
return baseline;
|
|
214
|
+
});
|
|
215
|
+
}
|
|
216
|
+
export function finishTurn(baseline: TurnBaseline | null, input: Parameters<typeof finishTurnCore>[1] = {}): Promise<TurnSnapshot | null> {
|
|
217
|
+
if (!baseline) return Promise.resolve(null);
|
|
218
|
+
const { now: _now, afterFirstRead: _hook, assistantText, ...options } = input;
|
|
219
|
+
return capture<TurnSnapshot>("finish", { baseline, input: baseline.config.remoteContext === "selected-excerpts" ? { ...options, assistantText } : options }).then(snapshot => {
|
|
220
|
+
// IPC cloning loses Object.freeze; reapply it before exposing private evidence.
|
|
221
|
+
for (const unit of snapshot.units) { if (unit.before) Object.freeze(unit.before); if (unit.after) Object.freeze(unit.after); Object.freeze(unit); }
|
|
222
|
+
Object.freeze(snapshot.units); Object.freeze(snapshot.gaps); Object.freeze(snapshot.coverage);
|
|
223
|
+
Object.freeze(snapshot.context.task); if (snapshot.context.plan) Object.freeze(snapshot.context.plan);
|
|
224
|
+
for (const rule of snapshot.context.rules) Object.freeze(rule);
|
|
225
|
+
Object.freeze(snapshot.context.rules); Object.freeze(snapshot.context.exceptions); Object.freeze(snapshot.context);
|
|
226
|
+
return Object.freeze(snapshot);
|
|
227
|
+
});
|
|
228
|
+
}
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
export type ReviewMode = "off" | "shadow" | "advisory";
|
|
2
|
+
export type RemoteContext = "disabled" | "selected-excerpts";
|
|
3
|
+
export type EvidenceStatus = "complete" | "partial" | "unstable_snapshot" | "not_checked";
|
|
4
|
+
export type Attribution = "uncertain" | "observed_only";
|
|
5
|
+
export type SemanticVerdict = "aligned" | "possible_deviation" | "insufficient_evidence" | "not_checked";
|
|
6
|
+
export type RuleVerdict = "no_observed_violation" | "potential_violation" | "not_applicable" | "insufficient_evidence" | "rule_conflict" | "not_checked";
|
|
7
|
+
export type FindingSource = "deterministic" | "system1";
|
|
8
|
+
export type FeedbackDelivery = "not_applicable" | "pending" | "delivered" | "stale";
|
|
9
|
+
|
|
10
|
+
export interface ProactiveConfig {
|
|
11
|
+
readonly version: 1;
|
|
12
|
+
readonly mode: ReviewMode;
|
|
13
|
+
readonly remoteContext: RemoteContext;
|
|
14
|
+
readonly include: readonly string[];
|
|
15
|
+
readonly maxEvaluationsPerSession: number;
|
|
16
|
+
}
|
|
17
|
+
export interface BoundReference { readonly path: string; readonly revision: string; readonly hash: string }
|
|
18
|
+
export interface TaskContext {
|
|
19
|
+
readonly task: BoundReference;
|
|
20
|
+
readonly plan?: BoundReference;
|
|
21
|
+
readonly rules: readonly BoundReference[];
|
|
22
|
+
readonly exceptions: readonly string[];
|
|
23
|
+
}
|
|
24
|
+
export interface SourceExcerpt {
|
|
25
|
+
readonly hash: string;
|
|
26
|
+
readonly offset: number;
|
|
27
|
+
readonly endOffset: number;
|
|
28
|
+
readonly startLine: number;
|
|
29
|
+
readonly endLine: number;
|
|
30
|
+
readonly text: string;
|
|
31
|
+
readonly truncated: boolean;
|
|
32
|
+
}
|
|
33
|
+
export interface TurnUnit {
|
|
34
|
+
readonly id: string;
|
|
35
|
+
readonly path: string;
|
|
36
|
+
readonly kind: "added" | "modified" | "deleted" | "renamed" | "text";
|
|
37
|
+
readonly before?: SourceExcerpt;
|
|
38
|
+
readonly after?: SourceExcerpt;
|
|
39
|
+
readonly attribution: Attribution;
|
|
40
|
+
readonly previousPath?: string;
|
|
41
|
+
}
|
|
42
|
+
export interface TurnSnapshot {
|
|
43
|
+
readonly snapshotId: string;
|
|
44
|
+
readonly turnId: string;
|
|
45
|
+
readonly head: string;
|
|
46
|
+
readonly context: TaskContext;
|
|
47
|
+
readonly planStatus: "bound" | "task_only";
|
|
48
|
+
readonly status: EvidenceStatus;
|
|
49
|
+
readonly gaps: readonly string[];
|
|
50
|
+
readonly units: readonly TurnUnit[];
|
|
51
|
+
readonly observedPaths: number;
|
|
52
|
+
readonly coverage: { readonly retainedUnits: number; readonly omittedPaths: number; readonly retainedBytes: number };
|
|
53
|
+
}
|
|
54
|
+
export interface RuleSection { readonly id: string; readonly source: BoundReference; readonly heading: string; readonly occurrence: number }
|
|
55
|
+
export interface ReviewFinding {
|
|
56
|
+
readonly source: FindingSource;
|
|
57
|
+
readonly snapshotId: string;
|
|
58
|
+
readonly unitId: string;
|
|
59
|
+
readonly reference: string;
|
|
60
|
+
readonly verdict: RuleVerdict | SemanticVerdict;
|
|
61
|
+
readonly evidenceStatus: EvidenceStatus;
|
|
62
|
+
readonly delivery: FeedbackDelivery;
|
|
63
|
+
}
|
|
@@ -0,0 +1,158 @@
|
|
|
1
|
+
import { consumeActionGrant, type ActionContract, type ActionGrant } from "./task-triage-authorization.ts";
|
|
2
|
+
|
|
3
|
+
export const PROCESS_OBLIGATIONS_SCHEMA = "agent-fleet.process-obligations/v1" as const;
|
|
4
|
+
export type TaskRisk = "unknown" | "low" | "high";
|
|
5
|
+
export type TaskScope = "unknown" | "read-only" | "small" | "wide";
|
|
6
|
+
export type ObligationStatus = "satisfied" | "open" | "unsupported" | "waived";
|
|
7
|
+
export type ProcessStage = "classify-risk" | "plan" | "execute" | "acceptance" | "review" | "confirm-action" | "complete";
|
|
8
|
+
|
|
9
|
+
export interface ProcessStageState { required: boolean; evidenceRef: string | null; revision: string | null; }
|
|
10
|
+
export interface ProcessAddition { id: string; source: "system1"; taskId: string; evaluationId: string; inputRevision: string; policyVersion: string; questionVersion: string; provider: string; model: string; reason: "security_change" | "wide_change" | "irreversible_execution"; status: "active" | "waived"; waiverReason: string | null; }
|
|
11
|
+
export interface ProcessObligationState {
|
|
12
|
+
schema: typeof PROCESS_OBLIGATIONS_SCHEMA; risk: TaskRisk; scope: TaskScope;
|
|
13
|
+
acceptance: ProcessStageState; review: ProcessStageState; plan: ProcessStageState;
|
|
14
|
+
reassessments: number; lastReason: string | null; appliedRuleIds: string[]; changedFiles: string[];
|
|
15
|
+
additions?: ProcessAddition[];
|
|
16
|
+
}
|
|
17
|
+
export interface ProcessClassificationInput { risk?: string; scope?: string; reason?: string; newTask?: boolean; }
|
|
18
|
+
export interface ProcessVerdict {
|
|
19
|
+
accepted: boolean; path: "read-only" | "changed-task"; risk: TaskRisk; scope: TaskScope; budgetTier: string;
|
|
20
|
+
obligations: Record<"risk" | "acceptance" | "review" | "plan", { status: ObligationStatus; evidenceRef?: string }> & { confirmation?: { status: ObligationStatus } };
|
|
21
|
+
additions: Pick<ProcessAddition, "id" | "taskId" | "evaluationId" | "inputRevision" | "reason" | "status">[];
|
|
22
|
+
appliedRuleIds: string[]; currentStage: ProcessStage; admissibleNextAction: string; auditScope: string[]; explanation: string;
|
|
23
|
+
}
|
|
24
|
+
const RISKS = new Set<TaskRisk>(["unknown", "low", "high"]), SCOPES = new Set<TaskScope>(["unknown", "read-only", "small", "wide"]);
|
|
25
|
+
const scopeRank: Record<TaskScope, number> = { unknown: 0, "read-only": 0, small: 1, wide: 2 };
|
|
26
|
+
const cleanReason = (value: unknown) => typeof value === "string" && value.trim() ? value.trim().slice(0, 512) : null;
|
|
27
|
+
const strings = (value: unknown) => Array.isArray(value) ? [...new Set(value.filter(v => typeof v === "string" && v.trim()).map(v => v.trim()))].sort() : [];
|
|
28
|
+
export function createProcessState(): ProcessObligationState { return { schema: PROCESS_OBLIGATIONS_SCHEMA, risk: "unknown", scope: "unknown", acceptance: { required: true, evidenceRef: null, revision: null }, review: { required: false, evidenceRef: null, revision: null }, plan: { required: false, evidenceRef: null, revision: null }, reassessments: 0, lastReason: null, appliedRuleIds: ["risk-unknown-fail-closed"], changedFiles: [] }; }
|
|
29
|
+
export function normalizeProcessState(value: unknown): ProcessObligationState {
|
|
30
|
+
const row = value && typeof value === "object" ? value as any : {}, state = createProcessState();
|
|
31
|
+
if (RISKS.has(row.risk)) state.risk = row.risk; if (SCOPES.has(row.scope)) state.scope = row.scope;
|
|
32
|
+
for (const key of ["acceptance", "review", "plan"] as const) { const stage = row[key] && typeof row[key] === "object" ? row[key] : {}; state[key] = { required: key === "acceptance" || stage.required === true || key === "review" && (state.risk === "high" || state.scope === "wide") || key === "plan" && state.scope === "wide", evidenceRef: typeof stage.evidenceRef === "string" && stage.evidenceRef ? stage.evidenceRef : null, revision: typeof stage.revision === "string" && stage.revision ? stage.revision : null }; }
|
|
33
|
+
// Legacy required stages remain independent of S1 and cannot be waived.
|
|
34
|
+
if (Array.isArray(row.additions) && (row.additions.length > 300 || Buffer.byteLength(JSON.stringify(row.additions)) > 64 * 1024)) throw new Error("Process additions exceed the persistence limit; dependent effects are blocked.");
|
|
35
|
+
state.additions = Array.isArray(row.additions) ? row.additions.map((a: any) => {
|
|
36
|
+
if (!a || a.source !== "system1" || typeof a.id !== "string" || !a.id || !["taskId", "evaluationId", "inputRevision", "policyVersion", "questionVersion", "provider", "model"].every(k => typeof a[k] === "string" && a[k]) || !["security_change", "wide_change", "irreversible_execution"].includes(a.reason) || !["active", "waived"].includes(a.status) || a.status === "waived" && (typeof a.waiverReason !== "string" || !a.waiverReason)) throw new Error("Invalid process addition; dependent effects are blocked.");
|
|
37
|
+
return { id: a.id, source: "system1" as const, taskId: a.taskId, evaluationId: a.evaluationId, inputRevision: a.inputRevision, policyVersion: a.policyVersion, questionVersion: a.questionVersion, provider: a.provider, model: a.model, reason: a.reason, status: a.status, waiverReason: a.status === "waived" ? a.waiverReason : null };
|
|
38
|
+
}) : [];
|
|
39
|
+
state.reassessments = Number.isSafeInteger(row.reassessments) && row.reassessments >= 0 ? row.reassessments : 0; state.lastReason = cleanReason(row.lastReason);
|
|
40
|
+
state.appliedRuleIds = strings(row.appliedRuleIds); state.changedFiles = strings(row.changedFiles); return state;
|
|
41
|
+
}
|
|
42
|
+
function rules(risk: TaskRisk, scope: TaskScope): string[] { return [...new Set([risk === "unknown" ? "risk-unknown-fail-closed" : risk === "high" ? "risk-high-independent-review" : "risk-low-minimal-acceptance", scope === "wide" ? "scope-wide-plan-review" : scope === "read-only" ? "scope-read-only-lightweight" : "scope-changed-task", "budget-tier-spend-only"])]; }
|
|
43
|
+
export function applyProcessClassification(current: ProcessObligationState, input: ProcessClassificationInput): { ok: true; state: ProcessObligationState; message: string } | { ok: false; state: ProcessObligationState; message: string } {
|
|
44
|
+
const reason = cleanReason(input.reason); if (input.newTask && !reason) return { ok: false, state: normalizeProcessState(current), message: "A genuine new task requires a non-empty reason." };
|
|
45
|
+
const base = input.newTask ? createProcessState() : normalizeProcessState(current), risk = input.risk === undefined ? base.risk : String(input.risk).trim().toLowerCase() as TaskRisk, scope = input.scope === undefined ? base.scope : String(input.scope).trim().toLowerCase() as TaskScope;
|
|
46
|
+
if (!RISKS.has(risk)) return { ok: false, state: base, message: `risk must be one of unknown | low | high (got "${input.risk}").` }; if (!SCOPES.has(scope)) return { ok: false, state: base, message: `scope must be one of read-only | small | wide (got "${input.scope}").` };
|
|
47
|
+
const riskWasExplicit = input.risk !== undefined, riskChanged = risk !== base.risk, scopeExpanded = scopeRank[scope] > scopeRank[base.scope];
|
|
48
|
+
if ((riskChanged || scopeExpanded) && !reason) return { ok: false, state: base, message: `${riskChanged ? "Risk change" : "Scope expansion"} requires a non-empty reason.` }; if (scopeExpanded && base.scope !== "unknown" && !riskWasExplicit) return { ok: false, state: base, message: "Scope expansion requires explicit risk reassessment in the same set_task_tier call." };
|
|
49
|
+
const next = normalizeProcessState(base); next.risk = risk; next.scope = scope; next.lastReason = reason ?? next.lastReason; next.appliedRuleIds = rules(risk, scope);
|
|
50
|
+
if (riskWasExplicit && (riskChanged || scopeExpanded || !!reason) || scopeExpanded) next.reassessments++;
|
|
51
|
+
if (risk === "high" || scope === "wide") next.review.required = true; if (scope === "wide") next.plan.required = true;
|
|
52
|
+
if (scopeExpanded) { next.acceptance = { required: true, evidenceRef: null, revision: null }; if (effectiveProcessStage(next, "review")) next.review = { ...next.review, evidenceRef: null, revision: null }; if (effectiveProcessStage(next, "plan")) next.plan = { ...next.plan, evidenceRef: null, revision: null }; }
|
|
53
|
+
return { ok: true, state: next, message: `Process classified: risk ${next.risk}, scope ${next.scope}.` };
|
|
54
|
+
}
|
|
55
|
+
export function effectiveProcessStage(state: ProcessObligationState, stage: "plan" | "review" | "confirmation"): boolean { const s = normalizeProcessState(state); return (stage !== "confirmation" && s[stage].required) || !!s.additions?.some(a => a.status === "active" && (stage === "confirmation" ? a.reason === "irreversible_execution" : stage === "plan" ? a.reason === "wide_change" : a.reason === "wide_change" || a.reason === "security_change")); }
|
|
56
|
+
export function noteProcessStage(state: ProcessObligationState, stage: "acceptance" | "plan" | "review", evidence: { evidenceRef: string; revision: string; changedFiles?: string[] }): ProcessObligationState { const next = normalizeProcessState(state); if ((stage === "acceptance" || effectiveProcessStage(next, stage)) && evidence.evidenceRef && evidence.revision) next[stage] = { ...next[stage], evidenceRef: evidence.evidenceRef, revision: evidence.revision }; if (stage === "acceptance" && evidence.changedFiles) next.changedFiles = strings(evidence.changedFiles); return next; }
|
|
57
|
+
export function processOpenObligations(state: ProcessObligationState, revision?: string): string[] { const s = normalizeProcessState(state); return [s.risk === "unknown" ? "risk" : "", effectiveProcessStage(s, "plan") && !s.plan.evidenceRef ? "plan" : "", s.acceptance.required && (!s.acceptance.evidenceRef || revision && s.acceptance.revision !== revision) ? "acceptance" : "", effectiveProcessStage(s, "review") && (!s.review.evidenceRef || revision && s.review.revision !== revision) ? "review" : "", effectiveProcessStage(s, "confirmation") ? "action_confirmation" : ""].filter(Boolean); }
|
|
58
|
+
// Recovery guidance is derived from effective obligations, not roster size or model advice.
|
|
59
|
+
export function missingProcessRoleRecoveryHints(state: ProcessObligationState, roster: ReadonlySet<string>): string {
|
|
60
|
+
const open = processOpenObligations(state);
|
|
61
|
+
const missingPlan = open.includes("plan") && !roster.has("planner");
|
|
62
|
+
const missingReview = open.includes("review") && !["code-reviewer", "plan-reviewer", "security-auditor"].some(name => roster.has(name));
|
|
63
|
+
return [
|
|
64
|
+
missingPlan ? "Plan requires planner: ask the human to run /af-agents-add planner or choose a roster with /af-agents-team." : "",
|
|
65
|
+
missingReview ? "Review requires a reviewer: ask the human to run /af-agents-add code-reviewer (or plan-reviewer or security-auditor), or choose a roster with /af-agents-team." : "",
|
|
66
|
+
].filter(Boolean).join(" ");
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
export const taskTransitionRecoveryHint = "Pending task transition: before dependent effects, call set_task_tier with the current tier and explicit risk/scope to bind this input to the same task; for a genuinely different task use new_task: true with a reason and obtain human supersession authorization if prior obligations are open. Do not waive while pending; bind first, then use only active addition IDs for the bound task.";
|
|
70
|
+
export const TASK_TRANSITION_ENTRY_TYPE = "agent-hub-task-transition";
|
|
71
|
+
export const TRANSITION_DIVERSION_STOP = 2;
|
|
72
|
+
|
|
73
|
+
/** Resume keeps an unbound transition fenced. A missing entry is the legacy clear state; a corrupt entry fails closed. */
|
|
74
|
+
export function latestPendingTaskTransition(entries: readonly unknown[]): boolean {
|
|
75
|
+
for (let i = entries.length - 1; i >= 0; i--) {
|
|
76
|
+
const entry = entries[i] as { type?: unknown; customType?: unknown; data?: { pending?: unknown } } | null;
|
|
77
|
+
if (!entry || entry.type !== "custom" || entry.customType !== TASK_TRANSITION_ENTRY_TYPE) continue;
|
|
78
|
+
return entry.data?.pending !== false;
|
|
79
|
+
}
|
|
80
|
+
return false;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
/** First non-recovery tool while a transition is pending gets the hint. The next one stops the turn. */
|
|
84
|
+
export function transitionDiversionDecision(count: number, hint: string): { nextCount: number; terminate?: true; reason: string } {
|
|
85
|
+
const nextCount = count + 1;
|
|
86
|
+
if (nextCount >= TRANSITION_DIVERSION_STOP) return { nextCount, terminate: true, reason: `Turn stopped after ${nextCount} tool calls while a task transition was pending. ${hint} Do not call another tool in this turn.` };
|
|
87
|
+
return { nextCount, reason: `${hint} This was diversion ${nextCount} of ${TRANSITION_DIVERSION_STOP}. The next tool that is not set_task_tier or ask_user stops the turn.` };
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
/** One assistant step may emit several tools at once. That step is a single refusal, not a stop:
|
|
91
|
+
* aborting it prevents the model from calling set_task_tier. A later step that still does not bind stops. */
|
|
92
|
+
export function transitionToolDecision(hintDelivered: boolean, count: number, hint: string): { nextCount: number; terminate?: true; reason: string } {
|
|
93
|
+
if (!hintDelivered) return { nextCount: 1, reason: `${hint} Tools in this step are refused, not executed. Call set_task_tier before any other tool. A later step that still does not bind stops the turn.` };
|
|
94
|
+
return transitionDiversionDecision(Math.max(count, 1), hint);
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
export function activeAdditionRecoveryHints(state: ProcessObligationState, taskId: string, inputRevision: string | undefined): string {
|
|
98
|
+
const descriptions = {
|
|
99
|
+
security_change: "Security-sensitive change: independent review before acceptance (not before authoring).",
|
|
100
|
+
wide_change: "Wide change: plan before effects and independent review before acceptance.",
|
|
101
|
+
irreversible_execution: "Potentially irreversible execution: exact action-bound, one-use human confirmation before each effect; unsupported child/peer binding refuses the effect.",
|
|
102
|
+
} as const;
|
|
103
|
+
const active = normalizeProcessState(state).additions!.filter(a => a.status === "active" && a.taskId === taskId);
|
|
104
|
+
if (!active.length) return "";
|
|
105
|
+
return `Active System 1 additions (not baseline): ${active.map(a => `${a.id} — ${descriptions[a.reason]} ${inputRevision && a.inputRevision === inputRevision ? `To contest this exact addition, ask the human to run /af-task-triage-waive ${a.id} <reason>.` : "Waiver unavailable for this input revision; do not reuse a stale authorization."}`).join(" ")} A waiver needs human authorization and cannot remove baseline or other additions.`;
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
/** T5/D2: trusted read-only inspection route for refused shell effects.
|
|
109
|
+
* There is no regex/model-label/operator-mode exemption for arbitrary bash: unknown
|
|
110
|
+
* shell/backend stays a potential effect. The usable route is the effective catalog's
|
|
111
|
+
* deterministic inspection tools with an explicit target path — never the shell string. */
|
|
112
|
+
export function readOnlyInspectionRoute(): string {
|
|
113
|
+
return "Usable read-only route: read/grep/find/ls with an explicit target path (or the filesystem tool when the deterministic-tools opt-in is enabled). Do not execute the shell string; no planner and no slash reset is needed for inspection.";
|
|
114
|
+
}
|
|
115
|
+
export function processActionGate(state: ProcessObligationState, contract?: ActionContract, grant?: ActionGrant): { reason: string; message: string } | null {
|
|
116
|
+
const pending = normalizeProcessState(state).additions!.filter(a => a.status === "active" && a.reason === "irreversible_execution");
|
|
117
|
+
if (!pending.length) return null;
|
|
118
|
+
if (!contract?.actionId || !contract.taskId || !contract.inputRevision || !contract.operation || !contract.target || pending.some(a => a.taskId !== contract.taskId || a.inputRevision !== contract.inputRevision) || !consumeActionGrant(grant, contract)) return { reason: "action_confirmation_unsupported", message: "A task-triage irreversible-action signal requires exact task/revision/action-bound human confirmation; unsupported binding refuses this effect." };
|
|
119
|
+
return null;
|
|
120
|
+
}
|
|
121
|
+
export function processPreEffectGate(state: ProcessObligationState, effect: "write" | "child" | "prove", persona = "", revision?: string): { reason: string; message: string } | null {
|
|
122
|
+
let s: ProcessObligationState;
|
|
123
|
+
try { s = normalizeProcessState(state); } catch { return { reason: "process_state_corrupt", message: "Saved process additions are invalid or oversized; dependent effects are blocked until human recovery of the session state." }; }
|
|
124
|
+
// Only the Hub's direct bash/edit/write effects receive exact-action grants.
|
|
125
|
+
// Only currently needed stage producers may pass the child gate. The native
|
|
126
|
+
// launch restricts their tools to inspection; the Hub persists their output;
|
|
127
|
+
// coms cannot supply this boundary. All other child/peer
|
|
128
|
+
// effects refuse an active confirmation addition as unsupported. Even read-only
|
|
129
|
+
// bash is treated as an effect: no shell-content heuristic grants an exemption.
|
|
130
|
+
const stageProducer = effect === "child" && (persona === "planner"
|
|
131
|
+
? effectiveProcessStage(s, "plan") && !s.plan.evidenceRef
|
|
132
|
+
: ["code-reviewer", "plan-reviewer", "security-auditor"].includes(persona) && effectiveProcessStage(s, "review") && !s.review.evidenceRef);
|
|
133
|
+
if ((effect === "write" || effect === "child") && effectiveProcessStage(s, "plan") && !s.plan.evidenceRef && persona !== "planner") return { reason: "process_plan_open", message: `Process gate refused the dependent effect: the wide-task plan obligation is open. Run the planner first; if no planner is on the roster, ask the human to use /af-agents-add planner or /af-agents-team. ${readOnlyInspectionRoute()}` };
|
|
134
|
+
if ((effect === "write" || effect === "child") && !stageProducer) { const confirmation = processActionGate(s); if (confirmation) return confirmation; }
|
|
135
|
+
if (effect === "prove") { const open = processOpenObligations(s, revision).filter(x => x !== "acceptance" && x !== "action_confirmation"); if (open.length) return { reason: "process_obligations_open", message: `Assertion cannot become proven while process obligations are open: ${open.join(", ")}.` }; }
|
|
136
|
+
return null;
|
|
137
|
+
}
|
|
138
|
+
export function evaluateProcessObligations(state: ProcessObligationState, input: { writable: boolean; budgetTier: string; t2Accepted?: boolean; currentRevision?: string }): ProcessVerdict {
|
|
139
|
+
const s = normalizeProcessState(state); const additions = s.additions!.map(({ id, taskId, evaluationId, inputRevision, reason, status }) => ({ id, taskId, evaluationId, inputRevision, reason, status })); if (!input.writable) return { accepted: false, path: "read-only", risk: s.risk, scope: s.scope, budgetTier: input.budgetTier, obligations: { risk: { status: "unsupported" }, acceptance: { status: "unsupported" }, review: { status: "unsupported" }, plan: { status: "unsupported" } }, additions, appliedRuleIds: rules(s.risk, "read-only"), currentStage: "acceptance", admissibleNextAction: "continue read-only research; changed-task acceptance is unavailable", auditScope: [], explanation: `Read-only source-traceable path; T2 acceptance is unsupported and fails closed. Budget tier ${input.budgetTier} limits spend only.` };
|
|
140
|
+
const status = (stage: ProcessStageState, required = stage.required, revisionBound = true): ObligationStatus => !required ? "satisfied" : stage.evidenceRef && (!revisionBound || !input.currentRevision || stage.revision === input.currentRevision) ? "satisfied" : "open";
|
|
141
|
+
const obligations: ProcessVerdict["obligations"] = { risk: { status: s.risk === "unknown" ? "open" : "satisfied" }, acceptance: { status: input.t2Accepted || status(s.acceptance) === "satisfied" ? "satisfied" : "open", ...(s.acceptance.evidenceRef ? { evidenceRef: s.acceptance.evidenceRef } : {}) }, review: { status: status(s.review, effectiveProcessStage(s, "review")), ...(s.review.evidenceRef ? { evidenceRef: s.review.evidenceRef } : {}) }, plan: { status: status(s.plan, effectiveProcessStage(s, "plan"), false), ...(s.plan.evidenceRef ? { evidenceRef: s.plan.evidenceRef } : {}) } };
|
|
142
|
+
const waivedOnly = (stage: "plan" | "review" | "confirmation") => !effectiveProcessStage(s, stage) && !((stage === "plan" || stage === "review") && s[stage].required) && s.additions!.some(a => a.status === "waived" && (stage === "confirmation" ? a.reason === "irreversible_execution" : stage === "plan" ? a.reason === "wide_change" : a.reason === "wide_change" || a.reason === "security_change"));
|
|
143
|
+
for (const stage of ["plan", "review"] as const) if (waivedOnly(stage)) obligations[stage] = { status: "waived" };
|
|
144
|
+
if (effectiveProcessStage(s, "confirmation") || waivedOnly("confirmation")) obligations.confirmation = { status: effectiveProcessStage(s, "confirmation") ? "open" : "waived" };
|
|
145
|
+
// Confirmation is checked for each exact effect before execution, not a task-level acceptance stage.
|
|
146
|
+
const open = Object.entries(obligations).filter(([name, x]) => name !== "confirmation" && (x.status === "open" || x.status === "unsupported")).map(([x]) => x), accepted = open.length === 0; const currentStage: ProcessStage = open.includes("risk") ? "classify-risk" : open.includes("plan") ? "plan" : open.includes("acceptance") ? "acceptance" : open.includes("review") ? "review" : "complete";
|
|
147
|
+
const next = currentStage === "classify-risk" ? "set_task_tier with explicit risk and reason" : currentStage === "plan" ? "dispatch planner" : currentStage === "acceptance" ? "execute and verify the changed task" : currentStage === "review" ? "dispatch an independent reviewer over the current changed scope" : "report completion";
|
|
148
|
+
return { accepted, path: "changed-task", risk: s.risk, scope: s.scope, budgetTier: input.budgetTier, obligations, additions, appliedRuleIds: s.appliedRuleIds.length ? s.appliedRuleIds : rules(s.risk,s.scope), currentStage, admissibleNextAction: next, auditScope: s.changedFiles, explanation: `Risk ${s.risk} and scope ${s.scope} determine correctness obligations; budget tier ${input.budgetTier} limits spend only.${open.length ? ` Open: ${open.join(", ")}.` : " All task-level obligations satisfied; source waivers remain waived, not satisfied."}${obligations.confirmation?.status === "open" ? " Each future effect still requires exact one-use human confirmation." : ""}` };
|
|
149
|
+
}
|
|
150
|
+
export function processAllowsPersona(state: ProcessObligationState, persona: string): boolean { const name = String(persona||"").trim().toLowerCase(), s=normalizeProcessState(state); return effectiveProcessStage(s, "plan") && name === "planner" || effectiveProcessStage(s, "review") && ["code-reviewer","plan-reviewer","security-auditor"].includes(name); }
|
|
151
|
+
export function processAuditRecord(state: ProcessObligationState, verdict: ProcessVerdict) { return { schema: PROCESS_OBLIGATIONS_SCHEMA, risk: verdict.risk, scope: verdict.scope, budgetTier: verdict.budgetTier, obligations: Object.fromEntries(Object.entries(verdict.obligations).map(([k,v])=>[k,{status:v.status}])), additions: verdict.additions, appliedRuleIds: verdict.appliedRuleIds, currentStage: verdict.currentStage, admissibleNextAction: verdict.admissibleNextAction, auditScope: verdict.auditScope, explanation: verdict.explanation, state: normalizeProcessState(state) }; }
|
|
152
|
+
export function latestProcessState(entries: readonly unknown[]): ProcessObligationState { for(let i=entries.length-1;i>=0;i--){const row=entries[i] as any,type=row?.customType??row?.type;if(type!=="agent-hub-process-state")continue;const data=row?.data;if(data?.schema===PROCESS_OBLIGATIONS_SCHEMA)return normalizeProcessState(data.state??data);}return createProcessState(); }
|
|
153
|
+
|
|
154
|
+
/** A saved addition must never authorize a different or ambiguous recovered task. */
|
|
155
|
+
export function processTaskIdentityConflicts(state: ProcessObligationState, taskId: string): boolean {
|
|
156
|
+
const ids = new Set(state.additions?.map(addition => addition.taskId));
|
|
157
|
+
return ids.size > 1 || ids.size === 1 && !ids.has(taskId);
|
|
158
|
+
}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import type { CapabilityPack, CapabilityResolution } from "../capability-packs.ts";
|
|
2
|
+
import type { WorkMode } from "../work-mode.ts";
|
|
3
|
+
import type { AgenticConfig } from "../agentic-contract.ts";
|
|
4
|
+
|
|
5
|
+
export interface HubPromptAgent {
|
|
6
|
+
name: string;
|
|
7
|
+
displayName: string;
|
|
8
|
+
description: string;
|
|
9
|
+
tools: string;
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
export interface HubPromptResearchPersona {
|
|
13
|
+
name: string;
|
|
14
|
+
displayName: string;
|
|
15
|
+
description: string;
|
|
16
|
+
model?: string;
|
|
17
|
+
thinking: string;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
export interface HubPromptState {
|
|
21
|
+
taskTier: string;
|
|
22
|
+
taskTierAssumed: boolean;
|
|
23
|
+
processRisk?: string;
|
|
24
|
+
processScope?: string;
|
|
25
|
+
processOpen?: readonly string[];
|
|
26
|
+
turnDispatchCount: number;
|
|
27
|
+
turnResearchCount: number;
|
|
28
|
+
taskDispatchCount: number;
|
|
29
|
+
taskResearchCount: number;
|
|
30
|
+
taskReviewRounds: number;
|
|
31
|
+
turnBudget: { maxDispatches: number | null; maxResearch: number | null };
|
|
32
|
+
taskBudget: { wallMs: number | null };
|
|
33
|
+
provisionalConfirmations: readonly { pack: CapabilityPack; reason: string; question: string | { question: string; context?: string; options?: string[] } }[];
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
/** Read-only prompt dependencies. Mutable Hub state remains owned by index.ts. */
|
|
37
|
+
export interface HubPromptContext {
|
|
38
|
+
getArtifactRoot?(): string | null;
|
|
39
|
+
getTriageBeforeDispatch?(): boolean;
|
|
40
|
+
getAgenticAskMode?(): AgenticConfig["mode"];
|
|
41
|
+
getCapabilityResolution(): CapabilityResolution;
|
|
42
|
+
getActiveTools(): readonly string[];
|
|
43
|
+
getToolCatalogNotice?(): string;
|
|
44
|
+
getAgents(): readonly HubPromptAgent[];
|
|
45
|
+
getResearchPersonas(): readonly HubPromptResearchPersona[];
|
|
46
|
+
getPromptState(): HubPromptState;
|
|
47
|
+
getWorkMode(): WorkMode;
|
|
48
|
+
getActiveTeamName(): string;
|
|
49
|
+
getUserLanguage(): string;
|
|
50
|
+
getRulesProtocol(): string;
|
|
51
|
+
getDocsProtocol(): string;
|
|
52
|
+
isAskUserAvailable(): boolean;
|
|
53
|
+
isComsReady(): boolean;
|
|
54
|
+
getIdentity(): { name: string; project: string } | null;
|
|
55
|
+
isHerdrFleetReady(): boolean;
|
|
56
|
+
}
|