prizmkit 1.1.99 → 1.1.101

package/bundled/dev-pipeline-windows/lib/common.ps1

@@ -1,829 +0,0 @@
-Set-StrictMode -Version 2.0
-$ErrorActionPreference = 'Stop'
-
-$script:PrizmAiProcess = $null
-
-function Initialize-PrizmLineLogBridgeType {
-  if ('PrizmLineLogBridge' -as [type]) { return }
-
-  Add-Type -TypeDefinition @'
-using System;
-using System.Diagnostics;
-using System.IO;
-using System.Text;
-
-public sealed class PrizmLineLogBridge : IDisposable
-{
-    private readonly StreamWriter writer;
-    private readonly object sync = new object();
-    public readonly DataReceivedEventHandler Handler;
-
-    public PrizmLineLogBridge(string logPath)
-    {
-        writer = new StreamWriter(logPath, false, new UTF8Encoding(false));
-        Handler = new DataReceivedEventHandler(OnDataReceived);
-    }
-
-    private void OnDataReceived(object sender, DataReceivedEventArgs eventArgs)
-    {
-        if (eventArgs.Data == null) return;
-        lock (sync)
-        {
-            writer.WriteLine(eventArgs.Data);
-            writer.Flush();
-        }
-    }
-
-    public void Dispose()
-    {
-        lock (sync)
-        {
-            writer.Flush();
-            writer.Dispose();
-        }
-    }
-}
-'@
-}
-
-function Write-PrizmInfo { param([string]$Message) Write-Host "[INFO]    $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') $Message" -ForegroundColor Blue }
-function Write-PrizmWarn { param([string]$Message) Write-Host "[WARN]    $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') $Message" -ForegroundColor Yellow }
-function Write-PrizmError { param([string]$Message) Write-Host "[ERROR]   $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') $Message" -ForegroundColor Red }
-function Write-PrizmSuccess { param([string]$Message) Write-Host "[SUCCESS] $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') $Message" -ForegroundColor Green }
-
-function Get-PrizmHiddenToolWorktreeExcludes {
-  return @(
-    ':(top,exclude,glob).*/worktree',
-    ':(top,exclude,glob).*/worktree/**',
-    ':(top,exclude,glob).*/worktrees',
-    ':(top,exclude,glob).*/worktrees/**'
-  )
-}
-
-function Initialize-PrizmPaths {
-  param([string]$ScriptRoot)
-  $pipelineDir = Resolve-Path $ScriptRoot
-  $pipelineParent = Split-Path $pipelineDir -Parent
-  if ((Split-Path $pipelineParent -Leaf) -eq '.prizmkit') {
-    $prizmkitDir = $pipelineParent
-    $projectRoot = Split-Path $pipelineParent -Parent
-  } else {
-    $projectRoot = Split-Path $pipelineDir -Parent
-    $prizmkitDir = Join-Path $projectRoot '.prizmkit'
-  }
-  [pscustomobject]@{
-    PipelineDir = $pipelineDir.Path
-    PrizmkitDir = $prizmkitDir
-    ProjectRoot = $projectRoot
-    ScriptsDir = Join-Path $pipelineDir.Path 'scripts'
-    TemplatesDir = Join-Path $pipelineDir.Path 'templates'
-  }
-}
-
-function Import-PrizmEnv {
-  param([string]$EnvPath)
-  if (-not (Test-Path $EnvPath)) { return }
-  foreach ($line in Get-Content $EnvPath) {
-    $trimmed = $line.Trim()
-    if (-not $trimmed -or $trimmed.StartsWith('#')) { continue }
-    $idx = $trimmed.IndexOf('=')
-    if ($idx -lt 1) { continue }
-    $key = $trimmed.Substring(0, $idx).Trim()
-    $rawValue = $trimmed.Substring($idx + 1).Trim()
-    $valueBuilder = [System.Text.StringBuilder]::new()
-    $inSingleQuote = $false
-    $inDoubleQuote = $false
-    for ($i = 0; $i -lt $rawValue.Length; $i++) {
-      $char = $rawValue[$i]
-      if ($char -eq "'" -and -not $inDoubleQuote) { $inSingleQuote = -not $inSingleQuote }
-      if ($char -eq '"' -and -not $inSingleQuote) { $inDoubleQuote = -not $inDoubleQuote }
-      if ($char -eq '#' -and -not $inSingleQuote -and -not $inDoubleQuote) { break }
-      [void]$valueBuilder.Append($char)
-    }
-    $value = $valueBuilder.ToString().Trim().Trim('"').Trim("'")
-    if (-not [Environment]::GetEnvironmentVariable($key, 'Process')) {
-      [Environment]::SetEnvironmentVariable($key, $value, 'Process')
-    }
-  }
-}
-
-function Resolve-PrizmPython {
-  $python = Get-Command python -ErrorAction SilentlyContinue
-  if ($python) {
-    & $python.Source -c 'import sys; raise SystemExit(0 if sys.version_info[0] == 3 else 1)' *> $null
-    if ($LASTEXITCODE -eq 0) { return @($python.Source) }
-  }
-  $py = Get-Command py -ErrorAction SilentlyContinue
-  if ($py) {
-    & $py.Source -3 -c 'import sys; raise SystemExit(0 if sys.version_info[0] == 3 else 1)' *> $null
-    if ($LASTEXITCODE -eq 0) { return @($py.Source, '-3') }
-  }
-  throw 'Python 3 is required. Install Python and ensure python or py is in PATH.'
-}
-
-function Resolve-PrizmPowerShellHost {
-  $pwsh = Get-Command pwsh -ErrorAction SilentlyContinue
-  if ($pwsh) { return $pwsh.Source }
-  $powershell = Get-Command powershell -ErrorAction SilentlyContinue
-  if ($powershell) { return $powershell.Source }
-  throw 'PowerShell host not found. Install PowerShell or ensure powershell.exe is in PATH.'
-}
-
-function Invoke-PrizmPythonOutput {
-  param([string[]]$PythonCommand, [string[]]$Arguments)
-  $cmd = $PythonCommand[0]
-  $prefix = @()
-  if ($PythonCommand.Count -gt 1) { $prefix = $PythonCommand[1..($PythonCommand.Count - 1)] }
-  $output = & $cmd @prefix @Arguments
-  if ($LASTEXITCODE -ne 0) { throw "Python command failed: $($Arguments -join ' ')" }
-  if (-not $output) { return '' }
-  return ($output -join "`n")
-}
-
-function Invoke-PrizmPythonJson {
-  param([string[]]$PythonCommand, [string[]]$Arguments)
-  $text = Invoke-PrizmPythonOutput $PythonCommand $Arguments
-  if (-not $text) { return $null }
-  return $text | ConvertFrom-Json
-}
-
-function Invoke-PrizmPythonText {
-  param([string[]]$PythonCommand, [string[]]$Arguments)
-  $cmd = $PythonCommand[0]
-  $prefix = @()
-  if ($PythonCommand.Count -gt 1) { $prefix = $PythonCommand[1..($PythonCommand.Count - 1)] }
-  & $cmd @prefix @Arguments
-  if ($LASTEXITCODE -ne 0) { throw "Python command failed: $($Arguments -join ' ')" }
-}
-
-function Test-PrizmInfraError {
-  param([string]$SessionLog, [string]$ProgressJson)
-  $parts = @()
-  if ($SessionLog -and (Test-Path $SessionLog)) {
-    try {
-      $text = Get-Content $SessionLog -Raw -ErrorAction Stop
-      if ($text.Length -gt 65536) { $text = $text.Substring($text.Length - 65536) }
-      $parts += $text
-    } catch {}
-  }
-  if ($ProgressJson -and (Test-Path $ProgressJson)) {
-    try { $parts += (Get-Content $ProgressJson -Raw -ErrorAction Stop) } catch {}
-  }
-  if ($parts.Count -eq 0) { return $false }
-
-  $haystack = $parts -join "`n"
-  return ($haystack -match '(?i)auth_unavailable|no auth available|502 Bad Gateway|503 Service Unavailable|504 Gateway Timeout|gateway timeout|upstream (connect )?error|connection reset|ECONNRESET|ETIMEDOUT|ENOTFOUND|EAI_AGAIN|rate limit|rate_limit|temporarily unavailable|overloaded')
-}
-
-function Test-PrizmAiRuntimeError {
-  param([string]$SessionLog, [string]$ProgressJson)
-
-  if ($ProgressJson -and (Test-Path $ProgressJson)) {
-    try {
-      $progress = Get-Content $ProgressJson -Raw -ErrorAction Stop | ConvertFrom-Json -ErrorAction Stop
-      if ($progress.PSObject.Properties['fatal_error_code'] -and $progress.fatal_error_code) {
-        return $true
-      }
-    } catch {}
-  }
-
-  $parts = @()
-  if ($SessionLog -and (Test-Path $SessionLog)) {
-    try {
-      $text = Get-Content $SessionLog -Raw -ErrorAction Stop
-      if ($text.Length -gt 65536) { $text = $text.Substring($text.Length - 65536) }
-      $parts += $text
-    } catch {}
-  }
-  if ($ProgressJson -and (Test-Path $ProgressJson)) {
-    try { $parts += (Get-Content $ProgressJson -Raw -ErrorAction Stop) } catch {}
-  }
-  if ($parts.Count -eq 0) { return $false }
-
-  $haystack = $parts -join "`n"
-  $contextPattern = '(?i)context_too_large|model_context_window_exceeded|input exceeds the context window|context window of this model|context window (was )?exceeded|exceeded (the )?context window|invalid_request_error.*context window|context window.*invalid_request_error'
-  $errorPattern = '(?i)api error|invalid_request_error|api_error_status|api_error_code|status\s*[:=]?\s*(400|413)|last_result_is_error\s*["'':=]?\s*true|is_error\s*["'':=]?\s*true'
-  if (($haystack -match $contextPattern) -and ($haystack -match $errorPattern)) { return $true }
-  return $false
-}
-
-function Get-PrizmProgressFatalErrorCode {
-  param([string]$ProgressFile)
-  if (-not (Test-Path $ProgressFile)) { return '' }
-  try {
-    $progress = Get-Content $ProgressFile -Raw -ErrorAction Stop | ConvertFrom-Json -ErrorAction Stop
-    if ($progress.PSObject.Properties['fatal_error_code'] -and $progress.fatal_error_code) {
-      return [string]$progress.fatal_error_code
-    }
-  } catch {}
-  return ''
-}
-
-function Write-PrizmFatalErrorMarker {
-  param([string]$MarkerPath, [string]$FatalErrorCode, [int]$StaleSeconds, [int]$Threshold)
-  $markerDir = Split-Path $MarkerPath -Parent
-  if ($markerDir) { New-Item -ItemType Directory -Force -Path $markerDir | Out-Null }
-  [ordered]@{
-    killed_at = (Get-Date).ToUniversalTime().ToString('yyyy-MM-ddTHH:mm:ssZ')
-    reason = $FatalErrorCode
-    fatal_error_code = $FatalErrorCode
-    stale_seconds = $StaleSeconds
-    threshold = $Threshold
-  } | ConvertTo-Json -Compress | Set-Content -Path $MarkerPath -Encoding UTF8
-}
-
-function Get-PrizmConfigValue {
-  param([string]$ConfigPath, [string]$Key)
-  if (-not (Test-Path $ConfigPath)) { return $null }
-  try {
-    $json = Get-Content $ConfigPath -Raw | ConvertFrom-Json
-    return $json.$Key
-  } catch { return $null }
-}
-
-function Split-PrizmCommandLine {
-  param([string]$CommandLine)
-  $trimmed = if ($CommandLine) { $CommandLine.Trim() } else { '' }
-  if (-not $trimmed) { throw 'AI CLI command is empty.' }
-  if (Test-Path $trimmed) {
-    return [pscustomobject]@{ Command = $trimmed; Arguments = '' }
-  }
-  if ($trimmed -match '^"([^"]+)"\s*(.*)$') {
-    return [pscustomobject]@{ Command = $matches[1]; Arguments = $matches[2].Trim() }
-  }
-  if ($trimmed -match "^'([^']+)'\s*(.*)$") {
-    return [pscustomobject]@{ Command = $matches[1]; Arguments = $matches[2].Trim() }
-  }
-  if ($trimmed -match '^(\S+)\s*(.*)$') {
-    return [pscustomobject]@{ Command = $matches[1]; Arguments = $matches[2].Trim() }
-  }
-  throw "Unable to parse AI CLI command: $CommandLine"
-}
-
-function Resolve-PrizmExecutableShim {
-  param([string]$Source)
-  if (-not $Source) { return $Source }
-
-  $extension = [System.IO.Path]::GetExtension($Source).ToLowerInvariant()
-  if ($extension -ne '.ps1') { return $Source }
-
-  $directory = [System.IO.Path]::GetDirectoryName($Source)
-  $baseName = [System.IO.Path]::GetFileNameWithoutExtension($Source)
-  if (-not $directory -or -not $baseName) { return $Source }
-
-  foreach ($candidateExtension in @('.cmd', '.bat', '.exe')) {
-    $candidate = Join-Path $directory ($baseName + $candidateExtension)
-    if (Test-Path $candidate) { return $candidate }
-  }
-
-  return $Source
-}
-
-function Resolve-PrizmCommandLine {
-  param([string]$CommandLine)
-  $parsed = Split-PrizmCommandLine $CommandLine
-  $command = @(Get-Command $parsed.Command -ErrorAction SilentlyContinue)[0]
-  if (-not $command) { return $CommandLine }
-  $source = if ($command.Source) { $command.Source } else { $command.Definition }
-  if (-not $source) { return $CommandLine }
-  $source = Resolve-PrizmExecutableShim $source
-  if ($source -match '\s') { $source = '"' + $source + '"' }
-  if ($parsed.Arguments) {
-    return "$source $($parsed.Arguments)"
-  }
-  return $source
-}
-
-function Get-PrizmCliNamesForPlatform {
-  param([string]$Platform)
-  $normalized = if ($Platform) { $Platform.ToLowerInvariant() } else { '' }
-  switch ($normalized) {
-    'codex' { return @('codex') }
-    'claude' { return @('claude') }
-    'codebuddy' { return @('cbc') }
-    'both' { return @('claude', 'cbc') }
-    'all' { return @('codex', 'claude', 'cbc') }
-    default { return @() }
-  }
-}
-
-function Resolve-PrizmCliName {
-  param([string]$CliName)
-  if ($CliName -eq 'cbc' -and $env:CODEBUDDY_CLI) {
-    return Resolve-PrizmCommandLine $env:CODEBUDDY_CLI
-  }
-  if (Get-Command $CliName -ErrorAction SilentlyContinue) {
-    return Resolve-PrizmCommandLine $CliName
-  }
-  return ''
-}
-
-function Resolve-PrizmCliForPlatform {
-  param([string]$Platform)
-  foreach ($candidate in (Get-PrizmCliNamesForPlatform $Platform)) {
-    $cli = Resolve-PrizmCliName $candidate
-    if ($cli) { return $cli }
-  }
-  return ''
-}
-
-function Resolve-PrizmCliForPlatformRequirement {
-  param([string]$Platform, [string]$Source)
-  $expectedCliNames = @(Get-PrizmCliNamesForPlatform $Platform)
-  if ($expectedCliNames.Count -eq 0) { return '' }
-  $cli = Resolve-PrizmCliForPlatform $Platform
-  if ($cli) { return $cli }
-  $expectedCliText = $expectedCliNames -join ', '
-  throw "$Source PrizmKit platform '$Platform' requires one of: $expectedCliText. Install it or set AI_CLI."
-}
-
-function Resolve-PrizmAiCli {
-  param([string]$ProjectRoot, [string]$PrizmkitDir)
-  Import-PrizmEnv (Join-Path $PrizmkitDir '.env')
-  if ($env:AI_CLI) { return Resolve-PrizmCommandLine $env:AI_CLI }
-  $configured = Get-PrizmConfigValue (Join-Path $PrizmkitDir 'config.json') 'ai_cli'
-  if ($configured) { return Resolve-PrizmCommandLine $configured }
-
-  $manifestPlatform = Get-PrizmConfigValue (Join-Path $PrizmkitDir 'manifest.json') 'platform'
-  if ($manifestPlatform) {
-    $manifestCli = Resolve-PrizmCliForPlatformRequirement ([string]$manifestPlatform) 'Installed'
-    if ($manifestCli) { return $manifestCli }
-  }
-
-  $configuredPlatform = Get-PrizmConfigValue (Join-Path $PrizmkitDir 'config.json') 'platform'
-  if ($configuredPlatform) {
-    $configuredPlatformCli = Resolve-PrizmCliForPlatformRequirement ([string]$configuredPlatform) 'Configured'
-    if ($configuredPlatformCli) { return $configuredPlatformCli }
-  }
-
-  if ($env:CODEBUDDY_CLI) { return Resolve-PrizmCommandLine $env:CODEBUDDY_CLI }
-
-  if (((Test-Path (Join-Path $ProjectRoot '.codex\agents\prizm-dev-team-dev.toml')) -or (Test-Path (Join-Path $ProjectRoot '.agents\skills\prizm-kit\SKILL.md'))) -and (Get-Command codex -ErrorAction SilentlyContinue)) { return Resolve-PrizmCommandLine 'codex' }
-  if ((Test-Path (Join-Path $ProjectRoot '.claude\commands\prizm-kit.md')) -and (Get-Command claude -ErrorAction SilentlyContinue)) { return Resolve-PrizmCommandLine 'claude' }
-  if (((Test-Path (Join-Path $ProjectRoot '.codebuddy\agents\prizm-dev-team-dev.md')) -or (Test-Path (Join-Path $ProjectRoot '.codebuddy\skills\prizm-kit\SKILL.md'))) -and (Resolve-PrizmCliName 'cbc')) { return Resolve-PrizmCliName 'cbc' }
-  foreach ($candidate in @('codex', 'claude', 'cbc')) {
-    $cli = Resolve-PrizmCliName $candidate
-    if ($cli) { return $cli }
-  }
-  throw 'No AI CLI found. Install Codex (codex), Claude Code (claude), or CodeBuddy (cbc), or set AI_CLI.'
-}
-
-function Get-PrizmConcretePlatform {
-  param([string]$Platform)
-  $normalized = if ($Platform) { $Platform.ToLowerInvariant() } else { '' }
-  if (@('codex', 'claude', 'codebuddy') -contains $normalized) { return $normalized }
-  return ''
-}
-
-function Get-PrizmKnownPlatformFromCli {
-  param([string]$CliCommand)
-  $parsed = Split-PrizmCommandLine $CliCommand
-  $cliName = [System.IO.Path]::GetFileNameWithoutExtension($parsed.Command).ToLowerInvariant()
-  if ($cliName -match 'claude') { return 'claude' }
-  if ($cliName -match 'codex') { return 'codex' }
-  if ($cliName -match 'cbc|codebuddy') { return 'codebuddy' }
-  return ''
-}
-
-function ConvertTo-PrizmProcessArgument {
-  param([string]$Argument)
-  if ($Argument -eq $null) { return '""' }
-  if ($Argument -notmatch '[\s"]') { return $Argument }
-  return '"' + ($Argument -replace '"', '\"') + '"'
-}
-
-function Join-PrizmProcessArguments {
-  param([string[]]$Arguments)
-  return (($Arguments | ForEach-Object { ConvertTo-PrizmProcessArgument $_ }) -join ' ')
-}
-
-function Get-PrizmPlatformFromCli {
-  param([string]$CliCommand)
-  $platform = Get-PrizmKnownPlatformFromCli $CliCommand
-  if ($platform) { return $platform }
-  return 'codebuddy'
-}
-
-function Get-PrizmPlatformFromProject {
-  param([string]$ProjectRoot, [string]$PrizmkitDir, [string]$CliCommand)
-  $cliPlatform = Get-PrizmKnownPlatformFromCli $CliCommand
-  if ($cliPlatform) { return $cliPlatform }
-  $envPlatform = Get-PrizmConcretePlatform $env:PRIZMKIT_PLATFORM
-  if ($envPlatform) { return $envPlatform }
-  $manifestPlatform = Get-PrizmConcretePlatform (Get-PrizmConfigValue (Join-Path $PrizmkitDir 'manifest.json') 'platform')
-  if ($manifestPlatform) { return $manifestPlatform }
-  $configuredPlatform = Get-PrizmConcretePlatform (Get-PrizmConfigValue (Join-Path $PrizmkitDir 'config.json') 'platform')
-  if ($configuredPlatform) { return $configuredPlatform }
-  return Get-PrizmPlatformFromCli $CliCommand
-}
-
-function Get-PrizmSessionPlatform {
-  param([string]$CliCommand)
-  $cliPlatform = Get-PrizmKnownPlatformFromCli $CliCommand
-  if ($cliPlatform) { return $cliPlatform }
-  $platform = Get-PrizmConcretePlatform $env:PRIZMKIT_PLATFORM
-  if ($platform) { return $platform }
-  return Get-PrizmPlatformFromCli $CliCommand
-}
-
-function Get-PrizmCodexSubagentTimeoutSeconds {
-  $configuredTimeout = 0
-  if ([int]::TryParse($env:CODEX_SUBAGENT_TIMEOUT_SECONDS, [ref]$configuredTimeout) -and $configuredTimeout -gt 0) {
-    return $configuredTimeout
-  }
-
-  $waitThreshold = 0
-  $waitThresholdText = if ($env:CODEX_WAIT_STALE_KILL_THRESHOLD) { $env:CODEX_WAIT_STALE_KILL_THRESHOLD } else { '3600' }
-  if ([int]::TryParse($waitThresholdText, [ref]$waitThreshold) -and $waitThreshold -gt 600) {
-    return ($waitThreshold - 300)
-  }
-
-  return 3300
-}
-
-function Get-PrizmEffectiveStaleKillThreshold {
-  param(
-    [string]$ProgressFile,
-    [int]$BaseThreshold
-  )
-
-  if ($BaseThreshold -le 0) { return $BaseThreshold }
-  if (-not (Test-Path $ProgressFile)) { return $BaseThreshold }
-
-  try {
-    $progress = Get-Content $ProgressFile -Raw -ErrorAction Stop | ConvertFrom-Json -ErrorAction Stop
-  } catch {
-    return $BaseThreshold
-  }
-
-  $spawnCount = 0
-  if ($progress.event_format -eq 'codex-json' -and $progress.current_tool -eq 'wait' -and $progress.tool_calls) {
-    foreach ($tool in @($progress.tool_calls)) {
-      if ($tool.name -eq 'spawn_agent') {
-        $count = 0
-        if ([int]::TryParse([string]$tool.count, [ref]$count)) { $spawnCount += $count }
-      }
-    }
-  }
-
-  if ($spawnCount -le 0) { return $BaseThreshold }
-
-  $waitThreshold = 0
-  if ([int]::TryParse($env:CODEX_WAIT_STALE_KILL_THRESHOLD, [ref]$waitThreshold) -and $waitThreshold -gt $BaseThreshold) {
-    return $waitThreshold
-  }
-
-  return [Math]::Max($BaseThreshold * 4, 3600)
-}
-
-function Get-PrizmProgressActivity {
-  param([string]$ProgressFile)
-
-  $empty = [pscustomobject]@{
-    ChildSignature = ''
-    ChildTotalBytes = 0
-    ChildSessionCount = 0
-    ProgressSignature = ''
-  }
-  if (-not (Test-Path $ProgressFile)) { return $empty }
-
-  try {
-    $progress = Get-Content $ProgressFile -Raw -ErrorAction Stop | ConvertFrom-Json -ErrorAction Stop
-  } catch {
-    return $empty
-  }
-
-  $childSignature = ''
-  if ($progress.PSObject.Properties['child_activity_signature'] -and $progress.child_activity_signature) {
-    $childSignature = [string]$progress.child_activity_signature
-  }
-
-  $childTotalBytes = [int64]0
-  if ($progress.PSObject.Properties['child_total_bytes']) {
-    [int64]::TryParse([string]$progress.child_total_bytes, [ref]$childTotalBytes) | Out-Null
-  }
-
-  $childSessionCount = 0
-  if ($progress.PSObject.Properties['child_session_files'] -and $progress.child_session_files) {
-    $childSessionCount = @($progress.child_session_files).Count
-  }
-
-  $messageCount = 0
-  if ($progress.PSObject.Properties['message_count']) {
-    [int]::TryParse([string]$progress.message_count, [ref]$messageCount) | Out-Null
-  }
-  $totalToolCalls = 0
-  if ($progress.PSObject.Properties['total_tool_calls']) {
-    [int]::TryParse([string]$progress.total_tool_calls, [ref]$totalToolCalls) | Out-Null
-  }
-  $activeSubagentCount = 0
-  if ($progress.PSObject.Properties['active_subagent_count']) {
-    [int]::TryParse([string]$progress.active_subagent_count, [ref]$activeSubagentCount) | Out-Null
-  }
-  $subagentSpawnCount = 0
-  if ($progress.PSObject.Properties['subagent_spawn_count']) {
-    [int]::TryParse([string]$progress.subagent_spawn_count, [ref]$subagentSpawnCount) | Out-Null
-  }
-  $currentPhase = if ($progress.PSObject.Properties['current_phase'] -and $progress.current_phase) { [string]$progress.current_phase } else { '' }
-  $currentTool = if ($progress.PSObject.Properties['current_tool'] -and $progress.current_tool) { [string]$progress.current_tool } else { '' }
-  $fatalErrorCode = if ($progress.PSObject.Properties['fatal_error_code'] -and $progress.fatal_error_code) { [string]$progress.fatal_error_code } else { '' }
-  $terminalResultText = if ($progress.PSObject.Properties['terminal_result_text'] -and $progress.terminal_result_text) { [string]$progress.terminal_result_text } else { '' }
-
-  $progressSignature = @(
-    $currentPhase,
-    $currentTool,
-    $messageCount,
-    $totalToolCalls,
-    $activeSubagentCount,
-    $subagentSpawnCount,
-    $childSignature,
-    $childTotalBytes,
-    $childSessionCount,
-    $fatalErrorCode,
-    $terminalResultText
-  ) | ConvertTo-Json -Compress
-
-  return [pscustomobject]@{
-    ChildSignature = $childSignature
-    ChildTotalBytes = $childTotalBytes
-    ChildSessionCount = $childSessionCount
-    ProgressSignature = $progressSignature
-  }
-}
-
-function Get-PrizmProgressChildActivity {
-  param([string]$ProgressFile)
-
-  $activity = Get-PrizmProgressActivity -ProgressFile $ProgressFile
-  return [pscustomobject]@{
-    Signature = $activity.ChildSignature
-    TotalBytes = $activity.ChildTotalBytes
-    SessionCount = $activity.ChildSessionCount
-  }
-}
-
-function Test-PrizmCodexJsonSupport {
-  param([string]$CliExecutable)
-  try {
-    $helpOutput = & $CliExecutable exec --help 2>&1
-    return (($helpOutput -join "`n") -match '--json')
-  } catch {
-    return $false
-  }
-}
-
-function Test-PrizmStreamJsonSupport {
-  param([string]$CliCommand)
-  $sessionPlatform = Get-PrizmSessionPlatform $CliCommand
-  $parsedCli = Split-PrizmCommandLine $CliCommand
-
-  if ($sessionPlatform -eq 'codebuddy') { return $true }
-  if ($sessionPlatform -eq 'codex') { return (Test-PrizmCodexJsonSupport $parsedCli.Command) }
-
-  try {
-    $helpOutput = & $parsedCli.Command --help 2>&1
-    return (($helpOutput -join "`n") -match 'stream-json')
-  } catch {
-    return $false
-  }
-}
-
-function Test-PrizmEffort {
-  param([string]$CliCommand)
-  if ([string]::IsNullOrEmpty($env:PRIZMKIT_EFFORT)) { return }
-
-  $sessionPlatform = Get-PrizmSessionPlatform $CliCommand
-  $valid = @{
-    claude    = @('low', 'medium', 'high', 'xhigh', 'max')
-    codex     = @('low', 'medium', 'high', 'xhigh')
-    codebuddy = @('low', 'medium', 'high', 'xhigh')
-  }
-
-  $allowed = $valid[$sessionPlatform]
-  if ($env:PRIZMKIT_EFFORT -notin $allowed) {
-    Write-Host "ERROR: PRIZMKIT_EFFORT='$env:PRIZMKIT_EFFORT' is not supported by the detected CLI ($sessionPlatform)." -ForegroundColor Red
-    Write-Host "  Supported values for $($sessionPlatform): $($allowed -join ', ')" -ForegroundColor Red
-    Write-Host "  Set `$env:PRIZMKIT_EFFORT to one of the above, or unset it to use the CLI default." -ForegroundColor Red
-    exit 1
-  }
-}
-
-function Start-PrizmProgressParser {
-  param(
-    [string[]]$PythonCommand,
-    [string]$ScriptsDir,
-    [string]$SessionLog,
-    [string]$ProgressFile,
-    [string]$CliCommand
-  )
-
-  if (-not (Test-PrizmStreamJsonSupport $CliCommand)) { return $null }
-
-  $parserScript = Join-Path $ScriptsDir 'parse-stream-progress.py'
-  if (-not (Test-Path $parserScript)) { return $null }
-
-  $cmd = $PythonCommand[0]
-  $prefix = @()
-  if ($PythonCommand.Count -gt 1) { $prefix = $PythonCommand[1..($PythonCommand.Count - 1)] }
-
-  $progressDir = Split-Path $ProgressFile -Parent
-  if ($progressDir) { New-Item -ItemType Directory -Force -Path $progressDir | Out-Null }
-
-  $psi = [System.Diagnostics.ProcessStartInfo]::new()
-  $psi.UseShellExecute = $false
-  $psi.CreateNoWindow = $true
-  $psi.FileName = $cmd
-  $psi.Arguments = Join-PrizmProcessArguments ($prefix + @($parserScript, '--session-log', $SessionLog, '--progress-file', $ProgressFile))
-  return [System.Diagnostics.Process]::Start($psi)
-}
-
-function Stop-PrizmProgressParser {
-  param($Process)
-  if ($Process -eq $null) { return }
-  try {
-    if (-not $Process.HasExited) {
-      try {
-        $Process.Kill($true)
-      } catch {
-        Stop-PrizmProcessTreeById -ProcessId ([int]$Process.Id)
-      }
-    }
-  } catch {}
-}
-
-function Stop-PrizmProcessTreeById {
-  param([int]$ProcessId)
-  if ($ProcessId -le 0) { return }
-
-  $process = Get-Process -Id $ProcessId -ErrorAction SilentlyContinue
-  if (-not $process) { return }
-
-  try {
-    $process.Kill($true)
-    return
-  } catch {
-    try {
-      $children = Get-CimInstance Win32_Process -Filter "ParentProcessId=$ProcessId" -ErrorAction SilentlyContinue
-      foreach ($child in $children) {
-        Stop-PrizmProcessTreeById -ProcessId ([int]$child.ProcessId)
-      }
-    } catch {
-      try {
-        $children = Get-WmiObject Win32_Process -Filter "ParentProcessId=$ProcessId" -ErrorAction SilentlyContinue
-        foreach ($child in $children) {
-          Stop-PrizmProcessTreeById -ProcessId ([int]$child.ProcessId)
-        }
-      } catch {}
-    }
-    try {
-      Stop-Process -Id $ProcessId -Force -ErrorAction SilentlyContinue
-    } catch {}
-  }
-}
-
-function Stop-PrizmSessionProcess {
-  param([string]$PidPath)
-  if (-not (Test-Path $PidPath)) { return }
-  $rawPid = Get-Content $PidPath -ErrorAction SilentlyContinue | Select-Object -First 1
-  $aiPid = 0
-  if ([int]::TryParse($rawPid, [ref]$aiPid)) {
-    Stop-PrizmProcessTreeById -ProcessId $aiPid
-  }
-}
-
-function Write-PrizmStaleKillMarker {
-  param([string]$MarkerPath, [int]$StaleSeconds, [int]$Threshold)
-  $markerDir = Split-Path $MarkerPath -Parent
-  if ($markerDir) { New-Item -ItemType Directory -Force -Path $markerDir | Out-Null }
-  [ordered]@{
-    killed_at = (Get-Date).ToUniversalTime().ToString('yyyy-MM-ddTHH:mm:ssZ')
-    reason = 'stale_session'
-    stale_seconds = $StaleSeconds
-    threshold = $Threshold
-  } | ConvertTo-Json -Compress | Set-Content -Path $MarkerPath -Encoding UTF8
-}
-
-function Invoke-PrizmAiSession {
-  param(
-    [string]$CliCommand,
-    [string]$PromptPath,
-    [string]$LogPath,
-    [string]$ProjectRoot,
-    [string]$Model = '',
-    [string]$PidPath = ''
-  )
-  $prompt = Get-Content $PromptPath -Raw
-  $logDir = Split-Path $LogPath -Parent
-  New-Item -ItemType Directory -Force -Path $logDir | Out-Null
-
-  $psi = [System.Diagnostics.ProcessStartInfo]::new()
-  $psi.UseShellExecute = $false
-  $psi.RedirectStandardInput = $true
-  $psi.RedirectStandardOutput = $true
-  $psi.RedirectStandardError = $true
-  $psi.WorkingDirectory = $ProjectRoot
-  [void]$psi.Environment.Remove('CLAUDECODE')
-  $cliArgs = @()
-  $parsedCli = Split-PrizmCommandLine $CliCommand
-  $cliExecutable = $parsedCli.Command
-  $sessionPlatform = Get-PrizmSessionPlatform $CliCommand
-  $useStreamJson = Test-PrizmStreamJsonSupport $CliCommand
-
-  if ($sessionPlatform -eq 'claude') {
-    $cliArgs += @('-p', '--dangerously-skip-permissions')
-    if ($env:VERBOSE -in @('1','true','yes','on') -or $useStreamJson) { $cliArgs += '--verbose' }
-    if ($useStreamJson) { $cliArgs += @('--output-format', 'stream-json') }
-    if ($env:PRIZMKIT_EFFORT) { $cliArgs += @('--effort', $env:PRIZMKIT_EFFORT) }
-    if ($Model) { $cliArgs += @('--model', $Model) }
-  } elseif ($sessionPlatform -eq 'codex') {
-    $cliArgs += @('--ask-for-approval', 'never', '--sandbox', 'danger-full-access')
-    $codexSubagentTimeout = Get-PrizmCodexSubagentTimeoutSeconds
-    if ($codexSubagentTimeout -gt 0) {
-      $cliArgs += @('--config', "agents.job_max_runtime_seconds=$codexSubagentTimeout")
-    }
-    $cliArgs += @('exec', '--cd', $ProjectRoot, '--skip-git-repo-check')
-    if ($useStreamJson) { $cliArgs += '--json' }
-    if ($Model) { $cliArgs += @('--model', $Model) }
-    if ($env:PRIZMKIT_EFFORT) { $cliArgs += @('--config', "model_reasoning_effort=$env:PRIZMKIT_EFFORT") }
-    $cliArgs += '-'
-  } else {
-    $cliArgs += @('--print', '-y')
-    if ($env:VERBOSE -in @('1','true','yes','on')) { $cliArgs += '--verbose' }
-    if ($useStreamJson) { $cliArgs += @('--output-format', 'stream-json') }
-    if ($env:PRIZMKIT_EFFORT) { $cliArgs += @('--effort', $env:PRIZMKIT_EFFORT) }
-    if ($Model) { $cliArgs += @('--model', $Model) }
-  }
-  $generatedArgs = (($cliArgs | ForEach-Object { ConvertTo-PrizmProcessArgument $_ }) -join ' ')
-  $fullArgs = @()
-  if ($parsedCli.Arguments) { $fullArgs += $parsedCli.Arguments }
-  if ($generatedArgs) { $fullArgs += $generatedArgs }
-  $argumentString = ($fullArgs -join ' ')
-
-  $cliExtension = [System.IO.Path]::GetExtension($cliExecutable).ToLowerInvariant()
-
-  if ($cliExtension -in @('.cmd', '.bat')) {
-    $psi.FileName = if ($env:ComSpec) { $env:ComSpec } else { 'cmd.exe' }
-    $childCommand = (ConvertTo-PrizmProcessArgument $cliExecutable)
-    if ($argumentString) { $childCommand = "$childCommand $argumentString" }
-    $psi.Arguments = '/d /s /c "' + $childCommand + '"'
-  } elseif ($cliExtension -eq '.ps1') {
-    $psi.FileName = Resolve-PrizmPowerShellHost
-    $scriptArgs = @('-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', $cliExecutable)
-    $scriptArgumentString = Join-PrizmProcessArguments $scriptArgs
-    if ($argumentString) { $scriptArgumentString = "$scriptArgumentString $argumentString" }
-    $psi.Arguments = $scriptArgumentString
-  } else {
-    $psi.FileName = $cliExecutable
-    $psi.Arguments = $argumentString
-  }
-
-  Initialize-PrizmLineLogBridgeType
-  $process = [System.Diagnostics.Process]::Start($psi)
-  $script:PrizmAiProcess = $process
-  $logBridge = [PrizmLineLogBridge]::new($LogPath)
-  $process.add_OutputDataReceived($logBridge.Handler)
-  $process.add_ErrorDataReceived($logBridge.Handler)
-  if ($PidPath) {
-    $pidDir = Split-Path $PidPath -Parent
-    if ($pidDir) { New-Item -ItemType Directory -Force -Path $pidDir | Out-Null }
-    Set-Content -Path $PidPath -Value ([string]$process.Id) -Encoding UTF8
-  }
-  try {
-    $process.BeginOutputReadLine()
-    $process.BeginErrorReadLine()
-    $process.StandardInput.Write($prompt)
-    $process.StandardInput.Close()
-    $process.WaitForExit()
-    $process.WaitForExit()
-    return $process.ExitCode
-  } finally {
-    $process.remove_OutputDataReceived($logBridge.Handler)
-    $process.remove_ErrorDataReceived($logBridge.Handler)
-    $logBridge.Dispose()
-  }
-}
-
-function New-PrizmSessionId {
-  param([string]$Prefix)
-  return "$Prefix-$(Get-Date -Format 'yyyyMMdd-HHmmss')-$([guid]::NewGuid().ToString('N').Substring(0, 8))"
-}
-
-function Get-PrizmListDefault {
-  param([string]$Kind, [string]$ProjectRoot)
-  switch ($Kind) {
-    'feature' { return Join-Path $ProjectRoot '.prizmkit\plans\feature-list.json' }
-    'bugfix' { return Join-Path $ProjectRoot '.prizmkit\plans\bug-fix-list.json' }
-    'refactor' { return Join-Path $ProjectRoot '.prizmkit\plans\refactor-list.json' }
-    default { throw "Unknown pipeline kind: $Kind" }
-  }
-}
-
-function Get-PrizmStateDir {
-  param([string]$Kind, [string]$ProjectRoot)
-  switch ($Kind) {
-    'feature' { return Join-Path $ProjectRoot '.prizmkit\state\features' }
-    'bugfix' { return Join-Path $ProjectRoot '.prizmkit\state\bugfix' }
-    'refactor' { return Join-Path $ProjectRoot '.prizmkit\state\refactor' }
-    default { throw "Unknown pipeline kind: $Kind" }
-  }
-}