prizmkit 1.1.46 → 1.1.48

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.1.46",
-  "bundledAt": "2026-05-20T14:21:52.729Z",
-  "bundledFrom": "f552940"
+  "frameworkVersion": "1.1.48",
+  "bundledAt": "2026-05-21T01:37:14.355Z",
+  "bundledFrom": "a20d996"
 }

package/bundled/dev-pipeline/launch-bugfix-daemon.sh

@@ -126,7 +126,7 @@ cmd_start() {
     done
 
     if [[ -z "$bug_list" ]]; then
-        bug_list=".prizmkit/plans/bug-fix-list.json"
+        bug_list="$PRIZMKIT_DIR/plans/bug-fix-list.json"
     fi
     if [[ ! "$bug_list" = /* ]]; then
         bug_list="$(cd "$(dirname "$bug_list")" 2>/dev/null && pwd)/$(basename "$bug_list")"

package/bundled/dev-pipeline/launch-feature-daemon.sh

@@ -155,7 +155,7 @@ cmd_start() {
 
     # Default feature list
     if [[ -z "$feature_list" ]]; then
-        feature_list=".prizmkit/plans/feature-list.json"
+        feature_list="$PRIZMKIT_DIR/plans/feature-list.json"
     fi
 
     # Resolve to absolute path

package/bundled/dev-pipeline/launch-refactor-daemon.sh

@@ -126,7 +126,7 @@ cmd_start() {
     done
 
     if [[ -z "$refactor_list" ]]; then
-        refactor_list=".prizmkit/plans/refactor-list.json"
+        refactor_list="$PRIZMKIT_DIR/plans/refactor-list.json"
     fi
     if [[ ! "$refactor_list" = /* ]]; then
         refactor_list="$(cd "$(dirname "$refactor_list")" 2>/dev/null && pwd)/$(basename "$refactor_list")"

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

@@ -136,11 +136,11 @@ prizm_detect_cli_and_platform() {
 
     if [[ -n "${AI_CLI:-}" ]]; then
         _raw_cli="$AI_CLI"
-    elif [[ -f ".prizmkit/config.json" ]]; then
+    elif [[ -f "$PRIZMKIT_DIR/config.json" ]]; then
         _config_ai_cli=$(python3 -c "
 import json, sys
 try:
-    with open('.prizmkit/config.json') as f:
+    with open('$PRIZMKIT_DIR/config.json') as f:
         d = json.load(f)
     v = d.get('ai_cli', '')
     if not v:

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

@@ -114,7 +114,7 @@ if [[ -z "$BUG_ID" && -z "$BUG_RANGE" && -z "$FILTER_MODE" ]]; then
     exit 1
 fi
 
-BUG_LIST="${BUG_LIST:-.prizmkit/plans/bug-fix-list.json}"
+BUG_LIST="${BUG_LIST:-$PRIZMKIT_DIR/plans/bug-fix-list.json}"
 
 # Resolve absolute path
 if [[ ! "$BUG_LIST" = /* ]]; then
@@ -263,7 +263,7 @@ print('?')
         log_info "Current status: $CURRENT_STATUS (no runtime state file)"
     fi
 
-    BUGFIX_DIR="$PROJECT_ROOT/.prizmkit/bugfix/$CUR_BUG_ID"
+    BUGFIX_DIR="$PRIZMKIT_DIR/bugfix/$CUR_BUG_ID"
     BUGFIX_COUNT=0
     if [[ -d "$BUGFIX_DIR" ]]; then
         BUGFIX_COUNT=$(find "$BUGFIX_DIR" -type f 2>/dev/null | wc -l | tr -d ' ')

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

@@ -114,7 +114,7 @@ if [[ -z "$FEATURE_ID" && -z "$FEATURE_RANGE" && -z "$FILTER_MODE" ]]; then
     exit 1
 fi
 
-FEATURE_LIST="${FEATURE_LIST:-.prizmkit/plans/feature-list.json}"
+FEATURE_LIST="${FEATURE_LIST:-$PRIZMKIT_DIR/plans/feature-list.json}"
 
 # Resolve absolute path
 if [[ ! "$FEATURE_LIST" = /* ]]; then
@@ -272,7 +272,7 @@ print('?')
         log_info "Current status: $CURRENT_STATUS (no runtime state file)"
     fi
 
-    SPECS_DIR="$PROJECT_ROOT/.prizmkit/specs/$FEATURE_SLUG"
+    SPECS_DIR="$PRIZMKIT_DIR/specs/$FEATURE_SLUG"
     SPECS_COUNT=0
     if [[ -d "$SPECS_DIR" ]]; then
         SPECS_COUNT=$(find "$SPECS_DIR" -type f 2>/dev/null | wc -l | tr -d ' ')

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

@@ -104,7 +104,7 @@ if [[ -z "$REFACTOR_ID" && -z "$REFACTOR_RANGE" && -z "$FILTER_MODE" ]]; then
     exit 1
 fi
 
-REFACTOR_LIST="${REFACTOR_LIST:-.prizmkit/plans/refactor-list.json}"
+REFACTOR_LIST="${REFACTOR_LIST:-$PRIZMKIT_DIR/plans/refactor-list.json}"
 
 # Resolve absolute path
 if [[ ! "$REFACTOR_LIST" = /* ]]; then
@@ -261,7 +261,7 @@ print('?')
         log_info "Current status: $CURRENT_STATUS (no runtime state file)"
     fi
 
-    SPECS_DIR="$PROJECT_ROOT/.prizmkit/specs/$REFACTOR_SLUG"
+    SPECS_DIR="$PRIZMKIT_DIR/specs/$REFACTOR_SLUG"
     SPECS_COUNT=0
     if [[ -d "$SPECS_DIR" ]]; then
         SPECS_COUNT=$(find "$SPECS_DIR" -type f 2>/dev/null | wc -l | tr -d ' ')

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

@@ -277,9 +277,7 @@ spawn_and_wait_session() {
 
     # Validate checkpoint completeness after successful session
     if [[ "$session_status" == "success" ]]; then
-        local _ckpt_root
-        _ckpt_root="$PROJECT_ROOT"
-        local checkpoint_file="$_ckpt_root/.prizmkit/bugfix/${bug_id}/workflow-checkpoint.json"
+        local checkpoint_file="$PRIZMKIT_DIR/bugfix/${bug_id}/workflow-checkpoint.json"
         if [[ -f "$checkpoint_file" ]]; then
             local checkpoint_result
             checkpoint_result=$(python3 -c "
@@ -469,7 +467,7 @@ run_one() {
     fi
 
     if [[ -z "$bug_list" ]]; then
-        bug_list=".prizmkit/plans/bug-fix-list.json"
+        bug_list="$PRIZMKIT_DIR/plans/bug-fix-list.json"
     fi
     if [[ ! "$bug_list" = /* ]]; then
         bug_list="$(pwd)/$bug_list"
@@ -522,9 +520,9 @@ run_one() {
 
         # Ensure state directory is gitignored
         local _gitignore_path
-        _gitignore_path="$(cd "$SCRIPT_DIR/.." && pwd)/.gitignore"
+        _gitignore_path="$PROJECT_ROOT/.gitignore"
         local _state_rel
-        _state_rel=$(python3 -c "import os; print(os.path.relpath('$STATE_DIR', '$(cd "$SCRIPT_DIR/.." && pwd)'))" 2>/dev/null || echo ".prizmkit/state/bugfix")
+        _state_rel=$(python3 -c "import os; print(os.path.relpath('$STATE_DIR', '$PROJECT_ROOT'))" 2>/dev/null || echo ".prizmkit/state/bugfix")
         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"
@@ -572,7 +570,7 @@ sys.exit(1)
             local project_root
             project_root="$PROJECT_ROOT"
 
-            local bugfix_dir="$project_root/.prizmkit/bugfix/$bug_id"
+            local bugfix_dir="$PRIZMKIT_DIR/bugfix/$bug_id"
             if [[ -d "$bugfix_dir" ]]; then
                 rm -rf "$bugfix_dir"
                 log_info "Removed $bugfix_dir"
@@ -826,7 +824,7 @@ else:
 # ============================================================
 
 main() {
-    local bug_list="${1:-.prizmkit/plans/bug-fix-list.json}"
+    local bug_list="${1:-$PRIZMKIT_DIR/plans/bug-fix-list.json}"
 
     if [[ ! "$bug_list" = /* ]]; then
         bug_list="$(pwd)/$bug_list"
@@ -881,9 +879,9 @@ main() {
 
         # Ensure state directory is gitignored
         local _gitignore_path
-        _gitignore_path="$(cd "$SCRIPT_DIR/.." && pwd)/.gitignore"
+        _gitignore_path="$PROJECT_ROOT/.gitignore"
         local _state_rel
-        _state_rel=$(python3 -c "import os; print(os.path.relpath('$STATE_DIR', '$(cd "$SCRIPT_DIR/.." && pwd)'))" 2>/dev/null || echo ".prizmkit/state/bugfix")
+        _state_rel=$(python3 -c "import os; print(os.path.relpath('$STATE_DIR', '$PROJECT_ROOT'))" 2>/dev/null || echo ".prizmkit/state/bugfix")
         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"
@@ -1211,7 +1209,7 @@ DEPLOY_PROMPT_EOF
 
         # Completion notes propagation (on success)
         if [ "$_SPAWN_RESULT" = "success" ]; then
-            local _summary_path="$_proj_root/.prizmkit/bugfix/${bug_id}/completion-summary.json"
+            local _summary_path="$PRIZMKIT_DIR/bugfix/${bug_id}/completion-summary.json"
             if [ -f "$_summary_path" ]; then
                 python3 "$SCRIPTS_DIR/patch-completion-notes.py" \
                     --bug-list "$bug_list" \
@@ -1280,7 +1278,7 @@ case "${1:-run}" in
         if [[ "${1:-}" =~ ^[Bb]-[0-9]+ ]]; then
             run_one "$@"
         else
-            main "${1:-.prizmkit/plans/bug-fix-list.json}"
+            main "${1:-$PRIZMKIT_DIR/plans/bug-fix-list.json}"
         fi
         ;;
     status)
@@ -1290,7 +1288,7 @@ case "${1:-run}" in
             exit 1
         fi
         python3 "$SCRIPTS_DIR/update-bug-status.py" \
-            --bug-list "${2:-.prizmkit/plans/bug-fix-list.json}" \
+            --bug-list "${2:-$PRIZMKIT_DIR/plans/bug-fix-list.json}" \
             --state-dir "$STATE_DIR" \
             --action status
         ;;
@@ -1305,7 +1303,7 @@ case "${1:-run}" in
             log_error "No bugfix pipeline state found. Run './run-bugfix.sh run' first."
             exit 1
         fi
-        _unskip_bug_list=".prizmkit/plans/bug-fix-list.json"
+        _unskip_bug_list="$PRIZMKIT_DIR/plans/bug-fix-list.json"
         _unskip_bug_id=""
         shift || true
         # Parse arguments: optional bug-id and bug-list path

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

@@ -322,10 +322,8 @@ sys.exit(1)
 
     # Validate key artifacts exist after successful session
     if [[ "$session_status" == "success" && -n "$feature_slug" ]]; then
-        local project_root_for_artifacts
-        project_root_for_artifacts="$PROJECT_ROOT"
-        local context_snapshot="$project_root_for_artifacts/.prizmkit/specs/${feature_slug}/context-snapshot.md"
-        local plan_file="$project_root_for_artifacts/.prizmkit/specs/${feature_slug}/plan.md"
+        local context_snapshot="$PRIZMKIT_DIR/specs/${feature_slug}/context-snapshot.md"
+        local plan_file="$PRIZMKIT_DIR/specs/${feature_slug}/plan.md"
 
         if [[ ! -f "$context_snapshot" ]]; then
             log_warn "ARTIFACT_MISSING: context-snapshot.md not found at $context_snapshot"
@@ -335,7 +333,7 @@ sys.exit(1)
         fi
 
         # Validate checkpoint completeness
-        local checkpoint_file="$project_root_for_artifacts/.prizmkit/specs/${feature_slug}/workflow-checkpoint.json"
+        local checkpoint_file="$PRIZMKIT_DIR/specs/${feature_slug}/workflow-checkpoint.json"
         if [[ -f "$checkpoint_file" ]]; then
             local checkpoint_result
             checkpoint_result=$(python3 -c "
@@ -377,9 +375,7 @@ sys.exit(0)
 
     # Check if session produced a failure-log for future retries
     if [[ "$session_status" != "success" && -n "$feature_slug" ]]; then
-        local project_root_for_failure
-        project_root_for_failure="$PROJECT_ROOT"
-        local failure_log="$project_root_for_failure/.prizmkit/specs/${feature_slug}/failure-log.md"
+        local failure_log="$PRIZMKIT_DIR/specs/${feature_slug}/failure-log.md"
         if [[ -f "$failure_log" ]]; then
             log_info "FAILURE_LOG: Session wrote failure-log.md — will be available to next retry"
         else
@@ -389,7 +385,7 @@ sys.exit(0)
 
     # Propagate completion notes for dependency context (only on success)
     if [[ "$session_status" == "success" && -n "$feature_slug" ]]; then
-        local summary_path="$project_root/.prizmkit/specs/$feature_slug/completion-summary.json"
+        local summary_path="$PRIZMKIT_DIR/specs/$feature_slug/completion-summary.json"
         if [[ -f "$summary_path" ]]; then
             python3 "$SCRIPTS_DIR/patch-completion-notes.py" \
                 --feature-list "$feature_list" \
@@ -605,7 +601,7 @@ run_one() {
 
     # Default feature list
     if [[ -z "$feature_list" ]]; then
-        feature_list=".prizmkit/plans/feature-list.json"
+        feature_list="$PRIZMKIT_DIR/plans/feature-list.json"
     fi
 
     # Resolve to absolute path
@@ -716,7 +712,7 @@ sys.exit(1)
             project_root="$PROJECT_ROOT"
 
             if [[ -n "$feature_slug" ]]; then
-                local specs_dir="$project_root/.prizmkit/specs/$feature_slug"
+                local specs_dir="$PRIZMKIT_DIR/specs/$feature_slug"
                 if [[ -d "$specs_dir" ]]; then
                     rm -rf "$specs_dir"
                     log_info "Removed $specs_dir"
@@ -990,7 +986,7 @@ else:
 # ============================================================
 
 main() {
-    local feature_list="${1:-.prizmkit/plans/feature-list.json}"
+    local feature_list="${1:-$PRIZMKIT_DIR/plans/feature-list.json}"
     local features_filter="${2:-}"
 
     # Resolve to absolute path
@@ -1011,11 +1007,9 @@ main() {
     # Validate .prizmkit/plans/feature-list.json is under project root
     local fl_dir
     fl_dir="$(cd "$(dirname "$feature_list")" && pwd)"
-    local project_root
-    project_root="$(pwd)"
-    if [[ "$fl_dir" != "$project_root"/.prizmkit/plans && "$fl_dir" != "$project_root" ]]; then
-        log_warn "feature-list.json is not under project root ($project_root), found at $fl_dir"
-        log_warn "Pipeline expects feature-list.json at <project-root>/.prizmkit/plans/feature-list.json. Proceeding but results may be unstable."
+    if [[ "$fl_dir" != "$PRIZMKIT_DIR/plans" && "$fl_dir" != "$PROJECT_ROOT" ]]; then
+        log_warn "feature-list.json is not under project root ($PROJECT_ROOT), found at $fl_dir"
+        log_warn "Pipeline expects feature-list.json at ${PRIZMKIT_DIR}/plans/feature-list.json. Proceeding but results may be unstable."
     fi
 
     check_dependencies
@@ -1060,9 +1054,9 @@ main() {
 
         # Ensure state directory is gitignored (prevents branch-switch state loss)
         local _gitignore_path
-        _gitignore_path="$(cd "$SCRIPT_DIR/.." && pwd)/.gitignore"
+        _gitignore_path="$PROJECT_ROOT/.gitignore"
         local _state_rel
-        _state_rel=$(python3 -c "import os; print(os.path.relpath('$STATE_DIR', '$(cd "$SCRIPT_DIR/.." && pwd)'))" 2>/dev/null || echo ".prizmkit/state/features")
+        _state_rel=$(python3 -c "import os; print(os.path.relpath('$STATE_DIR', '$PROJECT_ROOT'))" 2>/dev/null || echo ".prizmkit/state/features")
         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"
@@ -1506,7 +1500,7 @@ case "${1:-run}" in
             run_one "$@"
         else
             # Parse positional and --features flag
-             _run_feature_list=".prizmkit/plans/feature-list.json"
+             _run_feature_list="$PRIZMKIT_DIR/plans/feature-list.json"
              _run_features_filter=""
             while [[ $# -gt 0 ]]; do
                 case "$1" in
@@ -1535,7 +1529,7 @@ case "${1:-run}" in
             exit 1
         fi
         python3 "$SCRIPTS_DIR/update-feature-status.py" \
-            --feature-list "${2:-.prizmkit/plans/feature-list.json}" \
+            --feature-list "${2:-$PRIZMKIT_DIR/plans/feature-list.json}" \
             --state-dir "$STATE_DIR" \
             --action status
         ;;
@@ -1608,7 +1602,7 @@ case "${1:-run}" in
             log_error "No pipeline state found. Run './run-feature.sh run' first."
             exit 1
         fi
-        _unskip_feature_list=".prizmkit/plans/feature-list.json"
+        _unskip_feature_list="$PRIZMKIT_DIR/plans/feature-list.json"
         _unskip_feature_id=""
         shift || true
         # Parse arguments: optional feature-id and feature-list path

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

@@ -41,7 +41,22 @@ source "$SCRIPT_DIR/lib/common.sh"
 
 RECOVERY_STATE_DIR="${PRIZMKIT_DIR}/state/recovery"
 SCRIPTS_DIR="$SCRIPT_DIR/scripts"
-RECOVERY_DETECT_SCRIPT="${PROJECT_ROOT}/core/skills/orchestration-skill/workflows/recovery-workflow/scripts/detect-recovery-state.py"
+# detect-recovery-state.py lives in the installed skill assets (.claude or .codebuddy)
+if [[ -f "${PROJECT_ROOT}/.claude/command-assets/recovery-workflow/scripts/detect-recovery-state.py" ]]; then
+    RECOVERY_DETECT_SCRIPT="${PROJECT_ROOT}/.claude/command-assets/recovery-workflow/scripts/detect-recovery-state.py"
+elif [[ -f "${PROJECT_ROOT}/.codebuddy/skills/recovery-workflow/scripts/detect-recovery-state.py" ]]; then
+    RECOVERY_DETECT_SCRIPT="${PROJECT_ROOT}/.codebuddy/skills/recovery-workflow/scripts/detect-recovery-state.py"
+else
+    RECOVERY_DETECT_SCRIPT=""
+fi
+
+if [[ -z "$RECOVERY_DETECT_SCRIPT" ]]; then
+    log_error "Recovery detection script not found in either platform location:"
+    log_error "  ${PROJECT_ROOT}/.claude/command-assets/recovery-workflow/scripts/detect-recovery-state.py"
+    log_error "  ${PROJECT_ROOT}/.codebuddy/skills/recovery-workflow/scripts/detect-recovery-state.py"
+    log_error "Ensure PrizmKit is installed (npx prizmkit install) before running recovery."
+    exit 1
+fi
 
 # Configuration
 SESSION_TIMEOUT=${SESSION_TIMEOUT:-0}

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

@@ -279,15 +279,13 @@ spawn_and_wait_session() {
 
     # Validate key artifacts exist after successful session
     if [[ "$session_status" == "success" ]]; then
-        local _artifact_root
-        _artifact_root="$PROJECT_ROOT"
-        local plan_file="$_artifact_root/.prizmkit/refactor/$refactor_id/plan.md"
+        local plan_file="$PRIZMKIT_DIR/refactor/$refactor_id/plan.md"
         if [[ ! -f "$plan_file" ]]; then
             log_warn "ARTIFACT_MISSING: plan.md not found at $plan_file"
         fi
 
         # Validate checkpoint completeness
-        local checkpoint_file="$_artifact_root/.prizmkit/refactor/$refactor_id/workflow-checkpoint.json"
+        local checkpoint_file="$PRIZMKIT_DIR/refactor/$refactor_id/workflow-checkpoint.json"
         if [[ -f "$checkpoint_file" ]]; then
             local checkpoint_result
             checkpoint_result=$(python3 -c "
@@ -332,7 +330,7 @@ sys.exit(0)
 
     # Propagate completion notes for dependency context (only on success)
     if [[ "$session_status" == "success" ]]; then
-        local summary_path="$project_root/.prizmkit/refactor/$refactor_id/completion-summary.json"
+        local summary_path="$PRIZMKIT_DIR/refactor/$refactor_id/completion-summary.json"
         if [[ -f "$summary_path" ]]; then
             python3 "$SCRIPTS_DIR/patch-completion-notes.py" \
                 --refactor-list "$refactor_list" \
@@ -496,7 +494,7 @@ run_one() {
     fi
 
     if [[ -z "$refactor_list" ]]; then
-        refactor_list=".prizmkit/plans/refactor-list.json"
+        refactor_list="$PRIZMKIT_DIR/plans/refactor-list.json"
     fi
     if [[ ! "$refactor_list" = /* ]]; then
         refactor_list="$(pwd)/$refactor_list"
@@ -549,9 +547,9 @@ run_one() {
 
         # Ensure state directory is gitignored
         local _gitignore_path
-        _gitignore_path="$(cd "$SCRIPT_DIR/.." && pwd)/.gitignore"
+        _gitignore_path="$PROJECT_ROOT/.gitignore"
         local _state_rel
-        _state_rel=$(python3 -c "import os; print(os.path.relpath('$STATE_DIR', '$(cd "$SCRIPT_DIR/.." && pwd)'))" 2>/dev/null || echo ".prizmkit/state/refactor")
+        _state_rel=$(python3 -c "import os; print(os.path.relpath('$STATE_DIR', '$PROJECT_ROOT'))" 2>/dev/null || echo ".prizmkit/state/refactor")
         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"
@@ -599,7 +597,7 @@ sys.exit(1)
             local project_root
             project_root="$PROJECT_ROOT"
 
-            local refactor_dir="$project_root/.prizmkit/refactor/$refactor_id"
+            local refactor_dir="$PRIZMKIT_DIR/refactor/$refactor_id"
             if [[ -d "$refactor_dir" ]]; then
                 rm -rf "$refactor_dir"
                 log_info "Removed $refactor_dir"
@@ -856,7 +854,7 @@ else:
 # ============================================================
 
 main() {
-    local refactor_list="${1:-.prizmkit/plans/refactor-list.json}"
+    local refactor_list="${1:-$PRIZMKIT_DIR/plans/refactor-list.json}"
 
     if [[ ! "$refactor_list" = /* ]]; then
         refactor_list="$(pwd)/$refactor_list"
@@ -911,9 +909,9 @@ main() {
 
         # Ensure state directory is gitignored
         local _gitignore_path
-        _gitignore_path="$(cd "$SCRIPT_DIR/.." && pwd)/.gitignore"
+        _gitignore_path="$PROJECT_ROOT/.gitignore"
         local _state_rel
-        _state_rel=$(python3 -c "import os; print(os.path.relpath('$STATE_DIR', '$(cd "$SCRIPT_DIR/.." && pwd)'))" 2>/dev/null || echo ".prizmkit/state/refactor")
+        _state_rel=$(python3 -c "import os; print(os.path.relpath('$STATE_DIR', '$PROJECT_ROOT'))" 2>/dev/null || echo ".prizmkit/state/refactor")
         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"
@@ -1197,9 +1195,7 @@ DEPLOY_PROMPT_EOF
 
         # Validate key artifacts after successful session
         if [[ "$_SPAWN_RESULT" == "success" ]]; then
-            local _artifact_root
-            _artifact_root="$PROJECT_ROOT"
-            local plan_file="$_artifact_root/.prizmkit/refactor/$refactor_id/plan.md"
+            local plan_file="$PRIZMKIT_DIR/refactor/$refactor_id/plan.md"
             if [[ ! -f "$plan_file" ]]; then
                 log_warn "ARTIFACT_MISSING: plan.md not found at $plan_file"
             else
@@ -1317,7 +1313,7 @@ case "${1:-run}" in
         if [[ "${1:-}" =~ ^[Rr]-[0-9]+ ]]; then
             run_one "$@"
         else
-            main "${1:-.prizmkit/plans/refactor-list.json}"
+            main "${1:-$PRIZMKIT_DIR/plans/refactor-list.json}"
         fi
         ;;
     status)
@@ -1327,7 +1323,7 @@ case "${1:-run}" in
             exit 1
         fi
         python3 "$SCRIPTS_DIR/update-refactor-status.py" \
-            --refactor-list "${2:-.prizmkit/plans/refactor-list.json}" \
+            --refactor-list "${2:-$PRIZMKIT_DIR/plans/refactor-list.json}" \
             --state-dir "$STATE_DIR" \
             --action status
         ;;
@@ -1342,7 +1338,7 @@ case "${1:-run}" in
             log_error "No refactor pipeline state found. Run './run-refactor.sh run' first."
             exit 1
         fi
-        _unskip_refactor_list=".prizmkit/plans/refactor-list.json"
+        _unskip_refactor_list="$PRIZMKIT_DIR/plans/refactor-list.json"
         _unskip_refactor_id=""
         shift || true
         # Parse arguments: optional refactor-id and refactor-list path

package/bundled/skills/_metadata.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1.46",
+  "version": "1.1.48",
   "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

@@ -112,23 +112,30 @@ Detect user intent from their message, then follow the corresponding workflow:
      --action status 2>/dev/null
    ```
 
-4. **Ask execution mode** (first user decision):
+4. **Ask execution mode** (first user decision — SEPARATE `AskUserQuestion` call):
 
-   Present the three modes and ask the user to choose:
-   - **(1) Foreground** (recommended) — pipeline runs in the current session via `run-bugfix.sh run`. Visible output and direct error feedback.
-   - **(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.
+   ⛔ **This MUST be its own standalone `AskUserQuestion` call.** Do NOT combine execution mode with step 5 config questions. The execution mode question is asked ALONE, user responds, THEN you proceed to step 5.
 
-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.
+   Use `AskUserQuestion` with exactly 1 question:
 
-   ⛔ **HARD STOP**: You MUST call `AskUserQuestion` with the questions below and WAIT for the user's response. You MUST NOT:
+   **Question 1 — Execution mode** (multiSelect: false):
+   - Foreground (Recommended) — pipeline runs in the current session via `run-bugfix.sh run`. Visible output and direct error feedback.
+   - Background daemon — pipeline runs fully detached via `launch-bugfix-daemon.sh`. Survives AI CLI session closure.
+   - Manual — display the final assembled commands only. Do not execute anything. User runs them on their own.
+
+   ⚠️ STOP HERE and wait for user response before continuing to step 5.
+
+5. **Ask configuration options** ⚠️ MANDATORY INTERACTIVE STEP — applies to ALL execution modes (Foreground, Background, AND Manual). This is a SEPARATE `AskUserQuestion` call from step 4. You MUST ask the user to configure options and WAIT for their response BEFORE proceeding to step 6.
+
+   ⛔ **HARD STOP**: You MUST call `AskUserQuestion` with the 4 questions below and WAIT for the user's response. You MUST NOT:
+   - Combine step 4 and step 5 into one `AskUserQuestion` call (this is the most common violation — execution mode MUST be asked separately in step 4)
    - Skip this step and jump to the next step
    - Merge this step and the next step into one response
    - Assume default values and show the command without asking
    - Show the command as text and ask "ready?" without presenting the options
-   If you find yourself writing the final command before the user has answered these questions, STOP — you are violating this rule.
+   If you find yourself writing the final command before the user has answered these 4 questions, STOP — you are violating this rule.
 
-   Use `AskUserQuestion` to present the following configuration choices. Each question is a separate selectable option:
+   Use `AskUserQuestion` to present ALL 4 configuration choices (the full 4-question budget goes to config, NOT shared with execution mode):
 
    **Question 1 — Verbose logging** (multiSelect: false):
    - On (default) — Detailed AI session logs including tool calls and subagent activity

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

@@ -129,23 +129,30 @@ Detect user intent from their message, then follow the corresponding workflow:
 
    If `global_context.database` is absent and no features mention database keywords, the script skips DB checks automatically.
 
-5. **Ask execution mode** (first user decision):
+5. **Ask execution mode** (first user decision — SEPARATE `AskUserQuestion` call):
 
-   Present the three modes and ask the user to choose:
-   - **(1) Foreground** (recommended) — pipeline runs in the current session via `run-feature.sh run`. Visible output and direct error feedback.
-   - **(2) Background daemon** — pipeline runs fully detached via `launch-feature-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.
+   ⛔ **This MUST be its own standalone `AskUserQuestion` call.** Do NOT combine execution mode with step 6 config questions. The execution mode question is asked ALONE, user responds, THEN you proceed to step 6.
 
-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.
+   Use `AskUserQuestion` with exactly 1 question:
+
+   **Question 1 — Execution mode** (multiSelect: false):
+   - Foreground (Recommended) — pipeline runs in the current session via `run-feature.sh run`. Visible output and direct error feedback.
+   - Background daemon — pipeline runs fully detached via `launch-feature-daemon.sh`. Survives AI CLI session closure.
+   - Manual — display the final assembled commands only. Do not execute anything. User runs them on their own.
+
+   ⚠️ STOP HERE and wait for user response before continuing to step 6.
+
+6. **Ask configuration options** ⚠️ MANDATORY INTERACTIVE STEP — applies to ALL execution modes (Foreground, Background, AND Manual). This is a SEPARATE `AskUserQuestion` call from step 5. You MUST ask the user to configure options and WAIT for their response BEFORE proceeding to step 7.
 
    ⛔ **HARD STOP**: You MUST call `AskUserQuestion` with the 4 questions below and WAIT for the user's response. You MUST NOT:
+   - Combine step 5 and step 6 into one `AskUserQuestion` call (this is the most common violation — execution mode MUST be asked separately in step 5)
    - Skip this step and jump to step 7
    - Merge step 6 and step 7 into one response
    - Assume default values and show the command without asking
    - Show the command as text and ask "ready?" without presenting the options
-   If you find yourself writing the final command before the user has answered these questions, STOP — you are violating this rule.
+   If you find yourself writing the final command before the user has answered these 4 questions, STOP — you are violating this rule.
 
-   Use `AskUserQuestion` to present the following configuration choices. Each question is a separate selectable option:
+   Use `AskUserQuestion` to present ALL 4 configuration choices (the full 4-question budget goes to config, NOT shared with execution mode):
 
    **Question 1 — Critic review** (multiSelect: false):
    - Off (default) — Skip adversarial review
@@ -162,9 +169,7 @@ Detect user intent from their message, then follow the corresponding workflow:
 
    **Question 4 — Advanced config?** (multiSelect: false):
    - No (default) — Use defaults for session timeout and failure behavior
-   - Yes — Configure session timeout and stop-on-failure options
-
-   Note: Due to the 4-question limit per `AskUserQuestion` call, Feature filter and Browser verify use their defaults (all features, auto-detect browser tools). If the user selects "Other" on any option, handle their custom input.
+   - Yes — Configure session timeout, stop-on-failure, and deploy-after-completion options
 
    Default Critic to Off unless features have `estimated_complexity: "high"` or above (in which case default to On).
 

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

@@ -284,10 +284,11 @@ A feature is **exempt** when ANY true:
 
 ### Default Behavior (Phase 4.2)
 
-1. **Auto-generate** `browser_interaction` for ALL qualifying features. Read `${SKILL_DIR}/references/browser-interaction.md` for the object format, field rules, and `tool` selection guide.
-2. **Tool selection**: Default `tool` to `"auto"`. Override to `"opencli"` when the feature involves OAuth/SSO callbacks, third-party dashboard verification, or requires real login state. Override to `"playwright-cli"` when the feature is purely local UI (forms, components, routing).
-3. **Present a summary** to the user showing which features received `browser_interaction` (including the `tool` value).
-4. **User can opt-OUT** specific features or override the `tool` choice.
+1. **Ask user for browser tool preference (Mandatory)**: Before generating any `browser_interaction` fields, use `AskUserQuestion` to ask which browser verification tool to use as the project default. Read `${SKILL_DIR}/references/browser-interaction.md` §Browser Tool Selection for the exact question format and options (`auto`/`playwright-cli`/`opencli`). Do NOT skip this step or assume a default without asking.
+2. **Auto-generate** `browser_interaction` for ALL qualifying features. Read `${SKILL_DIR}/references/browser-interaction.md` for the object format, field rules, and per-feature `tool` override logic.
+3. **Tool assignment per feature**: Use the user's chosen default. Override to `"opencli"` when the feature involves OAuth/SSO callbacks, third-party dashboard verification, or requires real login state. Override to `"playwright-cli"` when the feature is purely local UI (forms, components, routing). If user chose `"auto"`, AI assigns per-feature based on these rules.
+4. **Present a summary** to the user showing which features received `browser_interaction` (including the `tool` value for each).
+5. **User can opt-OUT** specific features or override the `tool` choice.
 
 ## Output Rules
 
@@ -323,7 +324,7 @@ Set default testing-related fields for each feature. The user can opt out.
 | medium | `true` | `1` | Single critic review |
 | low | `false` | (omitted) | Skip critic |
 
-For frontend features with `browser_interaction`, browser verification is enabled by default. The `tool` field determines which browser tool is used (default: `auto` — AI chooses at runtime between `playwright-cli` and `opencli`).
+For frontend features with `browser_interaction`, browser verification is enabled by default. The `tool` field uses the user's choice from the mandatory browser tool question in Phase 4.2 (see §Browser Interaction Planning → Default Behavior).
 
 Present a consolidated testing summary table at Phase 8, then ask for confirmation.
 

package/bundled/skills/feature-planner/references/browser-interaction.md

@@ -1,6 +1,17 @@
 # Browser Interaction Planning
 
-For web apps with UI, features that involve user-facing pages or interactive flows can optionally include a `browser_interaction` field. This enables the dev-pipeline to verify UI behavior automatically using `playwright-cli` after implementation.
+For web apps with UI, features that involve user-facing pages or interactive flows can optionally include a `browser_interaction` field. This enables the dev-pipeline to verify UI behavior automatically after implementation using the configured browser tool (`playwright-cli` or `opencli`).
+
+## Browser Tool Selection (Mandatory — Ask User)
+
+Before auto-generating `browser_interaction` for features, you MUST ask the user which browser tool to use as the project default via `AskUserQuestion`:
+
+**Question**: "Which browser verification tool should this project use by default?"
+- **Auto — AI chooses per feature (Recommended)** — `playwright-cli` for local UI, `opencli` for authenticated flows. AI decides per-feature at planning time.
+- **playwright-cli** — isolated browser instance, no login state. Best for local dev server, forms, components.
+- **opencli** — reuses Chrome's logged-in sessions via Browser Bridge. Best for OAuth, third-party dashboards, SSO.
+
+Store the user's choice as the project-level default. Individual features can still override (see Tool Selection per Feature below).
 
 ## How to Capture
 
@@ -11,6 +22,7 @@ For each qualifying feature, generate the `browser_interaction` object:
 ```json
 {
   "browser_interaction": {
+    "tool": "auto",
     "verify_steps": [
       "Verify login form renders with email and password fields",
       "Verify valid credentials redirect to dashboard",

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

@@ -71,7 +71,7 @@ BROWNFIELD WORKFLOW (existing project):
    - TOP-LEVEL modules: directories directly under project root that contain source files or sub-directories with source files (e.g. `src/`, `internal/`, `lib/`)
    - SUB-MODULES: directories INSIDE a top-level module (e.g. `src/routes/`, `src/models/`)
    - A sub-module maps to `.prizmkit/prizm-docs/<M>/<S>.prizm`, never to `.prizmkit/prizm-docs/<S>.prizm` — flattening would create ambiguous paths when two modules have identically-named sub-modules
-   - Exclude: `.git/`, `node_modules/`, `vendor/`, `build/`, `dist/`, `__pycache__/`, `target/`, `bin/`, `.claude/`, `.codebuddy/`, `.prizmkit/`, `.prizmkit/prizm-docs/`, `dev-pipeline/`
+   - Exclude: `.git/`, `node_modules/`, `vendor/`, `build/`, `dist/`, `__pycache__/`, `target/`, `bin/`, `.claude/`, `.codebuddy/`, `.prizmkit/`
    - **Scan command** — run this to get a 2-level directory tree (excludes noise directories):
      ```bash
      find . -maxdepth 2 -type d \
@@ -79,8 +79,7 @@ BROWNFIELD WORKFLOW (existing project):
        -not -path '*/dist/*' -not -path '*/build/*' \
        -not -path '*/__pycache__/*' -not -path '*/vendor/*' \
        -not -path '*/.claude/*' -not -path '*/.codebuddy/*' \
-       -not -path '*/.prizmkit/*' -not -path '*/.prizmkit/prizm-docs/*' \
-       -not -path '*/dev-pipeline/*' -not -path '*/target/*' \
+       -not -path '*/.prizmkit/*' -not -path '*/target/*' \
        | sed -e 's;[^/]*/;|____;g;s;____|; |;g'
      ```
 3. Identify entry points by language convention

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

@@ -130,23 +130,30 @@ Detect user intent from their message, then follow the corresponding workflow:
 
    Wait for user confirmation before proceeding.
 
-5. **Ask execution mode** (first user decision):
+5. **Ask execution mode** (first user decision — SEPARATE `AskUserQuestion` call):
 
-   Present the three modes and ask the user to choose:
-   - **(1) Foreground** (recommended) — pipeline runs in the current session via `run-refactor.sh run`. Visible output and direct error feedback.
-   - **(2) Background daemon** — pipeline runs fully detached via `launch-refactor-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.
+   ⛔ **This MUST be its own standalone `AskUserQuestion` call.** Do NOT combine execution mode with step 6 config questions. The execution mode question is asked ALONE, user responds, THEN you proceed to step 6.
 
-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.
+   Use `AskUserQuestion` with exactly 1 question:
 
-   ⛔ **HARD STOP**: You MUST call `AskUserQuestion` with the questions below and WAIT for the user's response. You MUST NOT:
+   **Question 1 — Execution mode** (multiSelect: false):
+   - Foreground (Recommended) — pipeline runs in the current session via `run-refactor.sh run`. Visible output and direct error feedback.
+   - Background daemon — pipeline runs fully detached via `launch-refactor-daemon.sh`. Survives AI CLI session closure.
+   - Manual — display the final assembled commands only. Do not execute anything. User runs them on their own.
+
+   ⚠️ STOP HERE and wait for user response before continuing to step 6.
+
+6. **Ask configuration options** ⚠️ MANDATORY INTERACTIVE STEP — applies to ALL execution modes (Foreground, Background, AND Manual). This is a SEPARATE `AskUserQuestion` call from step 5. You MUST ask the user to configure options and WAIT for their response BEFORE proceeding to step 7.
+
+   ⛔ **HARD STOP**: You MUST call `AskUserQuestion` with the 4 questions below and WAIT for the user's response. You MUST NOT:
+   - Combine step 5 and step 6 into one `AskUserQuestion` call (this is the most common violation — execution mode MUST be asked separately in step 5)
    - Skip this step and jump to step 7
    - Merge step 6 and step 7 into one response
    - Assume default values and show the command without asking
    - Show the command as text and ask "ready?" without presenting the options
-   If you find yourself writing the final command before the user has answered these questions, STOP — you are violating this rule.
+   If you find yourself writing the final command before the user has answered these 4 questions, STOP — you are violating this rule.
 
-   Use `AskUserQuestion` to present the following configuration choices. Each question is a separate selectable option:
+   Use `AskUserQuestion` to present ALL 4 configuration choices (the full 4-question budget goes to config, NOT shared with execution mode):
 
    **Question 1 — Verbose logging** (multiSelect: false):
    - On (default) — Detailed AI session logs including tool calls and subagent activity

package/package.json

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

package/src/gitignore-template.js

@@ -11,44 +11,9 @@
 export function generateGitignore(options = {}) {
   void options;
   const lines = [
-    '# ===========================',
-    '# PrizmKit Runtime Artifacts',
-    '# ===========================',
-    '',
     '# PrizmKit 运行时全部产物（state/、prizm-docs/、.env、logs 等）',
     '.prizmkit/*',
-    '',
-    '# 多 Agent 协作临时工作区',
-    '.dev-team/',
-    '',
-    '# Playwright CLI 快照和截图',
-    '.playwright-cli/',
-    '',
   ];
 
-  lines.push(
-    '# ===========================',
-    '# Common',
-    '# ===========================',
-    '',
-    '# Dependencies',
-    'node_modules/',
-    '',
-    '# OS files',
-    '.DS_Store',
-    'Thumbs.db',
-    '',
-    '# IDE',
-    '.idea/',
-    '.vscode/',
-    '*.swp',
-    '*.swo',
-    '',
-    '# Environment',
-    '.env',
-    '.env.local',
-    '',
-  );
-
   return lines.join('\n');
-}
+}