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

failproofai 0.0.6-beta.3 → 0.0.6-beta.4

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 (509) hide show

package/.next/standalone/docs/ko/built-in-policies.mdx DELETED Viewed

@@ -1,572 +0,0 @@
----
-title: 내장 정책
-description: "일반적인 에이전트 오류 패턴을 감지하는 30가지 내장 정책"
-icon: shield
----
-failproofai에는 일반적인 에이전트 오류 패턴을 감지하는 30가지 내장 정책이 포함되어 있습니다. 각 정책은 특정 훅 이벤트 유형 및 도구 이름에 따라 실행됩니다. 9가지 정책은 코드를 작성하지 않고도 동작을 조정할 수 있는 파라미터를 제공합니다. 4가지 워크플로우 정책은 Claude가 중단하기 전에 커밋 → 푸시 → PR → CI 파이프라인을 완료하도록 강제합니다.
----
-## 개요
-정책은 다음과 같은 카테고리로 분류됩니다:
-| 카테고리 | 정책 | 훅 유형 |
-|----------|----------|-----------|
-| [위험한 명령어](#dangerous-commands) | block-sudo, block-rm-rf, block-curl-pipe-sh, block-failproofai-commands | PreToolUse |
-| [시크릿 (새니타이저)](#secrets-sanitizers) | sanitize-jwt, sanitize-api-keys, sanitize-connection-strings, sanitize-private-key-content, sanitize-bearer-tokens | PostToolUse |
-| [환경](#environment) | block-env-files, protect-env-vars | PreToolUse |
-| [파일 접근](#file-access) | block-read-outside-cwd, block-secrets-write | PreToolUse |
-| [Git](#git) | block-push-master, block-work-on-main, block-force-push, warn-git-amend, warn-git-stash-drop, warn-all-files-staged | PreToolUse |
-| [데이터베이스](#database) | warn-destructive-sql, warn-schema-alteration | PreToolUse |
-| [경고](#warnings) | warn-large-file-write, warn-package-publish, warn-background-process, warn-global-package-install | PreToolUse |
-| [패키지 매니저](#package-managers) | prefer-package-manager | PreToolUse |
-| [워크플로우](#workflow) | require-commit-before-stop, require-push-before-stop, require-pr-before-stop, require-ci-green-before-stop | Stop |
-- **`block-`** — 에이전트가 계속 진행하지 못하도록 차단합니다.
-- **`warn-`** — 에이전트가 스스로 수정할 수 있도록 추가 맥락 정보를 제공합니다.
-- **`sanitize-`** — 에이전트가 도구 출력을 받기 전에 민감한 데이터를 제거합니다.
-- **`require-`** — 조건이 충족될 때까지 Stop 이벤트를 차단합니다.
----
-<Tip>
-모든 정책은 `policyParams`에서 선택적 `hint` 필드를 지원합니다. hint는 Claude가 보는 deny 또는 instruct 메시지에 추가되어, 정책 코드를 수정하지 않고도 실행 가능한 안내를 제공합니다. 내장 정책, 커스텀 정책, 컨벤션 정책 모두에서 사용할 수 있습니다. 자세한 내용은 [설정 → hint](/ko/configuration#hint-cross-cutting)를 참고하세요.
-</Tip>
----
-## 위험한 명령어
-에이전트가 실행하기 어렵거나 호스트 시스템에 손상을 줄 수 있는 작업을 실행하지 못하도록 방지합니다.
-### `block-sudo`
-**이벤트:** PreToolUse (Bash)
-**기본값:** `sudo` 명령어가 포함된 모든 명령을 차단합니다.
-`sudo` 키워드가 포함된 명령 실행을 차단합니다. 패턴 매칭은 원시 문자열이 아닌 파싱된 명령 토큰을 기준으로 수행되므로, 셸 연산자 삽입을 통한 우회를 방지합니다.
-**파라미터:**
-| 파라미터 | 타입 | 기본값 | 설명 |
-|-------|------|---------|-------------|
-| `allowPatterns` | `string[]` | `[]` | 허용되는 정확한 명령 접두사. 각 항목은 파싱된 argv 토큰과 대조됩니다. |
-**예시:**
-```json
-{
-  "policyParams": {
-    "block-sudo": {
-      "allowPatterns": ["sudo systemctl status", "sudo journalctl"]
-    }
-  }
-}
-```
-이 설정에서 `sudo systemctl status nginx`는 허용되지만, `sudo rm /etc/hosts`는 차단됩니다.
-<Note>
-패턴은 원시 명령 문자열이 아닌 파싱된 토큰과 대조됩니다. 이를 통해 셸 연산자 추가를 통한 우회를 방지합니다 (예: `sudo systemctl status x; rm -rf /`는 `sudo systemctl status *`와 매칭되지 않습니다).
-</Note>
----
-### `block-rm-rf`
-**이벤트:** PreToolUse (Bash)
-**기본값:** `rm -rf`, `rm -fr` 및 유사한 재귀적 삭제 형식을 차단합니다.
-**파라미터:**
-| 파라미터 | 타입 | 기본값 | 설명 |
-|-------|------|---------|-------------|
-| `allowPaths` | `string[]` | `[]` | 재귀적 삭제가 허용되는 경로 (예: `/tmp`). |
-**예시:**
-```json
-{
-  "policyParams": {
-    "block-rm-rf": {
-      "allowPaths": ["/tmp", "/var/cache"]
-    }
-  }
-}
-```
----
-### `block-curl-pipe-sh`
-**이벤트:** PreToolUse (Bash)
-**기본값:** `curl <url> | bash`, `curl <url> | sh`, `wget <url> | bash` 및 유사한 패턴을 차단합니다.
-파라미터 없음.
----
-### `block-failproofai-commands`
-**이벤트:** PreToolUse (Bash)
-**기본값:** failproofai 자체를 제거하거나 비활성화하는 명령(예: `npm uninstall failproofai`, `failproofai policies --uninstall`)을 차단합니다.
-파라미터 없음.
----
-## 시크릿 (새니타이저)
-에이전트가 자격 증명을 컨텍스트나 출력에 노출하지 못하도록 방지합니다. 새니타이저 정책은 **PostToolUse** 이벤트에서 실행됩니다. Claude가 Bash 명령을 실행하거나, 파일을 읽거나, 도구를 호출하면 이 정책들이 출력값을 Claude에 반환하기 전에 검사합니다. 시크릿 패턴이 감지되면 해당 정책은 출력이 다시 전달되지 않도록 deny 결정을 반환합니다.
-### `sanitize-jwt`
-**이벤트:** PostToolUse (모든 도구)
-**기본값:** JWT 토큰(`.`으로 구분된 세 개의 base64url 세그먼트)을 마스킹합니다.
-파라미터 없음.
----
-### `sanitize-api-keys`
-**이벤트:** PostToolUse (모든 도구)
-**기본값:** 일반적인 API 키 형식을 마스킹합니다: Anthropic (`sk-ant-`), OpenAI (`sk-`), GitHub PAT (`ghp_`), AWS 액세스 키 (`AKIA`), Stripe 키 (`sk_live_`, `sk_test_`), Google API 키 (`AIza`).
-**파라미터:**
-| 파라미터 | 타입 | 기본값 | 설명 |
-|-------|------|---------|-------------|
-| `additionalPatterns` | `{ regex: string; label: string }[]` | `[]` | 시크릿으로 처리할 추가 정규식 패턴. |
-**예시:**
-```json
-{
-  "policyParams": {
-    "sanitize-api-keys": {
-      "additionalPatterns": [
-        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo internal API key" },
-        { "regex": "pat_[0-9a-f]{40}", "label": "Internal PAT" }
-      ]
-    }
-  }
-}
-```
----
-### `sanitize-connection-strings`
-**이벤트:** PostToolUse (모든 도구)
-**기본값:** 자격 증명이 포함된 데이터베이스 연결 문자열(예: `postgresql://user:password@host/db`)을 마스킹합니다.
-파라미터 없음.
----
-### `sanitize-private-key-content`
-**이벤트:** PostToolUse (모든 도구)
-**기본값:** PEM 블록(`-----BEGIN PRIVATE KEY-----`, `-----BEGIN RSA PRIVATE KEY-----` 등)을 마스킹합니다.
-파라미터 없음.
----
-### `sanitize-bearer-tokens`
-**이벤트:** PostToolUse (모든 도구)
-**기본값:** 토큰이 20자 이상인 `Authorization: Bearer <token>` 헤더를 마스킹합니다.
-파라미터 없음.
----
-## 환경
-에이전트가 민감한 환경 설정을 읽거나 노출하지 못하도록 보호합니다.
-### `block-env-files`
-**이벤트:** PreToolUse (Bash, Read)
-**기본값:** `cat .env`, 파일 경로가 `.env`인 `Read` 도구 호출 등 `.env` 파일을 읽는 것을 차단합니다.
-`.envrc`나 다른 환경 관련 파일은 차단하지 않으며, 정확히 `.env`로 명명된 파일만 차단합니다.
-파라미터 없음.
----
-### `protect-env-vars`
-**이벤트:** PreToolUse (Bash)
-**기본값:** 환경 변수를 출력하는 명령(`printenv`, `env`, `echo $VAR`)을 차단합니다.
-파라미터 없음.
----
-## 파일 접근
-에이전트가 프로젝트 경계 내에서만 작업하고 민감한 파일에 접근하지 못하도록 유지합니다.
-### `block-read-outside-cwd`
-**이벤트:** PreToolUse (Read, Bash)
-**기본값:** 현재 작업 디렉터리(프로젝트 루트) 외부의 파일을 읽는 것을 차단합니다.
-**파라미터:**
-| 파라미터 | 타입 | 기본값 | 설명 |
-|-------|------|---------|-------------|
-| `allowPaths` | `string[]` | `[]` | cwd 외부에 있더라도 허용되는 절대 경로 접두사. |
-**예시:**
-```json
-{
-  "policyParams": {
-    "block-read-outside-cwd": {
-      "allowPaths": ["/shared/data", "/opt/company/config"]
-    }
-  }
-}
-```
----
-### `block-secrets-write`
-**이벤트:** PreToolUse (Write, Edit)
-**기본값:** 개인 키 및 인증서에 일반적으로 사용되는 파일(`id_rsa`, `id_ed25519`, `*.key`, `*.pem`, `*.p12`, `*.pfx`)에 대한 쓰기를 차단합니다.
-**파라미터:**
-| 파라미터 | 타입 | 기본값 | 설명 |
-|-------|------|---------|-------------|
-| `additionalPatterns` | `string[]` | `[]` | 차단할 추가 파일명 패턴 (글로브 방식). |
-**예시:**
-```json
-{
-  "policyParams": {
-    "block-secrets-write": {
-      "additionalPatterns": [".token", ".secret"]
-    }
-  }
-}
-```
----
-## Git
-실수로 인한 푸시, 강제 푸시, 되돌리기 어려운 브랜치 실수를 방지합니다.
-### `block-push-master`
-**이벤트:** PreToolUse (Bash)
-**기본값:** `git push origin main` 및 `git push origin master`를 차단합니다.
-**파라미터:**
-| 파라미터 | 타입 | 기본값 | 설명 |
-|-------|------|---------|-------------|
-| `protectedBranches` | `string[]` | `["main", "master"]` | 직접 푸시할 수 없는 브랜치 이름. |
-**예시:**
-```json
-{
-  "policyParams": {
-    "block-push-master": {
-      "protectedBranches": ["main", "master", "release", "prod"]
-    }
-  }
-}
-```
-<Tip>
-`enabledPolicies`에서 제거하지 않고 이 정책을 사실상 비활성화하려면(모든 브랜치에 푸시 허용), `protectedBranches: []`로 설정하세요.
-</Tip>
----
-### `block-work-on-main`
-**이벤트:** PreToolUse (Bash)
-**기본값:** `main` 또는 `master` 브랜치를 직접 체크아웃하는 것을 차단합니다.
-**파라미터:**
-| 파라미터 | 타입 | 기본값 | 설명 |
-|-------|------|---------|-------------|
-| `protectedBranches` | `string[]` | `["main", "master"]` | 직접 체크아웃할 수 없는 브랜치 이름. |
----
-### `block-force-push`
-**이벤트:** PreToolUse (Bash)
-**기본값:** `git push --force` 및 `git push -f`를 차단합니다.
-정책별 파라미터는 없습니다. 공통 [`hint`](/ko/configuration#hint-cross-cutting)를 사용하여 대안을 제안할 수 있습니다:
-```json
-{
-  "policyParams": {
-    "block-force-push": {
-      "hint": "Create a new branch from your current HEAD (e.g. `git checkout -b <new-branch>`) and push that instead."
-    }
-  }
-}
-```
----
-### `warn-git-amend`
-**이벤트:** PreToolUse (Bash)
-**기본값:** `git commit --amend` 실행 시 Claude에게 주의하여 진행하도록 안내합니다. 명령을 차단하지는 않습니다.
-파라미터 없음.
----
-### `warn-git-stash-drop`
-**이벤트:** PreToolUse (Bash)
-**기본값:** `git stash drop` 실행 전 Claude에게 확인하도록 안내합니다. 명령을 차단하지는 않습니다.
-파라미터 없음.
----
-### `warn-all-files-staged`
-**이벤트:** PreToolUse (Bash)
-**기본값:** `git add -A` 또는 `git add .` 실행 시 Claude에게 스테이징할 내용을 검토하도록 안내합니다. 명령을 차단하지는 않습니다.
-파라미터 없음.
----
-## 데이터베이스
-데이터베이스에 실행되기 전에 파괴적인 SQL 작업을 감지합니다.
-### `warn-destructive-sql`
-**이벤트:** PreToolUse (Bash)
-**기본값:** `DROP TABLE`, `DROP DATABASE`, 또는 `WHERE` 절이 없는 `DELETE`가 포함된 SQL 실행 전 Claude에게 확인하도록 안내합니다.
-파라미터 없음.
----
-### `warn-schema-alteration`
-**이벤트:** PreToolUse (Bash)
-**기본값:** `ALTER TABLE` 구문 실행 전 Claude에게 확인하도록 안내합니다.
-파라미터 없음.
----
-## 경고
-잠재적으로 위험하지만 파괴적이지 않은 작업 전에 에이전트에게 추가 맥락을 제공합니다.
-### `warn-large-file-write`
-**이벤트:** PreToolUse (Write)
-**기본값:** 1024 KB보다 큰 파일을 쓰기 전에 Claude에게 확인하도록 안내합니다.
-**파라미터:**
-| 파라미터 | 타입 | 기본값 | 설명 |
-|-------|------|---------|-------------|
-| `thresholdKb` | `number` | `1024` | 경고가 발생하는 파일 크기 임계값 (킬로바이트). |
-**예시:**
-```json
-{
-  "policyParams": {
-    "warn-large-file-write": {
-      "thresholdKb": 256
-    }
-  }
-}
-```
-<Note>
-훅 핸들러는 페이로드에 대해 1 MB stdin 제한을 적용합니다. 소용량 콘텐츠로 이 정책을 테스트하려면 `thresholdKb`를 1024보다 훨씬 낮은 값으로 설정하세요.
-</Note>
----
-### `warn-package-publish`
-**이벤트:** PreToolUse (Bash)
-**기본값:** `npm publish` 실행 전 Claude에게 확인하도록 안내합니다.
-파라미터 없음.
----
-### `warn-background-process`
-**이벤트:** PreToolUse (Bash)
-**기본값:** `nohup`, `&`, `disown`, `screen`을 통해 백그라운드 프로세스를 시작할 때 Claude에게 주의하도록 안내합니다.
-파라미터 없음.
----
-### `warn-global-package-install`
-**이벤트:** PreToolUse (Bash)
-**기본값:** `npm install -g`, `yarn global add`, 또는 가상 환경 없이 `pip install` 실행 전 Claude에게 확인하도록 안내합니다.
-파라미터 없음.
----
-## 패키지 매니저
-에이전트가 사용할 수 있는 패키지 매니저를 제한합니다.
-### `prefer-package-manager`
-**이벤트:** PreToolUse (Bash)
-**기본값:** 비활성화됨. 활성화 시, `allowed` 목록에 없는 패키지 매니저 명령을 차단하고 허용된 매니저를 사용하도록 Claude에게 명령을 재작성하도록 안내합니다.
-감지 대상: pip, pip3, python -m pip, npm, npx, yarn, pnpm, pnpx, bun, bunx, uv, poetry, pipenv, conda, cargo.
-| 파라미터 | 타입 | 기본값 | 설명 |
-|-----------|------|---------|-------------|
-| `allowed` | string[] | `[]` | 허용되는 패키지 매니저 이름. 이 목록에 없는 감지된 매니저는 차단됩니다. 비어 있으면 정책이 동작하지 않습니다. |
-| `blocked` | string[] | `[]` | 내장 목록 외에 추가로 차단할 매니저 이름 (예: `['pdm', 'pipx']`). |
-내장 차단 목록에는 pip, pip3, npm, npx, yarn, pnpm, pnpx, bun, bunx, uv, poetry, pipenv, conda, cargo가 포함됩니다. `blocked`를 사용하여 이 목록에 없는 매니저를 추가할 수 있습니다.
-**예시 설정:**
-```json
-{
-  "enabledPolicies": ["prefer-package-manager"],
-  "policyParams": {
-    "prefer-package-manager": {
-      "allowed": ["uv", "bun"],
-      "blocked": ["pdm", "pipx"]
-    }
-  }
-}
-```
-이 설정에서 `pip install flask`와 `pdm install flask`는 모두 차단되며, `uv` 또는 `bun`을 사용하도록 안내하는 메시지가 표시됩니다. `uv pip install flask`와 같은 명령은 `uv`가 허용 목록에 있고 우선적으로 확인되므로 허용됩니다.
----
-## AI 동작
-에이전트가 루프에 빠지거나 예상치 못한 동작을 보일 때 감지합니다.
-### `warn-repeated-tool-calls`
-**이벤트:** PreToolUse (모든 도구)
-**기본값:** 동일한 도구가 동일한 파라미터로 3회 이상 호출될 때 Claude에게 재고하도록 안내합니다. 이는 에이전트가 루프에 빠졌다는 일반적인 신호입니다.
-파라미터 없음.
----
-## 워크플로우
-세션 종료 시 규율 있는 워크플로우를 강제합니다. 이 정책들은 **Stop** 이벤트에서 실행되며, 각 조건이 충족될 때까지 Claude의 중단을 차단합니다. 커밋 → 푸시 → PR → CI의 자연스러운 의존성 체인을 따릅니다. 정책이 deny를 반환하면 이후 정책들은 건너뜁니다 (deny 단락 평가).
-모든 워크플로우 정책은 **fail-open** 방식입니다: 필요한 도구를 사용할 수 없는 경우(예: `gh` 미설치, git 원격 없음), 정책은 검사가 건너뛰어진 이유를 설명하는 안내 메시지와 함께 허용합니다.
-### `require-commit-before-stop`
-**이벤트:** Stop
-**기본값:** 커밋되지 않은 변경사항(수정됨, 스테이징됨, 추적되지 않은 파일)이 있을 때 중단을 차단합니다. 작업 디렉터리가 깨끗한 경우 안내 메시지를 반환합니다.
-파라미터 없음.
----
-### `require-push-before-stop`
-**이벤트:** Stop
-**기본값:** 푸시되지 않은 커밋이 있거나 현재 브랜치에 원격 추적 브랜치가 없을 때 중단을 차단합니다. 필요한 경우 추적 브랜치를 생성하도록 `git push -u`를 제안합니다. 원격이 설정되지 않은 경우 fail-open 방식으로 동작합니다.
-**파라미터:**
-| 파라미터 | 타입 | 기본값 | 설명 |
-|-------|------|---------|-------------|
-| `remote` | `string` | `"origin"` | 푸시할 원격 이름. |
-**예시:**
-```json
-{
-  "policyParams": {
-    "require-push-before-stop": {
-      "remote": "upstream"
-    }
-  }
-}
-```
----
-### `require-pr-before-stop`
-**이벤트:** Stop
-**기본값:** 현재 브랜치에 풀 리퀘스트가 없거나 기존 PR이 closed/merged 상태일 때 중단을 차단합니다. `gh pr create`로 PR을 생성하도록 Claude에게 안내합니다.
-파라미터 없음.
-<Note>
-이 정책을 사용하려면 [GitHub CLI](https://cli.github.com/) (`gh`)가 설치되어 있고 인증되어 있어야 합니다.
-풀 리퀘스트 읽기 권한을 위해 `repo` 스코프를 가진 개인 액세스 토큰으로 `gh auth login`을 실행하세요. `gh`가 설치되어 있지 않거나 인증되지 않은 경우, 정책은 fail-open 방식으로 동작하며 그 이유를 Claude에게 보고합니다.
-</Note>
----
-### `require-ci-green-before-stop`
-**이벤트:** Stop
-**기본값:** 현재 브랜치의 CI 검사가 실패하거나 아직 실행 중일 때 중단을 차단합니다. GitHub Actions 워크플로우 실행과 서드파티 봇 검사(예: CodeRabbit, SonarCloud, Codecov) 모두를 확인합니다. `skipped` 및 `cancelled` 결과는 성공으로 처리합니다. 모든 검사가 통과되면 안내 메시지를 반환합니다.
-파라미터 없음.
-<Note>
-이 정책을 사용하려면 [GitHub CLI](https://cli.github.com/) (`gh`)가 설치되어 있고 인증되어 있어야 합니다.
-Actions 워크플로우 실행 및 Checks API에 대한 읽기 권한을 위해 `repo` 스코프를 가진 개인 액세스 토큰으로 `gh auth login`을 실행하세요. `gh`가 설치되어 있지 않거나 인증되지 않은 경우, 정책은 fail-open 방식으로 동작하며 그 이유를 Claude에게 보고합니다.
-</Note>
----
----
-## 개별 정책 비활성화
-설정 파일의 `enabledPolicies`에서 특정 정책을 제거하거나, 대시보드의 Policies 탭에서 해제합니다.
-```json
-{
-  "enabledPolicies": [
-    "block-rm-rf",
-    "sanitize-api-keys"
-  ]
-}
-```
-`enabledPolicies`에 나열되지 않은 정책은 `policyParams` 항목이 존재하더라도 실행되지 않습니다.

package/.next/standalone/docs/ko/cli/dashboard.mdx DELETED Viewed

@@ -1,28 +0,0 @@
----
-title: 세션 보기
-description: "대시보드를 실행하여 에이전트 세션을 탐색하고 정책을 관리합니다"
----
-```bash
-failproofai
-```
-`http://localhost:8020`에서 웹 대시보드를 시작합니다.
-## 옵션
-| 플래그 | 설명 |
-|------|-------------|
-| `--port <number>` | 수신 대기할 포트 (기본값: `8020`) |
-| `--projects-path <path>` | Claude Code 프로젝트 폴더 위치를 재정의합니다 |
-| `--allowed-origins <origins>` | 개발 리소스 접근이 허용된 호스트/IP 목록 (쉼표로 구분) |
-## 예시
-```bash
-# 다른 포트에서 실행
-failproofai --port 9000
-# 커스텀 프로젝트 경로 사용
-failproofai --projects-path ~/my-claude-projects
-```

package/.next/standalone/docs/ko/cli/environment-variables.mdx DELETED Viewed

@@ -1,34 +0,0 @@
----
-title: 환경 변수
-description: "환경 변수를 통한 failproofai 동작 설정"
----
-## 대시보드
-| 변수 | 설명 |
-|----------|-------------|
-| `PORT` | 대시보드 포트 (기본값: `8020`) |
-| `CLAUDE_PROJECTS_PATH` | Claude Code 프로젝트 폴더 위치 재정의 |
-| `FAILPROOFAI_DISABLE_PAGES=policies,projects` | 숨길 대시보드 페이지를 쉼표로 구분하여 지정 |
-| `FAILPROOFAI_ALLOWED_DEV_ORIGINS` | 개발 리소스에 접근을 허용할 호스트/IP. `--allowed-origins`와 동일. |
-## 로깅
-| 변수 | 설명 |
-|----------|-------------|
-| `FAILPROOFAI_LOG_LEVEL=info\|warn\|error` | 서버 로그 레벨 (기본값: `warn`) |
-| `FAILPROOFAI_HOOK_LOG_FILE` | 커스텀 훅 로그 파일 경로, 또는 기본값(`~/.failproofai/logs/hooks.log`)을 사용하려면 `true` |
-## 텔레메트리
-| 변수 | 설명 |
-|----------|-------------|
-| `FAILPROOFAI_TELEMETRY_DISABLED=1` | 익명 사용 텔레메트리 비활성화 |
-## LLM (정책 평가용)
-| 변수 | 설명 |
-|----------|-------------|
-| `FAILPROOFAI_LLM_BASE_URL` | LLM API 엔드포인트 (기본값: `https://api.openai.com/v1`) |
-| `FAILPROOFAI_LLM_API_KEY` | LLM 기반 정책을 위한 API 키 |
-| `FAILPROOFAI_LLM_MODEL` | 모델 이름 (기본값: `gpt-4o-mini`) |

package/.next/standalone/docs/ko/cli/hook.mdx DELETED Viewed

@@ -1,30 +0,0 @@
----
-title: 훅 핸들러 (내부)
-description: "각 도구 이벤트에서 Claude Code가 호출하는 서브프로세스"
----
-```bash
-failproofai --hook <EventType>
-```
-이 명령은 `failproofai policies --install`에 의해 Claude Code의 `settings.json`에 등록됩니다. 일반적으로 직접 호출하지 않습니다.
-stdin에서 JSON 페이로드를 읽고, 활성화된 모든 정책을 평가한 후, 결정을 나타내는 종료 코드와 함께 종료됩니다:
-| 종료 코드 | 결정 | 효과 |
-|-----------|----------|--------|
-| `0` | `allow` | 작업을 허용합니다 |
-| `1` | `deny` | 작업을 차단합니다 - Claude가 거부 이유를 확인합니다 |
-| `2` | `instruct` | Claude의 컨텍스트에 가이던스를 주입합니다 |
-### 지원되는 이벤트 유형
-| 카테고리 | 이벤트 |
-|----------|--------|
-| **도구 실행** | `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, `PermissionDenied` |
-| **세션 생명주기** | `SessionStart`, `SessionEnd`, `Stop`, `StopFailure` |
-| **사용자 상호작용** | `UserPromptSubmit`, `Notification`, `Elicitation`, `ElicitationResult` |
-| **서브에이전트 및 태스크** | `SubagentStart`, `SubagentStop`, `TaskCreated`, `TaskCompleted`, `TeammateIdle` |
-| **구성** | `InstructionsLoaded`, `ConfigChange`, `CwdChanged` |
-| **파일 시스템** | `FileChanged`, `WorktreeCreate`, `WorktreeRemove` |
-| **컨텍스트** | `PreCompact`, `PostCompact` |