# Хуки: защита конфигураций на поддержке + подсказка навыков

Два хука Claude Code, которые помогают безопасно дорабатывать типовые конфигурации 1С:

- **Защита от правки «на замке».** Если модель пытается напрямую (инструментами `Edit`/`Write`)
  изменить объект типовой конфигурации, который стоит на поддержке поставщика, редактирование
  **блокируется** — иначе оно молча сломает будущие обновления вендора. В отказе сразу даётся, что делать
  дальше под конкретный случай (доработать в расширении или явно разрешить редактирование).
- **Подсказка навыков.** Когда модель работает с исходниками 1С «вручную» (читает сырой XML, ищет по
  метаданным), хук ненавязчиво напоминает, что для этой задачи есть профильный навык (`meta-info`,
  `form-edit`, `mxl-*`, `skd-*` и т.п.). Не блокирует, подсказывает не чаще одного раза за сессию на группу.

Это дополнительный слой поверх проверок, которые уже встроены в сами навыки: навыки-мутаторы и так не дадут
испортить объект на поддержке. Хуки добавляют защиту для случаев, когда правят файлы **в обход навыков**.

> Хуки — возможность только Claude Code. На других платформах их нет; там работают встроенные в навыки проверки.

## Требования

**Node.js 18+** (тот же, что нужен для `/web-test`). Команда `node` должна быть доступна в PATH.

## Установка

### Через плагин — автоматически
Если навыки установлены как плагин (`/plugin install 1c-skills@cc-1c-skills`), хуки подключаются сами —
настраивать ничего не нужно.

### Вручную (при установке копированием папки навыков)
Копирование `.claude/skills/` хуки не переносит. Чтобы включить их:

1. Скопируйте каталог `hooks/` в проект, например в `<проект>/.claude/hooks/`.
2. Добавьте в `<проект>/.claude/settings.json`:

```json
{
  "hooks": {
    "PreToolUse": [
      { "matcher": "Edit|Write|MultiEdit",
        "hooks": [{ "type": "command",
          "command": "node \"${CLAUDE_PROJECT_DIR}/.claude/hooks/support-guard.mjs\"" }] }
    ],
    "PostToolUse": [
      { "matcher": "Read|Grep|Glob|Edit|Write|MultiEdit",
        "hooks": [{ "type": "command",
          "command": "node \"${CLAUDE_PROJECT_DIR}/.claude/hooks/skill-suggester.mjs\"" }] }
    ]
  }
}
```

## Настройка (`.v8-project.json`)

Поведение настраивается в файле проекта `.v8-project.json` — глобально и/или по конкретной базе
(`databases[].…`, переопределяет глобальное):

| Поле | Значения | По умолчанию | Что делает |
|------|----------|--------------|------------|
| `editingAllowedCheck` | `deny` / `warn` / `off` | `deny` | Реакция защиты: блокировать правку объекта на замке / только предупреждать / выключить проверку. |
| `skillSuggester` | `on` / `off` | `on` | Включает/выключает подсказки навыков. |

Источник истины по состоянию поддержки — сама выгрузка конфигурации; `.v8-project.json` лишь настраивает
реакцию.

## Что делать при отказе защиты

Текст отказа сам подсказывает варианты под конкретную ситуацию. Кратко:

- **Безопаснее всего** — вести доработку в расширении (навыки `cfe-borrow` / `cfe-patch-method`):
  состояние поддержки менять не нужно, обновления вендора сохраняются.
- **Либо** осознанно разрешить редактирование через навык `support-edit` (включить редактирование объекта,
  снять его с поддержки или включить возможность изменения всей конфигурации). Готовую команду под ваш
  случай печатает сам отказ.

## Проверка

```bash
node hooks/test/run.mjs
```

Прогоняет защиту и подсказку на реальных выгрузках и на временных тестовых данных (в `test-tmp/`, не
попадает в git; рабочие выгрузки не затрагиваются).