hikoutei 0.2.0

package/dist/application/sync/outbound/reconciliation/ReconciliationScanner.js

@@ -0,0 +1,518 @@
+/**
+ * Periodic reconciliation scanner for the System_State projection.
+ *
+ * SQLite is the canonical state; the Sheet is a projection that may drift when
+ * the fast-append path skips per-effect CAS, when a spreadsheet owner edits a
+ * protected tab, or when a response is lost. This scanner compares the durable
+ * desired state against one gateway snapshot per scan and, for every drift, it
+ * enqueues a normal system_projection effect on the existing outbox. The effect
+ * worker then applies the correction through the same slow path (with CAS) used
+ * by regular writes, so reconciliation never writes to the Sheet directly.
+ *
+ * Scope is intentionally limited to System_State in v1: that projection is
+ * protected and hidden, so the canonical state is always authoritative and a
+ * drift is always a repair target. User_Input reconciliation remains the
+ * responsibility of the candidate/conflict pipeline.
+ */
+import { randomUUID } from "node:crypto";
+import { EMPTY_STRING_LENGTH_ZERO, POSITIVE_SAFE_INTEGER_MINIMUM, stableHash, } from "../../../../domain/index.js";
+import { APPLICABILITY_KINDS, PRESENCE_KINDS, } from "../../../../shared/state/index.js";
+import { NORMALIZED_CELL_KINDS } from "../../../../shared/encoding/constants.js";
+import { appendPendingEffectsWithAdapter, claimWriterLeaseWithAdapter, requireRegisteredSyncSheetWithAdapter, WRITER_LEASE_CLAIM_RESULT_KINDS, } from "../../../../infrastructure/storage/index.js";
+import { STORAGE_ERROR_CODES, StorageError } from "../../../../infrastructure/storage/errors.js";
+import { computeSyncVisibleHash, observeSyncSnapshot, } from "../../gateway/syncGateway.js";
+import { SYNC_GATEWAY_PROJECTIONS, SYNC_GATEWAY_SNAPSHOT_READ_MODES, } from "../../gateway/constants.js";
+import { createSystemProjectionEffect } from "../projection/ProjectionEffectFactory.js";
+const DEFAULT_RECONCILIATION_ROLE = "typed-sheets-reconciler";
+const DEFAULT_RECONCILIATION_LEASE_MS = 60_000;
+const DEFAULT_SYSTEM_TOMBSTONE_FIELD = "_deleted";
+const READ_DESIRED_SYSTEM_STATE_SQL = `
+  SELECT
+    entity.entity_id              AS entity_id,
+    binding.row_binding_id        AS row_binding_id,
+    binding.anchor_reference      AS anchor_reference,
+    entity.entity_revision        AS entity_revision,
+    field.field_name              AS field_name,
+    field.normalized_value        AS normalized_value,
+    field.ownership               AS ownership
+  FROM entity_state AS entity
+  JOIN row_binding AS binding
+    ON binding.entity_id = entity.entity_id
+   AND binding.logical_sheet_id = ?
+   AND binding.state = 'active'
+  JOIN entity_field_state AS field
+    ON field.entity_id = entity.entity_id
+  WHERE entity.status = 'active'
+  ORDER BY entity.entity_id, field.field_name
+`;
+const READ_LATEST_VISIBLE_STATE_SQL = `
+  SELECT confirmed_visible_revision, confirmed_snapshot_hash
+  FROM sheet_visible_state
+  WHERE physical_sheet_id = ? AND projection = 'system_state' AND row_binding_id = ?
+`;
+const READ_LATEST_EFFECT_SQL = `
+  SELECT stream_sequence, expected_visible_revision, expected_visible_hash, status, payload_json
+  FROM sheet_effect_outbox
+  WHERE logical_sheet_id = ? AND target_kind = 'entity' AND target_id = ?
+  ORDER BY stream_sequence DESC
+  LIMIT 1
+`;
+/**
+ * Runs one reconciliation scan and enqueues correction effects for drift.
+ *
+ * The scan never writes to the Sheet. It only reads a snapshot and inserts
+ * effects into the durable outbox; the existing effect worker applies them.
+ */
+export async function runReconciliationScan(options) {
+    validateOptions(options);
+    const now = options.now ?? Date.now;
+    const createId = options.createId ?? randomUUID;
+    const tombstoneField = options.tombstoneField ?? (options.systemFields.includes(DEFAULT_SYSTEM_TOMBSTONE_FIELD)
+        ? DEFAULT_SYSTEM_TOMBSTONE_FIELD
+        : undefined);
+    const role = options.writerRole ?? DEFAULT_RECONCILIATION_ROLE;
+    const leaseDurationMs = options.leaseDurationMs ?? DEFAULT_RECONCILIATION_LEASE_MS;
+    const report = await scanAndEnqueue({
+        storage: options.storage,
+        gateway: options.gateway,
+        physicalSheetId: options.physicalSheetId,
+        logicalSheetId: options.logicalSheetId,
+        systemFields: options.systemFields,
+        tombstoneField,
+        schemaVersion: options.schemaVersion,
+        writerId: options.writerId,
+        now,
+        createId,
+        role,
+        leaseDurationMs,
+    });
+    try {
+        options.onReport?.(report);
+    }
+    catch {
+        // Observability callbacks must never fail the scan.
+    }
+    return report;
+}
+async function scanAndEnqueue(context) {
+    const sheet = await requireRegisteredSyncSheetWithAdapter(context.storage, context.physicalSheetId);
+    if (sheet.projection !== SYNC_GATEWAY_PROJECTIONS.SYSTEM_STATE) {
+        throw new StorageError(STORAGE_ERROR_CODES.INVALID_SYNC_REGISTRATION, "reconciliation scanner only supports the system_state projection");
+    }
+    const snapshotRequest = {
+        physicalSheetId: context.physicalSheetId,
+        sheetName: sheet.tabName,
+        registeredRange: sheet.registeredRange,
+        projection: SYNC_GATEWAY_PROJECTIONS.SYSTEM_STATE,
+        schemaVersion: sheet.schemaVersion,
+        readMode: SYNC_GATEWAY_SNAPSHOT_READ_MODES.FULL,
+    };
+    // Fast append intentionally skips metadata. Reconciliation is the lazy
+    // repair point that assigns stable anchors before comparing the snapshot.
+    const observed = await observeSyncSnapshot(context.gateway, snapshotRequest);
+    const snapshot = observed.snapshot;
+    const desired = await readDesiredSystemState(context);
+    const drifts = computeDrifts({
+        snapshot,
+        desired,
+        systemFields: context.systemFields,
+        sheet,
+    });
+    if (drifts.length === 0) {
+        return freezeReport(context.physicalSheetId, snapshot, desired, {
+            matched: countMatchedRows(snapshot, desired, sheet.businessKeyField),
+            drifted: 0,
+            missing: 0,
+            extra: countExtraRows(snapshot, desired, sheet.businessKeyField),
+            effects: 0,
+            fenceClaimed: false,
+        });
+    }
+    const fence = await claimReconcilerFence(context);
+    if (fence === null) {
+        return freezeReport(context.physicalSheetId, snapshot, desired, {
+            matched: countMatchedRows(snapshot, desired, sheet.businessKeyField),
+            drifted: drifts.filter((drift) => drift.kind === "drifted").length,
+            missing: drifts.filter((drift) => drift.kind === "missing").length,
+            extra: 0,
+            effects: 0,
+            fenceClaimed: false,
+        });
+    }
+    const effects = await buildCorrectionEffects(context, sheet, drifts, fence);
+    if (effects.length === 0) {
+        return freezeReport(context.physicalSheetId, snapshot, desired, {
+            matched: countMatchedRows(snapshot, desired, sheet.businessKeyField),
+            drifted: drifts.filter((drift) => drift.kind === "drifted").length,
+            missing: drifts.filter((drift) => drift.kind === "missing").length,
+            extra: countExtraRows(snapshot, desired, sheet.businessKeyField),
+            effects: 0,
+            fenceClaimed: true,
+        });
+    }
+    const enqueued = await appendPendingEffectsWithAdapter(context.storage, fence, effects);
+    if (!enqueued) {
+        return freezeReport(context.physicalSheetId, snapshot, desired, {
+            matched: countMatchedRows(snapshot, desired, sheet.businessKeyField),
+            drifted: drifts.filter((drift) => drift.kind === "drifted").length,
+            missing: drifts.filter((drift) => drift.kind === "missing").length,
+            extra: countExtraRows(snapshot, desired, sheet.businessKeyField),
+            effects: 0,
+            fenceClaimed: true,
+        });
+    }
+    return freezeReport(context.physicalSheetId, snapshot, desired, {
+        matched: countMatchedRows(snapshot, desired, sheet.businessKeyField),
+        drifted: drifts.filter((drift) => drift.kind === "drifted").length,
+        missing: drifts.filter((drift) => drift.kind === "missing").length,
+        extra: countExtraRows(snapshot, desired, sheet.businessKeyField),
+        effects: effects.length,
+        fenceClaimed: true,
+    });
+}
+function computeDrifts(args) {
+    const rowsByAnchor = new Map();
+    const rowsByIdentity = new Map();
+    const ambiguousIdentities = new Set();
+    for (const row of args.snapshot.rows) {
+        if (row.physicalAnchor.kind === PRESENCE_KINDS.PRESENT) {
+            rowsByAnchor.set(row.physicalAnchor.value, row);
+        }
+        const identity = snapshotIdentity(row, args.sheet.businessKeyField);
+        if (identity === undefined || ambiguousIdentities.has(identity))
+            continue;
+        if (rowsByIdentity.has(identity)) {
+            rowsByIdentity.delete(identity);
+            ambiguousIdentities.add(identity);
+        }
+        else {
+            rowsByIdentity.set(identity, row);
+        }
+    }
+    const drifts = [];
+    for (const desiredRow of args.desired) {
+        const observed = rowsByAnchor.get(desiredRow.anchorReference) ??
+            (ambiguousIdentities.has(desiredRow.entityId)
+                ? undefined
+                : rowsByIdentity.get(desiredRow.entityId));
+        if (observed === undefined) {
+            drifts.push({ kind: "missing", desired: desiredRow });
+            continue;
+        }
+        const observedHash = computeObservedHash(observed, args.systemFields);
+        const desiredHash = computeSyncVisibleHash(desiredRow.fields);
+        if (observedHash !== desiredHash) {
+            drifts.push({ kind: "drifted", desired: desiredRow });
+        }
+    }
+    return drifts;
+}
+/** Reads a business-key value from a snapshot row for unanchored fast appends. */
+function snapshotIdentity(row, identityField) {
+    const cell = row.cells[identityField]?.normalizedCell;
+    if (cell === undefined || cell === null)
+        return undefined;
+    switch (cell.kind) {
+        case NORMALIZED_CELL_KINDS.STRING:
+            return cell.value.length === EMPTY_STRING_LENGTH_ZERO ? undefined : cell.value;
+        case NORMALIZED_CELL_KINDS.NUMBER:
+            return Number.isFinite(cell.value) ? String(cell.value) : undefined;
+        case NORMALIZED_CELL_KINDS.BOOLEAN:
+            return String(cell.value);
+        case NORMALIZED_CELL_KINDS.DATE:
+            return cell.value;
+    }
+}
+function computeObservedHash(row, systemFields) {
+    const values = {};
+    for (const fieldName of systemFields) {
+        const cell = row.cells[fieldName];
+        values[fieldName] = cell === undefined ? null : cell.normalizedCell;
+    }
+    return computeSyncVisibleHash(values);
+}
+async function readDesiredSystemState(context) {
+    return context.storage.read(({ sql }) => readDesiredSystemStateWithSql(sql, context));
+}
+async function readDesiredSystemStateWithSql(sql, context) {
+    const rows = await sql.all(READ_DESIRED_SYSTEM_STATE_SQL, [
+        context.logicalSheetId,
+    ]);
+    const byEntity = new Map();
+    for (const row of rows) {
+        const existing = byEntity.get(row.entity_id);
+        const cell = decodeNormalizedCell(row.normalized_value);
+        if (existing === undefined) {
+            const fields = {};
+            fields[row.field_name] = cell;
+            byEntity.set(row.entity_id, {
+                entityId: row.entity_id,
+                rowBindingId: row.row_binding_id,
+                anchorReference: row.anchor_reference,
+                entityRevision: row.entity_revision,
+                fields,
+                fieldRevisionHash: "",
+            });
+            continue;
+        }
+        existing.fields[row.field_name] = cell;
+    }
+    const desired = [];
+    for (const row of byEntity.values()) {
+        ensureTombstoneField(row, context.tombstoneField);
+        const hash = computeFieldRevisionHash(row.fields);
+        desired.push({ ...row, fieldRevisionHash: hash });
+    }
+    return desired;
+}
+function ensureTombstoneField(row, tombstoneField) {
+    if (tombstoneField === undefined)
+        return;
+    const fields = row.fields;
+    if (fields[tombstoneField] === undefined) {
+        fields[tombstoneField] = { kind: NORMALIZED_CELL_KINDS.BOOLEAN, value: false };
+    }
+}
+function computeFieldRevisionHash(fields) {
+    const entries = Object.entries(fields)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([fieldName, value]) => ({ fieldName, value }));
+    return stableHash({ fields: entries });
+}
+function decodeNormalizedCell(value) {
+    try {
+        const parsed = JSON.parse(value);
+        if (!isNormalizedCellLike(parsed)) {
+            throw new StorageError(STORAGE_ERROR_CODES.OBSERVATION_STORAGE_INCONSISTENT, "entity_field_state.normalized_value is not a normalized cell");
+        }
+        return parsed;
+    }
+    catch (error) {
+        if (error instanceof StorageError)
+            throw error;
+        throw new StorageError(STORAGE_ERROR_CODES.OBSERVATION_STORAGE_INCONSISTENT, "entity_field_state.normalized_value is not valid JSON");
+    }
+}
+function isNormalizedCellLike(value) {
+    if (value === null)
+        return true;
+    if (typeof value !== "object" || value === null)
+        return false;
+    const cell = value;
+    return typeof cell.kind === "string";
+}
+async function buildCorrectionEffects(context, sheet, drifts, fence) {
+    const effects = [];
+    const commitId = "reconciliation:" + context.createId();
+    for (const drift of drifts) {
+        const baseline = await resolveCorrectionBaseline(context, drift.desired);
+        if (baseline.skip)
+            continue;
+        const effect = createSystemProjectionEffect({
+            effectId: "effect:" + context.createId(),
+            commitId,
+            logicalSheetId: context.logicalSheetId,
+            physicalSheetId: context.physicalSheetId,
+            sheetName: sheet.tabName,
+            registeredRange: sheet.registeredRange,
+            projection: SYNC_GATEWAY_PROJECTIONS.SYSTEM_STATE,
+            schemaVersion: context.schemaVersion,
+            targetKind: "entity",
+            targetId: drift.desired.entityId,
+            rowBindingId: { kind: PRESENCE_KINDS.PRESENT, value: drift.desired.rowBindingId },
+            conflictId: { kind: PRESENCE_KINDS.ABSENT },
+            targetAnchor: drift.desired.anchorReference,
+            fields: drift.desired.fields,
+            createIfMissing: baseline.createIfMissing,
+            expectedVisibleRevision: baseline.expectedVisibleRevision,
+            expectedVisibleHash: baseline.expectedVisibleHash,
+            targetEntityRevision: {
+                kind: APPLICABILITY_KINDS.APPLICABLE,
+                value: drift.desired.entityRevision,
+            },
+            targetFieldRevisionHash: {
+                kind: APPLICABILITY_KINDS.APPLICABLE,
+                value: drift.desired.fieldRevisionHash,
+            },
+            targetCanonicalCommitId: { kind: APPLICABILITY_KINDS.APPLICABLE, value: commitId },
+            streamSequence: baseline.streamSequence,
+        });
+        effects.push(effect);
+    }
+    return effects;
+}
+async function resolveCorrectionBaseline(context, desired) {
+    return context.storage.read(({ sql }) => resolveCorrectionBaselineWithSql(sql, context, desired));
+}
+async function resolveCorrectionBaselineWithSql(sql, context, desired) {
+    const latestEffect = await sql.get(READ_LATEST_EFFECT_SQL, [
+        context.logicalSheetId,
+        desired.entityId,
+    ]);
+    if (latestEffect !== undefined && latestEffect.stream_sequence !== null) {
+        const streamSequence = latestEffect.stream_sequence + 1;
+        if (latestEffect.status === "pending" || latestEffect.status === "processing") {
+            const payload = latestEffect.payload_json;
+            const expectedHash = payload === null ? "" : extractTargetVisibleHash(payload);
+            if (expectedHash === computeSyncVisibleHash(desired.fields)) {
+                // A canonical write already has an equivalent correction in flight.
+                // Do not append another stream item on every periodic scan while the
+                // first item is waiting for the gateway or its recovery read-back.
+                return {
+                    skip: true,
+                    expectedVisibleRevision: (latestEffect.expected_visible_revision ?? 0) + 1,
+                    expectedVisibleHash: expectedHash,
+                    createIfMissing: false,
+                    streamSequence,
+                };
+            }
+            return {
+                skip: false,
+                expectedVisibleRevision: (latestEffect.expected_visible_revision ?? 0) + 1,
+                expectedVisibleHash: expectedHash,
+                createIfMissing: false,
+                streamSequence,
+            };
+        }
+        const visible = await sql.get(READ_LATEST_VISIBLE_STATE_SQL, [
+            context.physicalSheetId,
+            desired.rowBindingId,
+        ]);
+        return baselineFromVisible(visible, streamSequence);
+    }
+    const visible = await sql.get(READ_LATEST_VISIBLE_STATE_SQL, [
+        context.physicalSheetId,
+        desired.rowBindingId,
+    ]);
+    return baselineFromVisible(visible, POSITIVE_SAFE_INTEGER_MINIMUM);
+}
+function baselineFromVisible(visible, streamSequence) {
+    if (visible === undefined ||
+        visible.confirmed_visible_revision === null ||
+        visible.confirmed_snapshot_hash === null ||
+        visible.confirmed_snapshot_hash.length === 0) {
+        return {
+            skip: false,
+            expectedVisibleRevision: 0,
+            expectedVisibleHash: "",
+            createIfMissing: true,
+            streamSequence,
+        };
+    }
+    return {
+        skip: false,
+        expectedVisibleRevision: visible.confirmed_visible_revision,
+        expectedVisibleHash: visible.confirmed_snapshot_hash,
+        createIfMissing: false,
+        streamSequence,
+    };
+}
+function extractTargetVisibleHash(payloadJson) {
+    try {
+        const parsed = JSON.parse(payloadJson);
+        return typeof parsed.targetVisibleHash === "string" ? parsed.targetVisibleHash : "";
+    }
+    catch {
+        return "";
+    }
+}
+async function claimReconcilerFence(context) {
+    const claim = await claimWriterLeaseWithAdapter(context.storage, {
+        role: context.role,
+        writerId: context.writerId,
+        leaseDurationMs: context.leaseDurationMs,
+        now: context.now(),
+    });
+    if (claim.kind !== WRITER_LEASE_CLAIM_RESULT_KINDS.CLAIMED)
+        return null;
+    const lease = claim.lease;
+    return {
+        role: lease.role,
+        writerEpoch: lease.writerEpoch,
+        fencingToken: lease.fencingToken,
+        now: context.now(),
+    };
+}
+function countMatchedRows(snapshot, desired, identityField) {
+    const anchors = new Set();
+    const identities = new Set();
+    const duplicateIdentities = new Set();
+    for (const row of snapshot.rows) {
+        if (row.physicalAnchor.kind === PRESENCE_KINDS.PRESENT)
+            anchors.add(row.physicalAnchor.value);
+        const identity = snapshotIdentity(row, identityField);
+        if (identity === undefined || duplicateIdentities.has(identity))
+            continue;
+        if (identities.has(identity)) {
+            identities.delete(identity);
+            duplicateIdentities.add(identity);
+        }
+        else {
+            identities.add(identity);
+        }
+    }
+    let matched = 0;
+    for (const row of desired) {
+        if (anchors.has(row.anchorReference) || identities.has(row.entityId))
+            matched += 1;
+    }
+    return matched;
+}
+function countExtraRows(snapshot, desired, identityField) {
+    const desiredAnchors = new Set(desired.map((row) => row.anchorReference));
+    const desiredIdentities = new Set(desired.map((row) => row.entityId));
+    let extra = 0;
+    for (const row of snapshot.rows) {
+        if (row.physicalAnchor.kind === PRESENCE_KINDS.PRESENT && desiredAnchors.has(row.physicalAnchor.value)) {
+            continue;
+        }
+        const identity = snapshotIdentity(row, identityField);
+        if (identity !== undefined && desiredIdentities.has(identity))
+            continue;
+        extra += 1;
+    }
+    return extra;
+}
+function freezeReport(physicalSheetId, snapshot, desired, delta) {
+    return {
+        physicalSheetId,
+        snapshotRowsScanned: snapshot.rows.length,
+        desiredRowsScanned: desired.length,
+        matchedRows: delta.matched,
+        driftedRows: delta.drifted,
+        missingRows: delta.missing,
+        extraRows: delta.extra,
+        effectsEnqueued: delta.effects,
+        fenceClaimed: delta.fenceClaimed,
+    };
+}
+function validateOptions(options) {
+    if (options.physicalSheetId.length === 0) {
+        throw new StorageError(STORAGE_ERROR_CODES.INVALID_SYNC_REGISTRATION, "reconciliation scanner requires a physical sheet id");
+    }
+    if (options.logicalSheetId.length === 0) {
+        throw new StorageError(STORAGE_ERROR_CODES.INVALID_SYNC_REGISTRATION, "reconciliation scanner requires a logical sheet id");
+    }
+    if (options.systemFields.length === 0) {
+        throw new StorageError(STORAGE_ERROR_CODES.INVALID_SYNC_REGISTRATION, "reconciliation scanner requires at least one system field");
+    }
+    if (!Number.isSafeInteger(options.schemaVersion) ||
+        options.schemaVersion < POSITIVE_SAFE_INTEGER_MINIMUM) {
+        throw new StorageError(STORAGE_ERROR_CODES.INVALID_SYNC_REGISTRATION, "reconciliation scanner schemaVersion must be a positive safe integer");
+    }
+    if (options.writerId.length === 0) {
+        throw new StorageError(STORAGE_ERROR_CODES.STALE_WRITER_FENCE, "reconciliation scanner writerId is required");
+    }
+    if (options.leaseDurationMs !== undefined &&
+        (!Number.isSafeInteger(options.leaseDurationMs) ||
+            options.leaseDurationMs < POSITIVE_SAFE_INTEGER_MINIMUM)) {
+        throw new StorageError(STORAGE_ERROR_CODES.STALE_WRITER_FENCE, "reconciliation scanner leaseDurationMs must be a positive safe integer");
+    }
+}
+// Re-export for callers that want the constants used as defaults.
+export const RECONCILIATION_DEFAULTS = {
+    ROLE: DEFAULT_RECONCILIATION_ROLE,
+    LEASE_MS: DEFAULT_RECONCILIATION_LEASE_MS,
+    TOMBSTONE_FIELD: DEFAULT_SYSTEM_TOMBSTONE_FIELD,
+};
+//# sourceMappingURL=ReconciliationScanner.js.map

package/dist/application/sync/outbound/reconciliation/ReconciliationScanner.js.map

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

package/dist/application/sync/telemetry/syncTiming.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Shared timing(소요 시간) contracts for the SQLite-to-Sheets write pipeline.
+ *
+ * Timing is diagnostic only: a sink failure must never change persistence or
+ * gateway behavior. The operation kinds describe the public lifecycle while
+ * phases describe implementation boundaries that can be compared in a trace.
+ */
+export declare const SYNC_TIMING_SCOPES: {
+    readonly ORM_FLUSH: "orm_flush";
+    readonly WORKER: "worker";
+    readonly GATEWAY: "gateway";
+};
+export type SyncTimingScope = (typeof SYNC_TIMING_SCOPES)[keyof typeof SYNC_TIMING_SCOPES];
+export declare const SYNC_TIMING_OPERATION_KINDS: {
+    readonly APPEND: "append";
+    readonly UPDATE: "update";
+    readonly DELETE: "delete";
+};
+export type SyncTimingOperationKind = (typeof SYNC_TIMING_OPERATION_KINDS)[keyof typeof SYNC_TIMING_OPERATION_KINDS];
+/** Count of lifecycle operations represented by one timing event. */
+export interface SyncTimingOperationCounts {
+    readonly append: number;
+    readonly update: number;
+    readonly delete: number;
+}
+/** One measured implementation phase inside a remote gateway operation. */
+export interface SyncGatewayTimingPhase {
+    readonly phase: string;
+    readonly durationMs: number;
+}
+/** Timing returned by one dynamically evaluated Apps Script operation. */
+export interface SyncGatewayTiming {
+    readonly operationKinds: readonly SyncTimingOperationKind[];
+    readonly operationCounts: SyncTimingOperationCounts;
+    readonly durationMs: number;
+    readonly phases: readonly SyncGatewayTimingPhase[];
+}
+/** One local or remote phase sent to the application's diagnostics sink. */
+export interface SyncTimingEvent {
+    readonly scope: SyncTimingScope;
+    readonly phase: string;
+    readonly durationMs: number;
+    readonly operationKinds: readonly SyncTimingOperationKind[];
+    readonly operationCounts: SyncTimingOperationCounts;
+}
+/** Optional observer used by servers and benchmarks to collect timings. */
+export type SyncTimingSink = (event: SyncTimingEvent) => void;
+/** Creates a zeroed operation count without sharing mutable state. */
+export declare function emptySyncTimingOperationCounts(): SyncTimingOperationCounts;
+//# sourceMappingURL=syncTiming.d.ts.map

package/dist/application/sync/telemetry/syncTiming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncTiming.d.ts","sourceRoot":"","sources":["../../../../src/application/sync/telemetry/syncTiming.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,kBAAkB;;;;CAIrB,CAAC;AAEX,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE/D,eAAO,MAAM,2BAA2B;;;;CAI9B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAC;AAEjF,qEAAqE;AACrE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,2EAA2E;AAC3E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,cAAc,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC5D,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACpD;AAED,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC5D,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC;CACrD;AAED,2EAA2E;AAC3E,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAE9D,sEAAsE;AACtE,wBAAgB,8BAA8B,IAAI,yBAAyB,CAE1E"}

package/dist/application/sync/telemetry/syncTiming.js

@@ -0,0 +1,22 @@
+/**
+ * Shared timing(소요 시간) contracts for the SQLite-to-Sheets write pipeline.
+ *
+ * Timing is diagnostic only: a sink failure must never change persistence or
+ * gateway behavior. The operation kinds describe the public lifecycle while
+ * phases describe implementation boundaries that can be compared in a trace.
+ */
+export const SYNC_TIMING_SCOPES = {
+    ORM_FLUSH: "orm_flush",
+    WORKER: "worker",
+    GATEWAY: "gateway",
+};
+export const SYNC_TIMING_OPERATION_KINDS = {
+    APPEND: "append",
+    UPDATE: "update",
+    DELETE: "delete",
+};
+/** Creates a zeroed operation count without sharing mutable state. */
+export function emptySyncTimingOperationCounts() {
+    return { append: 0, update: 0, delete: 0 };
+}
+//# sourceMappingURL=syncTiming.js.map

package/dist/application/sync/telemetry/syncTiming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncTiming.js","sourceRoot":"","sources":["../../../../src/application/sync/telemetry/syncTiming.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;CACV,CAAC;AAKX,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACR,CAAC;AAsCX,sEAAsE;AACtE,MAAM,UAAU,8BAA8B;IAC5C,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AAC7C,CAAC"}