prizmkit 1.1.100 → 1.1.102

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

@@ -1,2279 +0,0 @@
-#!/usr/bin/env python3
-"""Generate a session-specific bootstrap prompt from template and feature list.
-
-Supports two modes:
-1. **Section assembly** (preferred): Loads modular section files from
-   templates/sections/ and assembles them based on tier, conditions, and
-   feature configuration. Conditional logic is handled in Python code,
-   not regex-based template blocks.
-2. **Legacy template** (fallback): Reads a monolithic bootstrap-tier{1,2,3}.md
-   template and resolves {{PLACEHOLDER}} variables and {{IF_xxx}} blocks.
-
-The section assembly mode is used when templates/sections/ directory exists.
-Otherwise, falls back to legacy templates for backward compatibility.
-
-Usage:
-    python3 generate-bootstrap-prompt.py \
-        --feature-list <path> --feature-id <id> \
-        --session-id <id> --run-id <id> \
-        --retry-count <n> --resume-phase <n|null> \
-        --output <path>
-"""
-
-import argparse
-import glob
-import json
-import os
-import re
-import sys
-
-from utils import enrich_global_context, load_json_file, read_platform_conventions, setup_logging
-from continuation import add_continuation_args, append_continuation_handoff, is_continuation
-
-
-DEFAULT_MAX_RETRIES = 3
-DEFAULT_MAX_LOG_SIZE = 2097152
-
-LOGGER = setup_logging("generate-bootstrap-prompt")
-
-
-def parse_args():
-    parser = argparse.ArgumentParser(
-        description=(
-            "Generate a session-specific bootstrap prompt from a template "
-            "and .prizmkit/plans/feature-list.json."
-        )
-    )
-    parser.add_argument(
-        "--feature-list",
-        required=True,
-        help="Path to .prizmkit/plans/feature-list.json",
-    )
-    parser.add_argument(
-        "--feature-id",
-        required=True,
-        help="Feature ID to generate prompt for (e.g. F-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(
-        "--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/bootstrap-prompt.md"
-        ),
-    )
-    parser.add_argument(
-        "--mode",
-        choices=["lite", "standard", "full"],
-        default=None,
-        help="Override pipeline mode (default: auto-detect from complexity)",
-    )
-    parser.add_argument(
-        "--critic",
-        choices=["true", "false"],
-        default=None,
-        help="Override critic enablement (default: read from feature field)",
-    )
-    parser.add_argument(
-        "--extract-baselines",
-        action="store_true",
-        help="Run tests and extract baseline failures (slower, optional)",
-    )
-    parser.add_argument(
-        "--no-checkpoint",
-        action="store_true",
-        help="Do not write workflow-checkpoint.json (used by pipeline dry-run)",
-    )
-
-    add_continuation_args(parser, "feature")
-
-    return parser.parse_args()
-
-
-def read_text_file(path):
-    """Read and return the text content of a file."""
-    abs_path = os.path.abspath(path)
-    if not os.path.isfile(abs_path):
-        return None, "File not found: {}".format(abs_path)
-    try:
-        with open(abs_path, "r", encoding="utf-8") as f:
-            return f.read(), None
-    except IOError as e:
-        return None, "Cannot read file: {}".format(str(e))
-
-
-def find_feature(features, feature_id):
-    """Find and return the feature dict matching the given ID."""
-    for feature in features:
-        if isinstance(feature, dict) and feature.get("id") == feature_id:
-            return feature
-    return None
-
-
-def compute_feature_slug(feature_id, title):
-    """Compute the prizmkit feature slug: ###-kebab-case-name.
-
-    e.g. F-001 + "Project Infrastructure Setup" -> "001-project-infrastructure-setup"
-    The prizmkit skills use this slug to create per-feature directories.
-    """
-    # Extract numeric part from feature_id (e.g., "F-001" -> "001")
-    numeric = feature_id.replace("F-", "").replace("f-", "")
-    # Pad to 3 digits
-    numeric = numeric.zfill(3)
-
-    # Convert title to kebab-case
-    slug = title.lower()
-    slug = re.sub(r"[^a-z0-9\s-]", "", slug)  # remove non-alphanumeric
-    slug = re.sub(r"[\s]+", "-", slug.strip())  # spaces to hyphens
-    slug = re.sub(r"-+", "-", slug)  # collapse multiple hyphens
-    slug = slug.strip("-")
-
-    return "{}-{}".format(numeric, slug)
-
-
-def _format_bytes(n):
-    """Format a byte count to a human-readable string."""
-    if n >= 1048576:
-        return "{}MB".format(n // 1048576)
-    elif n >= 1024:
-        return "{}KB".format(n // 1024)
-    return "{}B".format(n)
-
-
-def _parse_non_negative_int_env(name, default):
-    """Parse a non-negative integer environment variable."""
-    value = os.environ.get(name, str(default))
-    try:
-        parsed = int(value)
-    except ValueError:
-        emit_failure("{} must be a non-negative integer".format(name))
-    if parsed < 0:
-        emit_failure("{} must be a non-negative integer".format(name))
-    return parsed
-
-
-def _parse_positive_int_env(name, default):
-    """Parse a positive integer environment variable."""
-    value = os.environ.get(name, str(default))
-    try:
-        parsed = int(value)
-    except ValueError:
-        emit_failure("{} must be a positive integer".format(name))
-    if parsed <= 0:
-        emit_failure("{} must be a positive integer".format(name))
-    return parsed
-
-
-
-def load_log_size_section(script_dir):
-    """Load the optional log-size awareness prompt section."""
-    max_log_size = _parse_non_negative_int_env("MAX_LOG_SIZE", DEFAULT_MAX_LOG_SIZE)
-    if max_log_size == 0:
-        return ""
-
-    section_path = os.path.join(
-        script_dir, "..", "templates", "sections", "log-size-awareness.md",
-    )
-    content, err = read_text_file(section_path)
-    if err:
-        return ""
-    return content
-
-def format_acceptance_criteria(criteria):
-    """Format acceptance criteria as a markdown bullet list."""
-    if not criteria:
-        return "- (none specified)"
-    lines = []
-    for item in criteria:
-        lines.append("- {}".format(item))
-    return "\n".join(lines)
-
-def dedupe_test_commands(test_commands):
-    """Return test commands with original order preserved."""
-    return list(dict.fromkeys(test_commands))
-
-
-def format_powershell_test_commands(test_commands):
-    """Format test commands as PowerShell statements with fail-fast guards."""
-    commands = dedupe_test_commands(test_commands)
-    if not commands:
-        return ""
-    guarded_commands = [
-        "{}; if ($LASTEXITCODE -ne 0) {{ exit $LASTEXITCODE }}".format(command)
-        for command in commands
-    ]
-    return "; ".join(guarded_commands)
-
-
-def format_baseline_test_commands(test_commands):
-    """Format test commands for Python's sequential baseline extraction."""
-    return dedupe_test_commands(test_commands)
-
-
-def detect_test_command_list(project_root):
-    """
-    Auto-detect test commands based on project structure.
-
-    Returns: ordered list of test commands.
-    """
-    test_commands = []
-
-    # Check for npm/package.json
-    if os.path.exists(os.path.join(project_root, "package.json")):
-        test_commands.append("npm test")
-
-    # Check for Go
-    if os.path.exists(os.path.join(project_root, "go.mod")):
-        test_commands.append("go test ./...")
-
-    # Check for Rust/Cargo
-    if os.path.exists(os.path.join(project_root, "Cargo.toml")):
-        test_commands.append("cargo test")
-
-    # Check for Python pytest
-    if os.path.exists(os.path.join(project_root, "pytest.ini")) or \
-       os.path.exists(os.path.join(project_root, "setup.py")):
-        test_commands.append("pytest")
-
-    # Check for Make test target
-    makefile_path = os.path.join(project_root, "Makefile")
-    if os.path.exists(makefile_path):
-        try:
-            with open(makefile_path, 'r') as f:
-                if 'test:' in f.read():
-                    test_commands.append("make test")
-        except Exception:
-            pass
-
-    return dedupe_test_commands(test_commands)
-
-
-def detect_test_commands(project_root):
-    """Auto-detect and format test commands for Windows PowerShell prompts."""
-    return format_powershell_test_commands(detect_test_command_list(project_root))
-
-
-def extract_baseline_failures(test_commands, project_root):
-    """
-    Run test command and extract failing tests.
-
-    Returns: semicolon-separated list of failing test names
-    """
-    if isinstance(test_commands, str):
-        test_commands = [test_commands]
-    test_commands = [command for command in test_commands if command]
-
-    if not test_commands or test_commands[0].startswith("(auto-detection"):
-        return ""
-
-    original_cwd = os.getcwd()
-    try:
-        import subprocess
-        os.chdir(project_root)
-
-        output_parts = []
-        for command in test_commands:
-            result = subprocess.run(
-                command,
-                shell=True,
-                capture_output=True,
-                text=True,
-                timeout=120
-            )
-            output_parts.append(result.stdout + result.stderr)
-
-        os.chdir(original_cwd)
-
-        output = "\n".join(output_parts)
-        failures = []
-
-        for line in output.split('\n'):
-            if 'FAILED' in line and '::' in line:
-                parts = line.split('FAILED')
-                if len(parts) > 1:
-                    test_name = parts[1].strip().split(' ')[0]
-                    if test_name and test_name not in failures:
-                        failures.append(test_name)
-
-        return ";".join(failures) if failures else ""
-
-    except Exception as e:
-        return f"(error: {str(e)})"
-    finally:
-        try:
-            os.chdir(original_cwd)
-        except Exception:
-            pass
-
-
-def format_ac_checklist(acceptance_criteria):
-    """Format acceptance criteria as a markdown checkbox list."""
-    if not acceptance_criteria:
-        return "- (no Verification Gates specified)"
-    lines = []
-    for item in acceptance_criteria:
-        lines.append("- [ ] {}".format(item))
-    return "\n".join(lines)
-
-
-
-def format_global_context(global_context, project_root=None):
-    """Format global_context dict as a key-value list.
-
-    If global_context is empty/sparse and project_root is provided,
-    auto-detect tech stack from project files to fill gaps.
-    """
-    if project_root:
-        enrich_global_context(global_context, project_root)
-
-    if not global_context:
-        return "- (none specified)"
-    lines = []
-    for key, value in sorted(global_context.items()):
-        lines.append("- **{}**: {}".format(key, value))
-    return "\n".join(lines)
-
-
-def format_user_context(user_context):
-    """Format user_context array as a markdown section.
-
-    Returns empty string if user_context is empty or absent,
-    so the template placeholder resolves to nothing.
-    """
-    if not user_context or not isinstance(user_context, list):
-        return ""
-    items = [item for item in user_context if isinstance(item, str) and item.strip()]
-    if not items:
-        return ""
-    lines = [
-        "> These materials were provided by the user and are authoritative "
-        "when they clarify or constrain this feature. They do not expand "
-        "the current scope by themselves; use the Task Contract to decide "
-        "what belongs to this session.",
-        "",
-    ]
-    for item in items:
-        lines.append("- {}".format(item))
-    return "\n".join(lines)
-
-
-def get_completed_dependencies(features, feature):
-    """Look up dependency features and list those with status=completed.
-
-    When a completed dependency has completion_notes (written by the AI
-    session and propagated by the pipeline runner), include them as rich
-    context so the downstream session knows what was built.
-    """
-    deps = feature.get("dependencies", [])
-    if not deps:
-        return "- (no dependencies)"
-
-    # Build a lookup map
-    feature_map = {}
-    for f in features:
-        if isinstance(f, dict) and "id" in f:
-            feature_map[f["id"]] = f
-
-    sections = []
-    for dep_id in deps:
-        dep = feature_map.get(dep_id)
-        if dep and dep.get("status") == "completed":
-            header = "- **{}** — {} (completed)".format(
-                dep_id, dep.get("title", "Untitled")
-            )
-            notes = dep.get("completion_notes", [])
-            if notes and isinstance(notes, list):
-                note_lines = "\n".join(
-                    "  - {}".format(n) for n in notes
-                    if isinstance(n, str) and n.strip()
-                )
-                if note_lines:
-                    header += "\n" + note_lines
-            sections.append(header)
-
-    if not sections:
-        return "- (no completed dependencies yet)"
-    return "\n".join(sections)
-
-
-def get_prev_session_status(state_dir, feature_id):
-    """Read previous session status from state dir if available."""
-    if not state_dir:
-        return "N/A (first run)"
-
-    # Try to read the feature status file to find the last session
-    feature_status_path = os.path.join(state_dir, feature_id, "status.json")
-    if not os.path.isfile(feature_status_path):
-        return "N/A (first run)"
-
-    try:
-        with open(feature_status_path, "r", encoding="utf-8") as f:
-            feature_status = json.load(f)
-    except (json.JSONDecodeError, IOError):
-        return "N/A (could not read feature status)"
-
-    last_session_id = feature_status.get("last_session_id")
-    if not last_session_id:
-        return "N/A (first run)"
-
-    # Try to read the last session's session-status.json
-    session_status_path = os.path.join(state_dir, feature_id, "sessions",
-        last_session_id, "session-status.json"
-    )
-    if not os.path.isfile(session_status_path):
-        return "N/A (previous session status file not found)"
-
-    try:
-        with open(session_status_path, "r", encoding="utf-8") as f:
-            session_data = json.load(f)
-    except (json.JSONDecodeError, IOError):
-        return "N/A (could not read previous session status)"
-
-    status = session_data.get("status", "unknown")
-    checkpoint = session_data.get("checkpoint_reached", "none")
-    current_phase = session_data.get("current_phase", "unknown")
-    errors = session_data.get("errors", [])
-
-    result = "{} (checkpoint: {}, last phase: {})".format(
-        status, checkpoint, current_phase
-    )
-    if errors:
-        result += " — errors: {}".format("; ".join(str(e) for e in errors))
-    return result
-
-
-def _read_project_brief(project_root):
-    """Read project-brief.md from new or old location with fallback.
-
-    Returns the file content as a string, or a fallback message if absent.
-    This brief is generated by app-planner during interactive planning and
-    captures the user's product ideas as a checklist. Each line is one idea,
-    marked [ ] for pending or [x] for completed. Feature sessions should mark
-    items [x] and append key file paths when implementing relevant ideas.
-    """
-    # Check both new and old paths for backward compatibility
-    new_path = os.path.join(project_root, ".prizmkit", "plans", "project-brief.md")
-    old_path = os.path.join(project_root, "project-brief.md")
-
-    for brief_path in [new_path, old_path]:
-        if os.path.isfile(brief_path):
-            try:
-                with open(brief_path, "r", encoding="utf-8") as f:
-                    content = f.read().strip()
-                    if brief_path == old_path:
-                        # Warn user about old path
-                        import sys
-                        print("⚠️  Migration notice: project-brief.md found in root. "
-                              "Please move to .prizmkit/plans/project-brief.md",
-                              file=sys.stderr)
-                    return content
-            except IOError:
-                return "(project-brief.md exists but could not be read)"
-
-    return "(No project brief available)"
-
-
-def resolve_project_root(script_dir):
-    """Resolve project root from script_dir of the prompt-generator script.
-
-    Layout-aware:
-      <project>/.prizmkit/dev-pipeline/scripts/  → project root = <project>
-      <repo>/dev-pipeline/scripts/               → project root = <repo>
-    """
-    pipeline_dir = os.path.dirname(script_dir)
-    pipeline_parent = os.path.dirname(pipeline_dir)
-    if os.path.basename(pipeline_parent) == ".prizmkit":
-        return os.path.abspath(os.path.dirname(pipeline_parent))
-    return os.path.abspath(pipeline_parent)
-
-
-def process_conditional_blocks(content, resume_phase):
-    """Handle conditional blocks based on resume_phase.
-
-    Supports:
-    - {{IF_FRESH_START}} / {{END_IF_FRESH_START}}
-    - {{IF_RESUME}} / {{END_IF_RESUME}}
-    - {{IF_RETRY}} / {{END_IF_RETRY}}
-    """
-    is_resume = resume_phase != "null"
-
-    if is_resume:
-        # Remove fresh-start blocks, keep resume blocks
-        content = re.sub(
-            r"\{\{IF_FRESH_START\}\}.*?\{\{END_IF_FRESH_START\}\}\n?",
-            "", content, flags=re.DOTALL,
-        )
-        content = re.sub(r"\{\{IF_RESUME\}\}\n?", "", content)
-        content = re.sub(r"\{\{END_IF_RESUME\}\}\n?", "", content)
-    else:
-        # Keep fresh-start blocks, remove resume blocks
-        content = re.sub(r"\{\{IF_FRESH_START\}\}\n?", "", content)
-        content = re.sub(r"\{\{END_IF_FRESH_START\}\}\n?", "", content)
-        content = re.sub(
-            r"\{\{IF_RESUME\}\}.*?\{\{END_IF_RESUME\}\}\n?",
-            "", content, flags=re.DOTALL,
-        )
-
-    return content
-
-
-def process_mode_blocks(content, pipeline_mode, init_done, critic_enabled=False,
-                        browser_interaction=False, browser_tool="auto"):
-    """Process pipeline mode, init, critic, and browser conditional blocks.
-
-    Keeps the block matching the current mode, removes the others.
-    Handles {{IF_CRITIC_ENABLED}} / {{END_IF_CRITIC_ENABLED}} blocks.
-    Handles {{IF_BROWSER_INTERACTION}} / {{END_IF_BROWSER_INTERACTION}} blocks.
-    Handles {{IF_BROWSER_TOOL_PLAYWRIGHT}} / {{IF_BROWSER_TOOL_OPENCLI}} /
-    {{IF_BROWSER_TOOL_AUTO}} blocks (nested inside browser interaction block).
-    """
-    # Handle lite/standard/full blocks
-    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:
-            # Keep content, remove tags
-            content = content.replace(tag_open + "\n", "")
-            content = content.replace(tag_open, "")
-            content = content.replace(tag_close + "\n", "")
-            content = content.replace(tag_close, "")
-        else:
-            # Remove entire block
-            pattern = re.escape(tag_open) + r".*?" + re.escape(tag_close) + r"\n?"
-            content = re.sub(pattern, "", content, flags=re.DOTALL)
-
-    # Init blocks
-    if init_done:
-        content = re.sub(r"\{\{IF_INIT_DONE\}\}\n?", "", content)
-        content = re.sub(r"\{\{END_IF_INIT_DONE\}\}\n?", "", content)
-        content = re.sub(
-            r"\{\{IF_INIT_NEEDED\}\}.*?\{\{END_IF_INIT_NEEDED\}\}\n?",
-            "", content, flags=re.DOTALL,
-        )
-    else:
-        content = re.sub(r"\{\{IF_INIT_NEEDED\}\}\n?", "", content)
-        content = re.sub(r"\{\{END_IF_INIT_NEEDED\}\}\n?", "", content)
-        content = re.sub(
-            r"\{\{IF_INIT_DONE\}\}.*?\{\{END_IF_INIT_DONE\}\}\n?",
-            "", content, flags=re.DOTALL,
-        )
-
-    # Critic blocks
-    critic_open = "{{IF_CRITIC_ENABLED}}"
-    critic_close = "{{END_IF_CRITIC_ENABLED}}"
-    if critic_enabled:
-        # Keep content, remove tags
-        content = content.replace(critic_open + "\n", "")
-        content = content.replace(critic_open, "")
-        content = content.replace(critic_close + "\n", "")
-        content = content.replace(critic_close, "")
-    else:
-        # Remove entire CRITIC blocks
-        pattern = re.escape(critic_open) + r".*?" + re.escape(critic_close) + r"\n?"
-        content = re.sub(pattern, "", content, flags=re.DOTALL)
-
-    # Browser interaction blocks
-    browser_open = "{{IF_BROWSER_INTERACTION}}"
-    browser_close = "{{END_IF_BROWSER_INTERACTION}}"
-    if browser_interaction:
-        content = content.replace(browser_open + "\n", "")
-        content = content.replace(browser_open, "")
-        content = content.replace(browser_close + "\n", "")
-        content = content.replace(browser_close, "")
-    else:
-        pattern = re.escape(browser_open) + r".*?" + re.escape(browser_close) + r"\n?"
-        content = re.sub(pattern, "", content, flags=re.DOTALL)
-
-    # Browser tool selection blocks (nested inside browser interaction)
-    tool_variants = ["PLAYWRIGHT", "OPENCLI", "AUTO"]
-    # Map browser_tool value to the variant tag name
-    active_variant = {
-        "playwright-cli": "PLAYWRIGHT",
-        "opencli": "OPENCLI",
-        "auto": "AUTO",
-    }.get(browser_tool, "AUTO")
-
-    for variant in tool_variants:
-        tool_open = "{{{{IF_BROWSER_TOOL_{}}}}}".format(variant)
-        tool_close = "{{{{END_IF_BROWSER_TOOL_{}}}}}".format(variant)
-        if variant == active_variant and browser_interaction:
-            # Keep content, remove tags
-            content = content.replace(tool_open + "\n", "")
-            content = content.replace(tool_open, "")
-            content = content.replace(tool_close + "\n", "")
-            content = content.replace(tool_close, "")
-        else:
-            # Remove entire block
-            pat = re.escape(tool_open) + r".*?" + re.escape(tool_close) + r"\n?"
-            content = re.sub(pat, "", content, flags=re.DOTALL)
-
-    return content
-
-
-def detect_init_status(project_root):
-    """Check if PrizmKit init has already been done."""
-    prizm_docs = os.path.join(project_root, ".prizmkit/prizm-docs", "root.prizm")
-    prizmkit_config = os.path.join(project_root, ".prizmkit", "config.json")
-    return os.path.isfile(prizm_docs) and os.path.isfile(prizmkit_config)
-
-
-def detect_existing_artifacts(project_root, feature_slug):
-    """Check which planning artifacts already exist for this feature.
-
-    Returns a dict with keys: has_spec, has_plan, all_complete.
-    Tasks are now part of plan.md (Tasks section), not a separate file.
-    """
-    specs_dir = os.path.join(project_root, ".prizmkit", "specs", feature_slug)
-    result = {
-        "has_spec": os.path.isfile(os.path.join(specs_dir, "spec.md")),
-        "has_plan": os.path.isfile(os.path.join(specs_dir, "plan.md")),
-    }
-    result["all_complete"] = all([
-        result["has_spec"], result["has_plan"]
-    ])
-    return result
-
-
-def determine_pipeline_mode(complexity):
-    """Map estimated_complexity to pipeline mode.
-
-    Returns: 'lite', 'standard', or 'full'
-
-    Tier assignment rationale:
-    - low + medium → lite (single agent): most features don't benefit from
-      the orchestrator→dev→reviewer overhead. A single agent reading
-      .prizmkit/prizm-docs + implementing directly is faster and cheaper.
-    - high → standard (orchestrator + dev + reviewer): complex features
-      need the spec→plan→analyze→implement→review pipeline.
-    - critical → full (full team + framework guardrails): architectural
-      changes that touch many files and need extra safety checks.
-    """
-    mapping = {
-        "low": "lite",
-        "medium": "lite",
-        "high": "standard",
-        "critical": "full",
-    }
-    return mapping.get(complexity, "lite")
-
-
-# ============================================================
-# Checkpoint generation
-# ============================================================
-
-# Mapping: section name -> (skill_key, display_name, required_artifacts)
-# skill_key is a unique identifier in the checkpoint, not necessarily the
-# prizmkit skill name.  This ensures each section has a distinct key so
-# merge_checkpoint_state() never collides.
-SECTION_TO_SKILL = {
-    "phase0-init": ("prizmkit-init", "Project Bootstrap",
-                    [".prizmkit/prizm-docs/root.prizm", ".prizmkit/config.json"]),
-    "phase0-test-baseline": ("test-baseline", "Test Baseline", []),
-    "phase-context-snapshot": ("context-snapshot", "Build Context Snapshot",
-                               [".prizmkit/specs/{slug}/context-snapshot.md"]),
-    "phase-specify-plan": ("context-snapshot-and-plan", "Specify & Plan",
-                           [".prizmkit/specs/{slug}/context-snapshot.md",
-                            ".prizmkit/specs/{slug}/plan.md"]),
-    "phase-plan": ("prizmkit-plan", "Plan & Tasks",
-                   [".prizmkit/specs/{slug}/plan.md"]),
-    "phase-critic-plan": ("critic-plan-review", "Critic: Plan Review", []),
-    "phase-implement": ("prizmkit-implement", "Implement + Test", []),
-    "phase-prizmkit-test": (
-        "prizmkit-test", "Scoped Feature Test Gate",
-        [".prizmkit/specs/{slug}/test-report-path.txt",
-         ".prizmkit/test/*/test-report.md"],
-    ),
-    "phase-review": ("prizmkit-code-review", "Code Review", []),
-    "phase-browser": ("browser-verification", "Browser Verification", []),
-    "phase-commit": None,  # special: split into retrospective + committer
-}
-
-# phase-commit is split into two steps
-_COMMIT_STEPS = [
-    ("prizmkit-retrospective", "Retrospective", []),
-    ("prizmkit-committer", "Commit", ["--headless"]),
-]
-
-
-def _resolve_artifacts(artifact_templates, slug):
-    """Replace {slug} placeholder with the actual feature slug."""
-    return [a.replace("{slug}", slug) for a in artifact_templates]
-
-
-def _artifact_exists(project_root, artifact):
-    """Return whether an artifact path or glob exists under project_root."""
-    full_path = os.path.join(project_root, artifact)
-    if glob.has_magic(full_path):
-        return bool(glob.glob(full_path))
-    return os.path.exists(full_path)
-
-
-def _read_text(path):
-    """Read a UTF-8 text file, returning an empty string on IO errors."""
-    try:
-        with open(path, "r", encoding="utf-8") as f:
-            return f.read()
-    except IOError:
-        return ""
-
-
-def _normalize_artifact_dir(path):
-    """Normalize report artifact_dir values for comparison."""
-    return path.strip().replace("\\", "/").rstrip("/")
-
-
-def _report_path_matches_artifacts(project_root, report_path, artifacts):
-    """Return whether report_path is an in-project test report artifact."""
-    test_root = os.path.realpath(
-        os.path.join(project_root, ".prizmkit", "test")
-    )
-    resolved_report = os.path.realpath(report_path)
-
-    try:
-        if os.path.commonpath([test_root, resolved_report]) != test_root:
-            return False
-    except ValueError:
-        return False
-
-    report_artifacts = [a for a in artifacts if a.endswith("test-report.md")]
-    for artifact in report_artifacts:
-        artifact_path = os.path.join(project_root, artifact)
-        if glob.has_magic(artifact_path):
-            candidates = glob.glob(artifact_path)
-        else:
-            candidates = [artifact_path]
-        for candidate in candidates:
-            if os.path.realpath(candidate) == resolved_report:
-                return True
-    return False
-
-
-def _extract_scope_field(report_text, field_name):
-    """Extract a '- Field: value' entry from the report Scope section."""
-    in_scope = False
-    prefix = "- {}:".format(field_name)
-    for raw_line in report_text.splitlines():
-        line = raw_line.strip()
-        if line == "## Scope":
-            in_scope = True
-            continue
-        if in_scope and line.startswith("## "):
-            break
-        if in_scope and line.startswith(prefix):
-            return line[len(prefix):].strip()
-    return ""
-
-
-def _extract_report_verdict(report_text):
-    """Extract the first non-empty line after the report Verdict heading."""
-    in_verdict = False
-    for raw_line in report_text.splitlines():
-        line = raw_line.strip()
-        if line == "## Verdict":
-            in_verdict = True
-            continue
-        if in_verdict:
-            if line.startswith("## "):
-                break
-            if line:
-                return line
-    return ""
-
-
-def _extract_report_section(report_text, heading):
-    """Extract text under a level-2 markdown heading."""
-    in_section = False
-    lines = []
-    for raw_line in report_text.splitlines():
-        line = raw_line.strip()
-        if line == heading:
-            in_section = True
-            continue
-        if in_section and line.startswith("## "):
-            break
-        if in_section:
-            lines.append(raw_line)
-    return "\n".join(lines)
-
-
-def _discover_openapi_file(project_root):
-    """Return the first common OpenAPI/Swagger file under project_root."""
-    candidates = [
-        "openapi.yaml", "openapi.yml", "swagger.yaml", "swagger.yml",
-        "docs/openapi.yaml", "docs/openapi.yml",
-        "docs/swagger.yaml", "docs/swagger.yml",
-        "api/openapi.yaml", "api/openapi.yml",
-        "api/swagger.yaml", "api/swagger.yml",
-    ]
-    for candidate in candidates:
-        full_path = os.path.join(project_root, candidate)
-        if os.path.isfile(full_path):
-            return full_path
-    return ""
-
-
-def _normalize_api_path(path):
-    """Normalize API path tokens for exact comparison."""
-    normalized = path.strip().strip("'\"`")
-    if len(normalized) > 1:
-        normalized = normalized.rstrip("/")
-    return normalized
-
-
-def _extract_openapi_operations(openapi_text):
-    """Extract OpenAPI method+path operations without requiring PyYAML."""
-    methods = {"GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS", "TRACE"}
-    operations = []
-    in_paths = False
-    paths_indent = 0
-    current_path = ""
-    current_path_indent = 0
-    path_key_re = re.compile(
-        r"^\s*(?:(['\"])(/.*?)\1|(/[^:\s]+))\s*:\s*(?:#.*)?$"
-    )
-    method_re = re.compile(r"^\s*([A-Za-z]+)\s*:\s*(?:#.*)?$")
-
-    for raw_line in openapi_text.splitlines():
-        stripped = raw_line.strip()
-        if not stripped or stripped.startswith("#"):
-            continue
-
-        indent = len(raw_line) - len(raw_line.lstrip())
-        if not in_paths:
-            if re.match(r"^\s*paths\s*:\s*(?:#.*)?$", raw_line):
-                in_paths = True
-                paths_indent = indent
-            continue
-
-        if indent <= paths_indent:
-            break
-
-        path_match = path_key_re.match(raw_line)
-        if path_match:
-            current_path = path_match.group(2) or path_match.group(3) or ""
-            current_path_indent = indent
-            continue
-
-        method_match = method_re.match(raw_line)
-        if current_path and method_match and indent > current_path_indent:
-            method = method_match.group(1).upper()
-            if method in methods:
-                operations.append((method, _normalize_api_path(current_path)))
-
-    return operations
-
-
-def _extract_matrix_operations(rows):
-    """Extract exact method+path tokens from Boundary Matrix rows."""
-    operations = set()
-    path_only = set()
-    token_re = re.compile(
-        r"(?:(\b(?:GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS|TRACE)\b)\s+)?(/[^\s,`|)]+)",
-        flags=re.IGNORECASE,
-    )
-    for row in rows:
-        interface = row.get("Interface", "")
-        for match in token_re.finditer(interface):
-            method = match.group(1).upper() if match.group(1) else ""
-            path = _normalize_api_path(match.group(2))
-            if not path:
-                continue
-            if method:
-                operations.add((method, path))
-            else:
-                path_only.add(path)
-    return operations, path_only
-
-
-def _boundary_report_sections_valid(project_root, report_text):
-    """Return whether required boundary sections do not report failure."""
-    required_columns = [
-        "Module",
-        "Interface",
-        "Service Type",
-        "Happy Path",
-        "Request Validation",
-        "Auth / Permission / Ownership",
-        "Domain Invariants",
-        "Collection / Pagination",
-        "Date / Time",
-        "State Transitions",
-        "Dependency Failure",
-        "Response Contract",
-        "N/A Reasons",
-        "Final Status",
-    ]
-    category_columns = [
-        "Happy Path",
-        "Request Validation",
-        "Auth / Permission / Ownership",
-        "Domain Invariants",
-        "Collection / Pagination",
-        "Date / Time",
-        "State Transitions",
-        "Dependency Failure",
-        "Response Contract",
-    ]
-    allowed_final_statuses = {
-        "boundary-covered",
-        "generated-needs-review",
-        "skipped-with-reason",
-    }
-    incomplete_markers = {
-        "boundary-missing",
-        "happy-path-only",
-        "unresolved",
-    }
-
-    matrix_section = _extract_report_section(report_text, "## Boundary Matrix")
-    if not matrix_section:
-        return False
-    matrix_lines = [line.strip() for line in matrix_section.splitlines()
-                    if line.strip().startswith("|")]
-    headers = []
-    rows = []
-    for line in matrix_lines:
-        cells = [cell.strip() for cell in line.strip().strip("|").split("|")]
-        if not headers:
-            if "Interface" in cells and "Final Status" in cells:
-                headers = cells
-            continue
-        if all(re.fullmatch(r":?-{3,}:?", cell) for cell in cells):
-            continue
-        if len(cells) < len(headers):
-            cells.extend([""] * (len(headers) - len(cells)))
-        row = {header: cells[i] if i < len(cells) else ""
-               for i, header in enumerate(headers)}
-        if row.get("Interface", "").strip(".` ") in {"", "..."}:
-            continue
-        rows.append(row)
-
-    if not headers or not rows:
-        return False
-    if any(column not in headers for column in required_columns):
-        return False
-
-    for row in rows:
-        final_status = row.get("Final Status", "").strip().lower()
-        if final_status not in allowed_final_statuses:
-            return False
-        for column in category_columns:
-            if not row.get(column, "").strip():
-                return False
-        for value in row.values():
-            normalized = value.strip().lower()
-            if any(marker in normalized for marker in incomplete_markers):
-                return False
-
-    openapi_file = _discover_openapi_file(project_root)
-    if openapi_file:
-        operations = _extract_openapi_operations(_read_text(openapi_file))
-        matrix_operations, _matrix_path_only = _extract_matrix_operations(rows)
-        for method, path in operations:
-            if (method, path) not in matrix_operations:
-                return False
-
-    gate_section = _extract_report_section(report_text,
-                                           "## Boundary Completion Gate")
-    if not gate_section:
-        return False
-    completion_gate_passed = False
-    boundary_missing_seen = False
-    happy_path_only_seen = False
-    for raw_line in gate_section.splitlines():
-        line = raw_line.strip()
-        match = re.match(r"-?\s*(Boundary-missing|Happy-path-only):\s*(\d+)\s*$",
-                         line, re.IGNORECASE)
-        if match:
-            if match.group(1).lower() == "boundary-missing":
-                boundary_missing_seen = True
-            if match.group(1).lower() == "happy-path-only":
-                happy_path_only_seen = True
-            if int(match.group(2)) > 0:
-                return False
-        if re.match(r"-?\s*Completion gate passed:\s*yes\s*$",
-                    line, re.IGNORECASE):
-            completion_gate_passed = True
-        if re.match(r"-?\s*Completion gate passed:\s*no\b",
-                    line, re.IGNORECASE):
-            return False
-    if not (completion_gate_passed and boundary_missing_seen and
-            happy_path_only_seen):
-        return False
-
-    validation_section = _extract_report_section(report_text,
-                                                 "## Boundary Validation")
-    if not validation_section:
-        return False
-    validator_result = ""
-    for raw_line in validation_section.splitlines():
-        line = raw_line.strip()
-        match = re.match(r"-?\s*Validator result:\s*(\S+)",
-                         line, re.IGNORECASE)
-        if match:
-            validator_result = match.group(1).strip().lower()
-            break
-
-    return validator_result == "passed"
-
-
-def _extract_scope_list(report_text, list_name):
-    """Extract a nested file list from the report Scope section."""
-    in_scope = False
-    in_list = False
-    list_marker = "- {}:".format(list_name)
-    values = []
-    for raw_line in report_text.splitlines():
-        line = raw_line.strip()
-        if line == "## Scope":
-            in_scope = True
-            continue
-        if in_scope and line.startswith("## "):
-            break
-        if not in_scope:
-            continue
-        if line == list_marker:
-            in_list = True
-            continue
-        if in_list:
-            if raw_line.startswith("  -") or raw_line.startswith("\t-"):
-                value = line[2:].strip().strip("`")
-                if value and value not in {"{...}", "..."}:
-                    values.append(value)
-                continue
-            if line.startswith("- "):
-                break
-    return values
-
-
-def _scoped_report_fresh(project_root, pointer_artifact, report_path, report_text):
-    """Return whether the report is newer than the gate marker and in-scope files."""
-    marker_path = os.path.join(
-        project_root,
-        os.path.dirname(pointer_artifact),
-        ".prizmkit-test-started",
-    )
-    if not os.path.exists(marker_path):
-        return False
-
-    try:
-        report_mtime = os.path.getmtime(report_path)
-        marker_mtime = os.path.getmtime(marker_path)
-    except OSError:
-        return False
-
-    if report_mtime < marker_mtime:
-        return False
-
-    project_root_real = os.path.realpath(project_root)
-    source_files = _extract_scope_list(report_text, "In-Scope Source Files")
-    test_files = _extract_scope_list(report_text, "In-Scope Test Files")
-    if not source_files or not test_files:
-        return False
-
-    ignored = {"none", "n/a", "not applicable", "(none)", "{...}", "..."}
-    for listed_file in source_files + test_files:
-        normalized = listed_file.strip().strip("`")
-        if not normalized or normalized.lower() in ignored:
-            return False
-        candidate = (normalized if os.path.isabs(normalized)
-                     else os.path.join(project_root, normalized))
-        candidate_real = os.path.realpath(candidate)
-        try:
-            if os.path.commonpath([project_root_real, candidate_real]) != project_root_real:
-                return False
-        except ValueError:
-            return False
-        if not os.path.isfile(candidate_real):
-            return False
-        if os.path.getmtime(candidate_real) > report_mtime:
-            return False
-
-    return True
-
-
-def _validate_scoped_test_report(project_root, artifacts):
-    """Validate the feature prizmkit-test pointer and scoped PASS report."""
-    pointer_artifacts = [a for a in artifacts
-                         if a.endswith("/test-report-path.txt")]
-    if not pointer_artifacts:
-        return False
-
-    pointer_artifact = pointer_artifacts[0]
-    pointer_path = os.path.join(project_root, pointer_artifact)
-    pointed_report = _read_text(pointer_path).strip().splitlines()
-    if not pointed_report:
-        return False
-
-    report_path = pointed_report[0].strip()
-    if not os.path.isabs(report_path):
-        report_path = os.path.join(project_root, report_path)
-    if not os.path.exists(report_path):
-        return False
-    if not _report_path_matches_artifacts(project_root, report_path, artifacts):
-        return False
-
-    report_text = _read_text(report_path)
-    mode = _extract_scope_field(report_text, "Mode")
-    artifact_dir = _extract_scope_field(report_text, "Artifact Dir")
-    verdict = _extract_report_verdict(report_text)
-
-    expected_artifact_dir = _normalize_artifact_dir(
-        os.path.dirname(pointer_artifact)
-    )
-    actual_artifact_dir = _normalize_artifact_dir(artifact_dir)
-
-    return (mode == "this-change" and
-            actual_artifact_dir == expected_artifact_dir and
-            verdict == "PASS" and
-            _boundary_report_sections_valid(project_root, report_text) and
-            _scoped_report_fresh(project_root, pointer_artifact,
-                                 report_path, report_text))
-
-
-def _completed_step_artifacts_valid(project_root, skill_key, artifacts):
-    """Return whether a completed checkpoint step can be preserved."""
-    if not all(_artifact_exists(project_root, a) for a in artifacts):
-        return False
-    if skill_key == "prizmkit-test":
-        return _validate_scoped_test_report(project_root, artifacts)
-    return True
-
-
-def generate_checkpoint_definition(sections, pipeline_mode, workflow_type,
-                                   item_id, item_slug, session_id,
-                                   init_done=False):
-    """Derive checkpoint step definitions from the assembled sections list.
-
-    Args:
-        sections: list of (name, content) tuples from assemble_sections()
-        pipeline_mode: "lite" | "standard" | "full"
-        workflow_type: "feature-pipeline"
-        item_id: feature ID (e.g. "F-001")
-        item_slug: feature slug (e.g. "001-user-auth")
-        session_id: current session ID
-        init_done: whether project is already initialized (Phase 0 skip)
-
-    Returns:
-        dict suitable for writing as workflow-checkpoint.json
-    """
-    steps = []
-    step_counter = 1
-    prev_step_id = None
-
-    for section_name, _content in sections:
-        if section_name not in SECTION_TO_SKILL:
-            continue
-
-        mapping = SECTION_TO_SKILL[section_name]
-
-        if mapping is None:
-            # phase-commit -> split into retrospective + committer
-            for skill, name, artifacts in _COMMIT_STEPS:
-                step_id = "S{:02d}".format(step_counter)
-                steps.append({
-                    "id": step_id,
-                    "skill": skill,
-                    "name": name,
-                    "status": "pending",
-                    "required_artifacts": _resolve_artifacts(artifacts, item_slug),
-                    "depends_on": prev_step_id,
-                })
-                prev_step_id = step_id
-                step_counter += 1
-            continue
-
-        skill, name, artifacts = mapping
-        step_id = "S{:02d}".format(step_counter)
-
-        status = "pending"
-        if init_done and section_name in ("phase0-init", "phase0-test-baseline"):
-            status = "skipped"
-
-        steps.append({
-            "id": step_id,
-            "skill": skill,
-            "name": name,
-            "status": status,
-            "required_artifacts": _resolve_artifacts(artifacts, item_slug),
-            "depends_on": prev_step_id,
-        })
-
-        prev_step_id = step_id
-        step_counter += 1
-
-    return {
-        "version": 1,
-        "workflow_type": workflow_type,
-        "pipeline_mode": pipeline_mode,
-        "item_id": item_id,
-        "item_slug": item_slug,
-        "session_id": session_id,
-        "steps": steps,
-    }
-
-
-def merge_checkpoint_state(existing, fresh, project_root):
-    """Merge existing checkpoint state into a freshly generated definition.
-
-    Matching is by skill_key (not step ID), since tier changes across retries
-    may shift step IDs.
-
-    Merge rules:
-    1. Only keep completed steps whose required_artifacts all exist on disk
-    2. Keep skipped steps unconditionally
-    3. Once a step is NOT completed/skipped, break the dependency chain:
-       all subsequent steps reset to pending
-    """
-    existing_status = {}
-    existing_artifacts = {}
-    fresh_artifacts = {step["skill"]: step.get("required_artifacts", [])
-                       for step in fresh.get("steps", [])}
-    for step in existing.get("steps", []):
-        existing_status[step["skill"]] = step["status"]
-        existing_artifacts[step["skill"]] = step.get("required_artifacts", [])
-
-    # Determine which completed steps have valid artifacts. Prefer the freshly
-    # generated artifact contract so newly added gates invalidate older
-    # checkpoint entries that only satisfied a weaker contract.
-    valid_completed = set()
-    for skill_key, status in existing_status.items():
-        if status == "completed":
-            artifacts = fresh_artifacts.get(
-                skill_key, existing_artifacts.get(skill_key, [])
-            )
-            if _completed_step_artifacts_valid(project_root,
-                                               skill_key,
-                                               artifacts):
-                valid_completed.add(skill_key)
-            else:
-                LOGGER.warning(
-                    "Step '%s' was completed but artifacts missing — "
-                    "resetting to pending", skill_key
-                )
-        elif status == "skipped":
-            valid_completed.add(skill_key)
-
-    # Apply to fresh steps; break chain on first non-valid step
-    chain_broken = False
-    for step in fresh["steps"]:
-        if chain_broken:
-            step["status"] = "pending"
-            continue
-
-        prev = existing_status.get(step["skill"])
-        if step["skill"] in valid_completed:
-            step["status"] = prev  # completed or skipped
-        else:
-            chain_broken = True
-            step["status"] = "pending"
-
-    return fresh
-
-
-# ============================================================
-# Section Assembly (new modular approach)
-# ============================================================
-
-
-def load_section(sections_dir, name):
-    """Load a section file from the sections directory.
-
-    Returns the file content as a string, or raises FileNotFoundError.
-    """
-    path = os.path.join(sections_dir, name)
-    if not os.path.isfile(path):
-        raise FileNotFoundError("Section file not found: {}".format(path))
-    with open(path, "r", encoding="utf-8") as f:
-        return f.read()
-
-
-def load_agent_prompts(templates_dir):
-    """Load agent prompt templates from agent-prompts/ directory.
-
-    Returns a dict of {{AGENT_PROMPT_XXX}} -> prompt content replacements.
-    If the directory does not exist, returns an empty dict (backward compat).
-    """
-    agent_prompts_dir = os.path.join(templates_dir, "agent-prompts")
-    if not os.path.isdir(agent_prompts_dir):
-        LOGGER.debug("No agent-prompts/ directory found, skipping")
-        return {}
-
-    # Map filename -> placeholder name
-    # e.g. dev-implement.md -> {{AGENT_PROMPT_DEV_IMPLEMENT}}
-    prompt_map = {}
-    for filename in sorted(os.listdir(agent_prompts_dir)):
-        if not filename.endswith(".md"):
-            continue
-        stem = filename[:-3]  # remove .md
-        placeholder = "{{{{AGENT_PROMPT_{}}}}}".format(
-            stem.upper().replace("-", "_")
-        )
-        filepath = os.path.join(agent_prompts_dir, filename)
-        try:
-            with open(filepath, "r", encoding="utf-8") as f:
-                prompt_map[placeholder] = f.read().strip()
-            LOGGER.debug("Loaded agent prompt: %s -> %s", filename, placeholder)
-        except IOError as exc:
-            LOGGER.warning("Failed to load agent prompt %s: %s", filename, exc)
-
-    return prompt_map
-
-
-def _tier_header(pipeline_mode):
-    """Return the tier-specific header and mission description."""
-    headers = {
-        "lite": (
-            "# Dev-Pipeline Session Bootstrap — Tier 1 (Single Agent)\n",
-            "**Tier 1 — Single Agent**: You handle everything directly. "
-            "No normal work subagents. No TeamCreate.\n",
-        ),
-        "standard": (
-            "# Dev-Pipeline Session Bootstrap — Tier 2 (Dual Agent)\n",
-            "**Tier 2 — Dual Agent**: You handle context + planning "
-            "directly. Then spawn Dev and Reviewer subagents. Spawn Dev "
-            "and Reviewer agents via the Agent tool.\n",
-        ),
-        "full": (
-            "# Dev-Pipeline Session Bootstrap — Tier 3 (Full Team)\n",
-            "**Tier 3 — Full Team**: For complex features, use the full "
-            "pipeline with Dev + Reviewer agents spawned via the Agent "
-            "tool.\n",
-        ),
-    }
-    return headers.get(pipeline_mode, headers["lite"])
-
-
-def _tier_reminders(pipeline_mode, critic_enabled=False):
-    """Return tier-specific reminder text."""
-    common = [
-        "- MANDATORY skills: `/prizmkit-retrospective`, `/prizmkit-committer` "
-        "— never skip these",
-        "- Build context-snapshot.md FIRST; use it throughout instead of "
-        "re-reading files",
-        "- `/prizmkit-committer` is mandatory — do NOT skip the commit phase, "
-        "and do NOT replace it with manual git commit commands",
-        "- Do NOT run `git add`/`git commit` during implementation phases — "
-        "all changes are committed once in the commit phase",
-        "- If any files remain after the commit, amend the existing commit — "
-        "do NOT create a follow-up commit",
-        "- When staging files, always use explicit file names — NEVER use "
-        "`git add -A` or `git add .`",
-    ]
-
-    if pipeline_mode == "lite":
-        specific = [
-            "- Tier 1: you handle everything directly — no normal work "
-            "subagents needed",
-        ]
-    elif pipeline_mode == "standard":
-        specific = [
-            "- Tier 2: orchestrator builds context+plan, Analyzer checks "
-            "consistency, Dev implements, Reviewer reviews+tests — use "
-            "direct Agent spawn for agents",
-            "- context-snapshot.md is append-only: orchestrator writes "
-            "Sections 1-4, Dev appends Implementation Log, Reviewer "
-            "appends Review Notes",
-            "- Gate checks enforce Implementation Log and Review Notes are "
-            "written before proceeding",
-            "- Do NOT use `run_in_background=true` when spawning normal work "
-            "subagents",
-            "- On timeout: check snapshot + git diff HEAD → model:lite → "
-            "remaining steps only → max 2 retries per phase → "
-            "orchestrator fallback",
-        ]
-    else:  # full
-        specific = [
-            "- Tier 3: full team — Dev (implementation) → Reviewer "
-            "(review + test) — spawn agents directly via Agent tool",
-            "- context-snapshot.md is append-only: orchestrator writes "
-            "Sections 1-4, Dev appends Implementation Log, Reviewer "
-            "appends Review Notes",
-            "- Gate checks enforce Implementation Log and Review Notes are "
-            "written before proceeding",
-            "- Do NOT use `run_in_background=true` when spawning normal work "
-            "agents",
-            "- On timeout: check snapshot → model:lite → remaining steps "
-            "only → max 2 retries → orchestrator fallback",
-        ]
-
-    lines = ["## Reminders\n"] + specific + common
-    return "\n".join(lines) + "\n"
-
-
-def assemble_sections(pipeline_mode, sections_dir, init_done, is_resume,
-                      critic_enabled, browser_enabled, retry_count=0,
-                      browser_tool="auto"):
-    """Assemble prompt sections based on tier and conditions.
-
-    Uses Python code for conditional logic instead of regex-based
-    template blocks. Each section is loaded from a separate .md file.
-
-    Returns a list of (section_name, content) tuples in order.
-    """
-    sections = []
-
-    # --- Header ---
-    title, tier_desc = _tier_header(pipeline_mode)
-    sections.append(("header", title))
-
-    # --- Session Context ---
-    sections.append(("session-context",
-                      load_section(sections_dir, "session-context.md")))
-
-    # --- Mission ---
-    mission = (
-        "## Your Mission\n\n"
-        "You are the **session orchestrator**. Implement Feature "
-        "{{FEATURE_ID}}: \"{{FEATURE_TITLE}}\".\n\n"
-        "**CRITICAL**: You MUST NOT exit until ALL work is complete "
-        "and committed."
-    )
-    if pipeline_mode != "lite":
-        mission += (
-            " When you spawn normal work subagents, wait for each to finish "
-            "(run_in_background=false)."
-        )
-    if pipeline_mode == "full":
-        mission += (
-            " Do NOT spawn work agents in background and exit — "
-            "that kills the session."
-        )
-    mission += "\n\n" + tier_desc
-    sections.append(("mission", mission))
-
-    # --- Task Contract: single source of current scope and gates ---
-    sections.append(("task-contract",
-                      load_section(sections_dir, "task-contract.md")))
-
-    # --- Feature Context (XML-wrapped, optimization 3) ---
-    sections.append(("feature-context",
-                      load_section(sections_dir, "feature-context.md")))
-
-    # --- Context Budget Rules ---
-    sections.append(("context-budget-rules",
-                      load_section(sections_dir, "context-budget-rules.md")))
-
-    # --- Log Size Awareness (only disabled when MAX_LOG_SIZE is explicitly 0) ---
-    max_log_size = _parse_non_negative_int_env("MAX_LOG_SIZE", DEFAULT_MAX_LOG_SIZE)
-    if max_log_size != 0 and os.path.isfile(os.path.join(sections_dir, "log-size-awareness.md")):
-        sections.append(("log-size-awareness",
-                          load_section(sections_dir, "log-size-awareness.md")))
-
-    # --- Directory Convention (tier-specific) ---
-    if pipeline_mode == "lite":
-        dc_file = "directory-convention-lite.md"
-    elif pipeline_mode == "standard":
-        dc_file = "directory-convention-agent.md"
-    else:
-        dc_file = "directory-convention-full.md"
-    sections.append(("directory-convention",
-                      load_section(sections_dir, dc_file)))
-
-    # --- Subagent Timeout Recovery (only for agent tiers) ---
-    if pipeline_mode in ("standard", "full"):
-        sections.append(("timeout-recovery",
-                          load_section(sections_dir,
-                                       "subagent-timeout-recovery.md")))
-
-    # --- Checkpoint System ---
-    checkpoint_section_path = os.path.join(sections_dir, "checkpoint-system.md")
-    if os.path.isfile(checkpoint_section_path):
-        sections.append(("checkpoint-system",
-                          load_section(sections_dir, "checkpoint-system.md")))
-
-    # --- Execution header ---
-    sections.append(("execution-header", "---\n\n## Execution\n"))
-
-    # --- Phase 0: Init or Test Baseline ---
-    if not init_done:
-        sections.append(("phase0-init",
-                          load_section(sections_dir, "phase0-init.md")))
-    else:
-        if pipeline_mode in ("standard", "full"):
-            sections.append(("phase0-test-baseline",
-                              load_section(sections_dir,
-                                           "phase0-test-baseline.md")))
-        else:
-            sections.append(("phase0-skip",
-                              "### Phase 0: SKIP (already initialized)\n"))
-
-    # --- Context Snapshot + Plan (tier-dependent) ---
-    if pipeline_mode == "full":
-        # Tier 3: full specify + plan workflow
-        sections.append(("phase-specify-plan",
-                          load_section(sections_dir,
-                                       "phase-specify-plan-full.md")))
-    else:
-        # Tier 1 & 2: separate context snapshot + plan
-        snapshot_base = load_section(sections_dir,
-                                     "phase-context-snapshot-base.md")
-        if pipeline_mode == "lite":
-            snapshot_suffix = load_section(
-                sections_dir, "phase-context-snapshot-lite-suffix.md")
-        else:
-            snapshot_suffix = load_section(
-                sections_dir, "phase-context-snapshot-agent-suffix.md")
-        sections.append(("phase-context-snapshot",
-                          snapshot_base + "\n" + snapshot_suffix))
-
-        if pipeline_mode == "lite":
-            sections.append(("phase-plan",
-                              load_section(sections_dir,
-                                           "phase-plan-lite.md")))
-        else:
-            sections.append(("phase-plan",
-                              load_section(sections_dir,
-                                           "phase-plan-agent.md")))
-
-    # --- Critic: Plan Challenge (only if critic enabled) ---
-    if critic_enabled:
-        if pipeline_mode == "full":
-            sections.append(("phase-critic-plan",
-                              load_section(sections_dir,
-                                           "phase-critic-plan-full.md")))
-        else:
-            sections.append(("phase-critic-plan",
-                              load_section(sections_dir,
-                                           "phase-critic-plan.md")))
-
-    # --- Implement (tier-dependent) ---
-    if pipeline_mode == "lite":
-        sections.append(("phase-implement",
-                          load_section(sections_dir,
-                                       "phase-implement-lite.md")))
-    elif pipeline_mode == "full":
-        sections.append(("phase-implement",
-                          load_section(sections_dir,
-                                       "phase-implement-full.md")))
-    else:
-        sections.append(("phase-implement",
-                          load_section(sections_dir,
-                                       "phase-implement-agent.md")))
-
-    # --- Test Failure Recovery Protocol (tier-specific) ---
-    if pipeline_mode == "lite":
-        sections.append(("test-failure-recovery",
-                          load_section(sections_dir,
-                                       "test-failure-recovery-lite.md")))
-    else:
-        sections.append(("test-failure-recovery",
-                          load_section(sections_dir,
-                                       "test-failure-recovery-agent.md")))
-
-    # --- Scoped Feature Test Gate ---
-    sections.append(("phase-prizmkit-test",
-                      load_section(sections_dir,
-                                   "phase-prizmkit-test.md")))
-
-    # Verification Gates are included in Task Contract. Keep AC in one place so
-    # background context and implementation prompts cannot redefine scope.
-    # --- Review (only for agent tiers) ---
-    if pipeline_mode == "full":
-        sections.append(("phase-review",
-                          load_section(sections_dir,
-                                       "phase-review-full.md")))
-    elif pipeline_mode == "standard":
-        sections.append(("phase-review",
-                          load_section(sections_dir,
-                                       "phase-review-agent.md")))
-
-    # --- Browser Verification (conditional, tool-aware) ---
-    if browser_enabled:
-        if browser_tool == "opencli":
-            browser_section_file = "phase-browser-verification-opencli.md"
-        elif browser_tool == "playwright-cli":
-            browser_section_file = "phase-browser-verification.md"
-        else:
-            # "auto" or unknown → let AI choose at runtime
-            browser_section_file = "phase-browser-verification-auto.md"
-        sections.append(("phase-browser",
-                          load_section(sections_dir,
-                                       browser_section_file)))
-
-    # --- Commit (tier-dependent) ---
-    if pipeline_mode == "full":
-        sections.append(("phase-commit",
-                          load_section(sections_dir,
-                                       "phase-commit-full.md")))
-    else:
-        sections.append(("phase-commit",
-                          load_section(sections_dir,
-                                       "phase-commit.md")))
-
-    # --- Critical Paths ---
-    if pipeline_mode == "lite":
-        cp_file = "critical-paths-lite.md"
-    elif pipeline_mode == "full":
-        cp_file = "critical-paths-full.md"
-    else:
-        cp_file = "critical-paths-agent.md"
-    sections.append(("critical-paths",
-                      load_section(sections_dir, cp_file)))
-
-    # --- Failure Capture ---
-    sections.append(("failure-capture",
-                      load_section(sections_dir, "failure-capture.md")))
-
-    # --- Reminders ---
-    sections.append(("reminders",
-                      _tier_reminders(pipeline_mode, critic_enabled)))
-
-    return sections
-
-
-def render_from_sections(sections, replacements):
-    """Join assembled sections and replace all {{PLACEHOLDER}} variables.
-
-    No regex-based conditional block processing needed — all conditions
-    were resolved during assembly.
-    """
-    content = "\n".join(text for _, text in sections)
-
-    # Replace all placeholders — run twice to handle agent prompt templates
-    # that contain their own {{PLACEHOLDER}} variables.  First pass injects
-    # agent prompt content (e.g. {{AGENT_PROMPT_DEV_IMPLEMENT}} expands to a
-    # block containing {{FEATURE_ID}}).  Second pass replaces the inner vars.
-    for _pass in range(2):
-        for placeholder, value in replacements.items():
-            content = content.replace(placeholder, value)
-
-    return content
-
-
-# ============================================================
-# Rendered output validation (optimization 7)
-# ============================================================
-
-
-def validate_rendered(content):
-    """Validate rendered prompt content for completeness.
-
-    Checks:
-    1. No unreplaced {{PLACEHOLDER}} variables remain
-    2. No unclosed conditional blocks (legacy {{IF_xxx}} tags)
-    3. Required sections present
-
-    Returns (is_valid, warnings, errors) tuple.
-    """
-    warnings = []
-    errors = []
-
-    # Check for unreplaced placeholders (excluding code blocks that may
-    # contain literal double braces like Jinja or Go templates)
-    unreplaced = re.findall(r"\{\{[A-Z][A-Z_0-9]+\}\}", content)
-    if unreplaced:
-        # Deduplicate
-        unique = sorted(set(unreplaced))
-        warnings.append(
-            "Unreplaced placeholders: {}".format(", ".join(unique))
-        )
-
-    # Check for unclosed conditional blocks (legacy)
-    unclosed_if = re.findall(
-        r"\{\{(?:IF|END_IF)_[A-Z_]+\}\}", content
-    )
-    if unclosed_if:
-        unique = sorted(set(unclosed_if))
-        errors.append(
-            "Unclosed conditional blocks: {}".format(", ".join(unique))
-        )
-
-    # Check required sections exist
-    required_markers = [
-        ("## Your Mission", "Mission section"),
-        ("## Execution", "Execution section"),
-        ("## Failure Capture", "Failure Capture Protocol"),
-    ]
-    for marker, label in required_markers:
-        if marker not in content:
-            errors.append("Missing required section: {}".format(label))
-
-    is_valid = len(errors) == 0
-
-    # Log results
-    for w in warnings:
-        LOGGER.warning("VALIDATE: %s", w)
-    for e in errors:
-        LOGGER.error("VALIDATE: %s", e)
-
-    return is_valid, warnings, errors
-
-
-def build_replacements(args, feature, features, global_context, script_dir):
-    """Build the full dict of placeholder -> replacement value."""
-    project_root = resolve_project_root(script_dir)
-
-    # Resolve paths - platform-aware agent/team resolution
-    platform = os.environ.get("PRIZMKIT_PLATFORM", "")
-    home_dir = os.path.expanduser("~")
-
-    # Auto-detect platform if not set
-    if not platform:
-        has_codex = os.path.isdir(os.path.join(project_root, ".codex", "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_codex:
-            platform = "codex"
-        elif has_claude:
-            platform = "claude"
-        elif has_codebuddy:
-            platform = "codebuddy"
-        else:
-            raise RuntimeError(
-                "PrizmKit agents not found. None of .codex/agents/, .claude/agents/, or .codebuddy/agents/ exists. "
-                "Run `npx prizmkit install` first, or set PRIZMKIT_PLATFORM=codex|claude|codebuddy explicitly."
-            )
-
-    if platform == "claude":
-        # Claude Code: agents in .claude/agents/, no native team config
-        agents_dir = os.path.join(project_root, ".claude", "agents")
-        team_config_path = os.path.join(
-            project_root, ".claude", "team-info.json",
-        )
-    elif platform == "codex":
-        # Codex: agents and team metadata are project-local references.
-        agents_dir = os.path.join(project_root, ".codex", "agents")
-        team_config_path = os.path.join(
-            project_root, ".codex", "team-info.json",
-        )
-    else:
-        # CodeBuddy: agents in .codebuddy/agents/, team in ~/.codebuddy/teams/
-        agents_dir = os.path.join(project_root, ".codebuddy", "agents")
-        team_config_path = os.path.join(
-            home_dir, ".codebuddy", "teams", "prizm-dev-team", "config.json",
-        )
-
-    # Agent definitions are native .toml for Codex and .md for Claude/CodeBuddy.
-    agent_ext = ".toml" if platform == "codex" else ".md"
-    dev_subagent = os.path.join(
-        agents_dir, f"prizm-dev-team-dev{agent_ext}",
-    )
-    reviewer_subagent = os.path.join(
-        agents_dir, f"prizm-dev-team-reviewer{agent_ext}",
-    )
-    critic_subagent = os.path.join(
-        agents_dir, f"prizm-dev-team-critic{agent_ext}",
-    )
-
-    # Verify agent files actually exist — missing files cause confusing
-    # errors when the AI session tries to read them later.
-    for agent_path, agent_name in [
-        (dev_subagent, "dev agent"),
-        (reviewer_subagent, "reviewer agent"),
-    ]:
-        if not os.path.isfile(agent_path):
-            LOGGER.warning(
-                "Agent file not found: %s (%s). "
-                "Subagent spawning may fail. "
-                "Run `npx prizmkit install` to reinstall agent definitions.",
-                agent_path, agent_name,
-            )
-    # Validator scripts - check if they exist in .codebuddy/scripts/, otherwise use .prizmkit/dev-pipeline/scripts/
-    validator_scripts_dir = os.path.join(project_root, ".prizmkit", "dev-pipeline", "scripts")
-    init_script_path = os.path.join(validator_scripts_dir, "init-dev-team.py")
-
-    # Session status path (relative to project root)
-    session_status_path = os.path.join(
-        ".prizmkit", "state", "features", args.feature_id,
-        "sessions", args.session_id, "session-status.json",
-    )
-    # Make it absolute from project root
-    session_status_abs = os.path.join(project_root, session_status_path)
-
-    # Compute feature slug for per-feature directory naming
-    feature_slug = compute_feature_slug(
-        args.feature_id, feature.get("title", "")
-    )
-
-    # Detect project state
-    init_done = detect_init_status(project_root)
-    artifacts = detect_existing_artifacts(project_root, feature_slug)
-    complexity = feature.get(
-        "estimated_complexity",
-        feature.get("complexity", "medium"),
-    )
-    if args.mode:
-        pipeline_mode = args.mode
-    else:
-        pipeline_mode = determine_pipeline_mode(complexity)
-
-    # Auto-detect resume: if all planning artifacts exist and resume_phase
-    # is "null" (fresh start), skip to Phase 6
-    effective_resume = args.resume_phase
-    if effective_resume == "null" and artifacts["all_complete"]:
-        effective_resume = "6"
-
-    # Determine critic enablement (priority: CLI > env > feature field > default)
-    critic_env = os.environ.get("ENABLE_CRITIC", "").lower()
-    if args.critic is not None:
-        critic_enabled = args.critic == "true"
-    elif critic_env in ("true", "1"):
-        critic_enabled = True
-    elif critic_env in ("false", "0"):
-        critic_enabled = False
-    else:
-        critic_enabled = bool(feature.get("critic", False))
-
-    # Determine critic count (from feature field, default 1)
-    # Multi-critic voting (3) must be explicitly set by the user in .prizmkit/plans/feature-list.json
-    critic_count = feature.get("critic_count", 1)
-
-    # Guard: if critic enabled but agent file missing, force disable and warn
-    if critic_enabled and not os.path.isfile(critic_subagent):
-        LOGGER.warning(
-            "Critic enabled but agent file not found: %s. "
-            "Critic phases will be SKIPPED. "
-            "Run `npx prizmkit install` to install agent definitions.",
-            critic_subagent,
-        )
-        critic_enabled = False
-
-    # Guard: if critic enabled but tier doesn't support it (lite), warn and disable
-    if critic_enabled and pipeline_mode == "lite":
-        LOGGER.warning(
-            "Critic enabled for feature %s but pipeline_mode='lite' (tier1) "
-            "does not support critic phases. Critic will be SKIPPED. "
-            "Use estimated_complexity='high' or pass --mode standard/full.",
-            args.feature_id,
-        )
-        critic_enabled = False
-
-    # Browser interaction - extract from feature if present
-    browser_interaction = feature.get("browser_interaction")
-    browser_enabled = False
-    browser_verify_steps = ""
-    browser_tool = "auto"  # default: AI chooses at runtime
-
-    browser_verify_env = os.environ.get("BROWSER_VERIFY", "").lower()
-    if browser_verify_env == "false":
-        browser_interaction = None
-
-    if browser_interaction and isinstance(browser_interaction, bool):
-        # Simple boolean: browser verification enabled, no specific goals
-        browser_enabled = True
-        browser_tool = "auto"
-        browser_verify_steps = (
-            "   # (no specific verify goals — explore the app and "
-            "verify the feature works as expected)")
-    elif browser_interaction and isinstance(browser_interaction, dict):
-        # Extract tool preference (playwright-cli / opencli / auto)
-        browser_tool = browser_interaction.get("tool", "auto")
-        if browser_tool not in ("playwright-cli", "opencli", "auto"):
-            LOGGER.warning(
-                "Unknown browser_interaction.tool '%s', defaulting to 'auto'",
-                browser_tool,
-            )
-            browser_tool = "auto"
-
-        # browser_interaction only needs verify_steps — AI auto-detects
-        # dev server command, URL, and port from project config
-        steps = browser_interaction.get("verify_steps", [])
-        if steps:
-            browser_enabled = True
-            browser_verify_steps = "\n".join(
-                "   # Goal {}: {}".format(i + 1, step)
-                for i, step in enumerate(steps)
-            )
-        elif browser_interaction.get("url") or browser_interaction.get("enabled", True):
-            # Backward compat: old format had url/setup_command fields
-            browser_enabled = True
-            browser_verify_steps = (
-                "   # (no specific verify goals — explore the app and "
-                "verify the feature works as expected)")
-
-    # Auto-detect test commands from project structure
-    test_commands = detect_test_command_list(project_root)
-    test_cmd = format_powershell_test_commands(test_commands)
-    if not test_cmd:
-        test_cmd = "(auto-detection found no standard test commands; manually specify TEST_CMD)"
-
-    # Optionally extract baseline failures from test execution
-    baseline_failures = ""
-    if args.extract_baselines:
-        baseline_test_commands = format_baseline_test_commands(test_commands)
-        if baseline_test_commands:
-            baseline_failures = extract_baseline_failures(baseline_test_commands, project_root)
-
-    # Extract coverage target from feature.testing field (new in v2)
-    coverage_target = "80"  # Default coverage target
-    testing_config = feature.get("testing", {})
-    if isinstance(testing_config, dict):
-        coverage_target = str(testing_config.get("coverage_target", 80))
-
-    # Detect dev server port from package.json
-    dev_port = "3000"  # Default fallback
-    try:
-        pkg_path = os.path.join(project_root, "package.json")
-        if os.path.isfile(pkg_path):
-            with open(pkg_path, "r", encoding="utf-8") as f:
-                pkg = json.load(f)
-            dev_script = pkg.get("scripts", {}).get("dev", "")
-            # Extract -p <port> from dev script
-            port_match = re.search(r"-p\s+(\d+)", dev_script)
-            if port_match:
-                dev_port = port_match.group(1)
-            else:
-                # Fallback: try NEXT_PUBLIC_SITE_URL from .env files
-                for env_file in [".env.local", ".env"]:
-                    env_path = os.path.join(project_root, env_file)
-                    if os.path.isfile(env_path):
-                        with open(env_path, "r", encoding="utf-8") as ef:
-                            for line in ef:
-                                m = re.match(
-                                    r"NEXT_PUBLIC_SITE_URL\s*=\s*.*?:([0-9]+)", line.strip()
-                                )
-                                if m:
-                                    dev_port = m.group(1)
-                                    break
-                        if dev_port != "3000":
-                            break
-    except Exception:
-        pass  # Keep default 3000 on any error
-    dev_url = f"http://localhost:{dev_port}"
-
-    max_log_size = _parse_non_negative_int_env("MAX_LOG_SIZE", DEFAULT_MAX_LOG_SIZE)
-
-    replacements = {
-        "{{LOG_SIZE_AWARENESS}}": load_log_size_section(script_dir),
-        "{{RUN_ID}}": args.run_id,
-        "{{SESSION_ID}}": args.session_id,
-        "{{FEATURE_ID}}": args.feature_id,
-        "{{FEATURE_LIST_PATH}}": os.path.abspath(args.feature_list),
-        "{{FEATURE_TITLE}}": feature.get("title", ""),
-        "{{FEATURE_DESCRIPTION}}": feature.get("description", ""),
-        "{{USER_CONTEXT}}": format_user_context(feature.get("user_context", [])),
-        "{{ACCEPTANCE_CRITERIA}}": format_acceptance_criteria(
-            feature.get("acceptance_criteria", [])
-        ),
-        "{{COMPLETED_DEPENDENCIES}}": get_completed_dependencies(
-            features, feature
-        ),
-        "{{GLOBAL_CONTEXT}}": format_global_context(global_context, project_root),
-        "{{PROJECT_BRIEF}}": _read_project_brief(project_root),
-        "{{PLATFORM_CONVENTIONS}}": read_platform_conventions(project_root),
-        "{{TEAM_CONFIG_PATH}}": team_config_path,
-        "{{DEV_SUBAGENT_PATH}}": dev_subagent,
-        "{{REVIEWER_SUBAGENT_PATH}}": reviewer_subagent,
-        "{{CRITIC_SUBAGENT_PATH}}": critic_subagent,
-        "{{INIT_SCRIPT_PATH}}": init_script_path,
-        "{{SESSION_STATUS_PATH}}": session_status_abs,
-        "{{PROJECT_ROOT}}": project_root,
-        "{{PIPELINE_DIR}}": ".prizmkit\\dev-pipeline",
-        "{{FEATURE_SLUG}}": feature_slug,
-        "{{CHECKPOINT_PATH}}": os.path.join(
-            ".prizmkit", "specs", feature_slug, "workflow-checkpoint.json",
-        ),
-        "{{PIPELINE_MODE}}": pipeline_mode,
-        "{{COMPLEXITY}}": complexity,
-        "{{CRITIC_ENABLED}}": "true" if critic_enabled else "false",
-        "{{CRITIC_COUNT}}": str(critic_count),
-        "{{INIT_DONE}}": "true" if init_done else "false",
-        "{{HAS_SPEC}}": "true" if artifacts["has_spec"] else "false",
-        "{{HAS_PLAN}}": "true" if artifacts["has_plan"] else "false",
-        "{{BROWSER_VERIFY_STEPS}}": browser_verify_steps,
-        "{{BROWSER_TOOL}}": browser_tool,
-        "{{AC_CHECKLIST}}": format_ac_checklist(
-            feature.get("acceptance_criteria", [])
-        ),
-        "{{TEST_CMD}}": test_cmd,
-        "{{BASELINE_FAILURES}}": baseline_failures,
-        "{{COVERAGE_TARGET}}": coverage_target,
-        "{{DEV_PORT}}": dev_port,
-        "{{DEV_URL}}": dev_url,
-        "{{MAX_LOG_SIZE}}": str(max_log_size),
-        "{{MAX_LOG_SIZE_HUMAN}}": _format_bytes(max_log_size),
-        "{{SESSION_LOG_PATH}}": os.path.join(
-            ".prizmkit", "state", "features", args.feature_id,
-            "sessions", args.session_id, "logs", "session.log",
-        ),
-    }
-
-    return replacements, effective_resume, browser_enabled, browser_tool
-
-
-def render_template(template_content, replacements, resume_phase,
-                    browser_enabled=False, browser_tool="auto"):
-    """Render the template by processing conditionals and replacing placeholders."""
-    # Step 1: Process fresh_start/resume conditional blocks
-    content = process_conditional_blocks(template_content, resume_phase)
-
-    # Step 2: Process mode, init, critic, and browser conditional blocks
-    pipeline_mode = replacements.get("{{PIPELINE_MODE}}", "standard")
-    init_done = replacements.get("{{INIT_DONE}}", "false") == "true"
-    critic_enabled = replacements.get("{{CRITIC_ENABLED}}", "false") == "true"
-    content = process_mode_blocks(content, pipeline_mode, init_done, critic_enabled,
-                                  browser_enabled, browser_tool)
-
-    # Step 3: Replace all {{PLACEHOLDER}} variables (two passes for nested
-    # agent prompt templates that may contain their own placeholders)
-    for _pass in range(2):
-        for placeholder, value in replacements.items():
-            content = content.replace(placeholder, value)
-
-    return content
-
-
-def write_output(output_path, content):
-    """Write the rendered content to the output file."""
-    abs_path = os.path.abspath(output_path)
-    output_dir = os.path.dirname(abs_path)
-    if output_dir and not os.path.isdir(output_dir):
-        try:
-            os.makedirs(output_dir, exist_ok=True)
-        except OSError as e:
-            return "Cannot create output directory: {}".format(str(e))
-    try:
-        with open(abs_path, "w", encoding="utf-8") as f:
-            f.write(content)
-    except IOError as e:
-        return "Cannot write output file: {}".format(str(e))
-    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()
-
-    # Resolve script directory
-    script_dir = os.path.dirname(os.path.abspath(__file__))
-    templates_dir = os.path.join(script_dir, "..", "templates")
-    sections_dir = os.path.join(templates_dir, "sections")
-
-    # Load feature list early (needed for both code paths)
-    feature_list_data, err = load_json_file(args.feature_list)
-    if err:
-        emit_failure("Feature list error: {}".format(err))
-
-    features = feature_list_data.get("features")
-    if not isinstance(features, list):
-        emit_failure("Feature list does not contain a 'features' array")
-
-    feature = find_feature(features, args.feature_id)
-    if feature is None:
-        emit_failure(
-            "Feature '{}' not found in feature list".format(args.feature_id)
-        )
-
-    global_context = feature_list_data.get("global_context", {})
-    if not isinstance(global_context, dict):
-        global_context = {}
-
-    # Build replacements (shared by both code paths)
-    replacements, effective_resume, browser_enabled, browser_tool = build_replacements(
-        args, feature, features, global_context, script_dir
-    )
-
-    # Load agent prompt templates and merge into replacements
-    agent_prompt_replacements = load_agent_prompts(templates_dir)
-    replacements.update(agent_prompt_replacements)
-
-    if is_continuation(args):
-        replacements["{{LOG_SIZE_AWARENESS}}"] = ""
-
-    # Extract state needed for assembly
-    pipeline_mode = replacements.get("{{PIPELINE_MODE}}", "lite")
-    init_done = replacements.get("{{INIT_DONE}}", "false") == "true"
-    is_resume = effective_resume != "null"
-    critic_enabled = replacements.get("{{CRITIC_ENABLED}}", "false") == "true"
-
-    # ── Choose rendering path ──────────────────────────────────────────
-    use_sections = os.path.isdir(sections_dir) and not args.template
-
-    if use_sections:
-        # New modular section assembly (code-level conditional logic)
-        LOGGER.info("Using section assembly from %s", sections_dir)
-        try:
-            sections = assemble_sections(
-                pipeline_mode, sections_dir, init_done, is_resume,
-                critic_enabled, browser_enabled,
-                retry_count=int(args.retry_count),
-                browser_tool=browser_tool,
-            )
-            if is_continuation(args):
-                sections = [
-                    (name, content) for name, content in sections
-                    if name != "log-size-awareness"
-                ]
-            rendered = render_from_sections(sections, replacements)
-        except FileNotFoundError as exc:
-            LOGGER.warning(
-                "Section assembly failed (%s), falling back to legacy "
-                "template", exc,
-            )
-            use_sections = False
-
-    if not use_sections:
-        # Legacy monolithic template path (backward compatible)
-        if args.template:
-            template_path = args.template
-        else:
-            complexity = feature.get(
-                "estimated_complexity",
-                feature.get("complexity", "medium"),
-            )
-            _mode = args.mode or determine_pipeline_mode(complexity)
-            _tier_file_map = {
-                "lite": "bootstrap-tier1.md",
-                "standard": "bootstrap-tier2.md",
-                "full": "bootstrap-tier3.md",
-            }
-            _tier_file = _tier_file_map.get(_mode, "bootstrap-tier2.md")
-            _tier_path = os.path.join(templates_dir, _tier_file)
-            if os.path.isfile(_tier_path):
-                template_path = _tier_path
-            else:
-                template_path = os.path.join(
-                    templates_dir, "bootstrap-prompt.md"
-                )
-
-        template_content, err = read_text_file(template_path)
-        if err:
-            emit_failure("Template error: {}".format(err))
-
-        rendered = render_template(
-            template_content, replacements, effective_resume, browser_enabled,
-            browser_tool
-        )
-
-    # ── Validate rendered output ───────────────────────────────────────
-    is_valid, warnings, errors = validate_rendered(rendered)
-    if not is_valid:
-        LOGGER.error(
-            "Rendered prompt failed validation: %s",
-            "; ".join(errors),
-        )
-        # Continue anyway — a partially valid prompt is better than none
-
-    # ── Write output ───────────────────────────────────────────────────
-    err = write_output(args.output, rendered)
-    if err:
-        emit_failure(err)
-
-    # ── Generate checkpoint file ──────────────────────────────────────
-    project_root = resolve_project_root(
-        os.path.dirname(os.path.abspath(__file__))
-    )
-    feature_slug = replacements.get("{{FEATURE_SLUG}}", "")
-    checkpoint_path = ""
-    checkpoint = {}
-
-    if not args.no_checkpoint and use_sections and feature_slug:
-        checkpoint = generate_checkpoint_definition(
-            sections=sections,
-            pipeline_mode=pipeline_mode,
-            workflow_type="feature-pipeline",
-            item_id=args.feature_id,
-            item_slug=feature_slug,
-            session_id=args.session_id,
-            init_done=init_done,
-        )
-
-        checkpoint_dir = os.path.join(
-            project_root, ".prizmkit", "specs", feature_slug,
-        )
-        os.makedirs(checkpoint_dir, exist_ok=True)
-        checkpoint_path = os.path.join(
-            checkpoint_dir, "workflow-checkpoint.json",
-        )
-
-        # On resume, merge existing completed state (with artifact validation)
-        if (is_resume or is_continuation(args)) and os.path.exists(checkpoint_path):
-            try:
-                with open(checkpoint_path, "r", encoding="utf-8") as f:
-                    existing = json.load(f)
-                checkpoint = merge_checkpoint_state(
-                    existing, checkpoint, project_root,
-                )
-                LOGGER.info("Merged existing checkpoint state from %s",
-                            checkpoint_path)
-            except (json.JSONDecodeError, KeyError) as exc:
-                LOGGER.warning(
-                    "Existing checkpoint corrupted (%s) — generating fresh",
-                    exc,
-                )
-
-        with open(checkpoint_path, "w", encoding="utf-8") as f:
-            json.dump(checkpoint, f, indent=2, ensure_ascii=False)
-        LOGGER.info("Wrote checkpoint to %s", checkpoint_path)
-
-    if is_continuation(args):
-        rendered = append_continuation_handoff(
-            rendered, args, project_root, args.task_type, args.feature_id,
-            feature_slug, checkpoint,
-        )
-        err = write_output(args.output, rendered)
-        if err:
-            emit_failure(err)
-
-    # ── Success JSON ───────────────────────────────────────────────────
-    feature_model = feature.get("model", "")
-    mode_agent_counts = {"lite": 1, "standard": 3, "full": 3}
-    agent_count = mode_agent_counts.get(pipeline_mode, 1)
-    critic_count_val = int(replacements.get("{{CRITIC_COUNT}}", "1"))
-    if critic_enabled:
-        agent_count += critic_count_val
-    output = {
-        "success": True,
-        "output_path": os.path.abspath(args.output),
-        "model": feature_model,
-        "pipeline_mode": pipeline_mode,
-        "agent_count": agent_count,
-        "critic_enabled": "true" if critic_enabled else "false",
-        "render_mode": "sections" if use_sections else "legacy",
-        "validation_warnings": len(warnings),
-        "validation_errors": len(errors),
-        "checkpoint_path": checkpoint_path,
-    }
-    print(json.dumps(output, indent=2, ensure_ascii=False))
-    sys.exit(0)
-
-
-if __name__ == "__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)))