@mailwoman/corpus 8.6.0 → 9.1.0

package/out/src/tools/golden-relabel-street.d.ts

@@ -0,0 +1,196 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Golden-set street-suffix relabel — v0.1.2 → v0.1.3.
+ *
+ *   ## Why this exists
+ *
+ *   The golden answer key and the training corpus disagreed about ONE thing, and the v9.0.0
+ *   promotion gate read the disagreement as a model regression (`us.street` 87.4 vs a floor of
+ *   87.8). The corpus SPLITS a US street into `street` + `street_suffix` — TIGER's adapter
+ *   decomposes at `corpus/src/adapters/tiger/street-decompose.ts`, the `street-affix` shard recipe
+ *   teaches it from USPS Pub-28, and `ComponentTag` carries `street_suffix` as a first-class tag.
+ *   The golden set FOLDED it: 2,216 US rows carry a `street`, and exactly 2 of them label a
+ *   `street_suffix`. Operator ruling, 2026-08-06: **the split is canonical**; the golden is the
+ *   stale side. This tool moves the answer key onto the corpus convention.
+ *
+ *   ## The instrument
+ *
+ *   `matchTrailingSuffix` from `@mailwoman/codex/us` — the USPS Pub-28 Appendix C table, which is
+ *   also what the corpus shard recipe splits on. The table is NOT re-implemented here, and the
+ *   libpostal dictionary TIGER reads is deliberately not used: measured on this golden set the two
+ *   disagree on 51 US rows, and the disagreements run in the codex table's favour (libpostal's
+ *   `directionals.txt` lists `center|c`, so TIGER reads the `C` of "C STREET" as a directional
+ *   prefix and then emits no suffix at all).
+ *
+ *   ## What it changes, and what it refuses to
+ *
+ *   Applied only to rows whose `country` is `US`. Three branches, mirroring the SHAPE of TIGER's
+ *   `decomposeStreet` on codex tables:
+ *
+ *   - **street type** — the last whitespace-separated word is a Pub-28 suffix, and something is left
+ *       over: "Main St" → `street: "Main"`, `street_suffix: "St"` (1,559 rows).
+ *   - **street type + post-directional** — the last word is a directional AND the one before it is a
+ *       Pub-28 suffix: "Pennsylvania Avenue NW" → `street: "Pennsylvania"`,
+ *       `street_suffix: "Avenue NW"` (347 rows). The post-directional joins the suffix rather than
+ *       becoming a tag of its own, because that is what the corpus adapter emits; there is no
+ *       `street_postfix` tag to move it to.
+ *   - **everything else is left folded** and reported. In particular a BARE post-directional tail
+ *       ("Seymour East", "BROADWAY N" — 16 rows) is NOT split: a directional is not a Pub-28 suffix,
+ *       and the observed rows in that class are unit-contaminated ("1ST AVE SW BOX E", where the
+ *       trailing "E" is a box letter).
+ *
+ *   FR rows are untouched, deliberately and permanently as far as this tool is concerned. French
+ *   street typology puts the type FIRST ("Rue de la Paix") and the golden labels only 7 of 665 FR
+ *   street rows with a `street_prefix`; whether FR should split at all is a different question with
+ *   a different table behind it, and nothing here should be read as having answered it.
+ *
+ *   ## Surface bytes
+ *
+ *   The split is a cut at a whitespace run in the ORIGINAL string — no trimming, no case
+ *   normalization, no re-joining of tokens. `street + gap + street_suffix` reconstructs the input
+ *   byte-for-byte, so the whitespace between them belongs to neither span (the same shape the corpus
+ *   adapter's spans have). The tool asserts this per row and refuses to write a file if it ever
+ *   fails.
+ */
+/**
+ * A golden-set row, as stored one-per-line in `us.jsonl` / `fr.jsonl` / `adversarial.jsonl`. Only the fields this tool
+ * reads are modeled; every other key rides through untouched.
+ */
+export interface GoldenStreetRow {
+    raw: string;
+    components: Record<string, string>;
+    country?: string;
+    source?: string;
+    notes?: string;
+    [key: string]: unknown;
+}
+/**
+ * What the tool decided about one row. Every value except the two `split-*` classes means "left folded".
+ */
+export type GoldenRelabelClass = "split-suffix" | "split-suffix-postdirectional" | "split-prefix-only" | "already-split" | "single-token" | "suffix-only-street" | "postdirectional-tail-only" | "no-suffix-match" | "no-street" | "not-us" | "untrimmed-street";
+/**
+ * A review trigger on a row the tool DID change. A flag is never an adjudication — it marks the row for the operator's
+ * deck, and the split is applied either way.
+ */
+export interface GoldenRelabelFlag {
+    kind: "name-prone-suffix" | "venue-context" | "remainder-is-affix";
+    detail: string;
+}
+/**
+ * Row-level relabel outcome.
+ */
+export interface GoldenRelabelResult {
+    /**
+     * The row to write. Identical object reference when nothing changed.
+     */
+    row: GoldenStreetRow;
+    changed: boolean;
+    rowClass: GoldenRelabelClass;
+    flags: GoldenRelabelFlag[];
+    /**
+     * A leading directional was lifted into `street_prefix` on this row.
+     */
+    prefixSplit: boolean;
+    /**
+     * The street span as it stood in the parent version — recorded for the review deck.
+     */
+    beforeStreet?: string;
+}
+/**
+ * Options for {@linkcode relabelGoldenStreetRow}.
+ */
+export interface RelabelStreetRowOptions {
+    /**
+     * Also lift a folded LEADING directional out into `street_prefix`. Default true.
+     *
+     * On by default because the fold cuts both ways and the answer key has to be corrected on both, or the correction is
+     * not a correction: 207 of the 1,682 split dev rows (12.3%) still opened with a directional after the suffix move —
+     * "N Desmet Avenue" would have graded `street: "N Desmet"` against a model that says `street_prefix: "N", street:
+     * "Desmet"`. Turn it OFF only to measure what the prefix fold alone costs.
+     */
+    splitPrefix?: boolean;
+}
+/**
+ * Decide, and apply, the US street-span split for ONE golden row. Pure: never mutates its argument, and returns the
+ * same object reference when the row is left alone.
+ */
+export declare function relabelGoldenStreetRow(row: GoldenStreetRow, options?: RelabelStreetRowOptions): GoldenRelabelResult;
+/**
+ * Per-class row counts for one relabelled file.
+ */
+export type GoldenRelabelCounts = Record<GoldenRelabelClass, number>;
+/**
+ * One line of the review deck: what a changed (or notably unchanged) row looked like before and after.
+ */
+export interface GoldenRelabelDeckEntry {
+    file: string;
+    line: number;
+    raw: string;
+    rowClass: GoldenRelabelClass;
+    before: Record<string, string>;
+    after: Record<string, string>;
+    flags: GoldenRelabelFlag[];
+}
+/**
+ * Options for {@linkcode relabelGoldenDirectory}.
+ */
+export interface RelabelGoldenOptions {
+    /**
+     * Parent golden version dir (read-only), e.g. `data/eval/golden/v0.1.2`.
+     */
+    input: string;
+    /**
+     * Output golden version dir. Created; never overwritten in place.
+     */
+    output: string;
+    /**
+     * Review-deck JSONL path. Default `<output>/REVIEW-DECK.jsonl`.
+     */
+    deck?: string;
+    /**
+     * Parent version label recorded in the manifest. Default: the input dir's basename.
+     */
+    parentLabel?: string;
+    /**
+     * Tool provenance recorded in the manifest — the commit the relabel ran at.
+     */
+    commit?: string;
+    /**
+     * Passed through to {@linkcode relabelGoldenStreetRow}. Default true.
+     */
+    splitPrefix?: boolean;
+}
+/**
+ * Aggregate outcome for a whole golden version.
+ */
+export interface RelabelGoldenReport {
+    files: Record<string, {
+        entries: number;
+        changed: number;
+        flagged: number;
+        prefixSplit: number;
+        counts: GoldenRelabelCounts;
+    }>;
+    deckPath: string;
+    outputDir: string;
+    totalChanged: number;
+    totalFlagged: number;
+}
+/**
+ * Relabel every `.jsonl` in a golden version dir, writing a new version dir plus a review deck and a MANIFEST that
+ * records the convention, the parent, and the counts. Non-JSONL siblings (README, split manifests) are copied forward
+ * so the new version is self-contained; nested split dirs (`dev/`, `test/`) are relabelled recursively.
+ */
+export declare function relabelGoldenDirectory(options: RelabelGoldenOptions, report?: (line: string) => void): Promise<RelabelGoldenReport>;
+/**
+ * Every relabel class that means the row was left folded, for callers that want to report the residue.
+ */
+export declare function isLeftFolded(rowClass: GoldenRelabelClass): boolean;
+/**
+ * True when a golden dir declares the US-split convention — i.e. it is safe to grade it with an UNFOLDED scorer.
+ */
+export declare function goldenDeclaresSplitStreets(dir: string): boolean;
+//# sourceMappingURL=golden-relabel-street.d.ts.map

package/out/src/tools/golden-relabel-street.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"golden-relabel-street.d.ts","sourceRoot":"","sources":["../../../src/tools/golden-relabel-street.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAcH;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC3B,cAAc,GACd,8BAA8B,GAC9B,mBAAmB,GACnB,eAAe,GACf,cAAc,GACd,oBAAoB,GACpB,2BAA2B,GAC3B,iBAAiB,GACjB,WAAW,GACX,QAAQ,GACR,kBAAkB,CAAA;AAErB;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,mBAAmB,GAAG,eAAe,GAAG,oBAAoB,CAAA;IAClE,MAAM,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC;;OAEG;IACH,GAAG,EAAE,eAAe,CAAA;IACpB,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,KAAK,EAAE,iBAAiB,EAAE,CAAA;IAC1B;;OAEG;IACH,WAAW,EAAE,OAAO,CAAA;IACpB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB;AAkFD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;CACrB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACrC,GAAG,EAAE,eAAe,EACpB,OAAO,GAAE,uBAA4B,GACnC,mBAAmB,CAmIrB;AAQD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAA;AAEpE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,KAAK,EAAE,iBAAiB,EAAE,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,KAAK,EAAE,MAAM,CACZ,MAAM,EACN;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,mBAAmB,CAAA;KAAE,CACvG,CAAA;IACD,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;CACpB;AA0BD;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC3C,OAAO,EAAE,oBAAoB,EAC7B,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkB,GAC1C,OAAO,CAAC,mBAAmB,CAAC,CAgJ9B;AAsDD;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAElE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAY/D"}

package/out/src/tools/golden-relabel-street.js

@@ -0,0 +1,440 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Golden-set street-suffix relabel — v0.1.2 → v0.1.3.
+ *
+ *   ## Why this exists
+ *
+ *   The golden answer key and the training corpus disagreed about ONE thing, and the v9.0.0
+ *   promotion gate read the disagreement as a model regression (`us.street` 87.4 vs a floor of
+ *   87.8). The corpus SPLITS a US street into `street` + `street_suffix` — TIGER's adapter
+ *   decomposes at `corpus/src/adapters/tiger/street-decompose.ts`, the `street-affix` shard recipe
+ *   teaches it from USPS Pub-28, and `ComponentTag` carries `street_suffix` as a first-class tag.
+ *   The golden set FOLDED it: 2,216 US rows carry a `street`, and exactly 2 of them label a
+ *   `street_suffix`. Operator ruling, 2026-08-06: **the split is canonical**; the golden is the
+ *   stale side. This tool moves the answer key onto the corpus convention.
+ *
+ *   ## The instrument
+ *
+ *   `matchTrailingSuffix` from `@mailwoman/codex/us` — the USPS Pub-28 Appendix C table, which is
+ *   also what the corpus shard recipe splits on. The table is NOT re-implemented here, and the
+ *   libpostal dictionary TIGER reads is deliberately not used: measured on this golden set the two
+ *   disagree on 51 US rows, and the disagreements run in the codex table's favour (libpostal's
+ *   `directionals.txt` lists `center|c`, so TIGER reads the `C` of "C STREET" as a directional
+ *   prefix and then emits no suffix at all).
+ *
+ *   ## What it changes, and what it refuses to
+ *
+ *   Applied only to rows whose `country` is `US`. Three branches, mirroring the SHAPE of TIGER's
+ *   `decomposeStreet` on codex tables:
+ *
+ *   - **street type** — the last whitespace-separated word is a Pub-28 suffix, and something is left
+ *       over: "Main St" → `street: "Main"`, `street_suffix: "St"` (1,559 rows).
+ *   - **street type + post-directional** — the last word is a directional AND the one before it is a
+ *       Pub-28 suffix: "Pennsylvania Avenue NW" → `street: "Pennsylvania"`,
+ *       `street_suffix: "Avenue NW"` (347 rows). The post-directional joins the suffix rather than
+ *       becoming a tag of its own, because that is what the corpus adapter emits; there is no
+ *       `street_postfix` tag to move it to.
+ *   - **everything else is left folded** and reported. In particular a BARE post-directional tail
+ *       ("Seymour East", "BROADWAY N" — 16 rows) is NOT split: a directional is not a Pub-28 suffix,
+ *       and the observed rows in that class are unit-contaminated ("1ST AVE SW BOX E", where the
+ *       trailing "E" is a box letter).
+ *
+ *   FR rows are untouched, deliberately and permanently as far as this tool is concerned. French
+ *   street typology puts the type FIRST ("Rue de la Paix") and the golden labels only 7 of 665 FR
+ *   street rows with a `street_prefix`; whether FR should split at all is a different question with
+ *   a different table behind it, and nothing here should be read as having answered it.
+ *
+ *   ## Surface bytes
+ *
+ *   The split is a cut at a whitespace run in the ORIGINAL string — no trimming, no case
+ *   normalization, no re-joining of tokens. `street + gap + street_suffix` reconstructs the input
+ *   byte-for-byte, so the whitespace between them belongs to neither span (the same shape the corpus
+ *   adapter's spans have). The tool asserts this per row and refuses to write a file if it ever
+ *   fails.
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import { isStreetDirectionalToken, matchTrailingSuffix } from "@mailwoman/codex/us";
+import { parseJSONStrict, tryParsingJSON } from "@mailwoman/core/objects";
+import { sha256File } from "@mailwoman/core/utils";
+import { TextSpliterator } from "spliterator";
+import { NAME_PRONE_US_SUFFIXES } from "../name-prone-us-suffixes.js";
+/**
+ * Cut `s` at its LAST whitespace run, returning the three pieces verbatim. Null when there is no interior whitespace,
+ * when the head would be empty, or when `s` carries leading/trailing whitespace (a golden row is stored trimmed; an
+ * untrimmed one is reported rather than silently normalized).
+ */
+function splitLastWord(s) {
+    if (s !== s.trim() || !s)
+        return null;
+    const match = /^(.*\S)(\s+)(\S+)$/.exec(s);
+    if (!match)
+        return null;
+    return { head: match[1], gap: match[2], tail: match[3] };
+}
+/**
+ * Cut `s` at its FIRST whitespace run — the leading-directional counterpart of {@link splitLastWord}. `head` is the
+ * first word, `tail` the rest, both verbatim.
+ */
+function splitFirstWord(s) {
+    if (s !== s.trim() || !s)
+        return null;
+    const match = /^(\S+)(\s+)(\S.*)$/.exec(s);
+    if (!match)
+        return null;
+    return { head: match[1], gap: match[2], tail: match[3] };
+}
+// ── Row-level relabel ──────────────────────────────────────────────────────
+/**
+ * Rebuild `components` with `street_suffix` inserted immediately after `street`, so the written row reads in address
+ * order rather than with the new tag appended at the end.
+ */
+function withStreetSpans(components, spans) {
+    const out = {};
+    for (const [key, value] of Object.entries(components)) {
+        if (key === "street") {
+            if (spans.prefix) {
+                out.street_prefix = spans.prefix;
+            }
+            out.street = spans.street;
+            if (spans.suffix) {
+                out.street_suffix = spans.suffix;
+            }
+            continue;
+        }
+        if (key === "street_prefix" || key === "street_suffix")
+            continue;
+        out[key] = value;
+    }
+    return out;
+}
+/**
+ * Decide, and apply, the US street-span split for ONE golden row. Pure: never mutates its argument, and returns the
+ * same object reference when the row is left alone.
+ */
+export function relabelGoldenStreetRow(row, options = {}) {
+    const splitPrefix = options.splitPrefix ?? true;
+    const keep = (rowClass) => ({
+        row,
+        changed: false,
+        rowClass,
+        flags: [],
+        prefixSplit: false,
+    });
+    if ((row.country ?? "").toUpperCase() !== "US")
+        return keep("not-us");
+    const street = row.components.street;
+    if (!street)
+        return keep("no-street");
+    if (row.components.street_suffix)
+        return keep("already-split");
+    if (street !== street.trim())
+        return keep("untrimmed-street");
+    const flags = [];
+    let rowClass;
+    let name = street;
+    let suffix;
+    let suffixGap = "";
+    let canonical;
+    const cut = splitLastWord(street);
+    if (!cut) {
+        rowClass = matchTrailingSuffix(street) ? "suffix-only-street" : "single-token";
+    }
+    else if (isStreetDirectionalToken(cut.tail)) {
+        // Street type + post-directional ("Pennsylvania Avenue NW"). The corpus adapter emits the pair as
+        // ONE suffix span, and there is no post-directional tag to move it to.
+        const inner = splitLastWord(cut.head);
+        const typeMatch = inner ? matchTrailingSuffix(inner.tail) : null;
+        if (!inner || !typeMatch) {
+            rowClass = "postdirectional-tail-only";
+        }
+        else {
+            rowClass = "split-suffix-postdirectional";
+            name = inner.head;
+            suffix = `${inner.tail}${cut.gap}${cut.tail}`;
+            suffixGap = inner.gap;
+            canonical = typeMatch.canonical;
+        }
+    }
+    else {
+        const typeMatch = matchTrailingSuffix(street);
+        if (!typeMatch) {
+            rowClass = "no-suffix-match";
+        }
+        else {
+            rowClass = "split-suffix";
+            name = cut.head;
+            suffix = cut.tail;
+            suffixGap = cut.gap;
+            canonical = typeMatch.canonical;
+        }
+    }
+    // Leading directional → street_prefix, on whatever name survived the suffix move. Independent of the
+    // suffix branch, because "N Main" is as folded as "N Main St" is.
+    let prefix;
+    let prefixGap = "";
+    if (splitPrefix && !row.components.street_prefix) {
+        const lead = splitFirstWord(name);
+        if (lead && isStreetDirectionalToken(lead.head)) {
+            prefix = lead.head;
+            prefixGap = lead.gap;
+            name = lead.tail;
+        }
+    }
+    if (!suffix && !prefix)
+        return keep(rowClass);
+    if (!suffix) {
+        rowClass = "split-prefix-only";
+    }
+    // The invariant this tool exists to keep: the spans plus the whitespace between them ARE the original
+    // span, byte for byte. Anything else means a token was rewritten.
+    const rebuilt = `${prefix ? prefix + prefixGap : ""}${name}${suffix ? suffixGap + suffix : ""}`;
+    if (rebuilt !== street) {
+        throw new Error(`golden-relabel: span reconstruction failed for ${JSON.stringify(street)}`);
+    }
+    if (canonical && NAME_PRONE_US_SUFFIXES.has(canonical)) {
+        flags.push({
+            kind: "name-prone-suffix",
+            detail: `${canonical} heads proper names as often as street types`,
+        });
+    }
+    const venue = row.components.venue;
+    if (suffix && venue && new RegExp(`(^|\\W)${escapeRegExp(suffix)}(\\W|$)`, "i").test(venue)) {
+        flags.push({
+            kind: "venue-context",
+            detail: `venue ${JSON.stringify(venue)} also carries ${JSON.stringify(suffix)}`,
+        });
+    }
+    // Narrow on purpose: a name that happens to be a Pub-28 canonical is NOT interesting ("Mountain Rd",
+    // "Valley Dr", "Mills Ln" are ordinary streets, and flagging them buried the deck — 108 rows of noise
+    // on the first run). A name that is a bare DIRECTIONAL is: "East Rd" leaves `street: "East"`, which is
+    // a direction, not a name.
+    if (isStreetDirectionalToken(name)) {
+        flags.push({
+            kind: "remainder-is-affix",
+            detail: `street would become the bare directional ${JSON.stringify(name)}`,
+        });
+    }
+    return {
+        row: {
+            ...row,
+            components: withStreetSpans(row.components, {
+                ...(prefix ? { prefix } : row.components.street_prefix ? { prefix: row.components.street_prefix } : {}),
+                street: name,
+                ...(suffix ? { suffix } : {}),
+            }),
+        },
+        changed: true,
+        rowClass,
+        flags,
+        prefixSplit: Boolean(prefix),
+        beforeStreet: street,
+    };
+}
+function escapeRegExp(s) {
+    return s.replaceAll(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+const EMPTY_COUNTS = () => ({
+    "split-suffix": 0,
+    "split-suffix-postdirectional": 0,
+    "split-prefix-only": 0,
+    "already-split": 0,
+    "single-token": 0,
+    "suffix-only-street": 0,
+    "postdirectional-tail-only": 0,
+    "no-suffix-match": 0,
+    "no-street": 0,
+    "not-us": 0,
+    "untrimmed-street": 0,
+});
+/**
+ * Classes that are LEFT FOLDED but still belong in the deck, because the operator asked to see them by name: a street
+ * that is entirely one suffix word, and a bare post-directional tail.
+ */
+const DECK_WORTHY_UNCHANGED = new Set([
+    "suffix-only-street",
+    "postdirectional-tail-only",
+    "untrimmed-street",
+]);
+/**
+ * Relabel every `.jsonl` in a golden version dir, writing a new version dir plus a review deck and a MANIFEST that
+ * records the convention, the parent, and the counts. Non-JSONL siblings (README, split manifests) are copied forward
+ * so the new version is self-contained; nested split dirs (`dev/`, `test/`) are relabelled recursively.
+ */
+export async function relabelGoldenDirectory(options, report = console.log) {
+    const { input, output } = options;
+    const deckPath = options.deck ?? join(output, "REVIEW-DECK.jsonl");
+    mkdirSync(output, { recursive: true });
+    const deck = [];
+    const files = {};
+    const walk = (dirIn, dirOut, prefix) => {
+        mkdirSync(dirOut, { recursive: true });
+        for (const name of readdirSync(dirIn, { withFileTypes: true })) {
+            const from = join(dirIn, name.name);
+            const to = join(dirOut, name.name);
+            if (name.isDirectory()) {
+                walk(from, to, `${prefix}${name.name}/`);
+                continue;
+            }
+            if (!name.name.endsWith(".jsonl")) {
+                // MANIFEST is rewritten below; everything else (README, SPLIT-MANIFEST) rides forward.
+                if (name.name !== "MANIFEST.json") {
+                    writeFileSync(to, readFileSync(from));
+                }
+                continue;
+            }
+            const counts = EMPTY_COUNTS();
+            let changed = 0;
+            let flagged = 0;
+            let prefixSplit = 0;
+            const out = [];
+            let lineNumber = 0;
+            for (const line of TextSpliterator.from(readFileSync(from, "utf8"))) {
+                if (!line.trim())
+                    continue;
+                lineNumber++;
+                // A corrupt answer-key line must STOP the relabel, not silently drop a row — a golden file
+                // short by one row is a floor cut against a different denominator.
+                const row = parseJSONStrict(line);
+                const result = relabelGoldenStreetRow(row, { splitPrefix: options.splitPrefix ?? true });
+                counts[result.rowClass]++;
+                if (result.changed) {
+                    changed++;
+                }
+                if (result.prefixSplit) {
+                    prefixSplit++;
+                }
+                if (result.flags.length) {
+                    flagged++;
+                }
+                if (result.changed || DECK_WORTHY_UNCHANGED.has(result.rowClass)) {
+                    deck.push({
+                        file: `${prefix}${name.name}`,
+                        line: lineNumber,
+                        raw: row.raw,
+                        rowClass: result.rowClass,
+                        before: row.components,
+                        after: result.row.components,
+                        flags: result.flags,
+                    });
+                }
+                out.push(JSON.stringify(result.row));
+            }
+            writeFileSync(to, out.join("\n") + "\n");
+            files[`${prefix}${name.name}`] = { entries: lineNumber, changed, flagged, prefixSplit, counts };
+            report(`  ${prefix}${name.name}: ${lineNumber} rows, ${changed} changed (${prefixSplit} with a prefix lift), ${flagged} flagged`);
+        }
+    };
+    report(`relabel ${input} → ${output}`);
+    walk(input, output, "");
+    writeFileSync(deckPath, deck.map((entry) => JSON.stringify(entry)).join("\n") + "\n");
+    writeFileSync(deckPath.replace(/\.jsonl$/, ".md"), renderDeckMarkdown(deck, basename(input), basename(output)));
+    const manifestFiles = {};
+    for (const [name, stats] of Object.entries(files)) {
+        manifestFiles[name] = {
+            entries: stats.entries,
+            sha256: await sha256File(join(output, name)),
+            changed: stats.changed,
+            flagged: stats.flagged,
+            prefix_split: stats.prefixSplit,
+        };
+    }
+    const totalChanged = Object.values(files).reduce((n, f) => n + f.changed, 0);
+    const totalFlagged = Object.values(files).reduce((n, f) => n + f.flagged, 0);
+    const manifest = {
+        version: basename(output),
+        parent: options.parentLabel ?? basename(input),
+        generated_at: new Date().toISOString(),
+        tool: "corpus/src/tools/golden-relabel-street.ts (mailwoman corpus golden-relabel)",
+        ...(options.commit ? { commit: options.commit } : {}),
+        convention: {
+            street_convention: { US: "split", "*": "folded" },
+            declared: "US street spans are labeled SPLIT: a leading directional is its own `street_prefix` span, the Pub-28 " +
+                "street type (plus a post-directional, when one trails it) is its own `street_suffix` span, and `street` " +
+                "carries only the name. Non-US rows keep the folded convention of the parent version. A scorer that " +
+                "folds `street_prefix`/`street`/`street_suffix` back together before comparing is NOT grading this " +
+                "answer key.",
+            instrument: "@mailwoman/codex/us — matchTrailingSuffix (USPS Pub-28 Appendix C) for the type, " +
+                "isStreetDirectionalToken for the directionals",
+            left_folded: "single-token streets, streets that are entirely one suffix word, bare post-directional tails, and any " +
+                "street whose trailing word is not in the Pub-28 table",
+            prefix_split: options.splitPrefix ?? true,
+        },
+        counts: {
+            changed: totalChanged,
+            flagged: totalFlagged,
+            prefix_split: Object.values(files).reduce((n, f) => n + f.prefixSplit, 0),
+            per_file: Object.fromEntries(Object.entries(files).map(([name, stats]) => [name, stats.counts])),
+        },
+        files: manifestFiles,
+        review_deck: basename(deckPath),
+    };
+    writeFileSync(join(output, "MANIFEST.json"), JSON.stringify(manifest, null, "\t") + "\n");
+    report(`✓ ${totalChanged} rows split, ${totalFlagged} flagged — deck at ${deckPath}`);
+    return { files, deckPath, outputDir: output, totalChanged, totalFlagged };
+}
+/**
+ * Render the operator-facing half of the review deck: the flagged rows first (those are the ones asking for a ruling),
+ * then the classes the tool LEFT FOLDED by name, then a sample of the ordinary corrections. The JSONL sibling carries
+ * every row; this file is the one a human reads.
+ */
+function renderDeckMarkdown(deck, parent, version) {
+    const span = (components) => [components.street_prefix, components.street, components.street_suffix]
+        .filter(Boolean)
+        .map((s) => JSON.stringify(s))
+        .join(" + ");
+    // The split dirs are copies of the same rows — dedupe the deck to the top-level files for reading.
+    const top = deck.filter((entry) => !entry.file.includes("/"));
+    const flagged = top.filter((entry) => entry.flags.length);
+    const folded = top.filter((entry) => isLeftFolded(entry.rowClass));
+    const plain = top.filter((entry) => !entry.flags.length && !isLeftFolded(entry.rowClass));
+    const rows = (entries) => entries
+        .map((entry) => `| ${entry.file}:${entry.line} | ${span(entry.before)} | ${span(entry.after)} | ${entry.flags.map((f) => f.kind).join(", ") || "—"} | ${JSON.stringify(entry.raw)} |`)
+        .join("\n");
+    const header = "| row | before | after | flags | raw |\n|---|---|---|---|---|";
+    return [
+        `# Golden street-suffix relabel review deck — ${parent} → ${version}`,
+        "",
+        "Rows are deduped to the top-level files (`dev/` and `test/` carry the same rows).",
+        "A flag is a REVIEW TRIGGER, not an adjudication: the split below is already applied.",
+        "",
+        `## Flagged (${flagged.length}) — needs a ruling`,
+        "",
+        header,
+        rows(flagged),
+        "",
+        `## Left folded (${folded.length}) — the tool declined to split these`,
+        "",
+        header,
+        rows(folded),
+        "",
+        `## Ordinary corrections (${plain.length}) — first 100 shown; the JSONL deck has all`,
+        "",
+        header,
+        rows(plain.slice(0, 100)),
+        "",
+    ].join("\n");
+}
+/**
+ * Every relabel class that means the row was left folded, for callers that want to report the residue.
+ */
+export function isLeftFolded(rowClass) {
+    return rowClass !== "split-suffix" && rowClass !== "split-suffix-postdirectional" && rowClass !== "split-prefix-only";
+}
+/**
+ * True when a golden dir declares the US-split convention — i.e. it is safe to grade it with an UNFOLDED scorer.
+ */
+export function goldenDeclaresSplitStreets(dir) {
+    for (const candidate of [join(dir, "MANIFEST.json"), join(dir, "..", "MANIFEST.json")]) {
+        if (!existsSync(candidate))
+            continue;
+        const manifest = tryParsingJSON(readFileSync(candidate, "utf8"));
+        if (manifest?.convention?.street_convention?.US === "split")
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=golden-relabel-street.js.map

package/out/src/tools/golden-relabel-street.js.map

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