@mailwoman/resolver-wof-sqlite 9.4.0 → 10.1.0

package/out/types.d.ts

@@ -2,237 +2,168 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   Public surface for the WOF SQLite resolver — types only, no runtime.
- *
- *   These mirror the conceptual model described in `docs/plan/phases/PHASE_4_2_wof_sqlite.md`. Phase
- *   4.3 will extend `PlaceCandidate` with the resolver-decorated fields that flow into
- *   `AddressNode.source` / `sourceID` (e.g. an explicit `wofURI: "wof-admin:101751113"` form).
  */
+import type { LatLon, LatLonBounds } from "@mailwoman/spatial";
 /**
- * The placetype taxonomy used by Who's On First. Ordered roughly from coarsest (country) to finest (address). See
- * https://github.com/whosonfirst/whosonfirst-placetypes for the authoritative definitions of each.
- *
- * Phase 4.2 only emits the ones we actually look up; the union is open enough to extend later.
+ * Lists the Who's On First placetypes this resolver looks up, ordered roughly from coarsest to finest.
  */
 export type WOFPlacetype = "country" | "macroregion" | "region" | "macrocounty" | "county" | "localadmin" | "locality" | "borough" | "neighbourhood" | "microhood" | "postalcode" | "venue" | "campus" | "address";
 /**
- * One candidate match for a place lookup.
- *
- * `score` is the post-boost ranking number — higher is better, but the scale is implementation- defined. Callers should
- * treat it as ordinal, not absolute.
- *
- * `id` is the WOF place id. It's named generically (not `wof_id`) so the shape stays structurally compatible with
- * `@mailwoman/resolver`'s `ResolvedPlace` — `WOFSQLitePlaceLookup` satisfies the generic `ResolverBackend` contract
- * without an adapter shim.
- *
- * `distanceKm` is populated only when the query carried `near` (and the place has a centroid). Useful for downstream
- * UIs that want to show "X km from you" alongside the result.
+ * Describes one ranked match for a place lookup, with `id` as the WOF id
+ * so the shape satisfies `ResolvedPlace`.
  */
 export interface PlaceCandidate {
     id: number;
     name: string;
     placetype: WOFPlacetype;
     /**
-     * ISO 3166-1 alpha-2 country code.
+     * The ISO 3166-1 alpha-2 country code.
      */
     country: string;
     lat: number;
     lon: number;
+    /**
+     * The place's depth-1 ancestor id from the ancestors sidecar, absent when the
+     * artifact has no sidecar even for a place with a parent.
+     */
     parent_id?: number;
     score: number;
     distanceKm?: number;
     /**
-     * True when this candidate's name OR an alias EXACTLY equals the query (the exact-match tier from
-     * {@link RankingWeights.exactMatchTiering}). Surfaced so a downstream country re-rank (#369's postcode anchor in
-     * `resolveTree`) can pin the country without crossing the tier — see the `exactMatch` field on `@mailwoman/core`'s
-     * `ResolvedPlace`.
+     * Whether the candidate's name or an alias exactly equals the query, used by a
+     * later re-rank to stay within the exact-match tier.
      */
     exactMatch?: boolean;
     /**
-     * Combined prominence (population term + best proximity-bias term, same additive units) — populated by the FTS
-     * lookup; the exact-tier sort orders by THIS instead of raw population when the query carried proximity hints
-     * (`near`/`bias`).
+     * The population term plus the best proximity-bias term.
+     *
+     * The exact tier sorts by this value instead of population when the query has `near` or `bias`.
      */
     prominence?: number;
     /**
-     * Population from WOF's `wof:population` property. Only present when the candidate has it on record — WOF carries
-     * population for ~15% of localities (mostly larger ones). Absent does NOT mean zero, just unknown.
+     * The WOF `wof:population` value, absent when the population is unknown.
      */
     population?: number;
     /**
-     * REFERENTIAL likelihood in [0, 1] — `referentialFromPopulation(population)`, the named form of the prominence key
-     * this resolver has always ranked namesakes by (ROAD_TO_V9 §2, ratified 2026-08-06).
-     *
-     * It is a strictly-increasing function of {@link PlaceCandidate.population} below `REFERENTIAL_SATURATION_POPULATION`
-     * and constant above it, so ordering by it — via `compareReferential`, which restores the megacity order with a
-     * population tiebreak — is the SAME ORDER as ordering by population. That equivalence is the point: naming the
-     * ranking key costs nothing at the ranking.
-     *
-     * Absent when the candidate has no population on record, exactly as {@link PlaceCandidate.population} is.
+     * The referential likelihood in [0, 1], derived from {@link PlaceCandidate.population}
+     * and absent whenever it is.
      */
     referential?: number;
     /**
-     * STRICT encyclopedia-evidence importance in [0, 1], fan-out-guarded per #1497 — CARRIED, NEVER RANKED ON.
-     *
-     * RESERVED SLOT awaiting a strict-channel source: present only when a extract's `place_importance` table carries the
-     * split columns, and no shipped extract does — the FTS lookup's clauses emit NULL for everything today. `undefined`
-     * means either "no encyclopedia entry for this place" or "this gazetteer predates the split"; both are absence, and
-     * neither is 0. The BLENDED prior the ranking reads is {@link PlaceCandidate.importance}.
-     *
-     * Saint-Denis is why this is not a ranking key: the Seine-Saint-Denis suburb (pop 96,128) scores 0.1173 while the
-     * Aude hamlet (pop 418) scores 0.5683. Consumers that want to display salience read this; the ranking never does.
+     * The encyclopedia-evidence importance in [0, 1], used for display only and present only
+     * when the extract's `place_importance` table has the split columns.
      */
     encyclopedic?: number;
     /**
-     * BLENDED global toponym prior in [0, 1] (#28) — `candidate.importance` surfaced verbatim: the score source's legacy
-     * blended importance (encyclopedia-derived where the concordance matched, a population-derived proxy elsewhere).
-     * Emitted only by the candidate-table backend, and only when the artifact measured this place — absent is UNMEASURED,
-     * never zero. Consumed by `rankByImportance` (`resolver/toponym-prior.ts`) for the bare-toponym class. See
-     * `candidate-schema.ts` → `CandidateTable.importance` for why the blend, not the strict channel, is what ships.
+     * The blended toponym prior in [0, 1] that `rankByImportance` reads for bare toponyms,
+     * set only by the candidate-table backend.
      */
     importance?: number;
     /**
-     * Bounding box from WOF's `spr.{min,max}_{latitude,longitude}` columns. Coarse outline for the place — a city's bbox
-     * is the city's full extent, a postcode's is roughly the postcode polygon's envelope. Optional because not all
-     * callers ask for it; implementations are free to omit when the underlying schema lacks the columns.
+     * The bounding box from the WOF `spr` extent columns, omitted when the schema lacks them.
      */
-    bbox?: GeoBbox;
+    bbox?: LatLonBounds;
     /**
-     * Set by the coordinate-first path when the chosen locality and the sibling postcode's containing locality are
-     * geographically far apart — the postcode and the parsed city name disagree (a transposed / wrong-for-the-city
-     * postcode). The candidate is still returned (the name wins for the locality), but the flag lets callers lower
-     * confidence / surface the conflict rather than silently mislocate. A retrieval/BM25 geocoder can't raise this — it's
-     * the falsehood-detection differentiator.
+     * Set by the postcode path when the chosen locality is far from the postcode's own
+     * locality. the candidate is still returned so callers can lower their confidence.
      */
     mismatch?: boolean;
     /**
-     * Admin-containment stamp (#1717 stage 2) — TRI-STATE, mirroring `ResolvedPlace.containedByQualifier` in
-     * `@mailwoman/core`: `true` = the ancestors sidecar vouches this candidate sits under the query's
-     * {@link FindPlaceQuery.regionQualifier}; `false` = evaluated and not vouched for; absent = never evaluated (no
-     * qualifier on the query, or an artifact without the sidecar). Absence is required — the resolver walk reads it as
-     * `unavailable`, never as "not contained".
+     * Whether the ancestors sidecar places this candidate under the query's
+     * {@link FindPlaceQuery.regionQualifier}, with `false` meaning the check ran
+     * and an absent value meaning it did not.
      */
     containedByQualifier?: boolean;
     /**
-     * The #1882 exemption's firing mark (#1893), mirroring `ResolvedPlace.variantAliasExempted` in `@mailwoman/core`:
-     * present only when this candidate's row would have taken the cross-country alias penalty and the exemption prevented
-     * it. Emitted by the candidate-table backend alone — the WASM FTS lookup never runs the ranker, and its candidates
-     * omit the field (not evaluated, never "did not fire").
+     * Set when the variant exemption spared the candidate from the cross-country
+     * alias penalty, by the candidate-table backend only.
      */
     variantAliasExempted?: true;
 }
 /**
- * A WGS-84 lat/lon point. Used as a proximity hint for `FindPlaceQuery.near`.
- */
-export interface GeoPoint {
-    lat: number;
-    lon: number;
-}
-/**
- * A WGS-84 bounding box. Used as a hard filter via `FindPlaceQuery.bbox`.
- */
-export interface GeoBbox {
-    minLat: number;
-    maxLat: number;
-    minLon: number;
-    maxLon: number;
-}
-/**
- * Query against the resolver.
+ * Describes a place lookup.
  *
- * `text` is the only required field; everything else narrows the search. When `country` and `parentID` are both set,
- * `parentID` wins (it's more specific).
- *
- * `near` and `bbox` are independent. `near` is a soft signal — candidates close to the point get a ranking boost but
- * distant candidates aren't dropped. `bbox` is a hard filter — only candidates whose bbox intersects the query bbox are
- * returned (uses the package-built R*Tree index when present; if the index is missing the option is silently ignored to
- * preserve backwards compatibility).
- *
- * `near` may carry `maxDistanceKm` to escalate from a boost to a hard filter — candidates further than that distance
- * from the point are dropped at the SQL level via an R*Tree pre-filter.
+ * Every field except `text` narrows or ranks the search.
+ * An extract without the R*Tree index ignores `bbox` and `near.maxDistanceKm` without an error.
  */
 export interface FindPlaceQuery {
     text: string;
     placetype?: WOFPlacetype | WOFPlacetype[];
     /**
-     * ISO 3166-1 alpha-2 — narrows to one country.
+     * Restricts matches to one ISO 3166-1 alpha-2 country.
      */
     country?: string;
     /**
-     * ISO 3166-1 alpha-2 — narrows the TYPO-FUZZY tier only (#1585). Exact and qualifier-strip probes stay worldwide (a
-     * locale hint is a prior, never a hard filter on exact matches), but a typo CORRECTION into a different country's
-     * namespace is nearly always a scrape, so the corrected-key probes honor this scope and a scoped-empty ABSTAINS
-     * rather than falling through to a world-fuzzy candidate. Ignored when `country` is set (already narrower).
+     * Restricts the typo-fuzzy tier to one ISO 3166-1 alpha-2 country, returning no
+     * result on a miss rather than falling back worldwide.
+     * Ignored when `country` is set.
      */
     fuzzyCountry?: string;
     /**
-     * Restrict name matching to PRIMARY-keyed rows (#1632) — set by probes whose surface is a RE-READING (a token taken
-     * out of a longer classified span), which never named an alias. See the ResolverBackend contract in
-     * `@mailwoman/core/resolver`.
+     * Whether to match only primary names, set by probes that re-read a token from
+     * a longer span because that token was never an alias.
      */
     primaryOnly?: boolean;
     /**
-     * Alias-row NAME ROLES the probe refuses to answer through (#1730) — the bare-toponym side races pass `abbr`/`gloss`.
-     * Role-NULL alias rows (the exonym tier) stay open; backends/artifacts without a role column ignore it.
+     * Alias name roles, such as `abbr` or `gloss`, that the probe excludes.
+     *
+     * Rows with no role and artifacts without a role column are unaffected.
      */
     excludeNameRoles?: readonly string[];
     /**
-     * WOF place id — narrows to descendants of this place.
+     * Restricts matches to descendants of this WOF place id.
      */
     parentID?: number;
     /**
-     * Sibling postcode. When set on a `locality` query AND a `postcode_locality` table is present, triggers the
-     * coordinate-first soft-score path: postcode→candidate localities are injected and scored `0.6·S_pc + 0.3·S_name +
-     * 0.1·S_pop` against the FTS name-match set, recovering small localities the name-match alone misses. Ignored when no
-     * postcode_locality extract is present.
+     * The sibling postcode for a `locality` query.
+     *
+     * A `postcode_locality` table adds that postcode's localities and scores them on a
+     * weighted blend so small localities a name match misses are found.
      */
     postcode?: string;
     /**
-     * Postcode-containment coherence (#31, Mechanism 2) — when true on a locality query that also carries `postcode`,
-     * candidate rows within `POSTCODE_CONTAINMENT_THRESHOLD_KM` of the postcode's own centroid sort by distance first,
-     * the rest appended in their original order. Set by the resolver from `ResolveOpts.postcodeContainmentCoherence`;
-     * absent → the population-first order is untouched (byte-identical).
+     * Whether a locality query with `postcode` moves candidates near the postcode's centroid
+     * to the front, sorted by distance, with the rest keeping their order.
      */
     postcodeContainmentCoherence?: boolean;
     /**
-     * The tree's parsed REGION qualifier (#1717 stage 2) — set by the resolver on locality lookups when
-     * `ResolveOpts.adminContainmentRerank` is on. See the `ResolverBackend` contract in `@mailwoman/core/resolver`: a
-     * capable backend stamps `containedByQualifier`, ranks contained candidates first, and may ADD contained same-key
-     * candidates a country scope hid — additive only, never a filter. Ignored on an artifact without the ancestors
-     * sidecar (candidates then carry no stamp).
+     * The parsed region qualifier for a locality lookup.
+     *
+     * A backend with the ancestors sidecar marks contained candidates.
+     * It ranks them first.
+     *
+     * It may add candidates hidden by a country scope.
+     * It never removes candidates.
      */
     regionQualifier?: string;
     /**
-     * Proximity hint — candidates close to this point get a ranking boost.
+     * A proximity hint that boosts nearby candidates and filters by radius only when `maxDistanceKm` is set.
      */
-    near?: GeoPoint & {
+    near?: LatLon & {
         maxDistanceKm?: number;
     };
     /**
-     * Ordered proximity-bias points (viewport center, user location, …), each optionally weighted (default 1.0, first
-     * entry strongest by convention). SOFT — a re-rank signal, never a filter: with bias present, exact-tier candidates
-     * order by combined prominence (population + the best decayed-distance term over these points) instead of population
-     * alone, which is how an ambiguous bare postcode ("48026": Fraser MI vs Russi IT) follows the map view / the user.
-     * Absent (and no `near`) → ranking is byte-identical to today. `near` is treated as a weight-1.0 bias point for
-     * back-compat.
+     * Ordered proximity-bias points with an optional weight defaulting to 1.
+     *
+     * The bias re-ranks exact-tier candidates by combined prominence.
+     * It keeps every candidate.
+     * It counts `near` as weight 1.
      */
-    bias?: Array<GeoPoint & {
+    bias?: Array<LatLon & {
         weight?: number;
     }>;
     /**
-     * Bounding-box filter — only candidates whose bbox intersects this box are returned.
+     * Returns only candidates whose bounding box intersects this box.
      */
-    bbox?: GeoBbox;
+    bbox?: LatLonBounds;
     /**
-     * Default 10.
+     * The maximum number of candidates to return, defaulting to 10.
      */
     limit?: number;
 }
 /**
- * The pull-based lookup surface. Implementations resolve a `FindPlaceQuery` to a ranked list of `PlaceCandidate`s. The
- * interface is async even though `node:sqlite` is sync — leaves room for `Worker`-backed implementations later without
- * a public API break.
+ * Resolves a {@link FindPlaceQuery} to ranked {@link PlaceCandidate}s, asynchronously
+ * so a worker-backed implementation can share the interface.
  */
 export interface PlaceLookup extends Disposable {
     findPlace(query: FindPlaceQuery): Promise<PlaceCandidate[]>;

package/out/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../lib/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../lib/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAE9D;;GAEG;AACH,MAAM,MAAM,YAAY,GACrB,SAAS,GACT,aAAa,GACb,QAAQ,GACR,aAAa,GACb,QAAQ,GACR,YAAY,GACZ,UAAU,GACV,SAAS,GACT,eAAe,GACf,WAAW,GACX,YAAY,GACZ,OAAO,GACP,QAAQ,GACR,SAAS,CAAA;AAEZ;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,YAAY,CAAA;IAEvB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IAEX;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,YAAY,CAAA;IAEnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAE9B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,IAAI,CAAA;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,YAAY,GAAG,YAAY,EAAE,CAAA;IAEzC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IAErB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAEpC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;OAGG;IACH,4BAA4B,CAAC,EAAE,OAAO,CAAA;IAEtC;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAE1C;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAE1C;;OAEG;IACH,IAAI,CAAC,EAAE,YAAY,CAAA;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC9C,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;CAC3D"}

package/out/types.js

@@ -2,12 +2,6 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   Public surface for the WOF SQLite resolver — types only, no runtime.
- *
- *   These mirror the conceptual model described in `docs/plan/phases/PHASE_4_2_wof_sqlite.md`. Phase
- *   4.3 will extend `PlaceCandidate` with the resolver-decorated fields that flow into
- *   `AddressNode.source` / `sourceID` (e.g. an explicit `wofURI: "wof-admin:101751113"` form).
  */
 export {};
 //# sourceMappingURL=types.js.map

package/out/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../lib/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../lib/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/out/unified-schema.d.ts

@@ -3,23 +3,19 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   Schema for the unified WOF SQLite database we build from cloned WOF GeoJSON repos
- *   (`scripts/build-unified-wof.ts`). This is the CANONICAL gazetteer — we never use the
- *   off-the-shelf geocode.earth prebuilt dumps (they assign different WOF ids to the same place;
- *   see the `feedback-custom-wof-db-only` memory). The table/column names match the resolver's
- *   expectations (`lookup.ts`) so `WOFSQLitePlaceLookup` works unchanged, INCLUDING the `ancestors`
- *   table (which lookup.ts's parent-constraint subquery needs) — see `populateAncestors`. The
- *   `place_search` FTS5 + `place_bbox` R*Tree are built separately by `build-fts` (fts.ts).
+ * Schema for the unified WOF SQLite database built from cloned WOF GeoJSON repos
+ * (`scripts/build-unified-wof.ts`). The table and column names match the resolver's
+ * expectations (`lookup.ts`) so `WOFSQLitePlaceLookup` works unchanged. The `ancestors` table
+ * table is what lookup.ts's parent-constraint subquery reads (see `populateAncestors`).
+ * The `place_search` FTS5 and `place_bbox` R*Tree tables are built separately by `build-fts` (fts.ts).
  */
 import type { DatabaseClient } from "@mailwoman/sqlite/client";
 import type { WOFDatabase } from "#schema";
 export declare function createUnifiedSchema(db: DatabaseClient<WOFDatabase>): Promise<void>;
 /**
- * Populate the `ancestors` table by walking each place's `parent_id` chain in `spr` (transitive closure, including the
- * place itself). Idempotent: drops + rebuilds the table contents. Returns the row count. Run after `spr` is fully
- * ingested (build-unified-wof freeze phase) or standalone on an existing unified DB (`scripts/add-ancestors.ts`).
- * Sentinel/negative parent_ids and cycles terminate the walk. ~4 rows/place average; a transaction keeps the ~5M
- * inserts fast.
+ * Populate the `ancestors` table by walking each place's `parent_id` chain in `spr`
+ * to a transitive closure that includes the place itself.
+ * Run this after `spr` is fully ingested.
  */
 export declare function populateAncestors<DB>(db: DatabaseClient<DB>): number;
 export declare function createUnifiedIndexes(db: DatabaseClient<WOFDatabase>): Promise<void>;

package/out/unified-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unified-schema.d.ts","sourceRoot":"","sources":["../lib/unified-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA+ExF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,GAAG,MAAM,CA0CpE;AAED,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBzF"}
+{"version":3,"file":"unified-schema.d.ts","sourceRoot":"","sources":["../lib/unified-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAqFxF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,GAAG,MAAM,CAyCpE;AAED,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBzF"}

package/out/unified-schema.js

@@ -3,21 +3,20 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   Schema for the unified WOF SQLite database we build from cloned WOF GeoJSON repos
- *   (`scripts/build-unified-wof.ts`). This is the CANONICAL gazetteer — we never use the
- *   off-the-shelf geocode.earth prebuilt dumps (they assign different WOF ids to the same place;
- *   see the `feedback-custom-wof-db-only` memory). The table/column names match the resolver's
- *   expectations (`lookup.ts`) so `WOFSQLitePlaceLookup` works unchanged, INCLUDING the `ancestors`
- *   table (which lookup.ts's parent-constraint subquery needs) — see `populateAncestors`. The
- *   `place_search` FTS5 + `place_bbox` R*Tree are built separately by `build-fts` (fts.ts).
+ * Schema for the unified WOF SQLite database built from cloned WOF GeoJSON repos
+ * (`scripts/build-unified-wof.ts`). The table and column names match the resolver's
+ * expectations (`lookup.ts`) so `WOFSQLitePlaceLookup` works unchanged. The `ancestors` table
+ * table is what lookup.ts's parent-constraint subquery reads (see `populateAncestors`).
+ * The `place_search` FTS5 and `place_bbox` R*Tree tables are built separately by `build-fts` (fts.ts).
  */
 export async function createUnifiedSchema(db) {
-    // PRAGMAs stay raw — not Kysely-modelled, and these tune the bulk build.
+    // PRAGMAs run raw because Kysely does not model them.
+    // They tune the bulk build.
     db.exec("PRAGMA journal_mode = WAL");
     db.exec("PRAGMA busy_timeout = 10000");
     db.exec("PRAGMA synchronous = OFF");
-    // `db` wraps `db` for the DDL (the house idiom); the caller owns `db`'s lifecycle, so we don't
-    // destroy it here. The bulk INSERTs (populateAncestors + build-unified-wof) stay on the raw handle.
+    // The caller owns `db`'s lifecycle, so this function does not destroy it.
+    // The bulk INSERTs (populateAncestors + build-unified-wof) run on the raw handle.
     await db.schema
         .createTable("spr")
         .ifNotExists()
@@ -39,12 +38,16 @@ export async function createUnifiedSchema(db) {
         .addColumn("is_superseding", "integer", (c) => c.notNull().defaultTo(0))
         .addColumn("lastmodified", "integer", (c) => c.notNull().defaultTo(0))
         .execute();
-    // `privateuse` carries WOF's x_<variant> kind (preferred | variant) / GeoNames' isPreferredName
-    // ("preferred" | ""). `official` is the #936 ingest bit: 1 when the row's language is an official
-    // language of the place's country (codex OFFICIAL_LANGUAGES) AND the row is a preferred form —
-    // x_variant rows tagged with an official language ("MSP", "Frisco") stay 0. Primary-name mirror
-    // rows stay 0 too: the name-exact tier already consults spr.name; `official` only marks the
-    // ALIASES eligible to join it. Both are ingest-time facts, never computed at query time.
+    // `privateuse` represents WOF's x_<variant> kind (preferred | variant) or GeoNames'
+    // isPreferredName ("preferred" | "").
+    // `official` is the ingest bit.
+    // It is 1 when the row's language is an official language of the place's country
+    // (codex OFFICIAL_LANGUAGES) and the row is a preferred form. x_variant rows
+    // tagged with an official language ("MSP", "Frisco") stay 0.
+    // Primary-name mirror rows stay 0 too.
+    // The name-exact tier already consults spr.name.
+    // `official` only marks the aliases eligible to join it.
+    // Both are ingest-time facts, never computed at query time.
     await db.schema
         .createTable("names")
         .ifNotExists()
@@ -71,11 +74,12 @@ export async function createUnifiedSchema(db) {
         .addColumn("id", "integer", (c) => c.primaryKey())
         .addColumn("population", "integer", (c) => c.notNull().defaultTo(0))
         .execute();
-    // `ancestors` maps each place to every place above it in the hierarchy (and itself). The
-    // resolver's parent-constraint scopes a child lookup to a parent's descendants via
-    // `spr.id IN (SELECT id FROM ancestors WHERE ancestor_id = ?)`. The off-the-shelf WOF dumps
-    // ship this table; our build derives it from the parent_id chain (see populateAncestors) since
-    // we don't capture `wof:hierarchy`.
+    // `ancestors` maps each place to every place above it in the hierarchy (and itself).
+    // The resolver's parent-constraint scopes a child lookup to a parent's descendants
+    // via `spr.id IN (select id from ancestors where ancestor_id = ?)`.
+    // The off-the-shelf WOF dumps ship this table.
+    // Our build derives it from the parent_id chain (see populateAncestors)
+    // since we don't capture `wof:hierarchy`.
     await db.schema
         .createTable("ancestors")
         .ifNotExists()
@@ -86,11 +90,9 @@ export async function createUnifiedSchema(db) {
         .execute();
 }
 /**
- * Populate the `ancestors` table by walking each place's `parent_id` chain in `spr` (transitive closure, including the
- * place itself). Idempotent: drops + rebuilds the table contents. Returns the row count. Run after `spr` is fully
- * ingested (build-unified-wof freeze phase) or standalone on an existing unified DB (`scripts/add-ancestors.ts`).
- * Sentinel/negative parent_ids and cycles terminate the walk. ~4 rows/place average; a transaction keeps the ~5M
- * inserts fast.
+ * Populate the `ancestors` table by walking each place's `parent_id` chain in `spr`
+ * to a transitive closure that includes the place itself.
+ * Run this after `spr` is fully ingested.
  */
 export function populateAncestors(db) {
     db.exec("DELETE FROM ancestors");
@@ -104,7 +106,6 @@ export function populateAncestors(db) {
     let count = 0;
     for (const r of rows) {
         insert.run(r.id, r.id, r.placetype);
-        // self
         count++;
         const seen = new Set([r.id]);
         let cur = r.parent_id;
@@ -139,8 +140,7 @@ export async function createUnifiedIndexes(db) {
         .on("concordances")
         .columns(["other_source", "other_id"])
         .execute();
-    // ancestor_id is the hot column (parent-constraint queries `WHERE ancestor_id = ?`); id supports
-    // the reverse lookup.
+    // ancestor_id is the hot column for parent-constraint queries. id supports the reverse lookup.
     await db.schema.createIndex("ancestors_by_ancestor").ifNotExists().on("ancestors").column("ancestor_id").execute();
     await db.schema.createIndex("ancestors_by_id").ifNotExists().on("ancestors").column("id").execute();
 }

package/out/unified-schema.js.map

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

package/out/uprn/existence.d.ts

@@ -3,34 +3,41 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  * @file The consult `./lookup.ts`'s docstring instructs: "callers building negative evidence must consult
- *   `readLayerCoverage`, not this reader alone." A bare `null` from `nearestUPRN` is two different facts — no UPRN here,
- *   or nobody surveyed here — and this is the only place that separates them. It answers an {@link Exclusion} or `null`,
+ *   `readLayerCoverage`, not this reader by itself." A bare `null` from `nearestUPRN` is two different facts — no uprn here,
+ *   or an unsurveyed area — and this is the only place that separates them. It answers an {@link Exclusion} or `null`,
  *   so a caller cannot read an unsurveyed cell as an empty one by accident.
  *
- *   `radiusM` is a CALLER'S parameter with no default. There is no radius that is correct for both "which property is
- *   this coordinate" and "is this street built at all", and picking one here would bury that choice where nobody
+ *   `radiusM` is a caller'S parameter with no default. There is no radius that is correct for both "which property is
+ *   this coordinate" and "is this street built at all", and picking one here would bury that choice where reviewers
  *   reviewing an exclusion can see it.
  */
-import { type LayerContractHandle } from "@mailwoman/core/layers";
+import { type layerschemahandle } from "@mailwoman/core/layers";
 import { type Exclusion } from "@mailwoman/evidence";
 import type { UPRNLookup } from "#uprn/lookup";
 /**
- * The identity fold, on purpose: this probe keys on a COORDINATE, not a name, so there is no string folding for the
- * builder and the probe to disagree about. Passing the same identity as both `probeFold` and `layerFold` records that
- * the fold axis is not in play here, rather than silently omitting the check. It is not a stub.
+ * The identity fold, on purpose: this probe keys on a coordinate rather than a name,
+ * so there is no string folding for the builder and the probe to disagree about.
+ *
+ * The same identity in both `probeFold` and `layerFold` records that the fold axis
+ * is not in play here, rather than silently omitting the check.
+ * It is not a stub.
  */
 export declare const UPRN_EXISTENCE_FOLD: string;
 /**
- * The countries OS Open UPRN covers. Northern Ireland is outside the product, so a `null` there is unknown and must
- * never become evidence of absence; the country check is what keeps it out.
+ * The countries OS Open uprn covers.
+ *
+ * Northern Ireland is outside the product, so a `null` there is unknown
+ * and must never become evidence of absence.
+ * The country check is what keeps it out.
  */
 export declare const UPRN_COVERED_COUNTRIES: ReadonlySet<string>;
 export interface UPRNAbsenceInput {
     lookup: UPRNLookup;
     /**
-     * The same file the lookup reads; the layer contract tables live beside the points.
+     * The same file the lookup reads.
+     * The layer interface tables live beside the points.
      */
-    contractDB: LayerContractHandle;
+    schemadb: layerschemahandle;
     latitude: number;
     longitude: number;
     radiusM: number;
@@ -40,14 +47,18 @@ export interface UPRNAbsenceInput {
     country?: string;
 }
 /**
- * The coverage cell a coordinate falls in, derived from its stored res-9 cell exactly as the builder derives it — never
- * from the centroid, which lands in a different parent for a fraction of cells.
+ * The coverage cell a coordinate falls in, derived from its stored res-9 cell exactly
+ * as the builder derives it rather than from the centroid.
+ *
+ * The centroid lands in a different parent for a fraction of cells.
  */
 export declare function uprnCoverageCell(latitude: number, longitude: number): number;
 /**
- * An {@link Exclusion} when no UPRN lies within `radiusM` AND the layer's coverage licenses saying so; `null` on a hit
- * (presence is not this probe's business) and on every refusal (unsurveyed cell, `source_present` basis, a country the
- * product does not cover). Never throws on a refusal: the caller falls open to the ranking it already had.
+ * An {@link Exclusion} when no uprn lies within `radiusM` and the layer's coverage licenses
+ * saying so; `null` on a hit (presence is not this probe's business) and on every refusal
+ * (unsurveyed cell, `source_present` basis, a country the product does not cover).
+ *
+ * Never throws on a refusal: the caller falls open to the ranking it already had.
  */
 export declare function uprnAbsenceAt(input: UPRNAbsenceInput): Promise<Exclusion | null>;
 //# sourceMappingURL=existence.d.ts.map