@chankov/agent-fleet 2.0.6 → 2.0.7

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.
Files changed (450) hide show
  1. package/.pi/harnesses/agent-hub/package.json +1 -1
  2. package/.pi/harnesses/coms/package.json +1 -1
  3. package/.pi/harnesses/damage-control-continue/README.md +11 -0
  4. package/.pi/harnesses/damage-control-continue/index.ts +5 -0
  5. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  6. package/.pi/harnesses/lib/update-check.ts +222 -0
  7. package/.versions/2.0.7/.pi/agents/dispatch-policy.yaml +32 -0
  8. package/.versions/2.0.7/.pi/agents/model-profiles.yaml +83 -0
  9. package/.versions/2.0.7/.pi/agents/peers.yaml +145 -0
  10. package/.versions/2.0.7/.pi/agents/teams.yaml +41 -0
  11. package/.versions/2.0.7/.pi/agents/voices.yaml +13 -0
  12. package/.versions/2.0.7/.pi/damage-control-rules.yaml +297 -0
  13. package/.versions/2.0.7/.pi/extensions/btw/README.md +120 -0
  14. package/.versions/2.0.7/.pi/extensions/btw/index.ts +914 -0
  15. package/{.pi/extensions/agent-fleet-update-check → .versions/2.0.7/.pi/extensions/btw}/package.json +1 -1
  16. package/.versions/2.0.7/.pi/extensions/btw/state.js +179 -0
  17. package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  18. package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  19. package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  20. package/.versions/2.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
  21. package/.versions/2.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
  22. package/.versions/2.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
  23. package/.versions/2.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
  24. package/.versions/2.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
  25. package/.versions/2.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
  26. package/.versions/2.0.7/.pi/extensions/package-lock.json +1175 -0
  27. package/.versions/2.0.7/.pi/extensions/package.json +9 -0
  28. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/README.md +205 -0
  29. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
  30. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  31. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
  32. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
  33. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  34. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  35. package/.versions/2.0.7/.pi/harnesses/agent-hub/README.md +1203 -0
  36. package/.versions/2.0.7/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  37. package/.versions/2.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  38. package/.versions/2.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
  39. package/.versions/2.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  40. package/.versions/2.0.7/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  41. package/.versions/2.0.7/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  42. package/.versions/2.0.7/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  43. package/.versions/2.0.7/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  44. package/.versions/2.0.7/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  45. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  46. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  47. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  48. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  49. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  50. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  51. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  52. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  53. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  54. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  55. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  56. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  57. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  58. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  59. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  60. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  61. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  62. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  63. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  64. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  65. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  66. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  67. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  68. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  69. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  70. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  71. package/.versions/2.0.7/.pi/harnesses/agent-hub/config/agents.ts +173 -0
  72. package/.versions/2.0.7/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  73. package/.versions/2.0.7/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  74. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  75. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  76. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  77. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  78. package/.versions/2.0.7/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  79. package/.versions/2.0.7/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  80. package/.versions/2.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
  81. package/.versions/2.0.7/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  82. package/.versions/2.0.7/.pi/harnesses/agent-hub/delegate.ts +446 -0
  83. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  84. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  85. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  86. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  87. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  88. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  89. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  90. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  91. package/.versions/2.0.7/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  92. package/.versions/2.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  93. package/.versions/2.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  94. package/.versions/2.0.7/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  95. package/.versions/2.0.7/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  96. package/.versions/2.0.7/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  97. package/.versions/2.0.7/.pi/harnesses/agent-hub/footer.ts +30 -0
  98. package/.versions/2.0.7/.pi/harnesses/agent-hub/helpers.ts +266 -0
  99. package/.versions/2.0.7/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  100. package/.versions/2.0.7/.pi/harnesses/agent-hub/index.ts +2151 -0
  101. package/.versions/2.0.7/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  102. package/.versions/2.0.7/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
  103. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  104. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  105. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  106. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  107. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  108. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  109. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  110. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  111. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  112. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  113. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  114. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  115. package/.versions/2.0.7/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  116. package/.versions/2.0.7/.pi/harnesses/agent-hub/package.json +7 -0
  117. package/.versions/2.0.7/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  118. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  119. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  120. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  121. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  122. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  123. package/.versions/2.0.7/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  124. package/.versions/2.0.7/.pi/harnesses/agent-hub/presentation.ts +48 -0
  125. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  126. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  127. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  128. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  129. package/.versions/2.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  130. package/.versions/2.0.7/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  131. package/.versions/2.0.7/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  132. package/.versions/2.0.7/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  133. package/.versions/2.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  134. package/.versions/2.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
  135. package/.versions/2.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
  136. package/.versions/2.0.7/.pi/harnesses/agent-hub/review-findings.js +102 -0
  137. package/.versions/2.0.7/.pi/harnesses/agent-hub/run-budget.js +537 -0
  138. package/.versions/2.0.7/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  139. package/.versions/2.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  140. package/.versions/2.0.7/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  141. package/.versions/2.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
  142. package/.versions/2.0.7/.pi/harnesses/agent-hub/session-start.ts +42 -0
  143. package/.versions/2.0.7/.pi/harnesses/agent-hub/spawn.ts +404 -0
  144. package/.versions/2.0.7/.pi/harnesses/agent-hub/timeline.ts +54 -0
  145. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  146. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  147. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  148. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  149. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
  150. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  151. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  152. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  153. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  154. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  155. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  156. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  157. package/.versions/2.0.7/.pi/harnesses/agent-hub/types.ts +63 -0
  158. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  159. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  160. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  161. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
  162. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
  163. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  164. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  165. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  166. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  167. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  168. package/.versions/2.0.7/.pi/harnesses/agent-hub/version.ts +42 -0
  169. package/.versions/2.0.7/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  170. package/.versions/2.0.7/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  171. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/README.md +59 -0
  172. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/index.ts +558 -0
  173. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  174. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  175. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  176. package/.versions/2.0.7/.pi/harnesses/coms/README.md +100 -0
  177. package/.versions/2.0.7/.pi/harnesses/coms/index.ts +282 -0
  178. package/.versions/2.0.7/.pi/harnesses/coms/package.json +7 -0
  179. package/.versions/2.0.7/.pi/harnesses/coms/version.ts +42 -0
  180. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/README.md +135 -0
  181. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/index.ts +541 -0
  182. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
  183. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/version.ts +42 -0
  184. package/.versions/2.0.7/.pi/harnesses/lib/coms-core-io.ts +385 -0
  185. package/.versions/2.0.7/.pi/harnesses/lib/coms-core.ts +577 -0
  186. package/.versions/2.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  187. package/.versions/2.0.7/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  188. package/.versions/2.0.7/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  189. package/.versions/2.0.7/.pi/harnesses/lib/context-budget-view.ts +107 -0
  190. package/.versions/2.0.7/.pi/harnesses/lib/context-budget.ts +114 -0
  191. package/.versions/2.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  192. package/.versions/2.0.7/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  193. package/.versions/2.0.7/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  194. package/.versions/2.0.7/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  195. package/.versions/2.0.7/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
  196. package/.versions/2.0.7/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
  197. package/.versions/2.0.7/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  198. package/.versions/2.0.7/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  199. package/.versions/2.0.7/.pi/harnesses/lib/fleet-panel.ts +34 -0
  200. package/.versions/2.0.7/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  201. package/.versions/2.0.7/.pi/harnesses/lib/fleet-selection.ts +24 -0
  202. package/.versions/2.0.7/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  203. package/.versions/2.0.7/.pi/harnesses/lib/herdr-client.ts +472 -0
  204. package/.versions/2.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
  205. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  206. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  207. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  208. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  209. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  210. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  211. package/.versions/2.0.7/.pi/harnesses/lib/spawned-peers.js +190 -0
  212. package/.versions/2.0.7/.pi/harnesses/lib/update-check.ts +222 -0
  213. package/.versions/2.0.7/.pi/harnesses/package-lock.json +2039 -0
  214. package/.versions/2.0.7/.pi/harnesses/package.json +10 -0
  215. package/.versions/2.0.7/.pi/prompts/af-build.md +24 -0
  216. package/.versions/2.0.7/.pi/prompts/af-code-simplify.md +22 -0
  217. package/.versions/2.0.7/.pi/prompts/af-plan.md +17 -0
  218. package/.versions/2.0.7/.pi/prompts/af-review.md +16 -0
  219. package/.versions/2.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
  220. package/.versions/2.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  221. package/.versions/2.0.7/.pi/prompts/af-ship.md +17 -0
  222. package/.versions/2.0.7/.pi/prompts/af-spec.md +15 -0
  223. package/.versions/2.0.7/.pi/prompts/af-test.md +19 -0
  224. package/.versions/2.0.7/.pi/skills/bowser/SKILL.md +145 -0
  225. package/.versions/2.0.7/.version +1 -0
  226. package/.versions/2.0.7/agents/architect.md +25 -0
  227. package/.versions/2.0.7/agents/bowser.md +28 -0
  228. package/.versions/2.0.7/agents/builder.md +56 -0
  229. package/.versions/2.0.7/agents/code-reviewer.md +210 -0
  230. package/.versions/2.0.7/agents/deep-researcher.md +33 -0
  231. package/.versions/2.0.7/agents/documenter.md +23 -0
  232. package/.versions/2.0.7/agents/orchestrator.md +23 -0
  233. package/.versions/2.0.7/agents/plan-reviewer.md +84 -0
  234. package/.versions/2.0.7/agents/planner.md +106 -0
  235. package/.versions/2.0.7/agents/releaser.md +25 -0
  236. package/.versions/2.0.7/agents/researcher.md +31 -0
  237. package/.versions/2.0.7/agents/security-auditor.md +168 -0
  238. package/.versions/2.0.7/agents/test-engineer.md +154 -0
  239. package/.versions/2.0.7/agents/web-debugger.md +44 -0
  240. package/.versions/2.0.7/agents/web-performance-auditor.md +194 -0
  241. package/.versions/2.0.7/bin/catalog/harness-runtime-closure.json +31 -0
  242. package/.versions/2.0.7/codex/fleet-session-client/SKILL.md +34 -0
  243. package/.versions/2.0.7/codex/fleet-session-client.zip +0 -0
  244. package/.versions/2.0.7/docs/ARCHITECTURE.md +407 -0
  245. package/.versions/2.0.7/docs/agent-fleet-setup.md +561 -0
  246. package/.versions/2.0.7/docs/claude-code-coms-bridge.md +133 -0
  247. package/.versions/2.0.7/docs/codex-session-bridge.md +219 -0
  248. package/.versions/2.0.7/docs/coms-hermes-bridge.md +188 -0
  249. package/.versions/2.0.7/docs/getting-started.md +126 -0
  250. package/.versions/2.0.7/docs/npm-install.md +327 -0
  251. package/.versions/2.0.7/docs/pi-extensions.md +446 -0
  252. package/.versions/2.0.7/docs/pi-setup.md +76 -0
  253. package/.versions/2.0.7/docs/skill-anatomy.md +150 -0
  254. package/.versions/2.0.7/hermes/README.md +347 -0
  255. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  256. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  257. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  258. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  259. package/.versions/2.0.7/hermes/gates/gate-o-capability.md +8 -0
  260. package/.versions/2.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
  261. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  262. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  263. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  264. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  265. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  266. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  267. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  268. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  269. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  270. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  271. package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  272. package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  273. package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  274. package/.versions/2.0.7/hermes/skills/hub-conductor/SKILL.md +84 -0
  275. package/.versions/2.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
  276. package/.versions/2.0.7/hermes/skills/hub-watchdog/SKILL.md +76 -0
  277. package/.versions/2.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
  278. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  279. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  280. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  281. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  282. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  283. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  284. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  285. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  286. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  287. package/.versions/2.0.7/hermes/watchdog-tests/__init__.py +0 -0
  288. package/.versions/2.0.7/hooks/coms-stop-hook.mjs +84 -0
  289. package/.versions/2.0.7/install-manifest.json +2886 -0
  290. package/.versions/2.0.7/justfile +247 -0
  291. package/.versions/2.0.7/manifest-meta.json +958 -0
  292. package/.versions/2.0.7/references/accessibility-checklist.md +160 -0
  293. package/.versions/2.0.7/references/communication-contract.md +26 -0
  294. package/.versions/2.0.7/references/definition-of-done.md +67 -0
  295. package/.versions/2.0.7/references/fleet-coordination-patterns.md +171 -0
  296. package/.versions/2.0.7/references/observability-checklist.md +91 -0
  297. package/.versions/2.0.7/references/orchestration-patterns.md +370 -0
  298. package/.versions/2.0.7/references/performance-checklist.md +153 -0
  299. package/.versions/2.0.7/references/prompting-patterns.md +380 -0
  300. package/.versions/2.0.7/references/security-checklist.md +179 -0
  301. package/.versions/2.0.7/references/testing-patterns.md +236 -0
  302. package/.versions/2.0.7/references/workflow-authoring.md +304 -0
  303. package/.versions/2.0.7/scripts/claude-code-preflight.ts +70 -0
  304. package/.versions/2.0.7/scripts/coms-claude-bridge.ts +411 -0
  305. package/.versions/2.0.7/scripts/coms-cli.ts +425 -0
  306. package/.versions/2.0.7/scripts/coms-hermes-bridge.ts +413 -0
  307. package/.versions/2.0.7/scripts/fleet-codex-client.ts +69 -0
  308. package/.versions/2.0.7/scripts/fleet-codex-read.py +146 -0
  309. package/.versions/2.0.7/scripts/fleet.ts +216 -0
  310. package/.versions/2.0.7/scripts/flow.ts +137 -0
  311. package/.versions/2.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
  312. package/.versions/2.0.7/scripts/hermes-monitor-scenario.ts +474 -0
  313. package/.versions/2.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
  314. package/.versions/2.0.7/scripts/install-hermes-plugin.sh +180 -0
  315. package/.versions/2.0.7/scripts/lib/claude-bridge-core.ts +210 -0
  316. package/.versions/2.0.7/scripts/lib/coms-envelope.ts +582 -0
  317. package/.versions/2.0.7/scripts/lib/fake-herdr-server.ts +88 -0
  318. package/.versions/2.0.7/scripts/lib/fleet-codex-catalog.ts +63 -0
  319. package/.versions/2.0.7/scripts/lib/fleet-codex-operations.ts +190 -0
  320. package/.versions/2.0.7/scripts/lib/fleet-codex-session.ts +166 -0
  321. package/.versions/2.0.7/scripts/lib/fleet-codex-transport.ts +124 -0
  322. package/.versions/2.0.7/scripts/lib/fleet-command.ts +252 -0
  323. package/.versions/2.0.7/scripts/lib/flow-command.ts +93 -0
  324. package/.versions/2.0.7/scripts/lib/flow-maintenance.ts +230 -0
  325. package/.versions/2.0.7/scripts/lib/herdr-layout.ts +281 -0
  326. package/.versions/2.0.7/scripts/lib/hermes-bridge-core.ts +241 -0
  327. package/.versions/2.0.7/scripts/lib/hermes-monitor-events.ts +1 -0
  328. package/.versions/2.0.7/scripts/lib/hermes-monitor-herdr.ts +2 -0
  329. package/.versions/2.0.7/scripts/lib/hermes-monitor-model.ts +3 -0
  330. package/.versions/2.0.7/scripts/lib/hermes-monitor-registry.ts +2 -0
  331. package/.versions/2.0.7/scripts/lib/hermes-monitor-socket.ts +2 -0
  332. package/.versions/2.0.7/scripts/lib/hermes-monitor-store.ts +2 -0
  333. package/.versions/2.0.7/scripts/lib/monitor-env.ts +146 -0
  334. package/.versions/2.0.7/scripts/lib/peer-launch.ts +318 -0
  335. package/.versions/2.0.7/scripts/lib/persona-banner.ts +62 -0
  336. package/.versions/2.0.7/scripts/lib/runtime-dependencies.js +124 -0
  337. package/.versions/2.0.7/scripts/lib/spawn-stagger.ts +101 -0
  338. package/.versions/2.0.7/scripts/lib/team-project.ts +178 -0
  339. package/.versions/2.0.7/scripts/lib/team-snapshot.ts +147 -0
  340. package/.versions/2.0.7/scripts/package-lock.json +35 -0
  341. package/.versions/2.0.7/scripts/package.json +9 -0
  342. package/.versions/2.0.7/scripts/peer-banner.ts +40 -0
  343. package/.versions/2.0.7/scripts/peer-launch.ts +285 -0
  344. package/.versions/2.0.7/scripts/team-snapshot.ts +237 -0
  345. package/.versions/2.0.7/scripts/team-up.ts +378 -0
  346. package/.versions/2.0.7/scripts/workflows/lib/agent-phase.ts +133 -0
  347. package/.versions/2.0.7/scripts/workflows/lib/changes.ts +61 -0
  348. package/.versions/2.0.7/scripts/workflows/lib/debate.ts +149 -0
  349. package/.versions/2.0.7/scripts/workflows/lib/env.ts +34 -0
  350. package/.versions/2.0.7/scripts/workflows/lib/envelopes.ts +169 -0
  351. package/.versions/2.0.7/scripts/workflows/lib/gates.ts +81 -0
  352. package/.versions/2.0.7/scripts/workflows/lib/git.ts +96 -0
  353. package/.versions/2.0.7/scripts/workflows/lib/merge.ts +95 -0
  354. package/.versions/2.0.7/scripts/workflows/lib/model-profile.ts +22 -0
  355. package/.versions/2.0.7/scripts/workflows/lib/model-visibility.ts +92 -0
  356. package/.versions/2.0.7/scripts/workflows/lib/permissions.ts +130 -0
  357. package/.versions/2.0.7/scripts/workflows/lib/personas.ts +57 -0
  358. package/.versions/2.0.7/scripts/workflows/lib/poll.ts +86 -0
  359. package/.versions/2.0.7/scripts/workflows/lib/quality.ts +64 -0
  360. package/.versions/2.0.7/scripts/workflows/lib/run.ts +108 -0
  361. package/.versions/2.0.7/scripts/workflows/lib/trace.ts +34 -0
  362. package/.versions/2.0.7/scripts/workflows/lib/voices.ts +128 -0
  363. package/.versions/2.0.7/scripts/workflows/lib/writer-lease.ts +112 -0
  364. package/.versions/2.0.7/scripts/workflows/tsconfig.json +22 -0
  365. package/.versions/2.0.7/scripts/workflows/wf-build-test.ts +61 -0
  366. package/.versions/2.0.7/scripts/workflows/wf-debate.ts +87 -0
  367. package/.versions/2.0.7/scripts/workflows/wf-document.ts +50 -0
  368. package/.versions/2.0.7/scripts/workflows/wf-poll.ts +95 -0
  369. package/.versions/2.0.7/scripts/workflows/wf-quality.ts +20 -0
  370. package/.versions/2.0.7/scripts/workflows/wf-scout.ts +38 -0
  371. package/.versions/2.0.7/skills/_internal/grilling.md +59 -0
  372. package/.versions/2.0.7/skills/browser-testing-with-devtools/SKILL.md +351 -0
  373. package/.versions/2.0.7/skills/code-review-and-quality/SKILL.md +381 -0
  374. package/.versions/2.0.7/skills/compound-learning/SKILL.md +137 -0
  375. package/.versions/2.0.7/skills/context-engineering/SKILL.md +291 -0
  376. package/.versions/2.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
  377. package/.versions/2.0.7/skills/designing-agents/SKILL.md +394 -0
  378. package/.versions/2.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
  379. package/.versions/2.0.7/skills/drafting-workflows/SKILL.md +143 -0
  380. package/.versions/2.0.7/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  381. package/.versions/2.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
  382. package/.versions/2.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
  383. package/.versions/2.0.7/skills/idea-refine/SKILL.md +182 -0
  384. package/.versions/2.0.7/skills/idea-refine/examples.md +238 -0
  385. package/.versions/2.0.7/skills/idea-refine/frameworks.md +99 -0
  386. package/.versions/2.0.7/skills/idea-refine/refinement-criteria.md +113 -0
  387. package/.versions/2.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
  388. package/.versions/2.0.7/skills/incremental-implementation/SKILL.md +298 -0
  389. package/.versions/2.0.7/skills/interview-me/SKILL.md +226 -0
  390. package/.versions/2.0.7/skills/orchestration-verification/SKILL.md +181 -0
  391. package/.versions/2.0.7/skills/peer-coms/SKILL.md +90 -0
  392. package/.versions/2.0.7/skills/performance-optimization/SKILL.md +350 -0
  393. package/.versions/2.0.7/skills/planning-and-task-breakdown/SKILL.md +265 -0
  394. package/.versions/2.0.7/skills/security-and-hardening/SKILL.md +461 -0
  395. package/.versions/2.0.7/skills/spec-driven-development/SKILL.md +256 -0
  396. package/.versions/2.0.7/skills/using-agent-skills/SKILL.md +197 -0
  397. package/.versions/2.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
  398. package/.versions/2.0.7/vendor/agent-skills-upstream/README.md +11 -0
  399. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  400. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  401. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  402. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  403. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  404. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  405. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  406. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  407. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  408. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  409. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  410. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  411. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  412. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  413. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  414. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  415. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  416. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  417. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  418. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  419. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  420. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  421. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  422. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  423. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  424. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  425. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  426. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  427. package/CHANGELOG.md +8 -0
  428. package/README.md +14 -7
  429. package/bin/cli.js +149 -78
  430. package/bin/lib/apply.js +53 -62
  431. package/bin/lib/features.js +2 -2
  432. package/bin/lib/public-plan.js +17 -0
  433. package/bin/lib/purge.js +9 -3
  434. package/bin/lib/reconcile.js +4 -10
  435. package/bin/lib/repair-desired.js +73 -0
  436. package/bin/lib/stt-wizard.js +25 -11
  437. package/bin/lib/transaction.js +118 -108
  438. package/bin/lib/tui.js +70 -65
  439. package/bin/lib/update-notifier.js +2 -2
  440. package/bin/lib/workspace-safety.js +72 -0
  441. package/docs/npm-install.md +41 -15
  442. package/docs/pi-extensions.md +3 -3
  443. package/docs/pi-setup.md +2 -2
  444. package/install-manifest.json +1 -39
  445. package/justfile +3 -3
  446. package/manifest-meta.json +2 -20
  447. package/package.json +2 -2
  448. package/scripts/fleet.ts +1 -1
  449. package/.pi/extensions/agent-fleet-update-check/README.md +0 -57
  450. package/.pi/extensions/agent-fleet-update-check/index.ts +0 -161
@@ -0,0 +1,160 @@
1
+ # Accessibility Checklist
2
+
3
+ Quick reference for WCAG 2.1 AA compliance. Use alongside the `frontend-ui-engineering` skill.
4
+
5
+ ## Table of Contents
6
+
7
+ - [Essential Checks](#essential-checks)
8
+ - [Common HTML Patterns](#common-html-patterns)
9
+ - [Testing Tools](#testing-tools)
10
+ - [Quick Reference: ARIA Live Regions](#quick-reference-aria-live-regions)
11
+ - [Common Anti-Patterns](#common-anti-patterns)
12
+
13
+ ## Essential Checks
14
+
15
+ ### Keyboard Navigation
16
+ - [ ] All interactive elements focusable via Tab key
17
+ - [ ] Focus order follows visual/logical order
18
+ - [ ] Focus is visible (outline/ring on focused elements)
19
+ - [ ] Custom widgets have keyboard support (Enter to activate, Escape to close)
20
+ - [ ] No keyboard traps (user can always Tab away from a component)
21
+ - [ ] Skip-to-content link at top of page - visible (at least) on keyboard focus
22
+ - [ ] Modals trap focus while open, return focus on close
23
+
24
+ ### Screen Readers
25
+ - [ ] All images have `alt` text (or `alt=""` for decorative images)
26
+ - [ ] All form inputs have associated labels (`<label>` or `aria-label`)
27
+ - [ ] Buttons and links have descriptive text (not "Click here")
28
+ - [ ] Icon-only buttons have `aria-label`
29
+ - [ ] Page has one `<h1>` and headings don't skip levels
30
+ - [ ] Dynamic content changes announced (`aria-live` regions)
31
+ - [ ] Tables have `<th>` headers with scope
32
+
33
+ ### Visual
34
+ - [ ] Text contrast ≥ 4.5:1 (normal text) or ≥ 3:1 (large text, 18px+)
35
+ - [ ] UI components contrast ≥ 3:1 against background
36
+ - [ ] Color is not the only way to convey information
37
+ - [ ] Text resizable to 200% without breaking layout
38
+ - [ ] No content that flashes more than 3 times per second
39
+
40
+ ### Forms
41
+ - [ ] Every input has a visible label
42
+ - [ ] Required fields indicated (not by color alone)
43
+ - [ ] Error messages specific and associated with the field
44
+ - [ ] Error state visible by more than color (icon, text, border)
45
+ - [ ] Form submission errors summarized and focusable
46
+ - [ ] Known fields use autocomplete (for example `type="email" autocomplete="email"`)
47
+
48
+ ### Content
49
+ - [ ] Language declared (`<html lang="en">`)
50
+ - [ ] Page has a descriptive `<title>`
51
+ - [ ] Links distinguish from surrounding text (not by color alone)
52
+ - [ ] Touch targets ≥ 44x44px on mobile
53
+ - [ ] Meaningful empty states (not blank screens)
54
+
55
+ ## Common HTML Patterns
56
+
57
+ ### Buttons vs. Links
58
+
59
+ ```html
60
+ <!-- Use <button> for actions -->
61
+ <button onClick={handleDelete}>Delete Task</button>
62
+
63
+ <!-- Use <a> for navigation -->
64
+ <a href="/tasks/123">View Task</a>
65
+
66
+ <!-- NEVER use div/span as buttons -->
67
+ <div onClick={handleDelete}>Delete</div> <!-- BAD -->
68
+ ```
69
+
70
+ ### Form Labels
71
+
72
+ ```html
73
+ <!-- Explicit label association -->
74
+ <label htmlFor="email">Email address</label>
75
+ <input id="email" type="email" required />
76
+
77
+ <!-- Implicit wrapping -->
78
+ <label>
79
+ Email address
80
+ <input type="email" required />
81
+ </label>
82
+
83
+ <!-- Hidden label (visible label preferred) -->
84
+ <input type="search" aria-label="Search tasks" />
85
+ ```
86
+
87
+ ### ARIA Roles
88
+
89
+ ```html
90
+ <!-- Navigation -->
91
+ <nav aria-label="Main navigation">...</nav>
92
+ <nav aria-label="Footer links">...</nav>
93
+
94
+ <!-- Status messages -->
95
+ <div role="status" aria-live="polite">Task saved</div>
96
+
97
+ <!-- Alert messages -->
98
+ <div role="alert">Error: Title is required</div>
99
+
100
+ <!-- Modal dialogs -->
101
+ <dialog aria-modal="true" aria-labelledby="dialog-title">
102
+ <h2 id="dialog-title">Confirm Delete</h2>
103
+ ...
104
+ </dialog>
105
+
106
+ <!-- Loading states -->
107
+ <div aria-busy="true" aria-label="Loading tasks">
108
+ <Spinner />
109
+ </div>
110
+ ```
111
+
112
+ ### Accessible Lists
113
+
114
+ ```html
115
+ <ul role="list" aria-label="Tasks">
116
+ <li>
117
+ <input type="checkbox" id="task-1" aria-label="Complete: Buy groceries" />
118
+ <label htmlFor="task-1">Buy groceries</label>
119
+ </li>
120
+ </ul>
121
+ ```
122
+
123
+ ## Testing Tools
124
+
125
+ ```bash
126
+ # Automated audit
127
+ npx axe-core # Programmatic accessibility testing
128
+ npx pa11y # CLI accessibility checker
129
+
130
+ # In browser
131
+ # Chrome DevTools → Lighthouse → Accessibility
132
+ # Chrome DevTools → Elements → Accessibility tree
133
+
134
+ # Screen reader testing
135
+ # macOS: VoiceOver (Cmd + F5)
136
+ # Windows: NVDA (free) or JAWS
137
+ # Linux: Orca
138
+ ```
139
+
140
+ ## Quick Reference: ARIA Live Regions
141
+
142
+ | Value | Behavior | Use For |
143
+ |-------|----------|---------|
144
+ | `aria-live="polite"` | Announced at next pause | Status updates, saved confirmations |
145
+ | `aria-live="assertive"` | Announced immediately | Errors, time-sensitive alerts |
146
+ | `role="status"` | Same as `polite` | Status messages |
147
+ | `role="alert"` | Same as `assertive` | Error messages |
148
+
149
+ ## Common Anti-Patterns
150
+
151
+ | Anti-Pattern | Problem | Fix |
152
+ |---|---|---|
153
+ | `div` as button | Not focusable, no keyboard support | Use `<button>` |
154
+ | Missing `alt` text | Images invisible to screen readers | Add descriptive `alt` |
155
+ | Color-only states | Invisible to color-blind users | Add icons, text, or patterns |
156
+ | Autoplaying media | Disorienting, can't be stopped | Add controls, don't autoplay |
157
+ | Custom dropdown with no ARIA | Unusable by keyboard/screen reader | Use native `<select>` or proper ARIA listbox |
158
+ | Removing focus outlines | Users can't see where they are | Style outlines, don't remove them |
159
+ | Empty links/buttons | "Link" announced with no description | Add text or `aria-label` |
160
+ | `tabindex > 0` | Breaks natural tab order | Use `tabindex="0"` or `-1` only |
@@ -0,0 +1,26 @@
1
+ # Communication contract
2
+
3
+ Optional add-on for poll, debate, and merge voices. Nothing in Agent Fleet loads this
4
+ file automatically. Enable it with one override line:
5
+
6
+ ```markdown
7
+ ## agent-hub
8
+ append-prompt: references/communication-contract.md
9
+ ```
10
+
11
+ `append-prompt:` is a comma-separated list of repo-relative files; listed files must
12
+ exist. The doctor checks the paths. Per-voice `append-prompt` in `.pi/agents/voices.yaml`
13
+ is also allowed.
14
+
15
+ ## How to speak
16
+
17
+ - State a single position in one sentence. Do not hedge with both-sides summaries.
18
+ - Argue with evidence. Each item in `case` is one claim plus the file, test, or invariant that supports it.
19
+ - Name what would change your mind. Empty `would_change_my_mind` is a failed contract, not humility.
20
+ - In debate, address other voices by name. `aligned_with` and `refutes` use voice names from the panel, never paraphrases.
21
+ - If evidence moved you, say so (`changed: true` and fill `evidence_that_moved_me`). Silent conversion is not allowed.
22
+ - Merge attributes every consensus, divergence, minority, and rejected item to a voice. Dropping a minority without a reason is a failed merge.
23
+ - Stay read-only unless the integrator is running with `--apply`. Voices never write.
24
+
25
+ This contract matches the `poll`, `debate`, and `merge` envelopes. Emitting extra fields
26
+ fails validation.
@@ -0,0 +1,67 @@
1
+ # Definition of Done
2
+
3
+ A standing, project-wide bar that every change must clear before it counts as done. Unlike acceptance criteria, which vary per task and answer "did we build the right thing?", the Definition of Done is the same every time and answers "is this finished to our standard?". Use it as the final gate in `planning-and-task-breakdown`, `incremental-implementation`, and `shipping-and-launch`.
4
+
5
+ ## Definition of Done vs. Acceptance Criteria
6
+
7
+ | | Acceptance Criteria | Definition of Done |
8
+ |---|---|---|
9
+ | Scope | Specific to one task or spec | Applies to every increment |
10
+ | Changes | Different for each item | Fixed and reused |
11
+ | Answers | "Did we build *this thing*?" | "Is it *ready*?" |
12
+ | Owner | Defined when planning the task | Defined once for the project |
13
+ | Example | "User can reset password via email link" | "Tests pass, no regressions, docs updated" |
14
+
15
+ The two are complementary. A task is done only when **its** acceptance criteria are met **and** the standing Definition of Done is satisfied. Skipping either leaves work that looks finished but is not.
16
+
17
+ ## The Standing Checklist
18
+
19
+ Apply this to every change before declaring it done.
20
+
21
+ ### Correctness
22
+ - [ ] All acceptance criteria for the task are met
23
+ - [ ] Code runs and behaves as intended, verified at runtime, not just compiled or typechecked
24
+ - [ ] New behavior is covered by tests that fail without the change and pass with it
25
+ - [ ] Existing tests still pass; no regressions introduced
26
+ - [ ] Edge cases and error paths are handled, not just the happy path
27
+
28
+ ### Quality
29
+ - [ ] Code reveals intent through naming and structure; no comments needed to explain *what* it does
30
+ - [ ] No duplicated business logic
31
+ - [ ] No dead code, debug output, or commented-out blocks left behind
32
+ - [ ] Changes are scoped to the task; no unrelated refactors snuck in
33
+ - [ ] Linting and formatting pass
34
+
35
+ The depth behind these items lives in `code-review-and-quality` (the five-axis review) and `code-simplification` (reducing complexity without changing behavior).
36
+
37
+ ### Integration
38
+ - [ ] Change works with the rest of the system, not just in isolation
39
+ - [ ] Database migrations, config changes, and feature flags are accounted for
40
+ - [ ] Backward compatibility considered for any public interface or API change
41
+
42
+ ### Documentation
43
+ - [ ] Public interfaces, APIs, and user-facing behavior are documented
44
+ - [ ] Architectural decisions worth preserving are recorded (see `documentation-and-adrs`)
45
+ - [ ] Documentation describes the current state in timeless language, not the change history
46
+
47
+ ### Ship-readiness
48
+ - [ ] Security implications reviewed for any untrusted input, auth, or data handling (see `security-and-hardening`)
49
+ - [ ] Observability in place for new critical paths (logs, metrics, traces) (see `observability-and-instrumentation`)
50
+ - [ ] Rollback path exists for anything risky (see `shipping-and-launch`)
51
+ - [ ] The human has reviewed and approved before merge or deploy
52
+
53
+ ## How to Apply
54
+
55
+ - **Per task**: confirm the Correctness and Quality sections before checking the task off.
56
+ - **Per feature**: confirm Integration and Documentation before considering the feature complete.
57
+ - **Per release**: the full checklist is the floor; `shipping-and-launch` adds the deploy-specific gates on top.
58
+
59
+ Tailor the list to the project once, then reuse it unchanged. A Definition of Done that is renegotiated every sprint is not a Definition of Done.
60
+
61
+ ## Red Flags
62
+
63
+ - "It's done, I just haven't run it yet": unverified work is not done.
64
+ - "Tests pass" used as a synonym for done while docs, regressions, or runtime verification are skipped.
65
+ - A different bar applied depending on deadline pressure.
66
+ - Acceptance criteria treated as the whole bar, with no standing quality floor.
67
+ - "Done" declared before human review on changes that need it.
@@ -0,0 +1,171 @@
1
+ # Fleet Coordination Patterns
2
+
3
+ Runtime coordination protocols for a *fleet* of long-lived agents — peers in herdr panes,
4
+ coms peers, bridged non-pi agents — talking to each other while work is in flight. This is
5
+ the **runtime layer**: message-level protocols between already-running agents.
6
+ [orchestration-patterns.md](orchestration-patterns.md) covers the **composition layer**
7
+ (which personas to invoke and how to wire them: direct invocation, slash-command fan-out,
8
+ Claude Code Agent Teams) — read that one when deciding *who runs*; read this one when
9
+ deciding *how running agents coordinate*.
10
+
11
+ Adapted from the coordination protocols in disler's cmux experiments
12
+ (`PATTERNS-read-and-notify.md`), generalized away from cmux and grounded in this repo's
13
+ mechanisms: coms envelopes (`coms_send`/`coms_await`), the agent-hub Verification
14
+ Contract, and the herdr fleet layer (`team-up`, events, pane control).
15
+
16
+ Each pattern: when to use → protocol → how this repo instantiates it → failure modes.
17
+ Patterns name live mechanisms or say "not implemented here" — nothing aspirational is
18
+ presented as current.
19
+
20
+ ---
21
+
22
+ ## 1. Read-to-decide with sentinels
23
+
24
+ **When:** an orchestrator must branch on another agent's outcome. Prose is not a branch
25
+ condition — an LLM paraphrasing "it mostly works" hides a RED.
26
+
27
+ **Protocol:** the producing agent ends its output with a machine-greppable verdict line
28
+ (`VERDICT=GREEN|RED`, `STATUS: blocked`, …). The consumer greps for the sentinel and
29
+ branches on it — never on its interpretation of the surrounding prose. If the sentinel is
30
+ missing, that is itself a verdict (treat as failure/unknown, never as success).
31
+
32
+ **In this repo (live):**
33
+ - `NEEDS_RESEARCH: <question>` — a specialist pauses for information; the hub runs the
34
+ research and resumes it (agent-hub auto-research pipe).
35
+ - `ASK_USER: <question>` — same protocol toward the human.
36
+ - The structured-return contract — agent-hub specialists return a typed
37
+ `{status, evidence, …}` block that `crossCheck` verifies against the dispatcher's
38
+ acceptance assertions; the *absence* of required evidence fails the gate.
39
+ - The `DIGEST:` contract — delegate children must end with a `DIGEST:` section; a missing
40
+ digest is flagged to the parent instead of silently passing.
41
+ - Phase 4 of the herdr integration adds `<<COMS_DONE:msg_id>>` as the bridge's completion
42
+ sentinel for driving non-pi CLIs.
43
+
44
+ **Failure modes:** sentinel collisions with legitimate output (pick unlikely strings);
45
+ agents *mentioning* the sentinel instead of *emitting* it (grep the last lines only);
46
+ treating a missing sentinel as success.
47
+
48
+ ---
49
+
50
+ ## 2. Push events over polling
51
+
52
+ **When:** an agent waits on another agent's state (done, blocked, alive) and the naive
53
+ implementation is a read-screen/ping loop.
54
+
55
+ **Protocol:** subscribe to a push channel and act on delivery. When polling is truly
56
+ unavoidable, bound it: explicit timeout, capped interval, and a terminal condition that
57
+ cannot be missed.
58
+
59
+ **In this repo (live):**
60
+ - `coms_await` — blocks on the response envelope for a `msg_id` (push) instead of
61
+ polling `coms_get`.
62
+ - The coms presence backend under herdr — the pool widget populates from
63
+ `events.subscribe` (`pane.agent_status_changed`, `pane.created/closed/exited`) instead
64
+ of the 10s ping cycle; the ping loop survives only in the files backend where no push
65
+ channel exists.
66
+ - herdr's blocking waiters — `herdr wait agent-status <pane> --status done` and
67
+ `pane.wait_for_output --match <text>` are server-side waits, not client loops.
68
+
69
+ **Failure modes:** waiting for a state the pane is already in (herdr status waits fire on
70
+ *changes* — read current state first); missed events during a reconnect (resync a
71
+ snapshot on every reconnect, as `HerdrAgentWatch` does); unbounded waits (always pass a
72
+ timeout).
73
+
74
+ ---
75
+
76
+ ## 3. Rendezvous / barriers
77
+
78
+ **When:** work must not proceed past a point until N agents have arrived at it — a
79
+ request needs its response, parallel builders must finish before the verifier runs.
80
+
81
+ **Protocol:** a named wait point. One side blocks on the barrier; the other side's
82
+ arrival (response, completion event) releases it. The barrier has a timeout and a
83
+ defined behavior on partial arrival.
84
+
85
+ **In this repo (live):**
86
+ - `coms_send` + `coms_await` — the request/response barrier between peers: the sender
87
+ blocks on the `msg_id`, the receiver's `agent_end` response capture releases it.
88
+ - The agent-hub dispatcher awaiting parallel dispatches before the Verification
89
+ Contract's gate — no verdict until every specialist's structured return is in.
90
+ - `/af-handoff` — a full-session barrier: the dispatcher composes a brief, sends it, and
91
+ awaits the peer's acknowledgment before ceding.
92
+
93
+ **Failure modes:** deadlock by mutual await (A awaits B while B awaits A — the coms hop
94
+ limit caps how deep synchronous chains can nest); barriers with no timeout; releasing on
95
+ ack instead of on completion (an ack means "received", not "done" — await the response
96
+ envelope, not the ack).
97
+
98
+ ---
99
+
100
+ ## 4. Fan-out / fan-in with digest discipline
101
+
102
+ **When:** a task shards into parallel independent slices whose results one agent must
103
+ merge — multi-angle reviews, per-module audits, racing hypotheses in debugging.
104
+
105
+ **Protocol:** shard → run in parallel → each worker writes its full output to an on-disk
106
+ artifact and returns only a bounded digest → the merger reads digests, pulls full
107
+ artifacts only where the digest warrants it. Raw dumps never travel upward.
108
+
109
+ **In this repo (live):**
110
+ - `spawn_research` findings files — research helpers write findings to disk; the hub
111
+ reads the file paths, not transcript dumps.
112
+ - The artifact bus — specialists exchange `kind`-tagged artifact files; inputs are
113
+ previews + paths, never inlined full content.
114
+ - The delegate `DIGEST:` contract — children return ≤30 digest lines with `path:line`
115
+ citations plus the result-file path; over-long returns are truncated with a warning.
116
+ - `just fleet team <team> --no-hub` is the fleet-level shard step: one pane per peer, each an
117
+ addressable worker.
118
+
119
+ **Failure modes:** digest inflation (cap lines, require citations); merger re-reading
120
+ every full artifact (defeats the point — pull selectively); shards that were not
121
+ actually independent (merge conflicts surface late; shard along module/file boundaries).
122
+
123
+ ---
124
+
125
+ ## 5. Racing with cancellation
126
+
127
+ **When:** several approaches to the same goal run in parallel and the first valid result
128
+ should win — competing fixes, multiple models on one question.
129
+
130
+ **Protocol:** N agents start; the orchestrator awaits the first result that passes
131
+ validation; every other runner is torn down immediately. Requires real kill semantics
132
+ and a validation step *before* declaring a winner (first ≠ correct).
133
+
134
+ **In this repo:** **not implemented as a first-class mechanism.** The pieces exist —
135
+ herdr `pane.close` / `workspace.close` (and the agent-hub `/af-agents-kill` command) can
136
+ tear down runners, and `coms_get` can poll multiple pending `msg_id`s — but **coms has no
137
+ cancel envelope**: a losing peer keeps working (and burning tokens) until its turn ends;
138
+ its late response is dropped as an orphan. Racing today means paying for every lane.
139
+ What it would take: a `cancel` envelope type honored mid-turn by peers, or racing only
140
+ runners whose lifecycle the orchestrator owns (herdr panes it may close — see the
141
+ damage-control rules before giving any LLM that verb).
142
+
143
+ **Failure modes:** declaring the fastest answer the best answer (validate first);
144
+ zombie runners after the race (tear down explicitly); racing where lanes share state
145
+ (two builders editing one worktree is a conflict, not a race — isolate worktrees).
146
+
147
+ ---
148
+
149
+ ---
150
+
151
+ ## 6. Same-question model poll and harness-mediated debate
152
+
153
+ **When:** one role, N models, the same question. Poll collects independent opinions then an integrator merge. Debate repeats for 2–5 rounds; each surviving voice sees the labeled positions of the others from the previous round.
154
+
155
+ **Protocol:** resolve a named panel from `.pi/agents/voices.yaml` → spawn every voice read-only in parallel → write each full opinion to disk → return only a bounded digest upward. Debate additionally feeds the previous round's labeled packet into the next turn of the same per-voice session. There is no judge. Voices never write to each other. With `--apply`, only the poll integrator may write, and only while holding a cross-process writer lease.
156
+
157
+ **In this repo (live):**
158
+ - `/af-poll` and `just flow poll --panel default "…"` — independent opinions plus integrator merge.
159
+ - `/af-debate` and `just flow debate --panel default --rounds 3 "…"` — harness-mediated rounds, no merge.
160
+ - Artifacts under `.pi/agent-sessions/artifacts/polls/<runId>/` (debate rounds in `debate/round-<n>/`).
161
+ - Optional communication contract via `append-prompt: references/communication-contract.md` — not loaded automatically.
162
+
163
+ **Not:** Claude Code Agent Teams. Live teammate messaging is a different composition-layer pattern; see [orchestration-patterns.md](orchestration-patterns.md).
164
+
165
+ **Failure modes:** missing `--panel` (refusal listing available names); a foreign-opinion packet over the hard byte cap (refusal with the named size, never truncation); fewer than two successful voices; `--apply` while another live owner holds the writer lease (refusal naming that owner's command).
166
+
167
+ ---
168
+
169
+ *Composition-layer patterns (which personas, which commands, Agent Teams):*
170
+ [orchestration-patterns.md](orchestration-patterns.md). *The contract the dispatcher
171
+ enforces over all of these:* [skills/orchestration-verification](../skills/orchestration-verification/SKILL.md).
@@ -0,0 +1,91 @@
1
+ # Observability Checklist
2
+
3
+ Quick reference for instrumenting production code. Use alongside the `observability-and-instrumentation` skill.
4
+
5
+ ## Table of Contents
6
+
7
+ - [On-Call Questions (Start Here)](#on-call-questions-start-here)
8
+ - [Structured Logging](#structured-logging)
9
+ - [Metrics](#metrics)
10
+ - [Distributed Tracing](#distributed-tracing)
11
+ - [Alerting](#alerting)
12
+ - [Dashboards](#dashboards)
13
+ - [Verify the Telemetry](#verify-the-telemetry)
14
+ - [Pre-Launch Gate](#pre-launch-gate)
15
+
16
+ ## On-Call Questions (Start Here)
17
+
18
+ Telemetry without a question is noise. Before instrumenting anything:
19
+
20
+ - [ ] 2–4 questions an on-call engineer will ask about this feature are written down
21
+ - [ ] Every signal below maps to one of those questions
22
+ - [ ] Each question is matched to the right signal type: metrics say **that** something is wrong, traces say **where**, logs say **why**
23
+
24
+ ## Structured Logging
25
+
26
+ - [ ] Logs are structured (JSON) with stable event names — not free-form strings
27
+ - [ ] Every log line carries a correlation/request ID, generated or accepted at the system boundary
28
+ - [ ] Correlation ID is propagated on every outbound call and async boundary (HTTP headers, queue metadata)
29
+ - [ ] Log levels are consistent: `error` = invariant broken, someone may act; `warn` = degraded but handled; `info` = significant business event; `debug` = off in production
30
+ - [ ] No secrets, tokens, passwords, or unredacted PII in any log line (hard rule from `security-and-hardening`)
31
+ - [ ] Fields are allowlisted — no whole request/response bodies, no auth headers
32
+ - [ ] External service calls logged with metadata only: endpoint, status, latency, attempt count, sanitized identifiers
33
+ - [ ] Actual log output spot-checked: structured fields, not `[object Object]`
34
+
35
+ ## Metrics
36
+
37
+ - [ ] **RED** instrumented for every endpoint and every external dependency: Rate, Errors, Duration
38
+ - [ ] **USE** instrumented for every resource (queues, pools, hosts): Utilization, Saturation, Errors
39
+ - [ ] Latency is a histogram; p50/p95/p99 queryable — never an average
40
+ - [ ] All labels come from small, fixed sets (route template, status class, provider name)
41
+ - [ ] No unbounded label values: no user IDs, tenant IDs, emails, raw URLs, request IDs, or error message text
42
+ - [ ] Status codes grouped by class (`5xx`, not `503`)
43
+ - [ ] Queue depth and processing duration tracked for every worker/queue
44
+
45
+ ## Distributed Tracing
46
+
47
+ - [ ] OpenTelemetry (or equivalent) initialized at service startup, before other imports
48
+ - [ ] Auto-instrumentation enabled for HTTP, gRPC, and DB clients
49
+ - [ ] Trace context propagated on every outbound call (W3C `traceparent`/`tracestate`) and extracted from every inbound request
50
+ - [ ] Context survives async boundaries — queue messages carry trace metadata
51
+ - [ ] Manual spans only around meaningful internal units of work, with the attributes on-call will filter by
52
+ - [ ] No secrets or PII as span attributes
53
+ - [ ] Head-based sampling at a low default rate; 100% of errors kept if tail sampling is available
54
+
55
+ ## Alerting
56
+
57
+ - [ ] Every alert is symptom-based (error rate, p99 latency, queue age) — causes (CPU, disk, restarts) go to dashboards, not pagers
58
+ - [ ] Every alert is actionable; "ignore it, it self-heals" alerts are deleted
59
+ - [ ] Every alert links to a runbook — minimum three lines: what it means, first query to run, escalation path
60
+ - [ ] Thresholds and durations justified by an SLO or historical data, not guesses
61
+ - [ ] Two severities only: **page** (user-facing, act now) and **ticket** (degradation, act this week)
62
+ - [ ] Each new alert test-fired once: it reached the right channel and the runbook link works
63
+ - [ ] No alerts that fire daily and get acknowledged without action
64
+
65
+ ## Dashboards
66
+
67
+ - [ ] Service health dashboard exists: error rate, latency p99, traffic, saturation
68
+ - [ ] Dependency health panel shows per-service error rates and latency
69
+ - [ ] Dashboard answers the on-call questions from the top of this checklist — not "everything except the answer"
70
+ - [ ] Default time range is sensible (1h–6h, not 30d)
71
+
72
+ ## Verify the Telemetry
73
+
74
+ Instrumentation is code; it can be wrong:
75
+
76
+ - [ ] Forced an error in staging → found it in the logs by correlation ID
77
+ - [ ] Sent test traffic → metric series appear with expected labels and sane values
78
+ - [ ] Followed one request end-to-end in the tracing UI → no broken spans
79
+ - [ ] An induced failure was diagnosed from telemetry alone, without reading the source
80
+
81
+ ## Pre-Launch Gate
82
+
83
+ Before a feature ships to production, all of the following are true:
84
+
85
+ - [ ] Structured logs flowing to the log aggregator
86
+ - [ ] RED metrics visible in dashboards for every new endpoint and dependency
87
+ - [ ] At least one symptom-based alert configured, with runbook, test-fired
88
+ - [ ] A request can be traced across every service it touches
89
+ - [ ] On-call knows where the runbooks are
90
+
91
+ For launch-day monitoring sequence and rollback triggers, see the `shipping-and-launch` skill.