j#SrSSKJr SSKJr SSKJrJrJrJ r SSK J r SSK J r SSKJr SSKJr \(aSS KJr S rS rSS jrg )uDocument heading review — demote page decoration the parser called a heading. The parser labels certain printed lines as section headings, and downstream consumers treat a heading as governing every chunk beneath it. When the label is wrong — a banner the page layout repeats at the top of its pages, or a table column label that leaked into the heading stream — that false context spreads across a large share of the document's text. Demotion is deliberately hard, because wrongly demoting a real heading strips section context from everything under it. Two witnesses must agree: 1. Geometry nominates: the same text appears as a heading on ``NOMINATION_PAGES`` or more pages, computed from the parse. 2. The heading-review agent confirms, judging only the nominated texts. A heading that appears on fewer pages is never put to the agent, and an unavailable review demotes nothing. One demotion follows from another instead of from a verdict. The parser can split a running header in two and label its first half a heading. Once the agent confirms a text as a running header, any heading occurrence whose text opens that header and is printed within ``SPLIT_HEADER_TOLERANCE`` of the header's position band is demoted too, whatever its page count. Every demotion is returned as a flag record, the run's record that the relabel happened and why. A verdict demotion names the text, its pages, the verdict and reason, and how many text items it governed. A split-header demotion names the page and where the line is printed against the header's band. ) annotations) defaultdict) TYPE_CHECKINGDictListSet) DocItemLabel)logger) LLMClient)CellFlag)DoclingDocumentg{Gz?c^# [[5n[[5m[[5nUR=(d 0R 5VVs0sH$upVXVR R=(d S_M& nnnURGH]nUR[R:XdM$URR5(dMEUR(aURSROSn X8RR5R!U 5 XHRR5==S- ss'UR(dMURSR"cMUR%U S5n TURR5R'[)SXRSR"R*- U - 55 GM` UR 5V V s0sHup[-U 5[.:dMX_M n n n U (d/$S(U4Sjjn[1U R 5SS9V V s/sHFupS U S XKS [-U 5S S R3S[1U 555SU"U 53 PMH nn n UR5SSR3U5-5IShvN nUc"[6R8"S[-U 55 /$UR:Vs0sHPnUR<S:wdMURR5U ;dM5URR5U_MR nnU(d/$[[5nSnURHRnUR[R:XaURR5nM=UU;dMEUU==S- ss'MT /nUR 5GH-un nSnURHmnUR[R:XdM#URR5U :XdMC[>RAUS[RB5 US- nMo [1X5n [6RD"SUR<U SS[-U 5UU 5 UR'[GUU SU U SUR<S[-U 5S S R3SU 55SUSUU SURH3 S95 GM0 UR 5V Vs0sHMun nUR<S:XdMTR%U 5(dM0U [KTU 5[)TU 54_MO nn nURGHnUR[R:wd+UR(aURSR"cMOURR5n URSRn UR%U S5n [)SXRSR"R*- U - 5nUR 5HununnURMU 5(a[-U 5[-U5:dM9U- Us=::a U[N-::dO MX[>RAUS[RB5 [6RD"S U SSU UUSS5 UR'[GUU U U SS!U<S"U S#US$S%US$S&US$S'3 S95 GM GM U$s snnfs sn n fs sn n fGNs snfs snn f7f))a.Demote confirmed page decoration from the document's heading stream. Relabels demoted headings to ``page_header`` in place on ``document`` and returns one flag record per demotion. Returns an empty list when nothing is nominated, the review backend does not support it, or the agent keeps everything. g?rNgc>TRU5nU(dg[U5[U5p2X2- S:a USSUSS3OUSS3nX2- S::aSOSnSUS U3$) Nzposition unknowng?.0%-z down the pageza fixed positionzvarying positionsz printed at , )getminmax)texttopslohibandfixed heading_topss >/home/mande/repo/quber/src/quber/core/fusion/heading_review.pyposition_evidence*review_headings..position_evidenceRsv%%TCIB57Wt^"S2c(.1Bs8SaIb&(go";NUG2dV,,c [US5*$)Nr)len)kvs r!review_headings..^sSAZKr")keyz- "u" — z# occurrence(s) as a heading across z pages (rc38# UHn[U5v M g7fNstr.0ps r "review_headings..]s4mc!ffmz); z&Nominated headings of this document:  zOheading review unavailable on this backend; keeping all {} nominated heading(s)section_headinglabeluNheading demoted ({}): {!r} — a heading on {} pages, governed {} text item(s)<heading_demotedz on c38# UHn[U5v M g7fr*r+r-s rr0r1s!8%Q#a&&%r2z ); relabeled z heading item(s) governing z text item(s); )sourcepagetitlerstatusnoterunning_headerzZheading demoted (split running header): {!r} on page {} at {:.0%} down the page opens {!r}z!first half of the running header z, printed on page z at rz' down the page where that header sits (r))rr,returnr,)(rsetlistintpagesitemssizeheighttextsr6r SECTION_HEADERrstripprovpage_noaddbboxrappendrtr$NOMINATION_PAGESsortedjoinreview_headingsr warningverdictsverdictobject __setattr__ PAGE_HEADERinfor reasonr startswithSPLIT_HEADER_TOLERANCE)documentllmr: heading_pages heading_countnor/ page_heightsitemr;hrrE nominatedr linesreviewvdemotedgovernedcurrentflagsrX relabeledbandstopheaderrrrs @rrUrU7s*5S)9M+6t+>;OR:V:V:XY:XB ,,:XLY ::44 49J9J+/99499Q<''!D ))//+ , 0 0 6 ))//+ , 1 ,yyyTYYq\..:!$$T3/TYY__./66s3YYq\EVEVEXEXAX\]@]7^_1>0C0C0Eh0EUWgIg0EIh  -")//"39OP QKD dV6--..QRUV[R\Q]^ II4fUm4 4 5S9J49P8Q SP   &&'QTXT]T]^cTd'de eF ~ ]  N   A 99) ) ./fflln .I      +3/HG ::44 4iioo'G   W  "   E  g NNDzz\888TYY__=NRV=V""4,2J2JKQ #y' \ OO "I J TN    1X('tCJ<8 !8%!889ykR))1$(8GWY  #)R%]]_ ,MD' ??. . A3?3C3CD3I As<%&L,>(?@@,    ::44 4DIISTIZIZIb yy yy|##   T3 '#IIaL--///145 % FHR%%d++D CK0G//3U"?U:UU   tWl.F.F G KKlSb s   LL!,;F:EWX\W]^!#Y&MbQTXUVWYZ]V^^_a   5!.D LQZi  fv sA]'+]/]'5]'B ]'$]'B]'] #] )0]'A ]&)]']7]']]?]A)]' A]'&]'C-]'3]!]!&!]!G]' ]'N)r`z'DoclingDocument'rar r:r,rAzList[CellFlag])__doc__ __future__r collectionsrtypingrrrrdocling_core.types.doc.labelsr logurur quber.agents.llm_clientr quber.core.extractors.baser docling_core.types.doc.documentr rRr_rUr"rr~s@<##116-/? Sr"