@mailwoman/resolver-wof-sqlite 9.4.0 → 10.1.0

package/out/coverage-manifest-schema.d.ts

@@ -2,64 +2,54 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
+ * @file Schema and read/write helpers for the candidate gazetteer's coverage manifest.
  *
- *   Typed schema + read/write helpers for the candidate gazetteer's COVERAGE MANIFEST — the two
- *   country-keyed tables through which the artifact declares facts about ITSELF, so those facts are
- *   updated at gazetteer REBUILD, not by a hand-edited code PR after someone remembers:
- *
- *   - `country_coverage`: the hard-country-filter coverage record (#743/#194) — per-country
- *     promotion-eval verdicts + the measured hard-resolve rates that used to live in a code comment on
- *     `HARD_PLACE_COUNTRY_SAFELIST`. Presence = measured; `hard_filter_safe = 0` = measured and
- *     FAILED the check (FI 69.5%, PL 77.8%) — distinguishable from a country never measured at all
- *     (the meaning-of-zero rule, `docs/engineering/reference/layer-contract.mdx`).
- *   - `country_bbox`: the coarse guard-B plausibility boxes that used to live in
- *     `resolver/plausibility.ts`'s `COUNTRY_BBOX`. An absent row fails open (never trips the guard),
- *     exactly like an absent key in the constant.
- *
- *   Emission happens at build time (`mailwoman/gazetteer-pipeline/coverage-manifest.ts` owns the
- *   measured record and calls {@link writeGazetteerCoverageManifest} before the DB is sealed — never
- *   patch a shipped DB, rebuild). The read happens at open time ({@link WOFCandidateTableLookup}
- *   calls {@link readGazetteerCoverageManifest} in its constructor); an artifact that predates the
- *   manifest returns `undefined` and every consumer falls back to the code constants byte-identically.
+ *   The manifest holds two country-keyed tables. `country_coverage` records each measured country's hard-filter
+ *   verdict. A missing row means the country was never measured. `hard_filter_safe = 0` means measurement found the
+ *   filter unsafe. `country_bbox` holds coarse plausibility boxes. A missing bbox row never trips the guard.
  */
 import { type CountryBBoxFact, type CountryCoverageFact, type GazetteerArtifactCoverage } from "@mailwoman/core/resolver";
 import type { DatabaseClient } from "@mailwoman/sqlite/client";
 import { type Kysely } from "kysely";
 /**
- * One country's hard-filter coverage measurement — the storage form of {@link CountryCoverageFact}.
+ * The stored form of {@link CountryCoverageFact}, one row per country.
  */
 export interface CountryCoverageTable {
     /**
-     * ISO 3166-1 alpha-2, uppercase (PK).
+     * The upper-case ISO 3166-1 alpha-2 code.
+     * This field is the primary key.
      */
     country: string;
     /**
-     * 0/1 — the promotion-eval verdict (a verdict column, NOT re-derived from the rate; see the fact type's docstring).
+     * The promotion-eval verdict as 0 or 1.
+     *
+     * It is stored directly because the rate by itself does not decide it.
      */
     hard_filter_safe: number;
     /**
-     * Measured hard-resolve rate 0..1 on the panel named in `source`; NULL when the receipt recorded none.
+     * The hard-resolve rate from 0 to 1 on the panel given in `source`, or NULL when none was recorded.
      */
     hard_resolve_rate: number | null;
     /**
-     * Panel size behind `hard_resolve_rate`; NULL when unrecorded.
+     * The panel size behind `hard_resolve_rate`, or NULL when none was recorded.
      */
     sample_size: number | null;
     /**
-     * ISO-8601 date of the measurement / promote eval.
+     * The ISO 8601 date of the measurement.
      */
     measured_at: string;
     /**
-     * The receipt: which panel/check produced this row.
+     * The panel or check that produced this row.
      */
     source: string;
 }
 /**
- * One country's coarse guard-B bounding box — the storage form of {@link CountryBBoxFact}.
+ * The stored form of {@link CountryBBoxFact}, one coarse bounding box per country.
  */
 export interface CountryBBoxTable {
     /**
-     * ISO 3166-1 alpha-2, uppercase (PK).
+     * The upper-case ISO 3166-1 alpha-2 code.
+     * This field is the primary key.
      */
     country: string;
     lat_min: number;
@@ -67,7 +57,7 @@ export interface CountryBBoxTable {
     lon_min: number;
     lon_max: number;
     /**
-     * Provenance of the box (harness + date).
+     * The provenance of the box.
      */
     source: string;
 }
@@ -79,34 +69,39 @@ export interface GazetteerCoverageDatabase {
     country_bbox: CountryBBoxTable;
 }
 /**
- * Table names the lookup probes (existence-restricted, so a candidate.db built before the manifest is byte-stable).
+ * The name of the per-country coverage table.
+ * Readers check that it exists before querying it.
  */
 export declare const COUNTRY_COVERAGE_TABLE = "country_coverage";
 /**
- * Table of per-country bounding boxes, used to reject a placement that fell outside its own country.
+ * The name of the per-country bounding-box table, used to reject a placement outside its own country.
  */
 export declare const COUNTRY_BBOX_TABLE = "country_bbox";
 /**
- * Create `country_coverage` — a handful of small PK-probed rows, the WITHOUT ROWID sweet spot.
+ * Creates the `country_coverage` table as a `WITHOUT ROWID` table keyed by country.
  */
 export declare function createCountryCoverageTable(db: Kysely<GazetteerCoverageDatabase>): Promise<void>;
 /**
- * Create `country_bbox` — same shape discipline as {@link createCountryCoverageTable}.
+ * Creates the `country_bbox` table as a `WITHOUT ROWID` table keyed by country.
  */
 export declare function createCountryBBoxTable(db: Kysely<GazetteerCoverageDatabase>): Promise<void>;
 /**
- * Write the coverage manifest into a candidate DB UNDER CONSTRUCTION (pre-seal — a shipped DB is never patched, rebuild
- * instead). Creates both tables and inserts the facts; call exactly once, from the gazetteer build.
+ * Creates both manifest tables in a candidate database under construction and inserts the facts.
+ *
+ * The gazetteer build calls it once.
+ * A shipped database is rebuilt instead of patched.
  */
 export declare function writeGazetteerCoverageManifest(db: Kysely<GazetteerCoverageDatabase>, facts: {
     coverage: readonly CountryCoverageFact[];
     bboxes: readonly CountryBBoxFact[];
 }): Promise<void>;
 /**
- * Read the coverage manifest from an OPEN candidate DB, or `undefined` when the artifact predates it (neither table
- * present) — the signal for consumers to fall back to the code constants byte-identically. Synchronous raw reads on
- * purpose: this runs inside {@link WOFCandidateTableLookup}'s synchronous constructor (the sync-reader carve-out in
- * `AGENTS.md`), and the tables are a few dozen rows read once per open.
+ * Reads the coverage manifest from an open candidate database.
+ *
+ * It returns `undefined` when neither table exists.
+ * Consumers then fall back to the code constants.
+ *
+ * The reads are synchronous because the candidate lookup calls this from its constructor.
  */
 export declare function readGazetteerCoverageManifest<DB>(db: DatabaseClient<DB>): GazetteerArtifactCoverage | undefined;
 //# sourceMappingURL=coverage-manifest-schema.d.ts.map

package/out/coverage-manifest-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coverage-manifest-schema.d.ts","sourceRoot":"","sources":["../lib/coverage-manifest-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAEN,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,MAAM,0BAA0B,CAAA;AAEjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAO,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAA;AAIzC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAA;IACxB;;OAEG;IACH,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACzC,gBAAgB,EAAE,oBAAoB,CAAA;IACtC,YAAY,EAAE,gBAAgB,CAAA;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,qBAAqB,CAAA;AACxD;;GAEG;AACH,eAAO,MAAM,kBAAkB,iBAAiB,CAAA;AAEhD;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,EAAE,EAAE,MAAM,CAAC,yBAAyB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAarG;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,EAAE,EAAE,MAAM,CAAC,yBAAyB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAYjG;AAED;;;GAGG;AACH,wBAAsB,8BAA8B,CACnD,EAAE,EAAE,MAAM,CAAC,yBAAyB,CAAC,EACrC,KAAK,EAAE;IAAE,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;CAAE,GACrF,OAAO,CAAC,IAAI,CAAC,CAmCf;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,GAAG,yBAAyB,GAAG,SAAS,CAuD/G"}
+{"version":3,"file":"coverage-manifest-schema.d.ts","sourceRoot":"","sources":["../lib/coverage-manifest-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAEN,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,MAAM,0BAA0B,CAAA;AAEjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAO,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAA;AAIzC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAA;IACxB;;OAEG;IACH,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACzC,gBAAgB,EAAE,oBAAoB,CAAA;IACtC,YAAY,EAAE,gBAAgB,CAAA;CAC9B;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,qBAAqB,CAAA;AACxD;;GAEG;AACH,eAAO,MAAM,kBAAkB,iBAAiB,CAAA;AAEhD;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,EAAE,EAAE,MAAM,CAAC,yBAAyB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAarG;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,EAAE,EAAE,MAAM,CAAC,yBAAyB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAYjG;AAED;;;;;GAKG;AACH,wBAAsB,8BAA8B,CACnD,EAAE,EAAE,MAAM,CAAC,yBAAyB,CAAC,EACrC,KAAK,EAAE;IAAE,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;CAAE,GACrF,OAAO,CAAC,IAAI,CAAC,CAmCf;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,GAAG,yBAAyB,GAAG,SAAS,CAuD/G"}

package/out/coverage-manifest-schema.js

@@ -2,40 +2,27 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
+ * @file Schema and read/write helpers for the candidate gazetteer's coverage manifest.
  *
- *   Typed schema + read/write helpers for the candidate gazetteer's COVERAGE MANIFEST — the two
- *   country-keyed tables through which the artifact declares facts about ITSELF, so those facts are
- *   updated at gazetteer REBUILD, not by a hand-edited code PR after someone remembers:
- *
- *   - `country_coverage`: the hard-country-filter coverage record (#743/#194) — per-country
- *     promotion-eval verdicts + the measured hard-resolve rates that used to live in a code comment on
- *     `HARD_PLACE_COUNTRY_SAFELIST`. Presence = measured; `hard_filter_safe = 0` = measured and
- *     FAILED the check (FI 69.5%, PL 77.8%) — distinguishable from a country never measured at all
- *     (the meaning-of-zero rule, `docs/engineering/reference/layer-contract.mdx`).
- *   - `country_bbox`: the coarse guard-B plausibility boxes that used to live in
- *     `resolver/plausibility.ts`'s `COUNTRY_BBOX`. An absent row fails open (never trips the guard),
- *     exactly like an absent key in the constant.
- *
- *   Emission happens at build time (`mailwoman/gazetteer-pipeline/coverage-manifest.ts` owns the
- *   measured record and calls {@link writeGazetteerCoverageManifest} before the DB is sealed — never
- *   patch a shipped DB, rebuild). The read happens at open time ({@link WOFCandidateTableLookup}
- *   calls {@link readGazetteerCoverageManifest} in its constructor); an artifact that predates the
- *   manifest returns `undefined` and every consumer falls back to the code constants byte-identically.
+ *   The manifest holds two country-keyed tables. `country_coverage` records each measured country's hard-filter
+ *   verdict. A missing row means the country was never measured. `hard_filter_safe = 0` means measurement found the
+ *   filter unsafe. `country_bbox` holds coarse plausibility boxes. A missing bbox row never trips the guard.
  */
 import { hardCountrySafelistFromCoverage, } from "@mailwoman/core/resolver";
 import { allRows } from "@mailwoman/core/utils";
 import { sql } from "kysely";
 import { hasTable } from "#sqlite-utils";
 /**
- * Table names the lookup probes (existence-restricted, so a candidate.db built before the manifest is byte-stable).
+ * The name of the per-country coverage table.
+ * Readers check that it exists before querying it.
  */
 export const COUNTRY_COVERAGE_TABLE = "country_coverage";
 /**
- * Table of per-country bounding boxes, used to reject a placement that fell outside its own country.
+ * The name of the per-country bounding-box table, used to reject a placement outside its own country.
  */
 export const COUNTRY_BBOX_TABLE = "country_bbox";
 /**
- * Create `country_coverage` — a handful of small PK-probed rows, the WITHOUT ROWID sweet spot.
+ * Creates the `country_coverage` table as a `WITHOUT ROWID` table keyed by country.
  */
 export async function createCountryCoverageTable(db) {
     await db.schema
@@ -47,12 +34,12 @@ export async function createCountryCoverageTable(db) {
         .addColumn("sample_size", "integer")
         .addColumn("measured_at", "text", (c) => c.notNull())
         .addColumn("source", "text", (c) => c.notNull())
-        // `WITHOUT ROWID` has no first-class builder; the raw modifier is the idiomatic fallback.
+        // Kysely has no builder method for `without rowid`.
         .modifyEnd(sql `without rowid`)
         .execute();
 }
 /**
- * Create `country_bbox` — same shape discipline as {@link createCountryCoverageTable}.
+ * Creates the `country_bbox` table as a `WITHOUT ROWID` table keyed by country.
  */
 export async function createCountryBBoxTable(db) {
     await db.schema
@@ -68,8 +55,10 @@ export async function createCountryBBoxTable(db) {
         .execute();
 }
 /**
- * Write the coverage manifest into a candidate DB UNDER CONSTRUCTION (pre-seal — a shipped DB is never patched, rebuild
- * instead). Creates both tables and inserts the facts; call exactly once, from the gazetteer build.
+ * Creates both manifest tables in a candidate database under construction and inserts the facts.
+ *
+ * The gazetteer build calls it once.
+ * A shipped database is rebuilt instead of patched.
  */
 export async function writeGazetteerCoverageManifest(db, facts) {
     await createCountryCoverageTable(db);
@@ -102,10 +91,12 @@ export async function writeGazetteerCoverageManifest(db, facts) {
     }
 }
 /**
- * Read the coverage manifest from an OPEN candidate DB, or `undefined` when the artifact predates it (neither table
- * present) — the signal for consumers to fall back to the code constants byte-identically. Synchronous raw reads on
- * purpose: this runs inside {@link WOFCandidateTableLookup}'s synchronous constructor (the sync-reader carve-out in
- * `AGENTS.md`), and the tables are a few dozen rows read once per open.
+ * Reads the coverage manifest from an open candidate database.
+ *
+ * It returns `undefined` when neither table exists.
+ * Consumers then fall back to the code constants.
+ *
+ * The reads are synchronous because the candidate lookup calls this from its constructor.
  */
 export function readGazetteerCoverageManifest(db) {
     const hasCoverage = hasTable(db, COUNTRY_COVERAGE_TABLE);

package/out/coverage-manifest-schema.js.map

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

package/out/currency-backfill.d.ts

@@ -3,34 +3,17 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   Pass 1c of the candidate build (#1737): resurrect deprecated-with-no-successor WOF localities that a second
- *   source independently attests. Extracted from `build-candidate.ts` as a cohesive unit — the checks, their measured
- *   constants, and the GeoNames dump reader live together here; the build calls {@link resurrectCurrencyHoles} once,
- *   between the primaries pass and the alias pass.
+ *   Restores deprecated WOF localities only when an independent source attests them.
  */
 import type { DatabaseClient } from "@mailwoman/sqlite/client";
-import type { loadImportanceIndex } from "#candidate-importance";
-import type { CandidateDatabase } from "#candidate-schema";
+import { type PathBuilderLike } from "path-ts";
+import type { loadImportanceIndex } from "#candidate/importance";
 import type { PlaceAttrs, StageRow } from "#candidate/place-attrs";
+import type { CandidateDatabase } from "#candidate/schema";
 import type { WOFDatabase } from "#schema";
 /**
- * Pass 1c (#1737): resurrect deprecated-with-no-successor localities that a second source independently attests.
- *
- * WOF deprecations WITH a successor need nothing — the successor indexes. A deprecation with `is_superseded = 0` on a
- * populated place is the shape of an upstream mistake (Rochester Kent, Aldershot, Telford; 120 GB localities alone),
- * and it is indistinguishable from a correct pruning at this layer without outside evidence. So every resurrection
- * requires all three conditions, positive evidence only:
- *
- * 1. NO live same-name spr row of any placetype within {@link CURRENCY_BACKFILL_RADIUS_KM} of the dead record — a live row
- *    means the place is alive (possibly under another placetype) and there is no hole. A DISTANT same-name row is a
- *    namesake and does not block.
- * 2. A GeoNames feature-class-P attestation of the same folded name within the radius.
- * 3. The attestor at or above {@link CURRENCY_BACKFILL_POP_FLOOR}.
- *
- * The staged row keeps the WOF identity — id, name, centroid, bbox, region ancestry — because the dead record's own
- * data is not what is wrong with it. GeoNames contributes exactly two things: the attestation, and the population that
- * lets the row stand in prominence races (the dead record's own population is absent). Each name is judged once per
- * country; the resurrected place joins `attrs`, so the alias pass explodes its alt names like any primary's.
+ * Restore a deprecated locality only when no nearby live namesake exists and GeoNames
+ * attests the same folded name above {@link CURRENCY_BACKFILL_POP_FLOOR}.
  */
 export interface CurrencyBackfillOutcomes {
     judged: number;
@@ -40,8 +23,8 @@ export interface CurrencyBackfillOutcomes {
     resurrected: number;
 }
 /**
- * One country's read of the check — every dead name judged, by outcome and by the dead row's placetype — so a census
- * can say what a wider dead-row query admits before a build carries it.
+ * One country's read of the check — every dead name judged, by outcome and by the dead
+ * row's placetype — so a census can say what a wider query admits.
  */
 export interface CurrencyBackfillCountryReport extends CurrencyBackfillOutcomes {
     country: string;
@@ -49,23 +32,21 @@ export interface CurrencyBackfillCountryReport extends CurrencyBackfillOutcomes
     dumpPresent: boolean;
     byDeadPlacetype: Record<string, CurrencyBackfillOutcomes>;
     /**
-     * The first resurrected names, `placetype:name`, so a census reads what a wider query admits — capped, because the
-     * report is a receipt and not the table.
+     * The first resurrected names, `placetype:name`, capped because the report is a receipt and not the table.
      */
     sample: string[];
 }
 /**
- * The placetypes a dead row may carry to be judged at all. `locality` is the shipped default; `localadmin` is the
- * second cause #1746 named (one GB row of seventeen) and is admitted through this option once its census is read.
+ * The placetypes a dead row may have to be judged at all; `locality` is the shipped default.
  */
 export declare const DEFAULT_DEAD_PLACETYPES: readonly string[];
 export declare function resurrectCurrencyHoles(ctx: {
     src: DatabaseClient<WOFDatabase>;
     /**
-     * The candidate build's transaction. Required unless `dryRun` — a dry run judges every row and stages nothing.
+     * The candidate build's transaction, required unless `dryRun`.
      */
     tx?: DatabaseClient<CandidateDatabase>;
-    geonamesDir: string;
+    geonamesDir: PathBuilderLike;
     countries: readonly string[];
     attrs: Map<number, PlaceAttrs>;
     ccID: (code: string | null) => number;
@@ -74,12 +55,9 @@ export declare function resurrectCurrencyHoles(ctx: {
     importance: ReturnType<typeof loadImportanceIndex> | undefined;
     stageRow: StageRow;
     progress: (phase: string, message: string) => void;
-    /**
-     * Which dead placetypes are judged. Default {@link DEFAULT_DEAD_PLACETYPES}.
-     */
     deadPlacetypes?: readonly string[];
     /**
-     * Judge and count, stage nothing — the census mode. No transaction is opened.
+     * Judge and count while staging no row and opening no transaction.
      */
     dryRun?: boolean;
     /**

package/out/currency-backfill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"currency-backfill.d.ts","sourceRoot":"","sources":["../lib/currency-backfill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAI9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAmB1C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,wBAAwB;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,6BAA8B,SAAQ,wBAAwB;IAC9E,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,WAAW,EAAE,OAAO,CAAA;IACpB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAA;IACzD;;;OAGG;IACH,MAAM,EAAE,MAAM,EAAE,CAAA;CAChB;AAID;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAAiB,CAAA;AAMtE,wBAAsB,sBAAsB,CAAC,GAAG,EAAE;IACjD,GAAG,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;IAChC;;OAEG;IACH,EAAE,CAAC,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAC9B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,CAAA;IACrC,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,CAAA;IACnC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,UAAU,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,GAAG,SAAS,CAAA;IAC9D,QAAQ,EAAE,QAAQ,CAAA;IAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAClD;;OAEG;IACH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,6BAA6B,KAAK,IAAI,CAAA;CAC3D,GAAG,OAAO,CAAC,MAAM,CAAC,CAmNlB"}
+{"version":3,"file":"currency-backfill.d.ts","sourceRoot":"","sources":["../lib/currency-backfill.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,KAAK,eAAe,EAAe,MAAM,SAAS,CAAA;AAG3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAO1C;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,6BAA8B,SAAQ,wBAAwB;IAC9E,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,WAAW,EAAE,OAAO,CAAA;IACpB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAA;IACzD;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAA;CAChB;AAID;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAAiB,CAAA;AAMtE,wBAAsB,sBAAsB,CAAC,GAAG,EAAE;IACjD,GAAG,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;IAChC;;OAEG;IACH,EAAE,CAAC,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;IACtC,WAAW,EAAE,eAAe,CAAA;IAC5B,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAC9B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,CAAA;IACrC,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,CAAA;IACnC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,UAAU,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,GAAG,SAAS,CAAA;IAC9D,QAAQ,EAAE,QAAQ,CAAA;IAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAElD,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,6BAA6B,KAAK,IAAI,CAAA;CAC3D,GAAG,OAAO,CAAC,MAAM,CAAC,CAwMlB"}

package/out/currency-backfill.js

@@ -3,10 +3,7 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   Pass 1c of the candidate build (#1737): resurrect deprecated-with-no-successor WOF localities that a second
- *   source independently attests. Extracted from `build-candidate.ts` as a cohesive unit — the checks, their measured
- *   constants, and the GeoNames dump reader live together here; the build calls {@link resurrectCurrencyHoles} once,
- *   between the primaries pass and the alias pass.
+ *   Restores deprecated WOF localities only when an independent source attests them.
  */
 import { pathExists } from "@mailwoman/core/fs/readers";
 import { isStrictlyFiner } from "@mailwoman/core/resources/whosonfirst";
@@ -14,24 +11,11 @@ import { haversineKm } from "@mailwoman/spatial";
 import { resolvePath } from "path-ts";
 import { TSVSpliterator } from "spliterator";
 import { normalizeLocalityForKey } from "#street/normalize";
-/**
- * Corroboration radius for the currency backfill (#1737), km — both for the live-near blocker and the GeoNames
- * attestation. Measured basis (2026-08-19 prototype, GB locality slice): at 10 km, 20 of 108 dead names resurrect —
- * Rochester (Kent), Aldershot, Staines, Telford, Ebbw Vale among them — while the `Birmingham/Wolverhampton/…`
- * conurbation blobs stay dead (no attestation) and Swansea/Wrexham stay out because a live same-name row already serves
- * them within the radius.
- */
 const CURRENCY_BACKFILL_RADIUS_KM = 10;
-/**
- * Minimum attestor population for a resurrection. The same prototype measured 44 of 108 dead GB names attested but
- * under this floor — hamlet-scale ghosts whose absence from the index nobody has reported. A floor keeps the pass
- * answering the measured defect (real settlements) rather than re-importing the tail WOF chose to prune.
- */
 const CURRENCY_BACKFILL_POP_FLOOR = 1000;
 const REPORT_SAMPLE_SIZE = 25;
 /**
- * The placetypes a dead row may carry to be judged at all. `locality` is the shipped default; `localadmin` is the
- * second cause #1746 named (one GB row of seventeen) and is admitted through this option once its census is read.
+ * The placetypes a dead row may have to be judged at all; `locality` is the shipped default.
  */
 export const DEFAULT_DEAD_PLACETYPES = ["locality"];
 function emptyOutcomes() {
@@ -65,17 +49,17 @@ export async function resurrectCurrencyHoles(ctx) {
             ctx.onCountry?.(report);
             continue;
         }
-        // Dead rows FIRST: a country with no deprecated-no-successor localities needs no attestors at all, and
-        // loading a national dump to judge zero rows is pure heap pressure on a build already near its ceiling
-        // (the first live run OOM'd in a later pass with JP/KR dumps loaded for 0 dead names each).
+        // Read dead rows first.
+        // A country with no dead names then avoids loading its national dump.
+        // That avoids heap pressure on a build near its limit.
         const dead = deadStmt.all(cc, ...deadPlacetypes);
         if (!dead.length) {
             ctx.progress("currency-backfill", `${cc}: 0 dead names — dump not loaded`);
             ctx.onCountry?.(report);
             continue;
         }
-        // Only the dead names' own folded keys can ever be probed, so only those keys are worth holding —
-        // the rest of the national dump streams through without residency.
+        // Only the dead names' own folded keys can ever be probed, so the rest of the
+        // national dump streams through without residency.
         const deadKeys = new Set();
         for (const d of dead) {
             const k = normalizeLocalityForKey(String(d.name ?? ""));
@@ -83,8 +67,7 @@ export async function resurrectCurrencyHoles(ctx) {
                 deadKeys.add(k);
             }
         }
-        // Folded name → P-class attestors. GeoNames columns by index: 1 name, 2 ascii, 4 lat, 5 lon,
-        // 6 feature_class, 14 population.
+        // GeoNames columns by index: 1 name, 2 ascii, 4 lat, 5 lon, 6 feature_class, 14 population.
         const attestors = new Map();
         for await (const f of TSVSpliterator.fromAsync(dumpPath, { header: false })) {
             if (f[6] !== "P")
@@ -118,28 +101,18 @@ export async function resurrectCurrencyHoles(ctx) {
             if (!pkey || seen.has(pkey))
                 continue;
             seen.add(pkey);
-            // Read from the row: the query admits whatever `deadPlacetypes` names, and the rank comparison below must
-            // judge each candidate against ITS dead rung, never a hardcoded one.
+            // The query admits whatever `deadPlacetypes` names, so the rank comparison
+            // judges each candidate against its own dead rung.
             const deadPlacetype = String(d.placetype ?? "locality");
             count(deadPlacetype, "judged");
             const dLat = Number(d.latitude);
             const dLon = Number(d.longitude);
-            // A live row blocks only when it is AT LEAST AS COARSE as the dead one. The original check compared name and
-            // distance alone, on the premise that a nearby same-name row means "the place is alive under another
-            // placetype" — true for a place recorded twice, false for a placetype DEMOTION, which is the shape that
-            // actually occurs: WOF retired `Gillingham` the locality (pop 101,187) and kept `Gillingham` the
-            // neighbourhood 3.2 km away, and the check read the surviving CHILD as covering its own dead parent.
-            // Sixteen of seventeen GB refusals had exactly that shape (#1746).
-            //
-            // An UNRANKED placetype blocks, which is the conservative direction: this check's failure mode is inventing
-            // a place, so a row we cannot rank is treated as covering rather than waved through.
+            // A live row blocks unless it is strictly finer than the dead one.
+            // An unranked placetype also blocks because the failure mode is inventing a place.
             const liveNear = liveStmt.all(cc, name).some((row) => {
                 if (haversineKm(dLat, dLon, Number(row.latitude), Number(row.longitude)) > CURRENCY_BACKFILL_RADIUS_KM) {
                     return false;
                 }
-                // Blocks UNLESS the live row is strictly finer. The equal rung must still block — a live `locality`
-                // covers a dead `locality` — and an unranked placetype blocks too, since this check's failure mode
-                // is inventing a place.
                 return isStrictlyFiner(String(row.placetype ?? ""), deadPlacetype) !== true;
             });
             if (liveNear) {

package/out/currency-backfill.js.map

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

package/out/env.d.ts

@@ -3,7 +3,7 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- * Environment variables naming the WOF SQLite artifacts this resolver opens, and the development weights the overlay
+ * Environment variables name the WOF SQLite artifacts this resolver opens and the development weights the overlay
  *   linker materializes. CLI flags (`--resolve-db`, …) override these at the call site.
  */
 import { z } from "zod";
@@ -27,10 +27,10 @@ export declare const $public: Record<never, never> & {
     MAILWOMAN_CONFIG_ROOT: string;
     MAILWOMAN_CACHE_ROOT: string;
     MAILWOMAN_TEMP_ROOT: string;
+    MAILWOMAN_COARSE_PLACER_DIR?: string | undefined;
     MAILWOMAN_DOCS_URL?: string | undefined;
     MAILWOMAN_LICENSE_KEY?: string | undefined;
     MAILWOMAN_LICENSE_URL?: string | undefined;
-    MAILWOMAN_COARSE_PLACER_DIR?: string | undefined;
 } & {
     MAILWOMAN_WOF_DB?: string | undefined;
     MAILWOMAN_WOF_ADMIN_DB?: string | undefined;

package/out/env.js

@@ -3,7 +3,7 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- * Environment variables naming the WOF SQLite artifacts this resolver opens, and the development weights the overlay
+ * Environment variables name the WOF SQLite artifacts this resolver opens and the development weights the overlay
  *   linker materializes. CLI flags (`--resolve-db`, …) override these at the call site.
  */
 import { $public as corePublic, liveEnv } from "@mailwoman/core/env";

package/out/exact-match.d.ts

@@ -3,23 +3,32 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   The exact-match tier's name probes — the two case-folded equality lookups that decide whether a
+ *   The exact-match tier's name probes, the two case-folded equality lookups that decide whether a
  *   candidate holds the query text as its own name, an alias, or an official name.
  */
 import type { DatabaseClient } from "@mailwoman/sqlite/client";
 /**
- * Among `ids`, return the subset whose name OR any alias equals `text` case-insensitively — the exact-match tier for
- * ranking. One indexed query over `<schema>.names`. When the extract has no `names` table (a slim DB built with
- * `dropNames`, or a postcode-only extract), fall back to the self-contained `place_search` FTS content: its `alt_names`
- * column is the same alias set joined on the boundary-preserving `ALIAS_SEPARATOR` (#523), so `aliasBagExactMatch`
- * recovers the exact alias tier ("New York City" → New York) that the dropped `names` table used to provide.
+ * Among `ids`, return the subset whose name or any alias equals `text` case-insensitively,
+ * the exact-match tier for ranking.
+ *
+ * One indexed query over `<schema>.names`.
+ * When the extract has no `names` table (a slim database built with `dropNames`, or a postcode-only extract),
+ * fall back to the self-contained `place_search` FTS content.
+ *
+ * Its `alt_names` column is the same alias set joined on the boundary-preserving
+ * `ALIAS_SEPARATOR`, so `aliasBagExactMatch` recovers the exact alias tier
+ * ("New York City" → New York) that the dropped `names` table used to provide.
  */
 export declare function exactMatchIDs<DB>(db: DatabaseClient<DB>, schemaName: string, ids: number[], text: string): Set<number>;
 /**
- * Among `ids` (already known exact matches), the subset holding `text` as an OFFICIAL name (`names.official = 1`, the
- * #940 ingest bit). Same COLLATE NOCASE semantics as {@link WOFSQLitePlaceLookup.#exactMatchIDs} so the two probes
- * agree on what "equals the query" means. Fails soft on gazetteers built before #940 (no `official` column) — the
- * sub-tier then behaves exactly as if `officialNameExact` were off.
+ * Among `ids` (already known exact matches), the subset holding `text` as an
+ * official name (`names.official = 1`, the ingest bit).
+ *
+ * Same collate nocase semantics as {@link WOFSQLitePlaceLookup.#exactMatchIDs},
+ * so the two probes agree on what "equals the query" means.
+ * Fails soft on gazetteers built before the `official` column existed.
+ *
+ * The sub-tier then behaves exactly as if `officialNameExact` were off.
  */
 export declare function officialNameIDs<DB>(db: DatabaseClient<DB>, schemaName: string, ids: number[], text: string): Set<number>;
 //# sourceMappingURL=exact-match.d.ts.map

package/out/exact-match.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exact-match.d.ts","sourceRoot":"","sources":["../lib/exact-match.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAI9D;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAC/B,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,EACtB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EAAE,EACb,IAAI,EAAE,MAAM,GACV,GAAG,CAAC,MAAM,CAAC,CAoDb;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,EACjC,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,EACtB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EAAE,EACb,IAAI,EAAE,MAAM,GACV,GAAG,CAAC,MAAM,CAAC,CAsBb"}
+{"version":3,"file":"exact-match.d.ts","sourceRoot":"","sources":["../lib/exact-match.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAI9D;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAC/B,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,EACtB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EAAE,EACb,IAAI,EAAE,MAAM,GACV,GAAG,CAAC,MAAM,CAAC,CAsDb;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,EAAE,EACjC,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,EACtB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EAAE,EACb,IAAI,EAAE,MAAM,GACV,GAAG,CAAC,MAAM,CAAC,CAsBb"}