"""task bundle prepare 실패 타입.

`stage_targets` 안에 있던 것을 leaf 로 뽑았다. 그 모듈의 도크스트링은 이 예외가
"저수준 모듈에 정의"돼 있다고 적었지만, 실제로는 944줄에 `stage_integrate` 를
끌어오는 모듈이었다. 그래서 예외 타입 하나가 필요한 `plan_run_root` 가
`stage_targets` 전체를 끌어오게 되고, 반대로 `stage_targets` 는
`plan_run_root` 를 함수 본문에서 지연 import 해야 했다.

`stage_targets` 와 `run` 이 이 이름을 재노출하므로 기존 호출부는 바뀌지 않는다.
이 모듈은 아무것도 import 하지 않는다.
"""
from __future__ import annotations


class PrepareError(Exception):
    """surface to caller — task bundle prepare failed.

    run.py(final-verification) 와 container.py 가 whole-task 통합 헬퍼의 실패를
    같은 타입으로 받는다.
    """