@mailwoman/corpus 4.16.2 → 5.0.0

package/out/src/shard-recipes/street-affix.js

@@ -0,0 +1,408 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `street-affix` shard recipe — the US street-affix coverage shard (the v0-parity `street_prefix` /
+ *   `street_suffix` gap — both ~0% F1 in the #15 assessment, collapsed into `street`). Raises
+ *   PREVALENCE of affix-split streets with format diversity so the model learns to split "N Main
+ *   St" → street_prefix="N" + street="Main" + street_suffix="St", and (negative space) sharpens
+ *   `street` itself. Ported from scripts/build-street-affix-shard.mjs.
+ *
+ *   Reads REAL US OpenAddresses tuples and SPLITS the OA `street` field via the codex:
+ *   `matchLeadingDirectional` (USPS Pub-28 C1) for the prefix, `matchTrailingSuffix` (Pub-28 C2
+ *   street suffixes) for the suffix. OA streets nearly all carry a suffix; only ~10-20% carry a
+ *   directional, so we INJECT a directional prefix onto a fraction of prefix-less streets to give
+ *   `street_prefix` real signal. Each row varies surface form per affix — abbreviated ("N", "St")
+ *   vs expanded ("North", "Street") — and varies the layout (full address / bare / street-only /
+ *   venue-prefixed).
+ *
+ *   LEAKAGE-SAFE EVAL (`--golden`): held-out eval uses the VERMONT source only (the corpus
+ *   defaultHoldout), a different seed, and emits {raw, components} for per-locale-f1. Train uses
+ *   every NON-Vermont US source.
+ *
+ *   Multi-locale BALANCE (`--multilocale-count`, opts.multilocaleCount > 0): appends NO-affix
+ *   native-order rows (FR/DE/IT/NL) AFTER the US affix rows, riding the same source weight, purely
+ *   to keep the postcode-ORDER distribution multi-locale so a US-heavy affix shard doesn't dilute
+ *   FR/DE postcode (the v0.9.8 blemish).
+ */
+import { spawnSync } from "node:child_process";
+import { DirectionalAbbreviation, lookupDirectional, matchCase, matchLeadingDirectional, matchTrailingSuffix, renderDirectional, US_STREET_SUFFIX_PREFERRED_ABBR, } from "@mailwoman/codex/us";
+import { stableSourceID } from "../adapter.js";
+import { alignRow } from "../align.js";
+import { makeMulberry32 } from "./scaffold.js";
+const TRAIN_SOURCES = [
+    { zip: "/tmp/oa-cache/us__ca__berkeley.zip", csv: "us/ca/berkeley.csv", region: "CA" },
+    { zip: "/tmp/oa-cache/us__ca__marin.zip", csv: "us/ca/marin.csv", region: "CA" },
+    { zip: "/tmp/oa-cache/us__dc__statewide.zip", csv: "us/dc/statewide.csv", region: "DC" },
+    { zip: "/tmp/oa-cache/us__ia__statewide.zip", csv: "us/ia/statewide.csv", region: "IA" },
+    { zip: "/tmp/oa-cache/us__il__cook.zip", csv: "us/il/cook.csv", region: "IL" },
+    { zip: "/tmp/oa-cache/us__mt__statewide.zip", csv: "us/mt/statewide.csv", region: "MT" },
+    { zip: "/tmp/oa-cache/us__sd__statewide.zip", csv: "us/sd/statewide.csv", region: "SD" },
+];
+const EVAL_SOURCE = { zip: "/tmp/oa-cache/us__vt__statewide.zip", csv: "us/vt/statewide.csv", region: "VT" };
+const MULTILOCALE_SOURCES = [
+    { zip: "/tmp/oa-cache/de__sn__statewide.zip", csv: "de/sn/statewide.csv", iso2: "DE", region: "", order: "eu" },
+    { zip: "/tmp/oa-cache/fr__countrywide.zip", csv: "fr/countrywide.csv", iso2: "FR", region: "", order: "fr" },
+    { zip: "/tmp/oa-cache/it__countrywide.zip", csv: "it/countrywide.csv", iso2: "IT", region: "", order: "eu" },
+    { zip: "/tmp/oa-cache/nl__countrywide.zip", csv: "nl/countrywide.csv", iso2: "NL", region: "", order: "eu" },
+];
+const MULTILOCALE_EVAL_SOURCES = [
+    { zip: "/tmp/oa-cache/de__berlin.zip", csv: "de/berlin.csv", iso2: "DE", region: "", order: "eu" },
+];
+const DIRECTIONAL_ABBRS = Object.values(DirectionalAbbreviation); // ["N","E","S","W","NE","NW","SE","SW"]
+const INJECT_PREFIX_PROB = 0.3; // fraction of prefix-less streets that get a synthetic directional
+/** Minimal RFC-4180-ish splitter (handles quoted fields). */
+function splitCSV(line) {
+    const out = [];
+    let cur = "";
+    let inQ = false;
+    for (let i = 0; i < line.length; i++) {
+        const c = line[i];
+        if (inQ) {
+            if (c === '"') {
+                if (line[i + 1] === '"') {
+                    cur += '"';
+                    i++;
+                }
+                else
+                    inQ = false;
+            }
+            else
+                cur += c;
+        }
+        else if (c === '"')
+            inQ = true;
+        else if (c === ",") {
+            out.push(cur);
+            cur = "";
+        }
+        else
+            cur += c;
+    }
+    out.push(cur);
+    return out;
+}
+/** Stream real US tuples (number/street/city/postcode) out of a cached OA zip. */
+function readTuples(source) {
+    const r = spawnSync("unzip", ["-p", source.zip, source.csv], { maxBuffer: 1024 * 1024 * 1024, encoding: "buffer" });
+    if (r.status !== 0) {
+        console.error(`  WARN: unzip failed for ${source.zip} (status ${r.status})`);
+        return [];
+    }
+    const lines = r.stdout.toString("utf8").split(/\r?\n/);
+    if (lines.length < 2)
+        return [];
+    const header = splitCSV(lines[0]).map((h) => h.trim().toLowerCase());
+    const idx = (name) => header.indexOf(name);
+    const iNum = idx("number"), iStreet = idx("street"), iCity = idx("city"), iPost = idx("postcode");
+    const get = (cells, i) => (i >= 0 && i < cells.length ? (cells[i] ?? "").trim() : "");
+    const tuples = [];
+    const seen = new Set();
+    for (let li = 1; li < lines.length; li++) {
+        if (!lines[li])
+            continue;
+        const cells = splitCSV(lines[li]);
+        const street = get(cells, iStreet);
+        const locality = get(cells, iCity);
+        const house_number = get(cells, iNum);
+        if (!street || !locality || !house_number)
+            continue;
+        const key = `${house_number}|${street}|${locality}`.toLowerCase();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        tuples.push({ house_number, street, locality, region: source.region, postcode: get(cells, iPost) });
+    }
+    return tuples;
+}
+const title = (s) => s
+    .toLowerCase()
+    .split(/\s+/)
+    .map((w) => (w ? w.charAt(0).toUpperCase() + w.slice(1) : w))
+    .join(" ");
+const isSuffixOrDirectional = (word) => matchTrailingSuffix(word) !== null || matchLeadingDirectional(word) !== null;
+/**
+ * Split an OA street into { prefix?, name, suffix } using the codex. Requires a trailing suffix and a non-empty name
+ * that isn't itself an affix token. Returns null when the street has no usable suffix.
+ */
+function parseStreet(street) {
+    let words = street.trim().split(/\s+/);
+    if (words.length < 2)
+        return null;
+    let prefix = null;
+    // Leading directional — only if it leaves ≥2 words behind (room for a name + suffix).
+    const lead = matchLeadingDirectional(street);
+    if (lead && words.length > 2) {
+        prefix = { canonical: lead.canonical, abbreviation: lead.abbreviation };
+        words = words.slice(1);
+    }
+    // Trailing USPS suffix — only if it leaves ≥1 word for the name.
+    const trail = matchTrailingSuffix(words.join(" "));
+    if (!trail || words.length < 2)
+        return null;
+    const suffix = trail.canonical;
+    const name = words.slice(0, -1).join(" ");
+    if (!name || isSuffixOrDirectional(name))
+        return null;
+    return { prefix, name, suffix };
+}
+/**
+ * Render the affix-split street in random surface forms (abbrev vs expanded per affix), Title-cased.
+ */
+function renderStreet(random, parsed) {
+    const name = title(parsed.name);
+    const parts = [];
+    const components = { street: name };
+    // Prefix: natural (from parse) or injected onto a prefix-less street to boost street_prefix signal.
+    let prefix = parsed.prefix;
+    if (!prefix && random() < INJECT_PREFIX_PROB) {
+        const m = lookupDirectional(DIRECTIONAL_ABBRS[Math.floor(random() * DIRECTIONAL_ABBRS.length)]);
+        prefix = { canonical: m.directional, abbreviation: m.abbreviation };
+    }
+    if (prefix) {
+        const rendered = renderDirectional(prefix, random() < 0.5 ? "abbr" : "full", "Aa"); // "Aa" → Title-case
+        components.street_prefix = rendered;
+        parts.push(rendered);
+    }
+    parts.push(name);
+    // Suffix: abbreviated ("St") vs expanded ("Street"), Title-cased to match the name.
+    const full = title(parsed.suffix); // canonical is uppercase word → "Street"
+    const abbr = matchCase(US_STREET_SUFFIX_PREFERRED_ABBR[parsed.suffix], "Aa"); // "AVE" → "Ave"
+    const renderedSuffix = random() < 0.5 ? abbr : full;
+    components.street_suffix = renderedSuffix;
+    parts.push(renderedSuffix);
+    return { street: parts.join(" "), components };
+}
+/** Synthetic recipient/venue prefixes — the arena's "JOHN DOE, ACME INC, …" pattern. */
+const VENUES = ["John Doe", "Jane Smith", "Acme Inc", "Wayne Enterprises", "Maria Garcia", "Riverside Clinic"];
+const tail = (loc, reg, pc) => (pc ? `${loc}, ${reg} ${pc}` : `${loc}, ${reg}`);
+/**
+ * Embed the rendered street in a RANDOM layout so the model recognizes affixes wherever the street sits: full address,
+ * bare house+street, street-only (pure affix parse), or venue-prefixed.
+ */
+function renderRow(random, base, street, streetComponents) {
+    const hn = base.house_number, loc = base.locality, reg = base.region, pc = base.postcode;
+    const road = `${hn} ${street}`;
+    const withRoad = { house_number: hn, ...streetComponents };
+    const r = random();
+    if (r < 0.4)
+        return {
+            fmt: "full",
+            raw: `${road}, ${tail(loc, reg, pc)}`,
+            components: { ...withRoad, locality: loc, region: reg, ...(pc ? { postcode: pc } : {}) },
+        };
+    if (r < 0.65)
+        return { fmt: "bare", raw: road, components: withRoad };
+    if (r < 0.85)
+        return { fmt: "street-only", raw: street, components: { ...streetComponents } };
+    const v = VENUES[Math.floor(random() * VENUES.length)];
+    return {
+        fmt: "venue",
+        raw: `${v}, ${road}, ${tail(loc, reg, pc)}`,
+        components: { venue: v, ...withRoad, locality: loc, region: reg, ...(pc ? { postcode: pc } : {}) },
+    };
+}
+/**
+ * Capped reader for the multi-locale BALANCE sources. The FR/IT/NL countrywide extracts are GB-scale; reading the whole
+ * CSV blows V8's string limit, so cap the bytes with `head` (mirrors build-country-shard-balanced.mjs). Only keeps
+ * tuples that carry a POSTCODE.
+ */
+function readBalanceTuples(source, limit) {
+    const maxLines = Math.max(limit * 8, 20000) + 1;
+    const r = spawnSync("bash", ["-c", `unzip -p "${source.zip}" "${source.csv}" | head -n ${maxLines}`], {
+        maxBuffer: 1024 * 1024 * 1024,
+        encoding: "buffer",
+    });
+    if (r.status !== 0) {
+        console.error(`  WARN: unzip failed for ${source.zip} (status ${r.status})`);
+        return [];
+    }
+    const lines = r.stdout.toString("utf8").split(/\r?\n/);
+    if (lines.length < 2)
+        return [];
+    const header = splitCSV(lines[0]).map((h) => h.trim().toLowerCase());
+    const idx = (n) => header.indexOf(n);
+    const iNum = idx("number"), iStreet = idx("street"), iCity = idx("city"), iRegion = idx("region"), iPost = idx("postcode");
+    const get = (cells, i) => (i >= 0 && i < cells.length ? (cells[i] ?? "").trim() : "");
+    const tuples = [];
+    const seen = new Set();
+    for (let li = 1; li < lines.length && tuples.length < limit; li++) {
+        if (!lines[li])
+            continue;
+        const cells = splitCSV(lines[li]);
+        const street = get(cells, iStreet), locality = get(cells, iCity), house_number = get(cells, iNum), postcode = get(cells, iPost);
+        if (!street || !locality || !house_number || !postcode)
+            continue; // postcode is required for balance
+        const key = `${house_number}|${street}|${locality}`.toLowerCase();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        tuples.push({
+            house_number,
+            street,
+            locality,
+            region: get(cells, iRegion) || source.region,
+            postcode,
+            iso2: source.iso2,
+            order: source.order,
+        });
+    }
+    return tuples;
+}
+/**
+ * Render a non-US BALANCE row in native order — NO affix split, NO country token. `street` is the OA value verbatim.
+ * The sole job is to put a postcode in its native position so the shard doesn't pull the model US-ward.
+ */
+function renderBalanceRow(t) {
+    const { house_number: hn, street, locality: loc, postcode: pc, order } = t;
+    // region is intentionally omitted — it isn't rendered in `raw`, so labeling it would fail alignment.
+    const components = { house_number: hn, street, locality: loc, postcode: pc };
+    const raw = order === "fr"
+        ? `${hn} ${street}, ${pc} ${loc}` // French: number-street, postcode-city
+        : `${street} ${hn}, ${pc} ${loc}`;
+    // DE/IT/NL: street-number, postcode-city
+    return { raw, components };
+}
+export const streetAffixRecipe = {
+    name: "street-affix",
+    description: "US street-affix rows: OA streets split into street_prefix/street/street_suffix (+ multilocale balance)",
+    mode: "generate",
+    options: [
+        {
+            flag: "--multilocale-count <N>",
+            description: "Append N no-affix native-order balance rows (FR/DE/IT/NL). Default 0",
+        },
+    ],
+    async run(opts, write) {
+        // Legacy build-street-affix-shard.mjs seeded `mulberry32(opts.seed)`.
+        const random = makeMulberry32(opts.seed);
+        const count = opts.count ?? 50000;
+        const source = opts.sourceName ?? "synth-affix";
+        const multilocaleCount = opts.multilocaleCount ?? 0;
+        const sources = opts.golden ? [EVAL_SOURCE] : TRAIN_SOURCES;
+        const pool = [];
+        for (const s of sources) {
+            const t = readTuples(s);
+            console.error(`  ${s.csv}: ${t.length} unique tuples`);
+            for (const x of t)
+                pool.push(x);
+        }
+        if (pool.length === 0) {
+            throw new Error("No US tuples found — are the cached OA zips present in /tmp/oa-cache?");
+        }
+        let emitted = 0;
+        let skipped = 0;
+        let noAffix = 0;
+        let guard = 0;
+        const formatCounts = {};
+        const affixCounts = { prefix: 0, suffix: 0, both: 0 };
+        const N = pool.length;
+        while (emitted < count && guard++ < count * 10) {
+            const base = pool[Math.floor(random() * N)];
+            const parsed = parseStreet(base.street);
+            if (!parsed) {
+                noAffix++;
+                continue;
+            }
+            const { street, components: streetComponents } = renderStreet(random, parsed);
+            const { fmt, raw, components } = renderRow(random, base, street, streetComponents);
+            // Every affix surface form must survive verbatim in raw, else alignment can't label it.
+            const surfaces = [streetComponents.street_prefix, streetComponents.street, streetComponents.street_suffix].filter((s) => Boolean(s));
+            if (!surfaces.every((s) => raw.includes(s))) {
+                skipped++;
+                continue;
+            }
+            formatCounts[fmt] = (formatCounts[fmt] ?? 0) + 1;
+            const hasP = !!streetComponents.street_prefix;
+            if (hasP && streetComponents.street_suffix)
+                affixCounts.both++;
+            else if (hasP)
+                affixCounts.prefix++;
+            else
+                affixCounts.suffix++;
+            if (opts.golden) {
+                write(JSON.stringify({ raw, components, country: "US" }) + "\n");
+                emitted++;
+                continue;
+            }
+            const canonical = {
+                raw,
+                components,
+                country: "US",
+                locale: "en-US",
+                source,
+                source_id: stableSourceID(source, components),
+                corpus_version: "0.4.0",
+                license: "OpenAddresses US (non-VT) skeletons, street split via USPS Pub-28 C1/C2 (codex)",
+            };
+            const aligned = alignRow(canonical);
+            if (aligned.kind !== "labeled" || !aligned.row) {
+                skipped++;
+                continue;
+            }
+            write(JSON.stringify({ ...aligned.row, synth_method: "affix", synth_base_id: null }) + "\n");
+            emitted++;
+        }
+        // ── Multi-locale balance rows (--multilocale-count) ─────────────────────────────────────────────
+        // Appended AFTER the US affix rows so the US affix signal is unchanged (same `--count`), and the
+        // non-US rows ride the SAME source weight. Native-order postcodes, no affix labels.
+        let balanceEmitted = 0;
+        let balanceSkipped = 0;
+        const balanceISO = {};
+        if (multilocaleCount > 0) {
+            const mlSources = opts.golden ? MULTILOCALE_EVAL_SOURCES : MULTILOCALE_SOURCES;
+            const perSource = Math.ceil((multilocaleCount * 3) / mlSources.length); // over-read; balance locales
+            const mlPool = [];
+            for (const s of mlSources) {
+                const t = readBalanceTuples(s, perSource);
+                console.error(`  balance ${s.csv} (${s.iso2}): ${t.length} tuples`);
+                for (const x of t)
+                    mlPool.push(x);
+            }
+            const M = mlPool.length;
+            let mlGuard = 0;
+            while (M > 0 && balanceEmitted < multilocaleCount && mlGuard++ < multilocaleCount * 10) {
+                const t = mlPool[Math.floor(random() * M)];
+                const { raw, components } = renderBalanceRow(t);
+                // Every component surface must survive in raw, else alignment can't label it.
+                if (![components.street, components.locality, components.postcode].every((s) => !!s && raw.includes(s))) {
+                    balanceSkipped++;
+                    continue;
+                }
+                balanceISO[t.iso2] = (balanceISO[t.iso2] ?? 0) + 1;
+                const locale = `${t.iso2.toLowerCase()}-${t.iso2}`;
+                if (opts.golden) {
+                    write(JSON.stringify({ raw, components, country: t.iso2 }) + "\n");
+                    balanceEmitted++;
+                    continue;
+                }
+                const canonical = {
+                    raw,
+                    components,
+                    country: t.iso2,
+                    locale,
+                    source,
+                    source_id: stableSourceID(source, components),
+                    corpus_version: "0.4.0",
+                    license: "OpenAddresses non-US skeletons (native-order postcode balance for the affix shard)",
+                };
+                const aligned = alignRow(canonical);
+                if (aligned.kind !== "labeled" || !aligned.row) {
+                    balanceSkipped++;
+                    continue;
+                }
+                write(JSON.stringify({ ...aligned.row, synth_method: "affix-balance", synth_base_id: null }) + "\n");
+                balanceEmitted++;
+            }
+        }
+        console.error(`Done: emitted ${emitted} affix rows, skipped ${skipped}, no-affix ${noAffix} (pool ${pool.length}).\n` +
+            `  formats: ${JSON.stringify(formatCounts)}\n` +
+            `  affix mix: ${JSON.stringify(affixCounts)}` +
+            (multilocaleCount > 0
+                ? `\n  balance: emitted ${balanceEmitted}, skipped ${balanceSkipped}, iso ${JSON.stringify(balanceISO)}`
+                : ""));
+        return { emitted: emitted + balanceEmitted, skipped: skipped + balanceSkipped };
+    },
+};
+//# sourceMappingURL=street-affix.js.map

package/out/src/shard-recipes/street-affix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"street-affix.js","sourceRoot":"","sources":["../../../src/shard-recipes/street-affix.ts"],"names":[],"mappings":"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"}

package/out/src/shard-recipes/street-bare.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `street-bare` shard recipe — BARE-street rows (the v0.8.0 harness lever, 2026-06-05). The
+ *   `functional.test.ts` cluster (bare street names — "10th Ave", "Main St", "1 Main Pl") was
+ *   mislabeled `locality` because {@link synthesizeStreetRow} only ever emitted streets WITH a ",
+ *   City, ST ZIP" tail. This recipe emits streets BARE (`--bare-prob`, default 0.6) — no tail, only
+ *   `street_prefix`/`street`/`street_suffix` (+ optional `house_number` at `--hn-prob`, default
+ *   0.85) — over the built-in {@link DEFAULT_US_BASES} pool (round-robin). Generate-mode, US-only,
+ *   in-distribution (no German-collapse risk). Ported from scripts/build-street-bare-shard.mjs.
+ *
+ *   Byte-fidelity: the legacy script seeded its own mulberry32 from `--seed`
+ *   (`mulberry32(opts.seed)`); this recipe re-creates the SAME generator
+ *   (`makeMulberry32(opts.seed)`) and preserves the synthesis call order exactly, so `--seed N`
+ *   reproduces the legacy run byte-for-byte.
+ */
+import { type ShardRecipe } from "./scaffold.js";
+export declare const streetBareRecipe: ShardRecipe;
+//# sourceMappingURL=street-bare.d.ts.map

package/out/src/shard-recipes/street-bare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"street-bare.d.ts","sourceRoot":"","sources":["../../../src/shard-recipes/street-bare.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,EAAyD,KAAK,WAAW,EAAE,MAAM,eAAe,CAAA;AAEvG,eAAO,MAAM,gBAAgB,EAAE,WAiE9B,CAAA"}

package/out/src/shard-recipes/street-bare.js

@@ -0,0 +1,82 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `street-bare` shard recipe — BARE-street rows (the v0.8.0 harness lever, 2026-06-05). The
+ *   `functional.test.ts` cluster (bare street names — "10th Ave", "Main St", "1 Main Pl") was
+ *   mislabeled `locality` because {@link synthesizeStreetRow} only ever emitted streets WITH a ",
+ *   City, ST ZIP" tail. This recipe emits streets BARE (`--bare-prob`, default 0.6) — no tail, only
+ *   `street_prefix`/`street`/`street_suffix` (+ optional `house_number` at `--hn-prob`, default
+ *   0.85) — over the built-in {@link DEFAULT_US_BASES} pool (round-robin). Generate-mode, US-only,
+ *   in-distribution (no German-collapse risk). Ported from scripts/build-street-bare-shard.mjs.
+ *
+ *   Byte-fidelity: the legacy script seeded its own mulberry32 from `--seed`
+ *   (`mulberry32(opts.seed)`); this recipe re-creates the SAME generator
+ *   (`makeMulberry32(opts.seed)`) and preserves the synthesis call order exactly, so `--seed N`
+ *   reproduces the legacy run byte-for-byte.
+ */
+import { alignRow } from "../align.js";
+import { DEFAULT_US_BASES } from "../synthesize-intersection.js";
+import { synthesizeStreetRow } from "../synthesize-street.js";
+import { makeMulberry32, shardSourceID } from "./scaffold.js";
+export const streetBareRecipe = {
+    name: "street-bare",
+    description: "Bare-street rows (US): DEFAULT_US_BASES → synthesizeStreetRow (bare) → aligned LabeledRow",
+    mode: "generate",
+    options: [
+        { flag: "--bare-prob <p>", description: "P(emit the street BARE — no city/region/postcode tail). Default 0.6" },
+        { flag: "--hn-prob <p>", description: "P(emit a house number). Default 0.85" },
+    ],
+    async run(opts, write) {
+        const random = makeMulberry32(opts.seed);
+        const count = opts.count ?? 3000;
+        const bareProb = opts.bareProb ?? 0.6;
+        const hnProb = opts.hnProb ?? 0.85;
+        const source = opts.sourceName ?? "synth-street-bare";
+        let emitted = 0;
+        let skipped = 0;
+        let guard = 0;
+        while (emitted < count && guard++ < count * 5) {
+            const base = DEFAULT_US_BASES[emitted % DEFAULT_US_BASES.length];
+            const synth = synthesizeStreetRow(base, {
+                random,
+                bareProb,
+                includeHouseNumberProb: hnProb,
+            });
+            if (!synth) {
+                skipped++;
+                continue;
+            }
+            const isBare = synth.components.region === undefined;
+            const canonical = {
+                raw: synth.raw,
+                components: synth.components,
+                country: base.country,
+                locale: synth.locale,
+                source,
+                source_id: shardSourceID(source, {
+                    street: synth.components.street,
+                    street_suffix: synth.components.street_suffix,
+                    house_number: synth.components.house_number,
+                    bare: String(isBare),
+                    n: String(emitted),
+                }),
+                corpus_version: "0.4.0",
+                license: "Synthetic — US street templates, public-domain street/city pools",
+            };
+            // Strict labeled-only check (matches the legacy builder): alignRow always returns a `row`
+            // (labeled OR quarantined), so the scaffold's `alignAndWrite` would write quarantined rows
+            // too — call alignRow directly and skip anything not "labeled".
+            const aligned = alignRow(canonical);
+            if (aligned.kind !== "labeled" || !aligned.row) {
+                skipped++;
+                continue;
+            }
+            write(JSON.stringify({ ...aligned.row, synth_method: "street-bare", synth_base_id: null }) + "\n");
+            emitted++;
+        }
+        return { emitted, skipped };
+    },
+};
+//# sourceMappingURL=street-bare.js.map

package/out/src/shard-recipes/street-bare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"street-bare.js","sourceRoot":"","sources":["../../../src/shard-recipes/street-bare.ts"],"names":[],"mappings":"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"}

package/out/src/shard-recipes/street.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `street` shard recipe — synthetic street-decomposition rows for Stage 3 (US-only): tuples →
+ *   {@link synthesizeStreetRow} → aligned LabeledRow. Ported from scripts/build-street-shard.mjs.
+ */
+import { type ShardRecipe } from "./scaffold.js";
+export declare const streetRecipe: ShardRecipe;
+//# sourceMappingURL=street.d.ts.map

package/out/src/shard-recipes/street.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"street.d.ts","sourceRoot":"","sources":["../../../src/shard-recipes/street.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAsC,KAAK,WAAW,EAAE,MAAM,eAAe,CAAA;AAEpF,eAAO,MAAM,YAAY,EAAE,WAyD1B,CAAA"}

package/out/src/shard-recipes/street.js

@@ -0,0 +1,63 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `street` shard recipe — synthetic street-decomposition rows for Stage 3 (US-only): tuples →
+ *   {@link synthesizeStreetRow} → aligned LabeledRow. Ported from scripts/build-street-shard.mjs.
+ */
+import { stableSourceID } from "../adapter.js";
+import { synthesizeStreetRow } from "../synthesize-street.js";
+import { alignAndWrite, makeLcg, readTuples } from "./scaffold.js";
+export const streetRecipe = {
+    name: "street",
+    description: "Street-decomposition rows (US): tuples → synthesizeStreetRow → aligned LabeledRow",
+    mode: "tuples",
+    options: [{ flag: "--house-number-prob <p>", description: "P(emit a house number). Default 0.85" }],
+    async run(opts, write) {
+        if (!opts.input)
+            throw new Error("street recipe requires --input <tuples.jsonl>");
+        const random = makeLcg(opts.seed);
+        const includeHouseNumberProb = opts.houseNumberProb ?? 0.85;
+        let read = 0;
+        let emitted = 0;
+        let skipped = 0;
+        for await (const tuple of readTuples(opts.input)) {
+            read++;
+            if (!tuple.locality || !tuple.region || !tuple.postcode || !tuple.country) {
+                skipped++;
+                continue;
+            }
+            if (tuple.country !== "US") {
+                skipped++;
+                continue;
+            }
+            for (let v = 0; v < opts.variants; v++) {
+                const synth = synthesizeStreetRow(tuple, { random, includeHouseNumberProb });
+                if (!synth)
+                    continue;
+                const ok = alignAndWrite(write, {
+                    raw: synth.raw,
+                    components: synth.components,
+                    country: tuple.country,
+                    locale: synth.locale,
+                    source: "synth-street",
+                    source_id: stableSourceID("synth-street", {
+                        locality: `${tuple.locality}#${v}`,
+                        region: tuple.region,
+                        postcode: tuple.postcode,
+                        country: tuple.country,
+                    }),
+                    corpus_version: "0.4.0",
+                    license: "Synthetic — public-domain street name + tuple combination",
+                }, "street-decomp");
+                if (ok)
+                    emitted++;
+                else
+                    skipped++;
+            }
+        }
+        return { read, emitted, skipped };
+    },
+};
+//# sourceMappingURL=street.js.map

package/out/src/shard-recipes/street.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"street.js","sourceRoot":"","sources":["../../../src/shard-recipes/street.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,mBAAmB,EAAwB,MAAM,yBAAyB,CAAA;AACnF,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAoB,MAAM,eAAe,CAAA;AAEpF,MAAM,CAAC,MAAM,YAAY,GAAgB;IACxC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,mFAAmF;IAChG,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE,WAAW,EAAE,sCAAsC,EAAE,CAAC;IACnG,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK;QACpB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;QACjF,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjC,MAAM,sBAAsB,GAAG,IAAI,CAAC,eAAe,IAAI,IAAI,CAAA;QAC3D,IAAI,IAAI,GAAG,CAAC,CAAA;QACZ,IAAI,OAAO,GAAG,CAAC,CAAA;QACf,IAAI,OAAO,GAAG,CAAC,CAAA;QAEf,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,IAAI,EAAE,CAAA;YAEN,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC3E,OAAO,EAAE,CAAA;gBACT,SAAQ;YACT,CAAC;YAED,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBAC5B,OAAO,EAAE,CAAA;gBACT,SAAQ;YACT,CAAC;YAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;gBACxC,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAwB,EAAE,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAA;gBAE/F,IAAI,CAAC,KAAK;oBAAE,SAAQ;gBACpB,MAAM,EAAE,GAAG,aAAa,CACvB,KAAK,EACL;oBACC,GAAG,EAAE,KAAK,CAAC,GAAG;oBACd,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,MAAM,EAAE,cAAc;oBACtB,SAAS,EAAE,cAAc,CAAC,cAAc,EAAE;wBACzC,QAAQ,EAAE,GAAG,KAAK,CAAC,QAAQ,IAAI,CAAC,EAAE;wBAClC,MAAM,EAAE,KAAK,CAAC,MAAM;wBACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,OAAO,EAAE,KAAK,CAAC,OAAO;qBACtB,CAAC;oBACF,cAAc,EAAE,OAAO;oBACvB,OAAO,EAAE,2DAA2D;iBACpE,EACD,eAAe,CACf,CAAA;gBAED,IAAI,EAAE;oBAAE,OAAO,EAAE,CAAA;;oBACZ,OAAO,EAAE,CAAA;YACf,CAAC;QACF,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;IAClC,CAAC;CACD,CAAA"}