#215 feat: enhance Invoke-NovaAgenticCopilotScaffold with progress feedback and clearer cancellation guidance

Author: stiwicourage

CHANGELOG.md

@@ -22,6 +22,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 - `Get-NovaUpdateNotificationPreference -Verbose` now explains whether Nova is reading a stored preference or the built-in default, and the command help now points read-only PowerShell users to the matching `% nova notification` workflow.
 - `Initialize-NovaModule` now shows scaffold progress, ends with the created project root plus the next suggested cmdlet, and fails with clearer guidance when the target project folder already exists.
 - `Install-NovaCli` now prints the installed launcher path, suggests the next command to run, and gives a clearer `PATH` warning when the destination directory is not yet available from the shell.
+- `Invoke-NovaAgenticCopilotScaffold` now shows apply progress, ends with the project root plus suggested review and validation steps, and fails with clearer cancellation guidance when the overwrite warning is declined.
 
 ### Deprecated
 

RELEASE_NOTE.md

@@ -18,6 +18,7 @@ This file summarizes the release notes for NovaModuleTools. **UNRELEASED** chang
 - `Get-NovaUpdateNotificationPreference -Verbose` now tells you whether Nova is using a stored update-notification preference or the built-in default, and the help now points to the matching `% nova notification` workflow.
 - `Initialize-NovaModule` now shows scaffold progress, ends with the project root and the next suggested cmdlet, and gives clearer recovery guidance when the target project folder already exists.
 - `Install-NovaCli` now prints the installed launcher path, suggests the next command to run, and gives a clearer `PATH` warning when the launcher directory is not yet available from the shell.
+- `Invoke-NovaAgenticCopilotScaffold` now shows apply progress, ends with the project root plus suggested review and validation steps, and gives clearer cancellation guidance when the overwrite warning is declined.
 
 ### Deprecated
 

docs/NovaModuleTools/en-US/Invoke-NovaAgenticCopilotScaffold.md

@@ -34,6 +34,8 @@ By default the workflow shows an overwrite warning before it updates the managed
 
 The target path must contain a valid `project.json`. Invalid project metadata or an invalid short name stops the command with a clear validation error.
 
+During apply or refresh, Nova shows progress for the main scaffold phases and ends with the project root plus the next suggested review and validation steps.
+
 ## EXAMPLES
 
 ### EXAMPLE 1
@@ -201,6 +203,8 @@ This workflow does not persist `ShortName` to `project.json` and does not infer
 
 `README.md`, `CHANGELOG.md`, and `RELEASE_NOTE.md` are created only when they are missing.
 
+Press `Ctrl+C` before confirming the overwrite warning if you want to cancel the apply without changing files.
+
 ## RELATED LINKS
 
 - [Initialize-NovaModule](./Initialize-NovaModule.md)

src/private/scaffold/InvokeNovaAgenticCopilotScaffoldWorkflow.ps1

@@ -49,7 +49,7 @@ function Confirm-NovaAgenticCopilotScaffoldWarning {
         return
     }
 
-    Stop-NovaOperation -Message 'Operation cancelled.' -ErrorId 'Nova.Workflow.AgenticCopilotScaffoldCancelled' -Category OperationStopped -TargetObject $WorkflowContext.ProjectRoot
+    Stop-NovaOperation -Message "Agentic Copilot scaffold apply cancelled for $( $WorkflowContext.ProjectRoot ). Re-run the command and choose Yes when you are ready to overwrite the managed scaffold paths." -ErrorId 'Nova.Workflow.AgenticCopilotScaffoldCancelled' -Category OperationStopped -TargetObject $WorkflowContext.ProjectRoot
 }
 
 function Invoke-NovaAgenticCopilotScaffoldWorkflow {
@@ -63,7 +63,54 @@ function Invoke-NovaAgenticCopilotScaffoldWorkflow {
         return
     }
 
-    Confirm-NovaAgenticCopilotScaffoldWarning -WorkflowContext $WorkflowContext
-    Initialize-NovaModuleAgenticCopilotScaffold -Answer $WorkflowContext.AnswerSet -ProjectRoot $WorkflowContext.ProjectRoot -ScaffoldPolicy $WorkflowContext.ScaffoldPolicy
+    $progressActivity = 'Applying Agentic Copilot scaffold'
+
+    try {
+        Invoke-NovaAgenticCopilotScaffoldStep -Activity $progressActivity -Status 'Confirming overwrite warning' -PercentComplete 20 -Action {
+            Confirm-NovaAgenticCopilotScaffoldWarning -WorkflowContext $WorkflowContext
+        }
+
+        Invoke-NovaAgenticCopilotScaffoldStep -Activity $progressActivity -Status 'Refreshing managed scaffold files' -PercentComplete 75 -Action {
+            Initialize-NovaModuleAgenticCopilotScaffold -Answer $WorkflowContext.AnswerSet -ProjectRoot $WorkflowContext.ProjectRoot -ScaffoldPolicy $WorkflowContext.ScaffoldPolicy
+        }
+    } finally {
+        Write-Progress -Activity $progressActivity -Completed
+    }
+
+    Write-NovaAgenticCopilotScaffoldResult -WorkflowContext $WorkflowContext
+}
+
+function Invoke-NovaAgenticCopilotScaffoldStep {
+    [CmdletBinding()]
+    param(
+        [Parameter(Mandatory)][string]$Activity,
+        [Parameter(Mandatory)][string]$Status,
+        [Parameter(Mandatory)][int]$PercentComplete,
+        [Parameter(Mandatory)][scriptblock]$Action
+    )
+
+    Write-Progress -Activity $Activity -Status $Status -PercentComplete $PercentComplete
+    & $Action
+}
+
+function Write-NovaAgenticCopilotScaffoldResult {
+    [CmdletBinding()]
+    param(
+        [Parameter(Mandatory)][pscustomobject]$WorkflowContext
+    )
+
     Write-Message "Agentic Copilot scaffold applied to $( $WorkflowContext.ProjectInfo.ProjectName )" -color Green
+    Write-Message "Project root: $( $WorkflowContext.ProjectRoot )"
+
+    foreach ($line in (Get-NovaAgenticCopilotScaffoldNextStepLine)) {
+        Write-Message $line
+    }
+}
+
+function Get-NovaAgenticCopilotScaffoldNextStepLine {
+    return @(
+        'Next steps:'
+        'Review AGENTS.md and CONTRIBUTING.md'
+        'Test-NovaBuild'
+    )
 }

tests/private/scaffold/InvokeNovaAgenticCopilotScaffoldWorkflow.TestSupport.ps1

@@ -7,6 +7,10 @@ function Initialize-NovaModuleAgenticCopilotScaffold {
     )
 }
 
+function Write-Message {
+    param([string]$Message, [string]$color)
+}
+
 function Stop-NovaOperation {
     param([string]$Message, [string]$ErrorId, [System.Management.Automation.ErrorCategory]$Category, $TargetObject)
     $exception = [System.Exception]::new($Message)

tests/private/scaffold/InvokeNovaAgenticCopilotScaffoldWorkflow.Tests.ps1

@@ -71,7 +71,7 @@ Describe 'Confirm-NovaAgenticCopilotScaffoldWarning' {
                 ManagedOverwritePathList = @('.github/agents/')
                 AddOnlyPathList = @('README.md')
             })
-        } | Should -Throw -ErrorId 'Nova.Workflow.AgenticCopilotScaffoldCancelled'
+        } | Should -Throw '*Agentic Copilot scaffold apply cancelled for /repo.*choose Yes when you are ready to overwrite the managed scaffold paths.*'
     }
 }
 
@@ -80,6 +80,7 @@ Describe 'Invoke-NovaAgenticCopilotScaffoldWorkflow' {
         Mock Confirm-NovaAgenticCopilotScaffoldWarning {}
         Mock Initialize-NovaModuleAgenticCopilotScaffold {}
         Mock Write-Message {}
+        Mock Write-Progress {}
     }
 
     It 'returns without applying when ShouldRun is false' {
@@ -108,6 +109,13 @@ Describe 'Invoke-NovaAgenticCopilotScaffoldWorkflow' {
 
         Assert-MockCalled Confirm-NovaAgenticCopilotScaffoldWarning -Times 1
         Assert-MockCalled Initialize-NovaModuleAgenticCopilotScaffold -Times 1
-        Assert-MockCalled Write-Message -Times 1
+        Assert-MockCalled Write-Progress -Times 3
+        Assert-MockCalled Write-Message -Times 5
+        Assert-MockCalled Write-Message -Times 1 -ParameterFilter {
+            $Message -eq 'Agentic Copilot scaffold applied to Demo' -and $color -eq 'Green'
+        }
+        Assert-MockCalled Write-Message -Times 1 -ParameterFilter {
+            $Message -eq 'Test-NovaBuild'
+        }
     }
 }