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

package/dist/bin/devops-cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/devops-cli.js

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const Context_1 = require("../core/Context");
+const Menu_1 = require("../core/Menu");
+const logger_1 = require("../core/logger");
+const CONFIG_CANDIDATES = [
+    "devops.pipeline.js",
+    "devops.config.js",
+    ".catops-cli.js"
+];
+function findConfig() {
+    const cwd = process.cwd();
+    for (const file of CONFIG_CANDIDATES) {
+        const fullPath = path.join(cwd, file);
+        if (fs.existsSync(fullPath)) {
+            return fullPath;
+        }
+    }
+    return null;
+}
+function printHelp() {
+    console.log(`
+catops-cli — framework CLI para pipelines DevOps
+
+Uso:
+  catops-cli [--flag] [--param=valor]
+
+Este comando busca, en el directorio actual, uno de estos archivos:
+  ${CONFIG_CANDIDATES.join("\n  ")}
+
+Ese archivo debe exportar una definición de menú, por ejemplo:
+
+  // devops.pipeline.js
+  module.exports = (ctx) => ({
+      title: "Pipeline",
+      "flag-selector": "--menu-selector",
+      options: {
+          Build: {
+              selector: "build",
+              action: async () => {
+                  await ctx.services.docker.build({
+                      image: "registry/app:v1",
+                      dockerfile: "Dockerfile"
+                  });
+              }
+          },
+          Deploy: {
+              selector: "deploy",
+              action: async () => {
+                  await ctx.services.kubectl.apply("deployment.yaml");
+              }
+          }
+      }
+  });
+
+Con esa definición, ambas formas funcionan:
+
+  catops-cli                       # menú interactivo
+  catops-cli --menu-selector=build # ejecuta "Build" directamente, sin prompts
+
+Si "Deploy" fuera un submenú anidado con su propio "flag-selector", se puede
+encadenar en un solo comando, por ejemplo:
+
+  catops-cli --menu-selector=deploy --deploy-target=staging
+
+También puedes usar la librería directamente en tu código:
+
+  const { Context, Menu } = require("catops-cli");
+  import { Context, Menu } from "catops-cli"; // con tipados, en TS
+`);
+}
+async function main() {
+    const configPath = findConfig();
+    if (!configPath) {
+        printHelp();
+        process.exit(0);
+    }
+    const ctx = Context_1.Context.parseArgv();
+    if (ctx.hasFlag("help") || ctx.hasFlag("h")) {
+        printHelp();
+        process.exit(0);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-var-requires, global-require
+    const definitionFactory = require(configPath);
+    const definition = typeof definitionFactory === "function"
+        ? await definitionFactory(ctx)
+        : definitionFactory;
+    logger_1.logger.info(`Usando configuración: ${path.relative(process.cwd(), configPath)}`);
+    await Menu_1.Menu.render(definition, ctx);
+}
+main().catch(error => {
+    const message = error instanceof Error ? error.message : String(error);
+    logger_1.logger.error(message);
+    process.exit(1);
+});
+//# sourceMappingURL=devops-cli.js.map

package/dist/bin/devops-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devops-cli.js","sourceRoot":"","sources":["../../src/bin/devops-cli.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,2CAA6B;AAC7B,uCAAyB;AACzB,6CAA0C;AAC1C,uCAAoC;AACpC,2CAAwC;AAGxC,MAAM,iBAAiB,GAAG;IACtB,oBAAoB;IACpB,kBAAkB;IAClB,gBAAgB;CACnB,CAAC;AAEF,SAAS,UAAU;IAEf,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE1B,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;QAEnC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAEtC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,QAAQ,CAAC;QACpB,CAAC;IAEL,CAAC;IAED,OAAO,IAAI,CAAC;AAEhB,CAAC;AAED,SAAS,SAAS;IAEd,OAAO,CAAC,GAAG,CAAC;;;;;;;IAOZ,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCjC,CAAC,CAAC;AAEH,CAAC;AAMD,KAAK,UAAU,IAAI;IAEf,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC;IAEhC,IAAI,CAAC,UAAU,EAAE,CAAC;QACd,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,GAAG,GAAG,iBAAO,CAAC,SAAS,EAAE,CAAC;IAEhC,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,8EAA8E;IAC9E,MAAM,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAoC,CAAC;IAEjF,MAAM,UAAU,GAAG,OAAO,iBAAiB,KAAK,UAAU;QACtD,CAAC,CAAC,MAAM,iBAAiB,CAAC,GAAG,CAAC;QAC9B,CAAC,CAAC,iBAAiB,CAAC;IAExB,eAAM,CAAC,IAAI,CAAC,yBAAyB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;IAEjF,MAAM,WAAI,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;AAEvC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;IACjB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,eAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/core/Context.d.ts

@@ -0,0 +1,56 @@
+import { type Logger } from "./logger";
+import { type ServicesRegistry } from "../services";
+import { Notifier } from "./Notifier";
+import type { AskOptions, ConfirmOptions, SelectChoices } from "./prompt";
+import type { TaskHooks } from "./types";
+export type FlagValue = boolean | string;
+export declare class Context {
+    private static instance;
+    flags: Record<string, FlagValue>;
+    params: Record<string, string>;
+    env: NodeJS.ProcessEnv;
+    vars: Record<string, unknown>;
+    results: Record<string, unknown>;
+    logger: Logger;
+    services: ServicesRegistry;
+    notifier: Notifier;
+    config: Record<string, unknown>;
+    state: Record<string, unknown>;
+    static current(): Context;
+    /** Reinicia el singleton. Útil sobre todo en tests. */
+    static reset(): Context;
+    setFlag(name: string, value?: FlagValue): this;
+    getFlag(name: string): FlagValue | undefined;
+    hasFlag(name: string): boolean;
+    set<T = unknown>(name: string, value: T): this;
+    get<T = unknown>(name: string): T | undefined;
+    /**
+     * Ejecuta una task, guarda su resultado en `ctx.results[taskId]`, y
+     * dispara los callbacks de éxito/error correspondientes:
+     *   1. `hooks.onSuccess` / `hooks.onError` (si los pasaste), y
+     *   2. el `notifier` global (clasifica el error por área de TI y
+     *      lo reporta a los canales registrados con `ctx.notifier.channel(...)`).
+     *
+     * Si la task lanza, el error se re-lanza después de notificar, para no
+     * esconder fallas silenciosamente.
+     */
+    run<T>(taskId: string, callback: (ctx: Context) => Promise<T> | T, hooks?: TaskHooks<T>): Promise<T>;
+    /**
+     * Envuelve un objeto de servicio (o cualquier objeto con métodos) en un
+     * Proxy que intercepta cada llamada a método. Si el método lanza un error,
+     * lo envuelve en un `ServiceError` con metadata del servicio (nombre,
+     * método, argumentos) y lo despacha al notifier antes de re-lanzarlo.
+     *
+     * Ejemplo:
+     *   const docker = ctx.wrap(ctx.services.docker, "docker");
+     *   await docker.push("myimage:latest");
+     *   // Si falla, el notifier recibe:
+     *   //   taskId: 'docker.push("myimage:latest")'
+     *   //   error: ServiceError { service: "docker", method: "push", args: [...], cause: ExecResult }
+     */
+    wrap<T extends Record<string, (...args: any[]) => any>>(service: T, serviceName: string): T;
+    ask(question: string, options?: AskOptions): Promise<string | undefined>;
+    confirm(question: string, options?: ConfirmOptions): Promise<boolean>;
+    select(title: string, choices: SelectChoices): Promise<string>;
+    static parseArgv(argv?: string[]): Context;
+}

package/dist/core/Context.js

@@ -0,0 +1,197 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Context = void 0;
+const logger_1 = require("./logger");
+const prompt = __importStar(require("./prompt"));
+const services_1 = require("../services");
+const Notifier_1 = require("./Notifier");
+const types_1 = require("./types");
+class Context {
+    constructor() {
+        this.flags = {};
+        this.params = {};
+        this.env = { ...process.env };
+        this.vars = {};
+        this.results = {};
+        this.logger = logger_1.logger;
+        this.services = services_1.services;
+        this.notifier = new Notifier_1.Notifier();
+        this.config = {};
+        this.state = {};
+    }
+    static current() {
+        if (!Context.instance) {
+            Context.instance = new Context();
+        }
+        return Context.instance;
+    }
+    /** Reinicia el singleton. Útil sobre todo en tests. */
+    static reset() {
+        Context.instance = new Context();
+        return Context.instance;
+    }
+    // ---- flags ----
+    setFlag(name, value = true) {
+        this.flags[name] = value;
+        return this;
+    }
+    getFlag(name) {
+        return this.flags[name];
+    }
+    hasFlag(name) {
+        return Boolean(this.flags[name]);
+    }
+    // ---- vars ----
+    set(name, value) {
+        this.vars[name] = value;
+        return this;
+    }
+    get(name) {
+        return this.vars[name];
+    }
+    // ---- results del pipe ----
+    /**
+     * Ejecuta una task, guarda su resultado en `ctx.results[taskId]`, y
+     * dispara los callbacks de éxito/error correspondientes:
+     *   1. `hooks.onSuccess` / `hooks.onError` (si los pasaste), y
+     *   2. el `notifier` global (clasifica el error por área de TI y
+     *      lo reporta a los canales registrados con `ctx.notifier.channel(...)`).
+     *
+     * Si la task lanza, el error se re-lanza después de notificar, para no
+     * esconder fallas silenciosamente.
+     */
+    async run(taskId, callback, hooks = {}) {
+        try {
+            const value = await callback(this);
+            this.results[taskId] = value;
+            await hooks.onSuccess?.(value, this);
+            await this.notifier.reportSuccess(taskId, value, this);
+            return value;
+        }
+        catch (error) {
+            await hooks.onError?.(error, this);
+            await this.notifier.reportError(taskId, error, this);
+            throw error;
+        }
+    }
+    /**
+     * Envuelve un objeto de servicio (o cualquier objeto con métodos) en un
+     * Proxy que intercepta cada llamada a método. Si el método lanza un error,
+     * lo envuelve en un `ServiceError` con metadata del servicio (nombre,
+     * método, argumentos) y lo despacha al notifier antes de re-lanzarlo.
+     *
+     * Ejemplo:
+     *   const docker = ctx.wrap(ctx.services.docker, "docker");
+     *   await docker.push("myimage:latest");
+     *   // Si falla, el notifier recibe:
+     *   //   taskId: 'docker.push("myimage:latest")'
+     *   //   error: ServiceError { service: "docker", method: "push", args: [...], cause: ExecResult }
+     */
+    wrap(service, serviceName) {
+        const ctx = this;
+        return new Proxy(service, {
+            get(target, prop, receiver) {
+                const original = Reflect.get(target, prop, receiver);
+                if (typeof original !== "function")
+                    return original;
+                return async function (...args) {
+                    try {
+                        return await original.apply(target, args);
+                    }
+                    catch (error) {
+                        const methodName = String(prop);
+                        const serializedArgs = args.map(a => {
+                            try {
+                                return JSON.stringify(a);
+                            }
+                            catch {
+                                return String(a);
+                            }
+                        }).join(", ");
+                        const taskId = `${serviceName}.${methodName}(${serializedArgs})`;
+                        const wrapped = new types_1.ServiceError(serviceName, methodName, args, error);
+                        await ctx.notifier.reportError(taskId, wrapped, ctx);
+                        throw wrapped;
+                    }
+                };
+            }
+        });
+    }
+    // ---- prompts ----
+    async ask(question, options) {
+        return prompt.ask(question, options);
+    }
+    async confirm(question, options) {
+        return prompt.confirm(question, options);
+    }
+    async select(title, choices) {
+        return prompt.select(title, choices);
+    }
+    // ---- inicialización desde argv ----
+    static parseArgv(argv = process.argv.slice(2)) {
+        const ctx = Context.current();
+        argv.forEach(arg => {
+            if (arg.startsWith("--")) {
+                const [key, value] = arg.slice(2).split("=");
+                if (value === undefined) {
+                    ctx.setFlag(key, true);
+                }
+                else {
+                    ctx.params[key] = value;
+                }
+            }
+        });
+        // Flags globales que reconfiguran shell.exec para todo el proceso,
+        // sin que ninguna task tenga que pasarlos manualmente.
+        const shellOptions = {};
+        if (ctx.hasFlag("dry-run") || ctx.hasFlag("dryRun")) {
+            shellOptions.dryRun = true;
+        }
+        if (ctx.params.retry !== undefined) {
+            shellOptions.retry = parseInt(ctx.params.retry, 10);
+        }
+        if (ctx.params.timeout !== undefined) {
+            shellOptions.timeout = parseInt(ctx.params.timeout, 10);
+        }
+        if (Object.keys(shellOptions).length) {
+            ctx.services.shell.configure(shellOptions);
+        }
+        return ctx;
+    }
+}
+exports.Context = Context;
+Context.instance = null;
+//# sourceMappingURL=Context.js.map

package/dist/core/Context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Context.js","sourceRoot":"","sources":["../../src/core/Context.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,qCAA+C;AAC/C,iDAAmC;AACnC,0CAA8D;AAC9D,yCAAsC;AAGtC,mCAAuC;AAIvC,MAAa,OAAO;IAApB;QAII,UAAK,GAA8B,EAAE,CAAC;QACtC,WAAM,GAA2B,EAAE,CAAC;QACpC,QAAG,GAAsB,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC5C,SAAI,GAA4B,EAAE,CAAC;QACnC,YAAO,GAA4B,EAAE,CAAC;QACtC,WAAM,GAAW,eAAM,CAAC;QACxB,aAAQ,GAAqB,mBAAQ,CAAC;QACtC,aAAQ,GAAa,IAAI,mBAAQ,EAAE,CAAC;QACpC,WAAM,GAA4B,EAAE,CAAC;QACrC,UAAK,GAA4B,EAAE,CAAC;IAiLxC,CAAC;IA/KG,MAAM,CAAC,OAAO;QACV,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACpB,OAAO,CAAC,QAAQ,GAAG,IAAI,OAAO,EAAE,CAAC;QACrC,CAAC;QACD,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC5B,CAAC;IAED,uDAAuD;IACvD,MAAM,CAAC,KAAK;QACR,OAAO,CAAC,QAAQ,GAAG,IAAI,OAAO,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC5B,CAAC;IAED,kBAAkB;IAElB,OAAO,CAAC,IAAY,EAAE,QAAmB,IAAI;QACzC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACzB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,CAAC,IAAY;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,CAAC,IAAY;QAChB,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,iBAAiB;IAEjB,GAAG,CAAc,IAAY,EAAE,KAAQ;QACnC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACxB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,GAAG,CAAc,IAAY;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAkB,CAAC;IAC5C,CAAC;IAED,6BAA6B;IAE7B;;;;;;;;;OASG;IACH,KAAK,CAAC,GAAG,CACL,MAAc,EACd,QAA0C,EAC1C,QAAsB,EAAE;QAGxB,IAAI,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;YAE7B,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACrC,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YAEvD,OAAO,KAAK,CAAC;QAEjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAEb,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACnC,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YAErD,MAAM,KAAK,CAAC;QAEhB,CAAC;IAEL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,CAAoD,OAAU,EAAE,WAAmB;QACnF,MAAM,GAAG,GAAG,IAAI,CAAC;QACjB,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE;YACtB,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;gBACtB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;gBACrD,IAAI,OAAO,QAAQ,KAAK,UAAU;oBAAE,OAAO,QAAQ,CAAC;gBACpD,OAAO,KAAK,WAA0B,GAAG,IAAe;oBACpD,IAAI,CAAC;wBACD,OAAO,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;oBAC9C,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACb,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;wBAChC,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;4BAChC,IAAI,CAAC;gCAAC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;4BAAC,CAAC;4BAAC,MAAM,CAAC;gCAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;4BAAC,CAAC;wBACjE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBACd,MAAM,MAAM,GAAG,GAAG,WAAW,IAAI,UAAU,IAAI,cAAc,GAAG,CAAC;wBACjE,MAAM,OAAO,GAAG,IAAI,oBAAY,CAAC,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;wBACvE,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;wBACrD,MAAM,OAAO,CAAC;oBAClB,CAAC;gBACL,CAAC,CAAC;YACN,CAAC;SACJ,CAAC,CAAC;IACP,CAAC;IAED,oBAAoB;IAEpB,KAAK,CAAC,GAAG,CAAC,QAAgB,EAAE,OAAoB;QAC5C,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,OAAwB;QACpD,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,OAAsB;QAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,sCAAsC;IAEtC,MAAM,CAAC,SAAS,CAAC,OAAiB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAEnD,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QAE9B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YAEf,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAEvB,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAE7C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACtB,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBAC3B,CAAC;qBAAM,CAAC;oBACJ,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBAC5B,CAAC;YAEL,CAAC;QAEL,CAAC,CAAC,CAAC;QAEH,mEAAmE;QACnE,uDAAuD;QACvD,MAAM,YAAY,GAA2D,EAAE,CAAC;QAEhF,IAAI,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClD,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC;QAC/B,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACjC,YAAY,CAAC,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACnC,YAAY,CAAC,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,CAAC;YACnC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,GAAG,CAAC;IAEf,CAAC;;AA5LL,0BA8LC;AA5LkB,gBAAQ,GAAmB,IAAI,AAAvB,CAAwB"}

package/dist/core/Menu.d.ts

@@ -0,0 +1,23 @@
+import { Context } from "./Context";
+import type { MenuDefinition } from "./types";
+export declare const EXIT: unique symbol;
+export declare class Menu {
+    static readonly EXIT: symbol;
+    /**
+     * Ejecuta un item ya resuelto: si es una task, la corre, guarda su
+     * resultado en `ctx.results[label]`, dispara `onSuccess`/`onError`
+     * propios del item (si se pasaron) y reporta el resultado al
+     * `ctx.notifier` (clasificación por área de TI + canales). Si es un
+     * submenú, simplemente lo renderiza (y así hereda su propio manejo de
+     * flag-selector/hooks).
+     */
+    private static executeEntry;
+    /**
+     * Renderiza un menú. Si `definition["flag-selector"]` está presente y el
+     * Context trae un param que matchea el `selector` de alguno de los
+     * items, esa opción se ejecuta automáticamente sin pedir input al
+     * usuario (y, si es un submenú, este a su vez revisa su propio
+     * "flag-selector", permitiendo encadenar varios niveles).
+     */
+    static render(definition: MenuDefinition, ctx?: Context): Promise<typeof EXIT | void>;
+}

package/dist/core/Menu.js

@@ -0,0 +1,160 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Menu = exports.EXIT = void 0;
+const prompt = __importStar(require("./prompt"));
+const logger_1 = require("./logger");
+const Context_1 = require("./Context");
+exports.EXIT = Symbol("exit");
+function isMenuDefinition(value) {
+    return Boolean(value)
+        && typeof value === "object"
+        && "title" in value
+        && "options" in value;
+}
+function resolveEntry(value) {
+    if (typeof value === "function") {
+        return { kind: "task", run: value };
+    }
+    if (isMenuDefinition(value)) {
+        return { kind: "menu", menu: value };
+    }
+    if (value && typeof value === "object") {
+        const wrapped = value;
+        if (wrapped.menu) {
+            return { kind: "menu", menu: wrapped.menu, selector: wrapped.selector };
+        }
+        if (typeof wrapped.action === "function") {
+            return {
+                kind: "task",
+                run: wrapped.action,
+                selector: wrapped.selector,
+                onSuccess: wrapped.onSuccess,
+                onError: wrapped.onError
+            };
+        }
+    }
+    throw new Error(`Item de menú inválido: ${JSON.stringify(value)}`);
+}
+function normalizeFlagName(flagSelector) {
+    return flagSelector.replace(/^--?/, "");
+}
+function errorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    const execError = error;
+    return execError?.stderr ?? execError?.stdout ?? String(error);
+}
+class Menu {
+    /**
+     * Ejecuta un item ya resuelto: si es una task, la corre, guarda su
+     * resultado en `ctx.results[label]`, dispara `onSuccess`/`onError`
+     * propios del item (si se pasaron) y reporta el resultado al
+     * `ctx.notifier` (clasificación por área de TI + canales). Si es un
+     * submenú, simplemente lo renderiza (y así hereda su propio manejo de
+     * flag-selector/hooks).
+     */
+    static async executeEntry(entry, label, ctx) {
+        if (entry.kind === "menu" && entry.menu) {
+            return Menu.render(entry.menu, ctx);
+        }
+        if (entry.kind === "task" && entry.run) {
+            try {
+                const result = await entry.run(ctx);
+                ctx.results[label] = result;
+                await entry.onSuccess?.(result, ctx);
+                await ctx.notifier.reportSuccess(label, result, ctx);
+            }
+            catch (error) {
+                await entry.onError?.(error, ctx);
+                await ctx.notifier.reportError(label, error, ctx);
+                logger_1.logger.error(errorMessage(error));
+                if (ctx.params.catch === "throw" || ctx.flags.catch === "throw")
+                    throw error;
+            }
+            return;
+        }
+        logger_1.logger.warn(`Opción "${label}" no tiene acción definida.`);
+    }
+    /**
+     * Renderiza un menú. Si `definition["flag-selector"]` está presente y el
+     * Context trae un param que matchea el `selector` de alguno de los
+     * items, esa opción se ejecuta automáticamente sin pedir input al
+     * usuario (y, si es un submenú, este a su vez revisa su propio
+     * "flag-selector", permitiendo encadenar varios niveles).
+     */
+    static async render(definition, ctx) {
+        const activeCtx = ctx ?? Context_1.Context.current();
+        const { title, options } = definition;
+        const flagSelector = definition["flag-selector"];
+        if (flagSelector) {
+            const flagKey = normalizeFlagName(flagSelector);
+            const wantedValue = activeCtx.params[flagKey];
+            if (wantedValue !== undefined) {
+                const match = Object.entries(options).find(([, value]) => {
+                    try {
+                        return resolveEntry(value).selector === wantedValue;
+                    }
+                    catch {
+                        return false;
+                    }
+                });
+                if (match) {
+                    const [label, value] = match;
+                    const entry = resolveEntry(value);
+                    logger_1.logger.info(`Selector automático: "${label}" (${flagSelector}=${wantedValue})`);
+                    return Menu.executeEntry(entry, label, activeCtx);
+                }
+                logger_1.logger.warn(`Ningún item de "${title}" coincide con ${flagSelector}=${wantedValue}; se muestra el menú interactivo.`);
+            }
+        }
+        const labels = Object.keys(options);
+        labels.push("Salir");
+        while (true) {
+            const choiceKey = await prompt.select(title, labels);
+            const label = labels[Number(choiceKey)];
+            if (label === "Salir") {
+                return exports.EXIT;
+            }
+            const entry = resolveEntry(options[label]);
+            const result = await Menu.executeEntry(entry, label, activeCtx);
+            if (result === exports.EXIT)
+                continue;
+        }
+    }
+}
+exports.Menu = Menu;
+Menu.EXIT = exports.EXIT;
+//# sourceMappingURL=Menu.js.map

package/dist/core/Menu.js.map

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

package/dist/core/Notifier.d.ts

@@ -0,0 +1,42 @@
+import type { Context } from "./Context";
+import type { ErrorClassifier, ErrorMessageFormatter, Sender } from "./types";
+export declare class Notifier {
+    private classifiers;
+    private messageFormatters;
+    private channels;
+    private successSenders;
+    private defaultArea;
+    /**
+     * 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: ErrorClassifier): 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: ErrorMessageFormatter): this;
+    setDefaultArea(area: string): 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: string, ...senders: Sender[]): this;
+    /** Senders que se disparan en cada tarea exitosa, sin clasificación. */
+    onSuccess(...senders: Sender[]): this;
+    private resolveArea;
+    private resolveMessage;
+    reportSuccess(taskId: string, result: unknown, ctx: Context): Promise<void>;
+    reportError(taskId: string, error: unknown, ctx: Context): Promise<string>;
+}