vjNdZddlmZddlZddlmZddlmZddlm Z dZ dZ d Z d Z ejd ejZejd ejZejd ejZde zZeGddZddZdd ddZddZy)udispatch.spec_template_validator — mandatory normal-callback clause gate. task-2553+32 (§4.1 / §4.3 / §6.1 / §6.2 / §6.11). Validates that an executor task spec / generated dispatch prompt carries the MANDATORY executor normal completion callback clause, and provides an idempotent injector so a generated dispatch prompt auto-includes it. Standalone, zero-mutation: imports/edits ZERO tracked module (dispatch/__init__ .py untouched, §8). Pure stdlib. NO-CRON note (9-R.1): this module performs ZERO cron register/remove. It only inspects/normalizes spec text. The clause it enforces describes the EXECUTOR firing its own completion callback — a designed lifecycle signal, not a registry/checkpoint ad-hoc cron, and not a +32 cron-remove. ) annotationsN) dataclass)List)NO_CRON_CORRECTED_DEFINITIONz#dispatch.spec_template_validator.v1PASSFAILHOLD_FOR_CHAIRut(normal\s+completion\s+callback|정상\s*완료\s*콜백|completion\s+callback\s+cron|normal\s+collector\s+callback)u*(mandatory|필수|반드시|MUST|required)u0(발사|발화|fire|register|등록|send|발송)u[EXECUTOR COMPLETION CALLBACK — MANDATORY] 작업 완료 직후(정상 종료 직전) executor 는 ANU 에 normal completion callback cron 을 반드시 발사해야 한다. 이는 mandatory lifecycle signal 이며 NO-CRON 으로 생략 불가. callback 4-tuple = {task_id, dispatch_cron_id, normal_collector_cron_id(필수), fallback_callback_cron_id}. normal collector 성공 시 fallback cancel-on-success. c4eZdZUded<ded<eddZy)SpecValidationResultstrverdictz List[str]reasonsc(|jtk(S)N)r r)selfs #dispatch/spec_template_validator.pyokzSpecValidationResult.okAs||t##N)returnbool)__name__ __module__ __qualname____annotations__propertyrrrr r <s L  $$rr c|syttj|}ttj|}ttj|}|xr|xr|S)u>True iff the spec/prompt carries the mandatory clause (§6.1).F)r_CALLBACK_INTENTsearch _MANDATORY _FIRE_VERB) spec_text has_intent has_mandatoryhas_fires rspec_has_normal_callback_clauser%FsX &--i89J**956MJ%%i01H  4- 4H4rT)spec_location_knownc|sttdgSt|rttgSttdgS)u§4.3 / §6.1 / §6.2 — gate an executor spec/prompt. * clause present -> PASS * clause missing -> FAIL * spec template location unknown -> HOLD_FOR_CHAIR (§9 trigger) u[dispatch/spec template location unresolvable — cannot codify clause (§9 HOLD_FOR_CHAIR).uexecutor normal completion callback clause MISSING — every executor spec/prompt MUST require the executor to fire its normal completion callback (§4.3/§6.2). NO-CRON does not exempt this (§6.3/§6.5).)r HOLDr%rr)r!r&s r validate_specr)PsR # 6   'y1#D"--   )  rcr|r t|r|S|r|jdrdnd}|xsd|dtdS)u§4.1 / §6.11 — idempotently ensure the clause is in a dispatch prompt. Returns the prompt unchanged if the clause is already present, else appends the canonical MANDATORY_CALLBACK_CLAUSE. Pure string transform, no side effects, no cron.  )r%endswithMANDATORY_CALLBACK_CLAUSE)promptseps r!inject_completion_callback_clauser1nsE1&9 vt4"4Cl^C5#<"=R @@r)r!r rr)r!r r&rrr )r/r rr )__doc__ __future__rre dataclassesrtypingr%dispatch.executor_completion_contractrVALIDATOR_SCHEMArrr(compile IGNORECASErrr r.r r%r)r1rrrr;s # !9  2::CMM RZZ12== RZZ7 ? # # $$ $548,0< Ar