Конфигурация

​

Области конфигурации

​

Правила слияния

project:  ["block-sudo"]
local:    ["block-rm-rf"]
global:   ["block-sudo", "sanitize-api-keys"]

resolved: ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← дедублицированное объединение

project:  block-sudo → { allowPatterns: ["sudo apt-get update"] }
global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }

resolved: { allowPatterns: ["sudo apt-get update"] }   ← project побеждает, global игнорируется

project:  (нет записи block-sudo)
local:    (нет записи block-sudo)
global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }

resolved: { allowPatterns: ["sudo systemctl status"] }  ← переходит к global

​

Формат файла конфигурации

{
  "enabledPolicies": [
    "block-sudo",
    "block-rm-rf",
    "block-push-master",
    "sanitize-api-keys",
    "sanitize-jwt",
    "block-env-files",
    "block-read-outside-cwd"
  ],
  "policyParams": {
    "block-sudo": {
      "allowPatterns": ["sudo systemctl status", "sudo journalctl"]
    },
    "block-push-master": {
      "protectedBranches": ["main", "release", "prod"]
    },
    "block-rm-rf": {
      "allowPaths": ["/tmp"]
    },
    "block-read-outside-cwd": {
      "allowPaths": ["/shared/data", "/opt/company"]
    },
    "sanitize-api-keys": {
      "additionalPatterns": [
        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API key" }
      ]
    },
    "warn-large-file-write": {
      "thresholdKb": 512
    }
  },
  "customPoliciesPath": "/home/alice/myproject/my-policies.js"
}

​

Справочник полей

​

enabledPolicies

​

policyParams

​

hint (кросс-функциональный)

{
  "policyParams": {
    "block-force-push": {
      "hint": "Try creating a fresh branch instead."
    },
    "block-sudo": {
      "allowPatterns": ["sudo apt-get"],
      "hint": "Use apt-get directly without sudo."
    },
    "custom/my-policy": {
      "hint": "Ask the user for approval first."
    }
  }
}

​

customPoliciesPath

​

Политики на основе конвенций

​

llm

{
  "llm": {
    "model": "claude-sonnet-4-6",
    "apiKey": "sk-ant-..."
  }
}

​

Управление конфигурацией из CLI

• Параметры CLI агента — указывает агенту вызывать failproofai --hook <event> при каждом использовании инструмента:
  • Claude Code: ~/.claude/settings.json (пользователь), <cwd>/.claude/settings.json (проект), <cwd>/.claude/settings.local.json (локально)
  • OpenAI Codex: ~/.codex/hooks.json (пользователь), <cwd>/.codex/hooks.json (проект) — Codex не имеет локальной области
  • GitHub Copilot CLI (бета): ~/.copilot/hooks/failproofai.json (пользователь), <cwd>/.github/hooks/failproofai.json (проект) — Copilot не имеет локальной области. Записи хуков используют поля команд bash/powershell с ключом ОС и timeoutSec Copilot; файл содержит маркер version: 1 верхнего уровня. Поддержка Copilot CLI находится в бета-версии, пока мы проверяем схему записи events.jsonl (которую общедоступные документы не указывают) против дополнительных реальных сессий.
  • Cursor Agent (бета): ~/.cursor/hooks.json (пользователь), <cwd>/.cursor/hooks.json (проект) — Cursor не имеет локальной области. Записи хуков используют форму с Claude-подобной формой {type, command, timeout} (без разделения bash/powershell), но хранятся под camelCase ключами событий (preToolUse, beforeSubmitPrompt, …) в плоском массиве согласно схеме хуков Cursor; файл содержит маркер version: 1 верхнего уровня. Обработчик канонизирует camelCase → PascalCase через CURSOR_EVENT_MAP, поэтому существующие встроенные политики срабатывают без изменений. Поддержка Cursor Agent находится в бета-версии, пока мы проверяем транскрипт Cursor на диске (не указан в общедоступных документах) против дополнительных реальных установок.
  • OpenCode (бета): ~/.config/opencode/opencode.json + ~/.config/opencode/plugins/failproofai.mjs (пользователь), <cwd>/.opencode/opencode.json + <cwd>/.opencode/plugins/failproofai.mjs (проект) — OpenCode не имеет локальной области. В отличие от остальных пяти CLI, OpenCode не имеет системы внешних команд для хуков: он загружает в процессе плагины JS/TS, явно зарегистрированные через массив plugin: [] в opencode.json (автообнаружение из .opencode/plugins/ не это как загружаются плагины в opencode v1.14.33). Install помещает маленький сгенерированный шим плагина, который subprocess-вызывает бинарный файл failproofai и переводит JSON-ответ бинарного файла Claude-подобной формы обратно в семантику плагина: throw new Error() для отрицания tool-события (отменяет вызов инструмента), client.session.prompt(...) для instruct И для отрицания Stop / SubagentStop (отправляет причину отрицания как следующее пользовательское сообщение — единственный канал force-retry, так как session.idle только для уведомления и выброс из неё — это no-op), и no-op для allow. Шим канонизирует названия инструментов (lowercase → PascalCase через OPENCODE_TOOL_MAP) и ключи аргументов инструментов (camelCase → snake_case через OPENCODE_TOOL_INPUT_MAP для Read / Write / Edit, например filePath → file_path, oldString → old_string) перед отправкой в бинарный файл, поэтому встроенные проверки путей вроде block-read-outside-cwd, block-env-files и block-secrets-write срабатывают без изменений для вызовов инструментов OpenCode. Сессии живут в БД SQLite OpenCode в ~/.local/share/opencode/opencode.db; средство просмотра сессий на панели инструментов читает их через opencode db --format json и opencode export <id>. Поддержка OpenCode находится в бета-версии, пока мы проверяем поведение в разных версиях и против дополнительных реальных сессий. См. документацию плагинов OpenCode.
  • Pi (бета): ~/.pi/agent/settings.json (пользователь), <cwd>/.pi/settings.json (проект) — Pi не имеет локальной области. Pi загружает пакеты расширений TypeScript при запуске; файл параметров — это плоский массив строк {"packages": ["./relative/path", …]}. failproofai записывает одну запись packages-массива, указывающую на встроенную директорию pi-extension/. Расширение внутренне подписывается на события Pi tool_call / user_bash / input / session_start и shell-вызывает failproofai --hook <Event> --cli pi; обработчик канонизирует underscore_lower_snake_case → PascalCase через PI_EVENT_MAP, поэтому существующие встроенные политики срабатывают без изменений. Аргументы инструментов также канонизируются через PI_TOOL_INPUT_MAP (Pi’s Read / Write / Edit доставляют path вместо file_path; картирование верхнего уровня позволяет block-env-files и block-secrets-write срабатывать — block-read-outside-cwd уже имел fallback для path). Поддержка Pi находится в бета-версии, пока API расширений Pi и макет журнала сессий стабилизируются.
  • Hermes (hermes-agent): ~/.hermes/config.yaml (только область пользователя — Hermes не имеет конфига проекта/локально). Hermes — это шлюз Slack/Telegram, поэтому одна установка перехватывает вызовы инструментов от каждой платформы (Slack/Telegram/cli/cron) и внутренние подагенты. Записи хуков — это пара {command, timeout} (timeout в секундах) под картой hooks: с ключами от snake_case событий Hermes (pre_tool_call / post_tool_call / on_session_start / on_session_end / subagent_stop); обработчик канонизирует события через HERMES_EVENT_MAP и названия инструментов через HERMES_TOOL_MAP, поэтому встроенные политики срабатывают без изменений. Конфиг редактируется через коммент-сохраняющий YAML round-trip Document, поэтому остальные параметры оператора выживают, и install устанавливает hooks_auto_accept: true, чтобы headless шлюз (без TTY) запускал хуки без промпта согласия. Оценщик выдаёт контракт {"decision":"block","reason"} stdout Hermes (Hermes игнорирует коды выхода). Ограничения: Hermes не имеет event end-turn Stop, поэтому встроенные require-*-before-stop никогда не срабатывают для него (неприменимо, не сломано); instruct деградирует до allow-with-logged-note (нет канала дополнительного контекста); и переписывание выходных секретов (sanitize-*) не может переписать вывод инструмента через shell-hook контракт. Hermes — также оффлайн audit источник — панель инструментов читает сессии шлюза напрямую из ~/.hermes/state.db.
• policies-config.json — указывает failproofai, какие политики оценивать и с какими параметрами (общее для всех CLI агентов)

failproofai policies --install --cli codex --scope project
failproofai policies --install --cli copilot --scope project
failproofai policies --install --cli cursor --scope project
failproofai policies --install --cli opencode --scope project
failproofai policies --install --cli pi --scope project
failproofai policies --install --cli hermes --scope user
failproofai policies --install --cli claude codex copilot cursor opencode pi

• Один CLI обнаружен — автоматически выбирает тот CLI без запроса.
• Несколько CLI обнаружено в интерактивном терминале — показывает однострочный prompt выбора со стрелками, сгруппированный в раздел Detected (N) (с агрегированной строкой Install for all N detected + каждый обнаруженный CLI отдельно) и раздел Not installed (M) · install hooks ahead of time, перечисляющий каждый неподдерживаемый CLI как опцию forward-install (↑↓ для перемещения, Enter для выбора, ^C для выхода). Flow разустановки показывает только раздел Detected.
• Несколько CLI обнаружено в неинтерактивном запуске (CI, без TTY) — устанавливает для всех обнаруженных CLI без запроса.
• Ничего не обнаружено — возвращается к claude с предупреждением, что бинарный файл агента не найден в PATH; команда хука всё ещё записывается, поэтому она активируется, как только вы установите один.

​

Пример: конфиг уровня проекта с командными значениями по умолчанию

{
  "enabledPolicies": [
    "block-sudo",
    "block-rm-rf",
    "block-push-master",
    "sanitize-api-keys",
    "block-env-files"
  ],
  "policyParams": {
    "block-push-master": {
      "protectedBranches": ["main", "release", "hotfix"]
    }
  }
}