@mailwoman/soil 9.2.0

package/out/schema.js

@@ -0,0 +1,186 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Typed schema for `soil.db` — the polygon truth table, the containment index above it, and the ONE
+ *   reduction both consumers read, plus the layer-contract tables from `@mailwoman/core/layers`.
+ *
+ *   THREE CELL-FACING TABLES ARE ONE PIPELINE, NOT THREE SOURCES. {@link SoilMapUnitAreaTable} holds what
+ *   the authority drew, unsimplified. {@link SoilMapUnitCellTable} says which cells each delineation
+ *   reaches and whether it fills them. {@link SoilCapabilityCellTable} is that index reduced ONCE, at build
+ *   time, into a per-cell distribution. A `partial` cell's contribution to the reduction is weighted by the
+ *   area it actually covers, which is why the truth table keeps unsimplified rings: simplify them and the
+ *   weights change silently.
+ *
+ *   THE REDUCTION STORES A DISTRIBUTION, NEVER A WINNER, AND THAT IS FORCED BY MEASUREMENT RATHER THAN
+ *   PREFERENCE. 84.0% of the 339,191 national map units hold two or more components; in 16.8% the largest
+ *   component covers under half the map unit; and 85.4% of `IA153`'s 17,966 delineations are smaller than
+ *   one resolution-9 cell, so no affordable cell size removes the mixture. NRCS itself ships
+ *   `muaggatt.niccdcd` — its own dominant-condition capability class — beside `niccdcdpct`, the share that
+ *   class actually covers, with an observed minimum of 2%. This table reproduces that pattern at cell grain
+ *   rather than inventing one.
+ *
+ *   AN ABSENCE IS NEVER A SMALL NUMBER. Four separate shares name why the rest of a cell carries no class,
+ *   and class 8 is NOT among them: class 8 is a determination — the survey looked and rated the land as
+ *   precluding commercial plant production — so it is a class share like any other. Folding a `NOTCOM`
+ *   polygon, a water body and an unrated series into "not arable" would produce a well-formed wrong answer,
+ *   which is what the four shares exist to make impossible.
+ *
+ *   `WITHOUT ROWID` ON THE CELL TABLES AND NEVER ON THE GEOMETRY TABLE. Small fixed-width rows probed by
+ *   their exact primary key belong in the B-tree; a row carrying a geometry blob does not — clustering it
+ *   into the B-tree makes every index page a geometry page.
+ */
+import { sql } from "kysely";
+/**
+ * Whether an H3 cell lies wholly inside one map-unit delineation, or is crossed by its boundary.
+ */
+export const SoilCellContainment = {
+    /**
+     * Every point in the cell is inside the delineation. Answered from the index alone, with no geometry read.
+     */
+    Whole: "whole",
+    /**
+     * The delineation's boundary crosses the cell. The index has narrowed the candidates; the point test decides.
+     */
+    Partial: "partial",
+};
+/**
+ * Create `soil_map_unit_area`. A PLAIN rowid table on purpose — the `rings` blob is exactly the payload `WITHOUT ROWID`
+ * penalizes.
+ */
+export async function createSoilMapUnitAreaTable(db) {
+    await db.schema
+        .createTable("soil_map_unit_area")
+        .addColumn("area_id", "text", (c) => c.primaryKey())
+        .addColumn("mukey", "text", (c) => c.notNull())
+        .addColumn("areasymbol", "text", (c) => c.notNull())
+        .addColumn("min_lat", "real", (c) => c.notNull())
+        .addColumn("min_lon", "real", (c) => c.notNull())
+        .addColumn("max_lat", "real", (c) => c.notNull())
+        .addColumn("max_lon", "real", (c) => c.notNull())
+        .addColumn("rings", "blob", (c) => c.notNull())
+        .execute();
+}
+/**
+ * Create `soil_map_unit_cell` — the containment index. Small fixed-width rows probed by their exact primary key.
+ */
+export async function createSoilMapUnitCellTable(db) {
+    await db.schema
+        .createTable("soil_map_unit_cell")
+        .addColumn("h3_cell", "integer", (c) => c.notNull())
+        .addColumn("resolution", "integer", (c) => c.notNull())
+        .addColumn("area_id", "text", (c) => c.notNull())
+        .addColumn("containment", "text", (c) => c.notNull())
+        .addPrimaryKeyConstraint("soil_map_unit_cell_pk", ["h3_cell", "area_id"])
+        // `WITHOUT ROWID` has no first-class builder; the raw modifier is the idiomatic fallback.
+        .modifyEnd(sql `without rowid`)
+        .execute();
+}
+/**
+ * Create `soil_map_unit`.
+ */
+export async function createSoilMapUnitTable(db) {
+    await db.schema
+        .createTable("soil_map_unit")
+        .addColumn("mukey", "text", (c) => c.primaryKey())
+        .addColumn("areasymbol", "text", (c) => c.notNull())
+        .addColumn("musym", "text", (c) => c.notNull())
+        .addColumn("muname", "text", (c) => c.notNull())
+        .addColumn("mukind", "text")
+        .addColumn("mustatus", "text")
+        .addColumn("farmlndcl", "text")
+        .addColumn("farmland_scope", "text", (c) => c.notNull())
+        .addColumn("niccdcd", "text")
+        .addColumn("niccdcdpct", "integer")
+        .addColumn("no_mapping", "integer", (c) => c.notNull())
+        .execute();
+}
+/**
+ * Create `soil_component`.
+ */
+export async function createSoilComponentTable(db) {
+    await db.schema
+        .createTable("soil_component")
+        .addColumn("cokey", "text", (c) => c.primaryKey())
+        .addColumn("mukey", "text", (c) => c.notNull())
+        .addColumn("comppct_r", "integer", (c) => c.notNull())
+        .addColumn("compname", "text")
+        .addColumn("compkind", "text")
+        .addColumn("nirrcapcl", "text")
+        .addColumn("nirrcapscl", "text")
+        .addColumn("irrcapcl", "text")
+        .addColumn("irrcapscl", "text")
+        .addColumn("nccpi_v3", "real")
+        .execute();
+}
+/**
+ * Create `soil_capability_cell` — the reduction both consumers read.
+ */
+export async function createSoilCapabilityCellTable(db) {
+    await db.schema
+        .createTable("soil_capability_cell")
+        .addColumn("h3_cell", "integer", (c) => c.primaryKey())
+        .addColumn("class_shares", "text", (c) => c.notNull())
+        .addColumn("unrated_share", "real", (c) => c.notNull())
+        .addColumn("notrateable_share", "real", (c) => c.notNull())
+        .addColumn("nodata_share", "real", (c) => c.notNull())
+        .addColumn("other_share", "real", (c) => c.notNull())
+        .addColumn("mapped_share", "real", (c) => c.notNull())
+        .addColumn("top_class", "text")
+        .addColumn("top_class_share", "real")
+        .addColumn("weighting", "text", (c) => c.notNull())
+        .addColumn("delineations", "integer", (c) => c.notNull())
+        .modifyEnd(sql `without rowid`)
+        .execute();
+}
+/**
+ * Create `soil_survey_area`.
+ */
+export async function createSoilSurveyAreaTable(db) {
+    await db.schema
+        .createTable("soil_survey_area")
+        .addColumn("areasymbol", "text", (c) => c.primaryKey())
+        .addColumn("areaname", "text", (c) => c.notNull())
+        .addColumn("saverest", "text", (c) => c.notNull())
+        .addColumn("saversion", "integer")
+        .addColumn("survey_source_date", "text")
+        .addColumn("survey_source_title", "text")
+        .addColumn("source_scale", "integer")
+        .addColumn("mapping_scale", "integer")
+        .addColumn("area_acres", "integer")
+        .addColumn("min_lat", "real", (c) => c.notNull())
+        .addColumn("min_lon", "real", (c) => c.notNull())
+        .addColumn("max_lat", "real", (c) => c.notNull())
+        .addColumn("max_lon", "real", (c) => c.notNull())
+        .addColumn("coverage_cells", "integer", (c) => c.notNull())
+        .addColumn("coverage_resolution", "integer", (c) => c.notNull())
+        .execute();
+}
+/**
+ * Create `soil_vocabulary`.
+ */
+export async function createSoilVocabularyTable(db) {
+    await db.schema
+        .createTable("soil_vocabulary")
+        .addColumn("domain", "text", (c) => c.notNull())
+        .addColumn("code", "text", (c) => c.notNull())
+        .addColumn("definition", "text", (c) => c.notNull())
+        .addColumn("sequence", "integer", (c) => c.notNull())
+        .addPrimaryKeyConstraint("soil_vocabulary_pk", ["domain", "code"])
+        .modifyEnd(sql `without rowid`)
+        .execute();
+}
+/**
+ * Every domain table this layer owns, in dependency order.
+ */
+export async function createSoilTables(db) {
+    await createSoilMapUnitAreaTable(db);
+    await createSoilMapUnitCellTable(db);
+    await createSoilMapUnitTable(db);
+    await createSoilComponentTable(db);
+    await createSoilCapabilityCellTable(db);
+    await createSoilSurveyAreaTable(db);
+    await createSoilVocabularyTable(db);
+}
+//# sourceMappingURL=schema.js.map

package/out/schema.js.map

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

package/out/scripts/ingest-chunk.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   One chunk of the soil ingest, as its own process — spawned by `buildSoilDatabase`, never run by hand.
+ *   The process boundary and the stdout contract live with `runIngestChunkScript`; what stays here is only
+ *   this product's flags and its feature-source constructor.
+ */
+export {};
+//# sourceMappingURL=ingest-chunk.d.ts.map

package/out/scripts/ingest-chunk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-chunk.d.ts","sourceRoot":"","sources":["../../lib/scripts/ingest-chunk.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/out/scripts/ingest-chunk.js

@@ -0,0 +1,42 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   One chunk of the soil ingest, as its own process — spawned by `buildSoilDatabase`, never run by hand.
+ *   The process boundary and the stdout contract live with `runIngestChunkScript`; what stays here is only
+ *   this product's flags and its feature-source constructor.
+ */
+import { requiredArgument } from "@mailwoman/core/scripting/arguments";
+import { INGEST_CHUNK_FLAGS, runIngestChunkScript } from "@mailwoman/core/scripting/ingest-chunk-script";
+import { createShapefileFeatureSource } from "#sdk/ingest";
+import { ingestSoilChunk } from "#sdk/ingest-chunk";
+await runIngestChunkScript({
+    context: "soil ingest-chunk",
+    options: {
+        ...INGEST_CHUNK_FLAGS,
+        shapefile: { type: "string" },
+        "area-symbol": { type: "string" },
+        "fid-from": { type: "string" },
+        "fid-to": { type: "string" },
+        "no-mapping-mukeys": { type: "string" },
+    },
+    run: async (database, values, chunk) => ingestSoilChunk(database, {
+        source: await createShapefileFeatureSource({
+            shapefilePath: requiredArgument("soil ingest-chunk", "shapefile", values.shapefile),
+            areaSymbol: requiredArgument("soil ingest-chunk", "area-symbol", values["area-symbol"]),
+            fidFrom: Number(requiredArgument("soil ingest-chunk", "fid-from", values["fid-from"])),
+            fidTo: Number(requiredArgument("soil ingest-chunk", "fid-to", values["fid-to"])),
+            // A range's own count is not knowable up front — `ogrinfo` reports the layer's total and nothing narrower — so
+            // the chunk asserts nothing about its size and the PARENT checks the per-area sum against the shapefile's.
+            declaredFeatureCount: 0,
+        }),
+        indexResolution: chunk.indexResolution,
+        coverageResolution: chunk.coverageResolution,
+        // An empty string is an empty set, not "every map unit": a build where nothing lacks soil mapping passes one, and
+        // `"".split(",")` yields one empty element that has to be dropped rather than joined against as a mukey.
+        noMappingMukeys: new Set((values["no-mapping-mukeys"] ?? "").split(",").filter((mukey) => mukey.length > 0)),
+        onProgress: chunk.onProgress,
+    }),
+});
+//# sourceMappingURL=ingest-chunk.js.map

package/out/scripts/ingest-chunk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-chunk.js","sourceRoot":"","sources":["../../lib/scripts/ingest-chunk.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AACtE,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAA;AAIxG,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAA;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEnD,MAAM,oBAAoB,CAAC;IAC1B,OAAO,EAAE,mBAAmB;IAC5B,OAAO,EAAE;QACR,GAAG,kBAAkB;QACrB,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC7B,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACjC,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,mBAAmB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACvC;IACD,GAAG,EAAE,KAAK,EAAE,QAAsC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CACpE,eAAe,CAAC,QAAQ,EAAE;QACzB,MAAM,EAAE,MAAM,4BAA4B,CAAC;YAC1C,aAAa,EAAE,gBAAgB,CAAC,mBAAmB,EAAE,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC;YACnF,UAAU,EAAE,gBAAgB,CAAC,mBAAmB,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;YACvF,OAAO,EAAE,MAAM,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;YACtF,KAAK,EAAE,MAAM,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAChF,+GAA+G;YAC/G,2GAA2G;YAC3G,oBAAoB,EAAE,CAAC;SACvB,CAAC;QACF,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,kHAAkH;QAClH,yGAAyG;QACzG,eAAe,EAAE,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC5G,UAAU,EAAE,KAAK,CAAC,UAAU;KAC5B,CAAC;CACH,CAAC,CAAA"}

package/out/sdk/acquire.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Acquisition, end to end: which survey areas a region holds, their archives, and the inputs the builder
+ *   takes.
+ *
+ *   THE FRESHNESS QUESTION IS ANSWERED BY THE TABULAR SERVICE, NOT BY THE FILE HOST. `sacatalog.saverest` is
+ *   the version-established date, and it is also what the archive's filename embeds — so one catalogue call
+ *   both decides what to download and names the file. The download host cannot answer it: it refuses `HEAD`
+ *   with 405 and ignores `Range`, so a length probe there is a full transfer.
+ *
+ *   THE VINTAGE IS THE REFRESH THE BUILD INGESTED, AND IT IS ONE DATE FOR THE WHOLE ARTIFACT. NRCS performs
+ *   ONE coordinated Annual Soils Refresh, each October 1; grouping `sacatalog` by year of `saverest` returns
+ *   2016: 1, 2025: 3,323, 2026: 56. So a region's areas share a refresh and the manifest can carry one
+ *   `source_vintage` — the LATEST of the areas built, because that is the date after which nothing in the
+ *   artifact changed. Every area's own date is kept per row in `soil_survey_area`, and so is the far older
+ *   field-survey date, which is the number a currency claim actually turns on.
+ */
+import type { SurveyAreaInput } from "#sdk/build-soil";
+import type { SoilDataAccessClient, SurveyAreaCatalogEntry } from "#sdk/client";
+import { type SurveyAreaArchive } from "#sdk/download";
+export interface AcquireRegionOptions {
+    client: SoilDataAccessClient;
+    /**
+     * The survey-area symbol prefix — a state code (`IA`) for a whole state, or a full symbol (`IA153`) for the
+     * single-area rung.
+     */
+    prefix: string;
+    /**
+     * Where vintages are kept.
+     */
+    cacheRoot: string;
+    /**
+     * Build only these symbols out of the ones the catalogue returns. Absent means all of them.
+     */
+    only?: ReadonlyArray<string>;
+    onProgress?: (message: string) => void;
+}
+/**
+ * What one region's acquisition produced.
+ */
+export interface AcquiredRegion {
+    catalog: SurveyAreaCatalogEntry[];
+    archives: SurveyAreaArchive[];
+    areas: SurveyAreaInput[];
+    /**
+     * The refresh the artifact carries — the latest version date among the areas built.
+     */
+    sourceVintage: string;
+}
+/**
+ * Acquire every survey area a prefix names, and turn them into builder inputs.
+ *
+ * @throws {Error} When the catalogue holds nothing for the prefix, when `only` names a symbol the catalogue does not
+ *   carry, or when any area's archive, metadata or shapefile refuses.
+ */
+export declare function acquireRegion(options: AcquireRegionOptions): Promise<AcquiredRegion>;
+//# sourceMappingURL=acquire.d.ts.map

package/out/sdk/acquire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acquire.d.ts","sourceRoot":"","sources":["../../lib/sdk/acquire.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAC/E,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAI1E,MAAM,WAAW,oBAAoB;IACpC,MAAM,EAAE,oBAAoB,CAAA;IAC5B;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC5B,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,sBAAsB,EAAE,CAAA;IACjC,QAAQ,EAAE,iBAAiB,EAAE,CAAA;IAC7B,KAAK,EAAE,eAAe,EAAE,CAAA;IACxB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAA;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2D1F"}

package/out/sdk/acquire.js

@@ -0,0 +1,74 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Acquisition, end to end: which survey areas a region holds, their archives, and the inputs the builder
+ *   takes.
+ *
+ *   THE FRESHNESS QUESTION IS ANSWERED BY THE TABULAR SERVICE, NOT BY THE FILE HOST. `sacatalog.saverest` is
+ *   the version-established date, and it is also what the archive's filename embeds — so one catalogue call
+ *   both decides what to download and names the file. The download host cannot answer it: it refuses `HEAD`
+ *   with 405 and ignores `Range`, so a length probe there is a full transfer.
+ *
+ *   THE VINTAGE IS THE REFRESH THE BUILD INGESTED, AND IT IS ONE DATE FOR THE WHOLE ARTIFACT. NRCS performs
+ *   ONE coordinated Annual Soils Refresh, each October 1; grouping `sacatalog` by year of `saverest` returns
+ *   2016: 1, 2025: 3,323, 2026: 56. So a region's areas share a refresh and the manifest can carry one
+ *   `source_vintage` — the LATEST of the areas built, because that is the date after which nothing in the
+ *   artifact changed. Every area's own date is kept per row in `soil_survey_area`, and so is the far older
+ *   field-survey date, which is the number a currency claim actually turns on.
+ */
+import { downloadSurveyArea } from "#sdk/download";
+import { mapUnitShapefile, readSoilSourceIdentity, surveyAreaShapefile } from "#sdk/ingest";
+import { readSurveyAreaAttributes, readSurveyAreaOutline } from "#sdk/survey-area";
+/**
+ * Acquire every survey area a prefix names, and turn them into builder inputs.
+ *
+ * @throws {Error} When the catalogue holds nothing for the prefix, when `only` names a symbol the catalogue does not
+ *   carry, or when any area's archive, metadata or shapefile refuses.
+ */
+export async function acquireRegion(options) {
+    const catalog = await options.client.readSurveyAreaCatalog(options.prefix);
+    const wanted = options.only ? new Set(options.only.map((symbol) => symbol.toUpperCase())) : undefined;
+    const selected = wanted ? catalog.filter((entry) => wanted.has(entry.areasymbol.toUpperCase())) : catalog;
+    if (wanted) {
+        const found = new Set(selected.map((entry) => entry.areasymbol.toUpperCase()));
+        const missing = [...wanted].filter((symbol) => !found.has(symbol));
+        if (missing.length) {
+            throw new Error(`soil acquire: the catalogue holds no survey area named ${missing.join(", ")} — building the rest would quietly answer a smaller question than the one asked`);
+        }
+    }
+    options.onProgress?.(`${selected.length} survey area(s) from the catalogue`);
+    const archives = [];
+    const areas = [];
+    for (const entry of selected) {
+        const archive = await downloadSurveyArea({
+            areaSymbol: entry.areasymbol,
+            versionDate: entry.saverest,
+            cacheRoot: options.cacheRoot,
+            ...(options.onProgress ? { onProgress: options.onProgress } : {}),
+        });
+        archives.push(archive);
+        const attributes = await readSurveyAreaAttributes(archive.tabularDirectory, entry.areasymbol);
+        const shapefilePath = mapUnitShapefile(archive.spatialDirectory, entry.areasymbol);
+        const identity = await readSoilSourceIdentity({ shapefilePath });
+        const outline = await readSurveyAreaOutline(surveyAreaShapefile(archive.spatialDirectory, entry.areasymbol));
+        options.onProgress?.(`${entry.areasymbol}: ${identity.featureCount.toLocaleString()} delineations · ${attributes.mapUnits.length} map units · ` +
+            `${attributes.components.length} components · refresh ${attributes.saverest} · field survey ${attributes.surveySourceDate ?? "unstated"}`);
+        areas.push({
+            attributes,
+            shapefilePath,
+            outline,
+            declaredFeatureCount: identity.featureCount,
+        });
+    }
+    // The LATEST refresh among the areas built, because that is the date after which nothing in this artifact changed.
+    // Taking the earliest would claim a currency the newest area does not have; taking today's date would claim one no
+    // area has.
+    const sourceVintage = selected
+        .map((entry) => entry.saverest)
+        .toSorted()
+        .at(-1);
+    return { catalog, archives, areas, sourceVintage };
+}
+//# sourceMappingURL=acquire.js.map

package/out/sdk/acquire.js.map

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

package/out/sdk/build-soil.d.ts

@@ -0,0 +1,197 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Build `soil.db` — the sealed polygon layer, from the survey areas NRCS publishes.
+ *
+ *   THE ACCUMULATION IS IN SQL, NOT IN A MAP. Classification is per delineation and shared with the
+ *   resolution measurement, but where the touches GO differs on purpose: the measuring instrument holds
+ *   them in memory because it is comparing candidate resolutions in one pass, and the builder streams them
+ *   into a temporary table because memory has to stay flat in row count. A polygon layer's touches
+ *   outnumber its features, and Iowa is 99 survey areas.
+ *
+ *   ABSENCE IS NO ROW, IN EVERY TABLE. Land outside a published survey area gets no `layer_coverage` row and
+ *   no summary row — never a zero, never an empty histogram. Inside a published area the coverage row says
+ *   `designated` at completeness 1.0, because NRCS declares its own mapping complete for those areas at its
+ *   own scale; a coverage cell reached ONLY by `NOTCOM` and access-denied polygons gets no row either,
+ *   because the polygon exists and the soil mapping behind it does not.
+ *
+ *   A COVERAGE ROW LICENSES ONLY THAT THE AUTHORITY MAPPED HERE. The reading is the class distribution, and
+ *   a cell that is 100% `unrated_share` is `designated`-complete and carries no capability reading
+ *   whatsoever. That pairing is not a corner case: 17.1% of national components carry no capability rating,
+ *   and for the irrigated rating the figure is 85.1%.
+ *
+ *   THE AREA CROSS-CHECK USES THE AUTHORITY'S OWN PUBLISHED FIGURE. `legend.areaacres` is what NRCS states
+ *   the survey area covers — 378,800 acres for `IA153`, which is 1,532.9 km² against the 1,532.5 km² an
+ *   independent projected measurement of the same shapefile reports. Comparing the spherical ring sum
+ *   against it catches a hole read as an exterior ring, whose absence is silent: such a polygon is
+ *   well-formed and simply answers "inside" for ground the authority did not map.
+ */
+import { type AreaAgreementReading } from "@mailwoman/core/layers";
+import { type ParsedGeometry } from "@mailwoman/spatial";
+import type { SoilFeatureSource } from "#sdk/ingest";
+import type { SoilChunkResult } from "#sdk/ingest-chunk";
+import type { SurveyAreaAttributes } from "#sdk/survey-area";
+/**
+ * Schema version of the domain tables. Bumped when a column changes meaning, never for an added column a reader can
+ * ignore.
+ */
+export declare const SOIL_SCHEMA_VERSION = 1;
+/**
+ * Delineation ids per chunk process.
+ *
+ * Sized against the ceiling the flood layer measured rather than guessed: single-process runs over that product died
+ * after roughly 510,000 and 798,000 features as h3's WASM heap fragmented. 100,000 leaves five times that margin, and
+ * the cost of a smaller number is one interpreter start per chunk. Iowa's largest survey area holds well under it, so
+ * on this build the bound costs one process per area — which is what makes an area's failure nameable.
+ */
+export declare const DEFAULT_CHUNK_SIZE = 100000;
+/**
+ * One survey area, ready to build: where its geometry is, and what its tabular export said.
+ */
+export interface SurveyAreaInput {
+    attributes: SurveyAreaAttributes;
+    /**
+     * The map-unit polygon shapefile.
+     */
+    shapefilePath?: string;
+    /**
+     * The survey area's own outline, already read.
+     */
+    outline: ParsedGeometry;
+    /**
+     * An in-process feature source. Correct for a fixture and for anything small; the batched path builds one of these
+     * per chunk, so the two share one implementation.
+     */
+    source?: SoilFeatureSource;
+    /**
+     * The delineation count the shapefile declares, when the caller has already read it.
+     */
+    declaredFeatureCount?: number;
+}
+export interface BuildSoilOptions {
+    /**
+     * The survey areas to build, in the order they should be ingested.
+     */
+    areas: ReadonlyArray<SurveyAreaInput>;
+    /**
+     * The region the layer name carries — the pilot's is `ia`.
+     */
+    region: string;
+    /**
+     * Where the sealed artifact lands. The build writes beside it and swaps.
+     */
+    out: string;
+    /**
+     * The refresh the build ingested — `layer_manifest.version` and `source_vintage`.
+     */
+    sourceVintage: string;
+    buildCmd: string;
+    buildSHA: string;
+    /**
+     * ISO-8601, supplied by the caller. Never generated here: the contract says so, and a library-generated timestamp
+     * makes two builds of the same inputs differ.
+     */
+    createdAt: string;
+    /**
+     * The resolution the cell index and the reduction are built at — chosen from the measurement.
+     */
+    indexResolution: number;
+    /**
+     * The resolution `layer_coverage` rows are keyed at. Must be coarser than the index resolution.
+     */
+    coverageResolution: number;
+    /**
+     * Delineation ids per chunk process. See {@link DEFAULT_CHUNK_SIZE}.
+     */
+    chunkSize?: number;
+    /**
+     * Run the ingest IN THIS PROCESS rather than spawning chunk children. Only for fixtures, which carry no shapefile for
+     * a child to open.
+     */
+    inProcess?: boolean;
+    onProgress?: (message: string) => void;
+}
+export interface BuildSoilResult {
+    out: string;
+    region: string;
+    surveyAreas: number;
+    delineations: number;
+    mapUnits: number;
+    components: number;
+    indexResolution: number;
+    coverageResolution: number;
+    wholeCellRows: number;
+    partialCellRows: number;
+    /**
+     * `partialCellRows / (wholeCellRows + partialCellRows)` over the STORED index rows. The whole side is compacted, so
+     * this is not the same number the resolution was chosen on and is reported separately.
+     */
+    storedPartialShare: number;
+    capabilityCells: number;
+    /**
+     * Cells the lattice was used for, rather than the whole-cell fast path.
+     */
+    sampledCells: number;
+    /**
+     * Cells whose top class covers less than half the cell — the §4.7 number, taken off the shipping artifact rather than
+     * out of a separate harness.
+     */
+    topClassUnderHalfCells: number;
+    topClassUnderHalfShare: number;
+    /**
+     * Cells with NO class at all: the survey mapped them and rated nothing there.
+     */
+    classlessCells: number;
+    /**
+     * Cells the index touched that no lattice point landed inside. Dropped rather than stored as an all-zero
+     * distribution, and counted because a large number would mean the lattice is too coarse for this geometry.
+     */
+    unsampledCells: number;
+    meanDelineationsPerCell: number;
+    coarsenedFeatures: number;
+    storedResolutions: number[];
+    coverageCells: number;
+    /**
+     * Coverage cells inside a survey-area outline that no delineation with soil mapping reached. Reported rather than
+     * smoothed over: SSURGO is wall-to-wall inside a published area, so a large number means the outline and the
+     * delineations disagree.
+     */
+    coverageCellsWithoutMapping: number;
+    /**
+     * The area readings in square kilometres against the authority's own published figure, with the witness stated. The
+     * `known` count of areas that publish an acreage is what a receipt reads the absence against.
+     */
+    area: AreaAgreementReading;
+    sizeBytes: number;
+}
+/**
+ * Build the layer.
+ *
+ * @throws {Error} On a delineation the classifier refuses, a streamed count that disagrees with the shapefile's own
+ *   declaration, an area total that disagrees with the authority's published acreage, or a set of outlines that yields
+ *   no interior coverage cell at all.
+ */
+export declare function buildSoilDatabase(options: BuildSoilOptions): Promise<BuildSoilResult>;
+/**
+ * What the whole ingest produced, however many processes it took.
+ */
+interface StreamResult {
+    delineations: number;
+    coarsened: number;
+    byArea: Map<string, number>;
+    observedByCoverageCell: Map<number, number>;
+    mappedByCoverageCell: Map<number, number>;
+    nestedM2: number;
+    allExteriorM2: number;
+}
+/**
+ * Add up what the chunks reported.
+ *
+ * Exported for its own test: the coverage-cell arithmetic is the one part of the batched path a fixture build cannot
+ * reach, and getting it wrong produces a well-formed artifact that under-reports how many delineations a cell holds.
+ */
+export declare function aggregateChunks(chunks: ReadonlyArray<SoilChunkResult>): StreamResult;
+export {};
+//# sourceMappingURL=build-soil.d.ts.map

package/out/sdk/build-soil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-soil.d.ts","sourceRoot":"","sources":["../../lib/sdk/build-soil.ts"],"names":[],"mappings":"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"}