failproofai 1.0.1-beta.0 → 1.0.1

package/.next/standalone/docs-old/ru/custom-policies.mdx

@@ -0,0 +1,358 @@
+---
+title: Пользовательские политики
+description: "Напишите свои правила на JavaScript — обеспечивайте соблюдение соглашений, предотвращайте дрейф, обнаруживайте сбои, интегрируйте с внешними системами"
+icon: code
+---
+
+Пользовательские политики позволяют писать правила для любого поведения агента: обеспечивать соблюдение соглашений проекта, предотвращать дрейф, блокировать деструктивные операции, обнаруживать зависшие агенты или интегрироваться с Slack, рабочими процессами одобрения и многим другим. Они используют ту же систему событий-хуков и решения `allow`, `deny`, `instruct`, что и встроенные политики.
+
+---
+
+## Быстрый пример
+
+```js
+// my-policies.js
+import { customPolicies, allow, deny, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "no-production-writes",
+  description: "Block writes to paths containing 'production'",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Write" && ctx.toolName !== "Edit") return allow();
+    const path = ctx.toolInput?.file_path ?? "";
+    if (path.includes("production")) {
+      return deny("Writes to production paths are blocked");
+    }
+    return allow();
+  },
+});
+```
+
+Установите её:
+
+```bash
+failproofai policies --install --custom ./my-policies.js
+```
+
+---
+
+## Два способа загрузки пользовательских политик
+
+### Вариант 1: На основе соглашений (рекомендуется)
+
+Поместите файлы `*policies.{js,mjs,ts}` в `.failproofai/policies/` и они автоматически загружаются — никаких флагов или изменений конфигурации не требуется. Это работает как git-хуки: положите файл, и всё просто работает.
+
+```
+# Уровень проекта — коммитится в git, совместно используется командой
+.failproofai/policies/security-policies.mjs
+.failproofai/policies/workflow-policies.mjs
+
+# Уровень пользователя — личные, применяются ко всем проектам
+~/.failproofai/policies/my-policies.mjs
+```
+
+**Как это работает:**
+- Сканируются оба каталога проекта и пользователя (объединение — не первый победитель)
+- Файлы загружаются в алфавитном порядке в каждом каталоге. Добавьте префикс `01-`, `02-` для управления порядком
+- Загружаются только файлы, соответствующие `*policies.{js,mjs,ts}`; остальные игнорируются
+- Каждый файл загружается независимо (fail-open для каждого файла)
+- Работают вместе с явными флагами `--custom` и встроенными политиками
+
+<Tip>
+Политики на основе соглашений — самый простой способ создать стандарт качества для вашей организации. Коммитьте `.failproofai/policies/` в git, и каждый член команды получит те же правила автоматически — никаких настроек по разработчикам не требуется. По мере обнаружения командой новых режимов отказа добавьте политику и отправьте. Со временем эти политики становятся живым стандартом качества, который постоянно улучшается с каждым вкладом.
+</Tip>
+
+### Вариант 2: Явный путь к файлу
+
+```bash
+# Установить с файлом пользовательских политик
+failproofai policies --install --custom ./my-policies.js
+
+# Заменить пути пользовательских политик
+failproofai policies --install --custom ./new-policies.js
+
+# Настроить несколько явных файлов (загружаются в порядке флагов)
+failproofai policies --install --custom ./security.js --custom ./workflow.js
+
+# Удалить все явные пути пользовательских политик из конфигурации
+failproofai policies --uninstall --custom
+```
+
+Разрешённые абсолютные пути хранятся в `policies-config.json` как `customPoliciesPaths`. Повторите `--custom` для настройки нескольких файлов. Существующие конфигурации с устаревшим полем `customPoliciesPath` продолжают работать. Файлы загружаются заново при каждом событии-хуке — кэширования между событиями нет.
+
+Каждая зарегистрированная политика отображается со своим переключателем на панели управления. Отключение политики записывает её ID с определением источника в `disabledCustomPolicies`; файл и его остальные политики продолжают загружаться, а отключённая политика исключается перед сопоставлением событий. Имена политик, дублирующиеся в разных файлах, имеют независимые переключатели.
+
+### Использование обоих вместе
+
+Политики на основе соглашений и явные файлы `--custom` могут сосуществовать. Порядок загрузки:
+
+1. Явные файлы `customPoliciesPaths` (в настроенном порядке)
+2. Файлы соглашений проекта (`{cwd}/.failproofai/policies/`, в алфавитном порядке)
+3. Файлы соглашений пользователя (`~/.failproofai/policies/`, в алфавитном порядке)
+
+---
+
+## API
+
+### Импорт
+
+```js
+import { customPolicies, allow, deny, instruct } from "failproofai";
+```
+
+### `customPolicies.add(hook)`
+
+Регистрирует политику. Вызывайте сколько угодно раз для нескольких политик в одном файле.
+
+```ts
+customPolicies.add({
+  name: string;                         // обязательно — уникальный идентификатор
+  description?: string;                 // показывается в выводе `failproofai policies`
+  match?: { events?: HookEventType[] }; // фильтр по типу события; опустите для сопоставления всех
+  fn: (ctx: PolicyContext) => PolicyResult | Promise<PolicyResult>;
+});
+```
+
+### Вспомогательные функции решений
+
+| Функция | Эффект | Используйте когда |
+|----------|--------|----------|
+| `allow()` | Разрешить операцию без вывода сообщения | Действие безопасно, сообщение не требуется |
+| `deny(message)` | Заблокировать операцию | Агент не должен выполнять это действие |
+| `instruct(message)` | Добавить контекст без блокировки | Дайте агенту дополнительный контекст для правильности |
+
+`deny(message)` — сообщение отображается Claude с префиксом `"Blocked by failproofai:"`. Один `deny` сокращает всю дальнейшую оценку.
+
+`instruct(message)` — сообщение добавляется к контексту Claude для текущего вызова инструмента. Все сообщения `instruct` накапливаются и доставляются вместе.
+
+<Tip>
+Вы можете добавить дополнительные рекомендации к любому сообщению `deny` или `instruct`, добавив поле `hint` в `policyParams` — никаких изменений кода не требуется. Это работает для пользовательских (`custom/`), проектных соглашений (`.failproofai-project/`) и пользовательских соглашений (`.failproofai-user/`) политик. Подробнее см. [Configuration → hint](/ru/configuration#hint-cross-cutting).
+</Tip>
+
+### Информационные сообщения разрешения
+
+`allow(message)` разрешает операцию **и** отправляет информационное сообщение обратно Claude. Сообщение доставляется как `additionalContext` в ответе stdout обработчика хука — тот же механизм, что используется `instruct`, но семантически отличается: это обновление статуса, а не предупреждение.
+
+| Функция | Эффект | Используйте когда |
+|----------|--------|----------|
+| `allow(message)` | Разрешить и отправить контекст Claude | Подтвердить пройденную проверку или объяснить пропуск проверки |
+
+Случаи использования:
+- **Подтверждения статуса:** `allow("All CI checks passed.")` — сообщает Claude, что всё хорошо
+- **Объяснения fail-open:** `allow("GitHub CLI not installed, skipping CI check.")` — сообщает Claude, почему проверка была пропущена, чтобы у него был полный контекст
+- **Несколько сообщений накапливаются:** если несколько политик возвращают `allow(message)`, все сообщения объединяются с новыми строками и доставляются вместе
+
+```js
+customPolicies.add({
+  name: "confirm-branch-status",
+  match: { events: ["Stop"] },
+  fn: async (ctx) => {
+    const cwd = ctx.session?.cwd;
+    if (!cwd) return allow("No working directory, skipping branch check.");
+
+    // ... check branch status ...
+    if (allPushed) {
+      return allow("Branch is up to date with remote.");
+    }
+    return deny("Unpushed changes detected.");
+  },
+});
+```
+
+### Поля `PolicyContext`
+
+| Поле | Тип | Описание |
+|-------|------|-------------|
+| `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
+| `toolName` | `string \| undefined` | Вызываемый инструмент (например `"Bash"`, `"Write"`, `"Read"`) |
+| `toolInput` | `Record<string, unknown> \| undefined` | Входные параметры инструмента |
+| `payload` | `Record<string, unknown>` | Полная сырая полезная нагрузка события от Claude Code |
+| `session` | `SessionMetadata \| undefined` | Контекст сеанса (см. ниже) |
+
+### Поля `SessionMetadata`
+
+| Поле | Тип | Описание |
+|-------|------|-------------|
+| `sessionId` | `string` | Идентификатор сеанса Claude Code |
+| `cwd` | `string` | Рабочий каталог сеанса Claude Code |
+| `transcriptPath` | `string` | Путь к файлу-стенограмме JSONL сеанса |
+
+### Типы событий
+
+| Событие | Когда оно срабатывает | Содержание `toolInput` |
+|--------|--------------|----------------------|
+| `PreToolUse` | Перед запуском инструмента Claude | Входные данные инструмента (например `{ command: "..." }` для Bash) |
+| `PostToolUse` | После завершения инструмента | Входные данные инструмента + `tool_result` (вывод) |
+| `Notification` | Когда Claude отправляет уведомление | `{ message: "...", notification_type: "idle" \| "permission_prompt" \| ... }` — хуки должны всегда возвращать `allow()`, они не могут блокировать уведомления |
+| `Stop` | Когда сеанс Claude заканчивается | Пусто |
+
+---
+
+## Порядок оценки
+
+Политики оцениваются в этом порядке:
+
+1. Встроенные политики (в порядке определения)
+2. Явные пользовательские политики из `customPoliciesPath` (в порядке `.add()`)
+3. Политики соглашений из проектного `.failproofai/policies/` (файлы в алфавитном порядке, `.add()` внутри)
+4. Политики соглашений из пользовательского `~/.failproofai/policies/` (файлы в алфавитном порядке, `.add()` внутри)
+
+<Note>
+Первый `deny` сокращает все последующие политики. Все сообщения `instruct` накапливаются и доставляются вместе.
+</Note>
+
+---
+
+## Транзитивные импорты
+
+Файлы пользовательских политик могут импортировать локальные модули используя относительные пути:
+
+```js
+// my-policies.js
+import { isBlockedPath } from "./utils.js";
+import { checkApproval } from "./approval-client.js";
+
+customPolicies.add({
+  name: "approval-gate",
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const approved = await checkApproval(ctx.toolInput?.command, ctx.session?.sessionId);
+    return approved ? allow() : deny("Approval required for this command");
+  },
+});
+```
+
+Все относительные импорты, достижимые из файла точки входа, разрешаются. Это реализуется путём переписывания импортов `from "failproofai"` в фактический путь dist и создания временных файлов `.mjs` для обеспечения совместимости ESM.
+
+---
+
+## Фильтрация типов событий
+
+Используйте `match.events` для ограничения срабатывания политики:
+
+```js
+customPolicies.add({
+  name: "require-summary-on-stop",
+  match: { events: ["Stop"] },
+  fn: async (ctx) => {
+    // Срабатывает только при завершении сеанса
+    // ctx.session.transcriptPath содержит полный журнал сеанса
+    return allow();
+  },
+});
+```
+
+Опустите `match` полностью, чтобы срабатывала при каждом типе события.
+
+---
+
+## Обработка ошибок и режимы отказа
+
+Пользовательские политики **fail-open**: ошибки никогда не блокируют встроенные политики и не вызывают сбой обработчика хука.
+
+| Отказ | Поведение |
+|---------|----------|
+| `customPoliciesPath` не установлен | Явные пользовательские политики не запускаются; встроенные и соглашения работают нормально |
+| Файл не найден | Предупреждение логируется в `~/.failproofai/hook.log`; встроенные продолжают |
+| Ошибка синтаксиса/импорта (явная) | Ошибка логируется в `~/.failproofai/hook.log`; явные пользовательские политики пропускаются |
+| Ошибка синтаксиса/импорта (соглашение) | Ошибка логируется; этот файл пропускается, остальные файлы соглашений загружаются |
+| `fn` выбросил исключение во время выполнения | Ошибка логируется; этот хук считается `allow`; остальные хуки продолжают |
+| `fn` занял больше 10 сек | Timeout логируется; считается `allow` |
+| Каталог соглашений отсутствует | Политики соглашений не запускаются; нет ошибки |
+
+<Tip>
+Для отладки ошибок пользовательских политик смотрите файл журнала:
+
+```bash
+tail -f ~/.failproofai/hook.log
+```
+</Tip>
+
+---
+
+## Полный пример: несколько политик
+
+```js
+// my-policies.js
+import { customPolicies, allow, deny, instruct } from "failproofai";
+
+// Prevent agent from writing to secrets/ directory
+customPolicies.add({
+  name: "block-secrets-dir",
+  description: "Prevent agent from writing to secrets/ directory",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (!["Write", "Edit"].includes(ctx.toolName ?? "")) return allow();
+    const path = ctx.toolInput?.file_path ?? "";
+    if (path.includes("secrets/")) return deny("Writing to secrets/ is not permitted");
+    return allow();
+  },
+});
+
+// Keep the agent on track: verify tests before committing
+customPolicies.add({
+  name: "remind-test-before-commit",
+  description: "Keep the agent on track: verify tests pass before committing",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = ctx.toolInput?.command ?? "";
+    if (/git\s+commit/.test(cmd)) {
+      return instruct("Verify all tests pass before committing. Run `bun test` if you haven't already.");
+    }
+    return allow();
+  },
+});
+
+// Prevent unplanned dependency changes during freeze
+customPolicies.add({
+  name: "dependency-freeze",
+  description: "Prevent unplanned dependency changes during freeze period",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = ctx.toolInput?.command ?? "";
+    const isInstall = /^(npm install|yarn add|bun add|pnpm add)\s+\S/.test(cmd);
+    if (isInstall && process.env.DEPENDENCY_FREEZE === "1") {
+      return deny("Package installs are frozen. Unset DEPENDENCY_FREEZE to allow.");
+    }
+    return allow();
+  },
+});
+
+export { customPolicies };
+```
+
+---
+
+## Примеры
+
+Каталог `examples/` содержит готовые к запуску файлы политик:
+
+| Файл | Содержание |
+|------|----------|
+| `examples/policies-basic.js` | Пять начальных политик, охватывающих распространённые режимы отказа агента |
+| `examples/policies-advanced/index.js` | Продвинутые паттерны: транзитивные импорты, асинхронные вызовы, скрубинг вывода и хуки завершения сеанса |
+| `examples/convention-policies/security-policies.mjs` | Политики безопасности на основе соглашений (блокировка записей .env, предотвращение переписывания истории git) |
+| `examples/convention-policies/workflow-policies.mjs` | Политики рабочего процесса на основе соглашений (напоминания о тестах, аудит записей файлов) |
+
+### Использование примеров явных файлов
+
+```bash
+failproofai policies --install --custom ./examples/policies-basic.js
+```
+
+### Использование примеров на основе соглашений
+
+```bash
+# Скопировать на уровень проекта
+mkdir -p .failproofai/policies
+cp examples/convention-policies/*.mjs .failproofai/policies/
+
+# Или скопировать на уровень пользователя
+mkdir -p ~/.failproofai/policies
+cp examples/convention-policies/*.mjs ~/.failproofai/policies/
+```
+
+Команда install не требуется — файлы автоматически подбираются при следующем событии-хуке.

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

@@ -0,0 +1,155 @@
+---
+title: Панель управления
+description: "Отслеживайте сеансы агентов, просматривайте вызовы инструментов и управляйте политиками"
+icon: chart-line
+---
+
+Панель управления failproofai — это локальное веб-приложение для мониторинга сеансов ваших AI-агентов и управления политиками. Узнайте, что делали ваши агенты, пока вас не было.
+
+---
+
+## Запуск панели управления
+
+```bash
+failproofai
+```
+
+Откроется по адресу `http://localhost:8020`.
+
+Панель управления читает данные локального проекта, сеанса и конфигурации failproofai непосредственно из файловой системы. Дополнительные функции с аутентификацией, такие как напоминания об аудите и приглашения, отправляют необходимую информацию для этих запросов (включая адреса электронной почты) на удалённые API.
+
+---
+
+## Страницы
+
+### Проекты
+
+Отображает все проекты Claude Code, OpenAI Codex, GitHub Copilot CLI _(бета)_, Cursor Agent _(бета)_, OpenCode _(бета)_, Pi _(бета)_, Hermes, OpenClaw, Factory Droid, Devin, Antigravity и Goose, найденные на вашем компьютере. Проекты Claude обнаруживаются в `~/.claude/projects/` (или пути, установленном через `CLAUDE_PROJECTS_PATH`); проекты Codex обнаруживаются сканированием каждой записи под `~/.codex/sessions/<YYYY>/<MM>/<DD>/*.jsonl` и группировкой по `cwd`, указанному в первой записи каждого сеанса; проекты Copilot CLI обнаруживаются сканированием каждого `~/.copilot/session-state/<sessionId>/workspace.yaml` (настраивается через `COPILOT_HOME`) и группировкой по его полю `cwd`; проекты Cursor Agent обнаруживаются сканированием метаданных каждого сеанса под `~/.cursor/agent-sessions/<sessionId>/` (настраивается через `CURSOR_HOME`, с проверкой `conversations/` и `sessions/` как резервных вариантов) для скалярного `cwd` в `meta.json` / `session.json` / `workspace.yaml`; проекты OpenCode обнаруживаются запросом к его БД SQLite по адресу `~/.local/share/opencode/opencode.db` через `opencode db --format json` (мы читаем таблицы `session` и `project` и группируем по `project_id`); проекты Pi обнаруживаются сканированием JSONL-записей каждого сеанса под `~/.pi/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl` (настраивается через `PI_SESSIONS_DIR`) и извлечением `cwd` из первой записи каждого сеанса; сеансы шлюза Hermes читаются непосредственно из хранилища SQLite каждого профиля — `~/.hermes/state.db` плюс `~/.hermes/profiles/<name>/state.db` (переопределяется через `HERMES_HOME` или `HERMES_DB_PATH` для одной базы данных) — и группируются в проекты `hermes-<profile>-<source>` по профилю и `source` (Slack/Telegram/cli/cron — сеансы шлюза не имеют cwd); сеансы шлюза OpenClaw читаются из `~/.openclaw/agents/<agentId>/sessions/*.jsonl` и группируются в проекты `openclaw-<agentId>-<channel>` по агенту и каналу (также без cwd); проекты Factory Droid обнаруживаются из JSONL-записей по адресу `~/.factory/sessions/<encoded-cwd>/*.jsonl` и группируются по cwd; проекты Devin из её БД SQLite по адресу `~/.local/share/devin/cli/sessions.db` (группируются по `working_directory` каждого сеанса); проекты Antigravity из JSONL-записей по адресу `~/.gemini/antigravity-cli/brain/<conversationId>/…/transcript_full.jsonl` и группируются по cwd; проекты Goose из её БД SQLite по адресу `~/.local/share/goose/sessions/sessions.db` (группируются по `working_dir` каждого сеанса). Проект, используемый несколькими CLI, отображается одной строкой со всеми соответствующими значками. Используйте раскрывающееся меню **CLI** над таблицей для фильтрации по определённому CLI агента; URL сохраняет ваш выбор как `?cli=claude|codex|copilot|cursor|opencode|pi|hermes|openclaw|factory|devin|antigravity|goose`.
+
+Hermes и OpenClaw имеют область пользователя и не имеют рабочего каталога для группировки, поэтому они отображаются как **сворачиваемое дерево папок** — профиль (или агент) на верхнем уровне, его каналы под ним — в то время как каждый CLI на основе cwd остаётся плоской строкой. Строки папок объединяют количество сеансов и самую последнюю активность всего, что под ними, свёрнутые папки запоминаются между визитами, а поиск по ключевому слову разворачивает совпадения.
+
+Каждый проект показывает:
+- Имя проекта (производное от пути папки)
+- Значок CLI — `Claude Code` (оранжевый), `OpenAI Codex` (фиолетовый), `GitHub Copilot` (синий), `Cursor Agent` (изумрудный), `OpenCode` (янтарный), `Pi` (розовый) и/или `Hermes` (индиго)
+- Дата самой последней активности сеанса
+
+Нажмите на проект, чтобы увидеть его сеансы.
+
+### Сеансы
+
+Отображает все сеансы в проекте. Каждый сеанс показывает:
+- ID сеанса
+- Время начала и окончания
+- Количество вызовов инструментов
+- Количество активности хука (политики, которые были применены)
+
+Используйте фильтр по диапазону дат и поиск по ID сеанса для сужения списка. Сеансы разбиваются на страницы.
+
+Нажмите на сеанс, чтобы открыть средство просмотра сеансов.
+
+### Средство просмотра сеансов
+
+Средство просмотра сеансов ответит на ключевой вопрос для автономных агентов: что сделал агент и остался ли он в пределах задачи? Значок CLI рядом с заголовком указывает, является ли сеанс записью Claude Code, OpenAI Codex, GitHub Copilot CLI, Cursor Agent, OpenCode, Pi, Hermes, OpenClaw, Factory Droid, Devin, Antigravity или Goose. Он показывает временную шкалу всего, что произошло в сеансе:
+
+- **Сообщения** — текстовые ответы Claude и подсказки пользователя
+- **Вызовы инструментов** — каждый инструмент, вызванный Claude, с его входными и выходными данными
+- **Активность политик** — для каждого вызова инструмента, какие политики были применены и какое решение они вернули
+
+Полоса статистики вверху показывает продолжительность сеанса, общее количество вызовов инструментов и сводку решений хука (количество allow / deny / instruct).
+
+Нажмите кнопку **Download Logs** для экспорта сеанса. Для сеансов Claude Code, Codex, Copilot, Cursor и Pi вы получаете оригинальную запись JSONL с диска без изменений; для OpenCode (чьи сеансы находятся в SQLite, а не на диске) вы получаете документ JSON, отражающий основные таблицы `session` / `messages` / `parts`.
+
+### Аудит
+
+Ориентированный на личность отчёт о том, как ваш агент на самом деле вёл себя в прошлых сеансах. Запускает то же сканирование, что и CLI `failproofai audit`, но отображает его как одноэкранный общий постер + четыре раздела ниже сгиба:
+
+1. **Постер** — заполняет первый видимый экран. Самодостаточный регион для захвата PNG с словесным знаком failproof_ai + этикетка аудита · индекс архетипа (`№ NN из 08`) + дата аудита · числовой балл (0–100) + таблетка рейтинга процентиля (`топ 15%`) · имя архетипа (один из `the optimist`, `the cowboy`, `the explorer`, `the goldfish`, `the paranoid architect`, `the precision builder`, `the hammer`, `the ghost`) + полоса 3 ключевых слов · строка редкости `// только N% агентов такого архетипа` · плитка сигила 8×8 пикселей · нижний колонтитул `audit yours → failproof.ai`. Три кнопки общего доступа расположены сразу за пределами окна захвата: `post your archetype` (X intent), `share on linkedin`, `download poster`. Захват выполняется через `html-to-image` так что PNG соответствует на экране визуализации пиксель за пиксель (пунктирные границы, маска логотипа SVG, градиенты, метрики шрифтов — всё сохраняется).
+
+2. **Сильные стороны** — спокойный список ✓ поведения, которое ваш агент уже делает правильно, вытекающее из данных живого аудита (чистый коэффициент вызовов инструментов, без прямых push в main, нет утечек учётных данных, нет штормов переповторов) — каждое появляется только когда соответствующая политика имеет чистую запись во времени аудита.
+
+3. **Причуды** — таблица того, что прошло незамеченным, ранжированная по серьёзности: `когда · что прошло + политика, которая бы это поймала · таблетка серьёзности · видно`, где повторяемость читается как `новое` (один раз), `N× видно` (2–9 раз) или `повторяющееся` (10+).
+
+4. **Как улучшить** — спокойный список, один на рекомендуемую политику: имя политики белым, однострочное описание, команда установки + кнопка копирования на правой стороне. Заголовок раздела читается как `включить всё N → прогнозируемый <score> · <tier>` (оценка, которую вы получите со всеми исправлениями), и его кнопка `[install all]` копирует объединённую команду `failproofai policy add a b c …` для каждой рекомендуемой политики.
+
+5. **Вернись лучше** — две карточки рядом. Слева: установить напоминание (выбор частоты `3d` / `7d` / `14d` / `30d`; сохраняется через `/api/auth/reminder` после аутентификации). Справа: разблокировать привилегии failproof — `invite a friend` открывает модальное окно, которое принимает список адресов электронной почты друзей, разделённых запятыми/пробелами/переводами строк (максимум 10 за отправку), POST их на `/api/audit/invite`, что перенаправляет на `POST /v0/invite` сервера api. Сервер api отправляет одно письмо на каждого получателя от `invite@failproof.ai` с копией отправителя и установленным `Reply-To`, так что получатель видит, кто его пригласил, а отправитель получает копию в своем почтовом ящике. Анонимные пользователи маршрутизируются через `AuthDialog` сначала, чтобы адрес электронной почты отправителя был известен до отправки приглашений. Выполнение прав / привилегий — последующее действие.
+
+Управляется выполнением `failproofai audit` — см. [Audit CLI](/ru/cli/audit) для базового механизма сканирования, поддерживаемых флагов и инвариантов кэша для каждой записи. Панель управления кэширует последний результат в `~/.failproofai/audit-dashboard.json` (режим `0600`, одиночный слот, новые запуски перезаписывают), поэтому повторные посещения мгновенны; **оба кэши для каждой записи и полного результата отклоняются при чтении, когда они старше 7 дней**, поэтому панель управления никогда не служит результатом возрастом в неделю — после TTL `/audit` переходит в состояние пустого значения и предлагает свежий запуск. Нажатие `[ re-audit now ]` близко внизу отчёта POST `/api/audit/run` с `noCache: true` — повторный аудит пропускает кэш для каждой записи и повторно сканирует каждую запись с нуля вместо того, чтобы молча возвращать кэшированный результат — и панель управления опрашивает `/api/audit/status` на частоте 1Hz до завершения запуска; липкая розовая полоса прогресса прикрепляется к верхней части видимого экрана во время запуска с таймером истекшего времени, и свежий результат переходит на место при успехе (без перезагрузки полной страницы; неудачный повторный аудит оставляет предыдущий отчёт нетронутым). При ошибке полоса становится красной с копией, ключируемой по `RerunError.kind` (`timeout` / `network` / `post_failed`). Состояние пустого значения (нет кэша или истекло) и состояние нулевых сеансов (кэш существует, но сканирование не нашло записей) выводятся отдельно.
+
+### Политики
+
+Двухвкладочная страница для управления политиками и проверки активности.
+
+<Tabs>
+  <Tab title="Вкладка Политики">
+  - Множественный выбор защиты каких CLI агентов failproofai обеспечивает с одной панели — Claude Code, OpenAI Codex, GitHub Copilot, Cursor Agent, OpenCode, Pi и Hermes все имеют строку со статусом установки (`Active` / `Detected` / `Inactive`), путём настроек области пользователя и брендовым акцентом. Отметьте или снимите флажки CLI, которые вы хотите, и нажмите `Apply changes` для установки/удаления diff за один шаг. CLI, двоичные файлы которых обнаруживаются в PATH, предварительно отмечены.
+  - Включайте или выключайте отдельные политики одним щелчком (пишет в `~/.failproofai/policies-config.json` — общий доступ для каждого установленного CLI)
+  - Разверните политику для настройки её параметров (для политик, поддерживающих `policyParams`)
+  - Установите пользовательский путь файла политик
+  </Tab>
+  <Tab title="Вкладка Активность">
+  - Полная разбитая на страницы история каждого события хука, которое было применено во всех сеансах
+  - Фильтр по решению, типу события, CLI (Claude Code / OpenAI Codex / GitHub Copilot _(бета)_ / Cursor Agent _(бета)_ / OpenCode _(бета)_ / Pi _(бета)_ / Hermes / OpenClaw / Factory Droid / Devin / Antigravity / Goose), имени политики или ID сеанса
+  - Каждая строка показывает: время, имя политики, решение, значок CLI (оранжевый = Claude Code, фиолетовый = OpenAI Codex, синий = GitHub Copilot, изумрудный = Cursor Agent, янтарный = OpenCode, розовый = Pi, индиго = Hermes, сине-зелёный = OpenClaw, розовый = Factory Droid, фиолетовый = Devin, голубой = Antigravity, лаймовый = Goose), имя инструмента, ID сеанса и причину решений deny/instruct
+  - Нажмите на ID сеанса, чтобы открыть его запись — средство просмотра автоматически определяет, какой CLI применил хук (Claude `~/.claude/projects/…`, Codex `~/.codex/sessions/…`, Copilot CLI `~/.copilot/session-state/<id>/events.jsonl`, Cursor Agent `~/.cursor/agent-sessions/<id>/events.jsonl`, OpenCode `~/.local/share/opencode/opencode.db`, Pi `~/.pi/agent/sessions/<encoded-cwd>/<id>.jsonl`, Hermes `~/.hermes/state.db`, OpenClaw `~/.openclaw/agents/<id>/sessions/*.jsonl`, Factory Droid `~/.factory/sessions/<encoded-cwd>/<id>.jsonl`, Devin `~/.local/share/devin/cli/sessions.db`, Antigravity `~/.gemini/antigravity-cli/brain/<id>/…/transcript_full.jsonl`, Goose `~/.local/share/goose/sessions/sessions.db`) и отображает соответствующий значок CLI в заголовке
+  </Tab>
+</Tabs>
+
+---
+
+## Автоматическое обновление
+
+Панель управления имеет переключатель автоматического обновления в верхней навигации. При включении текущая страница периодически обновляется, чтобы показать новые сеансы и активность политик по мере их появления. Необходимо для мониторинга долгоживущих сеансов автономных агентов.
+
+---
+
+## Отключение страниц
+
+Если вам нужны только некоторые части панели управления, установите `FAILPROOFAI_DISABLE_PAGES` в список имён страниц, разделённый запятыми:
+
+```bash
+FAILPROOFAI_DISABLE_PAGES=policies failproofai
+```
+
+Допустимые значения: `policies`, `projects`, `audit`.
+
+---
+
+## Настройка пути проектов
+
+По умолчанию панель управления читает из стандартного каталога проектов Claude Code. Переопределите его для пользовательских установок:
+
+```bash
+CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai
+```
+
+---
+
+## Доступ с небольшого хоста localhost
+
+При запуске панели управления в **режиме разработки** (`npm run dev`) и доступе к ней с имени хоста, отличного от `localhost` — например, пользовательского домена, удалённого IP или туннелированного URL — вы можете увидеть предупреждение вроде:
+
+```text
+⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
+```
+
+Это Next.js, блокирующий кросс-источник доступ к его HMR (горячая загрузка модулей) вебсокету, который является функцией только для разработки. Чтобы разрешить ваш хост, используйте флаг `--allowed-origins`:
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com
+```
+
+Для нескольких хостов или IP передайте список, разделённый запятыми:
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com,192.168.1.5
+```
+
+Вы также можете установить переменную окружения `FAILPROOFAI_ALLOWED_DEV_ORIGINS` вместо этого:
+
+```bash
+FAILPROOFAI_ALLOWED_DEV_ORIGINS=dashboard.example.com npm run dev
+```
+
+<Note>
+Это применяется только к режиму разработки. При запуске `failproofai` (режим производства) не существует вебсокета HMR и нет проблемы кросс-источника с ресурсом разработки.
+</Note>