>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #3606130. --> Reported by: [abhisekmazumdar](https://www.drupal.org/user/3557964) Related to !10 >>> <h2>Problem/Motivation</h2> <p>The bundled <code>ai_validations</code> submodule inside <code>drupal/ai</code> is marked <code>lifecycle: deprecated</code> but has no automated migration path. Sites upgrading to AI 2.0.0 without first installing the <code>drupal/ai_validations</code> standalone package will have a broken site. <code>core.extension</code> still lists the module but the code is deleted from disk when <code>drupal/ai</code> 2.0.0 is installed.</p> <p>The approach was researched and agreed in <a href="https://git.drupalcode.org/project/ai/-/work_items/3586538">https://git.drupalcode.org/project/ai/-/work_items/3586538</a> on the <code>ai</code> module project.</p> <h2>Proposed resolution</h2> <p>Add <code>modules/ai_validations/ai_validations.install</code> to the <code>drupal/ai</code> module with two functions:</p> <p><strong><code>hook_requirements()</code></strong> fires a <code>REQUIREMENT_WARNING</code> at <code>/admin/reports/status</code> when the bundled copy is active. It includes the exact <code>composer require</code> command the admin needs to run.</p> <p><strong><code>hook_update_10001()</code></strong> is a migration gate that runs when <code>drush updb</code> is called:</p> <ul> <li>Standalone not on disk: throws a retryable <code>\Exception</code> with <code>composer require drupal/ai_validations:@alpha</code> instructions.</li> <li>Standalone on disk: invalidates the container so <code>ExtensionDiscovery</code> loads the standalone on the next request.</li> </ul> <p>Also adds <code>drupal/ai_validations</code> to the <code>suggest</code> key in <code>drupal/ai</code> <code>composer.json</code>.</p> <p><strong>Note:</strong> <code>hook_update_N()</code> for same-machine-name migrations cannot use <code>$installer-&gt;install()</code>. The module is already registered in <code>core.extension</code>. When both copies are on disk, <code>ExtensionDiscovery</code> loads the standalone automatically. See <a href="https://git.drupalcode.org/project/ai/-/work_items/3586538">https://git.drupalcode.org/project/ai/-/work_items/3586538</a> for the full technical findings.</p> <h2>Remaining tasks</h2> <ul> <li>Commit <code>ai_validations.install</code> with <code>hook_requirements()</code> and <code>hook_update_10001()</code></li> <li>Update <code>drupal/ai</code> <code>composer.json</code> suggest</li> <li>Write <code>BundledSubmoduleSwapTestBase</code> abstract Kernel test class</li> <li>Write <code>AiValidationsSwapTest</code> subclass</li> <li>MR passes CI</li> </ul> <h2>User interface changes</h2> <p>A <code>REQUIREMENT_WARNING</code> appears at <code>/admin/reports/status</code> on any site running the bundled copy of <code>ai_validations</code>.</p> <h2>API changes</h2> <p>None.</p> <h2>Data model changes</h2> <p>None.</p> <h2>Related issues</h2> <ul> <li><a href="https://git.drupalcode.org/project/ai/-/work_items/3586538">https://git.drupalcode.org/project/ai/-/work_items/3586538</a> &mdash; Research and agreed mechanism (ai module)</li> <li><span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/ai/-/work_items/3552888" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/ai/-/work_items/3552888</a></span> &mdash; Original move-out issue for ai_validations</li> </ul>