prizmkit 1.0.94 → 1.0.95

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.0.94",
-  "bundledAt": "2026-03-23T00:08:19.504Z",
-  "bundledFrom": "b1e871c"
+  "frameworkVersion": "1.0.95",
+  "bundledAt": "2026-03-23T08:20:36.490Z",
+  "bundledFrom": "8a1ccc9"
 }

package/bundled/dev-pipeline/run.sh

@@ -1036,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.94",
+  "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.94",
+  "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": {