@br-validators/cli 1.3.0 → 1.6.0

package/dist/index.js

@@ -9,22 +9,774 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 // src/program.ts
 import { Command } from "commander";
 
-// src/commands/brcode.ts
-import {
-  BRCODE_OFFICIAL_SOURCE_URL,
-  parseBrCode,
-  validateBrCode
-} from "@br-validators/core";
+// src/commands/bancos/list.ts
+import { BANCOS_DATA_VERSION as BANCOS_DATA_VERSION2, getBancos } from "@br-validators/core/bancos";
 
 // 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/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/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/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,
+  parseBrCode,
+  validateBrCode
+} from "@br-validators/core";
 function resolveInput(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
@@ -179,6 +931,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));
@@ -204,23 +995,176 @@ function printStrip(value, options, io = { stdout: [] }) {
   return EXIT.OK;
 }
 
-// src/commands/cep.ts
-function resolveInput2(value, fileContent) {
+// src/commands/cep.ts
+function resolveInput2(value, fileContent) {
+  const input = value ?? fileContent?.trim();
+  if (!input) {
+    return null;
+  }
+  return input;
+}
+function runCepCommand(action, input, options, io = { stdout: [], stderr: [] }) {
+  const source = options.source ? CEP_OFFICIAL_SOURCE_URL : void 0;
+  switch (action) {
+    case "validate":
+      return printValidation(validateCep(input), { json: options.json, quiet: options.quiet, source }, io);
+    case "format":
+      return printFormat(formatCep(input), { json: options.json, quiet: options.quiet }, io);
+    case "strip":
+      return printStrip(stripCep(input), { json: options.json }, io);
+    default: {
+      const _exhaustive = action;
+      io.stderr.push(`Unknown action: ${_exhaustive}`);
+      return EXIT.USAGE;
+    }
+  }
+}
+function runCep(action, value, options, io = { stdout: [], stderr: [] }) {
+  const input = resolveInput2(value, options.file);
+  if (input === null) {
+    io.stderr.push("Missing CEP value. Pass an argument or use --file.");
+    return EXIT.USAGE;
+  }
+  return runCepCommand(action, input, options, io);
+}
+
+// src/commands/telefone.ts
+import {
+  TELEFONE_OFFICIAL_SOURCE_URL,
+  formatTelefone,
+  stripTelefone,
+  validateTelefone
+} from "@br-validators/core";
+function resolveInput3(value, fileContent) {
+  const input = value ?? fileContent?.trim();
+  if (!input) {
+    return null;
+  }
+  return input;
+}
+function printTelefoneValidation(result, options, io = { stdout: [], stderr: [] }) {
+  if (options.json) {
+    io.stdout.push(
+      JSON.stringify(
+        result.ok ? {
+          ok: true,
+          value: result.value,
+          tipo: result.tipo,
+          format: result.format,
+          ...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.tipo})`);
+    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}`);
+  return EXIT.INVALID;
+}
+function runTelefoneCommand(action, input, options, io = { stdout: [], stderr: [] }) {
+  const source = options.source ? TELEFONE_OFFICIAL_SOURCE_URL : void 0;
+  switch (action) {
+    case "validate":
+      return printTelefoneValidation(validateTelefone(input), { json: options.json, quiet: options.quiet, source }, io);
+    case "format":
+      return printFormat(formatTelefone(input), { json: options.json, quiet: options.quiet }, io);
+    case "strip":
+      return printStrip(stripTelefone(input), { json: options.json }, io);
+    default: {
+      const _exhaustive = action;
+      io.stderr.push(`Unknown action: ${_exhaustive}`);
+      return EXIT.USAGE;
+    }
+  }
+}
+function runTelefone(action, value, options, io = { stdout: [], stderr: [] }) {
+  const input = resolveInput3(value, options.file);
+  if (input === null) {
+    io.stderr.push("Missing telephone value. Pass an argument or use --file.");
+    return EXIT.USAGE;
+  }
+  return runTelefoneCommand(action, input, options, io);
+}
+
+// src/commands/cnh.ts
+import {
+  CNH_OFFICIAL_SOURCE_URL,
+  formatCnh,
+  stripCnh,
+  validateCnh
+} from "@br-validators/core";
+function resolveInput4(value, fileContent) {
+  const input = value ?? fileContent?.trim();
+  if (!input) {
+    return null;
+  }
+  return input;
+}
+function runCnhCommand(action, input, options, io = { stdout: [], stderr: [] }) {
+  const source = options.source ? CNH_OFFICIAL_SOURCE_URL : void 0;
+  switch (action) {
+    case "validate":
+      return printValidation(validateCnh(input), { json: options.json, quiet: options.quiet, source }, io);
+    case "format":
+      return printFormat(formatCnh(input), { json: options.json, quiet: options.quiet }, io);
+    case "strip":
+      return printStrip(stripCnh(input), { json: options.json }, io);
+    default: {
+      const _exhaustive = action;
+      io.stderr.push(`Unknown action: ${_exhaustive}`);
+      return EXIT.USAGE;
+    }
+  }
+}
+function runCnh(action, value, options, io = { stdout: [], stderr: [] }) {
+  const input = resolveInput4(value, options.file);
+  if (input === null) {
+    io.stderr.push("Missing CNH value. Pass an argument or use --file.");
+    return EXIT.USAGE;
+  }
+  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 runCepCommand(action, input, options, io = { stdout: [], stderr: [] }) {
-  const source = options.source ? CEP_OFFICIAL_SOURCE_URL : void 0;
+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(validateCep(input), { json: options.json, quiet: options.quiet, source }, io);
+      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(formatCep(input), { json: options.json, quiet: options.quiet }, io);
+      return printFormat(formatProcessoJudicial(input), { json: options.json, quiet: options.quiet }, io);
     case "strip":
-      return printStrip(stripCep(input), { json: options.json }, io);
+      return printStrip(stripProcessoJudicial(input), { json: options.json }, io);
     default: {
       const _exhaustive = action;
       io.stderr.push(`Unknown action: ${_exhaustive}`);
@@ -228,40 +1172,57 @@ function runCepCommand(action, input, options, io = { stdout: [], stderr: [] })
     }
   }
 }
-function runCep(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput2(value, options.file);
+function runProcessoJudicial(action, value, options, io = { stdout: [], stderr: [] }) {
+  const input = resolveInput5(value, options.file);
   if (input === null) {
-    io.stderr.push("Missing CEP value. Pass an argument or use --file.");
+    io.stderr.push("Missing processo judicial value. Pass an argument or use --file.");
     return EXIT.USAGE;
   }
-  return runCepCommand(action, input, options, io);
+  return runProcessoJudicialCommand(action, input, options, io);
 }
 
-// src/commands/telefone.ts
+// src/commands/rg.ts
 import {
-  TELEFONE_OFFICIAL_SOURCE_URL,
-  formatTelefone,
-  stripTelefone,
-  validateTelefone
-} from "@br-validators/core";
-function resolveInput3(value, fileContent) {
+  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 printTelefoneValidation(result, options, io = { stdout: [], stderr: [] }) {
+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,
-          tipo: result.tipo,
+          uf: result.uf,
           format: result.format,
+          checkDigitValidated: result.checkDigitValidated,
           ...options.source ? { source: options.source } : {}
-        } : { ok: false, code: result.code, message: result.message },
+        } : {
+          ok: false,
+          code: result.code,
+          message: result.message,
+          ...result.uf ? { uf: result.uf } : {}
+        },
         null,
         2
       )
@@ -272,7 +1233,8 @@ function printTelefoneValidation(result, options, io = { stdout: [], stderr: []
     return result.ok ? EXIT.OK : EXIT.INVALID;
   }
   if (result.ok) {
-    io.stdout.push(`valid: yes (${result.tipo})`);
+    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) {
@@ -283,56 +1245,25 @@ function printTelefoneValidation(result, options, io = { stdout: [], stderr: []
   io.stderr.push("valid: no");
   io.stderr.push(`code: ${result.code}`);
   io.stderr.push(`message: ${result.message}`);
-  return EXIT.INVALID;
-}
-function runTelefoneCommand(action, input, options, io = { stdout: [], stderr: [] }) {
-  const source = options.source ? TELEFONE_OFFICIAL_SOURCE_URL : void 0;
-  switch (action) {
-    case "validate":
-      return printTelefoneValidation(validateTelefone(input), { json: options.json, quiet: options.quiet, source }, io);
-    case "format":
-      return printFormat(formatTelefone(input), { json: options.json, quiet: options.quiet }, io);
-    case "strip":
-      return printStrip(stripTelefone(input), { json: options.json }, io);
-    default: {
-      const _exhaustive = action;
-      io.stderr.push(`Unknown action: ${_exhaustive}`);
-      return EXIT.USAGE;
-    }
+  if (result.uf) {
+    io.stderr.push(`uf: ${result.uf}`);
   }
+  return EXIT.INVALID;
 }
-function runTelefone(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput3(value, options.file);
-  if (input === null) {
-    io.stderr.push("Missing telephone value. Pass an argument or use --file.");
+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;
   }
-  return runTelefoneCommand(action, input, options, io);
-}
-
-// src/commands/cnh.ts
-import {
-  CNH_OFFICIAL_SOURCE_URL,
-  formatCnh,
-  stripCnh,
-  validateCnh
-} from "@br-validators/core";
-function resolveInput4(value, fileContent) {
-  const input = value ?? fileContent?.trim();
-  if (!input) {
-    return null;
-  }
-  return input;
-}
-function runCnhCommand(action, input, options, io = { stdout: [], stderr: [] }) {
-  const source = options.source ? CNH_OFFICIAL_SOURCE_URL : void 0;
+  const source = options.source ? getRgOfficialSourceUrl(uf) : void 0;
   switch (action) {
     case "validate":
-      return printValidation(validateCnh(input), { json: options.json, quiet: options.quiet, source }, io);
+      return printRgValidation(validateRg(input, { uf }), { json: options.json, quiet: options.quiet, source }, io);
     case "format":
-      return printFormat(formatCnh(input), { json: options.json, quiet: options.quiet }, io);
+      return printFormat(formatRg(input, { uf }), { json: options.json, quiet: options.quiet }, io);
     case "strip":
-      return printStrip(stripCnh(input), { json: options.json }, io);
+      return printStrip(stripRg(input, { uf }), { json: options.json }, io);
     default: {
       const _exhaustive = action;
       io.stderr.push(`Unknown action: ${_exhaustive}`);
@@ -340,13 +1271,13 @@ function runCnhCommand(action, input, options, io = { stdout: [], stderr: [] })
     }
   }
 }
-function runCnh(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput4(value, options.file);
+function runRg(action, value, options, io = { stdout: [], stderr: [] }) {
+  const input = resolveInput6(value, options.file);
   if (input === null) {
-    io.stderr.push("Missing CNH value. Pass an argument or use --file.");
+    io.stderr.push("Missing RG value. Pass an argument or use --file.");
     return EXIT.USAGE;
   }
-  return runCnhCommand(action, input, options, io);
+  return runRgCommand(action, input, options, io);
 }
 
 // src/commands/renavam.ts
@@ -356,7 +1287,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;
@@ -380,7 +1311,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;
@@ -395,7 +1326,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;
@@ -419,7 +1350,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;
@@ -435,7 +1366,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;
@@ -461,7 +1392,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;
@@ -476,7 +1407,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;
@@ -500,7 +1431,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;
@@ -515,7 +1446,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;
@@ -539,7 +1470,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;
@@ -555,7 +1486,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;
@@ -581,7 +1512,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;
@@ -596,7 +1527,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;
@@ -620,7 +1551,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;
@@ -635,7 +1566,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;
@@ -710,7 +1641,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;
@@ -729,7 +1660,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;
@@ -864,7 +1795,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;
@@ -880,7 +1811,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;
@@ -956,7 +1887,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;
@@ -977,7 +1908,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;
@@ -1074,7 +2005,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;
@@ -1084,7 +2015,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;
@@ -1118,7 +2049,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;
@@ -1149,7 +2080,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;
@@ -1180,7 +2111,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;
@@ -1550,6 +2481,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) {
@@ -1614,6 +2566,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) {
@@ -1670,11 +2644,101 @@ 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);
+}
 function writeCliIo(io) {
   for (const line of io.stdout) console.log(line);
   for (const line of io.stderr) console.error(line);
 }
 
+// src/commands/reference-lookup/register-program.ts
+function registerReferenceLookupCommands(program) {
+  for (const command of REFERENCE_LOOKUP_COMMANDS) {
+    const module = REFERENCE_LOOKUP_MODULES[command];
+    const root = program.command(command).description(module.description);
+    root.command("lookup").description(`Resolve ${command} by official code`).argument("<codigo>", "Lookup code").option("--json", "JSON output").option("--verbose", "Include dataset capture date").action((codigo, opts) => {
+      const io = { stdout: [], stderr: [] };
+      process.exitCode = handleReferenceLookupCli(command, codigo, opts, io);
+      writeCliIo(io);
+    });
+    if (REFERENCE_SEARCH_COMMANDS.includes(command)) {
+      root.command("search").description(`Search ${command} by description fragment`).argument("<query>", "Search query").option("--json", "JSON output").option("--verbose", "Include dataset capture date").option("--limit <n>", "Maximum rows", (v) => Number(v)).action((query, opts) => {
+        const io = { stdout: [], stderr: [] };
+        process.exitCode = handleReferenceSearchCli(command, query, opts, io);
+        writeCliIo(io);
+      });
+    }
+  }
+}
+
 // src/program.ts
 function createProgram() {
   const program = new Command();
@@ -1708,6 +2772,11 @@ function createProgram() {
       writeCliIo(io);
     });
   }
+  cep.command("faixa").description("Resolve CEP prefix to municipality (IBGE CNEFE)").argument("<prefixo>", "CEP prefix (5+ digits)").option("--json", "JSON output").option("--verbose", "Include dataset capture date").action((prefixo, opts) => {
+    const io = { stdout: [], stderr: [] };
+    process.exitCode = handleCepFaixaCli(prefixo, opts, io);
+    writeCliIo(io);
+  });
   const telefone = program.command("telefone").description("Telefone \u2014 Brazilian fixo/celular (Anatel DDD)");
   for (const action of ["validate", "format", "strip"]) {
     telefone.command(action).description(`${action} a Brazilian telephone number`).argument("[value]", "Telephone value (raw or masked)").option("--json", "JSON output").option("-q, --quiet", "Exit code only").option("--source", "Include official source URL (validate only)").option("-f, --file <path>", "Read value from file").action((value, opts) => {
@@ -1740,6 +2809,14 @@ function createProgram() {
       writeCliIo(io);
     });
   }
+  const processoJudicial = program.command("processo-judicial").description("Processo judicial CNJ \u2014 n\xFAmero \xFAnico NNNNNNN-DD.AAAA.J.TR.OOOO (Resolu\xE7\xE3o 65/2008)");
+  for (const action of ["validate", "parse", "format", "strip"]) {
+    processoJudicial.command(action).description(`${action} a processo judicial CNJ`).argument("[value]", "CNJ process number (masked or 20 digits)").option("--json", "JSON output").option("-q, --quiet", "Exit code only").option("--source", "Include official source URL (validate/parse only)").option("-f, --file <path>", "Read value from file").action((value, opts) => {
+      const io = { stdout: [], stderr: [] };
+      process.exitCode = handleProcessoJudicialCli(action, value, opts, io);
+      writeCliIo(io);
+    });
+  }
   const nfeChave = program.command("nfe-chave").description("NF-e / NFC-e chave de acesso \u2014 44 digits (SEFAZ MOC \xA72.2.6)");
   for (const action of ["validate", "parse", "format", "strip"]) {
     nfeChave.command(action).description(`${action} an NF-e chave de acesso`).argument("[value]", "Chave de acesso (44 digits, spaces allowed)").option("--json", "JSON output").option("-q, --quiet", "Exit code only").option("--source", "Include official source URL (validate/parse only)").option("-f, --file <path>", "Read value from file").action((value, opts) => {
@@ -1843,6 +2920,61 @@ function createProgram() {
       writeCliIo(io);
     });
   }
+  const rg = program.command("rg").description("RG (Registro Geral) \u2014 per-UF validation (phase 1: SP, RJ, MG, PR, RS, SC)");
+  for (const action of ["validate", "format", "strip"]) {
+    rg.command(action).description(`${action} an RG`).argument("[value]", "RG value (raw or masked)").requiredOption("--uf <uf>", "State code (SP, RJ, MG, PR, RS, SC)").option("--json", "JSON output").option("-q, --quiet", "Exit code only").option("--source", "Include official source URL (validate only)").option("-f, --file <path>", "Read value from file").action((value, opts) => {
+      const io = { stdout: [], stderr: [] };
+      process.exitCode = handleRgCli(action, value, opts, io);
+      writeCliIo(io);
+    });
+  }
+  const bancos = program.command("bancos").description("Bacen STR participants \u2014 offline lookup");
+  bancos.command("lookup").description("Resolve bank by COMPE (3 digits) or ISPB (8 digits)").argument("<codigoOuIspb>", "COMPE or ISPB").option("--json", "JSON output").option("--verbose", "Include dataset capture date (BANCOS_DATA_VERSION)").action((codigoOuIspb, opts) => {
+    const io = { stdout: [], stderr: [] };
+    process.exitCode = handleBancosLookupCli(codigoOuIspb, opts, io);
+    writeCliIo(io);
+  });
+  bancos.command("list").description("List STR participants (optional --limit)").option("--json", "JSON output").option("--verbose", "Include dataset capture date (BANCOS_DATA_VERSION)").option("--limit <n>", "Maximum rows to print", (v) => Number(v)).action((opts) => {
+    const io = { stdout: [], stderr: [] };
+    process.exitCode = handleBancosListCli(opts, io);
+    writeCliIo(io);
+  });
+  const ibge = program.command("ibge").description("IBGE states and municipalities \u2014 offline lookup");
+  ibge.command("lookup").description("Resolve municipality by 7-digit IBGE code").argument("<codigo>", "IBGE municipality code").option("--json", "JSON output").option("--verbose", "Include dataset capture date").action((codigo, opts) => {
+    const io = { stdout: [], stderr: [] };
+    process.exitCode = handleIbgeLookupCli(codigo, opts, io);
+    writeCliIo(io);
+  });
+  ibge.command("list").description("List estados or municipios").argument("<target>", "estados | municipios").option("--json", "JSON output").option("--verbose", "Include dataset capture date").option("--uf <uf>", "Filter municipalities by UF").option("--limit <n>", "Maximum rows", (v) => Number(v)).action((target, opts) => {
+    const io = { stdout: [], stderr: [] };
+    if (target !== "estados" && target !== "municipios") {
+      io.stderr.push("Expected target: estados | municipios");
+      process.exitCode = 2;
+      writeCliIo(io);
+      return;
+    }
+    process.exitCode = handleIbgeListCli(target, opts, io);
+    writeCliIo(io);
+  });
+  const feriados = program.command("feriados").description("Brazilian national holidays \u2014 offline calendar");
+  feriados.command("list").description("List national holidays for a year").option("--year <yyyy>", "Calendar year", (v) => Number(v)).option("--json", "JSON output").option("--verbose", "Include dataset capture date").action((opts) => {
+    const io = { stdout: [], stderr: [] };
+    process.exitCode = handleFeriadosListCli(opts, io);
+    writeCliIo(io);
+  });
+  const tseMunicipios = program.command("tse-municipios").description("TSE \u2194 IBGE municipality cross-walk \u2014 offline lookup");
+  tseMunicipios.command("lookup").description("Resolve TSE (5 digits) or IBGE (7 digits) municipality code").argument("<codigo>", "TSE or IBGE code").option("--json", "JSON output").option("--verbose", "Include dataset capture date").action((codigo, opts) => {
+    const io = { stdout: [], stderr: [] };
+    process.exitCode = handleTseMunicipiosLookupCli(codigo, opts, io);
+    writeCliIo(io);
+  });
+  const ddd = program.command("ddd").description("Anatel DDD geographic lookup \u2014 offline");
+  ddd.command("lookup").description("Resolve DDD to UF, region, and municipalities").argument("<code>", "2-digit DDD").option("--json", "JSON output").option("--verbose", "Include dataset capture date").action((code, opts) => {
+    const io = { stdout: [], stderr: [] };
+    process.exitCode = handleDddLookupCli(code, opts, io);
+    writeCliIo(io);
+  });
+  registerReferenceLookupCommands(program);
   program.command("detect").description("Detect document type from raw input").argument("[value]", "Raw value to classify").option("--uf <uf>", "State code for Inscri\xE7\xE3o Estadual detection").option("--json", "JSON output").option("-q, --quiet", "Exit code only").option("-f, --file <path>", "Read value from file").action((value, opts) => {
     const io = { stdout: [], stderr: [] };
     process.exitCode = handleDetectCli(value, opts, io);