[#3114] Derived the handler processing order and prompt count in 'PromptManager'.

.vortex/CLAUDE.md

@@ -144,7 +144,7 @@ When updating template files (settings, configs, Dockerfiles, etc.):
 
 When the installer prompt flow changes (any change under
 `.vortex/installer/src/Prompts/` - new or removed handler, reordered or reworded
-prompt, `TOTAL_RESPONSES` bump), also run `ahoy update-videos installer` to
+prompt), also run `ahoy update-videos installer` to
 re-record the demo, since the video records the live prompt flow.
 `update-snapshots` commits automatically; `update-videos` does not - stage and
 commit its output manually. Run both after the code change is committed.

.vortex/installer/CLAUDE.md

@@ -65,8 +65,8 @@ permission before running.
 Triggers that require re-recording:
 - New `Handlers/*.php` class or handler removal.
 - Wording change to `label()` or `hint()` of any existing handler.
-- Reordering prompts inside `PromptManager::runPrompts()`.
-- Change to `TOTAL_RESPONSES` constant.
+- Adding, removing or reordering prompts inside `PromptManager::runPrompts()`,
+  which also moves the progress denominator.
 
 ## Conditional Token System
 
@@ -130,6 +130,18 @@ Content removed if feature not selected
 
 ## Handler Development
 
+### Ordering
+
+`PromptManager::runPrompts()` is the catalogue of prompts: the `form()` chain
+lists every prompt, in order, under its section heading. Add a new prompt
+there, and the progress denominator follows automatically.
+
+Processing runs in a different order, so each handler declares its own
+`processWeight()` - lowest first, broadly the reverse of the prompt order so
+that string replacements process more specific values before more generic
+ones. It is declared on `HandlerInterface` with no default, so a new handler
+does not compile until it states where it processes.
+
 ### Key Pattern
 
 Handlers **queue** operations, PromptManager **executes**:

.vortex/installer/src/Prompts/Handlers/AiCodeInstructions.php

@@ -8,6 +8,13 @@
 
 class AiCodeInstructions extends AbstractHandler {
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 30;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/AssignAuthorPr.php

@@ -8,6 +8,13 @@
 
 class AssignAuthorPr extends AbstractHandler {
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 60;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/CiProvider.php

@@ -14,6 +14,13 @@ class CiProvider extends AbstractHandler {
 
   const CIRCLECI = 'circleci';
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 110;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/CodeCoverageProvider.php

@@ -12,6 +12,13 @@ class CodeCoverageProvider extends AbstractHandler {
 
   const CODECOV = 'codecov';
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 70;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/CodeProvider.php

@@ -12,6 +12,13 @@ class CodeProvider extends AbstractHandler {
 
   const OTHER = 'other';
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 250;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/CustomModules.php

@@ -15,6 +15,13 @@ class CustomModules extends AbstractHandler {
 
   const SEARCH = 'search';
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 320;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/DatabaseFetchSource.php

@@ -23,6 +23,13 @@ class DatabaseFetchSource extends AbstractHandler {
 
   const NONE = 'none';
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 160;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/DatabaseImage.php

@@ -10,6 +10,13 @@
 
 class DatabaseImage extends AbstractHandler {
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 150;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/DependencyUpdatesProvider.php

@@ -14,6 +14,13 @@ class DependencyUpdatesProvider extends AbstractHandler {
 
   const RENOVATEBOT_APP = 'renovatebot_app';
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 80;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/DeployTypes.php

@@ -16,6 +16,13 @@ class DeployTypes extends AbstractHandler {
 
   const WEBHOOK = 'webhook';
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 190;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/Domain.php

@@ -11,6 +11,13 @@
 
 class Domain extends AbstractHandler {
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 300;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/Dotenv.php

@@ -8,6 +8,13 @@
 
 class Dotenv extends AbstractHandler {
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 10;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/FrontendBuild.php

@@ -15,6 +15,13 @@
  */
 class FrontendBuild extends AbstractHandler {
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 340;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/Gitleaks.php

@@ -15,6 +15,13 @@
  */
 class Gitleaks extends AbstractHandler {
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 90;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/HandlerInterface.php

@@ -34,6 +34,18 @@ public static function id(): string;
    */
   public static function envName(): string;
 
+  /**
+   * Get the position of this handler in the processing chain.
+   *
+   * Handlers are processed from the lowest weight up, broadly in reverse of
+   * the order they are prompted in, so that string replacements process more
+   * specific values before more generic ones.
+   *
+   * @return int
+   *   The weight.
+   */
+  public static function processWeight(): int;
+
   /**
    * Get the prompt type for this handler.
    *

.vortex/installer/src/Prompts/Handlers/HostingProjectName.php

@@ -10,6 +10,13 @@
 
 class HostingProjectName extends AbstractHandler {
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 310;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/HostingProvider.php

@@ -18,6 +18,13 @@ class HostingProvider extends AbstractHandler {
 
   const OTHER = 'other';
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 200;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/Internal.php

@@ -14,6 +14,13 @@
 
 class Internal extends AbstractHandler {
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 410;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/LabelMergeConflictsPr.php

@@ -8,6 +8,13 @@
 
 class LabelMergeConflictsPr extends AbstractHandler {
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 50;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/MachineName.php

@@ -11,6 +11,13 @@
 
 class MachineName extends AbstractHandler {
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 380;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/Migration.php

@@ -10,6 +10,13 @@
 
 class Migration extends AbstractHandler {
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 140;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/MigrationFetchSource.php

@@ -21,6 +21,13 @@ class MigrationFetchSource extends AbstractHandler {
 
   const S3 = 's3';
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 130;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/MigrationImage.php

@@ -10,6 +10,13 @@
 
 class MigrationImage extends AbstractHandler {
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 120;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/ModulePrefix.php

@@ -9,6 +9,13 @@
 
 class ModulePrefix extends AbstractHandler {
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 330;
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/Modules.php

@@ -24,6 +24,13 @@ class Modules extends AbstractHandler {
    */
   protected const DEV_MODULES = ['devel', 'sdc_devel', 'generated_content', 'testmode', 'reroute_email'];
 
+  /**
+   * {@inheritdoc}
+   */
+  public static function processWeight(): int {
+    return 260;
+  }
+
   /**
    * {@inheritdoc}
    */