hikoutei 0.2.0

package/dist/infrastructure/storage/errors.d.ts

@@ -0,0 +1,55 @@
+/** Stable error categories shared by the storage layer. */
+export declare const STORAGE_ERROR_CODES: {
+    readonly INVALID_WRITER_LEASE_OPTIONS: "invalid_writer_lease_options";
+    readonly INVALID_SYNC_REGISTRATION: "invalid_sync_registration";
+    readonly SYNC_REGISTRATION_WRITE_FAILED: "sync_registration_write_failed";
+    readonly SYNC_REGISTRATION_CONFLICT: "sync_registration_conflict";
+    readonly SYNC_REGISTRY_TARGET_UNAVAILABLE: "sync_registry_target_unavailable";
+    readonly INVALID_OBSERVATION_INPUT: "invalid_observation_input";
+    readonly OBSERVATION_STORAGE_INCONSISTENT: "observation_storage_inconsistent";
+    readonly OBSERVATION_AUDIT_SERIALIZATION_FAILED: "observation_audit_serialization_failed";
+    readonly INVALID_READ_ONLY_OBSERVATION: "invalid_read_only_observation";
+    readonly INVALID_EFFECT_OPTIONS: "invalid_effect_options";
+    readonly INVALID_PENDING_EFFECT: "invalid_pending_effect";
+    readonly INVALID_PROJECTION_SEED: "invalid_projection_seed";
+    readonly PROJECTION_SEED_CONFLICT: "projection_seed_conflict";
+    readonly EFFECT_WRITE_FAILED: "effect_write_failed";
+    readonly EFFECT_REPLAN_CONFLICT: "effect_replan_conflict";
+    readonly INVALID_EFFECT_RESULT: "invalid_effect_result";
+    readonly INVALID_PROJECTION_CONFIRMATION: "invalid_projection_confirmation";
+    readonly PROJECTION_CONFIRMATION_REGRESSION: "projection_confirmation_regression";
+    readonly STALE_WRITER_FENCE: "stale_writer_fence";
+    readonly INVALID_RESTORE_OPTIONS: "invalid_restore_options";
+    readonly INVALID_RESTORE_BACKUP: "invalid_restore_backup";
+    readonly RESTORE_INSPECTION_MISMATCH: "restore_inspection_mismatch";
+    readonly RESTORE_ID_CONFLICT: "restore_id_conflict";
+    readonly INVALID_RESTORE_RECONCILIATION: "invalid_restore_reconciliation";
+    readonly RESTORE_RECONCILIATION_STATE_INVALID: "restore_reconciliation_state_invalid";
+    readonly INVALID_CUTOVER_OPTIONS: "invalid_cutover_options";
+    readonly CUTOVER_STATE_INVALID: "cutover_state_invalid";
+    readonly CUTOVER_IDENTITY_CONFLICT: "cutover_identity_conflict";
+    readonly CUTOVER_CHECKPOINT_FAILED: "cutover_checkpoint_failed";
+    readonly INVALID_SYNC_DEPLOYMENT_CONFIG: "invalid_sync_deployment_config";
+    readonly INVALID_SYNC_OPERATIONAL_LIMITS: "invalid_sync_operational_limits";
+    readonly SYNC_OPERATIONAL_HEALTH_UNAVAILABLE: "sync_operational_health_unavailable";
+    readonly INVALID_RESOLUTION_COMMAND: "invalid_resolution_command";
+    readonly RESOLUTION_COMMAND_IDENTITY_CONFLICT: "resolution_command_identity_conflict";
+    readonly RESOLUTION_STORAGE_INCONSISTENT: "resolution_storage_inconsistent";
+    readonly RESOLUTION_EFFECT_CONFLICT: "resolution_effect_conflict";
+    readonly RESOLUTION_TARGET_UNAVAILABLE: "resolution_target_unavailable";
+    readonly INVALID_STORED_CONFLICT: "invalid_stored_conflict";
+    readonly SQLITE_RUNTIME_UNAVAILABLE: "sqlite_runtime_unavailable";
+    readonly SCHEMA_VERSION_TOO_NEW: "schema_version_too_new";
+    readonly SCHEMA_TABLE_MISSING: "schema_table_missing";
+    readonly SCHEMA_INDEX_MISSING: "schema_index_missing";
+    readonly SCHEMA_COLUMN_MISSING: "schema_column_missing";
+    readonly SCHEMA_VERSION_INVALID: "schema_version_invalid";
+    readonly INVALID_SQL_SCRIPT: "invalid_sql_script";
+};
+export type StorageErrorCode = (typeof STORAGE_ERROR_CODES)[keyof typeof STORAGE_ERROR_CODES];
+/** Error raised when storage input, schema, or runtime prerequisites are invalid. */
+export declare class StorageError extends Error {
+    readonly code: StorageErrorCode;
+    constructor(code: StorageErrorCode, message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/infrastructure/storage/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/storage/errors.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CtB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAEjE,qFAAqF;AACrF,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;gBAEpB,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAK5E"}

package/dist/infrastructure/storage/errors.js

@@ -0,0 +1,58 @@
+/** Stable error categories shared by the storage layer. */
+export const STORAGE_ERROR_CODES = {
+    INVALID_WRITER_LEASE_OPTIONS: "invalid_writer_lease_options",
+    INVALID_SYNC_REGISTRATION: "invalid_sync_registration",
+    SYNC_REGISTRATION_WRITE_FAILED: "sync_registration_write_failed",
+    SYNC_REGISTRATION_CONFLICT: "sync_registration_conflict",
+    SYNC_REGISTRY_TARGET_UNAVAILABLE: "sync_registry_target_unavailable",
+    INVALID_OBSERVATION_INPUT: "invalid_observation_input",
+    OBSERVATION_STORAGE_INCONSISTENT: "observation_storage_inconsistent",
+    OBSERVATION_AUDIT_SERIALIZATION_FAILED: "observation_audit_serialization_failed",
+    INVALID_READ_ONLY_OBSERVATION: "invalid_read_only_observation",
+    INVALID_EFFECT_OPTIONS: "invalid_effect_options",
+    INVALID_PENDING_EFFECT: "invalid_pending_effect",
+    INVALID_PROJECTION_SEED: "invalid_projection_seed",
+    PROJECTION_SEED_CONFLICT: "projection_seed_conflict",
+    EFFECT_WRITE_FAILED: "effect_write_failed",
+    EFFECT_REPLAN_CONFLICT: "effect_replan_conflict",
+    INVALID_EFFECT_RESULT: "invalid_effect_result",
+    INVALID_PROJECTION_CONFIRMATION: "invalid_projection_confirmation",
+    PROJECTION_CONFIRMATION_REGRESSION: "projection_confirmation_regression",
+    STALE_WRITER_FENCE: "stale_writer_fence",
+    INVALID_RESTORE_OPTIONS: "invalid_restore_options",
+    INVALID_RESTORE_BACKUP: "invalid_restore_backup",
+    RESTORE_INSPECTION_MISMATCH: "restore_inspection_mismatch",
+    RESTORE_ID_CONFLICT: "restore_id_conflict",
+    INVALID_RESTORE_RECONCILIATION: "invalid_restore_reconciliation",
+    RESTORE_RECONCILIATION_STATE_INVALID: "restore_reconciliation_state_invalid",
+    INVALID_CUTOVER_OPTIONS: "invalid_cutover_options",
+    CUTOVER_STATE_INVALID: "cutover_state_invalid",
+    CUTOVER_IDENTITY_CONFLICT: "cutover_identity_conflict",
+    CUTOVER_CHECKPOINT_FAILED: "cutover_checkpoint_failed",
+    INVALID_SYNC_DEPLOYMENT_CONFIG: "invalid_sync_deployment_config",
+    INVALID_SYNC_OPERATIONAL_LIMITS: "invalid_sync_operational_limits",
+    SYNC_OPERATIONAL_HEALTH_UNAVAILABLE: "sync_operational_health_unavailable",
+    INVALID_RESOLUTION_COMMAND: "invalid_resolution_command",
+    RESOLUTION_COMMAND_IDENTITY_CONFLICT: "resolution_command_identity_conflict",
+    RESOLUTION_STORAGE_INCONSISTENT: "resolution_storage_inconsistent",
+    RESOLUTION_EFFECT_CONFLICT: "resolution_effect_conflict",
+    RESOLUTION_TARGET_UNAVAILABLE: "resolution_target_unavailable",
+    INVALID_STORED_CONFLICT: "invalid_stored_conflict",
+    SQLITE_RUNTIME_UNAVAILABLE: "sqlite_runtime_unavailable",
+    SCHEMA_VERSION_TOO_NEW: "schema_version_too_new",
+    SCHEMA_TABLE_MISSING: "schema_table_missing",
+    SCHEMA_INDEX_MISSING: "schema_index_missing",
+    SCHEMA_COLUMN_MISSING: "schema_column_missing",
+    SCHEMA_VERSION_INVALID: "schema_version_invalid",
+    INVALID_SQL_SCRIPT: "invalid_sql_script",
+};
+/** Error raised when storage input, schema, or runtime prerequisites are invalid. */
+export class StorageError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.name = "StorageError";
+        this.code = code;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/infrastructure/storage/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/infrastructure/storage/errors.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,4BAA4B,EAAE,8BAA8B;IAC5D,yBAAyB,EAAE,2BAA2B;IACtD,8BAA8B,EAAE,gCAAgC;IAChE,0BAA0B,EAAE,4BAA4B;IACxD,gCAAgC,EAAE,kCAAkC;IACpE,yBAAyB,EAAE,2BAA2B;IACtD,gCAAgC,EAAE,kCAAkC;IACpE,sCAAsC,EAAE,wCAAwC;IAChF,6BAA6B,EAAE,+BAA+B;IAC9D,sBAAsB,EAAE,wBAAwB;IAChD,sBAAsB,EAAE,wBAAwB;IAChD,uBAAuB,EAAE,yBAAyB;IAClD,wBAAwB,EAAE,0BAA0B;IACpD,mBAAmB,EAAE,qBAAqB;IAC1C,sBAAsB,EAAE,wBAAwB;IAChD,qBAAqB,EAAE,uBAAuB;IAC9C,+BAA+B,EAAE,iCAAiC;IAClE,kCAAkC,EAAE,oCAAoC;IACxE,kBAAkB,EAAE,oBAAoB;IACxC,uBAAuB,EAAE,yBAAyB;IAClD,sBAAsB,EAAE,wBAAwB;IAChD,2BAA2B,EAAE,6BAA6B;IAC1D,mBAAmB,EAAE,qBAAqB;IAC1C,8BAA8B,EAAE,gCAAgC;IAChE,oCAAoC,EAAE,sCAAsC;IAC5E,uBAAuB,EAAE,yBAAyB;IAClD,qBAAqB,EAAE,uBAAuB;IAC9C,yBAAyB,EAAE,2BAA2B;IACtD,yBAAyB,EAAE,2BAA2B;IACtD,8BAA8B,EAAE,gCAAgC;IAChE,+BAA+B,EAAE,iCAAiC;IAClE,mCAAmC,EAAE,qCAAqC;IAC1E,0BAA0B,EAAE,4BAA4B;IACxD,oCAAoC,EAAE,sCAAsC;IAC5E,+BAA+B,EAAE,iCAAiC;IAClE,0BAA0B,EAAE,4BAA4B;IACxD,6BAA6B,EAAE,+BAA+B;IAC9D,uBAAuB,EAAE,yBAAyB;IAClD,0BAA0B,EAAE,4BAA4B;IACxD,sBAAsB,EAAE,wBAAwB;IAChD,oBAAoB,EAAE,sBAAsB;IAC5C,oBAAoB,EAAE,sBAAsB;IAC5C,qBAAqB,EAAE,uBAAuB;IAC9C,sBAAsB,EAAE,wBAAwB;IAChD,kBAAkB,EAAE,oBAAoB;CAChC,CAAC;AAKX,qFAAqF;AACrF,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,IAAI,CAAmB;IAEhC,YAAY,IAAsB,EAAE,OAAe,EAAE,OAAsB;QACzE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/infrastructure/storage/index.d.ts

@@ -0,0 +1,23 @@
+export { CURRENT_SCHEMA_VERSION, migrateSchema, schemaDdl } from "./sqlite/schema.js";
+export type { SchemaMigrationResult } from "./sqlite/schema.js";
+export { CANONICAL_COMMIT_RESULT_KINDS, CANONICAL_COMMIT_STALE_TARGETS, commitCanonicalChanges, commitCanonicalChangesWithAdapter, commitCanonicalChangesWithSql, } from "./state/canonical/canonicalCommit.js";
+export type { CanonicalCommitInput, CanonicalCommitResult, CanonicalFieldWrite, CanonicalFieldCommitInput, CanonicalInsertCommitInput, CanonicalUpdateCommitInput, CanonicalDeleteCommitInput, } from "./state/canonical/canonicalCommit.js";
+export { openDatabase, openReadOnlyDatabase, getDatabaseSync, withImmediateTransaction, } from "./sqlite/sqliteBridge.js";
+export type { DatabaseSyncLike, StatementLike } from "./sqlite/sqliteBridge.js";
+export { claimWriterLease, claimWriterLeaseWithAdapter, claimWriterLeaseWithSql, readWriterLease, readWriterLeaseWithAdapter, readWriterLeaseWithSql, isFencingValid, isFencingValidWithAdapter, isFencingValidWithSql, } from "./sync/shared/writerLease.js";
+export { WRITER_LEASE_CLAIM_FAILURE_REASONS, WRITER_LEASE_CLAIM_RESULT_KINDS, } from "./sync/shared/writerLease.js";
+export type { WriterLease, ClaimLeaseOptions, FencingContext, WriterLeaseClaimFailureReason, WriterLeaseClaimResult, WriterLeaseClaimResultKind, } from "./sync/shared/writerLease.js";
+export { claimEffect, claimEffectWithAdapter, claimEffectWithSql, applyEffectResult, applyEffectResultWithAdapter, applyEffectResultWithSql, supersedeAndReplan, supersedeAndReplanWithAdapter, supersedeAndReplanWithSql, recoverExpiredLeases, recoverExpiredLeasesWithAdapter, recoverExpiredLeasesWithSql, releaseUnprocessedEffect, releaseUnprocessedEffectWithAdapter, releaseUnprocessedEffectWithSql, retryClaimedEffect, retryClaimedEffectWithAdapter, retryClaimedEffectWithSql, findPendingEffectsByTarget, findPendingEffectsByTargetWithAdapter, findPendingEffectsByTargetWithSql, listReadyEffects, listReadyEffectsWithAdapter, listReadyEffectsWithSql, hasPendingOrProcessingEffects, hasPendingOrProcessingEffectsWithAdapter, hasPendingOrProcessingEffectsWithSql, appendPendingEffects, appendPendingEffectsWithAdapter, appendPendingEffectsWithSql, } from "./sync/outbound/effectOutbox.js";
+export type { ClaimResult, ClaimEffectOptions, ApplyResultOptions, EffectProjectionConfirmation, NewEffect, PendingEffect, RetryClaimedEffectOptions, } from "./sync/outbound/effectOutbox.js";
+export { SYNC_EFFECT_RECOVERY_ERROR_CODES } from "./sync/outbound/effectOutbox.js";
+export { persistObservedRow, persistObservedRowWithAdapter, persistObservedRowWithSql, } from "./state/observation/observationWriter.js";
+export type { ObservationAttemptInput, EventIdentityInput, BusinessKeyChange, CanonicalRowMutation, PersistObservedRowInput, PersistObservedRowResult, } from "./state/observation/observationWriter.js";
+export { persistResolutionCommand, persistResolutionCommandWithAdapter, persistResolutionCommandWithSql, } from "./state/resolution/resolutionWriter.js";
+export type { PersistResolutionCommandInput, PersistResolutionCommandResult, } from "./state/resolution/resolutionWriter.js";
+export { registerSyncSheet, registerSyncSheetWithAdapter, registerSyncSheetWithSql, requireRegisteredSyncSheet, requireRegisteredSyncSheetWithAdapter, requireRegisteredSyncSheetWithSql, } from "./sync/shared/syncRegistry.js";
+export type { RegisteredProjection, RegisterSyncSheetInput, RegisteredSyncSheet, RegisterSyncSheetResult, } from "./sync/shared/syncRegistry.js";
+export { persistReadOnlySnapshotObservation, persistReadOnlySnapshotObservationWithAdapter, persistReadOnlySnapshotObservationWithSql, } from "./state/readonly/readOnlyObservation.js";
+export type { ReadOnlySnapshotObservationInput, ReadOnlySnapshotObservationResult, } from "./state/readonly/readOnlyObservation.js";
+export { inspectRestoredBackup, beginRestoreReconciliation, completeRestoreReconciliation, requireRestoreAllowsSheetWrites, } from "./recovery/restoreRecovery.js";
+export type { RestoreInspection, BeginRestoreReconciliationOptions, RestoreReconciliation, RestoreEffectDisposition, RestoreEffectReconciliation, CompleteRestoreReconciliationOptions, ReadyRestore, } from "./recovery/restoreRecovery.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/storage/index.d.ts.map

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

package/dist/infrastructure/storage/index.js

@@ -0,0 +1,13 @@
+export { CURRENT_SCHEMA_VERSION, migrateSchema, schemaDdl } from "./sqlite/schema.js";
+export { CANONICAL_COMMIT_RESULT_KINDS, CANONICAL_COMMIT_STALE_TARGETS, commitCanonicalChanges, commitCanonicalChangesWithAdapter, commitCanonicalChangesWithSql, } from "./state/canonical/canonicalCommit.js";
+export { openDatabase, openReadOnlyDatabase, getDatabaseSync, withImmediateTransaction, } from "./sqlite/sqliteBridge.js";
+export { claimWriterLease, claimWriterLeaseWithAdapter, claimWriterLeaseWithSql, readWriterLease, readWriterLeaseWithAdapter, readWriterLeaseWithSql, isFencingValid, isFencingValidWithAdapter, isFencingValidWithSql, } from "./sync/shared/writerLease.js";
+export { WRITER_LEASE_CLAIM_FAILURE_REASONS, WRITER_LEASE_CLAIM_RESULT_KINDS, } from "./sync/shared/writerLease.js";
+export { claimEffect, claimEffectWithAdapter, claimEffectWithSql, applyEffectResult, applyEffectResultWithAdapter, applyEffectResultWithSql, supersedeAndReplan, supersedeAndReplanWithAdapter, supersedeAndReplanWithSql, recoverExpiredLeases, recoverExpiredLeasesWithAdapter, recoverExpiredLeasesWithSql, releaseUnprocessedEffect, releaseUnprocessedEffectWithAdapter, releaseUnprocessedEffectWithSql, retryClaimedEffect, retryClaimedEffectWithAdapter, retryClaimedEffectWithSql, findPendingEffectsByTarget, findPendingEffectsByTargetWithAdapter, findPendingEffectsByTargetWithSql, listReadyEffects, listReadyEffectsWithAdapter, listReadyEffectsWithSql, hasPendingOrProcessingEffects, hasPendingOrProcessingEffectsWithAdapter, hasPendingOrProcessingEffectsWithSql, appendPendingEffects, appendPendingEffectsWithAdapter, appendPendingEffectsWithSql, } from "./sync/outbound/effectOutbox.js";
+export { SYNC_EFFECT_RECOVERY_ERROR_CODES } from "./sync/outbound/effectOutbox.js";
+export { persistObservedRow, persistObservedRowWithAdapter, persistObservedRowWithSql, } from "./state/observation/observationWriter.js";
+export { persistResolutionCommand, persistResolutionCommandWithAdapter, persistResolutionCommandWithSql, } from "./state/resolution/resolutionWriter.js";
+export { registerSyncSheet, registerSyncSheetWithAdapter, registerSyncSheetWithSql, requireRegisteredSyncSheet, requireRegisteredSyncSheetWithAdapter, requireRegisteredSyncSheetWithSql, } from "./sync/shared/syncRegistry.js";
+export { persistReadOnlySnapshotObservation, persistReadOnlySnapshotObservationWithAdapter, persistReadOnlySnapshotObservationWithSql, } from "./state/readonly/readOnlyObservation.js";
+export { inspectRestoredBackup, beginRestoreReconciliation, completeRestoreReconciliation, requireRestoreAllowsSheetWrites, } from "./recovery/restoreRecovery.js";
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infrastructure/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEtF,OAAO,EACL,6BAA6B,EAC7B,8BAA8B,EAC9B,sBAAsB,EACtB,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,sCAAsC,CAAC;AAU9C,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,uBAAuB,EACvB,eAAe,EACf,0BAA0B,EAC1B,sBAAsB,EACtB,cAAc,EACd,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,kCAAkC,EAClC,+BAA+B,GAChC,MAAM,8BAA8B,CAAC;AAStC,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,4BAA4B,EAC5B,wBAAwB,EACxB,kBAAkB,EAClB,6BAA6B,EAC7B,yBAAyB,EACzB,oBAAoB,EACpB,+BAA+B,EAC/B,2BAA2B,EAC3B,wBAAwB,EACxB,mCAAmC,EACnC,+BAA+B,EAC/B,kBAAkB,EAClB,6BAA6B,EAC7B,yBAAyB,EACzB,0BAA0B,EAC1B,qCAAqC,EACrC,iCAAiC,EACjC,gBAAgB,EAChB,2BAA2B,EAC3B,uBAAuB,EACvB,6BAA6B,EAC7B,wCAAwC,EACxC,oCAAoC,EACpC,oBAAoB,EACpB,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,iCAAiC,CAAC;AAUzC,OAAO,EAAE,gCAAgC,EAAE,MAAM,iCAAiC,CAAC;AACnF,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,yBAAyB,GAC1B,MAAM,0CAA0C,CAAC;AASlD,OAAO,EACL,wBAAwB,EACxB,mCAAmC,EACnC,+BAA+B,GAChC,MAAM,wCAAwC,CAAC;AAKhD,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,wBAAwB,EACxB,0BAA0B,EAC1B,qCAAqC,EACrC,iCAAiC,GAClC,MAAM,+BAA+B,CAAC;AAOvC,OAAO,EACL,kCAAkC,EAClC,6CAA6C,EAC7C,yCAAyC,GAC1C,MAAM,yCAAyC,CAAC;AAKjD,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,6BAA6B,EAC7B,+BAA+B,GAChC,MAAM,+BAA+B,CAAC"}

package/dist/infrastructure/storage/recovery/restoreRecovery.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Restore-reconciliation gate for a restored SQLite backup.
+ *
+ * A backup is inspected read-only first. The writable restored copy then
+ * invalidates every pre-restore writer fence and remains unable to authorize
+ * Sheet effects until the caller records completed reconciliation.
+ */
+import type { DatabaseSyncLike } from "../sqlite/sqliteBridge.js";
+/** Immutable facts verified from a read-only backup before restoration begins. */
+export interface RestoreInspection {
+    readonly sourceCutoverId: string;
+    readonly sourceSnapshotHash: string;
+    readonly marker: string;
+    readonly priorLeaseRoles: readonly string[];
+}
+/** Input used to begin the persisted restore reconciliation gate. */
+export interface BeginRestoreReconciliationOptions {
+    readonly restoreId: string;
+    readonly now: number;
+}
+/** A restore that has invalidated old fences but cannot yet write Sheets. */
+export interface RestoreReconciliation {
+    readonly restoreId: string;
+    readonly sourceCutoverId: string;
+    readonly sourceSnapshotHash: string;
+    readonly invalidatedLeaseCount: number;
+    readonly sheetWritesAllowed: false;
+}
+/** The only outcomes a caller may record after a remote effect postcondition read-back. */
+export type RestoreEffectDisposition = "applied" | "superseded" | "replan_required";
+/** One remote effect outcome used to close restore reconciliation. */
+export interface RestoreEffectReconciliation {
+    readonly effectId: string;
+    readonly disposition: RestoreEffectDisposition;
+}
+/** Input required to mark a restore reconciliation gate as ready. */
+export interface CompleteRestoreReconciliationOptions {
+    readonly effects: readonly RestoreEffectReconciliation[];
+}
+/** A restore whose caller has recorded reconciliation and may resume Sheet writes. */
+export interface ReadyRestore {
+    readonly restoreId: string;
+    readonly sheetWritesAllowed: true;
+}
+/**
+ * Verifies the essential schema and cutover marker through a read-only backup
+ * connection. It intentionally performs no replay or lease mutation.
+ */
+export declare function inspectRestoredBackup(readOnlyDb: DatabaseSyncLike, sourceCutoverId: string): RestoreInspection;
+/**
+ * Persists a reconciliation gate and invalidates every pre-restore lease.
+ *
+ * The caller must still read current Sheet postconditions. This function only
+ * prevents an old fence from being reused and keeps future Sheet writes gated.
+ */
+export declare function beginRestoreReconciliation(db: DatabaseSyncLike, inspection: RestoreInspection, options: BeginRestoreReconciliationOptions): RestoreReconciliation;
+/**
+ * Records that each relevant effect has been classified by a read-back caller.
+ * It does not replay events or turn expired processing effects back to pending.
+ */
+export declare function completeRestoreReconciliation(db: DatabaseSyncLike, restore: RestoreReconciliation, options: CompleteRestoreReconciliationOptions): ReadyRestore;
+/** Rejects a Sheet write until the persisted restore reconciliation status is complete. */
+export declare function requireRestoreAllowsSheetWrites(db: DatabaseSyncLike, restoreId: string): void;
+//# sourceMappingURL=restoreRecovery.d.ts.map

package/dist/infrastructure/storage/recovery/restoreRecovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoreRecovery.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/storage/recovery/restoreRecovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AA6ClE,kFAAkF;AAClF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED,qEAAqE;AACrE,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,6EAA6E;AAC7E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,kBAAkB,EAAE,KAAK,CAAC;CACpC;AAED,2FAA2F;AAC3F,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,YAAY,GAAG,iBAAiB,CAAC;AAEpF,sEAAsE;AACtE,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;CAChD;AAED,qEAAqE;AACrE,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,OAAO,EAAE,SAAS,2BAA2B,EAAE,CAAC;CAC1D;AAED,sFAAsF;AACtF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,IAAI,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,gBAAgB,EAC5B,eAAe,EAAE,MAAM,GACtB,iBAAiB,CAyCnB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,gBAAgB,EACpB,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE,iCAAiC,GACzC,qBAAqB,CA6CvB;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,EAAE,EAAE,gBAAgB,EACpB,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,oCAAoC,GAC5C,YAAY,CAcd;AAED,2FAA2F;AAC3F,wBAAgB,+BAA+B,CAAC,EAAE,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAU7F"}

package/dist/infrastructure/storage/recovery/restoreRecovery.js

@@ -0,0 +1,148 @@
+/**
+ * Restore-reconciliation gate for a restored SQLite backup.
+ *
+ * A backup is inspected read-only first. The writable restored copy then
+ * invalidates every pre-restore writer fence and remains unable to authorize
+ * Sheet effects until the caller records completed reconciliation.
+ */
+import { STORAGE_ERROR_CODES, StorageError } from "../errors.js";
+import { withImmediateTransaction } from "../sqlite/sqliteBridge.js";
+const CHECK_REQUIRED_TABLE_SQL = "SELECT name FROM sqlite_master WHERE type = 'table' AND name = ?";
+const READ_CUTOVER_MARKER_SQL = `
+  SELECT cutover_id, source_snapshot_hash, marker
+  FROM cutover_state
+  WHERE cutover_id = ?
+`;
+const READ_WRITER_LEASE_ROLES_SQL = "SELECT role FROM writer_lease ORDER BY role";
+const READ_RESTORE_SOURCE_MARKER_SQL = `
+  SELECT source_snapshot_hash, marker
+  FROM cutover_state
+  WHERE cutover_id = ?
+`;
+const CHECK_RESTORE_ID_SQL = "SELECT cutover_id FROM cutover_state WHERE cutover_id = ?";
+const INVALIDATE_WRITER_LEASES_SQL = "UPDATE writer_lease SET lease_until = ?";
+const INSERT_RESTORE_CUTOVER_SQL = `
+  INSERT INTO cutover_state (
+    cutover_id, phase, source_snapshot_hash, marker, status, created_at
+  ) VALUES (?, 'restore_reconciliation', ?, ?, 'reconciling', ?)
+`;
+const COMPLETE_RESTORE_RECONCILIATION_SQL = `
+  UPDATE cutover_state
+  SET status = 'reconciled'
+  WHERE cutover_id = ? AND phase = 'restore_reconciliation' AND status = 'reconciling'
+`;
+const READ_RESTORE_RECONCILIATION_STATUS_SQL = `
+  SELECT status
+  FROM cutover_state
+  WHERE cutover_id = ? AND phase = 'restore_reconciliation'
+`;
+/**
+ * Verifies the essential schema and cutover marker through a read-only backup
+ * connection. It intentionally performs no replay or lease mutation.
+ */
+export function inspectRestoredBackup(readOnlyDb, sourceCutoverId) {
+    requireNonEmptyText(sourceCutoverId, "source cutover ID");
+    for (const tableName of [
+        "entity_state",
+        "sheet_effect_outbox",
+        "writer_lease",
+        "cutover_state",
+    ]) {
+        const table = readOnlyDb.prepare(CHECK_REQUIRED_TABLE_SQL)
+            .get(tableName);
+        if (table === undefined) {
+            throw new StorageError(STORAGE_ERROR_CODES.INVALID_RESTORE_BACKUP, "restored backup is missing required table: " + tableName);
+        }
+    }
+    const marker = readOnlyDb.prepare(READ_CUTOVER_MARKER_SQL).get(sourceCutoverId);
+    if (marker === undefined ||
+        marker.source_snapshot_hash === null ||
+        marker.marker === null) {
+        throw new StorageError(STORAGE_ERROR_CODES.INVALID_RESTORE_BACKUP, "restored backup is missing the required cutover marker and source snapshot hash");
+    }
+    const leaseRows = readOnlyDb.prepare(READ_WRITER_LEASE_ROLES_SQL)
+        .all();
+    return {
+        sourceCutoverId: marker.cutover_id,
+        sourceSnapshotHash: marker.source_snapshot_hash,
+        marker: marker.marker,
+        priorLeaseRoles: leaseRows.map((lease) => lease.role),
+    };
+}
+/**
+ * Persists a reconciliation gate and invalidates every pre-restore lease.
+ *
+ * The caller must still read current Sheet postconditions. This function only
+ * prevents an old fence from being reused and keeps future Sheet writes gated.
+ */
+export function beginRestoreReconciliation(db, inspection, options) {
+    requireNonEmptyText(options.restoreId, "restore ID");
+    requireNonNegativeSafeInteger(options.now, "restore time");
+    const result = withImmediateTransaction(db, () => {
+        const sourceMarker = db.prepare(READ_RESTORE_SOURCE_MARKER_SQL)
+            .get(inspection.sourceCutoverId);
+        if (sourceMarker === undefined ||
+            sourceMarker.source_snapshot_hash !== inspection.sourceSnapshotHash ||
+            sourceMarker.marker !== inspection.marker) {
+            throw new StorageError(STORAGE_ERROR_CODES.RESTORE_INSPECTION_MISMATCH, "restore inspection does not match the restored cutover marker");
+        }
+        const existing = db.prepare(CHECK_RESTORE_ID_SQL).get(options.restoreId);
+        if (existing !== undefined) {
+            throw new StorageError(STORAGE_ERROR_CODES.RESTORE_ID_CONFLICT, "restore ID already exists: " + options.restoreId);
+        }
+        const invalidated = db.prepare(INVALIDATE_WRITER_LEASES_SQL).run(options.now);
+        db.prepare(INSERT_RESTORE_CUTOVER_SQL).run(options.restoreId, inspection.sourceSnapshotHash, inspection.marker, options.now);
+        return invalidated.changes;
+    });
+    return {
+        restoreId: options.restoreId,
+        sourceCutoverId: inspection.sourceCutoverId,
+        sourceSnapshotHash: inspection.sourceSnapshotHash,
+        invalidatedLeaseCount: result,
+        sheetWritesAllowed: false,
+    };
+}
+/**
+ * Records that each relevant effect has been classified by a read-back caller.
+ * It does not replay events or turn expired processing effects back to pending.
+ */
+export function completeRestoreReconciliation(db, restore, options) {
+    validateEffectReconciliation(options.effects);
+    withImmediateTransaction(db, () => {
+        const result = db.prepare(COMPLETE_RESTORE_RECONCILIATION_SQL).run(restore.restoreId);
+        if (result.changes !== 1) {
+            throw new StorageError(STORAGE_ERROR_CODES.RESTORE_RECONCILIATION_STATE_INVALID, "restore reconciliation is not pending: " + restore.restoreId);
+        }
+    });
+    return { restoreId: restore.restoreId, sheetWritesAllowed: true };
+}
+/** Rejects a Sheet write until the persisted restore reconciliation status is complete. */
+export function requireRestoreAllowsSheetWrites(db, restoreId) {
+    requireNonEmptyText(restoreId, "restore ID");
+    const row = db.prepare(READ_RESTORE_RECONCILIATION_STATUS_SQL)
+        .get(restoreId);
+    if (row === undefined || row.status !== "reconciled") {
+        throw new StorageError(STORAGE_ERROR_CODES.RESTORE_RECONCILIATION_STATE_INVALID, "restore reconciliation has not completed: " + restoreId);
+    }
+}
+function validateEffectReconciliation(effects) {
+    const effectIds = new Set();
+    for (const effect of effects) {
+        requireNonEmptyText(effect.effectId, "reconciled effect ID");
+        if (effectIds.has(effect.effectId)) {
+            throw new StorageError(STORAGE_ERROR_CODES.INVALID_RESTORE_RECONCILIATION, "duplicate reconciled effect ID: " + effect.effectId);
+        }
+        effectIds.add(effect.effectId);
+    }
+}
+function requireNonEmptyText(value, label) {
+    if (value.length === 0) {
+        throw new StorageError(STORAGE_ERROR_CODES.INVALID_RESTORE_OPTIONS, label + " is required");
+    }
+}
+function requireNonNegativeSafeInteger(value, label) {
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw new StorageError(STORAGE_ERROR_CODES.INVALID_RESTORE_OPTIONS, label + " must be a non-negative safe integer");
+    }
+}
+//# sourceMappingURL=restoreRecovery.js.map

package/dist/infrastructure/storage/recovery/restoreRecovery.js.map

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

package/dist/infrastructure/storage/sqlite/schema.d.ts

@@ -0,0 +1,49 @@
+import { type DatabaseSyncLike } from "./sqliteBridge.js";
+/**
+ * SQLite schema and migration DDL for the SQLite-authoritative sync storage layer.
+ *
+ * Implements the logical schema from design/packages/core/contracts/storage-schema.md.
+ * All identity constraints, unique indexes, and foreign keys are fixed here.
+ *
+ * Table creation order is parent-first. Deletion order is child-first.
+ */
+/** Current durable schema version managed by migrateSchema(). */
+export declare const CURRENT_SCHEMA_VERSION = 3;
+/** Observable result of bringing one SQLite database to the current schema. */
+export interface SchemaMigrationResult {
+    readonly fromVersion: number;
+    readonly toVersion: number;
+    /** Versions newly applied during this call; empty means already current. */
+    readonly appliedVersions: readonly number[];
+}
+/** Connection settings required by every typed-sheets SQLite store. */
+export declare const SQLITE_CONNECTION_PRAGMAS = "\n  PRAGMA foreign_keys = ON;\n  PRAGMA journal_mode = WAL;\n  PRAGMA busy_timeout = 5000;\n";
+/** Columns that must exist before a version-two-or-later marker is trusted. */
+export declare const REQUIRED_V2_COLUMNS: Readonly<Record<"sync_conflict" | "resolution_command", readonly string[]>>;
+/** Columns that must exist before a version-three marker is trusted. */
+export declare const REQUIRED_V3_COLUMNS: Readonly<Record<"sheet_effect_outbox", readonly string[]>>;
+/**
+ * Returns full DDL for an empty database or isolated test fixture.
+ *
+ * Durable runtime startup must call migrateSchema() instead: executing this
+ * directly cannot safely evolve an already-populated database.
+ */
+export declare function schemaDdl(): string;
+/**
+ * Upgrades a durable database under an immediate writer transaction.
+ *
+ * Version 1 represents the original one-shot schema. Version 2 persists the
+ * candidate epoch needed to prevent a stale resolution request from resolving
+ * an ABA candidate retry. Version 3 adds durable effect creation time so
+ * operations can measure pending-age backpressure. Unversioned legacy
+ * databases created by schemaDdl() are adopted only after verification.
+ */
+export declare function migrateSchema(db: DatabaseSyncLike): SchemaMigrationResult;
+/** Returns table DDL only, so migration transactions never change connection pragmas. */
+export declare function syncSchemaTablesDdl(): string;
+/**
+ * Creates indexes that depend on additive migration columns only after those
+ * columns have been confirmed. This keeps a version-one upgrade ordered.
+ */
+export declare function syncSchemaIndexesDdl(): string;
+//# sourceMappingURL=schema.d.ts.map

package/dist/infrastructure/storage/sqlite/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/storage/sqlite/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAOpF;;;;;;;GAOG;AAEH,iEAAiE;AACjE,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED,uEAAuE;AACvE,eAAO,MAAM,yBAAyB,iGAIrC,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CACxC,MAAM,CAAC,eAAe,GAAG,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC,CAsClE,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC,CAE1F,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,gBAAgB,GAAG,qBAAqB,CAwDzE;AAED,yFAAyF;AACzF,wBAAgB,mBAAmB,IAAI,MAAM,CAa5C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAK7C"}