@cat-indev/catops-cli 0.0.1-alpha.10

package/dist/services/oc.d.ts

@@ -0,0 +1,156 @@
+import type { ExecOptions, ExecResult } from "../core/types";
+export interface OcOptions {
+    /** Ruta al archivo kubeconfig. Se pasa como --kubeconfig <path>. */
+    kubeconfig?: string;
+    /** Namespace/proyecto destino. Se pasa como -n <namespace>. */
+    namespace?: string;
+    /** retry/timeout/dryRun para esta llamada puntual (ver shell.exec). */
+    exec?: ExecOptions;
+}
+export interface OcLoginOptions extends OcOptions {
+    server: string;
+    token?: string;
+    username?: string;
+    password?: string;
+    insecureSkipTlsVerify?: boolean;
+}
+export interface OcStartBuildOptions extends OcOptions {
+    follow?: boolean;
+}
+/**
+ * Ejemplo — 10 reintentos ante un login inestable:
+ *   await ctx.services.oc.login({
+ *       server: "https://api.cluster:6443",
+ *       token: process.env.OC_TOKEN,
+ *       exec: { retry: 10, retryDelay: 2000 }
+ *   });
+ */
+export declare function login({ server, token, username, password, insecureSkipTlsVerify, ...options }: OcLoginOptions): Promise<ExecResult>;
+export declare function project(name: string, options?: OcOptions): Promise<ExecResult>;
+export declare function apply(file: string, options?: OcOptions): Promise<ExecResult>;
+/**
+ * Igual que antes (`oc.get("pods", "-o", "wide")`), pero ahora también
+ * acepta OcOptions como último argumento:
+ *   oc.get("pods", "-o", "wide", { namespace: "prod", exec: { retry: 3 } })
+ */
+export declare function get(...rawArgs: Array<string | OcOptions>): Promise<ExecResult>;
+export declare function rollout(deployment: string, options?: OcOptions): Promise<ExecResult>;
+export declare function newApp(...args: string[]): Promise<ExecResult>;
+export declare function startBuild(buildConfig: string, { follow, ...options }?: OcStartBuildOptions): Promise<ExecResult>;
+export declare function logs(pod: string, options?: OcOptions): Promise<ExecResult>;
+export type DeploymentRolloutStatus = "success" | "failed" | "timeout";
+export interface DeploymentWatchResult {
+    status: DeploymentRolloutStatus;
+    deployment: string;
+    elapsedMs: number;
+    restarts: number;
+    message: string;
+}
+/**
+ * Se lanza cuando `waitForDeployment` no llega a un rollout exitoso. Lleva
+ * `command: "oc"` para que `classifiers.byCommand({ oc: "kubernetes" })`
+ * lo clasifique automáticamente si usas el sistema de notificaciones.
+ */
+export declare class DeploymentRolloutError extends Error {
+    readonly command = "oc";
+    readonly status: DeploymentRolloutStatus;
+    readonly deployment: string;
+    readonly elapsedMs: number;
+    readonly restarts: number;
+    constructor(message: string, info: Omit<DeploymentWatchResult, "message">);
+}
+export interface WaitForDeploymentOptions extends OcOptions {
+    /** Nombre del deployment/deploymentconfig, sin prefijo de recurso. */
+    deployment: string;
+    /** "deployment" (k8s nativo, default) o "dc" (DeploymentConfig clásico de OpenShift). */
+    resourceType?: "deployment" | "dc";
+    /** Milisegundos totales antes de abortar y reportar error. Default: 300000 (5 min). */
+    timeout?: number;
+    /** Milisegundos entre cada chequeo. Default: 5000. */
+    pollInterval?: number;
+    /**
+     * Si el recurso entra en estado Failed, milisegundos a esperar para ver
+     * si se recupera solo antes de darlo por fallido. Default: `pollInterval * 6`.
+     */
+    failedGracePeriod?: number;
+    /**
+     * Máximo de reinicios (sumados entre todos los pods/containers) tolerados
+     * antes de abortar inmediatamente. Si no se pasa, no se valida.
+     */
+    maxRestarts?: number;
+}
+/**
+ * Valida cíclicamente el estado de un Deployment/DeploymentConfig hasta que:
+ *   - llega a estado exitoso (replicas listas/actualizadas == replicas deseadas) -> resuelve,
+ *   - supera `maxRestarts` reinicios acumulados -> lanza DeploymentRolloutError,
+ *   - se queda en estado Failed más de `failedGracePeriod` sin recuperarse -> lanza DeploymentRolloutError,
+ *   - o se cumple `timeout` sin éxito -> lanza DeploymentRolloutError.
+ *
+ * El polling se detiene ("se mata el proceso") apenas se detecta cualquiera
+ * de las condiciones de fallo, re-lanzando el error para que `ctx.run(...)`
+ * lo capture y lo reporte vía `ctx.notifier` si lo tienes configurado.
+ */
+export declare function waitForDeployment(options: WaitForDeploymentOptions): Promise<DeploymentWatchResult>;
+export type DeploymentGroupStatus = "success" | "failed" | "timeout";
+export interface DeploymentGroupFailure {
+    deployment: string;
+    status: DeploymentRolloutStatus;
+    message: string;
+}
+export interface DeploymentGroupWatchResult {
+    status: "success";
+    label: string;
+    elapsedMs: number;
+    deployments: DeploymentWatchResult[];
+    message: string;
+}
+/**
+ * Se lanza cuando `waitForDeploymentGroup` no logra que TODAS las instancias
+ * del grupo lleguen a estado exitoso. Lleva `command: "oc"` para que
+ * `classifiers.byCommand({ oc: "kubernetes" })` lo clasifique solo.
+ */
+export declare class DeploymentGroupRolloutError extends Error {
+    readonly command = "oc";
+    readonly label: string;
+    readonly elapsedMs: number;
+    readonly succeeded: string[];
+    readonly failed: DeploymentGroupFailure[];
+    constructor(message: string, info: {
+        label: string;
+        elapsedMs: number;
+        succeeded: string[];
+        failed: DeploymentGroupFailure[];
+    });
+}
+export interface WaitForDeploymentGroupOptions extends OcOptions {
+    /**
+     * Label que agrupa todas las instancias del despliegue. Puede ser el
+     * selector ya armado ("deployment-group=repository-14") o un objeto
+     * ({ "deployment-group": "repository-14" }).
+     */
+    label: string | Record<string, string>;
+    /** "deployment" (k8s nativo, default) o "dc" (DeploymentConfig clásico de OpenShift). */
+    resourceType?: "deployment" | "dc";
+    /** Milisegundos totales antes de abortar el grupo entero. Default: 300000 (5 min). */
+    timeout?: number;
+    /** Milisegundos entre cada chequeo, por instancia. Default: 5000. */
+    pollInterval?: number;
+    /** Igual que en waitForDeployment, aplicado a cada instancia del grupo. */
+    failedGracePeriod?: number;
+    /** Igual que en waitForDeployment, aplicado a cada instancia del grupo. */
+    maxRestarts?: number;
+}
+/**
+ * Descubre todos los Deployments/DeploymentConfigs que compartan el `label`
+ * dado (p. ej. todas las instancias GitOps de un mismo repo, marcadas con
+ * `deployment-group: repository-14`) y espera a que TODAS lleguen a estado
+ * exitoso, corriendo `waitForDeployment` por cada una en paralelo con el
+ * mismo `timeout` global.
+ *
+ * Si alguna instancia falla (timeout individual, Failed sin recuperarse, o
+ * maxRestarts superado), se espera a que terminen las demás y se lanza
+ * `DeploymentGroupRolloutError` con el detalle de cuáles fallaron y cuáles sí
+ * llegaron a estado exitoso — listo para que `ctx.run(...)` lo capture y lo
+ * reporte vía `ctx.notifier`.
+ */
+export declare function waitForDeploymentGroup(options: WaitForDeploymentGroupOptions): Promise<DeploymentGroupWatchResult>;

package/dist/services/oc.js

@@ -0,0 +1,309 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeploymentGroupRolloutError = exports.DeploymentRolloutError = void 0;
+exports.login = login;
+exports.project = project;
+exports.apply = apply;
+exports.get = get;
+exports.rollout = rollout;
+exports.newApp = newApp;
+exports.startBuild = startBuild;
+exports.logs = logs;
+exports.waitForDeployment = waitForDeployment;
+exports.waitForDeploymentGroup = waitForDeploymentGroup;
+const shell_1 = require("./shell");
+function isOcOptions(value) {
+    return Boolean(value)
+        && typeof value === "object"
+        && !Array.isArray(value)
+        && ("kubeconfig" in value || "namespace" in value || "exec" in value || Object.keys(value).length === 0);
+}
+function withGlobalFlags(args, options = {}) {
+    const result = [...args];
+    if (options.kubeconfig) {
+        result.push("--kubeconfig", options.kubeconfig);
+    }
+    if (options.namespace) {
+        result.push("-n", options.namespace);
+    }
+    return result;
+}
+/** Arma los args finales para shell.exec: flags (--kubeconfig/-n) + el objeto exec al final, si se pasó. */
+function toExecArgs(args, options = {}) {
+    const withFlags = withGlobalFlags(args, options);
+    return options.exec ? [...withFlags, options.exec] : withFlags;
+}
+/**
+ * Ejemplo — 10 reintentos ante un login inestable:
+ *   await ctx.services.oc.login({
+ *       server: "https://api.cluster:6443",
+ *       token: process.env.OC_TOKEN,
+ *       exec: { retry: 10, retryDelay: 2000 }
+ *   });
+ */
+function login({ server, token, username, password, insecureSkipTlsVerify = false, ...options }) {
+    const args = ["login", server];
+    if (token) {
+        args.push("--token", token);
+    }
+    else {
+        args.push("-u", username ?? "", "-p", password ?? "");
+    }
+    if (insecureSkipTlsVerify) {
+        args.push("--insecure-skip-tls-verify");
+    }
+    return shell_1.shell.exec("oc", ...toExecArgs(args, options));
+}
+function project(name, options = {}) {
+    return shell_1.shell.exec("oc", ...toExecArgs(["project", name], options));
+}
+function apply(file, options = {}) {
+    return shell_1.shell.exec("oc", ...toExecArgs(["apply", "-f", file], options));
+}
+/**
+ * Igual que antes (`oc.get("pods", "-o", "wide")`), pero ahora también
+ * acepta OcOptions como último argumento:
+ *   oc.get("pods", "-o", "wide", { namespace: "prod", exec: { retry: 3 } })
+ */
+function get(...rawArgs) {
+    let args = rawArgs;
+    let options = {};
+    const last = rawArgs[rawArgs.length - 1];
+    if (rawArgs.length && isOcOptions(last)) {
+        options = last;
+        args = rawArgs.slice(0, -1);
+    }
+    return shell_1.shell.exec("oc", "get", ...toExecArgs(args, options));
+}
+function rollout(deployment, options = {}) {
+    return shell_1.shell.exec("oc", ...toExecArgs(["rollout", "status", `dc/${deployment}`], options));
+}
+function newApp(...args) {
+    return shell_1.shell.exec("oc", "new-app", ...args);
+}
+function startBuild(buildConfig, { follow = true, ...options } = {}) {
+    const args = ["start-build", buildConfig];
+    if (follow) {
+        args.push("-F");
+    }
+    return shell_1.shell.exec("oc", ...toExecArgs(args, options));
+}
+function logs(pod, options = {}) {
+    return shell_1.shell.exec("oc", ...toExecArgs(["logs", pod], options));
+}
+// ---------------------------------------------------------------------------
+// waitForDeployment — validación cíclica del rollout, para Deployment (k8s
+// nativo) o DeploymentConfig (OpenShift clásico).
+// ---------------------------------------------------------------------------
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Se lanza cuando `waitForDeployment` no llega a un rollout exitoso. Lleva
+ * `command: "oc"` para que `classifiers.byCommand({ oc: "kubernetes" })`
+ * lo clasifique automáticamente si usas el sistema de notificaciones.
+ */
+class DeploymentRolloutError extends Error {
+    constructor(message, info) {
+        super(message);
+        this.command = "oc";
+        this.name = "DeploymentRolloutError";
+        this.status = info.status;
+        this.deployment = info.deployment;
+        this.elapsedMs = info.elapsedMs;
+        this.restarts = info.restarts;
+    }
+}
+exports.DeploymentRolloutError = DeploymentRolloutError;
+function matchLabelsOf(selector) {
+    if (!selector)
+        return undefined;
+    if ("matchLabels" in selector) {
+        return selector.matchLabels;
+    }
+    return selector;
+}
+async function readWorkloadJSON(resourceType, name, options) {
+    const result = await get(`${resourceType}/${name}`, "-o", "json", options);
+    return JSON.parse(result.stdout);
+}
+async function countPodRestarts(matchLabels, options) {
+    if (!matchLabels || !Object.keys(matchLabels).length) {
+        return 0;
+    }
+    const selector = Object.entries(matchLabels)
+        .map(([key, value]) => `${key}=${value}`)
+        .join(",");
+    const result = await get("pods", "-l", selector, "-o", "json", options);
+    const parsed = JSON.parse(result.stdout);
+    return (parsed.items ?? []).reduce((total, pod) => {
+        const podRestarts = (pod.status?.containerStatuses ?? [])
+            .reduce((sum, container) => sum + (container.restartCount ?? 0), 0);
+        return total + podRestarts;
+    }, 0);
+}
+function isProgressingFailed(conditions) {
+    const progressing = conditions.find(c => c.type === "Progressing");
+    if (progressing?.status === "False")
+        return true;
+    return conditions.some(c => c.type === "ReplicaFailure" && c.status === "True");
+}
+/**
+ * Valida cíclicamente el estado de un Deployment/DeploymentConfig hasta que:
+ *   - llega a estado exitoso (replicas listas/actualizadas == replicas deseadas) -> resuelve,
+ *   - supera `maxRestarts` reinicios acumulados -> lanza DeploymentRolloutError,
+ *   - se queda en estado Failed más de `failedGracePeriod` sin recuperarse -> lanza DeploymentRolloutError,
+ *   - o se cumple `timeout` sin éxito -> lanza DeploymentRolloutError.
+ *
+ * El polling se detiene ("se mata el proceso") apenas se detecta cualquiera
+ * de las condiciones de fallo, re-lanzando el error para que `ctx.run(...)`
+ * lo capture y lo reporte vía `ctx.notifier` si lo tienes configurado.
+ */
+async function waitForDeployment(options) {
+    const { deployment, resourceType = "deployment", timeout = 300000, pollInterval = 5000, failedGracePeriod = pollInterval * 6, maxRestarts, ...ocOptions } = options;
+    const startedAt = Date.now();
+    let failedSince = null;
+    while (true) {
+        const elapsedMs = Date.now() - startedAt;
+        if (elapsedMs >= timeout) {
+            const message = `Timeout esperando el rollout de "${deployment}" (${timeout}ms)`;
+            throw new DeploymentRolloutError(message, { status: "timeout", deployment, elapsedMs, restarts: -1 });
+        }
+        let json;
+        try {
+            json = await readWorkloadJSON(resourceType, deployment, ocOptions);
+        }
+        catch {
+            // El recurso puede no existir todavía (justo después de un apply); reintenta.
+            await sleep(pollInterval);
+            continue;
+        }
+        const desired = json.spec?.replicas ?? 1;
+        const ready = json.status?.readyReplicas ?? json.status?.availableReplicas ?? 0;
+        const updated = json.status?.updatedReplicas ?? 0;
+        const conditions = json.status?.conditions ?? [];
+        const failed = isProgressingFailed(conditions);
+        const success = !failed && ready >= desired && updated >= desired;
+        let restarts = 0;
+        if (maxRestarts !== undefined) {
+            restarts = await countPodRestarts(matchLabelsOf(json.spec?.selector), ocOptions);
+            if (restarts > maxRestarts) {
+                const message = `"${deployment}" superó el máximo de reinicios permitido (${restarts} > ${maxRestarts})`;
+                throw new DeploymentRolloutError(message, { status: "failed", deployment, elapsedMs, restarts });
+            }
+        }
+        if (success) {
+            const message = `"${deployment}" alcanzó el estado esperado (${ready}/${desired} listas)`;
+            return { status: "success", deployment, elapsedMs, restarts, message };
+        }
+        if (failed) {
+            if (failedSince === null) {
+                failedSince = Date.now();
+            }
+            else if (Date.now() - failedSince >= failedGracePeriod) {
+                const message = `"${deployment}" quedó en estado Failed y no se recuperó en ${failedGracePeriod}ms`;
+                throw new DeploymentRolloutError(message, { status: "failed", deployment, elapsedMs, restarts });
+            }
+        }
+        else {
+            failedSince = null;
+        }
+        await sleep(pollInterval);
+    }
+}
+/**
+ * Se lanza cuando `waitForDeploymentGroup` no logra que TODAS las instancias
+ * del grupo lleguen a estado exitoso. Lleva `command: "oc"` para que
+ * `classifiers.byCommand({ oc: "kubernetes" })` lo clasifique solo.
+ */
+class DeploymentGroupRolloutError extends Error {
+    constructor(message, info) {
+        super(message);
+        this.command = "oc";
+        this.name = "DeploymentGroupRolloutError";
+        this.label = info.label;
+        this.elapsedMs = info.elapsedMs;
+        this.succeeded = info.succeeded;
+        this.failed = info.failed;
+    }
+}
+exports.DeploymentGroupRolloutError = DeploymentGroupRolloutError;
+function toSelectorString(label) {
+    if (typeof label === "string")
+        return label;
+    return Object.entries(label)
+        .map(([key, value]) => `${key}=${value}`)
+        .join(",");
+}
+async function listWorkloadNames(resourceType, selector, options) {
+    const listCommand = resourceType === "dc" ? "dc" : "deployments";
+    const result = await get(listCommand, "-l", selector, "-o", "json", options);
+    const parsed = JSON.parse(result.stdout);
+    return (parsed.items ?? [])
+        .map(item => item.metadata?.name)
+        .filter((name) => Boolean(name));
+}
+/**
+ * Descubre todos los Deployments/DeploymentConfigs que compartan el `label`
+ * dado (p. ej. todas las instancias GitOps de un mismo repo, marcadas con
+ * `deployment-group: repository-14`) y espera a que TODAS lleguen a estado
+ * exitoso, corriendo `waitForDeployment` por cada una en paralelo con el
+ * mismo `timeout` global.
+ *
+ * Si alguna instancia falla (timeout individual, Failed sin recuperarse, o
+ * maxRestarts superado), se espera a que terminen las demás y se lanza
+ * `DeploymentGroupRolloutError` con el detalle de cuáles fallaron y cuáles sí
+ * llegaron a estado exitoso — listo para que `ctx.run(...)` lo capture y lo
+ * reporte vía `ctx.notifier`.
+ */
+async function waitForDeploymentGroup(options) {
+    const { label, resourceType = "deployment", timeout = 300000, pollInterval = 5000, failedGracePeriod = pollInterval * 6, maxRestarts, ...ocOptions } = options;
+    const selector = toSelectorString(label);
+    const startedAt = Date.now();
+    const names = await listWorkloadNames(resourceType, selector, ocOptions);
+    if (!names.length) {
+        const message = `No se encontraron ${resourceType === "dc" ? "deploymentconfigs" : "deployments"} con el label "${selector}"`;
+        throw new DeploymentGroupRolloutError(message, {
+            label: selector,
+            elapsedMs: Date.now() - startedAt,
+            succeeded: [],
+            failed: []
+        });
+    }
+    const remainingMs = () => Math.max(0, timeout - (Date.now() - startedAt));
+    const settled = await Promise.allSettled(names.map(deployment => waitForDeployment({
+        deployment,
+        resourceType,
+        timeout: remainingMs(),
+        pollInterval,
+        failedGracePeriod,
+        maxRestarts,
+        ...ocOptions
+    })));
+    const succeeded = [];
+    const failed = [];
+    const deployments = [];
+    settled.forEach((outcome, index) => {
+        const name = names[index];
+        if (outcome.status === "fulfilled") {
+            succeeded.push(name);
+            deployments.push(outcome.value);
+            return;
+        }
+        const reason = outcome.reason;
+        failed.push({
+            deployment: name,
+            status: reason?.status ?? "failed",
+            message: reason?.message ?? String(outcome.reason)
+        });
+    });
+    const elapsedMs = Date.now() - startedAt;
+    if (failed.length) {
+        const summary = failed.map(f => `${f.deployment} (${f.status})`).join(", ");
+        const message = `${failed.length}/${names.length} instancias del grupo "${selector}" no llegaron a estado exitoso: ${summary}`;
+        throw new DeploymentGroupRolloutError(message, { label: selector, elapsedMs, succeeded, failed });
+    }
+    const message = `Las ${names.length} instancias del grupo "${selector}" alcanzaron el estado esperado`;
+    return { status: "success", label: selector, elapsedMs, deployments, message };
+}
+//# sourceMappingURL=oc.js.map

package/dist/services/oc.js.map

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

package/dist/services/pipeline.d.ts

@@ -0,0 +1,116 @@
+import type { Context } from "../core/Context";
+export type PipelineEntityStatus = "pending" | "running" | "success" | "failed" | "skipped";
+export interface PipelineTaskBase {
+    depends?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface CallbackTaskConfig extends PipelineTaskBase {
+    exec: (ctx: Context, results: Record<string, unknown>) => unknown | Promise<unknown>;
+}
+export type PipelineTaskConfig = CallbackTaskConfig;
+export interface PipelineJobConfig {
+    tasks?: Record<string, PipelineTaskConfig>;
+    depends?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface PipelineStageConfig {
+    jobs?: Record<string, PipelineJobConfig>;
+    depends?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface PipelineConfig {
+    stages?: Record<string, PipelineStageConfig>;
+    jobs?: Record<string, PipelineJobConfig>;
+    tasks?: Record<string, PipelineTaskConfig>;
+    metadata?: Record<string, unknown>;
+    ctx?: Context;
+}
+export interface PipelineRunResult {
+    status: "success" | "failed";
+    results: Record<string, unknown>;
+    error?: unknown;
+    duration: number;
+}
+export declare class PipelineResultsAccessor {
+    private readonly _pipelineResults;
+    private readonly _stageName;
+    private readonly _jobName;
+    constructor(pipelineResults: Record<string, unknown>, stageName: string, jobName: string);
+    resolve(name: string): unknown;
+    toProxy(): Record<string, unknown>;
+}
+export declare class PipelineTask {
+    readonly name: string;
+    readonly config: PipelineTaskConfig;
+    readonly depends: string[];
+    readonly metadata: Record<string, unknown>;
+    status: PipelineEntityStatus;
+    result: unknown;
+    error: unknown;
+    duration: number;
+    constructor(name: string, config: PipelineTaskConfig);
+    run(ctx: Context, resultsAccessor: Record<string, unknown>, stageName: string, jobName: string): Promise<void>;
+    private _execute;
+    reset(): void;
+}
+export declare class PipelineJob {
+    readonly name: string;
+    readonly tasks: Map<string, PipelineTask>;
+    readonly depends: string[];
+    readonly metadata: Record<string, unknown>;
+    status: PipelineEntityStatus;
+    results: Record<string, unknown>;
+    error: unknown;
+    duration: number;
+    constructor(name: string, config?: PipelineJobConfig);
+    task(nameOrConfig: string | PipelineTaskConfig, config?: PipelineTaskConfig): this;
+    getTask(name: string): PipelineTask | undefined;
+    getResults(): Record<string, unknown>;
+    run(ctx: Context, pipelineResults: Record<string, unknown>, stageName: string): Promise<void>;
+    reset(): void;
+}
+export declare class PipelineStage {
+    readonly name: string;
+    readonly jobs: Map<string, PipelineJob>;
+    readonly depends: string[];
+    readonly metadata: Record<string, unknown>;
+    status: PipelineEntityStatus;
+    results: Record<string, unknown>;
+    error: unknown;
+    duration: number;
+    constructor(name: string, config?: PipelineStageConfig);
+    job(nameOrConfig: string | PipelineJobConfig, config?: PipelineJobConfig): PipelineJob;
+    getJob(name: string): PipelineJob | undefined;
+    getResults(): Record<string, unknown>;
+    run(ctx: Context, pipelineResults: Record<string, unknown>): Promise<void>;
+    reset(): void;
+}
+export declare class Pipeline {
+    readonly name: string;
+    readonly stages: Map<string, PipelineStage>;
+    readonly metadata: Record<string, unknown>;
+    private ctx?;
+    private _results;
+    private _status;
+    private _error;
+    private _duration;
+    constructor(name: string, config?: PipelineConfig);
+    get status(): PipelineEntityStatus;
+    get results(): Record<string, unknown>;
+    get error(): unknown;
+    get duration(): number;
+    setContext(ctx: Context): this;
+    stage(nameOrConfig: string | PipelineStageConfig, config?: PipelineStageConfig): PipelineStage;
+    getStage(name: string): PipelineStage | undefined;
+    getResults(): Record<string, unknown>;
+    run(ctxOrResults?: Context | Record<string, unknown>): Promise<PipelineRunResult>;
+    reset(): void;
+}
+export declare class PipelineRegistry {
+    private pipelines;
+    define(nameOrConfig: string | PipelineConfig, config?: PipelineConfig): this;
+    get(name: string): Pipeline;
+    remove(name: string): boolean;
+    list(): string[];
+    run(name: string, ctx?: Context): Promise<PipelineRunResult>;
+}