@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,2 @@
1
+ import type { CommandModule } from "yargs";
2
+ export declare const projectCommand: CommandModule;
@@ -0,0 +1,176 @@
1
+ /**
2
+ * `interf project` — Project CRUD against a connected instance.
3
+ *
4
+ * interf project ls
5
+ * interf project create <id> --source <path> --intent "..." [--build-plan <id>]
6
+ * interf project show <id>
7
+ * interf project rm <id>
8
+ * Every subcommand requires an active connection. If `~/.interf/connection.json`
9
+ * is missing or unreachable, the command exits non-zero with the
10
+ * connect-or-error hint.
11
+ */
12
+ import { resolve } from "node:path";
13
+ import chalk from "chalk";
14
+ import { callJson, resolveConnection as requireConnection } from "../lib/http-client.js";
15
+ import { projectResourcePath } from "../../packages/runtime/service/routes.js";
16
+ import { ProjectListResponseSchema, ProjectResourceSchema, ProjectWireShapeSchema, } from "../../packages/runtime/schemas/index.js";
17
+ function statusColor(status) {
18
+ if (status === "ready")
19
+ return chalk.green;
20
+ if (status === "failed")
21
+ return chalk.red;
22
+ if (status === "skipped")
23
+ return chalk.dim;
24
+ return chalk.yellow;
25
+ }
26
+ function renderProjectSummary(project) {
27
+ console.log();
28
+ console.log(` ${chalk.bold(project.name)}`);
29
+ console.log(chalk.dim(` Build Plan: ${project.build_plan_id ?? "(not selected)"}`));
30
+ if (project.intent)
31
+ console.log(chalk.dim(` agent task: ${project.intent}`));
32
+ if (project.source_path)
33
+ console.log(chalk.dim(` source: ${project.source_path}`));
34
+ const contextGraphPath = project.context_graph_path;
35
+ if (contextGraphPath) {
36
+ console.log(chalk.dim(` Context Graph: ${contextGraphPath}`));
37
+ }
38
+ if (project.readiness?.status) {
39
+ const aggColor = project.readiness.ready ? chalk.green : chalk.yellow;
40
+ console.log(` readiness: ${aggColor(project.readiness.status)}${project.readiness.summary ? chalk.dim(` (${project.readiness.summary})`) : ""}`);
41
+ }
42
+ if (project.artifacts && project.artifacts.length > 0) {
43
+ console.log();
44
+ console.log(chalk.bold(" Outputs"));
45
+ const idWidth = Math.max(...project.artifacts.map((entry) => entry.artifact_id.length), 8);
46
+ for (const artifact of project.artifacts) {
47
+ const colored = statusColor(artifact.status)(artifact.status);
48
+ const stages = artifact.built_by_stages && artifact.built_by_stages.length > 0
49
+ ? chalk.dim(` ← ${artifact.built_by_stages.join(", ")}`)
50
+ : "";
51
+ console.log(` ${artifact.artifact_id.padEnd(idWidth)} ${colored}${stages}`);
52
+ }
53
+ }
54
+ if (project.latest_build_run_id) {
55
+ console.log();
56
+ console.log(chalk.dim(` latest Build: ${project.latest_build_run_id}`));
57
+ }
58
+ if (project.latest_benchmark_run_id) {
59
+ console.log(chalk.dim(` latest benchmark: ${project.latest_benchmark_run_id}`));
60
+ }
61
+ console.log();
62
+ console.log(chalk.dim(` Run with --json for the raw resource record.`));
63
+ console.log();
64
+ }
65
+ export const projectCommand = {
66
+ command: "project <subcommand>",
67
+ describe: "Manage Projects on the connected instance",
68
+ aliases: [],
69
+ builder: (yargs) => yargs
70
+ .option("url", { type: "string", describe: "Override the active connection URL" })
71
+ .option("token", { type: "string", describe: "Override the active bearer token" })
72
+ .command("ls", "List Projects", (y) => y, async (args) => {
73
+ const { url, token } = requireConnection(args);
74
+ const { status, body, raw } = await callJson(`${url}/v1/projects`, token);
75
+ if (status !== 200 || !body) {
76
+ console.error(chalk.red(`Failed to list Projects (HTTP ${status}).`));
77
+ if (raw)
78
+ console.error(raw);
79
+ process.exit(1);
80
+ }
81
+ const parsed = ProjectListResponseSchema.safeParse(body);
82
+ if (!parsed.success) {
83
+ console.error(chalk.red("Failed to parse Project list."));
84
+ process.exit(1);
85
+ }
86
+ const projects = parsed.data.projects;
87
+ if (projects.length === 0) {
88
+ console.log(chalk.dim(" No Projects yet. Create one with `interf project create <id> --source <path> --intent \"<agent task>\"`."));
89
+ return;
90
+ }
91
+ console.log();
92
+ console.log(chalk.bold(" Projects"));
93
+ console.log();
94
+ for (const project of projects) {
95
+ const sourceLabel = project.source.locator;
96
+ const buildPlan = project.build_plan_id ?? "(no Build Plan)";
97
+ console.log(` ${project.id}`);
98
+ console.log(chalk.dim(` agent task: ${project.intent}`));
99
+ console.log(chalk.dim(` source: ${sourceLabel}`));
100
+ console.log(chalk.dim(` Build Plan: ${buildPlan}`));
101
+ }
102
+ })
103
+ .command("create <project-id>", "Create a Project (Build Plan optional — select or draft it later)", (y) => y
104
+ .positional("project-id", { type: "string", demandOption: true, describe: "Project id (lowercase, dash-separated)" })
105
+ .option("source", { type: "string", demandOption: true, describe: "Path to the Source" })
106
+ .option("intent", { type: "string", demandOption: true, describe: "Agent task this Project's Context Graph should support" })
107
+ .option("build-plan", { type: "string", describe: "Build Plan id. Optional — select later with `interf plan select`." }), async (args) => {
108
+ const { url, token } = requireConnection(args);
109
+ const sourceAbs = resolve(process.cwd(), args.source);
110
+ const requestBody = {
111
+ id: args.projectId,
112
+ intent: args.intent,
113
+ source: { kind: "local-folder", locator: sourceAbs },
114
+ ...(args.buildPlan ? { build_plan_id: args.buildPlan } : {}),
115
+ };
116
+ const { status, body, raw } = await callJson(`${url}/v1/projects`, token, { method: "POST", body: JSON.stringify(requestBody) });
117
+ if (status !== 201 && status !== 200) {
118
+ console.error(chalk.red(`Failed to create Project (HTTP ${status}).`));
119
+ if (raw)
120
+ console.error(raw);
121
+ process.exit(1);
122
+ }
123
+ console.log(chalk.green(`Created Project ${chalk.bold(args.projectId)}.`));
124
+ if (!args.buildPlan) {
125
+ console.log(chalk.dim(` no Build Plan selected yet — pick or draft one before building:`));
126
+ console.log(chalk.dim(` interf plan select ${args.projectId} <plan-id>`));
127
+ console.log(chalk.dim(` interf plan draft ${args.projectId}`));
128
+ }
129
+ const parsed = ProjectWireShapeSchema.safeParse(body);
130
+ if (parsed.success && parsed.data.build_plan_id && parsed.data.context_graph.value) {
131
+ console.log(chalk.dim(` Context Graph: ${parsed.data.context_graph.value}`));
132
+ }
133
+ })
134
+ .command("show <project-id>", "Show a Project's full record", (y) => y
135
+ .positional("project-id", { type: "string", demandOption: true, describe: "Project id" })
136
+ .option("json", {
137
+ type: "boolean",
138
+ default: false,
139
+ describe: "Print the raw JSON record instead of the formatted summary",
140
+ }), async (args) => {
141
+ const { url, token } = requireConnection(args);
142
+ const { status, body, raw } = await callJson(`${url}${projectResourcePath(args.projectId)}`, token);
143
+ if (status !== 200) {
144
+ console.error(chalk.red(`Failed to read Project ${args.projectId} (HTTP ${status}).`));
145
+ if (raw)
146
+ console.error(raw);
147
+ process.exit(1);
148
+ }
149
+ if (args.json || !body) {
150
+ console.log(JSON.stringify(body, null, 2));
151
+ return;
152
+ }
153
+ const parsed = ProjectResourceSchema.safeParse(body);
154
+ if (!parsed.success) {
155
+ console.error(chalk.red(`Failed to parse Project ${args.projectId}.`));
156
+ process.exit(1);
157
+ }
158
+ renderProjectSummary(parsed.data);
159
+ })
160
+ .command("rm <project-id>", "Delete a Project", (y) => y.positional("project-id", { type: "string", demandOption: true, describe: "Project id" }), async (args) => {
161
+ const { url, token } = requireConnection(args);
162
+ const { status, raw } = await callJson(`${url}${projectResourcePath(args.projectId)}`, token, { method: "DELETE" });
163
+ if (status !== 200 && status !== 204) {
164
+ console.error(chalk.red(`Failed to delete Project ${args.projectId} (HTTP ${status}).`));
165
+ if (raw)
166
+ console.error(raw);
167
+ process.exit(1);
168
+ }
169
+ console.log(chalk.green(`Deleted Project ${chalk.bold(args.projectId)}.`));
170
+ })
171
+ .demandCommand(1)
172
+ .strict(),
173
+ handler: () => {
174
+ /* yargs subcommand handlers do the work */
175
+ },
176
+ };
@@ -1,9 +1,8 @@
1
1
  import type { CommandModule } from "yargs";
2
- interface ResetArgs {
3
- prepId: string;
2
+ import { type ConnectionArgs } from "../lib/http-client.js";
3
+ interface ResetArgs extends ConnectionArgs {
4
+ projectId: string;
4
5
  mode?: "build" | "all";
5
- url?: string;
6
- token?: string;
7
6
  }
8
7
  export declare const resetCommand: CommandModule<unknown, ResetArgs>;
9
8
  export {};
@@ -1,37 +1,16 @@
1
1
  /**
2
- * `interf reset <prep-id>` — reset a preparation's built output (or all state).
2
+ * `interf reset <project-id>` — reset a Project's built output (or all state).
3
3
  *
4
- * interf reset bristol # default mode = build
5
- * interf reset bristol --mode all # also clear Build Plan draft / runs
4
+ * interf reset bristol # default mode = build (clears the Context Graph)
5
+ * interf reset bristol --mode all # also clear Build Plan draft runs
6
6
  */
7
7
  import chalk from "chalk";
8
- import { CONNECT_OR_ERROR_HINT, readActiveConnection } from "../../packages/engine/connection-config.js";
9
- function resolveConnection(args) {
10
- const conn = readActiveConnection({
11
- urlOverride: args.url,
12
- authTokenOverride: args.token,
13
- });
14
- if (!conn) {
15
- console.error(CONNECT_OR_ERROR_HINT);
16
- process.exit(1);
17
- }
18
- return { url: conn.url.replace(/\/+$/, ""), token: conn.auth_token };
19
- }
20
- async function callJson(url, token, init = {}) {
21
- const headers = new Headers(init.headers ?? {});
22
- if (token)
23
- headers.set("authorization", `Bearer ${token}`);
24
- if (init.body && !headers.has("content-type"))
25
- headers.set("content-type", "application/json");
26
- const response = await fetch(url, { ...init, headers });
27
- const raw = await response.text();
28
- return { status: response.status, raw };
29
- }
8
+ import { callJson, resolveConnection } from "../lib/http-client.js";
30
9
  export const resetCommand = {
31
- command: "reset <prep-id>",
32
- describe: "Reset a preparation's built output",
10
+ command: "reset <project-id>",
11
+ describe: "Reset a Project's built output",
33
12
  builder: (yargs) => yargs
34
- .positional("prep-id", { type: "string", demandOption: true, describe: "Preparation id" })
13
+ .positional("project-id", { type: "string", demandOption: true, describe: "Project id" })
35
14
  .option("mode", {
36
15
  type: "string",
37
16
  choices: ["build", "all"],
@@ -42,13 +21,13 @@ export const resetCommand = {
42
21
  .option("token", { type: "string", describe: "Override the active bearer token" }),
43
22
  handler: async (args) => {
44
23
  const { url, token } = resolveConnection(args);
45
- const { status, raw } = await callJson(`${url}/v1/preparations/${encodeURIComponent(args.prepId)}/reset`, token, { method: "POST", body: JSON.stringify({ scope: args.mode }) });
24
+ const { status, raw } = await callJson(`${url}/v1/projects/${encodeURIComponent(args.projectId)}/reset`, token, { method: "POST", body: JSON.stringify({ scope: args.mode }) });
46
25
  if (status !== 200 && status !== 204) {
47
- console.error(chalk.red(`Failed to reset ${args.prepId} (HTTP ${status}).`));
26
+ console.error(chalk.red(`Failed to reset ${args.projectId} (HTTP ${status}).`));
48
27
  if (raw)
49
28
  console.error(raw);
50
29
  process.exit(1);
51
30
  }
52
- console.log(chalk.green(`Reset ${chalk.bold(args.prepId)} (${args.mode}).`));
31
+ console.log(chalk.green(`Reset ${chalk.bold(args.projectId)} (${args.mode}).`));
53
32
  },
54
33
  };
@@ -1,42 +1,15 @@
1
1
  /**
2
- * `interf runs` — observe / cancel / fetch run records on the connected instance.
2
+ * `interf runs` — observe, cancel, and fetch durable run records on the connected instance.
3
3
  *
4
- * interf runs ls [--prep <id>]
4
+ * interf runs ls [--project <id>]
5
5
  * interf runs status <run-id>
6
+ * interf runs events <run-id>
7
+ * interf runs artifacts <run-id>
6
8
  * interf runs cancel <run-id>
7
9
  */
8
10
  import chalk from "chalk";
9
- import { CONNECT_OR_ERROR_HINT, readActiveConnection } from "../../packages/engine/connection-config.js";
10
- function resolveConnection(args) {
11
- const conn = readActiveConnection({
12
- urlOverride: args.url,
13
- authTokenOverride: args.token,
14
- });
15
- if (!conn) {
16
- console.error(CONNECT_OR_ERROR_HINT);
17
- process.exit(1);
18
- }
19
- return { url: conn.url.replace(/\/+$/, ""), token: conn.auth_token };
20
- }
21
- async function callJson(url, token, init = {}) {
22
- const headers = new Headers(init.headers ?? {});
23
- if (token)
24
- headers.set("authorization", `Bearer ${token}`);
25
- if (init.body && !headers.has("content-type"))
26
- headers.set("content-type", "application/json");
27
- const response = await fetch(url, { ...init, headers });
28
- const raw = await response.text();
29
- let body = null;
30
- if (raw) {
31
- try {
32
- body = JSON.parse(raw);
33
- }
34
- catch {
35
- body = null;
36
- }
37
- }
38
- return { status: response.status, body, raw };
39
- }
11
+ import { callJson, resolveConnection } from "../lib/http-client.js";
12
+ import { RunArtifactsResponseSchema, RunEventsResponseSchema, RunObservabilityListResponseSchema, RunObservabilityResourceSchema, } from "../../packages/runtime/schemas/index.js";
40
13
  function runStatusColor(status) {
41
14
  if (status === "succeeded" || status === "completed")
42
15
  return chalk.green;
@@ -54,8 +27,8 @@ function renderRunStatus(run) {
54
27
  console.log(chalk.dim(` run: ${run.run_id}`));
55
28
  if (run.run_type)
56
29
  console.log(chalk.dim(` type: ${run.run_type}`));
57
- if (run.preparation)
58
- console.log(chalk.dim(` preparation: ${run.preparation}`));
30
+ if (run.project)
31
+ console.log(chalk.dim(` project: ${run.project}`));
59
32
  if (run.build_plan)
60
33
  console.log(chalk.dim(` Build Plan: ${run.build_plan}`));
61
34
  if (run.agent_label)
@@ -64,8 +37,8 @@ function renderRunStatus(run) {
64
37
  console.log(chalk.dim(` started: ${run.started_at}`));
65
38
  if (run.finished_at)
66
39
  console.log(chalk.dim(` finished: ${run.finished_at}`));
67
- if (run.output_path ?? run.verifiable_context_path) {
68
- console.log(chalk.dim(` output: ${run.output_path ?? run.verifiable_context_path}`));
40
+ if (run.output_path) {
41
+ console.log(chalk.dim(` output: ${run.output_path}`));
69
42
  }
70
43
  if (run.trace?.run?.error?.message) {
71
44
  console.log();
@@ -83,31 +56,30 @@ function renderRunStatus(run) {
83
56
  console.log();
84
57
  console.log(chalk.bold(" Metrics"));
85
58
  for (const metric of metrics.slice(0, 8)) {
86
- const value = metric.value !== undefined ? `${metric.value}${metric.unit ? ` ${metric.unit}` : ""}` : "";
87
- console.log(chalk.dim(` ${metric.label ?? "metric"}: ${value}`));
59
+ console.log(chalk.dim(` ${metric.label}: ${metric.value}${metric.detail ? ` (${metric.detail})` : ""}`));
88
60
  }
89
61
  }
90
62
  const artifacts = run.artifacts ?? [];
91
63
  if (artifacts.length > 0) {
92
64
  console.log();
93
- console.log(chalk.bold(" Artifacts"));
65
+ console.log(chalk.bold(" Outputs"));
94
66
  for (const artifact of artifacts.slice(0, 12)) {
95
67
  const stage = artifact.stage_id ? chalk.dim(` ← ${artifact.stage_id}`) : "";
96
- console.log(` ${artifact.label ?? artifact.role}: ${chalk.dim(artifact.path)}${stage}`);
68
+ console.log(` ${artifact.label ?? "output"}: ${chalk.dim(artifact.path)}${stage}`);
97
69
  }
98
70
  if (artifacts.length > 12)
99
71
  console.log(chalk.dim(` ... ${artifacts.length - 12} more`));
100
72
  }
101
- const proof = run.proof ?? [];
102
- if (proof.length > 0) {
73
+ const checks = run.checks ?? [];
74
+ if (checks.length > 0) {
103
75
  console.log();
104
- console.log(chalk.bold(" Proof"));
105
- for (const check of proof.slice(0, 12)) {
76
+ console.log(chalk.bold(" Checks"));
77
+ for (const check of checks.slice(0, 12)) {
106
78
  const marker = check.ok ? chalk.green("pass") : chalk.red("fail");
107
79
  console.log(` ${marker} ${check.label}${check.detail ? chalk.dim(` — ${check.detail}`) : ""}`);
108
80
  }
109
- if (proof.length > 12)
110
- console.log(chalk.dim(` ... ${proof.length - 12} more`));
81
+ if (checks.length > 12)
82
+ console.log(chalk.dim(` ... ${checks.length - 12} more`));
111
83
  }
112
84
  const events = run.trace?.events ?? [];
113
85
  if (events.length > 0) {
@@ -121,13 +93,50 @@ function renderRunStatus(run) {
121
93
  console.log(chalk.dim(" Run with --json for the raw run resource."));
122
94
  console.log();
123
95
  }
96
+ function renderEvents(events) {
97
+ if (events.length === 0) {
98
+ console.log(chalk.dim(" No events recorded for this run."));
99
+ return;
100
+ }
101
+ console.log();
102
+ for (const event of events) {
103
+ // stage_id / path exist only on some event variants; read defensively.
104
+ const stageId = "stage_id" in event ? event.stage_id : undefined;
105
+ const path = "path" in event ? event.path : undefined;
106
+ const detail = [stageId, path].filter(Boolean).join(" · ");
107
+ console.log(` ${chalk.dim(event.timestamp)} ${chalk.bold(event.type)}${detail ? chalk.dim(` ${detail}`) : ""}`);
108
+ }
109
+ console.log();
110
+ console.log(chalk.dim(" Run with --json for full event payloads."));
111
+ console.log();
112
+ }
113
+ function renderArtifacts(artifacts) {
114
+ if (artifacts.length === 0) {
115
+ console.log(chalk.dim(" No artifacts recorded for this run."));
116
+ return;
117
+ }
118
+ console.log();
119
+ for (const artifact of artifacts) {
120
+ const stage = artifact.stage_id ? chalk.dim(` ← ${artifact.stage_id}`) : "";
121
+ console.log(` ${artifact.label ?? artifact.role}: ${chalk.dim(artifact.path)}${stage}`);
122
+ }
123
+ console.log();
124
+ }
124
125
  export const runsCommand = {
125
126
  command: "runs <subcommand>",
126
- describe: "Inspect runs on the connected instance",
127
+ describe: "Inspect durable Runs on the connected instance",
127
128
  builder: (yargs) => yargs
128
129
  .option("url", { type: "string", describe: "Override the active connection URL" })
129
130
  .option("token", { type: "string", describe: "Override the active bearer token" })
130
- .command("ls", "List runs (optionally filtered by preparation)", (y) => y.option("prep", { type: "string", describe: "Filter by preparation id" }), async (args) => {
131
+ .command("ls", "List Runs across the instance (optionally filter by Project or type)", (y) => y
132
+ .option("project", {
133
+ type: "string",
134
+ describe: "Filter by Project id",
135
+ })
136
+ .option("type", {
137
+ type: "string",
138
+ describe: "Filter by run type (build, verify, build-plan-draft, build-plan-improvement, benchmark-question-draft)",
139
+ }), async (args) => {
131
140
  const { url, token } = resolveConnection(args);
132
141
  const { status, body, raw } = await callJson(`${url}/v1/runs`, token);
133
142
  if (status !== 200) {
@@ -136,10 +145,21 @@ export const runsCommand = {
136
145
  console.error(raw);
137
146
  process.exit(1);
138
147
  }
139
- const runs = body?.runs ?? [];
140
- const visibleRuns = args.prep
141
- ? runs.filter((run) => run.preparation === args.prep)
142
- : runs;
148
+ const parsed = RunObservabilityListResponseSchema.safeParse(body);
149
+ if (!parsed.success) {
150
+ console.error(chalk.red("Failed to parse runs response."));
151
+ process.exit(1);
152
+ }
153
+ const runs = parsed.data.runs;
154
+ const projectId = args.project;
155
+ const runType = args.type;
156
+ const visibleRuns = runs.filter((run) => {
157
+ if (projectId && run.project !== projectId)
158
+ return false;
159
+ if (runType && run.run_type !== runType)
160
+ return false;
161
+ return true;
162
+ });
143
163
  if (visibleRuns.length === 0) {
144
164
  console.log(chalk.dim(" No runs."));
145
165
  return;
@@ -147,8 +167,10 @@ export const runsCommand = {
147
167
  console.log();
148
168
  for (const run of visibleRuns) {
149
169
  console.log(` ${chalk.bold(run.run_id)} ${chalk.dim(`(${run.status ?? "?"})`)}`);
150
- if (run.preparation)
151
- console.log(chalk.dim(` prep: ${run.preparation}`));
170
+ if (run.run_type)
171
+ console.log(chalk.dim(` type: ${run.run_type}`));
172
+ if (run.project)
173
+ console.log(chalk.dim(` project: ${run.project}`));
152
174
  if (run.started_at)
153
175
  console.log(chalk.dim(` started: ${run.started_at}`));
154
176
  }
@@ -171,11 +193,68 @@ export const runsCommand = {
171
193
  console.log(raw);
172
194
  return;
173
195
  }
174
- renderRunStatus(body);
196
+ const parsed = RunObservabilityResourceSchema.safeParse(body);
197
+ if (!parsed.success) {
198
+ console.error(chalk.red(`Failed to parse run ${args.runId}.`));
199
+ process.exit(1);
200
+ }
201
+ renderRunStatus(parsed.data);
202
+ })
203
+ .command("events <run-id>", "Read the durable event log for a Build run", (y) => y
204
+ .positional("run-id", { type: "string", demandOption: true, describe: "Run id" })
205
+ .option("json", {
206
+ type: "boolean",
207
+ default: false,
208
+ describe: "Print the raw JSON event array",
209
+ }), async (args) => {
210
+ const { url, token } = resolveConnection(args);
211
+ const { status, body, raw } = await callJson(`${url}/v1/runs/${encodeURIComponent(args.runId)}/events`, token);
212
+ if (status !== 200) {
213
+ console.error(chalk.red(`Failed to read events for ${args.runId} (HTTP ${status}).`));
214
+ if (raw)
215
+ console.error(raw);
216
+ process.exit(1);
217
+ }
218
+ const parsed = RunEventsResponseSchema.safeParse(body);
219
+ if (!parsed.success) {
220
+ console.error(chalk.red(`Failed to parse events for ${args.runId}.`));
221
+ process.exit(1);
222
+ }
223
+ if (args.json) {
224
+ console.log(JSON.stringify(parsed.data.events, null, 2));
225
+ return;
226
+ }
227
+ renderEvents(parsed.data.events);
228
+ })
229
+ .command("artifacts <run-id>", "Read the artifact manifest for a finished Build run", (y) => y
230
+ .positional("run-id", { type: "string", demandOption: true, describe: "Run id" })
231
+ .option("json", {
232
+ type: "boolean",
233
+ default: false,
234
+ describe: "Print the raw JSON artifact array",
235
+ }), async (args) => {
236
+ const { url, token } = resolveConnection(args);
237
+ const { status, body, raw } = await callJson(`${url}/v1/runs/${encodeURIComponent(args.runId)}/artifacts`, token);
238
+ if (status !== 200) {
239
+ console.error(chalk.red(`Failed to read artifacts for ${args.runId} (HTTP ${status}).`));
240
+ if (raw)
241
+ console.error(raw);
242
+ process.exit(1);
243
+ }
244
+ const parsed = RunArtifactsResponseSchema.safeParse(body);
245
+ if (!parsed.success) {
246
+ console.error(chalk.red(`Failed to parse artifacts for ${args.runId}.`));
247
+ process.exit(1);
248
+ }
249
+ if (args.json) {
250
+ console.log(JSON.stringify(parsed.data.artifacts, null, 2));
251
+ return;
252
+ }
253
+ renderArtifacts(parsed.data.artifacts);
175
254
  })
176
255
  .command("cancel <run-id>", "Cancel a running run", (y) => y.positional("run-id", { type: "string", demandOption: true, describe: "Run id" }), async (args) => {
177
256
  const { url, token } = resolveConnection(args);
178
- const { status, raw } = await callJson(`${url}/v1/build-runs/${encodeURIComponent(args.runId)}/cancel`, token, { method: "POST", body: JSON.stringify({}) });
257
+ const { status, raw } = await callJson(`${url}/v1/runs/${encodeURIComponent(args.runId)}/cancel`, token, { method: "POST", body: JSON.stringify({}) });
179
258
  if (status !== 200 && status !== 202 && status !== 204) {
180
259
  console.error(chalk.red(`Failed to cancel ${args.runId} (HTTP ${status}).`));
181
260
  if (raw)
@@ -0,0 +1,24 @@
1
+ import type { CommandModule } from "yargs";
2
+ export interface RuntimeArgs {
3
+ host?: string;
4
+ port?: number;
5
+ appOwned?: boolean;
6
+ parentPid?: number;
7
+ }
8
+ export interface RuntimeStopArgs {
9
+ url?: string;
10
+ token?: string;
11
+ }
12
+ export interface RuntimeStatusArgs extends RuntimeStopArgs {
13
+ requireOwnerKind?: "desktop-app" | "headless";
14
+ requireOwnerPid?: number;
15
+ }
16
+ export interface RuntimeStartArgs extends RuntimeArgs {
17
+ timeoutMs?: number;
18
+ log?: string;
19
+ }
20
+ export declare function runRuntimeForeground(args: RuntimeArgs): Promise<void>;
21
+ export declare function runRuntimeStart(args: RuntimeStartArgs): Promise<void>;
22
+ export declare function runRuntimeStop(args: RuntimeStopArgs): Promise<void>;
23
+ export declare function runRuntimeStatus(args: RuntimeStatusArgs): Promise<void>;
24
+ export declare const runtimeCommand: CommandModule;