{"_id":"@egosbr/guard-brasil","_rev":"11-e643a67c1bea46f6477e99534c355fca","name":"@egosbr/guard-brasil","dist-tags":{"latest":"0.2.4"},"versions":{"0.1.0":{"name":"@egosbr/guard-brasil","version":"0.1.0","keywords":["lgpd","pii","brazil","ai-safety","guardrails","compliance","evidence-chain","atrian","brazilian","cpf","privacy","masking"],"author":{"name":"Enio Rocha","email":"enio@egos.ia.br"},"license":"MIT","_id":"@egosbr/guard-brasil@0.1.0","maintainers":[{"name":"enioxt","email":"enioxt@gmail.com"}],"homepage":"https://github.com/enioxt/egos/tree/main/packages/guard-brasil#readme","bugs":{"url":"https://github.com/enioxt/egos/issues"},"dist":{"shasum":"142430cf100b9ceb7ee0d892a018161e886f67cb","tarball":"https://registry.npmjs.org/@egosbr/guard-brasil/-/guard-brasil-0.1.0.tgz","fileCount":30,"integrity":"sha512-aXijrHdRbpkhBUZcPnWTxGD6+DSAQgqN5gegr5N4KfRex7kYfv4Od/3P0pzygZdb3E8ts3nZEBQXWSPdFGZT+w==","signatures":[{"sig":"MEQCIBeAzpv9gQjQsNYwJuo7Nmew3qHBCDewUFJcIFuzHA9KAiB6PxBF4jv00pxHhX8A1217q3Qm2dB1sFN8ulj5bDUOEg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":66007},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"demo":"bun run src/demo.ts","test":"bun test src/guard.test.ts","build":"tsc -p tsconfig.build.json","typecheck":"tsc --noEmit -p tsconfig.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"enioxt","email":"enioxt@gmail.com"},"deprecated":"Descontinuada — limpeza de conteúdo em andamento; não usar esta versão.","repository":{"url":"git+https://github.com/enioxt/egos.git","type":"git","directory":"packages/guard-brasil"},"_npmVersion":"10.8.2","description":"Brazilian AI safety layer — LGPD-compliant PII masking, ATRiAN ethical validation, and traceable evidence discipline for AI assistants","directories":{},"_nodeVersion":"20.20.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/guard-brasil_0.1.0_1774878327049_0.15028425009476565","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@egosbr/guard-brasil","version":"0.2.0","keywords":["lgpd","pii","brazil","ai-safety","guardrails","compliance","evidence-chain","atrian","brazilian","cpf","privacy","masking"],"author":{"name":"Enio Rocha","email":"enio@egos.ia.br"},"license":"MIT","_id":"@egosbr/guard-brasil@0.2.0","maintainers":[{"name":"enioxt","email":"enioxt@gmail.com"}],"homepage":"https://github.com/enioxt/egos/tree/main/packages/guard-brasil#readme","bugs":{"url":"https://github.com/enioxt/egos/issues"},"dist":{"shasum":"12d232f0ef6033c5839da9fb7a6a67e468433172","tarball":"https://registry.npmjs.org/@egosbr/guard-brasil/-/guard-brasil-0.2.0.tgz","fileCount":34,"integrity":"sha512-kzFyRaP588Jnp/NKgUKyfSIaEg+uZDtrqAyFTDmTS1Kidx1KSt4CkqjV6Qum2JtZybLKiyhwXQerRaC7Xl3VQQ==","signatures":[{"sig":"MEYCIQCpdsM9nnSlKigFghCnTo+0tbHbZ2nvUmXZp7AvX1YsowIhAKp8ziKco5IG2LCDO5w2KjzfgsPVR5SA0TYd1umqaKO8","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":89933},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"demo":"bun run src/demo.ts","test":"bun test src/guard.test.ts","build":"tsc -p tsconfig.build.json","typecheck":"tsc --noEmit -p tsconfig.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"enioxt","email":"enioxt@gmail.com"},"deprecated":"Descontinuada — limpeza de conteúdo em andamento; não usar esta versão.","repository":{"url":"git+https://github.com/enioxt/egos.git","type":"git","directory":"packages/guard-brasil"},"_npmVersion":"10.8.2","description":"Brazilian AI safety layer — LGPD-compliant PII masking, ATRiAN ethical validation, and traceable evidence discipline for AI assistants","directories":{},"_nodeVersion":"20.20.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/guard-brasil_0.2.0_1775005501304_0.08363560095546374","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@egosbr/guard-brasil","version":"0.2.1","keywords":["lgpd","pii","brazil","ai-safety","guardrails","compliance","evidence-chain","atrian","brazilian","cpf","privacy","masking"],"author":{"name":"Enio Rocha","email":"enio@egos.ia.br"},"license":"MIT","_id":"@egosbr/guard-brasil@0.2.1","maintainers":[{"name":"enioxt","email":"enioxt@gmail.com"}],"homepage":"https://github.com/enioxt/egos/tree/main/packages/guard-brasil#readme","bugs":{"url":"https://github.com/enioxt/egos/issues"},"dist":{"shasum":"905407a16533424cb8d60e73230b9db7ea20fd04","tarball":"https://registry.npmjs.org/@egosbr/guard-brasil/-/guard-brasil-0.2.1.tgz","fileCount":54,"integrity":"sha512-AzzZblTxWVfsGI/w3fjFwhjG9RVjowINy4O1D0oc2r1rpqDnLqmM42c8U9CIOnWKeOC3oKV6Ga5GMgOqPQMJWg==","signatures":[{"sig":"MEUCIQCktGXTj8wqxSPpEBKMbAubLu+ccyh4My9+feXGa4N6gAIgNVlFo1e3n6LHSKos7tvGd6zrasv4+C7e8rVFXyCsHZE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":143130},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"demo":"bun run src/demo.ts","test":"bun test src/guard.test.ts","build":"tsc -p tsconfig.build.json","typecheck":"tsc --noEmit -p tsconfig.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"enioxt","email":"enioxt@gmail.com"},"deprecated":"Descontinuada — limpeza de conteúdo em andamento; não usar esta versão.","repository":{"url":"git+https://github.com/enioxt/egos.git","type":"git","directory":"packages/guard-brasil"},"_npmVersion":"10.8.2","description":"Brazilian AI safety layer — LGPD-compliant PII masking, ATRiAN ethical validation, and traceable evidence discipline for AI assistants","directories":{},"_nodeVersion":"20.20.0","dependencies":{"@supabase/supabase-js":"^2.101.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/guard-brasil_0.2.1_1775219657826_0.4056005387160817","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@egosbr/guard-brasil","version":"0.2.2","keywords":["lgpd","pii","brazil","ai-safety","guardrails","compliance","evidence-chain","atrian","brazilian","cpf","privacy","masking"],"author":{"name":"Enio Rocha","email":"enio@egos.ia.br"},"license":"MIT","_id":"@egosbr/guard-brasil@0.2.2","maintainers":[{"name":"enioxt","email":"enioxt@gmail.com"}],"homepage":"https://github.com/enioxt/egos/tree/main/packages/guard-brasil#readme","bugs":{"url":"https://github.com/enioxt/egos/issues"},"dist":{"shasum":"b90e9e78fbff404c3660fadf2cb1e3722ec70d7f","tarball":"https://registry.npmjs.org/@egosbr/guard-brasil/-/guard-brasil-0.2.2.tgz","fileCount":54,"integrity":"sha512-y0h8yXLFuhtI8Mwv4/D0sIc+xd4hjXp6BNR44nJz7YoZOOdINQHWxyXlpCTERpYViGJf6I4cOye+OpWgpLK6NQ==","signatures":[{"sig":"MEQCIF9Od7lIJP2iP0xP7KRH5mClN3xDCe/WDLbEtjwfQIoZAiAVu9zFwvLSLMPcZqQLauqIrofonWUC6JTJC8d/icVRQA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":143128},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"demo":"bun run src/demo.ts","test":"bun test src/guard.test.ts","build":"tsc -p tsconfig.build.json","typecheck":"tsc --noEmit -p tsconfig.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"enioxt","email":"enioxt@gmail.com"},"deprecated":"Descontinuada — limpeza de conteúdo em andamento; não usar esta versão.","repository":{"url":"git+https://github.com/enioxt/egos.git","type":"git","directory":"packages/guard-brasil"},"_npmVersion":"10.8.2","description":"Brazilian AI safety layer — LGPD-compliant PII masking, ATRiAN ethical validation, and traceable evidence discipline for AI assistants","directories":{},"_nodeVersion":"20.20.0","dependencies":{"@supabase/supabase-js":"^2.101.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/guard-brasil_0.2.2_1775220856773_0.6204516353390428","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"name":"@egosbr/guard-brasil","version":"0.2.3","keywords":["lgpd","pii","brazil","ai-safety","guardrails","compliance","evidence-chain","atrian","brazilian","cpf","privacy","masking"],"author":{"name":"Enio Rocha","email":"enio@egos.ia.br"},"license":"MIT","_id":"@egosbr/guard-brasil@0.2.3","maintainers":[{"name":"enioxt","email":"enioxt@gmail.com"}],"homepage":"https://github.com/enioxt/egos/tree/main/packages/guard-brasil#readme","bugs":{"url":"https://github.com/enioxt/egos/issues"},"dist":{"shasum":"305847cb815affb8d8d44b84c9cd6d830b5a42ad","tarball":"https://registry.npmjs.org/@egosbr/guard-brasil/-/guard-brasil-0.2.3.tgz","fileCount":54,"integrity":"sha512-ve/mavy/nOpC821YDxDWDVP4V58xCIdf8da2gfZsVdVg4bKw05GwwROkMgJodUXbW7fma3T4JRVcgW6rxyS8Gw==","signatures":[{"sig":"MEUCIBPuOd4AwcyEVHZh7FpZQz56qBRuKuS7ffmwBaiK1cqYAiEAqfB2xpmsc8NUReQxT2d8i9l4qFDShnNreVhDm0hfZs4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":152327},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"demo":"bun run src/demo.ts","test":"bun test src/guard.test.ts","build":"tsc -p tsconfig.build.json","typecheck":"tsc --noEmit -p tsconfig.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"enioxt","email":"enioxt@gmail.com"},"deprecated":"Descontinuada — limpeza de conteúdo em andamento; não usar esta versão.","repository":{"url":"git+https://github.com/enioxt/egos.git","type":"git","directory":"packages/guard-brasil"},"_npmVersion":"10.8.2","description":"Brazilian AI safety layer — LGPD-compliant PII masking, ATRiAN ethical validation, and traceable evidence discipline for AI assistants","directories":{},"_nodeVersion":"20.20.0","dependencies":{"@supabase/supabase-js":"^2.101.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/guard-brasil_0.2.3_1775695992350_0.17269457559729595","host":"s3://npm-registry-packages-npm-production"}},"0.2.4":{"name":"@egosbr/guard-brasil","version":"0.2.4","description":"Brazilian AI safety layer — LGPD-compliant PII masking, ATRiAN ethical validation, and traceable evidence discipline for AI assistants","type":"module","main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"}},"keywords":["lgpd","pii","brazil","ai-safety","guardrails","compliance","evidence-chain","atrian","brazilian","cpf","privacy","masking"],"author":{"name":"Enio Rocha","email":"enio@egos.ia.br"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/enioxt/egos.git","directory":"packages/guard-brasil"},"homepage":"https://github.com/enioxt/egos/tree/main/packages/guard-brasil#readme","scripts":{"build":"tsc -p tsconfig.build.json","typecheck":"tsc --noEmit -p tsconfig.json","test":"bun test src/guard.test.ts","demo":"bun run src/demo.ts","prepublishOnly":"npm run build"},"dependencies":{"@supabase/supabase-js":"^2.101.1"},"_id":"@egosbr/guard-brasil@0.2.4","gitHead":"9607848a75c81366535c01f3d200741318b085c5","bugs":{"url":"https://github.com/enioxt/egos/issues"},"_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-PhMDTM4QmV0h4VNvP1o/QF4/asSGl1uceITd/gbqHRmaUBtdeE6Yc4KV4qIQloyyYKSTUOyAM8D5VEwT/Kfq6w==","shasum":"7633cc8abded7c9128d646a14b076eac9db81035","tarball":"https://registry.npmjs.org/@egosbr/guard-brasil/-/guard-brasil-0.2.4.tgz","fileCount":78,"unpackedSize":228313,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCDRygqbGRYqV8mcNlko2WsLjr6TOMu3r/xQf4dugP9IQIgOQHbpHSItgXyCpXuie8yNXjSGk9xVwKgzKH0TftXd+M="}]},"_npmUser":{"name":"enioxt","email":"enioxt@gmail.com"},"directories":{},"maintainers":[{"name":"enioxt","email":"enioxt@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/guard-brasil_0.2.4_1785245125699_0.5168924403109643"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-30T13:45:26.986Z","modified":"2026-07-28T13:25:26.085Z","0.1.0":"2026-03-30T13:45:27.213Z","0.2.0":"2026-04-01T01:05:01.480Z","0.2.1":"2026-04-03T12:34:17.984Z","0.2.2":"2026-04-03T12:54:16.930Z","0.2.3":"2026-04-09T00:53:12.481Z","0.2.4":"2026-07-28T13:25:25.839Z"},"bugs":{"url":"https://github.com/enioxt/egos/issues"},"author":{"name":"Enio Rocha","email":"enio@egos.ia.br"},"license":"MIT","homepage":"https://github.com/enioxt/egos/tree/main/packages/guard-brasil#readme","keywords":["lgpd","pii","brazil","ai-safety","guardrails","compliance","evidence-chain","atrian","brazilian","cpf","privacy","masking"],"repository":{"type":"git","url":"git+https://github.com/enioxt/egos.git","directory":"packages/guard-brasil"},"description":"Brazilian AI safety layer — LGPD-compliant PII masking, ATRiAN ethical validation, and traceable evidence discipline for AI assistants","maintainers":[{"name":"enioxt","email":"enioxt@gmail.com"}],"readme":"# @egosbr/guard-brasil\n\n**Camada de segurança para IA em contexto brasileiro** — mascaramento de dados pessoais (PII), validação ética e cadeia de evidências auditável antes de qualquer texto chegar ao usuário.\n\n> **Status:** em uso ativo · **Licença:** MIT · parte do framework [EGOS](https://github.com/enioxt/egos)\n\n---\n\n## Para que serve\n\nSistemas de IA implantados no Brasil costumam falhar em dois pontos:\n\n1. **Exposição acidental de dados pessoais** — CPF, CNPJ, RG, placa, número de processo e telefone vazam nas respostas do modelo, contrariando a Lei 13.709/2018 (LGPD).\n2. **Afirmações sem evidência** — modelos fazem promessas absolutas, inventam fontes ou citam dados que não existem, especialmente em contextos sensíveis (saúde, jurídico, financeiro).\n\n`@egosbr/guard-brasil` intercepta os dois problemas **na camada de saída**, antes que o texto chegue a quem lê.\n\n**Honestidade importante:** mascarar dados pessoais **não** torna uma operação inteira conforme à LGPD. Conformidade plena envolve base legal, encarregado (DPO), avaliação de impacto e outras obrigações fora do escopo desta biblioteca. Consulte assessoria jurídica para ambientes de produção com dados sensíveis.\n\n---\n\n## O que faz\n\n| Camada | O que verifica | Ação |\n|---|---|---|\n| **PII Scanner BR** | Dados pessoais brasileiros (tabela abaixo) | Mascarar ou bloquear |\n| **Validação ética** | Afirmações absolutas, dados fabricados, promessas falsas, entidades bloqueadas | Pontuar (0–100) + sinalizar |\n| **Public Guard** | Classificação de sensibilidade + aviso de divulgação LGPD | Redigir + nota de rodapé |\n| **Cadeia de evidências** | Rastreabilidade de afirmações + hash de auditoria | Construir bloco de evidências |\n\n---\n\n## Dados pessoais detectados\n\n| Categoria | Exemplo | Substituição |\n|---|---|---|\n| CPF | `123.456.789-09` | `[CPF REMOVIDO]` |\n| CNPJ | `00.000.000/0001-00` | `[CNPJ REMOVIDO]` |\n| RG | `RG: 12.345.678-9` | `[RG REMOVIDO]` |\n| Processo | `0001234-56.2024.1.02.0001` | `[PROCESSO REMOVIDO]` |\n| Placa | `ABC-1D23` | `[PLACA REMOVIDA]` |\n| Telefone | `(31) 99999-0000` | `[TELEFONE REMOVIDO]` |\n| E-mail | `contato@empresa.com.br` | `[EMAIL REMOVIDO]` |\n| Nome (contextual) | `Maria Souza` | `[NOME REMOVIDO]` |\n| Data de nasc. | `nascimento: 15/03/1985` | `[DATA REMOVIDA]` |\n\nA detecção inclui validação de dígitos verificadores onde aplicável (CPF, CNPJ), reduzindo falsos positivos em relação a regex simples.\n\n---\n\n## Stack\n\n- **Runtime:** Bun / Node.js (ESM)\n- **Linguagem:** TypeScript (strict)\n- **Empacotamento:** `dist/index.js` + tipos `dist/index.d.ts`\n\n---\n\n## Instalação\n\n```bash\n# npm\nnpm install @egosbr/guard-brasil\n\n# Bun\nbun add @egosbr/guard-brasil\n```\n\n---\n\n## Quick start\n\n```ts\nimport { GuardBrasil } from '@egosbr/guard-brasil';\n\nconst guard = GuardBrasil.create();\n\nconst result = guard.inspect(respostaDoLLM);\n\nif (!result.safe) {\n  console.log(result.output);          // texto já mascarado/limpo\n  console.log(result.lgpdDisclosure);  // nota de rodapé LGPD\n  console.log(result.summary);         // resumo legível das ocorrências\n}\n```\n\n---\n\n## Configuração\n\n```ts\nconst guard = GuardBrasil.create({\n  // Bloquear a saída inteira quando encontrar dado crítico (CPF, RG)\n  blockOnCriticalPII: false,   // padrão: false (mascara em vez de bloquear)\n\n  // Adicionar nota LGPD ao final de saídas mascaradas\n  lgpdDisclosure: true,        // padrão: true\n\n  // Validação ética\n  atrian: {\n    blockedEntities: ['TERMO_BLOQUEADO'],   // strings exatas → bloqueio imediato\n    knownAcronyms: ['LGPD', 'SINESP'],     // suprimir falsos positivos de siglas\n    onViolation: (result, text) => {\n      logger.warn('Violação ética', result);\n    },\n  },\n});\n```\n\n---\n\n## Cadeia de evidências\n\nAnexe afirmações rastreáveis para auditoria:\n\n```ts\nconst result = guard.inspect(resposta, {\n  sessionId: 'sessao-42',\n  claims: [\n    {\n      claim: 'Registro encontrado no sistema',\n      source: 'api-interna-v2',\n      excerpt: 'Item #2024-0098765 — status: encerrado',\n      confidence: 'high',\n    },\n  ],\n});\n\nconsole.log(result.evidenceBlock); // bloco de evidências com hash de auditoria\n```\n\n---\n\n## Categorias de violação ética\n\n| Categoria | Nível | Exemplo |\n|---|---|---|\n| `absolute_claim` | aviso | `\"com certeza\"`, `\"sem dúvida\"`, `\"sempre\"` |\n| `fabricated_data` | erro | citar fonte/dado que não existe |\n| `false_promise` | erro | `\"vamos resolver\"`, `\"isso será encaminhado\"` |\n| `blocked_entity` | crítico | qualquer string listada em `blockedEntities` |\n| `invented_acronym` | aviso | siglas em maiúsculas não reconhecidas |\n\n---\n\n## Testes e demo\n\n```bash\nbun test src/guard.test.ts   # 15 pass, 0 fail\nbun run src/demo.ts          # demo interativa\n```\n\n---\n\n## Limites e honestidade\n\n- Opera **na camada de saída** — não verifica o que entra no modelo nem controla o comportamento dele.\n- A detecção de nomes próprios é contextual e pode gerar falsos positivos ou negativos.\n- Conformidade com a LGPD envolve dimensões legais, organizacionais e técnicas que vão além do mascaramento automatizado.\n\n---\n\n## English summary\n\n`@egosbr/guard-brasil` is a TypeScript library that adds a Brazilian-context safety layer to LLM outputs. It masks Brazilian PII (CPF, CNPJ, RG, judicial process numbers, vehicle plates, etc.) with check-digit validation, scores outputs for ethical violations, and builds tamper-evident evidence chains for audit. Install via npm or Bun. The Portuguese sections above are canonical.\n\n---\n\n*Atualizado em 17 de junho de 2026 · MIT License · [egos.ia.br](https://egos.ia.br)*\n","readmeFilename":"README.md"}