nx_varfacts_lib.nx

nx_varfacts_lib.nx -- VaM .var PACKAGE FACT EXTRACTION CORE (conversion tier, VaM lane). A .var is a ZIP archive. THE WALL THIS LANE LIVES BEHIND (standing policy 1785794796 + measure-dont-ship): VaM is a CAPABILITY TARGET -- asset BYTES (meshes/textures/morph deltas) never enter our products or our published plane. What this core reads is the CENTRAL DIRECTORY (file NAMES + sizes = the package's own manifest) and meta.json (the package's own declared license) -- the package describing itself, never its content. Extracted MEASUREMENTS flow to refcorpus behind the k>=8 admission wall like every other reference corpus. COMPOSES INCUMBENTS: EOCD/central-directory walk = the nx_zip_read shape (that organ is a hardwired PyTorch-.bin test, not a library -- the walk is factored HERE as callables); ZIP method-8 members inflate via nx_deflate_inflate, the SAME raw-DEFLATE core under nx_gzip_wrap and nx_zlib_wrap (capacity-bounded; NOT the retired duplicate nx_inflate, debt 1785854636). ★TAIL-WINDOW CONTRACT: the EOCD + central directory live at the END of a ZIP, so a 519MB .var measures from its last few MB. The caller hands the TAIL bytes + the true file size; if the central directory starts before the window, the probe REFUSES (ok=0) -- a partial census is a plausible undercount, which is worse than absence. Fact slots (flat i64, VF_N_SLOTS): [0] ok [1] entries [2] morphs(.vmi) [3] scenes(Saves/scene/*.json) [4] textures(jpg/png/tif) [5] clothing(/Clothing/) [6] hair(/Hair/) [7] plugins(.cs/.cslist/.dll) [8] appearance(.vap) [9] meta_found [10] meta_lho [11] meta_method [12] meta_csize [13] meta_usize ★2026-09-11 EXTENSION (VaM census lane, ADDITIVE -- every legacy slot above keeps its meaning): (1) THE WALK IS FACTORED INTO CALLABLES so vf_probe, the census CLI (nx_varcensus) and the gate share ONE walk: vf_cd_locate reads the EOCD and names the outcome (OK / NO-EOCD / ZIP64 / WINDOW / SHORT) instead of one ok=0 for five different reasons, and WINDOW hands the caller the exact window it must read (file_size - cd_abs, derived from the archive itself, so no tail size has to be guessed); vf_cd_entry reads ONE record. (2) vf_member_data: STORED bytes in place, DEFLATE through the incumbent nx_deflate_inflate sized from the member's DECLARED usize and required to decode to exactly usize -- no capacity constant to tune. CRC is NOT verified here (imprecision chosen: a corrupt meta.json fails its JSON parse and is counted as unparsed, it is never trusted). (3) vf_json_*: a DEPTH-AWARE reader for meta.json. A key is matched only as a DIRECT member of the object it is asked of, so a nested dependency's own licenseType can never answer for the package (vf_license below takes the FIRST occurrence in the byte stream; the census prints both readings so their agreement is measured, not assumed). license_tier: ORIGINAL No hw writes (Rule 26).