hikoutei 0.10.1-dev → 0.10.4-dev

package/dist/sheets/providers/google-sheets-api/model/plannerReceipt.js

@@ -1,76 +1,130 @@
 /**
- * Receipt construction and result encoding for the effect planner.
+ * Sheets boundary adapter over the neutral CAS-evidence receipt encoders.
  *
- * `makeReceipt` builds a receipt record exactly like the Apps Script
- * `makeReceipt_`; the encoders translate planned outcomes into provider
- * results exactly like the Apps Script `result_` helper, including the
- * deferred-mode postcondition relabeling.
+ * The planning outcome shapes (`plannerContracts.ts`) and the Sheets result
+ * contract (`SyncEffectResult`) stay provider-owned; the receipt and
+ * result-encoding semantics live in the kernel (`@hikoutei/ikisaki`
+ * `evidence/plannerReceipt.ts`). This module maps between the two at the
+ * boundary with no semantic content of its own.
  */
 import { SYNC_EFFECT_RESULT_STATUSES, SYNC_POSTCONDITION_STATUSES } from "../../../../contracts/sheets/constants.js";
 import { presentValue, absentValue } from "../../../../contracts/state/index.js";
+import { encodeOutcomeResultEvidence, encodeSchemaErrorResultEvidence, makeReceiptEvidence, withDeferredPostconditionEvidence, } from "@hikoutei/ikisaki";
 /** Builds a receipt record exactly like `makeReceipt_`. */
 export function makeReceipt(effect, visibleHash, visibleRevision) {
-    return {
-        effectId: effect.effectId,
-        payloadHash: effect.payloadHash,
-        status: "applied",
-        visibleHash,
-        visibleRevision,
-    };
+    return makeReceiptEvidence(effect.effectId, effect.payloadHash, visibleHash, visibleRevision);
 }
 /** Encodes a planned outcome as a provider result (Apps Script `result_`). */
 export function encodeOutcomeResult(outcome) {
+    return toSyncEffectResult(encodeOutcomeResultEvidence(toOutcomeEvidence(outcome)));
+}
+/** Builds a schema_error result without any receipt-backed evidence. */
+export function encodeSchemaErrorResult(effect, reason) {
+    return toSyncEffectResult(encodeSchemaErrorResultEvidence(effect.effectId, effect.payloadHash, reason));
+}
+/** Applies the deferred-mode postcondition relabeling for applied results. */
+export function withDeferredPostcondition(result) {
+    // Non-applied results (and already-relabeled ones) pass through
+    // untouched, exactly like the historical helper — only a verified
+    // applied result is relabeled, so unlisted statuses can never be
+    // corrupted by the neutral round-trip.
+    if ((result.status !== SYNC_EFFECT_RESULT_STATUSES.APPLIED &&
+        result.status !== SYNC_EFFECT_RESULT_STATUSES.ALREADY_APPLIED) ||
+        result.postcondition !== SYNC_POSTCONDITION_STATUSES.VERIFIED) {
+        return result;
+    }
+    return toSyncEffectResult(withDeferredPostconditionEvidence(fromSyncEffectResult(result)));
+}
+/** Projects a planner outcome onto the neutral evidence shape. */
+function toOutcomeEvidence(outcome) {
     switch (outcome.kind) {
         case "applied":
+            return {
+                kind: "applied",
+                effectId: outcome.effect.effectId,
+                payloadHash: outcome.effect.payloadHash,
+                receipt: outcome.receipt,
+                created: outcome.created,
+                deletion: outcome.deletion,
+            };
         case "already_applied":
             return {
+                kind: "already_applied",
                 effectId: outcome.effect.effectId,
                 payloadHash: outcome.effect.payloadHash,
-                status: outcome.kind === "applied"
-                    ? SYNC_EFFECT_RESULT_STATUSES.APPLIED
-                    : SYNC_EFFECT_RESULT_STATUSES.ALREADY_APPLIED,
-                visibleRevision: presentValue(outcome.receipt.visibleRevision),
-                visibleHash: presentValue(outcome.receipt.visibleHash),
-                snapshotHash: absentValue(),
-                reason: absentValue(),
-                postcondition: SYNC_POSTCONDITION_STATUSES.VERIFIED,
+                receipt: outcome.receipt,
             };
         case "guard_mismatch":
         case "repair_reobserve":
         case "schema_error":
         case "retryable_error":
             return {
+                kind: outcome.kind,
                 effectId: outcome.effect.effectId,
                 payloadHash: outcome.effect.payloadHash,
-                status: outcome.kind,
-                visibleRevision: absentValue(),
-                visibleHash: absentValue(),
-                snapshotHash: absentValue(),
-                reason: presentValue(outcome.reason),
-                postcondition: SYNC_POSTCONDITION_STATUSES.UNAVAILABLE,
+                reason: outcome.reason,
             };
     }
 }
-/** Builds a schema_error result without any receipt-backed evidence. */
-export function encodeSchemaErrorResult(effect, reason) {
+/** Maps a neutral coded result onto the Sheets result contract. */
+function toSyncEffectResult(result) {
     return {
-        effectId: effect.effectId,
-        payloadHash: effect.payloadHash,
-        status: SYNC_EFFECT_RESULT_STATUSES.SCHEMA_ERROR,
-        visibleRevision: absentValue(),
-        visibleHash: absentValue(),
+        effectId: result.effectId,
+        payloadHash: result.payloadHash,
+        status: result.status === "applied"
+            ? SYNC_EFFECT_RESULT_STATUSES.APPLIED
+            : result.status === "already_applied"
+                ? SYNC_EFFECT_RESULT_STATUSES.ALREADY_APPLIED
+                : result.status === "guard_mismatch"
+                    ? SYNC_EFFECT_RESULT_STATUSES.GUARD_MISMATCH
+                    : result.status === "repair_reobserve"
+                        ? SYNC_EFFECT_RESULT_STATUSES.REPAIR_REOBSERVE
+                        : result.status === "schema_error"
+                            ? SYNC_EFFECT_RESULT_STATUSES.SCHEMA_ERROR
+                            : SYNC_EFFECT_RESULT_STATUSES.RETRYABLE_ERROR,
+        visibleRevision: result.visibleRevision === undefined
+            ? absentValue()
+            : presentValue(result.visibleRevision),
+        visibleHash: result.visibleHash === undefined
+            ? absentValue()
+            : presentValue(result.visibleHash),
         snapshotHash: absentValue(),
-        reason: presentValue(reason),
-        postcondition: SYNC_POSTCONDITION_STATUSES.UNAVAILABLE,
+        reason: result.reason === undefined ? absentValue() : presentValue(result.reason),
+        postcondition: result.postcondition === "verified"
+            ? SYNC_POSTCONDITION_STATUSES.VERIFIED
+            : result.postcondition === "acknowledged"
+                ? SYNC_POSTCONDITION_STATUSES.ACKNOWLEDGED
+                : SYNC_POSTCONDITION_STATUSES.UNAVAILABLE,
     };
 }
-/** Applies the deferred-mode postcondition relabeling for applied results. */
-export function withDeferredPostcondition(result) {
-    if ((result.status === SYNC_EFFECT_RESULT_STATUSES.APPLIED ||
-        result.status === SYNC_EFFECT_RESULT_STATUSES.ALREADY_APPLIED) &&
-        result.postcondition === SYNC_POSTCONDITION_STATUSES.VERIFIED) {
-        return { ...result, postcondition: SYNC_POSTCONDITION_STATUSES.ACKNOWLEDGED };
-    }
-    return result;
+/** Projects a Sheets result back onto the neutral coded shape. */
+function fromSyncEffectResult(result) {
+    return {
+        effectId: result.effectId,
+        payloadHash: result.payloadHash,
+        status: result.status === SYNC_EFFECT_RESULT_STATUSES.APPLIED
+            ? "applied"
+            : result.status === SYNC_EFFECT_RESULT_STATUSES.ALREADY_APPLIED
+                ? "already_applied"
+                : result.status === SYNC_EFFECT_RESULT_STATUSES.GUARD_MISMATCH
+                    ? "guard_mismatch"
+                    : result.status === SYNC_EFFECT_RESULT_STATUSES.REPAIR_REOBSERVE
+                        ? "repair_reobserve"
+                        : result.status === SYNC_EFFECT_RESULT_STATUSES.SCHEMA_ERROR
+                            ? "schema_error"
+                            : "retryable_error",
+        visibleRevision: result.visibleRevision.kind === "present"
+            ? result.visibleRevision.value
+            : undefined,
+        visibleHash: result.visibleHash.kind === "present"
+            ? result.visibleHash.value
+            : undefined,
+        reason: result.reason.kind === "present" ? result.reason.value : undefined,
+        postcondition: result.postcondition === SYNC_POSTCONDITION_STATUSES.VERIFIED
+            ? "verified"
+            : result.postcondition === SYNC_POSTCONDITION_STATUSES.ACKNOWLEDGED
+                ? "acknowledged"
+                : "unavailable",
+    };
 }
 //# sourceMappingURL=plannerReceipt.js.map

package/dist/sheets/providers/google-sheets-api/model/plannerReceipt.js.map

@@ -1 +1 @@
-{"version":3,"file":"plannerReceipt.js","sourceRoot":"","sources":["../../../../../../../../src/sheets/providers/google-sheets-api/model/plannerReceipt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AACnH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAG/E,2DAA2D;AAC3D,MAAM,UAAU,WAAW,CACzB,MAA4B,EAC5B,WAAmB,EACnB,eAAuB;IAEvB,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,MAAM,EAAE,SAAS;QACjB,WAAW;QACX,eAAe;KAChB,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,mBAAmB,CAAC,OAAuB;IACzD,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,SAAS,CAAC;QACf,KAAK,iBAAiB;YACpB,OAAO;gBACL,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ;gBACjC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW;gBACvC,MAAM,EAAE,OAAO,CAAC,IAAI,KAAK,SAAS;oBAChC,CAAC,CAAC,2BAA2B,CAAC,OAAO;oBACrC,CAAC,CAAC,2BAA2B,CAAC,eAAe;gBAC/C,eAAe,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC;gBAC9D,WAAW,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;gBACtD,YAAY,EAAE,WAAW,EAAE;gBAC3B,MAAM,EAAE,WAAW,EAAE;gBACrB,aAAa,EAAE,2BAA2B,CAAC,QAAQ;aACpD,CAAC;QACJ,KAAK,gBAAgB,CAAC;QACtB,KAAK,kBAAkB,CAAC;QACxB,KAAK,cAAc,CAAC;QACpB,KAAK,iBAAiB;YACpB,OAAO;gBACL,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ;gBACjC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW;gBACvC,MAAM,EAAE,OAAO,CAAC,IAAI;gBACpB,eAAe,EAAE,WAAW,EAAE;gBAC9B,WAAW,EAAE,WAAW,EAAE;gBAC1B,YAAY,EAAE,WAAW,EAAE;gBAC3B,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC;gBACpC,aAAa,EAAE,2BAA2B,CAAC,WAAW;aACvD,CAAC;IACN,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,uBAAuB,CACrC,MAA4B,EAC5B,MAAc;IAEd,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,MAAM,EAAE,2BAA2B,CAAC,YAAY;QAChD,eAAe,EAAE,WAAW,EAAE;QAC9B,WAAW,EAAE,WAAW,EAAE;QAC1B,YAAY,EAAE,WAAW,EAAE;QAC3B,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC;QAC5B,aAAa,EAAE,2BAA2B,CAAC,WAAW;KACvD,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,yBAAyB,CACvC,MAAwB;IAExB,IACE,CAAC,MAAM,CAAC,MAAM,KAAK,2BAA2B,CAAC,OAAO;QACpD,MAAM,CAAC,MAAM,KAAK,2BAA2B,CAAC,eAAe,CAAC;QAChE,MAAM,CAAC,aAAa,KAAK,2BAA2B,CAAC,QAAQ,EAC7D,CAAC;QACD,OAAO,EAAE,GAAG,MAAM,EAAE,aAAa,EAAE,2BAA2B,CAAC,YAAY,EAAE,CAAC;IAChF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"plannerReceipt.js","sourceRoot":"","sources":["../../../../../../../../src/sheets/providers/google-sheets-api/model/plannerReceipt.ts"],"names":[],"mappings":"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"}

package/dist/sheets/providers/google-sheets-api/model/postcondition.d.ts

@@ -1,11 +1,14 @@
 /**
- * Response-loss postcondition classifier (Apps Script `classifyPostcondition_`).
+ * Sheets boundary adapter over the neutral CAS-evidence postcondition
+ * classifier.
  *
  * Recovery probes classify one effect against a fresh target+receipt read.
- * The classifier never assumes success: a receipt proves the effect reached
- * the sheet, a matching visible hash proves the target content, and anything
- * else is `unapplied`, `changed`, or `unavailable` so the worker redrives,
- * fails, or keeps probing instead of closing the outbox on weak evidence.
+ * The Sheets context model (anchor/identity row lookup, working-row hashes,
+ * deletion-ness, route validation) stays provider-owned here; the
+ * applied/unapplied/changed/unavailable decision lives in the kernel
+ * (`@hikoutei/ikisaki` `evidence/postcondition.ts`). This module builds the
+ * neutral evidence views from the context and maps the verdict onto the
+ * Sheets postcondition contract.
  */
 import type { SyncEffectPostcondition, SyncProjectionEffect } from "../../../../contracts/sheets/syncSheets.js";
 import type { PreflightContext, PreflightReceipt } from "./preflightContext.js";

package/dist/sheets/providers/google-sheets-api/model/postcondition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postcondition.d.ts","sourceRoot":"","sources":["../../../../../../../../src/sheets/providers/google-sheets-api/model/postcondition.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAG9G,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAUhF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC9C,uBAAuB,CA+DzB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,oBAAoB,GAC3B,MAAM,GAAG,SAAS,CAGpB"}
+{"version":3,"file":"postcondition.d.ts","sourceRoot":"","sources":["../../../../../../../../src/sheets/providers/google-sheets-api/model/postcondition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAO9G,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAUhF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC9C,uBAAuB,CA0BzB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,oBAAoB,GAC3B,MAAM,GAAG,SAAS,CAGpB"}

package/dist/sheets/providers/google-sheets-api/model/postcondition.js

@@ -1,14 +1,18 @@
 /**
- * Response-loss postcondition classifier (Apps Script `classifyPostcondition_`).
+ * Sheets boundary adapter over the neutral CAS-evidence postcondition
+ * classifier.
  *
  * Recovery probes classify one effect against a fresh target+receipt read.
- * The classifier never assumes success: a receipt proves the effect reached
- * the sheet, a matching visible hash proves the target content, and anything
- * else is `unapplied`, `changed`, or `unavailable` so the worker redrives,
- * fails, or keeps probing instead of closing the outbox on weak evidence.
+ * The Sheets context model (anchor/identity row lookup, working-row hashes,
+ * deletion-ness, route validation) stays provider-owned here; the
+ * applied/unapplied/changed/unavailable decision lives in the kernel
+ * (`@hikoutei/ikisaki` `evidence/postcondition.ts`). This module builds the
+ * neutral evidence views from the context and maps the verdict onto the
+ * Sheets postcondition contract.
  */
 import { PRESENCE_KINDS } from "../../../../contracts/state/index.js";
 import { presentValue, absentValue } from "../../../../contracts/state/index.js";
+import { classifyCasPostcondition, } from "@hikoutei/ikisaki";
 import { currentHash, findWorkingRow, toWorkingRow, } from "./plannerWorkingRow.js";
 import { isDeletionEffect } from "./plannerDeletion.js";
 import { requireProviderEffect } from "./planner.js";
@@ -27,51 +31,21 @@ export function classifyPostcondition(context, effect, receipts) {
     };
     requireProviderEffect(effect, request, context);
     const receipt = receipts.get(effect.effectId);
-    if (receipt !== undefined && receipt.payloadHash !== effect.payloadHash) {
-        return postcondition("changed", absentValue(), absentValue());
-    }
     const row = findProbeRow(context, effect);
-    if (isDeletionEffect(effect.effectKind)) {
-        if (receipt !== undefined && row === undefined) {
-            return postcondition("applied", presentValue(receipt.visibleRevision), presentValue(receipt.visibleHash));
-        }
-        if (row === undefined) {
-            // An absent row without this effect's receipt could be a manual
-            // deletion; never let that absence close an outbox effect.
-            return postcondition("unavailable", absentValue(), absentValue());
-        }
-        const deleteHash = currentHash(row, effect.payload.fields);
-        if (receipt !== undefined) {
-            return postcondition("changed", absentValue(), presentValue(deleteHash));
-        }
-        return deleteHash === effect.expectedVisibleHash
-            ? postcondition("unapplied", presentValue(effect.expectedVisibleRevision), presentValue(deleteHash))
-            : postcondition("changed", absentValue(), presentValue(deleteHash));
-    }
-    // A receipt alone cannot prove that a non-delete row still exists; a manual
-    // deletion must remain observable instead of closing the outbox.
-    if (row === undefined) {
-        return postcondition(receipt !== undefined || !effect.payload.createIfMissing ? "changed" : "unapplied", absentValue(), absentValue(), receipt === undefined ? undefined : "receipt_target_missing");
-    }
-    const current = currentHash(row, effect.payload.fields);
-    if (current === effect.payload.targetVisibleHash) {
-        if (receipt === undefined) {
-            // The row already carries the target content, but without a receipt
-            // there is no durable proof that this effect was applied by the
-            // provider: the two-batch inline path can crash between the target-row
-            // write and the receipt write and leave exactly this orphan. Closing
-            // the outbox on row-hash evidence alone would turn that crash into a
-            // false success, so stay fail-closed.
-            return postcondition("unavailable", absentValue(), presentValue(current), "receipt_missing");
-        }
-        return postcondition("applied", presentValue(receipt.visibleRevision), presentValue(current));
-    }
-    const repairGuard = effect.repairGuardHash;
-    if (current === effect.expectedVisibleHash ||
-        (repairGuard.kind === PRESENCE_KINDS.PRESENT && current === repairGuard.value)) {
-        return postcondition("unapplied", presentValue(effect.expectedVisibleRevision), presentValue(current));
-    }
-    return postcondition("changed", absentValue(), presentValue(current));
+    const verdict = classifyCasPostcondition(toClassifyInput(effect, receipt, row));
+    return {
+        disposition: verdict.disposition,
+        visibleRevision: verdict.visibleRevision === undefined
+            ? absentValue()
+            : presentValue(verdict.visibleRevision),
+        visibleHash: verdict.visibleHash === undefined
+            ? absentValue()
+            : presentValue(verdict.visibleHash),
+        // The direct provider never computes a snapshot hash; recovery does not
+        // need it and the Apps Script provider also returns null here.
+        snapshotHash: absentValue(),
+        ...(verdict.reason === undefined ? {} : { reason: verdict.reason }),
+    };
 }
 /**
  * Locates the row number the probe's `findProbeRow` will classify for one
@@ -85,6 +59,33 @@ export function probeTargetRowNumber(context, effect) {
     const row = findProbeRow(context, effect);
     return row === undefined ? undefined : row.rowNumber;
 }
+/** Projects one effect plus its read-back evidence onto the neutral input. */
+function toClassifyInput(effect, receipt, row) {
+    return {
+        isDeletion: isDeletionEffect(effect.effectKind),
+        expectedVisibleHash: effect.expectedVisibleHash,
+        expectedVisibleRevision: effect.expectedVisibleRevision,
+        targetVisibleHash: effect.payload.targetVisibleHash,
+        createIfMissing: effect.payload.createIfMissing,
+        repairGuardHash: effect.repairGuardHash.kind === PRESENCE_KINDS.PRESENT
+            ? effect.repairGuardHash.value
+            : null,
+        effectPayloadHash: effect.payloadHash,
+        receipt: receipt === undefined
+            ? undefined
+            : {
+                payloadHash: receipt.payloadHash,
+                visibleRevision: receipt.visibleRevision,
+                visibleHash: receipt.visibleHash,
+            },
+        observedRow: row === undefined
+            ? undefined
+            : {
+                rowNumber: row.rowNumber,
+                currentHash: currentHash(row, effect.payload.fields),
+            },
+    };
+}
 function findProbeRow(context, effect) {
     const byAnchor = new Map();
     const byIdentity = new Map();
@@ -101,15 +102,4 @@ function findProbeRow(context, effect) {
     }
     return findWorkingRow(byAnchor, byIdentity, effect.payload.targetAnchor, effect.targetId);
 }
-function postcondition(disposition, visibleRevision, visibleHash, reason) {
-    const result = {
-        disposition,
-        visibleRevision,
-        visibleHash,
-        // The direct provider never computes a snapshot hash; recovery does not
-        // need it and the Apps Script provider also returns null here.
-        snapshotHash: absentValue(),
-    };
-    return reason === undefined ? result : { ...result, reason };
-}
 //# sourceMappingURL=postcondition.js.map

package/dist/sheets/providers/google-sheets-api/model/postcondition.js.map

@@ -1 +1 @@
-{"version":3,"file":"postcondition.js","sourceRoot":"","sources":["../../../../../../../../src/sheets/providers/google-sheets-api/model/postcondition.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"postcondition.js","sourceRoot":"","sources":["../../../../../../../../src/sheets/providers/google-sheets-api/model/postcondition.ts"],"names":[],"mappings":"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"}

package/dist/sheets/providers/google-sheets-api/model/preflightContext.d.ts

@@ -12,8 +12,7 @@ import type { NormalizedCell } from "../../../../contracts/encoding/types.js";
 import type { Presence } from "../../../../contracts/state/index.js";
 import type { SyncMissingTabOperation } from "../../../../contracts/sheets/errors.js";
 import type { GoogleSheetsApiTransport } from "../transport/googleSheetsApiTransport.js";
-import type { ReceiptReadCursor } from "./receiptCursor.js";
-import { type EngineRuntime, type PlannedRange, type ReadCalibration, type ReadEvidence } from "./readPlan.js";
+import { type BandEvidence, type BandRange, type EngineRuntime, type ReadCalibration, type ReceiptReadCursor } from "@hikoutei/ikisaki";
 /** One validated merged-cell region (a GridRange) from a sheet payload. */
 export interface ParsedMergedCell {
     readonly sheetId?: number;
@@ -187,7 +186,7 @@ credentialIndex?: number): Promise<readonly ParsedSheet[]>;
  */
 export interface PreflightReadShape {
     readonly scoped: boolean;
-    readonly cursor?: ReceiptReadCursor;
+    readonly cursor?: ReceiptReadCursor<PreflightReceipt>;
 }
 /** The historical whole-table read shape (every fallback/recovery path). */
 export declare const LEGACY_PREFLIGHT_READ_SHAPE: PreflightReadShape;
@@ -207,7 +206,7 @@ export declare const LEGACY_PREFLIGHT_READ_SHAPE: PreflightReadShape;
  * a title (a transport that never reports `gridProperties`) the historical
  * single open band is planned unchanged (correct, un-banded).
  */
-export declare function buildPreflightRanges(routes: readonly PreflightRouteOptions[], receiptSheet: ParsedSheet | undefined, shape?: PreflightReadShape, receiptBandStart?: number | undefined, rowBounds?: ReadonlyMap<string, number>, calibration?: ReadCalibration | undefined, evidence?: ReadEvidence): readonly PlannedRange[];
+export declare function buildPreflightRanges(routes: readonly PreflightRouteOptions[], receiptSheet: ParsedSheet | undefined, shape?: PreflightReadShape, receiptBandStart?: number | undefined, rowBounds?: ReadonlyMap<string, number>, calibration?: ReadCalibration | undefined, evidence?: BandEvidence): readonly BandRange[];
 /**
  * True when one route's TARGET read is column-scoped (header row + key-column
  * bands) rather than full-width: only key-column routes can hide non-key row
@@ -221,7 +220,7 @@ export declare function routeUsesColumnScope(route: PreflightRouteOptions, scope
  * on the lane the runtime was built for), so a chunked plan is sequential
  * but lands as ONE reassembled logical document for the context builders.
  */
-export declare function readPreflightData(engine: EngineRuntime, route: PreflightRouteOptions, sheets: readonly ParsedSheet[], 
+export declare function readPreflightData(engine: EngineRuntime<ParsedSheet, number, ParsedGridData>, route: PreflightRouteOptions, sheets: readonly ParsedSheet[], 
 /** Field mask override; defaults to the values-only base mask. The
  * oversized-verification fallback passes the full-evidence preflight mask
  * to reproduce the historical whole-table read exactly. */
@@ -235,7 +234,7 @@ shape?: PreflightReadShape): Promise<PreflightContext>;
  * invalid provider state (e.g. a missing tab) detected while building a
  * route context.
  */
-export declare function readPreflightDataForRoutes(engine: EngineRuntime, routes: readonly PreflightRouteOptions[], sheets: readonly ParsedSheet[], operation?: SyncMissingTabOperation, 
+export declare function readPreflightDataForRoutes(engine: EngineRuntime<ParsedSheet, number, ParsedGridData>, routes: readonly PreflightRouteOptions[], sheets: readonly ParsedSheet[], operation?: SyncMissingTabOperation, 
 /** Field mask override; defaults to the values-only base mask (see
  * `readPreflightData`). */
 fields?: string, 

package/dist/sheets/providers/google-sheets-api/model/preflightContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preflightContext.d.ts","sourceRoot":"","sources":["../../../../../../../../src/sheets/providers/google-sheets-api/model/preflightContext.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"preflightContext.d.ts","sourceRoot":"","sources":["../../../../../../../../src/sheets/providers/google-sheets-api/model/preflightContext.ts"],"names":[],"mappings":"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"}

package/dist/sheets/providers/google-sheets-api/model/preflightContext.js

@@ -14,7 +14,8 @@ import { GOOGLE_SHEETS_API_ENUMERATION_FIELDS, GOOGLE_SHEETS_API_PREFLIGHT_BASE_
 import { GoogleSheetsApiTransportError, invalidProviderState, } from "../errors.js";
 import { PRESENCE_KINDS } from "../../../../contracts/state/constants.js";
 import { columnLetters, parseRegisteredRange, quoteA1SheetName, } from "./valueNormalization.js";
-import { authoritativeRowBound, packReadRequests, planRowBands, } from "./readPlan.js";
+import { authoritativeRowBound, packReadRequests, planRowBands, } from "@hikoutei/ikisaki";
+import { SHEET_MAX_ROW } from "../constants.js";
 import { apiNumberValue, apiStringValue, parseSheetPropertiesDocument, } from "./preflightParsing.js";
 import { anchorColumnFor, checkColumnFor, findSheetByTitle, gridRowCells, indexRows, pickRegisteredGrid, readRows, requireSheetByTitle, requireSheetGrids, requireSingleGrid, resolveGridCell, synthesizeScopedTargetGrid, } from "./preflightRows.js";
 import { readRegisteredHeaders, validateCheckboxHeaders, } from "./preflightHeaders.js";
@@ -71,9 +72,9 @@ export function buildPreflightRanges(routes, receiptSheet, shape = LEGACY_PREFLI
     const ranges = [];
     const push = (items) => {
         for (const item of items) {
-            if (seen.has(item.range))
+            if (seen.has(item.address))
                 continue;
-            seen.add(item.range);
+            seen.add(item.address);
             ranges.push(item);
         }
     };
@@ -83,9 +84,10 @@ export function buildPreflightRanges(routes, receiptSheet, shape = LEGACY_PREFLI
     if (receiptSheet !== undefined) {
         const receiptQuote = `${quoteA1SheetName(GOOGLE_SHEETS_API_RECEIPT_SHEET_NAME)}!`;
         push(planRowBands({
-            quote: receiptQuote,
-            firstLetter: "A",
-            lastLetter: columnLetters(GOOGLE_SHEETS_API_RECEIPT_HEADERS.length),
+            addressPrefix: receiptQuote,
+            firstColumn: "A",
+            lastColumn: columnLetters(GOOGLE_SHEETS_API_RECEIPT_HEADERS.length),
+            openEndRow: SHEET_MAX_ROW,
             columnCount: GOOGLE_SHEETS_API_RECEIPT_HEADERS.length,
             fromRow: receiptBandStart === undefined || receiptBandStart < 2 ? 1 : receiptBandStart,
             rowBound: rowBounds.get(GOOGLE_SHEETS_API_RECEIPT_SHEET_NAME),
@@ -123,9 +125,10 @@ function scopedOrFullTargetRanges(route, scoped, rowBounds, calibration, evidenc
     const calib = calibration ?? NO_CALIBRATION;
     const bound = rowBounds.get(route.sheetName);
     const fullSpan = () => planRowBands({
-        quote,
-        firstLetter: "A",
-        lastLetter: columnLetters(lastColumn),
+        addressPrefix: quote,
+        firstColumn: "A",
+        lastColumn: columnLetters(lastColumn),
+        openEndRow: SHEET_MAX_ROW,
         columnCount: lastColumn,
         fromRow: 1,
         rowBound: bound,
@@ -140,14 +143,14 @@ function scopedOrFullTargetRanges(route, scoped, rowBounds, calibration, evidenc
     const checkProbeItem = checkProbe === undefined
         ? []
         : [{
-                range: `${quote}${columnLetters(checkProbe)}1:${columnLetters(checkProbe)}1`,
+                address: `${quote}${columnLetters(checkProbe)}1:${columnLetters(checkProbe)}1`,
                 cells: 1,
             }];
     if (!scoped)
         return [...fullSpan(), ...checkProbeItem];
     const lastLetter = columnLetters(lastColumn);
     const headerBand = [{
-            range: `${quote}A1:${lastLetter}1`,
+            address: `${quote}A1:${lastLetter}1`,
             cells: lastColumn,
         }];
     const columns = [];
@@ -167,9 +170,10 @@ function scopedOrFullTargetRanges(route, scoped, rowBounds, calibration, evidenc
     for (const column of new Set(columns)) {
         const letter = columnLetters(column);
         ranges.push(...planRowBands({
-            quote,
-            firstLetter: letter,
-            lastLetter: letter,
+            addressPrefix: quote,
+            firstColumn: letter,
+            lastColumn: letter,
+            openEndRow: SHEET_MAX_ROW,
             columnCount: 1,
             fromRow: 2,
             rowBound: bound,
@@ -236,7 +240,10 @@ async function readPreflightContextsWithCursor(engine, routes, sheets, receiptSh
     if (receiptSheet !== undefined)
         titles.push(receiptSheet.title);
     for (const title of titles) {
-        const bound = authoritativeRowBound(sheets, engine.rowBounds, title);
+        const bound = authoritativeRowBound(sheets.map((sheet) => ({
+            title: sheet.title,
+            rowCount: sheet.gridProperties?.rowCount,
+        })), engine.rowBounds, title);
         if (bound !== undefined)
             rowBounds.set(title, bound);
     }