@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
@@ -1,22 +1,32 @@
1
1
  import { z } from "zod";
2
2
  export declare const InterfIdPattern: RegExp;
3
- export declare const PreparationNamePattern: RegExp;
4
- export declare const PreparationNameSchema: z.ZodString;
3
+ export declare const ProjectIdPattern: RegExp;
4
+ export declare const ProjectIdSchema: z.ZodString;
5
5
  export declare const BuildPlanIdSchema: z.ZodString;
6
6
  /**
7
- * Build Plan-declared artifact identifier. Same shape as `BuildPlanIdSchema`
8
- * but conceptually distinct — it identifies a produced thing inside
9
- * one Build Plan, while `BuildPlanIdSchema` identifies the Build Plan itself.
7
+ * The user's agent task for a Project.
8
+ *
9
+ * Project intent is the compact, durable instruction that explains what
10
+ * the Context Graph must prepare the Source for. Build Plans operationalize
11
+ * this field, but Project owns it.
12
+ */
13
+ export declare const ProjectIntentSchema: z.ZodString;
14
+ /**
15
+ * Legacy internal output identifier. Same shape as `BuildPlanIdSchema` but
16
+ * conceptually distinct: it identifies a requested output inside one Build
17
+ * Plan, while `BuildPlanIdSchema` identifies the Build Plan itself.
18
+ *
19
+ * The exported name remains `ArtifactIdSchema` until the ABI rename lands.
10
20
  */
11
21
  export declare const ArtifactIdSchema: z.ZodString;
12
22
  export declare const RuntimeStageSchema: z.ZodString;
13
23
  export declare const RuntimeContractTypeSchema: z.ZodString;
14
24
  export declare const RuntimeTargetTypeSchema: z.ZodEnum<{
15
- "verifiable-context": "verifiable-context";
25
+ "context-graph": "context-graph";
16
26
  }>;
17
27
  export declare const TestTargetTypeSchema: z.ZodEnum<{
18
- "verifiable-context": "verifiable-context";
19
28
  "source-files": "source-files";
29
+ "context-graph": "context-graph";
20
30
  }>;
21
31
  export declare function isInterfRelativePath(value: string): boolean;
22
32
  /**
@@ -44,13 +54,17 @@ export type LocatorKind = z.infer<typeof LocatorKindSchema>;
44
54
  export type Locator = z.infer<typeof LocatorSchema>;
45
55
  export declare const SourceKindSchema: z.ZodEnum<{
46
56
  "local-folder": "local-folder";
47
- "remote-folder": "remote-folder";
48
57
  }>;
58
+ export declare const SourceBindingSchema: z.ZodObject<{
59
+ kind: z.ZodEnum<{
60
+ "local-folder": "local-folder";
61
+ }>;
62
+ locator: z.ZodString;
63
+ }, z.core.$strict>;
49
64
  export declare const SourceSchema: z.ZodObject<{
50
65
  id: z.ZodString;
51
66
  kind: z.ZodEnum<{
52
67
  "local-folder": "local-folder";
53
- "remote-folder": "remote-folder";
54
68
  }>;
55
69
  locator: z.ZodString;
56
70
  }, z.core.$strict>;
@@ -58,6 +72,7 @@ export declare const SourceFileSchema: z.ZodObject<{
58
72
  id: z.ZodString;
59
73
  path: z.ZodString;
60
74
  locator: z.ZodString;
75
+ size_bytes: z.ZodOptional<z.ZodNumber>;
61
76
  }, z.core.$strict>;
62
77
  export declare const SourceFilesSchema: z.ZodObject<{
63
78
  kind: z.ZodLiteral<"interf-source-files">;
@@ -67,7 +82,6 @@ export declare const SourceFilesSchema: z.ZodObject<{
67
82
  id: z.ZodString;
68
83
  kind: z.ZodEnum<{
69
84
  "local-folder": "local-folder";
70
- "remote-folder": "remote-folder";
71
85
  }>;
72
86
  locator: z.ZodString;
73
87
  }, z.core.$strict>;
@@ -76,19 +90,19 @@ export declare const SourceFilesSchema: z.ZodObject<{
76
90
  id: z.ZodString;
77
91
  path: z.ZodString;
78
92
  locator: z.ZodString;
93
+ size_bytes: z.ZodOptional<z.ZodNumber>;
79
94
  }, z.core.$strict>>;
80
95
  }, z.core.$strict>;
81
- export declare const SourceSnapshotSchema: z.ZodObject<{
82
- kind: z.ZodLiteral<"interf-source-snapshot">;
96
+ export declare const SourceStateSchema: z.ZodObject<{
97
+ kind: z.ZodLiteral<"interf-source-state">;
83
98
  version: z.ZodLiteral<1>;
84
- snapshot_id: z.ZodString;
99
+ graph_id: z.ZodString;
85
100
  generated_at: z.ZodString;
86
101
  run_id: z.ZodNullable<z.ZodString>;
87
102
  source: z.ZodObject<{
88
103
  id: z.ZodString;
89
104
  kind: z.ZodEnum<{
90
105
  "local-folder": "local-folder";
91
- "remote-folder": "remote-folder";
92
106
  }>;
93
107
  locator: z.ZodString;
94
108
  }, z.core.$strict>;
@@ -97,60 +111,881 @@ export declare const SourceSnapshotSchema: z.ZodObject<{
97
111
  id: z.ZodString;
98
112
  path: z.ZodString;
99
113
  locator: z.ZodString;
114
+ size_bytes: z.ZodOptional<z.ZodNumber>;
115
+ }, z.core.$strict>>;
116
+ }, z.core.$strict>;
117
+ export declare const SourceInspectableUnitSchema: z.ZodObject<{
118
+ kind: z.ZodEnum<{
119
+ file: "file";
120
+ page: "page";
121
+ slide: "slide";
122
+ sheet: "sheet";
123
+ table: "table";
124
+ image: "image";
125
+ section: "section";
126
+ }>;
127
+ index: z.ZodOptional<z.ZodNumber>;
128
+ label: z.ZodOptional<z.ZodString>;
129
+ }, z.core.$strict>;
130
+ export declare const SourceManifestEvidenceSchema: z.ZodObject<{
131
+ kind: z.ZodEnum<{
132
+ "agent-observation": "agent-observation";
133
+ "connector-metadata": "connector-metadata";
134
+ "user-provided": "user-provided";
135
+ }>;
136
+ summary: z.ZodString;
137
+ }, z.core.$strict>;
138
+ export declare const SourceManifestFileKindSchema: z.ZodEnum<{
139
+ image: "image";
140
+ pdf: "pdf";
141
+ document: "document";
142
+ spreadsheet: "spreadsheet";
143
+ presentation: "presentation";
144
+ text: "text";
145
+ other: "other";
146
+ }>;
147
+ export declare const SourceManifestFileSchema: z.ZodObject<{
148
+ id: z.ZodString;
149
+ locator: z.ZodString;
150
+ path: z.ZodString;
151
+ kind: z.ZodDefault<z.ZodEnum<{
152
+ image: "image";
153
+ pdf: "pdf";
154
+ document: "document";
155
+ spreadsheet: "spreadsheet";
156
+ presentation: "presentation";
157
+ text: "text";
158
+ other: "other";
159
+ }>>;
160
+ size_bytes: z.ZodOptional<z.ZodNumber>;
161
+ content_hash: z.ZodOptional<z.ZodString>;
162
+ page_count: z.ZodOptional<z.ZodNumber>;
163
+ inspectable_units: z.ZodDefault<z.ZodArray<z.ZodObject<{
164
+ kind: z.ZodEnum<{
165
+ file: "file";
166
+ page: "page";
167
+ slide: "slide";
168
+ sheet: "sheet";
169
+ table: "table";
170
+ image: "image";
171
+ section: "section";
172
+ }>;
173
+ index: z.ZodOptional<z.ZodNumber>;
174
+ label: z.ZodOptional<z.ZodString>;
175
+ }, z.core.$strict>>>;
176
+ confidence: z.ZodDefault<z.ZodEnum<{
177
+ high: "high";
178
+ medium: "medium";
179
+ low: "low";
180
+ }>>;
181
+ evidence: z.ZodArray<z.ZodObject<{
182
+ kind: z.ZodEnum<{
183
+ "agent-observation": "agent-observation";
184
+ "connector-metadata": "connector-metadata";
185
+ "user-provided": "user-provided";
186
+ }>;
187
+ summary: z.ZodString;
100
188
  }, z.core.$strict>>;
101
189
  }, z.core.$strict>;
190
+ export declare const SourceManifestScannerSchema: z.ZodObject<{
191
+ executor: z.ZodString;
192
+ agent_label: z.ZodString;
193
+ attempt: z.ZodNumber;
194
+ }, z.core.$strict>;
195
+ export declare const SourceManifestSchema: z.ZodObject<{
196
+ kind: z.ZodLiteral<"interf-source-manifest">;
197
+ version: z.ZodLiteral<1>;
198
+ manifest_id: z.ZodString;
199
+ generated_at: z.ZodString;
200
+ run_id: z.ZodNullable<z.ZodString>;
201
+ project: z.ZodString;
202
+ source: z.ZodObject<{
203
+ id: z.ZodString;
204
+ kind: z.ZodEnum<{
205
+ "local-folder": "local-folder";
206
+ }>;
207
+ locator: z.ZodString;
208
+ }, z.core.$strict>;
209
+ scanner: z.ZodObject<{
210
+ executor: z.ZodString;
211
+ agent_label: z.ZodString;
212
+ attempt: z.ZodNumber;
213
+ }, z.core.$strict>;
214
+ source_total: z.ZodNumber;
215
+ files: z.ZodArray<z.ZodObject<{
216
+ id: z.ZodString;
217
+ locator: z.ZodString;
218
+ path: z.ZodString;
219
+ kind: z.ZodDefault<z.ZodEnum<{
220
+ image: "image";
221
+ pdf: "pdf";
222
+ document: "document";
223
+ spreadsheet: "spreadsheet";
224
+ presentation: "presentation";
225
+ text: "text";
226
+ other: "other";
227
+ }>>;
228
+ size_bytes: z.ZodOptional<z.ZodNumber>;
229
+ content_hash: z.ZodOptional<z.ZodString>;
230
+ page_count: z.ZodOptional<z.ZodNumber>;
231
+ inspectable_units: z.ZodDefault<z.ZodArray<z.ZodObject<{
232
+ kind: z.ZodEnum<{
233
+ file: "file";
234
+ page: "page";
235
+ slide: "slide";
236
+ sheet: "sheet";
237
+ table: "table";
238
+ image: "image";
239
+ section: "section";
240
+ }>;
241
+ index: z.ZodOptional<z.ZodNumber>;
242
+ label: z.ZodOptional<z.ZodString>;
243
+ }, z.core.$strict>>>;
244
+ confidence: z.ZodDefault<z.ZodEnum<{
245
+ high: "high";
246
+ medium: "medium";
247
+ low: "low";
248
+ }>>;
249
+ evidence: z.ZodArray<z.ZodObject<{
250
+ kind: z.ZodEnum<{
251
+ "agent-observation": "agent-observation";
252
+ "connector-metadata": "connector-metadata";
253
+ "user-provided": "user-provided";
254
+ }>;
255
+ summary: z.ZodString;
256
+ }, z.core.$strict>>;
257
+ }, z.core.$strict>>;
258
+ warnings: z.ZodDefault<z.ZodArray<z.ZodString>>;
259
+ }, z.core.$strict>;
260
+ export declare const SourceManifestAuditSchema: z.ZodObject<{
261
+ kind: z.ZodLiteral<"interf-source-manifest-audit">;
262
+ version: z.ZodLiteral<1>;
263
+ run_id: z.ZodNullable<z.ZodString>;
264
+ manifest_id: z.ZodString;
265
+ generated_at: z.ZodString;
266
+ auditor: z.ZodObject<{
267
+ executor: z.ZodString;
268
+ agent_label: z.ZodString;
269
+ attempt: z.ZodNumber;
270
+ }, z.core.$strict>;
271
+ verdict: z.ZodEnum<{
272
+ pass: "pass";
273
+ fail: "fail";
274
+ "needs-review": "needs-review";
275
+ }>;
276
+ findings: z.ZodDefault<z.ZodArray<z.ZodString>>;
277
+ }, z.core.$strict>;
102
278
  export declare const StageInputSchema: z.ZodObject<{
103
279
  source_file_id: z.ZodString;
104
280
  path: z.ZodString;
105
281
  locator: z.ZodString;
282
+ kind: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
283
+ image: "image";
284
+ pdf: "pdf";
285
+ document: "document";
286
+ spreadsheet: "spreadsheet";
287
+ presentation: "presentation";
288
+ text: "text";
289
+ other: "other";
290
+ }>>>;
291
+ size_bytes: z.ZodOptional<z.ZodNumber>;
292
+ page_count: z.ZodOptional<z.ZodNumber>;
293
+ inspectable_units: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodObject<{
294
+ kind: z.ZodEnum<{
295
+ file: "file";
296
+ page: "page";
297
+ slide: "slide";
298
+ sheet: "sheet";
299
+ table: "table";
300
+ image: "image";
301
+ section: "section";
302
+ }>;
303
+ index: z.ZodOptional<z.ZodNumber>;
304
+ label: z.ZodOptional<z.ZodString>;
305
+ }, z.core.$strict>>>>;
306
+ content_hash: z.ZodOptional<z.ZodString>;
106
307
  }, z.core.$strict>;
107
308
  export declare const StageInputsSchema: z.ZodObject<{
108
309
  kind: z.ZodLiteral<"interf-stage-inputs">;
109
- version: z.ZodLiteral<1>;
310
+ version: z.ZodLiteral<3>;
110
311
  generated_at: z.ZodString;
111
312
  run_id: z.ZodNullable<z.ZodString>;
112
313
  build_plan: z.ZodString;
113
314
  stage: z.ZodString;
114
- source_snapshot_id: z.ZodString;
315
+ source_state_id: z.ZodString;
316
+ source_manifest_id: z.ZodString;
115
317
  input_total: z.ZodNumber;
116
318
  inputs: z.ZodArray<z.ZodObject<{
117
319
  source_file_id: z.ZodString;
118
320
  path: z.ZodString;
119
321
  locator: z.ZodString;
322
+ kind: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
323
+ image: "image";
324
+ pdf: "pdf";
325
+ document: "document";
326
+ spreadsheet: "spreadsheet";
327
+ presentation: "presentation";
328
+ text: "text";
329
+ other: "other";
330
+ }>>>;
331
+ size_bytes: z.ZodOptional<z.ZodNumber>;
332
+ page_count: z.ZodOptional<z.ZodNumber>;
333
+ inspectable_units: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodObject<{
334
+ kind: z.ZodEnum<{
335
+ file: "file";
336
+ page: "page";
337
+ slide: "slide";
338
+ sheet: "sheet";
339
+ table: "table";
340
+ image: "image";
341
+ section: "section";
342
+ }>;
343
+ index: z.ZodOptional<z.ZodNumber>;
344
+ label: z.ZodOptional<z.ZodString>;
345
+ }, z.core.$strict>>>>;
346
+ content_hash: z.ZodOptional<z.ZodString>;
120
347
  }, z.core.$strict>>;
121
348
  }, z.core.$strict>;
122
349
  export declare const SourceBuildMaxAttemptsSchema: z.ZodNumber;
123
350
  export declare const SourceBuildMaxLoopsSchema: z.ZodNumber;
351
+ export declare const ResourceRoleSchema: z.ZodEnum<{
352
+ source: "source";
353
+ summary: "summary";
354
+ other: "other";
355
+ knowledge: "knowledge";
356
+ entrypoint: "entrypoint";
357
+ diagnostic: "diagnostic";
358
+ }>;
359
+ export declare const MetricKeySchema: z.ZodString;
360
+ export declare const ResourceRefSchema: z.ZodObject<{
361
+ id: z.ZodString;
362
+ role: z.ZodEnum<{
363
+ source: "source";
364
+ summary: "summary";
365
+ other: "other";
366
+ knowledge: "knowledge";
367
+ entrypoint: "entrypoint";
368
+ diagnostic: "diagnostic";
369
+ }>;
370
+ kind: z.ZodString;
371
+ label: z.ZodString;
372
+ path: z.ZodOptional<z.ZodString>;
373
+ locator: z.ZodOptional<z.ZodString>;
374
+ stage_id: z.ZodOptional<z.ZodString>;
375
+ source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
376
+ links: z.ZodDefault<z.ZodArray<z.ZodString>>;
377
+ required: z.ZodDefault<z.ZodBoolean>;
378
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
379
+ }, z.core.$strict>;
380
+ export declare const MetricCountSchema: z.ZodObject<{
381
+ key: z.ZodString;
382
+ label: z.ZodString;
383
+ value: z.ZodNumber;
384
+ total: z.ZodOptional<z.ZodNumber>;
385
+ unit: z.ZodOptional<z.ZodString>;
386
+ primary: z.ZodDefault<z.ZodBoolean>;
387
+ issue_state: z.ZodOptional<z.ZodEnum<{
388
+ pass: "pass";
389
+ fail: "fail";
390
+ missing: "missing";
391
+ review: "review";
392
+ }>>;
393
+ detail: z.ZodOptional<z.ZodString>;
394
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
395
+ }, z.core.$strict>;
396
+ export declare const ReviewedInputDecisionSchema: z.ZodEnum<{
397
+ missing: "missing";
398
+ used: "used";
399
+ reviewed: "reviewed";
400
+ blocked: "blocked";
401
+ "not-relevant": "not-relevant";
402
+ }>;
403
+ export declare const ReviewedInputSchema: z.ZodObject<{
404
+ resource_id: z.ZodString;
405
+ decision: z.ZodEnum<{
406
+ missing: "missing";
407
+ used: "used";
408
+ reviewed: "reviewed";
409
+ blocked: "blocked";
410
+ "not-relevant": "not-relevant";
411
+ }>;
412
+ reason: z.ZodOptional<z.ZodString>;
413
+ output_resource_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
414
+ source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
415
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
416
+ }, z.core.$strict>;
417
+ export declare const MissingInputSchema: z.ZodObject<{
418
+ resource_id: z.ZodString;
419
+ status: z.ZodEnum<{
420
+ missing: "missing";
421
+ blocked: "blocked";
422
+ "not-relevant": "not-relevant";
423
+ }>;
424
+ reason: z.ZodString;
425
+ }, z.core.$strict>;
426
+ /**
427
+ * Stage runtime-file contracts: the `expected-inputs.json` and
428
+ * `reviewed-inputs.json` files a stage shell reads and writes. Defined once
429
+ * here so the build engine (stage-manifest writer, native entrypoint reader)
430
+ * and any future client validate against one shape instead of a hand-rolled
431
+ * parallel `interface`.
432
+ */
433
+ export declare const ExpectedInputsFileSchema: z.ZodObject<{
434
+ kind: z.ZodLiteral<"interf-stage-expected-inputs">;
435
+ version: z.ZodLiteral<1>;
436
+ generated_at: z.ZodString;
437
+ stage_id: z.ZodString;
438
+ expected: z.ZodArray<z.ZodObject<{
439
+ id: z.ZodString;
440
+ role: z.ZodEnum<{
441
+ source: "source";
442
+ summary: "summary";
443
+ other: "other";
444
+ knowledge: "knowledge";
445
+ entrypoint: "entrypoint";
446
+ diagnostic: "diagnostic";
447
+ }>;
448
+ kind: z.ZodString;
449
+ label: z.ZodString;
450
+ path: z.ZodOptional<z.ZodString>;
451
+ locator: z.ZodOptional<z.ZodString>;
452
+ stage_id: z.ZodOptional<z.ZodString>;
453
+ source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
454
+ links: z.ZodDefault<z.ZodArray<z.ZodString>>;
455
+ required: z.ZodDefault<z.ZodBoolean>;
456
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
457
+ }, z.core.$strict>>;
458
+ }, z.core.$strict>;
459
+ export type ExpectedInputsFile = z.infer<typeof ExpectedInputsFileSchema>;
460
+ export declare const ReviewedInputsFileSchema: z.ZodObject<{
461
+ kind: z.ZodLiteral<"interf-stage-reviewed-inputs">;
462
+ version: z.ZodLiteral<1>;
463
+ generated_at: z.ZodString;
464
+ stage_id: z.ZodString;
465
+ reviewed: z.ZodArray<z.ZodObject<{
466
+ resource_id: z.ZodString;
467
+ decision: z.ZodEnum<{
468
+ missing: "missing";
469
+ used: "used";
470
+ reviewed: "reviewed";
471
+ blocked: "blocked";
472
+ "not-relevant": "not-relevant";
473
+ }>;
474
+ reason: z.ZodOptional<z.ZodString>;
475
+ output_resource_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
476
+ source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
477
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
478
+ }, z.core.$strict>>;
479
+ }, z.core.$strict>;
480
+ export type ReviewedInputsFile = z.infer<typeof ReviewedInputsFileSchema>;
481
+ export declare const StageManifestSchema: z.ZodObject<{
482
+ kind: z.ZodLiteral<"interf-stage-manifest">;
483
+ version: z.ZodLiteral<1>;
484
+ generated_at: z.ZodString;
485
+ project: z.ZodString;
486
+ run_id: z.ZodNullable<z.ZodString>;
487
+ build_plan: z.ZodString;
488
+ stage_id: z.ZodString;
489
+ stage_label: z.ZodString;
490
+ role: z.ZodEnum<{
491
+ source: "source";
492
+ summary: "summary";
493
+ other: "other";
494
+ knowledge: "knowledge";
495
+ entrypoint: "entrypoint";
496
+ diagnostic: "diagnostic";
497
+ }>;
498
+ summary: z.ZodString;
499
+ input_manifests: z.ZodDefault<z.ZodArray<z.ZodObject<{
500
+ id: z.ZodString;
501
+ role: z.ZodEnum<{
502
+ source: "source";
503
+ summary: "summary";
504
+ other: "other";
505
+ knowledge: "knowledge";
506
+ entrypoint: "entrypoint";
507
+ diagnostic: "diagnostic";
508
+ }>;
509
+ kind: z.ZodString;
510
+ label: z.ZodString;
511
+ path: z.ZodOptional<z.ZodString>;
512
+ locator: z.ZodOptional<z.ZodString>;
513
+ stage_id: z.ZodOptional<z.ZodString>;
514
+ source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
515
+ links: z.ZodDefault<z.ZodArray<z.ZodString>>;
516
+ required: z.ZodDefault<z.ZodBoolean>;
517
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
518
+ }, z.core.$strict>>>;
519
+ expected: z.ZodDefault<z.ZodArray<z.ZodObject<{
520
+ id: z.ZodString;
521
+ role: z.ZodEnum<{
522
+ source: "source";
523
+ summary: "summary";
524
+ other: "other";
525
+ knowledge: "knowledge";
526
+ entrypoint: "entrypoint";
527
+ diagnostic: "diagnostic";
528
+ }>;
529
+ kind: z.ZodString;
530
+ label: z.ZodString;
531
+ path: z.ZodOptional<z.ZodString>;
532
+ locator: z.ZodOptional<z.ZodString>;
533
+ stage_id: z.ZodOptional<z.ZodString>;
534
+ source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
535
+ links: z.ZodDefault<z.ZodArray<z.ZodString>>;
536
+ required: z.ZodDefault<z.ZodBoolean>;
537
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
538
+ }, z.core.$strict>>>;
539
+ reviewed: z.ZodDefault<z.ZodArray<z.ZodObject<{
540
+ resource_id: z.ZodString;
541
+ decision: z.ZodEnum<{
542
+ missing: "missing";
543
+ used: "used";
544
+ reviewed: "reviewed";
545
+ blocked: "blocked";
546
+ "not-relevant": "not-relevant";
547
+ }>;
548
+ reason: z.ZodOptional<z.ZodString>;
549
+ output_resource_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
550
+ source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
551
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
552
+ }, z.core.$strict>>>;
553
+ referenced: z.ZodDefault<z.ZodArray<z.ZodObject<{
554
+ id: z.ZodString;
555
+ role: z.ZodEnum<{
556
+ source: "source";
557
+ summary: "summary";
558
+ other: "other";
559
+ knowledge: "knowledge";
560
+ entrypoint: "entrypoint";
561
+ diagnostic: "diagnostic";
562
+ }>;
563
+ kind: z.ZodString;
564
+ label: z.ZodString;
565
+ path: z.ZodOptional<z.ZodString>;
566
+ locator: z.ZodOptional<z.ZodString>;
567
+ stage_id: z.ZodOptional<z.ZodString>;
568
+ source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
569
+ links: z.ZodDefault<z.ZodArray<z.ZodString>>;
570
+ required: z.ZodDefault<z.ZodBoolean>;
571
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
572
+ }, z.core.$strict>>>;
573
+ missing: z.ZodDefault<z.ZodArray<z.ZodObject<{
574
+ resource_id: z.ZodString;
575
+ status: z.ZodEnum<{
576
+ missing: "missing";
577
+ blocked: "blocked";
578
+ "not-relevant": "not-relevant";
579
+ }>;
580
+ reason: z.ZodString;
581
+ }, z.core.$strict>>>;
582
+ produced: z.ZodDefault<z.ZodArray<z.ZodObject<{
583
+ id: z.ZodString;
584
+ role: z.ZodEnum<{
585
+ source: "source";
586
+ summary: "summary";
587
+ other: "other";
588
+ knowledge: "knowledge";
589
+ entrypoint: "entrypoint";
590
+ diagnostic: "diagnostic";
591
+ }>;
592
+ kind: z.ZodString;
593
+ label: z.ZodString;
594
+ path: z.ZodOptional<z.ZodString>;
595
+ locator: z.ZodOptional<z.ZodString>;
596
+ stage_id: z.ZodOptional<z.ZodString>;
597
+ source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
598
+ links: z.ZodDefault<z.ZodArray<z.ZodString>>;
599
+ required: z.ZodDefault<z.ZodBoolean>;
600
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
601
+ }, z.core.$strict>>>;
602
+ metrics: z.ZodDefault<z.ZodArray<z.ZodObject<{
603
+ key: z.ZodString;
604
+ label: z.ZodString;
605
+ value: z.ZodNumber;
606
+ total: z.ZodOptional<z.ZodNumber>;
607
+ unit: z.ZodOptional<z.ZodString>;
608
+ primary: z.ZodDefault<z.ZodBoolean>;
609
+ issue_state: z.ZodOptional<z.ZodEnum<{
610
+ pass: "pass";
611
+ fail: "fail";
612
+ missing: "missing";
613
+ review: "review";
614
+ }>>;
615
+ detail: z.ZodOptional<z.ZodString>;
616
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
617
+ }, z.core.$strict>>>;
618
+ }, z.core.$strict>;
619
+ export declare const GraphManifestStageSummarySchema: z.ZodObject<{
620
+ stage_id: z.ZodString;
621
+ stage_label: z.ZodString;
622
+ role: z.ZodEnum<{
623
+ source: "source";
624
+ summary: "summary";
625
+ other: "other";
626
+ knowledge: "knowledge";
627
+ entrypoint: "entrypoint";
628
+ diagnostic: "diagnostic";
629
+ }>;
630
+ manifest_path: z.ZodString;
631
+ summary: z.ZodString;
632
+ produced_total: z.ZodNumber;
633
+ missing_required_total: z.ZodNumber;
634
+ metrics: z.ZodDefault<z.ZodArray<z.ZodObject<{
635
+ key: z.ZodString;
636
+ label: z.ZodString;
637
+ value: z.ZodNumber;
638
+ total: z.ZodOptional<z.ZodNumber>;
639
+ unit: z.ZodOptional<z.ZodString>;
640
+ primary: z.ZodDefault<z.ZodBoolean>;
641
+ issue_state: z.ZodOptional<z.ZodEnum<{
642
+ pass: "pass";
643
+ fail: "fail";
644
+ missing: "missing";
645
+ review: "review";
646
+ }>>;
647
+ detail: z.ZodOptional<z.ZodString>;
648
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
649
+ }, z.core.$strict>>>;
650
+ }, z.core.$strict>;
651
+ export declare const GraphReadinessRollupSchema: z.ZodObject<{
652
+ status: z.ZodEnum<{
653
+ ready: "ready";
654
+ "not-ready": "not-ready";
655
+ }>;
656
+ ready: z.ZodBoolean;
657
+ summary: z.ZodString;
658
+ context_graph_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
659
+ missing_required_total: z.ZodNumber;
660
+ missing: z.ZodDefault<z.ZodArray<z.ZodObject<{
661
+ resource_id: z.ZodString;
662
+ status: z.ZodEnum<{
663
+ missing: "missing";
664
+ blocked: "blocked";
665
+ "not-relevant": "not-relevant";
666
+ }>;
667
+ reason: z.ZodString;
668
+ }, z.core.$strict>>>;
669
+ }, z.core.$strict>;
670
+ export declare const GraphOutputCountsSchema: z.ZodObject<{
671
+ nodes: z.ZodNumber;
672
+ edges: z.ZodNumber;
673
+ notes: z.ZodNumber;
674
+ links: z.ZodNumber;
675
+ source_refs: z.ZodNumber;
676
+ claims: z.ZodOptional<z.ZodNumber>;
677
+ entities: z.ZodOptional<z.ZodNumber>;
678
+ }, z.core.$strict>;
679
+ export declare const GraphManifestSchema: z.ZodObject<{
680
+ kind: z.ZodLiteral<"interf-graph-manifest">;
681
+ version: z.ZodLiteral<1>;
682
+ generated_at: z.ZodString;
683
+ project: z.ZodString;
684
+ graph_id: z.ZodString;
685
+ run_id: z.ZodNullable<z.ZodString>;
686
+ build_plan: z.ZodString;
687
+ intent: z.ZodNullable<z.ZodString>;
688
+ graph_path: z.ZodString;
689
+ primary_metrics: z.ZodDefault<z.ZodArray<z.ZodObject<{
690
+ key: z.ZodString;
691
+ label: z.ZodString;
692
+ value: z.ZodNumber;
693
+ total: z.ZodOptional<z.ZodNumber>;
694
+ unit: z.ZodOptional<z.ZodString>;
695
+ primary: z.ZodDefault<z.ZodBoolean>;
696
+ issue_state: z.ZodOptional<z.ZodEnum<{
697
+ pass: "pass";
698
+ fail: "fail";
699
+ missing: "missing";
700
+ review: "review";
701
+ }>>;
702
+ detail: z.ZodOptional<z.ZodString>;
703
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
704
+ }, z.core.$strict>>>;
705
+ stages: z.ZodDefault<z.ZodArray<z.ZodObject<{
706
+ stage_id: z.ZodString;
707
+ stage_label: z.ZodString;
708
+ role: z.ZodEnum<{
709
+ source: "source";
710
+ summary: "summary";
711
+ other: "other";
712
+ knowledge: "knowledge";
713
+ entrypoint: "entrypoint";
714
+ diagnostic: "diagnostic";
715
+ }>;
716
+ manifest_path: z.ZodString;
717
+ summary: z.ZodString;
718
+ produced_total: z.ZodNumber;
719
+ missing_required_total: z.ZodNumber;
720
+ metrics: z.ZodDefault<z.ZodArray<z.ZodObject<{
721
+ key: z.ZodString;
722
+ label: z.ZodString;
723
+ value: z.ZodNumber;
724
+ total: z.ZodOptional<z.ZodNumber>;
725
+ unit: z.ZodOptional<z.ZodString>;
726
+ primary: z.ZodDefault<z.ZodBoolean>;
727
+ issue_state: z.ZodOptional<z.ZodEnum<{
728
+ pass: "pass";
729
+ fail: "fail";
730
+ missing: "missing";
731
+ review: "review";
732
+ }>>;
733
+ detail: z.ZodOptional<z.ZodString>;
734
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
735
+ }, z.core.$strict>>>;
736
+ }, z.core.$strict>>>;
737
+ entrypoints: z.ZodDefault<z.ZodArray<z.ZodObject<{
738
+ id: z.ZodString;
739
+ role: z.ZodEnum<{
740
+ source: "source";
741
+ summary: "summary";
742
+ other: "other";
743
+ knowledge: "knowledge";
744
+ entrypoint: "entrypoint";
745
+ diagnostic: "diagnostic";
746
+ }>;
747
+ kind: z.ZodString;
748
+ label: z.ZodString;
749
+ path: z.ZodOptional<z.ZodString>;
750
+ locator: z.ZodOptional<z.ZodString>;
751
+ stage_id: z.ZodOptional<z.ZodString>;
752
+ source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
753
+ links: z.ZodDefault<z.ZodArray<z.ZodString>>;
754
+ required: z.ZodDefault<z.ZodBoolean>;
755
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
756
+ }, z.core.$strict>>>;
757
+ resources: z.ZodDefault<z.ZodArray<z.ZodObject<{
758
+ id: z.ZodString;
759
+ role: z.ZodEnum<{
760
+ source: "source";
761
+ summary: "summary";
762
+ other: "other";
763
+ knowledge: "knowledge";
764
+ entrypoint: "entrypoint";
765
+ diagnostic: "diagnostic";
766
+ }>;
767
+ kind: z.ZodString;
768
+ label: z.ZodString;
769
+ path: z.ZodOptional<z.ZodString>;
770
+ locator: z.ZodOptional<z.ZodString>;
771
+ stage_id: z.ZodOptional<z.ZodString>;
772
+ source_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
773
+ links: z.ZodDefault<z.ZodArray<z.ZodString>>;
774
+ required: z.ZodDefault<z.ZodBoolean>;
775
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
776
+ }, z.core.$strict>>>;
777
+ graph_outputs: z.ZodObject<{
778
+ nodes: z.ZodNumber;
779
+ edges: z.ZodNumber;
780
+ notes: z.ZodNumber;
781
+ links: z.ZodNumber;
782
+ source_refs: z.ZodNumber;
783
+ claims: z.ZodOptional<z.ZodNumber>;
784
+ entities: z.ZodOptional<z.ZodNumber>;
785
+ }, z.core.$strict>;
786
+ readiness: z.ZodObject<{
787
+ status: z.ZodEnum<{
788
+ ready: "ready";
789
+ "not-ready": "not-ready";
790
+ }>;
791
+ ready: z.ZodBoolean;
792
+ summary: z.ZodString;
793
+ context_graph_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
794
+ missing_required_total: z.ZodNumber;
795
+ missing: z.ZodDefault<z.ZodArray<z.ZodObject<{
796
+ resource_id: z.ZodString;
797
+ status: z.ZodEnum<{
798
+ missing: "missing";
799
+ blocked: "blocked";
800
+ "not-relevant": "not-relevant";
801
+ }>;
802
+ reason: z.ZodString;
803
+ }, z.core.$strict>>>;
804
+ }, z.core.$strict>;
805
+ }, z.core.$strict>;
124
806
  /**
125
807
  * Canonical check kinds the engine knows how to evaluate.
126
808
  *
127
809
  * Adding a new kind requires an engine release (the evaluator must
128
- * implement it). Build Plans and user checks pick from this list; they
810
+ * implement it). Plans and user checks pick from this list; they
129
811
  * cannot invent custom kinds.
130
812
  *
131
813
  * file_exists — file is present and non-empty
814
+ * source_manifest_valid — source-manifest.json exists, parses, and has at least one file
132
815
  * min_file_count — directory has ≥ N files (params: { min: number })
133
816
  * min_file_count_matches_source — directory has ≥ source_total files (the "all files analyzed" check)
817
+ * source_summary_folders — summaries directory has ≥ source_total source folders, each with summary.md or manifest.md
818
+ * source_page_coverage — page summary outputs exist for every manifest page unit
134
819
  * frontmatter_valid — every markdown file has parseable YAML frontmatter
135
820
  * frontmatter_required_keys — every markdown file has these frontmatter keys (params: { keys: string[] })
821
+ * frontmatter_nonempty_keys — every markdown file has non-empty values for these frontmatter keys
822
+ * source_refs_required — every markdown file has non-empty source_refs/source_ref/source_path frontmatter
823
+ * summary_backlinks_present — every summary cited by a note's source_refs is also wikilinked from that layer (no orphaned summaries)
824
+ * knowledge_web_connectivity — every knowledge note links at least one OTHER knowledge note (no disconnected islands in the knowledge web)
825
+ * graph_notes_connected — every markdown note across the WHOLE Context Graph (summaries, knowledge, artifacts, home) is link-connected to at least one other note (no free-floating island anywhere, including uncited summaries)
136
826
  * wikilinks_valid — every wikilink resolves
137
- * must_not_contain — file/directory does not contain forbidden phrases (params: { phrases: string[] })
138
- * must_contain — file/directory contains required phrases (params: { phrases: string[] })
139
- * qa_match — user-defined Q/A: agent answer matches expected (params: { question, expected, strictness })
827
+ * must_not_contain — file/directory does not contain forbidden phrases (params: { phrases: string[] } or { text: string })
828
+ * must_contain — file/directory contains required phrases (params: { phrases: string[] } or { text: string })
829
+ * qa_match — user-defined Q/A: agent answer matches expected (params: { expected: string, strictness?: "loose" | "strict" })
140
830
  */
141
- export declare const CHECK_KINDS: readonly ["file_exists", "min_file_count", "min_file_count_matches_source", "frontmatter_valid", "frontmatter_required_keys", "wikilinks_valid", "must_not_contain", "must_contain", "qa_match"];
831
+ export declare const CHECK_KINDS: readonly ["file_exists", "source_manifest_valid", "min_file_count", "min_file_count_matches_source", "source_summary_folders", "source_page_coverage", "frontmatter_valid", "frontmatter_required_keys", "frontmatter_nonempty_keys", "source_refs_required", "summary_backlinks_present", "knowledge_web_connectivity", "graph_notes_connected", "wikilinks_valid", "must_not_contain", "must_contain", "qa_match"];
142
832
  export declare const CheckKindSchema: z.ZodEnum<{
143
833
  file_exists: "file_exists";
834
+ source_manifest_valid: "source_manifest_valid";
144
835
  min_file_count: "min_file_count";
145
836
  min_file_count_matches_source: "min_file_count_matches_source";
837
+ source_summary_folders: "source_summary_folders";
838
+ source_page_coverage: "source_page_coverage";
146
839
  frontmatter_valid: "frontmatter_valid";
147
840
  frontmatter_required_keys: "frontmatter_required_keys";
841
+ frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
842
+ source_refs_required: "source_refs_required";
843
+ summary_backlinks_present: "summary_backlinks_present";
844
+ knowledge_web_connectivity: "knowledge_web_connectivity";
845
+ graph_notes_connected: "graph_notes_connected";
148
846
  wikilinks_valid: "wikilinks_valid";
149
847
  must_not_contain: "must_not_contain";
150
848
  must_contain: "must_contain";
151
849
  qa_match: "qa_match";
152
850
  }>;
153
851
  export type CheckKind = z.infer<typeof CheckKindSchema>;
852
+ export declare const CHECK_PARAM_CONTRACTS: {
853
+ readonly file_exists: {
854
+ readonly params: {};
855
+ readonly examples: readonly [{}];
856
+ };
857
+ readonly source_manifest_valid: {
858
+ readonly params: {
859
+ readonly path: "optional manifest path; defaults to .interf/runtime/source-manifest.json";
860
+ };
861
+ readonly examples: readonly [{}];
862
+ };
863
+ readonly min_file_count: {
864
+ readonly params: {
865
+ readonly min: "optional number; defaults to 1";
866
+ };
867
+ readonly examples: readonly [{
868
+ readonly min: 26;
869
+ }];
870
+ };
871
+ readonly min_file_count_matches_source: {
872
+ readonly params: {
873
+ readonly match: "optional count key string; defaults to source_total";
874
+ };
875
+ readonly examples: readonly [{
876
+ readonly match: "source_total";
877
+ }];
878
+ };
879
+ readonly source_summary_folders: {
880
+ readonly params: {
881
+ readonly match: "optional count key string; defaults to source_total";
882
+ readonly summary_file: "optional filename string; defaults to summary.md";
883
+ readonly manifest_file: "optional filename string; defaults to manifest.md";
884
+ };
885
+ readonly examples: readonly [{
886
+ readonly match: "source_total";
887
+ }];
888
+ };
889
+ readonly source_page_coverage: {
890
+ readonly params: {
891
+ readonly pages_dir: "optional directory name inside each source summary folder; defaults to pages";
892
+ readonly summary_file: "optional filename string; defaults to summary.md";
893
+ };
894
+ readonly examples: readonly [{
895
+ readonly pages_dir: "pages";
896
+ }];
897
+ };
898
+ readonly frontmatter_valid: {
899
+ readonly params: {};
900
+ readonly examples: readonly [{}];
901
+ };
902
+ readonly frontmatter_required_keys: {
903
+ readonly params: {
904
+ readonly keys: "required string[]";
905
+ };
906
+ readonly examples: readonly [{
907
+ readonly keys: readonly ["page", "title", "summary"];
908
+ }];
909
+ };
910
+ readonly frontmatter_nonempty_keys: {
911
+ readonly params: {
912
+ readonly keys: "required string[]";
913
+ };
914
+ readonly examples: readonly [{
915
+ readonly keys: readonly ["source_refs", "verification_state"];
916
+ }];
917
+ };
918
+ readonly source_refs_required: {
919
+ readonly params: {
920
+ readonly keys: "optional string[]; defaults to source_refs, source_ref, source_path";
921
+ };
922
+ readonly examples: readonly [{
923
+ readonly keys: readonly ["source_refs"];
924
+ }];
925
+ };
926
+ readonly summary_backlinks_present: {
927
+ readonly params: {
928
+ readonly summaries_dir: "optional summaries directory name; defaults to summaries";
929
+ readonly summary_file: "optional summary filename; defaults to summary.md";
930
+ readonly manifest_file: "optional manifest filename; defaults to manifest.md";
931
+ };
932
+ readonly examples: readonly [{}, {
933
+ readonly summaries_dir: "summaries";
934
+ }];
935
+ };
936
+ readonly knowledge_web_connectivity: {
937
+ readonly params: {
938
+ readonly knowledge_dir: "optional knowledge directory; defaults to the artifact's own target path. May only narrow the scan to a path inside that target layer.";
939
+ };
940
+ readonly examples: readonly [{}, {
941
+ readonly knowledge_dir: "knowledge";
942
+ }];
943
+ };
944
+ readonly graph_notes_connected: {
945
+ readonly params: {
946
+ readonly graph_root: "optional graph-root-relative directory to scan; defaults to the Context Graph root (every note in every layer). Use to narrow the floor to one layer (e.g. summaries) when a Build Plan splits the connectivity floor across outputs.";
947
+ };
948
+ readonly examples: readonly [{}, {
949
+ readonly graph_root: "summaries";
950
+ }];
951
+ };
952
+ readonly wikilinks_valid: {
953
+ readonly params: {};
954
+ readonly examples: readonly [{}];
955
+ };
956
+ readonly must_not_contain: {
957
+ readonly params: {
958
+ readonly phrases: "preferred string[] of forbidden phrases";
959
+ readonly text: "optional string shorthand for one forbidden phrase";
960
+ };
961
+ readonly examples: readonly [{
962
+ readonly phrases: readonly ["TODO", "Not yet built."];
963
+ }, {
964
+ readonly text: "TODO";
965
+ }];
966
+ };
967
+ readonly must_contain: {
968
+ readonly params: {
969
+ readonly phrases: "preferred string[] of required phrases";
970
+ readonly text: "optional string shorthand for one required phrase";
971
+ };
972
+ readonly examples: readonly [{
973
+ readonly phrases: readonly ["Bristol", "Central London"];
974
+ }, {
975
+ readonly text: "Bristol";
976
+ }];
977
+ };
978
+ readonly qa_match: {
979
+ readonly params: {
980
+ readonly expected: "required expected answer string";
981
+ readonly strictness: "optional string; loose or strict; defaults to loose";
982
+ };
983
+ readonly examples: readonly [{
984
+ readonly expected: "Acme Corp";
985
+ readonly strictness: "loose";
986
+ }];
987
+ };
988
+ };
154
989
  /**
155
990
  * One check declaration. Reusable across stage/artifact/user scopes.
156
991
  *
@@ -160,17 +995,25 @@ export type CheckKind = z.infer<typeof CheckKindSchema>;
160
995
  * rule-specific config (typed at the engine evaluator).
161
996
  *
162
997
  * `required: true` (default) → a failed check fails the parent
163
- * (stage/artifact/preparation). `required: false` → soft check, fails
998
+ * (stage/artifact/Project). `required: false` → soft check, fails
164
999
  * warn but don't block the `ready` verdict.
165
1000
  */
166
1001
  export declare const CheckSchema: z.ZodObject<{
167
1002
  id: z.ZodString;
168
1003
  kind: z.ZodEnum<{
169
1004
  file_exists: "file_exists";
1005
+ source_manifest_valid: "source_manifest_valid";
170
1006
  min_file_count: "min_file_count";
171
1007
  min_file_count_matches_source: "min_file_count_matches_source";
1008
+ source_summary_folders: "source_summary_folders";
1009
+ source_page_coverage: "source_page_coverage";
172
1010
  frontmatter_valid: "frontmatter_valid";
173
1011
  frontmatter_required_keys: "frontmatter_required_keys";
1012
+ frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
1013
+ source_refs_required: "source_refs_required";
1014
+ summary_backlinks_present: "summary_backlinks_present";
1015
+ knowledge_web_connectivity: "knowledge_web_connectivity";
1016
+ graph_notes_connected: "graph_notes_connected";
174
1017
  wikilinks_valid: "wikilinks_valid";
175
1018
  must_not_contain: "must_not_contain";
176
1019
  must_contain: "must_contain";
@@ -186,14 +1029,22 @@ export type Check = z.infer<typeof CheckSchema>;
186
1029
  * short one-line label for the UI; `details` carries rule-specific
187
1030
  * structured data (e.g., file count, missing keys, broken link list).
188
1031
  */
189
- export declare const ProofSchema: z.ZodObject<{
1032
+ export declare const CheckResultSchema: z.ZodObject<{
190
1033
  check_id: z.ZodString;
191
1034
  kind: z.ZodEnum<{
192
1035
  file_exists: "file_exists";
1036
+ source_manifest_valid: "source_manifest_valid";
193
1037
  min_file_count: "min_file_count";
194
1038
  min_file_count_matches_source: "min_file_count_matches_source";
1039
+ source_summary_folders: "source_summary_folders";
1040
+ source_page_coverage: "source_page_coverage";
195
1041
  frontmatter_valid: "frontmatter_valid";
196
1042
  frontmatter_required_keys: "frontmatter_required_keys";
1043
+ frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
1044
+ source_refs_required: "source_refs_required";
1045
+ summary_backlinks_present: "summary_backlinks_present";
1046
+ knowledge_web_connectivity: "knowledge_web_connectivity";
1047
+ graph_notes_connected: "graph_notes_connected";
197
1048
  wikilinks_valid: "wikilinks_valid";
198
1049
  must_not_contain: "must_not_contain";
199
1050
  must_contain: "must_contain";
@@ -205,16 +1056,75 @@ export declare const ProofSchema: z.ZodObject<{
205
1056
  details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
206
1057
  evaluated_at: z.ZodString;
207
1058
  }, z.core.$strict>;
208
- export type Proof = z.infer<typeof ProofSchema>;
1059
+ export type CheckResult = z.infer<typeof CheckResultSchema>;
1060
+ export declare const ContextCheckStatusSchema: z.ZodEnum<{
1061
+ passed: "passed";
1062
+ pending: "pending";
1063
+ running: "running";
1064
+ failed: "failed";
1065
+ skipped: "skipped";
1066
+ }>;
1067
+ export type ContextCheckStatus = z.infer<typeof ContextCheckStatusSchema>;
1068
+ /**
1069
+ * Legacy Build Plan check declaration. Current product surfaces should prefer
1070
+ * concrete coverage metrics, Stage Manifests, and Graph Manifest readiness.
1071
+ * Deterministic output diagnostics remain nested under requested outputs and
1072
+ * use `CheckSchema`.
1073
+ */
1074
+ export declare const ContextCheckDeclarationSchema: z.ZodObject<{
1075
+ id: z.ZodString;
1076
+ label: z.ZodString;
1077
+ description: z.ZodOptional<z.ZodString>;
1078
+ backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
1079
+ required: z.ZodDefault<z.ZodBoolean>;
1080
+ evidence_expectation: z.ZodOptional<z.ZodString>;
1081
+ }, z.core.$strict>;
1082
+ export declare const ContextCheckProjectionSchema: z.ZodObject<{
1083
+ id: z.ZodString;
1084
+ label: z.ZodString;
1085
+ description: z.ZodOptional<z.ZodString>;
1086
+ backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
1087
+ required: z.ZodDefault<z.ZodBoolean>;
1088
+ evidence_expectation: z.ZodOptional<z.ZodString>;
1089
+ status: z.ZodOptional<z.ZodEnum<{
1090
+ passed: "passed";
1091
+ pending: "pending";
1092
+ running: "running";
1093
+ failed: "failed";
1094
+ skipped: "skipped";
1095
+ }>>;
1096
+ evidence: z.ZodOptional<z.ZodString>;
1097
+ issue: z.ZodOptional<z.ZodString>;
1098
+ }, z.core.$strict>;
1099
+ export declare const ContextCheckSchema: z.ZodObject<{
1100
+ id: z.ZodString;
1101
+ label: z.ZodString;
1102
+ description: z.ZodOptional<z.ZodString>;
1103
+ backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
1104
+ required: z.ZodDefault<z.ZodBoolean>;
1105
+ evidence_expectation: z.ZodOptional<z.ZodString>;
1106
+ status: z.ZodOptional<z.ZodEnum<{
1107
+ passed: "passed";
1108
+ pending: "pending";
1109
+ running: "running";
1110
+ failed: "failed";
1111
+ skipped: "skipped";
1112
+ }>>;
1113
+ evidence: z.ZodOptional<z.ZodString>;
1114
+ issue: z.ZodOptional<z.ZodString>;
1115
+ }, z.core.$strict>;
1116
+ export type ContextCheckDeclaration = z.infer<typeof ContextCheckDeclarationSchema>;
1117
+ export type ContextCheckProjection = z.infer<typeof ContextCheckProjectionSchema>;
1118
+ export type ContextCheck = z.infer<typeof ContextCheckSchema>;
209
1119
  /**
210
1120
  * Per-thing readiness verdict. Used for an artifact, a stage, or a
211
- * preparation. Aggregate verdict over its required checks.
1121
+ * Project. Aggregate verdict over its required checks.
212
1122
  */
213
1123
  export declare const ReadyVerdictSchema: z.ZodEnum<{
214
1124
  ready: "ready";
215
- not_ready: "not_ready";
216
1125
  failed: "failed";
217
1126
  skipped: "skipped";
1127
+ not_ready: "not_ready";
218
1128
  }>;
219
1129
  export type ReadyVerdict = z.infer<typeof ReadyVerdictSchema>;
220
1130
  /**
@@ -223,14 +1133,14 @@ export type ReadyVerdict = z.infer<typeof ReadyVerdictSchema>;
223
1133
  * convention reference this constant in `frontmatter_required_keys`
224
1134
  * check params rather than re-typing the list.
225
1135
  */
226
- export declare const STANDARD_EVIDENCE_FRONTMATTER_KEYS: readonly ["source", "source_kind", "evidence_tier", "truth_mode", "state"];
1136
+ export declare const STANDARD_EVIDENCE_FRONTMATTER_KEYS: readonly ["source", "source_file_id", "source_path", "source_locator", "source_kind", "evidence_tier", "truth_mode", "state"];
227
1137
  export type StandardEvidenceFrontmatterKey = typeof STANDARD_EVIDENCE_FRONTMATTER_KEYS[number];
228
1138
  /**
229
- * Where an Artifact materializes. Discriminated union so future kinds
230
- * (literal value, remote handle, confirmation-only) slot in without a
231
- * schema break. `path` is always relative to the verifiable-context root,
232
- * and `artifact_kind` tells consumers whether the target materializes
233
- * as a file or directory.
1139
+ * Where an Artifact materializes. `path` is always relative to the
1140
+ * Context Graph root, and `artifact_kind` tells consumers whether the
1141
+ * target materializes as a file or directory. The `kind: "path"`
1142
+ * discriminator is retained on the wire so a future shape variant can be
1143
+ * added as a discriminated union without renaming existing data.
234
1144
  */
235
1145
  export declare const ArtifactPathShapeSchema: z.ZodObject<{
236
1146
  kind: z.ZodLiteral<"path">;
@@ -240,42 +1150,50 @@ export declare const ArtifactPathShapeSchema: z.ZodObject<{
240
1150
  directory: "directory";
241
1151
  }>;
242
1152
  }, z.core.$strict>;
243
- export declare const ArtifactShapeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
1153
+ export declare const ArtifactShapeSchema: z.ZodObject<{
244
1154
  kind: z.ZodLiteral<"path">;
245
1155
  path: z.ZodString;
246
1156
  artifact_kind: z.ZodEnum<{
247
1157
  file: "file";
248
1158
  directory: "directory";
249
1159
  }>;
250
- }, z.core.$strict>], "kind">;
1160
+ }, z.core.$strict>;
251
1161
  export type ArtifactPathShape = z.infer<typeof ArtifactPathShapeSchema>;
252
- export type ArtifactShape = z.infer<typeof ArtifactShapeSchema>;
1162
+ export type ArtifactShape = ArtifactPathShape;
253
1163
  /**
254
- * Build Plan-declared Artifact — a produced thing.
1164
+ * Legacy internal requested-output schema.
255
1165
  *
256
1166
  * `checks[]` is the locked vocabulary: an array of `Check` (with
257
1167
  * `kind` from `CHECK_KINDS`). The runtime evaluates them via the
258
- * shared check evaluator and produces `Proof[]` on each Build run.
1168
+ * shared check evaluator and produces `CheckResult[]` on each Build.
259
1169
  */
260
1170
  export declare const ArtifactSchema: z.ZodObject<{
261
1171
  id: z.ZodString;
262
1172
  description: z.ZodString;
263
- shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
1173
+ shape: z.ZodObject<{
264
1174
  kind: z.ZodLiteral<"path">;
265
1175
  path: z.ZodString;
266
1176
  artifact_kind: z.ZodEnum<{
267
1177
  file: "file";
268
1178
  directory: "directory";
269
1179
  }>;
270
- }, z.core.$strict>], "kind">;
1180
+ }, z.core.$strict>;
271
1181
  checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
272
1182
  id: z.ZodString;
273
1183
  kind: z.ZodEnum<{
274
1184
  file_exists: "file_exists";
1185
+ source_manifest_valid: "source_manifest_valid";
275
1186
  min_file_count: "min_file_count";
276
1187
  min_file_count_matches_source: "min_file_count_matches_source";
1188
+ source_summary_folders: "source_summary_folders";
1189
+ source_page_coverage: "source_page_coverage";
277
1190
  frontmatter_valid: "frontmatter_valid";
278
1191
  frontmatter_required_keys: "frontmatter_required_keys";
1192
+ frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
1193
+ source_refs_required: "source_refs_required";
1194
+ summary_backlinks_present: "summary_backlinks_present";
1195
+ knowledge_web_connectivity: "knowledge_web_connectivity";
1196
+ graph_notes_connected: "graph_notes_connected";
279
1197
  wikilinks_valid: "wikilinks_valid";
280
1198
  must_not_contain: "must_not_contain";
281
1199
  must_contain: "must_contain";
@@ -289,34 +1207,42 @@ export declare const ArtifactSchema: z.ZodObject<{
289
1207
  }, z.core.$strict>;
290
1208
  export type Artifact = z.infer<typeof ArtifactSchema>;
291
1209
  /**
292
- * Per-Artifact runtime status. Lives on Build run resources and on
293
- * preparation resources. `proofs[]` carries the structured evidence
1210
+ * Per-Artifact runtime status. Lives on Build resources and on
1211
+ * Project resources. `check_results[]` carries the structured evidence
294
1212
  * emitted by the shared check evaluator.
295
1213
  */
296
1214
  export declare const ArtifactStatusValueSchema: z.ZodEnum<{
297
1215
  ready: "ready";
298
- not_ready: "not_ready";
299
1216
  failed: "failed";
300
1217
  skipped: "skipped";
1218
+ not_ready: "not_ready";
301
1219
  }>;
302
1220
  export type ArtifactStatusValue = ReadyVerdict;
303
1221
  export declare const ArtifactStatusSchema: z.ZodObject<{
304
1222
  artifact_id: z.ZodString;
305
1223
  status: z.ZodEnum<{
306
1224
  ready: "ready";
307
- not_ready: "not_ready";
308
1225
  failed: "failed";
309
1226
  skipped: "skipped";
1227
+ not_ready: "not_ready";
310
1228
  }>;
311
1229
  built_by_stages: z.ZodDefault<z.ZodArray<z.ZodString>>;
312
- proofs: z.ZodDefault<z.ZodArray<z.ZodObject<{
1230
+ check_results: z.ZodDefault<z.ZodArray<z.ZodObject<{
313
1231
  check_id: z.ZodString;
314
1232
  kind: z.ZodEnum<{
315
1233
  file_exists: "file_exists";
1234
+ source_manifest_valid: "source_manifest_valid";
316
1235
  min_file_count: "min_file_count";
317
1236
  min_file_count_matches_source: "min_file_count_matches_source";
1237
+ source_summary_folders: "source_summary_folders";
1238
+ source_page_coverage: "source_page_coverage";
318
1239
  frontmatter_valid: "frontmatter_valid";
319
1240
  frontmatter_required_keys: "frontmatter_required_keys";
1241
+ frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
1242
+ source_refs_required: "source_refs_required";
1243
+ summary_backlinks_present: "summary_backlinks_present";
1244
+ knowledge_web_connectivity: "knowledge_web_connectivity";
1245
+ graph_notes_connected: "graph_notes_connected";
320
1246
  wikilinks_valid: "wikilinks_valid";
321
1247
  must_not_contain: "must_not_contain";
322
1248
  must_contain: "must_contain";
@@ -331,50 +1257,258 @@ export declare const ArtifactStatusSchema: z.ZodObject<{
331
1257
  summary: z.ZodOptional<z.ZodString>;
332
1258
  }, z.core.$strict>;
333
1259
  export type ArtifactStatus = z.infer<typeof ArtifactStatusSchema>;
1260
+ export declare const BuildEvidenceIssueStateSchema: z.ZodEnum<{
1261
+ pass: "pass";
1262
+ fail: "fail";
1263
+ missing: "missing";
1264
+ review: "review";
1265
+ }>;
1266
+ export type BuildEvidenceIssueState = z.infer<typeof BuildEvidenceIssueStateSchema>;
1267
+ export declare const BuildEvidenceMetricSchema: z.ZodObject<{
1268
+ observed: z.ZodNumber;
1269
+ total: z.ZodOptional<z.ZodNumber>;
1270
+ unit: z.ZodOptional<z.ZodString>;
1271
+ }, z.core.$strict>;
1272
+ export type BuildEvidenceMetric = z.infer<typeof BuildEvidenceMetricSchema>;
1273
+ export declare const BuildEvidenceRefSchema: z.ZodObject<{
1274
+ kind: z.ZodEnum<{
1275
+ output: "output";
1276
+ "source-inventory": "source-inventory";
1277
+ "stage-record": "stage-record";
1278
+ validator: "validator";
1279
+ trace: "trace";
1280
+ "stage-evidence": "stage-evidence";
1281
+ }>;
1282
+ label: z.ZodString;
1283
+ ref: z.ZodOptional<z.ZodString>;
1284
+ path: z.ZodOptional<z.ZodString>;
1285
+ run_id: z.ZodOptional<z.ZodString>;
1286
+ stage_id: z.ZodOptional<z.ZodString>;
1287
+ artifact_id: z.ZodOptional<z.ZodString>;
1288
+ }, z.core.$strict>;
1289
+ export type BuildEvidenceRef = z.infer<typeof BuildEvidenceRefSchema>;
1290
+ export declare const BuildCheckRowSchema: z.ZodObject<{
1291
+ id: z.ZodString;
1292
+ assertion: z.ZodString;
1293
+ metric: z.ZodObject<{
1294
+ observed: z.ZodNumber;
1295
+ total: z.ZodOptional<z.ZodNumber>;
1296
+ unit: z.ZodOptional<z.ZodString>;
1297
+ }, z.core.$strict>;
1298
+ evidence: z.ZodObject<{
1299
+ kind: z.ZodEnum<{
1300
+ output: "output";
1301
+ "source-inventory": "source-inventory";
1302
+ "stage-record": "stage-record";
1303
+ validator: "validator";
1304
+ trace: "trace";
1305
+ "stage-evidence": "stage-evidence";
1306
+ }>;
1307
+ label: z.ZodString;
1308
+ ref: z.ZodOptional<z.ZodString>;
1309
+ path: z.ZodOptional<z.ZodString>;
1310
+ run_id: z.ZodOptional<z.ZodString>;
1311
+ stage_id: z.ZodOptional<z.ZodString>;
1312
+ artifact_id: z.ZodOptional<z.ZodString>;
1313
+ }, z.core.$strict>;
1314
+ issue_state: z.ZodOptional<z.ZodEnum<{
1315
+ pass: "pass";
1316
+ fail: "fail";
1317
+ missing: "missing";
1318
+ review: "review";
1319
+ }>>;
1320
+ issue: z.ZodOptional<z.ZodString>;
1321
+ }, z.core.$strict>;
1322
+ export type BuildCheckRow = z.infer<typeof BuildCheckRowSchema>;
1323
+ export declare const BuildEvidenceResourceSchema: z.ZodObject<{
1324
+ kind: z.ZodLiteral<"interf-build-evidence">;
1325
+ version: z.ZodLiteral<1>;
1326
+ generated_at: z.ZodString;
1327
+ project_id: z.ZodString;
1328
+ build_run_id: z.ZodNullable<z.ZodString>;
1329
+ ready: z.ZodBoolean;
1330
+ summary: z.ZodString;
1331
+ rows: z.ZodDefault<z.ZodArray<z.ZodObject<{
1332
+ id: z.ZodString;
1333
+ assertion: z.ZodString;
1334
+ metric: z.ZodObject<{
1335
+ observed: z.ZodNumber;
1336
+ total: z.ZodOptional<z.ZodNumber>;
1337
+ unit: z.ZodOptional<z.ZodString>;
1338
+ }, z.core.$strict>;
1339
+ evidence: z.ZodObject<{
1340
+ kind: z.ZodEnum<{
1341
+ output: "output";
1342
+ "source-inventory": "source-inventory";
1343
+ "stage-record": "stage-record";
1344
+ validator: "validator";
1345
+ trace: "trace";
1346
+ "stage-evidence": "stage-evidence";
1347
+ }>;
1348
+ label: z.ZodString;
1349
+ ref: z.ZodOptional<z.ZodString>;
1350
+ path: z.ZodOptional<z.ZodString>;
1351
+ run_id: z.ZodOptional<z.ZodString>;
1352
+ stage_id: z.ZodOptional<z.ZodString>;
1353
+ artifact_id: z.ZodOptional<z.ZodString>;
1354
+ }, z.core.$strict>;
1355
+ issue_state: z.ZodOptional<z.ZodEnum<{
1356
+ pass: "pass";
1357
+ fail: "fail";
1358
+ missing: "missing";
1359
+ review: "review";
1360
+ }>>;
1361
+ issue: z.ZodOptional<z.ZodString>;
1362
+ }, z.core.$strict>>>;
1363
+ }, z.core.$strict>;
1364
+ export type BuildEvidenceResource = z.infer<typeof BuildEvidenceResourceSchema>;
1365
+ export declare const EvidenceCountKeySchema: z.ZodString;
1366
+ export declare const StageEvidenceSourceRefSchema: z.ZodObject<{
1367
+ path: z.ZodString;
1368
+ source_file_id: z.ZodOptional<z.ZodString>;
1369
+ locator: z.ZodOptional<z.ZodString>;
1370
+ }, z.core.$strict>;
1371
+ export type StageEvidenceSourceRef = z.infer<typeof StageEvidenceSourceRefSchema>;
1372
+ export declare const StageEvidenceOutputRefSchema: z.ZodObject<{
1373
+ artifact_id: z.ZodString;
1374
+ path: z.ZodString;
1375
+ }, z.core.$strict>;
1376
+ export type StageEvidenceOutputRef = z.infer<typeof StageEvidenceOutputRefSchema>;
1377
+ export declare const StageEvidenceCountSchema: z.ZodObject<{
1378
+ key: z.ZodString;
1379
+ label: z.ZodString;
1380
+ value: z.ZodNumber;
1381
+ total: z.ZodOptional<z.ZodNumber>;
1382
+ unit: z.ZodOptional<z.ZodString>;
1383
+ source: z.ZodEnum<{
1384
+ stage: "stage";
1385
+ engine: "engine";
1386
+ }>;
1387
+ stage_id: z.ZodOptional<z.ZodString>;
1388
+ artifact_id: z.ZodOptional<z.ZodString>;
1389
+ primary: z.ZodOptional<z.ZodBoolean>;
1390
+ expected: z.ZodOptional<z.ZodBoolean>;
1391
+ }, z.core.$strict>;
1392
+ export type StageEvidenceCount = z.infer<typeof StageEvidenceCountSchema>;
1393
+ export declare const StageEvidenceItemSchema: z.ZodObject<{
1394
+ id: z.ZodString;
1395
+ kind: z.ZodString;
1396
+ label: z.ZodString;
1397
+ summary: z.ZodOptional<z.ZodString>;
1398
+ source_refs: z.ZodDefault<z.ZodArray<z.ZodObject<{
1399
+ path: z.ZodString;
1400
+ source_file_id: z.ZodOptional<z.ZodString>;
1401
+ locator: z.ZodOptional<z.ZodString>;
1402
+ }, z.core.$strict>>>;
1403
+ output_refs: z.ZodDefault<z.ZodArray<z.ZodObject<{
1404
+ artifact_id: z.ZodString;
1405
+ path: z.ZodString;
1406
+ }, z.core.$strict>>>;
1407
+ stage_id: z.ZodString;
1408
+ artifact_id: z.ZodOptional<z.ZodString>;
1409
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1410
+ }, z.core.$strict>;
1411
+ export type StageEvidenceItem = z.infer<typeof StageEvidenceItemSchema>;
1412
+ export declare const StageEvidenceEdgeSchema: z.ZodObject<{
1413
+ from: z.ZodString;
1414
+ to: z.ZodString;
1415
+ relation: z.ZodString;
1416
+ stage_id: z.ZodString;
1417
+ }, z.core.$strict>;
1418
+ export type StageEvidenceEdge = z.infer<typeof StageEvidenceEdgeSchema>;
1419
+ export declare const StageEvidenceSchema: z.ZodObject<{
1420
+ kind: z.ZodLiteral<"interf-stage-evidence">;
1421
+ version: z.ZodLiteral<1>;
1422
+ run_id: z.ZodString;
1423
+ stage: z.ZodString;
1424
+ counts: z.ZodDefault<z.ZodArray<z.ZodObject<{
1425
+ key: z.ZodString;
1426
+ label: z.ZodString;
1427
+ value: z.ZodNumber;
1428
+ total: z.ZodOptional<z.ZodNumber>;
1429
+ unit: z.ZodOptional<z.ZodString>;
1430
+ source: z.ZodEnum<{
1431
+ stage: "stage";
1432
+ engine: "engine";
1433
+ }>;
1434
+ stage_id: z.ZodOptional<z.ZodString>;
1435
+ artifact_id: z.ZodOptional<z.ZodString>;
1436
+ primary: z.ZodOptional<z.ZodBoolean>;
1437
+ expected: z.ZodOptional<z.ZodBoolean>;
1438
+ }, z.core.$strict>>>;
1439
+ items: z.ZodDefault<z.ZodArray<z.ZodObject<{
1440
+ id: z.ZodString;
1441
+ kind: z.ZodString;
1442
+ label: z.ZodString;
1443
+ summary: z.ZodOptional<z.ZodString>;
1444
+ source_refs: z.ZodDefault<z.ZodArray<z.ZodObject<{
1445
+ path: z.ZodString;
1446
+ source_file_id: z.ZodOptional<z.ZodString>;
1447
+ locator: z.ZodOptional<z.ZodString>;
1448
+ }, z.core.$strict>>>;
1449
+ output_refs: z.ZodDefault<z.ZodArray<z.ZodObject<{
1450
+ artifact_id: z.ZodString;
1451
+ path: z.ZodString;
1452
+ }, z.core.$strict>>>;
1453
+ stage_id: z.ZodString;
1454
+ artifact_id: z.ZodOptional<z.ZodString>;
1455
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1456
+ }, z.core.$strict>>>;
1457
+ edges: z.ZodDefault<z.ZodArray<z.ZodObject<{
1458
+ from: z.ZodString;
1459
+ to: z.ZodString;
1460
+ relation: z.ZodString;
1461
+ stage_id: z.ZodString;
1462
+ }, z.core.$strict>>>;
1463
+ warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
1464
+ }, z.core.$strict>;
1465
+ export type StageEvidence = z.infer<typeof StageEvidenceSchema>;
334
1466
  export declare const ReadinessStatusSchema: z.ZodEnum<{
335
1467
  ready: "ready";
1468
+ "not-ready": "not-ready";
336
1469
  failed: "failed";
337
1470
  "not-configured": "not-configured";
338
1471
  "not-built": "not-built";
339
1472
  building: "building";
340
1473
  built: "built";
341
1474
  checking: "checking";
342
- "not-ready": "not-ready";
343
1475
  stale: "stale";
344
1476
  }>;
345
1477
  export declare const ReadinessGateSchema: z.ZodEnum<{
346
- "verifiable-context": "verifiable-context";
347
- "preparation-config": "preparation-config";
1478
+ "context-graph": "context-graph";
1479
+ "project-config": "project-config";
348
1480
  "build-run": "build-run";
349
- "artifact-checks": "artifact-checks";
350
- "readiness-checks": "readiness-checks";
351
- "checks-current": "checks-current";
1481
+ "artifact-diagnostics": "artifact-diagnostics";
1482
+ "context-checks": "context-checks";
1483
+ benchmarks: "benchmarks";
1484
+ "benchmarks-current": "benchmarks-current";
352
1485
  }>;
353
1486
  /**
354
1487
  * Per-gate status — one row in the readiness summary. A gate is a
355
- * high-level layer (is config valid? is verifiable context built? did
356
- * latest Build run succeed?). Gate failures are aggregated alongside
357
- * artifact-check failures into the overall `Readiness` verdict.
1488
+ * high-level layer (is config valid? is the Context Graph built? did
1489
+ * the latest Build succeed?). Gate failures are aggregated alongside
1490
+ * output diagnostic failures into the overall `Readiness` verdict.
358
1491
  */
359
1492
  export declare const GateStatusSchema: z.ZodObject<{
360
1493
  gate: z.ZodEnum<{
361
- "verifiable-context": "verifiable-context";
362
- "preparation-config": "preparation-config";
1494
+ "context-graph": "context-graph";
1495
+ "project-config": "project-config";
363
1496
  "build-run": "build-run";
364
- "artifact-checks": "artifact-checks";
365
- "readiness-checks": "readiness-checks";
366
- "checks-current": "checks-current";
1497
+ "artifact-diagnostics": "artifact-diagnostics";
1498
+ "context-checks": "context-checks";
1499
+ benchmarks: "benchmarks";
1500
+ "benchmarks-current": "benchmarks-current";
367
1501
  }>;
368
1502
  ok: z.ZodBoolean;
369
1503
  status: z.ZodOptional<z.ZodEnum<{
370
1504
  ready: "ready";
1505
+ "not-ready": "not-ready";
371
1506
  failed: "failed";
372
1507
  "not-configured": "not-configured";
373
1508
  "not-built": "not-built";
374
1509
  building: "building";
375
1510
  built: "built";
376
1511
  checking: "checking";
377
- "not-ready": "not-ready";
378
1512
  stale: "stale";
379
1513
  }>>;
380
1514
  summary: z.ZodString;
@@ -391,46 +1525,50 @@ export declare const VerifyTargetResultSchema: z.ZodObject<{
391
1525
  run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
392
1526
  run_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
393
1527
  }, z.core.$strict>;
394
- export declare const ReadinessSchema: z.ZodPreprocess<z.ZodObject<{
1528
+ /**
1529
+ * Project-level readiness verdict.
1530
+ */
1531
+ export declare const ReadinessSchema: z.ZodObject<{
395
1532
  kind: z.ZodLiteral<"interf-readiness-state">;
396
1533
  version: z.ZodLiteral<1>;
397
1534
  generated_at: z.ZodString;
398
- preparation: z.ZodString;
1535
+ project: z.ZodString;
399
1536
  status: z.ZodEnum<{
400
1537
  ready: "ready";
1538
+ "not-ready": "not-ready";
401
1539
  failed: "failed";
402
1540
  "not-configured": "not-configured";
403
1541
  "not-built": "not-built";
404
1542
  building: "building";
405
1543
  built: "built";
406
1544
  checking: "checking";
407
- "not-ready": "not-ready";
408
1545
  stale: "stale";
409
1546
  }>;
410
1547
  ready: z.ZodBoolean;
411
1548
  summary: z.ZodString;
412
- verifiable_context_path: z.ZodNullable<z.ZodString>;
1549
+ context_graph_path: z.ZodNullable<z.ZodString>;
413
1550
  latest_build_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
414
- latest_test_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1551
+ latest_benchmark_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
415
1552
  build: z.ZodNullable<z.ZodObject<{
416
1553
  gate: z.ZodEnum<{
417
- "verifiable-context": "verifiable-context";
418
- "preparation-config": "preparation-config";
1554
+ "context-graph": "context-graph";
1555
+ "project-config": "project-config";
419
1556
  "build-run": "build-run";
420
- "artifact-checks": "artifact-checks";
421
- "readiness-checks": "readiness-checks";
422
- "checks-current": "checks-current";
1557
+ "artifact-diagnostics": "artifact-diagnostics";
1558
+ "context-checks": "context-checks";
1559
+ benchmarks: "benchmarks";
1560
+ "benchmarks-current": "benchmarks-current";
423
1561
  }>;
424
1562
  ok: z.ZodBoolean;
425
1563
  status: z.ZodOptional<z.ZodEnum<{
426
1564
  ready: "ready";
1565
+ "not-ready": "not-ready";
427
1566
  failed: "failed";
428
1567
  "not-configured": "not-configured";
429
1568
  "not-built": "not-built";
430
1569
  building: "building";
431
1570
  built: "built";
432
1571
  checking: "checking";
433
- "not-ready": "not-ready";
434
1572
  stale: "stale";
435
1573
  }>>;
436
1574
  summary: z.ZodString;
@@ -450,7 +1588,7 @@ export declare const ReadinessSchema: z.ZodPreprocess<z.ZodObject<{
450
1588
  run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
451
1589
  run_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
452
1590
  }, z.core.$strict>>;
453
- verifiable_context: z.ZodNullable<z.ZodObject<{
1591
+ context_graph: z.ZodNullable<z.ZodObject<{
454
1592
  passed: z.ZodNumber;
455
1593
  total: z.ZodNumber;
456
1594
  pass_rate: z.ZodNullable<z.ZodNumber>;
@@ -462,23 +1600,24 @@ export declare const ReadinessSchema: z.ZodPreprocess<z.ZodObject<{
462
1600
  }, z.core.$strict>;
463
1601
  checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
464
1602
  gate: z.ZodEnum<{
465
- "verifiable-context": "verifiable-context";
466
- "preparation-config": "preparation-config";
1603
+ "context-graph": "context-graph";
1604
+ "project-config": "project-config";
467
1605
  "build-run": "build-run";
468
- "artifact-checks": "artifact-checks";
469
- "readiness-checks": "readiness-checks";
470
- "checks-current": "checks-current";
1606
+ "artifact-diagnostics": "artifact-diagnostics";
1607
+ "context-checks": "context-checks";
1608
+ benchmarks: "benchmarks";
1609
+ "benchmarks-current": "benchmarks-current";
471
1610
  }>;
472
1611
  ok: z.ZodBoolean;
473
1612
  status: z.ZodOptional<z.ZodEnum<{
474
1613
  ready: "ready";
1614
+ "not-ready": "not-ready";
475
1615
  failed: "failed";
476
1616
  "not-configured": "not-configured";
477
1617
  "not-built": "not-built";
478
1618
  building: "building";
479
1619
  built: "built";
480
1620
  checking: "checking";
481
- "not-ready": "not-ready";
482
1621
  stale: "stale";
483
1622
  }>>;
484
1623
  summary: z.ZodString;
@@ -486,7 +1625,7 @@ export declare const ReadinessSchema: z.ZodPreprocess<z.ZodObject<{
486
1625
  run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
487
1626
  artifact_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
488
1627
  }, z.core.$strict>>>;
489
- }, z.core.$strict>>;
1628
+ }, z.core.$strict>;
490
1629
  export declare const TestCaseExpectSchema: z.ZodObject<{
491
1630
  must_include: z.ZodOptional<z.ZodArray<z.ZodString>>;
492
1631
  must_include_one_of: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodString>>>;
@@ -515,7 +1654,7 @@ export declare const RuntimeExecutorInfoSchema: z.ZodObject<{
515
1654
  export declare const CANONICAL_ROLES: readonly ["extractor", "summarizer", "structurer", "verifier", "general"];
516
1655
  export type CanonicalRole = typeof CANONICAL_ROLES[number];
517
1656
  /**
518
- * Open-ended role identifier. Build Plans invent role names freely; the
1657
+ * Open-ended role identifier. Plans invent role names freely; the
519
1658
  * role-router maps unknown names to `general` at run time.
520
1659
  */
521
1660
  export declare const RoleSchema: z.ZodString;
@@ -523,7 +1662,19 @@ export declare const RoleSchema: z.ZodString;
523
1662
  * One agent in the registry. `available` is a runtime-only flag — true
524
1663
  * if the command's first token resolves on PATH. Stripped before
525
1664
  * persistence.
1665
+ *
1666
+ * `prefs` carries the merged-at-runtime per-agent preferences (env vars,
1667
+ * model, effort). It is filled in at load time by looking up the
1668
+ * registry's `agent_prefs` map by name. The persisted shape never carries
1669
+ * `prefs` — it lives in `agent_prefs` on disk so built-in agents (which
1670
+ * are detected, not persisted) can also receive preferences.
526
1671
  */
1672
+ export declare const AgentPrefsSchema: z.ZodObject<{
1673
+ env_vars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
1674
+ model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1675
+ effort: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1676
+ }, z.core.$strict>;
1677
+ export type AgentPrefs = z.infer<typeof AgentPrefsSchema>;
527
1678
  export declare const AgentRecordSchema: z.ZodObject<{
528
1679
  name: z.ZodString;
529
1680
  display_name: z.ZodString;
@@ -533,10 +1684,21 @@ export declare const AgentRecordSchema: z.ZodObject<{
533
1684
  user: "user";
534
1685
  }>;
535
1686
  available: z.ZodOptional<z.ZodBoolean>;
1687
+ prefs: z.ZodOptional<z.ZodObject<{
1688
+ env_vars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
1689
+ model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1690
+ effort: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1691
+ }, z.core.$strict>>;
536
1692
  }, z.core.$strict>;
537
1693
  export type AgentRecord = z.infer<typeof AgentRecordSchema>;
538
1694
  export declare const RoleMapSchema: z.ZodRecord<z.ZodString, z.ZodString>;
539
1695
  export type RoleMap = z.infer<typeof RoleMapSchema>;
1696
+ export declare const AgentPrefsMapSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
1697
+ env_vars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
1698
+ model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1699
+ effort: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1700
+ }, z.core.$strict>>;
1701
+ export type AgentPrefsMap = z.infer<typeof AgentPrefsMapSchema>;
540
1702
  export declare const AgentsRegistrySchema: z.ZodObject<{
541
1703
  agents: z.ZodDefault<z.ZodArray<z.ZodObject<{
542
1704
  name: z.ZodString;
@@ -547,24 +1709,54 @@ export declare const AgentsRegistrySchema: z.ZodObject<{
547
1709
  user: "user";
548
1710
  }>;
549
1711
  available: z.ZodOptional<z.ZodBoolean>;
1712
+ prefs: z.ZodOptional<z.ZodObject<{
1713
+ env_vars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
1714
+ model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1715
+ effort: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1716
+ }, z.core.$strict>>;
550
1717
  }, z.core.$strict>>>;
551
1718
  role_map: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
1719
+ agent_prefs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
1720
+ env_vars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
1721
+ model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1722
+ effort: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1723
+ }, z.core.$strict>>>;
552
1724
  }, z.core.$strict>;
553
1725
  export type AgentsRegistry = z.infer<typeof AgentsRegistrySchema>;
554
- export type PreparationName = z.infer<typeof PreparationNameSchema>;
1726
+ export type ProjectId = z.infer<typeof ProjectIdSchema>;
555
1727
  export type BuildPlanId = z.infer<typeof BuildPlanIdSchema>;
1728
+ export type ProjectIntent = z.infer<typeof ProjectIntentSchema>;
556
1729
  export type ArtifactId = z.infer<typeof ArtifactIdSchema>;
557
1730
  export type RuntimeStage = z.infer<typeof RuntimeStageSchema>;
558
1731
  export type RuntimeContractType = z.infer<typeof RuntimeContractTypeSchema>;
559
1732
  export type RuntimeTargetType = z.infer<typeof RuntimeTargetTypeSchema>;
560
1733
  export type TestTargetType = z.infer<typeof TestTargetTypeSchema>;
561
1734
  export type SourceKind = z.infer<typeof SourceKindSchema>;
1735
+ export type SourceBinding = z.infer<typeof SourceBindingSchema>;
562
1736
  export type Source = z.infer<typeof SourceSchema>;
563
1737
  export type SourceFile = z.infer<typeof SourceFileSchema>;
564
1738
  export type SourceFiles = z.infer<typeof SourceFilesSchema>;
565
- export type SourceSnapshot = z.infer<typeof SourceSnapshotSchema>;
1739
+ export type SourceState = z.infer<typeof SourceStateSchema>;
1740
+ export type SourceInspectableUnit = z.infer<typeof SourceInspectableUnitSchema>;
1741
+ export type SourceManifestEvidence = z.infer<typeof SourceManifestEvidenceSchema>;
1742
+ export type SourceManifestFileKind = z.infer<typeof SourceManifestFileKindSchema>;
1743
+ export type SourceManifestFile = z.infer<typeof SourceManifestFileSchema>;
1744
+ export type SourceManifestScanner = z.infer<typeof SourceManifestScannerSchema>;
1745
+ export type SourceManifest = z.infer<typeof SourceManifestSchema>;
1746
+ export type SourceManifestAudit = z.infer<typeof SourceManifestAuditSchema>;
566
1747
  export type StageInput = z.infer<typeof StageInputSchema>;
567
1748
  export type StageInputs = z.infer<typeof StageInputsSchema>;
1749
+ export type ResourceRole = z.infer<typeof ResourceRoleSchema>;
1750
+ export type ResourceRef = z.infer<typeof ResourceRefSchema>;
1751
+ export type MetricCount = z.infer<typeof MetricCountSchema>;
1752
+ export type ReviewedInputDecision = z.infer<typeof ReviewedInputDecisionSchema>;
1753
+ export type ReviewedInput = z.infer<typeof ReviewedInputSchema>;
1754
+ export type MissingInput = z.infer<typeof MissingInputSchema>;
1755
+ export type StageManifest = z.infer<typeof StageManifestSchema>;
1756
+ export type GraphManifestStageSummary = z.infer<typeof GraphManifestStageSummarySchema>;
1757
+ export type GraphReadinessRollup = z.infer<typeof GraphReadinessRollupSchema>;
1758
+ export type GraphOutputCounts = z.infer<typeof GraphOutputCountsSchema>;
1759
+ export type GraphManifest = z.infer<typeof GraphManifestSchema>;
568
1760
  export type ReadinessStatus = z.infer<typeof ReadinessStatusSchema>;
569
1761
  export type ReadinessGate = z.infer<typeof ReadinessGateSchema>;
570
1762
  export type GateStatus = z.infer<typeof GateStatusSchema>;