npm - failproofai - Versions diffs - 0.0.5 → 0.0.6-beta.1 - Mend

failproofai 0.0.5 → 0.0.6-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (179) hide show

package/.next/standalone/docs/i18n/README.ko.md CHANGED Viewed

@@ -23,21 +23,21 @@
 **번역**: [简体中文](docs/i18n/README.zh.md) | [日本語](docs/i18n/README.ja.md) | [한국어](docs/i18n/README.ko.md) | [Español](docs/i18n/README.es.md) | [Português](docs/i18n/README.pt-br.md) | [Deutsch](docs/i18n/README.de.md) | [Français](docs/i18n/README.fr.md) | [Русский](docs/i18n/README.ru.md) | [हिन्दी](docs/i18n/README.hi.md) | [Türkçe](docs/i18n/README.tr.md) | [Tiếng Việt](docs/i18n/README.vi.md) | [Italiano](docs/i18n/README.it.md) | [العربية](docs/i18n/README.ar.md) | [עברית](docs/i18n/README.he.md)
-AI 에이전트를 안정적으로 유지하고, 목표에 집중하며, 자율적으로 실행되도록 정책을 관리하는 가장 쉬운 방법 — **Claude Code** 및 **Agents SDK** 용.
+AI 에이전트를 안정적으로 유지하고, 주어진 작업에 집중하며, 자율적으로 실행될 수 있도록 정책을 관리하는 가장 쉬운 방법 — **Claude Code** 및 **Agents SDK** 지원.
-- **30가지 기본 제공 정책** - 흔히 발생하는 에이전트 장애 패턴을 즉시 감지합니다. 위험한 명령 차단, 시크릿 유출 방지, 에이전트를 프로젝트 경계 내로 제한, 루프 감지 등을 제공합니다.
-- **커스텀 정책** - JavaScript로 나만의 신뢰성 규칙을 작성하세요. `allow`/`deny`/`instruct` API를 활용해 컨벤션을 강제하거나, 드리프트를 방지하거나, 작업을 게이팅하거나, 외부 시스템과 연동할 수 있습니다.
-- **간편한 설정** - 코드 없이 정책을 세밀하게 조정하세요. 프로젝트별 또는 전역으로 허용 목록, 보호 브랜치, 임계값을 설정할 수 있습니다. 세 가지 스코프 설정이 자동으로 병합됩니다.
-- **에이전트 모니터** - 자리를 비운 사이 에이전트가 무엇을 했는지 확인하세요. 세션을 탐색하고, 모든 도구 호출을 검사하며, 정책이 발동된 위치를 정확히 확인할 수 있습니다.
+- **30가지 기본 제공 정책** - 일반적인 에이전트 장애 패턴을 즉시 감지합니다. 파괴적인 명령 차단, 시크릿 유출 방지, 에이전트를 프로젝트 경계 내부로 제한, 루프 감지 등을 지원합니다.
+- **커스텀 정책** - JavaScript로 직접 신뢰성 규칙을 작성하세요. `allow`/`deny`/`instruct` API를 활용해 관례 적용, 드리프트 방지, 작업 승인 게이팅, 외부 시스템 연동이 가능합니다.
+- **간편한 설정** - 코드 작성 없이 어떤 정책이든 조정할 수 있습니다. 허용 목록, 보호된 브랜치, 임계값을 프로젝트별 또는 전역으로 설정하세요. 세 가지 범위의 설정이 자동으로 병합됩니다.
+- **에이전트 모니터** - 자리를 비운 사이 에이전트가 무엇을 했는지 확인하세요. 세션을 탐색하고, 모든 도구 호출을 검사하며, 정책이 발동된 정확한 위치를 확인할 수 있습니다.
-모든 처리는 로컬에서 이루어지며 데이터는 외부로 전송되지 않습니다.
+모든 처리는 로컬에서 실행되며, 데이터는 외부로 전송되지 않습니다.
 ---
 ## 요구 사항
 - Node.js >= 20.9.0
-- Bun >= 1.3.0 (선택 사항 - 개발 또는 소스 빌드 시에만 필요)
+- Bun >= 1.3.0 (선택 사항 — 개발 또는 소스 빌드 시에만 필요)
 ---
@@ -59,7 +59,7 @@ bun add -g failproofai
 failproofai policies --install
 ```
-`~/.claude/settings.json`에 훅 항목을 작성합니다. 이제 Claude Code는 각 도구 호출 전후로 failproofai를 실행합니다.
+`~/.claude/settings.json`에 훅 항목을 작성합니다. 이후 Claude Code는 각 도구 호출 전후에 failproofai를 실행합니다.
 ### 2. 대시보드 실행
@@ -67,9 +67,9 @@ failproofai policies --install
 failproofai
 ```
-`http://localhost:8020`을 엽니다 — 세션 탐색, 로그 검사, 정책 관리가 가능합니다.
+`http://localhost:8020`을 열어 세션을 탐색하고, 로그를 검사하며, 정책을 관리합니다.
-### 3. 활성 정책 확인
+### 3. 현재 활성 정책 확인
 ```bash
 failproofai policies
@@ -79,15 +79,15 @@ failproofai policies
 ## 정책 설치
-### 스코프
+### 범위(Scope)
-| 스코프 | 명령어 | 저장 위치 |
-|--------|--------|-----------|
+| 범위 | 명령어 | 저장 위치 |
+|-------|---------|-----------------|
 | 전역 (기본값) | `failproofai policies --install` | `~/.claude/settings.json` |
 | 프로젝트 | `failproofai policies --install --scope project` | `.claude/settings.json` |
 | 로컬 | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
-### 특정 정책 설치
+### 특정 정책만 설치
 ```bash
 failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
@@ -97,7 +97,7 @@ failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
 ```bash
 failproofai policies --uninstall
-# 또는 특정 스코프 지정 시:
+# 또는 특정 범위만 제거:
 failproofai policies --uninstall --scope project
 ```
@@ -105,7 +105,7 @@ failproofai policies --uninstall --scope project
 ## 설정
-정책 설정은 전역의 경우 `~/.failproofai/policies-config.json`, 프로젝트별 설정은 프로젝트 내 `.failproofai/policies-config.json`에 저장됩니다.
+정책 설정은 `~/.failproofai/policies-config.json`(전역) 또는 프로젝트 내 `.failproofai/policies-config.json`(프로젝트별)에 저장됩니다.
 ```json
 {
@@ -138,32 +138,32 @@ failproofai policies --uninstall --scope project
 }
 ```
-**세 가지 설정 스코프**는 자동으로 병합됩니다 (프로젝트 → 로컬 → 전역). 전체 병합 규칙은 [docs/configuration.mdx](docs/configuration.mdx)를 참고하세요.
+**세 가지 설정 범위**는 자동으로 병합됩니다(프로젝트 → 로컬 → 전역). 전체 병합 규칙은 [docs/configuration.mdx](docs/configuration.mdx)를 참고하세요.
 ---
 ## 기본 제공 정책
-| 정책 | 설명 | 설정 가능 |
-|------|------|:---------:|
-| `block-sudo` | 에이전트의 권한 있는 시스템 명령 실행 방지 | `allowPatterns` |
+| 정책 | 설명 | 설정 가능 파라미터 |
+|--------|-------------|:---:|
+| `block-sudo` | 에이전트가 권한 있는 시스템 명령을 실행하지 못하도록 차단 | `allowPatterns` |
 | `block-rm-rf` | 실수로 인한 재귀적 파일 삭제 방지 | `allowPaths` |
-| `block-curl-pipe-sh` | 에이전트가 신뢰할 수 없는 스크립트를 셸로 파이핑하는 것을 방지 | |
-| `block-failproofai-commands` | 자가 제거 방지 | |
-| `sanitize-jwt` | JWT 토큰이 에이전트 컨텍스트로 유출되는 것을 차단 | |
-| `sanitize-api-keys` | API 키가 에이전트 컨텍스트로 유출되는 것을 차단 | `additionalPatterns` |
-| `sanitize-connection-strings` | 데이터베이스 자격 증명이 에이전트 컨텍스트로 유출되는 것을 차단 | |
+| `block-curl-pipe-sh` | 에이전트가 신뢰할 수 없는 스크립트를 셸에 파이프하지 못하도록 차단 | |
+| `block-failproofai-commands` | 자기 자신의 제거 방지 | |
+| `sanitize-jwt` | JWT 토큰이 에이전트 컨텍스트로 유출되지 않도록 차단 | |
+| `sanitize-api-keys` | API 키가 에이전트 컨텍스트로 유출되지 않도록 차단 | `additionalPatterns` |
+| `sanitize-connection-strings` | 데이터베이스 자격 증명이 에이전트 컨텍스트로 유출되지 않도록 차단 | |
 | `sanitize-private-key-content` | 출력에서 PEM 개인 키 블록 제거 | |
 | `sanitize-bearer-tokens` | 출력에서 Authorization Bearer 토큰 제거 | |
-| `block-env-files` | 에이전트가 .env 파일을 읽는 것을 방지 | |
-| `protect-env-vars` | 에이전트가 환경 변수를 출력하는 것을 방지 | |
-| `block-read-outside-cwd` | 에이전트를 프로젝트 경계 내로 제한 | `allowPaths` |
-| `block-secrets-write` | 개인 키 및 인증서 파일 쓰기 방지 | `additionalPatterns` |
-| `block-push-master` | main/master 브랜치에 실수로 푸시하는 것을 방지 | `protectedBranches` |
-| `block-work-on-main` | 에이전트가 보호된 브랜치에서 작업하는 것을 방지 | `protectedBranches` |
+| `block-env-files` | 에이전트가 .env 파일을 읽지 못하도록 차단 | |
+| `protect-env-vars` | 에이전트가 환경 변수를 출력하지 못하도록 방지 | |
+| `block-read-outside-cwd` | 에이전트를 프로젝트 경계 내부로 제한 | `allowPaths` |
+| `block-secrets-write` | 개인 키 및 인증서 파일에 쓰기 방지 | `additionalPatterns` |
+| `block-push-master` | main/master 브랜치에 실수로 푸시하지 않도록 방지 | `protectedBranches` |
+| `block-work-on-main` | 에이전트가 보호된 브랜치에서 작업하지 못하도록 차단 | `protectedBranches` |
 | `block-force-push` | `git push --force` 방지 | |
-| `warn-git-amend` | 커밋 수정 전 에이전트에게 알림 | |
-| `warn-git-stash-drop` | 스태시 삭제 전 에이전트에게 알림 | |
+| `warn-git-amend` | 커밋 수정 전 에이전트에 알림 | |
+| `warn-git-stash-drop` | 스태시 삭제 전 에이전트에 알림 | |
 | `warn-all-files-staged` | 실수로 인한 `git add -A` 감지 | |
 | `warn-destructive-sql` | 실행 전 DROP/DELETE SQL 감지 | |
 | `warn-schema-alteration` | 실행 전 ALTER TABLE 감지 | |
@@ -173,13 +173,13 @@ failproofai policies --uninstall --scope project
 | `warn-global-package-install` | 의도치 않은 전역 패키지 설치 감지 | |
 | …그 외 다수 | | |
-전체 정책 상세 정보 및 파라미터 참조: [docs/built-in-policies.mdx](docs/built-in-policies.mdx)
+전체 정책 상세 내용 및 파라미터 참조: [docs/built-in-policies.mdx](docs/built-in-policies.mdx)
 ---
 ## 커스텀 정책
-에이전트를 안정적으로 유지하고 목표에 집중시키기 위한 나만의 정책을 작성하세요:
+에이전트를 안정적으로 유지하고 작업에 집중시키기 위해 직접 정책을 작성하세요:
 ```js
 import { customPolicies, allow, deny, instruct } from "failproofai";
@@ -203,32 +203,32 @@ customPolicies.add({
 failproofai policies --install --custom ./my-policies.js
 ```
-### 결정 헬퍼
+### 결정 헬퍼 함수
-| 함수 | 동작 |
-|------|------|
+| 함수 | 효과 |
+|----------|--------|
 | `allow()` | 작업 허용 |
 | `allow(message)` | 허용하고 Claude에 정보성 컨텍스트 전달 |
 | `deny(message)` | 작업 차단; 메시지가 Claude에 표시됨 |
-| `instruct(message)` | Claude 프롬프트에 컨텍스트 추가; 차단하지 않음 |
+| `instruct(message)` | Claude의 프롬프트에 컨텍스트 추가; 차단하지 않음 |
 ### 컨텍스트 객체 (`ctx`)
 | 필드 | 타입 | 설명 |
-|------|------|------|
+|-------|------|-------------|
 | `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
-| `toolName` | `string` | 호출되는 도구 (`"Bash"`, `"Write"`, `"Read"`, …) |
+| `toolName` | `string` | 호출되는 도구 이름 (`"Bash"`, `"Write"`, `"Read"`, …) |
 | `toolInput` | `object` | 도구의 입력 파라미터 |
 | `payload` | `object` | 전체 원시 이벤트 페이로드 |
-| `session.cwd` | `string` | Claude Code 세션의 작업 디렉토리 |
+| `session.cwd` | `string` | Claude Code 세션의 작업 디렉터리 |
 | `session.sessionId` | `string` | 세션 식별자 |
 | `session.transcriptPath` | `string` | 세션 트랜스크립트 파일 경로 |
-커스텀 훅은 전이적 로컬 임포트, async/await, `process.env` 접근을 지원합니다. 오류는 fail-open 방식으로 처리됩니다 (`~/.failproofai/hook.log`에 기록되며, 기본 제공 정책은 계속 실행됩니다). 전체 가이드는 [docs/custom-hooks.mdx](docs/custom-hooks.mdx)를 참고하세요.
+커스텀 훅은 전이적 로컬 임포트, async/await, `process.env` 접근을 지원합니다. 오류 발생 시 페일-오픈 방식으로 처리됩니다(`~/.failproofai/hook.log`에 기록되며, 기본 제공 정책은 계속 동작). 전체 가이드는 [docs/custom-hooks.mdx](docs/custom-hooks.mdx)를 참고하세요.
-### 컨벤션 기반 정책
+### 관례 기반 정책
-`.failproofai/policies/` 디렉토리에 `*policies.{js,mjs,ts}` 파일을 추가하면 자동으로 로드됩니다 — `--custom` 플래그나 설정 변경이 필요 없습니다. git 훅처럼 파일을 추가하기만 하면 바로 동작합니다.
+`.failproofai/policies/` 디렉터리에 `*policies.{js,mjs,ts}` 파일을 넣으면 자동으로 로드됩니다 — `--custom` 플래그나 설정 변경이 필요 없습니다. git 훅처럼 파일만 넣으면 바로 작동합니다.
 ```text
 # 프로젝트 수준 — git에 커밋되어 팀과 공유
@@ -239,7 +239,7 @@ failproofai policies --install --custom ./my-policies.js
 ~/.failproofai/policies/my-policies.mjs
 ```
-두 수준 모두 로드됩니다 (합집합). 각 디렉토리 내 파일은 알파벳 순서로 로드됩니다. 순서를 제어하려면 `01-`, `02-` 등의 접두사를 사용하세요. 바로 사용 가능한 예제는 [examples/convention-policies/](examples/convention-policies/)를 참고하세요.
+두 수준 모두 로드됩니다(합집합). 각 디렉터리 내에서 파일은 알파벳 순으로 로드됩니다. `01-`, `02-` 등의 접두사를 붙여 순서를 제어하세요. 바로 사용 가능한 예시는 [examples/convention-policies/](examples/convention-policies/)를 참고하세요.
 ---
@@ -258,23 +258,23 @@ FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
 ## 문서
 | 가이드 | 설명 |
-|--------|------|
-| [시작하기](docs/getting-started.mdx) | 설치 및 첫 단계 |
-| [기본 제공 정책](docs/built-in-policies.mdx) | 파라미터 포함 30가지 기본 정책 전체 목록 |
-| [커스텀 정책](docs/custom-policies.mdx) | 나만의 정책 작성하기 |
-| [설정](docs/configuration.mdx) | 설정 파일 형식 및 스코프 병합 |
+|-------|-------------|
+| [시작하기](docs/getting-started.mdx) | 설치 및 첫 번째 단계 |
+| [기본 제공 정책](docs/built-in-policies.mdx) | 파라미터를 포함한 30가지 기본 제공 정책 전체 목록 |
+| [커스텀 정책](docs/custom-policies.mdx) | 직접 정책 작성하기 |
+| [설정](docs/configuration.mdx) | 설정 파일 형식 및 범위 병합 |
 | [대시보드](docs/dashboard.mdx) | 세션 모니터링 및 정책 활동 검토 |
-| [아키텍처](docs/architecture.mdx) | 훅 시스템 동작 원리 |
-| [테스팅](docs/testing.mdx) | 테스트 실행 및 새 테스트 작성 |
+| [아키텍처](docs/architecture.mdx) | 훅 시스템의 동작 원리 |
+| [테스트](docs/testing.mdx) | 테스트 실행 및 새 테스트 작성 |
-### 문서 로컬 실행
+### 로컬에서 문서 실행
 ```bash
 docker build -f Dockerfile.docs -t failproofai-docs .
 docker run --rm -p 3000:3000 failproofai-docs
 ```
-`http://localhost:3000`에서 Mintlify 문서 사이트를 엽니다. docs 디렉토리를 마운트하면 컨테이너가 변경 사항을 감시합니다:
+`http://localhost:3000`에서 Mintlify 문서 사이트가 열립니다. docs 디렉터리를 마운트하면 컨테이너가 변경 사항을 감지합니다:
 ```bash
 docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
@@ -284,9 +284,9 @@ docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
 ## failproofai 기여자를 위한 참고 사항
-이 저장소의 `.claude/settings.json`은 표준 `npx -y failproofai` 명령 대신 `bun ./bin/failproofai.mjs --hook <EventType>`을 사용합니다. failproofai 프로젝트 내에서 `npx -y failproofai`를 실행하면 자기 참조 충돌이 발생하기 때문입니다.
+이 저장소의 `.claude/settings.json`은 표준 `npx -y failproofai` 명령 대신 `bun ./bin/failproofai.mjs --hook <EventType>`을 사용합니다. failproofai 프로젝트 내부에서 `npx -y failproofai`를 실행하면 자기 참조 충돌이 발생하기 때문입니다.
-다른 모든 저장소에서는 `npx -y failproofai` 방식을 권장하며, 다음 명령으로 설치할 수 있습니다:
+다른 모든 저장소에서는 `npx -y failproofai` 사용을 권장하며, 다음 명령으로 설치할 수 있습니다:
 ```bash
 failproofai policies --install --scope project
@@ -304,4 +304,4 @@ failproofai policies --install --scope project
 ---
-**ExosphereHost: 에이전트를 위한 신뢰성 연구소**가 개발하고 유지 관리합니다. 저희는 자체 에이전트, 소프트웨어, 전문 지식을 통해 기업과 스타트업이 AI 에이전트의 신뢰성을 향상시킬 수 있도록 돕고 있습니다. 자세한 내용은 [exosphere.host](https://exosphere.host)를 방문하세요.
+**ExosphereHost: 에이전트를 위한 신뢰성 연구소**에서 개발 및 유지 관리합니다. 저희는 자체 에이전트, 소프트웨어, 전문 지식을 통해 기업과 스타트업이 AI 에이전트의 신뢰성을 향상할 수 있도록 돕습니다. 자세한 내용은 [exosphere.host](https://exosphere.host)를 방문하세요.

package/.next/standalone/docs/i18n/README.pt-br.md CHANGED Viewed

@@ -23,12 +23,12 @@
 **Traduções**: [简体中文](docs/i18n/README.zh.md) | [日本語](docs/i18n/README.ja.md) | [한국어](docs/i18n/README.ko.md) | [Español](docs/i18n/README.es.md) | [Português](docs/i18n/README.pt-br.md) | [Deutsch](docs/i18n/README.de.md) | [Français](docs/i18n/README.fr.md) | [Русский](docs/i18n/README.ru.md) | [हिन्दी](docs/i18n/README.hi.md) | [Türkçe](docs/i18n/README.tr.md) | [Tiếng Việt](docs/i18n/README.vi.md) | [Italiano](docs/i18n/README.it.md) | [العربية](docs/i18n/README.ar.md) | [עברית](docs/i18n/README.he.md)
-A maneira mais simples de gerenciar políticas que mantêm seus agentes de IA confiáveis, focados na tarefa e rodando de forma autônoma — para o **Claude Code** e o **Agents SDK**.
+A forma mais fácil de gerenciar políticas que mantêm seus agentes de IA confiáveis, focados na tarefa e operando de forma autônoma — para o **Claude Code** e o **Agents SDK**.
-- **30 Políticas Integradas** - Detecte os modos de falha mais comuns dos agentes logo de cara. Bloqueie comandos destrutivos, evite vazamento de segredos, mantenha os agentes dentro dos limites do projeto, detecte loops e muito mais.
-- **Políticas Personalizadas** - Escreva suas próprias regras de confiabilidade em JavaScript. Use a API `allow`/`deny`/`instruct` para impor convenções, evitar desvios, controlar operações ou integrar com sistemas externos.
-- **Configuração Simples** - Ajuste qualquer política sem escrever código. Defina listas de permissão, branches protegidas e limites por projeto ou globalmente. Três escopos de configuração são mesclados automaticamente.
-- **Monitor de Agentes** - Veja o que seus agentes fizeram enquanto você estava ausente. Navegue pelas sessões, inspecione cada chamada de ferramenta e revise exatamente onde as políticas foram acionadas.
+- **30 Políticas Integradas** — Detecte os modos de falha mais comuns de agentes de cara. Bloqueie comandos destrutivos, evite vazamento de segredos, mantenha agentes dentro dos limites do projeto, detecte loops e muito mais.
+- **Políticas Personalizadas** — Escreva suas próprias regras de confiabilidade em JavaScript. Use a API `allow`/`deny`/`instruct` para impor convenções, evitar desvios, controlar operações ou integrar com sistemas externos.
+- **Configuração Simples** — Ajuste qualquer política sem escrever código. Defina allowlists, branches protegidas e limites por projeto ou globalmente. Três escopos de configuração mesclados automaticamente.
+- **Monitor de Agentes** — Veja o que seus agentes fizeram enquanto você estava ausente. Navegue por sessões, inspecione cada chamada de ferramenta e revise exatamente onde as políticas foram acionadas.
 Tudo roda localmente — nenhum dado sai da sua máquina.
@@ -53,23 +53,23 @@ bun add -g failproofai
 ## Início rápido
-### 1. Ative as políticas globalmente
+### 1. Habilitar políticas globalmente
 ```bash
 failproofai policies --install
 ```
-Grava entradas de hook em `~/.claude/settings.json`. O Claude Code passará a invocar o failproofai antes e depois de cada chamada de ferramenta.
+Insere entradas de hook em `~/.claude/settings.json`. O Claude Code passará a invocar o failproofai antes e depois de cada chamada de ferramenta.
-### 2. Abra o painel
+### 2. Abrir o painel
 ```bash
 failproofai
 ```
-Abre `http://localhost:8020` — navegue pelas sessões, inspecione logs e gerencie políticas.
+Abre `http://localhost:8020` — navegue por sessões, inspecione logs e gerencie políticas.
-### 3. Verifique o que está ativo
+### 3. Verificar o que está ativo
 ```bash
 failproofai policies
@@ -105,7 +105,7 @@ failproofai policies --uninstall --scope project
 ## Configuração
-A configuração das políticas fica em `~/.failproofai/policies-config.json` (global) ou `.failproofai/policies-config.json` no seu projeto (por projeto).
+A configuração de políticas fica em `~/.failproofai/policies-config.json` (global) ou em `.failproofai/policies-config.json` no seu projeto (por projeto).
 ```json
 {
@@ -146,31 +146,31 @@ A configuração das políticas fica em `~/.failproofai/policies-config.json` (g
 | Política | Descrição | Configurável |
 |----------|-----------|:---:|
-| `block-sudo` | Impede que agentes executem comandos privilegiados do sistema | `allowPatterns` |
+| `block-sudo` | Impede agentes de executar comandos privilegiados do sistema | `allowPatterns` |
 | `block-rm-rf` | Previne exclusão recursiva acidental de arquivos | `allowPaths` |
-| `block-curl-pipe-sh` | Impede que agentes direcionem scripts não confiáveis para o shell | |
-| `block-failproofai-commands` | Previne a desinstalação do próprio failproofai | |
-| `sanitize-jwt` | Impede que tokens JWT vazem para o contexto do agente | |
-| `sanitize-api-keys` | Impede que chaves de API vazem para o contexto do agente | `additionalPatterns` |
-| `sanitize-connection-strings` | Impede que credenciais de banco de dados vazem para o contexto do agente | |
-| `sanitize-private-key-content` | Remove blocos de chave privada PEM da saída | |
-| `sanitize-bearer-tokens` | Remove tokens Bearer de Authorization da saída | |
-| `block-env-files` | Impede que agentes leiam arquivos .env | |
-| `protect-env-vars` | Impede que agentes imprimam variáveis de ambiente | |
-| `block-read-outside-cwd` | Mantém os agentes dentro dos limites do projeto | `allowPaths` |
-| `block-secrets-write` | Impede gravações em arquivos de chave privada e certificados | `additionalPatterns` |
+| `block-curl-pipe-sh` | Impede agentes de redirecionar scripts não confiáveis para o shell | |
+| `block-failproofai-commands` | Previne a auto-desinstalação | |
+| `sanitize-jwt` | Impede tokens JWT de vazarem para o contexto do agente | |
+| `sanitize-api-keys` | Impede chaves de API de vazarem para o contexto do agente | `additionalPatterns` |
+| `sanitize-connection-strings` | Impede credenciais de banco de dados de vazarem para o contexto do agente | |
+| `sanitize-private-key-content` | Redige blocos de chave privada PEM da saída | |
+| `sanitize-bearer-tokens` | Redige tokens Bearer de Authorization da saída | |
+| `block-env-files` | Impede agentes de ler arquivos .env | |
+| `protect-env-vars` | Previne agentes de imprimir variáveis de ambiente | |
+| `block-read-outside-cwd` | Mantém agentes dentro dos limites do projeto | `allowPaths` |
+| `block-secrets-write` | Previne gravações em arquivos de chave privada e certificados | `additionalPatterns` |
 | `block-push-master` | Previne pushes acidentais para main/master | `protectedBranches` |
 | `block-work-on-main` | Mantém agentes fora de branches protegidas | `protectedBranches` |
 | `block-force-push` | Previne `git push --force` | |
-| `warn-git-amend` | Lembra os agentes antes de fazer amend em commits | |
-| `warn-git-stash-drop` | Lembra os agentes antes de descartar stashes | |
+| `warn-git-amend` | Lembra agentes antes de emendar commits | |
+| `warn-git-stash-drop` | Lembra agentes antes de descartar stashes | |
 | `warn-all-files-staged` | Detecta `git add -A` acidental | |
-| `warn-destructive-sql` | Detecta DROP/DELETE SQL antes da execução | |
+| `warn-destructive-sql` | Detecta comandos SQL DROP/DELETE antes da execução | |
 | `warn-schema-alteration` | Detecta ALTER TABLE antes da execução | |
 | `warn-large-file-write` | Detecta gravações de arquivos inesperadamente grandes | `thresholdKb` |
 | `warn-package-publish` | Detecta `npm publish` acidental | |
-| `warn-background-process` | Detecta inicializações não intencionais de processos em background | |
-| `warn-global-package-install` | Detecta instalações não intencionais de pacotes globais | |
+| `warn-background-process` | Detecta lançamentos não intencionais de processos em segundo plano | |
+| `warn-global-package-install` | Detecta instalações globais de pacotes não intencionais | |
 | …e mais | | |
 Detalhes completos das políticas e referência de parâmetros: [docs/built-in-policies.mdx](docs/built-in-policies.mdx)
@@ -179,7 +179,7 @@ Detalhes completos das políticas e referência de parâmetros: [docs/built-in-p
 ## Políticas personalizadas
-Escreva suas próprias políticas para manter os agentes confiáveis e focados na tarefa:
+Escreva suas próprias políticas para manter agentes confiáveis e focados na tarefa:
 ```js
 import { customPolicies, allow, deny, instruct } from "failproofai";
@@ -219,19 +219,19 @@ failproofai policies --install --custom ./my-policies.js
 | `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
 | `toolName` | `string` | Ferramenta sendo chamada (`"Bash"`, `"Write"`, `"Read"`, …) |
 | `toolInput` | `object` | Parâmetros de entrada da ferramenta |
-| `payload` | `object` | Payload completo do evento bruto |
+| `payload` | `object` | Payload bruto completo do evento |
 | `session.cwd` | `string` | Diretório de trabalho da sessão do Claude Code |
 | `session.sessionId` | `string` | Identificador da sessão |
 | `session.transcriptPath` | `string` | Caminho para o arquivo de transcrição da sessão |
-Hooks personalizados suportam importações locais transitivas, async/await e acesso a `process.env`. Erros são fail-open (registrados em `~/.failproofai/hook.log`, as políticas integradas continuam funcionando). Consulte [docs/custom-hooks.mdx](docs/custom-hooks.mdx) para o guia completo.
+Hooks personalizados suportam importações locais transitivas, async/await e acesso a `process.env`. Erros são fail-open (registrados em `~/.failproofai/hook.log`; políticas integradas continuam funcionando). Consulte [docs/custom-hooks.mdx](docs/custom-hooks.mdx) para o guia completo.
 ### Políticas baseadas em convenção
-Coloque arquivos `*policies.{js,mjs,ts}` na pasta `.failproofai/policies/` e eles serão carregados automaticamente — sem necessidade de flag `--custom` ou alterações de configuração. Funciona como git hooks: basta adicionar o arquivo e pronto.
+Coloque arquivos `*policies.{js,mjs,ts}` em `.failproofai/policies/` e eles serão carregados automaticamente — sem flag `--custom` nem alterações de configuração. Funciona como git hooks: basta adicionar o arquivo e pronto.
 ```text
-# Nível de projeto — commitado no git, compartilhado com o time
+# Nível de projeto — commitado no git, compartilhado com a equipe
 .failproofai/policies/security-policies.mjs
 .failproofai/policies/workflow-policies.mjs
@@ -239,15 +239,15 @@ Coloque arquivos `*policies.{js,mjs,ts}` na pasta `.failproofai/policies/` e ele
 ~/.failproofai/policies/my-policies.mjs
 ```
-Ambos os níveis são carregados (união). Os arquivos são carregados em ordem alfabética dentro de cada diretório. Use prefixos `01-`, `02-`, etc. para controlar a ordem. Veja [examples/convention-policies/](examples/convention-policies/) para exemplos prontos para uso.
+Ambos os níveis são carregados (união). Os arquivos são carregados em ordem alfabética dentro de cada diretório. Use prefixos como `01-`, `02-`, etc. para controlar a ordem. Veja [examples/convention-policies/](examples/convention-policies/) para exemplos prontos para uso.
 ---
 ## Telemetria
-O Failproof AI coleta telemetria de uso anônima via PostHog para entender o uso das funcionalidades. Nenhum conteúdo de sessão, nome de arquivo, entrada de ferramenta ou informação pessoal é enviado.
+O Failproof AI coleta telemetria de uso anônima via PostHog para entender o uso dos recursos. Nenhum conteúdo de sessão, nome de arquivo, entrada de ferramenta ou informação pessoal é enviado.
-Para desativar:
+Para desabilitar:
 ```bash
 FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
@@ -265,16 +265,16 @@ FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
 | [Configuração](docs/configuration.mdx) | Formato do arquivo de configuração e mesclagem de escopos |
 | [Painel](docs/dashboard.mdx) | Monitore sessões e revise a atividade das políticas |
 | [Arquitetura](docs/architecture.mdx) | Como o sistema de hooks funciona |
-| [Testes](docs/testing.mdx) | Executando testes e escrevendo novos |
+| [Testes](docs/testing.mdx) | Executar testes e criar novos |
-### Execute a documentação localmente
+### Executar a documentação localmente
 ```bash
 docker build -f Dockerfile.docs -t failproofai-docs .
 docker run --rm -p 3000:3000 failproofai-docs
 ```
-Abre o site de documentação Mintlify em `http://localhost:3000`. O container detecta alterações se você montar o diretório de docs:
+Abre o site de documentação Mintlify em `http://localhost:3000`. O container observa alterações se você montar o diretório de docs:
 ```bash
 docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
@@ -284,15 +284,15 @@ docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
 ## Nota para contribuidores do failproofai
-O `.claude/settings.json` deste repositório usa `bun ./bin/failproofai.mjs --hook <EventType>` em vez do comando padrão `npx -y failproofai`. Isso ocorre porque executar `npx -y failproofai` dentro do próprio projeto failproofai gera um conflito de auto-referência.
+O arquivo `.claude/settings.json` deste repositório usa `bun ./bin/failproofai.mjs --hook <EventType>` em vez do comando padrão `npx -y failproofai`. Isso ocorre porque executar `npx -y failproofai` dentro do próprio projeto failproofai cria um conflito de auto-referência.
-Para todos os outros repositórios, a abordagem recomendada é `npx -y failproofai`, instalado via:
+Para todos os outros repositórios, a abordagem recomendada é `npx -y failproofai`, instalada via:
 ```bash
 failproofai policies --install --scope project
 ```
-## Contribuindo
+## Contribuição
 Consulte [CONTRIBUTING.md](CONTRIBUTING.md).
@@ -304,4 +304,4 @@ Consulte [LICENSE](LICENSE).
 ---
-Criado e mantido pela **ExosphereHost: Reliability Research Lab for Your Agents**. Ajudamos empresas e startups a melhorar a confiabilidade de seus agentes de IA por meio de nossos próprios agentes, software e expertise. Saiba mais em [exosphere.host](https://exosphere.host).
+Desenvolvido e mantido pela **ExosphereHost: Reliability Research Lab for Your Agents**. Ajudamos empresas e startups a melhorar a confiabilidade de seus agentes de IA por meio de nossos próprios agentes, software e expertise. Saiba mais em [exosphere.host](https://exosphere.host).