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

package/dist/core/Notifier.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Notifier = void 0;
+const types_1 = require("./types");
+const WILDCARD = "*";
+function toMessage(error) {
+    if (error instanceof types_1.ServiceError) {
+        return error.message;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    const maybeExecError = error;
+    const lastLine = (text) => {
+        return text ? text.trim().split("\n").pop() || text : undefined;
+    };
+    return lastLine(maybeExecError?.stderr)
+        || lastLine(maybeExecError?.stdout)
+        || maybeExecError?.message
+        || String(error);
+}
+class Notifier {
+    constructor() {
+        this.classifiers = [];
+        this.messageFormatters = [];
+        this.channels = new Map();
+        this.successSenders = [];
+        this.defaultArea = "unclassified";
+    }
+    /**
+     * Registra una función que decide a qué área de TI corresponde un
+     * error. Se prueban en el orden en que se registraron; gana la primera
+     * que devuelva un string. Si ninguna matchea, se usa el área "unclassified"
+     * (configurable con `setDefaultArea`).
+     */
+    classify(classifier) {
+        this.classifiers.push(classifier);
+        return this;
+    }
+    /**
+     * Registra una función que, dado el error, devuelve el mensaje
+     * personalizado a reportar (reemplaza el stderr/mensaje crudo). Se
+     * prueban en orden; gana la primera que devuelva un string. Si ninguna
+     * matchea, se usa el mensaje crudo del error (stderr/Error.message).
+     *
+     * Ejemplo:
+     *   notifier.describeError(messages.byPattern([
+     *       [/500 Internal Server Error/, "Se reportó a infraestructura: falta de espacio en el registry"],
+     *       [/unauthorized|403/, "Credenciales inválidas contra el registry, revisa el secret"]
+     *   ]));
+     */
+    describeError(formatter) {
+        this.messageFormatters.push(formatter);
+        return this;
+    }
+    setDefaultArea(area) {
+        this.defaultArea = area;
+        return this;
+    }
+    /**
+     * Asocia uno o más senders a un área. Puedes registrar el mismo sender
+     * en varias áreas, o usar el área especial "*" para que reciba TODOS
+     * los errores sin importar la clasificación.
+     */
+    channel(area, ...senders) {
+        const existing = this.channels.get(area) ?? [];
+        this.channels.set(area, [...existing, ...senders]);
+        return this;
+    }
+    /** Senders que se disparan en cada tarea exitosa, sin clasificación. */
+    onSuccess(...senders) {
+        this.successSenders.push(...senders);
+        return this;
+    }
+    resolveArea(error, ctx) {
+        for (const classifier of this.classifiers) {
+            const area = classifier(error, ctx);
+            if (area)
+                return area;
+        }
+        return this.defaultArea;
+    }
+    resolveMessage(error, ctx) {
+        for (const formatter of this.messageFormatters) {
+            const message = formatter(error, ctx);
+            if (message)
+                return message;
+        }
+        return toMessage(error);
+    }
+    async reportSuccess(taskId, result, ctx) {
+        if (!this.successSenders.length)
+            return;
+        const event = {
+            type: "success",
+            taskId,
+            result,
+            message: `Tarea "${taskId}" finalizó correctamente`,
+            timestamp: new Date().toISOString()
+        };
+        await Promise.allSettled(this.successSenders.map(sender => sender(event)));
+    }
+    async reportError(taskId, error, ctx) {
+        const area = this.resolveArea(error, ctx);
+        const senders = [
+            ...(this.channels.get(area) ?? []),
+            ...(area !== WILDCARD ? this.channels.get(WILDCARD) ?? [] : [])
+        ];
+        const serviceError = error instanceof types_1.ServiceError ? error : undefined;
+        const event = {
+            type: "error",
+            taskId,
+            area,
+            error,
+            message: this.resolveMessage(error, ctx),
+            timestamp: new Date().toISOString(),
+            ...(serviceError ? {
+                service: serviceError.service,
+                method: serviceError.method,
+                args: serviceError.args
+            } : {})
+        };
+        await Promise.allSettled(senders.map(sender => sender(event)));
+        return area;
+    }
+}
+exports.Notifier = Notifier;
+//# sourceMappingURL=Notifier.js.map

package/dist/core/Notifier.js.map

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

package/dist/core/classifiers.d.ts

@@ -0,0 +1,45 @@
+import type { ErrorClassifier } from "./types";
+/**
+ * Clasificador de fábrica: mapea el comando que falló (el primer argumento
+ * que le pasaste a shell.exec / docker.*, git.*, etc.) a un área de TI.
+ *
+ * Ejemplo:
+ *   notifier.classify(classifiers.byCommand({
+ *       docker: "containers",
+ *       kubectl: "kubernetes",
+ *       oc: "kubernetes",
+ *       terraform: "infra",
+ *       ansible: "infra",
+ *       git: "scm",
+ *       argocd: "cd-pipeline",
+ *       tkn: "cd-pipeline",
+ *       az: "cloud-azure"
+ *   }));
+ */
+export declare function byCommand(map: Record<string, string>): ErrorClassifier;
+/**
+ * Clasificador de fábrica: prueba una lista de [regex, área] contra el
+ * stderr (o stdout si stderr viene vacío) /mensaje del error y devuelve el
+ * área del primer patrón que matchee.
+ *
+ * Ejemplo:
+ *   notifier.classify(classifiers.byPattern([
+ *       [/permission denied|unauthorized/i, "security"],
+ *       [/timeout|ETIMEDOUT|ECONNREFUSED/i, "networking"],
+ *       [/no space left|ENOSPC/i, "infra"]
+ *   ]));
+ */
+export declare function byPattern(rules: Array<[RegExp, string]>): ErrorClassifier;
+/**
+ * Clasificador de fábrica: mapea el nombre del servicio que falló a un área
+ * de TI. Funciona con errores envueltos por `ctx.wrap()` (ServiceError) y
+ * también con errores raw de `shell.exec` (via `byCommand` como fallback).
+ *
+ * Ejemplo:
+ *   notifier.classify(classifiers.byService({
+ *       docker: "containers",
+ *       kubectl: "kubernetes",
+ *       http: "networking"
+ *   }));
+ */
+export declare function byService(map: Record<string, string>): ErrorClassifier;

package/dist/core/classifiers.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.byCommand = byCommand;
+exports.byPattern = byPattern;
+exports.byService = byService;
+const types_1 = require("./types");
+function unwrapExecLike(error) {
+    if (error instanceof types_1.ServiceError && error.cause) {
+        return error.cause;
+    }
+    return error;
+}
+function unwrapText(error) {
+    if (error instanceof types_1.ServiceError && error.cause) {
+        const cause = error.cause;
+        return cause.stderr || cause.stdout || cause.message || String(error.cause);
+    }
+    const execError = error;
+    return execError?.stderr || execError?.stdout || execError?.message || String(error);
+}
+/**
+ * Clasificador de fábrica: mapea el comando que falló (el primer argumento
+ * que le pasaste a shell.exec / docker.*, git.*, etc.) a un área de TI.
+ *
+ * Ejemplo:
+ *   notifier.classify(classifiers.byCommand({
+ *       docker: "containers",
+ *       kubectl: "kubernetes",
+ *       oc: "kubernetes",
+ *       terraform: "infra",
+ *       ansible: "infra",
+ *       git: "scm",
+ *       argocd: "cd-pipeline",
+ *       tkn: "cd-pipeline",
+ *       az: "cloud-azure"
+ *   }));
+ */
+function byCommand(map) {
+    return (error) => {
+        const execError = unwrapExecLike(error);
+        const command = execError?.command;
+        if (!command)
+            return undefined;
+        return map[command];
+    };
+}
+/**
+ * Clasificador de fábrica: prueba una lista de [regex, área] contra el
+ * stderr (o stdout si stderr viene vacío) /mensaje del error y devuelve el
+ * área del primer patrón que matchee.
+ *
+ * Ejemplo:
+ *   notifier.classify(classifiers.byPattern([
+ *       [/permission denied|unauthorized/i, "security"],
+ *       [/timeout|ETIMEDOUT|ECONNREFUSED/i, "networking"],
+ *       [/no space left|ENOSPC/i, "infra"]
+ *   ]));
+ */
+function byPattern(rules) {
+    return (error) => {
+        const text = unwrapText(error);
+        for (const [pattern, area] of rules) {
+            if (pattern.test(text)) {
+                return area;
+            }
+        }
+        return undefined;
+    };
+}
+/**
+ * Clasificador de fábrica: mapea el nombre del servicio que falló a un área
+ * de TI. Funciona con errores envueltos por `ctx.wrap()` (ServiceError) y
+ * también con errores raw de `shell.exec` (via `byCommand` como fallback).
+ *
+ * Ejemplo:
+ *   notifier.classify(classifiers.byService({
+ *       docker: "containers",
+ *       kubectl: "kubernetes",
+ *       http: "networking"
+ *   }));
+ */
+function byService(map) {
+    return (error) => {
+        if (error instanceof types_1.ServiceError) {
+            return map[error.service];
+        }
+        return undefined;
+    };
+}
+//# sourceMappingURL=classifiers.js.map

package/dist/core/classifiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifiers.js","sourceRoot":"","sources":["../../src/core/classifiers.ts"],"names":[],"mappings":";;AA2CA,8BAaC;AAcD,8BAgBC;AAcD,8BAYC;AA/GD,mCAAuC;AASvC,SAAS,cAAc,CAAC,KAAc;IAClC,IAAI,KAAK,YAAY,oBAAY,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/C,OAAO,KAAK,CAAC,KAAsB,CAAC;IACxC,CAAC;IACD,OAAO,KAAsB,CAAC;AAClC,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAC9B,IAAI,KAAK,YAAY,oBAAY,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAsB,CAAC;QAC3C,OAAO,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,SAAS,GAAG,KAAsB,CAAC;IACzC,OAAO,SAAS,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,IAAI,SAAS,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;AACzF,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,SAAS,CAAC,GAA2B;IAEjD,OAAO,CAAC,KAAc,EAAE,EAAE;QAEtB,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,SAAS,EAAE,OAAO,CAAC;QAEnC,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAE/B,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC;IAExB,CAAC,CAAC;AAEN,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,SAAS,CAAC,KAA8B;IAEpD,OAAO,CAAC,KAAc,EAAE,EAAE;QAEtB,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAE/B,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;YAClC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,OAAO,IAAI,CAAC;YAChB,CAAC;QACL,CAAC;QAED,OAAO,SAAS,CAAC;IAErB,CAAC,CAAC;AAEN,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,SAAS,CAAC,GAA2B;IAEjD,OAAO,CAAC,KAAc,EAAE,EAAE;QAEtB,IAAI,KAAK,YAAY,oBAAY,EAAE,CAAC;YAChC,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,SAAS,CAAC;IAErB,CAAC,CAAC;AAEN,CAAC"}

package/dist/core/logger.d.ts

@@ -0,0 +1,8 @@
+export interface Logger {
+    debug(message: string): void;
+    info(message: string): void;
+    success(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+}
+export declare const logger: Logger;

package/dist/core/logger.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+const COLORS = {
+    reset: "\x1b[0m",
+    gray: "\x1b[90m",
+    cyan: "\x1b[36m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    red: "\x1b[31m"
+};
+function timestamp() {
+    return new Date().toISOString().split("T")[1].replace("Z", "");
+}
+function paint(color, label, message) {
+    return `${COLORS.gray}[${timestamp()}]${COLORS.reset} ${color}${label}${COLORS.reset} ${message}`;
+}
+exports.logger = {
+    debug(message) {
+        if (!process.env.DEBUG)
+            return;
+        console.log(paint(COLORS.gray, "DEBUG", message));
+    },
+    info(message) {
+        console.log(paint(COLORS.cyan, "INFO ", message));
+    },
+    success(message) {
+        console.log(paint(COLORS.green, "OK   ", message));
+    },
+    warn(message) {
+        console.warn(paint(COLORS.yellow, "WARN ", message));
+    },
+    error(message) {
+        console.error(paint(COLORS.red, "ERROR", message));
+    }
+};
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":";;;AAAA,MAAM,MAAM,GAAG;IACX,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,GAAG,EAAE,UAAU;CACT,CAAC;AAEX,SAAS,SAAS;IACd,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,KAAK,CAAC,KAAa,EAAE,KAAa,EAAE,OAAe;IACxD,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,SAAS,EAAE,IAAI,MAAM,CAAC,KAAK,IAAI,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,OAAO,EAAE,CAAC;AACtG,CAAC;AAUY,QAAA,MAAM,GAAW;IAE1B,KAAK,CAAC,OAAe;QACjB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK;YAAE,OAAO;QAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,CAAC,OAAe;QAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,CAAC,OAAe;QACnB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,CAAC,OAAe;QAChB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,OAAe;QACjB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC;CAEJ,CAAC"}

package/dist/core/messages.d.ts

@@ -0,0 +1,102 @@
+import type { Context } from "./Context";
+import type { ErrorMessageFormatter } from "./types";
+/**
+ * Formateador de fábrica: prueba una lista de [regex, mensaje] contra el
+ * stderr (o stdout si stderr viene vacío, p. ej. errores de `oc` que se
+ * imprimen en stdout) /mensaje del error y devuelve el mensaje personalizado
+ * del primer patrón que matchee, en vez del stderr crudo.
+ *
+ * Ojo: esto NO distingue por comando — un mismo patrón (ej. "500 Internal
+ * Server Error") aplica igual venga de `docker`, `kubectl` o `terraform`.
+ * Si necesitas distinguir por comando (y opcionalmente por sub-comando),
+ * usa `byRule` más abajo.
+ *
+ * Ejemplo:
+ *   notifier.describeError(messages.byPattern([
+ *       [/500 Internal Server Error/, "Se reportó a infraestructura: falta de espacio en el registry"],
+ *       [/unauthorized|403/i, "Credenciales inválidas contra el registry, revisa el secret"],
+ *       [/no space left|ENOSPC/i, "El nodo se quedó sin espacio en disco"]
+ *   ]));
+ */
+export declare function byPattern(rules: Array<[RegExp, string]>): ErrorMessageFormatter;
+/**
+ * Formateador de fábrica: mapea el comando que falló (docker, kubectl,
+ * terraform, etc.) a un mensaje genérico fijo, sin importar el detalle del
+ * error. Útil como mensaje "catch-all" por comando cuando no necesitas
+ * distinguir por patrón.
+ *
+ * Ejemplo:
+ *   notifier.describeError(messages.byCommand({
+ *       docker: "Falló un paso de Docker, revisa el build/push del registry"
+ *   }));
+ */
+export declare function byCommand(map: Record<string, string>): ErrorMessageFormatter;
+/**
+ * Una regla de `byRule`: TODAS las condiciones que definas deben cumplirse
+ * (AND) para que aplique. Omitir una condición equivale a "no filtrar por
+ * eso" (matchea cualquier valor).
+ */
+export interface MessageRule {
+    /**
+     * Comando exacto (o lista de comandos) que debe haber fallado, tal como
+     * lo ve `shell.exec` (el primer argumento: "docker", "kubectl", "oc",
+     * "terraform", "git", etc.). Sin esto, la regla no filtra por comando.
+     */
+    command?: string | string[];
+    /**
+     * Sub-comando / argumento que debe estar presente, por ejemplo "push"
+     * para distinguir `docker push` de `docker build`. Puede ser un string
+     * exacto (se busca entre los args, o como substring de los args unidos)
+     * o un RegExp contra los args unidos con espacios.
+     */
+    args?: string | RegExp;
+    /** Patrón contra el stderr/mensaje del error. Sin esto, no filtra por texto. */
+    pattern?: RegExp;
+    /** Mensaje final. Puede ser un string fijo o una función que lo arma dinámicamente. */
+    message: string | ((error: unknown, ctx: Context) => string);
+}
+/**
+ * Formateador de fábrica avanzado: combina comando + sub-comando/args +
+ * patrón de texto (todo opcional, en modo AND) para distinguir el MISMO
+ * error de red/HTTP según de dónde vino. Resuelve justo el caso de "un 500
+ * puede venir de docker push, de kubectl, o de terraform, y cada uno
+ * necesita su propio mensaje".
+ *
+ * Se prueban las reglas en orden; gana la primera que matchee todas sus
+ * condiciones. Una regla sin `command` ni `args` ni `pattern` matchea
+ * cualquier error (útil como catch-all al final de la lista).
+ *
+ * Ejemplo — el caso concreto de varios comandos devolviendo el mismo 500:
+ *
+ *   notifier.describeError(messages.byRule([
+ *       {
+ *           command: "docker", args: "push", pattern: /500 Internal Server Error/,
+ *           message: "Se ha reportado a infraestructura: falta de espacio en el registry"
+ *       },
+ *       {
+ *           command: "kubectl", pattern: /500/,
+ *           message: "El API server de Kubernetes devolvió 500, reintenta en unos minutos"
+ *       },
+ *       {
+ *           command: "terraform", pattern: /500/,
+ *           message: (error, ctx) => `El backend remoto de Terraform State no respondió (env: ${ctx.params.env ?? "?"})`
+ *       },
+ *       {
+ *           pattern: /500 Internal Server Error/,
+ *           message: "Error 500 no clasificado por comando, revisar logs crudos"
+ *       }
+ *   ]));
+ */
+export declare function byRule(rules: MessageRule[]): ErrorMessageFormatter;
+/**
+ * Formateador de fábrica: mapea el nombre del servicio que falló a un
+ * mensaje genérico fijo. Funciona con errores envueltos por `ctx.wrap()`
+ * (ServiceError).
+ *
+ * Ejemplo:
+ *   notifier.describeError(messages.byService({
+ *       docker: "Falló una operación de Docker, revisa el build/push del registry",
+ *       http: "Falló una petición HTTP, revisa la conectividad"
+ *   }));
+ */
+export declare function byService(map: Record<string, string>): ErrorMessageFormatter;

package/dist/core/messages.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.byPattern = byPattern;
+exports.byCommand = byCommand;
+exports.byRule = byRule;
+exports.byService = byService;
+const types_1 = require("./types");
+function unwrapExecLike(error) {
+    if (error instanceof types_1.ServiceError && error.cause) {
+        return error.cause;
+    }
+    return error;
+}
+function textOf(error) {
+    if (error instanceof types_1.ServiceError && error.cause) {
+        const cause = error.cause;
+        return cause.stderr || cause.stdout || cause.message || String(error.cause);
+    }
+    const execError = error;
+    return execError?.stderr || execError?.stdout || execError?.message || String(error);
+}
+/**
+ * Formateador de fábrica: prueba una lista de [regex, mensaje] contra el
+ * stderr (o stdout si stderr viene vacío, p. ej. errores de `oc` que se
+ * imprimen en stdout) /mensaje del error y devuelve el mensaje personalizado
+ * del primer patrón que matchee, en vez del stderr crudo.
+ *
+ * Ojo: esto NO distingue por comando — un mismo patrón (ej. "500 Internal
+ * Server Error") aplica igual venga de `docker`, `kubectl` o `terraform`.
+ * Si necesitas distinguir por comando (y opcionalmente por sub-comando),
+ * usa `byRule` más abajo.
+ *
+ * Ejemplo:
+ *   notifier.describeError(messages.byPattern([
+ *       [/500 Internal Server Error/, "Se reportó a infraestructura: falta de espacio en el registry"],
+ *       [/unauthorized|403/i, "Credenciales inválidas contra el registry, revisa el secret"],
+ *       [/no space left|ENOSPC/i, "El nodo se quedó sin espacio en disco"]
+ *   ]));
+ */
+function byPattern(rules) {
+    return (error) => {
+        const text = textOf(error);
+        for (const [pattern, message] of rules) {
+            if (pattern.test(text)) {
+                return message;
+            }
+        }
+        return undefined;
+    };
+}
+/**
+ * Formateador de fábrica: mapea el comando que falló (docker, kubectl,
+ * terraform, etc.) a un mensaje genérico fijo, sin importar el detalle del
+ * error. Útil como mensaje "catch-all" por comando cuando no necesitas
+ * distinguir por patrón.
+ *
+ * Ejemplo:
+ *   notifier.describeError(messages.byCommand({
+ *       docker: "Falló un paso de Docker, revisa el build/push del registry"
+ *   }));
+ */
+function byCommand(map) {
+    return (error) => {
+        const execError = unwrapExecLike(error);
+        const command = execError?.command;
+        if (!command)
+            return undefined;
+        return map[command];
+    };
+}
+function commandMatches(rule, command) {
+    if (!rule.command)
+        return true;
+    if (!command)
+        return false;
+    const candidates = Array.isArray(rule.command) ? rule.command : [rule.command];
+    return candidates.includes(command);
+}
+function argsMatch(rule, args) {
+    if (!rule.args)
+        return true;
+    if (!args || !args.length)
+        return false;
+    const joined = args.join(" ");
+    if (rule.args instanceof RegExp) {
+        return rule.args.test(joined);
+    }
+    return args.includes(rule.args) || joined.includes(rule.args);
+}
+function patternMatches(rule, text) {
+    if (!rule.pattern)
+        return true;
+    return rule.pattern.test(text);
+}
+/**
+ * Formateador de fábrica avanzado: combina comando + sub-comando/args +
+ * patrón de texto (todo opcional, en modo AND) para distinguir el MISMO
+ * error de red/HTTP según de dónde vino. Resuelve justo el caso de "un 500
+ * puede venir de docker push, de kubectl, o de terraform, y cada uno
+ * necesita su propio mensaje".
+ *
+ * Se prueban las reglas en orden; gana la primera que matchee todas sus
+ * condiciones. Una regla sin `command` ni `args` ni `pattern` matchea
+ * cualquier error (útil como catch-all al final de la lista).
+ *
+ * Ejemplo — el caso concreto de varios comandos devolviendo el mismo 500:
+ *
+ *   notifier.describeError(messages.byRule([
+ *       {
+ *           command: "docker", args: "push", pattern: /500 Internal Server Error/,
+ *           message: "Se ha reportado a infraestructura: falta de espacio en el registry"
+ *       },
+ *       {
+ *           command: "kubectl", pattern: /500/,
+ *           message: "El API server de Kubernetes devolvió 500, reintenta en unos minutos"
+ *       },
+ *       {
+ *           command: "terraform", pattern: /500/,
+ *           message: (error, ctx) => `El backend remoto de Terraform State no respondió (env: ${ctx.params.env ?? "?"})`
+ *       },
+ *       {
+ *           pattern: /500 Internal Server Error/,
+ *           message: "Error 500 no clasificado por comando, revisar logs crudos"
+ *       }
+ *   ]));
+ */
+function byRule(rules) {
+    return (error, ctx) => {
+        const execError = unwrapExecLike(error);
+        const text = textOf(error);
+        for (const rule of rules) {
+            const matches = commandMatches(rule, execError?.command)
+                && argsMatch(rule, execError?.args)
+                && patternMatches(rule, text);
+            if (matches) {
+                return typeof rule.message === "function"
+                    ? rule.message(error, ctx)
+                    : rule.message;
+            }
+        }
+        return undefined;
+    };
+}
+/**
+ * Formateador de fábrica: mapea el nombre del servicio que falló a un
+ * mensaje genérico fijo. Funciona con errores envueltos por `ctx.wrap()`
+ * (ServiceError).
+ *
+ * Ejemplo:
+ *   notifier.describeError(messages.byService({
+ *       docker: "Falló una operación de Docker, revisa el build/push del registry",
+ *       http: "Falló una petición HTTP, revisa la conectividad"
+ *   }));
+ */
+function byService(map) {
+    return (error) => {
+        if (error instanceof types_1.ServiceError) {
+            return map[error.service];
+        }
+        return undefined;
+    };
+}
+//# sourceMappingURL=messages.js.map

package/dist/core/messages.js.map

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

package/dist/core/prompt.d.ts

@@ -0,0 +1,10 @@
+export interface AskOptions {
+    defaultValue?: string;
+}
+export declare function ask(question: string, options?: AskOptions): Promise<string | undefined>;
+export interface ConfirmOptions {
+    defaultValue?: boolean;
+}
+export declare function confirm(question: string, options?: ConfirmOptions): Promise<boolean>;
+export type SelectChoices = string[] | Record<string, string>;
+export declare function select(title: string, choices: SelectChoices): Promise<string>;