@interf/compiler 0.9.4 → 0.9.5

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

@@ -1,112 +0,0 @@
-import chalk from "chalk";
-import * as p from "@clack/prompts";
-import { ensurePortableContextScaffold, listPortableContextsForSourceFolder, } from "../../packages/project-model/interf.js";
-import { listSourcePreparationConfigs, loadCompiledPreparationConfig, loadSourceFolderConfig, resolveSourcePreparationPath, sourcePreparationConfigFromInterfConfig, syncCompiledInterfConfigFromSourcePreparationConfig, } from "../../packages/project-model/source-config.js";
-import { compileCompiled, createCompiled, } from "../../packages/compiler/method-runs.js";
-import { formatMethodExecutionProfile } from "../../packages/agents/lib/execution-profile.js";
-import { resolveMethodId } from "../../packages/methods/method-resolution.js";
-function formatSavedPreparationHint(entry) {
-    const config = entry.config;
-    const checkCount = config.checks.length;
-    const methodHint = `Method ${resolveMethodId(config)}${entry.localDraft ? " (local draft)" : ""}`;
-    if (config.about)
-        return `${config.path} · ${config.about} · ${methodHint}`;
-    if (checkCount === 0)
-        return `${config.path} · No readiness checks yet · ${methodHint}`;
-    return `${config.path} · ${checkCount} readiness check${checkCount === 1 ? "" : "s"} · ${methodHint}`;
-}
-export function listSavedPreparationEntries(sourcePath) {
-    const builtEntries = new Map();
-    for (const builtCompiled of listPortableContextsForSourceFolder(sourcePath)) {
-        const preparationConfig = loadCompiledPreparationConfig(builtCompiled.path)
-            ?? sourcePreparationConfigFromInterfConfig(builtCompiled.config);
-        builtEntries.set(builtCompiled.config.name, {
-            config: preparationConfig,
-            path: builtCompiled.path,
-            localDraft: builtCompiled.config.method_origin?.local_draft === true,
-        });
-    }
-    const entries = new Map();
-    for (const config of listSourcePreparationConfigs(loadSourceFolderConfig(sourcePath))) {
-        const built = builtEntries.get(config.name);
-        entries.set(config.name, {
-            config,
-            path: built?.path ?? null,
-            localDraft: built?.localDraft ?? false,
-        });
-    }
-    return Array.from(entries.values()).sort((left, right) => left.config.name.localeCompare(right.config.name));
-}
-export function findBuiltCompiledPath(sourcePath, compiledName) {
-    return listSavedPreparationEntries(sourcePath).find((entry) => entry.config.name === compiledName)?.path ?? null;
-}
-export function findSavedCompiledConfig(sourcePath, compiledName) {
-    return listSavedPreparationEntries(sourcePath).find((entry) => entry.config.name === compiledName)?.config ?? null;
-}
-export async function chooseCompiledConfigToBuild(options) {
-    const savedEntries = listSavedPreparationEntries(options.sourcePath);
-    if (savedEntries.length === 0) {
-        return null;
-    }
-    if (savedEntries.length === 1) {
-        return savedEntries[0]?.config ?? null;
-    }
-    const selected = await p.select({
-        message: options.selectMessage,
-        options: savedEntries.map((entry) => ({
-            value: entry.config.name,
-            label: entry.config.name,
-            hint: [
-                formatSavedPreparationHint(entry),
-                entry.path ? "Portable Context available" : "Portable Context not built yet",
-            ].join(" · "),
-        })),
-    });
-    if (p.isCancel(selected))
-        return undefined;
-    return savedEntries.find((entry) => entry.config.name === selected)?.config ?? null;
-}
-export function createCompiledFromConfig(sourcePath, preparationConfig) {
-    const methodId = resolveMethodId(preparationConfig);
-    const sourceFolderPath = resolveSourcePreparationPath(sourcePath, preparationConfig);
-    const compiledPath = createCompiled(preparationConfig.name, sourcePath, methodId, preparationConfig.about, sourceFolderPath);
-    syncCompiledInterfConfigFromSourcePreparationConfig(compiledPath, preparationConfig);
-    return compiledPath;
-}
-export function ensureCompiledFromConfig(sourcePath, preparationConfig) {
-    const methodId = resolveMethodId(preparationConfig);
-    const existingPath = findBuiltCompiledPath(sourcePath, preparationConfig.name);
-    if (existingPath) {
-        ensurePortableContextScaffold(sourcePath, preparationConfig.name, methodId);
-        syncCompiledInterfConfigFromSourcePreparationConfig(existingPath, preparationConfig);
-        return existingPath;
-    }
-    return createCompiledFromConfig(sourcePath, preparationConfig);
-}
-export async function compileCompiledWithReporter(executor, compiledPath, options = {}) {
-    console.log();
-    console.log(chalk.bold(`  ${options.heading ?? "Building Portable Context..."}`));
-    const profileLabel = formatMethodExecutionProfile(executor.executionProfile);
-    if (profileLabel) {
-        console.log(chalk.dim(`  Execution profile: ${profileLabel}`));
-    }
-    console.log();
-    const reporter = {
-        line: (message) => console.log(chalk.dim(`  ${message}`)),
-        blankLine: () => console.log(),
-    };
-    const result = await compileCompiled({
-        executor,
-        compiledPath,
-        reporter,
-        preserveStageShells: options.preserveStageShells,
-        runId: options.runId,
-        events: options.events,
-    });
-    if (!result.ok) {
-        return result;
-    }
-    console.log();
-    console.log(chalk.green(`  ✓ ${options.successMessage ?? "Portable Context ready."}`));
-    return result;
-}

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,
-    });
-}