6lj *%SrSSKJr SSKrSSKJrJrJrJrJ r \ \ \ \ \ \\ 4r Sr \R"S\R5S4\R"S\R5S 4\R"S \R5S 4\R"S \R5S 4\R"S\R5S4\R"S\R5S4\R"S\R5S4/rS\S'\R"S5r\R"S\R5S4\R"S\R5S4\R"S\R5S4\R"S\R5S4\R"S\R5S4\R"S \R5S4/rS\S!'S)S"jrS*S#jrS+S$jrS,S%jrS-S&jrS.S'jrS/S(jrg)0u@Filing metadata: what a document is, derived and displayed. A document carries filing_type, year, period and version as columns. Nothing displayable is stored beyond them: the label a card, the workspace header or an export filename shows is derived here at read time, so grooming the metadata corrects every label at once. `infer` pre-fills the metadata from a filename. It is a convenience and never authoritative — the upload form shows what it guessed and any field the user touches is pinned. The same rules live in `ui/src/metadata.js` for the form; `tests/playground/test_metadata.py` runs one case list through both so the two implementations cannot drift apart silently. The identity tuple (folder, filing_type, year, period, version) is what the overwrite flow keys on. It only exists when filing_type, year and period are all present, and it compares case-insensitively; `tuple_key` is that rule in one place. `overlap_key` is the same tuple without the version — two versions of one filing share it, which is exactly what the library's possible-duplicate flag reports. ) annotationsN)AnyDictIterableOptionalTuple)Q1Q2Q3Q4H1H2FYz$(?# UH!upURT5(dMUv M# g7fN)search).0rxlabelstems 7/home/mande/repo/quber/src/quber/playground/metadata.py infer..BsQ~)"4~s, ,NrQrrirrHrfirstr rrr) filing_typeyearperiod) rsplitresubnextrrr!groupintlower_YEAR_RE)filenamer-r/r.r#kindmr%s @r&inferr;;s ??3 "2 &D 66+r4 (DQ~QSWXK FD$$ IIdO  8 qwwqzl+S_D X qwwqzl+S_D V^qwwqzl+TC O-CD S[ %F S[ %F V^WWQZ--/7:TFF %%( | OOD ! qwwqz?D ~+/& GGc/nU(aURU5 SRSX!455nU(aURU5 U(aURSU35 SRU5$)uThe display label: `99-2 · Q1 2026 · v2` with missing parts omitted. Empty when the metadata is entirely absent — the title then stands alone. c3H# UHo(dM [U5v M g7fr )str)r"ps r&r'filing_label..ns6.QA&#a&&.s ""vu · )appendjoin)r-r.r/versionpartspys r& filing_labelrIcsaE [! 66.6 6B  R q ]# ;;u r<cUHfnU(dM UR5(dM#[R"SSUR55RS5SSnU(dMdUs $ g)uA filename-safe stem from the first non-empty candidate — label, then title, then original filename, per the label precedence.z [^a-z0-9]+-N<document)stripr1r2r6) candidatescr%s r& export_stemrQvsV 166-aggi8>>sCCRHDt  r<cPU=(d SR5R5$)Nr)rNr6)ss r&_normrTs G??  " " $$r<cU(aU(aU(dg[U5[U5[U5[U5U4$)uThe identity tuple, normalized for comparison — or None when it does not exist because filing_type, year or period is missing. Documents without a tuple never collide and never replace.N)rTr5)folderr-r.r/rFs r& tuple_keyrWs0 DV &M5-s4y%- QQr<c4[XX#SS9nU(aUSS$S$)ziThe tuple without its version: what v1/v2 siblings share, and what the possible-duplicate flag groups by.N)rF)rW)rVr-r.r/keys r& overlap_keyr[s% Ft DC3r7#t#r<c [U5n0nUHin[URS5URS5URS5URS55nUcMRURUS5S-X$'Mk UHkn[URS5URS5URS5URS55n[USL=(a X$S:5US'Mm g) zSet `overlap` on each document dict: True when another document shares its versionless tuple. Documents with incomplete metadata never flag.rVr-r.r/Nrroverlap)listr[getbool)docsrowscountsdrZs r&annotate_overlapsres :D35F !%%/155+?vPQPUPUV^P_` ? **S!,q0FK!%%/155+?vPQPUPUV^P_`CtO? a@) r<)r8r@returnzDict[str, Any]) r- Optional[str]r. Optional[int]r/rgrFrhrfr@)rOrgrfr@)rSrgrfr@) rVrgr-rgr.rhr/rgrFrhrfzOptional[TupleKey]) rVrgr-rgr.rhr/rgrfz#Optional[Tuple[str, str, int, str]])razIterable[Dict[str, Any]]rfNone)__doc__ __future__rr1typingrrrrrr@r5TupleKeyPERIODScompileIr__annotations__r7rr;rIrQrTrWr[rer<r&rsse*# 77 c3Xc]2 3 4 ZZ7>IZZ8"$$?JZZZZ0"$$7=ZZ*BDD16:ZZFMtT73 ::/ 0 ZZ5rtt