@mailwoman/corpus 2.0.0

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

@@ -0,0 +1,147 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `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. Phase 1.6 §1.2 (#22) selects this source for its adversarial-value-per-row: 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.
+ *
+ *   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.
+ *
+ *   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 load-bearing:
+ *   `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 { parse as csvParse } from "csv-parse";
+import { createReadStream } from "node:fs";
+import { stableSourceId } from "../../adapter.js";
+import { lookupStateAbbreviation } from "../../codex/us-fips-state.js";
+import { reconcileComponents } from "../../format.js";
+export const USGOV_HRSA_FQHC_ADAPTER_ID = "usgov-hrsa-fqhc";
+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.
+ *
+ * Suite / Apt / Unit designators stay on `street` for Phase 1 — 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).
+ */
+const HOUSE_NUMBER_PREFIX = /^(\d+(?:-\d+)?[A-Za-z]?)\s+(.+)$/;
+function splitAddress(address) {
+    const trimmed = address.trim();
+    if (!trimmed)
+        return null;
+    const m = HOUSE_NUMBER_PREFIX.exec(trimmed);
+    if (m)
+        return { house_number: m[1], street: m[2].trim() };
+    return { street: trimmed };
+}
+/**
+ * Compose the raw envelope-style address line. Format:
+ *
+ * "<Site Name>, <house> <street>, <city>, <state> <postcode>"
+ *
+ * The site name leads (US conventional addressee-then-address ordering) so a downstream model sees
+ * the venue-prefix-then-address shape that HRSA users actually type into geocoders.
+ */
+function composeRaw(venue, house, street, city, state, postcode) {
+    const streetPart = [house, street].filter(Boolean).join(" ").trim();
+    const cityPart = [city.trim(), [state, postcode].filter(Boolean).join(" ").trim()].filter(Boolean).join(", ");
+    return [venue.trim(), streetPart, cityPart].filter(Boolean).join(", ");
+}
+export function createUsgovHrsaFqhcAdapter() {
+    return {
+        id: USGOV_HRSA_FQHC_ADAPTER_ID,
+        defaultLicense: USGOV_HRSA_FQHC_DEFAULT_LICENSE,
+        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") {
+                throw new Error(`usgov-hrsa-fqhc adapter: only US supported, got country=${opts.country}`);
+            }
+            const stream = createReadStream(opts.inputPath, { encoding: "utf8" });
+            const parser = stream.pipe(csvParse({
+                columns: true,
+                skip_empty_lines: true,
+                relax_quotes: true,
+                relax_column_count: true,
+            }));
+            let emitted = 0;
+            try {
+                for await (const record of parser) {
+                    if (opts.signal?.aborted)
+                        break;
+                    if (opts.limit !== undefined && emitted >= opts.limit)
+                        break;
+                    const venue = (record["Site Name"] ?? "").trim();
+                    const split = splitAddress(record["Site Address"] ?? "");
+                    const city = (record["Site City"] ?? "").trim();
+                    const stateAbbr = (record["Site State Abbreviation"] ?? "").trim();
+                    const postcode = (record["Site Postal Code"] ?? "").trim();
+                    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`
+                    // otherwise mis-labels the venue's "Buffalo" as locality.
+                    const components = {
+                        venue,
+                        ...(split.house_number ? { house_number: split.house_number } : {}),
+                        street: split.street,
+                        locality: city,
+                        region: state.abbreviation,
+                        postcode,
+                    };
+                    const raw = composeRaw(venue, split.house_number, split.street, city, state.abbreviation, postcode);
+                    if (!raw)
+                        continue;
+                    const aligned = reconcileComponents(components, raw);
+                    if (Object.keys(aligned).length === 0)
+                        continue;
+                    const siteId = (record["Site ID"] ?? "").trim();
+                    const sourceId = siteId
+                        ? `${USGOV_HRSA_FQHC_ADAPTER_ID}-${siteId}`
+                        : stableSourceId(USGOV_HRSA_FQHC_ADAPTER_ID, aligned);
+                    yield {
+                        raw,
+                        components: aligned,
+                        country: "US",
+                        locale: "en-US",
+                        source: USGOV_HRSA_FQHC_ADAPTER_ID,
+                        source_id: sourceId,
+                        corpus_version: "",
+                        license: USGOV_HRSA_FQHC_DEFAULT_LICENSE,
+                    };
+                    emitted++;
+                }
+            }
+            finally {
+                stream.destroy();
+            }
+        },
+    };
+}
+export const usgovHrsaFqhcAdapter = createUsgovHrsaFqhcAdapter();
+//# sourceMappingURL=adapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../../src/adapters/usgov-hrsa-fqhc/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAGrD,MAAM,CAAC,MAAM,0BAA0B,GAAG,iBAAiB,CAAA;AAC3D,MAAM,CAAC,MAAM,+BAA+B,GAAG,eAAe,CAAA;AAkB9D;;;;;;;;;;GAUG;AACH,MAAM,mBAAmB,GAAG,kCAAkC,CAAA;AAE9D,SAAS,YAAY,CAAC,OAAe;IACpC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;IAC9B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAA;IACzB,MAAM,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC3C,IAAI,CAAC;QAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,EAAE,CAAA;IAC1D,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;AAC3B,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,UAAU,CAClB,KAAa,EACb,KAAyB,EACzB,MAAc,EACd,IAAY,EACZ,KAAa,EACb,QAAgB;IAEhB,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;IACnE,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC7G,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACvE,CAAC;AAED,MAAM,UAAU,0BAA0B;IACzC,OAAO;QACN,EAAE,EAAE,0BAA0B;QAC9B,cAAc,EAAE,+BAA+B;QAC/C,WAAW,EACV,yIAAyI;QAE1I,KAAK,CAAC,CAAC,IAAI,CAAC,IAAoB;YAC/B,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBAC3C,MAAM,IAAI,KAAK,CAAC,2DAA2D,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;YAC3F,CAAC;YAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAA;YACrE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CACzB,QAAQ,CAAC;gBACR,OAAO,EAAE,IAAI;gBACb,gBAAgB,EAAE,IAAI;gBACtB,YAAY,EAAE,IAAI;gBAClB,kBAAkB,EAAE,IAAI;aACxB,CAAC,CACF,CAAA;YAED,IAAI,OAAO,GAAG,CAAC,CAAA;YACf,IAAI,CAAC;gBACJ,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,MAAoC,EAAE,CAAC;oBACjE,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO;wBAAE,MAAK;oBAC/B,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,IAAI,IAAI,CAAC,KAAK;wBAAE,MAAK;oBAE5D,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;oBAChD,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAA;oBACxD,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;oBAC/C,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,yBAAyB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;oBAClE,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;oBAE1D,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ;wBAAE,SAAQ;oBACpD,MAAM,KAAK,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAA;oBAChD,IAAI,CAAC,KAAK;wBAAE,SAAQ;oBAEpB,2EAA2E;oBAC3E,wEAAwE;oBACxE,mEAAmE;oBACnE,0DAA0D;oBAC1D,MAAM,UAAU,GAA+B;wBAC9C,KAAK;wBACL,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACnE,MAAM,EAAE,KAAK,CAAC,MAAM;wBACpB,QAAQ,EAAE,IAAI;wBACd,MAAM,EAAE,KAAK,CAAC,YAAY;wBAC1B,QAAQ;qBACR,CAAA;oBAED,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAA;oBACnG,IAAI,CAAC,GAAG;wBAAE,SAAQ;oBAElB,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAA;oBACpD,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC;wBAAE,SAAQ;oBAE/C,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;oBAC/C,MAAM,QAAQ,GAAG,MAAM;wBACtB,CAAC,CAAC,GAAG,0BAA0B,IAAI,MAAM,EAAE;wBAC3C,CAAC,CAAC,cAAc,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAA;oBAEtD,MAAM;wBACL,GAAG;wBACH,UAAU,EAAE,OAAO;wBACnB,OAAO,EAAE,IAAI;wBACb,MAAM,EAAE,OAAO;wBACf,MAAM,EAAE,0BAA0B;wBAClC,SAAS,EAAE,QAAQ;wBACnB,cAAc,EAAE,EAAE;wBAClB,OAAO,EAAE,+BAA+B;qBACxC,CAAA;oBACD,OAAO,EAAE,CAAA;gBACV,CAAC;YACF,CAAC;oBAAS,CAAC;gBACV,MAAM,CAAC,OAAO,EAAE,CAAA;YACjB,CAAC;QACF,CAAC;KACD,CAAA;AACF,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,0BAA0B,EAAE,CAAA"}

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

@@ -0,0 +1,25 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `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.
+ *
+ *   The adapter consumes the outlet CSV the operator pre-downloads via `fetch-imls-pls.sh`. Column
+ *   names match the IMLS PLS outlet file header.
+ *
+ *   Output: one row per outlet with `venue` (library name), `(house_number, street, locality,
+ *   subregion, postcode)`, and lat/lon preserved in `source_id` stability.
+ *
+ *   License: stamped `"Public Domain"` per IMLS federal government distribution terms.
+ */
+import type { CorpusAdapter } from "../../types.js";
+export declare const USGOV_IMLS_PLS_ADAPTER_ID = "usgov-imls-pls";
+export declare const USGOV_IMLS_PLS_DEFAULT_LICENSE = "Public Domain";
+export declare function createUsgovImlsPlsAdapter(): CorpusAdapter;
+export declare const usgovImlsPlsAdapter: CorpusAdapter;
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/usgov-imls-pls/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAOH,OAAO,KAAK,EAAgC,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEjF,eAAO,MAAM,yBAAyB,mBAAmB,CAAA;AACzD,eAAO,MAAM,8BAA8B,kBAAkB,CAAA;AAsB7D,wBAAgB,yBAAyB,IAAI,aAAa,CAsFzD;AAED,eAAO,MAAM,mBAAmB,eAA8B,CAAA"}

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

@@ -0,0 +1,118 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `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.
+ *
+ *   The adapter consumes the outlet CSV the operator pre-downloads via `fetch-imls-pls.sh`. Column
+ *   names match the IMLS PLS outlet file header.
+ *
+ *   Output: one row per outlet with `venue` (library name), `(house_number, street, locality,
+ *   subregion, postcode)`, and lat/lon preserved in `source_id` stability.
+ *
+ *   License: stamped `"Public Domain"` per IMLS federal government distribution terms.
+ */
+import { parse as csvParse } from "csv-parse";
+import { createReadStream } from "node:fs";
+import { stableSourceId } from "../../adapter.js";
+import { lookupStateAbbreviation } from "../../codex/us-fips-state.js";
+import { reconcileComponents } from "../../format.js";
+export const USGOV_IMLS_PLS_ADAPTER_ID = "usgov-imls-pls";
+export const USGOV_IMLS_PLS_DEFAULT_LICENSE = "Public Domain";
+const HOUSE_NUMBER_PREFIX = /^(\d+(?:-\d+)?[A-Za-z]?)\s+(.+)$/;
+function splitAddress(address) {
+    const trimmed = address.trim();
+    if (!trimmed)
+        return null;
+    const m = HOUSE_NUMBER_PREFIX.exec(trimmed);
+    if (m)
+        return { house_number: m[1], street: m[2].trim() };
+    return { street: trimmed };
+}
+export function createUsgovImlsPlsAdapter() {
+    return {
+        id: USGOV_IMLS_PLS_ADAPTER_ID,
+        defaultLicense: USGOV_IMLS_PLS_DEFAULT_LICENSE,
+        description: "IMLS Public Libraries Survey — ~17K library outlets with venue+address (public-domain).",
+        async *rows(opts) {
+            if (opts.country && opts.country !== "US") {
+                throw new Error(`usgov-imls-pls adapter: only US supported, got country=${opts.country}`);
+            }
+            const stream = createReadStream(opts.inputPath, { encoding: "utf8" });
+            const parser = stream.pipe(csvParse({
+                columns: true,
+                skip_empty_lines: true,
+                relax_quotes: true,
+                relax_column_count: true,
+            }));
+            let emitted = 0;
+            try {
+                for await (const record of parser) {
+                    if (opts.signal?.aborted)
+                        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 county = (record.CNTY ?? "").trim();
+                    if (!libName || !city || !zip)
+                        continue;
+                    const state = lookupStateAbbreviation(stateAbbr);
+                    if (!state)
+                        continue;
+                    const split = splitAddress(address);
+                    if (!split)
+                        continue;
+                    const components = {
+                        venue: libName,
+                        ...(split.house_number ? { house_number: split.house_number } : {}),
+                        street: split.street,
+                        locality: city,
+                        region: state.abbreviation,
+                        postcode: zip,
+                        ...(county ? { subregion: county } : {}),
+                    };
+                    const streetPart = [split.house_number, split.street].filter(Boolean).join(" ").trim();
+                    const raw = [
+                        libName,
+                        streetPart,
+                        [city, [stateAbbr, zip].filter(Boolean).join(" ")].filter(Boolean).join(", "),
+                    ]
+                        .filter(Boolean)
+                        .join(", ");
+                    const aligned = reconcileComponents(components, raw);
+                    if (Object.keys(aligned).length <= 2)
+                        continue;
+                    const fscsKey = (record.FSCSKEY ?? "").trim();
+                    const sourceId = fscsKey
+                        ? `${USGOV_IMLS_PLS_ADAPTER_ID}-${fscsKey}`
+                        : stableSourceId(USGOV_IMLS_PLS_ADAPTER_ID, aligned);
+                    yield {
+                        raw,
+                        components: aligned,
+                        country: "US",
+                        locale: "en-US",
+                        source: USGOV_IMLS_PLS_ADAPTER_ID,
+                        source_id: sourceId,
+                        corpus_version: "",
+                        license: USGOV_IMLS_PLS_DEFAULT_LICENSE,
+                    };
+                    emitted++;
+                }
+            }
+            finally {
+                stream.destroy();
+            }
+        },
+    };
+}
+export const usgovImlsPlsAdapter = createUsgovImlsPlsAdapter();
+//# sourceMappingURL=adapter.js.map

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

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

package/out/src/adapters/usgov-nad/adapter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @copyright Sister Software
+ * @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 shards produced by `fetch-nad.ts`'s featureserver mode (operator
+ *   pre-downloads via `npx tsx packages/corpus/scripts/fetch-nad.ts`). Each shard 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).
+ */
+import type { CorpusAdapter } from "../../types.js";
+export declare const USGOV_NAD_ADAPTER_ID = "usgov-nad";
+export declare const USGOV_NAD_DEFAULT_LICENSE = "Public Domain";
+export declare function createUsgovNadAdapter(): CorpusAdapter;
+export declare const usgovNadAdapter: CorpusAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/out/src/adapters/usgov-nad/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/usgov-nad/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAQH,OAAO,KAAK,EAAgC,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEjF,eAAO,MAAM,oBAAoB,cAAc,CAAA;AAC/C,eAAO,MAAM,yBAAyB,kBAAkB,CAAA;AA+JxD,wBAAgB,qBAAqB,IAAI,aAAa,CAuFrD;AAED,eAAO,MAAM,eAAe,eAA0B,CAAA"}

package/out/src/adapters/usgov-nad/adapter.js

@@ -0,0 +1,227 @@
+/**
+ * @copyright Sister Software
+ * @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 shards produced by `fetch-nad.ts`'s featureserver mode (operator
+ *   pre-downloads via `npx tsx packages/corpus/scripts/fetch-nad.ts`). Each shard 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).
+ */
+import { createReadStream } from "node:fs";
+import { readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { createInterface } from "node:readline";
+import { reconcileComponents } from "../../format.js";
+export const USGOV_NAD_ADAPTER_ID = "usgov-nad";
+export const USGOV_NAD_DEFAULT_LICENSE = "Public Domain";
+const US_STATES_SET = new Set([
+    "AL",
+    "AK",
+    "AZ",
+    "AR",
+    "CA",
+    "CO",
+    "CT",
+    "DE",
+    "DC",
+    "FL",
+    "GA",
+    "HI",
+    "ID",
+    "IL",
+    "IN",
+    "IA",
+    "KS",
+    "KY",
+    "LA",
+    "ME",
+    "MD",
+    "MA",
+    "MI",
+    "MN",
+    "MS",
+    "MO",
+    "MT",
+    "NE",
+    "NV",
+    "NH",
+    "NJ",
+    "NM",
+    "NY",
+    "NC",
+    "ND",
+    "OH",
+    "OK",
+    "OR",
+    "PA",
+    "RI",
+    "SC",
+    "SD",
+    "TN",
+    "TX",
+    "UT",
+    "VT",
+    "VA",
+    "WA",
+    "WV",
+    "WI",
+    "WY",
+    // Territories that ship in NAD
+    "PR",
+    "GU",
+    "VI",
+    "AS",
+    "MP",
+]);
+function nonEmpty(...values) {
+    for (const v of values) {
+        const trimmed = (v ?? "").toString().trim();
+        if (trimmed)
+            return trimmed;
+    }
+    return undefined;
+}
+function composeHouseNumber(r) {
+    const full = (r.AddNo_Full ?? "").toString().trim();
+    if (full)
+        return full;
+    const num = r.Add_Number == null ? "" : String(r.Add_Number).trim();
+    if (!num)
+        return undefined;
+    const pre = (r.AddNum_Pre ?? "").toString().trim();
+    const suf = (r.AddNum_Suf ?? "").toString().trim();
+    return [pre, num, suf].filter(Boolean).join(" ").trim() || undefined;
+}
+function composeStreet(r) {
+    const full = (r.StNam_Full ?? "").toString().trim();
+    if (full)
+        return full;
+    const parts = [r.St_PreMod, r.St_PreDir, r.St_PreTyp, r.St_PreSep, r.St_Name, r.St_PosTyp, r.St_PosDir, r.St_PosMod]
+        .map((p) => (p ?? "").toString().trim())
+        .filter(Boolean);
+    return parts.length ? parts.join(" ") : undefined;
+}
+function composeLocality(r) {
+    return nonEmpty(r.Post_City, r.Inc_Muni, r.Census_Plc, r.Uninc_Comm);
+}
+function composePostcode(r) {
+    const zip = (r.Zip_Code ?? "").toString().trim();
+    if (!zip)
+        return undefined;
+    const plus4 = (r.Plus_4 ?? "").toString().trim();
+    return plus4 ? `${zip}-${plus4}` : zip;
+}
+function composeRaw(parts) {
+    const streetLine = [parts.houseNumber, parts.street].filter(Boolean).join(" ").trim();
+    const tail = `${parts.locality}, ${parts.region} ${parts.postcode}`;
+    return [parts.venue, streetLine || undefined, tail].filter(Boolean).join(", ");
+}
+export function createUsgovNadAdapter() {
+    return {
+        id: USGOV_NAD_ADAPTER_ID,
+        defaultLicense: USGOV_NAD_DEFAULT_LICENSE,
+        description: "US DOT National Address Database — ~97M structured US address points (911-grade). Single largest US source.",
+        async *rows(opts) {
+            if (opts.country && opts.country !== "US") {
+                throw new Error(`usgov-nad adapter: only US supported, got country=${opts.country}`);
+            }
+            // inputPath is a directory of NDJSON shards (per fetch-nad.ts featureserver output).
+            // Single-file inputs (e.g. a bulk-extracted CSV) are not currently supported — the
+            // featureserver shard pattern is the primary distribution.
+            const entries = await readdir(opts.inputPath);
+            const shards = entries.filter((n) => n.endsWith(".ndjson")).sort();
+            let emitted = 0;
+            outer: for (const shard of shards) {
+                if (opts.signal?.aborted)
+                    break;
+                const stream = createReadStream(join(opts.inputPath, shard), { encoding: "utf8" });
+                const rl = createInterface({ input: stream, crlfDelay: Infinity });
+                try {
+                    for await (const line of rl) {
+                        if (opts.signal?.aborted)
+                            break outer;
+                        if (opts.limit !== undefined && emitted >= opts.limit)
+                            break outer;
+                        if (!line)
+                            continue;
+                        let record;
+                        try {
+                            record = JSON.parse(line);
+                        }
+                        catch {
+                            continue; // malformed line — skip silently
+                        }
+                        const state = (record.State ?? "").toString().trim().toUpperCase();
+                        if (!US_STATES_SET.has(state))
+                            continue;
+                        const locality = composeLocality(record);
+                        if (!locality)
+                            continue;
+                        const postcode = composePostcode(record);
+                        if (!postcode)
+                            continue;
+                        const street = composeStreet(record);
+                        const houseNumber = composeHouseNumber(record);
+                        const venue = nonEmpty(record.LandmkName);
+                        const components = {
+                            ...(venue ? { venue } : {}),
+                            ...(houseNumber ? { house_number: houseNumber } : {}),
+                            ...(street ? { street } : {}),
+                            locality,
+                            region: state,
+                            postcode,
+                        };
+                        const raw = composeRaw({ venue, houseNumber, street, locality, region: state, postcode });
+                        if (!raw)
+                            continue;
+                        const aligned = reconcileComponents(components, raw);
+                        if (Object.keys(aligned).length <= 2)
+                            continue;
+                        const sourceId = record.UUID
+                            ? `${USGOV_NAD_ADAPTER_ID}-${record.UUID}`
+                            : `${USGOV_NAD_ADAPTER_ID}-${record.OBJECTID ?? `${shard}:${emitted}`}`;
+                        yield {
+                            raw,
+                            components: aligned,
+                            country: "US",
+                            locale: "en-US",
+                            source: USGOV_NAD_ADAPTER_ID,
+                            source_id: sourceId,
+                            corpus_version: "",
+                            license: USGOV_NAD_DEFAULT_LICENSE,
+                        };
+                        emitted++;
+                    }
+                }
+                finally {
+                    rl.close();
+                    stream.destroy();
+                }
+            }
+        },
+    };
+}
+export const usgovNadAdapter = createUsgovNadAdapter();
+//# sourceMappingURL=adapter.js.map

package/out/src/adapters/usgov-nad/adapter.js.map

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

package/out/src/adapters/usgov-nppes/adapter.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `usgov-nppes`: CMS National Plan and Provider Enumeration System (NPI registry) CSV consumer.
+ *
+ *   NPPES is the authoritative US healthcare provider registry, published monthly by CMS. Each row
+ *   carries a provider's business practice location address together with their legal business name
+ *   or individual name. At ~7M rows it is the single largest venue+address signal source
+ *   available.
+ *
+ *   The adapter consumes the monthly full-replacement CSV (operator pre-downloads via
+ *   `fetch-nppes.sh`). Column names match the canonical NPPES "Full Replacement Monthly NPI File"
+ *   header published at `https://download.cms.gov/nppes/NPI_Files.html`.
+ *
+ *   Output: one row per CSV record where the practice location address is populated. Organization
+ *   rows carry `venue` from the legal business name; individual rows compose `attention` from
+ *   last+first name. Address quad goes on `(house_number, street, locality, region, postcode)`.
+ *
+ *   License: stamped `"Public Domain"` per CMS's federal government distribution terms.
+ */
+import type { CorpusAdapter } from "../../types.js";
+export declare const USGOV_NPPES_ADAPTER_ID = "usgov-nppes";
+export declare const USGOV_NPPES_DEFAULT_LICENSE = "Public Domain";
+export declare function createUsgovNppesAdapter(): CorpusAdapter;
+export declare const usgovNppesAdapter: CorpusAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/out/src/adapters/usgov-nppes/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/usgov-nppes/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAOH,OAAO,KAAK,EAAgC,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEjF,eAAO,MAAM,sBAAsB,gBAAgB,CAAA;AACnD,eAAO,MAAM,2BAA2B,kBAAkB,CAAA;AAsC1D,wBAAgB,uBAAuB,IAAI,aAAa,CAqFvD;AAED,eAAO,MAAM,iBAAiB,eAA4B,CAAA"}