@mailwoman/resolver-wof-sqlite 9.4.0 → 10.1.0

package/out/geonames/aliases.js

@@ -2,62 +2,20 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   #743/#193 — fold GeoNames bilingual / alt-language place-names into a WOF/unified admin DB as
- *   first-class places. The hard-filter recall gap on bilingual countries (the address says
- *   "Karjaa" but the table holds the Swedish "Karis") is missing alt-LANGUAGE names, not missing
- *   places: the WOF/Overture `names` carried only the primary, so the candidate build's Latin-alias
- *   explode (build-candidate pass 2) had nothing to widen. GeoNames' per-country dump carries the
- *   variants inline (the Karis row's `alternatenames` includes "Karjaa").
- *
- *   For each POPULATED place (feature class `P`) this writes an `spr` row + `names` rows (primary +
- *   Latin alt-names) + population into the SAME tables the WOF/Overture paths use — synthetic ids
- *   based at {@link GEONAMES_ID_BASE} so the three sources never collide. The caller then rebuilds
- *   `place_search` ({@link buildPlaceSearchFTS} with `drop: true`) so the candidate build carries
- *   Karjaa↔Karis. Proven (FI hard-resolve 69.5 → 85.8 %, coverage 74.4 → 94.0 %); duplicating a
- *   place already held under another source is benign — the rows share name_key+coord and the
- *   candidate ranking dedupes by score.
- *
- *   This is the package home so the canonical `build-unified-wof --geonames-countries`, the
- *   pipeline fold (`gazetteer-pipeline/admin/fold-geonames`), AND the `mailwoman gazetteer` commands all share
- *   ONE implementation. GeoNames dump = `download.geonames.org/export/dump/<CC>.zip` → `<CC>.txt`
- *   (TSV).
  */
 import { isOfficialLanguage } from "@mailwoman/codex/country";
+import { readUnquotedTSV } from "@mailwoman/core/fs/delimited";
 import { pathExists } from "@mailwoman/core/fs/readers";
-import { join } from "path-ts";
-import { TSVSpliterator } from "spliterator";
-import { GEONAMES_POSTAL_ID_BASE } from "#geonames/postal";
-/**
- * Synthetic id base for GeoNames-sourced rows (#743/#193) — above Overture's 8e12 so the three sources (WOF real ids,
- * Overture, GeoNames) never collide in a combined DB.
- */
-export const GEONAMES_ID_BASE = 9_000_000_000_000;
-/**
- * The four tables the alias fold writes into the range it owns. The purge and the ingest must agree on this list — a
- * table written but not purged is exactly the #1514 defect.
- */
+import { GEONAMES_ID_BASE, GEONAMES_POSTAL_ID_BASE } from "@mailwoman/core/resolver/synthetic-id-ranges";
+import { resolvePathBuilder } from "path-ts";
 const FOLD_OWNED_TABLES = ["spr", "names", "place_population", "ancestors"];
 /**
- * Clear everything the alias fold owns — `[GEONAMES_ID_BASE, GEONAMES_POSTAL_ID_BASE)` across {@link
- * FOLD_OWNED_TABLES}
- * — so a fold's output is a function of its country list and dumps ALONE, never of what the DB happened to hold first.
- * Returns the rows removed per table.
- *
- * This exists because the synthetic id is a POSITION (`GEONAMES_ID_BASE + n`, counted across the country list in
- * order), not a derivation from the geonameid: change the list, its order, or a dump's contents and every subsequent id
- * shifts. Without the purge, a second fold overwrote the `spr` PREFIX it reached (`INSERT OR REPLACE`) while its
- * `names`/`ancestors` rows merely appended (bare `INSERT`) and `place_population` skipped unpopulated places entirely —
- * so the previous run's names, ancestry and populations stayed bound to ids now describing other places.
+ * Deletes every row the GeoNames alias fold owns, with ids in
+ * `[GEONAMES_ID_BASE, GEONAMES_POSTAL_ID_BASE)`, and returns the count removed per table.
  *
- * Measured on the live 2026-08-05 artifact: a 14-country re-fold over the 161-country fold baked into
- * `admin-global-priority.db` put 522,184 of 2,110,096 name rows in the range (24.7 %) on a place from a different
- * country. Gaborone/BW at id 9000000121151 became Aichegg/AT and kept all 26 of its names; Kinshasa's 16,000,000
- * population landed on a Lithuanian hamlet.
- *
- * The upper bound is NOT the end of the id space. Each later extract owns a range above this one — GeoNames-postal @
- * 9.5e12, NL-PC6 @ 9.6e12, Code-Point @ 9.7e12, NI @ 9.8e12 — and a purge that ran past {@link GEONAMES_POSTAL_ID_BASE}
- * would delete them.
+ * Fold ids are assigned sequentially, so a re-fold without this purge would attach
+ * stale names, ancestors and populations to other places.
+ * The upper bound leaves the postal and postcode id ranges above it untouched.
  */
 export function purgeGeonamesAliasRange(db) {
     const removed = {};
@@ -70,26 +28,18 @@ export function purgeGeonamesAliasRange(db) {
     return removed;
 }
 /**
- * Parse a country's alternateNamesV2 file into `geonameid -> spelling -> attribution`, restricted to the populated
- * places (`P`) in `wanted`.
+ * Formats a GeoNames fold progress event as one log line.
  */
+export function formatGeonamesIngestProgress(event, missingFile) {
+    if (event.skipped) {
+        return `${event.country}: ${missingFile ? `${missingFile} missing` : "dump missing"} — download from download.geonames.org/export/dump/${event.country}.zip; skipped`;
+    }
+    return `${event.country}: ${event.places.toLocaleString()} places, ${(event.aliasesRefused ?? 0).toLocaleString()} alt-names refused`;
+}
 async function parseAlternateNamesV2(v2File, cc, wanted) {
     const v2 = new Map();
-    // V2 columns (0-indexed): 1 geonameid, 2 isolanguage, 3 name, 4 isPreferredName, 5 isShortName,
-    // 6 isColloquial, 7 isHistoric, 8 from, 9 to.
-    //
-    // Two passes, because historic-ness is a fact about the NAME, not the row: GeoNames splits one
-    // spelling across rows — Malabo carries "Santa Isabel" as (es, unflagged) AND as (no-language,
-    // isHistoric=1, to=1973). Officialness must see the flags from EVERY row for the spelling, or the
-    // colonial-era name sails through on the language-tagged row (the #936 review's Malabo finding).
-    // Do NOT condition on isPreferredName instead — it's sparse annotation, not a signal (Turku's sv "Åbo"
-    // is unflagged; FI has 1,746 flags across the whole dump).
-    //
-    // Both passes STREAM the file rather than sharing one materialized array: NO's V2 dump is 33 MB,
-    // and a second read off the page cache costs less than holding half a million line strings.
-    // `header: false` — the dump is headerless.
     const historicNames = new Set();
-    for await (const f of TSVSpliterator.fromAsync(v2File, { header: false })) {
+    for await (const f of readUnquotedTSV(v2File)) {
         if (f[6] === "1" || f[7] === "1" || (f[9] ?? "").trim() !== "") {
             const alt = (f[3] ?? "").trim();
             if (alt && wanted.has(Number(f[1]))) {
@@ -97,12 +47,11 @@ async function parseAlternateNamesV2(v2File, cc, wanted) {
             }
         }
     }
-    for await (const f of TSVSpliterator.fromAsync(v2File, { header: false })) {
+    for await (const f of readUnquotedTSV(v2File)) {
         const gid = Number(f[1]);
         if (!wanted.has(gid))
             continue;
         const lang = f[2] ?? "";
-        // ISO 639 codes are 2-3 letters; GeoNames' pseudo-codes (post, link, iata, wkdt, …) are 4+.
         if (!/^[a-z]{2,3}$/.test(lang))
             continue;
         const alt = (f[3] ?? "").trim();
@@ -131,70 +80,59 @@ async function parseAlternateNamesV2(v2File, cc, wanted) {
     return v2;
 }
 /**
- * Fold the GeoNames `P`-class places (+ their Latin alt-names) for `countries` into `db`'s `spr` / `names` /
- * `place_population` tables. Returns the total places ingested.
+ * Purges the fold's id range, then adds GeoNames `P`-class places and their
+ * alternate names for `countries` to `db`.
+ * It returns the number of places ingested.
  *
- * `onProgress` receives one event per country (default: a stderr line, matching the build scripts' legacy output). The
- * caller MUST rebuild `place_search` afterward (`buildPlaceSearchFTS(db, { drop: true })`) for the new names to reach
- * the candidate build's alias pass.
+ * The caller must then rebuild `place_search` with `buildPlaceSearchFTS(db, { drop: true })`
+ * to make the new names searchable.
  */
 export async function ingestGeonamesAliases(db, countries, geonamesDir, onProgress, opts) {
-    // Latin-only, no bracket/paren noise GeoNames packs into `alternatenames` ("(( Karis Landskommun ))",
-    // airport codes), 2–60 chars, at least one letter (drops bare postcodes/numbers).
     const LATIN_NAME = /^[\p{Script=Latin}\p{M}\s\-'.]{2,60}$/u;
     const clean = (s) => {
         const t = s.trim();
         return t && LATIN_NAME.test(t) && /\p{L}/u.test(t) ? t : null;
     };
+    const NAME_NOISE = /[()[\]{}<>|/\\_@#$%^*+=~`"]/u;
+    const NAME_MIN_LENGTH = 2;
+    const NAME_MAX_LENGTH = 60;
+    const cleanAlias = (s) => {
+        const t = s.trim();
+        return t.length >= NAME_MIN_LENGTH && t.length <= NAME_MAX_LENGTH && /\p{L}/u.test(t) && !NAME_NOISE.test(t)
+            ? t
+            : null;
+    };
     const sprInsert = db.prepare(`INSERT OR REPLACE INTO spr (id, parent_id, name, placetype, country, latitude, longitude, min_latitude, min_longitude, max_latitude, max_longitude, is_current, is_deprecated, is_ceased, is_superseded, is_superseding, lastmodified) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
     const namesInsert = db.prepare(`INSERT INTO names (id, name, placetype, country, language, privateuse, official, lastmodified) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`);
     const populationInsert = db.prepare(`INSERT OR REPLACE INTO place_population (id, population) VALUES (?, ?)`);
-    // #267 admin linkage: ancestor rows (locality→region→country) so parentID scoping + adminCoherence reach
-    // the gap countries. Only used for a country in opts.adminForCountries.
     const ancestorInsert = db.prepare(`INSERT INTO ancestors (id, ancestor_id, ancestor_placetype, lastmodified) VALUES (?, ?, ?, 0)`);
     const report = (event, missingFile) => {
         if (onProgress) {
             onProgress(event);
         }
-        else if (event.skipped) {
-            console.error(`  GeoNames ${event.country}: ${missingFile} missing — download from download.geonames.org/export/dump/${event.country}.zip; skipped`);
-        }
         else {
-            console.error(`  GeoNames ${event.country}: ${event.places.toLocaleString()} populated places (+ Latin alt-names)`);
+            console.error(`  GeoNames ${formatGeonamesIngestProgress(event, missingFile)}`);
         }
     };
     let id = GEONAMES_ID_BASE;
     let total = 0;
     db.exec("BEGIN");
-    // #1514: clear the range before writing it. Inside the transaction, so a fold that throws leaves the
-    // DB as it found it rather than half-purged. See purgeGeonamesAliasRange for why the ids demand this.
     purgeGeonamesAliasRange(db);
     for (const cc of countries) {
-        const file = join(geonamesDir, `${cc}.txt`);
+        const file = resolvePathBuilder(geonamesDir, `${cc}.txt`);
         if (!(await pathExists(file))) {
             report({ country: cc, places: 0, skipped: true }, file);
             continue;
         }
         let nc = 0;
-        // #267: add A-class admin + ancestry only for the gap countries this country is in (never the EU set).
+        let refused = 0;
         const addAdmin = opts?.adminForCountries?.has(cc) ?? false;
-        const v2File = opts?.alternateDir ? join(opts.alternateDir, `${cc}.txt`) : undefined;
+        const v2File = opts?.alternateDir ? resolvePathBuilder(opts.alternateDir, `${cc}.txt`) : undefined;
         const readV2 = Boolean(v2File && (await pathExists(v2File)));
-        // Survey pass. The dump is STREAMED — NO's is 71 MB and only the caller knows which country
-        // comes next — so what a later pass needs has to be collected here rather than re-scanned off a
-        // materialized array. Two things qualify, and both are small: the P-class geonameid set the V2
-        // decoration is restricted to, and the handful of A-class rows the admin pre-pass writes (one
-        // PCL* + the ADM1s). Everything else is re-read in the emit pass below. Neither is wanted
-        // without V2 tags or admin, and then the pass is skipped rather than read for nothing.
-        //
-        // GeoNames dump columns (0-indexed): 0 geonameid, 1 name, 2 asciiname, 3 alternatenames, 4 lat, 5 lon,
-        // 6 feature_class, 7 feature_code, 10 admin1 code, 14 pop.
-        //
-        // `header: false` — the dump is headerless, so row 1 is a place, not column names.
         const wanted = new Set();
         const adminRows = [];
         if (readV2 || addAdmin) {
-            for await (const f of TSVSpliterator.fromAsync(file, { header: false })) {
+            for await (const f of readUnquotedTSV(file)) {
                 if (f[6] === "P") {
                     if (readV2) {
                         wanted.add(Number(f[0]));
@@ -206,12 +144,7 @@ export async function ingestGeonamesAliases(db, countries, geonamesDir, onProgre
                 }
             }
         }
-        // #936: V2 tags for this country's P-class rows — geonameid → exact alias spelling → tag. The V2
-        // dump repeats one spelling under several languages ("Åbo" sv/da/no); the merged tag is official /
-        // preferred if ANY qualifying row is.
         const v2 = readV2 ? await parseAlternateNamesV2(v2File, cc, wanted) : undefined;
-        // #267 admin pre-pass (gap countries): fold the country (PCLI) + regions (ADM1), self+ancestry them, and
-        // build the admin1→region map the localities link through. Point bbox (GeoNames gives a centroid only).
         let countryID = -1;
         const adminMap = new Map();
         if (addAdmin) {
@@ -222,11 +155,8 @@ export async function ingestGeonamesAliases(db, countries, geonamesDir, onProgre
                 const lat = Number(f[4]) || 0;
                 const lon = Number(f[5]) || 0;
                 if (f[7]?.startsWith("PCL")) {
-                    // Any country-level political entity — PCLI (independent), PCLD (dependent territory),
-                    // PCLF (freely associated), PCLS (special administrative region: HK/MO/PS). All are the
-                    // country tier; restricting to PCLI left those ~17 territories without a country row.
                     if (countryID >= 0)
-                        continue; // one country row
+                        continue;
                     countryID = id++;
                     sprInsert.run(countryID, -1, aname, "country", cc, lat, lon, lat, lon, lat, lon, 1, 0, 0, 0, 0, 0);
                     namesInsert.run(countryID, aname, "country", cc, "", "", 0, 0);
@@ -240,7 +170,6 @@ export async function ingestGeonamesAliases(db, countries, geonamesDir, onProgre
                     adminMap.set(f[10], rid);
                 }
             }
-            // Re-parent regions + ancestor them to the (now-known) country.
             if (countryID >= 0) {
                 for (const rid of adminMap.values()) {
                     db.prepare("UPDATE spr SET parent_id = ? WHERE id = ?").run(countryID, rid);
@@ -248,10 +177,9 @@ export async function ingestGeonamesAliases(db, countries, geonamesDir, onProgre
                 }
             }
         }
-        // Emit pass — a second stream over the same file, off the page cache the survey pass just warmed.
-        for await (const f of TSVSpliterator.fromAsync(file, { header: false })) {
+        for await (const f of readUnquotedTSV(file)) {
             if (f[6] !== "P")
-                continue; // populated places only
+                continue;
             const lat = Number(f[4]);
             const lon = Number(f[5]);
             if (!Number.isFinite(lat) || !Number.isFinite(lon))
@@ -260,18 +188,10 @@ export async function ingestGeonamesAliases(db, countries, geonamesDir, onProgre
             if (!name)
                 continue;
             const nid = id++;
-            // #267: link to the locality's region (else country) for gap countries; -1 (orphan) otherwise.
             const regionID = addAdmin ? (adminMap.get(f[10] ?? "") ?? -1) : -1;
             const parentID = regionID >= 0 ? regionID : addAdmin && countryID >= 0 ? countryID : -1;
-            // Point bbox — a GeoNames row is a centroid; the candidate's region-bbox disambiguation just
-            // sees it as contained in itself, fine for a locality.
             sprInsert.run(nid, parentID, name, "locality", cc, lat, lon, lat, lon, lat, lon, 1, 0, 0, 0, 0, 0);
             namesInsert.run(nid, name, "locality", cc, "", "", 0, 0);
-            // The SELF row is unconditional (#1514). `populateAncestors` writes one for every spr row it
-            // sees, so a full build's freeze phase produces it either way — but the freeze does not run on
-            // the fold-on-copy path, and since the purge now clears this range the fold has to emit
-            // everything the closure would. Measured on the 161-country fold: 212,993 self rows, exactly the
-            // non-gap countries' localities, which is what the base artifact carried and a fold-on-copy lost.
             ancestorInsert.run(nid, nid, "locality");
             if (addAdmin) {
                 if (regionID >= 0) {
@@ -284,7 +204,10 @@ export async function ingestGeonamesAliases(db, countries, geonamesDir, onProgre
             const seen = new Set([name]);
             const tags = v2?.get(Number(f[0]));
             for (const raw of [f[2] ?? "", ...(f[3] ? f[3].split(",") : [])]) {
-                const alt = clean(raw);
+                const alt = cleanAlias(raw);
+                if (!alt && raw.trim()) {
+                    refused++;
+                }
                 if (alt && !seen.has(alt)) {
                     seen.add(alt);
                     const tag = tags?.get(alt);
@@ -297,7 +220,7 @@ export async function ingestGeonamesAliases(db, countries, geonamesDir, onProgre
             }
             nc++;
         }
-        report({ country: cc, places: nc, skipped: false });
+        report({ country: cc, places: nc, skipped: false, aliasesRefused: refused });
         total += nc;
     }
     db.exec("COMMIT");

package/out/geonames/aliases.js.map

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

package/out/geonames/postal.d.ts

@@ -3,49 +3,33 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   #920 — fold GeoNames POSTAL codes into a WOF/unified postcode extract as first-class
- *   `postalcode` places, for the countries whose WOF postalcode repos don't exist (the
- *   namesake-tail locales: FI/CZ/SK/SI/DK/NO/HR/PL and any future gap).
+ *   Fold GeoNames postcode rows into a WOF or unified postcode extract as first-class `postalcode`
+ *   places for countries whose WOF postalcode repos do not exist.
  *
- *   Why: the night-31 taxonomy measured the cross-locale resolve tail as NAMESAKE COLLISION
- *   (FI 300/1k … PL 75/1k offender rows), and the controlled experiment showed postcode-extract
- *   coverage alone collapses it (FI 300→1, CZ 131→4): a resolvable postcode node feeds the
- *   resolver's coordinate-first sibling-postcode candidate injection, which binds the locality
- *   pick to its postcode neighborhood. The implementation already ships; it was coverage-starved.
+ *   Two laws are enforced here in code rather than in a runbook.
  *
- *   Two hard-won laws from the experiment are enforced HERE, in code, not in a runbook:
+ *   1. The name law. A postcode row's `name` is stored in the sanitized-query token shape with
+ *      every non-letter and non-number stripped. `sanitizeFTSQuery` reduces the parsed token to
+ *      that shape at lookup time. A stored `"110 00"` or `"11-041"` can never match the
+ *      query `"11000"` or `"11041"`. The display form is preserved as an alt row in `names`.
+ *   2. The medoid law. A postcode whose rows contain scattered points has no single true center.
+ *      Their average puts the code somewhere no address is. The medoid is the member point
+ *      nearest the group's mean.
  *
- *   1. **The name law (#920 format law):** a postcode row's `name` is stored in the
- *      SANITIZED-QUERY token shape — every non-letter/number stripped — because that is what
- *      `sanitizeFTSQuery` reduces the parsed token to at lookup time. Stored `"110 00"` (CZ) or
- *      `"11-041"` (PL) can never match the query `"11000"`/`"11041"`; the spaced CZ build
- *      measured WORSE than no coverage (+13 namesake rows) because its bigrams partial-matched
- *      WRONG codes. The display form is preserved as an alt row in `names`.
- *   2. **Medoid centroids:** GeoNames postal is one row per (postcode, settlement); the naive
- *      mean-of-members centroid displaced tighter village coordinates on already-correct rows
- *      (the p50-tax that ni-failed SK/SI/HR at 1.10–1.94 km CI). The MEDOID — the member point
- *      nearest the mean — keeps the coordinate on a real settlement.
- *
- *   Package home for the same reason as `geonames-aliases.ts`: `build-unified-wof
- *   --geonames-postal-countries`, any standalone fold, and the `mailwoman gazetteer` commands
- *   share ONE implementation. GeoNames postal dump = `download.geonames.org/export/zip/<CC>.zip`
- *   → `<CC>.txt` (TSV: country, postcode, place, admin1, code1, admin2, code2, admin3, code3,
- *   lat, lon, accuracy). License CC BY 4.0 — attribution rides the extract's `meta` provenance and
- *   the model card like the existing GeoNames alias fold.
+ *   `build-unified-wof --geonames-postal-countries`, standalone folds and the `mailwoman
+ *   gazetteer` commands share one implementation. The GeoNames postal dump is
+ *   `download.geonames.org/export/zip/<CC>.zip` → `<CC>.txt`, a headerless TSV of country,
+ *   postcode, place, admin1, code1, admin2, code2, admin3, code3, lat, lon and accuracy.
+ *   The license is CC BY 4.0. Attribution appears in the extract's `meta` provenance and model card.
  */
 import type { DatabaseClient } from "@mailwoman/sqlite/client";
 import { type PathBuilderLike } from "path-ts";
 import type { WOFDatabase } from "#schema";
 /**
- * Synthetic id base for GeoNames-POSTAL rows — its own namespace above the alias fold's {@link GEONAMES_ID_BASE} (9e12)
- * allocation so all four sources (WOF, Overture, GeoNames-alias, GeoNames-postal) coexist collision-free in a combined
- * DB.
- */
-export declare const GEONAMES_POSTAL_ID_BASE = 9500000000000;
-/**
- * The #920 name law: reduce a postcode to the sanitized-query token shape — strip every non-letter/number — so the
- * stored name matches what `sanitizeFTSQuery` produces from the parsed postcode token. `"110 00"` → `"11000"`,
- * `"11-041"` → `"11041"`, `"AD500"` → `"AD500"`.
+ * Reduce a postcode to the sanitized-query token shape, stripping every non-letter and non-number,
+ * so the stored name matches what `sanitizeFTSQuery` produces from the parsed postcode token.
+ *
+ * `"110 00"` → `"11000"`, `"11-041"` → `"11041"`, `"AD500"` → `"AD500"`.
  */
 export declare function normalizePostcodeName(raw: string): string;
 /**
@@ -53,22 +37,62 @@ export declare function normalizePostcodeName(raw: string): string;
  */
 export type PostcodePoint = readonly [number, number];
 /**
- * The #920 MEDOID law: pick the member point nearest the group's mean, never the mean itself.
+ * A medoid and the size of the group it came from.
  *
- * A postcode whose evidence is several scattered points has no single "true" centre, and the tempting answer — average
- * them — puts the code somewhere no address is. The night-31 experiment measured that as a p50 tax severe enough to
- * fail SK/SI/HR at 1.10–1.94 km CI: the mean displaced coordinates that were already correct. The medoid stays on a
- * real observation, so a single-member group is exactly its own point and a multi-member group is one of its members.
+ * These two integers describe the source dump.
+ * `@mailwoman/evidence`'s `EpistemicStatus` vocabulary belongs to the answering path.
  *
- * Distance is squared-Euclidean in DEGREES, not haversine. At the scale a postcode spans, the ranking the two produce
- * is the same, and this one carries no trig into a per-group inner loop. Ties go to the earliest member, which makes
- * the result a pure function of the input order — the property a rebuilt extract's ids depend on.
+ * `epistemicStatusFor` derives it there.
+ * These fields cannot use `observed` or `derived` here because that would give
+ * those words a second, local meaning.
+ */
+export interface MedoidSupport {
+    /**
+     * The medoid over the distinct member points.
+     */
+    point: PostcodePoint;
+    /**
+     * Rows the group held.
+     */
+    rows: number;
+    /**
+     * Distinct coordinates among them.
+     *
+     * One means every row refers to the same point.
+     * In a dump whose coordinates are computed, that is one value inherited N times
+     * rather than N sources agreeing.
+     */
+    distinctPoints: number;
+}
+/**
+ * Pick the member point nearest the group's mean, never the mean itself.
+ *
+ * The medoid stays on a real observation, so a single-member group is exactly its own point
+ * and a multi-member group is one of its members.
+ * The bound applies only while the members are distinct, so duplicate points are collapsed first.
+ *
+ * Separate counts for N rows at one coordinate would weight that value by how many settlements
+ * inherited it. {@link MedoidSupport.distinctPoints} reports how many points the answer rested on.
+ *
+ * Distance is squared-Euclidean in degrees rather than haversine.
+ * At the scale a postcode spans, both methods produce the same ranking.
+ *
+ * Squared-Euclidean distance keeps trigonometry out of a per-group inner loop.
+ *
+ * Ties go to the earliest member, so the result is a pure function of input order.
+ * Rebuilt extract IDs depend on that property.
  *
- * Exported (rather than inlined at each ingest) because it is the second half of the #920 pair: every postcode source
- * that groups member points — GeoNames postal, OSM `addr:postcode` — owes the same law, and a second hand-rolled copy
- * is where they drift.
+ * Exported for reuse by every postcode source that groups member points:
+ * GeoNames postal and OSM `addr:postcode`.
+ * Both sources owe the same law.
+ * A second hand-rolled copy would let them drift.
  */
 export declare function medoidPoint(points: readonly PostcodePoint[]): PostcodePoint;
+/**
+ * {@link medoidPoint} with the group size it rested on, for a caller that must
+ * record how thin the answer was.
+ */
+export declare function medoidWithSupport(points: readonly PostcodePoint[]): MedoidSupport;
 export interface GeonamesPostalIngestResult {
     /**
      * Distinct postcodes inserted across all countries.
@@ -78,16 +102,26 @@ export interface GeonamesPostalIngestResult {
      * Per-country distinct-postcode counts.
      */
     byCountry: Record<string, number>;
+    /**
+     * Per-country count of inserted codes the dump listed on several rows that all refer to one point.
+     *
+     * The coordinate rests on a single value no matter how many settlements sit under the code.
+     * Reported because the point is still the best the source offers.
+     *
+     * A consumer weighing postal coverage needs to know how much of it is this.
+     */
+    singlePointByCountry: Record<string, number>;
     /**
      * Countries whose `<CC>.txt` was missing under the postal dir (skipped, reported).
      */
     missing: string[];
 }
 /**
- * Fold GeoNames postcodes for `countries` into an open unified/postcode ingest DB: one `spr` row per distinct
- * normalized postcode (placetype `postalcode`, medoid centroid, degenerate bbox), the normalized form as `name`, and
- * the display form as an extra `names` row when it differs. The caller owns the FTS rebuild (rows ride the standard
- * freeze phase).
+ * Fold GeoNames postcodes for `countries` into an open unified/postcode ingest DB: one `spr` row
+ * per distinct normalized postcode (placetype `postalcode`, medoid centroid, degenerate bbox),
+ * the normalized form as `name`, and the display form as an extra `names` row when it differs.
+ *
+ * The caller owns the FTS rebuild (rows ride the standard freeze phase).
  */
 export declare function ingestGeonamesPostal(db: DatabaseClient<WOFDatabase>, countries: readonly string[], postalDir: PathBuilderLike): Promise<GeonamesPostalIngestResult>;
 //# sourceMappingURL=postal.d.ts.map

package/out/geonames/postal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postal.d.ts","sourceRoot":"","sources":["../../lib/geonames/postal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAQ,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAGpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAQ1C;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,gBAAoB,CAAA;AAExD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAErD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,aAAa,CA+B3E;AAED,MAAM,WAAW,0BAA0B;IAC1C;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAA;CACjB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACzC,EAAE,EAAE,cAAc,CAAC,WAAW,CAAC,EAC/B,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,SAAS,EAAE,eAAe,GACxB,OAAO,CAAC,0BAA0B,CAAC,CAsErC"}
+{"version":3,"file":"postal.d.ts","sourceRoot":"","sources":["../../lib/geonames/postal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,KAAK,eAAe,EAAsB,MAAM,SAAS,CAAA;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAU1C;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAErD;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC7B;;OAEG;IACH,KAAK,EAAE,aAAa,CAAA;IACpB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;;OAMG;IACH,cAAc,EAAE,MAAM,CAAA;CACtB;AAkCD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,aAAa,CAE3E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,aAAa,CAkCjF;AAED,MAAM,WAAW,0BAA0B;IAC1C;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC;;;;;;;OAOG;IACH,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5C;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAA;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACzC,EAAE,EAAE,cAAc,CAAC,WAAW,CAAC,EAC/B,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,SAAS,EAAE,eAAe,GACxB,OAAO,CAAC,0BAA0B,CAAC,CAgFrC"}