@interf/compiler 0.22.2 → 0.50.0

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

@@ -1,2 +0,0 @@
-import type { CommandModule } from "yargs";
-export declare const prepCommand: CommandModule;

package/dist/cli/commands/prep.js

@@ -1,240 +0,0 @@
-/**
- * `interf prep` — preparation CRUD against a connected instance.
- *
- *   interf prep ls
- *   interf prep create <id> --source <path> [--build-plan <id>] [--about <text>]
- *   interf prep show <id>
- *   interf prep rm <id>
- *
- * Every subcommand requires an active connection. If `~/.interf/connection.json`
- * is missing or unreachable, the command exits non-zero with the
- * connect-or-error hint.
- */
-import { resolve } from "node:path";
-import chalk from "chalk";
-import { CONNECT_OR_ERROR_HINT, readActiveConnection, } from "../../packages/engine/connection-config.js";
-import { preparationResourcePath } from "../../packages/engine/routes.js";
-import { requestedArtifactCheckLabel } from "../../packages/engine/requested-artifacts.js";
-import { RequestedArtifactSchema, SourceProfileSchema, } from "../../packages/project/lib/schema.js";
-function requireConnection(args) {
-    const conn = readActiveConnection({
-        urlOverride: args.url,
-        authTokenOverride: args.token,
-    });
-    if (!conn) {
-        console.error(CONNECT_OR_ERROR_HINT);
-        process.exit(1);
-    }
-    return { url: conn.url.replace(/\/+$/, ""), token: conn.auth_token };
-}
-async function callJson(url, token, init = {}) {
-    const headers = new Headers(init.headers ?? {});
-    if (token)
-        headers.set("authorization", `Bearer ${token}`);
-    if (init.body && !headers.has("content-type")) {
-        headers.set("content-type", "application/json");
-    }
-    const response = await fetch(url, { ...init, headers });
-    const raw = await response.text();
-    let body = null;
-    if (raw.length > 0) {
-        try {
-            body = JSON.parse(raw);
-        }
-        catch {
-            body = null;
-        }
-    }
-    return { status: response.status, body, raw };
-}
-const RequestedArtifactsCliSchema = RequestedArtifactSchema.array();
-function parseJsonOption(label, value, parse) {
-    if (!value)
-        return undefined;
-    let parsed;
-    try {
-        parsed = JSON.parse(value);
-    }
-    catch (error) {
-        console.error(chalk.red(`Invalid JSON for ${label}.`));
-        console.error(chalk.dim(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-    try {
-        return parse(parsed);
-    }
-    catch (error) {
-        console.error(chalk.red(`Invalid ${label}.`));
-        console.error(chalk.dim(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-}
-function statusColor(status) {
-    if (status === "ready")
-        return chalk.green;
-    if (status === "failed")
-        return chalk.red;
-    if (status === "skipped")
-        return chalk.dim;
-    return chalk.yellow;
-}
-function renderPreparationSummary(prep) {
-    console.log();
-    console.log(`  ${chalk.bold(prep.name)}`);
-    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.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;
-        console.log(`    readiness: ${aggColor(prep.readiness.status)}${prep.readiness.summary ? chalk.dim(` (${prep.readiness.summary})`) : ""}`);
-    }
-    if (prep.artifacts && prep.artifacts.length > 0) {
-        console.log();
-        console.log(chalk.bold("    Artifacts"));
-        const idWidth = Math.max(...prep.artifacts.map((entry) => entry.artifact_id.length), 8);
-        for (const artifact of prep.artifacts) {
-            const colored = statusColor(artifact.status)(artifact.status);
-            const stages = artifact.built_by_stages && artifact.built_by_stages.length > 0
-                ? chalk.dim(` ← ${artifact.built_by_stages.join(", ")}`)
-                : "";
-            console.log(`      ${artifact.artifact_id.padEnd(idWidth)}  ${colored}${stages}`);
-        }
-    }
-    if (prep.requested_artifacts && prep.requested_artifacts.length > 0) {
-        console.log();
-        console.log(chalk.bold("    Requested Artifacts"));
-        for (const artifact of prep.requested_artifacts) {
-            console.log(`      ${chalk.bold(artifact.title)}`);
-            if (artifact.purpose ?? artifact.description) {
-                console.log(chalk.dim(`        ${artifact.purpose ?? artifact.description}`));
-            }
-            const checks = artifact.checks ?? [];
-            for (const check of checks.slice(0, 4)) {
-                console.log(chalk.dim(`        - ${requestedArtifactCheckLabel(check)}`));
-            }
-        }
-    }
-    if (prep.latest_build_run_id) {
-        console.log();
-        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}`));
-    }
-    console.log();
-    console.log(chalk.dim(`  Run with --json for the raw resource record.`));
-    console.log();
-}
-export const prepCommand = {
-    command: "prep <subcommand>",
-    describe: "Manage preparations on the connected instance",
-    builder: (yargs) => yargs
-        .option("url", { type: "string", describe: "Override the active connection URL" })
-        .option("token", { type: "string", describe: "Override the active bearer token" })
-        .command("ls", "List preparations", (y) => y, async (args) => {
-        const { url, token } = requireConnection(args);
-        const { status, body, raw } = await callJson(`${url}/v1/preparations`, token);
-        if (status !== 200 || !body) {
-            console.error(chalk.red(`Failed to list preparations (HTTP ${status}).`));
-            if (raw)
-                console.error(raw);
-            process.exit(1);
-        }
-        const preparations = body.preparations ?? [];
-        if (preparations.length === 0) {
-            console.log(chalk.dim("  No preparations yet. Create one with `interf prep create <id> --source <path>`."));
-            return;
-        }
-        console.log();
-        console.log(chalk.bold("  Preparations"));
-        console.log();
-        for (const prep of preparations) {
-            const sourceLabel = prep.source?.locator ?? prep.source_path ?? "(no source)";
-            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: ${buildPlan}`));
-            console.log(chalk.dim(`    requested Artifacts: ${requested}`));
-            console.log(chalk.dim(`    readiness: ${readiness}`));
-        }
-    })
-        .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("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) => {
-        const { url, token } = requireConnection(args);
-        const sourceAbs = resolve(process.cwd(), args.source);
-        const requestedArtifacts = parseJsonOption("--requested-artifacts-json", args.requestedArtifactsJson, (input) => RequestedArtifactsCliSchema.parse(input));
-        const sourceProfile = parseJsonOption("--source-profile-json", args.sourceProfileJson, (input) => SourceProfileSchema.parse(input));
-        const requestBody = {
-            id: args.prepId,
-            source: { kind: "local-folder", locator: sourceAbs },
-            ...(args.buildPlan ? { build_plan_id: args.buildPlan } : {}),
-            about: args.about,
-            ...(requestedArtifacts ? { requested_artifacts: requestedArtifacts } : {}),
-            ...(sourceProfile ? { source_profile: sourceProfile } : {}),
-            checks: [],
-        };
-        const { status, body, raw } = await callJson(`${url}/v1/preparations`, token, { method: "POST", body: JSON.stringify(requestBody) });
-        if (status !== 201 && status !== 200) {
-            console.error(chalk.red(`Failed to create preparation (HTTP ${status}).`));
-            if (raw)
-                console.error(raw);
-            process.exit(1);
-        }
-        console.log(chalk.green(`Created preparation ${chalk.bold(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?.build_plan_id && body?.verifiable_context?.value) {
-            console.log(chalk.dim(`  verifiable context (locator): ${body.verifiable_context.value}`));
-        }
-    })
-        .command("show <prep-id>", "Show a preparation's full record", (y) => y
-        .positional("prep-id", { type: "string", demandOption: true, describe: "Preparation id" })
-        .option("json", {
-        type: "boolean",
-        default: false,
-        describe: "Print the raw JSON record instead of the formatted summary",
-    }), async (args) => {
-        const { url, token } = requireConnection(args);
-        const { status, body, raw } = await callJson(`${url}${preparationResourcePath(args.prepId)}`, token);
-        if (status !== 200) {
-            console.error(chalk.red(`Failed to read preparation ${args.prepId} (HTTP ${status}).`));
-            if (raw)
-                console.error(raw);
-            process.exit(1);
-        }
-        if (args.json || !body) {
-            console.log(JSON.stringify(body, null, 2));
-            return;
-        }
-        renderPreparationSummary(body);
-    })
-        .command("rm <prep-id>", "Delete a preparation", (y) => y.positional("prep-id", { type: "string", demandOption: true, describe: "Preparation id" }), async (args) => {
-        const { url, token } = requireConnection(args);
-        const { status, raw } = await callJson(`${url}${preparationResourcePath(args.prepId)}`, token, { method: "DELETE" });
-        if (status !== 200 && status !== 204) {
-            console.error(chalk.red(`Failed to delete preparation ${args.prepId} (HTTP ${status}).`));
-            if (raw)
-                console.error(raw);
-            process.exit(1);
-        }
-        console.log(chalk.green(`Deleted preparation ${chalk.bold(args.prepId)}.`));
-    })
-        .demandCommand(1)
-        .strict(),
-    handler: () => {
-        /* yargs subcommand handlers do the work */
-    },
-};

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

@@ -1,10 +0,0 @@
-import type { CommandModule } from "yargs";
-type TestTarget = "verifiable-context" | "source-files";
-interface TestArgs {
-    prepId: string;
-    target?: TestTarget;
-    url?: string;
-    token?: string;
-}
-export declare const testCommand: CommandModule<unknown, TestArgs>;
-export {};

package/dist/cli/commands/test.js

@@ -1,85 +0,0 @@
-/**
- * `interf test <prep-id>` — run readiness checks for a Preparation via a
- * judge against the latest verifiable context (default) or against the source
- * baseline (`--target source-files`). The source-files target reveals how
- * 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
- *   interf test bristol --target source-files
- */
-import chalk from "chalk";
-import { CONNECT_OR_ERROR_HINT, readActiveConnection } from "../../packages/engine/connection-config.js";
-function resolveConnection(args) {
-    const conn = readActiveConnection({
-        urlOverride: args.url,
-        authTokenOverride: args.token,
-    });
-    if (!conn) {
-        console.error(CONNECT_OR_ERROR_HINT);
-        process.exit(1);
-    }
-    return { url: conn.url.replace(/\/+$/, ""), token: conn.auth_token };
-}
-async function callJson(url, token, init = {}) {
-    const headers = new Headers(init.headers ?? {});
-    if (token)
-        headers.set("authorization", `Bearer ${token}`);
-    if (init.body && !headers.has("content-type"))
-        headers.set("content-type", "application/json");
-    const response = await fetch(url, { ...init, headers });
-    const raw = await response.text();
-    let body = null;
-    if (raw.length > 0) {
-        try {
-            body = JSON.parse(raw);
-        }
-        catch {
-            body = null;
-        }
-    }
-    return { status: response.status, body, raw };
-}
-export const testCommand = {
-    command: "test <prep-id>",
-    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: ["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" }),
-    handler: async (args) => {
-        const { url, token } = resolveConnection(args);
-        // 0.15 hard-error: refuse to start a readiness-check run if the engine
-        // has zero connected agents — verifier-role stages can't run without one.
-        const instance = await callJson(`${url}/v1/instance`, token);
-        if (instance.body && instance.body.agent_count === 0) {
-            console.error(chalk.red("  Cannot run readiness checks — no agents available."));
-            console.error("  Install Claude Code, Codex, Gemini, or another agent CLI, or");
-            console.error("  register a custom CLI: `interf agents register <name> --command <cmd>`.");
-            process.exit(1);
-        }
-        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}).`));
-            if (raw)
-                console.error(raw);
-            process.exit(1);
-        }
-        console.log();
-        console.log(`  Run ${chalk.bold(body?.run_id ?? "(?)")} ${chalk.dim(`(${body?.status ?? "started"})`)}`);
-        console.log(`  Target: ${target}`);
-        if (body?.readiness?.status)
-            console.log(`  Readiness: ${body.readiness.status}`);
-        if (body?.error)
-            console.log(chalk.red(`  Error: ${body.error}`));
-        console.log();
-    },
-};

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

@@ -1,2 +0,0 @@
-import type { CommandModule } from "yargs";
-export declare const webCommand: CommandModule;

package/dist/cli/commands/web.js

@@ -1,286 +0,0 @@
-/**
- * `interf web` — start the engine in the foreground until Ctrl-C.
- *
- *   interf web                # start on default port; hard error if port busy
- *   interf web start          # start the engine in the background
- *   interf web stop           # send SIGTERM to the running engine
- *   interf web status         # print engine info via the connected URL
- *
- * Pure server. No reuse / register-with-existing logic. Writes
- * `~/.interf/connection.json` on startup so subsequent CLI commands can
- * connect without a pointer file.
- */
-import chalk from "chalk";
-import { closeSync, mkdirSync, openSync, readFileSync } from "node:fs";
-import { spawn } from "node:child_process";
-import { dirname } from "node:path";
-import { LOCAL_SERVICE_DEFAULT_HOST, LOCAL_SERVICE_DEFAULT_PORT, buildLocalServiceUrl, } from "../../packages/engine/routes.js";
-import { startLocalService } from "../../packages/engine/server.js";
-import { createNativeLocalServiceRunHandlers } from "../../packages/engine/native-run-handlers.js";
-import { CONNECT_OR_ERROR_HINT, clearConnection, readActiveConnection, writeConnection, } from "../../packages/engine/connection-config.js";
-import { serviceRegistryPath } from "../../packages/engine/instance-paths.js";
-function packageVersionFromManifest() {
-    try {
-        const url = new URL("../../../package.json", import.meta.url);
-        const raw = readFileSync(url, "utf8");
-        const parsed = JSON.parse(raw);
-        return parsed.version;
-    }
-    catch {
-        return undefined;
-    }
-}
-function isPortInUseError(error) {
-    if (!error || typeof error !== "object")
-        return false;
-    const code = error.code;
-    return code === "EADDRINUSE";
-}
-async function runWebForeground(args) {
-    const host = args.host ?? LOCAL_SERVICE_DEFAULT_HOST;
-    const port = args.port ?? LOCAL_SERVICE_DEFAULT_PORT;
-    let service;
-    try {
-        service = await startLocalService({
-            host,
-            port,
-            packageVersion: packageVersionFromManifest(),
-            handlers: createNativeLocalServiceRunHandlers(),
-        });
-    }
-    catch (error) {
-        if (isPortInUseError(error)) {
-            console.error(chalk.red(`Error: another Interf engine is already running at ${buildLocalServiceUrl({ host, port })}.`));
-            console.error(`Stop it first with \`interf web stop\`.`);
-            process.exit(1);
-        }
-        throw error;
-    }
-    const shutdown = async () => {
-        try {
-            await service.close();
-        }
-        catch {
-            // best effort
-        }
-        process.exit(0);
-    };
-    console.log();
-    console.log(`  Interf engine: ${chalk.bold(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();
-    process.on("SIGINT", shutdown);
-    process.on("SIGTERM", shutdown);
-    await new Promise(() => {
-        /* block forever; signals trigger shutdown */
-    });
-}
-async function isEngineReachable(url) {
-    try {
-        const response = await fetch(`${url}/health`);
-        return response.status === 200;
-    }
-    catch {
-        return false;
-    }
-}
-async function waitForEngine(url, timeoutMs) {
-    const started = Date.now();
-    while (Date.now() - started < timeoutMs) {
-        if (await isEngineReachable(url))
-            return true;
-        await new Promise((resolveWait) => setTimeout(resolveWait, 150));
-    }
-    return false;
-}
-function managedWebLogPath(port) {
-    return `${dirname(serviceRegistryPath())}/interf-web-${port}.log`;
-}
-async function runWebStart(args) {
-    const host = args.host ?? LOCAL_SERVICE_DEFAULT_HOST;
-    const port = args.port ?? LOCAL_SERVICE_DEFAULT_PORT;
-    const url = buildLocalServiceUrl({ host, port });
-    if (await isEngineReachable(url)) {
-        writeConnection({ url, auth_token: null });
-        console.log(chalk.green(`Interf engine already running at ${chalk.bold(url)}.`));
-        console.log(`Interf UI: ${url}/`);
-        return;
-    }
-    const binPath = process.argv[1];
-    if (!binPath) {
-        console.error(chalk.red("Cannot locate the Interf CLI entrypoint for managed start."));
-        console.error(`Try running \`interf web\` in a separate terminal instead.`);
-        process.exit(1);
-    }
-    const logPath = args.log ?? managedWebLogPath(port);
-    mkdirSync(dirname(logPath), { recursive: true });
-    const stdoutFd = openSync(logPath, "a");
-    const stderrFd = openSync(logPath, "a");
-    let child;
-    try {
-        child = spawn(process.execPath, [binPath, "web", "--host", host, "--port", String(port)], {
-            detached: true,
-            stdio: ["ignore", stdoutFd, stderrFd],
-            env: process.env,
-        });
-        child.unref();
-    }
-    finally {
-        closeSync(stdoutFd);
-        closeSync(stderrFd);
-    }
-    const ready = await waitForEngine(url, args.timeoutMs ?? 5000);
-    if (!ready) {
-        console.error(chalk.red(`Timed out waiting for Interf engine at ${url}.`));
-        console.error(`Log: ${logPath}`);
-        process.exit(1);
-    }
-    writeConnection({ url, auth_token: null });
-    console.log(chalk.green(`Started Interf engine at ${chalk.bold(url)}.`));
-    console.log(`Interf UI: ${url}/`);
-    console.log(`Log: ${logPath}`);
-    console.log(chalk.dim(`Stop it with \`interf web stop\`.`));
-}
-function findEnginePidByUrl(url) {
-    try {
-        const raw = readFileSync(serviceRegistryPath(), "utf8");
-        const parsed = JSON.parse(raw);
-        const entry = parsed.services?.find((s) => s.url === url);
-        return entry?.pid ?? null;
-    }
-    catch {
-        return null;
-    }
-}
-function isPidAlive(pid) {
-    try {
-        // Signal 0 is a no-op probe — succeeds if the PID exists and we can
-        // signal it; throws ESRCH otherwise.
-        process.kill(pid, 0);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Scan ~/.interf/services.json for engines whose PID is still alive.
- * Used by `interf web stop` when ~/.interf/connection.json is missing
- * — the registry tells us which engine processes are actually running
- * regardless of which one the wizard last connected to.
- */
-function listLiveEnginesFromRegistry() {
-    try {
-        const raw = readFileSync(serviceRegistryPath(), "utf8");
-        const parsed = JSON.parse(raw);
-        return (parsed.services ?? []).filter((entry) => typeof entry.pid === "number" && isPidAlive(entry.pid));
-    }
-    catch {
-        return [];
-    }
-}
-async function runWebStop(args) {
-    // Resolution order: explicit --url override → active connection.json
-    // → fall back to scanning services.json for any live engine. The
-    // last fallback recovers from the case where connection.json was
-    // cleared while an engine was still running (e.g. another `interf
-    // web` attempt failed mid-startup, or `interf logout` was run while
-    // the engine kept going).
-    const conn = readActiveConnection({
-        urlOverride: args.url,
-        authTokenOverride: args.token,
-    });
-    let urlToStop = conn ? conn.url.replace(/\/+$/, "") : null;
-    let pidToStop = urlToStop ? findEnginePidByUrl(urlToStop) : null;
-    if (!pidToStop) {
-        const liveEngines = listLiveEnginesFromRegistry();
-        if (liveEngines.length === 0) {
-            console.error("No live Interf engine to stop.");
-            console.error("Checked ~/.interf/connection.json and ~/.interf/services.json — neither pointed at a running process.");
-            process.exit(1);
-        }
-        if (liveEngines.length > 1 && !urlToStop) {
-            console.error(`Multiple live Interf engines registered. Pick one with --url:`);
-            for (const entry of liveEngines) {
-                console.error(`  ${entry.url} (pid ${entry.pid})`);
-            }
-            process.exit(1);
-        }
-        const target = urlToStop
-            ? liveEngines.find((entry) => entry.url === urlToStop)
-            : liveEngines[0];
-        if (!target) {
-            console.error(`No live engine matches ${urlToStop ?? "the active connection"} in services.json.`);
-            process.exit(1);
-        }
-        urlToStop = target.url;
-        pidToStop = target.pid;
-        if (!conn) {
-            console.log(chalk.dim(`  No active connection.json — recovering engine pid ${pidToStop} from services.json.`));
-        }
-    }
-    try {
-        process.kill(pidToStop, "SIGTERM");
-        console.log(chalk.green(`Sent SIGTERM to engine pid ${pidToStop} (${urlToStop}).`));
-        if (conn)
-            clearConnection();
-    }
-    catch (error) {
-        console.error(`Failed to stop engine pid ${pidToStop}: ${error instanceof Error ? error.message : String(error)}`);
-        process.exit(1);
-    }
-}
-async function runWebStatus(args) {
-    const conn = readActiveConnection({
-        urlOverride: args.url,
-        authTokenOverride: args.token,
-    });
-    if (!conn) {
-        console.error(CONNECT_OR_ERROR_HINT);
-        process.exit(1);
-    }
-    const url = conn.url.replace(/\/+$/, "");
-    try {
-        const headers = new Headers();
-        if (conn.auth_token)
-            headers.set("authorization", `Bearer ${conn.auth_token}`);
-        const response = await fetch(`${url}/v1/instance`, { headers });
-        const raw = await response.text();
-        if (response.status !== 200) {
-            console.error(chalk.red(`Engine status request failed (HTTP ${response.status}).`));
-            if (raw)
-                console.error(raw);
-            process.exit(1);
-        }
-        console.log(raw);
-    }
-    catch (error) {
-        console.error(chalk.red(`Engine ${url} unreachable: ${error instanceof Error ? error.message : String(error)}`));
-        process.exit(1);
-    }
-}
-export const webCommand = {
-    command: "web [subcommand]",
-    describe: "Start / stop / inspect the Interf engine",
-    builder: (yargs) => yargs
-        .command("start", "Start the engine in the background", (y) => y
-        .option("host", { type: "string", default: LOCAL_SERVICE_DEFAULT_HOST, describe: "Host to bind" })
-        .option("port", { type: "number", default: LOCAL_SERVICE_DEFAULT_PORT, describe: "Port to bind" })
-        .option("timeout-ms", { type: "number", default: 5000, describe: "How long to wait for startup" })
-        .option("log", { type: "string", describe: "Path to write background engine logs" }), runWebStart)
-        .command("stop", "Stop the connected engine", (y) => y
-        .option("url", { type: "string", describe: "Override the active connection URL" })
-        .option("token", { type: "string", describe: "Override the active bearer token" }), runWebStop)
-        .command("status", "Show engine status via the connected URL", (y) => y
-        .option("url", { type: "string", describe: "Override the active connection URL" })
-        .option("token", { type: "string", describe: "Override the active bearer token" }), runWebStatus)
-        .command("$0", "Start the engine in the foreground (default)", (y) => y
-        .option("host", { type: "string", default: LOCAL_SERVICE_DEFAULT_HOST, describe: "Host to bind" })
-        .option("port", { type: "number", default: LOCAL_SERVICE_DEFAULT_PORT, describe: "Port to bind" }), runWebForeground)
-        .strict(),
-    handler: () => {
-        /* yargs subcommand handlers do the work */
-    },
-};

package/dist/interf-ui/404.html

@@ -1 +0,0 @@
-<!DOCTYPE html><html class="dark geistsans_d5a4f12f-module__eFBk2G__variable geistmono_157ca88a-module__DegD4G__variable" lang="en"><head><meta charSet="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="/_next/static/chunks/0.tjb6f4golw..css" data-precedence="next"/><link rel="preload" as="script" fetchPriority="low" href="/_next/static/chunks/10jeodxe4nkgj.js"/><script src="/_next/static/chunks/15z_en80lrq-3.js" async=""></script><script src="/_next/static/chunks/13c8b~m8knjsf.js" async=""></script><script src="/_next/static/chunks/turbopack-0usj_75.8frlw.js" async=""></script><script src="/_next/static/chunks/0g-ea0zj5d-0k.js" async=""></script><meta name="robots" content="noindex"/><meta name="next-size-adjust" content=""/><title>404: This page could not be found.</title><title>Interf UI</title><meta name="description" content="Local Interf instance for Preparations, Build Plans, Build runs, readiness checks, and verifiable context."/><script src="/_next/static/chunks/03~yq9q893hmn.js" noModule=""></script></head><body><div hidden=""><!--$--><!--/$--></div><div style="font-family:system-ui,&quot;Segoe UI&quot;,Roboto,Helvetica,Arial,sans-serif,&quot;Apple Color Emoji&quot;,&quot;Segoe UI Emoji&quot;;height:100vh;text-align:center;display:flex;flex-direction:column;align-items:center;justify-content:center"><div><style>body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}</style><h1 class="next-error-h1" style="display:inline-block;margin:0 20px 0 0;padding:0 23px 0 0;font-size:24px;font-weight:500;vertical-align:top;line-height:49px">404</h1><div style="display:inline-block"><h2 style="font-size:14px;font-weight:400;line-height:49px;margin:0">This page could not be found.</h2></div></div></div><!--$--><!--/$--><script src="/_next/static/chunks/10jeodxe4nkgj.js" id="_R_" async=""></script><script>(self.__next_f=self.__next_f||[]).push([0])</script><script>self.__next_f.push([1,"1:\"$Sreact.fragment\"\n2:I[58316,[\"/_next/static/chunks/0g-ea0zj5d-0k.js\"],\"default\"]\n3:I[87122,[\"/_next/static/chunks/0g-ea0zj5d-0k.js\"],\"default\"]\n4:I[36487,[\"/_next/static/chunks/0g-ea0zj5d-0k.js\"],\"OutletBoundary\"]\n5:\"$Sreact.suspense\"\n8:I[36487,[\"/_next/static/chunks/0g-ea0zj5d-0k.js\"],\"ViewportBoundary\"]\na:I[36487,[\"/_next/static/chunks/0g-ea0zj5d-0k.js\"],\"MetadataBoundary\"]\nc:I[74130,[\"/_next/static/chunks/0g-ea0zj5d-0k.js\"],\"default\",1]\n:HL[\"/_next/static/chunks/0.tjb6f4golw..css\",\"style\"]\n"])</script><script>self.__next_f.push([1,"0:{\"P\":null,\"c\":[\"\",\"_not-found\"],\"q\":\"\",\"i\":false,\"f\":[[[\"\",{\"children\":[\"/_not-found\",{\"children\":[\"__PAGE__\",{}]}]},\"$undefined\",\"$undefined\",16],[[\"$\",\"$1\",\"c\",{\"children\":[[[\"$\",\"link\",\"0\",{\"rel\":\"stylesheet\",\"href\":\"/_next/static/chunks/0.tjb6f4golw..css\",\"precedence\":\"next\",\"crossOrigin\":\"$undefined\",\"nonce\":\"$undefined\"}],[\"$\",\"script\",\"script-0\",{\"src\":\"/_next/static/chunks/0g-ea0zj5d-0k.js\",\"async\":true,\"nonce\":\"$undefined\"}]],[\"$\",\"html\",null,{\"className\":\"dark geistsans_d5a4f12f-module__eFBk2G__variable geistmono_157ca88a-module__DegD4G__variable\",\"lang\":\"en\",\"children\":[\"$\",\"body\",null,{\"children\":[\"$\",\"$L2\",null,{\"parallelRouterKey\":\"children\",\"error\":\"$undefined\",\"errorStyles\":\"$undefined\",\"errorScripts\":\"$undefined\",\"template\":[\"$\",\"$L3\",null,{}],\"templateStyles\":\"$undefined\",\"templateScripts\":\"$undefined\",\"notFound\":[[[\"$\",\"title\",null,{\"children\":\"404: This page could not be found.\"}],[\"$\",\"div\",null,{\"style\":{\"fontFamily\":\"system-ui,\\\"Segoe UI\\\",Roboto,Helvetica,Arial,sans-serif,\\\"Apple Color Emoji\\\",\\\"Segoe UI Emoji\\\"\",\"height\":\"100vh\",\"textAlign\":\"center\",\"display\":\"flex\",\"flexDirection\":\"column\",\"alignItems\":\"center\",\"justifyContent\":\"center\"},\"children\":[\"$\",\"div\",null,{\"children\":[[\"$\",\"style\",null,{\"dangerouslySetInnerHTML\":{\"__html\":\"body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}\"}}],[\"$\",\"h1\",null,{\"className\":\"next-error-h1\",\"style\":{\"display\":\"inline-block\",\"margin\":\"0 20px 0 0\",\"padding\":\"0 23px 0 0\",\"fontSize\":24,\"fontWeight\":500,\"verticalAlign\":\"top\",\"lineHeight\":\"49px\"},\"children\":404}],[\"$\",\"div\",null,{\"style\":{\"display\":\"inline-block\"},\"children\":[\"$\",\"h2\",null,{\"style\":{\"fontSize\":14,\"fontWeight\":400,\"lineHeight\":\"49px\",\"margin\":0},\"children\":\"This page could not be found.\"}]}]]}]}]],[]],\"forbidden\":\"$undefined\",\"unauthorized\":\"$undefined\"}]}]}]]}],{\"children\":[[\"$\",\"$1\",\"c\",{\"children\":[null,[\"$\",\"$L2\",null,{\"parallelRouterKey\":\"children\",\"error\":\"$undefined\",\"errorStyles\":\"$undefined\",\"errorScripts\":\"$undefined\",\"template\":[\"$\",\"$L3\",null,{}],\"templateStyles\":\"$undefined\",\"templateScripts\":\"$undefined\",\"notFound\":\"$undefined\",\"forbidden\":\"$undefined\",\"unauthorized\":\"$undefined\"}]]}],{\"children\":[[\"$\",\"$1\",\"c\",{\"children\":[[[\"$\",\"title\",null,{\"children\":\"404: This page could not be found.\"}],[\"$\",\"div\",null,{\"style\":\"$0:f:0:1:0:props:children:1:props:children:props:children:props:notFound:0:1:props:style\",\"children\":[\"$\",\"div\",null,{\"children\":[[\"$\",\"style\",null,{\"dangerouslySetInnerHTML\":{\"__html\":\"body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}\"}}],[\"$\",\"h1\",null,{\"className\":\"next-error-h1\",\"style\":\"$0:f:0:1:0:props:children:1:props:children:props:children:props:notFound:0:1:props:children:props:children:1:props:style\",\"children\":404}],[\"$\",\"div\",null,{\"style\":\"$0:f:0:1:0:props:children:1:props:children:props:children:props:notFound:0:1:props:children:props:children:2:props:style\",\"children\":[\"$\",\"h2\",null,{\"style\":\"$0:f:0:1:0:props:children:1:props:children:props:children:props:notFound:0:1:props:children:props:children:2:props:children:props:style\",\"children\":\"This page could not be found.\"}]}]]}]}]],null,[\"$\",\"$L4\",null,{\"children\":[\"$\",\"$5\",null,{\"name\":\"Next.MetadataOutlet\",\"children\":\"$@6\"}]}]]}],{},null,false,null]},null,false,\"$@7\"]},null,false,null],[\"$\",\"$1\",\"h\",{\"children\":[[\"$\",\"meta\",null,{\"name\":\"robots\",\"content\":\"noindex\"}],[\"$\",\"$L8\",null,{\"children\":\"$L9\"}],[\"$\",\"div\",null,{\"hidden\":true,\"children\":[\"$\",\"$La\",null,{\"children\":[\"$\",\"$5\",null,{\"name\":\"Next.Metadata\",\"children\":\"$Lb\"}]}]}],[\"$\",\"meta\",null,{\"name\":\"next-size-adjust\",\"content\":\"\"}]]}],false]],\"m\":\"$undefined\",\"G\":[\"$c\",[[\"$\",\"link\",\"0\",{\"rel\":\"stylesheet\",\"href\":\"/_next/static/chunks/0.tjb6f4golw..css\",\"precedence\":\"next\",\"crossOrigin\":\"$undefined\",\"nonce\":\"$undefined\"}]]],\"S\":true,\"h\":null,\"s\":\"$undefined\",\"l\":\"$undefined\",\"p\":\"$undefined\",\"d\":\"$undefined\",\"b\":\"--reS3xBzM5zc6QxNjZd6\"}\n"])</script><script>self.__next_f.push([1,"d:[]\n7:\"$Wd\"\n"])</script><script>self.__next_f.push([1,"9:[[\"$\",\"meta\",\"0\",{\"charSet\":\"utf-8\"}],[\"$\",\"meta\",\"1\",{\"name\":\"viewport\",\"content\":\"width=device-width, initial-scale=1\"}]]\n"])</script><script>self.__next_f.push([1,"6:null\nb:[[\"$\",\"title\",\"0\",{\"children\":\"Interf UI\"}],[\"$\",\"meta\",\"1\",{\"name\":\"description\",\"content\":\"Local Interf instance for Preparations, Build Plans, Build runs, readiness checks, and verifiable context.\"}]]\n"])</script></body></html>

package/dist/interf-ui/__next.__PAGE__.txt

@@ -1,10 +0,0 @@
-1:"$Sreact.fragment"
-2:I[30739,["/_next/static/chunks/0g-ea0zj5d-0k.js"],"ClientPageRoot"]
-3:I[71439,["/_next/static/chunks/0g-ea0zj5d-0k.js","/_next/static/chunks/0haldgm65ve6l.js","/_next/static/chunks/0dn41fa_zvgsl.js","/_next/static/chunks/0~a36ujuzpaz..js","/_next/static/chunks/14dznb2qpt-ho.js"],"default"]
-6:I[36487,["/_next/static/chunks/0g-ea0zj5d-0k.js"],"OutletBoundary"]
-7:"$Sreact.suspense"
-:HL["/_next/static/chunks/085-n_jv2ng_q.css","style"]
-0:{"rsc":["$","$1","c",{"children":[["$","$L2",null,{"Component":"$3","serverProvidedParams":{"searchParams":{},"params":{},"promises":["$@4","$@5"]}}],[["$","link","0",{"rel":"stylesheet","href":"/_next/static/chunks/085-n_jv2ng_q.css","precedence":"next"}],["$","script","script-0",{"src":"/_next/static/chunks/0haldgm65ve6l.js","async":true}],["$","script","script-1",{"src":"/_next/static/chunks/0dn41fa_zvgsl.js","async":true}],["$","script","script-2",{"src":"/_next/static/chunks/0~a36ujuzpaz..js","async":true}],["$","script","script-3",{"src":"/_next/static/chunks/14dznb2qpt-ho.js","async":true}]],["$","$L6",null,{"children":["$","$7",null,{"name":"Next.MetadataOutlet","children":"$@8"}]}]]}],"isPartial":false,"staleTime":300,"varyParams":null,"buildId":"--reS3xBzM5zc6QxNjZd6"}
-4:{}
-5:"$0:rsc:props:children:0:props:serverProvidedParams:params"
-8:null