prizmkit 1.0.142 → 1.0.144

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.0.142",
-  "bundledAt": "2026-03-28T23:25:23.889Z",
-  "bundledFrom": "6c6eed3"
+  "frameworkVersion": "1.0.144",
+  "bundledAt": "2026-03-29T13:53:32.397Z",
+  "bundledFrom": "f48ed27"
 }

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

@@ -39,7 +39,7 @@ branch_create() {
 
     # Create and checkout new branch
     if ! git -C "$project_root" checkout -b "$branch_name" "$source_branch" 2>/dev/null; then
-        log_error "Failed to create branch: $branch_name from $source_branch"
+        log_warn "Failed to create branch: $branch_name from $source_branch"
         return 1
     fi
 

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

@@ -138,29 +138,117 @@ prizm_check_common_dependencies() {
     fi
 }
 
-# Ensure git is installed and the current directory is a git repository.
-# If git is missing, print install instructions and exit.
+# Ensure git is installed and a given directory is a git repository.
+# If git is missing, attempt auto-install; on failure print instructions and exit.
 # If not inside a git repo, run git init + initial commit automatically.
+#
+# Usage: prizm_ensure_git_repo [directory]
+#   directory — path to check/initialize (defaults to current working directory)
 prizm_ensure_git_repo() {
+    local target_dir="${1:-.}"
+
+    # --- helper: run a command with a timeout (macOS-compatible) ---
+    # Uses GNU timeout / gtimeout if available, otherwise a background+kill fallback.
+    _run_with_timeout() {
+        local secs="$1"; shift
+        if command -v timeout &>/dev/null; then
+            timeout "$secs" "$@"
+        elif command -v gtimeout &>/dev/null; then
+            gtimeout "$secs" "$@"
+        else
+            # background + kill fallback
+            "$@" &
+            local pid=$!
+            ( sleep "$secs" && kill "$pid" 2>/dev/null ) &
+            local watchdog=$!
+            if wait "$pid" 2>/dev/null; then
+                kill "$watchdog" 2>/dev/null; wait "$watchdog" 2>/dev/null
+                return 0
+            else
+                kill "$watchdog" 2>/dev/null; wait "$watchdog" 2>/dev/null
+                return 1
+            fi
+        fi
+    }
+
     if ! command -v git &>/dev/null; then
-        log_error "git is required but not installed."
-        log_error "Install git:"
-        log_error "  macOS:   brew install git   or   xcode-select --install"
-        log_error "  Ubuntu:  sudo apt-get install git"
-        log_error "  Windows: https://git-scm.com/download/win"
+        log_warn "git is not installed. Attempting automatic installation..."
+        local _install_ok=false
+        case "$(uname -s)" in
+            Darwin)
+                if command -v brew &>/dev/null; then
+                    log_info "Installing git via Homebrew..."
+                    if _run_with_timeout 120 brew install git &>/dev/null; then
+                        _install_ok=true
+                    fi
+                else
+                    # xcode-select --install opens a GUI dialog that cannot be automated;
+                    # skip auto-install and fall through to manual instructions.
+                    log_info "Homebrew not found; cannot auto-install git on macOS."
+                fi
+                ;;
+            Linux)
+                # Verify passwordless sudo is available (daemon/CI safety)
+                if ! sudo -n true 2>/dev/null; then
+                    log_info "sudo requires a password; cannot auto-install git."
+                elif command -v apt-get &>/dev/null; then
+                    log_info "Installing git via apt-get..."
+                    _run_with_timeout 120 sudo apt-get update -y &>/dev/null
+                    if _run_with_timeout 120 sudo apt-get install -y git &>/dev/null; then
+                        _install_ok=true
+                    fi
+                elif command -v yum &>/dev/null; then
+                    log_info "Installing git via yum..."
+                    if _run_with_timeout 120 sudo yum install -y git &>/dev/null; then
+                        _install_ok=true
+                    fi
+                elif command -v dnf &>/dev/null; then
+                    log_info "Installing git via dnf..."
+                    if _run_with_timeout 120 sudo dnf install -y git &>/dev/null; then
+                        _install_ok=true
+                    fi
+                elif command -v pacman &>/dev/null; then
+                    log_info "Installing git via pacman..."
+                    if _run_with_timeout 120 sudo pacman -S --noconfirm git &>/dev/null; then
+                        _install_ok=true
+                    fi
+                fi
+                ;;
+        esac
+
+        if $_install_ok && command -v git &>/dev/null; then
+            log_success "git installed successfully ($(git --version))."
+        else
+            log_error "Automatic git installation failed or timed out."
+            log_error "Please install git manually:"
+            log_error "  macOS:   brew install git   or   xcode-select --install"
+            log_error "  Ubuntu:  sudo apt-get install git"
+            log_error "  CentOS:  sudo yum install git"
+            log_error "  Windows: https://git-scm.com/download/win"
+            exit 1
+        fi
+    fi
+
+    # Validate target directory exists
+    if [[ ! -d "$target_dir" ]]; then
+        log_error "Target directory does not exist: $target_dir"
         exit 1
     fi
 
-    if ! git rev-parse --is-inside-work-tree &>/dev/null 2>&1; then
-        log_warn "Current directory is not a git repository."
+    if ! git -C "$target_dir" rev-parse --is-inside-work-tree &>/dev/null 2>&1; then
+        log_warn "Directory is not a git repository: $target_dir"
         log_info "Initializing git repository..."
-        git init -b main
+        git -C "$target_dir" init -b main
+        log_info "Git repository initialized at: $target_dir"
         # Create initial commit so branches and diffs work
-        git add -A
-        git commit --no-verify -m "chore: initial commit (auto-created by dev-pipeline)" || {
+        if ! git -C "$target_dir" add -A; then
+            log_error "Failed to stage files in: $target_dir"
+            exit 1
+        fi
+        git -C "$target_dir" commit --no-verify -m "chore: initial commit (auto-created by dev-pipeline)" || {
             # If nothing to commit (empty project), create an empty initial commit
-            git commit --no-verify --allow-empty -m "chore: initial commit (auto-created by dev-pipeline)"
+            git -C "$target_dir" commit --no-verify --allow-empty -m "chore: initial commit (auto-created by dev-pipeline)"
         }
-        log_success "Git repository initialized with initial commit."
+        log_success "Initial commit created — workspace content committed."
     fi
 }

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

@@ -275,7 +275,9 @@ trap cleanup SIGINT SIGTERM
 
 check_dependencies() {
     prizm_check_common_dependencies "$CLI_CMD"
-    prizm_ensure_git_repo
+    local _project_root
+    _project_root="$(cd "$SCRIPT_DIR/.." && pwd)"
+    prizm_ensure_git_repo "$_project_root"
 }
 
 run_log_cleanup() {

package/bundled/dev-pipeline/run.sh

@@ -360,7 +360,9 @@ trap cleanup SIGINT SIGTERM
 
 check_dependencies() {
     prizm_check_common_dependencies "$CLI_CMD"
-    prizm_ensure_git_repo
+    local _project_root
+    _project_root="$(cd "$SCRIPT_DIR/.." && pwd)"
+    prizm_ensure_git_repo "$_project_root"
 }
 
 run_log_cleanup() {

package/bundled/skills/_metadata.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.141",
+  "version": "1.0.144",
   "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/bugfix-pipeline-launcher/SKILL.md

@@ -113,38 +113,37 @@ Detect user intent from their message, then follow the corresponding workflow:
    - **(2) Background daemon** — pipeline runs fully detached via `launch-bugfix-daemon.sh`. Survives AI CLI session closure.
    - **(3) Manual** — display the final assembled commands only. Do not execute anything. User runs them on their own.
 
-5. **Present configuration options**: After execution mode is chosen, show the remaining options with defaults. Ask the user to confirm or override.
+5. **Ask configuration options** ⚠️ MANDATORY INTERACTIVE STEP — applies to ALL execution modes (Foreground, Background, AND Manual). You MUST ask the user to configure options and WAIT for their response BEFORE proceeding to step 6. Do NOT skip this step or merge it with step 6.
 
-   **Configuration Options:**
+   Use `AskUserQuestion` to present the following configuration choices. Each question is a separate selectable option:
 
-   | Option | Default | Description |
-   |--------|---------|-------------|
-   | **Verbose logging** | On | Detailed AI session logs including tool calls and subagent activity |
-   | **Max retries** | 3 | Max retry attempts per failed bug |
-   | **Session timeout** | None | Per-bug timeout in seconds (e.g. `3600` = 1 hour) |
-   | **Bug filter** | All | Run specific bugs: `B-001:B-005` (range), `B-001,B-003` (list), or mixed `B-001,B-005:B-010` |
+   **Question 1 — Verbose logging** (multiSelect: false):
+   - On (default) — Detailed AI session logs including tool calls and subagent activity
+   - Off — Minimal logging
 
-   Default Verbose On.
+   **Question 2 — Max retries** (multiSelect: false):
+   - 3 (default)
+   - 1
+   - 5
 
-   **Environment variable mapping** (for natural language → env var translation):
+   **Question 3 — Session timeout** (multiSelect: false):
+   - None (default) — No timeout
+   - 30 min — `SESSION_TIMEOUT=1800`
+   - 1 hour — `SESSION_TIMEOUT=3600`
+   - 2 hours — `SESSION_TIMEOUT=7200`
 
-   | User says | Environment variable |
-   |-----------|---------------------|
-   | "timeout 2 hours" | `SESSION_TIMEOUT=7200` |
-   | "max 5 retries" | `MAX_RETRIES=5` |
-   | "no verbose" / "quiet" | `VERBOSE=0` |
-   | "heartbeat every 60s" | `HEARTBEAT_INTERVAL=60` |
+   Note: Bug filter defaults to all bugs (by severity order). If the user selects "Other" on any option, handle their custom input.
 
-   Example presentation to user:
-   ```
-   Bugfix pipeline will process N bugs in Foreground mode:
-   - Verbose:     On (subagent detection enabled)
-   - Max retries: 3
-   - Timeout:     none
-   - Bugs:        all (by severity order)
+   **Environment variable mapping** (for translating user responses → env vars):
 
-   Want to change any options, or proceed with these defaults?
-   ```
+   | Config choice | Environment variable |
+   |-----------|---------------------|
+   | Verbose: Off | `VERBOSE=0` |
+   | Verbose: On | `VERBOSE=1` |
+   | Max retries: N | `MAX_RETRIES=N` |
+   | Timeout: value | `SESSION_TIMEOUT=<seconds>` |
+
+   ⚠️ STOP HERE and wait for user response before continuing to step 6.
 
 6. **Show final command**: Assemble the complete command from execution mode + confirmed configuration, and present it to the user.
 

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

@@ -133,46 +133,48 @@ Detect user intent from their message, then follow the corresponding workflow:
    - **(2) Background daemon** — pipeline runs fully detached via `launch-daemon.sh`. Survives AI CLI session closure.
    - **(3) Manual** — display the final assembled commands only. Do not execute anything. User runs them on their own.
 
-6. **Present configuration options**: After execution mode is chosen, show the remaining options with defaults. Ask the user to confirm or override.
+6. **Ask configuration options** ⚠️ MANDATORY INTERACTIVE STEP — applies to ALL execution modes (Foreground, Background, AND Manual). You MUST ask the user to configure options and WAIT for their response BEFORE proceeding to step 7. Do NOT skip this step or merge it with step 7.
 
-   **Configuration Options:**
+   Use `AskUserQuestion` to present the following configuration choices. Each question is a separate selectable option:
 
-   | Option | Default | Description |
-   |--------|---------|-------------|
-   | **Critic review** | Off | Adversarial review after planning & implementation. Increases time ~5-10 min/feature |
-   | **Verbose logging** | On | Detailed AI session logs including tool calls and subagent activity |
-   | **Max retries** | 3 | Max retry attempts per failed feature |
-   | **Session timeout** | None | Per-feature timeout in seconds (e.g. `3600` = 1 hour) |
-   | **Feature filter** | All | Run specific features: `F-001:F-005` (range), `F-001,F-003` (list), or mixed `F-001,F-005:F-010` |
-   | **Browser verify** | Auto | Run playwright-cli verification for features with `browser_interaction`. Auto = run if playwright-cli installed and features have the field |
+   **Question 1 — Critic review** (multiSelect: false):
+   - Off (default) — Skip adversarial review
+   - On — Enable critic review after planning & implementation (+5-10 min/feature)
 
-   Default Verbose On. Default Critic to Off unless features have `estimated_complexity: "high"` or above.
+   **Question 2 — Verbose logging** (multiSelect: false):
+   - On (default) — Detailed AI session logs including tool calls and subagent activity
+   - Off — Minimal logging
 
-   **Environment variable mapping** (for natural language → env var translation):
+   **Question 3 — Max retries** (multiSelect: false):
+   - 3 (default)
+   - 1
+   - 5
 
-   | User says | Environment variable |
+   **Question 4 — Session timeout** (multiSelect: false):
+   - None (default) — No timeout
+   - 30 min — `SESSION_TIMEOUT=1800`
+   - 1 hour — `SESSION_TIMEOUT=3600`
+   - 2 hours — `SESSION_TIMEOUT=7200`
+
+   Note: Due to the 4-question limit per `AskUserQuestion` call, Feature filter and Browser verify use their defaults (all features, auto-detect playwright-cli). If the user selects "Other" on any option, handle their custom input.
+
+   Default Critic to Off unless features have `estimated_complexity: "high"` or above (in which case default to On).
+
+   **Environment variable mapping** (for translating user responses → env vars):
+
+   | Config choice | Environment variable |
    |-----------|---------------------|
-   | "timeout 2 hours" | `SESSION_TIMEOUT=7200` |
-   | "max 5 retries" | `MAX_RETRIES=5` |
-   | "no verbose" / "quiet" | `VERBOSE=0` |
-   | "heartbeat every 60s" | `HEARTBEAT_INTERVAL=60` |
-   | "enable critic review" | `ENABLE_CRITIC=true` |
+   | Critic: On | `ENABLE_CRITIC=true` |
+   | Verbose: Off | `VERBOSE=0` |
+   | Verbose: On | `VERBOSE=1` |
+   | Max retries: N | `MAX_RETRIES=N` |
+   | Timeout: value | `SESSION_TIMEOUT=<seconds>` |
    | "skip browser verify" | `BROWSER_VERIFY=false` |
    | "enable browser verify" | `BROWSER_VERIFY=true` |
 
-   Example presentation to user:
-   ```
-   Pipeline will process N features in Foreground mode:
-   - Critic:      Off
-   - Verbose:     On (subagent detection enabled)
-   - Max retries: 3
-   - Timeout:     none
-   - Features:    all
-
-   Want to change any options, or proceed with these defaults?
-   ```
+   ⚠️ STOP HERE and wait for user response before continuing to step 7.
 
-7. **Show final command**: Assemble the complete command from execution mode + confirmed configuration, and present it to the user.
+7. **Show final command**: After user confirms configuration in step 6, assemble the complete command from execution mode + user-confirmed configuration, and present it to the user.
 
    **Foreground command:**
    ```bash

package/package.json

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