@chankov/agent-fleet 2.0.17 → 2.0.18
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.pi/agent-fleet/scripts/coms-claude-bridge.ts +75 -49
- package/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +18 -20
- package/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +3 -1
- package/.pi/agents/model-profiles.yaml +5 -5
- package/.pi/agents/peers.yaml +3 -3
- package/.pi/agents/voices.yaml +1 -1
- package/.pi/harnesses/agent-hub/README.md +35 -8
- package/.pi/harnesses/agent-hub/agentic-sources.ts +29 -5
- package/.pi/harnesses/agent-hub/config/overrides.ts +13 -3
- package/.pi/harnesses/agent-hub/delegate.ts +16 -5
- package/.pi/harnesses/agent-hub/deterministic-fs.ts +7 -4
- package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +13 -2
- package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +2 -0
- package/.pi/harnesses/agent-hub/dispatch-native-types.ts +7 -0
- package/.pi/harnesses/agent-hub/dispatch-native.ts +1 -1
- package/.pi/harnesses/agent-hub/file-discovery/adapters.ts +82 -0
- package/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +56 -0
- package/.pi/harnesses/agent-hub/file-discovery/broker.ts +125 -0
- package/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +33 -0
- package/.pi/harnesses/agent-hub/file-discovery/descendant.ts +63 -0
- package/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
- package/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
- package/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +48 -0
- package/.pi/harnesses/agent-hub/file-discovery/hub.ts +152 -0
- package/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
- package/.pi/harnesses/agent-hub/file-discovery/owners.ts +96 -0
- package/.pi/harnesses/agent-hub/file-discovery/results.ts +54 -0
- package/.pi/harnesses/agent-hub/file-discovery/runtime.ts +120 -0
- package/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
- package/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
- package/.pi/harnesses/agent-hub/filesystem-tool.ts +74 -26
- package/.pi/harnesses/agent-hub/index.ts +23 -5
- package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +3 -2
- package/.pi/harnesses/agent-hub/no-progress.ts +45 -15
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/policy/work-mode.ts +2 -1
- package/.pi/harnesses/agent-hub/proactive-config.ts +8 -3
- package/.pi/harnesses/agent-hub/proactive-external-git.ts +59 -0
- package/.pi/harnesses/agent-hub/proactive-external.ts +77 -0
- package/.pi/harnesses/agent-hub/proactive-local.ts +25 -7
- package/.pi/harnesses/agent-hub/proactive-observer.ts +2 -1
- package/.pi/harnesses/agent-hub/proactive-rules.ts +39 -11
- package/.pi/harnesses/agent-hub/proactive-runtime.ts +8 -6
- package/.pi/harnesses/agent-hub/proactive-snapshot.ts +32 -2
- package/.pi/harnesses/agent-hub/proactive-types.ts +5 -1
- package/.pi/harnesses/agent-hub/prompts/fragments.ts +21 -49
- package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +2 -1
- package/.pi/harnesses/agent-hub/research/runtime.ts +7 -3
- package/.pi/harnesses/agent-hub/research/spawn-run.ts +17 -6
- package/.pi/harnesses/agent-hub/spawn.ts +38 -9
- package/.pi/harnesses/agent-hub/system1-communication-store.ts +39 -0
- package/.pi/harnesses/agent-hub/tools/action-executors.ts +6 -1
- package/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
- package/.pi/harnesses/agent-hub/tools/ask-system1.ts +1 -1
- package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +4 -4
- package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +4 -2
- package/.pi/harnesses/agent-hub/tools/set-task-tier.ts +3 -3
- package/.pi/harnesses/agent-hub/tools/spawn-research.ts +3 -1
- package/.pi/harnesses/agent-hub/ui/system1-communication.ts +1 -1
- package/.pi/harnesses/agent-hub/work-mode.ts +3 -0
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/context-budget-child-prompt.ts +3 -2
- package/.pi/harnesses/lib/deterministic-handle-path.ts +2 -0
- package/.pi/harnesses/lib/policy-roots.ts +142 -0
- package/.pi/harnesses/lib/system1/config-agentic.js +2 -1
- package/.pi/harnesses/lib/system1/config-file-discovery.js +21 -0
- package/.pi/harnesses/lib/system1/config-proactive.js +13 -2
- package/.pi/harnesses/lib/system1/config-v2.js +8 -5
- package/.versions/2.0.18/.pi/agent-fleet/hermes/README.md +347 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.18/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.18/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/coms-claude-bridge.ts +437 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/fleet.ts +217 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/flow.ts +157 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/package-lock.json +35 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/package.json +9 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/team-up.ts +378 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +36 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
- package/.versions/2.0.18/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.18/.pi/agents/model-profiles.yaml +134 -0
- package/.versions/2.0.18/.pi/agents/peers.yaml +147 -0
- package/.versions/2.0.18/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.18/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.18/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.18/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.18/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.18/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.18/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.18/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.18/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.18/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.18/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.18/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.18/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.18/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.18/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.18/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.18/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.18/.pi/extensions/package.json +9 -0
- package/.versions/2.0.18/.pi/extensions/pi-voice-stt/README.md +224 -0
- package/.versions/2.0.18/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.18/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.18/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.18/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.18/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.18/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/README.md +1483 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/acceptance.ts +199 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/context.ts +47 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/config/agents.ts +178 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/config/overrides.ts +165 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/context/budgets.ts +206 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/context-window.js +108 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/delegate.ts +478 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/deterministic-fs.ts +169 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +270 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +233 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-native-types.ts +267 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-native.ts +234 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/docs-lane.js +123 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/adapters.ts +82 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +56 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/broker.ts +125 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +33 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/descendant.ts +63 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +48 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/hub.ts +152 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +99 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/owners.ts +96 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/results.ts +54 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/runtime.ts +120 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/filesystem-tool.ts +185 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/fixtures/registration-surface.json +65 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/helpers.ts +270 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/index.ts +2625 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/input/completions.ts +82 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +133 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +144 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/no-progress.ts +593 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/orchestration-activation.ts +112 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/orchestration-route.ts +76 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/policy/work-mode.ts +137 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-config.ts +21 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-external-git.ts +59 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-external.ts +77 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-snapshot.ts +258 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-types.ts +67 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/process-obligations.ts +158 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/prompts/context.ts +56 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/prompts/fragments.ts +95 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/prompts/system-prompt.ts +125 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/reconcile.ts +26 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/recover-state.ts +104 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/recovery-contract.ts +150 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/research/runtime.ts +201 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/research/spawn-run.ts +194 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/return-contract.js +349 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/return-extract.js +77 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/review-closure.ts +43 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/review-findings.js +104 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/run-budget.js +554 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/run-namespace.js +93 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/scope-gate.js +144 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/session-audit.ts +313 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/spawn.ts +563 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/system1-communication-store.ts +190 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/system1-report.ts +275 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/system1-runtime.ts +258 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-authorization.ts +122 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-config.ts +29 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-obligations.ts +104 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-runtime.ts +125 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/timeline.ts +72 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/action-executors.ts +213 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/context.ts +144 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +560 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/tsconfig.json +22 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/types.ts +66 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/work-mode.ts +187 -0
- package/.versions/2.0.18/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
- package/.versions/2.0.18/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.18/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.18/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.18/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.18/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
- package/.versions/2.0.18/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.18/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.18/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.18/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.18/.pi/harnesses/damage-control-continue/README.md +135 -0
- package/.versions/2.0.18/.pi/harnesses/damage-control-continue/index.ts +533 -0
- package/.versions/2.0.18/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.18/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.18/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
- package/.versions/2.0.18/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.18/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.18/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.18/.pi/harnesses/lib/context-budget-child-prompt.ts +220 -0
- package/.versions/2.0.18/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
- package/.versions/2.0.18/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.18/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.18/.pi/harnesses/lib/damage-control-shared.ts +226 -0
- package/.versions/2.0.18/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
- package/.versions/2.0.18/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.18/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.18/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.18/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
- package/.versions/2.0.18/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
- package/.versions/2.0.18/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
- package/.versions/2.0.18/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.18/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.18/.pi/harnesses/lib/fleet-read-model.ts +609 -0
- package/.versions/2.0.18/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.18/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
- package/.versions/2.0.18/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
- package/.versions/2.0.18/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.18/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.18/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.18/.pi/harnesses/lib/policy-roots.ts +142 -0
- package/.versions/2.0.18/.pi/harnesses/lib/safe-source-read.js +29 -0
- package/.versions/2.0.18/.pi/harnesses/lib/spawned-peers.js +191 -0
- package/.versions/2.0.18/.pi/harnesses/lib/system1/config-agentic.js +15 -0
- package/.versions/2.0.18/.pi/harnesses/lib/system1/config-file-discovery.js +21 -0
- package/.versions/2.0.18/.pi/harnesses/lib/system1/config-json.js +37 -0
- package/.versions/2.0.18/.pi/harnesses/lib/system1/config-loader.js +44 -0
- package/.versions/2.0.18/.pi/harnesses/lib/system1/config-proactive.js +68 -0
- package/.versions/2.0.18/.pi/harnesses/lib/system1/config-triage.js +42 -0
- package/.versions/2.0.18/.pi/harnesses/lib/system1/config-v2.js +106 -0
- package/.versions/2.0.18/.pi/harnesses/lib/system1/config.js +50 -0
- package/.versions/2.0.18/.pi/harnesses/lib/system1/contracts.ts +154 -0
- package/.versions/2.0.18/.pi/harnesses/lib/system1/demo.ts +95 -0
- package/.versions/2.0.18/.pi/harnesses/lib/system1/jev.ts +503 -0
- package/.versions/2.0.18/.pi/harnesses/lib/system1/selection.js +11 -0
- package/.versions/2.0.18/.pi/harnesses/lib/system1/service.ts +245 -0
- package/.versions/2.0.18/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.18/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.18/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.18/.pi/prompts/af-build.md +27 -0
- package/.versions/2.0.18/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.18/.pi/prompts/af-constraints.md +31 -0
- package/.versions/2.0.18/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.18/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.18/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.18/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.18/.pi/prompts/af-setup-rules.md +20 -0
- package/.versions/2.0.18/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.18/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.18/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.18/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.18/.version +1 -0
- package/.versions/2.0.18/agents/architect.md +24 -0
- package/.versions/2.0.18/agents/bowser.md +28 -0
- package/.versions/2.0.18/agents/builder.md +55 -0
- package/.versions/2.0.18/agents/code-reviewer.md +209 -0
- package/.versions/2.0.18/agents/deep-researcher.md +32 -0
- package/.versions/2.0.18/agents/documenter.md +22 -0
- package/.versions/2.0.18/agents/orchestrator.md +22 -0
- package/.versions/2.0.18/agents/plan-reviewer.md +83 -0
- package/.versions/2.0.18/agents/planner.md +105 -0
- package/.versions/2.0.18/agents/releaser.md +24 -0
- package/.versions/2.0.18/agents/researcher.md +30 -0
- package/.versions/2.0.18/agents/security-auditor.md +167 -0
- package/.versions/2.0.18/agents/test-engineer.md +153 -0
- package/.versions/2.0.18/agents/web-debugger.md +44 -0
- package/.versions/2.0.18/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.18/bin/catalog/harness-runtime-closure.json +73 -0
- package/.versions/2.0.18/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.18/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.18/docs/ARCHITECTURE.md +874 -0
- package/.versions/2.0.18/docs/agent-fleet-setup.md +1101 -0
- package/.versions/2.0.18/docs/claude-code-coms-bridge.md +147 -0
- package/.versions/2.0.18/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.18/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.18/docs/getting-started.md +126 -0
- package/.versions/2.0.18/docs/npm-install.md +535 -0
- package/.versions/2.0.18/docs/pi-extensions.md +454 -0
- package/.versions/2.0.18/docs/pi-setup.md +92 -0
- package/.versions/2.0.18/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.18/install-manifest.json +3193 -0
- package/.versions/2.0.18/justfile +247 -0
- package/.versions/2.0.18/manifest-meta.json +1071 -0
- package/.versions/2.0.18/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.18/references/communication-contract.md +26 -0
- package/.versions/2.0.18/references/definition-of-done.md +67 -0
- package/.versions/2.0.18/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.18/references/observability-checklist.md +92 -0
- package/.versions/2.0.18/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.18/references/performance-checklist.md +236 -0
- package/.versions/2.0.18/references/prompting-patterns.md +380 -0
- package/.versions/2.0.18/references/security-checklist.md +245 -0
- package/.versions/2.0.18/references/testing-patterns.md +235 -0
- package/.versions/2.0.18/references/workflow-authoring.md +304 -0
- package/.versions/2.0.18/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.18/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.18/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.18/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.18/skills/constraint-driven-development/SKILL.md +338 -0
- package/.versions/2.0.18/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.18/skills/context-engineering/SKILL.md +341 -0
- package/.versions/2.0.18/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.18/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.18/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.18/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.18/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.18/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.18/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.18/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.18/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.18/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.18/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.18/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.18/skills/incremental-implementation/SKILL.md +353 -0
- package/.versions/2.0.18/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.18/skills/orchestration-verification/SKILL.md +182 -0
- package/.versions/2.0.18/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.18/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.18/skills/planning-and-task-breakdown/SKILL.md +318 -0
- package/.versions/2.0.18/skills/repository-ai-setup/SKILL.md +135 -0
- package/.versions/2.0.18/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
- package/.versions/2.0.18/skills/repository-ai-setup/references/apply-contract.md +74 -0
- package/.versions/2.0.18/skills/repository-ai-setup/references/provenance-template.md +16 -0
- package/.versions/2.0.18/skills/repository-ai-setup/references/setup-flow.md +108 -0
- package/.versions/2.0.18/skills/repository-ai-setup/references/verify-setup.md +20 -0
- package/.versions/2.0.18/skills/repository-ai-setup.zip +0 -0
- package/.versions/2.0.18/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.18/skills/spec-driven-development/SKILL.md +295 -0
- package/.versions/2.0.18/skills/using-agent-skills/SKILL.md +198 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/README.md +430 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
- package/.versions/2.0.18/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
- package/CHANGELOG.md +6 -0
- package/README.md +2 -2
- package/agents/architect.md +2 -2
- package/agents/bowser.md +1 -1
- package/agents/builder.md +5 -5
- package/agents/code-reviewer.md +2 -2
- package/agents/deep-researcher.md +2 -2
- package/agents/documenter.md +3 -3
- package/agents/orchestrator.md +2 -2
- package/agents/plan-reviewer.md +2 -2
- package/agents/planner.md +4 -4
- package/agents/releaser.md +2 -2
- package/agents/researcher.md +2 -2
- package/agents/security-auditor.md +2 -2
- package/agents/test-engineer.md +4 -4
- package/agents/web-debugger.md +2 -2
- package/agents/web-performance-auditor.md +2 -2
- package/bin/cli.js +2 -2
- package/bin/lib/external-content.js +33 -0
- package/bin/lib/project-provenance.js +19 -13
- package/bin/lib/transaction.js +32 -1
- package/docs/ARCHITECTURE.md +42 -2
- package/docs/agent-fleet-setup.md +4 -4
- package/docs/claude-code-coms-bridge.md +17 -4
- package/docs/external-project-ai-content.md +48 -0
- package/docs/npm-install.md +5 -0
- package/docs/system1-agentic.md +27 -0
- package/docs/system1-config.md +23 -1
- package/docs/system1-file-discovery.md +220 -0
- package/install-manifest.json +1 -1
- package/package.json +15 -6
- package/skills/repository-ai-setup/SKILL.md +18 -0
- package/skills/repository-ai-setup.zip +0 -0
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: using-agent-skills
|
|
3
|
+
description: Discovers and invokes agent skills. Use when starting a session, or when you need to decide which skill or workflow applies to the piece of work at hand. This is the meta-skill that governs how all other skills are discovered and invoked.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Using Agent Skills
|
|
7
|
+
|
|
8
|
+
## Overview
|
|
9
|
+
|
|
10
|
+
Agent Skills is a collection of engineering workflow skills organized by development phase. Each skill encodes a specific process that senior engineers follow. This meta-skill helps you discover and apply the right skill for your current task.
|
|
11
|
+
|
|
12
|
+
## Skill Discovery
|
|
13
|
+
|
|
14
|
+
When a task arrives, identify the development phase and apply the corresponding skill:
|
|
15
|
+
|
|
16
|
+
```
|
|
17
|
+
Task arrives
|
|
18
|
+
│
|
|
19
|
+
├── Don't know what you want yet? ──────→ interview-me
|
|
20
|
+
├── Have a rough concept, need variants? → idea-refine
|
|
21
|
+
├── New project/feature/change? ──→ spec-driven-development
|
|
22
|
+
├── No quality bar written down? ──→ constraint-driven-development
|
|
23
|
+
├── Have a spec, need tasks? ──────→ planning-and-task-breakdown
|
|
24
|
+
├── Implementing code? ────────────→ incremental-implementation
|
|
25
|
+
│ ├── UI work? ─────────────────→ frontend-ui-engineering
|
|
26
|
+
│ ├── API work? ────────────────→ api-and-interface-design
|
|
27
|
+
│ ├── Need better context? ─────→ context-engineering
|
|
28
|
+
│ ├── Need doc-verified code? ───→ source-driven-development
|
|
29
|
+
│ └── Stakes high / unfamiliar code? ──→ doubt-driven-development
|
|
30
|
+
├── Writing/running tests? ────────→ test-driven-development
|
|
31
|
+
│ └── Browser-based? ───────────→ browser-testing-with-devtools
|
|
32
|
+
├── Something broke? ──────────────→ debugging-and-error-recovery
|
|
33
|
+
├── Reviewing code? ───────────────→ code-review-and-quality
|
|
34
|
+
│ ├── Too complex? ─────────────→ code-simplification
|
|
35
|
+
│ ├── Security concerns? ───────→ security-and-hardening
|
|
36
|
+
│ └── Performance concerns? ────→ performance-optimization
|
|
37
|
+
├── Committing/branching? ─────────→ git-workflow-and-versioning
|
|
38
|
+
├── CI/CD pipeline work? ──────────→ ci-cd-and-automation
|
|
39
|
+
├── Deprecating/migrating? ────────→ deprecation-and-migration
|
|
40
|
+
├── Writing docs/ADRs? ───────────→ documentation-and-adrs
|
|
41
|
+
├── Adding logs/metrics/alerts? ───→ observability-and-instrumentation
|
|
42
|
+
└── Deploying/launching? ─────────→ shipping-and-launch
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## Core Operating Behaviors
|
|
46
|
+
|
|
47
|
+
These behaviors apply at all times, across all skills. They are non-negotiable.
|
|
48
|
+
|
|
49
|
+
### 1. Surface Assumptions
|
|
50
|
+
|
|
51
|
+
Before implementing anything non-trivial, explicitly state your assumptions:
|
|
52
|
+
|
|
53
|
+
```
|
|
54
|
+
ASSUMPTIONS I'M MAKING:
|
|
55
|
+
1. [assumption about requirements]
|
|
56
|
+
2. [assumption about architecture]
|
|
57
|
+
3. [assumption about scope]
|
|
58
|
+
→ Correct me now or I'll proceed with these.
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
Don't silently fill in ambiguous requirements. The most common failure mode is making wrong assumptions and running with them unchecked. Surface uncertainty early — it's cheaper than rework.
|
|
62
|
+
|
|
63
|
+
### 2. Manage Confusion Actively
|
|
64
|
+
|
|
65
|
+
When you encounter inconsistencies, conflicting requirements, or unclear specifications:
|
|
66
|
+
|
|
67
|
+
1. **STOP.** Do not proceed with a guess.
|
|
68
|
+
2. Name the specific confusion.
|
|
69
|
+
3. Present the tradeoff or ask the clarifying question.
|
|
70
|
+
4. Wait for resolution before continuing.
|
|
71
|
+
|
|
72
|
+
**Bad:** Silently picking one interpretation and hoping it's right.
|
|
73
|
+
**Good:** "I see X in the spec but Y in the existing code. Which takes precedence?"
|
|
74
|
+
|
|
75
|
+
### 3. Push Back When Warranted
|
|
76
|
+
|
|
77
|
+
You are not a yes-machine. When an approach has clear problems:
|
|
78
|
+
|
|
79
|
+
- Point out the issue directly
|
|
80
|
+
- Explain the concrete downside (quantify when possible — "this adds ~200ms latency" not "this might be slower")
|
|
81
|
+
- Propose an alternative
|
|
82
|
+
- Accept the human's decision if they override with full information
|
|
83
|
+
|
|
84
|
+
Sycophancy is a failure mode. "Of course!" followed by implementing a bad idea helps no one. Honest technical disagreement is more valuable than false agreement.
|
|
85
|
+
|
|
86
|
+
### 4. Enforce Simplicity
|
|
87
|
+
|
|
88
|
+
Your natural tendency is to overcomplicate. Actively resist it.
|
|
89
|
+
|
|
90
|
+
Before finishing any implementation, ask:
|
|
91
|
+
- Can this be done in fewer lines?
|
|
92
|
+
- Are these abstractions earning their complexity?
|
|
93
|
+
- Would a staff engineer look at this and say "why didn't you just..."?
|
|
94
|
+
|
|
95
|
+
If you build 1000 lines and 100 would suffice, you have failed. Prefer the boring, obvious solution. Cleverness is expensive.
|
|
96
|
+
|
|
97
|
+
### 5. Maintain Scope Discipline
|
|
98
|
+
|
|
99
|
+
Touch only what you're asked to touch.
|
|
100
|
+
|
|
101
|
+
Do NOT:
|
|
102
|
+
- Remove comments you don't understand
|
|
103
|
+
- "Clean up" code orthogonal to the task
|
|
104
|
+
- Refactor adjacent systems as a side effect
|
|
105
|
+
- Delete code that seems unused without explicit approval
|
|
106
|
+
- Add features not in the spec because they "seem useful"
|
|
107
|
+
|
|
108
|
+
Your job is surgical precision, not unsolicited renovation.
|
|
109
|
+
|
|
110
|
+
### 6. Verify, Don't Assume
|
|
111
|
+
|
|
112
|
+
Every skill includes a verification step. A task is not complete until verification passes. "Seems right" is never sufficient — there must be evidence (passing tests, build output, runtime data).
|
|
113
|
+
|
|
114
|
+
Per-skill verification is the local check. The project-wide bar that applies to *every* change, regardless of which skill is active, is the Definition of Done: tests pass, no regressions, behavior verified at runtime, docs updated. See `../../references/definition-of-done.md`. It complements each task's acceptance criteria rather than replacing them.
|
|
115
|
+
|
|
116
|
+
## Failure Modes to Avoid
|
|
117
|
+
|
|
118
|
+
These are the subtle errors that look like productivity but create problems:
|
|
119
|
+
|
|
120
|
+
1. Making wrong assumptions without checking
|
|
121
|
+
2. Not managing your own confusion — plowing ahead when lost
|
|
122
|
+
3. Not surfacing inconsistencies you notice
|
|
123
|
+
4. Not presenting tradeoffs on non-obvious decisions
|
|
124
|
+
5. Being sycophantic ("Of course!") to approaches with clear problems
|
|
125
|
+
6. Overcomplicating code and APIs
|
|
126
|
+
7. Modifying code or comments orthogonal to the task
|
|
127
|
+
8. Removing things you don't fully understand
|
|
128
|
+
9. Building without a spec because "it's obvious"
|
|
129
|
+
10. Skipping verification because "it looks right"
|
|
130
|
+
|
|
131
|
+
## Skill Rules
|
|
132
|
+
|
|
133
|
+
1. **Check for an applicable skill before starting work.** Skills encode processes that prevent common mistakes.
|
|
134
|
+
|
|
135
|
+
2. **Skills are workflows, not suggestions.** Follow the steps in order. Don't skip verification steps.
|
|
136
|
+
|
|
137
|
+
3. **Multiple skills can apply.** A feature implementation might involve `idea-refine` → `spec-driven-development` → `planning-and-task-breakdown` → `incremental-implementation` → `test-driven-development` → `code-review-and-quality` → `code-simplification` → `shipping-and-launch` in sequence.
|
|
138
|
+
|
|
139
|
+
4. **When in doubt, start with a spec.** If the task is non-trivial and there's no spec, begin with `spec-driven-development`.
|
|
140
|
+
|
|
141
|
+
## Lifecycle Sequence
|
|
142
|
+
|
|
143
|
+
For a complete feature, the typical skill sequence is:
|
|
144
|
+
|
|
145
|
+
```
|
|
146
|
+
1. interview-me → Extract what the user actually wants
|
|
147
|
+
2. idea-refine → Refine vague ideas
|
|
148
|
+
3. spec-driven-development → Define what we're building
|
|
149
|
+
4. planning-and-task-breakdown → Break into verifiable chunks
|
|
150
|
+
5. context-engineering → Load the right context
|
|
151
|
+
6. source-driven-development → Verify against official docs
|
|
152
|
+
7. incremental-implementation → Build slice by slice
|
|
153
|
+
8. observability-and-instrumentation → Instrument as you build (runs parallel with 7-9, not after)
|
|
154
|
+
9. doubt-driven-development → Cross-examine non-trivial decisions in-flight
|
|
155
|
+
10. test-driven-development → Prove each slice works
|
|
156
|
+
11. code-review-and-quality → Review before merge
|
|
157
|
+
12. code-simplification → Reduce unnecessary complexity while preserving behavior
|
|
158
|
+
13. git-workflow-and-versioning → Clean commit history
|
|
159
|
+
14. documentation-and-adrs → Document decisions
|
|
160
|
+
15. deprecation-and-migration → Retire old systems and move users safely when needed
|
|
161
|
+
16. shipping-and-launch → Deploy safely
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
Not every task needs every skill. A bug fix might only need: `debugging-and-error-recovery` → `test-driven-development` → `code-review-and-quality`.
|
|
165
|
+
|
|
166
|
+
## Quick Reference
|
|
167
|
+
|
|
168
|
+
| Phase | Skill | One-Line Summary |
|
|
169
|
+
|-------|-------|-----------------|
|
|
170
|
+
| Define | interview-me | Surface what the user actually wants before any plan, spec, or code exists |
|
|
171
|
+
| Define | idea-refine | Refine ideas through structured divergent and convergent thinking |
|
|
172
|
+
| Define | spec-driven-development | Requirements and acceptance criteria before code |
|
|
173
|
+
| Plan | planning-and-task-breakdown | Decompose into small, verifiable tasks |
|
|
174
|
+
| Build | incremental-implementation | Thin vertical slices, test each before expanding |
|
|
175
|
+
| Build | source-driven-development | Verify against official docs before implementing |
|
|
176
|
+
| Build | doubt-driven-development | Adversarial fresh-context review of every non-trivial decision |
|
|
177
|
+
| Build | context-engineering | Right context at the right time |
|
|
178
|
+
| Build | frontend-ui-engineering | Production-quality UI with accessibility |
|
|
179
|
+
| Build | api-and-interface-design | Stable interfaces with clear contracts |
|
|
180
|
+
| Verify | test-driven-development | Failing test first, then make it pass |
|
|
181
|
+
| Verify | browser-testing-with-devtools | Chrome DevTools MCP for runtime verification |
|
|
182
|
+
| Verify | debugging-and-error-recovery | Reproduce → localize → fix → guard |
|
|
183
|
+
| Review | code-review-and-quality | Five-axis review with quality gates |
|
|
184
|
+
| Review | code-simplification | Preserve behavior while reducing unnecessary complexity |
|
|
185
|
+
| Review | security-and-hardening | OWASP prevention, input validation, least privilege |
|
|
186
|
+
| Review | performance-optimization | Measure first, optimize only what matters |
|
|
187
|
+
| Ship | git-workflow-and-versioning | Atomic commits, clean history |
|
|
188
|
+
| Ship | ci-cd-and-automation | Automated quality gates on every change |
|
|
189
|
+
| Ship | deprecation-and-migration | Remove old systems and migrate users safely |
|
|
190
|
+
| Ship | documentation-and-adrs | Document the why, not just the what |
|
|
191
|
+
| Ship | observability-and-instrumentation | Structured logs, RED metrics, traces, symptom-based alerts |
|
|
192
|
+
| Ship | shipping-and-launch | Pre-launch checklist, monitoring, rollback plan |
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
# Agent Fleet changelog
|
|
2
2
|
|
|
3
|
+
## 2.0.18
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- ade610d: Declare `@sinclair/typebox` and `typebox` as wildcard peer dependencies instead of runtime dependencies so Pi uses its host-provided modules without startup warnings. Keep both packages as development dependencies for local tests and typechecking. Fixes #36.
|
|
8
|
+
|
|
3
9
|
## 2.0.17
|
|
4
10
|
|
|
5
11
|
### Patch Changes
|
package/README.md
CHANGED
|
@@ -211,7 +211,7 @@ Versioned with [semver](https://semver.org) — [CHANGELOG.md](CHANGELOG.md) ·
|
|
|
211
211
|
| **GitHub Copilot subscription** | `github-copilot/claude-sonnet-4.6`, `github-copilot/claude-haiku-4.5` | Common override for `builder` / reviewers |
|
|
212
212
|
| **Claude subscription** | a real **Claude Code pane**, bridged in as a first-class coms peer | `plan-reviewer` and `code-reviewer` — cross-model review |
|
|
213
213
|
| **Ollama — cloud *or* local** | `ollama/glm-5.2:cloud`, `ollama/minimax-m3:cloud`, or a model on your own box | Overflow capacity and cost control |
|
|
214
|
-
| **Anything else pi can address** | local MLX / llama.cpp / LM Studio weights; bundled `local-full` and `local-workers` use `
|
|
214
|
+
| **Anything else pi can address** | local MLX / llama.cpp / LM Studio weights; bundled `local-full` and `local-workers` use `incoai/Qwen3.8-27B-Splash` |
|
|
215
215
|
|
|
216
216
|
Two consequences worth spelling out:
|
|
217
217
|
|
|
@@ -222,7 +222,7 @@ Two consequences worth spelling out:
|
|
|
222
222
|
/af-models fast # move the whole team down a tier
|
|
223
223
|
/af-agent-model builder github-copilot/claude-sonnet-4.6
|
|
224
224
|
/af-agent-models-substitute # visually pick a session-wide source → target mapping
|
|
225
|
-
/af-agent-models-substitute openai-codex/gpt-6-sol ollama/glm-5.2:cloud # same operation, direct form
|
|
225
|
+
/af-agent-models-substitute openai-codex/gpt-6.1-sol ollama/glm-5.2:cloud # same operation, direct form
|
|
226
226
|
```
|
|
227
227
|
|
|
228
228
|
Per-project defaults live in `.ai/agent-fleet-overrides.md` — see [docs/agent-fleet-setup.md](docs/agent-fleet-setup.md).
|
package/agents/architect.md
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: architect
|
|
3
3
|
description: System architect — owns design decisions and migration strategy; answers design questions with concrete, justified recommendations.
|
|
4
|
-
model: openai-codex/gpt-6-sol
|
|
4
|
+
model: openai-codex/gpt-6.1-sol
|
|
5
5
|
models:
|
|
6
6
|
- github-copilot/claude-opus-5
|
|
7
7
|
- openai-codex/gpt-6-luna
|
|
8
8
|
- ollama/nemotron-3-ultra:cloud
|
|
9
9
|
- ollama/glm-5.2:cloud
|
|
10
|
-
-
|
|
10
|
+
- incoai/Qwen3.8-27B-Splash
|
|
11
11
|
thinking: high
|
|
12
12
|
---
|
|
13
13
|
|
package/agents/bowser.md
CHANGED
package/agents/builder.md
CHANGED
|
@@ -2,24 +2,24 @@
|
|
|
2
2
|
name: builder
|
|
3
3
|
description: Implementation and code generation — lands changes in small verifiable increments. Use for implementing features, fixes, and refactors once the task is defined.
|
|
4
4
|
tools: read,write,edit,bash,grep,find,ls
|
|
5
|
-
model: openai-codex/gpt-6-sol
|
|
5
|
+
model: openai-codex/gpt-6.1-sol
|
|
6
6
|
models:
|
|
7
7
|
- github-copilot/claude-opus-5
|
|
8
8
|
- openai-codex/gpt-6-luna
|
|
9
|
-
- openai-codex/gpt-
|
|
9
|
+
- openai-codex/gpt-6-luna
|
|
10
10
|
- ollama/minimax-m3:cloud
|
|
11
11
|
- ollama/kimi-k2.7-code:cloud
|
|
12
12
|
- ollama/glm-5.2:cloud
|
|
13
13
|
- ollama/nemotron-3-ultra:cloud
|
|
14
|
-
-
|
|
14
|
+
- incoai/Qwen3.8-27B-Splash
|
|
15
15
|
thinking: medium
|
|
16
16
|
delegate_depth: 1
|
|
17
17
|
subagents:
|
|
18
18
|
recon:
|
|
19
|
-
model: openai-codex/gpt-
|
|
19
|
+
model: openai-codex/gpt-6-luna
|
|
20
20
|
tools: read,grep,find,ls
|
|
21
21
|
verifier:
|
|
22
|
-
model: openai-codex/gpt-
|
|
22
|
+
model: openai-codex/gpt-6-luna
|
|
23
23
|
tools: read,bash,grep,find,ls
|
|
24
24
|
---
|
|
25
25
|
You are a builder agent. Implement the requested changes thoroughly. Write clean, minimal code. Follow existing patterns in the codebase. Test your work when possible.
|
package/agents/code-reviewer.md
CHANGED
|
@@ -7,12 +7,12 @@ model: xai/grok-4.7
|
|
|
7
7
|
models:
|
|
8
8
|
- openai-codex/gpt-6-luna
|
|
9
9
|
- github-copilot/claude-opus-5
|
|
10
|
-
- openai-codex/gpt-6-sol
|
|
10
|
+
- openai-codex/gpt-6.1-sol
|
|
11
11
|
- ollama/nemotron-3-ultra:cloud
|
|
12
12
|
- ollama/kimi-k2.7-code:cloud
|
|
13
13
|
- ollama/glm-5.2:cloud
|
|
14
14
|
- ollama/minimax-m3:cloud
|
|
15
|
-
-
|
|
15
|
+
- incoai/Qwen3.8-27B-Splash
|
|
16
16
|
thinking: medium
|
|
17
17
|
delegate_depth: 1
|
|
18
18
|
subagents:
|
|
@@ -6,10 +6,10 @@ kind: research
|
|
|
6
6
|
model: xai/grok-4.7
|
|
7
7
|
models:
|
|
8
8
|
- openai-codex/gpt-6-luna
|
|
9
|
-
- openai-codex/gpt-6-sol
|
|
9
|
+
- openai-codex/gpt-6.1-sol
|
|
10
10
|
- ollama/nemotron-3-ultra:cloud
|
|
11
11
|
- ollama/glm-5.2:cloud
|
|
12
|
-
-
|
|
12
|
+
- incoai/Qwen3.8-27B-Splash
|
|
13
13
|
thinking: medium
|
|
14
14
|
---
|
|
15
15
|
|
package/agents/documenter.md
CHANGED
|
@@ -5,13 +5,13 @@ tools: read,write,edit,grep,find,ls
|
|
|
5
5
|
writes:
|
|
6
6
|
- docs/
|
|
7
7
|
- "**/*.md"
|
|
8
|
-
model: openai-codex/gpt-6-sol
|
|
8
|
+
model: openai-codex/gpt-6.1-sol
|
|
9
9
|
models:
|
|
10
10
|
- openai-codex/gpt-6-luna
|
|
11
|
-
- openai-codex/gpt-
|
|
11
|
+
- openai-codex/gpt-6-luna
|
|
12
12
|
- ollama/glm-5.2:cloud
|
|
13
13
|
- ollama/nemotron-3-ultra:cloud
|
|
14
|
-
-
|
|
14
|
+
- incoai/Qwen3.8-27B-Splash
|
|
15
15
|
thinking: minimal
|
|
16
16
|
---
|
|
17
17
|
You are a documentation agent. Write clear, concise documentation. Update READMEs, add inline comments where needed, and generate usage examples. Match the project's existing doc style.
|
package/agents/orchestrator.md
CHANGED
|
@@ -2,12 +2,12 @@
|
|
|
2
2
|
name: orchestrator
|
|
3
3
|
description: Verification-Contract orchestrator — coordinates small, evidence-gated batches and does not report completion until each stated assertion has named proof.
|
|
4
4
|
kind: orchestrator
|
|
5
|
-
model: openai-codex/gpt-6-sol
|
|
5
|
+
model: openai-codex/gpt-6.1-sol
|
|
6
6
|
models:
|
|
7
7
|
- openai-codex/gpt-6-luna
|
|
8
8
|
- ollama/minimax-m3:cloud
|
|
9
9
|
- ollama/nemotron-3-ultra:cloud
|
|
10
|
-
-
|
|
10
|
+
- incoai/Qwen3.8-27B-Splash
|
|
11
11
|
thinking: medium
|
|
12
12
|
---
|
|
13
13
|
|
package/agents/plan-reviewer.md
CHANGED
|
@@ -6,10 +6,10 @@ model: xai/grok-4.7
|
|
|
6
6
|
models:
|
|
7
7
|
- openai-codex/gpt-6-luna
|
|
8
8
|
- github-copilot/claude-opus-5
|
|
9
|
-
- openai-codex/gpt-6-sol
|
|
9
|
+
- openai-codex/gpt-6.1-sol
|
|
10
10
|
- ollama/nemotron-3-ultra:cloud
|
|
11
11
|
- ollama/glm-5.2:cloud
|
|
12
|
-
-
|
|
12
|
+
- incoai/Qwen3.8-27B-Splash
|
|
13
13
|
thinking: medium
|
|
14
14
|
delegate_depth: 1
|
|
15
15
|
subagents:
|
package/agents/planner.md
CHANGED
|
@@ -7,22 +7,22 @@ writes:
|
|
|
7
7
|
model: openai-codex/gpt-6-astra
|
|
8
8
|
models:
|
|
9
9
|
- github-copilot/claude-fable-5
|
|
10
|
-
- openai-codex/gpt-6-sol
|
|
10
|
+
- openai-codex/gpt-6.1-sol
|
|
11
11
|
- openai-codex/gpt-6-luna
|
|
12
12
|
- ollama/nemotron-3-ultra:cloud
|
|
13
13
|
- ollama/glm-5.2:cloud
|
|
14
|
-
-
|
|
14
|
+
- incoai/Qwen3.8-27B-Splash
|
|
15
15
|
thinking: high
|
|
16
16
|
delegate_depth: 1
|
|
17
17
|
subagents:
|
|
18
18
|
scout:
|
|
19
|
-
model: openai-codex/gpt-
|
|
19
|
+
model: openai-codex/gpt-6-luna
|
|
20
20
|
tools: read,grep,find,ls
|
|
21
21
|
rules:
|
|
22
22
|
model: openai-codex/gpt-6-luna
|
|
23
23
|
tools: read,grep,find,ls
|
|
24
24
|
voice-1:
|
|
25
|
-
model: openai-codex/gpt-6-sol
|
|
25
|
+
model: openai-codex/gpt-6.1-sol
|
|
26
26
|
thinking: medium
|
|
27
27
|
tools: read,grep,find,ls
|
|
28
28
|
voice-2:
|
package/agents/releaser.md
CHANGED
|
@@ -2,12 +2,12 @@
|
|
|
2
2
|
name: releaser
|
|
3
3
|
description: Release owner — cuts versions and ships; runs the changeset → version-bump → tag flow on request.
|
|
4
4
|
color: #059669
|
|
5
|
-
model: openai-codex/gpt-6-sol
|
|
5
|
+
model: openai-codex/gpt-6.1-sol
|
|
6
6
|
models:
|
|
7
7
|
- openai-codex/gpt-6-luna
|
|
8
8
|
- ollama/glm-5.2:cloud
|
|
9
9
|
- ollama/nemotron-3-ultra:cloud
|
|
10
|
-
-
|
|
10
|
+
- incoai/Qwen3.8-27B-Splash
|
|
11
11
|
thinking: low
|
|
12
12
|
---
|
|
13
13
|
|
package/agents/researcher.md
CHANGED
|
@@ -7,10 +7,10 @@ model: openai-codex/gpt-6-luna
|
|
|
7
7
|
models:
|
|
8
8
|
- openai-codex/gpt-6-luna
|
|
9
9
|
- xai/grok-4.7
|
|
10
|
-
- openai-codex/gpt-6-sol
|
|
10
|
+
- openai-codex/gpt-6.1-sol
|
|
11
11
|
- ollama/nemotron-3-ultra:cloud
|
|
12
12
|
- ollama/minimax-m3:cloud
|
|
13
|
-
-
|
|
13
|
+
- incoai/Qwen3.8-27B-Splash
|
|
14
14
|
thinking: low
|
|
15
15
|
---
|
|
16
16
|
|
|
@@ -2,13 +2,13 @@
|
|
|
2
2
|
name: security-auditor
|
|
3
3
|
description: Security engineer focused on vulnerability detection, threat modeling, and secure coding practices. Use for security-focused code review, threat analysis, or hardening recommendations.
|
|
4
4
|
tools: read,bash,grep,find,ls
|
|
5
|
-
model: openai-codex/gpt-6-sol
|
|
5
|
+
model: openai-codex/gpt-6.1-sol
|
|
6
6
|
models:
|
|
7
7
|
- xai/grok-4.7
|
|
8
8
|
- openai-codex/gpt-6-luna
|
|
9
9
|
- ollama/nemotron-3-ultra:cloud
|
|
10
10
|
- ollama/glm-5.2:cloud
|
|
11
|
-
-
|
|
11
|
+
- incoai/Qwen3.8-27B-Splash
|
|
12
12
|
thinking: high
|
|
13
13
|
delegate_depth: 1
|
|
14
14
|
subagents:
|
package/agents/test-engineer.md
CHANGED
|
@@ -6,19 +6,19 @@ model: xai/grok-4.7
|
|
|
6
6
|
models:
|
|
7
7
|
- github-copilot/claude-opus-5
|
|
8
8
|
- openai-codex/gpt-6-luna
|
|
9
|
-
- openai-codex/gpt-6-sol
|
|
9
|
+
- openai-codex/gpt-6.1-sol
|
|
10
10
|
- ollama/kimi-k2.7-code:cloud
|
|
11
11
|
- ollama/glm-5.2:cloud
|
|
12
12
|
- ollama/nemotron-3-ultra:cloud
|
|
13
|
-
-
|
|
13
|
+
- incoai/Qwen3.8-27B-Splash
|
|
14
14
|
thinking: low
|
|
15
15
|
delegate_depth: 1
|
|
16
16
|
subagents:
|
|
17
17
|
coverage-scout:
|
|
18
|
-
model: openai-codex/gpt-
|
|
18
|
+
model: openai-codex/gpt-6-luna
|
|
19
19
|
tools: read,grep,find,ls
|
|
20
20
|
conventions:
|
|
21
|
-
model: openai-codex/gpt-
|
|
21
|
+
model: openai-codex/gpt-6-luna
|
|
22
22
|
tools: read,grep,find,ls
|
|
23
23
|
---
|
|
24
24
|
|
package/agents/web-debugger.md
CHANGED
|
@@ -4,10 +4,10 @@ description: Interactive headful Chrome debugging via Chrome DevTools MCP — li
|
|
|
4
4
|
model: openai-codex/gpt-6-luna
|
|
5
5
|
models:
|
|
6
6
|
- github-copilot/claude-opus-5
|
|
7
|
-
- openai-codex/gpt-6-sol
|
|
7
|
+
- openai-codex/gpt-6.1-sol
|
|
8
8
|
- openai-codex/gpt-6-luna
|
|
9
9
|
- ollama/glm-5.2:cloud
|
|
10
|
-
-
|
|
10
|
+
- incoai/Qwen3.8-27B-Splash
|
|
11
11
|
color: cyan
|
|
12
12
|
skills:
|
|
13
13
|
- browser-testing-with-devtools
|
|
@@ -5,11 +5,11 @@ tools: read,bash,grep,find,ls
|
|
|
5
5
|
model: openai-codex/gpt-6-luna
|
|
6
6
|
models:
|
|
7
7
|
- github-copilot/claude-opus-5
|
|
8
|
-
- openai-codex/gpt-6-sol
|
|
8
|
+
- openai-codex/gpt-6.1-sol
|
|
9
9
|
- openai-codex/gpt-6-luna
|
|
10
10
|
- ollama/nemotron-3-ultra:cloud
|
|
11
11
|
- ollama/glm-5.2:cloud
|
|
12
|
-
-
|
|
12
|
+
- incoai/Qwen3.8-27B-Splash
|
|
13
13
|
thinking: high
|
|
14
14
|
---
|
|
15
15
|
|
package/bin/cli.js
CHANGED
|
@@ -246,8 +246,8 @@ async function cmdConfigure() {
|
|
|
246
246
|
for (const key of ["rules", "docs"]) {
|
|
247
247
|
if (opts[key] === undefined) continue;
|
|
248
248
|
const paths = opts[key].split(",").map((path) => path.trim());
|
|
249
|
-
if (paths.some((path) => !path || path.startsWith("/") || /[\r\n:#]/.test(path) || path.includes("\\") || path.split("/").some((part) => part === "
|
|
250
|
-
fail(`--${key} requires comma-separated
|
|
249
|
+
if (paths.some((path) => !path || path.startsWith("/") || /[\r\n:#]/.test(path) || path.includes("\\") || path.split("/").some((part,index,parts) => part === "." || !part || (part === ".." && parts.slice(0,index).some(prior => prior !== "..")))))
|
|
250
|
+
fail(`--${key} requires comma-separated checkout-relative paths without internal traversal`);
|
|
251
251
|
requested[key] = [...new Set(paths)];
|
|
252
252
|
for (const path of requested[key]) if (!existsSync(join(workspace, path))) console.error(`Warning: configured ${key} path does not exist: ${path}`);
|
|
253
253
|
}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
// Reviewed project-content writes are separate from read grants and installer ownership.
|
|
2
|
+
import { existsSync, lstatSync, realpathSync } from "node:fs";
|
|
3
|
+
import { isAbsolute, relative, resolve, sep } from "node:path";
|
|
4
|
+
import { assertSafeWorkspaceTarget, assertWorkspaceRootSafe } from "./workspace-safety.js";
|
|
5
|
+
|
|
6
|
+
export function validateContentDestination(workspace, destination) {
|
|
7
|
+
if (!destination || typeof destination.root !== "string" || !destination.root ||
|
|
8
|
+
typeof destination.acceptedDecision !== "string" || !destination.acceptedDecision.trim() ||
|
|
9
|
+
!Array.isArray(destination.evidence) || !destination.evidence.length ||
|
|
10
|
+
!destination.evidence.every(value => typeof value === "string" && value.trim()) ||
|
|
11
|
+
Object.keys(destination).some(key => !["root", "acceptedDecision", "evidence"].includes(key)))
|
|
12
|
+
throw new Error("external content destination requires reviewed root, acceptedDecision and evidence");
|
|
13
|
+
const root = resolve(workspace, destination.root);
|
|
14
|
+
if (!existsSync(root) || !lstatSync(root).isDirectory()) throw new Error("external content destination must be an existing real directory");
|
|
15
|
+
assertWorkspaceRootSafe(root);
|
|
16
|
+
const checkout = realpathSync(workspace);
|
|
17
|
+
for (const [base, target] of [[root, checkout], [checkout, root]]) {
|
|
18
|
+
const rel = relative(base, target);
|
|
19
|
+
if (rel === "" || (!isAbsolute(rel) && rel !== ".." && !rel.startsWith(`..${sep}`)))
|
|
20
|
+
throw new Error("external content destination must be separate from the checkout");
|
|
21
|
+
}
|
|
22
|
+
return { root, acceptedDecision: destination.acceptedDecision, evidence: [...destination.evidence] };
|
|
23
|
+
}
|
|
24
|
+
export function externalContentTarget(workspace, destination, path) {
|
|
25
|
+
const reviewed = validateContentDestination(workspace, destination);
|
|
26
|
+
if (typeof path !== "string" || !/^\.ai\/(?:rules|commands|agent-prompts)\/.+/.test(path) ||
|
|
27
|
+
path.includes("\\") || path.split("/").some(part => !part || part === "." || part === "..") ||
|
|
28
|
+
path.split("/").slice(2).some(part => /^(?:\..*|secrets?(?:\..*)?|credentials?(?:\..*)?|node_modules|vendor|dist|build|coverage|.*\.(?:pem|key|p12|pfx))$/i.test(part)))
|
|
29
|
+
throw new Error(`invalid external project AI path: ${path}`);
|
|
30
|
+
const target = assertSafeWorkspaceTarget(reviewed.root, path, { allowLeafSymlink: false });
|
|
31
|
+
if (existsSync(target) && !lstatSync(target).isFile()) throw new Error("external project content target is not a regular file");
|
|
32
|
+
return target;
|
|
33
|
+
}
|
|
@@ -3,6 +3,7 @@ import { existsSync, lstatSync, mkdirSync, readFileSync, writeFileSync } from "n
|
|
|
3
3
|
import { dirname, join } from "node:path";
|
|
4
4
|
import { hashFile, hashText } from "./state.js";
|
|
5
5
|
import { runTransaction } from "./transaction.js";
|
|
6
|
+
import { externalContentTarget, validateContentDestination } from "./external-content.js";
|
|
6
7
|
import { assertSafeWorkspaceTarget } from "./workspace-safety.js";
|
|
7
8
|
|
|
8
9
|
export const AI_STATE_REL_PATH = ".ai/agent-fleet-ai-state.json";
|
|
@@ -14,7 +15,8 @@ const ROOTS = ["rules", "commands", "agent-prompts"];
|
|
|
14
15
|
const HEX = /^[a-f0-9]{64}$/;
|
|
15
16
|
const own = (value) => Object.hasOwn(value, "origin") && ["template", "repo-derived"].includes(value.origin);
|
|
16
17
|
|
|
17
|
-
export function projectPath(workspace, path) {
|
|
18
|
+
export function projectPath(workspace, path, contentDestination) {
|
|
19
|
+
if (contentDestination) return externalContentTarget(workspace,contentDestination,path);
|
|
18
20
|
if (typeof path !== "string" || path.includes("\\") || path.startsWith("/") || path.split("/").includes("..") ||
|
|
19
21
|
!ROOTS.some((root) => path.startsWith(`.ai/${root}/`) && path.length > root.length + 5)) throw new Error(`invalid project AI path: ${path}`);
|
|
20
22
|
return assertSafeWorkspaceTarget(workspace, path, { allowLeafSymlink: false });
|
|
@@ -30,7 +32,7 @@ export function requirePackageCatalogue(packageRoot) {
|
|
|
30
32
|
}
|
|
31
33
|
|
|
32
34
|
function validEntry(workspace, path, entry) {
|
|
33
|
-
projectPath(workspace, path);
|
|
35
|
+
projectPath(workspace, path, entry?.contentDestination);
|
|
34
36
|
if (!entry || !own(entry) || !HEX.test(entry.appliedHash) || !Array.isArray(entry.evidence) ||
|
|
35
37
|
!entry.evidence.every((x) => typeof x === "string" && x.length > 0) ||
|
|
36
38
|
typeof entry.acceptedDecision !== "string" || !entry.acceptedDecision.trim() ||
|
|
@@ -54,16 +56,19 @@ export function readProjectProvenance(workspace) {
|
|
|
54
56
|
|
|
55
57
|
const same = (a, b) => JSON.stringify(a) === JSON.stringify(b);
|
|
56
58
|
/** source: template identity/version/hash, or {origin:'repo-derived'}; inputs are relevant generation inputs. */
|
|
57
|
-
export function classifyProjectFile({ workspace, path, source, evidence, acceptedDecision, inputs = {}, knownTemplate = true, snapshotAvailable = false }) {
|
|
58
|
-
const target = projectPath(workspace, path);
|
|
59
|
+
export function classifyProjectFile({ workspace, path, source, evidence, acceptedDecision, inputs = {}, knownTemplate = true, snapshotAvailable = false, contentDestination }) {
|
|
59
60
|
const record = readProjectProvenance(workspace);
|
|
61
|
+
const previousDestination=record.state?.entries[path]?.contentDestination;
|
|
62
|
+
if (previousDestination && !contentDestination) throw new Error("external content destination must be explicitly supplied");
|
|
63
|
+
const destination=contentDestination ? validateContentDestination(workspace,contentDestination) : undefined;
|
|
64
|
+
const target = projectPath(workspace, path, destination);
|
|
60
65
|
if (record.status !== "valid") return { status: "unknown", reason: record.status };
|
|
61
66
|
const previous = record.state.entries[path];
|
|
62
67
|
if (!previous) return { status: "unknown", reason: "unrecorded" };
|
|
63
68
|
if (!existsSync(target) || !lstatSync(target).isFile()) return { status: "deleted" };
|
|
64
69
|
if (previous.origin === "template" && !knownTemplate) return { status: "unknown", reason: "unknown-template" };
|
|
65
70
|
const local = hashFile(target) !== previous.appliedHash;
|
|
66
|
-
const changed = !source || previous.origin !== source.origin ||
|
|
71
|
+
const changed = !same(previous.contentDestination,destination) || !source || previous.origin !== source.origin ||
|
|
67
72
|
(source.origin === "template" && ["templateId", "sourceVersion", "sourceHash"].some((key) => source[key] !== previous[key])) ||
|
|
68
73
|
!same(previous.evidence, evidence) || previous.acceptedDecision !== acceptedDecision || !same(previous.inputs ?? {}, inputs);
|
|
69
74
|
return { status: local ? (changed ? "conflict" : "local-edit") : (changed ? "source-update" : "unchanged"),
|
|
@@ -71,7 +76,8 @@ export function classifyProjectFile({ workspace, path, source, evidence, accepte
|
|
|
71
76
|
}
|
|
72
77
|
|
|
73
78
|
/** Only an already reviewed, accepted change may be written. Generator is not invoked for an unchanged rerun. */
|
|
74
|
-
export function applyAcceptedProjectFiles({ workspace, changes, generateContent, failAt = null }) {
|
|
79
|
+
export function applyAcceptedProjectFiles({ workspace, changes, generateContent, failAt = null, contentDestination }) {
|
|
80
|
+
const destination=contentDestination ? validateContentDestination(workspace,contentDestination) : undefined;
|
|
75
81
|
if (!Array.isArray(changes) || !changes.length) return { changed: false };
|
|
76
82
|
const record = readProjectProvenance(workspace);
|
|
77
83
|
if (record.status === "corrupt") throw new Error("provenance is corrupt; repair before apply");
|
|
@@ -82,14 +88,14 @@ export function applyAcceptedProjectFiles({ workspace, changes, generateContent,
|
|
|
82
88
|
const sidecarHash = hashFile(sidecar);
|
|
83
89
|
for (const change of changes) {
|
|
84
90
|
const { path, source, evidence, acceptedDecision, inputs = {}, accepted = false, requestChange = false } = change;
|
|
85
|
-
projectPath(workspace, path);
|
|
91
|
+
projectPath(workspace, path, destination);
|
|
86
92
|
if (seen.has(path)) throw new Error(`duplicate project AI path: ${path}`);
|
|
87
93
|
seen.add(path);
|
|
88
|
-
const entry = { origin: source?.origin, ...(source?.origin === "template" ? {
|
|
94
|
+
const entry = { ...(destination ? {contentDestination:destination} : {}), origin: source?.origin, ...(source?.origin === "template" ? {
|
|
89
95
|
templateId: source.templateId, sourceVersion: source.sourceVersion, sourceHash: source.sourceHash,
|
|
90
96
|
} : {}), evidence, acceptedDecision, inputs, appliedHash: "0".repeat(64) };
|
|
91
97
|
if (!validEntry(workspace, path, entry)) throw new Error(`invalid provenance entry: ${path}`);
|
|
92
|
-
const classification = classifyProjectFile({ workspace, path, source, evidence, acceptedDecision, inputs, knownTemplate: change.knownTemplate });
|
|
98
|
+
const classification = classifyProjectFile({ workspace, path, source, evidence, acceptedDecision, inputs, knownTemplate: change.knownTemplate, contentDestination:destination });
|
|
93
99
|
if (classification.status === "unchanged" && !requestChange) continue;
|
|
94
100
|
if (!accepted) throw new Error(`${path}: ${classification.status}; explicit acceptance required`);
|
|
95
101
|
if (!["unchanged", "source-update"].includes(classification.status) && !change.adopt && !change.reconciled)
|
|
@@ -98,17 +104,17 @@ export function applyAcceptedProjectFiles({ workspace, changes, generateContent,
|
|
|
98
104
|
const bytes = change.content === undefined ? generateContent?.(change) : change.content;
|
|
99
105
|
if (typeof bytes !== "string" && !Buffer.isBuffer(bytes)) throw new Error(`missing accepted content: ${path}`);
|
|
100
106
|
entry.appliedHash = hashText(bytes);
|
|
101
|
-
prepared.push({ path, bytes, entry, priorHash: hashFile(projectPath(workspace, path)) });
|
|
107
|
+
prepared.push({ path, bytes, entry, priorHash: hashFile(projectPath(workspace, path, destination)) });
|
|
102
108
|
}
|
|
103
109
|
if (!prepared.length) return { changed: false };
|
|
104
|
-
const plan = { workspace, verb: "configure", actions: [{ files: prepared.map(({ path }) => ({ path })).concat({ path: AI_STATE_REL_PATH }) }] };
|
|
110
|
+
const plan = { workspace, verb: "configure", ...(destination ? {externalContent:prepared.map(({path})=>({path,destination}))} : {}), actions: [{ files: (destination ? [] : prepared.map(({ path }) => ({ path }))).concat({ path: AI_STATE_REL_PATH }) }] };
|
|
105
111
|
return runTransaction({ workspace, plan, manifest: { items: [] }, failAt, validate: () => {
|
|
106
|
-
if (hashFile(sidecar) !== sidecarHash || prepared.some(({ path, priorHash }) => hashFile(projectPath(workspace, path)) !== priorHash))
|
|
112
|
+
if (hashFile(sidecar) !== sidecarHash || prepared.some(({ path, priorHash }) => hashFile(projectPath(workspace, path, destination)) !== priorHash))
|
|
107
113
|
throw new Error("project AI files changed since review; re-run setup");
|
|
108
114
|
}, commit: () => {
|
|
109
115
|
const entries = { ...state.entries };
|
|
110
116
|
for (const { path, bytes, entry } of prepared) {
|
|
111
|
-
const target = projectPath(workspace, path);
|
|
117
|
+
const target = projectPath(workspace, path, destination);
|
|
112
118
|
mkdirSync(dirname(target), { recursive: true }); writeFileSync(target, bytes);
|
|
113
119
|
if (hashFile(target) !== entry.appliedHash) throw new Error(`readback mismatch: ${path}`);
|
|
114
120
|
entries[path] = entry;
|