tubeless 0.1.0

package/dist/workbench-plan.js

@@ -0,0 +1,72 @@
+import { parseArgs } from "node:util";
+import { renderPipelinePlan } from "./render.js";
+import { errorMessage, loadPlanSource, TUBELESS_WORKBENCH_EXIT_CODE, writeUsageError, } from "./workbench-shared.js";
+const PLAN_USAGE = `Usage: tubeless plan [options] <pipeline-or-command-file>
+
+Preview pipeline selection without running steps or requiring domain options.
+
+Options:
+  -e, --export <name>   Select a pipeline or command export when the file has more than one
+  -t, --target <id>     Select a declared target and its prerequisites (repeatable)
+  -s, --step <id>       Select exact internal steps (repeatable)
+      --dry-run         Show each step's dry-run disposition
+      --explain         Include target/dependency selection provenance
+      --json            Emit the complete structured plan as JSON
+  -h, --help            Show this help
+`;
+function parsePlanArgs(argv) {
+    return parseArgs({
+        args: [...argv],
+        allowPositionals: true,
+        options: {
+            "dry-run": { type: "boolean" },
+            explain: { type: "boolean" },
+            export: { type: "string", short: "e" },
+            help: { type: "boolean", short: "h" },
+            json: { type: "boolean" },
+            step: { type: "string", short: "s", multiple: true },
+            target: { type: "string", short: "t", multiple: true },
+        },
+        strict: true,
+    });
+}
+export async function runPlan(argv, io) {
+    let parsed;
+    try {
+        parsed = parsePlanArgs(argv);
+    }
+    catch (error) {
+        return writeUsageError(io, errorMessage(error), PLAN_USAGE);
+    }
+    if (parsed.values.help) {
+        io.stdout.write(PLAN_USAGE);
+        return TUBELESS_WORKBENCH_EXIT_CODE.success;
+    }
+    if (parsed.positionals.length !== 1) {
+        return writeUsageError(io, "Pass exactly one pipeline or command file.", PLAN_USAGE);
+    }
+    const loaded = await loadPlanSource(parsed.positionals[0], parsed.values.export, io);
+    if ("exitCode" in loaded)
+        return loaded.exitCode;
+    const controls = {
+        dryRun: parsed.values["dry-run"] ?? false,
+    };
+    if (parsed.values.step !== undefined)
+        controls.stepIds = parsed.values.step;
+    if (parsed.values.target !== undefined)
+        controls.targets = parsed.values.target;
+    const planInput = { dryRun: controls.dryRun };
+    if (controls.stepIds !== undefined)
+        planInput.step = controls.stepIds;
+    if (controls.targets !== undefined)
+        planInput.target = controls.targets;
+    const plan = loaded.source.kind === "command"
+        ? loaded.source.command.plan(planInput)
+        : loaded.source.pipeline.plan(controls);
+    const rendered = parsed.values.json
+        ? renderPipelinePlan(plan, { format: "json", pretty: true })
+        : renderPipelinePlan(plan, { explain: parsed.values.explain ?? false });
+    io.stdout.write(`${rendered}\n`);
+    return plan.ok ? TUBELESS_WORKBENCH_EXIT_CODE.success : TUBELESS_WORKBENCH_EXIT_CODE.planning;
+}
+//# sourceMappingURL=workbench-plan.js.map

package/dist/workbench-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbench-plan.js","sourceRoot":"","sources":["../src/workbench-plan.ts"],"names":[],"mappings":"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"}

package/dist/workbench-run.d.ts

@@ -0,0 +1,13 @@
+import type { CliContext } from "./cli.js";
+import type { PipelineContext } from "./pipeline.js";
+import type { WorkbenchPipelineCommand } from "./pipeline-module.js";
+import { type WorkbenchCliIo } from "./workbench-shared.js";
+export interface WorkbenchStructuredPipelineCommand extends WorkbenchPipelineCommand {
+    execute(values: Record<string, unknown>, context?: Partial<CliContext>): Promise<unknown>;
+    parseValues(values: Record<string, unknown>, context?: Partial<CliContext>): ReturnType<WorkbenchPipelineCommand["parse"]>;
+}
+export declare function executePipelineCommand(command: WorkbenchPipelineCommand, args: readonly string[], io: WorkbenchCliIo, signal: AbortSignal, pipelineContext?: Omit<PipelineContext, "cwd" | "log" | "signal">): Promise<number>;
+/** Execute already validated structured command values through the normal workbench errors. */
+export declare function executePipelineCommandValues(command: WorkbenchStructuredPipelineCommand, values: Record<string, unknown>, io: WorkbenchCliIo, signal: AbortSignal, pipelineContext?: Omit<PipelineContext, "cwd" | "log" | "signal">): Promise<number>;
+export declare function runCommand(argv: readonly string[], io: WorkbenchCliIo): Promise<number>;
+//# sourceMappingURL=workbench-run.d.ts.map

package/dist/workbench-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbench-run.d.ts","sourceRoot":"","sources":["../src/workbench-run.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAGrE,OAAO,EAWL,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,kCAAmC,SAAQ,wBAAwB;IAClF,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1F,WAAW,CACT,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAC5B,UAAU,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC,CAAC;CAClD;AAiCD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,wBAAwB,EACjC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,WAAW,EACnB,eAAe,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC,GAChE,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED,+FAA+F;AAC/F,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,kCAAkC,EAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,WAAW,EACnB,eAAe,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC,GAChE,OAAO,CAAC,MAAM,CAAC,CAQjB;AAsCD,wBAAsB,UAAU,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAkD7F"}

package/dist/workbench-run.js

@@ -0,0 +1,115 @@
+import * as path from "node:path";
+import { parseArgs } from "node:util";
+import { isAbortError } from "./abort.js";
+import { renderPipelineError } from "./render.js";
+import { commandContext, errorMessage, isCliHelpRequested, isCliValidationError, isPipelineExecutionError, loadPipelineCommand, manageWorkbenchSignal, TUBELESS_WORKBENCH_EXIT_CODE, toExitCode, writeUsageError, } from "./workbench-shared.js";
+const RUN_USAGE = `Usage: tubeless run [options] <command-file> [-- <command-args...>]
+
+Execute an exported definePipelineCommand using its own validated CLI contract.
+
+Options:
+  -e, --export <name>   Select a command export when the file has more than one
+      --store <path>    Append run events to a local SQLite database
+  -h, --help            Show this workbench help
+
+Pass application flags after --. For command help, use: tubeless run <file> -- --help
+`;
+function parseRunArgs(argv) {
+    const separatorIndex = argv.indexOf("--");
+    const workbenchArgs = separatorIndex === -1 ? argv : argv.slice(0, separatorIndex);
+    const commandArgs = separatorIndex === -1 ? [] : argv.slice(separatorIndex + 1);
+    return {
+        commandArgs,
+        parsed: parseArgs({
+            args: [...workbenchArgs],
+            allowPositionals: true,
+            options: {
+                export: { type: "string", short: "e" },
+                help: { type: "boolean", short: "h" },
+                store: { type: "string" },
+            },
+            strict: true,
+        }),
+    };
+}
+export async function executePipelineCommand(command, args, io, signal, pipelineContext) {
+    return executePipelineCommandOperation(async () => {
+        await command.run(args, commandContext(io, signal, pipelineContext));
+    }, io, signal);
+}
+/** Execute already validated structured command values through the normal workbench errors. */
+export async function executePipelineCommandValues(command, values, io, signal, pipelineContext) {
+    return executePipelineCommandOperation(async () => {
+        await command.execute(values, commandContext(io, signal, pipelineContext));
+    }, io, signal);
+}
+async function executePipelineCommandOperation(operation, io, signal) {
+    try {
+        await operation();
+        return signal.aborted
+            ? TUBELESS_WORKBENCH_EXIT_CODE.cancellation
+            : TUBELESS_WORKBENCH_EXIT_CODE.success;
+    }
+    catch (error) {
+        if (isCliHelpRequested(error)) {
+            io.stdout.write(`${error.helpText.replace(/\n+$/, "")}\n`);
+            return toExitCode(error);
+        }
+        if (isCliValidationError(error)) {
+            for (const validationError of error.errors) {
+                io.stderr.write(`Error: ${validationError}\n`);
+            }
+            io.stderr.write(`\n${error.helpText.replace(/\n+$/, "")}\n`);
+            return toExitCode(error);
+        }
+        if (isPipelineExecutionError(error)) {
+            for (const pipelineError of error.result.errors) {
+                io.stderr.write(`Error: ${renderPipelineError(pipelineError)}\n`);
+            }
+            return toExitCode(error);
+        }
+        if (signal.aborted && isAbortError(error)) {
+            return TUBELESS_WORKBENCH_EXIT_CODE.cancellation;
+        }
+        io.stderr.write(`Error: ${errorMessage(error)}\n`);
+        return toExitCode(error);
+    }
+}
+export async function runCommand(argv, io) {
+    let parsed;
+    try {
+        parsed = parseRunArgs(argv);
+    }
+    catch (error) {
+        return writeUsageError(io, `${errorMessage(error)} Application flags belong after --.`, RUN_USAGE);
+    }
+    if (parsed.parsed.values.help) {
+        io.stdout.write(RUN_USAGE);
+        return TUBELESS_WORKBENCH_EXIT_CODE.success;
+    }
+    if (parsed.parsed.positionals.length !== 1) {
+        return writeUsageError(io, "Pass exactly one pipeline command file.", RUN_USAGE);
+    }
+    const loaded = await loadPipelineCommand(parsed.parsed.positionals[0], parsed.parsed.values.export, io);
+    if ("exitCode" in loaded)
+        return loaded.exitCode;
+    const managedSignal = manageWorkbenchSignal(io);
+    let store;
+    try {
+        let pipelineContext;
+        if (parsed.parsed.values.store) {
+            const { openSqlitePipelineRunStore } = await import("./run-store-sqlite.js");
+            store = await openSqlitePipelineRunStore(path.resolve(io.cwd, parsed.parsed.values.store));
+            pipelineContext = { tracing: { exporter: store } };
+        }
+        const exitCode = await executePipelineCommand(loaded.command, parsed.commandArgs, io, managedSignal.signal, pipelineContext);
+        return exitCode === TUBELESS_WORKBENCH_EXIT_CODE.success && managedSignal.wasInterrupted()
+            ? TUBELESS_WORKBENCH_EXIT_CODE.cancellation
+            : exitCode;
+    }
+    finally {
+        await store?.close();
+        managedSignal.cleanup();
+    }
+}
+//# sourceMappingURL=workbench-run.js.map

package/dist/workbench-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbench-run.js","sourceRoot":"","sources":["../src/workbench-run.ts"],"names":[],"mappings":"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"}

package/dist/workbench-shared.d.ts

@@ -0,0 +1,67 @@
+import type { CliContext } from "./cli.js";
+import { type PipelineContext, type PipelineError } from "./pipeline.js";
+import { type WorkbenchPipeline, type WorkbenchPipelineCommand, type WorkbenchPlanSource } from "./pipeline-module.js";
+/** Stable shell exit codes for the workbench command family. */
+export declare const TUBELESS_WORKBENCH_EXIT_CODE: {
+    readonly success: 0;
+    readonly usage: 1;
+    readonly load: 2;
+    readonly definition: 3;
+    readonly validation: 4;
+    readonly planning: 5;
+    readonly execution: 6;
+    readonly cancellation: 7;
+};
+export interface WorkbenchCliIo {
+    cwd: string;
+    signal?: AbortSignal;
+    stderr: {
+        write(chunk: string): void;
+    };
+    stdout: {
+        write(chunk: string): void;
+    };
+}
+export declare function writeUsageError(io: WorkbenchCliIo, message: string, usage: string): number;
+export declare function isDefinitionError(error: unknown): boolean;
+export declare function errorMessage(error: unknown): string;
+export declare function errorName(error: unknown): string | undefined;
+export declare function isCliHelpRequested(error: unknown): error is {
+    helpText: string;
+};
+export declare function isCliValidationError(error: unknown): error is {
+    errors: readonly string[];
+    helpText: string;
+};
+export declare function isPipelineExecutionError(error: unknown): error is {
+    result: {
+        errors: PipelineError[];
+    };
+};
+/** Map a thrown CLI or pipeline error onto the workbench exit-code family. */
+export declare function toExitCode(error: unknown): number;
+export declare function loadPipeline(fileArgument: string, exportName: string | undefined, io: WorkbenchCliIo): Promise<{
+    pipeline: WorkbenchPipeline;
+} | {
+    exitCode: number;
+}>;
+export declare function loadPipelineCommand(fileArgument: string, exportName: string | undefined, io: WorkbenchCliIo): Promise<{
+    command: WorkbenchPipelineCommand;
+    exportName: string;
+} | {
+    exitCode: number;
+}>;
+export declare function loadPlanSource(fileArgument: string, exportName: string | undefined, io: WorkbenchCliIo): Promise<{
+    source: WorkbenchPlanSource;
+} | {
+    exitCode: number;
+}>;
+export declare function writeCommandLine(output: WorkbenchCliIo["stdout"] | WorkbenchCliIo["stderr"], message: string, ...optionalParams: string[]): void;
+export declare function commandContext(io: WorkbenchCliIo, signal: AbortSignal, pipelineContext?: Omit<PipelineContext, "cwd" | "log" | "signal">): Partial<CliContext>;
+export interface ManagedWorkbenchSignal {
+    cleanup(): void;
+    signal: AbortSignal;
+    wasInterrupted(): boolean;
+}
+export declare function manageWorkbenchSignal(io: WorkbenchCliIo): ManagedWorkbenchSignal;
+//# sourceMappingURL=workbench-shared.d.ts.map

package/dist/workbench-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbench-shared.d.ts","sourceRoot":"","sources":["../src/workbench-shared.ts"],"names":[],"mappings":"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"}

package/dist/workbench-shared.js

@@ -0,0 +1,163 @@
+import { stat } from "node:fs/promises";
+import * as path from "node:path";
+import { PipelineDefinitionError } from "./pipeline.js";
+import { loadPipelineCommandModuleWithName, loadPipelineModule, loadPlanSourceModule, } from "./pipeline-module.js";
+/** Stable shell exit codes for the workbench command family. */
+export const TUBELESS_WORKBENCH_EXIT_CODE = {
+    success: 0,
+    usage: 1,
+    load: 2,
+    definition: 3,
+    validation: 4,
+    planning: 5,
+    execution: 6,
+    cancellation: 7,
+};
+export function writeUsageError(io, message, usage) {
+    io.stderr.write(`Error: ${message}\n\n${usage}`);
+    return TUBELESS_WORKBENCH_EXIT_CODE.usage;
+}
+export function isDefinitionError(error) {
+    return (error instanceof PipelineDefinitionError ||
+        (error instanceof Error && error.name === "PipelineDefinitionError"));
+}
+export function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export function errorName(error) {
+    return typeof error === "object" && error !== null && "name" in error
+        ? String(error.name)
+        : undefined;
+}
+export function isCliHelpRequested(error) {
+    return (errorName(error) === "CliHelpRequested" &&
+        typeof error === "object" &&
+        error !== null &&
+        "helpText" in error &&
+        typeof error.helpText === "string");
+}
+export function isCliValidationError(error) {
+    return (errorName(error) === "CliValidationError" &&
+        typeof error === "object" &&
+        error !== null &&
+        "errors" in error &&
+        Array.isArray(error.errors) &&
+        "helpText" in error &&
+        typeof error.helpText === "string");
+}
+export function isPipelineExecutionError(error) {
+    return (errorName(error) === "PipelineExecutionError" &&
+        typeof error === "object" &&
+        error !== null &&
+        "result" in error &&
+        typeof error.result === "object" &&
+        error.result !== null &&
+        "errors" in error.result &&
+        Array.isArray(error.result.errors));
+}
+/** Map a thrown CLI or pipeline error onto the workbench exit-code family. */
+export function toExitCode(error) {
+    if (isCliHelpRequested(error))
+        return TUBELESS_WORKBENCH_EXIT_CODE.success;
+    if (isCliValidationError(error))
+        return TUBELESS_WORKBENCH_EXIT_CODE.validation;
+    if (isPipelineExecutionError(error)) {
+        const errors = error.result.errors;
+        if (errors.length > 0 && errors.every(({ kind }) => kind === "cancellation")) {
+            return TUBELESS_WORKBENCH_EXIT_CODE.cancellation;
+        }
+        if (errors.some(({ phase }) => phase === "planning")) {
+            return TUBELESS_WORKBENCH_EXIT_CODE.planning;
+        }
+        return TUBELESS_WORKBENCH_EXIT_CODE.execution;
+    }
+    return TUBELESS_WORKBENCH_EXIT_CODE.execution;
+}
+export async function loadPipeline(fileArgument, exportName, io) {
+    const filePath = path.resolve(io.cwd, fileArgument);
+    try {
+        const fileStat = await stat(filePath);
+        if (!fileStat.isFile())
+            throw new Error(`${filePath} is not a file.`);
+        return { pipeline: await loadPipelineModule(filePath, exportName) };
+    }
+    catch (error) {
+        const exitCode = isDefinitionError(error)
+            ? TUBELESS_WORKBENCH_EXIT_CODE.definition
+            : TUBELESS_WORKBENCH_EXIT_CODE.load;
+        io.stderr.write(`Error: ${errorMessage(error)}\n`);
+        return { exitCode };
+    }
+}
+export async function loadPipelineCommand(fileArgument, exportName, io) {
+    const filePath = path.resolve(io.cwd, fileArgument);
+    try {
+        const fileStat = await stat(filePath);
+        if (!fileStat.isFile())
+            throw new Error(`${filePath} is not a file.`);
+        return await loadPipelineCommandModuleWithName(filePath, exportName);
+    }
+    catch (error) {
+        const exitCode = isDefinitionError(error)
+            ? TUBELESS_WORKBENCH_EXIT_CODE.definition
+            : TUBELESS_WORKBENCH_EXIT_CODE.load;
+        io.stderr.write(`Error: ${errorMessage(error)}\n`);
+        return { exitCode };
+    }
+}
+export async function loadPlanSource(fileArgument, exportName, io) {
+    const filePath = path.resolve(io.cwd, fileArgument);
+    try {
+        const fileStat = await stat(filePath);
+        if (!fileStat.isFile())
+            throw new Error(`${filePath} is not a file.`);
+        return { source: await loadPlanSourceModule(filePath, exportName) };
+    }
+    catch (error) {
+        const exitCode = isDefinitionError(error)
+            ? TUBELESS_WORKBENCH_EXIT_CODE.definition
+            : TUBELESS_WORKBENCH_EXIT_CODE.load;
+        io.stderr.write(`Error: ${errorMessage(error)}\n`);
+        return { exitCode };
+    }
+}
+export function writeCommandLine(output, message, ...optionalParams) {
+    output.write(`${[message, ...optionalParams].join(" ")}\n`);
+}
+export function commandContext(io, signal, pipelineContext) {
+    const context = {
+        cwd: io.cwd,
+        log: {
+            error: (message, ...params) => writeCommandLine(io.stderr, String(message ?? ""), ...params.map((param) => String(param ?? ""))),
+            log: (message, ...params) => writeCommandLine(io.stdout, String(message ?? ""), ...params.map((param) => String(param ?? ""))),
+            warn: (message, ...params) => writeCommandLine(io.stderr, String(message ?? ""), ...params.map((param) => String(param ?? ""))),
+        },
+        signal,
+    };
+    if (pipelineContext)
+        context.pipelineContext = pipelineContext;
+    return context;
+}
+export function manageWorkbenchSignal(io) {
+    if (io.signal) {
+        return {
+            cleanup: () => { },
+            signal: io.signal,
+            wasInterrupted: () => io.signal?.aborted === true,
+        };
+    }
+    const controller = new AbortController();
+    let interrupted = false;
+    const onSigint = () => {
+        interrupted = true;
+        io.stderr.write("SIGINT received; cancelling pipeline work.\n");
+        controller.abort();
+    };
+    process.once("SIGINT", onSigint);
+    return {
+        cleanup: () => process.removeListener("SIGINT", onSigint),
+        signal: controller.signal,
+        wasInterrupted: () => interrupted,
+    };
+}
+//# sourceMappingURL=workbench-shared.js.map

package/dist/workbench-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbench-shared.js","sourceRoot":"","sources":["../src/workbench-shared.ts"],"names":[],"mappings":"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"}

package/dist/workbench-studio.d.ts

@@ -0,0 +1,26 @@
+/** Current version of the declarative local-studio configuration contract. */
+export declare const PIPELINE_STUDIO_CONFIG_VERSION: 1;
+export interface PipelineStudioCommandModule {
+    /** Command module path, resolved relative to the studio configuration file. */
+    file: string;
+    /** Select a named definePipelineCommand export when the module has more than one. */
+    export?: string;
+    /** Optional display-name override. Defaults to the command's generated name. */
+    name?: string;
+}
+export interface PipelineStudioConfigInput {
+    /** Explicitly registered definePipelineCommand modules. */
+    commands: readonly PipelineStudioCommandModule[];
+    /** Command execution directory, relative to this file. Defaults to this file's directory. */
+    cwd?: string;
+}
+export interface PipelineStudioConfig {
+    readonly commands: readonly PipelineStudioCommandModule[];
+    readonly cwd?: string;
+    readonly version: typeof PIPELINE_STUDIO_CONFIG_VERSION;
+}
+/** Declare a versioned, dependency-free manifest of commands available to `tubeless ui`. */
+export declare function definePipelineStudio(config: PipelineStudioConfigInput): PipelineStudioConfig;
+/** Runtime guard used by the workbench when selecting an exported studio config. */
+export declare function isPipelineStudioConfig(value: unknown): value is PipelineStudioConfig;
+//# sourceMappingURL=workbench-studio.d.ts.map

package/dist/workbench-studio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbench-studio.d.ts","sourceRoot":"","sources":["../src/workbench-studio.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,eAAO,MAAM,8BAA8B,EAAG,CAAU,CAAC;AAIzD,MAAM,WAAW,2BAA2B;IAC1C,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,2DAA2D;IAC3D,QAAQ,EAAE,SAAS,2BAA2B,EAAE,CAAC;IACjD,6FAA6F;IAC7F,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,2BAA2B,EAAE,CAAC;IAC1D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,8BAA8B,CAAC;CACzD;AAeD,4FAA4F;AAC5F,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,yBAAyB,GAAG,oBAAoB,CAmC5F;AAED,oFAAoF;AACpF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAOpF"}

package/dist/workbench-studio.js

@@ -0,0 +1,57 @@
+/** Current version of the declarative local-studio configuration contract. */
+export const PIPELINE_STUDIO_CONFIG_VERSION = 1;
+const PIPELINE_STUDIO_CONFIG_MARKER = Symbol.for("tubeless/pipeline-studio-config/v1");
+function requiredText(value, label) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new Error(`${label} must be a non-empty string.`);
+    }
+}
+/** Declare a versioned, dependency-free manifest of commands available to `tubeless ui`. */
+export function definePipelineStudio(config) {
+    if (!Array.isArray(config.commands) || config.commands.length === 0) {
+        throw new Error("Pipeline studio config must declare at least one command.");
+    }
+    if (config.cwd !== undefined)
+        requiredText(config.cwd, "Pipeline studio cwd");
+    const identities = new Set();
+    const commands = config.commands.map((command, index) => {
+        requiredText(command.file, `Pipeline studio command ${index + 1} file`);
+        if (command.export !== undefined) {
+            requiredText(command.export, `Pipeline studio command ${index + 1} export`);
+        }
+        if (command.name !== undefined) {
+            requiredText(command.name, `Pipeline studio command ${index + 1} name`);
+        }
+        const identity = `${command.file}\0${command.export ?? ""}`;
+        if (identities.has(identity)) {
+            throw new Error(`Pipeline studio command ${JSON.stringify(command.file)}${command.export ? ` export ${JSON.stringify(command.export)}` : ""} is declared more than once.`);
+        }
+        identities.add(identity);
+        const frozenCommand = { file: command.file };
+        if (command.export !== undefined)
+            frozenCommand.export = command.export;
+        if (command.name !== undefined)
+            frozenCommand.name = command.name;
+        return Object.freeze(frozenCommand);
+    });
+    const defined = {
+        commands: Object.freeze(commands),
+        version: PIPELINE_STUDIO_CONFIG_VERSION,
+    };
+    if (config.cwd !== undefined)
+        defined.cwd = config.cwd;
+    Object.defineProperty(defined, PIPELINE_STUDIO_CONFIG_MARKER, { value: true });
+    return Object.freeze(defined);
+}
+/** Runtime guard used by the workbench when selecting an exported studio config. */
+export function isPipelineStudioConfig(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    if (!(PIPELINE_STUDIO_CONFIG_MARKER in value))
+        return false;
+    // SAFETY: The marker is only installed by definePipelineStudio, which sets version and
+    // commands to their declared types, so reading them via a structural view is safe.
+    const candidate = value;
+    return candidate.version === PIPELINE_STUDIO_CONFIG_VERSION && Array.isArray(candidate.commands);
+}
+//# sourceMappingURL=workbench-studio.js.map

package/dist/workbench-studio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbench-studio.js","sourceRoot":"","sources":["../src/workbench-studio.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAU,CAAC;AAEzD,MAAM,6BAA6B,GAAG,MAAM,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;AA+BvF,SAAS,YAAY,CAAC,KAAc,EAAE,KAAa;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,8BAA8B,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,oBAAoB,CAAC,MAAiC;IACpE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS;QAAE,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;IAE9E,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAA+B,EAAE;QACnF,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,2BAA2B,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC;QACxE,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,2BAA2B,KAAK,GAAG,CAAC,SAAS,CAAC,CAAC;QAC9E,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,2BAA2B,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,QAAQ,GAAG,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QAC5D,IAAI,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,2BAA2B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,8BAA8B,CAC1J,CAAC;QACJ,CAAC;QACD,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzB,MAAM,aAAa,GAAgC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;QAC1E,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,aAAa,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QACxE,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,aAAa,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAClE,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAwB;QACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;QACjC,OAAO,EAAE,8BAA8B;KACxC,CAAC;IACF,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS;QAAE,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IACvD,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,6BAA6B,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/E,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,CAAC,CAAC,6BAA6B,IAAI,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5D,uFAAuF;IACvF,mFAAmF;IACnF,MAAM,SAAS,GAAG,KAAkD,CAAC;IACrE,OAAO,SAAS,CAAC,OAAO,KAAK,8BAA8B,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AACnG,CAAC"}

package/dist/workbench-ui.d.ts

@@ -0,0 +1,3 @@
+import { type WorkbenchCliIo } from "./workbench-shared.js";
+export declare function runUi(argv: readonly string[], io: WorkbenchCliIo): Promise<number>;
+//# sourceMappingURL=workbench-ui.d.ts.map

package/dist/workbench-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbench-ui.d.ts","sourceRoot":"","sources":["../src/workbench-ui.ts"],"names":[],"mappings":"AAWA,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAiF/B,wBAAsB,KAAK,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAiOxF"}