@mailwoman/corpus 9.2.0 → 9.4.0

package/out/env.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ * Environment variables the corpus build and its acquisition tooling read.
+ */
+import { z } from "zod";
+/**
+ * Corpus build settings.
+ */
+export declare const PublicCorpusEnvSchema: z.ZodObject<{
+    MAILWOMAN_RESUME: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Credentials the corpus acquisition and golden-expansion tooling send. Never log their values.
+ */
+export declare const PrivateCorpusEnvSchema: z.ZodObject<{
+    OA_BATCH_TOKEN: z.ZodOptional<z.ZodString>;
+    DEEPSEEK_API_KEY: z.ZodOptional<z.ZodString>;
+    ANTHROPIC_API_KEY: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Live corpus settings over core's, sharing core's getters and cached values.
+ */
+export declare const $public: Record<never, never> & {
+    MAILWOMAN_DATA_ROOT: string;
+    MAILWOMAN_CONFIG_ROOT: string;
+    MAILWOMAN_CACHE_ROOT: string;
+    MAILWOMAN_TEMP_ROOT: string;
+    MAILWOMAN_DOCS_URL?: string | undefined;
+    MAILWOMAN_LICENSE_KEY?: string | undefined;
+    MAILWOMAN_LICENSE_URL?: string | undefined;
+    MAILWOMAN_COARSE_PLACER_DIR?: string | undefined;
+} & {
+    MAILWOMAN_RESUME?: string | undefined;
+};
+/**
+ * Live corpus credentials over core's. Never log their values.
+ */
+export declare const $private: Record<never, never> & Record<string, never> & {
+    OA_BATCH_TOKEN?: string | undefined;
+    DEEPSEEK_API_KEY?: string | undefined;
+    ANTHROPIC_API_KEY?: string | undefined;
+};
+//# sourceMappingURL=env.d.ts.map

package/out/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../lib/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;GAEG;AACH,eAAO,MAAM,qBAAqB;;iBAKhC,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;iBAejC,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;CAA6C,CAAA;AAEjE;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;CAA+C,CAAA"}

package/out/env.js

@@ -0,0 +1,46 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ * Environment variables the corpus build and its acquisition tooling read.
+ */
+import { $private as corePrivate, $public as corePublic, liveEnv } from "@mailwoman/core/env";
+import { z } from "zod";
+/**
+ * Corpus build settings.
+ */
+export const PublicCorpusEnvSchema = z.object({
+    MAILWOMAN_RESUME: z.string().optional().meta({
+        title: "Build resume",
+        description: "Resume-state override used by corpus build tooling.",
+    }),
+});
+/**
+ * Credentials the corpus acquisition and golden-expansion tooling send. Never log their values.
+ */
+export const PrivateCorpusEnvSchema = z.object({
+    // OpenAddresses batch-download API token (`corpus/lib/tools/fetch/openaddresses.ts`).
+    OA_BATCH_TOKEN: z.string().optional().meta({
+        title: "OpenAddresses batch token",
+        description: "API token used by the OpenAddresses batch-download corpus fetcher.",
+    }),
+    // LLM API keys for the corpus golden-expansion tooling.
+    DEEPSEEK_API_KEY: z.string().optional().meta({
+        title: "DeepSeek API key",
+        description: "API key used by corpus golden-expansion tooling when calling DeepSeek.",
+    }),
+    ANTHROPIC_API_KEY: z.string().optional().meta({
+        title: "Anthropic API key",
+        description: "API key used by corpus golden-expansion tooling when calling Anthropic.",
+    }),
+});
+/**
+ * Live corpus settings over core's, sharing core's getters and cached values.
+ */
+export const $public = liveEnv(PublicCorpusEnvSchema, corePublic);
+/**
+ * Live corpus credentials over core's. Never log their values.
+ */
+export const $private = liveEnv(PrivateCorpusEnvSchema, corePrivate);
+//# sourceMappingURL=env.js.map

package/out/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../lib/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,IAAI,WAAW,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC;QAC5C,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,qDAAqD;KAClE,CAAC;CACF,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,sFAAsF;IACtF,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC;QAC1C,KAAK,EAAE,2BAA2B;QAClC,WAAW,EAAE,oEAAoE;KACjF,CAAC;IACF,wDAAwD;IACxD,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC;QAC5C,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,wEAAwE;KACrF,CAAC;IACF,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC;QAC7C,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,yEAAyE;KACtF,CAAC;CACF,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,qBAAqB,EAAE,UAAU,CAAC,CAAA;AAEjE;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC,sBAAsB,EAAE,WAAW,CAAC,CAAA"}

package/out/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export * from "#adapters/utils/index";
+export * from "#adapters/gnaf/assemble";
+export * from "#adapters/index";
+export * from "#build";
+export * from "#runner";
+export * from "#recipes/index";
+export * from "#types";
+//# sourceMappingURL=index.d.ts.map

package/out/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,uBAAuB,CAAA;AACrC,cAAc,yBAAyB,CAAA;AACvC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,QAAQ,CAAA;AACtB,cAAc,SAAS,CAAA;AACvB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,QAAQ,CAAA"}

package/out/index.js

@@ -0,0 +1,13 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export * from "#adapters/utils/index";
+export * from "#adapters/gnaf/assemble";
+export * from "#adapters/index";
+export * from "#build";
+export * from "#runner";
+export * from "#recipes/index";
+export * from "#types";
+//# sourceMappingURL=index.js.map

package/out/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,uBAAuB,CAAA;AACrC,cAAc,yBAAyB,CAAA;AACvC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,QAAQ,CAAA;AACtB,cAAc,SAAS,CAAA;AACvB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,QAAQ,CAAA"}

package/out/recipes/anchor-absorption.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `anchor-absorption` slice recipe (#220/#723, Probe A1) — self-generates `--count` rows from
+ *   {@link synthesizeAnchorAbsorptionRow}'s 6-slice mix (CASE-H / CASE-P-us-rural / CASE-P-de /
+ *   anchor-fp / locale-ambig / standard), aligns each to BIO, and emits a labeled JSONL. The
+ *   LEADING 5-digit on CASE-H/anchor-fp/locale-ambig is sampled from the REAL US ZIPs in the
+ *   postcode-anchor lookup, so the shaped-painted anchor fires on it exactly as inference does —
+ *   teaching the model to OVERRIDE a present anchor from context. Ported from
+ *   scripts/build-anchor-absorption-slice.mjs.
+ */
+import { type CorpusRecipe } from "#recipes/scaffold";
+/**
+ * Slice recipe registered with the corpus builder — see the file header for the parse behaviour it exists to exercise,
+ * and `description` below for the surface form it generates.
+ */
+export declare const anchorAbsorptionRecipe: CorpusRecipe;
+//# sourceMappingURL=anchor-absorption.d.ts.map

package/out/recipes/anchor-absorption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor-absorption.d.ts","sourceRoot":"","sources":["../../lib/recipes/anchor-absorption.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAyBpE;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,YAoDpC,CAAA"}

package/out/recipes/anchor-absorption.js

@@ -0,0 +1,82 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `anchor-absorption` slice recipe (#220/#723, Probe A1) — self-generates `--count` rows from
+ *   {@link synthesizeAnchorAbsorptionRow}'s 6-slice mix (CASE-H / CASE-P-us-rural / CASE-P-de /
+ *   anchor-fp / locale-ambig / standard), aligns each to BIO, and emits a labeled JSONL. The
+ *   LEADING 5-digit on CASE-H/anchor-fp/locale-ambig is sampled from the REAL US ZIPs in the
+ *   postcode-anchor lookup, so the shaped-painted anchor fires on it exactly as inference does —
+ *   teaching the model to OVERRIDE a present anchor from context. Ported from
+ *   scripts/build-anchor-absorption-slice.mjs.
+ */
+import { dataRootPath } from "@mailwoman/core/data-root";
+import { readLocalJSONFile } from "@mailwoman/core/fs/readers";
+import { makeLcg } from "@mailwoman/core/utils";
+import { sliceSourceID } from "#recipes/scaffold";
+import { synthesizeAnchorAbsorptionRow } from "#synthesizers/anchor-absorption";
+import { alignRow } from "#utils";
+/**
+ * The leading-5-digit source: the real US ZIPs in the postcode anchor's pilot lookup. Resolved through the data-root
+ * helper (the lab default is `$MAILWOMAN_DATA_ROOT`), never re-hardcoded.
+ */
+const ANCHOR_LOOKUP = dataRootPath("anchor", "pilot-anchor-lookup.json");
+/**
+ * The real US ZIPs in the anchor lookup (entries whose value is a `[{ US: … }]` candidate list).
+ */
+async function loadRealUsZips(path) {
+    const d = await readLocalJSONFile(path);
+    const zips = [];
+    for (const [pc, v] of Object.entries(d)) {
+        if (Array.isArray(v) && v[0] && typeof v[0] === "object" && "US" in v[0] && /^\d{5}$/.test(pc)) {
+            zips.push(pc);
+        }
+    }
+    return zips;
+}
+/**
+ * Slice recipe registered with the corpus builder — see the file header for the parse behaviour it exists to exercise,
+ * and `description` below for the surface form it generates.
+ */
+export const anchorAbsorptionRecipe = {
+    name: "anchor-absorption",
+    description: "Anchor-absorption counter-augmentation (#220/#723): 6-slice mix → synthesizeAnchorAbsorptionRow",
+    mode: "generate",
+    async run(opts, write) {
+        // Emit PRNG: the legacy build-anchor-absorption-slice.mjs seeded an LCG (lcg(opts.seed)).
+        const random = makeLcg(opts.seed);
+        const source = opts.sourceName ?? "synth-anchor-absorption";
+        const count = opts.count ?? 50_000;
+        const realZips = await loadRealUsZips(ANCHOR_LOOKUP);
+        console.error(`Loaded ${realZips.length} real US ZIPs from the anchor lookup (the leading-5-digit source).`);
+        let written = 0;
+        let quarantined = 0;
+        const byTemplate = {};
+        for (let i = 0; i < count; i++) {
+            const synth = synthesizeAnchorAbsorptionRow({ random, realZips });
+            const country = synth.locale.split("-")[1];
+            // "en-US" -> "US", "de-DE" -> "DE"
+            const canonical = {
+                raw: synth.raw,
+                components: synth.components,
+                country,
+                locale: synth.locale,
+                source,
+                source_id: sliceSourceID(source, { v: String(i) }),
+            };
+            const aligned = alignRow(canonical);
+            if (aligned.kind !== "labeled") {
+                quarantined++;
+                continue;
+            }
+            write(JSON.stringify({ ...aligned.row, synth_method: "anchor-absorption", synth_template: synth.template }) + "\n");
+            written++;
+            byTemplate[synth.template] = (byTemplate[synth.template] ?? 0) + 1;
+        }
+        console.error(`\nwrote ${written} rows (${quarantined} quarantined)`);
+        console.error("  by slice:", JSON.stringify(byTemplate));
+        return { emitted: written, skipped: quarantined };
+    },
+};
+//# sourceMappingURL=anchor-absorption.js.map

package/out/recipes/anchor-absorption.js.map

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

package/out/recipes/bare-country.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `bare-country` — the country name as the WHOLE query. Addresses almost never consist of one bare
+ *   country name, so the class is out of the model's training distribution and the tag is a coin
+ *   flip: measured on the 2026-08-13 panel, France/Germany/United States/New Zealand parsed
+ *   `country` while Japan/China/Nigeria/Australia/Deutschland parsed `locality`. The retrieval-side
+ *   bare-country race (#1651) covers the answer either way; this slice closes the PARSE half so the
+ *   tag itself is right.
+ *
+ *   Source is the codex country table — every ISO canonical English name plus the curated surface
+ *   forms (endonyms and long-form names). The 2–3 letter CODES are deliberately excluded: a bare
+ *   `JP` or `GER` is an abbreviation register with its own ambiguity surface (`IN`, `DE`, `TO` are
+ *   English words), and teaching it here would be an unmeasured claim. Case augmentation is the
+ *   loader's job, as everywhere.
+ */
+import { type CorpusRecipe } from "#recipes/scaffold";
+/**
+ * Slice recipe registered with the corpus builder — see the file header for the parse behaviour it exists to exercise,
+ * and `description` below for the surface form it generates.
+ */
+export declare const bareCountryRecipe: CorpusRecipe;
+//# sourceMappingURL=bare-country.d.ts.map

package/out/recipes/bare-country.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bare-country.d.ts","sourceRoot":"","sources":["../../lib/recipes/bare-country.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,EAAiB,KAAK,YAAY,EAAiB,MAAM,mBAAmB,CAAA;AA+BnF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,YAqC/B,CAAA"}

package/out/recipes/bare-country.js

@@ -0,0 +1,88 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `bare-country` — the country name as the WHOLE query. Addresses almost never consist of one bare
+ *   country name, so the class is out of the model's training distribution and the tag is a coin
+ *   flip: measured on the 2026-08-13 panel, France/Germany/United States/New Zealand parsed
+ *   `country` while Japan/China/Nigeria/Australia/Deutschland parsed `locality`. The retrieval-side
+ *   bare-country race (#1651) covers the answer either way; this slice closes the PARSE half so the
+ *   tag itself is right.
+ *
+ *   Source is the codex country table — every ISO canonical English name plus the curated surface
+ *   forms (endonyms and long-form names). The 2–3 letter CODES are deliberately excluded: a bare
+ *   `JP` or `GER` is an abbreviation register with its own ambiguity surface (`IN`, `DE`, `TO` are
+ *   English words), and teaching it here would be an unmeasured claim. Case augmentation is the
+ *   loader's job, as everywhere.
+ */
+import { COUNTRY_SURFACE_FORMS, CountryNames, matchCountry } from "@mailwoman/codex/country";
+import { mulberry32 as makeMulberry32 } from "@mailwoman/core/utils";
+import { alignAndWrite, sliceSourceID } from "#recipes/scaffold";
+/**
+ * Surfaces shorter than this are the code register (`JP`, `GER`), not a name — excluded (see the module doc).
+ */
+const MIN_NAME_LENGTH = 4;
+/**
+ * Every (surface, iso2) pair the slice emits: the ISO canonical names plus each country's curated surface forms,
+ * deduplicated on the surface string (a form shared across countries — none known — would keep its first bearer).
+ */
+function* bareCountrySurfaces() {
+    const seen = new Set();
+    for (const [iso2, forms] of Object.entries(COUNTRY_SURFACE_FORMS)) {
+        for (const surface of forms) {
+            if (surface.length < MIN_NAME_LENGTH || seen.has(surface))
+                continue;
+            seen.add(surface);
+            yield { surface, iso2 };
+        }
+    }
+    for (const name of CountryNames) {
+        if (name.length < MIN_NAME_LENGTH || seen.has(name))
+            continue;
+        const matched = matchCountry(name);
+        if (!matched)
+            continue;
+        seen.add(name);
+        yield { surface: name, iso2: matched.iso2 };
+    }
+}
+/**
+ * Slice recipe registered with the corpus builder — see the file header for the parse behaviour it exists to exercise,
+ * and `description` below for the surface form it generates.
+ */
+export const bareCountryRecipe = {
+    name: "bare-country",
+    description: "The country name as the whole query (#1651 parse half): ISO names + curated endonyms, no codes",
+    mode: "generate",
+    async run(opts, write) {
+        // Seeded for parity with the other recipes; the surfaces themselves drive the content.
+        makeMulberry32(opts.seed);
+        let read = 0;
+        let emitted = 0;
+        let skipped = 0;
+        for (const { surface, iso2 } of bareCountrySurfaces()) {
+            read++;
+            const components = { country: surface };
+            const source_id = sliceSourceID("synth-bare-country", { country: surface, cc: iso2, v: String(read) });
+            const canonical = {
+                raw: surface,
+                components,
+                country: iso2,
+                locale: "und",
+                source: "synth-bare-country",
+                source_id,
+                corpus_version: "0.11.0",
+                license: "Synthetic — bare-country; surfaces from the codex country table (ISO 3166 + curated forms)",
+            };
+            if (alignAndWrite(write, canonical, "bare-country")) {
+                emitted++;
+            }
+            else {
+                skipped++;
+            }
+        }
+        return { read, emitted, skipped };
+    },
+};
+//# sourceMappingURL=bare-country.js.map

package/out/recipes/bare-country.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bare-country.js","sourceRoot":"","sources":["../../lib/recipes/bare-country.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5F,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAEpE,OAAO,EAAE,aAAa,EAAqB,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACnF;;GAEG;AACH,MAAM,eAAe,GAAG,CAAC,CAAA;AAEzB;;;GAGG;AACH,QAAQ,CAAC,CAAC,mBAAmB;IAC5B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAE9B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,EAAE,CAAC;QACnE,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;YAC7B,IAAI,OAAO,CAAC,MAAM,GAAG,eAAe,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;gBAAE,SAAQ;YACnE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACjB,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QACxB,CAAC;IACF,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,MAAM,GAAG,eAAe,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAQ;QAC7D,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;QAElC,IAAI,CAAC,OAAO;YAAE,SAAQ;QACtB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACd,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAA;IAC5C,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAiB;IAC9C,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,gGAAgG;IAC7G,IAAI,EAAE,UAAU;IAChB,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK;QACpB,uFAAuF;QACvF,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACzB,IAAI,IAAI,GAAG,CAAC,CAAA;QACZ,IAAI,OAAO,GAAG,CAAC,CAAA;QACf,IAAI,OAAO,GAAG,CAAC,CAAA;QAEf,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,mBAAmB,EAAE,EAAE,CAAC;YACvD,IAAI,EAAE,CAAA;YAEN,MAAM,UAAU,GAA2B,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;YAC/D,MAAM,SAAS,GAAG,aAAa,CAAC,oBAAoB,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAEtG,MAAM,SAAS,GAAG;gBACjB,GAAG,EAAE,OAAO;gBACZ,UAAU;gBACV,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE,oBAAoB;gBAC5B,SAAS;gBACT,cAAc,EAAE,QAAQ;gBACxB,OAAO,EAAE,4FAA4F;aACrG,CAAA;YAED,IAAI,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,cAAc,CAAC,EAAE,CAAC;gBACrD,OAAO,EAAE,CAAA;YACV,CAAC;iBAAM,CAAC;gBACP,OAAO,EAAE,CAAA;YACV,CAAC;QACF,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;IAClC,CAAC;CACD,CAAA"}

package/out/recipes/boundary-stress.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `boundary-stress` slice recipe (#375) — the boundary-instability augmentation. Self-generates
+ *   `--count` rows from {@link synthesizeBoundaryStressRow}'s weighted template mix (the v1.7.0,
+ *   DeepSeek-tuned 2026-06-18 composition), aligns each to BIO, and emits a labeled JSONL. The
+ *   change for the taxonomy's #1 parser family (the boundary-wobble class). Ported from
+ *   scripts/build-boundary-stress-slice.mjs.
+ *
+ *   `synthesizeBoundaryStressRow` is NOT re-exported from the corpus index — imported directly here.
+ */
+import { type CorpusRecipe } from "#recipes/scaffold";
+/**
+ * Slice recipe registered with the corpus builder — see the file header for the parse behaviour it exists to exercise,
+ * and `description` below for the surface form it generates.
+ */
+export declare const boundaryStressRecipe: CorpusRecipe;
+//# sourceMappingURL=boundary-stress.d.ts.map

package/out/recipes/boundary-stress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary-stress.d.ts","sourceRoot":"","sources":["../../lib/recipes/boundary-stress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,mBAAmB,CAAA;AAoCpE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,YA6ClC,CAAA"}

package/out/recipes/boundary-stress.js

@@ -0,0 +1,84 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `boundary-stress` slice recipe (#375) — the boundary-instability augmentation. Self-generates
+ *   `--count` rows from {@link synthesizeBoundaryStressRow}'s weighted template mix (the v1.7.0,
+ *   DeepSeek-tuned 2026-06-18 composition), aligns each to BIO, and emits a labeled JSONL. The
+ *   change for the taxonomy's #1 parser family (the boundary-wobble class). Ported from
+ *   scripts/build-boundary-stress-slice.mjs.
+ *
+ *   `synthesizeBoundaryStressRow` is NOT re-exported from the corpus index — imported directly here.
+ */
+import { mulberry32 as makeMulberry32 } from "@mailwoman/core/utils";
+import { sliceSourceID } from "#recipes/scaffold";
+import { synthesizeBoundaryStressRow } from "#synthesizers/boundary-stress";
+import { alignRow } from "#utils";
+/**
+ * Revised composition (v1.7.0, DeepSeek-tuned 2026-06-18): `bare-locality` ~11% (recover the 84% locality drop on bare
+ * "City, STATE" rows WITHOUT becoming a locality-first majority), and house-number-before:after = 7:3 (FR's dominant
+ * order is number-BEFORE; 30% after breaks the order-bias shortcut without risking FR hn-before accuracy). The three
+ * original non-number shapes keep the bulk. Weights sum to 1.0. Key order is required — it drives the cumulative
+ * thresholds below.
+ */
+const WEIGHTS = {
+    "street-eats-affix": 0.22,
+    "comma-less-city-state": 0.22,
+    "fr-prefix": 0.18,
+    "bare-locality": 0.11,
+    "house-number-before-street": 0.189,
+    "house-number-after-street": 0.081,
+};
+const CUM = (() => {
+    let acc = 0;
+    return Object.entries(WEIGHTS).map(([t, w]) => [t, (acc += w)]);
+})();
+function pickTemplate(r) {
+    const x = r();
+    for (const [t, c] of CUM)
+        if (x <= c)
+            return t;
+    return CUM.at(-1)[0];
+}
+/**
+ * Slice recipe registered with the corpus builder — see the file header for the parse behaviour it exists to exercise,
+ * and `description` below for the surface form it generates.
+ */
+export const boundaryStressRecipe = {
+    name: "boundary-stress",
+    description: "Boundary-instability rows (#375): weighted template mix → synthesizeBoundaryStressRow → aligned BIO",
+    mode: "generate",
+    async run(opts, write) {
+        // Emit PRNG: the legacy build-boundary-stress-slice.mjs seeded mulberry32(opts.seed).
+        const random = makeMulberry32(opts.seed);
+        const count = opts.count ?? 20_000;
+        let emitted = 0;
+        let skipped = 0;
+        for (let i = 0; i < count; i++) {
+            const row = synthesizeBoundaryStressRow(undefined, { random, forceTemplate: pickTemplate(random) });
+            const country = row.locale.split("-")[1] ?? "US";
+            const source_id = sliceSourceID("synth-boundary-stress", { ...row.components, v: String(i) });
+            const canonical = {
+                raw: row.raw,
+                components: row.components,
+                country,
+                locale: row.locale,
+                source: "synth-boundary-stress",
+                source_id,
+                corpus_version: "0.6.0",
+                license: "Synthetic — boundary-stress; derived from public-domain locality/region tuples",
+            };
+            const aligned = alignRow(canonical);
+            if (aligned.kind !== "labeled") {
+                skipped++;
+                continue;
+            }
+            // Match the base corpus parquet schema: flat synth_method / synth_base_id, not a nested `synth`.
+            write(JSON.stringify({ ...aligned.row, synth_method: `boundary-stress:${row.template}`, synth_base_id: null }) + "\n");
+            emitted++;
+        }
+        return { emitted, skipped };
+    },
+};
+//# sourceMappingURL=boundary-stress.js.map

package/out/recipes/boundary-stress.js.map

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

package/out/recipes/cn-organizational-units.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file `cn-organizational-units` recipe (#2034) — real CN address strings whose settlement is an ORGANIZATIONAL
+ *   ladder (`赵光三分场二十九队`: the Zhaoguang farm, No. 3 sub-farm, No. 29 production team), labeled by rule and aligned
+ *   character by character for the CJK sibling model.
+ *
+ *   THE LABELS ARE A READING OF THE SUFFIX, NOT A GUESS. Every generic that ends an ordinal unit (`分场`, `大队`, `队`,
+ *   `连`, `团`, `组`, `场部`) is in `@mailwoman/core/locale/zh-cn-units`' one table, and the same table reads the span back
+ *   after decode. The whole ordinal chain is ONE `locality_unit` span; the named head it belongs to (`赵光`, `孟定农场`) is
+ *   `dependent_locality`; a province, city or county written in front of it takes `region`, `locality`, `subregion`; a
+ *   Latin admin tail (`, Heilongjiang, China`) takes `region` and `country`. A row with no chain is skipped, not labeled:
+ *   `红卫大队` is a village name whose generic carries no ordinal, and `苗辽林场` is a named forest farm.
+ *
+ *   WHERE THE ROWS COME FROM. `--input` is a JSONL of `{ raw, country }` rows — the shape of `data/coarse-placer/*.jsonl`,
+ *   whose 50,000 CN rows hold 328 with unit vocabulary. That file is a local artifact and carries no per-row source; the
+ *   `<name>, <admin1>, <country>` shape is the corpus's GeoNames adapter's, so the rows are stamped with GeoNames'
+ *   licence and the inference is stated in the `license` field rather than hidden behind it.
+ *
+ *   FOR THE CJK MODEL ONLY. The tokenizer is {@link cjkAwareTokenizer}: one token per Han character, because the
+ *   whitespace tokenizer reads `三分场八队` as one word and could never give it two labels. The Latin model never trains
+ *   on this recipe's rows; its label set has no `locality_unit`.
+ */
+import { type CorpusRecipe } from "#recipes/scaffold";
+/**
+ * The components a row's string supports, every value a verbatim substring of `raw`, or `null` when the string carries
+ * no organizational chain and so teaches nothing this recipe exists for.
+ */
+export declare function labelCNOrganizationalRow(raw: string): Record<string, string> | null;
+/**
+ * Slice recipe registered with the corpus builder — see the file header for the rows it labels and why every label is a
+ * reading of a generic rather than a guess.
+ */
+export declare const cnOrganizationalUnitsRecipe: CorpusRecipe;
+//# sourceMappingURL=cn-organizational-units.d.ts.map

package/out/recipes/cn-organizational-units.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn-organizational-units.d.ts","sourceRoot":"","sources":["../../lib/recipes/cn-organizational-units.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,EAAE,KAAK,YAAY,EAA6B,MAAM,mBAAmB,CAAA;AAmBhF;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAkDnF;AAmBD;;;GAGG;AACH,eAAO,MAAM,2BAA2B,EAAE,YA2EzC,CAAA"}