Ошибки и failure modes

Общий формат

Пользовательские ошибки CLI выводятся в stderr в формате:

text

error: <message>

Команда завершается с ненулевым exit code.

Ситуация	Что означает	Что сделать
Локальные изменения при `sync`	`sync` может затереть рабочее дерево	выполнить `aiman push`, сохранить изменения вручную или использовать `--force`
Remote новее при `push`	опубликованное состояние ушло вперёд	выполнить `aiman sync`
История Git разошлась	AIM не может безопасно выбрать состояние	восстановить Git вручную
AI-среда не найдена	адаптер не нашёл base dir	указать путь в `aim.local.yaml`
MCP env не задана	required переменная отсутствует	ввести при `sync` или добавить в `aim.local.yaml`
Невалидный Skill	нет `name`, не совпадает файл или пустое тело	исправить `skills/<name>.md`
Невалидный MCP Item	нет обязательного поля или YAML невалиден	исправить `mcp/<name>.yaml`
Нет доступа к remote	Git не может прочитать или записать репозиторий	проверить сеть, credentials и права

Для опасных операций сначала используйте dry-run:

bash

aiman push --dry-run
aiman sync --dry-run
aiman apply --dry-run

Dry-run показывает план без записи в Git, репозиторий инвентаря или AI-среды.

aiman sync --force разрешает потерю локальных изменений при применении опубликованного состояния.

Используйте этот флаг только если локальное рабочее дерево можно восстановить или потерять.