tubeless 0.1.0

package/dist/paths.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1D,aAAa,EAAE,CAAC,GACf,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,CAWpB"}

package/dist/paths.js

@@ -0,0 +1,19 @@
+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/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/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"}

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

@@ -0,0 +1,5 @@
+/** Mark only commands created by definePipelineCommand as workbench-executable. */
+export declare function markPipelineCommand<T extends object>(command: T): T;
+/** Recognize a pipeline command across duplicate package instances in a loaded module. */
+export declare function isMarkedPipelineCommand(value: unknown): boolean;
+//# sourceMappingURL=pipeline-command-marker.d.ts.map

package/dist/pipeline-command-marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-command-marker.d.ts","sourceRoot":"","sources":["../src/pipeline-command-marker.ts"],"names":[],"mappings":"AAEA,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAQnE;AAED,0FAA0F;AAC1F,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAS/D"}

package/dist/pipeline-command-marker.js

@@ -0,0 +1,21 @@
+const PIPELINE_COMMAND_MARKER = Symbol.for("tubeless/pipeline-command");
+/** Mark only commands created by definePipelineCommand as workbench-executable. */
+export function markPipelineCommand(command) {
+    Object.defineProperty(command, PIPELINE_COMMAND_MARKER, {
+        configurable: false,
+        enumerable: false,
+        value: true,
+        writable: false,
+    });
+    return command;
+}
+/** Recognize a pipeline command across duplicate package instances in a loaded module. */
+export function isMarkedPipelineCommand(value) {
+    return ((typeof value === "object" || typeof value === "function") &&
+        value !== null &&
+        // SAFETY: value is a non-null object/function here, so symbol-keyed property
+        // access never throws. The marker is only ever written as the literal `true`
+        // by markPipelineCommand, so a strict `=== true` comparison is reliable.
+        value[PIPELINE_COMMAND_MARKER] === true);
+}
+//# sourceMappingURL=pipeline-command-marker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-command-marker.js","sourceRoot":"","sources":["../src/pipeline-command-marker.ts"],"names":[],"mappings":"AAAA,MAAM,uBAAuB,GAAG,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;AAExE,mFAAmF;AACnF,MAAM,UAAU,mBAAmB,CAAmB,OAAU;IAC9D,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,uBAAuB,EAAE;QACtD,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,KAAK;QACjB,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,OAAO,CACL,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC;QAC1D,KAAK,KAAK,IAAI;QACd,6EAA6E;QAC7E,6EAA6E;QAC7E,yEAAyE;QACxE,KAAiD,CAAC,uBAAuB,CAAC,KAAK,IAAI,CACrF,CAAC;AACJ,CAAC"}

package/dist/pipeline-diagnostics.d.ts

@@ -0,0 +1,4 @@
+import type { PipelineError } from "./pipeline.js";
+/** One-line human format used by kernel exceptions and shared renderers. */
+export declare function formatPipelineError(error: PipelineError): string;
+//# sourceMappingURL=pipeline-diagnostics.d.ts.map

package/dist/pipeline-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-diagnostics.d.ts","sourceRoot":"","sources":["../src/pipeline-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,eAAe,CAAC;AAUvE,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAQhE"}

package/dist/pipeline-diagnostics.js

@@ -0,0 +1,17 @@
+function deepestPipelineCause(cause) {
+    let current = cause;
+    while (current?.cause)
+        current = current.cause;
+    return current;
+}
+/** One-line human format used by kernel exceptions and shared renderers. */
+export function formatPipelineError(error) {
+    const step = error.stepId ? ` at step ${error.stepId}` : "";
+    const sourceCode = error.sourceCode ? ` (${error.sourceCode})` : "";
+    const deepestCause = deepestPipelineCause(error.cause);
+    const cause = deepestCause
+        ? `; caused by${deepestCause.sourceCode ? ` ${deepestCause.sourceCode}` : ""}: ${deepestCause.message}`
+        : "";
+    return `${error.phase}${step} [${error.code}]${sourceCode}: ${error.message}${cause}`;
+}
+//# sourceMappingURL=pipeline-diagnostics.js.map

package/dist/pipeline-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-diagnostics.js","sourceRoot":"","sources":["../src/pipeline-diagnostics.ts"],"names":[],"mappings":"AAEA,SAAS,oBAAoB,CAC3B,KAAqC;IAErC,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,OAAO,OAAO,EAAE,KAAK;QAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC;IAC/C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,mBAAmB,CAAC,KAAoB;IACtD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,MAAM,YAAY,GAAG,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,YAAY;QACxB,CAAC,CAAC,cAAc,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,YAAY,CAAC,OAAO,EAAE;QACvG,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,GAAG,KAAK,CAAC,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,UAAU,KAAK,KAAK,CAAC,OAAO,GAAG,KAAK,EAAE,CAAC;AACxF,CAAC"}

package/dist/pipeline-module.d.ts

@@ -0,0 +1,62 @@
+import type { CliCommandDescriptor, CliContext, PipelineCommandPlanInput } from "./cli.js";
+import type { PipelineMermaidOptions, PipelinePlan, PipelineRunControls } from "./pipeline.js";
+/** Runtime surface required by the workbench's non-executing pipeline commands. */
+export interface WorkbenchPipeline {
+    readonly id: string;
+    readonly stepIds: readonly string[];
+    readonly targetIds: readonly string[];
+    plan(controls?: PipelineRunControls): PipelinePlan;
+    toMermaid(options?: PipelineMermaidOptions): string;
+}
+/** Runtime surface exposed only by commands created with definePipelineCommand. */
+export type WorkbenchPipelineCommandParseResult = {
+    kind: "values";
+    values: Record<string, unknown>;
+} | {
+    kind: "help";
+    helpText: string;
+} | {
+    kind: "error";
+    errors: readonly string[];
+    helpText: string;
+};
+export interface WorkbenchPipelineCommand {
+    readonly descriptor: CliCommandDescriptor;
+    parse(argv?: readonly string[], context?: Partial<CliContext>): WorkbenchPipelineCommandParseResult;
+    plan(input?: PipelineCommandPlanInput): PipelinePlan;
+    run(argv?: readonly string[], context?: Partial<CliContext>): Promise<unknown>;
+}
+/** Runtime surface accepted by `tubeless plan`: a pipeline or a marked command. */
+export type WorkbenchPlanSource = {
+    kind: "command";
+    command: WorkbenchPipelineCommand;
+} | {
+    kind: "pipeline";
+    pipeline: WorkbenchPipeline;
+};
+/** Select one real pipeline from a loaded module, deduplicating export aliases. */
+export declare function selectPipelineExport(moduleExports: Record<string, unknown>, exportName?: string): WorkbenchPipeline;
+/** Select one definePipelineCommand export, deduplicating export aliases. */
+export declare function selectPipelineCommandExport(moduleExports: Record<string, unknown>, exportName?: string): WorkbenchPipelineCommand;
+/** Select one command and retain the stable name of the export that selected it. */
+export declare function selectPipelineCommandExportWithName(moduleExports: Record<string, unknown>, exportName?: string): {
+    command: WorkbenchPipelineCommand;
+    exportName: string;
+};
+/**
+ * Select a plan source. A marked command wins when the module also exports a
+ * pipeline. Named exports still have to be a pipeline or a marked command.
+ */
+export declare function selectPlanSourceExport(moduleExports: Record<string, unknown>, exportName?: string): WorkbenchPlanSource;
+/** Load and select a pipeline from an absolute module path. */
+export declare function loadPipelineModule(filePath: string, exportName?: string): Promise<WorkbenchPipeline>;
+/** Load and select a pipeline command from an absolute module path. */
+export declare function loadPipelineCommandModule(filePath: string, exportName?: string): Promise<WorkbenchPipelineCommand>;
+/** Load a command and its export name for a stable external registration identity. */
+export declare function loadPipelineCommandModuleWithName(filePath: string, exportName?: string): Promise<{
+    command: WorkbenchPipelineCommand;
+    exportName: string;
+}>;
+/** Load a marked command when present, otherwise a pipeline, for `tubeless plan`. */
+export declare function loadPlanSourceModule(filePath: string, exportName?: string): Promise<WorkbenchPlanSource>;
+//# sourceMappingURL=pipeline-module.d.ts.map

package/dist/pipeline-module.d.ts.map

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

package/dist/pipeline-module.js

@@ -0,0 +1,157 @@
+import { pathToFileURL } from "node:url";
+import { isMarkedPipelineCommand } from "./pipeline-command-marker.js";
+function isWorkbenchPipeline(value) {
+    return ((typeof value === "object" || typeof value === "function") &&
+        value !== null &&
+        "id" in value &&
+        typeof value.id === "string" &&
+        "stepIds" in value &&
+        Array.isArray(value.stepIds) &&
+        "targetIds" in value &&
+        Array.isArray(value.targetIds) &&
+        "plan" in value &&
+        typeof value.plan === "function" &&
+        "toMermaid" in value &&
+        typeof value.toMermaid === "function");
+}
+function isWorkbenchPipelineCommand(value) {
+    if (!isMarkedPipelineCommand(value))
+        return false;
+    // SAFETY: isMarkedPipelineCommand established value is a non-null object or
+    // function, so this single cast only widens to a shape we probe with `in`.
+    const candidate = value;
+    return ("descriptor" in candidate &&
+        typeof candidate.descriptor === "object" &&
+        candidate.descriptor !== null &&
+        "plan" in candidate &&
+        typeof candidate.plan === "function" &&
+        "parse" in candidate &&
+        typeof candidate.parse === "function" &&
+        "run" in candidate &&
+        typeof candidate.run === "function");
+}
+function selectUniqueExport(moduleExports, exportName, predicate, label) {
+    if (exportName !== undefined) {
+        if (!Object.prototype.hasOwnProperty.call(moduleExports, exportName)) {
+            throw new Error(`Module does not export ${JSON.stringify(exportName)}.`);
+        }
+        const selected = moduleExports[exportName];
+        if (!predicate(selected)) {
+            throw new Error(`Export ${JSON.stringify(exportName)} is not an tubeless ${label}.`);
+        }
+        return selected;
+    }
+    const candidates = Object.entries(moduleExports).filter((entry) => predicate(entry[1]));
+    const unique = candidates.filter(([, value], index) => candidates.findIndex(([, other]) => other === value) === index);
+    if (unique.length === 0) {
+        throw new Error(`Module does not export an tubeless ${label}.`);
+    }
+    if (unique.length > 1) {
+        throw new Error(`Module exports multiple ${label}s (${unique.map(([name]) => name).join(", ")}); pass --export <name>.`);
+    }
+    return unique[0][1];
+}
+/** Select one real pipeline from a loaded module, deduplicating export aliases. */
+export function selectPipelineExport(moduleExports, exportName) {
+    return selectUniqueExport(moduleExports, exportName, isWorkbenchPipeline, "pipeline");
+}
+/** Select one definePipelineCommand export, deduplicating export aliases. */
+export function selectPipelineCommandExport(moduleExports, exportName) {
+    return selectPipelineCommandExportWithName(moduleExports, exportName).command;
+}
+/** Select one command and retain the stable name of the export that selected it. */
+export function selectPipelineCommandExportWithName(moduleExports, exportName) {
+    if (exportName !== undefined) {
+        if (!Object.prototype.hasOwnProperty.call(moduleExports, exportName)) {
+            throw new Error(`Module does not export ${JSON.stringify(exportName)}.`);
+        }
+        const selected = moduleExports[exportName];
+        if (!isWorkbenchPipelineCommand(selected)) {
+            throw new Error(`Export ${JSON.stringify(exportName)} is not an tubeless pipeline command.`);
+        }
+        return { command: selected, exportName };
+    }
+    const candidates = uniqueNamedExports(moduleExports, isWorkbenchPipelineCommand);
+    if (candidates.length === 0) {
+        throw new Error("Module does not export an tubeless pipeline command.");
+    }
+    if (candidates.length > 1) {
+        throw new Error(`Module exports multiple pipeline commands (${candidates.map(([name]) => name).join(", ")}); pass --export <name>.`);
+    }
+    return { command: candidates[0][1], exportName: candidates[0][0] };
+}
+function uniqueNamedExports(moduleExports, predicate) {
+    const candidates = Object.entries(moduleExports).filter((entry) => predicate(entry[1]));
+    return candidates.filter(([, value], index) => candidates.findIndex(([, other]) => other === value) === index);
+}
+/**
+ * Select a plan source. A marked command wins when the module also exports a
+ * pipeline. Named exports still have to be a pipeline or a marked command.
+ */
+export function selectPlanSourceExport(moduleExports, exportName) {
+    if (exportName !== undefined) {
+        if (!Object.prototype.hasOwnProperty.call(moduleExports, exportName)) {
+            throw new Error(`Module does not export ${JSON.stringify(exportName)}.`);
+        }
+        const selected = moduleExports[exportName];
+        if (isWorkbenchPipelineCommand(selected)) {
+            return { kind: "command", command: selected };
+        }
+        if (isWorkbenchPipeline(selected)) {
+            return { kind: "pipeline", pipeline: selected };
+        }
+        throw new Error(`Export ${JSON.stringify(exportName)} is not an tubeless pipeline or pipeline command.`);
+    }
+    const commands = uniqueNamedExports(moduleExports, isWorkbenchPipelineCommand);
+    if (commands.length === 1) {
+        return { kind: "command", command: commands[0][1] };
+    }
+    if (commands.length > 1) {
+        throw new Error(`Module exports multiple pipeline commands (${commands.map(([name]) => name).join(", ")}); pass --export <name>.`);
+    }
+    const pipelines = uniqueNamedExports(moduleExports, isWorkbenchPipeline);
+    if (pipelines.length === 1) {
+        return { kind: "pipeline", pipeline: pipelines[0][1] };
+    }
+    if (pipelines.length > 1) {
+        throw new Error(`Module exports multiple pipelines (${pipelines.map(([name]) => name).join(", ")}); pass --export <name>.`);
+    }
+    throw new Error("Module does not export an tubeless pipeline or pipeline command.");
+}
+/** Load and select a pipeline from an absolute module path. */
+export async function loadPipelineModule(filePath, exportName) {
+    // SAFETY: a dynamic import of a JS/TS module always yields a module namespace
+    // object whose exports are string-keyed values, so the cast to
+    // Record<string, unknown> documents the import result's shape; selectors
+    // validate each export at runtime before use.
+    const moduleExports = (await import(pathToFileURL(filePath).href));
+    return selectPipelineExport(moduleExports, exportName);
+}
+/** Load and select a pipeline command from an absolute module path. */
+export async function loadPipelineCommandModule(filePath, exportName) {
+    // SAFETY: a dynamic import of a JS/TS module always yields a module namespace
+    // object whose exports are string-keyed values, so the cast to
+    // Record<string, unknown> documents the import result's shape; selectors
+    // validate each export at runtime before use.
+    const moduleExports = (await import(pathToFileURL(filePath).href));
+    return selectPipelineCommandExport(moduleExports, exportName);
+}
+/** Load a command and its export name for a stable external registration identity. */
+export async function loadPipelineCommandModuleWithName(filePath, exportName) {
+    // SAFETY: a dynamic import of a JS/TS module always yields a module namespace
+    // object whose exports are string-keyed values, so the cast to
+    // Record<string, unknown> documents the import result's shape; selectors
+    // validate each export at runtime before use.
+    const moduleExports = (await import(pathToFileURL(filePath).href));
+    return selectPipelineCommandExportWithName(moduleExports, exportName);
+}
+/** Load a marked command when present, otherwise a pipeline, for `tubeless plan`. */
+export async function loadPlanSourceModule(filePath, exportName) {
+    // SAFETY: a dynamic import of a JS/TS module always yields a module namespace
+    // object whose exports are string-keyed values, so the cast to
+    // Record<string, unknown> documents the import result's shape; selectors
+    // validate each export at runtime before use.
+    const moduleExports = (await import(pathToFileURL(filePath).href));
+    return selectPlanSourceExport(moduleExports, exportName);
+}
+//# sourceMappingURL=pipeline-module.js.map

package/dist/pipeline-module.js.map

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