@galaxy-tool-util/cli 0.1.0 → 0.4.0

package/dist/commands/lint.js

@@ -0,0 +1,195 @@
+import { makeNodeToolCache } from "@galaxy-tool-util/core/node";
+import { lintWorkflow, lintBestPracticesNative, lintBestPracticesFormat2, checkStrictEncoding, checkStrictStructure, buildSingleLintReport, } from "@galaxy-tool-util/schema";
+import { dirname } from "node:path";
+import { renderStepResults } from "./render-results.js";
+import { readWorkflowFile, resolveFormat } from "./workflow-io.js";
+import { createDefaultResolver } from "./url-resolver.js";
+import { resolveStrictOptions, } from "./strict-options.js";
+import { validateNativeSteps, validateFormat2Steps, decodeStructureErrors, detectEncodingErrors, } from "./validate-workflow.js";
+import { writeReportHtml } from "./report-output.js";
+function mergeLintResults(...results) {
+    const errors = [];
+    const warnings = [];
+    for (const r of results) {
+        if (!r)
+            continue;
+        errors.push(...r.errors);
+        warnings.push(...r.warnings);
+    }
+    return { errors, warnings, error_count: errors.length, warn_count: warnings.length };
+}
+export async function runLint(filePath, opts) {
+    const data = await readWorkflowFile(filePath);
+    if (!data)
+        return;
+    const format = resolveFormat(data, opts.format);
+    // Build or load tool cache for state validation
+    let cache;
+    if (!opts.skipStateValidation) {
+        try {
+            cache = makeNodeToolCache({ cacheDir: opts.cacheDir });
+            await cache.index.load();
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            console.warn(`Failed to load tool cache: ${msg}`);
+        }
+    }
+    const strict = resolveStrictOptions(opts);
+    const report = await lintWorkflowReport(filePath, data, format, {
+        skipBestPractices: opts.skipBestPractices,
+        skipStateValidation: opts.skipStateValidation,
+        cache,
+        strict,
+    });
+    if (opts.json || opts.reportHtml) {
+        const lintErrors = report.structural.error_count + (report.bestPractices?.error_count ?? 0);
+        const lintWarnings = report.structural.warn_count + (report.bestPractices?.warn_count ?? 0);
+        // Effect Schema decode for structure_errors
+        const structureErrors = decodeStructureErrors(data, format);
+        // Legacy encoding detection for encoding_errors
+        let encodingErrors = [];
+        if (cache && !opts.skipStateValidation) {
+            const expansionOpts = {
+                resolver: createDefaultResolver({ workflowDirectory: dirname(filePath) }),
+            };
+            encodingErrors = await detectEncodingErrors(data, cache, format, expansionOpts);
+        }
+        const singleReport = buildSingleLintReport(filePath, lintErrors, lintWarnings, report.stateValidation ?? [], { structure_errors: structureErrors, encoding_errors: encodingErrors });
+        if (opts.json) {
+            console.log(JSON.stringify(singleReport, null, 2));
+        }
+        await writeReportHtml("lint", singleReport, opts.reportHtml);
+        process.exitCode = report.exitCode;
+        return;
+    }
+    // Strict checks
+    if (report.encodingErrors.length > 0) {
+        console.error("Encoding errors:");
+        for (const e of report.encodingErrors)
+            console.error(`  ${e}`);
+    }
+    if (report.structureErrors.length > 0) {
+        console.error("Structure errors (strict):");
+        for (const e of report.structureErrors)
+            console.error(`  ${e}`);
+    }
+    // Structural lint
+    const { structural } = report;
+    if (structural.error_count > 0) {
+        console.error("Structural lint errors:");
+        for (const e of structural.errors)
+            console.error(`  ${e}`);
+    }
+    if (structural.warn_count > 0) {
+        console.warn("Structural lint warnings:");
+        for (const w of structural.warnings)
+            console.warn(`  ${w}`);
+    }
+    if (structural.error_count === 0 && structural.warn_count === 0) {
+        console.log("Structural lint: OK");
+    }
+    // Best practices
+    if (report.bestPractices) {
+        const bp = report.bestPractices;
+        if (bp.error_count > 0) {
+            console.error("Best practices errors:");
+            for (const e of bp.errors)
+                console.error(`  ${e}`);
+        }
+        if (bp.warn_count > 0) {
+            console.warn("Best practices warnings:");
+            for (const w of bp.warnings)
+                console.warn(`  ${w}`);
+        }
+        if (bp.error_count === 0 && bp.warn_count === 0) {
+            console.log("Best practices: OK");
+        }
+    }
+    // Tool state validation
+    if (report.stateValidation) {
+        const { validated, skipped } = renderStepResults(report.stateValidation);
+        if (report.stateValidation.length > 0) {
+            console.log(`\nTool state: ${validated} validated, ${skipped} skipped`);
+        }
+    }
+    else if (report.stateSkipped) {
+        console.log("Tool state validation: skipped");
+    }
+    process.exitCode = report.exitCode;
+}
+/** Lint a workflow, returning a structured report. Pure logic — no CLI I/O. */
+export async function lintWorkflowReport(filePath, data, format, opts) {
+    const strict = opts.strict ?? {
+        strictStructure: false,
+        strictEncoding: false,
+        strictState: false,
+    };
+    const fmt = format;
+    // Strict encoding check
+    const encodingErrors = strict.strictEncoding ? checkStrictEncoding(data, fmt) : [];
+    // Strict structure check
+    const structureErrors = strict.strictStructure ? checkStrictStructure(data, fmt) : [];
+    // Phase 1: Structural lint (always runs)
+    const structural = lintWorkflow(data);
+    // Phase 2: Best practices
+    let bestPractices = null;
+    if (!opts.skipBestPractices) {
+        bestPractices =
+            format === "native" ? lintBestPracticesNative(data) : lintBestPracticesFormat2(data);
+    }
+    // Phase 3: Tool state validation
+    let stateValidation = null;
+    let stateSkipped = !!opts.skipStateValidation;
+    if (!opts.skipStateValidation) {
+        const cache = opts.cache;
+        if (!cache) {
+            stateSkipped = true;
+        }
+        else {
+            try {
+                const isEmpty = (await cache.index.listAll()).length === 0;
+                if (isEmpty) {
+                    console.warn("Tool cache is empty — skipping tool state validation");
+                    stateSkipped = true;
+                }
+                else {
+                    const workflowDirectory = dirname(filePath);
+                    const expansionOpts = {
+                        resolver: createDefaultResolver({ workflowDirectory }),
+                    };
+                    if (format === "native") {
+                        stateValidation = await validateNativeSteps(data, cache, "", expansionOpts);
+                    }
+                    else {
+                        stateValidation = await validateFormat2Steps(data, cache, "", expansionOpts);
+                    }
+                }
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                console.warn(`Tool state validation failed: ${msg}`);
+                stateSkipped = true;
+            }
+        }
+    }
+    // Compute exit code: 0 = clean, 1 = warnings only, 2 = errors
+    const merged = mergeLintResults(structural, bestPractices);
+    const hasStateErrors = stateValidation?.some((r) => r.status === "fail") ?? false;
+    const hasStrictErrors = encodingErrors.length > 0 || structureErrors.length > 0;
+    const hasStrictStateSkips = strict.strictState &&
+        (stateValidation?.some((r) => r.status !== "ok" && r.status !== "fail") ?? false);
+    const hasErrors = merged.error_count > 0 || hasStateErrors || hasStrictErrors || hasStrictStateSkips;
+    const hasWarnings = merged.warn_count > 0;
+    const exitCode = hasErrors ? 2 : hasWarnings ? 1 : 0;
+    return {
+        structural,
+        bestPractices,
+        stateValidation,
+        stateSkipped,
+        encodingErrors,
+        structureErrors,
+        exitCode,
+    };
+}
+//# sourceMappingURL=lint.js.map

package/dist/commands/lint.js.map

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

package/dist/commands/list.js

@@ -1,8 +1,8 @@
-import { ToolCache } from "@galaxy-tool-util/core";
+import { makeNodeToolCache } from "@galaxy-tool-util/core/node";
 export async function runList(opts) {
-    const cache = new ToolCache({ cacheDir: opts.cacheDir });
+    const cache = makeNodeToolCache({ cacheDir: opts.cacheDir });
     await cache.index.load();
-    const entries = cache.listCached();
+    const entries = await cache.listCached();
     if (entries.length === 0) {
         console.log("Cache is empty.");
         return;

package/dist/commands/list.js.map

@@ -1 +1 @@
-{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAOnD,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAiB;IAC7C,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,OAAO,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;IAEnC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9C,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAEpF,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACzF,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAExD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,CAAC;AACH,CAAC"}
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAOhE,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAiB;IAC7C,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,OAAO,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;IAEzC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9C,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAEpF,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACzF,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAExD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,CAAC;AACH,CAAC"}

package/dist/commands/populate-workflow.d.ts

@@ -0,0 +1,6 @@
+export interface PopulateWorkflowOptions {
+    cacheDir?: string;
+    galaxyUrl?: string;
+}
+export declare function runPopulateWorkflow(filePath: string, opts: PopulateWorkflowOptions): Promise<void>;
+//# sourceMappingURL=populate-workflow.d.ts.map

package/dist/commands/populate-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"populate-workflow.d.ts","sourceRoot":"","sources":["../../src/commands/populate-workflow.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAgDf"}

package/dist/commands/populate-workflow.js

@@ -0,0 +1,55 @@
+/**
+ * `galaxy-tool-cache populate-workflow` — scan workflow(s) for tool references
+ * and populate the cache with each unique tool.
+ */
+import { makeNodeToolInfoService } from "@galaxy-tool-util/core/node";
+import { expandedNative, expandedFormat2, } from "@galaxy-tool-util/schema";
+import { dirname } from "node:path";
+import { readWorkflowFile, resolveFormat } from "./workflow-io.js";
+import { createDefaultResolver } from "./url-resolver.js";
+export async function runPopulateWorkflow(filePath, opts) {
+    const data = await readWorkflowFile(filePath);
+    if (!data)
+        return;
+    const format = resolveFormat(data);
+    const workflowDirectory = dirname(filePath);
+    const expansionOpts = {
+        resolver: createDefaultResolver({ workflowDirectory }),
+    };
+    let tools;
+    if (format === "native") {
+        const expanded = await expandedNative(data, expansionOpts);
+        tools = expanded.unique_tools;
+    }
+    else {
+        const expanded = await expandedFormat2(data, expansionOpts);
+        tools = expanded.unique_tools;
+    }
+    if (tools.size === 0) {
+        console.log("No tool steps found in workflow.");
+        return;
+    }
+    const service = makeNodeToolInfoService({
+        cacheDir: opts.cacheDir,
+        galaxyUrl: opts.galaxyUrl,
+    });
+    let cached = 0;
+    let failed = 0;
+    const total = tools.size;
+    for (const ref of tools) {
+        const result = await service.getToolInfo(ref.tool_id, ref.tool_version);
+        if (result) {
+            cached++;
+            console.log(`  Cached: ${ref.tool_id} v${ref.tool_version ?? "latest"}`);
+        }
+        else {
+            failed++;
+            console.warn(`  Failed: ${ref.tool_id} v${ref.tool_version ?? "latest"}`);
+        }
+    }
+    console.log(`\nPopulated ${cached}/${total} tools${failed > 0 ? `, ${failed} failed` : ""}`);
+    if (failed > 0) {
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=populate-workflow.js.map

package/dist/commands/populate-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"populate-workflow.js","sourceRoot":"","sources":["../../src/commands/populate-workflow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EACL,cAAc,EACd,eAAe,GAGhB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAO1D,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAAgB,EAChB,IAA6B;IAE7B,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,CAAC,IAAI;QAAE,OAAO;IAElB,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,aAAa,GAAqB;QACtC,QAAQ,EAAE,qBAAqB,CAAC,EAAE,iBAAiB,EAAE,CAAC;KACvD,CAAC;IAEF,IAAI,KAAyB,CAAC;IAC9B,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QAC3D,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC;IAChC,CAAC;SAAM,CAAC;QACN,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QAC5D,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC;IAChC,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAChD,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,uBAAuB,CAAC;QACtC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC,CAAC;IAEH,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC;IAEzB,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;QACxE,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,EAAE,CAAC;YACT,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC,YAAY,IAAI,QAAQ,EAAE,CAAC,CAAC;QAC3E,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,CAAC;YACT,OAAO,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC,YAAY,IAAI,QAAQ,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,IAAI,KAAK,SAAS,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7F,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/commands/render-results.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared rendering for ValidationStepResult arrays.
+ */
+import { type ValidationStepResult } from "@galaxy-tool-util/schema";
+export interface RenderSummary {
+    validated: number;
+    skipped: number;
+}
+/** Render step validation results to console, returning counts. */
+export declare function renderStepResults(results: ValidationStepResult[]): RenderSummary;
+//# sourceMappingURL=render-results.d.ts.map

package/dist/commands/render-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-results.d.ts","sourceRoot":"","sources":["../../src/commands/render-results.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEpF,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,aAAa,CAiBhF"}

package/dist/commands/render-results.js

@@ -0,0 +1,27 @@
+/**
+ * Shared rendering for ValidationStepResult arrays.
+ */
+import { SKIP_STATUSES } from "@galaxy-tool-util/schema";
+/** Render step validation results to console, returning counts. */
+export function renderStepResults(results) {
+    let validated = 0;
+    let skipped = 0;
+    for (const r of results) {
+        if (SKIP_STATUSES.has(r.status)) {
+            skipped++;
+            console.warn(`  [${r.step}] skipped — ${r.errors[0] ?? "unknown"}`);
+        }
+        else if (r.status === "fail") {
+            validated++;
+            console.error(`  [${r.step}] tool_state errors (${r.tool_id}):`);
+            for (const line of r.errors)
+                console.error(`    ${line}`);
+        }
+        else {
+            validated++;
+            console.log(`  [${r.step}] tool_state: OK`);
+        }
+    }
+    return { validated, skipped };
+}
+//# sourceMappingURL=render-results.js.map

package/dist/commands/render-results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-results.js","sourceRoot":"","sources":["../../src/commands/render-results.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,aAAa,EAA6B,MAAM,0BAA0B,CAAC;AAOpF,mEAAmE;AACnE,MAAM,UAAU,iBAAiB,CAAC,OAA+B;IAC/D,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC;QACtE,CAAC;aAAM,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC/B,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,wBAAwB,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;YACjE,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,MAAM;gBAAE,OAAO,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AAChC,CAAC"}

package/dist/commands/report-output.d.ts

@@ -0,0 +1,34 @@
+export type ReportType = "validate" | "lint" | "clean" | "validate-tree" | "lint-tree" | "clean-tree" | "roundtrip-tree";
+export interface ReportOutputOptions {
+    /**
+     * Path to write Markdown report to. Commander sets this to `true` (boolean)
+     * when `--report-markdown` is passed without a filename — treat as stdout.
+     * Use `"-"` explicitly to write to stdout.
+     */
+    reportMarkdown?: string | boolean;
+    /** Same semantics as reportMarkdown but for HTML output. */
+    reportHtml?: string | boolean;
+}
+/**
+ * Render and write report output if --report-markdown / --report-html flags
+ * were passed. Both can be specified simultaneously.
+ *
+ * @param templateName - e.g. "validate_tree.md.j2"
+ * @param report - the tree report object
+ * @param opts - parsed CLI options
+ */
+export declare function writeReportOutput(templateName: string, report: unknown, opts: ReportOutputOptions): Promise<void>;
+/**
+ * Generate a standalone HTML page that loads the gxwf-report-shell IIFE
+ * bundle from CDN and renders the given report data.
+ *
+ * The resulting HTML is self-contained (aside from the CDN network request).
+ * Use this for --report-html on single-workflow and tree commands.
+ */
+export declare function buildReportHtml(type: ReportType, data: unknown, title?: string): string;
+/**
+ * Write an HTML report to the given destination if set.
+ * dest follows the same string | boolean convention as reportHtml/reportMarkdown.
+ */
+export declare function writeReportHtml(type: ReportType, data: unknown, dest: string | boolean | undefined, title?: string): Promise<void>;
+//# sourceMappingURL=report-output.d.ts.map

package/dist/commands/report-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-output.d.ts","sourceRoot":"","sources":["../../src/commands/report-output.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,MAAM,GACN,OAAO,GACP,eAAe,GACf,WAAW,GACX,YAAY,GACZ,gBAAgB,CAAC;AAErB,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,SAAgB,GAAG,MAAM,CAgB9F;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,EAClC,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/commands/report-output.js

@@ -0,0 +1,70 @@
+/**
+ * Helpers for writing Markdown/HTML rendered reports from CLI commands.
+ */
+import { writeFile } from "node:fs/promises";
+import { renderReport } from "../workflow/report-templates.js";
+// Pin to a specific published gxwf-report-shell version.
+// Bump when a new shell version with user-visible changes is released to npm.
+const SHELL_CDN_VERSION = "0.1.0";
+const SHELL_CDN_BASE = `https://cdn.jsdelivr.net/npm/@galaxy-tool-util/gxwf-report-shell@${SHELL_CDN_VERSION}/dist`;
+/**
+ * Render and write report output if --report-markdown / --report-html flags
+ * were passed. Both can be specified simultaneously.
+ *
+ * @param templateName - e.g. "validate_tree.md.j2"
+ * @param report - the tree report object
+ * @param opts - parsed CLI options
+ */
+export async function writeReportOutput(templateName, report, opts) {
+    const dest = opts.reportMarkdown;
+    if (!dest)
+        return;
+    const content = await renderReport(templateName, report);
+    // Commander sets dest = true when flag is passed without a filename argument
+    if (dest === true || dest === "-") {
+        process.stdout.write(content);
+    }
+    else {
+        await writeFile(dest, content, "utf-8");
+    }
+}
+/**
+ * Generate a standalone HTML page that loads the gxwf-report-shell IIFE
+ * bundle from CDN and renders the given report data.
+ *
+ * The resulting HTML is self-contained (aside from the CDN network request).
+ * Use this for --report-html on single-workflow and tree commands.
+ */
+export function buildReportHtml(type, data, title = "gxwf Report") {
+    const payload = JSON.stringify({ type, data });
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${title}</title>
+  <link rel="stylesheet" href="${SHELL_CDN_BASE}/shell.css">
+</head>
+<body>
+  <div id="gxwf-report"></div>
+  <script>window.__GXWF_REPORT__ = ${payload};</script>
+  <script src="${SHELL_CDN_BASE}/shell.iife.js"></script>
+</body>
+</html>`;
+}
+/**
+ * Write an HTML report to the given destination if set.
+ * dest follows the same string | boolean convention as reportHtml/reportMarkdown.
+ */
+export async function writeReportHtml(type, data, dest, title) {
+    if (!dest)
+        return;
+    const content = buildReportHtml(type, data, title);
+    if (dest === true || dest === "-") {
+        process.stdout.write(content);
+    }
+    else {
+        await writeFile(dest, content, "utf-8");
+    }
+}
+//# sourceMappingURL=report-output.js.map

package/dist/commands/report-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-output.js","sourceRoot":"","sources":["../../src/commands/report-output.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAE/D,yDAAyD;AACzD,8EAA8E;AAC9E,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAClC,MAAM,cAAc,GAAG,oEAAoE,iBAAiB,OAAO,CAAC;AAsBpH;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,YAAoB,EACpB,MAAe,EACf,IAAyB;IAEzB,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC;IACjC,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACzD,6EAA6E;IAC7E,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;SAAM,CAAC;QACN,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,IAAgB,EAAE,IAAa,EAAE,KAAK,GAAG,aAAa;IACpF,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,OAAO;;;;;WAKE,KAAK;iCACiB,cAAc;;;;qCAIV,OAAO;iBAC3B,cAAc;;QAEvB,CAAC;AACT,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAgB,EAChB,IAAa,EACb,IAAkC,EAClC,KAAc;IAEd,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACnD,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;SAAM,CAAC;QACN,MAAM,SAAS,CAAC,IAAc,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;AACH,CAAC"}

package/dist/commands/resolve-tool.js

@@ -7,7 +7,7 @@ export async function loadCachedTool(cache, toolId, version) {
     if (coords.version === null) {
         return { kind: "no_version", toolId };
     }
-    const key = cacheKey(coords.toolshedUrl, coords.trsToolId, coords.version);
+    const key = await cacheKey(coords.toolshedUrl, coords.trsToolId, coords.version);
     const tool = await cache.loadCached(key);
     if (tool === null) {
         return { kind: "not_cached", toolId, key };

package/dist/commands/resolve-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-tool.js","sourceRoot":"","sources":["../../src/commands/resolve-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,QAAQ,EAAmB,MAAM,wBAAwB,CAAC;AAWnF,MAAM,UAAU,cAAc,CAAC,CAA8B;IAC3D,OAAO,MAAM,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAgB,EAChB,MAAc,EACd,OAAuB;IAEvB,MAAM,MAAM,GAAG,KAAK,CAAC,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7D,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;IACxC,CAAC;IACD,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AACvB,CAAC"}
+{"version":3,"file":"resolve-tool.js","sourceRoot":"","sources":["../../src/commands/resolve-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,QAAQ,EAAmB,MAAM,wBAAwB,CAAC;AAWnF,MAAM,UAAU,cAAc,CAAC,CAA8B;IAC3D,OAAO,MAAM,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAgB,EAChB,MAAc,EACd,OAAuB;IAEvB,MAAM,MAAM,GAAG,KAAK,CAAC,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7D,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;IACxC,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACjF,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AACvB,CAAC"}

package/dist/commands/roundtrip-tree.d.ts

@@ -0,0 +1,15 @@
+import { type StrictOptions } from "./strict-options.js";
+import { type ReportOutputOptions } from "./report-output.js";
+export interface RoundtripTreeOptions extends StrictOptions, ReportOutputOptions {
+    cacheDir?: string;
+    format?: string;
+    json?: boolean;
+    /** Only list files with error-severity diffs or failures. */
+    errorsOnly?: boolean;
+    /** Only list files with benign diffs (no errors, no failures). */
+    benignOnly?: boolean;
+    /** Suppress per-file lines; print only the aggregate summary. */
+    brief?: boolean;
+}
+export declare function runRoundtripTree(dir: string, opts: RoundtripTreeOptions): Promise<void>;
+//# sourceMappingURL=roundtrip-tree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"roundtrip-tree.d.ts","sourceRoot":"","sources":["../../src/commands/roundtrip-tree.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAI/E,OAAO,EAAsC,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAElG,MAAM,WAAW,oBAAqB,SAAQ,aAAa,EAAE,mBAAmB;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kEAAkE;IAClE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAQD,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4I7F"}