Қателер және сәтсіздік режимдері

Жалпы формат

CLI пайдаланушы қателері stderr-ге мынадай форматта шығарылады:

error: <message>

Команда нөлдік емес exit code-пен аяқталады.

Жиі кездесетін бұғаттаушы жағдайлар

Жағдай	Нені білдіреді	Не жасау керек
sync кезінде жергілікті өзгерістер	sync жұмыс ағашын жоюы мүмкін	aiman push орындау, өзгерістерді қолмен сақтау немесе --force пайдалану
push кезінде remote жаңа	жарияланған күй алға кетті	aiman sync орындау
Git тарихы айырылды	AIM күйді қауіпсіз таңдай алмайды	Git-ті қолмен қалпына келтіру
AI ортасы табылмады	адаптер base dir таппады	aim.local.yaml-да жолды көрсету
MCP env белгіленбеген	міндетті айнымалы жоқ	sync кезінде енгізу немесе aim.local.yaml-ға қосу
Жарамсыз Skill	name жоқ, файл сәйкес емес немесе дене бос	skills/<name>.md түзету
Жарамсыз MCP Item	міндетті өріс жоқ немесе YAML жарамсыз	mcp/<name>.yaml түзету
Remote-қа қол жоқ	Git репозиторийді оқи немесе жаза алмайды	желіні, credentials-ты және рұқсаттарды тексеру

--dry-run

Қауіпті операциялар үшін алдымен dry-run пайдаланыңыз:

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

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

--force

aiman sync --force жарияланған күйді қолданған кезде жергілікті өзгерістердің жоғалуына рұқсат береді.

Бұл флагты тек жергілікті жұмыс ағашын қалпына келтіруге немесе жоғалтуға болатын жағдайда пайдаланыңыз.