prizmkit 1.0.93 → 1.0.95

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.0.93",
-  "bundledAt": "2026-03-22T17:12:01.644Z",
-  "bundledFrom": "62f12ab"
+  "frameworkVersion": "1.0.95",
+  "bundledAt": "2026-03-23T08:20:36.490Z",
+  "bundledFrom": "8a1ccc9"
 }

package/bundled/dev-pipeline/retry-bug.sh

@@ -328,6 +328,7 @@ if [[ -f "$SESSION_LOG" ]]; then
     FINAL_SIZE=$(wc -c < "$SESSION_LOG" 2>/dev/null | tr -d ' ')
     log_info "Session log: $FINAL_LINES lines, $((FINAL_SIZE / 1024))KB"
 fi
+log_info "exit_code=$EXIT_CODE"
 
 # ── Determine session outcome from observable signals ──────────────
 PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"

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

@@ -337,6 +337,7 @@ if [[ -f "$SESSION_LOG" ]]; then
     FINAL_SIZE=$(wc -c < "$SESSION_LOG" 2>/dev/null | tr -d ' ')
     log_info "Session log: $FINAL_LINES lines, $((FINAL_SIZE / 1024))KB"
 fi
+log_info "exit_code=$EXIT_CODE"
 
 # ── Determine session outcome from observable signals ──────────────
 PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"

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

@@ -163,6 +163,7 @@ spawn_and_wait_session() {
         local final_lines=$(wc -l < "$session_log" 2>/dev/null | tr -d ' ')
         log_info "Session log: $final_lines lines, $((final_size / 1024))KB"
     fi
+    log_info "exit_code=$exit_code"
 
     # ── Determine session outcome from observable signals ──────────────
     local session_status

package/bundled/dev-pipeline/run.sh

@@ -183,6 +183,7 @@ spawn_and_wait_session() {
         local final_lines=$(wc -l < "$session_log" 2>/dev/null | tr -d ' ')
         log_info "Session log: $final_lines lines, $((final_size / 1024))KB"
     fi
+    log_info "exit_code=$exit_code"
 
     # ── Determine session outcome from observable signals ──────────────
     # No dependency on session-status.json — uses exit code, git commits,
@@ -272,39 +273,6 @@ sys.exit(1)
         feature_slug=""
     }
 
-    if [[ -n "$feature_slug" ]]; then
-        local project_root_for_summary
-        project_root_for_summary="$(cd "$SCRIPT_DIR/.." && pwd)"
-        local summary_path="$project_root_for_summary/.prizmkit/specs/${feature_slug}/session-summary.json"
-        mkdir -p "$(dirname "$summary_path")"
-        local session_start_time
-        session_start_time=$(python3 -c "
-import json, sys, os
-p = os.path.join(sys.argv[1], 'current-session.json')
-if os.path.isfile(p):
-    with open(p) as f: print(json.load(f).get('started_at', ''))
-else: print('')
-" "$STATE_DIR" 2>/dev/null) || session_start_time=""
-        local exec_tier
-        exec_tier=$(python3 -c "
-import json, sys, os
-p = sys.argv[1]
-if os.path.isfile(p):
-    with open(p) as f: print(json.load(f).get('exec_tier', ''))
-else: print('')
-" "$session_dir/session-status.json" 2>/dev/null) || exec_tier=""
-        cat > "$summary_path" <<SUMMARY
-{
-  "feature_id": "$feature_id",
-  "session_id": "$session_id",
-  "status": "$session_status",
-  "started_at": "$session_start_time",
-  "completed_at": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
-  "tier": "$exec_tier"
-}
-SUMMARY
-    fi
-
     # Validate key artifacts exist after successful session
     if [[ "$session_status" == "success" && -n "$feature_slug" ]]; then
         local project_root_for_artifacts
@@ -1068,11 +1036,36 @@ os.replace(tmp, target)
             else
                 log_warn "Auto-merge failed — dev branch preserved: $_DEV_BRANCH_NAME"
                 log_warn "Merge manually: git checkout $_ORIGINAL_BRANCH && git rebase $_DEV_BRANCH_NAME"
+                # branch_merge failed and left us on dev branch — checkout original and commit pipeline artifacts
+                if git -C "$_proj_root" checkout "$_ORIGINAL_BRANCH" 2>/dev/null; then
+                    local _merge_failed_current _merge_failed_dirty
+                    _merge_failed_current=$(git -C "$_proj_root" rev-parse --abbrev-ref HEAD 2>/dev/null || true)
+                    if [[ "$_merge_failed_current" == "$_ORIGINAL_BRANCH" ]]; then
+                        _merge_failed_dirty=$(git -C "$_proj_root" status --porcelain 2>/dev/null || true)
+                        if [[ -n "$_merge_failed_dirty" ]]; then
+                            git -C "$_proj_root" add -A 2>/dev/null || true
+                            git -C "$_proj_root" commit --no-verify -m "chore: include pipeline state artifacts" 2>/dev/null || true
+                        fi
+                    fi
+                fi
                 _DEV_BRANCH_NAME=""
             fi
         elif [[ -n "$_DEV_BRANCH_NAME" ]]; then
             # Session failed — return to original branch, preserve dev branch for inspection
-            git -C "$_proj_root" checkout "$_ORIGINAL_BRANCH" 2>/dev/null || true
+            if git -C "$_proj_root" checkout "$_ORIGINAL_BRANCH" 2>/dev/null; then
+                # Commit any dirty pipeline state files left on the original branch
+                local _failed_current _failed_dirty
+                _failed_current=$(git -C "$_proj_root" rev-parse --abbrev-ref HEAD 2>/dev/null || true)
+                if [[ "$_failed_current" == "$_ORIGINAL_BRANCH" ]]; then
+                    _failed_dirty=$(git -C "$_proj_root" status --porcelain 2>/dev/null || true)
+                    if [[ -n "$_failed_dirty" ]]; then
+                        git -C "$_proj_root" add -A 2>/dev/null || true
+                        git -C "$_proj_root" commit --no-verify -m "chore: include pipeline state artifacts" 2>/dev/null || true
+                    fi
+                fi
+            else
+                log_warn "Failed to checkout $_ORIGINAL_BRANCH after session failure — pipeline state may be uncommitted"
+            fi
             log_warn "Session failed — dev branch preserved for inspection: $_DEV_BRANCH_NAME"
             _DEV_BRANCH_NAME=""
         fi

package/bundled/skills/_metadata.json

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

package/bundled/skills/prizmkit-retrospective/SKILL.md

@@ -137,6 +137,34 @@ Sediment DECISIONS and interface conventions to platform memory files. This is w
 - Feature completion with notable DECISIONS or interface conventions discovered
 - **Skip for**: trivial fixes, config changes, bug fixes with no new conventions
 
+### Write Decision Gate (mandatory before any write)
+
+Before writing anything to memory files, apply this evaluation in order:
+
+**Gate 1 — Importance**: Is the content worth recording? Only record:
+- New feature implementations with non-obvious design choices
+- Critical logic changes with lasting impact
+- Interface conventions that future sessions must honor
+- **Skip**: simple queries, trivial fixes, one-off config changes, content with no future impact
+
+**Gate 2 — Dedup**: If Gate 1 passes, read the existing memory file(s) first. Compare against existing entries by core keywords, feature summary, or function signature. If a highly similar entry already exists, **skip or merge-update** it — never duplicate.
+
+**Gate 3 — Write only if both pass**: Write to memory files only when content is both important AND non-duplicate. Do NOT write by default after every feature. Skipping is the correct outcome for routine work.
+
+**File size monitor**: After each write, check the file's line count. If it exceeds 500 lines, trigger the compaction flow below.
+
+### Compaction Flow (triggered at >500 lines)
+
+Goal: reduce file size while preserving all valuable knowledge.
+
+Allowed operations (lossless):
+- **Merge similar entries**: combine multiple updates about the same feature/topic into one comprehensive record
+- **Remove stale content**: delete entries explicitly superseded, replaced, or marked as deprecated
+- **Distill verbose logs**: compress long narrative descriptions into concise bullet points, preserving key code snippets, config changes, and decision rationale
+- **Restructure**: reorganize headers and sections for clarity
+
+Principle: compaction must be lossless — no valuable operational history or decision rationale may be lost.
+
 ### Sedimentation Rules
 
 1. **Max 3-5 entries per feature**: Only keep DECISIONS and interface conventions that genuinely affect future development
@@ -150,26 +178,30 @@ Sediment DECISIONS and interface conventions to platform memory files. This is w
 - `claude` → target: `CLAUDE.md` in project root
 - `codebuddy` → targets: BOTH `CODEBUDDY.md` in project root AND `memory/MEMORY.md` (dual-write required)
 
-**2b-2.** Collect sedimentation candidates:
+**2b-2.** Apply the Write Decision Gate (Importance → Dedup → Write). If gate fails at any step, skip Job 3 entirely.
+
+**2b-3.** Collect sedimentation candidates (only if gate passes):
 - From context-snapshot.md '## Implementation Log': DECISIONS and notable discoveries
 - From context-snapshot.md '## Review Notes': quality patterns, architectural observations
 - From git diff analysis: any project-level conventions established
 - Filter: only entries that answer "Would a new session benefit from knowing this decision/convention?"
 
-**2b-3.** Read existing memory file(s) content. Check for duplicates or near-duplicates.
+**2b-4.** Read existing memory file(s) content. Check for duplicates or near-duplicates.
 - For Claude Code: read `CLAUDE.md`
 - For CodeBuddy: read BOTH `CODEBUDDY.md` AND `memory/MEMORY.md`
 
-**2b-4.** Append to memory file(s) using this format:
+**2b-5.** Append to memory file(s) using this format:
 ```markdown
 ### F-XXX: <feature-title>
 - DECISION: <decision content> — <rationale>
 - INTERFACE: <module.function>: <convention>
 ```
 
-**2b-5.** For CodeBuddy platform: write identical content to BOTH `CODEBUDDY.md` AND `memory/MEMORY.md` (dual-write, both must be updated).
+**2b-6.** For CodeBuddy platform: write identical content to BOTH `CODEBUDDY.md` AND `memory/MEMORY.md` (dual-write, both must be updated).
+
+**2b-7.** After writing, check file line count. If >500 lines, run the Compaction Flow before proceeding.
 
-**2b-6.** If no Implementation Log or Review Notes sections exist in context-snapshot.md, still attempt to extract DECISIONS from git diff and plan.md. Skip only if no meaningful decisions were made.
+**2b-8.** If no Implementation Log or Review Notes sections exist in context-snapshot.md, still attempt to extract DECISIONS from git diff and plan.md. Skip only if no meaningful decisions were made.
 
 ---
 

package/package.json

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