@interf/compiler 0.33.0 → 0.50.0

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

@@ -1,11 +1,10 @@
 import type { CommandModule } from "yargs";
-interface BuildArgs {
+import { type ConnectionArgs } from "../lib/http-client.js";
+interface BuildArgs extends ConnectionArgs {
     projectId: string;
     watch?: boolean;
     quiet?: boolean;
     idempotencyKey?: string;
-    url?: string;
-    token?: string;
 }
 export declare const buildCommand: CommandModule<unknown, BuildArgs>;
 export {};

package/dist/cli/commands/build.js

@@ -8,38 +8,8 @@
  * Requires an active connection. Hits POST /v1/projects/<id>/build-runs.
  */
 import chalk from "chalk";
-import { CONNECT_OR_ERROR_HINT, readActiveConnection } from "../../packages/runtime/connection-config.js";
+import { callJson, resolveConnection } from "../lib/http-client.js";
 import { projectSubresourcePath } from "../../packages/runtime/service/routes.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 buildCommand = {
     command: "build <project-id>",
     describe: "Build Context Graph for a Project",

package/dist/cli/commands/graphs.js

@@ -4,44 +4,20 @@
  *   interf graphs ls --project <id>
  *   interf graphs show <graphId> --project <id>
  *   interf graphs open <graphId> --project <id>
+ *   interf graphs sessions --project <id>
+ *   interf graphs session <stageRunId> --project <id>
  */
 import chalk from "chalk";
-import { CONNECT_OR_ERROR_HINT, readActiveConnection } from "../../packages/runtime/connection-config.js";
-import { ContextGraphListResponseSchema, ContextGraphResourceSchema, } from "../../packages/runtime/schemas/index.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) {
-        try {
-            body = JSON.parse(raw);
-        }
-        catch {
-            body = null;
-        }
-    }
-    return { status: response.status, body, raw };
-}
+import { callJson, resolveConnection } from "../lib/http-client.js";
+import { ContextGraphListResponseSchema, ContextGraphResourceSchema, ContextGraphSessionResponseSchema, ContextGraphSessionsResponseSchema, } from "../../packages/runtime/schemas/index.js";
 function graphUrl(baseUrl, projectId, graphId) {
     const root = `${baseUrl}/v1/projects/${encodeURIComponent(projectId)}/graphs`;
     return graphId ? `${root}/${encodeURIComponent(graphId)}` : root;
 }
+function sessionsUrl(baseUrl, projectId, stageRunId) {
+    const root = `${baseUrl}/v1/projects/${encodeURIComponent(projectId)}/context-graph/sessions`;
+    return stageRunId ? `${root}/${encodeURIComponent(stageRunId)}` : root;
+}
 function statusColor(graph) {
     const status = graph.readiness?.status;
     if (graph.readiness?.ready || status === "ready")
@@ -50,6 +26,13 @@ function statusColor(graph) {
         return chalk.red;
     return chalk.yellow;
 }
+function formatMetric(metric) {
+    const count = typeof metric.total === "number"
+        ? `${metric.value} / ${metric.total}`
+        : `${metric.value}`;
+    const unit = metric.unit ? ` ${metric.unit}` : "";
+    return metric.detail ? `${count}${unit} (${metric.detail})` : `${count}${unit}`;
+}
 function renderGraph(graph) {
     const color = statusColor(graph);
     const graphId = graph.graph_id ?? graph.latest_build_run_id ?? `${graph.project}-latest`;
@@ -65,10 +48,94 @@ function renderGraph(graph) {
     if (graph.created_at)
         console.log(chalk.dim(`    created: ${graph.created_at}`));
     console.log(chalk.dim(`    path: ${graph.path}`));
+    for (const metric of graph.primary_metrics.slice(0, 5)) {
+        console.log(chalk.dim(`    ${metric.label}: ${formatMetric(metric)}`));
+    }
+    if (graph.graph_manifest?.graph_outputs) {
+        const outputs = graph.graph_manifest.graph_outputs;
+        console.log(chalk.dim(`    graph: ${outputs.nodes} nodes, ${outputs.edges} edges`));
+    }
     if (graph.build_evidence?.summary)
         console.log(chalk.dim(`    evidence: ${graph.build_evidence.summary}`));
     console.log();
 }
+function sessionStatusColor(status) {
+    if (status === "succeeded")
+        return chalk.green;
+    if (status === "failed")
+        return chalk.red;
+    return chalk.yellow;
+}
+function renderSessionLine(session) {
+    const color = sessionStatusColor(session.status);
+    console.log(`  ${chalk.bold(session.stage_run_id)} ${color(`(${session.status})`)}`);
+    console.log(chalk.dim(`    stage: ${session.stage_label} [${session.stage_id}] · attempt ${session.attempt} · ${session.contract_type}`));
+    const model = session.executor.model ? ` (${session.executor.model})` : "";
+    console.log(chalk.dim(`    executor: ${session.executor.display_name || session.executor.name}${model}`));
+    const replay = session.shell.replay_ready
+        ? chalk.green("replay-ready")
+        : chalk.dim(session.shell.retention_reason ? `pruned: ${session.shell.retention_reason}` : "no replay shell");
+    console.log(chalk.dim(`    shell: ${replay}`));
+}
+function renderSession(session) {
+    const color = sessionStatusColor(session.status);
+    console.log();
+    console.log(`  ${chalk.bold(session.stage_run_id)} ${color(`(${session.status})`)}`);
+    console.log(chalk.dim(`    stage: ${session.stage_label} [${session.stage_id}]`));
+    console.log(chalk.dim(`    attempt: ${session.attempt}`));
+    console.log(chalk.dim(`    contract: ${session.contract_type}`));
+    console.log(chalk.dim(`    project: ${session.project}`));
+    if (session.build_run_id)
+        console.log(chalk.dim(`    build run: ${session.build_run_id}`));
+    console.log(chalk.dim(`    Build Plan: ${session.build_plan}`));
+    const model = session.executor.model ? ` (${session.executor.model})` : "";
+    console.log(chalk.dim(`    executor: ${session.executor.display_name || session.executor.name}${model}`));
+    console.log(chalk.dim(`    updated: ${session.updated_at}`));
+    console.log();
+    console.log(chalk.bold("    Shell"));
+    console.log(chalk.dim(`      root: ${session.shell.root_path}`));
+    console.log(`      replay: ${session.shell.replay_ready ? chalk.green("ready") : chalk.yellow("not ready")}`
+        + (session.shell.retention_reason ? chalk.dim(` (${session.shell.retention_reason})`) : ""));
+    const logPaths = Object.entries(session.logs).filter(([, value]) => Boolean(value));
+    if (logPaths.length > 0) {
+        console.log();
+        console.log(chalk.bold("    Logs"));
+        for (const [label, value] of logPaths) {
+            console.log(chalk.dim(`      ${label.replace(/_path$/, "")}: ${value}`));
+        }
+    }
+    const reads = session.artifacts.reads;
+    const writes = session.artifacts.writes;
+    if (reads.length > 0 || writes.length > 0) {
+        console.log();
+        console.log(chalk.bold("    Artifacts"));
+        for (const mount of reads)
+            console.log(chalk.dim(`      read  ${mount.artifact_id}: ${mount.artifact_path}`));
+        for (const mount of writes)
+            console.log(chalk.dim(`      write ${mount.artifact_id}: ${mount.artifact_path}`));
+    }
+    if (session.validation_attempts.length > 0) {
+        console.log();
+        console.log(chalk.bold("    Validation"));
+        for (const attempt of session.validation_attempts) {
+            const marker = attempt.status === "succeeded" ? chalk.green("pass") : chalk.red("fail");
+            console.log(`      ${marker} attempt ${attempt.attempt}: ${chalk.dim(attempt.summary)}`);
+        }
+    }
+    if (session.summary) {
+        console.log();
+        console.log(chalk.bold("    Summary"));
+        console.log(chalk.dim(`      ${session.summary}`));
+    }
+    if (session.error) {
+        console.log();
+        console.log(chalk.red("    Error"));
+        console.log(chalk.dim(`      ${session.error}`));
+    }
+    console.log();
+    console.log(chalk.dim("  Run with --json for the full session record (all runtime-file paths)."));
+    console.log();
+}
 export const graphsCommand = {
     command: "graphs <subcommand>",
     describe: "Inspect Context Graphs produced for a Project",
@@ -105,6 +172,9 @@ export const graphsCommand = {
             const graphId = graph.graph_id ?? graph.latest_build_run_id ?? `${graph.project}-latest`;
             console.log(`  ${chalk.bold(graphId)} ${chalk.dim(`(${statusLabel}${marker})`)}`);
             console.log(chalk.dim(`    path: ${graph.path}`));
+            const metric = graph.primary_metrics[0];
+            if (metric)
+                console.log(chalk.dim(`    ${metric.label}: ${formatMetric(metric)}`));
         }
         console.log();
     })
@@ -156,6 +226,81 @@ export const graphsCommand = {
             process.exit(1);
         }
         console.log(chalk.dim(`  Opened ${resource.path}`));
+    })
+        .command("sessions", "List stage execution sessions for the latest Context Graph", (y) => y
+        .option("project", {
+        type: "string",
+        demandOption: true,
+        describe: "Project id",
+    })
+        .option("json", {
+        type: "boolean",
+        default: false,
+        describe: "Print the raw JSON session records",
+    }), async (args) => {
+        const { url, token } = resolveConnection(args);
+        const { status, body, raw } = await callJson(sessionsUrl(url, args.project), token);
+        if (status !== 200) {
+            console.error(chalk.red(`Failed to list execution sessions (HTTP ${status}).`));
+            if (raw)
+                console.error(raw);
+            process.exit(1);
+        }
+        const parsed = ContextGraphSessionsResponseSchema.safeParse(body);
+        if (!parsed.success) {
+            console.error(chalk.red("Failed to parse execution sessions."));
+            process.exit(1);
+        }
+        if (args.json) {
+            console.log(JSON.stringify(parsed.data.sessions, null, 2));
+            return;
+        }
+        const sessions = parsed.data.sessions;
+        if (sessions.length === 0) {
+            console.log(chalk.dim("  No stage execution sessions for the latest Build run."));
+            return;
+        }
+        console.log();
+        for (const session of sessions)
+            renderSessionLine(session);
+        console.log();
+        console.log(chalk.dim("  interf graphs session <stage-run-id> --project <id> for one session."));
+        console.log();
+    })
+        .command("session <stageRunId>", "Show one stage execution session", (y) => y
+        .positional("stageRunId", {
+        type: "string",
+        demandOption: true,
+        describe: "Stage execution session id (stage_run_id)",
+    })
+        .option("project", {
+        type: "string",
+        demandOption: true,
+        describe: "Project id",
+    })
+        .option("json", {
+        type: "boolean",
+        default: false,
+        describe: "Print the raw JSON session record",
+    }), async (args) => {
+        const { url, token } = resolveConnection(args);
+        const { status, body, raw } = await callJson(sessionsUrl(url, args.project, args.stageRunId), token);
+        if (status !== 200) {
+            console.error(chalk.red(`Failed to read execution session ${args.stageRunId} (HTTP ${status}).`));
+            if (raw)
+                console.error(raw);
+            process.exit(1);
+        }
+        const parsed = ContextGraphSessionResponseSchema.safeParse(body);
+        if (!parsed.success) {
+            console.error(chalk.red(`Failed to parse execution session ${args.stageRunId}.`));
+            process.exit(1);
+        }
+        if (args.json) {
+            console.log(JSON.stringify(parsed.data.session, null, 2));
+            return;
+        }
+        renderSession(parsed.data.session);
     })
         .demandCommand(1, "Choose a graphs subcommand."),
     handler: () => {

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

@@ -5,5 +5,6 @@ export interface McpArgs {
     url?: string;
     token?: string;
 }
+export declare function generatedMcpId(prefix: string): string;
 export declare function startInterfMcpServer(args: McpArgs): Promise<void>;
 export declare const mcpCommand: CommandModule<unknown, McpArgs>;