@chankov/agent-fleet 2.0.12 → 2.0.13

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 (616) hide show
  1. package/.pi/agent-fleet/scripts/flow.ts +5 -3
  2. package/.pi/agent-fleet/scripts/lib/flow-command.ts +9 -4
  3. package/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +3 -1
  4. package/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
  5. package/.pi/agents/model-profiles.yaml +80 -29
  6. package/.pi/agents/peers.yaml +18 -18
  7. package/.pi/agents/voices.yaml +2 -2
  8. package/.pi/harnesses/agent-hub/README.md +55 -4
  9. package/.pi/harnesses/agent-hub/commands/audit.ts +1 -1
  10. package/.pi/harnesses/agent-hub/commands/context.ts +1 -1
  11. package/.pi/harnesses/agent-hub/config/model-profiles.ts +1 -0
  12. package/.pi/harnesses/agent-hub/delegate.ts +5 -3
  13. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +27 -2
  14. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +29 -0
  15. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +6 -0
  16. package/.pi/harnesses/agent-hub/index.ts +75 -40
  17. package/.pi/harnesses/agent-hub/package.json +1 -1
  18. package/.pi/harnesses/agent-hub/policy/profile-activation.ts +2 -2
  19. package/.pi/harnesses/agent-hub/proactive-config.ts +40 -0
  20. package/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  21. package/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  22. package/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  23. package/.pi/harnesses/agent-hub/proactive-local.ts +88 -0
  24. package/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
  25. package/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
  26. package/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
  27. package/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  28. package/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  29. package/.pi/harnesses/agent-hub/proactive-snapshot.ts +243 -0
  30. package/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
  31. package/.pi/harnesses/agent-hub/prompts/context.ts +2 -0
  32. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +3 -0
  33. package/.pi/harnesses/agent-hub/research/runtime.ts +3 -1
  34. package/.pi/harnesses/agent-hub/research/spawn-run.ts +4 -1
  35. package/.pi/harnesses/agent-hub/return-extract.js +1 -1
  36. package/.pi/harnesses/agent-hub/session-audit.ts +6 -5
  37. package/.pi/harnesses/agent-hub/system1-activity.ts +67 -0
  38. package/.pi/harnesses/agent-hub/system1-report.ts +142 -1
  39. package/.pi/harnesses/agent-hub/system1-runtime.ts +3 -0
  40. package/.pi/harnesses/agent-hub/tools/run-flow.ts +16 -2
  41. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +26 -5
  42. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +30 -5
  43. package/.pi/harnesses/agent-hub/ui/fleet-source.ts +7 -2
  44. package/.pi/harnesses/agent-hub/ui/grid.ts +12 -7
  45. package/.pi/harnesses/coms/package.json +1 -1
  46. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  47. package/.pi/harnesses/lib/context-budget-child-prompt.ts +41 -2
  48. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +4 -2
  49. package/.pi/harnesses/lib/fleet-dashboard-view.ts +14 -3
  50. package/.pi/harnesses/lib/fleet-detail-view.ts +68 -7
  51. package/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  52. package/.pi/harnesses/lib/fleet-strip-view.ts +44 -9
  53. package/.pi/prompts/af-setup-rules.md +20 -0
  54. package/.versions/2.0.13/.pi/agent-fleet/hermes/README.md +347 -0
  55. package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  56. package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  57. package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  58. package/.versions/2.0.13/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  59. package/.versions/2.0.13/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  60. package/.versions/2.0.13/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  61. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  62. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  63. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  64. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  65. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  66. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  67. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  68. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  69. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  70. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  71. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  72. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  73. package/.versions/2.0.13/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  74. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  75. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  76. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  77. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  78. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  79. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  80. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  81. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  82. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  83. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  84. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  85. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  86. package/.versions/2.0.13/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  87. package/.versions/2.0.13/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  88. package/.versions/2.0.13/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  89. package/.versions/2.0.13/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  90. package/.versions/2.0.13/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  91. package/.versions/2.0.13/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  92. package/.versions/2.0.13/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  93. package/.versions/2.0.13/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  94. package/.versions/2.0.13/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  95. package/.versions/2.0.13/.pi/agent-fleet/scripts/fleet.ts +216 -0
  96. package/.versions/2.0.13/.pi/agent-fleet/scripts/flow.ts +157 -0
  97. package/.versions/2.0.13/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  98. package/.versions/2.0.13/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  99. package/.versions/2.0.13/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  100. package/.versions/2.0.13/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  101. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  102. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  103. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  104. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  105. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  106. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  107. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  108. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  109. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  110. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  111. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  112. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  113. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  114. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  115. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  116. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  117. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  118. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  119. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  120. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  121. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  122. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  123. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  124. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  125. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  126. package/.versions/2.0.13/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  127. package/.versions/2.0.13/.pi/agent-fleet/scripts/package-lock.json +35 -0
  128. package/.versions/2.0.13/.pi/agent-fleet/scripts/package.json +9 -0
  129. package/.versions/2.0.13/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  130. package/.versions/2.0.13/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  131. package/.versions/2.0.13/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  132. package/.versions/2.0.13/.pi/agent-fleet/scripts/team-up.ts +378 -0
  133. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  134. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  135. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  136. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  137. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  138. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  139. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  140. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  141. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  142. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  143. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  144. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  145. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  146. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  147. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
  148. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  149. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  150. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  151. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  152. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  153. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  154. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  155. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  156. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  157. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  158. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  159. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  160. package/.versions/2.0.13/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  161. package/.versions/2.0.13/.pi/agents/dispatch-policy.yaml +32 -0
  162. package/.versions/2.0.13/.pi/agents/model-profiles.yaml +134 -0
  163. package/.versions/2.0.13/.pi/agents/peers.yaml +147 -0
  164. package/.versions/2.0.13/.pi/agents/teams.yaml +41 -0
  165. package/.versions/2.0.13/.pi/agents/voices.yaml +13 -0
  166. package/.versions/2.0.13/.pi/damage-control-rules.yaml +297 -0
  167. package/.versions/2.0.13/.pi/extensions/btw/README.md +120 -0
  168. package/.versions/2.0.13/.pi/extensions/btw/index.ts +914 -0
  169. package/.versions/2.0.13/.pi/extensions/btw/package.json +6 -0
  170. package/.versions/2.0.13/.pi/extensions/btw/state.js +179 -0
  171. package/.versions/2.0.13/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  172. package/.versions/2.0.13/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  173. package/.versions/2.0.13/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  174. package/.versions/2.0.13/.pi/extensions/compact-and-continue/README.md +42 -0
  175. package/.versions/2.0.13/.pi/extensions/compact-and-continue/index.ts +120 -0
  176. package/.versions/2.0.13/.pi/extensions/compact-and-continue/package.json +6 -0
  177. package/.versions/2.0.13/.pi/extensions/mcp-bridge/README.md +46 -0
  178. package/.versions/2.0.13/.pi/extensions/mcp-bridge/index.ts +206 -0
  179. package/.versions/2.0.13/.pi/extensions/mcp-bridge/package.json +6 -0
  180. package/.versions/2.0.13/.pi/extensions/package-lock.json +1175 -0
  181. package/.versions/2.0.13/.pi/extensions/package.json +9 -0
  182. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/README.md +224 -0
  183. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/config.ts +198 -0
  184. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  185. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/index.ts +248 -0
  186. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/package.json +6 -0
  187. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  188. package/.versions/2.0.13/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  189. package/.versions/2.0.13/.pi/harnesses/agent-hub/README.md +1360 -0
  190. package/.versions/2.0.13/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  191. package/.versions/2.0.13/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  192. package/.versions/2.0.13/.pi/harnesses/agent-hub/artifacts.js +146 -0
  193. package/.versions/2.0.13/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  194. package/.versions/2.0.13/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  195. package/.versions/2.0.13/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  196. package/.versions/2.0.13/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  197. package/.versions/2.0.13/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  198. package/.versions/2.0.13/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
  199. package/.versions/2.0.13/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  200. package/.versions/2.0.13/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  201. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  202. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  203. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  204. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  205. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  206. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  207. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  208. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  209. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  210. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  211. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  212. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  213. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  214. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  215. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  216. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  217. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/context.ts +45 -0
  218. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  219. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  220. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  221. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  222. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  223. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  224. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/recover.ts +52 -0
  225. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  226. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  227. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  228. package/.versions/2.0.13/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  229. package/.versions/2.0.13/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  230. package/.versions/2.0.13/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
  231. package/.versions/2.0.13/.pi/harnesses/agent-hub/config/overrides.ts +160 -0
  232. package/.versions/2.0.13/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  233. package/.versions/2.0.13/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  234. package/.versions/2.0.13/.pi/harnesses/agent-hub/context/budgets.ts +204 -0
  235. package/.versions/2.0.13/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  236. package/.versions/2.0.13/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  237. package/.versions/2.0.13/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  238. package/.versions/2.0.13/.pi/harnesses/agent-hub/context-window.js +108 -0
  239. package/.versions/2.0.13/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  240. package/.versions/2.0.13/.pi/harnesses/agent-hub/delegate.ts +467 -0
  241. package/.versions/2.0.13/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
  242. package/.versions/2.0.13/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  243. package/.versions/2.0.13/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  244. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
  245. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  246. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-complete.ts +169 -0
  247. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +248 -0
  248. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +231 -0
  249. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native-types.ts +257 -0
  250. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-native.ts +226 -0
  251. package/.versions/2.0.13/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  252. package/.versions/2.0.13/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  253. package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  254. package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  255. package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  256. package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  257. package/.versions/2.0.13/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  258. package/.versions/2.0.13/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  259. package/.versions/2.0.13/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  260. package/.versions/2.0.13/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  261. package/.versions/2.0.13/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
  262. package/.versions/2.0.13/.pi/harnesses/agent-hub/fixtures/registration-surface.json +61 -0
  263. package/.versions/2.0.13/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  264. package/.versions/2.0.13/.pi/harnesses/agent-hub/footer.ts +30 -0
  265. package/.versions/2.0.13/.pi/harnesses/agent-hub/helpers.ts +270 -0
  266. package/.versions/2.0.13/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  267. package/.versions/2.0.13/.pi/harnesses/agent-hub/index.ts +2336 -0
  268. package/.versions/2.0.13/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  269. package/.versions/2.0.13/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  270. package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +125 -0
  271. package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  272. package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  273. package/.versions/2.0.13/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  274. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  275. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  276. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  277. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  278. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  279. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  280. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  281. package/.versions/2.0.13/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  282. package/.versions/2.0.13/.pi/harnesses/agent-hub/no-progress.ts +359 -0
  283. package/.versions/2.0.13/.pi/harnesses/agent-hub/package.json +7 -0
  284. package/.versions/2.0.13/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  285. package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  286. package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  287. package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  288. package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  289. package/.versions/2.0.13/.pi/harnesses/agent-hub/policy/work-mode.ts +126 -0
  290. package/.versions/2.0.13/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  291. package/.versions/2.0.13/.pi/harnesses/agent-hub/presentation.ts +48 -0
  292. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-config.ts +40 -0
  293. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  294. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  295. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  296. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-local.ts +88 -0
  297. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
  298. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
  299. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
  300. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  301. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  302. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-snapshot.ts +243 -0
  303. package/.versions/2.0.13/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
  304. package/.versions/2.0.13/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
  305. package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/context.ts +53 -0
  306. package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/fragments.ts +118 -0
  307. package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  308. package/.versions/2.0.13/.pi/harnesses/agent-hub/prompts/system-prompt.ts +115 -0
  309. package/.versions/2.0.13/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  310. package/.versions/2.0.13/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  311. package/.versions/2.0.13/.pi/harnesses/agent-hub/recover-policy.ts +27 -0
  312. package/.versions/2.0.13/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  313. package/.versions/2.0.13/.pi/harnesses/agent-hub/recovery-contract.ts +80 -0
  314. package/.versions/2.0.13/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  315. package/.versions/2.0.13/.pi/harnesses/agent-hub/research/runtime.ts +195 -0
  316. package/.versions/2.0.13/.pi/harnesses/agent-hub/research/spawn-run.ts +174 -0
  317. package/.versions/2.0.13/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  318. package/.versions/2.0.13/.pi/harnesses/agent-hub/return-contract.js +327 -0
  319. package/.versions/2.0.13/.pi/harnesses/agent-hub/return-extract.js +77 -0
  320. package/.versions/2.0.13/.pi/harnesses/agent-hub/review-findings.js +104 -0
  321. package/.versions/2.0.13/.pi/harnesses/agent-hub/run-budget.js +542 -0
  322. package/.versions/2.0.13/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  323. package/.versions/2.0.13/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  324. package/.versions/2.0.13/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  325. package/.versions/2.0.13/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  326. package/.versions/2.0.13/.pi/harnesses/agent-hub/session-audit.ts +227 -0
  327. package/.versions/2.0.13/.pi/harnesses/agent-hub/session-health.js +110 -0
  328. package/.versions/2.0.13/.pi/harnesses/agent-hub/session-start.ts +42 -0
  329. package/.versions/2.0.13/.pi/harnesses/agent-hub/spawn.ts +526 -0
  330. package/.versions/2.0.13/.pi/harnesses/agent-hub/system1-activity.ts +510 -0
  331. package/.versions/2.0.13/.pi/harnesses/agent-hub/system1-report.ts +225 -0
  332. package/.versions/2.0.13/.pi/harnesses/agent-hub/system1-runtime.ts +276 -0
  333. package/.versions/2.0.13/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  334. package/.versions/2.0.13/.pi/harnesses/agent-hub/timeline.ts +72 -0
  335. package/.versions/2.0.13/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  336. package/.versions/2.0.13/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  337. package/.versions/2.0.13/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  338. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/action-executors.ts +185 -0
  339. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  340. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/context.ts +142 -0
  341. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  342. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +498 -0
  343. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  344. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  345. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  346. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  347. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  348. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
  349. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  350. package/.versions/2.0.13/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  351. package/.versions/2.0.13/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  352. package/.versions/2.0.13/.pi/harnesses/agent-hub/types.ts +66 -0
  353. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  354. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
  355. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  356. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  357. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +124 -0
  358. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  359. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/fleet-source.ts +175 -0
  360. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  361. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  362. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  363. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  364. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  365. package/.versions/2.0.13/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  366. package/.versions/2.0.13/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  367. package/.versions/2.0.13/.pi/harnesses/agent-hub/version.ts +42 -0
  368. package/.versions/2.0.13/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  369. package/.versions/2.0.13/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  370. package/.versions/2.0.13/.pi/harnesses/agent-hub/work-mode.ts +173 -0
  371. package/.versions/2.0.13/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  372. package/.versions/2.0.13/.pi/harnesses/ask-user-remote/README.md +59 -0
  373. package/.versions/2.0.13/.pi/harnesses/ask-user-remote/index.ts +558 -0
  374. package/.versions/2.0.13/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  375. package/.versions/2.0.13/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  376. package/.versions/2.0.13/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  377. package/.versions/2.0.13/.pi/harnesses/coms/README.md +100 -0
  378. package/.versions/2.0.13/.pi/harnesses/coms/index.ts +282 -0
  379. package/.versions/2.0.13/.pi/harnesses/coms/package.json +7 -0
  380. package/.versions/2.0.13/.pi/harnesses/coms/version.ts +42 -0
  381. package/.versions/2.0.13/.pi/harnesses/damage-control-continue/README.md +135 -0
  382. package/.versions/2.0.13/.pi/harnesses/damage-control-continue/index.ts +550 -0
  383. package/.versions/2.0.13/.pi/harnesses/damage-control-continue/package.json +7 -0
  384. package/.versions/2.0.13/.pi/harnesses/damage-control-continue/version.ts +42 -0
  385. package/.versions/2.0.13/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  386. package/.versions/2.0.13/.pi/harnesses/lib/coms-core-io.ts +385 -0
  387. package/.versions/2.0.13/.pi/harnesses/lib/coms-core.ts +577 -0
  388. package/.versions/2.0.13/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  389. package/.versions/2.0.13/.pi/harnesses/lib/context-budget-child-prompt.ts +219 -0
  390. package/.versions/2.0.13/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  391. package/.versions/2.0.13/.pi/harnesses/lib/context-budget-view.ts +107 -0
  392. package/.versions/2.0.13/.pi/harnesses/lib/context-budget.ts +114 -0
  393. package/.versions/2.0.13/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  394. package/.versions/2.0.13/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  395. package/.versions/2.0.13/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  396. package/.versions/2.0.13/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  397. package/.versions/2.0.13/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  398. package/.versions/2.0.13/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  399. package/.versions/2.0.13/.pi/harnesses/lib/fleet-dashboard-view.ts +147 -0
  400. package/.versions/2.0.13/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  401. package/.versions/2.0.13/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  402. package/.versions/2.0.13/.pi/harnesses/lib/fleet-panel.ts +34 -0
  403. package/.versions/2.0.13/.pi/harnesses/lib/fleet-read-model.ts +536 -0
  404. package/.versions/2.0.13/.pi/harnesses/lib/fleet-selection.ts +24 -0
  405. package/.versions/2.0.13/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  406. package/.versions/2.0.13/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  407. package/.versions/2.0.13/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  408. package/.versions/2.0.13/.pi/harnesses/lib/herdr-client.ts +472 -0
  409. package/.versions/2.0.13/.pi/harnesses/lib/herdr-presence.ts +399 -0
  410. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  411. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  412. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  413. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  414. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  415. package/.versions/2.0.13/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  416. package/.versions/2.0.13/.pi/harnesses/lib/spawned-peers.js +191 -0
  417. package/.versions/2.0.13/.pi/harnesses/lib/system1/config.js +61 -0
  418. package/.versions/2.0.13/.pi/harnesses/lib/system1/contracts.ts +152 -0
  419. package/.versions/2.0.13/.pi/harnesses/lib/system1/demo.ts +106 -0
  420. package/.versions/2.0.13/.pi/harnesses/lib/system1/jev.ts +503 -0
  421. package/.versions/2.0.13/.pi/harnesses/lib/system1/service.ts +245 -0
  422. package/.versions/2.0.13/.pi/harnesses/lib/update-check.ts +222 -0
  423. package/.versions/2.0.13/.pi/harnesses/package-lock.json +2039 -0
  424. package/.versions/2.0.13/.pi/harnesses/package.json +10 -0
  425. package/.versions/2.0.13/.pi/prompts/af-build.md +24 -0
  426. package/.versions/2.0.13/.pi/prompts/af-code-simplify.md +22 -0
  427. package/.versions/2.0.13/.pi/prompts/af-constraints.md +31 -0
  428. package/.versions/2.0.13/.pi/prompts/af-plan.md +17 -0
  429. package/.versions/2.0.13/.pi/prompts/af-review.md +16 -0
  430. package/.versions/2.0.13/.pi/prompts/af-set-hermes-telegram.md +15 -0
  431. package/.versions/2.0.13/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  432. package/.versions/2.0.13/.pi/prompts/af-setup-rules.md +20 -0
  433. package/.versions/2.0.13/.pi/prompts/af-ship.md +17 -0
  434. package/.versions/2.0.13/.pi/prompts/af-spec.md +15 -0
  435. package/.versions/2.0.13/.pi/prompts/af-test.md +19 -0
  436. package/.versions/2.0.13/.pi/skills/bowser/SKILL.md +145 -0
  437. package/.versions/2.0.13/.version +1 -0
  438. package/.versions/2.0.13/agents/architect.md +24 -0
  439. package/.versions/2.0.13/agents/bowser.md +28 -0
  440. package/.versions/2.0.13/agents/builder.md +55 -0
  441. package/.versions/2.0.13/agents/code-reviewer.md +209 -0
  442. package/.versions/2.0.13/agents/deep-researcher.md +32 -0
  443. package/.versions/2.0.13/agents/documenter.md +22 -0
  444. package/.versions/2.0.13/agents/orchestrator.md +22 -0
  445. package/.versions/2.0.13/agents/plan-reviewer.md +83 -0
  446. package/.versions/2.0.13/agents/planner.md +105 -0
  447. package/.versions/2.0.13/agents/releaser.md +24 -0
  448. package/.versions/2.0.13/agents/researcher.md +30 -0
  449. package/.versions/2.0.13/agents/security-auditor.md +167 -0
  450. package/.versions/2.0.13/agents/test-engineer.md +153 -0
  451. package/.versions/2.0.13/agents/web-debugger.md +44 -0
  452. package/.versions/2.0.13/agents/web-performance-auditor.md +194 -0
  453. package/.versions/2.0.13/bin/catalog/harness-runtime-closure.json +73 -0
  454. package/.versions/2.0.13/codex/fleet-session-client/SKILL.md +34 -0
  455. package/.versions/2.0.13/codex/fleet-session-client.zip +0 -0
  456. package/.versions/2.0.13/docs/ARCHITECTURE.md +753 -0
  457. package/.versions/2.0.13/docs/agent-fleet-setup.md +900 -0
  458. package/.versions/2.0.13/docs/claude-code-coms-bridge.md +134 -0
  459. package/.versions/2.0.13/docs/codex-session-bridge.md +219 -0
  460. package/.versions/2.0.13/docs/coms-hermes-bridge.md +188 -0
  461. package/.versions/2.0.13/docs/getting-started.md +126 -0
  462. package/.versions/2.0.13/docs/npm-install.md +468 -0
  463. package/.versions/2.0.13/docs/pi-extensions.md +454 -0
  464. package/.versions/2.0.13/docs/pi-setup.md +92 -0
  465. package/.versions/2.0.13/docs/skill-anatomy.md +150 -0
  466. package/.versions/2.0.13/install-manifest.json +3175 -0
  467. package/.versions/2.0.13/justfile +247 -0
  468. package/.versions/2.0.13/manifest-meta.json +1057 -0
  469. package/.versions/2.0.13/references/accessibility-checklist.md +160 -0
  470. package/.versions/2.0.13/references/communication-contract.md +26 -0
  471. package/.versions/2.0.13/references/definition-of-done.md +67 -0
  472. package/.versions/2.0.13/references/fleet-coordination-patterns.md +171 -0
  473. package/.versions/2.0.13/references/observability-checklist.md +92 -0
  474. package/.versions/2.0.13/references/orchestration-patterns.md +370 -0
  475. package/.versions/2.0.13/references/performance-checklist.md +236 -0
  476. package/.versions/2.0.13/references/prompting-patterns.md +380 -0
  477. package/.versions/2.0.13/references/security-checklist.md +245 -0
  478. package/.versions/2.0.13/references/testing-patterns.md +235 -0
  479. package/.versions/2.0.13/references/workflow-authoring.md +304 -0
  480. package/.versions/2.0.13/skills/_internal/grilling.md +59 -0
  481. package/.versions/2.0.13/skills/browser-testing-with-devtools/SKILL.md +351 -0
  482. package/.versions/2.0.13/skills/code-review-and-quality/SKILL.md +396 -0
  483. package/.versions/2.0.13/skills/compound-learning/SKILL.md +137 -0
  484. package/.versions/2.0.13/skills/constraint-driven-development/SKILL.md +338 -0
  485. package/.versions/2.0.13/skills/constraint-driven-development/references/floor-guard.md +99 -0
  486. package/.versions/2.0.13/skills/context-engineering/SKILL.md +341 -0
  487. package/.versions/2.0.13/skills/deprecation-and-migration/SKILL.md +247 -0
  488. package/.versions/2.0.13/skills/designing-agents/SKILL.md +394 -0
  489. package/.versions/2.0.13/skills/designing-agents/pi-harness-authoring.md +222 -0
  490. package/.versions/2.0.13/skills/drafting-workflows/SKILL.md +143 -0
  491. package/.versions/2.0.13/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  492. package/.versions/2.0.13/skills/frontend-ui-engineering/SKILL.md +328 -0
  493. package/.versions/2.0.13/skills/git-workflow-and-versioning/SKILL.md +316 -0
  494. package/.versions/2.0.13/skills/idea-refine/SKILL.md +182 -0
  495. package/.versions/2.0.13/skills/idea-refine/examples.md +238 -0
  496. package/.versions/2.0.13/skills/idea-refine/frameworks.md +99 -0
  497. package/.versions/2.0.13/skills/idea-refine/refinement-criteria.md +113 -0
  498. package/.versions/2.0.13/skills/idea-refine/scripts/idea-refine.sh +15 -0
  499. package/.versions/2.0.13/skills/incremental-implementation/SKILL.md +302 -0
  500. package/.versions/2.0.13/skills/interview-me/SKILL.md +226 -0
  501. package/.versions/2.0.13/skills/orchestration-verification/SKILL.md +182 -0
  502. package/.versions/2.0.13/skills/peer-coms/SKILL.md +90 -0
  503. package/.versions/2.0.13/skills/performance-optimization/SKILL.md +496 -0
  504. package/.versions/2.0.13/skills/planning-and-task-breakdown/SKILL.md +289 -0
  505. package/.versions/2.0.13/skills/repository-ai-setup/SKILL.md +117 -0
  506. package/.versions/2.0.13/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  507. package/.versions/2.0.13/skills/repository-ai-setup/references/apply-contract.md +74 -0
  508. package/.versions/2.0.13/skills/repository-ai-setup/references/provenance-template.md +16 -0
  509. package/.versions/2.0.13/skills/repository-ai-setup/references/setup-flow.md +108 -0
  510. package/.versions/2.0.13/skills/repository-ai-setup/references/verify-setup.md +20 -0
  511. package/.versions/2.0.13/skills/security-and-hardening/SKILL.md +524 -0
  512. package/.versions/2.0.13/skills/spec-driven-development/SKILL.md +295 -0
  513. package/.versions/2.0.13/skills/using-agent-skills/SKILL.md +198 -0
  514. package/.versions/2.0.13/vendor/agent-skills-upstream/LICENSE +21 -0
  515. package/.versions/2.0.13/vendor/agent-skills-upstream/README.md +430 -0
  516. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  517. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  518. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  519. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  520. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  521. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  522. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  523. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  524. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  525. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  526. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  527. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  528. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  529. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  530. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  531. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  532. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  533. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  534. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  535. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  536. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  537. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  538. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  539. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  540. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  541. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  542. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  543. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  544. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  545. package/.versions/2.0.13/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  546. package/CHANGELOG.md +10 -0
  547. package/README.md +3 -3
  548. package/agents/architect.md +2 -3
  549. package/agents/bowser.md +2 -2
  550. package/agents/builder.md +2 -3
  551. package/agents/code-reviewer.md +7 -8
  552. package/agents/deep-researcher.md +3 -4
  553. package/agents/documenter.md +2 -3
  554. package/agents/orchestrator.md +2 -3
  555. package/agents/plan-reviewer.md +5 -6
  556. package/agents/planner.md +5 -6
  557. package/agents/releaser.md +2 -3
  558. package/agents/researcher.md +4 -5
  559. package/agents/security-auditor.md +6 -7
  560. package/agents/test-engineer.md +3 -4
  561. package/agents/web-debugger.md +3 -3
  562. package/agents/web-performance-auditor.md +3 -3
  563. package/bin/catalog/harness-runtime-closure.json +30 -18
  564. package/bin/cli.js +47 -1
  565. package/bin/lib/apply.js +16 -0
  566. package/bin/lib/overrides.js +37 -1
  567. package/bin/lib/project-provenance.js +119 -0
  568. package/bin/lib/scan.js +1 -1
  569. package/bin/lib/transaction.js +1 -1
  570. package/bin/lib/validate-overrides.js +37 -3
  571. package/catalog/agent-prompts/README.md +12 -0
  572. package/catalog/agent-prompts/architecture-decision-author.md +24 -0
  573. package/catalog/agent-prompts/requirements-author.md +21 -0
  574. package/catalog/commands/README.md +13 -0
  575. package/catalog/commands/assess-change-impact.md +19 -0
  576. package/catalog/commands/audit-documentation.md +19 -0
  577. package/catalog/rules/README.md +33 -0
  578. package/catalog/rules/ai/policy-authoring.md +22 -0
  579. package/catalog/rules/architecture/behavior-preserving-refactoring.md +25 -0
  580. package/catalog/rules/architecture/public-contracts.md +22 -0
  581. package/catalog/rules/architecture/repository-boundaries.md +21 -0
  582. package/catalog/rules/architecture/structural-change-registration.md +25 -0
  583. package/catalog/rules/backend/notification-date-time.md +25 -0
  584. package/catalog/rules/bundles/README.md +16 -0
  585. package/catalog/rules/data/enum-semantics.md +25 -0
  586. package/catalog/rules/data/mixed-ownership-data.md +22 -0
  587. package/catalog/rules/data/reporting-queries.md +34 -0
  588. package/catalog/rules/docs/docs-maintenance.md +25 -0
  589. package/catalog/rules/frameworks/vue.md +25 -0
  590. package/catalog/rules/frontend/async-ui-states.md +26 -0
  591. package/catalog/rules/frontend/established-ui-primitives.md +25 -0
  592. package/catalog/rules/frontend/form-validation.md +26 -0
  593. package/catalog/rules/frontend/navigation-contracts.md +25 -0
  594. package/catalog/rules/languages/csharp.md +25 -0
  595. package/catalog/rules/languages/javascript.md +25 -0
  596. package/catalog/rules/languages/sql.md +24 -0
  597. package/catalog/rules/security/authorization-before-effects.md +26 -0
  598. package/catalog/rules/security/diagnostic-data-safety.md +22 -0
  599. package/catalog/rules/security/response-data-minimization.md +25 -0
  600. package/catalog/rules/security/trusted-tenant-scope.md +26 -0
  601. package/catalog/rules/testing/shared-package-consumers.md +25 -0
  602. package/catalog/rules/testing/verification-conventions.md +24 -0
  603. package/docs/ARCHITECTURE.md +50 -2
  604. package/docs/agent-fleet-setup.md +246 -28
  605. package/docs/codex-session-bridge.md +1 -1
  606. package/docs/pi-extensions.md +10 -5
  607. package/docs/workflows.md +4 -3
  608. package/install-manifest.json +125 -3
  609. package/manifest-meta.json +77 -15
  610. package/package.json +5 -3
  611. package/skills/repository-ai-setup/SKILL.md +117 -0
  612. package/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  613. package/skills/repository-ai-setup/references/apply-contract.md +74 -0
  614. package/skills/repository-ai-setup/references/provenance-template.md +16 -0
  615. package/skills/repository-ai-setup/references/setup-flow.md +108 -0
  616. package/skills/repository-ai-setup/references/verify-setup.md +20 -0
@@ -0,0 +1,21 @@
1
+ ---
2
+ fleet-template: repository-boundaries
3
+ fleet-source-version: 1
4
+ ---
5
+ # Rule: Repository boundaries
6
+
7
+ Load when planning, changing or reviewing code that may cross module or contract boundaries. Adapt this rule to the target's documented owners and real dependency graph; do not import a reference repository's architecture.
8
+
9
+ ## Rules
10
+ - Identify the affected module's responsibility and actual consumers before moving behavior or changing a shared contract. Cite explicit target policy where it exists; otherwise describe observed code as evidence, not as an enforceable layering rule.
11
+ - When an accepted boundary exists, keep ownership and public contract changes aligned with its consumers. Record deliberate exceptions with scope and rationale rather than hiding them in a generic rule.
12
+ - Trace cross-boundary impact for the requested change; distinguish direct callers from potential consumers that still need investigation.
13
+
14
+ ## Scope and exceptions
15
+ The target adaptation must name applicable paths, interfaces and documented exceptions. Do not prescribe a service/repository split, SPA package, controller layout, or dependency direction without target evidence and an accepted decision.
16
+
17
+ ## Verification
18
+ Check the target's policy and representative imports/callers, then inspect the changed contract and relevant tests or verification steps actually available. Flag unmapped consumers instead of asserting coverage.
19
+
20
+ ## References
21
+ Use the target rule index and applicable project documentation; for change impact use the adapted command derived from `catalog/commands/assess-change-impact.md`. These catalogue paths are *source references*, not target runtime links: replace them with actual `.ai/` references when adapting.
@@ -0,0 +1,25 @@
1
+ ---
2
+ fleet-template: structural-change-registration
3
+ fleet-source-version: 1
4
+ ---
5
+ # Rule: Structural-change registration completeness
6
+
7
+ Load when adding, moving, renaming, or removing files that participate in discovery, packaging, or runtime registration. Adapt to accepted target policy and tooling; this template is not automatically adopted policy.
8
+
9
+ Disposition: registration and delivery consistency; exclude project manifests, aliases, deployment providers, and prescribed folder layout.
10
+
11
+ ## Rules
12
+ - Identify the file’s actual registration and delivery surfaces before a structural change: imports, exports, manifests, aliases, bootstrap entries, dynamic discovery, asset pipelines, and consumers where applicable.
13
+ - Update affected references and registrations together. Do not create registrations for systems the target does not use.
14
+ - Distinguish generated registrations from authoritative sources; update the owning source and regenerate through the established mechanism rather than hand-editing generated output.
15
+ - For removal, resolve remaining consumers and remove obsolete registrations. For moves, check path case and relative references as well as static imports.
16
+ - Preserve unrelated configuration and registrations; structural cleanup is not authorization to reorganize the whole repository.
17
+
18
+ ## Scope and exceptions
19
+ Apply only to relevant target surfaces. Preserve explicit local exceptions with scope and rationale. Unresolved policy choices require acceptance before normative apply.
20
+
21
+ ## Verification
22
+ Search for stale old paths and verify new entry points with available lint/build checks. Exercise relevant runtime discovery and inspect the packaged artifact when delivery is affected; compilation alone does not prove registration or packaging correctness. Report untested surfaces.
23
+
24
+ ## References
25
+ Use the target rule index, accepted contracts, and existing checks. Bind references during adaptation.
@@ -0,0 +1,25 @@
1
+ ---
2
+ fleet-template: notification-date-time
3
+ fleet-source-version: 1
4
+ ---
5
+ # Rule: Notification date and time consistency
6
+
7
+ Load when formatting dates or times in email, in-app, or other notification channels. Adapt to accepted target policy and tooling; this template is not automatically adopted policy.
8
+
9
+ Disposition: centralized display formatting; exclude Nomenclatures constants, fixed formats, and assumed locale or time zone.
10
+
11
+ ## Rules
12
+ - Use the target’s accepted date/time formatting mechanism instead of scattering hardcoded display formats across notification channels.
13
+ - Establish the intended locale and time zone from the notification contract. Do not silently rely on worker-machine defaults or invent a recipient preference.
14
+ - Keep equivalent notifications consistent across channels while respecting explicitly different audience requirements.
15
+ - Distinguish human-readable display formatting from machine-readable timestamps. Do not replace protocol or stored timestamp formats with a localized display string.
16
+ - Define missing locale/time-zone behavior through existing policy; ask when it is unresolved. Preserve the underlying instant when formatting for different recipients.
17
+
18
+ ## Scope and exceptions
19
+ Apply only to relevant target surfaces. Preserve explicit local exceptions with scope and rationale. Unresolved policy choices require acceptance before normative apply.
20
+
21
+ ## Verification
22
+ Test representative accepted locales and zones, date-boundary cases, and daylight-saving transitions where relevant. Compare equivalent values across channels and ensure machine-readable timestamps retain their contract. Do not copy a source project’s literal format string.
23
+
24
+ ## References
25
+ Use the target rule index, accepted contracts, and existing checks. Bind references during adaptation.
@@ -0,0 +1,16 @@
1
+ # Rule bundles
2
+
3
+ Bundles compose catalogue rules into task-shaped loading sets. A bundle is a selection, not a copy: targets adapt the referenced rules, never this index. Read the task row, load only the listed rules, and never bulk-load the catalogue.
4
+
5
+ | Task | Load | Notes |
6
+ | --- | --- | --- |
7
+ | Planning (including before any diff exists) | [repository-boundaries](../architecture/repository-boundaries.md), [verification-conventions](../testing/verification-conventions.md) | Planning selects by the future change, not by a diff. |
8
+ | Backend change | planning bundle + [csharp](../languages/csharp.md) and/or [sql](../languages/sql.md) as the target stack requires | Only the languages present in the target. |
9
+ | Frontend change | planning bundle + [javascript](../languages/javascript.md) and/or [vue](../frameworks/vue.md) as the target stack requires | Only the stack present in the target. |
10
+ | Cross-stack change | backend + frontend bundles | Resolve shared-contract ownership first. |
11
+ | Review | planning bundle + the stack rules of the touched code | Reviewer checks claims against evidence. |
12
+ | Docs-only task | [docs-maintenance](../docs/docs-maintenance.md) | Implementation bundles are not loaded for docs-only work. |
13
+ | Testing and verification | [verification-conventions](../testing/verification-conventions.md) | Binds policy to real checkers; workflow stays with Fleet skills. |
14
+ | Monorepo area change | The bundle of the affected area only | One shared root never imposes one stack on all packages. |
15
+
16
+ A docs-only task never loads implementation bundles. No bundle duplicates rule content; policy lives in the rules.
@@ -0,0 +1,25 @@
1
+ ---
2
+ fleet-template: enum-semantics
3
+ fleet-source-version: 1
4
+ ---
5
+ # Rule: Explicit enum semantics
6
+
7
+ Load when creating or changing enums, named codes, or their persisted and serialized representations. Adapt to the target's accepted contracts and tooling; this template is not automatically adopted policy.
8
+
9
+ Disposition: portable named-value and compatibility guidance; exclude project paths, mandatory suffixes, sequential numbering, and a universal zero member.
10
+
11
+ ## Rules
12
+ - Prefer the existing named value over a magic number; use the target language's established representation rather than prescribing integer casts.
13
+ - Preserve persisted or externally serialized values. Reordering members must not silently change their meaning; make assignments explicit where the representation depends on declaration order.
14
+ - Follow accepted naming and placement conventions. Do not require sequential numbering, a name suffix, or an undefined zero member universally.
15
+ - Define how unknown values are handled at boundaries using the target contract; do not silently coerce them into a valid business value.
16
+ - Treat removal or reassignment of externally used values as a compatibility decision, with affected consumers and stored data identified.
17
+
18
+ ## Scope and exceptions
19
+ Apply only to the relevant target surfaces. Preserve explicit local exceptions with scope and rationale; unresolved policy choices require acceptance before normative apply.
20
+
21
+ ## Verification
22
+ Verify representative serialization round trips and stored-value mappings, including unknown values. Check compatibility against existing fixtures or published contracts; report unavailable evidence.
23
+
24
+ ## References
25
+ Use the target rule index, applicable contracts, and existing checks. Bind references during adaptation.
@@ -0,0 +1,22 @@
1
+ ---
2
+ fleet-template: mixed-ownership-data
3
+ fleet-source-version: 1
4
+ ---
5
+ # Rule: Generated facts and human decisions
6
+
7
+ Load when refreshing documents or structured data containing both generated observations and human-maintained annotations.
8
+
9
+ Disposition: retain ownership separation and evidence-based refresh; exclude provider schema and inventory layout.
10
+
11
+ ## Rules
12
+ - Establish which fields are generated, human-maintained, or derived before updating. Follow existing target ownership markers and schema; do not introduce a universal format.
13
+ - Match records by the target's stable identity, not display names alone. Preserve human descriptions, decisions, and exceptions during refresh.
14
+ - Keep observed facts distinct from declared intent. Record evidence and freshness using target conventions; represent unknown values explicitly rather than guessing or treating them as empty facts.
15
+ - Failed or partial collection does not prove deletion. Flag missing records for reconciliation instead of silently removing them.
16
+ - Preview changes and resolve ambiguous identity or ownership conflicts before apply. Do not overwrite concurrent local edits.
17
+
18
+ ## Scope and exceptions
19
+ Applies to mixed-ownership inventories, generated documentation, and service catalogues; wholly generated files follow their existing generation contract. Target schema defines unknown-value representation.
20
+
21
+ ## Verification
22
+ Exercise a refresh with human annotations, unknown values, and incomplete collection. Confirm annotations survive, missing evidence does not delete records, and an unchanged refresh yields no unnecessary changes. Report checks that remain manual or unavailable.
@@ -0,0 +1,34 @@
1
+ ---
2
+ fleet-template: reporting-queries
3
+ fleet-source-version: 1
4
+ ---
5
+ # Rule: Reporting query correctness and efficiency
6
+
7
+ Load when changing exports, reports, heavy read-only projections, or shared query loading shapes. Adapt to the target's accepted contracts and tooling; this template is not automatically adopted policy.
8
+
9
+ Disposition: query semantics and efficient execution; exclude EF/LINQ syntax, mandatory tracking modes, and prescribed layers.
10
+
11
+ ## Rules
12
+ - Establish the intended result grain and aggregate meaning before changing query shape. Joins must not accidentally multiply rows or inflate totals.
13
+ - Use an existence test when only eligibility matters, where supported; validate semantics rather than mechanically replacing every join.
14
+ - Avoid per-row queries and unnecessary early materialization. Push filtering and aggregation to the data engine where supported and appropriate; inspect actual translation instead of assuming ORM behavior.
15
+ - Select required data and use the target's established streaming or batching approach for large outputs. Do not mandate a single in-memory materialization for every export.
16
+ - Apply required ordering before slicing; include a deterministic tie-breaker where stable ordered results are required.
17
+ - Keep presentation formatting at the target's accepted boundary, without importing a specific repository or mapper architecture.
18
+
19
+ ## Shared-query change isolation
20
+ - Inspect all known callers before expanding a shared query. Filters, ordering, loading shape, tracking, projection, and materialization are part of its effective contract, not just its signature.
21
+ - Prefer a purpose-specific query or minimal projection when only one use case needs additional data. Execute additional work only on paths that need it; do not replace broad loading with per-row queries.
22
+ - An intentional shared-query expansion needs a caller-wide rationale and representative evidence. Convenience for one caller is not sufficient; resolve unclear performance or ownership trade-offs explicitly.
23
+ - Preserve existing read/write semantics and required consistency boundaries when splitting queries. Do not introduce an ORM upgrade or unsupported API simply to conceal the cost of an expanded query.
24
+
25
+ ## Scope and exceptions
26
+ Apply only to the relevant target surfaces. Preserve explicit local exceptions with scope and rationale; unresolved policy choices require acceptance before normative apply.
27
+
28
+ ## Verification
29
+ Use fixtures with duplicate reference rows, empty results, and representative aggregates. Inspect query counts, generated queries or execution plans where available; bind performance checks to existing target budgets rather than inventing thresholds.
30
+
31
+ For shared-query changes, verify unaffected caller paths retain their loading behavior and extra queries are conditional. Inspect generated queries or command counts and representative performance where feasible; mocks and green builds alone do not establish database performance. Report unmeasured effects.
32
+
33
+ ## References
34
+ Use the target rule index, applicable contracts, and existing checks. Bind references during adaptation.
@@ -0,0 +1,25 @@
1
+ ---
2
+ fleet-template: docs-maintenance
3
+ fleet-source-version: 1
4
+ ---
5
+ # Rule: Documentation maintenance
6
+
7
+ Load when creating, changing, or reviewing project documentation. Adapt this policy to the target's accepted document types, paths, and indexes; it is a starting point, not target policy.
8
+
9
+ Disposition: partial extraction — canonical sources and update-together kept; prescribed types, paths, and numbering excluded. Allowed document types require an explicit local decision; this template carries no default taxonomy.
10
+
11
+ ## Rules
12
+ - Treat the target's documentation index and canonical sources as the entry points; new documents link from the index instead of living orphaned.
13
+ - Update accepted contracts together: a behavior change updates the rule, the affected documents, and the index in the same change — never code without its documented contract, never a document contradicting the code it describes.
14
+ - When an accepted decision changes, synchronize affected implementation, tests, plans, and specifications in the same change. Remove stale contradictory current requirements before review; preserve historical decisions as clearly superseded records rather than rewriting history. Name any affected artifact that cannot be updated and report the gap instead of claiming synchronization.
15
+ - The allowed document types, their paths, and their templates are an explicit target decision (for example a subset of PRD / ADR / runbook / playbook / support notes, or none). Do not import a reference project's taxonomy, numbering, branch defaults, or output paths.
16
+ - Keep examples short and separated from normative instructions; legacy, generated, and historical examples are references, not standards.
17
+
18
+ ## Scope and exceptions
19
+ Applies to documentation sources in the target. The target adaptation must name the accepted types, their locations, the index file, and any explicit exceptions (for example decisions recorded only in chat for a defined period).
20
+
21
+ ## Verification
22
+ Check that the changed document is reachable from the index, that the referenced behavior matches the code, and that no orphaned or duplicated policy remains. Flag unmapped documents instead of asserting coverage.
23
+
24
+ ## References
25
+ Use the target rule index and applicable project documentation. These catalogue paths are *source references*, not target runtime links: replace them with actual `.ai/` references when adapting.
@@ -0,0 +1,25 @@
1
+ ---
2
+ fleet-template: vue
3
+ fleet-source-version: 1
4
+ ---
5
+ # Rule: Vue component conventions
6
+
7
+ Load when planning, changing, or reviewing Vue components. This is a framework profile, not a language rule: adapt it to the installed Vue version, SFC/in-DOM context, and existing API style.
8
+
9
+ Disposition: partial extraction — explicit contracts, request states, and recovery kept; project component inventory and provider specifics excluded.
10
+
11
+ ## Rules
12
+ - Identify the installed Vue version, SFC versus in-DOM context, and existing Options/Composition API usage before selecting syntax. Preserve explicit prop/event contracts; avoid introducing implicit app dependencies into reusable components.
13
+ - Represent loading, error, and completion state and prevent duplicate submissions where the operation requires it. Restore state after success and failure using the target component's actual disabled/event contract, not a copied reference-project control.
14
+ - Clean up owned listeners and timers with lifecycle APIs valid for the selected Vue version and API style.
15
+ - Use consistent component naming and file casing compatible with the template context. PascalCase SFC names are an optional convention, not a ban on kebab-case. No mandatory single-root wrapper and no forced migration between Options and Composition API.
16
+ - Keep SFC sections and options readable and consistent with local tooling; source examples disagree on ordering, so neither ordering becomes a universal rule. Lazy-load only at meaningful bundle boundaries.
17
+
18
+ ## Scope and exceptions
19
+ Applies to Vue components in the target. Excluded source assumptions, never carried over: shared-package placement and ownership mandates, store getters, validation-library defaults, base-component inventories, global CSS fixes, and CSS sizing policy. The target adaptation must name its Vue version, API style, and component library actually in use.
20
+
21
+ ## Verification
22
+ Run the target's component tests, type checks, and lint on touched components; exercise loading/error/duplicate-submission states where the rule applies. Flag version-specific behavior against the installed Vue documentation instead of asserting it.
23
+
24
+ ## References
25
+ Use the target rule index and applicable project documentation. These catalogue paths are *source references*, not target runtime links: replace them with actual `.ai/` references when adapting.
@@ -0,0 +1,26 @@
1
+ ---
2
+ fleet-template: async-ui-states
3
+ fleet-source-version: 1
4
+ ---
5
+ # Rule: Complete asynchronous UI states
6
+
7
+ Load when changing UI request handling, loading indicators, or error states. Adapt to the target's accepted contracts and tooling; this template is not automatically adopted policy.
8
+
9
+ Disposition: client-contract checks and complete state transitions; exclude Vue globals, endpoint formats, alert libraries, and project response shapes.
10
+
11
+ ## Rules
12
+ - Verify the actual client method and response contract before use; do not infer method names from another library.
13
+ - Cover both synchronous request-creation failures and asynchronous rejection. Promise rejection handlers alone cannot catch a throw before the promise exists.
14
+ - Ensure every applicable completion path leaves loading state and produces the target's appropriate success, empty, error, or cancellation state.
15
+ - Follow existing request-ownership and cancellation conventions so stale requests do not overwrite newer results or clear their loading state.
16
+ - Handle recognized errors through the target's existing error contract and provide an appropriate fallback for unknown failures. Do not expose raw sensitive responses.
17
+ - Keep shared components independent of application-only clients unless that dependency is an explicit component contract.
18
+
19
+ ## Scope and exceptions
20
+ Apply only to the relevant target surfaces. Preserve explicit local exceptions with scope and rationale; unresolved policy choices require acceptance before normative apply.
21
+
22
+ ## Verification
23
+ Exercise synchronous throws, rejected requests, successful empty and populated results, and overlapping requests where supported. Observe visible loading and error behavior in runtime UI checks; unit tests alone do not prove the rendered experience.
24
+
25
+ ## References
26
+ Use the target rule index, applicable contracts, and existing checks. Bind references during adaptation.
@@ -0,0 +1,25 @@
1
+ ---
2
+ fleet-template: established-ui-primitives
3
+ fleet-source-version: 1
4
+ ---
5
+ # Rule: Reuse established UI primitives
6
+
7
+ Load when building or changing UI controls for which the target has shared visual primitives. Adapt to accepted target policy and tooling; this template is not automatically adopted policy.
8
+
9
+ Disposition: reuse through verified component contracts; exclude mandatory Base components, icon libraries, CSS classes, and claims of automatic accessibility or performance.
10
+
11
+ ## Rules
12
+ - Inspect existing primitives and their actual props, slots, events, semantics, and styling before introducing a parallel control.
13
+ - Prefer an established primitive when it meets the use case. If it does not, explain the gap and follow the target’s extension or exception policy rather than forcing reuse or adding a new library silently.
14
+ - Preserve supported component contracts and use documented customization points; avoid depending on incidental internal markup without an explicit reason.
15
+ - Do not assume a shared component is accessible merely because it exists. Verify labels, focus, keyboard interaction, and relevant states for the actual composition.
16
+ - Reuse does not require every native element to become a component. Retain native semantics and avoid wrappers that add no target-supported value.
17
+
18
+ ## Scope and exceptions
19
+ Apply only to relevant target surfaces. Preserve explicit local exceptions with scope and rationale. Unresolved policy choices require acceptance before normative apply.
20
+
21
+ ## Verification
22
+ Verify component inputs, emitted events, disabled/error states, and rendered accessibility behavior using existing checks and runtime observation. Inspect the consuming composition, not just the primitive’s isolated example. Report any checks not performed.
23
+
24
+ ## References
25
+ Use the target rule index, accepted contracts, and existing checks. Bind references during adaptation.
@@ -0,0 +1,26 @@
1
+ ---
2
+ fleet-template: form-validation
3
+ fleet-source-version: 1
4
+ ---
5
+ # Rule: Consistent form validation
6
+
7
+ Load when adding or changing form validation and input error display. Adapt to the target's accepted contracts and tooling; this template is not automatically adopted policy.
8
+
9
+ Disposition: data-aligned validation, submission guards, and actionable feedback; exclude Vuelidate, UI components, example limits, and source paths.
10
+
11
+ ## Rules
12
+ - Use the existing validation mechanism and align validation with the actual data shape, including nested and dependent fields.
13
+ - Derive required fields and limits from accepted target requirements; do not copy example limits or impose a validation library.
14
+ - Revalidate before submission and prevent invalid submissions. Client-side validation does not replace authoritative server-side validation.
15
+ - Show actionable field errors using established interaction and accessibility conventions. Respect the target's touched/dirty or submission feedback policy rather than imposing universal blur behavior.
16
+ - Keep shared validators in their accepted owner; shared components must not import application-only validation modules.
17
+ - Keep displayed limits and messages consistent with the rules they describe, using existing localization where present.
18
+
19
+ ## Scope and exceptions
20
+ Apply only to the relevant target surfaces. Preserve explicit local exceptions with scope and rationale; unresolved policy choices require acceptance before normative apply.
21
+
22
+ ## Verification
23
+ Test valid and invalid submissions, untouched-field feedback, nested fields, and dependent-value changes as applicable. Check error association and rendered feedback with the target UI verification process; name checks that could not run.
24
+
25
+ ## References
26
+ Use the target rule index, applicable contracts, and existing checks. Bind references during adaptation.
@@ -0,0 +1,25 @@
1
+ ---
2
+ fleet-template: navigation-contracts
3
+ fleet-source-version: 1
4
+ ---
5
+ # Rule: Navigation and URL consistency
6
+
7
+ Load when changing routes, navigation, or query-string handling. Adapt to the target's accepted contracts and tooling; this template is not automatically adopted policy.
8
+
9
+ Disposition: stable navigation contracts and reusable component boundaries; exclude Vue plugins, route paths, and project naming defaults.
10
+
11
+ ## Rules
12
+ - Use the target's existing router and query utilities where applicable; inspect their contracts instead of introducing a parallel parser without need.
13
+ - Preserve established path and query parameter contracts for existing flows. Resolve intended compatibility changes explicitly.
14
+ - Follow accepted route naming conventions; do not import a universal kebab-case or no-hyphen rule.
15
+ - Prefer existing named routes for internal application navigation where supported. Keep shared components independent of an application's route table by using the target's established callbacks or URL inputs.
16
+ - Encode dynamic values through supported routing utilities. Handle navigation failures explicitly; suppress only a recognized benign duplicate-navigation condition when accepted locally, not every error.
17
+
18
+ ## Scope and exceptions
19
+ Apply only to the relevant target surfaces. Preserve explicit local exceptions with scope and rationale; unresolved policy choices require acceptance before normative apply.
20
+
21
+ ## Verification
22
+ Check direct navigation, refresh/deep links, query round trips with encoded values, and back/forward behavior as applicable. Verify shared consumers and distinguish runtime observations from static route checks.
23
+
24
+ ## References
25
+ Use the target rule index, applicable contracts, and existing checks. Bind references during adaptation.
@@ -0,0 +1,25 @@
1
+ ---
2
+ fleet-template: csharp
3
+ fleet-source-version: 1
4
+ ---
5
+ # Rule: C# conventions
6
+
7
+ Load when planning, changing, or reviewing C# code. Adapt this profile to the target's language version, nullable context, and analyzer/editorconfig policy; it is a starting point, not target policy.
8
+
9
+ Disposition: partial extraction — portable contracts kept, project and provider specifics excluded.
10
+
11
+ ## Rules
12
+ - Validate required arguments before dependent work; express optionality and nullability accurately for the target language version and nullable annotations. Use meaningful exception types and messages tied to the failure; do not impose a project validation base class or a shared `IsValid` gate.
13
+ - Use awaitable contracts for asynchronous operations and observe completion and failure. Preserve the target's supported `Task` / `Task<T>` / `ValueTask` contracts and framework event-handler exceptions; do not require every method or every database call to be async merely by category.
14
+ - Dispose resources the code owns according to their lifetime; do not impose a particular context factory and do not dispose externally owned or DI-managed objects.
15
+ - Catch exceptions where there is a concrete handling, translation, or cleanup responsibility. No blanket catch rule by layer, no mandatory try/catch around every body, and no claim that any single call pattern universally prevents deadlocks.
16
+ - Candidate conventions (adopt only what the target's editorconfig/analyzers or an explicit decision select): descriptive identifiers, conventional interface `I-` prefix and `Async` suffix for awaitable methods, built-in type aliases, consistent brace and property layout. Indentation, blank-line counts, and `var` preference follow existing tooling — they are not inherited defaults.
17
+
18
+ ## Scope and exceptions
19
+ Applies to C# sources in the target. Excluded source assumptions, never carried over: project layer suffixes, API route shapes, mapper/repository placement, enum policy, pinned SDK/language versions, and ORM configuration. The target adaptation must name its language version, nullable context, and the analyzer rules actually enforced.
20
+
21
+ ## Verification
22
+ Build the target, run its test suite, and confirm analyzer diagnostics for touched files. Flag version-specific behavior against the installed SDK documentation instead of asserting it.
23
+
24
+ ## References
25
+ Use the target rule index and applicable project documentation. These catalogue paths are *source references*, not target runtime links: replace them with actual `.ai/` references when adapting.
@@ -0,0 +1,25 @@
1
+ ---
2
+ fleet-template: javascript
3
+ fleet-source-version: 1
4
+ ---
5
+ # Rule: JavaScript conventions
6
+
7
+ Load when planning, changing, or reviewing JavaScript code. Adapt this profile to the target's runtime, module system, and formatter/linter; it is a starting point, not target policy.
8
+
9
+ Disposition: partial extraction — portable contracts kept, project and provider specifics excluded.
10
+
11
+ ## Rules
12
+ - Use descriptive, consistent identifiers. Candidate conventions are camelCase functions/variables and PascalCase classes; UPPER_SNAKE_CASE is an optional convention for semantic constants, not for every `const` binding.
13
+ - Preserve module contracts and side-effect import ordering. Import grouping, named/default exports, and quote/indentation choices follow the selected formatter/linter; do not convert exports or reorder side effects for style.
14
+ - Release listeners and timers when their owner no longer needs them. Observe async failures and restore operation state on success and error, using `finally` where appropriate.
15
+ - Document non-obvious behavior and public parameter/return contracts; use JSDoc where applicable without requiring boilerplate for every function.
16
+ - Use dynamic imports only at useful loading boundaries supported by the target build and runtime. Do not impose a bundler, state library, HTTP client, browser-only globals, or a file layout.
17
+
18
+ ## Scope and exceptions
19
+ Applies to JavaScript sources in the target. Excluded source assumptions, never carried over: prescribed bundler or store, concrete HTTP wrapper, browser-only APIs, and file-layout mandates. The target adaptation must name its runtime, module format, and the formatter/linter actually enforced.
20
+
21
+ ## Verification
22
+ Run the target's tests and lint on touched files; confirm no export or import-order change alters runtime behavior. Flag environment-specific behavior against the target runtime instead of asserting it.
23
+
24
+ ## References
25
+ Use the target rule index and applicable project documentation. These catalogue paths are *source references*, not target runtime links: replace them with actual `.ai/` references when adapting.
@@ -0,0 +1,24 @@
1
+ ---
2
+ fleet-template: sql
3
+ fleet-source-version: 1
4
+ ---
5
+ # Rule: SQL change guidance
6
+
7
+ Load when planning, changing, or reviewing database schema or data changes. This is dialect-aware guidance, not a deployment profile: adapt it to the target engine and the repository's established migration mechanism.
8
+
9
+ Disposition: partial extraction — change completeness and verification kept, pipeline and tooling specifics excluded.
10
+
11
+ ## Rules
12
+ - Make type, nullability, key, and relationship choices explicit and compatible with the target engine and existing contracts. No universal surrogate-key type, generated-value strategy, soft delete, audit columns, or fixed string/date types.
13
+ - Design indexes against actual predicates, joins, sorting, and workload; inspect representative plans when claiming performance. Do not mandate an index on every foreign key and do not order composite keys by selectivity alone.
14
+ - Account separately for schema changes and required data/backfill changes. Preserve data and required rolling-deployment compatibility; verify the migration path against the target engine and the repository's established migration mechanism.
15
+ - Make rerun behavior explicit for scripts intended to be repeatable; do not impose idempotency on every once-only migration. Include verification and failure/recovery expectations appropriate to the change.
16
+
17
+ ## Scope and exceptions
18
+ Applies to the target's database changes. Excluded source assumptions, never carried over: schema-layout maps, reference-table bootstraps, project/deployment pipelines, IDE or CI steps, and fixed migration filenames. No single dialect's syntax is normative for other engines. The target adaptation must name its engine, migration tool, and how repeatable versus once-only scripts are distinguished.
19
+
20
+ ## Verification
21
+ Review the migration against a representative database: schema applies cleanly, backfill preserves data, rollback or recovery is stated, and claimed index effects are backed by an actual plan. Flag engine-specific behavior against the target engine's documentation instead of asserting it.
22
+
23
+ ## References
24
+ Use the target rule index and applicable project documentation. These catalogue paths are *source references*, not target runtime links: replace them with actual `.ai/` references when adapting.
@@ -0,0 +1,26 @@
1
+ ---
2
+ fleet-template: authorization-before-effects
3
+ fleet-source-version: 1
4
+ ---
5
+ # Rule: Authorization before side effects
6
+
7
+ Load when changing resource mutations, uploads, deletions, or background actions. Adapt to accepted target policy; this template is not automatically adopted policy.
8
+
9
+ Disposition: retain portable authorization invariants; exclude project helpers, domain types, API-key requirements, prescribed layers, and provider defaults.
10
+
11
+ ## Rules
12
+ - Resolve the actual resource and requested operation through trusted target data; do not treat a supplied identifier as proof of permission.
13
+ - Verify authorization before mutations or other externally visible side effects. Read only the metadata needed for authorization before exposing protected resource content.
14
+ - Deny when required ownership or permissions cannot be established, including unrecognized resource types. Follow the target's established denial contract without leaking protected details.
15
+ - Enforce checks at the target's trusted execution boundary, including background or alternate entry points; a hidden UI control is not an authorization check.
16
+ - Where authorization state can change between checking and writing, use the target's transaction, locking, or conditional-write mechanism to maintain the required invariant. Do not prescribe one concurrency mechanism universally.
17
+ - Reuse accepted access-control policy and explicit exceptions; this rule does not grant access or authorize operational execution.
18
+
19
+ ## Scope and exceptions
20
+ Apply to the target's relevant protected resources. Bind identity, ownership, denial, and privileged-access exceptions to explicit local policy. Unresolved security decisions require acceptance before normative apply.
21
+
22
+ ## Verification
23
+ Test allowed and denied actions, unknown resource types, and failures to resolve ownership. Assert that denied actions produce no mutation or queued side effect. Check alternate execution paths and relevant concurrency cases; report untested invariants.
24
+
25
+ ## References
26
+ Use the target policy index and existing access-control contracts and checks. Keep permission-before-effect checks distinct from tenant-scope propagation; load both when applicable.
@@ -0,0 +1,22 @@
1
+ ---
2
+ fleet-template: diagnostic-data-safety
3
+ fleet-source-version: 1
4
+ ---
5
+ # Rule: Safe diagnostic evidence
6
+
7
+ Load when collecting or sharing logs, screenshots, diagnostic responses, reports, or fixtures.
8
+
9
+ Disposition: retain minimal non-secret collection; exclude provider commands, environments, and credential mappings.
10
+
11
+ ## Rules
12
+ - Collect only information necessary for the diagnostic question. Prefer synthetic fixtures and non-sensitive metadata.
13
+ - Avoid secret-returning endpoints; output redaction alone does not prevent secrets from entering tool results or intermediate artifacts. If safe collection is unavailable, stop and request a safer evidence source.
14
+ - Keep credentials, tokens, connection strings, personal data, and sensitive URL parameters out of reports, screenshots, logs, and committed fixtures. Inspect artifacts before sharing or committing them.
15
+ - Use the target's approved secret-handling mechanism without displaying values. Do not copy raw responses into durable evidence by default.
16
+ - If sensitive information is exposed, stop propagation and follow the target's incident process; redaction is not credential revocation.
17
+
18
+ ## Scope and exceptions
19
+ Applies to diagnostic evidence, not authorization to access systems. Bind classification, storage, retention, and access rules to target policy; ask when unclear. Do not invent retention periods.
20
+
21
+ ## Verification
22
+ Review collection endpoints and selected fields before execution, then inspect produced artifacts for sensitive content. Use existing scanners where available; a clean scanner result does not prove the absence of secrets.
@@ -0,0 +1,25 @@
1
+ ---
2
+ fleet-template: response-data-minimization
3
+ fleet-source-version: 1
4
+ ---
5
+ # Rule: Response-data minimization
6
+
7
+ Load when designing or changing externally exposed responses or their intermediate projections. Adapt to accepted target policy and tooling; this template is not automatically adopted policy.
8
+
9
+ Disposition: intentional field exposure and early minimization; exclude project DTO conventions, domain-specific field lists, and prescribed layers.
10
+
11
+ ## Rules
12
+ - Identify the fields intentionally exposed by the accepted response contract. Prefer explicit selection to serializing internal objects wholesale.
13
+ - Where practical, exclude sensitive and internal-only fields from upstream projections and intermediate response objects rather than relying solely on a final mapper to remove them.
14
+ - Review nested objects, errors, metadata, and debug paths as well as top-level fields. Authorization to access a resource does not authorize disclosure of all its fields.
15
+ - Follow the target’s data classification and explicit exceptions. Do not ban legitimate personal-data responses universally; require an accepted purpose and exposure contract.
16
+ - Keep minimized projections aligned with required behavior and existing query boundaries; do not broaden shared queries or break unrelated consumers as a shortcut.
17
+
18
+ ## Scope and exceptions
19
+ Apply only to relevant target surfaces. Preserve explicit local exceptions with scope and rationale. Unresolved policy choices require acceptance before normative apply.
20
+
21
+ ## Verification
22
+ Assert both required fields and absence of prohibited fields for representative success and error responses, including nested data. Test the actual serialization boundary where available. Report unverified response paths; mapper unit tests alone do not establish end-to-end minimization.
23
+
24
+ ## References
25
+ Use the target rule index, accepted contracts, and existing checks. Bind references during adaptation.
@@ -0,0 +1,26 @@
1
+ ---
2
+ fleet-template: trusted-tenant-scope
3
+ fleet-source-version: 1
4
+ ---
5
+ # Rule: Trusted tenant scope
6
+
7
+ Load when changing tenant-scoped reads, writes, authentication context, or delegated processing. Adapt to accepted target policy; this template is not automatically adopted policy.
8
+
9
+ Disposition: retain portable authorization invariants; exclude project helpers, domain types, API-key requirements, prescribed layers, and provider defaults.
10
+
11
+ ## Rules
12
+ - Derive authorization scope from validated identity and the target's trusted authorization context, not solely from client-supplied tenant identifiers.
13
+ - A client-supplied tenant selector may select only a scope already authorized for that identity. Cross-tenant administration requires an explicit policy and permission, never an implicit bypass.
14
+ - Propagate trusted scope through the target's service, data-access, and background-processing boundaries. Enforce resource ownership where data is returned or changed; authentication at the entry point alone is insufficient.
15
+ - Filter or verify resources through the actual tenant relationship. Deny when ownership cannot be established; do not infer ownership from naming or unrelated identifiers.
16
+ - Keep tenant context isolated between requests and jobs. Scope caches and lookups appropriately so one tenant cannot receive another tenant's data.
17
+ - Follow the target's accepted denial and privacy contract. Do not universally prescribe a status code or reveal whether an out-of-scope resource exists.
18
+
19
+ ## Scope and exceptions
20
+ Apply to the target's relevant protected resources. Bind identity, ownership, denial, and privileged-access exceptions to explicit local policy. Unresolved security decisions require acceptance before normative apply.
21
+
22
+ ## Verification
23
+ Exercise at least two tenant contexts: tampered selectors, cross-tenant resource IDs, authorized access, missing scope, and reused request/job or cache paths where applicable. Assert no cross-tenant data disclosure or mutation. Report gaps rather than treating authentication tests as isolation proof.
24
+
25
+ ## References
26
+ Use the target policy index and existing access-control contracts and checks. Keep permission-before-effect checks distinct from tenant-scope propagation; load both when applicable.
@@ -0,0 +1,25 @@
1
+ ---
2
+ fleet-template: shared-package-consumers
3
+ fleet-source-version: 1
4
+ ---
5
+ # Rule: Shared-package consumer verification
6
+
7
+ Load when changing a reusable package or component consumed by other applications. Adapt to accepted target policy and tooling; this template is not automatically adopted policy.
8
+
9
+ Disposition: consumer-based verification and host contracts; exclude Vue, local file dependency assumptions, and project commands.
10
+
11
+ ## Rules
12
+ - Identify actual consumers and their supported integration contracts, including host plugins, configuration, styles, and build assumptions.
13
+ - Run the package’s existing checks where available. When no standalone build exists, verify through consuming applications instead of inventing a package build merely to claim success.
14
+ - Select affected consumers using evidence. If multiple host configurations differ, cover those relevant differences or explicitly report the uncovered consumers.
15
+ - Check the real consumption mode: source linkage, workspace dependency, or packaged artifact. Success against linked source alone does not establish published-package correctness.
16
+ - Keep shared contracts explicit; a dependency available in one host must not silently become a requirement for every consumer.
17
+
18
+ ## Scope and exceptions
19
+ Apply only to relevant target surfaces. Preserve explicit local exceptions with scope and rationale. Unresolved policy choices require acceptance before normative apply.
20
+
21
+ ## Verification
22
+ Run the narrowest relevant consumer builds/tests and runtime checks for host-dependent behavior. Record consumer, configuration, consumption mode, and result. An isolated package test is not integration proof; distinguish structural tests from observed runtime behavior.
23
+
24
+ ## References
25
+ Use the target rule index, accepted contracts, and existing checks. Bind references during adaptation.
@@ -0,0 +1,24 @@
1
+ ---
2
+ fleet-template: verification-conventions
3
+ fleet-source-version: 1
4
+ ---
5
+ # Rule: Verification conventions
6
+
7
+ Load when a rule, command, or prompt needs an observable check. This template binds policy to the target's actual checkers; it does not duplicate the Fleet testing skills or invent thresholds.
8
+
9
+ Disposition: partial extraction — rule-to-check binding kept; workflow duplication excluded. Testing workflow itself stays with the existing Fleet skills; this file only constrains how rules claim verification.
10
+
11
+ ## Rules
12
+ - Every rule's Verification section names an observable check or an existing checker (test command, linter, type checker, review step). A rule with no available check says so and assigns review responsibility with evidence — it never invents a threshold, coverage number, or gate.
13
+ - Existing quality gates (`quality:` under `## workflows`, CONSTRAINTS.md where present) stay canonical. Setup reads and links them; it introduces no second quality subsystem and no blocking-versus-advisory change without an explicit decision.
14
+ - Blocking checks must already run in the target (CI or task-end command). Advisory observations stay advisory until the target promotes them.
15
+ - Verification of an adaptation inspects meaning as well as placeholders: no imported defaults without target evidence, no invented paths or commands, no dropped applicable constraint.
16
+
17
+ ## Scope and exceptions
18
+ Applies to all target `.ai/` content. Exceptions (checks that are advisory, manual, or owned by review) are named per rule, with owner and reason.
19
+
20
+ ## Verification
21
+ This rule is self-descriptive: confirm each adapted rule links to a real checker or explicitly assigns review. Flag rules whose checks do not exist in the target.
22
+
23
+ ## References
24
+ Use the target rule index, CONSTRAINTS.md where present, and applicable project documentation. These catalogue paths are *source references*, not target runtime links: replace them with actual `.ai/` references when adapting.