prizmkit 1.1.7 → 1.1.9

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.
@@ -18,8 +18,8 @@ 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"}
+FEATURE_ID_PATTERN = re.compile(r"^F-\d{3}(-[A-Z])?$")
+TERMINAL_STATUSES = {"completed", "failed", "skipped", "split", "auto_skipped"}
 VALID_PRIORITIES = {"critical", "high", "medium", "low"}
 
 REQUIRED_FEATURE_FIELDS = [
@@ -35,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()
 
@@ -245,7 +245,7 @@ def create_state_directory(state_dir, feature_list_path, features):
     features_dir = os.path.join(abs_state_dir, "features")
 
     now = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
-    run_id = "run-" + datetime.now(timezone.utc).strftime("%Y%m%d%H%M")
+    run_id = "run-" + datetime.now(timezone.utc).strftime("%Y%m%d%H%M%S")
 
     # Create top-level state directory
     os.makedirs(abs_state_dir, exist_ok=True)
@@ -283,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"
 
@@ -316,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
@@ -40,24 +40,25 @@ VALID_TYPES = ["extract", "rename", "restructure", "simplify", "decouple", "migr
 VALID_PRIORITIES = ["critical", "high", "medium", "low"]
 VALID_COMPLEXITIES = ["low", "medium", "high"]
 VALID_STATUSES = [
-    "pending", "in_progress", "completed", "failed", "skipped",
+    "pending", "in_progress", "completed", "failed", "skipped", "auto_skipped",
 ]
+TERMINAL_STATUSES = {"completed", "failed", "skipped", "auto_skipped"}
 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()
 
@@ -285,12 +286,18 @@ def create_state_directory(state_dir, refactor_list_path, refactors):
     refactors_dir = os.path.join(abs_state_dir, "refactors")
 
     now = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
-    run_id = "refactor-run-" + datetime.now(timezone.utc).strftime("%Y%m%d%H%M")
+    run_id = "refactor-run-" + datetime.now(timezone.utc).strftime("%Y%m%d%H%M%S")
 
     # Create top-level state directory
     os.makedirs(abs_state_dir, exist_ok=True)
     os.makedirs(refactors_dir, exist_ok=True)
 
+    # Count refactors already in terminal status at init time
+    completed_count = sum(
+        1 for r in refactors
+        if isinstance(r, dict) and r.get("status") in TERMINAL_STATUSES
+    )
+
     # Write pipeline.json
     pipeline_state = {
         "run_id": run_id,
@@ -299,7 +306,7 @@ def create_state_directory(state_dir, refactor_list_path, refactors):
         "refactor_list_path": rel_refactor_list_path,
         "created_at": now,
         "total_refactors": len(refactors),
-        "completed_refactors": 0,
+        "completed_refactors": completed_count,
     }
     pipeline_path = os.path.join(abs_state_dir, "pipeline.json")
     with open(pipeline_path, "w", encoding="utf-8") as f:
@@ -318,9 +325,13 @@ def create_state_directory(state_dir, refactor_list_path, refactors):
         sessions_dir = os.path.join(refactor_dir, "sessions")
         os.makedirs(sessions_dir, exist_ok=True)
 
+        # Respect existing terminal status from refactor-list.json
+        rl_status = refactor.get("status", "pending")
+        init_status = rl_status if rl_status in TERMINAL_STATUSES else "pending"
+
         refactor_status = {
             "refactor_id": rid,
-            "status": "pending",
+            "status": init_status,
             "retry_count": 0,
             "max_retries": 3,
             "sessions": [],

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

@@ -28,7 +28,7 @@ from datetime import datetime, timezone
 # Ordered pipeline phases — index defines forward-only progression.
 # Phase detection is monotonic: once a phase is reached, earlier phases
 # cannot be re-entered (prevents false positives from file content mentions).
-PHASE_ORDER = ["plan", "analyze", "implement", "code-review", "retrospective", "commit"]
+PHASE_ORDER = ["plan", "implement", "code-review", "retrospective", "commit"]
 
 # Keywords for phase detection.
 # "strong" keywords are skill invocations — high confidence, but still
@@ -40,10 +40,6 @@ PHASE_KEYWORDS = {
         "strong": ["prizmkit-plan"],
         "weak": ["spec.md", "plan.md", "specification", "architecture", "task checklist", "task breakdown", "gathering requirements"],
     },
-    "analyze": {
-        "strong": ["prizmkit-analyze"],
-        "weak": ["cross-check", "consistency analysis", "analyzing"],
-    },
     "implement": {
         "strong": ["prizmkit-implement"],
         "weak": ["implement", "writing code", "TDD", "coding"],

package/bundled/dev-pipeline/scripts/patch-completion-notes.py

@@ -0,0 +1,191 @@
+#!/usr/bin/env python3
+"""Patch completion_notes into feature-list.json, refactor-list.json, or bug-fix-list.json.
+
+Reads a completion-summary.json file written by the AI session and patches
+the corresponding item in the task list with the completion_notes field.
+
+This enables rich dependency context propagation: when a downstream task's
+bootstrap prompt is generated, it can read completion_notes from its
+completed dependencies to understand what was built/changed.
+
+Usage:
+    python3 patch-completion-notes.py \
+        --feature-list .prizmkit/plans/feature-list.json \
+        --feature-id F-001 \
+        --summary .prizmkit/specs/001-my-feature/completion-summary.json
+
+    python3 patch-completion-notes.py \
+        --refactor-list .prizmkit/plans/refactor-list.json \
+        --refactor-id R-001 \
+        --summary <path-to-summary>
+"""
+
+import argparse
+import json
+import os
+import sys
+
+from utils import load_json_file, write_json_file, setup_logging
+
+LOGGER = setup_logging("patch-completion-notes")
+
+
+def parse_args():
+    parser = argparse.ArgumentParser(
+        description="Patch completion_notes into a task list from completion-summary.json."
+    )
+    parser.add_argument(
+        "--feature-list",
+        default=None,
+        help="Path to .prizmkit/plans/feature-list.json",
+    )
+    parser.add_argument(
+        "--refactor-list",
+        default=None,
+        help="Path to .prizmkit/plans/refactor-list.json",
+    )
+    parser.add_argument(
+        "--bug-list",
+        default=None,
+        help="Path to .prizmkit/plans/bug-fix-list.json",
+    )
+    parser.add_argument(
+        "--feature-id",
+        default=None,
+        help="Feature ID to patch (e.g. F-001)",
+    )
+    parser.add_argument(
+        "--refactor-id",
+        default=None,
+        help="Refactor ID to patch (e.g. R-001)",
+    )
+    parser.add_argument(
+        "--bug-id",
+        default=None,
+        help="Bug ID to patch (e.g. B-001)",
+    )
+    parser.add_argument(
+        "--summary",
+        required=True,
+        help="Path to completion-summary.json file",
+    )
+    return parser.parse_args()
+
+
+def read_completion_notes(summary_path):
+    """Read completion_notes from a completion-summary.json file.
+
+    Returns a list of strings, or an empty list if the file is missing
+    or malformed.
+    """
+    if not os.path.isfile(summary_path):
+        LOGGER.warning("Summary file not found: %s", summary_path)
+        return []
+
+    data, err = load_json_file(summary_path)
+    if err:
+        LOGGER.warning("Failed to read summary: %s", err)
+        return []
+
+    notes = data.get("completion_notes", [])
+    if not isinstance(notes, list):
+        LOGGER.warning("completion_notes is not a list in %s", summary_path)
+        return []
+
+    # Filter: only keep non-empty strings
+    return [n for n in notes if isinstance(n, str) and n.strip()]
+
+
+def patch_list(list_path, item_id, item_key, notes):
+    """Patch completion_notes into a task list JSON file.
+
+    Args:
+        list_path: Path to the JSON list file
+        item_id: ID of the item to patch (e.g. "F-001" or "R-001")
+        item_key: Key for the items array (e.g. "features" or "refactors")
+        notes: List of completion note strings
+    """
+    data, err = load_json_file(list_path)
+    if err:
+        LOGGER.error("Failed to read list: %s", err)
+        return False
+
+    items = data.get(item_key, [])
+    found = False
+    for item in items:
+        if isinstance(item, dict) and item.get("id") == item_id:
+            item["completion_notes"] = notes
+            found = True
+            break
+
+    if not found:
+        LOGGER.error("Item %s not found in %s", item_id, list_path)
+        return False
+
+    err = write_json_file(list_path, data)
+    if err:
+        LOGGER.error("Failed to write list: %s", err)
+        return False
+
+    LOGGER.info(
+        "Patched %d completion notes for %s in %s",
+        len(notes), item_id, list_path,
+    )
+    return True
+
+
+def main():
+    args = parse_args()
+
+    # Determine mode: feature, refactor, or bug
+    if args.feature_list and args.feature_id:
+        list_path = args.feature_list
+        item_id = args.feature_id
+        item_key = "features"
+    elif args.refactor_list and args.refactor_id:
+        list_path = args.refactor_list
+        item_id = args.refactor_id
+        item_key = "refactors"
+    elif args.bug_list and args.bug_id:
+        list_path = args.bug_list
+        item_id = args.bug_id
+        item_key = "bugs"
+    else:
+        print(
+            "Error: must provide either (--feature-list + --feature-id) "
+            "or (--refactor-list + --refactor-id) "
+            "or (--bug-list + --bug-id)",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+    # Read completion notes
+    notes = read_completion_notes(args.summary)
+    if not notes:
+        LOGGER.info("No completion notes to patch for %s", item_id)
+        sys.exit(0)
+
+    # Patch the list
+    if not patch_list(list_path, item_id, item_key, notes):
+        sys.exit(1)
+
+    # Output result
+    result = {
+        "item_id": item_id,
+        "notes_count": len(notes),
+        "list_path": os.path.abspath(list_path),
+    }
+    print(json.dumps(result, indent=2, ensure_ascii=False))
+
+
+if __name__ == "__main__":
+    try:
+        main()
+    except KeyboardInterrupt:
+        sys.exit(130)
+    except SystemExit:
+        raise
+    except Exception as exc:
+        LOGGER.exception("Unhandled exception")
+        print("Error: {}".format(exc), file=sys.stderr)
+        sys.exit(1)