hikoutei 0.4.2 → 0.4.3

package/dist/application/sync/outbound/effects/SyncEffectWorkerConstants.d.ts

@@ -1,85 +0,0 @@
-/** Constants and durable status contracts shared by the effect worker modules. */
-export declare const DEFAULT_WORKER_ROLE = "sync-effect-worker";
-/** Outbound writer lease must outlive the longest remote effect request. */
-export declare const DEFAULT_WRITER_LEASE_DURATION_MS = 180000;
-/** Minimum headroom between the remote timeout and the effect lease. */
-export declare const EFFECT_LEASE_PROVIDER_HEADROOM_MS = 30000;
-/** Must exceed the 60-second provider transport timeout plus recovery margin. */
-export declare const DEFAULT_EFFECT_LEASE_DURATION_MS = 120000;
-/**
- * Maximum effects one provider `applyEffects` call will acknowledge.
- *
- * The remote provider caps a single bounded effect batch (see
- * `MAX_EFFECTS_PER_REQUEST` in the Google Sheets API provider defaults).
- * Chunking each physical route's dispatch to this limit keeps every request
- * inside that batch, so an oversized configured worker limit (`maxEffects`)
- * does not turn one route into repeated partial (`hasMore`) responses and the
- * deferred/requeue churn they cause.
- */
-export declare const EFFECT_BATCH_LIMIT = 20;
-/**
- * Maximum number of effects leased before dispatch starts. Selection may use a
- * larger SQLite upper bound, but a worker pass must not lease an unbounded
- * backlog while a remote batch is in flight.
- */
-export declare const MAX_IN_FLIGHT_EFFECTS = 20;
-/**
- * Maximum eligible fast-append rows one worker pass may select/claim in the
- * real provider runtime. The bulk append operation writes the whole reserved
- * target range in one `spreadsheets.batchUpdate` request (an atomic
- * target-plus-receipt batch), so a bulk pass can claim this many append
- * candidates while regular and recovery effects keep the bounded 20-effect
- * window below.
- */
-export declare const FAST_APPEND_BATCH_CANDIDATE_LIMIT = 1000;
-/**
- * Minimum interval between fast-append request starts in the real provider
- * runtime. The adaptive batch controller remembers the last append request
- * start across supervisor passes and waits only the remaining time before the
- * next append request; regular applyEffects calls never wait on this throttle.
- */
-export declare const APPEND_DISPATCH_THROTTLE_INTERVAL_MS = 1100;
-export declare const SYNC_EFFECT_KINDS: {
-    readonly SYSTEM_PROJECTION: "system_projection";
-    readonly CANDIDATE_RECONCILE: "candidate_reconcile";
-    readonly SYSTEM_REPAIR: "system_repair";
-    readonly RESOLUTION_PROJECTION: "resolution_projection";
-    readonly RESOLUTION_DELETE: "resolution_delete";
-    readonly USER_INPUT_DELETE: "user_input_delete";
-};
-export declare const EFFECT_TARGET_KINDS: {
-    readonly ENTITY: "entity";
-    readonly ROW_BINDING: "row_binding";
-    readonly PROJECTION_ROW: "projection_row";
-    readonly CONFLICT: "conflict";
-};
-export declare const OUTBOX_EFFECT_STATUSES: {
-    readonly DELIVERY_UNCERTAIN: "delivery_uncertain";
-    readonly FAILED: "failed";
-    readonly APPLIED: "applied";
-    readonly BLOCKED_CANDIDATE: "blocked_candidate";
-    readonly SUPERSEDED: "superseded";
-    readonly CONFLICT: "conflict";
-};
-export declare const WORKER_ERROR_CODES: {
-    readonly INVALID_EFFECT_PAYLOAD: "invalid_effect_payload";
-    readonly ACTIVE_CANDIDATE_PRESERVED: "active_candidate_preserved";
-    readonly PROVIDER_SUPERSEDED: "provider_superseded";
-    readonly CANDIDATE_GUARD_MISMATCH: "candidate_guard_mismatch";
-    readonly VISIBLE_GUARD_MISMATCH: "visible_guard_mismatch";
-    readonly PROVIDER_SCHEMA_ERROR: "provider_schema_error";
-    readonly PROVIDER_REMOTE_ERROR: "provider_remote_error";
-    readonly PROVIDER_RETRYABLE_ERROR: "provider_retryable_error";
-    readonly DELIVERY_UNCERTAIN_REQUIRES_PROBE: "delivery_uncertain_requires_probe";
-    readonly POSTCONDITION_READ_FAILED: "postcondition_read_failed";
-    readonly POSTCONDITION_APPLIED_WITHOUT_VISIBLE_STATE: "postcondition_applied_without_visible_state";
-    readonly POSTCONDITION_UNAVAILABLE: "postcondition_unavailable";
-    readonly POSTCONDITION_CHANGED: "postcondition_changed";
-    readonly POSTCONDITION_UNAPPLIED_REQUIRES_REDRIVE: "postcondition_unapplied_requires_redrive";
-    readonly REPAIR_REOBSERVE_REQUIRES_WRITER_REPLAN: "repair_reobserve_requires_writer_replan";
-    readonly REPAIR_REPLAN_FAILED: "repair_replan_failed";
-    readonly REPAIR_REPLAN_DEFERRED: "repair_replan_deferred";
-    readonly PROVIDER_CAPABILITY_MISSING: "provider_capability_missing";
-};
-export type SyncEffectWorkerErrorCode = (typeof WORKER_ERROR_CODES)[keyof typeof WORKER_ERROR_CODES];
-//# sourceMappingURL=SyncEffectWorkerConstants.d.ts.map

package/dist/application/sync/outbound/effects/SyncEffectWorkerConstants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SyncEffectWorkerConstants.d.ts","sourceRoot":"","sources":["../../../../../src/application/sync/outbound/effects/SyncEffectWorkerConstants.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAUlF,eAAO,MAAM,mBAAmB,uBAAuB,CAAC;AACxD,4EAA4E;AAC5E,eAAO,MAAM,gCAAgC,SAAU,CAAC;AACxD,wEAAwE;AACxE,eAAO,MAAM,iCAAiC,QAAS,CAAC;AACxD,iFAAiF;AACjF,eAAO,MAAM,gCAAgC,SAAU,CAAC;AAExD;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,KAAqB,CAAC;AACxD;;;;;;;GAOG;AACH,eAAO,MAAM,iCAAiC,OAAQ,CAAC;AACvD;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,OAAQ,CAAC;AAE1D,eAAO,MAAM,iBAAiB;;;;;;;CAA8D,CAAC;AAE7F,eAAO,MAAM,mBAAmB;;;;;CAA2E,CAAC;AAE5G,eAAO,MAAM,sBAAsB;;;;;;;CAOc,CAAC;AAElD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;CAqBrB,CAAC;AAEX,MAAM,MAAM,yBAAyB,GACnC,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/application/sync/outbound/effects/SyncEffectWorkerConstants.js

@@ -1,74 +0,0 @@
-/** Constants and durable status contracts shared by the effect worker modules. */
-import { EFFECT_KINDS as CANONICAL_EFFECT_KINDS, EFFECT_STATUSES as CANONICAL_EFFECT_STATUSES, EFFECT_TARGET_KINDS as CANONICAL_EFFECT_TARGET_KINDS, } from "../../../../domain/model/constants.js";
-import { SYNC_EFFECT_RECOVERY_ERROR_CODES } from "../../../../infrastructure/storage/sync/outbound/effectOutbox.js";
-export const DEFAULT_WORKER_ROLE = "sync-effect-worker";
-/** Outbound writer lease must outlive the longest remote effect request. */
-export const DEFAULT_WRITER_LEASE_DURATION_MS = 180_000;
-/** Minimum headroom between the remote timeout and the effect lease. */
-export const EFFECT_LEASE_PROVIDER_HEADROOM_MS = 30_000;
-/** Must exceed the 60-second provider transport timeout plus recovery margin. */
-export const DEFAULT_EFFECT_LEASE_DURATION_MS = 120_000;
-/**
- * Maximum effects one provider `applyEffects` call will acknowledge.
- *
- * The remote provider caps a single bounded effect batch (see
- * `MAX_EFFECTS_PER_REQUEST` in the Google Sheets API provider defaults).
- * Chunking each physical route's dispatch to this limit keeps every request
- * inside that batch, so an oversized configured worker limit (`maxEffects`)
- * does not turn one route into repeated partial (`hasMore`) responses and the
- * deferred/requeue churn they cause.
- */
-export const EFFECT_BATCH_LIMIT = 20;
-/**
- * Maximum number of effects leased before dispatch starts. Selection may use a
- * larger SQLite upper bound, but a worker pass must not lease an unbounded
- * backlog while a remote batch is in flight.
- */
-export const MAX_IN_FLIGHT_EFFECTS = EFFECT_BATCH_LIMIT;
-/**
- * Maximum eligible fast-append rows one worker pass may select/claim in the
- * real provider runtime. The bulk append operation writes the whole reserved
- * target range in one `spreadsheets.batchUpdate` request (an atomic
- * target-plus-receipt batch), so a bulk pass can claim this many append
- * candidates while regular and recovery effects keep the bounded 20-effect
- * window below.
- */
-export const FAST_APPEND_BATCH_CANDIDATE_LIMIT = 1_000;
-/**
- * Minimum interval between fast-append request starts in the real provider
- * runtime. The adaptive batch controller remembers the last append request
- * start across supervisor passes and waits only the remaining time before the
- * next append request; regular applyEffects calls never wait on this throttle.
- */
-export const APPEND_DISPATCH_THROTTLE_INTERVAL_MS = 1_100;
-export const SYNC_EFFECT_KINDS = CANONICAL_EFFECT_KINDS;
-export const EFFECT_TARGET_KINDS = CANONICAL_EFFECT_TARGET_KINDS;
-export const OUTBOX_EFFECT_STATUSES = {
-    DELIVERY_UNCERTAIN: CANONICAL_EFFECT_STATUSES.DELIVERY_UNCERTAIN,
-    FAILED: CANONICAL_EFFECT_STATUSES.FAILED,
-    APPLIED: CANONICAL_EFFECT_STATUSES.APPLIED,
-    BLOCKED_CANDIDATE: CANONICAL_EFFECT_STATUSES.BLOCKED_CANDIDATE,
-    SUPERSEDED: CANONICAL_EFFECT_STATUSES.SUPERSEDED,
-    CONFLICT: CANONICAL_EFFECT_STATUSES.CONFLICT,
-};
-export const WORKER_ERROR_CODES = {
-    INVALID_EFFECT_PAYLOAD: "invalid_effect_payload",
-    ACTIVE_CANDIDATE_PRESERVED: "active_candidate_preserved",
-    PROVIDER_SUPERSEDED: "provider_superseded",
-    CANDIDATE_GUARD_MISMATCH: "candidate_guard_mismatch",
-    VISIBLE_GUARD_MISMATCH: "visible_guard_mismatch",
-    PROVIDER_SCHEMA_ERROR: "provider_schema_error",
-    PROVIDER_REMOTE_ERROR: "provider_remote_error",
-    PROVIDER_RETRYABLE_ERROR: SYNC_EFFECT_RECOVERY_ERROR_CODES.PROVIDER_RETRYABLE_ERROR,
-    DELIVERY_UNCERTAIN_REQUIRES_PROBE: SYNC_EFFECT_RECOVERY_ERROR_CODES.DELIVERY_UNCERTAIN_REQUIRES_PROBE,
-    POSTCONDITION_READ_FAILED: SYNC_EFFECT_RECOVERY_ERROR_CODES.POSTCONDITION_READ_FAILED,
-    POSTCONDITION_APPLIED_WITHOUT_VISIBLE_STATE: "postcondition_applied_without_visible_state",
-    POSTCONDITION_UNAVAILABLE: SYNC_EFFECT_RECOVERY_ERROR_CODES.POSTCONDITION_UNAVAILABLE,
-    POSTCONDITION_CHANGED: "postcondition_changed",
-    POSTCONDITION_UNAPPLIED_REQUIRES_REDRIVE: SYNC_EFFECT_RECOVERY_ERROR_CODES.POSTCONDITION_UNAPPLIED_REQUIRES_REDRIVE,
-    REPAIR_REOBSERVE_REQUIRES_WRITER_REPLAN: "repair_reobserve_requires_writer_replan",
-    REPAIR_REPLAN_FAILED: "repair_replan_failed",
-    REPAIR_REPLAN_DEFERRED: "repair_replan_deferred",
-    PROVIDER_CAPABILITY_MISSING: "provider_capability_missing",
-};
-//# sourceMappingURL=SyncEffectWorkerConstants.js.map

package/dist/application/sync/outbound/effects/SyncEffectWorkerConstants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SyncEffectWorkerConstants.js","sourceRoot":"","sources":["../../../../../src/application/sync/outbound/effects/SyncEffectWorkerConstants.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAGlF,OAAO,EACL,YAAY,IAAI,sBAAsB,EACtC,eAAe,IAAI,yBAAyB,EAC5C,mBAAmB,IAAI,6BAA6B,GACrD,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,gCAAgC,EAAE,MAAM,kEAAkE,CAAC;AAEpH,MAAM,CAAC,MAAM,mBAAmB,GAAG,oBAAoB,CAAC;AACxD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,gCAAgC,GAAG,OAAO,CAAC;AACxD,wEAAwE;AACxE,MAAM,CAAC,MAAM,iCAAiC,GAAG,MAAM,CAAC;AACxD,iFAAiF;AACjF,MAAM,CAAC,MAAM,gCAAgC,GAAG,OAAO,CAAC;AAExD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AACrC;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AACxD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,KAAK,CAAC;AACvD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,KAAK,CAAC;AAE1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,sBAA2D,CAAC;AAE7F,MAAM,CAAC,MAAM,mBAAmB,GAAG,6BAAwE,CAAC;AAE5G,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,kBAAkB,EAAE,yBAAyB,CAAC,kBAAkB;IAChE,MAAM,EAAE,yBAAyB,CAAC,MAAM;IACxC,OAAO,EAAE,yBAAyB,CAAC,OAAO;IAC1C,iBAAiB,EAAE,yBAAyB,CAAC,iBAAiB;IAC9D,UAAU,EAAE,yBAAyB,CAAC,UAAU;IAChD,QAAQ,EAAE,yBAAyB,CAAC,QAAQ;CACG,CAAC;AAElD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,sBAAsB,EAAE,wBAAwB;IAChD,0BAA0B,EAAE,4BAA4B;IACxD,mBAAmB,EAAE,qBAAqB;IAC1C,wBAAwB,EAAE,0BAA0B;IACpD,sBAAsB,EAAE,wBAAwB;IAChD,qBAAqB,EAAE,uBAAuB;IAC9C,qBAAqB,EAAE,uBAAuB;IAC9C,wBAAwB,EAAE,gCAAgC,CAAC,wBAAwB;IACnF,iCAAiC,EAC/B,gCAAgC,CAAC,iCAAiC;IACpE,yBAAyB,EAAE,gCAAgC,CAAC,yBAAyB;IACrF,2CAA2C,EAAE,6CAA6C;IAC1F,yBAAyB,EAAE,gCAAgC,CAAC,yBAAyB;IACrF,qBAAqB,EAAE,uBAAuB;IAC9C,wCAAwC,EACtC,gCAAgC,CAAC,wCAAwC;IAC3E,uCAAuC,EAAE,yCAAyC;IAClF,oBAAoB,EAAE,sBAAsB;IAC5C,sBAAsB,EAAE,wBAAwB;IAChD,2BAA2B,EAAE,6BAA6B;CAClD,CAAC"}

package/dist/application/sync/outbound/effects/SyncEffectWorkerDispatch.d.ts

@@ -1,31 +0,0 @@
-/** Fast-append and unsupported-capability dispatch paths for the effect worker. */
-import type { FencingContext } from "../../../../infrastructure/storage/sync/shared/writerLease.js";
-import type { FastAppendRowsRequest, SyncEffectWorkerProvider } from "../../sheets/syncSheets.js";
-import { type TransportOutcome } from "../../sheets/transportOutcome.js";
-import type { ClaimedEffect, EffectWorkerStorage, MutableReport, SyncEffectWorkerBaseOptions } from "./SyncEffectWorker.js";
-/** Fails regular effects explicitly when the configured provider is fast-only. */
-export declare function rejectUnsupportedProviderEffects(storage: EffectWorkerStorage, fence: FencingContext, items: readonly ClaimedEffect[], report: MutableReport): Promise<void>;
-/**
- * Handles a failed remote dispatch at the transport boundary.
- *
- * A thrown batch-level dispatch error is not per-effect rejection evidence for
- * an uncertain transport. Explicit structured remote failures are different:
- * the provider has returned a verified rejection, so they close the effects in
- * the terminal failure path rather than entering recovery.
- */
-export declare function handleProviderDispatchError(options: SyncEffectWorkerBaseOptions, storage: EffectWorkerStorage, fence: FencingContext, items: readonly ClaimedEffect[], report: MutableReport, outcome: TransportOutcome, fullProvider?: SyncEffectWorkerProvider, beforeRecovery?: () => Promise<boolean>, onUncertainWithoutRecovery?: () => Promise<void>): Promise<void>;
-/**
- * Dispatches append-only rows through the idempotent provider batch operation.
- * A lost response is still returned to recovery; the provider receipt batch lets
- * the next attempt classify an already committed write without appending again.
- *
- * When the full provider runtime configured the append throttle, the request
- * waits only the time remaining since the previous append request started;
- * regular applyEffects dispatch never waits on this throttle.
- */
-export declare function dispatchFastAppendGroup(options: SyncEffectWorkerBaseOptions, storage: EffectWorkerStorage, fence: FencingContext, group: {
-    readonly request: FastAppendRowsRequest;
-    readonly items: readonly ClaimedEffect[];
-}, report: MutableReport, fullProvider?: SyncEffectWorkerProvider, beforeRecovery?: () => Promise<boolean>): Promise<void>;
-export declare function requeueFastAppendItems(storage: EffectWorkerStorage, fence: FencingContext, items: readonly ClaimedEffect[], report: MutableReport): Promise<void>;
-//# sourceMappingURL=SyncEffectWorkerDispatch.d.ts.map

package/dist/application/sync/outbound/effects/SyncEffectWorkerDispatch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SyncEffectWorkerDispatch.d.ts","sourceRoot":"","sources":["../../../../../src/application/sync/outbound/effects/SyncEffectWorkerDispatch.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+DAA+D,CAAC;AAEpG,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACzB,MAAM,4BAA4B,CAAC;AAoBpC,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,2BAA2B,EAC5B,MAAM,uBAAuB,CAAC;AAE/B,kFAAkF;AAClF,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC,CAkCf;AAED;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,gBAAgB,EACzB,YAAY,CAAC,EAAE,wBAAwB,EACvC,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EACvC,0BAA0B,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAC/C,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE;IACL,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C,EACD,MAAM,EAAE,aAAa,EACrB,YAAY,CAAC,EAAE,wBAAwB,EACvC,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAqJf;AA2CD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/dist/application/sync/outbound/effects/SyncEffectWorkerDispatch.js

@@ -1,222 +0,0 @@
-/** Fast-append and unsupported-capability dispatch paths for the effect worker. */
-import { LOOKUP_RESULT_KINDS, presentValue } from "../../../../shared/state/index.js";
-import { SYNC_TIMING_OPERATION_KINDS, SYNC_TIMING_SCOPES, } from "../../telemetry/syncTiming.js";
-import { WORKER_ERROR_CODES } from "./SyncEffectWorkerConstants.js";
-import { isPresent, lookupResult, } from "./SyncEffectWorkerHelpers.js";
-import { completeApplied, completeFailure, recoverUnknownResults, } from "./SyncEffectWorkerTransitions.js";
-import { emitProviderTiming, emitWorkerTiming, } from "./SyncEffectWorkerTiming.js";
-import { routeKey } from "./SyncEffectWorkerRouting.js";
-import { classifyTransportOutcome, TRANSPORT_OUTCOME_KINDS, } from "../../sheets/transportOutcome.js";
-/** Fails regular effects explicitly when the configured provider is fast-only. */
-export async function rejectUnsupportedProviderEffects(storage, fence, items, report) {
-    for (const item of items) {
-        if (item.pending.status === "delivery_uncertain") {
-            await markUncertainWithoutRecovery(storage, fence, [item], report, "The configured provider cannot probe an uncertain delivery yet.");
-            continue;
-        }
-        if (!isPresent(item.providerEffect)) {
-            await completeFailure(storage, fence, item, WORKER_ERROR_CODES.INVALID_EFFECT_PAYLOAD, item.invalidPayloadError, report);
-            continue;
-        }
-        await completeFailure(storage, fence, item, WORKER_ERROR_CODES.PROVIDER_CAPABILITY_MISSING, presentValue("The configured provider supports fast append only; regular effect dispatch or recovery is unavailable."), report);
-    }
-}
-/**
- * Handles a failed remote dispatch at the transport boundary.
- *
- * A thrown batch-level dispatch error is not per-effect rejection evidence for
- * an uncertain transport. Explicit structured remote failures are different:
- * the provider has returned a verified rejection, so they close the effects in
- * the terminal failure path rather than entering recovery.
- */
-export async function handleProviderDispatchError(options, storage, fence, items, report, outcome, fullProvider, beforeRecovery, onUncertainWithoutRecovery) {
-    if (outcome.kind === TRANSPORT_OUTCOME_KINDS.EXPLICIT_REMOTE_FAILURE) {
-        for (const item of items) {
-            await completeFailure(storage, fence, item, WORKER_ERROR_CODES.PROVIDER_REMOTE_ERROR, presentValue(outcome.message), report);
-        }
-        return;
-    }
-    if (fullProvider === undefined) {
-        if (onUncertainWithoutRecovery !== undefined) {
-            await onUncertainWithoutRecovery();
-            return;
-        }
-        await markUncertainWithoutRecovery(storage, fence, items, report, outcome.message);
-        return;
-    }
-    if (beforeRecovery === undefined || await beforeRecovery()) {
-        await recoverUnknownResults({ ...options, provider: fullProvider }, storage, fence, items, report);
-    }
-}
-/**
- * Dispatches append-only rows through the idempotent provider batch operation.
- * A lost response is still returned to recovery; the provider receipt batch lets
- * the next attempt classify an already committed write without appending again.
- *
- * When the full provider runtime configured the append throttle, the request
- * waits only the time remaining since the previous append request started;
- * regular applyEffects dispatch never waits on this throttle.
- */
-export async function dispatchFastAppendGroup(options, storage, fence, group, report, fullProvider, beforeRecovery) {
-    const throttleStartedAt = Date.now();
-    const throttledMs = await options.batchController?.waitForAppendThrottle(throttleStartedAt) ?? 0;
-    if (throttledMs > 0) {
-        emitWorkerTiming(options, {
-            scope: SYNC_TIMING_SCOPES.WORKER,
-            phase: "append_throttle_wait",
-            durationMs: Date.now() - throttleStartedAt,
-            operationKinds: [SYNC_TIMING_OPERATION_KINDS.APPEND],
-            operationCounts: { append: group.items.length, update: 0, delete: 0 },
-        });
-    }
-    let response;
-    const providerStartedAt = Date.now();
-    options.batchController?.beginAppendDispatch(providerStartedAt);
-    const requestRouteKey = routeKey(group.request);
-    const batchLimit = options.batchController?.beginDispatch(requestRouteKey, providerStartedAt) ?? group.items.length;
-    try {
-        response = await options.provider.fastAppendRows(group.request);
-    }
-    catch (error) {
-        const outcome = classifyTransportOutcome(error);
-        options.batchController?.observe(requestRouteKey, {
-            durationMs: Date.now() - providerStartedAt,
-            responseSucceeded: false,
-            responseLoss: outcome.kind === TRANSPORT_OUTCOME_KINDS.DELIVERY_UNCERTAIN,
-        });
-        const failedDurationMs = Date.now() - providerStartedAt;
-        emitWorkerTiming(options, {
-            scope: SYNC_TIMING_SCOPES.WORKER,
-            phase: "append_provider_dispatch",
-            durationMs: failedDurationMs,
-            operationKinds: [SYNC_TIMING_OPERATION_KINDS.APPEND],
-            operationCounts: { append: group.items.length, update: 0, delete: 0 },
-            routeKey: requestRouteKey,
-            batchLimit,
-            responseSucceeded: false,
-        });
-        const resultFence = {
-            ...fence,
-            now: options.clock?.() ?? fence.now + Math.max(0, Date.now() - providerStartedAt),
-        };
-        await handleProviderDispatchError(options, storage, resultFence, group.items, report, outcome, fullProvider, beforeRecovery, () => markFastAppendUncertain(storage, resultFence, group.items, report, outcome.message));
-        return;
-    }
-    const durationMs = Date.now() - providerStartedAt;
-    const resultFence = {
-        ...fence,
-        now: options.clock?.() ?? fence.now + Math.max(0, Date.now() - providerStartedAt),
-    };
-    options.batchController?.observe(requestRouteKey, {
-        durationMs,
-        responseSucceeded: response.results.length === group.items.length && !response.hasMore,
-        responseLoss: response.results.length !== group.items.length || response.hasMore,
-    });
-    emitProviderTiming(options, response.timing);
-    emitWorkerTiming(options, {
-        scope: SYNC_TIMING_SCOPES.WORKER,
-        phase: "append_provider_dispatch",
-        durationMs,
-        operationKinds: [SYNC_TIMING_OPERATION_KINDS.APPEND],
-        operationCounts: { append: group.items.length, update: 0, delete: 0 },
-        routeKey: requestRouteKey,
-        batchLimit,
-        responseSucceeded: response.results.length === group.items.length && !response.hasMore,
-    });
-    const resultPersistenceStartedAt = Date.now();
-    const byEffectId = new Map(response.results.map((result) => [result.effectId, result]));
-    const deferredEffectIds = new Set();
-    const recoveryItems = [];
-    for (const item of group.items) {
-        if (byEffectId.has(item.pending.effect_id) || !response.hasMore)
-            continue;
-        if (await storage.releaseUnprocessedEffect({
-            ...resultFence,
-            effectId: item.pending.effect_id,
-            claimToken: item.claimToken,
-        })) {
-            deferredEffectIds.add(item.pending.effect_id);
-            report.deferred += 1;
-        }
-    }
-    for (const item of group.items) {
-        if (deferredEffectIds.has(item.pending.effect_id))
-            continue;
-        const result = lookupResult(byEffectId.get(item.pending.effect_id));
-        if (result.kind === LOOKUP_RESULT_KINDS.NOT_FOUND) {
-            await requeueFastAppendItems(storage, resultFence, [item], report);
-            continue;
-        }
-        if (!isPresent(item.providerEffect)) {
-            await requeueFastAppendItems(storage, resultFence, [item], report);
-            continue;
-        }
-        if (!hasReceiptBackedVisibleEvidence(result.value)) {
-            // A fast-append status is not enough to close a worker-owned effect. The
-            // append receipt must provide the remote visible revision and hash; do
-            // not synthesize either value from local expectations or payload data.
-            recoveryItems.push(item);
-            continue;
-        }
-        await completeApplied(storage, resultFence, item, presentValue(result.value.visibleRevision), presentValue(result.value.visibleHash), report);
-    }
-    if (recoveryItems.length > 0) {
-        const recoveryFence = {
-            ...resultFence,
-            now: options.clock?.() ?? resultFence.now,
-        };
-        if (fullProvider !== undefined && (beforeRecovery === undefined || await beforeRecovery())) {
-            await recoverUnknownResults({ ...options, provider: fullProvider }, storage, recoveryFence, recoveryItems, report);
-        }
-        else {
-            await markFastAppendUncertain(storage, recoveryFence, recoveryItems, report, "Fast append did not return receipt-backed visible evidence.");
-        }
-    }
-    emitWorkerTiming(options, {
-        scope: SYNC_TIMING_SCOPES.WORKER,
-        phase: "append_result_persistence",
-        durationMs: Date.now() - resultPersistenceStartedAt,
-        operationKinds: [SYNC_TIMING_OPERATION_KINDS.APPEND],
-        operationCounts: { append: group.items.length, update: 0, delete: 0 },
-    });
-}
-function hasReceiptBackedVisibleEvidence(result) {
-    return typeof result.visibleRevision === "number" &&
-        Number.isSafeInteger(result.visibleRevision) &&
-        result.visibleRevision >= 1 &&
-        typeof result.visibleHash === "string" &&
-        result.visibleHash.length > 0;
-}
-/** Returns a response-lost fast append to pending for reconciliation-backed retry. */
-async function markFastAppendUncertain(storage, fence, items, report, message) {
-    await markUncertainWithoutRecovery(storage, fence, items, report, message);
-}
-async function markUncertainWithoutRecovery(storage, fence, items, report, message) {
-    for (const item of items) {
-        if (await storage.markDeliveryUncertain({
-            ...fence,
-            effectId: item.pending.effect_id,
-            claimToken: item.claimToken,
-            uncertainSince: item.pending.uncertain_since ?? fence.now,
-            nextProbeAt: fence.now + 1_000,
-            lastErrorCode: WORKER_ERROR_CODES.DELIVERY_UNCERTAIN_REQUIRES_PROBE,
-            lastErrorMessage: message,
-        }))
-            report.deferred += 1;
-    }
-}
-export async function requeueFastAppendItems(storage, fence, items, report) {
-    for (const item of items) {
-        if (await storage.retryClaimedEffect({
-            ...fence,
-            effectId: item.pending.effect_id,
-            claimToken: item.claimToken,
-            lastErrorCode: WORKER_ERROR_CODES.PROVIDER_RETRYABLE_ERROR,
-            lastErrorMessage: "Fast append response was not observed; the row will be retried and reconciled later.",
-        })) {
-            report.deferred += 1;
-            report.requeued += 1;
-        }
-    }
-}
-//# sourceMappingURL=SyncEffectWorkerDispatch.js.map

package/dist/application/sync/outbound/effects/SyncEffectWorkerDispatch.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SyncEffectWorkerDispatch.js","sourceRoot":"","sources":["../../../../../src/application/sync/outbound/effects/SyncEffectWorkerDispatch.ts"],"names":[],"mappings":"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"}

package/dist/application/sync/outbound/effects/SyncEffectWorkerHelpers.d.ts

@@ -1,14 +0,0 @@
-/** Small value and error helpers shared by effect-worker modules. */
-import type { Applicability, LookupResult, Presence } from "../../../../domain/index.js";
-import { PRESENCE_KINDS } from "../../../../shared/state/constants.js";
-export declare function safeErrorMessage(error: unknown): string;
-export type PresentValue<T> = {
-    readonly kind: typeof PRESENCE_KINDS.PRESENT;
-    readonly value: T;
-};
-export declare function isPresent<T>(value: Presence<T>): value is PresentValue<T>;
-export declare function isAbsent<T>(value: Presence<T>): boolean;
-export declare function lookupResult<T>(value: T | undefined): LookupResult<T>;
-export declare function applicabilityFromSqlNullable<T>(value: T | null): Applicability<T>;
-export declare function throwWorkerError(message: string): never;
-//# sourceMappingURL=SyncEffectWorkerHelpers.d.ts.map

package/dist/application/sync/outbound/effects/SyncEffectWorkerHelpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SyncEffectWorkerHelpers.d.ts","sourceRoot":"","sources":["../../../../../src/application/sync/outbound/effects/SyncEffectWorkerHelpers.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAErE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACzF,OAAO,EAEL,cAAc,EACf,MAAM,uCAAuC,CAAC;AAU/C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEvD;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,cAAc,CAAC,OAAO,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;CACnB,CAAC;AAEF,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,YAAY,CAAC,CAAC,CAAC,CAEzE;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAEvD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,YAAY,CAAC,CAAC,CAAC,CAIrE;AAED,wBAAgB,4BAA4B,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,CAEjF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAEvD"}

package/dist/application/sync/outbound/effects/SyncEffectWorkerHelpers.js

@@ -1,25 +0,0 @@
-/** Small value and error helpers shared by effect-worker modules. */
-import { LOOKUP_RESULT_KINDS, PRESENCE_KINDS, } from "../../../../shared/state/constants.js";
-import { applicableValue, notApplicableValue, } from "../../../../shared/state/index.js";
-import { STORAGE_ERROR_CODES, StorageError, } from "../../../../infrastructure/storage/errors.js";
-export function safeErrorMessage(error) {
-    return error instanceof Error ? error.message.slice(0, 500) : "unknown sync provider failure";
-}
-export function isPresent(value) {
-    return value.kind === PRESENCE_KINDS.PRESENT;
-}
-export function isAbsent(value) {
-    return value.kind === PRESENCE_KINDS.ABSENT;
-}
-export function lookupResult(value) {
-    return value === undefined
-        ? { kind: LOOKUP_RESULT_KINDS.NOT_FOUND }
-        : { kind: LOOKUP_RESULT_KINDS.FOUND, value };
-}
-export function applicabilityFromSqlNullable(value) {
-    return value === null ? notApplicableValue() : applicableValue(value);
-}
-export function throwWorkerError(message) {
-    throw new StorageError(STORAGE_ERROR_CODES.INVALID_PENDING_EFFECT, message);
-}
-//# sourceMappingURL=SyncEffectWorkerHelpers.js.map

package/dist/application/sync/outbound/effects/SyncEffectWorkerHelpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SyncEffectWorkerHelpers.js","sourceRoot":"","sources":["../../../../../src/application/sync/outbound/effects/SyncEffectWorkerHelpers.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAGrE,OAAO,EACL,mBAAmB,EACnB,cAAc,GACf,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,eAAe,EACf,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,mBAAmB,EACnB,YAAY,GACb,MAAM,8CAA8C,CAAC;AAEtD,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,+BAA+B,CAAC;AAChG,CAAC;AAOD,MAAM,UAAU,SAAS,CAAI,KAAkB;IAC7C,OAAO,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,OAAO,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAI,KAAkB;IAC5C,OAAO,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,MAAM,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,YAAY,CAAI,KAAoB;IAClD,OAAO,KAAK,KAAK,SAAS;QACxB,CAAC,CAAC,EAAE,IAAI,EAAE,mBAAmB,CAAC,SAAS,EAAE;QACzC,CAAC,CAAC,EAAE,IAAI,EAAE,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAI,KAAe;IAC7D,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,IAAI,YAAY,CAAC,mBAAmB,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;AAC9E,CAAC"}

package/dist/application/sync/outbound/effects/SyncEffectWorkerRouting.d.ts

@@ -1,61 +0,0 @@
-/** Effect conversion, request grouping, and routing predicates. */
-import type { EffectTargetKind } from "../../../../domain/index.js";
-import type { PendingEffect, WriterLease, FencingContext } from "../../../../infrastructure/storage/index.js";
-import type { ApplySyncEffectsRequest, FastAppendRowsRequest, ReadSyncEffectPostconditionsRequest, SyncProjectionEffect, SyncEffectResult, SyncProjection } from "../../sheets/syncSheets.js";
-import type { ClaimedEffect } from "./SyncEffectWorker.js";
-/** Accepts either inline read-back or a flushed-write acknowledgement. */
-export declare function isSuccessfulPostcondition(status: SyncEffectResult["postcondition"]): boolean;
-export declare function toProviderEffect(effect: PendingEffect): SyncProjectionEffect;
-export declare function groupByProviderRequest(items: readonly ClaimedEffect[]): readonly ProviderEffectGroup[];
-/** One append-only route paired with the claimed effects it represents. */
-export interface FastAppendProviderGroup {
-    readonly request: FastAppendRowsRequest;
-    readonly items: readonly ClaimedEffect[];
-}
-/** Groups append-only effects into one fast provider request per route. */
-export declare function groupByFastAppendRequest(items: readonly ClaimedEffect[]): readonly FastAppendProviderGroup[];
-/** Splits append groups using the same adaptive route limit as regular effects. */
-export declare function chunkFastAppendGroups(groups: readonly FastAppendProviderGroup[], limit: number | ((group: FastAppendProviderGroup) => number)): readonly FastAppendProviderGroup[];
-/** Groups postcondition reads so each group performs one remote Sheet scan. */
-export declare function groupByPostconditionRequest(items: readonly ClaimedEffect[]): readonly {
-    readonly request: ReadSyncEffectPostconditionsRequest;
-    readonly items: readonly ClaimedEffect[];
-}[];
-/** Builds the stable grouping key shared by all provider operations on one route. */
-export declare function routeKey(route: SyncProjectionEffect | ApplySyncEffectsRequest | FastAppendRowsRequest): string;
-/**
- * Splits each physical-route group into sub-batches no larger than the
- * provider's bounded effect batch (`EFFECT_BATCH_LIMIT` in the worker
- * constants, matching `MAX_EFFECTS_PER_REQUEST` in the Google Sheets API
- * provider constants) so one `applyEffects` call returns a complete result
- * set instead of a `hasMore` partial prefix.
- *
- * The physical-route grouping and the per-target predecessor ordering of the
- * supplied items are preserved: every effect stays on its original route, and
- * each sub-batch keeps the order of the ready selection. Effects in one ready
- * selection target distinct logical targets (the outbox only marks the
- * earliest non-applied effect per target ready), so sub-batching never
- * reorders effects that depend on one another.
- */
-export declare function chunkProviderEffectGroups(groups: readonly ProviderEffectGroup[], limit?: number | ((group: ProviderEffectGroup) => number)): readonly ProviderEffectGroup[];
-/** One physical route's effects paired with their provider request. */
-export interface ProviderEffectGroup {
-    readonly request: ApplySyncEffectsRequest;
-    readonly items: readonly ClaimedEffect[];
-}
-export declare function isSyncEffectKind(value: string): value is SyncProjectionEffect["effectKind"];
-export declare function isCandidateProtectingUserInputEffect(effect: SyncProjectionEffect): boolean;
-/** Selects only new System_State entity rows for the append-only fast path. */
-export declare function isFastAppendCandidate(item: ClaimedEffect): boolean;
-/** Classifies one converted provider effect as an append-only fast candidate. */
-export declare function isFastAppendEffect(effect: SyncProjectionEffect): boolean;
-/**
- * Pending-level fast-append classification used to bound a bulk claim window
- * before conversion. Recovery-status effects are excluded because the claim
- * loop diverts them to recovery regardless of their append shape.
- */
-export declare function isFastAppendPendingEffect(pending: PendingEffect): boolean;
-export declare function isSyncProjection(value: string): value is SyncProjection;
-export declare function isEffectTargetKind(value: string): value is EffectTargetKind;
-export declare function fenceFromLease(lease: WriterLease, now: number): FencingContext;
-//# sourceMappingURL=SyncEffectWorkerRouting.d.ts.map

package/dist/application/sync/outbound/effects/SyncEffectWorkerRouting.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SyncEffectWorkerRouting.d.ts","sourceRoot":"","sources":["../../../../../src/application/sync/outbound/effects/SyncEffectWorkerRouting.ts"],"names":[],"mappings":"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"}