tubeless 0.2.3 → 0.2.4

package/dist/core/pipeline-compiler.js

@@ -0,0 +1,44 @@
+import { validatePipelineDefinition } from "./pipeline-definition-validation.js";
+import { PipelineDefinitionError } from "./pipeline-errors.js";
+import { requiredFinalizerMetadata } from "./pipeline-finalizer.js";
+import { compilePipelineGraph } from "./pipeline-graph.js";
+import { STEP_OPTIONS_SCHEMA } from "./pipeline-step-metadata.js";
+export function compilePipeline(definition) {
+    const errors = validatePipelineDefinition(definition);
+    if (errors.length > 0) {
+        throw new PipelineDefinitionError(definition.id, errors);
+    }
+    // SAFETY: `steps` is `TSteps extends readonly AnyStep[]`; the cast restores
+    // the `TOptions` generic that the tuple erased, without changing the values.
+    const { compiledByAuthorStep, orderedSteps, stepGraph } = compilePipelineGraph(definition.steps);
+    const finalizerMetadata = requiredFinalizerMetadata(definition.finalize);
+    const requiredFinalizerSteps = finalizerMetadata?.steps;
+    // SAFETY: targets are a subset of `TSteps[number]`, each an `AnyStep<TOptions>`.
+    const declaredTargets = (definition.targets ?? []);
+    const compiledTargets = declaredTargets.map((target) => compiledByAuthorStep.get(target));
+    const compiledRequiredFinalizerSteps = requiredFinalizerSteps?.map((step) => compiledByAuthorStep.get(step));
+    const compiledFinalize = finalizerMetadata
+        ? finalizerMetadata.compile(compiledRequiredFinalizerSteps.map((step) => step.id))
+        : (outputs, context) => definition.finalize(outputs, context);
+    return Object.freeze({
+        declaredTargets: Object.freeze(compiledTargets),
+        // Invoke ordinary finalizers on the author's definition so method-style
+        // implementations keep `this`. Required finalizers compile the same input
+        // and context contract with stable required ids.
+        // SAFETY: both branches preserve `definition.finalize`'s call signature.
+        finalize: compiledFinalize,
+        id: definition.id,
+        optionsSchema: definition.steps.length === 0
+            ? undefined
+            : compiledByAuthorStep.get(definition.steps[0])?.[STEP_OPTIONS_SCHEMA],
+        orderedSteps: Object.freeze([...orderedSteps]),
+        stepGraph,
+        requiredFinalizerSteps: compiledRequiredFinalizerSteps
+            ? Object.freeze(compiledRequiredFinalizerSteps)
+            : undefined,
+        resultSchema: definition.resultSchema,
+        stepIds: Object.freeze(definition.steps.map((step) => compiledByAuthorStep.get(step).id)),
+        targetIds: Object.freeze(compiledTargets.map((step) => step.id)),
+    });
+}
+//# sourceMappingURL=pipeline-compiler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-compiler.js","sourceRoot":"","sources":["../../src/core/pipeline-compiler.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PipelineDefinition, StepsOptions } from \"./pipeline-definition.js\";\nimport { validatePipelineDefinition } from \"./pipeline-definition-validation.js\";\nimport { PipelineDefinitionError } from \"./pipeline-errors.js\";\nimport { requiredFinalizerMetadata } from \"./pipeline-finalizer.js\";\nimport { compilePipelineGraph, type CompiledStepGraph } from \"./pipeline-graph.js\";\nimport type { AnyStep } from \"./pipeline-steps.js\";\nimport { STEP_OPTIONS_SCHEMA } from \"./pipeline-step-metadata.js\";\nimport type { StandardSchemaV1 } from \"./pipeline-types.js\";\n\nexport interface CompiledPipeline<\n  TSteps extends readonly AnyStep[] = readonly AnyStep[],\n  TResult = unknown,\n  TTargets extends readonly TSteps[number][] = readonly [],\n  TResultSchema extends StandardSchemaV1 | undefined = undefined,\n> {\n  readonly declaredTargets: readonly AnyStep<StepsOptions<TSteps>>[];\n  readonly finalize: PipelineDefinition<TSteps, TResult, TTargets, TResultSchema>[\"finalize\"];\n  readonly id: string;\n  readonly optionsSchema: StandardSchemaV1 | undefined;\n  readonly orderedSteps: readonly AnyStep<StepsOptions<TSteps>>[];\n  readonly requiredFinalizerSteps: readonly AnyStep<StepsOptions<TSteps>>[] | undefined;\n  readonly stepGraph: ReadonlyMap<AnyStep, CompiledStepGraph>;\n  readonly resultSchema: TResultSchema | undefined;\n  readonly stepIds: readonly string[];\n  readonly targetIds: readonly string[];\n}\n\nexport function compilePipeline<\n  TSteps extends readonly AnyStep[],\n  TResult,\n  TTargets extends readonly TSteps[number][],\n  TResultSchema extends StandardSchemaV1 | undefined,\n>(\n  definition: PipelineDefinition<TSteps, TResult, TTargets, TResultSchema>\n): CompiledPipeline<TSteps, TResult, TTargets, TResultSchema> {\n  const errors = validatePipelineDefinition(definition);\n  if (errors.length > 0) {\n    throw new PipelineDefinitionError(definition.id, errors);\n  }\n  type TOptions = StepsOptions<TSteps>;\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 { compiledByAuthorStep, orderedSteps, stepGraph } = compilePipelineGraph(\n    definition.steps as readonly AnyStep<TOptions>[]\n  );\n  const finalizerMetadata = requiredFinalizerMetadata<TOptions>(definition.finalize);\n  const requiredFinalizerSteps = finalizerMetadata?.steps;\n  // SAFETY: targets are a subset of `TSteps[number]`, each an `AnyStep<TOptions>`.\n  const declaredTargets = (definition.targets ?? []) as readonly AnyStep<TOptions>[];\n  const compiledTargets = declaredTargets.map((target) => compiledByAuthorStep.get(target)!);\n  const compiledRequiredFinalizerSteps = requiredFinalizerSteps?.map((step) =>\n    compiledByAuthorStep.get(step)!\n  );\n  const compiledFinalize = finalizerMetadata\n    ? finalizerMetadata.compile(compiledRequiredFinalizerSteps!.map((step) => step.id))\n    : (\n        outputs: Parameters<typeof definition.finalize>[0],\n        context: Parameters<typeof definition.finalize>[1]\n      ) => definition.finalize(outputs, context);\n  return Object.freeze({\n    declaredTargets: Object.freeze(compiledTargets),\n    // Invoke ordinary finalizers on the author's definition so method-style\n    // implementations keep `this`. Required finalizers compile the same input\n    // and context contract with stable required ids.\n    // SAFETY: both branches preserve `definition.finalize`'s call signature.\n    finalize: compiledFinalize as typeof definition.finalize,\n    id: definition.id,\n    optionsSchema:\n      definition.steps.length === 0\n        ? undefined\n        : compiledByAuthorStep.get(definition.steps[0]!)?.[STEP_OPTIONS_SCHEMA],\n    orderedSteps: Object.freeze([...orderedSteps]),\n    stepGraph,\n    requiredFinalizerSteps: compiledRequiredFinalizerSteps\n      ? Object.freeze(compiledRequiredFinalizerSteps)\n      : undefined,\n    resultSchema: definition.resultSchema,\n    stepIds: Object.freeze(definition.steps.map((step) => compiledByAuthorStep.get(step)!.id)),\n    targetIds: Object.freeze(compiledTargets.map((step) => step.id)),\n  });\n}\n"]}

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

@@ -0,0 +1,4 @@
+import type { PipelineDefinition } from "./pipeline-definition.js";
+import type { AnyStep } from "./pipeline-steps.js";
+import type { PipelineError, StandardSchemaV1 } from "./pipeline-types.js";
+export declare function validatePipelineDefinition<TSteps extends readonly AnyStep[], TResult, TTargets extends readonly TSteps[number][], TResultSchema extends StandardSchemaV1 | undefined>(definition: PipelineDefinition<TSteps, TResult, TTargets, TResultSchema>): PipelineError[];

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

@@ -0,0 +1,101 @@
+import { duplicateValues } from "../utilities/collections.js";
+import { requiredFinalizerMetadata } from "./pipeline-finalizer.js";
+import { stepEdges, targetClosure, topologicalSort } from "./pipeline-graph.js";
+import { pipelineDiagnostic } from "./pipeline-errors.js";
+import { PIPELINE_FINALIZE_STEP_ID, STEP_OPTIONS_SCHEMA } from "./pipeline-step-metadata.js";
+export function validatePipelineDefinition(definition) {
+    const steps = definition.steps;
+    const errors = [];
+    if (definition.id.trim().length === 0) {
+        errors.push(pipelineDiagnostic("TUBELESS_DEFINITION_PIPELINE_ID_BLANK", "definition", "definition", "Pipeline id must not be blank"));
+    }
+    const stepIds = steps.map((step) => step.id);
+    const duplicateStepIds = duplicateValues(stepIds);
+    if (duplicateStepIds.length > 0) {
+        errors.push(pipelineDiagnostic("TUBELESS_DEFINITION_STEP_IDS_DUPLICATE", "definition", "definition", `Pipeline ${definition.id} has duplicate step ids: ${duplicateStepIds.join(", ")}`));
+    }
+    const optionsSchemas = new Set(steps.map((step) => step[STEP_OPTIONS_SCHEMA]));
+    if (optionsSchemas.size > 1 && [...optionsSchemas].some(Boolean)) {
+        errors.push(pipelineDiagnostic("TUBELESS_DEFINITION_OPTIONS_SCHEMA_CONFLICT", "definition", "definition", `Pipeline ${definition.id} mixes steps from different options-schema scopes`));
+    }
+    for (const step of steps) {
+        if (step.id.trim().length === 0) {
+            errors.push(pipelineDiagnostic("TUBELESS_DEFINITION_STEP_ID_BLANK", "definition", "definition", `Pipeline ${definition.id} has a step with a blank id`, { stepId: step.id }));
+        }
+        if (step.id === PIPELINE_FINALIZE_STEP_ID) {
+            errors.push(pipelineDiagnostic("TUBELESS_DEFINITION_STEP_ID_RESERVED", "definition", "definition", `Pipeline ${definition.id} uses reserved step id ${PIPELINE_FINALIZE_STEP_ID}`, { stepId: step.id }));
+        }
+        if (step.name !== undefined && step.name.trim().length === 0) {
+            errors.push(pipelineDiagnostic("TUBELESS_DEFINITION_STEP_NAME_BLANK", "definition", "definition", `Pipeline ${definition.id} step ${step.id} has a blank display name`, { stepId: step.id }));
+        }
+        const dependencyGroups = [
+            ["dependsOn", step.dependsOn ?? []],
+            ["optionalDependsOn", step.optionalDependsOn ?? []],
+            ["skipAfterFailureOf", step.skipAfterFailureOf ?? []],
+        ];
+        for (const [field, dependencies] of dependencyGroups) {
+            const duplicates = duplicateValues(dependencies.map((dependency) => dependency.id));
+            if (duplicates.length > 0) {
+                errors.push(pipelineDiagnostic("TUBELESS_DEFINITION_DEPENDENCY_DUPLICATE", "definition", "definition", `Pipeline ${definition.id} step ${step.id} repeats ${field}: ${duplicates.join(", ")}`, { stepId: step.id }));
+            }
+            if (dependencies.includes(step)) {
+                errors.push(pipelineDiagnostic("TUBELESS_DEFINITION_DEPENDENCY_SELF_REFERENCE", "definition", "definition", `Pipeline ${definition.id} step ${step.id} cannot reference itself in ${field}`, { stepId: step.id }));
+            }
+        }
+        const required = new Set(step.dependsOn ?? []);
+        const contradictory = (step.optionalDependsOn ?? []).filter((dependency) => required.has(dependency));
+        if (contradictory.length > 0) {
+            errors.push(pipelineDiagnostic("TUBELESS_DEFINITION_DEPENDENCY_CONTRADICTORY", "definition", "definition", `Pipeline ${definition.id} step ${step.id} declares dependencies as both required and optional: ${contradictory.map(({ id }) => id).join(", ")}`, { stepId: step.id }));
+        }
+    }
+    // SAFETY: `steps` is `TSteps extends readonly AnyStep[]`; the cast restores
+    // the `TOptions` generic that the tuple erased, without changing the values.
+    const knownSteps = new Set(steps);
+    // SAFETY: targets are a subset of `TSteps[number]`, each an `AnyStep<TOptions>`.
+    const declaredTargets = (definition.targets ?? []);
+    const duplicateTargetIds = duplicateValues(declaredTargets.map((target) => target.id));
+    if (duplicateTargetIds.length > 0) {
+        errors.push(pipelineDiagnostic("TUBELESS_DEFINITION_TARGETS_DUPLICATE", "definition", "definition", `Pipeline ${definition.id} declares duplicate targets: ${duplicateTargetIds.join(", ")}`));
+    }
+    const missingTargets = declaredTargets.filter((target) => !knownSteps.has(target));
+    if (missingTargets.length > 0) {
+        errors.push(pipelineDiagnostic("TUBELESS_DEFINITION_TARGET_NOT_IN_STEPS", "definition", "definition", `Pipeline ${definition.id} declares target step(s) not included in its steps list: ${missingTargets.map(({ id }) => id).join(", ")}`));
+    }
+    const missingReferences = [];
+    // SAFETY: `steps` is `TSteps extends readonly AnyStep[]`; the cast restores the
+    // `TOptions` generic that the tuple erased, without changing the values.
+    for (const step of steps) {
+        for (const dependency of stepEdges(step)) {
+            if (!knownSteps.has(dependency)) {
+                missingReferences.push(`${step.id} -> ${dependency.id}`);
+            }
+        }
+    }
+    if (missingReferences.length > 0) {
+        errors.push(pipelineDiagnostic("TUBELESS_DEFINITION_DEPENDENCY_NOT_IN_STEPS", "definition", "definition", `Pipeline ${definition.id} references step(s) not included in its steps list: ${missingReferences.join(", ")}`));
+    }
+    const requiredFinalizerSteps = requiredFinalizerMetadata(definition.finalize)?.steps;
+    const missingFinalizerSteps = (requiredFinalizerSteps ?? []).filter((step) => !knownSteps.has(step));
+    if (missingFinalizerSteps.length > 0) {
+        errors.push(pipelineDiagnostic("TUBELESS_DEFINITION_FINALIZER_STEP_NOT_IN_STEPS", "definition", "definition", `Pipeline ${definition.id} requires finalizer output from step(s) not included in its steps list: ${missingFinalizerSteps.map(({ id }) => id).join(", ")}`));
+    }
+    if (requiredFinalizerSteps &&
+        missingTargets.length === 0 &&
+        missingReferences.length === 0 &&
+        missingFinalizerSteps.length === 0) {
+        for (const target of declaredTargets) {
+            const selected = targetClosure([target]);
+            const missingRequiredSteps = requiredFinalizerSteps.filter((step) => !selected.has(step));
+            if (missingRequiredSteps.length > 0) {
+                errors.push(pipelineDiagnostic("TUBELESS_DEFINITION_TARGET_FINALIZER_MISMATCH", "definition", "definition", `Pipeline ${definition.id} target ${target.id} cannot satisfy required finalizer output(s): ${missingRequiredSteps.map(({ id }) => id).join(", ")}`, { stepId: target.id }));
+            }
+        }
+    }
+    // SAFETY: `steps` is `TSteps extends readonly AnyStep[]`; the cast restores the
+    // `TOptions` generic that the tuple erased, without changing the values.
+    if (errors.length === 0 && !topologicalSort(steps)) {
+        errors.push(pipelineDiagnostic("TUBELESS_DEFINITION_DEPENDENCY_CYCLE", "definition", "definition", `Pipeline ${definition.id} has a dependency cycle`));
+    }
+    return errors;
+}
+//# sourceMappingURL=pipeline-definition-validation.js.map

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

@@ -0,0 +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  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: targets are a subset of `TSteps[number]`, each an `AnyStep<TOptions>`.\n  const declaredTargets = (definition.targets ?? []) 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  // SAFETY: `steps` is `TSteps extends readonly AnyStep[]`; the cast restores the\n  // `TOptions` generic that the tuple erased, without changing the values.\n  if (errors.length === 0 && !topologicalSort(steps as readonly AnyStep<TOptions>[])) {\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"]}

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

@@ -0,0 +1,28 @@
+import type { AnyStep, Step, StepOutput } from "./pipeline-steps.js";
+import type { InferSchemaInput, PipelineExecutionContext, StandardSchemaV1 } from "./pipeline-types.js";
+/**
+ * Recovers the options type from the steps themselves rather than taking it as its own
+ * generic parameter. A `TOptions` parameter constrained by `TSteps extends
+ * readonly AnyStep<TOptions>[]` is self-referential — TypeScript can't solve that at a
+ * `definePipeline(...)` call site and silently widens `TOptions` to its bare
+ * `object` constraint (context.options would lose every pipeline-specific
+ * field). Structuring it as "derive TOptions from TSteps" instead of "constrain TSteps by
+ * TOptions" avoids the cycle, so callers never write out any of these type parameters.
+ */
+export type StepsOptions<TSteps extends readonly AnyStep[]> = TSteps[number] extends AnyStep<infer TOptions> ? TOptions : object;
+export type StepsInputOptions<TSteps extends readonly AnyStep[]> = TSteps[number] extends Step<string, unknown, object, infer TInputOptions, infer _TRunOut> ? TInputOptions : StepsOptions<TSteps>;
+export type StepIds<TSteps extends readonly AnyStep[]> = TSteps[number]["id"];
+export type TargetIds<TTargets extends readonly AnyStep[]> = TTargets[number]["id"];
+type PipelineOutputs<TSteps extends readonly AnyStep[]> = {
+    [S in TSteps[number] as S["id"]]: StepOutput<S>;
+};
+export interface PipelineDefinition<TSteps extends readonly AnyStep[], TResult, TTargets extends readonly TSteps[number][] = readonly [], TResultSchema extends StandardSchemaV1 | undefined = undefined> {
+    id: string;
+    steps: TSteps;
+    /** Public downstream goals that callers may select with `targets`. */
+    targets?: TTargets;
+    /** Optional Standard Schema for the finalized result. */
+    resultSchema?: TResultSchema;
+    finalize(outputs: Partial<PipelineOutputs<TSteps>>, context: PipelineExecutionContext<StepsOptions<TSteps>>): (TResultSchema extends StandardSchemaV1 ? InferSchemaInput<TResultSchema> : TResult) | Promise<TResultSchema extends StandardSchemaV1 ? InferSchemaInput<TResultSchema> : TResult>;
+}
+export {};

package/dist/core/pipeline-definition.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pipeline-definition.js.map

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

@@ -0,0 +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\nexport type StepIds<TSteps extends readonly AnyStep[]> = TSteps[number][\"id\"];\n\nexport type TargetIds<TTargets extends readonly AnyStep[]> = TTargets[number][\"id\"];\n\ntype PipelineOutputs<TSteps extends readonly AnyStep[]> = {\n  [S in TSteps[number] as S[\"id\"]]: StepOutput<S>;\n};\n\nexport interface PipelineDefinition<\n  TSteps extends readonly AnyStep[],\n  TResult,\n  TTargets extends readonly TSteps[number][] = readonly [],\n  TResultSchema extends StandardSchemaV1 | undefined = undefined,\n> {\n  id: string;\n  steps: TSteps;\n  /** Public downstream goals that callers may select with `targets`. */\n  targets?: TTargets;\n  /** Optional Standard Schema for the finalized result. */\n  resultSchema?: TResultSchema;\n  finalize(\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}\n"]}

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

@@ -0,0 +1,26 @@
+import type { CompiledStepGraph } from "./pipeline-graph.js";
+import type { AnyStep } from "./pipeline-steps.js";
+import type { PipelinePlanStep, PipelineStepReport, PipelineStepSkipReason } from "./pipeline-types.js";
+type StepDispositionInput<TOptions extends object> = {
+    dryRun: boolean;
+    graph: CompiledStepGraph<TOptions>;
+    planned: PipelinePlanStep;
+    reportsByStepId: ReadonlyMap<string, PipelineStepReport>;
+    step: AnyStep<TOptions>;
+};
+type StepDisposition = {
+    kind: "run";
+} | {
+    kind: "skip";
+    reason: PipelineStepSkipReason;
+    dependencyId?: string;
+    message?: string;
+};
+/**
+ * Single skip ladder for plan and live execution.
+ * Policy skips stay outside: they run only after a step is scheduled.
+ * Remainder copies plan `skipReason` for structural skips and marks planned-run
+ * steps fail-fast or cancelled, so this ladder has no abort/fail-fast mode.
+ */
+export declare function decideStepDisposition<TOptions extends object>(input: StepDispositionInput<TOptions>): StepDisposition;
+export {};

package/dist/core/pipeline-disposition.js

@@ -0,0 +1,44 @@
+/** Required dependencies are met when completed, or intentionally policy-skipped. */
+function isRequiredDependencyMet(report) {
+    if (!report)
+        return false;
+    if (report.status === "completed")
+        return true;
+    return report.status === "skipped" && report.reason === "policy";
+}
+/**
+ * Single skip ladder for plan and live execution.
+ * Policy skips stay outside: they run only after a step is scheduled.
+ * Remainder copies plan `skipReason` for structural skips and marks planned-run
+ * steps fail-fast or cancelled, so this ladder has no abort/fail-fast mode.
+ */
+export function decideStepDisposition(input) {
+    const { dryRun, graph, planned, reportsByStepId, step } = input;
+    if (!planned.selected) {
+        return { kind: "skip", reason: "filtered" };
+    }
+    const unsuccessfulAncestor = graph.skipAfterFailureOf.find((dep) => {
+        const status = reportsByStepId.get(dep.id)?.status;
+        return status === "failed" || status === "cancelled";
+    });
+    if (unsuccessfulAncestor) {
+        return {
+            kind: "skip",
+            reason: "failed-dependency",
+            dependencyId: unsuccessfulAncestor.id,
+        };
+    }
+    const unmetDependency = graph.dependsOn.find((dep) => !isRequiredDependencyMet(reportsByStepId.get(dep.id)));
+    if (unmetDependency) {
+        return {
+            kind: "skip",
+            reason: "unmet-dependency",
+            dependencyId: unmetDependency.id,
+        };
+    }
+    if (dryRun && step.dryRun === "skip") {
+        return { kind: "skip", reason: "dry-run" };
+    }
+    return { kind: "run" };
+}
+//# sourceMappingURL=pipeline-disposition.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-disposition.js","sourceRoot":"","sources":["../../src/core/pipeline-disposition.ts"],"names":[],"mappings":"AAQA,qFAAqF;AACrF,SAAS,uBAAuB,CAAC,MAAsC;IACrE,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC/C,OAAO,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC;AACnE,CAAC;AAmBD;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAqC;IAErC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAEhE,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,oBAAoB,GAAG,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;QACjE,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QACnD,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,WAAW,CAAC;IACvD,CAAC,CAAC,CAAC;IACH,IAAI,oBAAoB,EAAE,CAAC;QACzB,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,mBAAmB;YAC3B,YAAY,EAAE,oBAAoB,CAAC,EAAE;SACtC,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAC1C,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,uBAAuB,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAC/D,CAAC;IACF,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,kBAAkB;YAC1B,YAAY,EAAE,eAAe,CAAC,EAAE;SACjC,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QACrC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC7C,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC","sourcesContent":["import type { CompiledStepGraph } from \"./pipeline-graph.js\";\nimport type { AnyStep } from \"./pipeline-steps.js\";\nimport type {\n  PipelinePlanStep,\n  PipelineStepReport,\n  PipelineStepSkipReason,\n} from \"./pipeline-types.js\";\n\n/** Required dependencies are met when completed, or intentionally policy-skipped. */\nfunction isRequiredDependencyMet(report: PipelineStepReport | undefined): boolean {\n  if (!report) return false;\n  if (report.status === \"completed\") return true;\n  return report.status === \"skipped\" && report.reason === \"policy\";\n}\n\ntype StepDispositionInput<TOptions extends object> = {\n  dryRun: boolean;\n  graph: CompiledStepGraph<TOptions>;\n  planned: PipelinePlanStep;\n  reportsByStepId: ReadonlyMap<string, PipelineStepReport>;\n  step: AnyStep<TOptions>;\n};\n\ntype StepDisposition =\n  | { kind: \"run\" }\n  | {\n      kind: \"skip\";\n      reason: PipelineStepSkipReason;\n      dependencyId?: string;\n      message?: string;\n    };\n\n/**\n * Single skip ladder for plan and live execution.\n * Policy skips stay outside: they run only after a step is scheduled.\n * Remainder copies plan `skipReason` for structural skips and marks planned-run\n * steps fail-fast or cancelled, so this ladder has no abort/fail-fast mode.\n */\nexport function decideStepDisposition<TOptions extends object>(\n  input: StepDispositionInput<TOptions>\n): StepDisposition {\n  const { dryRun, graph, planned, reportsByStepId, step } = input;\n\n  if (!planned.selected) {\n    return { kind: \"skip\", reason: \"filtered\" };\n  }\n\n  const unsuccessfulAncestor = graph.skipAfterFailureOf.find((dep) => {\n    const status = reportsByStepId.get(dep.id)?.status;\n    return status === \"failed\" || status === \"cancelled\";\n  });\n  if (unsuccessfulAncestor) {\n    return {\n      kind: \"skip\",\n      reason: \"failed-dependency\",\n      dependencyId: unsuccessfulAncestor.id,\n    };\n  }\n\n  const unmetDependency = graph.dependsOn.find(\n    (dep) => !isRequiredDependencyMet(reportsByStepId.get(dep.id))\n  );\n  if (unmetDependency) {\n    return {\n      kind: \"skip\",\n      reason: \"unmet-dependency\",\n      dependencyId: unmetDependency.id,\n    };\n  }\n\n  if (dryRun && step.dryRun === \"skip\") {\n    return { kind: \"skip\", reason: \"dry-run\" };\n  }\n\n  return { kind: \"run\" };\n}\n"]}

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

@@ -0,0 +1,8 @@
+import type { PipelineError, PipelineErrorCode, PipelineErrorKind, PipelineErrorPhase } from "./pipeline-types.js";
+export declare function pipelineDiagnostic(code: PipelineErrorCode, phase: PipelineErrorPhase, kind: PipelineErrorKind, message: string, fields?: Pick<PipelineError, "stepId">): PipelineError;
+/** Programmer error raised immediately when a pipeline graph is invalid. */
+export declare class PipelineDefinitionError extends Error {
+    readonly pipelineId: string;
+    readonly errors: readonly PipelineError[];
+    constructor(pipelineId: string, errors: readonly PipelineError[]);
+}

package/dist/core/pipeline-errors.js

@@ -0,0 +1,20 @@
+import { brandTubelessError } from "../utilities/tubeless-error.js";
+import { formatPipelineError } from "./pipeline-diagnostics.js";
+export function pipelineDiagnostic(code, phase, kind, message, fields = {}) {
+    return { code, kind, message, phase, ...fields };
+}
+/** Programmer error raised immediately when a pipeline graph is invalid. */
+export class PipelineDefinitionError extends Error {
+    pipelineId;
+    errors;
+    constructor(pipelineId, errors) {
+        super(errors.length > 0
+            ? `Invalid pipeline ${pipelineId}: ${errors.map((error) => formatPipelineError(error)).join("; ")}`
+            : `Invalid pipeline ${pipelineId}`);
+        this.pipelineId = pipelineId;
+        this.errors = errors;
+        this.name = "PipelineDefinitionError";
+        brandTubelessError(this, "pipeline-definition");
+    }
+}
+//# sourceMappingURL=pipeline-errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-errors.js","sourceRoot":"","sources":["../../src/core/pipeline-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAQhE,MAAM,UAAU,kBAAkB,CAChC,IAAuB,EACvB,KAAyB,EACzB,IAAuB,EACvB,OAAe,EACf,MAAM,GAAkC,EAAE;IAE1C,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,CAAC;AACnD,CAAC;AAED,4EAA4E;AAC5E,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAErC,UAAU;IACV,MAAM;IAFjB,YACW,UAAkB,EAClB,MAAgC;QAEzC,KAAK,CACH,MAAM,CAAC,MAAM,GAAG,CAAC;YACf,CAAC,CAAC,oBAAoB,UAAU,KAAK,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACnG,CAAC,CAAC,oBAAoB,UAAU,EAAE,CACrC,CAAC;0BAPO,UAAU;sBACV,MAAM;QAOf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,kBAAkB,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IAClD,CAAC;CACF","sourcesContent":["import { brandTubelessError } from \"../utilities/tubeless-error.js\";\nimport { formatPipelineError } from \"./pipeline-diagnostics.js\";\nimport type {\n  PipelineError,\n  PipelineErrorCode,\n  PipelineErrorKind,\n  PipelineErrorPhase,\n} from \"./pipeline-types.js\";\n\nexport function pipelineDiagnostic(\n  code: PipelineErrorCode,\n  phase: PipelineErrorPhase,\n  kind: PipelineErrorKind,\n  message: string,\n  fields: Pick<PipelineError, \"stepId\"> = {}\n): PipelineError {\n  return { code, kind, message, phase, ...fields };\n}\n\n/** Programmer error raised immediately when a pipeline graph is invalid. */\nexport class PipelineDefinitionError extends Error {\n  constructor(\n    readonly pipelineId: string,\n    readonly errors: readonly PipelineError[]\n  ) {\n    super(\n      errors.length > 0\n        ? `Invalid pipeline ${pipelineId}: ${errors.map((error) => formatPipelineError(error)).join(\"; \")}`\n        : `Invalid pipeline ${pipelineId}`\n    );\n    this.name = \"PipelineDefinitionError\";\n    brandTubelessError(this, \"pipeline-definition\");\n  }\n}\n"]}

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

@@ -1,4 +1,4 @@
-import { type CompiledPipeline } from "./pipeline-plan.js";
+import type { CompiledPipeline } from "./pipeline-compiler.js";
 import type { AnyStep } from "./pipeline-steps.js";
 import type { InferSchemaOutput, PipelineContext, PipelinePlan, PipelineRun, PipelineRunControls, PipelineRuntime, StandardSchemaV1 } from "./pipeline-types.js";
 /** Observe an execution ID from an internal host without allowing it to be overridden. */

package/dist/core/pipeline-execute.js

@@ -4,8 +4,11 @@ import { brandTubelessError } from "../utilities/tubeless-error.js";
 import { createPipelineLifecycleObserver } from "./lifecycle.js";
 import { formatPipelineError } from "./pipeline-diagnostics.js";
 import { createRunId } from "./pipeline-ids.js";
-import { PIPELINE_FINALIZE_STEP_ID, compiledStepGraph, decideStepDisposition, planStepById, stepToPlanStep, } from "./pipeline-plan.js";
+import { decideStepDisposition } from "./pipeline-disposition.js";
+import { compiledStepGraph } from "./pipeline-graph.js";
+import { planStepById, stepToPlanStep } from "./pipeline-plan.js";
 import { PipelineRunState, isCancellationOnly, } from "./pipeline-run-state.js";
+import { PIPELINE_FINALIZE_STEP_ID } from "./pipeline-step-metadata.js";
 import { evaluateStepSkip, executeStepAttempt, validateStepOutput, } from "./pipeline-step-executor.js";
 import { PipelineBoundaryValidationError, validateStandardSchema } from "./pipeline-validation.js";
 import { createPipelineTraceEmitter } from "../tracing/tracing-internal.js";
@@ -178,7 +181,7 @@ export async function executePlannedRun(input) {
     catch {
         // Ignore observation failures; execution identity remains package-owned.
     }
-    const correlationId = runtime.correlationId ?? runtime.runId;
+    const correlationId = runtime.correlationId;
     const identity = { runId };
     if (correlationId !== undefined)
         identity.correlationId = correlationId;

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 {\n  abortableSleep,\n  isAbortError,\n  throwIfAborted as throwIfSignalAborted,\n} from \"../utilities/abort.js\";\nimport { PipelineChildError } from \"./child-execution.js\";\nimport { brandTubelessError } from \"../utilities/tubeless-error.js\";\nimport { createPipelineLifecycleObserver } from \"./lifecycle.js\";\nimport { formatPipelineError } from \"./pipeline-diagnostics.js\";\nimport { createRunId } from \"./pipeline-ids.js\";\nimport {\n  PIPELINE_FINALIZE_STEP_ID,\n  compiledStepGraph,\n  decideStepDisposition,\n  planStepById,\n  stepToPlanStep,\n  type CompiledPipeline,\n} from \"./pipeline-plan.js\";\nimport type { StepsOptions } from \"./pipeline-plan.js\";\nimport {\n  PipelineRunState,\n  isCancellationOnly,\n  type PipelineStepAttempt,\n} from \"./pipeline-run-state.js\";\nimport type { AnyStep } from \"./pipeline-steps.js\";\nimport {\n  evaluateStepSkip,\n  executeStepAttempt,\n  validateStepOutput,\n} from \"./pipeline-step-executor.js\";\nimport type {\n  InferSchemaOutput,\n  PipelineContext,\n  PipelineError,\n  PipelineErrorCause,\n  PipelineExecutionContext,\n  PipelineLogger,\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 { createPipelineTraceEmitter } from \"../tracing/tracing-internal.js\";\n\nconst PIPELINE_RUN_ID_OBSERVER = Symbol.for(\"tubeless.pipeline.runIdObserver\");\n\ninterface ObservedPipelineRuntime {\n  [PIPELINE_RUN_ID_OBSERVER]?: (runId: string) => void;\n}\n\n/** Observe an execution ID from an internal host without allowing it to be overridden. */\nexport function observePipelineRunId<TContext extends object>(\n  context: TContext,\n  observer: (runId: string) => void\n): TContext {\n  // SAFETY: the internal observer is intentionally hidden from the returned\n  // public type and can observe, but never choose, the generated run ID.\n  return { ...context, [PIPELINE_RUN_ID_OBSERVER]: observer };\n}\n\nconst PIPELINE_LOGGER_BASE = Symbol(\"pipelineLoggerBase\");\n\ntype TracedPipelineLogger = PipelineLogger & { [PIPELINE_LOGGER_BASE]?: PipelineLogger };\n\nfunction basePipelineLogger(log: PipelineLogger): PipelineLogger {\n  // SAFETY: `TracedPipelineLogger` only adds the optional symbol-keyed base\n  // property; reading it off any `PipelineLogger` is safe because the property\n  // is absent unless a tracing wrapper installed it.\n  return (log as TracedPipelineLogger)[PIPELINE_LOGGER_BASE] ?? log;\n}\n\nconst originalPipelineErrors = new WeakMap<PipelineError, unknown>();\n\nfunction defaultExecutionErrorMessage(result: PipelineRun<unknown>): string {\n  const firstError = result.errors[0];\n  const disposition = isCancellationOnly(result.errors) ? \"cancelled\" : \"failed\";\n  return firstError\n    ? `Pipeline ${result.pipelineId} ${disposition}: ${formatPipelineError(firstError)}`\n    : `Pipeline ${result.pipelineId} ${disposition}`;\n}\n\nfunction firstOriginalPipelineError(errors: readonly PipelineError[]): unknown {\n  for (const error of errors) {\n    if (originalPipelineErrors.has(error)) return originalPipelineErrors.get(error);\n  }\n  return undefined;\n}\n\nexport class PipelineExecutionError extends Error {\n  constructor(\n    readonly result: PipelineRun<unknown>,\n    message = defaultExecutionErrorMessage(result)\n  ) {\n    const cause = firstOriginalPipelineError(result.errors);\n    super(message, cause === undefined ? undefined : { cause });\n    this.name = \"PipelineExecutionError\";\n    brandTubelessError(this, \"pipeline-execution\");\n  }\n}\n\nconst MAX_PIPELINE_CAUSE_DEPTH = 8;\n\nfunction readErrorField(value: object, field: \"cause\" | \"code\" | \"message\" | \"name\"): unknown {\n  try {\n    // SAFETY: any object may be probed for an optional string-keyed field; a\n    // getter that throws is caught below, so the cast only enables the lookup.\n    return (value as Record<string, unknown>)[field];\n  } catch {\n    return undefined;\n  }\n}\n\nfunction safeErrorMessage(value: unknown): string {\n  try {\n    return String(value);\n  } catch {\n    return \"Unknown thrown value\";\n  }\n}\n\nfunction normalizePipelineCause(\n  value: unknown,\n  seen: WeakSet<object>,\n  depth = 0\n): PipelineErrorCause {\n  if (depth >= MAX_PIPELINE_CAUSE_DEPTH) {\n    return { message: \"Cause chain truncated\" };\n  }\n  if (typeof value !== \"object\" || value === null) {\n    return { message: safeErrorMessage(value) };\n  }\n  if (seen.has(value)) {\n    return { message: \"Circular cause\" };\n  }\n  seen.add(value);\n\n  const message = readErrorField(value, \"message\");\n  const name = readErrorField(value, \"name\");\n  const sourceCode = readErrorField(value, \"code\");\n  const nested = readErrorField(value, \"cause\");\n  const cause: PipelineErrorCause = {\n    message: typeof message === \"string\" ? message : safeErrorMessage(value),\n  };\n  if (typeof name === \"string\") cause.name = name;\n  if (typeof sourceCode === \"string\") cause.sourceCode = sourceCode;\n  if (nested !== undefined) cause.cause = normalizePipelineCause(nested, seen, depth + 1);\n  return cause;\n}\n\n// Fan-out snapshots bound every string as well as cause depth and item count.\nfunction fanOutCause(error: unknown): PipelineErrorCause {\n  const cause = normalizePipelineCause(error, new WeakSet<object>());\n  let current: PipelineErrorCause | undefined = cause;\n  while (current) {\n    current.message = current.message.slice(0, 1024);\n    if (current.name) current.name = current.name.slice(0, 1024);\n    if (current.sourceCode) current.sourceCode = current.sourceCode.slice(0, 1024);\n    current = current.cause;\n  }\n  return cause;\n}\n\nfunction normalizedNestedCause(error: unknown): PipelineErrorCause | undefined {\n  if (typeof error !== \"object\" || error === null) return undefined;\n  const cause = readErrorField(error, \"cause\");\n  if (cause === undefined) return undefined;\n  const seen = new WeakSet<object>();\n  seen.add(error);\n  return normalizePipelineCause(cause, seen);\n}\n\nfunction toPipelineError(\n  error: unknown,\n  classification: Omit<PipelineError, \"cause\" | \"message\" | \"sourceCode\" | \"stack\">\n): PipelineError {\n  const sourceCode =\n    typeof error === \"object\" && error !== null ? readErrorField(error, \"code\") : undefined;\n  const cause = normalizedNestedCause(error);\n  const pipelineError: PipelineError = {\n    ...classification,\n    message: error instanceof Error ? error.message : safeErrorMessage(error),\n  };\n  if (error instanceof Error && error.stack) pipelineError.stack = error.stack;\n  if (typeof sourceCode === \"string\") pipelineError.sourceCode = sourceCode;\n  if (cause) pipelineError.cause = cause;\n  if (error instanceof PipelineBoundaryValidationError) pipelineError.issues = error.issues;\n  if (error instanceof PipelineChildError && error.fanOut) {\n    const { failures, failureCount, schedulerError } = error.fanOut;\n    pipelineError.fanOut = {\n      failures: failures.map(({ error: itemError, key, index, cancelled }) => ({\n        index,\n        key: key.slice(0, 1024),\n        keyTruncated: key.length > 1024,\n        cancelled,\n        error: fanOutCause(itemError),\n      })),\n      failureCount,\n      omittedFailureCount: failureCount - failures.length,\n    };\n    if (schedulerError !== undefined)\n      pipelineError.fanOut.schedulerError = fanOutCause(schedulerError);\n  }\n  originalPipelineErrors.set(pipelineError, error);\n  return pipelineError;\n}\n\nexport function isPipelineCancellation(error: unknown, runtime: PipelineRuntime): boolean {\n  if (isAbortError(error)) return true;\n  if (runtime.signal?.aborted === true && error === runtime.signal.reason) return true;\n  if (error instanceof PipelineChildError) return error.cancelled;\n  return error instanceof PipelineExecutionError && isCancelledResult(error.result);\n}\n\nfunction isCancelledResult(result: PipelineRun<unknown>): boolean {\n  return result.status === \"cancelled\";\n}\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}): 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  try {\n    // SAFETY: only internal hosts attach this observation callback. A callback\n    // failure must not change whether the pipeline execution itself can start.\n    (runtime as PipelineRuntime & ObservedPipelineRuntime)[PIPELINE_RUN_ID_OBSERVER]?.(runId);\n  } catch {\n    // Ignore observation failures; execution identity remains package-owned.\n  }\n  const correlationId = runtime.correlationId ?? runtime.runId;\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 trace = createPipelineTraceEmitter(\n    compiled.id,\n    runtime.tracing,\n    basePipelineLogger(runtime.log),\n    { ...identity, itemKey: runtime.tracing?.itemKey },\n    runtime.now\n  );\n  const lifecycle = createPipelineLifecycleObserver(compiled.id, runtime, trace);\n  const tracedLogger = (stepId?: string, attemptId?: string): PipelineLogger => {\n    if (!trace) return runtime.log;\n    const base = basePipelineLogger(runtime.log);\n    const log: TracedPipelineLogger = {\n      error: (message, ...params) => {\n        lifecycle.log(\"error\", message, params, stepId, attemptId);\n        base.error(message, ...params);\n      },\n      log: (message, ...params) => {\n        lifecycle.log(\"log\", message, params, stepId, attemptId);\n        base.log(message, ...params);\n      },\n      warn: (message, ...params) => {\n        lifecycle.log(\"warn\", message, params, stepId, attemptId);\n        base.warn(message, ...params);\n      },\n    };\n    log[PIPELINE_LOGGER_BASE] = base;\n    return log;\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  // 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: tracedLogger(),\n    options: pipelineOptions,\n    runId,\n    trace: trace?.context,\n  };\n  if (correlationId !== undefined) executionContext.correlationId = correlationId;\n  if (runtime.parentRunId) executionContext.parentRunId = runtime.parentRunId;\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  const recordRemainingStates = (\n    fromIndex: number,\n    failedStepId?: string,\n    cancellationError?: PipelineError\n  ): void => {\n    for (let index = fromIndex; index < orderedSteps.length; index++) {\n      const step = orderedSteps[index]!;\n      const plannedStep = plannedStepFor(step);\n      if (plannedStep.skipReason) {\n        const dependencyId =\n          plannedStep.skipReason === \"unmet-dependency\"\n            ? plannedStep.dependencies.find((id) => plannedSteps.get(id)?.skipReason !== undefined)\n            : undefined;\n        state.skipStep(plannedStep, {\n          reason: plannedStep.skipReason,\n          dependencyId,\n        });\n      } else if (cancellationError) {\n        state.cancelStep(plannedStep, { ...cancellationError, stepId: step.id }, false);\n      } else {\n        state.skipStep(plannedStep, {\n          reason: \"fail-fast\",\n          message: failedStepId\n            ? `Not run because fail-fast stopped after ${failedStepId} failed.`\n            : \"Not run because the pipeline was aborted before this step started.\",\n          dependencyId: failedStepId,\n        });\n      }\n    }\n  };\n\n  const cancelBeforeStepStart = (stepId: string, stepIndex: number): boolean => {\n    try {\n      throwIfAborted(runtime);\n      return false;\n    } catch (error) {\n      const pipelineError = toPipelineError(error, {\n        code: \"TUBELESS_RUN_CANCELLED\",\n        kind: \"cancellation\",\n        phase: \"execution\",\n        stepId,\n      });\n      state.recordRunErrors([pipelineError]);\n      recordRemainingStates(stepIndex, undefined, pipelineError);\n      return true;\n    }\n  };\n\n  const recordStepExecutionFailure = (\n    error: unknown,\n    plannedStep: PipelinePlanStep,\n    stepIndex: number,\n    attempt: PipelineStepAttempt\n  ): boolean => {\n    const cancelled = isPipelineCancellation(error, runtime);\n    const childFailure =\n      error instanceof PipelineExecutionError || error instanceof PipelineChildError;\n    const validationFailure = error instanceof PipelineBoundaryValidationError;\n    const pipelineError = toPipelineError(error, {\n      code: cancelled\n        ? \"TUBELESS_RUN_CANCELLED\"\n        : validationFailure\n          ? \"TUBELESS_STEP_OUTPUT_VALIDATION_FAILED\"\n          : childFailure\n            ? \"TUBELESS_CHILD_FAILED\"\n            : \"TUBELESS_STEP_FAILED\",\n      kind: cancelled\n        ? \"cancellation\"\n        : validationFailure\n          ? \"validation\"\n          : childFailure\n            ? \"child\"\n            : \"step\",\n      phase: \"execution\",\n      stepId: plannedStep.id,\n    });\n    state.failStep(plannedStep, attempt, pipelineError);\n    if (controls.continueOnError) return false;\n    recordRemainingStates(stepIndex + 1, plannedStep.id, cancelled ? pipelineError : undefined);\n    return true;\n  };\n\n  const recordPolicySkip = async (\n    plannedStep: PipelinePlanStep,\n    step: AnyStep<TOptions>,\n    stepIndex: number,\n    reason: string,\n    value: unknown\n  ): Promise<boolean> => {\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, stepIndex, attempt);\n      }\n    }\n    state.skipStep(plannedStep, {\n      attempt,\n      message: reason,\n      output: { value: published },\n      reason: \"policy\",\n    });\n    return false;\n  };\n\n  for (const [stepIndex, step] of orderedSteps.entries()) {\n    const plannedStep = plannedStepFor(step);\n    if (cancelBeforeStepStart(step.id, stepIndex)) break;\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      continue;\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: tracedLogger(step.id),\n        });\n      } catch (error) {\n        const attempt = state.beginAttempt(plannedStep);\n        if (recordStepExecutionFailure(error, plannedStep, stepIndex, attempt)) break;\n        continue;\n      }\n      if (cancelBeforeStepStart(step.id, stepIndex)) break;\n      if (skipDecision) {\n        if (\n          await recordPolicySkip(\n            plannedStep,\n            step,\n            stepIndex,\n            skipDecision.reason,\n            skipDecision.value\n          )\n        ) {\n          break;\n        }\n        continue;\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: tracedLogger(step.id, attempt.attemptId),\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      if (recordStepExecutionFailure(error, plannedStep, stepIndex, attempt)) break;\n    }\n  }\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: tracedLogger(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 cancelled = isPipelineCancellation(error, runtime);\n      const validationFailure = error instanceof PipelineBoundaryValidationError;\n      const pipelineError = toPipelineError(error, {\n        code: cancelled\n          ? \"TUBELESS_FINALIZATION_CANCELLED\"\n          : validationFailure\n            ? \"TUBELESS_FINAL_RESULT_VALIDATION_FAILED\"\n            : \"TUBELESS_FINALIZATION_FAILED\",\n        kind: cancelled ? \"cancellation\" : validationFailure ? \"validation\" : \"finalization\",\n        phase: \"finalization\",\n        stepId: PIPELINE_FINALIZE_STEP_ID,\n      });\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 {\n  abortableSleep,\n  isAbortError,\n  throwIfAborted as throwIfSignalAborted,\n} from \"../utilities/abort.js\";\nimport { PipelineChildError } from \"./child-execution.js\";\nimport { brandTubelessError } from \"../utilities/tubeless-error.js\";\nimport { createPipelineLifecycleObserver } from \"./lifecycle.js\";\nimport { formatPipelineError } from \"./pipeline-diagnostics.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 { compiledStepGraph } from \"./pipeline-graph.js\";\nimport { planStepById, stepToPlanStep } from \"./pipeline-plan.js\";\nimport {\n  PipelineRunState,\n  isCancellationOnly,\n  type PipelineStepAttempt,\n} 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  PipelineErrorCause,\n  PipelineExecutionContext,\n  PipelineLogger,\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 { createPipelineTraceEmitter } from \"../tracing/tracing-internal.js\";\n\nconst PIPELINE_RUN_ID_OBSERVER = Symbol.for(\"tubeless.pipeline.runIdObserver\");\n\ninterface ObservedPipelineRuntime {\n  [PIPELINE_RUN_ID_OBSERVER]?: (runId: string) => void;\n}\n\n/** Observe an execution ID from an internal host without allowing it to be overridden. */\nexport function observePipelineRunId<TContext extends object>(\n  context: TContext,\n  observer: (runId: string) => void\n): TContext {\n  // SAFETY: the internal observer is intentionally hidden from the returned\n  // public type and can observe, but never choose, the generated run ID.\n  return { ...context, [PIPELINE_RUN_ID_OBSERVER]: observer };\n}\n\nconst PIPELINE_LOGGER_BASE = Symbol(\"pipelineLoggerBase\");\n\ntype TracedPipelineLogger = PipelineLogger & { [PIPELINE_LOGGER_BASE]?: PipelineLogger };\n\nfunction basePipelineLogger(log: PipelineLogger): PipelineLogger {\n  // SAFETY: `TracedPipelineLogger` only adds the optional symbol-keyed base\n  // property; reading it off any `PipelineLogger` is safe because the property\n  // is absent unless a tracing wrapper installed it.\n  return (log as TracedPipelineLogger)[PIPELINE_LOGGER_BASE] ?? log;\n}\n\nconst originalPipelineErrors = new WeakMap<PipelineError, unknown>();\n\nfunction defaultExecutionErrorMessage(result: PipelineRun<unknown>): string {\n  const firstError = result.errors[0];\n  const disposition = isCancellationOnly(result.errors) ? \"cancelled\" : \"failed\";\n  return firstError\n    ? `Pipeline ${result.pipelineId} ${disposition}: ${formatPipelineError(firstError)}`\n    : `Pipeline ${result.pipelineId} ${disposition}`;\n}\n\nfunction firstOriginalPipelineError(errors: readonly PipelineError[]): unknown {\n  for (const error of errors) {\n    if (originalPipelineErrors.has(error)) return originalPipelineErrors.get(error);\n  }\n  return undefined;\n}\n\nexport class PipelineExecutionError extends Error {\n  constructor(\n    readonly result: PipelineRun<unknown>,\n    message = defaultExecutionErrorMessage(result)\n  ) {\n    const cause = firstOriginalPipelineError(result.errors);\n    super(message, cause === undefined ? undefined : { cause });\n    this.name = \"PipelineExecutionError\";\n    brandTubelessError(this, \"pipeline-execution\");\n  }\n}\n\nconst MAX_PIPELINE_CAUSE_DEPTH = 8;\n\nfunction readErrorField(value: object, field: \"cause\" | \"code\" | \"message\" | \"name\"): unknown {\n  try {\n    // SAFETY: any object may be probed for an optional string-keyed field; a\n    // getter that throws is caught below, so the cast only enables the lookup.\n    return (value as Record<string, unknown>)[field];\n  } catch {\n    return undefined;\n  }\n}\n\nfunction safeErrorMessage(value: unknown): string {\n  try {\n    return String(value);\n  } catch {\n    return \"Unknown thrown value\";\n  }\n}\n\nfunction normalizePipelineCause(\n  value: unknown,\n  seen: WeakSet<object>,\n  depth = 0\n): PipelineErrorCause {\n  if (depth >= MAX_PIPELINE_CAUSE_DEPTH) {\n    return { message: \"Cause chain truncated\" };\n  }\n  if (typeof value !== \"object\" || value === null) {\n    return { message: safeErrorMessage(value) };\n  }\n  if (seen.has(value)) {\n    return { message: \"Circular cause\" };\n  }\n  seen.add(value);\n\n  const message = readErrorField(value, \"message\");\n  const name = readErrorField(value, \"name\");\n  const sourceCode = readErrorField(value, \"code\");\n  const nested = readErrorField(value, \"cause\");\n  const cause: PipelineErrorCause = {\n    message: typeof message === \"string\" ? message : safeErrorMessage(value),\n  };\n  if (typeof name === \"string\") cause.name = name;\n  if (typeof sourceCode === \"string\") cause.sourceCode = sourceCode;\n  if (nested !== undefined) cause.cause = normalizePipelineCause(nested, seen, depth + 1);\n  return cause;\n}\n\n// Fan-out snapshots bound every string as well as cause depth and item count.\nfunction fanOutCause(error: unknown): PipelineErrorCause {\n  const cause = normalizePipelineCause(error, new WeakSet<object>());\n  let current: PipelineErrorCause | undefined = cause;\n  while (current) {\n    current.message = current.message.slice(0, 1024);\n    if (current.name) current.name = current.name.slice(0, 1024);\n    if (current.sourceCode) current.sourceCode = current.sourceCode.slice(0, 1024);\n    current = current.cause;\n  }\n  return cause;\n}\n\nfunction normalizedNestedCause(error: unknown): PipelineErrorCause | undefined {\n  if (typeof error !== \"object\" || error === null) return undefined;\n  const cause = readErrorField(error, \"cause\");\n  if (cause === undefined) return undefined;\n  const seen = new WeakSet<object>();\n  seen.add(error);\n  return normalizePipelineCause(cause, seen);\n}\n\nfunction toPipelineError(\n  error: unknown,\n  classification: Omit<PipelineError, \"cause\" | \"message\" | \"sourceCode\" | \"stack\">\n): PipelineError {\n  const sourceCode =\n    typeof error === \"object\" && error !== null ? readErrorField(error, \"code\") : undefined;\n  const cause = normalizedNestedCause(error);\n  const pipelineError: PipelineError = {\n    ...classification,\n    message: error instanceof Error ? error.message : safeErrorMessage(error),\n  };\n  if (error instanceof Error && error.stack) pipelineError.stack = error.stack;\n  if (typeof sourceCode === \"string\") pipelineError.sourceCode = sourceCode;\n  if (cause) pipelineError.cause = cause;\n  if (error instanceof PipelineBoundaryValidationError) pipelineError.issues = error.issues;\n  if (error instanceof PipelineChildError && error.fanOut) {\n    const { failures, failureCount, schedulerError } = error.fanOut;\n    pipelineError.fanOut = {\n      failures: failures.map(({ error: itemError, key, index, cancelled }) => ({\n        index,\n        key: key.slice(0, 1024),\n        keyTruncated: key.length > 1024,\n        cancelled,\n        error: fanOutCause(itemError),\n      })),\n      failureCount,\n      omittedFailureCount: failureCount - failures.length,\n    };\n    if (schedulerError !== undefined)\n      pipelineError.fanOut.schedulerError = fanOutCause(schedulerError);\n  }\n  originalPipelineErrors.set(pipelineError, error);\n  return pipelineError;\n}\n\nexport function isPipelineCancellation(error: unknown, runtime: PipelineRuntime): boolean {\n  if (isAbortError(error)) return true;\n  if (runtime.signal?.aborted === true && error === runtime.signal.reason) return true;\n  if (error instanceof PipelineChildError) return error.cancelled;\n  return error instanceof PipelineExecutionError && isCancelledResult(error.result);\n}\n\nfunction isCancelledResult(result: PipelineRun<unknown>): boolean {\n  return result.status === \"cancelled\";\n}\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}): 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  try {\n    // SAFETY: only internal hosts attach this observation callback. A callback\n    // failure must not change whether the pipeline execution itself can start.\n    (runtime as PipelineRuntime & ObservedPipelineRuntime)[PIPELINE_RUN_ID_OBSERVER]?.(runId);\n  } catch {\n    // Ignore observation failures; execution identity remains package-owned.\n  }\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 trace = createPipelineTraceEmitter(\n    compiled.id,\n    runtime.tracing,\n    basePipelineLogger(runtime.log),\n    { ...identity, itemKey: runtime.tracing?.itemKey },\n    runtime.now\n  );\n  const lifecycle = createPipelineLifecycleObserver(compiled.id, runtime, trace);\n  const tracedLogger = (stepId?: string, attemptId?: string): PipelineLogger => {\n    if (!trace) return runtime.log;\n    const base = basePipelineLogger(runtime.log);\n    const log: TracedPipelineLogger = {\n      error: (message, ...params) => {\n        lifecycle.log(\"error\", message, params, stepId, attemptId);\n        base.error(message, ...params);\n      },\n      log: (message, ...params) => {\n        lifecycle.log(\"log\", message, params, stepId, attemptId);\n        base.log(message, ...params);\n      },\n      warn: (message, ...params) => {\n        lifecycle.log(\"warn\", message, params, stepId, attemptId);\n        base.warn(message, ...params);\n      },\n    };\n    log[PIPELINE_LOGGER_BASE] = base;\n    return log;\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  // 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: tracedLogger(),\n    options: pipelineOptions,\n    runId,\n    trace: trace?.context,\n  };\n  if (correlationId !== undefined) executionContext.correlationId = correlationId;\n  if (runtime.parentRunId) executionContext.parentRunId = runtime.parentRunId;\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  const recordRemainingStates = (\n    fromIndex: number,\n    failedStepId?: string,\n    cancellationError?: PipelineError\n  ): void => {\n    for (let index = fromIndex; index < orderedSteps.length; index++) {\n      const step = orderedSteps[index]!;\n      const plannedStep = plannedStepFor(step);\n      if (plannedStep.skipReason) {\n        const dependencyId =\n          plannedStep.skipReason === \"unmet-dependency\"\n            ? plannedStep.dependencies.find((id) => plannedSteps.get(id)?.skipReason !== undefined)\n            : undefined;\n        state.skipStep(plannedStep, {\n          reason: plannedStep.skipReason,\n          dependencyId,\n        });\n      } else if (cancellationError) {\n        state.cancelStep(plannedStep, { ...cancellationError, stepId: step.id }, false);\n      } else {\n        state.skipStep(plannedStep, {\n          reason: \"fail-fast\",\n          message: failedStepId\n            ? `Not run because fail-fast stopped after ${failedStepId} failed.`\n            : \"Not run because the pipeline was aborted before this step started.\",\n          dependencyId: failedStepId,\n        });\n      }\n    }\n  };\n\n  const cancelBeforeStepStart = (stepId: string, stepIndex: number): boolean => {\n    try {\n      throwIfAborted(runtime);\n      return false;\n    } catch (error) {\n      const pipelineError = toPipelineError(error, {\n        code: \"TUBELESS_RUN_CANCELLED\",\n        kind: \"cancellation\",\n        phase: \"execution\",\n        stepId,\n      });\n      state.recordRunErrors([pipelineError]);\n      recordRemainingStates(stepIndex, undefined, pipelineError);\n      return true;\n    }\n  };\n\n  const recordStepExecutionFailure = (\n    error: unknown,\n    plannedStep: PipelinePlanStep,\n    stepIndex: number,\n    attempt: PipelineStepAttempt\n  ): boolean => {\n    const cancelled = isPipelineCancellation(error, runtime);\n    const childFailure =\n      error instanceof PipelineExecutionError || error instanceof PipelineChildError;\n    const validationFailure = error instanceof PipelineBoundaryValidationError;\n    const pipelineError = toPipelineError(error, {\n      code: cancelled\n        ? \"TUBELESS_RUN_CANCELLED\"\n        : validationFailure\n          ? \"TUBELESS_STEP_OUTPUT_VALIDATION_FAILED\"\n          : childFailure\n            ? \"TUBELESS_CHILD_FAILED\"\n            : \"TUBELESS_STEP_FAILED\",\n      kind: cancelled\n        ? \"cancellation\"\n        : validationFailure\n          ? \"validation\"\n          : childFailure\n            ? \"child\"\n            : \"step\",\n      phase: \"execution\",\n      stepId: plannedStep.id,\n    });\n    state.failStep(plannedStep, attempt, pipelineError);\n    if (controls.continueOnError) return false;\n    recordRemainingStates(stepIndex + 1, plannedStep.id, cancelled ? pipelineError : undefined);\n    return true;\n  };\n\n  const recordPolicySkip = async (\n    plannedStep: PipelinePlanStep,\n    step: AnyStep<TOptions>,\n    stepIndex: number,\n    reason: string,\n    value: unknown\n  ): Promise<boolean> => {\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, stepIndex, attempt);\n      }\n    }\n    state.skipStep(plannedStep, {\n      attempt,\n      message: reason,\n      output: { value: published },\n      reason: \"policy\",\n    });\n    return false;\n  };\n\n  for (const [stepIndex, step] of orderedSteps.entries()) {\n    const plannedStep = plannedStepFor(step);\n    if (cancelBeforeStepStart(step.id, stepIndex)) break;\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      continue;\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: tracedLogger(step.id),\n        });\n      } catch (error) {\n        const attempt = state.beginAttempt(plannedStep);\n        if (recordStepExecutionFailure(error, plannedStep, stepIndex, attempt)) break;\n        continue;\n      }\n      if (cancelBeforeStepStart(step.id, stepIndex)) break;\n      if (skipDecision) {\n        if (\n          await recordPolicySkip(\n            plannedStep,\n            step,\n            stepIndex,\n            skipDecision.reason,\n            skipDecision.value\n          )\n        ) {\n          break;\n        }\n        continue;\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: tracedLogger(step.id, attempt.attemptId),\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      if (recordStepExecutionFailure(error, plannedStep, stepIndex, attempt)) break;\n    }\n  }\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: tracedLogger(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 cancelled = isPipelineCancellation(error, runtime);\n      const validationFailure = error instanceof PipelineBoundaryValidationError;\n      const pipelineError = toPipelineError(error, {\n        code: cancelled\n          ? \"TUBELESS_FINALIZATION_CANCELLED\"\n          : validationFailure\n            ? \"TUBELESS_FINAL_RESULT_VALIDATION_FAILED\"\n            : \"TUBELESS_FINALIZATION_FAILED\",\n        kind: cancelled ? \"cancellation\" : validationFailure ? \"validation\" : \"finalization\",\n        phase: \"finalization\",\n        stepId: PIPELINE_FINALIZE_STEP_ID,\n      });\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"]}