tubeless 0.2.3 → 0.2.5

package/README.md

@@ -5,7 +5,7 @@
 </p>
 <h1 align="center">Tubeless</h1>
 <p align="center">
-  Define a typed graph. Plan a target. Run it from Node.
+  Typed execution pipelines. Keep your workflow rolling.
 </p>
 <p align="center">
   <a href="https://www.npmjs.com/package/tubeless"><img alt="npm" src="https://img.shields.io/npm/v/tubeless?style=flat-square&labelColor=121212&color=c4a046"></a>
@@ -13,22 +13,32 @@
   <a href="./LICENSE"><img alt="MIT" src="https://img.shields.io/npm/l/tubeless?style=flat-square&labelColor=121212&color=c4c0b4"></a>
 </p>
 
-Typed, observable data pipelines you import from TypeScript or run from a Bun
-CLI. It is a library, not a hosted workflow engine or a Make/npm-scripts
-replacement. Tubeless is pre-1.0; its public API may change.
+Tubeless is a TypeScript toolkit for work that unfolds in steps. It fits data
+pipelines, multi-step application workflows, and AI workloads—anywhere you want
+explicit dependencies, typed handoffs, and inspectable execution.
+
+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.
+For scheduling or crash recovery, pair it with a [queue or workflow engine](./docs/comparison.md).
+
+## Installation
 
 ```sh
 npm install tubeless
 ```
 
-Also `pnpm add tubeless`, `yarn add tubeless`, or `bun add tubeless`. Library
-imports are ESM-only on Node.js 22+. The `tubeless` CLI requires Bun 1.3.14+;
-`npx tubeless` works anywhere with Bun installed and otherwise prints Bun
-install instructions. Linux and macOS are supported; Windows is untested. See
-[install and runtime](./docs/getting-started.md#install).
+The library uses ESM and requires Node.js 22 or later. The CLI also requires
+Bun 1.3.14 or later. Linux and macOS are supported; Windows is untested.
+See [installation and runtime support](./docs/getting-started.md#install).
+
+Tubeless is pre-1.0, so the public API may change between releases.
 
 ## Quick start
 
+This pipeline loads a list of strings, normalizes them, and returns the result.
+Declaring `load` as a dependency gives `normalize` a typed input.
+
 ```ts
 import { createSteps, definePipeline, requireOutputs } from "tubeless";
 
@@ -58,12 +68,15 @@ const rows = await ImportPipeline.runOrThrow({ lines: [" Alpha ", "", "Beta"] })
 // ["alpha", "beta"]
 ```
 
-`createSteps` types domain options only. Runs accept built-in controls beside
-them. Use `runOrThrow` when failure should throw, `run` for the structured
-report, `plan` when nothing should execute, and `toMermaid` for the static
-graph.
+`runOrThrow` returns the result or throws if the run fails. Use `run` for a
+report with step statuses, errors, and timings; `plan` to preview execution; or
+`toMermaid` to draw the graph. See the [getting started guide](./docs/getting-started.md).
+
+## Use the CLI
 
-## Inspect, plan, or run
+Define commands with `tubeless/cli` and catalogs with `tubeless/project`.
+The [CLI guide](./docs/cli.md) explains how to set up the manifest and commands.
+With an `import-rows` command registered, you can run:
 
 ```sh
 bunx tubeless list # reads ./tubeless.project.ts
@@ -71,49 +84,36 @@ bunx tubeless inspect import-rows
 bunx tubeless run import-rows -- --source input.json
 ```
 
-The project manifest explicitly registers stable command IDs, module paths, and
-execution cwd without scanning the filesystem. The CLI loads TypeScript modules
-with Bun; existing file-oriented commands remain available. Application flags
-go after `--`. `history` lists recorded
-`--store` runs or reads a finished `--trace` artifact without opening the studio. See
-[the CLI](./docs/cli.md) and [the local studio](./docs/studio.md).
-
-## Choose the right pattern
-
-| You need to…                                 | Start with                                                                |
-| -------------------------------------------- | ------------------------------------------------------------------------- |
-| Run typed steps in dependency order          | [Sequential pipeline](./examples/typed-import.ts)                         |
-| Validate external boundary values            | [Validated boundaries](./examples/validated-boundaries.ts)                |
-| Preview writes safely                        | [Dry runs and write gates](./examples/publish-with-gates.ts)              |
-| Skip work intentionally at runtime           | [Conditional step](./examples/conditional-step.ts)                        |
-| Continue independent work after a failure    | [Best-effort execution](./examples/best-effort.ts)                        |
-| Reuse a pipeline inside another              | [Child pipeline](./examples/child-pipeline.ts)                            |
-| Run a step on another engine                 | [Remote steps](./examples/remote-steps.ts)                                |
-| Run one child pipeline for many items        | [Fan-out and progress](./examples/fan-out-progress.ts)                    |
-| Resume long API work safely                  | [Retry, rate limit, and checkpoint](./examples/resumable-enrichment.ts)   |
-| Watch the live TTY reporter                  | [Live TUI](./examples/live-tui.ts)                                        |
-| Watch many primitives on a road-race weekend | [Peloton pipeline](./examples/peloton.ts)                                 |
-| Turn a pipeline into a typed script          | [Pipeline CLI](./examples/cli-job.ts)                                     |
-| Render plans and errors consistently         | [Human and JSON rendering](./examples/rendering.ts)                       |
-| Test deterministic execution                 | [Cancellation and test injection](./examples/cancellation-and-testing.ts) |
-| Export lifecycle telemetry                   | [Structured tracing](./examples/tracing.ts)                               |
-| Persist and inspect local runs               | [Local observability](./examples/local-observability.ts)                  |
-
-Install the [agent skill pack](./docs/agent-skills.md) with `npx skills add chetmancini/tubeless` to convert existing code using `tubeless-make-pipeline`. The [recipe index](./docs/recipes.md) explains each pattern.
-
-## Docs
-
-[Website](https://tubeless.io/) ·
-[Getting started](./docs/getting-started.md) · [CLI](./docs/cli.md) ·
+The CLI loads TypeScript modules with Bun. Pass application flags after `--`.
+Record runs with `--store` or save a portable trace with `--trace`, then inspect
+them with `tubeless history` or the [local studio](./docs/studio.md).
+
+## Find your route
+
+- Start with a [typed import](./examples/typed-import.ts) or add
+  [dry runs and write gates](./examples/publish-with-gates.ts) to a publishing job.
+- Build a larger workflow with [child pipelines](./examples/child-pipeline.ts)
+  and [fan-out](./examples/fan-out-progress.ts).
+- Take the [peloton example](./examples/peloton.ts) for a spin: a road-race weekend
+  workflow that brings several pipeline features together.
+
+The [recipe index](./docs/recipes.md) covers validation, retries, tracing, testing,
+and more. For help authoring pipelines with a coding agent, install the
+[agent skill pack](./docs/agent-skills.md) with `npx skills add chetmancini/tubeless`.
+
+## Documentation
+
+[Website](https://tubeless.io/) · [Getting started](./docs/getting-started.md) · [CLI](./docs/cli.md) ·
 [Studio](./docs/studio.md) · [Concepts](./docs/concepts.md) ·
 [Comparison](./docs/comparison.md) · [API](./docs/api-reference.md) ·
-[Agents](./docs/agent-guide.md) · [Studio OpenAPI](https://tubeless.io/openapi.json)
+[Agents](./docs/agent-guide.md)
 
 ## Contributing
 
-Pull requests are accepted for now; the maintainer set stays small. See
-[CONTRIBUTING.md](./CONTRIBUTING.md). Report vulnerabilities privately
-through [SECURITY.md](./SECURITY.md).
+Bug reports, documentation improvements, and focused pull requests are welcome.
+Open an [issue](https://github.com/chetmancini/tubeless/issues) before starting a
+large change or changing the public API. See [CONTRIBUTING.md](./CONTRIBUTING.md)
+for local setup and checks, and [SECURITY.md](./SECURITY.md) to report a vulnerability privately.
 
 ## License
 

package/dist/cli/cli-types.d.ts

@@ -49,7 +49,7 @@ export interface CliBooleanParam extends CliParamBase {
 }
 export interface CliPathParam extends CliParamBase {
     type: "path";
-    /** Relative defaults and values are resolved against `context.cwd`, like `definePaths`. */
+    /** Relative defaults and values are resolved against `context.cwd`. */
     default?: string;
     optional?: boolean;
     /** Validates the resolved path exists before `run` is called. */
@@ -135,7 +135,7 @@ export type CliParams<TSchema extends CliParamsSchema> = {
 export interface CliContext {
     cwd: string;
     /** Environment used for `param.env` fallbacks. Defaults to `process.env`. */
-    env?: NodeJS.ProcessEnv;
+    env?: Record<string, string | undefined>;
     log: PipelineLogger;
     /** Optional executor-only context used when this command runs a pipeline. */
     pipelineContext?: Omit<PipelineContext, "cwd" | "log" | "signal">;

package/dist/cli/cli-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-types.js","sourceRoot":"","sources":["../../src/cli/cli-types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAgLpE,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAEhC,MAAM;IACN,QAAQ;IAFnB,YACW,MAAyB,EACzB,QAAgB;QAEzB,KAAK,CAAC,oCAAoC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;sBAHrF,MAAM;wBACN,QAAQ;QAGjB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACpB,QAAQ;IAA7B,YAAqB,QAAgB;QACnC,KAAK,CAAC,QAAQ,CAAC,CAAC;wBADG,QAAQ;QAE3B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,kBAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACvC,CAAC;CACF","sourcesContent":["import type { CheckpointStore } from \"../node/checkpoint.js\";\nimport type { PipelineContext, PipelineLogger } from \"../core/pipeline.js\";\nimport { brandTubelessError } from \"../utilities/tubeless-error.js\";\n\n/**\n * Typed command-line entry points for scripts, mirroring how `definePipeline` turns a\n * declarative step list into a runnable pipeline: declare a flag schema once and get a\n * fully-typed, validated `values` object handed to `run`, instead of each script hand-\n * rolling its own `process.argv` scanning and `as` casts.\n */\n\nexport type CliParamType = \"string\" | \"number\" | \"boolean\" | \"path\";\n\ninterface CliParamBase {\n  /** Shown next to the flag in generated `--help` output. */\n  description?: string;\n  /** UI adapters place execution controls in one section. Built-ins set this. */\n  group?: \"execution\";\n  /** UI adapters treat exclusive repeatable parameters as mutually exclusive. Built-ins set this on step and target selection. */\n  exclusive?: true;\n  /** Overrides the derived `--flag-name`; defaults to the kebab-case of the schema key. */\n  flag?: string;\n  /** Optional one-letter alias, for example `short: \"v\"` enables `-v`. */\n  short?: string;\n  /**\n   * Optional environment-variable fallback. Explicit argv values always win;\n   * the environment value is validated like argv but never echoed in errors.\n   */\n  env?: string;\n}\n\nexport interface CliStringParam extends CliParamBase {\n  type: \"string\";\n  choices?: readonly string[];\n  default?: string;\n  optional?: boolean;\n  /** Repeatable: `--flag a --flag b` accumulates into `readonly string[]`, `[]` when absent. Cannot combine with `default`. */\n  multiple?: boolean;\n}\n\nexport interface CliNumberParam extends CliParamBase {\n  type: \"number\";\n  default?: number;\n  optional?: boolean;\n  integer?: boolean;\n  min?: number;\n  max?: number;\n  /** Repeatable: `--flag 1 --flag 2` accumulates into `readonly number[]`, `[]` when absent. Cannot combine with `default`. */\n  multiple?: boolean;\n}\n\nexport interface CliBooleanParam extends CliParamBase {\n  type: \"boolean\";\n  /** Defaults to `false`. A bare `--flag` sets `true`; `--no-flag` sets `false`. */\n  default?: boolean;\n}\n\nexport interface CliPathParam extends CliParamBase {\n  type: \"path\";\n  /** Relative defaults and values are resolved against `context.cwd`, like `definePaths`. */\n  default?: string;\n  optional?: boolean;\n  /** Validates the resolved path exists before `run` is called. */\n  mustExist?: boolean;\n  /** Only checked when `mustExist` is true; asserts the resolved path's kind. */\n  kind?: \"file\" | \"directory\";\n}\n\nexport type CliParam = CliStringParam | CliNumberParam | CliBooleanParam | CliPathParam;\n\nexport type CliParamsSchema = Record<string, CliParam>;\n\n/** JSON-safe description of one validated command parameter for non-terminal clients. */\nexport interface CliParameterDescriptor {\n  readonly choices?: readonly string[];\n  readonly default?: string | number | boolean;\n  readonly description?: string;\n  readonly environment?: string;\n  readonly exclusive?: true;\n  readonly flag: string;\n  readonly group?: \"execution\";\n  readonly integer?: boolean;\n  readonly key: string;\n  readonly max?: number;\n  readonly min?: number;\n  readonly multiple: boolean;\n  readonly mustExist?: boolean;\n  readonly pathKind?: \"directory\" | \"file\";\n  readonly positional: boolean;\n  readonly required: boolean;\n  readonly short?: string;\n  readonly type: CliParamType;\n}\n\n/** Immutable, presentation-neutral command contract shared by CLI and UI adapters. */\nexport interface CliCommandDescriptor {\n  readonly description?: string;\n  readonly name: string;\n  readonly parameters: readonly CliParameterDescriptor[];\n}\n\ntype CliScalarStringValue<P extends CliParam> = P extends {\n  choices: readonly (infer TChoice extends string)[];\n}\n  ? TChoice\n  : string;\n\ntype CliParamValue<P extends CliParam> = P extends { type: \"string\" }\n  ? P extends { multiple: true }\n    ? readonly CliScalarStringValue<P>[]\n    : CliScalarStringValue<P>\n  : P extends { type: \"number\" }\n    ? P extends { multiple: true }\n      ? readonly number[]\n      : number\n    : P extends { type: \"boolean\" }\n      ? boolean\n      : P extends { type: \"path\" }\n        ? string\n        : never;\n\n/**\n * A field is optional in the parsed output only when it's explicitly marked `optional:\n * true` (booleans never are — an absent boolean flag just means `false`). A field with a\n * `default` is also always present at runtime, but that's already covered: schemas\n * shouldn't combine `default` with `optional: true`, and if one does, the parsed type is\n * merely wider than necessary (`T | undefined` instead of `T`), never wrong.\n */\ntype CliParamIsOptional<P extends CliParam> = P extends { type: \"boolean\" }\n  ? false\n  : P extends { multiple: true }\n    ? false\n    : P extends { optional: true }\n      ? true\n      : false;\n\ntype RequiredCliParams<TSchema extends CliParamsSchema> = {\n  [K in keyof TSchema as CliParamIsOptional<TSchema[K]> extends true ? never : K]: CliParamValue<\n    TSchema[K]\n  >;\n};\n\ntype OptionalCliParams<TSchema extends CliParamsSchema> = {\n  [K in keyof TSchema as CliParamIsOptional<TSchema[K]> extends true ? K : never]?: CliParamValue<\n    TSchema[K]\n  >;\n};\n\n/**\n * Every command's parsed values include `dryRun` and `resume`, whether or not `TSchema`\n * declares them. `resume` is `false` unless `--resume` is passed or `checkpoint.defaultResume`\n * is `true`; it's meaningful even without `checkpoint` configured — a command can implement\n * its own \"is this done\" check and just read `values.resume` directly.\n */\nexport type CliParams<TSchema extends CliParamsSchema> = {\n  dryRun: boolean;\n  resume: boolean;\n} & RequiredCliParams<TSchema> &\n  OptionalCliParams<TSchema>;\n\nexport interface CliContext {\n  cwd: string;\n  /** Environment used for `param.env` fallbacks. Defaults to `process.env`. */\n  env?: NodeJS.ProcessEnv;\n  log: PipelineLogger;\n  /** Optional executor-only context used when this command runs a pipeline. */\n  pipelineContext?: Omit<PipelineContext, \"cwd\" | \"log\" | \"signal\">;\n  /** Optional caller-owned cancellation signal forwarded to command work. */\n  signal?: AbortSignal;\n  /** Present whenever the command's `checkpoint` config is set; see `CliCheckpointConfig`. */\n  checkpoint?: CheckpointStore;\n}\n\nexport type CliParseResult<TSchema extends CliParamsSchema> =\n  | { kind: \"values\"; values: CliParams<TSchema> }\n  | { kind: \"help\"; helpText: string }\n  | { kind: \"error\"; errors: readonly string[]; helpText: string };\n\nexport class CliValidationError extends Error {\n  constructor(\n    readonly errors: readonly string[],\n    readonly helpText: string\n  ) {\n    super(`Invalid command-line arguments:\\n${errors.map((error) => `  - ${error}`).join(\"\\n\")}`);\n    this.name = \"CliValidationError\";\n    brandTubelessError(this, \"cli-validation\");\n  }\n}\n\nexport class CliHelpRequested extends Error {\n  constructor(readonly helpText: string) {\n    super(helpText);\n    this.name = \"CliHelpRequested\";\n    brandTubelessError(this, \"cli-help\");\n  }\n}\n\nexport interface CliCheckpointConfig {\n  /** Relative paths resolve against `context.cwd`, like `CliPathParam`. */\n  path: string;\n  /**\n   * Defaults to `true`: a fully successful, non-dry-run `run` clears the checkpoint —\n   * the one-shot resumable-job pattern (start fresh next time). Set `false` for an\n   * incrementally-growing \"done\" set (e.g. entity enrichment) that must never auto-clear,\n   * since clearing it would cause already-processed items to be reprocessed.\n   */\n  clearOnSuccess?: boolean;\n  /**\n   * Defaults to `false`: start fresh unless `--resume` is passed. Set `true` to always\n   * resume by default (skip already-recorded items every run); `--no-resume` is the free\n   * opt-out, since boolean flags already support `--no-<flag>` negation.\n   */\n  defaultResume?: boolean;\n}\n\nexport interface CliCommandConfig<TSchema extends CliParamsSchema, TResult> {\n  /** Shown in generated usage text; defaults to the running script's file name. */\n  name?: string;\n  description?: string;\n  /** `dryRun`/`--dry-run` and `-h`/`--help` are provided automatically; don't redeclare them. */\n  params: TSchema;\n  /**\n   * Schema keys accepted in positional order. Flags for an earlier positional\n   * let the next positional fill the next unset field; a repeatable positional\n   * must be last.\n   */\n  positionals?: readonly (keyof TSchema & string)[];\n  /**\n   * Opts into a managed checkpoint file. Adds a reserved `--resume`/`--no-resume` flag\n   * (also don't redeclare a `resume` param) and populates `context.checkpoint` before\n   * `run` is called: resolved fresh (existing file cleared) unless resuming, and cleared\n   * again after a successful non-dry-run unless `clearOnSuccess` is `false`.\n   */\n  checkpoint?: CliCheckpointConfig;\n  /** Runs after every field passes its own validation; return error messages to reject. */\n  validate?(values: CliParams<TSchema>, context: CliContext): string[] | void;\n  run(values: CliParams<TSchema>, context: CliContext): TResult | Promise<TResult>;\n}\n\nexport interface CliCommand<TSchema extends CliParamsSchema, TResult> {\n  /** Structured schema metadata for adapters that should not parse generated help text. */\n  readonly descriptor: CliCommandDescriptor;\n  /** Pure: parses and validates without calling `run` or touching the process. */\n  parse(argv?: readonly string[], context?: Partial<CliContext>): CliParseResult<TSchema>;\n  /** Validates structured parameter values without tokenizing command-line arguments. */\n  parseValues(\n    values: Record<string, unknown>,\n    context?: Partial<CliContext>\n  ): CliParseResult<TSchema>;\n  /** Calls `run` from already validated parameter values. */\n  execute(values: CliParams<TSchema>, context?: Partial<CliContext>): Promise<TResult>;\n  /** Parses and calls `run`; throws `CliValidationError`/`CliHelpRequested` instead of running it. */\n  run(argv?: readonly string[], context?: Partial<CliContext>): Promise<TResult>;\n  /**\n   * Entry point for `if (import.meta.main) void command.main();`. Prints help/errors and\n   * sets `process.exitCode` — never calls `process.exit`, so buffered output still flushes\n   * — instead of throwing.\n   */\n  main(argv?: readonly string[], context?: Partial<CliContext>): Promise<void>;\n}\n"]}
+{"version":3,"file":"cli-types.js","sourceRoot":"","sources":["../../src/cli/cli-types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAgLpE,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAEhC,MAAM;IACN,QAAQ;IAFnB,YACW,MAAyB,EACzB,QAAgB;QAEzB,KAAK,CAAC,oCAAoC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;sBAHrF,MAAM;wBACN,QAAQ;QAGjB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACpB,QAAQ;IAA7B,YAAqB,QAAgB;QACnC,KAAK,CAAC,QAAQ,CAAC,CAAC;wBADG,QAAQ;QAE3B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,kBAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACvC,CAAC;CACF","sourcesContent":["import type { CheckpointStore } from \"../node/checkpoint.js\";\nimport type { PipelineContext, PipelineLogger } from \"../core/pipeline.js\";\nimport { brandTubelessError } from \"../utilities/tubeless-error.js\";\n\n/**\n * Typed command-line entry points for scripts, mirroring how `definePipeline` turns a\n * declarative step list into a runnable pipeline: declare a flag schema once and get a\n * fully-typed, validated `values` object handed to `run`, instead of each script hand-\n * rolling its own `process.argv` scanning and `as` casts.\n */\n\nexport type CliParamType = \"string\" | \"number\" | \"boolean\" | \"path\";\n\ninterface CliParamBase {\n  /** Shown next to the flag in generated `--help` output. */\n  description?: string;\n  /** UI adapters place execution controls in one section. Built-ins set this. */\n  group?: \"execution\";\n  /** UI adapters treat exclusive repeatable parameters as mutually exclusive. Built-ins set this on step and target selection. */\n  exclusive?: true;\n  /** Overrides the derived `--flag-name`; defaults to the kebab-case of the schema key. */\n  flag?: string;\n  /** Optional one-letter alias, for example `short: \"v\"` enables `-v`. */\n  short?: string;\n  /**\n   * Optional environment-variable fallback. Explicit argv values always win;\n   * the environment value is validated like argv but never echoed in errors.\n   */\n  env?: string;\n}\n\nexport interface CliStringParam extends CliParamBase {\n  type: \"string\";\n  choices?: readonly string[];\n  default?: string;\n  optional?: boolean;\n  /** Repeatable: `--flag a --flag b` accumulates into `readonly string[]`, `[]` when absent. Cannot combine with `default`. */\n  multiple?: boolean;\n}\n\nexport interface CliNumberParam extends CliParamBase {\n  type: \"number\";\n  default?: number;\n  optional?: boolean;\n  integer?: boolean;\n  min?: number;\n  max?: number;\n  /** Repeatable: `--flag 1 --flag 2` accumulates into `readonly number[]`, `[]` when absent. Cannot combine with `default`. */\n  multiple?: boolean;\n}\n\nexport interface CliBooleanParam extends CliParamBase {\n  type: \"boolean\";\n  /** Defaults to `false`. A bare `--flag` sets `true`; `--no-flag` sets `false`. */\n  default?: boolean;\n}\n\nexport interface CliPathParam extends CliParamBase {\n  type: \"path\";\n  /** Relative defaults and values are resolved against `context.cwd`. */\n  default?: string;\n  optional?: boolean;\n  /** Validates the resolved path exists before `run` is called. */\n  mustExist?: boolean;\n  /** Only checked when `mustExist` is true; asserts the resolved path's kind. */\n  kind?: \"file\" | \"directory\";\n}\n\nexport type CliParam = CliStringParam | CliNumberParam | CliBooleanParam | CliPathParam;\n\nexport type CliParamsSchema = Record<string, CliParam>;\n\n/** JSON-safe description of one validated command parameter for non-terminal clients. */\nexport interface CliParameterDescriptor {\n  readonly choices?: readonly string[];\n  readonly default?: string | number | boolean;\n  readonly description?: string;\n  readonly environment?: string;\n  readonly exclusive?: true;\n  readonly flag: string;\n  readonly group?: \"execution\";\n  readonly integer?: boolean;\n  readonly key: string;\n  readonly max?: number;\n  readonly min?: number;\n  readonly multiple: boolean;\n  readonly mustExist?: boolean;\n  readonly pathKind?: \"directory\" | \"file\";\n  readonly positional: boolean;\n  readonly required: boolean;\n  readonly short?: string;\n  readonly type: CliParamType;\n}\n\n/** Immutable, presentation-neutral command contract shared by CLI and UI adapters. */\nexport interface CliCommandDescriptor {\n  readonly description?: string;\n  readonly name: string;\n  readonly parameters: readonly CliParameterDescriptor[];\n}\n\ntype CliScalarStringValue<P extends CliParam> = P extends {\n  choices: readonly (infer TChoice extends string)[];\n}\n  ? TChoice\n  : string;\n\ntype CliParamValue<P extends CliParam> = P extends { type: \"string\" }\n  ? P extends { multiple: true }\n    ? readonly CliScalarStringValue<P>[]\n    : CliScalarStringValue<P>\n  : P extends { type: \"number\" }\n    ? P extends { multiple: true }\n      ? readonly number[]\n      : number\n    : P extends { type: \"boolean\" }\n      ? boolean\n      : P extends { type: \"path\" }\n        ? string\n        : never;\n\n/**\n * A field is optional in the parsed output only when it's explicitly marked `optional:\n * true` (booleans never are — an absent boolean flag just means `false`). A field with a\n * `default` is also always present at runtime, but that's already covered: schemas\n * shouldn't combine `default` with `optional: true`, and if one does, the parsed type is\n * merely wider than necessary (`T | undefined` instead of `T`), never wrong.\n */\ntype CliParamIsOptional<P extends CliParam> = P extends { type: \"boolean\" }\n  ? false\n  : P extends { multiple: true }\n    ? false\n    : P extends { optional: true }\n      ? true\n      : false;\n\ntype RequiredCliParams<TSchema extends CliParamsSchema> = {\n  [K in keyof TSchema as CliParamIsOptional<TSchema[K]> extends true ? never : K]: CliParamValue<\n    TSchema[K]\n  >;\n};\n\ntype OptionalCliParams<TSchema extends CliParamsSchema> = {\n  [K in keyof TSchema as CliParamIsOptional<TSchema[K]> extends true ? K : never]?: CliParamValue<\n    TSchema[K]\n  >;\n};\n\n/**\n * Every command's parsed values include `dryRun` and `resume`, whether or not `TSchema`\n * declares them. `resume` is `false` unless `--resume` is passed or `checkpoint.defaultResume`\n * is `true`; it's meaningful even without `checkpoint` configured — a command can implement\n * its own \"is this done\" check and just read `values.resume` directly.\n */\nexport type CliParams<TSchema extends CliParamsSchema> = {\n  dryRun: boolean;\n  resume: boolean;\n} & RequiredCliParams<TSchema> &\n  OptionalCliParams<TSchema>;\n\nexport interface CliContext {\n  cwd: string;\n  /** Environment used for `param.env` fallbacks. Defaults to `process.env`. */\n  env?: Record<string, string | undefined>;\n  log: PipelineLogger;\n  /** Optional executor-only context used when this command runs a pipeline. */\n  pipelineContext?: Omit<PipelineContext, \"cwd\" | \"log\" | \"signal\">;\n  /** Optional caller-owned cancellation signal forwarded to command work. */\n  signal?: AbortSignal;\n  /** Present whenever the command's `checkpoint` config is set; see `CliCheckpointConfig`. */\n  checkpoint?: CheckpointStore;\n}\n\nexport type CliParseResult<TSchema extends CliParamsSchema> =\n  | { kind: \"values\"; values: CliParams<TSchema> }\n  | { kind: \"help\"; helpText: string }\n  | { kind: \"error\"; errors: readonly string[]; helpText: string };\n\nexport class CliValidationError extends Error {\n  constructor(\n    readonly errors: readonly string[],\n    readonly helpText: string\n  ) {\n    super(`Invalid command-line arguments:\\n${errors.map((error) => `  - ${error}`).join(\"\\n\")}`);\n    this.name = \"CliValidationError\";\n    brandTubelessError(this, \"cli-validation\");\n  }\n}\n\nexport class CliHelpRequested extends Error {\n  constructor(readonly helpText: string) {\n    super(helpText);\n    this.name = \"CliHelpRequested\";\n    brandTubelessError(this, \"cli-help\");\n  }\n}\n\nexport interface CliCheckpointConfig {\n  /** Relative paths resolve against `context.cwd`, like `CliPathParam`. */\n  path: string;\n  /**\n   * Defaults to `true`: a fully successful, non-dry-run `run` clears the checkpoint —\n   * the one-shot resumable-job pattern (start fresh next time). Set `false` for an\n   * incrementally-growing \"done\" set (e.g. entity enrichment) that must never auto-clear,\n   * since clearing it would cause already-processed items to be reprocessed.\n   */\n  clearOnSuccess?: boolean;\n  /**\n   * Defaults to `false`: start fresh unless `--resume` is passed. Set `true` to always\n   * resume by default (skip already-recorded items every run); `--no-resume` is the free\n   * opt-out, since boolean flags already support `--no-<flag>` negation.\n   */\n  defaultResume?: boolean;\n}\n\nexport interface CliCommandConfig<TSchema extends CliParamsSchema, TResult> {\n  /** Shown in generated usage text; defaults to the running script's file name. */\n  name?: string;\n  description?: string;\n  /** `dryRun`/`--dry-run` and `-h`/`--help` are provided automatically; don't redeclare them. */\n  params: TSchema;\n  /**\n   * Schema keys accepted in positional order. Flags for an earlier positional\n   * let the next positional fill the next unset field; a repeatable positional\n   * must be last.\n   */\n  positionals?: readonly (keyof TSchema & string)[];\n  /**\n   * Opts into a managed checkpoint file. Adds a reserved `--resume`/`--no-resume` flag\n   * (also don't redeclare a `resume` param) and populates `context.checkpoint` before\n   * `run` is called: resolved fresh (existing file cleared) unless resuming, and cleared\n   * again after a successful non-dry-run unless `clearOnSuccess` is `false`.\n   */\n  checkpoint?: CliCheckpointConfig;\n  /** Runs after every field passes its own validation; return error messages to reject. */\n  validate?(values: CliParams<TSchema>, context: CliContext): string[] | void;\n  run(values: CliParams<TSchema>, context: CliContext): TResult | Promise<TResult>;\n}\n\nexport interface CliCommand<TSchema extends CliParamsSchema, TResult> {\n  /** Structured schema metadata for adapters that should not parse generated help text. */\n  readonly descriptor: CliCommandDescriptor;\n  /** Pure: parses and validates without calling `run` or touching the process. */\n  parse(argv?: readonly string[], context?: Partial<CliContext>): CliParseResult<TSchema>;\n  /** Validates structured parameter values without tokenizing command-line arguments. */\n  parseValues(\n    values: Record<string, unknown>,\n    context?: Partial<CliContext>\n  ): CliParseResult<TSchema>;\n  /** Calls `run` from already validated parameter values. */\n  execute(values: CliParams<TSchema>, context?: Partial<CliContext>): Promise<TResult>;\n  /** Parses and calls `run`; throws `CliValidationError`/`CliHelpRequested` instead of running it. */\n  run(argv?: readonly string[], context?: Partial<CliContext>): Promise<TResult>;\n  /**\n   * Entry point for `if (import.meta.main) void command.main();`. Prints help/errors and\n   * sets `process.exitCode` — never calls `process.exit`, so buffered output still flushes\n   * — instead of throwing.\n   */\n  main(argv?: readonly string[], context?: Partial<CliContext>): Promise<void>;\n}\n"]}

package/dist/cli/cli.d.ts

@@ -1,5 +1,5 @@
 export { CliHelpRequested, CliValidationError, type CliBooleanParam, type CliCheckpointConfig, type CliCommand, type CliCommandConfig, type CliCommandDescriptor, type CliContext, type CliNumberParam, type CliParam, type CliParameterDescriptor, type CliParams, type CliParamsSchema, type CliParamType, type CliParseResult, type CliPathParam, type CliStringParam, } from "./cli-types.js";
 export { defineCommand } from "./cli-command.js";
-export { definePipelineCommand, type DefinePipelineCommandConfig, type PipelineCliBuiltins, type PipelineCliParseResult, type PipelineCliValues, type PipelineCommand, type PipelineCommandHookConfig, type PipelineCommandHookContext, type PipelineCommandHookSets, } from "./cli-pipeline-command.js";
-export { normalizeMultiSelectChoices, parseMultiSelectInput, promptMultiSelect, type MultiSelectChoice, type MultiSelectResult, type ParseMultiSelectInputOptions, type PromptMultiSelectOptions, } from "../reporter/prompt-select.js";
-export { TUBELESS_WORKBENCH_EXIT_CODE } from "./cli-exit.js";
+export { definePipelineCommand, type DefinePipelineCommandConfig, type PipelineCliParseResult, type PipelineCliValues, type PipelineCommand, type PipelineCommandHookConfig, type PipelineCommandHookContext, type PipelineCommandHookSets, } from "./cli-pipeline-command.js";
+export type { PipelineReporterConfig, PipelineReporterMode, ReporterOutput, } from "../reporter/interactive-reporter.js";
+export type { ReporterColorMode, ReporterSymbolMode, ReporterTerminalCapabilities, RunReporterConfig, } from "../reporter/reporter.js";

package/dist/cli/cli.js

@@ -1,6 +1,4 @@
 export { CliHelpRequested, CliValidationError, } from "./cli-types.js";
 export { defineCommand } from "./cli-command.js";
 export { definePipelineCommand, } from "./cli-pipeline-command.js";
-export { normalizeMultiSelectChoices, parseMultiSelectInput, promptMultiSelect, } from "../reporter/prompt-select.js";
-export { TUBELESS_WORKBENCH_EXIT_CODE } from "./cli-exit.js";
 //# sourceMappingURL=cli.js.map

package/dist/cli/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,GAgBnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACL,qBAAqB,GAStB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,iBAAiB,GAKlB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC","sourcesContent":["export {\n  CliHelpRequested,\n  CliValidationError,\n  type CliBooleanParam,\n  type CliCheckpointConfig,\n  type CliCommand,\n  type CliCommandConfig,\n  type CliCommandDescriptor,\n  type CliContext,\n  type CliNumberParam,\n  type CliParam,\n  type CliParameterDescriptor,\n  type CliParams,\n  type CliParamsSchema,\n  type CliParamType,\n  type CliParseResult,\n  type CliPathParam,\n  type CliStringParam,\n} from \"./cli-types.js\";\nexport { defineCommand } from \"./cli-command.js\";\nexport {\n  definePipelineCommand,\n  type DefinePipelineCommandConfig,\n  type PipelineCliBuiltins,\n  type PipelineCliParseResult,\n  type PipelineCliValues,\n  type PipelineCommand,\n  type PipelineCommandHookConfig,\n  type PipelineCommandHookContext,\n  type PipelineCommandHookSets,\n} from \"./cli-pipeline-command.js\";\nexport {\n  normalizeMultiSelectChoices,\n  parseMultiSelectInput,\n  promptMultiSelect,\n  type MultiSelectChoice,\n  type MultiSelectResult,\n  type ParseMultiSelectInputOptions,\n  type PromptMultiSelectOptions,\n} from \"../reporter/prompt-select.js\";\nexport { TUBELESS_WORKBENCH_EXIT_CODE } from \"./cli-exit.js\";\n"]}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,GAgBnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACL,qBAAqB,GAQtB,MAAM,2BAA2B,CAAC","sourcesContent":["export {\n  CliHelpRequested,\n  CliValidationError,\n  type CliBooleanParam,\n  type CliCheckpointConfig,\n  type CliCommand,\n  type CliCommandConfig,\n  type CliCommandDescriptor,\n  type CliContext,\n  type CliNumberParam,\n  type CliParam,\n  type CliParameterDescriptor,\n  type CliParams,\n  type CliParamsSchema,\n  type CliParamType,\n  type CliParseResult,\n  type CliPathParam,\n  type CliStringParam,\n} from \"./cli-types.js\";\nexport { defineCommand } from \"./cli-command.js\";\nexport {\n  definePipelineCommand,\n  type DefinePipelineCommandConfig,\n  type PipelineCliParseResult,\n  type PipelineCliValues,\n  type PipelineCommand,\n  type PipelineCommandHookConfig,\n  type PipelineCommandHookContext,\n  type PipelineCommandHookSets,\n} from \"./cli-pipeline-command.js\";\nexport type {\n  PipelineReporterConfig,\n  PipelineReporterMode,\n  ReporterOutput,\n} from \"../reporter/interactive-reporter.js\";\nexport type {\n  ReporterColorMode,\n  ReporterSymbolMode,\n  ReporterTerminalCapabilities,\n  RunReporterConfig,\n} from \"../reporter/reporter.js\";\n"]}

package/dist/core/child-execution.js

@@ -4,7 +4,7 @@ import { runConcurrentSettled } from "../utilities/batch.js";
 import { toMappedChildStepProgress, } from "./mapped-child-progress.js";
 import { createRunId, RUN_MODEL_VERSION } from "./pipeline-ids.js";
 import { duplicateValues } from "../utilities/collections.js";
-import { EXECUTE_COMPILED_RUN, isCompiledPipeline } from "./pipeline-plan.js";
+import { EXECUTE_COMPILED_RUN, isCompiledPipeline } from "./pipeline-identity.js";
 import { createChildProgress } from "./child-progress.js";
 import { hasVisibleStepProgress } from "./progress.js";
 export class PipelineChildError extends Error {
@@ -46,8 +46,6 @@ function publicChildRuntime(context) {
         runtime.hooks = context.hooks;
     if (context.parentRunId)
         runtime.parentRunId = context.parentRunId;
-    if (context.runId)
-        runtime.runId = context.runId;
     if (context.signal)
         runtime.signal = context.signal;
     if (context.tracing)
@@ -69,7 +67,7 @@ async function failedPublicChildPlanRun(pipeline, plan, controls, context) {
         steps: [],
         version: RUN_MODEL_VERSION,
     };
-    const correlationId = context.correlationId ?? context.runId;
+    const correlationId = context.correlationId;
     if (correlationId !== undefined)
         result.correlationId = correlationId;
     if (context.parentRunId)

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 { runConcurrentSettled } from \"../utilities/batch.js\";\nimport {\n  toMappedChildStepProgress,\n  type MappedChildProgressSnapshot,\n  type ToMappedChildStepProgressOptions,\n} 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-plan.js\";\nimport { createChildProgress } from \"./child-progress.js\";\nimport { hasVisibleStepProgress } from \"./progress.js\";\nimport type {\n  Pipeline,\n  PipelineContext,\n  PipelineExecutionContext,\n  PipelineHooks,\n  PipelinePlan,\n  PipelinePlanStep,\n  PipelineRun,\n  PipelineRunControls,\n  PipelineRunOptions,\n  PipelineRuntime,\n  PipelineStepContext,\n  PipelineStepProgressDetail,\n} from \"./pipeline-types.js\";\nimport type { PipelineTracingOptions } from \"../tracing/tracing.js\";\n\nexport class PipelineChildError extends Error {\n  constructor(\n    message: string,\n    readonly cancelled = false,\n    cause?: unknown,\n    readonly fanOut?: {\n      failures: readonly { error: Error; key: string; index: number; cancelled: boolean }[];\n      failureCount: number;\n      schedulerError?: Error;\n    }\n  ) {\n    super(message, cause === undefined ? undefined : { cause });\n    this.name = \"PipelineChildError\";\n  }\n}\n\nconst LIVE_FAN_OUT_GROUP_LIMIT = 32;\n\ntype ChildPipeline = Pipeline<object, unknown, string, string>;\n\ntype CompiledChildExecute = (\n  plan: PipelinePlan,\n  options: PipelineRunOptions,\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: PipelineRunOptions,\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.runId) runtime.runId = context.runId;\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 ?? context.runId;\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: PipelineRunOptions,\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\ninterface ChildExecutionDependencies<TParentOptions extends object> {\n  createExecutionError(result: PipelineRun<unknown>, message: string): Error;\n  isCancellation(cause: unknown, context: PipelineExecutionContext<TParentOptions>): boolean;\n}\n\nexport interface SingleChildExecutionConfig<TParentOptions extends object> {\n  pipeline: ChildPipeline;\n  mapOptions(\n    inputs: ChildInputs,\n    context: PipelineExecutionContext<TParentOptions>\n  ): PipelineRunOptions;\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  mapOptions(\n    item: unknown,\n    index: number,\n    inputs: ChildInputs,\n    context: PipelineExecutionContext<TParentOptions>\n  ): PipelineRunOptions;\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  return context.tracing ? { ...context.tracing, itemKey } : undefined;\n}\n\nconst CHILD_RUN_CONTROL_KEYS = [\"continueOnError\", \"dryRun\", \"stepIds\", \"targets\"] as const;\n\nfunction isChildRunControlKey(\n  property: PropertyKey\n): property is (typeof CHILD_RUN_CONTROL_KEYS)[number] {\n  return (\n    typeof property === \"string\" &&\n    // SAFETY: `includes` membership over the literal tuple guarantees the cast\n    // target is exactly one of the declared run-control keys.\n    CHILD_RUN_CONTROL_KEYS.includes(property as (typeof CHILD_RUN_CONTROL_KEYS)[number])\n  );\n}\n\ninterface ChildRunBags {\n  controls: PipelineRunControls;\n  domainOptions: PipelineRunOptions;\n}\n\nfunction splitChildRunOptions(options: PipelineRunOptions): ChildRunBags {\n  const controls: PipelineRunControls = {};\n  let hasControls = false;\n  for (const key of CHILD_RUN_CONTROL_KEYS) {\n    if (!Object.prototype.hasOwnProperty.call(options, key)) continue;\n    hasControls = true;\n    Object.assign(controls, { [key]: options[key] });\n  }\n  if (!hasControls) {\n    return { controls, domainOptions: options };\n  }\n  return { controls, domainOptions: createChildDomainOptionsView(options) };\n}\n\nfunction createChildDomainOptionsView(options: PipelineRunOptions): PipelineRunOptions {\n  // SAFETY: proxy an empty facade so hiding non-configurable control keys on a\n  // frozen mapOptions bag does not violate proxy invariants. Reads still use\n  // `options` as the receiver so accessors and methods keep their original `this`.\n  return new Proxy({} as PipelineRunOptions, {\n    get(_target, property) {\n      if (isChildRunControlKey(property)) return undefined;\n      const value = readChildOptionProperty(options, property);\n      return value instanceof Function ? value.bind(options) : value;\n    },\n    has(_target, property) {\n      return !isChildRunControlKey(property) && property in options;\n    },\n    ownKeys() {\n      return Reflect.ownKeys(options).filter((property) => !isChildRunControlKey(property));\n    },\n    getOwnPropertyDescriptor(_target, property) {\n      if (isChildRunControlKey(property)) return undefined;\n      const descriptor = Reflect.getOwnPropertyDescriptor(options, property);\n      if (descriptor === undefined) return undefined;\n      return { ...descriptor, configurable: true };\n    },\n    getPrototypeOf() {\n      return Object.getPrototypeOf(options);\n    },\n    set(_target, property, value) {\n      if (isChildRunControlKey(property)) return true;\n      return Reflect.set(options, property, value, options);\n    },\n  });\n}\n\nfunction readChildOptionProperty(options: PipelineRunOptions, property: PropertyKey): unknown {\n  // SAFETY: child mapOptions is an untyped bag; this index reads the requested\n  // key on that original object so accessors keep it as `this`.\n  return options[property as keyof PipelineRunOptions];\n}\n\nfunction childRunBags(options: PipelineRunOptions, dryRun: boolean): ChildRunBags {\n  const { controls, domainOptions } = splitChildRunOptions(options);\n  return { controls: { ...controls, dryRun }, domainOptions };\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: PipelineRunOptions,\n  controls: PipelineRunControls,\n  context: PipelineContext,\n  hooks: PipelineHooks,\n  dependencies: ChildExecutionDependencies<object>,\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 dependencies.createExecutionError(\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 dependencies.createExecutionError(\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  dependencies: ChildExecutionDependencies<TParentOptions>\n): (inputs: ChildInputs, context: PipelineStepContext<TParentOptions>) => Promise<unknown> {\n  return async (inputs, context) => {\n    const { controls, domainOptions } = childRunBags(\n      config.mapOptions(inputs, context),\n      context.dryRun\n    );\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 selectedStepCount = childPlan.ok\n      ? childPlan.steps.filter((step) => step.selected).length\n      : 0;\n    const childProgress = hasProgressObserver(context) ? createChildProgress(childPlan) : undefined;\n    const terminalSteps = new Set<string>();\n    const report = (step: PipelinePlanStep, message: string, terminal = false): void => {\n      if (!childProgress) return;\n      if (terminal) terminalSteps.add(step.id);\n      context.reportProgress({\n        details: childProgress.details(),\n        completed: terminalSteps.size,\n        total: Math.max(1, selectedStepCount),\n        message: `${config.pipeline.id}/${step.name ?? step.id}: ${message}`,\n      });\n    };\n    const childHooks: PipelineHooks = {\n      onStepStatus: childProgress?.update,\n      onStepStart: ({ step }) => report(step, \"started\"),\n      onStepProgress: ({ progress, step }) => {\n        if (!hasVisibleStepProgress(progress)) return;\n        report(step, progress.message ?? `${progress.completed} completed`);\n      },\n      onStepComplete: ({ step }) => report(step, \"complete\", true),\n      onStepSkip: ({ reason, step }) => report(step, `skipped: ${reason}`, reason !== \"filtered\"),\n      onStepCancel: ({ error, step }) => report(step, `cancelled: ${error.message}`, true),\n      onStepFail: ({ error, step }) => report(step, `failed: ${error.message}`, true),\n    };\n    const childResult = await runChildPipeline(\n      config.pipeline,\n      domainOptions,\n      controls,\n      baseChildContext,\n      childProgress ? childHooks : {},\n      dependencies,\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  dependencies: ChildExecutionDependencies<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 active = new Map<string, string>();\n    const failedKeys = new Set<string>();\n    const itemIndexes = new Map(keys.map((key, index) => [key, index]));\n    const observesProgress = hasProgressObserver(context);\n    const itemRows = new Map<string, PipelineStepProgressDetail>(\n      keys.map((id) => [id, { id, status: \"pending\" }])\n    );\n    const itemProgress = new Map<string, ReturnType<typeof createChildProgress>>();\n    const childTerminalSteps = new Map<string, Set<string>>();\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 publishProgress = (spotlight?: string, final = false): void => {\n      if (!observesProgress) return;\n      const snapshot: MappedChildProgressSnapshot = {\n        active,\n        concurrency,\n        failedItems,\n        finishedItems,\n        itemCount: items.length,\n        plannedChildSteps,\n        plannedItems,\n        stepsPerItem,\n        terminalChildSteps,\n        spotlight,\n      };\n      // Materialize a bounded live window; expand the default final snapshot once.\n      // Active and failed sets avoid scanning or sorting the full fan-out per event.\n      const limit =\n        Math.max(0, Math.floor(config.progress?.detailLimit ?? LIVE_FAN_OUT_GROUP_LIMIT)) || 0;\n      let visibleKeys: readonly string[];\n      if (final && config.progress?.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        ...(itemProgress.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      context.reportProgress({ ...toMappedChildStepProgress(snapshot, config.progress), details });\n    };\n    const markChildTerminal = (itemKey: string, stepId: string, label: string): void => {\n      let seen = childTerminalSteps.get(itemKey);\n      if (!seen) {\n        seen = new Set();\n        childTerminalSteps.set(itemKey, seen);\n      }\n      if (!seen.has(stepId)) {\n        seen.add(stepId);\n        terminalChildSteps += 1;\n      }\n      active.set(itemKey, label);\n      publishProgress();\n    };\n\n    if (items.length === 0) {\n      publishProgress();\n      return [];\n    }\n    publishProgress();\n\n    const settled = await runConcurrentSettled(\n      items,\n      { concurrency, signal: context.signal },\n      async (item, itemIndex): Promise<Outcome> => {\n        const key = keys[itemIndex]!;\n        active.set(key, \"starting\");\n        itemRows.set(key, { id: key, status: \"running\" });\n        publishProgress();\n        try {\n          throwIfAborted(context.signal, `Mapped child pipeline ${config.pipeline.id}`);\n          const { controls, domainOptions } = childRunBags(\n            config.mapOptions(item, itemIndex, inputs, context),\n            context.dryRun\n          );\n          // Plan once per mapped-options bag for progress and execution.\n          const childPlan = config.pipeline.plan(controls);\n          if (childPlan.ok) {\n            const plannedSteps = childPlan.steps.filter((step) => step.selected).length;\n            plannedChildSteps += plannedSteps;\n            plannedItems += 1;\n            if (plannedSteps > stepsPerItem) stepsPerItem = plannedSteps;\n          }\n\n          const childProgress = observesProgress ? createChildProgress(childPlan) : undefined;\n          if (childProgress) itemProgress.set(key, childProgress);\n          const childHooks: PipelineHooks = {\n            onStepStatus: childProgress?.update,\n            onStepStart: ({ step }) => {\n              active.set(key, step.name ?? step.id);\n              publishProgress();\n            },\n            onStepProgress: ({ progress, step }) => {\n              if (!hasVisibleStepProgress(progress)) return;\n              const detail =\n                progress.message ??\n                (progress.total !== undefined\n                  ? `${progress.completed}/${progress.total}`\n                  : `${progress.completed}`);\n              active.set(key, `${step.name ?? step.id}:${detail}`);\n              publishProgress();\n            },\n            onStepComplete: ({ step }) =>\n              markChildTerminal(key, step.id, `${step.name ?? step.id}:complete`),\n            onStepSkip: ({ reason, step }) => {\n              if (reason === \"filtered\") return;\n              markChildTerminal(key, step.id, `${step.name ?? step.id}:skipped:${reason}`);\n            },\n            onStepCancel: ({ step }) =>\n              markChildTerminal(key, step.id, `${step.name ?? step.id}:cancelled`),\n            onStepFail: ({ step }) =>\n              markChildTerminal(key, step.id, `${step.name ?? step.id}:failed`),\n          };\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            observesProgress ? childHooks : {},\n            dependencies,\n            \"\",\n            childPlan\n          );\n\n          const seen = childTerminalSteps.get(key) ?? new Set<string>();\n          if (childPlan.ok) {\n            for (const planStep of childPlan.steps) {\n              if (!planStep.selected || seen.has(planStep.id)) continue;\n              seen.add(planStep.id);\n              terminalChildSteps += 1;\n            }\n          }\n          childTerminalSteps.set(key, seen);\n\n          const value = config.mapResult\n            ? config.mapResult(childResult.value, childResult, item, itemIndex, context)\n            : childResult.value;\n          active.delete(key);\n          itemRows.set(key, { id: key, status: \"completed\" });\n          finishedItems += 1;\n          publishProgress(`${key}: completed`);\n          return { key, ok: true, value };\n        } catch (error) {\n          const cause = error instanceof Error ? error : new Error(String(error));\n          active.delete(key);\n          itemRows.set(key, {\n            id: key,\n            status: dependencies.isCancellation(cause, context) ? \"cancelled\" : \"failed\",\n            label: cause.message,\n          });\n          failedKeys.add(key);\n          failedItems += 1;\n          publishProgress(`${key}: failed`);\n          return { error: cause, key, index: itemIndex, ok: false };\n        }\n      }\n    );\n\n    if (config.progress?.detailLimit === undefined && keys.length > LIVE_FAN_OUT_GROUP_LIMIT) {\n      publishProgress(undefined, true);\n    }\n    const outcomes = settled.results.filter((outcome): outcome is Outcome => outcome !== undefined);\n    const schedulerFailure =\n      settled.failure === undefined\n        ? undefined\n        : settled.failure instanceof Error\n          ? settled.failure\n          : new Error(String(settled.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 }) => dependencies.isCancellation(error, context)) &&\n        (schedulerFailure === undefined || dependencies.isCancellation(schedulerFailure, context));\n      const primaryError = cancelled\n        ? (failures[0]?.error ?? schedulerFailure)\n        : (failures.find(({ error }) => !dependencies.isCancellation(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: dependencies.isCancellation(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 { runConcurrentSettled } from \"../utilities/batch.js\";\nimport {\n  toMappedChildStepProgress,\n  type MappedChildProgressSnapshot,\n  type ToMappedChildStepProgressOptions,\n} 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 { createChildProgress } from \"./child-progress.js\";\nimport { hasVisibleStepProgress } from \"./progress.js\";\nimport type {\n  Pipeline,\n  PipelineContext,\n  PipelineExecutionContext,\n  PipelineHooks,\n  PipelinePlan,\n  PipelinePlanStep,\n  PipelineRun,\n  PipelineRunControls,\n  PipelineRunOptions,\n  PipelineRuntime,\n  PipelineStepContext,\n  PipelineStepProgressDetail,\n} from \"./pipeline-types.js\";\nimport type { PipelineTracingOptions } from \"../tracing/tracing-contracts.js\";\n\nexport class PipelineChildError extends Error {\n  constructor(\n    message: string,\n    readonly cancelled = false,\n    cause?: unknown,\n    readonly fanOut?: {\n      failures: readonly { error: Error; key: string; index: number; cancelled: boolean }[];\n      failureCount: number;\n      schedulerError?: Error;\n    }\n  ) {\n    super(message, cause === undefined ? undefined : { cause });\n    this.name = \"PipelineChildError\";\n  }\n}\n\nconst LIVE_FAN_OUT_GROUP_LIMIT = 32;\n\ntype ChildPipeline = Pipeline<object, unknown, string, string>;\n\ntype CompiledChildExecute = (\n  plan: PipelinePlan,\n  options: PipelineRunOptions,\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: PipelineRunOptions,\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: PipelineRunOptions,\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\ninterface ChildExecutionDependencies<TParentOptions extends object> {\n  createExecutionError(result: PipelineRun<unknown>, message: string): Error;\n  isCancellation(cause: unknown, context: PipelineExecutionContext<TParentOptions>): boolean;\n}\n\nexport interface SingleChildExecutionConfig<TParentOptions extends object> {\n  pipeline: ChildPipeline;\n  mapOptions(\n    inputs: ChildInputs,\n    context: PipelineExecutionContext<TParentOptions>\n  ): PipelineRunOptions;\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  mapOptions(\n    item: unknown,\n    index: number,\n    inputs: ChildInputs,\n    context: PipelineExecutionContext<TParentOptions>\n  ): PipelineRunOptions;\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  return context.tracing ? { ...context.tracing, itemKey } : undefined;\n}\n\nconst CHILD_RUN_CONTROL_KEYS = [\"continueOnError\", \"dryRun\", \"stepIds\", \"targets\"] as const;\n\nfunction isChildRunControlKey(\n  property: PropertyKey\n): property is (typeof CHILD_RUN_CONTROL_KEYS)[number] {\n  return (\n    typeof property === \"string\" &&\n    // SAFETY: `includes` membership over the literal tuple guarantees the cast\n    // target is exactly one of the declared run-control keys.\n    CHILD_RUN_CONTROL_KEYS.includes(property as (typeof CHILD_RUN_CONTROL_KEYS)[number])\n  );\n}\n\ninterface ChildRunBags {\n  controls: PipelineRunControls;\n  domainOptions: PipelineRunOptions;\n}\n\nfunction splitChildRunOptions(options: PipelineRunOptions): ChildRunBags {\n  const controls: PipelineRunControls = {};\n  let hasControls = false;\n  for (const key of CHILD_RUN_CONTROL_KEYS) {\n    if (!Object.prototype.hasOwnProperty.call(options, key)) continue;\n    hasControls = true;\n    Object.assign(controls, { [key]: options[key] });\n  }\n  if (!hasControls) {\n    return { controls, domainOptions: options };\n  }\n  return { controls, domainOptions: createChildDomainOptionsView(options) };\n}\n\nfunction createChildDomainOptionsView(options: PipelineRunOptions): PipelineRunOptions {\n  // SAFETY: proxy an empty facade so hiding non-configurable control keys on a\n  // frozen mapOptions bag does not violate proxy invariants. Reads still use\n  // `options` as the receiver so accessors and methods keep their original `this`.\n  return new Proxy({} as PipelineRunOptions, {\n    get(_target, property) {\n      if (isChildRunControlKey(property)) return undefined;\n      const value = readChildOptionProperty(options, property);\n      return value instanceof Function ? value.bind(options) : value;\n    },\n    has(_target, property) {\n      return !isChildRunControlKey(property) && property in options;\n    },\n    ownKeys() {\n      return Reflect.ownKeys(options).filter((property) => !isChildRunControlKey(property));\n    },\n    getOwnPropertyDescriptor(_target, property) {\n      if (isChildRunControlKey(property)) return undefined;\n      const descriptor = Reflect.getOwnPropertyDescriptor(options, property);\n      if (descriptor === undefined) return undefined;\n      return { ...descriptor, configurable: true };\n    },\n    getPrototypeOf() {\n      return Object.getPrototypeOf(options);\n    },\n    set(_target, property, value) {\n      if (isChildRunControlKey(property)) return true;\n      return Reflect.set(options, property, value, options);\n    },\n  });\n}\n\nfunction readChildOptionProperty(options: PipelineRunOptions, property: PropertyKey): unknown {\n  // SAFETY: child mapOptions is an untyped bag; this index reads the requested\n  // key on that original object so accessors keep it as `this`.\n  return options[property as keyof PipelineRunOptions];\n}\n\nfunction childRunBags(options: PipelineRunOptions, dryRun: boolean): ChildRunBags {\n  const { controls, domainOptions } = splitChildRunOptions(options);\n  return { controls: { ...controls, dryRun }, domainOptions };\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: PipelineRunOptions,\n  controls: PipelineRunControls,\n  context: PipelineContext,\n  hooks: PipelineHooks,\n  dependencies: ChildExecutionDependencies<object>,\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 dependencies.createExecutionError(\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 dependencies.createExecutionError(\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  dependencies: ChildExecutionDependencies<TParentOptions>\n): (inputs: ChildInputs, context: PipelineStepContext<TParentOptions>) => Promise<unknown> {\n  return async (inputs, context) => {\n    const { controls, domainOptions } = childRunBags(\n      config.mapOptions(inputs, context),\n      context.dryRun\n    );\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 selectedStepCount = childPlan.ok\n      ? childPlan.steps.filter((step) => step.selected).length\n      : 0;\n    const childProgress = hasProgressObserver(context) ? createChildProgress(childPlan) : undefined;\n    const terminalSteps = new Set<string>();\n    const report = (step: PipelinePlanStep, message: string, terminal = false): void => {\n      if (!childProgress) return;\n      if (terminal) terminalSteps.add(step.id);\n      context.reportProgress({\n        details: childProgress.details(),\n        completed: terminalSteps.size,\n        total: Math.max(1, selectedStepCount),\n        message: `${config.pipeline.id}/${step.name ?? step.id}: ${message}`,\n      });\n    };\n    const childHooks: PipelineHooks = {\n      onStepStatus: childProgress?.update,\n      onStepStart: ({ step }) => report(step, \"started\"),\n      onStepProgress: ({ progress, step }) => {\n        if (!hasVisibleStepProgress(progress)) return;\n        report(step, progress.message ?? `${progress.completed} completed`);\n      },\n      onStepComplete: ({ step }) => report(step, \"complete\", true),\n      onStepSkip: ({ reason, step }) => report(step, `skipped: ${reason}`, reason !== \"filtered\"),\n      onStepCancel: ({ error, step }) => report(step, `cancelled: ${error.message}`, true),\n      onStepFail: ({ error, step }) => report(step, `failed: ${error.message}`, true),\n    };\n    const childResult = await runChildPipeline(\n      config.pipeline,\n      domainOptions,\n      controls,\n      baseChildContext,\n      childProgress ? childHooks : {},\n      dependencies,\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  dependencies: ChildExecutionDependencies<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 active = new Map<string, string>();\n    const failedKeys = new Set<string>();\n    const itemIndexes = new Map(keys.map((key, index) => [key, index]));\n    const observesProgress = hasProgressObserver(context);\n    const itemRows = new Map<string, PipelineStepProgressDetail>(\n      keys.map((id) => [id, { id, status: \"pending\" }])\n    );\n    const itemProgress = new Map<string, ReturnType<typeof createChildProgress>>();\n    const childTerminalSteps = new Map<string, Set<string>>();\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 publishProgress = (spotlight?: string, final = false): void => {\n      if (!observesProgress) return;\n      const snapshot: MappedChildProgressSnapshot = {\n        active,\n        concurrency,\n        failedItems,\n        finishedItems,\n        itemCount: items.length,\n        plannedChildSteps,\n        plannedItems,\n        stepsPerItem,\n        terminalChildSteps,\n        spotlight,\n      };\n      // Materialize a bounded live window; expand the default final snapshot once.\n      // Active and failed sets avoid scanning or sorting the full fan-out per event.\n      const limit =\n        Math.max(0, Math.floor(config.progress?.detailLimit ?? LIVE_FAN_OUT_GROUP_LIMIT)) || 0;\n      let visibleKeys: readonly string[];\n      if (final && config.progress?.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        ...(itemProgress.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      context.reportProgress({ ...toMappedChildStepProgress(snapshot, config.progress), details });\n    };\n    const markChildTerminal = (itemKey: string, stepId: string, label: string): void => {\n      let seen = childTerminalSteps.get(itemKey);\n      if (!seen) {\n        seen = new Set();\n        childTerminalSteps.set(itemKey, seen);\n      }\n      if (!seen.has(stepId)) {\n        seen.add(stepId);\n        terminalChildSteps += 1;\n      }\n      active.set(itemKey, label);\n      publishProgress();\n    };\n\n    if (items.length === 0) {\n      publishProgress();\n      return [];\n    }\n    publishProgress();\n\n    const settled = await runConcurrentSettled(\n      items,\n      { concurrency, signal: context.signal },\n      async (item, itemIndex): Promise<Outcome> => {\n        const key = keys[itemIndex]!;\n        active.set(key, \"starting\");\n        itemRows.set(key, { id: key, status: \"running\" });\n        publishProgress();\n        try {\n          throwIfAborted(context.signal, `Mapped child pipeline ${config.pipeline.id}`);\n          const { controls, domainOptions } = childRunBags(\n            config.mapOptions(item, itemIndex, inputs, context),\n            context.dryRun\n          );\n          // Plan once per mapped-options bag for progress and execution.\n          const childPlan = config.pipeline.plan(controls);\n          if (childPlan.ok) {\n            const plannedSteps = childPlan.steps.filter((step) => step.selected).length;\n            plannedChildSteps += plannedSteps;\n            plannedItems += 1;\n            if (plannedSteps > stepsPerItem) stepsPerItem = plannedSteps;\n          }\n\n          const childProgress = observesProgress ? createChildProgress(childPlan) : undefined;\n          if (childProgress) itemProgress.set(key, childProgress);\n          const childHooks: PipelineHooks = {\n            onStepStatus: childProgress?.update,\n            onStepStart: ({ step }) => {\n              active.set(key, step.name ?? step.id);\n              publishProgress();\n            },\n            onStepProgress: ({ progress, step }) => {\n              if (!hasVisibleStepProgress(progress)) return;\n              const detail =\n                progress.message ??\n                (progress.total !== undefined\n                  ? `${progress.completed}/${progress.total}`\n                  : `${progress.completed}`);\n              active.set(key, `${step.name ?? step.id}:${detail}`);\n              publishProgress();\n            },\n            onStepComplete: ({ step }) =>\n              markChildTerminal(key, step.id, `${step.name ?? step.id}:complete`),\n            onStepSkip: ({ reason, step }) => {\n              if (reason === \"filtered\") return;\n              markChildTerminal(key, step.id, `${step.name ?? step.id}:skipped:${reason}`);\n            },\n            onStepCancel: ({ step }) =>\n              markChildTerminal(key, step.id, `${step.name ?? step.id}:cancelled`),\n            onStepFail: ({ step }) =>\n              markChildTerminal(key, step.id, `${step.name ?? step.id}:failed`),\n          };\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            observesProgress ? childHooks : {},\n            dependencies,\n            \"\",\n            childPlan\n          );\n\n          const seen = childTerminalSteps.get(key) ?? new Set<string>();\n          if (childPlan.ok) {\n            for (const planStep of childPlan.steps) {\n              if (!planStep.selected || seen.has(planStep.id)) continue;\n              seen.add(planStep.id);\n              terminalChildSteps += 1;\n            }\n          }\n          childTerminalSteps.set(key, seen);\n\n          const value = config.mapResult\n            ? config.mapResult(childResult.value, childResult, item, itemIndex, context)\n            : childResult.value;\n          active.delete(key);\n          itemRows.set(key, { id: key, status: \"completed\" });\n          finishedItems += 1;\n          publishProgress(`${key}: completed`);\n          return { key, ok: true, value };\n        } catch (error) {\n          const cause = error instanceof Error ? error : new Error(String(error));\n          active.delete(key);\n          itemRows.set(key, {\n            id: key,\n            status: dependencies.isCancellation(cause, context) ? \"cancelled\" : \"failed\",\n            label: cause.message,\n          });\n          failedKeys.add(key);\n          failedItems += 1;\n          publishProgress(`${key}: failed`);\n          return { error: cause, key, index: itemIndex, ok: false };\n        }\n      }\n    );\n\n    if (config.progress?.detailLimit === undefined && keys.length > LIVE_FAN_OUT_GROUP_LIMIT) {\n      publishProgress(undefined, true);\n    }\n    const outcomes = settled.results.filter((outcome): outcome is Outcome => outcome !== undefined);\n    const schedulerFailure =\n      settled.failure === undefined\n        ? undefined\n        : settled.failure instanceof Error\n          ? settled.failure\n          : new Error(String(settled.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 }) => dependencies.isCancellation(error, context)) &&\n        (schedulerFailure === undefined || dependencies.isCancellation(schedulerFailure, context));\n      const primaryError = cancelled\n        ? (failures[0]?.error ?? schedulerFailure)\n        : (failures.find(({ error }) => !dependencies.isCancellation(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: dependencies.isCancellation(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/lifecycle.d.ts

@@ -1,6 +1,6 @@
 import type { PipelineError, PipelinePlan, PipelineRun, PipelineRuntime, PipelineStepStatus } from "./pipeline-types.js";
 import { type PipelineTraceEmitter } from "../tracing/tracing-internal.js";
-import type { PipelineTraceAttributes } from "../tracing/tracing.js";
+import type { PipelineTraceAttributes } from "../tracing/tracing-contracts.js";
 /** Internal canonical lifecycle stream. Hooks and tracing are projections of it. */
 export interface PipelineLifecycleObserver {
     finalizeComplete(durationMs: number, value: unknown): void;

package/dist/core/lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/core/lifecycle.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  PipelineError,\n  PipelineHooks,\n  PipelinePlan,\n  PipelineRun,\n  PipelineRuntime,\n  PipelineStepStatus,\n} from \"./pipeline-types.js\";\nimport {\n  createPipelineTraceEmitter,\n  type PipelineTraceEmitter,\n} from \"../tracing/tracing-internal.js\";\nimport type { PipelineTraceAttributes, PipelineTraceContext } from \"../tracing/tracing.js\";\n\n/** Internal canonical lifecycle stream. Hooks and tracing are projections of it. */\nexport interface PipelineLifecycleObserver {\n  finalizeComplete(durationMs: number, value: unknown): void;\n  finalizeError(error: PipelineError, durationMs: number): void;\n  finalizeStart(): void;\n  flush(): Promise<void>;\n  log(\n    level: \"error\" | \"log\" | \"warn\",\n    message: unknown,\n    params?: readonly unknown[],\n    stepId?: string,\n    attemptId?: string\n  ): void;\n  pipelineComplete(result: PipelineRun<unknown>): void;\n  pipelineStart(plan: PipelinePlan, targetIds: readonly string[]): void;\n  reportAttempt(\n    stepId: string,\n    attempt: number,\n    attributes?: PipelineTraceAttributes,\n    attemptId?: string\n  ): void;\n  stepStatus(event: PipelineStepStatus, trace?: boolean): void;\n}\n\nfunction emitHook(runtime: PipelineRuntime, emit: (hooks: PipelineHooks) => void): void {\n  if (!runtime.hooks) return;\n  const hookSets = Array.isArray(runtime.hooks) ? runtime.hooks : [runtime.hooks];\n  for (const hooks of hookSets) {\n    try {\n      emit(hooks);\n    } catch (error) {\n      runtime.log.warn(\n        `Pipeline hook failed: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n}\n\nexport function createPipelineLifecycleObserver(\n  pipelineId: string,\n  runtime: PipelineRuntime,\n  trace: PipelineTraceEmitter | undefined\n): PipelineLifecycleObserver {\n  return {\n    pipelineStart(plan, targetIds) {\n      emitHook(runtime, (hooks) => hooks.onPipelineStart?.(plan));\n      trace?.pipelineStart(plan, targetIds);\n    },\n    stepStatus(event, traceStatus = true) {\n      emitHook(runtime, (hooks) => hooks.onStepStatus?.(event));\n      switch (event.status) {\n        case \"planned\":\n          emitHook(runtime, (hooks) => hooks.onStepPlan?.(event));\n          break;\n        case \"running\":\n          if (event.progress) {\n            const progress = event.progress;\n            emitHook(runtime, (hooks) => hooks.onStepProgress?.({ ...event, progress }));\n          } else {\n            emitHook(runtime, (hooks) =>\n              hooks.onStepStart?.({\n                attemptId: event.attemptId,\n                pipelineId: event.pipelineId,\n                status: \"running\",\n                step: event.step,\n              })\n            );\n          }\n          break;\n        case \"cancelled\":\n          emitHook(runtime, (hooks) => hooks.onStepCancel?.(event));\n          break;\n        case \"failed\":\n          emitHook(runtime, (hooks) => hooks.onStepFail?.(event));\n          break;\n        case \"skipped\":\n          emitHook(runtime, (hooks) => hooks.onStepSkip?.(event));\n          break;\n        case \"completed\":\n          emitHook(runtime, (hooks) => hooks.onStepComplete?.(event));\n          break;\n      }\n      if (traceStatus) trace?.stepStatus(event);\n    },\n    reportAttempt: (stepId, attempt, attributes, attemptId) =>\n      trace?.reportAttempt(stepId, attempt, attributes, attemptId),\n    log: (level, message, params, stepId, attemptId) =>\n      trace?.log(level, message, params, stepId, attemptId),\n    finalizeStart() {\n      emitHook(runtime, (hooks) => hooks.onFinalizeStart?.({ pipelineId }));\n      trace?.finalizeStart();\n    },\n    finalizeComplete(durationMs, value) {\n      emitHook(runtime, (hooks) => hooks.onFinalizeComplete?.({ durationMs, pipelineId, value }));\n      trace?.finalizeComplete(durationMs);\n    },\n    finalizeError(error, durationMs) {\n      emitHook(runtime, (hooks) => hooks.onFinalizeError?.({ durationMs, error, pipelineId }));\n      trace?.finalizeError(error, durationMs);\n    },\n    pipelineComplete(result) {\n      emitHook(runtime, (hooks) => hooks.onPipelineComplete?.(result));\n      trace?.pipelineComplete(result);\n    },\n    flush: () => trace?.flush() ?? Promise.resolve(),\n  };\n}\n\n/** Same start/complete projection executePlannedRun uses for an invalid plan. */\nexport async function emitRejectedPlanLifecycle(\n  pipelineId: string,\n  targetIds: readonly string[],\n  plan: PipelinePlan,\n  runtime: PipelineRuntime,\n  result: PipelineRun<unknown>\n): Promise<void> {\n  const identity: PipelineTraceContext = { runId: result.runId };\n  if (result.correlationId !== undefined) identity.correlationId = result.correlationId;\n  if (result.parentRunId) identity.parentRunId = result.parentRunId;\n  if (runtime.tracing?.itemKey) identity.itemKey = runtime.tracing.itemKey;\n  const lifecycle = createPipelineLifecycleObserver(\n    pipelineId,\n    runtime,\n    createPipelineTraceEmitter(pipelineId, runtime.tracing, runtime.log, identity, runtime.now)\n  );\n  lifecycle.pipelineStart(plan, targetIds);\n  lifecycle.pipelineComplete(result);\n  await lifecycle.flush();\n}\n"]}
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/core/lifecycle.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  PipelineError,\n  PipelineHooks,\n  PipelinePlan,\n  PipelineRun,\n  PipelineRuntime,\n  PipelineStepStatus,\n} from \"./pipeline-types.js\";\nimport {\n  createPipelineTraceEmitter,\n  type PipelineTraceEmitter,\n} from \"../tracing/tracing-internal.js\";\nimport type {\n  PipelineTraceAttributes,\n  PipelineTraceContext,\n} from \"../tracing/tracing-contracts.js\";\n\n/** Internal canonical lifecycle stream. Hooks and tracing are projections of it. */\nexport interface PipelineLifecycleObserver {\n  finalizeComplete(durationMs: number, value: unknown): void;\n  finalizeError(error: PipelineError, durationMs: number): void;\n  finalizeStart(): void;\n  flush(): Promise<void>;\n  log(\n    level: \"error\" | \"log\" | \"warn\",\n    message: unknown,\n    params?: readonly unknown[],\n    stepId?: string,\n    attemptId?: string\n  ): void;\n  pipelineComplete(result: PipelineRun<unknown>): void;\n  pipelineStart(plan: PipelinePlan, targetIds: readonly string[]): void;\n  reportAttempt(\n    stepId: string,\n    attempt: number,\n    attributes?: PipelineTraceAttributes,\n    attemptId?: string\n  ): void;\n  stepStatus(event: PipelineStepStatus, trace?: boolean): void;\n}\n\nfunction emitHook(runtime: PipelineRuntime, emit: (hooks: PipelineHooks) => void): void {\n  if (!runtime.hooks) return;\n  const hookSets = Array.isArray(runtime.hooks) ? runtime.hooks : [runtime.hooks];\n  for (const hooks of hookSets) {\n    try {\n      emit(hooks);\n    } catch (error) {\n      runtime.log.warn(\n        `Pipeline hook failed: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n}\n\nexport function createPipelineLifecycleObserver(\n  pipelineId: string,\n  runtime: PipelineRuntime,\n  trace: PipelineTraceEmitter | undefined\n): PipelineLifecycleObserver {\n  return {\n    pipelineStart(plan, targetIds) {\n      emitHook(runtime, (hooks) => hooks.onPipelineStart?.(plan));\n      trace?.pipelineStart(plan, targetIds);\n    },\n    stepStatus(event, traceStatus = true) {\n      emitHook(runtime, (hooks) => hooks.onStepStatus?.(event));\n      switch (event.status) {\n        case \"planned\":\n          emitHook(runtime, (hooks) => hooks.onStepPlan?.(event));\n          break;\n        case \"running\":\n          if (event.progress) {\n            const progress = event.progress;\n            emitHook(runtime, (hooks) => hooks.onStepProgress?.({ ...event, progress }));\n          } else {\n            emitHook(runtime, (hooks) =>\n              hooks.onStepStart?.({\n                attemptId: event.attemptId,\n                pipelineId: event.pipelineId,\n                status: \"running\",\n                step: event.step,\n              })\n            );\n          }\n          break;\n        case \"cancelled\":\n          emitHook(runtime, (hooks) => hooks.onStepCancel?.(event));\n          break;\n        case \"failed\":\n          emitHook(runtime, (hooks) => hooks.onStepFail?.(event));\n          break;\n        case \"skipped\":\n          emitHook(runtime, (hooks) => hooks.onStepSkip?.(event));\n          break;\n        case \"completed\":\n          emitHook(runtime, (hooks) => hooks.onStepComplete?.(event));\n          break;\n      }\n      if (traceStatus) trace?.stepStatus(event);\n    },\n    reportAttempt: (stepId, attempt, attributes, attemptId) =>\n      trace?.reportAttempt(stepId, attempt, attributes, attemptId),\n    log: (level, message, params, stepId, attemptId) =>\n      trace?.log(level, message, params, stepId, attemptId),\n    finalizeStart() {\n      emitHook(runtime, (hooks) => hooks.onFinalizeStart?.({ pipelineId }));\n      trace?.finalizeStart();\n    },\n    finalizeComplete(durationMs, value) {\n      emitHook(runtime, (hooks) => hooks.onFinalizeComplete?.({ durationMs, pipelineId, value }));\n      trace?.finalizeComplete(durationMs);\n    },\n    finalizeError(error, durationMs) {\n      emitHook(runtime, (hooks) => hooks.onFinalizeError?.({ durationMs, error, pipelineId }));\n      trace?.finalizeError(error, durationMs);\n    },\n    pipelineComplete(result) {\n      emitHook(runtime, (hooks) => hooks.onPipelineComplete?.(result));\n      trace?.pipelineComplete(result);\n    },\n    flush: () => trace?.flush() ?? Promise.resolve(),\n  };\n}\n\n/** Same start/complete projection executePlannedRun uses for an invalid plan. */\nexport async function emitRejectedPlanLifecycle(\n  pipelineId: string,\n  targetIds: readonly string[],\n  plan: PipelinePlan,\n  runtime: PipelineRuntime,\n  result: PipelineRun<unknown>\n): Promise<void> {\n  const identity: PipelineTraceContext = { runId: result.runId };\n  if (result.correlationId !== undefined) identity.correlationId = result.correlationId;\n  if (result.parentRunId) identity.parentRunId = result.parentRunId;\n  if (runtime.tracing?.itemKey) identity.itemKey = runtime.tracing.itemKey;\n  const lifecycle = createPipelineLifecycleObserver(\n    pipelineId,\n    runtime,\n    createPipelineTraceEmitter(pipelineId, runtime.tracing, runtime.log, identity, runtime.now)\n  );\n  lifecycle.pipelineStart(plan, targetIds);\n  lifecycle.pipelineComplete(result);\n  await lifecycle.flush();\n}\n"]}

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

@@ -0,0 +1,17 @@
+import type { PipelineDefinition, StepsOptions } from "./pipeline-definition.js";
+import { type CompiledStepGraph } from "./pipeline-graph.js";
+import type { AnyStep } from "./pipeline-steps.js";
+import type { StandardSchemaV1 } from "./pipeline-types.js";
+export interface CompiledPipeline<TSteps extends readonly AnyStep[] = readonly AnyStep[], TResult = unknown, TTargets extends readonly TSteps[number][] = readonly [], TResultSchema extends StandardSchemaV1 | undefined = undefined> {
+    readonly declaredTargets: readonly AnyStep<StepsOptions<TSteps>>[];
+    readonly finalize: PipelineDefinition<TSteps, TResult, TTargets, TResultSchema>["finalize"];
+    readonly id: string;
+    readonly optionsSchema: StandardSchemaV1 | undefined;
+    readonly orderedSteps: readonly AnyStep<StepsOptions<TSteps>>[];
+    readonly requiredFinalizerSteps: readonly AnyStep<StepsOptions<TSteps>>[] | undefined;
+    readonly stepGraph: ReadonlyMap<AnyStep, CompiledStepGraph>;
+    readonly resultSchema: TResultSchema | undefined;
+    readonly stepIds: readonly string[];
+    readonly targetIds: readonly string[];
+}
+export declare function compilePipeline<TSteps extends readonly AnyStep[], TResult, TTargets extends readonly TSteps[number][], TResultSchema extends StandardSchemaV1 | undefined>(definition: PipelineDefinition<TSteps, TResult, TTargets, TResultSchema>): CompiledPipeline<TSteps, TResult, TTargets, TResultSchema>;