@geotechcli/core 0.4.124 → 0.4.125

package/dist/ingest/borehole-continuity.d.ts

@@ -0,0 +1,59 @@
+import type { BoreholeInterpretation, BoreholeLayer } from '../vision/index.js';
+/**
+ * Deterministic borehole depth-continuity reconstruction.
+ *
+ * After multi-page borehole logs are merged ({@link mergeBoreholeLogPages}), the stitched layer
+ * sequence can still carry page-break artifacts: a boundary interval duplicated across two pages, a
+ * sub-millimetre rounding gap, or a small overlap where the same depth row was read twice. This module
+ * repairs those *page-break artifacts only* and records an explicit audit trail.
+ *
+ * Design rules (kept intentionally conservative so deterministic code never invents engineering data):
+ * - Never fabricate intervals and never silently hide a genuine anomaly.
+ * - Only repair small, page-break-shaped discrepancies (duplicates, micro-gaps, small overlaps).
+ * - Leave large/ambiguous overlaps and gaps untouched and flag them, so the authoritative
+ *   `validateMergedBorehole` check still surfaces them as blocking/review findings downstream.
+ * - Be idempotent: a second pass over repaired layers produces zero further repairs.
+ */
+export type BoreholeContinuityAction = 'trim-overlap' | 'drop-duplicate' | 'snap-gap' | 'flag-unrepairable';
+export interface BoreholeContinuityRepairDepths {
+    from: number | null;
+    to: number | null;
+}
+export interface BoreholeContinuityRepair {
+    action: BoreholeContinuityAction;
+    boreholeId: string;
+    /** Index of the affected layer in the borehole's original (pre-repair) `layers` array. */
+    layerIndex: number;
+    before: BoreholeContinuityRepairDepths;
+    /** Repaired depths, or `null` when the layer was dropped or only flagged. */
+    after: BoreholeContinuityRepairDepths | null;
+    note: string;
+}
+export interface BoreholeContinuityMetrics {
+    overlapCount: number;
+    gapCount: number;
+    nonMonotonicCount: number;
+    duplicateCount: number;
+}
+export interface ReconstructBoreholeContinuityOptions {
+    /** Gaps at or below this size (m) are snapped closed as rounding artifacts. Default 0.05. */
+    gapSnapToleranceMeters?: number;
+    /** Overlaps at or below this size (m) are trimmed as page-break artifacts; larger overlaps are left intact and flagged. Default 0.5. */
+    maxRepairableOverlapMeters?: number;
+}
+/**
+ * Compute deterministic continuity metrics for an ordered (or unordered) layer list. Used for
+ * warnings and benchmark/regression assertions. Layers missing a numeric `depthFrom`/`depthTo` are
+ * ignored for the pairwise checks.
+ */
+export declare function assessBoreholeContinuity(layers: BoreholeLayer[]): BoreholeContinuityMetrics;
+/**
+ * Repair page-break continuity artifacts in a single merged borehole. Returns the (possibly new)
+ * borehole with repaired layers plus continuity warnings appended, and a typed list of the repairs
+ * applied. The input borehole is never mutated.
+ */
+export declare function reconstructBoreholeContinuity(borehole: BoreholeInterpretation, options?: ReconstructBoreholeContinuityOptions): {
+    borehole: BoreholeInterpretation;
+    repairs: BoreholeContinuityRepair[];
+};
+//# sourceMappingURL=borehole-continuity.d.ts.map

package/dist/ingest/borehole-continuity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"borehole-continuity.d.ts","sourceRoot":"","sources":["../../src/ingest/borehole-continuity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEhF;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,wBAAwB,GAChC,cAAc,GACd,gBAAgB,GAChB,UAAU,GACV,mBAAmB,CAAC;AAExB,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,wBAAwB,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,0FAA0F;IAC1F,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,8BAA8B,CAAC;IACvC,6EAA6E;IAC7E,KAAK,EAAE,8BAA8B,GAAG,IAAI,CAAC;IAC7C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oCAAoC;IACnD,6FAA6F;IAC7F,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,wIAAwI;IACxI,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC;AA+CD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,yBAAyB,CA8B3F;AAaD;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,sBAAsB,EAChC,OAAO,GAAE,oCAAyC,GACjD;IAAE,QAAQ,EAAE,sBAAsB,CAAC;IAAC,OAAO,EAAE,wBAAwB,EAAE,CAAA;CAAE,CAsH3E"}

package/dist/ingest/borehole-continuity.js

@@ -0,0 +1,163 @@
+const DEFAULT_GAP_SNAP_TOLERANCE_M = 0.05;
+const DEFAULT_MAX_REPAIRABLE_OVERLAP_M = 0.5;
+const EPSILON_M = 1e-6;
+function approxEqual(a, b, eps = EPSILON_M) {
+    return Math.abs(a - b) <= eps;
+}
+function round3(value) {
+    return Math.round(value * 1000) / 1000;
+}
+function fmt(value) {
+    return value == null ? 'n/a' : value.toFixed(2);
+}
+function normDescription(layer) {
+    return (layer.description ?? '').trim().toLowerCase();
+}
+function normUscs(layer) {
+    return (layer.uscsSymbol ?? '').trim().toUpperCase();
+}
+/** Two layers describe the same material when both their description and USCS symbol match. */
+function sameMaterial(a, b) {
+    return normDescription(a) === normDescription(b) && normUscs(a) === normUscs(b);
+}
+function isNumericLayer(layer) {
+    return layer.depthFrom != null && layer.depthTo != null;
+}
+/** Keep the previous layer with the greatest bottom depth so the running boundary is monotonic. */
+function pickDeeperPrev(current, candidate) {
+    if (!isNumericLayer(candidate))
+        return current;
+    if (current == null || candidate.depthTo >= current.depthTo)
+        return candidate;
+    return current;
+}
+/**
+ * Compute deterministic continuity metrics for an ordered (or unordered) layer list. Used for
+ * warnings and benchmark/regression assertions. Layers missing a numeric `depthFrom`/`depthTo` are
+ * ignored for the pairwise checks.
+ */
+export function assessBoreholeContinuity(layers) {
+    let overlapCount = 0;
+    let gapCount = 0;
+    let nonMonotonicCount = 0;
+    let duplicateCount = 0;
+    for (const layer of layers) {
+        if (isNumericLayer(layer) && layer.depthTo < layer.depthFrom - EPSILON_M) {
+            nonMonotonicCount += 1;
+        }
+    }
+    const numeric = layers
+        .filter(isNumericLayer)
+        .slice()
+        .sort((a, b) => a.depthFrom - b.depthFrom || a.depthTo - b.depthTo);
+    for (let i = 1; i < numeric.length; i += 1) {
+        const prev = numeric[i - 1];
+        const cur = numeric[i];
+        if (approxEqual(cur.depthFrom, prev.depthFrom) && approxEqual(cur.depthTo, prev.depthTo)) {
+            duplicateCount += 1;
+        }
+        else if (cur.depthFrom < prev.depthTo - EPSILON_M) {
+            overlapCount += 1;
+        }
+        else if (cur.depthFrom > prev.depthTo + EPSILON_M) {
+            gapCount += 1;
+        }
+    }
+    return { overlapCount, gapCount, nonMonotonicCount, duplicateCount };
+}
+function makeRepair(action, boreholeId, layerIndex, before, after, note) {
+    return { action, boreholeId, layerIndex, before, after, note };
+}
+/**
+ * Repair page-break continuity artifacts in a single merged borehole. Returns the (possibly new)
+ * borehole with repaired layers plus continuity warnings appended, and a typed list of the repairs
+ * applied. The input borehole is never mutated.
+ */
+export function reconstructBoreholeContinuity(borehole, options = {}) {
+    const gapTolerance = options.gapSnapToleranceMeters ?? DEFAULT_GAP_SNAP_TOLERANCE_M;
+    const maxOverlap = options.maxRepairableOverlapMeters ?? DEFAULT_MAX_REPAIRABLE_OVERLAP_M;
+    const repairs = [];
+    if (borehole.layers.length === 0) {
+        return { borehole, repairs };
+    }
+    const indexed = borehole.layers.map((layer, index) => ({ layer, index }));
+    const numeric = indexed.filter((entry) => isNumericLayer(entry.layer));
+    const nonNumeric = indexed.filter((entry) => !isNumericLayer(entry.layer));
+    // Stable sort numeric layers by (from, to), keeping original order as the tiebreaker.
+    numeric.sort((a, b) => {
+        const fromDelta = a.layer.depthFrom - b.layer.depthFrom;
+        if (fromDelta !== 0)
+            return fromDelta;
+        const toDelta = a.layer.depthTo - b.layer.depthTo;
+        if (toDelta !== 0)
+            return toDelta;
+        return a.index - b.index;
+    });
+    const kept = [];
+    let prev = null;
+    for (const { layer, index } of numeric) {
+        const from = layer.depthFrom;
+        const to = layer.depthTo;
+        if (prev == null) {
+            kept.push(layer);
+            prev = pickDeeperPrev(prev, layer);
+            continue;
+        }
+        const prevFrom = prev.depthFrom;
+        const prevTo = prev.depthTo;
+        // Exact duplicate boundary row repeated at a page break (same span + same material) -> drop.
+        if (approxEqual(from, prevFrom) && approxEqual(to, prevTo) && sameMaterial(layer, prev)) {
+            repairs.push(makeRepair('drop-duplicate', borehole.boreholeId, index, { from, to }, null, `Dropped duplicate interval ${fmt(from)}–${fmt(to)} m repeated at a page break.`));
+            continue;
+        }
+        const overlap = prevTo - from;
+        if (overlap > EPSILON_M) {
+            // Interval fully nested inside the previous one.
+            if (to <= prevTo + EPSILON_M) {
+                if (sameMaterial(layer, prev)) {
+                    repairs.push(makeRepair('drop-duplicate', borehole.boreholeId, index, { from, to }, null, `Dropped interval ${fmt(from)}–${fmt(to)} m nested inside ${fmt(prevFrom)}–${fmt(prevTo)} m at a page break.`));
+                    continue;
+                }
+                repairs.push(makeRepair('flag-unrepairable', borehole.boreholeId, index, { from, to }, { from, to }, `Interval ${fmt(from)}–${fmt(to)} m is nested inside ${fmt(prevFrom)}–${fmt(prevTo)} m; left unchanged for review.`));
+                kept.push(layer);
+                // Do not advance prev: the nested layer is shallower than the current bottom.
+                continue;
+            }
+            if (overlap <= maxOverlap) {
+                const newFrom = round3(prevTo);
+                const trimmed = { ...layer, depthFrom: newFrom };
+                repairs.push(makeRepair('trim-overlap', borehole.boreholeId, index, { from, to }, { from: newFrom, to }, `Trimmed ${fmt(overlap)} m page-break overlap at ${fmt(prevTo)} m so ${fmt(newFrom)}–${fmt(to)} m follows ${fmt(prevFrom)}–${fmt(prevTo)} m.`));
+                kept.push(trimmed);
+                prev = pickDeeperPrev(prev, trimmed);
+                continue;
+            }
+            repairs.push(makeRepair('flag-unrepairable', borehole.boreholeId, index, { from, to }, { from, to }, `Overlap of ${fmt(overlap)} m at ${fmt(prevTo)} m exceeds the repairable threshold (${fmt(maxOverlap)} m) and was left for review.`));
+            kept.push(layer);
+            prev = pickDeeperPrev(prev, layer);
+            continue;
+        }
+        const gap = from - prevTo;
+        if (gap > EPSILON_M && gap <= gapTolerance) {
+            const newFrom = round3(prevTo);
+            const snapped = { ...layer, depthFrom: newFrom };
+            repairs.push(makeRepair('snap-gap', borehole.boreholeId, index, { from, to }, { from: newFrom, to }, `Snapped ${fmt(gap)} m micro-gap closed at ${fmt(prevTo)} m.`));
+            kept.push(snapped);
+            prev = pickDeeperPrev(prev, snapped);
+            continue;
+        }
+        // Contiguous, or a larger gap left for validateMergedBorehole to surface as a review finding.
+        kept.push(layer);
+        prev = pickDeeperPrev(prev, layer);
+    }
+    if (repairs.length === 0) {
+        return { borehole, repairs };
+    }
+    const repairedLayers = [...kept, ...nonNumeric.map((entry) => entry.layer)];
+    const newWarnings = repairs.map((repair) => repair.note);
+    const warnings = [...new Set([...borehole.warnings, ...newWarnings])];
+    return {
+        borehole: { ...borehole, layers: repairedLayers, warnings },
+        repairs,
+    };
+}
+//# sourceMappingURL=borehole-continuity.js.map

package/dist/ingest/borehole-continuity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"borehole-continuity.js","sourceRoot":"","sources":["../../src/ingest/borehole-continuity.ts"],"names":[],"mappings":"AAsDA,MAAM,4BAA4B,GAAG,IAAI,CAAC;AAC1C,MAAM,gCAAgC,GAAG,GAAG,CAAC;AAC7C,MAAM,SAAS,GAAG,IAAI,CAAC;AAEvB,SAAS,WAAW,CAAC,CAAS,EAAE,CAAS,EAAE,GAAG,GAAG,SAAS;IACxD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC;AAChC,CAAC;AAED,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AACzC,CAAC;AAED,SAAS,GAAG,CAAC,KAAoB;IAC/B,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,eAAe,CAAC,KAAoB;IAC3C,OAAO,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACxD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAoB;IACpC,OAAO,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACvD,CAAC;AAED,+FAA+F;AAC/F,SAAS,YAAY,CAAC,CAAgB,EAAE,CAAgB;IACtD,OAAO,eAAe,CAAC,CAAC,CAAC,KAAK,eAAe,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC;AAID,SAAS,cAAc,CAAC,KAAoB;IAC1C,OAAO,KAAK,CAAC,SAAS,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC;AAC1D,CAAC;AAED,mGAAmG;AACnG,SAAS,cAAc,CACrB,OAAoC,EACpC,SAAwB;IAExB,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC;QAAE,OAAO,OAAO,CAAC;IAC/C,IAAI,OAAO,IAAI,IAAI,IAAI,SAAS,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC9E,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAuB;IAC9D,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,IAAI,cAAc,GAAG,CAAC,CAAC;IAEvB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,SAAS,GAAG,SAAS,EAAE,CAAC;YACzE,iBAAiB,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,MAAM;SACnB,MAAM,CAAC,cAAc,CAAC;SACtB,KAAK,EAAE;SACP,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;IAEtE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QACxB,IAAI,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACzF,cAAc,IAAI,CAAC,CAAC;QACtB,CAAC;aAAM,IAAI,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,GAAG,SAAS,EAAE,CAAC;YACpD,YAAY,IAAI,CAAC,CAAC;QACpB,CAAC;aAAM,IAAI,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,GAAG,SAAS,EAAE,CAAC;YACpD,QAAQ,IAAI,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC;AACvE,CAAC;AAED,SAAS,UAAU,CACjB,MAAgC,EAChC,UAAkB,EAClB,UAAkB,EAClB,MAAsC,EACtC,KAA4C,EAC5C,IAAY;IAEZ,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACjE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAC3C,QAAgC,EAChC,UAAgD,EAAE;IAElD,MAAM,YAAY,GAAG,OAAO,CAAC,sBAAsB,IAAI,4BAA4B,CAAC;IACpF,MAAM,UAAU,GAAG,OAAO,CAAC,0BAA0B,IAAI,gCAAgC,CAAC;IAE1F,MAAM,OAAO,GAA+B,EAAE,CAAC;IAC/C,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAE3E,sFAAsF;IACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACpB,MAAM,SAAS,GAAI,CAAC,CAAC,KAAK,CAAC,SAAoB,GAAI,CAAC,CAAC,KAAK,CAAC,SAAoB,CAAC;QAChF,IAAI,SAAS,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACtC,MAAM,OAAO,GAAI,CAAC,CAAC,KAAK,CAAC,OAAkB,GAAI,CAAC,CAAC,KAAK,CAAC,OAAkB,CAAC;QAC1E,IAAI,OAAO,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC;QAClC,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAoB,EAAE,CAAC;IACjC,IAAI,IAAI,GAAgC,IAAI,CAAC;IAE7C,KAAK,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,OAAO,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,CAAC,SAAmB,CAAC;QACvC,MAAM,EAAE,GAAG,KAAK,CAAC,OAAiB,CAAC;QAEnC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;YACjB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjB,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACnC,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QAE5B,6FAA6F;QAC7F,IAAI,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACxF,OAAO,CAAC,IAAI,CACV,UAAU,CAAC,gBAAgB,EAAE,QAAQ,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EACzE,8BAA8B,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,8BAA8B,CAAC,CACpF,CAAC;YACF,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;QAC9B,IAAI,OAAO,GAAG,SAAS,EAAE,CAAC;YACxB,iDAAiD;YACjD,IAAI,EAAE,IAAI,MAAM,GAAG,SAAS,EAAE,CAAC;gBAC7B,IAAI,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;oBAC9B,OAAO,CAAC,IAAI,CACV,UAAU,CAAC,gBAAgB,EAAE,QAAQ,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EACzE,oBAAoB,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,oBAAoB,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,qBAAqB,CAAC,CACjH,CAAC;oBACF,SAAS;gBACX,CAAC;gBACD,OAAO,CAAC,IAAI,CACV,UAAU,CAAC,mBAAmB,EAAE,QAAQ,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EACpF,YAAY,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,uBAAuB,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,gCAAgC,CAAC,CACvH,CAAC;gBACF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACjB,8EAA8E;gBAC9E,SAAS;YACX,CAAC;YAED,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;gBAC1B,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC/B,MAAM,OAAO,GAAkB,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;gBAChE,OAAO,CAAC,IAAI,CACV,UAAU,CAAC,cAAc,EAAE,QAAQ,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,EACxF,WAAW,GAAG,CAAC,OAAO,CAAC,4BAA4B,GAAG,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,cAAc,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CACjJ,CAAC;gBACF,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACnB,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBACrC,SAAS;YACX,CAAC;YAED,OAAO,CAAC,IAAI,CACV,UAAU,CAAC,mBAAmB,EAAE,QAAQ,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EACpF,cAAc,GAAG,CAAC,OAAO,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,wCAAwC,GAAG,CAAC,UAAU,CAAC,8BAA8B,CAAC,CACvI,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjB,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACnC,SAAS;QACX,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,GAAG,MAAM,CAAC;QAC1B,IAAI,GAAG,GAAG,SAAS,IAAI,GAAG,IAAI,YAAY,EAAE,CAAC;YAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC/B,MAAM,OAAO,GAAkB,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;YAChE,OAAO,CAAC,IAAI,CACV,UAAU,CAAC,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,EACpF,WAAW,GAAG,CAAC,GAAG,CAAC,0BAA0B,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CACjE,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACnB,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACrC,SAAS;QACX,CAAC;QAED,8FAA8F;QAC9F,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjB,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5E,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAEtE,OAAO;QACL,QAAQ,EAAE,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE;QAC3D,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/ingest/coordinate-validation.d.ts

@@ -0,0 +1,54 @@
+import type { BoreholeLocation } from './geotech-schemas.js';
+/**
+ * Deterministic coordinate plausibility validation for ingested borehole locations.
+ *
+ * OCR and vision extraction routinely confuse digits, decimal separators, and the label/value
+ * pairing of easting vs northing. The parsing and CRS detection in `geo/coordinates.ts` recover a
+ * location, but nothing yet checks that the recovered numbers are *plausible* for the detected CRS
+ * or consistent across the boreholes of one document. This module adds those checks without
+ * touching the parsing path:
+ *
+ * - per-borehole: CRS range envelopes, suspected easting/northing axis swaps, WGS84 results outside
+ *   the CRS's geographic region, and UTM zone vs longitude consistency;
+ * - cross-borehole: mixed coordinate systems in one document and spatial outliers (the classic
+ *   OCR digit-error signature: one borehole plotting tens of kilometres from its siblings).
+ *
+ * Issues are flags for human review only — coordinates are never dropped or rewritten here.
+ */
+export type CoordinateValidationSeverity = 'advisory' | 'review';
+export type CoordinateValidationCode = 'projected_out_of_crs_range' | 'suspected_axis_swap' | 'wgs84_out_of_crs_region' | 'utm_zone_longitude_mismatch' | 'coordinate_outlier' | 'mixed_coordinate_systems';
+export interface CoordinateValidationIssue {
+    code: CoordinateValidationCode;
+    severity: CoordinateValidationSeverity;
+    message: string;
+    /** Present for borehole-scoped issues; absent for document-scoped issues. */
+    boreholeId?: string;
+}
+/**
+ * Validate a single borehole location against its detected CRS. Returns review-severity issues for
+ * out-of-range coordinates, suspected axis swaps, out-of-region WGS84 results, and UTM zone vs
+ * longitude mismatches. Locations without a recognized CRS envelope produce no issues here; the
+ * existing `validateMergedBorehole` checks (missing CRS, low CRS confidence, near-origin WGS84)
+ * remain authoritative for those cases.
+ */
+export declare function validateBoreholeLocationPlausibility(boreholeId: string, location: BoreholeLocation | null | undefined): CoordinateValidationIssue[];
+export interface BoreholeCoordinateEntry {
+    boreholeId: string;
+    location: BoreholeLocation | null | undefined;
+}
+export interface AssessBoreholeCoordinateConsistencyOptions {
+    /**
+     * A borehole whose nearest sibling is farther than this (km) while at least two other boreholes
+     * cluster within it is flagged as a spatial outlier. Default 10 km — generous enough for long
+     * linear (tunnel) alignments while still catching OCR digit errors, which typically displace a
+     * point by tens of kilometres.
+     */
+    maxNearestNeighborKm?: number;
+}
+/**
+ * Cross-borehole consistency checks for one document: mixed coordinate systems and spatial
+ * outliers. Outlier detection needs at least three located boreholes to attribute blame; with
+ * exactly two, an advisory document-scoped issue reports the separation without picking a culprit.
+ */
+export declare function assessBoreholeCoordinateConsistency(entries: BoreholeCoordinateEntry[], options?: AssessBoreholeCoordinateConsistencyOptions): CoordinateValidationIssue[];
+//# sourceMappingURL=coordinate-validation.d.ts.map

package/dist/ingest/coordinate-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinate-validation.d.ts","sourceRoot":"","sources":["../../src/ingest/coordinate-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAA6B,MAAM,sBAAsB,CAAC;AAExF;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,4BAA4B,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEjE,MAAM,MAAM,wBAAwB,GAChC,4BAA4B,GAC5B,qBAAqB,GACrB,yBAAyB,GACzB,6BAA6B,GAC7B,oBAAoB,GACpB,0BAA0B,CAAC;AAE/B,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,QAAQ,EAAE,4BAA4B,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAsED;;;;;;GAMG;AACH,wBAAgB,oCAAoC,CAClD,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,GAC5C,yBAAyB,EAAE,CAyD7B;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,0CAA0C;IACzD;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAWD;;;;GAIG;AACH,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,uBAAuB,EAAE,EAClC,OAAO,GAAE,0CAA+C,GACvD,yBAAyB,EAAE,CAsE7B"}

package/dist/ingest/coordinate-validation.js

@@ -0,0 +1,194 @@
+const BNG_ENVELOPE = {
+    label: 'British National Grid (EPSG:27700)',
+    easting: { min: 0, max: 700000 },
+    northing: { min: 0, max: 1300000 },
+    wgs84: {
+        latitude: { min: 49, max: 61.5 },
+        longitude: { min: -9, max: 2.5 },
+    },
+};
+const UTM_ENVELOPE = {
+    label: 'UTM',
+    easting: { min: 100000, max: 900000 },
+    northing: { min: 0, max: 10000000 },
+};
+/** Half-width of a UTM zone is 3 degrees; allow modest slack for boundary-zone surveys. */
+const UTM_ZONE_LONGITUDE_SLACK_DEG = 4.5;
+const DEG_TO_RAD = Math.PI / 180;
+const EARTH_RADIUS_KM = 6371;
+function within(value, range) {
+    return Number.isFinite(value) && value >= range.min && value <= range.max;
+}
+function fmt(value) {
+    return Number.isInteger(value) ? String(value) : value.toFixed(2);
+}
+function isUtmCrs(crs) {
+    if (crs.zone != null)
+        return true;
+    if (crs.epsg != null && ((crs.epsg >= 32601 && crs.epsg <= 32660) || (crs.epsg >= 32701 && crs.epsg <= 32760))) {
+        return true;
+    }
+    return crs.code === 'UTM';
+}
+function resolveCrsEnvelope(crs) {
+    if (!crs)
+        return undefined;
+    if (crs.epsg === 27700)
+        return BNG_ENVELOPE;
+    if (isUtmCrs(crs))
+        return UTM_ENVELOPE;
+    return undefined;
+}
+function haversineKm(aLat, aLon, bLat, bLon) {
+    const dLat = (bLat - aLat) * DEG_TO_RAD;
+    const dLon = (bLon - aLon) * DEG_TO_RAD;
+    const sinLat = Math.sin(dLat / 2);
+    const sinLon = Math.sin(dLon / 2);
+    const h = sinLat * sinLat
+        + Math.cos(aLat * DEG_TO_RAD) * Math.cos(bLat * DEG_TO_RAD) * sinLon * sinLon;
+    return 2 * EARTH_RADIUS_KM * Math.asin(Math.min(1, Math.sqrt(h)));
+}
+/**
+ * Validate a single borehole location against its detected CRS. Returns review-severity issues for
+ * out-of-range coordinates, suspected axis swaps, out-of-region WGS84 results, and UTM zone vs
+ * longitude mismatches. Locations without a recognized CRS envelope produce no issues here; the
+ * existing `validateMergedBorehole` checks (missing CRS, low CRS confidence, near-origin WGS84)
+ * remain authoritative for those cases.
+ */
+export function validateBoreholeLocationPlausibility(boreholeId, location) {
+    if (!location)
+        return [];
+    const issues = [];
+    const crs = location.crs;
+    const envelope = resolveCrsEnvelope(crs);
+    const projected = location.projected;
+    if (envelope && projected) {
+        const { easting, northing } = projected;
+        const inRange = within(easting, envelope.easting) && within(northing, envelope.northing);
+        const swappedInRange = within(northing, envelope.easting) && within(easting, envelope.northing);
+        if (!inRange && swappedInRange) {
+            issues.push({
+                code: 'suspected_axis_swap',
+                severity: 'review',
+                boreholeId,
+                message: `Borehole ${boreholeId} projected coordinates (E ${fmt(easting)}, N ${fmt(northing)}) fall outside the expected ${envelope.label} ranges but fit when swapped; easting and northing may be transposed.`,
+            });
+        }
+        else if (!inRange) {
+            issues.push({
+                code: 'projected_out_of_crs_range',
+                severity: 'review',
+                boreholeId,
+                message: `Borehole ${boreholeId} projected coordinates (E ${fmt(easting)}, N ${fmt(northing)}) fall outside the expected ${envelope.label} ranges and should be reviewed.`,
+            });
+        }
+    }
+    const wgs84 = location.wgs84;
+    if (envelope?.wgs84 && wgs84) {
+        if (!within(wgs84.latitude, envelope.wgs84.latitude) || !within(wgs84.longitude, envelope.wgs84.longitude)) {
+            issues.push({
+                code: 'wgs84_out_of_crs_region',
+                severity: 'review',
+                boreholeId,
+                message: `Borehole ${boreholeId} resolved to WGS84 (${fmt(wgs84.latitude)}, ${fmt(wgs84.longitude)}), outside the geographic region covered by ${envelope.label}; the CRS or coordinates should be reviewed.`,
+            });
+        }
+    }
+    if (wgs84 && crs?.zone != null && crs.zone >= 1 && crs.zone <= 60) {
+        const centralMeridian = crs.zone * 6 - 183;
+        let delta = Math.abs(wgs84.longitude - centralMeridian);
+        if (delta > 180)
+            delta = 360 - delta;
+        if (delta > UTM_ZONE_LONGITUDE_SLACK_DEG) {
+            issues.push({
+                code: 'utm_zone_longitude_mismatch',
+                severity: 'review',
+                boreholeId,
+                message: `Borehole ${boreholeId} resolved longitude ${fmt(wgs84.longitude)} is ${fmt(delta)} degrees from the central meridian of UTM zone ${crs.zone} (${fmt(centralMeridian)}); the zone or coordinates may be wrong.`,
+            });
+        }
+    }
+    return issues;
+}
+const DEFAULT_MAX_NEAREST_NEIGHBOR_KM = 10;
+function crsIdentifier(crs) {
+    if (!crs)
+        return null;
+    if (crs.epsg != null)
+        return `EPSG:${crs.epsg}`;
+    if (crs.code)
+        return crs.code;
+    return null;
+}
+/**
+ * Cross-borehole consistency checks for one document: mixed coordinate systems and spatial
+ * outliers. Outlier detection needs at least three located boreholes to attribute blame; with
+ * exactly two, an advisory document-scoped issue reports the separation without picking a culprit.
+ */
+export function assessBoreholeCoordinateConsistency(entries, options = {}) {
+    const maxNearestNeighborKm = options.maxNearestNeighborKm ?? DEFAULT_MAX_NEAREST_NEIGHBOR_KM;
+    const issues = [];
+    const crsIds = new Set();
+    for (const entry of entries) {
+        const id = crsIdentifier(entry.location?.crs);
+        if (id)
+            crsIds.add(id);
+    }
+    if (crsIds.size > 1) {
+        issues.push({
+            code: 'mixed_coordinate_systems',
+            severity: 'review',
+            message: `Boreholes in this document use ${crsIds.size} different coordinate systems (${[...crsIds].sort().join(', ')}); confirm a single project CRS before mapping.`,
+        });
+    }
+    const points = entries.flatMap((entry) => {
+        const wgs84 = entry.location?.wgs84;
+        if (!wgs84 || !Number.isFinite(wgs84.latitude) || !Number.isFinite(wgs84.longitude)) {
+            return [];
+        }
+        return [{ boreholeId: entry.boreholeId, latitude: wgs84.latitude, longitude: wgs84.longitude }];
+    });
+    if (points.length === 2) {
+        const [a, b] = points;
+        const distance = haversineKm(a.latitude, a.longitude, b.latitude, b.longitude);
+        if (distance > maxNearestNeighborKm) {
+            issues.push({
+                code: 'coordinate_outlier',
+                severity: 'advisory',
+                message: `Boreholes ${a.boreholeId} and ${b.boreholeId} plot ${fmt(distance)} km apart, beyond the expected site extent (${fmt(maxNearestNeighborKm)} km); one location may carry an OCR digit error.`,
+            });
+        }
+        return issues;
+    }
+    if (points.length < 3) {
+        return issues;
+    }
+    const nearest = points.map((point, index) => {
+        let best = Number.POSITIVE_INFINITY;
+        for (let other = 0; other < points.length; other += 1) {
+            if (other === index)
+                continue;
+            const candidate = points[other];
+            const distance = haversineKm(point.latitude, point.longitude, candidate.latitude, candidate.longitude);
+            if (distance < best)
+                best = distance;
+        }
+        return { ...point, nearestKm: best };
+    });
+    const clusteredCount = nearest.filter((point) => point.nearestKm <= maxNearestNeighborKm).length;
+    if (clusteredCount < 2) {
+        return issues;
+    }
+    for (const point of nearest) {
+        if (point.nearestKm > maxNearestNeighborKm) {
+            issues.push({
+                code: 'coordinate_outlier',
+                severity: 'review',
+                boreholeId: point.boreholeId,
+                message: `Borehole ${point.boreholeId} plots ${fmt(point.nearestKm)} km from its nearest sibling while the remaining boreholes cluster together; the coordinates likely carry an OCR digit error and should be reviewed.`,
+            });
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=coordinate-validation.js.map

package/dist/ingest/coordinate-validation.js.map

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

package/dist/ingest/geotech-extract.d.ts

@@ -5,6 +5,7 @@ import type { GlmOcrLayoutPage } from '../vision/layout-ocr.js';
 import type { ParseStatus } from '../vision/parse.js';
 import type { PdfDocumentInspection, PdfPageClassification } from './pdf.js';
 import type { IngestSegmentationSummary } from './segmentation.js';
+import { type ReconstructBoreholeContinuityOptions } from './borehole-continuity.js';
 export interface BoreholeVisionInput {
     base64: string;
     mimeType: string;
@@ -85,6 +86,8 @@ export interface IngestBoreholeLogDocumentOptions {
     interpretPageWithContext?: typeof interpretBoreholeLogWithContext;
     recoverTextHint?: typeof recoverDocumentTextHint;
     transcribePageImageText?: typeof transcribeDocumentImageText;
+    /** Optional thresholds for deterministic page-break continuity repair (defaults are conservative). */
+    continuityRepair?: ReconstructBoreholeContinuityOptions;
     now?: () => Date;
 }
 export declare function summarizeBoreholeIngestInspection(inspection: PdfDocumentInspection | null | undefined): BoreholeIngestInspectionSummary | null;

package/dist/ingest/geotech-extract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"geotech-extract.d.ts","sourceRoot":"","sources":["../../src/ingest/geotech-extract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"geotech-extract.d.ts","sourceRoot":"","sources":["../../src/ingest/geotech-extract.ts"],"names":[],"mappings":"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"}

package/dist/ingest/geotech-extract.js

@@ -1,5 +1,7 @@
 import { interpretBoreholeLog, interpretBoreholeLogWithContext, mergeBoreholeLogPages, transcribeDocumentImageText, } from '../vision/index.js';
 import { recoverDocumentTextHint } from '../vision/ocr.js';
+import { reconstructBoreholeContinuity, } from './borehole-continuity.js';
+import { assessBoreholeCoordinateConsistency, validateBoreholeLocationPlausibility, } from './coordinate-validation.js';
 function uniqueStrings(values) {
     return [...new Set(values.filter((value) => typeof value === 'string' && value.trim().length > 0))];
 }
@@ -577,10 +579,19 @@ export async function ingestBoreholeLogDocument(options) {
             ? `No pages could be ingested successfully.\n${pageFailures.join('\n')}`
             : 'No pages could be ingested successfully.');
     }
-    const mergedBoreholes = groups
+    const sanitizedBoreholes = groups
         .filter((group) => group.pages.length > 0)
         .map((group) => mergeBoreholeLogPages(group.pages, options.overrideBoreholeId ?? group.boreholeId ?? undefined))
         .map(sanitizeMergedBoreholeSptValues);
+    // Deterministic page-break continuity repair runs before validation so duplicated boundary rows,
+    // micro-gaps, and small page-break overlaps are healed, while genuine anomalies remain for
+    // validateMergedBorehole to surface authoritatively.
+    const continuityRepairs = [];
+    const mergedBoreholes = sanitizedBoreholes.map((borehole) => {
+        const reconstructed = reconstructBoreholeContinuity(borehole, options.continuityRepair ?? {});
+        continuityRepairs.push(...reconstructed.repairs);
+        return reconstructed.borehole;
+    });
     const boreholeValidationFeedback = mergedBoreholes.map((borehole) => validateMergedBorehole(borehole));
     const boreholes = mergedBoreholes.map((borehole, index) => {
         const validation = boreholeValidationFeedback[index];
@@ -650,6 +661,28 @@ export async function ingestBoreholeLogDocument(options) {
         });
     }
     reviewFindings.push(...boreholeValidationFeedback.flatMap((validation) => validation.findings));
+    reviewFindings.push(...continuityRepairs.map((repair) => ({
+        code: repair.action === 'flag-unrepairable'
+            ? 'continuity_unrepairable'
+            : 'continuity_repair_applied',
+        severity: 'advisory',
+        scope: 'borehole',
+        message: repair.note,
+        boreholeId: repair.boreholeId,
+    })));
+    // Deterministic coordinate plausibility and cross-borehole consistency checks. These only flag
+    // for review; locations are never dropped or rewritten here.
+    const coordinateIssues = [
+        ...boreholes.flatMap((borehole) => validateBoreholeLocationPlausibility(borehole.boreholeId, borehole.location)),
+        ...assessBoreholeCoordinateConsistency(boreholes.map((borehole) => ({ boreholeId: borehole.boreholeId, location: borehole.location }))),
+    ];
+    reviewFindings.push(...coordinateIssues.map((issue) => ({
+        code: issue.code,
+        severity: issue.severity,
+        scope: (issue.boreholeId != null ? 'borehole' : 'document'),
+        message: issue.message,
+        ...(issue.boreholeId != null ? { boreholeId: issue.boreholeId } : {}),
+    })));
     if (boreholes.some((borehole) => borehole.confidence < 70 || borehole.parseStatus !== 'parsed')) {
         reviewFindings.push({
             code: 'merged_borehole_incomplete',