prizmkit 1.1.90 → 1.1.91

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.1.90",
-  "bundledAt": "2026-07-01T16:16:33.956Z",
-  "bundledFrom": "917deef"
+  "frameworkVersion": "1.1.91",
+  "bundledAt": "2026-07-01T17:51:47.362Z",
+  "bundledFrom": "5dcb047"
 }

package/bundled/dev-pipeline/lib/heartbeat.sh

@@ -43,6 +43,8 @@ start_heartbeat() {
         local prev_size=0
         local prev_max_size=0
         local prev_child_activity_signature=""
+        local prev_progress_signature=""
+        local prev_error_loop_signature=""
         local stale_seconds=0
         while kill -0 "$cli_pid" 2>/dev/null; do
             sleep "$heartbeat_interval"
@@ -77,9 +79,10 @@ start_heartbeat() {
             local child_activity_signature=""
             local child_total_bytes=0
             local child_session_count=0
+            local progress_signature=""
             if [[ -f "$progress_json" ]]; then
-                local child_activity_data
-                child_activity_data=$(python3 - "$progress_json" <<'PY' 2>/dev/null || true
+                local progress_activity_data
+                progress_activity_data=$(python3 - "$progress_json" <<'PY' 2>/dev/null || true
 import json
 import sys
 
@@ -89,14 +92,31 @@ try:
 except Exception:
     sys.exit(0)
 
-signature = str(progress.get("child_activity_signature") or "")
+child_signature = str(progress.get("child_activity_signature") or "")
 total_bytes = int(progress.get("child_total_bytes") or 0)
 session_count = len(progress.get("child_session_files") or [])
-print(f"{signature}\t{total_bytes}\t{session_count}")
+progress_signature = json.dumps(
+    [
+        progress.get("current_phase") or "",
+        progress.get("current_tool") or "",
+        int(progress.get("message_count") or 0),
+        int(progress.get("total_tool_calls") or 0),
+        int(progress.get("active_subagent_count") or 0),
+        int(progress.get("subagent_spawn_count") or 0),
+        child_signature,
+        total_bytes,
+        session_count,
+        progress.get("fatal_error_code") or "",
+        progress.get("terminal_result_text") or "",
+    ],
+    separators=(",", ":"),
+)
+sep = "\x1f"
+print(sep.join([child_signature, str(total_bytes), str(session_count), progress_signature]))
 PY
                 )
-                if [[ -n "$child_activity_data" ]]; then
-                    IFS=$'\t' read -r child_activity_signature child_total_bytes child_session_count <<< "$child_activity_data"
+                if [[ -n "$progress_activity_data" ]]; then
+                    IFS=$'\037' read -r child_activity_signature child_total_bytes child_session_count progress_signature <<< "$progress_activity_data"
                 fi
             fi
 
@@ -106,6 +126,12 @@ PY
             fi
             prev_child_activity_signature="$child_activity_signature"
 
+            local progress_advanced=0
+            if [[ -n "$progress_signature" && "$progress_signature" != "$prev_progress_signature" ]]; then
+                progress_advanced=1
+            fi
+            prev_progress_signature="$progress_signature"
+
             local effective_stale_kill_threshold="$stale_kill_threshold"
             if [[ $stale_kill_threshold -gt 0 && -f "$progress_json" ]]; then
                 local extended_threshold
@@ -172,8 +198,11 @@ PY
 
             # Check for error-loop: agent is actively producing output but results are
             # all read-offset errors or wasted calls. This is a stuck agent that appears
-            # "active" by log growth but is accomplishing nothing.
+            # "active" by log growth but is accomplishing nothing. Only a newly advancing
+            # error signature counts; stale historical errors must not turn later normal
+            # output into a stale kill.
             local error_loop_detected=false
+            local error_loop_signature=""
             if [[ $effective_stale_kill_threshold -gt 0 && $growth -gt 0 && -f "$progress_json" ]]; then
                 local error_loop_flag
                 error_loop_flag=$(python3 - "$progress_json" <<'PY' 2>/dev/null || true
@@ -187,33 +216,38 @@ errors = progress.get("errors", [])
 if isinstance(errors, list) and len(errors) >= 5:
     recent = errors[-5:]
     if all(isinstance(e, dict) and e.get("type") in ("read_offset_overflow", "wasted_call") for e in recent):
-        print("error_loop")
+        print(json.dumps(recent, sort_keys=True, separators=(",", ":")))
 PY
                 )
-                if [[ "$error_loop_flag" == "error_loop" ]]; then
-                    error_loop_detected=true
+                if [[ -n "$error_loop_flag" ]]; then
+                    error_loop_signature="$error_loop_flag"
+                    if [[ -n "$prev_error_loop_signature" && "$error_loop_signature" != "$prev_error_loop_signature" ]]; then
+                        error_loop_detected=true
+                    fi
                 fi
             fi
+            prev_error_loop_signature="$error_loop_signature"
 
             # Track progress staleness. Parent sessions can sit in a wait/polling
-            # tool while child transcripts keep growing, so child activity counts.
-            # Error loops bypass normal growth-as-progress because the log is only
-            # growing with repeated failed reads or wasted calls.
+            # tool while child transcripts or structured progress counters keep
+            # advancing, so both child activity and progress.json state changes
+            # count as progress. Error loops bypass normal growth-as-progress
+            # because the log is only growing with repeated failed reads or wasted
+            # calls.
             #
             # When the main session log has been truncated (e.g. by subagent stdout
-            # redirection severing the file descriptor), use child activity as the
-            # primary progress signal — the parent process is still running and children
-            # are still producing output, so this is not a true stall.
+            # redirection severing the file descriptor), use structured progress and
+            # child activity as the primary progress signals — the parent process is
+            # still running and children may still be producing output.
             if [[ "$error_loop_detected" == "true" ]]; then
                 stale_seconds=$effective_stale_kill_threshold
             elif [[ "$log_truncated" == "true" ]]; then
-                # Log truncated: rely on child growth and CLI process liveness.
-                # Don't increment staleness — the process is still working.
-                if [[ $child_growth -gt 0 ]]; then
+                if [[ $progress_advanced -gt 0 || $child_growth -gt 0 ]]; then
                     stale_seconds=0
+                else
+                    stale_seconds=$((stale_seconds + heartbeat_interval))
                 fi
-                # If neither log nor children grow, this is a real stall
-            elif [[ $growth -le 0 && $child_growth -eq 0 ]]; then
+            elif [[ $growth -le 0 && $child_growth -eq 0 && $progress_advanced -eq 0 ]]; then
                 stale_seconds=$((stale_seconds + heartbeat_interval))
             else
                 stale_seconds=0
@@ -251,7 +285,7 @@ PY
             local status_icon
             if $log_truncated; then
                 status_icon="${RED}⚠${NC}"
-            elif [[ $growth -gt 0 || $child_growth -gt 0 ]]; then
+            elif [[ $growth -gt 0 || $child_growth -gt 0 || $progress_advanced -gt 0 ]]; then
                 status_icon="${GREEN}▶${NC}"
             else
                 status_icon="${YELLOW}⏸${NC}"

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

@@ -467,13 +467,14 @@ function Get-PrizmEffectiveStaleKillThreshold {
   return [Math]::Max($BaseThreshold * 4, 3600)
 }
 
-function Get-PrizmProgressChildActivity {
+function Get-PrizmProgressActivity {
   param([string]$ProgressFile)
 
   $empty = [pscustomobject]@{
-    Signature = ''
-    TotalBytes = 0
-    SessionCount = 0
+    ChildSignature = ''
+    ChildTotalBytes = 0
+    ChildSessionCount = 0
+    ProgressSignature = ''
   }
   if (-not (Test-Path $ProgressFile)) { return $empty }
 
@@ -483,25 +484,72 @@ function Get-PrizmProgressChildActivity {
     return $empty
   }
 
-  $signature = ''
+  $childSignature = ''
   if ($progress.PSObject.Properties['child_activity_signature'] -and $progress.child_activity_signature) {
-    $signature = [string]$progress.child_activity_signature
+    $childSignature = [string]$progress.child_activity_signature
   }
 
-  $totalBytes = [int64]0
+  $childTotalBytes = [int64]0
   if ($progress.PSObject.Properties['child_total_bytes']) {
-    [int64]::TryParse([string]$progress.child_total_bytes, [ref]$totalBytes) | Out-Null
+    [int64]::TryParse([string]$progress.child_total_bytes, [ref]$childTotalBytes) | Out-Null
   }
 
-  $sessionCount = 0
+  $childSessionCount = 0
   if ($progress.PSObject.Properties['child_session_files'] -and $progress.child_session_files) {
-    $sessionCount = @($progress.child_session_files).Count
+    $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 = $signature
-    TotalBytes = $totalBytes
-    SessionCount = $sessionCount
+    Signature = $activity.ChildSignature
+    TotalBytes = $activity.ChildTotalBytes
+    SessionCount = $activity.ChildSessionCount
   }
 }
 

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

@@ -740,7 +740,9 @@ function Invoke-PrizmPipeline {
     $elapsedSeconds = 0
     $staleSeconds = 0
     $previousLogSize = 0
+    $previousProgressSignature = ''
     $previousChildActivitySignature = ''
+    $previousErrorLoopSignature = ''
     $wasTimedOut = $false
     $staleKillMarker = Join-Path $logsDir 'stale-kill.json'
     $wasStaleKilled = $false
@@ -758,16 +760,22 @@ function Invoke-PrizmPipeline {
       $growth = $currentLogSize - $previousLogSize
       $previousLogSize = $currentLogSize
 
-      $childActivity = Get-PrizmProgressChildActivity -ProgressFile $progressJson
-      $childSignature = [string]$childActivity.Signature
+      $progressActivity = Get-PrizmProgressActivity -ProgressFile $progressJson
+      $progressSignature = [string]$progressActivity.ProgressSignature
+      $progressAdvanced = ($progressSignature -and $progressSignature -ne $previousProgressSignature)
+      $previousProgressSignature = $progressSignature
+      $childSignature = [string]$progressActivity.ChildSignature
       $childAdvanced = ($childSignature -and $childSignature -ne $previousChildActivitySignature)
       $previousChildActivitySignature = $childSignature
 
       $effectiveStaleKillThreshold = Get-PrizmEffectiveStaleKillThreshold -ProgressFile $progressJson -BaseThreshold $staleKillThreshold
 
       # Check for error-loop: agent is actively producing output but results are
-      # all read-offset errors or wasted calls.
+      # all read-offset errors or wasted calls. Only a newly advancing error
+      # signature counts; stale historical errors must not turn later normal output
+      # into a stale kill.
       $errorLoopDetected = $false
+      $errorLoopSignature = ''
       if ($effectiveStaleKillThreshold -gt 0 -and $growth -gt 0 -and (Test-Path $progressJson)) {
         try {
           $progress = Get-Content $progressJson -Raw | ConvertFrom-Json
@@ -778,17 +786,21 @@ function Invoke-PrizmPipeline {
               $_.type -in @("read_offset_overflow", "wasted_call")
             }).Count -eq 5
             if ($allBad) {
-              $errorLoopDetected = $true
+              $errorLoopSignature = ($recent | ConvertTo-Json -Compress)
+              if ($previousErrorLoopSignature -and $errorLoopSignature -ne $previousErrorLoopSignature) {
+                $errorLoopDetected = $true
+              }
             }
           }
         } catch {
           # Ignore JSON parse errors — progress file may be incomplete or malformed
         }
       }
+      $previousErrorLoopSignature = $errorLoopSignature
 
       if ($errorLoopDetected) {
         $staleSeconds = $effectiveStaleKillThreshold
-      } elseif ($growth -gt 0 -or $childAdvanced) {
+      } elseif ($growth -gt 0 -or $childAdvanced -or $progressAdvanced) {
         $staleSeconds = 0
       } else {
         $staleSeconds += $waitSeconds

package/bundled/dev-pipeline-windows/run-recovery.ps1

@@ -121,6 +121,7 @@ $job = Start-Job -ScriptBlock {
 $elapsedSeconds = 0
 $staleSeconds = 0
 $previousLogSize = 0
+$previousProgressSignature = ''
 $previousChildActivitySignature = ''
 $wasTimedOut = $false
 $wasStaleKilled = $false
@@ -136,12 +137,15 @@ while ($true) {
   $growth = $currentLogSize - $previousLogSize
   $previousLogSize = $currentLogSize
 
-  $childActivity = Get-PrizmProgressChildActivity -ProgressFile $progressPath
-  $childSignature = [string]$childActivity.Signature
+  $progressActivity = Get-PrizmProgressActivity -ProgressFile $progressPath
+  $progressSignature = [string]$progressActivity.ProgressSignature
+  $progressAdvanced = ($progressSignature -and $progressSignature -ne $previousProgressSignature)
+  $previousProgressSignature = $progressSignature
+  $childSignature = [string]$progressActivity.ChildSignature
   $childAdvanced = ($childSignature -and $childSignature -ne $previousChildActivitySignature)
   $previousChildActivitySignature = $childSignature
 
-  if ($growth -gt 0 -or $childAdvanced) { $staleSeconds = 0 } else { $staleSeconds += $waitSeconds }
+  if ($growth -gt 0 -or $childAdvanced -or $progressAdvanced) { $staleSeconds = 0 } else { $staleSeconds += $waitSeconds }
 
   if ($timeoutSeconds -gt 0 -and $elapsedSeconds -ge $timeoutSeconds) {
     $wasTimedOut = $true

package/bundled/skills/_metadata.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1.90",
+  "version": "1.1.91",
   "skills": {
     "prizm-kit": {
       "description": "Full-lifecycle dev toolkit. Covers spec-driven development, Prizm context docs, code quality, debugging, deployment, and knowledge management.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prizmkit",
-  "version": "1.1.90",
+  "version": "1.1.91",
   "description": "Create a new PrizmKit-powered project with clean initialization — no framework dev files, just what you need.",
   "type": "module",
   "bin": {