tubeless 0.2.13 → 0.2.15

package/dist/core/pipeline-definition-validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-definition-validation.js","sourceRoot":"","sources":["../../src/core/pipeline-definition-validation.ts"],"names":[],"mappings":"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","sourcesContent":["import { duplicateValues } from \"../utilities/collections.js\";\nimport type { PipelineDefinition, StepsOptions } from \"./pipeline-definition.js\";\nimport { requiredFinalizerMetadata } from \"./pipeline-finalizer.js\";\nimport { stepEdges, targetClosure, topologicalSort } from \"./pipeline-graph.js\";\nimport { pipelineDiagnostic } from \"./pipeline-errors.js\";\nimport type { AnyStep } from \"./pipeline-steps.js\";\nimport { PIPELINE_FINALIZE_STEP_ID, STEP_OPTIONS_SCHEMA } from \"./pipeline-step-metadata.js\";\nimport type { PipelineError, StandardSchemaV1 } from \"./pipeline-types.js\";\n\nexport function validatePipelineDefinition<\n  TSteps extends readonly AnyStep[],\n  TResult,\n  TTargets extends readonly TSteps[number][],\n  TResultSchema extends StandardSchemaV1 | undefined,\n>(definition: PipelineDefinition<TSteps, TResult, TTargets, TResultSchema>): PipelineError[] {\n  type TOptions = StepsOptions<TSteps>;\n  const steps = definition.steps;\n  const errors: PipelineError[] = [];\n  if (definition.id.trim().length === 0) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_PIPELINE_ID_BLANK\",\n        \"definition\",\n        \"definition\",\n        \"Pipeline id must not be blank\"\n      )\n    );\n  }\n\n  if (\n    definition.name !== undefined &&\n    (typeof definition.name !== \"string\" || definition.name.trim().length === 0)\n  ) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_PIPELINE_NAME_BLANK\",\n        \"definition\",\n        \"definition\",\n        \"Pipeline display name must not be blank\"\n      )\n    );\n  }\n\n  if (\n    definition.description !== undefined &&\n    (typeof definition.description !== \"string\" || definition.description.trim().length === 0)\n  ) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_PIPELINE_DESCRIPTION_BLANK\",\n        \"definition\",\n        \"definition\",\n        \"Pipeline description must not be blank\"\n      )\n    );\n  }\n\n  if (\n    definition.implementationVersion !== undefined &&\n    (typeof definition.implementationVersion !== \"string\" ||\n      definition.implementationVersion.trim().length === 0 ||\n      definition.implementationVersion.length > 256)\n  ) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_IMPLEMENTATION_VERSION_INVALID\",\n        \"definition\",\n        \"definition\",\n        \"Implementation version must be a nonblank string of at most 256 characters\"\n      )\n    );\n  }\n  const stepIds = steps.map((step) => step.id);\n  const duplicateStepIds = duplicateValues(stepIds);\n  if (duplicateStepIds.length > 0) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_STEP_IDS_DUPLICATE\",\n        \"definition\",\n        \"definition\",\n        `Pipeline ${definition.id} has duplicate step ids: ${duplicateStepIds.join(\", \")}`\n      )\n    );\n  }\n  const optionsSchemas = new Set(steps.map((step) => step[STEP_OPTIONS_SCHEMA]));\n  if (optionsSchemas.size > 1 && [...optionsSchemas].some(Boolean)) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_OPTIONS_SCHEMA_CONFLICT\",\n        \"definition\",\n        \"definition\",\n        `Pipeline ${definition.id} mixes steps from different options-schema scopes`\n      )\n    );\n  }\n  for (const step of steps) {\n    if (step.id.trim().length === 0) {\n      errors.push(\n        pipelineDiagnostic(\n          \"TUBELESS_DEFINITION_STEP_ID_BLANK\",\n          \"definition\",\n          \"definition\",\n          `Pipeline ${definition.id} has a step with a blank id`,\n          { stepId: step.id }\n        )\n      );\n    }\n    if (step.id === PIPELINE_FINALIZE_STEP_ID) {\n      errors.push(\n        pipelineDiagnostic(\n          \"TUBELESS_DEFINITION_STEP_ID_RESERVED\",\n          \"definition\",\n          \"definition\",\n          `Pipeline ${definition.id} uses reserved step id ${PIPELINE_FINALIZE_STEP_ID}`,\n          { stepId: step.id }\n        )\n      );\n    }\n    if (step.name !== undefined && step.name.trim().length === 0) {\n      errors.push(\n        pipelineDiagnostic(\n          \"TUBELESS_DEFINITION_STEP_NAME_BLANK\",\n          \"definition\",\n          \"definition\",\n          `Pipeline ${definition.id} step ${step.id} has a blank display name`,\n          { stepId: step.id }\n        )\n      );\n    }\n    const dependencyGroups = [\n      [\"dependsOn\", step.dependsOn ?? []],\n      [\"optionalDependsOn\", step.optionalDependsOn ?? []],\n      [\"skipAfterFailureOf\", step.skipAfterFailureOf ?? []],\n    ] as const;\n    for (const [field, dependencies] of dependencyGroups) {\n      const duplicates = duplicateValues(dependencies.map((dependency) => dependency.id));\n      if (duplicates.length > 0) {\n        errors.push(\n          pipelineDiagnostic(\n            \"TUBELESS_DEFINITION_DEPENDENCY_DUPLICATE\",\n            \"definition\",\n            \"definition\",\n            `Pipeline ${definition.id} step ${step.id} repeats ${field}: ${duplicates.join(\", \")}`,\n            { stepId: step.id }\n          )\n        );\n      }\n      if (dependencies.includes(step)) {\n        errors.push(\n          pipelineDiagnostic(\n            \"TUBELESS_DEFINITION_DEPENDENCY_SELF_REFERENCE\",\n            \"definition\",\n            \"definition\",\n            `Pipeline ${definition.id} step ${step.id} cannot reference itself in ${field}`,\n            { stepId: step.id }\n          )\n        );\n      }\n    }\n\n    const required = new Set(step.dependsOn ?? []);\n    const contradictory = (step.optionalDependsOn ?? []).filter((dependency) =>\n      required.has(dependency)\n    );\n    if (contradictory.length > 0) {\n      errors.push(\n        pipelineDiagnostic(\n          \"TUBELESS_DEFINITION_DEPENDENCY_CONTRADICTORY\",\n          \"definition\",\n          \"definition\",\n          `Pipeline ${definition.id} step ${step.id} declares dependencies as both required and optional: ${contradictory.map(({ id }) => id).join(\", \")}`,\n          { stepId: step.id }\n        )\n      );\n    }\n  }\n\n  // SAFETY: `steps` is `TSteps extends readonly AnyStep[]`; the cast restores\n  // the `TOptions` generic that the tuple erased, without changing the values.\n  const knownSteps = new Set<AnyStep<TOptions>>(steps as readonly AnyStep<TOptions>[]);\n  // SAFETY: the tuple contains only steps with the inferred options type.\n  const orderedSteps = topologicalSort(steps as readonly AnyStep<TOptions>[]);\n  // SAFETY: explicit targets are a subset of TSteps; implicit targets come from its graph.\n  const declaredTargets = (definition.targets ??\n    orderedSteps?.slice(-1) ??\n    []) as readonly AnyStep<TOptions>[];\n  const duplicateTargetIds = duplicateValues(declaredTargets.map((target) => target.id));\n  if (duplicateTargetIds.length > 0) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_TARGETS_DUPLICATE\",\n        \"definition\",\n        \"definition\",\n        `Pipeline ${definition.id} declares duplicate targets: ${duplicateTargetIds.join(\", \")}`\n      )\n    );\n  }\n  const missingTargets = declaredTargets.filter((target) => !knownSteps.has(target));\n  if (missingTargets.length > 0) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_TARGET_NOT_IN_STEPS\",\n        \"definition\",\n        \"definition\",\n        `Pipeline ${definition.id} declares target step(s) not included in its steps list: ${missingTargets.map(({ id }) => id).join(\", \")}`\n      )\n    );\n  }\n  const missingReferences: string[] = [];\n  // SAFETY: `steps` is `TSteps extends readonly AnyStep[]`; the cast restores the\n  // `TOptions` generic that the tuple erased, without changing the values.\n  for (const step of steps as readonly AnyStep<TOptions>[]) {\n    for (const dependency of stepEdges(step)) {\n      if (!knownSteps.has(dependency)) {\n        missingReferences.push(`${step.id} -> ${dependency.id}`);\n      }\n    }\n  }\n  if (missingReferences.length > 0) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_DEPENDENCY_NOT_IN_STEPS\",\n        \"definition\",\n        \"definition\",\n        `Pipeline ${definition.id} references step(s) not included in its steps list: ${missingReferences.join(\", \")}`\n      )\n    );\n  }\n\n  const requiredFinalizerSteps = requiredFinalizerMetadata<TOptions>(definition.finalize)?.steps;\n  const missingFinalizerSteps = (requiredFinalizerSteps ?? []).filter(\n    (step) => !knownSteps.has(step)\n  );\n  if (missingFinalizerSteps.length > 0) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_FINALIZER_STEP_NOT_IN_STEPS\",\n        \"definition\",\n        \"definition\",\n        `Pipeline ${definition.id} requires finalizer output from step(s) not included in its steps list: ${missingFinalizerSteps.map(({ id }) => id).join(\", \")}`\n      )\n    );\n  }\n\n  if (\n    requiredFinalizerSteps &&\n    missingTargets.length === 0 &&\n    missingReferences.length === 0 &&\n    missingFinalizerSteps.length === 0\n  ) {\n    for (const target of declaredTargets) {\n      const selected = targetClosure([target]);\n      const missingRequiredSteps = requiredFinalizerSteps.filter((step) => !selected.has(step));\n      if (missingRequiredSteps.length > 0) {\n        errors.push(\n          pipelineDiagnostic(\n            \"TUBELESS_DEFINITION_TARGET_FINALIZER_MISMATCH\",\n            \"definition\",\n            \"definition\",\n            `Pipeline ${definition.id} target ${target.id} cannot satisfy required finalizer output(s): ${missingRequiredSteps.map(({ id }) => id).join(\", \")}`,\n            { stepId: target.id }\n          )\n        );\n      }\n    }\n  }\n\n  if (errors.length === 0 && !orderedSteps) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_DEPENDENCY_CYCLE\",\n        \"definition\",\n        \"definition\",\n        `Pipeline ${definition.id} has a dependency cycle`\n      )\n    );\n  }\n  return errors;\n}\n"]}
+{"version":3,"file":"pipeline-definition-validation.js","sourceRoot":"","sources":["../../src/core/pipeline-definition-validation.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  compileStepCache,\n  validatePipelineCache,\n  type CompiledStepCache,\n} from \"./pipeline-cache.js\";\nimport { duplicateValues } from \"../utilities/collections.js\";\nimport type { PipelineDefinition, StepsOptions } from \"./pipeline-definition.js\";\nimport { requiredFinalizerMetadata } from \"./pipeline-finalizer.js\";\nimport { stepEdges, targetClosure, topologicalSort } from \"./pipeline-graph.js\";\nimport { pipelineDiagnostic } from \"./pipeline-errors.js\";\nimport type { AnyStep } from \"./pipeline-steps.js\";\nimport {\n  PIPELINE_FINALIZE_STEP_ID,\n  STEP_OPTIONS_SCHEMA,\n  STEP_NESTED_PIPELINE,\n  STEP_REMOTE,\n} from \"./pipeline-step-metadata.js\";\nimport type { PipelineError, StandardSchemaV1 } from \"./pipeline-types.js\";\n\n/** Validate author declarations and retain cache plans so graph construction never recompiles them. */\nexport function validatePipelineDefinition<\n  TSteps extends readonly AnyStep[],\n  TResult,\n  TTargets extends readonly TSteps[number][],\n  TResultSchema extends StandardSchemaV1 | undefined,\n>(definition: PipelineDefinition<TSteps, TResult, TTargets, TResultSchema>) {\n  type TOptions = StepsOptions<TSteps>;\n  const steps = definition.steps;\n  const errors: PipelineError[] = [];\n  const compiledCaches = new Map<AnyStep, CompiledStepCache<TOptions>>();\n  if (definition.id.trim().length === 0) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_PIPELINE_ID_BLANK\",\n        \"definition\",\n        \"definition\",\n        \"Pipeline id must not be blank\"\n      )\n    );\n  }\n\n  if (\n    definition.name !== undefined &&\n    (typeof definition.name !== \"string\" || definition.name.trim().length === 0)\n  ) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_PIPELINE_NAME_BLANK\",\n        \"definition\",\n        \"definition\",\n        \"Pipeline display name must not be blank\"\n      )\n    );\n  }\n\n  if (\n    definition.description !== undefined &&\n    (typeof definition.description !== \"string\" || definition.description.trim().length === 0)\n  ) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_PIPELINE_DESCRIPTION_BLANK\",\n        \"definition\",\n        \"definition\",\n        \"Pipeline description must not be blank\"\n      )\n    );\n  }\n\n  if (\n    definition.implementationVersion !== undefined &&\n    (typeof definition.implementationVersion !== \"string\" ||\n      definition.implementationVersion.trim().length === 0 ||\n      definition.implementationVersion.length > 256)\n  ) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_IMPLEMENTATION_VERSION_INVALID\",\n        \"definition\",\n        \"definition\",\n        \"Implementation version must be a nonblank string of at most 256 characters\"\n      )\n    );\n  }\n  try {\n    validatePipelineCache(definition.cache);\n  } catch (error) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_CACHE_INVALID\",\n        \"definition\",\n        \"definition\",\n        error instanceof Error ? error.message : String(error)\n      )\n    );\n  }\n  const stepIds = steps.map((step) => step.id);\n  const duplicateStepIds = duplicateValues(stepIds);\n  if (duplicateStepIds.length > 0) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_STEP_IDS_DUPLICATE\",\n        \"definition\",\n        \"definition\",\n        `Pipeline ${definition.id} has duplicate step ids: ${duplicateStepIds.join(\", \")}`\n      )\n    );\n  }\n  const optionsSchemas = new Set(steps.map((step) => step[STEP_OPTIONS_SCHEMA]));\n  if (optionsSchemas.size > 1 && [...optionsSchemas].some(Boolean)) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_OPTIONS_SCHEMA_CONFLICT\",\n        \"definition\",\n        \"definition\",\n        `Pipeline ${definition.id} mixes steps from different options-schema scopes`\n      )\n    );\n  }\n  for (const step of steps) {\n    try {\n      const configuredCache = step.cache;\n      if (configuredCache && (step[STEP_NESTED_PIPELINE] || step[STEP_REMOTE]))\n        throw new Error(\"Only ordinary steps can opt into caching\");\n      const cache = compileStepCache(\n        configuredCache,\n        definition.cache,\n        definition.implementationVersion\n      );\n      if (cache) compiledCaches.set(step, cache);\n    } catch (error) {\n      errors.push(\n        pipelineDiagnostic(\n          \"TUBELESS_DEFINITION_STEP_CACHE_INVALID\",\n          \"definition\",\n          \"definition\",\n          `Pipeline ${definition.id} step ${step.id}: ${error instanceof Error ? error.message : String(error)}`,\n          { stepId: step.id }\n        )\n      );\n    }\n    if (step.id.trim().length === 0) {\n      errors.push(\n        pipelineDiagnostic(\n          \"TUBELESS_DEFINITION_STEP_ID_BLANK\",\n          \"definition\",\n          \"definition\",\n          `Pipeline ${definition.id} has a step with a blank id`,\n          { stepId: step.id }\n        )\n      );\n    }\n    if (step.id === PIPELINE_FINALIZE_STEP_ID) {\n      errors.push(\n        pipelineDiagnostic(\n          \"TUBELESS_DEFINITION_STEP_ID_RESERVED\",\n          \"definition\",\n          \"definition\",\n          `Pipeline ${definition.id} uses reserved step id ${PIPELINE_FINALIZE_STEP_ID}`,\n          { stepId: step.id }\n        )\n      );\n    }\n    if (step.name !== undefined && step.name.trim().length === 0) {\n      errors.push(\n        pipelineDiagnostic(\n          \"TUBELESS_DEFINITION_STEP_NAME_BLANK\",\n          \"definition\",\n          \"definition\",\n          `Pipeline ${definition.id} step ${step.id} has a blank display name`,\n          { stepId: step.id }\n        )\n      );\n    }\n    const dependencyGroups = [\n      [\"dependsOn\", step.dependsOn ?? []],\n      [\"optionalDependsOn\", step.optionalDependsOn ?? []],\n      [\"skipAfterFailureOf\", step.skipAfterFailureOf ?? []],\n    ] as const;\n    for (const [field, dependencies] of dependencyGroups) {\n      const duplicates = duplicateValues(dependencies.map((dependency) => dependency.id));\n      if (duplicates.length > 0) {\n        errors.push(\n          pipelineDiagnostic(\n            \"TUBELESS_DEFINITION_DEPENDENCY_DUPLICATE\",\n            \"definition\",\n            \"definition\",\n            `Pipeline ${definition.id} step ${step.id} repeats ${field}: ${duplicates.join(\", \")}`,\n            { stepId: step.id }\n          )\n        );\n      }\n      if (dependencies.includes(step)) {\n        errors.push(\n          pipelineDiagnostic(\n            \"TUBELESS_DEFINITION_DEPENDENCY_SELF_REFERENCE\",\n            \"definition\",\n            \"definition\",\n            `Pipeline ${definition.id} step ${step.id} cannot reference itself in ${field}`,\n            { stepId: step.id }\n          )\n        );\n      }\n    }\n\n    const required = new Set(step.dependsOn ?? []);\n    const contradictory = (step.optionalDependsOn ?? []).filter((dependency) =>\n      required.has(dependency)\n    );\n    if (contradictory.length > 0) {\n      errors.push(\n        pipelineDiagnostic(\n          \"TUBELESS_DEFINITION_DEPENDENCY_CONTRADICTORY\",\n          \"definition\",\n          \"definition\",\n          `Pipeline ${definition.id} step ${step.id} declares dependencies as both required and optional: ${contradictory.map(({ id }) => id).join(\", \")}`,\n          { stepId: step.id }\n        )\n      );\n    }\n  }\n\n  // SAFETY: `steps` is `TSteps extends readonly AnyStep[]`; the cast restores\n  // the `TOptions` generic that the tuple erased, without changing the values.\n  const knownSteps = new Set<AnyStep<TOptions>>(steps as readonly AnyStep<TOptions>[]);\n  // SAFETY: the tuple contains only steps with the inferred options type.\n  const orderedSteps = topologicalSort(steps as readonly AnyStep<TOptions>[]);\n  // SAFETY: explicit targets are a subset of TSteps; implicit targets come from its graph.\n  const declaredTargets = (definition.targets ??\n    orderedSteps?.slice(-1) ??\n    []) as readonly AnyStep<TOptions>[];\n  const duplicateTargetIds = duplicateValues(declaredTargets.map((target) => target.id));\n  if (duplicateTargetIds.length > 0) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_TARGETS_DUPLICATE\",\n        \"definition\",\n        \"definition\",\n        `Pipeline ${definition.id} declares duplicate targets: ${duplicateTargetIds.join(\", \")}`\n      )\n    );\n  }\n  const missingTargets = declaredTargets.filter((target) => !knownSteps.has(target));\n  if (missingTargets.length > 0) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_TARGET_NOT_IN_STEPS\",\n        \"definition\",\n        \"definition\",\n        `Pipeline ${definition.id} declares target step(s) not included in its steps list: ${missingTargets.map(({ id }) => id).join(\", \")}`\n      )\n    );\n  }\n  const missingReferences: string[] = [];\n  // SAFETY: `steps` is `TSteps extends readonly AnyStep[]`; the cast restores the\n  // `TOptions` generic that the tuple erased, without changing the values.\n  for (const step of steps as readonly AnyStep<TOptions>[]) {\n    for (const dependency of stepEdges(step)) {\n      if (!knownSteps.has(dependency)) {\n        missingReferences.push(`${step.id} -> ${dependency.id}`);\n      }\n    }\n  }\n  if (missingReferences.length > 0) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_DEPENDENCY_NOT_IN_STEPS\",\n        \"definition\",\n        \"definition\",\n        `Pipeline ${definition.id} references step(s) not included in its steps list: ${missingReferences.join(\", \")}`\n      )\n    );\n  }\n\n  const requiredFinalizerSteps = requiredFinalizerMetadata<TOptions>(definition.finalize)?.steps;\n  const missingFinalizerSteps = (requiredFinalizerSteps ?? []).filter(\n    (step) => !knownSteps.has(step)\n  );\n  if (missingFinalizerSteps.length > 0) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_FINALIZER_STEP_NOT_IN_STEPS\",\n        \"definition\",\n        \"definition\",\n        `Pipeline ${definition.id} requires finalizer output from step(s) not included in its steps list: ${missingFinalizerSteps.map(({ id }) => id).join(\", \")}`\n      )\n    );\n  }\n\n  if (\n    requiredFinalizerSteps &&\n    missingTargets.length === 0 &&\n    missingReferences.length === 0 &&\n    missingFinalizerSteps.length === 0\n  ) {\n    for (const target of declaredTargets) {\n      const selected = targetClosure([target]);\n      const missingRequiredSteps = requiredFinalizerSteps.filter((step) => !selected.has(step));\n      if (missingRequiredSteps.length > 0) {\n        errors.push(\n          pipelineDiagnostic(\n            \"TUBELESS_DEFINITION_TARGET_FINALIZER_MISMATCH\",\n            \"definition\",\n            \"definition\",\n            `Pipeline ${definition.id} target ${target.id} cannot satisfy required finalizer output(s): ${missingRequiredSteps.map(({ id }) => id).join(\", \")}`,\n            { stepId: target.id }\n          )\n        );\n      }\n    }\n  }\n\n  if (errors.length === 0 && !orderedSteps) {\n    errors.push(\n      pipelineDiagnostic(\n        \"TUBELESS_DEFINITION_DEPENDENCY_CYCLE\",\n        \"definition\",\n        \"definition\",\n        `Pipeline ${definition.id} has a dependency cycle`\n      )\n    );\n  }\n  return { errors, compiledCaches };\n}\n"]}

package/dist/core/pipeline-definition.d.ts

@@ -1,3 +1,5 @@
+import type { PipelineMetadata } from "../tracing/graph-metadata.js";
+import type { PipelineCacheOptions } from "./pipeline-cache.js";
 import type { AnyStep, Step, StepOutput } from "./pipeline-steps.js";
 import type { InferSchemaInput, PipelineExecutionContext, StandardSchemaV1 } from "./pipeline-types.js";
 /**
@@ -37,9 +39,13 @@ export type PipelineDefinition<TSteps extends readonly AnyStep[], TResult = Defa
     name?: string;
     /** Human-readable purpose shown by command and discovery surfaces. */
     description?: string;
+    /** Inert, bounded JSON metadata, snapshotted during compilation. */
+    metadata?: PipelineMetadata;
     /** Author- or build-supplied version of handlers, mappings, schemas, and finalizer (1–256 characters). */
     implementationVersion?: string;
     steps: TSteps;
+    /** Defaults for explicitly cacheable steps. */
+    cache?: PipelineCacheOptions;
     /** Selectable public goals; omitted exposes the last step in execution order.
      * This declaration never filters a run. Use `[]` to expose no goals.
      */

package/dist/core/pipeline-definition.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-definition.js","sourceRoot":"","sources":["../../src/core/pipeline-definition.ts"],"names":[],"mappings":"","sourcesContent":["import type { AnyStep, Step, StepOutput } from \"./pipeline-steps.js\";\nimport type {\n  InferSchemaInput,\n  PipelineExecutionContext,\n  StandardSchemaV1,\n} from \"./pipeline-types.js\";\n\n/**\n * Recovers the options type from the steps themselves rather than taking it as its own\n * generic parameter. A `TOptions` parameter constrained by `TSteps extends\n * readonly AnyStep<TOptions>[]` is self-referential — TypeScript can't solve that at a\n * `definePipeline(...)` call site and silently widens `TOptions` to its bare\n * `object` constraint (context.options would lose every pipeline-specific\n * field). Structuring it as \"derive TOptions from TSteps\" instead of \"constrain TSteps by\n * TOptions\" avoids the cycle, so callers never write out any of these type parameters.\n */\nexport type StepsOptions<TSteps extends readonly AnyStep[]> =\n  TSteps[number] extends AnyStep<infer TOptions> ? TOptions : object;\n\nexport type StepsInputOptions<TSteps extends readonly AnyStep[]> =\n  TSteps[number] extends Step<string, unknown, object, infer TInputOptions, infer _TRunOut>\n    ? TInputOptions\n    : StepsOptions<TSteps>;\n\n/** Preserve whether the step factory supplied a runtime options schema. */\nexport type StepsOptionsSchema<TSteps extends readonly AnyStep[]> =\n  TSteps[number] extends Step<string, unknown, object, object, unknown, infer TSchema>\n    ? TSchema\n    : StandardSchemaV1 | undefined;\n\nexport type StepIds<TSteps extends readonly AnyStep[]> = TSteps[number][\"id\"];\n\nexport type TargetIds<TTargets extends readonly AnyStep[]> = TTargets[number][\"id\"];\n\n// Step types retain output and ID types, but erase their dependency graph.\n// Any declared step may therefore be last in the runtime topological order.\ntype DefaultStepOutput<TSteps extends readonly AnyStep[]> = TSteps extends readonly []\n  ? undefined\n  : StepOutput<TSteps[number]>;\n\nexport type DefaultPipelineResult<TSteps extends readonly AnyStep[]> =\n  | DefaultStepOutput<TSteps>\n  | undefined;\n\nexport type DefaultPipelineTargets<TSteps extends readonly AnyStep[]> = readonly TSteps[number][];\n\ntype PipelineOutputs<TSteps extends readonly AnyStep[]> = {\n  [S in TSteps[number] as S[\"id\"]]: StepOutput<S>;\n};\n\ntype PipelineFinalizer<\n  TSteps extends readonly AnyStep[],\n  TResult,\n  TResultSchema extends StandardSchemaV1 | undefined,\n> = (\n  outputs: Partial<PipelineOutputs<TSteps>>,\n  context: PipelineExecutionContext<StepsOptions<TSteps>>\n) =>\n  | (TResultSchema extends StandardSchemaV1 ? InferSchemaInput<TResultSchema> : TResult)\n  | Promise<TResultSchema extends StandardSchemaV1 ? InferSchemaInput<TResultSchema> : TResult>;\n\ntype PipelineFinalizerSource<\n  TSteps extends readonly AnyStep[],\n  TResult,\n  TResultSchema extends StandardSchemaV1 | undefined,\n> =\n  | PipelineFinalizer<TSteps, TResult, TResultSchema>\n  | (TSteps[number] &\n      Step<\n        string,\n        TResultSchema extends StandardSchemaV1 ? InferSchemaInput<TResultSchema> : TResult,\n        StepsOptions<TSteps>,\n        StepsInputOptions<TSteps>,\n        unknown\n      >);\n\n/**\n * Declarative configuration for compiling a typed pipeline.\n *\n * A pipeline may omit finalize when its final step in execution order supplies the result.\n * Set finalize to a declared step to require and return its precisely typed output.\n * The default emits undefined if that step published no output. If its output cannot\n * satisfy an explicit result type or schema input, a compatible finalizer is required.\n */\nexport type PipelineDefinition<\n  TSteps extends readonly AnyStep[],\n  TResult = DefaultPipelineResult<TSteps>,\n  TTargets extends readonly TSteps[number][] = DefaultPipelineTargets<TSteps>,\n  TResultSchema extends StandardSchemaV1 | undefined = undefined,\n> = {\n  id: string;\n  /** Optional display name; stable identity remains `id`. */\n  name?: string;\n  /** Human-readable purpose shown by command and discovery surfaces. */\n  description?: string;\n  /** Author- or build-supplied version of handlers, mappings, schemas, and finalizer (1–256 characters). */\n  implementationVersion?: string;\n  steps: TSteps;\n  /** Selectable public goals; omitted exposes the last step in execution order.\n   * This declaration never filters a run. Use `[]` to expose no goals.\n   */\n  targets?: TTargets;\n  /** Optional Standard Schema for the finalized result. */\n  resultSchema?: TResultSchema;\n} & (TResultSchema extends StandardSchemaV1\n  ? [DefaultStepOutput<TSteps>] extends [InferSchemaInput<TResultSchema>]\n    ? { finalize?: PipelineFinalizerSource<TSteps, TResult, TResultSchema> }\n    : { finalize: PipelineFinalizerSource<TSteps, TResult, TResultSchema> }\n  : [DefaultPipelineResult<TSteps>] extends [TResult]\n    ? { finalize?: PipelineFinalizerSource<TSteps, TResult, TResultSchema> }\n    : { finalize: PipelineFinalizerSource<TSteps, TResult, TResultSchema> });\n"]}
+{"version":3,"file":"pipeline-definition.js","sourceRoot":"","sources":["../../src/core/pipeline-definition.ts"],"names":[],"mappings":"","sourcesContent":["import type { PipelineMetadata } from \"../tracing/graph-metadata.js\";\nimport type { PipelineCacheOptions } from \"./pipeline-cache.js\";\nimport type { AnyStep, Step, StepOutput } from \"./pipeline-steps.js\";\nimport type {\n  InferSchemaInput,\n  PipelineExecutionContext,\n  StandardSchemaV1,\n} from \"./pipeline-types.js\";\n\n/**\n * Recovers the options type from the steps themselves rather than taking it as its own\n * generic parameter. A `TOptions` parameter constrained by `TSteps extends\n * readonly AnyStep<TOptions>[]` is self-referential — TypeScript can't solve that at a\n * `definePipeline(...)` call site and silently widens `TOptions` to its bare\n * `object` constraint (context.options would lose every pipeline-specific\n * field). Structuring it as \"derive TOptions from TSteps\" instead of \"constrain TSteps by\n * TOptions\" avoids the cycle, so callers never write out any of these type parameters.\n */\nexport type StepsOptions<TSteps extends readonly AnyStep[]> =\n  TSteps[number] extends AnyStep<infer TOptions> ? TOptions : object;\n\nexport type StepsInputOptions<TSteps extends readonly AnyStep[]> =\n  TSteps[number] extends Step<string, unknown, object, infer TInputOptions, infer _TRunOut>\n    ? TInputOptions\n    : StepsOptions<TSteps>;\n\n/** Preserve whether the step factory supplied a runtime options schema. */\nexport type StepsOptionsSchema<TSteps extends readonly AnyStep[]> =\n  TSteps[number] extends Step<string, unknown, object, object, unknown, infer TSchema>\n    ? TSchema\n    : StandardSchemaV1 | undefined;\n\nexport type StepIds<TSteps extends readonly AnyStep[]> = TSteps[number][\"id\"];\n\nexport type TargetIds<TTargets extends readonly AnyStep[]> = TTargets[number][\"id\"];\n\n// Step types retain output and ID types, but erase their dependency graph.\n// Any declared step may therefore be last in the runtime topological order.\ntype DefaultStepOutput<TSteps extends readonly AnyStep[]> = TSteps extends readonly []\n  ? undefined\n  : StepOutput<TSteps[number]>;\n\nexport type DefaultPipelineResult<TSteps extends readonly AnyStep[]> =\n  | DefaultStepOutput<TSteps>\n  | undefined;\n\nexport type DefaultPipelineTargets<TSteps extends readonly AnyStep[]> = readonly TSteps[number][];\n\ntype PipelineOutputs<TSteps extends readonly AnyStep[]> = {\n  [S in TSteps[number] as S[\"id\"]]: StepOutput<S>;\n};\n\ntype PipelineFinalizer<\n  TSteps extends readonly AnyStep[],\n  TResult,\n  TResultSchema extends StandardSchemaV1 | undefined,\n> = (\n  outputs: Partial<PipelineOutputs<TSteps>>,\n  context: PipelineExecutionContext<StepsOptions<TSteps>>\n) =>\n  | (TResultSchema extends StandardSchemaV1 ? InferSchemaInput<TResultSchema> : TResult)\n  | Promise<TResultSchema extends StandardSchemaV1 ? InferSchemaInput<TResultSchema> : TResult>;\n\ntype PipelineFinalizerSource<\n  TSteps extends readonly AnyStep[],\n  TResult,\n  TResultSchema extends StandardSchemaV1 | undefined,\n> =\n  | PipelineFinalizer<TSteps, TResult, TResultSchema>\n  | (TSteps[number] &\n      Step<\n        string,\n        TResultSchema extends StandardSchemaV1 ? InferSchemaInput<TResultSchema> : TResult,\n        StepsOptions<TSteps>,\n        StepsInputOptions<TSteps>,\n        unknown\n      >);\n\n/**\n * Declarative configuration for compiling a typed pipeline.\n *\n * A pipeline may omit finalize when its final step in execution order supplies the result.\n * Set finalize to a declared step to require and return its precisely typed output.\n * The default emits undefined if that step published no output. If its output cannot\n * satisfy an explicit result type or schema input, a compatible finalizer is required.\n */\nexport type PipelineDefinition<\n  TSteps extends readonly AnyStep[],\n  TResult = DefaultPipelineResult<TSteps>,\n  TTargets extends readonly TSteps[number][] = DefaultPipelineTargets<TSteps>,\n  TResultSchema extends StandardSchemaV1 | undefined = undefined,\n> = {\n  id: string;\n  /** Optional display name; stable identity remains `id`. */\n  name?: string;\n  /** Human-readable purpose shown by command and discovery surfaces. */\n  description?: string;\n  /** Inert, bounded JSON metadata, snapshotted during compilation. */\n  metadata?: PipelineMetadata;\n  /** Author- or build-supplied version of handlers, mappings, schemas, and finalizer (1–256 characters). */\n  implementationVersion?: string;\n  steps: TSteps;\n  /** Defaults for explicitly cacheable steps. */\n  cache?: PipelineCacheOptions;\n  /** Selectable public goals; omitted exposes the last step in execution order.\n   * This declaration never filters a run. Use `[]` to expose no goals.\n   */\n  targets?: TTargets;\n  /** Optional Standard Schema for the finalized result. */\n  resultSchema?: TResultSchema;\n} & (TResultSchema extends StandardSchemaV1\n  ? [DefaultStepOutput<TSteps>] extends [InferSchemaInput<TResultSchema>]\n    ? { finalize?: PipelineFinalizerSource<TSteps, TResult, TResultSchema> }\n    : { finalize: PipelineFinalizerSource<TSteps, TResult, TResultSchema> }\n  : [DefaultPipelineResult<TSteps>] extends [TResult]\n    ? { finalize?: PipelineFinalizerSource<TSteps, TResult, TResultSchema> }\n    : { finalize: PipelineFinalizerSource<TSteps, TResult, TResultSchema> });\n"]}

package/dist/core/pipeline-execute.js

@@ -67,6 +67,7 @@ export async function executePlannedRun(input) {
         dryRun,
         log: lifecycle.logger(),
         options: pipelineOptions,
+        cachePolicy: controls.cache,
         runId,
         trace: lifecycle.traceContext,
     };
@@ -212,6 +213,10 @@ export async function executePlannedRun(input) {
         try {
             const output = await executeStepAttempt({
                 attemptId: attempt.attemptId,
+                pipelineId: compiled.id,
+                onCacheHit: () => {
+                    attempt.outputSource = "cache";
+                },
                 context: executionContext,
                 dryRun,
                 inputs: stepInputs,

package/dist/core/pipeline-execute.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-execute.js","sourceRoot":"","sources":["../../src/core/pipeline-execute.ts"],"names":[],"mappings":"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","sourcesContent":["import { abortableSleep, throwIfAborted as throwIfSignalAborted } from \"../utilities/abort.js\";\nimport { createPipelineLifecycleObserver } from \"./lifecycle.js\";\nimport { createRunId } from \"./pipeline-ids.js\";\nimport type { CompiledPipeline } from \"./pipeline-compiler.js\";\nimport type { StepsOptions } from \"./pipeline-definition.js\";\nimport { decideStepDisposition } from \"./pipeline-disposition.js\";\nimport { schedulePipelineSteps } from \"./pipeline-scheduler.js\";\nimport { compiledStepGraph } from \"./pipeline-graph.js\";\nimport { planStepById, stepToPlanStep } from \"./pipeline-plan.js\";\nimport { PipelineRunState, type PipelineStepAttempt } from \"./pipeline-run-state.js\";\nimport type { AnyStep } from \"./pipeline-steps.js\";\nimport { PIPELINE_FINALIZE_STEP_ID } from \"./pipeline-step-metadata.js\";\nimport {\n  evaluateStepSkip,\n  executeStepAttempt,\n  validateStepOutput,\n} from \"./pipeline-step-executor.js\";\nimport type {\n  InferSchemaOutput,\n  PipelineContext,\n  PipelineError,\n  PipelineExecutionContext,\n  PipelinePlan,\n  PipelinePlanStep,\n  PipelineRun,\n  PipelineRunControls,\n  PipelineRuntime,\n  StandardSchemaV1,\n} from \"./pipeline-types.js\";\nimport { PipelineBoundaryValidationError, validateStandardSchema } from \"./pipeline-validation.js\";\nimport {\n  finalizationError,\n  stepExecutionError,\n  toPipelineError,\n} from \"./pipeline-execution-error.js\";\n\ntype PipelineRunIdentity = { correlationId?: string; parentRunId?: string; runId: string };\n\nfunction throwIfAborted(runtime: PipelineRuntime): void {\n  throwIfSignalAborted(runtime.signal, \"Pipeline run\");\n}\n\nexport async function executePlannedRun<\n  TSteps extends readonly AnyStep[],\n  TResult,\n  TTargets extends readonly TSteps[number][],\n  TResultSchema extends StandardSchemaV1 | undefined,\n>(input: {\n  compiled: CompiledPipeline<TSteps, TResult, TTargets, TResultSchema>;\n  controls: PipelineRunControls;\n  domainOptions: object;\n  plan: PipelinePlan;\n  runtime: PipelineRuntime;\n  overrides?: ReadonlyMap<AnyStep, unknown>;\n}): Promise<\n  PipelineRun<TResultSchema extends StandardSchemaV1 ? InferSchemaOutput<TResultSchema> : TResult>\n> {\n  type TPipelineResult = TResultSchema extends StandardSchemaV1\n    ? InferSchemaOutput<TResultSchema>\n    : TResult;\n  type TOptions = StepsOptions<TSteps>;\n  const { compiled, controls, runtime } = input;\n  const startedAtMs = runtime.now();\n  const runId = createRunId(compiled.id);\n  const correlationId = runtime.correlationId;\n  const identity: PipelineRunIdentity = { runId };\n  if (correlationId !== undefined) identity.correlationId = correlationId;\n  if (runtime.parentRunId) identity.parentRunId = runtime.parentRunId;\n  const dryRun = controls.dryRun === true;\n  const lifecycle = createPipelineLifecycleObserver(compiled.id, runtime, {\n    ...identity,\n    itemKey: runtime.tracing?.itemKey,\n    iteration: runtime.tracing?.iteration,\n  });\n  const state = new PipelineRunState<TPipelineResult>(\n    compiled.id,\n    dryRun,\n    startedAtMs,\n    identity,\n    runtime.now,\n    lifecycle\n  );\n  state.start(input.plan, compiled.targetIds);\n\n  if (!input.plan.ok) {\n    state.recordRunErrors(input.plan.errors);\n    return state.finish();\n  }\n\n  const maxConcurrency = controls.maxConcurrency ?? 1;\n\n  // SAFETY: `domainOptions` is the user-supplied options object; if a schema\n  // is present it is re-validated below before assignment to `pipelineOptions`.\n  let pipelineOptions = input.domainOptions as TOptions;\n  if (compiled.optionsSchema) {\n    try {\n      const validated = await validateStandardSchema(\n        compiled.optionsSchema,\n        input.domainOptions,\n        `Pipeline ${compiled.id} options`\n      );\n      if (typeof validated !== \"object\" || validated === null || Array.isArray(validated)) {\n        throw new PipelineBoundaryValidationError(\n          `Pipeline ${compiled.id} options schema returned a non-object value`,\n          [{ message: \"Expected the validated options value to be an object\" }]\n        );\n      }\n      // SAFETY: the schema validated the value against `TOptions` and the\n      // object-shape check above passed, so the value is a `TOptions`.\n      pipelineOptions = validated as TOptions;\n    } catch (error) {\n      state.recordRunErrors([\n        toPipelineError(error, {\n          code: \"TUBELESS_OPTIONS_VALIDATION_FAILED\",\n          kind: \"validation\",\n          phase: \"execution\",\n        }),\n      ]);\n      return state.finish();\n    }\n  }\n\n  for (const step of input.plan.steps) state.planStep(step);\n\n  const executionContext: PipelineExecutionContext<TOptions> = {\n    ...runtime,\n    dryRun,\n    log: lifecycle.logger(),\n    options: pipelineOptions,\n    runId,\n    trace: lifecycle.traceContext,\n  };\n\n  const plannedSteps = planStepById(input.plan);\n  const stepsById = new Map(compiled.orderedSteps.map((step) => [step.id, step]));\n  // `input.plan.steps` is already topologically ordered. Rehydrate from the original step\n  // objects so callers still get the typed handlers rather than plan metadata.\n  // SAFETY: every planned step id originates from `compiled.orderedSteps`, so the\n  // map lookup always finds the matching `AnyStep<TOptions>`.\n  const orderedSteps = input.plan.steps.map((step) => stepsById.get(step.id) as AnyStep<TOptions>);\n  const plannedStepFor = (step: AnyStep<TOptions>): PipelinePlanStep =>\n    plannedSteps.get(step.id) ??\n    stepToPlanStep(step, true, undefined, undefined, compiledStepGraph(compiled, step));\n\n  let stopError: PipelineError | undefined;\n  let externalCancellationError: PipelineError | undefined;\n\n  const recordUnstartedStep = (step: AnyStep<TOptions>, error: PipelineError): void => {\n    const plannedStep = plannedStepFor(step);\n    // Only the external signal can override a selected step's planned skip.\n    if (plannedStep.skipReason && (!plannedStep.selected || error !== externalCancellationError)) {\n      const dependencyId =\n        plannedStep.skipReason === \"unmet-dependency\"\n          ? plannedStep.dependencies.find((id) => plannedSteps.get(id)?.skipReason !== undefined)\n          : undefined;\n      state.skipStep(plannedStep, { reason: plannedStep.skipReason, dependencyId });\n    } else if (error.kind === \"cancellation\") {\n      state.cancelStep(plannedStep, { ...error, stepId: step.id }, false);\n    } else {\n      state.skipStep(plannedStep, {\n        reason: \"fail-fast\",\n        message: `Not run because fail-fast stopped after ${error.stepId} failed.`,\n        dependencyId: error.stepId,\n      });\n    }\n  };\n\n  const recordExternalCancellation = (stepId: string): PipelineError | undefined => {\n    if (externalCancellationError) return externalCancellationError;\n    try {\n      throwIfAborted(runtime);\n      return undefined;\n    } catch (error) {\n      externalCancellationError = toPipelineError(error, {\n        code: \"TUBELESS_RUN_CANCELLED\",\n        kind: \"cancellation\",\n        phase: \"execution\",\n        stepId,\n      });\n      state.recordRunErrors([externalCancellationError]);\n      return externalCancellationError;\n    }\n  };\n\n  const cancelBeforeStepStart = (step: AnyStep<TOptions>): boolean => {\n    const pipelineError = recordExternalCancellation(step.id);\n    if (!pipelineError) return false;\n    stopError ??= pipelineError;\n    recordUnstartedStep(step, pipelineError);\n    return true;\n  };\n\n  const recordStepExecutionFailure = (\n    error: unknown,\n    plannedStep: PipelinePlanStep,\n    attempt: PipelineStepAttempt\n  ): void => {\n    const pipelineError = stepExecutionError(error, runtime, plannedStep.id);\n    state.failStep(plannedStep, attempt, pipelineError);\n    if (!controls.continueOnError) stopError ??= pipelineError;\n  };\n\n  const recordPolicySkip = async (\n    plannedStep: PipelinePlanStep,\n    step: AnyStep<TOptions>,\n    reason: string,\n    value: unknown\n  ): Promise<void> => {\n    let attempt: PipelineStepAttempt | undefined;\n    let published = value;\n    if (step.outputSchema) {\n      attempt = state.beginAttempt(plannedStep);\n      try {\n        published = await validateStepOutput(\n          step,\n          value,\n          `Pipeline ${compiled.id} step ${step.id} output`\n        );\n      } catch (error) {\n        return recordStepExecutionFailure(error, plannedStep, attempt);\n      }\n    }\n    state.skipStep(plannedStep, {\n      attempt,\n      message: reason,\n      output: { value: published },\n      reason: \"policy\",\n    });\n  };\n\n  const executeOneStep = async (step: AnyStep<TOptions>): Promise<void> => {\n    const plannedStep = plannedStepFor(step);\n    if (cancelBeforeStepStart(step)) return;\n\n    if (plannedStep.selected && input.overrides?.has(step)) {\n      const attempt = state.beginAttempt(plannedStep, runtime.now(), \"override\");\n      try {\n        const output = await validateStepOutput(\n          step,\n          input.overrides.get(step),\n          `Pipeline ${compiled.id} step ${step.id} override output`\n        );\n        throwIfAborted(runtime);\n        state.completeStep(plannedStep, attempt, output);\n      } catch (error) {\n        recordStepExecutionFailure(error, plannedStep, attempt);\n      }\n      return;\n    }\n\n    const graph = compiledStepGraph(compiled, step);\n    const disposition = decideStepDisposition({\n      dryRun,\n      graph,\n      planned: plannedStep,\n      reportsByStepId: state.reportsByStepId,\n      step,\n    });\n    if (disposition.kind === \"skip\") {\n      state.skipStep(plannedStep, disposition);\n      return;\n    }\n\n    const inputEntries: Array<[string, unknown]> = [];\n    for (const dep of graph.dependsOn) inputEntries.push([dep.id, state.outputs.get(dep.id)]);\n    for (const dep of graph.optionalDependsOn) {\n      if (state.outputs.has(dep.id)) inputEntries.push([dep.id, state.outputs.get(dep.id)]);\n    }\n    const stepInputs = Object.fromEntries(inputEntries);\n\n    if (typeof step.skip === \"function\") {\n      let skipDecision;\n      try {\n        skipDecision = await evaluateStepSkip(step, stepInputs, {\n          ...executionContext,\n          log: lifecycle.logger(step.id),\n        });\n      } catch (error) {\n        const attempt = state.beginAttempt(plannedStep);\n        recordStepExecutionFailure(error, plannedStep, attempt);\n        return;\n      }\n      if (cancelBeforeStepStart(step)) return;\n      if (skipDecision) {\n        await recordPolicySkip(plannedStep, step, skipDecision.reason, skipDecision.value);\n        return;\n      }\n    }\n\n    const attempt = state.beginAttempt(plannedStep);\n    try {\n      const output = await executeStepAttempt({\n        attemptId: attempt.attemptId,\n        context: executionContext,\n        dryRun,\n        inputs: stepInputs,\n        log: lifecycle.logger(step.id, attempt.attemptId),\n        onArtifact: (record, preview) =>\n          lifecycle.recordArtifact(step.id, attempt.attemptId, record, preview),\n        onProgress: (progress) => state.reportProgress(plannedStep, attempt, progress),\n        onReportAttempt: (number, attributes) =>\n          lifecycle.reportAttempt(step.id, number, attributes, attempt.attemptId),\n        outputBoundary: `Pipeline ${compiled.id} step ${step.id} output`,\n        step,\n      });\n      state.completeStep(plannedStep, attempt, output);\n    } catch (error) {\n      recordStepExecutionFailure(error, plannedStep, attempt);\n    }\n  };\n\n  const unstarted = await schedulePipelineSteps({\n    orderedSteps,\n    stepGraph: compiled.stepGraph,\n    maxConcurrency,\n    executeOneStep,\n    shouldStop: () => stopError !== undefined || runtime.signal?.aborted === true,\n  });\n  if (unstarted.length > 0 && runtime.signal?.aborted) {\n    // An external abort takes precedence for work that never started, even\n    // when an earlier failure stopped dispatch. Keep every active step's outcome.\n    // Only reuse diagnostics created from this signal, never a step-local AbortError.\n    stopError = recordExternalCancellation(unstarted[0]!.id)!;\n  }\n  for (const step of unstarted) recordUnstartedStep(step, stopError!);\n\n  if (state.errors.length === 0 || controls.continueOnError) {\n    const finalizeStartedAt = runtime.now();\n    state.beginFinalization();\n    try {\n      throwIfAborted(runtime);\n      // SAFETY: `state.outputs` maps step ids to their produced values, which is\n      // exactly the shape the finalizer's outputs parameter describes.\n      const finalOutputs = Object.fromEntries(state.outputs) as Parameters<\n        CompiledPipeline<TSteps, TResult, TTargets, TResultSchema>[\"finalize\"]\n      >[0];\n      const finalizedValue = await compiled.finalize(finalOutputs, {\n        ...executionContext,\n        log: lifecycle.logger(PIPELINE_FINALIZE_STEP_ID),\n      });\n      // SAFETY: with a result schema the value is validated against\n      // `TPipelineResult`; without one the finalizer's declared return type\n      // is `TPipelineResult`, so the cast only restores that type.\n      const value = compiled.resultSchema\n        ? ((await validateStandardSchema(\n            compiled.resultSchema,\n            finalizedValue,\n            `Pipeline ${compiled.id} final result`\n          )) as TPipelineResult)\n        : (finalizedValue as TPipelineResult);\n      state.completeFinalization(value, runtime.now() - finalizeStartedAt);\n    } catch (error) {\n      const pipelineError = finalizationError(error, runtime);\n      state.failFinalization(pipelineError, runtime.now() - finalizeStartedAt);\n    }\n  }\n\n  return state.finish();\n}\n\nconst fallbackNow = (): number => Date.now();\n\nconst fallbackSleep = (durationMs: number, signal?: AbortSignal): Promise<void> =>\n  abortableSleep(durationMs, signal, \"Pipeline sleep\");\n\nexport function defaultPipelineContext(): PipelineContext {\n  return { cwd: process.cwd(), log: console, now: fallbackNow, sleep: fallbackSleep };\n}\n\nexport function resolvePipelineRuntime(context: Partial<PipelineContext> = {}): PipelineRuntime {\n  const defaults = defaultPipelineContext();\n  return {\n    ...defaults,\n    ...context,\n    cwd: context.cwd ?? defaults.cwd,\n    log: context.log ?? defaults.log,\n    now: context.now ?? defaults.now ?? fallbackNow,\n    sleep: context.sleep ?? defaults.sleep ?? fallbackSleep,\n  };\n}\n"]}
+{"version":3,"file":"pipeline-execute.js","sourceRoot":"","sources":["../../src/core/pipeline-execute.ts"],"names":[],"mappings":"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","sourcesContent":["import { abortableSleep, throwIfAborted as throwIfSignalAborted } from \"../utilities/abort.js\";\nimport { createPipelineLifecycleObserver } from \"./lifecycle.js\";\nimport { createRunId } from \"./pipeline-ids.js\";\nimport type { CompiledPipeline } from \"./pipeline-compiler.js\";\nimport type { StepsOptions } from \"./pipeline-definition.js\";\nimport { decideStepDisposition } from \"./pipeline-disposition.js\";\nimport { schedulePipelineSteps } from \"./pipeline-scheduler.js\";\nimport { compiledStepGraph } from \"./pipeline-graph.js\";\nimport { planStepById, stepToPlanStep } from \"./pipeline-plan.js\";\nimport { PipelineRunState, type PipelineStepAttempt } from \"./pipeline-run-state.js\";\nimport type { AnyStep } from \"./pipeline-steps.js\";\nimport { PIPELINE_FINALIZE_STEP_ID } from \"./pipeline-step-metadata.js\";\nimport {\n  evaluateStepSkip,\n  executeStepAttempt,\n  validateStepOutput,\n} from \"./pipeline-step-executor.js\";\nimport type {\n  InferSchemaOutput,\n  PipelineContext,\n  PipelineError,\n  PipelineExecutionContext,\n  PipelinePlan,\n  PipelinePlanStep,\n  PipelineRun,\n  PipelineRunControls,\n  PipelineRuntime,\n  StandardSchemaV1,\n} from \"./pipeline-types.js\";\nimport { PipelineBoundaryValidationError, validateStandardSchema } from \"./pipeline-validation.js\";\nimport {\n  finalizationError,\n  stepExecutionError,\n  toPipelineError,\n} from \"./pipeline-execution-error.js\";\n\ntype PipelineRunIdentity = { correlationId?: string; parentRunId?: string; runId: string };\n\nfunction throwIfAborted(runtime: PipelineRuntime): void {\n  throwIfSignalAborted(runtime.signal, \"Pipeline run\");\n}\n\nexport async function executePlannedRun<\n  TSteps extends readonly AnyStep[],\n  TResult,\n  TTargets extends readonly TSteps[number][],\n  TResultSchema extends StandardSchemaV1 | undefined,\n>(input: {\n  compiled: CompiledPipeline<TSteps, TResult, TTargets, TResultSchema>;\n  controls: PipelineRunControls;\n  domainOptions: object;\n  plan: PipelinePlan;\n  runtime: PipelineRuntime;\n  overrides?: ReadonlyMap<AnyStep, unknown>;\n}): Promise<\n  PipelineRun<TResultSchema extends StandardSchemaV1 ? InferSchemaOutput<TResultSchema> : TResult>\n> {\n  type TPipelineResult = TResultSchema extends StandardSchemaV1\n    ? InferSchemaOutput<TResultSchema>\n    : TResult;\n  type TOptions = StepsOptions<TSteps>;\n  const { compiled, controls, runtime } = input;\n  const startedAtMs = runtime.now();\n  const runId = createRunId(compiled.id);\n  const correlationId = runtime.correlationId;\n  const identity: PipelineRunIdentity = { runId };\n  if (correlationId !== undefined) identity.correlationId = correlationId;\n  if (runtime.parentRunId) identity.parentRunId = runtime.parentRunId;\n  const dryRun = controls.dryRun === true;\n  const lifecycle = createPipelineLifecycleObserver(compiled.id, runtime, {\n    ...identity,\n    itemKey: runtime.tracing?.itemKey,\n    iteration: runtime.tracing?.iteration,\n  });\n  const state = new PipelineRunState<TPipelineResult>(\n    compiled.id,\n    dryRun,\n    startedAtMs,\n    identity,\n    runtime.now,\n    lifecycle\n  );\n  state.start(input.plan, compiled.targetIds);\n\n  if (!input.plan.ok) {\n    state.recordRunErrors(input.plan.errors);\n    return state.finish();\n  }\n\n  const maxConcurrency = controls.maxConcurrency ?? 1;\n\n  // SAFETY: `domainOptions` is the user-supplied options object; if a schema\n  // is present it is re-validated below before assignment to `pipelineOptions`.\n  let pipelineOptions = input.domainOptions as TOptions;\n  if (compiled.optionsSchema) {\n    try {\n      const validated = await validateStandardSchema(\n        compiled.optionsSchema,\n        input.domainOptions,\n        `Pipeline ${compiled.id} options`\n      );\n      if (typeof validated !== \"object\" || validated === null || Array.isArray(validated)) {\n        throw new PipelineBoundaryValidationError(\n          `Pipeline ${compiled.id} options schema returned a non-object value`,\n          [{ message: \"Expected the validated options value to be an object\" }]\n        );\n      }\n      // SAFETY: the schema validated the value against `TOptions` and the\n      // object-shape check above passed, so the value is a `TOptions`.\n      pipelineOptions = validated as TOptions;\n    } catch (error) {\n      state.recordRunErrors([\n        toPipelineError(error, {\n          code: \"TUBELESS_OPTIONS_VALIDATION_FAILED\",\n          kind: \"validation\",\n          phase: \"execution\",\n        }),\n      ]);\n      return state.finish();\n    }\n  }\n\n  for (const step of input.plan.steps) state.planStep(step);\n\n  const executionContext: PipelineExecutionContext<TOptions> = {\n    ...runtime,\n    dryRun,\n    log: lifecycle.logger(),\n    options: pipelineOptions,\n    cachePolicy: controls.cache,\n    runId,\n    trace: lifecycle.traceContext,\n  };\n\n  const plannedSteps = planStepById(input.plan);\n  const stepsById = new Map(compiled.orderedSteps.map((step) => [step.id, step]));\n  // `input.plan.steps` is already topologically ordered. Rehydrate from the original step\n  // objects so callers still get the typed handlers rather than plan metadata.\n  // SAFETY: every planned step id originates from `compiled.orderedSteps`, so the\n  // map lookup always finds the matching `AnyStep<TOptions>`.\n  const orderedSteps = input.plan.steps.map((step) => stepsById.get(step.id) as AnyStep<TOptions>);\n  const plannedStepFor = (step: AnyStep<TOptions>): PipelinePlanStep =>\n    plannedSteps.get(step.id) ??\n    stepToPlanStep(step, true, undefined, undefined, compiledStepGraph(compiled, step));\n\n  let stopError: PipelineError | undefined;\n  let externalCancellationError: PipelineError | undefined;\n\n  const recordUnstartedStep = (step: AnyStep<TOptions>, error: PipelineError): void => {\n    const plannedStep = plannedStepFor(step);\n    // Only the external signal can override a selected step's planned skip.\n    if (plannedStep.skipReason && (!plannedStep.selected || error !== externalCancellationError)) {\n      const dependencyId =\n        plannedStep.skipReason === \"unmet-dependency\"\n          ? plannedStep.dependencies.find((id) => plannedSteps.get(id)?.skipReason !== undefined)\n          : undefined;\n      state.skipStep(plannedStep, { reason: plannedStep.skipReason, dependencyId });\n    } else if (error.kind === \"cancellation\") {\n      state.cancelStep(plannedStep, { ...error, stepId: step.id }, false);\n    } else {\n      state.skipStep(plannedStep, {\n        reason: \"fail-fast\",\n        message: `Not run because fail-fast stopped after ${error.stepId} failed.`,\n        dependencyId: error.stepId,\n      });\n    }\n  };\n\n  const recordExternalCancellation = (stepId: string): PipelineError | undefined => {\n    if (externalCancellationError) return externalCancellationError;\n    try {\n      throwIfAborted(runtime);\n      return undefined;\n    } catch (error) {\n      externalCancellationError = toPipelineError(error, {\n        code: \"TUBELESS_RUN_CANCELLED\",\n        kind: \"cancellation\",\n        phase: \"execution\",\n        stepId,\n      });\n      state.recordRunErrors([externalCancellationError]);\n      return externalCancellationError;\n    }\n  };\n\n  const cancelBeforeStepStart = (step: AnyStep<TOptions>): boolean => {\n    const pipelineError = recordExternalCancellation(step.id);\n    if (!pipelineError) return false;\n    stopError ??= pipelineError;\n    recordUnstartedStep(step, pipelineError);\n    return true;\n  };\n\n  const recordStepExecutionFailure = (\n    error: unknown,\n    plannedStep: PipelinePlanStep,\n    attempt: PipelineStepAttempt\n  ): void => {\n    const pipelineError = stepExecutionError(error, runtime, plannedStep.id);\n    state.failStep(plannedStep, attempt, pipelineError);\n    if (!controls.continueOnError) stopError ??= pipelineError;\n  };\n\n  const recordPolicySkip = async (\n    plannedStep: PipelinePlanStep,\n    step: AnyStep<TOptions>,\n    reason: string,\n    value: unknown\n  ): Promise<void> => {\n    let attempt: PipelineStepAttempt | undefined;\n    let published = value;\n    if (step.outputSchema) {\n      attempt = state.beginAttempt(plannedStep);\n      try {\n        published = await validateStepOutput(\n          step,\n          value,\n          `Pipeline ${compiled.id} step ${step.id} output`\n        );\n      } catch (error) {\n        return recordStepExecutionFailure(error, plannedStep, attempt);\n      }\n    }\n    state.skipStep(plannedStep, {\n      attempt,\n      message: reason,\n      output: { value: published },\n      reason: \"policy\",\n    });\n  };\n\n  const executeOneStep = async (step: AnyStep<TOptions>): Promise<void> => {\n    const plannedStep = plannedStepFor(step);\n    if (cancelBeforeStepStart(step)) return;\n\n    if (plannedStep.selected && input.overrides?.has(step)) {\n      const attempt = state.beginAttempt(plannedStep, runtime.now(), \"override\");\n      try {\n        const output = await validateStepOutput(\n          step,\n          input.overrides.get(step),\n          `Pipeline ${compiled.id} step ${step.id} override output`\n        );\n        throwIfAborted(runtime);\n        state.completeStep(plannedStep, attempt, output);\n      } catch (error) {\n        recordStepExecutionFailure(error, plannedStep, attempt);\n      }\n      return;\n    }\n\n    const graph = compiledStepGraph(compiled, step);\n    const disposition = decideStepDisposition({\n      dryRun,\n      graph,\n      planned: plannedStep,\n      reportsByStepId: state.reportsByStepId,\n      step,\n    });\n    if (disposition.kind === \"skip\") {\n      state.skipStep(plannedStep, disposition);\n      return;\n    }\n\n    const inputEntries: Array<[string, unknown]> = [];\n    for (const dep of graph.dependsOn) inputEntries.push([dep.id, state.outputs.get(dep.id)]);\n    for (const dep of graph.optionalDependsOn) {\n      if (state.outputs.has(dep.id)) inputEntries.push([dep.id, state.outputs.get(dep.id)]);\n    }\n    const stepInputs = Object.fromEntries(inputEntries);\n\n    if (typeof step.skip === \"function\") {\n      let skipDecision;\n      try {\n        skipDecision = await evaluateStepSkip(step, stepInputs, {\n          ...executionContext,\n          log: lifecycle.logger(step.id),\n        });\n      } catch (error) {\n        const attempt = state.beginAttempt(plannedStep);\n        recordStepExecutionFailure(error, plannedStep, attempt);\n        return;\n      }\n      if (cancelBeforeStepStart(step)) return;\n      if (skipDecision) {\n        await recordPolicySkip(plannedStep, step, skipDecision.reason, skipDecision.value);\n        return;\n      }\n    }\n\n    const attempt = state.beginAttempt(plannedStep);\n    try {\n      const output = await executeStepAttempt({\n        attemptId: attempt.attemptId,\n        pipelineId: compiled.id,\n        onCacheHit: () => {\n          attempt.outputSource = \"cache\";\n        },\n        context: executionContext,\n        dryRun,\n        inputs: stepInputs,\n        log: lifecycle.logger(step.id, attempt.attemptId),\n        onArtifact: (record, preview) =>\n          lifecycle.recordArtifact(step.id, attempt.attemptId, record, preview),\n        onProgress: (progress) => state.reportProgress(plannedStep, attempt, progress),\n        onReportAttempt: (number, attributes) =>\n          lifecycle.reportAttempt(step.id, number, attributes, attempt.attemptId),\n        outputBoundary: `Pipeline ${compiled.id} step ${step.id} output`,\n        step,\n      });\n      state.completeStep(plannedStep, attempt, output);\n    } catch (error) {\n      recordStepExecutionFailure(error, plannedStep, attempt);\n    }\n  };\n\n  const unstarted = await schedulePipelineSteps({\n    orderedSteps,\n    stepGraph: compiled.stepGraph,\n    maxConcurrency,\n    executeOneStep,\n    shouldStop: () => stopError !== undefined || runtime.signal?.aborted === true,\n  });\n  if (unstarted.length > 0 && runtime.signal?.aborted) {\n    // An external abort takes precedence for work that never started, even\n    // when an earlier failure stopped dispatch. Keep every active step's outcome.\n    // Only reuse diagnostics created from this signal, never a step-local AbortError.\n    stopError = recordExternalCancellation(unstarted[0]!.id)!;\n  }\n  for (const step of unstarted) recordUnstartedStep(step, stopError!);\n\n  if (state.errors.length === 0 || controls.continueOnError) {\n    const finalizeStartedAt = runtime.now();\n    state.beginFinalization();\n    try {\n      throwIfAborted(runtime);\n      // SAFETY: `state.outputs` maps step ids to their produced values, which is\n      // exactly the shape the finalizer's outputs parameter describes.\n      const finalOutputs = Object.fromEntries(state.outputs) as Parameters<\n        CompiledPipeline<TSteps, TResult, TTargets, TResultSchema>[\"finalize\"]\n      >[0];\n      const finalizedValue = await compiled.finalize(finalOutputs, {\n        ...executionContext,\n        log: lifecycle.logger(PIPELINE_FINALIZE_STEP_ID),\n      });\n      // SAFETY: with a result schema the value is validated against\n      // `TPipelineResult`; without one the finalizer's declared return type\n      // is `TPipelineResult`, so the cast only restores that type.\n      const value = compiled.resultSchema\n        ? ((await validateStandardSchema(\n            compiled.resultSchema,\n            finalizedValue,\n            `Pipeline ${compiled.id} final result`\n          )) as TPipelineResult)\n        : (finalizedValue as TPipelineResult);\n      state.completeFinalization(value, runtime.now() - finalizeStartedAt);\n    } catch (error) {\n      const pipelineError = finalizationError(error, runtime);\n      state.failFinalization(pipelineError, runtime.now() - finalizeStartedAt);\n    }\n  }\n\n  return state.finish();\n}\n\nconst fallbackNow = (): number => Date.now();\n\nconst fallbackSleep = (durationMs: number, signal?: AbortSignal): Promise<void> =>\n  abortableSleep(durationMs, signal, \"Pipeline sleep\");\n\nexport function defaultPipelineContext(): PipelineContext {\n  return { cwd: process.cwd(), log: console, now: fallbackNow, sleep: fallbackSleep };\n}\n\nexport function resolvePipelineRuntime(context: Partial<PipelineContext> = {}): PipelineRuntime {\n  const defaults = defaultPipelineContext();\n  return {\n    ...defaults,\n    ...context,\n    cwd: context.cwd ?? defaults.cwd,\n    log: context.log ?? defaults.log,\n    now: context.now ?? defaults.now ?? fallbackNow,\n    sleep: context.sleep ?? defaults.sleep ?? fallbackSleep,\n  };\n}\n"]}

package/dist/core/pipeline-graph.d.ts

@@ -1,3 +1,4 @@
+import type { CompiledStepCache } from "./pipeline-cache.js";
 import type { AnyStep } from "./pipeline-steps.js";
 export interface CompiledStepGraph<TOptions extends object = object> {
     readonly dependsOn: readonly AnyStep<TOptions>[];
@@ -20,4 +21,4 @@ export interface CompiledPipelineGraph<TOptions extends object> {
     readonly orderedSteps: readonly CompiledStep<TOptions>[];
     readonly stepGraph: ReadonlyMap<AnyStep, CompiledStepGraph>;
 }
-export declare function compilePipelineGraph<TOptions extends object>(steps: readonly AnyStep<TOptions>[]): CompiledPipelineGraph<TOptions>;
+export declare function compilePipelineGraph<TOptions extends object>(steps: readonly AnyStep<TOptions>[], compiledCaches?: ReadonlyMap<AnyStep, CompiledStepCache<TOptions>>): CompiledPipelineGraph<TOptions>;

package/dist/core/pipeline-graph.js

@@ -1,4 +1,5 @@
-import { STEP_NESTED_PIPELINE, STEP_OPTIONS_SCHEMA, STEP_REMOTE, } from "./pipeline-step-metadata.js";
+import { snapshotPipelineMetadata } from "../tracing/graph-metadata.js";
+import { STEP_CACHE, STEP_NESTED_PIPELINE, STEP_OPTIONS_SCHEMA, STEP_REMOTE, } from "./pipeline-step-metadata.js";
 export function liveStepGraph(step) {
     return {
         dependsOn: step.dependsOn ?? [],
@@ -6,12 +7,13 @@ export function liveStepGraph(step) {
         skipAfterFailureOf: step.skipAfterFailureOf ?? [],
     };
 }
-function compileStep(step) {
+function compileStep(step, cache) {
     const nestedPipeline = step[STEP_NESTED_PIPELINE];
     const remote = step[STEP_REMOTE];
     const optionsSchema = step[STEP_OPTIONS_SCHEMA];
     const name = step.name;
     const description = step.description;
+    const metadata = snapshotPipelineMetadata(step.metadata);
     const dryRun = step.dryRun;
     const outputSchema = step.outputSchema;
     const skip = step.skip;
@@ -31,6 +33,8 @@ function compileStep(step) {
         Object.assign(compiled, { [STEP_REMOTE]: Object.freeze({ ...remote }) });
     if (optionsSchema !== undefined)
         Object.assign(compiled, { [STEP_OPTIONS_SCHEMA]: optionsSchema });
+    if (metadata !== undefined)
+        Object.assign(compiled, { metadata });
     if (name !== undefined)
         Object.assign(compiled, { name });
     if (description !== undefined)
@@ -40,6 +44,8 @@ function compileStep(step) {
             dryRun: typeof dryRun === "function" ? dryRun.bind(step) : dryRun,
         });
     }
+    if (cache)
+        Object.assign(compiled, { [STEP_CACHE]: cache });
     if (outputSchema !== undefined)
         Object.assign(compiled, { outputSchema });
     if (skip !== undefined)
@@ -122,9 +128,9 @@ export function topologicalSort(steps) {
     // SAFETY: every id in `orderedIds` came from the same `steps` array.
     return orderedIds.map((id) => stepsById.get(id));
 }
-export function compilePipelineGraph(steps) {
+export function compilePipelineGraph(steps, compiledCaches = new Map()) {
     const orderedAuthorSteps = topologicalSort(steps);
-    const compiledByAuthorStep = new Map(orderedAuthorSteps.map((step) => [step, compileStep(step)]));
+    const compiledByAuthorStep = new Map(orderedAuthorSteps.map((step) => [step, compileStep(step, compiledCaches.get(step))]));
     const orderedSteps = orderedAuthorSteps.map((step) => compiledByAuthorStep.get(step));
     const stepGraph = new Map(orderedAuthorSteps.map((step) => {
         const compiled = compiledByAuthorStep.get(step);

package/dist/core/pipeline-graph.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-graph.js","sourceRoot":"","sources":["../../src/core/pipeline-graph.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AnyStep } from \"./pipeline-steps.js\";\nimport {\n  STEP_NESTED_PIPELINE,\n  STEP_OPTIONS_SCHEMA,\n  STEP_REMOTE,\n} from \"./pipeline-step-metadata.js\";\n\nexport interface CompiledStepGraph<TOptions extends object = object> {\n  readonly dependsOn: readonly AnyStep<TOptions>[];\n  readonly optionalDependsOn: readonly AnyStep<TOptions>[];\n  readonly skipAfterFailureOf: readonly AnyStep<TOptions>[];\n}\n\nexport type CompiledStep<TOptions extends object = object> = Omit<\n  AnyStep<TOptions>,\n  \"dependsOn\" | \"optionalDependsOn\" | \"skipAfterFailureOf\"\n>;\n\nexport function liveStepGraph<TOptions extends object>(\n  step: AnyStep<TOptions>\n): CompiledStepGraph<TOptions> {\n  return {\n    dependsOn: step.dependsOn ?? [],\n    optionalDependsOn: step.optionalDependsOn ?? [],\n    skipAfterFailureOf: step.skipAfterFailureOf ?? [],\n  };\n}\n\nfunction compileStep<TOptions extends object>(step: AnyStep<TOptions>): CompiledStep<TOptions> {\n  const nestedPipeline = step[STEP_NESTED_PIPELINE];\n  const remote = step[STEP_REMOTE];\n  const optionsSchema = step[STEP_OPTIONS_SCHEMA];\n  const name = step.name;\n  const description = step.description;\n  const dryRun = step.dryRun;\n  const outputSchema = step.outputSchema;\n  const skip = step.skip;\n  const compiled = {\n    id: step.id,\n    run: step.run.bind(step),\n  };\n  if (nestedPipeline !== undefined) {\n    Object.assign(compiled, {\n      [STEP_NESTED_PIPELINE]: Object.freeze({\n        ...nestedPipeline,\n        stepIds: Object.freeze([...nestedPipeline.stepIds]),\n      }),\n    });\n  }\n  if (remote !== undefined)\n    Object.assign(compiled, { [STEP_REMOTE]: Object.freeze({ ...remote }) });\n  if (optionsSchema !== undefined)\n    Object.assign(compiled, { [STEP_OPTIONS_SCHEMA]: optionsSchema });\n  if (name !== undefined) Object.assign(compiled, { name });\n  if (description !== undefined) Object.assign(compiled, { description });\n  if (dryRun !== undefined) {\n    Object.assign(compiled, {\n      dryRun: typeof dryRun === \"function\" ? dryRun.bind(step) : dryRun,\n    });\n  }\n  if (outputSchema !== undefined) Object.assign(compiled, { outputSchema });\n  if (skip !== undefined) Object.assign(compiled, { skip: skip.bind(step) });\n  return Object.freeze(compiled);\n}\n\nfunction snapshotCompiledStepGraph<TOptions extends object>(\n  step: AnyStep<TOptions>,\n  compiledByAuthorStep: ReadonlyMap<AnyStep<TOptions>, CompiledStep<TOptions>>\n): CompiledStepGraph<TOptions> {\n  const compileDependencies = (\n    dependencies: readonly AnyStep<TOptions>[] | undefined\n  ): readonly CompiledStep<TOptions>[] =>\n    Object.freeze(\n      (dependencies ?? []).map((dependency) => {\n        const compiled = compiledByAuthorStep.get(dependency);\n        if (compiled === undefined) {\n          throw new Error(`Compiled pipeline graph is missing dependency ${dependency.id}`);\n        }\n        return compiled;\n      })\n    );\n  return Object.freeze({\n    dependsOn: compileDependencies(step.dependsOn),\n    optionalDependsOn: compileDependencies(step.optionalDependsOn),\n    skipAfterFailureOf: compileDependencies(step.skipAfterFailureOf),\n  });\n}\n\nexport function compiledStepGraph<TOptions extends object>(\n  compiled: Pick<{ stepGraph: ReadonlyMap<AnyStep, CompiledStepGraph> }, \"stepGraph\">,\n  step: AnyStep<TOptions>\n): CompiledStepGraph<TOptions> {\n  const graph = compiled.stepGraph.get(step);\n  if (graph === undefined) {\n    throw new Error(`Compiled pipeline graph is missing step ${step.id}`);\n  }\n  // SAFETY: compile stores each descriptor as the map key.\n  return graph as CompiledStepGraph<TOptions>;\n}\n\n/** Returns every distinct edge into a step, regardless of dependency policy. */\nexport function stepEdges<TOptions extends object>(\n  step: AnyStep<TOptions>,\n  graph: CompiledStepGraph<TOptions> = liveStepGraph(step)\n): readonly AnyStep<TOptions>[] {\n  return [\n    ...new Set([...graph.dependsOn, ...graph.optionalDependsOn, ...graph.skipAfterFailureOf]),\n  ];\n}\n\n/** Required data and failure-gate closure for dependency-aware targets. */\nexport function targetClosure<TOptions extends object>(\n  targets: readonly AnyStep<TOptions>[]\n): Set<AnyStep<TOptions>> {\n  const selected = new Set<AnyStep<TOptions>>();\n  const include = (step: AnyStep<TOptions>): void => {\n    if (selected.has(step)) return;\n    selected.add(step);\n    for (const prerequisite of [...(step.dependsOn ?? []), ...(step.skipAfterFailureOf ?? [])]) {\n      include(prerequisite);\n    }\n  };\n  for (const target of targets) include(target);\n  return selected;\n}\n\n/** Orders steps so every dependency runs before its dependents. */\nexport function topologicalSort<TOptions extends object>(\n  steps: readonly AnyStep<TOptions>[]\n): readonly AnyStep<TOptions>[] | null {\n  const indexById = new Map(steps.map((step, index) => [step.id, index]));\n  const remainingInDegree = new Map(steps.map((step) => [step.id, stepEdges(step).length]));\n  const dependentsOf = new Map<string, string[]>();\n  for (const step of steps) {\n    for (const dep of stepEdges(step)) {\n      const dependents = dependentsOf.get(dep.id) ?? [];\n      dependents.push(step.id);\n      dependentsOf.set(dep.id, dependents);\n    }\n  }\n\n  const ready = steps.filter((step) => remainingInDegree.get(step.id) === 0).map((step) => step.id);\n  const orderedIds: string[] = [];\n  while (ready.length > 0) {\n    ready.sort((left, right) => (indexById.get(left) ?? 0) - (indexById.get(right) ?? 0));\n    const nextId = ready.shift();\n    if (nextId === undefined) break;\n    orderedIds.push(nextId);\n    for (const dependentId of dependentsOf.get(nextId) ?? []) {\n      const remaining = (remainingInDegree.get(dependentId) ?? 0) - 1;\n      remainingInDegree.set(dependentId, remaining);\n      if (remaining === 0) ready.push(dependentId);\n    }\n  }\n\n  if (orderedIds.length !== steps.length) return null;\n  const stepsById = new Map(steps.map((step) => [step.id, step]));\n  // SAFETY: every id in `orderedIds` came from the same `steps` array.\n  return orderedIds.map((id) => stepsById.get(id) as AnyStep<TOptions>);\n}\n\nexport interface CompiledPipelineGraph<TOptions extends object> {\n  readonly compiledByAuthorStep: ReadonlyMap<AnyStep<TOptions>, CompiledStep<TOptions>>;\n  readonly orderedSteps: readonly CompiledStep<TOptions>[];\n  readonly stepGraph: ReadonlyMap<AnyStep, CompiledStepGraph>;\n}\n\nexport function compilePipelineGraph<TOptions extends object>(\n  steps: readonly AnyStep<TOptions>[]\n): CompiledPipelineGraph<TOptions> {\n  const orderedAuthorSteps = topologicalSort(steps)!;\n  const compiledByAuthorStep = new Map<AnyStep<TOptions>, CompiledStep<TOptions>>(\n    orderedAuthorSteps.map((step) => [step, compileStep(step)])\n  );\n  const orderedSteps = orderedAuthorSteps.map((step) => compiledByAuthorStep.get(step)!);\n  const stepGraph = new Map<AnyStep, CompiledStepGraph>(\n    orderedAuthorSteps.map((step) => {\n      const compiled = compiledByAuthorStep.get(step)!;\n      return [compiled, snapshotCompiledStepGraph(step, compiledByAuthorStep)];\n    })\n  );\n  return { compiledByAuthorStep, orderedSteps, stepGraph };\n}\n"]}
+{"version":3,"file":"pipeline-graph.js","sourceRoot":"","sources":["../../src/core/pipeline-graph.ts"],"names":[],"mappings":"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","sourcesContent":["import { snapshotPipelineMetadata } from \"../tracing/graph-metadata.js\";\nimport type { CompiledStepCache } from \"./pipeline-cache.js\";\nimport type { AnyStep } from \"./pipeline-steps.js\";\nimport {\n  STEP_CACHE,\n  STEP_NESTED_PIPELINE,\n  STEP_OPTIONS_SCHEMA,\n  STEP_REMOTE,\n} from \"./pipeline-step-metadata.js\";\n\nexport interface CompiledStepGraph<TOptions extends object = object> {\n  readonly dependsOn: readonly AnyStep<TOptions>[];\n  readonly optionalDependsOn: readonly AnyStep<TOptions>[];\n  readonly skipAfterFailureOf: readonly AnyStep<TOptions>[];\n}\n\nexport type CompiledStep<TOptions extends object = object> = Omit<\n  AnyStep<TOptions>,\n  \"dependsOn\" | \"optionalDependsOn\" | \"skipAfterFailureOf\"\n>;\n\nexport function liveStepGraph<TOptions extends object>(\n  step: AnyStep<TOptions>\n): CompiledStepGraph<TOptions> {\n  return {\n    dependsOn: step.dependsOn ?? [],\n    optionalDependsOn: step.optionalDependsOn ?? [],\n    skipAfterFailureOf: step.skipAfterFailureOf ?? [],\n  };\n}\n\nfunction compileStep<TOptions extends object>(\n  step: AnyStep<TOptions>,\n  cache: CompiledStepCache<TOptions> | undefined\n): CompiledStep<TOptions> {\n  const nestedPipeline = step[STEP_NESTED_PIPELINE];\n  const remote = step[STEP_REMOTE];\n  const optionsSchema = step[STEP_OPTIONS_SCHEMA];\n  const name = step.name;\n  const description = step.description;\n  const metadata = snapshotPipelineMetadata(step.metadata);\n  const dryRun = step.dryRun;\n  const outputSchema = step.outputSchema;\n  const skip = step.skip;\n  const compiled = {\n    id: step.id,\n    run: step.run.bind(step),\n  };\n  if (nestedPipeline !== undefined) {\n    Object.assign(compiled, {\n      [STEP_NESTED_PIPELINE]: Object.freeze({\n        ...nestedPipeline,\n        stepIds: Object.freeze([...nestedPipeline.stepIds]),\n      }),\n    });\n  }\n  if (remote !== undefined)\n    Object.assign(compiled, { [STEP_REMOTE]: Object.freeze({ ...remote }) });\n  if (optionsSchema !== undefined)\n    Object.assign(compiled, { [STEP_OPTIONS_SCHEMA]: optionsSchema });\n  if (metadata !== undefined) Object.assign(compiled, { metadata });\n  if (name !== undefined) Object.assign(compiled, { name });\n  if (description !== undefined) Object.assign(compiled, { description });\n  if (dryRun !== undefined) {\n    Object.assign(compiled, {\n      dryRun: typeof dryRun === \"function\" ? dryRun.bind(step) : dryRun,\n    });\n  }\n  if (cache) Object.assign(compiled, { [STEP_CACHE]: cache });\n  if (outputSchema !== undefined) Object.assign(compiled, { outputSchema });\n  if (skip !== undefined) Object.assign(compiled, { skip: skip.bind(step) });\n  return Object.freeze(compiled);\n}\n\nfunction snapshotCompiledStepGraph<TOptions extends object>(\n  step: AnyStep<TOptions>,\n  compiledByAuthorStep: ReadonlyMap<AnyStep<TOptions>, CompiledStep<TOptions>>\n): CompiledStepGraph<TOptions> {\n  const compileDependencies = (\n    dependencies: readonly AnyStep<TOptions>[] | undefined\n  ): readonly CompiledStep<TOptions>[] =>\n    Object.freeze(\n      (dependencies ?? []).map((dependency) => {\n        const compiled = compiledByAuthorStep.get(dependency);\n        if (compiled === undefined) {\n          throw new Error(`Compiled pipeline graph is missing dependency ${dependency.id}`);\n        }\n        return compiled;\n      })\n    );\n  return Object.freeze({\n    dependsOn: compileDependencies(step.dependsOn),\n    optionalDependsOn: compileDependencies(step.optionalDependsOn),\n    skipAfterFailureOf: compileDependencies(step.skipAfterFailureOf),\n  });\n}\n\nexport function compiledStepGraph<TOptions extends object>(\n  compiled: Pick<{ stepGraph: ReadonlyMap<AnyStep, CompiledStepGraph> }, \"stepGraph\">,\n  step: AnyStep<TOptions>\n): CompiledStepGraph<TOptions> {\n  const graph = compiled.stepGraph.get(step);\n  if (graph === undefined) {\n    throw new Error(`Compiled pipeline graph is missing step ${step.id}`);\n  }\n  // SAFETY: compile stores each descriptor as the map key.\n  return graph as CompiledStepGraph<TOptions>;\n}\n\n/** Returns every distinct edge into a step, regardless of dependency policy. */\nexport function stepEdges<TOptions extends object>(\n  step: AnyStep<TOptions>,\n  graph: CompiledStepGraph<TOptions> = liveStepGraph(step)\n): readonly AnyStep<TOptions>[] {\n  return [\n    ...new Set([...graph.dependsOn, ...graph.optionalDependsOn, ...graph.skipAfterFailureOf]),\n  ];\n}\n\n/** Required data and failure-gate closure for dependency-aware targets. */\nexport function targetClosure<TOptions extends object>(\n  targets: readonly AnyStep<TOptions>[]\n): Set<AnyStep<TOptions>> {\n  const selected = new Set<AnyStep<TOptions>>();\n  const include = (step: AnyStep<TOptions>): void => {\n    if (selected.has(step)) return;\n    selected.add(step);\n    for (const prerequisite of [...(step.dependsOn ?? []), ...(step.skipAfterFailureOf ?? [])]) {\n      include(prerequisite);\n    }\n  };\n  for (const target of targets) include(target);\n  return selected;\n}\n\n/** Orders steps so every dependency runs before its dependents. */\nexport function topologicalSort<TOptions extends object>(\n  steps: readonly AnyStep<TOptions>[]\n): readonly AnyStep<TOptions>[] | null {\n  const indexById = new Map(steps.map((step, index) => [step.id, index]));\n  const remainingInDegree = new Map(steps.map((step) => [step.id, stepEdges(step).length]));\n  const dependentsOf = new Map<string, string[]>();\n  for (const step of steps) {\n    for (const dep of stepEdges(step)) {\n      const dependents = dependentsOf.get(dep.id) ?? [];\n      dependents.push(step.id);\n      dependentsOf.set(dep.id, dependents);\n    }\n  }\n\n  const ready = steps.filter((step) => remainingInDegree.get(step.id) === 0).map((step) => step.id);\n  const orderedIds: string[] = [];\n  while (ready.length > 0) {\n    ready.sort((left, right) => (indexById.get(left) ?? 0) - (indexById.get(right) ?? 0));\n    const nextId = ready.shift();\n    if (nextId === undefined) break;\n    orderedIds.push(nextId);\n    for (const dependentId of dependentsOf.get(nextId) ?? []) {\n      const remaining = (remainingInDegree.get(dependentId) ?? 0) - 1;\n      remainingInDegree.set(dependentId, remaining);\n      if (remaining === 0) ready.push(dependentId);\n    }\n  }\n\n  if (orderedIds.length !== steps.length) return null;\n  const stepsById = new Map(steps.map((step) => [step.id, step]));\n  // SAFETY: every id in `orderedIds` came from the same `steps` array.\n  return orderedIds.map((id) => stepsById.get(id) as AnyStep<TOptions>);\n}\n\nexport interface CompiledPipelineGraph<TOptions extends object> {\n  readonly compiledByAuthorStep: ReadonlyMap<AnyStep<TOptions>, CompiledStep<TOptions>>;\n  readonly orderedSteps: readonly CompiledStep<TOptions>[];\n  readonly stepGraph: ReadonlyMap<AnyStep, CompiledStepGraph>;\n}\n\nexport function compilePipelineGraph<TOptions extends object>(\n  steps: readonly AnyStep<TOptions>[],\n  compiledCaches: ReadonlyMap<AnyStep, CompiledStepCache<TOptions>> = new Map()\n): CompiledPipelineGraph<TOptions> {\n  const orderedAuthorSteps = topologicalSort(steps)!;\n  const compiledByAuthorStep = new Map<AnyStep<TOptions>, CompiledStep<TOptions>>(\n    orderedAuthorSteps.map((step) => [step, compileStep(step, compiledCaches.get(step))])\n  );\n  const orderedSteps = orderedAuthorSteps.map((step) => compiledByAuthorStep.get(step)!);\n  const stepGraph = new Map<AnyStep, CompiledStepGraph>(\n    orderedAuthorSteps.map((step) => {\n      const compiled = compiledByAuthorStep.get(step)!;\n      return [compiled, snapshotCompiledStepGraph(step, compiledByAuthorStep)];\n    })\n  );\n  return { compiledByAuthorStep, orderedSteps, stepGraph };\n}\n"]}

package/dist/core/pipeline-mermaid.js

@@ -1,3 +1,4 @@
+import { matchesStepQuery } from "./pipeline-query.js";
 import { liveStepGraph, stepEdges } from "./pipeline-graph.js";
 import { STEP_NESTED_PIPELINE } from "./pipeline-step-metadata.js";
 import { PIPELINE_MERMAID_DIRECTIONS } from "./pipeline-types.js";
@@ -12,6 +13,7 @@ function escapeMermaidLabel(value) {
         .replace(/>/g, "#62;");
 }
 export function renderPipelineMermaid(steps, options, stepGraph) {
+    steps = steps.filter((step) => matchesStepQuery(step.metadata, options.query ?? {}));
     const direction = options.direction ?? "TD";
     if (!PIPELINE_MERMAID_DIRECTIONS.includes(direction)) {
         throw new Error(`Invalid Mermaid flowchart direction: ${direction}`);
@@ -21,9 +23,11 @@ export function renderPipelineMermaid(steps, options, stepGraph) {
     for (const step of steps) {
         const nodeId = nodeIdByStep.get(step);
         const displayName = step.name ?? step.id;
-        const label = options.includeDescriptions && step.description
+        let label = options.includeDescriptions && step.description
             ? `${displayName} — ${step.description}`
             : displayName;
+        if (options.includeMetadata && step.metadata)
+            label += ` — ${JSON.stringify(step.metadata)}`;
         const nested = step[STEP_NESTED_PIPELINE];
         const iteration = nested?.mode === "iterate" ? ` (at most ${nested.maxIterations} iterations)` : "";
         lines.push(`  ${nodeId}["${escapeMermaidLabel(label + iteration)}"]`);
@@ -37,6 +41,8 @@ export function renderPipelineMermaid(steps, options, stepGraph) {
         const failureGates = new Set(graph.skipAfterFailureOf);
         for (const dependency of stepEdges(step, graph)) {
             const sourceId = nodeIdByStep.get(dependency);
+            if (sourceId === undefined)
+                continue;
             if (required.has(dependency)) {
                 edgeLines.push(`  ${sourceId} --> ${targetId}`);
                 continue;

package/dist/core/pipeline-mermaid.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-mermaid.js","sourceRoot":"","sources":["../../src/core/pipeline-mermaid.ts"],"names":[],"mappings":"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","sourcesContent":["import { liveStepGraph, stepEdges, type CompiledStepGraph } from \"./pipeline-graph.js\";\nimport type { AnyStep } from \"./pipeline-steps.js\";\nimport { STEP_NESTED_PIPELINE } from \"./pipeline-step-metadata.js\";\nimport { PIPELINE_MERMAID_DIRECTIONS, type PipelineMermaidOptions } from \"./pipeline-types.js\";\n\nfunction escapeMermaidLabel(value: string): string {\n  return value\n    .replace(/\\r\\n?|\\n/g, \" \")\n    .replace(/[\\u0000-\\u001f\\u007f-\\u009f]/g, \" \")\n    .replace(/#/g, \"#35;\")\n    .replace(/&/g, \"#38;\")\n    .replace(/\"/g, \"#quot;\")\n    .replace(/</g, \"#60;\")\n    .replace(/>/g, \"#62;\");\n}\n\nexport function renderPipelineMermaid<TOptions extends object>(\n  steps: readonly AnyStep<TOptions>[],\n  options: PipelineMermaidOptions,\n  stepGraph?: ReadonlyMap<AnyStep, CompiledStepGraph>\n): string {\n  const direction = options.direction ?? \"TD\";\n  if (!PIPELINE_MERMAID_DIRECTIONS.includes(direction)) {\n    throw new Error(`Invalid Mermaid flowchart direction: ${direction}`);\n  }\n  const nodeIdByStep = new Map(steps.map((step, index) => [step, `step${index}`]));\n  const lines = [`flowchart ${direction}`];\n\n  for (const step of steps) {\n    const nodeId = nodeIdByStep.get(step)!;\n    const displayName = step.name ?? step.id;\n    const label =\n      options.includeDescriptions && step.description\n        ? `${displayName} — ${step.description}`\n        : displayName;\n    const nested = step[STEP_NESTED_PIPELINE];\n    const iteration =\n      nested?.mode === \"iterate\" ? ` (at most ${nested.maxIterations} iterations)` : \"\";\n    lines.push(`  ${nodeId}[\"${escapeMermaidLabel(label + iteration)}\"]`);\n  }\n\n  const edgeLines: string[] = [];\n  for (const step of steps) {\n    const graph = stepGraph?.get(step) ?? liveStepGraph(step);\n    const targetId = nodeIdByStep.get(step)!;\n    const required = new Set(graph.dependsOn);\n    const optional = new Set(graph.optionalDependsOn);\n    const failureGates = new Set(graph.skipAfterFailureOf);\n\n    for (const dependency of stepEdges(step, graph)) {\n      const sourceId = nodeIdByStep.get(dependency)!;\n      if (required.has(dependency)) {\n        edgeLines.push(`  ${sourceId} --> ${targetId}`);\n        continue;\n      }\n      if (optional.has(dependency) && failureGates.has(dependency)) {\n        edgeLines.push(`  ${sourceId} -. optional input + failure gate .-> ${targetId}`);\n        continue;\n      }\n      if (optional.has(dependency)) {\n        edgeLines.push(`  ${sourceId} -. optional input .-> ${targetId}`);\n        continue;\n      }\n      edgeLines.push(`  ${sourceId} -. failure gate .-> ${targetId}`);\n    }\n  }\n\n  if (edgeLines.length > 0) lines.push(\"\", ...edgeLines);\n  return `${lines.join(\"\\n\")}\\n`;\n}\n"]}
+{"version":3,"file":"pipeline-mermaid.js","sourceRoot":"","sources":["../../src/core/pipeline-mermaid.ts"],"names":[],"mappings":"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","sourcesContent":["import { matchesStepQuery } from \"./pipeline-query.js\";\nimport { liveStepGraph, stepEdges, type CompiledStepGraph } from \"./pipeline-graph.js\";\nimport type { AnyStep } from \"./pipeline-steps.js\";\nimport { STEP_NESTED_PIPELINE } from \"./pipeline-step-metadata.js\";\nimport { PIPELINE_MERMAID_DIRECTIONS, type PipelineMermaidOptions } from \"./pipeline-types.js\";\n\nfunction escapeMermaidLabel(value: string): string {\n  return value\n    .replace(/\\r\\n?|\\n/g, \" \")\n    .replace(/[\\u0000-\\u001f\\u007f-\\u009f]/g, \" \")\n    .replace(/#/g, \"#35;\")\n    .replace(/&/g, \"#38;\")\n    .replace(/\"/g, \"#quot;\")\n    .replace(/</g, \"#60;\")\n    .replace(/>/g, \"#62;\");\n}\n\nexport function renderPipelineMermaid<TOptions extends object>(\n  steps: readonly AnyStep<TOptions>[],\n  options: PipelineMermaidOptions,\n  stepGraph?: ReadonlyMap<AnyStep, CompiledStepGraph>\n): string {\n  steps = steps.filter((step) => matchesStepQuery(step.metadata, options.query ?? {}));\n  const direction = options.direction ?? \"TD\";\n  if (!PIPELINE_MERMAID_DIRECTIONS.includes(direction)) {\n    throw new Error(`Invalid Mermaid flowchart direction: ${direction}`);\n  }\n  const nodeIdByStep = new Map(steps.map((step, index) => [step, `step${index}`]));\n  const lines = [`flowchart ${direction}`];\n\n  for (const step of steps) {\n    const nodeId = nodeIdByStep.get(step)!;\n    const displayName = step.name ?? step.id;\n    let label =\n      options.includeDescriptions && step.description\n        ? `${displayName} — ${step.description}`\n        : displayName;\n    if (options.includeMetadata && step.metadata) label += ` — ${JSON.stringify(step.metadata)}`;\n    const nested = step[STEP_NESTED_PIPELINE];\n    const iteration =\n      nested?.mode === \"iterate\" ? ` (at most ${nested.maxIterations} iterations)` : \"\";\n    lines.push(`  ${nodeId}[\"${escapeMermaidLabel(label + iteration)}\"]`);\n  }\n\n  const edgeLines: string[] = [];\n  for (const step of steps) {\n    const graph = stepGraph?.get(step) ?? liveStepGraph(step);\n    const targetId = nodeIdByStep.get(step)!;\n    const required = new Set(graph.dependsOn);\n    const optional = new Set(graph.optionalDependsOn);\n    const failureGates = new Set(graph.skipAfterFailureOf);\n\n    for (const dependency of stepEdges(step, graph)) {\n      const sourceId = nodeIdByStep.get(dependency);\n      if (sourceId === undefined) continue;\n      if (required.has(dependency)) {\n        edgeLines.push(`  ${sourceId} --> ${targetId}`);\n        continue;\n      }\n      if (optional.has(dependency) && failureGates.has(dependency)) {\n        edgeLines.push(`  ${sourceId} -. optional input + failure gate .-> ${targetId}`);\n        continue;\n      }\n      if (optional.has(dependency)) {\n        edgeLines.push(`  ${sourceId} -. optional input .-> ${targetId}`);\n        continue;\n      }\n      edgeLines.push(`  ${sourceId} -. failure gate .-> ${targetId}`);\n    }\n  }\n\n  if (edgeLines.length > 0) lines.push(\"\", ...edgeLines);\n  return `${lines.join(\"\\n\")}\\n`;\n}\n"]}

package/dist/core/pipeline-plan.js

@@ -8,6 +8,7 @@ export function stepToPlanStep(step, selected, skipReason, selectionReasons, gra
     const planStep = {
         dependencies: graph.dependsOn.map((dep) => dep.id),
         description: step.description,
+        ...(step.metadata === undefined ? {} : { metadata: step.metadata }),
         dryRun: step.dryRun === "skip" ? "skip" : step.dryRun !== undefined ? "custom" : "run",
         id: step.id,
         name: step.name,
@@ -86,6 +87,9 @@ export function buildPipelinePlan(compiled, controls) {
     const declaredTargetIds = new Set(compiled.declaredTargets.map((target) => target.id));
     const requestedStepIds = controls.stepIds ?? [];
     const requestedTargets = controls.targets ?? [];
+    if (controls.cache !== undefined && !["use", "recompute", "bypass"].includes(controls.cache)) {
+        errors.push(pipelineDiagnostic("TUBELESS_RUN_CACHE_INVALID", "planning", "validation", "cache must be use, recompute, or bypass"));
+    }
     const maxConcurrency = controls.maxConcurrency ?? 1;
     if (!Number.isInteger(maxConcurrency) || maxConcurrency < 1) {
         errors.push(pipelineDiagnostic("TUBELESS_RUN_CONCURRENCY_INVALID", "planning", "validation", "maxConcurrency must be a positive finite integer"));