@chankov/agent-fleet 0.0.6 → 0.0.8
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/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.pi/harnesses/agent-hub/README.md +75 -16
- package/.pi/harnesses/agent-hub/artifacts.js +56 -2
- package/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.pi/harnesses/agent-hub/delegate.ts +58 -9
- package/.pi/harnesses/agent-hub/drift-watchdog.js +54 -8
- package/.pi/harnesses/agent-hub/helpers.ts +34 -0
- package/.pi/harnesses/agent-hub/index.ts +723 -159
- package/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +2 -2
- package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -11
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.pi/harnesses/agent-hub/return-contract.js +78 -0
- package/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.pi/harnesses/agent-hub/run-budget.js +29 -3
- package/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.pi/harnesses/agent-hub/spawn.ts +109 -1
- package/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
- package/.pi/harnesses/coms/README.md +4 -3
- package/.pi/harnesses/coms/index.ts +80 -58
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.pi/harnesses/lib/herdr-client.ts +7 -2
- package/.pi/harnesses/lib/herdr-presence.ts +141 -30
- package/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
- package/.pi/harnesses/lib/hermes-monitor-registry.ts +1 -1
- package/.pi/harnesses/lib/hermes-monitor-socket.ts +47 -2
- package/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.claude/commands/build.md +44 -0
- package/.versions/0.0.7/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.7/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.7/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.7/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.7/.claude/commands/plan.md +16 -0
- package/.versions/0.0.7/.claude/commands/prime.md +22 -0
- package/.versions/0.0.7/.claude/commands/review.md +16 -0
- package/.versions/0.0.7/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.7/.claude/commands/ship.md +72 -0
- package/.versions/0.0.7/.claude/commands/spec.md +15 -0
- package/.versions/0.0.7/.claude/commands/test.md +19 -0
- package/.versions/0.0.7/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.7/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.7/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.7/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.7/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.7/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.7/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.7/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.7/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.7/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.7/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.7/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.7/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.7/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.7/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.7/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.7/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.7/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.7/.pi/extensions/package.json +9 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/README.md +857 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/helpers.ts +248 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/index.ts +8609 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/run-budget.js +181 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
- package/.versions/0.0.7/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.7/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.7/.pi/harnesses/coms/README.md +93 -0
- package/.versions/0.0.7/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/0.0.7/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.7/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/0.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.7/.pi/harnesses/lib/herdr-client.ts +463 -0
- package/.versions/0.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.7/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.7/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.7/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.7/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.7/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.7/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.7/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.7/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.7/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.7/.version +1 -0
- package/.versions/0.0.7/agents/architect.md +23 -0
- package/.versions/0.0.7/agents/bowser.md +26 -0
- package/.versions/0.0.7/agents/builder.md +53 -0
- package/.versions/0.0.7/agents/code-reviewer.md +205 -0
- package/.versions/0.0.7/agents/deep-researcher.md +31 -0
- package/.versions/0.0.7/agents/documenter.md +18 -0
- package/.versions/0.0.7/agents/orchestrator.md +65 -0
- package/.versions/0.0.7/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.7/agents/planner.md +69 -0
- package/.versions/0.0.7/agents/releaser.md +24 -0
- package/.versions/0.0.7/agents/researcher.md +28 -0
- package/.versions/0.0.7/agents/security-auditor.md +166 -0
- package/.versions/0.0.7/agents/test-engineer.md +151 -0
- package/.versions/0.0.7/agents/web-debugger.md +42 -0
- package/.versions/0.0.7/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.7/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.7/docs/ARCHITECTURE.md +262 -0
- package/.versions/0.0.7/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.7/docs/claude-code-coms-bridge.md +109 -0
- package/.versions/0.0.7/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.7/docs/coms-hermes-bridge.md +189 -0
- package/.versions/0.0.7/docs/getting-started.md +231 -0
- package/.versions/0.0.7/docs/npm-install.md +337 -0
- package/.versions/0.0.7/docs/opencode-setup.md +249 -0
- package/.versions/0.0.7/docs/pi-extensions.md +293 -0
- package/.versions/0.0.7/docs/pi-setup.md +476 -0
- package/.versions/0.0.7/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.7/hermes/README.md +347 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.7/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/0.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.7/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/0.0.7/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/0.0.7/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.7/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/0.0.7/hooks/hooks.json +14 -0
- package/.versions/0.0.7/hooks/session-start.sh +74 -0
- package/.versions/0.0.7/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.7/justfile +245 -0
- package/.versions/0.0.7/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.7/references/definition-of-done.md +67 -0
- package/.versions/0.0.7/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.7/references/observability-checklist.md +91 -0
- package/.versions/0.0.7/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.7/references/performance-checklist.md +153 -0
- package/.versions/0.0.7/references/prompting-patterns.md +380 -0
- package/.versions/0.0.7/references/security-checklist.md +179 -0
- package/.versions/0.0.7/references/testing-patterns.md +236 -0
- package/.versions/0.0.7/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.7/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.7/scripts/coms-claude-bridge.ts +401 -0
- package/.versions/0.0.7/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.7/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.7/scripts/fleet.ts +149 -0
- package/.versions/0.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.7/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/0.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/0.0.7/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/0.0.7/scripts/lib/claude-bridge-core.ts +165 -0
- package/.versions/0.0.7/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.7/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.7/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/0.0.7/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.7/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.7/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.7/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.7/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.7/scripts/lib/monitor-env.ts +120 -0
- package/.versions/0.0.7/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.7/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.7/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.7/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.7/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.7/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.7/scripts/team-up.ts +360 -0
- package/.versions/0.0.7/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.7/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.7/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.7/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.7/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.7/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +544 -0
- package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +35 -0
- package/.versions/0.0.7/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.7/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.7/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.7/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.7/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.7/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.7/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.7/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.7/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.7/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.7/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.7/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.7/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.7/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/.versions/0.0.8/.claude/commands/build.md +44 -0
- package/.versions/0.0.8/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.8/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.8/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.8/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.8/.claude/commands/plan.md +16 -0
- package/.versions/0.0.8/.claude/commands/prime.md +22 -0
- package/.versions/0.0.8/.claude/commands/review.md +16 -0
- package/.versions/0.0.8/.claude/commands/set-hermes-telegram.md +15 -0
- package/.versions/0.0.8/.claude/commands/set-hermes-watchdog.md +6 -0
- package/.versions/0.0.8/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.8/.claude/commands/ship.md +72 -0
- package/.versions/0.0.8/.claude/commands/spec.md +15 -0
- package/.versions/0.0.8/.claude/commands/test.md +19 -0
- package/.versions/0.0.8/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.8/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.8/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.8/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.8/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.8/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.8/.opencode/commands/af-doctor-agent-fleet.md +17 -0
- package/.versions/0.0.8/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.8/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.8/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.8/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.8/.opencode/commands/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.8/.opencode/commands/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.8/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.8/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.8/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.8/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.8/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.8/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.8/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.8/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.8/.pi/agents/peers.yaml +146 -0
- package/.versions/0.0.8/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.8/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.8/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.8/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.8/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.8/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.8/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.8/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.8/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.8/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.8/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.8/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.8/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.8/.pi/extensions/package.json +9 -0
- package/.versions/0.0.8/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.8/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.8/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.8/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.8/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.8/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.8/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/README.md +857 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/footer.ts +29 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/helpers.ts +248 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/index.ts +8609 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/run-budget.js +181 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
- package/.versions/0.0.8/.pi/harnesses/agent-hub/version.ts +18 -0
- package/.versions/0.0.8/.pi/harnesses/ask-user-remote/README.md +19 -0
- package/.versions/0.0.8/.pi/harnesses/ask-user-remote/index.ts +321 -0
- package/.versions/0.0.8/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.8/.pi/harnesses/coms/README.md +93 -0
- package/.versions/0.0.8/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/0.0.8/.pi/harnesses/coms/package.json +7 -0
- package/.versions/0.0.8/.pi/harnesses/coms/version.ts +18 -0
- package/.versions/0.0.8/.pi/harnesses/damage-control-continue/README.md +117 -0
- package/.versions/0.0.8/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/0.0.8/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/0.0.8/.pi/harnesses/damage-control-continue/version.ts +18 -0
- package/.versions/0.0.8/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/0.0.8/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/0.0.8/.pi/harnesses/lib/herdr-client.ts +463 -0
- package/.versions/0.0.8/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/0.0.8/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.8/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.8/.pi/prompts/af-build.md +24 -0
- package/.versions/0.0.8/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/0.0.8/.pi/prompts/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.8/.pi/prompts/af-plan.md +16 -0
- package/.versions/0.0.8/.pi/prompts/af-review.md +16 -0
- package/.versions/0.0.8/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/0.0.8/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/0.0.8/.pi/prompts/af-setup-agent-fleet.md +27 -0
- package/.versions/0.0.8/.pi/prompts/af-ship.md +17 -0
- package/.versions/0.0.8/.pi/prompts/af-spec.md +15 -0
- package/.versions/0.0.8/.pi/prompts/af-test.md +19 -0
- package/.versions/0.0.8/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.8/.version +1 -0
- package/.versions/0.0.8/agents/architect.md +23 -0
- package/.versions/0.0.8/agents/bowser.md +26 -0
- package/.versions/0.0.8/agents/builder.md +53 -0
- package/.versions/0.0.8/agents/code-reviewer.md +205 -0
- package/.versions/0.0.8/agents/deep-researcher.md +31 -0
- package/.versions/0.0.8/agents/documenter.md +18 -0
- package/.versions/0.0.8/agents/orchestrator.md +65 -0
- package/.versions/0.0.8/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.8/agents/planner.md +69 -0
- package/.versions/0.0.8/agents/releaser.md +24 -0
- package/.versions/0.0.8/agents/researcher.md +28 -0
- package/.versions/0.0.8/agents/security-auditor.md +166 -0
- package/.versions/0.0.8/agents/test-engineer.md +151 -0
- package/.versions/0.0.8/agents/web-debugger.md +42 -0
- package/.versions/0.0.8/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.8/codex/CONDUCTOR.md +148 -0
- package/.versions/0.0.8/docs/ARCHITECTURE.md +262 -0
- package/.versions/0.0.8/docs/agent-fleet-setup.md +366 -0
- package/.versions/0.0.8/docs/claude-code-coms-bridge.md +109 -0
- package/.versions/0.0.8/docs/codex-remote-conductor.md +170 -0
- package/.versions/0.0.8/docs/coms-hermes-bridge.md +189 -0
- package/.versions/0.0.8/docs/getting-started.md +231 -0
- package/.versions/0.0.8/docs/npm-install.md +337 -0
- package/.versions/0.0.8/docs/opencode-setup.md +249 -0
- package/.versions/0.0.8/docs/pi-extensions.md +293 -0
- package/.versions/0.0.8/docs/pi-setup.md +476 -0
- package/.versions/0.0.8/docs/skill-anatomy.md +150 -0
- package/.versions/0.0.8/hermes/README.md +347 -0
- package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/0.0.8/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/0.0.8/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/0.0.8/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/0.0.8/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/0.0.8/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/0.0.8/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.8/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/0.0.8/hooks/hooks.json +14 -0
- package/.versions/0.0.8/hooks/session-start.sh +74 -0
- package/.versions/0.0.8/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.8/justfile +245 -0
- package/.versions/0.0.8/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.8/references/definition-of-done.md +67 -0
- package/.versions/0.0.8/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.8/references/observability-checklist.md +91 -0
- package/.versions/0.0.8/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.8/references/performance-checklist.md +153 -0
- package/.versions/0.0.8/references/prompting-patterns.md +380 -0
- package/.versions/0.0.8/references/security-checklist.md +179 -0
- package/.versions/0.0.8/references/testing-patterns.md +236 -0
- package/.versions/0.0.8/scripts/codex-conductor.ts +41 -0
- package/.versions/0.0.8/scripts/codex-remote-control.ts +167 -0
- package/.versions/0.0.8/scripts/coms-claude-bridge.ts +401 -0
- package/.versions/0.0.8/scripts/coms-cli.ts +484 -0
- package/.versions/0.0.8/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/0.0.8/scripts/fleet.ts +149 -0
- package/.versions/0.0.8/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/0.0.8/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/0.0.8/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/0.0.8/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/0.0.8/scripts/lib/claude-bridge-core.ts +165 -0
- package/.versions/0.0.8/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/0.0.8/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/0.0.8/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/0.0.8/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/0.0.8/scripts/lib/fleet-command.ts +109 -0
- package/.versions/0.0.8/scripts/lib/herdr-layout.ts +263 -0
- package/.versions/0.0.8/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/0.0.8/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/0.0.8/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/0.0.8/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/0.0.8/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/0.0.8/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/0.0.8/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/0.0.8/scripts/lib/monitor-env.ts +120 -0
- package/.versions/0.0.8/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.8/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/0.0.8/scripts/lib/team-project.ts +191 -0
- package/.versions/0.0.8/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/0.0.8/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.8/scripts/team-snapshot.ts +237 -0
- package/.versions/0.0.8/scripts/team-up.ts +360 -0
- package/.versions/0.0.8/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.8/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.8/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.8/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.8/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.8/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.8/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.8/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/0.0.8/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.8/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.8/skills/guided-workspace-setup/SKILL.md +544 -0
- package/.versions/0.0.8/skills/guided-workspace-setup/companion-manifest.json +36 -0
- package/.versions/0.0.8/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.8/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.8/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.8/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.8/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.8/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.8/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.8/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.8/skills/peer-coms/SKILL.md +90 -0
- package/.versions/0.0.8/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.8/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.8/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.8/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.8/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.8/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.8/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +140 -0
- package/README.md +175 -18
- package/agents/code-reviewer.md +2 -2
- package/agents/orchestrator.md +11 -0
- package/agents/plan-reviewer.md +1 -1
- package/agents/planner.md +1 -1
- package/agents/security-auditor.md +1 -1
- package/bin/cli.js +40 -1
- package/bin/lib/hermes-profile-artifact.js +144 -0
- package/bin/lib/set-hermes-watchdog.js +173 -0
- package/bin/set-hermes-watchdog.js +26 -0
- package/docs/ARCHITECTURE.md +64 -12
- package/docs/agent-fleet-setup.md +2 -2
- package/docs/claude-code-coms-bridge.md +7 -1
- package/docs/coms-hermes-bridge.md +10 -0
- package/docs/getting-started.md +48 -0
- package/docs/hermes-watchdog-supervisor.md +140 -0
- package/hermes/README.md +135 -19
- package/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +10 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/hooks/coms-stop-hook.mjs +12 -1
- package/package.json +11 -2
- package/scripts/coms-claude-bridge.ts +154 -39
- package/scripts/fleet.ts +9 -1
- package/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/scripts/lib/claude-bridge-core.ts +65 -0
- package/scripts/lib/coms-envelope.ts +44 -1
- package/scripts/lib/hermes-monitor-events.ts +1 -0
- package/scripts/lib/monitor-env.ts +120 -0
- package/scripts/team-snapshot.ts +1 -1
- package/scripts/team-up.ts +10 -1
- package/skills/guided-workspace-setup/companion-manifest.json +1 -0
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
- package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
- package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
- package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
|
@@ -0,0 +1,390 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ci-cd-and-automation
|
|
3
|
+
description: Automates CI/CD pipeline setup. Use when setting up or modifying build and deployment pipelines. Use when you need to automate quality gates, configure test runners in CI, or establish deployment strategies.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# CI/CD and Automation
|
|
7
|
+
|
|
8
|
+
## Overview
|
|
9
|
+
|
|
10
|
+
Automate quality gates so that no change reaches production without passing tests, lint, type checking, and build. CI/CD is the enforcement mechanism for every other skill — it catches what humans and agents miss, and it does so consistently on every single change.
|
|
11
|
+
|
|
12
|
+
**Shift Left:** Catch problems as early in the pipeline as possible. A bug caught in linting costs minutes; the same bug caught in production costs hours. Move checks upstream — static analysis before tests, tests before staging, staging before production.
|
|
13
|
+
|
|
14
|
+
**Faster is Safer:** Smaller batches and more frequent releases reduce risk, not increase it. A deployment with 3 changes is easier to debug than one with 30. Frequent releases build confidence in the release process itself.
|
|
15
|
+
|
|
16
|
+
## When to Use
|
|
17
|
+
|
|
18
|
+
- Setting up a new project's CI pipeline
|
|
19
|
+
- Adding or modifying automated checks
|
|
20
|
+
- Configuring deployment pipelines
|
|
21
|
+
- When a change should trigger automated verification
|
|
22
|
+
- Debugging CI failures
|
|
23
|
+
|
|
24
|
+
## The Quality Gate Pipeline
|
|
25
|
+
|
|
26
|
+
Every change goes through these gates before merge:
|
|
27
|
+
|
|
28
|
+
```
|
|
29
|
+
Pull Request Opened
|
|
30
|
+
│
|
|
31
|
+
▼
|
|
32
|
+
┌─────────────────┐
|
|
33
|
+
│ LINT CHECK │ eslint, prettier
|
|
34
|
+
│ ↓ pass │
|
|
35
|
+
│ TYPE CHECK │ tsc --noEmit
|
|
36
|
+
│ ↓ pass │
|
|
37
|
+
│ UNIT TESTS │ jest/vitest
|
|
38
|
+
│ ↓ pass │
|
|
39
|
+
│ BUILD │ npm run build
|
|
40
|
+
│ ↓ pass │
|
|
41
|
+
│ INTEGRATION │ API/DB tests
|
|
42
|
+
│ ↓ pass │
|
|
43
|
+
│ E2E (optional) │ Playwright/Cypress
|
|
44
|
+
│ ↓ pass │
|
|
45
|
+
│ SECURITY AUDIT │ npm audit
|
|
46
|
+
│ ↓ pass │
|
|
47
|
+
│ BUNDLE SIZE │ bundlesize check
|
|
48
|
+
└─────────────────┘
|
|
49
|
+
│
|
|
50
|
+
▼
|
|
51
|
+
Ready for review
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
**No gate can be skipped.** If lint fails, fix lint — don't disable the rule. If a test fails, fix the code — don't skip the test.
|
|
55
|
+
|
|
56
|
+
## GitHub Actions Configuration
|
|
57
|
+
|
|
58
|
+
### Basic CI Pipeline
|
|
59
|
+
|
|
60
|
+
```yaml
|
|
61
|
+
# .github/workflows/ci.yml
|
|
62
|
+
name: CI
|
|
63
|
+
|
|
64
|
+
on:
|
|
65
|
+
pull_request:
|
|
66
|
+
branches: [main]
|
|
67
|
+
push:
|
|
68
|
+
branches: [main]
|
|
69
|
+
|
|
70
|
+
jobs:
|
|
71
|
+
quality:
|
|
72
|
+
runs-on: ubuntu-latest
|
|
73
|
+
steps:
|
|
74
|
+
- uses: actions/checkout@v4
|
|
75
|
+
|
|
76
|
+
- uses: actions/setup-node@v4
|
|
77
|
+
with:
|
|
78
|
+
node-version: '22'
|
|
79
|
+
cache: 'npm'
|
|
80
|
+
|
|
81
|
+
- name: Install dependencies
|
|
82
|
+
run: npm ci
|
|
83
|
+
|
|
84
|
+
- name: Lint
|
|
85
|
+
run: npm run lint
|
|
86
|
+
|
|
87
|
+
- name: Type check
|
|
88
|
+
run: npx tsc --noEmit
|
|
89
|
+
|
|
90
|
+
- name: Test
|
|
91
|
+
run: npm test -- --coverage
|
|
92
|
+
|
|
93
|
+
- name: Build
|
|
94
|
+
run: npm run build
|
|
95
|
+
|
|
96
|
+
- name: Security audit
|
|
97
|
+
run: npm audit --audit-level=high
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
### With Database Integration Tests
|
|
101
|
+
|
|
102
|
+
```yaml
|
|
103
|
+
integration:
|
|
104
|
+
runs-on: ubuntu-latest
|
|
105
|
+
services:
|
|
106
|
+
postgres:
|
|
107
|
+
image: postgres:16
|
|
108
|
+
env:
|
|
109
|
+
POSTGRES_DB: testdb
|
|
110
|
+
POSTGRES_USER: ci_user
|
|
111
|
+
POSTGRES_PASSWORD: ${{ secrets.CI_DB_PASSWORD }}
|
|
112
|
+
ports:
|
|
113
|
+
- 5432:5432
|
|
114
|
+
options: >-
|
|
115
|
+
--health-cmd pg_isready
|
|
116
|
+
--health-interval 10s
|
|
117
|
+
--health-timeout 5s
|
|
118
|
+
--health-retries 5
|
|
119
|
+
|
|
120
|
+
steps:
|
|
121
|
+
- uses: actions/checkout@v4
|
|
122
|
+
- uses: actions/setup-node@v4
|
|
123
|
+
with:
|
|
124
|
+
node-version: '22'
|
|
125
|
+
cache: 'npm'
|
|
126
|
+
- run: npm ci
|
|
127
|
+
- name: Run migrations
|
|
128
|
+
run: npx prisma migrate deploy
|
|
129
|
+
env:
|
|
130
|
+
DATABASE_URL: postgresql://ci_user:${{ secrets.CI_DB_PASSWORD }}@localhost:5432/testdb
|
|
131
|
+
- name: Integration tests
|
|
132
|
+
run: npm run test:integration
|
|
133
|
+
env:
|
|
134
|
+
DATABASE_URL: postgresql://ci_user:${{ secrets.CI_DB_PASSWORD }}@localhost:5432/testdb
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
> **Note:** Even for CI-only test databases, use GitHub Secrets for credentials rather than hardcoding values. This builds good habits and prevents accidental reuse of test credentials in other contexts.
|
|
138
|
+
|
|
139
|
+
### E2E Tests
|
|
140
|
+
|
|
141
|
+
```yaml
|
|
142
|
+
e2e:
|
|
143
|
+
runs-on: ubuntu-latest
|
|
144
|
+
steps:
|
|
145
|
+
- uses: actions/checkout@v4
|
|
146
|
+
- uses: actions/setup-node@v4
|
|
147
|
+
with:
|
|
148
|
+
node-version: '22'
|
|
149
|
+
cache: 'npm'
|
|
150
|
+
- run: npm ci
|
|
151
|
+
- name: Install Playwright
|
|
152
|
+
run: npx playwright install --with-deps chromium
|
|
153
|
+
- name: Build
|
|
154
|
+
run: npm run build
|
|
155
|
+
- name: Run E2E tests
|
|
156
|
+
run: npx playwright test
|
|
157
|
+
- uses: actions/upload-artifact@v4
|
|
158
|
+
if: failure()
|
|
159
|
+
with:
|
|
160
|
+
name: playwright-report
|
|
161
|
+
path: playwright-report/
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
## Feeding CI Failures Back to Agents
|
|
165
|
+
|
|
166
|
+
The power of CI with AI agents is the feedback loop. When CI fails:
|
|
167
|
+
|
|
168
|
+
```
|
|
169
|
+
CI fails
|
|
170
|
+
│
|
|
171
|
+
▼
|
|
172
|
+
Copy the failure output
|
|
173
|
+
│
|
|
174
|
+
▼
|
|
175
|
+
Feed it to the agent:
|
|
176
|
+
"The CI pipeline failed with this error:
|
|
177
|
+
[paste specific error]
|
|
178
|
+
Fix the issue and verify locally before pushing again."
|
|
179
|
+
│
|
|
180
|
+
▼
|
|
181
|
+
Agent fixes → pushes → CI runs again
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
**Key patterns:**
|
|
185
|
+
|
|
186
|
+
```
|
|
187
|
+
Lint failure → Agent runs `npm run lint --fix` and commits
|
|
188
|
+
Type error → Agent reads the error location and fixes the type
|
|
189
|
+
Test failure → Agent follows debugging-and-error-recovery skill
|
|
190
|
+
Build error → Agent checks config and dependencies
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
## Deployment Strategies
|
|
194
|
+
|
|
195
|
+
### Preview Deployments
|
|
196
|
+
|
|
197
|
+
Every PR gets a preview deployment for manual testing:
|
|
198
|
+
|
|
199
|
+
```yaml
|
|
200
|
+
# Deploy preview on PR (Vercel/Netlify/etc.)
|
|
201
|
+
deploy-preview:
|
|
202
|
+
runs-on: ubuntu-latest
|
|
203
|
+
if: github.event_name == 'pull_request'
|
|
204
|
+
steps:
|
|
205
|
+
- uses: actions/checkout@v4
|
|
206
|
+
- name: Deploy preview
|
|
207
|
+
run: npx vercel --token=${{ secrets.VERCEL_TOKEN }}
|
|
208
|
+
```
|
|
209
|
+
|
|
210
|
+
### Feature Flags
|
|
211
|
+
|
|
212
|
+
Feature flags decouple deployment from release. Deploy incomplete or risky features behind flags so you can:
|
|
213
|
+
|
|
214
|
+
- **Ship code without enabling it.** Merge to main early, enable when ready.
|
|
215
|
+
- **Roll back without redeploying.** Disable the flag instead of reverting code.
|
|
216
|
+
- **Canary new features.** Enable for 1% of users, then 10%, then 100%.
|
|
217
|
+
- **Run A/B tests.** Compare behavior with and without the feature.
|
|
218
|
+
|
|
219
|
+
```typescript
|
|
220
|
+
// Simple feature flag pattern
|
|
221
|
+
if (featureFlags.isEnabled('new-checkout-flow', { userId })) {
|
|
222
|
+
return renderNewCheckout();
|
|
223
|
+
}
|
|
224
|
+
return renderLegacyCheckout();
|
|
225
|
+
```
|
|
226
|
+
|
|
227
|
+
**Flag lifecycle:** Create → Enable for testing → Canary → Full rollout → Remove the flag and dead code. Flags that live forever become technical debt — set a cleanup date when you create them.
|
|
228
|
+
|
|
229
|
+
### Staged Rollouts
|
|
230
|
+
|
|
231
|
+
```
|
|
232
|
+
PR merged to main
|
|
233
|
+
│
|
|
234
|
+
▼
|
|
235
|
+
Staging deployment (auto)
|
|
236
|
+
│ Manual verification
|
|
237
|
+
▼
|
|
238
|
+
Production deployment (manual trigger or auto after staging)
|
|
239
|
+
│
|
|
240
|
+
▼
|
|
241
|
+
Monitor for errors (15-minute window)
|
|
242
|
+
│
|
|
243
|
+
├── Errors detected → Rollback
|
|
244
|
+
└── Clean → Done
|
|
245
|
+
```
|
|
246
|
+
|
|
247
|
+
### Rollback Plan
|
|
248
|
+
|
|
249
|
+
Every deployment should be reversible:
|
|
250
|
+
|
|
251
|
+
```yaml
|
|
252
|
+
# Manual rollback workflow
|
|
253
|
+
name: Rollback
|
|
254
|
+
on:
|
|
255
|
+
workflow_dispatch:
|
|
256
|
+
inputs:
|
|
257
|
+
version:
|
|
258
|
+
description: 'Version to rollback to'
|
|
259
|
+
required: true
|
|
260
|
+
|
|
261
|
+
jobs:
|
|
262
|
+
rollback:
|
|
263
|
+
runs-on: ubuntu-latest
|
|
264
|
+
steps:
|
|
265
|
+
- name: Rollback deployment
|
|
266
|
+
run: |
|
|
267
|
+
# Deploy the specified previous version
|
|
268
|
+
npx vercel rollback ${{ inputs.version }}
|
|
269
|
+
```
|
|
270
|
+
|
|
271
|
+
## Environment Management
|
|
272
|
+
|
|
273
|
+
```
|
|
274
|
+
.env.example → Committed (template for developers)
|
|
275
|
+
.env → NOT committed (local development)
|
|
276
|
+
.env.test → Committed (test environment, no real secrets)
|
|
277
|
+
CI secrets → Stored in GitHub Secrets / vault
|
|
278
|
+
Production secrets → Stored in deployment platform / vault
|
|
279
|
+
```
|
|
280
|
+
|
|
281
|
+
CI should never have production secrets. Use separate secrets for CI testing.
|
|
282
|
+
|
|
283
|
+
## Automation Beyond CI
|
|
284
|
+
|
|
285
|
+
### Dependabot / Renovate
|
|
286
|
+
|
|
287
|
+
```yaml
|
|
288
|
+
# .github/dependabot.yml
|
|
289
|
+
version: 2
|
|
290
|
+
updates:
|
|
291
|
+
- package-ecosystem: npm
|
|
292
|
+
directory: /
|
|
293
|
+
schedule:
|
|
294
|
+
interval: weekly
|
|
295
|
+
open-pull-requests-limit: 5
|
|
296
|
+
```
|
|
297
|
+
|
|
298
|
+
### Build Cop Role
|
|
299
|
+
|
|
300
|
+
Designate someone responsible for keeping CI green. When the build breaks, the Build Cop's job is to fix or revert — not the person whose change caused the break. This prevents broken builds from accumulating while everyone assumes someone else will fix it.
|
|
301
|
+
|
|
302
|
+
### PR Checks
|
|
303
|
+
|
|
304
|
+
- **Required reviews:** At least 1 approval before merge
|
|
305
|
+
- **Required status checks:** CI must pass before merge
|
|
306
|
+
- **Branch protection:** No force-pushes to main
|
|
307
|
+
- **Auto-merge:** If all checks pass and approved, merge automatically
|
|
308
|
+
|
|
309
|
+
## CI Optimization
|
|
310
|
+
|
|
311
|
+
When the pipeline exceeds 10 minutes, apply these strategies in order of impact:
|
|
312
|
+
|
|
313
|
+
```
|
|
314
|
+
Slow CI pipeline?
|
|
315
|
+
├── Cache dependencies
|
|
316
|
+
│ └── Use actions/cache or setup-node cache option for node_modules
|
|
317
|
+
├── Run jobs in parallel
|
|
318
|
+
│ └── Split lint, typecheck, test, build into separate parallel jobs
|
|
319
|
+
├── Only run what changed
|
|
320
|
+
│ └── Use path filters to skip unrelated jobs (e.g., skip e2e for docs-only PRs)
|
|
321
|
+
├── Use matrix builds
|
|
322
|
+
│ └── Shard test suites across multiple runners
|
|
323
|
+
├── Optimize the test suite
|
|
324
|
+
│ └── Remove slow tests from the critical path, run them on a schedule instead
|
|
325
|
+
└── Use larger runners
|
|
326
|
+
└── GitHub-hosted larger runners or self-hosted for CPU-heavy builds
|
|
327
|
+
```
|
|
328
|
+
|
|
329
|
+
**Example: caching and parallelism**
|
|
330
|
+
```yaml
|
|
331
|
+
jobs:
|
|
332
|
+
lint:
|
|
333
|
+
runs-on: ubuntu-latest
|
|
334
|
+
steps:
|
|
335
|
+
- uses: actions/checkout@v4
|
|
336
|
+
- uses: actions/setup-node@v4
|
|
337
|
+
with: { node-version: '22', cache: 'npm' }
|
|
338
|
+
- run: npm ci
|
|
339
|
+
- run: npm run lint
|
|
340
|
+
|
|
341
|
+
typecheck:
|
|
342
|
+
runs-on: ubuntu-latest
|
|
343
|
+
steps:
|
|
344
|
+
- uses: actions/checkout@v4
|
|
345
|
+
- uses: actions/setup-node@v4
|
|
346
|
+
with: { node-version: '22', cache: 'npm' }
|
|
347
|
+
- run: npm ci
|
|
348
|
+
- run: npx tsc --noEmit
|
|
349
|
+
|
|
350
|
+
test:
|
|
351
|
+
runs-on: ubuntu-latest
|
|
352
|
+
steps:
|
|
353
|
+
- uses: actions/checkout@v4
|
|
354
|
+
- uses: actions/setup-node@v4
|
|
355
|
+
with: { node-version: '22', cache: 'npm' }
|
|
356
|
+
- run: npm ci
|
|
357
|
+
- run: npm test -- --coverage
|
|
358
|
+
```
|
|
359
|
+
|
|
360
|
+
## Common Rationalizations
|
|
361
|
+
|
|
362
|
+
| Rationalization | Reality |
|
|
363
|
+
|---|---|
|
|
364
|
+
| "CI is too slow" | Optimize the pipeline (see CI Optimization below), don't skip it. A 5-minute pipeline prevents hours of debugging. |
|
|
365
|
+
| "This change is trivial, skip CI" | Trivial changes break builds. CI is fast for trivial changes anyway. |
|
|
366
|
+
| "The test is flaky, just re-run" | Flaky tests mask real bugs and waste everyone's time. Fix the flakiness. |
|
|
367
|
+
| "We'll add CI later" | Projects without CI accumulate broken states. Set it up on day one. |
|
|
368
|
+
| "Manual testing is enough" | Manual testing doesn't scale and isn't repeatable. Automate what you can. |
|
|
369
|
+
|
|
370
|
+
## Red Flags
|
|
371
|
+
|
|
372
|
+
- No CI pipeline in the project
|
|
373
|
+
- CI failures ignored or silenced
|
|
374
|
+
- Tests disabled in CI to make the pipeline pass
|
|
375
|
+
- Production deploys without staging verification
|
|
376
|
+
- No rollback mechanism
|
|
377
|
+
- Secrets stored in code or CI config files (not secrets manager)
|
|
378
|
+
- Long CI times with no optimization effort
|
|
379
|
+
|
|
380
|
+
## Verification
|
|
381
|
+
|
|
382
|
+
After setting up or modifying CI:
|
|
383
|
+
|
|
384
|
+
- [ ] All quality gates are present (lint, types, tests, build, audit)
|
|
385
|
+
- [ ] Pipeline runs on every PR and push to main
|
|
386
|
+
- [ ] Failures block merge (branch protection configured)
|
|
387
|
+
- [ ] CI results feed back into the development loop
|
|
388
|
+
- [ ] Secrets are stored in the secrets manager, not in code
|
|
389
|
+
- [ ] Deployment has a rollback mechanism
|
|
390
|
+
- [ ] Pipeline runs in under 10 minutes for the test suite
|