@interf/compiler 0.16.0 → 0.21.0

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

@@ -1,4 +1,6 @@
 import { z } from "zod";
+import { RequestedArtifactSchema, SourceProfileSchema, } from "../project/lib/schema.js";
+import { artifactRequirementsFromRequestedArtifacts, formatRequestedArtifactsForPrompt, } from "./requested-artifacts.js";
 export const ActionValueIdPattern = /^[a-z0-9][a-z0-9-]{0,79}$/;
 export const ActionValueIdSchema = z.string().trim().regex(ActionValueIdPattern, "Use lowercase letters, numbers, and dashes.");
 export const OptionalActionValueIdSchema = z.string().trim().refine((value) => value === "" || ActionValueIdPattern.test(value), "Use lowercase letters, numbers, and dashes.");
@@ -6,12 +8,16 @@ export const SourceReadinessCheckActionValueSchema = z.object({
     question: z.string().trim().min(1),
     answer: z.string().trim().optional(),
 }).strict();
+export const RequestedArtifactActionValueSchema = RequestedArtifactSchema;
+export const SourceProfileActionValueSchema = SourceProfileSchema;
 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(),
     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(),
@@ -26,6 +32,8 @@ export const MethodAuthoringActionValuesSchema = z.object({
     hint: z.string().trim().optional(),
     task_prompt: z.string().trim().min(1, "Agent work is required."),
     portable_output: z.string().trim().optional(),
+    requested_artifacts: z.array(RequestedArtifactActionValueSchema).optional(),
+    source_profile: SourceProfileActionValueSchema.nullable().optional(),
     readiness_notes: z.string().trim().optional(),
 }).strict();
 export const INTERF_SERVICE_ACTIONS = {
@@ -33,31 +41,31 @@ export const INTERF_SERVICE_ACTIONS = {
         id: "create-preparation",
         serviceAction: "preparation-setup",
         title: "Create Preparation",
-        description: "Save a Source Folder + Method binding so future runs can be invoked by name.",
+        description: "Save a Source, requested Artifacts, Build Plan, and run history under one Preparation.",
     },
     compileRun: {
         id: "compile-run",
         serviceAction: "compile",
-        title: "Compile Method",
-        description: "Run the chosen Method against this Source Folder and write portable context.",
+        title: "Compile Artifacts",
+        description: "Run the saved Build Plan against this Source and write portable context.",
     },
     selectMethod: {
         id: "select-method",
         serviceAction: "preparation-setup",
-        title: "Select Method",
-        description: "Choose which Method this saved binding should use for future runs.",
+        title: "Select Build Plan",
+        description: "Choose the Build Plan that will compile this Preparation's requested Artifacts.",
     },
     createMethod: {
         id: "create-method",
         serviceAction: "method-authoring",
-        title: "Draft Method",
-        description: "Draft a reusable local Method that captures a repeatable agent-work pattern.",
+        title: "Draft Build Plan",
+        description: "Draft a Build Plan for the Artifacts this Preparation should compile.",
     },
     methodChange: {
         id: "method-change",
         serviceAction: "method-change",
-        title: "Method Change",
-        description: "Modify, duplicate, or remove an existing Method.",
+        title: "Build Plan Change",
+        description: "Modify, duplicate, or remove an existing Build Plan.",
     },
     preparationChange: {
         id: "preparation-change",
@@ -86,8 +94,8 @@ export const INTERF_SERVICE_ACTIONS = {
     improvePreparation: {
         id: "improve-preparation",
         serviceAction: "method-improvement",
-        title: "Improve Method",
-        description: "Use readiness evidence to refine the Method this saved binding uses.",
+        title: "Improve Build Plan",
+        description: "Use readiness evidence to refine the Build Plan this Preparation uses.",
     },
 };
 function optionalLine(label, value) {
@@ -95,9 +103,13 @@ function optionalLine(label, value) {
     return trimmed ? `${label}: ${trimmed}` : null;
 }
 export function methodAuthoringTaskPrompt(values) {
+    const requestedArtifacts = values.requested_artifacts?.length
+        ? formatRequestedArtifactsForPrompt(values.requested_artifacts)
+        : null;
     return [
         `Agent work: ${values.task_prompt}`,
-        optionalLine("Portable-context output", values.portable_output),
+        requestedArtifacts ? `Requested Artifacts:\n${requestedArtifacts}` : null,
+        optionalLine("Requested Artifacts", values.portable_output),
         optionalLine("Readiness checks", values.readiness_notes),
     ].filter((line) => Boolean(line)).join("\n");
 }
@@ -171,7 +183,7 @@ export function methodTaskPromptFromInput(values) {
     const readinessNotes = inputValue(values, "readiness_notes");
     return [
         `Agent work: ${taskPrompt}`,
-        maybeActionValue(portableOutput) ? `Portable-context output: ${portableOutput}` : null,
+        maybeActionValue(portableOutput) ? `Requested Artifacts: ${portableOutput}` : null,
         maybeActionValue(readinessNotes) ? `Readiness checks: ${readinessNotes}` : null,
     ].filter((line) => Boolean(line)).join("\n");
 }
@@ -180,7 +192,7 @@ function createPreparationSchema(existingNames) {
         name: actionIdField("Preparation name"),
         path: requiredActionText("Source Folder"),
         about: requiredActionText("Agent work"),
-        method: optionalActionIdField("Method"),
+        method: optionalActionIdField("Build Plan"),
         readiness_notes: optionalActionText,
     }).strict().superRefine((values, ctx) => {
         if (existingNames.has(values.name)) {
@@ -195,7 +207,7 @@ function createPreparationSchema(existingNames) {
 function prepareRunSchema() {
     return z.object({
         preparation: actionIdField("Preparation"),
-        method: optionalActionIdField("Method"),
+        method: optionalActionIdField("Build Plan"),
         about: optionalActionText,
         source_folder_path: optionalActionText,
     }).strict();
@@ -205,13 +217,13 @@ function selectMethodSchema() {
         name: actionIdField("Preparation"),
         path: requiredActionText("Source Folder"),
         about: requiredActionText("Agent work"),
-        current_method: optionalActionIdField("Current Method"),
-        method: optionalActionIdField("Method"),
+        current_method: optionalActionIdField("Current Build Plan"),
+        method: actionIdField("Build Plan"),
     }).strict();
 }
 function methodAuthoringSchema(existingMethodIds) {
     return z.object({
-        method_id: optionalActionIdField("Method id"),
+        method_id: optionalActionIdField("Build Plan id"),
         label: optionalActionText,
         hint: optionalActionText,
         task_prompt: requiredActionText("Agent work"),
@@ -223,7 +235,7 @@ function methodAuthoringSchema(existingMethodIds) {
             ctx.addIssue({
                 code: z.ZodIssueCode.custom,
                 path: ["method_id"],
-                message: "A Method with this id already exists.",
+                message: "A Build Plan with this id already exists.",
             });
         }
     });
@@ -231,7 +243,7 @@ function methodAuthoringSchema(existingMethodIds) {
 function methodChangeSchema(action, methodId, existingMethodIds) {
     const base = {
         action: requiredActionText("Action"),
-        method: actionIdField("Method"),
+        method: actionIdField("Build Plan"),
         preparation: optionalActionIdField("Preparation"),
     };
     if (action === "modify") {
@@ -245,13 +257,13 @@ function methodChangeSchema(action, methodId, existingMethodIds) {
     if (action === "duplicate") {
         return z.object({
             ...base,
-            new_method_id: actionIdField("New Method id"),
+            new_method_id: actionIdField("New Build Plan id"),
         }).strict().superRefine((values, ctx) => {
             if (existingMethodIds.has(values.new_method_id)) {
                 ctx.addIssue({
                     code: z.ZodIssueCode.custom,
                     path: ["new_method_id"],
-                    message: "A Method with this id already exists.",
+                    message: "A Build Plan with this id already exists.",
                 });
             }
         });
@@ -272,7 +284,7 @@ function preparationChangeSchema(action, preparation, existingNames) {
             name: actionIdField("Preparation id"),
             path: requiredActionText("Source Folder"),
             about: requiredActionText("Agent work"),
-            method: optionalActionIdField("Method"),
+            method: optionalActionIdField("Build Plan"),
         }).strict().superRefine((values, ctx) => {
             if (values.name !== preparation && existingNames.has(values.name)) {
                 ctx.addIssue({
@@ -289,7 +301,7 @@ function preparationChangeSchema(action, preparation, existingNames) {
             name: actionIdField("New Preparation id"),
             path: requiredActionText("Source Folder"),
             about: requiredActionText("Agent work"),
-            method: optionalActionIdField("Method"),
+            method: optionalActionIdField("Build Plan"),
         }).strict().superRefine((values, ctx) => {
             if (existingNames.has(values.name)) {
                 ctx.addIssue({
@@ -321,7 +333,7 @@ function normalizedMethodActionValues(values, existingMethodIds, defaultSeed) {
         ...values,
         method_id: methodId,
         label: maybeActionValue(inputValue(values, "label")) ?? titleFromActionId(methodId),
-        hint: maybeActionValue(inputValue(values, "hint")) ?? conciseSummary(output ?? taskPrompt, "Reusable Method for preparing source files."),
+        hint: maybeActionValue(inputValue(values, "hint")) ?? conciseSummary(output ?? taskPrompt, "Reusable Build Plan for compiling Artifacts."),
         task_prompt: taskPrompt,
     };
 }
@@ -332,7 +344,7 @@ function createPreparationActionValues(values) {
         name: inputValue(values, "name"),
         path: inputValue(values, "path"),
         about: inputValue(values, "about"),
-        prepare_after_setup: true,
+        prepare_after_setup: false,
         ...(maybeActionValue(method) ? { method } : {}),
         ...(maybeActionValue(readinessNotes) ? { readiness_notes: readinessNotes } : {}),
     };
@@ -342,7 +354,7 @@ function selectMethodActionValues(values) {
         name: inputValue(values, "name"),
         path: inputValue(values, "path"),
         about: inputValue(values, "about"),
-        method: maybeActionValue(inputValue(values, "method")) ?? "interf-default",
+        method: inputValue(values, "method"),
         prepare_after_setup: false,
         setup_mode: "select-method",
     };
@@ -356,8 +368,10 @@ export function preparationSetupRequestFromActionValues(input) {
             name: values.name,
             path: values.path,
             about: values.about,
-            method: values.method && values.method.length > 0 ? values.method : "interf-default",
+            ...(values.method && values.method.length > 0 ? { method: values.method } : {}),
             checks: values.checks ?? [],
+            ...(values.requested_artifacts ? { requested_artifacts: values.requested_artifacts } : {}),
+            ...(values.source_profile ? { source_profile: values.source_profile } : {}),
             ...(typeof values.max_attempts === "number" ? { max_attempts: values.max_attempts } : {}),
             ...(typeof values.max_loops === "number" ? { max_loops: values.max_loops } : {}),
         },
@@ -367,9 +381,11 @@ export function methodAuthoringRequestFromActionValues(input, context) {
     const values = MethodAuthoringActionValuesSchema.parse(input);
     const methodId = values.method_id;
     if (!methodId) {
-        throw new Error("Method id is required.");
+        throw new Error("Build Plan id is required.");
     }
     const taskPrompt = methodAuthoringTaskPrompt(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,
@@ -377,9 +393,12 @@ export function methodAuthoringRequestFromActionValues(input, context) {
         ...(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 Method for preparing source files."),
+        hint: values.hint ?? conciseSummary(values.portable_output ?? values.task_prompt, "Reusable Build Plan for compiling Artifacts."),
         task_prompt: taskPrompt,
         checks: context.checks ?? [],
+        requested_artifacts: requestedArtifacts,
+        source_profile: sourceProfile,
+        artifact_requirements: artifactRequirementsFromRequestedArtifacts(requestedArtifacts),
     };
 }
 export function methodImprovementActionValues(options) {
@@ -392,7 +411,7 @@ export function methodImprovementActionValues(options) {
         reference_method_id: options.methodId,
         ...(maybeActionValue(options.label ?? "") ? { label: options.label } : {}),
         ...(maybeActionValue(options.hint ?? "") ? { hint: options.hint } : {}),
-        task_prompt: `Improve Method ${options.methodId} using the latest readiness evidence for Preparation ${options.preparationName}.`,
+        task_prompt: `Improve Build Plan ${options.methodId} using the latest readiness evidence for Preparation ${options.preparationName}.`,
         ...(maybeActionValue(readinessNotes) ? { readiness_notes: readinessNotes } : {}),
     };
 }
@@ -420,7 +439,7 @@ function methodChangeActionValues(action, values) {
             ...(maybeActionValue(inputValue(values, "label")) ? { label: inputValue(values, "label") } : {}),
             ...(maybeActionValue(inputValue(values, "hint")) ? { hint: inputValue(values, "hint") } : {}),
             task_prompt: [
-                `Modify Method ${methodId}.`,
+                `Modify Build Plan ${methodId}.`,
                 inputValue(values, "change_request"),
             ].filter(Boolean).join("\n"),
         };
@@ -470,13 +489,12 @@ export function buildCreatePreparationActionDefinition(context) {
     return {
         id: INTERF_SERVICE_ACTIONS.createPreparation.id,
         title: INTERF_SERVICE_ACTIONS.createPreparation.title,
-        description: "Describe the agent job. Interf saves the Preparation through the local service and starts its first compile run.",
-        submitLabel: "Confirm",
+        description: "Describe the Source and agent job. Interf saves a Preparation so a Build Plan can be drafted and reviewed before compile.",
+        submitLabel: "Create",
         initialValues: {
             name,
             path: context.prepDataDir,
             about: "",
-            method: "interf-default",
             readiness_notes: "",
         },
         schema: createPreparationSchema(existingNames),
@@ -489,7 +507,6 @@ export function buildCreatePreparationActionDefinition(context) {
         valuesPreview: createPreparationActionValues,
         buildDraft: (values) => {
             const actionValues = createPreparationActionValues(values);
-            const method = inputValue(values, "method");
             const readinessNotes = inputValue(values, "readiness_notes");
             return {
                 preparation: inputValue(values, "name"),
@@ -497,9 +514,9 @@ export function buildCreatePreparationActionDefinition(context) {
                 message: [
                     `Create Preparation ${inputValue(values, "name")}.`,
                     `Agent work: ${inputValue(values, "about")}`,
-                    maybeActionValue(method) ? `Method: ${method}` : null,
-                    maybeActionValue(readinessNotes) ? `Readiness checks: ${readinessNotes}` : null,
+                    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.",
                     "Use the attached typed action input as the source of truth.",
                 ].filter((line) => Boolean(line)).join("\n"),
             };
@@ -518,35 +535,18 @@ export function buildCreatePreparationActionDefinition(context) {
                 label: "Agent job",
                 type: "textarea",
                 rows: 4,
-                help: "The concrete work this prepared folder should enable.",
+                help: "The concrete work this Preparation should enable.",
                 context: "Saved as the Preparation intent and sent as typed action input.",
                 placeholder: "Example: Analyze every report chart, extract annual take-up by location, and produce a source data file plus markdown summary.",
             },
-            {
-                name: "method",
-                label: "Method",
-                type: "select",
-                help: "How Interf should build portable context for this Preparation.",
-                context: "Saved as the Method selected for this Preparation.",
-                options: methodChoiceOptions(context.methods),
-            },
             {
                 name: "readiness_notes",
-                label: "Ready when",
+                label: "Requested Artifacts",
                 type: "textarea",
                 rows: 3,
-                help: "Concrete checks that prove the prepared context is good enough.",
-                context: "Used as guidance when Interf proposes Preparation-level readiness checks.",
-                placeholder: "Example: Every output is source-backed, complete for the requested locations, and precise enough to verify.",
-            },
-            {
-                name: "name",
-                label: "Preparation id",
-                type: "text",
-                advanced: true,
-                help: "Auto-generated for the CLI and portable-context folder. Change only if needed.",
-                context: "Used in the CLI, saved on the Preparation, and used for the portable-context folder name.",
-                placeholder: name,
+                help: "Artifacts, coverage, and proof the agent needs before it can trust the Source.",
+                context: "Used as guidance when Interf drafts the Build Plan and readiness checks for review.",
+                placeholder: "Example: Extract every chart, produce a source data file, write a markdown summary, and show evidence for every location.",
             },
         ],
     };
@@ -555,7 +555,7 @@ export function buildCompileRunActionDefinition(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 Method against the source folder and record a visible run.",
+        description: "Build portable 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,
@@ -579,9 +579,10 @@ export function buildCompileRunActionDefinition(context) {
                 ...(maybeActionValue(inputValue(values, "method")) ? { method: inputValue(values, "method") } : {}),
             },
             message: [
-                `Compile Method ${inputValue(values, "method") || "(saved selection)"} for Preparation ${inputValue(values, "preparation")}.`,
+                `Compile Artifacts for Preparation ${inputValue(values, "preparation")}.`,
                 maybeActionValue(inputValue(values, "about")) ? `Agent work: ${inputValue(values, "about")}` : null,
-                "Build portable context from the saved Source Folder and selected Method.",
+                `Build Plan: ${inputValue(values, "method") || "(saved selection)"}.`,
+                "Build portable 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"),
         }),
@@ -596,11 +597,11 @@ export function buildCompileRunActionDefinition(context) {
             },
             {
                 name: "method",
-                label: "Method",
+                label: "Build Plan",
                 type: "text",
                 readOnly: true,
-                help: "The Method Interf will run for this Preparation.",
-                context: "Sent as the compile Method override.",
+                help: "The Build Plan Interf will run to build the requested Artifacts.",
+                context: "Sent as the compile build-plan override.",
             },
             {
                 name: "about",
@@ -632,20 +633,22 @@ export function buildSelectMethodActionDefinition(context) {
     const actionValues = (values) => ({
         ...selectMethodActionValues(values),
         checks: context.checks ?? [],
+        requested_artifacts: context.requestedArtifacts ?? [],
+        ...(context.sourceProfile ? { source_profile: context.sourceProfile } : {}),
         ...(typeof context.maxAttempts === "number" ? { max_attempts: context.maxAttempts } : {}),
         ...(typeof context.maxLoops === "number" ? { max_loops: context.maxLoops } : {}),
     });
     return {
         id: INTERF_SERVICE_ACTIONS.selectMethod.id,
         title: INTERF_SERVICE_ACTIONS.selectMethod.title,
-        description: "Choose which Method this Preparation uses for future compile runs. This saves the selection without running prepare.",
+        description: "Choose the Build Plan that compiles this Preparation's requested Artifacts. This saves the selection without running compile.",
         submitLabel: "Confirm",
         initialValues: {
             name: context.name,
             path: context.sourceFolderPath,
             about: context.about,
-            current_method: context.currentMethodId,
-            method: context.currentMethodId || "interf-default",
+            current_method: context.currentMethodId ?? "",
+            method: context.currentMethodId ?? "",
         },
         schema: selectMethodSchema(),
         validateRequest: (values) => packageSchemaFieldErrors(PreparationSetupActionValuesSchema.safeParse(actionValues(values)), {
@@ -659,26 +662,26 @@ export function buildSelectMethodActionDefinition(context) {
             preparation: inputValue(values, "name"),
             values: actionValues(values),
             message: [
-                `Select Method ${inputValue(values, "method") || "interf-default"} for Preparation ${inputValue(values, "name")}.`,
-                "Save the selected Method. Do not run prepare yet.",
+                `Select Build Plan ${inputValue(values, "method")} for Preparation ${inputValue(values, "name")}.`,
+                "Save the selected Build Plan. Do not run compile yet.",
                 "Use the attached typed action input as the source of truth.",
             ].join("\n"),
         }),
         fields: [
             {
                 name: "method",
-                label: "Method",
+                label: "Build Plan",
                 type: "select",
-                help: "The Method future compile runs should use.",
+                help: "The Build Plan future compile runs should use to build requested Artifacts.",
                 context: "Saved on the existing Preparation.",
                 options: methodChoiceOptions(context.methods),
             },
             {
                 name: "current_method",
-                label: "Current Method",
+                label: "Current Build Plan",
                 type: "text",
                 readOnly: true,
-                help: "The Method currently saved for this Preparation.",
+                help: "The Build Plan currently saved for this Preparation.",
                 context: "Shown so the change is explicit before approval.",
             },
             {
@@ -687,7 +690,7 @@ export function buildSelectMethodActionDefinition(context) {
                 type: "text",
                 readOnly: true,
                 advanced: true,
-                help: "The Preparation whose Method selection will be updated.",
+                help: "The Preparation whose Build Plan selection will be updated.",
                 context: "Sent with the setup action.",
             },
             {
@@ -697,7 +700,7 @@ export function buildSelectMethodActionDefinition(context) {
                 readOnly: true,
                 advanced: true,
                 help: "The saved job intent for this Preparation.",
-                context: "Preserved while updating the selected Method.",
+                context: "Preserved while updating the selected Build Plan.",
             },
             {
                 name: "path",
@@ -706,7 +709,7 @@ export function buildSelectMethodActionDefinition(context) {
                 readOnly: true,
                 advanced: true,
                 help: "The saved Source Folder path.",
-                context: "Preserved while updating the selected Method.",
+                context: "Preserved while updating the selected Build Plan.",
             },
         ],
     };
@@ -719,7 +722,7 @@ export function buildCreateMethodActionDefinition(context) {
     return {
         id: INTERF_SERVICE_ACTIONS.createMethod.id,
         title: INTERF_SERVICE_ACTIONS.createMethod.title,
-        description: "Describe the reusable job this Method should make possible. Interf will generate the stable Method metadata unless you override it.",
+        description: "Describe the Artifacts the agent needs. Interf drafts the Build Plan from this description; compile later proves source coverage.",
         submitLabel: "Send Request",
         initialValues: {
             method_id: "",
@@ -749,11 +752,11 @@ export function buildCreateMethodActionDefinition(context) {
             preparation: context.defaultPreparation,
             values: methodAuthoringActionValues(values),
             message: [
-                `Create Method ${inputValue(values, "method_id")}${context.defaultPreparation ? ` for Preparation ${context.defaultPreparation}` : ""}.`,
+                `Draft Build Plan ${inputValue(values, "method_id")}${context.defaultPreparation ? ` for Preparation ${context.defaultPreparation}` : ""}.`,
                 `Label: ${inputValue(values, "label")}`,
                 `Summary: ${inputValue(values, "hint")}`,
                 methodTaskPromptFromInput(values),
-                "Use the attached typed action input as the Method authoring request.",
+                "Use the attached typed action input as the Build Plan authoring request.",
             ].join("\n"),
         }),
         fields: [
@@ -762,17 +765,17 @@ export function buildCreateMethodActionDefinition(context) {
                 label: "Agent work",
                 type: "textarea",
                 rows: 4,
-                help: "The reusable job this Method should make possible for agents.",
-                context: "Used as the main Method-authoring instruction.",
+                help: "The agent task this Preparation should unlock.",
+                context: "Used as the main Build Plan authoring instruction.",
                 placeholder: "Example: Analyze every report chart, extract annual take-up by location, and produce a source data file plus markdown summary.",
             },
             {
                 name: "portable_output",
-                label: "Portable-context output",
+                label: "Requested Artifacts",
                 type: "textarea",
                 rows: 3,
                 help: "Files, sections, or evidence agents should receive in portable context.",
-                context: "Guides the Method output shape and stage artifact plan.",
+                context: "Guides the requested Artifact shape and Build Plan stages before compile proves source coverage.",
                 placeholder: "Describe the files or sections agents should receive.",
             },
             {
@@ -780,17 +783,17 @@ export function buildCreateMethodActionDefinition(context) {
                 label: "Readiness guidance",
                 type: "textarea",
                 rows: 3,
-                help: "What this Method output should be able to prove.",
-                context: "Guides readiness checks. Method acceptance criteria stay separate.",
-                placeholder: "Describe the evidence that should make this Method output ready.",
+                help: "What these Artifacts should be able to prove.",
+                context: "Guides readiness checks. Artifact contract checks stay separate.",
+                placeholder: "Describe the evidence that should make these Artifacts ready.",
             },
             {
                 name: "method_id",
-                label: "Method id",
+                label: "Build Plan id",
                 type: "text",
                 advanced: true,
                 help: "Optional. Leave blank and Interf generates a stable id from the job.",
-                context: "Saved under the Workspace methods folder and referenced by Preparations.",
+                context: "Saved as the technical Method-package id and referenced by Preparations.",
                 placeholder: methodId,
             },
             {
@@ -799,7 +802,7 @@ export function buildCreateMethodActionDefinition(context) {
                 type: "text",
                 advanced: true,
                 help: "Optional readable name people can choose later.",
-                context: "Shown in the UI and sent to the local agent while drafting the Method.",
+                context: "Shown in the UI and sent to the local agent while drafting the Build Plan.",
                 placeholder: label,
             },
             {
@@ -833,31 +836,31 @@ export function buildMethodChangeActionDefinition(context) {
     const messageFor = (values) => {
         if (context.action === "modify") {
             return [
-                `Modify Method ${inputValue(values, "method")}.`,
+                `Modify Build Plan ${inputValue(values, "method")}.`,
                 `Requested change: ${inputValue(values, "change_request")}`,
-                "Use the attached typed Method-authoring input as the source of truth.",
+                "Use the attached typed Build Plan authoring input as the source of truth.",
             ].join("\n");
         }
         if (context.action === "duplicate") {
             return [
-                `Duplicate Method ${inputValue(values, "method")} as ${inputValue(values, "new_method_id")}.`,
-                "Use the attached typed Method change input as the source of truth.",
+                `Duplicate Build Plan ${inputValue(values, "method")} as ${inputValue(values, "new_method_id")}.`,
+                "Use the attached typed Build Plan change input as the source of truth.",
             ].join("\n");
         }
         return [
-            `Remove Method ${inputValue(values, "method")}.`,
-            "The user typed the Method id to confirm removal.",
-            "Use the attached typed Method change input as the source of truth.",
+            `Remove Build Plan ${inputValue(values, "method")}.`,
+            "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",
-            label: "Method",
+            label: "Build Plan",
             type: "text",
             readOnly: true,
-            help: "The Method this request targets.",
-            context: "Sent as the Method change target.",
+            help: "The Build Plan this request targets.",
+            context: "Sent as the Build Plan change target.",
         },
         {
             name: "change_request",
@@ -866,18 +869,18 @@ export function buildMethodChangeActionDefinition(context) {
             rows: 4,
             advanced: context.action === "remove",
             help: context.action === "duplicate"
-                ? "What should be different in the duplicate Method."
-                : "What should change in the existing Method.",
-            context: "Sent as the human-authored Method change request.",
+                ? "What should be different in the duplicate Build Plan."
+                : "What should change in the existing Build Plan.",
+            context: "Sent as the human-authored Build Plan change request.",
             placeholder: "Describe the concrete change Interf should make.",
         },
         {
             name: "new_method_id",
-            label: "New Method id",
+            label: "New Build Plan id",
             type: "text",
             advanced: context.action !== "duplicate",
-            help: "Stable id for the duplicated Method.",
-            context: "Used as the target Method id for the duplicate request.",
+            help: "Stable id for the duplicated Build Plan.",
+            context: "Used as the target Build Plan id for the duplicate request.",
             placeholder: newMethodId,
         },
         {
@@ -886,7 +889,7 @@ export function buildMethodChangeActionDefinition(context) {
             type: "text",
             advanced: context.action !== "remove",
             help: `Type ${context.methodId} to confirm this removal request.`,
-            context: "Prevents accidental destructive Method requests.",
+            context: "Prevents accidental destructive Build Plan requests.",
             placeholder: context.methodId,
         },
         {
@@ -894,8 +897,8 @@ export function buildMethodChangeActionDefinition(context) {
             label: "Label",
             type: "text",
             advanced: true,
-            help: "Readable Method name to keep while modifying this Method.",
-            context: "Sent to the Method-authoring run.",
+            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,
         },
         {
@@ -904,9 +907,9 @@ export function buildMethodChangeActionDefinition(context) {
             type: "textarea",
             rows: 2,
             advanced: true,
-            help: "Short Method summary to keep while modifying this Method.",
-            context: "Sent to the Method-authoring run.",
-            placeholder: context.hint ?? "Reusable Method for preparing source folders.",
+            help: "Short Build Plan summary to keep while modifying this Build Plan.",
+            context: "Sent to the Build Plan authoring run.",
+            placeholder: context.hint ?? "Reusable Build Plan for compiling Artifacts.",
         },
         {
             name: "preparation",
@@ -921,12 +924,12 @@ export function buildMethodChangeActionDefinition(context) {
     ];
     return {
         id: `${INTERF_SERVICE_ACTIONS.methodChange.id}-${context.action}`,
-        title: `${actionLabel} Method`,
+        title: `${actionLabel} Build Plan`,
         description: context.action === "remove"
-            ? "Confirm the Method removal request. Interf will reject removal while any saved Preparation still uses it."
+            ? "Confirm the Build Plan removal request. Interf will reject removal while any saved Preparation still uses it."
             : context.action === "duplicate"
-                ? "Duplicate this Method through the local Interf service."
-                : "Describe the change and Interf will run a visible Method draft job.",
+                ? "Duplicate this Build Plan through the local Interf service."
+                : "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),
@@ -963,7 +966,7 @@ export function buildPreparationChangeActionDefinition(context) {
                 name: context.action === "duplicate" ? duplicateName : context.preparation,
                 path: context.sourceFolderPath,
                 about: context.about ?? "",
-                method: context.methodId ?? "interf-default",
+                method: context.methodId ?? "",
             }
             : {}),
         ...(context.action === "remove" ? { confirmation: "" } : {}),
@@ -974,7 +977,7 @@ export function buildPreparationChangeActionDefinition(context) {
             return [
                 `Modify Preparation ${inputValue(values, "preparation")}.`,
                 `Agent work: ${inputValue(values, "about")}`,
-                maybeActionValue(inputValue(values, "method")) ? `Method: ${inputValue(values, "method")}` : null,
+                maybeActionValue(inputValue(values, "method")) ? `Build Plan: ${inputValue(values, "method")}` : null,
                 `Source folder: ${inputValue(values, "path")}`,
                 "Use the attached typed Preparation setup input as the source of truth.",
             ].filter((line) => Boolean(line)).join("\n");
@@ -983,7 +986,7 @@ export function buildPreparationChangeActionDefinition(context) {
             return [
                 `Duplicate Preparation ${inputValue(values, "preparation")} as ${inputValue(values, "name")}.`,
                 `Agent work: ${inputValue(values, "about")}`,
-                maybeActionValue(inputValue(values, "method")) ? `Method: ${inputValue(values, "method")}` : null,
+                maybeActionValue(inputValue(values, "method")) ? `Build Plan: ${inputValue(values, "method")}` : null,
                 `Source folder: ${inputValue(values, "path")}`,
                 "Use the attached typed Preparation setup input as the source of truth.",
             ].filter((line) => Boolean(line)).join("\n");
@@ -1025,9 +1028,9 @@ export function buildPreparationChangeActionDefinition(context) {
         },
         {
             name: "method",
-            label: "Method",
+            label: "Build Plan",
             type: "text",
-            help: "The Method future compile runs should use.",
+            help: "The Build Plan future compile runs should use.",
             context: "Saved on this Preparation.",
             placeholder: "interf-default",
         },