# 오류 사전 — 중단 이유와 다음 행동
- BLOCKED는 무조건 시스템 고장이 아니라 현재 조건에서 안전하게 진행할 수 없다는 뜻입니다.
- 실패 뒤 자동 재시도/자동 rollback/삭제는 하지 않습니다.
- 출력의 `다음 행동`을 우선하고 아래 범주 문서를 봅니다.

| 범주 | 쉽게 말하면 | 다음 문서 |
|---|---|---|
| HOST | 바탕 환경/권한이 부족함 | [Host 준비](HOST_BOOTSTRAP.ko.md) |
| STORAGE | 같은 폴더 이름이지만 다른 디스크일 수 있음 | [저장소](STORAGE.ko.md) |
| MODEL | 모델의 출처/이름/자료형/검증이 맞지 않음 | [모델](MODEL_TOOLING.ko.md) |
| BUNDLE | 반입물 또는 patch 기준이 다름 | [배포 형식](RELEASE_FORMAT.ko.md) |
| RELEASE | 이전 작업/실행 상태/설정이 바뀜 | [복원](ROLLBACK.ko.md) |

## 주요 코드별 행동

| 코드 | 대응 |
|---|---|
| MAINTENANCE_REQUIRED | 기존 운영 도구로 Stop/reap와 writer/관리 컨테이너 정지 확인 |
| INTERRUPTED_DEPLOYMENT | recover로 inflight를 읽고 같은 apply를 반복하지 않음 |
| CURRENT_MISMATCH | 실제 image와 activation-proposal을 엔지니어가 대조, 링크 임의 변경 금지 |
| STORAGE_MOUNT_MISMATCH | findmnt/lsblk로 실제 UUID 대조, root 허용으로 우회 금지 |
| SOURCE_DIRTY | 개발 작업 변경 보존, 검토된 commit과 일치하는 snapshot 사용 |
| FULL_BUNDLE_REQUIRED | 작은 patch로 우회하지 않고 전체 image 포함 bundle 준비 |
| MODEL_PROFILE / MODEL_CONFIG | profile.json·manifest·pbtxt가 같은 모델인지 확인 |
| HELPER_CLEANUP_UNKNOWN | 정확한 helper 이름/ID를 조회, prefix 일괄 삭제 금지 |
| CONFIG_CHANGED | 옛 secret/설정을 덮지 말고 현재 계약을 반영한 새 release 준비 |
| DRIVER_REVIEW_REQUIRED | 승인 image와 실제 driver 조합 검토, 자동 upgrade 안 함 |

## 코드 색인

아래는 구현 문자열 색인입니다. 상태/상수도 포함되며 모든 코드가 오류는 아닙니다.

### HOST

`BOOTSTRAP_INTENT_EXISTS`, `COMPOSE_VERSION`, `DOCKER_CONFIG`, `DOCKER_SOCKET_EXPOSED`, `DOCKER_UNAVAILABLE`, `DRIVER_PACKAGE`, `DRIVER_POLICY_MISSING`, `DRIVER_REVIEW_REQUIRED`, `GPU_RUNTIME_MISSING`, `HOST_PACKAGES_INSTALLED`, `HOST_READY`, `HOST_UNSUPPORTED`, `PACKAGES_INSTALLED`, `PACKAGE_CONFLICT`, `PACKAGE_HASH`, `PACKAGE_LOCK`, `PACKAGE_PATH`, `RECOVERY_EMPTY`, `RECOVERY_OS`, `RECOVERY_OUTPUT`

### STORAGE

`BIND_FAILED`, `BIND_MISSING`, `DESTINATION_NOT_EMPTY`, `LOGICAL_MOUNT_CONFLICT`, `LOGICAL_NOT_EMPTY`, `LOGICAL_VIEW_MISSING`, `MOUNT_ID_UNAVAILABLE`, `MOUNT_PATH`, `MOUNT_UNKNOWN`, `MOVE_MANUAL_REQUIRED`, `MOVE_OVERLAP`, `ROOT`, `ROOTS_OVERLAP`, `ROOT_STORAGE_CONFIRMATION`, `STORAGE`, `STORAGE_ALIAS_OVERLAP`, `STORAGE_MOUNT_MISMATCH`, `STORAGE_NAME`, `STORAGE_PERMISSION`, `STORAGE_READ_ONLY`, `STORAGE_RENDER_MISMATCH`, `STORAGE_SCHEMA`, `STORAGE_SCOPE`, `STORES_OVERLAP`

### MODEL

`ENGINE_BATCH_PROFILE`, `ENGINE_CONTRACT`, `ENGINE_DESERIALIZE`, `ENGINE_NAMES`, `EXPORTED_NOT_VALIDATED`, `EXPORT_ADAPTER`, `EXPORT_OUTPUT`, `GPU_BUSY`, `HELPER_CLEANUP_UNKNOWN`, `HELPER_ID`, `HELPER_OWNERSHIP`, `MODEL_CHANGED`, `MODEL_CONFIG`, `MODEL_COPY`, `MODEL_DISK`, `MODEL_EXISTS`, `MODEL_GPU_MISMATCH`, `MODEL_HASH`, `MODEL_HELPER_FAILED`, `MODEL_INPUT_MAP`, `MODEL_INPUT_OUTPUT`, `MODEL_LINEAGE_REVIEW`, `MODEL_MOUNT_MISSING`, `MODEL_NOT_READY`, `MODEL_NOT_VERIFIED`, `MODEL_OPTIONS`, `MODEL_PROBE_FAILED`, `MODEL_PROFILE`, `MODEL_RECEIPT_REQUIRED`, `MODEL_TRT_MISMATCH`, `MODEL_UNKNOWN`, `MODEL_VERSION`, `PINNED_BUILDER`, `TRITON_MODE_UNKNOWN`, `TRITON_RESTART_REQUIRED`

### BUNDLE

`ARCHIVE_ENTRY`, `ARCHIVE_INVALID`, `ARCHIVE_PATH`, `ARCHIVE_PATH_CONFLICT`, `ASSET_HASH`, `ASSET_MISSING`, `ASSET_PATH`, `BUILD_CONTRACT_MISSING`, `BUNDLE_FIELDS`, `BUNDLE_FILES`, `BUNDLE_FILE_SPEC`, `BUNDLE_HASH`, `BUNDLE_INCOMPLETE`, `BUNDLE_MISSING`, `BUNDLE_PRIVATE_FILE`, `BUNDLE_SCHEMA`, `BUNDLE_SIZE`, `BUNDLE_SYMLINK`, `CHECKSUM_LIST`, `FILE_HASH`, `FILE_SIZE`, `FULL`, `FULL_BUNDLE_REQUIRED`, `FULL_REQUIRED`, `PATCH_IMAGES`, `PATCH_KIND`, `PATCH_PARENT`, `PATCH_SCOPE`, `SOURCE_CHANGED`, `SOURCE_DIRTY`, `SOURCE_MISSING`, `SOURCE_SHA`

### RELEASE

`COMPOSE`, `COMPOSE_BASE`, `COMPOSE_ISOLATION`, `COMPOSE_LAYER_MISSING`, `COMPOSE_NORMALIZATION`, `COMPOSE_ROUNDTRIP`, `COMPOSE_SERVICE_SCOPE`, `COMPOSE_VERSION`, `CONFIG`, `CONFIG_CHANGED`, `CONFIG_MISSING`, `CONFIG_SIZE`, `CONTAINER_ID`, `CONTAINER_NOT_READY`, `CURRENT_MISMATCH`, `DATA_COMPATIBILITY`, `DEPLOYED`, `DEPLOY_BUSY`, `IMAGES`, `IMAGE_ARCHIVE`, `IMAGE_HASH`, `IMAGE_ID_INVALID`, `IMAGE_MISSING`, `IMAGE_RENDER_MISMATCH`, `IMAGE_SPEC`, `INTERRUPTED_DEPLOYMENT`, `IP_CHANGED`, `MAINTENANCE_REQUIRED`, `PERSISTENT_MAPPING_CHANGED`, `PORT_OCCUPIED`, `PORT_QUERY`, `RELEASE_DISK`, `RELEASE_EXISTS`, `RELEASE_MISSING`, `RELEASE_TAMPERED`, `SITE_CHANGED`, `SITE_FIELDS`, `SITE_LAYERS`, `SITE_MODELS`, `SITE_PATH`, `SITE_SERVICES`, `SNAPSHOT_CHANGED`, `STATE_CHANGED`