@cleocode/core 2026.6.12 → 2026.6.14

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 (730) hide show
  1. package/dist/admin/ops.d.ts +4 -0
  2. package/dist/admin/ops.d.ts.map +1 -1
  3. package/dist/check/index.d.ts +12 -0
  4. package/dist/check/index.d.ts.map +1 -0
  5. package/dist/check/index.js +12 -0
  6. package/dist/check/index.js.map +1 -0
  7. package/dist/check/pr-gate.d.ts +179 -0
  8. package/dist/check/pr-gate.d.ts.map +1 -0
  9. package/dist/check/pr-gate.js +366 -0
  10. package/dist/check/pr-gate.js.map +1 -0
  11. package/dist/conduit/delivery-router.d.ts +134 -0
  12. package/dist/conduit/delivery-router.d.ts.map +1 -0
  13. package/dist/conduit/delivery-router.js +0 -0
  14. package/dist/conduit/delivery-router.js.map +1 -0
  15. package/dist/conduit/index.d.ts +5 -2
  16. package/dist/conduit/index.d.ts.map +1 -1
  17. package/dist/conduit/index.js +5 -2
  18. package/dist/conduit/index.js.map +1 -1
  19. package/dist/conduit/local-transport.d.ts +12 -0
  20. package/dist/conduit/local-transport.d.ts.map +1 -1
  21. package/dist/conduit/local-transport.js +53 -23
  22. package/dist/conduit/local-transport.js.map +1 -1
  23. package/dist/conduit/local-tui-adapter.d.ts +89 -0
  24. package/dist/conduit/local-tui-adapter.d.ts.map +1 -0
  25. package/dist/conduit/local-tui-adapter.js +225 -0
  26. package/dist/conduit/local-tui-adapter.js.map +1 -0
  27. package/dist/config/registry.d.ts +54 -0
  28. package/dist/config/registry.d.ts.map +1 -1
  29. package/dist/config/registry.js +94 -2
  30. package/dist/config/registry.js.map +1 -1
  31. package/dist/crypto/credentials.d.ts +37 -0
  32. package/dist/crypto/credentials.d.ts.map +1 -1
  33. package/dist/crypto/credentials.js +110 -0
  34. package/dist/crypto/credentials.js.map +1 -1
  35. package/dist/deriver/queue-manager.d.ts +30 -2
  36. package/dist/deriver/queue-manager.d.ts.map +1 -1
  37. package/dist/deriver/queue-manager.js +54 -9
  38. package/dist/deriver/queue-manager.js.map +1 -1
  39. package/dist/dispatch/config-domain-handler.d.ts +125 -0
  40. package/dist/dispatch/config-domain-handler.d.ts.map +1 -0
  41. package/dist/dispatch/config-domain-handler.js +160 -0
  42. package/dist/dispatch/config-domain-handler.js.map +1 -0
  43. package/dist/dispatch/contracts/derive-output-contract.d.ts +86 -0
  44. package/dist/dispatch/contracts/derive-output-contract.d.ts.map +1 -0
  45. package/dist/dispatch/contracts/derive-output-contract.js +347 -0
  46. package/dist/dispatch/contracts/derive-output-contract.js.map +1 -0
  47. package/dist/dispatch/contracts/ensures-schema.d.ts +77 -0
  48. package/dist/dispatch/contracts/ensures-schema.d.ts.map +1 -0
  49. package/dist/dispatch/contracts/ensures-schema.js +91 -0
  50. package/dist/dispatch/contracts/ensures-schema.js.map +1 -0
  51. package/dist/dispatch/contracts/input-contracts.d.ts.map +1 -1
  52. package/dist/dispatch/contracts/input-contracts.js +19 -1
  53. package/dist/dispatch/contracts/input-contracts.js.map +1 -1
  54. package/dist/dispatch/contracts/output-contracts.d.ts +27 -5
  55. package/dist/dispatch/contracts/output-contracts.d.ts.map +1 -1
  56. package/dist/dispatch/contracts/output-contracts.js +29 -6
  57. package/dist/dispatch/contracts/output-contracts.js.map +1 -1
  58. package/dist/docs/export-document.js +5413 -1345
  59. package/dist/docs/export-document.js.map +3 -3
  60. package/dist/gateway-client/client.d.ts +123 -0
  61. package/dist/gateway-client/client.d.ts.map +1 -0
  62. package/dist/gateway-client/client.js +93 -0
  63. package/dist/gateway-client/client.js.map +1 -0
  64. package/dist/gateway-client/generated/client/client.gen.d.ts +3 -0
  65. package/dist/gateway-client/generated/client/client.gen.d.ts.map +1 -0
  66. package/dist/gateway-client/generated/client/client.gen.js +217 -0
  67. package/dist/gateway-client/generated/client/client.gen.js.map +1 -0
  68. package/dist/gateway-client/generated/client/index.d.ts +11 -0
  69. package/dist/gateway-client/generated/client/index.d.ts.map +1 -0
  70. package/dist/gateway-client/generated/client/index.js +7 -0
  71. package/dist/gateway-client/generated/client/index.js.map +1 -0
  72. package/dist/gateway-client/generated/client/types.gen.d.ts +121 -0
  73. package/dist/gateway-client/generated/client/types.gen.d.ts.map +1 -0
  74. package/dist/gateway-client/generated/client/types.gen.js +3 -0
  75. package/dist/gateway-client/generated/client/types.gen.js.map +1 -0
  76. package/dist/gateway-client/generated/client/utils.gen.d.ts +38 -0
  77. package/dist/gateway-client/generated/client/utils.gen.d.ts.map +1 -0
  78. package/dist/gateway-client/generated/client/utils.gen.js +229 -0
  79. package/dist/gateway-client/generated/client/utils.gen.js.map +1 -0
  80. package/dist/gateway-client/generated/client.gen.d.ts +13 -0
  81. package/dist/gateway-client/generated/client.gen.d.ts.map +1 -0
  82. package/dist/gateway-client/generated/client.gen.js +4 -0
  83. package/dist/gateway-client/generated/client.gen.js.map +1 -0
  84. package/dist/gateway-client/generated/core/auth.gen.d.ts +26 -0
  85. package/dist/gateway-client/generated/core/auth.gen.d.ts.map +1 -0
  86. package/dist/gateway-client/generated/core/auth.gen.js +15 -0
  87. package/dist/gateway-client/generated/core/auth.gen.js.map +1 -0
  88. package/dist/gateway-client/generated/core/bodySerializer.gen.d.ts +26 -0
  89. package/dist/gateway-client/generated/core/bodySerializer.gen.d.ts.map +1 -0
  90. package/dist/gateway-client/generated/core/bodySerializer.gen.js +58 -0
  91. package/dist/gateway-client/generated/core/bodySerializer.gen.js.map +1 -0
  92. package/dist/gateway-client/generated/core/params.gen.d.ts +44 -0
  93. package/dist/gateway-client/generated/core/params.gen.d.ts.map +1 -0
  94. package/dist/gateway-client/generated/core/params.gen.js +101 -0
  95. package/dist/gateway-client/generated/core/params.gen.js.map +1 -0
  96. package/dist/gateway-client/generated/core/pathSerializer.gen.d.ts +34 -0
  97. package/dist/gateway-client/generated/core/pathSerializer.gen.d.ts.map +1 -0
  98. package/dist/gateway-client/generated/core/pathSerializer.gen.js +107 -0
  99. package/dist/gateway-client/generated/core/pathSerializer.gen.js.map +1 -0
  100. package/dist/gateway-client/generated/core/queryKeySerializer.gen.d.ts +19 -0
  101. package/dist/gateway-client/generated/core/queryKeySerializer.gen.d.ts.map +1 -0
  102. package/dist/gateway-client/generated/core/queryKeySerializer.gen.js +93 -0
  103. package/dist/gateway-client/generated/core/queryKeySerializer.gen.js.map +1 -0
  104. package/dist/gateway-client/generated/core/serverSentEvents.gen.d.ts +72 -0
  105. package/dist/gateway-client/generated/core/serverSentEvents.gen.d.ts.map +1 -0
  106. package/dist/gateway-client/generated/core/serverSentEvents.gen.js +133 -0
  107. package/dist/gateway-client/generated/core/serverSentEvents.gen.js.map +1 -0
  108. package/dist/gateway-client/generated/core/types.gen.d.ts +84 -0
  109. package/dist/gateway-client/generated/core/types.gen.d.ts.map +1 -0
  110. package/dist/gateway-client/generated/core/types.gen.js +3 -0
  111. package/dist/gateway-client/generated/core/types.gen.js.map +1 -0
  112. package/dist/gateway-client/generated/core/utils.gen.d.ts +20 -0
  113. package/dist/gateway-client/generated/core/utils.gen.d.ts.map +1 -0
  114. package/dist/gateway-client/generated/core/utils.gen.js +88 -0
  115. package/dist/gateway-client/generated/core/utils.gen.js.map +1 -0
  116. package/dist/gateway-client/generated/index.d.ts +3 -0
  117. package/dist/gateway-client/generated/index.d.ts.map +1 -0
  118. package/dist/gateway-client/generated/index.js +3 -0
  119. package/dist/gateway-client/generated/index.js.map +1 -0
  120. package/dist/gateway-client/generated/namespaces.gen.d.ts +512 -0
  121. package/dist/gateway-client/generated/namespaces.gen.d.ts.map +1 -0
  122. package/dist/gateway-client/generated/namespaces.gen.js +521 -0
  123. package/dist/gateway-client/generated/namespaces.gen.js.map +1 -0
  124. package/dist/gateway-client/generated/sdk.gen.d.ts +1780 -0
  125. package/dist/gateway-client/generated/sdk.gen.d.ts.map +1 -0
  126. package/dist/gateway-client/generated/sdk.gen.js +3811 -0
  127. package/dist/gateway-client/generated/sdk.gen.js.map +1 -0
  128. package/dist/gateway-client/generated/types.gen.d.ts +14681 -0
  129. package/dist/gateway-client/generated/types.gen.d.ts.map +1 -0
  130. package/dist/gateway-client/generated/types.gen.js +3 -0
  131. package/dist/gateway-client/generated/types.gen.js.map +1 -0
  132. package/dist/gateway-client/index.d.ts +27 -0
  133. package/dist/gateway-client/index.d.ts.map +1 -0
  134. package/dist/gateway-client/index.js +25 -0
  135. package/dist/gateway-client/index.js.map +1 -0
  136. package/dist/go/driver.d.ts +132 -7
  137. package/dist/go/driver.d.ts.map +1 -1
  138. package/dist/go/driver.js +135 -10
  139. package/dist/go/driver.js.map +1 -1
  140. package/dist/go/index.d.ts +1 -1
  141. package/dist/go/index.d.ts.map +1 -1
  142. package/dist/go/index.js +1 -1
  143. package/dist/go/index.js.map +1 -1
  144. package/dist/index.d.ts +11 -0
  145. package/dist/index.d.ts.map +1 -1
  146. package/dist/index.js +25 -0
  147. package/dist/index.js.map +1 -1
  148. package/dist/init.d.ts.map +1 -1
  149. package/dist/init.js +28 -0
  150. package/dist/init.js.map +1 -1
  151. package/dist/internal.d.ts +23 -11
  152. package/dist/internal.d.ts.map +1 -1
  153. package/dist/internal.js +29 -12
  154. package/dist/internal.js.map +1 -1
  155. package/dist/lifecycle/engine-ops.d.ts.map +1 -1
  156. package/dist/lifecycle/engine-ops.js +7 -4
  157. package/dist/lifecycle/engine-ops.js.map +1 -1
  158. package/dist/lifecycle/ivtr-loop.d.ts +108 -183
  159. package/dist/lifecycle/ivtr-loop.d.ts.map +1 -1
  160. package/dist/lifecycle/ivtr-loop.js +207 -522
  161. package/dist/lifecycle/ivtr-loop.js.map +1 -1
  162. package/dist/llm/auxiliary-fallback.js +1 -1
  163. package/dist/llm/auxiliary-fallback.js.map +1 -1
  164. package/dist/llm/catalog-model-resolver.d.ts +19 -0
  165. package/dist/llm/catalog-model-resolver.d.ts.map +1 -1
  166. package/dist/llm/catalog-model-resolver.js +36 -0
  167. package/dist/llm/catalog-model-resolver.js.map +1 -1
  168. package/dist/llm/catalog-resolver.d.ts +112 -0
  169. package/dist/llm/catalog-resolver.d.ts.map +1 -0
  170. package/dist/llm/catalog-resolver.js +207 -0
  171. package/dist/llm/catalog-resolver.js.map +1 -0
  172. package/dist/llm/catalog-seeder.d.ts +96 -0
  173. package/dist/llm/catalog-seeder.d.ts.map +1 -0
  174. package/dist/llm/catalog-seeder.js +189 -0
  175. package/dist/llm/catalog-seeder.js.map +1 -0
  176. package/dist/llm/cli-ops.d.ts +14 -1
  177. package/dist/llm/cli-ops.d.ts.map +1 -1
  178. package/dist/llm/cli-ops.js +46 -17
  179. package/dist/llm/cli-ops.js.map +1 -1
  180. package/dist/llm/complexity-classifier.d.ts +208 -0
  181. package/dist/llm/complexity-classifier.d.ts.map +1 -0
  182. package/dist/llm/complexity-classifier.js +359 -0
  183. package/dist/llm/complexity-classifier.js.map +1 -0
  184. package/dist/llm/concrete-session.d.ts.map +1 -1
  185. package/dist/llm/concrete-session.js +4 -0
  186. package/dist/llm/concrete-session.js.map +1 -1
  187. package/dist/llm/credential-pool.d.ts +2 -0
  188. package/dist/llm/credential-pool.d.ts.map +1 -1
  189. package/dist/llm/credential-pool.js +5 -2
  190. package/dist/llm/credential-pool.js.map +1 -1
  191. package/dist/llm/credentials-store.d.ts +10 -14
  192. package/dist/llm/credentials-store.d.ts.map +1 -1
  193. package/dist/llm/credentials-store.js.map +1 -1
  194. package/dist/llm/credentials.d.ts +35 -0
  195. package/dist/llm/credentials.d.ts.map +1 -1
  196. package/dist/llm/credentials.js +49 -0
  197. package/dist/llm/credentials.js.map +1 -1
  198. package/dist/llm/entity-ops.d.ts +299 -0
  199. package/dist/llm/entity-ops.d.ts.map +1 -0
  200. package/dist/llm/entity-ops.js +441 -0
  201. package/dist/llm/entity-ops.js.map +1 -0
  202. package/dist/llm/index.d.ts +19 -0
  203. package/dist/llm/index.d.ts.map +1 -1
  204. package/dist/llm/index.js +12 -0
  205. package/dist/llm/index.js.map +1 -1
  206. package/dist/llm/llm-queue-admit.d.ts +118 -0
  207. package/dist/llm/llm-queue-admit.d.ts.map +1 -0
  208. package/dist/llm/llm-queue-admit.js +275 -0
  209. package/dist/llm/llm-queue-admit.js.map +1 -0
  210. package/dist/llm/oauth/device-code.d.ts.map +1 -1
  211. package/dist/llm/oauth/device-code.js +2 -8
  212. package/dist/llm/oauth/device-code.js.map +1 -1
  213. package/dist/llm/oauth/google-pkce.d.ts.map +1 -1
  214. package/dist/llm/oauth/google-pkce.js +2 -18
  215. package/dist/llm/oauth/google-pkce.js.map +1 -1
  216. package/dist/llm/oauth/pkce.d.ts +70 -0
  217. package/dist/llm/oauth/pkce.d.ts.map +1 -1
  218. package/dist/llm/oauth/pkce.js +106 -29
  219. package/dist/llm/oauth/pkce.js.map +1 -1
  220. package/dist/llm/onboarding/front-door.d.ts +146 -0
  221. package/dist/llm/onboarding/front-door.d.ts.map +1 -0
  222. package/dist/llm/onboarding/front-door.js +153 -0
  223. package/dist/llm/onboarding/front-door.js.map +1 -0
  224. package/dist/llm/onboarding/login-engine.d.ts +175 -0
  225. package/dist/llm/onboarding/login-engine.d.ts.map +1 -0
  226. package/dist/llm/onboarding/login-engine.js +286 -0
  227. package/dist/llm/onboarding/login-engine.js.map +1 -0
  228. package/dist/llm/pi/gondolin-loader.d.ts +241 -0
  229. package/dist/llm/pi/gondolin-loader.d.ts.map +1 -0
  230. package/dist/llm/pi/gondolin-loader.js +195 -0
  231. package/dist/llm/pi/gondolin-loader.js.map +1 -0
  232. package/dist/llm/pi/index.d.ts +28 -0
  233. package/dist/llm/pi/index.d.ts.map +1 -0
  234. package/dist/llm/pi/index.js +27 -0
  235. package/dist/llm/pi/index.js.map +1 -0
  236. package/dist/llm/pi/pi-agent-adapter.d.ts +135 -0
  237. package/dist/llm/pi/pi-agent-adapter.d.ts.map +1 -0
  238. package/dist/llm/pi/pi-agent-adapter.js +329 -0
  239. package/dist/llm/pi/pi-agent-adapter.js.map +1 -0
  240. package/dist/llm/pi/pi-errors.d.ts +161 -0
  241. package/dist/llm/pi/pi-errors.d.ts.map +1 -0
  242. package/dist/llm/pi/pi-errors.js +296 -0
  243. package/dist/llm/pi/pi-errors.js.map +1 -0
  244. package/dist/llm/pi/pi-execution-env.d.ts +286 -0
  245. package/dist/llm/pi/pi-execution-env.d.ts.map +1 -0
  246. package/dist/llm/pi/pi-execution-env.js +406 -0
  247. package/dist/llm/pi/pi-execution-env.js.map +1 -0
  248. package/dist/llm/pi/pi-gondolin-env.d.ts +250 -0
  249. package/dist/llm/pi/pi-gondolin-env.d.ts.map +1 -0
  250. package/dist/llm/pi/pi-gondolin-env.js +541 -0
  251. package/dist/llm/pi/pi-gondolin-env.js.map +1 -0
  252. package/dist/llm/pi/pi-session-storage.d.ts +154 -0
  253. package/dist/llm/pi/pi-session-storage.d.ts.map +1 -0
  254. package/dist/llm/pi/pi-session-storage.js +314 -0
  255. package/dist/llm/pi/pi-session-storage.js.map +1 -0
  256. package/dist/llm/pi/pi-stream-fn.d.ts +124 -0
  257. package/dist/llm/pi/pi-stream-fn.d.ts.map +1 -0
  258. package/dist/llm/pi/pi-stream-fn.js +504 -0
  259. package/dist/llm/pi/pi-stream-fn.js.map +1 -0
  260. package/dist/llm/pi/pi-tool-bridge.d.ts +99 -0
  261. package/dist/llm/pi/pi-tool-bridge.d.ts.map +1 -0
  262. package/dist/llm/pi/pi-tool-bridge.js +117 -0
  263. package/dist/llm/pi/pi-tool-bridge.js.map +1 -0
  264. package/dist/llm/pi/pi-types.d.ts +56 -0
  265. package/dist/llm/pi/pi-types.d.ts.map +1 -0
  266. package/dist/llm/pi/pi-types.js +16 -0
  267. package/dist/llm/pi/pi-types.js.map +1 -0
  268. package/dist/llm/pi/resolve-execution-env.d.ts +194 -0
  269. package/dist/llm/pi/resolve-execution-env.d.ts.map +1 -0
  270. package/dist/llm/pi/resolve-execution-env.js +132 -0
  271. package/dist/llm/pi/resolve-execution-env.js.map +1 -0
  272. package/dist/llm/plugin-facade.js +5472 -1331
  273. package/dist/llm/plugin-facade.js.map +3 -3
  274. package/dist/llm/provider-registry/builtin/anthropic.d.ts.map +1 -1
  275. package/dist/llm/provider-registry/builtin/anthropic.js +23 -10
  276. package/dist/llm/provider-registry/builtin/anthropic.js.map +1 -1
  277. package/dist/llm/provider-registry/provider-alias.d.ts +62 -0
  278. package/dist/llm/provider-registry/provider-alias.d.ts.map +1 -0
  279. package/dist/llm/provider-registry/provider-alias.js +85 -0
  280. package/dist/llm/provider-registry/provider-alias.js.map +1 -0
  281. package/dist/llm/provider-registry/provider-defs.d.ts +45 -0
  282. package/dist/llm/provider-registry/provider-defs.d.ts.map +1 -0
  283. package/dist/llm/provider-registry/provider-defs.js +145 -0
  284. package/dist/llm/provider-registry/provider-defs.js.map +1 -0
  285. package/dist/llm/provider-registry/provider-seed.d.ts +78 -0
  286. package/dist/llm/provider-registry/provider-seed.d.ts.map +1 -0
  287. package/dist/llm/provider-registry/provider-seed.js +113 -0
  288. package/dist/llm/provider-registry/provider-seed.js.map +1 -0
  289. package/dist/llm/role-executor.d.ts.map +1 -1
  290. package/dist/llm/role-executor.js +44 -5
  291. package/dist/llm/role-executor.js.map +1 -1
  292. package/dist/llm/role-resolver.d.ts +46 -14
  293. package/dist/llm/role-resolver.d.ts.map +1 -1
  294. package/dist/llm/role-resolver.js +185 -20
  295. package/dist/llm/role-resolver.js.map +1 -1
  296. package/dist/llm/sealed-credential.d.ts +125 -0
  297. package/dist/llm/sealed-credential.d.ts.map +1 -0
  298. package/dist/llm/sealed-credential.js +133 -0
  299. package/dist/llm/sealed-credential.js.map +1 -0
  300. package/dist/llm/session-factory.d.ts.map +1 -1
  301. package/dist/llm/session-factory.js +6 -2
  302. package/dist/llm/session-factory.js.map +1 -1
  303. package/dist/llm/system-key.d.ts +67 -0
  304. package/dist/llm/system-key.d.ts.map +1 -0
  305. package/dist/llm/system-key.js +87 -0
  306. package/dist/llm/system-key.js.map +1 -0
  307. package/dist/llm/system-of-use-registry.d.ts +119 -0
  308. package/dist/llm/system-of-use-registry.d.ts.map +1 -0
  309. package/dist/llm/system-of-use-registry.js +200 -0
  310. package/dist/llm/system-of-use-registry.js.map +1 -0
  311. package/dist/llm/system-resolver.d.ts +32 -10
  312. package/dist/llm/system-resolver.d.ts.map +1 -1
  313. package/dist/llm/system-resolver.js +138 -35
  314. package/dist/llm/system-resolver.js.map +1 -1
  315. package/dist/memory/brain-writer-thread.d.ts.map +1 -1
  316. package/dist/memory/brain-writer-thread.js +116 -11
  317. package/dist/memory/brain-writer-thread.js.map +1 -1
  318. package/dist/memory/claude-mem-migration.d.ts.map +1 -1
  319. package/dist/memory/claude-mem-migration.js +21 -0
  320. package/dist/memory/claude-mem-migration.js.map +1 -1
  321. package/dist/memory/graph-memory-bridge.d.ts.map +1 -1
  322. package/dist/memory/graph-memory-bridge.js +32 -25
  323. package/dist/memory/graph-memory-bridge.js.map +1 -1
  324. package/dist/memory/learnings.d.ts +4 -0
  325. package/dist/memory/learnings.d.ts.map +1 -1
  326. package/dist/memory/llm-backend-resolver.js +23 -5
  327. package/dist/memory/llm-backend-resolver.js.map +1 -1
  328. package/dist/memory/patterns.d.ts +4 -0
  329. package/dist/memory/patterns.d.ts.map +1 -1
  330. package/dist/metrics/index.d.ts +2 -0
  331. package/dist/metrics/index.d.ts.map +1 -1
  332. package/dist/metrics/index.js +1 -0
  333. package/dist/metrics/index.js.map +1 -1
  334. package/dist/nexus/migrations/M-split-graph.d.ts.map +1 -1
  335. package/dist/nexus/migrations/M-split-graph.js +60 -53
  336. package/dist/nexus/migrations/M-split-graph.js.map +1 -1
  337. package/dist/orchestrate/pivot.d.ts.map +1 -1
  338. package/dist/orchestrate/pivot.js +20 -2
  339. package/dist/orchestrate/pivot.js.map +1 -1
  340. package/dist/orchestration/spawn.d.ts +89 -0
  341. package/dist/orchestration/spawn.d.ts.map +1 -1
  342. package/dist/orchestration/spawn.js +68 -0
  343. package/dist/orchestration/spawn.js.map +1 -1
  344. package/dist/playbooks/cantbook-profile.d.ts +96 -0
  345. package/dist/playbooks/cantbook-profile.d.ts.map +1 -0
  346. package/dist/playbooks/cantbook-profile.js +97 -0
  347. package/dist/playbooks/cantbook-profile.js.map +1 -0
  348. package/dist/playbooks/guarded-deterministic-runner.d.ts +153 -0
  349. package/dist/playbooks/guarded-deterministic-runner.d.ts.map +1 -0
  350. package/dist/playbooks/guarded-deterministic-runner.js +155 -0
  351. package/dist/playbooks/guarded-deterministic-runner.js.map +1 -0
  352. package/dist/playbooks/index.d.ts +2 -0
  353. package/dist/playbooks/index.d.ts.map +1 -1
  354. package/dist/playbooks/index.js +10 -0
  355. package/dist/playbooks/index.js.map +1 -1
  356. package/dist/playbooks/pi-runner-wiring.d.ts +75 -0
  357. package/dist/playbooks/pi-runner-wiring.d.ts.map +1 -0
  358. package/dist/playbooks/pi-runner-wiring.js +82 -0
  359. package/dist/playbooks/pi-runner-wiring.js.map +1 -0
  360. package/dist/release/engine-ops.js +2 -2
  361. package/dist/release/engine-ops.js.map +1 -1
  362. package/dist/routing/capability-matrix.d.ts.map +1 -1
  363. package/dist/routing/capability-matrix.js +0 -57
  364. package/dist/routing/capability-matrix.js.map +1 -1
  365. package/dist/runtime/openapi/generate-openapi.d.ts +211 -0
  366. package/dist/runtime/openapi/generate-openapi.d.ts.map +1 -0
  367. package/dist/runtime/openapi/generate-openapi.js +300 -0
  368. package/dist/runtime/openapi/generate-openapi.js.map +1 -0
  369. package/dist/runtime/openapi/index.d.ts +16 -0
  370. package/dist/runtime/openapi/index.d.ts.map +1 -0
  371. package/dist/runtime/openapi/index.js +16 -0
  372. package/dist/runtime/openapi/index.js.map +1 -0
  373. package/dist/selfimprove/budget.d.ts +206 -0
  374. package/dist/selfimprove/budget.d.ts.map +1 -0
  375. package/dist/selfimprove/budget.js +203 -0
  376. package/dist/selfimprove/budget.js.map +1 -0
  377. package/dist/selfimprove/dhq-adapter.d.ts +105 -0
  378. package/dist/selfimprove/dhq-adapter.d.ts.map +1 -0
  379. package/dist/selfimprove/dhq-adapter.js +95 -0
  380. package/dist/selfimprove/dhq-adapter.js.map +1 -0
  381. package/dist/selfimprove/draft-pr.d.ts +129 -0
  382. package/dist/selfimprove/draft-pr.d.ts.map +1 -0
  383. package/dist/selfimprove/draft-pr.js +158 -0
  384. package/dist/selfimprove/draft-pr.js.map +1 -0
  385. package/dist/selfimprove/envelope-diff.d.ts +162 -0
  386. package/dist/selfimprove/envelope-diff.d.ts.map +1 -0
  387. package/dist/selfimprove/envelope-diff.js +321 -0
  388. package/dist/selfimprove/envelope-diff.js.map +1 -0
  389. package/dist/selfimprove/replay.d.ts +121 -0
  390. package/dist/selfimprove/replay.d.ts.map +1 -0
  391. package/dist/selfimprove/replay.js +109 -0
  392. package/dist/selfimprove/replay.js.map +1 -0
  393. package/dist/selfimprove/run-loop.d.ts +148 -0
  394. package/dist/selfimprove/run-loop.d.ts.map +1 -0
  395. package/dist/selfimprove/run-loop.js +240 -0
  396. package/dist/selfimprove/run-loop.js.map +1 -0
  397. package/dist/selfimprove/scenario.d.ts +145 -0
  398. package/dist/selfimprove/scenario.d.ts.map +1 -0
  399. package/dist/selfimprove/scenario.js +243 -0
  400. package/dist/selfimprove/scenario.js.map +1 -0
  401. package/dist/selfimprove/scenarios/dhq-replay-find/golden.json +32 -0
  402. package/dist/selfimprove/scenarios/dhq-replay-find/scenario.json +18 -0
  403. package/dist/sentient/daemon-entry.js +5 -0
  404. package/dist/sentient/daemon-entry.js.map +1 -1
  405. package/dist/sentient/daemon.d.ts.map +1 -1
  406. package/dist/sentient/daemon.js +19 -0
  407. package/dist/sentient/daemon.js.map +1 -1
  408. package/dist/sentient/hygiene-scan.d.ts.map +1 -1
  409. package/dist/sentient/hygiene-scan.js +14 -6
  410. package/dist/sentient/hygiene-scan.js.map +1 -1
  411. package/dist/sessions/briefing.d.ts.map +1 -1
  412. package/dist/sessions/briefing.js +13 -9
  413. package/dist/sessions/briefing.js.map +1 -1
  414. package/dist/sessions/connection-session-handle.d.ts +161 -0
  415. package/dist/sessions/connection-session-handle.d.ts.map +1 -0
  416. package/dist/sessions/connection-session-handle.js +168 -0
  417. package/dist/sessions/connection-session-handle.js.map +1 -0
  418. package/dist/sessions/handoff.d.ts.map +1 -1
  419. package/dist/sessions/handoff.js +9 -0
  420. package/dist/sessions/handoff.js.map +1 -1
  421. package/dist/sessions/index.d.ts +4 -1
  422. package/dist/sessions/index.d.ts.map +1 -1
  423. package/dist/sessions/index.js +31 -1
  424. package/dist/sessions/index.js.map +1 -1
  425. package/dist/sessions/session-id.d.ts +34 -0
  426. package/dist/sessions/session-id.d.ts.map +1 -1
  427. package/dist/sessions/session-id.js +37 -0
  428. package/dist/sessions/session-id.js.map +1 -1
  429. package/dist/sessions/session-manifest-mirror.d.ts +115 -0
  430. package/dist/sessions/session-manifest-mirror.d.ts.map +1 -0
  431. package/dist/sessions/session-manifest-mirror.js +250 -0
  432. package/dist/sessions/session-manifest-mirror.js.map +1 -0
  433. package/dist/sessions/session-switch.d.ts.map +1 -1
  434. package/dist/sessions/session-switch.js +5 -2
  435. package/dist/sessions/session-switch.js.map +1 -1
  436. package/dist/setup/config-json-merge.d.ts.map +1 -1
  437. package/dist/setup/config-json-merge.js +14 -0
  438. package/dist/setup/config-json-merge.js.map +1 -1
  439. package/dist/setup/index.d.ts +23 -11
  440. package/dist/setup/index.d.ts.map +1 -1
  441. package/dist/setup/index.js +25 -12
  442. package/dist/setup/index.js.map +1 -1
  443. package/dist/setup/sections/llm.d.ts +28 -1
  444. package/dist/setup/sections/llm.d.ts.map +1 -1
  445. package/dist/setup/sections/llm.js +27 -6
  446. package/dist/setup/sections/llm.js.map +1 -1
  447. package/dist/setup/sections/models-roles.d.ts +40 -0
  448. package/dist/setup/sections/models-roles.d.ts.map +1 -0
  449. package/dist/setup/sections/models-roles.js +219 -0
  450. package/dist/setup/sections/models-roles.js.map +1 -0
  451. package/dist/setup/wizard.d.ts +19 -1
  452. package/dist/setup/wizard.d.ts.map +1 -1
  453. package/dist/setup/wizard.js.map +1 -1
  454. package/dist/store/converters.d.ts.map +1 -1
  455. package/dist/store/converters.js +2 -0
  456. package/dist/store/converters.js.map +1 -1
  457. package/dist/store/db-helpers.d.ts.map +1 -1
  458. package/dist/store/db-helpers.js +2 -0
  459. package/dist/store/db-helpers.js.map +1 -1
  460. package/dist/store/dual-scope-db.d.ts.map +1 -1
  461. package/dist/store/dual-scope-db.js +87 -47
  462. package/dist/store/dual-scope-db.js.map +1 -1
  463. package/dist/store/pi-session-store.d.ts +151 -0
  464. package/dist/store/pi-session-store.d.ts.map +1 -0
  465. package/dist/store/pi-session-store.js +166 -0
  466. package/dist/store/pi-session-store.js.map +1 -0
  467. package/dist/store/safety-data-accessor.d.ts +1 -0
  468. package/dist/store/safety-data-accessor.d.ts.map +1 -1
  469. package/dist/store/safety-data-accessor.js +5 -0
  470. package/dist/store/safety-data-accessor.js.map +1 -1
  471. package/dist/store/schedule-schema.d.ts +195 -0
  472. package/dist/store/schedule-schema.d.ts.map +1 -0
  473. package/dist/store/schedule-schema.js +84 -0
  474. package/dist/store/schedule-schema.js.map +1 -0
  475. package/dist/store/schedule-store.d.ts +144 -0
  476. package/dist/store/schedule-store.d.ts.map +1 -0
  477. package/dist/store/schedule-store.js +162 -0
  478. package/dist/store/schedule-store.js.map +1 -0
  479. package/dist/store/schema/attachments.d.ts +1 -1
  480. package/dist/store/schema/cleo-global/accounts.d.ts +357 -0
  481. package/dist/store/schema/cleo-global/accounts.d.ts.map +1 -0
  482. package/dist/store/schema/cleo-global/accounts.js +136 -0
  483. package/dist/store/schema/cleo-global/accounts.js.map +1 -0
  484. package/dist/store/schema/cleo-global/index.d.ts +5 -0
  485. package/dist/store/schema/cleo-global/index.d.ts.map +1 -1
  486. package/dist/store/schema/cleo-global/index.js +7 -0
  487. package/dist/store/schema/cleo-global/index.js.map +1 -1
  488. package/dist/store/schema/cleo-global/models-catalog.d.ts +359 -0
  489. package/dist/store/schema/cleo-global/models-catalog.d.ts.map +1 -0
  490. package/dist/store/schema/cleo-global/models-catalog.js +114 -0
  491. package/dist/store/schema/cleo-global/models-catalog.js.map +1 -0
  492. package/dist/store/schema/cleo-global/providers.d.ts +279 -0
  493. package/dist/store/schema/cleo-global/providers.d.ts.map +1 -0
  494. package/dist/store/schema/cleo-global/providers.js +94 -0
  495. package/dist/store/schema/cleo-global/providers.js.map +1 -0
  496. package/dist/store/schema/cleo-global/services.d.ts +493 -0
  497. package/dist/store/schema/cleo-global/services.d.ts.map +1 -0
  498. package/dist/store/schema/cleo-global/services.js +200 -0
  499. package/dist/store/schema/cleo-global/services.js.map +1 -0
  500. package/dist/store/schema/cleo-global/session-manifest.d.ts +217 -0
  501. package/dist/store/schema/cleo-global/session-manifest.d.ts.map +1 -0
  502. package/dist/store/schema/cleo-global/session-manifest.js +99 -0
  503. package/dist/store/schema/cleo-global/session-manifest.js.map +1 -0
  504. package/dist/store/schema/cleo-project/docs.d.ts +1 -1
  505. package/dist/store/schema/cleo-project/provenance-rest.d.ts +1 -1
  506. package/dist/store/schema/cleo-project/tasks-core.d.ts +16 -0
  507. package/dist/store/schema/cleo-project/tasks-core.d.ts.map +1 -1
  508. package/dist/store/schema/cleo-project/tasks-core.js +14 -0
  509. package/dist/store/schema/cleo-project/tasks-core.js.map +1 -1
  510. package/dist/store/schema/cleo-shared/brain.d.ts +2 -2
  511. package/dist/store/schema/memory-schema.d.ts +182 -2
  512. package/dist/store/schema/memory-schema.d.ts.map +1 -1
  513. package/dist/store/schema/memory-schema.js +111 -2
  514. package/dist/store/schema/memory-schema.js.map +1 -1
  515. package/dist/store/schema/provenance/releases.d.ts +1 -1
  516. package/dist/store/schema/tasks.d.ts +16 -0
  517. package/dist/store/schema/tasks.d.ts.map +1 -1
  518. package/dist/store/schema/tasks.js +10 -0
  519. package/dist/store/schema/tasks.js.map +1 -1
  520. package/dist/store/selfimprove-dhq-schema.d.ts +284 -0
  521. package/dist/store/selfimprove-dhq-schema.d.ts.map +1 -0
  522. package/dist/store/selfimprove-dhq-schema.js +128 -0
  523. package/dist/store/selfimprove-dhq-schema.js.map +1 -0
  524. package/dist/store/selfimprove-dhq-store.d.ts +175 -0
  525. package/dist/store/selfimprove-dhq-store.d.ts.map +1 -0
  526. package/dist/store/selfimprove-dhq-store.js +182 -0
  527. package/dist/store/selfimprove-dhq-store.js.map +1 -0
  528. package/dist/store/service-connections-accessor.d.ts +313 -0
  529. package/dist/store/service-connections-accessor.d.ts.map +1 -0
  530. package/dist/store/service-connections-accessor.js +464 -0
  531. package/dist/store/service-connections-accessor.js.map +1 -0
  532. package/dist/store/service-host-matcher.d.ts +70 -0
  533. package/dist/store/service-host-matcher.d.ts.map +1 -0
  534. package/dist/store/service-host-matcher.js +127 -0
  535. package/dist/store/service-host-matcher.js.map +1 -0
  536. package/dist/store/service-injection.d.ts +152 -0
  537. package/dist/store/service-injection.d.ts.map +1 -0
  538. package/dist/store/service-injection.js +225 -0
  539. package/dist/store/service-injection.js.map +1 -0
  540. package/dist/store/service-oauth.d.ts +287 -0
  541. package/dist/store/service-oauth.d.ts.map +1 -0
  542. package/dist/store/service-oauth.js +524 -0
  543. package/dist/store/service-oauth.js.map +1 -0
  544. package/dist/store/service-trust-gate.d.ts +164 -0
  545. package/dist/store/service-trust-gate.d.ts.map +1 -0
  546. package/dist/store/service-trust-gate.js +122 -0
  547. package/dist/store/service-trust-gate.js.map +1 -0
  548. package/dist/store/session-store.d.ts +52 -13
  549. package/dist/store/session-store.d.ts.map +1 -1
  550. package/dist/store/session-store.js +71 -13
  551. package/dist/store/session-store.js.map +1 -1
  552. package/dist/store/sqlite-data-accessor.d.ts.map +1 -1
  553. package/dist/store/sqlite-data-accessor.js +7 -0
  554. package/dist/store/sqlite-data-accessor.js.map +1 -1
  555. package/dist/store/umbrella-data-accessor.d.ts +1 -0
  556. package/dist/store/umbrella-data-accessor.d.ts.map +1 -1
  557. package/dist/store/umbrella-data-accessor.js +5 -0
  558. package/dist/store/umbrella-data-accessor.js.map +1 -1
  559. package/dist/store/validation-schemas.d.ts +36 -4
  560. package/dist/store/validation-schemas.d.ts.map +1 -1
  561. package/dist/store/writer-lease-schema.d.ts +392 -0
  562. package/dist/store/writer-lease-schema.d.ts.map +1 -0
  563. package/dist/store/writer-lease-schema.js +142 -0
  564. package/dist/store/writer-lease-schema.js.map +1 -0
  565. package/dist/store/writer-lease.d.ts +368 -0
  566. package/dist/store/writer-lease.d.ts.map +1 -0
  567. package/dist/store/writer-lease.js +1002 -0
  568. package/dist/store/writer-lease.js.map +1 -0
  569. package/dist/tasks/agent-lifecycle-lane.d.ts +175 -0
  570. package/dist/tasks/agent-lifecycle-lane.d.ts.map +1 -0
  571. package/dist/tasks/agent-lifecycle-lane.js +176 -0
  572. package/dist/tasks/agent-lifecycle-lane.js.map +1 -0
  573. package/dist/tasks/backfill-child-projections.d.ts.map +1 -1
  574. package/dist/tasks/backfill-child-projections.js +14 -9
  575. package/dist/tasks/backfill-child-projections.js.map +1 -1
  576. package/dist/tasks/complete.d.ts +17 -0
  577. package/dist/tasks/complete.d.ts.map +1 -1
  578. package/dist/tasks/complete.js +60 -20
  579. package/dist/tasks/complete.js.map +1 -1
  580. package/dist/tasks/depends-waiver-audit.d.ts +52 -0
  581. package/dist/tasks/depends-waiver-audit.d.ts.map +1 -0
  582. package/dist/tasks/depends-waiver-audit.js +36 -0
  583. package/dist/tasks/depends-waiver-audit.js.map +1 -0
  584. package/dist/tasks/duplicate-detector.d.ts.map +1 -1
  585. package/dist/tasks/duplicate-detector.js +14 -7
  586. package/dist/tasks/duplicate-detector.js.map +1 -1
  587. package/dist/tasks/engine-wrap.d.ts +36 -2
  588. package/dist/tasks/engine-wrap.d.ts.map +1 -1
  589. package/dist/tasks/engine-wrap.js +44 -2
  590. package/dist/tasks/engine-wrap.js.map +1 -1
  591. package/dist/tasks/index.d.ts +1 -0
  592. package/dist/tasks/index.d.ts.map +1 -1
  593. package/dist/tasks/index.js +1 -0
  594. package/dist/tasks/index.js.map +1 -1
  595. package/dist/tasks/ops.d.ts +3 -0
  596. package/dist/tasks/ops.d.ts.map +1 -1
  597. package/dist/tasks/task-ops.d.ts +1 -1
  598. package/dist/tasks/task-ops.d.ts.map +1 -1
  599. package/dist/tasks/task-ops.js +3 -1
  600. package/dist/tasks/task-ops.js.map +1 -1
  601. package/dist/tasks/task-reparent.d.ts +90 -0
  602. package/dist/tasks/task-reparent.d.ts.map +1 -1
  603. package/dist/tasks/task-reparent.js +171 -0
  604. package/dist/tasks/task-reparent.js.map +1 -1
  605. package/dist/telemetry/index.d.ts.map +1 -1
  606. package/dist/telemetry/index.js +10 -4
  607. package/dist/telemetry/index.js.map +1 -1
  608. package/dist/tools/agent-registry.d.ts +250 -0
  609. package/dist/tools/agent-registry.d.ts.map +1 -0
  610. package/dist/tools/agent-registry.js +292 -0
  611. package/dist/tools/agent-registry.js.map +1 -0
  612. package/dist/tools/agent-tool-families.d.ts +107 -0
  613. package/dist/tools/agent-tool-families.d.ts.map +1 -0
  614. package/dist/tools/agent-tool-families.js +527 -0
  615. package/dist/tools/agent-tool-families.js.map +1 -0
  616. package/dist/tools/browser-driver.d.ts +183 -0
  617. package/dist/tools/browser-driver.d.ts.map +1 -0
  618. package/dist/tools/browser-driver.js +242 -0
  619. package/dist/tools/browser-driver.js.map +1 -0
  620. package/dist/tools/builtin-agent-tools.d.ts +36 -0
  621. package/dist/tools/builtin-agent-tools.d.ts.map +1 -0
  622. package/dist/tools/builtin-agent-tools.js +191 -0
  623. package/dist/tools/builtin-agent-tools.js.map +1 -0
  624. package/dist/tools/dispatch.d.ts +370 -0
  625. package/dist/tools/dispatch.d.ts.map +1 -0
  626. package/dist/tools/dispatch.js +505 -0
  627. package/dist/tools/dispatch.js.map +1 -0
  628. package/dist/tools/env-scrub.d.ts +93 -0
  629. package/dist/tools/env-scrub.d.ts.map +1 -0
  630. package/dist/tools/env-scrub.js +176 -0
  631. package/dist/tools/env-scrub.js.map +1 -0
  632. package/dist/tools/exec-code-agent-tool.d.ts +179 -0
  633. package/dist/tools/exec-code-agent-tool.d.ts.map +1 -0
  634. package/dist/tools/exec-code-agent-tool.js +239 -0
  635. package/dist/tools/exec-code-agent-tool.js.map +1 -0
  636. package/dist/tools/fs.d.ts +30 -0
  637. package/dist/tools/fs.d.ts.map +1 -1
  638. package/dist/tools/fs.js +55 -2
  639. package/dist/tools/fs.js.map +1 -1
  640. package/dist/tools/guard.d.ts +15 -0
  641. package/dist/tools/guard.d.ts.map +1 -1
  642. package/dist/tools/guard.js +49 -12
  643. package/dist/tools/guard.js.map +1 -1
  644. package/dist/tools/index.d.ts +16 -0
  645. package/dist/tools/index.d.ts.map +1 -1
  646. package/dist/tools/index.js +52 -0
  647. package/dist/tools/index.js.map +1 -1
  648. package/dist/tools/mcp-agent-tool.d.ts +189 -0
  649. package/dist/tools/mcp-agent-tool.d.ts.map +1 -0
  650. package/dist/tools/mcp-agent-tool.js +243 -0
  651. package/dist/tools/mcp-agent-tool.js.map +1 -0
  652. package/dist/tools/media-agent-tools.d.ts +105 -0
  653. package/dist/tools/media-agent-tools.d.ts.map +1 -0
  654. package/dist/tools/media-agent-tools.js +255 -0
  655. package/dist/tools/media-agent-tools.js.map +1 -0
  656. package/dist/tools/memory-agent-tools.d.ts +99 -0
  657. package/dist/tools/memory-agent-tools.d.ts.map +1 -0
  658. package/dist/tools/memory-agent-tools.js +190 -0
  659. package/dist/tools/memory-agent-tools.js.map +1 -0
  660. package/dist/tools/pty.d.ts +45 -0
  661. package/dist/tools/pty.d.ts.map +1 -0
  662. package/dist/tools/pty.js +166 -0
  663. package/dist/tools/pty.js.map +1 -0
  664. package/dist/tools/schedule-agent-tools.d.ts +151 -0
  665. package/dist/tools/schedule-agent-tools.d.ts.map +1 -0
  666. package/dist/tools/schedule-agent-tools.js +238 -0
  667. package/dist/tools/schedule-agent-tools.js.map +1 -0
  668. package/dist/tools/schema-gen.d.ts +57 -0
  669. package/dist/tools/schema-gen.d.ts.map +1 -0
  670. package/dist/tools/schema-gen.js +52 -0
  671. package/dist/tools/schema-gen.js.map +1 -0
  672. package/dist/tools/shell.d.ts +12 -0
  673. package/dist/tools/shell.d.ts.map +1 -1
  674. package/dist/tools/shell.js +14 -1
  675. package/dist/tools/shell.js.map +1 -1
  676. package/dist/tools/skill-agent-tool.d.ts +108 -0
  677. package/dist/tools/skill-agent-tool.d.ts.map +1 -0
  678. package/dist/tools/skill-agent-tool.js +135 -0
  679. package/dist/tools/skill-agent-tool.js.map +1 -0
  680. package/dist/tools/web-agent-tools.d.ts +72 -0
  681. package/dist/tools/web-agent-tools.d.ts.map +1 -0
  682. package/dist/tools/web-agent-tools.js +393 -0
  683. package/dist/tools/web-agent-tools.js.map +1 -0
  684. package/dist/tools/web-search-backends.d.ts +156 -0
  685. package/dist/tools/web-search-backends.d.ts.map +1 -0
  686. package/dist/tools/web-search-backends.js +290 -0
  687. package/dist/tools/web-search-backends.js.map +1 -0
  688. package/dist/validation/engine-ops.d.ts.map +1 -1
  689. package/dist/validation/engine-ops.js +17 -1
  690. package/dist/validation/engine-ops.js.map +1 -1
  691. package/dist/validation/ops.d.ts +1 -15
  692. package/dist/validation/ops.d.ts.map +1 -1
  693. package/dist/validation/ops.js +0 -20
  694. package/dist/validation/ops.js.map +1 -1
  695. package/migrations/drizzle-brain/20260610000001_t10405-bitemporal-network-columns/migration.sql +71 -0
  696. package/migrations/drizzle-cleo-global/20260607000000_t11891-writer-leases/migration.sql +55 -0
  697. package/migrations/drizzle-cleo-global/20260607010000_t11639-session-manifest/migration.sql +43 -0
  698. package/migrations/drizzle-cleo-global/20260608000000_t11899-pi-session-tree/migration.sql +52 -0
  699. package/migrations/drizzle-cleo-global/20260608010000_t11709-accounts-credential-pool/migration.sql +72 -0
  700. package/migrations/drizzle-cleo-global/20260608020000_t11889-selfimprove-dhq/migration.sql +64 -0
  701. package/migrations/drizzle-cleo-global/20260609000000_t11937-service-vault/migration.sql +93 -0
  702. package/migrations/drizzle-cleo-global/20260609010000_t11733-models-catalog/migration.sql +65 -0
  703. package/migrations/drizzle-cleo-global/20260609020000_t11703-providers/migration.sql +52 -0
  704. package/migrations/drizzle-cleo-global/20260610000000_t11962-schedules/migration.sql +48 -0
  705. package/migrations/drizzle-cleo-project/20260607000000_t11891-writer-leases/migration.sql +55 -0
  706. package/migrations/drizzle-cleo-project/20260607010000_t11639-session-parent/migration.sql +22 -0
  707. package/migrations/drizzle-cleo-project/20260608000000_t11899-pi-session-tree/migration.sql +52 -0
  708. package/migrations/drizzle-cleo-project/20260608020000_t11889-selfimprove-dhq/migration.sql +64 -0
  709. package/migrations/drizzle-cleo-project/20260610000000_t11962-schedules/migration.sql +48 -0
  710. package/package.json +26 -14
  711. package/dist/lifecycle/chain-composition.d.ts +0 -30
  712. package/dist/lifecycle/chain-composition.d.ts.map +0 -1
  713. package/dist/lifecycle/chain-composition.js +0 -152
  714. package/dist/lifecycle/chain-composition.js.map +0 -1
  715. package/dist/lifecycle/chain-store.d.ts +0 -70
  716. package/dist/lifecycle/chain-store.d.ts.map +0 -1
  717. package/dist/lifecycle/chain-store.js +0 -246
  718. package/dist/lifecycle/chain-store.js.map +0 -1
  719. package/dist/lifecycle/default-chain.d.ts +0 -39
  720. package/dist/lifecycle/default-chain.d.ts.map +0 -1
  721. package/dist/lifecycle/default-chain.js +0 -176
  722. package/dist/lifecycle/default-chain.js.map +0 -1
  723. package/dist/lifecycle/tessera-engine.d.ts +0 -48
  724. package/dist/lifecycle/tessera-engine.d.ts.map +0 -1
  725. package/dist/lifecycle/tessera-engine.js +0 -249
  726. package/dist/lifecycle/tessera-engine.js.map +0 -1
  727. package/dist/validation/chain-validation.d.ts +0 -43
  728. package/dist/validation/chain-validation.d.ts.map +0 -1
  729. package/dist/validation/chain-validation.js +0 -146
  730. package/dist/validation/chain-validation.js.map +0 -1
@@ -0,0 +1,206 @@
1
+ /**
2
+ * Budget caps + circuit-breaker state machine for the self-improvement loop
3
+ * (T11889 · T11889-C).
4
+ *
5
+ * The loop is an AUTONOMOUS dogfooding engine — it boots a sandbox, replays a
6
+ * scenario, and on a regression it WRITES a leased DHQ row and opens a draft PR.
7
+ * Two guardrails bound that autonomy:
8
+ *
9
+ * 1. {@link SelfImproveBudget} — HARD, in-code caps (`maxTokens`, `maxUsd`,
10
+ * `maxPrs = 1`, `maxWorktrees = 1`). These are REAL, not advisory: the engine
11
+ * asks {@link CircuitBreaker.assertWithinBudget} BEFORE each costed step, so a
12
+ * cap is enforced as a PRE-FLIGHT check (never merely observed after the fact).
13
+ * `MemoryMax=32G` is NOT an in-code cap — a CORE function cannot portably
14
+ * self-confine to a cgroup (`systemd-run` is Linux-only) — it is an OPERATIONAL
15
+ * launch-wrapper documented on {@link MEMORY_MAX_LAUNCH_WRAPPER}; the in-process
16
+ * complement is the gondolin VM's own `memory` option.
17
+ * 2. {@link CircuitBreaker} — a one-way latch that HALTS the run (no further ops,
18
+ * no DHQ write, no PR) the moment any of these trip:
19
+ * - an architectural gate goes RED (`gateRed`);
20
+ * - the writer lease throws {@link "../store/writer-lease.js".LeaseUnavailableError}
21
+ * (a `require`-mode acquisition FAILURE — `leaseUnavailable`);
22
+ * - a budget cap would be exceeded (`budgetOverrun`);
23
+ * - a DB error escapes the leased section (`dbError`).
24
+ * It does NOT trip on "daemon OFF": the default lease mode is `local` (no
25
+ * daemon), so daemon-off is the NORMAL operating state — tripping on it would
26
+ * block EVERY write in the default config (P5 spec §B.7 correction).
27
+ *
28
+ * This module is PURE — no DB, no native handle, no `cleo` mutation, no I/O.
29
+ * Import-time side-effect-free.
30
+ *
31
+ * @module @cleocode/core/selfimprove/budget
32
+ * @epic T11889
33
+ * @task T11913
34
+ */
35
+ /**
36
+ * The reasons the circuit-breaker may latch OPEN. Each is a genuine
37
+ * halt-the-loop condition (P5 spec §B.7). Deliberately does NOT include a
38
+ * "daemon-off" reason — the default `local` lease mode runs daemon-less, so that
39
+ * is the normal state, not a fault.
40
+ */
41
+ export type CircuitBreakerReason =
42
+ /** An architectural gate (`cleo check arch --strict`) went RED. */
43
+ 'gateRed'
44
+ /** The writer lease threw `LeaseUnavailableError` (`require`-mode failure). */
45
+ | 'leaseUnavailable'
46
+ /** A budget cap (tokens/$/PRs/worktrees) would be exceeded. */
47
+ | 'budgetOverrun'
48
+ /** A DB error escaped the leased section. */
49
+ | 'dbError';
50
+ /**
51
+ * Hard, in-code budget caps for ONE self-improvement run.
52
+ *
53
+ * `maxPrs` and `maxWorktrees` are pinned to `1` by {@link DEFAULT_BUDGET}: the loop
54
+ * opens AT MOST one draft PR and boots AT MOST one sandbox per run. `maxTokens` /
55
+ * `maxUsd` bound model spend; the engine accumulates per-op cost and asks
56
+ * {@link CircuitBreaker.assertWithinBudget} before each costed step.
57
+ *
58
+ * `MemoryMax=32G` is intentionally ABSENT here — it is enforced at the launch
59
+ * boundary (see {@link MEMORY_MAX_LAUNCH_WRAPPER}), not by this object.
60
+ */
61
+ export interface SelfImproveBudget {
62
+ /** Maximum model tokens spent across the whole run. */
63
+ readonly maxTokens: number;
64
+ /** Maximum USD spent across the whole run. */
65
+ readonly maxUsd: number;
66
+ /** Maximum draft PRs opened in the run (pinned to `1`). */
67
+ readonly maxPrs: number;
68
+ /** Maximum sandbox envs booted in the run (pinned to `1`). */
69
+ readonly maxWorktrees: number;
70
+ }
71
+ /**
72
+ * The default budget for a self-improvement run. `maxPrs` / `maxWorktrees` are
73
+ * `1` by contract; `maxTokens` / `maxUsd` are conservative defaults overridable
74
+ * via {@link resolveBudget} (env) or an explicit partial.
75
+ */
76
+ export declare const DEFAULT_BUDGET: SelfImproveBudget;
77
+ /**
78
+ * The launch-boundary memory cap — an OPERATIONAL wrapper, NOT an in-code cap.
79
+ *
80
+ * A CORE function cannot portably self-confine to a cgroup (`systemd-run` is
81
+ * Linux-only; re-exec'ing under it from inside the engine is fragile), so the
82
+ * runbook / spawn wrapper that invokes `cleo selfimprove run` wraps it on Linux.
83
+ * On macOS the gondolin VM's own `memory` option bounds the guest. Exported as a
84
+ * documented constant so the spawn wrapper and the runbook share one SSoT string.
85
+ */
86
+ export declare const MEMORY_MAX_LAUNCH_WRAPPER: "systemd-run --user --scope -p MemoryMax=32G -p MemorySwapMax=0";
87
+ /**
88
+ * The mutable cost accumulator the engine threads through one run. Every costed
89
+ * step ADDS to this before asking the breaker whether the next step fits.
90
+ */
91
+ export interface BudgetSpend {
92
+ /** Tokens spent so far. */
93
+ tokens: number;
94
+ /** USD spent so far. */
95
+ usd: number;
96
+ /** Draft PRs opened so far. */
97
+ prs: number;
98
+ /** Sandbox envs booted so far. */
99
+ worktrees: number;
100
+ }
101
+ /** A fresh, zeroed {@link BudgetSpend}. */
102
+ export declare function emptySpend(): BudgetSpend;
103
+ /**
104
+ * The increment a single step would add to the spend. Each field defaults to `0`,
105
+ * so a step that only opens a PR passes `{ prs: 1 }`.
106
+ */
107
+ export interface BudgetCharge {
108
+ /** Tokens this step would consume. */
109
+ readonly tokens?: number;
110
+ /** USD this step would consume. */
111
+ readonly usd?: number;
112
+ /** Draft PRs this step would open. */
113
+ readonly prs?: number;
114
+ /** Sandbox envs this step would boot. */
115
+ readonly worktrees?: number;
116
+ }
117
+ /**
118
+ * Thrown by {@link CircuitBreaker.assertWithinBudget} when a step's charge would
119
+ * push the accumulated spend past a cap. Carries the offending dimension so the
120
+ * engine can trip the breaker with `reason: 'budgetOverrun'` and surface WHICH cap.
121
+ */
122
+ export declare class BudgetExceededError extends Error {
123
+ /** Stable machine-readable code. */
124
+ readonly code: "E_SELFIMPROVE_BUDGET_EXCEEDED";
125
+ /** Which cap was exceeded. */
126
+ readonly dimension: keyof SelfImproveBudget;
127
+ /**
128
+ * @param dimension - The exceeded cap dimension.
129
+ * @param attempted - The accumulated value the step would have reached.
130
+ * @param cap - The cap that bounds it.
131
+ */
132
+ constructor(dimension: keyof SelfImproveBudget, attempted: number, cap: number);
133
+ }
134
+ /** Snapshot of the circuit-breaker latch state. */
135
+ export interface CircuitBreakerState {
136
+ /** Whether the breaker has latched OPEN (the loop must halt). */
137
+ readonly open: boolean;
138
+ /** The reason the breaker tripped, or `null` while closed. */
139
+ readonly reason: CircuitBreakerReason | null;
140
+ /** A human-readable detail for the trip, or `null` while closed. */
141
+ readonly detail: string | null;
142
+ }
143
+ /**
144
+ * A one-way circuit-breaker latch + pre-flight budget gate for ONE run.
145
+ *
146
+ * Once {@link trip} is called the breaker stays OPEN for the run's lifetime —
147
+ * there is no reset (a run is single-use; the next run constructs a fresh
148
+ * breaker). {@link assertOpen} short-circuits B.4-B.5 to a no-op the moment the
149
+ * latch is set, and {@link assertWithinBudget} is the PRE-FLIGHT check the engine
150
+ * runs before each costed step.
151
+ *
152
+ * PURE — holds only in-memory counters; no I/O.
153
+ */
154
+ export declare class CircuitBreaker {
155
+ #private;
156
+ /**
157
+ * @param budget - The caps for this run (defaults to {@link DEFAULT_BUDGET}).
158
+ * @param spend - The starting spend (defaults to a zeroed accumulator).
159
+ */
160
+ constructor(budget?: SelfImproveBudget, spend?: BudgetSpend);
161
+ /** Whether the breaker has latched OPEN. */
162
+ get isOpen(): boolean;
163
+ /** The current latch state (open flag + reason + detail). */
164
+ get state(): CircuitBreakerState;
165
+ /** The accumulated spend so far (a live read of the internal counters). */
166
+ get spend(): Readonly<BudgetSpend>;
167
+ /**
168
+ * Latch the breaker OPEN. Idempotent: the FIRST trip wins — a later trip does
169
+ * not overwrite the original reason (the first fault is the relevant one).
170
+ *
171
+ * @param reason - The trip reason.
172
+ * @param detail - A human-readable detail for logs / the run report.
173
+ */
174
+ trip(reason: CircuitBreakerReason, detail: string): void;
175
+ /**
176
+ * Throw if the breaker is OPEN — the engine calls this at the top of each
177
+ * phase so a tripped breaker short-circuits the rest of the run.
178
+ *
179
+ * @throws {Error} `E_SELFIMPROVE_CIRCUIT_OPEN` when the breaker is latched.
180
+ */
181
+ assertClosed(): void;
182
+ /**
183
+ * PRE-FLIGHT budget check for a costed step. Computes the spend the step WOULD
184
+ * reach and — if any dimension would exceed its cap — TRIPS the breaker with
185
+ * `reason: 'budgetOverrun'` and throws {@link BudgetExceededError} BEFORE the
186
+ * step runs. On success it COMMITS the charge to the accumulator.
187
+ *
188
+ * @param charge - The increment the step would add.
189
+ * @throws {BudgetExceededError} When a cap would be exceeded (and trips the breaker).
190
+ */
191
+ chargeOrTrip(charge: BudgetCharge): void;
192
+ }
193
+ /**
194
+ * Resolve the effective {@link SelfImproveBudget}, layering env overrides over an
195
+ * explicit partial over {@link DEFAULT_BUDGET}. `maxPrs` / `maxWorktrees` are
196
+ * ALWAYS clamped to at most `1` regardless of override — the one-PR / one-sandbox
197
+ * ceiling is a hard invariant, not a tunable.
198
+ *
199
+ * Env overrides (numeric): `CLEO_SELFIMPROVE_MAX_TOKENS`, `CLEO_SELFIMPROVE_MAX_USD`.
200
+ *
201
+ * @param overrides - Optional explicit partial caps (test / caller injection).
202
+ * @param env - The environment to read overrides from (defaults to `process.env`).
203
+ * @returns The resolved, invariant-clamped budget.
204
+ */
205
+ export declare function resolveBudget(overrides?: Partial<SelfImproveBudget>, env?: NodeJS.ProcessEnv): SelfImproveBudget;
206
+ //# sourceMappingURL=budget.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/selfimprove/budget.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,203 @@
1
+ /**
2
+ * Budget caps + circuit-breaker state machine for the self-improvement loop
3
+ * (T11889 · T11889-C).
4
+ *
5
+ * The loop is an AUTONOMOUS dogfooding engine — it boots a sandbox, replays a
6
+ * scenario, and on a regression it WRITES a leased DHQ row and opens a draft PR.
7
+ * Two guardrails bound that autonomy:
8
+ *
9
+ * 1. {@link SelfImproveBudget} — HARD, in-code caps (`maxTokens`, `maxUsd`,
10
+ * `maxPrs = 1`, `maxWorktrees = 1`). These are REAL, not advisory: the engine
11
+ * asks {@link CircuitBreaker.assertWithinBudget} BEFORE each costed step, so a
12
+ * cap is enforced as a PRE-FLIGHT check (never merely observed after the fact).
13
+ * `MemoryMax=32G` is NOT an in-code cap — a CORE function cannot portably
14
+ * self-confine to a cgroup (`systemd-run` is Linux-only) — it is an OPERATIONAL
15
+ * launch-wrapper documented on {@link MEMORY_MAX_LAUNCH_WRAPPER}; the in-process
16
+ * complement is the gondolin VM's own `memory` option.
17
+ * 2. {@link CircuitBreaker} — a one-way latch that HALTS the run (no further ops,
18
+ * no DHQ write, no PR) the moment any of these trip:
19
+ * - an architectural gate goes RED (`gateRed`);
20
+ * - the writer lease throws {@link "../store/writer-lease.js".LeaseUnavailableError}
21
+ * (a `require`-mode acquisition FAILURE — `leaseUnavailable`);
22
+ * - a budget cap would be exceeded (`budgetOverrun`);
23
+ * - a DB error escapes the leased section (`dbError`).
24
+ * It does NOT trip on "daemon OFF": the default lease mode is `local` (no
25
+ * daemon), so daemon-off is the NORMAL operating state — tripping on it would
26
+ * block EVERY write in the default config (P5 spec §B.7 correction).
27
+ *
28
+ * This module is PURE — no DB, no native handle, no `cleo` mutation, no I/O.
29
+ * Import-time side-effect-free.
30
+ *
31
+ * @module @cleocode/core/selfimprove/budget
32
+ * @epic T11889
33
+ * @task T11913
34
+ */
35
+ /**
36
+ * The default budget for a self-improvement run. `maxPrs` / `maxWorktrees` are
37
+ * `1` by contract; `maxTokens` / `maxUsd` are conservative defaults overridable
38
+ * via {@link resolveBudget} (env) or an explicit partial.
39
+ */
40
+ export const DEFAULT_BUDGET = {
41
+ maxTokens: 200_000,
42
+ maxUsd: 5,
43
+ maxPrs: 1,
44
+ maxWorktrees: 1,
45
+ };
46
+ /**
47
+ * The launch-boundary memory cap — an OPERATIONAL wrapper, NOT an in-code cap.
48
+ *
49
+ * A CORE function cannot portably self-confine to a cgroup (`systemd-run` is
50
+ * Linux-only; re-exec'ing under it from inside the engine is fragile), so the
51
+ * runbook / spawn wrapper that invokes `cleo selfimprove run` wraps it on Linux.
52
+ * On macOS the gondolin VM's own `memory` option bounds the guest. Exported as a
53
+ * documented constant so the spawn wrapper and the runbook share one SSoT string.
54
+ */
55
+ export const MEMORY_MAX_LAUNCH_WRAPPER = 'systemd-run --user --scope -p MemoryMax=32G -p MemorySwapMax=0';
56
+ /** A fresh, zeroed {@link BudgetSpend}. */
57
+ export function emptySpend() {
58
+ return { tokens: 0, usd: 0, prs: 0, worktrees: 0 };
59
+ }
60
+ /**
61
+ * Thrown by {@link CircuitBreaker.assertWithinBudget} when a step's charge would
62
+ * push the accumulated spend past a cap. Carries the offending dimension so the
63
+ * engine can trip the breaker with `reason: 'budgetOverrun'` and surface WHICH cap.
64
+ */
65
+ export class BudgetExceededError extends Error {
66
+ /** Stable machine-readable code. */
67
+ code = 'E_SELFIMPROVE_BUDGET_EXCEEDED';
68
+ /** Which cap was exceeded. */
69
+ dimension;
70
+ /**
71
+ * @param dimension - The exceeded cap dimension.
72
+ * @param attempted - The accumulated value the step would have reached.
73
+ * @param cap - The cap that bounds it.
74
+ */
75
+ constructor(dimension, attempted, cap) {
76
+ super(`self-improve budget exceeded: ${dimension} would reach ${attempted}, cap is ${cap}`);
77
+ this.name = 'BudgetExceededError';
78
+ this.dimension = dimension;
79
+ }
80
+ }
81
+ /**
82
+ * A one-way circuit-breaker latch + pre-flight budget gate for ONE run.
83
+ *
84
+ * Once {@link trip} is called the breaker stays OPEN for the run's lifetime —
85
+ * there is no reset (a run is single-use; the next run constructs a fresh
86
+ * breaker). {@link assertOpen} short-circuits B.4-B.5 to a no-op the moment the
87
+ * latch is set, and {@link assertWithinBudget} is the PRE-FLIGHT check the engine
88
+ * runs before each costed step.
89
+ *
90
+ * PURE — holds only in-memory counters; no I/O.
91
+ */
92
+ export class CircuitBreaker {
93
+ #budget;
94
+ #spend;
95
+ #open = false;
96
+ #reason = null;
97
+ #detail = null;
98
+ /**
99
+ * @param budget - The caps for this run (defaults to {@link DEFAULT_BUDGET}).
100
+ * @param spend - The starting spend (defaults to a zeroed accumulator).
101
+ */
102
+ constructor(budget = DEFAULT_BUDGET, spend = emptySpend()) {
103
+ this.#budget = budget;
104
+ this.#spend = spend;
105
+ }
106
+ /** Whether the breaker has latched OPEN. */
107
+ get isOpen() {
108
+ return this.#open;
109
+ }
110
+ /** The current latch state (open flag + reason + detail). */
111
+ get state() {
112
+ return { open: this.#open, reason: this.#reason, detail: this.#detail };
113
+ }
114
+ /** The accumulated spend so far (a live read of the internal counters). */
115
+ get spend() {
116
+ return { ...this.#spend };
117
+ }
118
+ /**
119
+ * Latch the breaker OPEN. Idempotent: the FIRST trip wins — a later trip does
120
+ * not overwrite the original reason (the first fault is the relevant one).
121
+ *
122
+ * @param reason - The trip reason.
123
+ * @param detail - A human-readable detail for logs / the run report.
124
+ */
125
+ trip(reason, detail) {
126
+ if (this.#open)
127
+ return;
128
+ this.#open = true;
129
+ this.#reason = reason;
130
+ this.#detail = detail;
131
+ }
132
+ /**
133
+ * Throw if the breaker is OPEN — the engine calls this at the top of each
134
+ * phase so a tripped breaker short-circuits the rest of the run.
135
+ *
136
+ * @throws {Error} `E_SELFIMPROVE_CIRCUIT_OPEN` when the breaker is latched.
137
+ */
138
+ assertClosed() {
139
+ if (this.#open) {
140
+ const err = new Error(`self-improve circuit-breaker OPEN (${this.#reason}): ${this.#detail}`);
141
+ err.code = 'E_SELFIMPROVE_CIRCUIT_OPEN';
142
+ throw err;
143
+ }
144
+ }
145
+ /**
146
+ * PRE-FLIGHT budget check for a costed step. Computes the spend the step WOULD
147
+ * reach and — if any dimension would exceed its cap — TRIPS the breaker with
148
+ * `reason: 'budgetOverrun'` and throws {@link BudgetExceededError} BEFORE the
149
+ * step runs. On success it COMMITS the charge to the accumulator.
150
+ *
151
+ * @param charge - The increment the step would add.
152
+ * @throws {BudgetExceededError} When a cap would be exceeded (and trips the breaker).
153
+ */
154
+ chargeOrTrip(charge) {
155
+ const next = {
156
+ tokens: this.#spend.tokens + (charge.tokens ?? 0),
157
+ usd: this.#spend.usd + (charge.usd ?? 0),
158
+ prs: this.#spend.prs + (charge.prs ?? 0),
159
+ worktrees: this.#spend.worktrees + (charge.worktrees ?? 0),
160
+ };
161
+ const checks = [
162
+ ['maxTokens', next.tokens, this.#budget.maxTokens],
163
+ ['maxUsd', next.usd, this.#budget.maxUsd],
164
+ ['maxPrs', next.prs, this.#budget.maxPrs],
165
+ ['maxWorktrees', next.worktrees, this.#budget.maxWorktrees],
166
+ ];
167
+ for (const [dimension, attempted, cap] of checks) {
168
+ if (attempted > cap) {
169
+ const err = new BudgetExceededError(dimension, attempted, cap);
170
+ this.trip('budgetOverrun', err.message);
171
+ throw err;
172
+ }
173
+ }
174
+ this.#spend.tokens = next.tokens;
175
+ this.#spend.usd = next.usd;
176
+ this.#spend.prs = next.prs;
177
+ this.#spend.worktrees = next.worktrees;
178
+ }
179
+ }
180
+ /**
181
+ * Resolve the effective {@link SelfImproveBudget}, layering env overrides over an
182
+ * explicit partial over {@link DEFAULT_BUDGET}. `maxPrs` / `maxWorktrees` are
183
+ * ALWAYS clamped to at most `1` regardless of override — the one-PR / one-sandbox
184
+ * ceiling is a hard invariant, not a tunable.
185
+ *
186
+ * Env overrides (numeric): `CLEO_SELFIMPROVE_MAX_TOKENS`, `CLEO_SELFIMPROVE_MAX_USD`.
187
+ *
188
+ * @param overrides - Optional explicit partial caps (test / caller injection).
189
+ * @param env - The environment to read overrides from (defaults to `process.env`).
190
+ * @returns The resolved, invariant-clamped budget.
191
+ */
192
+ export function resolveBudget(overrides = {}, env = process.env) {
193
+ const envTokens = Number(env.CLEO_SELFIMPROVE_MAX_TOKENS);
194
+ const envUsd = Number(env.CLEO_SELFIMPROVE_MAX_USD);
195
+ const maxTokens = overrides.maxTokens ??
196
+ (Number.isFinite(envTokens) && envTokens > 0 ? envTokens : DEFAULT_BUDGET.maxTokens);
197
+ const maxUsd = overrides.maxUsd ?? (Number.isFinite(envUsd) && envUsd > 0 ? envUsd : DEFAULT_BUDGET.maxUsd);
198
+ // The one-PR / one-sandbox ceiling is invariant — clamp to at most 1.
199
+ const maxPrs = Math.min(1, overrides.maxPrs ?? DEFAULT_BUDGET.maxPrs);
200
+ const maxWorktrees = Math.min(1, overrides.maxWorktrees ?? DEFAULT_BUDGET.maxWorktrees);
201
+ return { maxTokens, maxUsd, maxPrs, maxWorktrees };
202
+ }
203
+ //# sourceMappingURL=budget.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/selfimprove/budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAwCH;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,SAAS,EAAE,OAAO;IAClB,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,CAAC;IACT,YAAY,EAAE,CAAC;CAChB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,yBAAyB,GACpC,gEAAyE,CAAC;AAiB5E,2CAA2C;AAC3C,MAAM,UAAU,UAAU;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;AACrD,CAAC;AAiBD;;;;GAIG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,oCAAoC;IACpB,IAAI,GAAG,+BAAwC,CAAC;IAChE,8BAA8B;IACd,SAAS,CAA0B;IAEnD;;;;OAIG;IACH,YAAY,SAAkC,EAAE,SAAiB,EAAE,GAAW;QAC5E,KAAK,CAAC,iCAAiC,SAAS,gBAAgB,SAAS,YAAY,GAAG,EAAE,CAAC,CAAC;QAC5F,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAYD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,cAAc;IAChB,OAAO,CAAoB;IAC3B,MAAM,CAAc;IAC7B,KAAK,GAAG,KAAK,CAAC;IACd,OAAO,GAAgC,IAAI,CAAC;IAC5C,OAAO,GAAkB,IAAI,CAAC;IAE9B;;;OAGG;IACH,YAAY,SAA4B,cAAc,EAAE,QAAqB,UAAU,EAAE;QACvF,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,4CAA4C;IAC5C,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,6DAA6D;IAC7D,IAAI,KAAK;QACP,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IAC1E,CAAC;IAED,2EAA2E;IAC3E,IAAI,KAAK;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,MAA4B,EAAE,MAAc;QAC/C,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO;QACvB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED;;;;;OAKG;IACH,YAAY;QACV,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,sCAAsC,IAAI,CAAC,OAAO,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7F,GAAgC,CAAC,IAAI,GAAG,4BAA4B,CAAC;YACtE,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,YAAY,CAAC,MAAoB;QAC/B,MAAM,IAAI,GAAgB;YACxB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;YACjD,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;YACxC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;YACxC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;SAC3D,CAAC;QAEF,MAAM,MAAM,GAAqD;YAC/D,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;YAClD,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;YACzC,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;YACzC,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;SAC5D,CAAC;QACF,KAAK,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;YACjD,IAAI,SAAS,GAAG,GAAG,EAAE,CAAC;gBACpB,MAAM,GAAG,GAAG,IAAI,mBAAmB,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;gBAC/D,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;gBACxC,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACzC,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC3B,YAAwC,EAAE,EAC1C,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAEpD,MAAM,SAAS,GACb,SAAS,CAAC,SAAS;QACnB,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IACvF,MAAM,MAAM,GACV,SAAS,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAE/F,sEAAsE;IACtE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IACtE,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,YAAY,IAAI,cAAc,CAAC,YAAY,CAAC,CAAC;IAExF,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;AACrD,CAAC"}
@@ -0,0 +1,105 @@
1
+ /**
2
+ * Durable DHQ adapter for the self-improvement loop (T11889 · T11889-C).
3
+ *
4
+ * This adapter sits OUTSIDE the store chokepoint (it is in `selfimprove/`, not
5
+ * `store/`), so it MUST NOT open a raw native handle (Gate-3). It is the lease
6
+ * boundary: EVERY write it performs is wrapped in
7
+ * {@link "../store/writer-lease.js".withWriterLease}`('project', 'bulk', …)`, which
8
+ * serializes the write against any other writer on the `(project, bulk)` lane. It
9
+ * then calls the Gate-3 accessors in
10
+ * {@link "../store/selfimprove-dhq-store.js"} (the ONLY native-handle toucher) —
11
+ * whose prepared statements target ONLY `selfimprove_dhq`.
12
+ *
13
+ * Two invariants the rest of the loop relies on:
14
+ *
15
+ * 1. **No raw / unleased write.** Reads go straight through the accessor (the
16
+ * shared handle, no lease); every WRITE goes through {@link upsertOpenDhq} /
17
+ * {@link recordPrUrl}, both of which acquire the lease first. There is no
18
+ * code path here that mutates `cleo.db` without the lease.
19
+ * 2. **`selfimprove_dhq` ONLY — never a prod `tasks`/`brain` row.** The lease
20
+ * SERIALIZES the write; it does NOT confine it to a table. The
21
+ * table-confinement is ENTIRELY this adapter's discipline: it calls only the
22
+ * `selfimprove_dhq` accessors, whose SQL references no other table. A unit
23
+ * test asserts the accessor SQL targets `selfimprove_dhq` and nothing else.
24
+ *
25
+ * Lease-mode note (P5 spec §B.7): the default mode is `local` (no daemon), where a
26
+ * contended lease DEGRADES under `busy_timeout` rather than throwing. To get a hard
27
+ * denial signal for the circuit-breaker, the process runs in `require` mode
28
+ * (`CLEO_WRITER_LEASE_MODE=require`), where an unacquirable lease THROWS
29
+ * {@link "../store/writer-lease.js".LeaseUnavailableError}. This adapter does NOT
30
+ * swallow that throw — it propagates so {@link runSelfImprove} trips the breaker.
31
+ *
32
+ * This module is import-time side-effect-free.
33
+ *
34
+ * @module @cleocode/core/selfimprove/dhq-adapter
35
+ * @epic T11889
36
+ * @task T11913
37
+ */
38
+ import { type SelfimproveDhqRow } from '../store/selfimprove-dhq-store.js';
39
+ /**
40
+ * The fields the engine supplies to {@link upsertOpenDhq}. `now` and the fixed
41
+ * `status: 'open'` are stamped by the accessor; `dhqId` / `severity` carry through.
42
+ */
43
+ export interface UpsertDhqInput {
44
+ /** Stable `'DHQ-###'` handle (used only on first insert for a hash). */
45
+ readonly dhqId: string;
46
+ /** The scenario name replayed. */
47
+ readonly scenario: string;
48
+ /** sha256 of the normalized regression signature — the idempotency key. */
49
+ readonly questionHash: string;
50
+ /** Human-readable DHQ title. */
51
+ readonly title: string;
52
+ /** The envelope-diff payload (the evidence) as serialized JSON. */
53
+ readonly regressionJson: string;
54
+ /** Severity classification, or `null` until triaged. */
55
+ readonly severity: string | null;
56
+ /** Ties the row to ONE loop run. */
57
+ readonly runId: string;
58
+ }
59
+ /** The durable DHQ adapter — the lease boundary for the self-improvement loop. */
60
+ export interface DhqAdapter {
61
+ /**
62
+ * Read the open DHQ row for a `question_hash` (lease-free — readers share the
63
+ * handle). Returns `null` when no open row exists.
64
+ */
65
+ readOpen(questionHash: string): Promise<SelfimproveDhqRow | null>;
66
+ /**
67
+ * UPSERT exactly ONE open DHQ row for a `question_hash`, under the
68
+ * `(project, bulk)` writer lease. Idempotent via the partial-UNIQUE index: a
69
+ * repeated open regression refreshes the existing row.
70
+ */
71
+ upsertOpenDhq(input: UpsertDhqInput): Promise<void>;
72
+ /**
73
+ * Record the draft PR URL on the open DHQ row for a `question_hash`, under the
74
+ * `(project, bulk)` writer lease.
75
+ *
76
+ * @returns The number of rows updated (0 when no open row exists).
77
+ */
78
+ recordPrUrl(questionHash: string, prUrl: string): Promise<number>;
79
+ }
80
+ /**
81
+ * Construct the durable DHQ adapter bound to a project working directory.
82
+ *
83
+ * Every WRITE method acquires the `(project, bulk)` writer lease via
84
+ * {@link "../store/writer-lease.js".withWriterLease} before delegating to the
85
+ * Gate-3 accessor. The native handle is resolved per call through
86
+ * {@link "../store/selfimprove-dhq-store.js".getSelfimproveDhqNativeDb} (the
87
+ * chokepoint singleton — no raw open). The clock is injectable for deterministic
88
+ * tests; production uses `Date.now`.
89
+ *
90
+ * @param opts - Adapter options.
91
+ * @param opts.cwd - Project working directory for scope resolution (defaults to `cwd`).
92
+ * @param opts.now - Injectable clock (defaults to {@link Date.now}).
93
+ * @returns A {@link DhqAdapter}.
94
+ *
95
+ * @example
96
+ * ```ts
97
+ * const adapter = createDhqAdapter({ cwd: projectRoot });
98
+ * await adapter.upsertOpenDhq({ dhqId: 'DHQ-001', … }); // leased UPSERT
99
+ * ```
100
+ */
101
+ export declare function createDhqAdapter(opts?: {
102
+ cwd?: string;
103
+ now?: () => number;
104
+ }): DhqAdapter;
105
+ //# sourceMappingURL=dhq-adapter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dhq-adapter.d.ts","sourceRoot":"","sources":["../../src/selfimprove/dhq-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAGL,KAAK,iBAAiB,EAIvB,MAAM,mCAAmC,CAAC;AAG3C;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,kFAAkF;AAClF,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAClE;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD;;;;;OAKG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACnE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAAO,GAAG,UAAU,CAoC5F"}
@@ -0,0 +1,95 @@
1
+ /**
2
+ * Durable DHQ adapter for the self-improvement loop (T11889 · T11889-C).
3
+ *
4
+ * This adapter sits OUTSIDE the store chokepoint (it is in `selfimprove/`, not
5
+ * `store/`), so it MUST NOT open a raw native handle (Gate-3). It is the lease
6
+ * boundary: EVERY write it performs is wrapped in
7
+ * {@link "../store/writer-lease.js".withWriterLease}`('project', 'bulk', …)`, which
8
+ * serializes the write against any other writer on the `(project, bulk)` lane. It
9
+ * then calls the Gate-3 accessors in
10
+ * {@link "../store/selfimprove-dhq-store.js"} (the ONLY native-handle toucher) —
11
+ * whose prepared statements target ONLY `selfimprove_dhq`.
12
+ *
13
+ * Two invariants the rest of the loop relies on:
14
+ *
15
+ * 1. **No raw / unleased write.** Reads go straight through the accessor (the
16
+ * shared handle, no lease); every WRITE goes through {@link upsertOpenDhq} /
17
+ * {@link recordPrUrl}, both of which acquire the lease first. There is no
18
+ * code path here that mutates `cleo.db` without the lease.
19
+ * 2. **`selfimprove_dhq` ONLY — never a prod `tasks`/`brain` row.** The lease
20
+ * SERIALIZES the write; it does NOT confine it to a table. The
21
+ * table-confinement is ENTIRELY this adapter's discipline: it calls only the
22
+ * `selfimprove_dhq` accessors, whose SQL references no other table. A unit
23
+ * test asserts the accessor SQL targets `selfimprove_dhq` and nothing else.
24
+ *
25
+ * Lease-mode note (P5 spec §B.7): the default mode is `local` (no daemon), where a
26
+ * contended lease DEGRADES under `busy_timeout` rather than throwing. To get a hard
27
+ * denial signal for the circuit-breaker, the process runs in `require` mode
28
+ * (`CLEO_WRITER_LEASE_MODE=require`), where an unacquirable lease THROWS
29
+ * {@link "../store/writer-lease.js".LeaseUnavailableError}. This adapter does NOT
30
+ * swallow that throw — it propagates so {@link runSelfImprove} trips the breaker.
31
+ *
32
+ * This module is import-time side-effect-free.
33
+ *
34
+ * @module @cleocode/core/selfimprove/dhq-adapter
35
+ * @epic T11889
36
+ * @task T11913
37
+ */
38
+ import { getSelfimproveDhqNativeDb, readOpenSelfimproveDhq, setSelfimproveDhqPrUrl, upsertOpenSelfimproveDhq, } from '../store/selfimprove-dhq-store.js';
39
+ import { withWriterLease } from '../store/writer-lease.js';
40
+ /**
41
+ * Construct the durable DHQ adapter bound to a project working directory.
42
+ *
43
+ * Every WRITE method acquires the `(project, bulk)` writer lease via
44
+ * {@link "../store/writer-lease.js".withWriterLease} before delegating to the
45
+ * Gate-3 accessor. The native handle is resolved per call through
46
+ * {@link "../store/selfimprove-dhq-store.js".getSelfimproveDhqNativeDb} (the
47
+ * chokepoint singleton — no raw open). The clock is injectable for deterministic
48
+ * tests; production uses `Date.now`.
49
+ *
50
+ * @param opts - Adapter options.
51
+ * @param opts.cwd - Project working directory for scope resolution (defaults to `cwd`).
52
+ * @param opts.now - Injectable clock (defaults to {@link Date.now}).
53
+ * @returns A {@link DhqAdapter}.
54
+ *
55
+ * @example
56
+ * ```ts
57
+ * const adapter = createDhqAdapter({ cwd: projectRoot });
58
+ * await adapter.upsertOpenDhq({ dhqId: 'DHQ-001', … }); // leased UPSERT
59
+ * ```
60
+ */
61
+ export function createDhqAdapter(opts = {}) {
62
+ const cwd = opts.cwd;
63
+ const now = opts.now ?? (() => Date.now());
64
+ return {
65
+ async readOpen(questionHash) {
66
+ const native = await getSelfimproveDhqNativeDb(cwd);
67
+ return readOpenSelfimproveDhq(native, questionHash);
68
+ },
69
+ async upsertOpenDhq(input) {
70
+ // EVERY write is leased — never raw / unleased. The lease serializes against
71
+ // other writers on (project, bulk); the table-confinement is the accessor's.
72
+ await withWriterLease('project', 'bulk', async () => {
73
+ const native = await getSelfimproveDhqNativeDb(cwd);
74
+ const row = {
75
+ dhqId: input.dhqId,
76
+ scenario: input.scenario,
77
+ questionHash: input.questionHash,
78
+ title: input.title,
79
+ regressionJson: input.regressionJson,
80
+ severity: input.severity,
81
+ runId: input.runId,
82
+ now: now(),
83
+ };
84
+ upsertOpenSelfimproveDhq(native, row);
85
+ });
86
+ },
87
+ async recordPrUrl(questionHash, prUrl) {
88
+ return withWriterLease('project', 'bulk', async () => {
89
+ const native = await getSelfimproveDhqNativeDb(cwd);
90
+ return setSelfimproveDhqPrUrl(native, questionHash, prUrl, now());
91
+ });
92
+ },
93
+ };
94
+ }
95
+ //# sourceMappingURL=dhq-adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dhq-adapter.js","sourceRoot":"","sources":["../../src/selfimprove/dhq-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EAGtB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AA6C3D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA6C,EAAE;IAC9E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IACrB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAE3C,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,YAAoB;YACjC,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,GAAG,CAAC,CAAC;YACpD,OAAO,sBAAsB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACtD,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,KAAqB;YACvC,6EAA6E;YAC7E,6EAA6E;YAC7E,MAAM,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE;gBAClD,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,GAAG,CAAC,CAAC;gBACpD,MAAM,GAAG,GAAyB;oBAChC,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,YAAY,EAAE,KAAK,CAAC,YAAY;oBAChC,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,cAAc,EAAE,KAAK,CAAC,cAAc;oBACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,GAAG,EAAE,GAAG,EAAE;iBACX,CAAC;gBACF,wBAAwB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YACxC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,YAAoB,EAAE,KAAa;YACnD,OAAO,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE;gBACnD,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,GAAG,CAAC,CAAC;gBACpD,OAAO,sBAAsB,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YACpE,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}