&j1=|SrSSKJr SSKrSSKJrJrJrJrJ r J r SSK J r J r SSKJr "SS\ 5r"S S \ 5r\R'S S 5r\R*"S 5rSSjrSSjrSS\"54SSjjrSSSjjrSSjrSSjrSSjrS SjrS!Sjr g)"uN Resolve a table's footnote reference markers to their definition text. A marker printed on a table cell points at a footnote, but the footnote's text can be printed in three places, each needing its own resolution step: 1. Below the table, inside the correction agent's crop. The agent already transcribed those as marker-and-text pairs (`FootnoteDef`), so pairing is a normalized-key match — `(1)`, `1` and a superscript one are the same marker. The crop ends where the page does, so a footnote that continues on the next page reaches the agent cut mid-sentence; when the scan tier's line for the same marker opens with everything the agent read and continues past it, that longer line is taken as the definition instead. 2. Beyond the crop: later on the page or on a following page, including a continuation block (markers `a` through `j` printed overleaf). Those are found by scanning the document's text lines in reading order after the table. Acceptance requires coherence: a matching line on the table's own page is trusted (it sits right under the table), and so is a line inside a run of consecutive marker-opened lines (the shape of a real continuation block). A solitary line whose leading token happens to be a digit, found on a distant page, proves nothing and is refused. 3. Nowhere as a footnote at all: a cross-reference to a NAMED SECTION of the document — `(Note 12)`, `Schedule II`, `(Addendum 3)` — points at a whole section, not a footnote line. WHICH markers are section references is the correction agent's judgement, made from the page image and carried on each mark's `kind`; nothing here infers it from the marker's wording. A section reference resolves to a POINTER — the heading that opens with the reference as written, plus its page — never to inlined text. Everything here is pure and deterministic. The demand-driven lookup agent (`quber.agents.footnote_lookup`) is the third tier for markers this module leaves unresolved; callers invoke it separately so the common case costs no model call. Every marker either resolves or lands in `unresolved`, and every marked definition either matches a marker or lands in `unreferenced` — nothing is silently dropped. Unmarked general notes are not exceptions: they carry no marker to match, and the consumer attaches them at table level. ) annotationsN) CollectionListLiteralOptionalSequenceTuple) BaseModelField) FootnoteDefcj\rSrSr%Sr\"\S9rS\S'\"\SS9r S\S '\"\S S9r S \S 'SS jr Sr g)FootnoteResolution0zEThe complete resolution for one table's markers, with its exceptions.)default_factoryzList['ResolvedFootnote']resolvedz?Markers (as printed) whose definition was not found in any tier)r description List[str] unresolvedz8Marked definitions that no marker on the table points atzList[FootnoteDef] unreferencedc[U5nURH*n[UR5U:XdMURs $ g)zAThe resolved text for a printed marker, matched by canonical key.N)canonical_markerrmarkertext)selfrkeyrs 9/home/mande/repo/quber/src/quber/core/fusion/footnotes.pytext_forFootnoteResolution.text_for=s9v&A)S0vv N)rstrreturn Optional[str]) __name__ __module__ __qualname____firstlineno____doc__r listr__annotations__rrr__static_attributes__r!r rrr0sKO).t)DH&D!UJ ',N'L# r rc\\rSrSr%Sr\"SS9rS\S'\"SS9rS\S'\"S S9r S \S 'S r g )ResolvedFootnoteFz;One marker paired with the text a reader should see for it.z"The marker as printed on the table)rr"rz>The definition text, or the pointer line for a Notes referencera$table: paired in the agent's own crop. scan: found by the reading-order scan beyond the crop. note_pointer: a Notes-section reference resolved to its heading and page. lookup: found by the demand-driven lookup agent. sibling: a definition printed under a neighboring table of the same series.z=Literal['table', 'scan', 'note_pointer', 'lookup', 'sibling']sourcer!N) r%r&r'r(r)r rr+rr0r,r!r rr.r.Fs>E$HIFCI"bcD#cLQ ZMF Ir r.u:⁰¹²³⁴⁵⁶⁷⁸⁹ᵃᵇᶜᵈᵉᶠᵍʰⁱʲᵏ0123456789abcdefghijku~^(?:\((?P\d{1,2}|[A-Za-z]{1,2}|[*†‡§]{1,3})\)|(?P\d{1,2}|[*†‡§]{1,3})|(?P[A-Za-z]{1,2})[.):])\s+c[R"SSU=(d S5R[5nUR S5R S5R 5$)zpA marker's identity independent of rendering: '(1)', '1' and a superscript one all key to '1'; letters casefold.z\s+z()[]z.:)resub translate _SUPERSCRIPTSstriprstripcasefold)rss rrrgsG vr6 nn[UUUS 9$s sn n fs snf) uqResolve every distinct marker on one table, in tier order. `markers` are the table's printed reference markers (the located marks plus the catalogued refs). `footnotes` are the agent's in-crop pairs. `trailing_lines` are the document's text lines in reading order after the table, each with its 1-indexed page — the scan tier's universe. `headings` are the document's section headings with their pages. `section_keys` are the canonical keys of the markers the correction agent judged to be cross-references to a named section of the document — that judgement is the agent's, made from the page image; nothing here infers it from the marker's wording or shape. A section reference resolves to a heading pointer or stays unresolved; it is never hunted as a footnote. Returns the resolution plus both exception lists; markers still unresolved here are the lookup agent's demand. rN note_pointerrrr0c3N># UHn[TU5(dMUv M g7fN)_extends).0cin_crops r $resolve_footnotes..sIjHWa4H11js% %scantablec3@# UHoR5v M g7frN)isalpharPchs rrSrTs/w wc3@# UHoR5v M g7frN)isdigitrYs rrSrTs37RJJLL7r[rrr)rr setdefaultrHlenrangesetadd_section_pointerappendr._scan_candidatesrnextanyr)markers footnotes table_pagetrailing_linesheadings section_keys defs_by_keydrrpage parsed_lines block_lenijkrr seen_keysprintedpointer candidateslongerrrRs @rresolve_footnotesr||s.+-K qxx( 3  " "3 * JXX:4)$/6LXc,''I A c,  ?1  % FA  #l## (:(F FA#l## (:(FqA5IL  c, (*HJ%Iw'cY&  c  &w9G 0gVd ef!!'* %cO  !&++GIjI4PF! 0fU[ \] 0gV] ^_   OO,G*Q-X^_ `  /w/ / /37333,Wh??? OO,G'R`a b   g &gla 0 :?OPQPXPX?Yaj?j9 xJUa bbWYPsKK#K>Kc UVs0sH5n[UR5(dM[UR5U_M7 nn[UR5n/nURHVnUR [U55nUb%UR [XsRUS95 MEUR U5 MX [XV[UR5S9$s snf)zFold externally found definitions into a resolution. Each found pair matching a still-unresolved marker resolves it under `source`; markers not found stay unresolved, and the rest of the resolution is unchanged.rLr^) rrr*rrgetrer.rrr) resolutionfoundr0rpby_keyrrrxs r absorb_lookuprs6; YU>Nqxx>X+qxx(!+UF YJ''(HJ(( JJ'0 1 = OO,G&&QWX Y   g & ) tJD[D[?\ Zs CCc6[U5n[U5nU(a[U5[U5::agUS[U5U:XagSRU5nSRU5n[U5[U5:=(a URU5$)a[Whether `longer` opens with the whole of `shorter` and continues past it, compared word by word with case, spacing and punctuation dropped so the two extractors' renderings of the same printed line agree. A hyphen dropped at a line break ('interest-only' against 'interestonly') is the remaining difference, so the comparison also joins the words.FNTr3)_wordsr`join startswith)shorterr{abjoined_ajoined_bs rrOrOs} wAvA A#a& 3q6{awwqzHwwqzH x=3x= ( JX-@-@-JJr cL[R"SUR55$)Nz [a-z0-9]+)r4findallr:rs rrrs ::lDMMO 44r c/n[XSS9HLuupVnUb USU:waMXc:XdUS:dUR5(aM8URUS5 MN U$)uVThe scan tier: every coherent line opening with `key`, in reading order. Coherent means the line is on the table's own page (it sits right under the table), or it belongs to a run of two or more consecutive marker-opened lines (a continuation block), or its marker is not purely numeric (a bare digit is the one leading token common prose also produces). The remaining case — a solitary numeric match on a distant page — is refused. The first entry is the scan tier's own answer; the rest matter only when the agent's in-crop text is being checked for a longer rendering of the same footnote. T)strictrrJ)zipr]re)rrrrsrkrparsedrqruns rrfrfsb"E"<4H >VAY#-    LL # I Lr c[U5nU(dgUH=up4[U5RU5(dM&SUR5SUS3s $ [R"SU5nU(dgUR S5n/n[R "SU5HnSn UHup4[R"S[U55n U bU R S 5U:waM?U R S5n U (a.U RU5(dURU 5(dMSUR5SUS3n O U c gURU 5 M U(aS RU5$S$) uThe pointer line for a section reference: the target's heading and page. The reference as the agent wrote it, normalized (spacing, punctuation, case dropped), must be the opening of a heading — 'Note 16' opens 'NOTE 16. Commitments and Contingencies', 'Schedule II' opens 'Schedule II — Valuation and Qualifying Accounts'. Two printed forms of the same target also agree: a reference written with a word where the heading opens with the bare number (or the reverse) matches on the number — 'Note 10' points at '10. Contingencies' — but only when the reference itself is a word-plus-number, never for a bare digit, and only at a digit boundary so '10' cannot open '104'. A reference naming several targets ('Notes 1 and 4') resolves when every number it names finds a heading; the pointer then lists them all. None when no heading matches — the reference then stays unresolved and flagged rather than pointing at nothing.NzSee z (page )z ([a-z]+)\drJz\d+z ([a-z]*)(\d+)rz; ) _heading_keyrr8r4rArBrrer) rxrmrrrqleadref_wordpointersnumberhitrEhwords rrdrd.sM w C     ( ( - -$**,wtfA6 6 88M3 'D zz!}HH**VS)"JD)<+=>AyAGGAJ&0GGAJEe..x88H._s5" 22s' ')rr:rs rrr[s" 7755 5 > > @@r )rr"r#r")rDr"r#zOptional[Tuple[str, str]])riz Sequence[str]rjSequence[FootnoteDef]rkintrlSequence[Tuple[str, int]]rmrrnzCollection[str]r#r)lookup)rrrrr0zLiteral['lookup', 'sibling']r#r)rr"r{r"r#bool)rr"r#r) rr"rrz/Sequence[Tuple[Optional[Tuple[str, str]], int]]rsz Sequence[int]rkrr#r)rxr"rmrr#r$)rr"r#r")!r) __future__rr4typingrrrrrr pydanticr r quber.agents.llm_clientr rr.r" maketransr7compiler@rrH frozensetr|rrOrrfrdrr!r rrsG#J# GG%/, y " Z\st ** 3 )$13*,$-K hc hc$hchc. hc ( hc " hchc\,4"  ) 0K"5 A   4*5ZAr