failproofai 1.0.1-beta.0 → 1.0.1

package/.next/standalone/docs-old/ru/cli/audit.mdx

@@ -0,0 +1,132 @@
+---
+---
+title: Аудит прошлых сеансов (бета)
+description: "Подсчитайте, как часто агент совершал неэффективные или рискованные действия в прошлых записях"
+---
+
+<Note>
+  **Бета-функция.** Аудит поставляется в бета-версии, пока мы собираем
+  ранние отзывы. Каталог детекторов и формат отчета могут измениться до
+  следующего стабильного выпуска. Пожалуйста, откройте issue, если что-то
+  выглядит неправильно.
+</Note>
+
+Аудит воспроизводит ваши прошлые записи agent-CLI через систему политик failproofai и отображает поделяемый визуальный отчет на **странице `/audit`** — архетип вашего агента, оценку от 0 до 100 и точно то, какие политики могли бы поймать что.
+
+## Запустить
+
+Три способа — все приводят к одному отчету `/audit`.
+
+<CodeGroup>
+
+```bash npx (без установки)
+npx -y failproofai audit
+```
+
+```bash failproofai audit
+failproofai audit
+```
+
+```bash failproofai (панель управления)
+failproofai
+```
+
+</CodeGroup>
+
+<CardGroup cols={3}>
+  <Card title="Без установки" icon="bolt">
+    `npx -y failproofai audit` загружает failproofai, запускает сканирование и
+    открывает для вас панель управления — ничего не нужно устанавливать заранее.
+  </Card>
+  <Card title="Из CLI" icon="terminal">
+    `failproofai audit` запускает сканирование в вашем терминале, затем автоматически
+    открывает `localhost:8020/audit` по завершении.
+  </Card>
+  <Card title="Из панели управления" icon="gauge">
+    Запустите `failproofai` и нажмите **Audit** в навигационной панели (между
+    Policies и Projects) или откройте `/audit` напрямую.
+  </Card>
+</CardGroup>
+
+<Tip>
+  Запустите `failproofai audit -h` (или `--help`) для справки. Аудит работает
+  **полностью автономно** — учетная запись или сеть не требуются — и панель
+  управления продолжает работать, пока вы не остановите ее с помощью `Ctrl+C`.
+</Tip>
+
+Панель управления сканирует прошлые записи agent CLI на этом компьютере (Claude Code, Codex, Copilot, Cursor, OpenCode, Pi) и сообщает, как часто агент совершал действия, которые failproofai предназначен останавливать — проверки переменных окружения, принудительные push'и, избыточные префиксы `cd <cwd>`, sleep-polling циклы, повторное чтение только что отредактированных файлов и многое другое.
+
+Для каждой записи каждое событие использования инструмента воспроизводится через 39 встроенных политик **и** через 8 аудит-специфичных детекторов, которые ловят паттерны, еще не охватываемые политиками реального времени. Подсчеты агрегируются по политикам / детекторам во всех сеансах.
+
+## Что вы получите
+
+Страница `/audit` — это один экран, поделяемый **постер**, за которым следуют четыре раздела ниже сгиба:
+
+1. **Постер** — личность вашего агента с первого взгляда: его **архетип** (один из 8 — `optimist`, `cowboy`, `explorer`, `goldfish`, `paranoid architect`, `precision builder`, `hammer`, `ghost`), ключевые слова его персоны, насколько редок этот архетип, и **оценка от 0 до 100** с полосой уровня (`S` вплоть до `bottom tier`). Разработано для того, чтобы поделиться — опубликуйте в X или LinkedIn или загрузите как PNG.
+2. **`// strengths`** — то, что ваш агент уже делает хорошо, как реальные цифры из сканирования (например, clean-tool-call %, `0` попыток push-to-main), показано только там, где соответствующая политика имеет чистую историю.
+3. **`// quirks`** — то, что прошло незамеченным: ранжированная таблица поведений, которые failproofai бы перехватил — *когда* это произошло в последний раз, *что прошло* (и встроенная политика, которая бы это заблокировала), его *серьезность* и как часто *встречалось* (`new` / `recurring` / `N× seen`).
+4. **`// how to improve`** — список предписанных исправлений: по одной строке на политику с копируемой командой `failproofai policy add <slug>`, плюс кнопка **install all**, которая включает каждую рекомендацию сразу и показывает вашу **спрогнозированную оценку**, если вы это сделаете.
+5. **`// come back better`** — создайте привычку: установите **напоминание** о переаудите по электронной почте (`3d` / `7d` / `14d` / `30d`) или переаудит сейчас, и **пригласите друга** запустить собственный аудит (отправлено с failproof.ai, Cc для вас). Напоминания и приглашения требуют входа.
+
+## Запланированные аудиты
+
+Если вы запустите **failproofaid daemon** (см. [`failproofai config`](/ru/cli/install-policies)),
+он может переаудировать для вас по расписанию и обновлять отчет `/audit` в
+фоновом режиме. Это **отключено по умолчанию**, потому что сканирование читает *содержимое*
+каждой записи сеанса агента на этом компьютере — ничего не сканируется по таймеру,
+пока вы не попросите.
+
+Включите это в `~/.failproofai/config.toml`:
+
+```toml
+[audit]
+auto = true
+interval_days = 7
+```
+
+| Ключ | Значение |
+|---|---|
+| `auto` | `true` включает запланированное сканирование. Всё остальное — отсутствие, `false`, `"yes"` — отключено. |
+| `interval_days` | Дни между сканированиями. Ограничено 1–90; `0`, отрицательное или не-число откатывается на `7`. |
+
+- Расписание **по стенным часам**, поэтому оно переживает спящий режим и перезагрузки: ноутбук,
+  который спал после положенного времени, запускает **один раз** при пробуждении, никогда накопления.
+- Каждый запуск — это отдельный процесс с низким приоритетом (`nice 19`) — никогда путь
+  hook'а демона, который остается свободным для ответа на вызовы инструментов.
+- Сканирование пропускается, если `failproofai audit` или переаудит панели управления уже
+  выполняется; он переповторяется вскоре после, а не рассматривается как ошибка.
+- Прогресс записывается в `~/.failproofai/state/audit-schedule.json` (последний запуск,
+  когда следующий). Демон владеет этим файлом — измените кадр в `config.toml`.
+
+<Note>
+Если вы включили это на машине, установленной старой failproofai, запустите
+`failproofai config` один раз. Определение сервиса демона нуждается в одной
+дополнительной записи, прежде чем он сможет запустить CLI, и обновление
+является частью этой команды.
+</Note>
+
+## Аудит-специфичные детекторы
+
+Эти детекторы ловят паттерны "глупого поведения", не (пока) не принудительные в реальном времени. Они работают только во время аудита и никогда не блокируют живой вызов инструмента.
+
+| Детектор | Что он считает |
+|---|---|
+| `redundant-cd-cwd` | Bash команды, начинающиеся с `cd <cwd> && …`, хотя команды уже запускаются в `cwd`. |
+| `prefer-edit-over-read-cat` | `cat`/`head`/`tail`/`less`/`more` на одном исходном файле — используйте инструмент `Read`. |
+| `prefer-edit-over-sed-awk` | `sed -i` / `awk … > file` встроенные правки — используйте инструмент `Edit`. |
+| `prefer-write-over-heredoc` | Heredoc / многострочный `echo > file` запись файлов — используйте инструмент `Write`. |
+| `sleep-polling-loop` | Длинный `sleep N` (≥ 30s) или `while …; sleep …; done` polling циклы. |
+| `find-from-root` | `find /`, `find /home`, `find /usr` и т.д. — ограничьте до `cwd`. |
+| `git-commit-no-verify` | `git commit … --no-verify` / `-n`, пропуск hook'ов. |
+| `reread-after-edit` | `Read` файла, который был только что `Edit`/`Write` в том же сеансе. |
+
+## Кэши
+
+- **Кэш для каждой записи** в `~/.failproofai/cache/audit/<sha1>.json` с ключом по `(mtime, size, engineVersion, detectorVersion)` — автоматически инвалидируется при изменении записи или кода политики/детектора. Каждая запись также хранит timestamp `cachedAt` как **TTL метаданные** (не часть ключа кэша); записи старше **7 дней** отклоняются при чтении, поэтому долгоживущие результаты не переживают развивающееся назначение детектора.
+- **Кэш полного результата** в `~/.failproofai/audit-dashboard.json` (режим 0600). Позволяет панели управления отображаться мгновенно при навигации без переаудита. Также отклоняется при чтении спустя **7 дней TTL** — `/audit` затем падает на пустое состояние и запрашивает свежий запуск. Нажмите `[ re-audit now ]` около дна отчета для обновления — переаудит отправляет `noCache: true`, поэтому он обходит кэш для каждой записи и повторно сканирует каждую запись вместо возврата кэшированного результата; запуск транслирует прогресс через закрепленную верхнюю полосу и меняет результат на месте при успехе (без перезагрузки страницы; неудачный переаудит сохраняет предыдущий отчет).
+
+## Примечания
+
+- **Без изменений.** Аудит воспроизводится в режиме только чтения. `warn-repeated-tool-calls` пропускается, потому что его сайдкар для каждого сеанса иначе был бы изменен.
+- **Политики рабочего процесса пропускаются.** Политики `require-*-before-stop` срабатывают только на события `Stop` и `execSync` против живого состояния git — они не имеют значимой интерпретации "что бы произошло в 2025", поэтому они не появляются в подсчетах аудита.
+- **Пользовательские политики пропускаются.** User-supplied пользовательские hook'и не воспроизводятся (они могли измениться с момента исходного сеанса).

package/.next/standalone/docs-old/ru/cli/dashboard.mdx

@@ -0,0 +1,29 @@
+---
+title: Просмотр сессий
+description: "Запустите панель управления для просмотра сессий агентов и управления политиками"
+---
+
+```bash
+failproofai
+```
+
+Запускает веб-панель управления по адресу `http://localhost:8020`.
+
+## Опции
+
+| Флаг | Описание |
+|------|---------|
+| `--port <number>` | Порт для прослушивания (по умолчанию: `8020`) |
+| `--allowed-origins <origins>` | Разделённые запятыми хосты/IP-адреса, разрешённые для доступа к ресурсам разработки |
+
+Чтобы перенаправить панель управления на папку Claude проекта, отличную от стандартной, установите переменную окружения `CLAUDE_PROJECTS_PATH` при запуске.
+
+## Примеры
+
+```bash
+# Запуск на другом порту
+failproofai --port 9000
+
+# Использование пользовательского пути к проектам Claude через переменную окружения
+CLAUDE_PROJECTS_PATH=~/my-claude-projects failproofai
+```

package/.next/standalone/docs-old/ru/cli/environment-variables.mdx

@@ -0,0 +1,72 @@
+---
+title: Переменные окружения
+description: "Настройте поведение failproofai с помощью переменных окружения"
+---
+
+## Dashboard
+
+| Переменная | Описание |
+|----------|-------------|
+| `PORT` | Порт Dashboard (по умолчанию: `8020`) |
+| `CLAUDE_PROJECTS_PATH` | Переопределить расположение папок проектов Claude Code |
+| `FAILPROOFAI_DISABLE_PAGES=policies,projects` | Разделённый запятыми список страниц Dashboard, которые нужно скрыть |
+| `FAILPROOFAI_ALLOWED_DEV_ORIGINS` | Хосты/IP-адреса, разрешённые для доступа к ресурсам разработки. Аналогично `--allowed-origins`. |
+
+## Логирование
+
+| Переменная | Описание |
+|----------|-------------|
+| `FAILPROOFAI_LOG_LEVEL=info\|warn\|error` | Уровень логирования сервера (по умолчанию: `warn`) |
+| `FAILPROOFAI_HOOK_LOG_FILE` | Пользовательский путь к файлу логов hook, или `true` для значения по умолчанию (`~/.failproofai/logs/hooks.log`) |
+
+## Телеметрия
+
+failproofai по умолчанию отправляет анонимную телеметрию использования. Есть два способа
+отключить её, и они применяют наиболее строгий вариант — переменная окружения
+никогда не сможет повторно включить то, что отключено в конфигурационном файле.
+
+| Переменная | Описание |
+|----------|-------------|
+| `FAILPROOFAI_TELEMETRY_DISABLED=1` | Отключить анонимную телеметрию использования для этого процесса |
+
+Чтобы отключить её постоянно для машины, добавьте это в `~/.failproofai/config.toml`:
+
+```toml
+[telemetry]
+enabled = false
+```
+
+<Note>
+Конфигурационный файл — это опция, которую нужно использовать, если вы запускаете **демон failproofaid**.
+Демон является системным сервисом, и его окружение не включает
+переменные, экспортированные из вашей оболочки — поэтому `FAILPROOFAI_TELEMETRY_DISABLED` не может
+до него достичь. `[telemetry] enabled = false` читается и CLI, и демоном.
+</Note>
+
+Демон отправляет только собственную **жизненный цикл**: что он запустился (и завершился ли
+предыдущий запуск корректно), что он остановился, когда был порождён или перезапущен его worker оценки,
+когда задача сборщика завершилась ошибкой, и результат
+pull облачной политики. Они содержат низкомощные значения и счётчики — никогда путь файла,
+команду, политику, промпт или что-либо прочитанное из транскрипта. Нет
+события per-tool-call.
+
+## Аутентификация
+
+| Переменная | Описание |
+|----------|-------------|
+| `FAILPROOF_API_URL` | Переопределить базовый URL api-сервера, используемый диалогом аутентификации Dashboard. По умолчанию `https://api.befailproof.ai`; установите `http://localhost:8080` (или другой адрес) при запуске локального api-сервера. |
+| `FAILPROOFAI_AUTH_DIR` | Переопределить расположение, где хранится `auth.json` (по умолчанию: `~/.failproofai`). В основном полезно для изолированных тестов. |
+
+## Подсказка первого запуска
+
+| Переменная | Описание |
+|----------|-------------|
+| `FAILPROOFAI_NO_FIRST_RUN=1` | Пропустить подсказку, предлагающую установить политики при первом вызове `failproofai` без аргументов |
+
+## LLM (для оценки политик)
+
+| Переменная | Описание |
+|----------|-------------|
+| `FAILPROOFAI_LLM_BASE_URL` | Endpoint API LLM (по умолчанию: `https://api.openai.com/v1`) |
+| `FAILPROOFAI_LLM_API_KEY` | API ключ для политик на основе LLM |
+| `FAILPROOFAI_LLM_MODEL` | Название модели (по умолчанию: `gpt-4o-mini`) |

package/.next/standalone/docs-old/ru/cli/hook.mdx

@@ -0,0 +1,30 @@
+---
+title: Hook handler (внутренний)
+description: "Подпроцесс, который Claude Code вызывает при каждом событии инструмента"
+---
+
+```bash
+failproofai --hook <EventType>
+```
+
+Это команда, зарегистрированная в `settings.json` Claude Code командой `failproofai policies --install`. Вы обычно не вызываете это напрямую.
+
+Читает JSON-полезную нагрузку из stdin, оценивает все включённые политики и завершается с кодом, указывающим решение:
+
+| Код выхода | Решение | Эффект |
+|-----------|---------|--------|
+| `0` | `allow` | Разрешить действие |
+| `1` | `deny` | Заблокировать действие — Claude видит причину отказа |
+| `2` | `instruct` | Внедрить рекомендации в контекст Claude |
+
+### Поддерживаемые типы событий
+
+| Категория | События |
+|----------|---------|
+| **Выполнение инструментов** | `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, `PermissionDenied` |
+| **Жизненный цикл сессии** | `SessionStart`, `SessionEnd`, `Stop`, `StopFailure` |
+| **Взаимодействие пользователя** | `UserPromptSubmit`, `Notification`, `Elicitation`, `ElicitationResult` |
+| **Подагенты и задачи** | `SubagentStart`, `SubagentStop`, `TaskCreated`, `TaskCompleted`, `TeammateIdle` |
+| **Конфигурация** | `InstructionsLoaded`, `ConfigChange`, `CwdChanged` |
+| **Файловая система** | `FileChanged`, `WorktreeCreate`, `WorktreeRemove` |
+| **Контекст** | `PreCompact`, `PostCompact` |

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

@@ -0,0 +1,57 @@
+---
+title: Установка политик
+description: "Включите политики, чтобы они запускались при каждом вызове инструмента агента"
+---
+
+```bash
+failproofai policies --install [policy-names...] [options]
+```
+
+Добавляет записи хуков в файл настроек установленного CLI агента (Claude Code, OpenAI Codex или GitHub Copilot CLI _(beta)_), чтобы failproofai перехватывал вызовы инструментов.
+
+Сокращения: `failproofai p -i`
+
+## Опции
+
+| Флаг | Описание |
+|------|---------|
+| `--cli claude\|codex\|copilot` | CLI агента(ов) для установки; через пробел (например `--cli claude codex copilot`) или повторно. Пропустите, чтобы автоматически определить установленные CLI и выбрать. |
+| `--scope user` | Установить в файл настроек пользователя (Claude: `~/.claude/settings.json`; Codex: `~/.codex/hooks.json`; Copilot: `~/.copilot/hooks/failproofai.json`). По умолчанию. |
+| `--scope project` | Установить в файл настроек проекта (Claude: `<cwd>/.claude/settings.json`; Codex: `<cwd>/.codex/hooks.json`; Copilot: `<cwd>/.github/hooks/failproofai.json`). |
+| `--scope local` | Только Claude — установить в `<cwd>/.claude/settings.local.json`. Codex и Copilot не имеют области `local`. |
+| `--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
+
+# Установить для OpenAI Codex (область проекта)
+failproofai policies --install --cli codex --scope project
+
+# Установить для GitHub Copilot CLI (beta) для текущего проекта
+failproofai policies --install --cli copilot --scope project
+
+# Установить для всех трёх CLI одновременно
+failproofai policies --install --cli claude codex copilot
+```
+
+Когда указана опция `--custom <path>`, файл немедленно проверяется — он должен вызвать `customPolicies.add()` хотя бы один раз. Разрешённый путь сохраняется в `policies-config.json` как `customPoliciesPath`.

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

@@ -0,0 +1,31 @@
+---
+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-old/ru/cli/migrate.mdx

@@ -0,0 +1,91 @@
+---
+---
+title: Миграция домашней директории
+description: "Обновите ~/.failproofai до актуальной структуры и посмотрите, что произойдёт, перед тем как это запустить"
+---
+
+```bash
+failproofai migrate --dry-run   # вывести план, ничего не менять
+failproofai migrate             # запустить миграцию
+```
+
+Большинство пользователей никогда не вводят эту команду вручную. Она запускается автоматически при первой команде после обновления, и [`failproofai update`](/ru/cli/update) её включает. Используйте команду напрямую, когда хотите увидеть план перед выполнением или запустить миграцию отдельно.
+
+## Привязка к структуре, а не к версии
+
+`~/.failproofai/VERSION` хранит номер **структуры** — форму директории, а не релиз, который её создал. Миграции привязаны к этому номеру, что делает длительные промежутки дешёвыми:
+
+- Версии npm меняются при каждом релизе, десятки версий между двумя структурами.
+- Поэтому машина, которая пропускает тридцать релизов без **изменения структуры**, запускает **ноль** миграций, а не тридцать холостых операций.
+- А машина, которая пропускает сразу несколько структур, запускает каждый шаг по порядку, каждый шаг зная только свои два конца.
+
+Это важно, потому что npm не может обновить установленный пакет самостоятельно. Машина, которая стоит на одной версии месяцами и затем прыгает через несколько структур — это нормальный случай, а не экзотический.
+
+## Пробный запуск
+
+`--dry-run` выводит точную цепь и файлы, которые были бы сохранены в первую очередь, и ничего не меняет — ни миграции, ни резервной копии, ни записи в журнал:
+
+```
+На диске структура 2; эта сборка говорит на 3.
+Будет запущено 1 шаг(ов):
+  2 → 3  структура 2 → 3: перенести config.toml и credentials.toml в JSON, переместить
+         custom-policies/ обратно в policies/, вложить конфиг политик в корень
+
+Эти файлы будут скопированы в ~/.failproofai/migrations/backup-layout2 в первую очередь:
+  VERSION
+  config.toml
+  credentials.toml
+```
+
+## Что переносится, а что пересоздаётся
+
+Каждый путь в домашней директории объявляет, какие данные он содержит, и это определяет, может ли миграция его отбросить. Правило: **производные и пересоздаваемые можно удалить; всё, что вы ввели, всё, что ещё не доставлено, и всё, что идентифицирует машину, переносится.**
+
+| Переносится | Пересоздаётся или пере-загружается |
+|---|---|
+| `config.json` — параметры, `daemon.configured`, дополнительные пути захвата | Кэш аудита |
+| `credentials.json` — ваша регистрация в облаке | Управляемые облаком развёртывания (пере-загружаются и проверяются при следующей проверке) |
+| `policies-config.json` — ваш выбор политик и их параметры | Рабочее состояние демона |
+| `policies/` — ваши файлы политик и вспомогательные модули, которые они импортируют | |
+| `hook-activity/` — журнал решений, который читает панель управления | |
+| Недоставленные события, всё ещё в очереди на загрузку | |
+| `cursors/` — маркеры коллектора | |
+| Бинарный файл демона в `bin/` | |
+
+<Note>
+  Недоставленные события переносятся вместо удаления, потому что потеря была бы
+  постоянной, а не просто медленной: маркер коллектора уже продвинулся дальше всего,
+  что находится в очереди, поэтому ничто никогда не прочитает этот диапазон
+  транскрипта снова. Миграция также просит демон доставить то, что находится
+  в очереди, как только он закончит, поэтому обычный результат — что переносить нечего.
+</Note>
+
+Ключи, которые *более новая* версия записала в `config.json`, `credentials.json` или `policies-config.json`, также сохраняются, а не удаляются более старым читателем.
+
+## Запись, которую она оставляет
+
+```
+~/.failproofai/migrations/
+  applied.json                 одна запись за шаг: структура, CLI, время, длительность, результат
+  backup-layout<n>/            копии неходящихся файлов, сделанные перед первым шагом
+```
+
+`applied.json` — это то, что отвечает на вопрос "через что эта машина действительно прошла" — первый вопрос, который стоит задать, когда что-то выглядит неправильно после обновления. Приложите его к отчёту об ошибке.
+
+Резервная копия намеренно маленькая, а не копия всей директории: миграция больше не удаляет ничего ненужного по замыслу, поэтому то, от чего стоит страховаться — это *дефект в шаге*, и в этих нескольких файлах такой дефект был бы больнее всего.
+
+## Если шаг не удался
+
+Цепь там останавливается. `VERSION` отмечается как завершённый только пройденным шагом, поэтому домашняя директория остаётся помечена старой структурой и следующая команда повторит попытку — директория никогда не помечается как текущая на основе неполной миграции. Шаг записывается в `applied.json` с `"ok": false`, и резервная копия остаётся там, где она была сделана.
+
+## Более новая домашняя директория отказывается мигрировать
+
+Если `~/.failproofai/` была написана **более новым** failproofai, чем тот, который вы запускаете, команда остановится и скажет вам обновиться вместо этого. Эти данные в порядке и более новый CLI их читает; миграция «вперёд» из них — это не то, что существует, и их сброс уничтожит что-то восстанавливаемое.
+
+```
+Директория failproofai этой машины была написана более новой версией (структура 4;
+эта сборка говорит на 3). Обновитесь вместо миграции:
+  npm install -g failproofai@latest
+```
+
+Демон применяет то же правило: `failproofaid` отказывается запускаться против структуры, которую он не понимает, вместо того чтобы читать и писать пути, которые переместились.

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

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

package/.next/standalone/docs-old/ru/cli/update.mdx

@@ -0,0 +1,64 @@
+---
+title: Обновление после upgrade
+description: "Завершите вторую половину upgrade, которую npm не может сделать: перенесите домашнюю директорию и синхронизируйте демон"
+---
+
+```bash
+npm install -g failproofai@latest && failproofai update
+```
+
+Это полный upgrade. `npm` заменяет CLI; `failproofai update` делает остальное.
+
+## Почему нужна вторая команда
+
+`npm install -g` заменяет только одно — CLI. Две другие части установки failproofai находятся вне пакета специально и не перемещаются при запуске npm:
+
+- **`~/.failproofai/`**, ваши настройки, регистрация облака, выбор политик и история. Новая версия может организовать это по-другому, и реорганизация должна быть выполнена кодом, который знает обе структуры.
+- **Двоичный файл демона `failproofaid`**, в `~/.failproofai/bin/failproofaid-<version>`. Он намеренно *не находится* в `node_modules`: upgrade, который заменил бы файл под работающим сервисом, переполучил бы живой демон на двоичный файл, собранный из другого исходного кода, а удаление пакета удалило бы его из-под сервиса, который затем бы crash-loop при каждой загрузке.
+
+Итак, после одного `npm install -g` CLI новый, а демон — нет. `failproofaid` отказывается запускаться с макетом домашней директории, который он не понимает — громкая версия этого несоответствия вместо молчаливой — поэтому обе половины нужно привести в соответствие. `failproofai update` — это шаг.
+
+## Что он делает
+
+<Steps>
+  <Step title="Запускает все ожидающие миграции макета">
+    Читает макет, записанный в `~/.failproofai/VERSION` и выполняет шаги, которые приводят его к тому, который эта версия понимает. Обычно нет — см. [`failproofai migrate`](/ru/cli/migrate).
+  </Step>
+  <Step title="Устанавливает соответствующий двоичный файл демона">
+    Из пакета платформы, который npm уже загрузил по возможности (без сети), в противном случае из ресурса релиза для этой точной версии, проверенного SHA-256 перед использованием.
+  </Step>
+  <Step title="Перезагружает сервис и подтверждает, что он запустился">
+    Проверяется, а не предполагается — менеджер сервисов сообщает о активном процессе в момент его форка, что не то же самое, что его работа.
+  </Step>
+</Steps>
+
+## Опции
+
+| Флаг | Эффект |
+|------|--------|
+| `--no-daemon` | Перенесите только домашнюю директорию, оставив демон на текущей версии. |
+
+<Warning>
+  `--no-daemon` оставляет демон с несоответствующей версией на месте. На машине, настроенной на требование демона, каждое событие hook **завершается с ошибкой** если демон не может ответить — и демон, который отказывается запускаться с перенесённой домашней директорией, не может ответить. Лучше позвольте запуститься половине с демоном.
+</Warning>
+
+## Если что-то пошло не так
+
+Команда выходит с ненулевым кодом и говорит, какая половина не удалась. Два случая, которые стоит знать:
+
+- **Шаг миграции не завершился.** Домашняя директория остаётся отмеченной со своим *старым* макетом, поэтому следующая команда повторит попытку — домашняя директория никогда не помечается текущей на основе частичной миграции. Копии ваших настроек и регистрации были сохранены до запуска чего-либо в `~/.failproofai/migrations/backup-layout<n>/`.
+- **Демон не удалось перезагрузить без пароля.** `sudo -n` используется намеренно, поэтому ничто никогда не подсказывает из-под отображения прогресса. Команда выводит точную строку для самостоятельного запуска.
+
+<Note>
+  Здесь ничего не требует интерактивного мастера установки. Ваши настройки, регистрация облака и выбор политик сохраняются при upgrade, поэтому перенесённая машина применяет политики точно так же, как раньше — что особенно важно на машинах без пользователей: CI runner, машина парка, headless шлюз.
+</Note>
+
+## Автоматизация
+
+`failproofai update` неинтерактивный и безопасен для запуска, когда нечего делать — он сообщает о миграции, которая не была необходима, и выходит с кодом 0. Размещение его после каждого upgrade в скрипте подготовки или Dockerfile — это предусмотренное использование:
+
+```dockerfile
+RUN npm install -g failproofai@latest && failproofai update --no-daemon
+```
+
+(`--no-daemon` в сборке образа, где ещё нет сервиса для перезагрузки.)

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

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