@interf/compiler 0.9.5 → 0.13.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 (214) hide show
  1. package/README.md +96 -92
  2. package/TRADEMARKS.md +2 -13
  3. package/agent-skills/interf-actions/SKILL.md +95 -36
  4. package/agent-skills/interf-actions/references/cli.md +118 -51
  5. package/builtin-methods/interf-default/README.md +3 -4
  6. package/builtin-methods/interf-default/compile/stages/shape/SKILL.md +2 -2
  7. package/builtin-methods/interf-default/compile/stages/summarize/SKILL.md +2 -1
  8. package/builtin-methods/interf-default/improve/SKILL.md +1 -1
  9. package/builtin-methods/interf-default/method.json +10 -4
  10. package/builtin-methods/interf-default/method.schema.json +0 -9
  11. package/builtin-methods/interf-default/use/query/SKILL.md +5 -5
  12. package/dist/cli/commands/compile.d.ts +8 -25
  13. package/dist/cli/commands/compile.js +75 -360
  14. package/dist/cli/commands/doctor.js +1 -1
  15. package/dist/cli/commands/login.d.ts +7 -0
  16. package/dist/cli/commands/login.js +39 -0
  17. package/dist/cli/commands/logout.d.ts +2 -0
  18. package/dist/cli/commands/logout.js +16 -0
  19. package/dist/cli/commands/method.d.ts +2 -0
  20. package/dist/cli/commands/method.js +113 -0
  21. package/dist/cli/commands/prep.d.ts +2 -0
  22. package/dist/cli/commands/prep.js +134 -0
  23. package/dist/cli/commands/reset.d.ts +8 -1
  24. package/dist/cli/commands/reset.js +47 -26
  25. package/dist/cli/commands/runs.d.ts +2 -0
  26. package/dist/cli/commands/runs.js +120 -0
  27. package/dist/cli/commands/status.d.ts +6 -1
  28. package/dist/cli/commands/status.js +68 -111
  29. package/dist/cli/commands/test.d.ts +6 -14
  30. package/dist/cli/commands/test.js +65 -181
  31. package/dist/cli/commands/web.d.ts +0 -9
  32. package/dist/cli/commands/web.js +147 -120
  33. package/dist/cli/commands/wizard.d.ts +9 -0
  34. package/dist/cli/commands/wizard.js +442 -0
  35. package/dist/cli/index.d.ts +7 -6
  36. package/dist/cli/index.js +13 -10
  37. package/dist/compiler-ui/404.html +1 -1
  38. package/dist/compiler-ui/__next.__PAGE__.txt +2 -2
  39. package/dist/compiler-ui/__next._full.txt +3 -3
  40. package/dist/compiler-ui/__next._head.txt +1 -1
  41. package/dist/compiler-ui/__next._index.txt +2 -2
  42. package/dist/compiler-ui/__next._tree.txt +2 -2
  43. package/dist/compiler-ui/_next/static/chunks/{18a8f2jkv3z.c.css → 045gole2ojo3g.css} +1 -1
  44. package/dist/compiler-ui/_next/static/chunks/{177mvn4rse235.js → 17t-lulmyawg5.js} +9 -9
  45. package/dist/compiler-ui/_not-found/__next._full.txt +2 -2
  46. package/dist/compiler-ui/_not-found/__next._head.txt +1 -1
  47. package/dist/compiler-ui/_not-found/__next._index.txt +2 -2
  48. package/dist/compiler-ui/_not-found/__next._not-found.__PAGE__.txt +1 -1
  49. package/dist/compiler-ui/_not-found/__next._not-found.txt +1 -1
  50. package/dist/compiler-ui/_not-found/__next._tree.txt +2 -2
  51. package/dist/compiler-ui/_not-found.html +1 -1
  52. package/dist/compiler-ui/_not-found.txt +2 -2
  53. package/dist/compiler-ui/index.html +1 -1
  54. package/dist/compiler-ui/index.txt +3 -3
  55. package/dist/packages/agents/lib/shells.d.ts +1 -1
  56. package/dist/packages/agents/lib/shells.js +111 -52
  57. package/dist/packages/agents/lib/user-config.d.ts +4 -2
  58. package/dist/packages/agents/lib/user-config.js +15 -7
  59. package/dist/packages/compiler/compiled-paths.d.ts +9 -2
  60. package/dist/packages/compiler/compiled-paths.js +30 -15
  61. package/dist/packages/compiler/compiled-pipeline.js +23 -3
  62. package/dist/packages/compiler/compiled-stage-plan.js +4 -0
  63. package/dist/packages/compiler/compiled-target.d.ts +1 -1
  64. package/dist/packages/compiler/compiled-target.js +1 -1
  65. package/dist/packages/compiler/index.d.ts +1 -0
  66. package/dist/packages/compiler/index.js +1 -0
  67. package/dist/packages/compiler/lib/schema.d.ts +26 -31
  68. package/dist/packages/compiler/lib/schema.js +1 -12
  69. package/dist/packages/compiler/method-runs.d.ts +2 -3
  70. package/dist/packages/compiler/method-runs.js +2 -3
  71. package/dist/packages/compiler/reset.js +3 -1
  72. package/dist/packages/compiler/runtime-contracts.js +0 -3
  73. package/dist/packages/compiler/runtime-prompt.js +1 -1
  74. package/dist/packages/compiler/source-files.d.ts +46 -0
  75. package/dist/packages/compiler/source-files.js +149 -0
  76. package/dist/packages/compiler/state-artifacts.d.ts +3 -2
  77. package/dist/packages/compiler/state-artifacts.js +4 -3
  78. package/dist/packages/compiler/state-io.d.ts +3 -2
  79. package/dist/packages/compiler/state-io.js +11 -5
  80. package/dist/packages/compiler/state-paths.d.ts +2 -1
  81. package/dist/packages/compiler/state-paths.js +6 -3
  82. package/dist/packages/compiler/state-view.d.ts +3 -2
  83. package/dist/packages/compiler/state-view.js +18 -28
  84. package/dist/packages/compiler/state.d.ts +4 -4
  85. package/dist/packages/compiler/state.js +3 -3
  86. package/dist/packages/contracts/index.d.ts +1 -1
  87. package/dist/packages/contracts/lib/preparation-paths.d.ts +117 -0
  88. package/dist/packages/contracts/lib/preparation-paths.js +177 -0
  89. package/dist/packages/contracts/lib/schema.d.ts +85 -5
  90. package/dist/packages/contracts/lib/schema.js +46 -1
  91. package/dist/packages/execution/lib/schema.d.ts +50 -50
  92. package/dist/packages/execution/lib/schema.js +1 -1
  93. package/dist/packages/local-service/action-definitions.d.ts +14 -14
  94. package/dist/packages/local-service/action-definitions.js +27 -28
  95. package/dist/packages/local-service/action-planner.js +2 -1
  96. package/dist/packages/local-service/client.d.ts +51 -52
  97. package/dist/packages/local-service/client.js +132 -140
  98. package/dist/packages/local-service/connection-config.d.ts +38 -0
  99. package/dist/packages/local-service/connection-config.js +75 -0
  100. package/dist/packages/local-service/index.d.ts +11 -7
  101. package/dist/packages/local-service/index.js +6 -4
  102. package/dist/packages/local-service/instance-paths.d.ts +100 -0
  103. package/dist/packages/local-service/instance-paths.js +165 -0
  104. package/dist/packages/local-service/lib/schema.d.ts +405 -2297
  105. package/dist/packages/local-service/lib/schema.js +146 -62
  106. package/dist/packages/local-service/native-run-handlers.js +3 -3
  107. package/dist/packages/local-service/preparation-store.d.ts +92 -0
  108. package/dist/packages/local-service/preparation-store.js +171 -0
  109. package/dist/packages/local-service/routes.d.ts +33 -16
  110. package/dist/packages/local-service/routes.js +44 -20
  111. package/dist/packages/local-service/run-observability.js +11 -11
  112. package/dist/packages/local-service/runtime-caches.d.ts +76 -0
  113. package/dist/packages/local-service/runtime-caches.js +191 -0
  114. package/dist/packages/local-service/runtime-event-applier.d.ts +12 -0
  115. package/dist/packages/local-service/runtime-event-applier.js +177 -0
  116. package/dist/packages/local-service/runtime-persistence.d.ts +47 -0
  117. package/dist/packages/local-service/runtime-persistence.js +137 -0
  118. package/dist/packages/local-service/runtime-proposal-helpers.d.ts +35 -0
  119. package/dist/packages/local-service/runtime-proposal-helpers.js +251 -0
  120. package/dist/packages/local-service/runtime-resource-builders.d.ts +52 -0
  121. package/dist/packages/local-service/runtime-resource-builders.js +149 -0
  122. package/dist/packages/local-service/runtime.d.ts +197 -43
  123. package/dist/packages/local-service/runtime.js +800 -974
  124. package/dist/packages/local-service/server.d.ts +15 -0
  125. package/dist/packages/local-service/server.js +641 -273
  126. package/dist/packages/local-service/service-registry.d.ts +47 -0
  127. package/dist/packages/local-service/service-registry.js +137 -0
  128. package/dist/packages/method-authoring/method-authoring.d.ts +1 -1
  129. package/dist/packages/method-authoring/method-authoring.js +2 -2
  130. package/dist/packages/method-authoring/method-improvement.js +1 -1
  131. package/dist/packages/method-package/builtin-compiled-method.d.ts +4 -5
  132. package/dist/packages/method-package/builtin-compiled-method.js +8 -14
  133. package/dist/packages/method-package/context-interface.d.ts +4 -40
  134. package/dist/packages/method-package/context-interface.js +1 -23
  135. package/dist/packages/method-package/interf-method-package.d.ts +4 -4
  136. package/dist/packages/method-package/interf-method-package.js +21 -33
  137. package/dist/packages/method-package/local-methods.d.ts +10 -6
  138. package/dist/packages/method-package/local-methods.js +57 -39
  139. package/dist/packages/method-package/method-definitions.d.ts +8 -34
  140. package/dist/packages/method-package/method-definitions.js +49 -37
  141. package/dist/packages/method-package/method-helpers.d.ts +1 -13
  142. package/dist/packages/method-package/method-helpers.js +8 -42
  143. package/dist/packages/method-package/method-stage-runner.js +2 -2
  144. package/dist/packages/method-package/user-methods.d.ts +17 -0
  145. package/dist/packages/method-package/user-methods.js +77 -0
  146. package/dist/packages/project-model/index.d.ts +0 -1
  147. package/dist/packages/project-model/index.js +0 -1
  148. package/dist/packages/project-model/interf-detect.d.ts +8 -3
  149. package/dist/packages/project-model/interf-detect.js +34 -34
  150. package/dist/packages/project-model/interf-scaffold.d.ts +3 -3
  151. package/dist/packages/project-model/interf-scaffold.js +23 -32
  152. package/dist/packages/project-model/lib/schema.js +38 -1
  153. package/dist/packages/project-model/preparation-entries.d.ts +5 -5
  154. package/dist/packages/project-model/preparation-entries.js +14 -14
  155. package/dist/packages/project-model/source-config.d.ts +11 -11
  156. package/dist/packages/project-model/source-config.js +74 -46
  157. package/dist/packages/project-model/source-folders.d.ts +5 -5
  158. package/dist/packages/project-model/source-folders.js +14 -14
  159. package/dist/packages/shared/filesystem.d.ts +7 -0
  160. package/dist/packages/shared/filesystem.js +97 -10
  161. package/dist/packages/testing/lib/schema.d.ts +10 -10
  162. package/dist/packages/testing/lib/schema.js +2 -2
  163. package/dist/packages/testing/readiness-check-run.d.ts +4 -4
  164. package/dist/packages/testing/readiness-check-run.js +36 -36
  165. package/dist/packages/testing/test-execution.js +6 -6
  166. package/dist/packages/testing/test-paths.js +4 -3
  167. package/dist/packages/testing/test-sandbox.d.ts +0 -1
  168. package/dist/packages/testing/test-sandbox.js +14 -30
  169. package/dist/packages/testing/test-targets.d.ts +1 -1
  170. package/dist/packages/testing/test-targets.js +6 -6
  171. package/dist/packages/testing/test.d.ts +1 -1
  172. package/dist/packages/testing/test.js +1 -1
  173. package/package.json +3 -4
  174. package/CHANGELOG.md +0 -93
  175. package/LICENSE +0 -183
  176. package/dist/cli/commands/action-input-cli.d.ts +0 -25
  177. package/dist/cli/commands/action-input-cli.js +0 -73
  178. package/dist/cli/commands/control-path.d.ts +0 -11
  179. package/dist/cli/commands/control-path.js +0 -72
  180. package/dist/cli/commands/create-method-wizard.d.ts +0 -64
  181. package/dist/cli/commands/create-method-wizard.js +0 -434
  182. package/dist/cli/commands/create.d.ts +0 -6
  183. package/dist/cli/commands/create.js +0 -183
  184. package/dist/cli/commands/default.d.ts +0 -2
  185. package/dist/cli/commands/default.js +0 -39
  186. package/dist/cli/commands/executor-flow.d.ts +0 -29
  187. package/dist/cli/commands/executor-flow.js +0 -163
  188. package/dist/cli/commands/init.d.ts +0 -26
  189. package/dist/cli/commands/init.js +0 -771
  190. package/dist/cli/commands/list.d.ts +0 -2
  191. package/dist/cli/commands/list.js +0 -30
  192. package/dist/cli/commands/preparation-action.d.ts +0 -8
  193. package/dist/cli/commands/preparation-action.js +0 -29
  194. package/dist/cli/commands/preparation-picker.d.ts +0 -5
  195. package/dist/cli/commands/preparation-picker.js +0 -36
  196. package/dist/cli/commands/preparation-selection.d.ts +0 -6
  197. package/dist/cli/commands/preparation-selection.js +0 -11
  198. package/dist/cli/commands/service-action-flow.d.ts +0 -9
  199. package/dist/cli/commands/service-action-flow.js +0 -19
  200. package/dist/cli/commands/source-config-wizard.d.ts +0 -51
  201. package/dist/cli/commands/source-config-wizard.js +0 -670
  202. package/dist/cli/commands/verify.d.ts +0 -2
  203. package/dist/cli/commands/verify.js +0 -94
  204. package/dist/packages/compiler/raw-snapshot.d.ts +0 -49
  205. package/dist/packages/compiler/raw-snapshot.js +0 -101
  206. package/dist/packages/method-package/index.d.ts +0 -11
  207. package/dist/packages/method-package/index.js +0 -11
  208. package/dist/packages/method-package/method-stage-policy.d.ts +0 -5
  209. package/dist/packages/method-package/method-stage-policy.js +0 -31
  210. package/dist/packages/project-model/project-paths.d.ts +0 -12
  211. package/dist/packages/project-model/project-paths.js +0 -33
  212. /package/dist/compiler-ui/_next/static/{84FaeF3EzBF9kKTMjSEVN → C6vVfy3aeYuIO3d2AoNvC}/_buildManifest.js +0 -0
  213. /package/dist/compiler-ui/_next/static/{84FaeF3EzBF9kKTMjSEVN → C6vVfy3aeYuIO3d2AoNvC}/_clientMiddlewareManifest.js +0 -0
  214. /package/dist/compiler-ui/_next/static/{84FaeF3EzBF9kKTMjSEVN → C6vVfy3aeYuIO3d2AoNvC}/_ssgManifest.js +0 -0
@@ -160,9 +160,9 @@ export declare const ObservableRunTypeSchema: z.ZodEnum<{
160
160
  job: "job";
161
161
  }>;
162
162
  export declare const ObservableRunStatusSchema: z.ZodEnum<{
163
+ succeeded: "succeeded";
163
164
  failed: "failed";
164
165
  running: "running";
165
- succeeded: "succeeded";
166
166
  cancelled: "cancelled";
167
167
  queued: "queued";
168
168
  }>;
@@ -176,33 +176,33 @@ export declare const ExecutionBackendKindSchema: z.ZodEnum<{
176
176
  "workflow-sdk": "workflow-sdk";
177
177
  }>;
178
178
  export declare const CompileRunStatusSchema: z.ZodEnum<{
179
+ succeeded: "succeeded";
179
180
  failed: "failed";
180
181
  running: "running";
181
- succeeded: "succeeded";
182
182
  cancelled: "cancelled";
183
183
  queued: "queued";
184
184
  }>;
185
185
  export declare const StageRunStatusSchema: z.ZodEnum<{
186
+ succeeded: "succeeded";
186
187
  failed: "failed";
187
188
  running: "running";
188
- succeeded: "succeeded";
189
189
  queued: "queued";
190
190
  }>;
191
191
  export declare const ArtifactRoleSchema: z.ZodEnum<{
192
- output: "output";
193
192
  runtime: "runtime";
193
+ output: "output";
194
194
  source: "source";
195
- test: "test";
196
195
  proof: "proof";
196
+ test: "test";
197
197
  }>;
198
198
  export declare const ArtifactRefSchema: z.ZodObject<{
199
199
  path: z.ZodString;
200
200
  role: z.ZodEnum<{
201
- output: "output";
202
201
  runtime: "runtime";
202
+ output: "output";
203
203
  source: "source";
204
- test: "test";
205
204
  proof: "proof";
205
+ test: "test";
206
206
  }>;
207
207
  stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
208
208
  label: z.ZodOptional<z.ZodString>;
@@ -228,9 +228,9 @@ export declare const RunObservabilitySchema: z.ZodObject<{
228
228
  }>;
229
229
  title: z.ZodString;
230
230
  status: z.ZodEnum<{
231
+ succeeded: "succeeded";
231
232
  failed: "failed";
232
233
  running: "running";
233
- succeeded: "succeeded";
234
234
  cancelled: "cancelled";
235
235
  queued: "queued";
236
236
  }>;
@@ -264,11 +264,11 @@ export declare const RunObservabilitySchema: z.ZodObject<{
264
264
  artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
265
265
  path: z.ZodString;
266
266
  role: z.ZodEnum<{
267
- output: "output";
268
267
  runtime: "runtime";
268
+ output: "output";
269
269
  source: "source";
270
- test: "test";
271
270
  proof: "proof";
271
+ test: "test";
272
272
  }>;
273
273
  stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
274
274
  label: z.ZodOptional<z.ZodString>;
@@ -303,8 +303,8 @@ export declare const RunObservabilitySchema: z.ZodObject<{
303
303
  latest_test_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
304
304
  compile: z.ZodNullable<z.ZodObject<{
305
305
  gate: z.ZodEnum<{
306
- "preparation-config": "preparation-config";
307
306
  "portable-context": "portable-context";
307
+ "preparation-config": "preparation-config";
308
308
  "compile-run": "compile-run";
309
309
  "readiness-checks": "readiness-checks";
310
310
  "source-baseline": "source-baseline";
@@ -352,8 +352,8 @@ export declare const RunObservabilitySchema: z.ZodObject<{
352
352
  }, z.core.$strict>;
353
353
  checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
354
354
  gate: z.ZodEnum<{
355
- "preparation-config": "preparation-config";
356
355
  "portable-context": "portable-context";
356
+ "preparation-config": "preparation-config";
357
357
  "compile-run": "compile-run";
358
358
  "readiness-checks": "readiness-checks";
359
359
  "source-baseline": "source-baseline";
@@ -451,11 +451,11 @@ export declare const ProofRecordSchema: z.ZodObject<{
451
451
  artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
452
452
  path: z.ZodString;
453
453
  role: z.ZodEnum<{
454
- output: "output";
455
454
  runtime: "runtime";
455
+ output: "output";
456
456
  source: "source";
457
- test: "test";
458
457
  proof: "proof";
458
+ test: "test";
459
459
  }>;
460
460
  stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
461
461
  label: z.ZodOptional<z.ZodString>;
@@ -521,11 +521,11 @@ export declare const ArtifactWrittenEventSchema: z.ZodObject<{
521
521
  artifact: z.ZodObject<{
522
522
  path: z.ZodString;
523
523
  role: z.ZodEnum<{
524
- output: "output";
525
524
  runtime: "runtime";
525
+ output: "output";
526
526
  source: "source";
527
- test: "test";
528
527
  proof: "proof";
528
+ test: "test";
529
529
  }>;
530
530
  stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
531
531
  label: z.ZodOptional<z.ZodString>;
@@ -548,11 +548,11 @@ export declare const ProofUpdatedEventSchema: z.ZodObject<{
548
548
  artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
549
549
  path: z.ZodString;
550
550
  role: z.ZodEnum<{
551
- output: "output";
552
551
  runtime: "runtime";
552
+ output: "output";
553
553
  source: "source";
554
- test: "test";
555
554
  proof: "proof";
555
+ test: "test";
556
556
  }>;
557
557
  stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
558
558
  label: z.ZodOptional<z.ZodString>;
@@ -617,8 +617,8 @@ export declare const ChecksEvaluatedEventSchema: z.ZodObject<{
617
617
  passed: z.ZodNumber;
618
618
  total: z.ZodNumber;
619
619
  target: z.ZodOptional<z.ZodEnum<{
620
+ "source-files": "source-files";
620
621
  compiled: "compiled";
621
- raw: "raw";
622
622
  }>>;
623
623
  checks_fingerprint: z.ZodOptional<z.ZodString>;
624
624
  stale: z.ZodOptional<z.ZodBoolean>;
@@ -653,8 +653,8 @@ export declare const ReadinessUpdatedEventSchema: z.ZodObject<{
653
653
  latest_test_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
654
654
  compile: z.ZodNullable<z.ZodObject<{
655
655
  gate: z.ZodEnum<{
656
- "preparation-config": "preparation-config";
657
656
  "portable-context": "portable-context";
657
+ "preparation-config": "preparation-config";
658
658
  "compile-run": "compile-run";
659
659
  "readiness-checks": "readiness-checks";
660
660
  "source-baseline": "source-baseline";
@@ -702,8 +702,8 @@ export declare const ReadinessUpdatedEventSchema: z.ZodObject<{
702
702
  }, z.core.$strict>;
703
703
  checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
704
704
  gate: z.ZodEnum<{
705
- "preparation-config": "preparation-config";
706
705
  "portable-context": "portable-context";
706
+ "preparation-config": "preparation-config";
707
707
  "compile-run": "compile-run";
708
708
  "readiness-checks": "readiness-checks";
709
709
  "source-baseline": "source-baseline";
@@ -765,11 +765,11 @@ export declare const InterfRunEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
765
765
  artifact: z.ZodObject<{
766
766
  path: z.ZodString;
767
767
  role: z.ZodEnum<{
768
- output: "output";
769
768
  runtime: "runtime";
769
+ output: "output";
770
770
  source: "source";
771
- test: "test";
772
771
  proof: "proof";
772
+ test: "test";
773
773
  }>;
774
774
  stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
775
775
  label: z.ZodOptional<z.ZodString>;
@@ -791,11 +791,11 @@ export declare const InterfRunEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
791
791
  artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
792
792
  path: z.ZodString;
793
793
  role: z.ZodEnum<{
794
- output: "output";
795
794
  runtime: "runtime";
795
+ output: "output";
796
796
  source: "source";
797
- test: "test";
798
797
  proof: "proof";
798
+ test: "test";
799
799
  }>;
800
800
  stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
801
801
  label: z.ZodOptional<z.ZodString>;
@@ -854,8 +854,8 @@ export declare const InterfRunEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
854
854
  passed: z.ZodNumber;
855
855
  total: z.ZodNumber;
856
856
  target: z.ZodOptional<z.ZodEnum<{
857
+ "source-files": "source-files";
857
858
  compiled: "compiled";
858
- raw: "raw";
859
859
  }>>;
860
860
  checks_fingerprint: z.ZodOptional<z.ZodString>;
861
861
  stale: z.ZodOptional<z.ZodBoolean>;
@@ -889,8 +889,8 @@ export declare const InterfRunEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
889
889
  latest_test_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
890
890
  compile: z.ZodNullable<z.ZodObject<{
891
891
  gate: z.ZodEnum<{
892
- "preparation-config": "preparation-config";
893
892
  "portable-context": "portable-context";
893
+ "preparation-config": "preparation-config";
894
894
  "compile-run": "compile-run";
895
895
  "readiness-checks": "readiness-checks";
896
896
  "source-baseline": "source-baseline";
@@ -938,8 +938,8 @@ export declare const InterfRunEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
938
938
  }, z.core.$strict>;
939
939
  checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
940
940
  gate: z.ZodEnum<{
941
- "preparation-config": "preparation-config";
942
941
  "portable-context": "portable-context";
942
+ "preparation-config": "preparation-config";
943
943
  "compile-run": "compile-run";
944
944
  "readiness-checks": "readiness-checks";
945
945
  "source-baseline": "source-baseline";
@@ -972,9 +972,9 @@ export declare const StageRunSchema: z.ZodObject<{
972
972
  stage_index: z.ZodOptional<z.ZodNumber>;
973
973
  stage_total: z.ZodOptional<z.ZodNumber>;
974
974
  status: z.ZodEnum<{
975
+ succeeded: "succeeded";
975
976
  failed: "failed";
976
977
  running: "running";
977
- succeeded: "succeeded";
978
978
  queued: "queued";
979
979
  }>;
980
980
  started_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1005,11 +1005,11 @@ export declare const StageRunSchema: z.ZodObject<{
1005
1005
  artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
1006
1006
  path: z.ZodString;
1007
1007
  role: z.ZodEnum<{
1008
- output: "output";
1009
1008
  runtime: "runtime";
1009
+ output: "output";
1010
1010
  source: "source";
1011
- test: "test";
1012
1011
  proof: "proof";
1012
+ test: "test";
1013
1013
  }>;
1014
1014
  stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1015
1015
  label: z.ZodOptional<z.ZodString>;
@@ -1031,11 +1031,11 @@ export declare const StageRunSchema: z.ZodObject<{
1031
1031
  artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
1032
1032
  path: z.ZodString;
1033
1033
  role: z.ZodEnum<{
1034
- output: "output";
1035
1034
  runtime: "runtime";
1035
+ output: "output";
1036
1036
  source: "source";
1037
- test: "test";
1038
1037
  proof: "proof";
1038
+ test: "test";
1039
1039
  }>;
1040
1040
  stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1041
1041
  label: z.ZodOptional<z.ZodString>;
@@ -1055,9 +1055,9 @@ export declare const CompileRunSchema: z.ZodObject<{
1055
1055
  version: z.ZodLiteral<1>;
1056
1056
  run_id: z.ZodString;
1057
1057
  status: z.ZodEnum<{
1058
+ succeeded: "succeeded";
1058
1059
  failed: "failed";
1059
1060
  running: "running";
1060
- succeeded: "succeeded";
1061
1061
  cancelled: "cancelled";
1062
1062
  queued: "queued";
1063
1063
  }>;
@@ -1079,9 +1079,9 @@ export declare const CompileRunSchema: z.ZodObject<{
1079
1079
  stage_index: z.ZodOptional<z.ZodNumber>;
1080
1080
  stage_total: z.ZodOptional<z.ZodNumber>;
1081
1081
  status: z.ZodEnum<{
1082
+ succeeded: "succeeded";
1082
1083
  failed: "failed";
1083
1084
  running: "running";
1084
- succeeded: "succeeded";
1085
1085
  queued: "queued";
1086
1086
  }>;
1087
1087
  started_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1112,11 +1112,11 @@ export declare const CompileRunSchema: z.ZodObject<{
1112
1112
  artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
1113
1113
  path: z.ZodString;
1114
1114
  role: z.ZodEnum<{
1115
- output: "output";
1116
1115
  runtime: "runtime";
1116
+ output: "output";
1117
1117
  source: "source";
1118
- test: "test";
1119
1118
  proof: "proof";
1119
+ test: "test";
1120
1120
  }>;
1121
1121
  stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1122
1122
  label: z.ZodOptional<z.ZodString>;
@@ -1138,11 +1138,11 @@ export declare const CompileRunSchema: z.ZodObject<{
1138
1138
  artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
1139
1139
  path: z.ZodString;
1140
1140
  role: z.ZodEnum<{
1141
- output: "output";
1142
1141
  runtime: "runtime";
1142
+ output: "output";
1143
1143
  source: "source";
1144
- test: "test";
1145
1144
  proof: "proof";
1145
+ test: "test";
1146
1146
  }>;
1147
1147
  stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1148
1148
  label: z.ZodOptional<z.ZodString>;
@@ -1193,11 +1193,11 @@ export declare const CompileRunSchema: z.ZodObject<{
1193
1193
  artifact: z.ZodObject<{
1194
1194
  path: z.ZodString;
1195
1195
  role: z.ZodEnum<{
1196
- output: "output";
1197
1196
  runtime: "runtime";
1197
+ output: "output";
1198
1198
  source: "source";
1199
- test: "test";
1200
1199
  proof: "proof";
1200
+ test: "test";
1201
1201
  }>;
1202
1202
  stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1203
1203
  label: z.ZodOptional<z.ZodString>;
@@ -1219,11 +1219,11 @@ export declare const CompileRunSchema: z.ZodObject<{
1219
1219
  artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
1220
1220
  path: z.ZodString;
1221
1221
  role: z.ZodEnum<{
1222
- output: "output";
1223
1222
  runtime: "runtime";
1223
+ output: "output";
1224
1224
  source: "source";
1225
- test: "test";
1226
1225
  proof: "proof";
1226
+ test: "test";
1227
1227
  }>;
1228
1228
  stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1229
1229
  label: z.ZodOptional<z.ZodString>;
@@ -1282,8 +1282,8 @@ export declare const CompileRunSchema: z.ZodObject<{
1282
1282
  passed: z.ZodNumber;
1283
1283
  total: z.ZodNumber;
1284
1284
  target: z.ZodOptional<z.ZodEnum<{
1285
+ "source-files": "source-files";
1285
1286
  compiled: "compiled";
1286
- raw: "raw";
1287
1287
  }>>;
1288
1288
  checks_fingerprint: z.ZodOptional<z.ZodString>;
1289
1289
  stale: z.ZodOptional<z.ZodBoolean>;
@@ -1317,8 +1317,8 @@ export declare const CompileRunSchema: z.ZodObject<{
1317
1317
  latest_test_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1318
1318
  compile: z.ZodNullable<z.ZodObject<{
1319
1319
  gate: z.ZodEnum<{
1320
- "preparation-config": "preparation-config";
1321
1320
  "portable-context": "portable-context";
1321
+ "preparation-config": "preparation-config";
1322
1322
  "compile-run": "compile-run";
1323
1323
  "readiness-checks": "readiness-checks";
1324
1324
  "source-baseline": "source-baseline";
@@ -1366,8 +1366,8 @@ export declare const CompileRunSchema: z.ZodObject<{
1366
1366
  }, z.core.$strict>;
1367
1367
  checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
1368
1368
  gate: z.ZodEnum<{
1369
- "preparation-config": "preparation-config";
1370
1369
  "portable-context": "portable-context";
1370
+ "preparation-config": "preparation-config";
1371
1371
  "compile-run": "compile-run";
1372
1372
  "readiness-checks": "readiness-checks";
1373
1373
  "source-baseline": "source-baseline";
@@ -1403,11 +1403,11 @@ export declare const CompileRunSchema: z.ZodObject<{
1403
1403
  artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
1404
1404
  path: z.ZodString;
1405
1405
  role: z.ZodEnum<{
1406
- output: "output";
1407
1406
  runtime: "runtime";
1407
+ output: "output";
1408
1408
  source: "source";
1409
- test: "test";
1410
1409
  proof: "proof";
1410
+ test: "test";
1411
1411
  }>;
1412
1412
  stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1413
1413
  label: z.ZodOptional<z.ZodString>;
@@ -1443,8 +1443,8 @@ export declare const CompileRunSchema: z.ZodObject<{
1443
1443
  latest_test_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1444
1444
  compile: z.ZodNullable<z.ZodObject<{
1445
1445
  gate: z.ZodEnum<{
1446
- "preparation-config": "preparation-config";
1447
1446
  "portable-context": "portable-context";
1447
+ "preparation-config": "preparation-config";
1448
1448
  "compile-run": "compile-run";
1449
1449
  "readiness-checks": "readiness-checks";
1450
1450
  "source-baseline": "source-baseline";
@@ -1492,8 +1492,8 @@ export declare const CompileRunSchema: z.ZodObject<{
1492
1492
  }, z.core.$strict>;
1493
1493
  checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
1494
1494
  gate: z.ZodEnum<{
1495
- "preparation-config": "preparation-config";
1496
1495
  "portable-context": "portable-context";
1496
+ "preparation-config": "preparation-config";
1497
1497
  "compile-run": "compile-run";
1498
1498
  "readiness-checks": "readiness-checks";
1499
1499
  "source-baseline": "source-baseline";
@@ -234,7 +234,7 @@ export const ChecksEvaluatedEventSchema = RunEventBaseSchema.extend({
234
234
  type: z.literal("checks.evaluated"),
235
235
  passed: z.number().int().min(0),
236
236
  total: z.number().int().min(0),
237
- target: z.enum(["raw", "compiled"]).optional(),
237
+ target: z.enum(["source-files", "compiled"]).optional(),
238
238
  checks_fingerprint: z.string().min(1).optional(),
239
239
  stale: z.boolean().optional(),
240
240
  test_run_id: z.string().min(1).optional(),
@@ -42,25 +42,25 @@ export declare const INTERF_SERVICE_ACTIONS: {
42
42
  readonly id: "create-preparation";
43
43
  readonly serviceAction: "preparation-setup";
44
44
  readonly title: "Create Preparation";
45
- readonly description: "Save a Source Folder and agent job as a Preparation.";
45
+ readonly description: "Save a Source Folder + Method binding so future runs can be invoked by name.";
46
46
  };
47
- readonly runPreparation: {
48
- readonly id: "prepare-run";
47
+ readonly compileRun: {
48
+ readonly id: "compile-run";
49
49
  readonly serviceAction: "compile";
50
- readonly title: "Run Preparation";
51
- readonly description: "Build portable context for a saved Preparation.";
50
+ readonly title: "Compile Method";
51
+ readonly description: "Run the chosen Method against this Source Folder and write portable context.";
52
52
  };
53
53
  readonly selectMethod: {
54
54
  readonly id: "select-method";
55
55
  readonly serviceAction: "preparation-setup";
56
56
  readonly title: "Select Method";
57
- readonly description: "Save the Method a Preparation should use for future prepare runs.";
57
+ readonly description: "Choose which Method this saved binding should use for future runs.";
58
58
  };
59
59
  readonly createMethod: {
60
60
  readonly id: "create-method";
61
61
  readonly serviceAction: "method-authoring";
62
- readonly title: "Create Method";
63
- readonly description: "Draft a reusable local Method for an agent-work pattern.";
62
+ readonly title: "Draft Method";
63
+ readonly description: "Draft a reusable local Method that captures a repeatable agent-work pattern.";
64
64
  };
65
65
  readonly methodChange: {
66
66
  readonly id: "method-change";
@@ -95,8 +95,8 @@ export declare const INTERF_SERVICE_ACTIONS: {
95
95
  readonly improvePreparation: {
96
96
  readonly id: "improve-preparation";
97
97
  readonly serviceAction: "method-improvement";
98
- readonly title: "Improve Preparation";
99
- readonly description: "Use readiness evidence to improve the Method for this Preparation.";
98
+ readonly title: "Improve Method";
99
+ readonly description: "Use readiness evidence to refine the Method this saved binding uses.";
100
100
  };
101
101
  };
102
102
  export type InterfServiceActionKey = keyof typeof INTERF_SERVICE_ACTIONS;
@@ -146,10 +146,10 @@ export type MethodActionChoice = {
146
146
  export type CreatePreparationActionContext = {
147
147
  existingNames: string[];
148
148
  methods: MethodActionChoice[];
149
- sourcePath: string;
149
+ prepDataDir: string;
150
150
  suggestedName: string;
151
151
  };
152
- export type PrepareRunActionContext = {
152
+ export type CompileRunActionContext = {
153
153
  about: string;
154
154
  methodId: string;
155
155
  name: string;
@@ -232,8 +232,8 @@ export declare function methodImprovementActionValues(options: {
232
232
  preparationName: string;
233
233
  }): MethodAuthoringActionValues;
234
234
  export declare function buildCreatePreparationActionDefinition(context: CreatePreparationActionContext): ActionInputDefinition;
235
- export declare function buildPrepareRunActionDefinition(context: PrepareRunActionContext): ActionInputDefinition;
236
- export declare function buildPrepareRunActionDraft(context: PrepareRunActionContext): ActionInputDraft;
235
+ export declare function buildCompileRunActionDefinition(context: CompileRunActionContext): ActionInputDefinition;
236
+ export declare function buildCompileRunActionDraft(context: CompileRunActionContext): ActionInputDraft;
237
237
  export declare function buildSelectMethodActionDefinition(context: SelectMethodActionContext): ActionInputDefinition;
238
238
  export declare function buildCreateMethodActionDefinition(context: CreateMethodActionContext): ActionInputDefinition;
239
239
  export declare function buildMethodChangeActionDefinition(context: MethodChangeActionContext): ActionInputDefinition;
@@ -33,25 +33,25 @@ export const INTERF_SERVICE_ACTIONS = {
33
33
  id: "create-preparation",
34
34
  serviceAction: "preparation-setup",
35
35
  title: "Create Preparation",
36
- description: "Save a Source Folder and agent job as a Preparation.",
36
+ description: "Save a Source Folder + Method binding so future runs can be invoked by name.",
37
37
  },
38
- runPreparation: {
39
- id: "prepare-run",
38
+ compileRun: {
39
+ id: "compile-run",
40
40
  serviceAction: "compile",
41
- title: "Run Preparation",
42
- description: "Build portable context for a saved Preparation.",
41
+ title: "Compile Method",
42
+ description: "Run the chosen Method against this Source Folder and write portable context.",
43
43
  },
44
44
  selectMethod: {
45
45
  id: "select-method",
46
46
  serviceAction: "preparation-setup",
47
47
  title: "Select Method",
48
- description: "Save the Method a Preparation should use for future prepare runs.",
48
+ description: "Choose which Method this saved binding should use for future runs.",
49
49
  },
50
50
  createMethod: {
51
51
  id: "create-method",
52
52
  serviceAction: "method-authoring",
53
- title: "Create Method",
54
- description: "Draft a reusable local Method for an agent-work pattern.",
53
+ title: "Draft Method",
54
+ description: "Draft a reusable local Method that captures a repeatable agent-work pattern.",
55
55
  },
56
56
  methodChange: {
57
57
  id: "method-change",
@@ -86,8 +86,8 @@ export const INTERF_SERVICE_ACTIONS = {
86
86
  improvePreparation: {
87
87
  id: "improve-preparation",
88
88
  serviceAction: "method-improvement",
89
- title: "Improve Preparation",
90
- description: "Use readiness evidence to improve the Method for this Preparation.",
89
+ title: "Improve Method",
90
+ description: "Use readiness evidence to refine the Method this saved binding uses.",
91
91
  },
92
92
  };
93
93
  function optionalLine(label, value) {
@@ -470,11 +470,11 @@ export function buildCreatePreparationActionDefinition(context) {
470
470
  return {
471
471
  id: INTERF_SERVICE_ACTIONS.createPreparation.id,
472
472
  title: INTERF_SERVICE_ACTIONS.createPreparation.title,
473
- description: "Describe the agent job. Interf saves the Preparation through the local service and starts its first prepare run.",
473
+ description: "Describe the agent job. Interf saves the Preparation through the local service and starts its first compile run.",
474
474
  submitLabel: "Confirm",
475
475
  initialValues: {
476
476
  name,
477
- path: context.sourcePath,
477
+ path: context.prepDataDir,
478
478
  about: "",
479
479
  method: "interf-default",
480
480
  readiness_notes: "",
@@ -543,10 +543,10 @@ export function buildCreatePreparationActionDefinition(context) {
543
543
  ],
544
544
  };
545
545
  }
546
- export function buildPrepareRunActionDefinition(context) {
546
+ export function buildCompileRunActionDefinition(context) {
547
547
  return {
548
- id: INTERF_SERVICE_ACTIONS.runPreparation.id,
549
- title: INTERF_SERVICE_ACTIONS.runPreparation.title,
548
+ id: INTERF_SERVICE_ACTIONS.compileRun.id,
549
+ title: INTERF_SERVICE_ACTIONS.compileRun.title,
550
550
  description: "Build portable context for this Preparation. Interf will run the saved Method against the source folder and record a visible run.",
551
551
  submitLabel: "Run",
552
552
  initialValues: {
@@ -557,7 +557,7 @@ export function buildPrepareRunActionDefinition(context) {
557
557
  },
558
558
  schema: prepareRunSchema(),
559
559
  valuesPreview: (values) => ({
560
- action_type: INTERF_SERVICE_ACTIONS.runPreparation.serviceAction,
560
+ action_type: INTERF_SERVICE_ACTIONS.compileRun.serviceAction,
561
561
  preparation: inputValue(values, "preparation"),
562
562
  method: inputValue(values, "method"),
563
563
  source_folder_path: inputValue(values, "source_folder_path"),
@@ -566,13 +566,12 @@ export function buildPrepareRunActionDefinition(context) {
566
566
  buildDraft: (values) => ({
567
567
  preparation: inputValue(values, "preparation"),
568
568
  values: {
569
- action_type: INTERF_SERVICE_ACTIONS.runPreparation.serviceAction,
569
+ action_type: INTERF_SERVICE_ACTIONS.compileRun.serviceAction,
570
570
  preparation: inputValue(values, "preparation"),
571
571
  ...(maybeActionValue(inputValue(values, "method")) ? { method: inputValue(values, "method") } : {}),
572
572
  },
573
573
  message: [
574
- `Run Preparation ${inputValue(values, "preparation")}.`,
575
- maybeActionValue(inputValue(values, "method")) ? `Method: ${inputValue(values, "method")}` : null,
574
+ `Compile Method ${inputValue(values, "method") || "(saved selection)"} for Preparation ${inputValue(values, "preparation")}.`,
576
575
  maybeActionValue(inputValue(values, "about")) ? `Agent work: ${inputValue(values, "about")}` : null,
577
576
  "Build portable context from the saved Source Folder and selected Method.",
578
577
  "Use the attached typed action input as the source of truth.",
@@ -602,7 +601,7 @@ export function buildPrepareRunActionDefinition(context) {
602
601
  readOnly: true,
603
602
  advanced: true,
604
603
  help: "The work this Preparation is meant to support.",
605
- context: "Preserved as context for the prepare-run proposal.",
604
+ context: "Preserved as context for the compile-run proposal.",
606
605
  placeholder: "No saved job description.",
607
606
  },
608
607
  {
@@ -617,8 +616,8 @@ export function buildPrepareRunActionDefinition(context) {
617
616
  ],
618
617
  };
619
618
  }
620
- export function buildPrepareRunActionDraft(context) {
621
- const definition = buildPrepareRunActionDefinition(context);
619
+ export function buildCompileRunActionDraft(context) {
620
+ const definition = buildCompileRunActionDefinition(context);
622
621
  return definition.buildDraft(definition.initialValues);
623
622
  }
624
623
  export function buildSelectMethodActionDefinition(context) {
@@ -631,7 +630,7 @@ export function buildSelectMethodActionDefinition(context) {
631
630
  return {
632
631
  id: INTERF_SERVICE_ACTIONS.selectMethod.id,
633
632
  title: INTERF_SERVICE_ACTIONS.selectMethod.title,
634
- description: "Choose which Method this Preparation uses for future prepare runs. This saves the selection without running prepare.",
633
+ description: "Choose which Method this Preparation uses for future compile runs. This saves the selection without running prepare.",
635
634
  submitLabel: "Confirm",
636
635
  initialValues: {
637
636
  name: context.name,
@@ -662,7 +661,7 @@ export function buildSelectMethodActionDefinition(context) {
662
661
  name: "method",
663
662
  label: "Method",
664
663
  type: "select",
665
- help: "The Method future prepare runs should use.",
664
+ help: "The Method future compile runs should use.",
666
665
  context: "Saved on the existing Preparation.",
667
666
  options: methodChoiceOptions(context.methods),
668
667
  },
@@ -773,9 +772,9 @@ export function buildCreateMethodActionDefinition(context) {
773
772
  label: "Readiness guidance",
774
773
  type: "textarea",
775
774
  rows: 3,
776
- help: "What a Preparation using this Method should be able to prove.",
777
- context: "Guides Preparation-level readiness checks. Method acceptance criteria stay separate.",
778
- placeholder: "Describe the evidence that should make a Preparation ready.",
775
+ help: "What this Method output should be able to prove.",
776
+ context: "Guides readiness checks. Method acceptance criteria stay separate.",
777
+ placeholder: "Describe the evidence that should make this Method output ready.",
779
778
  },
780
779
  {
781
780
  name: "method_id",
@@ -1020,7 +1019,7 @@ export function buildPreparationChangeActionDefinition(context) {
1020
1019
  name: "method",
1021
1020
  label: "Method",
1022
1021
  type: "text",
1023
- help: "The Method future prepare runs should use.",
1022
+ help: "The Method future compile runs should use.",
1024
1023
  context: "Saved on this Preparation.",
1025
1024
  placeholder: "interf-default",
1026
1025
  },
@@ -2,6 +2,7 @@ import { existsSync, mkdirSync, readFileSync, } from "node:fs";
2
2
  import { join } from "node:path";
3
3
  import { methodIdForSourcePreparationConfig, } from "../methods/method-resolution.js";
4
4
  import { PACKAGE_ROOT } from "../method-package/lib/package-root.js";
5
+ import { asPreparationDataDir, preparationServiceActionPlansRoot, } from "../contracts/lib/preparation-paths.js";
5
6
  import { ActionProposalPlanSchema, } from "./lib/schema.js";
6
7
  function extractJsonObject(text) {
7
8
  try {
@@ -105,7 +106,7 @@ JSON schema:
105
106
  `;
106
107
  }
107
108
  export async function planActionProposalWithExecutor(options) {
108
- const planRoot = join(options.context.sourcePath, "interf", ".service", "action-plans", Date.now().toString(36));
109
+ const planRoot = join(preparationServiceActionPlansRoot(asPreparationDataDir(options.context.sourcePath)), Date.now().toString(36));
109
110
  mkdirSync(planRoot, { recursive: true });
110
111
  const outputPath = join(planRoot, "proposal.json");
111
112
  const prompt = buildActionPlannerPrompt(options.request, options.context, outputPath);