@mailwoman/corpus 9.2.0 → 9.4.0

package/out/synthesizers/intersection.js

@@ -0,0 +1,175 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Intersection synthesizer — v0.7 coverage fix (night-3, DeepSeek-decided).
+ *
+ *   The 2026-05-29 harness diagnostic found the neural model emits `intersection_a`/`intersection_b`
+ *   with ~0.0001 probability on canonical intersections ("Broadway & W 42nd St") — it never learned
+ *   the tags, because the corpus has NO intersection training signal (no generator, and real-data
+ *   adapters don't emit intersection-formatted rows). Intersections are 65 of the 376 harness
+ *   assertions (17%), all 0% neural. This generator produces the missing signal as a small targeted
+ *   supplement slice (synthesis-as-supplement discipline: weight < 0.25, one-and-done).
+ *
+ *   Output is a `CanonicalRow` ({raw, components}); the corpus aligner turns it into BIO labels
+ *   (B-/I-intersection_a, O on the connector, B-/I-intersection_b). Surface forms of both streets
+ *   MUST occur verbatim in `raw` so alignment lands.
+ *
+ *   US-idiomatic only (the harness intersection cases are US: "X & Y, City, ST ZIP").
+ */
+import { pick } from "#synthesizers/utils";
+/**
+ * Street name cores (no suffix) — proper-noun streets that often appear bare.
+ */
+/**
+ * Attempts to draw a second street distinct from the first before giving up on the pair.
+ */
+const MAX_DISTINCT_STREET_TRIES = 8;
+/* oxlint-disable sister-software/no-unnamed-threshold -- the bare decimals below are weighted-sampler
+   cutoffs, not thresholds: `const r = random()` followed by a cascade of `r < 0.4` branches IS the
+   output distribution, and reading the cascade top-to-bottom is how you see it. Naming each cutoff
+   would hide the distribution behind a wall of identifiers. Genuine thresholds in these files are
+   extracted as named constants above. */
+const STREET_CORES = [
+    "Main",
+    "Oak",
+    "Elm",
+    "Maple",
+    "Pine",
+    "Cedar",
+    "Park",
+    "Lake",
+    "Hill",
+    "Washington",
+    "Lincoln",
+    "Jefferson",
+    "Madison",
+    "Franklin",
+    "Market",
+    "Broad",
+    "Church",
+    "Mill",
+    "Highland",
+    "Sunset",
+    "Union",
+    "Spring",
+];
+/**
+ * Bare proper-noun streets that idiomatically take NO suffix.
+ */
+const BARE_NAMES = ["Broadway", "Wall", "Bourbon", "Esplanade", "Riverside", "Lakeshore"];
+const ORDINALS = [
+    "1st",
+    "2nd",
+    "3rd",
+    "4th",
+    "5th",
+    "6th",
+    "7th",
+    "8th",
+    "9th",
+    "10th",
+    "42nd",
+    "23rd",
+    "34th",
+];
+const SUFFIXES = ["St", "Ave", "Blvd", "Rd", "Dr", "Ln", "Way", "Pl", "Ct", "Pkwy", "Ter", "Cir"];
+// Vocabulary compile-checked against the codex; the ORDER stays this literal's. `Object.values(DirectionalAbbreviation)`
+// runs N,E,S,W,… — deriving the array from it would re-map every pick() draw and change shipped slice bytes.
+const DIRECTIONALS = ["N", "S", "E", "W", "NE", "NW", "SE", "SW"];
+/**
+ * Connectors between the two streets. Whitespace-padded forms keep tokens clean for alignment. `@` added in v0.7.2 —
+ * the harness uses it ("Main St @ Second Ave") and v0.7.1 had never seen it.
+ */
+const CONNECTORS = [" & ", " and ", " at ", " / ", " @ "];
+/**
+ * Build a single street surface form, e.g. "W 42nd St", "Broadway", "Main St", "N Oak Ave".
+ */
+function buildStreetName(random) {
+    // ~20% bare proper-noun street (no suffix), else directional? + core/ordinal + suffix.
+    if (random() < 0.2)
+        return pick(BARE_NAMES, random);
+    const parts = [];
+    if (random() < 0.35) {
+        parts.push(pick(DIRECTIONALS, random));
+    }
+    parts.push(random() < 0.45 ? pick(ORDINALS, random) : pick(STREET_CORES, random));
+    parts.push(pick(SUFFIXES, random));
+    return parts.join(" ");
+}
+/**
+ * Synthesize one US intersection row. Returns null on the rare degenerate case where the two streets collide (so
+ * alignment never has two identical surface forms to disambiguate).
+ */
+export function synthesizeIntersectionRow(base, opts = {}) {
+    const random = opts.random ?? Math.random;
+    if (base.country !== "US")
+        return null;
+    const a = buildStreetName(random);
+    let b = buildStreetName(random);
+    // Ensure distinct surface forms (and not a substring of each other — alignment needs unambiguous spans).
+    let tries = 0;
+    while ((b === a || a.includes(b) || b.includes(a)) && tries++ < MAX_DISTINCT_STREET_TRIES) {
+        b = buildStreetName(random);
+    }
+    if (b === a || a.includes(b) || b.includes(a))
+        return null;
+    const connector = pick(CONNECTORS, random);
+    // "corner of" prefix variant (~20%) — still labels the two streets identically.
+    const cornerPrefix = random() < 0.2 ? "corner of " : "";
+    const components = { intersection_a: a, intersection_b: b };
+    // v0.7.2: ~60% BARE (no locality tail). v0.7.1 always appended ", City, ST", so the model learned
+    // to read post-intersection text as a locality and fumbled the harness's bare "X & Y" cases
+    // (mislabeling the second street as a locality). Match the eval distribution.
+    const bare = random() < 0.6;
+    let raw;
+    if (bare) {
+        raw = `${cornerPrefix}${a}${connector}${b}`;
+    }
+    else {
+        const includePostcode = base.postcode != null && random() < 0.7;
+        const tail = includePostcode
+            ? `, ${base.locality}, ${base.region} ${base.postcode}`
+            : `, ${base.locality}, ${base.region}`;
+        raw = `${cornerPrefix}${a}${connector}${b}${tail}`;
+        components.locality = base.locality;
+        components.region = base.region;
+        if (includePostcode) {
+            components.postcode = base.postcode;
+        }
+    }
+    return { raw, components, locale: "en-US" };
+}
+/**
+ * A small built-in US city/region/zip pool for standalone slice generation + tests.
+ */
+export const DEFAULT_US_BASES = [
+    { locality: "New York", region: "NY", postcode: "10036", country: "US" },
+    { locality: "Chicago", region: "IL", postcode: "60613", country: "US" },
+    { locality: "Los Angeles", region: "CA", postcode: "90012", country: "US" },
+    { locality: "Seattle", region: "WA", postcode: "98109", country: "US" },
+    { locality: "Austin", region: "TX", postcode: "78701", country: "US" },
+    { locality: "Portland", region: "OR", postcode: "97205", country: "US" },
+    { locality: "Denver", region: "CO", postcode: "80202", country: "US" },
+    { locality: "Boston", region: "MA", postcode: "02116", country: "US" },
+    { locality: "Miami", region: "FL", postcode: "33130", country: "US" },
+    { locality: "Atlanta", region: "GA", postcode: "30303", country: "US" },
+];
+/**
+ * Generate `count` intersection rows over the provided bases (round-robin).
+ */
+export function generateIntersectionRows(count, bases = DEFAULT_US_BASES, opts = {}) {
+    const random = opts.random ?? Math.random;
+    const out = [];
+    let guard = 0;
+    while (out.length < count && guard++ < count * 4) {
+        const base = bases[out.length % bases.length];
+        const row = synthesizeIntersectionRow(base, { random });
+        if (row) {
+            out.push(row);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=intersection.js.map

package/out/synthesizers/intersection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intersection.js","sourceRoot":"","sources":["../../lib/synthesizers/intersection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAG1C;;GAEG;AAEH;;GAEG;AACH,MAAM,yBAAyB,GAAG,CAAC,CAAA;AAEnC;;;;yCAIyC;AAEzC,MAAM,YAAY,GAAG;IACpB,MAAM;IACN,KAAK;IACL,KAAK;IACL,OAAO;IACP,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,YAAY;IACZ,SAAS;IACT,WAAW;IACX,SAAS;IACT,UAAU;IACV,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,MAAM;IACN,UAAU;IACV,QAAQ;IACR,OAAO;IACP,QAAQ;CACC,CAAA;AAEV;;GAEG;AACH,MAAM,UAAU,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,CAAU,CAAA;AAElG,MAAM,QAAQ,GAAG;IAChB,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;CACG,CAAA;AAEV,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAU,CAAA;AAE1G,yHAAyH;AACzH,6GAA6G;AAC7G,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAuD,CAAA;AAEvH;;;GAGG;AACH,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAU,CAAA;AAsBlE;;GAEG;AACH,SAAS,eAAe,CAAC,MAAoB;IAC5C,uFAAuF;IACvF,IAAI,MAAM,EAAE,GAAG,GAAG;QAAE,OAAO,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;IAEnD,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,IAAI,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAA;IACvC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAA;IACjF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAA;IAElC,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACxC,IAA2B,EAC3B,OAAkC,EAAE;IAEpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAA;IAEzC,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAEtC,MAAM,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;IACjC,IAAI,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;IAC/B,yGAAyG;IACzG,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,GAAG,yBAAyB,EAAE,CAAC;QAC3F,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;IAC5B,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IAE1D,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;IAC1C,gFAAgF;IAChF,MAAM,YAAY,GAAG,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAA;IAEvD,MAAM,UAAU,GAA+B,EAAE,cAAc,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,CAAA;IAEvF,kGAAkG;IAClG,4FAA4F;IAC5F,8EAA8E;IAC9E,MAAM,IAAI,GAAG,MAAM,EAAE,GAAG,GAAG,CAAA;IAC3B,IAAI,GAAW,CAAA;IAEf,IAAI,IAAI,EAAE,CAAC;QACV,GAAG,GAAG,GAAG,YAAY,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,EAAE,CAAA;IAC5C,CAAC;SAAM,CAAC;QACP,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,IAAI,MAAM,EAAE,GAAG,GAAG,CAAA;QAE/D,MAAM,IAAI,GAAG,eAAe;YAC3B,CAAC,CAAC,KAAK,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE;YACvD,CAAC,CAAC,KAAK,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,MAAM,EAAE,CAAA;QAEvC,GAAG,GAAG,GAAG,YAAY,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,GAAG,IAAI,EAAE,CAAA;QAClD,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;QACnC,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QAE/B,IAAI,eAAe,EAAE,CAAC;YACrB,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;QACpC,CAAC;IACF,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAyC;IACrE,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;IACxE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;IACvE,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;IAC3E,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;IACvE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;IACtE,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;IACxE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;IACtE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;IACtE,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;IACrE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;CACvE,CAAA;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACvC,KAAa,EACb,QAA8C,gBAAgB,EAC9D,OAAkC,EAAE;IAEpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAA;IACzC,MAAM,GAAG,GAAiC,EAAE,CAAA;IAC5C,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,OAAO,GAAG,CAAC,MAAM,GAAG,KAAK,IAAI,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAE,CAAA;QAC9C,MAAM,GAAG,GAAG,yBAAyB,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;QAEvD,IAAI,GAAG,EAAE,CAAC;YACT,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACd,CAAC;IACF,CAAC;IAED,OAAO,GAAG,CAAA;AACX,CAAC"}

package/out/synthesizers/no-street.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   No-street address synthesizer — the counter-distribution that v0.6.1's synth-street slice is
+ *   missing. Generates BIO-labelable rows where there is NO street, NO house_number, NO
+ *   street_prefix, NO street_suffix, NO intersection — only some subset of {venue, locality,
+ *   region, postcode, country}.
+ *
+ *   Rationale: the [2026-05-28 night-2
+ *   postmortem](../../docs/articles/evals/night-shifts/2026-05-28-night-2-postmortem.md) and the [layer-1
+ *   eval](../../docs/articles/evals/experiments/2026-05-28-layer-1-morphology-fst.md) showed that synth-street
+ *   pushed the model into a high-confidence "decompose mode" that leaked into `dependent_locality`.
+ *   Per DeepSeek's turn-2 recipe, the model needs explicit counter-examples: addresses where the
+ *   model should NOT emit street labels. This synthesizer is that source.
+ *
+ *   Six row templates, each producing a {raw, components} pair with no street-side tags:
+ *
+ *   1. **Plain venue + locality + region + postcode** `"Bob's Pizza, Boston, MA 02101"`
+ *   2. **Adversarial venue (containing street-typing words)** `"Wall Street Industries, NY 10005"`,
+ *        `"5th Avenue Theater, Seattle, WA"`, `"Highway 61 Diner, Memphis TN"`. These are the rows
+ *        that v0.6.1's decompose-mode would mis-tag as street_prefix/suffix; explicit negative
+ *        training kills that signal.
+ *   3. **Locality + region + postcode (minimal)** — `"Boston, MA 02101"`
+ *   4. **Locality + region** — `"Boston, MA"`
+ *   5. **Postcode-only** — `"02101"`
+ *   6. **Country-only** — `"United States"`, `"France"` (rare in real data, but the model has seen these
+ *        and should not hallucinate streets on them).
+ *
+ *   Output is a `CanonicalRow` with no street-side components. Alignment will produce BIO labels
+ *   where every token is one of {`B-venue`, `I-venue`, `B-locality`, `I-locality`, `B-region`,
+ *   `B-postcode`, `B-country`, `I-country`, `O`} — explicitly never any street tag. That IS the
+ *   counter-example signal the model is missing.
+ *
+ *   This complements (does not replace) the existing US-base-tuple source used by
+ *   `po-box.ts`; the same `NoStreetBaseTuple` shape is consumed.
+ */
+import type { CanonicalRow } from "#types";
+export interface NoStreetBaseTuple {
+    locality: string;
+    region: string;
+    postcode: string;
+    country: string;
+}
+export type NoStreetTemplate = "venue-plain" | "venue-adversarial" | "locality-region-postcode" | "locality-region" | "postcode-only" | "country-only";
+export interface NoStreetSynthesisOpts {
+    random?: () => number;
+    /**
+     * Override the template selection entirely (used by tests for deterministic coverage).
+     */
+    forceTemplate?: NoStreetTemplate;
+}
+export interface SynthesizedNoStreetRow {
+    raw: string;
+    components: CanonicalRow["components"];
+    locale: string;
+    template: NoStreetTemplate;
+}
+/**
+ * Generate one no-street counter-example row for a base (locality, region, postcode, country) tuple. Picks a template
+ * by weighted random; the venue templates are the critical counter-distribution against synth-street's decompose-mode
+ * pressure.
+ */
+export declare function synthesizeNoStreetRow(base: NoStreetBaseTuple, opts?: NoStreetSynthesisOpts): SynthesizedNoStreetRow | null;
+/**
+ * Convenience: assert at type-level that a synthesized row carries no street-side components. Used by tests +
+ * downstream consumers who want to verify the contract at runtime.
+ */
+export declare const STREET_SIDE_TAGS: readonly ["street", "street_prefix", "street_prefix_particle", "street_suffix", "house_number", "intersection_a", "intersection_b", "unit"];
+export declare function hasAnyStreetSideTag(components: CanonicalRow["components"]): boolean;
+//# sourceMappingURL=no-street.d.ts.map

package/out/synthesizers/no-street.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-street.d.ts","sourceRoot":"","sources":["../../lib/synthesizers/no-street.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAU1C,MAAM,WAAW,iBAAiB;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,gBAAgB,GACzB,aAAa,GACb,mBAAmB,GACnB,0BAA0B,GAC1B,iBAAiB,GACjB,eAAe,GACf,cAAc,CAAA;AAEjB,MAAM,WAAW,qBAAqB;IACrC,MAAM,CAAC,EAAE,MAAM,MAAM,CAAA;IACrB;;OAEG;IACH,aAAa,CAAC,EAAE,gBAAgB,CAAA;CAChC;AAED,MAAM,WAAW,sBAAsB;IACtC,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC,CAAA;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,gBAAgB,CAAA;CAC1B;AAoGD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,iBAAiB,EACvB,IAAI,GAAE,qBAA0B,GAC9B,sBAAsB,GAAG,IAAI,CA0F/B;AA2BD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,6IASnB,CAAA;AAEV,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC,GAAG,OAAO,CAMnF"}

package/out/synthesizers/no-street.js

@@ -0,0 +1,262 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   No-street address synthesizer — the counter-distribution that v0.6.1's synth-street slice is
+ *   missing. Generates BIO-labelable rows where there is NO street, NO house_number, NO
+ *   street_prefix, NO street_suffix, NO intersection — only some subset of {venue, locality,
+ *   region, postcode, country}.
+ *
+ *   Rationale: the [2026-05-28 night-2
+ *   postmortem](../../docs/articles/evals/night-shifts/2026-05-28-night-2-postmortem.md) and the [layer-1
+ *   eval](../../docs/articles/evals/experiments/2026-05-28-layer-1-morphology-fst.md) showed that synth-street
+ *   pushed the model into a high-confidence "decompose mode" that leaked into `dependent_locality`.
+ *   Per DeepSeek's turn-2 recipe, the model needs explicit counter-examples: addresses where the
+ *   model should NOT emit street labels. This synthesizer is that source.
+ *
+ *   Six row templates, each producing a {raw, components} pair with no street-side tags:
+ *
+ *   1. **Plain venue + locality + region + postcode** `"Bob's Pizza, Boston, MA 02101"`
+ *   2. **Adversarial venue (containing street-typing words)** `"Wall Street Industries, NY 10005"`,
+ *        `"5th Avenue Theater, Seattle, WA"`, `"Highway 61 Diner, Memphis TN"`. These are the rows
+ *        that v0.6.1's decompose-mode would mis-tag as street_prefix/suffix; explicit negative
+ *        training kills that signal.
+ *   3. **Locality + region + postcode (minimal)** — `"Boston, MA 02101"`
+ *   4. **Locality + region** — `"Boston, MA"`
+ *   5. **Postcode-only** — `"02101"`
+ *   6. **Country-only** — `"United States"`, `"France"` (rare in real data, but the model has seen these
+ *        and should not hallucinate streets on them).
+ *
+ *   Output is a `CanonicalRow` with no street-side components. Alignment will produce BIO labels
+ *   where every token is one of {`B-venue`, `I-venue`, `B-locality`, `I-locality`, `B-region`,
+ *   `B-postcode`, `B-country`, `I-country`, `O`} — explicitly never any street tag. That IS the
+ *   counter-example signal the model is missing.
+ *
+ *   This complements (does not replace) the existing US-base-tuple source used by
+ *   `po-box.ts`; the same `NoStreetBaseTuple` shape is consumed.
+ */
+import { countryToLocale, pick } from "#synthesizers/utils";
+//#endregion
+//#region Venue name pools
+/**
+ * Plain venue names — businesses without street-typing words in the name. Used as the easy-mode positive class for
+ * venue detection.
+ */
+const PLAIN_VENUES = [
+    "Bob's Pizza",
+    "Acme Corporation",
+    "Joe's Diner",
+    "Sunrise Bakery",
+    "Maple Leaf Cafe",
+    "Riverside Garden Center",
+    "Tech Solutions Inc",
+    "Pacific Industries",
+    "Atlantic Holdings",
+    "Stellar Consulting",
+    "Greenfield Partners",
+    "Mountain View Studio",
+    "The Daily Grind",
+    "Sunset Bistro",
+    "Harvest Moon Florist",
+    "Iron Forge Brewing",
+    "Crescent City Bookstore",
+    "Lighthouse Insurance Group",
+    "Pinecrest Veterinary",
+    "Westwood Realty",
+];
+/**
+ * Adversarial venue names — businesses whose names contain street-typing tokens (Avenue, Street, Highway, Lane, Drive,
+ * Court, Plaza, Park, ...) but are themselves venues, not streets. The model must learn that these are venues despite
+ * the street-typing tokens.
+ *
+ * **No leading digit+ordinal venues** (e.g. "5th Avenue Theatre", "7th Street Bistro"). The v0.6.2 2026-05-29 step-20K
+ * eval showed that synthesized rows starting with `<digits><ordinal>` confused the model about house_number recognition
+ * — tokens like "5th" (which should be `B-house_number` in real addresses) were being labeled `B-venue` because
+ * adversarial venues placed them in venue position. v0.6.3 omits these patterns; the `synth-house-venue` slice
+ * separately teaches that house_number and venue coexist.
+ */
+const ADVERSARIAL_VENUES = [
+    "Wall Street Industries",
+    "Highway 61 Diner",
+    "Lane Bryant",
+    "Park Avenue Dental",
+    "Broadway Theatre Company",
+    "Madison Square Garden",
+    "Main Street Bakery",
+    "Sunset Boulevard Studios",
+    "Ocean Drive Cafe",
+    "Mountain Road Outfitters",
+    "Hollywood Boulevard Salon",
+    "East Bay Auto",
+    "West End Pharmacy",
+    "North Shore Insurance",
+    "South Park Children's Center",
+    "River Road Animal Hospital",
+    "Hill Street Blues Bar",
+    "Court House Square Realty",
+    "Plaza Hotel",
+    "Lincoln Park Zoo",
+    "Central Park Conservancy",
+    "Lakeshore Boulevard Apartments",
+    "Memorial Drive Medical Center",
+    "Wabash Avenue Press",
+    "State Street Bank",
+    "Market Street Grill",
+    "Beach Boulevard Diner",
+    "Garden Lane Florist",
+];
+// Compile-time guard: every venue must NOT start with the digit+ordinal pattern that
+// confuses house_number recognition. If a future contributor adds a "5th Avenue Theatre"-
+// style entry, this assertion will fire at module load time.
+for (const v of ADVERSARIAL_VENUES) {
+    if (/^\d+(st|nd|rd|th)\b/i.test(v)) {
+        throw new Error(`ADVERSARIAL_VENUES entry "${v}" starts with digit+ordinal; this pattern confuses ` +
+            `house_number recognition (see v0.6.3 eval doc). Use a non-numeric venue name.`);
+    }
+}
+const COUNTRY_NAMES = new Map([
+    ["US", ["United States", "USA", "U.S.A.", "United States of America"]],
+    ["FR", ["France"]],
+    ["DE", ["Germany", "Deutschland"]],
+    ["GB", ["United Kingdom", "UK", "Great Britain"]],
+    ["CA", ["Canada"]],
+    ["AU", ["Australia"]],
+]);
+//#endregion
+//#region Synthesis
+/**
+ * Generate one no-street counter-example row for a base (locality, region, postcode, country) tuple. Picks a template
+ * by weighted random; the venue templates are the critical counter-distribution against synth-street's decompose-mode
+ * pressure.
+ */
+export function synthesizeNoStreetRow(base, opts = {}) {
+    const random = opts.random ?? Math.random;
+    const locale = countryToLocale(base.country);
+    const template = opts.forceTemplate ?? pickTemplate(random);
+    switch (template) {
+        case "venue-plain": {
+            const venue = pick(PLAIN_VENUES, random);
+            const raw = `${venue}, ${base.locality}, ${base.region} ${base.postcode}`;
+            return {
+                raw,
+                components: {
+                    venue,
+                    locality: base.locality,
+                    region: base.region,
+                    postcode: base.postcode,
+                },
+                locale,
+                template,
+            };
+        }
+        case "venue-adversarial": {
+            // The venue-adversarial template name is descriptive — when selected, this branch
+            // always draws from the adversarial pool. The `adversarialVenueRatio` opt is what
+            // the OUTER template picker uses to bias toward this template versus the plain one;
+            // once we're inside this branch the choice is already made.
+            const venue = pick(ADVERSARIAL_VENUES, random);
+            const raw = `${venue}, ${base.locality}, ${base.region} ${base.postcode}`;
+            return {
+                raw,
+                components: {
+                    venue,
+                    locality: base.locality,
+                    region: base.region,
+                    postcode: base.postcode,
+                },
+                locale,
+                template,
+            };
+        }
+        case "locality-region-postcode": {
+            const raw = `${base.locality}, ${base.region} ${base.postcode}`;
+            return {
+                raw,
+                components: {
+                    locality: base.locality,
+                    region: base.region,
+                    postcode: base.postcode,
+                },
+                locale,
+                template,
+            };
+        }
+        case "locality-region": {
+            const raw = `${base.locality}, ${base.region}`;
+            return {
+                raw,
+                components: {
+                    locality: base.locality,
+                    region: base.region,
+                },
+                locale,
+                template,
+            };
+        }
+        case "postcode-only": {
+            return {
+                raw: base.postcode,
+                components: { postcode: base.postcode },
+                locale,
+                template,
+            };
+        }
+        case "country-only": {
+            const names = COUNTRY_NAMES.get(base.country) ?? [base.country];
+            const country = pick(names, random);
+            return {
+                raw: country,
+                components: { country },
+                locale,
+                template,
+            };
+        }
+    }
+}
+/**
+ * Template weights chosen so that the venue-* templates dominate (they're the counter-example shape that matters), with
+ * the minimal templates as long-tail noise.
+ */
+function pickTemplate(random) {
+    const r = random();
+    if (r < 0.35)
+        return "venue-adversarial";
+    // 35% — the critical slice
+    if (r < 0.6)
+        return "venue-plain";
+    // 25%
+    if (r < 0.8)
+        return "locality-region-postcode";
+    // 20%
+    if (r < 0.92)
+        return "locality-region";
+    // 12%
+    if (r < 0.98)
+        return "postcode-only";
+    // 6%
+    return "country-only"; // 2%
+}
+/**
+ * Convenience: assert at type-level that a synthesized row carries no street-side components. Used by tests +
+ * downstream consumers who want to verify the contract at runtime.
+ */
+export const STREET_SIDE_TAGS = [
+    "street",
+    "street_prefix",
+    "street_prefix_particle",
+    "street_suffix",
+    "house_number",
+    "intersection_a",
+    "intersection_b",
+    "unit",
+];
+export function hasAnyStreetSideTag(components) {
+    for (const t of STREET_SIDE_TAGS) {
+        if (components[t])
+            return true;
+    }
+    return false;
+}
+//#endregion
+//# sourceMappingURL=no-street.js.map

package/out/synthesizers/no-street.js.map

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

package/out/synthesizers/po-box.d.ts

@@ -0,0 +1,108 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   PO box / PMB / Apartado / Boîte Postale synthesizer.
+ *
+ *   Generates BIO-labeled corpus rows where the delivery line is a PO box (mutually exclusive with
+ *   street + house_number per USPS Pub 28 / DMM 508). Locale-aware: emits idiomatic forms for
+ *   en-US, en-CA, en-GB, en-AU, fr-FR, fr-CA, es-ES, es-MX, es-AR.
+ *
+ *   Per-DeepSeek design:
+ *
+ *   - PMB ("Private Mailbox" — at CMRAs like UPS Store) shares the `po_box` tag with USPS PO Box.
+ *       Disambiguation is a downstream heuristic (presence of a street line).
+ *   - Whole-phrase span ("PO Box 123") not number-only ("123"). Matches existing golden eval.
+ *   - 10% of outputs receive number-format noise (commas, dashes, embedded spaces) to harden against
+ *       real-world OCR/transcription input.
+ *   - PO boxes drop street/house_number/unit/street_prefix/street_suffix from input components.
+ *
+ *   References:
+ *
+ *   - USPS Pub 28 §28C2.040 — Private Mailbox formatting
+ *   - USPS DMM 508 §4.1.4 / §4.5.4 — PO Box and street-addressed PO Box
+ */
+import type { CanonicalRow } from "#types";
+export interface PoBoxBaseTuple {
+    locality: string;
+    region: string;
+    postcode: string;
+    country: string;
+}
+export interface LocaleTemplate {
+    locale: string;
+    leaders: ReadonlyArray<string>;
+    pmb?: ReadonlyArray<string>;
+}
+/**
+ * The per-locale PO-box designator vocabulary (DeepSeek-signed list, see the header). Exported so slice builders
+ * (scripts/build-po-box-cedex-slice.mjs) can reuse THIS list as the single source of truth for non-US leaders instead
+ * of re-deriving it — the US slice additionally has `@mailwoman/codex/us` `US_PO_BOX_DESIGNATORS`/`isPOBox` as its
+ * matcher-side truth.
+ */
+export declare const PO_BOX_LOCALE_TEMPLATES: ReadonlyArray<LocaleTemplate>;
+/**
+ * Inject number-format noise into a box number string. Returns the noisy variant or the original (10% probability of
+ * noise per the design).
+ */
+export declare function maybeNoisifyBoxNumber(num: string, random: () => number): string;
+/**
+ * Compose a PO box phrase like "PO Box 123" or "PMB 200".
+ *
+ * Returns both the phrase and the canonical leader+number so the BIO aligner can mark the entire span as `po_box`.
+ */
+export declare function composePoBoxPhrase(leader: string, number: string): string;
+export interface SynthesizedPoBoxRow {
+    raw: string;
+    components: CanonicalRow["components"];
+    locale: string;
+    template: "po-box" | "pmb-with-street" | "military-po-box";
+}
+export interface PoBoxSynthesisOpts {
+    /**
+     * Random function — pass deterministic seed for tests. Default Math.random.
+     */
+    random?: () => number;
+    /**
+     * Number generator. Default uniform over 1..99999.
+     */
+    pickNumber?: (random: () => number) => string;
+    /**
+     * PMB probability when locale supports it (and a street is provided in the base tuple).
+     */
+    pmbRatio?: number;
+}
+/**
+ * Generate one PO box row for a base (locality, region, postcode, country) tuple. Picks a locale-appropriate leader and
+ * number. Optionally generates a PMB variant when the base tuple includes a street.
+ */
+export declare function synthesizePoBoxRow(base: PoBoxBaseTuple & {
+    street?: string;
+    houseNumber?: string;
+}, opts?: PoBoxSynthesisOpts): SynthesizedPoBoxRow | null;
+/**
+ * Generate one US military/diplomatic PO-box row (#517). Self-contained — draws no base tuple.
+ */
+export declare function synthesizeMilitaryPoBoxRow(opts?: PoBoxSynthesisOpts): SynthesizedPoBoxRow;
+/**
+ * Map a country code (ISO-3166-1 alpha-2 or alpha-3, or country display name) to the locale code we have a PO box
+ * template for.
+ *
+ * TEMPLATE-SCOPED on top of the shared `#synthesizers/utils` map: a locale the shared map resolves but
+ * {@link PO_BOX_LOCALE_TEMPLATES} does not carry falls back to `en-US`, so `DE` (shared: `de-DE`, no PO-box template)
+ * keeps rendering the en-US box vocabulary here.
+ */
+export declare function countryToLocale(country: string): string;
+/**
+ * All locales we synthesize for. Exposed for tests and for source-weight tuning.
+ */
+export declare function supportedLocales(): ReadonlyArray<string>;
+/**
+ * Locales whose standard PO-box delivery line carries NO region token — the address reads `<po_box>, <locality>
+ * <postcode>` with nothing between locality and postcode (#517). NZ is the canonical case (`Private Bag 12, Auckland
+ * 1010`). Consumers (e.g. the synth-po-box adapter) use this to avoid discarding region-less input tuples for these
+ * locales as "missing region".
+ */
+export declare const REGION_OPTIONAL_LOCALES: ReadonlySet<string>;
+//# sourceMappingURL=po-box.d.ts.map

package/out/synthesizers/po-box.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"po-box.d.ts","sourceRoot":"","sources":["../../lib/synthesizers/po-box.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAkB1C,MAAM,WAAW,cAAc;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAE9B,GAAG,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAC3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,aAAa,CAAC,cAAc,CA2CjE,CAAA;AAID;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,MAAM,GAAG,MAAM,CAe/E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,MAAM,WAAW,mBAAmB;IACnC,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC,CAAA;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,QAAQ,GAAG,iBAAiB,GAAG,iBAAiB,CAAA;CAC1D;AAED,MAAM,WAAW,kBAAkB;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,MAAM,CAAA;IACrB;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,MAAM,KAAK,MAAM,CAAA;IAC7C;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB;AAaD;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,cAAc,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAChE,IAAI,GAAE,kBAAuB,GAC3B,mBAAmB,GAAG,IAAI,CAyD5B;AA0BD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,GAAE,kBAAuB,GAAG,mBAAmB,CAuB7F;AAID;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAAC,MAAM,CAAC,CAExD;AAED;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAAsB,CAAA"}