@galaxy-tool-util/schema 0.1.0 → 0.4.0

package/dist/workflow/clean.js

@@ -4,14 +4,40 @@
  * Port of Galaxy's workflow_state clean operation. Removes bookkeeping keys
  * (__page__, __rerun_remap_job_id__), runtime leak keys (chromInfo, __input_ext),
  * and decodes JSON-encoded tool_state strings into proper dicts.
+ *
+ * Also strips Galaxy-injected structural properties (`uuid`, `errors`) from both
+ * native and format2 workflow and step dicts.
+ *
+ * Also provides a tool-definition-aware strip (`stripStaleKeysToolAware`)
+ * that mirrors Galaxy's `clean._strip_recursive`: uses the declared
+ * parameter tree to drop any undeclared key (runtime leaks, stale-branch
+ * params, tool-upgrade residue) honoring conditional branch selection,
+ * repeat expansion, and section nesting.
  */
+import { cleanDisplayLabel } from "./report-models.js";
+import { detectFormat } from "./detect-format.js";
+import { walkNativeState, walkFormat2State, SKIP_VALUE } from "./walker.js";
 /** Keys injected by Galaxy's tool form machinery — never meaningful in saved workflows. */
 const BOOKKEEPING_KEYS = new Set(["__page__", "__rerun_remap_job_id__"]);
+/** Canonical position keys — only left/top are kept; browser-computed extras are stripped. */
+const POSITION_CANONICAL_KEYS = new Set(["left", "top"]);
 /** Keys leaked from runtime context into saved state. */
 const RUNTIME_LEAK_KEYS = new Set(["chromInfo", "__input_ext"]);
 /** Internal indexing keys within conditionals and repeats. */
 const INTERNAL_KEYS = new Set(["__current_case__", "__index__"]);
 const STALE_KEYS = new Set([...BOOKKEEPING_KEYS, ...RUNTIME_LEAK_KEYS, ...INTERNAL_KEYS]);
+/**
+ * Galaxy-injected structural properties — present on workflow and step dicts
+ * in both native and format2 exports, but not meaningful in saved/shared
+ * workflows. Stripped from workflow-level and step-level dicts.
+ *
+ * `position` is intentionally excluded — it is a legitimate workflow property
+ * that VS Code and other tools may use.
+ *
+ * `errors` is always stripped. `uuid` is stripped by default but can be
+ * suppressed with `CleanWorkflowOptions.skipUuid`.
+ */
+const ALWAYS_STRIP_STEP_KEYS = new Set(["errors"]);
 /**
  * Decode a legacy JSON-encoded tool_state value. If the value is a string
  * that parses to a compound type (object/array), return the parsed value and
@@ -68,12 +94,14 @@ function parseToolState(toolState) {
     }
     return null;
 }
-/** Recursively remove stale keys from a tool_state dict. */
-function stripStaleKeys(state) {
+/** Recursively remove stale keys from a tool_state dict, tracking removed top-level keys. */
+function stripStaleKeys(state, removedKeys) {
     const result = {};
     for (const [key, value] of Object.entries(state)) {
-        if (STALE_KEYS.has(key))
+        if (STALE_KEYS.has(key)) {
+            removedKeys?.push(key);
             continue;
+        }
         result[key] = stripStaleValue(value);
     }
     return result;
@@ -88,44 +116,216 @@ function stripStaleValue(value) {
     }
     return value;
 }
-/** Clean a single native step's tool_state in place. */
-function cleanNativeStep(stepDef) {
-    const toolId = stepDef.tool_id;
-    if (!toolId)
-        return;
+/**
+ * Strip Galaxy-injected structural properties from a step dict in-place.
+ * Always removes `errors`; removes `uuid` unless `skipUuid` is true.
+ * Returns the list of keys actually removed.
+ */
+function stripStructuralStep(stepDict, skipUuid) {
+    const removed = [];
+    for (const key of ALWAYS_STRIP_STEP_KEYS) {
+        if (key in stepDict) {
+            delete stepDict[key];
+            removed.push(key);
+        }
+    }
+    if (!skipUuid && "uuid" in stepDict) {
+        delete stepDict.uuid;
+        removed.push("uuid");
+    }
+    return removed;
+}
+/** Clean a single native step's tool_state in place, returning step result info. */
+async function cleanNativeStep(stepDef, stepLabel, opts) {
+    const toolId = stepDef.tool_id ?? null;
+    const toolVersion = stepDef.tool_version ?? null;
+    // Strip structural properties from the step dict itself (uuid, errors)
+    const removedKeys = stripStructuralStep(stepDef, opts.skipUuid ?? false);
+    if (!toolId) {
+        return {
+            step: stepLabel,
+            tool_id: null,
+            version: null,
+            removed_keys: removedKeys,
+            skipped: true,
+            skip_reason: "no tool_id",
+            display_label: cleanDisplayLabel(null, null),
+        };
+    }
     const rawState = stepDef.tool_state;
-    if (rawState === undefined || rawState === null)
-        return;
+    if (rawState === undefined || rawState === null) {
+        return {
+            step: stepLabel,
+            tool_id: toolId,
+            version: toolVersion,
+            removed_keys: removedKeys,
+            skipped: true,
+            skip_reason: "no tool_state",
+            display_label: cleanDisplayLabel(toolId, toolVersion),
+        };
+    }
     const parsed = parseToolState(rawState);
-    if (!parsed)
-        return;
-    stepDef.tool_state = stripStaleKeys(parsed);
+    if (!parsed) {
+        return {
+            step: stepLabel,
+            tool_id: toolId,
+            version: toolVersion,
+            removed_keys: removedKeys,
+            skipped: true,
+            skip_reason: "unparseable tool_state",
+            display_label: cleanDisplayLabel(toolId, toolVersion),
+        };
+    }
+    let cleaned = stripStaleKeys(parsed, removedKeys);
+    // Tool-aware strip: drop keys not in the tool's parameter tree
+    if (opts.toolInputsResolver) {
+        const inputs = opts.toolInputsResolver(toolId, toolVersion);
+        if (inputs) {
+            const inputConnections = (stepDef.input_connections ?? {});
+            cleaned = stripStaleKeysToolAware(cleaned, inputs, inputConnections);
+        }
+    }
+    stepDef.tool_state = cleaned;
+    return {
+        step: stepLabel,
+        tool_id: toolId,
+        version: toolVersion,
+        removed_keys: removedKeys,
+        skipped: false,
+        skip_reason: "",
+        display_label: cleanDisplayLabel(toolId, toolVersion),
+    };
+}
+/** Normalize a step's position dict to only canonical keys (left, top). */
+function normalizeStepPosition(stepDef) {
+    const pos = stepDef.position;
+    if (pos !== null && typeof pos === "object" && !Array.isArray(pos)) {
+        for (const key of Object.keys(pos)) {
+            if (!POSITION_CANONICAL_KEYS.has(key)) {
+                delete pos[key];
+            }
+        }
+    }
 }
 /** Recursively clean all steps in a native workflow dict. */
-function cleanNativeSteps(workflowDict) {
+async function cleanNativeSteps(workflowDict, opts, prefix = "") {
     const steps = workflowDict.steps;
     if (!steps)
-        return;
-    for (const stepDef of Object.values(steps)) {
-        // Subworkflow steps don't have meaningful tool_state — recurse into the
-        // embedded subworkflow's steps instead.
+        return [];
+    const results = [];
+    for (const [key, stepDef] of Object.entries(steps)) {
+        const stepLabel = prefix ? `${prefix}${key}` : key;
+        normalizeStepPosition(stepDef);
         if (stepDef.type === "subworkflow" && stepDef.subworkflow) {
-            cleanNativeSteps(stepDef.subworkflow);
+            results.push(...(await cleanNativeSteps(stepDef.subworkflow, opts, `${stepLabel}.`)));
             continue;
         }
-        cleanNativeStep(stepDef);
+        results.push(await cleanNativeStep(stepDef, stepLabel, opts));
     }
+    return results;
+}
+/**
+ * Strip all keys from a native step's `tool_state` that are not declared in
+ * the tool's parameter tree. Mirrors Galaxy's `clean._strip_recursive`.
+ *
+ * Uses `walkNativeState` with an identity leaf callback: the walker builds
+ * its output from declared params only, silently dropping undeclared keys
+ * (runtime leaks like `|__identifier__`, stale-branch conditional params,
+ * tool-upgrade residue). Missing declared leaves are omitted via
+ * `SKIP_VALUE` rather than written back as `undefined`.
+ *
+ * Used by `roundtripValidate` to pre-clean the original workflow before
+ * diffing (matches Galaxy's `roundtrip_validate(clean_stale=True)`
+ * default).
+ *
+ * @param state - Raw tool_state dict (parsed, not a JSON string)
+ * @param toolInputs - Declared parameter models from the tool definition
+ * @param inputConnections - Flat connection map; only used for repeat
+ *   instance-count inference. Pass `{}` if not relevant.
+ */
+export function stripStaleKeysToolAware(state, toolInputs, inputConnections = {}) {
+    return walkNativeState(inputConnections, toolInputs, state, (_input, value) => value === undefined ? SKIP_VALUE : value);
+}
+/**
+ * Strip all keys from a format2 step's `state` that are not declared in
+ * the tool's parameter tree. Format2 analogue of `stripStaleKeysToolAware`.
+ */
+function stripStaleKeysToolAwareFormat2(state, toolInputs) {
+    return walkFormat2State(toolInputs, state, (_input, value) => value === undefined ? SKIP_VALUE : value);
+}
+/** Clean a single format2 step dict in place, returning step result info. */
+async function cleanFormat2Step(stepDef, stepLabel, opts) {
+    const toolId = stepDef.tool_id ?? null;
+    const toolVersion = stepDef.tool_version ?? null;
+    const removedKeys = stripStructuralStep(stepDef, opts.skipUuid ?? false);
+    // Tool-aware strip on `state` field
+    if (opts.toolInputsResolver && toolId) {
+        const inputs = opts.toolInputsResolver(toolId, toolVersion);
+        if (inputs) {
+            if (stepDef.state && typeof stepDef.state === "object" && !Array.isArray(stepDef.state)) {
+                stepDef.state = stripStaleKeysToolAwareFormat2(stepDef.state, inputs);
+            }
+            if (stepDef.tool_state &&
+                typeof stepDef.tool_state === "object" &&
+                !Array.isArray(stepDef.tool_state)) {
+                stepDef.tool_state = stripStaleKeysToolAwareFormat2(stepDef.tool_state, inputs);
+            }
+        }
+    }
+    return {
+        step: stepLabel,
+        tool_id: toolId,
+        version: toolVersion,
+        removed_keys: removedKeys,
+        skipped: false,
+        skip_reason: "",
+        display_label: cleanDisplayLabel(toolId, toolVersion),
+    };
+}
+/** Clean all steps in a format2 workflow dict. Steps may be a list or a dict. */
+async function cleanFormat2Steps(workflowDict, opts) {
+    const rawSteps = workflowDict.steps;
+    if (!rawSteps)
+        return [];
+    const results = [];
+    if (Array.isArray(rawSteps)) {
+        for (let i = 0; i < rawSteps.length; i++) {
+            const stepDef = rawSteps[i];
+            const label = stepDef.label ?? stepDef.id ?? String(i);
+            results.push(await cleanFormat2Step(stepDef, label, opts));
+        }
+    }
+    else if (rawSteps !== null && typeof rawSteps === "object") {
+        for (const [key, stepDef] of Object.entries(rawSteps)) {
+            const step = stepDef;
+            const label = step.label ?? step.id ?? key;
+            results.push(await cleanFormat2Step(step, label, opts));
+        }
+    }
+    return results;
 }
-import { detectFormat } from "./detect-format.js";
 /**
- * Clean a workflow — strip stale keys and decode legacy tool_state encoding.
- * Mutates and returns the workflow dict. Format2 workflows pass through unchanged.
+ * Clean a workflow — strip structural properties (`uuid`, `errors`), stale
+ * tool_state bookkeeping keys, and decode legacy tool_state encoding.
+ *
+ * Mutates the workflow dict in place. Handles both native and format2 formats.
+ * Returns both the mutated workflow and per-step clean results.
+ *
+ * When `opts.toolInputsResolver` is provided, also performs tool-aware stale
+ * key removal: drops any `tool_state` / `state` keys not declared in the
+ * tool's parameter tree (native via `stripStaleKeysToolAware`, format2 via
+ * `walkFormat2State`). Steps whose tool is not found in the resolver are
+ * left unchanged.
  */
-export function cleanWorkflow(workflowDict) {
+export async function cleanWorkflow(workflowDict, opts = {}) {
+    // Strip workflow-level uuid from both formats
+    if (!opts.skipUuid)
+        delete workflowDict.uuid;
     if (detectFormat(workflowDict) === "format2") {
-        return workflowDict;
+        const results = await cleanFormat2Steps(workflowDict, opts);
+        return { workflow: workflowDict, results };
     }
-    cleanNativeSteps(workflowDict);
-    return workflowDict;
+    const results = await cleanNativeSteps(workflowDict, opts);
+    return { workflow: workflowDict, results };
 }
 //# sourceMappingURL=clean.js.map

package/dist/workflow/clean.js.map

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

package/dist/workflow/coercions.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Pure scalar coercion parsers shared by state-merge and stateful-convert.
+ *
+ * Each function returns the parsed value or `null` when the input can't be
+ * interpreted. Callers choose whether to fall back to the original value
+ * (passthrough: `parseX(v) ?? v`) or treat `null` as an error.
+ */
+/** Parse boolean or "true"/"false" string → boolean. Case-insensitive. */
+export declare function parseBool(value: unknown): boolean | null;
+/** Parse number or non-empty numeric string → number. */
+export declare function parseNumber(value: unknown): number | null;
+/**
+ * Parse an array (passthrough) or comma-delimited string → string[].
+ * Empty string yields `[]`. Returns null for other inputs.
+ */
+export declare function parseStringArray(value: unknown): string[] | null;
+/**
+ * Parse an array or comma-delimited string → numeric array. Elements that
+ * can't be parsed as numbers are preserved as strings. Empty string → `[]`.
+ */
+export declare function parseNumberArray(value: unknown): (number | string)[] | null;
+//# sourceMappingURL=coercions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coercions.d.ts","sourceRoot":"","sources":["../../src/workflow/coercions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,0EAA0E;AAC1E,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAQxD;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAOzD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,IAAI,CAOhE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,IAAI,CAe3E"}

package/dist/workflow/coercions.js

@@ -0,0 +1,67 @@
+/**
+ * Pure scalar coercion parsers shared by state-merge and stateful-convert.
+ *
+ * Each function returns the parsed value or `null` when the input can't be
+ * interpreted. Callers choose whether to fall back to the original value
+ * (passthrough: `parseX(v) ?? v`) or treat `null` as an error.
+ */
+/** Parse boolean or "true"/"false" string → boolean. Case-insensitive. */
+export function parseBool(value) {
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "string") {
+        const lower = value.toLowerCase();
+        if (lower === "true")
+            return true;
+        if (lower === "false")
+            return false;
+    }
+    return null;
+}
+/** Parse number or non-empty numeric string → number. */
+export function parseNumber(value) {
+    if (typeof value === "number")
+        return value;
+    if (typeof value === "string" && value !== "") {
+        const n = Number(value);
+        if (!isNaN(n))
+            return n;
+    }
+    return null;
+}
+/**
+ * Parse an array (passthrough) or comma-delimited string → string[].
+ * Empty string yields `[]`. Returns null for other inputs.
+ */
+export function parseStringArray(value) {
+    if (Array.isArray(value))
+        return value;
+    if (typeof value === "string") {
+        if (value === "")
+            return [];
+        return value.split(",");
+    }
+    return null;
+}
+/**
+ * Parse an array or comma-delimited string → numeric array. Elements that
+ * can't be parsed as numbers are preserved as strings. Empty string → `[]`.
+ */
+export function parseNumberArray(value) {
+    if (Array.isArray(value)) {
+        return value.map((v) => {
+            const n = Number(v);
+            return isNaN(n) ? v : n;
+        });
+    }
+    if (typeof value === "string") {
+        if (value === "")
+            return [];
+        return value.split(",").map((s) => {
+            const n = Number(s);
+            return isNaN(n) ? s : n;
+        });
+    }
+    return null;
+}
+//# sourceMappingURL=coercions.js.map

package/dist/workflow/coercions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coercions.js","sourceRoot":"","sources":["../../src/workflow/coercions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,0EAA0E;AAC1E,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAClC,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;QAClC,IAAI,KAAK,KAAK,OAAO;YAAE,OAAO,KAAK,CAAC;IACtC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QAC9C,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAiB,CAAC;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,KAAK,KAAK,EAAE;YAAE,OAAO,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACrB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACpB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,KAAK,KAAK,EAAE;YAAE,OAAO,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAChC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACpB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/workflow/index.d.ts

@@ -1,9 +1,22 @@
+export { serializeWorkflow, resolveFormat, type SerializeWorkflowOptions } from "./serialize.js";
 export { type GalaxyWorkflow, GalaxyWorkflowSchema, type NativeGalaxyWorkflow, NativeGalaxyWorkflowSchema, } from "./raw/index.js";
-export { normalizedFormat2, NormalizedFormat2WorkflowSchema, NormalizedFormat2StepSchema, NormalizedFormat2InputSchema, NormalizedFormat2OutputSchema, NormalizedFormat2StepInputSchema, NormalizedFormat2StepOutputSchema, type NormalizedFormat2Workflow, type NormalizedFormat2Step, type NormalizedFormat2Input, type NormalizedFormat2Output, type NormalizedFormat2StepInput, type NormalizedFormat2StepOutput, normalizedNative, NormalizedNativeWorkflowSchema, NormalizedNativeStepSchema, ToolReferenceSchema, type NormalizedNativeWorkflow, type NormalizedNativeStep, type ToolReference, toFormat2, toNative, ensureFormat2, ensureNative, expandedFormat2, expandedNative, isTrsUrl, MAX_EXPANSION_DEPTH, type ExpandedFormat2Workflow, type ExpandedFormat2Step, type ExpandedNativeWorkflow, type ExpandedNativeStep, type RefResolver, type ExpansionOptions, flattenCommentData, unflattenCommentData, resolveSourceReference, UNLABELED_INPUT_PREFIX, UNLABELED_STEP_PREFIX, } from "./normalized/index.js";
-export { injectConnectionsIntoState, stripConnectedValues, flatStatePath, keysStartingWith, repeatInputsToArray, selectWhichWhen, } from "./state-merge.js";
+export { normalizedFormat2, NormalizedFormat2WorkflowSchema, NormalizedFormat2StepSchema, NormalizedFormat2InputSchema, NormalizedFormat2OutputSchema, NormalizedFormat2StepInputSchema, NormalizedFormat2StepOutputSchema, type NormalizedFormat2Workflow, type NormalizedFormat2Step, type NormalizedFormat2Input, type NormalizedFormat2Output, type NormalizedFormat2StepInput, type NormalizedFormat2StepOutput, normalizedNative, NormalizedNativeWorkflowSchema, NormalizedNativeStepSchema, ToolReferenceSchema, type NormalizedNativeWorkflow, type NormalizedNativeStep, type ToolReference, toFormat2, type ToFormat2Options, type Format2StateOverride, toNative, type ToNativeOptions, toFormat2Stateful, toNativeStateful, type StepConversionStatus, type StepConversionFailureClass, type StatefulExportResult, type StatefulNativeResult, type ToolInputsResolver, ensureFormat2, ensureNative, expandedFormat2, expandedNative, isTrsUrl, MAX_EXPANSION_DEPTH, type ExpandedFormat2Workflow, type ExpandedFormat2Step, type ExpandedNativeWorkflow, type ExpandedNativeStep, type RefResolver, type ExpansionOptions, flattenCommentData, unflattenCommentData, resolveSourceReference, UNLABELED_INPUT_PREFIX, UNLABELED_STEP_PREFIX, } from "./normalized/index.js";
+export { flatStatePath, keysStartingWith, repeatInputsToArray, selectWhichWhen, } from "./walk-helpers.js";
+export { injectConnectionsIntoState, stripConnectedValues } from "./state-merge.js";
 export { scanForReplacements, type ReplacementClassification } from "./replacement-scan.js";
 export { scanToolState, type LegacyEncodingClassification, type LegacyEncodingHit, type LegacyEncodingScanResult, } from "./legacy-encoding.js";
-export { cleanWorkflow } from "./clean.js";
+export { walkNativeState, walkFormat2State, SKIP_VALUE, UnknownKeyError, type LeafCallback, type WalkNativeOptions, } from "./walker.js";
+export { convertScalarValue, reverseScalarValue, convertStateToFormat2, encodeStateToNative, type Format2ConvertedState, } from "./stateful-convert.js";
+export { precheckNativeWorkflow, precheckNativeStep, type PrecheckResult, type StepPrecheckResult, } from "./precheck.js";
+export { ConversionValidationFailure, validateNativeStepState, validateFormat2StepState, validateFormat2StepStateStrict, type ToolStateDiagnostic, type ValidationPhase, } from "./stateful-validate.js";
+export { findParamAtPath, type ParamNavigationResult } from "./param-navigation.js";
+export { roundtripValidate, type RoundtripResult, type RoundtripStrictOptions, type StepRoundtripResult, type BenignArtifactKind, type RoundtripFailureClass, } from "./roundtrip.js";
+export { cleanWorkflow, type CleanWorkflowOptions, type CleanWorkflowResult } from "./clean.js";
 export { detectFormat, type WorkflowFormat } from "./detect-format.js";
-export { LintContext, lintNative, lintFormat2, lintWorkflow, lintBestPracticesFormat2, lintBestPracticesNative, type LintResult, } from "./lint.js";
+export { withClass, validateFormat2, validateFormat2Strict, validateNative, validateNativeStrict, validatorForFixture, } from "./validators.js";
+export { validateEncodingNative, validateEncodingFormat2, checkStrictEncoding, checkStrictStructure, } from "./strict-checks.js";
+export { LintContext, LintMessage, Linter, LEVEL_ERROR, LEVEL_WARN, lintNative, lintFormat2, lintWorkflow, lintBestPracticesFormat2, lintBestPracticesNative, type LintLevel, type LintResult, type LinterRef, type EmitOptions, } from "./lint.js";
+export { NativeStepKeyNotInteger } from "./lint-rules.js";
+export { parseLintProfiles, lintProfilesById, rulesForProfile, iwcRuleIds, LINT_PROFILES_FILENAME, IWC_PROFILE_NAMES, type LintProfile, } from "./lint-profiles.js";
+export { type StepStatus, SKIP_STATUSES, type ValidationStepResult, type CleanStepResult, type ResolvedOutputType, type ConnectionResult, type ConnectionStepResult, type ConnectionValidationReport, type WorkflowEntry, type WorkflowIndex, type SingleValidationReport, type SingleLintReport, type SingleCleanReport, type DiffType, type DiffSeverity, type BenignArtifact, type StepDiff, type SkipWorkflowReason, type FailureClass, type StepResult, type RoundTripResult, type StepIdMappingResult, type RoundTripValidationResult, type SingleRoundTripReport, type SingleExportReport, type StepEncodeStatus, type ToNativeResult, type WorkflowSourceFormat, type ExportResult, type ConvertResult, type WorkflowValidationResult, type LintWorkflowResult, type WorkflowCleanResult, type CategoryGroup, type TreeValidationReport, type LintTreeReport, type TreeCleanReport, type WorkflowExportResult, type ExportTreeReport, type WorkflowToNativeResult, type ToNativeTreeReport, type ToolFailureMode, type RoundTripTreeReport, validationSummary, validationFailures, cleanDisplayLabel, categoryOf, groupByCategory, buildSingleValidationReport, buildSingleLintReport, buildSingleCleanReport, buildWorkflowValidationResult, buildLintWorkflowResult, buildWorkflowCleanResult, buildTreeValidationReport, buildLintTreeReport, buildTreeCleanReport, buildWorkflowExportResult, buildExportTreeReport, buildWorkflowToNativeResult, buildToNativeTreeReport, buildRoundTripTreeReport, } from "./report-models.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,cAAc,EACnB,oBAAoB,EACpB,KAAK,oBAAoB,EACzB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,iBAAiB,EACjB,+BAA+B,EAC/B,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,gCAAgC,EAChC,iCAAiC,EACjC,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,gBAAgB,EAChB,8BAA8B,EAC9B,0BAA0B,EAC1B,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,SAAS,EACT,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,eAAe,EACf,cAAc,EACd,QAAQ,EACR,mBAAmB,EACnB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,mBAAmB,EAAE,KAAK,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAE5F,OAAO,EACL,aAAa,EACb,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEvE,OAAO,EACL,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,wBAAwB,EACxB,uBAAuB,EACvB,KAAK,UAAU,GAChB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"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"}

package/dist/workflow/index.js

@@ -1,11 +1,26 @@
+// Format-aware serialization helpers
+export { serializeWorkflow, resolveFormat } from "./serialize.js";
 // Raw (generated) workflow schema types
 export { GalaxyWorkflowSchema, NativeGalaxyWorkflowSchema, } from "./raw/index.js";
 // Normalized workflow types + normalizers
-export { normalizedFormat2, NormalizedFormat2WorkflowSchema, NormalizedFormat2StepSchema, NormalizedFormat2InputSchema, NormalizedFormat2OutputSchema, NormalizedFormat2StepInputSchema, NormalizedFormat2StepOutputSchema, normalizedNative, NormalizedNativeWorkflowSchema, NormalizedNativeStepSchema, ToolReferenceSchema, toFormat2, toNative, ensureFormat2, ensureNative, expandedFormat2, expandedNative, isTrsUrl, MAX_EXPANSION_DEPTH, flattenCommentData, unflattenCommentData, resolveSourceReference, UNLABELED_INPUT_PREFIX, UNLABELED_STEP_PREFIX, } from "./normalized/index.js";
-export { injectConnectionsIntoState, stripConnectedValues, flatStatePath, keysStartingWith, repeatInputsToArray, selectWhichWhen, } from "./state-merge.js";
+export { normalizedFormat2, NormalizedFormat2WorkflowSchema, NormalizedFormat2StepSchema, NormalizedFormat2InputSchema, NormalizedFormat2OutputSchema, NormalizedFormat2StepInputSchema, NormalizedFormat2StepOutputSchema, normalizedNative, NormalizedNativeWorkflowSchema, NormalizedNativeStepSchema, ToolReferenceSchema, toFormat2, toNative, toFormat2Stateful, toNativeStateful, ensureFormat2, ensureNative, expandedFormat2, expandedNative, isTrsUrl, MAX_EXPANSION_DEPTH, flattenCommentData, unflattenCommentData, resolveSourceReference, UNLABELED_INPUT_PREFIX, UNLABELED_STEP_PREFIX, } from "./normalized/index.js";
+export { flatStatePath, keysStartingWith, repeatInputsToArray, selectWhichWhen, } from "./walk-helpers.js";
+export { injectConnectionsIntoState, stripConnectedValues } from "./state-merge.js";
 export { scanForReplacements } from "./replacement-scan.js";
 export { scanToolState, } from "./legacy-encoding.js";
+export { walkNativeState, walkFormat2State, SKIP_VALUE, UnknownKeyError, } from "./walker.js";
+export { convertScalarValue, reverseScalarValue, convertStateToFormat2, encodeStateToNative, } from "./stateful-convert.js";
+export { precheckNativeWorkflow, precheckNativeStep, } from "./precheck.js";
+export { ConversionValidationFailure, validateNativeStepState, validateFormat2StepState, validateFormat2StepStateStrict, } from "./stateful-validate.js";
+export { findParamAtPath } from "./param-navigation.js";
+export { roundtripValidate, } from "./roundtrip.js";
 export { cleanWorkflow } from "./clean.js";
 export { detectFormat } from "./detect-format.js";
-export { LintContext, lintNative, lintFormat2, lintWorkflow, lintBestPracticesFormat2, lintBestPracticesNative, } from "./lint.js";
+export { withClass, validateFormat2, validateFormat2Strict, validateNative, validateNativeStrict, validatorForFixture, } from "./validators.js";
+export { validateEncodingNative, validateEncodingFormat2, checkStrictEncoding, checkStrictStructure, } from "./strict-checks.js";
+export { LintContext, LintMessage, Linter, LEVEL_ERROR, LEVEL_WARN, lintNative, lintFormat2, lintWorkflow, lintBestPracticesFormat2, lintBestPracticesNative, } from "./lint.js";
+export { NativeStepKeyNotInteger } from "./lint-rules.js";
+export { parseLintProfiles, lintProfilesById, rulesForProfile, iwcRuleIds, LINT_PROFILES_FILENAME, IWC_PROFILE_NAMES, } from "./lint-profiles.js";
+// Structured report models (mirrors Python _report_models.py)
+export { SKIP_STATUSES, validationSummary, validationFailures, cleanDisplayLabel, categoryOf, groupByCategory, buildSingleValidationReport, buildSingleLintReport, buildSingleCleanReport, buildWorkflowValidationResult, buildLintWorkflowResult, buildWorkflowCleanResult, buildTreeValidationReport, buildLintTreeReport, buildTreeCleanReport, buildWorkflowExportResult, buildExportTreeReport, buildWorkflowToNativeResult, buildToNativeTreeReport, buildRoundTripTreeReport, } from "./report-models.js";
 //# sourceMappingURL=index.js.map

package/dist/workflow/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,EAEL,oBAAoB,EAEpB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAExB,0CAA0C;AAC1C,OAAO,EACL,iBAAiB,EACjB,+BAA+B,EAC/B,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,gCAAgC,EAChC,iCAAiC,EAOjC,gBAAgB,EAChB,8BAA8B,EAC9B,0BAA0B,EAC1B,mBAAmB,EAInB,SAAS,EACT,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,eAAe,EACf,cAAc,EACd,QAAQ,EACR,mBAAmB,EAOnB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,mBAAmB,EAAkC,MAAM,uBAAuB,CAAC;AAE5F,OAAO,EACL,aAAa,GAId,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAuB,MAAM,oBAAoB,CAAC;AAEvE,OAAO,EACL,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,wBAAwB,EACxB,uBAAuB,GAExB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAiC,MAAM,gBAAgB,CAAC;AAEjG,wCAAwC;AACxC,OAAO,EAEL,oBAAoB,EAEpB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAExB,0CAA0C;AAC1C,OAAO,EACL,iBAAiB,EACjB,+BAA+B,EAC/B,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,gCAAgC,EAChC,iCAAiC,EAOjC,gBAAgB,EAChB,8BAA8B,EAC9B,0BAA0B,EAC1B,mBAAmB,EAInB,SAAS,EAGT,QAAQ,EAER,iBAAiB,EACjB,gBAAgB,EAMhB,aAAa,EACb,YAAY,EACZ,eAAe,EACf,cAAc,EACd,QAAQ,EACR,mBAAmB,EAOnB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAEpF,OAAO,EAAE,mBAAmB,EAAkC,MAAM,uBAAuB,CAAC;AAE5F,OAAO,EACL,aAAa,GAId,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,eAAe,GAGhB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GAEpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,sBAAsB,EACtB,kBAAkB,GAGnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,GAG/B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,eAAe,EAA8B,MAAM,uBAAuB,CAAC;AAEpF,OAAO,EACL,iBAAiB,GAMlB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,aAAa,EAAuD,MAAM,YAAY,CAAC;AAEhG,OAAO,EAAE,YAAY,EAAuB,MAAM,oBAAoB,CAAC;AAEvE,OAAO,EACL,SAAS,EACT,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,WAAW,EACX,WAAW,EACX,MAAM,EACN,WAAW,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,wBAAwB,EACxB,uBAAuB,GAKxB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,sBAAsB,EACtB,iBAAiB,GAElB,MAAM,oBAAoB,CAAC;AAE5B,8DAA8D;AAC9D,OAAO,EAEL,aAAa,EAiDb,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,6BAA6B,EAC7B,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC"}

package/dist/workflow/lint-profiles.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Lint profile catalog types and parser.
+ *
+ * Mirrors gxformat2/lint_profiles.py. Profiles group lint-rule IDs into
+ * named sets (`structural`, `best-practices`, `release`). Unknown IDs are
+ * tolerated — audit tooling compares against registered `Linter` subclasses
+ * to flag unimplemented entries as INFO.
+ *
+ * The YAML file lives alongside this module at `./lint_profiles.yml`. This
+ * module stays fs-free so src/ remains browser-compatible — callers read
+ * the file themselves and hand the string to `parseLintProfiles`.
+ */
+/** Relative path (from this module) to the profile catalog YAML. */
+export declare const LINT_PROFILES_FILENAME = "lint_profiles.yml";
+/** Canonical profile names whose union defines the IWC rule set. */
+export declare const IWC_PROFILE_NAMES: readonly ["structural", "best-practices", "release"];
+export interface LintProfile {
+    id: string;
+    description: string;
+    rules: string[];
+}
+export declare function parseLintProfiles(yamlContent: string): LintProfile[];
+export declare function lintProfilesById(profiles: LintProfile[]): Map<string, LintProfile>;
+export declare function rulesForProfile(profiles: LintProfile[], id: string): string[];
+/** Union of rule ids across structural / best-practices / release profiles. */
+export declare function iwcRuleIds(profiles: LintProfile[]): Set<string>;
+//# sourceMappingURL=lint-profiles.d.ts.map

package/dist/workflow/lint-profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-profiles.d.ts","sourceRoot":"","sources":["../../src/workflow/lint-profiles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,oEAAoE;AACpE,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAE1D,oEAAoE;AACpE,eAAO,MAAM,iBAAiB,sDAAuD,CAAC;AAEtF,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAOD,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CAOpE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAElF;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAM7E;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAU/D"}

package/dist/workflow/lint-profiles.js

@@ -0,0 +1,49 @@
+/**
+ * Lint profile catalog types and parser.
+ *
+ * Mirrors gxformat2/lint_profiles.py. Profiles group lint-rule IDs into
+ * named sets (`structural`, `best-practices`, `release`). Unknown IDs are
+ * tolerated — audit tooling compares against registered `Linter` subclasses
+ * to flag unimplemented entries as INFO.
+ *
+ * The YAML file lives alongside this module at `./lint_profiles.yml`. This
+ * module stays fs-free so src/ remains browser-compatible — callers read
+ * the file themselves and hand the string to `parseLintProfiles`.
+ */
+import * as yaml from "yaml";
+/** Relative path (from this module) to the profile catalog YAML. */
+export const LINT_PROFILES_FILENAME = "lint_profiles.yml";
+/** Canonical profile names whose union defines the IWC rule set. */
+export const IWC_PROFILE_NAMES = ["structural", "best-practices", "release"];
+export function parseLintProfiles(yamlContent) {
+    const raw = (yaml.parse(yamlContent) ?? {});
+    return Object.entries(raw).map(([id, body]) => ({
+        id,
+        description: body.description ?? "",
+        rules: body.rules ?? [],
+    }));
+}
+export function lintProfilesById(profiles) {
+    return new Map(profiles.map((p) => [p.id, p]));
+}
+export function rulesForProfile(profiles, id) {
+    const profile = lintProfilesById(profiles).get(id);
+    if (!profile) {
+        throw new Error(`Unknown lint profile: ${id}`);
+    }
+    return profile.rules;
+}
+/** Union of rule ids across structural / best-practices / release profiles. */
+export function iwcRuleIds(profiles) {
+    const byId = lintProfilesById(profiles);
+    const ids = new Set();
+    for (const name of IWC_PROFILE_NAMES) {
+        const profile = byId.get(name);
+        if (profile) {
+            for (const ruleId of profile.rules)
+                ids.add(ruleId);
+        }
+    }
+    return ids;
+}
+//# sourceMappingURL=lint-profiles.js.map

package/dist/workflow/lint-profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-profiles.js","sourceRoot":"","sources":["../../src/workflow/lint-profiles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,oEAAoE;AACpE,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AAE1D,oEAAoE;AACpE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,YAAY,EAAE,gBAAgB,EAAE,SAAS,CAAU,CAAC;AAatF,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAmC,CAAC;IAC9E,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9C,EAAE;QACF,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;QACnC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;KACxB,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAuB;IACtD,OAAO,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAuB,EAAE,EAAU;IACjE,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAC;AACvB,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,UAAU,CAAC,QAAuB;IAChD,MAAM,IAAI,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,KAAK;gBAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/workflow/lint-rules.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Lint rule classes.
+ *
+ * Each `Linter` subclass carries metadata only (severity, applies_to,
+ * profile). Emission happens in `lint.ts` via `LintContext.warn`/`error`
+ * with `linter=<Subclass>`.
+ */
+import { Linter } from "./linting.js";
+/** Native workflow step keys must be string representations of integers. */
+export declare class NativeStepKeyNotInteger extends Linter {
+    static severity: "error";
+    static applies_to: readonly ["native"];
+    static profile: string;
+}
+//# sourceMappingURL=lint-rules.d.ts.map

package/dist/workflow/lint-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-rules.d.ts","sourceRoot":"","sources":["../../src/workflow/lint-rules.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,4EAA4E;AAC5E,qBAAa,uBAAwB,SAAQ,MAAM;IACjD,MAAM,CAAC,QAAQ,EAAG,OAAO,CAAU;IACnC,MAAM,CAAC,UAAU,sBAAuB;IACxC,MAAM,CAAC,OAAO,SAAgB;CAC/B"}