@interf/compiler 0.9.4 → 0.13.0

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

@@ -1,58 +0,0 @@
-import type { TestTargetCandidate, TestTargetResult } from "../../packages/testing/test.js";
-import type { MethodExecutionProfile, MethodExecutor } from "../../packages/agents/lib/executors.js";
-import type { TestSandboxRetentionMode } from "../../packages/testing/test-sandbox.js";
-import type { SourcePreparationConfig } from "../../packages/project-model/lib/schema.js";
-import type { ReadinessCheckRun, TestRunMode } from "../../packages/testing/lib/schema.js";
-export interface SavedTestOutcome {
-    runPath: string;
-    displayRunPath?: string;
-    target: TestTargetCandidate;
-    result: TestTargetResult;
-}
-export interface AgentTestMatrixRow {
-    agentLabel: string;
-    rawOutcome?: SavedTestOutcome | null;
-    compiledOutcome?: SavedTestOutcome | null;
-}
-export declare function readinessPassRate(outcome: SavedTestOutcome): number;
-export declare function readSavedTestComparison(projectPath: string, preparationName: string): ReadinessCheckRun | null;
-export declare function readCurrentSavedTestComparison(options: {
-    projectPath: string;
-    preparationName: string;
-    checks: SourcePreparationConfig["checks"];
-}): {
-    comparison: ReadinessCheckRun | null;
-    stale: boolean;
-};
-export declare function printSavedTestComparisonState(payload: ReadinessCheckRun, comparisonRunPath?: string | null): void;
-export declare function printAgentTestMatrix(rows: AgentTestMatrixRow[]): void;
-export declare function printAgentTestFailures(rows: AgentTestMatrixRow[]): void;
-export declare function printSavedTestOutcome(prefix: string, outcome: SavedTestOutcome): void;
-export declare function printSavedTestComparison(rawOutcome: SavedTestOutcome | null, compiledOutcome: SavedTestOutcome | null, comparisonRunPath?: string | null): void;
-export declare function printSavedTestComparisonSummary(rawOutcome: SavedTestOutcome | null, compiledOutcome: SavedTestOutcome | null, comparisonRunPath?: string | null): void;
-export declare function saveTestComparisonRun(options: {
-    sourcePath: string;
-    compiledPath: string | null;
-    compiledName: string;
-    checksFingerprint: string;
-    mode: TestRunMode;
-    rawOutcome: SavedTestOutcome | null;
-    compiledOutcome: SavedTestOutcome | null;
-}): string;
-export declare function runSavedRawTest(options: {
-    sourcePath: string;
-    preparationConfig: SourcePreparationConfig;
-    executor?: MethodExecutor | null;
-    executionProfile?: MethodExecutionProfile;
-    preserveSandboxes?: TestSandboxRetentionMode;
-    runSuffix?: string | null;
-}): Promise<SavedTestOutcome | null>;
-export declare function runSavedCompiledTest(options: {
-    sourcePath: string;
-    preparationConfig: SourcePreparationConfig;
-    executor?: MethodExecutor | null;
-    executionProfile?: MethodExecutionProfile;
-    compiledPath?: string | null;
-    preserveSandboxes?: TestSandboxRetentionMode;
-    runSuffix?: string | null;
-}): Promise<SavedTestOutcome | null>;

package/dist/cli/commands/test-flow.js

@@ -1,231 +0,0 @@
-import chalk from "chalk";
-import { readinessPassRate as readinessPassRateForOutcome, readCurrentSavedReadinessCheckRun, readSavedReadinessCheckRun, runSavedPortableContextCheck, runSavedSourceFilesCheck, saveReadinessCheckRun, } from "../../packages/testing/readiness-check-run.js";
-import { findBuiltCompiledPath } from "./compiled-flow.js";
-export function readinessPassRate(outcome) {
-    return readinessPassRateForOutcome(outcome);
-}
-function visibleRunPath(outcome) {
-    return outcome.displayRunPath ?? outcome.runPath;
-}
-function loadLatestComparison(projectPath, preparationName) {
-    return readSavedReadinessCheckRun(projectPath, preparationName);
-}
-export function readSavedTestComparison(projectPath, preparationName) {
-    return loadLatestComparison(projectPath, preparationName);
-}
-export function readCurrentSavedTestComparison(options) {
-    return readCurrentSavedReadinessCheckRun({
-        projectPath: options.projectPath,
-        preparationName: options.preparationName,
-        checks: options.checks,
-    });
-}
-export function printSavedTestComparisonState(payload, comparisonRunPath) {
-    console.log();
-    console.log(chalk.bold("  Latest readiness results"));
-    console.log();
-    console.log("  | Target | Readiness checks |");
-    console.log("  | --- | --- |");
-    if (payload.raw) {
-        console.log(`  | Source files | \`${payload.raw.passed_cases}/${payload.raw.total_cases}\` |`);
-    }
-    if (payload.compiled) {
-        console.log(`  | Portable Context | \`${payload.compiled.passed_cases}/${payload.compiled.total_cases}\` |`);
-    }
-    if (!payload.raw || !payload.compiled) {
-        console.log();
-        if (!payload.raw) {
-            console.log(chalk.dim("  No saved source-files baseline yet."));
-        }
-        if (!payload.compiled) {
-            console.log(chalk.dim("  No saved portable-context run yet."));
-        }
-    }
-    if (payload.summary.raw_pass_rate != null && payload.summary.compiled_pass_rate != null) {
-        const direction = (payload.summary.pass_rate_delta ?? 0) >= 0 ? "improved" : "decreased";
-        const color = (payload.summary.pass_rate_delta ?? 0) >= 0 ? chalk.green : chalk.red;
-        console.log();
-        console.log(color(`  Readiness-check pass rate ${direction} from ${payload.summary.raw_pass_rate}% to ${payload.summary.compiled_pass_rate}%.`));
-    }
-    if (comparisonRunPath) {
-        console.log();
-        console.log(chalk.dim(`  Saved summary: ${comparisonRunPath}`));
-    }
-}
-function padCell(value, width) {
-    return value.padEnd(width, " ");
-}
-function resultCell(outcome) {
-    if (!outcome)
-        return "—";
-    return `${outcome.result.passedCases}/${outcome.result.totalCases}`;
-}
-function deltaCell(row) {
-    if (!row.rawOutcome || !row.compiledOutcome)
-        return "—";
-    const delta = row.compiledOutcome.result.passedCases - row.rawOutcome.result.passedCases;
-    return delta > 0 ? `+${delta}` : `${delta}`;
-}
-export function printAgentTestMatrix(rows) {
-    if (rows.length === 0)
-        return;
-    const includeRaw = rows.some((row) => Boolean(row.rawOutcome));
-    const includeCompiled = rows.some((row) => Boolean(row.compiledOutcome));
-    const includeDelta = includeRaw && includeCompiled;
-    const headers = [
-        "Agent",
-        ...(includeRaw ? ["Source files"] : []),
-        ...(includeCompiled ? ["Portable Context"] : []),
-        ...(includeDelta ? ["Delta"] : []),
-    ];
-    const body = rows.map((row) => [
-        row.agentLabel,
-        ...(includeRaw ? [resultCell(row.rawOutcome)] : []),
-        ...(includeCompiled ? [resultCell(row.compiledOutcome)] : []),
-        ...(includeDelta ? [deltaCell(row)] : []),
-    ]);
-    const widths = headers.map((header, index) => Math.max(header.length, ...body.map((row) => (row[index] ?? "").length)));
-    const heading = includeDelta ? "  Comparison" : "  Results";
-    console.log();
-    console.log(chalk.bold(heading));
-    console.log();
-    console.log(`  | ${headers.map((header, index) => padCell(header, widths[index] ?? header.length)).join(" | ")} |`);
-    console.log(`  | ${widths.map((width) => "-".repeat(width)).join(" | ")} |`);
-    for (const row of body) {
-        console.log(`  | ${row.map((cell, index) => padCell(cell ?? "", widths[index] ?? cell.length)).join(" | ")} |`);
-    }
-}
-export function printAgentTestFailures(rows) {
-    for (const row of rows) {
-        const failures = [];
-        for (const [label, outcome] of [
-            ["Source files", row.rawOutcome ?? null],
-            ["Portable Context", row.compiledOutcome ?? null],
-        ]) {
-            if (!outcome || outcome.result.ok)
-                continue;
-            for (const [index, caseResult] of outcome.result.caseResults.entries()) {
-                if (caseResult.ok)
-                    continue;
-                const reason = caseResult.checks.find((entry) => !entry.ok)?.detail ?? "failed";
-                failures.push(`${label} · Check ${index + 1}: ${reason}`);
-            }
-        }
-        if (failures.length === 0)
-            continue;
-        console.log();
-        console.log(chalk.bold(`  ${row.agentLabel} failures`));
-        console.log();
-        for (const failure of failures) {
-            console.log(`  - ${failure}`);
-        }
-    }
-}
-export function printSavedTestOutcome(prefix, outcome) {
-    const color = outcome.result.ok ? chalk.green : chalk.red;
-    const status = outcome.result.ok ? chalk.green("PASS") : chalk.red("FAIL");
-    console.log(chalk.bold(`  ${prefix}`));
-    console.log();
-    console.log(color(`  ${status} ${outcome.result.passedCases}/${outcome.result.totalCases} readiness checks`));
-    console.log();
-    for (const [index, caseResult] of outcome.result.caseResults.entries()) {
-        const caseStatus = caseResult.ok ? chalk.green("PASS") : chalk.red("FAIL");
-        console.log(`  ${caseStatus} Check ${index + 1}`);
-        console.log(chalk.dim(`       ${caseResult.question}`));
-        const failedChecks = caseResult.checks.filter((entry) => !entry.ok).slice(0, 3);
-        for (const failedCheck of failedChecks) {
-            console.log(chalk.dim(`       Failed criterion: ${failedCheck.label}: ${failedCheck.detail}`));
-        }
-    }
-    console.log();
-    if (outcome.result.sandbox_path) {
-        console.log(chalk.dim(`  Preserved sandbox: ${outcome.result.sandbox_path}`));
-        console.log();
-    }
-    console.log(chalk.dim(`  Saved run: ${visibleRunPath(outcome)}`));
-}
-export function printSavedTestComparison(rawOutcome, compiledOutcome, comparisonRunPath) {
-    if (!rawOutcome && !compiledOutcome)
-        return;
-    console.log();
-    if (rawOutcome) {
-        printSavedTestOutcome("Source files", rawOutcome);
-    }
-    if (compiledOutcome) {
-        if (rawOutcome)
-            console.log();
-        printSavedTestOutcome("Portable Context", compiledOutcome);
-    }
-    if (rawOutcome && compiledOutcome) {
-        const rawReadiness = readinessPassRate(rawOutcome);
-        const compiledReadiness = readinessPassRate(compiledOutcome);
-        const delta = compiledReadiness - rawReadiness;
-        const color = delta >= 0 ? chalk.green : chalk.red;
-        const direction = delta >= 0 ? "improved" : "decreased";
-        console.log();
-        console.log(color(`  Readiness-check pass rate ${direction} from ${rawReadiness}% to ${compiledReadiness}%.`));
-    }
-    if (comparisonRunPath) {
-        console.log();
-        console.log(chalk.dim(`  Saved summary: ${comparisonRunPath}`));
-    }
-}
-export function printSavedTestComparisonSummary(rawOutcome, compiledOutcome, comparisonRunPath) {
-    if (!rawOutcome && !compiledOutcome)
-        return;
-    console.log();
-    console.log(chalk.bold("  Comparison"));
-    console.log();
-    console.log("  | Target | Readiness checks |");
-    console.log("  | --- | --- |");
-    if (rawOutcome) {
-        console.log(`  | Source files | \`${rawOutcome.result.passedCases}/${rawOutcome.result.totalCases}\` |`);
-    }
-    if (compiledOutcome) {
-        console.log(`  | Portable Context | \`${compiledOutcome.result.passedCases}/${compiledOutcome.result.totalCases}\` |`);
-    }
-    if (rawOutcome && compiledOutcome) {
-        const rawReadiness = readinessPassRate(rawOutcome);
-        const compiledReadiness = readinessPassRate(compiledOutcome);
-        const delta = compiledReadiness - rawReadiness;
-        const color = delta >= 0 ? chalk.green : chalk.red;
-        const direction = delta >= 0 ? "improved" : "decreased";
-        console.log();
-        console.log(color(`  Readiness-check pass rate ${direction} from ${rawReadiness}% to ${compiledReadiness}%.`));
-    }
-    if (comparisonRunPath) {
-        console.log();
-        console.log(chalk.dim(`  Saved summary: ${comparisonRunPath}`));
-    }
-}
-export function saveTestComparisonRun(options) {
-    return saveReadinessCheckRun({
-        sourcePath: options.sourcePath,
-        portableContextPath: options.compiledPath,
-        preparationName: options.compiledName,
-        checksFingerprint: options.checksFingerprint,
-        mode: options.mode,
-        rawOutcome: options.rawOutcome,
-        compiledOutcome: options.compiledOutcome,
-    });
-}
-export async function runSavedRawTest(options) {
-    return runSavedSourceFilesCheck({
-        sourcePath: options.sourcePath,
-        preparationConfig: options.preparationConfig,
-        executor: options.executor,
-        preserveSandboxes: options.preserveSandboxes ?? "on-failure",
-        runSuffix: options.runSuffix,
-    });
-}
-export async function runSavedCompiledTest(options) {
-    const compiledPath = options.compiledPath ?? findBuiltCompiledPath(options.sourcePath, options.preparationConfig.name);
-    return runSavedPortableContextCheck({
-        sourcePath: options.sourcePath,
-        preparationConfig: options.preparationConfig,
-        executor: options.executor,
-        portableContextPath: compiledPath,
-        preserveSandboxes: options.preserveSandboxes ?? "on-failure",
-        runSuffix: options.runSuffix,
-    });
-}

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

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

package/dist/cli/commands/verify.js

@@ -1,94 +0,0 @@
-import chalk from "chalk";
-import { detectInterf } from "../../packages/project-model/interf.js";
-import { validateCompiledCompile, validateCompiledStage, } from "../../packages/compiler/validate.js";
-import { validateMethodPackage } from "../../packages/method-package/local-methods.js";
-function normalizeVerifyCheck(value) {
-    if (!value)
-        return null;
-    if (value === "stage")
-        return "stage";
-    if (value === "portable-context")
-        return "portable-context";
-    if (value === "method")
-        return "method";
-    return null;
-}
-export const verifyCommand = {
-    command: "verify <check> [stageId]",
-    describe: "Run deterministic verification checks",
-    builder: (yargs) => yargs
-        .positional("check", {
-        type: "string",
-        describe: "Check to run (`stage`, `portable-context`, or `method`)",
-    })
-        .positional("stageId", {
-        type: "string",
-        describe: "Stage id when using `verify stage <stage-id>`",
-    })
-        .option("path", {
-        type: "string",
-        describe: "Path to a Method package when using `verify method`",
-    })
-        .option("json", {
-        type: "boolean",
-        default: false,
-        describe: "Print JSON output",
-    }),
-    handler: async (argv) => {
-        const check = normalizeVerifyCheck(argv.check);
-        if (!check) {
-            process.exitCode = 1;
-            console.log(chalk.red(`Unknown verify check: ${String(argv.check)}`));
-            return;
-        }
-        let result;
-        if (check === "method") {
-            const path = argv.path;
-            if (!path) {
-                process.exitCode = 1;
-                console.log(chalk.red("`interf verify method` needs --path <method-dir>."));
-                return;
-            }
-            result = validateMethodPackage(path);
-        }
-        else {
-            const detected = detectInterf(process.cwd());
-            if (!detected) {
-                process.exitCode = 1;
-                console.log(chalk.red("Run this from inside Portable Context."));
-                return;
-            }
-            if (check === "portable-context") {
-                result = validateCompiledCompile(detected.path);
-            }
-            else {
-                const stageId = argv.stageId;
-                if (!stageId) {
-                    process.exitCode = 1;
-                    console.log(chalk.red("`interf verify stage` needs <stage-id>."));
-                    return;
-                }
-                result = validateCompiledStage(detected.path, stageId);
-            }
-        }
-        if (argv.json) {
-            console.log(JSON.stringify(result, null, 2));
-            if (typeof result === "object" && result && "ok" in result && !result.ok) {
-                process.exitCode = 1;
-            }
-            return;
-        }
-        const typed = result;
-        console.log();
-        if (typed.ok) {
-            console.log(chalk.green(`  ${typed.summary ?? "Verification passed."}`));
-        }
-        else {
-            process.exitCode = 1;
-            console.log(chalk.red(`  ${typed.summary ?? "Verification failed."}`));
-            for (const error of typed.errors ?? []) {
-                console.log(chalk.dim(`  - ${error}`));
-            }
-        }
-    },
-};