failproofai 1.0.1-beta.1 → 1.0.1

package/.next/standalone/docs-old/ko/getting-started.mdx

@@ -0,0 +1,199 @@
+---
+title: 시작하기
+description: "failproofai를 설치하고, 정책을 활성화하여 에이전트를 안정적으로 실행하세요"
+icon: rocket
+---
+
+## 요구사항
+
+- **Node.js** >= 20.9.0
+- **Bun** >= 1.3.0 (선택사항 - 소스에서 빌드할 때만 필요)
+
+---
+
+## 설치
+
+<CodeGroup>
+
+```bash npm
+npm install -g failproofai
+```
+
+```bash bun
+bun add -g failproofai
+```
+
+</CodeGroup>
+
+---
+
+## 빠른 시작
+
+<Steps>
+  <Step title="정책 활성화">
+    정책은 에이전트의 모든 툴 호출 전후에 실행되는 규칙입니다. 파괴적인 명령, 시크릿 유출, 그 외 장애 유형을 피해가 발생하기 전에 사전 차단합니다.
+
+    ```bash
+    failproofai policies --install
+    ```
+
+    이 명령은 설치된 에이전트 CLI에 훅 항목을 기록합니다 (Claude Code의 `~/.claude/settings.json`, OpenAI Codex의 `~/.codex/hooks.json`, GitHub Copilot CLI의 `~/.copilot/hooks/failproofai.json`, Cursor Agent의 `~/.cursor/hooks.json`, OpenCode의 `~/.config/opencode/plugins/failproofai.mjs` 생성 플러그인 심 및 `~/.config/opencode/opencode.json`의 `plugin` 배열에 등록 항목, Pi의 `~/.pi/agent/settings.json`, Hermes의 `~/.hermes/config.yaml`, OpenClaw의 `~/.openclaw/openclaw.json`, Factory Droid의 `~/.factory/hooks.json`, Devin CLI의 `~/.config/devin/config.json`, Antigravity CLI의 `~/.gemini/config/hooks.json`, 또는 Goose의 `~/.agents/plugins/failproofai/hooks/hooks.json` 자동 탐색 플러그인 디렉터리). 두 개 이상 감지되면 선택 프롬프트가 표시됩니다. `--cli claude codex copilot cursor opencode pi hermes openclaw factory devin antigravity goose`(임의 조합)를 전달하면 프롬프트를 건너뜁니다.
+
+    GitHub Copilot CLI, Cursor Agent, OpenCode, Pi는 **베타** 지원입니다 — `--cli copilot`, `--cli cursor`, `--cli opencode`, 또는 `--cli pi`로 설치하세요. Hermes(hermes-agent, Slack/Telegram 게이트웨이)는 `--cli hermes`로 사용자 범위에 설치되며 **오프라인 감사 소스**이기도 합니다. OpenClaw(openclaw 게이트웨이, 셀프호스팅 멀티채널 어시스턴트)는 `--cli openclaw`로 사용자 범위에 설치되고 — 인프로세스 플러그인 훅(`before_agent_finalize`는 실제 턴 종료 게이트이므로 `require-*-before-stop` 내장 정책이 적용됨)을 통해 정책이 실행됩니다 — 역시 **오프라인 감사 소스**입니다. Factory Droid(`droid`)는 `--cli factory`(사용자 + 프로젝트 범위)로 설치되며 **오프라인 감사 소스**이기도 합니다. Devin CLI(`devin`, Cognition)는 `--cli devin`(사용자 + 프로젝트 범위)으로 설치되며 **오프라인 감사 소스**이기도 합니다. Antigravity CLI(`agy`)는 `--cli antigravity`(사용자 + 프로젝트 범위)로 설치되며 **오프라인 감사 소스**이기도 합니다. Goose(코드명 goose, Block)는 `--cli goose`(사용자 + 프로젝트 범위)로 설치됩니다 — 인스톨러가 `~/.agents/plugins/failproofai/`에 플러그인 디렉터리를 생성하면 Goose가 자동으로 감지하며, 역시 **오프라인 감사 소스**입니다.
+
+    ```bash
+    failproofai policies --install --scope project
+    failproofai policies --install --cli codex --scope project
+    failproofai policies --install --cli copilot --scope project
+    failproofai policies --install --cli cursor --scope project
+    failproofai policies --install --cli opencode --scope project
+    failproofai policies --install --cli pi --scope project
+    failproofai policies --install --cli hermes --scope user
+    failproofai policies --install --cli openclaw --scope user
+    failproofai policies --install --cli factory --scope project
+    failproofai policies --install --cli devin --scope project
+    failproofai policies --install --cli antigravity --scope project
+    failproofai policies --install --cli goose --scope project
+    failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
+    ```
+  </Step>
+  <Step title="확인">
+    ```bash
+    failproofai policies
+    ```
+
+    모든 정책과 활성화 여부, 설정된 파라미터를 표시합니다.
+  </Step>
+  <Step title="대시보드 실행">
+    ```bash
+    failproofai
+    ```
+
+    `http://localhost:8020`에서 로컬 대시보드를 열어 세션을 탐색하고, 툴 호출을 검사하며, 정책을 관리할 수 있습니다.
+  </Step>
+  <Step title="에이전트 실행">
+    Claude Code를 평소처럼 시작하세요. 에이전트가 위험한 작업을 시도하면 failproofai가 자동으로 차단합니다. 에이전트를 무인으로 실행한 뒤 대시보드에서 발생한 내용을 검토하세요.
+  </Step>
+</Steps>
+
+---
+
+## 정책 작동 방식
+
+에이전트가 툴을 실행할 때마다 Claude Code는 failproofai를 서브프로세스로 호출합니다.
+
+```text
+Claude Code  →  failproofai --hook PreToolUse  →  reads stdin JSON
+                                                 evaluates policies
+                                                 writes decision to stdout
+```
+
+각 정책은 세 가지 결정 중 하나를 반환합니다.
+
+- **allow** - 에이전트가 정상적으로 진행
+- **deny** - 해당 작업이 차단되고, 에이전트에게 이유가 전달됨
+- **instruct** - 에이전트 프롬프트에 추가 컨텍스트가 삽입됨
+
+<Note>
+정책은 로컬 프로세스에서 실행됩니다. 원격 서비스로 전송되는 데이터는 없습니다.
+</Note>
+
+---
+
+## 컨벤션 기반 정책으로 팀 정책 설정하기
+
+팀 전체에 품질 기준을 빠르게 적용하는 방법은 `.failproofai/policies/` 컨벤션을 활용하는 것입니다. 이 디렉터리에 정책 파일을 넣으면 자동으로 로드됩니다 — 플래그, 설정 변경, 설치 명령이 필요 없습니다.
+
+<Steps>
+  <Step title="정책 디렉터리 생성">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+  </Step>
+  <Step title="정책 파일 추가">
+    예제 파일을 복사하거나 직접 작성하세요.
+
+    ```bash
+    cp node_modules/failproofai/examples/convention-policies/*.mjs .failproofai/policies/
+    ```
+
+    또는 새로 만들기:
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    customPolicies.add({
+      name: "test-before-commit",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
+          return instruct("Run tests before committing.");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="git에 커밋">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Add team quality policies"
+    ```
+
+    failproofai가 설치된 팀원 모두가 이 정책을 자동으로 사용하게 됩니다. 개발자별 별도 설정이 필요 없습니다.
+  </Step>
+</Steps>
+
+<Tip>
+`.failproofai/policies/`를 저장소에 커밋하면 팀 전체가 동일한 기준을 공유합니다. 새로운 장애 유형을 발견할 때마다 정책을 추가하고 푸시하면 모든 팀원이 다음 `git pull` 시 업데이트를 받습니다. 시간이 지날수록 이 정책들은 지속적으로 개선되는 살아있는 품질 기준이 됩니다.
+</Tip>
+
+---
+
+## 데이터 저장소
+
+모든 설정과 로그는 로컬 머신에 저장됩니다.
+
+| 경로 | 저장 내용 |
+|------|----------------|
+| `~/.failproofai/policies/local-policies/policies-config.json` | 전역 정책 설정 |
+| `~/.failproofai/hook-activity/` | 훅 실행 이력 (페이징된 JSONL) |
+| `~/.failproofai/logs/` | 커스텀 훅 오류 디버그 로그 |
+| `.failproofai/policies-config.json` | 프로젝트별 설정 (커밋됨) |
+| `.failproofai/policies-config.local.json` | 개인 오버라이드 (gitignore 처리됨) |
+
+---
+
+## 제거
+
+```bash
+failproofai policies --uninstall
+```
+
+`~/.claude/settings.json`에서 훅 항목을 제거합니다. `~/.failproofai/`의 설정 파일은 유지됩니다.
+
+---
+
+## 다음 단계
+
+<CardGroup cols={2}>
+
+<Card title="설정" icon="gear" href="/ko/configuration">
+  범위(Scope) 및 설정 파일 형식
+</Card>
+
+<Card title="내장 정책" icon="shield" href="/ko/built-in-policies">
+  파라미터를 포함한 26가지 정책 전체 목록
+</Card>
+
+<Card title="커스텀 정책" icon="code" href="/ko/custom-policies">
+  JavaScript로 나만의 정책 작성하기
+</Card>
+
+<Card title="에이전트 모니터" icon="chart-line" href="/ko/dashboard">
+  세션 모니터링 및 정책 활동 검토
+</Card>
+
+</CardGroup>

package/.next/standalone/docs-old/ko/introduction.mdx

@@ -0,0 +1,57 @@
+---
+title: "Failproof AI"
+description: "FailproofAI는 AI 에이전트에 39가지 내장 실패 정책을 제공하여 단 한 번의 설치로 루프, 시크릿 유출, 파괴적인 도구 호출 등을 감지합니다."
+---
+
+[![npm weekly downloads](https://img.shields.io/npm/dw/failproofai?style=flat-square&color=2ea44f)](https://www.npmjs.com/package/failproofai)
+
+**AI 실패 처리**, **오류 복구**, **LLM 안정성**을 위한 훅과 정책 모음입니다. **Claude Code**, **OpenAI Codex**, **GitHub Copilot**, **Cursor Agent**, **OpenCode**, **Pi**, **Hermes**, **OpenClaw**, **Factory Droid**, **Devin CLI**, **Antigravity CLI**, 그리고 **Agents SDK**에서 AI 에이전트를 안정적이고 자율적으로 운영하세요.
+
+AI 에이전트는 예측 가능한 방식으로 실패합니다. 파괴적인 명령을 실행하거나, 시크릿을 유출하거나, 작업 범위를 벗어나거나, 루프에 빠지거나, main 브랜치에 직접 푸시하기도 합니다. 방치하면 사소한 실패가 서비스 장애, 자격 증명 유출, 작업 손실로 이어질 수 있습니다.
+
+FailproofAI는 **정책(policies)**으로 이 문제를 해결합니다. 이 규칙들은 모든 에이전트 도구 호출에 훅으로 연결되어 **실패를 감지**하고, **완화 조치**(차단, 지시, 정제)를 취하며, 주의가 필요한 상황이 발생하면 **알림을 전송**합니다. 로컬 대시보드에서는 모든 도구 호출, 에이전트 실패, 복구 조치를 사후에 검토할 수 있습니다.
+
+트랜스크립트와 정책 평가 결과는 사용자 머신에 저장됩니다. 데이터는 인증된 감사 알림이나 초대 등 온라인 기능을 명시적으로 사용할 때만 전송됩니다.
+
+## 시작하기
+
+<CardGroup cols={2}>
+
+<Card title="39가지 내장 정책" icon="shield" href="/ko/built-in-policies">
+  파괴적인 명령 차단, 시크릿 유출 방지, 에이전트를 프로젝트 경계 내로 제한하는 등 다양한 기능을 즉시 사용할 수 있습니다.
+</Card>
+
+<Card title="커스텀 정책" icon="code" href="/ko/custom-policies">
+  간단한 allow / deny / instruct API를 사용하여 JavaScript로 직접 규칙을 작성하세요.
+</Card>
+
+<Card title="에이전트 모니터" icon="chart-line" href="/ko/dashboard">
+  자리를 비운 사이 에이전트가 무엇을 했는지 확인하세요. 세션 탐색, 도구 호출 검사, 정책이 실행된 위치 검토가 가능합니다.
+</Card>
+
+<Card title="간편한 설정" icon="gear" href="/ko/configuration">
+  코드 없이 어떤 정책이든 조정할 수 있습니다. 프로젝트별 또는 전역으로 허용 목록, 보호 브랜치, 임계값을 설정하세요.
+</Card>
+
+</CardGroup>
+
+## 빠른 시작
+
+<CodeGroup>
+
+```bash npm
+npm install -g failproofai
+```
+
+```bash bun
+bun add -g failproofai
+```
+
+</CodeGroup>
+
+```bash
+failproofai policies --install   # enable policies (or skip — `failproofai` will offer to set them up on first run)
+failproofai                      # launch the dashboard
+```
+
+전체 안내는 [시작 가이드](/ko/getting-started)를 참고하세요.

package/.next/standalone/docs-old/ko/package-aliases.mdx

@@ -0,0 +1,82 @@
+---
+title: 패키지 별칭
+description: "등록된 오타 방지 별칭과 작동 방식"
+icon: copy
+---
+
+## 공식 패키지
+
+npm의 공식 패키지는 **`failproofai`**입니다:
+
+```bash
+npm install -g failproofai
+# or
+bun add -g failproofai
+```
+
+---
+
+## 별칭을 직접 소유하는 이유
+
+타이포스쿼팅(typosquatting)은 공급망 공격의 일반적인 수법으로, 악의적인 행위자가 인기 있는 패키지 이름에서 한 글자만 다른 패키지 이름을 등록합니다. 설치 명령어를 잘못 입력한 사용자는 시스템 전체에 대한 접근 권한을 가진 공격자가 제어하는 코드를 실행하게 됩니다. 이것이 바로 Failproof AI가 방어하도록 설계된 위협 유형입니다.
+
+이러한 취약점을 제거하기 위해, **`failproofai`의 흔한 오타 및 포맷 변형 이름을 모두 npm에 선제적으로 등록**해 두었습니다. 이 이름들은 제3자가 등록할 수 없습니다. 각각은 실제 `failproofai` 패키지를 설치하고 위임하는 얇은 프록시입니다.
+
+---
+
+## 등록된 별칭
+
+**포맷 변형** - "failproof ai"를 표기하는 다양한 방식:
+
+| 패키지 | 상태 |
+|---------|--------|
+| `failproof` | ✅ 게시됨 |
+| `failproof-ai` | ⏳ npm 승인 대기 중 |
+| `fail-proof-ai` | ⏳ npm 승인 대기 중 |
+| `failproof_ai` | ⏳ npm 승인 대기 중 |
+| `fail_proof_ai` | ⏳ npm 승인 대기 중 |
+| `fail-proofai` | ⏳ npm 승인 대기 중 |
+
+**`failprof*` 오타** - "proof"에서 `o` 하나가 빠진 경우:
+
+| 패키지 | 상태 |
+|---------|--------|
+| `failprof` | ✅ 게시됨 |
+| `failprof-ai` | ✅ 게시됨 |
+| `failprofai` | ⏳ npm 승인 대기 중 |
+| `fail-prof-ai` | ⏳ npm 승인 대기 중 |
+| `failprof_ai` | ⏳ npm 승인 대기 중 |
+
+**`faliproof*` 오타** - `a`와 `i`가 뒤바뀐 경우:
+
+| 패키지 | 상태 |
+|---------|--------|
+| `faliproof` | ✅ 게시됨 |
+| `faliproof-ai` | ✅ 게시됨 |
+| `faliproofai` | ⏳ npm 승인 대기 중 |
+
+> **왜 대기 중인가요?** npm의 스팸 방지 정책은 구두점을 제거하고 유사도 검사를 실행했을 때 기존 패키지와 동일한 문자열로 정규화되는 이름의 등록을 차단합니다. 저희는 안티스쿼팅 목적으로 이 이름들을 예약하기 위해 npm 지원팀에 연락했으며, 승인되는 대로 활성화될 예정입니다.
+
+게시된 별칭이 저희 소유인지 확인하실 수 있습니다:
+
+```bash
+npm info failproof
+# Look for: "ExosphereHost Inc." in the maintainers field
+```
+
+---
+
+## 별칭 작동 방식
+
+각 별칭 패키지는 다음과 같이 동작합니다:
+
+1. `failproofai`를 의존성으로 등록하여 실제 패키지가 설치되고 바이너리를 사용할 수 있게 합니다.
+2. 자체 이름(예: `failprof-ai`)과 일치하는 바이너리를 제공하여 모든 인수를 `failproofai` 바이너리에 위임합니다.
+
+프록시는 두 줄짜리 Node 스크립트이며, 로직도 없고 네트워크 호출도 없으며 `failproofai` 자체가 수행하는 것 이외의 데이터 수집도 일절 없습니다.
+
+---
+
+## 누락된 이름을 발견했다면
+
+[failproofai/failproofai](https://github.com/failproofai/failproofai/issues)에 이슈를 열어 주시면 해당 이름을 등록하겠습니다.

package/.next/standalone/docs-old/ko/testing.mdx

@@ -0,0 +1,260 @@
+---
+title: 테스트
+description: "유닛 테스트, E2E 테스트, 테스트 헬퍼"
+icon: flask-vial
+---
+
+failproofai에는 두 가지 테스트 스위트가 있습니다: **유닛 테스트** (빠름, 모킹 사용)와 **엔드투엔드 테스트** (실제 서브프로세스 호출).
+
+---
+
+## 테스트 실행
+
+```bash
+# 유닛 테스트 한 번 실행
+bun run test:run
+
+# 유닛 테스트 워치 모드로 실행
+bun run test
+
+# E2E 테스트 실행 (사전 설정 필요 - 아래 참고)
+bun run test:e2e
+
+# 빌드 없이 타입 검사
+bunx tsc --noEmit
+
+# 린트
+bun run lint
+```
+
+---
+
+## 유닛 테스트
+
+유닛 테스트는 `__tests__/` 디렉토리에 위치하며 `jsdom`과 함께 [Vitest](https://vitest.dev)를 사용합니다.
+
+```text
+__tests__/
+  hooks/
+    builtin-policies.test.ts      # 각 빌트인 정책 로직
+    hooks-config.test.ts          # 설정 로딩 및 스코프 병합
+    policy-evaluator.test.ts      # 파라미터 주입 및 평가 순서
+    custom-hooks-registry.test.ts # globalThis 레지스트리 추가/조회/초기화
+    custom-hooks-loader.test.ts   # ESM 로더, 전이적 임포트, 에러 처리
+    manager.test.ts               # install/remove/list 작업
+  components/
+    sessions-list.test.tsx        # 세션 목록 컴포넌트
+    project-list.test.tsx         # 프로젝트 목록 컴포넌트
+    ...
+  lib/
+    logger.test.ts
+    paths.test.ts
+    date-filters.test.ts
+    telemetry.test.ts
+    ...
+  actions/
+    get-hooks-config.test.ts
+    get-hook-activity.test.ts
+    ...
+  contexts/
+    ThemeContext.test.tsx
+    AutoRefreshContext.test.tsx
+```
+
+### 정책 유닛 테스트 작성하기
+
+```typescript
+import { describe, it, expect, beforeEach } from "vitest";
+import { getBuiltinPolicies } from "../../src/hooks/builtin-policies";
+import { allow, deny } from "../../src/hooks/policy-types";
+
+describe("block-sudo", () => {
+  const policy = getBuiltinPolicies().find((p) => p.name === "block-sudo")!;
+
+  it("denies sudo commands", () => {
+    const ctx = {
+      eventType: "PreToolUse" as const,
+      payload: {},
+      toolName: "Bash",
+      toolInput: { command: "sudo apt install nodejs" },
+      params: { allowPatterns: [] },
+    };
+    expect(policy.fn(ctx)).toEqual(deny("sudo command blocked by failproofai"));
+  });
+
+  it("allows non-sudo commands", () => {
+    const ctx = {
+      eventType: "PreToolUse" as const,
+      payload: {},
+      toolName: "Bash",
+      toolInput: { command: "ls -la" },
+      params: { allowPatterns: [] },
+    };
+    expect(policy.fn(ctx)).toEqual(allow());
+  });
+
+  it("allows patterns in allowPatterns", () => {
+    const ctx = {
+      eventType: "PreToolUse" as const,
+      payload: {},
+      toolName: "Bash",
+      toolInput: { command: "sudo systemctl status nginx" },
+      params: { allowPatterns: ["sudo systemctl status"] },
+    };
+    expect(policy.fn(ctx)).toEqual(allow());
+  });
+});
+```
+
+---
+
+## 엔드투엔드 테스트
+
+E2E 테스트는 실제 `failproofai` 바이너리를 서브프로세스로 호출하고, JSON 페이로드를 stdin으로 파이프한 뒤, stdout 출력과 종료 코드를 검증합니다. 이를 통해 Claude Code가 사용하는 전체 통합 경로를 테스트합니다.
+
+### 설정
+
+E2E 테스트는 레포지토리 소스에서 직접 바이너리를 실행합니다. 최초 실행 전에, 커스텀 훅 파일이 `'failproofai'`에서 임포트할 때 사용하는 CJS 번들을 빌드하세요:
+
+```bash
+bun build src/index.ts --outdir dist --target node --format cjs
+```
+
+이후 테스트를 실행합니다:
+
+```bash
+bun run test:e2e
+```
+
+공개 훅 API (`src/hooks/custom-hooks-registry.ts`, `src/hooks/policy-helpers.ts`, `src/hooks/policy-types.ts`)를 수정할 때마다 `dist/`를 다시 빌드하세요.
+
+### E2E 테스트 구조
+
+```text
+__tests__/e2e/
+  helpers/
+    hook-runner.ts      # 바이너리 실행, 페이로드 JSON 파이프, 종료 코드 + stdout + stderr 캡처
+    fixture-env.ts      # 테스트별 격리된 임시 디렉토리 및 설정 파일
+    payloads.ts         # 각 이벤트 타입별 Claude 호환 페이로드 팩토리
+  hooks/
+    builtin-policies.e2e.test.ts   # 실제 서브프로세스로 각 빌트인 정책 테스트
+    custom-hooks.e2e.test.ts       # 커스텀 훅 로딩 및 평가
+    config-scopes.e2e.test.ts      # 프로젝트/로컬/전역 간 설정 병합
+    policy-params.e2e.test.ts      # 파라미터화된 정책별 파라미터 주입
+```
+
+### E2E 헬퍼 사용하기
+
+**`FixtureEnv`** - 테스트별 격리 환경:
+
+```typescript
+import { createFixtureEnv } from "../helpers/fixture-env";
+
+const env = createFixtureEnv();
+// env.cwd    - 임시 디렉토리; .failproofai/policies-config.json 을 인식하려면 payload.cwd로 전달
+// env.home   - 격리된 홈 디렉토리; 실제 ~/.failproofai 가 유입되지 않음
+
+env.writeConfig({
+  enabledPolicies: ["block-sudo"],
+  policyParams: {
+    "block-sudo": { allowPatterns: ["sudo systemctl status"] },
+  },
+});
+```
+
+`createFixtureEnv()`는 `afterEach` 정리를 자동으로 등록합니다.
+
+**`runHook`** - 바이너리 호출:
+
+```typescript
+import { runHook } from "../helpers/hook-runner";
+import { Payloads } from "../helpers/payloads";
+
+const result = await runHook(
+  "PreToolUse",
+  Payloads.preToolUse.bash("sudo apt install nodejs", env.cwd),
+  { homeDir: env.home }
+);
+
+expect(result.exitCode).toBe(0);
+expect(result.parsed?.hookSpecificOutput?.permissionDecision).toBe("deny");
+```
+
+**`Payloads`** - 미리 만들어진 페이로드 팩토리:
+
+```typescript
+Payloads.preToolUse.bash(command, cwd)
+Payloads.preToolUse.write(filePath, content, cwd)
+Payloads.preToolUse.read(filePath, cwd)
+Payloads.postToolUse.bash(command, output, cwd)
+Payloads.postToolUse.read(filePath, content, cwd)
+Payloads.notification(message, cwd)
+Payloads.stop(cwd)
+```
+
+### E2E 테스트 작성하기
+
+```typescript
+import { describe, it, expect } from "vitest";
+import { createFixtureEnv } from "../helpers/fixture-env";
+import { runHook } from "../helpers/hook-runner";
+import { Payloads } from "../helpers/payloads";
+
+describe("block-rm-rf (E2E)", () => {
+  it("denies rm -rf", async () => {
+    const env = createFixtureEnv();
+    env.writeConfig({ enabledPolicies: ["block-rm-rf"] });
+
+    const result = await runHook(
+      "PreToolUse",
+      Payloads.preToolUse.bash("rm -rf /", env.cwd),
+      { homeDir: env.home }
+    );
+
+    expect(result.exitCode).toBe(0);
+    expect(result.parsed?.hookSpecificOutput?.permissionDecision).toBe("deny");
+  });
+
+  it("allows non-recursive rm", async () => {
+    const env = createFixtureEnv();
+    env.writeConfig({ enabledPolicies: ["block-rm-rf"] });
+
+    const result = await runHook(
+      "PreToolUse",
+      Payloads.preToolUse.bash("rm /tmp/file.txt", env.cwd),
+      { homeDir: env.home }
+    );
+
+    expect(result.exitCode).toBe(0);
+    expect(result.stdout).toBe("");  // allow → 빈 stdout
+  });
+});
+```
+
+### E2E 응답 형태
+
+| 결정 | 종료 코드 | stdout |
+|----------|-----------|--------|
+| `PreToolUse` deny | `0` | `{"hookSpecificOutput":{"permissionDecision":"deny","permissionDecisionReason":"..."}}` |
+| `PostToolUse` deny | `0` | `{"hookSpecificOutput":{"additionalContext":"Blocked ... because: ..."}}` |
+| Instruct (Stop 제외) | `0` | `{"hookSpecificOutput":{"additionalContext":"Instruction from failproofai: ..."}}` |
+| Stop instruct | `2` | stdout 비어 있음; 이유는 stderr에 출력 |
+| Allow | `0` | 빈 문자열 |
+
+### Vitest 설정
+
+E2E 테스트는 `vitest.config.e2e.mts`를 사용하며 다음과 같이 구성됩니다:
+
+- `environment: "node"` - 브라우저 전역 변수 불필요
+- `pool: "forks"` - 진정한 프로세스 격리 (테스트가 서브프로세스를 생성)
+- `testTimeout: 20_000` - 테스트당 20초 (바이너리 시작 + 훅 평가)
+
+`forks` 풀은 중요합니다: 스레드 기반 워커는 `globalThis`를 공유하므로 서브프로세스를 생성하는 테스트에 간섭이 발생할 수 있습니다. 프로세스 기반 포크는 이 문제를 방지합니다.
+
+---
+
+## CI
+
+머지 전에 전체 CI 실행 (`bun run lint && bunx tsc --noEmit && bun run test:run && bun run build`)이 통과되어야 합니다. E2E 스위트는 별도의 CI 작업으로 병렬 실행됩니다.
+
+완전한 머지 전 체크리스트는 [Contributing](../CONTRIBUTING.md)을 참고하세요.

package/.next/standalone/docs-old/package-aliases.mdx

@@ -0,0 +1,82 @@
+---
+title: Package Aliases
+description: "Registered typosquat-prevention aliases and how they work"
+icon: copy
+---
+
+## Official package
+
+The canonical npm package is **`failproofai`**:
+
+```bash
+npm install -g failproofai
+# or
+bun add -g failproofai
+```
+
+---
+
+## Why we own the alias names
+
+Typosquatting is a common supply-chain attack where a malicious actor registers a package name that is one keystroke away from a popular package. Unsuspecting users who mistype the install command end up running attacker-controlled code with full system access - exactly the kind of threat Failproof AI is designed to defend against.
+
+To eliminate this surface, **we pre-emptively own all common misspellings and formatting variants** of `failproofai` on npm. None of these names can be registered by a third party. Each one is a thin proxy that installs and delegates to the real `failproofai` package.
+
+---
+
+## Registered aliases
+
+**Formatting variants** - different ways to write "failproof ai":
+
+| Package | Status |
+|---------|--------|
+| `failproof` | ✅ Published |
+| `failproof-ai` | ⏳ Pending npm support |
+| `fail-proof-ai` | ⏳ Pending npm support |
+| `failproof_ai` | ⏳ Pending npm support |
+| `fail_proof_ai` | ⏳ Pending npm support |
+| `fail-proofai` | ⏳ Pending npm support |
+
+**`failprof*` typos** - missing one `o` from "proof":
+
+| Package | Status |
+|---------|--------|
+| `failprof` | ✅ Published |
+| `failprof-ai` | ✅ Published |
+| `failprofai` | ⏳ Pending npm support |
+| `fail-prof-ai` | ⏳ Pending npm support |
+| `failprof_ai` | ⏳ Pending npm support |
+
+**`faliproof*` typos** - transposed `a` and `i`:
+
+| Package | Status |
+|---------|--------|
+| `faliproof` | ✅ Published |
+| `faliproof-ai` | ✅ Published |
+| `faliproofai` | ⏳ Pending npm support |
+
+> **Why pending?** npm's spam-prevention policy blocks names that normalize to the same string as an existing package after stripping punctuation and running similarity checks. We have contacted npm support to reserve these names for anti-squatting purposes. They will be activated once approved.
+
+You can verify any published alias is owned by us:
+
+```bash
+npm info failproof
+# Look for: "ExosphereHost Inc." in the maintainers field
+```
+
+---
+
+## How the aliases work
+
+Each alias package:
+
+1. Lists `failproofai` as a dependency - so the real package is installed and its binary becomes available
+2. Exposes a binary matching its own name (e.g. `failprof-ai`) that proxies all arguments to the `failproofai` binary
+
+The proxy is a two-line Node script; there is no logic, no network calls, and no data collection beyond what `failproofai` itself does.
+
+---
+
+## If you find a name we missed
+
+Open an issue at [failproofai/failproofai](https://github.com/failproofai/failproofai/issues) and we will register it.