@dsh-enhanced/preference-learning 0.1.7 → 0.1.14

package/lib/sqlite.js

@@ -1,7 +1,8 @@
+import { createHash } from 'node:crypto';
 import { chmodSync, closeSync, constants, lstatSync, mkdirSync, openSync, } from 'node:fs';
 import { dirname, isAbsolute } from 'node:path';
 import { DatabaseSync } from 'node:sqlite';
-export const preferenceSchemaVersion = 1;
+export const preferenceSchemaVersion = 12;
 export class PreferenceDatabaseError extends Error {
     code;
     constructor(code, message) {
@@ -38,6 +39,20 @@ function preparePrivateFile(path) {
 function userVersion(database) {
     return database.prepare('PRAGMA user_version').get().user_version;
 }
+/** Opaque stable binding used after cancellation rows redact their owner lineage. */
+export function preferencePromotionCancellationUpgradeBindingDigest(input) {
+    return createHash('sha256')
+        .update('preference-memory-promotion-cancellation-upgrade/v1\0')
+        .update(JSON.stringify([
+        input.promotionId,
+        input.promotionGeneration,
+        input.requestDigest,
+        input.principalLineageId,
+        input.principalLineageVersion,
+        input.ownerGeneration,
+    ]))
+        .digest('hex');
+}
 function migrate(database) {
     let transactionStarted = false;
     try {
@@ -54,7 +69,8 @@ function migrate(database) {
             transactionStarted = false;
             return;
         }
-        database.exec(`
+        if (current < 1)
+            database.exec(`
       CREATE TABLE preference_schema_meta (
         key TEXT PRIMARY KEY,
         value TEXT NOT NULL
@@ -153,6 +169,631 @@ function migrate(database) {
       INSERT INTO preference_schema_meta(key, value) VALUES ('schema-version', '1');
       PRAGMA user_version = 1;
     `);
+        if (current < 2)
+            database.exec(`
+      CREATE TABLE preference_host_maintenance_receipts (
+        idempotency_key TEXT PRIMARY KEY,
+        payload_hash TEXT NOT NULL,
+        scope_digest TEXT NOT NULL,
+        deleted_signals INTEGER NOT NULL CHECK (deleted_signals IN (0, 1)),
+        occurred_at INTEGER NOT NULL
+      ) STRICT;
+      CREATE INDEX preference_host_maintenance_scope_time
+        ON preference_host_maintenance_receipts(scope_digest, occurred_at DESC, idempotency_key);
+      UPDATE preference_schema_meta SET value = '2' WHERE key = 'schema-version';
+      PRAGMA user_version = 2;
+    `);
+        if (current < 3)
+            database.exec(`
+      CREATE TABLE preference_host_activation_receipts (
+        idempotency_key TEXT PRIMARY KEY,
+        payload_hash TEXT NOT NULL,
+        scope_digest TEXT NOT NULL,
+        hypothesis_id TEXT NOT NULL,
+        expected_version INTEGER NOT NULL CHECK (expected_version >= 1),
+        result_version INTEGER NOT NULL CHECK (result_version = expected_version + 1),
+        occurred_at INTEGER NOT NULL
+      ) STRICT;
+      CREATE INDEX preference_host_activation_scope_time
+        ON preference_host_activation_receipts(scope_digest, occurred_at DESC, idempotency_key);
+      UPDATE preference_schema_meta SET value = '3' WHERE key = 'schema-version';
+      PRAGMA user_version = 3;
+    `);
+        if (current < 4)
+            database.exec(`
+      CREATE TABLE preference_exposures (
+        idempotency_key TEXT PRIMARY KEY,
+        payload_hash TEXT NOT NULL,
+        scope_key TEXT NOT NULL,
+        workspace TEXT NOT NULL,
+        preset TEXT NOT NULL,
+        hypothesis_id TEXT NOT NULL,
+        hypothesis_version INTEGER NOT NULL CHECK (hypothesis_version >= 1),
+        session_id TEXT NOT NULL,
+        source_event_id TEXT NOT NULL,
+        source_inbox_id TEXT,
+        reply_outbox_id TEXT,
+        state TEXT NOT NULL CHECK (state IN ('pending', 'bound')),
+        exposed_at INTEGER NOT NULL,
+        bound_at INTEGER,
+        expires_at INTEGER NOT NULL,
+        CHECK ((state = 'pending' AND source_inbox_id IS NULL AND reply_outbox_id IS NULL AND bound_at IS NULL)
+          OR (state = 'bound' AND source_inbox_id IS NOT NULL AND reply_outbox_id IS NOT NULL AND bound_at IS NOT NULL))
+      ) STRICT;
+      CREATE INDEX preference_exposures_turn
+        ON preference_exposures(scope_key, session_id, source_event_id, state, hypothesis_id);
+      CREATE INDEX preference_exposures_outbox
+        ON preference_exposures(scope_key, reply_outbox_id, state, hypothesis_id);
+      CREATE INDEX preference_exposures_expiry
+        ON preference_exposures(expires_at, idempotency_key);
+      CREATE TABLE preference_exposure_corrections (
+        signal_id TEXT NOT NULL,
+        hypothesis_id TEXT NOT NULL,
+        hypothesis_version INTEGER NOT NULL CHECK (hypothesis_version >= 1),
+        source_inbox_id TEXT NOT NULL,
+        reply_outbox_id TEXT NOT NULL,
+        occurred_at INTEGER NOT NULL,
+        PRIMARY KEY (signal_id, hypothesis_id, hypothesis_version)
+      ) STRICT;
+      CREATE INDEX preference_exposure_corrections_target
+        ON preference_exposure_corrections(reply_outbox_id, hypothesis_id, occurred_at);
+      UPDATE preference_schema_meta SET value = '4' WHERE key = 'schema-version';
+      PRAGMA user_version = 4;
+    `);
+        if (current < 5)
+            database.exec(`
+      CREATE TABLE preference_scope_principals (
+        scope_key TEXT PRIMARY KEY,
+        scope_digest TEXT NOT NULL,
+        principal_digest TEXT NOT NULL CHECK (
+          length(principal_digest) = 64 AND principal_digest NOT GLOB '*[^a-f0-9]*'
+        ),
+        generation INTEGER NOT NULL CHECK (generation >= 1),
+        claimed_at INTEGER NOT NULL,
+        purge_pending INTEGER NOT NULL CHECK (purge_pending IN (0, 1)),
+        updated_at INTEGER NOT NULL
+      ) STRICT;
+      CREATE INDEX preference_scope_principals_digest
+        ON preference_scope_principals(scope_digest, principal_digest);
+      UPDATE preference_schema_meta SET value = '5' WHERE key = 'schema-version';
+      PRAGMA user_version = 5;
+    `);
+        if (current < 6)
+            database.exec(`
+      ALTER TABLE preference_scope_principals
+        ADD COLUMN principal_lineage_id TEXT;
+      ALTER TABLE preference_scope_principals
+        ADD COLUMN principal_lineage_version INTEGER;
+      ALTER TABLE preference_scope_principals
+        ADD COLUMN learning_paused INTEGER NOT NULL DEFAULT 0
+        CHECK (learning_paused IN (0, 1));
+      ALTER TABLE preference_scope_principals
+        ADD COLUMN paused_at INTEGER;
+      ALTER TABLE preference_scope_principals
+        ADD COLUMN control_version INTEGER NOT NULL DEFAULT 1 CHECK (control_version >= 1);
+      ALTER TABLE preference_scope_principals
+        ADD COLUMN ignore_events_through INTEGER NOT NULL DEFAULT -1 CHECK (ignore_events_through >= -1);
+      ALTER TABLE preference_host_activation_receipts
+        ADD COLUMN owner_generation INTEGER;
+      ALTER TABLE preference_host_activation_receipts
+        ADD COLUMN principal_lineage_id TEXT;
+      ALTER TABLE preference_host_activation_receipts
+        ADD COLUMN principal_lineage_version INTEGER;
+      ALTER TABLE preference_host_maintenance_receipts
+        ADD COLUMN owner_generation INTEGER;
+      ALTER TABLE preference_host_maintenance_receipts
+        ADD COLUMN principal_lineage_id TEXT;
+      ALTER TABLE preference_host_maintenance_receipts
+        ADD COLUMN principal_lineage_version INTEGER;
+      CREATE TABLE preference_owner_control_receipts (
+        idempotency_key TEXT PRIMARY KEY,
+        payload_hash TEXT NOT NULL,
+        scope_digest TEXT NOT NULL,
+        principal_digest TEXT NOT NULL CHECK (
+          length(principal_digest) = 64 AND principal_digest NOT GLOB '*[^a-f0-9]*'
+        ),
+        generation INTEGER NOT NULL CHECK (generation >= 1),
+        action TEXT NOT NULL CHECK (action IN ('pause', 'resume')),
+        result_paused INTEGER NOT NULL CHECK (result_paused IN (0, 1)),
+        result_control_version INTEGER NOT NULL CHECK (result_control_version >= 1),
+        result_ignore_events_through INTEGER NOT NULL CHECK (result_ignore_events_through >= -1),
+        occurred_at INTEGER NOT NULL
+      ) STRICT;
+      CREATE INDEX preference_owner_control_scope_time
+        ON preference_owner_control_receipts(scope_digest, occurred_at DESC, idempotency_key);
+      UPDATE preference_schema_meta SET value = '6' WHERE key = 'schema-version';
+      PRAGMA user_version = 6;
+    `);
+        if (current < 7)
+            database.exec(`
+      ALTER TABLE preference_scope_principals
+        ADD COLUMN admission_cursor_epoch TEXT;
+      ALTER TABLE preference_scope_principals
+        ADD COLUMN lineage_claim_sequence INTEGER
+        CHECK (lineage_claim_sequence IS NULL OR lineage_claim_sequence >= 1);
+      ALTER TABLE preference_scope_principals
+        ADD COLUMN admission_high_water INTEGER
+        CHECK (admission_high_water IS NULL OR admission_high_water >= 1);
+      ALTER TABLE preference_scope_principals
+        ADD COLUMN admission_high_water_kind TEXT
+        CHECK (admission_high_water_kind IN ('control', 'event'));
+      ALTER TABLE preference_scope_principals
+        ADD COLUMN ignore_events_through_sequence INTEGER
+        CHECK (ignore_events_through_sequence IS NULL OR ignore_events_through_sequence >= 1);
+
+      -- v6 control receipts were ordered only by millisecond timestamps and
+      -- cannot safely participate in the v7 total order. Drop them instead of
+      -- inventing cursors during a rolling upgrade.
+      DROP TABLE preference_owner_control_receipts;
+      CREATE TABLE preference_owner_control_receipts (
+        idempotency_key TEXT PRIMARY KEY,
+        payload_hash TEXT NOT NULL,
+        scope_digest TEXT NOT NULL,
+        principal_digest TEXT NOT NULL CHECK (
+          length(principal_digest) = 64 AND principal_digest NOT GLOB '*[^a-f0-9]*'
+        ),
+        generation INTEGER NOT NULL CHECK (generation >= 1),
+        action TEXT NOT NULL CHECK (action IN ('forget', 'pause', 'resume', 'status')),
+        admission_cursor_epoch TEXT NOT NULL,
+        admission_cursor_sequence INTEGER NOT NULL CHECK (admission_cursor_sequence >= 1),
+        result_applied INTEGER NOT NULL CHECK (result_applied IN (0, 1)),
+        result_paused INTEGER NOT NULL CHECK (result_paused IN (0, 1)),
+        result_control_version INTEGER NOT NULL CHECK (result_control_version >= 1),
+        result_admission_high_water INTEGER
+          CHECK (result_admission_high_water IS NULL OR result_admission_high_water >= 1),
+        result_ignore_events_through_sequence INTEGER
+          CHECK (result_ignore_events_through_sequence IS NULL
+            OR result_ignore_events_through_sequence >= 1),
+        result_signals INTEGER NOT NULL CHECK (result_signals >= 0),
+        result_hypotheses INTEGER NOT NULL CHECK (result_hypotheses >= 0),
+        result_active_overlays INTEGER NOT NULL CHECK (result_active_overlays >= 0),
+        result_shadow_hypotheses INTEGER NOT NULL CHECK (result_shadow_hypotheses >= 0),
+        result_deleted_signals INTEGER NOT NULL DEFAULT 0 CHECK (result_deleted_signals >= 0),
+        result_deleted_hypotheses INTEGER NOT NULL DEFAULT 0 CHECK (result_deleted_hypotheses >= 0),
+        result_forgotten_through INTEGER NOT NULL DEFAULT -1 CHECK (result_forgotten_through >= -1),
+        occurred_at INTEGER NOT NULL
+      ) STRICT;
+      CREATE INDEX preference_owner_control_scope_time
+        ON preference_owner_control_receipts(
+          scope_digest, admission_cursor_epoch, admission_cursor_sequence DESC, idempotency_key
+        );
+      UPDATE preference_schema_meta SET value = '7' WHERE key = 'schema-version';
+      PRAGMA user_version = 7;
+    `);
+        if (current < 8)
+            database.exec(`
+      ALTER TABLE preference_owner_control_receipts
+        RENAME TO preference_owner_control_receipts_v7;
+      DROP INDEX preference_owner_control_scope_time;
+      CREATE TABLE preference_owner_control_receipts (
+        idempotency_key TEXT PRIMARY KEY,
+        payload_hash TEXT NOT NULL,
+        scope_digest TEXT NOT NULL,
+        principal_digest TEXT NOT NULL CHECK (
+          length(principal_digest) = 64 AND principal_digest NOT GLOB '*[^a-f0-9]*'
+        ),
+        generation INTEGER NOT NULL CHECK (generation >= 1),
+        action TEXT NOT NULL CHECK (action IN (
+          'explain', 'forget', 'pause', 'resume', 'rollback', 'status'
+        )),
+        target_preference_key TEXT,
+        admission_cursor_epoch TEXT NOT NULL,
+        admission_cursor_sequence INTEGER NOT NULL CHECK (admission_cursor_sequence >= 1),
+        result_applied INTEGER NOT NULL CHECK (result_applied IN (0, 1)),
+        result_paused INTEGER NOT NULL CHECK (result_paused IN (0, 1)),
+        result_control_version INTEGER NOT NULL CHECK (result_control_version >= 1),
+        result_admission_high_water INTEGER
+          CHECK (result_admission_high_water IS NULL OR result_admission_high_water >= 1),
+        result_ignore_events_through_sequence INTEGER
+          CHECK (result_ignore_events_through_sequence IS NULL
+            OR result_ignore_events_through_sequence >= 1),
+        result_signals INTEGER NOT NULL CHECK (result_signals >= 0),
+        result_hypotheses INTEGER NOT NULL CHECK (result_hypotheses >= 0),
+        result_active_overlays INTEGER NOT NULL CHECK (result_active_overlays >= 0),
+        result_stored_active_overlays INTEGER NOT NULL DEFAULT 0
+          CHECK (result_stored_active_overlays >= 0),
+        result_shadow_hypotheses INTEGER NOT NULL CHECK (result_shadow_hypotheses >= 0),
+        result_deleted_signals INTEGER NOT NULL DEFAULT 0 CHECK (result_deleted_signals >= 0),
+        result_deleted_hypotheses INTEGER NOT NULL DEFAULT 0 CHECK (result_deleted_hypotheses >= 0),
+        result_forgotten_through INTEGER NOT NULL DEFAULT -1 CHECK (result_forgotten_through >= -1),
+        result_explanation_json TEXT,
+        result_rolled_back INTEGER NOT NULL DEFAULT 0 CHECK (result_rolled_back IN (0, 1)),
+        result_rolled_back_version INTEGER
+          CHECK (result_rolled_back_version IS NULL OR result_rolled_back_version >= 2),
+        occurred_at INTEGER NOT NULL,
+        CHECK ((action = 'rollback' AND target_preference_key IS NOT NULL)
+          OR (action != 'rollback' AND target_preference_key IS NULL)),
+        CHECK ((action = 'explain' AND result_explanation_json IS NOT NULL)
+          OR (action != 'explain' AND result_explanation_json IS NULL)),
+        CHECK (result_rolled_back = 0 OR action = 'rollback')
+      ) STRICT;
+      INSERT INTO preference_owner_control_receipts(
+        idempotency_key, payload_hash, scope_digest, principal_digest, generation,
+        action, admission_cursor_epoch, admission_cursor_sequence, result_applied,
+        result_paused, result_control_version, result_admission_high_water,
+        result_ignore_events_through_sequence, result_signals, result_hypotheses,
+        result_active_overlays, result_stored_active_overlays, result_shadow_hypotheses,
+        result_deleted_signals, result_deleted_hypotheses,
+        result_forgotten_through, occurred_at
+      )
+      SELECT idempotency_key, payload_hash, scope_digest, principal_digest, generation,
+        action, admission_cursor_epoch, admission_cursor_sequence, result_applied,
+        result_paused, result_control_version, result_admission_high_water,
+        result_ignore_events_through_sequence, result_signals, result_hypotheses,
+        result_active_overlays, result_active_overlays, result_shadow_hypotheses,
+        result_deleted_signals, result_deleted_hypotheses,
+        result_forgotten_through, occurred_at
+      FROM preference_owner_control_receipts_v7;
+      DROP TABLE preference_owner_control_receipts_v7;
+      CREATE INDEX preference_owner_control_scope_time
+        ON preference_owner_control_receipts(
+          scope_digest, admission_cursor_epoch, admission_cursor_sequence DESC, idempotency_key
+        );
+      UPDATE preference_schema_meta SET value = '8' WHERE key = 'schema-version';
+      PRAGMA user_version = 8;
+    `);
+        if (current < 9)
+            database.exec(`
+      ALTER TABLE preference_owner_control_receipts
+        RENAME TO preference_owner_control_receipts_v8;
+      DROP INDEX preference_owner_control_scope_time;
+      CREATE TABLE preference_owner_control_receipts (
+        idempotency_key TEXT PRIMARY KEY,
+        payload_hash TEXT NOT NULL,
+        scope_digest TEXT NOT NULL,
+        principal_digest TEXT NOT NULL CHECK (
+          length(principal_digest) = 64 AND principal_digest NOT GLOB '*[^a-f0-9]*'
+        ),
+        generation INTEGER NOT NULL CHECK (generation >= 1),
+        action TEXT NOT NULL CHECK (action IN (
+          'explain', 'export', 'forget', 'pause', 'resume', 'rollback', 'status'
+        )),
+        target_preference_key TEXT,
+        admission_cursor_epoch TEXT NOT NULL,
+        admission_cursor_sequence INTEGER NOT NULL CHECK (admission_cursor_sequence >= 1),
+        result_applied INTEGER NOT NULL CHECK (result_applied IN (0, 1)),
+        result_paused INTEGER NOT NULL CHECK (result_paused IN (0, 1)),
+        result_control_version INTEGER NOT NULL CHECK (result_control_version >= 1),
+        result_admission_high_water INTEGER
+          CHECK (result_admission_high_water IS NULL OR result_admission_high_water >= 1),
+        result_ignore_events_through_sequence INTEGER
+          CHECK (result_ignore_events_through_sequence IS NULL
+            OR result_ignore_events_through_sequence >= 1),
+        result_signals INTEGER NOT NULL CHECK (result_signals >= 0),
+        result_hypotheses INTEGER NOT NULL CHECK (result_hypotheses >= 0),
+        result_active_overlays INTEGER NOT NULL CHECK (result_active_overlays >= 0),
+        result_stored_active_overlays INTEGER NOT NULL DEFAULT 0
+          CHECK (result_stored_active_overlays >= 0),
+        result_shadow_hypotheses INTEGER NOT NULL CHECK (result_shadow_hypotheses >= 0),
+        result_deleted_signals INTEGER NOT NULL DEFAULT 0 CHECK (result_deleted_signals >= 0),
+        result_deleted_hypotheses INTEGER NOT NULL DEFAULT 0 CHECK (result_deleted_hypotheses >= 0),
+        result_forgotten_through INTEGER NOT NULL DEFAULT -1 CHECK (result_forgotten_through >= -1),
+        result_explanation_json TEXT,
+        result_rolled_back INTEGER NOT NULL DEFAULT 0 CHECK (result_rolled_back IN (0, 1)),
+        result_rolled_back_version INTEGER
+          CHECK (result_rolled_back_version IS NULL OR result_rolled_back_version >= 2),
+        occurred_at INTEGER NOT NULL,
+        CHECK ((action = 'rollback' AND target_preference_key IS NOT NULL)
+          OR (action != 'rollback' AND target_preference_key IS NULL)),
+        CHECK ((action IN ('explain', 'export') AND result_explanation_json IS NOT NULL)
+          OR (action NOT IN ('explain', 'export') AND result_explanation_json IS NULL)),
+        CHECK (result_rolled_back = 0 OR action = 'rollback')
+      ) STRICT;
+      INSERT INTO preference_owner_control_receipts(
+        idempotency_key, payload_hash, scope_digest, principal_digest, generation,
+        action, target_preference_key, admission_cursor_epoch, admission_cursor_sequence,
+        result_applied, result_paused, result_control_version, result_admission_high_water,
+        result_ignore_events_through_sequence, result_signals, result_hypotheses,
+        result_active_overlays, result_stored_active_overlays, result_shadow_hypotheses,
+        result_deleted_signals, result_deleted_hypotheses, result_forgotten_through,
+        result_explanation_json, result_rolled_back, result_rolled_back_version, occurred_at
+      )
+      SELECT idempotency_key, payload_hash, scope_digest, principal_digest, generation,
+        action, target_preference_key, admission_cursor_epoch, admission_cursor_sequence,
+        result_applied, result_paused, result_control_version, result_admission_high_water,
+        result_ignore_events_through_sequence, result_signals, result_hypotheses,
+        result_active_overlays, result_stored_active_overlays, result_shadow_hypotheses,
+        result_deleted_signals, result_deleted_hypotheses, result_forgotten_through,
+        result_explanation_json, result_rolled_back, result_rolled_back_version, occurred_at
+      FROM preference_owner_control_receipts_v8;
+      DROP TABLE preference_owner_control_receipts_v8;
+      CREATE INDEX preference_owner_control_scope_time
+        ON preference_owner_control_receipts(
+          scope_digest, admission_cursor_epoch, admission_cursor_sequence DESC, idempotency_key
+        );
+      UPDATE preference_schema_meta SET value = '9' WHERE key = 'schema-version';
+      PRAGMA user_version = 9;
+    `);
+        if (current < 10)
+            database.exec(`
+      CREATE TABLE preference_memory_promotions (
+        promotion_id TEXT NOT NULL,
+        promotion_generation INTEGER NOT NULL CHECK (promotion_generation >= 1),
+        scope_key TEXT NOT NULL,
+        scope_digest TEXT NOT NULL CHECK (
+          length(scope_digest) = 64 AND scope_digest NOT GLOB '*[^a-f0-9]*'
+        ),
+        workspace TEXT NOT NULL,
+        preset TEXT NOT NULL,
+        principal_id TEXT NOT NULL,
+        principal_digest TEXT NOT NULL CHECK (
+          length(principal_digest) = 64 AND principal_digest NOT GLOB '*[^a-f0-9]*'
+        ),
+        principal_lineage_id TEXT NOT NULL,
+        principal_lineage_version INTEGER NOT NULL CHECK (principal_lineage_version >= 1),
+        owner_generation INTEGER NOT NULL CHECK (owner_generation >= 1),
+        hypothesis_id TEXT NOT NULL,
+        hypothesis_key TEXT NOT NULL CHECK (hypothesis_key = 'memory.retention'),
+        hypothesis_value TEXT NOT NULL CHECK (hypothesis_value = 'long-term'),
+        hypothesis_version INTEGER NOT NULL CHECK (hypothesis_version >= 1),
+        confidence_bps INTEGER NOT NULL CHECK (confidence_bps BETWEEN 0 AND 10000),
+        contradiction_bps INTEGER NOT NULL CHECK (contradiction_bps BETWEEN 0 AND 10000),
+        supporting_signals INTEGER NOT NULL CHECK (supporting_signals >= 2),
+        distinct_signal_sources INTEGER NOT NULL CHECK (distinct_signal_sources >= 1),
+        evidence_mass INTEGER NOT NULL CHECK (evidence_mass >= 1),
+        renderer_id TEXT NOT NULL CHECK (renderer_id = 'memory.retention.long-term/v1'),
+        observed_at INTEGER NOT NULL CHECK (observed_at >= 0),
+        deadline_at INTEGER NOT NULL CHECK (deadline_at > observed_at),
+        request_digest TEXT NOT NULL UNIQUE CHECK (
+          length(request_digest) = 64 AND request_digest NOT GLOB '*[^a-f0-9]*'
+        ),
+        idempotency_key TEXT NOT NULL UNIQUE,
+        state TEXT NOT NULL CHECK (state IN (
+          'pending', 'submitted', 'confirmed', 'rejected', 'expired',
+          'conflicted', 'stale-owner', 'cancelled'
+        )),
+        memory_proposal_id TEXT,
+        submission_receipt_digest TEXT CHECK (submission_receipt_digest IS NULL OR (
+          length(submission_receipt_digest) = 64
+          AND submission_receipt_digest NOT GLOB '*[^a-f0-9]*'
+        )),
+        terminal_result_version INTEGER CHECK (
+          terminal_result_version IS NULL OR terminal_result_version >= 1
+        ),
+        terminal_receipt_digest TEXT CHECK (terminal_receipt_digest IS NULL OR (
+          length(terminal_receipt_digest) = 64
+          AND terminal_receipt_digest NOT GLOB '*[^a-f0-9]*'
+        )),
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL,
+        PRIMARY KEY (promotion_id, promotion_generation),
+        UNIQUE(scope_key, hypothesis_id, promotion_generation)
+      ) STRICT;
+      CREATE INDEX preference_memory_promotions_scope_state
+        ON preference_memory_promotions(scope_key, state, updated_at, promotion_id);
+      CREATE INDEX preference_memory_promotions_hypothesis
+        ON preference_memory_promotions(hypothesis_id, promotion_generation DESC);
+
+      CREATE TABLE preference_memory_promotion_outbox (
+        promotion_id TEXT NOT NULL,
+        promotion_generation INTEGER NOT NULL CHECK (promotion_generation >= 1),
+        state TEXT NOT NULL CHECK (state IN ('pending', 'retry_wait', 'submitted', 'cancelled')),
+        attempt_count INTEGER NOT NULL CHECK (attempt_count >= 0),
+        next_attempt_at INTEGER NOT NULL CHECK (next_attempt_at >= 0),
+        submitted_at INTEGER,
+        last_error TEXT,
+        updated_at INTEGER NOT NULL,
+        PRIMARY KEY (promotion_id, promotion_generation),
+        FOREIGN KEY (promotion_id, promotion_generation)
+          REFERENCES preference_memory_promotions(promotion_id, promotion_generation)
+          ON DELETE CASCADE
+      ) STRICT;
+      CREATE INDEX preference_memory_promotion_outbox_pending
+        ON preference_memory_promotion_outbox(state, next_attempt_at, updated_at, promotion_id);
+
+      CREATE TABLE preference_memory_promotion_results (
+        promotion_id TEXT NOT NULL,
+        promotion_generation INTEGER NOT NULL CHECK (promotion_generation >= 1),
+        result_version INTEGER NOT NULL CHECK (result_version >= 1),
+        request_digest TEXT NOT NULL CHECK (
+          length(request_digest) = 64 AND request_digest NOT GLOB '*[^a-f0-9]*'
+        ),
+        receipt_digest TEXT NOT NULL UNIQUE CHECK (
+          length(receipt_digest) = 64 AND receipt_digest NOT GLOB '*[^a-f0-9]*'
+        ),
+        status TEXT NOT NULL CHECK (status IN (
+          'confirmed', 'rejected', 'expired', 'conflicted', 'stale-owner'
+        )),
+        rejection_kind TEXT CHECK (rejection_kind IS NULL OR rejection_kind = 'owner-explicit'),
+        memory_proposal_id TEXT,
+        memory_proposal_version INTEGER CHECK (
+          memory_proposal_version IS NULL OR memory_proposal_version >= 1
+        ),
+        memory_record_id TEXT,
+        memory_record_version INTEGER CHECK (
+          memory_record_version IS NULL OR memory_record_version >= 1
+        ),
+        memory_record_digest TEXT CHECK (memory_record_digest IS NULL OR (
+          length(memory_record_digest) = 64
+          AND memory_record_digest NOT GLOB '*[^a-f0-9]*'
+        )),
+        occurred_at INTEGER NOT NULL CHECK (occurred_at >= 0),
+        projected_at INTEGER NOT NULL CHECK (projected_at >= 0),
+        PRIMARY KEY (promotion_id, promotion_generation),
+        FOREIGN KEY (promotion_id, promotion_generation)
+          REFERENCES preference_memory_promotions(promotion_id, promotion_generation)
+          ON DELETE CASCADE,
+        CHECK ((status = 'confirmed'
+          AND memory_proposal_id IS NOT NULL AND memory_proposal_version IS NOT NULL
+          AND memory_record_id IS NOT NULL AND memory_record_version IS NOT NULL
+          AND memory_record_digest IS NOT NULL AND rejection_kind IS NULL)
+          OR (status = 'rejected'
+            AND memory_proposal_id IS NOT NULL AND memory_proposal_version IS NOT NULL
+            AND rejection_kind = 'owner-explicit' AND memory_record_id IS NULL
+            AND memory_record_version IS NULL AND memory_record_digest IS NULL)
+          OR (status IN ('expired', 'conflicted')
+            AND memory_proposal_id IS NOT NULL AND memory_proposal_version IS NOT NULL
+            AND rejection_kind IS NULL AND memory_record_id IS NULL
+            AND memory_record_version IS NULL AND memory_record_digest IS NULL)
+          OR (status = 'stale-owner'
+            AND memory_proposal_id IS NULL AND memory_proposal_version IS NULL
+            AND rejection_kind IS NULL AND memory_record_id IS NULL
+            AND memory_record_version IS NULL AND memory_record_digest IS NULL))
+      ) STRICT;
+
+      -- Privacy-preserving resurrection fence retained after owner rotation or
+      -- forget. It contains only opaque/digested promotion identity.
+      CREATE TABLE preference_memory_promotion_cancellations (
+        promotion_id TEXT NOT NULL,
+        promotion_generation INTEGER NOT NULL CHECK (promotion_generation >= 1),
+        request_digest TEXT NOT NULL CHECK (
+          length(request_digest) = 64 AND request_digest NOT GLOB '*[^a-f0-9]*'
+        ),
+        principal_lineage_id TEXT NOT NULL,
+        principal_lineage_version INTEGER NOT NULL CHECK (principal_lineage_version >= 1),
+        owner_generation INTEGER NOT NULL CHECK (owner_generation >= 1),
+        reason TEXT NOT NULL CHECK (reason IN (
+          'forget', 'owner-rotated', 'superseded'
+        )),
+        cancelled_at INTEGER NOT NULL CHECK (cancelled_at >= 0),
+        cancellation_digest TEXT NOT NULL UNIQUE CHECK (
+          length(cancellation_digest) = 64 AND cancellation_digest NOT GLOB '*[^a-f0-9]*'
+        ),
+        state TEXT NOT NULL CHECK (state IN (
+          'pending', 'retry_wait', 'cancelled', 'already-confirmed'
+        )),
+        attempt_count INTEGER NOT NULL CHECK (attempt_count >= 0),
+        next_attempt_at INTEGER NOT NULL CHECK (next_attempt_at >= 0),
+        receipt_digest TEXT CHECK (receipt_digest IS NULL OR (
+          length(receipt_digest) = 64 AND receipt_digest NOT GLOB '*[^a-f0-9]*'
+        )),
+        last_error TEXT,
+        updated_at INTEGER NOT NULL,
+        PRIMARY KEY (promotion_id, promotion_generation)
+      ) STRICT;
+      CREATE INDEX preference_memory_promotion_cancellations_pending
+        ON preference_memory_promotion_cancellations(state, next_attempt_at, updated_at, promotion_id);
+
+      UPDATE preference_schema_meta SET value = '10' WHERE key = 'schema-version';
+      PRAGMA user_version = 10;
+    `);
+        if (current < 11)
+            database.exec(`
+      UPDATE preference_schema_meta SET value = '11' WHERE key = 'schema-version';
+      PRAGMA user_version = 11;
+    `);
+        if (current < 12) {
+            database.exec(`
+        ALTER TABLE preference_memory_promotion_cancellations
+          ADD COLUMN upgrade_binding_digest TEXT CHECK (
+            upgrade_binding_digest IS NULL OR (
+              length(upgrade_binding_digest) = 64
+              AND upgrade_binding_digest NOT GLOB '*[^a-f0-9]*'
+            )
+          );
+      `);
+            const rows = database.prepare(`
+        SELECT cancellation.promotion_id, cancellation.promotion_generation,
+          cancellation.request_digest, cancellation.principal_lineage_id,
+          cancellation.principal_lineage_version, cancellation.owner_generation,
+          cancellation.reason, cancellation.state, cancellation.receipt_digest,
+          promotion.request_digest AS promotion_request_digest,
+          promotion.principal_lineage_id AS promotion_principal_lineage_id,
+          promotion.principal_lineage_version AS promotion_principal_lineage_version,
+          promotion.owner_generation AS promotion_owner_generation
+        FROM preference_memory_promotion_cancellations cancellation
+        LEFT JOIN preference_memory_promotions promotion
+          ON promotion.promotion_id = cancellation.promotion_id
+          AND promotion.promotion_generation = cancellation.promotion_generation
+      `).all();
+            const update = database.prepare(`
+        UPDATE preference_memory_promotion_cancellations
+        SET upgrade_binding_digest = ?, principal_lineage_id = ?,
+          principal_lineage_version = ?, owner_generation = ?
+        WHERE promotion_id = ? AND promotion_generation = ?
+      `);
+            for (const row of rows) {
+                const redacted = row.receipt_digest !== null
+                    && row.principal_lineage_id.startsWith('redacted-');
+                const hasPromotionBinding = row.promotion_request_digest !== null
+                    && row.promotion_principal_lineage_id !== null
+                    && row.promotion_principal_lineage_version !== null
+                    && row.promotion_owner_generation !== null
+                    && row.promotion_request_digest === row.request_digest;
+                const requiresDelivery = row.state === 'pending' || row.state === 'retry_wait'
+                    || (row.state === 'already-confirmed' && row.reason !== 'superseded');
+                if (redacted && !hasPromotionBinding
+                    && (requiresDelivery || row.reason === 'superseded')) {
+                    throw new PreferenceDatabaseError('unsafe-file', 'legacy promotion cancellation cannot be safely upgraded after owner-lineage redaction');
+                }
+                const binding = hasPromotionBinding ? {
+                    promotionId: row.promotion_id,
+                    promotionGeneration: row.promotion_generation,
+                    requestDigest: row.promotion_request_digest,
+                    principalLineageId: row.promotion_principal_lineage_id,
+                    principalLineageVersion: row.promotion_principal_lineage_version,
+                    ownerGeneration: row.promotion_owner_generation,
+                } : {
+                    promotionId: row.promotion_id,
+                    promotionGeneration: row.promotion_generation,
+                    requestDigest: row.request_digest,
+                    principalLineageId: row.principal_lineage_id,
+                    principalLineageVersion: row.principal_lineage_version,
+                    ownerGeneration: row.owner_generation,
+                };
+                const restoreLineage = redacted
+                    && requiresDelivery
+                    && hasPromotionBinding;
+                update.run(preferencePromotionCancellationUpgradeBindingDigest(binding), restoreLineage ? binding.principalLineageId : row.principal_lineage_id, restoreLineage ? binding.principalLineageVersion : row.principal_lineage_version, restoreLineage ? binding.ownerGeneration : row.owner_generation, row.promotion_id, row.promotion_generation);
+            }
+            database.exec(`
+        ALTER TABLE preference_memory_promotion_cancellations
+          RENAME TO preference_memory_promotion_cancellations_v11;
+        CREATE TABLE preference_memory_promotion_cancellations (
+          promotion_id TEXT NOT NULL,
+          promotion_generation INTEGER NOT NULL CHECK (promotion_generation >= 1),
+          request_digest TEXT NOT NULL CHECK (
+            length(request_digest) = 64 AND request_digest NOT GLOB '*[^a-f0-9]*'
+          ),
+          principal_lineage_id TEXT NOT NULL,
+          principal_lineage_version INTEGER NOT NULL CHECK (principal_lineage_version >= 1),
+          owner_generation INTEGER NOT NULL CHECK (owner_generation >= 1),
+          reason TEXT NOT NULL CHECK (reason IN (
+            'forget', 'owner-rotated', 'superseded'
+          )),
+          cancelled_at INTEGER NOT NULL CHECK (cancelled_at >= 0),
+          cancellation_digest TEXT NOT NULL UNIQUE CHECK (
+            length(cancellation_digest) = 64 AND cancellation_digest NOT GLOB '*[^a-f0-9]*'
+          ),
+          state TEXT NOT NULL CHECK (state IN (
+            'pending', 'retry_wait', 'cancelled', 'already-confirmed'
+          )),
+          attempt_count INTEGER NOT NULL CHECK (attempt_count >= 0),
+          next_attempt_at INTEGER NOT NULL CHECK (next_attempt_at >= 0),
+          receipt_digest TEXT CHECK (receipt_digest IS NULL OR (
+            length(receipt_digest) = 64 AND receipt_digest NOT GLOB '*[^a-f0-9]*'
+          )),
+          last_error TEXT,
+          upgrade_binding_digest TEXT NOT NULL CHECK (
+            length(upgrade_binding_digest) = 64
+            AND upgrade_binding_digest NOT GLOB '*[^a-f0-9]*'
+          ),
+          updated_at INTEGER NOT NULL,
+          PRIMARY KEY (promotion_id, promotion_generation)
+        ) STRICT;
+        INSERT INTO preference_memory_promotion_cancellations(
+          promotion_id, promotion_generation, request_digest, principal_lineage_id,
+          principal_lineage_version, owner_generation, reason, cancelled_at,
+          cancellation_digest, state, attempt_count, next_attempt_at, receipt_digest,
+          last_error, upgrade_binding_digest, updated_at
+        )
+        SELECT promotion_id, promotion_generation, request_digest, principal_lineage_id,
+          principal_lineage_version, owner_generation, reason, cancelled_at,
+          cancellation_digest, state, attempt_count, next_attempt_at, receipt_digest,
+          last_error, upgrade_binding_digest, updated_at
+        FROM preference_memory_promotion_cancellations_v11;
+        DROP TABLE preference_memory_promotion_cancellations_v11;
+        CREATE INDEX preference_memory_promotion_cancellations_pending
+          ON preference_memory_promotion_cancellations(
+            state, next_attempt_at, updated_at, promotion_id
+          );
+        UPDATE preference_memory_promotion_cancellations
+        SET state = 'pending', receipt_digest = NULL, last_error = NULL, next_attempt_at = 0
+        WHERE state = 'already-confirmed' AND reason IN ('forget', 'owner-rotated');
+        UPDATE preference_schema_meta SET value = '12' WHERE key = 'schema-version';
+        PRAGMA user_version = 12;
+      `);
+        }
         database.exec('COMMIT');
         transactionStarted = false;
     }