@chankov/agent-fleet 1.0.3 → 1.0.4

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 (310) hide show
  1. package/.pi/harnesses/agent-hub/README.md +25 -11
  2. package/.pi/harnesses/agent-hub/delegate.ts +14 -3
  3. package/.pi/harnesses/agent-hub/index.ts +212 -40
  4. package/.pi/harnesses/agent-hub/package.json +1 -1
  5. package/.pi/harnesses/agent-hub/spawn.ts +25 -3
  6. package/.pi/harnesses/coms/package.json +1 -1
  7. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  8. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +2 -2
  9. package/.pi/harnesses/lib/fleet-detail-view.ts +95 -16
  10. package/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  11. package/.pi/prompts/af-plan.md +6 -5
  12. package/.versions/1.0.4/.pi/agents/dispatch-policy.yaml +32 -0
  13. package/.versions/1.0.4/.pi/agents/model-profiles.yaml +27 -0
  14. package/.versions/1.0.4/.pi/agents/peers.yaml +142 -0
  15. package/.versions/1.0.4/.pi/agents/teams.yaml +41 -0
  16. package/.versions/1.0.4/.pi/damage-control-rules.yaml +297 -0
  17. package/.versions/1.0.4/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  18. package/.versions/1.0.4/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  19. package/.versions/1.0.4/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  20. package/.versions/1.0.4/.pi/extensions/btw/README.md +120 -0
  21. package/.versions/1.0.4/.pi/extensions/btw/index.ts +914 -0
  22. package/.versions/1.0.4/.pi/extensions/btw/package.json +6 -0
  23. package/.versions/1.0.4/.pi/extensions/btw/state.js +179 -0
  24. package/.versions/1.0.4/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  25. package/.versions/1.0.4/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  26. package/.versions/1.0.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  27. package/.versions/1.0.4/.pi/extensions/compact-and-continue/README.md +42 -0
  28. package/.versions/1.0.4/.pi/extensions/compact-and-continue/index.ts +120 -0
  29. package/.versions/1.0.4/.pi/extensions/compact-and-continue/package.json +6 -0
  30. package/.versions/1.0.4/.pi/extensions/mcp-bridge/README.md +46 -0
  31. package/.versions/1.0.4/.pi/extensions/mcp-bridge/index.ts +206 -0
  32. package/.versions/1.0.4/.pi/extensions/mcp-bridge/package.json +6 -0
  33. package/.versions/1.0.4/.pi/extensions/package-lock.json +1175 -0
  34. package/.versions/1.0.4/.pi/extensions/package.json +9 -0
  35. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/README.md +205 -0
  36. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/config.ts +198 -0
  37. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  38. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
  39. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/package.json +6 -0
  40. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  41. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  42. package/.versions/1.0.4/.pi/harnesses/agent-hub/README.md +1170 -0
  43. package/.versions/1.0.4/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  44. package/.versions/1.0.4/.pi/harnesses/agent-hub/artifacts.js +146 -0
  45. package/.versions/1.0.4/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  46. package/.versions/1.0.4/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  47. package/.versions/1.0.4/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  48. package/.versions/1.0.4/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  49. package/.versions/1.0.4/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  50. package/.versions/1.0.4/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  51. package/.versions/1.0.4/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  52. package/.versions/1.0.4/.pi/harnesses/agent-hub/context-window.js +106 -0
  53. package/.versions/1.0.4/.pi/harnesses/agent-hub/delegate.ts +446 -0
  54. package/.versions/1.0.4/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  55. package/.versions/1.0.4/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  56. package/.versions/1.0.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  57. package/.versions/1.0.4/.pi/harnesses/agent-hub/execution-profile.ts +69 -0
  58. package/.versions/1.0.4/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  59. package/.versions/1.0.4/.pi/harnesses/agent-hub/footer.ts +36 -0
  60. package/.versions/1.0.4/.pi/harnesses/agent-hub/helpers.ts +266 -0
  61. package/.versions/1.0.4/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  62. package/.versions/1.0.4/.pi/harnesses/agent-hub/index.ts +10171 -0
  63. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  64. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  65. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  66. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  67. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  68. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  69. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  70. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  71. package/.versions/1.0.4/.pi/harnesses/agent-hub/package.json +7 -0
  72. package/.versions/1.0.4/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  73. package/.versions/1.0.4/.pi/harnesses/agent-hub/posture.ts +158 -0
  74. package/.versions/1.0.4/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  75. package/.versions/1.0.4/.pi/harnesses/agent-hub/research-retention.js +34 -0
  76. package/.versions/1.0.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  77. package/.versions/1.0.4/.pi/harnesses/agent-hub/return-contract.js +293 -0
  78. package/.versions/1.0.4/.pi/harnesses/agent-hub/return-extract.js +75 -0
  79. package/.versions/1.0.4/.pi/harnesses/agent-hub/review-findings.js +102 -0
  80. package/.versions/1.0.4/.pi/harnesses/agent-hub/run-budget.js +537 -0
  81. package/.versions/1.0.4/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  82. package/.versions/1.0.4/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  83. package/.versions/1.0.4/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  84. package/.versions/1.0.4/.pi/harnesses/agent-hub/session-health.js +110 -0
  85. package/.versions/1.0.4/.pi/harnesses/agent-hub/spawn.ts +388 -0
  86. package/.versions/1.0.4/.pi/harnesses/agent-hub/version.ts +42 -0
  87. package/.versions/1.0.4/.pi/harnesses/ask-user-remote/README.md +53 -0
  88. package/.versions/1.0.4/.pi/harnesses/ask-user-remote/index.ts +532 -0
  89. package/.versions/1.0.4/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  90. package/.versions/1.0.4/.pi/harnesses/coms/README.md +100 -0
  91. package/.versions/1.0.4/.pi/harnesses/coms/index.ts +1767 -0
  92. package/.versions/1.0.4/.pi/harnesses/coms/package.json +7 -0
  93. package/.versions/1.0.4/.pi/harnesses/coms/version.ts +42 -0
  94. package/.versions/1.0.4/.pi/harnesses/damage-control-continue/README.md +124 -0
  95. package/.versions/1.0.4/.pi/harnesses/damage-control-continue/index.ts +536 -0
  96. package/.versions/1.0.4/.pi/harnesses/damage-control-continue/package.json +7 -0
  97. package/.versions/1.0.4/.pi/harnesses/damage-control-continue/version.ts +42 -0
  98. package/.versions/1.0.4/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  99. package/.versions/1.0.4/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  100. package/.versions/1.0.4/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  101. package/.versions/1.0.4/.pi/harnesses/lib/context-budget-view.ts +107 -0
  102. package/.versions/1.0.4/.pi/harnesses/lib/context-budget.ts +114 -0
  103. package/.versions/1.0.4/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  104. package/.versions/1.0.4/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  105. package/.versions/1.0.4/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  106. package/.versions/1.0.4/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  107. package/.versions/1.0.4/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  108. package/.versions/1.0.4/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  109. package/.versions/1.0.4/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  110. package/.versions/1.0.4/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  111. package/.versions/1.0.4/.pi/harnesses/lib/fleet-panel.ts +34 -0
  112. package/.versions/1.0.4/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  113. package/.versions/1.0.4/.pi/harnesses/lib/fleet-selection.ts +24 -0
  114. package/.versions/1.0.4/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  115. package/.versions/1.0.4/.pi/harnesses/lib/herdr-client.ts +472 -0
  116. package/.versions/1.0.4/.pi/harnesses/lib/herdr-presence.ts +399 -0
  117. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  118. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  119. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  120. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  121. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  122. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  123. package/.versions/1.0.4/.pi/harnesses/lib/spawned-peers.js +190 -0
  124. package/.versions/1.0.4/.pi/harnesses/package-lock.json +2039 -0
  125. package/.versions/1.0.4/.pi/harnesses/package.json +10 -0
  126. package/.versions/1.0.4/.pi/prompts/af-build.md +24 -0
  127. package/.versions/1.0.4/.pi/prompts/af-code-simplify.md +22 -0
  128. package/.versions/1.0.4/.pi/prompts/af-plan.md +17 -0
  129. package/.versions/1.0.4/.pi/prompts/af-review.md +16 -0
  130. package/.versions/1.0.4/.pi/prompts/af-set-hermes-telegram.md +15 -0
  131. package/.versions/1.0.4/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  132. package/.versions/1.0.4/.pi/prompts/af-ship.md +17 -0
  133. package/.versions/1.0.4/.pi/prompts/af-spec.md +15 -0
  134. package/.versions/1.0.4/.pi/prompts/af-test.md +19 -0
  135. package/.versions/1.0.4/.pi/skills/bowser/SKILL.md +145 -0
  136. package/.versions/1.0.4/.version +1 -0
  137. package/.versions/1.0.4/agents/architect.md +25 -0
  138. package/.versions/1.0.4/agents/bowser.md +28 -0
  139. package/.versions/1.0.4/agents/builder.md +56 -0
  140. package/.versions/1.0.4/agents/code-reviewer.md +209 -0
  141. package/.versions/1.0.4/agents/deep-researcher.md +33 -0
  142. package/.versions/1.0.4/agents/documenter.md +19 -0
  143. package/.versions/1.0.4/agents/orchestrator.md +21 -0
  144. package/.versions/1.0.4/agents/plan-reviewer.md +84 -0
  145. package/.versions/1.0.4/agents/planner.md +71 -0
  146. package/.versions/1.0.4/agents/releaser.md +25 -0
  147. package/.versions/1.0.4/agents/researcher.md +29 -0
  148. package/.versions/1.0.4/agents/security-auditor.md +168 -0
  149. package/.versions/1.0.4/agents/test-engineer.md +154 -0
  150. package/.versions/1.0.4/agents/web-debugger.md +44 -0
  151. package/.versions/1.0.4/agents/web-performance-auditor.md +194 -0
  152. package/.versions/1.0.4/bin/catalog/harness-runtime-closure.json +38 -0
  153. package/.versions/1.0.4/codex/CONDUCTOR.md +148 -0
  154. package/.versions/1.0.4/docs/ARCHITECTURE.md +375 -0
  155. package/.versions/1.0.4/docs/agent-fleet-setup.md +468 -0
  156. package/.versions/1.0.4/docs/claude-code-coms-bridge.md +128 -0
  157. package/.versions/1.0.4/docs/codex-remote-conductor.md +170 -0
  158. package/.versions/1.0.4/docs/coms-hermes-bridge.md +189 -0
  159. package/.versions/1.0.4/docs/getting-started.md +98 -0
  160. package/.versions/1.0.4/docs/npm-install.md +292 -0
  161. package/.versions/1.0.4/docs/pi-extensions.md +441 -0
  162. package/.versions/1.0.4/docs/pi-setup.md +74 -0
  163. package/.versions/1.0.4/docs/skill-anatomy.md +150 -0
  164. package/.versions/1.0.4/hermes/README.md +347 -0
  165. package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  166. package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  167. package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  168. package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  169. package/.versions/1.0.4/hermes/gates/gate-o-capability.md +8 -0
  170. package/.versions/1.0.4/hermes/gates/gate-o-validator-fixtures.json +1 -0
  171. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  172. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  173. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  174. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  175. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  176. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  177. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  178. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  179. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  180. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  181. package/.versions/1.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  182. package/.versions/1.0.4/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  183. package/.versions/1.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  184. package/.versions/1.0.4/hermes/skills/hub-conductor/SKILL.md +84 -0
  185. package/.versions/1.0.4/hermes/skills/hub-liaison/SKILL.md +84 -0
  186. package/.versions/1.0.4/hermes/skills/hub-watchdog/SKILL.md +76 -0
  187. package/.versions/1.0.4/hermes/skills/hub-watchdog/manifest.json +1 -0
  188. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  189. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  190. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  191. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  192. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  193. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  194. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  195. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  196. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  197. package/.versions/1.0.4/hermes/watchdog-tests/__init__.py +0 -0
  198. package/.versions/1.0.4/hooks/coms-stop-hook.mjs +84 -0
  199. package/.versions/1.0.4/install-manifest.json +2745 -0
  200. package/.versions/1.0.4/justfile +272 -0
  201. package/.versions/1.0.4/manifest-meta.json +882 -0
  202. package/.versions/1.0.4/references/accessibility-checklist.md +160 -0
  203. package/.versions/1.0.4/references/definition-of-done.md +67 -0
  204. package/.versions/1.0.4/references/fleet-coordination-patterns.md +151 -0
  205. package/.versions/1.0.4/references/observability-checklist.md +91 -0
  206. package/.versions/1.0.4/references/orchestration-patterns.md +370 -0
  207. package/.versions/1.0.4/references/performance-checklist.md +153 -0
  208. package/.versions/1.0.4/references/prompting-patterns.md +380 -0
  209. package/.versions/1.0.4/references/security-checklist.md +179 -0
  210. package/.versions/1.0.4/references/testing-patterns.md +236 -0
  211. package/.versions/1.0.4/scripts/codex-conductor.ts +41 -0
  212. package/.versions/1.0.4/scripts/codex-remote-control.ts +167 -0
  213. package/.versions/1.0.4/scripts/coms-claude-bridge.ts +411 -0
  214. package/.versions/1.0.4/scripts/coms-cli.ts +484 -0
  215. package/.versions/1.0.4/scripts/coms-hermes-bridge.ts +413 -0
  216. package/.versions/1.0.4/scripts/fleet.ts +185 -0
  217. package/.versions/1.0.4/scripts/hermes-monitor-capability-runner.ts +25 -0
  218. package/.versions/1.0.4/scripts/hermes-monitor-scenario.ts +474 -0
  219. package/.versions/1.0.4/scripts/hermes-watchdog-capability-probe.ts +45 -0
  220. package/.versions/1.0.4/scripts/install-hermes-plugin.sh +180 -0
  221. package/.versions/1.0.4/scripts/lib/claude-bridge-core.ts +210 -0
  222. package/.versions/1.0.4/scripts/lib/codex-conductor.ts +88 -0
  223. package/.versions/1.0.4/scripts/lib/codex-remote-control.ts +480 -0
  224. package/.versions/1.0.4/scripts/lib/coms-envelope.ts +582 -0
  225. package/.versions/1.0.4/scripts/lib/fake-herdr-server.ts +88 -0
  226. package/.versions/1.0.4/scripts/lib/fleet-command.ts +266 -0
  227. package/.versions/1.0.4/scripts/lib/herdr-layout.ts +281 -0
  228. package/.versions/1.0.4/scripts/lib/hermes-bridge-core.ts +241 -0
  229. package/.versions/1.0.4/scripts/lib/hermes-monitor-events.ts +1 -0
  230. package/.versions/1.0.4/scripts/lib/hermes-monitor-herdr.ts +2 -0
  231. package/.versions/1.0.4/scripts/lib/hermes-monitor-model.ts +3 -0
  232. package/.versions/1.0.4/scripts/lib/hermes-monitor-registry.ts +2 -0
  233. package/.versions/1.0.4/scripts/lib/hermes-monitor-socket.ts +2 -0
  234. package/.versions/1.0.4/scripts/lib/hermes-monitor-store.ts +2 -0
  235. package/.versions/1.0.4/scripts/lib/monitor-env.ts +146 -0
  236. package/.versions/1.0.4/scripts/lib/peer-launch.ts +318 -0
  237. package/.versions/1.0.4/scripts/lib/persona-banner.ts +62 -0
  238. package/.versions/1.0.4/scripts/lib/spawn-stagger.ts +101 -0
  239. package/.versions/1.0.4/scripts/lib/team-project.ts +213 -0
  240. package/.versions/1.0.4/scripts/lib/team-snapshot.ts +147 -0
  241. package/.versions/1.0.4/scripts/peer-banner.ts +40 -0
  242. package/.versions/1.0.4/scripts/peer-launch.ts +259 -0
  243. package/.versions/1.0.4/scripts/team-snapshot.ts +237 -0
  244. package/.versions/1.0.4/scripts/team-up.ts +406 -0
  245. package/.versions/1.0.4/skills/_internal/grilling.md +59 -0
  246. package/.versions/1.0.4/skills/browser-testing-with-devtools/SKILL.md +351 -0
  247. package/.versions/1.0.4/skills/code-review-and-quality/SKILL.md +381 -0
  248. package/.versions/1.0.4/skills/compound-learning/SKILL.md +137 -0
  249. package/.versions/1.0.4/skills/context-engineering/SKILL.md +291 -0
  250. package/.versions/1.0.4/skills/deprecation-and-migration/SKILL.md +206 -0
  251. package/.versions/1.0.4/skills/designing-agents/SKILL.md +394 -0
  252. package/.versions/1.0.4/skills/designing-agents/pi-harness-authoring.md +222 -0
  253. package/.versions/1.0.4/skills/frontend-ui-engineering/SKILL.md +328 -0
  254. package/.versions/1.0.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
  255. package/.versions/1.0.4/skills/idea-refine/SKILL.md +182 -0
  256. package/.versions/1.0.4/skills/idea-refine/examples.md +238 -0
  257. package/.versions/1.0.4/skills/idea-refine/frameworks.md +99 -0
  258. package/.versions/1.0.4/skills/idea-refine/refinement-criteria.md +113 -0
  259. package/.versions/1.0.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
  260. package/.versions/1.0.4/skills/incremental-implementation/SKILL.md +298 -0
  261. package/.versions/1.0.4/skills/interview-me/SKILL.md +226 -0
  262. package/.versions/1.0.4/skills/orchestration-verification/SKILL.md +181 -0
  263. package/.versions/1.0.4/skills/peer-coms/SKILL.md +90 -0
  264. package/.versions/1.0.4/skills/performance-optimization/SKILL.md +350 -0
  265. package/.versions/1.0.4/skills/planning-and-task-breakdown/SKILL.md +263 -0
  266. package/.versions/1.0.4/skills/security-and-hardening/SKILL.md +461 -0
  267. package/.versions/1.0.4/skills/spec-driven-development/SKILL.md +256 -0
  268. package/.versions/1.0.4/skills/using-agent-skills/SKILL.md +197 -0
  269. package/.versions/1.0.4/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  270. package/.versions/1.0.4/vendor/agent-skills-upstream/LICENSE +21 -0
  271. package/.versions/1.0.4/vendor/agent-skills-upstream/README.md +11 -0
  272. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  273. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  274. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  275. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  276. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  277. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  278. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  279. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  280. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  281. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  282. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  283. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  284. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  285. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  286. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  287. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  288. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  289. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  290. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  291. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  292. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  293. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  294. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  295. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  296. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  297. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  298. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  299. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  300. package/CHANGELOG.md +7 -0
  301. package/agents/builder.md +1 -0
  302. package/agents/planner.md +1 -1
  303. package/install-manifest.json +3 -3
  304. package/package.json +2 -2
  305. package/skills/_internal/grilling.md +53 -5
  306. package/skills/idea-refine/SKILL.md +2 -2
  307. package/skills/incremental-implementation/SKILL.md +12 -1
  308. package/skills/planning-and-task-breakdown/SKILL.md +14 -5
  309. package/skills/spec-driven-development/SKILL.md +10 -11
  310. package/skills/using-agent-skills/SKILL.md +13 -15
@@ -1,7 +1,15 @@
1
1
  import type { FleetRow } from "./fleet-read-model.ts";
2
2
  import type { ThemeLike } from "./fleet-dashboard-view.ts";
3
3
 
4
- export interface TimelineEntry { kind: "text" | "tool" | "thinking"; title: string; content: string; timestamp: number; }
4
+ export interface TimelineEntry {
5
+ kind: "text" | "tool" | "thinking" | "tool-start" | "tool-result";
6
+ title: string;
7
+ content: string;
8
+ timestamp: number;
9
+ callId?: string;
10
+ status?: "success" | "error";
11
+ durationMs?: number;
12
+ }
5
13
  export interface PiModelSummary { provider?: unknown; id?: unknown; name?: unknown; }
6
14
  export interface FleetModelChoice { spec: string; label: string; }
7
15
  export interface FleetModelPickerState { index: number; scrollOffset: number; }
@@ -128,41 +136,112 @@ export function modelPickerTransition(
128
136
  return null;
129
137
  }
130
138
 
131
- export function detailContent(timeline: readonly TimelineEntry[], width: number, expandedIndex: number | null): string[] {
139
+ const isToolEntry = (entry: TimelineEntry | undefined) => entry?.kind === "tool" || entry?.kind === "tool-start" || entry?.kind === "tool-result";
140
+
141
+ function wrapPlainText(value: string, width: number): string[] {
142
+ const max = Math.max(1, width);
143
+ const output: string[] = [];
144
+ for (const sourceLine of value.split(/\r?\n/)) {
145
+ if (!sourceLine) { output.push(""); continue; }
146
+ let rest = sourceLine;
147
+ while (Array.from(rest).length > max) {
148
+ const chars = Array.from(rest);
149
+ let cut = max;
150
+ for (let i = max; i > Math.floor(max / 2); i--) if (/\s/.test(chars[i] ?? "")) { cut = i; break; }
151
+ output.push(chars.slice(0, cut).join("").trimEnd());
152
+ rest = chars.slice(cut).join("").trimStart();
153
+ }
154
+ output.push(rest);
155
+ }
156
+ return output;
157
+ }
158
+
159
+ function durationLabel(ms: number | undefined): string {
160
+ if (ms == null || !Number.isFinite(ms)) return "";
161
+ return ms < 1000 ? `${Math.max(0, Math.round(ms))}ms` : `${(Math.max(0, ms) / 1000).toFixed(2).replace(/0+$/, "").replace(/\.$/, "")}s`;
162
+ }
163
+
164
+ function detailEntryLines(entry: TimelineEntry, index: number, width: number, expandedIndex: number | null, verbose: boolean, selectedIndex?: number): string[] {
132
165
  const w = Math.max(1, width);
133
- return timeline.flatMap((entry, index) => {
134
- const icon = entry.kind === "tool" ? "▸" : entry.kind === "thinking" ? "·" : "•";
135
- if (index === expandedIndex && entry.kind === "tool") return [` ${icon} ${entry.title}`, ...entry.content.split(/\r?\n/).map(line => ` ${trim(line, Math.max(0, w - 3))}`)];
136
- return [` ${icon} ${trim(`${entry.title} ${entry.content.replace(/\s+/g, " ")}`, Math.max(0, w - 1))}`];
137
- });
166
+ const icon = isToolEntry(entry) ? (entry.kind === "tool-result" ? "◂" : "▸") : entry.kind === "thinking" ? "·" : "•";
167
+ const selected = index === selectedIndex ? "›" : " ";
168
+ const meta = entry.kind === "tool-result"
169
+ ? ` [${[entry.status, durationLabel(entry.durationMs)].filter(Boolean).join(" · ")}]`
170
+ : "";
171
+ if (!verbose) {
172
+ if (index === expandedIndex && isToolEntry(entry)) return [trim(`${selected}${icon} ${entry.title}${meta}`, w), ...entry.content.split(/\r?\n/).map(line => ` ${trim(line, Math.max(0, w - 3))}`)];
173
+ return [trim(`${selected}${icon} ${entry.title}${meta} ${entry.content.replace(/\s+/g, " ")}`, w)];
174
+ }
175
+ const heading = trim(`${selected}${icon} ${entry.title}`, w);
176
+ const metadata = meta ? wrapPlainText(meta.trim(), Math.max(1, w - 3)).map(line => trim(` ${line}`, w)) : [];
177
+ const payload = wrapPlainText(entry.content, Math.max(1, w - 3)).map(line => trim(` ${line}`, w));
178
+ return [heading, ...metadata, ...payload];
179
+ }
180
+
181
+ export interface DetailEntryOffset { index: number; start: number; end: number; }
182
+
183
+ /** Locate each logical event inside its wrapped visual lines. */
184
+ export function detailEntryOffsets(timeline: readonly TimelineEntry[], width: number, expandedIndex: number | null, verbose: boolean): DetailEntryOffset[] {
185
+ const offsets: DetailEntryOffset[] = [];
186
+ let cursor = 0;
187
+ for (let index = 0; index < timeline.length; index++) {
188
+ const length = detailEntryLines(timeline[index], index, width, expandedIndex, verbose).length;
189
+ offsets.push({ index, start: cursor, end: cursor + length });
190
+ cursor += length;
191
+ }
192
+ return offsets;
193
+ }
194
+
195
+ export function detailContent(timeline: readonly TimelineEntry[], width: number, expandedIndex: number | null, verbose = false, selectedIndex?: number): string[] {
196
+ return timeline.flatMap((entry, index) => detailEntryLines(entry, index, width, expandedIndex, verbose, selectedIndex));
138
197
  }
139
198
 
140
199
  /** Render a constant-height transcript detail screen, including the no-local-peer notice. */
141
- export function renderFleetDetail(row: FleetRow, timeline: readonly TimelineEntry[], scrollOffset: number, width: number, bodyHeight: number, theme: ThemeLike, expandedIndex: number | null = null): string[] {
200
+ export function renderFleetDetail(row: FleetRow, timeline: readonly TimelineEntry[], scrollOffset: number, width: number, bodyHeight: number, theme: ThemeLike, expandedIndex: number | null = null, verbose = false, selectedIndex?: number): string[] {
142
201
  const w = Math.max(1, width), body = Math.max(0, bodyHeight);
143
- const header = trim(` ${row.name} · ${row.status} · ${row.kind} · ${row.model} · ${row.backend} · ${row.contextPct == null ? "context automatic" : `${Math.round(row.contextPct)}%`} · ${Math.round(row.elapsed / 1000)}s · ${row.toolCount ?? "—"} tools`, w);
202
+ const mode = verbose ? "Verbose" : "Compact";
203
+ const header = trim(` ${row.name} · ${mode} · ${row.status} · ${row.kind} · ${row.model} · ${row.backend} · ${row.contextPct == null ? "context automatic" : `${Math.round(row.contextPct)}%`} · ${Math.round(row.elapsed / 1000)}s · ${row.toolCount ?? "—"} tools`, w);
144
204
  const lines = [theme.bold(header), theme.fg("dim", "╭" + "─".repeat(Math.max(0, w - 2)) + "╮")];
145
205
  if (!row.hasTimeline) lines.push(...Array.from({ length: body }, (_, i) => i === 0 ? theme.fg("dim", " no local transcript for this coms peer") : ""));
146
206
  else {
147
- const content = detailContent(timeline, w, expandedIndex);
207
+ const content = detailContent(timeline, w, expandedIndex, verbose, selectedIndex);
148
208
  const offset = Math.max(0, Math.min(scrollOffset, Math.max(0, content.length - body)));
149
209
  lines.push(...content.slice(offset, offset + body), ...Array(Math.max(0, body - content.slice(offset, offset + body).length)).fill(""));
150
210
  }
151
211
  lines.push(theme.fg("dim", "╰" + "─".repeat(Math.max(0, w - 2)) + "╯"));
152
212
  const modelHint = row.kind === "peer" ? "" : " · m model";
153
- lines.push(theme.fg("dim", `↑↓ scroll · PgUp/PgDn page · End tail · Enter expand tool · Ctrl+C copy${modelHint} · Esc dashboard`));
213
+ lines.push(theme.fg("dim", `↑↓ scroll · PgUp/PgDn page · End tail · Enter expand tool · v ${verbose ? "compact" : "verbose"} · Ctrl+C copy${modelHint} · Esc dashboard`));
154
214
  return lines.slice(0, body + DETAIL_CHROME_ROWS).concat(Array(Math.max(0, body + DETAIL_CHROME_ROWS - lines.length)).fill(""));
155
215
  }
156
216
 
157
217
  /** Pure state transitions used by the harness detail controller. */
158
- export function detailTransition(input: string, state: { scrollOffset: number; selectedIndex: number; expandedIndex: number | null; followTail: boolean }, timeline: readonly TimelineEntry[], bodyHeight: number, contentLength = timeline.length): "close" | "copy" | "model" | null {
159
- const max = Math.max(0, contentLength - Math.max(1, bodyHeight));
218
+ export function detailTransition(
219
+ input: string,
220
+ state: { scrollOffset: number; selectedIndex: number; expandedIndex: number | null; followTail: boolean; verbose?: boolean },
221
+ timeline: readonly TimelineEntry[],
222
+ bodyHeight: number,
223
+ contentLength = timeline.length,
224
+ offsets?: readonly DetailEntryOffset[],
225
+ ): "close" | "copy" | "model" | null {
226
+ const viewport = Math.max(1, bodyHeight);
227
+ const max = Math.max(0, contentLength - viewport);
160
228
  if (input === "\u001b" || input === "q") return "close";
161
229
  if (input === "\u0003") return "copy";
162
230
  if (input === "m") return "model";
163
- if (input === "\u001b[F") { state.followTail = true; state.scrollOffset = max; return null; }
164
- if (input === "\r") { if (timeline[state.selectedIndex]?.kind === "tool") state.expandedIndex = state.expandedIndex === state.selectedIndex ? null : state.selectedIndex; return null; }
231
+ if (input === "v") { state.verbose = !state.verbose; state.followTail = true; return null; }
232
+ if (input === "\u001b[F") { state.followTail = true; state.scrollOffset = max; state.selectedIndex = Math.max(0, timeline.length - 1); return null; }
233
+ if (input === "\u001b[H") { state.followTail = false; state.scrollOffset = 0; state.selectedIndex = 0; return null; }
234
+ if (input === "\r") { if (isToolEntry(timeline[state.selectedIndex])) state.expandedIndex = state.expandedIndex === state.selectedIndex ? null : state.selectedIndex; return null; }
165
235
  const delta = input === "\u001b[A" || input === "k" ? -1 : input === "\u001b[B" || input === "j" ? 1 : input === "\u001b[5~" ? -bodyHeight : input === "\u001b[6~" ? bodyHeight : 0;
166
- if (delta) { state.followTail = false; state.selectedIndex = Math.max(0, Math.min(Math.max(0, timeline.length - 1), state.selectedIndex + delta)); state.scrollOffset = Math.max(0, Math.min(max, state.scrollOffset + delta)); }
236
+ if (delta) {
237
+ state.followTail = false;
238
+ state.selectedIndex = Math.max(0, Math.min(Math.max(0, timeline.length - 1), state.selectedIndex + delta));
239
+ const selected = offsets?.[state.selectedIndex];
240
+ if (selected) {
241
+ if (selected.start < state.scrollOffset) state.scrollOffset = selected.start;
242
+ else if (selected.start >= state.scrollOffset + viewport) state.scrollOffset = selected.start - viewport + 1;
243
+ } else state.scrollOffset += delta;
244
+ state.scrollOffset = Math.max(0, Math.min(max, state.scrollOffset));
245
+ }
167
246
  return null;
168
247
  }
@@ -0,0 +1,244 @@
1
+ import fs from "node:fs";
2
+ import { dirname } from "node:path";
3
+
4
+ export type FleetTranscriptKind = "text" | "thinking" | "tool-start" | "tool-result";
5
+ export type FleetToolStatus = "success" | "error";
6
+
7
+ export interface FleetTranscriptEvent {
8
+ kind: FleetTranscriptKind;
9
+ title: string;
10
+ content: string;
11
+ timestamp: number;
12
+ callId?: string;
13
+ status?: FleetToolStatus;
14
+ durationMs?: number;
15
+ chunkIndex?: number;
16
+ chunkCount?: number;
17
+ }
18
+
19
+ export interface FleetTranscriptRecord {
20
+ event: FleetTranscriptEvent;
21
+ startOffset: number;
22
+ endOffset: number;
23
+ }
24
+
25
+ export interface FleetTranscriptPage {
26
+ events: FleetTranscriptEvent[];
27
+ records: FleetTranscriptRecord[];
28
+ startOffset: number;
29
+ nextOffset: number;
30
+ eof: boolean;
31
+ }
32
+
33
+ const DEFAULT_LIMIT = 500;
34
+ const DEFAULT_READ_BYTES = 1024 * 1024;
35
+ const EVENT_CONTENT_BYTES = 64 * 1024;
36
+ const REDACTED = "[REDACTED]";
37
+
38
+ /** Remove common credential forms before transcript data reaches disk or UI. */
39
+ export function redactSecrets(value: string): string {
40
+ const credential = "(?:api[_-]?key|access[_-]?token|auth[_-]?token|refresh[_-]?token|client[_-]?secret|password|passwd|pwd|token|secret)";
41
+ return value
42
+ .replace(/-----BEGIN(?: [A-Z0-9]+)* PRIVATE KEY-----[\s\S]*?-----END(?: [A-Z0-9]+)* PRIVATE KEY-----/gi, REDACTED)
43
+ .replace(/(["']authorization["']\s*:\s*["']bearer\s+)[^"']+/gi, `$1${REDACTED}`)
44
+ .replace(new RegExp(`(["']?)([A-Z0-9_]*${credential})\\1(\\s*[:=]\\s*)(["'])(.*?)\\4`, "gi"), (_match, quote, key, separator, valueQuote) => `${quote}${key}${quote}${separator}${valueQuote}${REDACTED}${valueQuote}`)
45
+ .replace(/(\bauthorization\s*:\s*bearer\s+)[^\s"']+/gi, `$1${REDACTED}`)
46
+ .replace(new RegExp(`(\\b[A-Z0-9_]*${credential}\\b\\s*=\\s*)(["']?)[^\\s,"';&]+\\2`, "gi"), `$1${REDACTED}`)
47
+ .replace(new RegExp(`(\\b${credential}\\b\\s*[:=]\\s*)(["']?)[^\\s,"';&]+\\2`, "gi"), `$1${REDACTED}`)
48
+ .replace(/\bsk-(?:proj-)?[A-Za-z0-9_-]{16,}\b/g, REDACTED)
49
+ .replace(/\b(?:ghp|gho|ghu|ghs|github_pat)_[A-Za-z0-9_]{20,}\b/g, REDACTED)
50
+ .replace(/\bxox[baprs]-[A-Za-z0-9-]{10,}\b/g, REDACTED)
51
+ .replace(/\bAKIA[0-9A-Z]{16}\b/g, REDACTED);
52
+ }
53
+
54
+ /** Defence-in-depth redaction for records entering or leaving the store. */
55
+ export function redactTimelineEvent(event: FleetTranscriptEvent): FleetTranscriptEvent {
56
+ return {
57
+ kind: event.kind,
58
+ title: redactSecrets(event.title),
59
+ content: redactSecrets(event.content),
60
+ timestamp: event.timestamp,
61
+ ...(event.callId ? { callId: redactSecrets(event.callId) } : {}),
62
+ ...(event.status ? { status: event.status } : {}),
63
+ ...(event.durationMs == null ? {} : { durationMs: event.durationMs }),
64
+ ...(event.chunkIndex == null ? {} : { chunkIndex: event.chunkIndex }),
65
+ ...(event.chunkCount == null ? {} : { chunkCount: event.chunkCount }),
66
+ };
67
+ }
68
+
69
+ function validEvent(value: unknown): value is FleetTranscriptEvent {
70
+ if (!value || typeof value !== "object") return false;
71
+ const event = value as Record<string, unknown>;
72
+ return (event.kind === "text" || event.kind === "thinking" || event.kind === "tool-start" || event.kind === "tool-result")
73
+ && typeof event.title === "string"
74
+ && typeof event.content === "string"
75
+ && typeof event.timestamp === "number"
76
+ && Number.isFinite(event.timestamp)
77
+ && (event.callId === undefined || typeof event.callId === "string")
78
+ && (event.status === undefined || event.status === "success" || event.status === "error")
79
+ && (event.durationMs === undefined || (typeof event.durationMs === "number" && Number.isFinite(event.durationMs) && event.durationMs >= 0))
80
+ && (event.chunkIndex === undefined || (Number.isInteger(event.chunkIndex) && (event.chunkIndex as number) >= 0))
81
+ && (event.chunkCount === undefined || (Number.isInteger(event.chunkCount) && (event.chunkCount as number) > 0));
82
+ }
83
+
84
+ function contentChunks(content: string, maxBytes = EVENT_CONTENT_BYTES): string[] {
85
+ if (Buffer.byteLength(content) <= maxBytes) return [content];
86
+ const chunks: string[] = [];
87
+ let current = "";
88
+ let bytes = 0;
89
+ for (const char of content) {
90
+ const size = Buffer.byteLength(char);
91
+ if (bytes + size > maxBytes && current) {
92
+ chunks.push(current);
93
+ current = "";
94
+ bytes = 0;
95
+ }
96
+ current += char;
97
+ bytes += size;
98
+ }
99
+ if (current || chunks.length === 0) chunks.push(current);
100
+ return chunks;
101
+ }
102
+
103
+ function secureDirectory(path: string): void {
104
+ fs.mkdirSync(path, { recursive: true, mode: 0o700 });
105
+ try { fs.chmodSync(path, 0o700); } catch (error) {
106
+ if (process.platform !== "win32") throw error;
107
+ }
108
+ }
109
+
110
+ function secureAppend(path: string, text: string): void {
111
+ secureDirectory(dirname(path));
112
+ try {
113
+ if (fs.lstatSync(path).isSymbolicLink()) throw new Error(`Refused transcript symlink: ${path}`);
114
+ } catch (error: any) {
115
+ if (error?.code !== "ENOENT") throw error;
116
+ }
117
+ const noFollow = (fs.constants as Record<string, number>).O_NOFOLLOW ?? 0;
118
+ const fd = fs.openSync(path, fs.constants.O_APPEND | fs.constants.O_CREAT | fs.constants.O_WRONLY | noFollow, 0o600);
119
+ try {
120
+ try { fs.fchmodSync(fd, 0o600); } catch (error) { if (process.platform !== "win32") throw error; }
121
+ fs.writeSync(fd, text, undefined, "utf8");
122
+ } finally {
123
+ fs.closeSync(fd);
124
+ }
125
+ }
126
+
127
+ export interface FleetTranscriptStore {
128
+ readonly path: string;
129
+ append(event: FleetTranscriptEvent): void;
130
+ read(options?: { after?: number; limit?: number; maxBytes?: number }): FleetTranscriptPage;
131
+ }
132
+
133
+ /** Create an append-only, owner-readable local transcript. */
134
+ export function createFleetTranscriptStore(path: string): FleetTranscriptStore {
135
+ return {
136
+ path,
137
+ append(event) {
138
+ const safe = redactTimelineEvent(event);
139
+ const chunks = contentChunks(safe.content);
140
+ const records = chunks.map((content, chunkIndex) => JSON.stringify({
141
+ ...safe,
142
+ content,
143
+ ...(chunks.length > 1 ? { chunkIndex, chunkCount: chunks.length } : {}),
144
+ })).join("\n") + "\n";
145
+ secureAppend(path, records);
146
+ },
147
+ read: (options) => readFleetTranscript(path, options),
148
+ };
149
+ }
150
+
151
+ /** Read complete JSONL records from a byte cursor without consuming a partial tail. */
152
+ export function readFleetTranscript(path: string, options: { after?: number; limit?: number; maxBytes?: number } = {}): FleetTranscriptPage {
153
+ const after = Math.max(0, Math.floor(options.after ?? 0));
154
+ const limit = Math.max(1, Math.floor(options.limit ?? DEFAULT_LIMIT));
155
+ const maxBytes = Math.max(1, Math.floor(options.maxBytes ?? DEFAULT_READ_BYTES));
156
+ let size: number;
157
+ try { size = fs.statSync(path).size; } catch (error: any) {
158
+ if (error?.code === "ENOENT") return { events: [], records: [], startOffset: after, nextOffset: after, eof: true };
159
+ throw error;
160
+ }
161
+ if (after >= size) return { events: [], records: [], startOffset: after, nextOffset: after, eof: true };
162
+ const length = Math.min(maxBytes, size - after);
163
+ const fd = fs.openSync(path, "r");
164
+ let buffer: Buffer;
165
+ try {
166
+ buffer = Buffer.alloc(length);
167
+ const read = fs.readSync(fd, buffer, 0, length, after);
168
+ buffer = buffer.subarray(0, read);
169
+ } finally {
170
+ fs.closeSync(fd);
171
+ }
172
+ const lastNewline = buffer.lastIndexOf(0x0a);
173
+ if (lastNewline < 0) return { events: [], records: [], startOffset: after, nextOffset: after, eof: false };
174
+ const complete = buffer.subarray(0, lastNewline + 1).toString("utf8");
175
+ const events: FleetTranscriptEvent[] = [];
176
+ const records: FleetTranscriptRecord[] = [];
177
+ let consumed = 0;
178
+ for (const line of complete.split("\n")) {
179
+ if (!line) continue;
180
+ const lineBytes = Buffer.byteLength(line) + 1;
181
+ let parsed: unknown;
182
+ try { parsed = JSON.parse(line); } catch { consumed += lineBytes; continue; }
183
+ if (validEvent(parsed)) {
184
+ const event = redactTimelineEvent(parsed);
185
+ events.push(event);
186
+ records.push({ event, startOffset: after + consumed, endOffset: after + consumed + lineBytes });
187
+ }
188
+ consumed += lineBytes;
189
+ if (events.length >= limit) break;
190
+ }
191
+ const nextOffset = after + consumed;
192
+ return { events, records, startOffset: records[0]?.startOffset ?? after, nextOffset, eof: nextOffset >= size };
193
+ }
194
+
195
+ /** Read the last complete records at or before a byte cursor. */
196
+ export function readFleetTranscriptBefore(path: string, options: { before?: number; limit?: number; maxBytes?: number } = {}): FleetTranscriptPage {
197
+ let size: number;
198
+ try { size = fs.statSync(path).size; } catch (error: any) {
199
+ if (error?.code === "ENOENT") return { events: [], records: [], startOffset: 0, nextOffset: 0, eof: true };
200
+ throw error;
201
+ }
202
+ const before = Math.max(0, Math.min(size, Math.floor(options.before ?? size)));
203
+ const limit = Math.max(1, Math.floor(options.limit ?? DEFAULT_LIMIT));
204
+ const maxBytes = Math.max(1, Math.floor(options.maxBytes ?? DEFAULT_READ_BYTES));
205
+ if (before === 0) return { events: [], records: [], startOffset: 0, nextOffset: 0, eof: size === 0 };
206
+ const start = Math.max(0, before - maxBytes);
207
+ const fd = fs.openSync(path, "r");
208
+ let buffer: Buffer;
209
+ try {
210
+ buffer = Buffer.alloc(before - start);
211
+ const read = fs.readSync(fd, buffer, 0, buffer.length, start);
212
+ buffer = buffer.subarray(0, read);
213
+ } finally { fs.closeSync(fd); }
214
+ let localStart = start === 0 ? 0 : buffer.indexOf(0x0a) + 1;
215
+ if (localStart < 0) localStart = buffer.length;
216
+ const records: FleetTranscriptRecord[] = [];
217
+ let cursor = localStart;
218
+ while (cursor < buffer.length) {
219
+ const newline = buffer.indexOf(0x0a, cursor);
220
+ if (newline < 0) break;
221
+ const line = buffer.subarray(cursor, newline).toString("utf8");
222
+ try {
223
+ const parsed = JSON.parse(line);
224
+ if (validEvent(parsed)) {
225
+ const event = redactTimelineEvent(parsed);
226
+ records.push({ event, startOffset: start + cursor, endOffset: start + newline + 1 });
227
+ }
228
+ } catch {}
229
+ cursor = newline + 1;
230
+ }
231
+ const selected = records.slice(-limit);
232
+ return {
233
+ events: selected.map(record => record.event),
234
+ records: selected,
235
+ startOffset: selected[0]?.startOffset ?? before,
236
+ nextOffset: before,
237
+ eof: before >= size,
238
+ };
239
+ }
240
+
241
+ /** Open a bounded window at the current transcript tail. */
242
+ export function readFleetTranscriptTail(path: string, options: { limit?: number; maxBytes?: number } = {}): FleetTranscriptPage {
243
+ return readFleetTranscriptBefore(path, { ...options, before: undefined });
244
+ }
@@ -7,10 +7,11 @@ Load and follow the `planning-and-task-breakdown` skill before proceeding.
7
7
  Read the existing spec (SPEC.md or equivalent) and the relevant codebase sections. Then:
8
8
 
9
9
  1. Enter plan mode — read only, no code changes
10
- 2. Identify the dependency graph between components
11
- 3. Slice work vertically (one complete path per task, not horizontal layers)
12
- 4. Write tasks with acceptance criteria and verification steps
13
- 5. Add checkpoints between phases
14
- 6. Present the plan for human review
10
+ 2. Grill unspecified forks per the planning skill's grilling helper — skip anything already explicit in chat, prompt, PRD, spec, or rules; ask one question at a time (with a recommended option) for every remaining multiple-valid-way, contradiction, or competing code pattern; do not write tasks while a load-bearing choice is still assumed
11
+ 3. Identify the dependency graph between components
12
+ 4. Slice work vertically (one complete path per task, not horizontal layers)
13
+ 5. Write tasks with acceptance criteria and verification steps
14
+ 6. Add checkpoints between phases
15
+ 7. Present the plan for human review
15
16
 
16
17
  Save the plan to the location the `planning-and-task-breakdown` skill defines (default `docs/plans/{area}/PLAN-{prd-name}-{phase}.md`, with the task list embedded — no separate todo file; overridable per project via `.ai/agent-fleet-overrides.md`). Match the project's existing `docs`/`Docs` capitalization.
@@ -0,0 +1,32 @@
1
+ # Backend routing for the agent-hub dispatcher (dispatch_agent). Decided at
2
+ # DISPATCH time, never at team activation — the hub and its peers boot in
3
+ # parallel (`just fleet team <team>`), so a member's coms peer may register
4
+ # after the session starts.
5
+ #
6
+ # default: native | coms — coms substitutes ANY active-team member that has
7
+ # a live same-name peer in the coms pool
8
+ # grace_s: <seconds> — how long a `fallback: none` member polls the pool
9
+ # for its peer before the dispatch is refused
10
+ # substitutions:
11
+ # <member>: — team-member/persona name (case-insensitive)
12
+ # prefer: native|coms — bare member block defaults to coms
13
+ # fallback: native|none — none = coms-required (refuse when no live peer)
14
+ # timeout_s: <seconds> — per-member reply timeout (default PI_COMS_TIMEOUT_MS)
15
+ #
16
+ # Missing file = everything native (no behavior change). This file is an
17
+ # orchestration decision; HOW each peer runs (model, runner: claude-code, env)
18
+ # stays in peers.yaml.
19
+
20
+ default: native
21
+ grace_s: 30
22
+
23
+ substitutions:
24
+ plan-reviewer:
25
+ prefer: coms
26
+ fallback: native
27
+ code-reviewer:
28
+ prefer: coms
29
+ fallback: native
30
+ documenter:
31
+ prefer: coms
32
+ fallback: native
@@ -0,0 +1,27 @@
1
+ # Named model profiles for /models — each entry must be one of the persona's
2
+ # declared candidates (frontmatter `model:` + `models:` list). A profile with
3
+ # any invalid entry is dropped whole at session start, with an error notify.
4
+ #
5
+ # Profiles only switch the personas they list; everyone else keeps their
6
+ # current model. They never touch delegate-children (`subagents:`) models.
7
+ mix-max:
8
+ code-reviewer: github-copilot/claude-opus-5
9
+ builder: openai-codex/gpt-5.6-sol
10
+ planner: github-copilot/claude-fable-5
11
+ plan-reviewer: openai-codex/gpt-5.6-sol
12
+ security-auditor: xai/grok-4.6
13
+ test-engineer: xai/grok-4.6
14
+ sol:
15
+ code-reviewer: openai-codex/gpt-5.6-sol
16
+ builder: openai-codex/gpt-5.6-sol
17
+ planner: openai-codex/gpt-5.6-sol
18
+ plan-reviewer: openai-codex/gpt-5.6-sol
19
+ security-auditor: openai-codex/gpt-5.6-sol
20
+ test-engineer: openai-codex/gpt-5.6-sol
21
+ terra:
22
+ code-reviewer: openai-codex/gpt-5.6-terra
23
+ builder: openai-codex/gpt-5.6-terra
24
+ planner: openai-codex/gpt-5.6-terra
25
+ plan-reviewer: openai-codex/gpt-5.6-terra
26
+ security-auditor: openai-codex/gpt-5.6-terra
27
+ test-engineer: openai-codex/gpt-5.6-terra
@@ -0,0 +1,142 @@
1
+ # Reusable coms peers, grouped into named teams (parallels teams.yaml).
2
+ #
3
+ # `just fleet team <name> --no-hub` spawns each peer in its own Herdr pane
4
+ # (requires a running herdr server — https://herdr.dev),
5
+ # using the hidden `_peer` helper (guarded Fleet Core + coms + the persona).
6
+ #
7
+ # A team is NOT required to launch a single peer: `just fleet peer <name>` puts
8
+ # one peer (pi or `--runner claude-code`) in its own pane — splitting the current
9
+ # pane inside Herdr, else creating a one-pane workspace, or `--here` for the
10
+ # calling terminal. A name declared below keeps its runner/model/extensions/
11
+ # env_file; an undeclared name works too.
12
+ #
13
+ # Each peer entry:
14
+ # name — coms identity (the addressable peer name); overrides persona frontmatter
15
+ # persona — file under agents/ (without .md); its body is the role, its
16
+ # frontmatter `description`/`color` become the coms purpose/color
17
+ # model — optional pi --model spec (e.g. anthropic/claude-opus-4-7); omit to
18
+ # inherit pi's default model
19
+ # extensions — optional comma-separated extension names under .pi/extensions/ to
20
+ # load into this peer (routes it through `_peer-plus`). Use for a
21
+ # chrome-devtools-mcp browser-debug peer whose `chrome_devtools__*`
22
+ # tools a --no-extensions subagent could not get.
23
+ # env_file — optional repo-relative KEY=VALUE file (no shell evaluation) injected
24
+ # into the peer's pane env by herdr before the command runs. Must exist
25
+ # at spawn or team-up refuses. Values are redacted in --dry-run output.
26
+ # Pair with the gitignored `.env` convention from guided setup
27
+ # (docs/agent-fleet-setup.md).
28
+ # runner — optional; "claude-code" spawns interactive Claude Code + its coms
29
+ # bridge in the pane instead of a pi peer (persona not required;
30
+ # model maps to `claude --model`). Example:
31
+ # - name: claude-main
32
+ # runner: claude-code
33
+ # model: opus
34
+
35
+ # Hub-only workspace: `just fleet team base --project <name>` creates a Herdr
36
+ # workspace containing only the guarded hub, with no reusable coms peer panes.
37
+ base:
38
+
39
+ full:
40
+ - name: web-debugger
41
+ persona: web-debugger
42
+ model: openai-codex/gpt-5.6-terra
43
+ extensions: chrome-devtools-mcp
44
+ - name: documenter
45
+ persona: documenter
46
+ model: openai-codex/gpt-5.6-terra
47
+ - name: researcher
48
+ persona: researcher
49
+ model: openai-codex/gpt-5.6-luna
50
+
51
+ web:
52
+ - name: web-debugger
53
+ persona: web-debugger
54
+ model: openai-codex/gpt-5.6-terra
55
+ extensions: chrome-devtools-mcp
56
+
57
+ docs:
58
+ - name: documenter
59
+ persona: documenter
60
+ model: openai-codex/gpt-5.6-terra
61
+ - name: researcher
62
+ persona: researcher
63
+ model: openai-codex/gpt-5.6-luna
64
+
65
+ # Mirrored from .pi/agents/teams.yaml for `just fleet team <team>`.
66
+ default:
67
+ - name: code-reviewer
68
+ runner: claude-code
69
+ - name: web-debugger
70
+ persona: web-debugger
71
+ model: openai-codex/gpt-5.6-terra
72
+ extensions: chrome-devtools-mcp
73
+
74
+ debug:
75
+ - name: test-engineer
76
+ persona: test-engineer
77
+ model: openai-codex/gpt-5.6-terra
78
+ - name: builder
79
+ persona: builder
80
+ model: openai-codex/gpt-5.6-terra
81
+ - name: code-reviewer
82
+ runner: claude-code
83
+
84
+ frontend:
85
+ - name: planner
86
+ persona: planner
87
+ model: openai-codex/gpt-5.6-sol
88
+ - name: builder
89
+ persona: builder
90
+ model: openai-codex/gpt-5.6-terra
91
+ - name: bowser
92
+ persona: bowser
93
+ model: openai-codex/gpt-5.6-luna
94
+ - name: code-reviewer
95
+ runner: claude-code
96
+
97
+ security:
98
+ - name: security-auditor
99
+ persona: security-auditor
100
+ model: openai-codex/gpt-5.6-sol
101
+ - name: builder
102
+ persona: builder
103
+ model: openai-codex/gpt-5.6-terra
104
+ - name: test-engineer
105
+ persona: test-engineer
106
+ model: openai-codex/gpt-5.6-terra
107
+ - name: code-reviewer
108
+ runner: claude-code
109
+
110
+ hotfix:
111
+ - name: builder
112
+ persona: builder
113
+ model: openai-codex/gpt-5.6-terra
114
+ - name: code-reviewer
115
+ runner: claude-code
116
+
117
+ release:
118
+ - name: releaser
119
+ persona: releaser
120
+ model: openai-codex/gpt-5.6-terra
121
+ - name: documenter
122
+ persona: documenter
123
+ model: openai-codex/gpt-5.6-terra
124
+
125
+ info:
126
+ - name: documenter
127
+ persona: documenter
128
+ model: openai-codex/gpt-5.3-codex-spark
129
+ - name: code-reviewer
130
+ runner: claude-code
131
+
132
+ review:
133
+ - name: plan-reviewer
134
+ runner: claude-code
135
+ - name: code-reviewer
136
+ runner: claude-code
137
+
138
+ plan:
139
+ - name: planner
140
+ runner: claude-code
141
+ - name: code-reviewer
142
+ runner: claude-code
@@ -0,0 +1,41 @@
1
+ # The first team is activated at startup. Switch with: /agents-team
2
+ # researcher / deep-researcher are not listed — they are always available through spawn_research.
3
+
4
+ default:
5
+ - builder
6
+ - test-engineer
7
+ - code-reviewer
8
+ - documenter
9
+
10
+ plan:
11
+ - planner
12
+ - plan-reviewer
13
+
14
+ debug:
15
+ - test-engineer
16
+ - builder
17
+ - code-reviewer
18
+
19
+ frontend:
20
+ - planner
21
+ - builder
22
+ - bowser
23
+ - code-reviewer
24
+
25
+ security:
26
+ - security-auditor
27
+ - builder
28
+ - test-engineer
29
+ - code-reviewer
30
+
31
+ hotfix:
32
+ - builder
33
+ - code-reviewer
34
+
35
+ release:
36
+ - releaser
37
+ - documenter
38
+
39
+ info:
40
+ - documenter
41
+ - code-reviewer