chore: mark index migrator as experimental across docs, CLI, and module docstring

Author: nkanu17

docs/api/cli.rst

@@ -446,6 +446,10 @@ The command returns the following metrics:
 rvl migrate
 -----------
 
+.. warning::
+
+   The index migrator is an **experimental** feature. APIs, CLI commands, and on-disk formats (plans, checkpoints, backups) may change in future releases. Review migration plans carefully before applying to production indexes.
+
 Manage document-preserving index migrations. This command group provides subcommands for planning, executing, and validating schema migrations that preserve existing data.
 
 **Syntax**

docs/concepts/index-migrations.md

@@ -7,6 +7,10 @@ myst:
 
 # Index Migrations
 
+```{warning}
+The index migrator is an **experimental** feature. APIs, CLI commands, and on-disk formats (plans, checkpoints, backups) may change in future releases. Review migration plans carefully before applying to production indexes.
+```
+
 Redis Search indexes are immutable. To change an index schema, you must drop the existing index and create a new one. RedisVL provides a migration workflow that automates this process while preserving your data.
 
 This page explains how migrations work and which changes are supported. For step by step instructions, see the [migration guide](../user_guide/how_to_guides/migrate-indexes.md).

docs/user_guide/how_to_guides/migrate-indexes.md

@@ -7,6 +7,10 @@ myst:
 
 # Migrate an Index
 
+```{warning}
+The index migrator is an **experimental** feature. APIs, CLI commands, and on-disk formats (plans, checkpoints, backups) may change in future releases. Review migration plans carefully before applying to production indexes.
+```
+
 This guide shows how to safely change your index schema using the RedisVL migrator.
 
 ## Quick Start

redisvl/cli/migrate.py

@@ -50,6 +50,13 @@ class Migrate:
         ]
     )
 
+    _EXPERIMENTAL_BANNER = (
+        "NOTE: The index migrator is an experimental feature. "
+        "APIs, CLI commands, and on-disk formats (plans, checkpoints, backups) "
+        "may change in future releases. "
+        "Review migration plans carefully before applying to production indexes."
+    )
+
     def __init__(self):
         parser = argparse.ArgumentParser(usage=self.usage)
         parser.add_argument("command", help="Subcommand to run")
@@ -61,6 +68,8 @@ def __init__(self):
             parser.print_help()
             sys.exit(1)
 
+        print(f"\n⚠️  {self._EXPERIMENTAL_BANNER}\n")
+
         try:
             getattr(self, command)()
         except Exception as e:

redisvl/migration/__init__.py

@@ -1,3 +1,14 @@
+"""Experimental index migration module.
+
+.. warning::
+
+    This module is **experimental** and may change or be removed in future
+    releases.  APIs, CLI commands, and on-disk formats (plans, checkpoints,
+    backups) are not yet covered by semantic-versioning guarantees.
+    Review the migration plan carefully before applying it to
+    production indexes.
+"""
+
 from redisvl.migration.async_executor import AsyncMigrationExecutor
 from redisvl.migration.async_planner import AsyncMigrationPlanner
 from redisvl.migration.async_validation import AsyncMigrationValidator