@interf/compiler 0.21.0 → 0.22.0

package/dist/cli/commands/mcp.js

@@ -22,17 +22,17 @@
  *   prep_list           GET /v1/preparations
  *   prep_create         POST /v1/preparations
  *   prep_show           GET /v1/preparations/{id}
- *   prep_set_method     PATCH /v1/preparations/{id}
+ *   prep_select_build_plan PATCH /v1/preparations/{id}
  *   prep_remove         DELETE /v1/preparations/{id}
- *   prep_compile        POST /v1/preparations/{id}/compile-runs
+ *   prep_build          POST /v1/preparations/{id}/build-runs
  *   prep_test           POST /v1/preparations/{id}/verify-runs
- *   method_list         GET /v1/methods
- *   method_draft        POST /v1/preparations/{id}/method-authoring-runs
- *   method_improve      POST /v1/preparations/{id}/method-improvement-runs
+ *   build_plan_list     GET /v1/build-plans
+ *   build_plan_draft    POST /v1/preparations/{id}/build-plan-draft-runs
+ *   build_plan_improve  POST /v1/preparations/{id}/build-plan-improvement-runs
  *   runs_status         GET /v1/runs/{run-id}
- *   runs_watch          GET /v1/runs/{run-id}/events  (snapshot, not SSE)
- *   runs_cancel         POST /v1/runs/{run-id}/cancel
- *   runs_fetch          GET /v1/runs/{run-id}/artifacts
+ *   runs_watch          GET /v1/build-runs/{run-id}/events  (snapshot, not SSE)
+ *   runs_cancel         POST /v1/build-runs/{run-id}/cancel
+ *   runs_fetch          GET /v1/build-runs/{run-id}/artifacts
  *   instance_status     GET /v1/instance
  */
 import { spawn } from "node:child_process";
@@ -41,8 +41,8 @@ import { z } from "zod";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CONNECT_OR_ERROR_HINT, readActiveConnection, } from "../../packages/engine/connection-config.js";
-import { LOCAL_SERVICE_ROUTES, preparationResourcePath, preparationSubresourcePath, runResourcePath, runSubresourcePath, } from "../../packages/engine/routes.js";
-import { MethodAuthoringArtifactRequirementSchema, } from "../../packages/engine/lib/schema.js";
+import { LOCAL_SERVICE_ROUTES, preparationResourcePath, preparationSubresourcePath, runResourcePath, } from "../../packages/engine/routes.js";
+import { BuildPlanAuthoringArtifactRequirementSchema, } from "../../packages/engine/lib/schema.js";
 import { RequestedArtifactSchema, SourceProfileSchema, } from "../../packages/project/lib/schema.js";
 function trimTrailingSlash(value) {
     return value.replace(/\/+$/, "");
@@ -224,7 +224,7 @@ function registerTools(server, connectionArgs) {
     server.registerTool("prep_list", {
         title: "List preparations",
         description: "List every Preparation registered on the connected Interf instance, "
-            + "with source binding, Build Plan / Method package id, and current readiness.",
+            + "with source binding, Build Plan id, and current readiness.",
         inputSchema: {},
     }, async () => callAndReturn(connectionArgs, LOCAL_SERVICE_ROUTES.preparations));
     server.registerTool("prep_create", {
@@ -234,17 +234,17 @@ function registerTools(server, connectionArgs) {
         inputSchema: {
             id: z.string().min(1).describe("Preparation id (kebab-case)."),
             source_path: z.string().min(1).describe("Source path visible to the connected instance."),
-            method_id: z.string().min(1).optional().describe("Optional Build Plan / Method id to select. Select later with prep_set_method if omitted."),
+            build_plan_id: z.string().min(1).optional().describe("Optional Build Plan id to select. Select later with prep_select_build_plan if omitted."),
             about: z.string().min(1).optional().describe("Optional human-readable description."),
             requested_artifacts: z.array(RequestedArtifactSchema).optional().describe("Requested Artifacts the agent/user confirmed for this Preparation."),
-            source_profile: SourceProfileSchema.optional().describe("Advisory source profile from the agent's inspection before compile."),
+            source_profile: SourceProfileSchema.optional().describe("Advisory source profile from the agent's inspection before build."),
         },
     }, async (args) => callAndReturn(connectionArgs, LOCAL_SERVICE_ROUTES.preparations, {
         method: "POST",
         body: JSON.stringify({
             id: args.id,
             source: { kind: "local-folder", locator: args.source_path },
-            ...(args.method_id ? { method_id: args.method_id } : {}),
+            ...(args.build_plan_id ? { build_plan_id: args.build_plan_id } : {}),
             ...(args.about ? { about: args.about } : {}),
             ...(args.requested_artifacts ? { requested_artifacts: args.requested_artifacts } : {}),
             ...(args.source_profile ? { source_profile: args.source_profile } : {}),
@@ -257,40 +257,40 @@ function registerTools(server, connectionArgs) {
             id: z.string().min(1).describe("Preparation id."),
         },
     }, async (args) => callAndReturn(connectionArgs, preparationResourcePath(args.id)));
-    server.registerTool("prep_set_method", {
+    server.registerTool("prep_select_build_plan", {
         title: "Select a Build Plan for a Preparation",
-        description: "Update the Build Plan / Method-package binding on a Preparation. Use this to swap "
-            + "Build Plans between compile runs without rebuilding the Preparation.",
+        description: "Update the selected Build Plan on a Preparation. Use this to swap "
+            + "Build Plans between Build runs without rebuilding the Preparation.",
         inputSchema: {
             id: z.string().min(1).describe("Preparation id."),
-            method_id: z.string().min(1).describe("Build Plan / Method id to use."),
+            build_plan_id: z.string().min(1).describe("Build Plan id to use."),
         },
     }, async (args) => callAndReturn(connectionArgs, preparationResourcePath(args.id), {
         method: "PATCH",
-        body: JSON.stringify({ method_id: args.method_id }),
+        body: JSON.stringify({ build_plan_id: args.build_plan_id }),
     }));
     server.registerTool("prep_remove", {
         title: "Remove a preparation",
-        description: "Delete a Preparation. Portable context is removed too.",
+        description: "Delete a Preparation. Verifiable context is removed too.",
         inputSchema: {
             id: z.string().min(1).describe("Preparation id."),
         },
     }, async (args) => callAndReturn(connectionArgs, preparationResourcePath(args.id), {
         method: "DELETE",
     }));
-    // ── Compile + readiness-check runs ─────────────────────────────────────
-    server.registerTool("prep_compile", {
-        title: "Start a compile run",
-        description: "Kick off a compile run for a Preparation. Returns the new run "
+    // ── Build + readiness-check runs ───────────────────────────────────────
+    server.registerTool("prep_build", {
+        title: "Start a Build run",
+        description: "Run the selected Build Plan for a Preparation. Returns the new Build run "
             + "resource immediately; use runs_status to poll progress and "
             + "runs_fetch when the run finishes.",
         inputSchema: {
             id: z.string().min(1).describe("Preparation id."),
         },
-    }, async (args) => callAndReturn(connectionArgs, preparationSubresourcePath(args.id, "compileRuns"), { method: "POST", body: "{}" }));
+    }, async (args) => callAndReturn(connectionArgs, preparationSubresourcePath(args.id, "buildRuns"), { method: "POST", body: "{}" }));
     server.registerTool("prep_test", {
         title: "Run readiness checks",
-        description: "Run the Preparation's readiness checks against the latest portable "
+        description: "Run the Preparation's readiness checks against the latest verifiable "
             + "context.",
         inputSchema: {
             id: z.string().min(1).describe("Preparation id."),
@@ -299,34 +299,34 @@ function registerTools(server, connectionArgs) {
         method: "POST",
         body: JSON.stringify({}),
     }));
-    // ── Methods ─────────────────────────────────────────────────────────────
-    server.registerTool("method_list", {
-        title: "List Methods",
-        description: "List every Method visible to the connected instance: user-authored "
-            + "Methods, the user library at ~/.interf/methods/, and bundled Methods.",
+    // ── Build Plans ────────────────────────────────────────────────────────
+    server.registerTool("build_plan_list", {
+        title: "List Build Plans",
+        description: "List every Build Plan visible to the connected instance: Preparation drafts, "
+            + "saved Build Plans, and bundled Build Plans.",
         inputSchema: {},
-    }, async () => callAndReturn(connectionArgs, LOCAL_SERVICE_ROUTES.methods));
-    server.registerTool("method_draft", {
+    }, async () => callAndReturn(connectionArgs, LOCAL_SERVICE_ROUTES.buildPlans));
+    server.registerTool("build_plan_draft", {
         title: "Draft a Build Plan",
         description: "Run the Build Plan authoring agent for a Preparation. Saved requested "
             + "Artifacts are used automatically when omitted from the request.",
         inputSchema: {
             prep_id: z.string().min(1).describe("Preparation id."),
             source_folder_path: z.string().min(1).describe("Source folder path visible to the connected instance."),
-            method_id: z.string().min(1).describe("Build Plan / Method id to create."),
+            build_plan_id: z.string().min(1).describe("Build Plan id to create."),
             label: z.string().min(1).describe("Human-readable Build Plan label."),
             hint: z.string().min(1).describe("Short Build Plan hint."),
             task_prompt: z.string().min(1).describe("Agent job this Build Plan should support."),
             requested_artifacts: z.array(RequestedArtifactSchema).optional(),
             source_profile: SourceProfileSchema.nullable().optional(),
-            artifact_requirements: z.array(MethodAuthoringArtifactRequirementSchema).optional(),
+            artifact_requirements: z.array(BuildPlanAuthoringArtifactRequirementSchema).optional(),
         },
-    }, async (args) => callAndReturn(connectionArgs, preparationSubresourcePath(args.prep_id, "methodAuthoringRuns"), {
+    }, async (args) => callAndReturn(connectionArgs, preparationSubresourcePath(args.prep_id, "buildPlanDraftRuns"), {
         method: "POST",
         body: JSON.stringify({
             preparation: args.prep_id,
             source_folder_path: args.source_folder_path,
-            method_id: args.method_id,
+            build_plan_id: args.build_plan_id,
             label: args.label,
             hint: args.hint,
             task_prompt: args.task_prompt,
@@ -335,28 +335,28 @@ function registerTools(server, connectionArgs) {
             ...(args.artifact_requirements ? { artifact_requirements: args.artifact_requirements } : {}),
         }),
     }));
-    server.registerTool("method_improve", {
+    server.registerTool("build_plan_improve", {
         title: "Improve a Build Plan",
         description: "Run the Build Plan improvement agent for a Preparation. Iterates on "
-            + "the selected Method package based on requested Artifacts and latest readiness evidence.",
+            + "the selected Build Plan based on requested Artifacts and latest readiness evidence.",
         inputSchema: {
             prep_id: z.string().min(1).describe("Preparation id."),
             source_folder_path: z.string().min(1).describe("Source folder path visible to the connected instance."),
-            method_id: z.string().min(1).describe("Selected Build Plan / Method id to improve."),
+            build_plan_id: z.string().min(1).describe("Selected Build Plan id to improve."),
             label: z.string().min(1).describe("Human-readable Build Plan label."),
             hint: z.string().min(1).describe("Short Build Plan hint."),
             task_prompt: z.string().min(1).describe("Change request or improvement goal."),
             requested_artifacts: z.array(RequestedArtifactSchema).optional(),
             source_profile: SourceProfileSchema.nullable().optional(),
-            artifact_requirements: z.array(MethodAuthoringArtifactRequirementSchema).optional(),
+            artifact_requirements: z.array(BuildPlanAuthoringArtifactRequirementSchema).optional(),
         },
-    }, async (args) => callAndReturn(connectionArgs, preparationSubresourcePath(args.prep_id, "methodImprovementRuns"), {
+    }, async (args) => callAndReturn(connectionArgs, preparationSubresourcePath(args.prep_id, "buildPlanImprovementRuns"), {
         method: "POST",
         body: JSON.stringify({
             preparation: args.prep_id,
             source_folder_path: args.source_folder_path,
-            method_id: args.method_id,
-            reference_method_id: args.method_id,
+            build_plan_id: args.build_plan_id,
+            reference_build_plan_id: args.build_plan_id,
             label: args.label,
             hint: args.hint,
             task_prompt: args.task_prompt,
@@ -381,22 +381,22 @@ function registerTools(server, connectionArgs) {
         inputSchema: {
             run_id: z.string().min(1).describe("Run id."),
         },
-    }, async (args) => callAndReturn(connectionArgs, runSubresourcePath(args.run_id, "events")));
+    }, async (args) => callAndReturn(connectionArgs, `${LOCAL_SERVICE_ROUTES.buildRuns}/${encodeURIComponent(args.run_id)}/events`));
     server.registerTool("runs_cancel", {
         title: "Cancel a run",
         description: "Request cancellation of an in-flight run.",
         inputSchema: {
             run_id: z.string().min(1).describe("Run id."),
         },
-    }, async (args) => callAndReturn(connectionArgs, runSubresourcePath(args.run_id, "cancel"), { method: "POST", body: "{}" }));
+    }, async (args) => callAndReturn(connectionArgs, `${LOCAL_SERVICE_ROUTES.buildRuns}/${encodeURIComponent(args.run_id)}/cancel`, { method: "POST", body: "{}" }));
     server.registerTool("runs_fetch", {
         title: "Fetch run artifacts",
-        description: "Return the artifact manifest for a finished run (portable context, "
+        description: "Return the artifact manifest for a finished run (verifiable context, "
             + "proof records, logs, run-scoped audit trail).",
         inputSchema: {
             run_id: z.string().min(1).describe("Run id."),
         },
-    }, async (args) => callAndReturn(connectionArgs, runSubresourcePath(args.run_id, "artifacts")));
+    }, async (args) => callAndReturn(connectionArgs, `${LOCAL_SERVICE_ROUTES.buildRuns}/${encodeURIComponent(args.run_id)}/artifacts`));
     // ── Instance ────────────────────────────────────────────────────────────
     server.registerTool("instance_status", {
         title: "Show instance status",

package/dist/cli/commands/prep.js

@@ -2,7 +2,7 @@
  * `interf prep` — preparation CRUD against a connected instance.
  *
  *   interf prep ls
- *   interf prep create <id> --source <path> [--method <id>] [--about <text>]
+ *   interf prep create <id> --source <path> [--build-plan <id>] [--about <text>]
  *   interf prep show <id>
  *   interf prep rm <id>
  *
@@ -81,11 +81,11 @@ function statusColor(status) {
 function renderPreparationSummary(prep) {
     console.log();
     console.log(`  ${chalk.bold(prep.name)}`);
-    console.log(chalk.dim(`    Build Plan: ${prep.method_id ?? "(not selected)"}`));
+    console.log(chalk.dim(`    Build Plan: ${prep.build_plan_id ?? "(not selected)"}`));
     if (prep.source_path)
         console.log(chalk.dim(`    source:  ${prep.source_path}`));
-    if (prep.portable_context_path) {
-        console.log(chalk.dim(`    output:  ${prep.portable_context_path}`));
+    if (prep.verifiable_context_path) {
+        console.log(chalk.dim(`    output:  ${prep.verifiable_context_path}`));
     }
     if (prep.readiness?.status) {
         const aggColor = prep.readiness.ready ? chalk.green : chalk.yellow;
@@ -117,9 +117,9 @@ function renderPreparationSummary(prep) {
             }
         }
     }
-    if (prep.latest_compile_run_id) {
+    if (prep.latest_build_run_id) {
         console.log();
-        console.log(chalk.dim(`    latest compile run: ${prep.latest_compile_run_id}`));
+        console.log(chalk.dim(`    latest Build run: ${prep.latest_build_run_id}`));
     }
     if (prep.latest_test_run_id) {
         console.log(chalk.dim(`    latest check run:   ${prep.latest_test_run_id}`));
@@ -153,12 +153,12 @@ export const prepCommand = {
         console.log();
         for (const prep of preparations) {
             const sourceLabel = prep.source?.locator ?? prep.source_path ?? "(no source)";
-            const method = prep.method_id ?? "(no Build Plan)";
+            const buildPlan = prep.build_plan_id ?? "(no Build Plan)";
             const readiness = prep.readiness?.status ?? "—";
             const requested = prep.requested_artifacts?.length ?? 0;
             console.log(`  ${prep.id}`);
             console.log(chalk.dim(`    source: ${sourceLabel}`));
-            console.log(chalk.dim(`    Build Plan: ${method}`));
+            console.log(chalk.dim(`    Build Plan: ${buildPlan}`));
             console.log(chalk.dim(`    requested Artifacts: ${requested}`));
             console.log(chalk.dim(`    readiness: ${readiness}`));
         }
@@ -166,7 +166,7 @@ export const prepCommand = {
         .command("create <prep-id>", "Create a Preparation (Build Plan optional — select or draft it later)", (y) => y
         .positional("prep-id", { type: "string", demandOption: true, describe: "Preparation id (lowercase, dash-separated)" })
         .option("source", { type: "string", demandOption: true, describe: "Path to the Source" })
-        .option("method", { type: "string", describe: "Build Plan / Method package id. Optional — bind later via `interf prep set-method`." })
+        .option("build-plan", { type: "string", describe: "Build Plan id. Optional — select later with `interf build-plan select`." })
         .option("about", { type: "string", describe: "One-line description of the agent work" })
         .option("requested-artifacts-json", { type: "string", describe: "JSON array of requested Artifacts for this Preparation" })
         .option("source-profile-json", { type: "string", describe: "JSON object describing the agent's advisory source profile" }), async (args) => {
@@ -177,7 +177,7 @@ export const prepCommand = {
         const requestBody = {
             id: args.prepId,
             source: { kind: "local-folder", locator: sourceAbs },
-            ...(args.method ? { method_id: args.method } : {}),
+            ...(args.buildPlan ? { build_plan_id: args.buildPlan } : {}),
             about: args.about,
             ...(requestedArtifacts ? { requested_artifacts: requestedArtifacts } : {}),
             ...(sourceProfile ? { source_profile: sourceProfile } : {}),
@@ -191,27 +191,14 @@ export const prepCommand = {
             process.exit(1);
         }
         console.log(chalk.green(`Created preparation ${chalk.bold(args.prepId)}.`));
-        if (!args.method) {
-            console.log(chalk.dim(`  no Build Plan selected yet — pick or draft one before compiling:`));
-            console.log(chalk.dim(`    interf prep set-method ${args.prepId} <method-id>`));
-            console.log(chalk.dim(`    interf method draft ${args.prepId}`));
+        if (!args.buildPlan) {
+            console.log(chalk.dim(`  no Build Plan selected yet — pick or draft one before building:`));
+            console.log(chalk.dim(`    interf build-plan select ${args.prepId} <build-plan-id>`));
+            console.log(chalk.dim(`    interf build-plan draft ${args.prepId}`));
         }
-        if (body?.method_id && body?.portable_context?.value) {
-            console.log(chalk.dim(`  portable context (locator): ${body.portable_context.value}`));
+        if (body?.build_plan_id && body?.verifiable_context?.value) {
+            console.log(chalk.dim(`  verifiable context (locator): ${body.verifiable_context.value}`));
         }
-    })
-        .command("set-method <prep-id> <method-id>", "Select a Build Plan / Method package for a Preparation", (y) => y
-        .positional("prep-id", { type: "string", demandOption: true, describe: "Preparation id" })
-        .positional("method-id", { type: "string", demandOption: true, describe: "Build Plan / Method package id to select" }), async (args) => {
-        const { url, token } = requireConnection(args);
-        const { status, raw } = await callJson(`${url}${preparationResourcePath(args.prepId)}`, token, { method: "PATCH", body: JSON.stringify({ method_id: args.methodId }) });
-        if (status !== 200) {
-            console.error(chalk.red(`Failed to set method (HTTP ${status}).`));
-            if (raw)
-                console.error(raw);
-            process.exit(1);
-        }
-        console.log(chalk.green(`Selected Build Plan ${chalk.bold(args.methodId)} for ${chalk.bold(args.prepId)}.`));
     })
         .command("show <prep-id>", "Show a preparation's full record", (y) => y
         .positional("prep-id", { type: "string", demandOption: true, describe: "Preparation id" })

package/dist/cli/commands/reset.d.ts

@@ -1,7 +1,7 @@
 import type { CommandModule } from "yargs";
 interface ResetArgs {
     prepId: string;
-    mode?: "compile" | "all";
+    mode?: "build" | "all";
     url?: string;
     token?: string;
 }

package/dist/cli/commands/reset.js

@@ -1,8 +1,8 @@
 /**
- * `interf reset <prep-id>` — reset a preparation's compile output (or all state).
+ * `interf reset <prep-id>` — reset a preparation's built output (or all state).
  *
- *   interf reset bristol             # default mode = compile
- *   interf reset bristol --mode all  # also clear method draft / runs
+ *   interf reset bristol             # default mode = build
+ *   interf reset bristol --mode all  # also clear Build Plan draft / runs
  */
 import chalk from "chalk";
 import { CONNECT_OR_ERROR_HINT, readActiveConnection } from "../../packages/engine/connection-config.js";
@@ -29,13 +29,13 @@ async function callJson(url, token, init = {}) {
 }
 export const resetCommand = {
     command: "reset <prep-id>",
-    describe: "Reset a preparation's compile output",
+    describe: "Reset a preparation's built output",
     builder: (yargs) => yargs
         .positional("prep-id", { type: "string", demandOption: true, describe: "Preparation id" })
         .option("mode", {
         type: "string",
-        choices: ["compile", "all"],
-        default: "compile",
+        choices: ["build", "all"],
+        default: "build",
         describe: "Scope of the reset",
     })
         .option("url", { type: "string", describe: "Override the active connection URL" })

package/dist/cli/commands/runs.js

@@ -4,11 +4,8 @@
  *   interf runs ls [--prep <id>]
  *   interf runs status <run-id>
  *   interf runs cancel <run-id>
- *   interf runs fetch <run-id> --to <path>
  */
 import chalk from "chalk";
-import { mkdirSync, writeFileSync } from "node:fs";
-import { dirname, isAbsolute, resolve } from "node:path";
 import { CONNECT_OR_ERROR_HINT, readActiveConnection } from "../../packages/engine/connection-config.js";
 function resolveConnection(args) {
     const conn = readActiveConnection({
@@ -59,16 +56,16 @@ function renderRunStatus(run) {
         console.log(chalk.dim(`    type: ${run.run_type}`));
     if (run.preparation)
         console.log(chalk.dim(`    preparation: ${run.preparation}`));
-    if (run.method)
-        console.log(chalk.dim(`    Build Plan: ${run.method}`));
+    if (run.build_plan)
+        console.log(chalk.dim(`    Build Plan: ${run.build_plan}`));
     if (run.agent_label)
         console.log(chalk.dim(`    agent: ${run.agent_label}`));
     if (run.started_at)
         console.log(chalk.dim(`    started: ${run.started_at}`));
     if (run.finished_at)
         console.log(chalk.dim(`    finished: ${run.finished_at}`));
-    if (run.output_path ?? run.portable_context_path) {
-        console.log(chalk.dim(`    output: ${run.output_path ?? run.portable_context_path}`));
+    if (run.output_path ?? run.verifiable_context_path) {
+        console.log(chalk.dim(`    output: ${run.output_path ?? run.verifiable_context_path}`));
     }
     if (run.trace?.run?.error?.message) {
         console.log();
@@ -139,8 +136,7 @@ export const runsCommand = {
                 console.error(raw);
             process.exit(1);
         }
-        const runs = body?.runs
-            ?? (body?.compile_runs ?? []).map((r) => r.run).filter(Boolean);
+        const runs = body?.runs ?? [];
         const visibleRuns = args.prep
             ? runs.filter((run) => run.preparation === args.prep)
             : runs;
@@ -179,7 +175,7 @@ export const runsCommand = {
     })
         .command("cancel <run-id>", "Cancel a running run", (y) => y.positional("run-id", { type: "string", demandOption: true, describe: "Run id" }), async (args) => {
         const { url, token } = resolveConnection(args);
-        const { status, raw } = await callJson(`${url}/v1/runs/${encodeURIComponent(args.runId)}/cancel`, token, { method: "POST", body: JSON.stringify({}) });
+        const { status, raw } = await callJson(`${url}/v1/build-runs/${encodeURIComponent(args.runId)}/cancel`, token, { method: "POST", body: JSON.stringify({}) });
         if (status !== 200 && status !== 202 && status !== 204) {
             console.error(chalk.red(`Failed to cancel ${args.runId} (HTTP ${status}).`));
             if (raw)
@@ -187,24 +183,6 @@ export const runsCommand = {
             process.exit(1);
         }
         console.log(chalk.green(`Cancelled ${chalk.bold(args.runId)}.`));
-    })
-        .command("fetch <run-id>", "Download a run's portable context", (y) => y
-        .positional("run-id", { type: "string", demandOption: true, describe: "Run id" })
-        .option("to", { type: "string", demandOption: true, describe: "Target path" }), async (args) => {
-        const { url, token } = resolveConnection(args);
-        const headers = new Headers();
-        if (token)
-            headers.set("authorization", `Bearer ${token}`);
-        const response = await fetch(`${url}/v1/runs/${encodeURIComponent(args.runId)}/artifacts/portable-context`, { headers });
-        if (response.status !== 200) {
-            console.error(chalk.red(`Failed to fetch artifact (HTTP ${response.status}).`));
-            process.exit(1);
-        }
-        const target = isAbsolute(args.to) ? args.to : resolve(process.cwd(), args.to);
-        mkdirSync(dirname(target), { recursive: true });
-        const buffer = Buffer.from(await response.arrayBuffer());
-        writeFileSync(target, buffer);
-        console.log(chalk.green(`Wrote ${target} (${buffer.length} bytes).`));
     })
         .demandCommand(1)
         .strict(),

package/dist/cli/commands/status.js

@@ -69,7 +69,7 @@ export const statusCommand = {
         else {
             for (const prep of list) {
                 const readiness = prep.readiness?.status ?? "—";
-                const buildPlan = prep.method_id ?? "no Build Plan";
+                const buildPlan = prep.build_plan_id ?? "no Build Plan";
                 const requested = prep.requested_artifacts?.length ?? 0;
                 console.log(`  ${chalk.bold(prep.id)} ${chalk.dim(`(${buildPlan} · ${requested} requested · ${readiness})`)}`);
                 console.log(chalk.dim(`    source: ${prep.source.locator}`));

package/dist/cli/commands/test.d.ts

@@ -1,5 +1,5 @@
 import type { CommandModule } from "yargs";
-type TestTarget = "compiled" | "source-files";
+type TestTarget = "verifiable-context" | "source-files";
 interface TestArgs {
     prepId: string;
     target?: TestTarget;

package/dist/cli/commands/test.js

@@ -1,9 +1,9 @@
 /**
  * `interf test <prep-id>` — run readiness checks for a Preparation via a
- * judge against the latest portable context (default) or against the source
+ * judge against the latest verifiable context (default) or against the source
  * baseline (`--target source-files`). The source-files target reveals how
- * much value the Method adds. Together with Method Artifact checks
- * (auto-run on every `interf compile`), this feeds the Preparation's
+ * much value the Build Plan adds. Together with Build Plan Artifact checks
+ * (auto-run on every `interf build`), this feeds the Preparation's
  * overall readiness state.
  *
  *   interf test bristol
@@ -43,14 +43,14 @@ async function callJson(url, token, init = {}) {
 }
 export const testCommand = {
     command: "test <prep-id>",
-    describe: "Run readiness checks against a Preparation's portable context (or source-files baseline)",
+    describe: "Run readiness checks against a Preparation's verifiable context (or source-files baseline)",
     builder: (yargs) => yargs
         .positional("prep-id", { type: "string", demandOption: true, describe: "Preparation id" })
         .option("target", {
         type: "string",
-        choices: ["compiled", "source-files"],
-        default: "compiled",
-        describe: "Judge target: 'compiled' (default) checks the portable context, 'source-files' checks the raw Source baseline",
+        choices: ["verifiable-context", "source-files"],
+        default: "verifiable-context",
+        describe: "Judge target: 'verifiable-context' (default) checks built output, 'source-files' checks the raw Source baseline",
     })
         .option("url", { type: "string", describe: "Override the active connection URL" })
         .option("token", { type: "string", describe: "Override the active bearer token" }),
@@ -65,7 +65,7 @@ export const testCommand = {
             console.error("  register a custom CLI: `interf agents register <name> --command <cmd>`.");
             process.exit(1);
         }
-        const target = args.target ?? "compiled";
+        const target = args.target ?? "verifiable-context";
         const { status, body, raw } = await callJson(`${url}/v1/preparations/${encodeURIComponent(args.prepId)}/verify-runs`, token, { method: "POST", body: JSON.stringify({ target }) });
         if (status !== 201 && status !== 200) {
             console.error(chalk.red(`Failed to start readiness-check run for ${args.prepId} (HTTP ${status}).`));

package/dist/cli/commands/web.js

@@ -67,7 +67,7 @@ async function runWebForeground(args) {
     };
     console.log();
     console.log(`  Interf engine: ${chalk.bold(service.url)}`);
-    console.log(`  Compiler UI:   ${service.url}/`);
+    console.log(`  Interf UI:     ${service.url}/`);
     console.log(`  Health:        ${service.url}/health`);
     console.log(chalk.dim("  Press Ctrl-C to stop."));
     console.log();
@@ -105,7 +105,7 @@ async function runWebStart(args) {
     if (await isEngineReachable(url)) {
         writeConnection({ url, auth_token: null });
         console.log(chalk.green(`Interf engine already running at ${chalk.bold(url)}.`));
-        console.log(`Compiler UI: ${url}/`);
+        console.log(`Interf UI: ${url}/`);
         return;
     }
     const binPath = process.argv[1];
@@ -139,7 +139,7 @@ async function runWebStart(args) {
     }
     writeConnection({ url, auth_token: null });
     console.log(chalk.green(`Started Interf engine at ${chalk.bold(url)}.`));
-    console.log(`Compiler UI: ${url}/`);
+    console.log(`Interf UI: ${url}/`);
     console.log(`Log: ${logPath}`);
     console.log(chalk.dim(`Stop it with \`interf web stop\`.`));
 }