@mailwoman/corpus 10.0.0 → 10.1.0

package/out/us/adapters/usgov/hrsa-fqhc/adapter.d.ts

@@ -5,48 +5,54 @@
  *
  *   `usgov-hrsa-fqhc`: HRSA "Health Center Service Delivery Site Locations" CSV consumer.
  *
- *   Federally Qualified Health Centers (FQHCs) are HRSA-funded community health programs that
- *   self-report site addresses to the HRSA Data Warehouse. The published CSV (`data.hrsa.gov`)
- *   carries the site name, the postal-formatted street address, and the locality/region/postcode
- *   quad. The source earns its place on adversarial-value-per-row (#22): every facility name is a
- *   human-typed venue string and the addresses pass through enough hands to accumulate the
- *   abbreviation drift + suite designator chaos that pure gazetteer data does not.
+ *   Federally Qualified Health Centers (FQHCs) are HRSA-funded community health programs.
+ *   They self-report site addresses to the HRSA Data Warehouse. The published CSV (`data.hrsa.gov`)
+ *   includes the site name, postal-formatted street address, locality, region and postcode.
+ *   Each facility name is a human-typed venue string. Multiple people have edited each address.
+ *   That editing introduces abbreviation drift and suite designators absent from gazetteer data.
  *
  *   The adapter consumes a CSV file the operator pre-downloads. The HRSA data is published as a
  *   single national CSV (~10K rows), small enough that the operator can re-fetch on every corpus
  *   rebuild without an intermediate SQLite step. Column names below match the HRSA Data Warehouse's
  *   "Health Center Service Delivery Site" public dataset. Operators substituting the
- *   closely-related "Site Address" or "Health Center" public extracts may need to remap columns;
- *   the README documents the expected set.
+ *   closely-related "Site Address" or "Health Center" public extracts may need to remap columns.
+ *   the readme documents the expected set.
  *
  *   Output: one row per CSV record, with `venue` component carrying the site name and the address
  *   quad on `(house_number, street, locality, region, postcode)`. Component order is critical:
- *   `venue` is inserted FIRST so alignment claims its surface span before `locality` searches for
+ *   `venue` is inserted first so alignment claims its surface span before `locality` searches for
  *   its own (the kryptonite case "Buffalo Health Clinic, …, Buffalo, NY" relies on `venue`
  *   consuming the first "Buffalo" so locality lands on the second).
  *
  *   License: stamped `"Public Domain"` per the HRSA Data Warehouse's federal government distribution
  *   terms.
  */
-import type { CorpusAdapter } from "#types";
+import { type CorpusAdapter } from "#types";
 /**
- * Registry id for this adapter. Stamped into every row it emits, so a corpus record can be traced back to the dataset
- * it came from.
+ * Registry id for this adapter.
+ *
+ * Stamped into every row it emits, so a corpus record can be traced back to the dataset it came from.
  */
 export declare const USGOV_HRSA_FQHC_ADAPTER_ID = "usgov-hrsa-fqhc";
 /**
- * License carried by this source (Public Domain), attached to each row so downstream consumers inherit the terms rather
- * than having to look them up.
+ * License assigned by this source (Public Domain), attached to each row so downstream
+ * consumers inherit the terms rather than having to look them up.
  */
 export declare const USGOV_HRSA_FQHC_DEFAULT_LICENSE = "Public Domain";
 /**
- * Split a "123 Main St Suite 4" surface form into `(house_number, street)`. The regex tolerates one trailing letter on
- * the number (`"123A Main St"`) and a hyphenated form (`"40-12 Bell Blvd"`); anything else falls back to street-only.
+ * Split a "123 Main St Suite 4" surface form into `(house_number, street)`.
+ *
+ * The regex tolerates one trailing letter on the number (`"123A Main St"`)
+ * and a hyphenated form (`"40-12 Bell Blvd"`); anything else falls back to street-only.
+ *
+ * Suite / Apt / Unit designators stay on `street`.
+ * Mailwoman's `unit` component exists.
+ *
+ * The address formatter has no clean slot for it.
+ * HRSA addresses also keep the suite in the street column.
  *
- * Suite / Apt / Unit designators stay on `street` — Mailwoman's `unit` component exists but the address-formatter does
- * not have a clean slot for it, and HRSA addresses do not separate the suite into its own column. Leaving the surface
- * form intact in `street` preserves the adversarial training signal (the model learns that a trailing "Suite 4" is part
- * of the road line in this distribution).
+ * The intact surface form in `street` keeps the adversarial training signal
+ * (the model learns that a trailing "Suite 4" is part of the road line in this distribution).
  */
 export declare function createUSGovHRSAFQHCAdapter(): CorpusAdapter;
 /**

package/out/us/adapters/usgov/hrsa-fqhc/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../../lib/us/adapters/usgov/hrsa-fqhc/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAMH,OAAO,KAAK,EAAgC,aAAa,EAAE,MAAM,QAAQ,CAAA;AAGzE;;;GAGG;AACH,eAAO,MAAM,0BAA0B,oBAAoB,CAAA;AAC3D;;;GAGG;AACH,eAAO,MAAM,+BAA+B,kBAAkB,CAAA;AAmB9D;;;;;;;;GAQG;AAEH,wBAAgB,0BAA0B,IAAI,aAAa,CA0E1D;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,eAA+B,CAAA"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../../lib/us/adapters/usgov/hrsa-fqhc/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAQH,OAAO,EAAuD,KAAK,aAAa,EAAiB,MAAM,QAAQ,CAAA;AAG/G;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,oBAAoB,CAAA;AAC3D;;;GAGG;AACH,eAAO,MAAM,+BAA+B,kBAAkB,CAAA;AAuB9D;;;;;;;;;;;;;;GAcG;AAEH,wBAAgB,0BAA0B,IAAI,aAAa,CA6E1D;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,eAA+B,CAAA"}

package/out/us/adapters/usgov/hrsa-fqhc/adapter.js

@@ -5,56 +5,68 @@
  *
  *   `usgov-hrsa-fqhc`: HRSA "Health Center Service Delivery Site Locations" CSV consumer.
  *
- *   Federally Qualified Health Centers (FQHCs) are HRSA-funded community health programs that
- *   self-report site addresses to the HRSA Data Warehouse. The published CSV (`data.hrsa.gov`)
- *   carries the site name, the postal-formatted street address, and the locality/region/postcode
- *   quad. The source earns its place on adversarial-value-per-row (#22): every facility name is a
- *   human-typed venue string and the addresses pass through enough hands to accumulate the
- *   abbreviation drift + suite designator chaos that pure gazetteer data does not.
+ *   Federally Qualified Health Centers (FQHCs) are HRSA-funded community health programs.
+ *   They self-report site addresses to the HRSA Data Warehouse. The published CSV (`data.hrsa.gov`)
+ *   includes the site name, postal-formatted street address, locality, region and postcode.
+ *   Each facility name is a human-typed venue string. Multiple people have edited each address.
+ *   That editing introduces abbreviation drift and suite designators absent from gazetteer data.
  *
  *   The adapter consumes a CSV file the operator pre-downloads. The HRSA data is published as a
  *   single national CSV (~10K rows), small enough that the operator can re-fetch on every corpus
  *   rebuild without an intermediate SQLite step. Column names below match the HRSA Data Warehouse's
  *   "Health Center Service Delivery Site" public dataset. Operators substituting the
- *   closely-related "Site Address" or "Health Center" public extracts may need to remap columns;
- *   the README documents the expected set.
+ *   closely-related "Site Address" or "Health Center" public extracts may need to remap columns.
+ *   the readme documents the expected set.
  *
  *   Output: one row per CSV record, with `venue` component carrying the site name and the address
  *   quad on `(house_number, street, locality, region, postcode)`. Component order is critical:
- *   `venue` is inserted FIRST so alignment claims its surface span before `locality` searches for
+ *   `venue` is inserted first so alignment claims its surface span before `locality` searches for
  *   its own (the kryptonite case "Buffalo Health Clinic, …, Buffalo, NY" relies on `venue`
  *   consuming the first "Buffalo" so locality lands on the second).
  *
  *   License: stamped `"Public Domain"` per the HRSA Data Warehouse's federal government distribution
  *   terms.
  */
-import { formatAddressRow } from "@mailwoman/codex/address-format";
+import { formatAddressRow } from "@mailwoman/codex/address/format";
 import { CSVSpliterator } from "spliterator";
-import { splitStreetLine, stableSourceID } from "#adapters/utils";
+import { stableSourceID } from "#adapters/source-id";
+import { splitStreetLine } from "#adapters/street-line";
+import { SourceRegister } from "#registers";
+import { AddressRole, SurfaceOrigin } from "#types";
 import { lookupStateAbbreviation } from "#us/fips-state";
 /**
- * Registry id for this adapter. Stamped into every row it emits, so a corpus record can be traced back to the dataset
- * it came from.
+ * Registry id for this adapter.
+ *
+ * Stamped into every row it emits, so a corpus record can be traced back to the dataset it came from.
  */
 export const USGOV_HRSA_FQHC_ADAPTER_ID = "usgov-hrsa-fqhc";
 /**
- * License carried by this source (Public Domain), attached to each row so downstream consumers inherit the terms rather
- * than having to look them up.
+ * License assigned by this source (Public Domain), attached to each row so downstream
+ * consumers inherit the terms rather than having to look them up.
  */
 export const USGOV_HRSA_FQHC_DEFAULT_LICENSE = "Public Domain";
 /**
- * Split a "123 Main St Suite 4" surface form into `(house_number, street)`. The regex tolerates one trailing letter on
- * the number (`"123A Main St"`) and a hyphenated form (`"40-12 Bell Blvd"`); anything else falls back to street-only.
+ * Split a "123 Main St Suite 4" surface form into `(house_number, street)`.
+ *
+ * The regex tolerates one trailing letter on the number (`"123A Main St"`)
+ * and a hyphenated form (`"40-12 Bell Blvd"`); anything else falls back to street-only.
+ *
+ * Suite / Apt / Unit designators stay on `street`.
+ * Mailwoman's `unit` component exists.
+ *
+ * The address formatter has no clean slot for it.
+ * HRSA addresses also keep the suite in the street column.
  *
- * Suite / Apt / Unit designators stay on `street` — Mailwoman's `unit` component exists but the address-formatter does
- * not have a clean slot for it, and HRSA addresses do not separate the suite into its own column. Leaving the surface
- * form intact in `street` preserves the adversarial training signal (the model learns that a trailing "Suite 4" is part
- * of the road line in this distribution).
+ * The intact surface form in `street` keeps the adversarial training signal
+ * (the model learns that a trailing "Suite 4" is part of the road line in this distribution).
  */
 export function createUSGovHRSAFQHCAdapter() {
     return {
         id: USGOV_HRSA_FQHC_ADAPTER_ID,
         defaultLicense: USGOV_HRSA_FQHC_DEFAULT_LICENSE,
+        addressRole: AddressRole.Facility,
+        register: SourceRegister.HRSAHealthCenters,
+        surface: SurfaceOrigin.Rendered,
         description: "HRSA Federally Qualified Health Center site locations (public-domain). Adversarial source: venue + address co-occurrence, hand-entered.",
         async *rows(opts) {
             if (opts.country && opts.country !== "US") {
@@ -69,19 +81,19 @@ export function createUSGovHRSAFQHCAdapter() {
                     break;
                 if (opts.limit !== undefined && emitted >= opts.limit)
                     break;
-                const venue = (record["Site Name"] ?? "").trim();
+                const venue = record["Site Name"] ?? "";
                 const split = splitStreetLine(record["Site Address"] ?? "");
-                const city = (record["Site City"] ?? "").trim();
-                const stateAbbr = (record["Site State Abbreviation"] ?? "").trim();
-                const postcode = (record["Site Postal Code"] ?? "").trim();
+                const city = record["Site City"] ?? "";
+                const stateAbbr = record["Site State Abbreviation"] ?? "";
+                const postcode = record["Site Postal Code"] ?? "";
                 if (!venue || !split || !city || !postcode)
                     continue;
                 const state = lookupStateAbbreviation(stateAbbr);
                 if (!state)
                     continue;
-                // Insertion order matters here. `venue` first so alignment claims its span
-                // (which may contain a token like "Buffalo") before `locality` runs its
-                // search — the kryptonite case `Buffalo Health Clinic, Buffalo NY`
+                // Insertion order matters here.
+                // `venue` first so alignment claims its span (which may contain a token like "Buffalo")
+                // before `locality` runs its search — the kryptonite case `Buffalo Health Clinic, Buffalo NY`
                 // otherwise mis-labels the venue's "Buffalo" as locality.
                 const components = {
                     venue,
@@ -95,7 +107,7 @@ export function createUSGovHRSAFQHCAdapter() {
                 if (!rendered)
                     continue;
                 const { raw, components: aligned } = rendered;
-                const siteID = (record["Site ID"] ?? "").trim();
+                const siteID = record["Site ID"] ?? "";
                 const sourceID = siteID
                     ? `${USGOV_HRSA_FQHC_ADAPTER_ID}-${siteID}`
                     : stableSourceID(USGOV_HRSA_FQHC_ADAPTER_ID, aligned);

package/out/us/adapters/usgov/hrsa-fqhc/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../../../lib/us/adapters/usgov/hrsa-fqhc/adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../../../lib/us/adapters/usgov/hrsa-fqhc/adapter.ts"],"names":[],"mappings":"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"}

package/out/us/adapters/usgov/imls-pls/adapter.d.ts

@@ -6,8 +6,8 @@
  *   `usgov-imls-pls`: IMLS Public Libraries Survey outlet CSV consumer.
  *
  *   The Institute of Museum and Library Services publishes an annual Public Libraries Survey with one
- *   row per library outlet (~17K rows). Each row carries the library name, street address, city,
- *   ZIP, county, and geocoordinates.
+ *   row per library outlet (~17K rows). Each row includes the library name, street address, city,
+ *   ZIP, county and geocoordinates.
  *
  *   The adapter consumes the outlet CSV the operator pre-downloads via `fetch-imls-pls.ts`. Column
  *   names match the IMLS PLS outlet file header.
@@ -17,15 +17,16 @@
  *
  *   License: stamped `"Public Domain"` per IMLS federal government distribution terms.
  */
-import type { CorpusAdapter } from "#types";
+import { type CorpusAdapter } from "#types";
 /**
- * Registry id for this adapter. Stamped into every row it emits, so a corpus record can be traced back to the dataset
- * it came from.
+ * Registry id for this adapter.
+ *
+ * Stamped into every row it emits, so a corpus record can be traced back to the dataset it came from.
  */
 export declare const USGOV_IMLS_PLS_ADAPTER_ID = "usgov-imls-pls";
 /**
- * License carried by this source (Public Domain), attached to each row so downstream consumers inherit the terms rather
- * than having to look them up.
+ * License assigned by this source (Public Domain), attached to each row so downstream
+ * consumers inherit the terms rather than having to look them up.
  */
 export declare const USGOV_IMLS_PLS_DEFAULT_LICENSE = "Public Domain";
 export declare function createUSGovIMLSPLSAdapter(): CorpusAdapter;

package/out/us/adapters/usgov/imls-pls/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../../lib/us/adapters/usgov/imls-pls/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,KAAK,EAAgC,aAAa,EAAE,MAAM,QAAQ,CAAA;AAGzE;;;GAGG;AACH,eAAO,MAAM,yBAAyB,mBAAmB,CAAA;AACzD;;;GAGG;AACH,eAAO,MAAM,8BAA8B,kBAAkB,CAAA;AAY7D,wBAAgB,yBAAyB,IAAI,aAAa,CAgFzD;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAA8B,CAAA"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../../lib/us/adapters/usgov/imls-pls/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,OAAO,EAAuD,KAAK,aAAa,EAAiB,MAAM,QAAQ,CAAA;AAG/G;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,mBAAmB,CAAA;AACzD;;;GAGG;AACH,eAAO,MAAM,8BAA8B,kBAAkB,CAAA;AAY7D,wBAAgB,yBAAyB,IAAI,aAAa,CAmFzD;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAA8B,CAAA"}

package/out/us/adapters/usgov/imls-pls/adapter.js

@@ -6,8 +6,8 @@
  *   `usgov-imls-pls`: IMLS Public Libraries Survey outlet CSV consumer.
  *
  *   The Institute of Museum and Library Services publishes an annual Public Libraries Survey with one
- *   row per library outlet (~17K rows). Each row carries the library name, street address, city,
- *   ZIP, county, and geocoordinates.
+ *   row per library outlet (~17K rows). Each row includes the library name, street address, city,
+ *   ZIP, county and geocoordinates.
  *
  *   The adapter consumes the outlet CSV the operator pre-downloads via `fetch-imls-pls.ts`. Column
  *   names match the IMLS PLS outlet file header.
@@ -17,24 +17,31 @@
  *
  *   License: stamped `"Public Domain"` per IMLS federal government distribution terms.
  */
-import { formatAddressRow } from "@mailwoman/codex/address-format";
+import { formatAddressRow } from "@mailwoman/codex/address/format";
 import { CSVSpliterator } from "spliterator";
-import { splitStreetLine, stableSourceID } from "#adapters/utils";
+import { stableSourceID } from "#adapters/source-id";
+import { splitStreetLine } from "#adapters/street-line";
+import { SourceRegister } from "#registers";
+import { AddressRole, SurfaceOrigin } from "#types";
 import { lookupStateAbbreviation } from "#us/fips-state";
 /**
- * Registry id for this adapter. Stamped into every row it emits, so a corpus record can be traced back to the dataset
- * it came from.
+ * Registry id for this adapter.
+ *
+ * Stamped into every row it emits, so a corpus record can be traced back to the dataset it came from.
  */
 export const USGOV_IMLS_PLS_ADAPTER_ID = "usgov-imls-pls";
 /**
- * License carried by this source (Public Domain), attached to each row so downstream consumers inherit the terms rather
- * than having to look them up.
+ * License assigned by this source (Public Domain), attached to each row so downstream
+ * consumers inherit the terms rather than having to look them up.
  */
 export const USGOV_IMLS_PLS_DEFAULT_LICENSE = "Public Domain";
 export function createUSGovIMLSPLSAdapter() {
     return {
         id: USGOV_IMLS_PLS_ADAPTER_ID,
         defaultLicense: USGOV_IMLS_PLS_DEFAULT_LICENSE,
+        addressRole: AddressRole.Facility,
+        register: SourceRegister.IMLSPublicLibraries,
+        surface: SurfaceOrigin.Rendered,
         description: "IMLS Public Libraries Survey — ~17K library outlets with venue+address (public-domain).",
         async *rows(opts) {
             if (opts.country && opts.country !== "US") {
@@ -49,11 +56,11 @@ export function createUSGovIMLSPLSAdapter() {
                     break;
                 if (opts.limit !== undefined && emitted >= opts.limit)
                     break;
-                const libName = (record.LIBNAME ?? "").trim();
-                const address = (record.ADDRESS ?? "").trim();
-                const city = (record.CITY ?? "").trim();
-                const zip = (record.ZIP ?? "").trim();
-                const stateAbbr = (record.STABR ?? "").trim();
+                const libName = record.LIBNAME ?? "";
+                const address = record.ADDRESS ?? "";
+                const city = record.CITY ?? "";
+                const zip = record.ZIP ?? "";
+                const stateAbbr = record.STABR ?? "";
                 if (!libName || !city || !zip)
                     continue;
                 const state = lookupStateAbbreviation(stateAbbr);
@@ -69,10 +76,10 @@ export function createUSGovIMLSPLSAdapter() {
                     locality: city,
                     region: state.abbreviation,
                     postcode: zip,
-                    // #552: no subregion — US postal addresses don't surface the county, so emitting
-                    // subregion creates a phantom component with no raw-span to align to, quarantining
-                    // ~21% of rows. The county is still available in the source CSV; it just isn't
-                    // a postal-surface component here.
+                    // No subregion: US postal addresses don't surface the county, so emitting subregion
+                    // creates a phantom component with no raw-span to align to, quarantining ~21% of rows.
+                    // The county is still available in the source CSV.
+                    // It is not a postal-surface component here.
                 };
                 const rendered = formatAddressRow(components, "US", { singleLine: true });
                 if (!rendered)
@@ -80,7 +87,7 @@ export function createUSGovIMLSPLSAdapter() {
                 const { raw, components: aligned } = rendered;
                 if (Object.keys(aligned).length <= 2)
                     continue;
-                const fscsKey = (record.FSCSKEY ?? "").trim();
+                const fscsKey = record.FSCSKEY ?? "";
                 const sourceID = fscsKey
                     ? `${USGOV_IMLS_PLS_ADAPTER_ID}-${fscsKey}`
                     : stableSourceID(USGOV_IMLS_PLS_ADAPTER_ID, aligned);

package/out/us/adapters/usgov/imls-pls/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../../../lib/us/adapters/usgov/imls-pls/adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../../../lib/us/adapters/usgov/imls-pls/adapter.ts"],"names":[],"mappings":"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"}

package/out/us/adapters/usgov/irs-bmf/adapter.d.ts

@@ -8,25 +8,26 @@
  *   The EO BMF is the IRS's authoritative registry of US tax-exempt organizations (charities,
  *   churches, foundations, ...), published as per-region CSVs at
  *   `https://www.irs.gov/charities-non-profits/exempt-organizations-business-master-file-extract-eo-bmf`
- *   (`eo1.csv`..`eo4.csv`, `eo_pr.csv`, `eo_xx.csv`). Each row carries an organization NAME plus
- *   its mailing address. It complements `usgov-nppes` with a DIFFERENT venue population
+ *   (`eo1.csv`..`eo4.csv`, `eo_pr.csv`, `eo_xx.csv`). Each row includes an organization name plus
+ *   its mailing address. It complements `usgov-nppes` with a different venue population
  *   (non-profits vs healthcare providers) and, notably, a high share of PO-box addresses — useful
  *   `po_box`-tag signal (a tag with historically low recall).
  *
- *   Output: one row per record with a usable city + postcode. NAME → `venue`; the street line becomes
- *   `po_box` when it's a PO-box, else `house_number` + `street`; CITY/STATE/ZIP fill the locality
- *   line. STATE is already a USPS abbreviation in the source. License: `"Public Domain"` (US
+ *   Output: one row per record with a usable city + postcode. name → `venue`; the street line becomes
+ *   `po_box` when it's a PO-box, else `house_number` + `street`; city/state/ZIP fill the locality
+ *   line. state is already a USPS abbreviation in the source. License: `"Public Domain"` (US
  *   federal).
  */
-import type { CorpusAdapter } from "#types";
+import { type CorpusAdapter } from "#types";
 /**
- * Registry id for this adapter. Stamped into every row it emits, so a corpus record can be traced back to the dataset
- * it came from.
+ * Registry id for this adapter.
+ *
+ * Stamped into every row it emits, so a corpus record can be traced back to the dataset it came from.
  */
 export declare const USGOV_IRS_BMF_ADAPTER_ID = "usgov-irs-bmf";
 /**
- * License carried by this source (Public Domain), attached to each row so downstream consumers inherit the terms rather
- * than having to look them up.
+ * License assigned by this source (Public Domain), attached to each row so downstream
+ * consumers inherit the terms rather than having to look them up.
  */
 export declare const USGOV_IRS_BMF_DEFAULT_LICENSE = "Public Domain";
 export declare function createUSGovIRSBMFAdapter(): CorpusAdapter;

package/out/us/adapters/usgov/irs-bmf/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../../lib/us/adapters/usgov/irs-bmf/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,KAAK,EAAgC,aAAa,EAAE,MAAM,QAAQ,CAAA;AAEzE;;;GAGG;AACH,eAAO,MAAM,wBAAwB,kBAAkB,CAAA;AACvD;;;GAGG;AACH,eAAO,MAAM,6BAA6B,kBAAkB,CAAA;AA+B5D,wBAAgB,wBAAwB,IAAI,aAAa,CAwExD;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,eAA6B,CAAA"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../../lib/us/adapters/usgov/irs-bmf/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAQH,OAAO,EAAuD,KAAK,aAAa,EAAiB,MAAM,QAAQ,CAAA;AAE/G;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,kBAAkB,CAAA;AACvD;;;GAGG;AACH,eAAO,MAAM,6BAA6B,kBAAkB,CAAA;AAkC5D,wBAAgB,wBAAwB,IAAI,aAAa,CA2ExD;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,eAA6B,CAAA"}

package/out/us/adapters/usgov/irs-bmf/adapter.js

@@ -8,39 +8,46 @@
  *   The EO BMF is the IRS's authoritative registry of US tax-exempt organizations (charities,
  *   churches, foundations, ...), published as per-region CSVs at
  *   `https://www.irs.gov/charities-non-profits/exempt-organizations-business-master-file-extract-eo-bmf`
- *   (`eo1.csv`..`eo4.csv`, `eo_pr.csv`, `eo_xx.csv`). Each row carries an organization NAME plus
- *   its mailing address. It complements `usgov-nppes` with a DIFFERENT venue population
+ *   (`eo1.csv`..`eo4.csv`, `eo_pr.csv`, `eo_xx.csv`). Each row includes an organization name plus
+ *   its mailing address. It complements `usgov-nppes` with a different venue population
  *   (non-profits vs healthcare providers) and, notably, a high share of PO-box addresses — useful
  *   `po_box`-tag signal (a tag with historically low recall).
  *
- *   Output: one row per record with a usable city + postcode. NAME → `venue`; the street line becomes
- *   `po_box` when it's a PO-box, else `house_number` + `street`; CITY/STATE/ZIP fill the locality
- *   line. STATE is already a USPS abbreviation in the source. License: `"Public Domain"` (US
+ *   Output: one row per record with a usable city + postcode. name → `venue`; the street line becomes
+ *   `po_box` when it's a PO-box, else `house_number` + `street`; city/state/ZIP fill the locality
+ *   line. state is already a USPS abbreviation in the source. License: `"Public Domain"` (US
  *   federal).
  */
-import { formatAddressRow } from "@mailwoman/codex/address-format";
+import { formatAddressRow } from "@mailwoman/codex/address/format";
 import { CSVSpliterator } from "spliterator";
-import { splitStreetLine, stableSourceID } from "#adapters/utils";
+import { stableSourceID } from "#adapters/source-id";
+import { splitStreetLine } from "#adapters/street-line";
+import { SourceRegister } from "#registers";
+import { AddressRole, SurfaceOrigin } from "#types";
 /**
- * Registry id for this adapter. Stamped into every row it emits, so a corpus record can be traced back to the dataset
- * it came from.
+ * Registry id for this adapter.
+ *
+ * Stamped into every row it emits, so a corpus record can be traced back to the dataset it came from.
  */
 export const USGOV_IRS_BMF_ADAPTER_ID = "usgov-irs-bmf";
 /**
- * License carried by this source (Public Domain), attached to each row so downstream consumers inherit the terms rather
- * than having to look them up.
+ * License assigned by this source (Public Domain), attached to each row so downstream
+ * consumers inherit the terms rather than having to look them up.
  */
 export const USGOV_IRS_BMF_DEFAULT_LICENSE = "Public Domain";
 /**
- * PO box in its many written forms: "PO BOX 12", "P.O. BOX 12", "P O BOX 12", "POB 12", "BOX 12".
+ * PO box in its many written forms: "PO BOX 12", "P.O.
+ *
+ * BOX 12", "P O BOX 12", "POB 12", "BOX 12".
  */
 const PO_BOX = /^\s*(?:P\.?\s?O\.?\s*BOX|POB|BOX)\s+\w/i;
 /**
  * Classify the street line into a `po_box` or a `{house_number?, street}` split.
  *
- * BMF mixes street addresses and PO boxes in one `STREET` column, so the PO-box shapes have to be claimed BEFORE the
- * shared house-number split runs — otherwise `splitStreetLine` would hand back `"PO Box 1234"` as a plain street, which
- * is correct for every other US adapter and wrong here.
+ * BMF mixes street addresses and PO boxes in one `street` column, so the PO-box shapes
+ * have to be claimed before the shared house-number split runs.
+ * Otherwise `splitStreetLine` would hand back `"PO Box 1234"` as a plain street.
+ * which is correct for every other US adapter and wrong here.
  */
 function splitStreetLineOrPOBox(street) {
     const trimmed = street.trim();
@@ -52,6 +59,9 @@ export function createUSGovIRSBMFAdapter() {
     return {
         id: USGOV_IRS_BMF_ADAPTER_ID,
         defaultLicense: USGOV_IRS_BMF_DEFAULT_LICENSE,
+        addressRole: AddressRole.Mailing,
+        register: SourceRegister.IRSBusinessMasterFile,
+        surface: SurfaceOrigin.Rendered,
         description: "IRS Exempt Organizations Business Master File — US non-profit venue+address (public-domain), with strong PO-box coverage.",
         async *rows(opts) {
             if (opts.country && opts.country !== "US") {
@@ -66,15 +76,15 @@ export function createUSGovIRSBMFAdapter() {
                     break;
                 if (opts.limit !== undefined && emitted >= opts.limit)
                     break;
-                const ein = (record.EIN ?? "").trim();
-                const venue = (record.NAME ?? "").trim() || undefined;
-                const street = (record.STREET ?? "").trim();
-                const city = (record.CITY ?? "").trim();
-                const state = (record.STATE ?? "").trim();
-                const zipRaw = (record.ZIP ?? "").trim();
+                const ein = record.EIN ?? "";
+                const venue = (record.NAME ?? "") || undefined;
+                const street = record.STREET ?? "";
+                const city = record.CITY ?? "";
+                const state = record.STATE ?? "";
+                const zipRaw = record.ZIP ?? "";
                 if (!city || !zipRaw)
                     continue;
-                const postcode = zipRaw.split("-")[0].trim(); // 5-digit; drop the optional +4
+                const postcode = zipRaw.split("-")[0].trim(); // 5-digit. drop the optional +4
                 const split = splitStreetLineOrPOBox(street);
                 if (!split)
                     continue;

package/out/us/adapters/usgov/irs-bmf/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../../../lib/us/adapters/usgov/irs-bmf/adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../../../lib/us/adapters/usgov/irs-bmf/adapter.ts"],"names":[],"mappings":"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"}

package/out/us/adapters/usgov/nad/adapter.d.ts

@@ -3,46 +3,26 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   `usgov-nad`: US DOT National Address Database — ~97M structured address-point records.
- *
- *   The single largest US address source available — federal aggregation of state + local 911-grade
- *   address points (every addressable location). Compared to TIGER ADDRFEAT (~20M segment-level, no
- *   city/locality) and NPPES (~7M provider-centric venues), NAD covers the entire residential +
- *   commercial address space with full structured components.
- *
- *   The adapter consumes NDJSON slices produced by `fetch-nad.ts`'s featureserver mode (operator
- *   pre-downloads via `mailwoman corpus fetch nad`). Each slice is per-OID-range
- *   `oids_<start>-<end>.ndjson` with a sibling `.manifest.json`. Adapter iterates every `.ndjson`
- *   in the input directory, skipping the `quarantined-bash-bug/` subdir (legacy of the bash-
- *   fetcher's silent-page-failure bug).
- *
- *   Field mapping (NAD v9 → CanonicalRow components):
- *
- *   - House_number: `AddNo_Full` (pre-composed); falls back to AddNum_Pre + Add_Number + AddNum_Suf
- *   - Street: `StNam_Full` (pre-composed); falls back to St_PreDir + St_PreTyp + St_Name + St_PosTyp
- *
- *       - St_PosDir + St_PosMod composition
- *   - Locality: `Post_City` > `Inc_Muni` > `Census_Plc` > `Uninc_Comm` (first non-empty)
- *   - Region: `State` (2-char USPS code, including territories: PR, GU, VI, AS, MP)
- *   - Postcode: `Zip_Code` + `Plus_4` (joined as `XXXXX-NNNN` when both present)
- *   - Venue: `LandmkName` (typically a park, school, hospital, named facility — when present)
- *
- *   License: stamped `"Public Domain"` per 17 U.S.C. § 105 (US federal works).
+ *   Reads the US DOT National Address Database from a directory of NDJSON files written by the NAD fetcher.
  */
-import type { CorpusAdapter } from "#types";
+import { type CorpusAdapter } from "#types";
 /**
- * Registry id for this adapter. Stamped into every row it emits, so a corpus record can be traced back to the dataset
- * it came from.
+ * The adapter id stamped on every emitted row.
  */
 export declare const USGOV_NAD_ADAPTER_ID = "usgov-nad";
 /**
- * License carried by this source (Public Domain), attached to each row so downstream consumers inherit the terms rather
- * than having to look them up.
+ * The license label on every emitted row, because US federal works are public domain under 17 U.S.C. § 105.
  */
 export declare const USGOV_NAD_DEFAULT_LICENSE = "Public Domain";
+/**
+ * Creates the NAD adapter.
+ *
+ * The adapter skips records without a US state code, locality, or ZIP code.
+ * It also skips rows whose rendering keeps two or fewer components.
+ */
 export declare function createUsgovNADAdapter(): CorpusAdapter;
 /**
- * The configured adapter instance registered with the corpus builder.
+ * The NAD adapter instance that the corpus builder registers.
  */
 export declare const usgovNADAdapter: CorpusAdapter;
 //# sourceMappingURL=adapter.d.ts.map

package/out/us/adapters/usgov/nad/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../../lib/us/adapters/usgov/nad/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AASH,OAAO,KAAK,EAAgC,aAAa,EAAE,MAAM,QAAQ,CAAA;AAEzE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,cAAc,CAAA;AAC/C;;;GAGG;AACH,eAAO,MAAM,yBAAyB,kBAAkB,CAAA;AA8KxD,wBAAgB,qBAAqB,IAAI,aAAa,CA8FrD;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,eAA0B,CAAA"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../../lib/us/adapters/usgov/nad/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,OAAO,EAAuD,KAAK,aAAa,EAAiB,MAAM,QAAQ,CAAA;AAE/G;;GAEG;AACH,eAAO,MAAM,oBAAoB,cAAc,CAAA;AAC/C;;GAEG;AACH,eAAO,MAAM,yBAAyB,kBAAkB,CAAA;AAiIxD;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,aAAa,CAgGrD;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,eAA0B,CAAA"}