prizmkit 1.0.125 → 1.0.126

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.0.125",
-  "bundledAt": "2026-03-27T19:33:35.398Z",
-  "bundledFrom": "ae0bada"
+  "frameworkVersion": "1.0.126",
+  "bundledAt": "2026-03-28T02:42:16.988Z",
+  "bundledFrom": "78687d9"
 }

package/bundled/dev-pipeline/README.md

@@ -205,7 +205,7 @@ Equivalent to `run.sh` but for the bug-fix pipeline.
 
 **Single-bug options:** `--dry-run`, `--timeout N` (same as `run.sh`)
 
-Processes bugs by: **severity** (critical > high > medium > low) then **priority** number.
+Processes bugs by: **severity** (critical > high > medium > low) then **priority** (high > medium > low).
 
 ---
 
@@ -250,7 +250,7 @@ python3 scripts/init-pipeline.py \
 **Validation checks:**
 - Schema: `$schema == "dev-pipeline-feature-list-v1"`
 - Required fields: `app_name` (string), `features` (non-empty array)
-- Per-feature: `id` (F-NNN), `title`, `description`, `priority` (int), `dependencies` (array of F-NNN), `acceptance_criteria` (array), `status`
+- Per-feature: `id` (F-NNN), `title`, `description`, `priority` (high/medium/low), `dependencies` (array of F-NNN), `acceptance_criteria` (array), `status`
 - Dependency DAG cycle detection (Kahn's algorithm)
 
 **Output (JSON to stdout):**
@@ -406,7 +406,7 @@ python3 scripts/update-bug-status.py \
 
 **Actions:** `get_next`, `update`, `status`, `pause`, `reset`, `clean`
 
-**Priority order:** severity (critical > high > medium > low), then priority number.
+**Priority order:** severity (critical > high > medium > low), then priority (high > medium > low).
 
 ---
 

package/bundled/dev-pipeline/assets/feature-list-example.json

@@ -10,7 +10,7 @@
       "id": "F-001",
       "title": "Project Infrastructure Setup",
       "description": "Initialize the monorepo structure with Next.js frontend, Express backend, and PostgreSQL database. Set up ESLint, Prettier, TypeScript configs, and CI/CD basics.",
-      "priority": 1,
+      "priority": "high",
       "estimated_complexity": "medium",
       "dependencies": [],
       "acceptance_criteria": [
@@ -28,7 +28,7 @@
       "id": "F-002",
       "title": "User Authentication",
       "description": "Implement email/password registration and login with JWT tokens. Include password reset via email, session management, and protected routes.",
-      "priority": 2,
+      "priority": "high",
       "estimated_complexity": "medium",
       "dependencies": [
         "F-001"
@@ -48,7 +48,7 @@
       "id": "F-003",
       "title": "Task CRUD Operations",
       "description": "Core task management: create, read, update, delete tasks. Tasks have title, description, status (todo/in-progress/done), priority, due date, and assignee.",
-      "priority": 3,
+      "priority": "high",
       "estimated_complexity": "medium",
       "dependencies": [
         "F-002"
@@ -68,7 +68,7 @@
       "id": "F-004",
       "title": "Project & Team Management",
       "description": "Organize tasks into projects. Support team creation, member invitation, and role-based permissions (owner, admin, member, viewer).",
-      "priority": 4,
+      "priority": "medium",
       "estimated_complexity": "high",
       "dependencies": [
         "F-003"
@@ -99,7 +99,7 @@
       "id": "F-005",
       "title": "Real-time Updates",
       "description": "Add WebSocket-based real-time notifications for task changes, comments, and team activity. Show live updates without page refresh.",
-      "priority": 5,
+      "priority": "medium",
       "estimated_complexity": "high",
       "dependencies": [
         "F-003"
@@ -119,7 +119,7 @@
       "id": "F-006",
       "title": "Analytics Dashboard",
       "description": "Dashboard showing task completion rates, team productivity metrics, overdue task tracking, and project progress visualization.",
-      "priority": 6,
+      "priority": "low",
       "estimated_complexity": "medium",
       "dependencies": [
         "F-004",

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

@@ -94,12 +94,12 @@ branch_merge() {
     local auto_push="${4:-0}"
 
     # Step 1: Checkout original branch
-    # First commit any remaining dirty files so checkout is not blocked
+    # Stash any uncommitted changes (e.g. untracked state/ files) so checkout is not blocked
+    local had_stash=false
     local remaining_dirty
     remaining_dirty=$(git -C "$project_root" status --porcelain 2>/dev/null || true)
     if [[ -n "$remaining_dirty" ]]; then
-        git -C "$project_root" add -A 2>/dev/null || true
-        git -C "$project_root" commit --no-verify -m "chore: include pipeline state artifacts" 2>/dev/null || true
+        git -C "$project_root" stash push --include-untracked -m "pipeline-merge-stash" 2>/dev/null && had_stash=true || true
     fi
 
     # Step 2: Rebase dev branch onto original to make it fast-forwardable.
@@ -112,11 +112,13 @@ branch_merge() {
         log_error "  git rebase --abort  # then resolve conflicts and retry"
         git -C "$project_root" rebase --abort 2>/dev/null || true
         git -C "$project_root" checkout "$dev_branch" 2>/dev/null || true
+        [[ "$had_stash" == true ]] && git -C "$project_root" stash pop 2>/dev/null || true
         return 1
     fi
     # After the rebase we are on dev_branch — checkout original for the fast-forward
     if ! git -C "$project_root" checkout "$original_branch" 2>/dev/null; then
         log_error "Failed to checkout $original_branch for merge"
+        [[ "$had_stash" == true ]] && git -C "$project_root" stash pop 2>/dev/null || true
         return 1
     fi
 
@@ -125,6 +127,7 @@ branch_merge() {
         log_error "Merge failed after rebase — this should not happen, resolve manually:"
         log_error "  git checkout $original_branch && git rebase $dev_branch"
         git -C "$project_root" checkout "$dev_branch" 2>/dev/null || true
+        [[ "$had_stash" == true ]] && git -C "$project_root" stash pop 2>/dev/null || true
         return 1
     fi
 
@@ -144,5 +147,8 @@ branch_merge() {
     git -C "$project_root" branch -d "$dev_branch" 2>/dev/null && \
         log_info "Deleted merged branch: $dev_branch" || true
 
+    # Step 6: Restore stashed state/ files
+    [[ "$had_stash" == true ]] && git -C "$project_root" stash pop 2>/dev/null || true
+
     return 0
 }

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

@@ -348,6 +348,19 @@ run_one() {
             log_error "Failed to initialize bugfix pipeline state"
             exit 1
         }
+
+        # Ensure state directory is gitignored
+        local _gitignore_path
+        _gitignore_path="$(cd "$SCRIPT_DIR/.." && pwd)/.gitignore"
+        local _state_rel
+        _state_rel=$(python3 -c "import os; print(os.path.relpath('$STATE_DIR', '$(cd "$SCRIPT_DIR/.." && pwd)'))" 2>/dev/null || echo "dev-pipeline/bugfix-state")
+        if [[ -f "$_gitignore_path" ]]; then
+            if ! grep -qF "$_state_rel" "$_gitignore_path" 2>/dev/null; then
+                printf '\n# Pipeline runtime state (auto-added by dev-pipeline)\n%s/\n' "$_state_rel" >> "$_gitignore_path"
+            fi
+        else
+            printf '# Pipeline runtime state (auto-added by dev-pipeline)\n%s/\n' "$_state_rel" > "$_gitignore_path"
+        fi
     fi
 
     # Verify bug exists
@@ -529,6 +542,19 @@ main() {
         local bugs_count
         bugs_count=$(echo "$init_result" | python3 -c "import sys,json; print(json.load(sys.stdin).get('bugs_count', 0))" 2>/dev/null || echo "0")
         log_success "Bugfix pipeline initialized with $bugs_count bugs"
+
+        # Ensure state directory is gitignored
+        local _gitignore_path
+        _gitignore_path="$(cd "$SCRIPT_DIR/.." && pwd)/.gitignore"
+        local _state_rel
+        _state_rel=$(python3 -c "import os; print(os.path.relpath('$STATE_DIR', '$(cd "$SCRIPT_DIR/.." && pwd)'))" 2>/dev/null || echo "dev-pipeline/bugfix-state")
+        if [[ -f "$_gitignore_path" ]]; then
+            if ! grep -qF "$_state_rel" "$_gitignore_path" 2>/dev/null; then
+                printf '\n# Pipeline runtime state (auto-added by dev-pipeline)\n%s/\n' "$_state_rel" >> "$_gitignore_path"
+            fi
+        else
+            printf '# Pipeline runtime state (auto-added by dev-pipeline)\n%s/\n' "$_state_rel" > "$_gitignore_path"
+        fi
     else
         log_info "Resuming existing bugfix pipeline..."
     fi

package/bundled/dev-pipeline/run.sh

@@ -828,6 +828,21 @@ main() {
         local features_count
         features_count=$(echo "$init_result" | python3 -c "import sys,json; print(json.load(sys.stdin).get('features_count', 0))" 2>/dev/null || echo "0")
         log_success "Pipeline initialized with $features_count features"
+
+        # Ensure state directory is gitignored (prevents branch-switch state loss)
+        local _gitignore_path
+        _gitignore_path="$(cd "$SCRIPT_DIR/.." && pwd)/.gitignore"
+        local _state_rel
+        _state_rel=$(python3 -c "import os; print(os.path.relpath('$STATE_DIR', '$(cd "$SCRIPT_DIR/.." && pwd)'))" 2>/dev/null || echo "dev-pipeline/state")
+        if [[ -f "$_gitignore_path" ]]; then
+            if ! grep -qF "$_state_rel" "$_gitignore_path" 2>/dev/null; then
+                printf '\n# Pipeline runtime state (auto-added by dev-pipeline)\n%s/\n' "$_state_rel" >> "$_gitignore_path"
+                log_info "Added $_state_rel/ to .gitignore"
+            fi
+        else
+            printf '# Pipeline runtime state (auto-added by dev-pipeline)\n%s/\n' "$_state_rel" > "$_gitignore_path"
+            log_info "Created .gitignore with $_state_rel/"
+        fi
     else
         log_info "Resuming existing pipeline..."
     fi
@@ -1010,35 +1025,14 @@ for f in data.get('stuck_features', []):
             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
+                # Return to original branch; state/ files are untracked and persist across checkout
+                git -C "$_proj_root" checkout "$_ORIGINAL_BRANCH" 2>/dev/null || true
                 _DEV_BRANCH_NAME=""
             fi
         elif [[ -n "$_DEV_BRANCH_NAME" ]]; then
             # Session failed — return to original branch, preserve dev branch for inspection
-            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"
+            if ! git -C "$_proj_root" checkout "$_ORIGINAL_BRANCH" 2>/dev/null; then
+                log_warn "Failed to checkout $_ORIGINAL_BRANCH after session failure — staying on dev branch"
             fi
             log_warn "Session failed — dev branch preserved for inspection: $_DEV_BRANCH_NAME"
             _DEV_BRANCH_NAME=""

package/bundled/dev-pipeline/scripts/update-bug-status.py

@@ -142,7 +142,7 @@ def action_get_next(bug_list_data, state_dir):
     Priority logic:
     1. Skip terminal statuses (completed, failed, skipped, needs_info)
     2. Prefer in_progress bugs (interrupted session resume) over pending
-    3. Sort by: severity (critical > high > medium > low), then by priority field
+    3. Sort by: severity (critical > high > medium > low), then by priority (high > medium > low)
     """
     bugs = bug_list_data.get("bugs", [])
     if not bugs:
@@ -183,10 +183,12 @@ def action_get_next(bug_list_data, state_dir):
         elif bstatus == "pending":
             pending_bugs.append(bug)
 
+    _PRIORITY_ORDER = {"high": 0, "medium": 1, "low": 2}
+
     def sort_key(b):
         severity = b.get("severity", "medium")
         sev_order = SEVERITY_PRIORITY.get(severity, 2)
-        priority = b.get("priority", 999)
+        priority = _PRIORITY_ORDER.get(b.get("priority", "low"), 2)
         return (sev_order, priority)
 
     if in_progress_bugs:

package/bundled/dev-pipeline/scripts/update-feature-status.py

@@ -334,7 +334,7 @@ def action_get_next(feature_list_data, state_dir, feature_filter=None):
     2. If feature_filter is set, skip features not in the filter
     3. Check that all dependencies are completed
     4. Prefer in_progress features over pending ones (interrupted session resume)
-    5. Among eligible features, pick lowest priority number (highest priority)
+    5. Among eligible features, pick highest priority (high > medium > low)
     """
     features = feature_list_data.get("features", [])
     if not features:
@@ -412,16 +412,19 @@ def action_get_next(feature_list_data, state_dir, feature_filter=None):
         else:
             pending_features.append(feature)
 
-    # Prefer in_progress features, then pending; sort by priority (lowest number = highest priority)
+    # Priority mapping: string enum → sort order (high first)
+    _PRIORITY_ORDER = {"high": 0, "medium": 1, "low": 2}
+
+    # Prefer in_progress features, then pending; sort by priority (high > medium > low)
     if in_progress_features:
         candidates = sorted(
             in_progress_features,
-            key=lambda f: f.get("priority", 999)
+            key=lambda f: _PRIORITY_ORDER.get(f.get("priority", "low"), 2)
         )
     else:
         candidates = sorted(
             pending_features,
-            key=lambda f: f.get("priority", 999)
+            key=lambda f: _PRIORITY_ORDER.get(f.get("priority", "low"), 2)
         )
 
     chosen = candidates[0]

package/bundled/dev-pipeline/templates/bug-fix-list-schema.json

@@ -55,9 +55,9 @@
             "description": "critical=crash/data-loss; high=core-feature-broken; medium=workaround-exists; low=cosmetic"
           },
           "priority": {
-            "type": "integer",
-            "minimum": 1,
-            "description": "Fix priority (lower = higher priority), determines pipeline processing order"
+            "type": "string",
+            "enum": ["high", "medium", "low"],
+            "description": "Fix priority. Pipeline processes high before medium before low; within same level, array order determines sequence."
           },
           "error_source": {
             "type": "object",

package/bundled/dev-pipeline/templates/feature-list-schema.json

@@ -46,8 +46,9 @@
             "minLength": 1
           },
           "priority": {
-            "type": "integer",
-            "minimum": 1
+            "type": "string",
+            "enum": ["high", "medium", "low"],
+            "description": "Feature priority. Pipeline processes high before medium before low; within same level, array order determines sequence."
           },
           "estimated_complexity": {
             "type": "string",

package/bundled/skills/_metadata.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.125",
+  "version": "1.0.126",
   "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/app-planner/scripts/validate-and-generate.py

@@ -34,6 +34,7 @@ SCHEMA_VERSION = "dev-pipeline-feature-list-v1"
 
 VALID_STATUSES = {"pending", "in_progress", "completed", "failed", "skipped", "split"}
 VALID_COMPLEXITIES = {"low", "medium", "high"}
+VALID_PRIORITIES = {"high", "medium", "low"}
 VALID_GRANULARITIES = {"feature", "sub_feature", "auto"}
 VALID_PLANNING_MODES = {"new", "incremental"}
 
@@ -251,10 +252,10 @@ def validate_feature_list(data, planning_mode="new"):
 
         # -- Priority --
         priority = feat.get("priority")
-        if isinstance(priority, int) and priority > 0:
+        if isinstance(priority, str) and priority in VALID_PRIORITIES:
             priorities.append(priority)
         else:
-            errors.append("{}: priority must be a positive integer, got {}".format(
+            errors.append("{}: priority must be one of 'high', 'medium', 'low', got {}".format(
                 label, repr(priority)
             ))
 
@@ -366,17 +367,6 @@ def validate_feature_list(data, planning_mode="new"):
                 seen_ids.add(sub_id)
                 total_sub_features += 1
 
-    # -- Priority uniqueness --
-    if len(priorities) != len(set(priorities)):
-        dup_prios = [
-            p for p, c in collections.Counter(priorities).items() if c > 1
-        ]
-        warnings.append(
-            "Duplicate priorities found: {}".format(
-                ", ".join(str(p) for p in sorted(dup_prios))
-            )
-        )
-
     # ------------------------------------------------------------------
     # 3. Dependency validation
     # ------------------------------------------------------------------
@@ -439,7 +429,7 @@ def generate_template():
                     "Initialize project structure, configure build tools, "
                     "set up development environment."
                 ),
-                "priority": 1,
+                "priority": "high",
                 "estimated_complexity": "medium",
                 "dependencies": [],
                 "acceptance_criteria": [

package/bundled/skills/bug-planner/SKILL.md

@@ -163,7 +163,7 @@ Before writing the file, verify all items pass:
 
 **Consistency checks:**
 - [ ] No duplicate bug IDs
-- [ ] No duplicate priorities (each bug should have unique priority number)
+- [ ] If `priority` is set, must be one of `high`, `medium`, `low`
 - [ ] If `affected_feature` is set, verify it exists in `feature-list.json` (if available)
 
 If any check fails, fix before writing the file.
@@ -217,7 +217,7 @@ Validate existing `bug-fix-list.json`:
    - Duplicate IDs
    - Missing required fields
    - Invalid status values
-   - Priority conflicts (same priority for different bugs)
+   - Invalid priority values (must be 'high', 'medium', or 'low')
    - Invalid `affected_feature` references (if feature-list.json exists)
 4. Output: validation result with specific errors/warnings
 

package/bundled/skills/bug-planner/scripts/validate-bug-list.py

@@ -110,12 +110,11 @@ def validate(bug_list_path, feature_list_path=None):
         if status not in VALID_STATUSES:
             errors.append(f"{prefix} ({bug_id}): invalid status '{status}' — must be one of {VALID_STATUSES}")
 
-        # Priority uniqueness
+        # Priority validation (optional field)
         priority = bug.get("priority")
         if priority is not None:
-            if priority in seen_priorities:
-                warnings.append(f"{prefix} ({bug_id}): duplicate priority {priority}")
-            seen_priorities.add(priority)
+            if priority not in ("high", "medium", "low"):
+                errors.append(f"{prefix} ({bug_id}): invalid priority '{priority}' — must be one of 'high', 'medium', 'low'")
 
         # Cross-reference affected_feature
         affected_feature = bug.get("affected_feature")

package/bundled/skills/dev-pipeline-launcher/SKILL.md

@@ -151,13 +151,13 @@ Detect user intent from their message, then follow the corresponding workflow:
 
    Default to (a). Only suggest (b) if features have `estimated_complexity: "high"` or above.
 
-   If user chooses (b), add `--critic` flag to the launch command in step 6.
+   If user chooses (b), prepend `ENABLE_CRITIC=true` to the launch command in step 6.
 
 6. **Ask user to confirm**: "Ready to launch the pipeline? It will process N features."
 
-7. **Launch** (based on chosen mode from step 4, with `--critic` if chosen in step 5):
-   - Foreground: `dev-pipeline/run.sh run feature-list.json [--critic]`
-   - Background: `dev-pipeline/launch-daemon.sh start feature-list.json [--critic]`
+7. **Launch** (based on chosen mode from step 4, with `ENABLE_CRITIC=true` env var if chosen in step 5):
+   - Foreground: `ENABLE_CRITIC=true dev-pipeline/run.sh run feature-list.json`
+   - Background: `dev-pipeline/launch-daemon.sh start feature-list.json --env "ENABLE_CRITIC=true"`
    - If user specified environment overrides:
      ```bash
      dev-pipeline/launch-daemon.sh start feature-list.json --env "SESSION_TIMEOUT=7200 MAX_RETRIES=5"
@@ -259,7 +259,7 @@ When user specifies custom settings, map to environment variables:
 | "max 5 retries" | `MAX_RETRIES=5` |
 | "verbose mode" | `VERBOSE=1` |
 | "heartbeat every 60s" | `HEARTBEAT_INTERVAL=60` |
-| "enable critic review" | `--critic` flag |
+| "enable critic review" | `ENABLE_CRITIC=true` env var (or `--critic` for single feature) |
 
 Pass via `--env`:
 ```bash

package/package.json

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