prizmkit 1.1.41 → 1.1.46

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
@@ -188,7 +191,6 @@ fi
 # Process each refactor
 # ============================================================
 
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 RESET_COUNT=0
 FAIL_COUNT=0
 
@@ -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
@@ -275,7 +278,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)"
+        _ckpt_root="$PROJECT_ROOT"
         local checkpoint_file="$_ckpt_root/.prizmkit/bugfix/${bug_id}/workflow-checkpoint.json"
         if [[ -f "$checkpoint_file" ]]; then
             local checkpoint_result
@@ -379,7 +382,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 +396,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"
 }
 
@@ -567,7 +570,7 @@ 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"
             if [[ -d "$bugfix_dir" ]]; then
@@ -746,7 +749,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 +758,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"
@@ -916,7 +919,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"

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
@@ -320,7 +323,7 @@ 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)"
+        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"
 
@@ -375,7 +378,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)"
+        project_root_for_failure="$PROJECT_ROOT"
         local failure_log="$project_root_for_failure/.prizmkit/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"
@@ -468,7 +471,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 +485,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"
 }
 
@@ -710,7 +713,7 @@ 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"
@@ -910,7 +913,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 +922,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"
@@ -1100,7 +1103,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"

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

@@ -34,8 +34,12 @@ 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"
 
@@ -48,7 +52,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

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

@@ -33,8 +33,12 @@ set -euo pipefail
 # ============================================================
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
-STATE_DIR="${PROJECT_ROOT}/.prizmkit/state/refactor"
+
+# 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/refactor"
 SCRIPTS_DIR="$SCRIPT_DIR/scripts"
 
 # Configuration
@@ -55,7 +59,6 @@ STRICT_BEHAVIOR_CHECK=${STRICT_BEHAVIOR_CHECK:-1}
 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
@@ -192,7 +195,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
@@ -277,7 +280,7 @@ spawn_and_wait_session() {
     # Validate key artifacts exist after successful session
     if [[ "$session_status" == "success" ]]; then
         local _artifact_root
-        _artifact_root="$(cd "$SCRIPT_DIR/.." && pwd)"
+        _artifact_root="$PROJECT_ROOT"
         local plan_file="$_artifact_root/.prizmkit/refactor/$refactor_id/plan.md"
         if [[ ! -f "$plan_file" ]]; then
             log_warn "ARTIFACT_MISSING: plan.md not found at $plan_file"
@@ -406,7 +409,7 @@ for item in data.get('refactors', []):
     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 "Refactor pipeline paused. Run './run-refactor.sh run' to resume."
     exit 130
@@ -420,7 +423,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"
 }
 
@@ -594,7 +597,7 @@ sys.exit(1)
             log_info "Cleaning artifacts for $refactor_id..."
 
             local project_root
-            project_root="$(cd "$SCRIPT_DIR/.." && pwd)"
+            project_root="$PROJECT_ROOT"
 
             local refactor_dir="$project_root/.prizmkit/refactor/$refactor_id"
             if [[ -d "$refactor_dir" ]]; then
@@ -776,7 +779,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_refactor SIGINT SIGTERM
@@ -785,7 +788,7 @@ else:
 
     # Branch lifecycle: create and checkout refactor 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"
@@ -951,7 +954,7 @@ main() {
 
     # Branch lifecycle: per-refactor 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"
@@ -1195,7 +1198,7 @@ DEPLOY_PROMPT_EOF
         # Validate key artifacts after successful session
         if [[ "$_SPAWN_RESULT" == "success" ]]; then
             local _artifact_root
-            _artifact_root="$(cd "$SCRIPT_DIR/.." && pwd)"
+            _artifact_root="$PROJECT_ROOT"
             local plan_file="$_artifact_root/.prizmkit/refactor/$refactor_id/plan.md"
             if [[ ! -f "$plan_file" ]]; then
                 log_warn "ARTIFACT_MISSING: plan.md not found at $plan_file"

package/bundled/dev-pipeline/scripts/generate-bootstrap-prompt.py

@@ -416,17 +416,17 @@ def _read_project_brief(project_root):
 
 
 def resolve_project_root(script_dir):
-    """Resolve project root as the parent directory of dev-pipeline/.
+    """Resolve project root from script_dir of the prompt-generator script.
 
-    The script lives at dev-pipeline/scripts/, so project root is two
-    levels up from the script directory.
+    Layout-aware:
+      <project>/.prizmkit/dev-pipeline/scripts/  → project root = <project>
+      <repo>/dev-pipeline/scripts/               → project root = <repo>
     """
-    # script_dir = .../dev-pipeline/scripts
-    # dev_pipeline_dir = .../dev-pipeline
-    # project_root = .../
-    dev_pipeline_dir = os.path.dirname(script_dir)
-    project_root = os.path.dirname(dev_pipeline_dir)
-    return os.path.abspath(project_root)
+    pipeline_dir = os.path.dirname(script_dir)
+    pipeline_parent = os.path.dirname(pipeline_dir)
+    if os.path.basename(pipeline_parent) == ".prizmkit":
+        return os.path.abspath(os.path.dirname(pipeline_parent))
+    return os.path.abspath(pipeline_parent)
 
 
 def process_conditional_blocks(content, resume_phase):
@@ -557,7 +557,7 @@ def process_mode_blocks(content, pipeline_mode, init_done, critic_enabled=False,
 
 def detect_init_status(project_root):
     """Check if PrizmKit init has already been done."""
-    prizm_docs = os.path.join(project_root, ".prizm-docs", "root.prizm")
+    prizm_docs = os.path.join(project_root, ".prizmkit/prizm-docs", "root.prizm")
     prizmkit_config = os.path.join(project_root, ".prizmkit", "config.json")
     return os.path.isfile(prizm_docs) and os.path.isfile(prizmkit_config)
 
@@ -587,7 +587,7 @@ def determine_pipeline_mode(complexity):
     Tier assignment rationale:
     - low + medium → lite (single agent): most features don't benefit from
       the orchestrator→dev→reviewer overhead. A single agent reading
-      .prizm-docs + implementing directly is faster and cheaper.
+      .prizmkit/prizm-docs + implementing directly is faster and cheaper.
     - high → standard (orchestrator + dev + reviewer): complex features
       need the spec→plan→analyze→implement→review pipeline.
     - critical → full (full team + framework guardrails): architectural
@@ -612,7 +612,7 @@ def determine_pipeline_mode(complexity):
 # merge_checkpoint_state() never collides.
 SECTION_TO_SKILL = {
     "phase0-init": ("prizmkit-init", "Project Bootstrap",
-                    [".prizm-docs/root.prizm", ".prizmkit/config.json"]),
+                    [".prizmkit/prizm-docs/root.prizm", ".prizmkit/config.json"]),
     "phase0-test-baseline": ("test-baseline", "Test Baseline", []),
     "phase-context-snapshot": ("context-snapshot", "Build Context Snapshot",
                                [".prizmkit/specs/{slug}/context-snapshot.md"]),
@@ -631,7 +631,7 @@ SECTION_TO_SKILL = {
 # phase-commit is split into two steps
 _COMMIT_STEPS = [
     ("prizmkit-retrospective", "Retrospective", []),
-    ("prizmkit-committer", "Commit", []),
+    ("prizmkit-committer", "Commit", ["--headless"]),
 ]
 
 
@@ -1239,8 +1239,8 @@ def build_replacements(args, feature, features, global_context, script_dir):
                 "Run `npx prizmkit install` to reinstall agent definitions.",
                 agent_path, agent_name,
             )
-    # Validator scripts - check if they exist in .codebuddy/scripts/, otherwise use dev-pipeline/scripts/
-    validator_scripts_dir = os.path.join(project_root, "dev-pipeline", "scripts")
+    # Validator scripts - check if they exist in .codebuddy/scripts/, otherwise use .prizmkit/dev-pipeline/scripts/
+    validator_scripts_dir = os.path.join(project_root, ".prizmkit", "dev-pipeline", "scripts")
     init_script_path = os.path.join(validator_scripts_dir, "init-dev-team.py")
 
     # Session status path (relative to project root)

package/bundled/dev-pipeline/scripts/generate-bugfix-prompt.py

@@ -208,10 +208,15 @@ def get_prev_session_status(state_dir, bug_id):
 
 
 def resolve_project_root(script_dir):
-    """Resolve project root as the parent of dev-pipeline/."""
-    dev_pipeline_dir = os.path.dirname(script_dir)
-    project_root = os.path.dirname(dev_pipeline_dir)
-    return os.path.abspath(project_root)
+    """Resolve project root. Layout-aware:
+      <project>/.prizmkit/dev-pipeline/scripts/  → <project>
+      <repo>/dev-pipeline/scripts/               → <repo>
+    """
+    pipeline_dir = os.path.dirname(script_dir)
+    pipeline_parent = os.path.dirname(pipeline_dir)
+    if os.path.basename(pipeline_parent) == ".prizmkit":
+        return os.path.abspath(os.path.dirname(pipeline_parent))
+    return os.path.abspath(pipeline_parent)
 
 
 def build_replacements(args, bug, global_context, script_dir):
@@ -450,7 +455,7 @@ BUGFIX_STEPS = [
       ".prizmkit/bugfix/{slug}/plan.md"]),
     ("prizmkit-implement", "Implement Fix", []),
     ("prizmkit-code-review", "Code Review", []),
-    ("prizmkit-committer", "Commit", []),
+    ("prizmkit-committer", "Commit", ["--headless"]),
     ("bug-report", "Generate Fix Report",
      [".prizmkit/bugfix/{slug}/fix-report.md"]),
 ]

package/bundled/dev-pipeline/scripts/generate-recovery-prompt.py

@@ -57,7 +57,7 @@ Use whatever information is available:
 - Read bug entry from `.prizmkit/plans/bug-fix-list.json` if bug ID is known
 - Read any existing artifacts in `.prizmkit/bugfix/{bug_id}/`
 - Read relevant source code and test files
-- Read `.prizm-docs/` for affected modules
+- Read `.prizmkit/prizm-docs/` for affected modules
 
 Produce a bug summary with: symptom, reproduction steps, expected behavior,
 affected files, and root cause hypothesis.""",
@@ -66,9 +66,9 @@ affected files, and root cause hypothesis.""",
         "Triage",
         """\
 Locate affected code and identify root cause:
-1. Read `.prizm-docs/root.prizm` then relevant L1/L2 docs for affected modules
+1. Read `.prizmkit/prizm-docs/root.prizm` then relevant L1/L2 docs for affected modules
 2. Read files mentioned in the bug description or error/stack trace
-3. Check `.prizm-docs/` TRAPS for known patterns
+3. Check `.prizmkit/prizm-docs/` TRAPS for known patterns
 4. Classify: root cause (confirmed/suspected), blast radius, fix complexity
 5. Log your diagnosis (no need to ask for user confirmation in autonomous mode)""",
     ),
@@ -115,9 +115,9 @@ for manual user testing:
         """\
 Commit the fix and finalize:
 1. Run `/prizmkit-retrospective` (structural sync only — update file counts,
-   interfaces, dependencies in .prizm-docs/)
+   interfaces, dependencies in .prizmkit/prizm-docs/)
 2. Stage all changed files explicitly (NEVER use `git add -A` or `git add .`)
-3. Run `/prizmkit-committer` with commit prefix `fix(<scope>): <description>`
+3. Run `/prizmkit-committer --headless` with commit prefix `fix(<scope>): <description>`
 4. Verify working tree is clean: `git status --short`
 5. Write `fix-report.md` to `.prizmkit/bugfix/{bug_id}/fix-report.md` with:
    - Root cause summary
@@ -132,7 +132,7 @@ FEATURE_PHASES = {
         "Brainstorm",
         """\
 Since this is an autonomous recovery session, work with whatever context is
-available. Read existing project files, `.prizm-docs/`, and any user-provided
+available. Read existing project files, `.prizmkit/prizm-docs/`, and any user-provided
 materials to understand the requirements. Skip interactive Q&A.
 Produce a requirements summary if one doesn't already exist.""",
     ),
@@ -153,7 +153,7 @@ Invoke `/feature-pipeline-launcher` skill:
 
 If `/feature-pipeline-launcher` is not available, run the pipeline directly:
 ```bash
-./dev-pipeline/run-feature.sh run .prizmkit/plans/feature-list.json
+./.prizmkit/dev-pipeline/run-feature.sh run .prizmkit/plans/feature-list.json
 ```""",
     ),
     4: (
@@ -161,7 +161,7 @@ If `/feature-pipeline-launcher` is not available, run the pipeline directly:
         """\
 Check pipeline status and report results:
 ```bash
-python3 dev-pipeline/scripts/update-feature-status.py \\
+python3 .prizmkit/dev-pipeline/scripts/update-feature-status.py \\
   --feature-list .prizmkit/plans/feature-list.json \\
   --state-dir .prizmkit/state/features \\
   --action status
@@ -175,7 +175,7 @@ REFACTOR_PHASES = {
         "Brainstorm",
         """\
 Since this is an autonomous recovery session, work with whatever context is
-available. Read existing project files, `.prizm-docs/`, and any materials
+available. Read existing project files, `.prizmkit/prizm-docs/`, and any materials
 to understand the refactoring goals. Skip interactive Q&A.
 Produce a refactoring goals summary if one doesn't already exist.""",
     ),
@@ -196,7 +196,7 @@ Invoke `/refactor-pipeline-launcher` skill:
 
 If `/refactor-pipeline-launcher` is not available, run the pipeline directly:
 ```bash
-./dev-pipeline/run-refactor.sh run .prizmkit/plans/refactor-list.json
+./.prizmkit/dev-pipeline/run-refactor.sh run .prizmkit/plans/refactor-list.json
 ```""",
     ),
     4: (
@@ -204,7 +204,7 @@ If `/refactor-pipeline-launcher` is not available, run the pipeline directly:
         """\
 Check pipeline status and report results:
 ```bash
-python3 dev-pipeline/scripts/update-refactor-status.py \\
+python3 .prizmkit/dev-pipeline/scripts/update-refactor-status.py \\
   --refactor-list .prizmkit/plans/refactor-list.json \\
   --state-dir .prizmkit/state/refactor \\
   --action status
@@ -688,9 +688,15 @@ def resolve_project_root(given_root):
     """Resolve project root from argument or git."""
     if given_root:
         return os.path.abspath(given_root)
-    # Auto-detect: script is at dev-pipeline/scripts/, project root is 2 levels up
+    # Auto-detect across two layouts:
+    #   <project>/.prizmkit/dev-pipeline/scripts/  → up 3 levels
+    #   <repo>/dev-pipeline/scripts/               → up 2 levels
     script_dir = os.path.dirname(os.path.abspath(__file__))
-    return os.path.dirname(os.path.dirname(script_dir))
+    pipeline_dir = os.path.dirname(script_dir)
+    pipeline_parent = os.path.dirname(pipeline_dir)
+    if os.path.basename(pipeline_parent) == ".prizmkit":
+        return os.path.dirname(pipeline_parent)
+    return pipeline_parent
 
 
 def emit_failure(message):

package/bundled/dev-pipeline/scripts/generate-refactor-prompt.py

@@ -40,7 +40,7 @@ REFACTOR_STEPS = [
     ("prizmkit-code-review", "Review — Code Review & Behavior Verification",
      [".prizmkit/refactor/{slug}/review-report.md"]),
     ("prizmkit-committer", "Commit",
-     []),
+     ["--headless"]),
     ("refactor-report", "Generate Refactor Report",
      [".prizmkit/refactor/{slug}/refactor-report.md"]),
 ]
@@ -357,10 +357,15 @@ def get_prev_session_status(state_dir, refactor_id):
 
 
 def resolve_project_root(script_dir):
-    """Resolve project root as the parent of dev-pipeline/."""
-    dev_pipeline_dir = os.path.dirname(script_dir)
-    project_root = os.path.dirname(dev_pipeline_dir)
-    return os.path.abspath(project_root)
+    """Resolve project root. Layout-aware:
+      <project>/.prizmkit/dev-pipeline/scripts/  → <project>
+      <repo>/dev-pipeline/scripts/               → <repo>
+    """
+    pipeline_dir = os.path.dirname(script_dir)
+    pipeline_parent = os.path.dirname(pipeline_dir)
+    if os.path.basename(pipeline_parent) == ".prizmkit":
+        return os.path.abspath(os.path.dirname(pipeline_parent))
+    return os.path.abspath(pipeline_parent)
 
 
 def build_replacements(args, refactor, refactors, global_context, script_dir):

package/bundled/dev-pipeline/scripts/parse-stream-progress.py

@@ -50,7 +50,7 @@ PHASE_KEYWORDS = {
     },
     "retrospective": {
         "strong": ["prizmkit-retrospective"],
-        "weak": ["retrospective", "structural sync", "architecture knowledge", ".prizm-docs/ sync"],
+        "weak": ["retrospective", "structural sync", "architecture knowledge", ".prizmkit/prizm-docs/ sync"],
     },
     "commit": {
         "strong": ["prizmkit-committer"],

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

@@ -341,7 +341,15 @@ def action_update(args, bug_list_path, state_dir):
 
 
 def _default_project_root():
-    return os.path.abspath(os.path.join(os.path.dirname(__file__), "..", ".."))
+    env = os.environ.get("PROJECT_ROOT")
+    if env:
+        return os.path.abspath(env)
+    script_dir = os.path.dirname(os.path.abspath(__file__))
+    pipeline_dir = os.path.dirname(script_dir)
+    pipeline_parent = os.path.dirname(pipeline_dir)
+    if os.path.basename(pipeline_parent) == ".prizmkit":
+        return os.path.dirname(pipeline_parent)
+    return pipeline_parent
 
 
 def cleanup_bug_artifacts(state_dir, bug_id, project_root=None):

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

@@ -236,7 +236,19 @@ def update_feature_in_list(feature_list_path, feature_id, new_status):
 
 
 def _default_project_root():
-    return os.path.abspath(os.path.join(os.path.dirname(__file__), "..", ".."))
+    # Script lives at <pipeline>/scripts/update-feature-status.py.
+    # Pipeline may be either <project>/.prizmkit/dev-pipeline (user install)
+    # or <repo>/dev-pipeline (framework source). Auto-detect by checking if
+    # the parent of dev-pipeline is named ".prizmkit".
+    env = os.environ.get("PROJECT_ROOT")
+    if env:
+        return os.path.abspath(env)
+    script_dir = os.path.dirname(os.path.abspath(__file__))
+    pipeline_dir = os.path.dirname(script_dir)
+    pipeline_parent = os.path.dirname(pipeline_dir)
+    if os.path.basename(pipeline_parent) == ".prizmkit":
+        return os.path.dirname(pipeline_parent)
+    return pipeline_parent
 
 
 def _build_feature_slug(feature_id, title):