failproofai 0.0.5 → 0.0.6-beta.1

package/.next/standalone/docs/i18n/README.ru.md

@@ -23,12 +23,12 @@
 
 **Переводы**: [简体中文](docs/i18n/README.zh.md) | [日本語](docs/i18n/README.ja.md) | [한국어](docs/i18n/README.ko.md) | [Español](docs/i18n/README.es.md) | [Português](docs/i18n/README.pt-br.md) | [Deutsch](docs/i18n/README.de.md) | [Français](docs/i18n/README.fr.md) | [Русский](docs/i18n/README.ru.md) | [हिन्दी](docs/i18n/README.hi.md) | [Türkçe](docs/i18n/README.tr.md) | [Tiếng Việt](docs/i18n/README.vi.md) | [Italiano](docs/i18n/README.it.md) | [العربية](docs/i18n/README.ar.md) | [עברית](docs/i18n/README.he.md)
 
-Самый простой способ управлять политиками, которые делают ваших AI-агентов надежными, сосредоточенными и способными работать автономно — для **Claude Code** и **Agents SDK**.
+Самый простой способ управлять политиками, которые делают ваших AI-агентов надёжными, сосредоточенными и автономными — для **Claude Code** и **Agents SDK**.
 
-- **30 встроенных политик** - Предотвращайте типичные сбои агентов уже из коробки. Блокируйте деструктивные команды, предотвращайте утечку секретов, держите агентов в границах проекта, обнаруживайте циклы и многое другое.
-- **Пользовательские политики** - Напишите собственные правила надежности на JavaScript. Используйте API `allow`/`deny`/`instruct` для обеспечения соглашений, предотвращения отклонений, управления операциями или интеграции с внешними системами.
-- **Простая конфигурация** - Настраивайте любую политику без написания кода. Устанавливайте списки разрешений, защищенные ветви, пороги для каждого проекта или глобально. Конфигурация трех уровней автоматически объединяется.
-- **Монитор агентов** - Узнайте, что делали ваши агенты, пока вас не было. Просматривайте сеансы, проверяйте каждый вызов инструмента и смотрите, где именно сработали политики.
+- **30 встроенных политик** — Предотвращайте типичные сбои агентов из коробки. Блокируйте деструктивные команды, предотвращайте утечки секретов, удерживайте агентов в границах проекта, обнаруживайте циклы и многое другое.
+- **Пользовательские политики** — Напишите свои правила надёжности на JavaScript. Используйте API `allow`/`deny`/`instruct` для обеспечения конвенций, предотвращения дрейфа, контроля операций или интеграции с внешними системами.
+- **Простая конфигурация** — Настраивайте любую политику без написания кода. Устанавливайте списки разрешений, защищённые ветви, пороги на уровне проекта или глобально. Конфигурация трёх уровней автоматически объединяется.
+- **Мониторинг агентов** — Смотрите, что делали ваши агенты, пока вас не было. Просматривайте сеансы, проверяйте каждый вызов инструмента и смотрите точно, где срабатывали политики.
 
 Всё работает локально — никакие данные не покидают вашу машину.
 
@@ -37,7 +37,7 @@
 ## Требования
 
 - Node.js >= 20.9.0
-- Bun >= 1.3.0 (необязательно — требуется только для разработки / сборки из исходного кода)
+- Bun >= 1.3.0 (опционально — требуется только для разработки / сборки из исходников)
 
 ---
 
@@ -59,7 +59,7 @@ bun add -g failproofai
 failproofai policies --install
 ```
 
-Добавляет записи перехватчиков в `~/.claude/settings.json`. Теперь Claude Code будет вызывать failproofai до и после каждого вызова инструмента.
+Записывает записи hook в `~/.claude/settings.json`. Claude Code теперь будет вызывать failproofai до и после каждого вызова инструмента.
 
 ### 2. Запустите панель управления
 
@@ -79,15 +79,15 @@ failproofai policies
 
 ## Установка политик
 
-### Уровни
+### Области видимости
 
-| Уровень | Команда | Где записывает |
-|---------|---------|----------------|
-| Глобальный (по умолчанию) | `failproofai policies --install` | `~/.claude/settings.json` |
+| Область | Команда | Где записывается |
+|---------|---------|------------------|
+| Глобальная (по умолчанию) | `failproofai policies --install` | `~/.claude/settings.json` |
 | Проект | `failproofai policies --install --scope project` | `.claude/settings.json` |
-| Локальный | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
+| Локальная | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
 
-### Установите конкретные политики
+### Установка специфических политик
 
 ```bash
 failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
@@ -97,7 +97,7 @@ failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
 
 ```bash
 failproofai policies --uninstall
-# или для конкретного уровня:
+# или для конкретной области:
 failproofai policies --uninstall --scope project
 ```
 
@@ -105,7 +105,7 @@ failproofai policies --uninstall --scope project
 
 ## Конфигурация
 
-Конфигурация политик находится в `~/.failproofai/policies-config.json` (глобально) или `.failproofai/policies-config.json` в вашем проекте (для каждого проекта).
+Конфигурация политик находится в `~/.failproofai/policies-config.json` (глобальная) или `.failproofai/policies-config.json` в вашем проекте (для каждого проекта).
 
 ```json
 {
@@ -120,11 +120,11 @@ failproofai policies --uninstall --scope project
   "policyParams": {
     "block-sudo": {
       "allowPatterns": ["sudo systemctl status", "sudo journalctl"],
-      "hint": "Use apt-get directly without sudo."
+      "hint": "Используйте apt-get напрямую без sudo."
     },
     "block-push-master": {
       "protectedBranches": ["main", "release", "prod"],
-      "hint": "Try creating a fresh branch instead."
+      "hint": "Попробуйте создать свежую ветвь вместо этого."
     },
     "sanitize-api-keys": {
       "additionalPatterns": [
@@ -138,60 +138,60 @@ failproofai policies --uninstall --scope project
 }
 ```
 
-**Три уровня конфигурации** автоматически объединяются (проект → локальный → глобальный). Полные правила объединения см. в [docs/configuration.mdx](docs/configuration.mdx).
+**Три области конфигурации** автоматически объединяются (проект → локальная → глобальная). Смотрите [docs/configuration.mdx](docs/configuration.mdx) для полных правил объединения.
 
 ---
 
 ## Встроенные политики
 
-| Политика | Описание | Настраиваемо |
+| Политика | Описание | Настраивается |
 |----------|---------|:---:|
-| `block-sudo` | Предотвратите запуск привилегированных системных команд агентами | `allowPatterns` |
-| `block-rm-rf` | Предотвратите случайное рекурсивное удаление файлов | `allowPaths` |
-| `block-curl-pipe-sh` | Предотвратите передачу ненадежных скриптов агентами в оболочку | |
-| `block-failproofai-commands` | Предотвратите самоудаление | |
-| `sanitize-jwt` | Остановите утечку JWT-токенов в контекст агента | |
-| `sanitize-api-keys` | Остановите утечку API-ключей в контекст агента | `additionalPatterns` |
-| `sanitize-connection-strings` | Остановите утечку учетных данных базы данных в контекст агента | |
-| `sanitize-private-key-content` | Скройте блоки PEM-ключей из выходных данных | |
-| `sanitize-bearer-tokens` | Скройте токены Authorization Bearer из выходных данных | |
-| `block-env-files` | Не позволяйте агентам читать файлы .env | |
-| `protect-env-vars` | Предотвратите вывод переменных окружения агентами | |
-| `block-read-outside-cwd` | Держите агентов внутри границ проекта | `allowPaths` |
-| `block-secrets-write` | Предотвратите запись в файлы приватных ключей и сертификатов | `additionalPatterns` |
-| `block-push-master` | Предотвратите случайные отправки на main/master | `protectedBranches` |
-| `block-work-on-main` | Держите агентов от защищенных ветвей | `protectedBranches` |
-| `block-force-push` | Предотвратите `git push --force` | |
-| `warn-git-amend` | Напомните агентам перед изменением коммитов | |
-| `warn-git-stash-drop` | Напомните агентам перед удалением сохранений | |
-| `warn-all-files-staged` | Поймайте случайный `git add -A` | |
-| `warn-destructive-sql` | Поймайте DROP/DELETE SQL перед выполнением | |
-| `warn-schema-alteration` | Поймайте ALTER TABLE перед выполнением | |
-| `warn-large-file-write` | Поймайте неожиданно большие записи файлов | `thresholdKb` |
-| `warn-package-publish` | Поймайте случайный `npm publish` | |
-| `warn-background-process` | Поймайте непреднамеренные фоновые процессы | |
-| `warn-global-package-install` | Поймайте непреднамеренные глобальные установки пакетов | |
-| …и еще | | |
-
-Полная информация о политиках и справочник параметров: [docs/built-in-policies.mdx](docs/built-in-policies.mdx)
+| `block-sudo` | Предотвратить запуск привилегированных системных команд | `allowPatterns` |
+| `block-rm-rf` | Предотвратить случайное рекурсивное удаление файлов | `allowPaths` |
+| `block-curl-pipe-sh` | Предотвратить передачу ненадёжных скриптов в shell | |
+| `block-failproofai-commands` | Предотвратить самостоятельное удаление | |
+| `sanitize-jwt` | Остановить утечку JWT токенов в контекст агента | |
+| `sanitize-api-keys` | Остановить утечку ключей API в контекст агента | `additionalPatterns` |
+| `sanitize-connection-strings` | Остановить утечку учётных данных базы данных в контекст агента | |
+| `sanitize-private-key-content` | Скрыть блоки PEM приватных ключей из вывода | |
+| `sanitize-bearer-tokens` | Скрыть токены Authorization Bearer из вывода | |
+| `block-env-files` | Удерживать агентов от чтения .env файлов | |
+| `protect-env-vars` | Предотвратить вывод переменных окружения | |
+| `block-read-outside-cwd` | Удерживать агентов в границах проекта | `allowPaths` |
+| `block-secrets-write` | Предотвратить запись в файлы приватных ключей и сертификатов | `additionalPatterns` |
+| `block-push-master` | Предотвратить случайные push в main/master | `protectedBranches` |
+| `block-work-on-main` | Удерживать агентов от защищённых ветвей | `protectedBranches` |
+| `block-force-push` | Предотвратить `git push --force` | |
+| `warn-git-amend` | Напомнить агентам перед изменением коммитов | |
+| `warn-git-stash-drop` | Напомнить агентам перед удалением стеша | |
+| `warn-all-files-staged` | Поймать случайный `git add -A` | |
+| `warn-destructive-sql` | Поймать DROP/DELETE SQL перед выполнением | |
+| `warn-schema-alteration` | Поймать ALTER TABLE перед выполнением | |
+| `warn-large-file-write` | Поймать неожиданно большие записи файлов | `thresholdKb` |
+| `warn-package-publish` | Поймать случайный `npm publish` | |
+| `warn-background-process` | Поймать непреднамеренные запуски фоновых процессов | |
+| `warn-global-package-install` | Поймать непреднамеренные глобальные установки пакетов | |
+| …и другие | | |
+
+Полные детали политик и справочник параметров: [docs/built-in-policies.mdx](docs/built-in-policies.mdx)
 
 ---
 
 ## Пользовательские политики
 
-Напишите собственные политики, чтобы ваши агенты были надежными и сосредоточенными:
+Напишите свои политики, чтобы сделать агентов надёжными и сосредоточенными на задаче:
 
 ```js
 import { customPolicies, allow, deny, instruct } from "failproofai";
 
 customPolicies.add({
   name: "no-production-writes",
-  description: "Block writes to paths containing 'production'",
+  description: "Заблокировать запись в пути, содержащие 'production'",
   match: { events: ["PreToolUse"] },
   fn: async (ctx) => {
     if (!["Write", "Edit"].includes(ctx.toolName ?? "")) return allow();
     const path = ctx.toolInput?.file_path ?? "";
-    if (path.includes("production")) return deny("Writes to production paths are blocked");
+    if (path.includes("production")) return deny("Запись в пути production заблокирована");
     return allow();
   },
 });
@@ -203,7 +203,7 @@ customPolicies.add({
 failproofai policies --install --custom ./my-policies.js
 ```
 
-### Вспомогательные функции для решений
+### Вспомогательные функции решений
 
 | Функция | Эффект |
 |---------|--------|
@@ -219,27 +219,27 @@ failproofai policies --install --custom ./my-policies.js
 | `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
 | `toolName` | `string` | Вызываемый инструмент (`"Bash"`, `"Write"`, `"Read"`, …) |
 | `toolInput` | `object` | Входные параметры инструмента |
-| `payload` | `object` | Полный необработанный payload события |
+| `payload` | `object` | Полный сырой payload события |
 | `session.cwd` | `string` | Рабочая директория сеанса Claude Code |
 | `session.sessionId` | `string` | Идентификатор сеанса |
-| `session.transcriptPath` | `string` | Путь к файлу стенограммы сеанса |
+| `session.transcriptPath` | `string` | Путь к файлу транскрипта сеанса |
 
-Пользовательские перехватчики поддерживают переходные локальные импорты, async/await и доступ к `process.env`. Ошибки безопасны (логируются в `~/.failproofai/hook.log`, встроенные политики продолжают работу). Полное руководство см. в [docs/custom-hooks.mdx](docs/custom-hooks.mdx).
+Пользовательские hooks поддерживают переходные локальные импорты, async/await и доступ к `process.env`. Ошибки являются fail-open (логируются в `~/.failproofai/hook.log`, встроенные политики продолжают работу). Смотрите [docs/custom-hooks.mdx](docs/custom-hooks.mdx) для полного руководства.
 
 ### Политики на основе соглашений
 
-Поместите файлы `*policies.{js,mjs,ts}` в `.failproofai/policies/` — они будут автоматически загружены без флага `--custom` или изменения конфигурации. Работает как git-хуки: поместите файл, и всё работает.
+Поместите файлы `*policies.{js,mjs,ts}` в `.failproofai/policies/` и они автоматически загружаются — без флага `--custom` или изменений конфигурации. Работает как git hooks: положите файл, и он просто работает.
 
 ```text
-# Уровень проекта — коммитится в git, общее с командой
+# Уровень проекта — зафиксировано в git, общее с командой
 .failproofai/policies/security-policies.mjs
 .failproofai/policies/workflow-policies.mjs
 
-# Уровень пользователя — личное, применяется ко всем проектам
+# Уровень пользователя — персональное, применяется ко всем проектам
 ~/.failproofai/policies/my-policies.mjs
 ```
 
-Загружаются оба уровня (объединение). Файлы загружаются в алфавитном порядке внутри каждой директории. Используйте префиксы `01-`, `02-`, и т.д., чтобы контролировать порядок. Готовые примеры см. в [examples/convention-policies/](examples/convention-policies/).
+Оба уровня загружаются (объединение). Файлы загружаются в алфавитном порядке в каждой директории. Используйте префиксы `01-`, `02-` и т.д. для контроля порядка. Смотрите [examples/convention-policies/](examples/convention-policies/) для готовых примеров.
 
 ---
 
@@ -258,13 +258,13 @@ FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
 ## Документация
 
 | Руководство | Описание |
-|-----------|---------|
+|-----------|----------|
 | [Начало работы](docs/getting-started.mdx) | Установка и первые шаги |
 | [Встроенные политики](docs/built-in-policies.mdx) | Все 30 встроенных политик с параметрами |
-| [Пользовательские политики](docs/custom-policies.mdx) | Напишите собственные политики |
-| [Конфигурация](docs/configuration.mdx) | Формат файла конфигурации и объединение уровней |
+| [Пользовательские политики](docs/custom-policies.mdx) | Напишите свои политики |
+| [Конфигурация](docs/configuration.mdx) | Формат файла конфигурации и объединение областей видимости |
 | [Панель управления](docs/dashboard.mdx) | Мониторинг сеансов и проверка активности политик |
-| [Архитектура](docs/architecture.mdx) | Как работает система перехватчиков |
+| [Архитектура](docs/architecture.mdx) | Как работает система hooks |
 | [Тестирование](docs/testing.mdx) | Запуск тестов и написание новых |
 
 ### Запустите документацию локально
@@ -274,7 +274,7 @@ docker build -f Dockerfile.docs -t failproofai-docs .
 docker run --rm -p 3000:3000 failproofai-docs
 ```
 
-Откроет сайт документации Mintlify на `http://localhost:3000`. Контейнер отслеживает изменения, если вы монтируете директорию документов:
+Открывает сайт документации Mintlify на `http://localhost:3000`. Контейнер следит за изменениями, если вы примонтируете директорию docs:
 
 ```bash
 docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
@@ -284,25 +284,25 @@ docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
 
 ## Примечание для участников failproofai
 
-`.claude/settings.json` этого репозитория использует `bun ./bin/failproofai.mjs --hook <EventType>` вместо стандартной команды `npx -y failproofai`. Это потому, что запуск `npx -y failproofai` внутри самого проекта failproofai создает конфликт самоссылающихся ссылок.
+`.claude/settings.json` этого репозитория использует `bun ./bin/failproofai.mjs --hook <EventType>` вместо стандартной команды `npx -y failproofai`. Это потому, что запуск `npx -y failproofai` внутри самого проекта failproofai создаёт конфликт самоссылки.
 
-Для всех остальных репозиториев рекомендуемый подход — `npx -y failproofai`, установленный с помощью:
+Для всех других репозиториев рекомендуемый подход — `npx -y failproofai`, установленный с помощью:
 
 ```bash
 failproofai policies --install --scope project
 ```
 
-## Участие в разработке
+## Помощь в разработке
 
-См. [CONTRIBUTING.md](CONTRIBUTING.md).
+Смотрите [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ---
 
 ## Лицензия
 
-См. [LICENSE](LICENSE).
+Смотрите [LICENSE](LICENSE).
 
 ---
 
-Создано и поддерживается компанией **ExosphereHost: Reliability Research Lab for Your Agents**. Мы помогаем предприятиям и стартапам повысить надежность своих AI-агентов через собственные агенты, программное обеспечение и экспертизу. Узнайте больше на [exosphere.host](https://exosphere.host).
+Создано и поддерживается **ExosphereHost: Reliability Research Lab for Your Agents**. Мы помогаем предприятиям и стартапам улучшить надёжность своих AI-агентов благодаря собственным агентам, программному обеспечению и опыту. Узнайте больше на [exosphere.host](https://exosphere.host).
 ```