vjdZddlmZddlmZmZddlmZmZdZ dZ dZ dZ e e e hZd Zdd Zed Gd dZddZddZdZeGddZddZddZ ddZd dZd dZy)!uidispatch.executor_completion_contract — executor completion callback contract. task-2553+32 — EXECUTOR COMPLETION CALLBACK MANDATORY RULE 복원 (코드/파일 자동화). 회장 정정 (memory/events/task-2553.normal-callback-mandatory-doctrine-correction _260518.json): executor completion callback = MANDATORY lifecycle signal. NO-CRON ≠ executor completion callback 금지. This standalone module encodes that rule as executable code so that ANY future executor task cannot omit its normal completion callback (§1/§4). Standalone, zero-mutation: imports/edits ZERO tracked module. The huge dispatch/__init__.py body is NOT touched (§8 기존 산출물 수정 0). File-level contract only — the same pattern as anu_v3.callback_4tuple_index / anu_v3.result_ready_recovery (+29). NO-CRON note (9-R.1): this module performs ZERO cron register/remove. It only *declares and validates* the contract. The executor's normal completion callback is a designed lifecycle signal — NOT an ad-hoc cron-add by the registry/checkpoint, and NOT a cron-remove by +32 (회장 금지 준수). Closeout note (9-R.2): requiring an executor's own normal-completion callback / result.json / report / .done is a *lifecycle signal*, NOT an escalation of repository/task-state finalization authority. The latter (closeout 확정 권한) remains forbidden; the former is REQUIRED. ) annotations) dataclassfield)ListOptionalz(dispatch.executor_completion_contract.v1NORMAL_COLLECTOR_COMPLETEDRESULT_READY_NO_NORMAL_CALLBACKDISPATCH_FAILEDaRNO-CRON == registry/checkpoint(+29/+30/+31) MUST NOT arbitrarily add/remove cron. It does NOT mean the executor is forbidden from sending its normal completion callback. The executor normal completion callback is a MANDATORY lifecycle signal, not a registry-initiated ad-hoc cron, and is therefore explicitly exempt from the cron-add ban.cy)u§6.5 — executor completion callback is NOT a 'cron 신규 등록 금지' breach. Always False: the normal completion callback is a designed lifecycle signal, distinct from a registry/checkpoint ad-hoc cron add. Fr (dispatch/executor_completion_contract.py0is_executor_completion_callback_a_cron_violationr;s r T)frozenc:eZdZUdZded<ded<ded<ded<y) Callback4Tupleu{task_id, dispatch_cron_id, normal_collector_cron_id*, fallback_cron_id}. normal_collector_cron_id is MANDATORY (§4.5). A None/empty value makes the contract invalid (§6.12) — it is NOT a valid NO-CRON degradation. strtask_iddispatch_cron_id Optional[str]normal_collector_cron_idfallback_callback_cron_idN)__name__ __module__ __qualname____doc____annotations__r r rrrEs  L++""r rcg}|js|jd|js|jd|js|jd|js|jd|S)u3Return invalidity reasons (empty == valid). §6.12.z task_id emptyzdispatch_cron_id emptyu{normal_collector_cron_id missing — MANDATORY lifecycle signal (§4.5/§6.12). NO-CRON does NOT exempt this (§6.3/§6.5).u4fallback_callback_cron_id empty (safety path, §6.6))rappendrrr)treasonss rvalidate_4tupler"SshG 99'  /0 % % J  & &MN Nr ct| SN)r")r s rtuple_is_validr%dsq! !!r )result_json_presentdone_marker_presentreport_present%normal_callback_registration_evidencec~eZdZUdZded<dZded<dZded<dZded<dZded <dZ ded <e e Z d ed <y)ExecutorCloseoutEvidenceFboolr&r'r(r)Nrrclaims_finalization_authority)default_factory List[str]notes) rrrr&rr'r(r)rr-rlistr0r r rr+r+ssV %% %% ND 38)47.2m2+0!4/T2E92r r+cfg}|js|jd|js|jd|js|jd|js|jd|j s|jd|j r|jd|S)uFAIL reasons for an executor closeout (§4.4 / §4.6 / 9-R.2). Missing normal callback registration evidence == FAIL (not a valid closeout) even when result.json/.done/report all exist. zresult.json missingz.done marker missingzreport missingunormal callback registration evidence missing — executor normal completion callback is MANDATORY (§4.4/§4.6). Not a valid normal lifecycle completion.u<normal_collector_cron_id absent in closeout evidence (§4.5)uzcloseout evidence claims repository/task-state finalization authority — forbidden (9-R.2/§6.15). Lifecycle signal only.)r&rr'r(r)rr-)evr!s rvalidate_closeout_evidencer4s G ! !,- ! !-.  '( 3 3 1  & & J  '' M  Nr ct| Sr$)r4)r3s rcloseout_is_validr6s)"- --r cJ|stS|xs|}|rtS|rtStS)u§4.6 / §6.8 / §6.9 completion classifier. result.json + .done exist but normal callback never registered -> RESULT_READY_NO_NORMAL_CALLBACK (a recovery state, NOT a normal lifecycle complete). )r rr ) dispatch_okresult_present done_presentnormal_callback_registered has_results rclassify_completionr=s/ /rMs8#(!<:#D#!$o6 M $ # # #""  3 3  3>.  !%   .8 =r