@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,143 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: drafting-workflows
|
|
3
|
+
description: Drafts deterministic Agent Fleet workflows by adapting the nearest existing flow and proving the draft compiles and dry-runs. Use when creating or changing a `just flow` workflow or translating an operator request into agent phase prompts.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Drafting Workflows
|
|
7
|
+
|
|
8
|
+
## Overview
|
|
9
|
+
|
|
10
|
+
Draft code-owned workflows by copying a proven flow shape, then edit only the decisions that actually require judgment. The operator owns intent; code owns phase order, retries, gates, permissions, and acceptance.
|
|
11
|
+
|
|
12
|
+
## When to Use
|
|
13
|
+
|
|
14
|
+
- Creating a new `.pi/agent-fleet/scripts/workflows/wf-*.ts` flow.
|
|
15
|
+
- Changing a flow's phase order, gates, retries, or acceptance rule.
|
|
16
|
+
- Translating an operator request into a prompt for an agent phase.
|
|
17
|
+
|
|
18
|
+
Do not use this skill to improvise an interactive hub dispatch. `just fleet` remains a separate orchestration surface.
|
|
19
|
+
|
|
20
|
+
## Process
|
|
21
|
+
|
|
22
|
+
### 1. Map, list, and stop
|
|
23
|
+
|
|
24
|
+
Read the managed workflow map in `.pi/agent-fleet/docs/workflows.md`, then list every available `.pi/agent-fleet/scripts/workflows/wf-*.ts` with exactly one line containing its name and `Phases:` shape. **Stop and wait for the operator to select or describe the desired flow.**
|
|
25
|
+
|
|
26
|
+
At this point:
|
|
27
|
+
|
|
28
|
+
- Do not open flow traces.
|
|
29
|
+
- Do not inventory the repository.
|
|
30
|
+
- Do not volunteer a dashboard or a guessed “current state.”
|
|
31
|
+
|
|
32
|
+
This discipline matters for three independent reasons: volunteered state is guessed state; reconnaissance spends context the real request will need; and a status dump is stale as soon as it is printed.
|
|
33
|
+
|
|
34
|
+
### 2. Preserve the request exactly
|
|
35
|
+
|
|
36
|
+
Translate the request into this four-line prompt:
|
|
37
|
+
|
|
38
|
+
```text
|
|
39
|
+
<the request — one imperative sentence, retaining their exact words wherever they were specific>
|
|
40
|
+
Where: <files/directories you actually checked>
|
|
41
|
+
Done means: <the observable outcome>
|
|
42
|
+
Out of scope: <the tempting addition you will not add>
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
**The intent is theirs. The precision is yours.** You may improve grammar, order, and verbosity. You may not silently omit a requirement, weaken a strong request (`rewrite` must not become `lightly refactor`), or invent an outcome.
|
|
46
|
+
|
|
47
|
+
Before running an agent phase, report the exact prompt you will send **verbatim**. Exact-prompt fidelity is evidence: a bad translation can be corrected before it reaches a commit phase.
|
|
48
|
+
|
|
49
|
+
### 3. Describe the phase shape
|
|
50
|
+
|
|
51
|
+
Write phases in execution order with explicit kinds, for example:
|
|
52
|
+
|
|
53
|
+
```text
|
|
54
|
+
agent(plan) → agent(build) → agent(review)
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Use `engineer(...)` only for operator-owned input, `agent(...)` for judgment, and `code(...)` for known deterministic commands or repository calculations. A known test command is code, not an agent.
|
|
58
|
+
|
|
59
|
+
### 4. Generate from the nearest shape
|
|
60
|
+
|
|
61
|
+
Run:
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
node --experimental-strip-types skills/drafting-workflows/scripts/make-workflow.ts \
|
|
65
|
+
<name> 'agent(plan) → agent(build) → agent(review)'
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
The generator reads `Phases:` docstrings, compares phase-kind sequences deterministically, and breaks ties by workflow name. Commas inside phase parentheses (for example `agent(builder-fix, bounded)`) remain part of that phase. It copies the nearest source in full, replaces the phase docstring block, and renames the workflow/preflight entry symbols to match the new file. It never overwrites an existing workflow.
|
|
69
|
+
|
|
70
|
+
Do not regenerate boilerplate from memory. Copying the entire nearest flow preserves imports, envelopes, explicit permission enforcement, gates, correction behavior, dry-run stubs, and finish semantics that a partial template can accidentally omit. The symbol rename is the sole identity change required to make `just flow <name>` discover the new module.
|
|
71
|
+
|
|
72
|
+
### 5. Resolve judgment-only TODOs
|
|
73
|
+
|
|
74
|
+
The draft marks only three classes of decisions:
|
|
75
|
+
|
|
76
|
+
- executable gates for claims that need repository evidence;
|
|
77
|
+
- bounded retry limits for safely correctable phases;
|
|
78
|
+
- the final acceptance condition, separate from phase completion.
|
|
79
|
+
|
|
80
|
+
Edit the copied phase bodies so the declared shape is real. Remove each TODO only after making that decision. Do not add TODOs for imports, envelope wiring, trace calls, dry-run stubs, or other boilerplate.
|
|
81
|
+
|
|
82
|
+
For the complete contracts, read `../../references/workflow-authoring.md`.
|
|
83
|
+
|
|
84
|
+
### 6. Keep the envelope triad synchronized
|
|
85
|
+
|
|
86
|
+
For every agent phase, keep these three sites identical:
|
|
87
|
+
|
|
88
|
+
1. the TypeBox schema in `lib/envelopes.ts`;
|
|
89
|
+
2. the JSON example emitted by the phase prompt;
|
|
90
|
+
3. the `envelope:` name at the workflow call site.
|
|
91
|
+
|
|
92
|
+
Use existing return-contract vocabulary. A parsed envelope with `status: "fail"` is a failed phase, not a successful parse.
|
|
93
|
+
|
|
94
|
+
### 7. Prove the draft before handoff
|
|
95
|
+
|
|
96
|
+
The generator refuses handoff unless both gates pass:
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
npx tsc -p .pi/agent-fleet/scripts/workflows/tsconfig.json --noEmit
|
|
100
|
+
node --experimental-strip-types skills/drafting-workflows/scripts/make-workflow.ts \
|
|
101
|
+
--verify-draft .pi/agent-fleet/scripts/workflows/wf-<name>.ts
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
The second command resolves the exact `wf-<name>.ts` entry export used by the flow registry, then executes it with stubbed agent phases and `dryRun: true`; it makes no model call. If either gate fails, the generator deletes the draft and reports the exact failure. Repair the source decision or rerun the generator—never bypass either gate. A handed-off draft is immediately reachable as `just flow <name>`; no central registry edit is required.
|
|
105
|
+
|
|
106
|
+
## Common Rationalizations
|
|
107
|
+
|
|
108
|
+
| Rationalization | Reality |
|
|
109
|
+
|---|---|
|
|
110
|
+
| “I should inspect traces first so I understand the state.” | Volunteered state is guessed, costly, and immediately stale. Map, list, stop. |
|
|
111
|
+
| “The operator clearly meant a smaller refactor.” | Weakening the request changes intent. Preserve their exact strong wording. |
|
|
112
|
+
| “A fresh template is cleaner than copying.” | A template silently drops proven safety wiring. Copy the nearest whole flow. |
|
|
113
|
+
| “The TypeScript is obvious; dry-run is enough.” | Type and runtime gates catch different failures. Both are mandatory. |
|
|
114
|
+
| “This TODO is harmless boilerplate.” | Boilerplate TODOs shift syntax work back to the operator. TODOs are for judgment only. |
|
|
115
|
+
| “The phases passed, so acceptance is implied.” | Phase completion and accepted work are deliberately separate facts. |
|
|
116
|
+
|
|
117
|
+
## Red Flags
|
|
118
|
+
|
|
119
|
+
- Reporting repository or trace state before the operator asks for a flow.
|
|
120
|
+
- Sending a paraphrased prompt without showing its exact text.
|
|
121
|
+
- A phase docstring that does not match the implemented phase order.
|
|
122
|
+
- Shell command strings where an argv list is available.
|
|
123
|
+
- Agent phases used to rediscover a known test command.
|
|
124
|
+
- Unbounded correction loops or retries after a permission breach.
|
|
125
|
+
- An approved review with blocking findings.
|
|
126
|
+
- A draft handed off after only one of compile or dry-run succeeds.
|
|
127
|
+
|
|
128
|
+
## Verification
|
|
129
|
+
|
|
130
|
+
Before presenting a workflow draft, confirm:
|
|
131
|
+
|
|
132
|
+
- [ ] The workflow map was read, available flows were listed one per line, and work stopped for operator direction.
|
|
133
|
+
- [ ] The four-line phase prompt preserves every explicit requirement and was reported verbatim.
|
|
134
|
+
- [ ] The nearest existing flow was copied in full; only its phase docstring block was initially replaced.
|
|
135
|
+
- [ ] Every remaining `// TODO:` is a gate, retry-bound, or acceptance judgment.
|
|
136
|
+
- [ ] Implemented phase order matches the `Phases:` docstring.
|
|
137
|
+
- [ ] Envelope schema, JSON prompt example, and call-site name agree.
|
|
138
|
+
- [ ] Every agent phase has an explicit persona or call-site writes policy; omission is a startup error, never unrestricted by accident.
|
|
139
|
+
- [ ] Writes policy and protected paths are enforced around agent phases.
|
|
140
|
+
- [ ] The generated export is uniquely named for the file and resolves through `just flow <name>`.
|
|
141
|
+
- [ ] `npx tsc -p .pi/agent-fleet/scripts/workflows/tsconfig.json --noEmit` passes.
|
|
142
|
+
- [ ] The generated workflow's stubbed dry run is accepted with zero model calls.
|
|
143
|
+
- [ ] The exact commands and outcomes are included in the handoff.
|
|
@@ -0,0 +1,177 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { spawnSync } from "node:child_process";
|
|
3
|
+
import { existsSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
|
|
4
|
+
import { basename, dirname, resolve } from "node:path";
|
|
5
|
+
import { pathToFileURL } from "node:url";
|
|
6
|
+
|
|
7
|
+
const PHASE_DOCSTRING = /\/\*\*\s*Phases:\s*([^\n*]+)[\s\S]*?\*\//;
|
|
8
|
+
const SAFE_NAME = /^[a-z][a-z0-9-]*$/;
|
|
9
|
+
const RESERVED_FLOW_NAMES = new Set(["cleanup", "merge"]);
|
|
10
|
+
export type PhaseKind = "engineer" | "agent" | "code";
|
|
11
|
+
export interface WorkflowShape { path: string; name: string; source: string; phases: string[]; kinds: PhaseKind[] }
|
|
12
|
+
export interface CommandResult { status: number | null; stdout?: string; stderr?: string }
|
|
13
|
+
export type CommandRunner = (command: string, args: string[], cwd: string) => CommandResult;
|
|
14
|
+
|
|
15
|
+
export function parsePhaseList(value: string): string[] {
|
|
16
|
+
const phases: string[] = [];
|
|
17
|
+
let start = 0;
|
|
18
|
+
let depth = 0;
|
|
19
|
+
for (let index = 0; index < value.length; index++) {
|
|
20
|
+
if (value[index] === "(") depth++;
|
|
21
|
+
else if (value[index] === ")") {
|
|
22
|
+
if (depth === 0) throw new Error("Unbalanced phase parentheses.");
|
|
23
|
+
depth--;
|
|
24
|
+
} else if (depth === 0 && (value[index] === "→" || value[index] === "," || value.slice(index, index + 2) === "->")) {
|
|
25
|
+
const phase = value.slice(start, index).trim();
|
|
26
|
+
if (phase) phases.push(phase);
|
|
27
|
+
if (value.slice(index, index + 2) === "->") index++;
|
|
28
|
+
start = index + 1;
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
if (depth !== 0) throw new Error("Unbalanced phase parentheses.");
|
|
32
|
+
const finalPhase = value.slice(start).trim();
|
|
33
|
+
if (finalPhase) phases.push(finalPhase);
|
|
34
|
+
if (!phases.length) throw new Error("At least one phase is required.");
|
|
35
|
+
return phases;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
export function phaseKind(phase: string): PhaseKind {
|
|
39
|
+
const explicit = phase.match(/^\s*(engineer|agent|code)\s*\(/i)?.[1]?.toLowerCase() as PhaseKind | undefined;
|
|
40
|
+
if (explicit) return explicit;
|
|
41
|
+
const name = phase.toLowerCase().replace(/[^a-z0-9-]/g, "");
|
|
42
|
+
if (/^(request|input|brief|goal)/.test(name)) return "engineer";
|
|
43
|
+
if (/^(test|quality|verify|lint|typecheck|commit|changes|capture)/.test(name)) return "code";
|
|
44
|
+
return "agent";
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
export function readWorkflowShapes(workflowsDir: string): WorkflowShape[] {
|
|
48
|
+
return readdirSync(workflowsDir)
|
|
49
|
+
.filter(file => /^wf-[a-z0-9-]+\.ts$/.test(file))
|
|
50
|
+
.sort()
|
|
51
|
+
.map(file => {
|
|
52
|
+
const path = resolve(workflowsDir, file);
|
|
53
|
+
const source = readFileSync(path, "utf8");
|
|
54
|
+
const match = source.match(PHASE_DOCSTRING);
|
|
55
|
+
if (!match) throw new Error(`${file} has no /** Phases: ... */ docstring.`);
|
|
56
|
+
const phases = parsePhaseList(match[1]);
|
|
57
|
+
return { path, name: file.slice(3, -3), source, phases, kinds: phases.map(phaseKind) };
|
|
58
|
+
});
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
function editDistance(left: PhaseKind[], right: PhaseKind[]): number {
|
|
62
|
+
const row = Array.from({ length: right.length + 1 }, (_, index) => index);
|
|
63
|
+
for (let i = 1; i <= left.length; i++) {
|
|
64
|
+
let diagonal = row[0];
|
|
65
|
+
row[0] = i;
|
|
66
|
+
for (let j = 1; j <= right.length; j++) {
|
|
67
|
+
const above = row[j];
|
|
68
|
+
row[j] = Math.min(row[j] + 1, row[j - 1] + 1, diagonal + (left[i - 1] === right[j - 1] ? 0 : 1));
|
|
69
|
+
diagonal = above;
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
return row[right.length];
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
export function selectNearestWorkflow(shapes: WorkflowShape[], requestedPhases: string[]): WorkflowShape {
|
|
76
|
+
if (!shapes.length) throw new Error("No .pi/agent-fleet/scripts/workflows/wf-*.ts sources were found.");
|
|
77
|
+
const requestedKinds = requestedPhases.map(phaseKind);
|
|
78
|
+
return [...shapes].sort((left, right) => {
|
|
79
|
+
const leftScore = editDistance(left.kinds, requestedKinds) * 100 + Math.abs(left.kinds.length - requestedKinds.length) * 10;
|
|
80
|
+
const rightScore = editDistance(right.kinds, requestedKinds) * 100 + Math.abs(right.kinds.length - requestedKinds.length) * 10;
|
|
81
|
+
return leftScore - rightScore || left.name.localeCompare(right.name);
|
|
82
|
+
})[0];
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
export function workflowExportName(name: string): string {
|
|
86
|
+
return `${name.replace(/-([a-z0-9])/g, (_, char: string) => char.toUpperCase())}Workflow`;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
export function renameWorkflowSymbols(source: string, sourceName: string, targetName: string): string {
|
|
90
|
+
const sourceWorkflow = workflowExportName(sourceName);
|
|
91
|
+
const targetWorkflow = workflowExportName(targetName);
|
|
92
|
+
const sourcePreflight = `${sourceWorkflow}Preflight`;
|
|
93
|
+
const targetPreflight = `${targetWorkflow}Preflight`;
|
|
94
|
+
return source
|
|
95
|
+
.replace(new RegExp(`\\b${sourcePreflight}\\b`, "g"), targetPreflight)
|
|
96
|
+
.replace(new RegExp(`\\b${sourceWorkflow}\\b`, "g"), targetWorkflow);
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
export function replacePhaseDocstring(source: string, phases: string[]): string {
|
|
100
|
+
if (!PHASE_DOCSTRING.test(source)) throw new Error("Source workflow has no phase docstring to replace.");
|
|
101
|
+
const phaseList = phases.join(" → ");
|
|
102
|
+
const replacement = `/** Phases: ${phaseList}\n * TODO: Choose executable gates for claims that require repository evidence.\n * TODO: Choose bounded retry limits for phases that can be corrected safely.\n * TODO: Define the final acceptance condition independently from phase completion.\n */`;
|
|
103
|
+
return source.replace(PHASE_DOCSTRING, replacement);
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
const defaultRunner: CommandRunner = (command, args, cwd) => {
|
|
107
|
+
const result = spawnSync(command, args, { cwd, encoding: "utf8", env: process.env });
|
|
108
|
+
return { status: result.status, stdout: result.stdout, stderr: result.stderr || result.error?.message };
|
|
109
|
+
};
|
|
110
|
+
|
|
111
|
+
function gateFailure(label: string, result: CommandResult): Error {
|
|
112
|
+
const detail = `${result.stdout ?? ""}${result.stderr ?? ""}`.trim();
|
|
113
|
+
return new Error(`${label} failed${result.status === null ? " to start" : ` with exit ${result.status}`}${detail ? `:\n${detail}` : "."}`);
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
export function makeWorkflow(options: {
|
|
117
|
+
cwd: string; name: string; phases: string[]; workflowsDir?: string; runner?: CommandRunner;
|
|
118
|
+
}): { outputPath: string; sourcePath: string; phases: string[] } {
|
|
119
|
+
if (!SAFE_NAME.test(options.name)) throw new Error(`Invalid workflow name: ${options.name}`);
|
|
120
|
+
if (RESERVED_FLOW_NAMES.has(options.name)) throw new Error(`Workflow name is reserved for maintenance: ${options.name}`);
|
|
121
|
+
const workflowsDir = resolve(options.workflowsDir ?? resolve(options.cwd, ".pi/agent-fleet/scripts/workflows"));
|
|
122
|
+
const outputPath = resolve(workflowsDir, `wf-${options.name}.ts`);
|
|
123
|
+
if (existsSync(outputPath)) throw new Error(`Refusing to overwrite existing workflow: ${outputPath}`);
|
|
124
|
+
const nearest = selectNearestWorkflow(readWorkflowShapes(workflowsDir), options.phases);
|
|
125
|
+
const copied = renameWorkflowSymbols(nearest.source, nearest.name, options.name);
|
|
126
|
+
writeFileSync(outputPath, replacePhaseDocstring(copied, options.phases), "utf8");
|
|
127
|
+
const runner = options.runner ?? defaultRunner;
|
|
128
|
+
try {
|
|
129
|
+
const tsc = resolve(options.cwd, "node_modules/.bin/tsc");
|
|
130
|
+
const compile = runner(tsc, ["-p", resolve(workflowsDir, "tsconfig.json"), "--noEmit"], options.cwd);
|
|
131
|
+
if (compile.status !== 0) throw gateFailure("Scoped workflow typecheck", compile);
|
|
132
|
+
const dryRun = runner(process.execPath, ["--experimental-strip-types", resolve(options.cwd, "skills/drafting-workflows/scripts/make-workflow.ts"), "--verify-draft", outputPath], options.cwd);
|
|
133
|
+
if (dryRun.status !== 0) throw gateFailure("Generated workflow dry run", dryRun);
|
|
134
|
+
return { outputPath, sourcePath: nearest.path, phases: [...options.phases] };
|
|
135
|
+
} catch (error) {
|
|
136
|
+
rmSync(outputPath, { force: true });
|
|
137
|
+
throw error;
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
export async function verifyDraft(path: string, cwd = process.cwd()): Promise<void> {
|
|
142
|
+
const resolvedPath = resolve(path);
|
|
143
|
+
const workflowName = basename(resolvedPath).replace(/^wf-/, "").replace(/\.ts$/, "");
|
|
144
|
+
const flowModulePath = resolve(cwd, ".pi/agent-fleet/scripts/flow.ts");
|
|
145
|
+
const { resolveWorkflow } = await import(`${pathToFileURL(flowModulePath).href}?verify=${Date.now()}`) as {
|
|
146
|
+
resolveWorkflow(name: string, workflowsDir?: string): Promise<{ run: (run: unknown, input: { args: string[]; dryRun: boolean; cwd: string }) => Promise<{ accepted: boolean }> } | undefined>;
|
|
147
|
+
};
|
|
148
|
+
const entry = await resolveWorkflow(workflowName, dirname(resolvedPath));
|
|
149
|
+
if (!entry) throw new Error(`${basename(path)} is not reachable as flow ${workflowName}.`);
|
|
150
|
+
const runModulePath: string = resolve(dirname(path), "lib/run.ts");
|
|
151
|
+
const { Run } = await import(pathToFileURL(runModulePath).href) as { Run: new (options: { cwd: string; runId: string; command: string[] }) => unknown };
|
|
152
|
+
const run = new Run({ cwd, runId: `draft-${process.pid}-${Date.now()}`, command: ["make-workflow", "--verify-draft", path] });
|
|
153
|
+
const result = await entry.run(run, {
|
|
154
|
+
args: ["generated workflow acceptance request"], dryRun: true, cwd,
|
|
155
|
+
});
|
|
156
|
+
if (!result?.accepted) throw new Error(`${basename(path)} dry run was not accepted.`);
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
async function main(argv: string[]): Promise<number> {
|
|
160
|
+
try {
|
|
161
|
+
if (argv[0] === "--verify-draft") {
|
|
162
|
+
if (!argv[1]) throw new Error("--verify-draft requires a workflow path.");
|
|
163
|
+
await verifyDraft(argv[1]);
|
|
164
|
+
return 0;
|
|
165
|
+
}
|
|
166
|
+
if (argv.length < 2) throw new Error("Usage: make-workflow <name> '<phase → phase → phase>'");
|
|
167
|
+
const phases = parsePhaseList(argv.slice(1).join(" "));
|
|
168
|
+
const result = makeWorkflow({ cwd: process.cwd(), name: argv[0], phases });
|
|
169
|
+
console.log(JSON.stringify({ workflow: result.outputPath, copiedFrom: result.sourcePath, phases: result.phases }));
|
|
170
|
+
return 0;
|
|
171
|
+
} catch (error) {
|
|
172
|
+
console.error(error instanceof Error ? error.message : String(error));
|
|
173
|
+
return 1;
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
if (import.meta.url === pathToFileURL(process.argv[1] ?? "").href) process.exitCode = await main(process.argv.slice(2));
|
|
@@ -0,0 +1,328 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: frontend-ui-engineering
|
|
3
|
+
description: Builds production-quality, accessible, responsive user-facing UIs. Use when building or modifying interfaces and pages, creating components, implementing layouts, meeting WCAG accessibility requirements, managing state, or when the output needs to look and feel production-quality rather than AI-generated.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Frontend UI Engineering
|
|
7
|
+
|
|
8
|
+
## Overview
|
|
9
|
+
|
|
10
|
+
Build production-quality user interfaces that are accessible, performant, and visually polished. The goal is UI that looks like it was built by a design-aware engineer at a top company — not like it was generated by an AI. This means real design system adherence, proper accessibility, thoughtful interaction patterns, and no generic "AI aesthetic."
|
|
11
|
+
|
|
12
|
+
## When to Use
|
|
13
|
+
|
|
14
|
+
- Building new UI components or pages
|
|
15
|
+
- Modifying existing user-facing interfaces
|
|
16
|
+
- Implementing responsive layouts
|
|
17
|
+
- Adding interactivity or state management
|
|
18
|
+
- Fixing visual or UX issues
|
|
19
|
+
|
|
20
|
+
## Component Architecture
|
|
21
|
+
|
|
22
|
+
### File Structure
|
|
23
|
+
|
|
24
|
+
Colocate everything related to a component:
|
|
25
|
+
|
|
26
|
+
```
|
|
27
|
+
src/components/
|
|
28
|
+
TaskList/
|
|
29
|
+
TaskList.tsx # Component implementation
|
|
30
|
+
TaskList.test.tsx # Tests
|
|
31
|
+
TaskList.stories.tsx # Storybook stories (if using)
|
|
32
|
+
use-task-list.ts # Custom hook (if complex state)
|
|
33
|
+
types.ts # Component-specific types (if needed)
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
### Component Patterns
|
|
37
|
+
|
|
38
|
+
**Prefer composition over configuration:**
|
|
39
|
+
|
|
40
|
+
```tsx
|
|
41
|
+
// Good: Composable
|
|
42
|
+
<Card>
|
|
43
|
+
<CardHeader>
|
|
44
|
+
<CardTitle>Tasks</CardTitle>
|
|
45
|
+
</CardHeader>
|
|
46
|
+
<CardBody>
|
|
47
|
+
<TaskList tasks={tasks} />
|
|
48
|
+
</CardBody>
|
|
49
|
+
</Card>
|
|
50
|
+
|
|
51
|
+
// Avoid: Over-configured
|
|
52
|
+
<Card
|
|
53
|
+
title="Tasks"
|
|
54
|
+
headerVariant="large"
|
|
55
|
+
bodyPadding="md"
|
|
56
|
+
content={<TaskList tasks={tasks} />}
|
|
57
|
+
/>
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
**Keep components focused:**
|
|
61
|
+
|
|
62
|
+
```tsx
|
|
63
|
+
// Good: Does one thing
|
|
64
|
+
export function TaskItem({ task, onToggle, onDelete }: TaskItemProps) {
|
|
65
|
+
return (
|
|
66
|
+
<li className="flex items-center gap-3 p-3">
|
|
67
|
+
<Checkbox checked={task.done} onChange={() => onToggle(task.id)} />
|
|
68
|
+
<span className={task.done ? 'line-through text-muted' : ''}>{task.title}</span>
|
|
69
|
+
<Button variant="ghost" size="sm" onClick={() => onDelete(task.id)}>
|
|
70
|
+
<TrashIcon />
|
|
71
|
+
</Button>
|
|
72
|
+
</li>
|
|
73
|
+
);
|
|
74
|
+
}
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
**Separate data fetching from presentation:**
|
|
78
|
+
|
|
79
|
+
```tsx
|
|
80
|
+
// Container: handles data
|
|
81
|
+
export function TaskListContainer() {
|
|
82
|
+
const { tasks, isLoading, error } = useTasks();
|
|
83
|
+
|
|
84
|
+
if (isLoading) return <TaskListSkeleton />;
|
|
85
|
+
if (error) return <ErrorState message="Failed to load tasks" retry={refetch} />;
|
|
86
|
+
if (tasks.length === 0) return <EmptyState message="No tasks yet" />;
|
|
87
|
+
|
|
88
|
+
return <TaskList tasks={tasks} />;
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
// Presentation: handles rendering
|
|
92
|
+
export function TaskList({ tasks }: { tasks: Task[] }) {
|
|
93
|
+
return (
|
|
94
|
+
<ul role="list" className="divide-y">
|
|
95
|
+
{tasks.map(task => <TaskItem key={task.id} task={task} />)}
|
|
96
|
+
</ul>
|
|
97
|
+
);
|
|
98
|
+
}
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
## State Management
|
|
102
|
+
|
|
103
|
+
**Choose the simplest approach that works:**
|
|
104
|
+
|
|
105
|
+
```
|
|
106
|
+
Local state (useState) → Component-specific UI state
|
|
107
|
+
Lifted state → Shared between 2-3 sibling components
|
|
108
|
+
Context → Theme, auth, locale (read-heavy, write-rare)
|
|
109
|
+
URL state (searchParams) → Filters, pagination, shareable UI state
|
|
110
|
+
Server state (React Query, SWR) → Remote data with caching
|
|
111
|
+
Global store (Zustand, Redux) → Complex client state shared app-wide
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
**Avoid prop drilling deeper than 3 levels.** If you're passing props through components that don't use them, introduce context or restructure the component tree.
|
|
115
|
+
|
|
116
|
+
## Design System Adherence
|
|
117
|
+
|
|
118
|
+
### Avoid the AI Aesthetic
|
|
119
|
+
|
|
120
|
+
AI-generated UI has recognizable patterns. Avoid all of them:
|
|
121
|
+
|
|
122
|
+
| AI Default | Why It Is a Problem | Production Quality |
|
|
123
|
+
|---|---|---|
|
|
124
|
+
| Purple/indigo everything | Models default to visually "safe" palettes, making every app look identical | Use the project's actual color palette |
|
|
125
|
+
| Excessive gradients | Gradients add visual noise and clash with most design systems | Flat or subtle gradients matching the design system |
|
|
126
|
+
| Rounded everything (rounded-2xl) | Maximum rounding signals "friendly" but ignores the hierarchy of corner radii in real designs | Consistent border-radius from the design system |
|
|
127
|
+
| Generic hero sections | Template-driven layout with no connection to the actual content or user need | Content-first layouts |
|
|
128
|
+
| Lorem ipsum-style copy | Placeholder text hides layout problems that real content reveals (length, wrapping, overflow) | Realistic placeholder content |
|
|
129
|
+
| Oversized padding everywhere | Equal generous padding destroys visual hierarchy and wastes screen space | Consistent spacing scale |
|
|
130
|
+
| Stock card grids | Uniform grids are a layout shortcut that ignores information priority and scanning patterns | Purpose-driven layouts |
|
|
131
|
+
| Shadow-heavy design | Layered shadows add depth that competes with content and slows rendering on low-end devices | Subtle or no shadows unless the design system specifies |
|
|
132
|
+
|
|
133
|
+
### Spacing and Layout
|
|
134
|
+
|
|
135
|
+
Use a consistent spacing scale. Don't invent values:
|
|
136
|
+
|
|
137
|
+
```css
|
|
138
|
+
/* Use the scale: 0.25rem increments (or whatever the project uses) */
|
|
139
|
+
/* Good */ padding: 1rem; /* 16px */
|
|
140
|
+
/* Good */ gap: 0.75rem; /* 12px */
|
|
141
|
+
/* Bad */ padding: 13px; /* Not on any scale */
|
|
142
|
+
/* Bad */ margin-top: 2.3rem; /* Not on any scale */
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
### Typography
|
|
146
|
+
|
|
147
|
+
Respect the type hierarchy:
|
|
148
|
+
|
|
149
|
+
```
|
|
150
|
+
h1 → Page title (one per page)
|
|
151
|
+
h2 → Section title
|
|
152
|
+
h3 → Subsection title
|
|
153
|
+
body → Default text
|
|
154
|
+
small → Secondary/helper text
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
Don't skip heading levels. Don't use heading styles for non-heading content.
|
|
158
|
+
|
|
159
|
+
### Color
|
|
160
|
+
|
|
161
|
+
- Use semantic color tokens: `text-primary`, `bg-surface`, `border-default` — not raw hex values
|
|
162
|
+
- Ensure sufficient contrast (4.5:1 for normal text, 3:1 for large text)
|
|
163
|
+
- Don't rely solely on color to convey information (use icons, text, or patterns too)
|
|
164
|
+
|
|
165
|
+
## Accessibility (WCAG 2.1 AA)
|
|
166
|
+
|
|
167
|
+
Every component must meet these standards:
|
|
168
|
+
|
|
169
|
+
### Keyboard Navigation
|
|
170
|
+
|
|
171
|
+
```tsx
|
|
172
|
+
// Every interactive element must be keyboard accessible
|
|
173
|
+
<button onClick={handleClick}>Click me</button> // ✓ Focusable by default
|
|
174
|
+
<div onClick={handleClick}>Click me</div> // ✗ Not focusable
|
|
175
|
+
<div role="button" tabIndex={0} onClick={handleClick} // ✓ But prefer <button>
|
|
176
|
+
onKeyDown={e => {
|
|
177
|
+
if (e.key === 'Enter') handleClick();
|
|
178
|
+
if (e.key === ' ') e.preventDefault();
|
|
179
|
+
}}
|
|
180
|
+
onKeyUp={e => {
|
|
181
|
+
if (e.key === ' ') handleClick();
|
|
182
|
+
}}>
|
|
183
|
+
Click me
|
|
184
|
+
</div>
|
|
185
|
+
```
|
|
186
|
+
|
|
187
|
+
### ARIA Labels
|
|
188
|
+
|
|
189
|
+
```tsx
|
|
190
|
+
// Label interactive elements that lack visible text
|
|
191
|
+
<button aria-label="Close dialog"><XIcon /></button>
|
|
192
|
+
|
|
193
|
+
// Label form inputs
|
|
194
|
+
<label htmlFor="email">Email</label>
|
|
195
|
+
<input id="email" type="email" />
|
|
196
|
+
|
|
197
|
+
// Or use aria-label when no visible label exists
|
|
198
|
+
<input aria-label="Search tasks" type="search" />
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
### Focus Management
|
|
202
|
+
|
|
203
|
+
```tsx
|
|
204
|
+
// Move focus when content changes
|
|
205
|
+
function Dialog({ isOpen, onClose }: DialogProps) {
|
|
206
|
+
const closeRef = useRef<HTMLButtonElement>(null);
|
|
207
|
+
|
|
208
|
+
useEffect(() => {
|
|
209
|
+
if (isOpen) closeRef.current?.focus();
|
|
210
|
+
}, [isOpen]);
|
|
211
|
+
|
|
212
|
+
// Trap focus inside dialog when open
|
|
213
|
+
return (
|
|
214
|
+
<dialog open={isOpen}>
|
|
215
|
+
<button ref={closeRef} onClick={onClose}>Close</button>
|
|
216
|
+
{/* dialog content */}
|
|
217
|
+
</dialog>
|
|
218
|
+
);
|
|
219
|
+
}
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
### Meaningful Empty and Error States
|
|
223
|
+
|
|
224
|
+
```tsx
|
|
225
|
+
// Don't show blank screens
|
|
226
|
+
function TaskList({ tasks }: { tasks: Task[] }) {
|
|
227
|
+
if (tasks.length === 0) {
|
|
228
|
+
return (
|
|
229
|
+
<div role="status" className="text-center py-12">
|
|
230
|
+
<TasksEmptyIcon className="mx-auto h-12 w-12 text-muted" />
|
|
231
|
+
<h3 className="mt-2 text-sm font-medium">No tasks</h3>
|
|
232
|
+
<p className="mt-1 text-sm text-muted">Get started by creating a new task.</p>
|
|
233
|
+
<Button className="mt-4" onClick={onCreateTask}>Create Task</Button>
|
|
234
|
+
</div>
|
|
235
|
+
);
|
|
236
|
+
}
|
|
237
|
+
|
|
238
|
+
return <ul role="list">...</ul>;
|
|
239
|
+
}
|
|
240
|
+
```
|
|
241
|
+
|
|
242
|
+
## Responsive Design
|
|
243
|
+
|
|
244
|
+
Design for mobile first, then expand:
|
|
245
|
+
|
|
246
|
+
```tsx
|
|
247
|
+
// Tailwind: mobile-first responsive
|
|
248
|
+
<div className="
|
|
249
|
+
grid grid-cols-1 /* Mobile: single column */
|
|
250
|
+
sm:grid-cols-2 /* Small: 2 columns */
|
|
251
|
+
lg:grid-cols-3 /* Large: 3 columns */
|
|
252
|
+
gap-4
|
|
253
|
+
">
|
|
254
|
+
```
|
|
255
|
+
|
|
256
|
+
Test at these breakpoints: 320px, 768px, 1024px, 1440px.
|
|
257
|
+
|
|
258
|
+
## Loading and Transitions
|
|
259
|
+
|
|
260
|
+
```tsx
|
|
261
|
+
// Skeleton loading (not spinners for content)
|
|
262
|
+
function TaskListSkeleton() {
|
|
263
|
+
return (
|
|
264
|
+
<div className="space-y-3" aria-busy="true" aria-label="Loading tasks">
|
|
265
|
+
{Array.from({ length: 3 }).map((_, i) => (
|
|
266
|
+
<div key={i} className="h-12 bg-muted animate-pulse rounded" />
|
|
267
|
+
))}
|
|
268
|
+
</div>
|
|
269
|
+
);
|
|
270
|
+
}
|
|
271
|
+
|
|
272
|
+
// Optimistic updates for perceived speed
|
|
273
|
+
function useToggleTask() {
|
|
274
|
+
const queryClient = useQueryClient();
|
|
275
|
+
|
|
276
|
+
return useMutation({
|
|
277
|
+
mutationFn: toggleTask,
|
|
278
|
+
onMutate: async (taskId) => {
|
|
279
|
+
await queryClient.cancelQueries({ queryKey: ['tasks'] });
|
|
280
|
+
const previous = queryClient.getQueryData(['tasks']);
|
|
281
|
+
|
|
282
|
+
queryClient.setQueryData(['tasks'], (old: Task[]) =>
|
|
283
|
+
old.map(t => t.id === taskId ? { ...t, done: !t.done } : t)
|
|
284
|
+
);
|
|
285
|
+
|
|
286
|
+
return { previous };
|
|
287
|
+
},
|
|
288
|
+
onError: (_err, _taskId, context) => {
|
|
289
|
+
queryClient.setQueryData(['tasks'], context?.previous);
|
|
290
|
+
},
|
|
291
|
+
});
|
|
292
|
+
}
|
|
293
|
+
```
|
|
294
|
+
|
|
295
|
+
## See Also
|
|
296
|
+
|
|
297
|
+
For detailed accessibility requirements and testing tools, see `../../references/accessibility-checklist.md`.
|
|
298
|
+
|
|
299
|
+
## Common Rationalizations
|
|
300
|
+
|
|
301
|
+
| Rationalization | Reality |
|
|
302
|
+
|---|---|
|
|
303
|
+
| "Accessibility is a nice-to-have" | It's a legal requirement in many jurisdictions and an engineering quality standard. |
|
|
304
|
+
| "We'll make it responsive later" | Retrofitting responsive design is 3x harder than building it from the start. |
|
|
305
|
+
| "The design isn't final, so I'll skip styling" | Use the design system defaults. Unstyled UI creates a broken first impression for reviewers. |
|
|
306
|
+
| "This is just a prototype" | Prototypes become production code. Build the foundation right. |
|
|
307
|
+
| "The AI aesthetic is fine for now" | It signals low quality. Use the project's actual design system from the start. |
|
|
308
|
+
|
|
309
|
+
## Red Flags
|
|
310
|
+
|
|
311
|
+
- Components with more than 200 lines (split them)
|
|
312
|
+
- Inline styles or arbitrary pixel values
|
|
313
|
+
- Missing error states, loading states, or empty states
|
|
314
|
+
- No keyboard navigation testing
|
|
315
|
+
- Color as the sole indicator of state (red/green without text or icons)
|
|
316
|
+
- Generic "AI look" (purple gradients, oversized cards, stock layouts)
|
|
317
|
+
|
|
318
|
+
## Verification
|
|
319
|
+
|
|
320
|
+
After building UI:
|
|
321
|
+
|
|
322
|
+
- [ ] Component renders without console errors
|
|
323
|
+
- [ ] All interactive elements are keyboard accessible (Tab through the page)
|
|
324
|
+
- [ ] Screen reader can convey the page's content and structure
|
|
325
|
+
- [ ] Responsive: works at 320px, 768px, 1024px, 1440px
|
|
326
|
+
- [ ] Loading, error, and empty states all handled
|
|
327
|
+
- [ ] Follows the project's design system (spacing, colors, typography)
|
|
328
|
+
- [ ] No accessibility warnings in dev tools or axe-core
|