@chankov/agent-fleet 0.0.7 → 0.0.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (303) hide show
  1. package/.pi/harnesses/agent-hub/package.json +1 -1
  2. package/.pi/harnesses/coms/package.json +1 -1
  3. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  4. package/.versions/0.0.8/.claude/commands/build.md +44 -0
  5. package/.versions/0.0.8/.claude/commands/code-simplify.md +22 -0
  6. package/.versions/0.0.8/.claude/commands/design-agent.md +14 -0
  7. package/.versions/0.0.8/.claude/commands/doctor-agent-fleet.md +17 -0
  8. package/.versions/0.0.8/.claude/commands/orchestrate.md +112 -0
  9. package/.versions/0.0.8/.claude/commands/plan.md +16 -0
  10. package/.versions/0.0.8/.claude/commands/prime.md +22 -0
  11. package/.versions/0.0.8/.claude/commands/review.md +16 -0
  12. package/.versions/0.0.8/.claude/commands/set-hermes-telegram.md +15 -0
  13. package/.versions/0.0.8/.claude/commands/set-hermes-watchdog.md +6 -0
  14. package/.versions/0.0.8/.claude/commands/setup-agent-fleet.md +25 -0
  15. package/.versions/0.0.8/.claude/commands/ship.md +72 -0
  16. package/.versions/0.0.8/.claude/commands/spec.md +15 -0
  17. package/.versions/0.0.8/.claude/commands/test.md +19 -0
  18. package/.versions/0.0.8/.claude/commands/webperf.md +32 -0
  19. package/.versions/0.0.8/.claude/orchestrate-teams.yaml +24 -0
  20. package/.versions/0.0.8/.opencode/commands/af-build.md +17 -0
  21. package/.versions/0.0.8/.opencode/commands/af-code-simplify.md +16 -0
  22. package/.versions/0.0.8/.opencode/commands/af-compound.md +16 -0
  23. package/.versions/0.0.8/.opencode/commands/af-design-agent.md +15 -0
  24. package/.versions/0.0.8/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  25. package/.versions/0.0.8/.opencode/commands/af-orchestrate.md +112 -0
  26. package/.versions/0.0.8/.opencode/commands/af-plan.md +16 -0
  27. package/.versions/0.0.8/.opencode/commands/af-prime.md +22 -0
  28. package/.versions/0.0.8/.opencode/commands/af-review.md +15 -0
  29. package/.versions/0.0.8/.opencode/commands/af-set-hermes-telegram.md +15 -0
  30. package/.versions/0.0.8/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  31. package/.versions/0.0.8/.opencode/commands/af-setup-agent-fleet.md +15 -0
  32. package/.versions/0.0.8/.opencode/commands/af-ship.md +16 -0
  33. package/.versions/0.0.8/.opencode/commands/af-spec.md +16 -0
  34. package/.versions/0.0.8/.opencode/commands/af-test.md +21 -0
  35. package/.versions/0.0.8/.opencode/commands/af-webperf.md +32 -0
  36. package/.versions/0.0.8/.opencode/orchestrate-teams.yaml +24 -0
  37. package/.versions/0.0.8/.pi/agents/dispatch-policy.yaml +32 -0
  38. package/.versions/0.0.8/.pi/agents/model-profiles.yaml +20 -0
  39. package/.versions/0.0.8/.pi/agents/peers.yaml +146 -0
  40. package/.versions/0.0.8/.pi/agents/teams.yaml +39 -0
  41. package/.versions/0.0.8/.pi/damage-control-rules.yaml +297 -0
  42. package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  43. package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  44. package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  45. package/.versions/0.0.8/.pi/extensions/btw/README.md +118 -0
  46. package/.versions/0.0.8/.pi/extensions/btw/index.ts +917 -0
  47. package/.versions/0.0.8/.pi/extensions/btw/package.json +6 -0
  48. package/.versions/0.0.8/.pi/extensions/btw/state.js +179 -0
  49. package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  50. package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  51. package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  52. package/.versions/0.0.8/.pi/extensions/compact-and-continue/README.md +42 -0
  53. package/.versions/0.0.8/.pi/extensions/compact-and-continue/index.ts +120 -0
  54. package/.versions/0.0.8/.pi/extensions/compact-and-continue/package.json +6 -0
  55. package/.versions/0.0.8/.pi/extensions/mcp-bridge/README.md +46 -0
  56. package/.versions/0.0.8/.pi/extensions/mcp-bridge/index.ts +206 -0
  57. package/.versions/0.0.8/.pi/extensions/mcp-bridge/package.json +6 -0
  58. package/.versions/0.0.8/.pi/extensions/package-lock.json +1143 -0
  59. package/.versions/0.0.8/.pi/extensions/package.json +9 -0
  60. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/README.md +201 -0
  61. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/config.ts +198 -0
  62. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  63. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/index.ts +248 -0
  64. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/package.json +6 -0
  65. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  66. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  67. package/.versions/0.0.8/.pi/harnesses/agent-hub/README.md +857 -0
  68. package/.versions/0.0.8/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  69. package/.versions/0.0.8/.pi/harnesses/agent-hub/artifacts.js +146 -0
  70. package/.versions/0.0.8/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  71. package/.versions/0.0.8/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  72. package/.versions/0.0.8/.pi/harnesses/agent-hub/context-window.js +106 -0
  73. package/.versions/0.0.8/.pi/harnesses/agent-hub/delegate.ts +435 -0
  74. package/.versions/0.0.8/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  75. package/.versions/0.0.8/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  76. package/.versions/0.0.8/.pi/harnesses/agent-hub/footer.ts +29 -0
  77. package/.versions/0.0.8/.pi/harnesses/agent-hub/helpers.ts +248 -0
  78. package/.versions/0.0.8/.pi/harnesses/agent-hub/index.ts +8609 -0
  79. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  80. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  81. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  82. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  83. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  84. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  85. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  86. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  87. package/.versions/0.0.8/.pi/harnesses/agent-hub/package.json +7 -0
  88. package/.versions/0.0.8/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  89. package/.versions/0.0.8/.pi/harnesses/agent-hub/research-retention.js +34 -0
  90. package/.versions/0.0.8/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  91. package/.versions/0.0.8/.pi/harnesses/agent-hub/return-contract.js +293 -0
  92. package/.versions/0.0.8/.pi/harnesses/agent-hub/return-extract.js +75 -0
  93. package/.versions/0.0.8/.pi/harnesses/agent-hub/run-budget.js +181 -0
  94. package/.versions/0.0.8/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  95. package/.versions/0.0.8/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  96. package/.versions/0.0.8/.pi/harnesses/agent-hub/session-health.js +110 -0
  97. package/.versions/0.0.8/.pi/harnesses/agent-hub/spawn.ts +354 -0
  98. package/.versions/0.0.8/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
  99. package/.versions/0.0.8/.pi/harnesses/agent-hub/version.ts +18 -0
  100. package/.versions/0.0.8/.pi/harnesses/ask-user-remote/README.md +19 -0
  101. package/.versions/0.0.8/.pi/harnesses/ask-user-remote/index.ts +321 -0
  102. package/.versions/0.0.8/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  103. package/.versions/0.0.8/.pi/harnesses/coms/README.md +93 -0
  104. package/.versions/0.0.8/.pi/harnesses/coms/index.ts +1767 -0
  105. package/.versions/0.0.8/.pi/harnesses/coms/package.json +7 -0
  106. package/.versions/0.0.8/.pi/harnesses/coms/version.ts +18 -0
  107. package/.versions/0.0.8/.pi/harnesses/damage-control-continue/README.md +117 -0
  108. package/.versions/0.0.8/.pi/harnesses/damage-control-continue/index.ts +536 -0
  109. package/.versions/0.0.8/.pi/harnesses/damage-control-continue/package.json +7 -0
  110. package/.versions/0.0.8/.pi/harnesses/damage-control-continue/version.ts +18 -0
  111. package/.versions/0.0.8/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  112. package/.versions/0.0.8/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  113. package/.versions/0.0.8/.pi/harnesses/lib/herdr-client.ts +463 -0
  114. package/.versions/0.0.8/.pi/harnesses/lib/herdr-presence.ts +399 -0
  115. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  116. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  117. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  118. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  119. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  120. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  121. package/.versions/0.0.8/.pi/harnesses/package-lock.json +35 -0
  122. package/.versions/0.0.8/.pi/harnesses/package.json +9 -0
  123. package/.versions/0.0.8/.pi/prompts/af-build.md +24 -0
  124. package/.versions/0.0.8/.pi/prompts/af-code-simplify.md +22 -0
  125. package/.versions/0.0.8/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  126. package/.versions/0.0.8/.pi/prompts/af-plan.md +16 -0
  127. package/.versions/0.0.8/.pi/prompts/af-review.md +16 -0
  128. package/.versions/0.0.8/.pi/prompts/af-set-hermes-telegram.md +15 -0
  129. package/.versions/0.0.8/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  130. package/.versions/0.0.8/.pi/prompts/af-setup-agent-fleet.md +27 -0
  131. package/.versions/0.0.8/.pi/prompts/af-ship.md +17 -0
  132. package/.versions/0.0.8/.pi/prompts/af-spec.md +15 -0
  133. package/.versions/0.0.8/.pi/prompts/af-test.md +19 -0
  134. package/.versions/0.0.8/.pi/skills/bowser/SKILL.md +145 -0
  135. package/.versions/0.0.8/.version +1 -0
  136. package/.versions/0.0.8/agents/architect.md +23 -0
  137. package/.versions/0.0.8/agents/bowser.md +26 -0
  138. package/.versions/0.0.8/agents/builder.md +53 -0
  139. package/.versions/0.0.8/agents/code-reviewer.md +205 -0
  140. package/.versions/0.0.8/agents/deep-researcher.md +31 -0
  141. package/.versions/0.0.8/agents/documenter.md +18 -0
  142. package/.versions/0.0.8/agents/orchestrator.md +65 -0
  143. package/.versions/0.0.8/agents/plan-reviewer.md +60 -0
  144. package/.versions/0.0.8/agents/planner.md +69 -0
  145. package/.versions/0.0.8/agents/releaser.md +24 -0
  146. package/.versions/0.0.8/agents/researcher.md +28 -0
  147. package/.versions/0.0.8/agents/security-auditor.md +166 -0
  148. package/.versions/0.0.8/agents/test-engineer.md +151 -0
  149. package/.versions/0.0.8/agents/web-debugger.md +42 -0
  150. package/.versions/0.0.8/agents/web-performance-auditor.md +192 -0
  151. package/.versions/0.0.8/codex/CONDUCTOR.md +148 -0
  152. package/.versions/0.0.8/docs/ARCHITECTURE.md +262 -0
  153. package/.versions/0.0.8/docs/agent-fleet-setup.md +366 -0
  154. package/.versions/0.0.8/docs/claude-code-coms-bridge.md +109 -0
  155. package/.versions/0.0.8/docs/codex-remote-conductor.md +170 -0
  156. package/.versions/0.0.8/docs/coms-hermes-bridge.md +189 -0
  157. package/.versions/0.0.8/docs/getting-started.md +231 -0
  158. package/.versions/0.0.8/docs/npm-install.md +337 -0
  159. package/.versions/0.0.8/docs/opencode-setup.md +249 -0
  160. package/.versions/0.0.8/docs/pi-extensions.md +293 -0
  161. package/.versions/0.0.8/docs/pi-setup.md +476 -0
  162. package/.versions/0.0.8/docs/skill-anatomy.md +150 -0
  163. package/.versions/0.0.8/hermes/README.md +347 -0
  164. package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  165. package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  166. package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  167. package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  168. package/.versions/0.0.8/hermes/gates/gate-o-capability.md +8 -0
  169. package/.versions/0.0.8/hermes/gates/gate-o-validator-fixtures.json +1 -0
  170. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  171. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  172. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  173. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  174. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  175. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  176. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  177. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  178. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  179. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  180. package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  181. package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  182. package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  183. package/.versions/0.0.8/hermes/skills/hub-conductor/SKILL.md +84 -0
  184. package/.versions/0.0.8/hermes/skills/hub-liaison/SKILL.md +84 -0
  185. package/.versions/0.0.8/hermes/skills/hub-watchdog/SKILL.md +76 -0
  186. package/.versions/0.0.8/hermes/skills/hub-watchdog/manifest.json +1 -0
  187. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  188. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  189. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  190. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  191. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  192. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  193. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  194. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  195. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  196. package/.versions/0.0.8/hermes/watchdog-tests/__init__.py +0 -0
  197. package/.versions/0.0.8/hooks/SIMPLIFY-IGNORE.md +90 -0
  198. package/.versions/0.0.8/hooks/coms-stop-hook.mjs +84 -0
  199. package/.versions/0.0.8/hooks/hooks.json +14 -0
  200. package/.versions/0.0.8/hooks/session-start.sh +74 -0
  201. package/.versions/0.0.8/hooks/simplify-ignore.sh +302 -0
  202. package/.versions/0.0.8/justfile +245 -0
  203. package/.versions/0.0.8/references/accessibility-checklist.md +160 -0
  204. package/.versions/0.0.8/references/definition-of-done.md +67 -0
  205. package/.versions/0.0.8/references/fleet-coordination-patterns.md +151 -0
  206. package/.versions/0.0.8/references/observability-checklist.md +91 -0
  207. package/.versions/0.0.8/references/orchestration-patterns.md +370 -0
  208. package/.versions/0.0.8/references/performance-checklist.md +153 -0
  209. package/.versions/0.0.8/references/prompting-patterns.md +380 -0
  210. package/.versions/0.0.8/references/security-checklist.md +179 -0
  211. package/.versions/0.0.8/references/testing-patterns.md +236 -0
  212. package/.versions/0.0.8/scripts/codex-conductor.ts +41 -0
  213. package/.versions/0.0.8/scripts/codex-remote-control.ts +167 -0
  214. package/.versions/0.0.8/scripts/coms-claude-bridge.ts +401 -0
  215. package/.versions/0.0.8/scripts/coms-cli.ts +484 -0
  216. package/.versions/0.0.8/scripts/coms-hermes-bridge.ts +413 -0
  217. package/.versions/0.0.8/scripts/fleet.ts +149 -0
  218. package/.versions/0.0.8/scripts/hermes-monitor-capability-runner.ts +25 -0
  219. package/.versions/0.0.8/scripts/hermes-monitor-scenario.ts +474 -0
  220. package/.versions/0.0.8/scripts/hermes-watchdog-capability-probe.ts +45 -0
  221. package/.versions/0.0.8/scripts/install-hermes-plugin.sh +180 -0
  222. package/.versions/0.0.8/scripts/lib/claude-bridge-core.ts +165 -0
  223. package/.versions/0.0.8/scripts/lib/codex-conductor.ts +88 -0
  224. package/.versions/0.0.8/scripts/lib/codex-remote-control.ts +480 -0
  225. package/.versions/0.0.8/scripts/lib/coms-envelope.ts +582 -0
  226. package/.versions/0.0.8/scripts/lib/fake-herdr-server.ts +88 -0
  227. package/.versions/0.0.8/scripts/lib/fleet-command.ts +109 -0
  228. package/.versions/0.0.8/scripts/lib/herdr-layout.ts +263 -0
  229. package/.versions/0.0.8/scripts/lib/hermes-bridge-core.ts +241 -0
  230. package/.versions/0.0.8/scripts/lib/hermes-monitor-events.ts +1 -0
  231. package/.versions/0.0.8/scripts/lib/hermes-monitor-herdr.ts +2 -0
  232. package/.versions/0.0.8/scripts/lib/hermes-monitor-model.ts +3 -0
  233. package/.versions/0.0.8/scripts/lib/hermes-monitor-registry.ts +2 -0
  234. package/.versions/0.0.8/scripts/lib/hermes-monitor-socket.ts +2 -0
  235. package/.versions/0.0.8/scripts/lib/hermes-monitor-store.ts +2 -0
  236. package/.versions/0.0.8/scripts/lib/monitor-env.ts +120 -0
  237. package/.versions/0.0.8/scripts/lib/persona-banner.ts +62 -0
  238. package/.versions/0.0.8/scripts/lib/spawn-stagger.ts +101 -0
  239. package/.versions/0.0.8/scripts/lib/team-project.ts +191 -0
  240. package/.versions/0.0.8/scripts/lib/team-snapshot.ts +147 -0
  241. package/.versions/0.0.8/scripts/peer-banner.ts +40 -0
  242. package/.versions/0.0.8/scripts/team-snapshot.ts +237 -0
  243. package/.versions/0.0.8/scripts/team-up.ts +360 -0
  244. package/.versions/0.0.8/skills/_internal/grilling.md +11 -0
  245. package/.versions/0.0.8/skills/browser-testing-with-devtools/SKILL.md +352 -0
  246. package/.versions/0.0.8/skills/code-review-and-quality/SKILL.md +381 -0
  247. package/.versions/0.0.8/skills/compound-learning/SKILL.md +137 -0
  248. package/.versions/0.0.8/skills/context-engineering/SKILL.md +291 -0
  249. package/.versions/0.0.8/skills/deprecation-and-migration/SKILL.md +206 -0
  250. package/.versions/0.0.8/skills/designing-agents/SKILL.md +394 -0
  251. package/.versions/0.0.8/skills/designing-agents/pi-harness-authoring.md +222 -0
  252. package/.versions/0.0.8/skills/frontend-ui-engineering/SKILL.md +328 -0
  253. package/.versions/0.0.8/skills/git-workflow-and-versioning/SKILL.md +316 -0
  254. package/.versions/0.0.8/skills/guided-workspace-setup/SKILL.md +544 -0
  255. package/.versions/0.0.8/skills/guided-workspace-setup/companion-manifest.json +36 -0
  256. package/.versions/0.0.8/skills/idea-refine/SKILL.md +182 -0
  257. package/.versions/0.0.8/skills/idea-refine/examples.md +238 -0
  258. package/.versions/0.0.8/skills/idea-refine/frameworks.md +99 -0
  259. package/.versions/0.0.8/skills/idea-refine/refinement-criteria.md +113 -0
  260. package/.versions/0.0.8/skills/idea-refine/scripts/idea-refine.sh +15 -0
  261. package/.versions/0.0.8/skills/incremental-implementation/SKILL.md +287 -0
  262. package/.versions/0.0.8/skills/interview-me/SKILL.md +226 -0
  263. package/.versions/0.0.8/skills/orchestration-verification/SKILL.md +181 -0
  264. package/.versions/0.0.8/skills/peer-coms/SKILL.md +90 -0
  265. package/.versions/0.0.8/skills/performance-optimization/SKILL.md +350 -0
  266. package/.versions/0.0.8/skills/planning-and-task-breakdown/SKILL.md +236 -0
  267. package/.versions/0.0.8/skills/security-and-hardening/SKILL.md +461 -0
  268. package/.versions/0.0.8/skills/spec-driven-development/SKILL.md +245 -0
  269. package/.versions/0.0.8/skills/using-agent-skills/SKILL.md +199 -0
  270. package/.versions/0.0.8/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  271. package/.versions/0.0.8/vendor/agent-skills-upstream/LICENSE +21 -0
  272. package/.versions/0.0.8/vendor/agent-skills-upstream/README.md +11 -0
  273. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  274. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  275. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  276. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  277. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  278. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  279. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  280. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  281. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  282. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  283. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  284. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  285. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  286. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  287. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  288. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  289. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  290. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  291. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  292. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  293. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  294. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  295. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  296. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  297. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  298. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  299. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  300. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  301. package/CHANGELOG.md +6 -0
  302. package/package.json +1 -1
  303. package/skills/guided-workspace-setup/companion-manifest.json +1 -0
@@ -0,0 +1,103 @@
1
+ """Exact-generation surgical transaction. No retargeting, retries, or shell execution."""
2
+ import time
3
+
4
+ from watchdog_actions import transport_identity
5
+
6
+ TERMINAL = {'completed', 'failed', 'cancelled', 'orphaned'}
7
+ IDENTITY_KEYS = ('profileKey', 'hubInstanceId', 'ownerSessionId')
8
+ CANCEL_TIMEOUT_SECONDS = 15
9
+
10
+
11
+ def _identity_bound(tx, api):
12
+ """Exact identity is mandatory; a missing field is a refusal, not a wildcard."""
13
+ identity = transport_identity(api)
14
+ for key in IDENTITY_KEYS:
15
+ value = tx.get(key)
16
+ if not isinstance(value, str) or not value:
17
+ return False
18
+ if identity.get(key) != value:
19
+ return False
20
+ return True
21
+
22
+
23
+ def _compare_and_swap(tx, api):
24
+ """
25
+ Fresh snapshot read before every step. Returns ('ok', exact_row),
26
+ ('superseded', None) when an N+1 generation exists, or ('refused', None).
27
+ """
28
+ rows = api.snapshot(tx['taskId'])
29
+ if not isinstance(rows, list):
30
+ return 'refused', None
31
+ if any(isinstance(row, dict) and row.get('generation', 0) > tx['generation'] for row in rows):
32
+ return 'superseded', None
33
+ exact = next((row for row in rows if isinstance(row, dict) and row.get('generation') == tx['generation']), None)
34
+ if not isinstance(exact, dict):
35
+ return 'refused', None
36
+ if exact.get('ownerSessionId') != tx['ownerSessionId']:
37
+ return 'refused', None
38
+ return 'ok', exact
39
+
40
+
41
+ def _start_cancel(tx, api, now, persist):
42
+ """Persist the proposal, re-check the generation, then cancel exactly N."""
43
+ if persist is None:
44
+ return {**tx, 'state': 'refused'}
45
+ try:
46
+ persist({'decision': 'recovery_proposed', 'hubInstanceId': tx['hubInstanceId'],
47
+ 'taskRef': {'taskId': tx['taskId'], 'generation': tx['generation']}})
48
+ except Exception:
49
+ return {**tx, 'state': 'refused'}
50
+ verdict, _ = _compare_and_swap(tx, api)
51
+ if verdict != 'ok':
52
+ return {**tx, 'state': verdict}
53
+ result = api.cancel(tx['taskId'], tx['generation'])
54
+ if not isinstance(result, dict) or not result.get('cancelled'):
55
+ return {**tx, 'state': 'refused'}
56
+ return {**tx, 'state': 'cancelling', 'cancelStartedAt': now}
57
+
58
+
59
+ def _observe_cancel(tx, api, now):
60
+ """Wait for the exact generation to reach a terminal state, bounded by a timeout."""
61
+ verdict, exact = _compare_and_swap(tx, api)
62
+ if verdict != 'ok':
63
+ return {**tx, 'state': verdict}
64
+ if exact.get('state') in TERMINAL:
65
+ return {**tx, 'state': 'cancel_observed'}
66
+ if now - tx.get('cancelStartedAt', now) >= CANCEL_TIMEOUT_SECONDS:
67
+ return {**tx, 'state': 'timed_out'}
68
+ return tx
69
+
70
+
71
+ def _enqueue_recovery(tx, api):
72
+ """One recovery enqueue, gated on a fresh no-N+1 terminal observation."""
73
+ verdict, exact = _compare_and_swap(tx, api)
74
+ if verdict != 'ok':
75
+ return {**tx, 'state': verdict}
76
+ if exact.get('state') not in TERMINAL:
77
+ return {**tx, 'state': 'refused'}
78
+ outcome = api.invoke_recovery(tx['taskId'], tx['generation'])
79
+ if isinstance(outcome, dict) and outcome.get('status') in ('accepted', 'duplicate'):
80
+ return {**tx, 'state': 'recovery_queued'}
81
+ return {**tx, 'state': 'refused'}
82
+
83
+
84
+ def recover(tx, api, allowlist, gate_o, now=None, persist=None):
85
+ """
86
+ Advance the local recovery state machine by exactly one step. Terminal
87
+ states are absorbing, so a restart can never repeat a completed step.
88
+ """
89
+ now = time.monotonic() if now is None else now
90
+ if not gate_o or tx.get('taskId') not in allowlist or tx.get('kind') != 'native':
91
+ return {**tx, 'state': 'refused'}
92
+ if not isinstance(tx.get('generation'), int) or tx['generation'] <= 0:
93
+ return {**tx, 'state': 'refused'}
94
+ if not _identity_bound(tx, api):
95
+ return {**tx, 'state': 'refused'}
96
+ state = tx.get('state', 'proposed')
97
+ if state == 'proposed':
98
+ return _start_cancel(tx, api, now, persist)
99
+ if state == 'cancelling':
100
+ return _observe_cancel(tx, api, now)
101
+ if state == 'cancel_observed':
102
+ return _enqueue_recovery(tx, api)
103
+ return tx
@@ -0,0 +1,163 @@
1
+ """Private, owner-only watcher state and append-only decision audit."""
2
+ import hashlib
3
+ import json
4
+ import os
5
+ import stat
6
+ import tempfile
7
+ from datetime import datetime, timedelta, timezone
8
+ from pathlib import Path
9
+
10
+ AUDIT_LIMIT = 1000
11
+ AUDIT_DAYS = 7
12
+
13
+
14
+ def _safe(path):
15
+ path = Path(path)
16
+ if path.exists():
17
+ mode = path.lstat().st_mode
18
+ if stat.S_ISLNK(mode) or not stat.S_ISREG(mode) or mode & 0o077:
19
+ raise ValueError('unsafe_state')
20
+
21
+
22
+ def _safe_parent(path):
23
+ parent = Path(path).parent
24
+ parent.mkdir(mode=0o700, parents=True, exist_ok=True)
25
+ mode = parent.lstat().st_mode
26
+ if stat.S_ISLNK(mode) or not stat.S_ISDIR(mode) or mode & 0o077:
27
+ raise ValueError('unsafe_state')
28
+
29
+
30
+ def atomic_json(path, value):
31
+ path = Path(path)
32
+ _safe_parent(path)
33
+ _safe(path)
34
+ fd, temporary = tempfile.mkstemp(dir=path.parent)
35
+ try:
36
+ os.fchmod(fd, 0o600)
37
+ with os.fdopen(fd, 'w', encoding='utf-8') as stream:
38
+ json.dump(value, stream, sort_keys=True, separators=(',', ':'))
39
+ stream.flush()
40
+ os.fsync(stream.fileno())
41
+ os.replace(temporary, path)
42
+ os.chmod(path, 0o600)
43
+ directory = os.open(path.parent, os.O_RDONLY)
44
+ try:
45
+ os.fsync(directory)
46
+ finally:
47
+ os.close(directory)
48
+ finally:
49
+ if os.path.exists(temporary):
50
+ os.unlink(temporary)
51
+
52
+
53
+ def load_json(path):
54
+ _safe(path)
55
+ return json.loads(Path(path).read_text(encoding='utf-8'))
56
+
57
+
58
+ def _audit_record(record, previous, sequence):
59
+ if not isinstance(record, dict):
60
+ raise ValueError('sensitive_audit')
61
+ # Store only correlation and decision fields: no raw route/output/prompt/token fields.
62
+ allowed = {'watchId', 'hubInstanceId', 'taskRef', 'eventIds', 'deviation', 'tier',
63
+ 'decision', 'requestId', 'parametersDigest', 'recoveryState', 'occurredAt'}
64
+ if set(record) - allowed:
65
+ raise ValueError('sensitive_audit')
66
+ task = record.get('taskRef')
67
+ if task is not None and (not isinstance(task, dict) or set(task) - {'taskId', 'generation'}):
68
+ raise ValueError('sensitive_audit')
69
+ event_ids = record.get('eventIds')
70
+ if event_ids is not None and (not isinstance(event_ids, list) or not all(isinstance(item, str) for item in event_ids)):
71
+ raise ValueError('sensitive_audit')
72
+ clean = {key: value for key, value in record.items() if value is not None}
73
+ clean.update({'schema': 'agent-fleet.watchdog-audit', 'schemaVersion': 1,
74
+ 'authority': 'watcher_decision_trace', 'auditSequence': sequence,
75
+ 'occurredAt': clean.get('occurredAt') or datetime.now(timezone.utc).isoformat().replace('+00:00', 'Z'),
76
+ 'previousHash': previous})
77
+ body = json.dumps(clean, sort_keys=True, separators=(',', ':'))
78
+ clean['recordHash'] = 'sha256:' + hashlib.sha256((previous + body).encode()).hexdigest()
79
+ return clean
80
+
81
+
82
+ def _read_audit(path):
83
+ _safe(path)
84
+ if not Path(path).exists():
85
+ return []
86
+ rows = []
87
+ previous = ''
88
+ for index, line in enumerate(Path(path).read_text(encoding='utf-8').splitlines(), 1):
89
+ try:
90
+ row = json.loads(line)
91
+ if row.get('previousHash') != previous or not isinstance(row.get('recordHash'), str):
92
+ raise ValueError('audit_tampered')
93
+ copy = dict(row); actual = copy.pop('recordHash')
94
+ body = json.dumps(copy, sort_keys=True, separators=(',', ':'))
95
+ expected = 'sha256:' + hashlib.sha256((previous + body).encode()).hexdigest()
96
+ if actual != expected:
97
+ raise ValueError('audit_tampered')
98
+ previous = actual
99
+ rows.append(row)
100
+ except (ValueError, json.JSONDecodeError) as error:
101
+ # A final torn line is recoverable only if it is the final physical record.
102
+ if index and index == len(Path(path).read_text(encoding='utf-8').splitlines()) and not line.strip():
103
+ break
104
+ raise ValueError('audit_tampered') from error
105
+ return rows
106
+
107
+
108
+ def _retain(rows):
109
+ cutoff = datetime.now(timezone.utc) - timedelta(days=AUDIT_DAYS)
110
+ retained = []
111
+ for row in rows:
112
+ try:
113
+ timestamp = datetime.fromisoformat(row['occurredAt'].replace('Z', '+00:00'))
114
+ except (KeyError, ValueError):
115
+ raise ValueError('audit_tampered')
116
+ pending = row.get('recoveryState') in {'proposed', 'cancelling', 'cancel_observed'}
117
+ if pending or timestamp >= cutoff:
118
+ retained.append(row)
119
+ normal = [row for row in retained if row.get('recoveryState') not in {'proposed', 'cancelling', 'cancel_observed'}]
120
+ pending = [row for row in retained if row not in normal]
121
+ return pending + normal[-AUDIT_LIMIT:]
122
+
123
+
124
+ def _rehash(rows):
125
+ """Compaction creates a new self-contained chain; never retain a deleted predecessor hash."""
126
+ previous = ''
127
+ compacted = []
128
+ for row in rows:
129
+ copy = dict(row)
130
+ copy.pop('recordHash', None)
131
+ copy['previousHash'] = previous
132
+ body = json.dumps(copy, sort_keys=True, separators=(',', ':'))
133
+ copy['recordHash'] = 'sha256:' + hashlib.sha256((previous + body).encode()).hexdigest()
134
+ previous = copy['recordHash']
135
+ compacted.append(copy)
136
+ return compacted
137
+
138
+
139
+ def audit(path, record, previous=''):
140
+ """Append one fsynced hash-linked NDJSON record and return its record hash."""
141
+ path = Path(path)
142
+ _safe_parent(path)
143
+ rows = _read_audit(path)
144
+ prior = rows[-1]['recordHash'] if rows else previous
145
+ row = _audit_record(record, prior, len(rows) + 1)
146
+ rows = _retain(rows + [row])
147
+ # Rewrite atomically so compaction cannot leave a partially appended chain.
148
+ # If records were removed their old predecessor is gone, therefore re-link.
149
+ rows = _rehash(rows)
150
+ payload = '\n'.join(json.dumps(item, sort_keys=True, separators=(',', ':')) for item in rows) + '\n'
151
+ fd, temporary = tempfile.mkstemp(dir=path.parent)
152
+ try:
153
+ os.fchmod(fd, 0o600)
154
+ with os.fdopen(fd, 'w', encoding='utf-8') as stream:
155
+ stream.write(payload); stream.flush(); os.fsync(stream.fileno())
156
+ os.replace(temporary, path); os.chmod(path, 0o600)
157
+ finally:
158
+ if os.path.exists(temporary): os.unlink(temporary)
159
+ return row['recordHash']
160
+
161
+
162
+ def profile_root(base, profile):
163
+ return Path(base) / hashlib.sha256(profile.encode()).hexdigest()
@@ -0,0 +1,138 @@
1
+ """Owner-safe, stdlib-only monitor discovery and newline JSON UDS transport."""
2
+ import json
3
+ import socket
4
+ from pathlib import Path
5
+
6
+ from watchdog_contract import MAX_FRAME, safe_file, validate_discovery
7
+
8
+ MAX_RESPONSE = 2 * 1024 * 1024
9
+
10
+ class TransportError(RuntimeError):
11
+ pass
12
+
13
+ def discover(runtime_dir, profile_key, hub_key, now):
14
+ """Read exactly one registry discovery entry; never scan arbitrary runtime roots."""
15
+ root = Path(runtime_dir)
16
+ if not root.is_absolute() or root.is_symlink() or not root.is_dir() or root.stat().st_mode & 0o077:
17
+ raise TransportError('unsafe_runtime')
18
+ if not all(isinstance(key, str) and len(key) == 64 and all(char in '0123456789abcdef' for char in key) for key in (profile_key, hub_key)):
19
+ raise TransportError('discovery')
20
+ namespace = root / profile_key / hub_key
21
+ try:
22
+ if namespace.is_symlink() or not namespace.is_dir() or namespace.stat().st_mode & 0o077:
23
+ raise ValueError('discovery')
24
+ entries = sorted(namespace.glob('discovery-*.json'))
25
+ if len(entries) != 1:
26
+ raise ValueError('discovery')
27
+ metadata = safe_file(entries[0], root)
28
+ value = validate_discovery(root, json.loads(metadata.read_text()), now)
29
+ token_path = safe_file(namespace / value['token'], root)
30
+ token = token_path.read_text().strip()
31
+ if not token:
32
+ raise ValueError('discovery')
33
+ prefix = '@runtime/'
34
+ if not value['socket'].startswith(prefix):
35
+ raise ValueError('discovery')
36
+ socket_path = root / value['socket'][len(prefix):]
37
+ if socket_path.parent.is_symlink() or socket_path.parent.parent != root / 's':
38
+ raise ValueError('discovery')
39
+ return {**value, 'token': token, 'socketPath': str(socket_path), 'namespacePath': str(namespace),
40
+ 'profileKey': profile_key, 'hubKey': hub_key}
41
+ except (OSError, ValueError, json.JSONDecodeError) as error:
42
+ raise TransportError(str(error) if str(error) in ('expired', 'unsafe_file', 'path_escape') else 'discovery') from error
43
+
44
+ def request(socket_path, token, payload, timeout=5):
45
+ if not isinstance(token, str) or not token:
46
+ raise TransportError('token')
47
+ data = json.dumps({**payload, 'token': token}, separators=(',', ':')).encode() + b'\n'
48
+ if len(data) > MAX_FRAME:
49
+ raise TransportError('frame_too_large')
50
+ client = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
51
+ client.settimeout(timeout)
52
+ try:
53
+ client.connect(socket_path)
54
+ client.sendall(data)
55
+ chunks, total = [], 0
56
+ while True:
57
+ block = client.recv(4096)
58
+ if not block:
59
+ break
60
+ total += len(block)
61
+ if total > MAX_RESPONSE:
62
+ raise TransportError('response_too_large')
63
+ chunks.append(block)
64
+ if b'\n' in block:
65
+ break
66
+ try:
67
+ response = json.loads(b''.join(chunks).split(b'\n', 1)[0])
68
+ except Exception as error:
69
+ raise TransportError('malformed_response') from error
70
+ if not response.get('ok'):
71
+ raise TransportError(response.get('error', 'monitor_unavailable'))
72
+ return response
73
+ except OSError as error:
74
+ raise TransportError('offline') from error
75
+ finally:
76
+ client.close()
77
+
78
+ class MonitorTransport:
79
+ """Bounded, authenticated UDS adapter; token is retained only in this instance."""
80
+ def __init__(self, discovery, timeout=5):
81
+ self.owner = discovery['owner']
82
+ # Identity comes from validated discovery so admission can cross-check
83
+ # a request against the Hub it actually reached, not a config copy.
84
+ self.profile_key = discovery.get('profileKey')
85
+ self.hub_instance_id = (discovery.get('lease') or {}).get('hub')
86
+ self.socket_path = discovery['socketPath']
87
+ self._token = discovery['token']
88
+ self.timeout = timeout
89
+
90
+ def _call(self, payload, timeout=None):
91
+ return request(self.socket_path, self._token, payload, self.timeout if timeout is None else timeout)
92
+
93
+ def events(self, cursor, limit=50, wait_ms=2000):
94
+ """
95
+ Long-poll for events. The read timeout must cover the wait window the
96
+ Hub was asked to hold, otherwise every poll would expire locally and be
97
+ journaled as an outage. The window stays short so a foreground SIGINT
98
+ is observed promptly.
99
+ """
100
+ wait_ms = min(max(0, wait_ms), 25000)
101
+ response = self._call({'type': 'events', 'afterSequence': cursor, 'limit': min(max(1, limit), 100),
102
+ 'waitMs': wait_ms}, timeout=self.timeout + wait_ms / 1000)
103
+ return response.get('events', response)
104
+
105
+ def snapshot(self, task_id=None):
106
+ response = self._call({'type': 'snapshot'})
107
+ if task_id is None:
108
+ return response
109
+ snapshot = response.get('snapshot', response)
110
+ tasks = snapshot.get('tasks', []) if isinstance(snapshot, dict) else []
111
+ return [item for item in tasks if isinstance(item, dict) and item.get('id') == task_id]
112
+
113
+ def invoke(self, payload):
114
+ return self._call({**payload, 'type': 'invoke'})
115
+
116
+ def cancel(self, task_id, generation):
117
+ return self._call({'type': 'cancel', 'taskId': task_id, 'generation': generation})
118
+
119
+ def invoke_recovery(self, task_id, generation):
120
+ request = {'taskId': task_id, 'generation': generation, 'action': 'request_status',
121
+ 'profileKey': self.profile_key, 'ownerSessionId': self.owner,
122
+ 'hubInstanceId': self.hub_instance_id,
123
+ 'parameters': {'assertionIds': [], 'evidenceEventIds': [],
124
+ 'instruction': 'Изпълни ограничено безопасно възстановяване и докладвай доказателства.'},
125
+ 'basis': {'deviation': 'stalled_progress', 'judgment': 'confirmed'}}
126
+ canonical = json.dumps(request, sort_keys=True, separators=(',', ':')).encode()
127
+ request['requestId'] = 'recovery:' + __import__('hashlib').sha256(canonical).hexdigest()
128
+ return self.invoke(request)
129
+
130
+
131
+ def reconcile(transport, cursor):
132
+ try:
133
+ return transport.events(cursor)
134
+ except TransportError as error:
135
+ if str(error) not in ('cursor_too_old', 'owner_changed'):
136
+ raise
137
+ snapshot = transport.snapshot()
138
+ return {'snapshot': snapshot, 'events': [], 'cursor': 0, 'reconciled': True}
@@ -0,0 +1,90 @@
1
+ # simplify-ignore hook
2
+
3
+ Block-level protection for `/code-simplify`. Mark code that should never be simplified — the model won't see it.
4
+
5
+ ## Setup
6
+
7
+ 1. Annotate blocks you want to protect:
8
+
9
+ ```js
10
+ /* simplify-ignore-start: perf-critical */
11
+ // manually unrolled XOR — 3x faster than a loop
12
+ result[0] = buf[0] ^ key[0];
13
+ result[1] = buf[1] ^ key[1];
14
+ result[2] = buf[2] ^ key[2];
15
+ result[3] = buf[3] ^ key[3];
16
+ /* simplify-ignore-end */
17
+ ```
18
+
19
+ 2. Add hooks to `.claude/settings.json`:
20
+
21
+ ```json
22
+ {
23
+ "hooks": {
24
+ "PreToolUse": [
25
+ {
26
+ "matcher": "Read",
27
+ "hooks": [{ "type": "command", "command": "bash ${CLAUDE_PROJECT_DIR}/hooks/simplify-ignore.sh" }]
28
+ }
29
+ ],
30
+ "PostToolUse": [
31
+ {
32
+ "matcher": "Edit|Write",
33
+ "hooks": [{ "type": "command", "command": "bash ${CLAUDE_PROJECT_DIR}/hooks/simplify-ignore.sh" }]
34
+ }
35
+ ],
36
+ "Stop": [
37
+ {
38
+ "hooks": [{ "type": "command", "command": "bash ${CLAUDE_PROJECT_DIR}/hooks/simplify-ignore.sh" }]
39
+ }
40
+ ]
41
+ }
42
+ }
43
+ ```
44
+
45
+ 3. Run `/code-simplify` — protected blocks become `/* BLOCK_de115a1d: perf-critical */` placeholders. The model reasons about surrounding code without seeing the protected implementation.
46
+
47
+ > **Note:** The hook stores temporary backups in `.claude/.simplify-ignore-cache/`. Make sure this path is in your `.gitignore`.
48
+
49
+ ## How it works
50
+
51
+ One script, three hook events:
52
+
53
+ | Event | Action |
54
+ |---|---|
55
+ | `PreToolUse Read` | Backs up file, replaces blocks with `BLOCK_<hash>` placeholders in-place |
56
+ | `PostToolUse Edit\|Write` | Expands placeholders back to real code, saves model's changes, re-filters |
57
+ | `Stop` | Restores all files from backup when session ends |
58
+
59
+ Each block is content-hashed (8 hex chars via `shasum`/`sha1sum`) so the round-trip is unambiguous even if the model duplicates or reorders placeholders. Cache is project-scoped to prevent cross-session interference.
60
+
61
+ ## Annotation syntax
62
+
63
+ ```js
64
+ /* simplify-ignore-start */ // basic — hides the block
65
+ /* simplify-ignore-start: reason */ // with reason — appears in placeholder
66
+ /* simplify-ignore-end */
67
+ ```
68
+
69
+ Any comment style works (`//`, `/*`, `#`, `<!--`). Multiple blocks per file and single-line blocks supported. Placeholders preserve the original comment syntax (e.g. `# BLOCK_xxx` for Python, `<!-- BLOCK_xxx -->` for HTML).
70
+
71
+ ## Crash recovery
72
+
73
+ If Claude Code crashes without triggering the Stop hook, files on disk may still have `BLOCK_<hash>` placeholders. To restore manually:
74
+
75
+ ```bash
76
+ echo '{}' | bash hooks/simplify-ignore.sh
77
+ ```
78
+
79
+ Backups are stored in `.claude/.simplify-ignore-cache/` within your project directory.
80
+
81
+ ## Known limitations
82
+
83
+ - **Single-line blocks hide the entire line.** If `simplify-ignore-start` and `simplify-ignore-end` appear on the same line as other code, the whole line is hidden from the model, not just the annotated portion. Use dedicated lines for annotations.
84
+ - **Comment suffix detection covers `*/` and `-->` only.** Template engines with non-standard comment closers (ERB `%>`, Blade `--}}`) may produce unbalanced placeholders. Use `#` or `//` style comments instead.
85
+ - **Fallback expansion is progressive, not exact.** If the model alters a placeholder's formatting (e.g. changes the reason text), the hook tries progressively simpler matches: full placeholder → prefix+hash+suffix → hash-only. The hash-only fallback may leave cosmetic debris (e.g. stray `:` or reason text). A warning is printed to stderr when this happens.
86
+ - **File renaming leaves placeholders.** If the model renames or moves a file via a shell command, the new file will retain `BLOCK_<hash>` placeholders. The original code is saved as `<old-filename>.recovered` when the session stops. You must manually restore the recovered code into the new file.
87
+
88
+ ## Requirements
89
+
90
+ - `jq`, `shasum` or `sha1sum` (auto-detected), Bash 3.2+
@@ -0,0 +1,84 @@
1
+ #!/usr/bin/env node
2
+ // hooks/coms-stop-hook.mjs — Claude Code Stop hook for the coms bridge.
3
+ //
4
+ // Writes the final assistant message of each turn to the file the
5
+ // coms-claude-bridge watches (~/.pi/coms/claude-bridge/<pane>/last-message.json,
6
+ // keyed by HERDR_PANE_ID), making the hook the bridge's PRIMARY completion
7
+ // path (exact text, no pane scraping). Outside a herdr pane it does nothing.
8
+ //
9
+ // Install (project or user settings.json):
10
+ // {
11
+ // "hooks": {
12
+ // "Stop": [{ "hooks": [{ "type": "command",
13
+ // "command": "node /path/to/agent-fleet/hooks/coms-stop-hook.mjs" }] }]
14
+ // }
15
+ // }
16
+ //
17
+ // The hook receives {session_id, transcript_path, …} as JSON on stdin and
18
+ // must never fail the turn: every error path exits 0.
19
+
20
+ import * as fs from "node:fs";
21
+ import * as os from "node:os";
22
+ import * as path from "node:path";
23
+
24
+ function lastAssistantText(transcriptPath) {
25
+ const raw = fs.readFileSync(transcriptPath, "utf-8");
26
+ let text = null;
27
+ for (const line of raw.split("\n")) {
28
+ if (!line.trim()) continue;
29
+ let entry;
30
+ try {
31
+ entry = JSON.parse(line);
32
+ } catch {
33
+ continue;
34
+ }
35
+ if (entry?.type !== "assistant") continue;
36
+ const content = entry?.message?.content;
37
+ if (!Array.isArray(content)) continue;
38
+ const parts = content.filter((c) => c?.type === "text" && typeof c.text === "string").map((c) => c.text);
39
+ if (parts.length > 0) text = parts.join("\n");
40
+ }
41
+ return text;
42
+ }
43
+
44
+ try {
45
+ const paneId = process.env.HERDR_PANE_ID;
46
+ if (!paneId) process.exit(0); // not in a herdr pane — nothing to bridge
47
+
48
+ const input = JSON.parse(fs.readFileSync(0, "utf-8"));
49
+ const transcriptPath = input?.transcript_path;
50
+ if (!transcriptPath || !fs.existsSync(transcriptPath)) process.exit(0);
51
+
52
+ const text = lastAssistantText(transcriptPath);
53
+ if (text == null) process.exit(0);
54
+
55
+ const dir = path.join(
56
+ os.homedir(),
57
+ ".pi",
58
+ "coms",
59
+ "claude-bridge",
60
+ paneId.replace(/[^A-Za-z0-9_-]/g, "_"),
61
+ );
62
+ fs.mkdirSync(dir, { recursive: true });
63
+ const file = path.join(dir, "last-message.json");
64
+ const tmp = `${file}.tmp-${process.pid}`;
65
+ // `transcript_path` is written for the Hermes fleet panel, which reads this
66
+ // file to find which ~/.claude/projects/*.jsonl belongs to a bridged peer.
67
+ // The bridge mints its own coms session id and has no other link to Claude
68
+ // Code's, so without this the panel could only guess by cwd — and a cwd
69
+ // routinely holds several transcripts. The bridge ignores the extra key
70
+ // (HookRecord carries an index signature).
71
+ fs.writeFileSync(
72
+ tmp,
73
+ JSON.stringify({
74
+ text,
75
+ session_id: input.session_id ?? null,
76
+ transcript_path: transcriptPath,
77
+ written_at: new Date().toISOString(),
78
+ }),
79
+ );
80
+ fs.renameSync(tmp, file);
81
+ } catch {
82
+ // never fail the turn
83
+ }
84
+ process.exit(0);
@@ -0,0 +1,14 @@
1
+ {
2
+ "hooks": {
3
+ "SessionStart": [
4
+ {
5
+ "hooks": [
6
+ {
7
+ "type": "command",
8
+ "command": "SCRIPT=\"${CLAUDE_PLUGIN_ROOT}/hooks/session-start.sh\"; [ -f \"$SCRIPT\" ] || SCRIPT=\"${CLAUDE_PROJECT_DIR}/.claude/hooks/session-start.sh\"; [ -f \"$SCRIPT\" ]&& bash \"$SCRIPT\" || true"
9
+ }
10
+ ]
11
+ }
12
+ ]
13
+ }
14
+ }
@@ -0,0 +1,74 @@
1
+ #!/bin/bash
2
+ # agent-fleet session start hook (Claude Code).
3
+ #
4
+ # Two responsibilities:
5
+ # 1. Inject the using-agent-skills meta-skill into the session context so
6
+ # Claude can route tasks to the right skill.
7
+ # 2. Surface a one-line "update available" banner when the installed
8
+ # package is behind the published version on npm.
9
+ #
10
+ # Both are best-effort. Network errors, missing files, and missing tools
11
+ # never block session start — the hook always exits 0 and prints a valid
12
+ # JSON object on stdout.
13
+
14
+ SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
15
+ PACKAGE_ROOT="$(dirname "$SCRIPT_DIR")"
16
+ SKILLS_DIR="$PACKAGE_ROOT/skills"
17
+ META_SKILL="$SKILLS_DIR/using-agent-skills/SKILL.md"
18
+ CHECK_SCRIPT="$PACKAGE_ROOT/bin/cli.js"
19
+
20
+ # ── 1. Meta-skill content ────────────────────────────────────────────────
21
+ if [ -f "$META_SKILL" ]; then
22
+ META_CONTENT=$(cat "$META_SKILL")
23
+ PRIORITY="IMPORTANT"
24
+ BASE_MESSAGE="agent-fleet loaded. Use the skill discovery flowchart to find the right skill for your task."
25
+ else
26
+ META_CONTENT=""
27
+ PRIORITY="INFO"
28
+ BASE_MESSAGE="agent-fleet: using-agent-skills meta-skill not found. Skills may still be available individually."
29
+ fi
30
+
31
+ # ── 2. Update banner (silent on any error) ───────────────────────────────
32
+ UPDATE_BANNER=""
33
+ if [ "$AGENT_SKILLS_NO_UPDATE_CHECK" != "1" ] \
34
+ && [ "$NO_UPDATE_NOTIFIER" != "1" ] \
35
+ && [ "$CI" != "true" ] \
36
+ && command -v node >/dev/null 2>&1 \
37
+ && [ -f "$CHECK_SCRIPT" ]; then
38
+ # Run with a 3-second wall-clock cap so a hung registry never stalls the
39
+ # session. The check-update subcommand emits the banner on stdout when an
40
+ # upgrade is available, nothing otherwise. Errors go to /dev/null.
41
+ if command -v timeout >/dev/null 2>&1; then
42
+ UPDATE_BANNER=$(timeout 3 node "$CHECK_SCRIPT" check-update 2>/dev/null || true)
43
+ else
44
+ UPDATE_BANNER=$(node "$CHECK_SCRIPT" check-update 2>/dev/null || true)
45
+ fi
46
+ fi
47
+
48
+ # ── Compose the message ──────────────────────────────────────────────────
49
+ FULL_MESSAGE="$BASE_MESSAGE"
50
+ if [ -n "$UPDATE_BANNER" ]; then
51
+ FULL_MESSAGE=$(printf '%s\n\n%s' "$FULL_MESSAGE" "$UPDATE_BANNER")
52
+ fi
53
+ if [ -n "$META_CONTENT" ]; then
54
+ FULL_MESSAGE=$(printf '%s\n\n%s' "$FULL_MESSAGE" "$META_CONTENT")
55
+ fi
56
+
57
+ # ── Emit JSON (node handles escaping correctly) ──────────────────────────
58
+ if command -v node >/dev/null 2>&1; then
59
+ printf '%s' "$FULL_MESSAGE" | node -e '
60
+ let msg = "";
61
+ process.stdin.setEncoding("utf8");
62
+ process.stdin.on("data", c => { msg += c; });
63
+ process.stdin.on("end", () => {
64
+ process.stdout.write(JSON.stringify({
65
+ priority: process.env.PRIORITY || "INFO",
66
+ message: msg,
67
+ }) + "\n");
68
+ });
69
+ '
70
+ else
71
+ # Fallback: ship just the base message with minimal escaping.
72
+ SAFE_MSG=$(printf '%s' "$BASE_MESSAGE" | sed 's/\\/\\\\/g; s/"/\\"/g')
73
+ printf '{"priority": "%s", "message": "%s"}\n' "$PRIORITY" "$SAFE_MSG"
74
+ fi