@chankov/agent-fleet 2.0.9 → 2.0.10
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/extensions/pi-voice-stt/README.md +24 -5
- package/.pi/extensions/pi-voice-stt/examples/stt.json +4 -4
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/return-contract.js +34 -0
- package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +80 -18
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/README.md +347 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.10/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.10/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/fleet.ts +216 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/flow.ts +137 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/package-lock.json +35 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/package.json +9 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/team-up.ts +378 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +133 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-scout.ts +38 -0
- package/.versions/2.0.10/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.10/.pi/agents/model-profiles.yaml +83 -0
- package/.versions/2.0.10/.pi/agents/peers.yaml +147 -0
- package/.versions/2.0.10/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.10/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.10/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.10/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.10/.pi/extensions/btw/index.ts +914 -0
- package/.versions/2.0.10/.pi/extensions/btw/package.json +6 -0
- package/.versions/2.0.10/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.10/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.10/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.10/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.10/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.10/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.10/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.10/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.10/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.10/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.10/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.10/.pi/extensions/package.json +9 -0
- package/.versions/2.0.10/.pi/extensions/pi-voice-stt/README.md +224 -0
- package/.versions/2.0.10/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.10/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.10/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.10/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.10/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.10/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/README.md +1217 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/acceptance.ts +62 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/context.ts +43 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/config/agents.ts +177 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/delegate.ts +446 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/index.ts +2132 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/no-progress.ts +76 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/return-contract.js +327 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/scope-gate.js +123 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/spawn.ts +404 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/context.ts +134 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +335 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/types.ts +63 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-actions.ts +76 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +99 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-source.ts +157 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/grid.ts +154 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.10/.pi/harnesses/agent-hub/work-mode.ts +167 -0
- package/.versions/2.0.10/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.10/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.10/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.10/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.10/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
- package/.versions/2.0.10/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.10/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.10/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.10/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.10/.pi/harnesses/damage-control-continue/README.md +135 -0
- package/.versions/2.0.10/.pi/harnesses/damage-control-continue/index.ts +541 -0
- package/.versions/2.0.10/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.10/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.10/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
- package/.versions/2.0.10/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.10/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.10/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.10/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
- package/.versions/2.0.10/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.10/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.10/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.10/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fleet-dashboard-view.ts +134 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fleet-read-model.ts +213 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fleet-strip-view.ts +132 -0
- package/.versions/2.0.10/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.10/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.10/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.10/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/2.0.10/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.10/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.10/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.10/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.10/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.10/.pi/prompts/af-constraints.md +31 -0
- package/.versions/2.0.10/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.10/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.10/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.10/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.10/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.10/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.10/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.10/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.10/.version +1 -0
- package/.versions/2.0.10/agents/architect.md +25 -0
- package/.versions/2.0.10/agents/bowser.md +28 -0
- package/.versions/2.0.10/agents/builder.md +56 -0
- package/.versions/2.0.10/agents/code-reviewer.md +210 -0
- package/.versions/2.0.10/agents/deep-researcher.md +33 -0
- package/.versions/2.0.10/agents/documenter.md +23 -0
- package/.versions/2.0.10/agents/orchestrator.md +23 -0
- package/.versions/2.0.10/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.10/agents/planner.md +106 -0
- package/.versions/2.0.10/agents/releaser.md +25 -0
- package/.versions/2.0.10/agents/researcher.md +31 -0
- package/.versions/2.0.10/agents/security-auditor.md +168 -0
- package/.versions/2.0.10/agents/test-engineer.md +154 -0
- package/.versions/2.0.10/agents/web-debugger.md +44 -0
- package/.versions/2.0.10/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.10/bin/catalog/harness-runtime-closure.json +32 -0
- package/.versions/2.0.10/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.10/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.10/docs/ARCHITECTURE.md +416 -0
- package/.versions/2.0.10/docs/agent-fleet-setup.md +586 -0
- package/.versions/2.0.10/docs/claude-code-coms-bridge.md +134 -0
- package/.versions/2.0.10/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.10/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.10/docs/getting-started.md +126 -0
- package/.versions/2.0.10/docs/npm-install.md +383 -0
- package/.versions/2.0.10/docs/pi-extensions.md +449 -0
- package/.versions/2.0.10/docs/pi-setup.md +92 -0
- package/.versions/2.0.10/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.10/install-manifest.json +2991 -0
- package/.versions/2.0.10/justfile +247 -0
- package/.versions/2.0.10/manifest-meta.json +970 -0
- package/.versions/2.0.10/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.10/references/communication-contract.md +26 -0
- package/.versions/2.0.10/references/definition-of-done.md +67 -0
- package/.versions/2.0.10/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.10/references/observability-checklist.md +92 -0
- package/.versions/2.0.10/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.10/references/performance-checklist.md +236 -0
- package/.versions/2.0.10/references/prompting-patterns.md +380 -0
- package/.versions/2.0.10/references/security-checklist.md +245 -0
- package/.versions/2.0.10/references/testing-patterns.md +235 -0
- package/.versions/2.0.10/references/workflow-authoring.md +304 -0
- package/.versions/2.0.10/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.10/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.10/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.10/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.10/skills/constraint-driven-development/SKILL.md +338 -0
- package/.versions/2.0.10/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.10/skills/context-engineering/SKILL.md +341 -0
- package/.versions/2.0.10/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.10/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.10/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.10/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.10/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.10/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.10/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.10/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.10/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.10/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.10/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.10/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.10/skills/incremental-implementation/SKILL.md +302 -0
- package/.versions/2.0.10/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.10/skills/orchestration-verification/SKILL.md +182 -0
- package/.versions/2.0.10/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.10/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.10/skills/planning-and-task-breakdown/SKILL.md +289 -0
- package/.versions/2.0.10/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.10/skills/spec-driven-development/SKILL.md +295 -0
- package/.versions/2.0.10/skills/using-agent-skills/SKILL.md +198 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/README.md +430 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
- package/.versions/2.0.10/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
- package/CHANGELOG.md +11 -0
- package/agents/architect.md +1 -1
- package/agents/bowser.md +1 -1
- package/agents/builder.md +1 -1
- package/agents/code-reviewer.md +1 -1
- package/agents/deep-researcher.md +1 -1
- package/agents/documenter.md +1 -1
- package/agents/orchestrator.md +1 -1
- package/agents/plan-reviewer.md +1 -1
- package/agents/planner.md +1 -1
- package/agents/releaser.md +1 -1
- package/agents/researcher.md +1 -1
- package/agents/security-auditor.md +1 -1
- package/agents/test-engineer.md +1 -1
- package/agents/web-debugger.md +1 -1
- package/agents/web-performance-auditor.md +1 -1
- package/bin/cli.js +8 -5
- package/bin/lib/path-boundaries.js +5 -6
- package/bin/lib/stt-wizard.js +154 -23
- package/docs/agent-fleet-setup.md +26 -8
- package/docs/npm-install.md +29 -2
- package/docs/pi-setup.md +16 -0
- package/install-manifest.json +1 -1
- package/package.json +13 -3
- package/skills/orchestration-verification/SKILL.md +1 -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,16 @@
|
|
|
1
1
|
# Agent Fleet changelog
|
|
2
2
|
|
|
3
|
+
## 2.0.10
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- 1c5488a: Run local TypeScript diagnostics once after successful writable native dispatches and conservatively demote current-dispatch proof claims when changed-file compiler errors contradict them.
|
|
8
|
+
- 12608f1: Fix package-internal Pi skill collisions by discovering only unshadowed upstream skills alongside Fleet-native skills, preserving the full skill catalog.
|
|
9
|
+
- a07cf09: Accept and preserve canonical nested voice STT configuration, distinguish installer aliases from runtime provider types, and require prepared provider settings instead of guessing them.
|
|
10
|
+
- 7077fc4: Fix compiler diagnostic path attribution through symlinked worktrees, including macOS temporary directories. Make diagnostics tests independent of `/tmp` and the installed TypeScript version.
|
|
11
|
+
|
|
12
|
+
Prevent release-blocking false positives by parsing actual import syntax instead of fixture text and checking untracked source files before commit. Run the shared Linux/macOS validation matrix on pull requests with read-only permissions, plus alternate-temp-directory regressions; reserve publishing permissions for validated main-branch releases.
|
|
13
|
+
|
|
3
14
|
## 2.0.9
|
|
4
15
|
|
|
5
16
|
### Patch Changes
|
package/agents/architect.md
CHANGED
package/agents/bowser.md
CHANGED
package/agents/builder.md
CHANGED
package/agents/code-reviewer.md
CHANGED
package/agents/documenter.md
CHANGED
|
@@ -12,7 +12,7 @@ models:
|
|
|
12
12
|
- openai-codex/gpt-5.3-codex-spark
|
|
13
13
|
- ollama/glm-5.2:cloud
|
|
14
14
|
- ollama/nemotron-3-ultra:cloud
|
|
15
|
-
-
|
|
15
|
+
- omlx/Qwen3.6-35B-A3B-4bit
|
|
16
16
|
thinking: minimal
|
|
17
17
|
---
|
|
18
18
|
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
package/agents/plan-reviewer.md
CHANGED
package/agents/planner.md
CHANGED
package/agents/releaser.md
CHANGED
package/agents/researcher.md
CHANGED
package/agents/test-engineer.md
CHANGED
package/agents/web-debugger.md
CHANGED
package/bin/cli.js
CHANGED
|
@@ -301,13 +301,13 @@ async function cmdSetup() {
|
|
|
301
301
|
});
|
|
302
302
|
if (provider.cancelled || !provider.value) selection = { cancelled: true, reason: provider.reason ?? "no provider" };
|
|
303
303
|
else sttProvider = provider.value;
|
|
304
|
-
} else if (!selection.cancelled && existingStt && sttProvider && sttProvider !== existingStt.
|
|
304
|
+
} else if (!selection.cancelled && existingStt && sttProvider && sttProvider !== existingStt.providerAlias) {
|
|
305
305
|
const replacement = await askChoice({ output: stdout, readLine: setupReadLine,
|
|
306
|
-
prompt: `Replace STT provider ${existingStt.
|
|
306
|
+
prompt: `Replace STT provider ${existingStt.provider} with ${sttProvider}? yes/y | no/n | cancel; Enter = no (keep existing provider) > `,
|
|
307
307
|
validate: (value) => /^y(?:es)?$/i.test(value) ? { ok: true, value: true } : value === "" || /^n(?:o)?$/i.test(value) ? { ok: true, value: false } : { ok: false, error: "Invalid answer. Enter yes/y to replace or no/n to keep the existing provider." },
|
|
308
308
|
});
|
|
309
309
|
if (replacement.cancelled) selection = { cancelled: true, reason: replacement.reason };
|
|
310
|
-
else if (!replacement.value) sttProvider =
|
|
310
|
+
else if (!replacement.value) sttProvider = null;
|
|
311
311
|
else sttReplacementApproved = true;
|
|
312
312
|
}
|
|
313
313
|
} catch (err) { setupRl.close(); fail(err.message); }
|
|
@@ -340,6 +340,7 @@ async function cmdSetup() {
|
|
|
340
340
|
setupRl?.close();
|
|
341
341
|
fail(plan.migrationError);
|
|
342
342
|
}
|
|
343
|
+
if (opts.json && !dryRun && plan.stt?.warning) console.error(`Warning: ${plan.stt.warning}`);
|
|
343
344
|
plan.fingerprints = capturePlanFingerprints(plan, manifest);
|
|
344
345
|
if (dryRun) {
|
|
345
346
|
setupRl?.close(); writeJson(publicPlan(plan)); exit(plan.conflicts.length ? 3 : 0);
|
|
@@ -903,6 +904,7 @@ function printPlan(plan) {
|
|
|
903
904
|
}
|
|
904
905
|
|
|
905
906
|
for (const note of plan.notes) console.log(`\nNote: ${note.detail}`);
|
|
907
|
+
if (plan.stt?.warning) console.log(`\nWarning: ${plan.stt.warning}`);
|
|
906
908
|
|
|
907
909
|
// Only the interesting half. A hundred `keep` lines buries the four that matter.
|
|
908
910
|
const shown = plan.actions.filter((a) => a.kind !== "keep");
|
|
@@ -967,7 +969,7 @@ function printConfigurationWrites(plan) {
|
|
|
967
969
|
const writes = [
|
|
968
970
|
plan.writeDesired ? plan.desiredPath : null,
|
|
969
971
|
plan.overrides?.write ? plan.overrides.path : null,
|
|
970
|
-
plan.stt?.path
|
|
972
|
+
plan.stt?.write ? plan.stt.path : null,
|
|
971
973
|
plan.stt?.env?.missing?.length ? plan.stt.env.path : null,
|
|
972
974
|
].filter(Boolean);
|
|
973
975
|
if (writes.length === 0) return;
|
|
@@ -1186,7 +1188,8 @@ Options:
|
|
|
1186
1188
|
--preset <default|full> Desired preset
|
|
1187
1189
|
--repair-config With --yes, approve known retired config removal (backup saved)
|
|
1188
1190
|
--features <name[,name]|none> Exact feature snapshot (replaces, never adds)
|
|
1189
|
-
--stt-provider <openai|groq|azure>
|
|
1191
|
+
--stt-provider <openai|groq|azure|azure-openai>
|
|
1192
|
+
Select provider explicitly; non-OpenAI setup requires prepared .ai/stt.json
|
|
1190
1193
|
--save-desired Persist CLI overrides to .ai/agent-fleet.json
|
|
1191
1194
|
--migrate Permit non-interactive first migration (with explicit preset/features and --yes)
|
|
1192
1195
|
--allow-exec Run consented runtime commands after the file transaction
|
|
@@ -32,19 +32,18 @@ export const MOVED_TO = Object.freeze({
|
|
|
32
32
|
agents: ".pi/agents/personas",
|
|
33
33
|
});
|
|
34
34
|
|
|
35
|
-
const SPECIFIER = /(?:\bfrom|\bimport|\brequire)\s*\(?\s*["'](\.\.?\/[^"']+)["']|new URL\(\s*["'](\.\.?[^"']*)["']/g;
|
|
36
|
-
|
|
37
35
|
/**
|
|
38
|
-
*
|
|
36
|
+
* Syntax-extracted relative specifiers that do not resolve to a file on disk.
|
|
37
|
+
* Parsing is supplied by the test-only caller so the installer does not acquire
|
|
38
|
+
* a TypeScript runtime dependency. Do not regex-scan source/fixture text here.
|
|
39
39
|
*
|
|
40
40
|
* `.js` is accepted for a `.ts` file: that is the NodeNext spelling the
|
|
41
41
|
* harnesses already use, and Node strips types at runtime.
|
|
42
42
|
*/
|
|
43
|
-
export function unresolvedSpecifiers({ root, file,
|
|
43
|
+
export function unresolvedSpecifiers({ root, file, specifiers }) {
|
|
44
44
|
const dir = dirname(join(root, file));
|
|
45
45
|
const out = [];
|
|
46
|
-
for (const
|
|
47
|
-
const spec = match[1] ?? match[2];
|
|
46
|
+
for (const spec of specifiers) {
|
|
48
47
|
const target = resolve(dir, spec);
|
|
49
48
|
if (existsSync(target)) continue;
|
|
50
49
|
if (target.endsWith(".js") && existsSync(`${target.slice(0, -3)}.ts`)) continue;
|
package/bin/lib/stt-wizard.js
CHANGED
|
@@ -2,46 +2,177 @@
|
|
|
2
2
|
import { existsSync, readFileSync } from "node:fs";
|
|
3
3
|
import { join } from "node:path";
|
|
4
4
|
|
|
5
|
+
const ENV_NAME = /^[A-Z_][A-Z0-9_]*$/;
|
|
6
|
+
const RUNTIME_PROVIDER_TYPES = new Set(["openai", "openai-compatible", "azure", "azure-openai"]);
|
|
7
|
+
const LEGACY_PROVIDER_FIELDS = new Set([
|
|
8
|
+
"apiKeyEnv", "endpointEnv", "endpoint", "baseUrl", "model", "deployment", "apiVersion", "format", "locales",
|
|
9
|
+
]);
|
|
10
|
+
|
|
11
|
+
// These are installer selections, not a list of runtime provider.type values.
|
|
5
12
|
export const STT_PROVIDERS = {
|
|
6
|
-
openai: {
|
|
7
|
-
groq: {
|
|
8
|
-
azure: {
|
|
13
|
+
openai: { runtimeType: "openai" },
|
|
14
|
+
groq: { preparedConfigRequired: true },
|
|
15
|
+
azure: { runtimeType: "azure", preparedConfigRequired: true },
|
|
16
|
+
"azure-openai": { runtimeType: "azure-openai", preparedConfigRequired: true },
|
|
9
17
|
};
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
}
|
|
18
|
+
|
|
19
|
+
function isObject(value) {
|
|
20
|
+
return Boolean(value) && typeof value === "object" && !Array.isArray(value);
|
|
21
|
+
}
|
|
22
|
+
function assertString(value, path) {
|
|
23
|
+
if (typeof value !== "string") throw new Error(`${path} must be a string`);
|
|
24
|
+
}
|
|
25
|
+
function assertOptionalString(object, key, path = key) {
|
|
26
|
+
if (object[key] !== undefined) assertString(object[key], path);
|
|
27
|
+
}
|
|
28
|
+
function assertEnvName(value, path) {
|
|
29
|
+
if (typeof value !== "string" || !ENV_NAME.test(value)) throw new Error(`${path} must name an environment variable`);
|
|
30
|
+
}
|
|
31
|
+
function isSecretField(key) {
|
|
32
|
+
if (/Env$/.test(key)) return false;
|
|
33
|
+
return /api.?key|access.?token|auth.?token|secret|password|credential|private.?key/i.test(key);
|
|
34
|
+
}
|
|
35
|
+
function containsSecretValue(value) {
|
|
36
|
+
return typeof value === "string" && /(?:sk-[A-Za-z0-9]|AIza[A-Za-z0-9_-]|gh[pousr]_|Bearer\s+)/i.test(value);
|
|
37
|
+
}
|
|
38
|
+
function validateSafeTree(value, path = "STT config") {
|
|
39
|
+
if (!value || typeof value !== "object") return;
|
|
16
40
|
for (const [key, item] of Object.entries(value)) {
|
|
17
|
-
|
|
18
|
-
if (
|
|
41
|
+
const field = `${path}.${key}`;
|
|
42
|
+
if (isSecretField(key)) throw new Error("STT config must not store secret fields");
|
|
43
|
+
if (/Env$/.test(key)) assertEnvName(item, field);
|
|
44
|
+
if (containsSecretValue(item)) throw new Error("STT config must not store secret values");
|
|
45
|
+
validateSafeTree(item, field);
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
function validateCapture(capture) {
|
|
49
|
+
if (!isObject(capture)) throw new Error("capture must be an object");
|
|
50
|
+
for (const key of ["ffmpegPath", "inputFormat", "input"]) assertOptionalString(capture, key, `capture.${key}`);
|
|
51
|
+
for (const key of ["sampleRate", "channels", "maxSeconds", "minBytes"]) {
|
|
52
|
+
if (capture[key] !== undefined && (typeof capture[key] !== "number" || !Number.isFinite(capture[key]) || capture[key] <= 0)) {
|
|
53
|
+
throw new Error(`capture.${key} must be a positive number`);
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
function validateNestedProvider(provider) {
|
|
58
|
+
if (!isObject(provider)) throw new Error("provider must be an object or supported legacy provider");
|
|
59
|
+
if (typeof provider.type !== "string" || !RUNTIME_PROVIDER_TYPES.has(provider.type)) {
|
|
60
|
+
throw new Error("unsupported provider.type");
|
|
61
|
+
}
|
|
62
|
+
for (const key of ["apiKeyEnv", "endpointEnv"]) {
|
|
63
|
+
if (provider[key] !== undefined) assertEnvName(provider[key], `provider.${key}`);
|
|
64
|
+
}
|
|
65
|
+
for (const key of ["endpoint", "baseUrl", "model", "deployment", "apiVersion"]) {
|
|
66
|
+
assertOptionalString(provider, key, `provider.${key}`);
|
|
67
|
+
}
|
|
68
|
+
if (provider.type === "azure-openai" && (typeof provider.deployment !== "string" || !provider.deployment.trim())) {
|
|
69
|
+
throw new Error("provider.deployment is required for provider.type azure-openai");
|
|
70
|
+
}
|
|
71
|
+
if (provider.format !== undefined && !["simple", "detailed"].includes(provider.format)) {
|
|
72
|
+
throw new Error("provider.format must be simple or detailed");
|
|
73
|
+
}
|
|
74
|
+
if (provider.locales !== undefined && (!Array.isArray(provider.locales) || provider.locales.some((item) => typeof item !== "string"))) {
|
|
75
|
+
throw new Error("provider.locales must be an array of strings");
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
function validateLegacyProvider(value) {
|
|
79
|
+
if (!Object.hasOwn(STT_PROVIDERS, value.provider) || value.provider === "azure-openai") {
|
|
80
|
+
throw new Error("unsupported legacy STT provider");
|
|
19
81
|
}
|
|
20
|
-
|
|
82
|
+
assertEnvName(value.apiKeyEnv, "apiKeyEnv");
|
|
83
|
+
if (value.provider === "azure") assertEnvName(value.endpointEnv, "endpointEnv");
|
|
21
84
|
}
|
|
22
|
-
|
|
85
|
+
|
|
86
|
+
export function validateSttConfig(value) {
|
|
87
|
+
if (!isObject(value)) throw new Error("STT config must be an object");
|
|
88
|
+
if (typeof value.provider === "string") validateLegacyProvider(value);
|
|
89
|
+
else validateNestedProvider(value.provider);
|
|
90
|
+
if (value.keybind !== undefined) assertString(value.keybind, "keybind");
|
|
91
|
+
if (value.language !== undefined) assertString(value.language, "language");
|
|
92
|
+
if (value.capture !== undefined) validateCapture(value.capture);
|
|
93
|
+
validateSafeTree(value);
|
|
94
|
+
return structuredClone(value); // Validation and metadata extraction never mutate human-owned config.
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
export function renderSttConfig(value) {
|
|
98
|
+
return JSON.stringify(validateSttConfig(value), null, 2) + "\n";
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
function providerMetadata(config) {
|
|
102
|
+
if (typeof config.provider === "string") {
|
|
103
|
+
return { format: "legacy", providerType: null, providerAlias: config.provider, provider: config.provider, warning: "legacy STT config preserved without automatic migration; runtime compatibility is not guaranteed" };
|
|
104
|
+
}
|
|
105
|
+
const providerType = config.provider.type;
|
|
106
|
+
const providerAlias = providerType === "openai" || providerType === "azure" || providerType === "azure-openai" ? providerType : null;
|
|
107
|
+
return { format: "runtime", providerType, providerAlias, provider: providerType, warning: null };
|
|
108
|
+
}
|
|
109
|
+
|
|
23
110
|
export function readSttConfig(workspace) {
|
|
24
111
|
const path = join(workspace, ".ai", "stt.json");
|
|
25
112
|
if (!existsSync(path)) return null;
|
|
26
113
|
const text = readFileSync(path, "utf8");
|
|
27
|
-
|
|
28
|
-
|
|
114
|
+
let parsed;
|
|
115
|
+
try { parsed = JSON.parse(text); }
|
|
116
|
+
catch { throw new Error("invalid .ai/stt.json: invalid JSON; repair it manually before setup"); }
|
|
117
|
+
try {
|
|
118
|
+
const config = validateSttConfig(parsed);
|
|
119
|
+
return { path, text, config, ...providerMetadata(config) };
|
|
120
|
+
} catch (error) {
|
|
121
|
+
throw new Error(`invalid .ai/stt.json: ${error.message}; repair it manually before setup`);
|
|
122
|
+
}
|
|
29
123
|
}
|
|
124
|
+
|
|
125
|
+
function requiredEnvNames(config) {
|
|
126
|
+
if (typeof config.provider === "string") return [config.apiKeyEnv, config.endpointEnv].filter(Boolean);
|
|
127
|
+
const provider = config.provider;
|
|
128
|
+
const names = [];
|
|
129
|
+
if (provider.apiKeyEnv) names.push(provider.apiKeyEnv);
|
|
130
|
+
else names.push(provider.type === "azure" ? "AZURE_SPEECH_KEY" : provider.type === "azure-openai" ? "AZURE_OPENAI_API_KEY" : "OPENAI_API_KEY");
|
|
131
|
+
if ((provider.type === "azure" || provider.type === "azure-openai") && !provider.endpoint) {
|
|
132
|
+
names.push(provider.endpointEnv || (provider.type === "azure" ? "AZURE_SPEECH_ENDPOINT" : "AZURE_OPENAI_ENDPOINT"));
|
|
133
|
+
}
|
|
134
|
+
return [...new Set(names)];
|
|
135
|
+
}
|
|
136
|
+
|
|
30
137
|
/** Append empty placeholders only for variables not already declared. */
|
|
31
138
|
export function appendEnvPlaceholders(workspace, config) {
|
|
32
139
|
const path = join(workspace, ".env");
|
|
33
140
|
const before = existsSync(path) ? readFileSync(path, "utf8") : "";
|
|
34
|
-
const names =
|
|
141
|
+
const names = requiredEnvNames(config);
|
|
35
142
|
const missing = names.filter((name) => !new RegExp(`^\\s*(?:export\\s+)?${name}\\s*=`, "m").test(before));
|
|
36
|
-
|
|
143
|
+
const suffix = missing.length ? `${before && !before.endsWith("\n") ? "\n" : ""}${missing.map((name) => `${name}=`).join("\n")}\n` : "";
|
|
144
|
+
return { path, text: before + suffix, missing };
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
function generatedConfig(existing, provider) {
|
|
148
|
+
const retained = structuredClone(existing?.config ?? {});
|
|
149
|
+
if (typeof retained.provider === "string") {
|
|
150
|
+
for (const field of LEGACY_PROVIDER_FIELDS) delete retained[field];
|
|
151
|
+
}
|
|
152
|
+
retained.provider = { type: STT_PROVIDERS[provider].runtimeType };
|
|
153
|
+
return validateSttConfig(retained);
|
|
37
154
|
}
|
|
155
|
+
|
|
38
156
|
export function planStt(workspace, provider, { replacementApproved = false } = {}) {
|
|
39
157
|
const existing = readSttConfig(workspace);
|
|
40
|
-
if (existing && (!provider || provider === existing.
|
|
41
|
-
return { path: existing.path, write: false, preserved: true, provider: existing.
|
|
158
|
+
if (existing && (!provider || provider === existing.providerAlias)) {
|
|
159
|
+
return { path: existing.path, write: false, preserved: true, provider: existing.provider, format: existing.format, warning: existing.warning, env: appendEnvPlaceholders(workspace, existing.config) };
|
|
160
|
+
}
|
|
161
|
+
if (!provider || !Object.hasOwn(STT_PROVIDERS, provider)) {
|
|
162
|
+
throw new Error(`first-time voice setup requires an explicit STT provider: ${Object.keys(STT_PROVIDERS).join(", ")}`);
|
|
163
|
+
}
|
|
164
|
+
if (existing && !replacementApproved) throw new Error(`replacing STT provider ${existing.provider} with ${provider} requires explicit approval`);
|
|
165
|
+
if (STT_PROVIDERS[provider].preparedConfigRequired) {
|
|
166
|
+
throw new Error(`${provider} setup requires a prepared nested .ai/stt.json with provider-specific settings; no values were guessed`);
|
|
42
167
|
}
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
168
|
+
const config = generatedConfig(existing, provider);
|
|
169
|
+
return {
|
|
170
|
+
path: join(workspace, ".ai", "stt.json"),
|
|
171
|
+
text: renderSttConfig(config),
|
|
172
|
+
write: true,
|
|
173
|
+
preserved: false,
|
|
174
|
+
replacing: existing?.provider ?? null,
|
|
175
|
+
provider,
|
|
176
|
+
env: appendEnvPlaceholders(workspace, config),
|
|
177
|
+
};
|
|
47
178
|
}
|