prizmkit 1.1.42 → 1.1.47

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

@@ -43,8 +43,11 @@ set -euo pipefail
 # ============================================================
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-STATE_DIR="${PROJECT_ROOT}/.prizmkit/state/features"
+
+# Source shared common helpers (exports PIPELINE_DIR/PRIZMKIT_DIR/PROJECT_ROOT)
+source "$SCRIPT_DIR/lib/common.sh"
+
+STATE_DIR="${PRIZMKIT_DIR}/state/features"
 SCRIPTS_DIR="$SCRIPT_DIR/scripts"
 
 # Colors
@@ -111,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
@@ -198,7 +201,6 @@ fi
 # Process each feature
 # ============================================================
 
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 RESET_COUNT=0
 FAIL_COUNT=0
 
@@ -270,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 ' ')
@@ -396,9 +398,9 @@ if [[ "$DO_RUN" == true && ${#FEATURE_IDS[@]} -eq 1 ]]; then
     echo ""
     exec "$SCRIPT_DIR/run-feature.sh" run "${FEATURE_IDS[0]}" "$FEATURE_LIST"
 else
-    log_info "  ./dev-pipeline/run-feature.sh run .prizmkit/plans/feature-list.json         # Resume pipeline from first pending"
+    log_info "  ./.prizmkit/dev-pipeline/run-feature.sh run .prizmkit/plans/feature-list.json         # Resume pipeline from first pending"
     if [[ ${#FEATURE_IDS[@]} -eq 1 ]]; then
-        log_info "  ./dev-pipeline/run-feature.sh run ${FEATURE_IDS[0]}     # Run single feature"
+        log_info "  ./.prizmkit/dev-pipeline/run-feature.sh run ${FEATURE_IDS[0]}     # Run single feature"
     fi
 fi
 echo ""

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

@@ -33,8 +33,11 @@ set -euo pipefail
 # ============================================================
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-STATE_DIR="${PROJECT_ROOT}/.prizmkit/state/refactor"
+
+# Source shared common helpers (exports PIPELINE_DIR/PRIZMKIT_DIR/PROJECT_ROOT)
+source "$SCRIPT_DIR/lib/common.sh"
+
+STATE_DIR="${PRIZMKIT_DIR}/state/refactor"
 SCRIPTS_DIR="$SCRIPT_DIR/scripts"
 
 # Colors
@@ -101,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
@@ -188,7 +191,6 @@ fi
 # Process each refactor
 # ============================================================
 
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 RESET_COUNT=0
 FAIL_COUNT=0
 
@@ -259,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 ' ')
@@ -383,9 +385,9 @@ if [[ "$DO_RUN" == true && ${#REFACTOR_IDS[@]} -eq 1 ]]; then
     echo ""
     exec "$SCRIPT_DIR/run-refactor.sh" run "${REFACTOR_IDS[0]}" "$REFACTOR_LIST"
 else
-    log_info "  ./dev-pipeline/run-refactor.sh run .prizmkit/plans/refactor-list.json         # Resume pipeline from first pending"
+    log_info "  ./.prizmkit/dev-pipeline/run-refactor.sh run .prizmkit/plans/refactor-list.json         # Resume pipeline from first pending"
     if [[ ${#REFACTOR_IDS[@]} -eq 1 ]]; then
-        log_info "  ./dev-pipeline/run-refactor.sh run ${REFACTOR_IDS[0]}     # Run single refactor"
+        log_info "  ./.prizmkit/dev-pipeline/run-refactor.sh run ${REFACTOR_IDS[0]}     # Run single refactor"
     fi
 fi
 echo ""

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

@@ -32,8 +32,12 @@ set -euo pipefail
 # ============================================================
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
-STATE_DIR="${PROJECT_ROOT}/.prizmkit/state/bugfix"
+
+# Source shared common helpers (exports PIPELINE_DIR/PRIZMKIT_DIR/PROJECT_ROOT,
+# CLI/platform detection, logs, deps)
+source "$SCRIPT_DIR/lib/common.sh"
+
+STATE_DIR="${PRIZMKIT_DIR}/state/bugfix"
 SCRIPTS_DIR="$SCRIPT_DIR/scripts"
 
 # Configuration
@@ -53,7 +57,6 @@ STOP_ON_FAILURE=${STOP_ON_FAILURE:-0}
 ENABLE_DEPLOY=${ENABLE_DEPLOY:-0}
 
 # Source shared common helpers (CLI/platform detection + logs + deps)
-source "$SCRIPT_DIR/lib/common.sh"
 prizm_detect_cli_and_platform
 
 # Source shared heartbeat library
@@ -190,7 +193,7 @@ spawn_and_wait_session() {
     # ── Determine session outcome from observable signals ──────────────
     local session_status
     local project_root
-    project_root="$(cd "$SCRIPT_DIR/.." && pwd)"
+    project_root="$PROJECT_ROOT"
     local default_branch="$base_branch"
 
     if [[ $exit_code -eq 124 ]]; then
@@ -274,9 +277,7 @@ spawn_and_wait_session() {
 
     # Validate checkpoint completeness after successful session
     if [[ "$session_status" == "success" ]]; then
-        local _ckpt_root
-        _ckpt_root="$(cd "$SCRIPT_DIR/.." && pwd)"
-        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 "
@@ -379,7 +380,7 @@ for bug in data.get('bugs', []):
     fi
 
     # GUARANTEED: always return to original branch (save WIP on dev branch first)
-    branch_ensure_return "$(cd "$SCRIPT_DIR/.." && pwd)" "$_ORIGINAL_BRANCH" "$_DEV_BRANCH_NAME"
+    branch_ensure_return "$PROJECT_ROOT" "$_ORIGINAL_BRANCH" "$_DEV_BRANCH_NAME"
 
     log_info "Bug fix pipeline paused. Run './run-bugfix.sh run' to resume."
     exit 130
@@ -393,7 +394,7 @@ trap cleanup SIGINT SIGTERM
 check_dependencies() {
     prizm_check_common_dependencies "$CLI_CMD"
     local _project_root
-    _project_root="$(cd "$SCRIPT_DIR/.." && pwd)"
+    _project_root="$PROJECT_ROOT"
     prizm_ensure_git_repo "$_project_root"
 }
 
@@ -466,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"
@@ -519,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"
@@ -567,9 +568,9 @@ sys.exit(1)
             log_info "Cleaning artifacts for $bug_id..."
 
             local project_root
-            project_root="$(cd "$SCRIPT_DIR/.." && pwd)"
+            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"
@@ -746,7 +747,7 @@ else:
         fi
 
         # GUARANTEED: always return to original branch (save WIP on dev branch first)
-        branch_ensure_return "$(cd "$SCRIPT_DIR/.." && pwd)" "$_ORIGINAL_BRANCH" "$_DEV_BRANCH_NAME"
+        branch_ensure_return "$PROJECT_ROOT" "$_ORIGINAL_BRANCH" "$_DEV_BRANCH_NAME"
         exit 130
     }
     trap cleanup_single_bug SIGINT SIGTERM
@@ -755,7 +756,7 @@ else:
 
     # Branch lifecycle: create and checkout bugfix branch
     local _proj_root
-    _proj_root="$(cd "$SCRIPT_DIR/.." && pwd)"
+    _proj_root="$PROJECT_ROOT"
     local _source_branch
     _source_branch=$(git -C "$_proj_root" rev-parse --abbrev-ref HEAD 2>/dev/null || echo "main")
     _ORIGINAL_BRANCH="$_source_branch"
@@ -823,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"
@@ -878,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"
@@ -916,7 +917,7 @@ main() {
 
     # Branch lifecycle: per-bug branches (like feature pipeline)
     local _proj_root
-    _proj_root="$(cd "$SCRIPT_DIR/.." && pwd)"
+    _proj_root="$PROJECT_ROOT"
     local _source_branch
     _source_branch=$(git -C "$_proj_root" rev-parse --abbrev-ref HEAD 2>/dev/null || echo "main")
     _ORIGINAL_BRANCH="$_source_branch"
@@ -1208,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" \
@@ -1277,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)
@@ -1287,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
         ;;
@@ -1302,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

@@ -35,8 +35,12 @@ set -euo pipefail
 # ============================================================
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
-STATE_DIR="${PROJECT_ROOT}/.prizmkit/state/features"
+
+# Source shared common helpers (exports PIPELINE_DIR/PRIZMKIT_DIR/PROJECT_ROOT,
+# CLI/platform detection, logs, deps)
+source "$SCRIPT_DIR/lib/common.sh"
+
+STATE_DIR="${PRIZMKIT_DIR}/state/features"
 SCRIPTS_DIR="$SCRIPT_DIR/scripts"
 
 # Configuration (override via environment variables)
@@ -56,7 +60,6 @@ STOP_ON_FAILURE=${STOP_ON_FAILURE:-0}
 ENABLE_DEPLOY=${ENABLE_DEPLOY:-0}
 
 # Source shared common helpers (CLI/platform detection + logs + deps)
-source "$SCRIPT_DIR/lib/common.sh"
 prizm_detect_cli_and_platform
 
 # Source shared heartbeat library
@@ -206,7 +209,7 @@ spawn_and_wait_session() {
     # and working tree cleanliness as the single source of truth.
     local session_status
     local project_root
-    project_root="$(cd "$SCRIPT_DIR/.." && pwd)"
+    project_root="$PROJECT_ROOT"
     local default_branch="$base_branch"
 
     if [[ $exit_code -eq 124 ]]; then
@@ -319,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="$(cd "$SCRIPT_DIR/.." && pwd)"
-        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"
@@ -332,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 "
@@ -374,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="$(cd "$SCRIPT_DIR/.." && pwd)"
-        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
@@ -386,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" \
@@ -468,7 +467,7 @@ for feat in data.get('features', []):
     fi
 
     # GUARANTEED: always return to original branch (save WIP on dev branch first)
-    branch_ensure_return "$(cd "$SCRIPT_DIR/.." && pwd)" "$_ORIGINAL_BRANCH" "$_DEV_BRANCH_NAME"
+    branch_ensure_return "$PROJECT_ROOT" "$_ORIGINAL_BRANCH" "$_DEV_BRANCH_NAME"
 
     log_info "Pipeline paused. Run './run-feature.sh run' to resume."
     exit 130
@@ -482,7 +481,7 @@ trap cleanup SIGINT SIGTERM
 check_dependencies() {
     prizm_check_common_dependencies "$CLI_CMD"
     local _project_root
-    _project_root="$(cd "$SCRIPT_DIR/.." && pwd)"
+    _project_root="$PROJECT_ROOT"
     prizm_ensure_git_repo "$_project_root"
 }
 
@@ -602,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
@@ -710,10 +709,10 @@ sys.exit(1)
             }
 
             local project_root
-            project_root="$(cd "$SCRIPT_DIR/.." && pwd)"
+            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"
@@ -910,7 +909,7 @@ else:
         fi
 
         # GUARANTEED: always return to original branch (save WIP on dev branch first)
-        branch_ensure_return "$(cd "$SCRIPT_DIR/.." && pwd)" "$_ORIGINAL_BRANCH" "$_DEV_BRANCH_NAME"
+        branch_ensure_return "$PROJECT_ROOT" "$_ORIGINAL_BRANCH" "$_DEV_BRANCH_NAME"
         exit 130
     }
     trap cleanup_single_feature SIGINT SIGTERM
@@ -919,7 +918,7 @@ else:
 
     # Branch lifecycle: create and checkout feature branch
     local _proj_root
-    _proj_root="$(cd "$SCRIPT_DIR/.." && pwd)"
+    _proj_root="$PROJECT_ROOT"
     local _source_branch
     _source_branch=$(git -C "$_proj_root" rev-parse --abbrev-ref HEAD 2>/dev/null || echo "main")
     _ORIGINAL_BRANCH="$_source_branch"
@@ -987,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
@@ -1008,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
@@ -1057,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"
@@ -1100,7 +1097,7 @@ main() {
 
     # Branch lifecycle: each feature gets its own dev branch (created per-iteration below)
     local _proj_root
-    _proj_root="$(cd "$SCRIPT_DIR/.." && pwd)"
+    _proj_root="$PROJECT_ROOT"
     local _source_branch
     _source_branch=$(git -C "$_proj_root" rev-parse --abbrev-ref HEAD 2>/dev/null || echo "main")
     _ORIGINAL_BRANCH="$_source_branch"
@@ -1503,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
@@ -1532,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
         ;;
@@ -1605,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

@@ -34,10 +34,29 @@ set -euo pipefail
 # ============================================================
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
-RECOVERY_STATE_DIR="${PROJECT_ROOT}/.prizmkit/state/recovery"
+
+# Source shared common helpers (exports PIPELINE_DIR/PRIZMKIT_DIR/PROJECT_ROOT,
+# CLI/platform detection, logs, deps)
+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}
@@ -48,7 +67,6 @@ MODEL=${MODEL:-""}
 AUTO_PUSH=${AUTO_PUSH:-0}
 
 # Source shared common helpers (CLI/platform detection + logs + deps)
-source "$SCRIPT_DIR/lib/common.sh"
 prizm_detect_cli_and_platform
 
 # Source shared heartbeat library