prizmkit 1.1.96 → 1.1.97

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.1.96",
-  "bundledAt": "2026-07-02T18:48:14.022Z",
-  "bundledFrom": "42b5a94"
+  "frameworkVersion": "1.1.97",
+  "bundledAt": "2026-07-03T07:22:35.206Z",
+  "bundledFrom": "732b89b"
 }

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

@@ -23,6 +23,8 @@ set -euo pipefail
 #   HEARTBEAT_INTERVAL    Heartbeat log interval in seconds (default: 30)
 #   STALE_KILL_THRESHOLD   Auto-kill session after N seconds of no progress (default: 900)
 #   HEARTBEAT_STALE_THRESHOLD  Heartbeat stale threshold in seconds (default: 600)
+#   MAX_LOG_SIZE         Session log size threshold for compact warning (default: 2097152 = 2MB, set 0 to disable)
+#   LOG_MONITOR_POLL_INTERVAL  Log monitor poll interval in seconds (default: 30)
 #   DEV_BRANCH            Custom dev branch name (default: auto-generated bugfix/pipeline-{run_id})
 #   AUTO_PUSH             Auto-push to remote after successful bug fix (default: 0). Set to 1 to enable.
 #   STOP_ON_FAILURE       Stop pipeline after a task exhausts all retries (default: 0). Set to 1 to stop.
@@ -283,7 +285,7 @@ finalize_bug_status_after_branch_return() {
         --session-id "$session_id" \
         --max-retries "$max_retries" \
         --max-infra-retries "$max_infra_retries" \
-        --action update 2>&1) || {
+        --action update) || {
         log_error "Failed to update bug status: $update_output"
         update_output=""
     }
@@ -1227,6 +1229,8 @@ show_help() {
     echo "  VERBOSE               Set to 1 for verbose AI CLI output"
     echo "  HEARTBEAT_INTERVAL    Heartbeat log interval in seconds (default: 30)"
     echo "  STALE_KILL_THRESHOLD  Auto-kill session after N seconds of no progress (default: 900)"
+    echo "  MAX_LOG_SIZE          Session log size threshold for compact warning (default: 2097152 = 2MB, set 0 to disable)"
+    echo "  LOG_MONITOR_POLL_INTERVAL  Log monitor poll interval in seconds (default: 30)"
     echo "  STOP_ON_FAILURE       Stop pipeline when a task exhausts retries: 0|1 (default: 0)"
     echo ""
     echo "Examples:"

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

@@ -25,6 +25,8 @@ set -euo pipefail
 #   HEARTBEAT_INTERVAL    Heartbeat log interval in seconds (default: 30)
 #   STALE_KILL_THRESHOLD   Auto-kill session after N seconds of no progress (default: 900)
 #   HEARTBEAT_STALE_THRESHOLD  Heartbeat stale threshold in seconds (default: 600)
+#   MAX_LOG_SIZE         Session log size threshold for compact warning (default: 2097152 = 2MB, set 0 to disable)
+#   LOG_MONITOR_POLL_INTERVAL  Log monitor poll interval in seconds (default: 30)
 #   PIPELINE_MODE         Override mode for all features: lite|standard|full (used by daemon)
 #   DEV_BRANCH            Custom dev branch name (default: auto-generated dev/{feature_id}-YYYYMMDDHHmm)
 #   AUTO_PUSH             Auto-push to remote after successful feature (default: 0). Set to 1 to enable.
@@ -402,7 +404,7 @@ finalize_feature_status_after_branch_return() {
         --session-id "$session_id" \
         --max-retries "$max_retries" \
         --max-infra-retries "$max_infra_retries" \
-        --action update 2>&1) || {
+        --action update) || {
         log_error "Failed to update feature status: $update_output"
         log_error ".prizmkit/plans/feature-list.json may be out of sync. Manual intervention needed."
     }
@@ -1433,6 +1435,8 @@ show_help() {
     echo "  HEARTBEAT_INTERVAL    Heartbeat log interval in seconds (default: 30)"
     echo "  STALE_KILL_THRESHOLD  Auto-kill session after N seconds of no progress (default: 900)"
     echo "  HEARTBEAT_STALE_THRESHOLD  Heartbeat stale threshold in seconds (default: 600)"
+    echo "  MAX_LOG_SIZE          Session log size threshold for compact warning (default: 2097152 = 2MB, set 0 to disable)"
+    echo "  LOG_MONITOR_POLL_INTERVAL  Log monitor poll interval in seconds (default: 30)"
     echo "  PIPELINE_MODE         Override mode for all features: lite|standard|full"
     echo "  ENABLE_CRITIC         Enable critic review for all features: true|false"
     echo "  STOP_ON_FAILURE       Stop pipeline when a task exhausts retries: 0|1 (default: 0)"

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

@@ -23,6 +23,8 @@ set -euo pipefail
 #   HEARTBEAT_INTERVAL    Heartbeat log interval in seconds (default: 30)
 #   STALE_KILL_THRESHOLD   Auto-kill session after N seconds of no progress (default: 900)
 #   HEARTBEAT_STALE_THRESHOLD  Heartbeat stale threshold in seconds (default: 600)
+#   MAX_LOG_SIZE         Session log size threshold for compact warning (default: 2097152 = 2MB, set 0 to disable)
+#   LOG_MONITOR_POLL_INTERVAL  Log monitor poll interval in seconds (default: 30)
 #   DEV_BRANCH            Custom dev branch name (default: auto-generated refactor/pipeline-{run_id})
 #   AUTO_PUSH             Auto-push to remote after successful refactor (default: 0). Set to 1 to enable.
 #   STOP_ON_FAILURE       Stop pipeline after a task exhausts all retries (default: 0). Set to 1 to stop.
@@ -309,7 +311,7 @@ finalize_refactor_status_after_branch_return() {
         --session-id "$session_id" \
         --max-retries "$max_retries" \
         --max-infra-retries "$max_infra_retries" \
-        --action update 2>&1) || {
+        --action update) || {
         log_error "Failed to update refactor status: $update_output"
         update_output=""
     }
@@ -1261,6 +1263,8 @@ show_help() {
     echo "  STRICT_BEHAVIOR_CHECK    Force full test suite after each refactor (default: 1)"
     echo "  HEARTBEAT_INTERVAL       Heartbeat log interval in seconds (default: 30)"
     echo "  STALE_KILL_THRESHOLD     Auto-kill session after N seconds of no progress (default: 900)"
+    echo "  MAX_LOG_SIZE             Session log size threshold for compact warning (default: 2097152 = 2MB, set 0 to disable)"
+    echo "  LOG_MONITOR_POLL_INTERVAL  Log monitor poll interval in seconds (default: 30)"
     echo "  STOP_ON_FAILURE          Stop pipeline when a task exhausts retries: 0|1 (default: 0)"
     echo ""
     echo "Examples:"

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

@@ -31,6 +31,8 @@ from utils import enrich_global_context, load_json_file, read_platform_conventio
 
 
 DEFAULT_MAX_RETRIES = 3
+DEFAULT_MAX_LOG_SIZE = 2097152
+DEFAULT_LOG_MONITOR_POLL_INTERVAL = 30
 
 LOGGER = setup_logging("generate-bootstrap-prompt")
 
@@ -152,6 +154,54 @@ def compute_feature_slug(feature_id, title):
     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:
@@ -1272,7 +1322,8 @@ def _tier_header(pipeline_mode):
         "lite": (
             "# Dev-Pipeline Session Bootstrap — Tier 1 (Single Agent)\n",
             "**Tier 1 — Single Agent**: You handle everything directly. "
-            "No subagents, no TeamCreate.\n",
+            "No normal work subagents; the log-size monitor is the only "
+            "allowed persistent background subagent. No TeamCreate.\n",
         ),
         "standard": (
             "# Dev-Pipeline Session Bootstrap — Tier 2 (Dual Agent)\n",
@@ -1309,7 +1360,9 @@ def _tier_reminders(pipeline_mode, critic_enabled=False):
 
     if pipeline_mode == "lite":
         specific = [
-            "- Tier 1: you handle everything directly — no subagents needed",
+            "- Tier 1: you handle everything directly — no normal work "
+            "subagents needed; the log-size monitor is the only allowed "
+            "persistent background subagent",
         ]
     elif pipeline_mode == "standard":
         specific = [
@@ -1321,7 +1374,9 @@ def _tier_reminders(pipeline_mode, critic_enabled=False):
             "appends Review Notes",
             "- Gate checks enforce Implementation Log and Review Notes are "
             "written before proceeding",
-            "- Do NOT use `run_in_background=true` when spawning subagents",
+            "- Do NOT use `run_in_background=true` when spawning normal work "
+            "subagents; the log-size monitor is the only allowed persistent "
+            "background subagent",
             "- On timeout: check snapshot + git diff HEAD → model:lite → "
             "remaining steps only → max 2 retries per phase → "
             "orchestrator fallback",
@@ -1335,7 +1390,9 @@ def _tier_reminders(pipeline_mode, critic_enabled=False):
             "appends Review Notes",
             "- Gate checks enforce Implementation Log and Review Notes are "
             "written before proceeding",
-            "- Do NOT use `run_in_background=true` when spawning agents",
+            "- Do NOT use `run_in_background=true` when spawning normal work "
+            "agents; the log-size monitor is the only allowed persistent "
+            "background subagent",
             "- On timeout: check snapshot → model:lite → remaining steps "
             "only → max 2 retries → orchestrator fallback",
         ]
@@ -1374,12 +1431,13 @@ def assemble_sections(pipeline_mode, sections_dir, init_done, is_resume,
     )
     if pipeline_mode != "lite":
         mission += (
-            " When you spawn subagents, wait for each to finish "
-            "(run_in_background=false)."
+            " When you spawn normal work subagents, wait for each to finish "
+            "(run_in_background=false). The log-size monitor is the only "
+            "allowed persistent background subagent."
         )
     if pipeline_mode == "full":
         mission += (
-            " Do NOT spawn agents in background and exit — "
+            " Do NOT spawn work agents in background and exit — "
             "that kills the session."
         )
     mission += "\n\n" + tier_desc
@@ -1397,6 +1455,12 @@ def assemble_sections(pipeline_mode, sections_dir, init_done, is_resume,
     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"
@@ -1866,7 +1930,16 @@ def build_replacements(args, feature, features, global_context, script_dir):
         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)
+    if max_log_size == 0:
+        poll_interval = DEFAULT_LOG_MONITOR_POLL_INTERVAL
+    else:
+        poll_interval = _parse_positive_int_env(
+            "LOG_MONITOR_POLL_INTERVAL", DEFAULT_LOG_MONITOR_POLL_INTERVAL,
+        )
+
     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,
@@ -1911,6 +1984,24 @@ def build_replacements(args, feature, features, global_context, script_dir):
         "{{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),
+        "{{LOG_MONITOR_POLL_INTERVAL}}": str(poll_interval),
+        "{{LOG_MONITOR_STATUS_FILE}}": os.path.join(
+            ".prizmkit", "state", "features", args.feature_id,
+            "sessions", args.session_id, "logs", "log-monitor-status.txt",
+        ),
+        "{{LOG_MONITOR_BASELINE_FILE}}": os.path.join(
+            ".prizmkit", "state", "features", args.feature_id,
+            "sessions", args.session_id, "logs", "log-monitor-baseline.txt",
+        ),
+        "{{SESSION_LOG_PATH}}": os.path.join(
+            ".prizmkit", "state", "features", args.feature_id,
+            "sessions", args.session_id, "logs", "session.log",
+        ),
+        "{{LOG_MONITOR_SCRIPT}}": os.path.join(
+            ".prizmkit", "dev-pipeline", "scripts", "monitor-log.sh",
+        ),
     }
 
     return replacements, effective_resume, browser_enabled, browser_tool

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

@@ -23,6 +23,8 @@ from utils import enrich_global_context, load_json_file, read_platform_conventio
 
 
 DEFAULT_MAX_RETRIES = 3
+DEFAULT_MAX_LOG_SIZE = 2097152
+DEFAULT_LOG_MONITOR_POLL_INTERVAL = 30
 
 LOGGER = setup_logging("generate-bugfix-prompt")
 
@@ -60,6 +62,57 @@ def read_text_file(path):
         return None, "Cannot read file: {}".format(str(e))
 
 
+
+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:
+        raise ValueError("{} must be a non-negative integer".format(name))
+    if parsed < 0:
+        raise ValueError("{} 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:
+        raise ValueError("{} must be a positive integer".format(name))
+    if parsed <= 0:
+        raise ValueError("{} 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",
+    )
+    if not os.path.isfile(section_path):
+        return ""
+
+    content, err = read_text_file(section_path)
+    if err:
+        return ""
+    return content
+
 def find_bug(bugs, bug_id):
     """Find and return the bug dict matching the given ID."""
     for bug in bugs:
@@ -304,7 +357,34 @@ def build_replacements(args, bug, global_context, script_dir):
             browser_enabled = True
             browser_verify_steps = "   # (reproduce bug and verify fix)"
 
+    max_log_size = _parse_non_negative_int_env("MAX_LOG_SIZE", DEFAULT_MAX_LOG_SIZE)
+    if max_log_size == 0:
+        poll_interval = DEFAULT_LOG_MONITOR_POLL_INTERVAL
+    else:
+        poll_interval = _parse_positive_int_env(
+            "LOG_MONITOR_POLL_INTERVAL", DEFAULT_LOG_MONITOR_POLL_INTERVAL,
+        )
+
     replacements = {
+        "{{LOG_SIZE_AWARENESS}}": load_log_size_section(script_dir),
+        "{{MAX_LOG_SIZE}}": str(max_log_size),
+        "{{MAX_LOG_SIZE_HUMAN}}": _format_bytes(max_log_size),
+        "{{LOG_MONITOR_POLL_INTERVAL}}": str(poll_interval),
+        "{{LOG_MONITOR_STATUS_FILE}}": os.path.join(
+            ".prizmkit", "state", "bugfix", "bugs", args.bug_id,
+            "sessions", args.session_id, "logs", "log-monitor-status.txt",
+        ),
+        "{{LOG_MONITOR_BASELINE_FILE}}": os.path.join(
+            ".prizmkit", "state", "bugfix", "bugs", args.bug_id,
+            "sessions", args.session_id, "logs", "log-monitor-baseline.txt",
+        ),
+        "{{SESSION_LOG_PATH}}": os.path.join(
+            ".prizmkit", "state", "bugfix", "bugs", args.bug_id,
+            "sessions", args.session_id, "logs", "session.log",
+        ),
+        "{{LOG_MONITOR_SCRIPT}}": os.path.join(
+            ".prizmkit", "dev-pipeline", "scripts", "monitor-log.sh",
+        ),
         "{{RUN_ID}}": args.run_id,
         "{{SESSION_ID}}": args.session_id,
         "{{BUG_ID}}": args.bug_id,
@@ -420,9 +500,10 @@ def render_template(template_content, replacements, bug):
     # Step 1: Process conditional blocks
     content = process_conditional_blocks(template_content, bug)
 
-    # Step 2: Replace all {{PLACEHOLDER}} variables
-    for placeholder, value in replacements.items():
-        content = content.replace(placeholder, value)
+    # Step 2: Replace all {{PLACEHOLDER}} variables (two passes for nested sections)
+    for _pass in range(2):
+        for placeholder, value in replacements.items():
+            content = content.replace(placeholder, value)
 
     return content
 
@@ -675,6 +756,8 @@ if __name__ == "__main__":
         main()
     except KeyboardInterrupt:
         emit_failure("generate-bugfix-prompt interrupted")
+    except ValueError as exc:
+        emit_failure(str(exc))
     except SystemExit:
         raise
     except Exception as exc:

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

@@ -23,6 +23,8 @@ from utils import enrich_global_context, load_json_file, read_platform_conventio
 
 
 DEFAULT_MAX_RETRIES = 3
+DEFAULT_MAX_LOG_SIZE = 2097152
+DEFAULT_LOG_MONITOR_POLL_INTERVAL = 30
 
 LOGGER = setup_logging("generate-refactor-prompt")
 
@@ -151,6 +153,57 @@ def read_text_file(path):
         return None, "Cannot read file: {}".format(str(e))
 
 
+
+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:
+        raise ValueError("{} must be a non-negative integer".format(name))
+    if parsed < 0:
+        raise ValueError("{} 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:
+        raise ValueError("{} must be a positive integer".format(name))
+    if parsed <= 0:
+        raise ValueError("{} 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",
+    )
+    if not os.path.isfile(section_path):
+        return ""
+
+    content, err = read_text_file(section_path)
+    if err:
+        return ""
+    return content
+
 def find_refactor(refactors, refactor_id):
     """Find and return the refactor dict matching the given ID."""
     for refactor in refactors:
@@ -464,7 +517,34 @@ def build_replacements(args, refactor, refactors, global_context, script_dir):
             browser_enabled = True
             browser_verify_steps = "   # (validate UI renders correctly and feature still works)"
 
+    max_log_size = _parse_non_negative_int_env("MAX_LOG_SIZE", DEFAULT_MAX_LOG_SIZE)
+    if max_log_size == 0:
+        poll_interval = DEFAULT_LOG_MONITOR_POLL_INTERVAL
+    else:
+        poll_interval = _parse_positive_int_env(
+            "LOG_MONITOR_POLL_INTERVAL", DEFAULT_LOG_MONITOR_POLL_INTERVAL,
+        )
+
     replacements = {
+        "{{LOG_SIZE_AWARENESS}}": load_log_size_section(script_dir),
+        "{{MAX_LOG_SIZE}}": str(max_log_size),
+        "{{MAX_LOG_SIZE_HUMAN}}": _format_bytes(max_log_size),
+        "{{LOG_MONITOR_POLL_INTERVAL}}": str(poll_interval),
+        "{{LOG_MONITOR_STATUS_FILE}}": os.path.join(
+            ".prizmkit", "state", "refactor", "refactors", args.refactor_id,
+            "sessions", args.session_id, "logs", "log-monitor-status.txt",
+        ),
+        "{{LOG_MONITOR_BASELINE_FILE}}": os.path.join(
+            ".prizmkit", "state", "refactor", "refactors", args.refactor_id,
+            "sessions", args.session_id, "logs", "log-monitor-baseline.txt",
+        ),
+        "{{SESSION_LOG_PATH}}": os.path.join(
+            ".prizmkit", "state", "refactor", "refactors", args.refactor_id,
+            "sessions", args.session_id, "logs", "session.log",
+        ),
+        "{{LOG_MONITOR_SCRIPT}}": os.path.join(
+            ".prizmkit", "dev-pipeline", "scripts", "monitor-log.sh",
+        ),
         "{{RUN_ID}}": args.run_id,
         "{{SESSION_ID}}": args.session_id,
         "{{REFACTOR_ID}}": args.refactor_id,
@@ -587,9 +667,10 @@ def render_template(template_content, replacements, resume_phase, refactor):
     # Step 1: Process conditional blocks
     content = process_conditional_blocks(template_content, resume_phase, refactor)
 
-    # Step 2: Replace all {{PLACEHOLDER}} variables
-    for placeholder, value in replacements.items():
-        content = content.replace(placeholder, value)
+    # Step 2: Replace all {{PLACEHOLDER}} variables (two passes for nested sections)
+    for _pass in range(2):
+        for placeholder, value in replacements.items():
+            content = content.replace(placeholder, value)
 
     return content
 
@@ -753,6 +834,8 @@ if __name__ == "__main__":
         main()
     except KeyboardInterrupt:
         emit_failure("generate-refactor-prompt interrupted")
+    except ValueError as exc:
+        emit_failure(str(exc))
     except SystemExit:
         raise
     except Exception as exc:

package/bundled/dev-pipeline/scripts/monitor-log.sh

@@ -0,0 +1,104 @@
+#!/usr/bin/env bash
+# monitor-log.sh — Background log size monitor for AI session subagent
+#
+# Polls session.log size, computes effective size (current - baseline),
+# and writes a structured JSON status file. Intended to be run by a
+# background subagent inside the AI CLI session.
+#
+# Usage:
+#   bash monitor-log.sh <session_log> <max_size> <poll_interval> <status_file> <baseline_file>
+#
+# Status file format (JSON, rewritten each poll cycle):
+#   {
+#     "status": "OK" | "COMPACT_NEEDED",
+#     "total_bytes": <current session.log size in bytes>,
+#     "baseline_bytes": <baseline size from last compact>,
+#     "effective_bytes": <total - baseline>,
+#     "threshold_bytes": <compact threshold>,
+#     "overage_bytes": <effective - threshold, 0 if not exceeded>,
+#     "usage_pct": <effective / threshold * 100, integer>
+#   }
+
+SESSION_LOG="${1}"
+MAX_SIZE="${2}"
+POLL_INTERVAL="${3}"
+STATUS_FILE="${4}"
+BASELINE_FILE="${5}"
+
+# Validate required args
+if [[ -z "$SESSION_LOG" || -z "$MAX_SIZE" || -z "$POLL_INTERVAL" || -z "$STATUS_FILE" || -z "$BASELINE_FILE" ]]; then
+    echo "Usage: $0 <session_log> <max_size> <poll_interval> <status_file> <baseline_file>" >&2
+    exit 1
+fi
+
+# Ensure status dir exists
+mkdir -p "$(dirname "$STATUS_FILE")"
+
+# Validate numeric args
+if ! [[ "$MAX_SIZE" =~ ^[0-9]+$ ]]; then
+    echo "ERROR: max_size must be a non-negative integer" >&2
+    exit 1
+fi
+if ! [[ "$POLL_INTERVAL" =~ ^[0-9]+$ ]] || [[ "$POLL_INTERVAL" -le 0 ]]; then
+    echo "ERROR: poll_interval must be a positive integer" >&2
+    exit 1
+fi
+
+echo "[monitor-log] Starting log monitor: max=${MAX_SIZE} interval=${POLL_INTERVAL}s" >&2
+echo "[monitor-log] Watching: $SESSION_LOG" >&2
+
+while true; do
+    # Read current log size
+    if [[ -f "$SESSION_LOG" ]]; then
+        size=$(wc -c < "$SESSION_LOG" 2>/dev/null | tr -d ' ')
+    else
+        size=0
+    fi
+
+    # Read baseline (resets after each /compact)
+    baseline=0
+    if [[ -f "$BASELINE_FILE" ]]; then
+        baseline=$(cat "$BASELINE_FILE" 2>/dev/null | tr -d ' ')
+        if ! [[ "$baseline" =~ ^[0-9]+$ ]]; then
+            baseline=0
+        fi
+    fi
+
+    # Effective size = growth since last compact
+    effective=$((size - baseline))
+    if [[ $effective -lt 0 ]]; then
+        effective=0
+    fi
+
+    # Determine status (MAX_SIZE=0 disables monitoring)
+    if [[ $MAX_SIZE -gt 0 && $effective -gt $MAX_SIZE ]]; then
+        status="COMPACT_NEEDED"
+        overage=$((effective - MAX_SIZE))
+        echo "[monitor-log] COMPACT_NEEDED: effective=${effective} overage=${overage} (threshold=${MAX_SIZE})" >&2
+    else
+        status="OK"
+        overage=0
+    fi
+
+    # Usage percentage (effective / threshold * 100)
+    if [[ $MAX_SIZE -gt 0 ]]; then
+        usage_pct=$((effective * 100 / MAX_SIZE))
+    else
+        usage_pct=0
+    fi
+
+    # Write structured JSON status
+    cat > "$STATUS_FILE" << EOF
+{
+  "status": "${status}",
+  "total_bytes": ${size},
+  "baseline_bytes": ${baseline},
+  "effective_bytes": ${effective},
+  "threshold_bytes": ${MAX_SIZE},
+  "overage_bytes": ${overage},
+  "usage_pct": ${usage_pct}
+}
+EOF
+
+    sleep "$POLL_INTERVAL"
+done

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

@@ -12,7 +12,7 @@ You are the **session orchestrator**. Implement Feature {{FEATURE_ID}}: "{{FEATU
 
 **CRITICAL**: You MUST NOT exit until ALL work is complete and committed.
 
-**Tier 1 — Single Agent**: You handle everything directly. No subagents, no TeamCreate.
+**Tier 1 — Single Agent**: You handle everything directly. No normal work subagents; the log-size monitor is the only allowed persistent background subagent. No TeamCreate.
 
 ### Feature Description
 
@@ -54,6 +54,9 @@ You are running in **headless non-interactive mode** with a FINITE context windo
 
 ---
 
+{{LOG_SIZE_AWARENESS}}
+---
+
 ## PrizmKit Directory Convention
 
 ```

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

@@ -10,7 +10,7 @@
 
 You are the **session orchestrator**. Implement Feature {{FEATURE_ID}}: "{{FEATURE_TITLE}}".
 
-**CRITICAL**: You MUST NOT exit until ALL work is complete and committed. When you spawn subagents, wait for each to finish (run_in_background=false).
+**CRITICAL**: You MUST NOT exit until ALL work is complete and committed. When you spawn normal work subagents, wait for each to finish (run_in_background=false). The log-size monitor is the only allowed persistent background subagent.
 
 **Tier 2 — Dual Agent**: You handle context + planning directly. Then spawn Dev and Reviewer subagents. Spawn Dev and Reviewer agents via the Agent tool.
 
@@ -60,6 +60,9 @@ You are running in **headless non-interactive mode** with a FINITE context windo
 
 ---
 
+{{LOG_SIZE_AWARENESS}}
+---
+
 ## PrizmKit Directory Convention
 
 ```
@@ -601,7 +604,7 @@ If you encounter an unrecoverable error, context overflow, or are about to exit
 - Build context-snapshot.md FIRST; all subagents read it instead of re-reading source files
 - 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 subagents
+- Do NOT use `run_in_background=true` when spawning normal work subagents; the log-size monitor is the only allowed persistent background subagent
 - **NEVER delete, modify, or touch any file under `.prizmkit/state/`** — those are pipeline runtime files managed by the runner
 - NEVER run `rm -rf`, `git clean`, or any destructive filesystem operations
 - `/prizmkit-committer` is mandatory, and must not be replaced with manual git commit commands