@interf/compiler 0.18.0 → 0.22.0

package/dist/packages/engine/lib/schema.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
-import { ArtifactRefSchema, CompileRunSchema, CompileRunStatusSchema, InterfRunEventSchema, ProofRecordSchema, RunObservabilitySchema, } from "../execution/lib/schema.js";
-import { SourcePreparationConfigSchema, SourceReadinessCheckSchema, } from "../../project/lib/schema.js";
-import { ArtifactSchema, ArtifactIdSchema, ArtifactPathShapeSchema, ArtifactStatusSchema, CheckSchema, LocatorSchema, PreparationNameSchema, ReadinessSchema, SourceCompiledMaxAttemptsSchema, SourceCompiledMaxLoopsSchema, MethodIdSchema, TestTargetTypeSchema, } from "../../contracts/lib/schema.js";
+import { ArtifactRefSchema, BuildRunStatusSchema, InterfRunEventSchema, ProofRecordSchema, RunObservabilitySchema, StageRunSchema, } from "../execution/lib/schema.js";
+import { RequestedArtifactSchema, SourcePreparationConfigSchema, SourceProfileSchema, SourceReadinessCheckSchema, } from "../../project/lib/schema.js";
+import { ArtifactSchema, ArtifactIdSchema, ArtifactPathShapeSchema, ArtifactStatusSchema, CheckSchema, LocatorSchema, PreparationNameSchema, ReadinessSchema, SourceBuildMaxAttemptsSchema, SourceBuildMaxLoopsSchema, BuildPlanIdSchema, TestTargetTypeSchema, } from "../../contracts/lib/schema.js";
 import { ReadinessCheckRunSchema, } from "../verify/lib/schema.js";
 const JsonObjectSchema = z.record(z.string(), z.unknown());
 // ───────────────────────────────────────────────────────────────────────────
@@ -51,34 +51,39 @@ export const PreparationCreateRequestSchema = z.object({
     id: PreparationNameSchema,
     source: SourceBindingSchema,
     /**
-     * Method binding. Optional — a preparation can be created with no
-     * method bound, then have one selected (or drafted) later before the
-     * first compile. Null/missing means "method not chosen yet".
+     * Selected Build Plan id. Optional — a Preparation
+     * can be created with requested Artifacts first, then have a Build Plan
+     * selected or drafted later before the first build.
      */
-    method_id: MethodIdSchema.nullable().optional(),
+    build_plan_id: BuildPlanIdSchema.nullable().optional(),
     about: z.string().min(1).optional(),
+    requested_artifacts: z.array(RequestedArtifactSchema).default([]),
+    source_profile: SourceProfileSchema.optional(),
     checks: z.array(SourceReadinessCheckSchema).default([]),
-    max_attempts: SourceCompiledMaxAttemptsSchema.optional(),
-    max_loops: SourceCompiledMaxLoopsSchema.optional(),
+    max_attempts: SourceBuildMaxAttemptsSchema.optional(),
+    max_loops: SourceBuildMaxLoopsSchema.optional(),
 }).strict();
 /** Body of `PATCH /v1/preparations/<id>` — update mutable preparation fields. */
 export const PreparationUpdateRequestSchema = z.object({
-    method_id: MethodIdSchema.nullable().optional(),
+    build_plan_id: BuildPlanIdSchema.nullable().optional(),
     about: z.string().nullable().optional(),
     /**
-     * Replace the full quality-check list. Use the empty array to clear
+     * Replace the full readiness-check list. Use the empty array to clear
      * every check. Each item is a `SourceReadinessCheck`
      * (`{ question, answer?, strictness?, expect? }`).
      */
     checks: z.array(SourceReadinessCheckSchema).optional(),
+    requested_artifacts: z.array(RequestedArtifactSchema).optional(),
+    source_profile: SourceProfileSchema.nullable().optional(),
 }).strict();
-/** Body of `POST /v1/methods` — install a Method package by path. */
-export const MethodInstallRequestSchema = z.object({
+/** Body of `POST /v1/build-plans` — save a Build Plan definition by path. */
+export const BuildPlanSaveRequestSchema = z.object({
     source_path: z.string().min(1),
+    id: BuildPlanIdSchema.optional(),
     overwrite: z.boolean().default(false),
 }).strict();
-export const MethodInstallResultSchema = z.object({
-    method_id: MethodIdSchema,
+export const BuildPlanSaveResultSchema = z.object({
+    build_plan_id: BuildPlanIdSchema,
     installed: z.boolean(),
     path: z.string().min(1),
 }).strict();
@@ -89,11 +94,13 @@ export const PreparationDeleteResponseSchema = z.object({
 export const PreparationWireShapeSchema = z.object({
     id: PreparationNameSchema,
     source: SourceBindingSchema,
-    method_id: MethodIdSchema.nullable(),
+    build_plan_id: BuildPlanIdSchema.nullable(),
     about: z.string().min(1).nullable(),
     config_path: z.string().min(1),
-    portable_context: ArtifactLocatorSchema,
+    verifiable_context: ArtifactLocatorSchema,
     checks: z.array(SourceReadinessCheckSchema).default([]),
+    requested_artifacts: z.array(RequestedArtifactSchema).default([]),
+    source_profile: SourceProfileSchema.nullable().optional(),
 }).strict();
 /**
  * The local service must only ever bind to a loopback interface. Any other
@@ -122,12 +129,12 @@ export const LocalServiceConfigSchema = z.object({
     host: LocalServiceHostSchema.default("127.0.0.1"),
     port: LocalServicePortSchema.default(4873),
 }).strict();
-export const ServiceRegistryWorkspaceSchema = z.object({
-    control_path: z.string().min(1),
-    registered_at: z.string().min(1),
-    last_activity: z.string().min(1),
-}).strict();
-export const ServiceRegistryEntrySchema = z.object({
+export const ServiceRegistryEntrySchema = z.preprocess((value) => {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return value;
+    const { old_state_roots: _oldStateRoots, ...entry } = value;
+    return entry;
+}, z.object({
     pid: z.number().int().positive(),
     host: LocalServiceHostSchema,
     port: LocalServicePortSchema,
@@ -140,8 +147,7 @@ export const ServiceRegistryEntrySchema = z.object({
      * fresh entries always have one.
      */
     auth_token: LocalServiceAuthTokenSchema.optional(),
-    workspaces: z.array(ServiceRegistryWorkspaceSchema).default([]),
-}).strict();
+}).strict());
 export const ServiceRegistrySchema = z.object({
     services: z.array(ServiceRegistryEntrySchema).default([]),
 }).strict();
@@ -157,7 +163,6 @@ export const LocalServiceHealthSchema = z.object({
     started_at: z.string().min(1).optional(),
     package_version: z.string().min(1).optional(),
     instance_started_at: z.string().min(1).optional(),
-    registered_workspaces: z.array(ServiceRegistryWorkspaceSchema).default([]),
     active_runs: z.number().int().min(0).default(0),
     idle_for_seconds: z.number().int().min(0).default(0),
 }).strict();
@@ -167,29 +172,16 @@ export const LocalServiceErrorSchema = z.object({
         code: z.string().min(1).optional(),
     }).strict(),
 }).strict();
-export const LocalServicePointerSchema = z.object({
-    service_url: z.string().min(1),
-    host: LocalServiceHostSchema,
-    port: LocalServicePortSchema,
-    pid: z.number().int().positive(),
-    control_path: z.string().min(1),
-    started_at: z.string().min(1),
-    /**
-     * Per-workspace copy of the bearer token. Optional so legacy pointer
-     * files keep parsing during upgrades; new pointers always include it.
-     */
-    auth_token: LocalServiceAuthTokenSchema.optional(),
-}).strict();
-export const PortableContextMappingSchema = z.object({
+export const VerifiableContextMappingSchema = z.object({
     preparation: PreparationNameSchema,
     path: z.string().min(1).nullable(),
     exists: z.boolean(),
-    method_id: MethodIdSchema.nullable(),
-    latest_compile_run_id: z.string().min(1).nullable(),
+    build_plan_id: BuildPlanIdSchema.nullable(),
+    latest_build_run_id: z.string().min(1).nullable(),
     latest_test_run_id: z.string().min(1).nullable(),
 }).strict();
 export const PreparationRunLinkageSchema = z.object({
-    latest_compile_run_id: z.string().min(1).nullable(),
+    latest_build_run_id: z.string().min(1).nullable(),
     latest_test_run_id: z.string().min(1).nullable(),
 }).strict();
 export const PreparationResourceSchema = z.object({
@@ -197,26 +189,39 @@ export const PreparationResourceSchema = z.object({
     name: PreparationNameSchema,
     preparation: SourcePreparationConfigSchema,
     source_path: z.string().min(1),
-    method_id: MethodIdSchema.nullable(),
+    build_plan_id: BuildPlanIdSchema.nullable(),
     checks: z.array(SourceReadinessCheckSchema).default([]),
-    portable_context: PortableContextMappingSchema,
-    portable_context_path: z.string().min(1).nullable(),
+    requested_artifacts: z.array(RequestedArtifactSchema).default([]),
+    source_profile: SourceProfileSchema.nullable().optional(),
+    verifiable_context: VerifiableContextMappingSchema,
+    verifiable_context_path: z.string().min(1).nullable(),
     readiness: ReadinessSchema,
     runs: PreparationRunLinkageSchema,
-    latest_compile_run_id: z.string().min(1).nullable().optional(),
+    latest_build_run_id: z.string().min(1).nullable().optional(),
     latest_test_run_id: z.string().min(1).nullable().optional(),
-    // 0.17 — per-Artifact status from the latest compile run, mirrored
+    // Per-Artifact status from the latest Build run, mirrored
     // here so the UI/CLI can render artifact rows without a separate
-    // GET /v1/preparations/<id>/runs fetch. Empty when the Method
-    // no compile run has produced artifacts yet.
+    // GET /v1/preparations/<id>/runs fetch. Empty when no Build run has
+    // produced artifacts yet.
     artifacts: z.array(ArtifactStatusSchema).default([]),
 }).strict();
-export const MethodResourceSchema = z.object({
-    id: MethodIdSchema,
-    method_id: MethodIdSchema,
+export const BuildPlanResourceSchema = z.object({
+    id: BuildPlanIdSchema,
+    build_plan_id: BuildPlanIdSchema,
     path: z.string().min(1),
     label: z.string().min(1).optional(),
     hint: z.string().min(1).optional(),
+    purpose: z.object({
+        label: z.string().min(1),
+        task_hint: z.string().min(1),
+    }).strict().optional(),
+    inputs: z.array(z.object({
+        id: ArtifactIdSchema,
+        label: z.string().min(1),
+        description: z.string().min(1),
+        required: z.boolean().default(false),
+        examples: z.array(z.string().min(1)).optional(),
+    }).strict()).default([]),
     source_kind: z.enum(["builtin", "local"]).default("local"),
     built_in: z.boolean().default(false),
     active_for_preparations: z.array(PreparationNameSchema).default([]),
@@ -228,40 +233,59 @@ export const MethodResourceSchema = z.object({
         contract_type: z.string().min(1),
         skill_dir: z.string().min(1),
         /**
-         * 0.15 — role hint Methods declare per stage. Defaults to
+         * Role hint Build Plans declare per stage. Defaults to
          * `general` at the runtime layer; the wire shape mirrors that
-         * default so older /v1/methods clients always see a string.
+         * default so clients always see a string.
          */
         role: z.string().min(1).default("general"),
         reads: z.array(z.string().min(1)).default([]),
         writes: z.array(z.string().min(1)).default([]),
     }).strict()).default([]),
 }).strict();
-export const CompileRunCreateRequestSchema = z.object({
+export const BuildRunCreateRequestSchema = z.object({
     preparation: PreparationNameSchema,
-    method: MethodIdSchema.optional(),
-    max_attempts: SourceCompiledMaxAttemptsSchema.optional(),
-    max_loops: SourceCompiledMaxLoopsSchema.optional(),
+    build_plan: BuildPlanIdSchema.optional(),
+    max_attempts: SourceBuildMaxAttemptsSchema.optional(),
+    max_loops: SourceBuildMaxLoopsSchema.optional(),
     preserve_stage_shells: z.enum(["on-failure", "always"]).optional(),
 }).strict();
-export const CompileRunSummarySchema = z.object({
+export const BuildRunSummarySchema = z.object({
     run_id: z.string().min(1),
-    status: CompileRunStatusSchema,
+    status: BuildRunStatusSchema,
     preparation: PreparationNameSchema,
-    method: MethodIdSchema,
-    portable_context_path: z.string().min(1),
+    build_plan: BuildPlanIdSchema,
+    verifiable_context_path: z.string().min(1),
     started_at: z.string().nullable().optional(),
     finished_at: z.string().nullable().optional(),
     latest_event: InterfRunEventSchema.nullable().optional(),
     latest_proof: ProofRecordSchema.nullable().optional(),
 }).strict();
-export const CompileRunResourceSchema = z.object({
-    run: CompileRunSchema,
+export const BuildRunSchema = z.object({
+    kind: z.literal("interf-build-run"),
+    version: z.literal(1),
+    run_id: z.string().min(1),
+    status: BuildRunStatusSchema,
+    preparation: PreparationNameSchema,
+    build_plan: BuildPlanIdSchema,
+    backend: z.string().min(1),
+    source_path: z.string().min(1),
+    verifiable_context_path: z.string().min(1),
+    created_at: z.string().min(1),
+    started_at: z.string().nullable().optional(),
+    finished_at: z.string().nullable().optional(),
+    stages: z.array(StageRunSchema).default([]),
+    events: z.array(InterfRunEventSchema).default([]),
+    latest_proof: ProofRecordSchema.nullable().optional(),
+    readiness: ReadinessSchema.nullable().optional(),
+    artifacts: z.array(ArtifactStatusSchema).default([]),
+}).strict();
+export const BuildRunResourceSchema = z.object({
+    run: BuildRunSchema,
 }).strict();
 export const LocalJobTypeSchema = z.enum([
     "readiness-check-draft",
-    "method-authoring",
-    "method-improvement",
+    "build-plan-draft",
+    "build-plan-improvement",
 ]);
 export const RunStatusSchema = z.enum([
     "queued",
@@ -319,7 +343,7 @@ export const LocalJobRunCreateRequestSchema = z.object({
     job_type: LocalJobTypeSchema,
     title: z.string().min(1),
     preparation: PreparationNameSchema.nullable().optional(),
-    method: MethodIdSchema.nullable().optional(),
+    build_plan: BuildPlanIdSchema.nullable().optional(),
     source_path: z.string().min(1).nullable().optional(),
     output_path: z.string().min(1).nullable().optional(),
     agent: LocalJobAgentSchema.nullable().optional(),
@@ -331,47 +355,47 @@ export const LocalJobRunCreateRequestSchema = z.object({
 }).strict();
 export const PreparationSetupCreateRequestSchema = z.object({
     preparation: SourcePreparationConfigSchema,
-    prepare_after_setup: z.boolean().default(false),
-    setup_mode: z.enum(["create", "select-method"]).default("create"),
+    build_after_setup: z.boolean().default(false),
+    setup_mode: z.enum(["create", "select-build-plan"]).default("create"),
 }).strict();
 export const PreparationSetupResultSchema = z.object({
     kind: z.literal("interf-preparation-setup-result"),
     version: z.literal(1),
-    operation: z.enum(["create", "select-method"]),
+    operation: z.enum(["create", "select-build-plan"]),
     preparation: PreparationNameSchema,
-    method: MethodIdSchema,
+    build_plan: BuildPlanIdSchema.nullable(),
     source_folder_path: z.string().min(1),
     config_path: z.string().min(1),
-    portable_context_path: z.string().min(1),
+    verifiable_context_path: z.string().min(1),
     changed: z.boolean(),
     message: z.string().min(1),
     submitted_run_id: z.string().min(1).nullable().optional(),
-    submitted_run_type: z.literal("compile-run").nullable().optional(),
+    submitted_run_type: z.literal("build-run").nullable().optional(),
 }).strict();
-export const MethodChangeCreateRequestSchema = z.discriminatedUnion("operation", [
+export const BuildPlanChangeCreateRequestSchema = z.discriminatedUnion("operation", [
     z.object({
-        action_type: z.literal("method-change").optional(),
+        action_type: z.literal("build-plan-change").optional(),
         operation: z.literal("duplicate"),
-        method: MethodIdSchema,
-        new_method_id: MethodIdSchema,
+        build_plan: BuildPlanIdSchema,
+        new_build_plan_id: BuildPlanIdSchema,
         label: z.string().min(1).optional(),
         hint: z.string().min(1).optional(),
     }).strict(),
     z.object({
-        action_type: z.literal("method-change").optional(),
+        action_type: z.literal("build-plan-change").optional(),
         operation: z.literal("remove"),
-        method: MethodIdSchema,
-        confirmation: MethodIdSchema,
+        build_plan: BuildPlanIdSchema,
+        confirmation: BuildPlanIdSchema,
     }).strict(),
 ]);
-export const MethodChangeResultSchema = z.object({
-    kind: z.literal("interf-method-change-result"),
+export const BuildPlanChangeResultSchema = z.object({
+    kind: z.literal("interf-build-plan-change-result"),
     version: z.literal(1),
     operation: z.enum(["duplicate", "remove"]),
-    method: MethodIdSchema,
-    new_method_id: MethodIdSchema.nullable().optional(),
+    build_plan: BuildPlanIdSchema,
+    new_build_plan_id: BuildPlanIdSchema.nullable().optional(),
     updated_preparations: z.array(PreparationNameSchema).default([]),
-    method_path: z.string().min(1),
+    build_plan_path: z.string().min(1),
     changed: z.boolean(),
     message: z.string().min(1),
 }).strict();
@@ -389,21 +413,21 @@ export const PreparationChangeResultSchema = z.object({
     operation: z.literal("remove"),
     preparation: PreparationNameSchema,
     config_path: z.string().min(1),
-    portable_context_path: z.string().min(1),
-    portable_context_retained: z.boolean(),
+    verifiable_context_path: z.string().min(1),
+    verifiable_context_retained: z.boolean(),
     changed: z.boolean(),
     message: z.string().min(1),
 }).strict();
 export const ResetRequestSchema = z.object({
     preparation: PreparationNameSchema,
-    scope: z.enum(["compile", "all"]),
+    scope: z.enum(["build", "all"]),
 }).strict();
 export const ResetResultSchema = z.object({
     kind: z.literal("interf-reset-result"),
     version: z.literal(1),
     preparation: PreparationNameSchema,
-    scope: z.enum(["compile", "all"]),
-    portable_context_path: z.string().min(1),
+    scope: z.enum(["build", "all"]),
+    verifiable_context_path: z.string().min(1),
     changed: z.boolean(),
     message: z.string().min(1),
 }).strict();
@@ -416,30 +440,32 @@ export const ReadinessCheckDraftCreateRequestSchema = z.object({
 export const ReadinessCheckDraftResultSchema = z.object({
     checks: z.array(SourceReadinessCheckSchema).default([]),
 }).strict();
-export const MethodAuthoringArtifactRequirementSchema = z.object({
+export const BuildPlanAuthoringArtifactRequirementSchema = z.object({
     id: ArtifactIdSchema,
     description: z.string().min(1).optional(),
     shape: ArtifactPathShapeSchema,
     checks: z.array(CheckSchema).default([]),
     stage_hint: z.string().min(1).optional(),
 }).strict();
-export const MethodAuthoringCreateRequestSchema = z.object({
+export const BuildPlanAuthoringCreateRequestSchema = z.object({
     preparation: PreparationNameSchema.nullable().optional(),
     source_folder_path: z.string().min(1),
-    base_method_id: MethodIdSchema.optional(),
-    reference_method_id: MethodIdSchema.optional(),
-    method_id: MethodIdSchema,
+    base_build_plan_id: BuildPlanIdSchema.optional(),
+    reference_build_plan_id: BuildPlanIdSchema.optional(),
+    build_plan_id: BuildPlanIdSchema,
     label: z.string().min(1),
     hint: z.string().min(1),
     task_prompt: z.string().min(1),
     checks: z.array(SourceReadinessCheckSchema).default([]),
-    artifact_requirements: z.array(MethodAuthoringArtifactRequirementSchema).default([]),
+    requested_artifacts: z.array(RequestedArtifactSchema).default([]),
+    source_profile: SourceProfileSchema.nullable().optional(),
+    artifact_requirements: z.array(BuildPlanAuthoringArtifactRequirementSchema).default([]),
 }).strict();
-export const MethodAuthoringResultSchema = z.object({
+export const BuildPlanAuthoringResultSchema = z.object({
     status: z.enum(["updated", "no-change", "invalid", "executor-failed"]),
     changed: z.boolean(),
     summary: z.string().min(1),
-    method_path: z.string().min(1),
+    build_plan_path: z.string().min(1),
     shell_path: z.string().min(1),
     validation: z.unknown().nullable().optional(),
 }).strict();
@@ -459,7 +485,7 @@ export const LocalJobRunResourceSchema = z.object({
     status: LocalJobStatusSchema,
     title: z.string().min(1),
     preparation: PreparationNameSchema.nullable().optional(),
-    method: MethodIdSchema.nullable().optional(),
+    build_plan: BuildPlanIdSchema.nullable().optional(),
     source_path: z.string().min(1).nullable().optional(),
     output_path: z.string().min(1).nullable().optional(),
     agent: LocalJobAgentSchema.nullable().optional(),
@@ -473,26 +499,18 @@ export const LocalJobRunResourceSchema = z.object({
 }).strict();
 export const VerifyRunStatusSchema = RunStatusSchema;
 /**
- * 0.17 — verify runs choose their judge target. `compiled` (default)
- * judges against the latest portable-context output; `source-files`
- * judges against the raw source folder for a baseline that reveals
- * how much value the Method actually adds. The 0.15 cleanup made
- * verify compiled-only on the wire because the source-files branch
- * had been retired in 0.13.1; 0.17 restores it because the QA tab and
- * `verify/README.md` have always claimed the option exists, and the
- * sandbox + spec builders for source-files have remained in tree
- * since 0.13.
+ * Verify runs choose their judge target.
  */
 export const VerifyRunCreateRequestSchema = z.object({
     preparation: PreparationNameSchema,
-    target: TestTargetTypeSchema.default("compiled"),
+    target: TestTargetTypeSchema.default("verifiable-context"),
 }).strict();
 export const VerifyRunResourceSchema = z.object({
     run_id: z.string().min(1),
     status: VerifyRunStatusSchema,
     preparation: PreparationNameSchema,
     source_path: z.string().min(1),
-    portable_context_path: z.string().min(1).nullable(),
+    verifiable_context_path: z.string().min(1).nullable(),
     started_at: z.string().nullable().optional(),
     finished_at: z.string().nullable().optional(),
     readiness_run: ReadinessCheckRunSchema.nullable(),
@@ -516,9 +534,9 @@ export const LocalExecutorSelectRequestSchema = z.object({
 export const ActionProposalTypeSchema = z.enum([
     "clarification",
     "readiness-check-draft",
-    "method-authoring",
-    "method-improvement",
-    "compile",
+    "build-plan-draft",
+    "build-plan-improvement",
+    "build",
     "test",
 ]);
 export const ActionProposalPlanActionTypeSchema = z.enum([
@@ -526,10 +544,10 @@ export const ActionProposalPlanActionTypeSchema = z.enum([
     "preparation-setup",
     "preparation-change",
     "readiness-check-draft",
-    "method-authoring",
-    "method-change",
-    "method-improvement",
-    "compile",
+    "build-plan-draft",
+    "build-plan-change",
+    "build-plan-improvement",
+    "build",
     "test",
 ]);
 export const ActionProposalStatusSchema = z.enum([
@@ -557,7 +575,7 @@ export const ActionProposalCreateRequestSchema = z.object({
 export const ActionProposalPlanSchema = z.object({
     action_type: ActionProposalPlanActionTypeSchema,
     preparation: PreparationNameSchema.optional(),
-    method: MethodIdSchema.optional(),
+    build_plan: BuildPlanIdSchema.optional(),
     values: JsonObjectSchema.optional(),
     title: z.string().min(1).optional(),
     summary: z.string().min(1).optional(),
@@ -584,14 +602,14 @@ const ActionProposalResourceBaseSchema = z.object({
     command_preview: z.string().min(1).optional(),
     message: z.string().min(1),
     preparation: PreparationNameSchema.nullable().optional(),
-    method: MethodIdSchema.nullable().optional(),
+    build_plan: BuildPlanIdSchema.nullable().optional(),
     client_origin: ActionClientOriginSchema.default("unknown"),
     created_at: z.string().min(1),
     updated_at: z.string().min(1),
     proposed_by_executor: LocalJobAgentSchema.nullable().optional(),
     approval: ActionProposalApprovalSchema.nullable().optional(),
     submitted_run_id: z.string().min(1).nullable().optional(),
-    submitted_run_type: z.enum(["compile-run", "verify-run", "job-run"]).nullable().optional(),
+    submitted_run_type: z.enum(["build-run", "verify-run", "job-run"]).nullable().optional(),
     error: z.string().min(1).nullable().optional(),
 }).strict();
 export const ActionProposalResourceSchema = z.discriminatedUnion("action_type", [
@@ -600,8 +618,8 @@ export const ActionProposalResourceSchema = z.discriminatedUnion("action_type",
         request: JsonObjectSchema,
     }).strict(),
     ActionProposalResourceBaseSchema.extend({
-        action_type: z.literal("compile"),
-        request: CompileRunCreateRequestSchema,
+        action_type: z.literal("build"),
+        request: BuildRunCreateRequestSchema,
     }).strict(),
     ActionProposalResourceBaseSchema.extend({
         action_type: z.literal("test"),
@@ -612,21 +630,21 @@ export const ActionProposalResourceSchema = z.discriminatedUnion("action_type",
         request: ReadinessCheckDraftCreateRequestSchema,
     }).strict(),
     ActionProposalResourceBaseSchema.extend({
-        action_type: z.literal("method-authoring"),
-        request: MethodAuthoringCreateRequestSchema,
+        action_type: z.literal("build-plan-draft"),
+        request: BuildPlanAuthoringCreateRequestSchema,
     }).strict(),
     ActionProposalResourceBaseSchema.extend({
-        action_type: z.literal("method-improvement"),
-        request: MethodAuthoringCreateRequestSchema,
+        action_type: z.literal("build-plan-improvement"),
+        request: BuildPlanAuthoringCreateRequestSchema,
     }).strict(),
 ]);
-export const PortableContextResourceSchema = z.object({
+export const VerifiableContextResourceSchema = z.object({
     preparation: PreparationNameSchema,
     path: z.string().min(1),
     exists: z.boolean(),
     readiness: ReadinessSchema,
-    method: MethodIdSchema.nullable().optional(),
-    latest_compile_run_id: z.string().min(1).nullable().optional(),
+    build_plan: BuildPlanIdSchema.nullable().optional(),
+    latest_build_run_id: z.string().min(1).nullable().optional(),
     latest_test_run_id: z.string().min(1).nullable().optional(),
     artifacts: z.array(ArtifactRefSchema).default([]),
 }).strict();
@@ -639,41 +657,37 @@ export const SourceFileResourceSchema = z.object({
     modified_at: z.string().min(1).nullable(),
     source_folder_path: z.string().min(1),
 }).strict();
-export const WorkspaceFileResourceSchema = z.object({
-    path: z.string().min(1),
-    absolute_path: z.string().min(1),
-    size_bytes: z.number().int().min(0),
-    modified_at: z.string().min(1).nullable(),
-}).strict();
 export const LocalServiceDiscoverySchema = z.object({
     kind: z.literal("interf-local-service-discovery"),
     version: z.literal(1),
     resources: z.object({
+        instance: z.string().min(1),
         preparations: z.string().min(1),
-        methods: z.string().min(1),
+        build_plans: z.string().min(1),
+        build_runs: z.string().min(1),
         runs: z.string().min(1),
-        readiness: z.string().min(1),
-        portable_contexts: z.string().min(1),
-        source_files: z.string().min(1),
-        workspace_files: z.string().min(1),
         action_proposals: z.string().min(1),
-        preparation_setups: z.string().min(1),
-        preparation_changes: z.string().min(1),
-        method_changes: z.string().min(1),
-        workspace_bootstraps: z.string().min(1).optional(),
-        readiness_check_drafts: z.string().min(1),
-        method_authoring_runs: z.string().min(1),
-        method_improvement_runs: z.string().min(1),
-        compile_runs: z.string().min(1),
-        verify_runs: z.string().min(1),
-        reset: z.string().min(1),
         executor: z.string().min(1),
+        open_path: z.string().min(1),
         /**
          * 0.15 — connected agents primitive. Optional during the 0.14 →
          * 0.15 rollout so older clients don't fail discovery validation.
          */
         agents: z.string().min(1).optional(),
-        workspaces: z.string().min(1).optional(),
+        /**
+         * Optional resource paths for scoped helper resources.
+         */
+        readiness: z.string().min(1).optional(),
+        verifiable_contexts: z.string().min(1).optional(),
+        source_files: z.string().min(1).optional(),
+        preparation_setups: z.string().min(1).optional(),
+        preparation_changes: z.string().min(1).optional(),
+        build_plan_changes: z.string().min(1).optional(),
+        readiness_check_drafts: z.string().min(1).optional(),
+        build_plan_draft_runs: z.string().min(1).optional(),
+        build_plan_improvement_runs: z.string().min(1).optional(),
+        verify_runs: z.string().min(1).optional(),
+        reset: z.string().min(1).optional(),
         status: z.string().min(1).optional(),
     }).strict(),
 }).strict();
@@ -687,11 +701,11 @@ export const OpenPathResponseSchema = z.object({
 export const PreparationListResponseSchema = z.object({
     preparations: z.array(PreparationWireShapeSchema),
 }).strict();
-export const MethodListResponseSchema = z.object({
-    methods: z.array(MethodResourceSchema),
+export const BuildPlanListResponseSchema = z.object({
+    build_plans: z.array(BuildPlanResourceSchema),
 }).strict();
-export const CompileRunListResponseSchema = z.object({
-    compile_runs: z.array(CompileRunResourceSchema),
+export const BuildRunListResponseSchema = z.object({
+    build_runs: z.array(BuildRunResourceSchema),
 }).strict();
 export const LocalJobRunListResponseSchema = z.object({
     jobs: z.array(LocalJobRunResourceSchema),
@@ -705,8 +719,8 @@ export const RunObservabilityListResponseSchema = z.object({
 export const ActionProposalListResponseSchema = z.object({
     action_proposals: z.array(ActionProposalResourceSchema),
 }).strict();
-export const PortableContextListResponseSchema = z.object({
-    portable_contexts: z.array(PortableContextResourceSchema),
+export const VerifiableContextListResponseSchema = z.object({
+    verifiable_contexts: z.array(VerifiableContextResourceSchema),
 }).strict();
 export const ReadinessListResponseSchema = z.object({
     readiness: z.array(ReadinessResourceSchema),
@@ -714,6 +728,3 @@ export const ReadinessListResponseSchema = z.object({
 export const SourceFileListResponseSchema = z.object({
     source_files: z.array(SourceFileResourceSchema),
 }).strict();
-export const WorkspaceFileListResponseSchema = z.object({
-    workspace_files: z.array(WorkspaceFileResourceSchema),
-}).strict();