@br-validators/cli 1.3.0 → 1.6.0

package/dist/run-captured.js

@@ -6,13 +6,767 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 });
 
 // src/constants.ts
-var SUPPORTED_TYPES = ["cnpj", "cpf", "cep", "telefone", "cnh", "renavam", "titulo-eleitor", "nfe-chave", "brcode", "placa", "pis-pasep", "pix", "boleto", "cartao", "ie"];
+var SUPPORTED_TYPES = ["cnpj", "cpf", "cep", "telefone", "cnh", "renavam", "titulo-eleitor", "processo-judicial", "rg", "nfe-chave", "brcode", "placa", "pis-pasep", "pix", "boleto", "cartao", "ie"];
 var EXIT = {
   OK: 0,
   INVALID: 1,
   USAGE: 2
 };
 
+// src/commands/reference-lookup/registry.ts
+import {
+  CEST_DATA_VERSION,
+  getCestPorCodigo
+} from "@br-validators/core/cest";
+import {
+  INCOTERMS_DATA_VERSION,
+  getIncotermPorCodigo
+} from "@br-validators/core/incoterms";
+import {
+  MOEDAS_DATA_VERSION,
+  getMoedaPorCodigo
+} from "@br-validators/core/moedas";
+import {
+  NATUREZA_JURIDICA_DATA_VERSION,
+  getNaturezaJuridicaPorCodigo
+} from "@br-validators/core/natureza-juridica";
+import { NBS_DATA_VERSION, getNbsPorCodigo } from "@br-validators/core/nbs";
+import {
+  PAISES_BACEN_DATA_VERSION,
+  getPaisPorCodigoBacen
+} from "@br-validators/core/paises-bacen";
+import {
+  AEROPORTOS_DATA_VERSION,
+  getAeroportoPorIata,
+  getAeroportoPorIcao
+} from "@br-validators/core/aeroportos";
+import { PORTOS_DATA_VERSION, getPortoPorCodigo } from "@br-validators/core/portos";
+import {
+  CNAES_DATA_VERSION,
+  getCnaePorCodigo
+} from "@br-validators/core/cnaes";
+import {
+  CFOP_DATA_VERSION,
+  getCfopPorCodigo
+} from "@br-validators/core/cfop";
+import { NCM_DATA_VERSION, getNcmPorCodigo } from "@br-validators/core/ncm";
+import { CBO_DATA_VERSION, getCboPorCodigo } from "@br-validators/core/cbo";
+var REFERENCE_LOOKUP_COMMANDS = [
+  "natureza-juridica",
+  "nbs",
+  "cest",
+  "cnae",
+  "cfop",
+  "ncm",
+  "cbo",
+  "moedas",
+  "paises-bacen",
+  "incoterms",
+  "portos",
+  "aeroportos"
+];
+var REFERENCE_SEARCH_COMMANDS = ["cnae", "cfop", "ncm", "cbo"];
+function lookupAeroporto(input) {
+  const normalized = input.trim().toUpperCase();
+  if (/^[A-Z0-9]{3}$/.test(normalized)) {
+    return getAeroportoPorIata(normalized);
+  }
+  if (/^[A-Z]{4}$/.test(normalized)) {
+    return getAeroportoPorIcao(normalized);
+  }
+  return void 0;
+}
+var REFERENCE_LOOKUP_MODULES = {
+  "natureza-juridica": {
+    command: "natureza-juridica",
+    description: "RFB legal nature codes \u2014 offline lookup",
+    resultKey: "naturezaJuridica",
+    capturadoEm: NATUREZA_JURIDICA_DATA_VERSION.capturadoEm,
+    lookup: (input) => getNaturezaJuridicaPorCodigo(input),
+    formatHuman: (result) => {
+      const row = result;
+      return `${row.codigo} \u2014 ${row.descricao}`;
+    }
+  },
+  nbs: {
+    command: "nbs",
+    description: "NFSe NBS service codes \u2014 offline lookup",
+    resultKey: "nbs",
+    capturadoEm: NBS_DATA_VERSION.capturadoEm,
+    lookup: (input) => getNbsPorCodigo(input),
+    formatHuman: (result) => {
+      const row = result;
+      return `${row.codigo} \u2014 ${row.descricao}`;
+    }
+  },
+  cest: {
+    command: "cest",
+    description: "CONFAZ CEST ST codes \u2014 offline lookup",
+    resultKey: "cest",
+    capturadoEm: CEST_DATA_VERSION.capturadoEm,
+    lookup: (input) => getCestPorCodigo(input),
+    formatHuman: (result) => {
+      const row = result;
+      return `${row.codigo} \u2014 ${row.descricao}`;
+    }
+  },
+  cnae: {
+    command: "cnae",
+    description: "IBGE CNAE 2.3 subclasses \u2014 offline lookup",
+    resultKey: "cnae",
+    capturadoEm: CNAES_DATA_VERSION.capturadoEm,
+    lookup: (input) => getCnaePorCodigo(input),
+    formatHuman: (result) => {
+      const row = result;
+      return `${row.codigo} \u2014 ${row.descricao}`;
+    }
+  },
+  cfop: {
+    command: "cfop",
+    description: "CONFAZ CFOP fiscal operations \u2014 offline lookup",
+    resultKey: "cfop",
+    capturadoEm: CFOP_DATA_VERSION.capturadoEm,
+    lookup: (input) => getCfopPorCodigo(input),
+    formatHuman: (result) => {
+      const row = result;
+      return `${row.codigo} \u2014 ${row.descricao}`;
+    }
+  },
+  ncm: {
+    command: "ncm",
+    description: "Siscomex NCM Mercosur codes \u2014 offline lookup",
+    resultKey: "ncm",
+    capturadoEm: NCM_DATA_VERSION.capturadoEm,
+    lookup: (input) => getNcmPorCodigo(input),
+    formatHuman: (result) => {
+      const row = result;
+      return `${row.codigo} \u2014 ${row.descricao}`;
+    }
+  },
+  cbo: {
+    command: "cbo",
+    description: "MTE CBO 2002 occupations \u2014 offline lookup",
+    resultKey: "cbo",
+    capturadoEm: CBO_DATA_VERSION.capturadoEm,
+    lookup: (input) => getCboPorCodigo(input),
+    formatHuman: (result) => {
+      const row = result;
+      return `${row.codigo} \u2014 ${row.descricao}`;
+    }
+  },
+  moedas: {
+    command: "moedas",
+    description: "ISO 4217 + Bacen PTAX currencies \u2014 offline lookup",
+    resultKey: "moeda",
+    capturadoEm: MOEDAS_DATA_VERSION.capturadoEm,
+    lookup: (input) => getMoedaPorCodigo(input),
+    formatHuman: (result) => {
+      const row = result;
+      const symbol = row.simbolo ?? "\u2014";
+      return `${row.codigo} \u2014 ${row.nome} (${symbol})`;
+    }
+  },
+  "paises-bacen": {
+    command: "paises-bacen",
+    description: "NF-e Bacen country codes \u2014 offline lookup",
+    resultKey: "pais",
+    capturadoEm: PAISES_BACEN_DATA_VERSION.capturadoEm,
+    lookup: (input) => getPaisPorCodigoBacen(input),
+    formatHuman: (result) => {
+      const row = result;
+      return `${row.codigo} \u2014 ${row.nome}`;
+    }
+  },
+  incoterms: {
+    command: "incoterms",
+    description: "ICC Incoterms 2020 \u2014 offline lookup",
+    resultKey: "incoterm",
+    capturadoEm: INCOTERMS_DATA_VERSION.capturadoEm,
+    lookup: (input) => getIncotermPorCodigo(input),
+    formatHuman: (result) => {
+      const row = result;
+      return `${row.codigo} \u2014 ${row.nome} (${row.edicao})`;
+    }
+  },
+  portos: {
+    command: "portos",
+    description: "ANTAQ port installations \u2014 offline lookup",
+    resultKey: "porto",
+    capturadoEm: PORTOS_DATA_VERSION.capturadoEm,
+    lookup: (input) => getPortoPorCodigo(input),
+    formatHuman: (result) => {
+      const row = result;
+      return `${row.codigo} \u2014 ${row.nome} (${row.uf})`;
+    }
+  },
+  aeroportos: {
+    command: "aeroportos",
+    description: "ANAC public aerodromos \u2014 offline lookup by IATA or ICAO",
+    resultKey: "aeroporto",
+    capturadoEm: AEROPORTOS_DATA_VERSION.capturadoEm,
+    lookup: lookupAeroporto,
+    formatHuman: (result) => {
+      const row = result;
+      const iata = row.iata ?? "\u2014";
+      return `${iata}/${row.icao} \u2014 ${row.nome} (${row.uf})`;
+    }
+  }
+};
+function isReferenceLookupCommand(value) {
+  return REFERENCE_LOOKUP_COMMANDS.includes(value);
+}
+function isReferenceSearchCommand(value) {
+  return REFERENCE_SEARCH_COMMANDS.includes(value);
+}
+
+// src/commands/bancos/list.ts
+import { BANCOS_DATA_VERSION as BANCOS_DATA_VERSION2, getBancos } from "@br-validators/core/bancos";
+
+// src/commands/bancos/lookup.ts
+import {
+  BANCOS_DATA_VERSION,
+  getBancoPorCodigo,
+  getBancoPorIspb
+} from "@br-validators/core/bancos";
+function normalizeBancosLookupInput(raw) {
+  const digits = raw.replace(/\D/g, "");
+  if (digits.length === 8) {
+    return { kind: "ispb", value: digits.padStart(8, "0") };
+  }
+  if (digits.length >= 1 && digits.length <= 3) {
+    return { kind: "codigo", value: digits.padStart(3, "0").slice(-3) };
+  }
+  return null;
+}
+function lookupBanco(raw) {
+  const normalized = normalizeBancosLookupInput(raw);
+  if (!normalized) {
+    return void 0;
+  }
+  return normalized.kind === "ispb" ? getBancoPorIspb(normalized.value) : getBancoPorCodigo(normalized.value);
+}
+function formatBancoHuman(banco) {
+  return `${banco.codigo} \u2014 ${banco.nome} (ISPB ${banco.ispb})`;
+}
+function runBancosLookupCommand(input, options, io = { stdout: [], stderr: [] }) {
+  const normalized = normalizeBancosLookupInput(input);
+  if (!normalized) {
+    io.stderr.push("Invalid bank code or ISPB. Use 3-digit COMPE (e.g. 001) or 8-digit ISPB.");
+    return EXIT.USAGE;
+  }
+  const banco = lookupBanco(input);
+  if (!banco) {
+    io.stderr.push(`Bank not found: ${input}`);
+    return EXIT.INVALID;
+  }
+  if (options.json) {
+    const payload = { ok: true, banco };
+    if (options.verbose) {
+      payload.capturadoEm = BANCOS_DATA_VERSION.capturadoEm;
+    }
+    io.stdout.push(JSON.stringify(payload, null, 2));
+    return EXIT.OK;
+  }
+  io.stdout.push(formatBancoHuman(banco));
+  if (options.verbose) {
+    io.stdout.push(`capturadoEm: ${BANCOS_DATA_VERSION.capturadoEm}`);
+  }
+  return EXIT.OK;
+}
+function runBancosLookup(value, options, io = { stdout: [], stderr: [] }) {
+  if (!value?.trim()) {
+    io.stderr.push("Missing bank code or ISPB. Pass COMPE (001) or ISPB (8 digits).");
+    return EXIT.USAGE;
+  }
+  return runBancosLookupCommand(value.trim(), options, io);
+}
+
+// src/commands/bancos/list.ts
+function sliceBancos(limit) {
+  const all = getBancos();
+  if (limit === void 0 || !Number.isFinite(limit) || limit <= 0) {
+    return all;
+  }
+  return all.slice(0, limit);
+}
+function runBancosListCommand(options, io = { stdout: [], stderr: [] }) {
+  const bancos = sliceBancos(options.limit);
+  if (options.json) {
+    const payload = {
+      ok: true,
+      total: bancos.length,
+      bancos
+    };
+    if (options.verbose) {
+      payload.capturadoEm = BANCOS_DATA_VERSION2.capturadoEm;
+    }
+    io.stdout.push(JSON.stringify(payload, null, 2));
+    return EXIT.OK;
+  }
+  for (const banco of bancos) {
+    io.stdout.push(formatBancoHuman(banco));
+  }
+  if (options.verbose) {
+    io.stdout.push(`capturadoEm: ${BANCOS_DATA_VERSION2.capturadoEm}`);
+  }
+  return EXIT.OK;
+}
+function runBancosList(options, io = { stdout: [], stderr: [] }) {
+  return runBancosListCommand(options, io);
+}
+
+// src/commands/reference-lookup/lookup.ts
+function runReferenceLookupCommand(command, input, options, io = { stdout: [], stderr: [] }) {
+  const module = REFERENCE_LOOKUP_MODULES[command];
+  const trimmed = input.trim();
+  if (trimmed.length === 0) {
+    io.stderr.push(`Missing code. Pass a lookup value for ${command}.`);
+    return EXIT.USAGE;
+  }
+  const result = module.lookup(trimmed);
+  if (!result) {
+    io.stderr.push(`Not found: ${trimmed}`);
+    return EXIT.INVALID;
+  }
+  if (options.json) {
+    const payload = {
+      ok: true,
+      [module.resultKey]: result,
+      ...options.verbose ? { capturadoEm: module.capturadoEm } : {}
+    };
+    io.stdout.push(JSON.stringify(payload, null, 2));
+    return EXIT.OK;
+  }
+  io.stdout.push(module.formatHuman(result));
+  if (options.verbose) {
+    io.stdout.push(`capturadoEm: ${module.capturadoEm}`);
+  }
+  return EXIT.OK;
+}
+function runReferenceLookup(command, value, options, io = { stdout: [], stderr: [] }) {
+  if (!isReferenceLookupCommand(command)) {
+    io.stderr.push(`Unknown reference lookup command: ${command}`);
+    return EXIT.USAGE;
+  }
+  if (!value?.trim()) {
+    io.stderr.push(`Missing code. Usage: br-validators ${command} lookup <codigo>`);
+    return EXIT.USAGE;
+  }
+  return runReferenceLookupCommand(command, value.trim(), options, io);
+}
+
+// src/commands/reference-lookup/search.ts
+import { searchCbo } from "@br-validators/core/cbo";
+import { searchCnaes } from "@br-validators/core/cnaes";
+import { searchCfop } from "@br-validators/core/cfop";
+import { searchNcm } from "@br-validators/core/ncm";
+function runSearch(command, query, limit) {
+  switch (command) {
+    case "cnae":
+      return searchCnaes(query, { limit });
+    case "cfop":
+      return searchCfop(query, { limit });
+    case "ncm":
+      return searchNcm(query, { limit });
+    case "cbo":
+      return searchCbo(query, { limit });
+  }
+}
+function formatSearchHuman(command, results) {
+  const module = REFERENCE_LOOKUP_MODULES[command];
+  return results.map((row) => module.formatHuman(row));
+}
+function runReferenceSearchCommand(command, query, options, io = { stdout: [], stderr: [] }) {
+  const trimmed = query.trim();
+  if (trimmed.length === 0) {
+    io.stderr.push(`Missing search query. Pass a description fragment for ${command}.`);
+    return EXIT.USAGE;
+  }
+  const limit = options.limit !== void 0 && options.limit > 0 ? options.limit : 10;
+  const results = runSearch(command, trimmed, limit);
+  const module = REFERENCE_LOOKUP_MODULES[command];
+  const resultKey = `${module.resultKey}s`;
+  if (options.json) {
+    const payload = {
+      ok: true,
+      query: trimmed,
+      total: results.length,
+      [resultKey]: results,
+      ...options.verbose ? { capturadoEm: module.capturadoEm } : {}
+    };
+    io.stdout.push(JSON.stringify(payload, null, 2));
+    return EXIT.OK;
+  }
+  if (results.length === 0) {
+    io.stderr.push(`No matches for: ${trimmed}`);
+    return EXIT.INVALID;
+  }
+  for (const line of formatSearchHuman(command, results)) {
+    io.stdout.push(line);
+  }
+  if (options.verbose) {
+    io.stdout.push(`capturadoEm: ${module.capturadoEm}`);
+  }
+  return EXIT.OK;
+}
+function runReferenceSearch(command, query, options, io = { stdout: [], stderr: [] }) {
+  if (!isReferenceSearchCommand(command)) {
+    io.stderr.push(`Unknown reference search command: ${command}`);
+    return EXIT.USAGE;
+  }
+  if (!query?.trim()) {
+    io.stderr.push(`Missing query. Usage: br-validators ${command} search <query>`);
+    return EXIT.USAGE;
+  }
+  return runReferenceSearchCommand(command, query.trim(), options, io);
+}
+
+// src/commands/ibge/lookup.ts
+import {
+  getMunicipioPorCodigo,
+  IBGE_DATA_VERSION
+} from "@br-validators/core/ibge";
+function normalizeIbgeMunicipioCode(raw) {
+  const digits = raw.replace(/\D/g, "");
+  if (digits.length !== 7) {
+    return null;
+  }
+  return Number(digits);
+}
+function formatMunicipioHuman(municipio) {
+  return `${municipio.codigo} \u2014 ${municipio.nome} (${municipio.uf})`;
+}
+function runIbgeLookupCommand(input, options, io = { stdout: [], stderr: [] }) {
+  const codigo = normalizeIbgeMunicipioCode(input);
+  if (codigo === null) {
+    io.stderr.push("Invalid IBGE municipality code. Use 7 digits (e.g. 3550308).");
+    return EXIT.USAGE;
+  }
+  const municipio = getMunicipioPorCodigo(codigo);
+  if (!municipio) {
+    io.stderr.push(`Municipality not found: ${input}`);
+    return EXIT.INVALID;
+  }
+  if (options.json) {
+    const payload = {
+      ok: true,
+      municipio
+    };
+    if (options.verbose) {
+      payload.capturadoEm = IBGE_DATA_VERSION.capturadoEm;
+    }
+    io.stdout.push(JSON.stringify(payload, null, 2));
+    return EXIT.OK;
+  }
+  io.stdout.push(formatMunicipioHuman(municipio));
+  if (options.verbose) {
+    io.stdout.push(`capturadoEm: ${IBGE_DATA_VERSION.capturadoEm}`);
+  }
+  return EXIT.OK;
+}
+function runIbgeLookup(value, options, io = { stdout: [], stderr: [] }) {
+  if (!value?.trim()) {
+    io.stderr.push("Missing IBGE municipality code. Pass a 7-digit code.");
+    return EXIT.USAGE;
+  }
+  return runIbgeLookupCommand(value.trim(), options, io);
+}
+
+// src/commands/ibge/list.ts
+import {
+  getEstados,
+  getMunicipios,
+  IBGE_DATA_VERSION as IBGE_DATA_VERSION2
+} from "@br-validators/core/ibge";
+function sliceRows(rows, limit) {
+  if (limit === void 0 || !Number.isFinite(limit) || limit <= 0) {
+    return rows;
+  }
+  return rows.slice(0, limit);
+}
+function formatEstadoHuman(estado) {
+  return `${estado.codigo} \u2014 ${estado.sigla} \u2014 ${estado.nome}`;
+}
+function runIbgeListEstadosCommand(options, io = { stdout: [], stderr: [] }) {
+  const estados = sliceRows(getEstados(), options.limit);
+  if (options.json) {
+    const payload = {
+      ok: true,
+      total: estados.length,
+      estados
+    };
+    if (options.verbose) {
+      payload.capturadoEm = IBGE_DATA_VERSION2.capturadoEm;
+    }
+    io.stdout.push(JSON.stringify(payload, null, 2));
+    return EXIT.OK;
+  }
+  for (const estado of estados) {
+    io.stdout.push(formatEstadoHuman(estado));
+  }
+  if (options.verbose) {
+    io.stdout.push(`capturadoEm: ${IBGE_DATA_VERSION2.capturadoEm}`);
+  }
+  return EXIT.OK;
+}
+function runIbgeListMunicipiosCommand(options, io = { stdout: [], stderr: [] }) {
+  const uf = options.uf?.trim().toUpperCase();
+  const municipios = sliceRows(getMunicipios(uf ? { uf } : void 0), options.limit);
+  if (options.json) {
+    const payload = {
+      ok: true,
+      total: municipios.length,
+      municipios,
+      ...uf ? { uf } : {}
+    };
+    if (options.verbose) {
+      payload.capturadoEm = IBGE_DATA_VERSION2.capturadoEm;
+    }
+    io.stdout.push(JSON.stringify(payload, null, 2));
+    return EXIT.OK;
+  }
+  for (const municipio of municipios) {
+    io.stdout.push(formatMunicipioHuman(municipio));
+  }
+  if (options.verbose) {
+    io.stdout.push(`capturadoEm: ${IBGE_DATA_VERSION2.capturadoEm}`);
+  }
+  return EXIT.OK;
+}
+function runIbgeList(target, options, io = { stdout: [], stderr: [] }) {
+  if (target === "estados") {
+    return runIbgeListEstadosCommand(options, io);
+  }
+  return runIbgeListMunicipiosCommand(options, io);
+}
+
+// src/commands/feriados/list.ts
+import {
+  FERIADOS_DATA_VERSION,
+  getFeriadosNacionais
+} from "@br-validators/core/feriados";
+function resolveYear(year) {
+  if (year !== void 0 && Number.isInteger(year) && year >= 1900 && year <= 2100) {
+    return year;
+  }
+  return (/* @__PURE__ */ new Date()).getUTCFullYear();
+}
+function formatFeriadoHuman(feriado) {
+  return `${feriado.data} \u2014 ${feriado.nome} (${feriado.tipo})`;
+}
+function runFeriadosListCommand(options, io = { stdout: [], stderr: [] }) {
+  const year = resolveYear(options.year);
+  const feriados = getFeriadosNacionais(year);
+  if (options.json) {
+    const payload = {
+      ok: true,
+      year,
+      total: feriados.length,
+      feriados
+    };
+    if (options.verbose) {
+      payload.capturadoEm = FERIADOS_DATA_VERSION.capturadoEm;
+    }
+    io.stdout.push(JSON.stringify(payload, null, 2));
+    return EXIT.OK;
+  }
+  for (const feriado of feriados) {
+    io.stdout.push(formatFeriadoHuman(feriado));
+  }
+  if (options.verbose) {
+    io.stdout.push(`capturadoEm: ${FERIADOS_DATA_VERSION.capturadoEm}`);
+  }
+  return EXIT.OK;
+}
+function runFeriadosList(options, io = { stdout: [], stderr: [] }) {
+  return runFeriadosListCommand(options, io);
+}
+
+// src/commands/tse-municipios/lookup.ts
+import {
+  getCodigosTsePorMunicipio,
+  getMunicipioIbgePorCodigoTse,
+  TSE_MUNICIPIOS_DATA_VERSION
+} from "@br-validators/core/tse-municipios";
+import { getMunicipioPorCodigo as getMunicipioPorCodigo2 } from "@br-validators/core/ibge";
+function normalizeTseInput(raw) {
+  const digits = raw.replace(/\D/g, "");
+  if (digits.length === 5) {
+    return { kind: "tse", value: digits.padStart(5, "0") };
+  }
+  if (digits.length === 7) {
+    return { kind: "ibge", value: Number(digits) };
+  }
+  return null;
+}
+function lookupTseMunicipio(raw) {
+  const normalized = normalizeTseInput(raw);
+  if (!normalized) {
+    return void 0;
+  }
+  if (normalized.kind === "tse") {
+    const ibgeCodigo = getMunicipioIbgePorCodigoTse(normalized.value);
+    if (ibgeCodigo === void 0) {
+      return void 0;
+    }
+    return { kind: "tse-to-ibge", codigoTse: normalized.value, ibgeCodigo };
+  }
+  const codigosTse = getCodigosTsePorMunicipio(normalized.value);
+  if (codigosTse.length === 0) {
+    return void 0;
+  }
+  return { kind: "ibge-to-tse", ibgeCodigo: normalized.value, codigosTse };
+}
+function formatTseLookupHuman(result) {
+  if (result.kind === "tse-to-ibge") {
+    const municipio2 = getMunicipioPorCodigo2(result.ibgeCodigo);
+    const name2 = municipio2 ? `${municipio2.nome} (${municipio2.uf})` : String(result.ibgeCodigo);
+    return `TSE ${result.codigoTse} \u2192 IBGE ${result.ibgeCodigo} \u2014 ${name2}`;
+  }
+  const municipio = getMunicipioPorCodigo2(result.ibgeCodigo);
+  const name = municipio ? `${municipio.nome} (${municipio.uf})` : String(result.ibgeCodigo);
+  return `IBGE ${result.ibgeCodigo} \u2014 ${name} \u2192 TSE ${result.codigosTse.join(", ")}`;
+}
+function runTseMunicipiosLookupCommand(input, options, io = { stdout: [], stderr: [] }) {
+  const normalized = normalizeTseInput(input);
+  if (!normalized) {
+    io.stderr.push("Invalid code. Use 5-digit TSE or 7-digit IBGE municipality code.");
+    return EXIT.USAGE;
+  }
+  const result = lookupTseMunicipio(input);
+  if (!result) {
+    io.stderr.push(`Mapping not found: ${input}`);
+    return EXIT.INVALID;
+  }
+  if (options.json) {
+    const payload = {
+      ok: true,
+      mapping: result
+    };
+    if (options.verbose) {
+      payload.capturadoEm = TSE_MUNICIPIOS_DATA_VERSION.capturadoEm;
+    }
+    io.stdout.push(JSON.stringify(payload, null, 2));
+    return EXIT.OK;
+  }
+  io.stdout.push(formatTseLookupHuman(result));
+  if (options.verbose) {
+    io.stdout.push(`capturadoEm: ${TSE_MUNICIPIOS_DATA_VERSION.capturadoEm}`);
+  }
+  return EXIT.OK;
+}
+function runTseMunicipiosLookup(value, options, io = { stdout: [], stderr: [] }) {
+  if (!value?.trim()) {
+    io.stderr.push("Missing code. Pass a 5-digit TSE or 7-digit IBGE municipality code.");
+    return EXIT.USAGE;
+  }
+  return runTseMunicipiosLookupCommand(value.trim(), options, io);
+}
+
+// src/commands/cep/faixa.ts
+import {
+  CEP_FAIXA_DATA_VERSION,
+  getCepFaixaInfo
+} from "@br-validators/core/cep";
+function normalizePrefix(raw) {
+  const digits = raw.replace(/\D/g, "");
+  if (digits.length < 5) {
+    return null;
+  }
+  return digits.slice(0, 5);
+}
+function formatCepFaixaHuman(faixa) {
+  return `${faixa.prefixo} \u2014 ${faixa.cidade} (${faixa.uf}) \xB7 IBGE ${faixa.codigoIbge}`;
+}
+function runCepFaixaCommand(input, options, io = { stdout: [], stderr: [] }) {
+  const prefix = normalizePrefix(input);
+  if (prefix === null) {
+    io.stderr.push("Invalid CEP prefix. Use at least 5 digits (e.g. 01310).");
+    return EXIT.USAGE;
+  }
+  const faixa = getCepFaixaInfo(prefix);
+  if (!faixa) {
+    io.stderr.push(`CEP prefix not found: ${input}`);
+    return EXIT.INVALID;
+  }
+  if (options.json) {
+    const payload = {
+      ok: true,
+      faixa
+    };
+    if (options.verbose) {
+      payload.capturadoEm = CEP_FAIXA_DATA_VERSION.capturadoEm;
+    }
+    io.stdout.push(JSON.stringify(payload, null, 2));
+    return EXIT.OK;
+  }
+  io.stdout.push(formatCepFaixaHuman(faixa));
+  if (options.verbose) {
+    io.stdout.push(`capturadoEm: ${CEP_FAIXA_DATA_VERSION.capturadoEm}`);
+  }
+  return EXIT.OK;
+}
+function runCepFaixa(value, options, io = { stdout: [], stderr: [] }) {
+  if (!value?.trim()) {
+    io.stderr.push("Missing CEP prefix. Pass at least 5 digits.");
+    return EXIT.USAGE;
+  }
+  return runCepFaixaCommand(value.trim(), options, io);
+}
+
+// src/commands/ddd/lookup.ts
+import {
+  getDddInfo,
+  TELEFONE_DDD_DATA_VERSION
+} from "@br-validators/core/telefone";
+function normalizeDdd(raw) {
+  const digits = raw.replace(/\D/g, "");
+  if (digits.length === 0) {
+    return null;
+  }
+  return digits.padStart(2, "0").slice(-2);
+}
+function formatDddHuman(info) {
+  const municipios = info.municipios.slice(0, 3).join(", ");
+  const suffix = info.municipios.length > 3 ? "\u2026" : "";
+  return `DDD ${info.ddd} \u2014 ${info.uf} / ${info.regiao} \u2014 ${municipios}${suffix}`;
+}
+function runDddLookupCommand(input, options, io = { stdout: [], stderr: [] }) {
+  const ddd = normalizeDdd(input);
+  if (ddd === null) {
+    io.stderr.push("Invalid DDD. Use 2 digits (e.g. 11).");
+    return EXIT.USAGE;
+  }
+  const info = getDddInfo(ddd);
+  if (!info) {
+    io.stderr.push(`DDD not found: ${input}`);
+    return EXIT.INVALID;
+  }
+  if (options.json) {
+    const payload = {
+      ok: true,
+      ddd: info
+    };
+    if (options.verbose) {
+      payload.capturadoEm = TELEFONE_DDD_DATA_VERSION.capturadoEm;
+    }
+    io.stdout.push(JSON.stringify(payload, null, 2));
+    return EXIT.OK;
+  }
+  io.stdout.push(formatDddHuman(info));
+  if (options.verbose) {
+    io.stdout.push(`capturadoEm: ${TELEFONE_DDD_DATA_VERSION.capturadoEm}`);
+  }
+  return EXIT.OK;
+}
+function runDddLookup(value, options, io = { stdout: [], stderr: [] }) {
+  if (!value?.trim()) {
+    io.stderr.push("Missing DDD code. Pass 2 digits (e.g. 11).");
+    return EXIT.USAGE;
+  }
+  return runDddLookupCommand(value.trim(), options, io);
+}
+
 // src/commands/brcode.ts
 import {
   BRCODE_OFFICIAL_SOURCE_URL,
@@ -173,6 +927,45 @@ function printNfeChaveValidation(result, options, io = { stdout: [], stderr: []
   io.stderr.push(`message: ${result.message}`);
   return EXIT.INVALID;
 }
+function printProcessoJudicialValidation(result, options, io = { stdout: [], stderr: [] }) {
+  if (options.json) {
+    io.stdout.push(
+      JSON.stringify(
+        result.ok ? {
+          ok: true,
+          value: result.value,
+          format: result.format,
+          segments: result.segments,
+          ...options.source ? { source: options.source } : {}
+        } : { ok: false, code: result.code, message: result.message },
+        null,
+        2
+      )
+    );
+    return result.ok ? EXIT.OK : EXIT.INVALID;
+  }
+  if (options.quiet) {
+    return result.ok ? EXIT.OK : EXIT.INVALID;
+  }
+  if (result.ok) {
+    io.stdout.push(`valid: yes (${result.format})`);
+    io.stdout.push(`value: ${result.value}`);
+    io.stdout.push(`sequencial: ${result.segments.sequencial}`);
+    io.stdout.push(`checkDigits: ${result.segments.checkDigits}`);
+    io.stdout.push(`ano: ${result.segments.ano}`);
+    io.stdout.push(`segmentoJustica: ${result.segments.segmentoJustica}`);
+    io.stdout.push(`tribunal: ${result.segments.tribunal}`);
+    io.stdout.push(`origem: ${result.segments.origem}`);
+    if (options.source) {
+      io.stdout.push(`source: ${options.source}`);
+    }
+    return EXIT.OK;
+  }
+  io.stderr.push("valid: no");
+  io.stderr.push(`code: ${result.code}`);
+  io.stderr.push(`message: ${result.message}`);
+  return EXIT.INVALID;
+}
 function printFormat(result, options, io = { stdout: [], stderr: [] }) {
   if (options.json) {
     io.stdout.push(JSON.stringify(result, null, 2));
@@ -343,6 +1136,146 @@ function runCnh(action, value, options, io = { stdout: [], stderr: [] }) {
   return runCnhCommand(action, input, options, io);
 }
 
+// src/commands/processo-judicial.ts
+import {
+  PROCESSO_JUDICIAL_OFFICIAL_SOURCE_URL,
+  formatProcessoJudicial,
+  stripProcessoJudicial,
+  validateProcessoJudicial
+} from "@br-validators/core/processo-judicial";
+function resolveInput5(value, fileContent) {
+  const input = value ?? fileContent?.trim();
+  if (!input) {
+    return null;
+  }
+  return input;
+}
+function runProcessoJudicialCommand(action, input, options, io = { stdout: [], stderr: [] }) {
+  const source = options.source ? PROCESSO_JUDICIAL_OFFICIAL_SOURCE_URL : void 0;
+  switch (action) {
+    case "validate":
+      return printValidation(validateProcessoJudicial(input), { json: options.json, quiet: options.quiet, source }, io);
+    case "parse":
+      return printProcessoJudicialValidation(validateProcessoJudicial(input), { json: options.json, quiet: options.quiet, source }, io);
+    case "format":
+      return printFormat(formatProcessoJudicial(input), { json: options.json, quiet: options.quiet }, io);
+    case "strip":
+      return printStrip(stripProcessoJudicial(input), { json: options.json }, io);
+    default: {
+      const _exhaustive = action;
+      io.stderr.push(`Unknown action: ${_exhaustive}`);
+      return EXIT.USAGE;
+    }
+  }
+}
+function runProcessoJudicial(action, value, options, io = { stdout: [], stderr: [] }) {
+  const input = resolveInput5(value, options.file);
+  if (input === null) {
+    io.stderr.push("Missing processo judicial value. Pass an argument or use --file.");
+    return EXIT.USAGE;
+  }
+  return runProcessoJudicialCommand(action, input, options, io);
+}
+
+// src/commands/rg.ts
+import {
+  RG_SUPPORTED_UFS,
+  formatRg,
+  getRgOfficialSourceUrl,
+  stripRg,
+  validateRg
+} from "@br-validators/core/rg";
+function resolveInput6(value, fileContent) {
+  const input = value ?? fileContent?.trim();
+  if (!input) {
+    return null;
+  }
+  return input;
+}
+function resolveRgUf(uf) {
+  if (uf === void 0) {
+    return null;
+  }
+  const normalized = uf.toUpperCase();
+  if (RG_SUPPORTED_UFS.includes(normalized)) {
+    return normalized;
+  }
+  return null;
+}
+function printRgValidation(result, options, io = { stdout: [], stderr: [] }) {
+  if (options.json) {
+    io.stdout.push(
+      JSON.stringify(
+        result.ok ? {
+          ok: true,
+          value: result.value,
+          uf: result.uf,
+          format: result.format,
+          checkDigitValidated: result.checkDigitValidated,
+          ...options.source ? { source: options.source } : {}
+        } : {
+          ok: false,
+          code: result.code,
+          message: result.message,
+          ...result.uf ? { uf: result.uf } : {}
+        },
+        null,
+        2
+      )
+    );
+    return result.ok ? EXIT.OK : EXIT.INVALID;
+  }
+  if (options.quiet) {
+    return result.ok ? EXIT.OK : EXIT.INVALID;
+  }
+  if (result.ok) {
+    io.stdout.push(`valid: yes (${result.uf})`);
+    io.stdout.push(`checkDigitValidated: ${result.checkDigitValidated ? "yes" : "no"}`);
+    io.stdout.push(`value: ${result.value}`);
+    io.stdout.push(`format: ${result.format}`);
+    if (options.source) {
+      io.stdout.push(`source: ${options.source}`);
+    }
+    return EXIT.OK;
+  }
+  io.stderr.push("valid: no");
+  io.stderr.push(`code: ${result.code}`);
+  io.stderr.push(`message: ${result.message}`);
+  if (result.uf) {
+    io.stderr.push(`uf: ${result.uf}`);
+  }
+  return EXIT.INVALID;
+}
+function runRgCommand(action, input, options, io = { stdout: [], stderr: [] }) {
+  const uf = resolveRgUf(options.uf);
+  if (!uf) {
+    io.stderr.push(`Missing or invalid --uf. Use one of: ${RG_SUPPORTED_UFS.join(", ")}.`);
+    return EXIT.USAGE;
+  }
+  const source = options.source ? getRgOfficialSourceUrl(uf) : void 0;
+  switch (action) {
+    case "validate":
+      return printRgValidation(validateRg(input, { uf }), { json: options.json, quiet: options.quiet, source }, io);
+    case "format":
+      return printFormat(formatRg(input, { uf }), { json: options.json, quiet: options.quiet }, io);
+    case "strip":
+      return printStrip(stripRg(input, { uf }), { json: options.json }, io);
+    default: {
+      const _exhaustive = action;
+      io.stderr.push(`Unknown action: ${_exhaustive}`);
+      return EXIT.USAGE;
+    }
+  }
+}
+function runRg(action, value, options, io = { stdout: [], stderr: [] }) {
+  const input = resolveInput6(value, options.file);
+  if (input === null) {
+    io.stderr.push("Missing RG value. Pass an argument or use --file.");
+    return EXIT.USAGE;
+  }
+  return runRgCommand(action, input, options, io);
+}
+
 // src/commands/renavam.ts
 import {
   RENAVAM_OFFICIAL_SOURCE_URL,
@@ -350,7 +1283,7 @@ import {
   stripRenavam,
   validateRenavam
 } from "@br-validators/core";
-function resolveInput5(value, fileContent) {
+function resolveInput7(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -374,7 +1307,7 @@ function runRenavamCommand(action, input, options, io = { stdout: [], stderr: []
   }
 }
 function runRenavam(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput5(value, options.file);
+  const input = resolveInput7(value, options.file);
   if (input === null) {
     io.stderr.push("Missing RENAVAM value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -389,7 +1322,7 @@ import {
   stripTituloEleitor,
   validateTituloEleitor
 } from "@br-validators/core";
-function resolveInput6(value, fileContent) {
+function resolveInput8(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -413,7 +1346,7 @@ function runTituloEleitorCommand(action, input, options, io = { stdout: [], stde
   }
 }
 function runTituloEleitor(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput6(value, options.file);
+  const input = resolveInput8(value, options.file);
   if (input === null) {
     io.stderr.push("Missing T\xEDtulo de Eleitor value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -429,7 +1362,7 @@ import {
   stripNfeChave,
   validateNfeChave
 } from "@br-validators/core";
-function resolveInput7(value, fileContent) {
+function resolveInput9(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -455,7 +1388,7 @@ function runNfeChaveCommand(action, input, options, io = { stdout: [], stderr: [
   }
 }
 function runNfeChave(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput7(value, options.file);
+  const input = resolveInput9(value, options.file);
   if (input === null) {
     io.stderr.push("Missing NF-e chave de acesso value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -470,7 +1403,7 @@ import {
   stripCnpj,
   validateCnpj
 } from "@br-validators/core";
-function resolveInput8(value, fileContent) {
+function resolveInput10(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -494,7 +1427,7 @@ function runCnpjCommand(action, input, options, io = { stdout: [], stderr: [] })
   }
 }
 function runCnpj(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput8(value, options.file);
+  const input = resolveInput10(value, options.file);
   if (input === null) {
     io.stderr.push("Missing CNPJ value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -509,7 +1442,7 @@ import {
   stripCpf,
   validateCpf
 } from "@br-validators/core";
-function resolveInput9(value, fileContent) {
+function resolveInput11(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -533,7 +1466,7 @@ function runCpfCommand(action, input, options, io = { stdout: [], stderr: [] })
   }
 }
 function runCpf(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput9(value, options.file);
+  const input = resolveInput11(value, options.file);
   if (input === null) {
     io.stderr.push("Missing CPF value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -549,7 +1482,7 @@ import {
   stripPlaca,
   validatePlaca
 } from "@br-validators/core";
-function resolveInput10(value, fileContent) {
+function resolveInput12(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -575,7 +1508,7 @@ function runPlacaCommand(action, input, options, io = { stdout: [], stderr: [] }
   }
 }
 function runPlaca(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput10(value, options.file);
+  const input = resolveInput12(value, options.file);
   if (input === null) {
     io.stderr.push("Missing placa value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -590,7 +1523,7 @@ import {
   stripPisPasep,
   validatePisPasep
 } from "@br-validators/core";
-function resolveInput11(value, fileContent) {
+function resolveInput13(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -614,7 +1547,7 @@ function runPisPasepCommand(action, input, options, io = { stdout: [], stderr: [
   }
 }
 function runPisPasep(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput11(value, options.file);
+  const input = resolveInput13(value, options.file);
   if (input === null) {
     io.stderr.push("Missing PIS/PASEP value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -629,7 +1562,7 @@ import {
   formatPixKey,
   validatePixKey
 } from "@br-validators/core";
-function resolveInput12(value, fileContent) {
+function resolveInput14(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -704,7 +1637,7 @@ function runPixCommand(action, input, options, io = { stdout: [], stderr: [] })
   }
 }
 function runPix(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput12(value, options.file);
+  const input = resolveInput14(value, options.file);
   if (input === null) {
     io.stderr.push("Missing PIX key value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -723,7 +1656,7 @@ import {
   stripLinhaDigitavel,
   validateBoleto
 } from "@br-validators/core";
-function resolveInput13(value, fileContent) {
+function resolveInput15(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -858,7 +1791,7 @@ function runBoletoCommand(action, input, options, direction, io = { stdout: [],
   }
 }
 function runBoleto(action, value, options, direction, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput13(value, options.file);
+  const input = resolveInput15(value, options.file);
   if (input === null) {
     io.stderr.push("Missing boleto value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -874,7 +1807,7 @@ import {
   stripCartaoCredito,
   validateCartaoCredito
 } from "@br-validators/core";
-function resolveInput14(value, fileContent) {
+function resolveInput16(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -950,7 +1883,7 @@ function runCartaoCommand(action, input, options, io = { stdout: [], stderr: []
   }
 }
 function runCartao(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput14(value, options.file);
+  const input = resolveInput16(value, options.file);
   if (input === null) {
     io.stderr.push("Missing credit card PAN value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -971,7 +1904,7 @@ import {
   validateIeProdutorRural,
   validateInscricaoEstadual
 } from "@br-validators/core";
-function resolveInput15(value, fileContent) {
+function resolveInput17(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -1068,7 +2001,7 @@ function runIeCommand(action, input, options, io = { stdout: [], stderr: [] }) {
   }
 }
 function runIe(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput15(value, options.file);
+  const input = resolveInput17(value, options.file);
   if (input === null) {
     io.stderr.push("Missing IE value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -1078,7 +2011,7 @@ function runIe(action, value, options, io = { stdout: [], stderr: [] }) {
 
 // src/commands/detect.ts
 import { detect } from "@br-validators/core";
-function resolveInput16(value, fileContent) {
+function resolveInput18(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -1112,7 +2045,7 @@ function printDetect(result, options, io = { stdout: [], stderr: [] }) {
   return EXIT.INVALID;
 }
 function runDetect(value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput16(value, options.file);
+  const input = resolveInput18(value, options.file);
   if (input === null) {
     io.stderr.push("Missing value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -1143,7 +2076,7 @@ var SANITIZABLE_TYPES = [
 function isSanitizableType(type) {
   return SANITIZABLE_TYPES.includes(type);
 }
-function resolveInput17(value, fileContent) {
+function resolveInput19(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -1174,7 +2107,7 @@ function runSanitize(type, value, options, io = { stdout: [], stderr: [] }) {
     io.stderr.push(`Unsupported sanitize type: ${type}`);
     return EXIT.USAGE;
   }
-  const input = resolveInput17(value, options.file);
+  const input = resolveInput19(value, options.file);
   if (input === null) {
     io.stderr.push("Missing value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -1544,6 +2477,27 @@ function handleTituloEleitorCli(action, value, opts, io = { stdout: [], stderr:
     io
   );
 }
+function handleProcessoJudicialCli(action, value, opts, io = { stdout: [], stderr: [] }) {
+  let fileContent;
+  if (opts.file) {
+    const content = readInputFile(opts.file, io);
+    if (content === null) {
+      return EXIT.USAGE;
+    }
+    fileContent = content;
+  }
+  return runProcessoJudicial(
+    action,
+    value,
+    {
+      json: Boolean(opts.json),
+      quiet: Boolean(opts.quiet),
+      source: Boolean(opts.source),
+      file: fileContent
+    },
+    io
+  );
+}
 function handleNfeChaveCli(action, value, opts, io = { stdout: [], stderr: [] }) {
   let fileContent;
   if (opts.file) {
@@ -1608,6 +2562,28 @@ function handleIeCli(action, value, opts, io = { stdout: [], stderr: [] }) {
     io
   );
 }
+function handleRgCli(action, value, opts, io = { stdout: [], stderr: [] }) {
+  let fileContent;
+  if (opts.file) {
+    const content = readInputFile(opts.file, io);
+    if (content === null) {
+      return EXIT.USAGE;
+    }
+    fileContent = content;
+  }
+  return runRg(
+    action,
+    value,
+    {
+      json: Boolean(opts.json),
+      quiet: Boolean(opts.quiet),
+      source: Boolean(opts.source),
+      uf: opts.uf,
+      file: fileContent
+    },
+    io
+  );
+}
 function handleDetectCli(value, opts, io = { stdout: [], stderr: [] }) {
   let fileContent;
   if (opts.file) {
@@ -1664,10 +2640,81 @@ function handleGenerateCli(type, opts, io = { stdout: [], stderr: [] }) {
     io
   );
 }
+function handleBancosLookupCli(value, opts, io = { stdout: [], stderr: [] }) {
+  return runBancosLookup(
+    value,
+    {
+      json: Boolean(opts.json),
+      verbose: Boolean(opts.verbose)
+    },
+    io
+  );
+}
+function handleBancosListCli(opts, io = { stdout: [], stderr: [] }) {
+  return runBancosList(
+    {
+      json: Boolean(opts.json),
+      verbose: Boolean(opts.verbose),
+      limit: opts.limit
+    },
+    io
+  );
+}
+function handleReferenceLookupCli(command, value, opts, io = { stdout: [], stderr: [] }) {
+  return runReferenceLookup(
+    command,
+    value,
+    {
+      json: Boolean(opts.json),
+      verbose: Boolean(opts.verbose)
+    },
+    io
+  );
+}
+function handleReferenceSearchCli(command, query, opts, io = { stdout: [], stderr: [] }) {
+  return runReferenceSearch(
+    command,
+    query,
+    {
+      json: Boolean(opts.json),
+      verbose: Boolean(opts.verbose),
+      limit: opts.limit
+    },
+    io
+  );
+}
+function handleIbgeLookupCli(value, opts, io = { stdout: [], stderr: [] }) {
+  return runIbgeLookup(value, { json: Boolean(opts.json), verbose: Boolean(opts.verbose) }, io);
+}
+function handleIbgeListCli(target, opts, io = { stdout: [], stderr: [] }) {
+  return runIbgeList(target, {
+    json: Boolean(opts.json),
+    verbose: Boolean(opts.verbose),
+    uf: opts.uf,
+    limit: opts.limit
+  }, io);
+}
+function handleFeriadosListCli(opts, io = { stdout: [], stderr: [] }) {
+  return runFeriadosList({
+    json: Boolean(opts.json),
+    verbose: Boolean(opts.verbose),
+    year: opts.year
+  }, io);
+}
+function handleTseMunicipiosLookupCli(value, opts, io = { stdout: [], stderr: [] }) {
+  return runTseMunicipiosLookup(value, { json: Boolean(opts.json), verbose: Boolean(opts.verbose) }, io);
+}
+function handleCepFaixaCli(value, opts, io = { stdout: [], stderr: [] }) {
+  return runCepFaixa(value, { json: Boolean(opts.json), verbose: Boolean(opts.verbose) }, io);
+}
+function handleDddLookupCli(value, opts, io = { stdout: [], stderr: [] }) {
+  return runDddLookup(value, { json: Boolean(opts.json), verbose: Boolean(opts.verbose) }, io);
+}
 
 // src/argv-dispatch.ts
 var STANDARD_ACTIONS = ["validate", "format", "strip"];
 var NFE_ACTIONS = ["validate", "parse", "format", "strip"];
+var PROCESSO_JUDICIAL_ACTIONS = ["validate", "parse", "format", "strip"];
 var BRCODE_ACTIONS = ["parse", "validate"];
 var PLACA_ACTIONS = ["validate", "format", "strip", "convert"];
 var PIX_ACTIONS = ["detect", "validate", "format"];
@@ -1727,6 +2774,20 @@ function parseArgv(tokens) {
       index += 1;
       continue;
     }
+    if (token === "--verbose") {
+      opts.verbose = true;
+      continue;
+    }
+    if (token === "--limit") {
+      opts.limit = Number(tokens[index + 1]);
+      index += 1;
+      continue;
+    }
+    if (token === "--year") {
+      opts.year = Number(tokens[index + 1]);
+      index += 1;
+      continue;
+    }
     if (token.startsWith("-")) {
       continue;
     }
@@ -1749,7 +2810,7 @@ function dispatchArgv(tokens, io) {
   if (tokens.length === 0 || tokens.includes("--help") || tokens.includes("-h")) {
     io.stdout.push("br-validators \u2014 100% open-source Brazilian document validators");
     io.stdout.push("Usage: br-validators <command> ...");
-    io.stdout.push("Commands: list \xB7 cpf \xB7 cnpj \xB7 cep \xB7 telefone \xB7 cnh \xB7 renavam \xB7 titulo-eleitor \xB7 nfe-chave \xB7 brcode \xB7 placa \xB7 pis-pasep \xB7 pix \xB7 boleto \xB7 cartao \xB7 cartao-credito \xB7 ie \xB7 detect \xB7 sanitize \xB7 generate");
+    io.stdout.push("Commands: list \xB7 cpf \xB7 cnpj \xB7 cep \xB7 telefone \xB7 cnh \xB7 renavam \xB7 titulo-eleitor \xB7 processo-judicial \xB7 rg \xB7 nfe-chave \xB7 brcode \xB7 placa \xB7 pis-pasep \xB7 pix \xB7 boleto \xB7 cartao \xB7 cartao-credito \xB7 ie \xB7 bancos \xB7 ibge \xB7 feriados \xB7 tse-municipios \xB7 ddd \xB7 natureza-juridica \xB7 nbs \xB7 cest \xB7 cnae \xB7 cfop \xB7 ncm \xB7 cbo \xB7 moedas \xB7 paises-bacen \xB7 incoterms \xB7 portos \xB7 aeroportos \xB7 detect \xB7 sanitize \xB7 generate");
     return EXIT.OK;
   }
   if (tokens.includes("--version") || tokens.includes("-V")) {
@@ -1768,8 +2829,18 @@ function dispatchArgv(tokens, io) {
       return dispatchStandard(rest, opts, io, handleCnpjCli);
     case "cpf":
       return dispatchStandard(rest, opts, io, handleCpfCli);
-    case "cep":
-      return dispatchStandard(rest, opts, io, handleCepCli);
+    case "cep": {
+      const action = rest[0];
+      if (action === "faixa") {
+        const value2 = rest.slice(1).join(" ") || void 0;
+        return handleCepFaixaCli(value2, opts, io);
+      }
+      if (!action || !STANDARD_ACTIONS.includes(action)) {
+        return usage(io, "Expected action: validate | format | strip | faixa <prefix>");
+      }
+      const value = rest.slice(1).join(" ") || void 0;
+      return handleCepCli(action, value, opts, io);
+    }
     case "telefone":
       return dispatchStandard(rest, opts, io, handleTelefoneCli);
     case "cnh":
@@ -1778,6 +2849,19 @@ function dispatchArgv(tokens, io) {
       return dispatchStandard(rest, opts, io, handleRenavamCli);
     case "titulo-eleitor":
       return dispatchStandard(rest, opts, io, handleTituloEleitorCli);
+    case "processo-judicial": {
+      const action = rest[0];
+      if (!action || !PROCESSO_JUDICIAL_ACTIONS.includes(action)) {
+        return usage(io, "Expected action: validate | parse | format | strip");
+      }
+      const value = rest.slice(1).join(" ") || void 0;
+      return handleProcessoJudicialCli(
+        action,
+        value,
+        opts,
+        io
+      );
+    }
     case "nfe-chave": {
       const action = rest[0];
       if (!action || !NFE_ACTIONS.includes(action)) {
@@ -1851,14 +2935,87 @@ function dispatchArgv(tokens, io) {
         io,
         (action, value, ieOpts, ioArg) => handleIeCli(action, value, ieOpts, ioArg)
       );
+    case "rg":
+      return dispatchStandard(
+        rest,
+        opts,
+        io,
+        (action, value, rgOpts, ioArg) => handleRgCli(action, value, rgOpts, ioArg)
+      );
+    case "bancos": {
+      const action = rest[0];
+      if (action === "lookup") {
+        const value = rest.slice(1).join(" ") || void 0;
+        return handleBancosLookupCli(value, opts, io);
+      }
+      if (action === "list") {
+        return handleBancosListCli(opts, io);
+      }
+      return usage(io, "Expected: bancos lookup <codigo|ispb> | bancos list [--limit n]");
+    }
+    case "ibge": {
+      const action = rest[0];
+      if (action === "lookup") {
+        const value = rest.slice(1).join(" ") || void 0;
+        return handleIbgeLookupCli(value, opts, io);
+      }
+      if (action === "list") {
+        const target = rest[1];
+        if (target === "estados") {
+          return handleIbgeListCli("estados", opts, io);
+        }
+        if (target === "municipios") {
+          return handleIbgeListCli("municipios", opts, io);
+        }
+        return usage(io, "Expected: ibge list estados | ibge list municipios [--uf UF] [--limit n]");
+      }
+      return usage(io, "Expected: ibge lookup <codigo> | ibge list estados | ibge list municipios");
+    }
+    case "feriados": {
+      const action = rest[0];
+      if (action === "list") {
+        return handleFeriadosListCli(opts, io);
+      }
+      return usage(io, "Expected: feriados list [--year YYYY]");
+    }
+    case "tse-municipios": {
+      const action = rest[0];
+      if (action === "lookup") {
+        const value = rest.slice(1).join(" ") || void 0;
+        return handleTseMunicipiosLookupCli(value, opts, io);
+      }
+      return usage(io, "Expected: tse-municipios lookup <codigo-tse|codigo-ibge>");
+    }
+    case "ddd": {
+      const action = rest[0];
+      if (action === "lookup") {
+        const value = rest.slice(1).join(" ") || void 0;
+        return handleDddLookupCli(value, opts, io);
+      }
+      return usage(io, "Expected: ddd lookup <code>");
+    }
     case "detect":
       return handleDetectCli(rest.join(" ") || void 0, opts, io);
     case "sanitize":
       return handleSanitizeCli(rest[0] ?? "", rest.slice(1).join(" ") || void 0, opts, io);
     case "generate":
       return handleGenerateCli(rest[0] ?? "", opts, io);
-    default:
+    default: {
+      if (isReferenceLookupCommand(root)) {
+        const action = rest[0];
+        if (action === "lookup") {
+          const value = rest.slice(1).join(" ") || void 0;
+          return handleReferenceLookupCli(root, value, opts, io);
+        }
+        if (action === "search" && isReferenceSearchCommand(root)) {
+          const value = rest.slice(1).join(" ") || void 0;
+          return handleReferenceSearchCli(root, value, opts, io);
+        }
+        const searchHint = isReferenceSearchCommand(root) ? " | search <query>" : "";
+        return usage(io, `Expected: ${root} lookup <codigo>${searchHint}`);
+      }
       return usage(io, `Unknown command: ${root}`);
+    }
   }
 }