nx_civicmap_lib.nx

nx_civicmap_lib.nx -- THE CIVIC QUALITY-OF-LIFE MAP, all of its judgement and none of its plumbing. /compare/civicmap rungs CM1 (cm_layer_admit), CM2 (cm_fips_join), CM3 (cm_choropleth_emit) = milestone M0, "one honest layer on a real map". Admitted 2026-08-27; this is the first organ behind those contracts. THE THESIS, and it is the whole reason this organ exists rather than a spreadsheet and a JS map library: 1. A LAYER IS A DATA ADMISSION, NEVER CODE. Source, url, licence, resolution, cadence and mirror are ROWS. cm_layer_admit REFUSES a row that cannot say its licence or name its mirror, and the refusal NAMES THE RULE THAT FIRED -- a count without a worklist is not actionable. Adding a layer is adding data; a bad layer gets better data, never a deletion (rule 25). 2. ABSENCE IS NOT ZERO. The published record this map is built from is riddled with suppression: county death counts under ten are withheld for confidentiality, and the peer-reviewed finding is that ignoring that censoring SYSTEMATICALLY UNDERSTATES rural mortality. A choropleth that paints a suppressed county with the bottom-bucket colour publishes a lie in the safest-looking direction. ★★★★★★ AN UNOBSERVABLE CELL RENDERED AS A NUMBER IS A FALSE MEASUREMENT WITH AN AUTHORITATIVE COLOUR, AND NOBODY AUDITS THE REASSURING END OF A SCALE. So a county with no observation, or a suppressed one, emits data-state='UNOBSERVABLE' WITH A NAMED REASON AND NO data-value AT ALL -- structurally incapable of being read as a quantity. That is a machine-checkable contract, and nx_civicmap_gate bites it in both directions. 3. COVERAGE PRINTS BESIDE EVERY FIGURE. counties=, present=, unobservable= and their SUM are emitted on the page and on stdout. A partition is a claim: the parts must sum, and the sum is printed. COMPOSES, NEVER RE-IMPLEMENTS: geo_spatial_join (nx_geo_join, integer-exact point-in-polygon -- the PostGIS ST_Contains staple with no float, so boundary points can be neither dropped nor double-counted) and ep_artifact_path (nx_estate_path -- a verdict that changes with the caller's working directory is not a measurement). Numbers go out through nxi_fd (zero-alloc); file reads compose sys_read_file, which sizes its buffer from the file and CANNOT short-read, so there is no cap here to guess wrong. SCOPE, STATED SO IT CANNOT BE OVERREAD: this organ renders whatever counties are ADMITTED. It has no opinion about national coverage and never claims any -- the count it loaded is the count it prints. Banking the full public-domain TIGER county set is CM2's DATA half and is deliberately not smuggled in here as a hardcoded table. LIBRARY ONLY: there is deliberately NO main() here. The verbs and argv live in nx_civicmap.nx, so nx_civicmap_gate.nx can import THIS file and exercise every rule IN-PROCESS -- no fork, no deployed binary, and therefore no gate that measures a stale artifact instead of the source under test. It is also what lets the mutation harness reach the logic: a rule behind a fork boundary has zero mutation coverage, which is a defect this estate has already paid for and filed.// license_tier: ORIGINAL No hardware writes (Rule 26).