prizmkit 1.0.12 → 1.0.14

package/bundled/dev-pipeline/scripts/cleanup-logs.py

@@ -0,0 +1,192 @@
+#!/usr/bin/env python3
+"""Clean up pipeline session logs by age and total size.
+
+Targets files under any `.../sessions/.../logs/` directory inside a state dir.
+
+Policies:
+1) Remove files older than retention window.
+2) If total remaining size still exceeds max threshold, remove oldest files first
+   until within threshold.
+
+Usage:
+  python3 cleanup-logs.py --state-dir dev-pipeline/state
+  python3 cleanup-logs.py --state-dir dev-pipeline/bugfix-state --retention-days 30 --max-total-mb 2048
+"""
+
+import argparse
+import json
+import os
+import time
+
+from utils import error_out, setup_logging
+
+LOGGER = setup_logging("cleanup-logs")
+
+
+def parse_args():
+    parser = argparse.ArgumentParser(description="Cleanup pipeline logs by age and total size.")
+    parser.add_argument("--state-dir", required=True, help="State directory to scan")
+    parser.add_argument(
+        "--retention-days",
+        type=int,
+        default=14,
+        help="Delete logs older than this many days (default: 14)",
+    )
+    parser.add_argument(
+        "--max-total-mb",
+        type=int,
+        default=1024,
+        help="Target max total log size in MB after cleanup (default: 1024)",
+    )
+    parser.add_argument("--dry-run", action="store_true", help="Report actions without deleting")
+    return parser.parse_args()
+
+
+def iter_log_files(state_dir):
+    """Yield absolute paths of files inside .../sessions/.../logs/ directories."""
+    for root, _dirs, files in os.walk(state_dir):
+        if os.path.basename(root) != "logs":
+            continue
+
+        normalized = root.replace("\\", "/")
+        if "/sessions/" not in normalized:
+            continue
+
+        for name in files:
+            if name == ".DS_Store":
+                continue
+            yield os.path.join(root, name)
+
+
+def file_info(path):
+    """Return file metadata dict with path, size, and mtime."""
+    st = os.stat(path)
+    return {"path": path, "size": st.st_size, "mtime": st.st_mtime}
+
+
+def remove_file(path, dry_run=False):
+    if dry_run:
+        return True
+    try:
+        os.remove(path)
+        return True
+    except OSError:
+        return False
+
+
+def cleanup_empty_dirs(state_dir, dry_run=False):
+    """Remove empty logs directories bottom-up."""
+    removed = 0
+    for root, dirs, _files in os.walk(state_dir, topdown=False):
+        for d in dirs:
+            full = os.path.join(root, d)
+            if os.path.basename(full) != "logs":
+                continue
+            try:
+                if not os.listdir(full):
+                    if not dry_run:
+                        os.rmdir(full)
+                    removed += 1
+            except OSError:
+                continue
+    return removed
+
+
+def main():
+    args = parse_args()
+    state_dir = os.path.abspath(args.state_dir)
+
+    if not os.path.isdir(state_dir):
+        error_out("State directory not found: {}".format(state_dir), code=2)
+
+    if args.retention_days < 0:
+        error_out("retention-days must be >= 0", code=2)
+    if args.max_total_mb < 0:
+        error_out("max-total-mb must be >= 0", code=2)
+
+    now = time.time()
+    retention_cutoff = now - (args.retention_days * 86400)
+    max_total_bytes = args.max_total_mb * 1024 * 1024
+
+    files = []
+    for path in iter_log_files(state_dir):
+        try:
+            files.append(file_info(path))
+        except OSError:
+            continue
+
+    initial_total = sum(f["size"] for f in files)
+
+    deleted_files = []
+    kept_files = []
+
+    # Step 1: age-based cleanup
+    for f in files:
+        if f["mtime"] < retention_cutoff:
+            if remove_file(f["path"], dry_run=args.dry_run):
+                deleted_files.append({**f, "reason": "retention"})
+            else:
+                kept_files.append(f)
+        else:
+            kept_files.append(f)
+
+    # Step 2: size-based cleanup (oldest first)
+    current_total = sum(f["size"] for f in kept_files)
+    if current_total > max_total_bytes:
+        kept_files.sort(key=lambda x: x["mtime"])  # oldest first
+        still_kept = []
+        for f in kept_files:
+            if current_total <= max_total_bytes:
+                still_kept.append(f)
+                continue
+
+            if remove_file(f["path"], dry_run=args.dry_run):
+                deleted_files.append({**f, "reason": "size"})
+                current_total -= f["size"]
+            else:
+                still_kept.append(f)
+
+        kept_files = still_kept
+
+    removed_empty_log_dirs = cleanup_empty_dirs(state_dir, dry_run=args.dry_run)
+
+    final_total = sum(f["size"] for f in kept_files)
+    reclaimed = initial_total - final_total
+
+    report = {
+        "success": True,
+        "state_dir": state_dir,
+        "dry_run": args.dry_run,
+        "retention_days": args.retention_days,
+        "max_total_mb": args.max_total_mb,
+        "initial_files": len(files),
+        "deleted_files": len(deleted_files),
+        "deleted_by_reason": {
+            "retention": sum(1 for f in deleted_files if f["reason"] == "retention"),
+            "size": sum(1 for f in deleted_files if f["reason"] == "size"),
+        },
+        "removed_empty_log_dirs": removed_empty_log_dirs,
+        "initial_total_bytes": initial_total,
+        "final_total_bytes": final_total,
+        "reclaimed_bytes": reclaimed,
+    }
+
+    LOGGER.info(
+        "cleanup complete: deleted=%s reclaimed=%sKB",
+        report["deleted_files"],
+        int(report["reclaimed_bytes"] / 1024),
+    )
+
+    print(json.dumps(report, indent=2, ensure_ascii=False))
+
+
+if __name__ == "__main__":
+    try:
+        main()
+    except KeyboardInterrupt:
+        error_out("cleanup-logs interrupted", code=130)
+    except SystemExit:
+        raise
+    except Exception as exc:
+        LOGGER.exception("Unhandled exception in cleanup-logs")
+        error_out("cleanup-logs failed: {}".format(str(exc)), code=1)

package/bundled/dev-pipeline/scripts/detect-stuck.py

@@ -21,6 +21,11 @@ import os
 import sys
 from datetime import datetime, timezone
 
+from utils import error_out, setup_logging
+
+
+LOGGER = setup_logging("detect-stuck")
+
 
 def parse_args():
     parser = argparse.ArgumentParser(
@@ -340,8 +345,7 @@ def main():
     state_dir = os.path.abspath(args.state_dir)
 
     if not os.path.isdir(state_dir):
-        sys.stderr.write("Error: state directory not found: {}\n".format(state_dir))
-        sys.exit(2)
+        error_out("State directory not found: {}".format(state_dir), code=2)
 
     # Determine which features to check
     if args.feature_id:
@@ -382,4 +386,12 @@ def main():
 
 
 if __name__ == "__main__":
-    main()
+    try:
+        main()
+    except KeyboardInterrupt:
+        error_out("detect-stuck interrupted", code=130)
+    except SystemExit:
+        raise
+    except Exception as exc:
+        LOGGER.exception("Unhandled exception in detect-stuck")
+        error_out("detect-stuck failed: {}".format(str(exc)), code=1)

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

@@ -19,11 +19,13 @@ import os
 import re
 import sys
 
-from utils import load_json_file
+from utils import load_json_file, setup_logging
 
 
 DEFAULT_MAX_RETRIES = 3
 
+LOGGER = setup_logging("generate-bootstrap-prompt")
+
 
 def parse_args():
     parser = argparse.ArgumentParser(
@@ -359,10 +361,17 @@ def build_replacements(args, feature, features, global_context, script_dir):
 
     # Auto-detect platform if not set
     if not platform:
-        if os.path.isdir(os.path.join(project_root, ".claude", "agents")):
+        has_claude = os.path.isdir(os.path.join(project_root, ".claude", "agents"))
+        has_codebuddy = os.path.isdir(os.path.join(project_root, ".codebuddy", "agents"))
+        if has_claude:
             platform = "claude"
-        else:
+        elif has_codebuddy:
             platform = "codebuddy"
+        else:
+            raise RuntimeError(
+                "PrizmKit agents not found. Neither .claude/agents/ nor .codebuddy/agents/ exists. "
+                "Run `npx prizmkit install` first, or set PRIZMKIT_PLATFORM=claude|codebuddy explicitly."
+            )
 
     if platform == "claude":
         # Claude Code: agents in .claude/agents/, no native team config
@@ -498,6 +507,12 @@ def write_output(output_path, content):
     return None
 
 
+def emit_failure(message):
+    """Emit standardized failure JSON and exit."""
+    print(json.dumps({"success": False, "error": message}, indent=2, ensure_ascii=False))
+    sys.exit(1)
+
+
 def main():
     args = parse_args()
 
@@ -538,38 +553,22 @@ def main():
     # Load template
     template_content, err = read_text_file(template_path)
     if err:
-        output = {"success": False, "error": "Template error: {}".format(err)}
-        print(json.dumps(output, indent=2, ensure_ascii=False))
-        sys.exit(1)
+        emit_failure("Template error: {}".format(err))
 
     # Load feature list
     feature_list_data, err = load_json_file(args.feature_list)
     if err:
-        output = {"success": False, "error": "Feature list error: {}".format(err)}
-        print(json.dumps(output, indent=2, ensure_ascii=False))
-        sys.exit(1)
+        emit_failure("Feature list error: {}".format(err))
 
     # Extract features array
     features = feature_list_data.get("features")
     if not isinstance(features, list):
-        output = {
-            "success": False,
-            "error": "Feature list does not contain a 'features' array",
-        }
-        print(json.dumps(output, indent=2, ensure_ascii=False))
-        sys.exit(1)
+        emit_failure("Feature list does not contain a 'features' array")
 
     # Find the target feature
     feature = find_feature(features, args.feature_id)
     if feature is None:
-        output = {
-            "success": False,
-            "error": "Feature '{}' not found in feature list".format(
-                args.feature_id
-            ),
-        }
-        print(json.dumps(output, indent=2, ensure_ascii=False))
-        sys.exit(1)
+        emit_failure("Feature '{}' not found in feature list".format(args.feature_id))
 
     # Extract global context
     global_context = feature_list_data.get("global_context", {})
@@ -592,9 +591,7 @@ def main():
     # Write the output
     err = write_output(args.output, rendered)
     if err:
-        output = {"success": False, "error": err}
-        print(json.dumps(output, indent=2, ensure_ascii=False))
-        sys.exit(1)
+        emit_failure(err)
 
     # Success
     output = {
@@ -606,4 +603,12 @@ def main():
 
 
 if __name__ == "__main__":
-    main()
+    try:
+        main()
+    except KeyboardInterrupt:
+        emit_failure("generate-bootstrap-prompt interrupted")
+    except SystemExit:
+        raise
+    except Exception as exc:
+        LOGGER.exception("Unhandled exception in generate-bootstrap-prompt")
+        emit_failure("Unexpected error: {}".format(str(exc)))

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

@@ -19,11 +19,13 @@ import os
 import re
 import sys
 
-from utils import load_json_file
+from utils import load_json_file, setup_logging
 
 
 DEFAULT_MAX_RETRIES = 3
 
+LOGGER = setup_logging("generate-bugfix-prompt")
+
 
 def parse_args():
     parser = argparse.ArgumentParser(
@@ -309,6 +311,12 @@ def write_output(output_path, content):
     return None
 
 
+def emit_failure(message):
+    """Emit standardized failure JSON and exit."""
+    print(json.dumps({"success": False, "error": message}, indent=2, ensure_ascii=False))
+    sys.exit(1)
+
+
 def main():
     args = parse_args()
 
@@ -326,36 +334,22 @@ def main():
     # Load template
     template_content, err = read_text_file(template_path)
     if err:
-        output = {"success": False, "error": "Template error: {}".format(err)}
-        print(json.dumps(output, indent=2, ensure_ascii=False))
-        sys.exit(1)
+        emit_failure("Template error: {}".format(err))
 
     # Load bug fix list
     bug_list_data, err = load_json_file(args.bug_list)
     if err:
-        output = {"success": False, "error": "Bug list error: {}".format(err)}
-        print(json.dumps(output, indent=2, ensure_ascii=False))
-        sys.exit(1)
+        emit_failure("Bug list error: {}".format(err))
 
     # Extract bugs array
     bugs = bug_list_data.get("bugs")
     if not isinstance(bugs, list):
-        output = {
-            "success": False,
-            "error": "Bug fix list does not contain a 'bugs' array",
-        }
-        print(json.dumps(output, indent=2, ensure_ascii=False))
-        sys.exit(1)
+        emit_failure("Bug fix list does not contain a 'bugs' array")
 
     # Find the target bug
     bug = find_bug(bugs, args.bug_id)
     if bug is None:
-        output = {
-            "success": False,
-            "error": "Bug '{}' not found in bug fix list".format(args.bug_id),
-        }
-        print(json.dumps(output, indent=2, ensure_ascii=False))
-        sys.exit(1)
+        emit_failure("Bug '{}' not found in bug fix list".format(args.bug_id))
 
     # Extract global context
     global_context = bug_list_data.get("global_context", {})
@@ -371,9 +365,7 @@ def main():
     # Write the output
     err = write_output(args.output, rendered)
     if err:
-        output = {"success": False, "error": err}
-        print(json.dumps(output, indent=2, ensure_ascii=False))
-        sys.exit(1)
+        emit_failure(err)
 
     # Success
     output = {
@@ -385,4 +377,12 @@ def main():
 
 
 if __name__ == "__main__":
-    main()
+    try:
+        main()
+    except KeyboardInterrupt:
+        emit_failure("generate-bugfix-prompt interrupted")
+    except SystemExit:
+        raise
+    except Exception as exc:
+        LOGGER.exception("Unhandled exception in generate-bugfix-prompt")
+        emit_failure("Unexpected error: {}".format(str(exc)))

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

@@ -42,6 +42,8 @@ SESSION_STATUS_VALUES = [
     "failed",
     "crashed",
     "timed_out",
+    "commit_missing",
+    "docs_missing",
 ]
 
 TERMINAL_STATUSES = {"completed", "failed", "skipped"}
@@ -401,12 +403,54 @@ def action_update(args, feature_list_path, state_dir):
     fs = load_feature_status(state_dir, feature_id)
 
     if session_status == "success":
+        # No-op guard: if this exact successful session was already recorded,
+        # avoid rewriting state files again (prevents post-commit dirty changes).
+        existing_sessions = fs.get("sessions", [])
+        already_completed = fs.get("status") == "completed" and fs.get("resume_from_phase") is None
+        same_session_already_recorded = (
+            session_id
+            and session_id in existing_sessions
+            and fs.get("last_session_id") == session_id
+        )
+        if already_completed and (same_session_already_recorded or not session_id):
+            summary = {
+                "action": "update",
+                "feature_id": feature_id,
+                "session_status": session_status,
+                "new_status": fs.get("status", "completed"),
+                "retry_count": fs.get("retry_count", 0),
+                "resume_from_phase": fs.get("resume_from_phase"),
+                "updated_at": fs.get("updated_at"),
+                "no_op": True,
+            }
+            print(json.dumps(summary, indent=2, ensure_ascii=False))
+            return
+
         fs["status"] = "completed"
         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))
             return
+    elif session_status in ("commit_missing", "docs_missing"):
+        # Degraded outcome: keep artifacts for retry and expose specific status.
+        fs["retry_count"] = fs.get("retry_count", 0) + 1
+
+        if fs["retry_count"] >= max_retries:
+            fs["status"] = "failed"
+            target_status = "failed"
+        else:
+            fs["status"] = session_status
+            target_status = session_status
+
+        fs["resume_from_phase"] = None
+        fs["sessions"] = []
+        fs["last_session_id"] = None
+
+        err = update_feature_in_list(feature_list_path, feature_id, target_status)
+        if err:
+            error_out("Failed to update feature-list.json: {}".format(err))
+            return
     else:
         fs["retry_count"] = fs.get("retry_count", 0) + 1
 
@@ -456,7 +500,10 @@ def action_update(args, feature_list_path, state_dir):
         "resume_from_phase": fs.get("resume_from_phase"),
         "updated_at": fs["updated_at"],
     }
-    if session_status != "success":
+    if session_status in ("commit_missing", "docs_missing"):
+        summary["degraded_reason"] = session_status
+        summary["restart_policy"] = "finalization_retry"
+    elif session_status != "success":
         summary["restart_policy"] = "full_restart"
         summary["cleanup_performed"] = cleaned
 
@@ -628,7 +675,15 @@ def action_status(feature_list_data, state_dir):
     app_name = feature_list_data.get("app_name", "Unknown")
 
     # Gather status info
-    counts = {"completed": 0, "in_progress": 0, "failed": 0, "pending": 0, "skipped": 0}
+    counts = {
+        "completed": 0,
+        "in_progress": 0,
+        "failed": 0,
+        "pending": 0,
+        "skipped": 0,
+        "commit_missing": 0,
+        "docs_missing": 0,
+    }
     feature_lines = []
 
     # Build dependency info: feature_id -> list of dep_ids that are not completed
@@ -671,6 +726,10 @@ def action_status(feature_list_data, state_dir):
             icon = COLOR_RED + "[✗]" + COLOR_RESET
         elif fstatus == "skipped":
             icon = COLOR_GRAY + "[—]" + COLOR_RESET
+        elif fstatus == "commit_missing":
+            icon = COLOR_RED + "[↑]" + COLOR_RESET
+        elif fstatus == "docs_missing":
+            icon = COLOR_RED + "[D]" + COLOR_RESET
         else:
             icon = COLOR_GRAY + "[ ]" + COLOR_RESET
 
@@ -686,6 +745,10 @@ def action_status(feature_list_data, state_dir):
                 detail = " ({})".format(", ".join(parts))
         elif fstatus == "failed":
             detail = " (failed after {} retries)".format(retry_count)
+        elif fstatus == "commit_missing":
+            detail = " (commit missing, retry {}/{})".format(retry_count, max_retries_val)
+        elif fstatus == "docs_missing":
+            detail = " (docs missing, retry {}/{})".format(retry_count, max_retries_val)
         elif fstatus == "pending":
             # Check if blocked by dependencies
             deps = feature.get("dependencies", [])
@@ -709,6 +772,10 @@ def action_status(feature_list_data, state_dir):
             line_content = "{} {} {}{}".format(
                 fid, icon, COLOR_RED + title + COLOR_RESET, detail
             )
+        elif fstatus in ("commit_missing", "docs_missing"):
+            line_content = "{} {} {}{}".format(
+                fid, icon, COLOR_RED + title + COLOR_RESET, detail
+            )
         else:
             line_content = "{} {} {}{}".format(
                 fid, icon, COLOR_GRAY + title + COLOR_RESET, detail
@@ -739,6 +806,9 @@ def action_status(feature_list_data, state_dir):
     summary_line2 = "Failed: {} | Pending: {} | Skipped: {}".format(
         counts["failed"], counts["pending"], counts["skipped"]
     )
+    summary_line3 = "Commit Missing: {} | Docs Missing: {}".format(
+        counts["commit_missing"], counts["docs_missing"]
+    )
 
     # 构建预估剩余时间行
     CONFIDENCE_ICONS = {"high": "●", "medium": "◐", "low": "○"}
@@ -759,6 +829,7 @@ def action_status(feature_list_data, state_dir):
     print("║" + pad_right("  App: {}".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) + " ║")
     print("╠" + "─" * BOX_WIDTH + "╣")
     print("║" + pad_right("  Progress: {}".format(progress_bar), inner) + " ║")
     print("║" + pad_right("  {}".format(eta_line), inner) + " ║")

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

@@ -6,6 +6,7 @@ to avoid duplication across pipeline scripts.
 """
 
 import json
+import logging
 import os
 import sys
 
@@ -49,6 +50,27 @@ def write_json_file(path, data):
     return None
 
 
+def setup_logging(name="prizmkit.dev_pipeline", level=None):
+    """Configure and return a standard logger for pipeline scripts.
+
+    Logs are written to stderr to avoid interfering with stdout JSON outputs.
+    """
+    resolved_level = (level or os.environ.get("PRIZMKIT_LOG_LEVEL", "INFO")).upper()
+    numeric_level = getattr(logging, resolved_level, logging.INFO)
+
+    root_logger = logging.getLogger()
+    if not root_logger.handlers:
+        logging.basicConfig(
+            level=numeric_level,
+            stream=sys.stderr,
+            format="%(asctime)s [%(levelname)s] %(name)s: %(message)s",
+        )
+
+    logger = logging.getLogger(name)
+    logger.setLevel(numeric_level)
+    return logger
+
+
 def error_out(message, code=1):
     """Print an error JSON and exit with the given code."""
     output = {"error": message}

package/bundled/dev-pipeline/templates/bootstrap-tier1.md

@@ -111,6 +111,21 @@ Key decisions: [list]
 
 **CP-2**: All acceptance criteria met, tests pass.
 
+### Phase 4.5: Prizm Doc Update (mandatory for feature sessions)
+
+Run `prizmkit.doc.update` and sync project docs before commit:
+1. Use `git diff --cached --name-status` (fallback: `git diff --name-status`) to locate changed modules
+2. Update affected `.prizm-docs/` files (L1/L2, changelog.prizm)
+3. Stage documentation updates (`git add .prizm-docs/`) if changed
+
+Doc maintenance pass condition (pipeline-enforced): `REGISTRY.md` **or** `.prizm-docs/` changed in the final commit.
+
+### Phase 4.7: Retrospective (feature sessions only, before commit)
+
+If this session is a feature (not a bug-fix-only commit), run `prizmkit.retrospective` now — **before committing**.
+Retrospective must update relevant `.prizm-docs/` sections (TRAPS/RULES/DECISIONS) when applicable, so those changes are included in the feature commit.
+Stage any `.prizm-docs/` changes produced: `git add .prizm-docs/`
+
 ### Phase 5: Commit
 
 - Run `prizmkit.summarize` → archive to REGISTRY.md
@@ -122,6 +137,7 @@ Key decisions: [list]
     --feature-id "{{FEATURE_ID}}" --session-id "{{SESSION_ID}}" --action complete
   ```
 - Run `prizmkit.committer` → `feat({{FEATURE_ID}}): {{FEATURE_TITLE}}`, do NOT push
+- MANDATORY: commit must be done via `prizmkit.committer` skill. Do NOT run manual `git add`/`git commit` as a substitute.
 
 ---
 
@@ -135,7 +151,7 @@ Write to: `{{SESSION_STATUS_PATH}}`
   "feature_id": "{{FEATURE_ID}}",
   "feature_slug": "{{FEATURE_SLUG}}",
   "exec_tier": 1,
-  "status": "<success|partial|failed>",
+  "status": "<success|partial|failed|commit_missing|docs_missing>",
   "completed_phases": [0, 1, 2, 3, 4, 5],
   "current_phase": 5,
   "checkpoint_reached": "CP-2",
@@ -144,6 +160,8 @@ Write to: `{{SESSION_STATUS_PATH}}`
   "errors": [],
   "can_resume": false,
   "resume_from_phase": null,
+  "docs_maintained": true,
+  "retrospective_done": true,
   "artifacts": {
     "context_snapshot_path": ".prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md",
     "plan_path": ".prizmkit/specs/{{FEATURE_SLUG}}/plan.md",
@@ -154,6 +172,23 @@ Write to: `{{SESSION_STATUS_PATH}}`
 }
 ```
 
+### Step 3.1: Final Clean Check (before exit)
+
+After writing `session-status.json`, verify repository is clean:
+
+```bash
+git status --short
+```
+
+If any files remain, include them in the last commit:
+
+```bash
+git add -A
+git commit --amend --no-edit
+```
+
+Re-check `git status --short` and ensure it is empty before exiting.
+
 ## Critical Paths
 
 | Resource | Path |
@@ -168,4 +203,5 @@ Write to: `{{SESSION_STATUS_PATH}}`
 - Tier 1: you do everything — no subagents, no TeamCreate
 - Build context-snapshot.md FIRST; use it throughout instead of re-reading files
 - ALWAYS write session-status.json before exiting
-- `prizmkit.committer` is mandatory — do NOT skip the commit phase
+- `prizmkit.committer` is mandatory — do NOT skip the commit phase, and do NOT replace it with manual git commit commands
+- Before exiting, `git status --short` must be empty