@galaxy-tool-util/cli 0.1.0 → 0.4.0

package/dist/commands/roundtrip-tree.js

@@ -0,0 +1,178 @@
+/**
+ * `gxwf roundtrip-tree` — batch roundtrip validation across a directory.
+ * Mirrors the patterns in convert-tree.ts.
+ */
+import { makeNodeToolCache } from "@galaxy-tool-util/core/node";
+import { roundtripValidate, buildRoundTripTreeReport, categoryOf, } from "@galaxy-tool-util/schema";
+import { dirname, join } from "node:path";
+import { loadToolInputsForWorkflow } from "./stateful-tool-inputs.js";
+import { createDefaultResolver } from "./url-resolver.js";
+import { resolveStrictOptions } from "./strict-options.js";
+import { resolveFormat } from "./workflow-io.js";
+import { collectTree, skipWorkflow } from "./tree.js";
+import { countDiffs } from "./roundtrip.js";
+import { writeReportOutput, writeReportHtml } from "./report-output.js";
+export async function runRoundtripTree(dir, opts) {
+    const cache = makeNodeToolCache({ cacheDir: opts.cacheDir });
+    await cache.index.load();
+    if ((await cache.index.listAll()).length === 0) {
+        console.warn("Tool cache is empty — all steps will fall back (no roundtrip possible)");
+    }
+    const strict = resolveStrictOptions(opts);
+    // Only native workflows are eligible; format2 files are skipped.
+    const treeResult = await collectTree(dir, async (info, data) => {
+        const sourceFormat = resolveFormat(data, opts.format);
+        if (sourceFormat !== "native") {
+            skipWorkflow(`not a native workflow (${sourceFormat})`);
+        }
+        const expansionOpts = {
+            resolver: createDefaultResolver({
+                workflowDirectory: dirname(join(dir, info.relativePath)),
+            }),
+        };
+        const { resolver, status: toolStatus } = await loadToolInputsForWorkflow(data, "native", cache, expansionOpts);
+        const failedLoads = toolStatus.filter((s) => !s.loaded);
+        const result = roundtripValidate(data, resolver, {
+            strictEncoding: strict.strictEncoding,
+            strictStructure: strict.strictStructure,
+            strictState: strict.strictState,
+        });
+        if (result.encodingErrors.length > 0 || result.structureErrors.length > 0) {
+            const allErrors = [...result.encodingErrors, ...result.structureErrors];
+            throw new Error(`Strict: ${allErrors.join("; ")}`);
+        }
+        return {
+            relativePath: info.relativePath,
+            result,
+            toolLoadErrors: failedLoads.length > 0 ? failedLoads : undefined,
+        };
+    }, false);
+    // Aggregate
+    let totalBenign = 0;
+    let totalErrors = 0;
+    let filesClean = 0;
+    let filesBenignOnly = 0;
+    let filesFailed = 0;
+    const fileResults = [];
+    for (const o of treeResult.outcomes) {
+        if (o.error || o.skipped || !o.result)
+            continue;
+        fileResults.push(o.result);
+        const counts = countDiffs(o.result.result);
+        totalBenign += counts.benign;
+        totalErrors += counts.error;
+        if (!o.result.result.success)
+            filesFailed++;
+        else if (o.result.result.clean)
+            filesClean++;
+        else
+            filesBenignOnly++;
+    }
+    // Build RoundTripTreeReport for Markdown/HTML rendering
+    const roundtripWorkflows = treeResult.outcomes.map((o) => {
+        const relPath = o.info.relativePath;
+        if (o.error)
+            return makeRoundTripResult(relPath, null, o.error, null);
+        if (o.skipped)
+            return makeRoundTripResult(relPath, null, null, "legacy_encoding");
+        return makeRoundTripResult(relPath, o.result.result, null, null);
+    });
+    const roundtripReport = buildRoundTripTreeReport(treeResult.root, roundtripWorkflows);
+    await writeReportOutput("roundtrip_tree.md.j2", roundtripReport, {
+        reportMarkdown: opts.reportMarkdown,
+    });
+    await writeReportHtml("roundtrip-tree", roundtripReport, opts.reportHtml);
+    if (opts.json) {
+        console.log(JSON.stringify({
+            root: treeResult.root,
+            files: fileResults,
+            summary: {
+                total: fileResults.length,
+                clean: filesClean,
+                benignOnly: filesBenignOnly,
+                failed: filesFailed,
+                benignDiffs: totalBenign,
+                errorDiffs: totalErrors,
+            },
+        }, null, 2));
+    }
+    else {
+        if (!opts.brief) {
+            for (const o of treeResult.outcomes) {
+                if (o.error) {
+                    // File-level errors always shown unless --benign-only.
+                    if (!opts.benignOnly) {
+                        console.error(`  ${o.info.relativePath}: ERROR (${o.error})`);
+                    }
+                    continue;
+                }
+                if (o.skipped)
+                    continue;
+                const r = o.result;
+                const c = countDiffs(r.result);
+                const isFail = !r.result.success;
+                const isClean = r.result.clean;
+                const isBenign = !isFail && !isClean;
+                if (opts.errorsOnly && !isFail)
+                    continue;
+                if (opts.benignOnly && !isBenign)
+                    continue;
+                const status = isFail ? "FAIL" : isClean ? "clean" : "benign";
+                console.log(`  ${r.relativePath}: ${status} (${c.benign} benign, ${c.error} real diff, ${c.failed} conversion failure)`);
+                if (r.toolLoadErrors) {
+                    for (const t of r.toolLoadErrors) {
+                        const ver = t.toolVersion ? `@${t.toolVersion}` : "";
+                        console.error(`    tool ${t.toolId}${ver}: ${t.error}`);
+                    }
+                }
+            }
+        }
+        console.log(`\nSummary: ${fileResults.length} file(s): ${filesClean} clean, ${filesBenignOnly} benign-only, ${filesFailed} failed`);
+        console.log(`Diffs: ${totalBenign} benign, ${totalErrors} real`);
+    }
+    // Exit code: 2 if any failure, 1 if benign-only, 0 if all clean
+    if (filesFailed > 0 || totalErrors > 0)
+        process.exitCode = 2;
+    else if (totalBenign > 0)
+        process.exitCode = 1;
+    else
+        process.exitCode = 0;
+}
+/** Map the TS-internal RoundtripResult to the report-model shape for template rendering. */
+function makeRoundTripResult(relPath, result, error, skippedReason) {
+    const allDiffs = result?.stepResults.flatMap((s) => s.diffs) ?? [];
+    const errorDiffs = allDiffs.filter((d) => d.severity === "error");
+    const benignDiffs = allDiffs.filter((d) => d.severity === "benign");
+    const ok = result ? result.success : false;
+    let status;
+    if (error)
+        status = "error";
+    else if (skippedReason)
+        status = "skipped";
+    else if (ok)
+        status = "ok";
+    else
+        status = "roundtrip_mismatch";
+    const conversionFailureLines = result?.stepResults
+        .filter((s) => !s.success)
+        .map((s) => s.error ?? `Step ${s.stepId} failed`) ?? [];
+    return {
+        workflow_path: relPath,
+        category: categoryOf(relPath),
+        conversion_result: null,
+        diffs: allDiffs,
+        step_id_mapping: null,
+        stale_clean_results: null,
+        error,
+        skipped_reason: skippedReason,
+        structure_errors: result?.structureErrors ?? [],
+        encoding_errors: result?.encodingErrors ?? [],
+        error_diffs: errorDiffs,
+        benign_diffs: benignDiffs,
+        ok,
+        status,
+        conversion_failure_lines: conversionFailureLines,
+        summary_line: status.toUpperCase(),
+    };
+}
+//# sourceMappingURL=roundtrip-tree.js.map

package/dist/commands/roundtrip-tree.js.map

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

package/dist/commands/roundtrip.d.ts

@@ -0,0 +1,31 @@
+import { type RoundtripResult } from "@galaxy-tool-util/schema";
+import { type StrictOptions } from "./strict-options.js";
+export interface RoundtripOptions extends StrictOptions {
+    cacheDir?: string;
+    format?: string;
+    json?: boolean;
+    /** Only show steps with error-severity diffs. */
+    errorsOnly?: boolean;
+    /** Only show steps with benign diffs (suppress clean + real-error steps). */
+    benignOnly?: boolean;
+    /** Suppress the per-diff list; show only per-step counts and summary. */
+    brief?: boolean;
+}
+export declare function runRoundtrip(filePath: string, opts: RoundtripOptions): Promise<void>;
+export interface ReportFilter {
+    errorsOnly?: boolean;
+    benignOnly?: boolean;
+    brief?: boolean;
+}
+/**
+ * Exit code policy: 0 clean, 1 benign-only, 2 real diffs or errors.
+ * Exposed for reuse by the tree command.
+ */
+export declare function exitCodeFor(result: RoundtripResult): number;
+/** Count diffs across a result by severity — reused by tree aggregation. */
+export declare function countDiffs(result: RoundtripResult): {
+    benign: number;
+    error: number;
+    failed: number;
+};
+//# sourceMappingURL=roundtrip.d.ts.map

package/dist/commands/roundtrip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roundtrip.d.ts","sourceRoot":"","sources":["../../src/commands/roundtrip.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,0BAA0B,CAAC;AAIlC,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAG/E,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iDAAiD;IACjD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yEAAyE;IACzE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmE1F;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAmED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAI3D;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAOA"}

package/dist/commands/roundtrip.js

@@ -0,0 +1,144 @@
+/**
+ * `gxwf roundtrip` — roundtrip-validate a native workflow through format2
+ * and back, reporting per-step diffs and classifying them as benign or real.
+ *
+ * Exit codes:
+ *   0  clean roundtrip (no diffs)
+ *   1  benign diffs only (type coercions, stale keys, connection moves)
+ *   2  real diffs or conversion errors
+ */
+import { makeNodeToolCache } from "@galaxy-tool-util/core/node";
+import { roundtripValidate, } from "@galaxy-tool-util/schema";
+import { dirname } from "node:path";
+import { loadToolInputsForWorkflow } from "./stateful-tool-inputs.js";
+import { createDefaultResolver } from "./url-resolver.js";
+import { resolveStrictOptions } from "./strict-options.js";
+import { readWorkflowFile, resolveFormat } from "./workflow-io.js";
+export async function runRoundtrip(filePath, opts) {
+    const data = await readWorkflowFile(filePath);
+    if (!data)
+        return;
+    const sourceFormat = resolveFormat(data, opts.format);
+    const strict = resolveStrictOptions(opts);
+    if (sourceFormat !== "native") {
+        console.error(`Roundtrip source must be a native (.ga) workflow; got ${sourceFormat}.` +
+            ` Convert to native first or pass a .ga file.`);
+        process.exitCode = 2;
+        return;
+    }
+    const cache = makeNodeToolCache({ cacheDir: opts.cacheDir });
+    await cache.index.load();
+    if ((await cache.index.listAll()).length === 0) {
+        console.warn("Tool cache is empty — all steps will fall back (no roundtrip possible)");
+    }
+    const expansionOpts = {
+        resolver: createDefaultResolver({ workflowDirectory: dirname(filePath) }),
+    };
+    const { resolver, status: toolStatus } = await loadToolInputsForWorkflow(data, "native", cache, expansionOpts);
+    for (const s of toolStatus) {
+        if (!s.loaded) {
+            const ver = s.toolVersion ? `@${s.toolVersion}` : "";
+            console.error(`  tool ${s.toolId}${ver}: ${s.error}`);
+        }
+    }
+    const result = roundtripValidate(data, resolver, {
+        strictEncoding: strict.strictEncoding,
+        strictStructure: strict.strictStructure,
+        strictState: strict.strictState,
+    });
+    if (opts.json) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        // Report strict errors before step-level results
+        if (result.encodingErrors.length > 0) {
+            console.error("Encoding errors:");
+            for (const e of result.encodingErrors)
+                console.error(`  ${e}`);
+        }
+        if (result.structureErrors.length > 0) {
+            console.error("Structure errors (strict):");
+            for (const e of result.structureErrors)
+                console.error(`  ${e}`);
+        }
+        reportResult(filePath, result, opts);
+    }
+    let exitCode = exitCodeFor(result);
+    // --strict-state: require all steps to roundtrip (no skips/failures)
+    if (strict.strictState && result.stepResults.some((s) => !s.success)) {
+        exitCode = 2;
+    }
+    process.exitCode = exitCode;
+}
+function reportResult(filePath, result, filter) {
+    const total = result.stepResults.length;
+    const failed = result.stepResults.filter((s) => !s.success).length;
+    const benignCount = result.stepResults.reduce((n, s) => n + s.diffs.filter((d) => d.severity === "benign").length, 0);
+    const errorCount = result.stepResults.reduce((n, s) => n + s.diffs.filter((d) => d.severity === "error").length, 0);
+    console.log(`Roundtrip: ${filePath}`);
+    console.log(`  ${total - failed}/${total} step(s) ok, ${benignCount} benign diff(s), ${errorCount} real diff(s)`);
+    // --brief short-circuits: skip the per-step detail entirely. Still prints
+    // the one-line summary above, which is the whole point of --brief.
+    if (filter.brief)
+        return;
+    for (const step of result.stepResults) {
+        const hasError = step.diffs.some((d) => d.severity === "error");
+        const hasBenign = step.diffs.some((d) => d.severity === "benign");
+        if (filter.errorsOnly && !hasError && step.success)
+            continue;
+        if (filter.benignOnly) {
+            // Show only steps with benign diffs and no errors and no failure.
+            if (!hasBenign || hasError || !step.success)
+                continue;
+        }
+        // Default: skip clean-passing tool steps but keep informational
+        // subworkflow notes (failureClass set, success true) visible.
+        if (!filter.errorsOnly &&
+            !filter.benignOnly &&
+            step.diffs.length === 0 &&
+            step.success &&
+            !step.failureClass) {
+            continue;
+        }
+        // Indent nested subworkflow steps (depth>0) so the hierarchy is visible.
+        const indent = "  ".repeat(step.depth);
+        const label = step.toolId ? `${step.stepId} (${step.toolId})` : step.stepId;
+        if (!step.success) {
+            console.error(`${indent}  step ${label}: ${step.failureClass ?? "failed"} — ${step.error ?? ""}`);
+        }
+        else if (step.failureClass) {
+            console.log(`${indent}  step ${label}: ${step.failureClass} (${step.error ?? ""})`);
+        }
+        const diffsToShow = filter.errorsOnly
+            ? step.diffs.filter((d) => d.severity === "error")
+            : filter.benignOnly
+                ? step.diffs.filter((d) => d.severity === "benign")
+                : step.diffs;
+        for (const d of diffsToShow) {
+            const tag = d.severity === "error" ? "ERROR" : `benign:${d.benign_artifact?.reason ?? "?"}`;
+            const loc = d.key_path || "<root>";
+            console.log(`${indent}    [${tag}] ${loc}: ${d.description}`);
+        }
+    }
+}
+/**
+ * Exit code policy: 0 clean, 1 benign-only, 2 real diffs or errors.
+ * Exposed for reuse by the tree command.
+ */
+export function exitCodeFor(result) {
+    if (!result.success)
+        return 2;
+    if (!result.clean)
+        return 1;
+    return 0;
+}
+/** Count diffs across a result by severity — reused by tree aggregation. */
+export function countDiffs(result) {
+    const flat = result.stepResults.flatMap((s) => s.diffs);
+    return {
+        benign: flat.filter((d) => d.severity === "benign").length,
+        error: flat.filter((d) => d.severity === "error").length,
+        failed: result.stepResults.filter((s) => !s.success).length,
+    };
+}
+//# sourceMappingURL=roundtrip.js.map

package/dist/commands/roundtrip.js.map

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

package/dist/commands/schema.js

@@ -1,4 +1,4 @@
-import { ToolCache } from "@galaxy-tool-util/core";
+import { makeNodeToolCache } from "@galaxy-tool-util/core/node";
 import { createFieldModel, STATE_REPRESENTATIONS, } from "@galaxy-tool-util/schema";
 import * as JSONSchema from "effect/JSONSchema";
 import { writeFile } from "node:fs/promises";
@@ -11,7 +11,7 @@ export async function runSchema(toolId, opts) {
         return;
     }
     const stateRep = repName;
-    const cache = new ToolCache({ cacheDir: opts.cacheDir });
+    const cache = makeNodeToolCache({ cacheDir: opts.cacheDir });
     await cache.index.load();
     const result = await loadCachedTool(cache, toolId, opts.version);
     if (isResolveError(result)) {

package/dist/commands/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/commands/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EACL,gBAAgB,EAChB,qBAAqB,GAGtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AASnE,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAc,EAAE,IAAmB;IACjE,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,IAAI,eAAe,CAAC;IACvD,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,OAA8B,CAAC,EAAE,CAAC;QACpE,OAAO,CAAC,KAAK,CACX,2BAA2B,OAAO,gBAAgB,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrF,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IACD,MAAM,QAAQ,GAAG,OAA8B,CAAC;IAEhD,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACzD,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACjE,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACjC,OAAO,CAAC,KAAK,CAAC,kCAAkC,MAAM,EAAE,CAAC,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,4BAA4B,MAAM,sCAAsC,CAAC,CAAC;QAC1F,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAA6B;QACvC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,MAAgD;KACzE,CAAC;IAEF,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,EAAE,QAA+B,CAAC,CAAC;IAC/E,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,CAAC,KAAK,CAAC,2EAA2E,CAAC,CAAC;QAC3F,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,UAAmB,CAAC;IACxB,IAAI,CAAC;QACH,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvD,OAAO,CAAC,KAAK,CAAC,kCAAkC,GAAG,EAAE,CAAC,CAAC;QACvD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAEnD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAClD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/commands/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EACL,gBAAgB,EAChB,qBAAqB,GAGtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AASnE,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAc,EAAE,IAAmB;IACjE,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,IAAI,eAAe,CAAC;IACvD,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,OAA8B,CAAC,EAAE,CAAC;QACpE,OAAO,CAAC,KAAK,CACX,2BAA2B,OAAO,gBAAgB,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrF,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IACD,MAAM,QAAQ,GAAG,OAA8B,CAAC;IAEhD,MAAM,KAAK,GAAG,iBAAiB,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC7D,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACjE,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACjC,OAAO,CAAC,KAAK,CAAC,kCAAkC,MAAM,EAAE,CAAC,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,4BAA4B,MAAM,sCAAsC,CAAC,CAAC;QAC1F,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAA6B;QACvC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,MAAgD;KACzE,CAAC;IAEF,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,EAAE,QAA+B,CAAC,CAAC;IAC/E,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,CAAC,KAAK,CAAC,2EAA2E,CAAC,CAAC;QAC3F,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,UAAmB,CAAC;IACxB,IAAI,CAAC;QACH,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvD,OAAO,CAAC,KAAK,CAAC,kCAAkC,GAAG,EAAE,CAAC,CAAC;QACvD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAEnD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAClD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/commands/stateful-tool-inputs.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Helper for stateful workflow conversion: expand a workflow, walk every
+ * step (including subworkflows), and preload tool parameter definitions
+ * from a `ToolCache` into a synchronous `ToolInputsResolver` suitable for
+ * `toFormat2Stateful` / `toNativeStateful`.
+ *
+ * Using `expandedNative` / `expandedFormat2` ensures externally-referenced
+ * subworkflows (@import, URL, TRS) contribute their tools — not just
+ * inline subworkflows (which is all `unique_tools` would cover).
+ *
+ * Keys inputs by `${tool_id}\0${tool_version ?? ""}` so multi-version
+ * workflows don't collide. Matches gxformat2's `ConversionOptions`
+ * callback-shaped design: callers pass the resolver, not the map.
+ */
+import type { ToolCache } from "@galaxy-tool-util/core";
+import { type ExpansionOptions, type ToolInputsResolver, type WorkflowFormat } from "@galaxy-tool-util/schema";
+export interface ToolLoadStatus {
+    toolId: string;
+    toolVersion: string | null;
+    loaded: boolean;
+    error?: string;
+}
+export interface LoadedToolInputs {
+    resolver: ToolInputsResolver;
+    status: ToolLoadStatus[];
+}
+/**
+ * Expand the workflow, walk every step, and preload tool inputs from the
+ * cache. Returns a sync resolver for `toFormat2Stateful` / `toNativeStateful`
+ * plus a per-tool load status list.
+ */
+export declare function loadToolInputsForWorkflow(data: Record<string, unknown>, format: WorkflowFormat, cache: ToolCache, expansionOpts?: ExpansionOptions): Promise<LoadedToolInputs>;
+//# sourceMappingURL=stateful-tool-inputs.d.ts.map

package/dist/commands/stateful-tool-inputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateful-tool-inputs.d.ts","sourceRoot":"","sources":["../../src/commands/stateful-tool-inputs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAGL,KAAK,gBAAgB,EAKrB,KAAK,kBAAkB,EAEvB,KAAK,cAAc,EACpB,MAAM,0BAA0B,CAAC;AAKlC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AAMD;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,SAAS,EAChB,aAAa,CAAC,EAAE,gBAAgB,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAyB3B"}

package/dist/commands/stateful-tool-inputs.js

@@ -0,0 +1,73 @@
+import { expandedFormat2, expandedNative, } from "@galaxy-tool-util/schema";
+import { isResolveError, loadCachedTool } from "./resolve-tool.js";
+function toolKey(toolId, version) {
+    return `${toolId}\0${version ?? ""}`;
+}
+/**
+ * Expand the workflow, walk every step, and preload tool inputs from the
+ * cache. Returns a sync resolver for `toFormat2Stateful` / `toNativeStateful`
+ * plus a per-tool load status list.
+ */
+export async function loadToolInputsForWorkflow(data, format, cache, expansionOpts) {
+    const refs = format === "native"
+        ? collectNativeToolRefs(await expandedNative(data, expansionOpts))
+        : collectFormat2ToolRefs(await expandedFormat2(data, expansionOpts));
+    const loaded = new Map();
+    const status = [];
+    for (const [toolId, version] of refs) {
+        const key = toolKey(toolId, version);
+        if (loaded.has(key))
+            continue;
+        const resolved = await loadCachedTool(cache, toolId, version);
+        if (isResolveError(resolved)) {
+            const reason = resolved.kind === "no_version" ? `no version for ${toolId}` : `${toolId} not in cache`;
+            status.push({ toolId, toolVersion: version, loaded: false, error: reason });
+            continue;
+        }
+        loaded.set(key, resolved.tool.inputs);
+        status.push({ toolId, toolVersion: version, loaded: true });
+    }
+    const resolver = (toolId, version) => loaded.get(toolKey(toolId, version));
+    return { resolver, status };
+}
+// --- Step walkers over expanded workflows ---
+function collectNativeToolRefs(wf) {
+    const seen = new Set();
+    const refs = [];
+    const walk = (steps) => {
+        for (const step of Object.values(steps)) {
+            if (step.tool_id != null) {
+                const key = toolKey(step.tool_id, step.tool_version ?? null);
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    refs.push([step.tool_id, step.tool_version ?? null]);
+                }
+            }
+            if (step.subworkflow)
+                walk(step.subworkflow.steps);
+        }
+    };
+    walk(wf.steps);
+    return refs;
+}
+function collectFormat2ToolRefs(wf) {
+    const seen = new Set();
+    const refs = [];
+    const walk = (steps) => {
+        for (const step of steps) {
+            if (step.tool_id != null) {
+                const key = toolKey(step.tool_id, step.tool_version ?? null);
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    refs.push([step.tool_id, step.tool_version ?? null]);
+                }
+            }
+            if (step.run && typeof step.run === "object") {
+                walk(step.run.steps);
+            }
+        }
+    };
+    walk(wf.steps);
+    return refs;
+}
+//# sourceMappingURL=stateful-tool-inputs.js.map

package/dist/commands/stateful-tool-inputs.js.map

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

package/dist/commands/strict-options.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Strict validation options — decomposed into three orthogonal dimensions.
+ *
+ * --strict is shorthand for --strict-structure --strict-encoding --strict-state.
+ */
+import type { Command } from "commander";
+export interface StrictOptions {
+    strict?: boolean;
+    strictStructure?: boolean;
+    strictEncoding?: boolean;
+    strictState?: boolean;
+}
+export interface ResolvedStrictOptions {
+    strictStructure: boolean;
+    strictEncoding: boolean;
+    strictState: boolean;
+}
+/** Expand --strict shorthand into the three individual flags. */
+export declare function resolveStrictOptions(opts: StrictOptions): ResolvedStrictOptions;
+/** Register --strict, --strict-structure, --strict-encoding, --strict-state on a Commander command. */
+export declare function addStrictOptions(cmd: Command): Command;
+//# sourceMappingURL=strict-options.d.ts.map

package/dist/commands/strict-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strict-options.d.ts","sourceRoot":"","sources":["../../src/commands/strict-options.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,iEAAiE;AACjE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,qBAAqB,CAO/E;AAED,uGAAuG;AACvG,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAMtD"}

package/dist/commands/strict-options.js

@@ -0,0 +1,18 @@
+/** Expand --strict shorthand into the three individual flags. */
+export function resolveStrictOptions(opts) {
+    const all = !!opts.strict;
+    return {
+        strictStructure: all || !!opts.strictStructure,
+        strictEncoding: all || !!opts.strictEncoding,
+        strictState: all || !!opts.strictState,
+    };
+}
+/** Register --strict, --strict-structure, --strict-encoding, --strict-state on a Commander command. */
+export function addStrictOptions(cmd) {
+    return cmd
+        .option("--strict", "Shorthand for --strict-structure --strict-encoding --strict-state")
+        .option("--strict-structure", "Reject unknown keys at envelope/step level")
+        .option("--strict-encoding", "Reject JSON-string tool_state and format2 field misuse")
+        .option("--strict-state", "Require every tool step to validate; no skips allowed");
+}
+//# sourceMappingURL=strict-options.js.map

package/dist/commands/strict-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strict-options.js","sourceRoot":"","sources":["../../src/commands/strict-options.ts"],"names":[],"mappings":"AAoBA,iEAAiE;AACjE,MAAM,UAAU,oBAAoB,CAAC,IAAmB;IACtD,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IAC1B,OAAO;QACL,eAAe,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe;QAC9C,cAAc,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc;QAC5C,WAAW,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW;KACvC,CAAC;AACJ,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,OAAO,GAAG;SACP,MAAM,CAAC,UAAU,EAAE,mEAAmE,CAAC;SACvF,MAAM,CAAC,oBAAoB,EAAE,4CAA4C,CAAC;SAC1E,MAAM,CAAC,mBAAmB,EAAE,wDAAwD,CAAC;SACrF,MAAM,CAAC,gBAAgB,EAAE,uDAAuD,CAAC,CAAC;AACvF,CAAC"}

package/dist/commands/structural-schema.d.ts

@@ -0,0 +1,6 @@
+export interface StructuralSchemaOptions {
+    format?: string;
+    output?: string;
+}
+export declare function runStructuralSchema(opts: StructuralSchemaOptions): Promise<void>;
+//# sourceMappingURL=structural-schema.d.ts.map

package/dist/commands/structural-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-schema.d.ts","sourceRoot":"","sources":["../../src/commands/structural-schema.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBtF"}

package/dist/commands/structural-schema.js

@@ -0,0 +1,31 @@
+/**
+ * `galaxy-tool-cache structural-schema` — export the structural JSON Schema
+ * for Galaxy workflow validation (gxformat2 or native).
+ */
+import { GalaxyWorkflowSchema, NativeGalaxyWorkflowSchema } from "@galaxy-tool-util/schema";
+import * as JSONSchema from "effect/JSONSchema";
+import { writeWorkflowOutput } from "./workflow-io.js";
+export async function runStructuralSchema(opts) {
+    const format = opts.format ?? "format2";
+    if (format !== "format2" && format !== "native") {
+        console.error(`Unknown format: ${format}. Use 'format2' (default) or 'native'.`);
+        process.exitCode = 1;
+        return;
+    }
+    let jsonSchema;
+    try {
+        jsonSchema =
+            format === "native"
+                ? JSONSchema.make(NativeGalaxyWorkflowSchema)
+                : JSONSchema.make(GalaxyWorkflowSchema);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        console.error(`JSON Schema generation failed: ${msg}`);
+        process.exitCode = 1;
+        return;
+    }
+    const output = JSON.stringify(jsonSchema, null, 2) + "\n";
+    await writeWorkflowOutput(output, opts.output, "Structural schema");
+}
+//# sourceMappingURL=structural-schema.js.map

package/dist/commands/structural-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-schema.js","sourceRoot":"","sources":["../../src/commands/structural-schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAOvD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAA6B;IACrE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,SAAS,CAAC;IACxC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,CAAC,KAAK,CAAC,mBAAmB,MAAM,wCAAwC,CAAC,CAAC;QACjF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,UAAmB,CAAC;IACxB,IAAI,CAAC;QACH,UAAU;YACR,MAAM,KAAK,QAAQ;gBACjB,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,0BAA0B,CAAC;gBAC7C,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvD,OAAO,CAAC,KAAK,CAAC,kCAAkC,GAAG,EAAE,CAAC,CAAC;QACvD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IAC1D,MAAM,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AACtE,CAAC"}