@interf/compiler 0.22.2 → 0.33.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 (575) hide show
  1. package/README.md +175 -234
  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 -4
  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 +10 -0
  10. package/dist/cli/commands/benchmark.js +88 -0
  11. package/dist/cli/commands/build-plan.js +95 -103
  12. package/dist/cli/commands/build.d.ts +1 -1
  13. package/dist/cli/commands/build.js +16 -15
  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 +199 -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 +3 -2
  20. package/dist/cli/commands/mcp.js +721 -204
  21. package/dist/cli/commands/project.d.ts +2 -0
  22. package/dist/cli/commands/project.js +202 -0
  23. package/dist/cli/commands/reset.d.ts +1 -1
  24. package/dist/cli/commands/reset.js +10 -10
  25. package/dist/cli/commands/runs.js +52 -26
  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 +33 -22
  30. package/dist/cli/commands/traces.d.ts +2 -0
  31. package/dist/cli/commands/traces.js +125 -0
  32. package/dist/cli/commands/wizard.js +155 -150
  33. package/dist/cli/index.d.ts +7 -4
  34. package/dist/cli/index.js +13 -7
  35. package/dist/index.d.ts +2 -2
  36. package/dist/index.js +2 -2
  37. package/dist/packages/build-plans/authoring/brief.d.ts +517 -0
  38. package/dist/packages/build-plans/authoring/brief.js +89 -0
  39. package/dist/packages/build-plans/authoring/build-plan-authoring.d.ts +10 -10
  40. package/dist/packages/build-plans/authoring/build-plan-authoring.js +66 -26
  41. package/dist/packages/build-plans/authoring/build-plan-edit-session.d.ts +1 -1
  42. package/dist/packages/build-plans/authoring/build-plan-edit-session.js +8 -2
  43. package/dist/packages/build-plans/authoring/build-plan-improvement.d.ts +9 -6
  44. package/dist/packages/build-plans/authoring/build-plan-improvement.js +39 -42
  45. package/dist/packages/build-plans/authoring/lib/build-plan-edit-utils.js +7 -7
  46. package/dist/packages/build-plans/build-plan-resolution.d.ts +1 -1
  47. package/dist/packages/build-plans/build-plan-resolution.js +3 -3
  48. package/dist/packages/build-plans/index.d.ts +1 -1
  49. package/dist/packages/build-plans/index.js +1 -1
  50. package/dist/packages/build-plans/package/build-plan-definitions.d.ts +14 -12
  51. package/dist/packages/build-plans/package/build-plan-definitions.js +40 -39
  52. package/dist/packages/build-plans/package/build-plan-helpers.d.ts +3 -2
  53. package/dist/packages/build-plans/package/build-plan-helpers.js +27 -13
  54. package/dist/packages/build-plans/package/build-plan-review-paths.d.ts +5 -5
  55. package/dist/packages/build-plans/package/build-plan-review-paths.js +15 -15
  56. package/dist/packages/build-plans/package/build-plan-stage-runner.d.ts +4 -4
  57. package/dist/packages/build-plans/package/build-plan-stage-runner.js +22 -11
  58. package/dist/packages/build-plans/package/builtin-build-plan.d.ts +5 -6
  59. package/dist/packages/build-plans/package/builtin-build-plan.js +7 -8
  60. package/dist/packages/build-plans/package/context-interface.d.ts +11 -9
  61. package/dist/packages/build-plans/package/context-interface.js +14 -33
  62. package/dist/packages/build-plans/package/interf-build-plan-package.d.ts +6 -17
  63. package/dist/packages/build-plans/package/interf-build-plan-package.js +56 -52
  64. package/dist/packages/build-plans/package/local-build-plans.d.ts +12 -10
  65. package/dist/packages/build-plans/package/local-build-plans.js +56 -31
  66. package/dist/packages/build-plans/package/user-build-plans.js +1 -1
  67. package/dist/packages/contracts/index.d.ts +4 -2
  68. package/dist/packages/contracts/index.js +2 -1
  69. package/dist/packages/contracts/lib/project-paths.d.ts +137 -0
  70. package/dist/packages/contracts/lib/project-paths.js +211 -0
  71. package/dist/packages/contracts/lib/project-schema.d.ts +160 -0
  72. package/dist/packages/contracts/lib/project-schema.js +113 -0
  73. package/dist/packages/contracts/lib/schema.d.ts +739 -80
  74. package/dist/packages/contracts/lib/schema.js +410 -75
  75. package/dist/packages/contracts/utils/parse.js +67 -0
  76. package/dist/packages/projects/index.d.ts +6 -0
  77. package/dist/packages/{project → projects}/index.js +0 -3
  78. package/dist/packages/{project → projects}/interf-detect.d.ts +12 -12
  79. package/dist/packages/{project → projects}/interf-detect.js +56 -50
  80. package/dist/packages/projects/interf.d.ts +2 -0
  81. package/dist/packages/projects/interf.js +1 -0
  82. package/dist/packages/projects/lib/schema.d.ts +79 -0
  83. package/dist/packages/projects/lib/schema.js +89 -0
  84. package/dist/packages/projects/source-config.d.ts +58 -0
  85. package/dist/packages/projects/source-config.js +352 -0
  86. package/dist/packages/projects/source-folders.d.ts +11 -0
  87. package/dist/packages/{project → projects}/source-folders.js +26 -26
  88. package/dist/packages/{engine → runtime}/action-planner.d.ts +1 -1
  89. package/dist/packages/{engine → runtime}/action-planner.js +20 -22
  90. package/dist/packages/runtime/action-values.d.ts +1 -0
  91. package/dist/packages/runtime/action-values.js +1 -0
  92. package/dist/packages/runtime/actions/errors.d.ts +2 -0
  93. package/dist/packages/runtime/actions/errors.js +12 -0
  94. package/dist/packages/runtime/actions/fields.d.ts +82 -0
  95. package/dist/packages/runtime/actions/form-builders.d.ts +14 -0
  96. package/dist/packages/runtime/actions/form-builders.js +619 -0
  97. package/dist/packages/runtime/actions/form-validators.d.ts +8 -0
  98. package/dist/packages/runtime/actions/form-validators.js +128 -0
  99. package/dist/packages/runtime/actions/helpers.d.ts +11 -0
  100. package/dist/packages/runtime/actions/helpers.js +80 -0
  101. package/dist/packages/runtime/actions/index.d.ts +8 -0
  102. package/dist/packages/runtime/actions/index.js +11 -0
  103. package/dist/packages/runtime/actions/registry.d.ts +64 -0
  104. package/dist/packages/runtime/actions/registry.js +62 -0
  105. package/dist/packages/runtime/actions/requests.d.ts +45 -0
  106. package/dist/packages/runtime/actions/requests.js +158 -0
  107. package/dist/packages/runtime/actions/schemas.d.ts +154 -0
  108. package/dist/packages/runtime/actions/schemas.js +36 -0
  109. package/dist/packages/runtime/agent-handoff.d.ts +11 -0
  110. package/dist/packages/runtime/agent-handoff.js +101 -0
  111. package/dist/packages/{engine → runtime}/agents/index.d.ts +1 -2
  112. package/dist/packages/{engine → runtime}/agents/index.js +1 -2
  113. package/dist/packages/runtime/agents/lib/args.d.ts +14 -0
  114. package/dist/packages/runtime/agents/lib/args.js +24 -0
  115. package/dist/packages/{engine → runtime}/agents/lib/constants.d.ts +4 -1
  116. package/dist/packages/runtime/agents/lib/constants.js +13 -0
  117. package/dist/packages/runtime/agents/lib/context-graph-bootstrap.d.ts +3 -0
  118. package/dist/packages/{engine/agents/lib/verifiable-context-bootstrap.js → runtime/agents/lib/context-graph-bootstrap.js} +5 -6
  119. package/dist/packages/{engine → runtime}/agents/lib/detection.d.ts +5 -0
  120. package/dist/packages/{engine → runtime}/agents/lib/detection.js +16 -7
  121. package/dist/packages/{engine → runtime}/agents/lib/execution-profile.js +8 -14
  122. package/dist/packages/{engine → runtime}/agents/lib/execution.js +14 -4
  123. package/dist/packages/{engine → runtime}/agents/lib/preflight.js +15 -13
  124. package/dist/packages/{engine → runtime}/agents/lib/render.js +4 -4
  125. package/dist/packages/runtime/agents/lib/shell-fs.d.ts +18 -0
  126. package/dist/packages/runtime/agents/lib/shell-fs.js +190 -0
  127. package/dist/packages/runtime/agents/lib/shell-paths.d.ts +16 -0
  128. package/dist/packages/runtime/agents/lib/shell-paths.js +63 -0
  129. package/dist/packages/runtime/agents/lib/shell-projection.d.ts +25 -0
  130. package/dist/packages/runtime/agents/lib/shell-projection.js +314 -0
  131. package/dist/packages/runtime/agents/lib/shell-templates.d.ts +30 -0
  132. package/dist/packages/runtime/agents/lib/shell-templates.js +452 -0
  133. package/dist/packages/runtime/agents/lib/shell-workspace.d.ts +17 -0
  134. package/dist/packages/runtime/agents/lib/shell-workspace.js +70 -0
  135. package/dist/packages/runtime/agents/lib/shells.d.ts +63 -0
  136. package/dist/packages/runtime/agents/lib/shells.js +383 -0
  137. package/dist/packages/{engine → runtime}/agents/lib/user-config.d.ts +8 -2
  138. package/dist/packages/{engine → runtime}/agents/lib/user-config.js +8 -2
  139. package/dist/packages/runtime/agents/providers/claude-code.d.ts +13 -0
  140. package/dist/packages/runtime/agents/providers/claude-code.js +45 -0
  141. package/dist/packages/runtime/agents/providers/codex.d.ts +17 -0
  142. package/dist/packages/runtime/agents/providers/codex.js +64 -0
  143. package/dist/packages/runtime/agents/providers/cursor.d.ts +9 -0
  144. package/dist/packages/runtime/agents/providers/cursor.js +24 -0
  145. package/dist/packages/runtime/agents/providers/index.d.ts +9 -0
  146. package/dist/packages/runtime/agents/providers/index.js +31 -0
  147. package/dist/packages/runtime/agents/providers/types.d.ts +50 -0
  148. package/dist/packages/{engine → runtime}/agents/registry.d.ts +13 -2
  149. package/dist/packages/{engine → runtime}/agents/registry.js +48 -10
  150. package/dist/packages/{engine → runtime}/agents/role-executors.d.ts +1 -1
  151. package/dist/packages/{engine → runtime}/agents/role-executors.js +7 -6
  152. package/dist/packages/{engine → runtime}/agents/role-router.js +7 -5
  153. package/dist/packages/runtime/auth/account-context.d.ts +52 -0
  154. package/dist/packages/runtime/auth/account-context.js +68 -0
  155. package/dist/packages/runtime/auth/auth-flow.d.ts +73 -0
  156. package/dist/packages/runtime/auth/auth-flow.js +189 -0
  157. package/dist/packages/runtime/auth/jwt-validator.d.ts +58 -0
  158. package/dist/packages/runtime/auth/jwt-validator.js +86 -0
  159. package/dist/packages/runtime/auth/keychain.d.ts +35 -0
  160. package/dist/packages/runtime/auth/keychain.js +85 -0
  161. package/dist/packages/runtime/auth/session-store.d.ts +38 -0
  162. package/dist/packages/runtime/auth/session-store.js +88 -0
  163. package/dist/packages/runtime/auth/workos-client.d.ts +58 -0
  164. package/dist/packages/runtime/auth/workos-client.js +87 -0
  165. package/dist/packages/runtime/benchmark-question-draft.d.ts +20 -0
  166. package/dist/packages/runtime/benchmark-question-draft.js +124 -0
  167. package/dist/packages/runtime/build/artifact-counts.d.ts +1 -0
  168. package/dist/packages/{engine → runtime}/build/artifact-counts.js +5 -9
  169. package/dist/packages/{engine → runtime}/build/artifact-status.d.ts +5 -5
  170. package/dist/packages/{engine → runtime}/build/artifact-status.js +25 -23
  171. package/dist/packages/runtime/build/atomic-fs.d.ts +3 -0
  172. package/dist/packages/runtime/build/atomic-fs.js +95 -0
  173. package/dist/packages/runtime/build/billing-events.d.ts +78 -0
  174. package/dist/packages/{engine → runtime}/build/billing-events.js +17 -19
  175. package/dist/packages/runtime/build/build-evidence.d.ts +15 -0
  176. package/dist/packages/runtime/build/build-evidence.js +173 -0
  177. package/dist/packages/{engine → runtime}/build/build-pipeline.d.ts +12 -8
  178. package/dist/packages/runtime/build/build-pipeline.js +304 -0
  179. package/dist/packages/{engine → runtime}/build/build-plan-primitives.d.ts +1 -1
  180. package/dist/packages/{engine → runtime}/build/build-plan-primitives.js +0 -1
  181. package/dist/packages/runtime/build/build-plan-runs.d.ts +14 -0
  182. package/dist/packages/runtime/build/build-plan-runs.js +31 -0
  183. package/dist/packages/runtime/build/build-stage-plan.d.ts +16 -0
  184. package/dist/packages/{engine → runtime}/build/build-stage-plan.js +28 -29
  185. package/dist/packages/{engine → runtime}/build/build-stage-runner.d.ts +2 -1
  186. package/dist/packages/runtime/build/build-stage-runner.js +165 -0
  187. package/dist/packages/{engine → runtime}/build/build-target.d.ts +4 -4
  188. package/dist/packages/runtime/build/build-target.js +16 -0
  189. package/dist/packages/{engine → runtime}/build/check-evaluator.d.ts +14 -16
  190. package/dist/packages/runtime/build/check-evaluator.js +575 -0
  191. package/dist/packages/runtime/build/context-graph-paths.d.ts +51 -0
  192. package/dist/packages/runtime/build/context-graph-paths.js +133 -0
  193. package/dist/packages/runtime/build/context-graph-schema.d.ts +19 -0
  194. package/dist/packages/runtime/build/context-graph-schema.js +39 -0
  195. package/dist/packages/{engine → runtime}/build/discovery.d.ts +2 -2
  196. package/dist/packages/{engine → runtime}/build/discovery.js +4 -4
  197. package/dist/packages/{engine → runtime}/build/index.d.ts +5 -3
  198. package/dist/packages/{engine → runtime}/build/index.js +5 -3
  199. package/dist/packages/{engine → runtime}/build/lib/schema.d.ts +221 -88
  200. package/dist/packages/{engine → runtime}/build/lib/schema.js +61 -41
  201. package/dist/packages/runtime/build/reset.d.ts +2 -0
  202. package/dist/packages/runtime/build/reset.js +62 -0
  203. package/dist/packages/{engine → runtime}/build/runtime-contracts.js +5 -5
  204. package/dist/packages/runtime/build/runtime-inventory.d.ts +7 -0
  205. package/dist/packages/{engine → runtime}/build/runtime-inventory.js +3 -3
  206. package/dist/packages/{engine → runtime}/build/runtime-paths.js +6 -6
  207. package/dist/packages/{engine → runtime}/build/runtime-prompt.js +7 -6
  208. package/dist/packages/{engine → runtime}/build/runtime-reconcile.d.ts +1 -1
  209. package/dist/packages/{engine → runtime}/build/runtime-reconcile.js +25 -21
  210. package/dist/packages/runtime/build/runtime-runs.d.ts +10 -0
  211. package/dist/packages/runtime/build/runtime-runs.js +265 -0
  212. package/dist/packages/{engine → runtime}/build/runtime-types.d.ts +6 -6
  213. package/dist/packages/runtime/build/runtime-types.js +1 -0
  214. package/dist/packages/runtime/build/runtime.d.ts +6 -0
  215. package/dist/packages/runtime/build/runtime.js +5 -0
  216. package/dist/packages/runtime/build/source-files.d.ts +58 -0
  217. package/dist/packages/runtime/build/source-files.js +184 -0
  218. package/dist/packages/runtime/build/source-inventory.d.ts +27 -0
  219. package/dist/packages/runtime/build/source-inventory.js +273 -0
  220. package/dist/packages/runtime/build/source-manifest.d.ts +52 -0
  221. package/dist/packages/runtime/build/source-manifest.js +192 -0
  222. package/dist/packages/runtime/build/stage-evidence.d.ts +22 -0
  223. package/dist/packages/runtime/build/stage-evidence.js +317 -0
  224. package/dist/packages/runtime/build/stage-reuse.d.ts +11 -0
  225. package/dist/packages/runtime/build/stage-reuse.js +142 -0
  226. package/dist/packages/runtime/build/state-artifacts.d.ts +9 -0
  227. package/dist/packages/runtime/build/state-artifacts.js +14 -0
  228. package/dist/packages/runtime/build/state-health.d.ts +4 -0
  229. package/dist/packages/{engine → runtime}/build/state-health.js +21 -26
  230. package/dist/packages/runtime/build/state-io.d.ts +12 -0
  231. package/dist/packages/runtime/build/state-io.js +119 -0
  232. package/dist/packages/{engine → runtime}/build/state-paths.d.ts +3 -1
  233. package/dist/packages/runtime/build/state-paths.js +22 -0
  234. package/dist/packages/runtime/build/state-view.d.ts +5 -0
  235. package/dist/packages/{engine → runtime}/build/state-view.js +60 -33
  236. package/dist/packages/runtime/build/state.d.ts +7 -0
  237. package/dist/packages/runtime/build/state.js +12 -0
  238. package/dist/packages/runtime/build/traces.d.ts +30 -0
  239. package/dist/packages/runtime/build/traces.js +133 -0
  240. package/dist/packages/{engine/build/validate-verifiable-context.d.ts → runtime/build/validate-context-graph.d.ts} +6 -6
  241. package/dist/packages/{engine/build/validate-verifiable-context.js → runtime/build/validate-context-graph.js} +48 -35
  242. package/dist/packages/{engine → runtime}/build/validate.d.ts +5 -5
  243. package/dist/packages/{engine → runtime}/build/validate.js +26 -26
  244. package/dist/packages/{engine → runtime}/client.d.ts +15 -15
  245. package/dist/packages/{engine → runtime}/client.js +41 -24
  246. package/dist/packages/{engine → runtime}/connection-config.d.ts +3 -2
  247. package/dist/packages/{engine → runtime}/connection-config.js +9 -8
  248. package/dist/packages/runtime/context-checks.d.ts +10 -0
  249. package/dist/packages/runtime/context-checks.js +114 -0
  250. package/dist/packages/runtime/context-graph-scaffold.d.ts +9 -0
  251. package/dist/packages/runtime/context-graph-scaffold.js +134 -0
  252. package/dist/packages/runtime/entitlement-guard.d.ts +43 -0
  253. package/dist/packages/runtime/entitlement-guard.js +70 -0
  254. package/dist/packages/{engine → runtime}/execution/index.d.ts +2 -2
  255. package/dist/packages/{engine → runtime}/execution/index.js +1 -1
  256. package/dist/packages/{engine → runtime}/execution/lib/schema.d.ts +270 -192
  257. package/dist/packages/{engine → runtime}/execution/lib/schema.js +35 -32
  258. package/dist/packages/runtime/index.d.ts +29 -0
  259. package/dist/packages/runtime/index.js +21 -0
  260. package/dist/packages/runtime/instance-paths.d.ts +30 -0
  261. package/dist/packages/runtime/instance-paths.js +29 -0
  262. package/dist/packages/{engine → runtime}/native-run-handlers.d.ts +4 -4
  263. package/dist/packages/{engine → runtime}/native-run-handlers.js +184 -152
  264. package/dist/packages/runtime/plan-artifact-contract.d.ts +17 -0
  265. package/dist/packages/runtime/plan-artifact-contract.js +42 -0
  266. package/dist/packages/runtime/project-entries.d.ts +11 -0
  267. package/dist/packages/runtime/project-entries.js +49 -0
  268. package/dist/packages/runtime/project-source-state.d.ts +26 -0
  269. package/dist/packages/runtime/project-source-state.js +53 -0
  270. package/dist/packages/runtime/project-store.d.ts +85 -0
  271. package/dist/packages/runtime/project-store.js +168 -0
  272. package/dist/packages/runtime/requested-artifacts.d.ts +7 -0
  273. package/dist/packages/{engine → runtime}/requested-artifacts.js +23 -1
  274. package/dist/packages/{engine → runtime}/run-observability.d.ts +2 -1
  275. package/dist/packages/{engine → runtime}/run-observability.js +166 -84
  276. package/dist/packages/runtime/runtime-action-proposals.d.ts +7 -0
  277. package/dist/packages/runtime/runtime-action-proposals.js +542 -0
  278. package/dist/packages/runtime/runtime-build-plans.d.ts +5 -0
  279. package/dist/packages/runtime/runtime-build-plans.js +131 -0
  280. package/dist/packages/runtime/runtime-build-runs.d.ts +47 -0
  281. package/dist/packages/runtime/runtime-build-runs.js +562 -0
  282. package/dist/packages/runtime/runtime-caches.d.ts +91 -0
  283. package/dist/packages/{engine → runtime}/runtime-caches.js +77 -49
  284. package/dist/packages/{engine → runtime}/runtime-event-applier.d.ts +3 -1
  285. package/dist/packages/{engine → runtime}/runtime-event-applier.js +53 -17
  286. package/dist/packages/runtime/runtime-executor.d.ts +22 -0
  287. package/dist/packages/runtime/runtime-executor.js +131 -0
  288. package/dist/packages/runtime/runtime-jobs.d.ts +13 -0
  289. package/dist/packages/runtime/runtime-jobs.js +463 -0
  290. package/dist/packages/runtime/runtime-observability.d.ts +11 -0
  291. package/dist/packages/runtime/runtime-observability.js +39 -0
  292. package/dist/packages/{engine → runtime}/runtime-persistence.d.ts +9 -18
  293. package/dist/packages/{engine → runtime}/runtime-persistence.js +25 -25
  294. package/dist/packages/runtime/runtime-project-mutations.d.ts +7 -0
  295. package/dist/packages/runtime/runtime-project-mutations.js +64 -0
  296. package/dist/packages/runtime/runtime-project-reads.d.ts +15 -0
  297. package/dist/packages/runtime/runtime-project-reads.js +381 -0
  298. package/dist/packages/runtime/runtime-proposal-helpers.d.ts +22 -0
  299. package/dist/packages/runtime/runtime-proposal-helpers.js +223 -0
  300. package/dist/packages/{engine → runtime}/runtime-resource-builders.d.ts +21 -16
  301. package/dist/packages/{engine → runtime}/runtime-resource-builders.js +48 -38
  302. package/dist/packages/runtime/runtime-verify-runs.d.ts +84 -0
  303. package/dist/packages/runtime/runtime-verify-runs.js +295 -0
  304. package/dist/packages/runtime/runtime.d.ts +1165 -0
  305. package/dist/packages/runtime/runtime.js +417 -0
  306. package/dist/packages/runtime/schemas/actions.d.ts +1182 -0
  307. package/dist/packages/runtime/schemas/actions.js +117 -0
  308. package/dist/packages/runtime/schemas/agents.d.ts +76 -0
  309. package/dist/packages/runtime/schemas/agents.js +41 -0
  310. package/dist/packages/runtime/schemas/build-plans.d.ts +959 -0
  311. package/dist/packages/runtime/schemas/build-plans.js +107 -0
  312. package/dist/packages/runtime/schemas/files.d.ts +567 -0
  313. package/dist/packages/runtime/schemas/files.js +51 -0
  314. package/dist/packages/runtime/schemas/index.d.ts +8 -0
  315. package/dist/packages/runtime/schemas/index.js +12 -0
  316. package/dist/packages/runtime/schemas/instance.d.ts +141 -0
  317. package/dist/packages/runtime/schemas/instance.js +143 -0
  318. package/dist/packages/runtime/schemas/jobs.d.ts +339 -0
  319. package/dist/packages/runtime/schemas/jobs.js +103 -0
  320. package/dist/packages/runtime/schemas/projects.d.ts +339 -0
  321. package/dist/packages/runtime/schemas/projects.js +136 -0
  322. package/dist/packages/runtime/schemas/runs.d.ts +2676 -0
  323. package/dist/packages/runtime/schemas/runs.js +98 -0
  324. package/dist/packages/runtime/service/index.d.ts +3 -0
  325. package/dist/packages/runtime/service/index.js +3 -0
  326. package/dist/packages/runtime/service/openapi.d.ts +7 -0
  327. package/dist/packages/runtime/service/openapi.js +117 -0
  328. package/dist/packages/runtime/service/operations.d.ts +1490 -0
  329. package/dist/packages/runtime/service/operations.js +245 -0
  330. package/dist/packages/runtime/service/routes.d.ts +106 -0
  331. package/dist/packages/runtime/service/routes.js +120 -0
  332. package/dist/packages/runtime/service/server-api-files.d.ts +10 -0
  333. package/dist/packages/runtime/service/server-api-files.js +85 -0
  334. package/dist/packages/runtime/service/server-app-boot.d.ts +4 -0
  335. package/dist/packages/runtime/service/server-app-boot.js +46 -0
  336. package/dist/packages/runtime/service/server-guards.d.ts +63 -0
  337. package/dist/packages/runtime/service/server-guards.js +181 -0
  338. package/dist/packages/runtime/service/server-helpers.d.ts +27 -0
  339. package/dist/packages/runtime/service/server-helpers.js +89 -0
  340. package/dist/packages/runtime/service/server-instance-helpers.d.ts +30 -0
  341. package/dist/packages/runtime/service/server-instance-helpers.js +114 -0
  342. package/dist/packages/runtime/service/server-routes-action-proposals.d.ts +3 -0
  343. package/dist/packages/runtime/service/server-routes-action-proposals.js +43 -0
  344. package/dist/packages/runtime/service/server-routes-agents.d.ts +4 -0
  345. package/dist/packages/runtime/service/server-routes-agents.js +198 -0
  346. package/dist/packages/runtime/service/server-routes-auth.d.ts +33 -0
  347. package/dist/packages/runtime/service/server-routes-auth.js +138 -0
  348. package/dist/packages/runtime/service/server-routes-build-plans.d.ts +3 -0
  349. package/dist/packages/runtime/service/server-routes-build-plans.js +83 -0
  350. package/dist/packages/runtime/service/server-routes-discovery.d.ts +4 -0
  351. package/dist/packages/runtime/service/server-routes-discovery.js +196 -0
  352. package/dist/packages/runtime/service/server-routes-events.d.ts +5 -0
  353. package/dist/packages/runtime/service/server-routes-events.js +99 -0
  354. package/dist/packages/runtime/service/server-routes-project-context.d.ts +9 -0
  355. package/dist/packages/runtime/service/server-routes-project-context.js +192 -0
  356. package/dist/packages/runtime/service/server-routes-project-jobs.d.ts +9 -0
  357. package/dist/packages/runtime/service/server-routes-project-jobs.js +130 -0
  358. package/dist/packages/runtime/service/server-routes-project-runs.d.ts +14 -0
  359. package/dist/packages/runtime/service/server-routes-project-runs.js +85 -0
  360. package/dist/packages/runtime/service/server-routes-projects.d.ts +4 -0
  361. package/dist/packages/runtime/service/server-routes-projects.js +92 -0
  362. package/dist/packages/runtime/service/server-routes-runs.d.ts +3 -0
  363. package/dist/packages/runtime/service/server-routes-runs.js +112 -0
  364. package/dist/packages/runtime/service/server.d.ts +37 -0
  365. package/dist/packages/runtime/service/server.js +300 -0
  366. package/dist/packages/{engine → runtime/service}/service-registry.d.ts +5 -5
  367. package/dist/packages/{engine → runtime/service}/service-registry.js +7 -7
  368. package/dist/packages/runtime/verify/benchmark-run.d.ts +81 -0
  369. package/dist/packages/runtime/verify/benchmark-run.js +303 -0
  370. package/dist/packages/{engine → runtime}/verify/index.d.ts +2 -2
  371. package/dist/packages/{engine → runtime}/verify/index.js +1 -1
  372. package/dist/packages/{engine → runtime}/verify/lib/schema.d.ts +83 -16
  373. package/dist/packages/{engine → runtime}/verify/lib/schema.js +26 -18
  374. package/dist/packages/{engine → runtime}/verify/verify-execution.js +11 -11
  375. package/dist/packages/{engine → runtime}/verify/verify-paths.d.ts +4 -4
  376. package/dist/packages/runtime/verify/verify-paths.js +61 -0
  377. package/dist/packages/{engine → runtime}/verify/verify-sandbox.d.ts +1 -1
  378. package/dist/packages/runtime/verify/verify-sandbox.js +88 -0
  379. package/dist/packages/{engine → runtime}/verify/verify-specs.d.ts +2 -0
  380. package/dist/packages/{engine → runtime}/verify/verify-specs.js +5 -3
  381. package/dist/packages/runtime/verify/verify-targets.d.ts +5 -0
  382. package/dist/packages/{engine → runtime}/verify/verify-targets.js +12 -12
  383. package/dist/packages/runtime/verify/verify-types.js +1 -0
  384. package/dist/packages/{engine → runtime}/verify/verify.d.ts +1 -1
  385. package/dist/packages/{engine → runtime}/verify/verify.js +1 -1
  386. package/dist/packages/runtime/wire-schemas.d.ts +18 -0
  387. package/dist/packages/runtime/wire-schemas.js +27 -0
  388. package/package.json +39 -31
  389. package/public-repo/CONTRIBUTING.md +7 -16
  390. package/public-repo/README.md +175 -234
  391. package/public-repo/SECURITY.md +3 -4
  392. package/public-repo/build-plans/interf-default/README.md +19 -14
  393. package/public-repo/build-plans/interf-default/build/stages/shape/SKILL.md +18 -11
  394. package/public-repo/build-plans/interf-default/build/stages/structure/SKILL.md +12 -5
  395. package/public-repo/build-plans/interf-default/build/stages/summarize/SKILL.md +16 -4
  396. package/public-repo/build-plans/interf-default/build-plan.json +34 -28
  397. package/public-repo/build-plans/interf-default/build-plan.schema.json +54 -32
  398. package/public-repo/build-plans/interf-default/improve/SKILL.md +3 -3
  399. package/public-repo/build-plans/interf-default/use/query/SKILL.md +17 -11
  400. package/public-repo/openapi/local-service.openapi.json +6803 -0
  401. package/public-repo/skills/interf/SKILL.md +460 -179
  402. package/dist/cli/commands/prep.d.ts +0 -2
  403. package/dist/cli/commands/prep.js +0 -240
  404. package/dist/cli/commands/test.d.ts +0 -10
  405. package/dist/cli/commands/test.js +0 -85
  406. package/dist/cli/commands/web.d.ts +0 -2
  407. package/dist/cli/commands/web.js +0 -286
  408. package/dist/interf-ui/404.html +0 -1
  409. package/dist/interf-ui/__next.__PAGE__.txt +0 -10
  410. package/dist/interf-ui/__next._full.txt +0 -20
  411. package/dist/interf-ui/__next._head.txt +0 -5
  412. package/dist/interf-ui/__next._index.txt +0 -5
  413. package/dist/interf-ui/__next._tree.txt +0 -5
  414. package/dist/interf-ui/_next/static/--reS3xBzM5zc6QxNjZd6/_buildManifest.js +0 -11
  415. package/dist/interf-ui/_next/static/--reS3xBzM5zc6QxNjZd6/_clientMiddlewareManifest.js +0 -1
  416. package/dist/interf-ui/_next/static/--reS3xBzM5zc6QxNjZd6/_ssgManifest.js +0 -1
  417. package/dist/interf-ui/_next/static/chunks/0.tjb6f4golw..css +0 -3
  418. package/dist/interf-ui/_next/static/chunks/03~yq9q893hmn.js +0 -1
  419. package/dist/interf-ui/_next/static/chunks/085-n_jv2ng_q.css +0 -1
  420. package/dist/interf-ui/_next/static/chunks/0dn41fa_zvgsl.js +0 -1
  421. package/dist/interf-ui/_next/static/chunks/0g-ea0zj5d-0k.js +0 -1
  422. package/dist/interf-ui/_next/static/chunks/0gwqglc4iz583.js +0 -1
  423. package/dist/interf-ui/_next/static/chunks/0haldgm65ve6l.js +0 -1
  424. package/dist/interf-ui/_next/static/chunks/0nv3am99vjzn4.js +0 -1
  425. package/dist/interf-ui/_next/static/chunks/0s77gt_o4jwtx.js +0 -1
  426. package/dist/interf-ui/_next/static/chunks/0y5z3t-z1c8ks.js.map +0 -5
  427. package/dist/interf-ui/_next/static/chunks/0~a36ujuzpaz..js +0 -116
  428. package/dist/interf-ui/_next/static/chunks/10jeodxe4nkgj.js +0 -31
  429. package/dist/interf-ui/_next/static/chunks/119h2rouych2t.js +0 -1
  430. package/dist/interf-ui/_next/static/chunks/13c8b~m8knjsf.js +0 -1
  431. package/dist/interf-ui/_next/static/chunks/14dznb2qpt-ho.js +0 -91
  432. package/dist/interf-ui/_next/static/chunks/15z_en80lrq-3.js +0 -5
  433. package/dist/interf-ui/_next/static/chunks/turbopack-0p.pvcjrtq-jh.js +0 -1
  434. package/dist/interf-ui/_next/static/chunks/turbopack-0usj_75.8frlw.js +0 -1
  435. package/dist/interf-ui/_next/static/chunks/turbopack-worker-0sjn--fhq~1cg.js +0 -1
  436. package/dist/interf-ui/_next/static/media/GeistMono_Variable.p.17jn9btb_52pq.woff2 +0 -0
  437. package/dist/interf-ui/_next/static/media/Geist_Variable-s.p.0-te~ja_gpvcf.woff2 +0 -0
  438. package/dist/interf-ui/_next/static/media/worker.102zas1s52_pf.js +0 -109
  439. package/dist/interf-ui/_not-found/__next._full.txt +0 -15
  440. package/dist/interf-ui/_not-found/__next._head.txt +0 -5
  441. package/dist/interf-ui/_not-found/__next._index.txt +0 -5
  442. package/dist/interf-ui/_not-found/__next._not-found.__PAGE__.txt +0 -5
  443. package/dist/interf-ui/_not-found/__next._not-found.txt +0 -5
  444. package/dist/interf-ui/_not-found/__next._tree.txt +0 -2
  445. package/dist/interf-ui/_not-found.html +0 -1
  446. package/dist/interf-ui/_not-found.txt +0 -15
  447. package/dist/interf-ui/index.html +0 -1
  448. package/dist/interf-ui/index.txt +0 -20
  449. package/dist/packages/contracts/lib/preparation-paths.d.ts +0 -117
  450. package/dist/packages/contracts/lib/preparation-paths.js +0 -177
  451. package/dist/packages/engine/action-definitions.d.ts +0 -407
  452. package/dist/packages/engine/action-definitions.js +0 -1158
  453. package/dist/packages/engine/action-values.d.ts +0 -1
  454. package/dist/packages/engine/action-values.js +0 -1
  455. package/dist/packages/engine/agents/lib/args.d.ts +0 -4
  456. package/dist/packages/engine/agents/lib/args.js +0 -52
  457. package/dist/packages/engine/agents/lib/chart-guidance.d.ts +0 -1
  458. package/dist/packages/engine/agents/lib/chart-guidance.js +0 -8
  459. package/dist/packages/engine/agents/lib/constants.js +0 -28
  460. package/dist/packages/engine/agents/lib/schema.d.ts +0 -8
  461. package/dist/packages/engine/agents/lib/schema.js +0 -7
  462. package/dist/packages/engine/agents/lib/shells.d.ts +0 -74
  463. package/dist/packages/engine/agents/lib/shells.js +0 -1052
  464. package/dist/packages/engine/agents/lib/verifiable-context-bootstrap.d.ts +0 -3
  465. package/dist/packages/engine/build/artifact-counts.d.ts +0 -1
  466. package/dist/packages/engine/build/billing-events.d.ts +0 -89
  467. package/dist/packages/engine/build/build-pipeline.js +0 -175
  468. package/dist/packages/engine/build/build-plan-runs.d.ts +0 -14
  469. package/dist/packages/engine/build/build-plan-runs.js +0 -31
  470. package/dist/packages/engine/build/build-stage-plan.d.ts +0 -16
  471. package/dist/packages/engine/build/build-stage-runner.js +0 -94
  472. package/dist/packages/engine/build/build-target.js +0 -16
  473. package/dist/packages/engine/build/check-evaluator.js +0 -298
  474. package/dist/packages/engine/build/reset.d.ts +0 -2
  475. package/dist/packages/engine/build/reset.js +0 -74
  476. package/dist/packages/engine/build/runtime-inventory.d.ts +0 -7
  477. package/dist/packages/engine/build/runtime-runs.d.ts +0 -10
  478. package/dist/packages/engine/build/runtime-runs.js +0 -224
  479. package/dist/packages/engine/build/runtime.d.ts +0 -5
  480. package/dist/packages/engine/build/runtime.js +0 -4
  481. package/dist/packages/engine/build/source-files.d.ts +0 -46
  482. package/dist/packages/engine/build/source-files.js +0 -149
  483. package/dist/packages/engine/build/state-artifacts.d.ts +0 -9
  484. package/dist/packages/engine/build/state-artifacts.js +0 -14
  485. package/dist/packages/engine/build/state-health.d.ts +0 -4
  486. package/dist/packages/engine/build/state-io.d.ts +0 -11
  487. package/dist/packages/engine/build/state-io.js +0 -82
  488. package/dist/packages/engine/build/state-paths.js +0 -16
  489. package/dist/packages/engine/build/state-view.d.ts +0 -5
  490. package/dist/packages/engine/build/state.d.ts +0 -7
  491. package/dist/packages/engine/build/state.js +0 -12
  492. package/dist/packages/engine/build/validate-helpers.d.ts +0 -12
  493. package/dist/packages/engine/build/validate-helpers.js +0 -41
  494. package/dist/packages/engine/build/verifiable-context-paths.d.ts +0 -47
  495. package/dist/packages/engine/build/verifiable-context-paths.js +0 -121
  496. package/dist/packages/engine/build/verifiable-context-schema.d.ts +0 -21
  497. package/dist/packages/engine/build/verifiable-context-schema.js +0 -126
  498. package/dist/packages/engine/cloud-seams.d.ts +0 -115
  499. package/dist/packages/engine/cloud-seams.js +0 -84
  500. package/dist/packages/engine/index.d.ts +0 -22
  501. package/dist/packages/engine/index.js +0 -15
  502. package/dist/packages/engine/instance-paths.d.ts +0 -106
  503. package/dist/packages/engine/instance-paths.js +0 -171
  504. package/dist/packages/engine/lib/schema.d.ts +0 -6304
  505. package/dist/packages/engine/lib/schema.js +0 -730
  506. package/dist/packages/engine/preparation-store.d.ts +0 -105
  507. package/dist/packages/engine/preparation-store.js +0 -213
  508. package/dist/packages/engine/readiness-check-draft.d.ts +0 -20
  509. package/dist/packages/engine/readiness-check-draft.js +0 -111
  510. package/dist/packages/engine/requested-artifacts.d.ts +0 -5
  511. package/dist/packages/engine/routes.d.ts +0 -85
  512. package/dist/packages/engine/routes.js +0 -99
  513. package/dist/packages/engine/runtime-caches.d.ts +0 -76
  514. package/dist/packages/engine/runtime-proposal-helpers.d.ts +0 -35
  515. package/dist/packages/engine/runtime-proposal-helpers.js +0 -247
  516. package/dist/packages/engine/runtime.d.ts +0 -371
  517. package/dist/packages/engine/runtime.js +0 -2463
  518. package/dist/packages/engine/server.d.ts +0 -58
  519. package/dist/packages/engine/server.js +0 -1399
  520. package/dist/packages/engine/verify/readiness-check-run.d.ts +0 -82
  521. package/dist/packages/engine/verify/readiness-check-run.js +0 -265
  522. package/dist/packages/engine/verify/verify-paths.js +0 -61
  523. package/dist/packages/engine/verify/verify-sandbox.js +0 -88
  524. package/dist/packages/engine/verify/verify-targets.d.ts +0 -5
  525. package/dist/packages/engine/wire-schemas.d.ts +0 -547
  526. package/dist/packages/engine/wire-schemas.js +0 -59
  527. package/dist/packages/project/index.d.ts +0 -9
  528. package/dist/packages/project/interf-bootstrap.d.ts +0 -1
  529. package/dist/packages/project/interf-bootstrap.js +0 -1
  530. package/dist/packages/project/interf-scaffold.d.ts +0 -3
  531. package/dist/packages/project/interf-scaffold.js +0 -136
  532. package/dist/packages/project/interf.d.ts +0 -4
  533. package/dist/packages/project/interf.js +0 -3
  534. package/dist/packages/project/lib/schema.d.ts +0 -328
  535. package/dist/packages/project/lib/schema.js +0 -136
  536. package/dist/packages/project/preparation-entries.d.ts +0 -11
  537. package/dist/packages/project/preparation-entries.js +0 -49
  538. package/dist/packages/project/source-config.d.ts +0 -46
  539. package/dist/packages/project/source-config.js +0 -394
  540. package/dist/packages/project/source-folders.d.ts +0 -11
  541. package/public-repo/plugins/README.md +0 -9
  542. package/public-repo/plugins/interf/.claude-plugin/plugin.json +0 -21
  543. package/public-repo/plugins/interf/.mcp.json +0 -12
  544. package/public-repo/plugins/interf/README.md +0 -32
  545. package/public-repo/plugins/interf/skills/interf/SKILL.md +0 -376
  546. /package/dist/packages/{engine/agents/lib/types.js → runtime/actions/fields.js} +0 -0
  547. /package/dist/packages/{engine → runtime}/agents/lib/agents.d.ts +0 -0
  548. /package/dist/packages/{engine → runtime}/agents/lib/agents.js +0 -0
  549. /package/dist/packages/{engine → runtime}/agents/lib/execution-profile.d.ts +0 -0
  550. /package/dist/packages/{engine → runtime}/agents/lib/execution.d.ts +0 -0
  551. /package/dist/packages/{engine → runtime}/agents/lib/executors.d.ts +0 -0
  552. /package/dist/packages/{engine → runtime}/agents/lib/executors.js +0 -0
  553. /package/dist/packages/{engine → runtime}/agents/lib/logs.d.ts +0 -0
  554. /package/dist/packages/{engine → runtime}/agents/lib/logs.js +0 -0
  555. /package/dist/packages/{engine → runtime}/agents/lib/preflight.d.ts +0 -0
  556. /package/dist/packages/{engine → runtime}/agents/lib/render.d.ts +0 -0
  557. /package/dist/packages/{engine → runtime}/agents/lib/status.d.ts +0 -0
  558. /package/dist/packages/{engine → runtime}/agents/lib/status.js +0 -0
  559. /package/dist/packages/{engine → runtime}/agents/lib/types.d.ts +0 -0
  560. /package/dist/packages/{engine/build/runtime-types.js → runtime/agents/lib/types.js} +0 -0
  561. /package/dist/packages/{engine/verify/verify-types.js → runtime/agents/providers/types.js} +0 -0
  562. /package/dist/packages/{engine → runtime}/agents/role-router.d.ts +0 -0
  563. /package/dist/packages/{engine → runtime}/build/build-execution.d.ts +0 -0
  564. /package/dist/packages/{engine → runtime}/build/build-execution.js +0 -0
  565. /package/dist/packages/{engine → runtime}/build/runtime-contracts.d.ts +0 -0
  566. /package/dist/packages/{engine → runtime}/build/runtime-paths.d.ts +0 -0
  567. /package/dist/packages/{engine → runtime}/build/runtime-prompt.d.ts +0 -0
  568. /package/dist/packages/{engine → runtime}/execution/adapters.d.ts +0 -0
  569. /package/dist/packages/{engine → runtime}/execution/adapters.js +0 -0
  570. /package/dist/packages/{engine → runtime}/execution/events.d.ts +0 -0
  571. /package/dist/packages/{engine → runtime}/execution/events.js +0 -0
  572. /package/dist/packages/{engine → runtime}/verify/verify-execution.d.ts +0 -0
  573. /package/dist/packages/{engine → runtime}/verify/verify-profile-presets.d.ts +0 -0
  574. /package/dist/packages/{engine → runtime}/verify/verify-profile-presets.js +0 -0
  575. /package/dist/packages/{engine → runtime}/verify/verify-types.d.ts +0 -0
@@ -0,0 +1,128 @@
1
+ import { z } from "zod";
2
+ import { ActionValueIdPattern, actionIdField, optionalActionIdField, optionalActionText, requiredActionText, } from "./schemas.js";
3
+ import { maybeActionValue } from "./helpers.js";
4
+ void ActionValueIdPattern;
5
+ export function createProjectSchema(existingNames) {
6
+ return z.object({
7
+ name: actionIdField("Project name"),
8
+ path: requiredActionText("Source"),
9
+ build_plan: optionalActionIdField("Build Plan").optional(),
10
+ }).strict().superRefine((values, ctx) => {
11
+ if (existingNames.has(values.name)) {
12
+ ctx.addIssue({
13
+ code: z.ZodIssueCode.custom,
14
+ path: ["name"],
15
+ message: "A Project with this name already exists.",
16
+ });
17
+ }
18
+ });
19
+ }
20
+ export function prepareRunSchema() {
21
+ return z.object({
22
+ project: actionIdField("Project"),
23
+ build_plan: optionalActionIdField("Build Plan"),
24
+ source_folder_path: optionalActionText,
25
+ }).strict();
26
+ }
27
+ export function selectBuildPlanSchema() {
28
+ return z.object({
29
+ name: actionIdField("Project"),
30
+ path: requiredActionText("Source"),
31
+ current_build_plan: optionalActionIdField("Current Build Plan"),
32
+ build_plan: actionIdField("Build Plan"),
33
+ }).strict();
34
+ }
35
+ export function buildPlanAuthoringSchema(existingBuildPlanIds) {
36
+ return z.object({
37
+ build_plan_id: optionalActionIdField("Build Plan id"),
38
+ label: optionalActionText,
39
+ hint: optionalActionText,
40
+ intent: requiredActionText("Intent"),
41
+ requested_artifacts_description: optionalActionText,
42
+ user_prep_instructions: optionalActionText,
43
+ }).strict().superRefine((values, ctx) => {
44
+ const explicitBuildPlanId = maybeActionValue(values.build_plan_id ?? "");
45
+ if (explicitBuildPlanId && existingBuildPlanIds.has(explicitBuildPlanId)) {
46
+ ctx.addIssue({
47
+ code: z.ZodIssueCode.custom,
48
+ path: ["build_plan_id"],
49
+ message: "A Build Plan with this id already exists.",
50
+ });
51
+ }
52
+ });
53
+ }
54
+ export function buildPlanChangeSchema(action, buildPlanId, existingBuildPlanIds) {
55
+ const base = {
56
+ action: requiredActionText("Action"),
57
+ build_plan: actionIdField("Build Plan"),
58
+ project: optionalActionIdField("Project"),
59
+ };
60
+ if (action === "modify") {
61
+ return z.object({
62
+ ...base,
63
+ change_request: requiredActionText("Requested change"),
64
+ label: optionalActionText,
65
+ hint: optionalActionText,
66
+ }).strict();
67
+ }
68
+ if (action === "duplicate") {
69
+ return z.object({
70
+ ...base,
71
+ new_build_plan_id: actionIdField("New Build Plan id"),
72
+ }).strict().superRefine((values, ctx) => {
73
+ if (existingBuildPlanIds.has(values.new_build_plan_id)) {
74
+ ctx.addIssue({
75
+ code: z.ZodIssueCode.custom,
76
+ path: ["new_build_plan_id"],
77
+ message: "A Build Plan with this id already exists.",
78
+ });
79
+ }
80
+ });
81
+ }
82
+ return z.object({
83
+ ...base,
84
+ confirmation: requiredActionText("Confirmation").refine((value) => value === buildPlanId, `Type ${buildPlanId} to confirm.`),
85
+ }).strict();
86
+ }
87
+ export function projectChangeSchema(action, project, existingNames) {
88
+ const base = {
89
+ action: requiredActionText("Action"),
90
+ project: actionIdField("Project"),
91
+ };
92
+ if (action === "modify") {
93
+ return z.object({
94
+ ...base,
95
+ name: actionIdField("Project id"),
96
+ path: requiredActionText("Source"),
97
+ build_plan: optionalActionIdField("Build Plan"),
98
+ }).strict().superRefine((values, ctx) => {
99
+ if (values.name !== project && existingNames.has(values.name)) {
100
+ ctx.addIssue({
101
+ code: z.ZodIssueCode.custom,
102
+ path: ["name"],
103
+ message: "A Project with this name already exists.",
104
+ });
105
+ }
106
+ });
107
+ }
108
+ if (action === "duplicate") {
109
+ return z.object({
110
+ ...base,
111
+ name: actionIdField("New Project id"),
112
+ path: requiredActionText("Source"),
113
+ build_plan: optionalActionIdField("Build Plan"),
114
+ }).strict().superRefine((values, ctx) => {
115
+ if (existingNames.has(values.name)) {
116
+ ctx.addIssue({
117
+ code: z.ZodIssueCode.custom,
118
+ path: ["name"],
119
+ message: "A Project with this name already exists.",
120
+ });
121
+ }
122
+ });
123
+ }
124
+ return z.object({
125
+ ...base,
126
+ confirmation: requiredActionText("Confirmation").refine((value) => value === project, `Type ${project} to confirm.`),
127
+ }).strict();
128
+ }
@@ -0,0 +1,11 @@
1
+ import { type BuildPlanAuthoringActionValues } from "./schemas.js";
2
+ import type { ActionFieldOption, ActionInputValues, BuildPlanActionChoice } from "./fields.js";
3
+ export declare function buildPlanAuthoringIntentBrief(values: BuildPlanAuthoringActionValues): string;
4
+ export declare function slugForActionId(value: string): string;
5
+ export declare function uniqueActionId(seed: string, usedIds: Set<string>): string;
6
+ export declare function titleFromActionId(value: string): string;
7
+ export declare function maybeActionValue(value: string): string | undefined;
8
+ export declare function inputValue(values: ActionInputValues, key: string): string;
9
+ export declare function buildPlanChoiceOptions(buildPlans: BuildPlanActionChoice[]): ActionFieldOption[];
10
+ export declare function buildPlanIntentFromInput(values: ActionInputValues): string;
11
+ export declare function conciseSummary(value: string, fallback: string): string;
@@ -0,0 +1,80 @@
1
+ import { formatRequestedArtifactsForPrompt } from "../requested-artifacts.js";
2
+ import { BuildPlanAuthoringActionValuesSchema, } from "./schemas.js";
3
+ export function buildPlanAuthoringIntentBrief(values) {
4
+ const requestedArtifacts = values.requested_artifacts?.length
5
+ ? formatRequestedArtifactsForPrompt(values.requested_artifacts)
6
+ : null;
7
+ const requestedArtifactsDescription = values.requested_artifacts_description?.trim();
8
+ const prepInstructions = values.user_prep_instructions?.trim();
9
+ return [
10
+ `Intent: ${values.intent}`,
11
+ requestedArtifacts ? `Requested Artifacts:\n${requestedArtifacts}` : null,
12
+ requestedArtifactsDescription ? `Requested Artifacts: ${requestedArtifactsDescription}` : null,
13
+ prepInstructions ? `Build instructions: ${prepInstructions}` : null,
14
+ ].filter((line) => Boolean(line)).join("\n");
15
+ }
16
+ export function slugForActionId(value) {
17
+ const slug = value
18
+ .toLowerCase()
19
+ .replace(/[^a-z0-9]+/g, "-")
20
+ .replace(/^-+|-+$/g, "")
21
+ .slice(0, 72)
22
+ .replace(/-+$/g, "");
23
+ return slug || "project";
24
+ }
25
+ export function uniqueActionId(seed, usedIds) {
26
+ const base = slugForActionId(seed);
27
+ if (!usedIds.has(base))
28
+ return base;
29
+ for (let index = 2; index < 100; index += 1) {
30
+ const candidate = `${base}-${index}`;
31
+ if (!usedIds.has(candidate))
32
+ return candidate;
33
+ }
34
+ return `${base}-${Date.now().toString(36)}`;
35
+ }
36
+ export function titleFromActionId(value) {
37
+ return value
38
+ .split("-")
39
+ .filter(Boolean)
40
+ .map((part) => `${part.charAt(0).toUpperCase()}${part.slice(1)}`)
41
+ .join(" ");
42
+ }
43
+ export function maybeActionValue(value) {
44
+ const trimmed = value.trim();
45
+ return trimmed.length > 0 ? trimmed : undefined;
46
+ }
47
+ export function inputValue(values, key) {
48
+ return values[key] ?? "";
49
+ }
50
+ export function buildPlanChoiceOptions(buildPlans) {
51
+ const seen = new Set();
52
+ const options = [];
53
+ for (const buildPlan of [{ id: "interf-default", label: "interf-default" }, ...buildPlans]) {
54
+ if (seen.has(buildPlan.id))
55
+ continue;
56
+ seen.add(buildPlan.id);
57
+ options.push({ label: buildPlan.label ?? buildPlan.id, value: buildPlan.id });
58
+ }
59
+ return options;
60
+ }
61
+ export function buildPlanIntentFromInput(values) {
62
+ const parsed = BuildPlanAuthoringActionValuesSchema.safeParse(values);
63
+ if (parsed.success)
64
+ return buildPlanAuthoringIntentBrief(parsed.data);
65
+ const intent = inputValue(values, "intent");
66
+ const requestedArtifactsDescription = inputValue(values, "requested_artifacts_description");
67
+ const prepInstructions = inputValue(values, "user_prep_instructions");
68
+ return [
69
+ `Intent: ${intent}`,
70
+ maybeActionValue(requestedArtifactsDescription) ? `Requested Artifacts: ${requestedArtifactsDescription}` : null,
71
+ maybeActionValue(prepInstructions) ? `Build instructions: ${prepInstructions}` : null,
72
+ ].filter((line) => Boolean(line)).join("\n");
73
+ }
74
+ export function conciseSummary(value, fallback) {
75
+ const normalized = value.replace(/\s+/g, " ").trim();
76
+ if (!normalized)
77
+ return fallback;
78
+ const sentence = normalized.match(/^.{24,180}?(?:[.!?](?:\s|$)|$)/)?.[0]?.trim() ?? normalized;
79
+ return sentence.length > 180 ? `${sentence.slice(0, 177).trim()}...` : sentence;
80
+ }
@@ -0,0 +1,8 @@
1
+ export * from "./schemas.js";
2
+ export * from "./registry.js";
3
+ export * from "./fields.js";
4
+ export * from "./errors.js";
5
+ export * from "./helpers.js";
6
+ export * from "./form-validators.js";
7
+ export * from "./requests.js";
8
+ export * from "./form-builders.js";
@@ -0,0 +1,11 @@
1
+ // Aggregate barrel for engine action definitions. Re-exports the public
2
+ // surface so existing callers (UI page.tsx, CLI commands, action-values.ts)
3
+ // don't have to know which sibling file owns a given symbol.
4
+ export * from "./schemas.js";
5
+ export * from "./registry.js";
6
+ export * from "./fields.js";
7
+ export * from "./errors.js";
8
+ export * from "./helpers.js";
9
+ export * from "./form-validators.js";
10
+ export * from "./requests.js";
11
+ export * from "./form-builders.js";
@@ -0,0 +1,64 @@
1
+ export declare const INTERF_SERVICE_ACTIONS: {
2
+ readonly createProject: {
3
+ readonly id: "create-project";
4
+ readonly serviceAction: "project-setup";
5
+ readonly title: "Create Project";
6
+ readonly description: "Save a Source, Build Plan, and Project activity under one Project.";
7
+ };
8
+ readonly buildRun: {
9
+ readonly id: "build-run";
10
+ readonly serviceAction: "build";
11
+ readonly title: "Build Context Graph";
12
+ readonly description: "Run the saved Build Plan against this Source and write a Context Graph.";
13
+ };
14
+ readonly selectBuildPlan: {
15
+ readonly id: "select-build-plan";
16
+ readonly serviceAction: "project-setup";
17
+ readonly title: "Select Build Plan";
18
+ readonly description: "Choose the Build Plan that will build this Project's Context Graph.";
19
+ };
20
+ readonly createBuildPlan: {
21
+ readonly id: "build-plan-draft";
22
+ readonly serviceAction: "build-plan-draft";
23
+ readonly title: "Draft Build Plan";
24
+ readonly description: "Draft a Build Plan for the Context Graph this Project should build.";
25
+ };
26
+ readonly buildPlanChange: {
27
+ readonly id: "build-plan-change";
28
+ readonly serviceAction: "build-plan-change";
29
+ readonly title: "Modify Build Plan";
30
+ readonly description: "Modify, duplicate, or remove an existing Build Plan.";
31
+ };
32
+ readonly projectChange: {
33
+ readonly id: "project-change";
34
+ readonly serviceAction: "project-change";
35
+ readonly title: "Modify Project";
36
+ readonly description: "Modify, duplicate, or remove an existing Project.";
37
+ };
38
+ readonly confirmAction: {
39
+ readonly id: "confirm-action";
40
+ readonly serviceAction: "action-proposal";
41
+ readonly title: "Confirm Request";
42
+ readonly description: "Confirm the typed Interf service request before it runs.";
43
+ };
44
+ readonly runBenchmark: {
45
+ readonly id: "run-benchmark";
46
+ readonly serviceAction: "benchmark";
47
+ readonly title: "Run Benchmark";
48
+ readonly description: "Run saved Q&A / fact-check evaluation questions against this Project.";
49
+ };
50
+ readonly draftBenchmarkQuestions: {
51
+ readonly id: "draft-benchmark-questions";
52
+ readonly serviceAction: "benchmark-question-draft";
53
+ readonly title: "Draft Benchmark Questions";
54
+ readonly description: "Ask the configured local executor to draft saved Q&A / fact-check evaluation questions.";
55
+ };
56
+ readonly improveProject: {
57
+ readonly id: "improve-project";
58
+ readonly serviceAction: "build-plan-improvement";
59
+ readonly title: "Improve Build Plan";
60
+ readonly description: "Use benchmark results and Build evidence to refine the Build Plan this Project uses.";
61
+ };
62
+ };
63
+ export type InterfServiceActionKey = keyof typeof INTERF_SERVICE_ACTIONS;
64
+ export type InterfServiceActionId = typeof INTERF_SERVICE_ACTIONS[InterfServiceActionKey]["id"];
@@ -0,0 +1,62 @@
1
+ export const INTERF_SERVICE_ACTIONS = {
2
+ createProject: {
3
+ id: "create-project",
4
+ serviceAction: "project-setup",
5
+ title: "Create Project",
6
+ description: "Save a Source, Build Plan, and Project activity under one Project.",
7
+ },
8
+ buildRun: {
9
+ id: "build-run",
10
+ serviceAction: "build",
11
+ title: "Build Context Graph",
12
+ description: "Run the saved Build Plan against this Source and write a Context Graph.",
13
+ },
14
+ selectBuildPlan: {
15
+ id: "select-build-plan",
16
+ serviceAction: "project-setup",
17
+ title: "Select Build Plan",
18
+ description: "Choose the Build Plan that will build this Project's Context Graph.",
19
+ },
20
+ createBuildPlan: {
21
+ id: "build-plan-draft",
22
+ serviceAction: "build-plan-draft",
23
+ title: "Draft Build Plan",
24
+ description: "Draft a Build Plan for the Context Graph this Project should build.",
25
+ },
26
+ buildPlanChange: {
27
+ id: "build-plan-change",
28
+ serviceAction: "build-plan-change",
29
+ title: "Modify Build Plan",
30
+ description: "Modify, duplicate, or remove an existing Build Plan.",
31
+ },
32
+ projectChange: {
33
+ id: "project-change",
34
+ serviceAction: "project-change",
35
+ title: "Modify Project",
36
+ description: "Modify, duplicate, or remove an existing Project.",
37
+ },
38
+ confirmAction: {
39
+ id: "confirm-action",
40
+ serviceAction: "action-proposal",
41
+ title: "Confirm Request",
42
+ description: "Confirm the typed Interf service request before it runs.",
43
+ },
44
+ runBenchmark: {
45
+ id: "run-benchmark",
46
+ serviceAction: "benchmark",
47
+ title: "Run Benchmark",
48
+ description: "Run saved Q&A / fact-check evaluation questions against this Project.",
49
+ },
50
+ draftBenchmarkQuestions: {
51
+ id: "draft-benchmark-questions",
52
+ serviceAction: "benchmark-question-draft",
53
+ title: "Draft Benchmark Questions",
54
+ description: "Ask the configured local executor to draft saved Q&A / fact-check evaluation questions.",
55
+ },
56
+ improveProject: {
57
+ id: "improve-project",
58
+ serviceAction: "build-plan-improvement",
59
+ title: "Improve Build Plan",
60
+ description: "Use benchmark results and Build evidence to refine the Build Plan this Project uses.",
61
+ },
62
+ };
@@ -0,0 +1,45 @@
1
+ import { artifactRequirementsFromRequestedArtifacts } from "../requested-artifacts.js";
2
+ import type { RequestedArtifact, SourceContext, BuildPlanContextCheckDraft } from "../../build-plans/authoring/brief.js";
3
+ import { type BuildPlanAuthoringActionValues, type ProjectSetupActionValues } from "./schemas.js";
4
+ import type { ActionInputValues, ActionValues, BuildPlanChangeAction, ProjectChangeAction } from "./fields.js";
5
+ export declare function normalizedBuildPlanActionValues(values: ActionInputValues, existingBuildPlanIds: Set<string>, defaultSeed: string): ActionInputValues;
6
+ export declare function createProjectActionValues(values: ActionInputValues): ProjectSetupActionValues;
7
+ export declare function selectBuildPlanActionValues(values: ActionInputValues): ProjectSetupActionValues;
8
+ export declare function projectSetupRequestFromActionValues(input: unknown): {
9
+ project: {
10
+ build_plan?: string;
11
+ name: string;
12
+ path: string;
13
+ };
14
+ build_after_setup: boolean;
15
+ setup_mode: "create" | "select-build-plan";
16
+ };
17
+ export declare function buildPlanAuthoringRequestFromActionValues(input: unknown, context: {
18
+ checks?: BuildPlanContextCheckDraft[];
19
+ project?: string | null;
20
+ requestedArtifacts?: RequestedArtifact[];
21
+ sourceContext?: SourceContext | null;
22
+ }): {
23
+ artifact_requirements: ReturnType<typeof artifactRequirementsFromRequestedArtifacts>;
24
+ base_build_plan_id?: string;
25
+ checks: BuildPlanContextCheckDraft[];
26
+ hint?: string;
27
+ label: string;
28
+ build_plan_id: string;
29
+ project?: string;
30
+ reference_build_plan_id?: string;
31
+ requested_artifacts: RequestedArtifact[];
32
+ source_context?: SourceContext | null;
33
+ intent: string;
34
+ user_prep_instructions?: string;
35
+ };
36
+ export declare function buildPlanImprovementActionValues(options: {
37
+ hint?: string;
38
+ label?: string;
39
+ buildPlanId: string;
40
+ projectName: string;
41
+ }): BuildPlanAuthoringActionValues;
42
+ export declare function buildPlanAuthoringActionValues(values: ActionInputValues): BuildPlanAuthoringActionValues;
43
+ export declare function buildPlanChangeActionValues(action: BuildPlanChangeAction, values: ActionInputValues): ActionValues;
44
+ export declare function duplicateProjectActionValues(values: ActionInputValues): ProjectSetupActionValues;
45
+ export declare function projectChangeActionValues(action: ProjectChangeAction, values: ActionInputValues): ActionValues;
@@ -0,0 +1,158 @@
1
+ import { artifactRequirementsFromRequestedArtifacts, } from "../requested-artifacts.js";
2
+ import { BuildPlanAuthoringActionValuesSchema, ProjectSetupActionValuesSchema, } from "./schemas.js";
3
+ import { conciseSummary, inputValue, maybeActionValue, titleFromActionId, uniqueActionId, } from "./helpers.js";
4
+ export function normalizedBuildPlanActionValues(values, existingBuildPlanIds, defaultSeed) {
5
+ const explicitBuildPlanId = maybeActionValue(inputValue(values, "build_plan_id"));
6
+ const intent = inputValue(values, "intent").trim();
7
+ const buildPlanId = explicitBuildPlanId ?? uniqueActionId(intent || defaultSeed || "custom-build-plan", existingBuildPlanIds);
8
+ const output = maybeActionValue(inputValue(values, "requested_artifacts_description"));
9
+ return {
10
+ ...values,
11
+ build_plan_id: buildPlanId,
12
+ label: maybeActionValue(inputValue(values, "label")) ?? titleFromActionId(buildPlanId),
13
+ hint: maybeActionValue(inputValue(values, "hint")) ?? conciseSummary(output ?? intent, "Build Plan for requested Artifacts and Context Checks."),
14
+ intent,
15
+ };
16
+ }
17
+ export function createProjectActionValues(values) {
18
+ const buildPlan = inputValue(values, "build_plan");
19
+ return {
20
+ name: inputValue(values, "name"),
21
+ path: inputValue(values, "path"),
22
+ build_after_setup: false,
23
+ ...(maybeActionValue(buildPlan) ? { build_plan: buildPlan } : {}),
24
+ };
25
+ }
26
+ export function selectBuildPlanActionValues(values) {
27
+ return {
28
+ name: inputValue(values, "name"),
29
+ path: inputValue(values, "path"),
30
+ build_plan: inputValue(values, "build_plan"),
31
+ build_after_setup: false,
32
+ setup_mode: "select-build-plan",
33
+ };
34
+ }
35
+ export function projectSetupRequestFromActionValues(input) {
36
+ const values = ProjectSetupActionValuesSchema.parse(input);
37
+ const buildPlan = values.build_plan;
38
+ return {
39
+ build_after_setup: values.build_after_setup ?? false,
40
+ setup_mode: values.setup_mode === "select-build-plan" ? "select-build-plan" : "create",
41
+ project: {
42
+ name: values.name,
43
+ path: values.path,
44
+ ...(buildPlan && buildPlan.length > 0 ? { build_plan: buildPlan } : {}),
45
+ },
46
+ };
47
+ }
48
+ export function buildPlanAuthoringRequestFromActionValues(input, context) {
49
+ const values = BuildPlanAuthoringActionValuesSchema.parse(input);
50
+ const buildPlanId = values.build_plan_id;
51
+ if (!buildPlanId) {
52
+ throw new Error("Build Plan id is required.");
53
+ }
54
+ const requestedArtifacts = values.requested_artifacts ?? context.requestedArtifacts ?? [];
55
+ const sourceContext = values.source_context ?? context.sourceContext ?? null;
56
+ const baseBuildPlanId = values.base_build_plan_id;
57
+ const referenceBuildPlanId = values.reference_build_plan_id;
58
+ return {
59
+ ...(context.project ? { project: context.project } : {}),
60
+ ...(baseBuildPlanId ? { base_build_plan_id: baseBuildPlanId } : {}),
61
+ ...(referenceBuildPlanId ? { reference_build_plan_id: referenceBuildPlanId } : {}),
62
+ build_plan_id: buildPlanId,
63
+ label: values.label ?? titleFromActionId(buildPlanId),
64
+ ...(values.hint ? { hint: values.hint } : { hint: conciseSummary(values.requested_artifacts_description ?? values.intent, "Reusable Build Plan for building Artifacts.") }),
65
+ intent: values.intent,
66
+ checks: values.checks ?? context.checks ?? [],
67
+ ...(values.user_prep_instructions ? { user_prep_instructions: values.user_prep_instructions } : {}),
68
+ requested_artifacts: requestedArtifacts,
69
+ source_context: sourceContext,
70
+ artifact_requirements: artifactRequirementsFromRequestedArtifacts(requestedArtifacts),
71
+ };
72
+ }
73
+ export function buildPlanImprovementActionValues(options) {
74
+ return {
75
+ build_plan_id: options.buildPlanId,
76
+ reference_build_plan_id: options.buildPlanId,
77
+ ...(maybeActionValue(options.label ?? "") ? { label: options.label } : {}),
78
+ ...(maybeActionValue(options.hint ?? "") ? { hint: options.hint } : {}),
79
+ intent: `Improve Build Plan ${options.buildPlanId} using the latest benchmark results and Build evidence for Project ${options.projectName}.`,
80
+ };
81
+ }
82
+ export function buildPlanAuthoringActionValues(values) {
83
+ const buildPlanId = inputValue(values, "build_plan_id");
84
+ const label = inputValue(values, "label");
85
+ const hint = inputValue(values, "hint");
86
+ const requestedArtifactsDescription = inputValue(values, "requested_artifacts_description");
87
+ const userPrepInstructions = inputValue(values, "user_prep_instructions");
88
+ return {
89
+ ...(maybeActionValue(buildPlanId) ? { build_plan_id: buildPlanId } : {}),
90
+ ...(maybeActionValue(label) ? { label } : {}),
91
+ ...(maybeActionValue(hint) ? { hint } : {}),
92
+ intent: inputValue(values, "intent"),
93
+ ...(maybeActionValue(requestedArtifactsDescription) ? { requested_artifacts_description: requestedArtifactsDescription } : {}),
94
+ ...(maybeActionValue(userPrepInstructions) ? { user_prep_instructions: userPrepInstructions } : {}),
95
+ };
96
+ }
97
+ export function buildPlanChangeActionValues(action, values) {
98
+ if (action === "modify") {
99
+ const buildPlanId = inputValue(values, "build_plan");
100
+ return {
101
+ build_plan_id: buildPlanId,
102
+ reference_build_plan_id: buildPlanId,
103
+ ...(maybeActionValue(inputValue(values, "label")) ? { label: inputValue(values, "label") } : {}),
104
+ ...(maybeActionValue(inputValue(values, "hint")) ? { hint: inputValue(values, "hint") } : {}),
105
+ intent: [
106
+ `Modify Build Plan ${buildPlanId}.`,
107
+ inputValue(values, "change_request"),
108
+ ].filter(Boolean).join("\n"),
109
+ };
110
+ }
111
+ if (action === "duplicate") {
112
+ const newBuildPlanId = inputValue(values, "new_build_plan_id");
113
+ return {
114
+ action_type: "build-plan-change",
115
+ operation: "duplicate",
116
+ build_plan: inputValue(values, "build_plan"),
117
+ new_build_plan_id: newBuildPlanId,
118
+ label: titleFromActionId(newBuildPlanId),
119
+ hint: `Duplicate of ${inputValue(values, "build_plan")}`,
120
+ };
121
+ }
122
+ return {
123
+ action_type: "build-plan-change",
124
+ operation: "remove",
125
+ build_plan: inputValue(values, "build_plan"),
126
+ confirmation: inputValue(values, "confirmation"),
127
+ };
128
+ }
129
+ export function duplicateProjectActionValues(values) {
130
+ const buildPlan = inputValue(values, "build_plan");
131
+ return {
132
+ name: inputValue(values, "name"),
133
+ path: inputValue(values, "path"),
134
+ build_after_setup: false,
135
+ setup_mode: "create",
136
+ ...(maybeActionValue(buildPlan) ? { build_plan: buildPlan } : {}),
137
+ };
138
+ }
139
+ export function projectChangeActionValues(action, values) {
140
+ if (action === "modify") {
141
+ const buildPlan = inputValue(values, "build_plan");
142
+ return {
143
+ name: inputValue(values, "project"),
144
+ path: inputValue(values, "path"),
145
+ build_after_setup: false,
146
+ setup_mode: "select-build-plan",
147
+ ...(maybeActionValue(buildPlan) ? { build_plan: buildPlan } : {}),
148
+ };
149
+ }
150
+ if (action === "duplicate")
151
+ return duplicateProjectActionValues(values);
152
+ return {
153
+ action_type: "project-change",
154
+ operation: "remove",
155
+ project: inputValue(values, "project"),
156
+ confirmation: inputValue(values, "confirmation"),
157
+ };
158
+ }