@interf/compiler 0.21.0 → 0.22.0

package/dist/packages/engine/action-definitions.js

@@ -14,24 +14,24 @@ export const PreparationSetupActionValuesSchema = z.object({
     name: ActionValueIdSchema,
     path: z.string().trim().min(1, "Source Folder is required."),
     about: z.string().trim().min(1, "Agent work is required."),
-    method: OptionalActionValueIdSchema.optional(),
+    build_plan: OptionalActionValueIdSchema.optional(),
     checks: z.array(SourceReadinessCheckActionValueSchema).optional(),
     requested_artifacts: z.array(RequestedArtifactActionValueSchema).optional(),
     source_profile: SourceProfileActionValueSchema.optional(),
     max_attempts: z.number().int().min(1).max(5).optional(),
     max_loops: z.number().int().min(1).max(3).optional(),
     readiness_notes: z.string().trim().optional(),
-    prepare_after_setup: z.boolean().optional(),
-    setup_mode: z.enum(["create", "select-method"]).optional(),
+    build_after_setup: z.boolean().optional(),
+    setup_mode: z.enum(["create", "select-build-plan"]).optional(),
 }).strict();
-export const MethodAuthoringActionValuesSchema = z.object({
-    method_id: ActionValueIdSchema.optional(),
-    base_method_id: ActionValueIdSchema.optional(),
-    reference_method_id: ActionValueIdSchema.optional(),
+export const BuildPlanAuthoringActionValuesSchema = z.object({
+    build_plan_id: ActionValueIdSchema.optional(),
+    base_build_plan_id: ActionValueIdSchema.optional(),
+    reference_build_plan_id: ActionValueIdSchema.optional(),
     label: z.string().trim().optional(),
     hint: z.string().trim().optional(),
     task_prompt: z.string().trim().min(1, "Agent work is required."),
-    portable_output: z.string().trim().optional(),
+    requested_artifacts_description: z.string().trim().optional(),
     requested_artifacts: z.array(RequestedArtifactActionValueSchema).optional(),
     source_profile: SourceProfileActionValueSchema.nullable().optional(),
     readiness_notes: z.string().trim().optional(),
@@ -43,27 +43,27 @@ export const INTERF_SERVICE_ACTIONS = {
         title: "Create Preparation",
         description: "Save a Source, requested Artifacts, Build Plan, and run history under one Preparation.",
     },
-    compileRun: {
-        id: "compile-run",
-        serviceAction: "compile",
-        title: "Compile Artifacts",
-        description: "Run the saved Build Plan against this Source and write portable context.",
+    buildRun: {
+        id: "build-run",
+        serviceAction: "build",
+        title: "Build Artifacts",
+        description: "Run the saved Build Plan against this Source and write verifiable context.",
     },
-    selectMethod: {
-        id: "select-method",
+    selectBuildPlan: {
+        id: "select-build-plan",
         serviceAction: "preparation-setup",
         title: "Select Build Plan",
-        description: "Choose the Build Plan that will compile this Preparation's requested Artifacts.",
+        description: "Choose the Build Plan that will build this Preparation's requested Artifacts.",
     },
-    createMethod: {
-        id: "create-method",
-        serviceAction: "method-authoring",
+    createBuildPlan: {
+        id: "build-plan-draft",
+        serviceAction: "build-plan-draft",
         title: "Draft Build Plan",
-        description: "Draft a Build Plan for the Artifacts this Preparation should compile.",
+        description: "Draft a Build Plan for the Artifacts this Preparation should build.",
     },
-    methodChange: {
-        id: "method-change",
-        serviceAction: "method-change",
+    buildPlanChange: {
+        id: "build-plan-change",
+        serviceAction: "build-plan-change",
         title: "Build Plan Change",
         description: "Modify, duplicate, or remove an existing Build Plan.",
     },
@@ -93,7 +93,7 @@ export const INTERF_SERVICE_ACTIONS = {
     },
     improvePreparation: {
         id: "improve-preparation",
-        serviceAction: "method-improvement",
+        serviceAction: "build-plan-improvement",
         title: "Improve Build Plan",
         description: "Use readiness evidence to refine the Build Plan this Preparation uses.",
     },
@@ -102,14 +102,14 @@ function optionalLine(label, value) {
     const trimmed = value?.trim();
     return trimmed ? `${label}: ${trimmed}` : null;
 }
-export function methodAuthoringTaskPrompt(values) {
+export function buildPlanAuthoringTaskPrompt(values) {
     const requestedArtifacts = values.requested_artifacts?.length
         ? formatRequestedArtifactsForPrompt(values.requested_artifacts)
         : null;
     return [
         `Agent work: ${values.task_prompt}`,
         requestedArtifacts ? `Requested Artifacts:\n${requestedArtifacts}` : null,
-        optionalLine("Requested Artifacts", values.portable_output),
+        optionalLine("Requested Artifacts", values.requested_artifacts_description),
         optionalLine("Readiness checks", values.readiness_notes),
     ].filter((line) => Boolean(line)).join("\n");
 }
@@ -163,27 +163,27 @@ export function maybeActionValue(value) {
 function inputValue(values, key) {
     return values[key] ?? "";
 }
-export function methodChoiceOptions(methods) {
+export function buildPlanChoiceOptions(buildPlans) {
     const seen = new Set();
     const options = [];
-    for (const method of [{ id: "interf-default", label: "interf-default" }, ...methods]) {
-        if (seen.has(method.id))
+    for (const buildPlan of [{ id: "interf-default", label: "interf-default" }, ...buildPlans]) {
+        if (seen.has(buildPlan.id))
             continue;
-        seen.add(method.id);
-        options.push({ label: method.label ?? method.id, value: method.id });
+        seen.add(buildPlan.id);
+        options.push({ label: buildPlan.label ?? buildPlan.id, value: buildPlan.id });
     }
     return options;
 }
-export function methodTaskPromptFromInput(values) {
-    const parsed = MethodAuthoringActionValuesSchema.safeParse(values);
+export function buildPlanTaskPromptFromInput(values) {
+    const parsed = BuildPlanAuthoringActionValuesSchema.safeParse(values);
     if (parsed.success)
-        return methodAuthoringTaskPrompt(parsed.data);
+        return buildPlanAuthoringTaskPrompt(parsed.data);
     const taskPrompt = inputValue(values, "task_prompt");
-    const portableOutput = inputValue(values, "portable_output");
+    const requestedArtifactsDescription = inputValue(values, "requested_artifacts_description");
     const readinessNotes = inputValue(values, "readiness_notes");
     return [
         `Agent work: ${taskPrompt}`,
-        maybeActionValue(portableOutput) ? `Requested Artifacts: ${portableOutput}` : null,
+        maybeActionValue(requestedArtifactsDescription) ? `Requested Artifacts: ${requestedArtifactsDescription}` : null,
         maybeActionValue(readinessNotes) ? `Readiness checks: ${readinessNotes}` : null,
     ].filter((line) => Boolean(line)).join("\n");
 }
@@ -192,7 +192,7 @@ function createPreparationSchema(existingNames) {
         name: actionIdField("Preparation name"),
         path: requiredActionText("Source Folder"),
         about: requiredActionText("Agent work"),
-        method: optionalActionIdField("Build Plan"),
+        build_plan: optionalActionIdField("Build Plan"),
         readiness_notes: optionalActionText,
     }).strict().superRefine((values, ctx) => {
         if (existingNames.has(values.name)) {
@@ -207,43 +207,43 @@ function createPreparationSchema(existingNames) {
 function prepareRunSchema() {
     return z.object({
         preparation: actionIdField("Preparation"),
-        method: optionalActionIdField("Build Plan"),
+        build_plan: optionalActionIdField("Build Plan"),
         about: optionalActionText,
         source_folder_path: optionalActionText,
     }).strict();
 }
-function selectMethodSchema() {
+function selectBuildPlanSchema() {
     return z.object({
         name: actionIdField("Preparation"),
         path: requiredActionText("Source Folder"),
         about: requiredActionText("Agent work"),
-        current_method: optionalActionIdField("Current Build Plan"),
-        method: actionIdField("Build Plan"),
+        current_build_plan: optionalActionIdField("Current Build Plan"),
+        build_plan: actionIdField("Build Plan"),
     }).strict();
 }
-function methodAuthoringSchema(existingMethodIds) {
+function buildPlanAuthoringSchema(existingBuildPlanIds) {
     return z.object({
-        method_id: optionalActionIdField("Build Plan id"),
+        build_plan_id: optionalActionIdField("Build Plan id"),
         label: optionalActionText,
         hint: optionalActionText,
         task_prompt: requiredActionText("Agent work"),
-        portable_output: optionalActionText,
+        requested_artifacts_description: optionalActionText,
         readiness_notes: optionalActionText,
     }).strict().superRefine((values, ctx) => {
-        const explicitMethodId = maybeActionValue(values.method_id ?? "");
-        if (explicitMethodId && existingMethodIds.has(explicitMethodId)) {
+        const explicitBuildPlanId = maybeActionValue(values.build_plan_id ?? "");
+        if (explicitBuildPlanId && existingBuildPlanIds.has(explicitBuildPlanId)) {
             ctx.addIssue({
                 code: z.ZodIssueCode.custom,
-                path: ["method_id"],
+                path: ["build_plan_id"],
                 message: "A Build Plan with this id already exists.",
             });
         }
     });
 }
-function methodChangeSchema(action, methodId, existingMethodIds) {
+function buildPlanChangeSchema(action, buildPlanId, existingBuildPlanIds) {
     const base = {
         action: requiredActionText("Action"),
-        method: actionIdField("Build Plan"),
+        build_plan: actionIdField("Build Plan"),
         preparation: optionalActionIdField("Preparation"),
     };
     if (action === "modify") {
@@ -257,12 +257,12 @@ function methodChangeSchema(action, methodId, existingMethodIds) {
     if (action === "duplicate") {
         return z.object({
             ...base,
-            new_method_id: actionIdField("New Build Plan id"),
+            new_build_plan_id: actionIdField("New Build Plan id"),
         }).strict().superRefine((values, ctx) => {
-            if (existingMethodIds.has(values.new_method_id)) {
+            if (existingBuildPlanIds.has(values.new_build_plan_id)) {
                 ctx.addIssue({
                     code: z.ZodIssueCode.custom,
-                    path: ["new_method_id"],
+                    path: ["new_build_plan_id"],
                     message: "A Build Plan with this id already exists.",
                 });
             }
@@ -270,7 +270,7 @@ function methodChangeSchema(action, methodId, existingMethodIds) {
     }
     return z.object({
         ...base,
-        confirmation: requiredActionText("Confirmation").refine((value) => value === methodId, `Type ${methodId} to confirm.`),
+        confirmation: requiredActionText("Confirmation").refine((value) => value === buildPlanId, `Type ${buildPlanId} to confirm.`),
     }).strict();
 }
 function preparationChangeSchema(action, preparation, existingNames) {
@@ -284,7 +284,7 @@ function preparationChangeSchema(action, preparation, existingNames) {
             name: actionIdField("Preparation id"),
             path: requiredActionText("Source Folder"),
             about: requiredActionText("Agent work"),
-            method: optionalActionIdField("Build Plan"),
+            build_plan: optionalActionIdField("Build Plan"),
         }).strict().superRefine((values, ctx) => {
             if (values.name !== preparation && existingNames.has(values.name)) {
                 ctx.addIssue({
@@ -301,7 +301,7 @@ function preparationChangeSchema(action, preparation, existingNames) {
             name: actionIdField("New Preparation id"),
             path: requiredActionText("Source Folder"),
             about: requiredActionText("Agent work"),
-            method: optionalActionIdField("Build Plan"),
+            build_plan: optionalActionIdField("Build Plan"),
         }).strict().superRefine((values, ctx) => {
             if (existingNames.has(values.name)) {
                 ctx.addIssue({
@@ -324,51 +324,52 @@ function conciseSummary(value, fallback) {
     const sentence = normalized.match(/^.{24,180}?(?:[.!?](?:\s|$)|$)/)?.[0]?.trim() ?? normalized;
     return sentence.length > 180 ? `${sentence.slice(0, 177).trim()}...` : sentence;
 }
-function normalizedMethodActionValues(values, existingMethodIds, defaultSeed) {
-    const explicitMethodId = maybeActionValue(inputValue(values, "method_id"));
+function normalizedBuildPlanActionValues(values, existingBuildPlanIds, defaultSeed) {
+    const explicitBuildPlanId = maybeActionValue(inputValue(values, "build_plan_id"));
     const taskPrompt = inputValue(values, "task_prompt").trim();
-    const methodId = explicitMethodId ?? uniqueActionId(taskPrompt || defaultSeed || "custom-method", existingMethodIds);
-    const output = maybeActionValue(inputValue(values, "portable_output"));
+    const buildPlanId = explicitBuildPlanId ?? uniqueActionId(taskPrompt || defaultSeed || "custom-build-plan", existingBuildPlanIds);
+    const output = maybeActionValue(inputValue(values, "requested_artifacts_description"));
     return {
         ...values,
-        method_id: methodId,
-        label: maybeActionValue(inputValue(values, "label")) ?? titleFromActionId(methodId),
-        hint: maybeActionValue(inputValue(values, "hint")) ?? conciseSummary(output ?? taskPrompt, "Reusable Build Plan for compiling Artifacts."),
+        build_plan_id: buildPlanId,
+        label: maybeActionValue(inputValue(values, "label")) ?? titleFromActionId(buildPlanId),
+        hint: maybeActionValue(inputValue(values, "hint")) ?? conciseSummary(output ?? taskPrompt, "Reusable Build Plan for building Artifacts."),
         task_prompt: taskPrompt,
     };
 }
 function createPreparationActionValues(values) {
-    const method = inputValue(values, "method");
+    const buildPlan = inputValue(values, "build_plan");
     const readinessNotes = inputValue(values, "readiness_notes");
     return {
         name: inputValue(values, "name"),
         path: inputValue(values, "path"),
         about: inputValue(values, "about"),
-        prepare_after_setup: false,
-        ...(maybeActionValue(method) ? { method } : {}),
+        build_after_setup: false,
+        ...(maybeActionValue(buildPlan) ? { build_plan: buildPlan } : {}),
         ...(maybeActionValue(readinessNotes) ? { readiness_notes: readinessNotes } : {}),
     };
 }
-function selectMethodActionValues(values) {
+function selectBuildPlanActionValues(values) {
     return {
         name: inputValue(values, "name"),
         path: inputValue(values, "path"),
         about: inputValue(values, "about"),
-        method: inputValue(values, "method"),
-        prepare_after_setup: false,
-        setup_mode: "select-method",
+        build_plan: inputValue(values, "build_plan"),
+        build_after_setup: false,
+        setup_mode: "select-build-plan",
     };
 }
 export function preparationSetupRequestFromActionValues(input) {
     const values = PreparationSetupActionValuesSchema.parse(input);
+    const buildPlan = values.build_plan;
     return {
-        prepare_after_setup: values.prepare_after_setup ?? false,
-        setup_mode: values.setup_mode === "select-method" ? "select-method" : "create",
+        build_after_setup: values.build_after_setup ?? false,
+        setup_mode: values.setup_mode === "select-build-plan" ? "select-build-plan" : "create",
         preparation: {
             name: values.name,
             path: values.path,
             about: values.about,
-            ...(values.method && values.method.length > 0 ? { method: values.method } : {}),
+            ...(buildPlan && buildPlan.length > 0 ? { build_plan: buildPlan } : {}),
             checks: values.checks ?? [],
             ...(values.requested_artifacts ? { requested_artifacts: values.requested_artifacts } : {}),
             ...(values.source_profile ? { source_profile: values.source_profile } : {}),
@@ -377,23 +378,23 @@ export function preparationSetupRequestFromActionValues(input) {
         },
     };
 }
-export function methodAuthoringRequestFromActionValues(input, context) {
-    const values = MethodAuthoringActionValuesSchema.parse(input);
-    const methodId = values.method_id;
-    if (!methodId) {
+export function buildPlanAuthoringRequestFromActionValues(input, context) {
+    const values = BuildPlanAuthoringActionValuesSchema.parse(input);
+    const buildPlanId = values.build_plan_id ?? values.build_plan_id;
+    if (!buildPlanId) {
         throw new Error("Build Plan id is required.");
     }
-    const taskPrompt = methodAuthoringTaskPrompt(values);
+    const taskPrompt = buildPlanAuthoringTaskPrompt(values);
     const requestedArtifacts = values.requested_artifacts ?? context.requestedArtifacts ?? [];
     const sourceProfile = values.source_profile ?? context.sourceProfile ?? null;
     return {
         ...(context.preparation ? { preparation: context.preparation } : {}),
         source_folder_path: context.sourceFolderPath,
-        ...(values.base_method_id ? { base_method_id: values.base_method_id } : {}),
-        ...(values.reference_method_id ? { reference_method_id: values.reference_method_id } : {}),
-        method_id: methodId,
-        label: values.label ?? titleFromActionId(methodId),
-        hint: values.hint ?? conciseSummary(values.portable_output ?? values.task_prompt, "Reusable Build Plan for compiling Artifacts."),
+        ...(values.base_build_plan_id ?? values.base_build_plan_id ? { base_build_plan_id: values.base_build_plan_id ?? values.base_build_plan_id } : {}),
+        ...(values.reference_build_plan_id ?? values.reference_build_plan_id ? { reference_build_plan_id: values.reference_build_plan_id ?? values.reference_build_plan_id } : {}),
+        build_plan_id: buildPlanId,
+        label: values.label ?? titleFromActionId(buildPlanId),
+        hint: values.hint ?? conciseSummary(values.requested_artifacts_description ?? values.task_prompt, "Reusable Build Plan for building Artifacts."),
         task_prompt: taskPrompt,
         checks: context.checks ?? [],
         requested_artifacts: requestedArtifacts,
@@ -401,76 +402,76 @@ export function methodAuthoringRequestFromActionValues(input, context) {
         artifact_requirements: artifactRequirementsFromRequestedArtifacts(requestedArtifacts),
     };
 }
-export function methodImprovementActionValues(options) {
+export function buildPlanImprovementActionValues(options) {
     const readinessNotes = (options.checks ?? [])
         .map((check) => check.question)
         .filter((question) => question.trim().length > 0)
         .join("\n");
     return {
-        method_id: options.methodId,
-        reference_method_id: options.methodId,
+        build_plan_id: options.buildPlanId,
+        reference_build_plan_id: options.buildPlanId,
         ...(maybeActionValue(options.label ?? "") ? { label: options.label } : {}),
         ...(maybeActionValue(options.hint ?? "") ? { hint: options.hint } : {}),
-        task_prompt: `Improve Build Plan ${options.methodId} using the latest readiness evidence for Preparation ${options.preparationName}.`,
+        task_prompt: `Improve Build Plan ${options.buildPlanId} using the latest readiness evidence for Preparation ${options.preparationName}.`,
         ...(maybeActionValue(readinessNotes) ? { readiness_notes: readinessNotes } : {}),
     };
 }
-function methodAuthoringActionValues(values) {
-    const methodId = inputValue(values, "method_id");
+function buildPlanAuthoringActionValues(values) {
+    const buildPlanId = inputValue(values, "build_plan_id");
     const label = inputValue(values, "label");
     const hint = inputValue(values, "hint");
-    const portableOutput = inputValue(values, "portable_output");
+    const requestedArtifactsDescription = inputValue(values, "requested_artifacts_description");
     const readinessNotes = inputValue(values, "readiness_notes");
     return {
-        ...(maybeActionValue(methodId) ? { method_id: methodId } : {}),
+        ...(maybeActionValue(buildPlanId) ? { build_plan_id: buildPlanId } : {}),
         ...(maybeActionValue(label) ? { label } : {}),
         ...(maybeActionValue(hint) ? { hint } : {}),
         task_prompt: inputValue(values, "task_prompt"),
-        ...(maybeActionValue(portableOutput) ? { portable_output: portableOutput } : {}),
+        ...(maybeActionValue(requestedArtifactsDescription) ? { requested_artifacts_description: requestedArtifactsDescription } : {}),
         ...(maybeActionValue(readinessNotes) ? { readiness_notes: readinessNotes } : {}),
     };
 }
-function methodChangeActionValues(action, values) {
+function buildPlanChangeActionValues(action, values) {
     if (action === "modify") {
-        const methodId = inputValue(values, "method");
+        const buildPlanId = inputValue(values, "build_plan");
         return {
-            method_id: methodId,
-            reference_method_id: methodId,
+            build_plan_id: buildPlanId,
+            reference_build_plan_id: buildPlanId,
             ...(maybeActionValue(inputValue(values, "label")) ? { label: inputValue(values, "label") } : {}),
             ...(maybeActionValue(inputValue(values, "hint")) ? { hint: inputValue(values, "hint") } : {}),
             task_prompt: [
-                `Modify Build Plan ${methodId}.`,
+                `Modify Build Plan ${buildPlanId}.`,
                 inputValue(values, "change_request"),
             ].filter(Boolean).join("\n"),
         };
     }
     if (action === "duplicate") {
-        const newMethodId = inputValue(values, "new_method_id");
+        const newBuildPlanId = inputValue(values, "new_build_plan_id");
         return {
-            action_type: "method-change",
+            action_type: "build-plan-change",
             operation: "duplicate",
-            method: inputValue(values, "method"),
-            new_method_id: newMethodId,
-            label: titleFromActionId(newMethodId),
-            hint: `Duplicate of ${inputValue(values, "method")}`,
+            build_plan: inputValue(values, "build_plan"),
+            new_build_plan_id: newBuildPlanId,
+            label: titleFromActionId(newBuildPlanId),
+            hint: `Duplicate of ${inputValue(values, "build_plan")}`,
         };
     }
     return {
-        action_type: "method-change",
+        action_type: "build-plan-change",
         operation: "remove",
-        method: inputValue(values, "method"),
+        build_plan: inputValue(values, "build_plan"),
         confirmation: inputValue(values, "confirmation"),
     };
 }
 function duplicatePreparationActionValues(values) {
-    const method = inputValue(values, "method");
+    const buildPlan = inputValue(values, "build_plan");
     return {
         name: inputValue(values, "name"),
         path: inputValue(values, "path"),
         about: inputValue(values, "about"),
-        prepare_after_setup: false,
+        build_after_setup: false,
         setup_mode: "create",
-        ...(maybeActionValue(method) ? { method } : {}),
+        ...(maybeActionValue(buildPlan) ? { build_plan: buildPlan } : {}),
     };
 }
 function preparationChangeActionValues(action, values) {
@@ -489,7 +490,7 @@ export function buildCreatePreparationActionDefinition(context) {
     return {
         id: INTERF_SERVICE_ACTIONS.createPreparation.id,
         title: INTERF_SERVICE_ACTIONS.createPreparation.title,
-        description: "Describe the Source and agent job. Interf saves a Preparation so a Build Plan can be drafted and reviewed before compile.",
+        description: "Describe the Source and agent job. Interf saves a Preparation so a Build Plan can be drafted and reviewed before build.",
         submitLabel: "Create",
         initialValues: {
             name,
@@ -502,7 +503,7 @@ export function buildCreatePreparationActionDefinition(context) {
             name: "name",
             path: "path",
             about: "about",
-            method: "method",
+            build_plan: "build_plan",
         }),
         valuesPreview: createPreparationActionValues,
         buildDraft: (values) => {
@@ -516,7 +517,7 @@ export function buildCreatePreparationActionDefinition(context) {
                     `Agent work: ${inputValue(values, "about")}`,
                     maybeActionValue(readinessNotes) ? `Requested Artifacts and readiness: ${readinessNotes}` : null,
                     `Source folder: ${inputValue(values, "path")}`,
-                    "Draft or select the Build Plan after this Preparation exists. Do not run compile yet.",
+                    "Draft or select the Build Plan after this Preparation exists. Do not build yet.",
                     "Use the attached typed action input as the source of truth.",
                 ].filter((line) => Boolean(line)).join("\n"),
             };
@@ -551,38 +552,38 @@ export function buildCreatePreparationActionDefinition(context) {
         ],
     };
 }
-export function buildCompileRunActionDefinition(context) {
+export function buildBuildRunActionDefinition(context) {
     return {
-        id: INTERF_SERVICE_ACTIONS.compileRun.id,
-        title: INTERF_SERVICE_ACTIONS.compileRun.title,
-        description: "Build portable context for this Preparation. Interf will run the saved Build Plan against the Source and record a visible run.",
+        id: INTERF_SERVICE_ACTIONS.buildRun.id,
+        title: INTERF_SERVICE_ACTIONS.buildRun.title,
+        description: "Build verifiable context for this Preparation. Interf will run the saved Build Plan against the Source and record a visible run.",
         submitLabel: "Run",
         initialValues: {
             preparation: context.name,
-            method: context.methodId,
+            build_plan: context.buildPlanId,
             about: context.about,
             source_folder_path: context.sourceFolderPath,
         },
         schema: prepareRunSchema(),
         valuesPreview: (values) => ({
-            action_type: INTERF_SERVICE_ACTIONS.compileRun.serviceAction,
+            action_type: INTERF_SERVICE_ACTIONS.buildRun.serviceAction,
             preparation: inputValue(values, "preparation"),
-            method: inputValue(values, "method"),
+            build_plan: inputValue(values, "build_plan"),
             source_folder_path: inputValue(values, "source_folder_path"),
             about: inputValue(values, "about"),
         }),
         buildDraft: (values) => ({
             preparation: inputValue(values, "preparation"),
             values: {
-                action_type: INTERF_SERVICE_ACTIONS.compileRun.serviceAction,
+                action_type: INTERF_SERVICE_ACTIONS.buildRun.serviceAction,
                 preparation: inputValue(values, "preparation"),
-                ...(maybeActionValue(inputValue(values, "method")) ? { method: inputValue(values, "method") } : {}),
+                ...(maybeActionValue(inputValue(values, "build_plan")) ? { build_plan: inputValue(values, "build_plan") } : {}),
             },
             message: [
-                `Compile Artifacts for Preparation ${inputValue(values, "preparation")}.`,
+                `Build Artifacts for Preparation ${inputValue(values, "preparation")}.`,
                 maybeActionValue(inputValue(values, "about")) ? `Agent work: ${inputValue(values, "about")}` : null,
-                `Build Plan: ${inputValue(values, "method") || "(saved selection)"}.`,
-                "Build portable context from the saved Source and requested Artifacts.",
+                `Build Plan: ${inputValue(values, "build_plan") || "(saved selection)"}.`,
+                "Build verifiable context from the saved Source and requested Artifacts.",
                 "Use the attached typed action input as the source of truth.",
             ].filter((line) => Boolean(line)).join("\n"),
         }),
@@ -593,15 +594,15 @@ export function buildCompileRunActionDefinition(context) {
                 type: "text",
                 readOnly: true,
                 help: "The saved Preparation that will be built.",
-                context: "Sent as the compile target.",
+                context: "Sent as the build target.",
             },
             {
-                name: "method",
+                name: "build_plan",
                 label: "Build Plan",
                 type: "text",
                 readOnly: true,
                 help: "The Build Plan Interf will run to build the requested Artifacts.",
-                context: "Sent as the compile build-plan override.",
+                context: "Sent as the Build Plan override.",
             },
             {
                 name: "about",
@@ -610,7 +611,7 @@ export function buildCompileRunActionDefinition(context) {
                 readOnly: true,
                 advanced: true,
                 help: "The work this Preparation is meant to support.",
-                context: "Preserved as context for the compile-run proposal.",
+                context: "Preserved as context for the Build run proposal.",
                 placeholder: "No saved job description.",
             },
             {
@@ -625,13 +626,13 @@ export function buildCompileRunActionDefinition(context) {
         ],
     };
 }
-export function buildCompileRunActionDraft(context) {
-    const definition = buildCompileRunActionDefinition(context);
+export function buildBuildRunActionDraft(context) {
+    const definition = buildBuildRunActionDefinition(context);
     return definition.buildDraft(definition.initialValues);
 }
-export function buildSelectMethodActionDefinition(context) {
+export function buildSelectBuildPlanActionDefinition(context) {
     const actionValues = (values) => ({
-        ...selectMethodActionValues(values),
+        ...selectBuildPlanActionValues(values),
         checks: context.checks ?? [],
         requested_artifacts: context.requestedArtifacts ?? [],
         ...(context.sourceProfile ? { source_profile: context.sourceProfile } : {}),
@@ -639,45 +640,45 @@ export function buildSelectMethodActionDefinition(context) {
         ...(typeof context.maxLoops === "number" ? { max_loops: context.maxLoops } : {}),
     });
     return {
-        id: INTERF_SERVICE_ACTIONS.selectMethod.id,
-        title: INTERF_SERVICE_ACTIONS.selectMethod.title,
-        description: "Choose the Build Plan that compiles this Preparation's requested Artifacts. This saves the selection without running compile.",
+        id: INTERF_SERVICE_ACTIONS.selectBuildPlan.id,
+        title: INTERF_SERVICE_ACTIONS.selectBuildPlan.title,
+        description: "Choose the Build Plan that builds this Preparation's requested Artifacts. This saves the selection without running a Build run.",
         submitLabel: "Confirm",
         initialValues: {
             name: context.name,
             path: context.sourceFolderPath,
             about: context.about,
-            current_method: context.currentMethodId ?? "",
-            method: context.currentMethodId ?? "",
+            current_build_plan: context.currentBuildPlanId ?? "",
+            build_plan: context.currentBuildPlanId ?? "",
         },
-        schema: selectMethodSchema(),
+        schema: selectBuildPlanSchema(),
         validateRequest: (values) => packageSchemaFieldErrors(PreparationSetupActionValuesSchema.safeParse(actionValues(values)), {
             name: "name",
             path: "path",
             about: "about",
-            method: "method",
+            build_plan: "build_plan",
         }),
         valuesPreview: actionValues,
         buildDraft: (values) => ({
             preparation: inputValue(values, "name"),
             values: actionValues(values),
             message: [
-                `Select Build Plan ${inputValue(values, "method")} for Preparation ${inputValue(values, "name")}.`,
-                "Save the selected Build Plan. Do not run compile yet.",
+                `Select Build Plan ${inputValue(values, "build_plan")} for Preparation ${inputValue(values, "name")}.`,
+                "Save the selected Build Plan. Do not build yet.",
                 "Use the attached typed action input as the source of truth.",
             ].join("\n"),
         }),
         fields: [
             {
-                name: "method",
+                name: "build_plan",
                 label: "Build Plan",
                 type: "select",
-                help: "The Build Plan future compile runs should use to build requested Artifacts.",
+                help: "The Build Plan future Build runs should use to build requested Artifacts.",
                 context: "Saved on the existing Preparation.",
-                options: methodChoiceOptions(context.methods),
+                options: buildPlanChoiceOptions(context.buildPlans),
             },
             {
-                name: "current_method",
+                name: "current_build_plan",
                 label: "Current Build Plan",
                 type: "text",
                 readOnly: true,
@@ -714,48 +715,48 @@ export function buildSelectMethodActionDefinition(context) {
         ],
     };
 }
-export function buildCreateMethodActionDefinition(context) {
-    const existingMethodIds = new Set(context.existingMethodIds);
-    const defaultSeed = context.defaultPreparation ? `${context.defaultPreparation}-method` : context.suggestedMethodId;
-    const methodId = uniqueActionId(defaultSeed, existingMethodIds);
-    const label = titleFromActionId(methodId);
+export function buildCreateBuildPlanActionDefinition(context) {
+    const existingBuildPlanIds = new Set(context.existingBuildPlanIds);
+    const defaultSeed = context.defaultPreparation ? `${context.defaultPreparation}-build-plan` : context.suggestedBuildPlanId;
+    const buildPlanId = uniqueActionId(defaultSeed, existingBuildPlanIds);
+    const label = titleFromActionId(buildPlanId);
     return {
-        id: INTERF_SERVICE_ACTIONS.createMethod.id,
-        title: INTERF_SERVICE_ACTIONS.createMethod.title,
-        description: "Describe the Artifacts the agent needs. Interf drafts the Build Plan from this description; compile later proves source coverage.",
+        id: INTERF_SERVICE_ACTIONS.createBuildPlan.id,
+        title: INTERF_SERVICE_ACTIONS.createBuildPlan.title,
+        description: "Describe the Artifacts the agent needs. Interf drafts the Build Plan from this description; the Build run later proves source coverage.",
         submitLabel: "Send Request",
         initialValues: {
-            method_id: "",
+            build_plan_id: "",
             label: "",
             hint: "",
             task_prompt: "",
-            portable_output: "",
+            requested_artifacts_description: "",
             readiness_notes: "",
         },
-        normalizeValues: (values) => normalizedMethodActionValues(values, existingMethodIds, defaultSeed),
-        schema: methodAuthoringSchema(existingMethodIds),
-        validateRequest: (values) => packageSchemaFieldErrors(MethodAuthoringActionValuesSchema.safeParse(methodAuthoringActionValues(values)), {
-            method_id: "method_id",
+        normalizeValues: (values) => normalizedBuildPlanActionValues(values, existingBuildPlanIds, defaultSeed),
+        schema: buildPlanAuthoringSchema(existingBuildPlanIds),
+        validateRequest: (values) => packageSchemaFieldErrors(BuildPlanAuthoringActionValuesSchema.safeParse(buildPlanAuthoringActionValues(values)), {
+            build_plan_id: "build_plan_id",
             label: "label",
             hint: "hint",
             task_prompt: "task_prompt",
-            portable_output: "portable_output",
+            requested_artifacts_description: "requested_artifacts_description",
             readiness_notes: "readiness_notes",
         }),
         valuesPreview: (values) => ({
-            method_id: inputValue(values, "method_id"),
+            build_plan_id: inputValue(values, "build_plan_id"),
             label: inputValue(values, "label"),
             hint: inputValue(values, "hint"),
-            task_prompt: methodTaskPromptFromInput(values),
+            task_prompt: buildPlanTaskPromptFromInput(values),
         }),
         buildDraft: (values) => ({
             preparation: context.defaultPreparation,
-            values: methodAuthoringActionValues(values),
+            values: buildPlanAuthoringActionValues(values),
             message: [
-                `Draft Build Plan ${inputValue(values, "method_id")}${context.defaultPreparation ? ` for Preparation ${context.defaultPreparation}` : ""}.`,
+                `Draft Build Plan ${inputValue(values, "build_plan_id")}${context.defaultPreparation ? ` for Preparation ${context.defaultPreparation}` : ""}.`,
                 `Label: ${inputValue(values, "label")}`,
                 `Summary: ${inputValue(values, "hint")}`,
-                methodTaskPromptFromInput(values),
+                buildPlanTaskPromptFromInput(values),
                 "Use the attached typed action input as the Build Plan authoring request.",
             ].join("\n"),
         }),
@@ -770,12 +771,12 @@ export function buildCreateMethodActionDefinition(context) {
                 placeholder: "Example: Analyze every report chart, extract annual take-up by location, and produce a source data file plus markdown summary.",
             },
             {
-                name: "portable_output",
+                name: "requested_artifacts_description",
                 label: "Requested Artifacts",
                 type: "textarea",
                 rows: 3,
-                help: "Files, sections, or evidence agents should receive in portable context.",
-                context: "Guides the requested Artifact shape and Build Plan stages before compile proves source coverage.",
+                help: "Files, sections, or evidence agents should receive in verifiable context.",
+                context: "Guides the requested Artifact shape and Build Plan stages before a Build run proves source coverage.",
                 placeholder: "Describe the files or sections agents should receive.",
             },
             {
@@ -788,13 +789,13 @@ export function buildCreateMethodActionDefinition(context) {
                 placeholder: "Describe the evidence that should make these Artifacts ready.",
             },
             {
-                name: "method_id",
+                name: "build_plan_id",
                 label: "Build Plan id",
                 type: "text",
                 advanced: true,
                 help: "Optional. Leave blank and Interf generates a stable id from the job.",
-                context: "Saved as the technical Method-package id and referenced by Preparations.",
-                placeholder: methodId,
+                context: "Saved as the Build Plan id and referenced by Preparations.",
+                placeholder: buildPlanId,
             },
             {
                 name: "label",
@@ -818,44 +819,44 @@ export function buildCreateMethodActionDefinition(context) {
         ],
     };
 }
-export function buildMethodChangeActionDefinition(context) {
-    const existingMethodIds = new Set(context.existingMethodIds);
+export function buildBuildPlanChangeActionDefinition(context) {
+    const existingBuildPlanIds = new Set(context.existingBuildPlanIds);
     const actionLabel = titleFromActionId(context.action);
-    const newMethodId = context.action === "duplicate"
-        ? uniqueActionId(`${context.methodId}-copy`, existingMethodIds)
+    const newBuildPlanId = context.action === "duplicate"
+        ? uniqueActionId(`${context.buildPlanId}-copy`, existingBuildPlanIds)
         : "";
     const initialValues = {
-        action: `method-${context.action}`,
-        method: context.methodId,
+        action: `build-plan-${context.action}`,
+        build_plan: context.buildPlanId,
         preparation: context.preparation,
         ...(context.action === "modify" ? { change_request: "", label: context.label ?? "", hint: context.hint ?? "" } : {}),
-        ...(context.action === "duplicate" ? { new_method_id: newMethodId } : {}),
+        ...(context.action === "duplicate" ? { new_build_plan_id: newBuildPlanId } : {}),
         ...(context.action === "remove" ? { confirmation: "" } : {}),
     };
-    const actionValues = (values) => methodChangeActionValues(context.action, values);
+    const actionValues = (values) => buildPlanChangeActionValues(context.action, values);
     const messageFor = (values) => {
         if (context.action === "modify") {
             return [
-                `Modify Build Plan ${inputValue(values, "method")}.`,
+                `Modify Build Plan ${inputValue(values, "build_plan")}.`,
                 `Requested change: ${inputValue(values, "change_request")}`,
                 "Use the attached typed Build Plan authoring input as the source of truth.",
             ].join("\n");
         }
         if (context.action === "duplicate") {
             return [
-                `Duplicate Build Plan ${inputValue(values, "method")} as ${inputValue(values, "new_method_id")}.`,
+                `Duplicate Build Plan ${inputValue(values, "build_plan")} as ${inputValue(values, "new_build_plan_id")}.`,
                 "Use the attached typed Build Plan change input as the source of truth.",
             ].join("\n");
         }
         return [
-            `Remove Build Plan ${inputValue(values, "method")}.`,
+            `Remove Build Plan ${inputValue(values, "build_plan")}.`,
             "The user typed the Build Plan id to confirm removal.",
             "Use the attached typed Build Plan change input as the source of truth.",
         ].join("\n");
     };
     const fields = [
         {
-            name: "method",
+            name: "build_plan",
             label: "Build Plan",
             type: "text",
             readOnly: true,
@@ -875,22 +876,22 @@ export function buildMethodChangeActionDefinition(context) {
             placeholder: "Describe the concrete change Interf should make.",
         },
         {
-            name: "new_method_id",
+            name: "new_build_plan_id",
             label: "New Build Plan id",
             type: "text",
             advanced: context.action !== "duplicate",
             help: "Stable id for the duplicated Build Plan.",
             context: "Used as the target Build Plan id for the duplicate request.",
-            placeholder: newMethodId,
+            placeholder: newBuildPlanId,
         },
         {
             name: "confirmation",
             label: "Confirm removal",
             type: "text",
             advanced: context.action !== "remove",
-            help: `Type ${context.methodId} to confirm this removal request.`,
+            help: `Type ${context.buildPlanId} to confirm this removal request.`,
             context: "Prevents accidental destructive Build Plan requests.",
-            placeholder: context.methodId,
+            placeholder: context.buildPlanId,
         },
         {
             name: "label",
@@ -899,7 +900,7 @@ export function buildMethodChangeActionDefinition(context) {
             advanced: true,
             help: "Readable Build Plan name to keep while modifying this Build Plan.",
             context: "Sent to the Build Plan authoring run.",
-            placeholder: context.label ?? context.methodId,
+            placeholder: context.label ?? context.buildPlanId,
         },
         {
             name: "hint",
@@ -923,7 +924,7 @@ export function buildMethodChangeActionDefinition(context) {
         },
     ];
     return {
-        id: `${INTERF_SERVICE_ACTIONS.methodChange.id}-${context.action}`,
+        id: `${INTERF_SERVICE_ACTIONS.buildPlanChange.id}-${context.action}`,
         title: `${actionLabel} Build Plan`,
         description: context.action === "remove"
             ? "Confirm the Build Plan removal request. Interf will reject removal while any saved Preparation still uses it."
@@ -932,7 +933,7 @@ export function buildMethodChangeActionDefinition(context) {
                 : "Describe the change and Interf will run a visible Build Plan draft job.",
         submitLabel: context.action === "modify" ? "Send Request" : "Confirm",
         initialValues,
-        schema: methodChangeSchema(context.action, context.methodId, existingMethodIds),
+        schema: buildPlanChangeSchema(context.action, context.buildPlanId, existingBuildPlanIds),
         valuesPreview: actionValues,
         buildDraft: (values) => ({
             preparation: inputValue(values, "preparation"),
@@ -942,7 +943,7 @@ export function buildMethodChangeActionDefinition(context) {
         fields: fields.filter((field) => {
             if (field.name === "change_request")
                 return context.action === "modify";
-            if (field.name === "new_method_id")
+            if (field.name === "new_build_plan_id")
                 return context.action === "duplicate";
             if (field.name === "confirmation")
                 return context.action === "remove";
@@ -966,7 +967,7 @@ export function buildPreparationChangeActionDefinition(context) {
                 name: context.action === "duplicate" ? duplicateName : context.preparation,
                 path: context.sourceFolderPath,
                 about: context.about ?? "",
-                method: context.methodId ?? "",
+                build_plan: context.buildPlanId ?? "",
             }
             : {}),
         ...(context.action === "remove" ? { confirmation: "" } : {}),
@@ -977,7 +978,7 @@ export function buildPreparationChangeActionDefinition(context) {
             return [
                 `Modify Preparation ${inputValue(values, "preparation")}.`,
                 `Agent work: ${inputValue(values, "about")}`,
-                maybeActionValue(inputValue(values, "method")) ? `Build Plan: ${inputValue(values, "method")}` : null,
+                maybeActionValue(inputValue(values, "build_plan")) ? `Build Plan: ${inputValue(values, "build_plan")}` : null,
                 `Source folder: ${inputValue(values, "path")}`,
                 "Use the attached typed Preparation setup input as the source of truth.",
             ].filter((line) => Boolean(line)).join("\n");
@@ -986,7 +987,7 @@ export function buildPreparationChangeActionDefinition(context) {
             return [
                 `Duplicate Preparation ${inputValue(values, "preparation")} as ${inputValue(values, "name")}.`,
                 `Agent work: ${inputValue(values, "about")}`,
-                maybeActionValue(inputValue(values, "method")) ? `Build Plan: ${inputValue(values, "method")}` : null,
+                maybeActionValue(inputValue(values, "build_plan")) ? `Build Plan: ${inputValue(values, "build_plan")}` : null,
                 `Source folder: ${inputValue(values, "path")}`,
                 "Use the attached typed Preparation setup input as the source of truth.",
             ].filter((line) => Boolean(line)).join("\n");
@@ -1027,10 +1028,10 @@ export function buildPreparationChangeActionDefinition(context) {
             placeholder: "Describe the agent job.",
         },
         {
-            name: "method",
+            name: "build_plan",
             label: "Build Plan",
             type: "text",
-            help: "The Build Plan future compile runs should use.",
+            help: "The Build Plan future Build runs should use.",
             context: "Saved on this Preparation.",
             placeholder: "interf-default",
         },
@@ -1068,7 +1069,7 @@ export function buildPreparationChangeActionDefinition(context) {
                 name: "name",
                 path: "path",
                 about: "about",
-                method: "method",
+                build_plan: "build_plan",
             })
             : undefined,
         valuesPreview: actionValues,
@@ -1078,7 +1079,7 @@ export function buildPreparationChangeActionDefinition(context) {
             message: messageFor(values),
         }),
         fields: fields.filter((field) => {
-            if (field.name === "name" || field.name === "about" || field.name === "method" || field.name === "path")
+            if (field.name === "name" || field.name === "about" || field.name === "build_plan" || field.name === "path")
                 return context.action === "modify" || context.action === "duplicate";
             if (field.name === "confirmation")
                 return context.action === "remove";
@@ -1150,7 +1151,7 @@ export function buildReadinessActionDraft(options) {
         message: `Improve ${options.preparation} using the latest readiness evidence.`,
         values: {
             action_type: INTERF_SERVICE_ACTIONS.improvePreparation.serviceAction,
-            ...(options.methodId ? { method: options.methodId } : {}),
+            ...(options.buildPlanId ? { build_plan: options.buildPlanId } : {}),
             preparation: options.preparation,
         },
     };