fizko-cli 0.2.0

package/dist/index.js

@@ -0,0 +1,1561 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/index.ts
+var import_commander = require("commander");
+
+// src/config.ts
+var import_fs = __toESM(require("fs"));
+var import_os = __toESM(require("os"));
+var import_path = __toESM(require("path"));
+function configDir() {
+  const xdg = process.env.XDG_CONFIG_HOME;
+  const base = xdg ? xdg : import_path.default.join(import_os.default.homedir(), ".config");
+  const dir = import_path.default.join(base, "fizko");
+  import_fs.default.mkdirSync(dir, { recursive: true });
+  return dir;
+}
+function configPath() {
+  return import_path.default.join(configDir(), "credentials.json");
+}
+function save(creds) {
+  const p = configPath();
+  import_fs.default.writeFileSync(p, JSON.stringify(creds, null, 2), { encoding: "utf8", mode: 384 });
+  return p;
+}
+function load() {
+  const p = configPath();
+  if (!import_fs.default.existsSync(p)) return null;
+  try {
+    return JSON.parse(import_fs.default.readFileSync(p, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function clear() {
+  const p = configPath();
+  if (import_fs.default.existsSync(p)) import_fs.default.unlinkSync(p);
+}
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.fizko.ai";
+var compact = false;
+function setCompact(value) {
+  compact = value;
+}
+function getCredentials() {
+  const envKey = process.env.FIZKO_API_KEY ?? "";
+  const envUrl = process.env.FIZKO_API_URL ?? "";
+  if (envKey) {
+    return { apiKey: envKey, baseUrl: (envUrl || DEFAULT_BASE_URL).replace(/\/$/, "") };
+  }
+  const saved = load();
+  if (saved?.api_key) {
+    const url = envUrl || saved.base_url || DEFAULT_BASE_URL;
+    return { apiKey: saved.api_key, baseUrl: url.replace(/\/$/, "") };
+  }
+  process.stderr.write(JSON.stringify({ error: "Not authenticated. Run: fizko login" }) + "\n");
+  process.exit(1);
+}
+function handleError(status, body) {
+  let err;
+  try {
+    err = JSON.parse(body);
+  } catch {
+    err = { error: body, status_code: status };
+  }
+  process.stderr.write(JSON.stringify(err) + "\n");
+  process.exit(1);
+}
+function buildUrl(base, path2, params) {
+  const url = new URL(`${base}${path2}`);
+  if (params) {
+    for (const [k, v] of Object.entries(params)) {
+      if (v !== void 0 && v !== null) url.searchParams.set(k, String(v));
+    }
+  }
+  return url.toString();
+}
+async function get(path2, params) {
+  const { apiKey, baseUrl } = getCredentials();
+  const url = buildUrl(baseUrl, path2, params);
+  const res = await fetch(url, { headers: { "X-API-Key": apiKey } });
+  const text = await res.text();
+  if (res.status >= 400) handleError(res.status, text);
+  return JSON.parse(text);
+}
+async function post(path2, data, overrideKey, overrideUrl) {
+  let apiKey;
+  let baseUrl;
+  if (overrideKey) {
+    apiKey = overrideKey;
+    baseUrl = (overrideUrl ?? process.env.FIZKO_API_URL ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+  } else {
+    ({ apiKey, baseUrl } = getCredentials());
+  }
+  const url = `${baseUrl}${path2}`;
+  const headers = { "Content-Type": "application/json" };
+  if (apiKey) headers["X-API-Key"] = apiKey;
+  const res = await fetch(url, { method: "POST", headers, body: JSON.stringify(data ?? {}) });
+  const text = await res.text();
+  if (res.status >= 400) handleError(res.status, text);
+  if (res.status === 204) return { status: "deleted" };
+  try {
+    return JSON.parse(text);
+  } catch {
+    return { status: "ok" };
+  }
+}
+async function patch(path2, data) {
+  const { apiKey, baseUrl } = getCredentials();
+  const url = `${baseUrl}${path2}`;
+  const res = await fetch(url, {
+    method: "PATCH",
+    headers: { "Content-Type": "application/json", "X-API-Key": apiKey },
+    body: JSON.stringify(data ?? {})
+  });
+  const text = await res.text();
+  if (res.status >= 400) handleError(res.status, text);
+  try {
+    return JSON.parse(text);
+  } catch {
+    return { status: "ok" };
+  }
+}
+async function rawGet(url, params) {
+  const fullUrl = buildUrl(url, "", params).replace(/\/$/, "") || url;
+  const u = new URL(url);
+  if (params) {
+    for (const [k, v] of Object.entries(params)) {
+      if (v !== void 0 && v !== null) u.searchParams.set(k, String(v));
+    }
+  }
+  const res = await fetch(u.toString());
+  const text = await res.text();
+  if (res.status >= 400) handleError(res.status, text);
+  return JSON.parse(text);
+}
+async function rawPost(url, data) {
+  const res = await fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(data ?? {})
+  });
+  const text = await res.text();
+  if (res.status >= 400) handleError(res.status, text);
+  return JSON.parse(text);
+}
+function output(data) {
+  console.log(JSON.stringify(data, null, compact ? void 0 : 2));
+}
+
+// src/commands/auth.ts
+var DEFAULT_BASE_URL2 = "https://api.fizko.ai";
+var DEFAULT_WEB_URL = "https://admin.fizko.ai";
+function registerAuth(program2) {
+  program2.command("login").description("Iniciar sesi\xF3n con tu cuenta Fizko.").option("--api-url <url>", "URL de la API", process.env.FIZKO_API_URL ?? DEFAULT_BASE_URL2).option("--web-url <url>", "URL del dashboard", process.env.FIZKO_WEB_URL ?? DEFAULT_WEB_URL).option("--no-browser", "No abrir el navegador autom\xE1ticamente").action(async (opts) => {
+    const baseUrl = opts.apiUrl.replace(/\/$/, "");
+    const dashboardUrl = opts.webUrl.replace(/\/$/, "");
+    const saved = load();
+    if (saved?.api_key) {
+      process.stderr.write(`Ya autenticado como ${saved.email}.
+`);
+      process.stderr.write("Usa 'fizko logout' para cerrar sesi\xF3n primero.\n");
+      process.exit(0);
+    }
+    process.stderr.write("Iniciando autenticaci\xF3n...\n\n");
+    const resp = await rawPost(`${baseUrl}/api/auth/cli/initiate`);
+    const deviceCode = resp.device_code;
+    const userCode = resp.user_code;
+    const pollInterval = (resp.poll_interval ?? 2) * 1e3;
+    const expiresIn = (resp.expires_in ?? 600) * 1e3;
+    const authUrl = `${dashboardUrl}/cli-auth?code=${userCode}`;
+    process.stderr.write(`Tu c\xF3digo de verificaci\xF3n: ${userCode}
+
+`);
+    process.stderr.write(`Abre este link en tu navegador: ${authUrl}
+
+`);
+    if (opts.browser !== false) {
+      const { execSync } = await import("child_process");
+      const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+      try {
+        execSync(`${cmd} "${authUrl}"`);
+      } catch {
+      }
+    }
+    process.stderr.write("Esperando autorizaci\xF3n");
+    const deadline = Date.now() + expiresIn;
+    while (Date.now() < deadline) {
+      await new Promise((r) => setTimeout(r, pollInterval));
+      const poll = await rawGet(`${baseUrl}/api/auth/cli/poll`, { device_code: deviceCode });
+      if (poll.status === "authorized") {
+        const apiKey = poll.api_key;
+        const email = poll.user_email ?? "";
+        const path2 = save({ api_key: apiKey, email, base_url: baseUrl });
+        process.stderr.write(`
+
+Autenticado como ${email}
+`);
+        process.stderr.write(`Credenciales guardadas en ${path2}
+`);
+        process.exit(0);
+      }
+      if (poll.status === "expired") {
+        process.stderr.write("\n\nC\xF3digo expirado. Intenta de nuevo con: fizko login\n");
+        process.exit(1);
+      }
+      process.stderr.write(".");
+    }
+    process.stderr.write("\n\nTiempo agotado. Intenta de nuevo con: fizko login\n");
+    process.exit(1);
+  });
+  program2.command("logout").description("Cerrar sesi\xF3n y eliminar credenciales guardadas.").action(() => {
+    const saved = load();
+    if (!saved) {
+      process.stderr.write("No hay sesi\xF3n activa.\n");
+      process.exit(0);
+    }
+    clear();
+    process.stderr.write(`Sesi\xF3n de ${saved.email} cerrada.
+`);
+  });
+  program2.command("status").description("Mostrar estado de autenticaci\xF3n.").action(() => {
+    const envKey = process.env.FIZKO_API_KEY;
+    const saved = load();
+    if (envKey) {
+      process.stderr.write("Autenticado via FIZKO_API_KEY (env var)\n");
+    } else if (saved?.api_key) {
+      process.stderr.write(`Autenticado como ${saved.email}
+`);
+      process.stderr.write(`API: ${saved.base_url ?? DEFAULT_BASE_URL}
+`);
+    } else {
+      process.stderr.write("No autenticado. Ejecuta: fizko login\n");
+    }
+  });
+}
+
+// src/commands/companies.ts
+function registerCompanies(program2) {
+  const cmd = program2.command("companies").description("Listar y consultar empresas.");
+  cmd.command("list").description("Listar empresas del usuario.").option("--page <n>", "N\xFAmero de p\xE1gina", (v) => parseInt(v)).action(async (opts) => {
+    output(await get("/api/companies", { page: opts.page }));
+  });
+  cmd.command("get <company_id>").description("Obtener detalle de una empresa.").action(async (companyId) => {
+    output(await get(`/api/companies/${companyId}`));
+  });
+}
+
+// src/commands/tax.ts
+function registerTax(program2) {
+  const cmd = program2.command("tax").description("Documentos tributarios, F29, res\xFAmenes e indicadores.");
+  cmd.command("purchases").description("Listar documentos de compra.").requiredOption("--company <uuid>", "UUID de la empresa").option("--period-year <n>", "A\xF1o (ej: 2026)", (v) => parseInt(v)).option("--period-month <n>", "Mes (1-12)", (v) => parseInt(v)).option("--document-type <type>", "Tipo de documento (ej: 33, 34)").option("--page <n>", "N\xFAmero de p\xE1gina", (v) => parseInt(v)).action(async (opts) => {
+    output(await get("/api/tax/purchases", {
+      company: opts.company,
+      period_year: opts.periodYear,
+      period_month: opts.periodMonth,
+      document_type: opts.documentType,
+      page: opts.page
+    }));
+  });
+  cmd.command("purchase <purchase_id>").description("Obtener detalle de un documento de compra.").action(async (id) => {
+    output(await get(`/api/tax/purchases/${id}`));
+  });
+  cmd.command("sales").description("Listar documentos de venta.").requiredOption("--company <uuid>", "UUID de la empresa").option("--period-year <n>", "A\xF1o (ej: 2026)", (v) => parseInt(v)).option("--period-month <n>", "Mes (1-12)", (v) => parseInt(v)).option("--document-type <type>", "Tipo de documento").option("--page <n>", "N\xFAmero de p\xE1gina", (v) => parseInt(v)).action(async (opts) => {
+    output(await get("/api/tax/sales", {
+      company: opts.company,
+      period_year: opts.periodYear,
+      period_month: opts.periodMonth,
+      document_type: opts.documentType,
+      page: opts.page
+    }));
+  });
+  cmd.command("sale <sale_id>").description("Obtener detalle de un documento de venta.").action(async (id) => {
+    output(await get(`/api/tax/sales/${id}`));
+  });
+  cmd.command("contacts").description("Listar contactos tributarios (proveedores/clientes).").requiredOption("--company <uuid>", "UUID de la empresa").option("--page <n>", "N\xFAmero de p\xE1gina", (v) => parseInt(v)).action(async (opts) => {
+    output(await get("/api/tax/contacts", { company: opts.company, page: opts.page }));
+  });
+  cmd.command("documents").description("Listar todos los documentos tributarios (compras + ventas + honorarios).").requiredOption("--company <uuid>", "UUID de la empresa").option("--period <yyyy-mm>", "Per\xEDodo YYYY-MM").option("--start-date <date>", "Fecha inicio YYYY-MM-DD").option("--end-date <date>", "Fecha fin YYYY-MM-DD").option("--limit <n>", "Documentos por p\xE1gina", (v) => parseInt(v)).option("--offset <n>", "Offset de paginaci\xF3n", (v) => parseInt(v)).action(async (opts) => {
+    output(await get("/api/tax/documents", {
+      company_id: opts.company,
+      period: opts.period,
+      start_date: opts.startDate,
+      end_date: opts.endDate,
+      limit: opts.limit,
+      offset: opts.offset
+    }));
+  });
+  cmd.command("document <document_id>").description("Obtener detalle de un documento tributario.").action(async (id) => {
+    output(await get(`/api/tax/documents/${id}`));
+  });
+  cmd.command("documents-summary").description("Resumen de transacciones por tipo de documento (\xFAltimos 3 meses).").requiredOption("--company <uuid>", "UUID de la empresa").action(async (opts) => {
+    output(await get("/api/tax/documents/summary", { company_id: opts.company }));
+  });
+  cmd.command("f29").description("Listar declaraciones F29 agrupadas por per\xEDodo.").requiredOption("--company <uuid>", "UUID de la empresa").option("--year <n>", "A\xF1o", (v) => parseInt(v)).option("--page <n>", "N\xFAmero de p\xE1gina", (v) => parseInt(v)).action(async (opts) => {
+    output(await get("/api/tax/form29", {
+      company_id: opts.company,
+      year: opts.year,
+      page: opts.page
+    }));
+  });
+  cmd.command("f29-export").description("Exportar documentos de un c\xF3digo F29 espec\xEDfico.").requiredOption("--company <uuid>", "UUID de la empresa").requiredOption("--code <code>", "C\xF3digo F29 a exportar").requiredOption("--period <yyyy-mm>", "Per\xEDodo YYYY-MM").action(async (opts) => {
+    output(await get("/api/tax/f29/export-csv", {
+      company_id: opts.company,
+      code: opts.code,
+      period: opts.period
+    }));
+  });
+  cmd.command("f29-codes").description("Listar c\xF3digos F29 exportables para un per\xEDodo.").requiredOption("--company <uuid>", "UUID de la empresa").requiredOption("--period <yyyy-mm>", "Per\xEDodo YYYY-MM").action(async (opts) => {
+    output(await get("/api/tax/f29/exportable-codes", {
+      company_id: opts.company,
+      period: opts.period
+    }));
+  });
+  cmd.command("summary").description("Resumen tributario para un per\xEDodo (desde F29).").requiredOption("--company <uuid>", "UUID de la empresa").requiredOption("--period <yyyy-mm>", "Per\xEDodo YYYY-MM").action(async (opts) => {
+    output(await get("/api/tax/summary", { company_id: opts.company, period: opts.period }));
+  });
+  cmd.command("iva").description("Resumen de IVA para un per\xEDodo.").requiredOption("--company <uuid>", "UUID de la empresa").requiredOption("--period <yyyy-mm>", "Per\xEDodo YYYY-MM").action(async (opts) => {
+    output(await get("/api/tax/summary/iva", { company_id: opts.company, period: opts.period }));
+  });
+  cmd.command("timeline").description("L\xEDnea de tiempo tributaria (\xFAltimos 12 meses).").requiredOption("--company <uuid>", "UUID de la empresa").action(async (opts) => {
+    output(await get("/api/tax/summary/timeline", { company_id: opts.company }));
+  });
+  cmd.command("honorarios").description("Listar boletas de honorarios.").requiredOption("--company <uuid>", "UUID de la empresa").option("--period-year <n>", "A\xF1o", (v) => parseInt(v)).option("--period-month <n>", "Mes (1-12)", (v) => parseInt(v)).action(async (opts) => {
+    output(await get("/api/tax/honorarios", {
+      company: opts.company,
+      period_year: opts.periodYear,
+      period_month: opts.periodMonth
+    }));
+  });
+  cmd.command("ddjj").description("Listar declaraciones juradas.").requiredOption("--company <uuid>", "UUID de la empresa").option("--year <n>", "A\xF1o tributario", (v) => parseInt(v)).action(async (opts) => {
+    output(await get("/api/tax/ddjj", { company_id: opts.company, year: opts.year }));
+  });
+  cmd.command("checker-tributario").description("Comparar libro SII vs documentos contabilizados en Fizko.").requiredOption("--company <uuid>", "UUID de la empresa").requiredOption("--period <yyyy-mm>", "Per\xEDodo YYYY-MM").action(async (opts) => {
+    output(await get("/api/tax/checker-tributario", {
+      company_id: opts.company,
+      period: opts.period
+    }));
+  });
+  cmd.command("checker-impuestos").description("Comparar impuestos declarados en F29 vs contabilizados en Fizko.").requiredOption("--company <uuid>", "UUID de la empresa").requiredOption("--period <yyyy-mm>", "Per\xEDodo YYYY-MM").action(async (opts) => {
+    output(await get("/api/tax/checker-impuestos-mensuales", {
+      company_id: opts.company,
+      period: opts.period
+    }));
+  });
+}
+
+// src/commands/accounting.ts
+function registerAccounting(program2) {
+  const cmd = program2.command("accounting").description("Contabilidad: plan de cuentas, asientos, reportes, obligaciones.");
+  cmd.command("accounts").description("Listar plan de cuentas.").requiredOption("--company <uuid>", "UUID de la empresa").option("--tree", "Devolver en estructura de \xE1rbol").action(async (opts) => {
+    const params = { company: opts.company };
+    if (opts.tree) params["tree"] = "1";
+    output(await get("/api/accounting/accounts", params));
+  });
+  cmd.command("journal-entries").description("Listar asientos contables.").requiredOption("--company <uuid>", "UUID de la empresa").option("--period <yyyy-mm>", "Per\xEDodo YYYY-MM").option("--limit <n>", "L\xEDmite de resultados", (v) => parseInt(v)).option("--offset <n>", "Offset de paginaci\xF3n", (v) => parseInt(v)).action(async (opts) => {
+    output(await get("/api/accounting/journal-entries", {
+      company: opts.company,
+      period: opts.period,
+      limit: opts.limit,
+      offset: opts.offset
+    }));
+  });
+  cmd.command("journal-entry <entry_id>").description("Obtener detalle de un asiento contable.").action(async (id) => {
+    output(await get(`/api/accounting/journal-entries/${id}`));
+  });
+  cmd.command("balance-report").description("Balance de 8 columnas.").requiredOption("--company <uuid>", "UUID de la empresa").requiredOption("--period-from <yyyy-mm>", "Per\xEDodo inicio YYYY-MM").requiredOption("--period-to <yyyy-mm>", "Per\xEDodo fin YYYY-MM").option("--cost-center-id <uuid>", "UUID centro de costo").action(async (opts) => {
+    output(await get("/api/accounting/balance-report", {
+      company_id: opts.company,
+      period_from: opts.periodFrom,
+      period_to: opts.periodTo,
+      cost_center_id: opts.costCenterId
+    }));
+  });
+  cmd.command("income-statement").description("Estado de resultados (EERR).").requiredOption("--company <uuid>", "UUID de la empresa").requiredOption("--period-from <yyyy-mm>", "Per\xEDodo inicio YYYY-MM").requiredOption("--period-to <yyyy-mm>", "Per\xEDodo fin YYYY-MM").option("--cost-center-id <uuid>", "UUID centro de costo").action(async (opts) => {
+    output(await get("/api/accounting/reports/income-statement", {
+      company_id: opts.company,
+      period_from: opts.periodFrom,
+      period_to: opts.periodTo,
+      cost_center_id: opts.costCenterId
+    }));
+  });
+  cmd.command("general-journal").description("Libro diario.").requiredOption("--company <uuid>", "UUID de la empresa").requiredOption("--period <yyyy-mm>", "Per\xEDodo YYYY-MM").option("--page <n>", "N\xFAmero de p\xE1gina", (v) => parseInt(v)).option("--page-size <n>", "Tama\xF1o de p\xE1gina", (v) => parseInt(v)).action(async (opts) => {
+    output(await get("/api/accounting/reports/general-journal", {
+      company_id: opts.company,
+      period: opts.period,
+      page: opts.page,
+      page_size: opts.pageSize
+    }));
+  });
+  cmd.command("general-ledger").description("Libro mayor.").requiredOption("--company <uuid>", "UUID de la empresa").requiredOption("--period-from <yyyy-mm>", "Per\xEDodo inicio YYYY-MM").requiredOption("--period-to <yyyy-mm>", "Per\xEDodo fin YYYY-MM").option("--account-id <uuid>", "UUID de cuenta espec\xEDfica").action(async (opts) => {
+    output(await get("/api/accounting/reports/general-ledger", {
+      company_id: opts.company,
+      period_from: opts.periodFrom,
+      period_to: opts.periodTo,
+      account_id: opts.accountId
+    }));
+  });
+  cmd.command("classified-balance").description("Balance clasificado.").requiredOption("--company <uuid>", "UUID de la empresa").option("--period <yyyy-mm>", "Per\xEDodo YYYY-MM").option("--period-from <yyyy-mm>", "Per\xEDodo inicio YYYY-MM").option("--period-to <yyyy-mm>", "Per\xEDodo fin YYYY-MM").option("--cost-center-id <uuid>", "UUID centro de costo").action(async (opts) => {
+    output(await get("/api/accounting/reports/classified-balance", {
+      company_id: opts.company,
+      period: opts.period,
+      period_from: opts.periodFrom,
+      period_to: opts.periodTo,
+      cost_center_id: opts.costCenterId
+    }));
+  });
+  cmd.command("rli-balance").description("Balance RLI (Renta L\xEDquida Imponible).").requiredOption("--company <uuid>", "UUID de la empresa").requiredOption("--period-from <yyyy-mm>", "Per\xEDodo inicio YYYY-MM").requiredOption("--period-to <yyyy-mm>", "Per\xEDodo fin YYYY-MM").action(async (opts) => {
+    output(await get("/api/accounting/reports/rli-balance", {
+      company_id: opts.company,
+      period_from: opts.periodFrom,
+      period_to: opts.periodTo
+    }));
+  });
+  cmd.command("progress").description("Avance contable de la empresa.").requiredOption("--company <uuid>", "UUID de la empresa").option("--period <yyyy-mm>", "Per\xEDodo YYYY-MM").action(async (opts) => {
+    output(await get("/api/accounting/progress", {
+      company_id: opts.company,
+      period: opts.period
+    }));
+  });
+  cmd.command("obligations").description("Listar obligaciones contables (cuentas por pagar/cobrar).").requiredOption("--company <uuid>", "UUID de la empresa").option("--obligation-type <type>", "Tipo: payable o receivable").option("--status <status>", "Estado: pending, partial, paid, overdue").option("--period <yyyy-mm>", "Per\xEDodo YYYY-MM").option("--limit <n>", "L\xEDmite de resultados", (v) => parseInt(v), 30).option("--offset <n>", "Offset de paginaci\xF3n", (v) => parseInt(v), 0).action(async (opts) => {
+    output(await get("/api/accounting/obligations/", {
+      company: opts.company,
+      obligation_type: opts.obligationType,
+      status: opts.status,
+      period: opts.period,
+      limit: opts.limit,
+      offset: opts.offset
+    }));
+  });
+  cmd.command("obligation <obligation_id>").description("Obtener detalle de una obligaci\xF3n.").action(async (id) => {
+    output(await get(`/api/accounting/obligations/${id}/`));
+  });
+  cmd.command("contabilizar <obligation_id>").description("Contabilizar una obligaci\xF3n. Sin --lines, auto-genera el asiento.").option("--lines <json>", 'L\xEDneas del asiento JSON: [{"account_code":"5101","debit":1000,"credit":0}]').option("--account-code <code>", "C\xF3digo de cuenta (modo legacy)").option("--description <text>", "Descripci\xF3n del asiento").action(async (id, opts) => {
+    const body = {};
+    if (opts.lines) body["lines"] = JSON.parse(opts.lines);
+    if (opts.accountCode) body["account_code"] = opts.accountCode;
+    if (opts.description) body["description"] = opts.description;
+    output(await post(`/api/accounting/obligations/${id}/contabilizar/`, body));
+  });
+  cmd.command("descontabilizar <obligation_id>").description("Eliminar el asiento contable de una obligaci\xF3n.").action(async (id) => {
+    output(await post(`/api/accounting/obligations/${id}/descontabilizar/`));
+  });
+  cmd.command("abonar <obligation_id>").description("Registrar un pago (abono) en una obligaci\xF3n.").requiredOption("--amount <n>", "Monto del abono", parseFloat).requiredOption("--payment-type <type>", "Tipo: cash, check, third_party, international, factoring, bad_debt").option("--notes <text>", "Notas opcionales", "").option("--no-contabilizar", "No auto-contabilizar el pago").action(async (id, opts) => {
+    output(await post(`/api/accounting/obligations/${id}/abonar/`, {
+      amount: opts.amount,
+      payment_type: opts.paymentType,
+      notes: opts.notes,
+      contabilizar: opts.contabilizar !== false
+    }));
+  });
+}
+
+// src/commands/banking.ts
+function registerBanking(program2) {
+  const cmd = program2.command("banking").description("Movimientos bancarios, clasificaci\xF3n y conciliaci\xF3n.");
+  cmd.command("movements").description("Listar movimientos bancarios.").requiredOption("--company <uuid>", "UUID de la empresa").option("--status <status>", "Estado: pending, reconciled, matched, split").option("--classification <text>", "Filtrar por clasificaci\xF3n").option("--period <yyyy-mm>", "Filtrar por mes (prefijo YYYY-MM)").option("--limit <n>", "L\xEDmite de resultados", (v) => parseInt(v), 30).option("--offset <n>", "Offset de paginaci\xF3n", (v) => parseInt(v), 0).action(async (opts) => {
+    const params = {
+      company: opts.company,
+      status: opts.status,
+      limit: opts.limit,
+      offset: opts.offset
+    };
+    if (opts.classification) params["classification__icontains"] = opts.classification;
+    if (opts.period) params["date__gte"] = `${opts.period}-01`;
+    output(await get("/api/accounting/bank-movements/", params));
+  });
+  cmd.command("movement <movement_id>").description("Obtener detalle de un movimiento bancario.").action(async (id) => {
+    output(await get(`/api/accounting/bank-movements/${id}/`));
+  });
+  cmd.command("classify <movement_id>").description("Clasificar un movimiento bancario.").requiredOption("--classification <text>", "Clasificaci\xF3n (ej: 'Gasto Operacional')").option("--document-type <type>", "Tipo documento (ej: 'Factura')").option("--comment <text>", "Comentario").action(async (id, opts) => {
+    const body = { classification: opts.classification };
+    if (opts.documentType) body["document_type"] = opts.documentType;
+    if (opts.comment) body["comment"] = opts.comment;
+    output(await patch(`/api/accounting/bank-movements/${id}/classify/`, body));
+  });
+  cmd.command("contabilizar <movement_id>").description("Crear asiento contable para un movimiento bancario.").requiredOption("--account-code <code>", "C\xF3digo de cuenta contrapartida (ej: '5101')").option("--description <text>", "Descripci\xF3n del asiento").action(async (id, opts) => {
+    const body = { account_code: opts.accountCode };
+    if (opts.description) body["description"] = opts.description;
+    output(await post(`/api/accounting/bank-movements/${id}/contabilizar/`, body));
+  });
+  cmd.command("contabilizar-reconciliaciones <movement_id>").description("Crear un asiento por cada reconciliaci\xF3n del movimiento.").requiredOption(
+    "--entries <json>",
+    'Array JSON: [{"reconciliation_id":"UUID","lines":[{"account_code":"5101","debit":1000,"credit":0}],"description":"opcional"}]'
+  ).action(async (id, opts) => {
+    output(await post(
+      `/api/accounting/bank-movements/${id}/contabilizar-reconciliaciones/`,
+      { entries: JSON.parse(opts.entries) }
+    ));
+  });
+  cmd.command("descontabilizar <movement_id>").description("Eliminar el asiento contable de un movimiento bancario.").action(async (id) => {
+    output(await post(`/api/accounting/bank-movements/${id}/descontabilizar/`, {}));
+  });
+  cmd.command("reconcile").description("Conciliar un movimiento con una obligaci\xF3n.").requiredOption("--movement-id <uuid>", "UUID del movimiento bancario").requiredOption("--obligation-id <uuid>", "UUID de la obligaci\xF3n").option("--amount <n>", "Monto (auto-detecta si no se proporciona)", parseFloat).option("--notes <text>", "Notas", "").action(async (opts) => {
+    const body = {
+      movement_id: opts.movementId,
+      obligation_id: opts.obligationId,
+      notes: opts.notes
+    };
+    if (opts.amount !== void 0) body["amount"] = opts.amount;
+    output(await post("/api/accounting/reconciliation/match", body));
+  });
+  cmd.command("reconcile-multi").description("Conciliar un movimiento con m\xFAltiples obligaciones (divide el monto autom\xE1ticamente).").requiredOption("--movement-id <uuid>", "UUID del movimiento bancario").requiredOption("--obligation-ids <uuids>", "UUIDs de obligaciones separados por coma").option("--notes <text>", "Notas", "").action(async (opts) => {
+    const ids = opts.obligationIds.split(",").map((s) => s.trim());
+    output(await post("/api/accounting/reconciliation/match-multi", {
+      movement_id: opts.movementId,
+      obligation_ids: ids,
+      notes: opts.notes
+    }));
+  });
+  cmd.command("unmatch <reconciliation_id>").description("Deshacer una conciliaci\xF3n (unmatch).").action(async (id) => {
+    output(await post("/api/accounting/reconciliation/unmatch", { reconciliation_id: id }));
+  });
+  cmd.command("list-reconciliations").description("Listar conciliaciones completadas.").requiredOption("--company <uuid>", "UUID de la empresa").option("--period <yyyy-mm>", "Per\xEDodo YYYY-MM").option("--limit <n>", "L\xEDmite de resultados", (v) => parseInt(v), 30).option("--offset <n>", "Offset de paginaci\xF3n", (v) => parseInt(v), 0).action(async (opts) => {
+    output(await get("/api/accounting/reconciliation/list", {
+      company_id: opts.company,
+      period: opts.period,
+      limit: opts.limit,
+      offset: opts.offset
+    }));
+  });
+  cmd.command("suggestions").description("Obtener sugerencias de conciliaci\xF3n para un movimiento.").requiredOption("--company <uuid>", "UUID de la empresa").requiredOption("--movement-id <uuid>", "UUID del movimiento").action(async (opts) => {
+    output(await get("/api/accounting/reconciliation/suggestions", {
+      company_id: opts.company,
+      movement_id: opts.movementId
+    }));
+  });
+  cmd.command("status").description("Estado de conciliaci\xF3n de la empresa.").requiredOption("--company <uuid>", "UUID de la empresa").option("--period <yyyy-mm>", "Per\xEDodo YYYY-MM").action(async (opts) => {
+    output(await get("/api/accounting/reconciliation/status", {
+      company_id: opts.company,
+      period: opts.period
+    }));
+  });
+  cmd.command("obligation-from-movement <movement_id>").description("Crear obligaci\xF3n desde un movimiento bancario y auto-conciliar.").option("--classification <text>", "Clasificaci\xF3n del movimiento (si no tiene)").option("--obligation-type <type>", "Tipo: payable o receivable (auto-detecta)").option("--notes <text>", "Notas", "").action(async (id, opts) => {
+    const body = { bank_movement_id: id, notes: opts.notes };
+    if (opts.classification) body["classification"] = opts.classification;
+    if (opts.obligationType) body["obligation_type_override"] = opts.obligationType;
+    output(await post("/api/accounting/obligations/create-from-movement/", body));
+  });
+}
+
+// src/schema.ts
+var SCHEMA = {
+  "name": "fizko",
+  "description": "CLI for the Fizko API. Query tax documents, accounting reports, and company data for Chilean businesses. All commands output JSON to stdout. Errors go to stderr as JSON with exit code 1.",
+  "auth": "Run 'fizko login' to authenticate, or set FIZKO_API_KEY env var. Credentials are stored in ~/.config/fizko/credentials.json.",
+  "global_flags": {
+    "--compact": "Output JSON without indentation (smaller output for programmatic use)"
+  },
+  "tip": "Start with 'fizko companies list' to get company UUIDs, then use those UUIDs in other commands.",
+  "commands": {
+    "companies list": {
+      "description": "List all companies the authenticated user has access to. Returns array of companies with id, rut, business_name, tax_info.",
+      "options": {
+        "--page": {
+          "type": "int",
+          "required": false,
+          "description": "Page number for pagination"
+        }
+      },
+      "example": "fizko companies list"
+    },
+    "companies get": {
+      "description": "Get full detail of a single company including tax_info, settings, and representatives.",
+      "args": {
+        "company_id": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        }
+      },
+      "example": "fizko companies get 550e8400-e29b-41d4-a716-446655440000"
+    },
+    "tax purchases": {
+      "description": "List purchase documents (facturas de compra). Returns paginated list with supplier info, amounts, IVA, document type, and period.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--period-year": {
+          "type": "int",
+          "required": false,
+          "description": "Filter by year (e.g. 2026)"
+        },
+        "--period-month": {
+          "type": "int",
+          "required": false,
+          "description": "Filter by month (1-12)"
+        },
+        "--document-type": {
+          "type": "str",
+          "required": false,
+          "description": "DTE type code (33=factura, 34=exenta, 61=nota credito)"
+        },
+        "--page": {
+          "type": "int",
+          "required": false,
+          "description": "Page number"
+        }
+      },
+      "example": "fizko tax purchases --company UUID --period-year 2026 --period-month 1"
+    },
+    "tax purchase": {
+      "description": "Get full detail of a single purchase document.",
+      "args": {
+        "purchase_id": {
+          "type": "UUID",
+          "required": true,
+          "description": "Purchase document UUID"
+        }
+      },
+      "example": "fizko tax purchase 550e8400-e29b-41d4-a716-446655440000"
+    },
+    "tax sales": {
+      "description": "List sales documents (facturas de venta). Returns paginated list with customer info, amounts, IVA, document type, and period.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--period-year": {
+          "type": "int",
+          "required": false,
+          "description": "Filter by year"
+        },
+        "--period-month": {
+          "type": "int",
+          "required": false,
+          "description": "Filter by month (1-12)"
+        },
+        "--document-type": {
+          "type": "str",
+          "required": false,
+          "description": "DTE type code"
+        },
+        "--page": {
+          "type": "int",
+          "required": false,
+          "description": "Page number"
+        }
+      },
+      "example": "fizko tax sales --company UUID --period-year 2026 --period-month 3"
+    },
+    "tax sale": {
+      "description": "Get full detail of a single sales document.",
+      "args": {
+        "sale_id": {
+          "type": "UUID",
+          "required": true,
+          "description": "Sales document UUID"
+        }
+      },
+      "example": "fizko tax sale UUID"
+    },
+    "tax contacts": {
+      "description": "List tax contacts (suppliers and customers). Returns business_name, rut, is_supplier, is_customer.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--page": {
+          "type": "int",
+          "required": false,
+          "description": "Page number"
+        }
+      },
+      "example": "fizko tax contacts --company UUID"
+    },
+    "tax documents": {
+      "description": "List ALL tax documents unified (purchases + sales + honorarios) sorted by date. Best for getting a complete view of transactions.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--period": {
+          "type": "str",
+          "required": false,
+          "description": "Period YYYY-MM"
+        },
+        "--start-date": {
+          "type": "str",
+          "required": false,
+          "description": "Start date YYYY-MM-DD"
+        },
+        "--end-date": {
+          "type": "str",
+          "required": false,
+          "description": "End date YYYY-MM-DD"
+        },
+        "--limit": {
+          "type": "int",
+          "required": false,
+          "description": "Results per page (default 100)"
+        },
+        "--offset": {
+          "type": "int",
+          "required": false,
+          "description": "Pagination offset"
+        }
+      },
+      "example": "fizko tax documents --company-id UUID --period 2026-01"
+    },
+    "tax document": {
+      "description": "Get full detail of any tax document by its UUID (purchase, sale, or honorario).",
+      "args": {
+        "document_id": {
+          "type": "UUID",
+          "required": true,
+          "description": "Document UUID"
+        }
+      },
+      "example": "fizko tax document UUID"
+    },
+    "tax documents-summary": {
+      "description": "Get transaction count summary by document type for the last 3 months. Useful for understanding transaction volume.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        }
+      },
+      "example": "fizko tax documents-summary --company-id UUID"
+    },
+    "tax f29": {
+      "description": "List Form 29 tax declarations (monthly VAT/income tax) grouped by period. Includes both local and SII-downloaded versions.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--year": {
+          "type": "int",
+          "required": false,
+          "description": "Filter by year"
+        },
+        "--page": {
+          "type": "int",
+          "required": false,
+          "description": "Page number"
+        }
+      },
+      "example": "fizko tax f29 --company-id UUID --year 2026"
+    },
+    "tax f29-export": {
+      "description": "Export documents contributing to a specific F29 code as CSV data.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--code": {
+          "type": "str",
+          "required": true,
+          "description": "F29 code to export"
+        },
+        "--period": {
+          "type": "str",
+          "required": true,
+          "description": "Period YYYY-MM"
+        }
+      },
+      "example": "fizko tax f29-export --company-id UUID --code 538 --period 2026-01"
+    },
+    "tax f29-codes": {
+      "description": "List all F29 codes that have exportable documents for a period.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--period": {
+          "type": "str",
+          "required": true,
+          "description": "Period YYYY-MM"
+        }
+      },
+      "example": "fizko tax f29-codes --company-id UUID --period 2026-01"
+    },
+    "tax summary": {
+      "description": "Get tax summary for a period from Form 29 data. Includes IVA debito/credito, PPM, retention amounts.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--period": {
+          "type": "str",
+          "required": true,
+          "description": "Period YYYY-MM"
+        }
+      },
+      "example": "fizko tax summary --company-id UUID --period 2026-01"
+    },
+    "tax iva": {
+      "description": "Get IVA (VAT) summary for a period. Shows IVA debito, credito, and balance.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--period": {
+          "type": "str",
+          "required": true,
+          "description": "Period YYYY-MM"
+        }
+      },
+      "example": "fizko tax iva --company-id UUID --period 2026-01"
+    },
+    "tax timeline": {
+      "description": "Get tax timeline for the last 12 months. Shows monthly totals for purchases, sales, IVA.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        }
+      },
+      "example": "fizko tax timeline --company-id UUID"
+    },
+    "tax honorarios": {
+      "description": "List boletas de honorarios (freelance receipts). Shows issuer, amount, retention, dates.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--period-year": {
+          "type": "int",
+          "required": false,
+          "description": "Filter by year"
+        },
+        "--period-month": {
+          "type": "int",
+          "required": false,
+          "description": "Filter by month (1-12)"
+        }
+      },
+      "example": "fizko tax honorarios --company UUID --period-year 2026"
+    },
+    "tax ddjj": {
+      "description": "List declaraciones juradas (annual sworn statements). Shows DJ number, status, year.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--year": {
+          "type": "int",
+          "required": false,
+          "description": "Tax year"
+        }
+      },
+      "example": "fizko tax ddjj --company-id UUID --year 2025"
+    },
+    "tax checker-tributario": {
+      "description": "Compare SII purchase/sales books vs Fizko accounting records. Shows discrepancies between declared and booked documents.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--period": {
+          "type": "str",
+          "required": true,
+          "description": "Period YYYY-MM"
+        }
+      },
+      "example": "fizko tax checker-tributario --company-id UUID --period 2026-01"
+    },
+    "tax checker-impuestos": {
+      "description": "Compare taxes declared in F29 vs taxes booked in Fizko accounting. Shows discrepancies per tax line.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--period": {
+          "type": "str",
+          "required": true,
+          "description": "Period YYYY-MM"
+        }
+      },
+      "example": "fizko tax checker-impuestos --company-id UUID --period 2026-01"
+    },
+    "accounting accounts": {
+      "description": "List chart of accounts (plan de cuentas). Returns account code, name, type, balance. Use --tree for hierarchical structure.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--tree": {
+          "type": "bool",
+          "required": false,
+          "description": "Return as tree structure instead of flat list"
+        }
+      },
+      "example": "fizko accounting accounts --company UUID --tree"
+    },
+    "accounting journal-entries": {
+      "description": "List journal entries (asientos contables). Returns entry date, description, lines with debit/credit amounts.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--period": {
+          "type": "str",
+          "required": false,
+          "description": "Period YYYY-MM"
+        },
+        "--limit": {
+          "type": "int",
+          "required": false,
+          "description": "Results limit"
+        },
+        "--offset": {
+          "type": "int",
+          "required": false,
+          "description": "Pagination offset"
+        }
+      },
+      "example": "fizko accounting journal-entries --company UUID --period 2026-01"
+    },
+    "accounting journal-entry": {
+      "description": "Get full detail of a journal entry including all debit/credit lines.",
+      "args": {
+        "entry_id": {
+          "type": "UUID",
+          "required": true,
+          "description": "Journal entry UUID"
+        }
+      },
+      "example": "fizko accounting journal-entry UUID"
+    },
+    "accounting balance-report": {
+      "description": "Balance de 8 columnas (Eight-Column Balance Sheet). Shows opening balances, movements, sums, and closing balances per account.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--period-from": {
+          "type": "str",
+          "required": true,
+          "description": "Start period YYYY-MM"
+        },
+        "--period-to": {
+          "type": "str",
+          "required": true,
+          "description": "End period YYYY-MM"
+        },
+        "--cost-center-id": {
+          "type": "UUID",
+          "required": false,
+          "description": "Filter by cost center"
+        }
+      },
+      "example": "fizko accounting balance-report --company-id UUID --period-from 2026-01 --period-to 2026-12"
+    },
+    "accounting income-statement": {
+      "description": "Estado de Resultados (Income Statement / EERR). Shows revenue, costs, expenses, and net income by category.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--period-from": {
+          "type": "str",
+          "required": true,
+          "description": "Start period YYYY-MM"
+        },
+        "--period-to": {
+          "type": "str",
+          "required": true,
+          "description": "End period YYYY-MM"
+        },
+        "--cost-center-id": {
+          "type": "UUID",
+          "required": false,
+          "description": "Filter by cost center"
+        }
+      },
+      "example": "fizko accounting income-statement --company-id UUID --period-from 2026-01 --period-to 2026-12"
+    },
+    "accounting general-journal": {
+      "description": "Libro Diario (General Journal). Lists all posted journal entries for a period with line detail.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--period": {
+          "type": "str",
+          "required": true,
+          "description": "Period YYYY-MM"
+        },
+        "--page": {
+          "type": "int",
+          "required": false,
+          "description": "Page number"
+        },
+        "--page-size": {
+          "type": "int",
+          "required": false,
+          "description": "Results per page"
+        }
+      },
+      "example": "fizko accounting general-journal --company-id UUID --period 2026-01"
+    },
+    "accounting general-ledger": {
+      "description": "Libro Mayor (General Ledger). Shows all movements per account for a period range.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--period-from": {
+          "type": "str",
+          "required": true,
+          "description": "Start period YYYY-MM"
+        },
+        "--period-to": {
+          "type": "str",
+          "required": true,
+          "description": "End period YYYY-MM"
+        },
+        "--account-id": {
+          "type": "UUID",
+          "required": false,
+          "description": "Filter by specific account"
+        }
+      },
+      "example": "fizko accounting general-ledger --company-id UUID --period-from 2026-01 --period-to 2026-12"
+    },
+    "accounting classified-balance": {
+      "description": "Balance Clasificado (Classified Balance Sheet). Groups accounts by clasificacion_balance categories.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--period": {
+          "type": "str",
+          "required": false,
+          "description": "Single period YYYY-MM (or use period-from/period-to)"
+        },
+        "--period-from": {
+          "type": "str",
+          "required": false,
+          "description": "Start period YYYY-MM"
+        },
+        "--period-to": {
+          "type": "str",
+          "required": false,
+          "description": "End period YYYY-MM"
+        },
+        "--cost-center-id": {
+          "type": "UUID",
+          "required": false,
+          "description": "Filter by cost center"
+        }
+      },
+      "example": "fizko accounting classified-balance --company-id UUID --period 2026-12"
+    },
+    "accounting rli-balance": {
+      "description": "Balance RLI (Renta Liquida Imponible). Shows taxable income calculation for Operacion Renta.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--period-from": {
+          "type": "str",
+          "required": true,
+          "description": "Start period YYYY-MM"
+        },
+        "--period-to": {
+          "type": "str",
+          "required": true,
+          "description": "End period YYYY-MM"
+        }
+      },
+      "example": "fizko accounting rli-balance --company-id UUID --period-from 2026-01 --period-to 2026-12"
+    },
+    "accounting progress": {
+      "description": "Accounting progress metrics. Shows how many documents are booked vs pending for a period.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--period": {
+          "type": "str",
+          "required": false,
+          "description": "Period YYYY-MM"
+        }
+      },
+      "example": "fizko accounting progress --company-id UUID --period 2026-01"
+    },
+    "accounting obligations": {
+      "description": "List accounting obligations (cuentas por pagar/cobrar). Filterable by type, status, period.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--obligation-type": {
+          "type": "str",
+          "required": false,
+          "description": "payable or receivable"
+        },
+        "--status": {
+          "type": "str",
+          "required": false,
+          "description": "pending, partial, paid, overdue"
+        },
+        "--period": {
+          "type": "str",
+          "required": false,
+          "description": "Period YYYY-MM"
+        },
+        "--limit": {
+          "type": "int",
+          "required": false,
+          "description": "Results limit (default 30)"
+        },
+        "--offset": {
+          "type": "int",
+          "required": false,
+          "description": "Pagination offset"
+        }
+      },
+      "example": "fizko accounting obligations --company UUID --status pending --period 2026-01"
+    },
+    "accounting obligation": {
+      "description": "Get full detail of an obligation including journal entry, payments, reconciliations.",
+      "args": {
+        "obligation_id": {
+          "type": "UUID",
+          "required": true,
+          "description": "Obligation UUID"
+        }
+      },
+      "example": "fizko accounting obligation UUID"
+    },
+    "accounting contabilizar": {
+      "description": "Create journal entry for an obligation. Without extra params, auto-generates lines from account rules. Provide --lines for explicit control or --account-code for legacy mode.",
+      "args": {
+        "obligation_id": {
+          "type": "UUID",
+          "required": true,
+          "description": "Obligation UUID"
+        }
+      },
+      "options": {
+        "--lines": {
+          "type": "JSON",
+          "required": false,
+          "description": 'Journal lines as JSON array: [{"account_code":"5101","debit":1000,"credit":0}]'
+        },
+        "--account-code": {
+          "type": "str",
+          "required": false,
+          "description": "Counterpart account code (legacy mode)"
+        },
+        "--description": {
+          "type": "str",
+          "required": false,
+          "description": "Journal entry description"
+        }
+      },
+      "example": "fizko accounting contabilizar UUID"
+    },
+    "accounting descontabilizar": {
+      "description": "Delete the journal entry linked to an obligation.",
+      "args": {
+        "obligation_id": {
+          "type": "UUID",
+          "required": true,
+          "description": "Obligation UUID"
+        }
+      },
+      "example": "fizko accounting descontabilizar UUID"
+    },
+    "accounting abonar": {
+      "description": "Record a payment on an obligation. By default also creates journal entry (--contabilizar). Use --no-contabilizar to skip.",
+      "args": {
+        "obligation_id": {
+          "type": "UUID",
+          "required": true,
+          "description": "Obligation UUID"
+        }
+      },
+      "options": {
+        "--amount": {
+          "type": "float",
+          "required": true,
+          "description": "Payment amount"
+        },
+        "--payment-type": {
+          "type": "str",
+          "required": true,
+          "description": "cash, check, third_party, international, factoring, bad_debt"
+        },
+        "--notes": {
+          "type": "str",
+          "required": false,
+          "description": "Payment notes"
+        },
+        "--contabilizar/--no-contabilizar": {
+          "type": "bool",
+          "required": false,
+          "description": "Auto-create journal entry (default: yes)"
+        }
+      },
+      "example": "fizko accounting abonar UUID --amount 50000 --payment-type cash"
+    },
+    "banking movements": {
+      "description": "List bank movements. Filterable by status, classification, period.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--status": {
+          "type": "str",
+          "required": false,
+          "description": "pending, reconciled, matched, split"
+        },
+        "--classification": {
+          "type": "str",
+          "required": false,
+          "description": "Filter by classification text"
+        },
+        "--period": {
+          "type": "str",
+          "required": false,
+          "description": "Period YYYY-MM"
+        },
+        "--limit": {
+          "type": "int",
+          "required": false,
+          "description": "Results limit (default 30)"
+        },
+        "--offset": {
+          "type": "int",
+          "required": false,
+          "description": "Pagination offset"
+        }
+      },
+      "example": "fizko banking movements --company UUID --status pending"
+    },
+    "banking movement": {
+      "description": "Get full detail of a bank movement including journal entry and reconciliations.",
+      "args": {
+        "movement_id": {
+          "type": "UUID",
+          "required": true,
+          "description": "Bank movement UUID"
+        }
+      },
+      "example": "fizko banking movement UUID"
+    },
+    "banking classify": {
+      "description": "Classify a bank movement (e.g., 'Gasto Operacional', 'Ingreso Operacional').",
+      "args": {
+        "movement_id": {
+          "type": "UUID",
+          "required": true,
+          "description": "Bank movement UUID"
+        }
+      },
+      "options": {
+        "--classification": {
+          "type": "str",
+          "required": true,
+          "description": "Classification label"
+        },
+        "--document-type": {
+          "type": "str",
+          "required": false,
+          "description": "Document type (Factura, Boleta, etc.)"
+        },
+        "--comment": {
+          "type": "str",
+          "required": false,
+          "description": "Explanation comment"
+        }
+      },
+      "example": "fizko banking classify UUID --classification 'Gasto Operacional'"
+    },
+    "banking contabilizar": {
+      "description": "Create journal entry for a bank movement. Requires counterpart account code.",
+      "args": {
+        "movement_id": {
+          "type": "UUID",
+          "required": true,
+          "description": "Bank movement UUID"
+        }
+      },
+      "options": {
+        "--account-code": {
+          "type": "str",
+          "required": true,
+          "description": "Counterpart account code (e.g., '5101')"
+        },
+        "--description": {
+          "type": "str",
+          "required": false,
+          "description": "Journal entry description"
+        }
+      },
+      "example": "fizko banking contabilizar UUID --account-code 5101"
+    },
+    "banking descontabilizar": {
+      "description": "Delete the journal entry linked to a bank movement.",
+      "args": {
+        "movement_id": {
+          "type": "UUID",
+          "required": true,
+          "description": "Bank movement UUID"
+        }
+      },
+      "example": "fizko banking descontabilizar UUID"
+    },
+    "banking contabilizar-reconciliaciones": {
+      "description": "Create one journal entry per reconciliation for a movement. Use when movement has multiple reconciliations with different accounts.",
+      "args": {
+        "movement_id": {
+          "type": "UUID",
+          "required": true,
+          "description": "Bank movement UUID"
+        }
+      },
+      "options": {
+        "--entries": {
+          "type": "JSON",
+          "required": true,
+          "description": 'Array: [{"reconciliation_id":"UUID","lines":[{"account_code":"5101","debit":1000,"credit":0}],"description":"optional"}]'
+        }
+      },
+      "example": `fizko banking contabilizar-reconciliaciones UUID --entries '[{"reconciliation_id":"UUID","lines":[{"account_code":"5101","debit":1000,"credit":0}]}]'`
+    },
+    "banking reconcile": {
+      "description": "Match a bank movement with a single obligation.",
+      "options": {
+        "--movement-id": {
+          "type": "UUID",
+          "required": true,
+          "description": "Bank movement UUID"
+        },
+        "--obligation-id": {
+          "type": "UUID",
+          "required": true,
+          "description": "Obligation UUID"
+        },
+        "--amount": {
+          "type": "float",
+          "required": false,
+          "description": "Reconciliation amount (auto-detected if omitted)"
+        },
+        "--notes": {
+          "type": "str",
+          "required": false,
+          "description": "Notes"
+        }
+      },
+      "example": "fizko banking reconcile --movement-id UUID --obligation-id UUID"
+    },
+    "banking reconcile-multi": {
+      "description": "Match a bank movement with multiple obligations. Automatically splits the movement amount across obligations.",
+      "options": {
+        "--movement-id": {
+          "type": "UUID",
+          "required": true,
+          "description": "Bank movement UUID"
+        },
+        "--obligation-ids": {
+          "type": "str",
+          "required": true,
+          "description": "Comma-separated obligation UUIDs"
+        },
+        "--notes": {
+          "type": "str",
+          "required": false,
+          "description": "Notes"
+        }
+      },
+      "example": "fizko banking reconcile-multi --movement-id UUID --obligation-ids UUID1,UUID2"
+    },
+    "banking unmatch": {
+      "description": "Undo a reconciliation (unmatch). Returns the movement to pending status.",
+      "args": {
+        "reconciliation_id": {
+          "type": "UUID",
+          "required": true,
+          "description": "Reconciliation UUID to undo"
+        }
+      },
+      "example": "fizko banking unmatch UUID"
+    },
+    "banking list-reconciliations": {
+      "description": "List completed reconciliations for a company/period.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--period": {
+          "type": "str",
+          "required": false,
+          "description": "Period YYYY-MM"
+        },
+        "--limit": {
+          "type": "int",
+          "required": false,
+          "description": "Results limit (default 30)"
+        },
+        "--offset": {
+          "type": "int",
+          "required": false,
+          "description": "Pagination offset"
+        }
+      },
+      "example": "fizko banking list-reconciliations --company UUID --period 2026-01"
+    },
+    "banking suggestions": {
+      "description": "Get AI-scored reconciliation suggestions for a specific bank movement.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--movement-id": {
+          "type": "UUID",
+          "required": true,
+          "description": "Bank movement UUID"
+        }
+      },
+      "example": "fizko banking suggestions --company UUID --movement-id UUID"
+    },
+    "banking status": {
+      "description": "Get reconciliation progress metrics for a company/period.",
+      "options": {
+        "--company": {
+          "type": "UUID",
+          "required": true,
+          "description": "Company UUID"
+        },
+        "--period": {
+          "type": "str",
+          "required": false,
+          "description": "Period YYYY-MM"
+        }
+      },
+      "example": "fizko banking status --company UUID --period 2026-01"
+    },
+    "banking obligation-from-movement": {
+      "description": "Create an obligation from a bank movement and auto-reconcile.",
+      "args": {
+        "movement_id": {
+          "type": "UUID",
+          "required": true,
+          "description": "Bank movement UUID"
+        }
+      },
+      "options": {
+        "--classification": {
+          "type": "str",
+          "required": false,
+          "description": "Classification for unclassified movements"
+        },
+        "--obligation-type": {
+          "type": "str",
+          "required": false,
+          "description": "payable or receivable (auto-detected)"
+        },
+        "--notes": {
+          "type": "str",
+          "required": false,
+          "description": "Notes"
+        }
+      },
+      "example": "fizko banking obligation-from-movement UUID --classification 'Gasto Operacional'"
+    }
+  }
+};
+
+// src/index.ts
+var program = new import_commander.Command();
+program.name("fizko").description(
+  "CLI for the Fizko API. Query tax documents, accounting reports, and company data.\n\nQuick start:\n  fizko login                              # authenticate\n  fizko companies list                     # get company UUIDs\n  fizko tax purchases --company <uuid>     # query data\n  fizko schema                             # show all commands as JSON (for AI agents)"
+).option("--compact", "Output JSON without indentation").hook("preAction", (thisCommand) => {
+  if (thisCommand.opts().compact) setCompact(true);
+});
+program.command("schema").description("Print machine-readable schema of all commands as JSON. Designed for AI agent discovery.").action(() => {
+  output(SCHEMA);
+});
+registerAuth(program);
+registerCompanies(program);
+registerTax(program);
+registerAccounting(program);
+registerBanking(program);
+program.parseAsync(process.argv).catch((err) => {
+  process.stderr.write(JSON.stringify({ error: String(err) }) + "\n");
+  process.exit(1);
+});