prizmkit 1.1.81 → 1.1.83

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.1.81",
-  "bundledAt": "2026-06-29T17:31:12.809Z",
-  "bundledFrom": "65df08d"
+  "frameworkVersion": "1.1.83",
+  "bundledAt": "2026-06-30T06:54:40.455Z",
+  "bundledFrom": "74dab7e"
 }

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

@@ -403,6 +403,13 @@ prizm_start_ai_session() {
 
     unset CLAUDECODE 2>/dev/null || true
 
+    # Write the prompt to log before launching (defense against stdout truncation)
+    echo "=== PRIZMKIT SESSION START ===" > "$log_path"
+    echo "Prompt: $prompt_path" >> "$log_path"
+    echo "Model: ${model:-default}" >> "$log_path"
+    echo "Started at: $(date -u +%Y-%m-%dT%H:%M:%SZ)" >> "$log_path"
+    echo "--- OUTPUT BELOW ---" >> "$log_path"
+
     local session_platform
     session_platform="$(_prizm_session_platform)"
 
@@ -421,7 +428,7 @@ prizm_start_ai_session() {
             if [[ -n "$model" ]]; then
                 claude_args+=(--model "$model")
             fi
-            "$CLI_CMD" "${claude_args[@]}" > "$log_path" 2>&1 &
+            "$CLI_CMD" "${claude_args[@]}" >> "$log_path" 2>&1 &
             ;;
         codex)
             local codex_args=(--ask-for-approval never --sandbox danger-full-access)
@@ -440,7 +447,7 @@ prizm_start_ai_session() {
             if [[ -n "${PRIZMKIT_EFFORT:-}" ]]; then
                 codex_args+=(--config "model_reasoning_effort=$PRIZMKIT_EFFORT")
             fi
-            "$CLI_CMD" "${codex_args[@]}" - < "$prompt_path" > "$log_path" 2>&1 &
+            "$CLI_CMD" "${codex_args[@]}" - < "$prompt_path" >> "$log_path" 2>&1 &
             ;;
         *)
             local cb_args=(--print -y)
@@ -456,7 +463,7 @@ prizm_start_ai_session() {
             if [[ -n "$model" ]]; then
                 cb_args+=(--model "$model")
             fi
-            "$CLI_CMD" "${cb_args[@]}" < "$prompt_path" > "$log_path" 2>&1 &
+            "$CLI_CMD" "${cb_args[@]}" < "$prompt_path" >> "$log_path" 2>&1 &
             ;;
     esac
     PRIZM_AI_PID=$!
@@ -938,6 +945,13 @@ prizm_run_ai_session() {
 
     unset CLAUDECODE 2>/dev/null || true
 
+    # Write preamble before launching (defense against stdout truncation)
+    echo "=== PRIZMKIT SESSION START ===" > "$log_path"
+    echo "Prompt: $prompt_path" >> "$log_path"
+    echo "Model: ${model:-default}" >> "$log_path"
+    echo "Started at: $(date -u +%Y-%m-%dT%H:%M:%SZ)" >> "$log_path"
+    echo "--- OUTPUT BELOW ---" >> "$log_path"
+
     local session_platform
     session_platform="$(_prizm_session_platform)"
 
@@ -950,7 +964,7 @@ prizm_run_ai_session() {
             if [[ -n "$model" ]]; then
                 claude_args+=(--model "$model")
             fi
-            "$CLI_CMD" "${claude_args[@]}" > "$log_path" 2>&1
+            "$CLI_CMD" "${claude_args[@]}" >> "$log_path" 2>&1
             ;;
         codex)
             local codex_args=(--ask-for-approval never --sandbox danger-full-access)
@@ -969,7 +983,7 @@ prizm_run_ai_session() {
             if [[ -n "${PRIZMKIT_EFFORT:-}" ]]; then
                 codex_args+=(--config "model_reasoning_effort=$PRIZMKIT_EFFORT")
             fi
-            "$CLI_CMD" "${codex_args[@]}" - < "$prompt_path" > "$log_path" 2>&1
+            "$CLI_CMD" "${codex_args[@]}" - < "$prompt_path" >> "$log_path" 2>&1
             ;;
         *)
             local cb_args=(--print -y)
@@ -979,7 +993,7 @@ prizm_run_ai_session() {
             if [[ -n "$model" ]]; then
                 cb_args+=(--model "$model")
             fi
-            "$CLI_CMD" "${cb_args[@]}" < "$prompt_path" > "$log_path" 2>&1
+            "$CLI_CMD" "${cb_args[@]}" < "$prompt_path" >> "$log_path" 2>&1
             ;;
     esac
 }

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

@@ -41,6 +41,7 @@ start_heartbeat() {
     (
         local elapsed=0
         local prev_size=0
+        local prev_max_size=0
         local prev_child_activity_signature=""
         local stale_seconds=0
         while kill -0 "$cli_pid" 2>/dev/null; do
@@ -48,13 +49,28 @@ start_heartbeat() {
             elapsed=$((elapsed + heartbeat_interval))
             kill -0 "$cli_pid" 2>/dev/null || break
 
-            # Get log file size
+            # Get log file size. If session_log was truncated (e.g. by subagent
+            # stdout redirection severing the file descriptor), detect and flag it.
             local cur_size=0
             if [[ -f "$session_log" ]]; then
                 cur_size=$(wc -c < "$session_log" 2>/dev/null || echo 0)
                 cur_size=$(echo "$cur_size" | tr -d ' ')
             fi
 
+            # Detect log truncation: size dropped to 0 or near-zero after previously
+            # accumulating significant content (>100KB). This indicates the file was
+            # unlinked/truncated by something outside our control while the AI CLI
+            # process is still running.
+            local log_truncated=false
+            if [[ $cur_size -lt 1024 && $prev_max_size -gt 102400 ]]; then
+                log_truncated=true
+            fi
+            # Track the maximum size we've seen for truncation detection
+            local prev_max_size=$prev_max_size
+            if [[ $cur_size -gt $prev_max_size ]]; then
+                prev_max_size=$cur_size
+            fi
+
             local growth=$((cur_size - prev_size))
             prev_size=$cur_size
 
@@ -183,16 +199,30 @@ PY
             # 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.
+            #
+            # 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.
             if [[ "$error_loop_detected" == "true" ]]; then
                 stale_seconds=$effective_stale_kill_threshold
-            elif [[ $growth -eq 0 && $child_growth -eq 0 ]]; then
+            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
+                    stale_seconds=0
+                fi
+                # If neither log nor children grow, this is a real stall
+            elif [[ $growth -le 0 && $child_growth -eq 0 ]]; then
                 stale_seconds=$((stale_seconds + heartbeat_interval))
             else
                 stale_seconds=0
             fi
 
             local size_display
-            if [[ $cur_size -gt 1048576 ]]; then
+            if $log_truncated; then
+                size_display="${cur_size}B/TRUNCATED(from ${prev_max_size}B)"
+            elif [[ $cur_size -gt 1048576 ]]; then
                 size_display="$((cur_size / 1048576))MB"
             elif [[ $cur_size -gt 1024 ]]; then
                 size_display="$((cur_size / 1024))KB"
@@ -219,7 +249,9 @@ PY
             local secs=$((elapsed % 60))
 
             local status_icon
-            if [[ $growth -gt 0 || $child_growth -gt 0 ]]; then
+            if $log_truncated; then
+                status_icon="${RED}⚠${NC}"
+            elif [[ $growth -gt 0 || $child_growth -gt 0 ]]; then
                 status_icon="${GREEN}▶${NC}"
             else
                 status_icon="${YELLOW}⏸${NC}"

package/bundled/dev-pipeline/run-bugfix.sh

@@ -159,6 +159,10 @@ spawn_and_wait_session() {
         local final_size=$(wc -c < "$session_log" 2>/dev/null | tr -d ' ')
         local final_lines=$(wc -l < "$session_log" 2>/dev/null | tr -d ' ')
         log_info "Session log: $final_lines lines, $((final_size / 1024))KB"
+        if [[ "$final_size" -lt 1024 && "$exit_code" -eq 0 ]]; then
+            log_warn "Session log was truncated during execution (subagent stdout redirection may have severed it)"
+            log_warn "Proceeding with exit-code-only outcome detection — child transcripts and git state are still valid"
+        fi
     fi
     log_info "exit_code=$exit_code"
 

package/bundled/dev-pipeline/run-feature.sh

@@ -174,6 +174,10 @@ spawn_and_wait_session() {
         local final_size=$(wc -c < "$session_log" 2>/dev/null | tr -d ' ')
         local final_lines=$(wc -l < "$session_log" 2>/dev/null | tr -d ' ')
         log_info "Session log: $final_lines lines, $((final_size / 1024))KB"
+        if [[ "$final_size" -lt 1024 && "$exit_code" -eq 0 ]]; then
+            log_warn "Session log was truncated during execution (subagent stdout redirection may have severed it)"
+            log_warn "Proceeding with exit-code-only outcome detection — child transcripts and git state are still valid"
+        fi
     fi
     log_info "exit_code=$exit_code"
 
@@ -990,7 +994,7 @@ else:
 
     # Commit feature status update on the original branch (after guaranteed return)
     if ! git -C "$_proj_root" diff --quiet "$feature_list" 2>/dev/null; then
-        git -C "$_proj_root" add "$feature_list"
+        git -C "$_proj_root" add "$feature_list" 2>/dev/null || true
         git -C "$_proj_root" commit --no-verify -m "chore($feature_id): update feature status" 2>/dev/null || true
     fi
 
@@ -1424,7 +1428,7 @@ DEPLOY_PROMPT_EOF
 
         # Commit feature status update on the original branch (after guaranteed return)
         if ! git -C "$_proj_root" diff --quiet "$feature_list" 2>/dev/null; then
-            git -C "$_proj_root" add "$feature_list"
+            git -C "$_proj_root" add "$feature_list" 2>/dev/null || true
             git -C "$_proj_root" commit --no-verify -m "chore($feature_id): update feature status" 2>/dev/null || true
         fi
 
@@ -1636,7 +1640,7 @@ case "${1:-run}" in
 
         # Commit the status change
         if ! git diff --quiet "$_unskip_feature_list" 2>/dev/null; then
-            git add "$_unskip_feature_list"
+            git add "$_unskip_feature_list" 2>/dev/null || true
             git commit -m "chore: unskip auto-skipped features" 2>/dev/null || true
         fi
         ;;

package/bundled/dev-pipeline/run-refactor.sh

@@ -161,6 +161,10 @@ spawn_and_wait_session() {
         local final_size=$(wc -c < "$session_log" 2>/dev/null | tr -d ' ')
         local final_lines=$(wc -l < "$session_log" 2>/dev/null | tr -d ' ')
         log_info "Session log: $final_lines lines, $((final_size / 1024))KB"
+        if [[ "$final_size" -lt 1024 && "$exit_code" -eq 0 ]]; then
+            log_warn "Session log was truncated during execution (subagent stdout redirection may have severed it)"
+            log_warn "Proceeding with exit-code-only outcome detection — child transcripts and git state are still valid"
+        fi
     fi
     log_info "exit_code=$exit_code"
 

package/bundled/dev-pipeline/templates/bootstrap-tier1.md

@@ -418,11 +418,6 @@ If you encounter an unrecoverable error, context overflow, or are about to exit
 
 2. This file is intentionally lightweight — write it BEFORE context runs out.
 
-**Lifecycle**: failure-log.md is a temporary cross-session artifact. Do NOT commit it to git. After a successful session (all phases complete + commit done), delete it:
-```bash
-rm -f .prizmkit/specs/{{FEATURE_SLUG}}/failure-log.md
-```
-
 ## Reminders
 
 - Tier 1: you handle everything directly — no subagents needed
@@ -432,3 +427,5 @@ rm -f .prizmkit/specs/{{FEATURE_SLUG}}/failure-log.md
 - Do NOT run `git add`/`git commit` during Phase 1-3 — all changes are committed once in Phase 4
 - If any files remain after the commit, amend the existing commit — do NOT create a follow-up commit
 - When staging files, always use explicit file names — NEVER use `git add -A` or `git add .`
+- **NEVER delete, modify, or touch any file under `.prizmkit/state/`** — those are pipeline runtime files managed by the runner
+- NEVER run `rm -rf`, `git clean`, or any destructive filesystem operations

package/bundled/dev-pipeline/templates/bootstrap-tier2.md

@@ -534,11 +534,6 @@ If you encounter an unrecoverable error, context overflow, or are about to exit
 
 2. This file is intentionally lightweight — write it BEFORE context runs out.
 
-**Lifecycle**: failure-log.md is a temporary cross-session artifact. Do NOT commit it to git. After a successful session (all phases complete + commit done), delete it:
-```bash
-rm -f .prizmkit/specs/{{FEATURE_SLUG}}/failure-log.md
-```
-
 ## Reminders
 
 - Tier 2: orchestrator builds context+plan, Analyzer checks consistency, Dev implements, Reviewer reviews+tests — use direct Agent spawn for agents
@@ -546,6 +541,8 @@ rm -f .prizmkit/specs/{{FEATURE_SLUG}}/failure-log.md
 - context-snapshot.md is append-only: orchestrator writes Sections 1-4, Dev appends Implementation Log, Reviewer appends Review Notes
 - Gate checks enforce Implementation Log and Review Notes are written before proceeding
 - Do NOT use `run_in_background=true` when spawning subagents
+- **NEVER delete, modify, or touch any file under `.prizmkit/state/`** — those are pipeline runtime files managed by the runner
+- NEVER run `rm -rf`, `git clean`, or any destructive filesystem operations
 - `/prizmkit-committer` is mandatory, and must not be replaced with manual git commit commands
 - Do NOT run `git add`/`git commit` during Phase 1-5 — all changes are committed once in Phase 6
 - If any files remain after the commit, amend the existing commit — do NOT create a follow-up commit

package/bundled/dev-pipeline/templates/bootstrap-tier3.md

@@ -612,11 +612,6 @@ If you encounter an unrecoverable error, context overflow, or are about to exit
 
 2. This file is intentionally lightweight — write it BEFORE context runs out.
 
-**Lifecycle**: failure-log.md is a temporary cross-session artifact. Do NOT commit it to git. After a successful session (all phases complete + commit done), delete it:
-```bash
-rm -f .prizmkit/specs/{{FEATURE_SLUG}}/failure-log.md
-```
-
 ## Reminders
 
 - Tier 3: full team — Dev (implementation) → Reviewer (review + test) — spawn agents directly via Agent tool
@@ -624,6 +619,8 @@ rm -f .prizmkit/specs/{{FEATURE_SLUG}}/failure-log.md
 - Gate checks enforce Implementation Log and Review Notes are written before proceeding
 - Do NOT use `run_in_background=true` when spawning agents
 - Commit phase must use `/prizmkit-committer`; do NOT replace with manual git commit commands
+- **NEVER delete, modify, or touch any file under `.prizmkit/state/`** — those are pipeline runtime files managed by the runner
+- NEVER run `rm -rf`, `git clean`, or any destructive filesystem operations
 - Do NOT run `git add`/`git commit` during Phase 1-5 — all changes are committed once in Phase 6
 - If any files remain after the commit, amend the existing commit — do NOT create a follow-up commit
 - When staging files, always use explicit file names — NEVER use `git add -A` or `git add .`

package/bundled/dev-pipeline/templates/sections/failure-capture.md

@@ -14,8 +14,3 @@ If you encounter an unrecoverable error, context overflow, or are about to exit
    ```
 
 2. This file is intentionally lightweight — write it BEFORE context runs out.
-
-**Lifecycle**: failure-log.md is a temporary cross-session artifact. Do NOT commit it to git. After a successful session (all phases complete + commit done), delete it:
-```bash
-rm -f .prizmkit/specs/{{FEATURE_SLUG}}/failure-log.md
-```

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

@@ -41,6 +41,7 @@ start_heartbeat() {
     (
         local elapsed=0
         local prev_size=0
+        local prev_max_size=0
         local prev_child_activity_signature=""
         local stale_seconds=0
         while kill -0 "$cli_pid" 2>/dev/null; do
@@ -48,13 +49,28 @@ start_heartbeat() {
             elapsed=$((elapsed + heartbeat_interval))
             kill -0 "$cli_pid" 2>/dev/null || break
 
-            # Get log file size
+            # Get log file size. If session_log was truncated (e.g. by subagent
+            # stdout redirection severing the file descriptor), detect and flag it.
             local cur_size=0
             if [[ -f "$session_log" ]]; then
                 cur_size=$(wc -c < "$session_log" 2>/dev/null || echo 0)
                 cur_size=$(echo "$cur_size" | tr -d ' ')
             fi
 
+            # Detect log truncation: size dropped to 0 or near-zero after previously
+            # accumulating significant content (>100KB). This indicates the file was
+            # unlinked/truncated by something outside our control while the AI CLI
+            # process is still running.
+            local log_truncated=false
+            if [[ $cur_size -lt 1024 && $prev_max_size -gt 102400 ]]; then
+                log_truncated=true
+            fi
+            # Track the maximum size we've seen for truncation detection
+            local prev_max_size=$prev_max_size
+            if [[ $cur_size -gt $prev_max_size ]]; then
+                prev_max_size=$cur_size
+            fi
+
             local growth=$((cur_size - prev_size))
             prev_size=$cur_size
 
@@ -183,16 +199,30 @@ PY
             # 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.
+            #
+            # 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.
             if [[ "$error_loop_detected" == "true" ]]; then
                 stale_seconds=$effective_stale_kill_threshold
-            elif [[ $growth -eq 0 && $child_growth -eq 0 ]]; then
+            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
+                    stale_seconds=0
+                fi
+                # If neither log nor children grow, this is a real stall
+            elif [[ $growth -le 0 && $child_growth -eq 0 ]]; then
                 stale_seconds=$((stale_seconds + heartbeat_interval))
             else
                 stale_seconds=0
             fi
 
             local size_display
-            if [[ $cur_size -gt 1048576 ]]; then
+            if $log_truncated; then
+                size_display="${cur_size}B/TRUNCATED(from ${prev_max_size}B)"
+            elif [[ $cur_size -gt 1048576 ]]; then
                 size_display="$((cur_size / 1048576))MB"
             elif [[ $cur_size -gt 1024 ]]; then
                 size_display="$((cur_size / 1024))KB"
@@ -219,7 +249,9 @@ PY
             local secs=$((elapsed % 60))
 
             local status_icon
-            if [[ $growth -gt 0 || $child_growth -gt 0 ]]; then
+            if $log_truncated; then
+                status_icon="${RED}⚠${NC}"
+            elif [[ $growth -gt 0 || $child_growth -gt 0 ]]; then
                 status_icon="${GREEN}▶${NC}"
             else
                 status_icon="${YELLOW}⏸${NC}"

package/bundled/skills/_metadata.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1.81",
+  "version": "1.1.83",
   "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.81",
+  "version": "1.1.83",
   "description": "Create a new PrizmKit-powered project with clean initialization — no framework dev files, just what you need.",
   "type": "module",
   "bin": {