@interf/compiler 0.9.5 → 0.13.0

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

package/dist/packages/compiler/raw-snapshot.d.ts

@@ -1,49 +0,0 @@
-import type { InterfConfig } from "../project-model/lib/schema.js";
-export interface CompiledRawSyncResult {
-    sourceTotal: number;
-    copied: number;
-    removed: number;
-}
-type RawSnapshotMaterializeMode = "copy" | "link-or-copy";
-export declare function resolveCompiledRawPath(compiledPath: string, config?: {
-    [x: string]: unknown;
-    type: "compiled";
-    name: string;
-    method: string;
-    checks: {
-        question: string;
-        id?: string | undefined;
-        answer?: string | undefined;
-        expect?: {
-            must_include?: string[] | undefined;
-            must_include_one_of?: string[][] | undefined;
-            must_not_include?: string[] | undefined;
-            min_words?: number | undefined;
-            max_words?: number | undefined;
-        } | undefined;
-        strictness?: string | undefined;
-    }[];
-    source: {
-        path: string;
-        control_path?: string | undefined;
-        preparation_path?: string | undefined;
-    };
-    about?: string | undefined;
-    max_attempts?: number | undefined;
-    max_loops?: number | undefined;
-    method_origin?: {
-        selected: string;
-        local_draft?: boolean | undefined;
-    } | undefined;
-} | null): string;
-export declare function syncCompiledRawSnapshot(compiledPath: string, sourcePath?: string): CompiledRawSyncResult;
-export declare function ensureCompiledRawBinding(compiledPath: string): InterfConfig | null;
-export declare function projectRawSnapshot(options: {
-    sourcePath: string;
-    destinationPath: string;
-    compiledPath: string;
-    mode?: RawSnapshotMaterializeMode;
-    prune?: boolean;
-    preserveTimestamps?: boolean;
-}): CompiledRawSyncResult;
-export {};

package/dist/packages/compiler/raw-snapshot.js

@@ -1,101 +0,0 @@
-import { cpSync, existsSync, linkSync, mkdirSync, rmSync, statSync, } from "node:fs";
-import { dirname, join, relative, resolve } from "node:path";
-import { listFilesRecursive } from "../shared/filesystem.js";
-import { assertPathWithinRoot } from "../shared/path-guards.js";
-import { discoverSourceFiles } from "./discovery.js";
-import { defaultControlPathForCompiled } from "./compiled-paths.js";
-import { readInterfConfig, resolveSourceInputPath, } from "../project-model/interf-detect.js";
-import { saveCompiledInterfConfig } from "../project-model/source-config.js";
-export function resolveCompiledRawPath(compiledPath, config = readInterfConfig(compiledPath)) {
-    const configuredPath = typeof config?.source?.path === "string" && config.source.path.length > 0
-        ? config.source.path
-        : "raw";
-    return assertPathWithinRoot(compiledPath, resolve(compiledPath, configuredPath), "Compiled raw path");
-}
-export function syncCompiledRawSnapshot(compiledPath, sourcePath = resolveSourceInputPath(compiledPath)) {
-    ensureCompiledRawBinding(compiledPath);
-    const rawPath = resolveCompiledRawPath(compiledPath);
-    return projectRawSnapshot({
-        sourcePath,
-        destinationPath: rawPath,
-        compiledPath,
-        mode: "copy",
-        prune: true,
-        preserveTimestamps: true,
-    });
-}
-export function ensureCompiledRawBinding(compiledPath) {
-    const config = readInterfConfig(compiledPath);
-    if (!config)
-        return null;
-    if (config.source?.path === "./raw")
-        return config;
-    const nextConfig = {
-        ...config,
-        source: {
-            ...(config.source ?? {}),
-            path: "./raw",
-            control_path: config.source?.control_path ?? defaultControlPathForCompiled(compiledPath),
-        },
-    };
-    return saveCompiledInterfConfig(compiledPath, nextConfig);
-}
-function filesMatch(sourcePath, targetPath) {
-    if (!existsSync(targetPath))
-        return false;
-    try {
-        const sourceStat = statSync(sourcePath);
-        const targetStat = statSync(targetPath);
-        return sourceStat.size === targetStat.size && sourceStat.mtimeMs === targetStat.mtimeMs;
-    }
-    catch {
-        return false;
-    }
-}
-function materializeRawSnapshotFile(sourcePath, targetPath, options) {
-    mkdirSync(dirname(targetPath), { recursive: true });
-    rmSync(targetPath, { force: true });
-    if (options.mode === "link-or-copy") {
-        try {
-            linkSync(sourcePath, targetPath);
-            return;
-        }
-        catch {
-            // fall through to copy
-        }
-    }
-    cpSync(sourcePath, targetPath, { preserveTimestamps: options.preserveTimestamps });
-}
-export function projectRawSnapshot(options) {
-    const discovery = discoverSourceFiles(options.sourcePath, options.compiledPath);
-    const expectedFiles = new Set(discovery.sourceFiles);
-    mkdirSync(options.destinationPath, { recursive: true });
-    let removed = 0;
-    if (options.prune !== false) {
-        for (const existingPath of listFilesRecursive(options.destinationPath)) {
-            const relativePath = relative(options.destinationPath, existingPath);
-            if (expectedFiles.has(relativePath))
-                continue;
-            rmSync(existingPath, { force: true });
-            removed += 1;
-        }
-    }
-    let copied = 0;
-    for (const relativePath of discovery.sourceFiles) {
-        const sourceFilePath = join(options.sourcePath, relativePath);
-        const targetFilePath = join(options.destinationPath, relativePath);
-        if (filesMatch(sourceFilePath, targetFilePath)) {
-            continue;
-        }
-        materializeRawSnapshotFile(sourceFilePath, targetFilePath, {
-            mode: options.mode ?? "copy",
-            preserveTimestamps: options.preserveTimestamps ?? true,
-        });
-        copied += 1;
-    }
-    return {
-        sourceTotal: discovery.totalCount,
-        copied,
-        removed,
-    };
-}

package/dist/packages/method-package/index.d.ts

@@ -1,11 +0,0 @@
-export * as builtinMethod from "./builtin-compiled-method.js";
-export * as contextInterface from "./context-interface.js";
-export * as localMethods from "./local-methods.js";
-export * as packageWriters from "./interf-method-package.js";
-export * as methodDefinitions from "./method-definitions.js";
-export * as methodHelpers from "./method-helpers.js";
-export * as methodStagePolicy from "./method-stage-policy.js";
-export * as methodStageRunner from "./method-stage-runner.js";
-export * as methodReviewPaths from "./method-review-paths.js";
-export * as packageRoot from "./lib/package-root.js";
-export { CONTEXT_INTERFACE_FILE, ContextInterfaceSchema, ContextInterfaceZoneSchema, ContextInterfaceZoneIdSchema, ContextInterfaceZoneRoleSchema, MethodInputSpecSchema, MethodInputContractSchema, contextInterfaceFilePath, resolveContextInterfacePath, contextInterfaceExists, contextInterfaceRelativePath, listContextInterfaceZones, findContextInterfaceZone, contextInterfaceZoneAbsolutePath, contextInterfaceArtifactPath, contextInterfaceArtifactPathsForZoneIds, buildContextInterface, writeContextInterfaceFile, writeContextInterface, readContextInterface, type ContextInterface, type ContextInterfaceZone, type ContextInterfaceZoneId, type ContextInterfaceZoneRole, type ContextInterfaceStageLike, type MethodInputSpec, type ContextInterfaceSummary, summarizeContextInterface, deriveMethodInputsFromContextInterface, } from "./context-interface.js";

package/dist/packages/method-package/index.js

@@ -1,11 +0,0 @@
-export * as builtinMethod from "./builtin-compiled-method.js";
-export * as contextInterface from "./context-interface.js";
-export * as localMethods from "./local-methods.js";
-export * as packageWriters from "./interf-method-package.js";
-export * as methodDefinitions from "./method-definitions.js";
-export * as methodHelpers from "./method-helpers.js";
-export * as methodStagePolicy from "./method-stage-policy.js";
-export * as methodStageRunner from "./method-stage-runner.js";
-export * as methodReviewPaths from "./method-review-paths.js";
-export * as packageRoot from "./lib/package-root.js";
-export { CONTEXT_INTERFACE_FILE, ContextInterfaceSchema, ContextInterfaceZoneSchema, ContextInterfaceZoneIdSchema, ContextInterfaceZoneRoleSchema, MethodInputSpecSchema, MethodInputContractSchema, contextInterfaceFilePath, resolveContextInterfacePath, contextInterfaceExists, contextInterfaceRelativePath, listContextInterfaceZones, findContextInterfaceZone, contextInterfaceZoneAbsolutePath, contextInterfaceArtifactPath, contextInterfaceArtifactPathsForZoneIds, buildContextInterface, writeContextInterfaceFile, writeContextInterface, readContextInterface, summarizeContextInterface, deriveMethodInputsFromContextInterface, } from "./context-interface.js";

package/dist/packages/method-package/method-stage-policy.d.ts

@@ -1,5 +0,0 @@
-export interface StagePolicyStageLike {
-    id: string;
-}
-export declare function normalizeStagePolicyNotes(value: unknown): Record<string, string[]> | undefined;
-export declare function mergeStagePolicyNotesForStages(stages: readonly StagePolicyStageLike[], baseNotes: unknown, overrideNotes: Record<string, string[]> | undefined): Record<string, string[]> | undefined;

package/dist/packages/method-package/method-stage-policy.js

@@ -1,31 +0,0 @@
-export function normalizeStagePolicyNotes(value) {
-    if (!value || typeof value !== "object" || Array.isArray(value))
-        return undefined;
-    const normalized = {};
-    for (const [stageId, notes] of Object.entries(value)) {
-        if (!Array.isArray(notes))
-            continue;
-        const cleaned = Array.from(new Set(notes
-            .filter((note) => typeof note === "string")
-            .map((note) => note.trim())
-            .filter((note) => note.length > 0)));
-        if (cleaned.length > 0) {
-            normalized[stageId] = cleaned;
-        }
-    }
-    return Object.keys(normalized).length > 0 ? normalized : undefined;
-}
-export function mergeStagePolicyNotesForStages(stages, baseNotes, overrideNotes) {
-    const normalizedBase = normalizeStagePolicyNotes(baseNotes);
-    const merged = {};
-    for (const stage of stages) {
-        const combined = Array.from(new Set([
-            ...(normalizedBase?.[stage.id] ?? []),
-            ...((overrideNotes?.[stage.id] ?? []).map((note) => note.trim()).filter((note) => note.length > 0)),
-        ]));
-        if (combined.length > 0) {
-            merged[stage.id] = combined;
-        }
-    }
-    return Object.keys(merged).length > 0 ? merged : undefined;
-}

package/dist/packages/project-model/project-paths.d.ts

@@ -1,12 +0,0 @@
-export declare const PROJECT_INTERF_DIR = "interf";
-export declare const PORTABLE_CONTEXT_INTERF_DIR = ".interf";
-export declare const PORTABLE_CONTEXT_TESTS_DIR = "tests";
-export declare function projectInterfRoot(projectPath: string): string;
-export declare function portableContextPath(projectPath: string, preparationName: string): string;
-export declare function preparationTestsRoot(projectPath: string, preparationName: string): string;
-export type PreparationTestTargetLabel = "file-as-is" | "compiled";
-export declare function preparationTestRunsRoot(projectPath: string, preparationName: string, target: PreparationTestTargetLabel): string;
-export declare function preparationLatestReadinessRunPath(projectPath: string, preparationName: string): string;
-export declare function preparationLatestReadinessSummaryPath(projectPath: string, preparationName: string): string;
-export declare function normalizePreparationTestRunId(input: string): string;
-export declare function preparationTestRunPath(projectPath: string, preparationName: string, target: PreparationTestTargetLabel, generatedAt: string, runId: string, runSuffix?: string | null): string;

package/dist/packages/project-model/project-paths.js

@@ -1,33 +0,0 @@
-import { join } from "node:path";
-export const PROJECT_INTERF_DIR = "interf";
-export const PORTABLE_CONTEXT_INTERF_DIR = ".interf";
-export const PORTABLE_CONTEXT_TESTS_DIR = "tests";
-export function projectInterfRoot(projectPath) {
-    return join(projectPath, PROJECT_INTERF_DIR);
-}
-export function portableContextPath(projectPath, preparationName) {
-    return join(projectInterfRoot(projectPath), preparationName);
-}
-export function preparationTestsRoot(projectPath, preparationName) {
-    return join(portableContextPath(projectPath, preparationName), PORTABLE_CONTEXT_INTERF_DIR, PORTABLE_CONTEXT_TESTS_DIR);
-}
-export function preparationTestRunsRoot(projectPath, preparationName, target) {
-    return join(preparationTestsRoot(projectPath, preparationName), target, "runs");
-}
-export function preparationLatestReadinessRunPath(projectPath, preparationName) {
-    return join(preparationTestsRoot(projectPath, preparationName), "latest.json");
-}
-export function preparationLatestReadinessSummaryPath(projectPath, preparationName) {
-    return join(preparationTestsRoot(projectPath, preparationName), "latest.md");
-}
-export function normalizePreparationTestRunId(input) {
-    return input
-        .toLowerCase()
-        .trim()
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-+|-+$/g, "")
-        .slice(0, 80);
-}
-export function preparationTestRunPath(projectPath, preparationName, target, generatedAt, runId, runSuffix) {
-    return join(preparationTestRunsRoot(projectPath, preparationName, target), `${generatedAt.replace(/[:.]/g, "-")}-${runId}${runSuffix ? `-${normalizePreparationTestRunId(runSuffix)}` : ""}.json`);
-}