j ddlmZmZmZmZddlmZddlmZdZ Gdde Z Gdde Z Gd d e Z Gd d e Zd ede defdZy))AnyDictListOptional)Request) JSONResponsecodemessagec NeZdZdZ d dddedededeeeefffdZ xZ S) AppErroruoApplication-level error mapped to JSON response by ``app_error_handler``. ``details`` (optional, kw-only) is merged into the ``error`` payload by the handler — used by subclasses (e.g. ``StaleUpstreamError``) that need to surface structured remediation metadata. Existing call sites that omit ``details`` are unaffected: the response shape stays ``{"error": {"code", "message"}}``. Reserved keys (``code`` / ``message``) cannot appear in ``details`` — fail-fast at construction time. The handler also enforces base-fields-win on merge as defense in depth (review iter1 IMPORTANT). N)detailsr r status_coderc|r/|Dcgc] }|tvs |}}|rtdtd|||_||_||_|r t |ni|_t|!|ycc}w)Nz*AppError details cannot use reserved keys u — got ) _RESERVED_DETAIL_KEYS ValueErrorr r rdictrsuper__init__)selfr r rrkinvalid __class__s E/Users/manta/Documents/Projects/TheRoad-I1/backend/app/core/errors.pyrzAppError.__init__s ")H'QQ2G-Gq'GH @,-YwkC  &(/tG}R  !Is A,A,)i) __name__ __module__ __qualname____doc__strintrrrr __classcell__rs@rr r sT " " -1 """ " $sCx.) ""r cjeZdZdZdddddddedededeed eed eeed ed effd ZxZS)StaleUpstreamErroru(D6 §4.8 — preflight detection: upstream cp is stale. Raised by ``app.services.dispatcher_preflight.check_bg_catalog_freshness`` when ``background_master_plan`` and consumer manifests disagree on ``bg_catalog_hash`` / ``shot_binding_hash``, when a consumer manifest is missing under D6 mode, or when a manifest file is corrupt. HTTP 422. Direct attributes (``upstream`` / ``expected_*`` / ``observed_*`` / ``missing_in_render`` / ``remediation``) are also surfaced via ``self.details`` for the handler to serialize. N)expected_shot_binding_hashobserved_shot_binding_hashmissing_in_render remediationr upstreamexpected_bg_catalog_hashobserved_bg_catalog_hashr'r(r)r*r c,||_||_||_||_||_t |xsg|_||_||||d} ||| d<|xsd| d<|j rt |j | d<t |%d|xsd|d| y) N)r+r,r-r*r'r&r(r)STALE_UPSTREAMzSTALE_UPSTREAM upstream=r r rr) r+r,r-r'r(listr)r*rr) rr+r,r-r'r(r)r*r rrs rrzStaleUpstreamError.__init__;s! (@%(@%*D'*D'!%&7&=2!>&!(@(@& #  & 14NG0 14N4TRTG0 1  ! !+/0F0F+GG' ( !D!9(D  r#) rrrrrrrrr!r"s@rr%r%.s $594815% % #& % #& % %-SM % %-SM% $DI.% % % % r#r%c NeZdZdZdddedeededeeefdef fd ZxZS) VisibleStagingDriftErrorushot_director.visible_entity_ids ↔ shot_staging.camera_direction dual SOT drift 가 scene_detail 진입 직전에 감지되었음을 알리는 fail-fast. shot_staging 의 camera_direction NL 에 명시적 off-camera/off-screen/화면 밖 phrase 가 있는데 그 인접의 인물 이름이 director.visible 에 남아 있으면 drift. auto-fix 안 함 (consumer-side SOT 변조 위험) — 운영자가 shot_director force 재실행 또는 shot_staging force 재실행 으로 명시적 reconciliation 결정. HTTP 422. Direct attributes (``shot_label`` / ``visible`` / ``camera_direction`` / ``drift_entities`` / ``remediation``) 도 ``self.details`` 로 serialize. r&)r* shot_labelvisiblecamera_directiondrift_entitiesr*cP||_t||_||_t ||_|xsd|_|t||t ||j d}djdt|jD}t|-d|d|dd| y) Nushot_director force 재실행 (description-level gaze/offscreen 제외 재산출) 또는 shot_staging force 재실행 (camera_direction 재기획) 후 scene_detail 재진입.)r5r6r7r8r*z, c32K|]\}}|d|dyw)()N).0sidnms r z4VisibleStagingDriftError.__init__..s% *HwsBse1RDN*HsVISIBLE_STAGING_DRIFTu`: shot_director.visible 와 shot_staging.camera_direction 사이 dual SOT drift — staging 이 uV 를 명시적 off-camera 처리했으나 visible 에 남아 있음. auto-fix 안 함.r0r1) r5r2r6r7rr8r*joinsorteditemsrr) rr5r6r7r8r*r drift_reprrs rrz!VisibleStagingDriftError.__init__ps%G} 0">2&  * %G} 0">2++ # YY *01E1E1G*H   (,J,,-   r#) rrrrrrrrr!r"s@rr4r4csU &' ' c '  ' S#X ' ' ' r#r4c DeZdZdZdedededeeeefffd Z xZ S)ShotStagingOrientationErroruPatch C / Area A — content_surface / reflective_surface element 의 orientation 이 max_attempts (3회) 모두 빈 값으로 남음. HTTP 422. shot_staging step fail. 운영자가 analysis_dispatch mode=force 로 step 수동 재실행. raise 는 shot_staging.py 의 batch loop 안 `call_structured` try/ except Exception **밖**에서 실행되어야 broad except 에 swallow 되지 않는다 — umbrella spec Area A § 4.2 참조. batch_num total_batchesattempts violationsc ||_||_||_t||_|||t|d}t |dd|d|dt|jd|d d| y) N)rIrJrKrL SHOT_STAGING_ORIENTATION_MISSINGzshot_staging batch /z: zT element(s) with content_surface/reflective_surface class missing orientation after z attempts.r0r1)rIrJrKr2rLrrlen)rrIrJrKrLrrs rrz$ShotStagingOrientationError.__init__s#*  z*#* z* #  3%i[-t'()F*J(   r#) rrrrr rrrrrr!r"s@rrHrHsG       c3h(   r#rHrequestexcreturnc*K|j|jd}|jrJ|jjDcic]\}}|tvs||}}}|j ||}n|}t |jd|iScc}}ww)aUSerialize AppError to ``{"error": {...}}`` JSON. Base ``code`` / ``message`` always win over ``details`` to prevent a subclass from accidentally shadowing them via ``details={"code": ..., ...}`` (review iter1 IMPORTANT). ``StaleUpstreamError`` and other subclasses must surface remediation metadata under disjoint keys. r error)rcontent)r r rrErupdaterr)rQrRbaservmergederrs rapp_error_handlerr\sHH 5D {{$';;#4#4#6Y#641a!CX:X!Q$#6Y d$ OO#  ZsABB B 8BN)typingrrrrfastapirfastapi.responsesrr Exceptionr r%r4rHr\r=r#rrasg,,*,!"y!"H2 2 j4 x4 n) () XW8 r#