failproofai 0.0.5 → 0.0.6-beta.1

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

@@ -1,12 +1,11 @@
 ---
-
 ---
 title: Архитектура
-description: "Как работают обработчик хука, загрузка конфигурации и оценка политик"
+description: "Как работают обработчик хуков, загрузка конфига и оценка политик"
 icon: sitemap
 ---
 
-В этом документе объясняется, как failproofai работает внутренне: как система хуков перехватывает вызовы инструментов агента, как загружается и объединяется конфигурация, как оцениваются политики и как панель мониторинга отслеживает активность агента.
+Этот документ объясняет, как работает failproofai изнутри: как система хуков перехватывает вызовы инструментов агента, как загружается и объединяется конфигурация, как оцениваются политики и как панель мониторинга отслеживает активность агента.
 
 ---
 
@@ -14,18 +13,18 @@ icon: sitemap
 
 failproofai состоит из двух независимых подсистем:
 
-1. **Обработчик хука** — быстрый CLI подпроцесс, который Claude Code вызывает при каждом вызове инструмента агента. Оценивает политики и возвращает решение.
-2. **Agent Monitor (Dashboard)** — веб-приложение Next.js для мониторинга сеансов агента и управления политиками.
+1. **Hook handler** — быстрый CLI подпроцесс, который Claude Code вызывает при каждом вызове инструмента агента. Оценивает политики и возвращает решение.
+2. **Agent Monitor (Dashboard)** — веб-приложение Next.js для мониторинга сессий агента и управления политиками.
 
-Обе подсистемы совместно используют файлы конфигурации в `~/.failproofai/` и в директории `.failproofai/` проекта, но работают как отдельные процессы и общаются только через файловую систему.
+Обе подсистемы совместно используют файлы конфигурации в `~/.failproofai/` и в директории проекта `.failproofai/`, но работают как отдельные процессы и взаимодействуют только через файловую систему.
 
 ---
 
-## Обработчик хука
+## Hook handler
 
 ### Интеграция с Claude Code
 
-Когда вы запускаете `failproofai policies --install`, в `~/.claude/settings.json` добавляются записи следующего вида:
+Когда вы запускаете `failproofai policies --install`, он записывает записи подобно этой в `~/.claude/settings.json`:
 
 ```json
 {
@@ -46,7 +45,7 @@ failproofai состоит из двух независимых подсисте
 }
 ```
 
-Затем Claude Code вызывает `failproofai --hook PreToolUse` как подпроцесс перед каждым вызовом инструмента, передавая JSON-полезную нагрузку на stdin.
+Claude Code затем вызывает `failproofai --hook PreToolUse` как подпроцесс перед каждым вызовом инструмента, передавая JSON-полезную нагрузку на stdin.
 
 ### Формат полезной нагрузки
 
@@ -62,13 +61,13 @@ failproofai состоит из двух независимых подсисте
 }
 ```
 
-Для событий `PostToolUse` полезная нагрузка также содержит `tool_result` с выходом инструмента.
+Для событий `PostToolUse` полезная нагрузка также содержит `tool_result` с результатом работы инструмента.
 
-Обработчик устанавливает ограничение входного потока в 1 МБ. Полезные нагрузки, превышающие этот лимит, отбрасываются и все политики неявно разрешают операцию.
+Обработчик устанавливает лимит stdin в 1 МБ. Полезные нагрузки, превышающие этот лимит, отбрасываются и все политики неявно разрешают операцию.
 
 ### Формат ответа
 
-**Отклонить (PreToolUse):**
+**Deny (PreToolUse):**
 ```json
 {
   "hookSpecificOutput": {
@@ -78,7 +77,7 @@ failproofai состоит из двух независимых подсисте
 }
 ```
 
-**Отклонить (PostToolUse):**
+**Deny (PostToolUse):**
 ```json
 {
   "hookSpecificOutput": {
@@ -87,7 +86,7 @@ failproofai состоит из двух независимых подсисте
 }
 ```
 
-**Инструкция (любое событие кроме Stop):**
+**Instruct (любое событие, кроме Stop):**
 ```json
 {
   "hookSpecificOutput": {
@@ -96,20 +95,20 @@ failproofai состоит из двух независимых подсисте
 }
 ```
 
-**Инструкция события Stop:**
+**Instruct для события Stop:**
 - Код выхода: `2`
-- Причина записана в stderr (не stdout)
+- Причина выводится в stderr (не в stdout)
 
-**Разрешить:**
+**Allow:**
 - Код выхода: `0`
 - Пустой stdout
 
-**Разрешить с сообщением:**
+**Allow с сообщением:**
 
-`allow(message)` позволяет политике отправить контекстную информацию в Claude, даже если операция разрешена. Обработчик хука записывает в **stdout** следующий JSON (не в файл конфигурации — это ответ обработчика на Claude Code, как и ответы deny и instruct выше):
+`allow(message)` позволяет политике отправлять информационный контекст обратно в Claude даже когда операция разрешена. Обработчик хуков записывает следующий JSON в **stdout** (не в файл конфига — это ответ обработчика для Claude Code, как и ответы deny и instruct выше):
 
 ```json
-// Written to stdout by the hook handler process
+// Написано в stdout процессом обработчика хуков
 {
   "hookSpecificOutput": {
     "additionalContext": "All CI checks passed on branch 'feat/my-feature'."
@@ -117,8 +116,8 @@ failproofai состоит из двух независимых подсисте
 }
 ```
 - Код выхода: `0` (операция разрешена)
-- Когда несколько политик возвращают `allow` с сообщением, их сообщения объединяются с переносами строк в единую строку `additionalContext`
-- Если ни одна политика не предоставляет сообщение, stdout остается пустым (как раньше)
+- Когда несколько политик возвращают `allow` с сообщением, их сообщения объединяются с переводами строк в один string `additionalContext`
+- Если ни одна политика не предоставляет сообщение, stdout пуст (как и раньше)
 
 ### Конвейер обработки
 
@@ -147,7 +146,7 @@ stdin JSON
 
 ## Загрузка конфигурации
 
-`src/hooks/hooks-config.ts` реализует загрузку конфигурации с тремя областями видимости.
+`src/hooks/hooks-config.ts` реализует загрузку конфигурации в трёх областях.
 
 ```text
 [1] {cwd}/.failproofai/policies-config.json        ← project  (highest priority)
@@ -156,12 +155,12 @@ stdin JSON
 ```
 
 Логика объединения:
-- `enabledPolicies` — объединение всех трех файлов без дубликатов
-- `policyParams` — на политику, первый файл, который ее определяет, полностью выигрывает
-- `customPoliciesPath` — первый файл, который его определяет, выигрывает
-- `llm` — первый файл, который его определяет, выигрывает
+- `enabledPolicies` — дедублицированное объединение всех трёх файлов
+- `policyParams` — по ключу политики, первый файл, который его определяет, получает полный приоритет
+- `customPoliciesPath` — первый файл, который его определяет, получает приоритет
+- `llm` — первый файл, который его определяет, получает приоритет
 
-Веб-панель мониторинга использует `readHooksConfig()` (только глобальная) для чтения и записи, так как она не вызывается с рабочей директорией проекта.
+Веб-панель использует `readHooksConfig()` (только глобальный) для чтения и записи, поскольку она вызывается без cwd проекта.
 
 ---
 
@@ -171,18 +170,18 @@ stdin JSON
 
 Для каждой политики:
 
-1. Найти схему `params` политики (если она существует).
-2. Прочитать `policyParams[policy.name]` из объединенной конфигурации.
-3. Объединить предоставленные пользователем значения со значениями по умолчанию из схемы, создав `ctx.params`.
-4. Вызвать `policy.fn(ctx)` с разрешенным контекстом.
-5. Если результат — `deny`, остановиться немедленно и вернуть это решение.
-6. Если результат — `instruct`, накопить сообщение и продолжить.
-7. Если результат — `allow`, перейти к следующей политике.
+1. Поиск схемы `params` политики (если она есть).
+2. Чтение `policyParams[policy.name]` из объединённой конфигурации.
+3. Объединение предоставленных пользователем значений со значениями по умолчанию из схемы для создания `ctx.params`.
+4. Вызов `policy.fn(ctx)` с разрешённым контекстом.
+5. Если результат `deny`, остановиться немедленно и вернуть это решение.
+6. Если результат `instruct`, накопить сообщение и продолжить.
+7. Если результат `allow`, перейти к следующей политике.
 
-После запуска всех политик:
-- Если было возвращено какое-либо `deny`, выдать ответ deny.
-- Если были собраны возвращаемые значения `instruct`, выдать единый ответ instruct со всеми объединенными сообщениями.
-- В противном случае выдать ответ allow (пустой stdout, выход 0).
+После выполнения всех политик:
+- Если была возвращена какая-либо `deny`, вывести ответ deny.
+- Если были собраны какие-либо `instruct`, вывести один ответ instruct со всеми объединёнными сообщениями.
+- В противном случае вывести ответ allow (пустой stdout, выход 0).
 
 ---
 
@@ -206,15 +205,15 @@ interface BuiltinPolicyDefinition {
 }
 ```
 
-Политики, которые принимают `params`, объявляют `PolicyParamsSchema` с типами и значениями по умолчанию для каждого параметра. Оценщик политик вводит разрешенные значения в `ctx.params` перед вызовом `fn`. Функции политик читают `ctx.params` без проверки null, потому что значения по умолчанию всегда применяются в первую очередь.
+Политики, которые принимают `params`, объявляют `PolicyParamsSchema` с типами и значениями по умолчанию для каждого параметра. Оценщик политик внедряет разрешённые значения в `ctx.params` перед вызовом `fn`. Функции политик читают `ctx.params` без проверки на null, поскольку значения по умолчанию всегда применяются в первую очередь.
 
-Сопоставление шаблонов внутри политик использует разобранные токены команд (argv), а не сопоставление сырых строк. Это предотвращает обход путем инъекции оператора оболочки (например, шаблон для `sudo systemctl status *` не может быть обойден путем добавления `; rm -rf /` к команде).
+Сопоставление шаблонов внутри политик использует разобранные токены команды (argv), а не простое совпадение строк. Это предотвращает обход с помощью инъекции оператора оболочки (например, шаблон для `sudo systemctl status *` не может быть обойден путём добавления `; rm -rf /` к команде).
 
 ---
 
 ## Пользовательские политики
 
-`src/hooks/custom-hooks-registry.ts` реализует реестр на основе `globalThis`:
+`src/hooks/custom-hooks-registry.ts` реализует реестр, поддерживаемый `globalThis`:
 
 ```typescript
 const REGISTRY_KEY = "__failproofai_custom_hooks__";
@@ -229,17 +228,17 @@ export function clearCustomHooks(): void { ... }  // used in tests
 
 `src/hooks/custom-hooks-loader.ts` загружает файл политики пользователя:
 
-1. Прочитать `customPoliciesPath` из конфигурации; пропустить, если отсутствует.
-2. Разрешить абсолютный путь; проверить, что файл существует.
-3. Переписать все импорты `from "failproofai"` на фактический путь dist, чтобы `customPolicies` разрешался к тому же реестру `globalThis`.
-4. Рекурсивно переписать переходные локальные импорты, чтобы обеспечить совместимость ESM.
-5. Написать временные файлы `.mjs` и `import()` файл входа.
-6. Вызвать `getCustomHooks()`, чтобы получить зарегистрированные хуки.
-7. Очистить все временные файлы в блоке `finally`.
+1. Чтение `customPoliciesPath` из конфигурации; пропуск, если отсутствует.
+2. Разрешение в абсолютный путь; проверка существования файла.
+3. Переписывание всех импортов `from "failproofai"` на фактический путь dist, чтобы `customPolicies` разрешался в одинаковый реестр `globalThis`.
+4. Рекурсивное переписывание переходных локальных импортов для обеспечения совместимости ESM.
+5. Запись временных файлов `.mjs` и `import()` файла входа.
+6. Вызов `getCustomHooks()` для получения зарегистрированных хуков.
+7. Очистка всех временных файлов в блоке `finally`.
 
 При любой ошибке (файл не найден, синтаксическая ошибка, ошибка импорта) ошибка регистрируется в `~/.failproofai/hook.log` и загрузчик возвращает пустой массив. Встроенные политики не затрагиваются.
 
-Пользовательские политики оцениваются после всех встроенных политик. `deny` пользовательской политики по-прежнему прерывает дальнейшие пользовательские политики (но все встроенные уже запустились к этому моменту).
+Пользовательские политики оцениваются после всех встроенных политик. Пользовательская политика `deny` по-прежнему прерывает дальнейшие пользовательские политики (но к тому моменту все встроенные уже выполнены).
 
 ---
 
@@ -260,13 +259,13 @@ export function clearCustomHooks(): void { ... }  // used in tests
 }
 ```
 
-Одна строка на каждую политику, которая приняла решение, отличное от allow. Решения allow не регистрируются (чтобы файл оставался маленьким).
+По одной строке на каждую политику, которая приняла решение, отличное от allow. Решения allow не регистрируются (чтобы держать файл в разумном размере).
 
 ---
 
-## Архитектура панели мониторинга
+## Архитектура панели
 
-Панель мониторинга — это приложение **Next.js 16**, использующее App Router с React Server Components и Server Actions.
+Панель — это приложение **Next.js 16** с использованием App Router, React Server Components и Server Actions.
 
 ```text
 app/
@@ -288,16 +287,16 @@ app/
 
 **Поток данных:**
 
-- Компоненты страниц вызывают `lib/projects.ts` и `lib/log-entries.ts` для чтения данных проекта/сеанса непосредственно из файловой системы (без слоя API для операций чтения).
-- Страница Policies использует Server Actions для всех мутаций (переключение, обновление параметров, установка/удаление).
-- Просмотрщик сеансов анализирует формат JSONL-транскрипта Claude и отображает шкалу времени сообщений и вызовов инструментов.
+- Компоненты страниц вызывают `lib/projects.ts` и `lib/log-entries.ts` для чтения данных проекта/сессии непосредственно из файловой системы (без слоя API для чтения).
+- Страница Policies использует Server Actions для всех изменений (переключение, обновление параметров, установка/удаление).
+- Просмотрщик сессии анализирует формат JSONL транскрипта Claude и отображает временную шкалу сообщений и вызовов инструментов.
 
 **Ключевые решения проектирования:**
 
-- Нет базы данных — все постоянное состояние хранится в простых файлах (`~/.failproofai/`, `~/.claude/projects/`).
-- Server Actions для мутаций — REST API не требуется для CRUD операций.
-- React Server Components для страниц чтения — более быстрая начальная загрузка, отсутствие клиентского бандла для выборки данных.
-- Клиентские компоненты только там, где требуется интерактивность (переключение политик, поиск активности, просмотр логов).
+- Нет базы данных — всё постоянное состояние хранится в простых файлах (`~/.failproofai/`, `~/.claude/projects/`).
+- Server Actions для изменений — REST API не требуется для CRUD операций.
+- React Server Components для страниц чтения — более быстрая начальная загрузка, без клиентского пакета для получения данных.
+- Клиентские компоненты только где требуется интерактивность (переключение политик, поиск по активности, просмотр логов).
 
 ---
 

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

@@ -1,58 +1,57 @@
 ---
----
 title: Конфигурация
-description: "Формат файла конфигурации, трёхуровневая система и правила слияния"
+description: "Формат файла конфигурации, система трёх областей и правила слияния"
 icon: gear
 ---
 
-failproofai использует JSON файлы конфигурации для управления активными политиками, их поведением и источниками пользовательских политик. Конфигурация разработана так, чтобы её было легко делиться с командой — закоммитьте её в репозиторий, и каждый разработчик получит одинаковую защиту агента.
+failproofai использует JSON-файлы конфигурации для управления активными политиками, их поведением и местом загрузки пользовательских политик. Конфигурация разработана так, чтобы её было легко делиться с командой — достаточно добавить её в репозиторий, и каждый разработчик получит одинаковую защиту агента.
 
 ---
 
-## Уровни конфигурации
+## Области конфигурации
 
-Существует три уровня конфигурации, оцениваемые в порядке приоритета:
+Существует три области конфигурации, оцениваемые в порядке приоритета:
 
-| Уровень | Путь файла | Назначение |
-|---------|-----------|-----------|
-| **project** | `.failproofai/policies-config.json` | Настройки репозитория, коммитятся в систему контроля версий |
-| **local** | `.failproofai/policies-config.local.json` | Личные переопределения на уровне репозитория, в .gitignore |
-| **global** | `~/.failproofai/policies-config.json` | Пользовательские стандартные значения для всех проектов |
+| Область | Путь к файлу | Назначение |
+|---------|--------------|-----------|
+| **project** | `.failproofai/policies-config.json` | Параметры репозитория, коммитятся в контроль версий |
+| **local** | `.failproofai/policies-config.local.json` | Личные переопределения для конкретного репозитория, в .gitignore |
+| **global** | `~/.failproofai/policies-config.json` | Параметры уровня пользователя для всех проектов |
 
-Когда failproofai получает событие hook, он загружает и объединяет все три существующих файла для текущей директории.
+Когда failproofai получает событие хука, он загружает и объединяет все три файла, которые существуют для текущей рабочей директории.
 
 ### Правила слияния
 
-**`enabledPolicies`** — объединение всех трёх уровней. Политика, активированная на любом уровне, работает.
+**`enabledPolicies`** — объединение всех трёх областей. Политика, активированная на любом уровне, становится активной.
 
 ```text
 project:  ["block-sudo"]
 local:    ["block-rm-rf"]
 global:   ["block-sudo", "sanitize-api-keys"]
 
-resolved: ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← объединение без дубликатов
+resolved: ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← дедублицированное объединение
 ```
 
-**`policyParams`** — первый уровень, определивший параметры для данной политики, полностью выигрывает. Нет глубокого слияния значений в параметрах политики.
+**`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 игнорируется
+resolved: { allowPatterns: ["sudo apt-get update"] }   ← project побеждает, global игнорируется
 ```
 
 ```text
-project:  (нет записи block-sudo)
-local:    (нет записи block-sudo)
+project:  (нет входа block-sudo)
+local:    (нет входа block-sudo)
 global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
 
 resolved: { allowPatterns: ["sudo systemctl status"] }  ← переходит на global
 ```
 
-**`customPoliciesPath`** — первый уровень, определивший его, выигрывает.
+**`customPoliciesPath`** — первая область, которая определяет его, побеждает.
 
-**`llm`** — первый уровень, определивший его, выигрывает.
+**`llm`** — первая область, которая определяет его, побеждает.
 
 ---
 
@@ -97,85 +96,85 @@ resolved: { allowPatterns: ["sudo systemctl status"] }  ← переходит
 
 ---
 
-## Справка по полям
+## Справочник полей
 
 ### `enabledPolicies`
 
 Тип: `string[]`
 
-Список имён политик для активации. Имена должны точно совпадать с идентификаторами политик, показываемыми командой `failproofai policies`. Полный список см. в разделе [Built-in Policies](/ru/built-in-policies).
+Список имён политик для активации. Имена должны точно совпадать с идентификаторами политик, показываемыми `failproofai policies`. Полный список смотрите в разделе [Встроенные политики](/ru/built-in-policies).
 
-Политики, отсутствующие в `enabledPolicies`, неактивны, даже если у них есть записи в `policyParams`.
+Политики, отсутствующие в `enabledPolicies`, неактивны, даже если они имеют записи в `policyParams`.
 
 ### `policyParams`
 
 Тип: `Record<string, Record<string, unknown>>`
 
-Переопределения параметров для каждой политики. Внешний ключ — имя политики; внутренние ключи — специфичны для политики. Каждая политика документирует свои доступные параметры в разделе [Built-in Policies](/ru/built-in-policies).
+Переопределения параметров для отдельных политик. Внешний ключ — это имя политики; внутренние ключи специфичны для политики. Каждая политика описывает свои доступные параметры в разделе [Встроенные политики](/ru/built-in-policies).
 
-Если политика имеет параметры, но вы их не указали, используются встроенные значения по умолчанию политики. Пользователи, которые вообще не конфигурируют `policyParams`, получают идентичное поведение с предыдущими версиями.
+Если политика имеет параметры, но вы их не указали, используются встроенные значения по умолчанию. Пользователи, которые вообще не настраивают `policyParams`, получат идентичное поведение предыдущим версиям.
 
-Неизвестные ключи в блоке параметров политики молча игнорируются при срабатывании hook, но отмечаются как предупреждения при выполнении `failproofai policies`.
+Неизвестные ключи внутри блока параметров политики молча игнорируются при срабатывании хука, но флагируются как предупреждения при запуске `failproofai policies`.
 
-#### `hint` (кросс-функциональный)
+#### `hint` (сквозной)
 
 Тип: `string` (опционально)
 
-Сообщение, добавляемое к причине, когда политика возвращает `deny` или `instruct`. Используйте его, чтобы дать Claude практические рекомендации без изменения самой политики.
+Сообщение, добавляемое к причине, когда политика возвращает `deny` или `instruct`. Используйте его, чтобы дать Claude действенное руководство без изменения самой политики.
 
-Работает с любым типом политики — встроенной, пользовательской (`custom/`), проектной конвенции (`.failproofai-project/`) или пользовательской конвенции (`.failproofai-user/`).
+Работает с любым типом политик — встроенными, пользовательскими (`custom/`), соглашениями проекта (`.failproofai-project/`) или соглашениями пользователя (`.failproofai-user/`).
 
 ```json
 {
   "policyParams": {
     "block-force-push": {
-      "hint": "Попробуйте создать свежую ветку вместо этого."
+      "hint": "Попробуйте создать новую ветку вместо этого."
     },
     "block-sudo": {
       "allowPatterns": ["sudo apt-get"],
       "hint": "Используйте apt-get напрямую без sudo."
     },
     "custom/my-policy": {
-      "hint": "Сначала запросите одобрение у пользователя."
+      "hint": "Сначала получите одобрение у пользователя."
     }
   }
 }
 ```
 
-Когда `block-force-push` запрещает, Claude видит: *"Force-pushing заблокирован. Попробуйте создать свежую ветку вместо этого."*
+Когда `block-force-push` отклоняет, Claude видит: *"Force-pushing заблокирован. Попробуйте создать новую ветку вместо этого."*
 
-Значения, не являющиеся строками, и пустые строки молча игнорируются. Если `hint` не установлен, поведение не изменяется (обратная совместимость).
+Значения, не являющиеся строками, и пустые строки молча игнорируются. Если `hint` не задан, поведение не меняется (обратная совместимость).
 
 ### `customPoliciesPath`
 
 Тип: `string` (абсолютный путь)
 
-Путь к JavaScript файлу, содержащему пользовательские hook политики. Устанавливается автоматически командой `failproofai policies --install --custom <path>` (путь преобразуется в абсолютный перед сохранением).
+Путь к JavaScript-файлу, содержащему пользовательские политики хука. Этот параметр устанавливается автоматически командой `failproofai policies --install --custom <path>` (путь разрешается к абсолютному перед сохранением).
 
-Файл загружается заново при каждом события hook — кеширования нет. Детали разработки см. в разделе [Custom Policies](/ru/custom-policies).
+Файл загружается заново при каждом срабатывании хука — кэширования нет. Подробности разработки смотрите в разделе [Пользовательские политики](/ru/custom-policies).
 
-### Политики на основе конвенций
+### Политики на основе соглашений
 
-В дополнение к явному `customPoliciesPath`, failproofai автоматически обнаруживает и загружает файлы политик из директорий `.failproofai/policies/`:
+В дополнение к явному `customPoliciesPath` failproofai автоматически обнаруживает и загружает файлы политик из директорий `.failproofai/policies/`:
 
-| Уровень | Директория | Уровень |
-|---------|-----------|--------|
-| Project | `.failproofai/policies/` | Общая с командой через систему контроля версий |
-| User | `~/.failproofai/policies/` | Личная, применяется ко всем проектам |
+| Уровень | Директория | Область |
+|---------|-----------|---------|
+| Проект | `.failproofai/policies/` | Совместное использование с командой через контроль версий |
+| Пользователь | `~/.failproofai/policies/` | Личные, применяются ко всем проектам |
 
-**Соответствие файлов:** Загружаются только файлы, соответствующие маске `*policies.{js,mjs,ts}` (например, `security-policies.mjs`, `workflow-policies.js`). Другие файлы в директории игнорируются.
+**Соответствие файлов:** Загружаются только файлы, соответствующие шаблону `*policies.{js,mjs,ts}` (например `security-policies.mjs`, `workflow-policies.js`). Другие файлы в директории игнорируются.
 
-**Конфигурация не требуется:** Политики на основе конвенций не требуют записей в `policies-config.json`. Просто поместите файлы в директорию, и они будут обнаружены при следующем событии hook.
+**Конфигурация не требуется:** Политики на основе соглашений не требуют записей в `policies-config.json`. Просто поместите файлы в директорию, и они будут загружены при следующем срабатывании хука.
 
-**Загрузка объединением:** Сканируются обе директории конвенций — проектная и пользовательская. Загружаются все соответствующие файлы с обоих уровней (в отличие от `customPoliciesPath`, который использует first-scope-wins).
+**Объединённая загрузка:** Сканируются обе директории соглашений — проекта и пользователя. Все подходящие файлы с обоих уровней загружаются (в отличие от `customPoliciesPath`, который использует первый-побеждает).
 
-Детали и примеры см. в разделе [Custom Policies](/ru/custom-policies).
+Подробности и примеры смотрите в разделе [Пользовательские политики](/ru/custom-policies).
 
 ### `llm`
 
 Тип: `object` (опционально)
 
-Конфигурация LLM клиента для политик, делающих AI вызовы. Не требуется для большинства установок.
+Конфигурация LLM-клиента для политик, которые выполняют вызовы AI. Не требуется для большинства конфигураций.
 
 ```json
 {
@@ -188,20 +187,20 @@ resolved: { allowPatterns: ["sudo systemctl status"] }  ← переходит
 
 ---
 
-## Управление конфигурацией через CLI
+## Управление конфигурацией из CLI
 
-Команды `policies --install` и `policies --uninstall` записывают в `settings.json` Claude Code (точки входа для hook), в то время как `policies-config.json` — это файл, который вы управляете напрямую. Это два отдельных файла:
+Команды `policies --install` и `policies --uninstall` записывают в `settings.json` Claude Code (точки входа хука), а `policies-config.json` — это файл, которым вы управляете напрямую. Это два разных файла:
 
-- **`settings.json`** — указывает Claude Code вызывать `failproofai --hook <event>` при каждом использовании инструмента
-- **`policies-config.json`** — указывает failproofai, какие политики оценивать и с какими параметрами
+- **`settings.json`** — говорит Claude Code вызывать `failproofai --hook <event>` при каждом использовании инструмента
+- **`policies-config.json`** — говорит failproofai, какие политики оценивать и с какими параметрами
 
-Вы можете редактировать `policies-config.json` напрямую в любое время; изменения вступают в силу на следующем события hook без необходимости перезагрузки.
+Вы можете редактировать `policies-config.json` напрямую в любой момент; изменения вступают в силу сразу же при следующем срабатывании хука без необходимости перезагрузки.
 
 ---
 
-## Пример: конфигурация на уровне проекта с командными стандартами
+## Пример: конфигурация уровня проекта с командными параметрами по умолчанию
 
-Закоммитьте `.failproofai/policies-config.json` в ваш репозиторий:
+Добавьте `.failproofai/policies-config.json` в свой репозиторий:
 
 ```json
 {
@@ -220,4 +219,4 @@ resolved: { allowPatterns: ["sudo systemctl status"] }  ← переходит
 }
 ```
 
-Каждый разработчик может затем создать `.failproofai/policies-config.local.json` (в .gitignore) для личных переопределений без влияния на коллег.
+Затем каждый разработчик может создать `.failproofai/policies-config.local.json` (в .gitignore) для личных переопределений без влияния на коллег.