failproofai 0.0.6-beta.2 → 0.0.6-beta.4

package/.next/standalone/docs/ru/cli/install-policies.mdx

@@ -1,48 +0,0 @@
----
----
-title: Установка политик
-description: "Включите политики для их выполнения при каждом вызове инструмента агентом"
----
-
-```bash
-failproofai policies --install [policy-names...] [options]
-```
-
-Записывает записи хука в `settings.json` Claude Code, чтобы failproofai перехватывал вызовы инструментов.
-
-Синонимы: `failproofai p -i`
-
-## Опции
-
-| Флаг | Описание |
-|------|-------------|
-| `--scope user` | Установить в `~/.claude/settings.json` (по умолчанию - все сеансы) |
-| `--scope project` | Установить в `.claude/settings.json` в текущей директории |
-| `--scope local` | Установить в `.claude/settings.local.json` в текущей директории |
-| `--custom <path>` / `-c` | Путь к JS-файлу с пользовательскими хук-политиками |
-
-## Поведение
-
-- **Без названий политик** - открывает интерактивное меню для выбора политик
-- **Конкретные названия** - включает указанные политики (добавляет их к уже включённым)
-- **`all`** - включает все доступные политики
-
-Установка является дополнительной: повторный запуск `--install` добавляет новые политики без удаления существующих.
-
-## Примеры
-
-```bash
-# Установить все политики по умолчанию глобально (интерактивно)
-failproofai policies --install
-
-# Установить конкретные политики для текущего проекта
-failproofai policies --install block-sudo sanitize-api-keys --scope project
-
-# Включить все политики сразу
-failproofai policies --install all
-
-# Установить с пользовательским файлом политик
-failproofai policies --install --custom ./my-policies.js
-```
-
-Когда указан `--custom <path>`, файл проверяется немедленно - он должен вызвать `customPolicies.add()` хотя бы один раз. Разрешённый путь сохраняется в `policies-config.json` как `customPoliciesPath`.

package/.next/standalone/docs/ru/cli/list-policies.mdx

@@ -1,32 +0,0 @@
----
----
-title: Список политик
-description: "Посмотрите, какие политики включены, их параметры и пользовательские политики"
----
-
-```bash
-failproofai policies
-```
-
-Показывает все политики с их статусом, настроенными параметрами и пользовательскими политиками.
-
-## Пример вывода
-
-```text
-Failproof AI Hook Policies (user)
-
-  Status  Name                          Description
-  ──────  ──────────────────────────────────────────────────────────────
-  ✓       block-sudo                    Block sudo commands
-            allowPatterns: ["sudo systemctl status"]
-  ✓       block-rm-rf                   Block recursive deletions
-  ✗       block-curl-pipe-sh            Block curl|bash patterns
-  ✓       sanitize-api-keys             Redact API keys from output
-            additionalPatterns: [{ regex: "MY_TOKEN_...", label: "..." }]
-
-  ── Custom Policies (/home/alice/myproject/my-policies.js) ──────────────
-  ✓       require-jira-ticket           Block commits without ticket
-  ✓       approval-gate                 Approval gate for destructive ops
-```
-
-Неизвестные ключи в `policyParams` здесь помечаются, чтобы вы могли рано поймать опечатки.

package/.next/standalone/docs/ru/cli/remove-policies.mdx

@@ -1,43 +0,0 @@
----
-title: Удаление политик
-description: "Удаление записей hook из settings Claude Code"
----
-
-```bash
-failproofai policies --uninstall [policy-names...] [options]
-```
-
-Удаляет записи failproofai hook из `settings.json` Claude Code.
-
-Альтернативные команды: `failproofai p -u`
-
-## Опции
-
-| Флаг | Описание |
-|------|-------------|
-| `--scope user` | Удалить из глобальных параметров (по умолчанию) |
-| `--scope project` | Удалить из параметров проекта |
-| `--scope local` | Удалить из локальных параметров |
-| `--scope all` | Удалить из всех областей одновременно |
-| `--custom` / `-c` | Очистить `customPoliciesPath` из конфига |
-
-## Поведение
-
-- **Без имён политик** - удаляет все записи failproofai hook из файла параметров
-- **С конкретными именами** - отключает эти политики, но сохраняет установленные hook
-
-## Примеры
-
-```bash
-# Удалить все hook глобально
-failproofai policies --uninstall
-
-# Отключить определённую политику (сохраняя установленные hook)
-failproofai policies --uninstall block-sudo
-
-# Удалить hook из всех областей
-failproofai policies --uninstall --scope all
-
-# Очистить путь к пользовательским политикам
-failproofai policies --uninstall --custom
-```

package/.next/standalone/docs/ru/cli/version.mdx

@@ -1,12 +0,0 @@
----
-title: Проверка версии
-description: "Вывести установленную версию failproofai"
----
-
-```bash
-failproofai --version
-# or
-failproofai -v
-```
-
-Выводит номер установленной версии.

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

@@ -1,222 +0,0 @@
----
-title: Конфигурация
-description: "Формат файла конфигурации, система трёх областей и правила слияния"
-icon: gear
----
-
-failproofai использует JSON-файлы конфигурации для управления активными политиками, их поведением и местом загрузки пользовательских политик. Конфигурация разработана так, чтобы её было легко делиться с командой — достаточно добавить её в репозиторий, и каждый разработчик получит одинаковую защиту агента.
-
----
-
-## Области конфигурации
-
-Существует три области конфигурации, оцениваемые в порядке приоритета:
-
-| Область | Путь к файлу | Назначение |
-|---------|--------------|-----------|
-| **project** | `.failproofai/policies-config.json` | Параметры репозитория, коммитятся в контроль версий |
-| **local** | `.failproofai/policies-config.local.json` | Личные переопределения для конкретного репозитория, в .gitignore |
-| **global** | `~/.failproofai/policies-config.json` | Параметры уровня пользователя для всех проектов |
-
-Когда failproofai получает событие хука, он загружает и объединяет все три файла, которые существуют для текущей рабочей директории.
-
-### Правила слияния
-
-**`enabledPolicies`** — объединение всех трёх областей. Политика, активированная на любом уровне, становится активной.
-
-```text
-project:  ["block-sudo"]
-local:    ["block-rm-rf"]
-global:   ["block-sudo", "sanitize-api-keys"]
-
-resolved: ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← дедублицированное объединение
-```
-
-**`policyParams`** — первая область, которая определяет параметры для данной политики, побеждает полностью. Глубокого слияния значений внутри параметров политики не происходит.
-
-```text
-project:  block-sudo → { allowPatterns: ["sudo apt-get update"] }
-global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
-
-resolved: { allowPatterns: ["sudo apt-get update"] }   ← project побеждает, global игнорируется
-```
-
-```text
-project:  (нет входа block-sudo)
-local:    (нет входа block-sudo)
-global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
-
-resolved: { allowPatterns: ["sudo systemctl status"] }  ← переходит на global
-```
-
-**`customPoliciesPath`** — первая область, которая определяет его, побеждает.
-
-**`llm`** — первая область, которая определяет его, побеждает.
-
----
-
-## Формат файла конфигурации
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "block-push-master",
-    "sanitize-api-keys",
-    "sanitize-jwt",
-    "block-env-files",
-    "block-read-outside-cwd"
-  ],
-  "policyParams": {
-    "block-sudo": {
-      "allowPatterns": ["sudo systemctl status", "sudo journalctl"]
-    },
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "prod"]
-    },
-    "block-rm-rf": {
-      "allowPaths": ["/tmp"]
-    },
-    "block-read-outside-cwd": {
-      "allowPaths": ["/shared/data", "/opt/company"]
-    },
-    "sanitize-api-keys": {
-      "additionalPatterns": [
-        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API key" }
-      ]
-    },
-    "warn-large-file-write": {
-      "thresholdKb": 512
-    }
-  },
-  "customPoliciesPath": "/home/alice/myproject/my-policies.js"
-}
-```
-
----
-
-## Справочник полей
-
-### `enabledPolicies`
-
-Тип: `string[]`
-
-Список имён политик для активации. Имена должны точно совпадать с идентификаторами политик, показываемыми `failproofai policies`. Полный список смотрите в разделе [Встроенные политики](/ru/built-in-policies).
-
-Политики, отсутствующие в `enabledPolicies`, неактивны, даже если они имеют записи в `policyParams`.
-
-### `policyParams`
-
-Тип: `Record<string, Record<string, unknown>>`
-
-Переопределения параметров для отдельных политик. Внешний ключ — это имя политики; внутренние ключи специфичны для политики. Каждая политика описывает свои доступные параметры в разделе [Встроенные политики](/ru/built-in-policies).
-
-Если политика имеет параметры, но вы их не указали, используются встроенные значения по умолчанию. Пользователи, которые вообще не настраивают `policyParams`, получат идентичное поведение предыдущим версиям.
-
-Неизвестные ключи внутри блока параметров политики молча игнорируются при срабатывании хука, но флагируются как предупреждения при запуске `failproofai policies`.
-
-#### `hint` (сквозной)
-
-Тип: `string` (опционально)
-
-Сообщение, добавляемое к причине, когда политика возвращает `deny` или `instruct`. Используйте его, чтобы дать Claude действенное руководство без изменения самой политики.
-
-Работает с любым типом политик — встроенными, пользовательскими (`custom/`), соглашениями проекта (`.failproofai-project/`) или соглашениями пользователя (`.failproofai-user/`).
-
-```json
-{
-  "policyParams": {
-    "block-force-push": {
-      "hint": "Попробуйте создать новую ветку вместо этого."
-    },
-    "block-sudo": {
-      "allowPatterns": ["sudo apt-get"],
-      "hint": "Используйте apt-get напрямую без sudo."
-    },
-    "custom/my-policy": {
-      "hint": "Сначала получите одобрение у пользователя."
-    }
-  }
-}
-```
-
-Когда `block-force-push` отклоняет, Claude видит: *"Force-pushing заблокирован. Попробуйте создать новую ветку вместо этого."*
-
-Значения, не являющиеся строками, и пустые строки молча игнорируются. Если `hint` не задан, поведение не меняется (обратная совместимость).
-
-### `customPoliciesPath`
-
-Тип: `string` (абсолютный путь)
-
-Путь к JavaScript-файлу, содержащему пользовательские политики хука. Этот параметр устанавливается автоматически командой `failproofai policies --install --custom <path>` (путь разрешается к абсолютному перед сохранением).
-
-Файл загружается заново при каждом срабатывании хука — кэширования нет. Подробности разработки смотрите в разделе [Пользовательские политики](/ru/custom-policies).
-
-### Политики на основе соглашений
-
-В дополнение к явному `customPoliciesPath` failproofai автоматически обнаруживает и загружает файлы политик из директорий `.failproofai/policies/`:
-
-| Уровень | Директория | Область |
-|---------|-----------|---------|
-| Проект | `.failproofai/policies/` | Совместное использование с командой через контроль версий |
-| Пользователь | `~/.failproofai/policies/` | Личные, применяются ко всем проектам |
-
-**Соответствие файлов:** Загружаются только файлы, соответствующие шаблону `*policies.{js,mjs,ts}` (например `security-policies.mjs`, `workflow-policies.js`). Другие файлы в директории игнорируются.
-
-**Конфигурация не требуется:** Политики на основе соглашений не требуют записей в `policies-config.json`. Просто поместите файлы в директорию, и они будут загружены при следующем срабатывании хука.
-
-**Объединённая загрузка:** Сканируются обе директории соглашений — проекта и пользователя. Все подходящие файлы с обоих уровней загружаются (в отличие от `customPoliciesPath`, который использует первый-побеждает).
-
-Подробности и примеры смотрите в разделе [Пользовательские политики](/ru/custom-policies).
-
-### `llm`
-
-Тип: `object` (опционально)
-
-Конфигурация LLM-клиента для политик, которые выполняют вызовы AI. Не требуется для большинства конфигураций.
-
-```json
-{
-  "llm": {
-    "model": "claude-sonnet-4-6",
-    "apiKey": "sk-ant-..."
-  }
-}
-```
-
----
-
-## Управление конфигурацией из CLI
-
-Команды `policies --install` и `policies --uninstall` записывают в `settings.json` Claude Code (точки входа хука), а `policies-config.json` — это файл, которым вы управляете напрямую. Это два разных файла:
-
-- **`settings.json`** — говорит Claude Code вызывать `failproofai --hook <event>` при каждом использовании инструмента
-- **`policies-config.json`** — говорит failproofai, какие политики оценивать и с какими параметрами
-
-Вы можете редактировать `policies-config.json` напрямую в любой момент; изменения вступают в силу сразу же при следующем срабатывании хука без необходимости перезагрузки.
-
----
-
-## Пример: конфигурация уровня проекта с командными параметрами по умолчанию
-
-Добавьте `.failproofai/policies-config.json` в свой репозиторий:
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "block-push-master",
-    "sanitize-api-keys",
-    "block-env-files"
-  ],
-  "policyParams": {
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "hotfix"]
-    }
-  }
-}
-```
-
-Затем каждый разработчик может создать `.failproofai/policies-config.local.json` (в .gitignore) для личных переопределений без влияния на коллег.