@mailwoman/resolver-wof-sqlite 9.4.0 → 10.1.0

package/out/candidate/lookup.js

@@ -0,0 +1,456 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import { expandPlacetypeFilter } from "@mailwoman/codex/placetype-map";
+import { referentialFromPopulation } from "@mailwoman/core/resolver";
+import { allRows } from "@mailwoman/core/utils";
+import { jaroWinkler, levenshteinSimilarity } from "@mailwoman/match/comparators";
+import { partitionByContainment } from "@mailwoman/resolver";
+import { haversineKm } from "@mailwoman/spatial";
+import { SQLiteLookup } from "@mailwoman/sqlite/lookup";
+import { CANDIDATE_ANCESTOR_TABLE, CANDIDATE_INTERVAL_TABLE, intervalContains, } from "#candidate/ancestors/schema";
+import { CANDIDATE_FTS_TABLE } from "#candidate/fts";
+import { readGazetteerCoverageManifest } from "#coverage-manifest-schema";
+import { POSTAL_CITY_CANDIDATE_TABLE } from "#postal/city/candidate-schema";
+import { rankByPrimaryPreference, RERANK_FETCH } from "#primary-preference";
+import { applyProximityRerank } from "#proximity-rerank";
+import { REGION_CLASS_PLACETYPES, regionQualifierProbeKeys } from "#region-keys";
+import { hasColumn, hasTable } from "#sqlite-utils";
+import { normalizeLocalityForKey, stripLocalityQualifier } from "#street/normalize";
+export { rankByPrimaryPreference } from "#primary-preference";
+const FUZZY_FETCH = 40;
+const WORD_FUZZY_MIN = 0.85;
+function wordFuzzySimilarity(a, b) {
+    return Math.max(jaroWinkler(a, b), levenshteinSimilarity(a, b));
+}
+const POSTCODE_CONTAINMENT_THRESHOLD_KM = 25;
+function ftsTrigramQuery(s) {
+    const grams = new Set();
+    for (let i = 0; i + 3 <= s.length; i++) {
+        const g = s.slice(i, i + 3);
+        if (/^[\p{L}\p{N} ]{3}$/u.test(g)) {
+            grams.add(g);
+        }
+    }
+    return [...grams].map((g) => `"${g}"`).join(" OR ");
+}
+/**
+ * Node {@link PlaceLookup} over `candidate.db`.
+ */
+export class WOFCandidateTableLookup extends SQLiteLookup {
+    #countryToID = new Map();
+    #idToCountry = new Map();
+    #placetypeToID = new Map();
+    #idToPlacetype = new Map();
+    #postalCityProbe;
+    #ftsProbe;
+    /**
+     * Prepared unfiltered `name_key` existence probe, so fuzzy fallback runs only for true name misses.
+     */
+    #nameKeyExistsProbe;
+    artifactCoverage;
+    #importanceSelect;
+    #hasNameRole;
+    #variantAliasExemption;
+    #roleSelect;
+    #ancestorsProbe;
+    #ancestorsCache = new Map();
+    #intervalProbe;
+    #intervalCache = new Map();
+    #qualifierProbe;
+    /**
+     * Ancestor lineage accessor, nearest-first, present only when the artifact supports it.
+     */
+    ancestors;
+    constructor(opts) {
+        super(opts);
+        for (const r of allRows(this.database.prepare("SELECT id, code FROM country_codes"))) {
+            const code = String(r.code).toUpperCase();
+            this.#countryToID.set(code, Number(r.id));
+            this.#idToCountry.set(Number(r.id), code);
+        }
+        for (const r of allRows(this.database.prepare("SELECT id, placetype FROM placetype_codes"))) {
+            this.#placetypeToID.set(String(r.placetype), Number(r.id));
+            this.#idToPlacetype.set(Number(r.id), String(r.placetype));
+        }
+        if (hasTable(this.database, POSTAL_CITY_CANDIDATE_TABLE)) {
+            this.#postalCityProbe = this.database.prepare(`SELECT spr_id, name, latitude, longitude FROM ${POSTAL_CITY_CANDIDATE_TABLE} WHERE name_key = ? AND postcode = ? LIMIT 1`);
+        }
+        if (hasTable(this.database, CANDIDATE_FTS_TABLE)) {
+            this.#ftsProbe = this.database.prepare(`SELECT name_key FROM ${CANDIDATE_FTS_TABLE} WHERE ${CANDIDATE_FTS_TABLE} MATCH ? ORDER BY bm25(${CANDIDATE_FTS_TABLE}) LIMIT ?`);
+            this.#nameKeyExistsProbe = this.database.prepare("SELECT 1 FROM candidate WHERE name_key = ? LIMIT 1");
+        }
+        // Optional columns are detected once here for hot-path reads.
+        this.#importanceSelect = hasColumn(this.database, "candidate", "importance") ? ", importance" : "";
+        this.#hasNameRole = hasColumn(this.database, "candidate", "name_role");
+        this.#variantAliasExemption = opts.variantAliasExemption === true;
+        this.#roleSelect = this.#hasNameRole ? ", name_role" : "";
+        if (hasTable(this.database, CANDIDATE_ANCESTOR_TABLE)) {
+            this.#ancestorsProbe = this.database.prepare(`SELECT parent_spr_id, parent_placetype_id, parent_name FROM ${CANDIDATE_ANCESTOR_TABLE}` +
+                " WHERE spr_id = ? ORDER BY depth ASC");
+            this.ancestors = (id) => this.#ancestorLineage(id);
+        }
+        if (this.#ancestorsProbe && hasTable(this.database, CANDIDATE_INTERVAL_TABLE)) {
+            this.#intervalProbe = this.database.prepare(`SELECT pre, post FROM ${CANDIDATE_INTERVAL_TABLE} WHERE spr_id = ?`);
+            const bandIDs = [...REGION_CLASS_PLACETYPES, "country"]
+                .map((placetype) => this.#placetypeToID.get(placetype))
+                .filter((id) => id !== undefined);
+            if (bandIDs.length) {
+                this.#qualifierProbe = this.database.prepare(`SELECT DISTINCT spr_id FROM candidate WHERE name_key = ? AND placetype_id IN (${bandIDs.join(",")}) LIMIT 8`);
+            }
+        }
+        this.artifactCoverage = readGazetteerCoverageManifest(this.database);
+    }
+    #ancestorLineage(id) {
+        const pid = typeof id === "number" ? id : Number(id);
+        if (!Number.isFinite(pid) || !this.#ancestorsProbe)
+            return [];
+        const cached = this.#ancestorsCache.get(pid);
+        if (cached)
+            return cached;
+        const rows = allRows(this.#ancestorsProbe, pid);
+        const lineage = rows.map((r) => ({
+            id: Number(r.parent_spr_id),
+            placetype: this.#idToPlacetype.get(Number(r.parent_placetype_id)) ?? "",
+            name: String(r.parent_name ?? ""),
+        }));
+        this.#ancestorsCache.set(pid, lineage);
+        return lineage;
+    }
+    #intervalLabel(sprID) {
+        if (!this.#intervalProbe)
+            return null;
+        const cached = this.#intervalCache.get(sprID);
+        if (cached !== undefined)
+            return cached;
+        const row = this.#intervalProbe.get(sprID);
+        const label = row ? { pre: Number(row.pre), post: Number(row.post) } : null;
+        this.#intervalCache.set(sprID, label);
+        return label;
+    }
+    #qualifierRegionIDs(qualifier, country) {
+        const ids = new Set();
+        if (!this.#qualifierProbe)
+            return ids;
+        for (const key of regionQualifierProbeKeys(qualifier, country)) {
+            if (!key)
+                continue;
+            for (const row of allRows(this.#qualifierProbe, key)) {
+                ids.add(Number(row.spr_id));
+            }
+        }
+        return ids;
+    }
+    /**
+     * Whether `sprID` is contained by any qualifier row, using interval labels first
+     * and the ancestor chain as fallback.
+     */
+    #containedByQualifier(sprID, qualifierIDs, qualifierLabels) {
+        if (qualifierIDs.has(sprID))
+            return true;
+        const label = this.#intervalLabel(sprID);
+        if (label && qualifierLabels.some((outer) => intervalContains(outer, label)))
+            return true;
+        return this.#ancestorLineage(sprID).some((ancestor) => qualifierIDs.has(Number(ancestor.id)));
+    }
+    /**
+     * Apply admin-containment re-rank: stamp containment, inject contained misses,
+     * then partition contained-first.
+     */
+    #applyAdminContainment(rows, qualifier, country, opts) {
+        const qualifierIDs = this.#qualifierRegionIDs(qualifier, country);
+        if (!qualifierIDs.size) {
+            for (const row of rows) {
+                row.containedByQualifier = false;
+            }
+            return rows;
+        }
+        const qualifierLabels = [...qualifierIDs]
+            .map((id) => this.#intervalLabel(id))
+            .filter((label) => label !== null);
+        const contained = (sprID) => this.#containedByQualifier(sprID, qualifierIDs, qualifierLabels);
+        for (const row of rows) {
+            row.containedByQualifier = contained(Number(row.spr_id));
+        }
+        const present = new Set(rows.map((row) => Number(row.spr_id)));
+        const injected = [];
+        const injectSQL = (primaryOnly) => "SELECT spr_id, name, country_id, placetype_id, latitude, longitude, min_lat, min_lon, max_lat, max_lon, neg_rank, is_primary, population" +
+            `${this.#importanceSelect} FROM candidate WHERE ${["name_key = ?", ...opts.shapeFilters, ...(primaryOnly ? ["is_primary = 1"] : [])].join(" AND ")} ` +
+            "ORDER BY neg_rank ASC LIMIT ?";
+        const injectFrom = (key, primaryOnly) => {
+            const fetched = allRows(this.database.prepare(injectSQL(primaryOnly)), key, ...opts.shapeParams, RERANK_FETCH);
+            for (const row of fetched) {
+                const sprID = Number(row.spr_id);
+                if (present.has(sprID) || !contained(sprID))
+                    continue;
+                present.add(sprID);
+                injected.push({ ...row, effectiveNegRank: row.neg_rank, demoted: false, containedByQualifier: true });
+            }
+        };
+        injectFrom(opts.nameKey, false);
+        // Also inject contained neighborhood-band namesakes (primary-keyed only).
+        const bandIDs = ["neighbourhood", "macrohood", "microhood"]
+            .map((placetype) => this.#placetypeToID.get(placetype))
+            .filter((id) => id !== undefined);
+        if (bandIDs.length) {
+            const bandSQL = "SELECT spr_id, name, country_id, placetype_id, latitude, longitude, min_lat, min_lon, max_lat, max_lon, neg_rank, is_primary, population" +
+                `${this.#importanceSelect} FROM candidate WHERE name_key = ? AND placetype_id IN (${bandIDs.map(() => "?").join(",")}) AND is_primary = 1 ` +
+                "ORDER BY neg_rank ASC LIMIT ?";
+            const fetched = allRows(this.database.prepare(bandSQL), opts.nameKey, ...bandIDs, RERANK_FETCH);
+            for (const row of fetched) {
+                const sprID = Number(row.spr_id);
+                if (present.has(sprID) || !contained(sprID))
+                    continue;
+                present.add(sprID);
+                injected.push({ ...row, effectiveNegRank: row.neg_rank, demoted: false, containedByQualifier: true });
+            }
+        }
+        // Try stripped-key injection only when exact-key containment found no row.
+        if (!injected.length &&
+            !rows.some((row) => row.containedByQualifier) &&
+            opts.strippedKey &&
+            opts.strippedKey !== opts.nameKey) {
+            injectFrom(opts.strippedKey, true);
+        }
+        if (!injected.length && !rows.some((row) => row.containedByQualifier))
+            return rows;
+        return partitionByContainment([...rows, ...injected], (row) => row.containedByQualifier === true, (row) => !row.demoted && !row.fuzzy).slice(0, opts.limit);
+    }
+    #wantsLocality(placetype) {
+        if (!placetype)
+            return true;
+        const want = Array.isArray(placetype) ? placetype : [placetype];
+        return expandPlacetypeFilter(want).includes("locality");
+    }
+    #postcodeAnchor(postcode, country) {
+        const placetypeID = this.#placetypeToID.get("postalcode");
+        if (placetypeID === undefined)
+            return null;
+        const conds = ["name_key = ?", "placetype_id = ?"];
+        const params = [postcode.replaceAll(/\s+/g, ""), placetypeID];
+        if (country) {
+            const countryID = this.#countryToID.get(country.toUpperCase());
+            if (countryID === undefined)
+                return null; // Unknown country in this artifact.
+            conds.push("country_id = ?");
+            params.push(countryID);
+        }
+        const row = this.database
+            .prepare(`SELECT latitude, longitude FROM candidate WHERE ${conds.join(" AND ")} ORDER BY neg_rank ASC LIMIT 1`)
+            .get(...params);
+        if (!row || (Number(row.latitude) === 0 && Number(row.longitude) === 0))
+            return null;
+        return { lat: Number(row.latitude), lon: Number(row.longitude) };
+    }
+    async findPlace(query) {
+        let text = (query.text ?? "").trim();
+        if (!text)
+            return [];
+        // Postcode queries use whitespace-stripped keying.
+        const wantsPostcode = [query.placetype].flat().includes("postalcode");
+        if (wantsPostcode) {
+            text = text.replaceAll(/\s+/g, "");
+        }
+        const nameKey = normalizeLocalityForKey(text);
+        if (!nameKey)
+            return [];
+        if (query.postcode && this.#postalCityProbe && this.#wantsLocality(query.placetype)) {
+            const hit = this.#postalCityProbe.get(nameKey, query.postcode.trim());
+            if (hit) {
+                return [
+                    {
+                        id: Number(hit.spr_id),
+                        name: String(hit.name ?? ""),
+                        placetype: "locality",
+                        country: query.country?.toUpperCase() ?? "",
+                        lat: Number(hit.latitude),
+                        lon: Number(hit.longitude),
+                        score: 1,
+                        exactMatch: true,
+                    },
+                ];
+            }
+        }
+        const limit = Math.max(1, query.limit ?? 10);
+        // Shape filters are tracked separately from the shared country scope for exact and stripped probes.
+        const filters = [];
+        const filterParams = [];
+        const shapeFilters = [];
+        const shapeParams = [];
+        if (query.country) {
+            const cid = this.#countryToID.get(query.country.toUpperCase());
+            if (cid === undefined)
+                return []; // Unknown country in this artifact.
+            filters.push("country_id = ?");
+            filterParams.push(cid);
+        }
+        if (query.placetype) {
+            // Expand placetype equivalents (e.g. locality includes borough/localadmin).
+            const want = Array.isArray(query.placetype) ? query.placetype : [query.placetype];
+            const ids = expandPlacetypeFilter(want)
+                .map((t) => this.#placetypeToID.get(t))
+                .filter((v) => v !== undefined);
+            if (!ids.length)
+                return [];
+            shapeFilters.push(`placetype_id IN (${ids.map(() => "?").join(",")})`);
+            shapeParams.push(...ids);
+        }
+        if (query.bbox) {
+            const b = query.bbox;
+            shapeFilters.push("latitude BETWEEN ? AND ? AND longitude BETWEEN ? AND ?");
+            shapeParams.push(b.minLat, b.maxLat, b.minLon, b.maxLon);
+        }
+        // Optional guard: restrict to primary rows for token-extracted probes.
+        if (query.primaryOnly) {
+            shapeFilters.push("is_primary = 1");
+        }
+        // The role filter is skipped on an artifact lacking `name_role`.
+        if (query.excludeNameRoles?.length && this.#hasNameRole) {
+            shapeFilters.push(`(name_role IS NULL OR name_role NOT IN (${query.excludeNameRoles.map(() => "?").join(",")}))`);
+            shapeParams.push(...query.excludeNameRoles);
+        }
+        filters.push(...shapeFilters);
+        filterParams.push(...shapeParams);
+        // Region scope is optional (`region_id = parentID`); the fallback stays unscoped.
+        const regionParentID = query.parentID || undefined;
+        const probe = (nk, regionID, countryID) => {
+            const conds = ["name_key = ?", ...filters];
+            const params = [nk, ...filterParams];
+            if (regionID !== undefined) {
+                conds.push("region_id = ?");
+                params.push(regionID);
+            }
+            if (typeof countryID === "number") {
+                conds.push("country_id = ?");
+                params.push(countryID);
+            }
+            // Population-ordered fetch over-fetches for the bounded primary-preference rerank.
+            const sql = "SELECT spr_id, name, country_id, placetype_id, latitude, longitude, min_lat, min_lon, max_lat, max_lon, neg_rank, is_primary, population" +
+                `${this.#importanceSelect}${this.#roleSelect} FROM candidate WHERE ${conds.join(" AND ")} ORDER BY neg_rank ASC LIMIT ?`;
+            const fetched = allRows(this.database.prepare(sql), ...params, Math.max(limit, RERANK_FETCH));
+            return rankByPrimaryPreference(fetched, limit, undefined, this.#idToPlacetype, this.#variantAliasExemption);
+        };
+        const cascade = (regionID) => {
+            let rows = probe(nameKey, regionID);
+            if (!rows.length) {
+                const strippedKey = normalizeLocalityForKey(stripLocalityQualifier(text));
+                if (strippedKey && strippedKey !== nameKey) {
+                    // Stripped probes only accept primary rows to avoid alias-scrape matches.
+                    rows = probe(strippedKey, regionID).filter((r) => r.is_primary === 1);
+                }
+            }
+            // Typo-tolerant fallback for true name misses only, skipping postcodes and respecting the fuzzy-country scope.
+            const fuzzyCountryID = !query.country && query.fuzzyCountry ? this.#countryToID.get(query.fuzzyCountry.toUpperCase()) : undefined;
+            const fuzzyScopedOut = !query.country && !!query.fuzzyCountry && typeof fuzzyCountryID !== "number";
+            if (!rows.length &&
+                !wantsPostcode &&
+                !fuzzyScopedOut &&
+                this.#ftsProbe &&
+                this.#nameKeyExistsProbe &&
+                !this.#nameKeyExistsProbe.get(nameKey)) {
+                const match = ftsTrigramQuery(nameKey);
+                if (match) {
+                    const hits = allRows(this.#ftsProbe, match, FUZZY_FETCH);
+                    const ranked = hits
+                        .map((h) => ({ nk: String(h.name_key), s: wordFuzzySimilarity(nameKey, String(h.name_key)) }))
+                        .filter((h) => h.s >= WORD_FUZZY_MIN)
+                        // oxlint-disable-next-line unicorn/no-array-sort -- sorts a freshly-built array. toSorted would double-allocate on a hot path
+                        .sort((a, b) => b.s - a.s);
+                    const seen = new Set();
+                    for (const h of ranked) {
+                        if (seen.has(h.nk))
+                            continue;
+                        seen.add(h.nk);
+                        rows.push(...probe(h.nk, regionID, fuzzyCountryID).map((r) => ({ ...r, fuzzy: true })));
+                        if (rows.length >= limit)
+                            break;
+                    }
+                    rows = rows.slice(0, limit);
+                }
+            }
+            return rows;
+        };
+        let rows = cascade(regionParentID);
+        let regionScopeMiss = false;
+        if (!rows.length && regionParentID !== undefined) {
+            rows = cascade(undefined);
+            regionScopeMiss = rows.length > 0;
+        }
+        if (query.postcode &&
+            query.postcodeContainmentCoherence === true &&
+            this.#wantsLocality(query.placetype) &&
+            rows.length > 1) {
+            const anchor = this.#postcodeAnchor(query.postcode, query.country);
+            if (anchor) {
+                const insideThreshold = [];
+                const outsideThreshold = [];
+                for (const row of rows) {
+                    const distanceKm = haversineKm(anchor.lat, anchor.lon, Number(row.latitude), Number(row.longitude));
+                    if (distanceKm <= POSTCODE_CONTAINMENT_THRESHOLD_KM) {
+                        insideThreshold.push({ row, distanceKm });
+                    }
+                    else {
+                        outsideThreshold.push(row);
+                    }
+                }
+                if (insideThreshold.length) {
+                    // oxlint-disable-next-line unicorn/no-array-sort -- hot-path in-place sort
+                    insideThreshold.sort((a, b) => a.distanceKm - b.distanceKm);
+                    rows = [...insideThreshold.map(({ row }) => row), ...outsideThreshold];
+                }
+            }
+        }
+        // Admin-containment re-rank runs last.
+        if (query.regionQualifier?.trim() && this.#qualifierProbe && this.#wantsLocality(query.placetype)) {
+            rows = this.#applyAdminContainment(rows, query.regionQualifier.trim(), query.country, {
+                nameKey,
+                strippedKey: normalizeLocalityForKey(stripLocalityQualifier(text)),
+                shapeFilters,
+                shapeParams,
+                limit,
+            });
+        }
+        const candidates = rows.map((row) => {
+            const hasBbox = row.min_lat != null && row.max_lat != null && row.min_lon != null && row.max_lon != null;
+            const parent = this.#ancestorLineage(Number(row.spr_id))[0];
+            return {
+                id: Number(row.spr_id),
+                name: String(row.name ?? ""),
+                placetype: (this.#idToPlacetype.get(Number(row.placetype_id)) ?? ""),
+                country: this.#idToCountry.get(Number(row.country_id)) ?? "",
+                lat: Number(row.latitude),
+                lon: Number(row.longitude),
+                ...(parent ? { parent_id: Number(parent.id) } : {}),
+                score: -Number(row.neg_rank),
+                prominence: -Number(row.effectiveNegRank),
+                exactMatch: !row.demoted && !row.fuzzy,
+                ...(regionScopeMiss ? { regionScopeMiss: true } : {}),
+                ...(row.containedByQualifier === undefined ? {} : { containedByQualifier: row.containedByQualifier }),
+                ...(row.variantExempted ? { variantAliasExempted: true } : {}),
+                ...(row.population === null || row.population <= 0
+                    ? {}
+                    : { population: row.population, referential: referentialFromPopulation(row.population) }),
+                ...(typeof row.importance === "number" && Number.isFinite(row.importance)
+                    ? { importance: row.importance }
+                    : {}),
+                ...(hasBbox
+                    ? {
+                        bbox: {
+                            minLat: Number(row.min_lat),
+                            maxLat: Number(row.max_lat),
+                            minLon: Number(row.min_lon),
+                            maxLon: Number(row.max_lon),
+                        },
+                    }
+                    : {}),
+            };
+        });
+        if (query.bias && query.bias.length) {
+            applyProximityRerank(candidates, query.bias);
+        }
+        return candidates;
+    }
+}
+//# sourceMappingURL=lookup.js.map

package/out/candidate/lookup.js.map

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

package/out/candidate/name-roles.d.ts

@@ -5,38 +5,26 @@
  * @file Pass 3c of the candidate build — the `name_role` detectors and the thresholds they are judged by.
  */
 import type { DatabaseClient } from "@mailwoman/sqlite/client";
-import type { CandidateDatabase } from "#candidate-schema";
 import type { PlaceAttrs } from "#candidate/place-attrs";
+import type { CandidateDatabase } from "#candidate/schema";
 import type { WOFDatabase } from "#schema";
 /**
- * Key-count threshold for the gloss anomaly detector (#1730) — the sweep's own boundary: 4,000 places carried >= 50
- * keys, and a legitimate famous place at that count (New York, 176 keys) is separated by the PROMINENCE check, never by
- * this number alone.
+ * Key-count threshold for the gloss anomaly detector.
+ *
+ * A legitimate famous place is separated by the prominence check rather than this number by itself.
  */
 export declare const GLOSS_KEY_THRESHOLD = 50;
 /**
- * Placetypes the gloss detector never flags. A country or region legitimately carries a name in every language — that
- * is what an exonym set IS — so key volume discriminates nothing there. The detector's population is the non-admin
- * tail, where a place named by a common noun ("Poisson", "Sunday") accumulating 200+ translations is a
- * machine-translated gloss set, not fame.
+ * Placetypes the gloss detector never flags: a country or region legitimately has a
+ * name in every language, so key volume provides no signal there.
  */
 export declare const GLOSS_EXCLUDED_PLACETYPES: ReadonlySet<string>;
 /**
- * Pass 3c — the #1730 name-role prototype: two independent detectors over the staged rows, WRITE-ONLY in this
- * generation (no ranking consumer; the rank penalty is its own D-rule-conditional step with the `gloss_key` board as
- * regression check). Both stamp `is_primary = 0` rows only — a place's canonical name and the `place_abbr` region
- * abbreviations are never a gloss or a variant.
- *
- * - `gloss` is ANOMALY-based, and stamps only the certain core: key volume at/over the threshold + a non-admin placetype
- *
- *   - NO measured prominence (population absent AND importance unmeasured). Provenance cannot separate a gloss from an
- *     exonym — WOF imported both as `x_preferred` — and prominence is what rescues New York/Paris.
- * - `abbr` is PROVENANCE-based — the #936 signal: a WOF `variant` name in one of the country's official languages (or
- *   English), measured there at a 13× key-collision rate. A source without a `names` table (fixture-scale admin DBs)
- *   skips this detector loudly.
+ * Stamp `name_role` on non-primary rows: `abbr` by provenance, `variant` by
+ * own-name verdict, then `gloss` by key-volume anomaly.
  *
- * Returns the stamp counts plus the census the prototype exists to report: how much of the ≥-threshold key tail carries
- * any role.
+ * @returns The stamp counts plus the census the prototype exists to report:
+ * how much of the ≥-threshold key tail has any role.
  */
 export declare function stampNameRoles(ctx: {
     src: DatabaseClient<WOFDatabase>;

package/out/candidate/name-roles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"name-roles.d.ts","sourceRoot":"","sources":["../../lib/candidate/name-roles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAG9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAG1C;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAA;AAErC;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,MAAM,CASxD,CAAA;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE;IACnC,GAAG,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;IAChC,GAAG,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;IACtC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAC9B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAClD,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CA0K/G"}
+{"version":3,"file":"name-roles.d.ts","sourceRoot":"","sources":["../../lib/candidate/name-roles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAI9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAG1C;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAA;AAErC;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,MAAM,CASxD,CAAA;AAEF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE;IACnC,GAAG,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;IAChC,GAAG,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;IACtC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAC9B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAClD,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAoK/G"}

package/out/candidate/name-roles.js

@@ -9,16 +9,14 @@ import { tableExists } from "@mailwoman/sqlite/introspection";
 import { isOwnNameVariant } from "#candidate/own-name";
 import { normalizeLocalityForKey } from "#street/normalize";
 /**
- * Key-count threshold for the gloss anomaly detector (#1730) — the sweep's own boundary: 4,000 places carried >= 50
- * keys, and a legitimate famous place at that count (New York, 176 keys) is separated by the PROMINENCE check, never by
- * this number alone.
+ * Key-count threshold for the gloss anomaly detector.
+ *
+ * A legitimate famous place is separated by the prominence check rather than this number by itself.
  */
 export const GLOSS_KEY_THRESHOLD = 50;
 /**
- * Placetypes the gloss detector never flags. A country or region legitimately carries a name in every language — that
- * is what an exonym set IS — so key volume discriminates nothing there. The detector's population is the non-admin
- * tail, where a place named by a common noun ("Poisson", "Sunday") accumulating 200+ translations is a
- * machine-translated gloss set, not fame.
+ * Placetypes the gloss detector never flags: a country or region legitimately has a
+ * name in every language, so key volume provides no signal there.
  */
 export const GLOSS_EXCLUDED_PLACETYPES = new Set([
     "country",
@@ -31,21 +29,11 @@ export const GLOSS_EXCLUDED_PLACETYPES = new Set([
     "county",
 ]);
 /**
- * Pass 3c — the #1730 name-role prototype: two independent detectors over the staged rows, WRITE-ONLY in this
- * generation (no ranking consumer; the rank penalty is its own D-rule-conditional step with the `gloss_key` board as
- * regression check). Both stamp `is_primary = 0` rows only — a place's canonical name and the `place_abbr` region
- * abbreviations are never a gloss or a variant.
- *
- * - `gloss` is ANOMALY-based, and stamps only the certain core: key volume at/over the threshold + a non-admin placetype
- *
- *   - NO measured prominence (population absent AND importance unmeasured). Provenance cannot separate a gloss from an
- *     exonym — WOF imported both as `x_preferred` — and prominence is what rescues New York/Paris.
- * - `abbr` is PROVENANCE-based — the #936 signal: a WOF `variant` name in one of the country's official languages (or
- *   English), measured there at a 13× key-collision rate. A source without a `names` table (fixture-scale admin DBs)
- *   skips this detector loudly.
+ * Stamp `name_role` on non-primary rows: `abbr` by provenance, `variant` by
+ * own-name verdict, then `gloss` by key-volume anomaly.
  *
- * Returns the stamp counts plus the census the prototype exists to report: how much of the ≥-threshold key tail carries
- * any role.
+ * @returns The stamp counts plus the census the prototype exists to report:
+ * how much of the ≥-threshold key tail has any role.
  */
 export function stampNameRoles(ctx) {
     const { src, out, attrs, keyCounts, glossThreshold, progress } = ctx;
@@ -63,7 +51,7 @@ export function stampNameRoles(ctx) {
             continue;
         if (GLOSS_EXCLUDED_PLACETYPES.has(ptNameByID.get(a.ptid) ?? ""))
             continue;
-        if (a.pop > 0 || a.imp != null)
+        if ((a.pop ?? 0) > 0 || a.imp != null)
             continue;
         glossSids.push(sid);
     }
@@ -73,9 +61,8 @@ export function stampNameRoles(ctx) {
     const hasSourceNames = tableExists(src, "names");
     if (hasSourceNames) {
         out.exec("BEGIN");
-        // Two provenance routes into the same stamp: WOF's abbreviation/short name KINDS arrive in the
-        // LANGUAGE column ('abbr'/'short' — 280 rows, measured 2026-08-18, Toledo's 'TO' among them) and
-        // qualify by kind alone; everything else qualifies as a variant in an official language.
+        // WOF's abbreviation/short name kinds qualify by kind only.
+        // Everything else qualifies as a variant in an official language.
         for (const r of src
             .prepare("SELECT id, name, language FROM names WHERE privateuse = 'variant' OR language IN ('abbr', 'short')")
             .iterate()) {
@@ -98,19 +85,14 @@ export function stampNameRoles(ctx) {
     else {
         progress("roles", "source carries no `names` table — abbr detector skipped (gloss still runs)");
     }
-    // Stamp order is precedence: the provenance-based abbr first, then the own-name variant verdict,
-    // then gloss fills what neither claimed.
+    // Stamp order is precedence: abbr first, then the own-name variant verdict, then gloss fills what neither claimed.
     const roleAbbr = Number(out
         .prepare(`UPDATE cand_stage SET name_role = 'abbr'
 				 WHERE is_primary = 0 AND EXISTS (
 					SELECT 1 FROM role_key rk WHERE rk.spr_id = cand_stage.spr_id AND rk.name_key = cand_stage.name_key)`)
         .run().changes);
-    // --- variant detector (#1882): the alias surface is the holder's OWN primary name in another
-    // orthography — romanization, spacing/diacritic variant, or abbreviation expansion. The verdict
-    // is per (alias key, primary key) pair, so it runs in JS over the still-unstamped alias rows;
-    // an uncovered script answers no-verdict and stamps nothing (own-name.ts owns the predicate and
-    // its measured threshold). Runs BEFORE gloss on purpose: a surface that IS the place's own name
-    // is not a translation, whatever the key volume says.
+    // Runs before gloss so the place's own name remains its source name.
+    // An uncovered script answers no-verdict.
     out.exec("CREATE TEMP TABLE variant_key (spr_id INTEGER NOT NULL, name_key TEXT NOT NULL, PRIMARY KEY (spr_id, name_key)) WITHOUT ROWID");
     const insVariantKey = out.prepare("INSERT OR IGNORE INTO variant_key VALUES (?, ?)");
     let variantScanned = 0;