@br-validators/cli 1.5.0 → 1.6.0

package/dist/index.js

@@ -13,7 +13,7 @@ import { Command } from "commander";
 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,
@@ -141,16 +141,31 @@ import {
   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)) {
@@ -195,6 +210,50 @@ var REFERENCE_LOOKUP_MODULES = {
       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",
@@ -256,6 +315,9 @@ var REFERENCE_LOOKUP_MODULES = {
 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: [] }) {
@@ -297,6 +359,418 @@ function runReferenceLookup(command, value, options, io = { stdout: [], stderr:
   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,
@@ -457,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));
@@ -627,6 +1140,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,
@@ -634,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;
@@ -658,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;
@@ -673,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;
@@ -697,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;
@@ -713,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;
@@ -739,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;
@@ -754,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;
@@ -778,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;
@@ -793,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;
@@ -817,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;
@@ -833,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;
@@ -859,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;
@@ -874,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;
@@ -898,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;
@@ -913,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;
@@ -988,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;
@@ -1007,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;
@@ -1142,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;
@@ -1158,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;
@@ -1234,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;
@@ -1255,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;
@@ -1352,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;
@@ -1362,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;
@@ -1396,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;
@@ -1427,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;
@@ -1458,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;
@@ -1828,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) {
@@ -1892,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) {
@@ -1979,6 +2675,45 @@ function handleReferenceLookupCli(command, value, opts, io = { stdout: [], stder
     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);
@@ -1994,6 +2729,13 @@ function registerReferenceLookupCommands(program) {
       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);
+      });
+    }
   }
 }
 
@@ -2030,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) => {
@@ -2062,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) => {
@@ -2165,6 +2920,14 @@ 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: [] };
@@ -2176,6 +2939,41 @@ function createProgram() {
     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: [] };