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

package/.next/standalone/docs/ru/examples.mdx

@@ -1,309 +0,0 @@
----
-
----
-title: Примеры
-description: "Как настроить hooks для Claude Code и Agents SDK"
-icon: book-open
----
-
-Готовые примеры для распространённых сценариев. Каждый показывает, как установить и что ожидать.
-
----
-
-## Настройка hooks для Claude Code
-
-Failproof AI интегрируется с Claude Code через его [систему hooks](https://docs.anthropic.com/en/docs/claude-code/hooks). Когда вы запускаете `failproofai policies --install`, он регистрирует hook-команды в `settings.json` Claude Code, которые срабатывают при каждом вызове инструмента.
-
-<Steps>
-  <Step title="Установите failproofai">
-    ```bash
-    npm install -g failproofai
-    ```
-  </Step>
-  <Step title="Включите все встроенные политики">
-    ```bash
-    failproofai policies --install
-    ```
-  </Step>
-  <Step title="Проверьте, что hooks зарегистрированы">
-    ```bash
-    cat ~/.claude/settings.json | grep failproofai
-    ```
-
-    Вы должны увидеть записи hook для событий `PreToolUse`, `PostToolUse`, `Notification` и `Stop`.
-  </Step>
-  <Step title="Запустите Claude Code">
-    ```bash
-    claude
-    ```
-
-    Политики теперь выполняются автоматически при каждом вызове инструмента. Попробуйте попросить Claude запустить `sudo rm -rf /` — это будет заблокировано.
-  </Step>
-</Steps>
-
----
-
-## Настройка hooks для Agents SDK
-
-Если вы разрабатываете с использованием [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk), вы можете использовать ту же систему hooks программно.
-
-<Steps>
-  <Step title="Установите failproofai в ваш проект">
-    ```bash
-    npm install failproofai
-    ```
-  </Step>
-  <Step title="Настройте hooks в вашем агенте">
-    Передайте hook-команды при создании процесса агента. Hooks срабатывают так же, как в Claude Code — через stdin/stdout JSON:
-
-    ```bash
-    failproofai --hook PreToolUse   # вызывается перед каждым инструментом
-    failproofai --hook PostToolUse  # вызывается после каждого инструмента
-    ```
-  </Step>
-  <Step title="Напишите пользовательскую политику для вашего агента">
-    ```javascript
-    import { customPolicies, allow, deny } from "failproofai";
-
-    customPolicies.add({
-      name: "limit-to-project-dir",
-      description: "Keep the agent inside the project directory",
-      match: { events: ["PreToolUse"] },
-      fn: async (ctx) => {
-        const path = String(ctx.toolInput?.file_path ?? "");
-        if (path.startsWith("/") && !path.startsWith(ctx.session?.cwd ?? "")) {
-          return deny("Agent is restricted to the project directory");
-        }
-        return allow();
-      },
-    });
-    ```
-  </Step>
-  <Step title="Установите пользовательскую политику">
-    ```bash
-    failproofai policies --install --custom ./my-agent-policies.js
-    ```
-  </Step>
-</Steps>
-
----
-
-## Блокировка деструктивных команд
-
-Наиболее распространённая настройка — предотвратить необратимый ущерб от действий агентов.
-
-```bash
-failproofai policies --install block-sudo block-rm-rf block-force-push block-curl-pipe-sh
-```
-
-Что это делает:
-- `block-sudo` — блокирует все команды `sudo`
-- `block-rm-rf` — блокирует рекурсивное удаление файлов
-- `block-force-push` — блокирует `git push --force`
-- `block-curl-pipe-sh` — блокирует передачу удалённых скриптов в shell
-
----
-
-## Предотвращение утечки секретов
-
-Помешайте агентам видеть или утекать учётные данные в выводе инструментов.
-
-```bash
-failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
-```
-
-Они срабатывают на `PostToolUse` — после запуска инструмента, они скрывают вывод, прежде чем агент его увидит.
-
----
-
-## Получайте оповещения Slack, когда агентам требуется внимание
-
-Используйте notification hook для отправки оповещений об ожидании в Slack.
-
-```javascript
-import { customPolicies, allow, instruct } from "failproofai";
-
-customPolicies.add({
-  name: "slack-on-idle",
-  description: "Alert Slack when the agent is waiting for input",
-  match: { events: ["Notification"] },
-  fn: async (ctx) => {
-    const webhookUrl = process.env.SLACK_WEBHOOK_URL;
-    if (!webhookUrl) return allow();
-
-    const message = String(ctx.payload?.message ?? "Agent is waiting");
-    const project = ctx.session?.cwd ?? "unknown";
-
-    try {
-      await fetch(webhookUrl, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-          text: `*${message}*\nProject: \`${project}\``,
-        }),
-        signal: AbortSignal.timeout(5000),
-      });
-    } catch {
-      // never block the agent if Slack is unreachable
-    }
-
-    return allow();
-  },
-});
-```
-
-Установите это:
-
-```bash
-SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --custom ./slack-alerts.js
-```
-
----
-
-## Держите агентов на одной ветке
-
-Предотвратите переключение веток и отправку на защищённые ветки.
-
-```javascript
-import { customPolicies, allow, deny } from "failproofai";
-
-customPolicies.add({
-  name: "stay-on-branch",
-  description: "Prevent the agent from checking out other branches",
-  match: { events: ["PreToolUse"] },
-  fn: async (ctx) => {
-    if (ctx.toolName !== "Bash") return allow();
-    const cmd = String(ctx.toolInput?.command ?? "");
-    if (/git\s+checkout\s+(?!-b)/.test(cmd)) {
-      return deny("Stay on the current branch. Create a new branch with -b if needed.");
-    }
-    return allow();
-  },
-});
-```
-
----
-
-## Требуйте тесты перед коммитами
-
-Напомните агентам запустить тесты перед коммитом.
-
-```javascript
-import { customPolicies, allow, instruct } from "failproofai";
-
-customPolicies.add({
-  name: "test-before-commit",
-  description: "Remind the agent to run tests before committing",
-  match: { events: ["PreToolUse"] },
-  fn: async (ctx) => {
-    if (ctx.toolName !== "Bash") return allow();
-    const cmd = String(ctx.toolInput?.command ?? "");
-    if (/git\s+commit/.test(cmd)) {
-      return instruct("Run tests before committing. Use `npm test` or `bun test` first.");
-    }
-    return allow();
-  },
-});
-```
-
----
-
-## Заблокируйте production репозиторий
-
-Заколмитьте конфигурацию на уровне проекта, чтобы все разработчики в вашей команде получили одинаковые политики.
-
-Создайте `.failproofai/policies-config.json` в вашем репозитории:
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "block-force-push",
-    "block-push-master",
-    "block-env-files",
-    "sanitize-api-keys",
-    "sanitize-jwt"
-  ],
-  "policyParams": {
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "production"]
-    }
-  }
-}
-```
-
-Затем заколмитьте это:
-
-```bash
-git add .failproofai/policies-config.json
-git commit -m "Add failproofai team policies"
-```
-
-Каждый член команды, у которого установлен failproofai, автоматически получит эти правила.
-
----
-
-## Постройте стандарт качества на уровне организации с политиками соглашения
-
-Наиболее эффективная настройка: заколмитьте `.failproofai/policies/` в ваш репозиторий с политиками, подобранными для вашего проекта. Каждый член команды получит их автоматически — без команд установки, без изменения конфигурации.
-
-<Steps>
-  <Step title="Создайте директорию и добавьте политики">
-    ```bash
-    mkdir -p .failproofai/policies
-    ```
-
-    ```js
-    // .failproofai/policies/team-policies.mjs
-    import { customPolicies, allow, deny, instruct } from "failproofai";
-
-    // Enforce your team's preferred package manager
-    // (or enable the built-in prefer-package-manager policy instead)
-    customPolicies.add({
-      name: "enforce-bun",
-      match: { events: ["PreToolUse"] },
-      fn: async (ctx) => {
-        if (ctx.toolName !== "Bash") return allow();
-        const cmd = String(ctx.toolInput?.command ?? "");
-        if (/\bnpm\b/.test(cmd)) return deny("Use bun instead of npm.");
-        return allow();
-      },
-    });
-
-    // Remind the agent to run tests before committing
-    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"
-    ```
-  </Step>
-  <Step title="Продолжайте совершенствоваться">
-    Когда ваша команда сталкивается с новыми сбоями, добавьте политики и отправьте. Все получат обновление при следующем `git pull`. Эти политики становятся живым стандартом качества, который растёт вместе с вашей командой.
-  </Step>
-</Steps>
-
----
-
-## Другие примеры
-
-Директория [`examples/`](https://github.com/exospherehost/failproofai/tree/main/examples) в репозитории содержит:
-
-| Файл | Что он показывает |
-|------|---------------|
-| `policies-basic.js` | Начальные политики — блокировка записей в production, force-push, передача скриптов |
-| `policies-notification.js` | Оповещения Slack для уведомлений об ожидании и завершения сессии |
-| `policies-advanced/index.js` | Транзитивный импорт, асинхронные hooks, скрубинг вывода PostToolUse, обработка события Stop |

package/.next/standalone/docs/ru/for-agents.mdx

@@ -1,38 +0,0 @@
----
-title: "Для агентов"
-description: "Добавьте справку Failproof AI вашему кодирующему агенту одной командой. Работает с Claude Code, Cursor, Windsurf и другими."
----
-
-Добавьте полную справку Failproof AI вашему кодирующему агенту одной командой. Работает с Claude Code, Cursor, Windsurf и любым другим агентом, поддерживающим навыки.
-
-```bash
-npx skills add https://docs.befailproof.ai
-```
-
-`npx skills` определяет, какие агенты у вас установлены, и автоматически добавляет навык в правильном формате для каждого.
-
-## Что включает навык
-
-| Область | Содержание |
-|------|----------------|
-| Policies | Встроенные имена политик, типы событий, параметры, включение/отключение |
-| Custom policies | `customPolicies.add()`, фильтры совпадений, API `allow`/`deny`/`instruct` |
-| Context object | `ctx.eventType`, `ctx.toolName`, `ctx.toolInput`, `ctx.session` |
-| Configuration | Структура `policies-config.json`, слияние scope, `policyParams` |
-| CLI | `failproofai policies --install`, `--uninstall`, `--custom`, scope |
-| Dashboard | Просмотр сессий, активность политик, переменные окружения |
-| Architecture | Поток обработчика hook, коды выхода, контракт stdin/stdout |
-
-## Полон ли навык?
-
-Mintlify генерирует `llms.txt` из всех страниц в навигации. Документация Failproof AI охватывает полный API - каждая политика, опция и пример включены. Если вы обнаружите что-то отсутствующее, источник находится по адресу `https://docs.befailproof.ai/llms-full.txt`.
-
-Для целевого контекста создавайте ссылку непосредственно на конкретную страницу:
-
-```bash
-# Только API custom policies
-npx skills add https://docs.befailproof.ai/custom-policies
-
-# Только встроенные политики
-npx skills add https://docs.befailproof.ai/built-in-policies
-```

package/.next/standalone/docs/ru/getting-started.mdx

@@ -1,186 +0,0 @@
----
-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
-    ```
-
-    Это добавляет записи hook в файл `settings.json` Claude Code. Вы также можете установить политики для отдельного проекта или выбрать конкретные:
-
-    ```bash
-    failproofai policies --install --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  →  читает JSON из stdin
-                                                 оценивает политики
-                                                 записывает решение в 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-config.json` | Глобальная конфигурация политик |
-| `~/.failproofai/hook-activity.jsonl` | История выполнения hook-ов |
-| `~/.failproofai/hook.log` | Лог отладки для ошибок пользовательских hook-ов |
-| `.failproofai/policies-config.json` | Конфигурация для проекта (добавляется в репозиторий) |
-| `.failproofai/policies-config.local.json` | Личные переопределения (исключено из git) |
-
----
-
-## Удаление
-
-```bash
-failproofai policies --uninstall
-```
-
-Удаляет записи hook из `~/.claude/settings.json`. Файлы конфигурации в `~/.failproofai/` сохраняются.
-
----
-
-## Следующие шаги
-
-<CardGroup cols={2}>
-
-<Card title="Конфигурация" icon="gear" href="/ru/configuration">
-  Области и формат файла конфигурации
-</Card>
-
-<Card title="Встроенные политики" icon="shield" href="/ru/built-in-policies">
-  Все 26 политик с параметрами
-</Card>
-
-<Card title="Пользовательские политики" icon="code" href="/ru/custom-policies">
-  Напишите свои политики на JavaScript
-</Card>
-
-<Card title="Монитор агента" icon="chart-line" href="/ru/dashboard">
-  Мониторьте сессии и просматривайте активность политик
-</Card>
-
-</CardGroup>

package/.next/standalone/docs/ru/introduction.mdx

@@ -1,57 +0,0 @@
----
-title:  Failproof AI
-description: "Управляйте хуками и политиками, которые делают ваших AI агентов надежными и позволяют им работать автономно"
----
-
-[![npm weekly downloads](https://img.shields.io/npm/dw/failproofai?style=flat-square&color=2ea44f)](https://www.npmjs.com/package/failproofai)
-
-Хуки и политики, которые делают ваших AI агентов надежными и позволяют им работать автономно — для **Claude Code** и **Agents SDK**.
-
-AI агенты отказывают предсказуемым образом. Они запускают деструктивные команды, утекают секреты, отклоняются от задачи, застревают в циклах или пушат напрямую в main. Без присмотра небольшие сбои каскадируют.
-
-Failproof AI решает эту проблему с помощью **политик** — правил, которые интегрируются в каждый вызов инструмента агента и могут **обнаруживать сбои**, **смягчать их** (блокировать, инструктировать, санитизировать) и **оповещать вас**, когда требуется внимание. Локальная панель мониторинга позволяет просмотреть всё впоследствии.
-
-Всё работает локально. Никакие данные не покидают вашу машину.
-
-## Начните работу
-
-<CardGroup cols={2}>
-
-<Card title="26 встроенных политик" icon="shield" href="/ru/built-in-policies">
-  Блокируйте деструктивные команды, предотвращайте утечки секретов, удерживайте агентов внутри границ проекта и многое другое — прямо из коробки.
-</Card>
-
-<Card title="Пользовательские политики" icon="code" href="/ru/custom-policies">
-  Напишите свои собственные правила на JavaScript с простым API allow / deny / instruct.
-</Card>
-
-<Card title="Монитор агентов" icon="chart-line" href="/ru/dashboard">
-  Смотрите, что делали ваши агенты, пока вас не было. Просматривайте сессии, проверяйте вызовы инструментов, смотрите, где срабатывали политики.
-</Card>
-
-<Card title="Простая конфигурация" icon="gear" href="/ru/configuration">
-  Настраивайте любую политику без кода. Устанавливайте списки разрешений, защищённые ветки или пороги по проектам или глобально.
-</Card>
-
-</CardGroup>
-
-## Быстрый старт
-
-<CodeGroup>
-
-```bash npm
-npm install -g failproofai
-```
-
-```bash bun
-bun add -g failproofai
-```
-
-</CodeGroup>
-
-```bash
-failproofai policies --install   # enable policies
-failproofai                      # launch the dashboard
-```
-
-Подробное руководство см. в [Getting started](/ru/getting-started).

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

@@ -1,82 +0,0 @@
----
-title: Альтернативные имена пакетов
-description: "Зарегистрированные альтернативные имена для защиты от опечаток и их работа"
-icon: copy
----
-
-## Официальный пакет
-
-Основной npm-пакет — **`failproofai`**:
-
-```bash
-npm install -g failproofai
-# или
-bun add -g failproofai
-```
-
----
-
-## Почему мы владеем альтернативными именами
-
-Typosquatting — это распространённая атака на цепочку поставок, при которой злоумышленник регистрирует имя пакета, отличающееся на один символ от популярного пакета. Невнимательные пользователи, допустившие опечатку в команде установки, в итоге запускают код, контролируемый злоумышленником, с полным доступом к системе — это именно тот вид угрозы, против которого разработана Failproof AI.
-
-Чтобы исключить эту уязвимость, **мы заранее регистрируем все распространённые опечатки и варианты написания** `failproofai` на npm. Ни одно из этих имён не может быть зарегистрировано третьей стороной. Каждое из них — это тонкий прокси, который устанавливает и делегирует работу основному пакету `failproofai`.
-
----
-
-## Зарегистрированные альтернативные имена
-
-**Варианты написания** — разные способы написания "failproof ai":
-
-| Пакет | Статус |
-|---------|--------|
-| `failproof` | ✅ Опубликован |
-| `failproof-ai` | ⏳ Ожидает поддержки npm |
-| `fail-proof-ai` | ⏳ Ожидает поддержки npm |
-| `failproof_ai` | ⏳ Ожидает поддержки npm |
-| `fail_proof_ai` | ⏳ Ожидает поддержки npm |
-| `fail-proofai` | ⏳ Ожидает поддержки npm |
-
-**Опечатки `failprof*`** — пропущена одна буква `o` в слове "proof":
-
-| Пакет | Статус |
-|---------|--------|
-| `failprof` | ✅ Опубликован |
-| `failprof-ai` | ✅ Опубликован |
-| `failprofai` | ⏳ Ожидает поддержки npm |
-| `fail-prof-ai` | ⏳ Ожидает поддержки npm |
-| `failprof_ai` | ⏳ Ожидает поддержки npm |
-
-**Опечатки `faliproof*`** — переставлены буквы `a` и `i`:
-
-| Пакет | Статус |
-|---------|--------|
-| `faliproof` | ✅ Опубликован |
-| `faliproof-ai` | ✅ Опубликован |
-| `faliproofai` | ⏳ Ожидает поддержки npm |
-
-> **Почему в статусе "ожидает"?** Политика npm по защите от спама блокирует имена, которые нормализуются в одну строку с существующим пакетом после удаления пунктуации и проверки сходства. Мы связались с поддержкой npm, чтобы зарезервировать эти имена в целях защиты от typosquatting. Они будут активированы после одобрения.
-
-Вы можете проверить, что любое опубликованное альтернативное имя принадлежит нам:
-
-```bash
-npm info failproof
-# Ищите: "ExosphereHost Inc." в поле maintainers
-```
-
----
-
-## Как работают альтернативные имена
-
-Каждый пакет-альтернатива:
-
-1. Указывает `failproofai` как зависимость — поэтому при установке запускается основной пакет (включая его hook `postinstall`)
-2. Экспортирует бинарный файл с собственным именем (например `failprof-ai`), который пробрасывает все аргументы на бинарный файл `failproofai`
-
-Прокси — это двухстрочный скрипт Node.js; в нём нет никакой логики, сетевых запросов и сбора данных, кроме того, что делает сам `failproofai`.
-
----
-
-## Если мы пропустили какое-то имя
-
-Откройте задачу на [exospherehost/failproofai](https://github.com/exospherehost/failproofai/issues) и мы его зарегистрируем.