tubeless 0.2.11 → 0.2.13

package/dist/core/pipeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/core/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAUzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAcvD,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,CAAC;AA+EnD,SAAS,oBAAoB,CAC3B,QAAiD;IAEjD,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC;IAC/E,MAAM,QAAQ,GAA4C,EAAE,CAAC;IAC7D,IAAI,eAAe,KAAK,SAAS;QAAE,QAAQ,CAAC,eAAe,GAAG,eAAe,CAAC;IAC9E,IAAI,MAAM,KAAK,SAAS;QAAE,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC;IACnD,IAAI,cAAc,KAAK,SAAS;QAAE,QAAQ,CAAC,cAAc,GAAG,cAAc,CAAC;IAC3E,IAAI,OAAO,KAAK,SAAS;QAAE,QAAQ,CAAC,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;IAC3D,IAAI,OAAO,KAAK,SAAS;QAAE,QAAQ,CAAC,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;IAC3D,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAO5B,UACiD;IAWjD,MAAM,QAAQ,GAAG,eAAe,CAA2C,UAAU,CAAC,CAAC;IAOvF,6DAA6D;IAC7D,MAAM,OAAO,GAAG,QAAQ,CAAC,OAA6B,CAAC;IACvD,iEAAiE;IACjE,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAiC,CAAC;IAE7D,SAAS,UAAU,CAAC,QAAiD;QAInE,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAC1D,OAAO;YACL,QAAQ,EAAE,kBAAkB;YAC5B,IAAI,EAAE,iBAAiB,CAAC,QAAQ,EAAE,kBAAkB,CAAC;SACtD,CAAC;IACJ,CAAC;IAED,SAAS,IAAI,CAAC,QAAQ,GAA4C,EAAE;QAClE,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;IACnC,CAAC;IAED,SAAS,SAAS,CAAC,OAAO,GAA2B,EAAE;QACrD,OAAO,qBAAqB,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IACnF,CAAC;IAED,KAAK,UAAU,eAAe,CAC5B,OAAqB,EACrB,OAAsB,EACtB,QAAiD,EACjD,OAAO,GAA6B,sBAAsB,EAAE;QAE5D,OAAO,iBAAiB,CAAC;YACvB,QAAQ;YACR,QAAQ;YACR,aAAa,EAAE,OAAO;YACtB,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,sBAAsB,CAAC,OAAO,CAAC;SACzC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,UAAU,GAAG,CAChB,OAAsB,EACtB,QAAQ,GAA4C,EAAE,EACtD,OAAO,GAA6B,sBAAsB,EAAE;QAE5D,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QACtC,OAAO,eAAe,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC;IAED,KAAK,UAAU,UAAU,CACvB,OAAsB,EACtB,QAAQ,GAA4C,EAAE,EACtD,OAAO,GAA6B,sBAAsB,EAAE;QAE5D,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;QACD,sEAAsE;QACtE,OAAO,MAAM,CAAC,KAAwB,CAAC;IACzC,CAAC;IAED,MAAM,QAAQ,GAAG;QACf,EAAE,EAAE,UAAU,CAAC,EAAE;QACjB,GAAG,CAAC,UAAU,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC;QACnE,GAAG,CAAC,UAAU,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,UAAU,CAAC,WAAW,EAAE,CAAC;QACxF,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,mFAAmF;QACnF,aAAa,EAAE,QAAQ,CAAC,aACQ;QAChC,OAAO;QACP,SAAS;QACT,IAAI;QACJ,GAAG;QACH,UAAU;QACV,SAAS;KACV,CAAC;IACF,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,oBAAoB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;IAClF,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAChC,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["import {\n  defaultPipelineContext,\n  executePlannedRun,\n  PipelineExecutionError,\n  resolvePipelineRuntime,\n} from \"./pipeline-execute.js\";\nimport { RUN_MODEL_VERSION } from \"./pipeline-ids.js\";\nimport { compilePipeline } from \"./pipeline-compiler.js\";\nimport type {\n  DefaultPipelineResult,\n  DefaultPipelineTargets,\n  PipelineDefinition,\n  StepIds,\n  StepsInputOptions,\n  StepsOptionsSchema,\n  TargetIds,\n} from \"./pipeline-definition.js\";\nimport { PipelineDefinitionError } from \"./pipeline-errors.js\";\nimport { requireOutputs } from \"./pipeline-finalizer.js\";\nimport { brandCompiledPipeline, EXECUTE_COMPILED_RUN } from \"./pipeline-identity.js\";\nimport { renderPipelineMermaid } from \"./pipeline-mermaid.js\";\nimport { buildPipelinePlan } from \"./pipeline-plan.js\";\nimport type { AnyStep } from \"./pipeline-steps.js\";\nimport type {\n  InferSchemaOutput,\n  Pipeline,\n  PipelineContext,\n  PipelineDefinitionSnapshot,\n  PipelineMermaidOptions,\n  PipelinePlan,\n  PipelineRun,\n  PipelineRunControls,\n  StandardSchemaV1,\n} from \"./pipeline-types.js\";\n\nexport { PipelineExecutionError, RUN_MODEL_VERSION };\nexport { isPipelineErrorCode, PIPELINE_ERROR_CODES } from \"./pipeline-types.js\";\nexport { createSteps } from \"./pipeline-steps.js\";\nexport { PipelineDefinitionError, requireOutputs };\nexport type {\n  PipelineDefinitionIdentity,\n  PipelineDefinitionSnapshot,\n  PipelineLogger,\n  PipelineContext,\n  PipelineRunControls,\n  PipelineExecutionContext,\n  PipelineStepProgressDetailStatus,\n  PipelineStepProgressDetail,\n  PipelineStepProgress,\n  PipelineStepContext,\n  RemoteStepAdapter,\n  PipelineErrorPhase,\n  PipelineErrorKind,\n  PipelineErrorCode,\n  PipelineValidationIssue,\n  PipelineError,\n  PipelineFanOutDiagnostics,\n  PipelineFanOutFailure,\n  StandardSchemaV1,\n  PipelineErrorCause,\n  PipelineStepCompleteReport,\n  PipelineStepSkippedReport,\n  PipelineStepCancelledReport,\n  PipelineStepFailedReport,\n  PipelineStepReport,\n  PipelineStepReportStatus,\n  PipelineRunStatus,\n  PipelineRun,\n  PipelineStepSkipReason,\n  StepSkipDecision,\n  PipelineStepStatus,\n  PipelineStepLifecycleStatus,\n  PipelineStepPlannedEvent,\n  PipelineStepStartEvent,\n  PipelineStepProgressEvent,\n  PipelineStepCancelledEvent,\n  PipelineStepFailedEvent,\n  PipelineStepSkippedEvent,\n  PipelineStepCompleteEvent,\n  PipelineHooks,\n  PipelineStepSelectionReason,\n  PipelinePlanStep,\n  PipelinePlan,\n  PipelineMermaidDirection,\n  PipelineMermaidOptions,\n  Pipeline,\n  PipelineInput,\n  PipelineResult,\n} from \"./pipeline-types.js\";\n\nexport type { PipelineDefinition } from \"./pipeline-definition.js\";\n\nexport type { Step, MappedChildProgressOptions } from \"./pipeline-steps.js\";\n\ntype DuplicateStepIds<\n  TSteps extends readonly AnyStep[],\n  TSeen extends string = never,\n> = TSteps extends readonly [infer THead, ...infer TTail]\n  ? THead extends AnyStep\n    ? TTail extends readonly AnyStep[]\n      ? THead[\"id\"] extends TSeen\n        ? THead[\"id\"] | DuplicateStepIds<TTail, TSeen>\n        : DuplicateStepIds<TTail, TSeen | THead[\"id\"]>\n      : never\n    : never\n  : never;\n\ntype CheckedStepTuple<TSteps extends readonly AnyStep[]> =\n  string extends StepIds<TSteps>\n    ? unknown\n    : DuplicateStepIds<TSteps> extends never\n      ? unknown\n      : {\n          /** Compile-time diagnostic: every literal step ID in a definition must be unique. */\n          readonly __duplicateStepIds: DuplicateStepIds<TSteps>;\n        };\n\nfunction normalizeRunControls<TStepId extends string, TTargetId extends string>(\n  controls: PipelineRunControls<TStepId, TTargetId>\n): PipelineRunControls<TStepId, TTargetId> {\n  const { continueOnError, dryRun, maxConcurrency, stepIds, targets } = controls;\n  const snapshot: PipelineRunControls<TStepId, TTargetId> = {};\n  if (continueOnError !== undefined) snapshot.continueOnError = continueOnError;\n  if (dryRun !== undefined) snapshot.dryRun = dryRun;\n  if (maxConcurrency !== undefined) snapshot.maxConcurrency = maxConcurrency;\n  if (stepIds !== undefined) snapshot.stepIds = [...stepIds];\n  if (targets !== undefined) snapshot.targets = [...targets];\n  return snapshot;\n}\n\n/**\n * Compile a typed step graph into a validated, executable pipeline.\n * Prefer inferred type arguments to preserve the literal id. For an explicit\n * result contract, annotate the finalizer's return type; partially supplied type\n * arguments use defaults for remaining parameters, including the id's string type.\n */\nexport function definePipeline<\n  const TSteps extends readonly AnyStep[],\n  TResult = DefaultPipelineResult<TSteps>,\n  const TTargets extends readonly TSteps[number][] = DefaultPipelineTargets<TSteps>,\n  const TResultSchema extends StandardSchemaV1 | undefined = undefined,\n  const TId extends string = string,\n>(\n  definition: PipelineDefinition<TSteps, TResult, TTargets, TResultSchema> &\n    CheckedStepTuple<TSteps> & { readonly id: TId }\n): Pipeline<\n  StepsInputOptions<TSteps>,\n  TResultSchema extends StandardSchemaV1 ? InferSchemaOutput<TResultSchema> : TResult,\n  StepIds<TSteps>,\n  TargetIds<TTargets>,\n  TId\n> & {\n  readonly definition: PipelineDefinitionSnapshot;\n  readonly optionsSchema: StepsOptionsSchema<TSteps>;\n} {\n  const compiled = compilePipeline<TSteps, TResult, TTargets, TResultSchema>(definition);\n  type TInputOptions = StepsInputOptions<TSteps>;\n  type TPipelineResult = TResultSchema extends StandardSchemaV1\n    ? InferSchemaOutput<TResultSchema>\n    : TResult;\n  type TStepId = StepIds<TSteps>;\n  type TTargetId = TargetIds<TTargets>;\n  // SAFETY: each compiled step id is a string key of `TSteps`.\n  const stepIds = compiled.stepIds as readonly TStepId[];\n  // SAFETY: each compiled target id is a string key of `TTargets`.\n  const targetIds = compiled.targetIds as readonly TTargetId[];\n\n  function prepareRun(controls: PipelineRunControls<TStepId, TTargetId>): {\n    controls: PipelineRunControls<TStepId, TTargetId>;\n    plan: PipelinePlan;\n  } {\n    const normalizedControls = normalizeRunControls(controls);\n    return {\n      controls: normalizedControls,\n      plan: buildPipelinePlan(compiled, normalizedControls),\n    };\n  }\n\n  function plan(controls: PipelineRunControls<TStepId, TTargetId> = {}): PipelinePlan {\n    return prepareRun(controls).plan;\n  }\n\n  function toMermaid(options: PipelineMermaidOptions = {}): string {\n    return renderPipelineMermaid(compiled.orderedSteps, options, compiled.stepGraph);\n  }\n\n  async function executeCompiled(\n    runPlan: PipelinePlan,\n    options: TInputOptions,\n    controls: PipelineRunControls<TStepId, TTargetId>,\n    context: Partial<PipelineContext> = defaultPipelineContext()\n  ): Promise<PipelineRun<TPipelineResult>> {\n    return executePlannedRun({\n      compiled,\n      controls,\n      domainOptions: options,\n      plan: runPlan,\n      runtime: resolvePipelineRuntime(context),\n    });\n  }\n\n  async function run(\n    options: TInputOptions,\n    controls: PipelineRunControls<TStepId, TTargetId> = {},\n    context: Partial<PipelineContext> = defaultPipelineContext()\n  ): Promise<PipelineRun<TPipelineResult>> {\n    const prepared = prepareRun(controls);\n    return executeCompiled(prepared.plan, options, prepared.controls, context);\n  }\n\n  async function runOrThrow(\n    options: TInputOptions,\n    controls: PipelineRunControls<TStepId, TTargetId> = {},\n    context: Partial<PipelineContext> = defaultPipelineContext()\n  ): Promise<TPipelineResult> {\n    const result = await run(options, controls, context);\n    if (result.status !== \"completed\") {\n      throw new PipelineExecutionError(result);\n    }\n    // SAFETY: a completed run always carries its `TPipelineResult` value.\n    return result.value as TPipelineResult;\n  }\n\n  const pipeline = {\n    id: definition.id,\n    ...(definition.name === undefined ? {} : { name: definition.name }),\n    ...(definition.description === undefined ? {} : { description: definition.description }),\n    definition: compiled.definition,\n    // SAFETY: compilation verifies that every step belongs to the same options schema.\n    optionsSchema: compiled.optionsSchema as StepsOptionsSchema<TSteps> &\n      (StandardSchemaV1 | undefined),\n    stepIds,\n    targetIds,\n    plan,\n    run,\n    runOrThrow,\n    toMermaid,\n  };\n  Object.defineProperty(pipeline, EXECUTE_COMPILED_RUN, { value: executeCompiled });\n  brandCompiledPipeline(pipeline);\n  return pipeline;\n}\n"]}
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/core/pipeline.ts"],"names":[],"mappings":"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","sourcesContent":["import { PipelineExecutionError } from \"./pipeline-execution-error.js\";\nimport {\n  defaultPipelineContext,\n  executePlannedRun,\n  resolvePipelineRuntime,\n} from \"./pipeline-execute.js\";\nimport { RUN_MODEL_VERSION } from \"./pipeline-ids.js\";\nimport { compilePipeline } from \"./pipeline-compiler.js\";\nimport type {\n  DefaultPipelineResult,\n  DefaultPipelineTargets,\n  PipelineDefinition,\n  StepIds,\n  StepsInputOptions,\n  StepsOptionsSchema,\n  TargetIds,\n} from \"./pipeline-definition.js\";\nimport { PipelineDefinitionError } from \"./pipeline-errors.js\";\nimport { requireOutputs } from \"./pipeline-finalizer.js\";\nimport {\n  brandCompiledPipeline,\n  EXECUTE_COMPILED_RUN,\n  EXECUTE_TEST_RUN,\n} from \"./pipeline-identity.js\";\nimport { renderPipelineMermaid } from \"./pipeline-mermaid.js\";\nimport { buildPipelinePlan } from \"./pipeline-plan.js\";\nimport type { AnyStep } from \"./pipeline-steps.js\";\nimport type {\n  InferSchemaOutput,\n  Pipeline,\n  PipelineContext,\n  PipelineDefinitionSnapshot,\n  PipelineMermaidOptions,\n  PipelinePlan,\n  PipelineRun,\n  PipelineRunControls,\n  StandardSchemaV1,\n} from \"./pipeline-types.js\";\n\nexport { PipelineExecutionError, RUN_MODEL_VERSION };\nexport { isPipelineErrorCode, PIPELINE_ERROR_CODES } from \"./pipeline-types.js\";\nexport { createSteps } from \"./pipeline-steps.js\";\nexport type { IterationDecision, IterationState } from \"./iteration.js\";\nexport { PipelineDefinitionError, requireOutputs };\nexport type {\n  PipelineDefinitionIdentity,\n  PipelineDefinitionSnapshot,\n  PipelineLogger,\n  PipelineContext,\n  PipelineRunControls,\n  PipelineExecutionContext,\n  PipelineStepProgressDetailStatus,\n  PipelineStepProgressDetail,\n  PipelineStepProgress,\n  PipelineStepContext,\n  RemoteStepAdapter,\n  PipelineErrorPhase,\n  PipelineErrorKind,\n  PipelineErrorCode,\n  PipelineValidationIssue,\n  PipelineError,\n  PipelineFanOutDiagnostics,\n  PipelineFanOutFailure,\n  StandardSchemaV1,\n  PipelineErrorCause,\n  PipelineStepCompleteReport,\n  PipelineStepSkippedReport,\n  PipelineStepCancelledReport,\n  PipelineStepFailedReport,\n  PipelineStepReport,\n  PipelineStepReportStatus,\n  PipelineRunStatus,\n  PipelineRun,\n  PipelineStepSkipReason,\n  StepSkipDecision,\n  PipelineStepStatus,\n  PipelineStepLifecycleStatus,\n  PipelineStepPlannedEvent,\n  PipelineStepStartEvent,\n  PipelineStepProgressEvent,\n  PipelineStepCancelledEvent,\n  PipelineStepFailedEvent,\n  PipelineStepSkippedEvent,\n  PipelineStepCompleteEvent,\n  PipelineHooks,\n  PipelineStepSelectionReason,\n  PipelinePlanStep,\n  PipelinePlan,\n  PipelineMermaidDirection,\n  PipelineMermaidOptions,\n  Pipeline,\n  PipelineInput,\n  PipelineResult,\n} from \"./pipeline-types.js\";\n\nexport type { PipelineDefinition } from \"./pipeline-definition.js\";\n\nexport type { Step, MappedChildProgressOptions } from \"./pipeline-steps.js\";\n\ntype DuplicateStepIds<\n  TSteps extends readonly AnyStep[],\n  TSeen extends string = never,\n> = TSteps extends readonly [infer THead, ...infer TTail]\n  ? THead extends AnyStep\n    ? TTail extends readonly AnyStep[]\n      ? THead[\"id\"] extends TSeen\n        ? THead[\"id\"] | DuplicateStepIds<TTail, TSeen>\n        : DuplicateStepIds<TTail, TSeen | THead[\"id\"]>\n      : never\n    : never\n  : never;\n\ntype CheckedStepTuple<TSteps extends readonly AnyStep[]> =\n  string extends StepIds<TSteps>\n    ? unknown\n    : DuplicateStepIds<TSteps> extends never\n      ? unknown\n      : {\n          /** Compile-time diagnostic: every literal step ID in a definition must be unique. */\n          readonly __duplicateStepIds: DuplicateStepIds<TSteps>;\n        };\n\nfunction normalizeRunControls<TStepId extends string, TTargetId extends string>(\n  controls: PipelineRunControls<TStepId, TTargetId>\n): PipelineRunControls<TStepId, TTargetId> {\n  const { continueOnError, dryRun, maxConcurrency, stepIds, targets } = controls;\n  const snapshot: PipelineRunControls<TStepId, TTargetId> = {};\n  if (continueOnError !== undefined) snapshot.continueOnError = continueOnError;\n  if (dryRun !== undefined) snapshot.dryRun = dryRun;\n  if (maxConcurrency !== undefined) snapshot.maxConcurrency = maxConcurrency;\n  if (stepIds !== undefined) snapshot.stepIds = [...stepIds];\n  if (targets !== undefined) snapshot.targets = [...targets];\n  return snapshot;\n}\n\n/**\n * Compile a typed step graph into a validated, executable pipeline.\n * Prefer inferred type arguments to preserve the literal id. For an explicit\n * result contract, annotate the finalizer's return type; partially supplied type\n * arguments use defaults for remaining parameters, including the id's string type.\n */\nexport function definePipeline<\n  const TSteps extends readonly AnyStep[],\n  TResult = DefaultPipelineResult<TSteps>,\n  const TTargets extends readonly TSteps[number][] = DefaultPipelineTargets<TSteps>,\n  const TResultSchema extends StandardSchemaV1 | undefined = undefined,\n  const TId extends string = string,\n>(\n  definition: PipelineDefinition<TSteps, TResult, TTargets, TResultSchema> &\n    CheckedStepTuple<TSteps> & { readonly id: TId }\n): Pipeline<\n  StepsInputOptions<TSteps>,\n  TResultSchema extends StandardSchemaV1 ? InferSchemaOutput<TResultSchema> : TResult,\n  StepIds<TSteps>,\n  TargetIds<TTargets>,\n  TId\n> & {\n  readonly definition: PipelineDefinitionSnapshot;\n  readonly optionsSchema: StepsOptionsSchema<TSteps>;\n} {\n  const compiled = compilePipeline<TSteps, TResult, TTargets, TResultSchema>(definition);\n  type TInputOptions = StepsInputOptions<TSteps>;\n  type TPipelineResult = TResultSchema extends StandardSchemaV1\n    ? InferSchemaOutput<TResultSchema>\n    : TResult;\n  type TStepId = StepIds<TSteps>;\n  type TTargetId = TargetIds<TTargets>;\n  // SAFETY: each compiled step id is a string key of `TSteps`.\n  const stepIds = compiled.stepIds as readonly TStepId[];\n  // SAFETY: each compiled target id is a string key of `TTargets`.\n  const targetIds = compiled.targetIds as readonly TTargetId[];\n\n  function prepareRun(controls: PipelineRunControls<TStepId, TTargetId>): {\n    controls: PipelineRunControls<TStepId, TTargetId>;\n    plan: PipelinePlan;\n  } {\n    const normalizedControls = normalizeRunControls(controls);\n    return {\n      controls: normalizedControls,\n      plan: buildPipelinePlan(compiled, normalizedControls),\n    };\n  }\n\n  function plan(controls: PipelineRunControls<TStepId, TTargetId> = {}): PipelinePlan {\n    return prepareRun(controls).plan;\n  }\n\n  function toMermaid(options: PipelineMermaidOptions = {}): string {\n    return renderPipelineMermaid(compiled.orderedSteps, options, compiled.stepGraph);\n  }\n\n  async function executeCompiled(\n    runPlan: PipelinePlan,\n    options: TInputOptions,\n    controls: PipelineRunControls<TStepId, TTargetId>,\n    context: Partial<PipelineContext> = defaultPipelineContext(),\n    overrides?: ReadonlyMap<AnyStep, unknown>\n  ): Promise<PipelineRun<TPipelineResult>> {\n    return executePlannedRun({\n      compiled,\n      controls,\n      domainOptions: options,\n      plan: runPlan,\n      runtime: resolvePipelineRuntime(context),\n      overrides,\n    });\n  }\n\n  async function run(\n    options?: TInputOptions,\n    controls: PipelineRunControls<TStepId, TTargetId> = {},\n    context: Partial<PipelineContext> = defaultPipelineContext()\n  ): Promise<PipelineRun<TPipelineResult>> {\n    const prepared = prepareRun(controls);\n    // SAFETY: the public signature permits omission only when {} satisfies the\n    // input type. Schemas still validate the default object during execution.\n    const input = options === undefined ? ({} as TInputOptions) : options;\n    return executeCompiled(prepared.plan, input, prepared.controls, context);\n  }\n\n  async function runOrThrow(\n    options?: TInputOptions,\n    controls: PipelineRunControls<TStepId, TTargetId> = {},\n    context: Partial<PipelineContext> = defaultPipelineContext()\n  ): Promise<TPipelineResult> {\n    const result = await run(options, controls, context);\n    if (result.status !== \"completed\") {\n      throw new PipelineExecutionError(result);\n    }\n    // SAFETY: a completed run always carries its `TPipelineResult` value.\n    return result.value as TPipelineResult;\n  }\n\n  const pipeline = {\n    id: definition.id,\n    ...(definition.name === undefined ? {} : { name: definition.name }),\n    ...(definition.description === undefined ? {} : { description: definition.description }),\n    definition: compiled.definition,\n    // SAFETY: compilation verifies that every step belongs to the same options schema.\n    optionsSchema: compiled.optionsSchema as StepsOptionsSchema<TSteps> &\n      (StandardSchemaV1 | undefined),\n    stepIds,\n    targetIds,\n    plan,\n    run,\n    runOrThrow,\n    toMermaid,\n  };\n  Object.defineProperty(pipeline, EXECUTE_COMPILED_RUN, { value: executeCompiled });\n  Object.defineProperty(pipeline, EXECUTE_TEST_RUN, {\n    value: (\n      options: TInputOptions,\n      controls: PipelineRunControls<TStepId, TTargetId>,\n      context: Partial<PipelineContext>,\n      overrides: ReadonlyMap<AnyStep, unknown>\n    ) => {\n      const resolved = new Map<AnyStep, unknown>();\n      for (const [step, value] of overrides) {\n        const compiledStep = compiled.compiledByAuthorStep.get(step);\n        if (!compiledStep)\n          throw new TypeError(\n            `Override step ${step.id} does not belong to pipeline ${compiled.id}`\n          );\n        resolved.set(compiledStep, value);\n      }\n      const prepared = prepareRun(controls);\n      return executeCompiled(\n        prepared.plan,\n        options === undefined ? ({} as TInputOptions) : options,\n        prepared.controls,\n        context,\n        resolved\n      );\n    },\n  });\n  brandCompiledPipeline(pipeline);\n  return pipeline;\n}\n\nexport type {\n  ArtifactJsonValue,\n  ArtifactMetadata,\n  ArtifactRecord,\n} from \"../tracing/artifact-metadata.js\";\nexport type { ArtifactLoader, ArtifactSaver, ArtifactResult } from \"./pipeline-artifacts.js\";\n"]}

package/dist/project/project-compiler.d.ts

@@ -1,6 +1,8 @@
-import { type MappedChildProgressOptions, type Pipeline, type PipelineExecutionContext, type PipelineRun, type PipelineRunControls, type PipelineStepContext, type StandardSchemaV1, type StepSkipDecision } from "../core/pipeline.js";
+import { type Pipeline } from "../core/pipeline.js";
+import { type ProjectRegistry } from "./project-registry.js";
 import { PipelineDocumentError, type PipelineDocumentMetadata } from "./project-document.js";
 export { PipelineDocumentError };
+export type { ProjectRegistry } from "./project-registry.js";
 /** Immutable compiled pipelines and descriptive metadata from a parsed document. */
 export interface CompiledPipelineDocument {
     readonly pipelines: readonly Pipeline<object, unknown>[];
@@ -8,36 +10,6 @@ export interface CompiledPipelineDocument {
     /** Return the shared compiled instance, or throw if the document has no such id. */
     get(id: string): Pipeline<object, unknown>;
 }
-/** Dependency values are checked at runtime rather than inferred from a project document. */
-type PipelineDocumentHandler = (inputs: Record<string, unknown>, context: PipelineStepContext<object>) => unknown;
-type PipelineDocumentFinalizer = (outputs: Record<string, unknown>, context: PipelineExecutionContext<object>) => unknown;
-type PipelineDocumentSkipPredicate = (inputs: Record<string, unknown>, context: PipelineExecutionContext<object>) => StepSkipDecision | Promise<StepSkipDecision>;
-/** Application-owned wiring for one declarative `fromPipeline` step. */
-interface PipelineDocumentFromPipelineAdapter {
-    controls?: PipelineRunControls | ((inputs: Record<string, unknown>, context: PipelineExecutionContext<object>) => PipelineRunControls);
-    mapOptions(inputs: Record<string, unknown>, context: PipelineExecutionContext<object>): object;
-    mapResult?(value: unknown, result: PipelineRun<unknown>, context: PipelineStepContext<object>): unknown;
-}
-/** Application-owned wiring for one declarative `forEachPipeline` step. */
-interface PipelineDocumentForEachPipelineAdapter {
-    controls?: PipelineRunControls | ((item: unknown, index: number, inputs: Record<string, unknown>, context: PipelineExecutionContext<object>) => PipelineRunControls);
-    items(inputs: Record<string, unknown>, context: PipelineExecutionContext<object>): readonly unknown[] | Promise<readonly unknown[]>;
-    key(item: unknown, index: number): string;
-    concurrency?: number | ((inputs: Record<string, unknown>, context: PipelineExecutionContext<object>) => number);
-    progress?: MappedChildProgressOptions;
-    mapOptions(item: unknown, index: number, inputs: Record<string, unknown>, context: PipelineExecutionContext<object>): object;
-    mapResult?(value: unknown, result: PipelineRun<unknown>, item: unknown, index: number, context: PipelineStepContext<object>): unknown;
-}
-/** Only explicitly registered functions and schemas can be referenced by a document. */
-export interface ProjectRegistry {
-    steps: Readonly<Record<string, PipelineDocumentHandler>>;
-    finalizers: Readonly<Record<string, PipelineDocumentFinalizer>>;
-    skipPredicates?: Readonly<Record<string, PipelineDocumentSkipPredicate>>;
-    fromPipelineAdapters?: Readonly<Record<string, PipelineDocumentFromPipelineAdapter>>;
-    forEachPipelineAdapters?: Readonly<Record<string, PipelineDocumentForEachPipelineAdapter>>;
-    optionsSchemas?: Readonly<Record<string, StandardSchemaV1<object, object>>>;
-    schemas?: Readonly<Record<string, StandardSchemaV1>>;
-}
 /**
  * Compile parsed YAML or JSON into ordinary pipelines. Does not load modules,
  * invoke handlers or schemas, or perform I/O. Graph validation belongs to core.

package/dist/project/project-compiler.js

@@ -1,91 +1,15 @@
-import { createSteps, definePipeline, requireOutputs, } from "../core/pipeline.js";
+import { definePipeline, requireOutputs } from "../core/pipeline.js";
+import { ProjectRegistryResolver } from "./project-registry.js";
+import { compileDocumentSteps } from "./project-step-graph.js";
 import { validatePipelineDocument, PipelineDocumentError, } from "./project-document.js";
 export { PipelineDocumentError };
-function resolve(registry, name, path) {
-    if (!registry || !Object.hasOwn(registry, name)) {
-        throw new PipelineDocumentError(path, `Unknown registered name ${JSON.stringify(name)}`);
-    }
-    return registry[name];
-}
-function handler(registry, name, path) {
-    const value = resolve(registry, name, path);
-    if (typeof value !== "function")
-        throw new PipelineDocumentError(path, "Expected a registered function");
-    return value;
-}
-function schema(registry, name, path) {
-    if (name === undefined)
-        return undefined;
-    const value = resolve(registry, name, path);
-    if (!value ||
-        value["~standard"]?.version !== 1 ||
-        typeof value["~standard"].validate !== "function") {
-        throw new PipelineDocumentError(path, "Expected a Standard Schema v1 schema");
-    }
-    return value;
-}
-function registeredObject(registry, name, path) {
-    const value = resolve(registry, name, path);
-    if (typeof value !== "object" || value === null || Array.isArray(value)) {
-        throw new PipelineDocumentError(path, "Expected a registered adapter object");
-    }
-    return value;
-}
-function fromPipelineAdapter(registry, name, path) {
-    const adapter = registeredObject(registry, name, path);
-    if (typeof adapter.mapOptions !== "function") {
-        throw new PipelineDocumentError(path, "Expected an adapter with mapOptions");
-    }
-    if (adapter.controls !== undefined &&
-        typeof adapter.controls !== "function" &&
-        (typeof adapter.controls !== "object" || adapter.controls === null)) {
-        throw new PipelineDocumentError(path, "Expected adapter controls to be an object or function");
-    }
-    if (adapter.mapResult !== undefined && typeof adapter.mapResult !== "function") {
-        throw new PipelineDocumentError(path, "Expected adapter mapResult to be a function");
-    }
-    return {
-        controls: adapter.controls,
-        mapOptions: adapter.mapOptions,
-        mapResult: adapter.mapResult,
-    };
-}
-function forEachPipelineAdapter(registry, name, path) {
-    const adapter = registeredObject(registry, name, path);
-    if (typeof adapter.items !== "function" ||
-        typeof adapter.key !== "function" ||
-        typeof adapter.mapOptions !== "function") {
-        throw new PipelineDocumentError(path, "Expected an adapter with items, key, and mapOptions");
-    }
-    if (adapter.concurrency !== undefined &&
-        typeof adapter.concurrency !== "number" &&
-        typeof adapter.concurrency !== "function") {
-        throw new PipelineDocumentError(path, "Expected adapter concurrency to be a number or function");
-    }
-    if (adapter.controls !== undefined &&
-        typeof adapter.controls !== "function" &&
-        (typeof adapter.controls !== "object" || adapter.controls === null)) {
-        throw new PipelineDocumentError(path, "Expected adapter controls to be an object or function");
-    }
-    if (adapter.mapResult !== undefined && typeof adapter.mapResult !== "function") {
-        throw new PipelineDocumentError(path, "Expected adapter mapResult to be a function");
-    }
-    return {
-        items: adapter.items,
-        key: adapter.key,
-        controls: adapter.controls,
-        concurrency: adapter.concurrency,
-        progress: adapter.progress,
-        mapOptions: adapter.mapOptions,
-        mapResult: adapter.mapResult,
-    };
-}
 /**
  * Compile parsed YAML or JSON into ordinary pipelines. Does not load modules,
  * invoke handlers or schemas, or perform I/O. Graph validation belongs to core.
  */
 export function compilePipelineDocument(document, registry) {
     const parsed = validatePipelineDocument(document);
+    const resolvedRegistry = new ProjectRegistryResolver(registry);
     const compiled = new Map();
     const compiling = new Set();
     const resolvePipeline = (id, path) => {
@@ -104,112 +28,19 @@ export function compilePipelineDocument(document, registry) {
         const definition = parsed.pipelines[id];
         const path = `$.pipelines[${JSON.stringify(id)}]`;
         compiling.add(id);
-        const optionsSchema = schema(registry.optionsSchemas, definition.optionsSchema, `${path}.optionsSchema`);
-        const factory = createSteps(optionsSchema);
-        const entries = definition.steps.map((definition, index) => {
-            const stepPath = `${path}.steps[${index}]`;
-            // Populate these arrays after all steps exist, allowing forward references
-            // and leaving cycle detection to the existing definition validator.
-            const dependsOn = [];
-            const optionalDependsOn = [];
-            const skipAfterFailureOf = [];
-            const dryRun = definition.dryRun === undefined || definition.dryRun === "skip"
-                ? definition.dryRun
-                : handler(registry.steps, definition.dryRun.run, `${stepPath}.dryRun.run`);
-            const outputSchema = schema(registry.schemas, definition.outputSchema, `${stepPath}.outputSchema`);
-            const common = {
-                name: definition.name,
-                description: definition.description,
-                dependsOn,
-                optionalDependsOn,
-                skipAfterFailureOf,
-            };
-            const skip = definition.skip === undefined
-                ? undefined
-                : handler(registry.skipPredicates ?? {}, definition.skip, `${stepPath}.skip`);
-            let built;
-            if (definition.run !== undefined) {
-                const config = {
-                    ...common,
-                    dryRun,
-                    run: handler(registry.steps, definition.run, `${stepPath}.run`),
-                    skip,
-                };
-                built = outputSchema
-                    ? factory.step(definition.id, { ...config, outputSchema })
-                    : factory.step(definition.id, config);
-            }
-            else if (definition.fromPipeline !== undefined) {
-                const reference = definition.fromPipeline;
-                const adapter = fromPipelineAdapter(registry.fromPipelineAdapters, reference.adapter, `${stepPath}.fromPipeline.adapter`);
-                const config = {
-                    ...common,
-                    dryRun: definition.dryRun,
-                    pipeline: resolvePipeline(reference.pipeline, `${stepPath}.fromPipeline.pipeline`),
-                    controls: adapter.controls,
-                    mapOptions: adapter.mapOptions,
-                    skip,
-                };
-                built =
-                    adapter.mapResult === undefined
-                        ? factory.fromPipeline(definition.id, config)
-                        : factory.fromPipeline(definition.id, { ...config, mapResult: adapter.mapResult });
-            }
-            else {
-                const reference = definition.forEachPipeline;
-                const adapter = forEachPipelineAdapter(registry.forEachPipelineAdapters, reference.adapter, `${stepPath}.forEachPipeline.adapter`);
-                // SAFETY: document pipelines publish unknown values. The fan-out builder
-                // still represents a valued skip as the complete unknown result array.
-                const fanOutSkip = skip;
-                const config = {
-                    ...common,
-                    dryRun: definition.dryRun,
-                    pipeline: resolvePipeline(reference.pipeline, `${stepPath}.forEachPipeline.pipeline`),
-                    items: adapter.items,
-                    key: adapter.key,
-                    concurrency: adapter.concurrency,
-                    controls: adapter.controls,
-                    progress: adapter.progress,
-                    mapOptions: adapter.mapOptions,
-                    skip: fanOutSkip,
-                };
-                built =
-                    adapter.mapResult === undefined
-                        ? factory.forEachPipeline(definition.id, config)
-                        : factory.forEachPipeline(definition.id, { ...config, mapResult: adapter.mapResult });
-            }
-            return {
-                definition,
-                path: stepPath,
-                dependsOn,
-                optionalDependsOn,
-                skipAfterFailureOf,
-                step: built,
-            };
-        });
-        const byId = new Map(entries.map((entry) => [entry.step.id, entry.step]));
-        const resolveSteps = (ids = [], fieldPath) => ids.map((stepId, index) => {
-            const found = byId.get(stepId);
-            if (!found)
-                throw new PipelineDocumentError(`${fieldPath}[${index}]`, `Unknown step ${JSON.stringify(stepId)}`);
-            return found;
-        });
-        for (const entry of entries) {
-            for (const field of ["dependsOn", "optionalDependsOn", "skipAfterFailureOf"]) {
-                entry[field].push(...resolveSteps(entry.definition[field], `${entry.path}.${field}`));
-            }
-        }
-        const finalize = handler(registry.finalizers, definition.finalize.run, `${path}.finalize.run`);
+        const optionsSchema = resolvedRegistry.optionsSchema(definition.optionsSchema, `${path}.optionsSchema`);
+        const graph = compileDocumentSteps(definition.steps, optionsSchema, resolvedRegistry, resolvePipeline, path);
+        const finalize = resolvedRegistry.finalizer(definition.finalize.run, `${path}.finalize.run`);
         const pipeline = definePipeline({
             id,
             name: definition.name,
             description: definition.description,
-            steps: entries.map((entry) => entry.step),
-            targets: resolveSteps(definition.targets, `${path}.targets`),
-            resultSchema: schema(registry.schemas, definition.resultSchema, `${path}.resultSchema`),
+            steps: graph.steps,
+            targets: graph.resolve(definition.targets, `${path}.targets`),
+            resultSchema: resolvedRegistry.outputSchema(definition.resultSchema, `${path}.resultSchema`),
             finalize: definition.finalize.requireOutputs === undefined
                 ? finalize
-                : requireOutputs(resolveSteps(definition.finalize.requireOutputs, `${path}.finalize.requireOutputs`), finalize),
+                : requireOutputs(graph.resolve(definition.finalize.requireOutputs, `${path}.finalize.requireOutputs`), finalize),
         });
         compiled.set(id, pipeline);
         compiling.delete(id);

package/dist/project/project-compiler.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-compiler.js","sourceRoot":"","sources":["../../src/project/project-compiler.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  createSteps,\n  definePipeline,\n  requireOutputs,\n  type MappedChildProgressOptions,\n  type Pipeline,\n  type PipelineExecutionContext,\n  type PipelineRun,\n  type PipelineRunControls,\n  type PipelineStepContext,\n  type StandardSchemaV1,\n  type StepSkipDecision,\n} from \"../core/pipeline.js\";\nimport type { AnyStep } from \"../core/pipeline-steps.js\";\nimport {\n  validatePipelineDocument,\n  PipelineDocumentError,\n  type PipelineDocumentMetadata,\n} from \"./project-document.js\";\n\nexport { PipelineDocumentError };\n\n/** Immutable compiled pipelines and descriptive metadata from a parsed document. */\nexport interface CompiledPipelineDocument {\n  readonly pipelines: readonly Pipeline<object, unknown>[];\n  readonly metadata?: PipelineDocumentMetadata;\n  /** Return the shared compiled instance, or throw if the document has no such id. */\n  get(id: string): Pipeline<object, unknown>;\n}\n\n/** Dependency values are checked at runtime rather than inferred from a project document. */\ntype PipelineDocumentHandler = (\n  inputs: Record<string, unknown>,\n  context: PipelineStepContext<object>\n) => unknown;\n\ntype PipelineDocumentFinalizer = (\n  outputs: Record<string, unknown>,\n  context: PipelineExecutionContext<object>\n) => unknown;\n\ntype PipelineDocumentSkipPredicate = (\n  inputs: Record<string, unknown>,\n  context: PipelineExecutionContext<object>\n) => StepSkipDecision | Promise<StepSkipDecision>;\n\n/** Application-owned wiring for one declarative `fromPipeline` step. */\ninterface PipelineDocumentFromPipelineAdapter {\n  controls?:\n    | PipelineRunControls\n    | ((\n        inputs: Record<string, unknown>,\n        context: PipelineExecutionContext<object>\n      ) => PipelineRunControls);\n  mapOptions(inputs: Record<string, unknown>, context: PipelineExecutionContext<object>): object;\n  mapResult?(\n    value: unknown,\n    result: PipelineRun<unknown>,\n    context: PipelineStepContext<object>\n  ): unknown;\n}\n\n/** Application-owned wiring for one declarative `forEachPipeline` step. */\ninterface PipelineDocumentForEachPipelineAdapter {\n  controls?:\n    | PipelineRunControls\n    | ((\n        item: unknown,\n        index: number,\n        inputs: Record<string, unknown>,\n        context: PipelineExecutionContext<object>\n      ) => PipelineRunControls);\n  items(\n    inputs: Record<string, unknown>,\n    context: PipelineExecutionContext<object>\n  ): readonly unknown[] | Promise<readonly unknown[]>;\n  key(item: unknown, index: number): string;\n  concurrency?:\n    | number\n    | ((inputs: Record<string, unknown>, context: PipelineExecutionContext<object>) => number);\n  progress?: MappedChildProgressOptions;\n  mapOptions(\n    item: unknown,\n    index: number,\n    inputs: Record<string, unknown>,\n    context: PipelineExecutionContext<object>\n  ): object;\n  mapResult?(\n    value: unknown,\n    result: PipelineRun<unknown>,\n    item: unknown,\n    index: number,\n    context: PipelineStepContext<object>\n  ): unknown;\n}\n\n/** Only explicitly registered functions and schemas can be referenced by a document. */\nexport interface ProjectRegistry {\n  steps: Readonly<Record<string, PipelineDocumentHandler>>;\n  finalizers: Readonly<Record<string, PipelineDocumentFinalizer>>;\n  skipPredicates?: Readonly<Record<string, PipelineDocumentSkipPredicate>>;\n  fromPipelineAdapters?: Readonly<Record<string, PipelineDocumentFromPipelineAdapter>>;\n  forEachPipelineAdapters?: Readonly<Record<string, PipelineDocumentForEachPipelineAdapter>>;\n  optionsSchemas?: Readonly<Record<string, StandardSchemaV1<object, object>>>;\n  schemas?: Readonly<Record<string, StandardSchemaV1>>;\n}\n\nfunction resolve<T>(\n  registry: Readonly<Record<string, T>> | undefined,\n  name: string,\n  path: string\n): T {\n  if (!registry || !Object.hasOwn(registry, name)) {\n    throw new PipelineDocumentError(path, `Unknown registered name ${JSON.stringify(name)}`);\n  }\n  return registry[name];\n}\n\nfunction handler<T extends PipelineDocumentHandler | PipelineDocumentFinalizer>(\n  registry: Readonly<Record<string, T>>,\n  name: string,\n  path: string\n): T {\n  const value = resolve(registry, name, path);\n  if (typeof value !== \"function\")\n    throw new PipelineDocumentError(path, \"Expected a registered function\");\n  return value;\n}\n\nfunction schema<T extends StandardSchemaV1>(\n  registry: Readonly<Record<string, T>> | undefined,\n  name: string | undefined,\n  path: string\n): T | undefined {\n  if (name === undefined) return undefined;\n  const value = resolve(registry, name, path);\n  if (\n    !value ||\n    value[\"~standard\"]?.version !== 1 ||\n    typeof value[\"~standard\"].validate !== \"function\"\n  ) {\n    throw new PipelineDocumentError(path, \"Expected a Standard Schema v1 schema\");\n  }\n  return value;\n}\n\nfunction registeredObject<T extends object>(\n  registry: Readonly<Record<string, T>> | undefined,\n  name: string,\n  path: string\n): T {\n  const value = resolve(registry, name, path);\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    throw new PipelineDocumentError(path, \"Expected a registered adapter object\");\n  }\n  return value;\n}\n\nfunction fromPipelineAdapter(\n  registry: ProjectRegistry[\"fromPipelineAdapters\"],\n  name: string,\n  path: string\n): PipelineDocumentFromPipelineAdapter {\n  const adapter = registeredObject(registry, name, path);\n  if (typeof adapter.mapOptions !== \"function\") {\n    throw new PipelineDocumentError(path, \"Expected an adapter with mapOptions\");\n  }\n  if (\n    adapter.controls !== undefined &&\n    typeof adapter.controls !== \"function\" &&\n    (typeof adapter.controls !== \"object\" || adapter.controls === null)\n  ) {\n    throw new PipelineDocumentError(path, \"Expected adapter controls to be an object or function\");\n  }\n  if (adapter.mapResult !== undefined && typeof adapter.mapResult !== \"function\") {\n    throw new PipelineDocumentError(path, \"Expected adapter mapResult to be a function\");\n  }\n  return {\n    controls: adapter.controls,\n    mapOptions: adapter.mapOptions,\n    mapResult: adapter.mapResult,\n  };\n}\n\nfunction forEachPipelineAdapter(\n  registry: ProjectRegistry[\"forEachPipelineAdapters\"],\n  name: string,\n  path: string\n): PipelineDocumentForEachPipelineAdapter {\n  const adapter = registeredObject(registry, name, path);\n  if (\n    typeof adapter.items !== \"function\" ||\n    typeof adapter.key !== \"function\" ||\n    typeof adapter.mapOptions !== \"function\"\n  ) {\n    throw new PipelineDocumentError(path, \"Expected an adapter with items, key, and mapOptions\");\n  }\n  if (\n    adapter.concurrency !== undefined &&\n    typeof adapter.concurrency !== \"number\" &&\n    typeof adapter.concurrency !== \"function\"\n  ) {\n    throw new PipelineDocumentError(\n      path,\n      \"Expected adapter concurrency to be a number or function\"\n    );\n  }\n  if (\n    adapter.controls !== undefined &&\n    typeof adapter.controls !== \"function\" &&\n    (typeof adapter.controls !== \"object\" || adapter.controls === null)\n  ) {\n    throw new PipelineDocumentError(path, \"Expected adapter controls to be an object or function\");\n  }\n  if (adapter.mapResult !== undefined && typeof adapter.mapResult !== \"function\") {\n    throw new PipelineDocumentError(path, \"Expected adapter mapResult to be a function\");\n  }\n  return {\n    items: adapter.items,\n    key: adapter.key,\n    controls: adapter.controls,\n    concurrency: adapter.concurrency,\n    progress: adapter.progress,\n    mapOptions: adapter.mapOptions,\n    mapResult: adapter.mapResult,\n  };\n}\n\n/**\n * Compile parsed YAML or JSON into ordinary pipelines. Does not load modules,\n * invoke handlers or schemas, or perform I/O. Graph validation belongs to core.\n */\nexport function compilePipelineDocument(\n  document: unknown,\n  registry: ProjectRegistry\n): CompiledPipelineDocument {\n  const parsed = validatePipelineDocument(document);\n  const compiled = new Map<string, Pipeline<object, unknown>>();\n  const compiling = new Set<string>();\n\n  const resolvePipeline = (id: string, path: string): Pipeline<object, unknown> => {\n    if (!Object.hasOwn(parsed.pipelines, id)) {\n      throw new PipelineDocumentError(path, `Unknown pipeline ${JSON.stringify(id)}`);\n    }\n    if (compiling.has(id)) {\n      throw new PipelineDocumentError(\n        path,\n        `Pipeline composition cycle through ${JSON.stringify(id)}`\n      );\n    }\n    return compile(id);\n  };\n\n  const compile = (id: string): Pipeline<object, unknown> => {\n    const existing = compiled.get(id);\n    if (existing) return existing;\n    const definition = parsed.pipelines[id]!;\n    const path = `$.pipelines[${JSON.stringify(id)}]`;\n    compiling.add(id);\n    const optionsSchema = schema(\n      registry.optionsSchemas,\n      definition.optionsSchema,\n      `${path}.optionsSchema`\n    );\n    const factory = createSteps(optionsSchema);\n    const entries = definition.steps.map((definition, index) => {\n      const stepPath = `${path}.steps[${index}]`;\n      // Populate these arrays after all steps exist, allowing forward references\n      // and leaving cycle detection to the existing definition validator.\n      const dependsOn: AnyStep[] = [];\n      const optionalDependsOn: AnyStep[] = [];\n      const skipAfterFailureOf: AnyStep[] = [];\n      const dryRun =\n        definition.dryRun === undefined || definition.dryRun === \"skip\"\n          ? definition.dryRun\n          : handler(registry.steps, definition.dryRun.run, `${stepPath}.dryRun.run`);\n      const outputSchema = schema(\n        registry.schemas,\n        definition.outputSchema,\n        `${stepPath}.outputSchema`\n      );\n      const common = {\n        name: definition.name,\n        description: definition.description,\n        dependsOn,\n        optionalDependsOn,\n        skipAfterFailureOf,\n      };\n      const skip =\n        definition.skip === undefined\n          ? undefined\n          : handler(registry.skipPredicates ?? {}, definition.skip, `${stepPath}.skip`);\n      let built: AnyStep<object>;\n      if (definition.run !== undefined) {\n        const config = {\n          ...common,\n          dryRun,\n          run: handler(registry.steps, definition.run, `${stepPath}.run`),\n          skip,\n        };\n        built = outputSchema\n          ? factory.step(definition.id, { ...config, outputSchema })\n          : factory.step(definition.id, config);\n      } else if (definition.fromPipeline !== undefined) {\n        const reference = definition.fromPipeline;\n        const adapter = fromPipelineAdapter(\n          registry.fromPipelineAdapters,\n          reference.adapter,\n          `${stepPath}.fromPipeline.adapter`\n        );\n        const config = {\n          ...common,\n          dryRun: definition.dryRun,\n          pipeline: resolvePipeline(reference.pipeline, `${stepPath}.fromPipeline.pipeline`),\n          controls: adapter.controls,\n          mapOptions: adapter.mapOptions,\n          skip,\n        };\n        built =\n          adapter.mapResult === undefined\n            ? factory.fromPipeline(definition.id, config)\n            : factory.fromPipeline(definition.id, { ...config, mapResult: adapter.mapResult });\n      } else {\n        const reference = definition.forEachPipeline;\n        const adapter = forEachPipelineAdapter(\n          registry.forEachPipelineAdapters,\n          reference.adapter,\n          `${stepPath}.forEachPipeline.adapter`\n        );\n        // SAFETY: document pipelines publish unknown values. The fan-out builder\n        // still represents a valued skip as the complete unknown result array.\n        const fanOutSkip = skip as\n          | ((\n              inputs: Record<string, unknown>,\n              context: PipelineExecutionContext<object>\n            ) =>\n              | StepSkipDecision<readonly unknown[]>\n              | Promise<StepSkipDecision<readonly unknown[]>>)\n          | undefined;\n        const config = {\n          ...common,\n          dryRun: definition.dryRun,\n          pipeline: resolvePipeline(reference.pipeline, `${stepPath}.forEachPipeline.pipeline`),\n          items: adapter.items,\n          key: adapter.key,\n          concurrency: adapter.concurrency,\n          controls: adapter.controls,\n          progress: adapter.progress,\n          mapOptions: adapter.mapOptions,\n          skip: fanOutSkip,\n        };\n        built =\n          adapter.mapResult === undefined\n            ? factory.forEachPipeline(definition.id, config)\n            : factory.forEachPipeline(definition.id, { ...config, mapResult: adapter.mapResult });\n      }\n      return {\n        definition,\n        path: stepPath,\n        dependsOn,\n        optionalDependsOn,\n        skipAfterFailureOf,\n        step: built,\n      };\n    });\n    const byId = new Map(entries.map((entry) => [entry.step.id, entry.step]));\n    const resolveSteps = (ids: readonly string[] = [], fieldPath: string): AnyStep[] =>\n      ids.map((stepId, index) => {\n        const found = byId.get(stepId);\n        if (!found)\n          throw new PipelineDocumentError(\n            `${fieldPath}[${index}]`,\n            `Unknown step ${JSON.stringify(stepId)}`\n          );\n        return found;\n      });\n    for (const entry of entries) {\n      for (const field of [\"dependsOn\", \"optionalDependsOn\", \"skipAfterFailureOf\"] as const) {\n        entry[field].push(...resolveSteps(entry.definition[field], `${entry.path}.${field}`));\n      }\n    }\n    const finalize = handler(registry.finalizers, definition.finalize.run, `${path}.finalize.run`);\n    const pipeline = definePipeline({\n      id,\n      name: definition.name,\n      description: definition.description,\n      steps: entries.map((entry) => entry.step),\n      targets: resolveSteps(definition.targets, `${path}.targets`),\n      resultSchema: schema(registry.schemas, definition.resultSchema, `${path}.resultSchema`),\n      finalize:\n        definition.finalize.requireOutputs === undefined\n          ? finalize\n          : requireOutputs(\n              resolveSteps(definition.finalize.requireOutputs, `${path}.finalize.requireOutputs`),\n              finalize\n            ),\n    });\n    compiled.set(id, pipeline);\n    compiling.delete(id);\n    return pipeline;\n  };\n\n  const pipelines = Object.freeze(Object.keys(parsed.pipelines).map(compile));\n  const metadata =\n    parsed.metadata === undefined\n      ? undefined\n      : Object.freeze({\n          ...parsed.metadata,\n          authors:\n            parsed.metadata.authors === undefined\n              ? undefined\n              : Object.freeze([...parsed.metadata.authors]),\n        });\n  return Object.freeze({\n    pipelines,\n    ...(metadata === undefined ? {} : { metadata }),\n    get(id: string): Pipeline<object, unknown> {\n      const pipeline = compiled.get(id);\n      if (!pipeline) {\n        throw new Error(`Compiled document does not define pipeline ${JSON.stringify(id)}.`);\n      }\n      return pipeline;\n    },\n  });\n}\n"]}
+{"version":3,"file":"project-compiler.js","sourceRoot":"","sources":["../../src/project/project-compiler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAiB,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,uBAAuB,EAAwB,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EACL,wBAAwB,EACxB,qBAAqB,GAEtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAWjC;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAiB,EACjB,QAAyB;IAEzB,MAAM,MAAM,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,gBAAgB,GAAG,IAAI,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAqC,CAAC;IAC9D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAEpC,MAAM,eAAe,GAAG,CAAC,EAAU,EAAE,IAAY,EAA6B,EAAE;QAC9E,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,qBAAqB,CAC7B,IAAI,EACJ,sCAAsC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAC3D,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC,EAAE,CAAC,CAAC;IACrB,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,EAAU,EAA6B,EAAE;QACxD,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,EAAE,CAAE,CAAC;QACzC,MAAM,IAAI,GAAG,eAAe,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC;QAClD,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,MAAM,aAAa,GAAG,gBAAgB,CAAC,aAAa,CAClD,UAAU,CAAC,aAAa,EACxB,GAAG,IAAI,gBAAgB,CACxB,CAAC;QACF,MAAM,KAAK,GAAG,oBAAoB,CAChC,UAAU,CAAC,KAAK,EAChB,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,IAAI,CACL,CAAC;QACF,MAAM,QAAQ,GAAG,gBAAgB,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,IAAI,eAAe,CAAC,CAAC;QAC7F,MAAM,QAAQ,GAAG,cAAc,CAAC;YAC9B,EAAE;YACF,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,WAAW,EAAE,UAAU,CAAC,WAAW;YACnC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,IAAI,UAAU,CAAC;YAC7D,YAAY,EAAE,gBAAgB,CAAC,YAAY,CAAC,UAAU,CAAC,YAAY,EAAE,GAAG,IAAI,eAAe,CAAC;YAC5F,QAAQ,EACN,UAAU,CAAC,QAAQ,CAAC,cAAc,KAAK,SAAS;gBAC9C,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAC,cAAc,CACZ,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,cAAc,EAAE,GAAG,IAAI,0BAA0B,CAAC,EACpF,QAAQ,CACT;SACR,CAAC,CAAC;QACH,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC3B,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5E,MAAM,QAAQ,GACZ,MAAM,CAAC,QAAQ,KAAK,SAAS;QAC3B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;YACZ,GAAG,MAAM,CAAC,QAAQ;YAClB,OAAO,EACL,MAAM,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS;gBACnC,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;SAClD,CAAC,CAAC;IACT,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS;QACT,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;QAC/C,GAAG,CAAC,EAAU;YACZ,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,8CAA8C,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;YACvF,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { definePipeline, requireOutputs, type Pipeline } from \"../core/pipeline.js\";\nimport { ProjectRegistryResolver, type ProjectRegistry } from \"./project-registry.js\";\nimport { compileDocumentSteps } from \"./project-step-graph.js\";\nimport {\n  validatePipelineDocument,\n  PipelineDocumentError,\n  type PipelineDocumentMetadata,\n} from \"./project-document.js\";\n\nexport { PipelineDocumentError };\nexport type { ProjectRegistry } from \"./project-registry.js\";\n\n/** Immutable compiled pipelines and descriptive metadata from a parsed document. */\nexport interface CompiledPipelineDocument {\n  readonly pipelines: readonly Pipeline<object, unknown>[];\n  readonly metadata?: PipelineDocumentMetadata;\n  /** Return the shared compiled instance, or throw if the document has no such id. */\n  get(id: string): Pipeline<object, unknown>;\n}\n\n/**\n * Compile parsed YAML or JSON into ordinary pipelines. Does not load modules,\n * invoke handlers or schemas, or perform I/O. Graph validation belongs to core.\n */\nexport function compilePipelineDocument(\n  document: unknown,\n  registry: ProjectRegistry\n): CompiledPipelineDocument {\n  const parsed = validatePipelineDocument(document);\n  const resolvedRegistry = new ProjectRegistryResolver(registry);\n  const compiled = new Map<string, Pipeline<object, unknown>>();\n  const compiling = new Set<string>();\n\n  const resolvePipeline = (id: string, path: string): Pipeline<object, unknown> => {\n    if (!Object.hasOwn(parsed.pipelines, id)) {\n      throw new PipelineDocumentError(path, `Unknown pipeline ${JSON.stringify(id)}`);\n    }\n    if (compiling.has(id)) {\n      throw new PipelineDocumentError(\n        path,\n        `Pipeline composition cycle through ${JSON.stringify(id)}`\n      );\n    }\n    return compile(id);\n  };\n\n  const compile = (id: string): Pipeline<object, unknown> => {\n    const existing = compiled.get(id);\n    if (existing) return existing;\n    const definition = parsed.pipelines[id]!;\n    const path = `$.pipelines[${JSON.stringify(id)}]`;\n    compiling.add(id);\n    const optionsSchema = resolvedRegistry.optionsSchema(\n      definition.optionsSchema,\n      `${path}.optionsSchema`\n    );\n    const graph = compileDocumentSteps(\n      definition.steps,\n      optionsSchema,\n      resolvedRegistry,\n      resolvePipeline,\n      path\n    );\n    const finalize = resolvedRegistry.finalizer(definition.finalize.run, `${path}.finalize.run`);\n    const pipeline = definePipeline({\n      id,\n      name: definition.name,\n      description: definition.description,\n      steps: graph.steps,\n      targets: graph.resolve(definition.targets, `${path}.targets`),\n      resultSchema: resolvedRegistry.outputSchema(definition.resultSchema, `${path}.resultSchema`),\n      finalize:\n        definition.finalize.requireOutputs === undefined\n          ? finalize\n          : requireOutputs(\n              graph.resolve(definition.finalize.requireOutputs, `${path}.finalize.requireOutputs`),\n              finalize\n            ),\n    });\n    compiled.set(id, pipeline);\n    compiling.delete(id);\n    return pipeline;\n  };\n\n  const pipelines = Object.freeze(Object.keys(parsed.pipelines).map(compile));\n  const metadata =\n    parsed.metadata === undefined\n      ? undefined\n      : Object.freeze({\n          ...parsed.metadata,\n          authors:\n            parsed.metadata.authors === undefined\n              ? undefined\n              : Object.freeze([...parsed.metadata.authors]),\n        });\n  return Object.freeze({\n    pipelines,\n    ...(metadata === undefined ? {} : { metadata }),\n    get(id: string): Pipeline<object, unknown> {\n      const pipeline = compiled.get(id);\n      if (!pipeline) {\n        throw new Error(`Compiled document does not define pipeline ${JSON.stringify(id)}.`);\n      }\n      return pipeline;\n    },\n  });\n}\n"]}

package/dist/project/project-registry.d.ts

@@ -0,0 +1,44 @@
+import type { MappedChildProgressOptions, PipelineExecutionContext, PipelineRun, PipelineRunControls, PipelineStepContext, StandardSchemaV1, StepSkipDecision } from "../core/pipeline.js";
+/** Dependency values are checked at runtime rather than inferred from a project document. */
+type PipelineDocumentHandler = (inputs: Record<string, unknown>, context: PipelineStepContext<object>) => unknown;
+type PipelineDocumentFinalizer = (outputs: Record<string, unknown>, context: PipelineExecutionContext<object>) => unknown;
+type PipelineDocumentSkipPredicate = (inputs: Record<string, unknown>, context: PipelineExecutionContext<object>) => StepSkipDecision | Promise<StepSkipDecision>;
+/** Application-owned wiring for one declarative `fromPipeline` step. */
+interface PipelineDocumentFromPipelineAdapter {
+    controls?: PipelineRunControls | ((inputs: Record<string, unknown>, context: PipelineExecutionContext<object>) => PipelineRunControls);
+    mapOptions(inputs: Record<string, unknown>, context: PipelineExecutionContext<object>): object;
+    mapResult?(value: unknown, result: PipelineRun<unknown>, context: PipelineStepContext<object>): unknown;
+}
+/** Application-owned wiring for one declarative `forEachPipeline` step. */
+interface PipelineDocumentForEachPipelineAdapter {
+    controls?: PipelineRunControls | ((item: unknown, index: number, inputs: Record<string, unknown>, context: PipelineExecutionContext<object>) => PipelineRunControls);
+    items(inputs: Record<string, unknown>, context: PipelineExecutionContext<object>): readonly unknown[] | Promise<readonly unknown[]>;
+    key(item: unknown, index: number): string;
+    concurrency?: number | ((inputs: Record<string, unknown>, context: PipelineExecutionContext<object>) => number);
+    progress?: MappedChildProgressOptions;
+    mapOptions(item: unknown, index: number, inputs: Record<string, unknown>, context: PipelineExecutionContext<object>): object;
+    mapResult?(value: unknown, result: PipelineRun<unknown>, item: unknown, index: number, context: PipelineStepContext<object>): unknown;
+}
+/** Only explicitly registered functions and schemas can be referenced by a document. */
+export interface ProjectRegistry {
+    steps: Readonly<Record<string, PipelineDocumentHandler>>;
+    finalizers: Readonly<Record<string, PipelineDocumentFinalizer>>;
+    skipPredicates?: Readonly<Record<string, PipelineDocumentSkipPredicate>>;
+    fromPipelineAdapters?: Readonly<Record<string, PipelineDocumentFromPipelineAdapter>>;
+    forEachPipelineAdapters?: Readonly<Record<string, PipelineDocumentForEachPipelineAdapter>>;
+    optionsSchemas?: Readonly<Record<string, StandardSchemaV1<object, object>>>;
+    schemas?: Readonly<Record<string, StandardSchemaV1>>;
+}
+/** Resolve application wiring without constructing pipelines or invoking application code. */
+export declare class ProjectRegistryResolver {
+    #private;
+    constructor(registry: ProjectRegistry);
+    step(name: string, path: string): PipelineDocumentHandler;
+    finalizer(name: string, path: string): PipelineDocumentFinalizer;
+    skip(name: string | undefined, path: string): PipelineDocumentSkipPredicate | undefined;
+    optionsSchema(name: string | undefined, path: string): StandardSchemaV1<object, object> | undefined;
+    outputSchema(name: string | undefined, path: string): StandardSchemaV1 | undefined;
+    singleChild(name: string, path: string): PipelineDocumentFromPipelineAdapter;
+    mappedChild(name: string, path: string): PipelineDocumentForEachPipelineAdapter;
+}
+export {};

package/dist/project/project-registry.js

@@ -0,0 +1,107 @@
+import { PipelineDocumentError } from "./project-document.js";
+function resolve(registry, name, path) {
+    if (!registry || !Object.hasOwn(registry, name)) {
+        throw new PipelineDocumentError(path, `Unknown registered name ${JSON.stringify(name)}`);
+    }
+    return registry[name];
+}
+function handler(registry, name, path) {
+    const value = resolve(registry, name, path);
+    if (typeof value !== "function")
+        throw new PipelineDocumentError(path, "Expected a registered function");
+    return value;
+}
+function schema(registry, name, path) {
+    if (name === undefined)
+        return undefined;
+    const value = resolve(registry, name, path);
+    if (!value ||
+        value["~standard"]?.version !== 1 ||
+        typeof value["~standard"].validate !== "function") {
+        throw new PipelineDocumentError(path, "Expected a Standard Schema v1 schema");
+    }
+    return value;
+}
+function registeredObject(registry, name, path) {
+    const value = resolve(registry, name, path);
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new PipelineDocumentError(path, "Expected a registered adapter object");
+    }
+    return value;
+}
+function validateAdapterMapping(adapter, path) {
+    if (adapter.controls !== undefined &&
+        typeof adapter.controls !== "function" &&
+        (typeof adapter.controls !== "object" || adapter.controls === null)) {
+        throw new PipelineDocumentError(path, "Expected adapter controls to be an object or function");
+    }
+    if (adapter.mapResult !== undefined && typeof adapter.mapResult !== "function") {
+        throw new PipelineDocumentError(path, "Expected adapter mapResult to be a function");
+    }
+}
+function fromPipelineAdapter(registry, name, path) {
+    const adapter = registeredObject(registry, name, path);
+    if (typeof adapter.mapOptions !== "function") {
+        throw new PipelineDocumentError(path, "Expected an adapter with mapOptions");
+    }
+    validateAdapterMapping(adapter, path);
+    return {
+        controls: adapter.controls,
+        mapOptions: adapter.mapOptions,
+        mapResult: adapter.mapResult,
+    };
+}
+function forEachPipelineAdapter(registry, name, path) {
+    const adapter = registeredObject(registry, name, path);
+    if (typeof adapter.items !== "function" ||
+        typeof adapter.key !== "function" ||
+        typeof adapter.mapOptions !== "function") {
+        throw new PipelineDocumentError(path, "Expected an adapter with items, key, and mapOptions");
+    }
+    if (adapter.concurrency !== undefined &&
+        typeof adapter.concurrency !== "number" &&
+        typeof adapter.concurrency !== "function") {
+        throw new PipelineDocumentError(path, "Expected adapter concurrency to be a number or function");
+    }
+    validateAdapterMapping(adapter, path);
+    return {
+        items: adapter.items,
+        key: adapter.key,
+        controls: adapter.controls,
+        concurrency: adapter.concurrency,
+        progress: adapter.progress,
+        mapOptions: adapter.mapOptions,
+        mapResult: adapter.mapResult,
+    };
+}
+/** Resolve application wiring without constructing pipelines or invoking application code. */
+export class ProjectRegistryResolver {
+    #registry;
+    constructor(registry) {
+        this.#registry = registry;
+    }
+    step(name, path) {
+        return handler(this.#registry.steps, name, path);
+    }
+    finalizer(name, path) {
+        return handler(this.#registry.finalizers, name, path);
+    }
+    skip(name, path) {
+        return name === undefined
+            ? undefined
+            : handler(this.#registry.skipPredicates ?? {}, name, path);
+    }
+    optionsSchema(name, path) {
+        return schema(this.#registry.optionsSchemas, name, path);
+    }
+    outputSchema(name, path) {
+        return schema(this.#registry.schemas, name, path);
+    }
+    singleChild(name, path) {
+        return fromPipelineAdapter(this.#registry.fromPipelineAdapters, name, path);
+    }
+    mappedChild(name, path) {
+        return forEachPipelineAdapter(this.#registry.forEachPipelineAdapters, name, path);
+    }
+}
+//# sourceMappingURL=project-registry.js.map

package/dist/project/project-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-registry.js","sourceRoot":"","sources":["../../src/project/project-registry.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  MappedChildProgressOptions,\n  PipelineExecutionContext,\n  PipelineRun,\n  PipelineRunControls,\n  PipelineStepContext,\n  StandardSchemaV1,\n  StepSkipDecision,\n} from \"../core/pipeline.js\";\nimport { PipelineDocumentError } from \"./project-document.js\";\n\n/** Dependency values are checked at runtime rather than inferred from a project document. */\ntype PipelineDocumentHandler = (\n  inputs: Record<string, unknown>,\n  context: PipelineStepContext<object>\n) => unknown;\n\ntype PipelineDocumentFinalizer = (\n  outputs: Record<string, unknown>,\n  context: PipelineExecutionContext<object>\n) => unknown;\n\ntype PipelineDocumentSkipPredicate = (\n  inputs: Record<string, unknown>,\n  context: PipelineExecutionContext<object>\n) => StepSkipDecision | Promise<StepSkipDecision>;\n\n/** Application-owned wiring for one declarative `fromPipeline` step. */\ninterface PipelineDocumentFromPipelineAdapter {\n  controls?:\n    | PipelineRunControls\n    | ((\n        inputs: Record<string, unknown>,\n        context: PipelineExecutionContext<object>\n      ) => PipelineRunControls);\n  mapOptions(inputs: Record<string, unknown>, context: PipelineExecutionContext<object>): object;\n  mapResult?(\n    value: unknown,\n    result: PipelineRun<unknown>,\n    context: PipelineStepContext<object>\n  ): unknown;\n}\n\n/** Application-owned wiring for one declarative `forEachPipeline` step. */\ninterface PipelineDocumentForEachPipelineAdapter {\n  controls?:\n    | PipelineRunControls\n    | ((\n        item: unknown,\n        index: number,\n        inputs: Record<string, unknown>,\n        context: PipelineExecutionContext<object>\n      ) => PipelineRunControls);\n  items(\n    inputs: Record<string, unknown>,\n    context: PipelineExecutionContext<object>\n  ): readonly unknown[] | Promise<readonly unknown[]>;\n  key(item: unknown, index: number): string;\n  concurrency?:\n    | number\n    | ((inputs: Record<string, unknown>, context: PipelineExecutionContext<object>) => number);\n  progress?: MappedChildProgressOptions;\n  mapOptions(\n    item: unknown,\n    index: number,\n    inputs: Record<string, unknown>,\n    context: PipelineExecutionContext<object>\n  ): object;\n  mapResult?(\n    value: unknown,\n    result: PipelineRun<unknown>,\n    item: unknown,\n    index: number,\n    context: PipelineStepContext<object>\n  ): unknown;\n}\n\n/** Only explicitly registered functions and schemas can be referenced by a document. */\nexport interface ProjectRegistry {\n  steps: Readonly<Record<string, PipelineDocumentHandler>>;\n  finalizers: Readonly<Record<string, PipelineDocumentFinalizer>>;\n  skipPredicates?: Readonly<Record<string, PipelineDocumentSkipPredicate>>;\n  fromPipelineAdapters?: Readonly<Record<string, PipelineDocumentFromPipelineAdapter>>;\n  forEachPipelineAdapters?: Readonly<Record<string, PipelineDocumentForEachPipelineAdapter>>;\n  optionsSchemas?: Readonly<Record<string, StandardSchemaV1<object, object>>>;\n  schemas?: Readonly<Record<string, StandardSchemaV1>>;\n}\n\nfunction resolve<T>(\n  registry: Readonly<Record<string, T>> | undefined,\n  name: string,\n  path: string\n): T {\n  if (!registry || !Object.hasOwn(registry, name)) {\n    throw new PipelineDocumentError(path, `Unknown registered name ${JSON.stringify(name)}`);\n  }\n  return registry[name];\n}\n\nfunction handler<T extends PipelineDocumentHandler | PipelineDocumentFinalizer>(\n  registry: Readonly<Record<string, T>>,\n  name: string,\n  path: string\n): T {\n  const value = resolve(registry, name, path);\n  if (typeof value !== \"function\")\n    throw new PipelineDocumentError(path, \"Expected a registered function\");\n  return value;\n}\n\nfunction schema<T extends StandardSchemaV1>(\n  registry: Readonly<Record<string, T>> | undefined,\n  name: string | undefined,\n  path: string\n): T | undefined {\n  if (name === undefined) return undefined;\n  const value = resolve(registry, name, path);\n  if (\n    !value ||\n    value[\"~standard\"]?.version !== 1 ||\n    typeof value[\"~standard\"].validate !== \"function\"\n  ) {\n    throw new PipelineDocumentError(path, \"Expected a Standard Schema v1 schema\");\n  }\n  return value;\n}\n\nfunction registeredObject<T extends object>(\n  registry: Readonly<Record<string, T>> | undefined,\n  name: string,\n  path: string\n): T {\n  const value = resolve(registry, name, path);\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    throw new PipelineDocumentError(path, \"Expected a registered adapter object\");\n  }\n  return value;\n}\n\nfunction validateAdapterMapping(\n  adapter: { controls?: unknown; mapResult?: unknown },\n  path: string\n): void {\n  if (\n    adapter.controls !== undefined &&\n    typeof adapter.controls !== \"function\" &&\n    (typeof adapter.controls !== \"object\" || adapter.controls === null)\n  ) {\n    throw new PipelineDocumentError(path, \"Expected adapter controls to be an object or function\");\n  }\n  if (adapter.mapResult !== undefined && typeof adapter.mapResult !== \"function\") {\n    throw new PipelineDocumentError(path, \"Expected adapter mapResult to be a function\");\n  }\n}\n\nfunction fromPipelineAdapter(\n  registry: ProjectRegistry[\"fromPipelineAdapters\"],\n  name: string,\n  path: string\n): PipelineDocumentFromPipelineAdapter {\n  const adapter = registeredObject(registry, name, path);\n  if (typeof adapter.mapOptions !== \"function\") {\n    throw new PipelineDocumentError(path, \"Expected an adapter with mapOptions\");\n  }\n  validateAdapterMapping(adapter, path);\n  return {\n    controls: adapter.controls,\n    mapOptions: adapter.mapOptions,\n    mapResult: adapter.mapResult,\n  };\n}\n\nfunction forEachPipelineAdapter(\n  registry: ProjectRegistry[\"forEachPipelineAdapters\"],\n  name: string,\n  path: string\n): PipelineDocumentForEachPipelineAdapter {\n  const adapter = registeredObject(registry, name, path);\n  if (\n    typeof adapter.items !== \"function\" ||\n    typeof adapter.key !== \"function\" ||\n    typeof adapter.mapOptions !== \"function\"\n  ) {\n    throw new PipelineDocumentError(path, \"Expected an adapter with items, key, and mapOptions\");\n  }\n  if (\n    adapter.concurrency !== undefined &&\n    typeof adapter.concurrency !== \"number\" &&\n    typeof adapter.concurrency !== \"function\"\n  ) {\n    throw new PipelineDocumentError(\n      path,\n      \"Expected adapter concurrency to be a number or function\"\n    );\n  }\n  validateAdapterMapping(adapter, path);\n  return {\n    items: adapter.items,\n    key: adapter.key,\n    controls: adapter.controls,\n    concurrency: adapter.concurrency,\n    progress: adapter.progress,\n    mapOptions: adapter.mapOptions,\n    mapResult: adapter.mapResult,\n  };\n}\n\n/** Resolve application wiring without constructing pipelines or invoking application code. */\nexport class ProjectRegistryResolver {\n  readonly #registry: ProjectRegistry;\n\n  constructor(registry: ProjectRegistry) {\n    this.#registry = registry;\n  }\n\n  step(name: string, path: string): PipelineDocumentHandler {\n    return handler(this.#registry.steps, name, path);\n  }\n\n  finalizer(name: string, path: string): PipelineDocumentFinalizer {\n    return handler(this.#registry.finalizers, name, path);\n  }\n\n  skip(name: string | undefined, path: string): PipelineDocumentSkipPredicate | undefined {\n    return name === undefined\n      ? undefined\n      : handler(this.#registry.skipPredicates ?? {}, name, path);\n  }\n\n  optionsSchema(\n    name: string | undefined,\n    path: string\n  ): StandardSchemaV1<object, object> | undefined {\n    return schema(this.#registry.optionsSchemas, name, path);\n  }\n\n  outputSchema(name: string | undefined, path: string): StandardSchemaV1 | undefined {\n    return schema(this.#registry.schemas, name, path);\n  }\n\n  singleChild(name: string, path: string): PipelineDocumentFromPipelineAdapter {\n    return fromPipelineAdapter(this.#registry.fromPipelineAdapters, name, path);\n  }\n\n  mappedChild(name: string, path: string): PipelineDocumentForEachPipelineAdapter {\n    return forEachPipelineAdapter(this.#registry.forEachPipelineAdapters, name, path);\n  }\n}\n"]}

package/dist/project/project-step-graph.d.ts

@@ -0,0 +1,9 @@
+import { type Pipeline, type StandardSchemaV1 } from "../core/pipeline.js";
+import type { AnyStep } from "../core/pipeline-steps.js";
+import { type PipelineDocumentStep } from "./project-document.js";
+import type { ProjectRegistryResolver } from "./project-registry.js";
+/** Build and link one document's step graph; mutable forward-reference arrays stay local. */
+export declare function compileDocumentSteps(definitions: readonly PipelineDocumentStep[], optionsSchema: StandardSchemaV1<object, object> | undefined, registry: ProjectRegistryResolver, resolvePipeline: (id: string, path: string) => Pipeline<object, unknown>, path: string): {
+    readonly steps: readonly AnyStep[];
+    resolve(ids: readonly string[] | undefined, fieldPath: string): AnyStep[];
+};