Каталог встроенных политик - Failproof AI

Установленный пакет является источником истины для доступности политик. Запустите failproofai policies после каждого обновления, так как записи каталога и поведение могут измениться в зависимости от версии пакета.

Рекомендуемая базовая конфигурация

Рекомендуемый выбор в настройке включает очистители секретов, защиту окружения, самозащиту, защиту от опасных команд и безопасность защищённых веток:

sanitize-jwt                 sanitize-api-keys
sanitize-connection-strings sanitize-private-key-content
sanitize-bearer-tokens       protect-env-vars
block-env-files              block-secrets-write
block-self-pause             block-failproofai-commands
block-sudo                   block-curl-pipe-sh
block-rm-rf                  block-push-master
block-force-push

«Рекомендуемое» намеренно уже, чем Всё. Политики инфраструктуры и рабочего процесса могут прерывать допустимые операции и должны быть включены для репозиториев и машин, которым они требуются.

Секреты и окружение

Политика	Триггер	Результат
`sanitize-jwt`	`PostToolUse`	Скрывает JWT-токены из вывода инструмента, прежде чем модель их увидит.
`sanitize-api-keys`	`PostToolUse`	Скрывает общие ключи OpenAI, Anthropic, GitHub, AWS, Stripe и Google.
`sanitize-connection-strings`	`PostToolUse`	Скрывает строки подключения к базе данных, содержащие учётные данные.
`sanitize-private-key-content`	`PostToolUse`	Скрывает содержимое тел приватных ключей PEM.
`sanitize-bearer-tokens`	`PostToolUse`	Скрывает токены авторизации bearer.
`protect-env-vars`	`PreToolUse` на инструментах shell	Блокирует команды, которые выводят переменные окружения.
`block-env-files`	`PreToolUse`	Блокирует чтение и запись файлов `.env`.
`block-read-outside-cwd`	`PreToolUse` на инструментах read, glob, grep или shell	Ограничивает чтение рабочей директорией сеанса.
`block-secrets-write`	`PreToolUse` на инструментах write	Блокирует запись в файлы с именами секретных ключей и учётных данных.

Опасные команды и инфраструктура

Политика	Триггер	Результат
`block-self-pause`	`PreToolUse`, `PermissionRequest`	Предотвращает агенту паузировать собственное принудительное исполнение.
`block-sudo`	`PreToolUse`, `PermissionRequest`	Блокирует `sudo`, если не совпадает шаблон разрешения.
`block-curl-pipe-sh`	`PreToolUse`	Блокирует загруженные скрипты, переданные напрямую в shell.
`block-rm-rf`	`PreToolUse`	Блокирует катастрофические рекурсивные шаблоны удаления.
`block-failproofai-commands`	`PreToolUse`	Предотвращает агентам изменение или удаление Failproof AI.
`block-kubectl`	`PreToolUse`	Ограничивает команды Kubernetes.
`block-terraform`	`PreToolUse`	Ограничивает команды Terraform и OpenTofu.
`block-aws-cli`	`PreToolUse`	Ограничивает команды AWS CLI.
`block-gcloud`	`PreToolUse`	Ограничивает команды Google Cloud CLI.
`block-az-cli`	`PreToolUse`	Ограничивает команды Azure CLI.
`block-helm`	`PreToolUse`	Ограничивает команды Helm.
`block-gh-pipeline`	`PreToolUse`	Ограничивает изменяющие операции GitHub CLI: рабочие процессы, запуски, слияния, релизы, кэш и секреты.

Безопасность Git и базы данных

Политика	Триггер	Результат
`block-push-master`	`PreToolUse`	Блокирует прямые отправки на настроенные защищённые ветки.
`block-force-push`	`PreToolUse`	Блокирует force-push; `--force-with-lease` остаётся разрешённым в текущей реализации.
`block-work-on-main`	`PreToolUse`	Блокирует коммиты и слияния на защищённых ветках.
`warn-git-amend`	`PreToolUse`	Предупреждает перед переписыванием коммита с `--amend`.
`warn-git-stash-drop`	`PreToolUse`	Предупреждает перед постоянным удалением или очисткой stash.
`warn-all-files-staged`	`PreToolUse`	Предупреждает при широком `git add -A`, `git add .` или `git add --all`.
`warn-destructive-sql`	`PreToolUse`	Предупреждает при `DROP`, `TRUNCATE` и `DELETE` без `WHERE` через известные клиенты базы данных.
`warn-schema-alteration`	`PreToolUse`	Предупреждает при известных операциях `ALTER TABLE` над столбцами и переименовании.

Пакеты, поведение системы и циклы агента

Политика	Триггер	Результат
`warn-package-publish`	`PreToolUse`	Предупреждает перед публикацией в реестры пакетов.
`warn-global-package-install`	`PreToolUse`	Предупреждает перед глобальной установкой пакетов.
`prefer-package-manager`	`PreToolUse`	Инструктирует агента использовать разрешённый менеджер пакетов.
`warn-large-file-write`	`PreToolUse` на инструментах write	Предупреждает выше настроенного порога размера файла.
`warn-background-process`	`PreToolUse`	Предупреждает при отсоединённых или долгоживущих фоновых процессах.
`warn-repeated-tool-calls`	`PreToolUse`	Предупреждает после трёх или более идентичных вызовов инструмента.

Рабочий процесс завершения задачи

Эти политики требуют обработчика, который выдаёт совместимое событие Stop.

Политика	Результат
`require-commit-before-stop`	Отказывает завершение, пока отслеживаемая работа остаётся незакоммичена.
`require-push-before-stop`	Отказывает завершение, пока коммиты остаются только локальными.
`require-pr-before-stop`	Требует pull request для текущей ветки.
`require-no-conflicts-before-stop`	Требует чистого слияния с настроенной базовой веткой.
`require-ci-green-before-stop`	Требует успешного завершения проверок CI для текущего HEAD.

Справочник параметров

Настраивайте параметры в объекте policyParams выбранной области видимости. Типы проверяются каждой политикой.

Политика	Параметр	Тип и значение по умолчанию
`sanitize-api-keys`	`additionalPatterns`	`pattern[]`, `[]`; записи содержат `regex` и `label`
`block-read-outside-cwd`	`allowPaths`	`string[]`, `[]`
`block-sudo`	`allowPatterns`	`string[]`, `[]`
`block-rm-rf`	`allowPaths`	`string[]`, `[]`
Блокаторы инфраструктуры	`allowPatterns`	`string[]`, `[]`
`block-secrets-write`	`additionalPatterns`	`string[]`, `[]`
`block-push-master`	`protectedBranches`	`string[]`, `["main", "master"]`
`block-work-on-main`	`protectedBranches`	`string[]`, `["main", "master"]`
`prefer-package-manager`	`allowed`, `blocked`	`string[]`, `[]`
`warn-large-file-write`	`thresholdKb`	`number`, `1024`
`require-push-before-stop`	`remote`, `baseBranch`	`string`, `"origin"`; `string`, `"main"`
`require-pr-before-stop`	`baseBranch`	`string`, `"main"`
`require-no-conflicts-before-stop`	`baseBranch`	`string`, `"main"`

{
  "enabledPolicies": ["block-sudo", "block-push-master"],
  "policyParams": {
    "block-sudo": {
      "allowPatterns": ["sudo systemctl status"]
    },
    "block-push-master": {
      "protectedBranches": ["main", "release"]
    }
  }
}

Шаблон разрешения расширяет возможности агента. Протестируйте точную токенизацию и варианты команд на целевом обработчике перед развёртыванием на всем парке.