tubeless 0.2.13 → 0.2.15

package/README.md

@@ -21,7 +21,7 @@ cycling kind of tubeless: no inner tube, and no extra runtime to keep the work r
 
 Pipelines run in your process with no runtime dependencies. You can preview
 execution, select a target and its dependencies, compose child pipelines, and
-track progress. An optional CLI and local studio help you run and inspect jobs.
+track progress. The optional CLI and [Studio](./docs/studio.md) run locally or behind your authenticated admin gateway.
 For scheduling or crash recovery, pair it with a [queue or workflow engine](./docs/comparison.md).
 
 ## Installation

package/dist/cli/cli-pipeline-command.d.ts

@@ -1,6 +1,6 @@
 import { type InferredCliParams, type InferredFlagOverrides } from "./cli-schema.js";
 import type { CliBooleanParam, CliCheckpointConfig, CliCommandDescriptor, CliContext, CliNumberParam, CliParams, CliParamsSchema, CliStringParam } from "./cli-types.js";
-import { type Pipeline, type PipelineHooks, type PipelineInput, type PipelineMermaidOptions, type PipelinePlan, type PipelineResult, type StandardSchemaV1 } from "../core/pipeline.js";
+import { type Pipeline, type PipelineHooks, type PipelineInput, type PipelineMermaidOptions, type StepCachePolicy, type PipelinePlan, type PipelineResult, type StandardSchemaV1 } from "../core/pipeline.js";
 import { type PipelineReporterConfig } from "../reporter/reporter-entry.js";
 export type PipelineCliBuiltins = {
     stepIds: CliStringParam & {
@@ -11,6 +11,10 @@ export type PipelineCliBuiltins = {
     };
     continueOnError: CliBooleanParam;
     maxConcurrency: CliNumberParam;
+    cache: CliStringParam & {
+        choices: readonly ["use", "recompute", "bypass"];
+        optional: true;
+    };
 };
 /** Validated domain parameters plus the built-in pipeline execution controls. */
 export type PipelineCliValues<TSchema extends CliParamsSchema> = CliParams<TSchema> & {
@@ -18,6 +22,7 @@ export type PipelineCliValues<TSchema extends CliParamsSchema> = CliParams<TSche
     targets: readonly string[];
     continueOnError: boolean;
     maxConcurrency: number;
+    cache?: StepCachePolicy;
 };
 /** Parse result returned by commands created with `definePipelineCommand`. */
 export type PipelineCliParseResult<TSchema extends CliParamsSchema> = {
@@ -64,7 +69,7 @@ type PipelineCommandHookSets<TResult> = PipelineHooks<TResult> | readonly Pipeli
 /** Static or lazily constructed lifecycle hooks for a pipeline command. */
 export type PipelineCommandHookConfig<TResult, TSchema extends CliParamsSchema> = PipelineCommandHookSets<TResult> | ((input: PipelineCommandHookContext<TSchema>) => PipelineCommandHookSets<TResult> | undefined);
 type PipelineCommandMapOptions<TOptions extends object, TSchema extends CliParamsSchema> = (values: PipelineCliValues<TSchema>, context: CliContext) => TOptions | Promise<TOptions>;
-type DefaultPipelineCommandOptions<TSchema extends CliParamsSchema> = Omit<PipelineCliValues<TSchema>, "continueOnError" | "maxConcurrency" | "dryRun" | "resume" | "stepIds" | "targets">;
+type DefaultPipelineCommandOptions<TSchema extends CliParamsSchema> = Omit<PipelineCliValues<TSchema>, "cache" | "continueOnError" | "maxConcurrency" | "dryRun" | "resume" | "stepIds" | "targets">;
 type CanDefaultPipelineCommandOptions<TOptions extends object, TSchema extends CliParamsSchema> = DefaultPipelineCommandOptions<TSchema> extends TOptions ? Exclude<keyof TSchema, keyof TOptions> extends never ? true : false : false;
 interface DefinePipelineCommandConfigBase<TResult, TSchema extends CliParamsSchema> {
     /** Defaults to pipeline.name, then pipeline.id. */

package/dist/cli/cli-pipeline-command.js

@@ -5,8 +5,20 @@ import { markPipelineCommand } from "../utilities/pipeline-command-marker.js";
 import {} from "../core/pipeline.js";
 import { createPipelineReporter } from "../reporter/reporter-entry.js";
 import { TUBELESS_WORKBENCH_EXIT_CODE } from "./cli-exit.js";
-const PIPELINE_COMMAND_KEYS = new Set(["continueOnError", "maxConcurrency", "stepIds", "targets"]);
-const PIPELINE_COMMAND_FLAGS = new Set(["continue-on-error", "max-concurrency", "step", "target"]);
+const PIPELINE_COMMAND_KEYS = new Set([
+    "cache",
+    "continueOnError",
+    "maxConcurrency",
+    "stepIds",
+    "targets",
+]);
+const PIPELINE_COMMAND_FLAGS = new Set([
+    "cache",
+    "continue-on-error",
+    "max-concurrency",
+    "step",
+    "target",
+]);
 function assertNoPipelineCommandConflicts(params) {
     for (const [key, param] of Object.entries(params)) {
         if (PIPELINE_COMMAND_KEYS.has(key)) {
@@ -36,6 +48,7 @@ function pipelineRunControlsFromCliValues(values) {
         dryRun: values.dryRun,
         continueOnError: values.continueOnError,
         maxConcurrency: values.maxConcurrency,
+        ...(values.cache !== undefined ? { cache: values.cache } : {}),
     };
     if (values.stepIds.length > 0)
         controls.stepIds = values.stepIds;
@@ -53,7 +66,7 @@ function isHookConfigFunction(config) {
     return typeof config === "function";
 }
 function defaultPipelineCommandOptions(values) {
-    const { continueOnError: _continueOnError, maxConcurrency: _maxConcurrency, dryRun: _dryRun, resume: _resume, stepIds: _stepIds, targets: _targets, ...domainValues } = values;
+    const { cache: _cache, continueOnError: _continueOnError, maxConcurrency: _maxConcurrency, dryRun: _dryRun, resume: _resume, stepIds: _stepIds, targets: _targets, ...domainValues } = values;
     return domainValues;
 }
 function nonBlankPipelineText(value) {
@@ -72,6 +85,13 @@ export function definePipelineCommand(pipeline, config = {}) {
     assertNoPipelineCommandConflicts(userParams);
     const targetFlagEnabled = pipeline.targetIds.length > 0;
     const bridgeParams = {
+        cache: {
+            type: "string",
+            choices: ["use", "recompute", "bypass"],
+            optional: true,
+            group: "execution",
+            description: "Override the cache policy for opted-in steps, including child pipelines.",
+        },
         stepIds: {
             type: "string",
             multiple: true,
@@ -141,6 +161,7 @@ export function definePipelineCommand(pipeline, config = {}) {
                 dryRun: values.dryRun,
                 continueOnError: pipelineValues.continueOnError,
                 maxConcurrency: pipelineValues.maxConcurrency,
+                cache: pipelineValues.cache,
                 stepIds: pipelineValues.stepIds,
                 targets: targetFlagEnabled ? pipelineValues.targets : [],
             });

package/dist/cli/cli-pipeline-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-pipeline-command.js","sourceRoot":"","sources":["../../src/cli/cli-pipeline-command.ts"],"names":[],"mappings":"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","sourcesContent":["import { createCommand } from \"./cli-command.js\";\nimport { flagName } from \"./cli-parser.js\";\nimport {\n  inferCliParams,\n  type InferredCliParams,\n  type InferredFlagOverrides,\n} from \"./cli-schema.js\";\nimport type {\n  CliBooleanParam,\n  CliCheckpointConfig,\n  CliCommandConfig,\n  CliCommandDescriptor,\n  CliContext,\n  CliNumberParam,\n  CliParams,\n  CliParamsSchema,\n  CliStringParam,\n} from \"./cli-types.js\";\nimport { markPipelineCommand } from \"../utilities/pipeline-command-marker.js\";\nimport {\n  type Pipeline,\n  type PipelineHooks,\n  type PipelineInput,\n  type PipelineMermaidOptions,\n  type PipelinePlan,\n  type PipelineResult,\n  type PipelineRunControls,\n  type StandardSchemaV1,\n} from \"../core/pipeline.js\";\nimport { createPipelineReporter, type PipelineReporterConfig } from \"../reporter/reporter-entry.js\";\nimport { TUBELESS_WORKBENCH_EXIT_CODE } from \"./cli-exit.js\";\n\nexport type PipelineCliBuiltins = {\n  stepIds: CliStringParam & { multiple: true };\n  targets: CliStringParam & { multiple: true };\n  continueOnError: CliBooleanParam;\n  maxConcurrency: CliNumberParam;\n};\n\n/** Validated domain parameters plus the built-in pipeline execution controls. */\nexport type PipelineCliValues<TSchema extends CliParamsSchema> = CliParams<TSchema> & {\n  stepIds: readonly string[];\n  targets: readonly string[];\n  continueOnError: boolean;\n  maxConcurrency: number;\n};\n\n/** Parse result returned by commands created with `definePipelineCommand`. */\nexport type PipelineCliParseResult<TSchema extends CliParamsSchema> =\n  | { kind: \"values\"; values: PipelineCliValues<TSchema> }\n  | { kind: \"help\"; helpText: string }\n  | { kind: \"error\"; errors: readonly string[]; helpText: string };\n\n/** Typed CLI facade over a pipeline with planning and graph helpers. */\nexport interface PipelineCommand<\n  TSchema extends CliParamsSchema,\n  TResult,\n  TPipeline extends Pipeline<object, unknown> = Pipeline<object, TResult>,\n> {\n  /** Exact pipeline adapted by this command. */\n  readonly pipeline: TPipeline;\n  readonly descriptor: CliCommandDescriptor;\n  /** Stable identity of the wrapped pipeline. */\n  readonly id: TPipeline[\"id\"];\n  /** Stable definition-order step ids for discovery surfaces such as CLI help. */\n  readonly stepIds: TPipeline[\"stepIds\"];\n  /** Stable declared goal ids that support dependency-aware target execution. */\n  readonly targetIds: TPipeline[\"targetIds\"];\n  /** Plan without parsing or requiring domain parameters. */\n  plan(controls?: Parameters<TPipeline[\"plan\"]>[0]): PipelinePlan;\n  /** Generate a static Mermaid flowchart without running or planning the pipeline. */\n  toMermaid(options?: PipelineMermaidOptions): string;\n  parse(argv?: readonly string[], context?: Partial<CliContext>): PipelineCliParseResult<TSchema>;\n  /** Validate structured form values without tokenizing argv. */\n  parseValues(\n    values: Record<string, unknown>,\n    context?: Partial<CliContext>\n  ): PipelineCliParseResult<TSchema>;\n  /** Execute already validated form values. */\n  execute(values: PipelineCliValues<TSchema>, context?: Partial<CliContext>): Promise<TResult>;\n  run(argv?: readonly string[], context?: Partial<CliContext>): Promise<TResult>;\n  main(argv?: readonly string[], context?: Partial<CliContext>): Promise<void>;\n}\n\n/** Parsed values and CLI services passed to a pipeline hook factory. */\nexport interface PipelineCommandHookContext<TSchema extends CliParamsSchema> {\n  context: CliContext;\n  values: PipelineCliValues<TSchema>;\n}\n\n/** One lifecycle hook set or an ordered collection of hook sets. */\ntype PipelineCommandHookSets<TResult> = PipelineHooks<TResult> | readonly PipelineHooks<TResult>[];\n\n/** Static or lazily constructed lifecycle hooks for a pipeline command. */\nexport type PipelineCommandHookConfig<TResult, TSchema extends CliParamsSchema> =\n  | PipelineCommandHookSets<TResult>\n  | ((input: PipelineCommandHookContext<TSchema>) => PipelineCommandHookSets<TResult> | undefined);\n\ntype PipelineCommandMapOptions<TOptions extends object, TSchema extends CliParamsSchema> = (\n  values: PipelineCliValues<TSchema>,\n  context: CliContext\n) => TOptions | Promise<TOptions>;\n\ntype DefaultPipelineCommandOptions<TSchema extends CliParamsSchema> = Omit<\n  PipelineCliValues<TSchema>,\n  \"continueOnError\" | \"maxConcurrency\" | \"dryRun\" | \"resume\" | \"stepIds\" | \"targets\"\n>;\n\ntype CanDefaultPipelineCommandOptions<TOptions extends object, TSchema extends CliParamsSchema> =\n  DefaultPipelineCommandOptions<TSchema> extends TOptions\n    ? Exclude<keyof TSchema, keyof TOptions> extends never\n      ? true\n      : false\n    : false;\n\ninterface DefinePipelineCommandConfigBase<TResult, TSchema extends CliParamsSchema> {\n  /** Defaults to pipeline.name, then pipeline.id. */\n  name?: string;\n  /** Defaults to pipeline.description. */\n  description?: string;\n  /** Advanced: replace inferred flags for type-only pipelines or custom CLI inputs. */\n  params?: TSchema;\n  /** Extra parameter keys accepted in positional order. */\n  positionals?: readonly (keyof TSchema & string)[];\n  checkpoint?: CliCheckpointConfig;\n  /** Expose resume input for application-owned handling without managed checkpointing. */\n  resume?: true;\n  /** Additional lifecycle hooks, or a factory resolved from parsed values and CLI context. */\n  hooks?: PipelineCommandHookConfig<TResult, TSchema>;\n  /** Configure plain/interactive reporting, or disable it. Defaults to automatic mode. */\n  reporter?: false | PipelineReporterConfig;\n  /** Print domain-specific result lines after a successful run. */\n  summarize?(\n    result: TResult,\n    values: PipelineCliValues<TSchema>,\n    context: CliContext\n  ): readonly string[] | void;\n  validate?(values: PipelineCliValues<TSchema>, context: CliContext): string[] | void;\n}\n\n/** Configuration for a typed pipeline command. Mapping is optional only for compatible flags. */\nexport type DefinePipelineCommandConfig<\n  TOptions extends object,\n  TResult,\n  TSchema extends CliParamsSchema,\n> = DefinePipelineCommandConfigBase<TResult, TSchema> &\n  (CanDefaultPipelineCommandOptions<TOptions, TSchema> extends true\n    ? {\n        /** Override the default same-name flag-to-option mapping. */\n        mapOptions?: PipelineCommandMapOptions<TOptions, TSchema>;\n      }\n    : {\n        /** Required when parsed flags do not already satisfy the pipeline's domain options. */\n        mapOptions: PipelineCommandMapOptions<TOptions, TSchema>;\n      });\n\nconst PIPELINE_COMMAND_KEYS = new Set([\"continueOnError\", \"maxConcurrency\", \"stepIds\", \"targets\"]);\nconst PIPELINE_COMMAND_FLAGS = new Set([\"continue-on-error\", \"max-concurrency\", \"step\", \"target\"]);\n\nfunction assertNoPipelineCommandConflicts(params: CliParamsSchema): void {\n  for (const [key, param] of Object.entries(params)) {\n    if (PIPELINE_COMMAND_KEYS.has(key)) {\n      throw new Error(\n        `\"${key}\" is a reserved parameter provided automatically by pipeline commands; remove it from params.`\n      );\n    }\n    const flag = flagName(key, param);\n    if (PIPELINE_COMMAND_FLAGS.has(flag)) {\n      throw new Error(\n        `--${flag} is a reserved flag provided automatically by pipeline commands; remove \"${key}\" from params or give it a different flag name.`\n      );\n    }\n  }\n}\n\nfunction normalizePipelineCliValues<TSchema extends CliParamsSchema>(\n  values: CliParams<PipelineCliBuiltins & TSchema>\n): PipelineCliValues<TSchema> {\n  // SAFETY: `PipelineCliValues<TSchema>` is `CliParams<TSchema>` plus the builtin\n  // `stepIds`/`targets`/`continueOnError`/`maxConcurrency` keys, which `CliParams<PipelineCliBuiltins & TSchema>`\n  // already provides, so the runtime shape matches the target type.\n  const pipelineValues = values as PipelineCliValues<TSchema>;\n  const { continueOnError, stepIds, targets } = pipelineValues;\n  return {\n    ...pipelineValues,\n    continueOnError,\n    stepIds,\n    targets: targets ?? [],\n  };\n}\n\nfunction pipelineRunControlsFromCliValues(values: {\n  continueOnError: boolean;\n  maxConcurrency: number;\n  dryRun: boolean;\n  stepIds: readonly string[];\n  targets: readonly string[];\n}): PipelineRunControls {\n  const controls: PipelineRunControls = {\n    dryRun: values.dryRun,\n    continueOnError: values.continueOnError,\n    maxConcurrency: values.maxConcurrency,\n  };\n  if (values.stepIds.length > 0) controls.stepIds = values.stepIds;\n  if (values.targets.length > 0) controls.targets = values.targets;\n  return controls;\n}\n\nfunction normalizePipelineHookSets<TResult>(\n  hooks: PipelineCommandHookSets<TResult> | undefined\n): PipelineHooks<TResult>[] {\n  if (!hooks) return [];\n  // SAFETY: a non-array `PipelineCommandHookSets` is always a single `PipelineHooks`.\n  return Array.isArray(hooks) ? [...hooks] : [hooks as PipelineHooks<TResult>];\n}\n\nfunction isHookConfigFunction<TResult, TSchema extends CliParamsSchema>(\n  config: PipelineCommandHookConfig<TResult, TSchema> | undefined\n): config is (\n  input: PipelineCommandHookContext<TSchema>\n) => PipelineCommandHookSets<TResult> | undefined {\n  return typeof config === \"function\";\n}\n\nfunction defaultPipelineCommandOptions<TSchema extends CliParamsSchema>(\n  values: PipelineCliValues<TSchema>\n): DefaultPipelineCommandOptions<TSchema> {\n  const {\n    continueOnError: _continueOnError,\n    maxConcurrency: _maxConcurrency,\n    dryRun: _dryRun,\n    resume: _resume,\n    stepIds: _stepIds,\n    targets: _targets,\n    ...domainValues\n  } = values;\n  return domainValues;\n}\n\nfunction nonBlankPipelineText(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0 ? value : undefined;\n}\n\n/** Turn a pipeline into a CLI; infer domain flags from its Standard JSON Schema input. */\nexport function definePipelineCommand<const TPipeline extends Pipeline<object, unknown>>(\n  pipeline: TPipeline &\n    (keyof PipelineInput<TPipeline> extends never\n      ? unknown\n      : { readonly optionsSchema: StandardSchemaV1 }),\n  config?: Omit<\n    DefinePipelineCommandConfigBase<\n      PipelineResult<TPipeline>,\n      InferredCliParams<NoInfer<PipelineInput<TPipeline>>>\n    >,\n    \"params\"\n  > & {\n    params?: never;\n    mapOptions?: never;\n    /** Advanced: customize flag spelling, aliases, help or environment fallbacks. */\n    overrides?: InferredFlagOverrides<NoInfer<PipelineInput<TPipeline>>>;\n  }\n): PipelineCommand<\n  InferredCliParams<PipelineInput<TPipeline>>,\n  PipelineResult<TPipeline>,\n  TPipeline\n>;\n/** Advanced: declare CLI inputs explicitly, mapping them only when their shape differs. */\nexport function definePipelineCommand<\n  const TPipeline extends Pipeline<object, unknown>,\n  const TSchema extends CliParamsSchema = {},\n>(\n  pipeline: TPipeline,\n  config: DefinePipelineCommandConfig<\n    NoInfer<PipelineInput<TPipeline>>,\n    PipelineResult<TPipeline>,\n    TSchema\n  >\n): PipelineCommand<TSchema, PipelineResult<TPipeline>, TPipeline>;\nexport function definePipelineCommand<\n  const TPipeline extends Pipeline<object, unknown>,\n  const TSchema extends CliParamsSchema = {},\n>(\n  pipeline: TPipeline,\n  config: DefinePipelineCommandConfigBase<PipelineResult<TPipeline>, TSchema> & {\n    mapOptions?: PipelineCommandMapOptions<PipelineInput<TPipeline>, TSchema>;\n    overrides?: InferredFlagOverrides<PipelineInput<TPipeline>>;\n  } = {}\n): PipelineCommand<TSchema, PipelineResult<TPipeline>, TPipeline> {\n  type TOptions = PipelineInput<TPipeline>;\n  type TResult = PipelineResult<TPipeline>;\n  // SAFETY: explicit params retain TSchema; the inferred overload derives its schema\n  // from the same pipeline input type. Type-only pipelines have no runtime fields.\n  const userParams = (config.params ??\n    (pipeline.optionsSchema && !config.mapOptions\n      ? inferCliParams(pipeline.optionsSchema, config.overrides)\n      : {})) as TSchema;\n  if (config.overrides && (config.params || config.mapOptions || !pipeline.optionsSchema)) {\n    throw new Error(\n      \"Flag overrides require inferred pipeline flags; use params for an explicit CLI.\"\n    );\n  }\n  assertNoPipelineCommandConflicts(userParams);\n\n  const targetFlagEnabled = pipeline.targetIds.length > 0;\n  const bridgeParams: CliParamsSchema = {\n    stepIds: {\n      type: \"string\",\n      multiple: true,\n      flag: \"step\",\n      group: \"execution\",\n      exclusive: true,\n      choices: pipeline.stepIds,\n      description: `Run exactly this step. Steps: ${pipeline.stepIds.join(\", \")}`,\n    },\n    continueOnError: {\n      type: \"boolean\",\n      group: \"execution\",\n      description: \"Continue independent work after a step fails.\",\n    },\n    maxConcurrency: {\n      type: \"number\",\n      group: \"execution\",\n      default: 1,\n      integer: true,\n      min: 1,\n      description: \"Maximum simultaneous steps in this run.\",\n    },\n  };\n  if (targetFlagEnabled) {\n    bridgeParams.targets = {\n      type: \"string\",\n      multiple: true,\n      flag: \"target\",\n      group: \"execution\",\n      exclusive: true,\n      choices: pipeline.targetIds,\n      description: `Run this declared target and its prerequisites. Targets: ${pipeline.targetIds.join(\", \")}`,\n    };\n  }\n\n  // SAFETY: `bridgeParams` supplies the `PipelineCliBuiltins` keys and `userParams` is\n  // `TSchema`, so the merged object satisfies `PipelineCliBuiltins & TSchema`.\n  const params = { ...bridgeParams, ...userParams } as PipelineCliBuiltins & TSchema;\n  const inheritedName = nonBlankPipelineText(pipeline.name);\n  const inheritedDescription = nonBlankPipelineText(pipeline.description);\n\n  const commandConfig = {\n    name: config.name ?? inheritedName ?? pipeline.id,\n    description: config.description ?? inheritedDescription,\n    params,\n    positionals: config.positionals,\n    checkpoint: config.checkpoint,\n    resume: config.resume,\n    validate: (values, context) => {\n      const pipelineValues = normalizePipelineCliValues<TSchema>(values);\n      const errors = config.validate?.(pipelineValues, context) ?? [];\n      if (pipelineValues.stepIds.length > 0 && pipelineValues.targets.length > 0) {\n        return [\"--step and --target cannot be used together.\", ...errors];\n      }\n      return errors.length > 0 ? errors : undefined;\n    },\n    run: async (values, cliContext) => {\n      const pipelineValues = normalizePipelineCliValues<TSchema>(values);\n      let mapped: TOptions;\n      if (config.mapOptions) {\n        mapped = await config.mapOptions(pipelineValues, cliContext);\n      } else {\n        // SAFETY: `defaultPipelineCommandOptions` returns exactly the domain options the\n        // `CanDefaultPipelineCommandOptions` constraint guarantees map to `TOptions`.\n        mapped = defaultPipelineCommandOptions(pipelineValues) as TOptions;\n      }\n      const controls = pipelineRunControlsFromCliValues({\n        dryRun: values.dryRun,\n        continueOnError: pipelineValues.continueOnError,\n        maxConcurrency: pipelineValues.maxConcurrency,\n        stepIds: pipelineValues.stepIds,\n        targets: targetFlagEnabled ? pipelineValues.targets : [],\n      });\n\n      const reporter =\n        config.reporter === false\n          ? undefined\n          : createPipelineReporter<TResult>({\n              log: cliContext.log,\n              ...(config.reporter ?? {}),\n              ...(cliContext.reporterOutput ? { output: cliContext.reporterOutput } : {}),\n            });\n      const runtimeContext = reporter ? { ...cliContext, log: reporter.log } : cliContext;\n      let result: TResult;\n      try {\n        const configuredHooks = isHookConfigFunction(config.hooks)\n          ? config.hooks({ context: runtimeContext, values: pipelineValues })\n          : config.hooks;\n        const hooks: PipelineHooks<TResult>[] = [\n          ...normalizePipelineHookSets(cliContext.pipelineContext?.hooks),\n          ...(reporter ? [reporter.hooks] : []),\n          ...normalizePipelineHookSets(configuredHooks),\n        ];\n\n        // SAFETY: TResult is extracted from this exact pipeline's runOrThrow return type.\n        result = (await pipeline.runOrThrow(mapped, controls, {\n          ...cliContext.pipelineContext,\n          cwd: runtimeContext.cwd,\n          log: runtimeContext.log,\n          hooks: hooks.length > 0 ? hooks : undefined,\n          signal: runtimeContext.signal,\n        })) as TResult;\n      } finally {\n        reporter?.dispose();\n      }\n      for (const line of config.summarize?.(result, pipelineValues, cliContext) ?? []) {\n        cliContext.log.log(line);\n      }\n      return result;\n    },\n  } satisfies CliCommandConfig<PipelineCliBuiltins & TSchema, TResult>;\n\n  const command = createCommand(commandConfig, {\n    validation: TUBELESS_WORKBENCH_EXIT_CODE.validation,\n  });\n\n  function parse(\n    argv: readonly string[] = process.argv.slice(2),\n    contextOverrides?: Partial<CliContext>\n  ): PipelineCliParseResult<TSchema> {\n    const result = command.parse(argv, contextOverrides);\n    return result.kind === \"values\"\n      ? { kind: \"values\", values: normalizePipelineCliValues<TSchema>(result.values) }\n      : result;\n  }\n\n  function plan(controls: Parameters<TPipeline[\"plan\"]>[0] = {}): PipelinePlan {\n    return pipeline.plan(controls);\n  }\n\n  function parseValues(\n    values: Record<string, unknown>,\n    contextOverrides?: Partial<CliContext>\n  ): PipelineCliParseResult<TSchema> {\n    const result = command.parseValues(values, contextOverrides);\n    return result.kind === \"values\"\n      ? { kind: \"values\", values: normalizePipelineCliValues<TSchema>(result.values) }\n      : result;\n  }\n\n  return markPipelineCommand(\n    {\n      pipeline,\n      descriptor: command.descriptor,\n      id: pipeline.id,\n      stepIds: pipeline.stepIds,\n      targetIds: pipeline.targetIds,\n      execute: (values, contextOverrides) =>\n        // SAFETY: `execute` receives `PipelineCliValues<TSchema>` from the public interface,\n        // which is a subtype of `CliParams<PipelineCliBuiltins & TSchema>`.\n        command.execute(values as CliParams<PipelineCliBuiltins & TSchema>, contextOverrides),\n      parse,\n      parseValues,\n      plan,\n      toMermaid: (options) => pipeline.toMermaid(options),\n      run: command.run,\n      main: command.main,\n    },\n    pipeline\n  );\n}\n"]}
+{"version":3,"file":"cli-pipeline-command.js","sourceRoot":"","sources":["../../src/cli/cli-pipeline-command.ts"],"names":[],"mappings":"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","sourcesContent":["import { createCommand } from \"./cli-command.js\";\nimport { flagName } from \"./cli-parser.js\";\nimport {\n  inferCliParams,\n  type InferredCliParams,\n  type InferredFlagOverrides,\n} from \"./cli-schema.js\";\nimport type {\n  CliBooleanParam,\n  CliCheckpointConfig,\n  CliCommandConfig,\n  CliCommandDescriptor,\n  CliContext,\n  CliNumberParam,\n  CliParams,\n  CliParamsSchema,\n  CliStringParam,\n} from \"./cli-types.js\";\nimport { markPipelineCommand } from \"../utilities/pipeline-command-marker.js\";\nimport {\n  type Pipeline,\n  type PipelineHooks,\n  type PipelineInput,\n  type PipelineMermaidOptions,\n  type StepCachePolicy,\n  type PipelinePlan,\n  type PipelineResult,\n  type PipelineRunControls,\n  type StandardSchemaV1,\n} from \"../core/pipeline.js\";\nimport { createPipelineReporter, type PipelineReporterConfig } from \"../reporter/reporter-entry.js\";\nimport { TUBELESS_WORKBENCH_EXIT_CODE } from \"./cli-exit.js\";\n\nexport type PipelineCliBuiltins = {\n  stepIds: CliStringParam & { multiple: true };\n  targets: CliStringParam & { multiple: true };\n  continueOnError: CliBooleanParam;\n  maxConcurrency: CliNumberParam;\n  cache: CliStringParam & { choices: readonly [\"use\", \"recompute\", \"bypass\"]; optional: true };\n};\n\n/** Validated domain parameters plus the built-in pipeline execution controls. */\nexport type PipelineCliValues<TSchema extends CliParamsSchema> = CliParams<TSchema> & {\n  stepIds: readonly string[];\n  targets: readonly string[];\n  continueOnError: boolean;\n  maxConcurrency: number;\n  cache?: StepCachePolicy;\n};\n\n/** Parse result returned by commands created with `definePipelineCommand`. */\nexport type PipelineCliParseResult<TSchema extends CliParamsSchema> =\n  | { kind: \"values\"; values: PipelineCliValues<TSchema> }\n  | { kind: \"help\"; helpText: string }\n  | { kind: \"error\"; errors: readonly string[]; helpText: string };\n\n/** Typed CLI facade over a pipeline with planning and graph helpers. */\nexport interface PipelineCommand<\n  TSchema extends CliParamsSchema,\n  TResult,\n  TPipeline extends Pipeline<object, unknown> = Pipeline<object, TResult>,\n> {\n  /** Exact pipeline adapted by this command. */\n  readonly pipeline: TPipeline;\n  readonly descriptor: CliCommandDescriptor;\n  /** Stable identity of the wrapped pipeline. */\n  readonly id: TPipeline[\"id\"];\n  /** Stable definition-order step ids for discovery surfaces such as CLI help. */\n  readonly stepIds: TPipeline[\"stepIds\"];\n  /** Stable declared goal ids that support dependency-aware target execution. */\n  readonly targetIds: TPipeline[\"targetIds\"];\n  /** Plan without parsing or requiring domain parameters. */\n  plan(controls?: Parameters<TPipeline[\"plan\"]>[0]): PipelinePlan;\n  /** Generate a static Mermaid flowchart without running or planning the pipeline. */\n  toMermaid(options?: PipelineMermaidOptions): string;\n  parse(argv?: readonly string[], context?: Partial<CliContext>): PipelineCliParseResult<TSchema>;\n  /** Validate structured form values without tokenizing argv. */\n  parseValues(\n    values: Record<string, unknown>,\n    context?: Partial<CliContext>\n  ): PipelineCliParseResult<TSchema>;\n  /** Execute already validated form values. */\n  execute(values: PipelineCliValues<TSchema>, context?: Partial<CliContext>): Promise<TResult>;\n  run(argv?: readonly string[], context?: Partial<CliContext>): Promise<TResult>;\n  main(argv?: readonly string[], context?: Partial<CliContext>): Promise<void>;\n}\n\n/** Parsed values and CLI services passed to a pipeline hook factory. */\nexport interface PipelineCommandHookContext<TSchema extends CliParamsSchema> {\n  context: CliContext;\n  values: PipelineCliValues<TSchema>;\n}\n\n/** One lifecycle hook set or an ordered collection of hook sets. */\ntype PipelineCommandHookSets<TResult> = PipelineHooks<TResult> | readonly PipelineHooks<TResult>[];\n\n/** Static or lazily constructed lifecycle hooks for a pipeline command. */\nexport type PipelineCommandHookConfig<TResult, TSchema extends CliParamsSchema> =\n  | PipelineCommandHookSets<TResult>\n  | ((input: PipelineCommandHookContext<TSchema>) => PipelineCommandHookSets<TResult> | undefined);\n\ntype PipelineCommandMapOptions<TOptions extends object, TSchema extends CliParamsSchema> = (\n  values: PipelineCliValues<TSchema>,\n  context: CliContext\n) => TOptions | Promise<TOptions>;\n\ntype DefaultPipelineCommandOptions<TSchema extends CliParamsSchema> = Omit<\n  PipelineCliValues<TSchema>,\n  \"cache\" | \"continueOnError\" | \"maxConcurrency\" | \"dryRun\" | \"resume\" | \"stepIds\" | \"targets\"\n>;\n\ntype CanDefaultPipelineCommandOptions<TOptions extends object, TSchema extends CliParamsSchema> =\n  DefaultPipelineCommandOptions<TSchema> extends TOptions\n    ? Exclude<keyof TSchema, keyof TOptions> extends never\n      ? true\n      : false\n    : false;\n\ninterface DefinePipelineCommandConfigBase<TResult, TSchema extends CliParamsSchema> {\n  /** Defaults to pipeline.name, then pipeline.id. */\n  name?: string;\n  /** Defaults to pipeline.description. */\n  description?: string;\n  /** Advanced: replace inferred flags for type-only pipelines or custom CLI inputs. */\n  params?: TSchema;\n  /** Extra parameter keys accepted in positional order. */\n  positionals?: readonly (keyof TSchema & string)[];\n  checkpoint?: CliCheckpointConfig;\n  /** Expose resume input for application-owned handling without managed checkpointing. */\n  resume?: true;\n  /** Additional lifecycle hooks, or a factory resolved from parsed values and CLI context. */\n  hooks?: PipelineCommandHookConfig<TResult, TSchema>;\n  /** Configure plain/interactive reporting, or disable it. Defaults to automatic mode. */\n  reporter?: false | PipelineReporterConfig;\n  /** Print domain-specific result lines after a successful run. */\n  summarize?(\n    result: TResult,\n    values: PipelineCliValues<TSchema>,\n    context: CliContext\n  ): readonly string[] | void;\n  validate?(values: PipelineCliValues<TSchema>, context: CliContext): string[] | void;\n}\n\n/** Configuration for a typed pipeline command. Mapping is optional only for compatible flags. */\nexport type DefinePipelineCommandConfig<\n  TOptions extends object,\n  TResult,\n  TSchema extends CliParamsSchema,\n> = DefinePipelineCommandConfigBase<TResult, TSchema> &\n  (CanDefaultPipelineCommandOptions<TOptions, TSchema> extends true\n    ? {\n        /** Override the default same-name flag-to-option mapping. */\n        mapOptions?: PipelineCommandMapOptions<TOptions, TSchema>;\n      }\n    : {\n        /** Required when parsed flags do not already satisfy the pipeline's domain options. */\n        mapOptions: PipelineCommandMapOptions<TOptions, TSchema>;\n      });\n\nconst PIPELINE_COMMAND_KEYS = new Set([\n  \"cache\",\n  \"continueOnError\",\n  \"maxConcurrency\",\n  \"stepIds\",\n  \"targets\",\n]);\nconst PIPELINE_COMMAND_FLAGS = new Set([\n  \"cache\",\n  \"continue-on-error\",\n  \"max-concurrency\",\n  \"step\",\n  \"target\",\n]);\n\nfunction assertNoPipelineCommandConflicts(params: CliParamsSchema): void {\n  for (const [key, param] of Object.entries(params)) {\n    if (PIPELINE_COMMAND_KEYS.has(key)) {\n      throw new Error(\n        `\"${key}\" is a reserved parameter provided automatically by pipeline commands; remove it from params.`\n      );\n    }\n    const flag = flagName(key, param);\n    if (PIPELINE_COMMAND_FLAGS.has(flag)) {\n      throw new Error(\n        `--${flag} is a reserved flag provided automatically by pipeline commands; remove \"${key}\" from params or give it a different flag name.`\n      );\n    }\n  }\n}\n\nfunction normalizePipelineCliValues<TSchema extends CliParamsSchema>(\n  values: CliParams<PipelineCliBuiltins & TSchema>\n): PipelineCliValues<TSchema> {\n  // SAFETY: `PipelineCliValues<TSchema>` is `CliParams<TSchema>` plus the builtin\n  // `stepIds`/`targets`/`continueOnError`/`maxConcurrency` keys, which `CliParams<PipelineCliBuiltins & TSchema>`\n  // already provides, so the runtime shape matches the target type.\n  const pipelineValues = values as PipelineCliValues<TSchema>;\n  const { continueOnError, stepIds, targets } = pipelineValues;\n  return {\n    ...pipelineValues,\n    continueOnError,\n    stepIds,\n    targets: targets ?? [],\n  };\n}\n\nfunction pipelineRunControlsFromCliValues(values: {\n  continueOnError: boolean;\n  maxConcurrency: number;\n  cache?: StepCachePolicy;\n  dryRun: boolean;\n  stepIds: readonly string[];\n  targets: readonly string[];\n}): PipelineRunControls {\n  const controls: PipelineRunControls = {\n    dryRun: values.dryRun,\n    continueOnError: values.continueOnError,\n    maxConcurrency: values.maxConcurrency,\n    ...(values.cache !== undefined ? { cache: values.cache } : {}),\n  };\n  if (values.stepIds.length > 0) controls.stepIds = values.stepIds;\n  if (values.targets.length > 0) controls.targets = values.targets;\n  return controls;\n}\n\nfunction normalizePipelineHookSets<TResult>(\n  hooks: PipelineCommandHookSets<TResult> | undefined\n): PipelineHooks<TResult>[] {\n  if (!hooks) return [];\n  // SAFETY: a non-array `PipelineCommandHookSets` is always a single `PipelineHooks`.\n  return Array.isArray(hooks) ? [...hooks] : [hooks as PipelineHooks<TResult>];\n}\n\nfunction isHookConfigFunction<TResult, TSchema extends CliParamsSchema>(\n  config: PipelineCommandHookConfig<TResult, TSchema> | undefined\n): config is (\n  input: PipelineCommandHookContext<TSchema>\n) => PipelineCommandHookSets<TResult> | undefined {\n  return typeof config === \"function\";\n}\n\nfunction defaultPipelineCommandOptions<TSchema extends CliParamsSchema>(\n  values: PipelineCliValues<TSchema>\n): DefaultPipelineCommandOptions<TSchema> {\n  const {\n    cache: _cache,\n    continueOnError: _continueOnError,\n    maxConcurrency: _maxConcurrency,\n    dryRun: _dryRun,\n    resume: _resume,\n    stepIds: _stepIds,\n    targets: _targets,\n    ...domainValues\n  } = values;\n  return domainValues;\n}\n\nfunction nonBlankPipelineText(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0 ? value : undefined;\n}\n\n/** Turn a pipeline into a CLI; infer domain flags from its Standard JSON Schema input. */\nexport function definePipelineCommand<const TPipeline extends Pipeline<object, unknown>>(\n  pipeline: TPipeline &\n    (keyof PipelineInput<TPipeline> extends never\n      ? unknown\n      : { readonly optionsSchema: StandardSchemaV1 }),\n  config?: Omit<\n    DefinePipelineCommandConfigBase<\n      PipelineResult<TPipeline>,\n      InferredCliParams<NoInfer<PipelineInput<TPipeline>>>\n    >,\n    \"params\"\n  > & {\n    params?: never;\n    mapOptions?: never;\n    /** Advanced: customize flag spelling, aliases, help or environment fallbacks. */\n    overrides?: InferredFlagOverrides<NoInfer<PipelineInput<TPipeline>>>;\n  }\n): PipelineCommand<\n  InferredCliParams<PipelineInput<TPipeline>>,\n  PipelineResult<TPipeline>,\n  TPipeline\n>;\n/** Advanced: declare CLI inputs explicitly, mapping them only when their shape differs. */\nexport function definePipelineCommand<\n  const TPipeline extends Pipeline<object, unknown>,\n  const TSchema extends CliParamsSchema = {},\n>(\n  pipeline: TPipeline,\n  config: DefinePipelineCommandConfig<\n    NoInfer<PipelineInput<TPipeline>>,\n    PipelineResult<TPipeline>,\n    TSchema\n  >\n): PipelineCommand<TSchema, PipelineResult<TPipeline>, TPipeline>;\nexport function definePipelineCommand<\n  const TPipeline extends Pipeline<object, unknown>,\n  const TSchema extends CliParamsSchema = {},\n>(\n  pipeline: TPipeline,\n  config: DefinePipelineCommandConfigBase<PipelineResult<TPipeline>, TSchema> & {\n    mapOptions?: PipelineCommandMapOptions<PipelineInput<TPipeline>, TSchema>;\n    overrides?: InferredFlagOverrides<PipelineInput<TPipeline>>;\n  } = {}\n): PipelineCommand<TSchema, PipelineResult<TPipeline>, TPipeline> {\n  type TOptions = PipelineInput<TPipeline>;\n  type TResult = PipelineResult<TPipeline>;\n  // SAFETY: explicit params retain TSchema; the inferred overload derives its schema\n  // from the same pipeline input type. Type-only pipelines have no runtime fields.\n  const userParams = (config.params ??\n    (pipeline.optionsSchema && !config.mapOptions\n      ? inferCliParams(pipeline.optionsSchema, config.overrides)\n      : {})) as TSchema;\n  if (config.overrides && (config.params || config.mapOptions || !pipeline.optionsSchema)) {\n    throw new Error(\n      \"Flag overrides require inferred pipeline flags; use params for an explicit CLI.\"\n    );\n  }\n  assertNoPipelineCommandConflicts(userParams);\n\n  const targetFlagEnabled = pipeline.targetIds.length > 0;\n  const bridgeParams: CliParamsSchema = {\n    cache: {\n      type: \"string\",\n      choices: [\"use\", \"recompute\", \"bypass\"],\n      optional: true,\n      group: \"execution\",\n      description: \"Override the cache policy for opted-in steps, including child pipelines.\",\n    },\n    stepIds: {\n      type: \"string\",\n      multiple: true,\n      flag: \"step\",\n      group: \"execution\",\n      exclusive: true,\n      choices: pipeline.stepIds,\n      description: `Run exactly this step. Steps: ${pipeline.stepIds.join(\", \")}`,\n    },\n    continueOnError: {\n      type: \"boolean\",\n      group: \"execution\",\n      description: \"Continue independent work after a step fails.\",\n    },\n    maxConcurrency: {\n      type: \"number\",\n      group: \"execution\",\n      default: 1,\n      integer: true,\n      min: 1,\n      description: \"Maximum simultaneous steps in this run.\",\n    },\n  };\n  if (targetFlagEnabled) {\n    bridgeParams.targets = {\n      type: \"string\",\n      multiple: true,\n      flag: \"target\",\n      group: \"execution\",\n      exclusive: true,\n      choices: pipeline.targetIds,\n      description: `Run this declared target and its prerequisites. Targets: ${pipeline.targetIds.join(\", \")}`,\n    };\n  }\n\n  // SAFETY: `bridgeParams` supplies the `PipelineCliBuiltins` keys and `userParams` is\n  // `TSchema`, so the merged object satisfies `PipelineCliBuiltins & TSchema`.\n  const params = { ...bridgeParams, ...userParams } as PipelineCliBuiltins & TSchema;\n  const inheritedName = nonBlankPipelineText(pipeline.name);\n  const inheritedDescription = nonBlankPipelineText(pipeline.description);\n\n  const commandConfig = {\n    name: config.name ?? inheritedName ?? pipeline.id,\n    description: config.description ?? inheritedDescription,\n    params,\n    positionals: config.positionals,\n    checkpoint: config.checkpoint,\n    resume: config.resume,\n    validate: (values, context) => {\n      const pipelineValues = normalizePipelineCliValues<TSchema>(values);\n      const errors = config.validate?.(pipelineValues, context) ?? [];\n      if (pipelineValues.stepIds.length > 0 && pipelineValues.targets.length > 0) {\n        return [\"--step and --target cannot be used together.\", ...errors];\n      }\n      return errors.length > 0 ? errors : undefined;\n    },\n    run: async (values, cliContext) => {\n      const pipelineValues = normalizePipelineCliValues<TSchema>(values);\n      let mapped: TOptions;\n      if (config.mapOptions) {\n        mapped = await config.mapOptions(pipelineValues, cliContext);\n      } else {\n        // SAFETY: `defaultPipelineCommandOptions` returns exactly the domain options the\n        // `CanDefaultPipelineCommandOptions` constraint guarantees map to `TOptions`.\n        mapped = defaultPipelineCommandOptions(pipelineValues) as TOptions;\n      }\n      const controls = pipelineRunControlsFromCliValues({\n        dryRun: values.dryRun,\n        continueOnError: pipelineValues.continueOnError,\n        maxConcurrency: pipelineValues.maxConcurrency,\n        cache: pipelineValues.cache,\n        stepIds: pipelineValues.stepIds,\n        targets: targetFlagEnabled ? pipelineValues.targets : [],\n      });\n\n      const reporter =\n        config.reporter === false\n          ? undefined\n          : createPipelineReporter<TResult>({\n              log: cliContext.log,\n              ...(config.reporter ?? {}),\n              ...(cliContext.reporterOutput ? { output: cliContext.reporterOutput } : {}),\n            });\n      const runtimeContext = reporter ? { ...cliContext, log: reporter.log } : cliContext;\n      let result: TResult;\n      try {\n        const configuredHooks = isHookConfigFunction(config.hooks)\n          ? config.hooks({ context: runtimeContext, values: pipelineValues })\n          : config.hooks;\n        const hooks: PipelineHooks<TResult>[] = [\n          ...normalizePipelineHookSets(cliContext.pipelineContext?.hooks),\n          ...(reporter ? [reporter.hooks] : []),\n          ...normalizePipelineHookSets(configuredHooks),\n        ];\n\n        // SAFETY: TResult is extracted from this exact pipeline's runOrThrow return type.\n        result = (await pipeline.runOrThrow(mapped, controls, {\n          ...cliContext.pipelineContext,\n          cwd: runtimeContext.cwd,\n          log: runtimeContext.log,\n          hooks: hooks.length > 0 ? hooks : undefined,\n          signal: runtimeContext.signal,\n        })) as TResult;\n      } finally {\n        reporter?.dispose();\n      }\n      for (const line of config.summarize?.(result, pipelineValues, cliContext) ?? []) {\n        cliContext.log.log(line);\n      }\n      return result;\n    },\n  } satisfies CliCommandConfig<PipelineCliBuiltins & TSchema, TResult>;\n\n  const command = createCommand(commandConfig, {\n    validation: TUBELESS_WORKBENCH_EXIT_CODE.validation,\n  });\n\n  function parse(\n    argv: readonly string[] = process.argv.slice(2),\n    contextOverrides?: Partial<CliContext>\n  ): PipelineCliParseResult<TSchema> {\n    const result = command.parse(argv, contextOverrides);\n    return result.kind === \"values\"\n      ? { kind: \"values\", values: normalizePipelineCliValues<TSchema>(result.values) }\n      : result;\n  }\n\n  function plan(controls: Parameters<TPipeline[\"plan\"]>[0] = {}): PipelinePlan {\n    return pipeline.plan(controls);\n  }\n\n  function parseValues(\n    values: Record<string, unknown>,\n    contextOverrides?: Partial<CliContext>\n  ): PipelineCliParseResult<TSchema> {\n    const result = command.parseValues(values, contextOverrides);\n    return result.kind === \"values\"\n      ? { kind: \"values\", values: normalizePipelineCliValues<TSchema>(result.values) }\n      : result;\n  }\n\n  return markPipelineCommand(\n    {\n      pipeline,\n      descriptor: command.descriptor,\n      id: pipeline.id,\n      stepIds: pipeline.stepIds,\n      targetIds: pipeline.targetIds,\n      execute: (values, contextOverrides) =>\n        // SAFETY: `execute` receives `PipelineCliValues<TSchema>` from the public interface,\n        // which is a subtype of `CliParams<PipelineCliBuiltins & TSchema>`.\n        command.execute(values as CliParams<PipelineCliBuiltins & TSchema>, contextOverrides),\n      parse,\n      parseValues,\n      plan,\n      toMermaid: (options) => pipeline.toMermaid(options),\n      run: command.run,\n      main: command.main,\n    },\n    pipeline\n  );\n}\n"]}

package/dist/core/child-execution.js

@@ -81,8 +81,10 @@ function childTracingOptions(context, itemKey = context.trace?.itemKey) {
         iteration: tracing.iteration?.runId === context.runId ? tracing.iteration : undefined,
     };
 }
-function childRunControls(controls, parentDryRun) {
+function childRunControls(controls, parentDryRun, cachePolicy) {
     const resolved = {};
+    if (cachePolicy !== undefined || controls?.cache !== undefined)
+        resolved.cache = cachePolicy ?? controls?.cache;
     if (controls?.continueOnError !== undefined) {
         resolved.continueOnError = controls.continueOnError;
     }
@@ -139,7 +141,7 @@ export function createSingleChildRunner(config) {
     return async (inputs, context) => {
         const domainOptions = config.mapOptions ? config.mapOptions(inputs, context) : context.options;
         const configuredControls = typeof config.controls === "function" ? config.controls(inputs, context) : config.controls;
-        const controls = childRunControls(configuredControls, context.dryRun);
+        const controls = childRunControls(configuredControls, context.dryRun, context.cachePolicy);
         const baseChildContext = {
             correlationId: context.correlationId,
             cwd: context.cwd,
@@ -187,7 +189,7 @@ export function createMappedChildRunner(config) {
                 const configuredControls = typeof config.controls === "function"
                     ? config.controls(item, itemIndex, inputs, context)
                     : config.controls;
-                const controls = childRunControls(configuredControls, context.dryRun);
+                const controls = childRunControls(configuredControls, context.dryRun, context.cachePolicy);
                 // Plan once per mapped-options bag for progress and execution.
                 const childPlan = config.pipeline.plan(controls);
                 const childHooks = progress?.plan(key, childPlan) ?? {};

package/dist/core/child-execution.js.map

@@ -1 +1 @@
-{"version":3,"file":"child-execution.js","sourceRoot":"","sources":["../../src/core/child-execution.ts"],"names":[],"mappings":"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","sourcesContent":["import { throwIfAborted } from \"../utilities/abort.js\";\nimport { emitRejectedPlanLifecycle } from \"./lifecycle.js\";\nimport { runConcurrentPartial } from \"../utilities/batch.js\";\nimport {\n  isPipelineCancellation,\n  PipelineChildError,\n  PipelineExecutionError,\n} from \"./pipeline-execution-error.js\";\nimport type { ToMappedChildStepProgressOptions } from \"./mapped-child-progress.js\";\nimport { createRunId, RUN_MODEL_VERSION } from \"./pipeline-ids.js\";\nimport { duplicateValues } from \"../utilities/collections.js\";\nimport { EXECUTE_COMPILED_RUN, isCompiledPipeline } from \"./pipeline-identity.js\";\nimport { createMappedChildProgress, createSingleChildProgress } from \"./child-progress.js\";\nimport type {\n  Pipeline,\n  PipelineContext,\n  PipelineExecutionContext,\n  PipelineHooks,\n  PipelinePlan,\n  PipelineRun,\n  PipelineRunControls,\n  PipelineRuntime,\n  PipelineStepContext,\n} from \"./pipeline-types.js\";\nimport type { PipelineTracingOptions } from \"../tracing/tracing-contracts.js\";\n\ntype ChildPipeline = Pipeline<object, unknown, string, string>;\n\ntype CompiledChildExecute = (\n  plan: PipelinePlan,\n  options: object,\n  controls: PipelineRunControls,\n  context?: Partial<PipelineContext>\n) => Promise<PipelineRun<unknown>>;\n\ntype ExecutableChild = ChildPipeline & {\n  [EXECUTE_COMPILED_RUN]?: CompiledChildExecute;\n};\n\nfunction compiledChildExecute(pipeline: ChildPipeline): CompiledChildExecute | undefined {\n  if (!isCompiledPipeline(pipeline)) return undefined;\n  // SAFETY: branded pipelines are the `definePipeline` object, which always\n  // stamps `EXECUTE_COMPILED_RUN`. Wrappers that inherit the symbol are rejected\n  // by the identity check above.\n  return (pipeline as ExecutableChild)[EXECUTE_COMPILED_RUN];\n}\n\nfunction executeCompiledChild(\n  pipeline: ChildPipeline,\n  plan: PipelinePlan,\n  domainOptions: object,\n  controls: PipelineRunControls,\n  context: PipelineContext\n): Promise<PipelineRun<unknown>> {\n  const execute = compiledChildExecute(pipeline);\n  if (execute === undefined) {\n    return pipeline.run(domainOptions, controls, context);\n  }\n  return execute(plan, domainOptions, controls, context);\n}\n\nfunction publicChildRuntime(context: PipelineContext): PipelineRuntime {\n  const runtime: PipelineRuntime = {\n    cwd: context.cwd,\n    log: context.log,\n    now: context.now ?? Date.now,\n    sleep: context.sleep ?? (async () => undefined),\n  };\n  if (context.correlationId !== undefined) runtime.correlationId = context.correlationId;\n  if (context.hooks) runtime.hooks = context.hooks;\n  if (context.parentRunId) runtime.parentRunId = context.parentRunId;\n  if (context.signal) runtime.signal = context.signal;\n  if (context.tracing) runtime.tracing = context.tracing;\n  return runtime;\n}\n\nasync function failedPublicChildPlanRun(\n  pipeline: ChildPipeline,\n  plan: PipelinePlan,\n  controls: PipelineRunControls,\n  context: PipelineContext\n): Promise<PipelineRun<unknown>> {\n  const runtime = publicChildRuntime(context);\n  const startedAtMs = runtime.now();\n  const result: PipelineRun<unknown> = {\n    pipelineId: pipeline.id,\n    dryRun: controls.dryRun === true,\n    errors: [...plan.errors],\n    finalized: false,\n    finishedAtMs: runtime.now(),\n    runId: createRunId(pipeline.id),\n    startedAtMs,\n    status: \"failed\",\n    steps: [],\n    version: RUN_MODEL_VERSION,\n  };\n  const correlationId = context.correlationId;\n  if (correlationId !== undefined) result.correlationId = correlationId;\n  if (context.parentRunId) result.parentRunId = context.parentRunId;\n  await emitRejectedPlanLifecycle(pipeline.id, pipeline.targetIds, plan, runtime, result);\n  return result;\n}\n\nasync function rejectedChildPlanResult(\n  pipeline: ChildPipeline,\n  plan: PipelinePlan,\n  domainOptions: object,\n  controls: PipelineRunControls,\n  context: PipelineContext\n): Promise<PipelineRun<unknown>> {\n  const execute = compiledChildExecute(pipeline);\n  if (execute === undefined) {\n    return failedPublicChildPlanRun(pipeline, plan, controls, context);\n  }\n  return execute(plan, domainOptions, controls, context);\n}\n\ntype ChildInputs = Record<string, unknown>;\n\nexport interface SingleChildExecutionConfig<TParentOptions extends object> {\n  pipeline: ChildPipeline;\n  controls?:\n    | PipelineRunControls\n    | ((\n        inputs: ChildInputs,\n        context: PipelineExecutionContext<TParentOptions>\n      ) => PipelineRunControls);\n  mapOptions?(inputs: ChildInputs, context: PipelineExecutionContext<TParentOptions>): object;\n  mapResult?(\n    value: unknown,\n    result: PipelineRun<unknown>,\n    context: PipelineStepContext<TParentOptions>\n  ): unknown;\n}\n\nexport interface MappedChildExecutionConfig<TParentOptions extends object> {\n  pipeline: ChildPipeline;\n  items(\n    inputs: ChildInputs,\n    context: PipelineExecutionContext<TParentOptions>\n  ): readonly unknown[] | Promise<readonly unknown[]>;\n  key(item: unknown, index: number): string;\n  concurrency?:\n    | number\n    | ((inputs: ChildInputs, context: PipelineExecutionContext<TParentOptions>) => number);\n  progress?: ToMappedChildStepProgressOptions;\n  controls?:\n    | PipelineRunControls\n    | ((\n        item: unknown,\n        index: number,\n        inputs: ChildInputs,\n        context: PipelineExecutionContext<TParentOptions>\n      ) => PipelineRunControls);\n  mapOptions(\n    item: unknown,\n    index: number,\n    inputs: ChildInputs,\n    context: PipelineExecutionContext<TParentOptions>\n  ): object;\n  mapResult?(\n    value: unknown,\n    result: PipelineRun<unknown>,\n    item: unknown,\n    index: number,\n    context: PipelineStepContext<TParentOptions>\n  ): unknown;\n}\n\nfunction childTracingOptions(\n  context: PipelineExecutionContext<object>,\n  itemKey = context.trace?.itemKey\n): PipelineTracingOptions | undefined {\n  const tracing = context.tracing;\n  if (!tracing) return undefined;\n  return {\n    ...tracing,\n    itemKey,\n    // A relation injected by this wrapper belongs to its next child, not descendants.\n    iteration: tracing.iteration?.runId === context.runId ? tracing.iteration : undefined,\n  };\n}\n\nfunction childRunControls(\n  controls: PipelineRunControls | undefined,\n  parentDryRun: boolean\n): PipelineRunControls {\n  const resolved: PipelineRunControls = {};\n  if (controls?.continueOnError !== undefined) {\n    resolved.continueOnError = controls.continueOnError;\n  }\n  if (controls?.maxConcurrency !== undefined) {\n    resolved.maxConcurrency = controls.maxConcurrency;\n  }\n  if (controls?.stepIds !== undefined) resolved.stepIds = [...controls.stepIds];\n  if (controls?.targets !== undefined) resolved.targets = [...controls.targets];\n  if (parentDryRun || controls?.dryRun === true) {\n    resolved.dryRun = true;\n  } else if (controls?.dryRun !== undefined) {\n    resolved.dryRun = false;\n  }\n  return resolved;\n}\n\nfunction isConcurrencyFunction<TOptions extends object>(\n  concurrency:\n    | number\n    | ((inputs: ChildInputs, context: PipelineExecutionContext<TOptions>) => number)\n    | undefined\n): concurrency is (inputs: ChildInputs, context: PipelineExecutionContext<TOptions>) => number {\n  return typeof concurrency === \"function\";\n}\n\nfunction firstChildFailure(result: PipelineRun<unknown>) {\n  const firstFailedStep = result.steps.find(\n    ({ status }) => status === \"failed\" || status === \"cancelled\"\n  );\n  const firstError =\n    firstFailedStep && \"error\" in firstFailedStep ? firstFailedStep.error : result.errors[0];\n  return {\n    failureLocation: firstFailedStep?.id ?? firstError?.stepId ?? \"unknown step\",\n    message: firstError?.message ?? \"unknown error\",\n  };\n}\n\nasync function runChildPipeline(\n  pipeline: ChildPipeline,\n  domainOptions: object,\n  controls: PipelineRunControls,\n  context: PipelineContext,\n  hooks: PipelineHooks,\n  messagePrefix = \"\",\n  plan: PipelinePlan\n): Promise<PipelineRun<unknown>> {\n  if (!plan.ok) {\n    const firstError = plan.errors[0];\n    const result = await rejectedChildPlanResult(pipeline, plan, domainOptions, controls, {\n      ...context,\n      hooks,\n    });\n    throw new PipelineExecutionError(\n      result,\n      `${messagePrefix}could not start: ${firstError?.message ?? \"invalid plan\"}`\n    );\n  }\n\n  const result = await executeCompiledChild(pipeline, plan, domainOptions, controls, {\n    ...context,\n    hooks,\n  });\n  if (result.status !== \"completed\") {\n    const { failureLocation, message } = firstChildFailure(result);\n    throw new PipelineExecutionError(\n      result,\n      `${messagePrefix}failed at ${failureLocation}: ${message}`\n    );\n  }\n  return result;\n}\n\nfunction hasProgressObserver(context: PipelineContext): boolean {\n  const hooks = Array.isArray(context.hooks) ? context.hooks : [context.hooks];\n  return (\n    Boolean(context.tracing) || hooks.some((hook) => hook?.onStepProgress || hook?.onStepStatus)\n  );\n}\n\nexport function createSingleChildRunner<TParentOptions extends object>(\n  config: SingleChildExecutionConfig<TParentOptions>\n): (inputs: ChildInputs, context: PipelineStepContext<TParentOptions>) => Promise<unknown> {\n  return async (inputs, context) => {\n    const domainOptions = config.mapOptions ? config.mapOptions(inputs, context) : context.options;\n    const configuredControls =\n      typeof config.controls === \"function\" ? config.controls(inputs, context) : config.controls;\n    const controls = childRunControls(configuredControls, context.dryRun);\n    const baseChildContext: PipelineContext = {\n      correlationId: context.correlationId,\n      cwd: context.cwd,\n      log: context.log,\n      now: context.now,\n      parentRunId: context.runId,\n      signal: context.signal,\n      sleep: context.sleep,\n      tracing: childTracingOptions(context),\n    };\n    // Plan once for progress totals and execution. Invalid plans fail before child.run.\n    const childPlan = config.pipeline.plan(controls);\n    const childHooks = hasProgressObserver(context)\n      ? createSingleChildProgress(childPlan, context.reportProgress)\n      : {};\n    const childResult = await runChildPipeline(\n      config.pipeline,\n      domainOptions,\n      controls,\n      baseChildContext,\n      childHooks,\n      `Child pipeline ${config.pipeline.id} `,\n      childPlan\n    );\n\n    return config.mapResult\n      ? config.mapResult(childResult.value, childResult, context)\n      : childResult.value;\n  };\n}\n\nexport function createMappedChildRunner<TParentOptions extends object>(\n  config: MappedChildExecutionConfig<TParentOptions>\n): (inputs: ChildInputs, context: PipelineStepContext<TParentOptions>) => Promise<unknown[]> {\n  return async (inputs, context) => {\n    const items = [...(await config.items(inputs, context))];\n    const keys = items.map((item, index) => config.key(item, index));\n    const duplicateKeys = duplicateValues(keys);\n    if (duplicateKeys.length > 0) {\n      throw new PipelineChildError(\n        `Mapped child pipeline ${config.pipeline.id} received duplicate item keys: ${duplicateKeys.join(\", \")}`\n      );\n    }\n    const concurrency = Math.max(\n      1,\n      isConcurrencyFunction(config.concurrency)\n        ? config.concurrency(inputs, context)\n        : (config.concurrency ?? 1)\n    );\n    type Outcome =\n      | { key: string; ok: true; value: unknown }\n      | { error: Error; key: string; index: number; ok: false };\n\n    const progress = hasProgressObserver(context)\n      ? createMappedChildProgress(keys, concurrency, config.progress, context.reportProgress)\n      : undefined;\n    progress?.publish();\n    if (items.length === 0) return [];\n\n    const partial = await runConcurrentPartial(\n      items,\n      { concurrency, signal: context.signal },\n      async (item, itemIndex): Promise<Outcome> => {\n        const key = keys[itemIndex]!;\n        progress?.start(key);\n        try {\n          throwIfAborted(context.signal, `Mapped child pipeline ${config.pipeline.id}`);\n          const domainOptions = config.mapOptions(item, itemIndex, inputs, context);\n          const configuredControls =\n            typeof config.controls === \"function\"\n              ? config.controls(item, itemIndex, inputs, context)\n              : config.controls;\n          const controls = childRunControls(configuredControls, context.dryRun);\n          // Plan once per mapped-options bag for progress and execution.\n          const childPlan = config.pipeline.plan(controls);\n          const childHooks = progress?.plan(key, childPlan) ?? {};\n          const childResult = await runChildPipeline(\n            config.pipeline,\n            domainOptions,\n            controls,\n            {\n              correlationId: context.correlationId,\n              cwd: context.cwd,\n              log: context.log,\n              now: context.now,\n              parentRunId: context.runId,\n              signal: context.signal,\n              sleep: context.sleep,\n              tracing: childTracingOptions(context, key),\n            },\n            childHooks,\n            \"\",\n            childPlan\n          );\n\n          progress?.childCompleted(key);\n\n          const value = config.mapResult\n            ? config.mapResult(childResult.value, childResult, item, itemIndex, context)\n            : childResult.value;\n          progress?.complete(key);\n          return { key, ok: true, value };\n        } catch (error) {\n          const cause = error instanceof Error ? error : new Error(String(error));\n          progress?.fail(key, cause, isPipelineCancellation(cause, context));\n          return { error: cause, key, index: itemIndex, ok: false };\n        }\n      }\n    );\n\n    progress?.finish();\n    const outcomes = partial.ok\n      ? partial.results\n      : partial.results.filter((outcome): outcome is Outcome => outcome !== undefined);\n    const schedulerFailure = partial.ok\n      ? undefined\n      : partial.failure instanceof Error\n        ? partial.failure\n        : new Error(String(partial.failure));\n\n    const failures = outcomes.filter(\n      (outcome): outcome is Extract<Outcome, { ok: false }> => !outcome.ok\n    );\n    if (failures.length > 0 || schedulerFailure !== undefined) {\n      const details = failures.map(({ error, key }) => `${key}: ${error.message}`).join(\"; \");\n      const cancelled =\n        failures.every(({ error }) => isPipelineCancellation(error, context)) &&\n        (schedulerFailure === undefined || isPipelineCancellation(schedulerFailure, context));\n      const primaryError = cancelled\n        ? (failures[0]?.error ?? schedulerFailure)\n        : (failures.find(({ error }) => !isPipelineCancellation(error, context))?.error ??\n          failures[0]?.error ??\n          schedulerFailure);\n      const message =\n        failures.length > 0\n          ? `Mapped child pipeline ${config.pipeline.id} failed for ${failures.length} item(s): ${details}`\n          : `Mapped child pipeline ${config.pipeline.id} failed: ${primaryError?.message ?? \"aborted\"}`;\n      throw new PipelineChildError(message, cancelled, primaryError, {\n        failures: failures.slice(0, 32).map(({ error, key, index }) => ({\n          error,\n          key,\n          index,\n          cancelled: isPipelineCancellation(error, context),\n        })),\n        failureCount: failures.length,\n        schedulerError: schedulerFailure,\n      });\n    }\n    // SAFETY: when failures.length === 0 every outcome was produced by the\n    // success branch (return { key, ok: true, value }), so each outcome is\n    // necessarily `{ ok: true }`; the assertion narrows the union accordingly.\n    return outcomes.map((outcome) => (outcome as Extract<Outcome, { ok: true }>).value);\n  };\n}\n"]}
+{"version":3,"file":"child-execution.js","sourceRoot":"","sources":["../../src/core/child-execution.ts"],"names":[],"mappings":"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","sourcesContent":["import { throwIfAborted } from \"../utilities/abort.js\";\nimport { emitRejectedPlanLifecycle } from \"./lifecycle.js\";\nimport { runConcurrentPartial } from \"../utilities/batch.js\";\nimport {\n  isPipelineCancellation,\n  PipelineChildError,\n  PipelineExecutionError,\n} from \"./pipeline-execution-error.js\";\nimport type { ToMappedChildStepProgressOptions } from \"./mapped-child-progress.js\";\nimport { createRunId, RUN_MODEL_VERSION } from \"./pipeline-ids.js\";\nimport { duplicateValues } from \"../utilities/collections.js\";\nimport { EXECUTE_COMPILED_RUN, isCompiledPipeline } from \"./pipeline-identity.js\";\nimport { createMappedChildProgress, createSingleChildProgress } from \"./child-progress.js\";\nimport type {\n  Pipeline,\n  PipelineContext,\n  PipelineExecutionContext,\n  PipelineHooks,\n  PipelinePlan,\n  PipelineRun,\n  PipelineRunControls,\n  PipelineRuntime,\n  PipelineStepContext,\n} from \"./pipeline-types.js\";\nimport type { PipelineTracingOptions } from \"../tracing/tracing-contracts.js\";\n\ntype ChildPipeline = Pipeline<object, unknown, string, string>;\n\ntype CompiledChildExecute = (\n  plan: PipelinePlan,\n  options: object,\n  controls: PipelineRunControls,\n  context?: Partial<PipelineContext>\n) => Promise<PipelineRun<unknown>>;\n\ntype ExecutableChild = ChildPipeline & {\n  [EXECUTE_COMPILED_RUN]?: CompiledChildExecute;\n};\n\nfunction compiledChildExecute(pipeline: ChildPipeline): CompiledChildExecute | undefined {\n  if (!isCompiledPipeline(pipeline)) return undefined;\n  // SAFETY: branded pipelines are the `definePipeline` object, which always\n  // stamps `EXECUTE_COMPILED_RUN`. Wrappers that inherit the symbol are rejected\n  // by the identity check above.\n  return (pipeline as ExecutableChild)[EXECUTE_COMPILED_RUN];\n}\n\nfunction executeCompiledChild(\n  pipeline: ChildPipeline,\n  plan: PipelinePlan,\n  domainOptions: object,\n  controls: PipelineRunControls,\n  context: PipelineContext\n): Promise<PipelineRun<unknown>> {\n  const execute = compiledChildExecute(pipeline);\n  if (execute === undefined) {\n    return pipeline.run(domainOptions, controls, context);\n  }\n  return execute(plan, domainOptions, controls, context);\n}\n\nfunction publicChildRuntime(context: PipelineContext): PipelineRuntime {\n  const runtime: PipelineRuntime = {\n    cwd: context.cwd,\n    log: context.log,\n    now: context.now ?? Date.now,\n    sleep: context.sleep ?? (async () => undefined),\n  };\n  if (context.correlationId !== undefined) runtime.correlationId = context.correlationId;\n  if (context.hooks) runtime.hooks = context.hooks;\n  if (context.parentRunId) runtime.parentRunId = context.parentRunId;\n  if (context.signal) runtime.signal = context.signal;\n  if (context.tracing) runtime.tracing = context.tracing;\n  return runtime;\n}\n\nasync function failedPublicChildPlanRun(\n  pipeline: ChildPipeline,\n  plan: PipelinePlan,\n  controls: PipelineRunControls,\n  context: PipelineContext\n): Promise<PipelineRun<unknown>> {\n  const runtime = publicChildRuntime(context);\n  const startedAtMs = runtime.now();\n  const result: PipelineRun<unknown> = {\n    pipelineId: pipeline.id,\n    dryRun: controls.dryRun === true,\n    errors: [...plan.errors],\n    finalized: false,\n    finishedAtMs: runtime.now(),\n    runId: createRunId(pipeline.id),\n    startedAtMs,\n    status: \"failed\",\n    steps: [],\n    version: RUN_MODEL_VERSION,\n  };\n  const correlationId = context.correlationId;\n  if (correlationId !== undefined) result.correlationId = correlationId;\n  if (context.parentRunId) result.parentRunId = context.parentRunId;\n  await emitRejectedPlanLifecycle(pipeline.id, pipeline.targetIds, plan, runtime, result);\n  return result;\n}\n\nasync function rejectedChildPlanResult(\n  pipeline: ChildPipeline,\n  plan: PipelinePlan,\n  domainOptions: object,\n  controls: PipelineRunControls,\n  context: PipelineContext\n): Promise<PipelineRun<unknown>> {\n  const execute = compiledChildExecute(pipeline);\n  if (execute === undefined) {\n    return failedPublicChildPlanRun(pipeline, plan, controls, context);\n  }\n  return execute(plan, domainOptions, controls, context);\n}\n\ntype ChildInputs = Record<string, unknown>;\n\nexport interface SingleChildExecutionConfig<TParentOptions extends object> {\n  pipeline: ChildPipeline;\n  controls?:\n    | PipelineRunControls\n    | ((\n        inputs: ChildInputs,\n        context: PipelineExecutionContext<TParentOptions>\n      ) => PipelineRunControls);\n  mapOptions?(inputs: ChildInputs, context: PipelineExecutionContext<TParentOptions>): object;\n  mapResult?(\n    value: unknown,\n    result: PipelineRun<unknown>,\n    context: PipelineStepContext<TParentOptions>\n  ): unknown;\n}\n\nexport interface MappedChildExecutionConfig<TParentOptions extends object> {\n  pipeline: ChildPipeline;\n  items(\n    inputs: ChildInputs,\n    context: PipelineExecutionContext<TParentOptions>\n  ): readonly unknown[] | Promise<readonly unknown[]>;\n  key(item: unknown, index: number): string;\n  concurrency?:\n    | number\n    | ((inputs: ChildInputs, context: PipelineExecutionContext<TParentOptions>) => number);\n  progress?: ToMappedChildStepProgressOptions;\n  controls?:\n    | PipelineRunControls\n    | ((\n        item: unknown,\n        index: number,\n        inputs: ChildInputs,\n        context: PipelineExecutionContext<TParentOptions>\n      ) => PipelineRunControls);\n  mapOptions(\n    item: unknown,\n    index: number,\n    inputs: ChildInputs,\n    context: PipelineExecutionContext<TParentOptions>\n  ): object;\n  mapResult?(\n    value: unknown,\n    result: PipelineRun<unknown>,\n    item: unknown,\n    index: number,\n    context: PipelineStepContext<TParentOptions>\n  ): unknown;\n}\n\nfunction childTracingOptions(\n  context: PipelineExecutionContext<object>,\n  itemKey = context.trace?.itemKey\n): PipelineTracingOptions | undefined {\n  const tracing = context.tracing;\n  if (!tracing) return undefined;\n  return {\n    ...tracing,\n    itemKey,\n    // A relation injected by this wrapper belongs to its next child, not descendants.\n    iteration: tracing.iteration?.runId === context.runId ? tracing.iteration : undefined,\n  };\n}\n\nfunction childRunControls(\n  controls: PipelineRunControls | undefined,\n  parentDryRun: boolean,\n  cachePolicy: PipelineRunControls[\"cache\"]\n): PipelineRunControls {\n  const resolved: PipelineRunControls = {};\n  if (cachePolicy !== undefined || controls?.cache !== undefined)\n    resolved.cache = cachePolicy ?? controls?.cache;\n  if (controls?.continueOnError !== undefined) {\n    resolved.continueOnError = controls.continueOnError;\n  }\n  if (controls?.maxConcurrency !== undefined) {\n    resolved.maxConcurrency = controls.maxConcurrency;\n  }\n  if (controls?.stepIds !== undefined) resolved.stepIds = [...controls.stepIds];\n  if (controls?.targets !== undefined) resolved.targets = [...controls.targets];\n  if (parentDryRun || controls?.dryRun === true) {\n    resolved.dryRun = true;\n  } else if (controls?.dryRun !== undefined) {\n    resolved.dryRun = false;\n  }\n  return resolved;\n}\n\nfunction isConcurrencyFunction<TOptions extends object>(\n  concurrency:\n    | number\n    | ((inputs: ChildInputs, context: PipelineExecutionContext<TOptions>) => number)\n    | undefined\n): concurrency is (inputs: ChildInputs, context: PipelineExecutionContext<TOptions>) => number {\n  return typeof concurrency === \"function\";\n}\n\nfunction firstChildFailure(result: PipelineRun<unknown>) {\n  const firstFailedStep = result.steps.find(\n    ({ status }) => status === \"failed\" || status === \"cancelled\"\n  );\n  const firstError =\n    firstFailedStep && \"error\" in firstFailedStep ? firstFailedStep.error : result.errors[0];\n  return {\n    failureLocation: firstFailedStep?.id ?? firstError?.stepId ?? \"unknown step\",\n    message: firstError?.message ?? \"unknown error\",\n  };\n}\n\nasync function runChildPipeline(\n  pipeline: ChildPipeline,\n  domainOptions: object,\n  controls: PipelineRunControls,\n  context: PipelineContext,\n  hooks: PipelineHooks,\n  messagePrefix = \"\",\n  plan: PipelinePlan\n): Promise<PipelineRun<unknown>> {\n  if (!plan.ok) {\n    const firstError = plan.errors[0];\n    const result = await rejectedChildPlanResult(pipeline, plan, domainOptions, controls, {\n      ...context,\n      hooks,\n    });\n    throw new PipelineExecutionError(\n      result,\n      `${messagePrefix}could not start: ${firstError?.message ?? \"invalid plan\"}`\n    );\n  }\n\n  const result = await executeCompiledChild(pipeline, plan, domainOptions, controls, {\n    ...context,\n    hooks,\n  });\n  if (result.status !== \"completed\") {\n    const { failureLocation, message } = firstChildFailure(result);\n    throw new PipelineExecutionError(\n      result,\n      `${messagePrefix}failed at ${failureLocation}: ${message}`\n    );\n  }\n  return result;\n}\n\nfunction hasProgressObserver(context: PipelineContext): boolean {\n  const hooks = Array.isArray(context.hooks) ? context.hooks : [context.hooks];\n  return (\n    Boolean(context.tracing) || hooks.some((hook) => hook?.onStepProgress || hook?.onStepStatus)\n  );\n}\n\nexport function createSingleChildRunner<TParentOptions extends object>(\n  config: SingleChildExecutionConfig<TParentOptions>\n): (inputs: ChildInputs, context: PipelineStepContext<TParentOptions>) => Promise<unknown> {\n  return async (inputs, context) => {\n    const domainOptions = config.mapOptions ? config.mapOptions(inputs, context) : context.options;\n    const configuredControls =\n      typeof config.controls === \"function\" ? config.controls(inputs, context) : config.controls;\n    const controls = childRunControls(configuredControls, context.dryRun, context.cachePolicy);\n    const baseChildContext: PipelineContext = {\n      correlationId: context.correlationId,\n      cwd: context.cwd,\n      log: context.log,\n      now: context.now,\n      parentRunId: context.runId,\n      signal: context.signal,\n      sleep: context.sleep,\n      tracing: childTracingOptions(context),\n    };\n    // Plan once for progress totals and execution. Invalid plans fail before child.run.\n    const childPlan = config.pipeline.plan(controls);\n    const childHooks = hasProgressObserver(context)\n      ? createSingleChildProgress(childPlan, context.reportProgress)\n      : {};\n    const childResult = await runChildPipeline(\n      config.pipeline,\n      domainOptions,\n      controls,\n      baseChildContext,\n      childHooks,\n      `Child pipeline ${config.pipeline.id} `,\n      childPlan\n    );\n\n    return config.mapResult\n      ? config.mapResult(childResult.value, childResult, context)\n      : childResult.value;\n  };\n}\n\nexport function createMappedChildRunner<TParentOptions extends object>(\n  config: MappedChildExecutionConfig<TParentOptions>\n): (inputs: ChildInputs, context: PipelineStepContext<TParentOptions>) => Promise<unknown[]> {\n  return async (inputs, context) => {\n    const items = [...(await config.items(inputs, context))];\n    const keys = items.map((item, index) => config.key(item, index));\n    const duplicateKeys = duplicateValues(keys);\n    if (duplicateKeys.length > 0) {\n      throw new PipelineChildError(\n        `Mapped child pipeline ${config.pipeline.id} received duplicate item keys: ${duplicateKeys.join(\", \")}`\n      );\n    }\n    const concurrency = Math.max(\n      1,\n      isConcurrencyFunction(config.concurrency)\n        ? config.concurrency(inputs, context)\n        : (config.concurrency ?? 1)\n    );\n    type Outcome =\n      | { key: string; ok: true; value: unknown }\n      | { error: Error; key: string; index: number; ok: false };\n\n    const progress = hasProgressObserver(context)\n      ? createMappedChildProgress(keys, concurrency, config.progress, context.reportProgress)\n      : undefined;\n    progress?.publish();\n    if (items.length === 0) return [];\n\n    const partial = await runConcurrentPartial(\n      items,\n      { concurrency, signal: context.signal },\n      async (item, itemIndex): Promise<Outcome> => {\n        const key = keys[itemIndex]!;\n        progress?.start(key);\n        try {\n          throwIfAborted(context.signal, `Mapped child pipeline ${config.pipeline.id}`);\n          const domainOptions = config.mapOptions(item, itemIndex, inputs, context);\n          const configuredControls =\n            typeof config.controls === \"function\"\n              ? config.controls(item, itemIndex, inputs, context)\n              : config.controls;\n          const controls = childRunControls(\n            configuredControls,\n            context.dryRun,\n            context.cachePolicy\n          );\n          // Plan once per mapped-options bag for progress and execution.\n          const childPlan = config.pipeline.plan(controls);\n          const childHooks = progress?.plan(key, childPlan) ?? {};\n          const childResult = await runChildPipeline(\n            config.pipeline,\n            domainOptions,\n            controls,\n            {\n              correlationId: context.correlationId,\n              cwd: context.cwd,\n              log: context.log,\n              now: context.now,\n              parentRunId: context.runId,\n              signal: context.signal,\n              sleep: context.sleep,\n              tracing: childTracingOptions(context, key),\n            },\n            childHooks,\n            \"\",\n            childPlan\n          );\n\n          progress?.childCompleted(key);\n\n          const value = config.mapResult\n            ? config.mapResult(childResult.value, childResult, item, itemIndex, context)\n            : childResult.value;\n          progress?.complete(key);\n          return { key, ok: true, value };\n        } catch (error) {\n          const cause = error instanceof Error ? error : new Error(String(error));\n          progress?.fail(key, cause, isPipelineCancellation(cause, context));\n          return { error: cause, key, index: itemIndex, ok: false };\n        }\n      }\n    );\n\n    progress?.finish();\n    const outcomes = partial.ok\n      ? partial.results\n      : partial.results.filter((outcome): outcome is Outcome => outcome !== undefined);\n    const schedulerFailure = partial.ok\n      ? undefined\n      : partial.failure instanceof Error\n        ? partial.failure\n        : new Error(String(partial.failure));\n\n    const failures = outcomes.filter(\n      (outcome): outcome is Extract<Outcome, { ok: false }> => !outcome.ok\n    );\n    if (failures.length > 0 || schedulerFailure !== undefined) {\n      const details = failures.map(({ error, key }) => `${key}: ${error.message}`).join(\"; \");\n      const cancelled =\n        failures.every(({ error }) => isPipelineCancellation(error, context)) &&\n        (schedulerFailure === undefined || isPipelineCancellation(schedulerFailure, context));\n      const primaryError = cancelled\n        ? (failures[0]?.error ?? schedulerFailure)\n        : (failures.find(({ error }) => !isPipelineCancellation(error, context))?.error ??\n          failures[0]?.error ??\n          schedulerFailure);\n      const message =\n        failures.length > 0\n          ? `Mapped child pipeline ${config.pipeline.id} failed for ${failures.length} item(s): ${details}`\n          : `Mapped child pipeline ${config.pipeline.id} failed: ${primaryError?.message ?? \"aborted\"}`;\n      throw new PipelineChildError(message, cancelled, primaryError, {\n        failures: failures.slice(0, 32).map(({ error, key, index }) => ({\n          error,\n          key,\n          index,\n          cancelled: isPipelineCancellation(error, context),\n        })),\n        failureCount: failures.length,\n        schedulerError: schedulerFailure,\n      });\n    }\n    // SAFETY: when failures.length === 0 every outcome was produced by the\n    // success branch (return { key, ok: true, value }), so each outcome is\n    // necessarily `{ ok: true }`; the assertion narrows the union accordingly.\n    return outcomes.map((outcome) => (outcome as Extract<Outcome, { ok: true }>).value);\n  };\n}\n"]}

package/dist/core/child-progress.js

@@ -131,6 +131,8 @@ function createChildProgress(plan) {
             if (event.outputSource === "override") {
                 message += " (overridden)";
             }
+            if (event.outputSource === "cache")
+                message += " (cached)";
             const previous = terminalSteps.size;
             if (event.status !== "running")
                 terminalSteps.add(event.step.id);

package/dist/core/child-progress.js.map

@@ -1 +1 @@
-{"version":3,"file":"child-progress.js","sourceRoot":"","sources":["../../src/core/child-progress.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  PipelineHooks,\n  PipelinePlan,\n  PipelineStepProgress,\n  PipelineStepProgressDetail,\n  PipelineStepStatus,\n} from \"./pipeline-types.js\";\nimport { hasVisibleStepProgress } from \"./progress.js\";\nimport {\n  mappedChildProgressSummary,\n  type MappedChildProgressSnapshot,\n  type ToMappedChildStepProgressOptions,\n} from \"./mapped-child-progress.js\";\n\nconst LIVE_FAN_OUT_GROUP_LIMIT = 32;\n\ntype ReportProgress = (progress: PipelineStepProgress) => void;\n\nfunction sameChildProgress(\n  left: PipelineStepProgress | undefined,\n  right: PipelineStepProgress | undefined\n): boolean {\n  if (left === right) return true;\n  if (\n    !left ||\n    !right ||\n    !Object.is(left.completed, right.completed) ||\n    !Object.is(left.total, right.total) ||\n    left.message !== right.message\n  )\n    return false;\n  if (left.details === right.details) return true;\n  const leftDetails = left.details ?? [];\n  const rightDetails = right.details ?? [];\n  return (\n    leftDetails.length === rightDetails.length &&\n    leftDetails.every((row, index) => {\n      const other = rightDetails[index]!;\n      return (\n        row === other ||\n        (row.id === other.id &&\n          row.name === other.name &&\n          Object.is(row.depth, other.depth) &&\n          Object.is(row.completed, other.completed) &&\n          Object.is(row.total, other.total) &&\n          row.label === other.label &&\n          row.status === other.status &&\n          row.outputSource === other.outputSource)\n      );\n    })\n  );\n}\n\nfunction sameChildStatus(left: PipelineStepStatus, right: PipelineStepStatus): boolean {\n  if (left.status !== right.status) return false;\n  if (left.status === \"planned\" || right.status === \"planned\") return true;\n  if (left.attemptId !== right.attemptId || left.outputSource !== right.outputSource) return false;\n  if (left.status === \"running\" || right.status === \"running\") {\n    return (\n      left.status === \"running\" &&\n      right.status === \"running\" &&\n      sameChildProgress(left.progress, right.progress)\n    );\n  }\n  return left.finishedAtMs === right.finishedAtMs;\n}\n\n/** External children may emit either hook family, or both for the same event. */\nfunction childProgressHooks(update: (event: PipelineStepStatus) => void): PipelineHooks {\n  const pending = new Map<string, { event: PipelineStepStatus; focused: boolean }>();\n  const consume = (event: PipelineStepStatus, focused: boolean): void => {\n    const previous = pending.get(event.step.id);\n    if (previous && previous.focused !== focused && sameChildStatus(previous.event, event)) {\n      pending.delete(event.step.id);\n      return;\n    }\n    pending.set(event.step.id, { event, focused });\n    update(event);\n  };\n  const onFocusedStatus = (event: PipelineStepStatus): void => consume(event, true);\n  return {\n    onStepStatus: (event) => consume(event, false),\n    onStepStart: onFocusedStatus,\n    onStepProgress: onFocusedStatus,\n    onStepComplete: onFocusedStatus,\n    onStepSkip: onFocusedStatus,\n    onStepCancel: onFocusedStatus,\n    onStepFail: onFocusedStatus,\n  };\n}\n\n/** Retain one child's step states without forwarding its lifecycle to parent hooks. */\nfunction createChildProgress(plan: PipelinePlan) {\n  const rows = new Map<string, PipelineStepProgressDetail>();\n  const progress = new Map<string, PipelineStepProgress>();\n  const terminalSteps = new Set<string>();\n  for (const step of plan.steps) {\n    if (step.selected) rows.set(step.id, { id: step.id, name: step.name, status: \"pending\" });\n  }\n  return {\n    total: plan.ok ? rows.size : 0,\n    get completed() {\n      return terminalSteps.size;\n    },\n    complete(): number {\n      const previous = terminalSteps.size;\n      if (plan.ok) for (const id of rows.keys()) terminalSteps.add(id);\n      return terminalSteps.size - previous;\n    },\n    update(event: PipelineStepStatus) {\n      const name = event.step.name ?? event.step.id;\n      // Filtered steps are announced by single children, but never counted or\n      // included in the retained tree or mapped activity labels.\n      if (event.status === \"skipped\" && event.reason === \"filtered\") {\n        return { message: `${name}: skipped: filtered`, label: undefined, terminalDelta: 0 };\n      }\n      if (!rows.has(event.step.id) || event.status === \"planned\") return;\n      let message: string;\n      let label: string;\n      let errorLabel: string | undefined;\n      switch (event.status) {\n        case \"running\":\n          if (event.progress) {\n            if (!hasVisibleStepProgress(event.progress)) return;\n            progress.set(event.step.id, event.progress);\n            message = event.progress.message ?? `${event.progress.completed} completed`;\n            label = `${name}:${event.progress.message ?? (event.progress.total !== undefined ? `${event.progress.completed}/${event.progress.total}` : `${event.progress.completed}`)}`;\n          } else {\n            message = \"started\";\n            label = name;\n          }\n          break;\n        case \"completed\":\n          message = \"complete\";\n          label = `${name}:complete`;\n          break;\n        case \"skipped\":\n          message = `skipped: ${event.reason}`;\n          label = `${name}:skipped:${event.reason}`;\n          errorLabel = event.message ?? event.reason;\n          break;\n        case \"cancelled\":\n        case \"failed\":\n          message = `${event.status}: ${event.error.message}`;\n          label = `${name}:${event.status}`;\n          errorLabel = event.error.message;\n          break;\n      }\n      if (event.outputSource === \"override\") {\n        message += \" (overridden)\";\n      }\n      const previous = terminalSteps.size;\n      if (event.status !== \"running\") terminalSteps.add(event.step.id);\n      const latest = progress.get(event.step.id);\n      const row: PipelineStepProgressDetail = {\n        id: event.step.id,\n        name: event.step.name,\n        status: event.status,\n        ...(event.outputSource ? { outputSource: event.outputSource } : {}),\n      };\n      if (latest) {\n        row.completed = latest.completed;\n        row.total = latest.total;\n        row.label = latest.message;\n      }\n      if (errorLabel !== undefined) row.label = errorLabel;\n      rows.set(event.step.id, row);\n      return {\n        message: `${name}: ${message}`,\n        label,\n        terminalDelta: terminalSteps.size - previous,\n      };\n    },\n    details(): PipelineStepProgressDetail[] {\n      return [...rows.values()].flatMap((row) => [\n        { ...row },\n        ...(progress.get(row.id)?.details ?? []).map((detail) => ({\n          ...detail,\n          depth: (detail.depth ?? 0) + 1,\n          status:\n            (detail.status ?? \"running\") === \"running\" && row.status !== \"running\"\n              ? row.status\n              : detail.status,\n        })),\n      ]);\n    },\n  };\n}\n\n/** Project canonical child statuses into the opaque parent's progress. */\nexport function createSingleChildProgress(\n  plan: PipelinePlan,\n  report: ReportProgress\n): PipelineHooks {\n  const child = createChildProgress(plan);\n  return childProgressHooks((event) => {\n    const update = child.update(event);\n    if (!update) return;\n    report({\n      completed: child.completed,\n      total: Math.max(1, child.total),\n      message: `${plan.pipelineId}/${update.message}`,\n      details: child.details(),\n    });\n  });\n}\n\n/** Own fan-out counts, activity labels and bounded detail rendering. */\nexport function createMappedChildProgress(\n  keys: readonly string[],\n  concurrency: number,\n  options: ToMappedChildStepProgressOptions | undefined,\n  report: ReportProgress\n) {\n  const active = new Map<string, string>();\n  const failedKeys = new Set<string>();\n  const itemIndexes = new Map(keys.map((key, index) => [key, index]));\n  const itemRows = new Map<string, PipelineStepProgressDetail>(\n    keys.map((id) => [id, { id, status: \"pending\" }])\n  );\n  const children = new Map<string, ReturnType<typeof createChildProgress>>();\n  let finishedItems = 0;\n  let failedItems = 0;\n  let stepsPerItem = 0;\n  let plannedChildSteps = 0;\n  let plannedItems = 0;\n  let terminalChildSteps = 0;\n\n  const publish = (spotlight?: string, final = false): void => {\n    const snapshot: MappedChildProgressSnapshot = {\n      active,\n      concurrency,\n      failedItems,\n      finishedItems,\n      itemCount: keys.length,\n      plannedChildSteps,\n      plannedItems,\n      stepsPerItem,\n      terminalChildSteps,\n      spotlight,\n    };\n    // Materialize only the visible window. Active and failed sets avoid a\n    // scan or sort of the entire fan-out on every child status event.\n    const limit = Math.max(0, Math.floor(options?.detailLimit ?? LIVE_FAN_OUT_GROUP_LIMIT)) || 0;\n    let visibleKeys: readonly string[];\n    if (final && options?.detailLimit === undefined) {\n      visibleKeys = keys;\n    } else {\n      const visible = new Set<string>();\n      for (const candidates of [active.keys(), failedKeys.keys(), keys.values()]) {\n        for (const key of candidates) {\n          if (visible.size >= limit) break;\n          visible.add(key);\n        }\n      }\n      visibleKeys = [...visible].sort(\n        (left, right) => itemIndexes.get(left)! - itemIndexes.get(right)!\n      );\n    }\n    const details = visibleKeys.flatMap((key) => [\n      { ...itemRows.get(key)! },\n      ...(children.get(key)?.details() ?? []).map((detail) => ({\n        ...detail,\n        depth: (detail.depth ?? 0) + 1,\n      })),\n    ]);\n    if (visibleKeys.length < keys.length) {\n      details.push({ id: `+${keys.length - visibleKeys.length} more`, status: \"pending\" });\n    }\n    report({ ...mappedChildProgressSummary(snapshot, options), details });\n  };\n\n  return {\n    publish,\n    start(key: string): void {\n      active.set(key, \"starting\");\n      itemRows.set(key, { id: key, status: \"running\" });\n      publish();\n    },\n    plan(key: string, plan: PipelinePlan): PipelineHooks {\n      const child = createChildProgress(plan);\n      children.set(key, child);\n      if (plan.ok) {\n        plannedChildSteps += child.total;\n        plannedItems += 1;\n        stepsPerItem = Math.max(stepsPerItem, child.total);\n      }\n      return childProgressHooks((event) => {\n        const update = child.update(event);\n        if (!update || update.label === undefined) return;\n        terminalChildSteps += update.terminalDelta;\n        active.set(key, update.label);\n        publish();\n      });\n    },\n    childCompleted(key: string): void {\n      // Public child implementations may return success without emitting all\n      // statuses. Reconcile their selected steps before mapping the result.\n      terminalChildSteps += children.get(key)?.complete() ?? 0;\n    },\n    complete(key: string): void {\n      active.delete(key);\n      itemRows.set(key, { id: key, status: \"completed\" });\n      finishedItems += 1;\n      publish(`${key}: completed`);\n    },\n    fail(key: string, error: Error, cancelled: boolean): void {\n      active.delete(key);\n      itemRows.set(key, {\n        id: key,\n        status: cancelled ? \"cancelled\" : \"failed\",\n        label: error.message,\n      });\n      failedKeys.add(key);\n      failedItems += 1;\n      publish(`${key}: failed`);\n    },\n    finish(): void {\n      if (options?.detailLimit === undefined && keys.length > LIVE_FAN_OUT_GROUP_LIMIT) {\n        publish(undefined, true);\n      }\n    },\n  };\n}\n"]}
+{"version":3,"file":"child-progress.js","sourceRoot":"","sources":["../../src/core/child-progress.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  PipelineHooks,\n  PipelinePlan,\n  PipelineStepProgress,\n  PipelineStepProgressDetail,\n  PipelineStepStatus,\n} from \"./pipeline-types.js\";\nimport { hasVisibleStepProgress } from \"./progress.js\";\nimport {\n  mappedChildProgressSummary,\n  type MappedChildProgressSnapshot,\n  type ToMappedChildStepProgressOptions,\n} from \"./mapped-child-progress.js\";\n\nconst LIVE_FAN_OUT_GROUP_LIMIT = 32;\n\ntype ReportProgress = (progress: PipelineStepProgress) => void;\n\nfunction sameChildProgress(\n  left: PipelineStepProgress | undefined,\n  right: PipelineStepProgress | undefined\n): boolean {\n  if (left === right) return true;\n  if (\n    !left ||\n    !right ||\n    !Object.is(left.completed, right.completed) ||\n    !Object.is(left.total, right.total) ||\n    left.message !== right.message\n  )\n    return false;\n  if (left.details === right.details) return true;\n  const leftDetails = left.details ?? [];\n  const rightDetails = right.details ?? [];\n  return (\n    leftDetails.length === rightDetails.length &&\n    leftDetails.every((row, index) => {\n      const other = rightDetails[index]!;\n      return (\n        row === other ||\n        (row.id === other.id &&\n          row.name === other.name &&\n          Object.is(row.depth, other.depth) &&\n          Object.is(row.completed, other.completed) &&\n          Object.is(row.total, other.total) &&\n          row.label === other.label &&\n          row.status === other.status &&\n          row.outputSource === other.outputSource)\n      );\n    })\n  );\n}\n\nfunction sameChildStatus(left: PipelineStepStatus, right: PipelineStepStatus): boolean {\n  if (left.status !== right.status) return false;\n  if (left.status === \"planned\" || right.status === \"planned\") return true;\n  if (left.attemptId !== right.attemptId || left.outputSource !== right.outputSource) return false;\n  if (left.status === \"running\" || right.status === \"running\") {\n    return (\n      left.status === \"running\" &&\n      right.status === \"running\" &&\n      sameChildProgress(left.progress, right.progress)\n    );\n  }\n  return left.finishedAtMs === right.finishedAtMs;\n}\n\n/** External children may emit either hook family, or both for the same event. */\nfunction childProgressHooks(update: (event: PipelineStepStatus) => void): PipelineHooks {\n  const pending = new Map<string, { event: PipelineStepStatus; focused: boolean }>();\n  const consume = (event: PipelineStepStatus, focused: boolean): void => {\n    const previous = pending.get(event.step.id);\n    if (previous && previous.focused !== focused && sameChildStatus(previous.event, event)) {\n      pending.delete(event.step.id);\n      return;\n    }\n    pending.set(event.step.id, { event, focused });\n    update(event);\n  };\n  const onFocusedStatus = (event: PipelineStepStatus): void => consume(event, true);\n  return {\n    onStepStatus: (event) => consume(event, false),\n    onStepStart: onFocusedStatus,\n    onStepProgress: onFocusedStatus,\n    onStepComplete: onFocusedStatus,\n    onStepSkip: onFocusedStatus,\n    onStepCancel: onFocusedStatus,\n    onStepFail: onFocusedStatus,\n  };\n}\n\n/** Retain one child's step states without forwarding its lifecycle to parent hooks. */\nfunction createChildProgress(plan: PipelinePlan) {\n  const rows = new Map<string, PipelineStepProgressDetail>();\n  const progress = new Map<string, PipelineStepProgress>();\n  const terminalSteps = new Set<string>();\n  for (const step of plan.steps) {\n    if (step.selected) rows.set(step.id, { id: step.id, name: step.name, status: \"pending\" });\n  }\n  return {\n    total: plan.ok ? rows.size : 0,\n    get completed() {\n      return terminalSteps.size;\n    },\n    complete(): number {\n      const previous = terminalSteps.size;\n      if (plan.ok) for (const id of rows.keys()) terminalSteps.add(id);\n      return terminalSteps.size - previous;\n    },\n    update(event: PipelineStepStatus) {\n      const name = event.step.name ?? event.step.id;\n      // Filtered steps are announced by single children, but never counted or\n      // included in the retained tree or mapped activity labels.\n      if (event.status === \"skipped\" && event.reason === \"filtered\") {\n        return { message: `${name}: skipped: filtered`, label: undefined, terminalDelta: 0 };\n      }\n      if (!rows.has(event.step.id) || event.status === \"planned\") return;\n      let message: string;\n      let label: string;\n      let errorLabel: string | undefined;\n      switch (event.status) {\n        case \"running\":\n          if (event.progress) {\n            if (!hasVisibleStepProgress(event.progress)) return;\n            progress.set(event.step.id, event.progress);\n            message = event.progress.message ?? `${event.progress.completed} completed`;\n            label = `${name}:${event.progress.message ?? (event.progress.total !== undefined ? `${event.progress.completed}/${event.progress.total}` : `${event.progress.completed}`)}`;\n          } else {\n            message = \"started\";\n            label = name;\n          }\n          break;\n        case \"completed\":\n          message = \"complete\";\n          label = `${name}:complete`;\n          break;\n        case \"skipped\":\n          message = `skipped: ${event.reason}`;\n          label = `${name}:skipped:${event.reason}`;\n          errorLabel = event.message ?? event.reason;\n          break;\n        case \"cancelled\":\n        case \"failed\":\n          message = `${event.status}: ${event.error.message}`;\n          label = `${name}:${event.status}`;\n          errorLabel = event.error.message;\n          break;\n      }\n      if (event.outputSource === \"override\") {\n        message += \" (overridden)\";\n      }\n      if (event.outputSource === \"cache\") message += \" (cached)\";\n      const previous = terminalSteps.size;\n      if (event.status !== \"running\") terminalSteps.add(event.step.id);\n      const latest = progress.get(event.step.id);\n      const row: PipelineStepProgressDetail = {\n        id: event.step.id,\n        name: event.step.name,\n        status: event.status,\n        ...(event.outputSource ? { outputSource: event.outputSource } : {}),\n      };\n      if (latest) {\n        row.completed = latest.completed;\n        row.total = latest.total;\n        row.label = latest.message;\n      }\n      if (errorLabel !== undefined) row.label = errorLabel;\n      rows.set(event.step.id, row);\n      return {\n        message: `${name}: ${message}`,\n        label,\n        terminalDelta: terminalSteps.size - previous,\n      };\n    },\n    details(): PipelineStepProgressDetail[] {\n      return [...rows.values()].flatMap((row) => [\n        { ...row },\n        ...(progress.get(row.id)?.details ?? []).map((detail) => ({\n          ...detail,\n          depth: (detail.depth ?? 0) + 1,\n          status:\n            (detail.status ?? \"running\") === \"running\" && row.status !== \"running\"\n              ? row.status\n              : detail.status,\n        })),\n      ]);\n    },\n  };\n}\n\n/** Project canonical child statuses into the opaque parent's progress. */\nexport function createSingleChildProgress(\n  plan: PipelinePlan,\n  report: ReportProgress\n): PipelineHooks {\n  const child = createChildProgress(plan);\n  return childProgressHooks((event) => {\n    const update = child.update(event);\n    if (!update) return;\n    report({\n      completed: child.completed,\n      total: Math.max(1, child.total),\n      message: `${plan.pipelineId}/${update.message}`,\n      details: child.details(),\n    });\n  });\n}\n\n/** Own fan-out counts, activity labels and bounded detail rendering. */\nexport function createMappedChildProgress(\n  keys: readonly string[],\n  concurrency: number,\n  options: ToMappedChildStepProgressOptions | undefined,\n  report: ReportProgress\n) {\n  const active = new Map<string, string>();\n  const failedKeys = new Set<string>();\n  const itemIndexes = new Map(keys.map((key, index) => [key, index]));\n  const itemRows = new Map<string, PipelineStepProgressDetail>(\n    keys.map((id) => [id, { id, status: \"pending\" }])\n  );\n  const children = new Map<string, ReturnType<typeof createChildProgress>>();\n  let finishedItems = 0;\n  let failedItems = 0;\n  let stepsPerItem = 0;\n  let plannedChildSteps = 0;\n  let plannedItems = 0;\n  let terminalChildSteps = 0;\n\n  const publish = (spotlight?: string, final = false): void => {\n    const snapshot: MappedChildProgressSnapshot = {\n      active,\n      concurrency,\n      failedItems,\n      finishedItems,\n      itemCount: keys.length,\n      plannedChildSteps,\n      plannedItems,\n      stepsPerItem,\n      terminalChildSteps,\n      spotlight,\n    };\n    // Materialize only the visible window. Active and failed sets avoid a\n    // scan or sort of the entire fan-out on every child status event.\n    const limit = Math.max(0, Math.floor(options?.detailLimit ?? LIVE_FAN_OUT_GROUP_LIMIT)) || 0;\n    let visibleKeys: readonly string[];\n    if (final && options?.detailLimit === undefined) {\n      visibleKeys = keys;\n    } else {\n      const visible = new Set<string>();\n      for (const candidates of [active.keys(), failedKeys.keys(), keys.values()]) {\n        for (const key of candidates) {\n          if (visible.size >= limit) break;\n          visible.add(key);\n        }\n      }\n      visibleKeys = [...visible].sort(\n        (left, right) => itemIndexes.get(left)! - itemIndexes.get(right)!\n      );\n    }\n    const details = visibleKeys.flatMap((key) => [\n      { ...itemRows.get(key)! },\n      ...(children.get(key)?.details() ?? []).map((detail) => ({\n        ...detail,\n        depth: (detail.depth ?? 0) + 1,\n      })),\n    ]);\n    if (visibleKeys.length < keys.length) {\n      details.push({ id: `+${keys.length - visibleKeys.length} more`, status: \"pending\" });\n    }\n    report({ ...mappedChildProgressSummary(snapshot, options), details });\n  };\n\n  return {\n    publish,\n    start(key: string): void {\n      active.set(key, \"starting\");\n      itemRows.set(key, { id: key, status: \"running\" });\n      publish();\n    },\n    plan(key: string, plan: PipelinePlan): PipelineHooks {\n      const child = createChildProgress(plan);\n      children.set(key, child);\n      if (plan.ok) {\n        plannedChildSteps += child.total;\n        plannedItems += 1;\n        stepsPerItem = Math.max(stepsPerItem, child.total);\n      }\n      return childProgressHooks((event) => {\n        const update = child.update(event);\n        if (!update || update.label === undefined) return;\n        terminalChildSteps += update.terminalDelta;\n        active.set(key, update.label);\n        publish();\n      });\n    },\n    childCompleted(key: string): void {\n      // Public child implementations may return success without emitting all\n      // statuses. Reconcile their selected steps before mapping the result.\n      terminalChildSteps += children.get(key)?.complete() ?? 0;\n    },\n    complete(key: string): void {\n      active.delete(key);\n      itemRows.set(key, { id: key, status: \"completed\" });\n      finishedItems += 1;\n      publish(`${key}: completed`);\n    },\n    fail(key: string, error: Error, cancelled: boolean): void {\n      active.delete(key);\n      itemRows.set(key, {\n        id: key,\n        status: cancelled ? \"cancelled\" : \"failed\",\n        label: error.message,\n      });\n      failedKeys.add(key);\n      failedItems += 1;\n      publish(`${key}: failed`);\n    },\n    finish(): void {\n      if (options?.detailLimit === undefined && keys.length > LIVE_FAN_OUT_GROUP_LIMIT) {\n        publish(undefined, true);\n      }\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,68 @@
+import { type ArtifactMetadata, type ArtifactRecord } from "../tracing/artifact-metadata.js";
+import type { PipelineExecutionContext } from "./pipeline-types.js";
+/** Cache I/O is cancellable and independent of pipeline scheduling. */
+export interface StepCacheContext {
+    readonly signal?: AbortSignal;
+}
+/** Encoded raw handler result and its creation time; expiration is enforced by core. */
+export interface StepCacheEntry {
+    readonly value: Uint8Array;
+    readonly createdAtMs: number;
+    /** Optional receipt identifying the stored bytes, refreshed by the adapter on reads. */
+    readonly artifact?: ArtifactMetadata;
+}
+/** Store timestamped encoded handler results; only undefined means a cache miss. */
+export interface StepCacheStore {
+    get(key: string, context: StepCacheContext): StepCacheEntry | undefined | Promise<StepCacheEntry | undefined>;
+    /** Return an optional receipt after persistence succeeds; core supplies a stable artifact ID. */
+    set(key: string, entry: StepCacheEntry, context: StepCacheContext): void | ArtifactMetadata | Promise<void | ArtifactMetadata>;
+}
+/** Encode a detached snapshot; decode must produce a fresh handler-result value. */
+export interface StepCacheCodec {
+    encode(value: unknown): Uint8Array | Promise<Uint8Array>;
+    decode(value: Uint8Array): unknown | Promise<unknown>;
+}
+/** Use reads and writes, recompute replaces entries, bypass performs no cache work. */
+export type StepCachePolicy = "use" | "recompute" | "bypass";
+interface CacheSettings {
+    /** Maximum acceptable age: milliseconds or a fixed duration such as "30 days" or "12h". */
+    readonly maxAge?: string | number;
+    readonly store?: StepCacheStore;
+    readonly codec?: StepCacheCodec;
+}
+/** Defaults for opted-in steps; configuring defaults does not make other steps cacheable. */
+export interface PipelineCacheOptions extends CacheSettings {
+    /** Root directory relative to the run's cwd; defaults to .cache with pipeline/step subdirectories. */
+    readonly directory?: string;
+}
+type CachePolicyResolver<TInputs, TOptions extends object> = {
+    resolve(inputs: TInputs, context: PipelineExecutionContext<TOptions>): StepCachePolicy | Promise<StepCachePolicy>;
+}["resolve"];
+/** Opt a deterministic ordinary step into caching, with optional overrides of pipeline defaults. */
+export interface StepCache<TInputs, TOptions extends object = {}> extends CacheSettings {
+    /** Explicit implementation identity; defaults to the pipeline's implementationVersion. */
+    readonly version?: string;
+    /** Override the hash of dependency inputs and validated options; null bypasses this invocation. */
+    key?(inputs: TInputs, context: PipelineExecutionContext<TOptions>): string | null | Promise<string | null>;
+    readonly policy?: StepCachePolicy | CachePolicyResolver<TInputs, TOptions>;
+}
+export interface CompiledStepCache<TOptions extends object> extends StepCache<Record<string, unknown>, TOptions> {
+    readonly version: string;
+    readonly directory: string;
+    readonly maxAge?: number;
+}
+export declare function validatePipelineCache(settings: PipelineCacheOptions | undefined): void;
+export declare function compileStepCache<TOptions extends object>(source: boolean | StepCache<Record<string, unknown>, TOptions> | undefined, defaults: PipelineCacheOptions | undefined, implementationVersion: string | undefined): CompiledStepCache<TOptions> | undefined;
+/** One execution path: cache raw handler results, then validate every publication. */
+export declare function executeWithStepCache<TOptions extends object>(input: {
+    cache: CompiledStepCache<TOptions> | undefined;
+    pipelineId: string;
+    stepId: string;
+    inputs: Record<string, unknown>;
+    context: PipelineExecutionContext<TOptions>;
+    run(): Promise<unknown>;
+    validate(value: unknown): Promise<unknown>;
+    onHit(): void;
+    onArtifact(record: ArtifactRecord): void;
+}): Promise<unknown>;
+export {};