alegra-data-agent 0.1.0

package/dist/commands/install.js

@@ -0,0 +1,274 @@
+import { AuthRequiredError } from "../api.js";
+import { hasAuth, readAuth } from "../auth.js";
+import { installAll } from "../installer.js";
+import { bold, cyan, dim, gray, green, log, logError, red, yellow } from "../colors.js";
+import { COMMAND_NAME, formatBytes, getClaudeSkillsDir, getPackageVersion } from "../lib.js";
+import { runHookInstall } from "./hook.js";
+import { runLogin } from "./login.js";
+const BANNER_WIDTH = 58;
+const SHORT_DESCRIPTIONS = {
+    "alegra-bi": "Router principal de BI",
+    "alegra-sales": "New logos, MRR, deals, funnel, cuota",
+    "alegra-accountant": "Programa Contadores, FC 2.0, halo",
+    "alegra-growth": "Signups, MQL/PQL/SQL, conversión",
+    "alegra-ce-universe": "CHS, churn, retención, voice of customer",
+    "alegra-producto": "Métricas SaaS — MRR, ARPA, churn rate",
+    "alegra-strategic": "MRR walk, cross-sell, upsell, pricing",
+    "alanube": "Tablas Alanube en Redshift",
+};
+function padToWidth(text, visibleLen, width) {
+    const pad = Math.max(0, width - visibleLen);
+    return text + " ".repeat(pad);
+}
+function fancyBanner() {
+    const v = getPackageVersion();
+    const innerWidth = BANNER_WIDTH - 2;
+    const nameLen = COMMAND_NAME.length;
+    const versionLen = `v${v}`.length;
+    const spacesBetween = Math.max(1, innerWidth - 4 - nameLen - versionLen);
+    const line1 = "   " +
+        bold(COMMAND_NAME) +
+        " ".repeat(spacesBetween) +
+        dim(`v${v}`);
+    const line1PadCount = nameLen + spacesBetween + versionLen + 3;
+    const line2Plain = "   Agente de Data · Alegra";
+    const line2 = "   " + gray("Agente de Data · Alegra");
+    const emptyPad = innerWidth + 2;
+    log("");
+    log("  " + cyan("╔" + "═".repeat(BANNER_WIDTH) + "╗"));
+    log("  " + cyan("║") + " ".repeat(emptyPad) + cyan("║"));
+    log("  " + cyan("║") + padToWidth(line1, line1PadCount, innerWidth + 2) + cyan("║"));
+    log("  " + cyan("║") + padToWidth(line2, line2Plain.length, innerWidth + 2) + cyan("║"));
+    log("  " + cyan("║") + " ".repeat(emptyPad) + cyan("║"));
+    log("  " + cyan("╚" + "═".repeat(BANNER_WIDTH) + "╝"));
+    log("");
+}
+function section(title) {
+    log(cyan("▶ ") + bold(title));
+    log("");
+}
+function shortDesc(name, manifestDesc) {
+    const handPicked = SHORT_DESCRIPTIONS[name];
+    if (handPicked)
+        return handPicked;
+    const oneLine = manifestDesc.split(/\.|\n/)[0].trim();
+    return oneLine.length > 55 ? oneLine.slice(0, 54) + "…" : oneLine;
+}
+function printResultRow(result, manifest) {
+    const isSkill = result.kind === "skill";
+    const entry = isSkill ? manifest.skills[result.name] : manifest.mcps?.[result.name];
+    const desc = isSkill
+        ? entry
+            ? shortDesc(result.name, entry.description)
+            : ""
+        : entry?.description ?? "MCP server";
+    let icon;
+    switch (result.status) {
+        case "installed":
+            icon = green("✓");
+            break;
+        case "updated":
+            icon = green("↻");
+            break;
+        case "unchanged":
+            icon = gray("·");
+            break;
+        case "skipped":
+            icon = yellow("-");
+            break;
+        case "failed":
+            icon = red("✗");
+            break;
+    }
+    const kindBadge = isSkill ? "" : dim("[mcp] ");
+    const padName = result.name.padEnd(22);
+    log(`   ${icon} ${kindBadge}${bold(padName)} ${gray("· " + desc)}`);
+}
+function printSummary(results, manifest) {
+    const installed = results.filter((r) => r.status === "installed").length;
+    const updated = results.filter((r) => r.status === "updated").length;
+    const unchanged = results.filter((r) => r.status === "unchanged").length;
+    const failed = results.filter((r) => r.status === "failed").length;
+    const skipped = results.filter((r) => r.status === "skipped").length;
+    let totalBytes = 0;
+    let totalFiles = 0;
+    for (const r of results) {
+        if (r.kind !== "skill")
+            continue;
+        const e = manifest.skills[r.name];
+        if (e && r.status !== "failed" && r.status !== "skipped") {
+            totalBytes += e.bytes;
+            totalFiles += e.files.length;
+        }
+    }
+    log("");
+    section("Resumen");
+    const parts = [];
+    if (installed > 0)
+        parts.push(green(`${installed} instaladas`));
+    if (updated > 0)
+        parts.push(green(`${updated} actualizadas`));
+    if (unchanged > 0)
+        parts.push(gray(`${unchanged} sin cambios`));
+    if (skipped > 0)
+        parts.push(yellow(`${skipped} omitidas`));
+    if (failed > 0)
+        parts.push(red(`${failed} fallidas`));
+    log("   " +
+        green("✓") +
+        " " +
+        bold(parts.join(gray(" · "))) +
+        gray(`  ·  ${totalFiles} archivos · ${formatBytes(totalBytes)}`));
+    log("   " + green("✓") + " " + gray("destino:") + " " + getClaudeSkillsDir());
+    log("");
+    for (const r of results.filter((x) => x.status === "failed")) {
+        logError(`${r.name}: ${r.error}`);
+    }
+}
+function printNextSteps(noHook) {
+    section("Siguientes pasos");
+    log("   " + bold(yellow("→  Reinicia Claude Code para activar las skills")));
+    log("");
+    log("   " + dim("Comandos útiles:"));
+    log(`     ${dim("$")} ${bold(`${COMMAND_NAME} list`)}      ${gray("ver skills disponibles")}`);
+    log(`     ${dim("$")} ${bold(`${COMMAND_NAME} status`)}    ${gray("estado actual + drift")}`);
+    log(`     ${dim("$")} ${bold(`${COMMAND_NAME} update`)}    ${gray("actualizar a la última")}`);
+    log(`     ${dim("$")} ${bold(`${COMMAND_NAME} whoami`)}    ${gray("cuenta autenticada")}`);
+    if (!noHook) {
+        log(`     ${dim("$")} ${bold(`${COMMAND_NAME} hook uninstall`)}  ${gray("apagar aviso")}`);
+    }
+    log("");
+    log("   " +
+        dim("Docs · ") +
+        cyan("github.com/alegradev/alegra-data-agent"));
+    log("");
+}
+function isClaudeCode() {
+    return process.env.CLAUDECODE === "1" || process.env.CLAUDE_CODE === "1";
+}
+export async function runInstall(opts = {}) {
+    const compact = isClaudeCode();
+    if (!compact)
+        fancyBanner();
+    if (!hasAuth()) {
+        if (!compact)
+            log(dim("  No hay sesión activa. Inicio el flow de login antes de instalar.\n"));
+        const code = await runLogin({});
+        if (code !== 0)
+            return code;
+    }
+    const auth = readAuth();
+    if (auth && !compact) {
+        section("Cuenta autorizada");
+        log("   " + green("✓") + " " + bold(auth.email));
+        log("");
+    }
+    if (opts.dryRun) {
+        log(dim("  Modo dry-run: no se modificará nada.\n"));
+    }
+    if (!compact) {
+        section("Descargando skills del gateway");
+    }
+    let result;
+    try {
+        result = await installAll({
+            dryRun: opts.dryRun,
+            force: opts.force,
+            only: opts.only,
+            targets: opts.targets,
+        });
+    }
+    catch (err) {
+        if (err instanceof AuthRequiredError) {
+            logError(err.message);
+            log(dim(`  Corre: ${COMMAND_NAME} login`));
+            return 2;
+        }
+        const msg = err instanceof Error ? err.message : String(err);
+        logError(msg);
+        if (msg.includes("EACCES") || msg.includes("permission denied")) {
+            log(dim(`  Sin permisos para escribir. Verifica permisos de ~/.claude/skills/`));
+        }
+        else if (msg.includes("ENOSPC") || msg.includes("no space")) {
+            log(dim(`  No hay espacio en disco. Libera espacio y reintenta.`));
+        }
+        else if (msg.includes("network") || msg.includes("ENOTFOUND") || msg.includes("ECONNREFUSED")) {
+            log(dim(`  Verifica tu conexión a internet y el estado del gateway.`));
+        }
+        return 1;
+    }
+    if ("error" in result) {
+        logError(result.error);
+        return 1;
+    }
+    if (compact) {
+        printCompactSummary(result.results, result.manifest, auth?.email);
+    }
+    else {
+        for (const r of result.results) {
+            printResultRow(r, result.manifest);
+        }
+        printSummary(result.results, result.manifest);
+    }
+    const hasFails = result.results.some((r) => r.status === "failed");
+    if (hasFails)
+        return 1;
+    if (opts.dryRun)
+        return 0;
+    if (!opts.noHook) {
+        if (!compact)
+            log("  " + gray("Instalando hook de notificaciones…"));
+        runHookInstall(opts.hookMode ?? "check");
+        if (!compact)
+            log("");
+    }
+    if (!compact) {
+        printNextSteps(opts.noHook ?? false);
+    }
+    return 0;
+}
+function printCompactSummary(results, manifest, email) {
+    const ok = results.filter((r) => r.status === "installed" || r.status === "updated" || r.status === "unchanged");
+    const failed = results.filter((r) => r.status === "failed");
+    const installed = results.filter((r) => r.status === "installed").length;
+    const updated = results.filter((r) => r.status === "updated").length;
+    const unchanged = results.filter((r) => r.status === "unchanged").length;
+    let totalBytes = 0;
+    let totalFiles = 0;
+    const skillOks = ok.filter((r) => r.kind === "skill");
+    const mcpOks = ok.filter((r) => r.kind === "mcp");
+    for (const r of skillOks) {
+        const e = manifest.skills[r.name];
+        if (e) {
+            totalBytes += e.bytes;
+            totalFiles += e.files.length;
+        }
+    }
+    const verbo = updated > 0 && installed === 0 ? "actualizadas" : "instaladas";
+    const skillList = skillOks.map((r) => r.name).sort().join(", ");
+    const userPart = email ? gray(` · ${email}`) : "";
+    log("");
+    log("  " +
+        green("✓") +
+        " " +
+        bold(`${skillOks.length} skills + ${mcpOks.length} MCPs ${verbo}`) +
+        gray(`  ·  ${totalFiles} archivos · ${formatBytes(totalBytes)}`) +
+        userPart);
+    if (skillList)
+        log("  " + gray("skills: ") + gray(skillList));
+    if (mcpOks.length > 0)
+        log("  " + gray("mcps:   ") + gray(mcpOks.map((r) => r.name).sort().join(", ")));
+    log("  " +
+        gray("destino:") +
+        " " +
+        cyan(getClaudeSkillsDir()) +
+        gray("  ·  ") +
+        bold(yellow("reinicia tu cliente para activarlas")));
+    if (unchanged > 0 && installed === 0 && updated === 0) {
+        log("  " + dim(`(${unchanged} sin cambios desde la última instalación)`));
+    }
+    log("");
+    for (const r of failed) {
+        logError(`${r.name}: ${r.error}`);
+    }
+}

package/dist/commands/list.js

@@ -0,0 +1,44 @@
+import { AuthRequiredError, fetchManifest } from "../api.js";
+import { readLockFile, formatBytes } from "../lib.js";
+import { bold, cyan, dim, gray, green, log, logError, yellow } from "../colors.js";
+export async function runList() {
+    let manifest;
+    try {
+        manifest = await fetchManifest();
+    }
+    catch (err) {
+        if (err instanceof AuthRequiredError) {
+            logError(err.message);
+            return 2;
+        }
+        logError(err instanceof Error ? err.message : String(err));
+        return 1;
+    }
+    if (!manifest) {
+        logError("No se pudo cargar el manifest del gateway.");
+        return 1;
+    }
+    const lock = readLockFile();
+    log("");
+    log(bold(cyan("  Skills disponibles")) + dim(` — ${Object.keys(manifest.skills).length} totales`));
+    log(gray("  " + "─".repeat(70)));
+    const names = Object.keys(manifest.skills).sort();
+    for (const name of names) {
+        const entry = manifest.skills[name];
+        const installed = lock.skills[name];
+        const sameHash = installed?.bundleHash === entry.bundleHash;
+        let badge;
+        if (!installed)
+            badge = gray("[no instalada]");
+        else if (sameHash)
+            badge = green("[instalada]   ");
+        else
+            badge = yellow("[actualizar]  ");
+        const team = entry.team ? gray(` ${entry.team}`) : "";
+        log(`  ${badge} ${bold(name)}${team}  ${dim(formatBytes(entry.bytes))}`);
+        const desc = entry.description.length > 200 ? entry.description.slice(0, 200) + "…" : entry.description;
+        log(gray(`     ${desc}`));
+        log("");
+    }
+    return 0;
+}

package/dist/commands/login.js

@@ -0,0 +1,31 @@
+import { performBrowserLogin, readAuth, writeAuth } from "../auth.js";
+import { banner } from "../ui.js";
+import { bold, dim, green, log, logError } from "../colors.js";
+import { GATEWAY_URL, getAuthFilePath } from "../lib.js";
+export async function runLogin(opts = {}) {
+    banner();
+    if (!opts.force) {
+        const existing = readAuth();
+        if (existing) {
+            log(`  ${green("✓")} Ya estás autenticado como ${bold(existing.email)}.`);
+            log(dim(`     Token: ${getAuthFilePath()}`));
+            log(dim(`     Para volver a iniciar sesión: --force`));
+            log("");
+            return 0;
+        }
+    }
+    log(`  Gateway: ${dim(GATEWAY_URL)}`);
+    try {
+        const record = await performBrowserLogin();
+        writeAuth(record);
+        log("");
+        log(`  ${green("✓")} Autenticado como ${bold(record.email)}.`);
+        log(dim(`     Token guardado en: ${getAuthFilePath()}`));
+        log("");
+        return 0;
+    }
+    catch (err) {
+        logError(err instanceof Error ? err.message : String(err));
+        return 1;
+    }
+}

package/dist/commands/logout.js

@@ -0,0 +1,13 @@
+import { clearAuth, readAuth } from "../auth.js";
+import { dim, log, logOk, logWarn } from "../colors.js";
+export function runLogout() {
+    const existing = readAuth();
+    if (!existing) {
+        logWarn("No hay sesión activa.");
+        return 0;
+    }
+    clearAuth();
+    logOk(`Sesión cerrada (${existing.email}).`);
+    log(dim("  Tus skills instaladas no se eliminan. Para borrarlas: uninstall."));
+    return 0;
+}

package/dist/commands/status.js

@@ -0,0 +1,61 @@
+import { AuthRequiredError, fetchManifest } from "../api.js";
+import { readAuth } from "../auth.js";
+import { detectDrift } from "../installer.js";
+import { COMMAND_NAME, GATEWAY_URL, getClaudeSkillsDir, getLockFilePath, getPackageVersion, readLockFile, } from "../lib.js";
+import { bold, cyan, dim, gray, green, log, logError, logWarn, yellow } from "../colors.js";
+export async function runStatus() {
+    const auth = readAuth();
+    log("");
+    log(bold(cyan("  Estado")));
+    log(gray("  " + "─".repeat(70)));
+    log(`  ${gray("Paquete:")}        ${bold(COMMAND_NAME)} v${getPackageVersion()}`);
+    log(`  ${gray("Gateway:")}        ${GATEWAY_URL}`);
+    log(`  ${gray("Autenticado:")}    ${auth ? green(auth.email) : gray("no")}`);
+    log(`  ${gray("Destino:")}        ${getClaudeSkillsDir()}`);
+    log(`  ${gray("Lock file:")}      ${getLockFilePath()}`);
+    log("");
+    if (!auth) {
+        logWarn(`Inicia sesión con: ${bold(`${COMMAND_NAME} login`)}`);
+        log("");
+        return 0;
+    }
+    let manifest;
+    try {
+        manifest = await fetchManifest();
+    }
+    catch (err) {
+        if (err instanceof AuthRequiredError) {
+            logError(err.message);
+            return 2;
+        }
+        logError(err instanceof Error ? err.message : String(err));
+        return 1;
+    }
+    if (!manifest) {
+        logError("No se pudo cargar el manifest.");
+        return 1;
+    }
+    const lock = readLockFile();
+    const drift = detectDrift(manifest);
+    log(bold("  Skills:"));
+    log(`    ${green("✓")} ${drift.unchanged.length} al día`);
+    if (drift.toInstall.length > 0)
+        log(`    ${cyan("+")} ${drift.toInstall.length} nuevas disponibles: ${drift.toInstall.join(", ")}`);
+    if (drift.toUpdate.length > 0)
+        log(`    ${yellow("↻")} ${drift.toUpdate.length} con actualización: ${drift.toUpdate.join(", ")}`);
+    if (drift.orphaned.length > 0)
+        log(`    ${dim("·")} ${drift.orphaned.length} huérfanas: ${drift.orphaned.join(", ")}`);
+    log("");
+    const total = drift.toInstall.length + drift.toUpdate.length;
+    if (total > 0) {
+        logWarn(`Hay ${total} skill(s) por actualizar. Corre: ${bold(`${COMMAND_NAME} update`)}`);
+    }
+    else if (Object.keys(lock.skills).length === 0) {
+        logWarn(`Aún no hay skills instaladas. Corre: ${bold(`${COMMAND_NAME} install`)}`);
+    }
+    else {
+        log(`  ${green("Todo al día.")}`);
+    }
+    log("");
+    return 0;
+}

package/dist/commands/uninstall.js

@@ -0,0 +1,28 @@
+import { uninstallAll } from "../installer.js";
+import { readLockFile } from "../lib.js";
+import { banner, confirm } from "../ui.js";
+import { dim, gray, log, logOk, logWarn, red } from "../colors.js";
+export async function runUninstall(opts = {}) {
+    banner();
+    const lock = readLockFile();
+    const skills = Object.keys(lock.skills);
+    if (skills.length === 0) {
+        logWarn("No hay skills instaladas por este paquete.");
+        return 0;
+    }
+    log(red(`  Vas a eliminar ${skills.length} skill(s):`));
+    for (const s of skills)
+        log(gray(`    - ${s}`));
+    log("");
+    if (!opts.yes && !opts.dryRun) {
+        const ok = await confirm("¿Continuar?", false);
+        if (!ok) {
+            log(dim("  Cancelado."));
+            return 0;
+        }
+    }
+    const results = uninstallAll({ dryRun: opts.dryRun });
+    log("");
+    logOk(`${results.length} skill(s) eliminadas.`);
+    return 0;
+}

package/dist/commands/update.js

@@ -0,0 +1,56 @@
+import { AuthRequiredError, fetchManifest } from "../api.js";
+import { detectDrift, installAll, summarize } from "../installer.js";
+import { banner } from "../ui.js";
+import { cyan, dim, gray, green, log, logError, yellow } from "../colors.js";
+export async function runUpdate(opts = {}) {
+    banner();
+    let manifest;
+    try {
+        manifest = await fetchManifest();
+    }
+    catch (err) {
+        if (err instanceof AuthRequiredError) {
+            logError(err.message);
+            return 2;
+        }
+        logError(err instanceof Error ? err.message : String(err));
+        return 1;
+    }
+    if (!manifest) {
+        logError("No se pudo cargar el manifest.");
+        return 1;
+    }
+    const drift = detectDrift(manifest);
+    const pending = [
+        ...drift.toInstall,
+        ...drift.toUpdate,
+        ...drift.mcps.toInstall,
+        ...drift.mcps.toUpdate,
+    ];
+    if (pending.length === 0) {
+        log(green("  ✓ Todo al día (skills + MCPs).\n"));
+        return 0;
+    }
+    log(cyan(`  → ${pending.length} elemento(s) por actualizar:\n`));
+    for (const name of drift.toInstall)
+        log(`    ${cyan("+")} ${name} ${gray("(skill nueva)")}`);
+    for (const name of drift.toUpdate)
+        log(`    ${yellow("↻")} ${name} ${gray("(skill nueva versión)")}`);
+    for (const name of drift.mcps.toInstall)
+        log(`    ${cyan("+")} ${name} ${gray("(MCP nuevo)")}`);
+    for (const name of drift.mcps.toUpdate)
+        log(`    ${yellow("↻")} ${name} ${gray("(MCP actualizado)")}`);
+    log("");
+    if (opts.dryRun) {
+        log(dim("  Modo dry-run: no se modificará nada.\n"));
+        return 0;
+    }
+    const result = await installAll({ only: pending, targets: opts.targets, force: true });
+    if ("error" in result) {
+        logError(result.error);
+        return 1;
+    }
+    summarize(result.results);
+    const failed = result.results.some((r) => r.status === "failed");
+    return failed ? 1 : 0;
+}

package/dist/commands/whoami.js

@@ -0,0 +1,16 @@
+import { readAuth } from "../auth.js";
+import { bold, dim, log, logWarn } from "../colors.js";
+import { COMMAND_NAME, getAuthFilePath } from "../lib.js";
+export function runWhoami() {
+    const auth = readAuth();
+    if (!auth) {
+        logWarn(`No autenticado. Corre: ${COMMAND_NAME} login`);
+        return 1;
+    }
+    log("");
+    log(`  ${bold(auth.email)}`);
+    log(dim(`  Conectado desde: ${auth.obtainedAt}`));
+    log(dim(`  Token en: ${getAuthFilePath()}`));
+    log("");
+    return 0;
+}