@galaxy-tool-util/schema 0.2.0 → 0.4.0

package/dist/workflow/report-models.js

@@ -0,0 +1,342 @@
+/**
+ * Structured report models for CLI and API output.
+ *
+ * These types mirror Python's `galaxy.tool_util.workflow_state._report_models`
+ * exactly — field names are snake_case, status literals match, and JSON shape
+ * is identical so that the same frontend rendering code works for both.
+ *
+ * Hierarchy:
+ *   Step-level  →  Single-workflow wrappers  →  Tree-level reports
+ */
+export const SKIP_STATUSES = new Set([
+    "skip_tool_not_found",
+    "skip_replacement_params",
+]);
+// ── Builder helpers ──────────────────────────────────────────────────
+/** Compute summary counts for a list of step results. */
+export function validationSummary(results) {
+    let ok = 0;
+    let fail = 0;
+    let skip = 0;
+    for (const r of results) {
+        if (r.status === "ok")
+            ok++;
+        else if (r.status === "fail")
+            fail++;
+        else
+            skip++;
+    }
+    return { ok, fail, skip };
+}
+/** Build flat failure list from step results (for template rendering). */
+export function validationFailures(results) {
+    const out = [];
+    for (const sr of results) {
+        if (sr.status !== "fail")
+            continue;
+        for (const err of sr.errors) {
+            out.push({ step: sr.step, tool_id: sr.tool_id, message: err });
+        }
+    }
+    return out;
+}
+/** Compute display_label matching Python's CleanStepResult. */
+export function cleanDisplayLabel(tool_id, version) {
+    let label = tool_id ?? "unknown";
+    if (version)
+        label += ` ${version}`;
+    return label;
+}
+/** Compute category from a relative path (directory portion, or "(root)"). */
+export function categoryOf(relativePath) {
+    const lastSlash = relativePath.lastIndexOf("/");
+    if (lastSlash < 0)
+        return "(root)";
+    const dir = relativePath.slice(0, lastSlash);
+    return dir || "(root)";
+}
+/** Extract basename from a path (portion after last slash). Avoids node:path for browser compat. */
+function baseName(path) {
+    const lastSlash = path.lastIndexOf("/");
+    return lastSlash < 0 ? path : path.slice(lastSlash + 1);
+}
+/** Group results by category, sorted by name. */
+export function groupByCategory(results) {
+    const groups = new Map();
+    for (const r of results) {
+        const cat = r.category || "(root)";
+        let list = groups.get(cat);
+        if (!list) {
+            list = [];
+            groups.set(cat, list);
+        }
+        list.push(r);
+    }
+    return Array.from(groups.entries())
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([name, results]) => ({ name, results }));
+}
+// ── Single-workflow report builders ──────────────────────────────────
+export function buildSingleValidationReport(workflow, results, opts) {
+    return {
+        workflow,
+        results,
+        connection_report: null,
+        skipped_reason: opts?.skipped_reason ?? null,
+        structure_errors: opts?.structure_errors ?? [],
+        encoding_errors: opts?.encoding_errors ?? [],
+        summary: validationSummary(results),
+    };
+}
+export function buildSingleLintReport(workflow, lint_errors, lint_warnings, results, opts) {
+    const summary = validationSummary(results);
+    return {
+        workflow,
+        lint_errors,
+        lint_warnings,
+        results,
+        structure_errors: opts?.structure_errors ?? [],
+        encoding_errors: opts?.encoding_errors ?? [],
+        summary: {
+            lint_errors,
+            lint_warnings,
+            state_ok: summary.ok,
+            state_fail: summary.fail,
+            state_skip: summary.skip,
+        },
+    };
+}
+export function buildSingleCleanReport(workflow, results) {
+    return {
+        workflow,
+        results,
+        total_removed: results.reduce((n, r) => n + r.removed_keys.length, 0),
+        steps_with_removals: results.filter((r) => r.removed_keys.length > 0).length,
+    };
+}
+// ── Tree workflow-level result builders ──────────────────────────────
+export function buildWorkflowValidationResult(relativePath, stepResults, opts) {
+    const hasError = !!(opts?.error || opts?.skipped_reason);
+    return {
+        path: relativePath,
+        category: categoryOf(relativePath),
+        name: baseName(relativePath),
+        error: opts?.error ?? null,
+        skipped_reason: opts?.skipped_reason ?? null,
+        results: stepResults,
+        connection_report: null,
+        summary: hasError ? null : validationSummary(stepResults),
+        failures: hasError ? null : validationFailures(stepResults),
+    };
+}
+export function buildLintWorkflowResult(relativePath, lint_errors, lint_warnings, stepResults, opts) {
+    const hasError = !!(opts?.error || opts?.skipped_reason);
+    return {
+        path: relativePath,
+        category: categoryOf(relativePath),
+        name: baseName(relativePath),
+        error: opts?.error ?? null,
+        skipped_reason: opts?.skipped_reason ?? null,
+        lint_errors,
+        lint_warnings,
+        results: stepResults,
+        step_counts: hasError ? null : validationSummary(stepResults),
+    };
+}
+export function buildWorkflowCleanResult(relativePath, stepResults, opts) {
+    return {
+        path: relativePath,
+        category: categoryOf(relativePath),
+        name: baseName(relativePath),
+        error: opts?.error ?? null,
+        skipped_reason: opts?.skipped_reason ?? null,
+        results: stepResults,
+        total_removed: stepResults.reduce((n, r) => n + r.removed_keys.length, 0),
+        steps_affected: stepResults.filter((r) => r.removed_keys.length > 0).length,
+    };
+}
+// ── Tree report builders ─────────────────────────────────────────────
+export function buildTreeValidationReport(root, workflows) {
+    let ok = 0;
+    let fail = 0;
+    let skip = 0;
+    let error = 0;
+    let skipped = 0;
+    const all_failures = [];
+    for (const r of workflows) {
+        if (r.skipped_reason) {
+            skipped++;
+            continue;
+        }
+        if (r.error) {
+            error++;
+            continue;
+        }
+        for (const sr of r.results) {
+            if (sr.status === "ok")
+                ok++;
+            else if (sr.status === "fail")
+                fail++;
+            else
+                skip++;
+        }
+        for (const f of r.failures ?? []) {
+            all_failures.push({ workflow: r.path, ...f });
+        }
+    }
+    return {
+        root,
+        workflows,
+        categories: groupByCategory(workflows),
+        all_failures,
+        summary: { ok, fail, skip, error, skipped },
+    };
+}
+export function buildLintTreeReport(root, workflows) {
+    let lint_errors = 0;
+    let lint_warnings = 0;
+    let state_ok = 0;
+    let state_fail = 0;
+    let state_skip = 0;
+    let errors = 0;
+    let skipped = 0;
+    for (const r of workflows) {
+        if (r.skipped_reason) {
+            skipped++;
+            continue;
+        }
+        if (r.error) {
+            errors++;
+            continue;
+        }
+        lint_errors += r.lint_errors;
+        lint_warnings += r.lint_warnings;
+        for (const sr of r.results) {
+            if (sr.status === "ok")
+                state_ok++;
+            else if (sr.status === "fail")
+                state_fail++;
+            else
+                state_skip++;
+        }
+    }
+    return {
+        root,
+        workflows,
+        categories: groupByCategory(workflows),
+        summary: { lint_errors, lint_warnings, state_ok, state_fail, state_skip, errors, skipped },
+    };
+}
+export function buildWorkflowExportResult(relativePath, opts = {}) {
+    const { ok = false, steps_converted = 0, steps_fallback = 0, error = null, skipped_reason = null, } = opts;
+    let status;
+    if (error)
+        status = "error";
+    else if (skipped_reason)
+        status = "skipped";
+    else if (ok)
+        status = "ok";
+    else
+        status = "partial";
+    return {
+        path: relativePath,
+        category: categoryOf(relativePath),
+        name: baseName(relativePath),
+        error,
+        skipped_reason,
+        ok,
+        steps_converted,
+        steps_fallback,
+        status,
+    };
+}
+export function buildExportTreeReport(root, output_dir, workflows) {
+    const ok = workflows.filter((r) => r.ok && !r.error && !r.skipped_reason).length;
+    const fail = workflows.filter((r) => !!r.error).length;
+    const skipped = workflows.filter((r) => !!r.skipped_reason).length;
+    return { root, output_dir, workflows, summary: { ok, fail, skipped } };
+}
+export function buildWorkflowToNativeResult(relativePath, opts = {}) {
+    const { ok = false, steps_encoded = 0, steps_fallback = 0, error = null, skipped_reason = null, } = opts;
+    let status;
+    if (error)
+        status = "error";
+    else if (skipped_reason)
+        status = "skipped";
+    else if (ok)
+        status = "ok";
+    else
+        status = "partial";
+    return {
+        path: relativePath,
+        category: categoryOf(relativePath),
+        name: baseName(relativePath),
+        error,
+        skipped_reason,
+        ok,
+        steps_encoded,
+        steps_fallback,
+        status,
+    };
+}
+export function buildToNativeTreeReport(root, output_dir, workflows) {
+    const ok = workflows.filter((r) => r.ok && !r.error && !r.skipped_reason).length;
+    const fail = workflows.filter((r) => !!r.error).length;
+    const skipped = workflows.filter((r) => !!r.skipped_reason).length;
+    return { root, output_dir, workflows, summary: { ok, fail, skipped } };
+}
+export function buildRoundTripTreeReport(root, workflows) {
+    let clean = 0, benign_only = 0, fail = 0, error = 0, skipped = 0;
+    for (const r of workflows) {
+        const status = r.status;
+        if (status === "skipped")
+            skipped++;
+        else if (status === "error")
+            error++;
+        else if (status === "ok") {
+            if (r.benign_diffs.length > 0)
+                benign_only++;
+            else
+                clean++;
+        }
+        else
+            fail++;
+    }
+    const tool_failure_modes = [];
+    return {
+        root,
+        workflows,
+        total: workflows.length,
+        summary: { clean, benign_only, fail, error, skipped },
+        tool_failure_modes,
+    };
+}
+export function buildTreeCleanReport(root, workflows) {
+    let total_keys = 0;
+    let affected = 0;
+    let clean = 0;
+    let errors = 0;
+    let skipped = 0;
+    for (const r of workflows) {
+        if (r.skipped_reason) {
+            skipped++;
+            continue;
+        }
+        if (r.error) {
+            errors++;
+            continue;
+        }
+        total_keys += r.total_removed;
+        if (r.total_removed > 0)
+            affected++;
+        else
+            clean++;
+    }
+    return {
+        root,
+        workflows,
+        categories: groupByCategory(workflows),
+        summary: { total_keys, affected, clean, errors, skipped },
+    };
+}
+//# sourceMappingURL=report-models.js.map

package/dist/workflow/report-models.js.map

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

package/dist/workflow/roundtrip.d.ts

@@ -1,8 +1,21 @@
 import type { StepConversionStatus, ToolInputsResolver } from "./normalized/stateful-runner.js";
+import type { DiffSeverity, StepDiff } from "./report-models.js";
+/**
+ * TS-internal failure class for roundtrip steps. Intentionally narrower than
+ * the Python-API-mirror `FailureClass` in `report-models.ts`.
+ *
+ * Gap vs `FailureClass`: Python has `"native_validation"`, `"type_not_handled"`,
+ * `"format2_validation"`, `"parse_error"`, `"other"` which the TS roundtrip
+ * algorithm does not produce. TS has `"subworkflow_external_ref"` which has no
+ * direct Python equivalent (closest: Python's `"subworkflow"`).
+ *
+ * If building a `StepResult` (Python API shape) from a `StepRoundtripResult`,
+ * map `"subworkflow_external_ref"` → `null` or add it to `FailureClass`.
+ */
 export type RoundtripFailureClass = "conversion_error" | "reimport_error" | "roundtrip_mismatch"
 /** Subworkflow ref was an external URL/TRS string — inline steps not available for diff. */
  | "subworkflow_external_ref";
-export type DiffSeverity = "error" | "benign";
+export type { DiffSeverity, StepDiff };
 export type BenignArtifactKind = "type_coercion" | "multi_select_normalized" | "all_null_section_omitted" | "empty_container_omitted" | "connection_only_section_omitted" | "bookkeeping_stripped"
 /**
  * Runtime-leak key (`__workflow_invocation_uuid__` or `*|__identifier__`)
@@ -10,12 +23,6 @@ export type BenignArtifactKind = "type_coercion" | "multi_select_normalized" | "
  * stateful conversion; mirrors Galaxy's `RUNTIME_LEAK` classification.
  */
  | "runtime_leak_stripped";
-export interface StepDiff {
-    path: string;
-    severity: DiffSeverity;
-    kind?: BenignArtifactKind;
-    message: string;
-}
 export interface StepRoundtripResult {
     stepId: string;
     toolId?: string;
@@ -41,6 +48,22 @@ export interface RoundtripResult {
     success: boolean;
     /** No diffs at all (clean roundtrip). */
     clean: boolean;
+    /** Strict-encoding errors across all stages (input, forward output, reverse output). */
+    encodingErrors: string[];
+    /** Strict-structure errors across all stages (input, forward output, reverse output). */
+    structureErrors: string[];
+    /**
+     * The re-imported native workflow dict (result of format2→native reverse pass).
+     * Only populated on successful roundtrip. Cast to Record<string, unknown> for
+     * serialization (same pattern as operateToNative in the server layer).
+     */
+    reimportedWorkflow?: unknown;
+}
+/** Options controlling strict validation within roundtripValidate. */
+export interface RoundtripStrictOptions {
+    strictEncoding?: boolean;
+    strictStructure?: boolean;
+    strictState?: boolean;
 }
 /**
  * Roundtrip a native workflow through format2 and back, diffing each
@@ -50,5 +73,5 @@ export interface RoundtripResult {
  * Returns `success=true` iff no error-severity diffs and no conversion
  * failures. `clean=true` iff there are zero diffs of any severity.
  */
-export declare function roundtripValidate(nativeRaw: unknown, toolInputsResolver: ToolInputsResolver): RoundtripResult;
+export declare function roundtripValidate(nativeRaw: unknown, toolInputsResolver: ToolInputsResolver, strictOpts?: RoundtripStrictOptions): RoundtripResult;
 //# sourceMappingURL=roundtrip.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"roundtrip.d.ts","sourceRoot":"","sources":["../../src/workflow/roundtrip.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAQhG,MAAM,MAAM,qBAAqB,GAC7B,kBAAkB,GAClB,gBAAgB,GAChB,oBAAoB;AACtB,4FAA4F;GAC1F,0BAA0B,CAAC;AAE/B,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE9C,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,yBAAyB,GACzB,0BAA0B,GAC1B,yBAAyB,GACzB,iCAAiC,GACjC,sBAAsB;AACxB;;;;GAIG;GACD,uBAAuB,CAAC;AAE5B,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,yEAAyE;IACzE,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,yEAAyE;IACzE,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,2EAA2E;IAC3E,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,KAAK,EAAE,OAAO,CAAC;CAChB;AA4VD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,OAAO,EAClB,kBAAkB,EAAE,kBAAkB,GACrC,eAAe,CAyKjB"}
+{"version":3,"file":"roundtrip.d.ts","sourceRoot":"","sources":["../../src/workflow/roundtrip.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAMhG,OAAO,KAAK,EAAkB,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAIjF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,qBAAqB,GAC7B,kBAAkB,GAClB,gBAAgB,GAChB,oBAAoB;AACtB,4FAA4F;GAC1F,0BAA0B,CAAC;AAE/B,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEvC,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,yBAAyB,GACzB,0BAA0B,GAC1B,yBAAyB,GACzB,iCAAiC,GACjC,sBAAsB;AACxB;;;;GAIG;GACD,uBAAuB,CAAC;AAO5B,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,yEAAyE;IACzE,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,yEAAyE;IACzE,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,2EAA2E;IAC3E,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,wFAAwF;IACxF,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,yFAAyF;IACzF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,sEAAsE;AACtE,MAAM,WAAW,sBAAsB;IACrC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAoYD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,OAAO,EAClB,kBAAkB,EAAE,kBAAkB,EACtC,UAAU,CAAC,EAAE,sBAAsB,GAClC,eAAe,CAiOjB"}