failproofai 0.0.6-beta.1 → 0.0.6-beta.2

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**.
+Самый простой способ управления политиками, которые делают ваши ИИ-агенты надежными, сосредоточенными на задачах и работающими автономно — для **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,15 +59,15 @@ bun add -g failproofai
 failproofai policies --install
 ```
 
-Записывает записи hook в `~/.claude/settings.json`. Claude Code теперь будет вызывать failproofai до и после каждого вызова инструмента.
+Записывает записи хука в `~/.claude/settings.json`. Claude Code теперь будет вызывать failproofai до и после каждого вызова инструмента.
 
-### 2. Запустите панель управления
+### 2. Запустите панель мониторинга
 
 ```bash
 failproofai
 ```
 
-Открывает `http://localhost:8020` — просматривайте сеансы, проверяйте логи, управляйте политиками.
+Открывает `http://localhost:8020` — просматривайте сессии, проверяйте логи, управляйте политиками.
 
 ### 3. Проверьте, что активно
 
@@ -79,15 +79,15 @@ failproofai policies
 
 ## Установка политик
 
-### Области видимости
+### Области действия
 
-| Область | Команда | Где записывается |
-|---------|---------|------------------|
+| Область | Команда | Куда записывается |
+|--------|---------|-----------------|
 | Глобальная (по умолчанию) | `failproofai policies --install` | `~/.claude/settings.json` |
 | Проект | `failproofai policies --install --scope project` | `.claude/settings.json` |
 | Локальная | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
 
-### Установка специфических политик
+### Установка конкретных политик
 
 ```bash
 failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
@@ -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
 {
@@ -124,7 +124,7 @@ failproofai policies --uninstall --scope project
     },
     "block-push-master": {
       "protectedBranches": ["main", "release", "prod"],
-      "hint": "Попробуйте создать свежую ветвь вместо этого."
+      "hint": "Попробуйте создать свежую ветку вместо этого."
     },
     "sanitize-api-keys": {
       "additionalPatterns": [
@@ -138,55 +138,55 @@ failproofai policies --uninstall --scope project
 }
 ```
 
-**Три области конфигурации** автоматически объединяются (проект → локальная → глобальная). Смотрите [docs/configuration.mdx](docs/configuration.mdx) для полных правил объединения.
+**Три области конфигурации** объединяются автоматически (проект → локальная → глобальная). Полные правила объединения см. в [docs/configuration.mdx](docs/configuration.mdx).
 
 ---
 
 ## Встроенные политики
 
 | Политика | Описание | Настраивается |
-|----------|---------|:---:|
-| `block-sudo` | Предотвратить запуск привилегированных системных команд | `allowPatterns` |
+|--------|-------------|:---:|
+| `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-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` | Скрыть токены 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-push-master` | Предотвратить случайные отправки в main/master | `protectedBranches` |
+| `block-work-on-main` | Держать агентов подальше от защищённых веток | `protectedBranches` |
 | `block-force-push` | Предотвратить `git push --force` | |
 | `warn-git-amend` | Напомнить агентам перед изменением коммитов | |
-| `warn-git-stash-drop` | Напомнить агентам перед удалением стеша | |
+| `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` | Поймать непреднамеренные глобальные установки пакетов | |
+| `warn-background-process` | Поймать ненамеренные запуски фоновых процессов | |
+| `warn-global-package-install` | Поймать ненамеренные глобальные установки пакетов | |
 | …и другие | | |
 
-Полные детали политик и справочник параметров: [docs/built-in-policies.mdx](docs/built-in-policies.mdx)
+Полные детали политик и справка по параметрам: [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: "Заблокировать запись в пути, содержащие 'production'",
+  description: "Блокировать запись в пути, содержащие 'production'",
   match: { events: ["PreToolUse"] },
   fn: async (ctx) => {
     if (!["Write", "Edit"].includes(ctx.toolName ?? "")) return allow();
@@ -203,10 +203,10 @@ customPolicies.add({
 failproofai policies --install --custom ./my-policies.js
 ```
 
-### Вспомогательные функции решений
+### Вспомогательные функции принятия решений
 
 | Функция | Эффект |
-|---------|--------|
+|----------|--------|
 | `allow()` | Разрешить операцию |
 | `allow(message)` | Разрешить и отправить информационный контекст Claude |
 | `deny(message)` | Заблокировать операцию; сообщение показано Claude |
@@ -215,39 +215,39 @@ failproofai policies --install --custom ./my-policies.js
 ### Объект контекста (`ctx`)
 
 | Поле | Тип | Описание |
-|------|-----|---------|
+|-------|------|-------------|
 | `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
 | `toolName` | `string` | Вызываемый инструмент (`"Bash"`, `"Write"`, `"Read"`, …) |
-| `toolInput` | `object` | Входные параметры инструмента |
-| `payload` | `object` | Полный сырой payload события |
-| `session.cwd` | `string` | Рабочая директория сеанса Claude Code |
-| `session.sessionId` | `string` | Идентификатор сеанса |
-| `session.transcriptPath` | `string` | Путь к файлу транскрипта сеанса |
+| `toolInput` | `object` | Параметры входа инструмента |
+| `payload` | `object` | Полная исходная полезная нагрузка события |
+| `session.cwd` | `string` | Рабочий каталог сессии Claude Code |
+| `session.sessionId` | `string` | Идентификатор сессии |
+| `session.transcriptPath` | `string` | Путь к файлу стенограммы сессии |
 
-Пользовательские hooks поддерживают переходные локальные импорты, async/await и доступ к `process.env`. Ошибки являются fail-open (логируются в `~/.failproofai/hook.log`, встроенные политики продолжают работу). Смотрите [docs/custom-hooks.mdx](docs/custom-hooks.mdx) для полного руководства.
+Пользовательские хуки поддерживают переходные локальные импорты, async/await и доступ к `process.env`. Ошибки перекрываются открытыми (логируются в `~/.failproofai/hook.log`, встроенные политики продолжают работу). Полное руководство см. в [docs/custom-hooks.mdx](docs/custom-hooks.mdx).
 
 ### Политики на основе соглашений
 
-Поместите файлы `*policies.{js,mjs,ts}` в `.failproofai/policies/` и они автоматически загружаются — без флага `--custom` или изменений конфигурации. Работает как git hooks: положите файл, и он просто работает.
+Поместите файлы `*policies.{js,mjs,ts}` в `.failproofai/policies/` и они будут автоматически загружены — никаких флагов или изменений конфигурации не требуется. Фиксируйте каталог в git и каждый члена команды получит одинаковые стандарты качества автоматически.
 
 ```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-` и т.д. для управления порядком. По мере того, как ваша команда открывает новые режимы отказа, добавьте политику и отправьте — все получат обновление при следующем pull. См. [examples/convention-policies/](examples/convention-policies/) для готовых к использованию примеров.
 
 ---
 
 ## Телеметрия
 
-Failproof AI собирает анонимную телеметрию использования через PostHog для понимания использования функций. Содержимое сеанса, имена файлов, входные данные инструментов или личная информация никогда не отправляются.
+Failproof AI собирает анонимную телеметрию использования через PostHog, чтобы понять использование функций. Содержимое сессии, имена файлов, входные параметры инструментов или личная информация никогда не отправляются.
 
-Отключите это:
+Отключите её:
 
 ```bash
 FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
@@ -258,14 +258,14 @@ FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
 ## Документация
 
 | Руководство | Описание |
-|-----------|----------|
-| [Начало работы](docs/getting-started.mdx) | Установка и первые шаги |
-| [Встроенные политики](docs/built-in-policies.mdx) | Все 30 встроенных политик с параметрами |
-| [Пользовательские политики](docs/custom-policies.mdx) | Напишите свои политики |
-| [Конфигурация](docs/configuration.mdx) | Формат файла конфигурации и объединение областей видимости |
-| [Панель управления](docs/dashboard.mdx) | Мониторинг сеансов и проверка активности политик |
-| [Архитектура](docs/architecture.mdx) | Как работает система hooks |
-| [Тестирование](docs/testing.mdx) | Запуск тестов и написание новых |
+|-------|-------------|
+| [Getting Started](docs/getting-started.mdx) | Установка и первые шаги |
+| [Built-in Policies](docs/built-in-policies.mdx) | Все 30 встроенных политик с параметрами |
+| [Custom Policies](docs/custom-policies.mdx) | Напишите свои собственные политики |
+| [Configuration](docs/configuration.mdx) | Формат файла конфигурации и объединение областей |
+| [Dashboard](docs/dashboard.mdx) | Мониторинг сессий и проверка активности политик |
+| [Architecture](docs/architecture.mdx) | Как работает система хуков |
+| [Testing](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`. Контейнер следит за изменениями, если вы примонтируете директорию docs:
+Открывает сайт документации Mintlify на `http://localhost:3000`. Контейнер отслеживает изменения, если вы монтируете каталог документации:
 
 ```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**. Мы помогаем предприятиям и стартапам улучшить надежность своих ИИ-агентов благодаря нашим собственным агентам, программному обеспечению и опыту. Узнайте больше на [exosphere.host](https://exosphere.host).
 ```