prizmkit 1.1.98 → 1.1.100

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

@@ -50,8 +50,7 @@ function Invoke-PrizmPipeline {
     Write-Host ""
     Write-Host "Environment Variables:"
     Write-Host "  PRIZMKIT_EFFORT       AI reasoning effort (low|medium|high|xhigh|max; max is Claude Code only)"
-    Write-Host "  MAX_LOG_SIZE          Session log size threshold for compact warning (default: 2097152 = 2MB, set 0 to disable)"
-    Write-Host "  LOG_MONITOR_POLL_INTERVAL  Log monitor poll interval in seconds (default: 30)"
+    Write-Host "  MAX_LOG_SIZE          Include passive log-size checkpoint guidance above this threshold (default: 2097152 = 2MB, set 0 to disable)"
     $global:PRIZM_EXIT_CODE = 0
     return
   }
@@ -626,7 +625,10 @@ function Invoke-PrizmPipeline {
   }
 
   function Invoke-PrizmPipelineItem {
-    param([string]$CurrentItemId)
+    param(
+      [string]$CurrentItemId,
+      [object]$ContinuationState = $null
+    )
     $script:PRIZM_ITEM_EXIT_CODE = 0
 
     $sessionId = New-PrizmSessionId $Kind
@@ -636,6 +638,27 @@ function Invoke-PrizmPipeline {
     $isGitRepository = if (-not $dryRun) { Test-PrizmGitRepository $paths.ProjectRoot } else { $false }
     $originalBranch = if ($isGitRepository) { Get-PrizmCurrentBranch $paths.ProjectRoot } else { '' }
     $devBranchName = ''
+    $activeDevBranch = ''
+    $continuationPending = $false
+    $continuationReason = ''
+    $contextOverflowCount = 0
+    $continuationCount = 0
+    $previousSessionId = ''
+    $noProgressCount = 0
+    if ($ContinuationState) {
+      if ($ContinuationState.PSObject.Properties['active_dev_branch'] -and $ContinuationState.active_dev_branch) { $activeDevBranch = [string]$ContinuationState.active_dev_branch }
+      if ($ContinuationState.PSObject.Properties['base_branch'] -and $ContinuationState.base_branch) { $originalBranch = [string]$ContinuationState.base_branch }
+      if ($ContinuationState.PSObject.Properties['continuation_pending']) { $continuationPending = [bool]$ContinuationState.continuation_pending }
+      if ($ContinuationState.PSObject.Properties['continuation_reason'] -and $ContinuationState.continuation_reason) { $continuationReason = [string]$ContinuationState.continuation_reason }
+      if ($ContinuationState.PSObject.Properties['context_overflow_count'] -and $ContinuationState.context_overflow_count -ne $null) { $contextOverflowCount = [int]$ContinuationState.context_overflow_count }
+      if ($ContinuationState.PSObject.Properties['continuation_count'] -and $ContinuationState.continuation_count -ne $null) { $continuationCount = [int]$ContinuationState.continuation_count }
+      if ($ContinuationState.PSObject.Properties['last_context_overflow_session_id'] -and $ContinuationState.last_context_overflow_session_id) { $previousSessionId = [string]$ContinuationState.last_context_overflow_session_id }
+      if ($ContinuationState.PSObject.Properties['no_progress_count'] -and $ContinuationState.no_progress_count -ne $null) { $noProgressCount = [int]$ContinuationState.no_progress_count }
+    }
+    if ($continuationPending -and $activeDevBranch) {
+      Write-PrizmInfo "Continuation pending ($continuationReason); reusing dev branch: $activeDevBranch"
+      Write-PrizmInfo "Continuation count: $continuationCount (context overflows: $contextOverflowCount)"
+    }
     $hadDirtyBaseline = if ($isGitRepository) { Test-PrizmGitWorkDirty $paths.ProjectRoot $stateDir $listPath } else { $false }
     if ($hadDirtyBaseline) {
       if ($dryRun) {
@@ -647,7 +670,7 @@ function Invoke-PrizmPipeline {
     }
 
     if ($dryRun) {
-      $statusPath = Join-Path $stateDir "$($idName)s\$CurrentItemId\status.json"
+      $statusPath = Join-Path $stateDir "$CurrentItemId\status.json"
       if (Test-Path $statusPath) {
         try {
           $itemStatus = Get-Content -Raw $statusPath | ConvertFrom-Json
@@ -664,7 +687,7 @@ function Invoke-PrizmPipeline {
 
       if ($isGitRepository -and $originalBranch) {
         Invoke-PrizmGitCommitPath $paths.ProjectRoot $listPath "chore($CurrentItemId): mark in_progress" | Out-Null
-        $candidateBranch = if ($devBranchOverride) { $devBranchOverride } else { New-PrizmDefaultDevBranchName $Kind $CurrentItemId }
+        $candidateBranch = if ($devBranchOverride) { $devBranchOverride } elseif ($continuationPending -and $activeDevBranch) { $activeDevBranch } else { New-PrizmDefaultDevBranchName $Kind $CurrentItemId }
         if (New-PrizmDevBranch $paths.ProjectRoot $candidateBranch $originalBranch) {
           $devBranchName = $candidateBranch
           Write-PrizmInfo "Dev branch: $devBranchName"
@@ -679,10 +702,11 @@ function Invoke-PrizmPipeline {
 
     $baseCommit = if ($isGitRepository) { Get-PrizmGitHead $paths.ProjectRoot } else { '' }
 
+    while ($true) {
     $sessionDir = if ($dryRun) {
       Join-Path ([System.IO.Path]::GetTempPath()) "prizmkit-dry-run\$sessionId"
     } else {
-      Join-Path $stateDir "$($idName)s\$CurrentItemId\sessions\$sessionId"
+      Join-Path $stateDir "$CurrentItemId\sessions\$sessionId"
     }
     $logsDir = Join-Path $sessionDir 'logs'
     New-Item -ItemType Directory -Force -Path $logsDir | Out-Null
@@ -697,6 +721,15 @@ function Invoke-PrizmPipeline {
     }
 
     $promptArgs = @((Join-Path $paths.ScriptsDir $promptScript), $listOption, $listPath, $idOption, $CurrentItemId, '--session-id', $sessionId, '--run-id', $runId, '--retry-count', $retryCount, '--resume-phase', $resumePhase, '--state-dir', $stateDir, '--output', $promptPath)
+    $continuationSummaryPath = ".prizmkit/$Kind/$CurrentItemId/continuation-summary.md"
+    if ($Kind -eq 'feature') {
+      $featureSlug = Get-PrizmFeatureSlugFromList $listPath $CurrentItemId
+      if ($featureSlug) { $continuationSummaryPath = ".prizmkit/specs/$featureSlug/continuation-summary.md" }
+    }
+    if ($continuationPending) {
+      $modeForContinuation = if ($continuationReason) { $continuationReason } else { 'context_overflow' }
+      $promptArgs += @('--continuation-mode', $modeForContinuation, '--previous-session-id', $previousSessionId, '--continuation-count', [string]$continuationCount, '--context-overflow-count', [string]$contextOverflowCount, '--task-type', $Kind, '--active-dev-branch', $activeDevBranch, '--base-branch', $originalBranch, '--continuation-summary-path', $continuationSummaryPath)
+    }
     if ($mode) { $promptArgs += @('--mode', $mode) }
     if ($critic) { $promptArgs += @('--critic', $critic) }
     if ($dryRun) { $promptArgs += '--no-checkpoint' }
@@ -717,6 +750,10 @@ function Invoke-PrizmPipeline {
 
     Write-PrizmInfo "Starting $cli session for $CurrentItemId ($sessionId)"
 
+    $artifactDirForFingerprint = if ($Kind -eq 'feature') { Split-Path $continuationSummaryPath -Parent } else { ".prizmkit/$Kind/$CurrentItemId" }
+    $checkpointForFingerprint = Join-Path $artifactDirForFingerprint 'workflow-checkpoint.json'
+    $progressBefore = Get-PrizmContextProgressFingerprint -ProjectRoot $paths.ProjectRoot -TaskType $Kind -TaskId $CurrentItemId -ArtifactDir $artifactDirForFingerprint -CheckpointFile $checkpointForFingerprint
+
     $progressJson = Join-Path $logsDir 'progress.json'
     $parserProcess = Start-PrizmProgressParser -PythonCommand $python -ScriptsDir $paths.ScriptsDir -SessionLog $sessionLog -ProgressFile $progressJson -CliCommand $cli
 
@@ -798,22 +835,34 @@ function Invoke-PrizmPipeline {
     }
     Stop-PrizmProgressParser $parserProcess
 
+    $wasContextOverflow = Test-PrizmContextOverflowError -SessionLog $sessionLog -ProgressJson $progressJson
     $wasInfraError = ($exitCode -ne 0 -and (Test-PrizmInfraError -SessionLog $sessionLog -ProgressJson $progressJson))
     $wasAiRuntimeError = Test-PrizmAiRuntimeError -SessionLog $sessionLog -ProgressJson $progressJson
     $semanticCompletion = if ($Kind -eq 'feature' -and $isGitRepository) {
       Get-PrizmFeatureSemanticCompletion $paths.ProjectRoot $listPath $CurrentItemId $baseCommit $paths.PrizmkitDir
     } else { $null }
 
+    $hasSuccessfulCommit = $false
+    if ($Kind -ne 'feature' -and $isGitRepository) {
+      $hasSuccessfulCommit = Test-PrizmGitCommitsSince $paths.ProjectRoot $baseCommit
+    }
+
     $status = 'crashed'
     if ($semanticCompletion) {
       $status = 'success'
-      if ($exitCode -ne 0 -or $wasStaleKilled -or $wasAiRuntimeError) {
+      if ($exitCode -ne 0 -or $wasStaleKilled -or $wasContextOverflow -or $wasAiRuntimeError) {
         Write-PrizmWarn "Session ended with a failure signal after semantic completion; treating as finalized success"
         Write-PrizmWarn "Semantic completion commit: $($semanticCompletion.CommitSha)"
       }
+    } elseif ($hasSuccessfulCommit) {
+      $status = 'success'
+    } elseif ($wasContextOverflow) {
+      $status = 'context_overflow'
+      Write-PrizmWarn "AI session failed because the AI CLI exceeded the model context window"
+      Write-PrizmWarn "Context overflow is retried without consuming code retry budget"
     } elseif ($wasAiRuntimeError) {
       $status = 'infra_error'
-      Write-PrizmWarn "AI session failed due to structured AI runtime/context error"
+      Write-PrizmWarn "AI session failed due to structured AI runtime error"
       Write-PrizmWarn "AI runtime errors are retried without consuming code retry budget"
     } elseif ($wasInfraError) {
       $status = 'infra_error'
@@ -841,6 +890,38 @@ function Invoke-PrizmPipeline {
 
     $mergeSucceeded = $true
     $itemListStatus = ''
+    $activeDevBranchForStatus = $devBranchName
+    $progressAfter = ''
+    $statusContinuationArgs = @('--active-dev-branch', $activeDevBranchForStatus, '--base-branch', $originalBranch, '--last-fatal-error-code', 'context_overflow', '--continuation-summary-path', $continuationSummaryPath)
+    if ($status -eq 'context_overflow') {
+      $progressAfter = Get-PrizmContextProgressFingerprint -ProjectRoot $paths.ProjectRoot -TaskType $Kind -TaskId $CurrentItemId -ArtifactDir $artifactDirForFingerprint -CheckpointFile $checkpointForFingerprint
+      if (Test-PrizmContextProgressChanged -BeforeJson $progressBefore -AfterJson $progressAfter) {
+        $noProgressCount = 0
+        Write-PrizmInfo "Context-overflow session made observable progress; continuing on $devBranchName"
+      } else {
+        $noProgressCount++
+        Write-PrizmWarn "Context-overflow session made no observable progress ($noProgressCount consecutive)"
+      }
+      $statusContinuationArgs = @('--active-dev-branch', $activeDevBranchForStatus, '--base-branch', $originalBranch, '--last-fatal-error-code', 'context_overflow', '--continuation-summary-path', $continuationSummaryPath, '--no-progress-count', [string]$noProgressCount, '--progress-fingerprint', $progressAfter)
+      if ($noProgressCount -ge 2) {
+        Write-PrizmWarn 'Pausing automatic continuation: context_overflow_without_git_checkpoint_or_artifact_progress'
+        $status = 'stalled_context_continuation'
+      } else {
+        $updateResult = Invoke-PrizmPythonJson $python (@((Join-Path $paths.ScriptsDir $updateScript), $listOption, $listPath, '--state-dir', $stateDir, '--action', 'update', $idOption, $CurrentItemId, '--session-id', $sessionId, '--session-status', 'context_overflow') + $maxRetryArgs + $maxInfraRetryArgs + $statusContinuationArgs)
+        if ($updateResult -and $updateResult.PSObject.Properties['new_status']) { $itemListStatus = [string]$updateResult.new_status }
+        $continuationPending = $true
+        $continuationReason = 'context_overflow'
+        $previousSessionId = $sessionId
+        $activeDevBranch = $devBranchName
+        $contextOverflowCount++
+        $continuationCount++
+        $sessionId = New-PrizmSessionId $Kind
+        $runId = "run-$(Get-Date -Format 'yyyyMMdd-HHmmss')"
+        Write-PrizmInfo "Launching automatic continuation for $CurrentItemId on same branch/worktree"
+        continue
+      }
+    }
+
     if ($status -eq 'success') {
       if (Test-PrizmGitDirty $paths.ProjectRoot) {
         Write-PrizmInfo "Auto-committing remaining session artifacts."
@@ -848,7 +929,7 @@ function Invoke-PrizmPipeline {
       }
 
       if ($status -eq 'success') {
-        $updateResult = Invoke-PrizmPythonJson $python (@((Join-Path $paths.ScriptsDir $updateScript), $listOption, $listPath, '--state-dir', $stateDir, '--action', 'update', $idOption, $CurrentItemId, '--session-id', $sessionId, '--session-status', $status) + $maxRetryArgs + $maxInfraRetryArgs)
+        $updateResult = Invoke-PrizmPythonJson $python (@((Join-Path $paths.ScriptsDir $updateScript), $listOption, $listPath, '--state-dir', $stateDir, '--action', 'update', $idOption, $CurrentItemId, '--session-id', $sessionId, '--session-status', $status) + $maxRetryArgs + $maxInfraRetryArgs + $statusContinuationArgs)
         if ($updateResult -and $updateResult.PSObject.Properties['new_status']) {
           $itemListStatus = [string]$updateResult.new_status
         }
@@ -885,7 +966,7 @@ function Invoke-PrizmPipeline {
           Write-PrizmRuntimeFailureLog $failureLog $CurrentItemId $sessionId $status $exitCode $staleKillMarker $progressJson $checkpointPath $paths.ProjectRoot $baseCommit
         }
       }
-      $updateResult = Invoke-PrizmPythonJson $python (@((Join-Path $paths.ScriptsDir $updateScript), $listOption, $listPath, '--state-dir', $stateDir, '--action', 'update', $idOption, $CurrentItemId, '--session-id', $sessionId, '--session-status', $status) + $maxRetryArgs + $maxInfraRetryArgs)
+      $updateResult = Invoke-PrizmPythonJson $python (@((Join-Path $paths.ScriptsDir $updateScript), $listOption, $listPath, '--state-dir', $stateDir, '--action', 'update', $idOption, $CurrentItemId, '--session-id', $sessionId, '--session-status', $status) + $maxRetryArgs + $maxInfraRetryArgs + $statusContinuationArgs)
       if ($updateResult -and $updateResult.PSObject.Properties['new_status']) {
         $itemListStatus = [string]$updateResult.new_status
       }
@@ -894,6 +975,9 @@ function Invoke-PrizmPipeline {
       }
     }
 
+    break
+    }
+
     if ($status -eq 'success' -and $mergeSucceeded) {
       Write-PrizmSuccess "$Kind item completed: $CurrentItemId"
     } else {
@@ -951,7 +1035,7 @@ function Invoke-PrizmPipeline {
     }
 
     $processedCount++
-    Invoke-PrizmPipelineItem $nextItemId
+    Invoke-PrizmPipelineItem $nextItemId $next
     $lastExitCode = $script:PRIZM_ITEM_EXIT_CODE
     if ($dryRun) {
       $global:PRIZM_EXIT_CODE = $lastExitCode

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

@@ -14,6 +14,35 @@ function Get-PrizmFeatureSlug {
   return "$numeric-$slug"
 }
 
+function Write-PrizmContinuationResetWarning {
+  param([string]$StatusPath, [string]$ItemId, [string]$Label)
+  if (-not (Test-Path $StatusPath)) { return }
+  try {
+    $status = Get-Content $StatusPath -Raw | ConvertFrom-Json
+  } catch {
+    return
+  }
+  if ($status.continuation_pending -eq $true) {
+    $reason = $status.continuation_reason
+    if (-not $reason) { $reason = 'context_overflow' }
+    Write-PrizmWarn "Continuation pending for $Label $ItemId ($reason). Manual reset will abandon automatic continuation progress."
+    if ($status.active_dev_branch) {
+      Write-PrizmWarn "Pending continuation branch: $($status.active_dev_branch)"
+    }
+  }
+}
+
+function Write-PrizmContinuationResetWarningsForState {
+  param([string]$StateDir, [string]$Label)
+  if (-not (Test-Path $StateDir)) { return }
+  Get-ChildItem -Path $StateDir -Directory -ErrorAction SilentlyContinue | ForEach-Object {
+    Write-PrizmContinuationResetWarning `
+      -StatusPath (Join-Path $_.FullName 'status.json') `
+      -ItemId $_.Name `
+      -Label $Label
+  }
+}
+
 function Invoke-PrizmReset {
   param(
     [ValidateSet('feature','bugfix','refactor')][string]$Kind,
@@ -60,6 +89,7 @@ function Invoke-PrizmReset {
   }
 
   if (-not $itemId) {
+    Write-PrizmContinuationResetWarningsForState -StateDir $stateDir -Label $label
     & (Join-Path $paths.PipelineDir $runScript) reset
     $global:PRIZM_RESET_EXIT_CODE = $LASTEXITCODE
     return
@@ -67,6 +97,10 @@ function Invoke-PrizmReset {
 
   if (-not (Test-Path $listPath)) { throw "List file not found: $listPath" }
   New-Item -ItemType Directory -Force -Path $stateDir | Out-Null
+  Write-PrizmContinuationResetWarning `
+    -StatusPath (Join-Path (Join-Path $stateDir $itemId) 'status.json') `
+    -ItemId $itemId `
+    -Label $label
 
   $action = if ($clean) { 'clean' } else { 'reset' }
   $resetArgs = @((Join-Path $paths.ScriptsDir $updateScript), $listOption, $listPath, '--state-dir', $stateDir, '--action', $action, $idOption, $itemId)

package/bundled/dev-pipeline-windows/reset-bug.ps1

@@ -1,4 +1,5 @@
 #!/usr/bin/env pwsh
+# Manual reset entrypoint; shared warning/reset behavior lives in lib/reset.ps1.
 . "$PSScriptRoot\lib\reset.ps1"
 try {
   Invoke-PrizmReset -Kind bugfix -ScriptRoot $PSScriptRoot -Args $args

package/bundled/dev-pipeline-windows/reset-feature.ps1

@@ -1,4 +1,5 @@
 #!/usr/bin/env pwsh
+# Manual reset entrypoint; shared warning/reset behavior lives in lib/reset.ps1.
 . "$PSScriptRoot\lib\reset.ps1"
 try {
   Invoke-PrizmReset -Kind feature -ScriptRoot $PSScriptRoot -Args $args

package/bundled/dev-pipeline-windows/reset-refactor.ps1

@@ -1,4 +1,5 @@
 #!/usr/bin/env pwsh
+# Manual reset entrypoint; shared warning/reset behavior lives in lib/reset.ps1.
 . "$PSScriptRoot\lib\reset.ps1"
 try {
   Invoke-PrizmReset -Kind refactor -ScriptRoot $PSScriptRoot -Args $args

package/bundled/dev-pipeline-windows/scripts/check-session-status.py

@@ -22,6 +22,77 @@ ID_FIELDS = ["feature_id", "bug_id", "refactor_id"]
 
 LOGGER = setup_logging("check-session-status")
 
+CONTEXT_OVERFLOW_CODE = "context_overflow"
+CONTEXT_CODE_VALUES = {
+    "context_overflow",
+    "context_too_large",
+    "context_length_exceeded",
+    "model_context_window_exceeded",
+}
+CONTEXT_TEXT_PATTERNS = (
+    "input exceeds the context window",
+    "context window of this model",
+    "context window exceeded",
+    "maximum context length exceeded",
+    "prompt is too long",
+    "too many tokens",
+    "input token count exceeds",
+)
+REQUEST_TOO_LARGE_TEXT = "request too large"
+REQUEST_TOO_LARGE_SEMANTICS = ("context", "token", "tokens", "prompt", "input", "model")
+ERROR_LIKE_STATUSES = {"failed", "crashed", "timed_out", "context_overflow"}
+
+
+def _flatten_values(value):
+    if isinstance(value, dict):
+        values = []
+        for child in value.values():
+            values.extend(_flatten_values(child))
+        return values
+    if isinstance(value, list):
+        values = []
+        for child in value:
+            values.extend(_flatten_values(child))
+        return values
+    if value is None:
+        return []
+    return [str(value)]
+
+
+def _is_error_like_status(data):
+    status = str(data.get("status", "")).lower()
+    if status in ERROR_LIKE_STATUSES:
+        return True
+    if data.get("last_result_is_error") is True or data.get("is_error") is True:
+        return True
+    if data.get("api_error_status") not in (None, ""):
+        return True
+    errors = data.get("errors")
+    return isinstance(errors, list) and len(errors) > 0
+
+
+def has_context_overflow_signal(data):
+    """Return true when session-status data carries a context overflow signal.
+
+    Success remains success: direct status handling happens before this helper.
+    Exact machine codes are accepted only from structured code fields. Natural
+    language context/token phrases require a failed/error-like status or an
+    explicit error field to avoid prompt/documentation false positives.
+    """
+    if not isinstance(data, dict):
+        return False
+    for field in ("fatal_error_code", "api_error_code", "error_code", "stop_reason"):
+        value = data.get(field)
+        if isinstance(value, str) and value.lower() in CONTEXT_CODE_VALUES:
+            return True
+    if not _is_error_like_status(data):
+        return False
+    text = " ".join(_flatten_values(data)).lower()
+    if any(pattern in text for pattern in CONTEXT_TEXT_PATTERNS):
+        return True
+    return REQUEST_TOO_LARGE_TEXT in text and any(
+        semantic in text for semantic in REQUEST_TOO_LARGE_SEMANTICS
+    )
 
 def parse_args():
     parser = argparse.ArgumentParser(
@@ -79,12 +150,14 @@ def determine_status(data):
     """Determine the single-line status string from the parsed data.
 
     Returns one of: success, partial_resumable, partial_not_resumable,
-    failed, commit_missing, docs_missing, merge_conflict.
+    failed, commit_missing, docs_missing, merge_conflict, context_overflow.
     """
     status = data.get("status", "")
 
     if status == "success":
         return "success"
+    if status == "context_overflow" or has_context_overflow_signal(data):
+        return "context_overflow"
     elif status == "partial":
         can_resume = data.get("can_resume", False)
         if can_resume: