@a5c-ai/babysitter-sdk 5.0.0 → 5.0.1-staging.04a3db697

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 (943) hide show
  1. package/dist/breakpoints/evaluator.d.ts +33 -0
  2. package/dist/breakpoints/evaluator.d.ts.map +1 -0
  3. package/dist/breakpoints/evaluator.js +156 -0
  4. package/dist/breakpoints/index.d.ts +9 -0
  5. package/dist/breakpoints/index.d.ts.map +1 -0
  6. package/dist/breakpoints/index.js +19 -0
  7. package/dist/breakpoints/patterns.d.ts +24 -0
  8. package/dist/breakpoints/patterns.d.ts.map +1 -0
  9. package/dist/breakpoints/patterns.js +88 -0
  10. package/dist/breakpoints/proven-verification.d.ts +51 -0
  11. package/dist/breakpoints/proven-verification.d.ts.map +1 -0
  12. package/dist/breakpoints/proven-verification.js +120 -0
  13. package/dist/breakpoints/rules.d.ts +26 -0
  14. package/dist/breakpoints/rules.d.ts.map +1 -0
  15. package/dist/breakpoints/rules.js +110 -0
  16. package/dist/breakpoints/types.d.ts +78 -0
  17. package/dist/breakpoints/types.d.ts.map +1 -0
  18. package/dist/breakpoints/types.js +7 -0
  19. package/dist/cli/commands/breakpointRules.d.ts +26 -0
  20. package/dist/cli/commands/breakpointRules.d.ts.map +1 -0
  21. package/dist/cli/commands/breakpointRules.js +222 -0
  22. package/dist/cli/commands/compressOutput.d.ts +24 -0
  23. package/dist/cli/commands/compressOutput.d.ts.map +1 -0
  24. package/dist/cli/commands/compressOutput.js +85 -0
  25. package/dist/cli/commands/compressOutputHelpers.d.ts +15 -0
  26. package/dist/cli/commands/compressOutputHelpers.d.ts.map +1 -0
  27. package/dist/cli/commands/compressOutputHelpers.js +367 -0
  28. package/dist/cli/commands/compression/reset.d.ts +15 -0
  29. package/dist/cli/commands/compression/reset.d.ts.map +1 -0
  30. package/dist/cli/commands/compression/reset.js +87 -0
  31. package/dist/cli/commands/compression/set.d.ts +26 -0
  32. package/dist/cli/commands/compression/set.d.ts.map +1 -0
  33. package/dist/cli/commands/compression/set.js +179 -0
  34. package/dist/cli/commands/compression/status.d.ts +12 -0
  35. package/dist/cli/commands/compression/status.d.ts.map +1 -0
  36. package/dist/cli/commands/compression/status.js +133 -0
  37. package/dist/cli/commands/compression/toggle.d.ts +17 -0
  38. package/dist/cli/commands/compression/toggle.d.ts.map +1 -0
  39. package/dist/cli/commands/compression/toggle.js +115 -0
  40. package/dist/cli/commands/configure/output.d.ts +6 -0
  41. package/dist/cli/commands/configure/output.d.ts.map +1 -0
  42. package/dist/cli/commands/configure/output.js +164 -0
  43. package/dist/cli/commands/configure.d.ts +124 -0
  44. package/dist/cli/commands/configure.d.ts.map +1 -0
  45. package/dist/cli/commands/configure.js +300 -0
  46. package/dist/cli/commands/costStats.d.ts +13 -0
  47. package/dist/cli/commands/costStats.d.ts.map +1 -0
  48. package/dist/cli/commands/costStats.js +327 -0
  49. package/dist/cli/commands/detectExistingRun.d.ts +14 -0
  50. package/dist/cli/commands/detectExistingRun.d.ts.map +1 -0
  51. package/dist/cli/commands/detectExistingRun.js +89 -0
  52. package/dist/cli/commands/harness/install.d.ts +17 -0
  53. package/dist/cli/commands/harness/install.d.ts.map +1 -0
  54. package/dist/cli/commands/harness/install.js +83 -0
  55. package/dist/cli/commands/health/checks.d.ts +10 -0
  56. package/dist/cli/commands/health/checks.d.ts.map +1 -0
  57. package/dist/cli/commands/health/checks.js +268 -0
  58. package/dist/cli/commands/health/environment.d.ts +3 -0
  59. package/dist/cli/commands/health/environment.d.ts.map +1 -0
  60. package/dist/cli/commands/health/environment.js +89 -0
  61. package/dist/cli/commands/health/output.d.ts +5 -0
  62. package/dist/cli/commands/health/output.d.ts.map +1 -0
  63. package/dist/cli/commands/health/output.js +92 -0
  64. package/dist/cli/commands/health.d.ts +74 -0
  65. package/dist/cli/commands/health.d.ts.map +1 -0
  66. package/dist/cli/commands/health.js +92 -0
  67. package/dist/cli/commands/hooks/log.d.ts +15 -0
  68. package/dist/cli/commands/hooks/log.d.ts.map +1 -0
  69. package/dist/cli/commands/hooks/log.js +298 -0
  70. package/dist/cli/commands/hooks/run.d.ts +25 -0
  71. package/dist/cli/commands/hooks/run.d.ts.map +1 -0
  72. package/dist/cli/commands/hooks/run.js +234 -0
  73. package/dist/cli/commands/instructions.d.ts +20 -0
  74. package/dist/cli/commands/instructions.d.ts.map +1 -0
  75. package/dist/cli/commands/instructions.js +292 -0
  76. package/dist/cli/commands/log.d.ts +22 -0
  77. package/dist/cli/commands/log.d.ts.map +1 -0
  78. package/dist/cli/commands/log.js +99 -0
  79. package/dist/cli/commands/mcpServe.d.ts +11 -0
  80. package/dist/cli/commands/mcpServe.d.ts.map +1 -0
  81. package/dist/cli/commands/mcpServe.js +35 -0
  82. package/dist/cli/commands/plugin/marketplaceCommands.d.ts +5 -0
  83. package/dist/cli/commands/plugin/marketplaceCommands.d.ts.map +1 -0
  84. package/dist/cli/commands/plugin/marketplaceCommands.js +114 -0
  85. package/dist/cli/commands/plugin/packageCommands.d.ts +6 -0
  86. package/dist/cli/commands/plugin/packageCommands.d.ts.map +1 -0
  87. package/dist/cli/commands/plugin/packageCommands.js +270 -0
  88. package/dist/cli/commands/plugin/registryCommands.d.ts +5 -0
  89. package/dist/cli/commands/plugin/registryCommands.d.ts.map +1 -0
  90. package/dist/cli/commands/plugin/registryCommands.js +128 -0
  91. package/dist/cli/commands/plugin/shared.d.ts +20 -0
  92. package/dist/cli/commands/plugin/shared.d.ts.map +1 -0
  93. package/dist/cli/commands/plugin/shared.js +44 -0
  94. package/dist/cli/commands/plugin.d.ts +9 -0
  95. package/dist/cli/commands/plugin.d.ts.map +1 -0
  96. package/dist/cli/commands/plugin.js +22 -0
  97. package/dist/cli/commands/processLibrary.d.ts +16 -0
  98. package/dist/cli/commands/processLibrary.d.ts.map +1 -0
  99. package/dist/cli/commands/processLibrary.js +156 -0
  100. package/dist/cli/commands/profile.d.ts +26 -0
  101. package/dist/cli/commands/profile.d.ts.map +1 -0
  102. package/dist/cli/commands/profile.js +213 -0
  103. package/dist/cli/commands/runIterate.d.ts +49 -0
  104. package/dist/cli/commands/runIterate.d.ts.map +1 -0
  105. package/dist/cli/commands/runIterate.js +156 -0
  106. package/dist/cli/commands/runIterateHelpers.d.ts +29 -0
  107. package/dist/cli/commands/runIterateHelpers.d.ts.map +1 -0
  108. package/dist/cli/commands/runIterateHelpers.js +134 -0
  109. package/dist/cli/commands/session/associate.d.ts +10 -0
  110. package/dist/cli/commands/session/associate.d.ts.map +1 -0
  111. package/dist/cli/commands/session/associate.js +77 -0
  112. package/dist/cli/commands/session/checkIteration.d.ts +7 -0
  113. package/dist/cli/commands/session/checkIteration.d.ts.map +1 -0
  114. package/dist/cli/commands/session/checkIteration.js +76 -0
  115. package/dist/cli/commands/session/cleanup.d.ts +5 -0
  116. package/dist/cli/commands/session/cleanup.d.ts.map +1 -0
  117. package/dist/cli/commands/session/cleanup.js +20 -0
  118. package/dist/cli/commands/session/common.d.ts +16 -0
  119. package/dist/cli/commands/session/common.d.ts.map +1 -0
  120. package/dist/cli/commands/session/common.js +33 -0
  121. package/dist/cli/commands/session/init.d.ts +10 -0
  122. package/dist/cli/commands/session/init.d.ts.map +1 -0
  123. package/dist/cli/commands/session/init.js +76 -0
  124. package/dist/cli/commands/session/iterationMessage.d.ts +17 -0
  125. package/dist/cli/commands/session/iterationMessage.d.ts.map +1 -0
  126. package/dist/cli/commands/session/iterationMessage.js +106 -0
  127. package/dist/cli/commands/session/lastMessage.d.ts +13 -0
  128. package/dist/cli/commands/session/lastMessage.d.ts.map +1 -0
  129. package/dist/cli/commands/session/lastMessage.js +45 -0
  130. package/dist/cli/commands/session/resume.d.ts +10 -0
  131. package/dist/cli/commands/session/resume.d.ts.map +1 -0
  132. package/dist/cli/commands/session/resume.js +129 -0
  133. package/dist/cli/commands/session/state.d.ts +7 -0
  134. package/dist/cli/commands/session/state.d.ts.map +1 -0
  135. package/dist/cli/commands/session/state.js +49 -0
  136. package/dist/cli/commands/session/update.d.ts +10 -0
  137. package/dist/cli/commands/session/update.d.ts.map +1 -0
  138. package/dist/cli/commands/session/update.js +54 -0
  139. package/dist/cli/commands/session/whoami.d.ts +5 -0
  140. package/dist/cli/commands/session/whoami.d.ts.map +1 -0
  141. package/dist/cli/commands/session/whoami.js +22 -0
  142. package/dist/cli/commands/skill/discoveryLocal.d.ts +32 -0
  143. package/dist/cli/commands/skill/discoveryLocal.d.ts.map +1 -0
  144. package/dist/cli/commands/skill/discoveryLocal.js +383 -0
  145. package/dist/cli/commands/skill/processMarkers.d.ts +9 -0
  146. package/dist/cli/commands/skill/processMarkers.d.ts.map +1 -0
  147. package/dist/cli/commands/skill/processMarkers.js +104 -0
  148. package/dist/cli/commands/skill/remoteDiscovery.d.ts +4 -0
  149. package/dist/cli/commands/skill/remoteDiscovery.d.ts.map +1 -0
  150. package/dist/cli/commands/skill/remoteDiscovery.js +164 -0
  151. package/dist/cli/commands/skill/types.d.ts +69 -0
  152. package/dist/cli/commands/skill/types.d.ts.map +1 -0
  153. package/dist/cli/commands/skill/types.js +2 -0
  154. package/dist/cli/commands/skill.d.ts +20 -0
  155. package/dist/cli/commands/skill.d.ts.map +1 -0
  156. package/dist/cli/commands/skill.js +292 -0
  157. package/dist/cli/commands/tokensStats.d.ts +70 -0
  158. package/dist/cli/commands/tokensStats.d.ts.map +1 -0
  159. package/dist/cli/commands/tokensStats.js +238 -0
  160. package/dist/cli/commands/tokensStatsFormatting.d.ts +9 -0
  161. package/dist/cli/commands/tokensStatsFormatting.d.ts.map +1 -0
  162. package/dist/cli/commands/tokensStatsFormatting.js +137 -0
  163. package/dist/cli/completionProof.d.ts +4 -0
  164. package/dist/cli/completionProof.d.ts.map +1 -0
  165. package/dist/cli/completionProof.js +45 -0
  166. package/dist/cli/main/argFlagParsers.d.ts +9 -0
  167. package/dist/cli/main/argFlagParsers.d.ts.map +1 -0
  168. package/dist/cli/main/argFlagParsers.js +346 -0
  169. package/dist/cli/main/argFlags.d.ts +4 -0
  170. package/dist/cli/main/argFlags.d.ts.map +1 -0
  171. package/dist/cli/main/argFlags.js +77 -0
  172. package/dist/cli/main/argPositionals.d.ts +3 -0
  173. package/dist/cli/main/argPositionals.d.ts.map +1 -0
  174. package/dist/cli/main/argPositionals.js +87 -0
  175. package/dist/cli/main/args.d.ts +7 -0
  176. package/dist/cli/main/args.d.ts.map +1 -0
  177. package/dist/cli/main/args.js +120 -0
  178. package/dist/cli/main/dispatch.d.ts +5 -0
  179. package/dist/cli/main/dispatch.d.ts.map +1 -0
  180. package/dist/cli/main/dispatch.js +44 -0
  181. package/dist/cli/main/dispatchHarness.d.ts +3 -0
  182. package/dist/cli/main/dispatchHarness.d.ts.map +1 -0
  183. package/dist/cli/main/dispatchHarness.js +73 -0
  184. package/dist/cli/main/dispatchRunSession.d.ts +3 -0
  185. package/dist/cli/main/dispatchRunSession.d.ts.map +1 -0
  186. package/dist/cli/main/dispatchRunSession.js +316 -0
  187. package/dist/cli/main/program.d.ts +17 -0
  188. package/dist/cli/main/program.d.ts.map +1 -0
  189. package/dist/cli/main/program.js +94 -0
  190. package/dist/cli/main/runAssignProcess.d.ts +3 -0
  191. package/dist/cli/main/runAssignProcess.d.ts.map +1 -0
  192. package/dist/cli/main/runAssignProcess.js +169 -0
  193. package/dist/cli/main/runCommands.d.ts +4 -0
  194. package/dist/cli/main/runCommands.d.ts.map +1 -0
  195. package/dist/cli/main/runCommands.js +13 -0
  196. package/dist/cli/main/runCreate.d.ts +5 -0
  197. package/dist/cli/main/runCreate.d.ts.map +1 -0
  198. package/dist/cli/main/runCreate.js +382 -0
  199. package/dist/cli/main/runInspection.d.ts +5 -0
  200. package/dist/cli/main/runInspection.d.ts.map +1 -0
  201. package/dist/cli/main/runInspection.js +139 -0
  202. package/dist/cli/main/runState.d.ts +55 -0
  203. package/dist/cli/main/runState.d.ts.map +1 -0
  204. package/dist/cli/main/runState.js +226 -0
  205. package/dist/cli/main/runSupport.d.ts +49 -0
  206. package/dist/cli/main/runSupport.d.ts.map +1 -0
  207. package/dist/cli/main/runSupport.js +364 -0
  208. package/dist/cli/main/taskCommands.d.ts +6 -0
  209. package/dist/cli/main/taskCommands.d.ts.map +1 -0
  210. package/dist/cli/main/taskCommands.js +356 -0
  211. package/dist/cli/main/types.d.ts +120 -0
  212. package/dist/cli/main/types.d.ts.map +1 -0
  213. package/dist/cli/main/types.js +2 -0
  214. package/dist/cli/main/ui.d.ts +12 -0
  215. package/dist/cli/main/ui.d.ts.map +1 -0
  216. package/dist/cli/main/ui.js +177 -0
  217. package/dist/cli/main/usage.d.ts +7 -0
  218. package/dist/cli/main/usage.d.ts.map +1 -0
  219. package/dist/cli/main/usage.js +154 -0
  220. package/dist/cli/main.d.ts +13 -0
  221. package/dist/cli/main.d.ts.map +1 -0
  222. package/dist/cli/main.js +50 -0
  223. package/dist/cli/mcpServeEntry.d.ts +3 -0
  224. package/dist/cli/mcpServeEntry.d.ts.map +1 -0
  225. package/dist/cli/mcpServeEntry.js +8 -0
  226. package/dist/cli/render/ansi.d.ts +12 -0
  227. package/dist/cli/render/ansi.d.ts.map +1 -0
  228. package/dist/cli/render/ansi.js +24 -0
  229. package/dist/cli/render/effectTree.d.ts +17 -0
  230. package/dist/cli/render/effectTree.d.ts.map +1 -0
  231. package/dist/cli/render/effectTree.js +46 -0
  232. package/dist/cli/render/events/effectRequested.d.ts +3 -0
  233. package/dist/cli/render/events/effectRequested.d.ts.map +1 -0
  234. package/dist/cli/render/events/effectRequested.js +22 -0
  235. package/dist/cli/render/events/effectResolved.d.ts +3 -0
  236. package/dist/cli/render/events/effectResolved.d.ts.map +1 -0
  237. package/dist/cli/render/events/effectResolved.js +20 -0
  238. package/dist/cli/render/events/index.d.ts +4 -0
  239. package/dist/cli/render/events/index.d.ts.map +1 -0
  240. package/dist/cli/render/events/index.js +25 -0
  241. package/dist/cli/render/events/processAssigned.d.ts +3 -0
  242. package/dist/cli/render/events/processAssigned.d.ts.map +1 -0
  243. package/dist/cli/render/events/processAssigned.js +22 -0
  244. package/dist/cli/render/events/runCompleted.d.ts +3 -0
  245. package/dist/cli/render/events/runCompleted.d.ts.map +1 -0
  246. package/dist/cli/render/events/runCompleted.js +18 -0
  247. package/dist/cli/render/events/runCreated.d.ts +3 -0
  248. package/dist/cli/render/events/runCreated.d.ts.map +1 -0
  249. package/dist/cli/render/events/runCreated.js +19 -0
  250. package/dist/cli/render/events/runFailed.d.ts +3 -0
  251. package/dist/cli/render/events/runFailed.d.ts.map +1 -0
  252. package/dist/cli/render/events/runFailed.js +23 -0
  253. package/dist/cli/render/events/types.d.ts +6 -0
  254. package/dist/cli/render/events/types.d.ts.map +1 -0
  255. package/dist/cli/render/events/types.js +2 -0
  256. package/dist/cli/render/index.d.ts +5 -0
  257. package/dist/cli/render/index.d.ts.map +1 -0
  258. package/dist/cli/render/index.js +14 -0
  259. package/dist/cli/render/statusBadge.d.ts +4 -0
  260. package/dist/cli/render/statusBadge.d.ts.map +1 -0
  261. package/dist/cli/render/statusBadge.js +25 -0
  262. package/dist/cli/resolveInputPath.d.ts +61 -0
  263. package/dist/cli/resolveInputPath.d.ts.map +1 -0
  264. package/dist/cli/resolveInputPath.js +193 -0
  265. package/dist/compression/config-loader.d.ts +24 -0
  266. package/dist/compression/config-loader.d.ts.map +1 -0
  267. package/dist/compression/config-loader.js +179 -0
  268. package/dist/compression/config.d.ts +49 -0
  269. package/dist/compression/config.d.ts.map +1 -0
  270. package/dist/compression/config.js +41 -0
  271. package/dist/compression/density-filter.d.ts +20 -0
  272. package/dist/compression/density-filter.d.ts.map +1 -0
  273. package/dist/compression/density-filter.js +91 -0
  274. package/dist/compression/library-cache.d.ts +19 -0
  275. package/dist/compression/library-cache.d.ts.map +1 -0
  276. package/dist/compression/library-cache.js +149 -0
  277. package/dist/config/configValidation.d.ts +22 -0
  278. package/dist/config/configValidation.d.ts.map +1 -0
  279. package/dist/config/configValidation.js +140 -0
  280. package/dist/config/defaults.d.ts +67 -0
  281. package/dist/config/defaults.d.ts.map +1 -0
  282. package/dist/config/defaults.js +132 -0
  283. package/dist/config/index.d.ts +26 -0
  284. package/dist/config/index.d.ts.map +1 -0
  285. package/dist/config/index.js +51 -0
  286. package/dist/config/runs.d.ts +22 -0
  287. package/dist/config/runs.d.ts.map +1 -0
  288. package/dist/config/runs.js +192 -0
  289. package/dist/cost/claudeCodeParser.d.ts +81 -0
  290. package/dist/cost/claudeCodeParser.d.ts.map +1 -0
  291. package/dist/cost/claudeCodeParser.js +232 -0
  292. package/dist/cost/collector.d.ts +42 -0
  293. package/dist/cost/collector.d.ts.map +1 -0
  294. package/dist/cost/collector.js +105 -0
  295. package/dist/cost/index.d.ts +18 -0
  296. package/dist/cost/index.d.ts.map +1 -0
  297. package/dist/cost/index.js +38 -0
  298. package/dist/cost/journal.d.ts +40 -0
  299. package/dist/cost/journal.d.ts.map +1 -0
  300. package/dist/cost/journal.js +137 -0
  301. package/dist/cost/pricing.d.ts +19 -0
  302. package/dist/cost/pricing.d.ts.map +1 -0
  303. package/dist/cost/pricing.js +135 -0
  304. package/dist/cost/types.d.ts +87 -0
  305. package/dist/cost/types.d.ts.map +1 -0
  306. package/dist/cost/types.js +19 -0
  307. package/dist/harness/BaseAdapter.d.ts +93 -0
  308. package/dist/harness/BaseAdapter.d.ts.map +1 -0
  309. package/dist/harness/BaseAdapter.js +236 -0
  310. package/dist/harness/adapters/claude-code.d.ts +24 -0
  311. package/dist/harness/adapters/claude-code.d.ts.map +1 -0
  312. package/dist/harness/adapters/claude-code.js +64 -0
  313. package/dist/harness/adapters/codex.d.ts +12 -0
  314. package/dist/harness/adapters/codex.d.ts.map +1 -0
  315. package/dist/harness/adapters/codex.js +37 -0
  316. package/dist/harness/adapters/cursor.d.ts +13 -0
  317. package/dist/harness/adapters/cursor.d.ts.map +1 -0
  318. package/dist/harness/adapters/cursor.js +85 -0
  319. package/dist/harness/adapters/gemini-cli.d.ts +12 -0
  320. package/dist/harness/adapters/gemini-cli.d.ts.map +1 -0
  321. package/dist/harness/adapters/gemini-cli.js +34 -0
  322. package/dist/harness/adapters/github-copilot.d.ts +13 -0
  323. package/dist/harness/adapters/github-copilot.d.ts.map +1 -0
  324. package/dist/harness/adapters/github-copilot.js +59 -0
  325. package/dist/harness/adapters/index.d.ts +12 -0
  326. package/dist/harness/adapters/index.d.ts.map +1 -0
  327. package/dist/harness/adapters/index.js +26 -0
  328. package/dist/harness/adapters/oh-my-pi.d.ts +12 -0
  329. package/dist/harness/adapters/oh-my-pi.d.ts.map +1 -0
  330. package/dist/harness/adapters/oh-my-pi.js +41 -0
  331. package/dist/harness/adapters/openclaw.d.ts +12 -0
  332. package/dist/harness/adapters/openclaw.d.ts.map +1 -0
  333. package/dist/harness/adapters/openclaw.js +49 -0
  334. package/dist/harness/adapters/opencode.d.ts +12 -0
  335. package/dist/harness/adapters/opencode.d.ts.map +1 -0
  336. package/dist/harness/adapters/opencode.js +51 -0
  337. package/dist/harness/adapters/pi.d.ts +12 -0
  338. package/dist/harness/adapters/pi.d.ts.map +1 -0
  339. package/dist/harness/adapters/pi.js +41 -0
  340. package/dist/harness/amuxFallbackMetadata.d.ts +3 -0
  341. package/dist/harness/amuxFallbackMetadata.d.ts.map +1 -0
  342. package/dist/harness/amuxFallbackMetadata.js +201 -0
  343. package/dist/harness/amuxMetadata.d.ts +51 -0
  344. package/dist/harness/amuxMetadata.d.ts.map +1 -0
  345. package/dist/harness/amuxMetadata.js +176 -0
  346. package/dist/harness/customAdapter.d.ts +14 -0
  347. package/dist/harness/customAdapter.d.ts.map +1 -0
  348. package/dist/harness/customAdapter.js +124 -0
  349. package/dist/harness/derivePromptContext.d.ts +75 -0
  350. package/dist/harness/derivePromptContext.d.ts.map +1 -0
  351. package/dist/harness/derivePromptContext.js +120 -0
  352. package/dist/harness/discovery.d.ts +80 -0
  353. package/dist/harness/discovery.d.ts.map +1 -0
  354. package/dist/harness/discovery.js +313 -0
  355. package/dist/harness/hooks/babysitterHooks.d.ts +23 -0
  356. package/dist/harness/hooks/babysitterHooks.d.ts.map +1 -0
  357. package/dist/harness/hooks/babysitterHooks.js +162 -0
  358. package/dist/harness/hooks/promptContexts.d.ts +24 -0
  359. package/dist/harness/hooks/promptContexts.d.ts.map +1 -0
  360. package/dist/harness/hooks/promptContexts.js +106 -0
  361. package/dist/harness/hooks/runState.d.ts +14 -0
  362. package/dist/harness/hooks/runState.d.ts.map +1 -0
  363. package/dist/harness/hooks/runState.js +103 -0
  364. package/dist/harness/hooks/sessionBinding.d.ts +28 -0
  365. package/dist/harness/hooks/sessionBinding.d.ts.map +1 -0
  366. package/dist/harness/hooks/sessionBinding.js +153 -0
  367. package/dist/harness/hooks/stopHookContinuation.d.ts +44 -0
  368. package/dist/harness/hooks/stopHookContinuation.d.ts.map +1 -0
  369. package/dist/harness/hooks/stopHookContinuation.js +280 -0
  370. package/dist/harness/hooks/stopHookHandler.d.ts +35 -0
  371. package/dist/harness/hooks/stopHookHandler.d.ts.map +1 -0
  372. package/dist/harness/hooks/stopHookHandler.js +354 -0
  373. package/dist/harness/hooks/utils.d.ts +43 -0
  374. package/dist/harness/hooks/utils.d.ts.map +1 -0
  375. package/dist/harness/hooks/utils.js +215 -0
  376. package/dist/harness/index.d.ts +20 -0
  377. package/dist/harness/index.d.ts.map +1 -0
  378. package/dist/harness/index.js +51 -0
  379. package/dist/harness/install.d.ts +71 -0
  380. package/dist/harness/install.d.ts.map +1 -0
  381. package/dist/harness/install.js +267 -0
  382. package/dist/harness/installSupport.d.ts +37 -0
  383. package/dist/harness/installSupport.d.ts.map +1 -0
  384. package/dist/harness/installSupport.js +203 -0
  385. package/dist/harness/internal/promptContext.d.ts +3 -0
  386. package/dist/harness/internal/promptContext.d.ts.map +1 -0
  387. package/dist/harness/internal/promptContext.js +29 -0
  388. package/dist/harness/nullAdapter.d.ts +9 -0
  389. package/dist/harness/nullAdapter.d.ts.map +1 -0
  390. package/dist/harness/nullAdapter.js +46 -0
  391. package/dist/harness/registry.d.ts +51 -0
  392. package/dist/harness/registry.d.ts.map +1 -0
  393. package/dist/harness/registry.js +235 -0
  394. package/dist/harness/types.d.ts +200 -0
  395. package/dist/harness/types.d.ts.map +1 -0
  396. package/dist/harness/types.js +34 -0
  397. package/dist/harness/unified/adapter.d.ts +21 -0
  398. package/dist/harness/unified/adapter.d.ts.map +1 -0
  399. package/dist/harness/unified/adapter.js +239 -0
  400. package/dist/harness/unified/capabilities.d.ts +37 -0
  401. package/dist/harness/unified/capabilities.d.ts.map +1 -0
  402. package/dist/harness/unified/capabilities.js +79 -0
  403. package/dist/harness/unified/discovery.d.ts +11 -0
  404. package/dist/harness/unified/discovery.d.ts.map +1 -0
  405. package/dist/harness/unified/discovery.js +23 -0
  406. package/dist/harness/unified/index.d.ts +6 -0
  407. package/dist/harness/unified/index.d.ts.map +1 -0
  408. package/dist/harness/unified/index.js +16 -0
  409. package/dist/harness/unified/promptContext.d.ts +16 -0
  410. package/dist/harness/unified/promptContext.d.ts.map +1 -0
  411. package/dist/harness/unified/promptContext.js +56 -0
  412. package/dist/harness/unified/subprocess.d.ts +57 -0
  413. package/dist/harness/unified/subprocess.d.ts.map +1 -0
  414. package/dist/harness/unified/subprocess.js +121 -0
  415. package/dist/hooks/dispatcher.d.ts +29 -0
  416. package/dist/hooks/dispatcher.d.ts.map +1 -0
  417. package/dist/hooks/dispatcher.js +337 -0
  418. package/dist/hooks/index.d.ts +16 -0
  419. package/dist/hooks/index.d.ts.map +1 -0
  420. package/dist/hooks/index.js +20 -0
  421. package/dist/hooks/types.d.ts +170 -0
  422. package/dist/hooks/types.d.ts.map +1 -0
  423. package/dist/hooks/types.js +6 -0
  424. package/dist/index.d.ts +29 -0
  425. package/dist/index.d.ts.map +1 -0
  426. package/dist/index.js +76 -0
  427. package/dist/logging/index.d.ts +3 -0
  428. package/dist/logging/index.d.ts.map +1 -0
  429. package/dist/logging/index.js +11 -0
  430. package/dist/logging/runLogger.d.ts +85 -0
  431. package/dist/logging/runLogger.d.ts.map +1 -0
  432. package/dist/logging/runLogger.js +182 -0
  433. package/dist/mcp/index.d.ts +7 -0
  434. package/dist/mcp/index.d.ts.map +1 -0
  435. package/dist/mcp/index.js +53 -0
  436. package/dist/mcp/server.d.ts +3 -0
  437. package/dist/mcp/server.d.ts.map +1 -0
  438. package/dist/mcp/server.js +21 -0
  439. package/dist/mcp/tools/discovery.d.ts +3 -0
  440. package/dist/mcp/tools/discovery.d.ts.map +1 -0
  441. package/dist/mcp/tools/discovery.js +117 -0
  442. package/dist/mcp/tools/runs.d.ts +3 -0
  443. package/dist/mcp/tools/runs.d.ts.map +1 -0
  444. package/dist/mcp/tools/runs.js +289 -0
  445. package/dist/mcp/tools/sessions.d.ts +3 -0
  446. package/dist/mcp/tools/sessions.d.ts.map +1 -0
  447. package/dist/mcp/tools/sessions.js +216 -0
  448. package/dist/mcp/tools/tasks.d.ts +3 -0
  449. package/dist/mcp/tools/tasks.d.ts.map +1 -0
  450. package/dist/mcp/tools/tasks.js +230 -0
  451. package/dist/mcp/transport/index.d.ts +1 -0
  452. package/dist/mcp/transport/index.d.ts.map +1 -0
  453. package/dist/mcp/transport/index.js +2 -0
  454. package/dist/mcp/util/errors.d.ts +14 -0
  455. package/dist/mcp/util/errors.d.ts.map +1 -0
  456. package/dist/mcp/util/errors.js +10 -0
  457. package/dist/mcp/util/resolve-run-dir.d.ts +6 -0
  458. package/dist/mcp/util/resolve-run-dir.d.ts.map +1 -0
  459. package/dist/mcp/util/resolve-run-dir.js +11 -0
  460. package/dist/plugins/index.d.ts +14 -0
  461. package/dist/plugins/index.d.ts.map +1 -0
  462. package/dist/plugins/index.js +51 -0
  463. package/dist/plugins/marketplace.d.ts +36 -0
  464. package/dist/plugins/marketplace.d.ts.map +1 -0
  465. package/dist/plugins/marketplace.js +162 -0
  466. package/dist/plugins/marketplaceHelpers.d.ts +15 -0
  467. package/dist/plugins/marketplaceHelpers.d.ts.map +1 -0
  468. package/dist/plugins/marketplaceHelpers.js +114 -0
  469. package/dist/plugins/migrations.d.ts +52 -0
  470. package/dist/plugins/migrations.d.ts.map +1 -0
  471. package/dist/plugins/migrations.js +151 -0
  472. package/dist/plugins/packageReader.d.ts +47 -0
  473. package/dist/plugins/packageReader.d.ts.map +1 -0
  474. package/dist/plugins/packageReader.js +153 -0
  475. package/dist/plugins/paths.d.ts +30 -0
  476. package/dist/plugins/paths.d.ts.map +1 -0
  477. package/dist/plugins/paths.js +69 -0
  478. package/dist/plugins/registry.d.ts +54 -0
  479. package/dist/plugins/registry.d.ts.map +1 -0
  480. package/dist/plugins/registry.js +116 -0
  481. package/dist/plugins/types.d.ts +133 -0
  482. package/dist/plugins/types.d.ts.map +1 -0
  483. package/dist/plugins/types.js +35 -0
  484. package/dist/processLibrary/active.d.ts +17 -0
  485. package/dist/processLibrary/active.d.ts.map +1 -0
  486. package/dist/processLibrary/active.js +216 -0
  487. package/dist/processLibrary/activeTypes.d.ts +82 -0
  488. package/dist/processLibrary/activeTypes.d.ts.map +1 -0
  489. package/dist/processLibrary/activeTypes.js +6 -0
  490. package/dist/profiles/index.d.ts +25 -0
  491. package/dist/profiles/index.d.ts.map +1 -0
  492. package/dist/profiles/index.js +40 -0
  493. package/dist/profiles/projectProfile.d.ts +67 -0
  494. package/dist/profiles/projectProfile.d.ts.map +1 -0
  495. package/dist/profiles/projectProfile.js +169 -0
  496. package/dist/profiles/projectProfileMerge.d.ts +3 -0
  497. package/dist/profiles/projectProfileMerge.d.ts.map +1 -0
  498. package/dist/profiles/projectProfileMerge.js +175 -0
  499. package/dist/profiles/projectProfileRender.d.ts +3 -0
  500. package/dist/profiles/projectProfileRender.d.ts.map +1 -0
  501. package/dist/profiles/projectProfileRender.js +275 -0
  502. package/dist/profiles/projectTypes.d.ts +149 -0
  503. package/dist/profiles/projectTypes.d.ts.map +1 -0
  504. package/dist/profiles/projectTypes.js +6 -0
  505. package/dist/profiles/types.d.ts +5 -0
  506. package/dist/profiles/types.d.ts.map +1 -0
  507. package/dist/profiles/types.js +11 -0
  508. package/dist/profiles/userProfile.d.ts +67 -0
  509. package/dist/profiles/userProfile.d.ts.map +1 -0
  510. package/dist/profiles/userProfile.js +351 -0
  511. package/dist/profiles/userProfileRender.d.ts +3 -0
  512. package/dist/profiles/userProfileRender.d.ts.map +1 -0
  513. package/dist/profiles/userProfileRender.js +188 -0
  514. package/dist/profiles/userTypes.d.ts +119 -0
  515. package/dist/profiles/userTypes.d.ts.map +1 -0
  516. package/dist/profiles/userTypes.js +6 -0
  517. package/dist/prompts/babysitterMdDiscovery.d.ts +38 -0
  518. package/dist/prompts/babysitterMdDiscovery.d.ts.map +1 -0
  519. package/dist/prompts/babysitterMdDiscovery.js +150 -0
  520. package/dist/prompts/capabilityCollector.d.ts +48 -0
  521. package/dist/prompts/capabilityCollector.d.ts.map +1 -0
  522. package/dist/prompts/capabilityCollector.js +126 -0
  523. package/dist/prompts/capabilityProcessMap.d.ts +33 -0
  524. package/dist/prompts/capabilityProcessMap.d.ts.map +1 -0
  525. package/dist/prompts/capabilityProcessMap.js +105 -0
  526. package/dist/prompts/commandTemplates.d.ts +4 -0
  527. package/dist/prompts/commandTemplates.d.ts.map +1 -0
  528. package/dist/prompts/commandTemplates.js +32 -0
  529. package/dist/prompts/compose.d.ts +28 -0
  530. package/dist/prompts/compose.d.ts.map +1 -0
  531. package/dist/prompts/compose.js +197 -0
  532. package/dist/prompts/context.d.ts +8 -0
  533. package/dist/prompts/context.d.ts.map +1 -0
  534. package/dist/prompts/context.js +13 -0
  535. package/dist/prompts/contextDetect.d.ts +64 -0
  536. package/dist/prompts/contextDetect.d.ts.map +1 -0
  537. package/dist/prompts/contextDetect.js +122 -0
  538. package/dist/prompts/contextShared.d.ts +6 -0
  539. package/dist/prompts/contextShared.d.ts.map +1 -0
  540. package/dist/prompts/contextShared.js +63 -0
  541. package/dist/prompts/continuityOverlay.d.ts +35 -0
  542. package/dist/prompts/continuityOverlay.d.ts.map +1 -0
  543. package/dist/prompts/continuityOverlay.js +210 -0
  544. package/dist/prompts/index.d.ts +23 -0
  545. package/dist/prompts/index.d.ts.map +1 -0
  546. package/dist/prompts/index.js +88 -0
  547. package/dist/prompts/parts/breakpointHandling.d.ts +8 -0
  548. package/dist/prompts/parts/breakpointHandling.d.ts.map +1 -0
  549. package/dist/prompts/parts/breakpointHandling.js +12 -0
  550. package/dist/prompts/parts/codingPhilosophy.d.ts +7 -0
  551. package/dist/prompts/parts/codingPhilosophy.d.ts.map +1 -0
  552. package/dist/prompts/parts/codingPhilosophy.js +11 -0
  553. package/dist/prompts/parts/completionProof.d.ts +6 -0
  554. package/dist/prompts/parts/completionProof.d.ts.map +1 -0
  555. package/dist/prompts/parts/completionProof.js +10 -0
  556. package/dist/prompts/parts/continuityOverlay.d.ts +2 -0
  557. package/dist/prompts/parts/continuityOverlay.d.ts.map +1 -0
  558. package/dist/prompts/parts/continuityOverlay.js +5 -0
  559. package/dist/prompts/parts/criticalRules.d.ts +7 -0
  560. package/dist/prompts/parts/criticalRules.d.ts.map +1 -0
  561. package/dist/prompts/parts/criticalRules.js +29 -0
  562. package/dist/prompts/parts/dependencies.d.ts +6 -0
  563. package/dist/prompts/parts/dependencies.d.ts.map +1 -0
  564. package/dist/prompts/parts/dependencies.js +10 -0
  565. package/dist/prompts/parts/effects.d.ts +6 -0
  566. package/dist/prompts/parts/effects.d.ts.map +1 -0
  567. package/dist/prompts/parts/effects.js +10 -0
  568. package/dist/prompts/parts/gitSafety.d.ts +7 -0
  569. package/dist/prompts/parts/gitSafety.d.ts.map +1 -0
  570. package/dist/prompts/parts/gitSafety.js +11 -0
  571. package/dist/prompts/parts/index.d.ts +37 -0
  572. package/dist/prompts/parts/index.d.ts.map +1 -0
  573. package/dist/prompts/parts/index.js +70 -0
  574. package/dist/prompts/parts/intentFidelityChecks.d.ts +7 -0
  575. package/dist/prompts/parts/intentFidelityChecks.d.ts.map +1 -0
  576. package/dist/prompts/parts/intentFidelityChecks.js +14 -0
  577. package/dist/prompts/parts/interview.d.ts +6 -0
  578. package/dist/prompts/parts/interview.d.ts.map +1 -0
  579. package/dist/prompts/parts/interview.js +18 -0
  580. package/dist/prompts/parts/iteration.d.ts +6 -0
  581. package/dist/prompts/parts/iteration.d.ts.map +1 -0
  582. package/dist/prompts/parts/iteration.js +15 -0
  583. package/dist/prompts/parts/loopControl.d.ts +11 -0
  584. package/dist/prompts/parts/loopControl.d.ts.map +1 -0
  585. package/dist/prompts/parts/loopControl.js +22 -0
  586. package/dist/prompts/parts/nonNegotiables.d.ts +7 -0
  587. package/dist/prompts/parts/nonNegotiables.d.ts.map +1 -0
  588. package/dist/prompts/parts/nonNegotiables.js +14 -0
  589. package/dist/prompts/parts/outputEfficiency.d.ts +7 -0
  590. package/dist/prompts/parts/outputEfficiency.d.ts.map +1 -0
  591. package/dist/prompts/parts/outputEfficiency.js +11 -0
  592. package/dist/prompts/parts/parallelDispatch.d.ts +15 -0
  593. package/dist/prompts/parts/parallelDispatch.d.ts.map +1 -0
  594. package/dist/prompts/parts/parallelDispatch.js +46 -0
  595. package/dist/prompts/parts/parallelPhaseDetection.d.ts +6 -0
  596. package/dist/prompts/parts/parallelPhaseDetection.d.ts.map +1 -0
  597. package/dist/prompts/parts/parallelPhaseDetection.js +10 -0
  598. package/dist/prompts/parts/priorityLadder.d.ts +7 -0
  599. package/dist/prompts/parts/priorityLadder.d.ts.map +1 -0
  600. package/dist/prompts/parts/priorityLadder.js +13 -0
  601. package/dist/prompts/parts/processCreation.d.ts +6 -0
  602. package/dist/prompts/parts/processCreation.d.ts.map +1 -0
  603. package/dist/prompts/parts/processCreation.js +10 -0
  604. package/dist/prompts/parts/processGuidelines.d.ts +7 -0
  605. package/dist/prompts/parts/processGuidelines.d.ts.map +1 -0
  606. package/dist/prompts/parts/processGuidelines.js +11 -0
  607. package/dist/prompts/parts/projectInstructions.d.ts +8 -0
  608. package/dist/prompts/parts/projectInstructions.d.ts.map +1 -0
  609. package/dist/prompts/parts/projectInstructions.js +28 -0
  610. package/dist/prompts/parts/quickReference.d.ts +6 -0
  611. package/dist/prompts/parts/quickReference.d.ts.map +1 -0
  612. package/dist/prompts/parts/quickReference.js +17 -0
  613. package/dist/prompts/parts/recovery.d.ts +7 -0
  614. package/dist/prompts/parts/recovery.d.ts.map +1 -0
  615. package/dist/prompts/parts/recovery.js +11 -0
  616. package/dist/prompts/parts/resultsPosting.d.ts +7 -0
  617. package/dist/prompts/parts/resultsPosting.d.ts.map +1 -0
  618. package/dist/prompts/parts/resultsPosting.js +11 -0
  619. package/dist/prompts/parts/rootCauseGuardrail.d.ts +7 -0
  620. package/dist/prompts/parts/rootCauseGuardrail.d.ts.map +1 -0
  621. package/dist/prompts/parts/rootCauseGuardrail.js +13 -0
  622. package/dist/prompts/parts/runCreation.d.ts +7 -0
  623. package/dist/prompts/parts/runCreation.d.ts.map +1 -0
  624. package/dist/prompts/parts/runCreation.js +61 -0
  625. package/dist/prompts/parts/runOverlapDetection.d.ts +6 -0
  626. package/dist/prompts/parts/runOverlapDetection.d.ts.map +1 -0
  627. package/dist/prompts/parts/runOverlapDetection.js +10 -0
  628. package/dist/prompts/parts/seeAlso.d.ts +7 -0
  629. package/dist/prompts/parts/seeAlso.d.ts.map +1 -0
  630. package/dist/prompts/parts/seeAlso.js +11 -0
  631. package/dist/prompts/parts/taskExamples.d.ts +7 -0
  632. package/dist/prompts/parts/taskExamples.d.ts.map +1 -0
  633. package/dist/prompts/parts/taskExamples.js +11 -0
  634. package/dist/prompts/parts/taskKinds.d.ts +6 -0
  635. package/dist/prompts/parts/taskKinds.d.ts.map +1 -0
  636. package/dist/prompts/parts/taskKinds.js +25 -0
  637. package/dist/prompts/parts/toolPreferences.d.ts +7 -0
  638. package/dist/prompts/parts/toolPreferences.d.ts.map +1 -0
  639. package/dist/prompts/parts/toolPreferences.js +11 -0
  640. package/dist/prompts/parts/userProfile.d.ts +7 -0
  641. package/dist/prompts/parts/userProfile.d.ts.map +1 -0
  642. package/dist/prompts/parts/userProfile.js +11 -0
  643. package/dist/prompts/runtimeContext.d.ts +30 -0
  644. package/dist/prompts/runtimeContext.d.ts.map +1 -0
  645. package/dist/prompts/runtimeContext.js +38 -0
  646. package/dist/prompts/strata.d.ts +60 -0
  647. package/dist/prompts/strata.d.ts.map +1 -0
  648. package/dist/prompts/strata.js +243 -0
  649. package/dist/prompts/templateRenderer.d.ts +18 -0
  650. package/dist/prompts/templateRenderer.d.ts.map +1 -0
  651. package/dist/prompts/templateRenderer.js +131 -0
  652. package/dist/prompts/templates/breakpoint-handling.md +137 -0
  653. package/dist/prompts/templates/coding-philosophy.md +12 -0
  654. package/dist/prompts/templates/commands/assimilate.md +47 -0
  655. package/dist/prompts/templates/commands/cleanup.md +54 -0
  656. package/dist/prompts/templates/commands/contrib.md +40 -0
  657. package/dist/prompts/templates/commands/doctor.md +511 -0
  658. package/dist/prompts/templates/commands/forever.md +11 -0
  659. package/dist/prompts/templates/commands/project-install.md +25 -0
  660. package/dist/prompts/templates/commands/retrospect.md +68 -0
  661. package/dist/prompts/templates/commands/user-install.md +24 -0
  662. package/dist/prompts/templates/completion-proof.md +21 -0
  663. package/dist/prompts/templates/critical-rules.md +73 -0
  664. package/dist/prompts/templates/dependencies.md +9 -0
  665. package/dist/prompts/templates/effects.md +46 -0
  666. package/dist/prompts/templates/git-safety.md +9 -0
  667. package/dist/prompts/templates/intent-fidelity-checks.md +31 -0
  668. package/dist/prompts/templates/interview.md +65 -0
  669. package/dist/prompts/templates/iteration.md +41 -0
  670. package/dist/prompts/templates/loop-control.md +64 -0
  671. package/dist/prompts/templates/non-negotiables.md +11 -0
  672. package/dist/prompts/templates/output-efficiency.md +12 -0
  673. package/dist/prompts/templates/parallel-phase-detection.md +59 -0
  674. package/dist/prompts/templates/priority-ladder.md +13 -0
  675. package/dist/prompts/templates/process-creation.md +130 -0
  676. package/dist/prompts/templates/process-guidelines.md +106 -0
  677. package/dist/prompts/templates/quick-reference.md +46 -0
  678. package/dist/prompts/templates/recovery.md +30 -0
  679. package/dist/prompts/templates/results-posting.md +69 -0
  680. package/dist/prompts/templates/root-cause-guardrail.md +14 -0
  681. package/dist/prompts/templates/run-creation.md +80 -0
  682. package/dist/prompts/templates/run-overlap-detection.md +65 -0
  683. package/dist/prompts/templates/see-also.md +4 -0
  684. package/dist/prompts/templates/task-examples.md +229 -0
  685. package/dist/prompts/templates/task-kinds.md +106 -0
  686. package/dist/prompts/templates/tool-preferences.md +8 -0
  687. package/dist/prompts/templates/user-profile.md +48 -0
  688. package/dist/prompts/types.d.ts +191 -0
  689. package/dist/prompts/types.d.ts.map +1 -0
  690. package/dist/prompts/types.js +7 -0
  691. package/dist/runtime/asyncEffects.d.ts +22 -0
  692. package/dist/runtime/asyncEffects.d.ts.map +1 -0
  693. package/dist/runtime/asyncEffects.js +86 -0
  694. package/dist/runtime/commitEffectResult.d.ts +12 -0
  695. package/dist/runtime/commitEffectResult.d.ts.map +1 -0
  696. package/dist/runtime/commitEffectResult.js +240 -0
  697. package/dist/runtime/constants.d.ts +2 -0
  698. package/dist/runtime/constants.d.ts.map +1 -0
  699. package/dist/runtime/constants.js +5 -0
  700. package/dist/runtime/createRun.d.ts +3 -0
  701. package/dist/runtime/createRun.d.ts.map +1 -0
  702. package/dist/runtime/createRun.js +142 -0
  703. package/dist/runtime/effectGroupRegistry.d.ts +57 -0
  704. package/dist/runtime/effectGroupRegistry.d.ts.map +1 -0
  705. package/dist/runtime/effectGroupRegistry.js +107 -0
  706. package/dist/runtime/errorSuggestions.d.ts +4 -0
  707. package/dist/runtime/errorSuggestions.d.ts.map +1 -0
  708. package/dist/runtime/errorSuggestions.js +98 -0
  709. package/dist/runtime/errorTemplates.d.ts +101 -0
  710. package/dist/runtime/errorTemplates.d.ts.map +1 -0
  711. package/dist/runtime/errorTemplates.js +173 -0
  712. package/dist/runtime/errorUtils.d.ts +10 -0
  713. package/dist/runtime/errorUtils.d.ts.map +1 -0
  714. package/dist/runtime/errorUtils.js +42 -0
  715. package/dist/runtime/exceptions.d.ts +73 -0
  716. package/dist/runtime/exceptions.d.ts.map +1 -0
  717. package/dist/runtime/exceptions.js +197 -0
  718. package/dist/runtime/hooks/runtime.d.ts +31 -0
  719. package/dist/runtime/hooks/runtime.d.ts.map +1 -0
  720. package/dist/runtime/hooks/runtime.js +67 -0
  721. package/dist/runtime/index.d.ts +18 -0
  722. package/dist/runtime/index.d.ts.map +1 -0
  723. package/dist/runtime/index.js +61 -0
  724. package/dist/runtime/instrumentation.d.ts +6 -0
  725. package/dist/runtime/instrumentation.d.ts.map +1 -0
  726. package/dist/runtime/instrumentation.js +14 -0
  727. package/dist/runtime/intrinsics/breakpoint.d.ts +9 -0
  728. package/dist/runtime/intrinsics/breakpoint.d.ts.map +1 -0
  729. package/dist/runtime/intrinsics/breakpoint.js +108 -0
  730. package/dist/runtime/intrinsics/hook.d.ts +26 -0
  731. package/dist/runtime/intrinsics/hook.d.ts.map +1 -0
  732. package/dist/runtime/intrinsics/hook.js +45 -0
  733. package/dist/runtime/intrinsics/index.d.ts +7 -0
  734. package/dist/runtime/intrinsics/index.d.ts.map +1 -0
  735. package/dist/runtime/intrinsics/index.js +15 -0
  736. package/dist/runtime/intrinsics/orchestratorTask.d.ts +4 -0
  737. package/dist/runtime/intrinsics/orchestratorTask.d.ts.map +1 -0
  738. package/dist/runtime/intrinsics/orchestratorTask.js +28 -0
  739. package/dist/runtime/intrinsics/parallel.d.ts +9 -0
  740. package/dist/runtime/intrinsics/parallel.d.ts.map +1 -0
  741. package/dist/runtime/intrinsics/parallel.js +160 -0
  742. package/dist/runtime/intrinsics/parallelGroup.d.ts +16 -0
  743. package/dist/runtime/intrinsics/parallelGroup.d.ts.map +1 -0
  744. package/dist/runtime/intrinsics/parallelGroup.js +105 -0
  745. package/dist/runtime/intrinsics/sleep.d.ts +4 -0
  746. package/dist/runtime/intrinsics/sleep.d.ts.map +1 -0
  747. package/dist/runtime/intrinsics/sleep.js +70 -0
  748. package/dist/runtime/intrinsics/subprocess.d.ts +5 -0
  749. package/dist/runtime/intrinsics/subprocess.d.ts.map +1 -0
  750. package/dist/runtime/intrinsics/subprocess.js +56 -0
  751. package/dist/runtime/intrinsics/task.d.ts +26 -0
  752. package/dist/runtime/intrinsics/task.d.ts.map +1 -0
  753. package/dist/runtime/intrinsics/task.js +132 -0
  754. package/dist/runtime/intrinsics/taskHelpers.d.ts +20 -0
  755. package/dist/runtime/intrinsics/taskHelpers.d.ts.map +1 -0
  756. package/dist/runtime/intrinsics/taskHelpers.js +148 -0
  757. package/dist/runtime/invocation/hashInvocationKey.d.ts +12 -0
  758. package/dist/runtime/invocation/hashInvocationKey.d.ts.map +1 -0
  759. package/dist/runtime/invocation/hashInvocationKey.js +12 -0
  760. package/dist/runtime/invocation/index.d.ts +3 -0
  761. package/dist/runtime/invocation/index.d.ts.map +1 -0
  762. package/dist/runtime/invocation/index.js +5 -0
  763. package/dist/runtime/orchestrateHelpers.d.ts +16 -0
  764. package/dist/runtime/orchestrateHelpers.d.ts.map +1 -0
  765. package/dist/runtime/orchestrateHelpers.js +103 -0
  766. package/dist/runtime/orchestrateIteration.d.ts +4 -0
  767. package/dist/runtime/orchestrateIteration.d.ts.map +1 -0
  768. package/dist/runtime/orchestrateIteration.js +213 -0
  769. package/dist/runtime/parallelStrategies.d.ts +23 -0
  770. package/dist/runtime/parallelStrategies.d.ts.map +1 -0
  771. package/dist/runtime/parallelStrategies.js +79 -0
  772. package/dist/runtime/policy/engine.d.ts +4 -0
  773. package/dist/runtime/policy/engine.d.ts.map +1 -0
  774. package/dist/runtime/policy/engine.js +97 -0
  775. package/dist/runtime/policy/index.d.ts +5 -0
  776. package/dist/runtime/policy/index.d.ts.map +1 -0
  777. package/dist/runtime/policy/index.js +13 -0
  778. package/dist/runtime/policy/logging.d.ts +6 -0
  779. package/dist/runtime/policy/logging.d.ts.map +1 -0
  780. package/dist/runtime/policy/logging.js +43 -0
  781. package/dist/runtime/policy/types.d.ts +55 -0
  782. package/dist/runtime/policy/types.d.ts.map +1 -0
  783. package/dist/runtime/policy/types.js +10 -0
  784. package/dist/runtime/processContext.d.ts +36 -0
  785. package/dist/runtime/processContext.d.ts.map +1 -0
  786. package/dist/runtime/processContext.js +161 -0
  787. package/dist/runtime/replay/createReplayEngine.d.ts +32 -0
  788. package/dist/runtime/replay/createReplayEngine.d.ts.map +1 -0
  789. package/dist/runtime/replay/createReplayEngine.js +189 -0
  790. package/dist/runtime/replay/effectIndex.d.ts +39 -0
  791. package/dist/runtime/replay/effectIndex.d.ts.map +1 -0
  792. package/dist/runtime/replay/effectIndex.js +322 -0
  793. package/dist/runtime/replay/index.d.ts +7 -0
  794. package/dist/runtime/replay/index.d.ts.map +1 -0
  795. package/dist/runtime/replay/index.js +19 -0
  796. package/dist/runtime/replay/replayCursor.d.ts +7 -0
  797. package/dist/runtime/replay/replayCursor.d.ts.map +1 -0
  798. package/dist/runtime/replay/replayCursor.js +22 -0
  799. package/dist/runtime/replay/stateCache.d.ts +50 -0
  800. package/dist/runtime/replay/stateCache.d.ts.map +1 -0
  801. package/dist/runtime/replay/stateCache.js +222 -0
  802. package/dist/runtime/runLifecycleState.d.ts +7 -0
  803. package/dist/runtime/runLifecycleState.d.ts.map +1 -0
  804. package/dist/runtime/runLifecycleState.js +54 -0
  805. package/dist/runtime/schemaValidator.d.ts +16 -0
  806. package/dist/runtime/schemaValidator.d.ts.map +1 -0
  807. package/dist/runtime/schemaValidator.js +92 -0
  808. package/dist/runtime/types.d.ts +240 -0
  809. package/dist/runtime/types.d.ts.map +1 -0
  810. package/dist/runtime/types.js +2 -0
  811. package/dist/sdkVersion.d.ts +5 -0
  812. package/dist/sdkVersion.d.ts.map +1 -0
  813. package/dist/sdkVersion.js +49 -0
  814. package/dist/session/cleanup.d.ts +17 -0
  815. package/dist/session/cleanup.d.ts.map +1 -0
  816. package/dist/session/cleanup.js +212 -0
  817. package/dist/session/discovery.d.ts +25 -0
  818. package/dist/session/discovery.d.ts.map +1 -0
  819. package/dist/session/discovery.js +44 -0
  820. package/dist/session/index.d.ts +15 -0
  821. package/dist/session/index.d.ts.map +1 -0
  822. package/dist/session/index.js +42 -0
  823. package/dist/session/parse.d.ts +45 -0
  824. package/dist/session/parse.d.ts.map +1 -0
  825. package/dist/session/parse.js +176 -0
  826. package/dist/session/transcript.d.ts +7 -0
  827. package/dist/session/transcript.d.ts.map +1 -0
  828. package/dist/session/transcript.js +51 -0
  829. package/dist/session/types.d.ts +196 -0
  830. package/dist/session/types.d.ts.map +1 -0
  831. package/dist/session/types.js +45 -0
  832. package/dist/session/whoami.d.ts +16 -0
  833. package/dist/session/whoami.d.ts.map +1 -0
  834. package/dist/session/whoami.js +108 -0
  835. package/dist/session/write.d.ts +61 -0
  836. package/dist/session/write.d.ts.map +1 -0
  837. package/dist/session/write.js +217 -0
  838. package/dist/storage/atomic.d.ts +2 -0
  839. package/dist/storage/atomic.d.ts.map +1 -0
  840. package/dist/storage/atomic.js +54 -0
  841. package/dist/storage/cleanup.d.ts +4 -0
  842. package/dist/storage/cleanup.d.ts.map +1 -0
  843. package/dist/storage/cleanup.js +96 -0
  844. package/dist/storage/clock.d.ts +6 -0
  845. package/dist/storage/clock.d.ts.map +1 -0
  846. package/dist/storage/clock.js +29 -0
  847. package/dist/storage/createRunDir.d.ts +6 -0
  848. package/dist/storage/createRunDir.d.ts.map +1 -0
  849. package/dist/storage/createRunDir.js +87 -0
  850. package/dist/storage/icloudWarning.d.ts +6 -0
  851. package/dist/storage/icloudWarning.d.ts.map +1 -0
  852. package/dist/storage/icloudWarning.js +84 -0
  853. package/dist/storage/index.d.ts +9 -0
  854. package/dist/storage/index.d.ts.map +1 -0
  855. package/dist/storage/index.js +36 -0
  856. package/dist/storage/journal.d.ts +4 -0
  857. package/dist/storage/journal.d.ts.map +1 -0
  858. package/dist/storage/journal.js +133 -0
  859. package/dist/storage/lock.d.ts +10 -0
  860. package/dist/storage/lock.d.ts.map +1 -0
  861. package/dist/storage/lock.js +82 -0
  862. package/dist/storage/paths.d.ts +23 -0
  863. package/dist/storage/paths.d.ts.map +1 -0
  864. package/dist/storage/paths.js +51 -0
  865. package/dist/storage/runFiles.d.ts +6 -0
  866. package/dist/storage/runFiles.d.ts.map +1 -0
  867. package/dist/storage/runFiles.js +44 -0
  868. package/dist/storage/tasks.d.ts +17 -0
  869. package/dist/storage/tasks.d.ts.map +1 -0
  870. package/dist/storage/tasks.js +83 -0
  871. package/dist/storage/types.d.ts +121 -0
  872. package/dist/storage/types.d.ts.map +1 -0
  873. package/dist/storage/types.js +2 -0
  874. package/dist/storage/ulids.d.ts +11 -0
  875. package/dist/storage/ulids.d.ts.map +1 -0
  876. package/dist/storage/ulids.js +25 -0
  877. package/dist/tasks/batching.d.ts +34 -0
  878. package/dist/tasks/batching.d.ts.map +1 -0
  879. package/dist/tasks/batching.js +91 -0
  880. package/dist/tasks/context.d.ts +11 -0
  881. package/dist/tasks/context.d.ts.map +1 -0
  882. package/dist/tasks/context.js +181 -0
  883. package/dist/tasks/defineTask.d.ts +37 -0
  884. package/dist/tasks/defineTask.d.ts.map +1 -0
  885. package/dist/tasks/defineTask.js +99 -0
  886. package/dist/tasks/effectGroup.d.ts +19 -0
  887. package/dist/tasks/effectGroup.d.ts.map +1 -0
  888. package/dist/tasks/effectGroup.js +58 -0
  889. package/dist/tasks/grouping.d.ts +19 -0
  890. package/dist/tasks/grouping.d.ts.map +1 -0
  891. package/dist/tasks/grouping.js +54 -0
  892. package/dist/tasks/index.d.ts +9 -0
  893. package/dist/tasks/index.d.ts.map +1 -0
  894. package/dist/tasks/index.js +24 -0
  895. package/dist/tasks/kinds/index.d.ts +7 -0
  896. package/dist/tasks/kinds/index.d.ts.map +1 -0
  897. package/dist/tasks/kinds/index.js +162 -0
  898. package/dist/tasks/kinds/resolvers.d.ts +21 -0
  899. package/dist/tasks/kinds/resolvers.d.ts.map +1 -0
  900. package/dist/tasks/kinds/resolvers.js +124 -0
  901. package/dist/tasks/partitioning.d.ts +11 -0
  902. package/dist/tasks/partitioning.d.ts.map +1 -0
  903. package/dist/tasks/partitioning.js +20 -0
  904. package/dist/tasks/registry.d.ts +53 -0
  905. package/dist/tasks/registry.d.ts.map +1 -0
  906. package/dist/tasks/registry.js +147 -0
  907. package/dist/tasks/serializer.d.ts +62 -0
  908. package/dist/tasks/serializer.d.ts.map +1 -0
  909. package/dist/tasks/serializer.js +197 -0
  910. package/dist/tasks/types.d.ts +180 -0
  911. package/dist/tasks/types.d.ts.map +1 -0
  912. package/dist/tasks/types.js +2 -0
  913. package/dist/test-fixtures/kinds/index.d.ts +56 -0
  914. package/dist/test-fixtures/kinds/index.d.ts.map +1 -0
  915. package/dist/test-fixtures/kinds/index.js +44 -0
  916. package/dist/testing/deterministic.d.ts +62 -0
  917. package/dist/testing/deterministic.d.ts.map +1 -0
  918. package/dist/testing/deterministic.js +193 -0
  919. package/dist/testing/deterministicProviders.d.ts +32 -0
  920. package/dist/testing/deterministicProviders.d.ts.map +1 -0
  921. package/dist/testing/deterministicProviders.js +263 -0
  922. package/dist/testing/index.d.ts +4 -0
  923. package/dist/testing/index.d.ts.map +1 -0
  924. package/dist/testing/index.js +23 -0
  925. package/dist/testing/runHarness.d.ts +64 -0
  926. package/dist/testing/runHarness.d.ts.map +1 -0
  927. package/dist/testing/runHarness.js +165 -0
  928. package/dist/testing/snapshots.d.ts +17 -0
  929. package/dist/testing/snapshots.d.ts.map +1 -0
  930. package/dist/testing/snapshots.js +24 -0
  931. package/dist/utils/ancestorWalk.d.ts +14 -0
  932. package/dist/utils/ancestorWalk.d.ts.map +1 -0
  933. package/dist/utils/ancestorWalk.js +203 -0
  934. package/dist/utils/compressContext.d.ts +50 -0
  935. package/dist/utils/compressContext.d.ts.map +1 -0
  936. package/dist/utils/compressContext.js +180 -0
  937. package/dist/utils/processLiveness.d.ts +9 -0
  938. package/dist/utils/processLiveness.d.ts.map +1 -0
  939. package/dist/utils/processLiveness.js +36 -0
  940. package/dist/utils/sessionMarker.d.ts +17 -0
  941. package/dist/utils/sessionMarker.d.ts.map +1 -0
  942. package/dist/utils/sessionMarker.js +218 -0
  943. package/package.json +4 -4
@@ -0,0 +1,106 @@
1
+ ## Process Creation Guidelines and methodologies
2
+
3
+ - When building UX and full stack applications, integrate/link the main pages
4
+ of the frontend with functionality created for every phase of the development
5
+ process (where relevant), so that there is a way to test the functionality as
6
+ you go.
7
+
8
+ - Unless otherwise specified, prefer quality gated iterative development loops
9
+ in the process.
10
+
11
+ - You can change the process after the run is created or during the run (and
12
+ adapt the process accordingly and journal accordingly) in case you discover new
13
+ information or requirements.
14
+
15
+ - The process should be a comprehensive and complete solution to the user
16
+ request.
17
+
18
+ - The process should usually be a composition (in code) of multiple processes
19
+ from the process library (not just one), for multiple phases and parts of the
20
+ process, each utilizing a different process from the library as a reference.
21
+
22
+ - Include verification and refinement steps (and loops) for planning phases and
23
+ integration phases, debugging phases, refactoring phases, etc.
24
+
25
+ - Create the process with (and around) the available skills and subagents.
26
+ (check which are available first and use discover to find them)
27
+
28
+ - Prefer incremental work that allows testing and experimentation with the new
29
+ functionality as you go.
30
+
31
+ ### Process File Discovery Markers
32
+
33
+ When creating process files, include `@skill` and `@agent` markers in the JSDoc
34
+ header listing the skills and agents relevant to this process. The SDK reads
35
+ these markers to provide targeted discovery results instead of scanning all
36
+ available skills.
37
+
38
+ **Format** (one per line, path relative to the active process-library root):
39
+ ```javascript
40
+ /**
41
+ * @process specializations/web-development/react-app-development
42
+ * @description React app development with TDD
43
+ * @skill frontend-design specializations/web-development/skills/frontend-design/SKILL.md
44
+ * @agent frontend-architect specializations/web-development/agents/frontend-architect/AGENT.md
45
+ */
46
+ ```
47
+
48
+ **Steps during process creation:**
49
+ 1. Use `babysitter skill:discover --process-path <path> --json` to find
50
+ relevant skills/agents in the specialization directory
51
+ 2. Select the ones actually needed by the process tasks
52
+ 3. Add them as `@skill`/`@agent` markers in the JSDoc header
53
+ 4. Use full relative path from the active process-library root returned in
54
+ `binding.dir` by `babysitter process-library:active --json`
55
+
56
+ - Unless otherwise specified, prefer processes that close the widest loop in the
57
+ quality gates (for example e2e tests with a full browser or emulator/vm if it
58
+ is a mobile or desktop app) AND gates that make sure the work is accurate
59
+ against the user request (all the specs are covered and no extra stuff was
60
+ added unless permitted by the intent of the user).
61
+
62
+ - Scan the methodologies and processes in the active process library and the SDK
63
+ package to find relevant processes and methodologies to use as a reference.
64
+ This search is mandatory before writing the process.
65
+
66
+ - If you encounter a generic reusable part of a process that can be later reused
67
+ and composed, build it in a modular way and organize it in the `.a5c/processes`
68
+ directory.
69
+
70
+ Prefer processes that have the following characteristics unless otherwise
71
+ specified:
72
+ - In case of a new project, plan the architecture, stack, parts, milestones
73
+ - In case of an existing project, analyze the architecture, stack, relevant
74
+ parts, milestones, and plan the changes
75
+ - In case of modifying existing code (brownfield), trace the runtime call path
76
+ from user-facing entry points through to final output before planning changes;
77
+ record traced paths as `runtimeCallPaths` in the planning output; only modify
78
+ files that are actually on the live execution path (see ADVANCED_PATTERNS.md
79
+ Pattern 9 for the full pattern)
80
+ - Integrate/link the main pages (or entry points) with functionality created
81
+ for every phase of the development process
82
+ - Quality gated iterative and convergent development/refinement loops
83
+ - Test driven -- where quality gates use `kind: 'shell'` tasks with
84
+ `expectedExitCode` for deterministic verification (compilation, linting,
85
+ test suites, grep checks, dependency availability, runtime smoke tests).
86
+ Reserve `kind: 'agent'` for subjective assessment only (code review,
87
+ architecture evaluation, UX quality)
88
+ - Integration phases for each new functionality in every milestone
89
+ - Where relevant -- beautiful and polished UX with pixel-perfect verification
90
+ - Accurate and complete implementation of the user request
91
+ - Closing quality feedback loops as comprehensively as practical
92
+ - Search for processes, skills, agents, methodologies during the interactive
93
+ process building phase to compose a comprehensive process:
94
+ - `.a5c/processes/` (project level processes)
95
+ - `specializations/` under the active process-library root
96
+ - `methodologies/` under the active process-library root
97
+ - **Drift-resistant prompt composition** (issue #129). In multi-phase
98
+ processes, never paraphrase spec text into agent-task prompt literals.
99
+ Read specs at run time via `kind: 'shell'` `cat` tasks and interpolate
100
+ stdout verbatim into downstream prompts -- this keeps spec bytes out of
101
+ the authoring compose pass where proximity bias rewrites criteria to
102
+ match recently-built implementation. Order test-authoring phases *before*
103
+ implementation phases so the tests become frozen inputs rather than a
104
+ post-hoc rationalization of what got built. See the "Drift-resistant
105
+ prompt composition" section of the process creation guidance for the
106
+ full pattern and examples.
@@ -0,0 +1,46 @@
1
+ ## Quick Commands Reference
2
+
3
+ **Create run (with session binding):**
4
+ ```bash
5
+ $CLI run:create --process-id <id> --entry <path>#<export> --inputs <file> \
6
+ --prompt "$PROMPT" --harness {{harness}}{{bindingFlags}} [--non-interactive] --json
7
+ ```
8
+
9
+ `--harness` binds the run to the current session via the **PID-scoped session
10
+ marker** (authoritative) written by the session-start hook. The harness env
11
+ file and `AGENT_SESSION_ID` env var are only consulted as fallbacks, so
12
+ runs stay bound to the correct session even when env vars are stale or
13
+ inherited across shells. Verify with `babysitter session:whoami --json`.
14
+
15
+ **Check status:**
16
+ ```bash
17
+ $CLI run:status <runId> --json
18
+ ```
19
+
20
+ When the run completes, `run:iterate` and `run:status` emit `completionProof`.
21
+ Use that exact value in a `<promise>...</promise>` tag to end the loop.
22
+
23
+ **View events:**
24
+ ```bash
25
+ $CLI run:events <runId> --limit 20 --reverse
26
+ ```
27
+
28
+ **List tasks:**
29
+ ```bash
30
+ $CLI task:list <runId> --pending --json
31
+ ```
32
+
33
+ **Post task result:**
34
+ ```bash
35
+ $CLI task:post <runId> <effectId> --status <ok|error> --json
36
+ ```
37
+
38
+ **Assign process to bare run:**
39
+ ```bash
40
+ $CLI run:assign-process <runDir> --entry <path>#<export> [--process-id <id>] [--json]
41
+ ```
42
+
43
+ **Iterate:**
44
+ ```bash
45
+ $CLI run:iterate <runId> --json --iteration <n>{{iterateFlags}}
46
+ ```
@@ -0,0 +1,30 @@
1
+ ## Recovery from failure
2
+
3
+ If at any point the run fails due to SDK issues or corrupted state or journal,
4
+ analyze the error and the journal events. Recover the state and journal to the
5
+ last known good state, adapt, and try to continue the run.
6
+
7
+ When recovery requires it, repair the actual process/run artifacts instead of
8
+ only describing the problem. If the process authored a bad loop, impossible
9
+ shell command, or permanently failing effect pattern, edit the process file
10
+ itself. If the run metadata is what is blocking replay, repair the journal
11
+ entries and/or task files/results so the next `run:iterate` can proceed from a
12
+ coherent state.
13
+
14
+ {{#hasNonNegotiables}}
15
+ ### Failure Protocol (required)
16
+
17
+ When blocked or failed, follow this order:
18
+
19
+ 1. Report the concrete blocker and root cause (command/output based, not vague).
20
+ 2. Attempt repair of current run/session/journal first.
21
+ 3. If the blocker is caused by bad process logic or bad recorded effect state,
22
+ modify the process file and/or the relevant journal/task artifacts before
23
+ retrying.
24
+ 4. Present recovery options when strategy changes intent/scope:
25
+ - Option A: continue intent-faithful repair path (recommended)
26
+ - Option B: reduced-scope fallback (requires explicit user approval)
27
+ 5. Do not create a new simplified process without explicit approval if it
28
+ reduces scope or quality expectations.
29
+ 6. Resume orchestration only after the chosen recovery path is explicit.
30
+ {{/hasNonNegotiables}}
@@ -0,0 +1,69 @@
1
+ ### 6. Results Posting
2
+
3
+ **IMPORTANT**: Do NOT write `result.json` directly. The SDK owns that file.
4
+
5
+ **Workflow:**
6
+
7
+ 1. Write the result **value** to a separate file (e.g., `output.json` or
8
+ `value.json`):
9
+ ```json
10
+ {
11
+ "score": 85,
12
+ "details": { ... }
13
+ }
14
+ ```
15
+
16
+ 2. Post the result, either by passing the value file or inline JSON:
17
+ ```bash
18
+ $CLI task:post <runDir> <effectId> \
19
+ --status ok \
20
+ --value tasks/<effectId>/output.json \
21
+ --json
22
+
23
+ $CLI task:post <runDir> <effectId> \
24
+ --status ok \
25
+ --value-inline '{"score": 85}' \
26
+ --json
27
+ ```
28
+
29
+ The `task:post` command will:
30
+ - Read the value from your file or inline JSON
31
+ - Write the complete `result.json` (including schema, metadata, and your value)
32
+ - Append an `EFFECT_RESOLVED` event to the journal
33
+ - Update the state cache
34
+
35
+ **Available flags:**
36
+ - `--status <ok|error>` (required)
37
+ - `--value <file>` - Result value (for status=ok)
38
+ - `--value-inline <json>` - Inline result value JSON (for status=ok, cannot be combined with `--value`)
39
+ - `--error <file>` - Error payload (for status=error)
40
+ - `--stdout-file <file>` - Capture stdout
41
+ - `--stderr-file <file>` - Capture stderr
42
+ - `--started-at <iso8601>` - Task start time
43
+ - `--finished-at <iso8601>` - Task end time
44
+ - `--metadata <file>` - Additional metadata JSON
45
+
46
+ **Common mistake to avoid:**
47
+ ```bash
48
+ # wrong: Writing result.json directly
49
+ echo '{"result": {...}}' > tasks/<effectId>/result.json
50
+ $CLI task:post <runId> <effectId> --status ok
51
+
52
+ # correct: Write value to a separate file or pass inline JSON, then let SDK create result.json
53
+ echo '{"score": 85}' > tasks/<effectId>/output.json
54
+ $CLI task:post <runId> <effectId> --status ok --value tasks/<effectId>/output.json
55
+
56
+ $CLI task:post <runId> <effectId> --status ok --value-inline '{"score": 85}'
57
+ ```
58
+
59
+ **Breakpoint-specific posting:**
60
+
61
+ ```bash
62
+ # Breakpoint approval
63
+ echo '{"approved": true, "response": "User approved"}' > tasks/<effectId>/output.json
64
+ $CLI task:post <runId> <effectId> --status ok --value tasks/<effectId>/output.json
65
+
66
+ # Breakpoint rejection (ALWAYS use --status ok, not --status error)
67
+ echo '{"approved": false, "response": "User rejected"}' > tasks/<effectId>/output.json
68
+ $CLI task:post <runId> <effectId> --status ok --value tasks/<effectId>/output.json
69
+ ```
@@ -0,0 +1,14 @@
1
+ # Root Cause & Guardrail
2
+
3
+ - When diagnosing a failure, keep asking *why* until you reach a cause
4
+ a change can actually fix. A fix that only makes the symptom go away
5
+ leaves the cause live elsewhere.
6
+ - Prefer a small change at the root over a large change at the surface.
7
+ If the surface-level fix is faster, note what the real cause is so it
8
+ can be revisited.
9
+ - When the same bug category has already appeared more than once, add a
10
+ guardrail: a test that reproduces it, a lint/type rule that blocks
11
+ it, or a pre-commit/CI check. A guardrail that would not catch the
12
+ next occurrence is not worth adding.
13
+ - Do not disable tests, checks, or safety rails to make a run pass.
14
+ Either fix the underlying issue, or stop and surface it.
@@ -0,0 +1,80 @@
1
+ ### 2. Create run and bind session:
2
+
3
+ If an existing bare run is reported in the **Existing Run State** section above,
4
+ use `run:assign-process` (see below) instead of creating a new run.
5
+
6
+ **For new runs:**
7
+
8
+ ```bash
9
+ $CLI run:create \
10
+ --process-id <id> \
11
+ --entry <absolute-path>#<export> \
12
+ --inputs <file> \
13
+ --prompt "$PROMPT" \
14
+ --harness {{harness}} \{{bindingFlagsLine}}
15
+ --json
16
+ ```
17
+
18
+ {{requiredFlagsList}}
19
+
20
+ **Optional flags:**
21
+ - `--inputs <file>` -- path to a JSON file with process inputs
22
+ - `--run-id <id>` -- override auto-generated run ID
23
+ - `--runs-dir <dir>` -- advanced compatibility override for the runs directory (default: `~/.a5c/runs`, or `<repo>/.a5c/runs` when `BABYSITTER_RUNS_SCOPE=repo`)
24
+ - `--non-interactive` -- auto-approve breakpoints without human interaction (yolo mode)
25
+
26
+ {{sessionIdNote}}
27
+
28
+ **Common mistakes to avoid:**
29
+ - wrong: Calling `session:init` explicitly
30
+ - wrong: Fabricating a session ID when none is available from the environment
31
+ {{mistakeHarnessNote}}
32
+
33
+ **For resuming existing runs:**
34
+
35
+ ```bash
36
+ $CLI session:resume \
37
+ --session-id <id> \{{resumeFlagsLine}}
38
+ --run-id <runId> --json
39
+ ```
40
+
41
+ **For assigning a process to an existing bare run:**
42
+
43
+ When the session-start hook has already created a bare run (no `--entry`), use
44
+ `run:assign-process` to attach the process definition, then bind the session:
45
+
46
+ ```bash
47
+ # 1. Assign the process to the bare run
48
+ $CLI run:assign-process <runDir> \
49
+ --entry <absolute-path>#<export> \
50
+ --process-id <id> \
51
+ --json
52
+
53
+ # 2. Bind the session to the run (if not already bound by session-start)
54
+ $CLI session:associate \
55
+ --session-id <id> \
56
+ --run-id <runId> \
57
+ --state-dir <stateDir> \
58
+ --json
59
+ ```
60
+
61
+ **Required arguments:**
62
+ - `<runDir>` — path to the existing run directory (positional)
63
+ - `--entry <path>#<export>` — path to the process JS file and its named export
64
+
65
+ **Optional flags:**
66
+ - `--process-id <id>` — override the process identifier stored in the run (defaults to the existing `processId` from the bare run)
67
+ - `--process-revision <rev>` — pin a specific process revision
68
+ - `--force` — allow re-assigning even if the run already has a process
69
+ - `--dry-run` — validate without writing changes
70
+ - `--json` — emit machine-readable JSON output
71
+ - `--verbose` — log resolved paths and options to stderr
72
+
73
+ This command rejects if the run already has a process assigned unless `--force` is
74
+ passed. On success it updates `run.json` and appends a `PROCESS_ASSIGNED` journal
75
+ event to the run.
76
+
77
+ **Common mistakes to avoid:**
78
+ - wrong: Always creating a new run when a bare run already exists from session-start
79
+ - correct: Check `.a5c/runs/` for existing bare runs and use `run:assign-process`
80
+ - wrong: Skipping `run:assign-process` and calling `run:iterate` on a bare run (will fail)
@@ -0,0 +1,65 @@
1
+ ### 2.0 Run Overlap Detection
2
+
3
+ Before calling `$CLI run:create`, scan for recent runs that may already cover
4
+ the same work. This avoids creating duplicate runs that waste tokens and
5
+ complicate the run history.
6
+
7
+ **Scan procedure:**
8
+
9
+ 1. List recent run directories:
10
+ ```bash
11
+ ls -lt ~/.a5c/runs/ | head -20
12
+ ```
13
+ 2. For each run created within the last 30 minutes, read its metadata:
14
+ ```bash
15
+ cat ~/.a5c/runs/<runId>/run.json
16
+ ```
17
+ 3. Compare the candidate run's `prompt` and `processId` against the new
18
+ request:
19
+ - **Keyword overlap**: does the existing prompt share 3 or more significant
20
+ keywords with the new prompt?
21
+ - **Process match**: does `processId` match the process you intend to use?
22
+ 4. If overlap is detected, check its current status:
23
+ ```bash
24
+ $CLI run:status ~/.a5c/runs/<runId>
25
+ ```
26
+
27
+ **If an overlapping run is found:**
28
+
29
+ {{#interactive}}
30
+ Surface a clear warning to the user with the similar run's details:
31
+
32
+ - Run ID: `<runId>`
33
+ - Process: `<processId>`
34
+ - Created: `<createdAt>`
35
+ - Status: `<status>`
36
+ - Prompt excerpt: `<first 120 chars of prompt>`
37
+
38
+ Ask the user to choose one of:
39
+ 1. **Proceed** — create a new run anyway (e.g., intentional retry or variant)
40
+ 2. **Skip** — abort run creation; the existing run already covers the request
41
+ 3. **Resume** — resume the existing run via `$CLI run:iterate ~/.a5c/runs/<runId>`
42
+
43
+ Do not proceed with `run:create` until the user has responded.
44
+ {{/interactive}}
45
+ {{^interactive}}
46
+ Log a warning with the overlapping run's details (runId, processId, createdAt,
47
+ status) and continue creating the new run. Non-interactive mode does not block
48
+ on overlap — the caller is responsible for deduplication.
49
+ {{/interactive}}
50
+
51
+ **No overlap found:** proceed directly to `$CLI run:create` as normal.
52
+
53
+ If the current repo is still using legacy repo-local runs, the SDK will also read `<repo>/.a5c/runs` automatically for compatibility.
54
+
55
+ **Tracking run chains:**
56
+
57
+ When creating a run that intentionally follows or retries a previous run,
58
+ include the related run ID in the inputs so the process can reference it:
59
+
60
+ ```json
61
+ {
62
+ "relatedRunId": "<previousRunId>",
63
+ "relatedRunReason": "retry|variant|follow-up"
64
+ }
65
+ ```
@@ -0,0 +1,4 @@
1
+ ## See Also
2
+ - `library/tdd-quality-convergence.js` - TDD quality convergence example
3
+ - `library/reference/ADVANCED_PATTERNS.md` - Agent/skill patterns, iterative convergence
4
+ - `library/reference/sdk.md` - SDK API reference
@@ -0,0 +1,229 @@
1
+ ### Agent Task Example
2
+
3
+ Important: Check which subagents and agents are actually available before
4
+ assigning the name. If none, pass the general-purpose subagent. Check the
5
+ subagents and agents in the plugin (in nested folders) and to find relevant
6
+ subagents and agents to use as a reference. Specifically check subagents and
7
+ agents in folders next to the reference process file.
8
+
9
+ When executing the agent task, use the Task tool. Never use the Babysitter skill
10
+ or agent to execute the task.
11
+ When the Task tool or delegated worker accepts a timeout, use a generous budget
12
+ for real coding or verification work instead of a short default.
13
+
14
+ ```javascript
15
+ export const agentTask = defineTask('agent-scorer', (args, taskCtx) => ({
16
+ kind: 'agent',
17
+ title: 'Agent scoring',
18
+ agent: {
19
+ name: 'quality-scorer',
20
+ prompt: {
21
+ role: 'QA engineer',
22
+ task: 'Score results 0-100',
23
+ context: { ...args },
24
+ instructions: ['Review', 'Score', 'Recommend'],
25
+ outputFormat: 'JSON'
26
+ },
27
+ outputSchema: {
28
+ type: 'object',
29
+ required: ['score']
30
+ }
31
+ },
32
+
33
+ io: {
34
+ inputJsonPath: `tasks/${taskCtx.effectId}/inputs.json`,
35
+ outputJsonPath: `tasks/${taskCtx.effectId}/output.json`
36
+ }
37
+ }));
38
+ ```
39
+
40
+ ### Shell Verification Task Example
41
+
42
+ Use shell tasks for all deterministic verification gates. Shell tasks produce
43
+ binary pass/fail results via exit codes that cannot be bypassed by agent
44
+ reasoning.
45
+
46
+ ```javascript
47
+ // Grep-based integration check
48
+ export const grepCheckTask = defineTask('grep-integration-check', (args, taskCtx) => ({
49
+ kind: 'shell',
50
+ title: 'Verify integration points exist',
51
+ shell: {
52
+ command: `cd ${args.projectDir || '.'} && grep -q "${args.pattern}" ${args.file}`,
53
+ expectedExitCode: 0,
54
+ timeout: 10000
55
+ },
56
+ io: {
57
+ inputJsonPath: `tasks/${taskCtx.effectId}/inputs.json`,
58
+ outputJsonPath: `tasks/${taskCtx.effectId}/output.json`
59
+ }
60
+ }));
61
+
62
+ // Multi-check verification gate
63
+ export const verificationGateTask = defineTask('verification-gate', (args, taskCtx) => ({
64
+ kind: 'shell',
65
+ title: 'Deterministic verification gate',
66
+ shell: {
67
+ command: [
68
+ `cd ${args.projectDir || '.'}`,
69
+ 'npx tsc --noEmit',
70
+ 'npx eslint src/ --max-warnings=0',
71
+ 'npx vitest run --reporter=verbose'
72
+ ].join(' && '),
73
+ expectedExitCode: 0,
74
+ timeout: 300000
75
+ },
76
+ io: {
77
+ inputJsonPath: `tasks/${taskCtx.effectId}/inputs.json`,
78
+ outputJsonPath: `tasks/${taskCtx.effectId}/output.json`
79
+ }
80
+ }));
81
+ ```
82
+
83
+ Use `library/processes/shared/deterministic-quality-gate.js` for composable
84
+ preset gates (createGrepCheck, createCompilationGate, createTestSuiteGate,
85
+ createRuntimeSmokeTest).
86
+
87
+ ### Runtime Spec Read + Agent Prompt Example (drift defense, issue #129)
88
+
89
+ Pair a `kind: 'shell'` `cat` task with a `kind: 'agent'` task so the spec
90
+ bytes are pulled from disk at execution time and interpolated verbatim into
91
+ the agent prompt. This keeps spec text out of the process-authoring compose
92
+ pass, where token proximity bias would otherwise rewrite acceptance criteria
93
+ to match recently-built implementation artifacts.
94
+
95
+ ```javascript
96
+ // Phase 1: read the spec at execution time (bytes bypass your compose pass).
97
+ export const readSpecTask = defineTask('read-spec', (args, taskCtx) => ({
98
+ kind: 'shell',
99
+ title: `Read spec ${args.specPath}`,
100
+ shell: {
101
+ command: `cat ${args.specPath}`,
102
+ expectedExitCode: 0,
103
+ timeout: 5000,
104
+ },
105
+ io: {
106
+ inputJsonPath: `tasks/${taskCtx.effectId}/inputs.json`,
107
+ outputJsonPath: `tasks/${taskCtx.effectId}/output.json`,
108
+ },
109
+ }));
110
+
111
+ // Phase 2: test-authoring agent -- prompt interpolates spec.stdout verbatim,
112
+ // and the prompt explicitly forbids reading implementation files. Author
113
+ // tests strictly from the spec. Place this phase BEFORE any implementation
114
+ // phase so tests are frozen inputs, not post-hoc rationalizations.
115
+ export const authorTestsFromSpecTask = defineTask(
116
+ 'author-tests-from-spec',
117
+ (args, taskCtx) => ({
118
+ kind: 'agent',
119
+ title: 'Author tests from spec (no implementation access)',
120
+ agent: {
121
+ name: 'general-purpose',
122
+ prompt: {
123
+ role: 'Test author',
124
+ task: 'Author tests that exercise every acceptance criterion below.',
125
+ context: {
126
+ specVerbatim: args.specStdout, // from readSpecTask.stdout
127
+ testFilePath: args.testFilePath,
128
+ },
129
+ instructions: [
130
+ 'Treat the SPEC block below as the sole source of truth.',
131
+ 'Do not read files under src/ or implementation directories.',
132
+ 'Cite spec line numbers in each test name.',
133
+ 'If a criterion is impossible to test as written, raise a',
134
+ ' breakpoint -- do not rewrite the criterion.',
135
+ '',
136
+ 'SPEC (verbatim, do not paraphrase):',
137
+ '---',
138
+ args.specStdout,
139
+ '---',
140
+ ],
141
+ },
142
+ },
143
+ io: {
144
+ inputJsonPath: `tasks/${taskCtx.effectId}/inputs.json`,
145
+ outputJsonPath: `tasks/${taskCtx.effectId}/output.json`,
146
+ },
147
+ }),
148
+ );
149
+
150
+ // Phase N: verification agent -- re-read spec AND artifacts fresh via cat/
151
+ // git show, interpolate both verbatim, and end with a direct compare
152
+ // instruction. Recency anchors the verifier's attention on source-of-truth
153
+ // rather than accumulated narrative drift.
154
+ export const verifyAgainstSpecTask = defineTask(
155
+ 'verify-against-spec',
156
+ (args, taskCtx) => ({
157
+ kind: 'agent',
158
+ title: 'Spec-vs-artifact verification (recency-anchored)',
159
+ agent: {
160
+ name: 'general-purpose',
161
+ prompt: {
162
+ role: 'Acceptance reviewer',
163
+ task: 'Compare SPEC to ARTIFACTS directly. Report per-criterion pass/fail.',
164
+ instructions: [
165
+ 'Ignore any narrative in your context about how ARTIFACTS were built.',
166
+ 'Do not summarize either block -- compare line by line.',
167
+ '',
168
+ 'SPEC (verbatim):',
169
+ '---',
170
+ args.specStdout,
171
+ '---',
172
+ '',
173
+ 'ARTIFACTS (verbatim):',
174
+ '---',
175
+ args.artifactsStdout,
176
+ '---',
177
+ ],
178
+ },
179
+ },
180
+ io: {
181
+ inputJsonPath: `tasks/${taskCtx.effectId}/inputs.json`,
182
+ outputJsonPath: `tasks/${taskCtx.effectId}/output.json`,
183
+ },
184
+ }),
185
+ );
186
+ ```
187
+
188
+ The spec source can be any file -- markdown specs under `specs/`, issue body
189
+ dumps written to `/tmp/`, `bd show <id> > /tmp/spec.md`, etc. The pattern is
190
+ orthogonal to the spec-tracking tool; what matters is that the bytes are read
191
+ at execution time, not authored into the process file as a string literal.
192
+
193
+ ### Skill Task Example
194
+
195
+ Important: Check which skills are actually available before assigning the skill
196
+ name. Check the skills in the plugin (in nested folders) and to find relevant
197
+ skills to use as a reference. Skills are preferred over subagents for executing
198
+ tasks.
199
+ When delegating the skill execution, use a generous timeout budget and require
200
+ the skill to execute the work and return the real result.
201
+
202
+ ```javascript
203
+ export const skillTask = defineTask('analyzer-skill', (args, taskCtx) => ({
204
+ kind: 'skill',
205
+ title: 'Analyze codebase',
206
+
207
+ skill: {
208
+ name: 'codebase-analyzer',
209
+ context: {
210
+ scope: args.scope,
211
+ depth: args.depth,
212
+ analysisType: args.type,
213
+ criteria: ['Code consistency', 'Naming conventions', 'Error handling'],
214
+ instructions: [
215
+ 'Scan specified paths for code patterns',
216
+ 'Analyze consistency across the codebase',
217
+ 'Check naming conventions',
218
+ 'Review error handling patterns',
219
+ 'Generate structured analysis report'
220
+ ]
221
+ }
222
+ },
223
+
224
+ io: {
225
+ inputJsonPath: `tasks/${taskCtx.effectId}/inputs.json`,
226
+ outputJsonPath: `tasks/${taskCtx.effectId}/output.json`
227
+ }
228
+ }));
229
+ ```