@chankov/agent-fleet 2.0.17 → 2.0.18

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 (662) hide show
  1. package/.pi/agent-fleet/scripts/coms-claude-bridge.ts +75 -49
  2. package/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +18 -20
  3. package/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +3 -1
  4. package/.pi/agents/model-profiles.yaml +5 -5
  5. package/.pi/agents/peers.yaml +3 -3
  6. package/.pi/agents/voices.yaml +1 -1
  7. package/.pi/harnesses/agent-hub/README.md +35 -8
  8. package/.pi/harnesses/agent-hub/agentic-sources.ts +29 -5
  9. package/.pi/harnesses/agent-hub/config/overrides.ts +13 -3
  10. package/.pi/harnesses/agent-hub/delegate.ts +16 -5
  11. package/.pi/harnesses/agent-hub/deterministic-fs.ts +7 -4
  12. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +13 -2
  13. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +2 -0
  14. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +7 -0
  15. package/.pi/harnesses/agent-hub/dispatch-native.ts +1 -1
  16. package/.pi/harnesses/agent-hub/file-discovery/adapters.ts +82 -0
  17. package/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +56 -0
  18. package/.pi/harnesses/agent-hub/file-discovery/broker.ts +125 -0
  19. package/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +33 -0
  20. package/.pi/harnesses/agent-hub/file-discovery/descendant.ts +63 -0
  21. package/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  22. package/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  23. package/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +48 -0
  24. package/.pi/harnesses/agent-hub/file-discovery/hub.ts +152 -0
  25. package/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  26. package/.pi/harnesses/agent-hub/file-discovery/owners.ts +96 -0
  27. package/.pi/harnesses/agent-hub/file-discovery/results.ts +54 -0
  28. package/.pi/harnesses/agent-hub/file-discovery/runtime.ts +120 -0
  29. package/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  30. package/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  31. package/.pi/harnesses/agent-hub/filesystem-tool.ts +74 -26
  32. package/.pi/harnesses/agent-hub/index.ts +23 -5
  33. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +3 -2
  34. package/.pi/harnesses/agent-hub/no-progress.ts +45 -15
  35. package/.pi/harnesses/agent-hub/package.json +1 -1
  36. package/.pi/harnesses/agent-hub/policy/work-mode.ts +2 -1
  37. package/.pi/harnesses/agent-hub/proactive-config.ts +8 -3
  38. package/.pi/harnesses/agent-hub/proactive-external-git.ts +59 -0
  39. package/.pi/harnesses/agent-hub/proactive-external.ts +77 -0
  40. package/.pi/harnesses/agent-hub/proactive-local.ts +25 -7
  41. package/.pi/harnesses/agent-hub/proactive-observer.ts +2 -1
  42. package/.pi/harnesses/agent-hub/proactive-rules.ts +39 -11
  43. package/.pi/harnesses/agent-hub/proactive-runtime.ts +8 -6
  44. package/.pi/harnesses/agent-hub/proactive-snapshot.ts +32 -2
  45. package/.pi/harnesses/agent-hub/proactive-types.ts +5 -1
  46. package/.pi/harnesses/agent-hub/prompts/fragments.ts +21 -49
  47. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +2 -1
  48. package/.pi/harnesses/agent-hub/research/runtime.ts +7 -3
  49. package/.pi/harnesses/agent-hub/research/spawn-run.ts +17 -6
  50. package/.pi/harnesses/agent-hub/spawn.ts +38 -9
  51. package/.pi/harnesses/agent-hub/system1-communication-store.ts +39 -0
  52. package/.pi/harnesses/agent-hub/tools/action-executors.ts +6 -1
  53. package/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  54. package/.pi/harnesses/agent-hub/tools/ask-system1.ts +1 -1
  55. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +4 -4
  56. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +4 -2
  57. package/.pi/harnesses/agent-hub/tools/set-task-tier.ts +3 -3
  58. package/.pi/harnesses/agent-hub/tools/spawn-research.ts +3 -1
  59. package/.pi/harnesses/agent-hub/ui/system1-communication.ts +1 -1
  60. package/.pi/harnesses/agent-hub/work-mode.ts +3 -0
  61. package/.pi/harnesses/coms/package.json +1 -1
  62. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  63. package/.pi/harnesses/lib/context-budget-child-prompt.ts +3 -2
  64. package/.pi/harnesses/lib/deterministic-handle-path.ts +2 -0
  65. package/.pi/harnesses/lib/policy-roots.ts +142 -0
  66. package/.pi/harnesses/lib/system1/config-agentic.js +2 -1
  67. package/.pi/harnesses/lib/system1/config-file-discovery.js +21 -0
  68. package/.pi/harnesses/lib/system1/config-proactive.js +13 -2
  69. package/.pi/harnesses/lib/system1/config-v2.js +8 -5
  70. package/.versions/2.0.18/.pi/agent-fleet/hermes/README.md +347 -0
  71. package/.versions/2.0.18/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  72. package/.versions/2.0.18/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  73. package/.versions/2.0.18/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  74. package/.versions/2.0.18/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  75. package/.versions/2.0.18/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  76. package/.versions/2.0.18/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  77. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  78. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  79. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  80. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  81. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  82. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  83. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  84. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  85. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  86. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  87. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  88. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  89. package/.versions/2.0.18/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  90. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  91. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  92. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  93. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  94. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  95. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  96. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  97. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  98. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  99. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  100. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  101. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  102. package/.versions/2.0.18/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  103. package/.versions/2.0.18/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  104. package/.versions/2.0.18/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  105. package/.versions/2.0.18/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  106. package/.versions/2.0.18/.pi/agent-fleet/scripts/coms-claude-bridge.ts +437 -0
  107. package/.versions/2.0.18/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  108. package/.versions/2.0.18/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  109. package/.versions/2.0.18/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  110. package/.versions/2.0.18/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  111. package/.versions/2.0.18/.pi/agent-fleet/scripts/fleet.ts +217 -0
  112. package/.versions/2.0.18/.pi/agent-fleet/scripts/flow.ts +157 -0
  113. package/.versions/2.0.18/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  114. package/.versions/2.0.18/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  115. package/.versions/2.0.18/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  116. package/.versions/2.0.18/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  117. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
  118. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  119. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  120. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  121. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  122. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  123. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  124. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  125. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  126. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  127. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  128. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  129. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  130. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  131. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  132. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  133. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  134. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  135. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  136. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  137. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  138. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  139. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  140. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  141. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  142. package/.versions/2.0.18/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  143. package/.versions/2.0.18/.pi/agent-fleet/scripts/package-lock.json +35 -0
  144. package/.versions/2.0.18/.pi/agent-fleet/scripts/package.json +9 -0
  145. package/.versions/2.0.18/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  146. package/.versions/2.0.18/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  147. package/.versions/2.0.18/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  148. package/.versions/2.0.18/.pi/agent-fleet/scripts/team-up.ts +378 -0
  149. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  150. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  151. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  152. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  153. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  154. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  155. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  156. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  157. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  158. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  159. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  160. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  161. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  162. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  163. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +36 -0
  164. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  165. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  166. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  167. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  168. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  169. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  170. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  171. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  172. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  173. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  174. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  175. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  176. package/.versions/2.0.18/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  177. package/.versions/2.0.18/.pi/agents/dispatch-policy.yaml +32 -0
  178. package/.versions/2.0.18/.pi/agents/model-profiles.yaml +134 -0
  179. package/.versions/2.0.18/.pi/agents/peers.yaml +147 -0
  180. package/.versions/2.0.18/.pi/agents/teams.yaml +41 -0
  181. package/.versions/2.0.18/.pi/agents/voices.yaml +13 -0
  182. package/.versions/2.0.18/.pi/damage-control-rules.yaml +297 -0
  183. package/.versions/2.0.18/.pi/extensions/btw/README.md +120 -0
  184. package/.versions/2.0.18/.pi/extensions/btw/index.ts +914 -0
  185. package/.versions/2.0.18/.pi/extensions/btw/package.json +6 -0
  186. package/.versions/2.0.18/.pi/extensions/btw/state.js +179 -0
  187. package/.versions/2.0.18/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  188. package/.versions/2.0.18/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  189. package/.versions/2.0.18/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  190. package/.versions/2.0.18/.pi/extensions/compact-and-continue/README.md +42 -0
  191. package/.versions/2.0.18/.pi/extensions/compact-and-continue/index.ts +120 -0
  192. package/.versions/2.0.18/.pi/extensions/compact-and-continue/package.json +6 -0
  193. package/.versions/2.0.18/.pi/extensions/mcp-bridge/README.md +46 -0
  194. package/.versions/2.0.18/.pi/extensions/mcp-bridge/index.ts +206 -0
  195. package/.versions/2.0.18/.pi/extensions/mcp-bridge/package.json +6 -0
  196. package/.versions/2.0.18/.pi/extensions/package-lock.json +1175 -0
  197. package/.versions/2.0.18/.pi/extensions/package.json +9 -0
  198. package/.versions/2.0.18/.pi/extensions/pi-voice-stt/README.md +224 -0
  199. package/.versions/2.0.18/.pi/extensions/pi-voice-stt/config.ts +198 -0
  200. package/.versions/2.0.18/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  201. package/.versions/2.0.18/.pi/extensions/pi-voice-stt/index.ts +248 -0
  202. package/.versions/2.0.18/.pi/extensions/pi-voice-stt/package.json +6 -0
  203. package/.versions/2.0.18/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  204. package/.versions/2.0.18/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  205. package/.versions/2.0.18/.pi/harnesses/agent-hub/README.md +1483 -0
  206. package/.versions/2.0.18/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  207. package/.versions/2.0.18/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  208. package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  209. package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  210. package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
  211. package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  212. package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  213. package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
  214. package/.versions/2.0.18/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  215. package/.versions/2.0.18/.pi/harnesses/agent-hub/artifacts.js +146 -0
  216. package/.versions/2.0.18/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  217. package/.versions/2.0.18/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  218. package/.versions/2.0.18/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  219. package/.versions/2.0.18/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  220. package/.versions/2.0.18/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  221. package/.versions/2.0.18/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
  222. package/.versions/2.0.18/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  223. package/.versions/2.0.18/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  224. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  225. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  226. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  227. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  228. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  229. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  230. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  231. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  232. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  233. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  234. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  235. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  236. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  237. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  238. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  239. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  240. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/context.ts +47 -0
  241. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  242. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  243. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  244. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  245. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  246. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  247. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  248. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  249. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  250. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  251. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  252. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  253. package/.versions/2.0.18/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  254. package/.versions/2.0.18/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  255. package/.versions/2.0.18/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
  256. package/.versions/2.0.18/.pi/harnesses/agent-hub/config/overrides.ts +165 -0
  257. package/.versions/2.0.18/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  258. package/.versions/2.0.18/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  259. package/.versions/2.0.18/.pi/harnesses/agent-hub/context/budgets.ts +206 -0
  260. package/.versions/2.0.18/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  261. package/.versions/2.0.18/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  262. package/.versions/2.0.18/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  263. package/.versions/2.0.18/.pi/harnesses/agent-hub/context-window.js +108 -0
  264. package/.versions/2.0.18/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  265. package/.versions/2.0.18/.pi/harnesses/agent-hub/delegate.ts +478 -0
  266. package/.versions/2.0.18/.pi/harnesses/agent-hub/deterministic-fs.ts +169 -0
  267. package/.versions/2.0.18/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  268. package/.versions/2.0.18/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  269. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
  270. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  271. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
  272. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +270 -0
  273. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +233 -0
  274. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-native-types.ts +267 -0
  275. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-native.ts +234 -0
  276. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  277. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  278. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  279. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  280. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  281. package/.versions/2.0.18/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  282. package/.versions/2.0.18/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  283. package/.versions/2.0.18/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  284. package/.versions/2.0.18/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  285. package/.versions/2.0.18/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  286. package/.versions/2.0.18/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  287. package/.versions/2.0.18/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  288. package/.versions/2.0.18/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  289. package/.versions/2.0.18/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  290. package/.versions/2.0.18/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  291. package/.versions/2.0.18/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  292. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/adapters.ts +82 -0
  293. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +56 -0
  294. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/broker.ts +125 -0
  295. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +33 -0
  296. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/descendant.ts +63 -0
  297. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  298. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  299. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +48 -0
  300. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/hub.ts +152 -0
  301. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  302. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +99 -0
  303. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/owners.ts +96 -0
  304. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/results.ts +54 -0
  305. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/runtime.ts +120 -0
  306. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  307. package/.versions/2.0.18/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  308. package/.versions/2.0.18/.pi/harnesses/agent-hub/filesystem-tool.ts +185 -0
  309. package/.versions/2.0.18/.pi/harnesses/agent-hub/fixtures/registration-surface.json +65 -0
  310. package/.versions/2.0.18/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  311. package/.versions/2.0.18/.pi/harnesses/agent-hub/footer.ts +30 -0
  312. package/.versions/2.0.18/.pi/harnesses/agent-hub/helpers.ts +270 -0
  313. package/.versions/2.0.18/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  314. package/.versions/2.0.18/.pi/harnesses/agent-hub/index.ts +2625 -0
  315. package/.versions/2.0.18/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  316. package/.versions/2.0.18/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  317. package/.versions/2.0.18/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +133 -0
  318. package/.versions/2.0.18/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  319. package/.versions/2.0.18/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +144 -0
  320. package/.versions/2.0.18/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  321. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  322. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  323. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  324. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  325. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  326. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  327. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  328. package/.versions/2.0.18/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  329. package/.versions/2.0.18/.pi/harnesses/agent-hub/no-progress.ts +593 -0
  330. package/.versions/2.0.18/.pi/harnesses/agent-hub/orchestration-activation.ts +112 -0
  331. package/.versions/2.0.18/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  332. package/.versions/2.0.18/.pi/harnesses/agent-hub/orchestration-route.ts +76 -0
  333. package/.versions/2.0.18/.pi/harnesses/agent-hub/package.json +7 -0
  334. package/.versions/2.0.18/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  335. package/.versions/2.0.18/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  336. package/.versions/2.0.18/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  337. package/.versions/2.0.18/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  338. package/.versions/2.0.18/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  339. package/.versions/2.0.18/.pi/harnesses/agent-hub/policy/work-mode.ts +137 -0
  340. package/.versions/2.0.18/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  341. package/.versions/2.0.18/.pi/harnesses/agent-hub/presentation.ts +48 -0
  342. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-config.ts +21 -0
  343. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  344. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-external-git.ts +59 -0
  345. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-external.ts +77 -0
  346. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  347. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  348. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
  349. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
  350. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
  351. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
  352. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  353. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  354. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-snapshot.ts +258 -0
  355. package/.versions/2.0.18/.pi/harnesses/agent-hub/proactive-types.ts +67 -0
  356. package/.versions/2.0.18/.pi/harnesses/agent-hub/process-obligations.ts +158 -0
  357. package/.versions/2.0.18/.pi/harnesses/agent-hub/prompts/context.ts +56 -0
  358. package/.versions/2.0.18/.pi/harnesses/agent-hub/prompts/fragments.ts +95 -0
  359. package/.versions/2.0.18/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  360. package/.versions/2.0.18/.pi/harnesses/agent-hub/prompts/system-prompt.ts +125 -0
  361. package/.versions/2.0.18/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  362. package/.versions/2.0.18/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  363. package/.versions/2.0.18/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  364. package/.versions/2.0.18/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  365. package/.versions/2.0.18/.pi/harnesses/agent-hub/recovery-contract.ts +150 -0
  366. package/.versions/2.0.18/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  367. package/.versions/2.0.18/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  368. package/.versions/2.0.18/.pi/harnesses/agent-hub/research/runtime.ts +201 -0
  369. package/.versions/2.0.18/.pi/harnesses/agent-hub/research/spawn-run.ts +194 -0
  370. package/.versions/2.0.18/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  371. package/.versions/2.0.18/.pi/harnesses/agent-hub/return-contract.js +349 -0
  372. package/.versions/2.0.18/.pi/harnesses/agent-hub/return-extract.js +77 -0
  373. package/.versions/2.0.18/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  374. package/.versions/2.0.18/.pi/harnesses/agent-hub/review-findings.js +104 -0
  375. package/.versions/2.0.18/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  376. package/.versions/2.0.18/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  377. package/.versions/2.0.18/.pi/harnesses/agent-hub/run-budget.js +554 -0
  378. package/.versions/2.0.18/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  379. package/.versions/2.0.18/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  380. package/.versions/2.0.18/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  381. package/.versions/2.0.18/.pi/harnesses/agent-hub/scope-gate.js +144 -0
  382. package/.versions/2.0.18/.pi/harnesses/agent-hub/session-audit.ts +313 -0
  383. package/.versions/2.0.18/.pi/harnesses/agent-hub/session-health.js +110 -0
  384. package/.versions/2.0.18/.pi/harnesses/agent-hub/session-start.ts +42 -0
  385. package/.versions/2.0.18/.pi/harnesses/agent-hub/spawn.ts +563 -0
  386. package/.versions/2.0.18/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  387. package/.versions/2.0.18/.pi/harnesses/agent-hub/system1-communication-store.ts +190 -0
  388. package/.versions/2.0.18/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  389. package/.versions/2.0.18/.pi/harnesses/agent-hub/system1-runtime.ts +258 -0
  390. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  391. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-authorization.ts +122 -0
  392. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-config.ts +29 -0
  393. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  394. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  395. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-obligations.ts +104 -0
  396. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  397. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  398. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  399. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  400. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-runtime.ts +125 -0
  401. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  402. package/.versions/2.0.18/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  403. package/.versions/2.0.18/.pi/harnesses/agent-hub/timeline.ts +72 -0
  404. package/.versions/2.0.18/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  405. package/.versions/2.0.18/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  406. package/.versions/2.0.18/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  407. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/action-executors.ts +213 -0
  408. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  409. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  410. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  411. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/context.ts +144 -0
  412. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
  413. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +560 -0
  414. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  415. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  416. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  417. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
  418. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  419. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  420. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
  421. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  422. package/.versions/2.0.18/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  423. package/.versions/2.0.18/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  424. package/.versions/2.0.18/.pi/harnesses/agent-hub/types.ts +66 -0
  425. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  426. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
  427. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  428. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  429. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
  430. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  431. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  432. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  433. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  434. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  435. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  436. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  437. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  438. package/.versions/2.0.18/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  439. package/.versions/2.0.18/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  440. package/.versions/2.0.18/.pi/harnesses/agent-hub/version.ts +42 -0
  441. package/.versions/2.0.18/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  442. package/.versions/2.0.18/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  443. package/.versions/2.0.18/.pi/harnesses/agent-hub/work-mode.ts +187 -0
  444. package/.versions/2.0.18/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  445. package/.versions/2.0.18/.pi/harnesses/ask-user-remote/README.md +59 -0
  446. package/.versions/2.0.18/.pi/harnesses/ask-user-remote/index.ts +558 -0
  447. package/.versions/2.0.18/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  448. package/.versions/2.0.18/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  449. package/.versions/2.0.18/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  450. package/.versions/2.0.18/.pi/harnesses/coms/README.md +100 -0
  451. package/.versions/2.0.18/.pi/harnesses/coms/index.ts +282 -0
  452. package/.versions/2.0.18/.pi/harnesses/coms/package.json +7 -0
  453. package/.versions/2.0.18/.pi/harnesses/coms/version.ts +42 -0
  454. package/.versions/2.0.18/.pi/harnesses/damage-control-continue/README.md +135 -0
  455. package/.versions/2.0.18/.pi/harnesses/damage-control-continue/index.ts +533 -0
  456. package/.versions/2.0.18/.pi/harnesses/damage-control-continue/package.json +7 -0
  457. package/.versions/2.0.18/.pi/harnesses/damage-control-continue/version.ts +42 -0
  458. package/.versions/2.0.18/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  459. package/.versions/2.0.18/.pi/harnesses/lib/coms-core-io.ts +385 -0
  460. package/.versions/2.0.18/.pi/harnesses/lib/coms-core.ts +577 -0
  461. package/.versions/2.0.18/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  462. package/.versions/2.0.18/.pi/harnesses/lib/context-budget-child-prompt.ts +220 -0
  463. package/.versions/2.0.18/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  464. package/.versions/2.0.18/.pi/harnesses/lib/context-budget-view.ts +107 -0
  465. package/.versions/2.0.18/.pi/harnesses/lib/context-budget.ts +114 -0
  466. package/.versions/2.0.18/.pi/harnesses/lib/damage-control-shared.ts +226 -0
  467. package/.versions/2.0.18/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
  468. package/.versions/2.0.18/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  469. package/.versions/2.0.18/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  470. package/.versions/2.0.18/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  471. package/.versions/2.0.18/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  472. package/.versions/2.0.18/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
  473. package/.versions/2.0.18/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  474. package/.versions/2.0.18/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  475. package/.versions/2.0.18/.pi/harnesses/lib/fleet-panel.ts +34 -0
  476. package/.versions/2.0.18/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  477. package/.versions/2.0.18/.pi/harnesses/lib/fleet-selection.ts +24 -0
  478. package/.versions/2.0.18/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  479. package/.versions/2.0.18/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  480. package/.versions/2.0.18/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  481. package/.versions/2.0.18/.pi/harnesses/lib/herdr-client.ts +472 -0
  482. package/.versions/2.0.18/.pi/harnesses/lib/herdr-presence.ts +399 -0
  483. package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  484. package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  485. package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  486. package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  487. package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  488. package/.versions/2.0.18/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  489. package/.versions/2.0.18/.pi/harnesses/lib/policy-roots.ts +142 -0
  490. package/.versions/2.0.18/.pi/harnesses/lib/safe-source-read.js +29 -0
  491. package/.versions/2.0.18/.pi/harnesses/lib/spawned-peers.js +191 -0
  492. package/.versions/2.0.18/.pi/harnesses/lib/system1/config-agentic.js +15 -0
  493. package/.versions/2.0.18/.pi/harnesses/lib/system1/config-file-discovery.js +21 -0
  494. package/.versions/2.0.18/.pi/harnesses/lib/system1/config-json.js +37 -0
  495. package/.versions/2.0.18/.pi/harnesses/lib/system1/config-loader.js +44 -0
  496. package/.versions/2.0.18/.pi/harnesses/lib/system1/config-proactive.js +68 -0
  497. package/.versions/2.0.18/.pi/harnesses/lib/system1/config-triage.js +42 -0
  498. package/.versions/2.0.18/.pi/harnesses/lib/system1/config-v2.js +106 -0
  499. package/.versions/2.0.18/.pi/harnesses/lib/system1/config.js +50 -0
  500. package/.versions/2.0.18/.pi/harnesses/lib/system1/contracts.ts +154 -0
  501. package/.versions/2.0.18/.pi/harnesses/lib/system1/demo.ts +95 -0
  502. package/.versions/2.0.18/.pi/harnesses/lib/system1/jev.ts +503 -0
  503. package/.versions/2.0.18/.pi/harnesses/lib/system1/selection.js +11 -0
  504. package/.versions/2.0.18/.pi/harnesses/lib/system1/service.ts +245 -0
  505. package/.versions/2.0.18/.pi/harnesses/lib/update-check.ts +222 -0
  506. package/.versions/2.0.18/.pi/harnesses/package-lock.json +2039 -0
  507. package/.versions/2.0.18/.pi/harnesses/package.json +10 -0
  508. package/.versions/2.0.18/.pi/prompts/af-build.md +27 -0
  509. package/.versions/2.0.18/.pi/prompts/af-code-simplify.md +22 -0
  510. package/.versions/2.0.18/.pi/prompts/af-constraints.md +31 -0
  511. package/.versions/2.0.18/.pi/prompts/af-plan.md +17 -0
  512. package/.versions/2.0.18/.pi/prompts/af-review.md +16 -0
  513. package/.versions/2.0.18/.pi/prompts/af-set-hermes-telegram.md +15 -0
  514. package/.versions/2.0.18/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  515. package/.versions/2.0.18/.pi/prompts/af-setup-rules.md +20 -0
  516. package/.versions/2.0.18/.pi/prompts/af-ship.md +17 -0
  517. package/.versions/2.0.18/.pi/prompts/af-spec.md +15 -0
  518. package/.versions/2.0.18/.pi/prompts/af-test.md +19 -0
  519. package/.versions/2.0.18/.pi/skills/bowser/SKILL.md +145 -0
  520. package/.versions/2.0.18/.version +1 -0
  521. package/.versions/2.0.18/agents/architect.md +24 -0
  522. package/.versions/2.0.18/agents/bowser.md +28 -0
  523. package/.versions/2.0.18/agents/builder.md +55 -0
  524. package/.versions/2.0.18/agents/code-reviewer.md +209 -0
  525. package/.versions/2.0.18/agents/deep-researcher.md +32 -0
  526. package/.versions/2.0.18/agents/documenter.md +22 -0
  527. package/.versions/2.0.18/agents/orchestrator.md +22 -0
  528. package/.versions/2.0.18/agents/plan-reviewer.md +83 -0
  529. package/.versions/2.0.18/agents/planner.md +105 -0
  530. package/.versions/2.0.18/agents/releaser.md +24 -0
  531. package/.versions/2.0.18/agents/researcher.md +30 -0
  532. package/.versions/2.0.18/agents/security-auditor.md +167 -0
  533. package/.versions/2.0.18/agents/test-engineer.md +153 -0
  534. package/.versions/2.0.18/agents/web-debugger.md +44 -0
  535. package/.versions/2.0.18/agents/web-performance-auditor.md +194 -0
  536. package/.versions/2.0.18/bin/catalog/harness-runtime-closure.json +73 -0
  537. package/.versions/2.0.18/codex/fleet-session-client/SKILL.md +34 -0
  538. package/.versions/2.0.18/codex/fleet-session-client.zip +0 -0
  539. package/.versions/2.0.18/docs/ARCHITECTURE.md +874 -0
  540. package/.versions/2.0.18/docs/agent-fleet-setup.md +1101 -0
  541. package/.versions/2.0.18/docs/claude-code-coms-bridge.md +147 -0
  542. package/.versions/2.0.18/docs/codex-session-bridge.md +219 -0
  543. package/.versions/2.0.18/docs/coms-hermes-bridge.md +188 -0
  544. package/.versions/2.0.18/docs/getting-started.md +126 -0
  545. package/.versions/2.0.18/docs/npm-install.md +535 -0
  546. package/.versions/2.0.18/docs/pi-extensions.md +454 -0
  547. package/.versions/2.0.18/docs/pi-setup.md +92 -0
  548. package/.versions/2.0.18/docs/skill-anatomy.md +150 -0
  549. package/.versions/2.0.18/install-manifest.json +3193 -0
  550. package/.versions/2.0.18/justfile +247 -0
  551. package/.versions/2.0.18/manifest-meta.json +1071 -0
  552. package/.versions/2.0.18/references/accessibility-checklist.md +160 -0
  553. package/.versions/2.0.18/references/communication-contract.md +26 -0
  554. package/.versions/2.0.18/references/definition-of-done.md +67 -0
  555. package/.versions/2.0.18/references/fleet-coordination-patterns.md +171 -0
  556. package/.versions/2.0.18/references/observability-checklist.md +92 -0
  557. package/.versions/2.0.18/references/orchestration-patterns.md +370 -0
  558. package/.versions/2.0.18/references/performance-checklist.md +236 -0
  559. package/.versions/2.0.18/references/prompting-patterns.md +380 -0
  560. package/.versions/2.0.18/references/security-checklist.md +245 -0
  561. package/.versions/2.0.18/references/testing-patterns.md +235 -0
  562. package/.versions/2.0.18/references/workflow-authoring.md +304 -0
  563. package/.versions/2.0.18/skills/_internal/grilling.md +59 -0
  564. package/.versions/2.0.18/skills/browser-testing-with-devtools/SKILL.md +351 -0
  565. package/.versions/2.0.18/skills/code-review-and-quality/SKILL.md +396 -0
  566. package/.versions/2.0.18/skills/compound-learning/SKILL.md +137 -0
  567. package/.versions/2.0.18/skills/constraint-driven-development/SKILL.md +338 -0
  568. package/.versions/2.0.18/skills/constraint-driven-development/references/floor-guard.md +99 -0
  569. package/.versions/2.0.18/skills/context-engineering/SKILL.md +341 -0
  570. package/.versions/2.0.18/skills/deprecation-and-migration/SKILL.md +247 -0
  571. package/.versions/2.0.18/skills/designing-agents/SKILL.md +394 -0
  572. package/.versions/2.0.18/skills/designing-agents/pi-harness-authoring.md +222 -0
  573. package/.versions/2.0.18/skills/drafting-workflows/SKILL.md +143 -0
  574. package/.versions/2.0.18/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  575. package/.versions/2.0.18/skills/frontend-ui-engineering/SKILL.md +328 -0
  576. package/.versions/2.0.18/skills/git-workflow-and-versioning/SKILL.md +316 -0
  577. package/.versions/2.0.18/skills/idea-refine/SKILL.md +182 -0
  578. package/.versions/2.0.18/skills/idea-refine/examples.md +238 -0
  579. package/.versions/2.0.18/skills/idea-refine/frameworks.md +99 -0
  580. package/.versions/2.0.18/skills/idea-refine/refinement-criteria.md +113 -0
  581. package/.versions/2.0.18/skills/idea-refine/scripts/idea-refine.sh +15 -0
  582. package/.versions/2.0.18/skills/incremental-implementation/SKILL.md +353 -0
  583. package/.versions/2.0.18/skills/interview-me/SKILL.md +226 -0
  584. package/.versions/2.0.18/skills/orchestration-verification/SKILL.md +182 -0
  585. package/.versions/2.0.18/skills/peer-coms/SKILL.md +90 -0
  586. package/.versions/2.0.18/skills/performance-optimization/SKILL.md +496 -0
  587. package/.versions/2.0.18/skills/planning-and-task-breakdown/SKILL.md +318 -0
  588. package/.versions/2.0.18/skills/repository-ai-setup/SKILL.md +135 -0
  589. package/.versions/2.0.18/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  590. package/.versions/2.0.18/skills/repository-ai-setup/references/apply-contract.md +74 -0
  591. package/.versions/2.0.18/skills/repository-ai-setup/references/provenance-template.md +16 -0
  592. package/.versions/2.0.18/skills/repository-ai-setup/references/setup-flow.md +108 -0
  593. package/.versions/2.0.18/skills/repository-ai-setup/references/verify-setup.md +20 -0
  594. package/.versions/2.0.18/skills/repository-ai-setup.zip +0 -0
  595. package/.versions/2.0.18/skills/security-and-hardening/SKILL.md +524 -0
  596. package/.versions/2.0.18/skills/spec-driven-development/SKILL.md +295 -0
  597. package/.versions/2.0.18/skills/using-agent-skills/SKILL.md +198 -0
  598. package/.versions/2.0.18/vendor/agent-skills-upstream/LICENSE +21 -0
  599. package/.versions/2.0.18/vendor/agent-skills-upstream/README.md +430 -0
  600. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  601. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  602. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  603. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  604. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  605. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  606. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  607. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  608. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  609. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  610. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  611. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  612. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  613. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  614. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  615. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  616. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  617. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  618. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  619. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  620. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  621. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  622. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  623. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  624. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  625. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  626. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  627. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  628. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  629. package/.versions/2.0.18/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  630. package/CHANGELOG.md +6 -0
  631. package/README.md +2 -2
  632. package/agents/architect.md +2 -2
  633. package/agents/bowser.md +1 -1
  634. package/agents/builder.md +5 -5
  635. package/agents/code-reviewer.md +2 -2
  636. package/agents/deep-researcher.md +2 -2
  637. package/agents/documenter.md +3 -3
  638. package/agents/orchestrator.md +2 -2
  639. package/agents/plan-reviewer.md +2 -2
  640. package/agents/planner.md +4 -4
  641. package/agents/releaser.md +2 -2
  642. package/agents/researcher.md +2 -2
  643. package/agents/security-auditor.md +2 -2
  644. package/agents/test-engineer.md +4 -4
  645. package/agents/web-debugger.md +2 -2
  646. package/agents/web-performance-auditor.md +2 -2
  647. package/bin/cli.js +2 -2
  648. package/bin/lib/external-content.js +33 -0
  649. package/bin/lib/project-provenance.js +19 -13
  650. package/bin/lib/transaction.js +32 -1
  651. package/docs/ARCHITECTURE.md +42 -2
  652. package/docs/agent-fleet-setup.md +4 -4
  653. package/docs/claude-code-coms-bridge.md +17 -4
  654. package/docs/external-project-ai-content.md +48 -0
  655. package/docs/npm-install.md +5 -0
  656. package/docs/system1-agentic.md +27 -0
  657. package/docs/system1-config.md +23 -1
  658. package/docs/system1-file-discovery.md +220 -0
  659. package/install-manifest.json +1 -1
  660. package/package.json +15 -6
  661. package/skills/repository-ai-setup/SKILL.md +18 -0
  662. package/skills/repository-ai-setup.zip +0 -0
@@ -0,0 +1,192 @@
1
+ ---
2
+ name: using-agent-skills
3
+ description: Discovers and invokes agent skills. Use when starting a session, or when you need to decide which skill or workflow applies to the piece of work at hand. This is the meta-skill that governs how all other skills are discovered and invoked.
4
+ ---
5
+
6
+ # Using Agent Skills
7
+
8
+ ## Overview
9
+
10
+ Agent Skills is a collection of engineering workflow skills organized by development phase. Each skill encodes a specific process that senior engineers follow. This meta-skill helps you discover and apply the right skill for your current task.
11
+
12
+ ## Skill Discovery
13
+
14
+ When a task arrives, identify the development phase and apply the corresponding skill:
15
+
16
+ ```
17
+ Task arrives
18
+ │
19
+ ├── Don't know what you want yet? ──────→ interview-me
20
+ ├── Have a rough concept, need variants? → idea-refine
21
+ ├── New project/feature/change? ──→ spec-driven-development
22
+ ├── No quality bar written down? ──→ constraint-driven-development
23
+ ├── Have a spec, need tasks? ──────→ planning-and-task-breakdown
24
+ ├── Implementing code? ────────────→ incremental-implementation
25
+ │ ├── UI work? ─────────────────→ frontend-ui-engineering
26
+ │ ├── API work? ────────────────→ api-and-interface-design
27
+ │ ├── Need better context? ─────→ context-engineering
28
+ │ ├── Need doc-verified code? ───→ source-driven-development
29
+ │ └── Stakes high / unfamiliar code? ──→ doubt-driven-development
30
+ ├── Writing/running tests? ────────→ test-driven-development
31
+ │ └── Browser-based? ───────────→ browser-testing-with-devtools
32
+ ├── Something broke? ──────────────→ debugging-and-error-recovery
33
+ ├── Reviewing code? ───────────────→ code-review-and-quality
34
+ │ ├── Too complex? ─────────────→ code-simplification
35
+ │ ├── Security concerns? ───────→ security-and-hardening
36
+ │ └── Performance concerns? ────→ performance-optimization
37
+ ├── Committing/branching? ─────────→ git-workflow-and-versioning
38
+ ├── CI/CD pipeline work? ──────────→ ci-cd-and-automation
39
+ ├── Deprecating/migrating? ────────→ deprecation-and-migration
40
+ ├── Writing docs/ADRs? ───────────→ documentation-and-adrs
41
+ ├── Adding logs/metrics/alerts? ───→ observability-and-instrumentation
42
+ └── Deploying/launching? ─────────→ shipping-and-launch
43
+ ```
44
+
45
+ ## Core Operating Behaviors
46
+
47
+ These behaviors apply at all times, across all skills. They are non-negotiable.
48
+
49
+ ### 1. Surface Assumptions
50
+
51
+ Before implementing anything non-trivial, explicitly state your assumptions:
52
+
53
+ ```
54
+ ASSUMPTIONS I'M MAKING:
55
+ 1. [assumption about requirements]
56
+ 2. [assumption about architecture]
57
+ 3. [assumption about scope]
58
+ → Correct me now or I'll proceed with these.
59
+ ```
60
+
61
+ Don't silently fill in ambiguous requirements. The most common failure mode is making wrong assumptions and running with them unchecked. Surface uncertainty early — it's cheaper than rework.
62
+
63
+ ### 2. Manage Confusion Actively
64
+
65
+ When you encounter inconsistencies, conflicting requirements, or unclear specifications:
66
+
67
+ 1. **STOP.** Do not proceed with a guess.
68
+ 2. Name the specific confusion.
69
+ 3. Present the tradeoff or ask the clarifying question.
70
+ 4. Wait for resolution before continuing.
71
+
72
+ **Bad:** Silently picking one interpretation and hoping it's right.
73
+ **Good:** "I see X in the spec but Y in the existing code. Which takes precedence?"
74
+
75
+ ### 3. Push Back When Warranted
76
+
77
+ You are not a yes-machine. When an approach has clear problems:
78
+
79
+ - Point out the issue directly
80
+ - Explain the concrete downside (quantify when possible — "this adds ~200ms latency" not "this might be slower")
81
+ - Propose an alternative
82
+ - Accept the human's decision if they override with full information
83
+
84
+ Sycophancy is a failure mode. "Of course!" followed by implementing a bad idea helps no one. Honest technical disagreement is more valuable than false agreement.
85
+
86
+ ### 4. Enforce Simplicity
87
+
88
+ Your natural tendency is to overcomplicate. Actively resist it.
89
+
90
+ Before finishing any implementation, ask:
91
+ - Can this be done in fewer lines?
92
+ - Are these abstractions earning their complexity?
93
+ - Would a staff engineer look at this and say "why didn't you just..."?
94
+
95
+ If you build 1000 lines and 100 would suffice, you have failed. Prefer the boring, obvious solution. Cleverness is expensive.
96
+
97
+ ### 5. Maintain Scope Discipline
98
+
99
+ Touch only what you're asked to touch.
100
+
101
+ Do NOT:
102
+ - Remove comments you don't understand
103
+ - "Clean up" code orthogonal to the task
104
+ - Refactor adjacent systems as a side effect
105
+ - Delete code that seems unused without explicit approval
106
+ - Add features not in the spec because they "seem useful"
107
+
108
+ Your job is surgical precision, not unsolicited renovation.
109
+
110
+ ### 6. Verify, Don't Assume
111
+
112
+ Every skill includes a verification step. A task is not complete until verification passes. "Seems right" is never sufficient — there must be evidence (passing tests, build output, runtime data).
113
+
114
+ Per-skill verification is the local check. The project-wide bar that applies to *every* change, regardless of which skill is active, is the Definition of Done: tests pass, no regressions, behavior verified at runtime, docs updated. See `../../references/definition-of-done.md`. It complements each task's acceptance criteria rather than replacing them.
115
+
116
+ ## Failure Modes to Avoid
117
+
118
+ These are the subtle errors that look like productivity but create problems:
119
+
120
+ 1. Making wrong assumptions without checking
121
+ 2. Not managing your own confusion — plowing ahead when lost
122
+ 3. Not surfacing inconsistencies you notice
123
+ 4. Not presenting tradeoffs on non-obvious decisions
124
+ 5. Being sycophantic ("Of course!") to approaches with clear problems
125
+ 6. Overcomplicating code and APIs
126
+ 7. Modifying code or comments orthogonal to the task
127
+ 8. Removing things you don't fully understand
128
+ 9. Building without a spec because "it's obvious"
129
+ 10. Skipping verification because "it looks right"
130
+
131
+ ## Skill Rules
132
+
133
+ 1. **Check for an applicable skill before starting work.** Skills encode processes that prevent common mistakes.
134
+
135
+ 2. **Skills are workflows, not suggestions.** Follow the steps in order. Don't skip verification steps.
136
+
137
+ 3. **Multiple skills can apply.** A feature implementation might involve `idea-refine` → `spec-driven-development` → `planning-and-task-breakdown` → `incremental-implementation` → `test-driven-development` → `code-review-and-quality` → `code-simplification` → `shipping-and-launch` in sequence.
138
+
139
+ 4. **When in doubt, start with a spec.** If the task is non-trivial and there's no spec, begin with `spec-driven-development`.
140
+
141
+ ## Lifecycle Sequence
142
+
143
+ For a complete feature, the typical skill sequence is:
144
+
145
+ ```
146
+ 1. interview-me → Extract what the user actually wants
147
+ 2. idea-refine → Refine vague ideas
148
+ 3. spec-driven-development → Define what we're building
149
+ 4. planning-and-task-breakdown → Break into verifiable chunks
150
+ 5. context-engineering → Load the right context
151
+ 6. source-driven-development → Verify against official docs
152
+ 7. incremental-implementation → Build slice by slice
153
+ 8. observability-and-instrumentation → Instrument as you build (runs parallel with 7-9, not after)
154
+ 9. doubt-driven-development → Cross-examine non-trivial decisions in-flight
155
+ 10. test-driven-development → Prove each slice works
156
+ 11. code-review-and-quality → Review before merge
157
+ 12. code-simplification → Reduce unnecessary complexity while preserving behavior
158
+ 13. git-workflow-and-versioning → Clean commit history
159
+ 14. documentation-and-adrs → Document decisions
160
+ 15. deprecation-and-migration → Retire old systems and move users safely when needed
161
+ 16. shipping-and-launch → Deploy safely
162
+ ```
163
+
164
+ Not every task needs every skill. A bug fix might only need: `debugging-and-error-recovery` → `test-driven-development` → `code-review-and-quality`.
165
+
166
+ ## Quick Reference
167
+
168
+ | Phase | Skill | One-Line Summary |
169
+ |-------|-------|-----------------|
170
+ | Define | interview-me | Surface what the user actually wants before any plan, spec, or code exists |
171
+ | Define | idea-refine | Refine ideas through structured divergent and convergent thinking |
172
+ | Define | spec-driven-development | Requirements and acceptance criteria before code |
173
+ | Plan | planning-and-task-breakdown | Decompose into small, verifiable tasks |
174
+ | Build | incremental-implementation | Thin vertical slices, test each before expanding |
175
+ | Build | source-driven-development | Verify against official docs before implementing |
176
+ | Build | doubt-driven-development | Adversarial fresh-context review of every non-trivial decision |
177
+ | Build | context-engineering | Right context at the right time |
178
+ | Build | frontend-ui-engineering | Production-quality UI with accessibility |
179
+ | Build | api-and-interface-design | Stable interfaces with clear contracts |
180
+ | Verify | test-driven-development | Failing test first, then make it pass |
181
+ | Verify | browser-testing-with-devtools | Chrome DevTools MCP for runtime verification |
182
+ | Verify | debugging-and-error-recovery | Reproduce → localize → fix → guard |
183
+ | Review | code-review-and-quality | Five-axis review with quality gates |
184
+ | Review | code-simplification | Preserve behavior while reducing unnecessary complexity |
185
+ | Review | security-and-hardening | OWASP prevention, input validation, least privilege |
186
+ | Review | performance-optimization | Measure first, optimize only what matters |
187
+ | Ship | git-workflow-and-versioning | Atomic commits, clean history |
188
+ | Ship | ci-cd-and-automation | Automated quality gates on every change |
189
+ | Ship | deprecation-and-migration | Remove old systems and migrate users safely |
190
+ | Ship | documentation-and-adrs | Document the why, not just the what |
191
+ | Ship | observability-and-instrumentation | Structured logs, RED metrics, traces, symptom-based alerts |
192
+ | Ship | shipping-and-launch | Pre-launch checklist, monitoring, rollback plan |
package/CHANGELOG.md CHANGED
@@ -1,5 +1,11 @@
1
1
  # Agent Fleet changelog
2
2
 
3
+ ## 2.0.18
4
+
5
+ ### Patch Changes
6
+
7
+ - ade610d: Declare `@sinclair/typebox` and `typebox` as wildcard peer dependencies instead of runtime dependencies so Pi uses its host-provided modules without startup warnings. Keep both packages as development dependencies for local tests and typechecking. Fixes #36.
8
+
3
9
  ## 2.0.17
4
10
 
5
11
  ### Patch Changes
package/README.md CHANGED
@@ -211,7 +211,7 @@ Versioned with [semver](https://semver.org) — [CHANGELOG.md](CHANGELOG.md) ·
211
211
  | **GitHub Copilot subscription** | `github-copilot/claude-sonnet-4.6`, `github-copilot/claude-haiku-4.5` | Common override for `builder` / reviewers |
212
212
  | **Claude subscription** | a real **Claude Code pane**, bridged in as a first-class coms peer | `plan-reviewer` and `code-reviewer` — cross-model review |
213
213
  | **Ollama — cloud *or* local** | `ollama/glm-5.2:cloud`, `ollama/minimax-m3:cloud`, or a model on your own box | Overflow capacity and cost control |
214
- | **Anything else pi can address** | local MLX / llama.cpp / LM Studio weights; bundled `local-full` and `local-workers` use `omlx/Qwen3.6-35B-A3B-4bit` |
214
+ | **Anything else pi can address** | local MLX / llama.cpp / LM Studio weights; bundled `local-full` and `local-workers` use `incoai/Qwen3.8-27B-Splash` |
215
215
 
216
216
  Two consequences worth spelling out:
217
217
 
@@ -222,7 +222,7 @@ Two consequences worth spelling out:
222
222
  /af-models fast # move the whole team down a tier
223
223
  /af-agent-model builder github-copilot/claude-sonnet-4.6
224
224
  /af-agent-models-substitute # visually pick a session-wide source → target mapping
225
- /af-agent-models-substitute openai-codex/gpt-6-sol ollama/glm-5.2:cloud # same operation, direct form
225
+ /af-agent-models-substitute openai-codex/gpt-6.1-sol ollama/glm-5.2:cloud # same operation, direct form
226
226
  ```
227
227
 
228
228
  Per-project defaults live in `.ai/agent-fleet-overrides.md` — see [docs/agent-fleet-setup.md](docs/agent-fleet-setup.md).
@@ -1,13 +1,13 @@
1
1
  ---
2
2
  name: architect
3
3
  description: System architect — owns design decisions and migration strategy; answers design questions with concrete, justified recommendations.
4
- model: openai-codex/gpt-6-sol
4
+ model: openai-codex/gpt-6.1-sol
5
5
  models:
6
6
  - github-copilot/claude-opus-5
7
7
  - openai-codex/gpt-6-luna
8
8
  - ollama/nemotron-3-ultra:cloud
9
9
  - ollama/glm-5.2:cloud
10
- - omlx/Qwen3.6-35B-A3B-4bit
10
+ - incoai/Qwen3.8-27B-Splash
11
11
  thinking: high
12
12
  ---
13
13
 
package/agents/bowser.md CHANGED
@@ -8,7 +8,7 @@ models:
8
8
  - openai-codex/gpt-6-luna
9
9
  - ollama/minimax-m3:cloud
10
10
  - ollama/nemotron-3-ultra:cloud
11
- - omlx/Qwen3.6-35B-A3B-4bit
11
+ - incoai/Qwen3.8-27B-Splash
12
12
  color: orange
13
13
  skills:
14
14
  - bowser
package/agents/builder.md CHANGED
@@ -2,24 +2,24 @@
2
2
  name: builder
3
3
  description: Implementation and code generation — lands changes in small verifiable increments. Use for implementing features, fixes, and refactors once the task is defined.
4
4
  tools: read,write,edit,bash,grep,find,ls
5
- model: openai-codex/gpt-6-sol
5
+ model: openai-codex/gpt-6.1-sol
6
6
  models:
7
7
  - github-copilot/claude-opus-5
8
8
  - openai-codex/gpt-6-luna
9
- - openai-codex/gpt-5.3-codex-spark
9
+ - openai-codex/gpt-6-luna
10
10
  - ollama/minimax-m3:cloud
11
11
  - ollama/kimi-k2.7-code:cloud
12
12
  - ollama/glm-5.2:cloud
13
13
  - ollama/nemotron-3-ultra:cloud
14
- - omlx/Qwen3.6-35B-A3B-4bit
14
+ - incoai/Qwen3.8-27B-Splash
15
15
  thinking: medium
16
16
  delegate_depth: 1
17
17
  subagents:
18
18
  recon:
19
- model: openai-codex/gpt-5.3-codex-spark
19
+ model: openai-codex/gpt-6-luna
20
20
  tools: read,grep,find,ls
21
21
  verifier:
22
- model: openai-codex/gpt-5.3-codex-spark
22
+ model: openai-codex/gpt-6-luna
23
23
  tools: read,bash,grep,find,ls
24
24
  ---
25
25
  You are a builder agent. Implement the requested changes thoroughly. Write clean, minimal code. Follow existing patterns in the codebase. Test your work when possible.
@@ -7,12 +7,12 @@ model: xai/grok-4.7
7
7
  models:
8
8
  - openai-codex/gpt-6-luna
9
9
  - github-copilot/claude-opus-5
10
- - openai-codex/gpt-6-sol
10
+ - openai-codex/gpt-6.1-sol
11
11
  - ollama/nemotron-3-ultra:cloud
12
12
  - ollama/kimi-k2.7-code:cloud
13
13
  - ollama/glm-5.2:cloud
14
14
  - ollama/minimax-m3:cloud
15
- - omlx/Qwen3.6-35B-A3B-4bit
15
+ - incoai/Qwen3.8-27B-Splash
16
16
  thinking: medium
17
17
  delegate_depth: 1
18
18
  subagents:
@@ -6,10 +6,10 @@ kind: research
6
6
  model: xai/grok-4.7
7
7
  models:
8
8
  - openai-codex/gpt-6-luna
9
- - openai-codex/gpt-6-sol
9
+ - openai-codex/gpt-6.1-sol
10
10
  - ollama/nemotron-3-ultra:cloud
11
11
  - ollama/glm-5.2:cloud
12
- - omlx/Qwen3.6-35B-A3B-4bit
12
+ - incoai/Qwen3.8-27B-Splash
13
13
  thinking: medium
14
14
  ---
15
15
 
@@ -5,13 +5,13 @@ tools: read,write,edit,grep,find,ls
5
5
  writes:
6
6
  - docs/
7
7
  - "**/*.md"
8
- model: openai-codex/gpt-6-sol
8
+ model: openai-codex/gpt-6.1-sol
9
9
  models:
10
10
  - openai-codex/gpt-6-luna
11
- - openai-codex/gpt-5.3-codex-spark
11
+ - openai-codex/gpt-6-luna
12
12
  - ollama/glm-5.2:cloud
13
13
  - ollama/nemotron-3-ultra:cloud
14
- - omlx/Qwen3.6-35B-A3B-4bit
14
+ - incoai/Qwen3.8-27B-Splash
15
15
  thinking: minimal
16
16
  ---
17
17
  You are a documentation agent. Write clear, concise documentation. Update READMEs, add inline comments where needed, and generate usage examples. Match the project's existing doc style.
@@ -2,12 +2,12 @@
2
2
  name: orchestrator
3
3
  description: Verification-Contract orchestrator — coordinates small, evidence-gated batches and does not report completion until each stated assertion has named proof.
4
4
  kind: orchestrator
5
- model: openai-codex/gpt-6-sol
5
+ model: openai-codex/gpt-6.1-sol
6
6
  models:
7
7
  - openai-codex/gpt-6-luna
8
8
  - ollama/minimax-m3:cloud
9
9
  - ollama/nemotron-3-ultra:cloud
10
- - omlx/Qwen3.6-35B-A3B-4bit
10
+ - incoai/Qwen3.8-27B-Splash
11
11
  thinking: medium
12
12
  ---
13
13
 
@@ -6,10 +6,10 @@ model: xai/grok-4.7
6
6
  models:
7
7
  - openai-codex/gpt-6-luna
8
8
  - github-copilot/claude-opus-5
9
- - openai-codex/gpt-6-sol
9
+ - openai-codex/gpt-6.1-sol
10
10
  - ollama/nemotron-3-ultra:cloud
11
11
  - ollama/glm-5.2:cloud
12
- - omlx/Qwen3.6-35B-A3B-4bit
12
+ - incoai/Qwen3.8-27B-Splash
13
13
  thinking: medium
14
14
  delegate_depth: 1
15
15
  subagents:
package/agents/planner.md CHANGED
@@ -7,22 +7,22 @@ writes:
7
7
  model: openai-codex/gpt-6-astra
8
8
  models:
9
9
  - github-copilot/claude-fable-5
10
- - openai-codex/gpt-6-sol
10
+ - openai-codex/gpt-6.1-sol
11
11
  - openai-codex/gpt-6-luna
12
12
  - ollama/nemotron-3-ultra:cloud
13
13
  - ollama/glm-5.2:cloud
14
- - omlx/Qwen3.6-35B-A3B-4bit
14
+ - incoai/Qwen3.8-27B-Splash
15
15
  thinking: high
16
16
  delegate_depth: 1
17
17
  subagents:
18
18
  scout:
19
- model: openai-codex/gpt-5.3-codex-spark
19
+ model: openai-codex/gpt-6-luna
20
20
  tools: read,grep,find,ls
21
21
  rules:
22
22
  model: openai-codex/gpt-6-luna
23
23
  tools: read,grep,find,ls
24
24
  voice-1:
25
- model: openai-codex/gpt-6-sol
25
+ model: openai-codex/gpt-6.1-sol
26
26
  thinking: medium
27
27
  tools: read,grep,find,ls
28
28
  voice-2:
@@ -2,12 +2,12 @@
2
2
  name: releaser
3
3
  description: Release owner — cuts versions and ships; runs the changeset → version-bump → tag flow on request.
4
4
  color: #059669
5
- model: openai-codex/gpt-6-sol
5
+ model: openai-codex/gpt-6.1-sol
6
6
  models:
7
7
  - openai-codex/gpt-6-luna
8
8
  - ollama/glm-5.2:cloud
9
9
  - ollama/nemotron-3-ultra:cloud
10
- - omlx/Qwen3.6-35B-A3B-4bit
10
+ - incoai/Qwen3.8-27B-Splash
11
11
  thinking: low
12
12
  ---
13
13
 
@@ -7,10 +7,10 @@ model: openai-codex/gpt-6-luna
7
7
  models:
8
8
  - openai-codex/gpt-6-luna
9
9
  - xai/grok-4.7
10
- - openai-codex/gpt-6-sol
10
+ - openai-codex/gpt-6.1-sol
11
11
  - ollama/nemotron-3-ultra:cloud
12
12
  - ollama/minimax-m3:cloud
13
- - omlx/Qwen3.6-35B-A3B-4bit
13
+ - incoai/Qwen3.8-27B-Splash
14
14
  thinking: low
15
15
  ---
16
16
 
@@ -2,13 +2,13 @@
2
2
  name: security-auditor
3
3
  description: Security engineer focused on vulnerability detection, threat modeling, and secure coding practices. Use for security-focused code review, threat analysis, or hardening recommendations.
4
4
  tools: read,bash,grep,find,ls
5
- model: openai-codex/gpt-6-sol
5
+ model: openai-codex/gpt-6.1-sol
6
6
  models:
7
7
  - xai/grok-4.7
8
8
  - openai-codex/gpt-6-luna
9
9
  - ollama/nemotron-3-ultra:cloud
10
10
  - ollama/glm-5.2:cloud
11
- - omlx/Qwen3.6-35B-A3B-4bit
11
+ - incoai/Qwen3.8-27B-Splash
12
12
  thinking: high
13
13
  delegate_depth: 1
14
14
  subagents:
@@ -6,19 +6,19 @@ model: xai/grok-4.7
6
6
  models:
7
7
  - github-copilot/claude-opus-5
8
8
  - openai-codex/gpt-6-luna
9
- - openai-codex/gpt-6-sol
9
+ - openai-codex/gpt-6.1-sol
10
10
  - ollama/kimi-k2.7-code:cloud
11
11
  - ollama/glm-5.2:cloud
12
12
  - ollama/nemotron-3-ultra:cloud
13
- - omlx/Qwen3.6-35B-A3B-4bit
13
+ - incoai/Qwen3.8-27B-Splash
14
14
  thinking: low
15
15
  delegate_depth: 1
16
16
  subagents:
17
17
  coverage-scout:
18
- model: openai-codex/gpt-5.3-codex-spark
18
+ model: openai-codex/gpt-6-luna
19
19
  tools: read,grep,find,ls
20
20
  conventions:
21
- model: openai-codex/gpt-5.3-codex-spark
21
+ model: openai-codex/gpt-6-luna
22
22
  tools: read,grep,find,ls
23
23
  ---
24
24
 
@@ -4,10 +4,10 @@ description: Interactive headful Chrome debugging via Chrome DevTools MCP — li
4
4
  model: openai-codex/gpt-6-luna
5
5
  models:
6
6
  - github-copilot/claude-opus-5
7
- - openai-codex/gpt-6-sol
7
+ - openai-codex/gpt-6.1-sol
8
8
  - openai-codex/gpt-6-luna
9
9
  - ollama/glm-5.2:cloud
10
- - omlx/Qwen3.6-35B-A3B-4bit
10
+ - incoai/Qwen3.8-27B-Splash
11
11
  color: cyan
12
12
  skills:
13
13
  - browser-testing-with-devtools
@@ -5,11 +5,11 @@ tools: read,bash,grep,find,ls
5
5
  model: openai-codex/gpt-6-luna
6
6
  models:
7
7
  - github-copilot/claude-opus-5
8
- - openai-codex/gpt-6-sol
8
+ - openai-codex/gpt-6.1-sol
9
9
  - openai-codex/gpt-6-luna
10
10
  - ollama/nemotron-3-ultra:cloud
11
11
  - ollama/glm-5.2:cloud
12
- - omlx/Qwen3.6-35B-A3B-4bit
12
+ - incoai/Qwen3.8-27B-Splash
13
13
  thinking: high
14
14
  ---
15
15
 
package/bin/cli.js CHANGED
@@ -246,8 +246,8 @@ async function cmdConfigure() {
246
246
  for (const key of ["rules", "docs"]) {
247
247
  if (opts[key] === undefined) continue;
248
248
  const paths = opts[key].split(",").map((path) => path.trim());
249
- if (paths.some((path) => !path || path.startsWith("/") || /[\r\n:#]/.test(path) || path.includes("\\") || path.split("/").some((part) => part === ".." || part === "." || !part)))
250
- fail(`--${key} requires comma-separated workspace-relative paths`);
249
+ if (paths.some((path) => !path || path.startsWith("/") || /[\r\n:#]/.test(path) || path.includes("\\") || path.split("/").some((part,index,parts) => part === "." || !part || (part === ".." && parts.slice(0,index).some(prior => prior !== "..")))))
250
+ fail(`--${key} requires comma-separated checkout-relative paths without internal traversal`);
251
251
  requested[key] = [...new Set(paths)];
252
252
  for (const path of requested[key]) if (!existsSync(join(workspace, path))) console.error(`Warning: configured ${key} path does not exist: ${path}`);
253
253
  }
@@ -0,0 +1,33 @@
1
+ // Reviewed project-content writes are separate from read grants and installer ownership.
2
+ import { existsSync, lstatSync, realpathSync } from "node:fs";
3
+ import { isAbsolute, relative, resolve, sep } from "node:path";
4
+ import { assertSafeWorkspaceTarget, assertWorkspaceRootSafe } from "./workspace-safety.js";
5
+
6
+ export function validateContentDestination(workspace, destination) {
7
+ if (!destination || typeof destination.root !== "string" || !destination.root ||
8
+ typeof destination.acceptedDecision !== "string" || !destination.acceptedDecision.trim() ||
9
+ !Array.isArray(destination.evidence) || !destination.evidence.length ||
10
+ !destination.evidence.every(value => typeof value === "string" && value.trim()) ||
11
+ Object.keys(destination).some(key => !["root", "acceptedDecision", "evidence"].includes(key)))
12
+ throw new Error("external content destination requires reviewed root, acceptedDecision and evidence");
13
+ const root = resolve(workspace, destination.root);
14
+ if (!existsSync(root) || !lstatSync(root).isDirectory()) throw new Error("external content destination must be an existing real directory");
15
+ assertWorkspaceRootSafe(root);
16
+ const checkout = realpathSync(workspace);
17
+ for (const [base, target] of [[root, checkout], [checkout, root]]) {
18
+ const rel = relative(base, target);
19
+ if (rel === "" || (!isAbsolute(rel) && rel !== ".." && !rel.startsWith(`..${sep}`)))
20
+ throw new Error("external content destination must be separate from the checkout");
21
+ }
22
+ return { root, acceptedDecision: destination.acceptedDecision, evidence: [...destination.evidence] };
23
+ }
24
+ export function externalContentTarget(workspace, destination, path) {
25
+ const reviewed = validateContentDestination(workspace, destination);
26
+ if (typeof path !== "string" || !/^\.ai\/(?:rules|commands|agent-prompts)\/.+/.test(path) ||
27
+ path.includes("\\") || path.split("/").some(part => !part || part === "." || part === "..") ||
28
+ path.split("/").slice(2).some(part => /^(?:\..*|secrets?(?:\..*)?|credentials?(?:\..*)?|node_modules|vendor|dist|build|coverage|.*\.(?:pem|key|p12|pfx))$/i.test(part)))
29
+ throw new Error(`invalid external project AI path: ${path}`);
30
+ const target = assertSafeWorkspaceTarget(reviewed.root, path, { allowLeafSymlink: false });
31
+ if (existsSync(target) && !lstatSync(target).isFile()) throw new Error("external project content target is not a regular file");
32
+ return target;
33
+ }
@@ -3,6 +3,7 @@ import { existsSync, lstatSync, mkdirSync, readFileSync, writeFileSync } from "n
3
3
  import { dirname, join } from "node:path";
4
4
  import { hashFile, hashText } from "./state.js";
5
5
  import { runTransaction } from "./transaction.js";
6
+ import { externalContentTarget, validateContentDestination } from "./external-content.js";
6
7
  import { assertSafeWorkspaceTarget } from "./workspace-safety.js";
7
8
 
8
9
  export const AI_STATE_REL_PATH = ".ai/agent-fleet-ai-state.json";
@@ -14,7 +15,8 @@ const ROOTS = ["rules", "commands", "agent-prompts"];
14
15
  const HEX = /^[a-f0-9]{64}$/;
15
16
  const own = (value) => Object.hasOwn(value, "origin") && ["template", "repo-derived"].includes(value.origin);
16
17
 
17
- export function projectPath(workspace, path) {
18
+ export function projectPath(workspace, path, contentDestination) {
19
+ if (contentDestination) return externalContentTarget(workspace,contentDestination,path);
18
20
  if (typeof path !== "string" || path.includes("\\") || path.startsWith("/") || path.split("/").includes("..") ||
19
21
  !ROOTS.some((root) => path.startsWith(`.ai/${root}/`) && path.length > root.length + 5)) throw new Error(`invalid project AI path: ${path}`);
20
22
  return assertSafeWorkspaceTarget(workspace, path, { allowLeafSymlink: false });
@@ -30,7 +32,7 @@ export function requirePackageCatalogue(packageRoot) {
30
32
  }
31
33
 
32
34
  function validEntry(workspace, path, entry) {
33
- projectPath(workspace, path);
35
+ projectPath(workspace, path, entry?.contentDestination);
34
36
  if (!entry || !own(entry) || !HEX.test(entry.appliedHash) || !Array.isArray(entry.evidence) ||
35
37
  !entry.evidence.every((x) => typeof x === "string" && x.length > 0) ||
36
38
  typeof entry.acceptedDecision !== "string" || !entry.acceptedDecision.trim() ||
@@ -54,16 +56,19 @@ export function readProjectProvenance(workspace) {
54
56
 
55
57
  const same = (a, b) => JSON.stringify(a) === JSON.stringify(b);
56
58
  /** source: template identity/version/hash, or {origin:'repo-derived'}; inputs are relevant generation inputs. */
57
- export function classifyProjectFile({ workspace, path, source, evidence, acceptedDecision, inputs = {}, knownTemplate = true, snapshotAvailable = false }) {
58
- const target = projectPath(workspace, path);
59
+ export function classifyProjectFile({ workspace, path, source, evidence, acceptedDecision, inputs = {}, knownTemplate = true, snapshotAvailable = false, contentDestination }) {
59
60
  const record = readProjectProvenance(workspace);
61
+ const previousDestination=record.state?.entries[path]?.contentDestination;
62
+ if (previousDestination && !contentDestination) throw new Error("external content destination must be explicitly supplied");
63
+ const destination=contentDestination ? validateContentDestination(workspace,contentDestination) : undefined;
64
+ const target = projectPath(workspace, path, destination);
60
65
  if (record.status !== "valid") return { status: "unknown", reason: record.status };
61
66
  const previous = record.state.entries[path];
62
67
  if (!previous) return { status: "unknown", reason: "unrecorded" };
63
68
  if (!existsSync(target) || !lstatSync(target).isFile()) return { status: "deleted" };
64
69
  if (previous.origin === "template" && !knownTemplate) return { status: "unknown", reason: "unknown-template" };
65
70
  const local = hashFile(target) !== previous.appliedHash;
66
- const changed = !source || previous.origin !== source.origin ||
71
+ const changed = !same(previous.contentDestination,destination) || !source || previous.origin !== source.origin ||
67
72
  (source.origin === "template" && ["templateId", "sourceVersion", "sourceHash"].some((key) => source[key] !== previous[key])) ||
68
73
  !same(previous.evidence, evidence) || previous.acceptedDecision !== acceptedDecision || !same(previous.inputs ?? {}, inputs);
69
74
  return { status: local ? (changed ? "conflict" : "local-edit") : (changed ? "source-update" : "unchanged"),
@@ -71,7 +76,8 @@ export function classifyProjectFile({ workspace, path, source, evidence, accepte
71
76
  }
72
77
 
73
78
  /** Only an already reviewed, accepted change may be written. Generator is not invoked for an unchanged rerun. */
74
- export function applyAcceptedProjectFiles({ workspace, changes, generateContent, failAt = null }) {
79
+ export function applyAcceptedProjectFiles({ workspace, changes, generateContent, failAt = null, contentDestination }) {
80
+ const destination=contentDestination ? validateContentDestination(workspace,contentDestination) : undefined;
75
81
  if (!Array.isArray(changes) || !changes.length) return { changed: false };
76
82
  const record = readProjectProvenance(workspace);
77
83
  if (record.status === "corrupt") throw new Error("provenance is corrupt; repair before apply");
@@ -82,14 +88,14 @@ export function applyAcceptedProjectFiles({ workspace, changes, generateContent,
82
88
  const sidecarHash = hashFile(sidecar);
83
89
  for (const change of changes) {
84
90
  const { path, source, evidence, acceptedDecision, inputs = {}, accepted = false, requestChange = false } = change;
85
- projectPath(workspace, path);
91
+ projectPath(workspace, path, destination);
86
92
  if (seen.has(path)) throw new Error(`duplicate project AI path: ${path}`);
87
93
  seen.add(path);
88
- const entry = { origin: source?.origin, ...(source?.origin === "template" ? {
94
+ const entry = { ...(destination ? {contentDestination:destination} : {}), origin: source?.origin, ...(source?.origin === "template" ? {
89
95
  templateId: source.templateId, sourceVersion: source.sourceVersion, sourceHash: source.sourceHash,
90
96
  } : {}), evidence, acceptedDecision, inputs, appliedHash: "0".repeat(64) };
91
97
  if (!validEntry(workspace, path, entry)) throw new Error(`invalid provenance entry: ${path}`);
92
- const classification = classifyProjectFile({ workspace, path, source, evidence, acceptedDecision, inputs, knownTemplate: change.knownTemplate });
98
+ const classification = classifyProjectFile({ workspace, path, source, evidence, acceptedDecision, inputs, knownTemplate: change.knownTemplate, contentDestination:destination });
93
99
  if (classification.status === "unchanged" && !requestChange) continue;
94
100
  if (!accepted) throw new Error(`${path}: ${classification.status}; explicit acceptance required`);
95
101
  if (!["unchanged", "source-update"].includes(classification.status) && !change.adopt && !change.reconciled)
@@ -98,17 +104,17 @@ export function applyAcceptedProjectFiles({ workspace, changes, generateContent,
98
104
  const bytes = change.content === undefined ? generateContent?.(change) : change.content;
99
105
  if (typeof bytes !== "string" && !Buffer.isBuffer(bytes)) throw new Error(`missing accepted content: ${path}`);
100
106
  entry.appliedHash = hashText(bytes);
101
- prepared.push({ path, bytes, entry, priorHash: hashFile(projectPath(workspace, path)) });
107
+ prepared.push({ path, bytes, entry, priorHash: hashFile(projectPath(workspace, path, destination)) });
102
108
  }
103
109
  if (!prepared.length) return { changed: false };
104
- const plan = { workspace, verb: "configure", actions: [{ files: prepared.map(({ path }) => ({ path })).concat({ path: AI_STATE_REL_PATH }) }] };
110
+ const plan = { workspace, verb: "configure", ...(destination ? {externalContent:prepared.map(({path})=>({path,destination}))} : {}), actions: [{ files: (destination ? [] : prepared.map(({ path }) => ({ path }))).concat({ path: AI_STATE_REL_PATH }) }] };
105
111
  return runTransaction({ workspace, plan, manifest: { items: [] }, failAt, validate: () => {
106
- if (hashFile(sidecar) !== sidecarHash || prepared.some(({ path, priorHash }) => hashFile(projectPath(workspace, path)) !== priorHash))
112
+ if (hashFile(sidecar) !== sidecarHash || prepared.some(({ path, priorHash }) => hashFile(projectPath(workspace, path, destination)) !== priorHash))
107
113
  throw new Error("project AI files changed since review; re-run setup");
108
114
  }, commit: () => {
109
115
  const entries = { ...state.entries };
110
116
  for (const { path, bytes, entry } of prepared) {
111
- const target = projectPath(workspace, path);
117
+ const target = projectPath(workspace, path, destination);
112
118
  mkdirSync(dirname(target), { recursive: true }); writeFileSync(target, bytes);
113
119
  if (hashFile(target) !== entry.appliedHash) throw new Error(`readback mismatch: ${path}`);
114
120
  entries[path] = entry;