fix(#148): improve interactive validation for nova init prompts

- Implement immediate inline validation for invalid module names during interactive flow.
- Update prompt behavior to retry on validation failure before proceeding.
- Enhance documentation to reflect new validation behavior.

Author: stiwicourage

CHANGELOG.md

@@ -46,6 +46,10 @@ Keep stable `Update-NovaModuleVersion` / `% nova bump` releases on the SemVer ma
 - Fix the repository `run.ps1` quality loop after the CI installer refactor introduced new ScriptAnalyzer warnings.
     - The internal CI installer helper now follows ScriptAnalyzer naming and `ShouldProcess` expectations.
     - `run.ps1` no longer stops in the analyzer step because of those helper warnings.
+- Fix interactive `nova init` / `nova init -e` scaffold validation so invalid answers retry immediately at the prompt.
+    - Invalid module names now show the validation message inline instead of failing after the full questionnaire.
+    - Standard and example scaffold flows now share the same retry-first validation behavior through the common prompt
+      path.
 
 ### Security
 

docs/NovaModuleTools/en-US/Initialize-NovaModule.md

@@ -30,6 +30,9 @@ PS> Initialize-NovaModule [-Path <string>] [-Example] [-WhatIf] [-Confirm] [<Com
 The command collects project details interactively, including the module name, description, version, author, minimum
 PowerShell version, Git initialization, and, for the standard scaffold, optional basic Pester support.
 
+If you enter an invalid answer during the interactive flow, `Initialize-NovaModule` reports the validation problem
+immediately and retries that prompt before it continues to the next question.
+
 Use this command when you want to start a new module in the NovaModuleTools structure without hand-creating the project
 layout.
 
@@ -38,7 +41,8 @@ supported.
 
 Use `-Example` when you want the scaffold to start from the packaged example project instead of the minimal default
 layout. The example flow keeps the example source, resource, and test files, skips the Pester enable/disable question,
-and applies the interactive metadata values to the copied `project.json`.
+and applies the interactive metadata values to the copied `project.json`. The standard and example flows share the same
+inline validation and retry behavior for interactive answers.
 
 This command supports `-WhatIf` and `-Confirm` through PowerShell `SupportsShouldProcess`. Use `-WhatIf` to preview the
 scaffold target after the interactive answers have been collected, without creating folders, writing `project.json`, or
@@ -53,6 +57,7 @@ PS> Initialize-NovaModule -Path ~/Work
 ```
 
 Starts the interactive scaffold flow and creates the new module under `~/Work`.
+Invalid interactive answers are retried immediately before the command continues.
 
 ### EXAMPLE 2
 
@@ -70,6 +75,7 @@ PS> Initialize-NovaModule -Example -Path ~/Work
 
 Creates a new project under `~/Work` from the packaged example template and applies the answers from the interactive
 prompt flow to the copied `project.json`.
+Invalid interactive answers are retried immediately here as well.
 
 ### EXAMPLE 4
 

src/private/cli/GetAwesomePromptFieldDescription.ps1

@@ -0,0 +1,15 @@
+function Get-AwesomePromptFieldDescription {
+    param([Parameter(Mandatory)][object]$Ask)
+
+    $fieldDescription = [System.Management.Automation.Host.FieldDescription]::new(
+            (Get-AwesomePromptValue -Ask $Ask -Name 'Prompt')
+    )
+    $defaultValue = Get-AwesomePromptValue -Ask $Ask -Name 'Default'
+    if ($defaultValue -ne 'MANDATORY') {
+        $fieldDescription.DefaultValue = $defaultValue
+    }
+
+    return $fieldDescription
+}
+
+

src/private/cli/GetAwesomePromptResult.ps1

@@ -1,11 +1,11 @@
 function Get-AwesomePromptResult {
     param(
-        [Parameter(Mandatory)][pscustomobject]$Ask,
+        [Parameter(Mandatory)][object]$Ask,
         [Parameter(Mandatory)][object]$Response
     )
 
     if ( [string]::IsNullOrEmpty($Response.Values)) {
-        return $Ask.Default
+        return Get-AwesomePromptValue -Ask $Ask -Name 'Default'
     }
 
     return $Response.Values

src/private/cli/GetAwesomePromptValidationFailure.ps1

@@ -0,0 +1,28 @@
+function Get-AwesomePromptValidationFailure {
+    param(
+        [Parameter(Mandatory)][object]$Ask,
+        [AllowNull()]$Value
+    )
+
+    $validation = Get-AwesomePromptValue -Ask $Ask -Name 'Validation'
+    if ($null -eq $validation) {
+        return $null
+    }
+
+    $validator = Get-AwesomePromptValue -Ask $validation -Name 'Test'
+    if ($null -eq $validator) {
+        return $null
+    }
+
+    if ([bool](& $validator $Value)) {
+        return $null
+    }
+
+    return [pscustomobject]@{
+        Message = Get-AwesomePromptValue -Ask $validation -Name 'Message'
+        ErrorId = Get-AwesomePromptValue -Ask $validation -Name 'ErrorId'
+        Category = Get-AwesomePromptValue -Ask $validation -Name 'Category'
+        TargetObject = $Value
+    }
+}
+

src/private/cli/GetAwesomePromptValue.ps1

@@ -0,0 +1,22 @@
+function Get-AwesomePromptValue {
+    param(
+        [Parameter(Mandatory)][object]$Ask,
+        [Parameter(Mandatory)][string]$Name
+    )
+
+    if ($Ask -is [System.Collections.IDictionary]) {
+        if ( $Ask.Contains($Name)) {
+            return $Ask[$Name]
+        }
+
+        return $null
+    }
+
+    $property = $Ask.PSObject.Properties[$Name]
+    if ($null -eq $property) {
+        return $null
+    }
+
+    return $property.Value
+}
+

src/private/cli/ReadAwesomeChoicePrompt.ps1

@@ -1,12 +1,17 @@
 function Read-AwesomeChoicePrompt {
     param(
-        [Parameter(Mandatory)][pscustomobject]$Ask,
+        [Parameter(Mandatory)][object]$Ask,
         [Parameter(Mandatory)][object]$HostUi
     )
 
-    $options = Get-AwesomeChoiceOptionList -Choice $Ask.Choice
-    $defaultIndex = $options.Label.IndexOf('&' + $Ask.Default)
-    $response = $HostUi.PromptForChoice($Ask.Caption, $Ask.Message, $options, $defaultIndex)
+    $options = Get-AwesomeChoiceOptionList -Choice (Get-AwesomePromptValue -Ask $Ask -Name 'Choice')
+    $defaultIndex = $options.Label.IndexOf('&' + (Get-AwesomePromptValue -Ask $Ask -Name 'Default'))
+    $response = $HostUi.PromptForChoice(
+            (Get-AwesomePromptValue -Ask $Ask -Name 'Caption'),
+            (Get-AwesomePromptValue -Ask $Ask -Name 'Message'),
+            $options,
+            $defaultIndex
+    )
 
     return $options.Label[$response] -replace '&'
 }

src/private/cli/ReadAwesomeStandardPrompt.ps1

@@ -1,16 +1,21 @@
 function Read-AwesomeStandardPrompt {
     param(
-        [Parameter(Mandatory)][pscustomobject]$Ask,
+        [Parameter(Mandatory)][object]$Ask,
         [Parameter(Mandatory)][object]$HostUi
     )
 
-    $fieldDescription = [System.Management.Automation.Host.FieldDescription]::new($Ask.Prompt)
-    if ($Ask.Default -ne 'MANDATORY') {
-        $fieldDescription.DefaultValue = $Ask.Default
-    }
+    $fieldDescription = Get-AwesomePromptFieldDescription -Ask $Ask
 
     do {
-        $response = $HostUi.Prompt($Ask.Caption, $Ask.Message, @($fieldDescription))
+        $response = $HostUi.Prompt(
+                (Get-AwesomePromptValue -Ask $Ask -Name 'Caption'),
+                (Get-AwesomePromptValue -Ask $Ask -Name 'Message'),
+                @($fieldDescription)
+        )
+
+        if (Test-AwesomePromptRequiresRetry -Ask $Ask -Response $response) {
+            Write-AwesomePromptRetryMessage -Ask $Ask -Response $response
+        }
     } while (Test-AwesomePromptRequiresRetry -Ask $Ask -Response $response)
 
     return Get-AwesomePromptResult -Ask $Ask -Response $response

src/private/cli/TestAwesomePromptRequiresRetry.ps1

@@ -1,8 +1,13 @@
 function Test-AwesomePromptRequiresRetry {
     param(
-        [Parameter(Mandatory)][pscustomobject]$Ask,
+        [Parameter(Mandatory)][object]$Ask,
         [Parameter(Mandatory)][object]$Response
     )
 
-    return $Ask.Default -eq 'MANDATORY' -and [string]::IsNullOrEmpty($Response.Values)
+    if ((Get-AwesomePromptValue -Ask $Ask -Name 'Default') -eq 'MANDATORY' -and [string]::IsNullOrEmpty($Response.Values)) {
+        return $true
+    }
+
+    $value = Get-AwesomePromptResult -Ask $Ask -Response $Response
+    return $null -ne (Get-AwesomePromptValidationFailure -Ask $Ask -Value $value)
 }

src/private/cli/WriteAwesomePromptRetryMessage.ps1

@@ -0,0 +1,15 @@
+function Write-AwesomePromptRetryMessage {
+    param(
+        [Parameter(Mandatory)][object]$Ask,
+        [Parameter(Mandatory)][object]$Response
+    )
+
+    $value = Get-AwesomePromptResult -Ask $Ask -Response $Response
+    $failure = Get-AwesomePromptValidationFailure -Ask $Ask -Value $value
+    if ($null -eq $failure) {
+        return
+    }
+
+    Write-Message -Text $failure.Message -color Yello
+}
+