prizmkit 1.0.29 → 1.0.35

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.0.29",
-  "bundledAt": "2026-03-17T08:36:23.833Z",
-  "bundledFrom": "726da22"
+  "frameworkVersion": "1.0.35",
+  "bundledAt": "2026-03-17T13:12:38.845Z",
+  "bundledFrom": "2597a15"
 }

package/bundled/agents/prizm-dev-team-dev.md

@@ -100,3 +100,4 @@ DEV-14: 若 `npm test` 中存在 pre-existing 失败，不得忽略——必须
 - 发送 COMPLETION_SIGNAL 标志所有任务完成
 - 发送 ESCALATION 上报接口歧义或任务阻塞
 - 接收 TASK_ASSIGNMENT 获取分配的工作
+

package/bundled/agents/prizm-dev-team-reviewer.md

@@ -121,3 +121,4 @@ REV-10: 禁止使用 timeout 命令（macOS 不兼容）。运行测试时直接
 - 发送 COMPLETION_SIGNAL（含判定结果）标志完成
 - 发送 ISSUE_REPORT 报告 CRITICAL 发现
 - 接收 TASK_ASSIGNMENT 获取分配的工作
+

package/bundled/dev-pipeline/launch-bugfix-daemon.sh

@@ -148,6 +148,11 @@ cmd_start() {
     log_info "Bug fix list: $bug_list"
     log_info "Log file: $LOG_FILE"
 
+    # Unset CLAUDECODE to allow spawning nested Claude Code sessions.
+    # When this daemon is launched from within a Claude Code session, the env var
+    # is inherited and blocks child claude processes with "nested sessions" error.
+    unset CLAUDECODE 2>/dev/null || true
+
     {
         echo ""
         echo "================================================================"

package/bundled/dev-pipeline/launch-daemon.sh

@@ -8,11 +8,11 @@ set -euo pipefail
 # log consolidation, and lifecycle commands.
 #
 # Usage:
-#   ./launch-daemon.sh start [feature-list.json] [--env "KEY=VAL ..."]
+#   ./launch-daemon.sh start [feature-list.json] [--mode <mode>] [--env "KEY=VAL ..."]
 #   ./launch-daemon.sh stop
 #   ./launch-daemon.sh status
 #   ./launch-daemon.sh logs [--lines N] [--follow]
-#   ./launch-daemon.sh restart [feature-list.json] [--env "KEY=VAL ..."]
+#   ./launch-daemon.sh restart [feature-list.json] [--mode <mode>] [--env "KEY=VAL ..."]
 #
 # NOTE:
 #   In AI skill sessions, always use this daemon wrapper.
@@ -92,6 +92,7 @@ clean_stale_pid() {
 cmd_start() {
     local feature_list=""
     local env_overrides=""
+    local mode_override=""
 
     # Parse arguments
     while [[ $# -gt 0 ]]; do
@@ -105,6 +106,23 @@ cmd_start() {
                 env_overrides="$1"
                 shift
                 ;;
+            --mode)
+                shift
+                if [[ $# -eq 0 ]]; then
+                    log_error "--mode requires a value (lite|standard|full|self-evolve)"
+                    exit 1
+                fi
+                case "$1" in
+                    lite|standard|full|self-evolve)
+                        mode_override="$1"
+                        ;;
+                    *)
+                        log_error "Invalid mode: $1 (must be lite, standard, full, or self-evolve)"
+                        exit 1
+                        ;;
+                esac
+                shift
+                ;;
             *)
                 feature_list="$1"
                 shift
@@ -152,8 +170,15 @@ cmd_start() {
 
     # Build environment prefix
     local env_cmd=""
+    local env_parts=""
     if [[ -n "$env_overrides" ]]; then
-        env_cmd="env $env_overrides"
+        env_parts="$env_overrides"
+    fi
+    if [[ -n "$mode_override" ]]; then
+        env_parts="${env_parts:+$env_parts }PIPELINE_MODE=$mode_override"
+    fi
+    if [[ -n "$env_parts" ]]; then
+        env_cmd="env $env_parts"
     fi
 
     # Record start time
@@ -174,6 +199,9 @@ cmd_start() {
     log_info "Launching pipeline..."
     log_info "Feature list: $feature_list"
     log_info "Log file: $LOG_FILE"
+    if [[ -n "$mode_override" ]]; then
+        log_info "Mode: $mode_override"
+    fi
     if [[ -n "$env_overrides" ]]; then
         log_info "Environment overrides: $env_overrides"
     fi
@@ -184,6 +212,9 @@ cmd_start() {
         echo "================================================================"
         echo "  Pipeline Daemon Started: $start_time"
         echo "  Feature list: $feature_list"
+        if [[ -n "$mode_override" ]]; then
+            echo "  Mode: $mode_override"
+        fi
         if [[ -n "$env_overrides" ]]; then
             echo "  Environment: $env_overrides"
         fi
@@ -191,6 +222,11 @@ cmd_start() {
         echo ""
     } >> "$LOG_FILE"
 
+    # Unset CLAUDECODE to allow spawning nested Claude Code sessions.
+    # When this daemon is launched from within a Claude Code session, the env var
+    # is inherited and blocks child claude processes with "nested sessions" error.
+    unset CLAUDECODE 2>/dev/null || true
+
     # Launch with nohup + disown for full detachment
     if [[ -n "$env_cmd" ]]; then
         nohup $env_cmd "$RUN_SCRIPT" run "$feature_list" >> "$LOG_FILE" 2>&1 &
@@ -207,12 +243,13 @@ cmd_start() {
     # Write start metadata (atomic)
     python3 -c "
 import json, sys, os
-pid, started_at, feature_list, env_overrides, log_file, state_dir = int(sys.argv[1]), sys.argv[2], sys.argv[3], sys.argv[4], sys.argv[5], sys.argv[6]
+pid, started_at, feature_list, env_overrides, log_file, state_dir, mode = int(sys.argv[1]), sys.argv[2], sys.argv[3], sys.argv[4], sys.argv[5], sys.argv[6], sys.argv[7]
 data = {
     'pid': pid,
     'started_at': started_at,
     'feature_list': feature_list,
     'env_overrides': env_overrides,
+    'mode': mode,
     'log_file': log_file
 }
 target = os.path.join(state_dir, '.pipeline-meta.json')
@@ -220,7 +257,7 @@ tmp = target + '.tmp'
 with open(tmp, 'w') as f:
     json.dump(data, f, indent=2)
 os.replace(tmp, target)
-" "$pipeline_pid" "$start_time" "$feature_list" "$env_overrides" "$LOG_FILE" "$STATE_DIR" 2>/dev/null || true
+" "$pipeline_pid" "$start_time" "$feature_list" "$env_overrides" "$LOG_FILE" "$STATE_DIR" "$mode_override" 2>/dev/null || true
 
     # Wait briefly and verify
     sleep 2
@@ -269,8 +306,9 @@ cmd_stop() {
 
     log_info "Stopping pipeline (PID: $pid)..."
 
-    # Send SIGTERM for graceful shutdown (triggers run.sh cleanup trap)
-    kill -TERM "$pid" 2>/dev/null || true
+    # Kill the entire process group to include child processes (claude-internal, etc.)
+    # First try SIGTERM to the process group (negative PID)
+    kill -TERM -- -"$pid" 2>/dev/null || kill -TERM "$pid" 2>/dev/null || true
 
     # Wait up to 30 seconds for graceful exit
     local waited=0
@@ -282,10 +320,10 @@ cmd_stop() {
         waited=$((waited + 1))
     done
 
-    # Force kill if still alive
+    # Force kill if still alive (process group first, then individual)
     if kill -0 "$pid" 2>/dev/null; then
         log_warn "Process did not exit after 30s, sending SIGKILL..."
-        kill -9 "$pid" 2>/dev/null || true
+        kill -9 -- -"$pid" 2>/dev/null || kill -9 "$pid" 2>/dev/null || true
         sleep 1
     fi
 
@@ -510,17 +548,23 @@ show_help() {
 Usage: launch-daemon.sh <command> [options]
 
 Commands:
-  start [feature-list.json] [--env "K=V ..."]   Start pipeline in background
+  start [feature-list.json] [--mode <mode>] [--env "K=V ..."]   Start pipeline in background
   stop                                            Gracefully stop pipeline
   status                                          Check if pipeline is running
   logs [--lines N] [--follow]                     View pipeline logs
-  restart [feature-list.json] [--env "K=V ..."]  Stop + start pipeline
+  restart [feature-list.json] [--mode <mode>] [--env "K=V ..."]  Stop + start pipeline
   help                                            Show this help
 
+Options:
+  --mode <lite|standard|full|self-evolve>   Override pipeline mode for all features
+  --env "KEY=VAL ..."                        Set environment variables
+
 Examples:
   ./launch-daemon.sh start                        # Start with default feature-list.json
   ./launch-daemon.sh start my-features.json       # Start with custom feature list
+  ./launch-daemon.sh start --mode self-evolve     # Self-evolve mode (framework development)
   ./launch-daemon.sh start --env "MAX_RETRIES=5 SESSION_TIMEOUT=7200"
+  ./launch-daemon.sh start feature-list.json --mode self-evolve --env "VERBOSE=1"
   ./launch-daemon.sh status                       # Check if running (JSON on stdout)
   ./launch-daemon.sh logs --follow                # Live log tailing
   ./launch-daemon.sh logs --lines 100             # Last 100 lines

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

@@ -84,18 +84,23 @@ spawn_and_wait_session() {
         model_flag="--model $MODEL"
     fi
 
+    # Unset CLAUDECODE to prevent "nested session" error when launched from
+    # within an existing Claude Code session (e.g. via launch-bugfix-daemon.sh).
+    unset CLAUDECODE 2>/dev/null || true
+
     case "$CLI_CMD" in
         *claude*)
+            # Claude Code: prompt via -p, --dangerously-skip-permissions for auto-accept
             "$CLI_CMD" \
-                --print \
                 -p "$(cat "$bootstrap_prompt")" \
-                --yes \
+                --dangerously-skip-permissions \
                 $verbose_flag \
                 $stream_json_flag \
                 $model_flag \
                 > "$session_log" 2>&1 &
             ;;
         *)
+            # CodeBuddy (cbc) and others: prompt via stdin, -y for auto-accept
             "$CLI_CMD" \
                 --print \
                 -y \
@@ -198,6 +203,9 @@ cleanup() {
     echo ""
     log_warn "Received interrupt signal. Saving state..."
 
+    # Kill all child processes (claude-internal, heartbeat, progress parser, etc.)
+    kill 0 2>/dev/null || true
+
     if [[ -n "$BUG_LIST" && -f "$BUG_LIST" ]]; then
         python3 "$SCRIPTS_DIR/update-bug-status.py" \
             --bug-list "$BUG_LIST" \
@@ -537,7 +545,7 @@ bug_id, session_id, state_dir = sys.argv[1], sys.argv[2], sys.argv[3]
 data = {
     'bug_id': bug_id,
     'session_id': session_id,
-    'started_at': datetime.utcnow().strftime('%Y-%m-%dT%H:%M:%SZ')
+    'started_at': datetime.now(datetime.UTC).strftime('%Y-%m-%dT%H:%M:%SZ')
 }
 target = os.path.join(state_dir, 'current-session.json')
 tmp = target + '.tmp'

package/bundled/dev-pipeline/run.sh

@@ -27,6 +27,7 @@ set -euo pipefail
 #   LOG_CLEANUP_ENABLED   Run periodic log cleanup (default: 1)
 #   LOG_RETENTION_DAYS    Delete logs older than N days (default: 14)
 #   LOG_MAX_TOTAL_MB      Keep total logs under N MB via oldest-first cleanup (default: 1024)
+#   PIPELINE_MODE         Override mode for all features: lite|standard|full|self-evolve (used by daemon)
 # ============================================================
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
@@ -98,13 +99,16 @@ spawn_and_wait_session() {
         model_flag="--model $MODEL"
     fi
 
+    # Unset CLAUDECODE to prevent "nested session" error when launched from
+    # within an existing Claude Code session (e.g. via launch-daemon.sh).
+    unset CLAUDECODE 2>/dev/null || true
+
     case "$CLI_CMD" in
         *claude*)
-            # Claude Code: prompt via -p argument, --yes for auto-accept
+            # Claude Code: prompt via -p argument, --dangerously-skip-permissions for auto-accept
             "$CLI_CMD" \
-                --print \
                 -p "$(cat "$bootstrap_prompt")" \
-                --yes \
+                --dangerously-skip-permissions \
                 $verbose_flag \
                 $stream_json_flag \
                 $model_flag \
@@ -247,6 +251,9 @@ cleanup() {
     echo ""
     log_warn "Received interrupt signal. Saving state..."
 
+    # Kill all child processes (claude-internal, heartbeat, progress parser, etc.)
+    kill 0 2>/dev/null || true
+
     if [[ -n "$FEATURE_LIST" && -f "$FEATURE_LIST" ]]; then
         python3 "$SCRIPTS_DIR/update-feature-status.py" \
             --feature-list "$FEATURE_LIST" \
@@ -326,11 +333,11 @@ run_one() {
                     exit 1
                 fi
                 case "$1" in
-                    lite|standard|full)
+                    lite|standard|full|self-evolve)
                         mode_override="$1"
                         ;;
                     *)
-                        log_error "Invalid mode: $1 (must be lite, standard, or full)"
+                        log_error "Invalid mode: $1 (must be lite, standard, full, or self-evolve)"
                         exit 1
                         ;;
                 esac
@@ -403,6 +410,14 @@ run_one() {
     check_dependencies
     run_log_cleanup
 
+    # Auto-detect framework repo: if scripts/bundle.js exists, enable self-evolve mode
+    local project_root
+    project_root=$(git -C "$SCRIPT_DIR" rev-parse --show-toplevel 2>/dev/null || echo "")
+    if [[ -z "$mode_override" && -n "$project_root" && -f "$project_root/scripts/bundle.js" ]]; then
+        log_info "Detected PrizmKit framework repo — auto-enabling self-evolve mode"
+        mode_override="self-evolve"
+    fi
+
     # Verify feature exists
     local feature_title
     feature_title=$(python3 -c "
@@ -586,6 +601,37 @@ sys.exit(1)
 
     echo ""
     if [[ "$session_status" == "success" ]]; then
+        # Self-evolve mode: run framework validation after successful session
+        if [[ "$mode_override" == "self-evolve" ]]; then
+            log_info "Self-evolve mode: running framework validation..."
+            if bash "$SCRIPTS_DIR/validate-framework.sh" 2>&1; then
+                log_success "Framework validation passed"
+            else
+                log_warn "Framework validation failed — review issues above"
+                session_status="framework_validation_failed"
+            fi
+
+            # Check for reload_needed marker in session status
+            local session_status_file="$session_dir/session-status.json"
+            if [[ -f "$session_status_file" ]]; then
+                local reload_needed
+                reload_needed=$(python3 -c "
+import json, sys
+with open(sys.argv[1]) as f:
+    data = json.load(f)
+print(data.get('reload_needed', False))
+" "$session_status_file" 2>/dev/null || echo "False")
+                if [[ "$reload_needed" == "True" ]]; then
+                    echo ""
+                    log_warn "╔══════════════════════════════════════════════════════════════╗"
+                    log_warn "║  RELOAD NEEDED: This session modified pipeline skills or     ║"
+                    log_warn "║  templates that are used by the dev-pipeline itself.          ║"
+                    log_warn "║  Changes will take effect in the NEXT session.                ║"
+                    log_warn "╚══════════════════════════════════════════════════════════════╝"
+                fi
+            fi
+        fi
+
         log_success "════════════════════════════════════════════════════"
         log_success "  $feature_id completed successfully!"
         log_success "════════════════════════════════════════════════════"
@@ -738,15 +784,36 @@ for f in data.get('stuck_features', []):
         mkdir -p "$session_dir/logs"
 
         local bootstrap_prompt="$session_dir/bootstrap-prompt.md"
-        python3 "$SCRIPTS_DIR/generate-bootstrap-prompt.py" \
-            --feature-list "$feature_list" \
-            --feature-id "$feature_id" \
-            --session-id "$session_id" \
-            --run-id "$run_id" \
-            --retry-count "$retry_count" \
-            --resume-phase "$resume_phase" \
-            --state-dir "$STATE_DIR" \
-            --output "$bootstrap_prompt" >/dev/null 2>&1
+
+        local main_prompt_args=(
+            --feature-list "$feature_list"
+            --feature-id "$feature_id"
+            --session-id "$session_id"
+            --run-id "$run_id"
+            --retry-count "$retry_count"
+            --resume-phase "$resume_phase"
+            --state-dir "$STATE_DIR"
+            --output "$bootstrap_prompt"
+        )
+
+        # Support PIPELINE_MODE env var (set by launch-daemon.sh --mode)
+        if [[ -n "${PIPELINE_MODE:-}" ]]; then
+            main_prompt_args+=(--mode "$PIPELINE_MODE")
+        fi
+
+        # Auto-detect framework repo: if scripts/bundle.js exists, enable self-evolve mode
+        if [[ -z "${PIPELINE_MODE:-}" ]]; then
+            local _project_root
+            _project_root=$(git -C "$SCRIPT_DIR" rev-parse --show-toplevel 2>/dev/null || echo "")
+            if [[ -n "$_project_root" && -f "$_project_root/scripts/bundle.js" ]]; then
+                if [[ $session_count -eq 0 ]]; then
+                    log_info "Detected PrizmKit framework repo — auto-enabling self-evolve mode"
+                fi
+                main_prompt_args+=(--mode "self-evolve")
+            fi
+        fi
+
+        python3 "$SCRIPTS_DIR/generate-bootstrap-prompt.py" "${main_prompt_args[@]}" >/dev/null 2>&1
 
         # Update current session tracking (atomic write via temp file)
         python3 -c "
@@ -756,7 +823,7 @@ feature_id, session_id, state_dir = sys.argv[1], sys.argv[2], sys.argv[3]
 data = {
     'feature_id': feature_id,
     'session_id': session_id,
-    'started_at': datetime.utcnow().strftime('%Y-%m-%dT%H:%M:%SZ')
+    'started_at': datetime.now(datetime.UTC).strftime('%Y-%m-%dT%H:%M:%SZ')
 }
 target = os.path.join(state_dir, 'current-session.json')
 tmp = target + '.tmp'
@@ -806,7 +873,7 @@ show_help() {
     echo "Single Feature Options (run <feature-id>):"
     echo "  --dry-run                   Generate bootstrap prompt only, don't spawn session"
     echo "  --resume-phase N            Override resume phase (default: auto-detect)"
-    echo "  --mode <lite|standard|full> Override pipeline mode (bypasses estimated_complexity)"
+    echo "  --mode <lite|standard|full|self-evolve> Override pipeline mode (bypasses estimated_complexity)"
     echo "  --clean                     Delete artifacts and reset before running"
     echo "  --no-reset                  Skip feature status reset step"
     echo "  --timeout N                 Session timeout in seconds (default: 0 = no limit)"
@@ -821,6 +888,7 @@ show_help() {
     echo "  LOG_CLEANUP_ENABLED   Run log cleanup before execution (default: 1)"
     echo "  LOG_RETENTION_DAYS    Delete logs older than N days (default: 14)"
     echo "  LOG_MAX_TOTAL_MB      Keep total logs under N MB (default: 1024)"
+    echo "  PIPELINE_MODE         Override mode for all features: lite|standard|full|self-evolve"
     echo ""
     echo "Examples:"
     echo "  ./run.sh run                                         # Run all features"
@@ -887,7 +955,7 @@ case "${1:-run}" in
             unset CLAUDECODE
             case "$CLI_CMD" in
                 *claude*)
-                    "$CLI_CMD" --print -p "$test_prompt" --dangerously-skip-permissions --no-session-persistence $local_model_flag > "$tmpfile" 2>/dev/null
+                    "$CLI_CMD" -p "$test_prompt" --dangerously-skip-permissions --no-session-persistence $local_model_flag > "$tmpfile" 2>/dev/null
                     ;;
                 *)
                     echo "$test_prompt" | "$CLI_CMD" --print -y $local_model_flag > "$tmpfile" 2>/dev/null

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

@@ -84,7 +84,7 @@ def parse_args():
     )
     parser.add_argument(
         "--mode",
-        choices=["lite", "standard", "full"],
+        choices=["lite", "standard", "full", "self-evolve"],
         default=None,
         help="Override pipeline mode (default: auto-detect from complexity)",
     )
@@ -276,14 +276,35 @@ def process_mode_blocks(content, pipeline_mode, init_done):
     """Process pipeline mode and init conditional blocks.
 
     Keeps the block matching the current mode, removes the others.
+    For self-evolve mode: keeps SELF_EVOLVE blocks AND FULL blocks
+    (since self-evolve is full + framework guardrails).
     """
+    is_self_evolve = pipeline_mode == "self-evolve"
+
+    # Step 1: Handle SELF_EVOLVE conditional blocks first
+    se_open = "{{IF_MODE_SELF_EVOLVE}}"
+    se_close = "{{END_IF_MODE_SELF_EVOLVE}}"
+    if is_self_evolve:
+        # Keep content, remove tags
+        content = content.replace(se_open + "\n", "")
+        content = content.replace(se_open, "")
+        content = content.replace(se_close + "\n", "")
+        content = content.replace(se_close, "")
+    else:
+        # Remove entire SELF_EVOLVE blocks
+        pattern = re.escape(se_open) + r".*?" + re.escape(se_close) + r"\n?"
+        content = re.sub(pattern, "", content, flags=re.DOTALL)
+
+    # Step 2: Handle lite/standard/full blocks
+    # self-evolve inherits full mode for the standard tier blocks
+    effective_mode = "full" if is_self_evolve else pipeline_mode
     modes = ["lite", "standard", "full"]
 
     for mode in modes:
         tag_open = "{{{{IF_MODE_{}}}}}".format(mode.upper())
         tag_close = "{{{{END_IF_MODE_{}}}}}".format(mode.upper())
 
-        if mode == pipeline_mode:
+        if mode == effective_mode:
             # Keep content, remove tags
             content = content.replace(tag_open + "\n", "")
             content = content.replace(tag_open, "")
@@ -427,6 +448,8 @@ def build_replacements(args, feature, features, global_context, script_dir):
     else:
         pipeline_mode = determine_pipeline_mode(complexity)
 
+    is_self_evolve = pipeline_mode == "self-evolve"
+
     # Auto-detect resume: if all planning artifacts exist and resume_phase
     # is "null" (fresh start), skip to Phase 6
     effective_resume = args.resume_phase
@@ -468,6 +491,7 @@ def build_replacements(args, feature, features, global_context, script_dir):
         "{{HAS_PLAN}}": "true" if artifacts["has_plan"] else "false",
         "{{HAS_TASKS}}": "true" if artifacts["has_tasks"] else "false",
         "{{ARTIFACTS_COMPLETE}}": "true" if artifacts["all_complete"] else "false",
+        "{{IS_SELF_EVOLVE}}": "true" if is_self_evolve else "false",
     }
 
     return replacements, effective_resume
@@ -539,6 +563,7 @@ def main():
             "lite": "bootstrap-tier1.md",
             "standard": "bootstrap-tier2.md",
             "full": "bootstrap-tier3.md",
+            "self-evolve": "bootstrap-tier3.md",
         }
         _tier_file = _tier_file_map.get(_mode, "bootstrap-tier2.md")
         _tier_path = os.path.join(script_dir, "..", "templates", _tier_file)

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

@@ -124,9 +124,9 @@ def load_feature_status(state_dir, feature_id, feature_list_status=None):
     )
     if not os.path.isfile(status_path):
         now = now_iso()
-        return {
+        data = {
             "feature_id": feature_id,
-            "status": "pending",
+            "status": feature_list_status if feature_list_status else "pending",
             "retry_count": 0,
             "max_retries": 3,
             "sessions": [],
@@ -135,13 +135,14 @@ def load_feature_status(state_dir, feature_id, feature_list_status=None):
             "created_at": now,
             "updated_at": now,
         }
+        return data
     data, err = load_json_file(status_path)
     if err:
         # If we can't read it, treat as pending
         now = now_iso()
         data = {
             "feature_id": feature_id,
-            "status": "pending",
+            "status": feature_list_status if feature_list_status else "pending",
             "retry_count": 0,
             "max_retries": 3,
             "sessions": [],
@@ -685,7 +686,12 @@ def _estimate_remaining_time(features, state_dir, counts, feature_list_data=None
 
 
 def action_status(feature_list_data, state_dir):
-    """Print a formatted overview of all features and their status."""
+    """Print a formatted overview of all features and their status.
+
+    Status is read exclusively from 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")
 
@@ -701,7 +707,7 @@ def action_status(feature_list_data, state_dir):
     }
     feature_lines = []
 
-    # Build dependency info: feature_id -> list of dep_ids that are not completed
+    # Build status map from feature-list.json only
     status_map = {}
     for feature in features:
         if not isinstance(feature, dict):
@@ -709,8 +715,7 @@ def action_status(feature_list_data, state_dir):
         fid = feature.get("id")
         if not fid:
             continue
-        fs = load_feature_status(state_dir, fid, feature.get("status"))
-        status_map[fid] = fs.get("status", "pending")
+        status_map[fid] = feature.get("status", "pending")
 
     for feature in features:
         if not isinstance(feature, dict):
@@ -720,11 +725,7 @@ def action_status(feature_list_data, state_dir):
         if not fid:
             continue
 
-        fs = load_feature_status(state_dir, fid, feature.get("status"))
-        fstatus = fs.get("status", "pending")
-        retry_count = fs.get("retry_count", 0)
-        max_retries_val = fs.get("max_retries", 3)
-        resume_phase = fs.get("resume_from_phase")
+        fstatus = feature.get("status", "pending")
 
         # Count statuses
         if fstatus in counts:
@@ -750,21 +751,7 @@ def action_status(feature_list_data, state_dir):
 
         # Build detail suffix
         detail = ""
-        if fstatus == "in_progress":
-            parts = []
-            if retry_count > 0:
-                parts.append("retry {}/{}".format(retry_count, max_retries_val))
-            if resume_phase is not None:
-                parts.append("CP-{}".format(resume_phase))
-            if parts:
-                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":
+        if fstatus == "pending":
             # Check if blocked by dependencies
             deps = feature.get("dependencies", [])
             blocking = [

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

@@ -31,6 +31,40 @@ You are the **session orchestrator**. Implement Feature {{FEATURE_ID}}: "{{FEATU
 
 {{GLOBAL_CONTEXT}}
 
+{{IF_MODE_SELF_EVOLVE}}
+## Framework Self-Development Context
+
+**You are developing the PrizmKit framework itself.** This is NOT a regular project — you are modifying the tool that powers this pipeline. Extra guardrails apply.
+
+### Framework Structure
+
+```
+core/skills/          — Skill definitions (each has _metadata.json)
+core/agents/          — Agent .md definitions (YAML frontmatter required)
+core/team/            — Team config (dev repo only, NOT installed)
+dev-pipeline/         — Pipeline scripts + templates (installed with --pipeline)
+  templates/          — Bootstrap prompt templates (tier1/2/3)
+  scripts/            — Python/bash pipeline scripts
+create-prizmkit/      — npm package / CLI installer
+  bundled/            — Pre-bundled assets (auto-generated, NEVER edit directly)
+tests/                — Validation + unit tests
+```
+
+### 5 Key Invariants (MUST be preserved)
+
+1. **Skill ↔ _metadata.json 1:1 mapping**: Every directory in `core/skills/` MUST have a `_metadata.json`. Every `_metadata.json` must reference an existing skill directory.
+2. **Template variables resolve completely**: All `{{PLACEHOLDER}}` in `dev-pipeline/templates/` must be resolvable by `generate-bootstrap-prompt.py`. No unresolved placeholders in output.
+3. **Agent YAML frontmatter is valid**: Every `.md` in `core/agents/` must have valid YAML frontmatter with required fields (name, description, tools).
+4. **Bundle is generated, never hand-edited**: `create-prizmkit/bundled/` is auto-generated by `scripts/bundle.js`. Manual edits will be overwritten.
+5. **CI must pass**: `npm run ci` (validate-all + bundle + verify-bundle + eslint + vitest) must pass after every change.
+
+### Version Isolation
+
+LLM context is frozen at prompt time. Modifying a skill source file during this session will NOT change the behavior of that skill within this session. The real risk is structural inconsistency.
+
+**When you modify any file in `dev-pipeline/scripts/`, `dev-pipeline/templates/`, or `core/skills/` that this pipeline actively uses**: set `reload_needed: true` in `session-status.json`. The pipeline runner will warn the operator after session completion.
+{{END_IF_MODE_SELF_EVOLVE}}
+
 ## PrizmKit Directory Convention
 
 ```
@@ -182,6 +216,17 @@ grep -c '^\- \[ \]' .prizmkit/specs/{{FEATURE_SLUG}}/tasks.md 2>/dev/null || ech
 
 Spawn Dev agent (Task tool, subagent_type="prizm-dev-team-dev", run_in_background=false).
 
+{{IF_MODE_SELF_EVOLVE}}
+**Framework Self-Evolve — Dev Extra Instructions**:
+Append the following to the Dev agent prompt:
+> "FRAMEWORK RULES (self-evolve mode):
+> - If you modify any file in `core/skills/`, also update `_metadata.json` in the same skill directory.
+> - If you modify `dev-pipeline/templates/*.md`, verify all `{{PLACEHOLDER}}` markers have matching entries in `generate-bootstrap-prompt.py`.
+> - Before marking implementation complete, run `node tests/validate-all.js` and fix any failures.
+> - NEVER directly modify files in `create-prizmkit/bundled/` — those are auto-generated by `scripts/bundle.js`.
+> - If you modify any file in `dev-pipeline/scripts/` or `dev-pipeline/templates/` or `core/skills/` that this pipeline uses, note this in your Implementation Log for reload_needed tracking."
+{{END_IF_MODE_SELF_EVOLVE}}
+
 Prompt:
 > "Read {{DEV_SUBAGENT_PATH}}. Implement feature {{FEATURE_ID}} (slug: {{FEATURE_SLUG}}) using TDD.
 > 1. Read `.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md` FIRST — all source files and context are there. Do NOT re-read individual source files.
@@ -210,6 +255,18 @@ All tasks `[x]`, tests pass.
 
 Spawn Reviewer agent (Task tool, subagent_type="prizm-dev-team-reviewer", run_in_background=false).
 
+{{IF_MODE_SELF_EVOLVE}}
+**Framework Self-Evolve — Reviewer Extra Instructions**:
+Append the following to the Reviewer agent prompt:
+> "FRAMEWORK REVIEW DIMENSIONS (self-evolve mode):
+> In addition to standard code review, check:
+> 1. **Structural integrity**: Every `core/skills/*/` must have `_metadata.json`. Run `node tests/validate-all.js` to verify.
+> 2. **Template safety**: If any `dev-pipeline/templates/*.md` was modified, check that all `{{PLACEHOLDER}}` markers are properly balanced (open/close) and resolvable.
+> 3. **Agent frontmatter**: If any `core/agents/*.md` was modified, validate YAML frontmatter has required fields (name, description, tools).
+> 4. **CI gate**: Run `npm run ci` and report the result. Any failure is CRITICAL.
+> 5. **Bundle safety**: Verify no files in `create-prizmkit/bundled/` were directly modified (check `git diff --name-only` for bundled/ changes)."
+{{END_IF_MODE_SELF_EVOLVE}}
+
 Prompt:
 > "Read {{REVIEWER_SUBAGENT_PATH}}. For feature {{FEATURE_ID}} (slug: {{FEATURE_SLUG}}):
 > 1. Read `.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md` FIRST — Section 4 has original source files, 'Implementation Log' section lists exactly what Dev changed. Do NOT re-read source files that are NOT mentioned in the Implementation Log.
@@ -232,6 +289,27 @@ Wait for Reviewer to return.
 
 ### Phase 7: Summarize & Commit — DO NOT SKIP
 
+{{IF_MODE_SELF_EVOLVE}}
+**Framework Validation Gate (self-evolve mode)**:
+
+Before proceeding with commit, run the full framework CI pipeline:
+
+```bash
+bash {{VALIDATOR_SCRIPTS_DIR}}/validate-framework.sh
+```
+
+- If ALL steps pass → proceed with commit below.
+- If any step fails → fix the issue and re-run. Maximum 2 fix-and-retry rounds.
+- After 2 failed rounds → mark session as `framework_validation_failed`, write session-status.json, and exit.
+
+**reload_needed check**: Review the Implementation Log in context-snapshot.md. If ANY of these paths were modified:
+- `dev-pipeline/scripts/*.py` or `dev-pipeline/scripts/*.sh`
+- `dev-pipeline/templates/*.md`
+- `core/skills/` (any skill used by the pipeline)
+
+Then set `"reload_needed": true` in session-status.json.
+{{END_IF_MODE_SELF_EVOLVE}}
+
 **For bug fixes**: skip `/prizmkit-summarize`, skip retrospective, and use `fix(<scope>):` commit prefix.
 
 **7a.** Check if feature already committed:

package/bundled/dev-pipeline/tests/test_update_feature_status.py

@@ -255,23 +255,14 @@ class TestActionUpdateDegradedStatuses:
 
 class TestActionStatusForDegradedStates:
     def test_status_output_contains_degraded_counters(self, feature_list_file, state_dir, capsys):
-        # Prepare commit_missing and docs_missing statuses
-        f1_dir = os.path.join(state_dir, "features", "F-001")
-        f2_dir = os.path.join(state_dir, "features", "F-002")
-        os.makedirs(f1_dir, exist_ok=True)
-        os.makedirs(f2_dir, exist_ok=True)
-
-        with open(os.path.join(f1_dir, "status.json"), "w", encoding="utf-8") as f:
-            json.dump({"status": "commit_missing", "retry_count": 1, "max_retries": 3}, f)
-        with open(os.path.join(f2_dir, "status.json"), "w", encoding="utf-8") as f:
-            json.dump({"status": "docs_missing", "retry_count": 2, "max_retries": 3}, f)
-
+        # Update feature-list.json to set degraded statuses (single source of truth)
         with open(feature_list_file, "r", encoding="utf-8") as f:
             feature_list_data = json.load(f)
 
+        feature_list_data["features"][0]["status"] = "commit_missing"
+        feature_list_data["features"][1]["status"] = "docs_missing"
+
         ufs.action_status(feature_list_data, state_dir)
         out = capsys.readouterr().out
 
         assert "Commit Missing: 1 | Docs Missing: 1" in out
-        assert "commit missing, retry 1/3" in out
-        assert "docs missing, retry 2/3" in out

package/bundled/skills/_metadata.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.29",
+  "version": "1.0.35",
   "skills": {
     "prizm-kit": {
       "description": "Full-lifecycle dev toolkit. Covers spec-driven development, Prizm context docs, code quality, debugging, deployment, and knowledge management.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prizmkit",
-  "version": "1.0.29",
+  "version": "1.0.35",
   "description": "Create a new PrizmKit-powered project with clean initialization — no framework dev files, just what you need.",
   "type": "module",
   "bin": {