lootforge 0.3.0

package/dist/cli/commands/regenerate.js

@@ -0,0 +1,244 @@
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { parseGenerateProviderFlag, runGeneratePipeline, } from "../../pipeline/generate.js";
+import { CliError } from "../../shared/errors.js";
+import { resolvePathWithinRoot, resolveStagePathLayout } from "../../shared/paths.js";
+import { readArgValue, parseBooleanArg } from "../parseArgs.js";
+export function parseRegenerateCommandArgs(argv) {
+    const outFlag = readArgValue(argv, "out");
+    const indexFlag = readArgValue(argv, "index");
+    const providerFlag = readArgValue(argv, "provider");
+    const lockFlag = readArgValue(argv, "lock");
+    const idsFlag = readArgValue(argv, "ids");
+    const editFlag = readArgValue(argv, "edit");
+    const preserveCompositionFlag = readArgValue(argv, "preserve-composition");
+    const instruction = readArgValue(argv, "instruction")?.trim() ?? undefined;
+    return {
+        outDir: path.resolve(outFlag ?? process.cwd()),
+        targetsIndexPath: indexFlag ? path.resolve(indexFlag) : undefined,
+        provider: parseGenerateProviderFlag(providerFlag),
+        selectionLockPath: lockFlag ? path.resolve(lockFlag) : undefined,
+        ids: idsFlag
+            ? idsFlag
+                .split(",")
+                .map((value) => value.trim())
+                .filter(Boolean)
+            : [],
+        edit: parseBooleanArg(editFlag ?? "true", "--edit"),
+        preserveComposition: parseBooleanArg(preserveCompositionFlag ?? "true", "--preserve-composition"),
+        instruction,
+    };
+}
+export async function runRegenerateCommand(argv, options = {}) {
+    const args = parseRegenerateCommandArgs(argv);
+    const layout = resolveStagePathLayout(args.outDir);
+    const targetsIndexPath = path.resolve(args.targetsIndexPath ?? path.join(layout.jobsDir, "targets-index.json"));
+    const selectionLockPath = path.resolve(args.selectionLockPath ?? path.join(layout.outDir, "locks", "selection-lock.json"));
+    const [targetsIndex, selectionLock] = await Promise.all([
+        readTargetsIndex(targetsIndexPath),
+        readSelectionLock(selectionLockPath),
+    ]);
+    const prepared = await prepareRegenerateTargets({
+        outDir: layout.outDir,
+        targetsIndex,
+        selectionLock,
+        selectionLockPath,
+        ids: args.ids,
+        edit: args.edit,
+        instruction: args.instruction,
+        preserveComposition: args.preserveComposition,
+    });
+    const regenerateIndexPath = path.join(layout.jobsDir, "regenerate-targets-index.json");
+    await mkdir(path.dirname(regenerateIndexPath), { recursive: true });
+    await writeFile(regenerateIndexPath, `${JSON.stringify({
+        generatedAt: targetsIndex.generatedAt,
+        manifestPath: targetsIndex.manifestPath,
+        targets: prepared.targets,
+    }, null, 2)}\n`, "utf8");
+    const pipelineResult = await runGeneratePipeline({
+        outDir: args.outDir,
+        targetsIndexPath: regenerateIndexPath,
+        provider: args.provider,
+        ids: prepared.targetIds,
+        selectionLockPath,
+        skipLocked: false,
+        onProgress: options.onProgress ?? writeGenerateProgressLog,
+        now: options.now,
+        fetchImpl: options.fetchImpl,
+        registry: options.registry,
+    });
+    return {
+        runId: pipelineResult.runId,
+        jobs: pipelineResult.jobs.length,
+        imagesDir: pipelineResult.imagesDir,
+        provenancePath: pipelineResult.provenancePath,
+        targetsRegenerated: prepared.targetIds,
+    };
+}
+async function readTargetsIndex(targetsIndexPath) {
+    const raw = await readFile(targetsIndexPath, "utf8");
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new CliError(`Failed to parse targets index JSON (${targetsIndexPath}): ${error instanceof Error ? error.message : String(error)}`, { code: "invalid_targets_index", exitCode: 1 });
+    }
+    if (!Array.isArray(parsed.targets)) {
+        throw new CliError(`No targets found in planned index: ${targetsIndexPath}`, {
+            code: "missing_targets",
+            exitCode: 1,
+        });
+    }
+    return parsed;
+}
+async function readSelectionLock(selectionLockPath) {
+    let raw;
+    try {
+        raw = await readFile(selectionLockPath, "utf8");
+    }
+    catch (error) {
+        throw new CliError(`Failed to read selection lock "${selectionLockPath}". Run "lootforge select" first.`, { code: "selection_lock_missing", exitCode: 1, cause: error });
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        throw new CliError(`Failed to parse selection lock JSON (${selectionLockPath}): ${error instanceof Error ? error.message : String(error)}`, { code: "selection_lock_invalid", exitCode: 1 });
+    }
+}
+async function prepareRegenerateTargets(params) {
+    const plannedTargets = params.targetsIndex.targets ?? [];
+    const targetsById = new Map(plannedTargets.map((target) => [target.id, target]));
+    const lockTargets = params.selectionLock.targets ?? [];
+    const lockByTargetId = new Map(lockTargets.map((target) => [target.targetId, target]));
+    const approvedLockIds = lockTargets
+        .filter((target) => target.approved)
+        .map((target) => target.targetId);
+    const requestedIds = params.ids.length > 0 ? Array.from(new Set(params.ids)) : Array.from(new Set(approvedLockIds));
+    if (requestedIds.length === 0) {
+        throw new CliError("No regeneration targets resolved. Pass --ids or approve targets via lootforge select.", { code: "regenerate_no_targets", exitCode: 1 });
+    }
+    const targetIdsToRegenerate = [];
+    const rewrittenTargets = new Map();
+    for (const targetId of requestedIds) {
+        const target = targetsById.get(targetId);
+        if (!target) {
+            throw new CliError(`Target "${targetId}" was not found in targets index.`, {
+                code: "regenerate_missing_target",
+                exitCode: 1,
+            });
+        }
+        if (target.generationDisabled) {
+            throw new CliError(`Target "${targetId}" is generationDisabled and cannot be regenerated.`, {
+                code: "regenerate_disabled_target",
+                exitCode: 1,
+            });
+        }
+        const lock = lockByTargetId.get(targetId);
+        if (!lock) {
+            throw new CliError(`Target "${targetId}" is missing from selection lock. Run lootforge select before regenerate.`, { code: "regenerate_missing_lock_entry", exitCode: 1 });
+        }
+        if (!lock.approved) {
+            throw new CliError(`Target "${targetId}" is not approved in selection lock. Review/eval/select before regenerate.`, { code: "regenerate_unapproved_lock_entry", exitCode: 1 });
+        }
+        let selectedOutputPath;
+        try {
+            selectedOutputPath = resolvePathWithinRoot(params.outDir, lock.selectedOutputPath, `selection lock output path for target "${targetId}"`);
+        }
+        catch (error) {
+            throw new CliError(`Selection lock output path for "${targetId}" must stay within --out (${params.outDir}).`, {
+                code: "regenerate_unsafe_locked_path",
+                exitCode: 1,
+                cause: error,
+            });
+        }
+        let sourceExists = false;
+        try {
+            await access(selectedOutputPath);
+            sourceExists = true;
+        }
+        catch {
+            sourceExists = false;
+        }
+        if (!sourceExists) {
+            throw new CliError(`Locked source image for "${targetId}" does not exist: ${selectedOutputPath}`, { code: "regenerate_missing_locked_image", exitCode: 1 });
+        }
+        const rewritten = params.edit
+            ? toEditFirstRegenerateTarget({
+                target,
+                lock,
+                selectionLockPath: params.selectionLockPath,
+                lockGeneratedAt: params.selectionLock.generatedAt,
+                selectedOutputPath,
+                instruction: params.instruction,
+                preserveComposition: params.preserveComposition,
+            })
+            : {
+                ...target,
+                regenerationSource: {
+                    mode: "selection-lock",
+                    selectionLockPath: params.selectionLockPath,
+                    selectionLockGeneratedAt: params.selectionLock.generatedAt,
+                    lockInputHash: lock.inputHash,
+                    lockSelectedOutputPath: selectedOutputPath,
+                },
+            };
+        rewrittenTargets.set(targetId, rewritten);
+        targetIdsToRegenerate.push(targetId);
+    }
+    return {
+        targets: plannedTargets.map((target) => rewrittenTargets.get(target.id) ?? target),
+        targetIds: targetIdsToRegenerate,
+    };
+}
+function toEditFirstRegenerateTarget(params) {
+    const existingInputs = params.target.edit?.inputs ?? [];
+    const nonBaseInputs = existingInputs.filter((input) => input.role !== "base");
+    const baseInput = {
+        path: params.selectedOutputPath,
+        role: "base",
+        fidelity: "high",
+    };
+    const dedupedInputs = [baseInput, ...nonBaseInputs].filter((input, index, list) => list.findIndex((candidate) => candidate.path === input.path &&
+        (candidate.role ?? "reference") === (input.role ?? "reference")) === index);
+    return {
+        ...params.target,
+        generationMode: "edit-first",
+        edit: {
+            mode: "iterate",
+            instruction: params.instruction ??
+                params.target.edit?.instruction ??
+                `Regenerate target "${params.target.id}" from approved selection lock output.`,
+            inputs: dedupedInputs,
+            preserveComposition: params.preserveComposition,
+        },
+        regenerationSource: {
+            mode: "selection-lock-edit",
+            selectionLockPath: params.selectionLockPath,
+            selectionLockGeneratedAt: params.lockGeneratedAt,
+            lockInputHash: params.lock.inputHash,
+            lockSelectedOutputPath: params.selectedOutputPath,
+        },
+    };
+}
+function writeGenerateProgressLog(event) {
+    if (event.type === "prepare") {
+        process.stdout.write(`Preparing ${event.totalJobs} regeneration job(s)...\n`);
+        return;
+    }
+    const printableIndex = typeof event.jobIndex === "number" ? event.jobIndex + 1 : undefined;
+    const total = event.totalJobs;
+    const slot = typeof printableIndex === "number" ? `[${printableIndex}/${total}] ` : "";
+    const target = event.targetId ?? "unknown-target";
+    if (event.type === "job_start") {
+        process.stdout.write(`${slot}regenerating ${target} via ${event.provider ?? "provider"} (${event.model ?? "model"})\n`);
+        return;
+    }
+    if (event.type === "job_finish") {
+        process.stdout.write(`${slot}finished ${target} -> ${event.outputPath ?? "unknown-output"} (${event.bytesWritten ?? 0} bytes)\n`);
+        return;
+    }
+    process.stdout.write(`${slot}failed ${target}: ${event.message ?? "unknown error"}\n`);
+}
+//# sourceMappingURL=regenerate.js.map

package/dist/cli/commands/regenerate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regenerate.js","sourceRoot":"","sources":["../../../src/cli/commands/regenerate.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,5 @@
+export interface ReviewCommandResult {
+    reviewHtmlPath: string;
+    targetCount: number;
+}
+export declare function runReviewCommand(argv: string[]): Promise<ReviewCommandResult>;

package/dist/cli/commands/review.js

@@ -0,0 +1,18 @@
+import path from "node:path";
+import { runReviewPipeline } from "../../pipeline/review.js";
+import { readArgValue } from "../parseArgs.js";
+export async function runReviewCommand(argv) {
+    const outDir = path.resolve(readArgValue(argv, "out") ?? process.cwd());
+    const evalReportPath = readArgValue(argv, "eval");
+    const htmlPath = readArgValue(argv, "html");
+    const result = await runReviewPipeline({
+        outDir,
+        evalReportPath: evalReportPath ? path.resolve(evalReportPath) : undefined,
+        reviewHtmlPath: htmlPath ? path.resolve(htmlPath) : undefined,
+    });
+    return {
+        reviewHtmlPath: result.reviewHtmlPath,
+        targetCount: result.targetCount,
+    };
+}
+//# sourceMappingURL=review.js.map

package/dist/cli/commands/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../../src/cli/commands/review.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAO/C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAc;IACnD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACxE,MAAM,cAAc,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAE5C,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;QACrC,MAAM;QACN,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS;QACzE,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;KAC9D,CAAC,CAAC;IAEH,OAAO;QACL,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,6 @@
+export interface SelectCommandResult {
+    selectionLockPath: string;
+    approvedTargets: number;
+    totalTargets: number;
+}
+export declare function runSelectCommand(argv: string[]): Promise<SelectCommandResult>;

package/dist/cli/commands/select.js

@@ -0,0 +1,21 @@
+import path from "node:path";
+import { runSelectPipeline } from "../../pipeline/select.js";
+import { readArgValue } from "../parseArgs.js";
+export async function runSelectCommand(argv) {
+    const outDir = path.resolve(readArgValue(argv, "out") ?? process.cwd());
+    const evalReportPath = readArgValue(argv, "eval");
+    const provenancePath = readArgValue(argv, "provenance");
+    const lockPath = readArgValue(argv, "lock");
+    const result = await runSelectPipeline({
+        outDir,
+        evalReportPath: evalReportPath ? path.resolve(evalReportPath) : undefined,
+        provenancePath: provenancePath ? path.resolve(provenancePath) : undefined,
+        selectionLockPath: lockPath ? path.resolve(lockPath) : undefined,
+    });
+    return {
+        selectionLockPath: result.selectionLockPath,
+        approvedTargets: result.approvedTargets,
+        totalTargets: result.totalTargets,
+    };
+}
+//# sourceMappingURL=select.js.map

package/dist/cli/commands/select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.js","sourceRoot":"","sources":["../../../src/cli/commands/select.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAQ/C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAc;IACnD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACxE,MAAM,cAAc,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAClD,MAAM,cAAc,GAAG,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAE5C,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;QACrC,MAAM;QACN,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS;QACzE,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS;QACzE,iBAAiB,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;KACjE,CAAC,CAAC;IAEH,OAAO;QACL,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;QAC3C,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,YAAY,EAAE,MAAM,CAAC,YAAY;KAClC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,16 @@
+export interface ServeCommandArgs {
+    host: string;
+    port: number;
+    maxActiveJobs: number;
+    defaultOutDir?: string;
+}
+export interface ServeCommandResult {
+    host: string;
+    port: number;
+    url: string;
+    apiVersion: string;
+    maxActiveJobs: number;
+    defaultOutDir?: string;
+}
+export declare function parseServeCommandArgs(argv: string[]): ServeCommandArgs;
+export declare function runServeCommand(argv: string[]): Promise<ServeCommandResult>;

package/dist/cli/commands/serve.js

@@ -0,0 +1,100 @@
+import path from "node:path";
+import { SERVICE_API_VERSION, startLootForgeService } from "../../service/server.js";
+import { CliError } from "../../shared/errors.js";
+import { readArgValue } from "../parseArgs.js";
+const DEFAULT_SERVICE_HOST = "127.0.0.1";
+const DEFAULT_SERVICE_PORT = 8744;
+const DEFAULT_SERVICE_MAX_ACTIVE_JOBS = 2;
+export function parseServeCommandArgs(argv) {
+    const hostFlag = readArgValue(argv, "host");
+    const portFlag = readArgValue(argv, "port");
+    const maxActiveJobsFlag = readArgValue(argv, "max-active-jobs");
+    const outFlag = readArgValue(argv, "out");
+    const envHost = process.env.LOOTFORGE_SERVICE_HOST?.trim();
+    const envPort = process.env.LOOTFORGE_SERVICE_PORT?.trim();
+    const envMaxActiveJobs = process.env.LOOTFORGE_SERVICE_MAX_ACTIVE_JOBS?.trim();
+    const envOut = process.env.LOOTFORGE_SERVICE_OUT?.trim();
+    const host = normalizeHost(hostFlag ?? envHost ?? DEFAULT_SERVICE_HOST);
+    const port = parsePort(portFlag ?? envPort ?? String(DEFAULT_SERVICE_PORT));
+    const maxActiveJobs = parseMaxActiveJobs(maxActiveJobsFlag ?? envMaxActiveJobs ?? String(DEFAULT_SERVICE_MAX_ACTIVE_JOBS));
+    const defaultOut = outFlag ?? envOut;
+    return {
+        host,
+        port,
+        maxActiveJobs,
+        defaultOutDir: defaultOut ? path.resolve(defaultOut) : undefined,
+    };
+}
+export async function runServeCommand(argv) {
+    const args = parseServeCommandArgs(argv);
+    const service = await startLootForgeService({
+        host: args.host,
+        port: args.port,
+        maxActiveJobs: args.maxActiveJobs,
+        defaultOutDir: args.defaultOutDir,
+    });
+    registerShutdownHandlers(service.close);
+    return {
+        host: service.host,
+        port: service.port,
+        url: service.baseUrl,
+        apiVersion: SERVICE_API_VERSION,
+        maxActiveJobs: service.maxActiveJobs,
+        ...(args.defaultOutDir ? { defaultOutDir: args.defaultOutDir } : {}),
+    };
+}
+function normalizeHost(value) {
+    const normalized = value.trim();
+    if (normalized.length === 0) {
+        throw new CliError("Invalid --host value. Host cannot be empty.", {
+            code: "invalid_serve_host",
+            exitCode: 1,
+        });
+    }
+    return normalized;
+}
+function parsePort(value) {
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed < 0 || parsed > 65535) {
+        throw new CliError(`Invalid --port value "${value}". Use a port between 0 and 65535.`, {
+            code: "invalid_serve_port",
+            exitCode: 1,
+        });
+    }
+    return parsed;
+}
+function parseMaxActiveJobs(value) {
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isInteger(parsed) || parsed < 1) {
+        throw new CliError(`Invalid --max-active-jobs value "${value}". Use an integer greater than or equal to 1.`, {
+            code: "invalid_serve_max_active_jobs",
+            exitCode: 1,
+        });
+    }
+    return parsed;
+}
+function registerShutdownHandlers(close) {
+    let isClosing = false;
+    const shutdown = (signal) => {
+        if (isClosing) {
+            return;
+        }
+        isClosing = true;
+        void close()
+            .catch(() => {
+            // no-op: process is exiting on signal
+        })
+            .finally(() => {
+            process.stdout.write(`lootforge service stopped (${signal}).\n`);
+            // eslint-disable-next-line n/no-process-exit
+            process.exit(0);
+        });
+    };
+    process.once("SIGINT", () => {
+        shutdown("SIGINT");
+    });
+    process.once("SIGTERM", () => {
+        shutdown("SIGTERM");
+    });
+}
+//# sourceMappingURL=serve.js.map

package/dist/cli/commands/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../../src/cli/commands/serve.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,17 @@
+import { type ValidationReport } from "../../manifest/types.js";
+export interface ValidateCommandArgs {
+    manifestPath: string;
+    outDir: string;
+    strict: boolean;
+    checkImages: boolean;
+    imagesDir?: string;
+}
+export interface ValidateCommandResult {
+    report: ValidationReport;
+    reportPath: string;
+    imageAcceptanceReportPath?: string;
+    strict: boolean;
+    exitCode: number;
+}
+export declare function parseValidateCommandArgs(argv: string[]): ValidateCommandArgs;
+export declare function runValidateCommand(argv: string[]): Promise<ValidateCommandResult>;

package/dist/cli/commands/validate.js

@@ -0,0 +1,108 @@
+import path from "node:path";
+import { runImageAcceptanceChecks } from "../../checks/imageAcceptance.js";
+import { loadManifestSource } from "../../manifest/load.js";
+import { normalizeManifestTargets, validateManifestSource } from "../../manifest/validate.js";
+import { getErrorMessage } from "../../shared/errors.js";
+import { writeJsonFile } from "../../shared/fs.js";
+import { resolveManifestPath, resolveOutDir, resolveStagePathLayout } from "../../shared/paths.js";
+import { readArgValue, parseBooleanArg } from "../parseArgs.js";
+export function parseValidateCommandArgs(argv) {
+    const manifestPath = resolveManifestPath(readArgValue(argv, "manifest"));
+    const outDir = resolveOutDir(readArgValue(argv, "out"), path.dirname(manifestPath));
+    const strict = parseBooleanArg(readArgValue(argv, "strict") ?? "true", "--strict");
+    const checkImages = parseBooleanArg(readArgValue(argv, "check-images") ?? "false", "--check-images");
+    const imagesDirFlag = readArgValue(argv, "images-dir");
+    return {
+        manifestPath,
+        outDir,
+        strict,
+        checkImages,
+        imagesDir: imagesDirFlag ? path.resolve(imagesDirFlag) : undefined,
+    };
+}
+export async function runValidateCommand(argv) {
+    const args = parseValidateCommandArgs(argv);
+    const reportPath = path.join(args.outDir, "checks", "validation-report.json");
+    let report;
+    let imageAcceptanceReportPath;
+    let manifest;
+    try {
+        const source = await loadManifestSource(args.manifestPath);
+        const validation = validateManifestSource(source);
+        report = {
+            ...validation.report,
+            issues: [...validation.report.issues],
+        };
+        manifest = validation.manifest;
+    }
+    catch (error) {
+        report = {
+            manifestPath: args.manifestPath,
+            generatedAt: new Date().toISOString(),
+            ok: false,
+            errors: 1,
+            warnings: 0,
+            targetCount: 0,
+            issues: [
+                {
+                    level: "error",
+                    code: "manifest_load_failed",
+                    path: "$",
+                    message: getErrorMessage(error),
+                },
+            ],
+        };
+        await writeJsonFile(reportPath, report);
+        const strictFailure = args.strict && report.errors > 0;
+        return {
+            report,
+            reportPath,
+            imageAcceptanceReportPath,
+            strict: args.strict,
+            exitCode: strictFailure ? 1 : 0,
+        };
+    }
+    if (args.checkImages && manifest) {
+        try {
+            const targets = normalizeManifestTargets(manifest, {
+                manifestPath: args.manifestPath,
+            });
+            const layout = resolveStagePathLayout(args.outDir);
+            const imagesDir = args.imagesDir ?? layout.processedImagesDir;
+            const acceptanceReport = await runImageAcceptanceChecks({
+                targets,
+                imagesDir,
+                strict: args.strict,
+            });
+            imageAcceptanceReportPath = path.join(args.outDir, "checks", "image-acceptance-report.json");
+            await writeJsonFile(imageAcceptanceReportPath, acceptanceReport);
+            report.issues.push(...acceptanceReport.items.flatMap((item) => item.issues.map((issue) => ({
+                level: issue.level,
+                code: `image_${issue.code}`,
+                path: `targets.${item.targetId}.image`,
+                message: issue.message,
+            }))));
+        }
+        catch (error) {
+            report.issues.push({
+                level: "error",
+                code: "image_acceptance_check_failed",
+                path: "$",
+                message: getErrorMessage(error),
+            });
+        }
+        report.errors = report.issues.filter((issue) => issue.level === "error").length;
+        report.warnings = report.issues.filter((issue) => issue.level === "warning").length;
+        report.ok = report.errors === 0;
+    }
+    await writeJsonFile(reportPath, report);
+    const strictFailure = args.strict && report.errors > 0;
+    return {
+        report,
+        reportPath,
+        imageAcceptanceReportPath,
+        strict: args.strict,
+        exitCode: strictFailure ? 1 : 0,
+    };
+}
+//# sourceMappingURL=validate.js.map

package/dist/cli/commands/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.d.ts

@@ -0,0 +1 @@
+export declare function main(argv: string[]): Promise<number>;