Task 001 complete

Author: johnmbaughman

specs/feat/paramsets-install-speckit/tasks.md

@@ -7,8 +7,8 @@
 
 Follow these executable tasks in order. Tasks marked with **[P]** can run in parallel because they modify different files and have no dependency overlap. Each task lists required files, dependencies, and success criteria so an LLM or human can execute it without extra context.
 
-## Phase 3.1 – Setup
-- [ ] **T001** Prepare host simulation helpers for tests
+-## Phase 3.1 – Setup
+- [X] **T001** Prepare host simulation helpers for tests
   - Files: `tests/Support/HostMocks.ps1`
   - Work: Add a reusable helper module exposing `New-TestHostInteractive`, `New-TestHostNonInteractive`, and prompt transcript utilities so unit/integration tests can simulate TTY/non-TTY behavior without altering global host state.
   - Depends on: —

tests/Support/HostMocks.ps1

@@ -0,0 +1,78 @@
+<#
+Helper test host objects and prompt transcript utilities for Pester tests.
+
+Provides:
+ - New-TestHostInteractive
+ - New-TestHostNonInteractive
+ - Start-TestPromptTranscript
+ - Add-TestPromptEntry
+ - Get-TestPromptTranscript
+ - Clear-TestPromptTranscript
+
+#>
+
+function New-TestHostInteractive {
+    <# Creates a PSCustomObject that mimics $Host with UI.RawUI that indicates a TTY is available. #>
+    $rawUI = [PSCustomObject]@{
+        KeyAvailable    = $true
+        CursorSize      = 1
+        BackgroundColor = 'Black'
+        ForegroundColor = 'White'
+        WindowSize      = [PSCustomObject]@{ Width = 120; Height = 30 }
+        BufferSize      = [PSCustomObject]@{ Width = 120; Height = 300 }
+        CursorPosition  = [PSCustomObject]@{ X = 0; Y = 0 }
+    }
+
+    $ui = [PSCustomObject]@{ RawUI = $rawUI }
+    $testHostObj = [PSCustomObject]@{ Name = 'TestHost'; UI = $ui }
+    return $testHostObj
+}
+
+function New-TestHostNonInteractive {
+    <# Creates a PSCustomObject that mimics $Host without TTY support (KeyAvailable = $false). #>
+    $rawUI = [PSCustomObject]@{
+        KeyAvailable    = $false
+        CursorSize      = 1
+        BackgroundColor = 'Black'
+        ForegroundColor = 'White'
+        WindowSize      = [PSCustomObject]@{ Width = 80; Height = 25 }
+        BufferSize      = [PSCustomObject]@{ Width = 80; Height = 200 }
+        CursorPosition  = [PSCustomObject]@{ X = 0; Y = 0 }
+    }
+
+    $ui = [PSCustomObject]@{ RawUI = $rawUI }
+    $testHostObj = [PSCustomObject]@{ Name = 'TestHost'; UI = $ui }
+    return $testHostObj
+}
+
+# Prompt transcript utilities (simple in-memory capture for tests)
+if (-not (Test-Path -LiteralPath variable:TestHostPromptTranscript -ErrorAction SilentlyContinue)) {
+    Set-Variable -Name TestHostPromptTranscript -Scope Script -Value @()
+}
+
+function Start-TestPromptTranscript {
+    Set-Variable -Name TestHostPromptTranscript -Scope Script -Value @()
+}
+
+function Add-TestPromptEntry {
+    param(
+        [Parameter(Mandatory=$true)] [string] $Prompt,
+        [Parameter(Mandatory=$true)] [string] $Response
+    )
+    $entry = [PSCustomObject]@{
+        Time     = (Get-Date).ToString('o')
+        Prompt   = $Prompt
+        Response = $Response
+    }
+    $script:TestHostPromptTranscript += $entry
+}
+
+function Get-TestPromptTranscript {
+    return ,$script:TestHostPromptTranscript
+}
+
+function Clear-TestPromptTranscript {
+    Set-Variable -Name TestHostPromptTranscript -Scope Script -Value @()
+}
+
+# Intentionally do not call Export-ModuleMember here so the file can be dot-sourced from tests.