hikoutei 0.2.0

package/dist/domain/model/constants.d.ts

@@ -0,0 +1,73 @@
+/** Runtime values for operations observed on a Sheet row. */
+export declare const ROW_OPERATIONS: {
+    readonly INSERT: "insert";
+    readonly UPDATE: "update";
+    readonly DELETE: "delete";
+    readonly RENAME: "rename";
+};
+/** Closed set of row operations accepted by the evaluator. */
+export type RowOperation = (typeof ROW_OPERATIONS)[keyof typeof ROW_OPERATIONS];
+/** Runtime values for field ownership in canonical and manifest state. */
+export declare const FIELD_OWNERSHIPS: {
+    readonly USER: "user";
+    readonly SYSTEM: "system";
+};
+/** Closed set of field ownership values. */
+export type FieldOwnership = (typeof FIELD_OWNERSHIPS)[keyof typeof FIELD_OWNERSHIPS];
+/** Runtime values for the lifecycle state of a row-to-entity binding. */
+export declare const ROW_BINDING_STATES: {
+    readonly CANDIDATE: "candidate";
+    readonly ACTIVE: "active";
+    readonly TOMBSTONED: "tombstoned";
+    readonly AMBIGUOUS: "ambiguous";
+};
+/** Closed set of row-binding lifecycle states. */
+export type RowBindingState = (typeof ROW_BINDING_STATES)[keyof typeof ROW_BINDING_STATES];
+/** Runtime values describing evidence for an observed row deletion. */
+export declare const DELETE_EVIDENCE: {
+    readonly DELETED_CONFIRMED: "deleted_confirmed";
+    readonly ANCHOR_LOST: "anchor_lost";
+    readonly UNAVAILABLE: "unavailable";
+};
+/** Closed set of deletion evidence values. */
+export type DeleteEvidence = (typeof DELETE_EVIDENCE)[keyof typeof DELETE_EVIDENCE];
+/** Runtime values returned when a precondition validator succeeds. */
+export declare const PRECONDITION_RESULTS: {
+    readonly VALID: "valid";
+    readonly INVALID: "invalid";
+};
+/** Runtime values describing whether canonical state is available. */
+export declare const CANONICAL_RESOLUTION_STATUSES: {
+    readonly AVAILABLE: "available";
+    readonly MISSING: "missing";
+};
+/** Closed set of canonical-state resolution statuses. */
+export type CanonicalResolutionStatus = (typeof CANONICAL_RESOLUTION_STATUSES)[keyof typeof CANONICAL_RESOLUTION_STATUSES];
+/** Runtime values for reasons that quarantine an observed row. */
+export declare const QUARANTINE_REASONS: {
+    readonly UNKNOWN_FIELD: "unknown_field";
+    readonly UNKNOWN_BASE_REVISION: "unknown_base_revision";
+    readonly AMBIGUOUS_IDENTITY: "ambiguous_identity";
+    readonly IDENTITY_TAMPERING: "identity_tampering";
+    readonly SCHEMA_DRIFT: "schema_drift";
+    readonly SYSTEM_FIELD_EDIT: "system_field_edit";
+    readonly MIXED_OWNERSHIP_EDIT: "mixed_ownership_edit";
+    readonly INVALID_CELL: "invalid_cell";
+    readonly FORMULA_UNSUPPORTED: "formula_unsupported";
+    readonly MERGED_CELL_UNSUPPORTED: "merged_cell_unsupported";
+    readonly CELL_ERROR: "cell_error";
+    readonly ANCHOR_LOST: "anchor_lost";
+    readonly INVALID_SNAPSHOT_METADATA: "invalid_snapshot_metadata";
+    readonly INVALID_EVENT: "invalid_event";
+};
+/** Closed set of reasons that quarantine an observed row. */
+export type QuarantineReason = (typeof QUARANTINE_REASONS)[keyof typeof QUARANTINE_REASONS];
+/** Runtime values for canonical conflict lifecycle states. */
+export declare const CONFLICT_STATUSES: {
+    readonly OPEN: "OPEN";
+    readonly NEEDS_REBASE: "NEEDS_REBASE";
+    readonly RESOLVED: "RESOLVED";
+};
+/** Closed set of canonical conflict lifecycle states. */
+export type ConflictStatus = (typeof CONFLICT_STATUSES)[keyof typeof CONFLICT_STATUSES];
+//# sourceMappingURL=constants.d.ts.map

package/dist/domain/model/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/domain/model/constants.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX,8DAA8D;AAC9D,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAEhF,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB;;;CAGnB,CAAC;AAEX,4CAA4C;AAC5C,MAAM,MAAM,cAAc,GACxB,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE3D,yEAAyE;AACzE,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AAEX,kDAAkD;AAClD,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE/D,uEAAuE;AACvE,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAEX,8CAA8C;AAC9C,MAAM,MAAM,cAAc,GACxB,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAEzD,sEAAsE;AACtE,eAAO,MAAM,oBAAoB;;;CAGvB,CAAC;AAEX,sEAAsE;AACtE,eAAO,MAAM,6BAA6B;;;CAGhC,CAAC;AAEX,yDAAyD;AACzD,MAAM,MAAM,yBAAyB,GACnC,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,OAAO,6BAA6B,CAAC,CAAC;AAErF,kEAAkE;AAClE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;CAerB,CAAC;AAEX,6DAA6D;AAC7D,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE/D,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AAEX,yDAAyD;AACzD,MAAM,MAAM,cAAc,GACxB,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/domain/model/constants.js

@@ -0,0 +1,59 @@
+/** Runtime values for operations observed on a Sheet row. */
+export const ROW_OPERATIONS = {
+    INSERT: "insert",
+    UPDATE: "update",
+    DELETE: "delete",
+    RENAME: "rename",
+};
+/** Runtime values for field ownership in canonical and manifest state. */
+export const FIELD_OWNERSHIPS = {
+    USER: "user",
+    SYSTEM: "system",
+};
+/** Runtime values for the lifecycle state of a row-to-entity binding. */
+export const ROW_BINDING_STATES = {
+    CANDIDATE: "candidate",
+    ACTIVE: "active",
+    TOMBSTONED: "tombstoned",
+    AMBIGUOUS: "ambiguous",
+};
+/** Runtime values describing evidence for an observed row deletion. */
+export const DELETE_EVIDENCE = {
+    DELETED_CONFIRMED: "deleted_confirmed",
+    ANCHOR_LOST: "anchor_lost",
+    UNAVAILABLE: "unavailable",
+};
+/** Runtime values returned when a precondition validator succeeds. */
+export const PRECONDITION_RESULTS = {
+    VALID: "valid",
+    INVALID: "invalid",
+};
+/** Runtime values describing whether canonical state is available. */
+export const CANONICAL_RESOLUTION_STATUSES = {
+    AVAILABLE: "available",
+    MISSING: "missing",
+};
+/** Runtime values for reasons that quarantine an observed row. */
+export const QUARANTINE_REASONS = {
+    UNKNOWN_FIELD: "unknown_field",
+    UNKNOWN_BASE_REVISION: "unknown_base_revision",
+    AMBIGUOUS_IDENTITY: "ambiguous_identity",
+    IDENTITY_TAMPERING: "identity_tampering",
+    SCHEMA_DRIFT: "schema_drift",
+    SYSTEM_FIELD_EDIT: "system_field_edit",
+    MIXED_OWNERSHIP_EDIT: "mixed_ownership_edit",
+    INVALID_CELL: "invalid_cell",
+    FORMULA_UNSUPPORTED: "formula_unsupported",
+    MERGED_CELL_UNSUPPORTED: "merged_cell_unsupported",
+    CELL_ERROR: "cell_error",
+    ANCHOR_LOST: "anchor_lost",
+    INVALID_SNAPSHOT_METADATA: "invalid_snapshot_metadata",
+    INVALID_EVENT: "invalid_event",
+};
+/** Runtime values for canonical conflict lifecycle states. */
+export const CONFLICT_STATUSES = {
+    OPEN: "OPEN",
+    NEEDS_REBASE: "NEEDS_REBASE",
+    RESOLVED: "RESOLVED",
+};
+//# sourceMappingURL=constants.js.map

package/dist/domain/model/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/domain/model/constants.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACR,CAAC;AAKX,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;CACR,CAAC;AAMX,yEAAyE;AACzE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;CACd,CAAC;AAMX,uEAAuE;AACvE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,iBAAiB,EAAE,mBAAmB;IACtC,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;CAClB,CAAC;AAMX,sEAAsE;AACtE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;CACV,CAAC;AAEX,sEAAsE;AACtE,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;CACV,CAAC;AAMX,kEAAkE;AAClE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,aAAa,EAAE,eAAe;IAC9B,qBAAqB,EAAE,uBAAuB;IAC9C,kBAAkB,EAAE,oBAAoB;IACxC,kBAAkB,EAAE,oBAAoB;IACxC,YAAY,EAAE,cAAc;IAC5B,iBAAiB,EAAE,mBAAmB;IACtC,oBAAoB,EAAE,sBAAsB;IAC5C,YAAY,EAAE,cAAc;IAC5B,mBAAmB,EAAE,qBAAqB;IAC1C,uBAAuB,EAAE,yBAAyB;IAClD,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,yBAAyB,EAAE,2BAA2B;IACtD,aAAa,EAAE,eAAe;CACtB,CAAC;AAMX,8DAA8D;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,MAAM;IACZ,YAAY,EAAE,cAAc;IAC5B,QAAQ,EAAE,UAAU;CACZ,CAAC"}

package/dist/domain/model/index.d.ts

@@ -0,0 +1,3 @@
+export type { CanonicalFieldState, CanonicalEntityState, CanonicalResolution, CanonicalResolutionStatus, FieldOwnership, Projection, RowBindingState, NormalizedRow, NormalizedRowField, ObservationSource, RowOperation, DeleteEvidence, EditorActorSource, ObservedFieldChange, ObservedInsertFieldChange, ObservedVersionedFieldChange, RawObservedFieldChange, RawObservedInsertFieldChange, RawObservedVersionedFieldChange, ObservedRowChange, ObservedInsertRowChange, ObservedExistingRowChange, ObservedDeleteRowChange, RawObservedRowChange, RawObservedInsertRowChange, RawObservedExistingRowChange, RawObservedDeleteRowChange, ObservedEditBatch, SheetChangeEvent, InsertSheetChangeEvent, ExistingSheetChangeEvent, DeleteSheetChangeEvent, ConflictStatus, SyncConflict, QuarantineReason, QuarantinePlan, InsertQuarantinePlan, ExistingQuarantinePlan, DeleteQuarantinePlan, TypedQuarantinePlan, RepairPlan, FieldManifestEntry, OwnershipManifest, RowBindingContext, CandidateRowBindingContext, ActiveRowBindingContext, TombstonedRowBindingContext, AmbiguousRowBindingContext, ResolutionAction, ActorRole, ResolutionCommand, EffectKind, EffectTargetKind, EffectStatus, SheetEffect, } from "./types.js";
+export { CANONICAL_RESOLUTION_STATUSES, CONFLICT_STATUSES, DELETE_EVIDENCE, FIELD_OWNERSHIPS, PRECONDITION_RESULTS, QUARANTINE_REASONS, ROW_BINDING_STATES, ROW_OPERATIONS, } from "./constants.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/model/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/model/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,cAAc,EACd,UAAU,EACV,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,4BAA4B,EAC5B,sBAAsB,EACtB,4BAA4B,EAC5B,+BAA+B,EAC/B,iBAAiB,EACjB,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,EACpB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,uBAAuB,EACvB,2BAA2B,EAC3B,0BAA0B,EAC1B,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,6BAA6B,EAC7B,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,GACf,MAAM,gBAAgB,CAAC"}

package/dist/domain/model/index.js

@@ -0,0 +1,2 @@
+export { CANONICAL_RESOLUTION_STATUSES, CONFLICT_STATUSES, DELETE_EVIDENCE, FIELD_OWNERSHIPS, PRECONDITION_RESULTS, QUARANTINE_REASONS, ROW_BINDING_STATES, ROW_OPERATIONS, } from "./constants.js";
+//# sourceMappingURL=index.js.map

package/dist/domain/model/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/model/index.ts"],"names":[],"mappings":"AAyDA,OAAO,EACL,6BAA6B,EAC7B,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,GACf,MAAM,gBAAgB,CAAC"}

package/dist/domain/model/types.d.ts

@@ -0,0 +1,330 @@
+/**
+ * Pure domain model types shared across the core evaluator.
+ *
+ * These types contain no Google SDK, SQLite, or platform-specific values.
+ * All cell values are NormalizedCell, all timestamps are audit-only ISO strings.
+ */
+import type { NormalizedCell } from "../../shared/encoding/types.js";
+import type { ConflictStatus } from "./constants.js";
+import type { NormalizedCellKind } from "../../shared/encoding/types.js";
+import type { Applicability, Presence } from "../../shared/state/types.js";
+import type { CANONICAL_RESOLUTION_STATUSES, DeleteEvidence, FieldOwnership, QuarantineReason, RowOperation, ROW_BINDING_STATES, ROW_OPERATIONS } from "./constants.js";
+export type { CanonicalResolutionStatus, ConflictStatus, DeleteEvidence, FieldOwnership, QuarantineReason, RowBindingState, RowOperation, } from "./constants.js";
+/** A single field within a canonical entity. */
+export interface CanonicalFieldState {
+    readonly fieldName: string;
+    readonly value: NormalizedCell;
+    readonly fieldRevision: number;
+    readonly ownership: FieldOwnership;
+}
+/** The canonical accepted state of an entity as seen by the evaluator. */
+export interface CanonicalEntityState {
+    readonly entityId: string;
+    readonly entityRevision: number;
+    readonly businessKey: string;
+    readonly fields: ReadonlyMap<string, CanonicalFieldState>;
+}
+/** Explicitly represents whether canonical state is available to evaluation. */
+export type CanonicalResolution = {
+    readonly status: typeof CANONICAL_RESOLUTION_STATUSES.AVAILABLE;
+    readonly entity: CanonicalEntityState;
+} | {
+    readonly status: typeof CANONICAL_RESOLUTION_STATUSES.MISSING;
+};
+export type Projection = "user_input" | "system_state" | "legacy_combined";
+/** A single field in an observed row change. */
+export interface NormalizedRowField {
+    readonly fieldName: string;
+    readonly cell: NormalizedCell;
+    readonly baseFieldRevision: Applicability<number>;
+}
+/** A row read from a Sheet snapshot, identified by row binding. */
+export interface NormalizedRow {
+    readonly rowBindingId: string;
+    readonly fields: ReadonlyMap<string, NormalizedRowField>;
+}
+export type ObservationSource = "onEdit" | "polling" | "resolution" | "repair";
+/** Provenance of an optional editor identity retained for audit only. */
+export type EditorActorSource = "google_active_user" | "unavailable";
+/** A single normalized field change without operation-specific revision state. */
+interface ObservedFieldChangeBase {
+    readonly fieldName: string;
+    readonly previousValue: NormalizedCell;
+    readonly nextValue: NormalizedCell;
+}
+/** A field change for an inserted row, which has no prior field revision. */
+export interface ObservedInsertFieldChange extends ObservedFieldChangeBase {
+    readonly baseFieldRevision?: never;
+}
+/** A field change for an existing row with a required prior field revision. */
+export interface ObservedVersionedFieldChange extends ObservedFieldChangeBase {
+    readonly baseFieldRevision: number;
+}
+/** A validated field change accepted by the evaluator. */
+export type ObservedFieldChange = ObservedInsertFieldChange | ObservedVersionedFieldChange;
+/** Common untrusted field data before cell normalization. */
+interface RawObservedFieldChangeBase {
+    readonly fieldName: string;
+    readonly previousValue: unknown;
+    readonly nextValue: unknown;
+}
+/** Raw field data for an insertion, which has no prior field revision. */
+export interface RawObservedInsertFieldChange extends RawObservedFieldChangeBase {
+    readonly baseFieldRevision?: never;
+}
+/** Raw field data for an existing row with a prior field revision. */
+export interface RawObservedVersionedFieldChange extends RawObservedFieldChangeBase {
+    readonly baseFieldRevision: number;
+}
+/** Raw field data whose revision shape is determined by row state. */
+export type RawObservedFieldChange = RawObservedInsertFieldChange | RawObservedVersionedFieldChange;
+/** Common identity and visibility data for a validated row change. */
+interface ObservedRowChangeBase {
+    readonly rowBindingId: string;
+    readonly baseVisibleRevision: number;
+}
+/** A validated insertion with only the state an insertion can carry. */
+export interface ObservedInsertRowChange extends ObservedRowChangeBase {
+    readonly operation: typeof ROW_OPERATIONS.INSERT;
+    readonly afterRow: NormalizedRow;
+    readonly fields: readonly ObservedInsertFieldChange[];
+}
+/** A validated update or rename with both visible row snapshots. */
+export interface ObservedExistingRowChange extends ObservedRowChangeBase {
+    readonly operation: typeof ROW_OPERATIONS.UPDATE | typeof ROW_OPERATIONS.RENAME;
+    readonly beforeRow: NormalizedRow;
+    readonly afterRow: NormalizedRow;
+    readonly baseEntityRevision: number;
+    readonly fields: readonly ObservedVersionedFieldChange[];
+}
+/** A validated deletion with required evidence that may later be rejected. */
+export interface ObservedDeleteRowChange extends ObservedRowChangeBase {
+    readonly operation: typeof ROW_OPERATIONS.DELETE;
+    readonly beforeRow: NormalizedRow;
+    readonly baseEntityRevision: number;
+    /** Anchor evidence is checked by operation preconditions after normalization. */
+    readonly deleteEvidence: DeleteEvidence;
+    readonly fields: readonly ObservedVersionedFieldChange[];
+}
+/** A validated row change whose shape is determined by its operation. */
+export type ObservedRowChange = ObservedInsertRowChange | ObservedExistingRowChange | ObservedDeleteRowChange;
+/** Common raw row data shared by operation-specific input variants. */
+interface RawObservedRowChangeBase {
+    readonly rowBindingId: string;
+    readonly baseVisibleRevision: number;
+}
+/** Raw insertion input with no existing-row state fields. */
+export interface RawObservedInsertRowChange extends RawObservedRowChangeBase {
+    readonly operation: typeof ROW_OPERATIONS.INSERT;
+    readonly afterRow: NormalizedRow;
+    readonly fields: readonly RawObservedInsertFieldChange[];
+}
+/** Raw update or rename input with required existing-row state. */
+export interface RawObservedExistingRowChange extends RawObservedRowChangeBase {
+    readonly operation: typeof ROW_OPERATIONS.UPDATE | typeof ROW_OPERATIONS.RENAME;
+    readonly beforeRow: NormalizedRow;
+    readonly afterRow: NormalizedRow;
+    readonly baseEntityRevision: number;
+    readonly fields: readonly RawObservedVersionedFieldChange[];
+}
+/** Raw delete input with required deletion evidence and entity revision. */
+export interface RawObservedDeleteRowChange extends RawObservedRowChangeBase {
+    readonly operation: typeof ROW_OPERATIONS.DELETE;
+    readonly beforeRow: NormalizedRow;
+    readonly baseEntityRevision: number;
+    readonly deleteEvidence: DeleteEvidence;
+    readonly fields: readonly RawObservedVersionedFieldChange[];
+}
+/** Raw row input whose shape is determined by its operation. */
+export type RawObservedRowChange = RawObservedInsertRowChange | RawObservedExistingRowChange | RawObservedDeleteRowChange;
+/** A batch of row changes observed from one paste/drag-fill/poll cycle. */
+export interface ObservedEditBatch {
+    readonly batchId: string;
+    readonly source: ObservationSource;
+    readonly sheetId: string;
+    readonly projection: Projection;
+    /** Schema version reported by the normalized snapshot. */
+    readonly schemaVersion: number;
+    readonly atomicity: "row_independent";
+    readonly baseSnapshotHash: string;
+    /** Authenticated service principal; audit metadata, never a merge input. */
+    readonly ingressActorId: string;
+    /** Verified editor identity when the gateway can provide one. */
+    readonly editorActorId: Presence<string>;
+    readonly editorActorSource: EditorActorSource;
+    readonly rows: readonly ObservedRowChange[];
+}
+/** Common metadata for a normalized Sheet change event. */
+interface SheetChangeEventBase {
+    readonly eventId: string;
+    readonly eventKey: string;
+    readonly payloadHash: string;
+    readonly batchId: string;
+    readonly source: ObservationSource;
+    readonly sheetId: string;
+    readonly projection: Projection;
+    readonly rowBindingId: string;
+    readonly baseVisibleRevision: number;
+    readonly baseSnapshotHash: string;
+    readonly beforeRowHash: string;
+    readonly afterRowHash: string;
+}
+/** An event for a newly observed row with no prior entity revision. */
+export interface InsertSheetChangeEvent extends SheetChangeEventBase {
+    readonly operation: typeof ROW_OPERATIONS.INSERT;
+    readonly fields: readonly ObservedInsertFieldChange[];
+}
+/** An event for an existing row with a required entity revision. */
+export interface ExistingSheetChangeEvent extends SheetChangeEventBase {
+    readonly operation: typeof ROW_OPERATIONS.UPDATE | typeof ROW_OPERATIONS.RENAME;
+    readonly baseEntityRevision: number;
+    readonly fields: readonly ObservedVersionedFieldChange[];
+}
+/** A delete event with a required entity revision and deletion evidence. */
+export interface DeleteSheetChangeEvent extends SheetChangeEventBase {
+    readonly operation: typeof ROW_OPERATIONS.DELETE;
+    readonly baseEntityRevision: number;
+    readonly fields: readonly ObservedVersionedFieldChange[];
+}
+/** A normalized event whose shape is determined by its operation. */
+export type SheetChangeEvent = InsertSheetChangeEvent | ExistingSheetChangeEvent | DeleteSheetChangeEvent;
+/** Field-level conflict record preserving both candidate and canonical state. */
+export interface SyncConflict {
+    readonly conflictId: string;
+    readonly conflictGroupId: Presence<string>;
+    readonly eventId: string;
+    readonly rowBindingId: string;
+    readonly entityId: string;
+    readonly fieldName: string;
+    readonly userValue: NormalizedCell;
+    readonly userBaseRevision: number;
+    readonly canonicalValueAtDetection: NormalizedCell;
+    readonly canonicalRevisionAtDetection: number;
+    readonly currentCanonicalValue: NormalizedCell;
+    readonly currentCanonicalRevision: number;
+    /** Monotonic attempt generation for this field's active candidate. */
+    readonly candidateEpoch: number;
+    readonly status: ConflictStatus;
+    readonly resolutionCommandId: Presence<string>;
+}
+/** A plan to quarantine a row with preserved evidence. */
+interface QuarantinePlanBase {
+    readonly quarantineId: string;
+    readonly reason: QuarantineReason;
+    readonly rowBindingId: string;
+    readonly operation: RowOperation;
+    readonly fields: readonly ObservedFieldChange[];
+    readonly repairFields: readonly string[];
+}
+/** Quarantine evidence for an inserted row. */
+export interface InsertQuarantinePlan extends QuarantinePlanBase {
+    readonly operation: typeof ROW_OPERATIONS.INSERT;
+    readonly afterRow: NormalizedRow;
+}
+/** Quarantine evidence for an existing row edit. */
+export interface ExistingQuarantinePlan extends QuarantinePlanBase {
+    readonly operation: typeof ROW_OPERATIONS.UPDATE | typeof ROW_OPERATIONS.RENAME;
+    readonly beforeRow: NormalizedRow;
+    readonly afterRow: NormalizedRow;
+}
+/** Quarantine evidence for a deleted row. */
+export interface DeleteQuarantinePlan extends QuarantinePlanBase {
+    readonly operation: typeof ROW_OPERATIONS.DELETE;
+    readonly beforeRow: NormalizedRow;
+}
+export type QuarantinePlan = InsertQuarantinePlan | ExistingQuarantinePlan | DeleteQuarantinePlan;
+/** Alias kept for internal code that needs to emphasize the typed shape. */
+export type TypedQuarantinePlan = QuarantinePlan;
+/** A plan to repair system-owned fields to canonical values. */
+export interface RepairPlan {
+    readonly quarantineId: string;
+    readonly rowBindingId: string;
+    readonly affectedSystemFields: readonly string[];
+    readonly canonicalTargetValues: ReadonlyMap<string, NormalizedCell>;
+    readonly repairGuardHash: string;
+    readonly reason: string;
+}
+/** Ownership metadata for a single field. */
+export interface FieldManifestEntry {
+    readonly fieldName: string;
+    readonly ownership: FieldOwnership;
+    readonly projection: Projection;
+    readonly type: NormalizedCellKind;
+    readonly required: boolean;
+    readonly unique: boolean;
+}
+/** Maps field names to ownership metadata. */
+export type OwnershipManifest = ReadonlyMap<string, FieldManifestEntry>;
+/** Common identity context shared by operation-state-specific bindings. */
+interface RowBindingContextBase {
+    readonly rowBindingId: string;
+    readonly candidateEpoch: number;
+}
+/** A candidate binding that has not been attached to a canonical entity. */
+export interface CandidateRowBindingContext extends RowBindingContextBase {
+    readonly bindingState: typeof ROW_BINDING_STATES.CANDIDATE;
+    readonly businessKey?: string;
+}
+/** An active binding with an entity and business key. */
+export interface ActiveRowBindingContext extends RowBindingContextBase {
+    readonly bindingState: typeof ROW_BINDING_STATES.ACTIVE;
+    readonly entityId: string;
+    readonly businessKey: string;
+}
+/** A tombstoned binding that still points to its former entity. */
+export interface TombstonedRowBindingContext extends RowBindingContextBase {
+    readonly bindingState: typeof ROW_BINDING_STATES.TOMBSTONED;
+    readonly entityId: string;
+    readonly businessKey: string;
+}
+/** An ambiguous binding whose entity identity cannot be trusted. */
+export interface AmbiguousRowBindingContext extends RowBindingContextBase {
+    readonly bindingState: typeof ROW_BINDING_STATES.AMBIGUOUS;
+}
+/** A binding whose shape is determined by its lifecycle state. */
+export type RowBindingContext = CandidateRowBindingContext | ActiveRowBindingContext | TombstonedRowBindingContext | AmbiguousRowBindingContext;
+export type ResolutionAction = "acknowledge_system";
+export type ActorRole = "sheet_editor" | "sync_operator" | "sync_admin";
+/** A trusted resolution command for a conflict. */
+export interface ResolutionCommand {
+    readonly commandId: string;
+    readonly requestKey: string;
+    readonly action: ResolutionAction;
+    readonly actorId: string;
+    readonly role: ActorRole;
+    readonly targetConflictId: string;
+    readonly expectedRevision: number;
+    readonly activeCandidateHash: string;
+    /** Prevents an old acknowledgement from resolving an ABA candidate retry. */
+    readonly expectedCandidateEpoch: number;
+    readonly payloadHash: string;
+}
+export type EffectKind = "system_projection" | "candidate_reconcile" | "system_repair" | "resolution_projection"
+/** Removes a resolved system-owned Sync_Conflicts row after a visible CAS. */
+ | "resolution_delete"
+/** Removes one candidate-free User_Input row after a full-row visible CAS. */
+ | "user_input_delete";
+export type EffectTargetKind = "entity" | "row_binding" | "projection_row" | "conflict";
+export type EffectStatus = "pending" | "processing" | "applied" | "blocked_candidate" | "superseded" | "conflict" | "failed";
+/** A sheet effect to be dispatched by the outbox worker. */
+export interface SheetEffect {
+    readonly effectId: string;
+    readonly effectKind: EffectKind;
+    readonly commitId: string;
+    readonly sheetId: string;
+    readonly projection: Projection;
+    readonly rowBindingId: string;
+    readonly targetKind: EffectTargetKind;
+    readonly targetId: string;
+    readonly targetEntityRevision: number;
+    readonly targetFieldRevisionHash: string;
+    readonly targetCanonicalCommitId: string;
+    readonly expectedVisibleRevision: number;
+    readonly expectedVisibleHash: string;
+    readonly repairGuardHash: Presence<string>;
+    readonly sourceQuarantineId: Presence<string>;
+    readonly payloadHash: string;
+    readonly effectDedupeKey: string;
+    readonly streamSequence: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/domain/model/types.d.ts.map

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

package/dist/domain/model/types.js

@@ -0,0 +1,8 @@
+/**
+ * Pure domain model types shared across the core evaluator.
+ *
+ * These types contain no Google SDK, SQLite, or platform-specific values.
+ * All cell values are NormalizedCell, all timestamps are audit-only ISO strings.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/domain/model/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/domain/model/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Public surface for the SQLite-authoritative sync foundation.
+ *
+ * The SQLite-authoritative sync bootstrap is explicitly service-side: it uses
+ * a secret-bearing Apps Script client and must never be bundled into a browser.
+ */
+export * from "./domain/index.js";
+export * from "./application/index.js";
+export * from "./infrastructure/index.js";
+export type { SqlExecutor, SqlGeneratedId, SqlMutationResult, SqlParameter, SqlStorageAdapter, SqlStorageContext, } from "./adapter/persistence/index.js";
+export { AppsScriptSyncGatewayError, APPS_SCRIPT_OPERATION_NAMES, AppsScriptOperationClient, createApplyEffectsOperation, createEnsureRowAnchorsOperation, createObserveSnapshotOperation, createFastAppendRowsOperation, createReadEffectPostconditionOperation, createReadEffectPostconditionsOperation, createReadSnapshotOperation, createReadTableRowsOperation, AppsScriptOperationSyncGateway, } from "./adapter/sheets/providers/apps-script-gateway/index.js";
+export type { AppsScriptOperationDefinition, AnyAppsScriptOperationDefinition, AppsScriptOperationGateway, AppsScriptOperationResult, AppsScriptOperationResults, AppsScriptOperationClientOptions, AppsScriptOperationRequestEvent, AppsScriptOperationName, } from "./adapter/sheets/providers/apps-script-gateway/index.js";
+export type { AppsScriptFastAppendOperationArgs, AppsScriptFastAppendOperationRequest, AppsScriptFastAppendOperation, } from "./adapter/sheets/providers/apps-script-gateway/index.js";
+export type { AppsScriptApplyEffectsOperationArgs, AppsScriptApplyEffectsOperationRequest, AppsScriptReadEffectPostconditionOperationArgs, AppsScriptReadEffectPostconditionsOperationArgs, } from "./adapter/sheets/providers/apps-script-gateway/index.js";
+export type { AppsScriptEnsureRowAnchorsOperationArgs, AppsScriptObserveSnapshotOperationArgs, AppsScriptReadSnapshotOperationArgs, AppsScriptReadTableRowsRequest, } from "./adapter/sheets/providers/apps-script-gateway/index.js";
+export type { AppsScriptOperationProjectionStatus, AppsScriptOperationSyncGatewayOptions, } from "./adapter/sheets/providers/apps-script-gateway/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,YAAY,EACV,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,2BAA2B,EAC3B,+BAA+B,EAC/B,8BAA8B,EAC9B,6BAA6B,EAC7B,sCAAsC,EACtC,uCAAuC,EACvC,2BAA2B,EAC3B,4BAA4B,EAC5B,8BAA8B,GAC/B,MAAM,yDAAyD,CAAC;AACjE,YAAY,EACV,6BAA6B,EAC7B,gCAAgC,EAChC,0BAA0B,EAC1B,yBAAyB,EACzB,0BAA0B,EAC1B,gCAAgC,EAChC,+BAA+B,EAC/B,uBAAuB,GACxB,MAAM,yDAAyD,CAAC;AACjE,YAAY,EACV,iCAAiC,EACjC,oCAAoC,EACpC,6BAA6B,GAC9B,MAAM,yDAAyD,CAAC;AACjE,YAAY,EACV,mCAAmC,EACnC,sCAAsC,EACtC,8CAA8C,EAC9C,+CAA+C,GAChD,MAAM,yDAAyD,CAAC;AACjE,YAAY,EACV,uCAAuC,EACvC,sCAAsC,EACtC,mCAAmC,EACnC,8BAA8B,GAC/B,MAAM,yDAAyD,CAAC;AACjE,YAAY,EACV,mCAAmC,EACnC,qCAAqC,GACtC,MAAM,yDAAyD,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * Public surface for the SQLite-authoritative sync foundation.
+ *
+ * The SQLite-authoritative sync bootstrap is explicitly service-side: it uses
+ * a secret-bearing Apps Script client and must never be bundled into a browser.
+ */
+export * from "./domain/index.js";
+export * from "./application/index.js";
+export * from "./infrastructure/index.js";
+export { AppsScriptSyncGatewayError, APPS_SCRIPT_OPERATION_NAMES, AppsScriptOperationClient, createApplyEffectsOperation, createEnsureRowAnchorsOperation, createObserveSnapshotOperation, createFastAppendRowsOperation, createReadEffectPostconditionOperation, createReadEffectPostconditionsOperation, createReadSnapshotOperation, createReadTableRowsOperation, AppsScriptOperationSyncGateway, } from "./adapter/sheets/providers/apps-script-gateway/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAS1C,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,2BAA2B,EAC3B,+BAA+B,EAC/B,8BAA8B,EAC9B,6BAA6B,EAC7B,sCAAsC,EACtC,uCAAuC,EACvC,2BAA2B,EAC3B,4BAA4B,EAC5B,8BAA8B,GAC/B,MAAM,yDAAyD,CAAC"}

package/dist/infrastructure/index.d.ts

@@ -0,0 +1,3 @@
+/** Concrete persistence and recovery implementations. */
+export * from "./storage/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/infrastructure/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAEzD,cAAc,oBAAoB,CAAC"}

package/dist/infrastructure/index.js

@@ -0,0 +1,3 @@
+/** Concrete persistence and recovery implementations. */
+export * from "./storage/index.js";
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/infrastructure/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAEzD,cAAc,oBAAoB,CAAC"}

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

@@ -0,0 +1,4 @@
+export { EMPTY_ARRAY_LENGTH_ZERO, EMPTY_STRING_LENGTH_ZERO, POSITIVE_SAFE_INTEGER_MINIMUM, } from "../../shared/constants.js";
+/** Number of rows expected when one guarded storage mutation succeeds. */
+export declare const EXPECTED_SINGLE_ROW_CHANGE_COUNT: 1;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/storage/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,2BAA2B,CAAC;AAEnC,0EAA0E;AAC1E,eAAO,MAAM,gCAAgC,EAAG,CAAU,CAAC"}

package/dist/infrastructure/storage/constants.js

@@ -0,0 +1,4 @@
+export { EMPTY_ARRAY_LENGTH_ZERO, EMPTY_STRING_LENGTH_ZERO, POSITIVE_SAFE_INTEGER_MINIMUM, } from "../../shared/constants.js";
+/** Number of rows expected when one guarded storage mutation succeeds. */
+export const EXPECTED_SINGLE_ROW_CHANGE_COUNT = 1;
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/infrastructure/storage/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,2BAA2B,CAAC;AAEnC,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAU,CAAC"}