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

failproofai 0.0.6-beta.1 → 0.0.6-beta.3

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 (177) 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
@@ -81,13 +81,13 @@ 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,48 +138,48 @@ 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-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 파일을 읽지 못하도록 차단 | |
+| `block-env-files` | 에이전트가 .env 파일을 읽지 못하도록 방지 | |
 | `protect-env-vars` | 에이전트가 환경 변수를 출력하지 못하도록 방지 | |
-| `block-read-outside-cwd` | 에이전트를 프로젝트 경계 내부로 제한 | `allowPaths` |
+| `block-read-outside-cwd` | 에이전트를 프로젝트 범위 내로 제한 | `allowPaths` |
 | `block-secrets-write` | 개인 키 및 인증서 파일에 쓰기 방지 | `additionalPatterns` |
-| `block-push-master` | main/master 브랜치에 실수로 푸시하지 않도록 방지 | `protectedBranches` |
-| `block-work-on-main` | 에이전트가 보호된 브랜치에서 작업하지 못하도록 차단 | `protectedBranches` |
+| `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 감지 | |
-| `warn-large-file-write` | 예상치 못한 대용량 파일 쓰기 감지 | `thresholdKb` |
+| `warn-large-file-write` | 예상치 못하게 큰 파일 쓰기 감지 | `thresholdKb` |
 | `warn-package-publish` | 실수로 인한 `npm publish` 감지 | |
-| `warn-background-process` | 의도치 않은 백그라운드 프로세스 실행 감지 | |
-| `warn-global-package-install` | 의도치 않은 전역 패키지 설치 감지 | |
-| …그 외 다수 | | |
+| `warn-background-process` | 의도하지 않은 백그라운드 프로세스 실행 감지 | |
+| `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";
@@ -197,7 +197,7 @@ customPolicies.add({
 });
 ```
-다음 명령어로 설치하세요:
+다음 명령으로 설치합니다:
 ```bash
 failproofai policies --install --custom ./my-policies.js
@@ -205,30 +205,30 @@ failproofai policies --install --custom ./my-policies.js
 ### 결정 헬퍼 함수
-| 함수 | 효과 |
-|----------|--------|
+| 함수 | 동작 |
+|------|------|
 | `allow()` | 작업 허용 |
-| `allow(message)` | 허용하고 Claude에 정보성 컨텍스트 전달 |
+| `allow(message)` | 허용하고 Claude에 정보성 컨텍스트 전송 |
 | `deny(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.sessionId` | `string` | 세션 식별자 |
 | `session.transcriptPath` | `string` | 세션 트랜스크립트 파일 경로 |
-커스텀 훅은 전이적 로컬 임포트, async/await, `process.env` 접근을 지원합니다. 오류 발생 시 페일-오픈 방식으로 처리됩니다(`~/.failproofai/hook.log`에 기록되며, 기본 제공 정책은 계속 동작). 전체 가이드는 [docs/custom-hooks.mdx](docs/custom-hooks.mdx)를 참고하세요.
+커스텀 훅은 전이적 로컬 임포트, async/await, `process.env` 접근을 지원합니다. 오류 발생 시 fail-open 방식으로 처리됩니다 (`~/.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}` 파일을 추가하면 별도의 플래그나 설정 변경 없이 자동으로 로드됩니다. 해당 디렉터리를 git에 커밋하면 모든 팀원이 동일한 품질 기준을 자동으로 적용받습니다.
 ```text
 # 프로젝트 수준 — git에 커밋되어 팀과 공유
@@ -239,13 +239,13 @@ 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/)를 참고하세요.
 ---
 ## 텔레메트리
-Failproof AI는 기능 사용 현황을 파악하기 위해 PostHog를 통해 익명 사용 텔레메트리를 수집합니다. 세션 내용, 파일 이름, 도구 입력, 개인 정보는 절대 전송되지 않습니다.
+Failproof AI는 기능 사용 현황을 파악하기 위해 PostHog를 통해 익명의 사용 텔레메트리를 수집합니다. 세션 내용, 파일 이름, 도구 입력, 개인 정보는 절대 전송되지 않습니다.
 비활성화 방법:
@@ -258,14 +258,14 @@ FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
 ## 문서
 | 가이드 | 설명 |
-|-------|-------------|
+|--------|------|
 | [시작하기](docs/getting-started.mdx) | 설치 및 첫 번째 단계 |
-| [기본 제공 정책](docs/built-in-policies.mdx) | 파라미터를 포함한 30가지 기본 제공 정책 전체 목록 |
+| [내장 정책](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) | 테스트 실행 및 새 테스트 작성 |
 ### 로컬에서 문서 실행
@@ -274,7 +274,7 @@ 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 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**.
+A maneira mais fácil de gerenciar políticas que mantêm seus agentes de IA confiáveis, focados nas tarefas e operando de forma autônoma — para **Claude Code** e o **Agents SDK**.
-- **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.
+- **30 Políticas Integradas** - Identifique modos de falha comuns de 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 aplicar 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.
 Tudo roda localmente — nenhum dado sai da sua máquina.
@@ -53,23 +53,23 @@ bun add -g failproofai
 ## Início rápido
-### 1. Habilitar políticas globalmente
+### 1. Habilite as políticas globalmente
 ```bash
 failproofai policies --install
 ```
-Insere entradas de hook em `~/.claude/settings.json`. O Claude Code passará a invocar o failproofai antes e depois de cada chamada de ferramenta.
+Grava entradas de hook em `~/.claude/settings.json`. A partir de agora, Claude Code invocará o failproofai antes e depois de cada chamada de ferramenta.
-### 2. Abrir o painel
+### 2. Inicie o painel
 ```bash
 failproofai
 ```
-Abre `http://localhost:8020` — navegue por sessões, inspecione logs e gerencie políticas.
+Abre `http://localhost:8020` — navegue pelas sessões, inspecione logs e gerencie políticas.
-### 3. Verificar o que está ativo
+### 3. Verifique o que está ativo
 ```bash
 failproofai policies
@@ -105,7 +105,7 @@ failproofai policies --uninstall --scope project
 ## Configuração
-A configuração de políticas fica em `~/.failproofai/policies-config.json` (global) ou em `.failproofai/policies-config.json` no seu projeto (por projeto).
+A configuração de políticas fica em `~/.failproofai/policies-config.json` (global) ou `.failproofai/policies-config.json` no seu projeto (por projeto).
 ```json
 {
@@ -146,31 +146,31 @@ A configuração de políticas fica em `~/.failproofai/policies-config.json` (gl
 | Política | Descrição | Configurável |
 |----------|-----------|:---:|
-| `block-sudo` | Impede agentes de executar comandos privilegiados do sistema | `allowPatterns` |
+| `block-sudo` | Impede que agentes executem comandos de sistema privilegiados | `allowPatterns` |
 | `block-rm-rf` | Previne exclusão recursiva acidental de arquivos | `allowPaths` |
-| `block-curl-pipe-sh` | Impede agentes de redirecionar scripts não confiáveis para o shell | |
+| `block-curl-pipe-sh` | Impede que agentes redirecionem 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` |
+| `sanitize-jwt` | Evita que tokens JWT vazem para o contexto do agente | |
+| `sanitize-api-keys` | Evita que chaves de API vazem para o contexto do agente | `additionalPatterns` |
+| `sanitize-connection-strings` | Evita 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 Authorization Bearer da saída | |
+| `block-env-files` | Impede que agentes leiam arquivos .env | |
+| `protect-env-vars` | Previne que agentes exibam variáveis de ambiente | |
+| `block-read-outside-cwd` | Mantém os 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-work-on-main` | Mantém os agentes fora de branches protegidas | `protectedBranches` |
 | `block-force-push` | Previne `git push --force` | |
-| `warn-git-amend` | Lembra agentes antes de emendar commits | |
-| `warn-git-stash-drop` | Lembra agentes antes de descartar stashes | |
+| `warn-git-amend` | Lembra os agentes antes de emendar commits | |
+| `warn-git-stash-drop` | Lembra os agentes antes de descartar stashes | |
 | `warn-all-files-staged` | Detecta `git add -A` acidental | |
-| `warn-destructive-sql` | Detecta comandos SQL DROP/DELETE antes da execução | |
+| `warn-destructive-sql` | Detecta comandos DROP/DELETE SQL 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 lançamentos não intencionais de processos em segundo plano | |
-| `warn-global-package-install` | Detecta instalações globais de pacotes não intencionais | |
+| `warn-background-process` | Detecta inicializações não intencionais de processos em segundo plano | |
+| `warn-global-package-install` | Detecta instalações não intencionais de pacotes globais | |
 | …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 agentes confiáveis e focados na tarefa:
+Escreva suas próprias políticas para manter os agentes confiáveis e focados nas tarefas:
 ```js
 import { customPolicies, allow, deny, instruct } from "failproofai";
@@ -203,14 +203,14 @@ Instale com:
 failproofai policies --install --custom ./my-policies.js
 ```
-### Funções de decisão
+### Auxiliares de decisão
 | Função | Efeito |
 |--------|--------|
 | `allow()` | Permite a operação |
-| `allow(message)` | Permite e envia contexto informativo para o Claude |
-| `deny(message)` | Bloqueia a operação; a mensagem é exibida para o Claude |
-| `instruct(message)` | Adiciona contexto ao prompt do Claude; não bloqueia |
+| `allow(message)` | Permite e envia contexto informativo para Claude |
+| `deny(message)` | Bloqueia a operação; mensagem exibida para Claude |
+| `instruct(message)` | Adiciona contexto ao prompt de Claude; não bloqueia |
 ### Objeto de contexto (`ctx`)
@@ -219,35 +219,35 @@ 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 bruto completo do evento |
+| `payload` | `object` | Payload completo do evento bruto |
 | `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`; 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`; as 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}` 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.
+Coloque arquivos `*policies.{js,mjs,ts}` em `.failproofai/policies/` e eles serão carregados automaticamente — sem flags ou alterações de configuração. Faça commit do diretório no git e todos os membros da equipe recebem automaticamente os mesmos padrões de qualidade.
 ```text
 # Nível de projeto — commitado no git, compartilhado com a equipe
 .failproofai/policies/security-policies.mjs
 .failproofai/policies/workflow-policies.mjs
-# Nível de usuário — pessoal, aplicado a todos os projetos
+# Nível do usuário — pessoal, aplica-se a todos os projetos
 ~/.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 como `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 o prefixo `01-`, `02-`, etc. para controlar a ordem. À medida que sua equipe descobre novos modos de falha, adicione uma política e faça push — todos receberão a atualização no próximo pull. 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 dos recursos. Nenhum conteúdo de sessão, nome de arquivo, entrada de ferramenta ou informação pessoal é enviado.
+Failproof AI coleta telemetria de uso anônima via PostHog para entender o uso de recursos. Nenhum conteúdo de sessão, nome de arquivo, entrada de ferramenta ou informação pessoal é enviado.
-Para desabilitar:
+Para desativar:
 ```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) | Executar testes e criar novos |
+| [Testes](docs/testing.mdx) | Executando testes e escrevendo novos |
-### Executar a documentação localmente
+### Execute 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 observa alterações se você montar o diretório de 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:
 ```bash
 docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
@@ -292,7 +292,7 @@ Para todos os outros repositórios, a abordagem recomendada é `npx -y failproof
 failproofai policies --install --scope project
 ```
-## Contribuição
+## Contribuindo
 Consulte [CONTRIBUTING.md](CONTRIBUTING.md).
@@ -304,4 +304,4 @@ Consulte [LICENSE](LICENSE).
 ---
-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).
+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, softwares e expertise. Saiba mais em [exosphere.host](https://exosphere.host).