@chankov/agent-fleet 1.0.1 → 1.0.2

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 (316) hide show
  1. package/.pi/extensions/package-lock.json +77 -45
  2. package/.pi/harnesses/agent-hub/README.md +109 -18
  3. package/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  4. package/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  5. package/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  6. package/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  7. package/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  8. package/.pi/harnesses/agent-hub/hub-state-audit.js +18 -0
  9. package/.pi/harnesses/agent-hub/index.ts +988 -422
  10. package/.pi/harnesses/agent-hub/package.json +1 -1
  11. package/.pi/harnesses/agent-hub/posture.ts +72 -17
  12. package/.pi/harnesses/agent-hub/run-budget.js +12 -13
  13. package/.pi/harnesses/agent-hub/spawn.ts +14 -2
  14. package/.pi/harnesses/ask-user-remote/index.ts +59 -4
  15. package/.pi/harnesses/coms/package.json +1 -1
  16. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  17. package/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  18. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  19. package/.pi/harnesses/lib/context-budget-view.ts +107 -0
  20. package/.pi/harnesses/lib/context-budget.ts +114 -0
  21. package/.pi/harnesses/lib/fleet-detail-view.ts +92 -2
  22. package/.pi/harnesses/package-lock.json +73 -80
  23. package/.versions/1.0.2/.pi/agents/dispatch-policy.yaml +32 -0
  24. package/.versions/1.0.2/.pi/agents/model-profiles.yaml +27 -0
  25. package/.versions/1.0.2/.pi/agents/peers.yaml +142 -0
  26. package/.versions/1.0.2/.pi/agents/teams.yaml +41 -0
  27. package/.versions/1.0.2/.pi/damage-control-rules.yaml +297 -0
  28. package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  29. package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  30. package/.versions/1.0.2/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  31. package/.versions/1.0.2/.pi/extensions/btw/README.md +120 -0
  32. package/.versions/1.0.2/.pi/extensions/btw/index.ts +914 -0
  33. package/.versions/1.0.2/.pi/extensions/btw/package.json +6 -0
  34. package/.versions/1.0.2/.pi/extensions/btw/state.js +179 -0
  35. package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  36. package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  37. package/.versions/1.0.2/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  38. package/.versions/1.0.2/.pi/extensions/compact-and-continue/README.md +42 -0
  39. package/.versions/1.0.2/.pi/extensions/compact-and-continue/index.ts +120 -0
  40. package/.versions/1.0.2/.pi/extensions/compact-and-continue/package.json +6 -0
  41. package/.versions/1.0.2/.pi/extensions/mcp-bridge/README.md +46 -0
  42. package/.versions/1.0.2/.pi/extensions/mcp-bridge/index.ts +206 -0
  43. package/.versions/1.0.2/.pi/extensions/mcp-bridge/package.json +6 -0
  44. package/.versions/1.0.2/.pi/extensions/package-lock.json +1175 -0
  45. package/.versions/1.0.2/.pi/extensions/package.json +9 -0
  46. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/README.md +205 -0
  47. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/config.ts +198 -0
  48. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  49. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/index.ts +248 -0
  50. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/package.json +6 -0
  51. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  52. package/.versions/1.0.2/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  53. package/.versions/1.0.2/.pi/harnesses/agent-hub/README.md +1156 -0
  54. package/.versions/1.0.2/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  55. package/.versions/1.0.2/.pi/harnesses/agent-hub/artifacts.js +146 -0
  56. package/.versions/1.0.2/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  57. package/.versions/1.0.2/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  58. package/.versions/1.0.2/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  59. package/.versions/1.0.2/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  60. package/.versions/1.0.2/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  61. package/.versions/1.0.2/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  62. package/.versions/1.0.2/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  63. package/.versions/1.0.2/.pi/harnesses/agent-hub/context-window.js +106 -0
  64. package/.versions/1.0.2/.pi/harnesses/agent-hub/delegate.ts +435 -0
  65. package/.versions/1.0.2/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  66. package/.versions/1.0.2/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  67. package/.versions/1.0.2/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  68. package/.versions/1.0.2/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  69. package/.versions/1.0.2/.pi/harnesses/agent-hub/footer.ts +35 -0
  70. package/.versions/1.0.2/.pi/harnesses/agent-hub/helpers.ts +266 -0
  71. package/.versions/1.0.2/.pi/harnesses/agent-hub/hub-state-audit.js +73 -0
  72. package/.versions/1.0.2/.pi/harnesses/agent-hub/index.ts +9909 -0
  73. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  74. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  75. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  76. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  77. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  78. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  79. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  80. package/.versions/1.0.2/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  81. package/.versions/1.0.2/.pi/harnesses/agent-hub/package.json +7 -0
  82. package/.versions/1.0.2/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  83. package/.versions/1.0.2/.pi/harnesses/agent-hub/posture.ts +158 -0
  84. package/.versions/1.0.2/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  85. package/.versions/1.0.2/.pi/harnesses/agent-hub/research-retention.js +34 -0
  86. package/.versions/1.0.2/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  87. package/.versions/1.0.2/.pi/harnesses/agent-hub/return-contract.js +293 -0
  88. package/.versions/1.0.2/.pi/harnesses/agent-hub/return-extract.js +75 -0
  89. package/.versions/1.0.2/.pi/harnesses/agent-hub/review-findings.js +102 -0
  90. package/.versions/1.0.2/.pi/harnesses/agent-hub/run-budget.js +539 -0
  91. package/.versions/1.0.2/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  92. package/.versions/1.0.2/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  93. package/.versions/1.0.2/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  94. package/.versions/1.0.2/.pi/harnesses/agent-hub/session-health.js +110 -0
  95. package/.versions/1.0.2/.pi/harnesses/agent-hub/spawn.ts +366 -0
  96. package/.versions/1.0.2/.pi/harnesses/agent-hub/version.ts +42 -0
  97. package/.versions/1.0.2/.pi/harnesses/ask-user-remote/README.md +53 -0
  98. package/.versions/1.0.2/.pi/harnesses/ask-user-remote/index.ts +532 -0
  99. package/.versions/1.0.2/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  100. package/.versions/1.0.2/.pi/harnesses/coms/README.md +100 -0
  101. package/.versions/1.0.2/.pi/harnesses/coms/index.ts +1767 -0
  102. package/.versions/1.0.2/.pi/harnesses/coms/package.json +7 -0
  103. package/.versions/1.0.2/.pi/harnesses/coms/version.ts +42 -0
  104. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/README.md +124 -0
  105. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/index.ts +536 -0
  106. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/package.json +7 -0
  107. package/.versions/1.0.2/.pi/harnesses/damage-control-continue/version.ts +42 -0
  108. package/.versions/1.0.2/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  109. package/.versions/1.0.2/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  110. package/.versions/1.0.2/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  111. package/.versions/1.0.2/.pi/harnesses/lib/context-budget-view.ts +107 -0
  112. package/.versions/1.0.2/.pi/harnesses/lib/context-budget.ts +114 -0
  113. package/.versions/1.0.2/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  114. package/.versions/1.0.2/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  115. package/.versions/1.0.2/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  116. package/.versions/1.0.2/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  117. package/.versions/1.0.2/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  118. package/.versions/1.0.2/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  119. package/.versions/1.0.2/.pi/harnesses/lib/fleet-detail-view.ts +133 -0
  120. package/.versions/1.0.2/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  121. package/.versions/1.0.2/.pi/harnesses/lib/fleet-panel.ts +34 -0
  122. package/.versions/1.0.2/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  123. package/.versions/1.0.2/.pi/harnesses/lib/fleet-selection.ts +24 -0
  124. package/.versions/1.0.2/.pi/harnesses/lib/herdr-client.ts +472 -0
  125. package/.versions/1.0.2/.pi/harnesses/lib/herdr-presence.ts +399 -0
  126. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  127. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  128. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  129. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  130. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  131. package/.versions/1.0.2/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  132. package/.versions/1.0.2/.pi/harnesses/lib/spawned-peers.js +190 -0
  133. package/.versions/1.0.2/.pi/harnesses/package-lock.json +2039 -0
  134. package/.versions/1.0.2/.pi/harnesses/package.json +10 -0
  135. package/.versions/1.0.2/.pi/prompts/af-build.md +24 -0
  136. package/.versions/1.0.2/.pi/prompts/af-code-simplify.md +22 -0
  137. package/.versions/1.0.2/.pi/prompts/af-plan.md +16 -0
  138. package/.versions/1.0.2/.pi/prompts/af-review.md +16 -0
  139. package/.versions/1.0.2/.pi/prompts/af-set-hermes-telegram.md +15 -0
  140. package/.versions/1.0.2/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  141. package/.versions/1.0.2/.pi/prompts/af-ship.md +17 -0
  142. package/.versions/1.0.2/.pi/prompts/af-spec.md +15 -0
  143. package/.versions/1.0.2/.pi/prompts/af-test.md +19 -0
  144. package/.versions/1.0.2/.pi/skills/bowser/SKILL.md +145 -0
  145. package/.versions/1.0.2/.version +1 -0
  146. package/.versions/1.0.2/agents/architect.md +24 -0
  147. package/.versions/1.0.2/agents/bowser.md +27 -0
  148. package/.versions/1.0.2/agents/builder.md +54 -0
  149. package/.versions/1.0.2/agents/code-reviewer.md +208 -0
  150. package/.versions/1.0.2/agents/deep-researcher.md +32 -0
  151. package/.versions/1.0.2/agents/documenter.md +18 -0
  152. package/.versions/1.0.2/agents/orchestrator.md +20 -0
  153. package/.versions/1.0.2/agents/plan-reviewer.md +83 -0
  154. package/.versions/1.0.2/agents/planner.md +70 -0
  155. package/.versions/1.0.2/agents/releaser.md +24 -0
  156. package/.versions/1.0.2/agents/researcher.md +28 -0
  157. package/.versions/1.0.2/agents/security-auditor.md +167 -0
  158. package/.versions/1.0.2/agents/test-engineer.md +153 -0
  159. package/.versions/1.0.2/agents/web-debugger.md +43 -0
  160. package/.versions/1.0.2/agents/web-performance-auditor.md +193 -0
  161. package/.versions/1.0.2/bin/catalog/harness-runtime-closure.json +38 -0
  162. package/.versions/1.0.2/codex/CONDUCTOR.md +148 -0
  163. package/.versions/1.0.2/docs/ARCHITECTURE.md +369 -0
  164. package/.versions/1.0.2/docs/agent-fleet-setup.md +468 -0
  165. package/.versions/1.0.2/docs/claude-code-coms-bridge.md +128 -0
  166. package/.versions/1.0.2/docs/codex-remote-conductor.md +170 -0
  167. package/.versions/1.0.2/docs/coms-hermes-bridge.md +189 -0
  168. package/.versions/1.0.2/docs/getting-started.md +98 -0
  169. package/.versions/1.0.2/docs/npm-install.md +292 -0
  170. package/.versions/1.0.2/docs/pi-extensions.md +439 -0
  171. package/.versions/1.0.2/docs/pi-setup.md +74 -0
  172. package/.versions/1.0.2/docs/skill-anatomy.md +150 -0
  173. package/.versions/1.0.2/hermes/README.md +347 -0
  174. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  175. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  176. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  177. package/.versions/1.0.2/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  178. package/.versions/1.0.2/hermes/gates/gate-o-capability.md +8 -0
  179. package/.versions/1.0.2/hermes/gates/gate-o-validator-fixtures.json +1 -0
  180. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  181. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  182. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  183. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  184. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  185. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  186. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  187. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  188. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  189. package/.versions/1.0.2/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  190. package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  191. package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  192. package/.versions/1.0.2/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  193. package/.versions/1.0.2/hermes/skills/hub-conductor/SKILL.md +84 -0
  194. package/.versions/1.0.2/hermes/skills/hub-liaison/SKILL.md +84 -0
  195. package/.versions/1.0.2/hermes/skills/hub-watchdog/SKILL.md +76 -0
  196. package/.versions/1.0.2/hermes/skills/hub-watchdog/manifest.json +1 -0
  197. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  198. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  199. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  200. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  201. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  202. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  203. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  204. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  205. package/.versions/1.0.2/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  206. package/.versions/1.0.2/hermes/watchdog-tests/__init__.py +0 -0
  207. package/.versions/1.0.2/hooks/coms-stop-hook.mjs +84 -0
  208. package/.versions/1.0.2/install-manifest.json +2745 -0
  209. package/.versions/1.0.2/justfile +272 -0
  210. package/.versions/1.0.2/manifest-meta.json +882 -0
  211. package/.versions/1.0.2/references/accessibility-checklist.md +160 -0
  212. package/.versions/1.0.2/references/definition-of-done.md +67 -0
  213. package/.versions/1.0.2/references/fleet-coordination-patterns.md +151 -0
  214. package/.versions/1.0.2/references/observability-checklist.md +91 -0
  215. package/.versions/1.0.2/references/orchestration-patterns.md +370 -0
  216. package/.versions/1.0.2/references/performance-checklist.md +153 -0
  217. package/.versions/1.0.2/references/prompting-patterns.md +380 -0
  218. package/.versions/1.0.2/references/security-checklist.md +179 -0
  219. package/.versions/1.0.2/references/testing-patterns.md +236 -0
  220. package/.versions/1.0.2/scripts/codex-conductor.ts +41 -0
  221. package/.versions/1.0.2/scripts/codex-remote-control.ts +167 -0
  222. package/.versions/1.0.2/scripts/coms-claude-bridge.ts +411 -0
  223. package/.versions/1.0.2/scripts/coms-cli.ts +484 -0
  224. package/.versions/1.0.2/scripts/coms-hermes-bridge.ts +413 -0
  225. package/.versions/1.0.2/scripts/fleet.ts +185 -0
  226. package/.versions/1.0.2/scripts/hermes-monitor-capability-runner.ts +25 -0
  227. package/.versions/1.0.2/scripts/hermes-monitor-scenario.ts +474 -0
  228. package/.versions/1.0.2/scripts/hermes-watchdog-capability-probe.ts +45 -0
  229. package/.versions/1.0.2/scripts/install-hermes-plugin.sh +180 -0
  230. package/.versions/1.0.2/scripts/lib/claude-bridge-core.ts +210 -0
  231. package/.versions/1.0.2/scripts/lib/codex-conductor.ts +88 -0
  232. package/.versions/1.0.2/scripts/lib/codex-remote-control.ts +480 -0
  233. package/.versions/1.0.2/scripts/lib/coms-envelope.ts +582 -0
  234. package/.versions/1.0.2/scripts/lib/fake-herdr-server.ts +88 -0
  235. package/.versions/1.0.2/scripts/lib/fleet-command.ts +266 -0
  236. package/.versions/1.0.2/scripts/lib/herdr-layout.ts +281 -0
  237. package/.versions/1.0.2/scripts/lib/hermes-bridge-core.ts +241 -0
  238. package/.versions/1.0.2/scripts/lib/hermes-monitor-events.ts +1 -0
  239. package/.versions/1.0.2/scripts/lib/hermes-monitor-herdr.ts +2 -0
  240. package/.versions/1.0.2/scripts/lib/hermes-monitor-model.ts +3 -0
  241. package/.versions/1.0.2/scripts/lib/hermes-monitor-registry.ts +2 -0
  242. package/.versions/1.0.2/scripts/lib/hermes-monitor-socket.ts +2 -0
  243. package/.versions/1.0.2/scripts/lib/hermes-monitor-store.ts +2 -0
  244. package/.versions/1.0.2/scripts/lib/monitor-env.ts +146 -0
  245. package/.versions/1.0.2/scripts/lib/peer-launch.ts +318 -0
  246. package/.versions/1.0.2/scripts/lib/persona-banner.ts +62 -0
  247. package/.versions/1.0.2/scripts/lib/spawn-stagger.ts +101 -0
  248. package/.versions/1.0.2/scripts/lib/team-project.ts +213 -0
  249. package/.versions/1.0.2/scripts/lib/team-snapshot.ts +147 -0
  250. package/.versions/1.0.2/scripts/peer-banner.ts +40 -0
  251. package/.versions/1.0.2/scripts/peer-launch.ts +259 -0
  252. package/.versions/1.0.2/scripts/team-snapshot.ts +237 -0
  253. package/.versions/1.0.2/scripts/team-up.ts +406 -0
  254. package/.versions/1.0.2/skills/_internal/grilling.md +11 -0
  255. package/.versions/1.0.2/skills/browser-testing-with-devtools/SKILL.md +351 -0
  256. package/.versions/1.0.2/skills/code-review-and-quality/SKILL.md +381 -0
  257. package/.versions/1.0.2/skills/compound-learning/SKILL.md +137 -0
  258. package/.versions/1.0.2/skills/context-engineering/SKILL.md +291 -0
  259. package/.versions/1.0.2/skills/deprecation-and-migration/SKILL.md +206 -0
  260. package/.versions/1.0.2/skills/designing-agents/SKILL.md +394 -0
  261. package/.versions/1.0.2/skills/designing-agents/pi-harness-authoring.md +222 -0
  262. package/.versions/1.0.2/skills/frontend-ui-engineering/SKILL.md +328 -0
  263. package/.versions/1.0.2/skills/git-workflow-and-versioning/SKILL.md +316 -0
  264. package/.versions/1.0.2/skills/idea-refine/SKILL.md +182 -0
  265. package/.versions/1.0.2/skills/idea-refine/examples.md +238 -0
  266. package/.versions/1.0.2/skills/idea-refine/frameworks.md +99 -0
  267. package/.versions/1.0.2/skills/idea-refine/refinement-criteria.md +113 -0
  268. package/.versions/1.0.2/skills/idea-refine/scripts/idea-refine.sh +15 -0
  269. package/.versions/1.0.2/skills/incremental-implementation/SKILL.md +287 -0
  270. package/.versions/1.0.2/skills/interview-me/SKILL.md +226 -0
  271. package/.versions/1.0.2/skills/orchestration-verification/SKILL.md +181 -0
  272. package/.versions/1.0.2/skills/peer-coms/SKILL.md +90 -0
  273. package/.versions/1.0.2/skills/performance-optimization/SKILL.md +350 -0
  274. package/.versions/1.0.2/skills/planning-and-task-breakdown/SKILL.md +254 -0
  275. package/.versions/1.0.2/skills/security-and-hardening/SKILL.md +461 -0
  276. package/.versions/1.0.2/skills/spec-driven-development/SKILL.md +257 -0
  277. package/.versions/1.0.2/skills/using-agent-skills/SKILL.md +199 -0
  278. package/.versions/1.0.2/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  279. package/.versions/1.0.2/vendor/agent-skills-upstream/LICENSE +21 -0
  280. package/.versions/1.0.2/vendor/agent-skills-upstream/README.md +11 -0
  281. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  282. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  283. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  284. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  285. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  286. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  287. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  288. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  289. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  290. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  291. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  292. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  293. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  294. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  295. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  296. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  297. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  298. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  299. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  300. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  301. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  302. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  303. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  304. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  305. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  306. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  307. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  308. package/.versions/1.0.2/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  309. package/CHANGELOG.md +9 -0
  310. package/README.md +4 -2
  311. package/agents/orchestrator.md +4 -56
  312. package/docs/ARCHITECTURE.md +48 -16
  313. package/docs/agent-fleet-setup.md +33 -2
  314. package/docs/pi-extensions.md +29 -2
  315. package/install-manifest.json +2 -2
  316. package/package.json +2 -2
@@ -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,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);