prizmkit 1.1.6 → 1.1.8

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

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
-"""Generate a session-specific bug fix bootstrap prompt from template and bug-fix-list.json.
+"""Generate a session-specific bug fix bootstrap prompt from template and .prizmkit/plans/bug-fix-list.json.
 
-Reads the bugfix-bootstrap-prompt.md template and a bug-fix-list.json, resolves all
+Reads the bugfix-bootstrap-prompt.md template and a .prizmkit/plans/bug-fix-list.json, resolves all
 {{PLACEHOLDER}} variables, handles conditional blocks, and writes the rendered
 prompt to the specified output path.
 
@@ -31,16 +31,16 @@ def parse_args():
     parser = argparse.ArgumentParser(
         description=(
             "Generate a session-specific bug fix bootstrap prompt from a template "
-            "and bug-fix-list.json."
+            "and .prizmkit/plans/bug-fix-list.json."
         )
     )
-    parser.add_argument("--bug-list", required=True, help="Path to bug-fix-list.json")
+    parser.add_argument("--bug-list", required=True, help="Path to .prizmkit/plans/bug-fix-list.json")
     parser.add_argument("--bug-id", required=True, help="Bug ID to generate prompt for (e.g. B-001)")
     parser.add_argument("--session-id", required=True, help="Session ID for this pipeline session")
     parser.add_argument("--run-id", required=True, help="Pipeline run ID")
     parser.add_argument("--retry-count", required=True, help="Current retry count")
     parser.add_argument("--resume-phase", required=True, help='Phase to resume from, or "null" for fresh start')
-    parser.add_argument("--state-dir", default=None, help="State directory path for reading previous session info")
+    parser.add_argument("--state-dir", default=None, help="State directory (default: .prizmkit/state/bugfix)")
     parser.add_argument("--output", required=True, help="Output path for the rendered prompt")
     parser.add_argument("--template", default=None, help="Custom template path. Defaults to {script_dir}/../templates/bugfix-bootstrap-prompt.md")
     return parser.parse_args()
@@ -217,7 +217,7 @@ def build_replacements(args, bug, global_context, script_dir):
 
     # Session status path
     session_status_path = os.path.join(
-        project_root, "dev-pipeline", "bugfix-state", "bugs", args.bug_id,
+        project_root, ".prizmkit", "state", "bugfix", "bugs", args.bug_id,
         "sessions", args.session_id, "session-status.json"
     )
 

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

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
-"""Generate a session-specific refactor bootstrap prompt from template and refactor-list.json.
+"""Generate a session-specific refactor bootstrap prompt from template and .prizmkit/plans/refactor-list.json.
 
-Reads the refactor-bootstrap-prompt.md template and a refactor-list.json, resolves all
+Reads the refactor-bootstrap-prompt.md template and a .prizmkit/plans/refactor-list.json, resolves all
 {{PLACEHOLDER}} variables, handles conditional blocks, and writes the rendered
 prompt to the specified output path.
 
@@ -30,16 +30,16 @@ def parse_args():
     parser = argparse.ArgumentParser(
         description=(
             "Generate a session-specific refactor bootstrap prompt from a template "
-            "and refactor-list.json."
+            "and .prizmkit/plans/refactor-list.json."
         )
     )
-    parser.add_argument("--refactor-list", required=True, help="Path to refactor-list.json")
+    parser.add_argument("--refactor-list", required=True, help="Path to .prizmkit/plans/refactor-list.json")
     parser.add_argument("--refactor-id", required=True, help="Refactor ID to generate prompt for (e.g. R-001)")
     parser.add_argument("--session-id", required=True, help="Session ID for this pipeline session")
     parser.add_argument("--run-id", required=True, help="Pipeline run ID")
     parser.add_argument("--retry-count", required=True, help="Current retry count")
     parser.add_argument("--resume-phase", required=True, help='Phase to resume from, or "null" for fresh start')
-    parser.add_argument("--state-dir", default=None, help="State directory path for reading previous session info")
+    parser.add_argument("--state-dir", default=None, help="State directory (default: .prizmkit/state/refactor)")
     parser.add_argument("--output", required=True, help="Output path for the rendered prompt")
     parser.add_argument("--template", default=None, help="Custom template path. Defaults to {script_dir}/../templates/refactor-bootstrap-prompt.md")
     return parser.parse_args()
@@ -247,7 +247,7 @@ def build_replacements(args, refactor, global_context, script_dir):
 
     # Session status path
     session_status_path = os.path.join(
-        project_root, "dev-pipeline", "refactor-state", "refactors", args.refactor_id,
+        project_root, ".prizmkit", "state", "refactor", "refactors", args.refactor_id,
         "sessions", args.session_id, "session-status.json"
     )
 

package/bundled/dev-pipeline/scripts/init-bugfix-pipeline.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Initialize the bug-fix pipeline state directory from a bug-fix-list.json file.
+"""Initialize the bug-fix pipeline state directory from a .prizmkit/plans/bug-fix-list.json file.
 
 Validates the bug fix list schema, sorts by priority/severity, and creates
 the state directory structure with pipeline and per-bug status files.
@@ -40,17 +40,17 @@ VALID_STATUSES = [
 
 def parse_args():
     parser = argparse.ArgumentParser(
-        description="Initialize bug-fix pipeline state from a bug-fix-list.json file."
+        description="Initialize bug-fix pipeline state from a .prizmkit/plans/bug-fix-list.json file."
     )
     parser.add_argument(
         "--bug-list",
         required=True,
-        help="Path to the bug-fix-list.json file",
+        help="Path to the .prizmkit/plans/bug-fix-list.json file",
     )
     parser.add_argument(
         "--state-dir",
         required=True,
-        help="Path to the state directory to create/initialize",
+        help="Path to the state directory (default: .prizmkit/state/bugfix)",
     )
     return parser.parse_args()
 

package/bundled/dev-pipeline/scripts/init-pipeline.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Initialize the dev-pipeline state directory from a feature-list.json file.
+"""Initialize the dev-pipeline state directory from a .prizmkit/plans/feature-list.json file.
 
 Validates the feature list schema, checks dependency DAG for cycles,
 and creates the state directory structure with pipeline and feature status files.
@@ -20,6 +20,7 @@ from datetime import datetime, timezone
 EXPECTED_SCHEMA = "dev-pipeline-feature-list-v1"
 FEATURE_ID_PATTERN = re.compile(r"^F-\d{3}$")
 TERMINAL_STATUSES = {"completed", "failed", "skipped"}
+VALID_PRIORITIES = {"critical", "high", "medium", "low"}
 
 REQUIRED_FEATURE_FIELDS = [
     "id",
@@ -34,17 +35,17 @@ REQUIRED_FEATURE_FIELDS = [
 
 def parse_args():
     parser = argparse.ArgumentParser(
-        description="Initialize dev-pipeline state from a feature-list.json file."
+        description="Initialize dev-pipeline state from a .prizmkit/plans/feature-list.json file."
     )
     parser.add_argument(
         "--feature-list",
         required=True,
-        help="Path to the feature-list.json file",
+        help="Path to the .prizmkit/plans/feature-list.json file",
     )
     parser.add_argument(
         "--state-dir",
         required=True,
-        help="Path to the state directory to create/initialize",
+        help="Path to the state directory (default: .prizmkit/state/features)",
     )
     return parser.parse_args()
 
@@ -75,11 +76,12 @@ def validate_schema(data):
             "Invalid $schema: expected '{}', got '{}'".format(EXPECTED_SCHEMA, schema)
         )
 
-    # Check app_name
-    if "app_name" not in data:
-        errors.append("Missing required field: app_name")
-    elif not isinstance(data["app_name"], str) or not data["app_name"].strip():
-        errors.append("app_name must be a non-empty string")
+    # Check project_name (supports legacy app_name for backward compatibility)
+    project_name = data.get("project_name", data.get("app_name"))
+    if project_name is None:
+        errors.append("Missing required field: project_name")
+    elif not isinstance(project_name, str) or not project_name.strip():
+        errors.append("project_name must be a non-empty string")
 
     # Check features array
     if "features" not in data:
@@ -132,6 +134,18 @@ def validate_features(features):
                 )
             )
 
+        # Validate priority enum
+        priority = feature.get("priority")
+        if priority is not None and priority not in VALID_PRIORITIES:
+            errors.append(
+                "Feature '{}' has invalid priority '{}' "
+                "(must be one of: {})".format(
+                    fid if fid else "index {}".format(i),
+                    priority,
+                    ", ".join(sorted(VALID_PRIORITIES)),
+                )
+            )
+
         # Validate acceptance_criteria is a list
         ac = feature.get("acceptance_criteria")
         if ac is not None and not isinstance(ac, list):
@@ -269,7 +283,7 @@ def create_state_directory(state_dir, feature_list_path, features):
         sessions_dir = os.path.join(feature_dir, "sessions")
         os.makedirs(sessions_dir, exist_ok=True)
 
-        # Respect existing terminal status from feature-list.json
+        # Respect existing terminal status from .prizmkit/plans/feature-list.json
         fl_status = feature.get("status", "pending")
         init_status = fl_status if fl_status in TERMINAL_STATUSES else "pending"
 
@@ -302,13 +316,13 @@ def main():
         print(json.dumps(output, indent=2, ensure_ascii=False))
         sys.exit(1)
 
-    # Warn if feature-list.json is not at project root
+    # Warn if .prizmkit/plans/feature-list.json is not at project root
     feature_list_dir = os.path.dirname(os.path.abspath(args.feature_list))
     indicators = ['.git', 'package.json', '.prizmkit']
     is_at_root = any(os.path.exists(os.path.join(feature_list_dir, i)) for i in indicators)
     if not is_at_root:
         sys.stderr.write(
-            "Warning: feature-list.json may not be at project root: {}\n".format(feature_list_dir)
+            "Warning: .prizmkit/plans/feature-list.json may not be at project root: {}\n".format(feature_list_dir)
         )
 
     # Validate schema

package/bundled/dev-pipeline/scripts/init-refactor-pipeline.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Initialize the refactor pipeline state directory from a refactor-list.json file.
+"""Initialize the refactor pipeline state directory from a .prizmkit/plans/refactor-list.json file.
 
 Validates the refactor list schema, sorts by priority/complexity, checks for
 circular dependencies, and creates the state directory structure with pipeline
@@ -47,17 +47,17 @@ VALID_BEHAVIOR_STRATEGIES = ["test-gate", "snapshot", "manual"]
 
 def parse_args():
     parser = argparse.ArgumentParser(
-        description="Initialize refactor pipeline state from a refactor-list.json file."
+        description="Initialize refactor pipeline state from a .prizmkit/plans/refactor-list.json file."
     )
     parser.add_argument(
         "--refactor-list",
         required=True,
-        help="Path to the refactor-list.json file",
+        help="Path to the .prizmkit/plans/refactor-list.json file",
     )
     parser.add_argument(
         "--state-dir",
         required=True,
-        help="Path to the state directory to create/initialize",
+        help="Path to the state directory (default: .prizmkit/state/refactor)",
     )
     return parser.parse_args()
 

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

@@ -57,8 +57,8 @@ def parse_args():
     parser = argparse.ArgumentParser(
         description="Core state machine for bug-fix pipeline bug status management."
     )
-    parser.add_argument("--bug-list", required=True, help="Path to the bug-fix-list.json file")
-    parser.add_argument("--state-dir", required=True, help="Path to the bugfix-state/ directory")
+    parser.add_argument("--bug-list", required=True, help="Path to the .prizmkit/plans/bug-fix-list.json file")
+    parser.add_argument("--state-dir", required=True, help="Path to the state directory (default: .prizmkit/state/bugfix)")
     parser.add_argument(
         "--action", required=True,
         choices=["get_next", "update", "status", "pause", "reset", "clean"],
@@ -128,7 +128,7 @@ def update_bug_in_list(bug_list_path, bug_id, new_status):
             found = True
             break
     if not found:
-        return "Bug '{}' not found in bug-fix-list.json".format(bug_id)
+        return "Bug '{}' not found in .prizmkit/plans/bug-fix-list.json".format(bug_id)
     return write_json_file(bug_list_path, data)
 
 
@@ -183,12 +183,12 @@ def action_get_next(bug_list_data, state_dir):
         elif bstatus == "pending":
             pending_bugs.append(bug)
 
-    _PRIORITY_ORDER = {"high": 0, "medium": 1, "low": 2}
+    _PRIORITY_ORDER = {"critical": 0, "high": 1, "medium": 2, "low": 3}
 
     def sort_key(b):
         severity = b.get("severity", "medium")
         sev_order = SEVERITY_PRIORITY.get(severity, 2)
-        priority = _PRIORITY_ORDER.get(b.get("priority", "low"), 2)
+        priority = _PRIORITY_ORDER.get(b.get("priority", "low"), 3)
         return (sev_order, priority)
 
     if in_progress_bugs:
@@ -238,7 +238,7 @@ def action_update(args, bug_list_path, state_dir):
         bs["resume_from_phase"] = None
         err = update_bug_in_list(bug_list_path, bug_id, "completed")
         if err:
-            error_out("Failed to update bug-fix-list.json: {}".format(err))
+            error_out("Failed to update .prizmkit/plans/bug-fix-list.json: {}".format(err))
             return
     elif session_status == "merge_conflict":
         # Degraded outcome: keep artifacts for retry (branch preserves work)
@@ -257,7 +257,7 @@ def action_update(args, bug_list_path, state_dir):
 
         err = update_bug_in_list(bug_list_path, bug_id, target_status)
         if err:
-            error_out("Failed to update bug-fix-list.json: {}".format(err))
+            error_out("Failed to update .prizmkit/plans/bug-fix-list.json: {}".format(err))
             return
     else:
         bs["retry_count"] = bs.get("retry_count", 0) + 1
@@ -281,7 +281,7 @@ def action_update(args, bug_list_path, state_dir):
 
         err = update_bug_in_list(bug_list_path, bug_id, target_status)
         if err:
-            error_out("Failed to update bug-fix-list.json: {}".format(err))
+            error_out("Failed to update .prizmkit/plans/bug-fix-list.json: {}".format(err))
             return
 
     if session_status == "success" and session_id:
@@ -544,7 +544,7 @@ def action_reset(args, bug_list_path, state_dir):
 
     err = update_bug_in_list(bug_list_path, bug_id, "pending")
     if err:
-        error_out("Failed to update bug-fix-list.json: {}".format(err))
+        error_out("Failed to update .prizmkit/plans/bug-fix-list.json: {}".format(err))
         return
 
     result = {
@@ -620,7 +620,7 @@ def action_clean(args, bug_list_path, state_dir):
 
     err = update_bug_in_list(bug_list_path, bug_id, "pending")
     if err:
-        error_out("Failed to update bug-fix-list.json: {}".format(err))
+        error_out("Failed to update .prizmkit/plans/bug-fix-list.json: {}".format(err))
         return
 
     result = {

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

@@ -60,12 +60,12 @@ def parse_args():
     parser.add_argument(
         "--feature-list",
         required=True,
-        help="Path to the feature-list.json file",
+        help="Path to the .prizmkit/plans/feature-list.json file",
     )
     parser.add_argument(
         "--state-dir",
         required=True,
-        help="Path to the state/ directory",
+        help="Path to the state directory (default: .prizmkit/state/features)",
     )
     parser.add_argument(
         "--action",
@@ -159,7 +159,7 @@ def load_feature_status(state_dir, feature_id, feature_list_status=None):
     If the file does not exist, return a default pending status.
 
     If feature_list_status is a terminal status (completed, failed, skipped),
-    it overrides the status field from status.json. This makes feature-list.json
+    it overrides the status field from status.json. This makes .prizmkit/plans/feature-list.json
     the single source of truth for terminal statuses, while all other fields
     (retry_count, sessions, etc.) still come from status.json.
     """
@@ -195,7 +195,7 @@ def load_feature_status(state_dir, feature_id, feature_list_status=None):
             "created_at": now,
             "updated_at": now,
         }
-    # feature-list.json wins for terminal statuses
+    # .prizmkit/plans/feature-list.json wins for terminal statuses
     if feature_list_status in TERMINAL_STATUSES:
         data["status"] = feature_list_status
     return data
@@ -210,7 +210,7 @@ def save_feature_status(state_dir, feature_id, status_data):
 
 
 def update_feature_in_list(feature_list_path, feature_id, new_status):
-    """Update a feature's status field in feature-list.json.
+    """Update a feature's status field in .prizmkit/plans/feature-list.json.
 
     Reads the whole file, modifies the target feature's status, writes back.
     Returns an error string on failure, None on success.
@@ -226,7 +226,7 @@ def update_feature_in_list(feature_list_path, feature_id, new_status):
             found = True
             break
     if not found:
-        return "Feature '{}' not found in feature-list.json".format(feature_id)
+        return "Feature '{}' not found in .prizmkit/plans/feature-list.json".format(feature_id)
     return write_json_file(feature_list_path, data)
 
 
@@ -336,13 +336,13 @@ def auto_skip_blocked_features(feature_list_path, state_dir, failed_feature_id):
     by marking those blocked features as auto_skipped, allowing the pipeline to
     continue processing unblocked features and eventually reach PIPELINE_COMPLETE.
 
-    Re-reads feature-list.json from disk to get the latest state (including the
+    Re-reads .prizmkit/plans/feature-list.json from disk to get the latest state (including the
     just-written failed status from update_feature_in_list).
 
-    NOTE: This function performs a read-modify-write on feature-list.json without
-    file locking. The caller (action_update) also writes to feature-list.json
+    NOTE: This function performs a read-modify-write on .prizmkit/plans/feature-list.json without
+    file locking. The caller (action_update) also writes to .prizmkit/plans/feature-list.json
     immediately before calling this. Safe for single-pipeline execution, but if
-    multiple pipeline instances share the same feature-list.json concurrently,
+    multiple pipeline instances share the same .prizmkit/plans/feature-list.json concurrently,
     a race condition may cause lost writes. Add file locking if parallel pipelines
     are introduced.
     """
@@ -383,7 +383,7 @@ def auto_skip_blocked_features(feature_list_path, state_dir, failed_feature_id):
     if not to_skip:
         return []
 
-    # Batch-write to feature-list.json
+    # Batch-write to .prizmkit/plans/feature-list.json
     for f in features:
         if isinstance(f, dict) and f.get("id") in to_skip:
             f["status"] = "auto_skipped"
@@ -524,19 +524,19 @@ def action_get_next(feature_list_data, state_dir, feature_filter=None):
         else:
             pending_features.append(feature)
 
-    # Priority mapping: string enum → sort order (high first)
-    _PRIORITY_ORDER = {"high": 0, "medium": 1, "low": 2}
+    # Priority mapping: string enum → sort order (critical first)
+    _PRIORITY_ORDER = {"critical": 0, "high": 1, "medium": 2, "low": 3}
 
     # Prefer in_progress features, then pending; sort by priority (high > medium > low)
     if in_progress_features:
         candidates = sorted(
             in_progress_features,
-            key=lambda f: _PRIORITY_ORDER.get(f.get("priority", "low"), 2)
+            key=lambda f: _PRIORITY_ORDER.get(f.get("priority", "low"), 3)
         )
     else:
         candidates = sorted(
             pending_features,
-            key=lambda f: _PRIORITY_ORDER.get(f.get("priority", "low"), 2)
+            key=lambda f: _PRIORITY_ORDER.get(f.get("priority", "low"), 3)
         )
 
     chosen = candidates[0]
@@ -605,7 +605,7 @@ def action_update(args, feature_list_path, state_dir):
         fs["resume_from_phase"] = None
         err = update_feature_in_list(feature_list_path, feature_id, "completed")
         if err:
-            error_out("Failed to update feature-list.json: {}".format(err))
+            error_out("Failed to update .prizmkit/plans/feature-list.json: {}".format(err))
             return
     elif session_status in ("commit_missing", "docs_missing", "merge_conflict"):
         # Degraded outcome: keep artifacts for retry and expose specific status.
@@ -624,7 +624,7 @@ def action_update(args, feature_list_path, state_dir):
 
         err = update_feature_in_list(feature_list_path, feature_id, target_status)
         if err:
-            error_out("Failed to update feature-list.json: {}".format(err))
+            error_out("Failed to update .prizmkit/plans/feature-list.json: {}".format(err))
             return
     else:
         # crashed / failed / timed_out — preserve all artifacts for debugging.
@@ -646,7 +646,7 @@ def action_update(args, feature_list_path, state_dir):
 
         err = update_feature_in_list(feature_list_path, feature_id, target_status)
         if err:
-            error_out("Failed to update feature-list.json: {}".format(err))
+            error_out("Failed to update .prizmkit/plans/feature-list.json: {}".format(err))
             return
 
     if session_status == "success" and session_id:
@@ -860,12 +860,12 @@ def _estimate_remaining_time(features, state_dir, counts, feature_list_data=None
 def action_status(feature_list_data, state_dir, feature_filter=None):
     """Print a formatted overview of all features and their status.
 
-    Status is read exclusively from feature-list.json (the single source of
+    Status is read exclusively from .prizmkit/plans/feature-list.json (the single source of
     truth).  state_dir is only used for ETA estimation when session history
     is available.
     """
     features = feature_list_data.get("features", [])
-    app_name = feature_list_data.get("app_name", "Unknown")
+    app_name = feature_list_data.get("project_name", feature_list_data.get("app_name", "Unknown"))
 
     # Apply feature filter
     if feature_filter is not None:
@@ -887,7 +887,7 @@ def action_status(feature_list_data, state_dir, feature_filter=None):
     }
     feature_lines = []
 
-    # Build status map from feature-list.json only
+    # Build status map from .prizmkit/plans/feature-list.json only
     status_map = {}
     for feature in features:
         if not isinstance(feature, dict):
@@ -1018,7 +1018,7 @@ def action_status(feature_list_data, state_dir, feature_filter=None):
     print("╔" + "═" * BOX_WIDTH + "╗")
     print("║" + pad_right(COLOR_BOLD + "  Dev-Pipeline Status" + COLOR_RESET, inner) + " ║")
     print("╠" + "═" * BOX_WIDTH + "╣")
-    print("║" + pad_right("  App: {}".format(app_name), inner) + " ║")
+    print("║" + pad_right("  Project: {}".format(app_name), inner) + " ║")
     print("║" + pad_right("  {}".format(summary_line), inner) + " ║")
     print("║" + pad_right("  {}".format(summary_line2), inner) + " ║")
     print("║" + pad_right("  {}".format(summary_line3), inner) + " ║")
@@ -1038,7 +1038,7 @@ def action_status(feature_list_data, state_dir, feature_filter=None):
 def action_start(args, feature_list_path, state_dir):
     """Mark a feature as in_progress at session start.
 
-    This keeps feature-list.json/state status in sync during execution,
+    This keeps .prizmkit/plans/feature-list.json/state status in sync during execution,
     instead of only updating after session end.
     """
     feature_id = args.feature_id
@@ -1059,7 +1059,7 @@ def action_start(args, feature_list_path, state_dir):
 
     err = update_feature_in_list(feature_list_path, feature_id, "in_progress")
     if err:
-        error_out("Failed to update feature-list.json: {}".format(err))
+        error_out("Failed to update .prizmkit/plans/feature-list.json: {}".format(err))
         return
 
     result = {
@@ -1080,7 +1080,7 @@ def action_reset(args, feature_list_path, state_dir):
     """Reset a feature to pending state.
 
     Resets status.json (status -> pending, retry_count -> 0, clear sessions,
-    clear resume_from_phase) and updates feature-list.json status to pending.
+    clear resume_from_phase) and updates .prizmkit/plans/feature-list.json status to pending.
     Does NOT delete any files on disk.
     """
     feature_id = args.feature_id
@@ -1107,10 +1107,10 @@ def action_reset(args, feature_list_path, state_dir):
         error_out("Failed to save feature status: {}".format(err))
         return
 
-    # Update feature-list.json
+    # Update .prizmkit/plans/feature-list.json
     err = update_feature_in_list(feature_list_path, feature_id, "pending")
     if err:
-        error_out("Failed to update feature-list.json: {}".format(err))
+        error_out("Failed to update .prizmkit/plans/feature-list.json: {}".format(err))
         return
 
     result = {
@@ -1202,7 +1202,7 @@ def action_clean(args, feature_list_path, state_dir):
 
     err = update_feature_in_list(feature_list_path, feature_id, "pending")
     if err:
-        error_out("Failed to update feature-list.json: {}".format(err))
+        error_out("Failed to update .prizmkit/plans/feature-list.json: {}".format(err))
         return
 
     result = {
@@ -1248,7 +1248,7 @@ def action_unskip(args, feature_list_path, state_dir):
                 target = f
                 break
         if not target:
-            error_out("Feature '{}' not found in feature-list.json".format(feature_id))
+            error_out("Feature '{}' not found in .prizmkit/plans/feature-list.json".format(feature_id))
             return
         if target.get("status") not in ("failed", "skipped", "auto_skipped"):
             error_out(
@@ -1328,7 +1328,7 @@ def action_unskip(args, feature_list_path, state_dir):
         error_out("No features to unskip")
         return
 
-    # Reset all collected features in feature-list.json
+    # Reset all collected features in .prizmkit/plans/feature-list.json
     reset_details = []
     for f in features:
         if isinstance(f, dict) and f.get("id") in to_reset:
@@ -1342,7 +1342,7 @@ def action_unskip(args, feature_list_path, state_dir):
 
     err = write_json_file(feature_list_path, data)
     if err:
-        error_out("Failed to write feature-list.json: {}".format(err))
+        error_out("Failed to write .prizmkit/plans/feature-list.json: {}".format(err))
         return
 
     # Reset status.json for each feature

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

@@ -68,8 +68,8 @@ def parse_args():
     parser = argparse.ArgumentParser(
         description="Core state machine for refactor pipeline status management."
     )
-    parser.add_argument("--refactor-list", required=True, help="Path to the refactor-list.json file")
-    parser.add_argument("--state-dir", required=True, help="Path to the refactor-state/ directory")
+    parser.add_argument("--refactor-list", required=True, help="Path to the .prizmkit/plans/refactor-list.json file")
+    parser.add_argument("--state-dir", required=True, help="Path to the state directory (default: .prizmkit/state/refactor)")
     parser.add_argument(
         "--action", required=True,
         choices=["get_next", "update", "status", "pause", "reset", "clean"],
@@ -133,7 +133,7 @@ def update_refactor_in_list(refactor_list_path, refactor_id, new_status):
             found = True
             break
     if not found:
-        return "Refactor '{}' not found in refactor-list.json".format(refactor_id)
+        return "Refactor '{}' not found in .prizmkit/plans/refactor-list.json".format(refactor_id)
     return write_json_file(refactor_list_path, data)
 
 
@@ -270,7 +270,7 @@ def action_update(args, refactor_list_path, state_dir):
         rs["resume_from_phase"] = None
         err = update_refactor_in_list(refactor_list_path, refactor_id, "completed")
         if err:
-            error_out("Failed to update refactor-list.json: {}".format(err))
+            error_out("Failed to update .prizmkit/plans/refactor-list.json: {}".format(err))
             return
     elif session_status == "merge_conflict":
         rs["retry_count"] = rs.get("retry_count", 0) + 1
@@ -288,7 +288,7 @@ def action_update(args, refactor_list_path, state_dir):
 
         err = update_refactor_in_list(refactor_list_path, refactor_id, target_status)
         if err:
-            error_out("Failed to update refactor-list.json: {}".format(err))
+            error_out("Failed to update .prizmkit/plans/refactor-list.json: {}".format(err))
             return
     else:
         rs["retry_count"] = rs.get("retry_count", 0) + 1
@@ -312,7 +312,7 @@ def action_update(args, refactor_list_path, state_dir):
 
         err = update_refactor_in_list(refactor_list_path, refactor_id, target_status)
         if err:
-            error_out("Failed to update refactor-list.json: {}".format(err))
+            error_out("Failed to update .prizmkit/plans/refactor-list.json: {}".format(err))
             return
 
     if session_status == "success" and session_id:
@@ -572,7 +572,7 @@ def action_reset(args, refactor_list_path, state_dir):
 
     err = update_refactor_in_list(refactor_list_path, refactor_id, "pending")
     if err:
-        error_out("Failed to update refactor-list.json: {}".format(err))
+        error_out("Failed to update .prizmkit/plans/refactor-list.json: {}".format(err))
         return
 
     result = {
@@ -644,7 +644,7 @@ def action_clean(args, refactor_list_path, state_dir):
 
     err = update_refactor_in_list(refactor_list_path, refactor_id, "pending")
     if err:
-        error_out("Failed to update refactor-list.json: {}".format(err))
+        error_out("Failed to update .prizmkit/plans/refactor-list.json: {}".format(err))
         return
 
     result = {