@omnizap-system/omnizap 2.6.1 → 2.6.2

package/database/migrations/20260412_d36_system_config_tables_down.sql

@@ -0,0 +1,32 @@
+-- D+36 rollback
+
+SET @migration_key := '20260412_d36_system_config_tables';
+
+INSERT INTO `group_configs` (`id`, `config`, `updated_at`)
+SELECT
+  'system:premium_users' AS `id`,
+  JSON_OBJECT('premiumUsers', COALESCE(JSON_ARRAYAGG(`id`), JSON_ARRAY())) AS `config`,
+  CURRENT_TIMESTAMP AS `updated_at`
+FROM `system_premium_users`
+ON DUPLICATE KEY UPDATE
+  `config` = VALUES(`config`),
+  `updated_at` = CURRENT_TIMESTAMP;
+
+INSERT INTO `group_configs` (`id`, `config`, `updated_at`)
+SELECT
+  'system:ai_prompts' AS `id`,
+  JSON_OBJECT('prompts', COALESCE(JSON_OBJECTAGG(`id`, `prompt`), JSON_OBJECT())) AS `config`,
+  CURRENT_TIMESTAMP AS `updated_at`
+FROM `system_ai_prompts`
+ON DUPLICATE KEY UPDATE
+  `config` = VALUES(`config`),
+  `updated_at` = CURRENT_TIMESTAMP;
+
+DROP TABLE IF EXISTS `system_ai_prompts`;
+DROP TABLE IF EXISTS `system_premium_users`;
+
+UPDATE schema_change_log
+   SET status = 'rolled_back',
+       notes = 'D+36 rollback executed',
+       updated_at = CURRENT_TIMESTAMP
+ WHERE migration_key = @migration_key;

package/database/migrations/20260412_d36_system_config_tables_up.sql

@@ -0,0 +1,66 @@
+-- D+36 (2026-04-12) - Split system config records from group_configs
+-- Scope: move `system:premium_users` and `system:ai_prompts` to dedicated tables
+
+SET @migration_key := '20260412_d36_system_config_tables';
+
+CREATE TABLE IF NOT EXISTS `system_premium_users` (
+  `id` varchar(255) NOT NULL,
+  `created_at` timestamp NULL DEFAULT current_timestamp(),
+  `updated_at` timestamp NULL DEFAULT current_timestamp() ON UPDATE current_timestamp(),
+  PRIMARY KEY (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+CREATE TABLE IF NOT EXISTS `system_ai_prompts` (
+  `id` varchar(255) NOT NULL,
+  `prompt` longtext NOT NULL,
+  `created_at` timestamp NULL DEFAULT current_timestamp(),
+  `updated_at` timestamp NULL DEFAULT current_timestamp() ON UPDATE current_timestamp(),
+  PRIMARY KEY (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+INSERT INTO `system_premium_users` (`id`)
+SELECT DISTINCT jt.premium_jid
+  FROM `group_configs` gc
+  JOIN JSON_TABLE(
+    COALESCE(JSON_EXTRACT(gc.config, '$.premiumUsers'), JSON_ARRAY()),
+    '$[*]' COLUMNS (`premium_jid` VARCHAR(255) PATH '$')
+  ) jt
+ WHERE gc.id = 'system:premium_users'
+   AND jt.premium_jid IS NOT NULL
+   AND TRIM(jt.premium_jid) <> ''
+ON DUPLICATE KEY UPDATE
+  `updated_at` = CURRENT_TIMESTAMP;
+
+INSERT INTO `system_ai_prompts` (`id`, `prompt`)
+SELECT jt.prompt_jid,
+       COALESCE(
+         JSON_UNQUOTE(
+           JSON_EXTRACT(
+             JSON_EXTRACT(gc.config, '$.prompts'),
+             CONCAT('$."', REPLACE(jt.prompt_jid, '"', '\\"'), '"')
+           )
+         ),
+         ''
+       ) AS prompt_text
+  FROM `group_configs` gc
+  JOIN JSON_TABLE(
+    JSON_KEYS(COALESCE(JSON_EXTRACT(gc.config, '$.prompts'), JSON_OBJECT())),
+    '$[*]' COLUMNS (`prompt_jid` VARCHAR(255) PATH '$')
+  ) jt
+ WHERE gc.id = 'system:ai_prompts'
+   AND jt.prompt_jid IS NOT NULL
+   AND TRIM(jt.prompt_jid) <> ''
+ON DUPLICATE KEY UPDATE
+  `prompt` = VALUES(`prompt`),
+  `updated_at` = CURRENT_TIMESTAMP;
+
+DELETE FROM `group_configs`
+ WHERE id IN ('system:premium_users', 'system:ai_prompts');
+
+INSERT INTO schema_change_log (migration_key, phase, status, notes)
+VALUES (@migration_key, 'D+36', 'applied', 'split system:premium_users and system:ai_prompts into dedicated tables')
+ON DUPLICATE KEY UPDATE
+  phase = VALUES(phase),
+  status = 'applied',
+  notes = VALUES(notes),
+  updated_at = CURRENT_TIMESTAMP;

package/database/migrations/20260413_d37_group_user_warnings_down.sql

@@ -0,0 +1,11 @@
+-- D+37 rollback
+
+SET @migration_key := '20260413_d37_group_user_warnings';
+
+DROP TABLE IF EXISTS `group_user_warnings`;
+
+UPDATE schema_change_log
+   SET status = 'rolled_back',
+       notes = 'D+37 rollback executed',
+       updated_at = CURRENT_TIMESTAMP
+ WHERE migration_key = @migration_key;

package/database/migrations/20260413_d37_group_user_warnings_up.sql

@@ -0,0 +1,24 @@
+-- D+37 (2026-04-13) - Group moderation warnings
+-- Scope: track warnings per participant inside each group
+
+SET @migration_key := '20260413_d37_group_user_warnings';
+
+CREATE TABLE IF NOT EXISTS `group_user_warnings` (
+  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
+  `group_id` varchar(255) NOT NULL,
+  `participant_jid` varchar(255) NOT NULL,
+  `warned_by_jid` varchar(255) DEFAULT NULL,
+  `reason` text DEFAULT NULL,
+  `created_at` timestamp NULL DEFAULT current_timestamp(),
+  PRIMARY KEY (`id`),
+  KEY `idx_group_user_warnings_lookup` (`group_id`,`participant_jid`,`created_at`),
+  KEY `idx_group_user_warnings_prune` (`group_id`,`participant_jid`,`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+INSERT INTO schema_change_log (migration_key, phase, status, notes)
+VALUES (@migration_key, 'D+37', 'applied', 'created group_user_warnings table for moderation warnings')
+ON DUPLICATE KEY UPDATE
+  phase = VALUES(phase),
+  status = 'applied',
+  notes = VALUES(notes),
+  updated_at = CURRENT_TIMESTAMP;

package/database/migrations/20260414_d38_multi_session_foundation_down.sql

@@ -0,0 +1,72 @@
+-- D+38 rollback
+
+SET @migration_key := '20260414_d38_multi_session_foundation';
+
+DROP PROCEDURE IF EXISTS __drop_column_if_exists;
+DROP PROCEDURE IF EXISTS __drop_index_if_exists;
+
+DELIMITER $$
+CREATE PROCEDURE __drop_column_if_exists(IN p_table_name VARCHAR(64), IN p_column_name VARCHAR(64))
+BEGIN
+  IF EXISTS (
+    SELECT 1
+      FROM information_schema.columns
+     WHERE table_schema = DATABASE()
+       AND table_name = p_table_name
+       AND column_name = p_column_name
+  ) THEN
+    SET @ddl = CONCAT('ALTER TABLE `', p_table_name, '` DROP COLUMN `', p_column_name, '`');
+    PREPARE stmt FROM @ddl;
+    EXECUTE stmt;
+    DEALLOCATE PREPARE stmt;
+  END IF;
+END$$
+
+CREATE PROCEDURE __drop_index_if_exists(IN p_table_name VARCHAR(64), IN p_index_name VARCHAR(64))
+BEGIN
+  IF EXISTS (
+    SELECT 1
+      FROM information_schema.statistics
+     WHERE table_schema = DATABASE()
+       AND table_name = p_table_name
+       AND index_name = p_index_name
+  ) THEN
+    SET @ddl = CONCAT('ALTER TABLE `', p_table_name, '` DROP INDEX `', p_index_name, '`');
+    PREPARE stmt FROM @ddl;
+    EXECUTE stmt;
+    DEALLOCATE PREPARE stmt;
+  END IF;
+END$$
+DELIMITER ;
+
+CALL __drop_index_if_exists('message_analysis_event', 'idx_message_analysis_session_command_created');
+CALL __drop_index_if_exists('message_analysis_event', 'idx_message_analysis_session_sender_created');
+CALL __drop_index_if_exists('message_analysis_event', 'idx_message_analysis_session_chat_created');
+CALL __drop_index_if_exists('message_analysis_event', 'idx_message_analysis_session_created');
+
+CALL __drop_index_if_exists('baileys_event_journal', 'idx_baileys_event_session_message_created');
+CALL __drop_index_if_exists('baileys_event_journal', 'idx_baileys_event_session_chat_created');
+CALL __drop_index_if_exists('baileys_event_journal', 'idx_baileys_event_session_name_created');
+CALL __drop_index_if_exists('baileys_event_journal', 'idx_baileys_event_session_created');
+
+CALL __drop_index_if_exists('messages', 'idx_messages_session_canonical_sender_timestamp');
+CALL __drop_index_if_exists('messages', 'idx_messages_session_sender_timestamp');
+CALL __drop_index_if_exists('messages', 'idx_messages_session_chat_timestamp');
+CALL __drop_index_if_exists('messages', 'idx_messages_session_message_id');
+
+CALL __drop_column_if_exists('message_analysis_event', 'session_id');
+CALL __drop_column_if_exists('baileys_event_journal', 'session_id');
+CALL __drop_column_if_exists('messages', 'session_id');
+
+DROP TABLE IF EXISTS `group_assignment_history`;
+DROP TABLE IF EXISTS `group_assignment`;
+DROP TABLE IF EXISTS `wa_session_registry`;
+
+UPDATE schema_change_log
+   SET status = 'rolled_back',
+       notes = 'D+38 rollback executed',
+       updated_at = CURRENT_TIMESTAMP
+ WHERE migration_key = @migration_key;
+
+DROP PROCEDURE IF EXISTS __drop_column_if_exists;
+DROP PROCEDURE IF EXISTS __drop_index_if_exists;

package/database/migrations/20260414_d38_multi_session_foundation_up.sql

@@ -0,0 +1,125 @@
+-- D+38 (2026-04-14) - Multi-session foundation
+-- Scope:
+-- 1) add group ownership/session registry tables
+-- 2) add session_id scoping columns to high-traffic WhatsApp tables
+-- 3) add session-aware composite indexes
+
+SET @migration_key := '20260414_d38_multi_session_foundation';
+
+DROP PROCEDURE IF EXISTS __ensure_column;
+DROP PROCEDURE IF EXISTS __ensure_index;
+
+DELIMITER $$
+CREATE PROCEDURE __ensure_column(IN p_table_name VARCHAR(64), IN p_column_name VARCHAR(64), IN p_ddl TEXT)
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1
+      FROM information_schema.columns
+     WHERE table_schema = DATABASE()
+       AND table_name = p_table_name
+       AND column_name = p_column_name
+  ) THEN
+    SET @ddl = p_ddl;
+    PREPARE stmt FROM @ddl;
+    EXECUTE stmt;
+    DEALLOCATE PREPARE stmt;
+  END IF;
+END$$
+
+CREATE PROCEDURE __ensure_index(IN p_table_name VARCHAR(64), IN p_index_name VARCHAR(64), IN p_ddl TEXT)
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1
+      FROM information_schema.statistics
+     WHERE table_schema = DATABASE()
+       AND table_name = p_table_name
+       AND index_name = p_index_name
+  ) THEN
+    SET @ddl = p_ddl;
+    PREPARE stmt FROM @ddl;
+    EXECUTE stmt;
+    DEALLOCATE PREPARE stmt;
+  END IF;
+END$$
+DELIMITER ;
+
+CREATE TABLE IF NOT EXISTS `wa_session_registry` (
+  `session_id` varchar(64) NOT NULL,
+  `bot_jid` varchar(255) DEFAULT NULL,
+  `status` varchar(24) NOT NULL DEFAULT 'offline',
+  `capacity_weight` int(10) unsigned NOT NULL DEFAULT 1,
+  `current_score` decimal(12,4) NOT NULL DEFAULT 0.0000,
+  `last_heartbeat_at` datetime DEFAULT NULL,
+  `last_connected_at` datetime DEFAULT NULL,
+  `last_disconnected_at` datetime DEFAULT NULL,
+  `metadata` longtext CHARACTER SET utf8mb4 COLLATE utf8mb4_bin DEFAULT NULL CHECK (json_valid(`metadata`)),
+  `created_at` timestamp NOT NULL DEFAULT current_timestamp(),
+  `updated_at` timestamp NOT NULL DEFAULT current_timestamp() ON UPDATE current_timestamp(),
+  PRIMARY KEY (`session_id`),
+  KEY `idx_wa_session_registry_status_updated` (`status`,`updated_at`),
+  KEY `idx_wa_session_registry_heartbeat` (`last_heartbeat_at`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+CREATE TABLE IF NOT EXISTS `group_assignment` (
+  `group_jid` varchar(255) NOT NULL,
+  `owner_session_id` varchar(64) NOT NULL,
+  `lease_expires_at` datetime NOT NULL,
+  `cooldown_until` datetime DEFAULT NULL,
+  `assignment_version` bigint(20) unsigned NOT NULL DEFAULT 1,
+  `pinned` tinyint(1) NOT NULL DEFAULT 0,
+  `last_reason` varchar(64) DEFAULT NULL,
+  `created_at` timestamp NOT NULL DEFAULT current_timestamp(),
+  `updated_at` timestamp NOT NULL DEFAULT current_timestamp() ON UPDATE current_timestamp(),
+  PRIMARY KEY (`group_jid`),
+  KEY `idx_group_assignment_owner_lease` (`owner_session_id`,`lease_expires_at`),
+  KEY `idx_group_assignment_lease` (`lease_expires_at`),
+  KEY `idx_group_assignment_cooldown` (`cooldown_until`),
+  KEY `idx_group_assignment_pinned_updated` (`pinned`,`updated_at`),
+  CONSTRAINT `fk_group_assignment_owner_session` FOREIGN KEY (`owner_session_id`) REFERENCES `wa_session_registry` (`session_id`) ON UPDATE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+CREATE TABLE IF NOT EXISTS `group_assignment_history` (
+  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
+  `group_jid` varchar(255) NOT NULL,
+  `previous_session_id` varchar(64) DEFAULT NULL,
+  `new_session_id` varchar(64) NOT NULL,
+  `change_reason` varchar(64) DEFAULT NULL,
+  `changed_by` varchar(64) NOT NULL DEFAULT 'system',
+  `assignment_version` bigint(20) unsigned NOT NULL,
+  `metadata` longtext CHARACTER SET utf8mb4 COLLATE utf8mb4_bin DEFAULT NULL CHECK (json_valid(`metadata`)),
+  `created_at` timestamp NOT NULL DEFAULT current_timestamp(),
+  PRIMARY KEY (`id`),
+  KEY `idx_group_assignment_history_group_created` (`group_jid`,`created_at`),
+  KEY `idx_group_assignment_history_new_session_created` (`new_session_id`,`created_at`),
+  KEY `idx_group_assignment_history_prev_session_created` (`previous_session_id`,`created_at`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+CALL __ensure_column('messages', 'session_id', 'ALTER TABLE messages ADD COLUMN session_id VARCHAR(64) NOT NULL DEFAULT ''default'' AFTER message_id');
+CALL __ensure_column('baileys_event_journal', 'session_id', 'ALTER TABLE baileys_event_journal ADD COLUMN session_id VARCHAR(64) NOT NULL DEFAULT ''default'' AFTER id');
+CALL __ensure_column('message_analysis_event', 'session_id', 'ALTER TABLE message_analysis_event ADD COLUMN session_id VARCHAR(64) NOT NULL DEFAULT ''default'' AFTER id');
+
+CALL __ensure_index('messages', 'idx_messages_session_message_id', 'CREATE INDEX idx_messages_session_message_id ON messages (session_id, message_id)');
+CALL __ensure_index('messages', 'idx_messages_session_chat_timestamp', 'CREATE INDEX idx_messages_session_chat_timestamp ON messages (session_id, chat_id, timestamp)');
+CALL __ensure_index('messages', 'idx_messages_session_sender_timestamp', 'CREATE INDEX idx_messages_session_sender_timestamp ON messages (session_id, sender_id, timestamp)');
+CALL __ensure_index('messages', 'idx_messages_session_canonical_sender_timestamp', 'CREATE INDEX idx_messages_session_canonical_sender_timestamp ON messages (session_id, canonical_sender_id, timestamp)');
+
+CALL __ensure_index('baileys_event_journal', 'idx_baileys_event_session_created', 'CREATE INDEX idx_baileys_event_session_created ON baileys_event_journal (session_id, created_at)');
+CALL __ensure_index('baileys_event_journal', 'idx_baileys_event_session_name_created', 'CREATE INDEX idx_baileys_event_session_name_created ON baileys_event_journal (session_id, event_name, created_at)');
+CALL __ensure_index('baileys_event_journal', 'idx_baileys_event_session_chat_created', 'CREATE INDEX idx_baileys_event_session_chat_created ON baileys_event_journal (session_id, chat_id, created_at)');
+CALL __ensure_index('baileys_event_journal', 'idx_baileys_event_session_message_created', 'CREATE INDEX idx_baileys_event_session_message_created ON baileys_event_journal (session_id, message_id, created_at)');
+
+CALL __ensure_index('message_analysis_event', 'idx_message_analysis_session_created', 'CREATE INDEX idx_message_analysis_session_created ON message_analysis_event (session_id, created_at)');
+CALL __ensure_index('message_analysis_event', 'idx_message_analysis_session_chat_created', 'CREATE INDEX idx_message_analysis_session_chat_created ON message_analysis_event (session_id, chat_id, created_at)');
+CALL __ensure_index('message_analysis_event', 'idx_message_analysis_session_sender_created', 'CREATE INDEX idx_message_analysis_session_sender_created ON message_analysis_event (session_id, sender_id, created_at)');
+CALL __ensure_index('message_analysis_event', 'idx_message_analysis_session_command_created', 'CREATE INDEX idx_message_analysis_session_command_created ON message_analysis_event (session_id, command_name, created_at)');
+
+INSERT INTO schema_change_log (migration_key, phase, status, notes)
+VALUES (@migration_key, 'D+38', 'applied', 'multi-session foundation tables and session-scoped indexes')
+ON DUPLICATE KEY UPDATE
+  phase = VALUES(phase),
+  status = 'applied',
+  notes = VALUES(notes),
+  updated_at = CURRENT_TIMESTAMP;
+
+DROP PROCEDURE IF EXISTS __ensure_column;
+DROP PROCEDURE IF EXISTS __ensure_index;

package/database/migrations/20260414_d39_multi_session_cutover_down.sql

@@ -0,0 +1,103 @@
+-- D+39 rollback
+
+SET @migration_key := '20260414_d39_multi_session_cutover';
+
+DROP PROCEDURE IF EXISTS __drop_index_if_exists;
+DROP PROCEDURE IF EXISTS __ensure_unique_index;
+DROP PROCEDURE IF EXISTS __ensure_index;
+DROP PROCEDURE IF EXISTS __assert_no_global_message_duplicates;
+
+DELIMITER $$
+CREATE PROCEDURE __drop_index_if_exists(IN p_table_name VARCHAR(64), IN p_index_name VARCHAR(64))
+BEGIN
+  IF EXISTS (
+    SELECT 1
+      FROM information_schema.statistics
+     WHERE table_schema = DATABASE()
+       AND table_name = p_table_name
+       AND index_name = p_index_name
+  ) THEN
+    SET @ddl = CONCAT('ALTER TABLE `', p_table_name, '` DROP INDEX `', p_index_name, '`');
+    PREPARE stmt FROM @ddl;
+    EXECUTE stmt;
+    DEALLOCATE PREPARE stmt;
+  END IF;
+END$$
+
+CREATE PROCEDURE __ensure_unique_index(IN p_table_name VARCHAR(64), IN p_index_name VARCHAR(64), IN p_ddl TEXT)
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1
+      FROM information_schema.statistics
+     WHERE table_schema = DATABASE()
+       AND table_name = p_table_name
+       AND index_name = p_index_name
+       AND non_unique = 0
+  ) THEN
+    SET @ddl = p_ddl;
+    PREPARE stmt FROM @ddl;
+    EXECUTE stmt;
+    DEALLOCATE PREPARE stmt;
+  END IF;
+END$$
+
+CREATE PROCEDURE __ensure_index(IN p_table_name VARCHAR(64), IN p_index_name VARCHAR(64), IN p_ddl TEXT)
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1
+      FROM information_schema.statistics
+     WHERE table_schema = DATABASE()
+       AND table_name = p_table_name
+       AND index_name = p_index_name
+  ) THEN
+    SET @ddl = p_ddl;
+    PREPARE stmt FROM @ddl;
+    EXECUTE stmt;
+    DEALLOCATE PREPARE stmt;
+  END IF;
+END$$
+
+CREATE PROCEDURE __assert_no_global_message_duplicates()
+BEGIN
+  DECLARE v_dup_exists INT DEFAULT 0;
+
+  SELECT
+    CASE
+      WHEN EXISTS (
+        SELECT 1
+          FROM messages
+         GROUP BY message_id
+        HAVING COUNT(*) > 1
+         LIMIT 1
+      ) THEN 1
+      ELSE 0
+    END
+    INTO v_dup_exists;
+
+  IF v_dup_exists = 1 THEN
+    SIGNAL SQLSTATE '45000'
+      SET MESSAGE_TEXT = 'Rollback D+39 bloqueado: existem message_id duplicados entre sessoes.';
+  END IF;
+END$$
+DELIMITER ;
+
+CALL __assert_no_global_message_duplicates();
+
+CALL __drop_index_if_exists('messages', 'uq_messages_session_message_id');
+
+-- Retorna ao estado da fase D+38:
+-- 1) índice único global em message_id
+-- 2) índice não-único de apoio em (session_id, message_id)
+CALL __ensure_unique_index('messages', 'message_id', 'CREATE UNIQUE INDEX message_id ON messages (message_id)');
+CALL __ensure_index('messages', 'idx_messages_session_message_id', 'CREATE INDEX idx_messages_session_message_id ON messages (session_id, message_id)');
+
+UPDATE schema_change_log
+   SET status = 'rolled_back',
+       notes = 'D+39 rollback executed',
+       updated_at = CURRENT_TIMESTAMP
+ WHERE migration_key = @migration_key;
+
+DROP PROCEDURE IF EXISTS __drop_index_if_exists;
+DROP PROCEDURE IF EXISTS __ensure_unique_index;
+DROP PROCEDURE IF EXISTS __ensure_index;
+DROP PROCEDURE IF EXISTS __assert_no_global_message_duplicates;

package/database/migrations/20260414_d39_multi_session_cutover_up.sql

@@ -0,0 +1,83 @@
+-- D+39 (2026-04-14) - Multi-session message uniqueness cutover
+-- Scope: replace global unique(message_id) with unique(session_id, message_id)
+
+SET @migration_key := '20260414_d39_multi_session_cutover';
+
+DROP PROCEDURE IF EXISTS __assert_column_exists;
+DROP PROCEDURE IF EXISTS __drop_index_if_exists;
+DROP PROCEDURE IF EXISTS __ensure_unique_index;
+
+DELIMITER $$
+CREATE PROCEDURE __assert_column_exists(IN p_table_name VARCHAR(64), IN p_column_name VARCHAR(64))
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1
+      FROM information_schema.columns
+     WHERE table_schema = DATABASE()
+       AND table_name = p_table_name
+       AND column_name = p_column_name
+  ) THEN
+    SIGNAL SQLSTATE '45000' SET MESSAGE_TEXT = 'D+39 requer coluna session_id previamente criada (execute D+38 antes).';
+  END IF;
+END$$
+
+CREATE PROCEDURE __drop_index_if_exists(IN p_table_name VARCHAR(64), IN p_index_name VARCHAR(64))
+BEGIN
+  IF EXISTS (
+    SELECT 1
+      FROM information_schema.statistics
+     WHERE table_schema = DATABASE()
+       AND table_name = p_table_name
+       AND index_name = p_index_name
+  ) THEN
+    SET @ddl = CONCAT('ALTER TABLE `', p_table_name, '` DROP INDEX `', p_index_name, '`');
+    PREPARE stmt FROM @ddl;
+    EXECUTE stmt;
+    DEALLOCATE PREPARE stmt;
+  END IF;
+END$$
+
+CREATE PROCEDURE __ensure_unique_index(IN p_table_name VARCHAR(64), IN p_index_name VARCHAR(64), IN p_ddl TEXT)
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1
+      FROM information_schema.statistics
+     WHERE table_schema = DATABASE()
+       AND table_name = p_table_name
+       AND index_name = p_index_name
+       AND non_unique = 0
+  ) THEN
+    SET @ddl = p_ddl;
+    PREPARE stmt FROM @ddl;
+    EXECUTE stmt;
+    DEALLOCATE PREPARE stmt;
+  END IF;
+END$$
+DELIMITER ;
+
+CALL __assert_column_exists('messages', 'session_id');
+
+-- Remove índice legado global e índice não-único redundante da fase D+38.
+CALL __drop_index_if_exists('messages', 'message_id');
+CALL __drop_index_if_exists('messages', 'uq_messages_message_id');
+CALL __drop_index_if_exists('messages', 'uniq_messages_message_id');
+CALL __drop_index_if_exists('messages', 'idx_messages_session_message_id');
+
+-- Novo contrato de unicidade por sessão.
+CALL __ensure_unique_index(
+  'messages',
+  'uq_messages_session_message_id',
+  'CREATE UNIQUE INDEX uq_messages_session_message_id ON messages (session_id, message_id)'
+);
+
+INSERT INTO schema_change_log (migration_key, phase, status, notes)
+VALUES (@migration_key, 'D+39', 'applied', 'messages uniqueness changed to (session_id, message_id)')
+ON DUPLICATE KEY UPDATE
+  phase = VALUES(phase),
+  status = 'applied',
+  notes = VALUES(notes),
+  updated_at = CURRENT_TIMESTAMP;
+
+DROP PROCEDURE IF EXISTS __assert_column_exists;
+DROP PROCEDURE IF EXISTS __drop_index_if_exists;
+DROP PROCEDURE IF EXISTS __ensure_unique_index;