@mailwoman/codex 9.1.0 → 9.3.0

package/out/postcode-systems.d.ts

@@ -10,24 +10,119 @@
  *
  *   It is the shared source of truth for "which systems can this shape be" — consumed by the postcode
  *   anchor (to narrow which systems' street vocabularies it checks) and, in time, by the runtime
- *   pipeline's locale gate (so its format→locale scoring derives from the same patterns rather than
+ *   pipeline's `@mailwoman/locale-hint` stage (so its format→locale scoring derives from the same patterns rather than
  *   a second, divergent copy). The point is to unify the DATA, not to couple the modules: callers
  *   depend on this pure function, never on each other.
  *
  *   Note this is a SHAPE test, not a gazetteer-membership test. A bare `68161` matches the US,
- *   German, AND French 5-digit shapes, so it returns `["us", "de", "fr"]` — the shape alone cannot
- *   split the numeric-postcode systems. The anchor uses real gazetteer membership for the finer
+ *   German, French, Spanish and Italian 5-digit shapes, so it returns `["us", "de", "fr", "es", "it"]` —
+ *   the shape alone cannot split the numeric-postcode systems. The anchor uses real gazetteer membership for the finer
  *   call; this function answers the coarser, model-free "which systems is this shape even eligible
  *   for".
  */
 /**
  * A codex address-system code — the subpath under `@mailwoman/codex/<system>`.
  */
-export type SystemCode = "us" | "de" | "fr" | "ca" | "gb" | "jp" | "au" | "nz";
+export type SystemCode = "us" | "de" | "fr" | "es" | "it" | "ca" | "gb" | "jp" | "au" | "nz";
+/**
+ * Every address system with a postcode shape, in {@link SYSTEM_ACCEPTS} order. The one list a consumer that needs the
+ * universe of systems (rather than the systems a given code fits) should read, so it cannot drift from the table.
+ */
+export declare const SYSTEM_CODES: readonly SystemCode[];
 /**
  * Every address system whose own postcode shape accepts `postcode`. Empty when no system recognizes the shape (e.g. a
  * bare `27`, or a 7-digit run). O(number of systems) — a handful of cheap regex tests, run only on the few
  * postcode-shaped spans an address contains.
  */
 export declare function candidateSystemsForPostcode(postcode: string): SystemCode[];
+/**
+ * Postcode shapes whose code is UNIT-GRADE — a delivery-walk or street-block unit, categorically tighter than any
+ * locality centroid, so an EXACT hit on one may lead the admin ladder instead of following the locality-first epoch
+ * convention.
+ *
+ * The convention exists because most postal systems are AREA-class: an FR 5-digit zone is coarser than the commune it
+ * contains, so promoting it would trade a good answer for a worse one. Two systems are the other way round, and
+ * membership here is earned by MEASUREMENT of the code's granularity, never by "the code has letters in it":
+ *
+ * - **NL PC6** (`1012 LG`) — ~8 addresses per code; the CBS polygon centroid (#977, the original carve-out).
+ * - **GB unit** (`N7 0BT`) — ~15 addresses per code, 1,751,733 shipped from OS Code-Point Open. Measured 2026-08-10
+ *   against the panel-v2 GB rooftop truth: unit centroid within 1 km on 15/15 rows, median 38 m, max 100 m, while the
+ *   locality centroid the ladder returned instead was 5.1–14.6 km out.
+ * - **CA URBAN LDU** (`M1J 1A8`) — 843,739 six-character codes. Measured on 879 graded rows of the CA OSM-rooftop panel,
+ *   through the production candidate backend, ladder arm against ladder arm:
+ *
+ *   | 732 URBAN rows | p50 | p75 | p90 | ≤1 km | | -------------- | ---: | ---: | ---: | ---: | | locality-first | 2.51
+ *   km | 5.42 km | 9.53 km | 26.4% | | postcode-first | **78 m** | **162 m** | **373 m** | **94.7%** |
+ *
+ *   Closer on 90.4% of them. That is GB's tier on a sample fifty times larger than GB's.
+ *
+ * **CA RURAL is excluded, and the code says which.** Canada Post puts a `0` in the SECOND position of a rural forward
+ * sortation area, so `T0H 1M0` is rural and `M1J 1A8` is not — no lookup required. A rural LDU serves a delivery route
+ * rather than a block face, and it measures like one. On the same panel, the 114 rural rows:
+ *
+ * | 114 RURAL rows | p50       | p75         | p90         | ≤1 km     |
+ * | -------------- | --------: | ----------: | ----------: | --------: |
+ * | locality-first | **929 m** | **2.02 km** | **5.73 km** | **53.5%** |
+ * | postcode-first | 2.08 km   | 4.79 km     | 8.11 km     | 25.4%     |
+ *
+ * Postcode-first is closer on only 26.3% of them, so the pattern below admits `[1-9]` in that position and nothing
+ * else. `509 Main Street South-West Falher AB T0H 1M0` is the worked case: 0.29 km from the locality centroid and 43.18
+ * km from its own postal code.
+ *
+ * The pooled CA number hides that entirely — 0.10 km p50 across both populations reads as a uniform win and is not one.
+ * A tier claim that averages two granularities is the thing this table exists to prevent.
+ *
+ * Lives in codex (per-address-system postal reference) so the Node result assembly (`mailwoman/geocode-core`) and the
+ * demo's pin ranking consume ONE tier definition — the 2026-08-11 staged-repoint e2e measured the two disagreeing.
+ */
+export declare const UNIT_GRADE_POSTCODE: ReadonlyArray<RegExp>;
+/**
+ * True when a resolved postcode is an EXACT hit on a unit-grade code — the #977 three-way guard, shared by the Node
+ * ladder and the demo pin ranking:
+ *
+ * 1. The PARSED span is a full unit shape ({@link UNIT_GRADE_POSTCODE}), not a stem the user typed;
+ * 2. The node resolved (a coordinate is present — checked by the caller); and
+ * 3. The resolver's own hit is the FULL code, not a coarsened prefix (a 4-digit NL stem or a GB outward district is
+ *    AREA-class, and promoting it is the exact trade the epoch convention forbids).
+ */
+export declare function isUnitGradePostcodeHit(parsed: string, resolverName: string | undefined): boolean;
+/**
+ * Address systems whose AREA-grade postal code is still FINER than the locality containing it — the third granularity
+ * tier, between {@link UNIT_GRADE_POSTCODE} and the locality-first default.
+ *
+ * Whether a postal zone is coarser than its locality is a fact about a country's ADMINISTRATIVE geography, not about
+ * its postal system, and code length does not predict it: FR and DE are both 5-digit and land on opposite sides. France
+ * has ~35,000 communes and one code postal often spans several, so the commune is finer. A German Gemeinde can be
+ * enormous — Berlin is one WOF locality — so the PLZ is finer by a wide margin.
+ *
+ * Membership is earned by a full-panel measurement, the same bar {@link UNIT_GRADE_POSTCODE} sets for CA. Coordinate
+ * p50 on the OpenAddresses panels, locality-first (the default) against the postcode point:
+ *
+ * | country | rows  | locality-first | postcode point | verdict                                                                |
+ * | ------- | ----: | -------------: | -------------: | ---------------------------------------------------------------------- |
+ * | **DE**  | 2,997 | 5.84 km        | **1.24 km**    | postcode, on EVERY percentile incl. p99 (21.50 → 10.57)                |
+ * | FR      | 3,000 | **0.97 km**    | 2.64 km        | locality, closer on 77.5% of rows                                      |
+ * | IT      | 2,833 | **1.34 km**    | 3.05 km        | locality, closer on 66.4%                                              |
+ * | ES      | 2,929 | **0.68 km**    | 0.97 km        | locality, but near a coin flip — 46.1% of rows prefer the postcode     |
+ * | US      | 577   | **2.28 km**    | 4.15 km        | locality (see below)                                                   |
+ * | **JP**  | 586   | 4.93 km        | **0.48 km**    | postcode, closer on 97.3% of rows (p90 13.55 → 1.21, p99 19.63 → 3.54) |
+ *
+ * **The US row is measured on the population production actually sends to the ladder.** Its rooftop cascade is US-only
+ * by construction (`selectAddressPointsDB` composes `address-points-us-<slug>.db`), and it serves 94.2% of US queries,
+ * so only 577 of 10,000 panel rows reach an admin decision at all. Those are the rows no rooftop or interpolation
+ * extract could place, which skews rural — exactly where a locality centroid sits close and a ZIP zone is wide.
+ * Measured over all 10,000 rows instead, the US looks like a postcode-first country (2.41 km vs 3.63); that is a
+ * selection effect, and it is why this table reports 577 rows for the US and full panels for the others, which have no
+ * such cascade.
+ *
+ * **The JP row is the JP board through the served path** (`jp-served-resolve.run.ts`, 2,000 rows, seed 42): the 586
+ * rows carrying a postcode the candidate table keys, graded on the row's own entrance point — the locality-first answer
+ * is the municipality centroid, the postcode answer the code's 町域 centroid from the WOF extract.
+ */
+export declare const AREA_POSTCODE_FINER_THAN_LOCALITY: ReadonlySet<string>;
+/**
+ * True when this country's area-grade postal code outranks its locality. Absent or unknown country → false, so the
+ * locality-first convention is what an unscoped query gets.
+ */
+export declare function areaPostcodeLeadsLocality(country: string | undefined): boolean;
 //# sourceMappingURL=postcode-systems.d.ts.map

package/out/postcode-systems.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postcode-systems.d.ts","sourceRoot":"","sources":["../postcode-systems.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAWH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAkB9E;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,CAW1E"}
+{"version":3,"file":"postcode-systems.d.ts","sourceRoot":"","sources":["../lib/postcode-systems.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAaH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAoB5F;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAA6C,CAAA;AAE3F;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,CAW1E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,MAAM,CAUrD,CAAA;AAQD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAMhG;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,iCAAiC,EAAE,WAAW,CAAC,MAAM,CAAyB,CAAA;AAE3F;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE9E"}

package/out/postcode-systems.js

@@ -10,24 +10,26 @@
  *
  *   It is the shared source of truth for "which systems can this shape be" — consumed by the postcode
  *   anchor (to narrow which systems' street vocabularies it checks) and, in time, by the runtime
- *   pipeline's locale gate (so its format→locale scoring derives from the same patterns rather than
+ *   pipeline's `@mailwoman/locale-hint` stage (so its format→locale scoring derives from the same patterns rather than
  *   a second, divergent copy). The point is to unify the DATA, not to couple the modules: callers
  *   depend on this pure function, never on each other.
  *
  *   Note this is a SHAPE test, not a gazetteer-membership test. A bare `68161` matches the US,
- *   German, AND French 5-digit shapes, so it returns `["us", "de", "fr"]` — the shape alone cannot
- *   split the numeric-postcode systems. The anchor uses real gazetteer membership for the finer
+ *   German, French, Spanish and Italian 5-digit shapes, so it returns `["us", "de", "fr", "es", "it"]` —
+ *   the shape alone cannot split the numeric-postcode systems. The anchor uses real gazetteer membership for the finer
  *   call; this function answers the coarser, model-free "which systems is this shape even eligible
  *   for".
  */
-import { normalizeAuPostcode } from "./au/index.js";
-import { normalizeCaPostalCode } from "./ca/index.js";
-import { normalizePLZ } from "./de/index.js";
-import { normalizeCodePostal } from "./fr/index.js";
-import { normalizeUkPostcode } from "./gb/index.js";
-import { normalizeJpPostalCode } from "./jp/index.js";
-import { normalizeNZPostcode } from "./nz/index.js";
-import { isZipCode } from "./us/index.js";
+import { normalizeAuPostcode } from "#au/index";
+import { normalizeCaPostalCode } from "#ca/index";
+import { normalizePLZ } from "#de/index";
+import { normalizeCodigoPostal } from "#es/index";
+import { normalizeCodePostal } from "#fr/index";
+import { normalizeUkPostcode } from "#gb/index";
+import { normalizeCAP } from "#it/index";
+import { normalizeJpPostalCode } from "#jp/index";
+import { normalizeNZPostcode } from "#nz/index";
+import { isZipCode } from "#us/index";
 /**
  * Per-system membership test: each entry returns true when the string is accepted by that system's own postcode shape
  * (after that system's normalization — so `D-68161` reaches `de`, `1012 LM` reaches nothing here since NL has no slice
@@ -37,12 +39,19 @@ const SYSTEM_ACCEPTS = [
     ["us", (s) => isZipCode(s)],
     ["de", (s) => normalizePLZ(s) !== null],
     ["fr", (s) => normalizeCodePostal(s) !== null],
+    ["es", (s) => normalizeCodigoPostal(s) !== null],
+    ["it", (s) => normalizeCAP(s) !== null],
     ["ca", (s) => normalizeCaPostalCode(s) !== null],
     ["gb", (s) => normalizeUkPostcode(s) !== null],
     ["jp", (s) => normalizeJpPostalCode(s) !== null],
     ["au", (s) => normalizeAuPostcode(s) !== null],
     ["nz", (s) => normalizeNZPostcode(s) !== null],
 ];
+/**
+ * Every address system with a postcode shape, in {@link SYSTEM_ACCEPTS} order. The one list a consumer that needs the
+ * universe of systems (rather than the systems a given code fits) should read, so it cannot drift from the table.
+ */
+export const SYSTEM_CODES = SYSTEM_ACCEPTS.map(([system]) => system);
 /**
  * Every address system whose own postcode shape accepts `postcode`. Empty when no system recognizes the shape (e.g. a
  * bare `27`, or a 7-digit run). O(number of systems) — a handful of cheap regex tests, run only on the few
@@ -59,4 +68,116 @@ export function candidateSystemsForPostcode(postcode) {
     }
     return out;
 }
+/**
+ * Postcode shapes whose code is UNIT-GRADE — a delivery-walk or street-block unit, categorically tighter than any
+ * locality centroid, so an EXACT hit on one may lead the admin ladder instead of following the locality-first epoch
+ * convention.
+ *
+ * The convention exists because most postal systems are AREA-class: an FR 5-digit zone is coarser than the commune it
+ * contains, so promoting it would trade a good answer for a worse one. Two systems are the other way round, and
+ * membership here is earned by MEASUREMENT of the code's granularity, never by "the code has letters in it":
+ *
+ * - **NL PC6** (`1012 LG`) — ~8 addresses per code; the CBS polygon centroid (#977, the original carve-out).
+ * - **GB unit** (`N7 0BT`) — ~15 addresses per code, 1,751,733 shipped from OS Code-Point Open. Measured 2026-08-10
+ *   against the panel-v2 GB rooftop truth: unit centroid within 1 km on 15/15 rows, median 38 m, max 100 m, while the
+ *   locality centroid the ladder returned instead was 5.1–14.6 km out.
+ * - **CA URBAN LDU** (`M1J 1A8`) — 843,739 six-character codes. Measured on 879 graded rows of the CA OSM-rooftop panel,
+ *   through the production candidate backend, ladder arm against ladder arm:
+ *
+ *   | 732 URBAN rows | p50 | p75 | p90 | ≤1 km | | -------------- | ---: | ---: | ---: | ---: | | locality-first | 2.51
+ *   km | 5.42 km | 9.53 km | 26.4% | | postcode-first | **78 m** | **162 m** | **373 m** | **94.7%** |
+ *
+ *   Closer on 90.4% of them. That is GB's tier on a sample fifty times larger than GB's.
+ *
+ * **CA RURAL is excluded, and the code says which.** Canada Post puts a `0` in the SECOND position of a rural forward
+ * sortation area, so `T0H 1M0` is rural and `M1J 1A8` is not — no lookup required. A rural LDU serves a delivery route
+ * rather than a block face, and it measures like one. On the same panel, the 114 rural rows:
+ *
+ * | 114 RURAL rows | p50       | p75         | p90         | ≤1 km     |
+ * | -------------- | --------: | ----------: | ----------: | --------: |
+ * | locality-first | **929 m** | **2.02 km** | **5.73 km** | **53.5%** |
+ * | postcode-first | 2.08 km   | 4.79 km     | 8.11 km     | 25.4%     |
+ *
+ * Postcode-first is closer on only 26.3% of them, so the pattern below admits `[1-9]` in that position and nothing
+ * else. `509 Main Street South-West Falher AB T0H 1M0` is the worked case: 0.29 km from the locality centroid and 43.18
+ * km from its own postal code.
+ *
+ * The pooled CA number hides that entirely — 0.10 km p50 across both populations reads as a uniform win and is not one.
+ * A tier claim that averages two granularities is the thing this table exists to prevent.
+ *
+ * Lives in codex (per-address-system postal reference) so the Node result assembly (`mailwoman/geocode-core`) and the
+ * demo's pin ranking consume ONE tier definition — the 2026-08-11 staged-repoint e2e measured the two disagreeing.
+ */
+export const UNIT_GRADE_POSTCODE = [
+    // NL PC6 — `1012 LG` / `1012LG`.
+    /^\d{4}\s?[A-Z]{2}$/i,
+    // GB unit — outward (1-2 letters + digit + optional alnum) + inward `\d[A-Z]{2}`, the same shape
+    // `@mailwoman/codex/gb`'s UK_POSTCODE_PATTERN anchors, restated here so this module stays
+    // dependency-free within the package (the slices import THIS, never the reverse).
+    /^[A-Z]{1,2}\d[A-Z\d]?\s?\d[A-Z]{2}$/i,
+    // CA urban LDU — `M1J 1A8`. The `[1-9]` in the second position is the whole tier claim: a `0` there marks a RURAL
+    // forward sortation area, which measures 2.08 km p50 against the locality's 929 m and does not belong here.
+    /^[A-Z][1-9][A-Z]\s?\d[A-Z]\d$/i,
+];
+/**
+ * Strip everything but letters and digits, upper-cased — the comparison surface for "did the resolver hit the FULL code
+ * or a coarser stem?". `N7 0BT` and `N70BT` are the same code; `N7` is not.
+ */
+const alnum = (s) => s.replaceAll(/[^\p{L}\p{N}]/gu, "").toUpperCase();
+/**
+ * True when a resolved postcode is an EXACT hit on a unit-grade code — the #977 three-way guard, shared by the Node
+ * ladder and the demo pin ranking:
+ *
+ * 1. The PARSED span is a full unit shape ({@link UNIT_GRADE_POSTCODE}), not a stem the user typed;
+ * 2. The node resolved (a coordinate is present — checked by the caller); and
+ * 3. The resolver's own hit is the FULL code, not a coarsened prefix (a 4-digit NL stem or a GB outward district is
+ *    AREA-class, and promoting it is the exact trade the epoch convention forbids).
+ */
+export function isUnitGradePostcodeHit(parsed, resolverName) {
+    const value = parsed.trim();
+    if (!value || !UNIT_GRADE_POSTCODE.some((re) => re.test(value)))
+        return false;
+    return alnum(resolverName ?? "") === alnum(value);
+}
+/**
+ * Address systems whose AREA-grade postal code is still FINER than the locality containing it — the third granularity
+ * tier, between {@link UNIT_GRADE_POSTCODE} and the locality-first default.
+ *
+ * Whether a postal zone is coarser than its locality is a fact about a country's ADMINISTRATIVE geography, not about
+ * its postal system, and code length does not predict it: FR and DE are both 5-digit and land on opposite sides. France
+ * has ~35,000 communes and one code postal often spans several, so the commune is finer. A German Gemeinde can be
+ * enormous — Berlin is one WOF locality — so the PLZ is finer by a wide margin.
+ *
+ * Membership is earned by a full-panel measurement, the same bar {@link UNIT_GRADE_POSTCODE} sets for CA. Coordinate
+ * p50 on the OpenAddresses panels, locality-first (the default) against the postcode point:
+ *
+ * | country | rows  | locality-first | postcode point | verdict                                                                |
+ * | ------- | ----: | -------------: | -------------: | ---------------------------------------------------------------------- |
+ * | **DE**  | 2,997 | 5.84 km        | **1.24 km**    | postcode, on EVERY percentile incl. p99 (21.50 → 10.57)                |
+ * | FR      | 3,000 | **0.97 km**    | 2.64 km        | locality, closer on 77.5% of rows                                      |
+ * | IT      | 2,833 | **1.34 km**    | 3.05 km        | locality, closer on 66.4%                                              |
+ * | ES      | 2,929 | **0.68 km**    | 0.97 km        | locality, but near a coin flip — 46.1% of rows prefer the postcode     |
+ * | US      | 577   | **2.28 km**    | 4.15 km        | locality (see below)                                                   |
+ * | **JP**  | 586   | 4.93 km        | **0.48 km**    | postcode, closer on 97.3% of rows (p90 13.55 → 1.21, p99 19.63 → 3.54) |
+ *
+ * **The US row is measured on the population production actually sends to the ladder.** Its rooftop cascade is US-only
+ * by construction (`selectAddressPointsDB` composes `address-points-us-<slug>.db`), and it serves 94.2% of US queries,
+ * so only 577 of 10,000 panel rows reach an admin decision at all. Those are the rows no rooftop or interpolation
+ * extract could place, which skews rural — exactly where a locality centroid sits close and a ZIP zone is wide.
+ * Measured over all 10,000 rows instead, the US looks like a postcode-first country (2.41 km vs 3.63); that is a
+ * selection effect, and it is why this table reports 577 rows for the US and full panels for the others, which have no
+ * such cascade.
+ *
+ * **The JP row is the JP board through the served path** (`jp-served-resolve.run.ts`, 2,000 rows, seed 42): the 586
+ * rows carrying a postcode the candidate table keys, graded on the row's own entrance point — the locality-first answer
+ * is the municipality centroid, the postcode answer the code's 町域 centroid from the WOF extract.
+ */
+export const AREA_POSTCODE_FINER_THAN_LOCALITY = new Set(["DE", "JP"]);
+/**
+ * True when this country's area-grade postal code outranks its locality. Absent or unknown country → false, so the
+ * locality-first convention is what an unscoped query gets.
+ */
+export function areaPostcodeLeadsLocality(country) {
+    return country !== undefined && AREA_POSTCODE_FINER_THAN_LOCALITY.has(country.trim().toUpperCase());
+}
 //# sourceMappingURL=postcode-systems.js.map

package/out/postcode-systems.js.map

@@ -1 +1 @@
-{"version":3,"file":"postcode-systems.js","sourceRoot":"","sources":["../postcode-systems.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAOzC;;;;GAIG;AACH,MAAM,cAAc,GAAiE;IACpF,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACvC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC9C,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAChD,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC9C,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAChD,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC9C,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CAC9C,CAAA;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,QAAgB;IAC3D,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO,EAAE,CAAA;IAC/D,MAAM,GAAG,GAAiB,EAAE,CAAA;IAE5B,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,cAAc,EAAE,CAAC;QAChD,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACjB,CAAC;IACF,CAAC;IAED,OAAO,GAAG,CAAA;AACX,CAAC"}
+{"version":3,"file":"postcode-systems.js","sourceRoot":"","sources":["../lib/postcode-systems.ts"],"names":[],"mappings":"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"}

package/out/tools/build-country-surface-lexicon.d.ts

@@ -34,7 +34,7 @@
  *
  *   Source of truth: `@mailwoman/codex` (COUNTRY_SURFACE_FORMS + ISO2_TO_NAME) — the SAME data the
  *   corpus-python bridge `country-surfaces.json` is generated from (export-country-surfaces.ts), so
- *   the channel and the corpus shard synthesizer cannot diverge on what a country surface IS.
+ *   the channel and the corpus extract synthesizer cannot diverge on what a country surface IS.
  *
  *   Output: data/gazetteer/country-surface-lexicon-v1.json (small, committed, provenance-tracked).
  *   Regenerate: `node codex/tools/build-country-surface-lexicon.ts`

package/out/tools/build-country-surface-lexicon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-country-surface-lexicon.d.ts","sourceRoot":"","sources":["../../tools/build-country-surface-lexicon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG"}
+{"version":3,"file":"build-country-surface-lexicon.d.ts","sourceRoot":"","sources":["../../lib/tools/build-country-surface-lexicon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG"}

package/out/tools/build-country-surface-lexicon.js

@@ -34,16 +34,17 @@
  *
  *   Source of truth: `@mailwoman/codex` (COUNTRY_SURFACE_FORMS + ISO2_TO_NAME) — the SAME data the
  *   corpus-python bridge `country-surfaces.json` is generated from (export-country-surfaces.ts), so
- *   the channel and the corpus shard synthesizer cannot diverge on what a country surface IS.
+ *   the channel and the corpus extract synthesizer cannot diverge on what a country surface IS.
  *
  *   Output: data/gazetteer/country-surface-lexicon-v1.json (small, committed, provenance-tracked).
  *   Regenerate: `node codex/tools/build-country-surface-lexicon.ts`
  */
-import { mkdirSync, writeFileSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-import { COUNTRY_SURFACE_FORMS, ISO2_TO_NAME } from "../country/country.js";
-import { wordNorm, wordNormLower } from "../normalize.js";
-import { US_STATE_ABBREVIATIONS, US_STATE_NAMES } from "../us/state.js";
+import { makeDirectories, writeLocalTextFile } from "@mailwoman/core/fs/writers";
+import { repoRootPath } from "@mailwoman/core/paths";
+import { dirname } from "path-ts";
+import { COUNTRY_SURFACE_FORMS, ISO2_TO_NAME } from "#country/country";
+import { wordNorm, wordNormLower } from "#normalize";
+import { US_STATE_ABBREVIATIONS, US_STATE_NAMES } from "#us/state";
 /**
  * Ambiguous entries printed before the list is truncated.
  */
@@ -58,7 +59,7 @@ const SLOTS = ["country_surface", "country_ambiguous"];
  * Committed output path (a codex-derived artifact, like export-country-surfaces.ts — no argv, so the no-process-globals
  * lint policy holds; codex stays zero-runtime-dep).
  */
-const OUTPUT = resolve(import.meta.dirname, "../../data/gazetteer/country-surface-lexicon-v1.json");
+const OUTPUT = repoRootPath("data", "gazetteer", "country-surface-lexicon-v1.json");
 /**
  * THE shared word-normalization rule (identical to build-gazetteer-anchor-lexicon.mjs and mirrored in
  * gazetteer_char_paint on both sides): per whitespace-word, strip LEADING/TRAILING characters that are not Unicode
@@ -141,8 +142,8 @@ const lexicon = {
     entries: Object.fromEntries([...entries].toSorted(([a], [b]) => a.localeCompare(b))),
     code_entries: Object.fromEntries([...codeEntries].toSorted(([a], [b]) => a.localeCompare(b))),
 };
-mkdirSync(dirname(OUTPUT), { recursive: true });
-writeFileSync(OUTPUT, JSON.stringify(lexicon, null, 1) + "\n");
+await makeDirectories(dirname(OUTPUT));
+await writeLocalTextFile(JSON.stringify(lexicon, null, 1) + "\n", OUTPUT);
 process.stderr.write(`wrote ${OUTPUT}: ${entries.size} entries + ${codeEntries.size} code_entries, ` +
     `max_ngram=${maxNgram}, ${ambiguousEntries.length} ambiguous: ${ambiguousEntries.slice(0, MAX_LISTED_AMBIGUOUS).join(", ")}${ambiguousEntries.length > MAX_LISTED_AMBIGUOUS ? ", …" : ""}\n`);
 //# sourceMappingURL=build-country-surface-lexicon.js.map

package/out/tools/build-country-surface-lexicon.js.map

@@ -1 +1 @@
-{"version":3,"file":"build-country-surface-lexicon.js","sourceRoot":"","sources":["../../tools/build-country-surface-lexicon.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"build-country-surface-lexicon.js","sourceRoot":"","sources":["../../lib/tools/build-country-surface-lexicon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEjC,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACtE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAElE;;GAEG;AACH,MAAM,oBAAoB,GAAG,EAAE,CAAA;AAE/B;;GAEG;AACH,MAAM,wBAAwB,GAAG,CAAC,CAAA;AAElC,MAAM,GAAG,GAAG,EAAE,eAAe,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAA;AACxD,MAAM,KAAK,GAAG,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAAA;AAEtD;;;GAGG;AACH,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,iCAAiC,CAAC,CAAA;AAEnF;;;;;GAKG;AACH;;GAEG;AACH,MAAM,WAAW,GAAG,CAAC,CAAS,EAAW,EAAE;IAC1C,MAAM,OAAO,GAAG,CAAC,CAAC,UAAU,CAAC,YAAY,EAAE,EAAE,CAAC,CAAA;IAE9C,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,IAAI,wBAAwB,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACpG,CAAC,CAAA;AAED,qGAAqG;AACrG,mGAAmG;AACnG,qDAAqD;AACrD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;AACxE,MAAM,cAAc,GAAG,IAAI,GAAG,CAAS,sBAA2C,CAAC,CAAA;AAEnF;;;;GAIG;AACH,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAA;AAExH,MAAM,eAAe,GAAG,CAAC,QAAgB,EAAW,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,qBAAqB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;AAExH,wFAAwF;AACxF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAA,CAAC,gBAAgB;AAC1D,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAA,CAAC,sBAAsB;AACpE,IAAI,QAAQ,GAAG,CAAC,CAAA;AAEhB,SAAS,GAAG,CAAC,OAAe;IAC3B,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;IAExB,IAAI,CAAC,CAAC;QAAE,OAAM;IAEd,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;QAErC,IAAI,CAAC,GAAG;YAAE,OAAM;QAChB,gGAAgG;QAChG,MAAM,IAAI,GAAG,GAAG,CAAC,eAAe,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACxF,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;QAExD,OAAM;IACP,CAAC;IAED,MAAM,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,CAAA;IAE5B,IAAI,CAAC,GAAG;QAAE,OAAM;IAChB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC5B,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IAC3C,4FAA4F;IAC5F,oBAAoB;IACpB,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,CAAA;IAC5D,MAAM,IAAI,GAAG,GAAG,CAAC,eAAe,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC1E,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;AACjD,CAAC;AAED,qGAAqG;AACrG,kGAAkG;AAClG,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,EAAE,CAAC;IAC1D,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACvB,GAAG,CAAC,CAAC,CAAC,CAAA;IACP,CAAC;AACF,CAAC;AAED,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,YAAY,EAAE,CAAC;IACrC,GAAG,CAAC,IAAI,CAAC,CAAA;AACV,CAAC;AAED,MAAM,gBAAgB,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;AAElH,MAAM,OAAO,GAAG;IACf,OAAO,EAAE,CAAC;IACV,YAAY,EACX,8GAA8G;IAC/G,WAAW,EAAE,KAAK,CAAC,MAAM;IACzB,KAAK,EAAE,KAAK;IACZ,IAAI,EAAE,GAAG;IACT,SAAS,EAAE,QAAQ;IACnB,KAAK,EAAE;QACN,SAAS,EACR,wFAAwF;YACxF,+GAA+G;QAChH,OAAO,EACN,uKAAuK;QACxK,YAAY,EACX,mLAAmL;QACpL,IAAI,EAAE,gHAAgH;QACtH,OAAO,EACN,4HAA4H;KAC7H;IACD,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACpF,YAAY,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;CAC7F,CAAA;AAED,MAAM,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;AACtC,MAAM,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAA;AAEzE,OAAO,CAAC,MAAM,CAAC,KAAK,CACnB,SAAS,MAAM,KAAK,OAAO,CAAC,IAAI,cAAc,WAAW,CAAC,IAAI,iBAAiB;IAC9E,aAAa,QAAQ,KAAK,gBAAgB,CAAC,MAAM,eAAe,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,MAAM,GAAG,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAC7L,CAAA"}

package/out/tools/export-country-surfaces.d.ts

@@ -4,7 +4,7 @@
  * @author Teffen Ellis, et al.
  *
  *   codex → corpus-python bridge: emit the authoritative country surface forms as JSON so the Python
- *   shard generators can synthesize address tails ("…, USA" / "…, United States of America") without
+ *   extract generators can synthesize address tails ("…, USA" / "…, United States of America") without
  *   re-deriving the country name/alias data. `@mailwoman/codex` stays the single source of truth
  *   (COUNTRY_SURFACE_FORMS + ISO2_TO_NAME, salvaged from isp-nexus spatial/countries); this writes a
  *   snapshot the language boundary can't import directly.

package/out/tools/export-country-surfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"export-country-surfaces.d.ts","sourceRoot":"","sources":["../../tools/export-country-surfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}
+{"version":3,"file":"export-country-surfaces.d.ts","sourceRoot":"","sources":["../../lib/tools/export-country-surfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/out/tools/export-country-surfaces.js

@@ -4,16 +4,16 @@
  * @author Teffen Ellis, et al.
  *
  *   codex → corpus-python bridge: emit the authoritative country surface forms as JSON so the Python
- *   shard generators can synthesize address tails ("…, USA" / "…, United States of America") without
+ *   extract generators can synthesize address tails ("…, USA" / "…, United States of America") without
  *   re-deriving the country name/alias data. `@mailwoman/codex` stays the single source of truth
  *   (COUNTRY_SURFACE_FORMS + ISO2_TO_NAME, salvaged from isp-nexus spatial/countries); this writes a
  *   snapshot the language boundary can't import directly.
  *
  *   Regenerate: `node codex/tools/export-country-surfaces.ts` (writes the corpus-python data file).
  */
-import { writeFileSync } from "node:fs";
-import { resolve } from "node:path";
-import { COUNTRY_SURFACE_FORMS, ISO2_TO_NAME } from "../country/country.js";
+import { writeLocalTextFile } from "@mailwoman/core/fs/writers";
+import { repoRootPath } from "@mailwoman/core/paths";
+import { COUNTRY_SURFACE_FORMS, ISO2_TO_NAME } from "#country/country";
 // Merge: rich surface forms where the codex curates them, else the canonical English name for every
 // ISO 3166-1 alpha-2. Canonical-name-first (the codex's own ordering) so the common form leads.
 const surfaces = {};
@@ -25,10 +25,10 @@ for (const [iso2, name] of ISO2_TO_NAME) {
         surfaces[iso2] = [name];
     }
 }
-const out = resolve(import.meta.dirname, "../../corpus-python/src/mailwoman_train/data/country-surfaces.json");
-writeFileSync(out, JSON.stringify({
+const out = repoRootPath("corpus-python", "src", "mailwoman_train", "data", "country-surfaces.json");
+await writeLocalTextFile(JSON.stringify({
     _generated: "codex/tools/export-country-surfaces.ts from @mailwoman/codex COUNTRY_SURFACE_FORMS + ISO2_TO_NAME",
     surfaces,
-}, null, 2) + "\n");
+}, null, 2) + "\n", out);
 process.stderr.write(`wrote ${Object.keys(surfaces).length} countries → ${out}\n`);
 //# sourceMappingURL=export-country-surfaces.js.map

package/out/tools/export-country-surfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"export-country-surfaces.js","sourceRoot":"","sources":["../../tools/export-country-surfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAE3E,oGAAoG;AACpG,gGAAgG;AAChG,MAAM,QAAQ,GAA6B,EAAE,CAAA;AAE7C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,EAAE,CAAC;IACnE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAA;AAC5B,CAAC;AAED,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,YAAY,EAAE,CAAC;IACzC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACxB,CAAC;AACF,CAAC;AAED,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,oEAAoE,CAAC,CAAA;AAE9G,aAAa,CACZ,GAAG,EACH,IAAI,CAAC,SAAS,CACb;IACC,UAAU,EAAE,mGAAmG;IAC/G,QAAQ;CACR,EACD,IAAI,EACJ,CAAC,CACD,GAAG,IAAI,CACR,CAAA;AAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,CAAA"}
+{"version":3,"file":"export-country-surfaces.js","sourceRoot":"","sources":["../../lib/tools/export-country-surfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEpD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEtE,oGAAoG;AACpG,gGAAgG;AAChG,MAAM,QAAQ,GAA6B,EAAE,CAAA;AAE7C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,EAAE,CAAC;IACnE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAA;AAC5B,CAAC;AAED,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,YAAY,EAAE,CAAC;IACzC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACxB,CAAC;AACF,CAAC;AAED,MAAM,GAAG,GAAG,YAAY,CAAC,eAAe,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,uBAAuB,CAAC,CAAA;AAEpG,MAAM,kBAAkB,CACvB,IAAI,CAAC,SAAS,CACb;IACC,UAAU,EAAE,mGAAmG;IAC/G,QAAQ;CACR,EACD,IAAI,EACJ,CAAC,CACD,GAAG,IAAI,EACR,GAAG,CACH,CAAA;AAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,CAAA"}

package/out/tools/generate-country-population.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Regenerate `codex/country/population.ts` — the per-country population table — from GeoNames
+ *   `countryInfo.txt` (https://download.geonames.org/export/dump/countryInfo.txt, CC-BY-4.0). The
+ *   output is committed; this tool makes it reproducible (provenance), not a hand-typed dictionary.
+ *
+ *   Why it exists (#1650): WOF carries no readable population for 147 of 237 country records
+ *   (measured against the 2026-08-18 candidate build), so those countries entered every prominence
+ *   race at an asserted ZERO — ranked below any namesake hamlet. The magnitude is what a fame race
+ *   reads, so a census-vintage figure is entirely sufficient; currency of the estimate is not the
+ *   point.
+ *
+ *   Rows whose GeoNames population is 0 are DROPPED rather than emitted: an entry in this table is a
+ *   positive claim, and the consumer's absence branch (`?? undefined`) must stay reachable for
+ *   territories GeoNames itself declines to estimate (the meaning-of-zero rule).
+ *
+ *   Usage: mailwoman dev generate country-population
+ */
+/**
+ * Options for {@linkcode generateCountryPopulation}.
+ */
+export interface GenerateCountryPopulationOptions {
+    /**
+     * Output path override. Default: `codex/country/population.ts` (the committed table).
+     */
+    out?: string;
+}
+/**
+ * Summary returned by {@linkcode generateCountryPopulation}.
+ */
+export interface GenerateCountryPopulationSummary {
+    countries: number;
+    outPath: string;
+}
+/**
+ * Fetch GeoNames `countryInfo.txt` and regenerate the committed `COUNTRY_POPULATION` table.
+ */
+export declare function generateCountryPopulation(options?: GenerateCountryPopulationOptions, report?: (line: string) => void): Promise<GenerateCountryPopulationSummary>;
+//# sourceMappingURL=generate-country-population.d.ts.map

package/out/tools/generate-country-population.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-country-population.d.ts","sourceRoot":"","sources":["../../lib/tools/generate-country-population.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAmCH;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAChD;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAChD,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC9C,OAAO,GAAE,gCAAqC,EAC9C,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC7B,OAAO,CAAC,gCAAgC,CAAC,CA8D3C"}

package/out/tools/generate-country-population.js

@@ -0,0 +1,106 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Regenerate `codex/country/population.ts` — the per-country population table — from GeoNames
+ *   `countryInfo.txt` (https://download.geonames.org/export/dump/countryInfo.txt, CC-BY-4.0). The
+ *   output is committed; this tool makes it reproducible (provenance), not a hand-typed dictionary.
+ *
+ *   Why it exists (#1650): WOF carries no readable population for 147 of 237 country records
+ *   (measured against the 2026-08-18 candidate build), so those countries entered every prominence
+ *   race at an asserted ZERO — ranked below any namesake hamlet. The magnitude is what a fame race
+ *   reads, so a census-vintage figure is entirely sufficient; currency of the estimate is not the
+ *   point.
+ *
+ *   Rows whose GeoNames population is 0 are DROPPED rather than emitted: an entry in this table is a
+ *   positive claim, and the consumer's absence branch (`?? undefined`) must stay reachable for
+ *   territories GeoNames itself declines to estimate (the meaning-of-zero rule).
+ *
+ *   Usage: mailwoman dev generate country-population
+ */
+import { APIClient, pluckResponseData } from "@mailwoman/core/api";
+import { writeLocalTextFile } from "@mailwoman/core/fs/writers";
+import { resolvePackagePath } from "@mailwoman/core/module/resolvers";
+const SOURCE = "https://download.geonames.org/export/dump/countryInfo.txt";
+/**
+ * The committed output path, resolved relative to this module (codex/tools/ → codex/country/). See
+ * `generate-country-reference.ts` for why this is `import.meta.url` rather than a `core` path helper (codex is
+ * zero-runtime-dep and `core` already references `codex` — importing core here would cycle the project graph).
+ */
+const DEFAULT_OUT = resolvePackagePath("@mailwoman/codex", "lib", "country", "population.ts");
+/**
+ * Tab positions this tool reads from `countryInfo.txt`'s 19-column rows. Named so the parse states which columns it
+ * believes in; a GeoNames format change fails the count guard below rather than silently reading the wrong column.
+ */
+const COLUMN_ISO2 = 0;
+const COLUMN_POPULATION = 7;
+const MINIMUM_COLUMNS = 8;
+/**
+ * GeoNames publishes ~250 countries/territories; a parse recovering fewer than this read the wrong column or a
+ * truncated body, and the guard fails loudly instead of committing a hollow table.
+ */
+const MINIMUM_PLAUSIBLE_COUNTRIES = 200;
+/**
+ * Numbers below five digits are emitted bare — the house numeric-separator style groups by three and only from five
+ * digits up (`8450`, not `8_450`).
+ */
+const SEPARATOR_MINIMUM = 10_000;
+/**
+ * Fetch GeoNames `countryInfo.txt` and regenerate the committed `COUNTRY_POPULATION` table.
+ */
+export async function generateCountryPopulation(options = {}, report) {
+    const outPath = options.out ?? DEFAULT_OUT;
+    // `responseType: "text"` because the source is a tab-separated dump, not JSON.
+    const text = await new APIClient({ displayName: "geonames-country-info", retry: true })
+        .fetch({ url: SOURCE, responseType: "text" })
+        .then(pluckResponseData);
+    const rows = {};
+    // oxlint-disable-next-line mailwoman/prefer-spliterator -- countryInfo.txt is ~35 kB and bounded (~300 rows)
+    for (const line of text.split("\n")) {
+        if (!line || line.startsWith("#"))
+            continue;
+        // oxlint-disable-next-line mailwoman/prefer-spliterator -- one 19-column row
+        const columns = line.split("\t");
+        if (columns.length < MINIMUM_COLUMNS)
+            continue;
+        const alpha2 = columns[COLUMN_ISO2].trim();
+        const population = Number(columns[COLUMN_POPULATION]);
+        if (!/^[A-Z]{2}$/.test(alpha2))
+            continue;
+        if (!Number.isFinite(population) || population <= 0)
+            continue;
+        rows[alpha2] = population;
+    }
+    if (Object.keys(rows).length < MINIMUM_PLAUSIBLE_COUNTRIES) {
+        throw new Error(`generateCountryPopulation: only ${Object.keys(rows).length} rows parsed — format drift?`);
+    }
+    const body = Object.keys(rows)
+        .toSorted()
+        .map((k) => {
+        const n = rows[k];
+        const literal = n >= SEPARATOR_MINIMUM ? n.toLocaleString("en-US").replaceAll(",", "_") : String(n);
+        return `\t${k}: ${literal},`;
+    })
+        .join("\n");
+    const header = `/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   GENERATED — do not edit by hand. Per-country population, derived from GeoNames countryInfo.txt
+ *   (https://download.geonames.org/export/dump/countryInfo.txt, CC-BY-4.0). Estimates are
+ *   census-vintage; a prominence race reads the magnitude, not the currency. Countries GeoNames
+ *   declines to estimate are ABSENT, never zero.
+ *   Regenerate with: mailwoman dev generate country-population
+ */
+
+/**
+ * ISO 3166-1 alpha-2 → population estimate.
+ */
+export const COUNTRY_POPULATION: Readonly<Record<string, number>> = {`;
+    await writeLocalTextFile(`${header}\n${body}\n}\n`, outPath);
+    report?.(`wrote ${outPath} (${Object.keys(rows).length} countries)`);
+    return { countries: Object.keys(rows).length, outPath };
+}
+//# sourceMappingURL=generate-country-population.js.map

package/out/tools/generate-country-population.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-country-population.js","sourceRoot":"","sources":["../../lib/tools/generate-country-population.ts"],"names":[],"mappings":"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"}