tubeless 0.2.2 → 0.2.4

package/skills/tubeless/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: tubeless
+description: Author, modify, or review typed Tubeless pipelines, pipeline-backed CLI commands, and project catalogs in TypeScript projects. Use for dependency modeling, failure and skip policies, dry runs, child pipelines, and pipeline tests.
+---
+
+# Author Tubeless pipelines
+
+Use the project's installed Tubeless version and public package imports. Keep
+domain logic in ordinary functions and make orchestration explicit in the graph.
+
+## Find the matching documentation
+
+Read the consumer's package manifest, installed Tubeless version, and existing
+pipeline conventions first. The installed `tubeless` package includes `docs/`
+and `examples/`; locate it through the project's package manager. Within the
+Tubeless source repository, use those directories at the repository root.
+
+Read `docs/agent-guide.md`, then the smallest matching example in
+`docs/recipes.md`. These paths are relative to the **Tubeless package**, not
+this installed skill or the consumer's repository. If package docs are absent,
+start with the [public documentation index](https://tubeless.io/llms.txt),
+[agent guide](https://tubeless.io/docs/agent-guide.md), and
+[recipes](https://tubeless.io/docs/recipes.md). Confirm newer examples against
+the installed declarations before using them; do not silently upgrade Tubeless.
+
+## Authoring decisions
+
+- Use `createSteps<TDomainOptions>()` per pipeline. Domain options contain
+  business inputs; pass built-in controls separately to `run(options, controls?)`.
+- Give steps stable kebab-case IDs and descriptions of their domain work.
+  `name` is an optional display label. Return values from steps and consume
+  inferred dependency outputs instead of sharing mutable state.
+- Use `dependsOn` for required outputs, `optionalDependsOn` for expected
+  absence, and `skipAfterFailureOf` for a failure gate without a required value.
+  Keep publication dependent on successful validation.
+- Use `step.skippable` for an intentional successful omission. Handle its
+  `T | undefined` output explicitly; do not turn exceptions into skips.
+- Set `dryRun: "skip"` on writes and other external side effects, or supply a
+  side-effect-free typed preview handler. Unmarked steps still run in dry runs.
+- Use `requireOutputs` when the final result requires specific outputs. A plain
+  finalizer is appropriate when partial results are valid domain results.
+- Use `runOrThrow` for callers expecting a successful value, `run` for callers
+  inspecting structured failures or partial results, and `plan(controls)` when
+  no work should execute. Plans do not validate domain input.
+- Use `context.log`, forward `context.signal`, use `context.sleep` for waits,
+  and report progress for long loops. Resolve relative paths from `context.cwd`.
+- Branch on structured error `code`, `phase`, and `kind`, not message text.
+
+## Add only the capabilities the workflow needs
+
+Read the corresponding package recipe before using these features:
+
+- `fromPipeline` for an independently useful child workflow;
+  `forEachPipeline` for runtime fan-out with stable keys and bounded concurrency.
+  Use ordinary helpers or `runConcurrent` for lightweight work without child
+  lifecycle reporting.
+- `createSteps(optionsSchema)`, `outputSchema`, or `resultSchema` for runtime
+  validation at untrusted boundaries. Reuse the project's Standard Schema
+  implementation; core needs no schema dependency.
+- `definePipelineCommand` from `tubeless/workbench` for pipeline-backed scripts.
+  Built-in `--step` / `--target` flags map to `stepIds` / `targets`. Do not
+  redeclare built-in flags. Read `docs/cli.md` for option mapping.
+- Use `pipelines/<name>.ts` for definitions and `scripts/<name>.ts` for command
+  wrappers when introducing a layout. Register commands explicitly in
+  `tubeless.project.ts`; adapt the package's `examples/catalog/` without copying
+  unrelated example IDs. Preserve existing consumer conventions.
+- Keep storage and Studio optional. Read `docs/studio.md` before adding them;
+  read the composition guides before adding child or remote execution.
+- Implement concrete JSON or telemetry adapters in the application against
+  `PipelineTraceExporter`; adapt the package's `examples/tracing.ts`. Use
+  `composeTraceExporters` for multiple trace destinations. Finished traces
+  can be read with `tubeless history --trace` or `tubeless ui --trace`; recorded
+  contents are not redacted.
+
+## Verify
+
+Typecheck the consumer and run focused tests. Use `createPipelineTestRuntime`
+from `tubeless/testing` for deterministic observation and cancellation, with
+fake I/O for side effects. Check failure gates, skipped outputs, and dry-run
+behavior. Generate diagrams with `pipeline.toMermaid()` when useful.
+
+Within the Tubeless source repository, also follow its `AGENTS.md` and run
+`make check`. For repository evaluations, write `solution.ts` in a disposable
+directory and compile with `bun run eval:agent --`; do not execute model-written
+submissions in the repository. Follow `docs/agent-evaluations.md` for assessment.

package/skills/tubeless-make-pipeline/SKILL.md

@@ -0,0 +1,126 @@
+---
+name: tubeless-make-pipeline
+description: Convert existing TypeScript or JavaScript scripts, jobs, service workflows, or ETL code into thoughtfully structured, typed Tubeless pipelines. Use when asked to extract a pipeline from existing code, replace ad hoc orchestration, or organize a large workflow into typed steps while preserving behavior.
+---
+
+# Make a Tubeless pipeline from existing code
+
+Implement the conversion in the user's project. Preserve observable behavior and
+reuse domain functions while making data flow, ordering, and failure policy
+visible in a typed graph.
+
+## Ground the design in the existing code
+
+Read the entrypoint, its callers, relevant helpers, tests, and package manifest.
+Trace inputs, outputs, external effects, error handling, retries, cancellation,
+and any shared mutable state. Identify ordering requirements that are currently
+implicit, such as validation before publication or writes inside a transaction.
+Preserve transaction boundaries, cleanup, and resource ownership when splitting
+work. A transaction or critical section can remain inside one step.
+
+Identify the installed Tubeless version. Read `docs/agent-guide.md` and the
+smallest matching `docs/recipes.md` example from that installed package, or from
+the package root when working in Tubeless itself. These are package paths, not
+paths relative to this skill. If unavailable, use the
+[agent guide](https://tubeless.io/docs/agent-guide.md) and
+[recipe index](https://tubeless.io/docs/recipes.md), checking APIs against the
+installed declarations. If Tubeless is missing, add it using the project's
+package manager and dependency conventions. Avoid unrelated upgrades.
+
+Before editing, briefly explain the proposed steps, their inputs and outputs,
+and which steps can write externally. Resolve uncertainties from code and tests;
+ask only when a missing domain decision affects correctness.
+
+## Choose meaningful boundaries
+
+Create steps around domain outcomes an operator would recognize: load records,
+validate a batch, enrich records, build an artifact, publish it. A useful step
+has a coherent output and a reason to appear in a plan or failure report.
+
+- Keep small parsing, formatting, and mapping functions as helpers inside a
+  step. Do not make every function call a step or hide the entire old script in
+  one step when it contains distinct stages.
+- Build dependencies from consumed values and required ordering. Do not rely
+  on declaration order. Keep independent work independent, but preserve the
+  original concurrency, rate limits, and ordering unless a change is intended.
+- Use `dependsOn` when a value or successful prerequisite is required. Use
+  `optionalDependsOn` only when absence is a valid case. Use
+  `skipAfterFailureOf` when a failed or cancelled prerequisite must block work
+  without requiring its output. Optional input alone is not a failure gate.
+- Replace shared mutable accumulators with returned step outputs. Reuse
+  domain types and helpers; avoid a generic bag of optional fields passed
+  through every step.
+- Extract a child pipeline only when that workflow is independently useful.
+  Choose `forEachPipeline` for per-item lifecycle reporting; use bounded helper
+  concurrency when that reporting is unnecessary. Read the matching recipe
+  before introducing either.
+
+## Keep the graph typed
+
+Use one `createSteps<TDomainOptions>()` builder and one `definePipeline` per
+pipeline. Import from `tubeless` and its public subpaths. Keep business inputs
+in domain options; built-in run controls belong in the separate controls argument.
+
+Give each step a stable literal kebab-case ID and an operational description.
+Let `dependsOn: [step]` infer input types from returned outputs. Preserve
+inference in step collections; do not widen IDs to `string` or use `any`, broad
+records, or type assertions to bypass graph errors. Add explicit output types
+where they define a domain contract, rather than annotating every intermediate.
+
+Parse untrusted inputs as `unknown` and validate at the boundary with existing
+project validators. Use Standard Schema support when it fits existing schemas;
+TypeScript alone does not validate external data.
+
+Use `requireOutputs` for a result that requires completed steps. If dry runs,
+intentional skips, or best-effort execution legitimately produce partial
+results, model that result explicitly and narrow missing values. Do not default
+a missing required output to an empty array, `false`, or a fake success value.
+
+## Preserve operational behavior
+
+- Mark filesystem writes, database mutations, publication, and other external
+  side effects with `dryRun: "skip"` or a typed, side-effect-free `dryRun`
+  handler. Unmarked steps still execute in a dry run. Read-only fetches may
+  still contact real systems; use fake I/O during verification.
+- Follow skipped values through downstream steps and the finalizer. A skipped
+  write may prevent `requireOutputs` from producing a result. Either preserve
+  that contract or define an honest preview result; never fabricate a completed
+  write to make dry runs pass.
+- Keep validation required for publication. Test this even with
+  `continueOnError` if the caller enables best-effort execution.
+- Use `step.skippable` only for a successful policy decision. Preserve thrown
+  failures and their causes; branch on structured Tubeless error fields.
+  Map pipeline errors at the caller boundary if existing callers require a
+  specific error contract.
+- Use `context.log` inside steps. Pass `context.signal` to I/O and retry helpers,
+  use `context.sleep` for waits, and report progress for long loops. Preserve
+  existing retry scope and idempotency; do not add retries to unsafe mutations.
+- Keep pipeline imports free of execution and external effects. Leave invocation
+  in the existing caller or a thin command wrapper. Retain externally used
+  function signatures and return shapes unless the user requests changing them.
+- Use `runOrThrow(options, controls?)` for value-or-error callers and `run` for
+  explicit report handling. `continueOnError` does not make `runOrThrow` succeed
+  after failures. Keep cleanup in a reliable `finally` or resource scope.
+
+Respect the project's layout. If it has no convention, use
+`pipelines/<name>.ts` and export `<Name>Pipeline`. Add a
+`definePipelineCommand` wrapper only for a CLI workflow, following the CLI
+recipe; register it in an existing project catalog when appropriate. Keep
+storage, Studio, telemetry exporters, and remote engines optional.
+
+## Prove the conversion
+
+Typecheck and run the project's focused tests. Adapt existing tests to compare
+observable behavior, not just graph shape. Cover relevant success, validation
+failure, dependency failure, intentional skip, cancellation, and dry-run paths.
+Use `createPipelineTestRuntime` from `tubeless/testing` with fake I/O, and assert
+that forbidden writes never happen. Avoid executing production work as a test.
+
+Inspect `pipeline.plan()` and, for declared goals, target selection. Planning
+does not execute steps or validate domain inputs; it cannot prove runtime
+correctness. Generate a graph with `pipeline.toMermaid()` when it helps explain
+the design. Within the Tubeless source repository, also run `make check`.
+
+Finish with the implemented step structure, preserved or intentionally changed
+behavior, validation results, and any unresolved contract decisions. Remove
+superseded orchestration once callers use the pipeline; keep reusable helpers.

package/dist/node/env.d.ts

@@ -1 +0,0 @@
-export declare function requireEnv(varName: string, usedBy: string): string;

package/dist/node/env.js

@@ -1,8 +0,0 @@
-export function requireEnv(varName, usedBy) {
-    const value = process.env[varName];
-    if (!value) {
-        throw new Error(`${varName} is required for ${usedBy}`);
-    }
-    return value;
-}
-//# sourceMappingURL=env.js.map

package/dist/node/env.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/node/env.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,MAAc;IACxD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,oBAAoB,MAAM,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["export function requireEnv(varName: string, usedBy: string): string {\n  const value = process.env[varName];\n  if (!value) {\n    throw new Error(`${varName} is required for ${usedBy}`);\n  }\n  return value;\n}\n"]}

package/dist/node/file-utils.d.ts

@@ -1,3 +0,0 @@
-export declare function writeJson(filePath: string, value: unknown): void;
-export declare function readJson<T>(filePath: string): T;
-export declare function resetDir(dirPath: string): void;

package/dist/node/file-utils.js

@@ -1,17 +0,0 @@
-import * as fs from "fs";
-import { writeAtomicText } from "./atomic-text.js";
-export function writeJson(filePath, value) {
-    writeAtomicText(filePath, `${JSON.stringify(value, null, 2)}\n`);
-}
-export function readJson(filePath) {
-    // SAFETY: the caller's type parameter T is the contract for the file's
-    // contents; the file is expected to hold JSON matching T (files written by
-    // writeJson round-trip). JSON.parse returns `any`, so the assertion only
-    // documents the caller's guarantee — it performs no runtime narrowing.
-    return JSON.parse(fs.readFileSync(filePath, "utf-8"));
-}
-export function resetDir(dirPath) {
-    fs.rmSync(dirPath, { recursive: true, force: true });
-    fs.mkdirSync(dirPath, { recursive: true });
-}
-//# sourceMappingURL=file-utils.js.map

package/dist/node/file-utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-utils.js","sourceRoot":"","sources":["../../src/node/file-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,KAAc;IACxD,eAAe,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAI,QAAgB;IAC1C,uEAAuE;IACvE,2EAA2E;IAC3E,yEAAyE;IACzE,uEAAuE;IACvE,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAM,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC7C,CAAC","sourcesContent":["import * as fs from \"fs\";\nimport { writeAtomicText } from \"./atomic-text.js\";\n\nexport function writeJson(filePath: string, value: unknown): void {\n  writeAtomicText(filePath, `${JSON.stringify(value, null, 2)}\\n`);\n}\n\nexport function readJson<T>(filePath: string): T {\n  // SAFETY: the caller's type parameter T is the contract for the file's\n  // contents; the file is expected to hold JSON matching T (files written by\n  // writeJson round-trip). JSON.parse returns `any`, so the assertion only\n  // documents the caller's guarantee — it performs no runtime narrowing.\n  return JSON.parse(fs.readFileSync(filePath, \"utf-8\")) as T;\n}\n\nexport function resetDir(dirPath: string): void {\n  fs.rmSync(dirPath, { recursive: true, force: true });\n  fs.mkdirSync(dirPath, { recursive: true });\n}\n"]}

package/dist/node/paths.d.ts

@@ -1,8 +0,0 @@
-/**
- * Declares a set of workspace-relative default paths as one factory instead of one
- * `function defaultXDir(cwd) { return path.join(cwd, "...") }` per path. The returned
- * function re-resolves against `cwd` on every call — nothing is computed or cached at
- * module-load time, so a frozen-`process.cwd()` bug cannot be reintroduced by
- * construction.
- */
-export declare function definePaths<T extends Record<string, string>>(relativePaths: T): (cwd: string) => T;

package/dist/node/paths.js

@@ -1,19 +0,0 @@
-import * as path from "path";
-/**
- * Declares a set of workspace-relative default paths as one factory instead of one
- * `function defaultXDir(cwd) { return path.join(cwd, "...") }` per path. The returned
- * function re-resolves against `cwd` on every call — nothing is computed or cached at
- * module-load time, so a frozen-`process.cwd()` bug cannot be reintroduced by
- * construction.
- */
-export function definePaths(relativePaths) {
-    return (cwd) => 
-    // SAFETY: Object.entries(relativePaths) yields exactly T's keys, and every
-    // value is path.join(cwd, relativePath), a string — so the result satisfies
-    // T's Record<string, string> constraint.
-    Object.fromEntries(Object.entries(relativePaths).map(([key, relativePath]) => [
-        key,
-        path.join(cwd, relativePath),
-    ]));
-}
-//# sourceMappingURL=paths.js.map

package/dist/node/paths.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/node/paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,aAAgB;IAEhB,OAAO,CAAC,GAAW,EAAE,EAAE;IACrB,2EAA2E;IAC3E,4EAA4E;IAC5E,yCAAyC;IACzC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,EAAE,CAAC;QACzD,GAAG;QACH,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC;KAC7B,CAAC,CACE,CAAC;AACX,CAAC","sourcesContent":["import * as path from \"path\";\n\n/**\n * Declares a set of workspace-relative default paths as one factory instead of one\n * `function defaultXDir(cwd) { return path.join(cwd, \"...\") }` per path. The returned\n * function re-resolves against `cwd` on every call — nothing is computed or cached at\n * module-load time, so a frozen-`process.cwd()` bug cannot be reintroduced by\n * construction.\n */\nexport function definePaths<T extends Record<string, string>>(\n  relativePaths: T\n): (cwd: string) => T {\n  return (cwd: string) =>\n    // SAFETY: Object.entries(relativePaths) yields exactly T's keys, and every\n    // value is path.join(cwd, relativePath), a string — so the result satisfies\n    // T's Record<string, string> constraint.\n    Object.fromEntries(\n      Object.entries(relativePaths).map(([key, relativePath]) => [\n        key,\n        path.join(cwd, relativePath),\n      ])\n    ) as T;\n}\n"]}

package/dist/reporter/prompt-select.d.ts

@@ -1,80 +0,0 @@
-/**
- * One option in an interactive multi-select list.
- * Domain packages supply their own values and labels; this module stays generic.
- */
-export interface MultiSelectChoice<T extends string = string> {
-    value: T;
-    /** Shown in fzf/readline. Defaults to `value`. */
-    label?: string;
-}
-/**
- * Result of a multi-select prompt.
- * - `all`: user chose the explicit all-option (meaning is domain-defined)
- * - `values`: one or more concrete choice values, in choice-list order
- */
-export type MultiSelectResult<T extends string = string> = {
-    kind: "all";
-} | {
-    kind: "values";
-    values: readonly T[];
-};
-export interface PromptMultiSelectOptions<T extends string = string> {
-    /** Items the user may pick. */
-    choices: readonly (MultiSelectChoice<T> | T)[];
-    /**
-     * When true, show an "all" row that returns `{ kind: "all" }`.
-     * Domains decide what "all" expands to after the prompt returns.
-     */
-    allowAll?: boolean;
-    /** Label for the all-option row. Defaults to `"All"`. */
-    allLabel?: string;
-    /** Value token recognized as all (input parse + fzf). Defaults to `"all"`. */
-    allValue?: string;
-    /** Heading printed above the numbered fallback menu. */
-    title?: string;
-    /** fzf `--header` text. */
-    header?: string;
-    /** fzf `--prompt` and readline question prefix. Defaults to `"> "`. */
-    prompt?: string;
-    /** Prefer fzf multi-select when the binary is available. Defaults to true. */
-    preferFzf?: boolean;
-    stdin?: NodeJS.ReadableStream;
-    stdout?: NodeJS.WritableStream;
-}
-export interface ParseMultiSelectInputOptions {
-    allowAll?: boolean;
-    allValue?: string;
-}
-/** Normalize string or `{ value, label }` choices into a stable list. */
-export declare function normalizeMultiSelectChoices<T extends string>(choices: readonly (MultiSelectChoice<T> | T)[]): MultiSelectChoice<T>[];
-/**
- * Parse a space/comma-separated selection of 1-based indices, choice values,
- * or the all-token. Returns null when the input is empty or unparseable.
- */
-export declare function parseMultiSelectInput<T extends string>(input: string, choices: readonly (MultiSelectChoice<T> | T)[], options?: ParseMultiSelectInputOptions): MultiSelectResult<T> | null;
-/**
- * Interactively multi-select from a list of choices.
- *
- * Prefers fzf multi-select when available; falls back to a numbered prompt.
- * Returns `null` when the user cancels or the session is non-interactive.
- *
- * @example
- * ```ts
- * import { promptMultiSelect } from "tubeless/cli";
- *
- * const picked = await promptMultiSelect({
- *   choices: [
- *     { value: "shard-a", label: "Shard A (east)" },
- *     { value: "shard-b", label: "Shard B (west)" },
- *   ],
- *   allowAll: true,
- *   allLabel: "All shards",
- *   title: "Select shards to process",
- *   prompt: "shards> ",
- * });
- * if (!picked) throw new Error("Selection cancelled");
- * if (picked.kind === "all") runAll();
- * else runSelected(picked.values);
- * ```
- */
-export declare function promptMultiSelect<T extends string>(options: PromptMultiSelectOptions<T>): Promise<MultiSelectResult<T> | null>;

package/dist/reporter/prompt-select.js

@@ -1,197 +0,0 @@
-import { spawnSync } from "node:child_process";
-import * as readline from "node:readline/promises";
-function canUseInteractivePrompt(stdin, stdout) {
-    const inTty = "isTTY" in stdin && stdin.isTTY === true;
-    const outTty = "isTTY" in stdout && stdout.isTTY === true;
-    return Boolean(inTty && outTty);
-}
-function fzfAvailable() {
-    const result = spawnSync("fzf", ["--version"], {
-        encoding: "utf8",
-        stdio: ["ignore", "pipe", "ignore"],
-    });
-    return result.status === 0;
-}
-function isStringChoice(choice) {
-    return typeof choice === "string";
-}
-/** Normalize string or `{ value, label }` choices into a stable list. */
-export function normalizeMultiSelectChoices(choices) {
-    return choices.map((choice) => isStringChoice(choice)
-        ? { value: choice, label: choice }
-        : { ...choice, label: choice.label ?? choice.value });
-}
-function displayLabel(choice) {
-    return choice.label ?? choice.value;
-}
-/**
- * Parse a space/comma-separated selection of 1-based indices, choice values,
- * or the all-token. Returns null when the input is empty or unparseable.
- */
-export function parseMultiSelectInput(input, choices, options = {}) {
-    const normalized = normalizeMultiSelectChoices(choices);
-    const allowAll = options.allowAll ?? false;
-    const allValue = (options.allValue ?? "all").toLowerCase();
-    const trimmed = input.trim().toLowerCase();
-    if (!trimmed)
-        return null;
-    if (allowAll && (trimmed === allValue || trimmed === "*")) {
-        return { kind: "all" };
-    }
-    const tokens = trimmed.split(/[\s,]+/).filter(Boolean);
-    if (tokens.length === 0)
-        return null;
-    const valueByLower = new Map(normalized.map((choice) => [choice.value.toLowerCase(), choice.value]));
-    const selected = new Set();
-    for (const token of tokens) {
-        if (allowAll && (token === allValue || token === "*")) {
-            return { kind: "all" };
-        }
-        const asIndex = Number(token);
-        if (Number.isInteger(asIndex) && asIndex >= 1 && asIndex <= normalized.length) {
-            selected.add(normalized[asIndex - 1].value);
-            continue;
-        }
-        const matched = valueByLower.get(token);
-        if (matched !== undefined) {
-            selected.add(matched);
-            continue;
-        }
-        return null;
-    }
-    if (selected.size === 0)
-        return null;
-    return {
-        kind: "values",
-        values: normalized.map((choice) => choice.value).filter((value) => selected.has(value)),
-    };
-}
-function promptWithFzf(choices, options) {
-    const lines = [
-        ...(options.allowAll ? [`${options.allValue}\t${options.allLabel}`] : []),
-        ...choices.map((choice) => `${choice.value}\t${displayLabel(choice)}`),
-    ];
-    // Candidate list is piped on stdin; fzf opens /dev/tty for the interactive UI.
-    const result = spawnSync("fzf", [
-        "--multi",
-        "--delimiter=\t",
-        "--with-nth=2..",
-        `--header=${options.header}`,
-        `--prompt=${options.prompt}`,
-        "--height=40%",
-        "--reverse",
-    ], {
-        input: `${lines.join("\n")}\n`,
-        encoding: "utf8",
-        stdio: ["pipe", "pipe", "inherit"],
-    });
-    if (result.status !== 0) {
-        return null;
-    }
-    const selectedLines = (result.stdout ?? "")
-        .split("\n")
-        .map((line) => line.trim())
-        .filter(Boolean);
-    if (selectedLines.length === 0)
-        return null;
-    const allToken = options.allValue.toLowerCase();
-    if (options.allowAll &&
-        selectedLines.some((line) => {
-            const key = (line.split("\t")[0] ?? line).toLowerCase();
-            return key === allToken;
-        })) {
-        return { kind: "all" };
-    }
-    const selected = new Set();
-    for (const line of selectedLines) {
-        const key = line.split("\t")[0] ?? "";
-        const matched = choices.find((choice) => choice.value === key);
-        if (matched)
-            selected.add(matched.value);
-    }
-    if (selected.size === 0)
-        return null;
-    return {
-        kind: "values",
-        values: choices.map((choice) => choice.value).filter((value) => selected.has(value)),
-    };
-}
-async function promptWithReadline(choices, options) {
-    const output = options.stdout;
-    output.write(`${options.title}:\n`);
-    if (options.allowAll) {
-        output.write(`  ${options.allValue}  ${options.allLabel}\n`);
-    }
-    choices.forEach((choice, index) => {
-        output.write(`  ${String(index + 1).padStart(2, " ")}. ${displayLabel(choice)}\n`);
-    });
-    const allHint = options.allowAll ? `, or '${options.allValue}'` : "";
-    output.write(`\nEnter numbers and/or values (space/comma separated)${allHint}. Empty cancels.\n`);
-    const rl = readline.createInterface({ input: options.stdin, output: options.stdout });
-    try {
-        const answer = await rl.question(options.prompt.endsWith(" ") ? options.prompt : `${options.prompt} `);
-        return parseMultiSelectInput(answer, choices, {
-            allowAll: options.allowAll,
-            allValue: options.allValue,
-        });
-    }
-    finally {
-        rl.close();
-    }
-}
-/**
- * Interactively multi-select from a list of choices.
- *
- * Prefers fzf multi-select when available; falls back to a numbered prompt.
- * Returns `null` when the user cancels or the session is non-interactive.
- *
- * @example
- * ```ts
- * import { promptMultiSelect } from "tubeless/cli";
- *
- * const picked = await promptMultiSelect({
- *   choices: [
- *     { value: "shard-a", label: "Shard A (east)" },
- *     { value: "shard-b", label: "Shard B (west)" },
- *   ],
- *   allowAll: true,
- *   allLabel: "All shards",
- *   title: "Select shards to process",
- *   prompt: "shards> ",
- * });
- * if (!picked) throw new Error("Selection cancelled");
- * if (picked.kind === "all") runAll();
- * else runSelected(picked.values);
- * ```
- */
-export async function promptMultiSelect(options) {
-    const choices = normalizeMultiSelectChoices(options.choices);
-    if (choices.length === 0) {
-        throw new Error("promptMultiSelect requires at least one choice");
-    }
-    const stdin = options.stdin ?? process.stdin;
-    const stdout = options.stdout ?? process.stdout;
-    const preferFzf = options.preferFzf ?? true;
-    const allowAll = options.allowAll ?? false;
-    const allValue = options.allValue ?? "all";
-    const allLabel = options.allLabel ?? "All";
-    const title = options.title ?? "Select one or more options";
-    const header = options.header ?? "Select options (TAB multi-select, Enter confirm)";
-    const prompt = options.prompt ?? "> ";
-    if (!canUseInteractivePrompt(stdin, stdout)) {
-        return null;
-    }
-    if (preferFzf && fzfAvailable()) {
-        return promptWithFzf(choices, { allowAll, allLabel, allValue, header, prompt });
-    }
-    return promptWithReadline(choices, {
-        allowAll,
-        allLabel,
-        allValue,
-        title,
-        prompt,
-        stdin,
-        stdout,
-    });
-}
-//# sourceMappingURL=prompt-select.js.map

package/dist/reporter/prompt-select.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"prompt-select.js","sourceRoot":"","sources":["../../src/reporter/prompt-select.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawnSync } from \"node:child_process\";\nimport * as readline from \"node:readline/promises\";\n\n/**\n * One option in an interactive multi-select list.\n * Domain packages supply their own values and labels; this module stays generic.\n */\nexport interface MultiSelectChoice<T extends string = string> {\n  value: T;\n  /** Shown in fzf/readline. Defaults to `value`. */\n  label?: string;\n}\n\n/**\n * Result of a multi-select prompt.\n * - `all`: user chose the explicit all-option (meaning is domain-defined)\n * - `values`: one or more concrete choice values, in choice-list order\n */\nexport type MultiSelectResult<T extends string = string> =\n  | { kind: \"all\" }\n  | { kind: \"values\"; values: readonly T[] };\n\nexport interface PromptMultiSelectOptions<T extends string = string> {\n  /** Items the user may pick. */\n  choices: readonly (MultiSelectChoice<T> | T)[];\n  /**\n   * When true, show an \"all\" row that returns `{ kind: \"all\" }`.\n   * Domains decide what \"all\" expands to after the prompt returns.\n   */\n  allowAll?: boolean;\n  /** Label for the all-option row. Defaults to `\"All\"`. */\n  allLabel?: string;\n  /** Value token recognized as all (input parse + fzf). Defaults to `\"all\"`. */\n  allValue?: string;\n  /** Heading printed above the numbered fallback menu. */\n  title?: string;\n  /** fzf `--header` text. */\n  header?: string;\n  /** fzf `--prompt` and readline question prefix. Defaults to `\"> \"`. */\n  prompt?: string;\n  /** Prefer fzf multi-select when the binary is available. Defaults to true. */\n  preferFzf?: boolean;\n  stdin?: NodeJS.ReadableStream;\n  stdout?: NodeJS.WritableStream;\n}\n\nexport interface ParseMultiSelectInputOptions {\n  allowAll?: boolean;\n  allValue?: string;\n}\n\nfunction canUseInteractivePrompt(\n  stdin: NodeJS.ReadableStream,\n  stdout: NodeJS.WritableStream\n): boolean {\n  const inTty = \"isTTY\" in stdin && stdin.isTTY === true;\n  const outTty = \"isTTY\" in stdout && stdout.isTTY === true;\n  return Boolean(inTty && outTty);\n}\n\nfunction fzfAvailable(): boolean {\n  const result = spawnSync(\"fzf\", [\"--version\"], {\n    encoding: \"utf8\",\n    stdio: [\"ignore\", \"pipe\", \"ignore\"],\n  });\n  return result.status === 0;\n}\n\nfunction isStringChoice<T extends string>(choice: MultiSelectChoice<T> | T): choice is T {\n  return typeof choice === \"string\";\n}\n\n/** Normalize string or `{ value, label }` choices into a stable list. */\nexport function normalizeMultiSelectChoices<T extends string>(\n  choices: readonly (MultiSelectChoice<T> | T)[]\n): MultiSelectChoice<T>[] {\n  return choices.map((choice) =>\n    isStringChoice(choice)\n      ? { value: choice, label: choice }\n      : { ...choice, label: choice.label ?? choice.value }\n  );\n}\n\nfunction displayLabel(choice: MultiSelectChoice<string>): string {\n  return choice.label ?? choice.value;\n}\n\n/**\n * Parse a space/comma-separated selection of 1-based indices, choice values,\n * or the all-token. Returns null when the input is empty or unparseable.\n */\nexport function parseMultiSelectInput<T extends string>(\n  input: string,\n  choices: readonly (MultiSelectChoice<T> | T)[],\n  options: ParseMultiSelectInputOptions = {}\n): MultiSelectResult<T> | null {\n  const normalized = normalizeMultiSelectChoices(choices);\n  const allowAll = options.allowAll ?? false;\n  const allValue = (options.allValue ?? \"all\").toLowerCase();\n  const trimmed = input.trim().toLowerCase();\n  if (!trimmed) return null;\n\n  if (allowAll && (trimmed === allValue || trimmed === \"*\")) {\n    return { kind: \"all\" };\n  }\n\n  const tokens = trimmed.split(/[\\s,]+/).filter(Boolean);\n  if (tokens.length === 0) return null;\n\n  const valueByLower = new Map(\n    normalized.map((choice) => [choice.value.toLowerCase(), choice.value])\n  );\n  const selected = new Set<T>();\n\n  for (const token of tokens) {\n    if (allowAll && (token === allValue || token === \"*\")) {\n      return { kind: \"all\" };\n    }\n    const asIndex = Number(token);\n    if (Number.isInteger(asIndex) && asIndex >= 1 && asIndex <= normalized.length) {\n      selected.add(normalized[asIndex - 1]!.value);\n      continue;\n    }\n    const matched = valueByLower.get(token);\n    if (matched !== undefined) {\n      selected.add(matched);\n      continue;\n    }\n    return null;\n  }\n\n  if (selected.size === 0) return null;\n  return {\n    kind: \"values\",\n    values: normalized.map((choice) => choice.value).filter((value) => selected.has(value)),\n  };\n}\n\nfunction promptWithFzf<T extends string>(\n  choices: readonly MultiSelectChoice<T>[],\n  options: {\n    allowAll: boolean;\n    allLabel: string;\n    allValue: string;\n    header: string;\n    prompt: string;\n  }\n): MultiSelectResult<T> | null {\n  const lines = [\n    ...(options.allowAll ? [`${options.allValue}\\t${options.allLabel}`] : []),\n    ...choices.map((choice) => `${choice.value}\\t${displayLabel(choice)}`),\n  ];\n  // Candidate list is piped on stdin; fzf opens /dev/tty for the interactive UI.\n  const result = spawnSync(\n    \"fzf\",\n    [\n      \"--multi\",\n      \"--delimiter=\\t\",\n      \"--with-nth=2..\",\n      `--header=${options.header}`,\n      `--prompt=${options.prompt}`,\n      \"--height=40%\",\n      \"--reverse\",\n    ],\n    {\n      input: `${lines.join(\"\\n\")}\\n`,\n      encoding: \"utf8\",\n      stdio: [\"pipe\", \"pipe\", \"inherit\"],\n    }\n  );\n  if (result.status !== 0) {\n    return null;\n  }\n  const selectedLines = (result.stdout ?? \"\")\n    .split(\"\\n\")\n    .map((line) => line.trim())\n    .filter(Boolean);\n  if (selectedLines.length === 0) return null;\n\n  const allToken = options.allValue.toLowerCase();\n  if (\n    options.allowAll &&\n    selectedLines.some((line) => {\n      const key = (line.split(\"\\t\")[0] ?? line).toLowerCase();\n      return key === allToken;\n    })\n  ) {\n    return { kind: \"all\" };\n  }\n\n  const selected = new Set<T>();\n  for (const line of selectedLines) {\n    const key = line.split(\"\\t\")[0] ?? \"\";\n    const matched = choices.find((choice) => choice.value === key);\n    if (matched) selected.add(matched.value);\n  }\n  if (selected.size === 0) return null;\n  return {\n    kind: \"values\",\n    values: choices.map((choice) => choice.value).filter((value) => selected.has(value)),\n  };\n}\n\nasync function promptWithReadline<T extends string>(\n  choices: readonly MultiSelectChoice<T>[],\n  options: {\n    allowAll: boolean;\n    allLabel: string;\n    allValue: string;\n    title: string;\n    prompt: string;\n    stdin: NodeJS.ReadableStream;\n    stdout: NodeJS.WritableStream;\n  }\n): Promise<MultiSelectResult<T> | null> {\n  const output = options.stdout;\n  output.write(`${options.title}:\\n`);\n  if (options.allowAll) {\n    output.write(`  ${options.allValue}  ${options.allLabel}\\n`);\n  }\n  choices.forEach((choice, index) => {\n    output.write(`  ${String(index + 1).padStart(2, \" \")}. ${displayLabel(choice)}\\n`);\n  });\n  const allHint = options.allowAll ? `, or '${options.allValue}'` : \"\";\n  output.write(`\\nEnter numbers and/or values (space/comma separated)${allHint}. Empty cancels.\\n`);\n\n  const rl = readline.createInterface({ input: options.stdin, output: options.stdout });\n  try {\n    const answer = await rl.question(\n      options.prompt.endsWith(\" \") ? options.prompt : `${options.prompt} `\n    );\n    return parseMultiSelectInput(answer, choices, {\n      allowAll: options.allowAll,\n      allValue: options.allValue,\n    });\n  } finally {\n    rl.close();\n  }\n}\n\n/**\n * Interactively multi-select from a list of choices.\n *\n * Prefers fzf multi-select when available; falls back to a numbered prompt.\n * Returns `null` when the user cancels or the session is non-interactive.\n *\n * @example\n * ```ts\n * import { promptMultiSelect } from \"tubeless/cli\";\n *\n * const picked = await promptMultiSelect({\n *   choices: [\n *     { value: \"shard-a\", label: \"Shard A (east)\" },\n *     { value: \"shard-b\", label: \"Shard B (west)\" },\n *   ],\n *   allowAll: true,\n *   allLabel: \"All shards\",\n *   title: \"Select shards to process\",\n *   prompt: \"shards> \",\n * });\n * if (!picked) throw new Error(\"Selection cancelled\");\n * if (picked.kind === \"all\") runAll();\n * else runSelected(picked.values);\n * ```\n */\nexport async function promptMultiSelect<T extends string>(\n  options: PromptMultiSelectOptions<T>\n): Promise<MultiSelectResult<T> | null> {\n  const choices = normalizeMultiSelectChoices(options.choices);\n  if (choices.length === 0) {\n    throw new Error(\"promptMultiSelect requires at least one choice\");\n  }\n\n  const stdin = options.stdin ?? process.stdin;\n  const stdout = options.stdout ?? process.stdout;\n  const preferFzf = options.preferFzf ?? true;\n  const allowAll = options.allowAll ?? false;\n  const allValue = options.allValue ?? \"all\";\n  const allLabel = options.allLabel ?? \"All\";\n  const title = options.title ?? \"Select one or more options\";\n  const header = options.header ?? \"Select options (TAB multi-select, Enter confirm)\";\n  const prompt = options.prompt ?? \"> \";\n\n  if (!canUseInteractivePrompt(stdin, stdout)) {\n    return null;\n  }\n\n  if (preferFzf && fzfAvailable()) {\n    return promptWithFzf(choices, { allowAll, allLabel, allValue, header, prompt });\n  }\n\n  return promptWithReadline(choices, {\n    allowAll,\n    allLabel,\n    allValue,\n    title,\n    prompt,\n    stdin,\n    stdout,\n  });\n}\n"]}

package/dist/studio/run-store-ui-client-source.d.ts

@@ -1 +0,0 @@
-export declare const PIPELINE_RUN_STUDIO_CLIENT_SOURCE: string;