@interf/compiler 0.22.2 → 0.50.0

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 (616) hide show
  1. package/README.md +119 -282
  2. package/dist/bin-mcp.d.ts +2 -0
  3. package/dist/bin-mcp.js +63 -0
  4. package/dist/bin-runtime.d.ts +2 -0
  5. package/dist/bin-runtime.js +111 -0
  6. package/dist/cli/commands/agents.js +4 -35
  7. package/dist/cli/commands/auth.d.ts +20 -0
  8. package/dist/cli/commands/auth.js +161 -0
  9. package/dist/cli/commands/benchmark.d.ts +9 -0
  10. package/dist/cli/commands/benchmark.js +58 -0
  11. package/dist/cli/commands/build-plan.js +107 -139
  12. package/dist/cli/commands/build.d.ts +3 -4
  13. package/dist/cli/commands/build.js +16 -45
  14. package/dist/cli/commands/doctor.js +3 -3
  15. package/dist/cli/commands/graphs.d.ts +2 -0
  16. package/dist/cli/commands/graphs.js +344 -0
  17. package/dist/cli/commands/login.js +4 -6
  18. package/dist/cli/commands/logout.js +1 -1
  19. package/dist/cli/commands/mcp.d.ts +4 -2
  20. package/dist/cli/commands/mcp.js +846 -232
  21. package/dist/cli/commands/project.d.ts +2 -0
  22. package/dist/cli/commands/project.js +176 -0
  23. package/dist/cli/commands/reset.d.ts +3 -4
  24. package/dist/cli/commands/reset.js +10 -31
  25. package/dist/cli/commands/runs.js +136 -57
  26. package/dist/cli/commands/runtime.d.ts +24 -0
  27. package/dist/cli/commands/runtime.js +373 -0
  28. package/dist/cli/commands/status.d.ts +1 -0
  29. package/dist/cli/commands/status.js +35 -45
  30. package/dist/cli/commands/traces.d.ts +2 -0
  31. package/dist/cli/commands/traces.js +97 -0
  32. package/dist/cli/commands/wizard.js +171 -178
  33. package/dist/cli/index.d.ts +7 -4
  34. package/dist/cli/index.js +13 -7
  35. package/dist/cli/lib/http-client.d.ts +39 -0
  36. package/dist/cli/lib/http-client.js +73 -0
  37. package/dist/index.d.ts +2 -2
  38. package/dist/index.js +2 -2
  39. package/dist/packages/build-plans/authoring/brief.d.ts +538 -0
  40. package/dist/packages/build-plans/authoring/brief.js +89 -0
  41. package/dist/packages/build-plans/authoring/build-plan-authoring.d.ts +52 -11
  42. package/dist/packages/build-plans/authoring/build-plan-authoring.js +493 -46
  43. package/dist/packages/build-plans/authoring/build-plan-edit-session.d.ts +10 -1
  44. package/dist/packages/build-plans/authoring/build-plan-edit-session.js +27 -4
  45. package/dist/packages/build-plans/authoring/build-plan-improvement.d.ts +9 -6
  46. package/dist/packages/build-plans/authoring/build-plan-improvement.js +97 -46
  47. package/dist/packages/build-plans/authoring/lib/build-plan-edit-utils.d.ts +1 -0
  48. package/dist/packages/build-plans/authoring/lib/build-plan-edit-utils.js +7 -7
  49. package/dist/packages/build-plans/build-plan-resolution.d.ts +1 -1
  50. package/dist/packages/build-plans/build-plan-resolution.js +3 -3
  51. package/dist/packages/build-plans/index.d.ts +1 -1
  52. package/dist/packages/build-plans/index.js +1 -1
  53. package/dist/packages/build-plans/package/build-plan-definitions.d.ts +14 -13
  54. package/dist/packages/build-plans/package/build-plan-definitions.js +45 -42
  55. package/dist/packages/build-plans/package/build-plan-helpers.d.ts +3 -2
  56. package/dist/packages/build-plans/package/build-plan-helpers.js +27 -13
  57. package/dist/packages/build-plans/package/build-plan-review-paths.d.ts +5 -5
  58. package/dist/packages/build-plans/package/build-plan-review-paths.js +15 -15
  59. package/dist/packages/build-plans/package/build-plan-stage-runner.d.ts +5 -4
  60. package/dist/packages/build-plans/package/build-plan-stage-runner.js +23 -11
  61. package/dist/packages/build-plans/package/builtin-build-plan.d.ts +7 -8
  62. package/dist/packages/build-plans/package/builtin-build-plan.js +10 -11
  63. package/dist/packages/build-plans/package/context-interface.d.ts +14 -9
  64. package/dist/packages/build-plans/package/context-interface.js +14 -33
  65. package/dist/packages/build-plans/package/interf-build-plan-package.d.ts +6 -17
  66. package/dist/packages/build-plans/package/interf-build-plan-package.js +68 -64
  67. package/dist/packages/build-plans/package/local-build-plans.d.ts +21 -14
  68. package/dist/packages/build-plans/package/local-build-plans.js +105 -55
  69. package/dist/packages/build-plans/package/user-build-plans.js +1 -1
  70. package/dist/packages/contracts/index.d.ts +5 -2
  71. package/dist/packages/contracts/index.js +3 -1
  72. package/dist/packages/contracts/lib/context-graph-layer.d.ts +161 -0
  73. package/dist/packages/contracts/lib/context-graph-layer.js +216 -0
  74. package/dist/packages/contracts/lib/project-paths.d.ts +144 -0
  75. package/dist/packages/contracts/lib/project-paths.js +220 -0
  76. package/dist/packages/contracts/lib/project-schema.d.ts +423 -0
  77. package/dist/packages/contracts/lib/project-schema.js +138 -0
  78. package/dist/packages/contracts/lib/schema.d.ts +1273 -81
  79. package/dist/packages/contracts/lib/schema.js +675 -79
  80. package/dist/packages/contracts/utils/filesystem.d.ts +1 -0
  81. package/dist/packages/contracts/utils/filesystem.js +29 -1
  82. package/dist/packages/contracts/utils/parse.js +67 -0
  83. package/dist/packages/projects/index.d.ts +6 -0
  84. package/dist/packages/{project → projects}/index.js +0 -3
  85. package/dist/packages/{project → projects}/interf-detect.d.ts +12 -12
  86. package/dist/packages/{project → projects}/interf-detect.js +56 -50
  87. package/dist/packages/projects/interf.d.ts +2 -0
  88. package/dist/packages/projects/interf.js +1 -0
  89. package/dist/packages/projects/lib/schema.d.ts +77 -0
  90. package/dist/packages/projects/lib/schema.js +91 -0
  91. package/dist/packages/projects/source-config.d.ts +53 -0
  92. package/dist/packages/projects/source-config.js +339 -0
  93. package/dist/packages/projects/source-folders.d.ts +11 -0
  94. package/dist/packages/{project → projects}/source-folders.js +26 -26
  95. package/dist/packages/{engine → runtime}/action-planner.d.ts +1 -1
  96. package/dist/packages/{engine → runtime}/action-planner.js +20 -22
  97. package/dist/packages/runtime/action-values.d.ts +1 -0
  98. package/dist/packages/runtime/action-values.js +1 -0
  99. package/dist/packages/runtime/actions/errors.d.ts +2 -0
  100. package/dist/packages/runtime/actions/errors.js +12 -0
  101. package/dist/packages/runtime/actions/fields.d.ts +86 -0
  102. package/dist/packages/runtime/actions/form-builders.d.ts +14 -0
  103. package/dist/packages/runtime/actions/form-builders.js +667 -0
  104. package/dist/packages/runtime/actions/form-validators.d.ts +8 -0
  105. package/dist/packages/runtime/actions/form-validators.js +134 -0
  106. package/dist/packages/runtime/actions/helpers.d.ts +11 -0
  107. package/dist/packages/runtime/actions/helpers.js +80 -0
  108. package/dist/packages/runtime/actions/index.d.ts +8 -0
  109. package/dist/packages/runtime/actions/index.js +11 -0
  110. package/dist/packages/runtime/actions/registry.d.ts +64 -0
  111. package/dist/packages/runtime/actions/registry.js +62 -0
  112. package/dist/packages/runtime/actions/requests.d.ts +45 -0
  113. package/dist/packages/runtime/actions/requests.js +164 -0
  114. package/dist/packages/runtime/actions/schemas.d.ts +161 -0
  115. package/dist/packages/runtime/actions/schemas.js +37 -0
  116. package/dist/packages/runtime/agent-handoff.d.ts +11 -0
  117. package/dist/packages/runtime/agent-handoff.js +102 -0
  118. package/dist/packages/{engine → runtime}/agents/index.d.ts +1 -2
  119. package/dist/packages/{engine → runtime}/agents/index.js +1 -2
  120. package/dist/packages/runtime/agents/lib/args.d.ts +14 -0
  121. package/dist/packages/runtime/agents/lib/args.js +24 -0
  122. package/dist/packages/{engine → runtime}/agents/lib/constants.d.ts +4 -1
  123. package/dist/packages/runtime/agents/lib/constants.js +13 -0
  124. package/dist/packages/runtime/agents/lib/context-graph-bootstrap.d.ts +3 -0
  125. package/dist/packages/{engine/agents/lib/verifiable-context-bootstrap.js → runtime/agents/lib/context-graph-bootstrap.js} +5 -6
  126. package/dist/packages/{engine → runtime}/agents/lib/detection.d.ts +5 -0
  127. package/dist/packages/{engine → runtime}/agents/lib/detection.js +16 -7
  128. package/dist/packages/{engine → runtime}/agents/lib/execution-profile.d.ts +14 -0
  129. package/dist/packages/{engine → runtime}/agents/lib/execution-profile.js +31 -14
  130. package/dist/packages/{engine → runtime}/agents/lib/execution.js +22 -6
  131. package/dist/packages/{engine → runtime}/agents/lib/executors.d.ts +1 -0
  132. package/dist/packages/{engine → runtime}/agents/lib/executors.js +11 -2
  133. package/dist/packages/runtime/agents/lib/logs.d.ts +12 -0
  134. package/dist/packages/runtime/agents/lib/logs.js +41 -0
  135. package/dist/packages/{engine → runtime}/agents/lib/preflight.js +19 -14
  136. package/dist/packages/runtime/agents/lib/render.d.ts +26 -0
  137. package/dist/packages/{engine → runtime}/agents/lib/render.js +48 -22
  138. package/dist/packages/runtime/agents/lib/shell-fs.d.ts +18 -0
  139. package/dist/packages/runtime/agents/lib/shell-fs.js +190 -0
  140. package/dist/packages/runtime/agents/lib/shell-paths.d.ts +16 -0
  141. package/dist/packages/runtime/agents/lib/shell-paths.js +63 -0
  142. package/dist/packages/runtime/agents/lib/shell-projection.d.ts +25 -0
  143. package/dist/packages/runtime/agents/lib/shell-projection.js +314 -0
  144. package/dist/packages/runtime/agents/lib/shell-templates.d.ts +30 -0
  145. package/dist/packages/runtime/agents/lib/shell-templates.js +494 -0
  146. package/dist/packages/runtime/agents/lib/shell-workspace.d.ts +17 -0
  147. package/dist/packages/runtime/agents/lib/shell-workspace.js +70 -0
  148. package/dist/packages/runtime/agents/lib/shells.d.ts +92 -0
  149. package/dist/packages/runtime/agents/lib/shells.js +509 -0
  150. package/dist/packages/runtime/agents/lib/source-context-scan.d.ts +10 -0
  151. package/dist/packages/runtime/agents/lib/source-context-scan.js +388 -0
  152. package/dist/packages/{engine → runtime}/agents/lib/status.js +1 -14
  153. package/dist/packages/runtime/agents/lib/string-utils.d.ts +16 -0
  154. package/dist/packages/runtime/agents/lib/string-utils.js +36 -0
  155. package/dist/packages/{engine → runtime}/agents/lib/types.d.ts +1 -0
  156. package/dist/packages/{engine → runtime}/agents/lib/user-config.d.ts +8 -2
  157. package/dist/packages/{engine → runtime}/agents/lib/user-config.js +8 -2
  158. package/dist/packages/runtime/agents/providers/claude-code.d.ts +13 -0
  159. package/dist/packages/runtime/agents/providers/claude-code.js +45 -0
  160. package/dist/packages/runtime/agents/providers/codex.d.ts +17 -0
  161. package/dist/packages/runtime/agents/providers/codex.js +66 -0
  162. package/dist/packages/runtime/agents/providers/cursor.d.ts +9 -0
  163. package/dist/packages/runtime/agents/providers/cursor.js +24 -0
  164. package/dist/packages/runtime/agents/providers/index.d.ts +9 -0
  165. package/dist/packages/runtime/agents/providers/index.js +31 -0
  166. package/dist/packages/runtime/agents/providers/types.d.ts +50 -0
  167. package/dist/packages/{engine → runtime}/agents/registry.d.ts +13 -2
  168. package/dist/packages/{engine → runtime}/agents/registry.js +48 -10
  169. package/dist/packages/{engine → runtime}/agents/role-executors.d.ts +1 -1
  170. package/dist/packages/{engine → runtime}/agents/role-executors.js +9 -7
  171. package/dist/packages/{engine → runtime}/agents/role-router.js +7 -5
  172. package/dist/packages/runtime/auth/account-context.d.ts +52 -0
  173. package/dist/packages/runtime/auth/account-context.js +68 -0
  174. package/dist/packages/runtime/auth/auth-flow.d.ts +73 -0
  175. package/dist/packages/runtime/auth/auth-flow.js +189 -0
  176. package/dist/packages/runtime/auth/jwt-validator.d.ts +58 -0
  177. package/dist/packages/runtime/auth/jwt-validator.js +86 -0
  178. package/dist/packages/runtime/auth/keychain.d.ts +35 -0
  179. package/dist/packages/runtime/auth/keychain.js +85 -0
  180. package/dist/packages/runtime/auth/session-store.d.ts +38 -0
  181. package/dist/packages/runtime/auth/session-store.js +96 -0
  182. package/dist/packages/runtime/auth/workos-client.d.ts +58 -0
  183. package/dist/packages/runtime/auth/workos-client.js +87 -0
  184. package/dist/packages/runtime/benchmark-question-draft.d.ts +23 -0
  185. package/dist/packages/runtime/benchmark-question-draft.js +153 -0
  186. package/dist/packages/runtime/build/artifact-counts.d.ts +1 -0
  187. package/dist/packages/{engine → runtime}/build/artifact-counts.js +5 -9
  188. package/dist/packages/{engine → runtime}/build/artifact-status.d.ts +6 -6
  189. package/dist/packages/{engine → runtime}/build/artifact-status.js +26 -24
  190. package/dist/packages/runtime/build/atomic-fs.d.ts +3 -0
  191. package/dist/packages/runtime/build/atomic-fs.js +95 -0
  192. package/dist/packages/runtime/build/billing-events.d.ts +78 -0
  193. package/dist/packages/{engine → runtime}/build/billing-events.js +17 -19
  194. package/dist/packages/runtime/build/build-evidence.d.ts +16 -0
  195. package/dist/packages/runtime/build/build-evidence.js +179 -0
  196. package/dist/packages/{engine → runtime}/build/build-pipeline.d.ts +12 -8
  197. package/dist/packages/runtime/build/build-pipeline.js +388 -0
  198. package/dist/packages/{engine → runtime}/build/build-plan-primitives.d.ts +1 -1
  199. package/dist/packages/{engine → runtime}/build/build-plan-primitives.js +0 -1
  200. package/dist/packages/runtime/build/build-plan-runs.d.ts +14 -0
  201. package/dist/packages/runtime/build/build-plan-runs.js +31 -0
  202. package/dist/packages/runtime/build/build-stage-plan.d.ts +16 -0
  203. package/dist/packages/runtime/build/build-stage-plan.js +101 -0
  204. package/dist/packages/{engine → runtime}/build/build-stage-runner.d.ts +2 -1
  205. package/dist/packages/runtime/build/build-stage-runner.js +302 -0
  206. package/dist/packages/{engine → runtime}/build/build-target.d.ts +7 -4
  207. package/dist/packages/runtime/build/build-target.js +40 -0
  208. package/dist/packages/{engine → runtime}/build/check-evaluator.d.ts +14 -16
  209. package/dist/packages/runtime/build/check-evaluator.js +1226 -0
  210. package/dist/packages/runtime/build/context-graph-paths.d.ts +64 -0
  211. package/dist/packages/runtime/build/context-graph-paths.js +160 -0
  212. package/dist/packages/runtime/build/context-graph-schema.d.ts +19 -0
  213. package/dist/packages/runtime/build/context-graph-schema.js +39 -0
  214. package/dist/packages/{engine → runtime}/build/discovery.d.ts +2 -2
  215. package/dist/packages/{engine → runtime}/build/discovery.js +4 -4
  216. package/dist/packages/{engine → runtime}/build/index.d.ts +7 -5
  217. package/dist/packages/{engine → runtime}/build/index.js +7 -5
  218. package/dist/packages/runtime/build/inspect-map.d.ts +10 -0
  219. package/dist/packages/runtime/build/inspect-map.js +270 -0
  220. package/dist/packages/{engine → runtime}/build/lib/schema.d.ts +449 -123
  221. package/dist/packages/runtime/build/lib/schema.js +494 -0
  222. package/dist/packages/runtime/build/native-entrypoint.d.ts +2 -0
  223. package/dist/packages/runtime/build/native-entrypoint.js +286 -0
  224. package/dist/packages/runtime/build/reset.d.ts +2 -0
  225. package/dist/packages/runtime/build/reset.js +62 -0
  226. package/dist/packages/{engine → runtime}/build/runtime-contracts.js +13 -7
  227. package/dist/packages/runtime/build/runtime-inventory.d.ts +7 -0
  228. package/dist/packages/{engine → runtime}/build/runtime-inventory.js +3 -3
  229. package/dist/packages/runtime/build/runtime-log-paths.d.ts +3 -0
  230. package/dist/packages/runtime/build/runtime-log-paths.js +16 -0
  231. package/dist/packages/{engine → runtime}/build/runtime-prompt.js +12 -9
  232. package/dist/packages/{engine → runtime}/build/runtime-reconcile.d.ts +1 -1
  233. package/dist/packages/{engine → runtime}/build/runtime-reconcile.js +25 -21
  234. package/dist/packages/runtime/build/runtime-runs.d.ts +10 -0
  235. package/dist/packages/runtime/build/runtime-runs.js +318 -0
  236. package/dist/packages/{engine → runtime}/build/runtime-types.d.ts +9 -6
  237. package/dist/packages/runtime/build/runtime-types.js +1 -0
  238. package/dist/packages/runtime/build/runtime.d.ts +8 -0
  239. package/dist/packages/runtime/build/runtime.js +7 -0
  240. package/dist/packages/runtime/build/source-files.d.ts +58 -0
  241. package/dist/packages/runtime/build/source-files.js +193 -0
  242. package/dist/packages/runtime/build/source-inventory.d.ts +28 -0
  243. package/dist/packages/runtime/build/source-inventory.js +512 -0
  244. package/dist/packages/runtime/build/source-manifest.d.ts +63 -0
  245. package/dist/packages/runtime/build/source-manifest.js +220 -0
  246. package/dist/packages/runtime/build/stage-evidence.d.ts +22 -0
  247. package/dist/packages/runtime/build/stage-evidence.js +386 -0
  248. package/dist/packages/runtime/build/stage-manifest.d.ts +45 -0
  249. package/dist/packages/runtime/build/stage-manifest.js +1125 -0
  250. package/dist/packages/runtime/build/stage-reuse.d.ts +11 -0
  251. package/dist/packages/runtime/build/stage-reuse.js +154 -0
  252. package/dist/packages/runtime/build/stage-session.d.ts +81 -0
  253. package/dist/packages/runtime/build/stage-session.js +308 -0
  254. package/dist/packages/runtime/build/state-artifacts.d.ts +9 -0
  255. package/dist/packages/runtime/build/state-artifacts.js +14 -0
  256. package/dist/packages/runtime/build/state-health.d.ts +4 -0
  257. package/dist/packages/{engine → runtime}/build/state-health.js +21 -26
  258. package/dist/packages/runtime/build/state-io.d.ts +12 -0
  259. package/dist/packages/runtime/build/state-io.js +118 -0
  260. package/dist/packages/runtime/build/state-view.d.ts +5 -0
  261. package/dist/packages/runtime/build/state-view.js +121 -0
  262. package/dist/packages/runtime/build/state.d.ts +7 -0
  263. package/dist/packages/runtime/build/state.js +12 -0
  264. package/dist/packages/runtime/build/summary-coverage-index.d.ts +21 -0
  265. package/dist/packages/runtime/build/summary-coverage-index.js +189 -0
  266. package/dist/packages/runtime/build/traces.d.ts +30 -0
  267. package/dist/packages/runtime/build/traces.js +133 -0
  268. package/dist/packages/{engine/build/validate-verifiable-context.d.ts → runtime/build/validate-context-graph.d.ts} +6 -6
  269. package/dist/packages/{engine/build/validate-verifiable-context.js → runtime/build/validate-context-graph.js} +49 -36
  270. package/dist/packages/{engine → runtime}/build/validate.d.ts +5 -5
  271. package/dist/packages/{engine → runtime}/build/validate.js +26 -26
  272. package/dist/packages/{engine → runtime}/client.d.ts +18 -18
  273. package/dist/packages/{engine → runtime}/client.js +48 -36
  274. package/dist/packages/{engine → runtime}/connection-config.d.ts +3 -2
  275. package/dist/packages/{engine → runtime}/connection-config.js +9 -8
  276. package/dist/packages/runtime/context-checks.d.ts +10 -0
  277. package/dist/packages/runtime/context-checks.js +127 -0
  278. package/dist/packages/runtime/context-graph-scaffold.d.ts +9 -0
  279. package/dist/packages/runtime/context-graph-scaffold.js +135 -0
  280. package/dist/packages/runtime/context-graph-semantic-graph.d.ts +9 -0
  281. package/dist/packages/runtime/context-graph-semantic-graph.js +416 -0
  282. package/dist/packages/runtime/entitlement-guard.d.ts +43 -0
  283. package/dist/packages/runtime/entitlement-guard.js +70 -0
  284. package/dist/packages/{engine → runtime}/execution/index.d.ts +2 -2
  285. package/dist/packages/{engine → runtime}/execution/index.js +1 -1
  286. package/dist/packages/{engine → runtime}/execution/lib/schema.d.ts +272 -191
  287. package/dist/packages/{engine → runtime}/execution/lib/schema.js +35 -32
  288. package/dist/packages/runtime/index.d.ts +29 -0
  289. package/dist/packages/runtime/index.js +21 -0
  290. package/dist/packages/runtime/instance-paths.d.ts +30 -0
  291. package/dist/packages/runtime/instance-paths.js +29 -0
  292. package/dist/packages/runtime/native-run-handlers.d.ts +63 -0
  293. package/dist/packages/{engine → runtime}/native-run-handlers.js +217 -166
  294. package/dist/packages/runtime/plan-artifact-contract.d.ts +17 -0
  295. package/dist/packages/runtime/plan-artifact-contract.js +42 -0
  296. package/dist/packages/runtime/project-entries.d.ts +11 -0
  297. package/dist/packages/runtime/project-entries.js +49 -0
  298. package/dist/packages/runtime/project-source-state.d.ts +26 -0
  299. package/dist/packages/runtime/project-source-state.js +56 -0
  300. package/dist/packages/runtime/project-store.d.ts +90 -0
  301. package/dist/packages/runtime/project-store.js +195 -0
  302. package/dist/packages/runtime/requested-artifacts.d.ts +7 -0
  303. package/dist/packages/{engine → runtime}/requested-artifacts.js +23 -1
  304. package/dist/packages/{engine → runtime}/run-observability.d.ts +2 -1
  305. package/dist/packages/{engine → runtime}/run-observability.js +174 -87
  306. package/dist/packages/runtime/runtime-action-proposals.d.ts +7 -0
  307. package/dist/packages/runtime/runtime-action-proposals.js +542 -0
  308. package/dist/packages/runtime/runtime-build-plans.d.ts +5 -0
  309. package/dist/packages/runtime/runtime-build-plans.js +175 -0
  310. package/dist/packages/runtime/runtime-build-runs.d.ts +47 -0
  311. package/dist/packages/runtime/runtime-build-runs.js +555 -0
  312. package/dist/packages/runtime/runtime-caches.d.ts +117 -0
  313. package/dist/packages/runtime/runtime-caches.js +266 -0
  314. package/dist/packages/{engine → runtime}/runtime-event-applier.d.ts +3 -1
  315. package/dist/packages/{engine → runtime}/runtime-event-applier.js +53 -17
  316. package/dist/packages/runtime/runtime-executor.d.ts +22 -0
  317. package/dist/packages/runtime/runtime-executor.js +131 -0
  318. package/dist/packages/runtime/runtime-jobs.d.ts +13 -0
  319. package/dist/packages/runtime/runtime-jobs.js +463 -0
  320. package/dist/packages/runtime/runtime-observability.d.ts +11 -0
  321. package/dist/packages/runtime/runtime-observability.js +39 -0
  322. package/dist/packages/{engine → runtime}/runtime-persistence.d.ts +9 -18
  323. package/dist/packages/{engine → runtime}/runtime-persistence.js +25 -25
  324. package/dist/packages/runtime/runtime-project-mutations.d.ts +7 -0
  325. package/dist/packages/runtime/runtime-project-mutations.js +65 -0
  326. package/dist/packages/runtime/runtime-project-reads.d.ts +18 -0
  327. package/dist/packages/runtime/runtime-project-reads.js +574 -0
  328. package/dist/packages/runtime/runtime-proposal-helpers.d.ts +22 -0
  329. package/dist/packages/runtime/runtime-proposal-helpers.js +223 -0
  330. package/dist/packages/{engine → runtime}/runtime-resource-builders.d.ts +23 -16
  331. package/dist/packages/{engine → runtime}/runtime-resource-builders.js +58 -46
  332. package/dist/packages/runtime/runtime-status.d.ts +14 -0
  333. package/dist/packages/runtime/runtime-status.js +15 -0
  334. package/dist/packages/runtime/runtime-verify-runs.d.ts +84 -0
  335. package/dist/packages/runtime/runtime-verify-runs.js +296 -0
  336. package/dist/packages/runtime/runtime.d.ts +1582 -0
  337. package/dist/packages/runtime/runtime.js +431 -0
  338. package/dist/packages/runtime/schemas/actions.d.ts +1206 -0
  339. package/dist/packages/runtime/schemas/actions.js +117 -0
  340. package/dist/packages/runtime/schemas/agents.d.ts +104 -0
  341. package/dist/packages/runtime/schemas/agents.js +74 -0
  342. package/dist/packages/runtime/schemas/build-plans.d.ts +1132 -0
  343. package/dist/packages/runtime/schemas/build-plans.js +141 -0
  344. package/dist/packages/runtime/schemas/context-graphs.d.ts +1522 -0
  345. package/dist/packages/runtime/schemas/context-graphs.js +110 -0
  346. package/dist/packages/runtime/schemas/files.d.ts +227 -0
  347. package/dist/packages/runtime/schemas/files.js +28 -0
  348. package/dist/packages/runtime/schemas/index.d.ts +9 -0
  349. package/dist/packages/runtime/schemas/index.js +13 -0
  350. package/dist/packages/runtime/schemas/instance.d.ts +141 -0
  351. package/dist/packages/runtime/schemas/instance.js +143 -0
  352. package/dist/packages/runtime/schemas/jobs.d.ts +339 -0
  353. package/dist/packages/runtime/schemas/jobs.js +107 -0
  354. package/dist/packages/runtime/schemas/projects.d.ts +366 -0
  355. package/dist/packages/runtime/schemas/projects.js +160 -0
  356. package/dist/packages/runtime/schemas/runs.d.ts +3445 -0
  357. package/dist/packages/runtime/schemas/runs.js +115 -0
  358. package/dist/packages/runtime/service/index.d.ts +3 -0
  359. package/dist/packages/runtime/service/index.js +3 -0
  360. package/dist/packages/runtime/service/openapi.d.ts +7 -0
  361. package/dist/packages/runtime/service/openapi.js +118 -0
  362. package/dist/packages/runtime/service/operations.d.ts +3011 -0
  363. package/dist/packages/runtime/service/operations.js +375 -0
  364. package/dist/packages/runtime/service/routes.d.ts +114 -0
  365. package/dist/packages/runtime/service/routes.js +128 -0
  366. package/dist/packages/runtime/service/server-api-files.d.ts +10 -0
  367. package/dist/packages/runtime/service/server-api-files.js +85 -0
  368. package/dist/packages/runtime/service/server-app-boot.d.ts +4 -0
  369. package/dist/packages/runtime/service/server-app-boot.js +46 -0
  370. package/dist/packages/runtime/service/server-guards.d.ts +63 -0
  371. package/dist/packages/runtime/service/server-guards.js +181 -0
  372. package/dist/packages/runtime/service/server-helpers.d.ts +38 -0
  373. package/dist/packages/runtime/service/server-helpers.js +108 -0
  374. package/dist/packages/runtime/service/server-instance-helpers.d.ts +30 -0
  375. package/dist/packages/runtime/service/server-instance-helpers.js +114 -0
  376. package/dist/packages/runtime/service/server-routes-action-proposals.d.ts +3 -0
  377. package/dist/packages/runtime/service/server-routes-action-proposals.js +45 -0
  378. package/dist/packages/runtime/service/server-routes-agents.d.ts +4 -0
  379. package/dist/packages/runtime/service/server-routes-agents.js +132 -0
  380. package/dist/packages/runtime/service/server-routes-auth.d.ts +33 -0
  381. package/dist/packages/runtime/service/server-routes-auth.js +138 -0
  382. package/dist/packages/runtime/service/server-routes-build-plans.d.ts +3 -0
  383. package/dist/packages/runtime/service/server-routes-build-plans.js +86 -0
  384. package/dist/packages/runtime/service/server-routes-discovery.d.ts +4 -0
  385. package/dist/packages/runtime/service/server-routes-discovery.js +196 -0
  386. package/dist/packages/runtime/service/server-routes-events.d.ts +5 -0
  387. package/dist/packages/runtime/service/server-routes-events.js +99 -0
  388. package/dist/packages/runtime/service/server-routes-project-context.d.ts +9 -0
  389. package/dist/packages/runtime/service/server-routes-project-context.js +287 -0
  390. package/dist/packages/runtime/service/server-routes-project-jobs.d.ts +9 -0
  391. package/dist/packages/runtime/service/server-routes-project-jobs.js +137 -0
  392. package/dist/packages/runtime/service/server-routes-project-runs.d.ts +14 -0
  393. package/dist/packages/runtime/service/server-routes-project-runs.js +88 -0
  394. package/dist/packages/runtime/service/server-routes-projects.d.ts +4 -0
  395. package/dist/packages/runtime/service/server-routes-projects.js +96 -0
  396. package/dist/packages/runtime/service/server-routes-runs.d.ts +3 -0
  397. package/dist/packages/runtime/service/server-routes-runs.js +119 -0
  398. package/dist/packages/runtime/service/server.d.ts +37 -0
  399. package/dist/packages/runtime/service/server.js +300 -0
  400. package/dist/packages/{engine → runtime/service}/service-registry.d.ts +5 -5
  401. package/dist/packages/{engine → runtime/service}/service-registry.js +7 -7
  402. package/dist/packages/runtime/verify/benchmark-run.d.ts +81 -0
  403. package/dist/packages/runtime/verify/benchmark-run.js +303 -0
  404. package/dist/packages/{engine → runtime}/verify/index.d.ts +2 -2
  405. package/dist/packages/{engine → runtime}/verify/index.js +1 -1
  406. package/dist/packages/{engine → runtime}/verify/lib/schema.d.ts +83 -16
  407. package/dist/packages/{engine → runtime}/verify/lib/schema.js +38 -18
  408. package/dist/packages/runtime/verify/test-file-guard.d.ts +2 -0
  409. package/dist/packages/runtime/verify/test-file-guard.js +29 -0
  410. package/dist/packages/{engine → runtime}/verify/verify-execution.d.ts +7 -0
  411. package/dist/packages/{engine → runtime}/verify/verify-execution.js +119 -45
  412. package/dist/packages/{engine → runtime}/verify/verify-paths.d.ts +5 -4
  413. package/dist/packages/runtime/verify/verify-paths.js +65 -0
  414. package/dist/packages/{engine → runtime}/verify/verify-sandbox.d.ts +1 -1
  415. package/dist/packages/runtime/verify/verify-sandbox.js +88 -0
  416. package/dist/packages/{engine → runtime}/verify/verify-specs.d.ts +2 -0
  417. package/dist/packages/runtime/verify/verify-specs.js +126 -0
  418. package/dist/packages/runtime/verify/verify-targets.d.ts +5 -0
  419. package/dist/packages/{engine → runtime}/verify/verify-targets.js +12 -12
  420. package/dist/packages/runtime/verify/verify-types.js +1 -0
  421. package/dist/packages/{engine → runtime}/verify/verify.d.ts +1 -1
  422. package/dist/packages/{engine → runtime}/verify/verify.js +1 -1
  423. package/dist/packages/runtime/wire-schemas.d.ts +18 -0
  424. package/dist/packages/runtime/wire-schemas.js +27 -0
  425. package/package.json +32 -30
  426. package/public-repo/CONTRIBUTING.md +16 -18
  427. package/public-repo/README.md +119 -282
  428. package/public-repo/SECURITY.md +3 -4
  429. package/public-repo/build-plans/interf-default/README.md +24 -16
  430. package/public-repo/build-plans/interf-default/build/stages/entrypoint/SKILL.md +74 -0
  431. package/public-repo/build-plans/interf-default/build/stages/knowledge/SKILL.md +95 -0
  432. package/public-repo/build-plans/interf-default/build/stages/summarize/SKILL.md +49 -4
  433. package/public-repo/build-plans/interf-default/build-plan.json +49 -39
  434. package/public-repo/build-plans/interf-default/build-plan.schema.json +59 -33
  435. package/public-repo/build-plans/interf-default/improve/SKILL.md +3 -3
  436. package/public-repo/build-plans/interf-default/use/query/SKILL.md +18 -11
  437. package/public-repo/openapi/local-service.openapi.json +14227 -0
  438. package/public-repo/skills/interf/SKILL.md +508 -187
  439. package/dist/cli/commands/prep.d.ts +0 -2
  440. package/dist/cli/commands/prep.js +0 -240
  441. package/dist/cli/commands/test.d.ts +0 -10
  442. package/dist/cli/commands/test.js +0 -85
  443. package/dist/cli/commands/web.d.ts +0 -2
  444. package/dist/cli/commands/web.js +0 -286
  445. package/dist/interf-ui/404.html +0 -1
  446. package/dist/interf-ui/__next.__PAGE__.txt +0 -10
  447. package/dist/interf-ui/__next._full.txt +0 -20
  448. package/dist/interf-ui/__next._head.txt +0 -5
  449. package/dist/interf-ui/__next._index.txt +0 -5
  450. package/dist/interf-ui/__next._tree.txt +0 -5
  451. package/dist/interf-ui/_next/static/--reS3xBzM5zc6QxNjZd6/_buildManifest.js +0 -11
  452. package/dist/interf-ui/_next/static/--reS3xBzM5zc6QxNjZd6/_clientMiddlewareManifest.js +0 -1
  453. package/dist/interf-ui/_next/static/--reS3xBzM5zc6QxNjZd6/_ssgManifest.js +0 -1
  454. package/dist/interf-ui/_next/static/chunks/0.tjb6f4golw..css +0 -3
  455. package/dist/interf-ui/_next/static/chunks/03~yq9q893hmn.js +0 -1
  456. package/dist/interf-ui/_next/static/chunks/085-n_jv2ng_q.css +0 -1
  457. package/dist/interf-ui/_next/static/chunks/0dn41fa_zvgsl.js +0 -1
  458. package/dist/interf-ui/_next/static/chunks/0g-ea0zj5d-0k.js +0 -1
  459. package/dist/interf-ui/_next/static/chunks/0gwqglc4iz583.js +0 -1
  460. package/dist/interf-ui/_next/static/chunks/0haldgm65ve6l.js +0 -1
  461. package/dist/interf-ui/_next/static/chunks/0nv3am99vjzn4.js +0 -1
  462. package/dist/interf-ui/_next/static/chunks/0s77gt_o4jwtx.js +0 -1
  463. package/dist/interf-ui/_next/static/chunks/0y5z3t-z1c8ks.js.map +0 -5
  464. package/dist/interf-ui/_next/static/chunks/0~a36ujuzpaz..js +0 -116
  465. package/dist/interf-ui/_next/static/chunks/10jeodxe4nkgj.js +0 -31
  466. package/dist/interf-ui/_next/static/chunks/119h2rouych2t.js +0 -1
  467. package/dist/interf-ui/_next/static/chunks/13c8b~m8knjsf.js +0 -1
  468. package/dist/interf-ui/_next/static/chunks/14dznb2qpt-ho.js +0 -91
  469. package/dist/interf-ui/_next/static/chunks/15z_en80lrq-3.js +0 -5
  470. package/dist/interf-ui/_next/static/chunks/turbopack-0p.pvcjrtq-jh.js +0 -1
  471. package/dist/interf-ui/_next/static/chunks/turbopack-0usj_75.8frlw.js +0 -1
  472. package/dist/interf-ui/_next/static/chunks/turbopack-worker-0sjn--fhq~1cg.js +0 -1
  473. package/dist/interf-ui/_next/static/media/GeistMono_Variable.p.17jn9btb_52pq.woff2 +0 -0
  474. package/dist/interf-ui/_next/static/media/Geist_Variable-s.p.0-te~ja_gpvcf.woff2 +0 -0
  475. package/dist/interf-ui/_next/static/media/worker.102zas1s52_pf.js +0 -109
  476. package/dist/interf-ui/_not-found/__next._full.txt +0 -15
  477. package/dist/interf-ui/_not-found/__next._head.txt +0 -5
  478. package/dist/interf-ui/_not-found/__next._index.txt +0 -5
  479. package/dist/interf-ui/_not-found/__next._not-found.__PAGE__.txt +0 -5
  480. package/dist/interf-ui/_not-found/__next._not-found.txt +0 -5
  481. package/dist/interf-ui/_not-found/__next._tree.txt +0 -2
  482. package/dist/interf-ui/_not-found.html +0 -1
  483. package/dist/interf-ui/_not-found.txt +0 -15
  484. package/dist/interf-ui/index.html +0 -1
  485. package/dist/interf-ui/index.txt +0 -20
  486. package/dist/packages/contracts/lib/preparation-paths.d.ts +0 -117
  487. package/dist/packages/contracts/lib/preparation-paths.js +0 -177
  488. package/dist/packages/engine/action-definitions.d.ts +0 -407
  489. package/dist/packages/engine/action-definitions.js +0 -1158
  490. package/dist/packages/engine/action-values.d.ts +0 -1
  491. package/dist/packages/engine/action-values.js +0 -1
  492. package/dist/packages/engine/agents/lib/args.d.ts +0 -4
  493. package/dist/packages/engine/agents/lib/args.js +0 -52
  494. package/dist/packages/engine/agents/lib/chart-guidance.d.ts +0 -1
  495. package/dist/packages/engine/agents/lib/chart-guidance.js +0 -8
  496. package/dist/packages/engine/agents/lib/constants.js +0 -28
  497. package/dist/packages/engine/agents/lib/logs.d.ts +0 -2
  498. package/dist/packages/engine/agents/lib/logs.js +0 -17
  499. package/dist/packages/engine/agents/lib/render.d.ts +0 -8
  500. package/dist/packages/engine/agents/lib/schema.d.ts +0 -8
  501. package/dist/packages/engine/agents/lib/schema.js +0 -7
  502. package/dist/packages/engine/agents/lib/shells.d.ts +0 -74
  503. package/dist/packages/engine/agents/lib/shells.js +0 -1052
  504. package/dist/packages/engine/agents/lib/verifiable-context-bootstrap.d.ts +0 -3
  505. package/dist/packages/engine/build/artifact-counts.d.ts +0 -1
  506. package/dist/packages/engine/build/billing-events.d.ts +0 -89
  507. package/dist/packages/engine/build/build-pipeline.js +0 -175
  508. package/dist/packages/engine/build/build-plan-runs.d.ts +0 -14
  509. package/dist/packages/engine/build/build-plan-runs.js +0 -31
  510. package/dist/packages/engine/build/build-stage-plan.d.ts +0 -16
  511. package/dist/packages/engine/build/build-stage-plan.js +0 -100
  512. package/dist/packages/engine/build/build-stage-runner.js +0 -94
  513. package/dist/packages/engine/build/build-target.js +0 -16
  514. package/dist/packages/engine/build/check-evaluator.js +0 -298
  515. package/dist/packages/engine/build/lib/schema.js +0 -316
  516. package/dist/packages/engine/build/reset.d.ts +0 -2
  517. package/dist/packages/engine/build/reset.js +0 -74
  518. package/dist/packages/engine/build/runtime-inventory.d.ts +0 -7
  519. package/dist/packages/engine/build/runtime-paths.d.ts +0 -8
  520. package/dist/packages/engine/build/runtime-paths.js +0 -26
  521. package/dist/packages/engine/build/runtime-runs.d.ts +0 -10
  522. package/dist/packages/engine/build/runtime-runs.js +0 -224
  523. package/dist/packages/engine/build/runtime.d.ts +0 -5
  524. package/dist/packages/engine/build/runtime.js +0 -4
  525. package/dist/packages/engine/build/source-files.d.ts +0 -46
  526. package/dist/packages/engine/build/source-files.js +0 -149
  527. package/dist/packages/engine/build/state-artifacts.d.ts +0 -9
  528. package/dist/packages/engine/build/state-artifacts.js +0 -14
  529. package/dist/packages/engine/build/state-health.d.ts +0 -4
  530. package/dist/packages/engine/build/state-io.d.ts +0 -11
  531. package/dist/packages/engine/build/state-io.js +0 -82
  532. package/dist/packages/engine/build/state-paths.d.ts +0 -5
  533. package/dist/packages/engine/build/state-paths.js +0 -16
  534. package/dist/packages/engine/build/state-view.d.ts +0 -5
  535. package/dist/packages/engine/build/state-view.js +0 -94
  536. package/dist/packages/engine/build/state.d.ts +0 -7
  537. package/dist/packages/engine/build/state.js +0 -12
  538. package/dist/packages/engine/build/validate-helpers.d.ts +0 -12
  539. package/dist/packages/engine/build/validate-helpers.js +0 -41
  540. package/dist/packages/engine/build/verifiable-context-paths.d.ts +0 -47
  541. package/dist/packages/engine/build/verifiable-context-paths.js +0 -121
  542. package/dist/packages/engine/build/verifiable-context-schema.d.ts +0 -21
  543. package/dist/packages/engine/build/verifiable-context-schema.js +0 -126
  544. package/dist/packages/engine/cloud-seams.d.ts +0 -115
  545. package/dist/packages/engine/cloud-seams.js +0 -84
  546. package/dist/packages/engine/index.d.ts +0 -22
  547. package/dist/packages/engine/index.js +0 -15
  548. package/dist/packages/engine/instance-paths.d.ts +0 -106
  549. package/dist/packages/engine/instance-paths.js +0 -171
  550. package/dist/packages/engine/lib/schema.d.ts +0 -6304
  551. package/dist/packages/engine/lib/schema.js +0 -730
  552. package/dist/packages/engine/native-run-handlers.d.ts +0 -25
  553. package/dist/packages/engine/preparation-store.d.ts +0 -105
  554. package/dist/packages/engine/preparation-store.js +0 -213
  555. package/dist/packages/engine/readiness-check-draft.d.ts +0 -20
  556. package/dist/packages/engine/readiness-check-draft.js +0 -111
  557. package/dist/packages/engine/requested-artifacts.d.ts +0 -5
  558. package/dist/packages/engine/routes.d.ts +0 -85
  559. package/dist/packages/engine/routes.js +0 -99
  560. package/dist/packages/engine/runtime-caches.d.ts +0 -76
  561. package/dist/packages/engine/runtime-caches.js +0 -191
  562. package/dist/packages/engine/runtime-proposal-helpers.d.ts +0 -35
  563. package/dist/packages/engine/runtime-proposal-helpers.js +0 -247
  564. package/dist/packages/engine/runtime.d.ts +0 -371
  565. package/dist/packages/engine/runtime.js +0 -2463
  566. package/dist/packages/engine/server.d.ts +0 -58
  567. package/dist/packages/engine/server.js +0 -1399
  568. package/dist/packages/engine/verify/readiness-check-run.d.ts +0 -82
  569. package/dist/packages/engine/verify/readiness-check-run.js +0 -265
  570. package/dist/packages/engine/verify/verify-paths.js +0 -61
  571. package/dist/packages/engine/verify/verify-sandbox.js +0 -88
  572. package/dist/packages/engine/verify/verify-specs.js +0 -114
  573. package/dist/packages/engine/verify/verify-targets.d.ts +0 -5
  574. package/dist/packages/engine/wire-schemas.d.ts +0 -547
  575. package/dist/packages/engine/wire-schemas.js +0 -59
  576. package/dist/packages/project/index.d.ts +0 -9
  577. package/dist/packages/project/interf-bootstrap.d.ts +0 -1
  578. package/dist/packages/project/interf-bootstrap.js +0 -1
  579. package/dist/packages/project/interf-scaffold.d.ts +0 -3
  580. package/dist/packages/project/interf-scaffold.js +0 -136
  581. package/dist/packages/project/interf.d.ts +0 -4
  582. package/dist/packages/project/interf.js +0 -3
  583. package/dist/packages/project/lib/schema.d.ts +0 -328
  584. package/dist/packages/project/lib/schema.js +0 -136
  585. package/dist/packages/project/preparation-entries.d.ts +0 -11
  586. package/dist/packages/project/preparation-entries.js +0 -49
  587. package/dist/packages/project/source-config.d.ts +0 -46
  588. package/dist/packages/project/source-config.js +0 -394
  589. package/dist/packages/project/source-folders.d.ts +0 -11
  590. package/public-repo/build-plans/interf-default/build/stages/shape/SKILL.md +0 -27
  591. package/public-repo/build-plans/interf-default/build/stages/structure/SKILL.md +0 -21
  592. package/public-repo/plugins/README.md +0 -9
  593. package/public-repo/plugins/interf/.claude-plugin/plugin.json +0 -21
  594. package/public-repo/plugins/interf/.mcp.json +0 -12
  595. package/public-repo/plugins/interf/README.md +0 -32
  596. package/public-repo/plugins/interf/skills/interf/SKILL.md +0 -376
  597. /package/dist/packages/{engine/agents/lib/types.js → runtime/actions/fields.js} +0 -0
  598. /package/dist/packages/{engine → runtime}/agents/lib/agents.d.ts +0 -0
  599. /package/dist/packages/{engine → runtime}/agents/lib/agents.js +0 -0
  600. /package/dist/packages/{engine → runtime}/agents/lib/execution.d.ts +0 -0
  601. /package/dist/packages/{engine → runtime}/agents/lib/preflight.d.ts +0 -0
  602. /package/dist/packages/{engine → runtime}/agents/lib/status.d.ts +0 -0
  603. /package/dist/packages/{engine/build/runtime-types.js → runtime/agents/lib/types.js} +0 -0
  604. /package/dist/packages/{engine/verify/verify-types.js → runtime/agents/providers/types.js} +0 -0
  605. /package/dist/packages/{engine → runtime}/agents/role-router.d.ts +0 -0
  606. /package/dist/packages/{engine → runtime}/build/build-execution.d.ts +0 -0
  607. /package/dist/packages/{engine → runtime}/build/build-execution.js +0 -0
  608. /package/dist/packages/{engine → runtime}/build/runtime-contracts.d.ts +0 -0
  609. /package/dist/packages/{engine → runtime}/build/runtime-prompt.d.ts +0 -0
  610. /package/dist/packages/{engine → runtime}/execution/adapters.d.ts +0 -0
  611. /package/dist/packages/{engine → runtime}/execution/adapters.js +0 -0
  612. /package/dist/packages/{engine → runtime}/execution/events.d.ts +0 -0
  613. /package/dist/packages/{engine → runtime}/execution/events.js +0 -0
  614. /package/dist/packages/{engine → runtime}/verify/verify-profile-presets.d.ts +0 -0
  615. /package/dist/packages/{engine → runtime}/verify/verify-profile-presets.js +0 -0
  616. /package/dist/packages/{engine → runtime}/verify/verify-types.d.ts +0 -0
@@ -0,0 +1,494 @@
1
+ import { z } from "zod";
2
+ import { BUILD_PLAN_ARTIFACT_KINDS, } from "../build-plan-primitives.js";
3
+ import { ArtifactIdSchema, ArtifactSchema, CheckSchema, ProjectIntentSchema, ProjectIdSchema, RuntimeContractTypeSchema, RuntimeExecutorInfoSchema, RuntimeStageSchema, RuntimeTargetTypeSchema, StageEvidenceCountSchema, StageEvidenceEdgeSchema, StageEvidenceItemSchema, SourceBuildMaxAttemptsSchema, SourceBuildMaxLoopsSchema, InterfIdPattern, BuildPlanIdSchema, isInterfRelativePath, } from "../../../contracts/lib/schema.js";
4
+ // `ArtifactSchema` is used internally below in `BuildPlanContextRawSchema`'s
5
+ // `artifacts[]` field. The other Artifact* schemas/types are NOT
6
+ // re-exported through this module — callers import them directly from
7
+ // `contracts/lib/schema.js`. Re-exports with zero consumers were pruned
8
+ // to keep this barrel narrow.
9
+ export { GateStatusSchema, ProjectIntentSchema, ReadinessGateSchema, ReadinessSchema, ReadinessStatusSchema, VerifyTargetResultSchema, RuntimeContractTypeSchema, RuntimeExecutorInfoSchema, RuntimeStageSchema, RuntimeTargetTypeSchema, SourceFilesSchema, SourceFileSchema, SourceKindSchema, SourceManifestAuditSchema, SourceManifestEvidenceSchema, SourceManifestFileKindSchema, SourceManifestFileSchema, SourceManifestScannerSchema, SourceManifestSchema, SourceInspectableUnitSchema, SourceSchema, SourceStateSchema, StageInputSchema, StageInputsSchema, StageEvidenceCountSchema, StageEvidenceEdgeSchema, StageEvidenceItemSchema, GraphManifestSchema, GraphManifestStageSummarySchema, GraphOutputCountsSchema, GraphReadinessRollupSchema, MetricCountSchema, MissingInputSchema, ResourceRefSchema, ResourceRoleSchema, ReviewedInputDecisionSchema, ReviewedInputSchema, StageManifestSchema, SourceBuildMaxAttemptsSchema, SourceBuildMaxLoopsSchema, TestCaseExpectSchema, TestTargetTypeSchema, InterfIdPattern, BuildPlanIdSchema, } from "../../../contracts/lib/schema.js";
10
+ import { BuildPlanContextCheckDraftSchema, } from "../../../build-plans/authoring/brief.js";
11
+ const JsonRecordSchema = z.record(z.string(), z.unknown());
12
+ // Lifecycle status of a built Context Graph as reported by `health.json`.
13
+ // Defined once here and reused inside `ContextGraphHealthSchema.status` so the
14
+ // `RuntimeStatus` type can never drift from the schema that validates the file.
15
+ export const RuntimeStatusSchema = z.enum(["idle", "running", "built", "stale", "failed"]);
16
+ // Which stage `health.json` reports: a terminal pseudo-stage
17
+ // (`idle`/`built`/`failed`) or a concrete Build Plan stage id. This is the
18
+ // SAME union used at `ContextGraphHealthSchema.stage`; the type is inferred
19
+ // from it so the inline alias no longer widens to a bare `string`.
20
+ export const BuildStageSchema = z.union([
21
+ z.enum(["idle", "built", "failed"]),
22
+ RuntimeStageSchema,
23
+ ]);
24
+ // Status of one agent-run execution (a stage session and the run-scoped
25
+ // ledger that records it). Single source for both `StageExecutionSessionSchema`
26
+ // and `ExecutionStageLedgerSchema` so the two records can never disagree.
27
+ export const ExecutionStatusSchema = z.enum(["running", "succeeded", "failed"]);
28
+ export const BuildPlanArtifactIdSchema = z.string().regex(InterfIdPattern);
29
+ export const BuildPlanArtifactKindSchema = z.enum(BUILD_PLAN_ARTIFACT_KINDS);
30
+ export const BuildPlanArtifactRoleSchema = z.literal("output");
31
+ export const BuildStageStatusSchema = z.enum(["idle", "running", "succeeded", "failed"]);
32
+ export const StageFingerprintSchema = z.string().regex(/^[a-f0-9]{64}$/);
33
+ export const ContextGraphStageStateSchema = z.object({
34
+ contract_type: RuntimeContractTypeSchema.optional(),
35
+ status: BuildStageStatusSchema.optional(),
36
+ fingerprint: StageFingerprintSchema.optional(),
37
+ started_at: z.string().nullable().optional(),
38
+ finished_at: z.string().nullable().optional(),
39
+ counts: z.record(z.string(), z.number()).optional(),
40
+ artifact_counts: z.record(z.string(), z.number()).optional(),
41
+ artifacts: z.array(z.string()).optional(),
42
+ summary: z.string().nullable().optional(),
43
+ run_id: z.string().nullable().optional(),
44
+ });
45
+ export const ContextGraphStateSchema = z.object({
46
+ version: z.number().int().min(1),
47
+ pending: z.array(z.string()),
48
+ stages: z.record(z.string().regex(InterfIdPattern), ContextGraphStageStateSchema).optional(),
49
+ last_add: z.string().nullable().optional(),
50
+ last_build: z.string().nullable().optional(),
51
+ warning_count: z.number().optional(),
52
+ error_count: z.number().optional(),
53
+ }).strict();
54
+ // A view-spec section, discriminated on `type` so each variant declares its
55
+ // own path contract instead of one object where both `path?` and `paths?` are
56
+ // always optional. The producer is `buildDefaultContextGraphViewSpec`
57
+ // (state-view.ts): `status`/`cards` carry a single source `path`; `documents`
58
+ // carries a `paths` list. `flow`/`table` have no producer yet, so their path
59
+ // contract is genuinely unknown — both fields stay optional for those two
60
+ // rather than guessing a shape no caller has committed to.
61
+ const ViewSectionBaseFields = {
62
+ id: z.string(),
63
+ title: z.string(),
64
+ };
65
+ export const ViewSectionSchema = z.discriminatedUnion("type", [
66
+ z.object({ ...ViewSectionBaseFields, type: z.literal("status"), path: z.string() }),
67
+ z.object({ ...ViewSectionBaseFields, type: z.literal("cards"), path: z.string() }),
68
+ z.object({ ...ViewSectionBaseFields, type: z.literal("documents"), paths: z.array(z.string()) }),
69
+ z.object({
70
+ ...ViewSectionBaseFields,
71
+ type: z.literal("flow"),
72
+ path: z.string().optional(),
73
+ paths: z.array(z.string()).optional(),
74
+ }),
75
+ z.object({
76
+ ...ViewSectionBaseFields,
77
+ type: z.literal("table"),
78
+ path: z.string().optional(),
79
+ paths: z.array(z.string()).optional(),
80
+ }),
81
+ ]);
82
+ export const ViewCardSchema = z.object({
83
+ id: z.string(),
84
+ label: z.string(),
85
+ metric: z.string(),
86
+ denominator_metric: z.string().optional(),
87
+ format: z.enum(["number", "fraction", "timestamp"]),
88
+ });
89
+ export const ContextGraphHealthSchema = z.object({
90
+ kind: z.literal("context-graph-health"),
91
+ version: z.number().int().min(1),
92
+ generated_at: z.string(),
93
+ target_name: z.string(),
94
+ status: RuntimeStatusSchema,
95
+ stage: BuildStageSchema,
96
+ summary: z.string(),
97
+ metrics: z.record(z.string(), z.number()),
98
+ checks: z.record(z.string(), z.boolean()),
99
+ });
100
+ export const ContextGraphViewSpecSchema = z.object({
101
+ kind: z.literal("context-graph-view-spec"),
102
+ version: z.number().int().min(1),
103
+ generated_at: z.string(),
104
+ target_name: z.string(),
105
+ health_source: z.string(),
106
+ state_source: z.string(),
107
+ default_note: z.string().nullable(),
108
+ document_scope: z.array(z.string()),
109
+ cards: z.array(ViewCardSchema),
110
+ sections: z.array(ViewSectionSchema),
111
+ });
112
+ export const BuildPlanPurposeSchema = z.object({
113
+ label: z.string().min(1),
114
+ task_hint: z.string().min(1),
115
+ }).strict();
116
+ /**
117
+ * Runtime projection of a single Build Plan artifact — the resolved
118
+ * shape stored in `.interf/build-plan/build-plan.json`. Distinct from
119
+ * the user-facing `Artifact` declaration in
120
+ * `contracts/lib/schema.ts` (which carries `shape`, `checks`, and
121
+ * `built_by_stages` at declaration time) and from `ArtifactRef` in
122
+ * `execution/lib/schema.ts` (the run-time event reference). One artifact
123
+ * passes through three lifecycle shapes: declared, projected, referenced.
124
+ */
125
+ export const BuildPlanArtifactSchema = z.object({
126
+ id: BuildPlanArtifactIdSchema,
127
+ role: BuildPlanArtifactRoleSchema,
128
+ path: z.string().min(1).refine(isInterfRelativePath, {
129
+ message: "Artifact paths must stay inside the context graph root",
130
+ }),
131
+ kind: BuildPlanArtifactKindSchema,
132
+ required: z.boolean(),
133
+ owned_by: z.array(z.string().regex(InterfIdPattern)),
134
+ description: z.string().min(1),
135
+ });
136
+ // Persisted schema for the Build Plan-defined artifact interface that one
137
+ // context graph must implement on disk.
138
+ export const BuildPlanContextRawSchema = z.object({
139
+ kind: z.literal("build-plan-schema"),
140
+ version: z.literal(1),
141
+ target_type: z.literal("context-graph"),
142
+ label: z.string().min(1),
143
+ artifacts: z.array(ArtifactSchema).min(1),
144
+ }).strict();
145
+ export const BuildPlanContextSchemaSchema = BuildPlanContextRawSchema;
146
+ export const BuildPlanRuntimeApiSchema = z.object({
147
+ kind: z.literal("build"),
148
+ version: z.literal(1),
149
+ });
150
+ export const BuildPlanStageArtifactReadAccessSchema = z.array(ArtifactIdSchema);
151
+ export const BuildPlanStageArtifactWriteAccessSchema = z.array(ArtifactIdSchema).min(1);
152
+ export const ExecutionShellArtifactMountSchema = z.object({
153
+ artifact_id: ArtifactIdSchema,
154
+ artifact_path: z.string(),
155
+ shell_root_path: z.string(),
156
+ input_mount_path: z.string().nullable(),
157
+ output_mount_path: z.string().nullable(),
158
+ });
159
+ export const ExecutionShellPathsSchema = z.object({
160
+ kind: z.literal("interf-execution-shell"),
161
+ version: z.literal(1),
162
+ build_plan: BuildPlanIdSchema,
163
+ stage: RuntimeStageSchema,
164
+ reads: z.array(ExecutionShellArtifactMountSchema),
165
+ writes: z.array(ExecutionShellArtifactMountSchema),
166
+ });
167
+ export const StageExecutionSessionValidationAttemptSchema = z.object({
168
+ attempt: z.number().int().min(1),
169
+ recorded_at: z.string().min(1),
170
+ status: z.enum(["succeeded", "failed"]),
171
+ summary: z.string().min(1),
172
+ }).strict();
173
+ /**
174
+ * Which kind of agent job a `StageExecutionSession` preserves. Every
175
+ * `executor.execute()` job that writes a graph-scoped session leaves the SAME
176
+ * inspectable session shape; `job_type` is the discriminator a reader keys off
177
+ * instead of inferring the job from coincidental fields. The default is `stage`
178
+ * so every existing writer/caller (a Build-Plan stage attempt inside a Context
179
+ * Graph) is unchanged. The stage-only fields (`stage_id`, `stage_label`,
180
+ * `contract_type`) stay populated for `stage`/`source-inventory` jobs.
181
+ *
182
+ * Only `stage` and `source-inventory` are ever produced by a session writer:
183
+ * `writeStageExecutionSessionStarted` defaults to `stage`, and source-inventory
184
+ * passes `jobType: "source-inventory"`. Graph-less jobs (Build Plan draft/
185
+ * improvement, benchmark-question drafting) record `LocalJobRun` instead — see
186
+ * `LocalJobTypeSchema` in `schemas/jobs.ts` — so their kinds never appear here.
187
+ *
188
+ * job_type -> preserved shell_type map (`PreservedShellTypeSchema` below):
189
+ * stage -> "stage-execution"
190
+ * source-inventory -> "stage-execution"
191
+ * The other `PreservedShellTypeSchema` members are driven by their own job
192
+ * substrate, NOT by an `AgentJobType`:
193
+ * build-plan-authoring <- LocalJobRun "build-plan-draft"
194
+ * build-plan-improvement <- LocalJobRun "build-plan-improvement"
195
+ * benchmark-question-draft <- LocalJobRun "benchmark-question-draft"
196
+ * test-judge <- the verify/judge path (verify-execution.ts),
197
+ * which is not an AgentJobType at all.
198
+ */
199
+ export const AgentJobTypeSchema = z.enum([
200
+ "stage",
201
+ "source-inventory",
202
+ ]);
203
+ export const StageExecutionSessionSchema = z.object({
204
+ kind: z.literal("interf-stage-execution-session"),
205
+ version: z.literal(1),
206
+ // `.default("stage")` lets every session written before this discriminator
207
+ // existed parse as a stage job, and keeps all current stage/source-inventory
208
+ // writers byte-identical without passing job_type explicitly.
209
+ job_type: AgentJobTypeSchema.default("stage"),
210
+ generated_at: z.string().min(1),
211
+ updated_at: z.string().min(1),
212
+ project: ProjectIdSchema,
213
+ project_intent: ProjectIntentSchema.nullable(),
214
+ context_graph_path: z.string().min(1),
215
+ build_plan: BuildPlanIdSchema,
216
+ build_run_id: z.string().min(1).nullable(),
217
+ // Stage identity: present for `stage`/`source-inventory` jobs (both produced
218
+ // here today). Kept nullable so a future non-stage `AgentJobType` could carry
219
+ // null without a schema migration.
220
+ stage_id: RuntimeStageSchema.nullable(),
221
+ stage_label: z.string().min(1).nullable(),
222
+ contract_type: RuntimeContractTypeSchema.nullable(),
223
+ stage_run_id: z.string().min(1),
224
+ attempt: z.number().int().min(1),
225
+ status: ExecutionStatusSchema,
226
+ executor: RuntimeExecutorInfoSchema,
227
+ shell: z.object({
228
+ root_path: z.string().min(1),
229
+ workspace_manifest_path: z.string().min(1).nullable(),
230
+ preserved_shell_manifest_path: z.string().min(1).nullable(),
231
+ replay_ready: z.boolean(),
232
+ // Why a non-replayable session is still truthful. Null while the shell is
233
+ // live; set when the shell was intentionally pruned (e.g. a successful
234
+ // attempt under `on-failure` retention) so "session exists" never implies a
235
+ // replay shell that is gone. When set, `replay_ready` is false and
236
+ // `preserved_shell_manifest_path` is null. `.default(null)` lets sessions
237
+ // written before this field existed parse without it.
238
+ retention_reason: z.string().min(1).nullable().default(null),
239
+ }).strict(),
240
+ logs: z.object({
241
+ prompt_path: z.string().min(1).nullable(),
242
+ event_stream_path: z.string().min(1).nullable(),
243
+ status_path: z.string().min(1).nullable(),
244
+ }).strict(),
245
+ runtime_files: z.object({
246
+ project_path: z.string().min(1).nullable(),
247
+ contract_path: z.string().min(1).nullable(),
248
+ paths_path: z.string().min(1).nullable(),
249
+ source_locator_path: z.string().min(1).nullable(),
250
+ source_manifest_path: z.string().min(1).nullable(),
251
+ source_state_path: z.string().min(1).nullable(),
252
+ stage_inputs_path: z.string().min(1).nullable(),
253
+ expected_inputs_path: z.string().min(1).nullable(),
254
+ reviewed_inputs_path: z.string().min(1).nullable(),
255
+ previous_attempts_path: z.string().min(1).nullable(),
256
+ retry_feedback_path: z.string().min(1).nullable(),
257
+ last_validation_failure_path: z.string().min(1).nullable(),
258
+ verifier_path: z.string().min(1).nullable(),
259
+ stage_evidence_path: z.string().min(1).nullable(),
260
+ // Best-effort transcript of the agent's reasoning/thinking spans, teed from
261
+ // the live event stream during the run (one JSON object per line). Null when
262
+ // the executor emitted no reasoning. This is the inspectable "full
263
+ // transcript" reference for a preserved attempt.
264
+ reasoning_path: z.string().min(1).nullable().default(null),
265
+ }).strict(),
266
+ artifacts: z.object({
267
+ reads: z.array(ExecutionShellArtifactMountSchema).default([]),
268
+ writes: z.array(ExecutionShellArtifactMountSchema).default([]),
269
+ }).strict(),
270
+ validation_attempts: z.array(StageExecutionSessionValidationAttemptSchema).default([]),
271
+ summary: z.string().min(1).nullable(),
272
+ error: z.string().min(1).nullable(),
273
+ }).strict();
274
+ export const RuntimeProjectContextSchema = z.object({
275
+ id: ProjectIdSchema,
276
+ intent: z.string().min(1).nullable(),
277
+ }).strict();
278
+ export const RuntimeStageInstructionsSchema = z.object({
279
+ stage_skill_dir: z.string().regex(InterfIdPattern),
280
+ effective_mode: z.enum(["builtin", "extend", "override"]),
281
+ local_mode: z.enum(["extend", "override"]).nullable(),
282
+ local_docs: z.array(z.string()),
283
+ mode_sources: z.array(z.string()),
284
+ }).strict();
285
+ export const RuntimeStageContractSchema = z.object({
286
+ kind: z.literal("interf-stage-contract"),
287
+ version: z.literal(1),
288
+ generated_at: z.string(),
289
+ run_id: z.string(),
290
+ target_type: RuntimeTargetTypeSchema,
291
+ target_name: z.string(),
292
+ project: RuntimeProjectContextSchema,
293
+ build_plan: z.object({
294
+ id: BuildPlanIdSchema,
295
+ stage_index: z.number().nullable(),
296
+ stage_total: z.number(),
297
+ stages: z.array(RuntimeStageSchema),
298
+ }),
299
+ stage: RuntimeStageSchema,
300
+ stage_label: z.string(),
301
+ contract_type: RuntimeContractTypeSchema,
302
+ executor: RuntimeExecutorInfoSchema,
303
+ instructions: RuntimeStageInstructionsSchema,
304
+ counts: z.record(z.string(), z.number()),
305
+ artifacts: z.object({
306
+ reads: z.array(z.string()),
307
+ writes: z.array(z.string()),
308
+ write_contracts: z.array(z.object({
309
+ artifact_id: ArtifactIdSchema,
310
+ path: z.string().min(1),
311
+ checks: z.array(CheckSchema),
312
+ }).strict()).default([]),
313
+ }),
314
+ context_checks: z.array(BuildPlanContextCheckDraftSchema).default([]),
315
+ policies: z.object({
316
+ execution_mode: z.literal("deterministic"),
317
+ status_prefixes: z.array(z.string()),
318
+ notes: z.array(z.string()),
319
+ evidence_weighting: z.object({
320
+ required_fields: z.array(z.string()),
321
+ preserve_tiers: z.boolean(),
322
+ }).optional(),
323
+ working_set: z.object({
324
+ target_context_fraction: z.number(),
325
+ strategy: z.string(),
326
+ }).optional(),
327
+ }),
328
+ });
329
+ export const ExecutionStageLedgerSchema = z.object({
330
+ kind: z.literal("interf-run"),
331
+ version: z.literal(1),
332
+ run_id: z.string(),
333
+ target_type: RuntimeTargetTypeSchema,
334
+ target_name: z.string(),
335
+ build_plan: BuildPlanIdSchema,
336
+ stage: RuntimeStageSchema,
337
+ stage_label: z.string(),
338
+ contract_type: RuntimeContractTypeSchema,
339
+ status: ExecutionStatusSchema,
340
+ executor: RuntimeExecutorInfoSchema,
341
+ started_at: z.string(),
342
+ updated_at: z.string(),
343
+ finished_at: z.string().nullable(),
344
+ contract_path: z.string(),
345
+ execution_path: z.string().optional(),
346
+ counts: z.record(z.string(), z.number()),
347
+ output_artifacts: z.array(z.string()),
348
+ logs: z.object({
349
+ prompt_path: z.string(),
350
+ event_stream_path: z.string(),
351
+ status_path: z.string().optional(),
352
+ }).optional(),
353
+ evidence_path: z.string().min(1).optional(),
354
+ evidence: z.lazy(() => StageEvidenceReconciliationSchema).optional(),
355
+ summary: z.string(),
356
+ exit_code: z.number().nullable(),
357
+ error: z.string().nullable(),
358
+ });
359
+ export const RejectedStageEvidenceSchema = z.object({
360
+ kind: z.enum(["count", "item", "edge", "file"]),
361
+ id: z.string().min(1),
362
+ reason: z.string().min(1),
363
+ }).strict();
364
+ export const StageEvidenceReconciliationSchema = z.object({
365
+ kind: z.literal("interf-stage-evidence-reconciliation"),
366
+ version: z.literal(1),
367
+ generated_at: z.string().min(1),
368
+ evidence_path: z.string().min(1).nullable(),
369
+ accepted: z.object({
370
+ counts: z.array(StageEvidenceCountSchema).default([]),
371
+ items: z.array(StageEvidenceItemSchema).default([]),
372
+ edges: z.array(StageEvidenceEdgeSchema).default([]),
373
+ }).strict(),
374
+ rejected: z.array(RejectedStageEvidenceSchema).default([]),
375
+ warnings: z.array(z.string().min(1)).default([]),
376
+ }).strict();
377
+ export const ExecutionInventoryEntrySchema = z.object({
378
+ input_artifact: ArtifactIdSchema.optional(),
379
+ input_path: z.string().min(1).optional(),
380
+ output_artifact: ArtifactIdSchema,
381
+ output_path: z.string().min(1),
382
+ state: z.string().min(1).optional(),
383
+ metadata: JsonRecordSchema.optional(),
384
+ }).strict();
385
+ export const ExecutionInventorySchema = z.object({
386
+ // Both discriminators are always written by the only producers
387
+ // (`emptyExecutionInventory`/`buildInventoryFromEntries` in
388
+ // runtime-inventory.ts), so they are required, not optional. A persisted
389
+ // inventory missing `kind`/`version` is malformed and must fail to parse.
390
+ kind: z.literal("context-graph-runtime-ledger"),
391
+ version: z.literal(1),
392
+ stage: RuntimeStageSchema.optional(),
393
+ entries: z.array(ExecutionInventoryEntrySchema),
394
+ total: z.number().int().nonnegative(),
395
+ });
396
+ export const BuildPlanImprovementLoopSummarySchema = z.object({
397
+ variation: z.number().int().min(1),
398
+ kind: z.enum(["baseline", "edited"]),
399
+ attempts_run: z.number().int().min(1),
400
+ passed: z.boolean(),
401
+ passed_questions: z.number().int().min(0),
402
+ total_questions: z.number().int().min(0),
403
+ failed_stage: z.string().nullable().optional(),
404
+ test_run_path: z.string().nullable().optional(),
405
+ test_sandbox_path: z.string().nullable().optional(),
406
+ summary: z.string().min(1),
407
+ });
408
+ export const BuildPlanImprovementContextSchema = z.object({
409
+ kind: z.literal("interf-build-plan-improvement-loop"),
410
+ version: z.literal(1),
411
+ generated_at: z.string(),
412
+ target_name: z.string(),
413
+ build_plan_id: BuildPlanIdSchema,
414
+ loop_index: z.number().int().min(1),
415
+ max_loops: SourceBuildMaxLoopsSchema,
416
+ max_attempts: SourceBuildMaxAttemptsSchema,
417
+ review_paths: z.object({
418
+ build_plan_root: z.string(),
419
+ context_graph_runtime: z.string().nullable(),
420
+ benchmark_runs: z.string().nullable(),
421
+ execution_shells: z.string().nullable(),
422
+ test_runs: z.string().nullable(),
423
+ test_sandboxes: z.string().nullable(),
424
+ }),
425
+ benchmark_questions: z.object({
426
+ count: z.number().int().min(0),
427
+ questions: z.array(z.object({
428
+ id: z.string(),
429
+ question: z.string(),
430
+ })),
431
+ }),
432
+ previous_variations: z.array(BuildPlanImprovementLoopSummarySchema),
433
+ latest_failure: BuildPlanImprovementLoopSummarySchema.nullable(),
434
+ });
435
+ export const PreservedShellTypeSchema = z.enum([
436
+ "stage-execution",
437
+ "build-plan-authoring",
438
+ "build-plan-improvement",
439
+ "benchmark-question-draft",
440
+ "test-judge",
441
+ ]);
442
+ export const PreservedShellStateSchema = z.object({
443
+ kind: z.literal("interf-preserved-shell"),
444
+ version: z.literal(1),
445
+ shell_type: PreservedShellTypeSchema,
446
+ generated_at: z.string(),
447
+ root_path: z.string(),
448
+ materialized_symlinks: z.number().int().min(0),
449
+ });
450
+ export const BuildPlanPackageValidationSchema = z.object({
451
+ ok: z.boolean(),
452
+ summary: z.string(),
453
+ errors: z.array(z.string()),
454
+ counts: z.record(z.string(), z.number()),
455
+ });
456
+ export const BuildPlanImprovementLoopRecordSchema = z.object({
457
+ kind: z.literal("interf-build-plan-improvement-loop-record"),
458
+ version: z.literal(1),
459
+ recorded_at: z.string(),
460
+ run_id: z.string(),
461
+ loop_index: z.number().int().min(1),
462
+ target_name: z.string(),
463
+ build_plan_id: BuildPlanIdSchema,
464
+ result: z.enum(["updated", "no-change", "invalid", "executor-failed"]),
465
+ changed: z.boolean(),
466
+ applied: z.boolean(),
467
+ summary: z.string(),
468
+ shell_path: z.string(),
469
+ loop_root_path: z.string(),
470
+ context_path: z.string(),
471
+ build_plan_before_path: z.string(),
472
+ build_plan_after_path: z.string(),
473
+ prompt_log_path: z.string(),
474
+ event_log_path: z.string(),
475
+ status_log_path: z.string(),
476
+ // The agent's reasoning transcript inside the preserved improvement shell
477
+ // (runtime/agent-reasoning.jsonl), so the record indexes the reasoning the
478
+ // same way a stage session exposes reasoning_path. Nullable for older records.
479
+ reasoning_path: z.string().nullable().default(null),
480
+ preserved_shell_manifest_path: z.string().nullable(),
481
+ validation: BuildPlanPackageValidationSchema.nullable(),
482
+ });
483
+ export const BuildPlanImprovementRunLedgerSchema = z.object({
484
+ kind: z.literal("interf-build-plan-improvement-run"),
485
+ version: z.literal(1),
486
+ generated_at: z.string(),
487
+ updated_at: z.string(),
488
+ run_id: z.string(),
489
+ target_name: z.string(),
490
+ build_plan_id: BuildPlanIdSchema,
491
+ max_loops: SourceBuildMaxLoopsSchema,
492
+ max_attempts: SourceBuildMaxAttemptsSchema,
493
+ loops: z.array(BuildPlanImprovementLoopRecordSchema),
494
+ });
@@ -0,0 +1,2 @@
1
+ import type { AgentExecutor } from "../agents/lib/executors.js";
2
+ export declare function createNativeEntrypointExecutor(): AgentExecutor;