gigstack 0.1.0

package/dist/cli.mjs

@@ -0,0 +1,3068 @@
+#!/usr/bin/env node
+import{createRequire}from'module';const require=createRequire(import.meta.url);
+
+// src/cli.ts
+import { Command } from "commander";
+import pc15 from "picocolors";
+
+// src/output.ts
+import pc from "picocolors";
+var jsonMode = false;
+function setJsonMode(enabled) {
+  jsonMode = enabled;
+}
+function isJsonMode() {
+  return jsonMode;
+}
+function printJson(data) {
+  console.log(JSON.stringify(data, null, 2));
+}
+function printTable(rows, columns) {
+  if (jsonMode) return printJson(rows);
+  if (rows.length === 0) {
+    console.log(pc.dim("Sin resultados"));
+    return;
+  }
+  const cols = columns || Object.keys(rows[0]);
+  const widths = cols.map(
+    (c) => Math.max(c.length, ...rows.map((r) => String(r[c] ?? "").length))
+  );
+  const header = cols.map((c, i) => pc.bold(c.padEnd(widths[i]))).join("  ");
+  const separator = widths.map((w) => "\u2500".repeat(w)).join("\u2500\u2500");
+  console.log(header);
+  console.log(pc.dim(separator));
+  for (const row of rows) {
+    console.log(cols.map((c, i) => String(row[c] ?? "").padEnd(widths[i])).join("  "));
+  }
+}
+function printKeyValue(data) {
+  if (jsonMode) return printJson(data);
+  const maxKey = Math.max(...Object.keys(data).map((k) => k.length));
+  for (const [k, v] of Object.entries(data)) {
+    console.log(`${pc.bold(k.padEnd(maxKey))}  ${v}`);
+  }
+}
+function success(msg) {
+  console.log(pc.green(`\u2713 ${msg}`));
+}
+function error(msg) {
+  console.error(pc.red(`\u2717 ${msg}`));
+}
+function warn(msg) {
+  console.log(pc.yellow(`! ${msg}`));
+}
+function formatMoney(amount, currency = "MXN") {
+  return `$${(amount || 0).toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })} ${currency.toUpperCase()}`;
+}
+var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+function spinner(message) {
+  if (jsonMode) return { stop() {
+  } };
+  let i = 0;
+  const stream = process.stderr;
+  const interval = setInterval(() => {
+    stream.write(`\r${pc.cyan(SPINNER_FRAMES[i++ % SPINNER_FRAMES.length])} ${pc.dim(message)}`);
+  }, 80);
+  return {
+    stop(finalMessage) {
+      clearInterval(interval);
+      stream.write("\r" + " ".repeat(message.length + 4) + "\r");
+      if (finalMessage) stream.write(finalMessage + "\n");
+    }
+  };
+}
+async function spin(message, fn) {
+  const s = spinner(message);
+  try {
+    const result = await fn();
+    s.stop();
+    return result;
+  } catch (e) {
+    s.stop();
+    throw e;
+  }
+}
+function formatDate(val) {
+  if (!val) return "\u2014";
+  if (typeof val === "string") return val.slice(0, 10);
+  if (typeof val === "number") {
+    const ms = val > 1e12 ? val : val * 1e3;
+    return new Date(ms).toISOString().slice(0, 10);
+  }
+  if (val._seconds) return new Date(val._seconds * 1e3).toISOString().slice(0, 10);
+  if (val.seconds) return new Date(val.seconds * 1e3).toISOString().slice(0, 10);
+  if (val instanceof Date) return val.toISOString().slice(0, 10);
+  return String(val);
+}
+
+// src/commands/auth.ts
+import pc4 from "picocolors";
+
+// src/config.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+var CONFIG_DIR = join(homedir(), ".config", "gigstack");
+var CREDENTIALS_FILE = join(CONFIG_DIR, "credentials.json");
+function ensureConfigDir() {
+  if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true, mode: 448 });
+  }
+}
+function readCredentials() {
+  if (!existsSync(CREDENTIALS_FILE)) return null;
+  try {
+    return JSON.parse(readFileSync(CREDENTIALS_FILE, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function writeCredentials(creds) {
+  ensureConfigDir();
+  writeFileSync(CREDENTIALS_FILE, JSON.stringify(creds, null, 2), { mode: 384 });
+}
+function saveProfile(name, apiKey, environment) {
+  const creds = readCredentials() || { profiles: {}, activeProfile: name };
+  creds.profiles[name] = { apiKey, environment };
+  creds.activeProfile = name;
+  writeCredentials(creds);
+}
+function removeProfile(name) {
+  const creds = readCredentials();
+  if (!creds) return;
+  delete creds.profiles[name];
+  if (creds.activeProfile === name) {
+    creds.activeProfile = Object.keys(creds.profiles)[0] || "";
+  }
+  writeCredentials(creds);
+}
+function switchProfile(name) {
+  const creds = readCredentials();
+  if (!creds || !creds.profiles[name]) return false;
+  creds.activeProfile = name;
+  writeCredentials(creds);
+  return true;
+}
+function getActiveProfile() {
+  const envKey = process.env.GIGSTACK_API_KEY;
+  if (envKey) return { name: "env", apiKey: envKey, environment: "production" };
+  const creds = readCredentials();
+  if (!creds || !creds.activeProfile || !creds.profiles[creds.activeProfile]) return null;
+  return { name: creds.activeProfile, ...creds.profiles[creds.activeProfile] };
+}
+function parseJwtPayload(apiKey) {
+  try {
+    const parts = apiKey.split(".");
+    if (parts.length === 3) {
+      return JSON.parse(Buffer.from(parts[1], "base64").toString());
+    }
+  } catch {
+  }
+  return null;
+}
+function isTestKey(apiKey) {
+  if (apiKey.startsWith("sk_test")) return true;
+  const payload = parseJwtPayload(apiKey);
+  if (payload) {
+    if (payload.livemode === false) return true;
+    if (payload.key_id?.includes("test")) return true;
+  }
+  return false;
+}
+function getTeamFromKey(apiKey) {
+  const payload = parseJwtPayload(apiKey);
+  return payload?.team || null;
+}
+function listProfiles() {
+  const creds = readCredentials();
+  if (!creds) return [];
+  return Object.keys(creds.profiles).map((name) => ({
+    name,
+    active: name === creds.activeProfile
+  }));
+}
+
+// src/api.ts
+import pc2 from "picocolors";
+var BASE_URL = "https://api.gigstack.io/v2";
+var ApiError = class extends Error {
+  constructor(status, body) {
+    const detail = body?.error?.message || body?.error || "";
+    const msg = body?.message || `API error ${status}`;
+    super(detail ? `${msg}: ${typeof detail === "string" ? detail : JSON.stringify(detail)}` : msg);
+    this.status = status;
+    this.body = body;
+  }
+};
+function getApiKey(override) {
+  if (override) return override;
+  const profile = getActiveProfile();
+  if (!profile) {
+    console.error(pc2.red("No autenticado. Ejecuta: gigstack login"));
+    process.exit(1);
+  }
+  return profile.apiKey;
+}
+async function api(method, path, opts) {
+  const apiKey = getApiKey(opts?.apiKey);
+  const url = new URL(`${BASE_URL}${path}`);
+  if (opts?.query) {
+    for (const [k, v] of Object.entries(opts.query)) {
+      if (v !== void 0) url.searchParams.set(k, v);
+    }
+  }
+  if (opts?.team) url.searchParams.set("team", opts.team);
+  let res;
+  try {
+    res = await fetch(url.toString(), {
+      method,
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+        "Content-Type": "application/json"
+      },
+      body: opts?.body ? JSON.stringify(opts.body) : void 0
+    });
+  } catch (e) {
+    if (e.code === "ENOTFOUND" || e.cause?.code === "ENOTFOUND") {
+      throw new Error("Sin conexi\xF3n a internet. Verifica tu red.");
+    }
+    throw new Error(`Error de conexi\xF3n: ${e.message}`);
+  }
+  const data = await res.json();
+  if (!res.ok) {
+    throw new ApiError(res.status, data);
+  }
+  return data;
+}
+async function resolveTeam(apiKey) {
+  const key = apiKey || getApiKey();
+  const jwtTeamId = getTeamFromKey(key);
+  if (jwtTeamId) {
+    try {
+      const res2 = await api("GET", `/teams/${jwtTeamId}`, { apiKey: key });
+      if (res2.data) return res2.data;
+    } catch {
+    }
+  }
+  const res = await api("GET", "/teams", { apiKey: key });
+  const teams = res.data || [];
+  if (jwtTeamId) {
+    const match = teams.find((t) => t.id === jwtTeamId);
+    if (match) return match;
+  }
+  return teams[0] || null;
+}
+
+// src/prompt.ts
+import { createInterface } from "node:readline";
+import pc3 from "picocolors";
+var rl = () => createInterface({ input: process.stdin, output: process.stdout });
+function ask(question, defaultVal) {
+  const suffix = defaultVal ? pc3.dim(` (${defaultVal})`) : "";
+  return new Promise((resolve) => {
+    const r = rl();
+    r.question(`${pc3.bold(question)}${suffix}: `, (answer) => {
+      r.close();
+      resolve(answer.trim() || defaultVal || "");
+    });
+  });
+}
+function askRequired(question) {
+  return new Promise(async (resolve) => {
+    let val = "";
+    while (!val) {
+      val = await ask(question);
+      if (!val) console.log(pc3.red("  Campo requerido"));
+    }
+    resolve(val);
+  });
+}
+function askHidden(question) {
+  return new Promise((resolve) => {
+    const r = rl();
+    process.stdout.write(`${pc3.bold(question)}: `);
+    if (process.stdin.setRawMode) {
+      process.stdin.setRawMode(true);
+      process.stdin.resume();
+      let input = "";
+      const onData = (ch) => {
+        const c = ch.toString();
+        if (c === "\n" || c === "\r") {
+          process.stdin.setRawMode(false);
+          process.stdin.removeListener("data", onData);
+          process.stdout.write("\n");
+          r.close();
+          resolve(input.trim());
+        } else if (c === "\x7F" || c === "\b") {
+          input = input.slice(0, -1);
+        } else if (c === "") {
+          process.exit(0);
+        } else {
+          input += c;
+        }
+      };
+      process.stdin.on("data", onData);
+    } else {
+      r.question("", (answer) => {
+        r.close();
+        resolve(answer.trim());
+      });
+    }
+  });
+}
+async function select(question, options) {
+  console.log(pc3.bold(question));
+  options.forEach((o, i) => console.log(`  ${pc3.dim(`${i + 1})`)} ${o.label}`));
+  const answer = await ask("Selecciona", "1");
+  const idx = parseInt(answer) - 1;
+  if (idx >= 0 && idx < options.length) return options[idx].value;
+  const match = options.find((o) => o.value === answer || o.label.toLowerCase().includes(answer.toLowerCase()));
+  return match?.value || options[0].value;
+}
+async function confirm(question, defaultVal = true) {
+  const hint = defaultVal ? "S/n" : "s/N";
+  const answer = await ask(`${question} (${hint})`);
+  if (!answer) return defaultVal;
+  return answer.toLowerCase().startsWith("s") || answer.toLowerCase().startsWith("y");
+}
+
+// src/commands/auth.ts
+function registerAuthCommands(program2) {
+  program2.command("login").description("Autenticarse con tu API key de gigstack").option("-k, --api-key <key>", "API key (o se pedir\xE1 interactivamente)").option("-p, --profile <name>", "Nombre del perfil", "default").action(async (opts) => {
+    let apiKey = opts.apiKey || process.env.GIGSTACK_API_KEY;
+    if (!apiKey) {
+      console.log(pc4.dim("Obt\xE9n tu API key en: app.gigstack.pro/settings \u2192 API\n"));
+      apiKey = await askHidden("API Key");
+    }
+    if (!apiKey) {
+      error("API key requerida");
+      process.exit(1);
+    }
+    try {
+      const team = await resolveTeam(apiKey);
+      const isTest = isTestKey(apiKey);
+      saveProfile(opts.profile, apiKey, isTest ? "test" : "production");
+      success(`Autenticado como ${pc4.bold(team?.legal_name || team?.brand?.alias || "equipo gigstack")}`);
+      if (isTest) console.log(pc4.yellow("  Modo prueba (test key)"));
+      console.log(pc4.dim(`  Perfil "${opts.profile}" guardado en ~/.config/gigstack/credentials.json`));
+    } catch (e) {
+      error(`Error de autenticaci\xF3n: ${e.message}`);
+      process.exit(1);
+    }
+  });
+  program2.command("logout").description("Eliminar credenciales").option("-p, --profile <name>", "Perfil a eliminar", "default").action((opts) => {
+    removeProfile(opts.profile);
+    success(`Perfil "${opts.profile}" eliminado`);
+  });
+  program2.command("whoami").description("Mostrar perfil y cuenta actual").action(async () => {
+    const profile = getActiveProfile();
+    if (!profile) {
+      error("No autenticado. Ejecuta: gigstack login");
+      process.exit(1);
+    }
+    try {
+      const team = await resolveTeam();
+      printKeyValue({
+        Perfil: profile.name,
+        Modo: isTestKey(profile.apiKey) ? pc4.yellow("test") : pc4.green("producci\xF3n"),
+        RFC: team?.tax_id || pc4.dim("no configurado"),
+        Nombre: team?.legal_name || team?.brand?.alias || "\u2014",
+        SAT: team?.sat?.completed ? pc4.green("conectado") : pc4.red("no conectado"),
+        "API Key": profile.apiKey.slice(0, 12) + "..." + profile.apiKey.slice(-4)
+      });
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  program2.command("switch <profile>").description("Cambiar perfil activo").action((name) => {
+    if (switchProfile(name)) {
+      success(`Perfil activo: ${name}`);
+    } else {
+      error(`Perfil "${name}" no encontrado`);
+      const profiles = listProfiles();
+      if (profiles.length) {
+        console.log(pc4.dim("Perfiles disponibles: " + profiles.map((p) => p.name).join(", ")));
+      }
+    }
+  });
+  program2.command("profiles").description("Listar perfiles guardados").action(() => {
+    const profiles = listProfiles();
+    if (!profiles.length) {
+      console.log(pc4.dim("Sin perfiles. Ejecuta: gigstack login"));
+      return;
+    }
+    for (const p of profiles) {
+      console.log(`${p.active ? pc4.green("\u25CF") : pc4.dim("\u25CB")} ${p.name}`);
+    }
+  });
+}
+
+// src/commands/clients.ts
+import pc6 from "picocolors";
+
+// src/list-opts.ts
+import pc5 from "picocolors";
+function withListOpts(cmd) {
+  return cmd.option("-l, --limit <n>", "L\xEDmite de resultados (1-100)", "20").option("--next <token>", "Token de paginaci\xF3n (de respuesta anterior)").option("--from <date>", "Fecha inicio (YYYY-MM-DD, YYYY-MM, 30d, 7d)").option("--to <date>", "Fecha fin (YYYY-MM-DD, YYYY-MM, today)").option("--sort <dir>", "Orden: asc o desc", "desc").option("--order-by <field>", "Ordenar por: timestamp o name", "timestamp").option("--team <id>", "Team ID");
+}
+function buildListQuery(opts) {
+  const query = { limit: opts.limit };
+  if (opts.next) query.next = opts.next;
+  if (opts.sort && opts.sort !== "desc") query.sort = opts.sort;
+  if (opts.orderBy && opts.orderBy !== "timestamp") query.order_by = opts.orderBy;
+  if (opts.from || opts.to) {
+    const from = opts.from ? parseDate(opts.from) : void 0;
+    const to = opts.to ? parseDate(opts.to, true) : void 0;
+    if (from) query["created[gte]"] = String(Math.floor(new Date(from).getTime() / 1e3));
+    if (to) query["created[lte]"] = String(Math.floor((/* @__PURE__ */ new Date(to + "T23:59:59")).getTime() / 1e3));
+  }
+  return query;
+}
+function printPaginationHint(res) {
+  if (res.has_more && res.next) {
+    console.log(pc5.dim(`
+... ${res.total_results ?? "m\xE1s"} resultados. Usa --next ${res.next} para la siguiente p\xE1gina`));
+  } else if (res.has_more) {
+    console.log(pc5.dim(`
+... m\xE1s resultados disponibles`));
+  }
+}
+function parseDate(input, isEnd = false) {
+  const trimmed = input.trim().toLowerCase();
+  const relMatch = trimmed.match(/^(\d+)d$/);
+  if (relMatch) {
+    const d = /* @__PURE__ */ new Date();
+    d.setDate(d.getDate() - parseInt(relMatch[1]));
+    return d.toISOString().slice(0, 10);
+  }
+  if (trimmed === "today") return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  if (/^\d{4}-\d{2}$/.test(trimmed)) {
+    if (isEnd) {
+      const [y, m] = trimmed.split("-").map(Number);
+      const last = new Date(y, m, 0).getDate();
+      return `${trimmed}-${String(last).padStart(2, "0")}`;
+    }
+    return `${trimmed}-01`;
+  }
+  return trimmed;
+}
+
+// src/commands/clients.ts
+var TAX_SYSTEMS = [
+  { label: "601 \u2014 General de Ley (Personas Morales)", value: "601" },
+  { label: "612 \u2014 Personas F\xEDsicas con Actividad Empresarial", value: "612" },
+  { label: "616 \u2014 Sin obligaciones fiscales", value: "616" },
+  { label: "621 \u2014 Incorporaci\xF3n Fiscal", value: "621" },
+  { label: "625 \u2014 R\xE9gimen de actividades agr\xEDcolas", value: "625" },
+  { label: "626 \u2014 RESICO", value: "626" }
+];
+function registerClientCommands(program2) {
+  const clients = program2.command("clients").description("Gestionar clientes");
+  withListOpts(
+    clients.command("list").description("Listar clientes")
+  ).action(async (opts) => {
+    try {
+      const query = buildListQuery(opts);
+      const res = await spin("Cargando clientes\u2026", () => api("GET", "/clients", { query, team: opts.team }));
+      const items = res.data || [];
+      if (isJsonMode()) return printJson(items);
+      printTable(
+        items.map((c) => ({
+          id: c.id,
+          nombre: c.legal_name || c.name || "\u2014",
+          rfc: c.tax_id || "\u2014",
+          email: c.email || "\u2014"
+        }))
+      );
+      printPaginationHint(res);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  clients.command("get <id>").description("Ver detalle de un cliente").option("--team <id>", "Team ID").action(async (id, opts) => {
+    try {
+      const res = await api("GET", `/clients/${id}`, { team: opts.team });
+      const c = res.data;
+      if (isJsonMode()) return printJson(c);
+      printKeyValue({
+        ID: c.id,
+        Nombre: c.legal_name || c.name,
+        RFC: c.tax_id || "\u2014",
+        Email: c.email || "\u2014",
+        "R\xE9gimen fiscal": c.tax_system || "\u2014",
+        "Uso CFDI": c.use || "\u2014",
+        "C\xF3digo postal": c.address?.zip || "\u2014",
+        V\u00E1lido: c.is_valid ? "S\xED" : "No",
+        Creado: formatDate(c.created_at)
+      });
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  clients.command("create").description("Crear un cliente (interactivo si no se pasan flags)").option("--name <name>", "Nombre o raz\xF3n social").option("--email <email>", "Email").option("--rfc <rfc>", "RFC").option("--tax-system <code>", "R\xE9gimen fiscal (ej: 601, 612, 626)").option("--zip <zip>", "C\xF3digo postal").option("--use <use>", "Uso CFDI", "G03").option("--team <id>", "Team ID").action(async (opts) => {
+    try {
+      const interactive = !opts.name && !opts.rfc;
+      const name = opts.name || (interactive ? await askRequired("Nombre / raz\xF3n social") : "");
+      const email = opts.email || (interactive ? await ask("Email") : "");
+      const rfc = opts.rfc || (interactive ? await askRequired("RFC") : "");
+      const taxSystem = opts.taxSystem || (interactive ? await select("R\xE9gimen fiscal", TAX_SYSTEMS) : "");
+      const zip = opts.zip || (interactive ? await ask("C\xF3digo postal") : "");
+      if (!name || !rfc) {
+        error("Nombre y RFC son requeridos");
+        process.exit(1);
+      }
+      const res = await spin("Creando cliente\u2026", () => api("POST", "/clients", {
+        body: {
+          name,
+          legal_name: name,
+          email: email || void 0,
+          tax_id: rfc,
+          tax_system: taxSystem || void 0,
+          use: opts.use,
+          address: zip ? { zip } : void 0
+        },
+        team: opts.team
+      }));
+      success(`Cliente creado: ${res.data.id}`);
+      if (!isJsonMode()) console.log(`  RFC: ${res.data.tax_id}  Email: ${res.data.email || "\u2014"}`);
+      else printJson(res.data);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  clients.command("update <id>").description("Actualizar un cliente").option("--name <name>", "Nombre o raz\xF3n social").option("--email <email>", "Email").option("--rfc <rfc>", "RFC").option("--tax-system <code>", "R\xE9gimen fiscal").option("--zip <zip>", "C\xF3digo postal").option("--use <use>", "Uso CFDI").option("--team <id>", "Team ID").action(async (id, opts) => {
+    try {
+      const hasFlags = opts.name || opts.email || opts.rfc || opts.taxSystem || opts.zip || opts.use;
+      let body = {};
+      if (hasFlags) {
+        if (opts.name) {
+          body.name = opts.name;
+          body.legal_name = opts.name;
+        }
+        if (opts.email) body.email = opts.email;
+        if (opts.rfc) body.tax_id = opts.rfc;
+        if (opts.taxSystem) body.tax_system = opts.taxSystem;
+        if (opts.zip) body.address = { zip: opts.zip };
+        if (opts.use) body.use = opts.use;
+      } else {
+        const current = await spin("Cargando cliente\u2026", () => api("GET", `/clients/${id}`, { team: opts.team }));
+        const c = current.data;
+        console.log(pc6.dim(`Editando: ${c.legal_name || c.name} (${c.tax_id || "sin RFC"})
+`));
+        console.log(pc6.dim("Deja vac\xEDo para mantener el valor actual.\n"));
+        const name = await ask("Nombre", c.legal_name || c.name || "");
+        const email = await ask("Email", c.email || "");
+        const rfc = await ask("RFC", c.tax_id || "");
+        const taxSystem = await ask("R\xE9gimen fiscal", c.tax_system || "");
+        const zip = await ask("C\xF3digo postal", c.address?.zip || "");
+        if (name && name !== (c.legal_name || c.name)) {
+          body.name = name;
+          body.legal_name = name;
+        }
+        if (email && email !== c.email) body.email = email;
+        if (rfc && rfc !== c.tax_id) body.tax_id = rfc;
+        if (taxSystem && taxSystem !== c.tax_system) body.tax_system = taxSystem;
+        if (zip && zip !== c.address?.zip) body.address = { zip };
+      }
+      if (Object.keys(body).length === 0) {
+        console.log(pc6.dim("Sin cambios"));
+        return;
+      }
+      const res = await spin("Actualizando cliente\u2026", () => api("PUT", `/clients/${id}`, { body, team: opts.team }));
+      success(`Cliente ${id} actualizado`);
+      if (isJsonMode()) printJson(res.data);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  clients.command("search <query>").description("Buscar clientes").option("--team <id>", "Team ID").action(async (query, opts) => {
+    try {
+      const res = await spin("Buscando clientes\u2026", () => api("GET", "/clients/search", { query: { q: query }, team: opts.team }));
+      const items = res.data || [];
+      if (isJsonMode()) return printJson(items);
+      printTable(
+        items.map((c) => ({
+          id: c.id,
+          nombre: c.legal_name || c.name || "\u2014",
+          rfc: c.tax_id || "\u2014",
+          email: c.email || "\u2014"
+        }))
+      );
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  clients.command("validate <id>").description("Validar datos fiscales de un cliente contra el SAT").option("--team <id>", "Team ID").action(async (id, opts) => {
+    try {
+      const res = await spin("Validando contra el SAT\u2026", () => api("POST", `/clients/validate/${id}`, { team: opts.team }));
+      success("Validaci\xF3n completada");
+      if (isJsonMode()) printJson(res.data);
+      else printKeyValue(res.data);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  clients.command("portal").description("Generar link del portal de cliente (autofactura, documentos, pagos)").option("--id <id>", "Client ID").option("--email <email>", "Email del cliente").option("--team <id>", "Team ID").action(async (opts) => {
+    try {
+      if (!opts.id && !opts.email) {
+        const query = await askRequired("Email o ID del cliente");
+        if (query.startsWith("client_") || query.startsWith("cus_")) opts.id = query;
+        else opts.email = query;
+      }
+      const body = {};
+      if (opts.id) body.id = opts.id;
+      if (opts.email) body.email = opts.email;
+      const res = await spin("Generando portal\u2026", () => api("POST", "/clients/customerportal", { body, team: opts.team }));
+      const data = res.data;
+      if (isJsonMode()) return printJson(data);
+      success("Portal generado");
+      console.log(`  URL: ${pc6.bold(data.url)}`);
+      if (data.expires_at) {
+        const expires = new Date(data.expires_at > 1e12 ? data.expires_at : data.expires_at * 1e3);
+        console.log(pc6.dim(`  Expira: ${expires.toISOString().slice(0, 10)} (5 d\xEDas)`));
+      }
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  clients.command("delete <id>").description("Eliminar un cliente").option("--team <id>", "Team ID").action(async (id, opts) => {
+    try {
+      await api("DELETE", `/clients/${id}`, { team: opts.team });
+      success(`Cliente ${id} eliminado`);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+}
+
+// src/commands/invoices.ts
+import { writeFileSync as writeFileSync2 } from "node:fs";
+import { join as join2 } from "node:path";
+import pc7 from "picocolors";
+function uid(item) {
+  return item.uuid ? item.uuid.slice(0, 8) + "\u2026" : item.id ? item.id.slice(0, 12) + "\u2026" : "\u2014";
+}
+function registerInvoiceCommands(program2) {
+  const invoices = program2.command("invoices").description("Gestionar facturas CFDI");
+  withListOpts(
+    invoices.command("list").description("Listar facturas de ingreso")
+  ).option("--status <status>", "Filtrar por status (valid, cancelled)").option("--client <id>", "Filtrar por cliente").option("--series <series>", "Filtrar por serie").action(async (opts) => {
+    try {
+      const query = buildListQuery(opts);
+      if (opts.status) query.status = opts.status;
+      if (opts.client) query.client_id = opts.client;
+      if (opts.series) query.series = opts.series;
+      const res = await spin("Cargando facturas\u2026", () => api("GET", "/invoices/income", { query, team: opts.team }));
+      const items = res.data || [];
+      if (isJsonMode()) return printJson(items);
+      printTable(
+        items.map((i) => ({
+          uuid: uid(i),
+          cliente: (i.client?.legal_name || i.client?.name || "\u2014").slice(0, 25),
+          total: formatMoney(i.total, i.currency),
+          m\u00E9todo: i.payment_method || "\u2014",
+          status: i.status || "\u2014",
+          fecha: formatDate(i.created_at)
+        }))
+      );
+      printPaginationHint(res);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  invoices.command("get <uuid>").description("Ver detalle de una factura").option("--team <id>", "Team ID").action(async (uuid, opts) => {
+    try {
+      const res = await api("GET", `/invoices/income/${uuid}`, { team: opts.team });
+      const i = res.data;
+      if (isJsonMode()) return printJson(i);
+      printKeyValue({
+        UUID: i.uuid || i.id || "\u2014",
+        Status: i.status || "\u2014",
+        Cliente: i.client?.legal_name || i.client?.name || "\u2014",
+        RFC: i.client?.tax_id || "\u2014",
+        Email: i.client?.email || "\u2014",
+        Subtotal: formatMoney(i.subtotal, i.currency),
+        Total: formatMoney(i.total, i.currency),
+        "M\xE9todo pago": i.payment_method || "\u2014",
+        "Forma pago": i.payment_form || "\u2014",
+        Serie: i.series || "\u2014",
+        Folio: i.folio_number || "\u2014",
+        "Saldo pendiente": i.last_balance !== void 0 ? formatMoney(i.last_balance, i.currency) : "\u2014",
+        Complementos: i.payment_complements ?? "\u2014",
+        Creado: formatDate(i.created_at)
+      });
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  invoices.command("create").description("Crear factura de ingreso (CFDI 4.0) \u2014 interactivo si no se pasan flags").option("--client <id>", "ID del cliente").option("--items <json>", 'Items JSON: [{"description":"...","quantity":1,"unit_price":100,"product_key":"84111506","unit_key":"E48"}]').option("--payment-form <code>", "Forma de pago (ej: 01=Efectivo, 03=Transferencia, 04=Tarjeta)", "03").option("--payment-method <code>", "M\xE9todo de pago (PUE o PPD)", "PUE").option("--use <use>", "Uso CFDI", "G03").option("--currency <code>", "Moneda", "MXN").option("--series <series>", "Serie").option("--send-email", "Enviar factura por email al cliente").option("--emails <emails>", "Emails adicionales (separados por coma)").option("--team <id>", "Team ID").action(async (opts) => {
+    try {
+      const interactive = !opts.client && !opts.items;
+      let clientId = opts.client;
+      let items;
+      if (interactive) {
+        const clientQuery = await askRequired("Buscar cliente (nombre, RFC, email o ID)");
+        if (clientQuery.startsWith("client_") || clientQuery.match(/^[a-zA-Z0-9_-]{10,}$/)) {
+          try {
+            const directRes = await spin("Buscando cliente\u2026", () => api("GET", `/clients/${clientQuery}`, { team: opts.team }));
+            if (directRes.data) {
+              clientId = directRes.data.id;
+              const c = directRes.data;
+              console.log(pc7.dim(`  \u2192 ${c.legal_name || c.name || "\u2014"} (${c.tax_id || "sin RFC"})`));
+            }
+          } catch {
+          }
+        }
+        if (!clientId) {
+          const searchRes = await spin("Buscando cliente\u2026", () => api("GET", "/clients/search", { query: { q: clientQuery }, team: opts.team }));
+          const found = searchRes.data || [];
+          if (found.length === 0) {
+            error("No se encontr\xF3 el cliente");
+            process.exit(1);
+          }
+          if (found.length === 1) {
+            clientId = found[0].id;
+            console.log(pc7.dim(`  \u2192 ${found[0].legal_name || found[0].name} (${found[0].tax_id || "sin RFC"})`));
+          } else {
+            clientId = await select(
+              "Selecciona cliente",
+              found.slice(0, 8).map((c) => ({
+                label: `${c.legal_name || c.name} \u2014 ${c.tax_id || "sin RFC"}`,
+                value: c.id
+              }))
+            );
+          }
+        }
+        items = [];
+        let addMore = true;
+        while (addMore) {
+          console.log(pc7.bold(`
+Concepto ${items.length + 1}`));
+          const description = await askRequired("Descripci\xF3n");
+          const quantity = parseFloat(await ask("Cantidad", "1")) || 1;
+          const unitPrice = parseFloat(await askRequired("Precio unitario"));
+          const productKey = await ask("Clave producto SAT", "84111506");
+          const unitKey = await ask("Clave unidad SAT", "E48");
+          const addIva = await confirm("Agregar IVA 16%?");
+          const item = { description, quantity, unit_price: unitPrice, product_key: productKey, unit_key: unitKey };
+          if (addIva) item.taxes = [{ type: "IVA", rate: 0.16, factor: "Tasa", withholding: false }];
+          items.push(item);
+          addMore = await confirm("Agregar otro concepto?", false);
+        }
+        opts.paymentForm = await select("Forma de pago", [
+          { label: "03 \u2014 Transferencia electr\xF3nica", value: "03" },
+          { label: "01 \u2014 Efectivo", value: "01" },
+          { label: "04 \u2014 Tarjeta de cr\xE9dito", value: "04" },
+          { label: "28 \u2014 Tarjeta de d\xE9bito", value: "28" },
+          { label: "99 \u2014 Por definir", value: "99" }
+        ]);
+        opts.paymentMethod = await select("M\xE9todo de pago", [
+          { label: "PUE \u2014 Pago en una sola exhibici\xF3n", value: "PUE" },
+          { label: "PPD \u2014 Pago en parcialidades o diferido", value: "PPD" }
+        ]);
+        const subtotal = items.reduce((sum3, i) => sum3 + i.quantity * i.unit_price, 0);
+        console.log(`
+${pc7.bold("Resumen:")}`);
+        console.log(`  Cliente: ${clientId}`);
+        console.log(`  Conceptos: ${items.length}`);
+        console.log(`  Subtotal: ${formatMoney(subtotal, opts.currency)}`);
+        console.log(`  Forma pago: ${opts.paymentForm}  M\xE9todo: ${opts.paymentMethod}`);
+        const proceed = await confirm("\nTimbrar factura?");
+        if (!proceed) {
+          console.log(pc7.dim("Cancelado"));
+          return;
+        }
+      } else {
+        if (!clientId) {
+          error("--client es requerido");
+          process.exit(1);
+        }
+        if (!opts.items) {
+          error("--items es requerido");
+          process.exit(1);
+        }
+        try {
+          items = JSON.parse(opts.items);
+        } catch {
+          error("Items JSON inv\xE1lido");
+          process.exit(1);
+        }
+      }
+      const body = {
+        client: { id: clientId },
+        items,
+        payment_form: opts.paymentForm,
+        payment_method: opts.paymentMethod,
+        use: opts.use,
+        currency: opts.currency,
+        series: opts.series || void 0
+      };
+      if (opts.sendEmail) body.send_email = true;
+      if (opts.emails) body.emails = opts.emails.split(",").map((e) => e.trim());
+      const res = await spin("Timbrando factura\u2026", () => api("POST", "/invoices/income", { body, team: opts.team }));
+      success(`Factura creada: ${res.data.uuid || res.data.id}`);
+      if (isJsonMode()) printJson(res.data);
+      else console.log(`  Total: ${formatMoney(res.data.total, res.data.currency)}`);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  invoices.command("send <uuid>").description("Reenviar factura por email (PDF + XML adjuntos)").option("--to <emails>", "Emails adicionales separados por coma").option("--team <id>", "Team ID").action(async (uuid, opts) => {
+    try {
+      const body = {};
+      if (opts.to) body.emails = opts.to.split(",").map((e) => e.trim());
+      const res = await spin("Enviando factura por email\u2026", () => api("POST", `/invoices/${uuid}/send`, { body, team: opts.team }));
+      if (isJsonMode()) return printJson(res.data);
+      success(`Email enviado a: ${(res.data?.recipients || []).join(", ")}`);
+      if (res.data?.attachments?.length) {
+        console.log(pc7.dim(`  Adjuntos: ${res.data.attachments.join(", ")}`));
+      }
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  invoices.command("cancel <uuid>").description("Cancelar una factura").requiredOption("--motive <code>", "Motivo de cancelaci\xF3n (01, 02, 03, 04)").option("--replacement <uuid>", "UUID de factura de reemplazo (para motivo 01)").option("--team <id>", "Team ID").action(async (uuid, opts) => {
+    try {
+      await spin("Cancelando factura\u2026", () => api("DELETE", `/invoices/${uuid}`, {
+        body: { motive: opts.motive, replacement: opts.replacement },
+        team: opts.team
+      }));
+      success(`Factura ${uuid} cancelada`);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  invoices.command("search <query>").description("Buscar facturas").option("--team <id>", "Team ID").action(async (query, opts) => {
+    try {
+      const res = await spin("Buscando facturas\u2026", () => api("GET", "/invoices/search", { query: { q: query }, team: opts.team }));
+      const items = res.data || [];
+      if (isJsonMode()) return printJson(items);
+      printTable(
+        items.map((i) => ({
+          uuid: uid(i),
+          cliente: (i.client?.legal_name || "\u2014").slice(0, 25),
+          total: formatMoney(i.total, i.currency),
+          status: i.status || "\u2014"
+        }))
+      );
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  invoices.command("files <uuid>").description("Obtener archivos PDF/XML de una factura").option("--team <id>", "Team ID").action(async (uuid, opts) => {
+    try {
+      const res = await api("GET", `/invoices/${uuid}/files`, { team: opts.team });
+      if (isJsonMode()) return printJson(res.data);
+      const files = res.data;
+      if (files.pdf) console.log(`PDF: ${files.pdf}`);
+      if (files.xml) console.log(`XML: ${files.xml}`);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  invoices.command("download <uuid>").description("Descargar PDF y XML de una factura al directorio actual").option("-o, --out <dir>", "Directorio de salida", ".").option("--team <id>", "Team ID").action(async (uuid, opts) => {
+    try {
+      const res = await spin("Obteniendo archivos\u2026", () => api("GET", `/invoices/${uuid}/files`, { team: opts.team }));
+      const files = res.data;
+      const saved = [];
+      if (files.pdf) {
+        const pdfRes = await spin("Descargando PDF\u2026", () => fetch(files.pdf));
+        const buf = Buffer.from(await pdfRes.arrayBuffer());
+        const path = join2(opts.out, `${uuid}.pdf`);
+        writeFileSync2(path, buf);
+        saved.push(path);
+      }
+      if (files.xml) {
+        const xmlRes = await spin("Descargando XML\u2026", () => fetch(files.xml));
+        const buf = Buffer.from(await xmlRes.arrayBuffer());
+        const path = join2(opts.out, `${uuid}.xml`);
+        writeFileSync2(path, buf);
+        saved.push(path);
+      }
+      if (saved.length === 0) error("No se encontraron archivos para esta factura");
+      else success(`Descargado: ${saved.join(", ")}`);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  const drafts = invoices.command("drafts").description("Pre-facturas / borradores");
+  withListOpts(drafts.command("list").description("Listar borradores")).action(async (opts) => {
+    try {
+      const query = buildListQuery(opts);
+      const res = await spin("Cargando borradores\u2026", () => api("GET", "/invoices/draft", { query, team: opts.team }));
+      const items = res.data || [];
+      if (isJsonMode()) return printJson(items);
+      printTable(
+        items.map((i) => ({
+          uuid: uid(i),
+          cliente: (i.client?.legal_name || "\u2014").slice(0, 25),
+          total: formatMoney(i.total || 0, i.currency),
+          fecha: formatDate(i.created_at)
+        }))
+      );
+      printPaginationHint(res);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  drafts.command("stamp <uuid>").description("Timbrar borrador (convertir a CFDI)").option("--team <id>", "Team ID").action(async (uuid, opts) => {
+    try {
+      const res = await spin("Timbrando borrador\u2026", () => api("POST", `/invoices/draft/${uuid}/stamp`, { team: opts.team }));
+      success(`Borrador timbrado: ${res.data.uuid || res.data.id}`);
+      if (isJsonMode()) printJson(res.data);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  withListOpts(invoices.command("credit-notes").description("Listar notas de cr\xE9dito")).action(async (opts) => {
+    try {
+      const query = buildListQuery(opts);
+      const res = await spin("Cargando notas de cr\xE9dito\u2026", () => api("GET", "/invoices/egress", { query, team: opts.team }));
+      const items = res.data || [];
+      if (isJsonMode()) return printJson(items);
+      printTable(
+        items.map((i) => ({
+          uuid: uid(i),
+          cliente: (i.client?.legal_name || "\u2014").slice(0, 25),
+          total: formatMoney(i.total, i.currency),
+          status: i.status || "\u2014"
+        }))
+      );
+      printPaginationHint(res);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  withListOpts(invoices.command("complements").description("Listar complementos de pago")).option("--invoice <uuid>", "Filtrar por factura PPD relacionada").action(async (opts) => {
+    try {
+      const query = buildListQuery(opts);
+      if (opts.invoice) query.invoice_id = opts.invoice;
+      const res = await spin("Cargando complementos\u2026", () => api("GET", "/invoices/complements", { query, team: opts.team }));
+      const items = res.data || [];
+      if (isJsonMode()) return printJson(items);
+      printTable(
+        items.map((i) => ({
+          uuid: uid(i),
+          cliente: (i.client?.legal_name || "\u2014").slice(0, 25),
+          total: formatMoney(i.total, i.currency),
+          status: i.status || "\u2014"
+        }))
+      );
+      printPaginationHint(res);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+}
+
+// src/commands/payments.ts
+function registerPaymentCommands(program2) {
+  const payments = program2.command("payments").description("Gestionar pagos y cobros");
+  withListOpts(
+    payments.command("list").description("Listar pagos")
+  ).option("--status <status>", "Filtrar: pending, succeeded, failed, cancelled, refunded").option("--client <id>", "Filtrar por cliente").option("--currency <code>", "Filtrar por moneda (MXN, USD)").option("--email <email>", "Filtrar por email del cliente").option("--rfc <rfc>", "Filtrar por RFC del cliente").action(async (opts) => {
+    try {
+      const query = buildListQuery(opts);
+      if (opts.status) query.status = opts.status;
+      if (opts.client) query.client_id = opts.client;
+      if (opts.currency) query.currency = opts.currency;
+      if (opts.email) query.email = opts.email;
+      if (opts.rfc) query.tax_id = opts.rfc;
+      const res = await spin("Cargando pagos\u2026", () => api("GET", "/payments", { query, team: opts.team }));
+      const items = res.data || [];
+      if (isJsonMode()) return printJson(items);
+      printTable(
+        items.map((p) => ({
+          id: p.id ? p.id.slice(0, 12) + "\u2026" : "\u2014",
+          cliente: (p.client?.legal_name || p.client?.name || "\u2014").slice(0, 25),
+          total: formatMoney(p.total, p.currency),
+          status: p.status,
+          fecha: formatDate(p.created_at)
+        }))
+      );
+      printPaginationHint(res);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  payments.command("get <id>").description("Ver detalle de un pago").option("--team <id>", "Team ID").action(async (id, opts) => {
+    try {
+      const res = await api("GET", `/payments/${id}`, { team: opts.team });
+      const p = res.data;
+      if (isJsonMode()) return printJson(p);
+      printKeyValue({
+        ID: p.id || "\u2014",
+        Status: p.status,
+        Cliente: p.client?.legal_name || p.client?.name || "\u2014",
+        Email: p.client?.email || "\u2014",
+        RFC: p.client?.tax_id || "\u2014",
+        Total: formatMoney(p.total, p.currency),
+        "Forma pago": p.payment_form || "\u2014",
+        "Link de pago": p.short_url || "\u2014",
+        Creado: formatDate(p.created_at)
+      });
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  payments.command("request").description("Solicitar un pago (genera link de cobro)").requiredOption("--client <id>", "ID del cliente").requiredOption("--items <json>", "Items JSON").option("--currency <code>", "Moneda", "MXN").option("--methods <list>", "M\xE9todos permitidos (card,bank,oxxo,stripe-spei)", "card,bank").option("--send-email", "Enviar link por email al cliente").option("--team <id>", "Team ID").action(async (opts) => {
+    try {
+      let items;
+      try {
+        items = JSON.parse(opts.items);
+      } catch {
+        error("Items JSON inv\xE1lido");
+        process.exit(1);
+      }
+      const body = {
+        client: { id: opts.client },
+        items,
+        currency: opts.currency,
+        allowed_payment_methods: opts.methods.split(",")
+      };
+      if (opts.sendEmail) body.send_email = true;
+      const res = await spin("Creando solicitud de pago\u2026", () => api("POST", "/payments/request", { body, team: opts.team }));
+      success(`Pago solicitado: ${res.data.id}`);
+      if (res.data.short_url) console.log(`  Link: ${res.data.short_url}`);
+      if (isJsonMode()) printJson(res.data);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  payments.command("register").description("Registrar un pago recibido").requiredOption("--client <id>", "ID del cliente").requiredOption("--items <json>", "Items JSON").requiredOption("--payment-form <code>", "Forma de pago (03=Transferencia, etc)").option("--currency <code>", "Moneda", "MXN").option("--send-email", "Enviar confirmaci\xF3n por email").option("--team <id>", "Team ID").action(async (opts) => {
+    try {
+      let items;
+      try {
+        items = JSON.parse(opts.items);
+      } catch {
+        error("Items JSON inv\xE1lido");
+        process.exit(1);
+      }
+      const body = {
+        automation_type: "stamp_invoice",
+        client: { id: opts.client },
+        items,
+        currency: opts.currency,
+        payment_form: opts.paymentForm,
+        idempotency_key: `cli_${Date.now()}`
+      };
+      if (opts.sendEmail) body.send_email = true;
+      const res = await spin("Registrando pago\u2026", () => api("POST", "/payments/register", { body, team: opts.team }));
+      success(`Pago registrado: ${res.data.id}`);
+      if (isJsonMode()) printJson(res.data);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  payments.command("refund <id>").description("Reembolsar un pago").option("--team <id>", "Team ID").action(async (id, opts) => {
+    try {
+      const res = await spin("Procesando reembolso\u2026", () => api("POST", `/payments/${id}/refund`, { team: opts.team }));
+      success(`Pago ${id} reembolsado`);
+      if (isJsonMode()) printJson(res.data);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+}
+
+// src/commands/services.ts
+import pc8 from "picocolors";
+function registerServiceCommands(program2) {
+  const services = program2.command("services").description("Gestionar productos y servicios");
+  withListOpts(
+    services.command("list").description("Listar servicios")
+  ).action(async (opts) => {
+    try {
+      const query = buildListQuery(opts);
+      const res = await spin("Cargando servicios\u2026", () => api("GET", "/services", { query, team: opts.team }));
+      const items = res.data || [];
+      if (isJsonMode()) return printJson(items);
+      printTable(
+        items.map((s) => ({
+          id: s.id ? s.id.slice(0, 12) + "\u2026" : "\u2014",
+          descripcion: (s.description || "\u2014").slice(0, 35),
+          precio: formatMoney(s.unit_price, "MXN"),
+          clave_prod: s.product_key || "\u2014",
+          clave_unit: s.unit_key || "\u2014"
+        }))
+      );
+      printPaginationHint(res);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  services.command("get <id>").description("Ver detalle de un servicio").option("--team <id>", "Team ID").action(async (id, opts) => {
+    try {
+      const res = await api("GET", `/services/${id}`, { team: opts.team });
+      const s = res.data;
+      if (isJsonMode()) return printJson(s);
+      printKeyValue({
+        ID: s.id,
+        Descripci\u00F3n: s.description,
+        SKU: s.sku || "\u2014",
+        "Precio unitario": formatMoney(s.unit_price, "MXN"),
+        "Clave producto": s.product_key,
+        "Clave unidad": s.unit_key,
+        "Nombre unidad": s.unit_name || "\u2014",
+        Impuestos: (s.taxes || []).map((t) => `${t.type} ${(t.rate * 100).toFixed(0)}%${t.withholding ? " (ret)" : ""}`).join(", ") || "\u2014"
+      });
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  services.command("create").description("Crear un servicio").requiredOption("--description <desc>", "Descripci\xF3n del servicio").requiredOption("--price <price>", "Precio unitario").requiredOption("--product-key <key>", "Clave SAT del producto (ej: 84111506)").requiredOption("--unit-key <key>", "Clave SAT de unidad (ej: E48, H87)").option("--sku <sku>", "SKU interno").option("--unit-name <name>", "Nombre de unidad").option("--iva", "Agregar IVA 16%").option("--team <id>", "Team ID").action(async (opts) => {
+    try {
+      const taxes = opts.iva ? [{ type: "IVA", rate: 0.16, factor: "Tasa", withholding: false }] : [];
+      const res = await spin("Creando servicio\u2026", () => api("POST", "/services", {
+        body: {
+          description: opts.description,
+          unit_price: parseFloat(opts.price),
+          product_key: opts.productKey,
+          unit_key: opts.unitKey,
+          unit_name: opts.unitName,
+          sku: opts.sku,
+          taxes
+        },
+        team: opts.team
+      }));
+      success(`Servicio creado: ${res.data.id}`);
+      if (isJsonMode()) printJson(res.data);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  services.command("update <id>").description("Actualizar un servicio").option("--description <desc>", "Descripci\xF3n").option("--price <price>", "Precio unitario").option("--product-key <key>", "Clave SAT del producto").option("--unit-key <key>", "Clave SAT de unidad").option("--sku <sku>", "SKU interno").option("--team <id>", "Team ID").action(async (id, opts) => {
+    try {
+      const hasFlags = opts.description || opts.price || opts.productKey || opts.unitKey || opts.sku;
+      let body = {};
+      if (hasFlags) {
+        if (opts.description) body.description = opts.description;
+        if (opts.price) body.unit_price = parseFloat(opts.price);
+        if (opts.productKey) body.product_key = opts.productKey;
+        if (opts.unitKey) body.unit_key = opts.unitKey;
+        if (opts.sku) body.sku = opts.sku;
+      } else {
+        const current = await spin("Cargando servicio\u2026", () => api("GET", `/services/${id}`, { team: opts.team }));
+        const s = current.data;
+        console.log(pc8.dim(`Editando: ${s.description}
+`));
+        console.log(pc8.dim("Deja vac\xEDo para mantener el valor actual.\n"));
+        const description = await ask("Descripci\xF3n", s.description || "");
+        const price = await ask("Precio unitario", String(s.unit_price || ""));
+        const productKey = await ask("Clave producto SAT", s.product_key || "");
+        const unitKey = await ask("Clave unidad SAT", s.unit_key || "");
+        const sku = await ask("SKU", s.sku || "");
+        if (description && description !== s.description) body.description = description;
+        if (price && parseFloat(price) !== s.unit_price) body.unit_price = parseFloat(price);
+        if (productKey && productKey !== s.product_key) body.product_key = productKey;
+        if (unitKey && unitKey !== s.unit_key) body.unit_key = unitKey;
+        if (sku && sku !== s.sku) body.sku = sku;
+      }
+      if (Object.keys(body).length === 0) {
+        console.log(pc8.dim("Sin cambios"));
+        return;
+      }
+      const res = await spin("Actualizando servicio\u2026", () => api("PUT", `/services/${id}`, { body, team: opts.team }));
+      success(`Servicio ${id} actualizado`);
+      if (isJsonMode()) printJson(res.data);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  services.command("delete <id>").description("Eliminar un servicio").option("--team <id>", "Team ID").action(async (id, opts) => {
+    try {
+      await api("DELETE", `/services/${id}`, { team: opts.team });
+      success(`Servicio ${id} eliminado`);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+}
+
+// src/commands/webhooks.ts
+function registerWebhookCommands(program2) {
+  const webhooks = program2.command("webhooks").description("Gestionar webhooks");
+  withListOpts(
+    webhooks.command("list").description("Listar webhooks configurados")
+  ).action(async (opts) => {
+    try {
+      const query = buildListQuery(opts);
+      const res = await spin("Cargando webhooks\u2026", () => api("GET", "/webhooks", { query, team: opts.team }));
+      const items = res.data || [];
+      if (isJsonMode()) return printJson(items);
+      printTable(
+        items.map((w) => ({
+          id: w.id ? w.id.slice(0, 12) + "\u2026" : "\u2014",
+          url: (w.url || "\u2014").slice(0, 40),
+          events: (w.events || []).join(", ").slice(0, 30) || "all"
+        }))
+      );
+      printPaginationHint(res);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  webhooks.command("create").description("Crear un webhook").requiredOption("--url <url>", "URL del webhook").option("--events <events>", "Eventos separados por coma (ej: invoice.created,payment.succeeded)").option("--team <id>", "Team ID").action(async (opts) => {
+    try {
+      const body = { url: opts.url };
+      if (opts.events) body.events = opts.events.split(",");
+      const res = await spin("Creando webhook\u2026", () => api("POST", "/webhooks", { body, team: opts.team }));
+      success(`Webhook creado: ${res.data.id}`);
+      if (isJsonMode()) printJson(res.data);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  webhooks.command("delete <id>").description("Eliminar un webhook").option("--team <id>", "Team ID").action(async (id, opts) => {
+    try {
+      await api("DELETE", `/webhooks/${id}`, { team: opts.team });
+      success(`Webhook ${id} eliminado`);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+}
+
+// src/commands/teams.ts
+function registerTeamCommands(program2) {
+  const teams = program2.command("teams").description("Gestionar equipos");
+  teams.command("list").description("Listar equipos").action(async () => {
+    try {
+      const res = await api("GET", "/teams");
+      const items = res.data || [];
+      if (isJsonMode()) return printJson(items);
+      printTable(
+        items.map((t) => ({
+          id: t.id,
+          nombre: t.legal_name || t.name || "\u2014",
+          rfc: t.tax_id || "\u2014"
+        }))
+      );
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  teams.command("get <id>").description("Ver detalle de un equipo").action(async (id) => {
+    try {
+      const res = await api("GET", `/teams/${id}`);
+      const t = res.data;
+      if (isJsonMode()) return printJson(t);
+      printKeyValue({
+        ID: t.id,
+        Nombre: t.legal_name || t.name || "\u2014",
+        RFC: t.tax_id || "\u2014",
+        "R\xE9gimen fiscal": t.tax_system || "\u2014",
+        "C\xF3digo postal": t.address?.zip || "\u2014"
+      });
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  teams.command("integrations").description("Ver integraciones del equipo").action(async () => {
+    try {
+      const res = await api("GET", "/teams/integrations");
+      if (isJsonMode()) return printJson(res.data);
+      printKeyValue(res.data);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+}
+
+// src/commands/receipts.ts
+function registerReceiptCommands(program2) {
+  const receipts = program2.command("receipts").description("Gestionar recibos de venta");
+  withListOpts(
+    receipts.command("list").description("Listar recibos")
+  ).option("--status <status>", "Filtrar: pending, open, invoiced, completed, expired, cancelled").option("--client <id>", "Filtrar por cliente").action(async (opts) => {
+    try {
+      const query = buildListQuery(opts);
+      if (opts.status) query.status = opts.status;
+      if (opts.client) query.client_id = opts.client;
+      const res = await spin("Cargando recibos\u2026", () => api("GET", "/receipts", { query, team: opts.team }));
+      const items = (res.data || []).filter((r) => r != null);
+      if (isJsonMode()) return printJson(items);
+      printTable(
+        items.map((r) => ({
+          id: r.id ? r.id.slice(0, 12) + "\u2026" : "\u2014",
+          cliente: (r.client?.legal_name || r.client?.name || "p\xFAblico general").slice(0, 25),
+          total: formatMoney(r.total, r.currency),
+          status: r.status || "\u2014",
+          v\u00E1lido: formatDate(r.validUntil)
+        }))
+      );
+      printPaginationHint(res);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  receipts.command("stamp <id>").description("Timbrar un recibo").option("--team <id>", "Team ID").action(async (id, opts) => {
+    try {
+      const res = await spin("Timbrando recibo\u2026", () => api("POST", `/receipts/${id}/stamp`, { team: opts.team }));
+      success(`Recibo timbrado: ${res.data.id}`);
+      if (isJsonMode()) printJson(res.data);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+  receipts.command("cancel <id>").description("Cancelar un recibo").option("--team <id>", "Team ID").action(async (id, opts) => {
+    try {
+      await api("DELETE", `/receipts/${id}`, { team: opts.team });
+      success(`Recibo ${id} cancelado`);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+}
+
+// src/commands/doctor.ts
+import pc9 from "picocolors";
+function pass(msg) {
+  console.log(pc9.green(`  \u2713 ${msg}`));
+}
+function fail(msg) {
+  console.log(pc9.red(`  \u2717 ${msg}`));
+}
+function info(msg) {
+  console.log(pc9.dim(`    ${msg}`));
+}
+function warn2(msg) {
+  console.log(pc9.yellow(`  ! ${msg}`));
+}
+function registerDoctorCommand(program2) {
+  program2.command("doctor").description("Diagn\xF3stico del CLI: verifica auth, conexi\xF3n, SAT y configuraci\xF3n").action(async () => {
+    console.log(pc9.bold("\ngigstack doctor\n"));
+    let allGood = true;
+    const nodeVersion = process.version;
+    const major = parseInt(nodeVersion.slice(1));
+    if (major >= 18) {
+      pass(`Node.js ${nodeVersion}`);
+    } else {
+      fail(`Node.js ${nodeVersion} \u2014 se requiere v18+`);
+      allGood = false;
+    }
+    console.log();
+    const profile = getActiveProfile();
+    if (!profile) {
+      fail("No hay credenciales configuradas");
+      info("Ejecuta: gigstack login");
+      allGood = false;
+      return printSummary(allGood);
+    }
+    const profiles = listProfiles();
+    pass(`Perfil activo: ${pc9.bold(profile.name)}`);
+    if (profiles.length > 1) {
+      info(`${profiles.length} perfiles configurados`);
+    }
+    if (isTestKey(profile.apiKey)) {
+      warn2("Usando API key de prueba (test mode)");
+    } else {
+      pass("Usando API key de producci\xF3n (live mode)");
+    }
+    console.log();
+    try {
+      const start = Date.now();
+      const team = await resolveTeam(profile.apiKey);
+      const latency = Date.now() - start;
+      pass(`Conexi\xF3n a API: ${latency}ms`);
+      if (!team) {
+        fail("No se encontraron equipos");
+        allGood = false;
+      } else {
+        pass(`Equipo: ${pc9.bold(team.legal_name || team.brand?.alias || team.name || "\u2014")}`);
+        if (team.tax_id) {
+          pass(`RFC: ${team.tax_id}`);
+        } else {
+          warn2("RFC no configurado");
+        }
+        console.log();
+        if (team.sat?.completed) {
+          pass("SAT conectado");
+          if (team.sat.csd_expires_at) {
+            const expires = formatDate(team.sat.csd_expires_at);
+            const expiresDate = new Date(team.sat.csd_expires_at > 1e12 ? team.sat.csd_expires_at : team.sat.csd_expires_at * 1e3);
+            const daysLeft = Math.floor((expiresDate.getTime() - Date.now()) / 864e5);
+            if (daysLeft < 30) {
+              warn2(`CSD expira en ${daysLeft} d\xEDas (${expires})`);
+              allGood = false;
+            } else {
+              pass(`CSD v\xE1lido hasta ${expires} (${daysLeft} d\xEDas)`);
+            }
+          }
+          if (team.sat.connected_at) {
+            info(`Conectado: ${formatDate(team.sat.connected_at)}`);
+          }
+        } else {
+          fail("SAT no conectado \u2014 no podr\xE1s timbrar facturas");
+          info("Conecta tu CSD en app.gigstack.pro/settings");
+          allGood = false;
+        }
+        console.log();
+        const integrations = team.integrations || {};
+        const connected = Object.entries(integrations).filter(([_, v]) => v?.completed).map(([k]) => k);
+        if (connected.length > 0) {
+          pass(`Integraciones: ${connected.join(", ")}`);
+        } else {
+          info("Sin integraciones conectadas");
+        }
+        console.log();
+        const endpoints = [
+          { name: "Clientes", path: "/clients", query: { limit: "1" } },
+          { name: "Facturas", path: "/invoices/income", query: { limit: "1" } },
+          { name: "Pagos", path: "/payments", query: { limit: "1" } },
+          { name: "Servicios", path: "/services", query: { limit: "1" } },
+          { name: "Webhooks", path: "/webhooks" },
+          { name: "Recibos", path: "/receipts", query: { limit: "1" } }
+        ];
+        for (const ep of endpoints) {
+          try {
+            await api("GET", ep.path, { query: ep.query });
+            pass(`${ep.name} (${ep.path})`);
+          } catch (e) {
+            fail(`${ep.name} (${ep.path}): ${e.message}`);
+            allGood = false;
+          }
+        }
+      }
+    } catch (e) {
+      fail(`Error de conexi\xF3n: ${e.message}`);
+      allGood = false;
+    }
+    printSummary(allGood);
+  });
+}
+function printSummary(allGood) {
+  console.log();
+  if (allGood) {
+    console.log(pc9.green(pc9.bold("Todo en orden. Tu CLI est\xE1 listo.")));
+  } else {
+    console.log(pc9.yellow(pc9.bold("Algunos problemas detectados. Revisa los items marcados arriba.")));
+  }
+  console.log();
+}
+
+// src/commands/pay.ts
+import pc10 from "picocolors";
+function registerPayCommand(program2) {
+  program2.command("pay").description("Registrar un pago y enviar portal de autofactura al cliente").option("--email <email>", "Email del cliente").option("--name <name>", "Nombre del cliente").option("--rfc <rfc>", "RFC del cliente (busca o crea autom\xE1ticamente)").option("--description <desc>", "Descripci\xF3n del servicio/producto").option("--amount <amount>", "Monto (sin IVA)").option("--iva", "Agregar IVA 16%").option("--no-iva", "Sin IVA").option("--payment-form <code>", "Forma de pago (01=Efectivo, 03=Transferencia, 04=Tarjeta)").option("--currency <code>", "Moneda", "MXN").option("--automation <type>", "Tipo de automatizaci\xF3n (pue_invoice, ppd_invoice_and_complement, none)", "pue_invoice").option("--product-key <key>", "Clave producto SAT", "84111506").option("--unit-key <key>", "Clave unidad SAT", "E48").option("--metadata <json>", "Metadata JSON adicional").option("--stdin", "Leer input desde stdin (JSON)").option("--team <id>", "Team ID").action(async (opts) => {
+    try {
+      let email;
+      let name;
+      let rfc;
+      let description;
+      let amount;
+      let addIva;
+      let paymentForm;
+      if (opts.stdin) {
+        const chunks = [];
+        for await (const chunk of process.stdin) chunks.push(chunk);
+        const input = JSON.parse(Buffer.concat(chunks).toString());
+        email = input.email;
+        name = input.name;
+        rfc = input.rfc;
+        description = input.description;
+        amount = input.amount;
+        addIva = input.iva !== false;
+        paymentForm = input.payment_form || "03";
+        opts.currency = input.currency || opts.currency;
+        opts.automation = input.automation || opts.automation;
+        opts.productKey = input.product_key || opts.productKey;
+        opts.unitKey = input.unit_key || opts.unitKey;
+        if (input.metadata) opts.metadata = JSON.stringify(input.metadata);
+      } else if (opts.email && opts.amount && opts.description) {
+        email = opts.email;
+        name = opts.name;
+        rfc = opts.rfc;
+        description = opts.description;
+        amount = parseFloat(opts.amount);
+        addIva = opts.iva !== false;
+        paymentForm = opts.paymentForm || "03";
+      } else {
+        email = opts.email || await askRequired("Email del cliente");
+        name = opts.name || await ask("Nombre del cliente (opcional)");
+        rfc = opts.rfc || await ask("RFC (opcional, el cliente puede completarlo en el portal)");
+        description = opts.description || await askRequired("Descripci\xF3n del servicio/producto");
+        const amountStr = opts.amount || await askRequired("Monto (sin IVA)");
+        amount = parseFloat(amountStr);
+        if (isNaN(amount) || amount <= 0) {
+          error("Monto inv\xE1lido");
+          process.exit(1);
+        }
+        addIva = opts.iva !== void 0 ? opts.iva : await confirm("Agregar IVA 16%?");
+        paymentForm = opts.paymentForm || await select("Forma de pago", [
+          { label: "03 \u2014 Transferencia electr\xF3nica", value: "03" },
+          { label: "01 \u2014 Efectivo", value: "01" },
+          { label: "04 \u2014 Tarjeta de cr\xE9dito", value: "04" },
+          { label: "28 \u2014 Tarjeta de d\xE9bito", value: "28" },
+          { label: "99 \u2014 Por definir", value: "99" }
+        ]);
+        const iva2 = addIva ? amount * 0.16 : 0;
+        const total2 = amount + iva2;
+        console.log(`
+${pc10.bold("Resumen:")}`);
+        console.log(`  Cliente:     ${email}${name ? ` (${name})` : ""}`);
+        console.log(`  Descripci\xF3n: ${description}`);
+        console.log(`  Subtotal:    ${formatMoney(amount, opts.currency)}`);
+        if (addIva) console.log(`  IVA 16%:     ${formatMoney(iva2, opts.currency)}`);
+        console.log(`  ${pc10.bold("Total:")}      ${pc10.bold(formatMoney(total2, opts.currency))}`);
+        console.log(`  Forma pago:  ${paymentForm}`);
+        console.log(`  Automaci\xF3n:  ${opts.automation}`);
+        const proceed = await confirm("\nRegistrar pago?");
+        if (!proceed) {
+          console.log(pc10.dim("Cancelado"));
+          return;
+        }
+      }
+      const client = { email };
+      if (name) {
+        client.name = name;
+        client.legal_name = name;
+      }
+      if (rfc) {
+        client.tax_id = rfc;
+        client.search = { on_key: "tax_id", on_value: rfc, auto_create: true };
+      } else {
+        client.search = { on_key: "email", on_value: email, auto_create: true };
+      }
+      const item = {
+        description,
+        quantity: 1,
+        unit_price: amount,
+        product_key: opts.productKey,
+        unit_key: opts.unitKey
+      };
+      if (addIva) {
+        item.taxes = [{ type: "IVA", rate: 0.16, factor: "Tasa", withholding: false }];
+      }
+      const body = {
+        client,
+        items: [item],
+        currency: opts.currency,
+        payment_form: paymentForm,
+        automation_type: opts.automation,
+        idempotency_key: `cli_${Date.now()}`
+      };
+      if (opts.metadata) {
+        try {
+          body.metadata = JSON.parse(opts.metadata);
+        } catch {
+        }
+      }
+      const res = await spin("Registrando pago\u2026", () => api("POST", "/payments/register", { body, team: opts.team }));
+      const payment = res.data;
+      if (isJsonMode()) return printJson(payment);
+      const iva = addIva ? amount * 0.16 : 0;
+      const total = amount + iva;
+      success("Pago registrado");
+      console.log(`  ID:    ${payment.id || "\u2014"}`);
+      console.log(`  Total: ${formatMoney(total, opts.currency)}`);
+      if (payment.client?.id) console.log(`  Cliente: ${payment.client.id}`);
+      if (payment.short_url) console.log(`  Link pago: ${payment.short_url}`);
+      console.log(`
+  ${pc10.dim("Portal de autofactura enviado a")} ${pc10.bold(email)}`);
+    } catch (e) {
+      error(e.message);
+    }
+  });
+}
+
+// src/commands/status.ts
+import pc11 from "picocolors";
+function sum(items, key = "total") {
+  return items.reduce((s, i) => s + (i?.[key] || 0), 0);
+}
+function fmt(amount, currency = "MXN") {
+  return formatMoney(amount, currency);
+}
+function parseDate2(input, isEnd = false) {
+  const trimmed = input.trim().toLowerCase();
+  const relMatch = trimmed.match(/^(\d+)d$/);
+  if (relMatch) {
+    const d = /* @__PURE__ */ new Date();
+    d.setDate(d.getDate() - parseInt(relMatch[1]));
+    return d.toISOString().slice(0, 10);
+  }
+  if (trimmed === "today") return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  if (/^\d{4}-\d{2}$/.test(trimmed)) {
+    if (isEnd) {
+      const [y, m] = trimmed.split("-").map(Number);
+      const last = new Date(y, m, 0).getDate();
+      return `${trimmed}-${String(last).padStart(2, "0")}`;
+    }
+    return `${trimmed}-01`;
+  }
+  return trimmed;
+}
+function defaultFrom() {
+  const d = /* @__PURE__ */ new Date();
+  return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-01`;
+}
+function defaultTo() {
+  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+}
+function registerStatusCommand(program2) {
+  program2.command("status").description("Resumen financiero: facturas, pagos, recibos y conciliaci\xF3n").option("--from <date>", "Fecha inicio (YYYY-MM-DD, YYYY-MM, 30d, 7d)").option("--to <date>", "Fecha fin (YYYY-MM-DD, YYYY-MM, today)").option("--team <id>", "Team ID").action(async (opts) => {
+    try {
+      const from = opts.from ? parseDate2(opts.from) : defaultFrom();
+      const to = opts.to ? parseDate2(opts.to, true) : defaultTo();
+      const fromTs = String(Math.floor(new Date(from).getTime() / 1e3));
+      const toTs = String(Math.floor((/* @__PURE__ */ new Date(to + "T23:59:59")).getTime() / 1e3));
+      const dateQuery = {
+        "created[gte]": fromTs,
+        "created[lte]": toTs,
+        limit: "100"
+      };
+      const noDatesQuery = { limit: "100" };
+      const hasDateFilter = opts.from || opts.to;
+      const [team, invoices, payments, receipts] = await spin(
+        "Cargando resumen\u2026",
+        () => Promise.all([
+          resolveTeam(),
+          api("GET", "/invoices/income", { query: hasDateFilter ? dateQuery : noDatesQuery, team: opts.team }).catch(() => ({ data: [] })),
+          api("GET", "/payments", { query: hasDateFilter ? dateQuery : noDatesQuery, team: opts.team }).catch(() => ({ data: [] })),
+          api("GET", "/receipts", { query: hasDateFilter ? dateQuery : noDatesQuery, team: opts.team }).catch(() => ({ data: [] }))
+        ])
+      );
+      const inv = (invoices.data || []).filter((i) => i != null);
+      const pay = (payments.data || []).filter((p) => p != null);
+      const rec = (receipts.data || []).filter((r) => r != null);
+      const cur = inv[0]?.currency || pay[0]?.currency || "MXN";
+      const validInv = inv.filter((i) => i.status === "valid");
+      const cancelledInv = inv.filter((i) => i.status === "cancelled");
+      const pueInv = validInv.filter((i) => i.payment_method === "PUE");
+      const ppdInv = validInv.filter((i) => i.payment_method === "PPD");
+      const succeededPay = pay.filter((p) => p.status === "succeeded");
+      const pendingPay = pay.filter((p) => p.status === "pending" || p.status === "requires_payment_method");
+      const failedPay = pay.filter((p) => p.status === "failed" || p.status === "cancelled");
+      const pendingRec = rec.filter((r) => r.status === "pending" || r.status === "open");
+      const invoicedRec = rec.filter((r) => r.status === "invoiced" || r.status === "completed");
+      const ppdWithBalance = ppdInv.filter((i) => {
+        const balance = i.last_balance ?? i.total;
+        return balance > 0 && (!i.payment_complements || i.payment_complements === 0 || balance > 0.01);
+      });
+      const ppdPaid = ppdInv.filter((i) => {
+        const balance = i.last_balance;
+        return balance !== void 0 && balance !== null && balance <= 0.01;
+      });
+      const ppdPartial = ppdInv.filter((i) => {
+        const balance = i.last_balance;
+        return balance !== void 0 && balance !== null && balance > 0.01 && balance < (i.total || 0);
+      });
+      const ppdPendingTotal = ppdWithBalance.reduce((s, i) => s + (i.last_balance ?? i.total ?? 0), 0);
+      const now = Date.now();
+      const dayMs = 864e5;
+      const aging = { current: [], d30: [], d60: [], d90: [], over90: [] };
+      for (const i of ppdWithBalance) {
+        const ts = i.created_at ? typeof i.created_at === "string" ? new Date(i.created_at).getTime() : i.created_at > 1e12 ? i.created_at : i.created_at * 1e3 : now;
+        const daysOld = Math.floor((now - ts) / dayMs);
+        const balance = i.last_balance ?? i.total ?? 0;
+        const entry = { ...i, _balance: balance, _daysOld: daysOld };
+        if (daysOld <= 15) aging.current.push(entry);
+        else if (daysOld <= 30) aging.d30.push(entry);
+        else if (daysOld <= 60) aging.d60.push(entry);
+        else if (daysOld <= 90) aging.d90.push(entry);
+        else aging.over90.push(entry);
+      }
+      if (isJsonMode()) {
+        return printJson({
+          period: hasDateFilter ? { from, to } : { note: "last 100 records" },
+          team: { name: team?.legal_name || team?.brand?.alias, tax_id: team?.tax_id },
+          invoices: {
+            total: inv.length,
+            valid: validInv.length,
+            cancelled: cancelledInv.length,
+            pue: { count: pueInv.length, total: sum(pueInv) },
+            ppd: { count: ppdInv.length, total: sum(ppdInv) },
+            total_amount: sum(validInv)
+          },
+          payments: {
+            total: pay.length,
+            succeeded: succeededPay.length,
+            pending: pendingPay.length,
+            failed: failedPay.length,
+            succeeded_amount: sum(succeededPay),
+            pending_amount: sum(pendingPay)
+          },
+          receipts: {
+            total: rec.length,
+            pending: pendingRec.length,
+            invoiced: invoicedRec.length,
+            pending_amount: sum(pendingRec),
+            total_amount: sum(rec)
+          },
+          cobranza: {
+            ppd_pending: ppdWithBalance.length,
+            ppd_paid: ppdPaid.length,
+            ppd_partial: ppdPartial.length,
+            pending_amount: ppdPendingTotal,
+            aging: {
+              current: { count: aging.current.length, amount: aging.current.reduce((s, i) => s + i._balance, 0) },
+              d30: { count: aging.d30.length, amount: aging.d30.reduce((s, i) => s + i._balance, 0) },
+              d60: { count: aging.d60.length, amount: aging.d60.reduce((s, i) => s + i._balance, 0) },
+              d90: { count: aging.d90.length, amount: aging.d90.reduce((s, i) => s + i._balance, 0) },
+              over90: { count: aging.over90.length, amount: aging.over90.reduce((s, i) => s + i._balance, 0) }
+            }
+          }
+        });
+      }
+      const teamName = team?.legal_name || team?.brand?.alias || "\u2014";
+      console.log(`
+${pc11.bold(teamName)} ${team?.tax_id ? pc11.dim(`(${team.tax_id})`) : ""}`);
+      if (hasDateFilter) {
+        console.log(pc11.dim(`${from}  \u2192  ${to}`));
+      } else {
+        console.log(pc11.dim(`\xDAltimos 100 registros (usa --from para filtrar)`));
+      }
+      console.log(`
+${pc11.bold(pc11.underline("Facturas"))}`);
+      console.log(`  V\xE1lidas        ${String(validInv.length).padStart(4)}   ${pc11.green(fmt(sum(validInv), cur))}`);
+      console.log(`    PUE          ${String(pueInv.length).padStart(4)}   ${fmt(sum(pueInv), cur)}`);
+      console.log(`    PPD          ${String(ppdInv.length).padStart(4)}   ${fmt(sum(ppdInv), cur)}`);
+      if (cancelledInv.length > 0) {
+        console.log(`  Canceladas     ${String(cancelledInv.length).padStart(4)}   ${pc11.dim(fmt(sum(cancelledInv), cur))}`);
+      }
+      console.log(`
+${pc11.bold(pc11.underline("Pagos"))}`);
+      console.log(`  Cobrados       ${String(succeededPay.length).padStart(4)}   ${pc11.green(fmt(sum(succeededPay), cur))}`);
+      if (pendingPay.length > 0) {
+        console.log(`  Pendientes     ${String(pendingPay.length).padStart(4)}   ${pc11.yellow(fmt(sum(pendingPay), cur))}`);
+      }
+      if (failedPay.length > 0) {
+        console.log(`  Fallidos       ${String(failedPay.length).padStart(4)}   ${pc11.red(fmt(sum(failedPay), cur))}`);
+      }
+      console.log(`
+${pc11.bold(pc11.underline("Recibos"))}`);
+      console.log(`  Total          ${String(rec.length).padStart(4)}   ${fmt(sum(rec), cur)}`);
+      if (pendingRec.length > 0) {
+        console.log(`  Por facturar   ${String(pendingRec.length).padStart(4)}   ${pc11.yellow(fmt(sum(pendingRec), cur))}`);
+      }
+      if (invoicedRec.length > 0) {
+        console.log(`  Facturados     ${String(invoicedRec.length).padStart(4)}   ${pc11.green(fmt(sum(invoicedRec), cur))}`);
+      }
+      if (ppdInv.length > 0) {
+        console.log(`
+${pc11.bold(pc11.underline("Cobranza PPD"))}`);
+        console.log(`  Pendientes     ${String(ppdWithBalance.length).padStart(4)}   ${ppdPendingTotal > 0 ? pc11.red(fmt(ppdPendingTotal, cur)) : pc11.green(fmt(0, cur))}`);
+        if (ppdPartial.length > 0) {
+          console.log(`  Pago parcial   ${String(ppdPartial.length).padStart(4)}`);
+        }
+        if (ppdPaid.length > 0) {
+          console.log(`  Liquidadas     ${String(ppdPaid.length).padStart(4)}   ${pc11.green(fmt(sum(ppdPaid), cur))}`);
+        }
+        const agingBuckets = [
+          { label: "0-15 d\xEDas", data: aging.current },
+          { label: "16-30 d\xEDas", data: aging.d30 },
+          { label: "31-60 d\xEDas", data: aging.d60 },
+          { label: "61-90 d\xEDas", data: aging.d90 },
+          { label: "+90 d\xEDas", data: aging.over90 }
+        ].filter((b) => b.data.length > 0);
+        if (agingBuckets.length > 0) {
+          console.log(pc11.dim("  Antig\xFCedad:"));
+          for (const bucket of agingBuckets) {
+            const bucketTotal = bucket.data.reduce((s, i) => s + i._balance, 0);
+            const color = bucket === agingBuckets[agingBuckets.length - 1] && bucket.data === aging.over90 ? pc11.red : pc11.yellow;
+            console.log(`    ${bucket.label.padEnd(12)} ${String(bucket.data.length).padStart(4)}   ${color(fmt(bucketTotal, cur))}`);
+          }
+        }
+      }
+      const invoicedTotal = sum(validInv);
+      const collectedTotal = sum(succeededPay);
+      const pendingRecTotal = sum(pendingRec);
+      const diff = collectedTotal - invoicedTotal;
+      console.log(`
+${pc11.bold(pc11.underline("Conciliaci\xF3n"))}`);
+      console.log(`  Facturado (PUE)          ${pc11.green(fmt(sum(pueInv), cur))}`);
+      console.log(`  Facturado (PPD)          ${fmt(sum(ppdInv), cur)}`);
+      console.log(`  Cobrado total            ${pc11.green(fmt(collectedTotal, cur))}`);
+      console.log(`  Recibos por facturar     ${pc11.yellow(fmt(pendingRecTotal, cur))}`);
+      if (Math.abs(diff) > 0.01) {
+        const diffColor = diff > 0 ? pc11.yellow : pc11.red;
+        console.log(`  Diferencia (cobro-fact)  ${diffColor(fmt(diff, cur))}`);
+      } else {
+        console.log(`  Diferencia               ${pc11.green("$0.00 \u2014 cuadrado")}`);
+      }
+      console.log();
+      if (team?.sat?.completed) {
+        console.log(`${pc11.green("\u25CF")} SAT conectado`);
+      } else {
+        console.log(`${pc11.red("\u25CF")} SAT no conectado`);
+      }
+      if (team?.billing?.credits !== void 0) {
+        const credits = team.billing.credits;
+        console.log(`${credits > 0 ? pc11.green("\u25CF") : pc11.red("\u25CF")} ${credits} cr\xE9ditos restantes`);
+      }
+      console.log();
+    } catch (e) {
+      console.error(pc11.red(`\u2717 ${e.message}`));
+    }
+  });
+}
+
+// src/commands/context.ts
+import pc12 from "picocolors";
+var KNOWLEDGE = {
+  payments: {
+    title: "Pagos (Payments)",
+    summary: "A payment represents money collected from a client. Payments can come from multiple sources (Stripe, PayPal, MercadoPago, bank transfer, cash, etc.) or be registered manually via the API/CLI. A payment is NOT an invoice \u2014 a payment triggers automations that can create invoices, receipts, or payment complements automatically.",
+    concepts: {
+      payment: "Money received from a client. Has items, a total, a currency, and a payment form (how the money was received).",
+      payment_form: "SAT-defined code for HOW money was received. 01=Cash, 03=Wire transfer, 04=Credit card, 28=Debit card, 99=To be defined.",
+      payment_method: "PUE (paid in full at once) or PPD (installments/deferred). Determines invoice type and whether payment complements are needed.",
+      automation_type: "What happens after payment is registered: 'pue_invoice' (stamp invoice immediately), 'ppd_invoice_and_complement' (create PPD invoice + complement), 'receipt' (create receipt for self-invoicing), 'none' (just record the payment).",
+      idempotency_key: "Unique key to prevent duplicate payments. Always use one when registering payments programmatically.",
+      payment_source: "Where the payment originated: stripe, paypal, mercadopago, openpay, conekta, clip, dlocal, woocommerce, shopify, manual, api."
+    },
+    statuses: {
+      pending: "Payment created but not yet collected. Client has not paid yet. Waiting for payment method or processing.",
+      requires_payment_method: "Payment link sent but client hasn't chosen how to pay yet.",
+      processing: "Payment is being processed by the payment processor (card charge in progress, etc.).",
+      succeeded: "Money collected successfully. Automations will fire (invoice, receipt, etc.).",
+      failed: "Payment attempt failed (card declined, insufficient funds, etc.). No money was collected.",
+      cancelled: "Payment was cancelled before collection. No money was collected.",
+      refunded: "Payment was collected but then returned to the client. A credit note (nota de cr\xE9dito) may be needed."
+    },
+    actions: {
+      "payments list": "List payments. Supports --limit, --next (cursor pagination), --from/--to (date filter), --sort, --order-by, --status, --client, --currency, --email, --rfc.",
+      "payments request": "Create a payment link. Client receives a URL to pay via card, bank, OXXO, etc. Supports --send-email.",
+      "payments register": "Record a payment already received (cash, wire transfer, etc.). Triggers automations. Supports --send-email.",
+      "payments refund <id>": "Refund a succeeded payment. Money returned to client.",
+      "pay": "Shortcut: register payment + auto-create client + send self-invoice portal. Best for quick charges."
+    },
+    relationships: [
+      "Payment \u2192 triggers automation \u2192 creates Invoice (PUE) or Invoice (PPD) + Complement",
+      "Payment \u2192 triggers automation \u2192 creates Receipt (for self-invoicing by client)",
+      "Payment succeeded \u2192 automation fires. Payment failed/cancelled \u2192 nothing happens.",
+      "Refunded payment \u2192 may need credit note (nota de cr\xE9dito / egress invoice)",
+      "A payment can have a client attached. If client has RFC, invoice is auto-stamped. If not, a receipt is created for self-invoicing."
+    ],
+    tips: [
+      "To charge someone: use 'gigstack pay' for the simplest flow.",
+      "To send a payment link: use 'gigstack payments request'.",
+      "To record money already received: use 'gigstack payments register'.",
+      "Pending payments are NOT missing money \u2014 they are payment links waiting for the client to pay.",
+      "'succeeded' is the only status that means money was actually collected.",
+      "Use --from/--to for date ranges, --status to filter by payment status, --currency for currency, --email or --rfc to find payments by client.",
+      "Pagination: the CLI shows a --next token at the bottom of results. Pass it to get the next page."
+    ]
+  },
+  invoices: {
+    title: "Facturas CFDI (Invoices)",
+    summary: "A CFDI invoice is a legally-binding Mexican tax document stamped by the SAT. There are 4 types: Income (I), Egress/Credit note (E), Payment complement (P), and Transfer (T). Invoices are created after a payment, manually, or via automation. An invoice is NOT a payment \u2014 it's the fiscal proof of a transaction.",
+    concepts: {
+      cfdi: "Comprobante Fiscal Digital por Internet \u2014 the official Mexican digital invoice format required by SAT.",
+      income_invoice: "Type 'I' (Ingreso). The most common: proves revenue was received. Created for each sale/payment.",
+      credit_note: "Type 'E' (Egreso). Cancels or reduces a previous income invoice. Used for refunds, discounts, returns.",
+      payment_complement: "Type 'P' (Pago). Required for PPD invoices to prove each installment payment was received. Links back to the original PPD invoice.",
+      transfer_invoice: "Type 'T' (Traslado). For transferring goods between locations. Rare in gigstack.",
+      pue: "Pago en Una sola Exhibici\xF3n \u2014 paid in full at once. One invoice, done. Most common for small transactions.",
+      ppd: "Pago en Parcialidades o Diferido \u2014 payment in installments or deferred. Requires payment complements for each payment received. The invoice is stamped first, payments come later.",
+      folio: "Sequential invoice number within a series (e.g., A-001, A-002). Managed by gigstack, no gaps.",
+      series: "Letter/prefix for invoice numbering (e.g., 'A', 'B', 'WEB'). Different series for different purposes.",
+      use_cfdi: "SAT code for how the client will use the invoice. G03=General expenses (most common), G01=Acquisition of merchandise, S01=No fiscal effects.",
+      global_invoice: "Monthly consolidated invoice for all receipts that were NOT self-invoiced by clients. Created by the EOM (End of Month) process."
+    },
+    statuses: {
+      valid: "Invoice is stamped and valid with the SAT. This is the normal state.",
+      cancelled: "Invoice was cancelled with the SAT. Requires a motive code (01-04).",
+      pending: "Invoice is being processed (rare, usually stamping is instant).",
+      draft: "Pre-invoice / borrador. Not yet stamped. Can be edited before stamping."
+    },
+    actions: {
+      "invoices list": "List invoices. Supports --limit, --next (cursor pagination), --from/--to (date filter), --sort, --order-by, --status, --client, --series.",
+      "invoices create": "Stamp a new income invoice (CFDI 4.0). Interactive or via flags. Supports --send-email and --emails.",
+      "invoices cancel <uuid>": "Cancel an invoice with the SAT. Requires --motive (01=replacement, 02=no commercial activity, 03=wrong operation, 04=related to global invoice).",
+      "invoices download <uuid>": "Download PDF and XML files to disk.",
+      "invoices files <uuid>": "Get PDF/XML download URLs.",
+      "invoices search <query>": "Search invoices by client name, RFC, or UUID.",
+      "invoices drafts list": "List pre-invoices that haven't been stamped yet.",
+      "invoices drafts stamp <uuid>": "Stamp a draft, converting it to a real CFDI.",
+      "invoices credit-notes": "List credit notes (egress invoices).",
+      "invoices complements": "List payment complements. Supports --invoice <uuid> to filter by parent PPD invoice."
+    },
+    relationships: [
+      "Payment (succeeded) \u2192 triggers \u2192 Income Invoice (PUE) \u2014 one invoice per payment.",
+      "Payment (succeeded) \u2192 triggers \u2192 Income Invoice (PPD) + Payment Complement \u2014 invoice first, complement proves each payment.",
+      "PPD Invoice \u2192 needs Payment Complements to track installment payments. Without complements, the PPD invoice is 'unpaid'.",
+      "Receipt (not self-invoiced) \u2192 grouped at End of Month \u2192 Global Invoice.",
+      "Invoice cancelled \u2192 may need replacement invoice (motive 01) or credit note.",
+      "Credit note (E) \u2192 reduces/cancels a previous income invoice (I)."
+    ],
+    tips: [
+      "PPD invoices with last_balance > 0 are unpaid or partially paid \u2014 this is your 'cobranza' (collections).",
+      "PUE invoices are fully paid by definition \u2014 the payment happened before/at stamping.",
+      "Don't confuse invoice status with payment status. An invoice can be 'valid' but the PPD payment still pending.",
+      "Cancelled invoices need a motive. Use 01 if you're replacing it, 02-04 for other reasons.",
+      "Use --status to filter by invoice status (valid, cancelled, pending), --client for client ID, --series for invoice series.",
+      "Use --from/--to for date ranges. Pagination: the CLI shows a --next token at the bottom of results."
+    ]
+  },
+  receipts: {
+    title: "Recibos de Venta (Sales Receipts)",
+    summary: "A receipt is a NON-fiscal sales document generated when a payment is received but the client hasn't provided their fiscal data (RFC) for invoicing. The receipt includes a link to a self-invoice portal where the client can enter their RFC and generate their own CFDI invoice. Receipts that are NOT self-invoiced by month end are grouped into a 'global invoice'. A receipt is NOT a missing payment \u2014 the money was already collected.",
+    concepts: {
+      receipt: "Proof of sale WITHOUT fiscal value. Generated when payment is received but client RFC is unknown.",
+      self_invoice_portal: "Web page where the client enters their RFC and fiscal data to generate their own CFDI from the receipt. URL sent via email automatically.",
+      global_invoice: "At end of month, all receipts NOT self-invoiced are grouped into one consolidated CFDI invoice to 'p\xFAblico general' (XAXX010101000). This fulfills the fiscal obligation.",
+      eom: "End of Month process. Runs daily at 23:59 Mexico City time. Groups pending receipts \u2192 global invoices."
+    },
+    statuses: {
+      pending: "Receipt created, waiting for client to self-invoice. The money IS collected \u2014 only the CFDI is missing.",
+      open: "Same as pending \u2014 receipt is available for self-invoicing.",
+      invoiced: "Client completed self-invoicing. A CFDI was generated from this receipt.",
+      completed: "Same as invoiced \u2014 receipt was converted to a CFDI.",
+      expired: "Self-invoice window closed. Receipt will be included in the global invoice at EOM.",
+      cancelled: "Receipt was cancelled. Will not be included in any invoice."
+    },
+    actions: {
+      "receipts list": "List all receipts. Supports --limit, --next (cursor pagination), --from/--to (date filter), --sort, --order-by, --status, --client.",
+      "receipts stamp <id>": "Manually stamp a receipt (generate invoice from it).",
+      "receipts cancel <id>": "Cancel a receipt."
+    },
+    relationships: [
+      "Payment (succeeded, no client RFC) \u2192 creates Receipt \u2192 client self-invoices \u2192 Income Invoice.",
+      "Receipt (pending at EOM) \u2192 grouped into Global Invoice to p\xFAblico general.",
+      "Receipt pending does NOT mean payment pending. The money is collected. Only the CFDI is missing.",
+      "Receipt amount = payment amount. There is no 'debt' on a receipt \u2014 it's a documentation task, not a collection task."
+    ],
+    tips: [
+      "IMPORTANT: 'Receipts pending' means self-invoicing is pending, NOT that money is owed. The payment was already collected.",
+      "If you want to know who owes you money, look at PPD invoices with balance > 0 (cobranza), NOT at pending receipts.",
+      "To reduce pending receipts, remind clients to self-invoice before month end.",
+      "Global invoicing at EOM handles the fiscal obligation for any receipt not self-invoiced.",
+      "Use --status to filter receipts (pending, invoiced, expired, cancelled), --client for client ID.",
+      "Pagination: the CLI shows a --next token at the bottom of results. Pass it to get the next page."
+    ]
+  },
+  clients: {
+    title: "Clientes (Clients)",
+    summary: "A client represents a person or company you transact with. Clients have fiscal data (RFC, tax system, address) needed for invoicing. Clients can be created manually or auto-created when registering a payment with client search.",
+    concepts: {
+      rfc: "Registro Federal de Contribuyentes \u2014 Mexican tax ID. Required for invoicing. Format: 12-13 alphanumeric characters.",
+      tax_system: "R\xE9gimen fiscal \u2014 SAT tax regime code. Common: 601 (General/Corp), 612 (Business individual), 616 (No obligations), 626 (RESICO).",
+      use_cfdi: "How the client will use the invoice. G03 (general expenses) is the safe default.",
+      publico_general: "Generic client (XAXX010101000) used for global invoices when no specific client RFC is available.",
+      auto_create: "When registering a payment, you can pass client.search with auto_create=true. If the client doesn't exist, it's created automatically."
+    },
+    statuses: {
+      is_valid: "Client's fiscal data has been validated against the SAT."
+    },
+    actions: {
+      "clients list": "List clients. Supports --limit, --next (cursor pagination), --from/--to (date filter), --sort, --order-by.",
+      "clients create": "Create a client interactively or via flags.",
+      "clients update <id>": "Update client fiscal data (name, RFC, tax system, etc.).",
+      "clients search <query>": "Search by name, RFC, or email.",
+      "clients validate <id>": "Validate client's fiscal data against the SAT.",
+      "clients delete <id>": "Delete a client."
+    },
+    relationships: [
+      "Client \u2192 attached to Payments, Invoices, Receipts.",
+      "Client with RFC \u2192 payment triggers invoice automation.",
+      "Client without RFC \u2192 payment triggers receipt (self-invoice portal).",
+      "Client.search in payment body \u2192 auto-find or auto-create client by RFC or email."
+    ],
+    tips: [
+      "Always validate new clients with 'clients validate' to avoid CFDI stamping errors.",
+      "Use client.search with auto_create when registering payments \u2014 avoids manual client creation.",
+      "You can search clients by ID directly: pass the client_xxx ID in the search prompt."
+    ]
+  },
+  cobranza: {
+    title: "Cobranza (Collections / Accounts Receivable)",
+    summary: "Cobranza tracks money that is OWED to you. Only PPD invoices can have outstanding balances \u2014 PUE invoices are paid in full by definition. Receipts are NOT cobranza: receipt money is already collected, only the self-invoice is pending. To find who owes you money, look at PPD invoices where last_balance > 0.",
+    concepts: {
+      ppd_balance: "The remaining amount on a PPD invoice. Starts at the invoice total, decreases with each payment complement. When balance = 0, the invoice is fully paid.",
+      payment_complement: "CFDI type 'P' \u2014 proves a payment was received against a PPD invoice. Each complement reduces the PPD balance.",
+      installment: "Each payment complement is an installment. Installment 1 is the first payment, 2 is the second, etc.",
+      aging: "How many days since the PPD invoice was created. Older = higher risk of non-payment. Buckets: 0-15, 16-30, 31-60, 61-90, 90+ days.",
+      partial_payment: "A PPD invoice where some payment complements exist but balance > 0. Client started paying but hasn't finished."
+    },
+    statuses: {
+      "last_balance > 0, complements = 0": "PPD invoice with NO payments received. Full amount is outstanding.",
+      "last_balance > 0, complements > 0": "Partial payment. Some money received, but balance remains.",
+      "last_balance = 0": "Fully paid. All payment complements received. No action needed."
+    },
+    actions: {
+      "status": "Run 'gigstack status' to see cobranza summary with aging breakdown.",
+      "invoices list --json": "Get all invoices as JSON, filter by payment_method=PPD and last_balance > 0 to find outstanding invoices.",
+      "invoices complements": "List payment complements to see which PPD invoices have received payments."
+    },
+    relationships: [
+      "PPD Invoice (last_balance > 0) = money owed to you = cobranza.",
+      "PUE Invoice = already paid, never appears in cobranza.",
+      "Receipt pending = money already collected, NOT cobranza. Only the self-invoice document is missing.",
+      "Payment complement received \u2192 reduces PPD balance \u2192 moves toward fully paid."
+    ],
+    tips: [
+      "CRITICAL: Receipts are NOT cobranza. A pending receipt means the client hasn't self-invoiced yet, but the MONEY IS ALREADY COLLECTED.",
+      "To find who owes money: filter PPD invoices where last_balance > 0.",
+      "Prioritize by aging: invoices over 90 days are at highest risk of non-payment.",
+      "Partial payments (balance > 0 but complements > 0) need a nudge \u2014 the client started paying but stopped.",
+      "'gigstack status' shows a complete cobranza breakdown with aging buckets.",
+      "Use 'gigstack invoices list --status valid --json' and filter client-side by payment_method=PPD and last_balance > 0 for collections data. Server-side payment_method filter is not yet available."
+    ]
+  },
+  automations: {
+    title: "Automatizaciones (Automations)",
+    summary: "Automations are actions triggered by events (mainly payments). When a payment is registered or received via webhook, gigstack can automatically create invoices, receipts, payment complements, or send emails. Automations are configured per team and can be overridden per payment.",
+    concepts: {
+      pue_invoice: "Automation: stamp a PUE income invoice immediately when payment succeeds.",
+      ppd_invoice_and_complement: "Automation: stamp a PPD invoice (if not exists) and a payment complement for this payment.",
+      receipt: "Automation: create a receipt with self-invoice portal link. Used when client RFC is unknown.",
+      none: "No automation. Just record the payment, do nothing else.",
+      stamp_invoice: "Legacy automation name, equivalent to pue_invoice in the payments/register endpoint."
+    },
+    relationships: [
+      "Payment registered with automation_type \u2192 proserver fires the automation.",
+      "Webhook payment (Stripe, PayPal, etc.) \u2192 uses team's default automation config.",
+      "Manual payment (API/CLI) \u2192 uses the automation_type specified in the request."
+    ],
+    tips: [
+      "Default automation for 'gigstack pay' is pue_invoice \u2014 stamps an invoice immediately.",
+      "Use 'none' if you just want to record the payment without any fiscal documents.",
+      "PPD automations are for installment scenarios \u2014 the invoice is created once, complements are added per payment."
+    ]
+  },
+  services: {
+    title: "Servicios/Productos (Services/Products)",
+    summary: "Services are your product/service catalog. Each service has a description, price, SAT product key, and SAT unit key. Services can be reused across invoices and payments to avoid re-entering item details.",
+    concepts: {
+      product_key: "SAT catalog code for the product/service. Common: 84111506 (consulting), 80161500 (admin services), 43232100 (software licenses).",
+      unit_key: "SAT unit code. Common: E48 (service unit), H87 (piece), ACT (activity), HUR (hour), DAY (day).",
+      taxes: "Tax configuration per service. Typically IVA 16% (type: 'IVA', rate: 0.16, factor: 'Tasa'). Can include withholdings (retenciones)."
+    },
+    actions: {
+      "services list": "List all services in your catalog. Supports --limit, --next (cursor pagination), --sort, --order-by.",
+      "services create": "Create a new service with SAT keys and pricing.",
+      "services update <id>": "Update service description, price, or SAT keys.",
+      "services delete <id>": "Delete a service."
+    },
+    tips: [
+      "Create services for your common offerings to avoid retyping SAT keys every time.",
+      "IVA 16% is the standard tax rate in Mexico. Add it to most services unless exempt.",
+      "Product key 84111506 and unit key E48 are safe defaults for professional services."
+    ]
+  },
+  webhooks: {
+    title: "Webhooks",
+    summary: "Webhooks let you receive real-time notifications when events happen in gigstack (invoice created, payment received, etc.). Configure a URL and optionally filter by event types.",
+    concepts: {
+      events: "Event types you can subscribe to: invoice.created, invoice.cancelled, payment.succeeded, payment.failed, receipt.created, etc."
+    },
+    actions: {
+      "webhooks list": "List configured webhooks.",
+      "webhooks create": "Create a webhook with a URL and optional event filter.",
+      "webhooks delete <id>": "Delete a webhook."
+    },
+    tips: [
+      "If no events are specified, the webhook receives ALL events.",
+      "Webhooks include a signature header for verification."
+    ]
+  }
+};
+var TOPIC_LIST = Object.keys(KNOWLEDGE);
+function registerContextCommand(program2) {
+  program2.command("context [topic]").description("Domain knowledge for agents: understand gigstack concepts, statuses, and relationships").option("--short", "Brief summary only").option("--all", "Dump all topics at once (for AI agents to load full domain knowledge)").action((topic, opts) => {
+    if (opts.all) {
+      if (isJsonMode()) {
+        const topics = {};
+        for (const [id, t2] of Object.entries(KNOWLEDGE)) {
+          topics[id] = t2;
+        }
+        return printJson({ topics });
+      }
+      console.log(pc12.bold("\ngigstack context --all \u2014 full domain knowledge\n"));
+      for (const [id, t2] of Object.entries(KNOWLEDGE)) {
+        console.log(`${pc12.bold(pc12.underline(t2.title))} ${pc12.dim(`(${id})`)}`);
+        console.log(`${t2.summary}
+`);
+      }
+      return;
+    }
+    if (!topic) {
+      if (isJsonMode()) {
+        return printJson({ topics: TOPIC_LIST.map((t2) => ({ id: t2, title: KNOWLEDGE[t2].title, summary: KNOWLEDGE[t2].summary })) });
+      }
+      console.log(pc12.bold("\ngigstack context \u2014 domain knowledge for agents\n"));
+      console.log("Available topics:\n");
+      for (const [id, t2] of Object.entries(KNOWLEDGE)) {
+        console.log(`  ${pc12.bold(id.padEnd(14))} ${t2.title}`);
+        console.log(`  ${" ".repeat(14)} ${pc12.dim(t2.summary.slice(0, 90))}\u2026
+`);
+      }
+      console.log(pc12.dim(`Usage: gigstack context <topic> [--json] [--short] [--all]
+`));
+      return;
+    }
+    const t = KNOWLEDGE[topic.toLowerCase()];
+    if (!t) {
+      console.error(pc12.red(`Unknown topic: ${topic}`));
+      console.log(pc12.dim(`Available: ${TOPIC_LIST.join(", ")}`));
+      process.exit(1);
+    }
+    if (isJsonMode()) {
+      return printJson(t);
+    }
+    console.log(`
+${pc12.bold(pc12.underline(t.title))}
+`);
+    console.log(t.summary);
+    if (opts.short) {
+      console.log();
+      return;
+    }
+    console.log(`
+${pc12.bold("Concepts:")}`);
+    for (const [k, v] of Object.entries(t.concepts)) {
+      console.log(`  ${pc12.cyan(k.padEnd(28))} ${v}`);
+    }
+    if (t.statuses) {
+      console.log(`
+${pc12.bold("Statuses:")}`);
+      for (const [k, v] of Object.entries(t.statuses)) {
+        console.log(`  ${pc12.yellow(k.padEnd(28))} ${v}`);
+      }
+    }
+    if (t.actions) {
+      console.log(`
+${pc12.bold("CLI Actions:")}`);
+      for (const [k, v] of Object.entries(t.actions)) {
+        console.log(`  ${pc12.green(("gigstack " + k).padEnd(38))} ${v}`);
+      }
+    }
+    if (t.relationships) {
+      console.log(`
+${pc12.bold("Relationships:")}`);
+      for (const r of t.relationships) {
+        console.log(`  ${pc12.dim("\u2192")} ${r}`);
+      }
+    }
+    if (t.tips) {
+      console.log(`
+${pc12.bold("Agent Tips:")}`);
+      for (const tip of t.tips) {
+        console.log(`  ${pc12.dim("!")} ${tip}`);
+      }
+    }
+    console.log();
+  });
+}
+
+// src/commands/completions.ts
+var COMMANDS = {
+  "": [
+    "login",
+    "logout",
+    "whoami",
+    "switch",
+    "profiles",
+    "context",
+    "status",
+    "doctor",
+    "pay",
+    "clients",
+    "invoices",
+    "payments",
+    "services",
+    "webhooks",
+    "receipts",
+    "teams",
+    "export",
+    "completions"
+  ],
+  clients: ["list", "get", "create", "update", "search", "validate", "delete"],
+  invoices: ["list", "get", "create", "cancel", "search", "files", "download", "drafts", "credit-notes", "complements"],
+  payments: ["list", "get", "request", "register", "refund"],
+  services: ["list", "get", "create", "update", "delete"],
+  receipts: ["list", "stamp", "cancel"],
+  webhooks: ["list", "create", "delete"],
+  teams: ["list", "get", "integrations"],
+  export: ["invoices", "payments", "receipts", "clients"],
+  context: ["payments", "invoices", "receipts", "clients", "cobranza", "automations", "services", "webhooks"],
+  completions: ["bash", "zsh", "fish"]
+};
+function bashScript() {
+  const topLevel = COMMANDS[""].join(" ");
+  const cases = Object.entries(COMMANDS).filter(([k]) => k !== "").map(([cmd, subs]) => `      ${cmd}) COMPREPLY=( $(compgen -W "${subs.join(" ")}" -- "$cur") ) ;;`).join("\n");
+  return `# gigstack bash completion
+# Add to ~/.bashrc: eval "$(gigstack completions bash)"
+_gigstack_completions() {
+  local cur prev words cword
+  _init_completion || return
+
+  local top_commands="${topLevel}"
+
+  if [[ $cword -eq 1 ]]; then
+    COMPREPLY=( $(compgen -W "$top_commands" -- "$cur") )
+    return
+  fi
+
+  case "\${words[1]}" in
+${cases}
+  esac
+}
+
+complete -F _gigstack_completions gigstack
+`;
+}
+function zshScript() {
+  const topLevel = COMMANDS[""].join(" ");
+  const cases = Object.entries(COMMANDS).filter(([k]) => k !== "").map(([cmd, subs]) => `      ${cmd}) compadd -- ${subs.join(" ")} ;;`).join("\n");
+  return `# gigstack zsh completion
+# Add to ~/.zshrc: eval "$(gigstack completions zsh)"
+_gigstack_completions() {
+  local -a top_commands
+  top_commands=(${topLevel})
+
+  if (( CURRENT == 2 )); then
+    compadd -- \${top_commands[@]}
+    return
+  fi
+
+  case "\${words[2]}" in
+${cases}
+  esac
+}
+
+compdef _gigstack_completions gigstack
+`;
+}
+function fishScript() {
+  const lines = [
+    "# gigstack fish completion",
+    "# Save to ~/.config/fish/completions/gigstack.fish",
+    "",
+    "# Disable file completions",
+    "complete -c gigstack -f",
+    "",
+    "# Top-level commands"
+  ];
+  for (const cmd of COMMANDS[""]) {
+    lines.push(`complete -c gigstack -n '__fish_use_subcommand' -a '${cmd}'`);
+  }
+  lines.push("");
+  for (const [cmd, subs] of Object.entries(COMMANDS)) {
+    if (cmd === "") continue;
+    lines.push(`# ${cmd} subcommands`);
+    for (const sub of subs) {
+      lines.push(`complete -c gigstack -n '__fish_seen_subcommand_from ${cmd}' -a '${sub}'`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n") + "\n";
+}
+function registerCompletionsCommand(program2) {
+  program2.command("completions").description("Generar script de autocompletado para tu shell").argument("<shell>", "Shell: bash, zsh, o fish").action((shell) => {
+    switch (shell) {
+      case "bash":
+        process.stdout.write(bashScript());
+        break;
+      case "zsh":
+        process.stdout.write(zshScript());
+        break;
+      case "fish":
+        process.stdout.write(fishScript());
+        break;
+      default:
+        console.error(`Shell no soportado: ${shell}. Usa bash, zsh, o fish.`);
+        process.exit(1);
+    }
+  });
+}
+
+// src/commands/export.ts
+var INVOICE_COLUMNS = [
+  { key: "uuid", extract: (i) => i.uuid || "" },
+  { key: "status", extract: (i) => i.status || "" },
+  { key: "payment_method", extract: (i) => i.payment_method || "" },
+  { key: "payment_form", extract: (i) => i.payment_form || "" },
+  { key: "client_name", extract: (i) => i.client?.legal_name || i.client?.name || "" },
+  { key: "client_rfc", extract: (i) => i.client?.tax_id || "" },
+  { key: "client_email", extract: (i) => i.client?.email || "" },
+  { key: "subtotal", extract: (i) => String(i.subtotal ?? "") },
+  { key: "total", extract: (i) => String(i.total ?? "") },
+  { key: "currency", extract: (i) => i.currency || "" },
+  { key: "series", extract: (i) => i.series || "" },
+  { key: "folio_number", extract: (i) => String(i.folio_number ?? "") },
+  { key: "last_balance", extract: (i) => String(i.last_balance ?? "") },
+  { key: "created_at", extract: (i) => formatDate(i.created_at) }
+];
+var PAYMENT_COLUMNS = [
+  { key: "id", extract: (p) => p.id || "" },
+  { key: "status", extract: (p) => p.status || "" },
+  { key: "client_name", extract: (p) => p.client?.legal_name || p.client?.name || "" },
+  { key: "client_rfc", extract: (p) => p.client?.tax_id || "" },
+  { key: "client_email", extract: (p) => p.client?.email || "" },
+  { key: "total", extract: (p) => String(p.total ?? "") },
+  { key: "currency", extract: (p) => p.currency || "" },
+  { key: "payment_form", extract: (p) => p.payment_form || "" },
+  { key: "short_url", extract: (p) => p.short_url || "" },
+  { key: "created_at", extract: (p) => formatDate(p.created_at) }
+];
+var RECEIPT_COLUMNS = [
+  { key: "id", extract: (r) => r.id || "" },
+  { key: "status", extract: (r) => r.status || "" },
+  { key: "client_name", extract: (r) => r.client?.legal_name || r.client?.name || "" },
+  { key: "client_rfc", extract: (r) => r.client?.tax_id || "" },
+  { key: "total", extract: (r) => String(r.total ?? "") },
+  { key: "currency", extract: (r) => r.currency || "" },
+  { key: "validUntil", extract: (r) => formatDate(r.validUntil) },
+  { key: "created_at", extract: (r) => formatDate(r.created_at) }
+];
+var CLIENT_COLUMNS = [
+  { key: "id", extract: (c) => c.id || "" },
+  { key: "legal_name", extract: (c) => c.legal_name || c.name || "" },
+  { key: "tax_id", extract: (c) => c.tax_id || "" },
+  { key: "email", extract: (c) => c.email || "" },
+  { key: "tax_system", extract: (c) => c.tax_system || "" },
+  { key: "use", extract: (c) => c.use || "" },
+  { key: "zip", extract: (c) => c.address?.zip || "" },
+  { key: "is_valid", extract: (c) => c.is_valid === void 0 ? "" : String(c.is_valid) },
+  { key: "created_at", extract: (c) => formatDate(c.created_at) }
+];
+function csvEscape(value) {
+  if (value.includes(",") || value.includes('"') || value.includes("\n")) {
+    return `"${value.replace(/"/g, '""')}"`;
+  }
+  return value;
+}
+function toCsvRow(columns, item) {
+  return columns.map((col) => csvEscape(col.extract(item))).join(",");
+}
+function csvHeader(columns) {
+  return columns.map((col) => csvEscape(col.key)).join(",");
+}
+async function fetchAllPages(endpoint, baseQuery, team) {
+  const all = [];
+  let nextToken;
+  let page = 0;
+  baseQuery.limit = "100";
+  let s = spinner("Exportando datos\u2026");
+  try {
+    do {
+      const query = { ...baseQuery };
+      if (nextToken) query.next = nextToken;
+      const res = await api("GET", endpoint, { query, team });
+      const items = (res.data || []).filter((r) => r != null);
+      all.push(...items);
+      page++;
+      nextToken = res.has_more && res.next ? res.next : void 0;
+      s.stop();
+      if (nextToken) {
+        s = spinner(`Exportando datos\u2026 (${all.length} registros, p\xE1gina ${page + 1})`);
+      }
+    } while (nextToken);
+  } finally {
+    s.stop();
+  }
+  process.stderr.write(`Exportados ${all.length} registros
+`);
+  return all;
+}
+var SUBCOMMANDS = [
+  {
+    name: "invoices",
+    description: "Exportar facturas de ingreso",
+    endpoint: "/invoices/income",
+    columns: INVOICE_COLUMNS,
+    extraOpts: (cmd) => cmd.option("--status <status>", "Filtrar por status (valid, cancelled)").option("--client <id>", "Filtrar por cliente").option("--series <series>", "Filtrar por serie"),
+    applyFilters: (opts, query) => {
+      if (opts.status) query.status = opts.status;
+      if (opts.client) query.client_id = opts.client;
+      if (opts.series) query.series = opts.series;
+    }
+  },
+  {
+    name: "payments",
+    description: "Exportar pagos",
+    endpoint: "/payments",
+    columns: PAYMENT_COLUMNS,
+    extraOpts: (cmd) => cmd.option("--status <status>", "Filtrar: pending, succeeded, failed, cancelled, refunded").option("--client <id>", "Filtrar por cliente").option("--currency <code>", "Filtrar por moneda (MXN, USD)").option("--email <email>", "Filtrar por email del cliente").option("--rfc <rfc>", "Filtrar por RFC del cliente"),
+    applyFilters: (opts, query) => {
+      if (opts.status) query.status = opts.status;
+      if (opts.client) query.client_id = opts.client;
+      if (opts.currency) query.currency = opts.currency;
+      if (opts.email) query.email = opts.email;
+      if (opts.rfc) query.tax_id = opts.rfc;
+    }
+  },
+  {
+    name: "receipts",
+    description: "Exportar recibos de venta",
+    endpoint: "/receipts",
+    columns: RECEIPT_COLUMNS,
+    extraOpts: (cmd) => cmd.option("--status <status>", "Filtrar: pending, open, invoiced, completed, expired, cancelled").option("--client <id>", "Filtrar por cliente"),
+    applyFilters: (opts, query) => {
+      if (opts.status) query.status = opts.status;
+      if (opts.client) query.client_id = opts.client;
+    }
+  },
+  {
+    name: "clients",
+    description: "Exportar clientes",
+    endpoint: "/clients",
+    columns: CLIENT_COLUMNS
+  }
+];
+function registerExportCommand(program2) {
+  const exportCmd = program2.command("export").description("Exportar datos a CSV o JSON (stdout)");
+  for (const sub of SUBCOMMANDS) {
+    let cmd = exportCmd.command(sub.name).description(sub.description).option("--from <date>", "Fecha inicio (YYYY-MM-DD, YYYY-MM, 30d, 7d)").option("--to <date>", "Fecha fin (YYYY-MM-DD, YYYY-MM, today)").option("--sort <dir>", "Orden: asc o desc", "desc").option("--order-by <field>", "Ordenar por: timestamp o name", "timestamp").option("--format <fmt>", "Formato de salida: csv o json", "csv").option("--team <id>", "Team ID");
+    if (sub.extraOpts) cmd = sub.extraOpts(cmd);
+    cmd.action(async (opts) => {
+      try {
+        const query = buildListQuery(opts);
+        if (sub.applyFilters) sub.applyFilters(opts, query);
+        const items = await fetchAllPages(sub.endpoint, query, opts.team);
+        if (opts.format === "json") {
+          process.stdout.write(JSON.stringify(items, null, 2) + "\n");
+        } else {
+          process.stdout.write(csvHeader(sub.columns) + "\n");
+          for (const item of items) {
+            process.stdout.write(toCsvRow(sub.columns, item) + "\n");
+          }
+        }
+      } catch (e) {
+        error(e.message);
+        process.exit(1);
+      }
+    });
+  }
+}
+
+// src/commands/explain.ts
+import pc13 from "picocolors";
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function detectType(id) {
+  if (id.startsWith("client_") || id.startsWith("cus_")) return "client";
+  if (id.startsWith("payment_")) return "payment";
+  if (id.startsWith("receipt_")) return "receipt";
+  if (id.startsWith("service_")) return "service";
+  if (UUID_RE.test(id)) return "invoice";
+  return null;
+}
+async function fetchInvoice(id, team) {
+  const res = await api("GET", `/invoices/income/${id}`, { team });
+  return { type: "invoice", data: res.data };
+}
+async function fetchPayment(id, team) {
+  const res = await api("GET", `/payments/${id}`, { team });
+  return { type: "payment", data: res.data };
+}
+async function fetchReceipt(id, team) {
+  const res = await api("GET", `/receipts/${id}`, { team });
+  return { type: "receipt", data: res.data };
+}
+async function fetchClient(id, team) {
+  const res = await api("GET", `/clients/${id}`, { team });
+  return { type: "client", data: res.data };
+}
+async function fetchService(id, team) {
+  const res = await api("GET", `/services/${id}`, { team });
+  return { type: "service", data: res.data };
+}
+async function fetchByType(type, id, team) {
+  switch (type) {
+    case "invoice":
+      return fetchInvoice(id, team);
+    case "payment":
+      return fetchPayment(id, team);
+    case "receipt":
+      return fetchReceipt(id, team);
+    case "client":
+      return fetchClient(id, team);
+    case "service":
+      return fetchService(id, team);
+  }
+}
+async function tryAll(id, team) {
+  const order = ["payment", "invoice", "receipt", "client", "service"];
+  for (const type of order) {
+    try {
+      return await fetchByType(type, id, team);
+    } catch {
+    }
+  }
+  throw new Error(`No se encontr\xF3 ning\xFAn recurso con ID: ${id}`);
+}
+function explainInvoice(i) {
+  const clientName = i.client?.legal_name || i.client?.name || "desconocido";
+  const isPPD = (i.payment_method || "").toUpperCase() === "PPD";
+  const isCancelled = (i.status || "").toLowerCase() === "cancelled";
+  printKeyValue({
+    UUID: i.uuid || i.id || "\u2014",
+    Tipo: "Factura de ingreso",
+    Status: i.status || "\u2014",
+    Cliente: clientName,
+    RFC: i.client?.tax_id || "\u2014",
+    Subtotal: formatMoney(i.subtotal, i.currency),
+    Total: formatMoney(i.total, i.currency),
+    "M\xE9todo pago": i.payment_method || "\u2014",
+    "Forma pago": i.payment_form || "\u2014",
+    Serie: i.series || "\u2014",
+    Folio: i.folio_number || "\u2014",
+    Creado: formatDate(i.created_at)
+  });
+  if (isPPD) {
+    console.log("");
+    console.log(pc13.bold(pc13.yellow("PPD \u2014 Pago en parcialidades")));
+    console.log(`  Saldo pendiente: ${i.last_balance !== void 0 ? formatMoney(i.last_balance, i.currency) : "desconocido"}`);
+    console.log(`  Complementos: ${i.payment_complements ?? 0}`);
+    const fullyPaid = i.last_balance !== void 0 && i.last_balance <= 0;
+    console.log(`  Liquidada: ${fullyPaid ? pc13.green("S\xED") : pc13.yellow("No")}`);
+  }
+  if (isCancelled) {
+    console.log("");
+    console.log(pc13.bold(pc13.red("Cancelada")));
+    if (i.cancellation_status) console.log(`  Status cancelaci\xF3n: ${i.cancellation_status}`);
+    if (i.cancellation_receipt) console.log(`  Acuse: ${i.cancellation_receipt}`);
+  }
+  console.log("");
+  const methodLabel = isPPD ? "PPD" : "PUE";
+  let narrative = `Factura de ingreso ${methodLabel} por ${formatMoney(i.total, i.currency)} a ${clientName} creada el ${formatDate(i.created_at)}.`;
+  if (isCancelled) {
+    narrative += ` Status: ${pc13.red("cancelada")}.`;
+  } else if (isPPD && i.last_balance !== void 0 && i.last_balance <= 0) {
+    narrative += ` Status: ${pc13.green("v\xE1lida")} \u2014 completamente liquidada con ${i.payment_complements ?? 0} complemento(s).`;
+  } else if (isPPD) {
+    narrative += ` Status: ${pc13.yellow("v\xE1lida")} \u2014 saldo pendiente ${formatMoney(i.last_balance, i.currency)}.`;
+  } else {
+    narrative += ` Status: ${pc13.green("v\xE1lida")}.`;
+  }
+  console.log(pc13.dim(narrative));
+}
+function explainPayment(p) {
+  const clientName = p.client?.legal_name || p.client?.name || "desconocido";
+  printKeyValue({
+    ID: p.id || "\u2014",
+    Tipo: "Pago",
+    Status: p.status || "\u2014",
+    Cliente: clientName,
+    Email: p.client?.email || "\u2014",
+    RFC: p.client?.tax_id || "\u2014",
+    Total: formatMoney(p.total, p.currency),
+    "Forma pago": p.payment_form || "\u2014",
+    Procesador: p.processor || p.payment_processor || "\u2014",
+    "Link de pago": p.short_url || "\u2014",
+    Creado: formatDate(p.created_at)
+  });
+  if (p.automation_type || p.invoice_id || p.invoice?.uuid) {
+    console.log("");
+    console.log(pc13.bold("Automatizaci\xF3n"));
+    if (p.automation_type) console.log(`  Tipo: ${p.automation_type}`);
+    const invoiceRef2 = p.invoice?.uuid || p.invoice_id || p.invoiceId;
+    if (invoiceRef2) console.log(`  Factura generada: ${invoiceRef2}`);
+    if (p.receipt_id || p.receiptId) console.log(`  Recibo generado: ${p.receipt_id || p.receiptId}`);
+  }
+  console.log("");
+  const formLabel = p.payment_form ? ` via forma ${p.payment_form}` : "";
+  const processorLabel = p.processor || p.payment_processor ? ` (${p.processor || p.payment_processor})` : "";
+  let narrative = `Pago de ${formatMoney(p.total, p.currency)} recibido de ${clientName} el ${formatDate(p.created_at)}${formLabel}${processorLabel}.`;
+  narrative += ` Status: ${p.status || "desconocido"}.`;
+  const invoiceRef = p.invoice?.uuid || p.invoice_id || p.invoiceId;
+  if (invoiceRef) narrative += ` Se gener\xF3 factura ${invoiceRef}.`;
+  const receiptRef = p.receipt_id || p.receiptId;
+  if (receiptRef) narrative += ` Se gener\xF3 recibo ${receiptRef}.`;
+  console.log(pc13.dim(narrative));
+}
+async function explainClient(c, team) {
+  printKeyValue({
+    ID: c.id || "\u2014",
+    Tipo: "Cliente",
+    Nombre: c.legal_name || c.name || "\u2014",
+    RFC: c.tax_id || "\u2014",
+    Email: c.email || "\u2014",
+    "R\xE9gimen fiscal": c.tax_system || "\u2014",
+    "Uso CFDI": c.use || "\u2014",
+    "C\xF3digo postal": c.address?.zip || "\u2014",
+    V\u00E1lido: c.is_valid ? pc13.green("S\xED") : pc13.yellow("No"),
+    Creado: formatDate(c.created_at)
+  });
+  let invoiceCount = 0;
+  let paymentCount = 0;
+  try {
+    const invoiceRes = await api("GET", "/invoices/income", { query: { client_id: c.id, limit: "1" }, team });
+    invoiceCount = invoiceRes.pagination?.totalItems ?? (invoiceRes.data || []).length;
+  } catch {
+  }
+  try {
+    const paymentRes = await api("GET", "/payments", { query: { client_id: c.id, limit: "1" }, team });
+    paymentCount = paymentRes.pagination?.totalItems ?? (paymentRes.data || []).length;
+  } catch {
+  }
+  console.log("");
+  console.log(pc13.bold("Actividad"));
+  console.log(`  Facturas: ${invoiceCount}`);
+  console.log(`  Pagos: ${paymentCount}`);
+  console.log("");
+  const clientName = c.legal_name || c.name || "desconocido";
+  const rfcLabel = c.tax_id ? `RFC: ${c.tax_id}` : "sin RFC";
+  const validLabel = c.is_valid ? "datos fiscales v\xE1lidos" : "datos fiscales sin validar";
+  const narrative = `Cliente ${clientName} (${rfcLabel}). ${invoiceCount} factura(s), ${paymentCount} pago(s) registrados. ${validLabel}.`;
+  console.log(pc13.dim(narrative));
+}
+function explainReceipt(r) {
+  const clientName = r.client?.legal_name || r.client?.name || "p\xFAblico general";
+  const status = (r.status || "").toLowerCase();
+  printKeyValue({
+    ID: r.id || "\u2014",
+    Tipo: "Recibo de venta",
+    Status: r.status || "\u2014",
+    Cliente: clientName,
+    Total: formatMoney(r.total, r.currency),
+    "V\xE1lido hasta": formatDate(r.validUntil),
+    Creado: formatDate(r.created_at)
+  });
+  if (r.invoice_id || r.invoiceId || r.invoice?.uuid) {
+    console.log("");
+    console.log(pc13.bold("Autofactura"));
+    console.log(`  Factura: ${r.invoice?.uuid || r.invoice_id || r.invoiceId}`);
+    if (r.invoiced_at) console.log(`  Fecha: ${formatDate(r.invoiced_at)}`);
+  }
+  console.log("");
+  let narrative;
+  if (status === "pending" || status === "open") {
+    narrative = `Recibo pendiente de autofactura por ${formatMoney(r.total, r.currency)} para ${clientName}. El dinero YA fue cobrado.`;
+    if (r.validUntil) narrative += ` Vigente hasta ${formatDate(r.validUntil)}.`;
+  } else if (status === "invoiced" || status === "completed") {
+    const invoiceRef = r.invoice?.uuid || r.invoice_id || r.invoiceId;
+    narrative = `Recibo por ${formatMoney(r.total, r.currency)}. El cliente se autofactur\xF3${r.invoiced_at ? ` el ${formatDate(r.invoiced_at)}` : ""}.`;
+    if (invoiceRef) narrative += ` Factura: ${invoiceRef}.`;
+  } else if (status === "expired") {
+    narrative = `Recibo expirado por ${formatMoney(r.total, r.currency)}. El cliente no se autofactur\xF3 a tiempo. Se incluir\xE1 en factura global.`;
+  } else if (status === "cancelled") {
+    narrative = `Recibo cancelado por ${formatMoney(r.total, r.currency)}.`;
+  } else {
+    narrative = `Recibo por ${formatMoney(r.total, r.currency)} para ${clientName}. Status: ${r.status || "desconocido"}.`;
+  }
+  console.log(pc13.dim(narrative));
+}
+function explainService(s) {
+  printKeyValue({
+    ID: s.id || "\u2014",
+    Tipo: "Servicio / Producto",
+    Descripci\u00F3n: s.description || "\u2014",
+    SKU: s.sku || "\u2014",
+    "Precio unitario": formatMoney(s.unit_price, "MXN"),
+    "Clave producto": s.product_key || "\u2014",
+    "Clave unidad": s.unit_key || "\u2014",
+    "Nombre unidad": s.unit_name || "\u2014",
+    Impuestos: (s.taxes || []).map((t) => `${t.type} ${(t.rate * 100).toFixed(0)}%${t.withholding ? " (ret)" : ""}`).join(", ") || "Sin impuestos"
+  });
+  console.log("");
+  const taxLabel = (s.taxes || []).length > 0 ? `Con ${(s.taxes || []).map((t) => `${t.type} ${(t.rate * 100).toFixed(0)}%`).join(" + ")}.` : "Sin impuestos configurados.";
+  const narrative = `Servicio "${s.description || "\u2014"}" a ${formatMoney(s.unit_price, "MXN")} por unidad (${s.unit_key || "\u2014"}). ${taxLabel}`;
+  console.log(pc13.dim(narrative));
+}
+function registerExplainCommand(program2) {
+  program2.command("explain <id>").description("Explicar cualquier recurso de gigstack (factura, pago, recibo, cliente, servicio)").option("--team <id>", "Team ID").action(async (id, opts) => {
+    try {
+      const detectedType = detectType(id);
+      let result;
+      if (detectedType) {
+        try {
+          result = await spin(
+            `Cargando ${detectedType}\u2026`,
+            () => fetchByType(detectedType, id, opts.team)
+          );
+        } catch {
+          warn(`No se encontr\xF3 como ${detectedType}, buscando en otros tipos\u2026`);
+          result = await spin("Buscando recurso\u2026", () => tryAll(id, opts.team));
+        }
+      } else {
+        result = await spin("Detectando tipo de recurso\u2026", () => tryAll(id, opts.team));
+      }
+      if (isJsonMode()) {
+        return printJson({ type: result.type, ...result.data });
+      }
+      console.log(pc13.bold(`
+${pc13.cyan("\u2500\u2500\u2500 gigstack explain \u2500\u2500\u2500")}
+`));
+      switch (result.type) {
+        case "invoice":
+          explainInvoice(result.data);
+          break;
+        case "payment":
+          explainPayment(result.data);
+          break;
+        case "client":
+          await explainClient(result.data, opts.team);
+          break;
+        case "receipt":
+          explainReceipt(result.data);
+          break;
+        case "service":
+          explainService(result.data);
+          break;
+      }
+      console.log("");
+    } catch (e) {
+      error(e.message);
+    }
+  });
+}
+
+// src/commands/forecast.ts
+import pc14 from "picocolors";
+var DAY_MS = 864e5;
+function fmt2(amount, currency = "MXN") {
+  return formatMoney(amount, currency);
+}
+function sum2(items, key = "total") {
+  return items.reduce((s, i) => s + (i?.[key] || 0), 0);
+}
+function toUnix(d) {
+  return String(Math.floor(d.getTime() / 1e3));
+}
+function monthRange(year, month) {
+  const start = new Date(year, month, 1);
+  const end = new Date(year, month + 1, 0, 23, 59, 59);
+  return { gte: toUnix(start), lte: toUnix(end) };
+}
+function ageDays(item) {
+  const now = Date.now();
+  const ts = item.created_at ? typeof item.created_at === "string" ? new Date(item.created_at).getTime() : item.created_at > 1e12 ? item.created_at : item.created_at * 1e3 : now;
+  return Math.floor((now - ts) / DAY_MS);
+}
+function collectionProbability(days) {
+  if (days <= 30) return 0.9;
+  if (days <= 60) return 0.75;
+  if (days <= 90) return 0.5;
+  if (days <= 120) return 0.3;
+  return 0.15;
+}
+function calcTrend(monthlyValues) {
+  const valid = monthlyValues.filter((v) => v > 0);
+  if (valid.length === 0) return { avgAll: 0, trend: 0, arrow: "\u2192" };
+  const avgAll = valid.reduce((a, b) => a + b, 0) / valid.length;
+  if (valid.length < 4) {
+    if (valid.length >= 2) {
+      const first = valid[0];
+      const last = valid[valid.length - 1];
+      const pct = first > 0 ? (last - first) / first * 100 / (valid.length - 1) : 0;
+      const arrow2 = pct > 5 ? "\u2191" : pct < -5 ? "\u2193" : "\u2192";
+      return { avgAll, trend: pct, arrow: arrow2 };
+    }
+    return { avgAll, trend: 0, arrow: "\u2192" };
+  }
+  const mid = Math.floor(valid.length / 2);
+  const prior = valid.slice(0, mid);
+  const recent = valid.slice(mid);
+  const avgPrior = prior.reduce((a, b) => a + b, 0) / prior.length;
+  const avgRecent = recent.reduce((a, b) => a + b, 0) / recent.length;
+  if (avgPrior === 0) return { avgAll, trend: 0, arrow: "\u2192" };
+  const monthlyPct = (avgRecent - avgPrior) / avgPrior * 100 / mid;
+  const arrow = monthlyPct > 5 ? "\u2191" : monthlyPct < -5 ? "\u2193" : "\u2192";
+  return { avgAll, trend: monthlyPct, arrow };
+}
+function project(base, monthlyPctChange, months) {
+  const factor = 1 + monthlyPctChange / 100;
+  return base * Math.pow(factor, months);
+}
+function monthName(month, year) {
+  const names = ["Enero", "Febrero", "Marzo", "Abril", "Mayo", "Junio", "Julio", "Agosto", "Septiembre", "Octubre", "Noviembre", "Diciembre"];
+  return `${names[month]} ${year}`;
+}
+async function fetchMonth(resource, year, month, team) {
+  const range = monthRange(year, month);
+  try {
+    const res = await api("GET", resource, {
+      query: { "created[gte]": range.gte, "created[lte]": range.lte, limit: "100" },
+      team
+    });
+    return (res.data || []).filter((d) => d != null);
+  } catch {
+    return [];
+  }
+}
+function registerForecastCommand(program2) {
+  program2.command("forecast").description("Proyecci\xF3n de ingresos, cobranza, recibos EOM y flujo de efectivo").option("--months <n>", "Meses a proyectar (default: 3)", "3").option("--team <id>", "Team ID").action(async (opts) => {
+    try {
+      const projMonths = Math.max(1, Math.min(12, parseInt(opts.months) || 3));
+      const now = /* @__PURE__ */ new Date();
+      const curYear = now.getFullYear();
+      const curMonth = now.getMonth();
+      const [team, histData, currentData] = await spin("Cargando datos hist\xF3ricos\u2026", async () => {
+        const t = await resolveTeam();
+        const months = [];
+        for (let i = 6; i >= 1; i--) {
+          const d = new Date(curYear, curMonth - i, 1);
+          months.push({ year: d.getFullYear(), month: d.getMonth() });
+        }
+        const histPromises = months.map(async (m) => {
+          const [invoices, payments, receipts] = await Promise.all([
+            fetchMonth("/invoices/income", m.year, m.month, opts.team),
+            fetchMonth("/payments", m.year, m.month, opts.team),
+            fetchMonth("/receipts", m.year, m.month, opts.team)
+          ]);
+          return { ...m, invoices, payments, receipts };
+        });
+        const currentPromises = Promise.all([
+          fetchMonth("/invoices/income", curYear, curMonth, opts.team),
+          fetchMonth("/payments", curYear, curMonth, opts.team),
+          fetchMonth("/receipts", curYear, curMonth, opts.team),
+          // PPD invoices (all, not just current month) — we need those with balance
+          api("GET", "/invoices/income", {
+            query: { limit: "100", payment_method: "PPD" },
+            team: opts.team
+          }).then((r) => (r.data || []).filter((d) => d != null)).catch(() => []),
+          // Pending payments (payment links)
+          api("GET", "/payments", {
+            query: { limit: "100", status: "pending" },
+            team: opts.team
+          }).then((r) => (r.data || []).filter((d) => d != null)).catch(() => [])
+        ]);
+        const [hist, current2] = await Promise.all([
+          Promise.all(histPromises),
+          currentPromises
+        ]);
+        return [
+          t,
+          hist,
+          {
+            invoices: current2[0],
+            payments: current2[1],
+            receipts: current2[2],
+            ppdAll: current2[3],
+            pendingPayments: current2[4]
+          }
+        ];
+      });
+      const history = histData;
+      const current = currentData;
+      const allInvoices = [...history.flatMap((h) => h.invoices), ...current.invoices];
+      const allPayments = [...history.flatMap((h) => h.payments), ...current.payments];
+      const cur = allInvoices[0]?.currency || allPayments[0]?.currency || "MXN";
+      const monthlyInvoiced = history.map((h) => sum2(h.invoices.filter((i) => i.status === "valid")));
+      const monthlyCollected = history.map((h) => sum2(h.payments.filter((p) => p.status === "succeeded")));
+      const monthlyReceiptCount = history.map((h) => h.receipts.length);
+      const monthlyReceiptTotal = history.map((h) => sum2(h.receipts));
+      const monthlyInvoicedReceiptCount = history.map(
+        (h) => h.receipts.filter((r) => r.status === "invoiced" || r.status === "completed").length
+      );
+      const revTrend = calcTrend(monthlyInvoiced);
+      const projectedThisMonth = revTrend.avgAll * (1 + revTrend.trend / 100);
+      const futureProjections = [];
+      for (let i = 1; i <= projMonths; i++) {
+        const d = new Date(curYear, curMonth + i, 1);
+        futureProjections.push({
+          month: monthName(d.getMonth(), d.getFullYear()),
+          revenue: project(revTrend.avgAll, revTrend.trend, i),
+          collections: project(
+            calcTrend(monthlyCollected).avgAll,
+            calcTrend(monthlyCollected).trend,
+            i
+          ),
+          risk: 0
+          // filled below
+        });
+      }
+      const ppdWithBalance = current.ppdAll.filter((i) => {
+        const balance = i.last_balance ?? i.total;
+        return i.status === "valid" && balance > 0.01;
+      });
+      const ppdAnalysis = ppdWithBalance.map((i) => {
+        const balance = i.last_balance ?? i.total ?? 0;
+        const days = ageDays(i);
+        const prob = collectionProbability(days);
+        const clientName = i.client?.legal_name || i.client?.name || i.client_name || "Sin nombre";
+        return { ...i, _balance: balance, _days: days, _prob: prob, _clientName: clientName };
+      });
+      const totalAtRisk = ppdAnalysis.reduce((s, i) => s + i._balance, 0);
+      const expectedRecovery = ppdAnalysis.reduce((s, i) => s + i._balance * i._prob, 0);
+      const likelyLoss = totalAtRisk - expectedRecovery;
+      const highRisk = ppdAnalysis.filter((i) => i._days > 90);
+      const highRiskAmount = highRisk.reduce((s, i) => s + i._balance, 0);
+      const topRisk = [...ppdAnalysis].sort((a, b) => a._prob - b._prob || b._balance - a._balance).slice(0, 3);
+      for (let i = 0; i < futureProjections.length; i++) {
+        futureProjections[i].risk = highRiskAmount * Math.pow(0.85, i + 1);
+      }
+      const pendingReceipts = current.receipts.filter(
+        (r) => r.status === "pending" || r.status === "open"
+      );
+      const pendingReceiptsTotal = sum2(pendingReceipts);
+      const pendingReceiptsCount = pendingReceipts.length;
+      const totalHistReceipts = monthlyReceiptCount.reduce((a, b) => a + b, 0);
+      const totalHistInvoiced = monthlyInvoicedReceiptCount.reduce((a, b) => a + b, 0);
+      const selfInvoiceRate = totalHistReceipts > 0 ? totalHistInvoiced / totalHistReceipts : 0;
+      const estGlobalCount = Math.round(pendingReceiptsCount * (1 - selfInvoiceRate));
+      const estGlobalAmount = pendingReceiptsTotal * (1 - selfInvoiceRate);
+      const pendingPayCount = current.pendingPayments.length;
+      const pendingPayTotal = sum2(current.pendingPayments);
+      const totalHistPayments = history.reduce((s, h) => s + h.payments.length, 0);
+      const totalHistSucceeded = history.reduce(
+        (s, h) => s + h.payments.filter((p) => p.status === "succeeded").length,
+        0
+      );
+      const conversionRate = totalHistPayments > 0 ? totalHistSucceeded / totalHistPayments : 0.85;
+      const expectedFromLinks = pendingPayTotal * conversionRate;
+      const expectedFromPPD = expectedRecovery;
+      const totalExpectedCash = expectedFromLinks + expectedFromPPD;
+      if (isJsonMode()) {
+        return printJson({
+          period: monthName(curMonth, curYear),
+          team: { name: team?.legal_name || team?.brand?.alias, tax_id: team?.tax_id },
+          revenue: {
+            monthly_average_6m: Math.round(revTrend.avgAll * 100) / 100,
+            trend_pct: Math.round(revTrend.trend * 100) / 100,
+            trend_direction: revTrend.arrow === "\u2191" ? "growing" : revTrend.arrow === "\u2193" ? "declining" : "stable",
+            projected_this_month: Math.round(projectedThisMonth * 100) / 100,
+            projections: futureProjections.map((p) => ({
+              month: p.month,
+              revenue: Math.round(p.revenue * 100) / 100,
+              collections: Math.round(p.collections * 100) / 100,
+              risk: Math.round(p.risk * 100) / 100
+            })),
+            monthly_history: history.map((h, idx) => ({
+              month: monthName(h.month, h.year),
+              invoiced: monthlyInvoiced[idx],
+              collected: monthlyCollected[idx],
+              receipts: monthlyReceiptCount[idx]
+            }))
+          },
+          collections_risk: {
+            total_pending: Math.round(totalAtRisk * 100) / 100,
+            invoice_count: ppdWithBalance.length,
+            expected_recovery: Math.round(expectedRecovery * 100) / 100,
+            recovery_pct: totalAtRisk > 0 ? Math.round(expectedRecovery / totalAtRisk * 100) : 0,
+            likely_loss: Math.round(likelyLoss * 100) / 100,
+            high_risk: {
+              amount: Math.round(highRiskAmount * 100) / 100,
+              count: highRisk.length
+            },
+            top_risk: topRisk.map((i) => ({
+              client: i._clientName,
+              balance: i._balance,
+              days: i._days,
+              probability: i._prob
+            }))
+          },
+          eom_estimate: {
+            pending_receipts: pendingReceiptsCount,
+            pending_amount: Math.round(pendingReceiptsTotal * 100) / 100,
+            self_invoice_rate: Math.round(selfInvoiceRate * 100),
+            estimated_global_count: estGlobalCount,
+            estimated_global_amount: Math.round(estGlobalAmount * 100) / 100
+          },
+          cash_flow: {
+            pending_payment_links: pendingPayCount,
+            pending_links_amount: Math.round(pendingPayTotal * 100) / 100,
+            conversion_rate: Math.round(conversionRate * 100),
+            expected_from_links: Math.round(expectedFromLinks * 100) / 100,
+            expected_from_ppd: Math.round(expectedFromPPD * 100) / 100,
+            total_expected: Math.round(totalExpectedCash * 100) / 100
+          }
+        });
+      }
+      const teamName = team?.legal_name || team?.brand?.alias || "\u2014";
+      console.log(`
+${pc14.bold(`Proyecci\xF3n \u2014 ${monthName(curMonth, curYear)}`)}`);
+      console.log(pc14.dim(teamName));
+      console.log(`
+${pc14.bold(pc14.underline("Facturaci\xF3n"))}`);
+      console.log(`  Promedio mensual (6m)    ${fmt2(revTrend.avgAll, cur)}`);
+      const trendColor = revTrend.arrow === "\u2191" ? pc14.green : revTrend.arrow === "\u2193" ? pc14.red : pc14.yellow;
+      const trendSign = revTrend.trend >= 0 ? "+" : "";
+      console.log(`  Tendencia                ${trendColor(`${revTrend.arrow} ${trendSign}${Math.round(revTrend.trend)}% mensual`)}`);
+      console.log(`  Proyecci\xF3n este mes      ${pc14.green(fmt2(projectedThisMonth, cur))}`);
+      if (futureProjections.length > 0) {
+        const projStr = futureProjections.map((p) => fmt2(p.revenue, cur)).join(" \u2192 ");
+        console.log(`  Pr\xF3ximos ${projMonths} meses         ${projStr}`);
+      }
+      console.log(`
+${pc14.bold(pc14.underline("Cobranza PPD"))}`);
+      if (ppdAnalysis.length === 0) {
+        console.log(`  ${pc14.dim("Sin facturas PPD pendientes")}`);
+      } else {
+        const recoveryPct = totalAtRisk > 0 ? Math.round(expectedRecovery / totalAtRisk * 100) : 0;
+        console.log(`  Total pendiente          ${pc14.red(fmt2(totalAtRisk, cur))}  ${pc14.dim(`(${ppdWithBalance.length} facturas)`)}`);
+        console.log(`  Recuperaci\xF3n esperada    ${pc14.green(fmt2(expectedRecovery, cur))}   ${pc14.dim(`(${recoveryPct}%)`)}`);
+        if (highRisk.length > 0) {
+          console.log(`  En riesgo alto           ${pc14.red(fmt2(highRiskAmount, cur))}   ${pc14.dim(`(${highRisk.length} facturas +90 d\xEDas)`)}`);
+        }
+        if (topRisk.length > 0) {
+          console.log(pc14.dim("  Mayor riesgo:"));
+          for (const r of topRisk) {
+            const probStr = `${Math.round(r._prob * 100)}%`;
+            const name = r._clientName.length > 22 ? r._clientName.slice(0, 22) + "\u2026" : r._clientName;
+            console.log(
+              `    ${name.padEnd(24)} ${fmt2(r._balance, cur).padEnd(16)} ${String(r._days).padStart(3)} d\xEDas  ${pc14.dim(`prob: ${probStr}`)}`
+            );
+          }
+        }
+      }
+      console.log(`
+${pc14.bold(pc14.underline("Recibos \u2192 Factura Global"))}`);
+      console.log(`  Pendientes hoy           ${String(pendingReceiptsCount).padEnd(5)} recibos    ${fmt2(pendingReceiptsTotal, cur)}`);
+      console.log(`  Tasa hist\xF3rica autofact  ${selfInvoiceRate > 0 ? `${Math.round(selfInvoiceRate * 100)}%` : pc14.dim("sin datos")}`);
+      console.log(`  Estimado factura global  ~${String(estGlobalCount).padEnd(4)} recibos   ${fmt2(estGlobalAmount, cur)}`);
+      console.log(`
+${pc14.bold(pc14.underline("Flujo de Efectivo"))}`);
+      console.log(`  Pagos pendientes         ${String(pendingPayCount).padEnd(5)} links      ${fmt2(pendingPayTotal, cur)}`);
+      console.log(`  Conversi\xF3n hist\xF3rica     ${Math.round(conversionRate * 100)}%`);
+      console.log(`  Cobro esperado (links)   ${pc14.green(fmt2(expectedFromLinks, cur))}`);
+      console.log(`  Cobro esperado (PPD)     ${pc14.green(fmt2(expectedFromPPD, cur))}`);
+      console.log(`  ${pc14.bold("Total entrada esperada")}   ${pc14.green(pc14.bold(fmt2(totalExpectedCash, cur)))}`);
+      if (projMonths > 1) {
+        console.log(`
+${pc14.bold(pc14.underline("Proyecci\xF3n multi-mes"))}`);
+        const colTrend = calcTrend(monthlyCollected);
+        const header = `  ${"Mes".padEnd(20)} ${"Ingresos".padStart(18)} ${"Cobranza".padStart(18)} ${"Riesgo".padStart(18)}`;
+        console.log(pc14.dim(header));
+        console.log(pc14.dim("  " + "\u2500".repeat(76)));
+        for (const p of futureProjections) {
+          console.log(
+            `  ${p.month.padEnd(20)} ${pc14.green(fmt2(p.revenue, cur).padStart(18))} ${fmt2(p.collections, cur).padStart(18)} ${pc14.red(fmt2(p.risk, cur).padStart(18))}`
+          );
+        }
+      }
+      console.log();
+    } catch (e) {
+      console.error(pc14.red(`\u2717 ${e.message}`));
+    }
+  });
+}
+
+// src/cli.ts
+var program = new Command();
+program.name("gigstack").description("gigstack CLI \u2014 facturaci\xF3n electr\xF3nica desde tu terminal").version("0.1.0").option("--json", "Salida en formato JSON").option("--team <id>", "Team ID para operaciones multi-equipo").hook("preAction", (thisCommand) => {
+  const opts = thisCommand.opts();
+  if (opts.json) setJsonMode(true);
+});
+registerAuthCommands(program);
+registerContextCommand(program);
+registerStatusCommand(program);
+registerDoctorCommand(program);
+registerPayCommand(program);
+registerClientCommands(program);
+registerInvoiceCommands(program);
+registerPaymentCommands(program);
+registerServiceCommands(program);
+registerWebhookCommands(program);
+registerTeamCommands(program);
+registerReceiptCommands(program);
+registerCompletionsCommand(program);
+registerExportCommand(program);
+registerExplainCommand(program);
+registerForecastCommand(program);
+program.addHelpText("after", `
+${pc15.bold("Ejemplos:")}
+  ${pc15.dim("$")} gigstack login                          Autenticarse
+  ${pc15.dim("$")} gigstack context payments               Entender pagos (para agentes)
+  ${pc15.dim("$")} gigstack status                         Resumen r\xE1pido del equipo
+  ${pc15.dim("$")} gigstack doctor                         Diagn\xF3stico completo
+  ${pc15.dim("$")} gigstack pay                             Registrar pago + autofactura
+  ${pc15.dim("$")} gigstack whoami                          Ver cuenta actual
+  ${pc15.dim("$")} gigstack clients list                    Listar clientes
+  ${pc15.dim("$")} gigstack clients create                  Crear cliente (interactivo)
+  ${pc15.dim("$")} gigstack invoices list                   Listar facturas
+  ${pc15.dim("$")} gigstack invoices create                 Crear factura (interactivo)
+  ${pc15.dim("$")} gigstack invoices list --json             Salida JSON
+  ${pc15.dim("$")} gigstack payments list                   Listar pagos
+  ${pc15.dim("$")} gigstack services list                   Listar servicios
+  ${pc15.dim("$")} gigstack export invoices --from 2026-01  Exportar facturas a CSV
+  ${pc15.dim("$")} gigstack export payments --format json   Exportar pagos a JSON
+  ${pc15.dim("$")} gigstack explain <id>                    Explicar cualquier recurso
+
+${pc15.bold("Docs:")} https://docs.gigstack.io
+`);
+program.parse();