prizmkit 1.1.95 → 1.1.97

package/bundled/dev-pipeline/templates/bootstrap-tier3.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). Do NOT spawn agents in background and exit — that kills the session.
+**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. Do NOT spawn work agents in background and exit — that kills the session.
 
 **Tier 3 — Full Team**: For complex features, use the full pipeline (Phase 0–6) with Dev + Reviewer agents spawned 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
 
 ```
@@ -635,7 +638,7 @@ If you encounter an unrecoverable error, context overflow, or are about to exit
 - Tier 3: full team — Dev (implementation) → Reviewer (review) — 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 agents
+- Do NOT use `run_in_background=true` when spawning normal work agents; the log-size monitor is the only allowed persistent background subagent
 - Commit phase must use `/prizmkit-committer`; do NOT replace with manual git commit commands
 - **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

package/bundled/dev-pipeline/templates/bugfix-bootstrap-prompt.md

@@ -13,6 +13,8 @@ You are the **bug fix session agent**. Fix Bug {{BUG_ID}}: "{{BUG_TITLE}}".
 
 **CRITICAL**: You MUST NOT exit until ALL work is complete and committed.
 
+**SUBAGENT LIFECYCLE**: The log-size monitor is the only allowed persistent background subagent. Any normal work subagent must be awaited with `run_in_background=false`.
+
 **NON-INTERACTIVE MODE**: There is NO human on the other end. NEVER ask for user confirmation, NEVER wait for user input. Make decisions autonomously and move forward.
 
 ### Bug Description
@@ -51,6 +53,7 @@ You are the **bug fix session agent**. Fix Bug {{BUG_ID}}: "{{BUG_TITLE}}".
 4. **Minimize tool output** — Capture to temp file, scan head/tail, filter with grep/sed/awk. Never load full output.
 5. **No intermediate commits** — All changes committed once at the end via `/prizmkit-committer`.
 
+{{LOG_SIZE_AWARENESS}}
 ## Bug Fix Artifacts Directory
 
 ```

package/bundled/dev-pipeline/templates/refactor-bootstrap-prompt.md

@@ -12,7 +12,7 @@
 
 You are the **refactor session orchestrator**. Execute Refactor {{REFACTOR_ID}}: "{{REFACTOR_TITLE}}".
 
-**CRITICAL SESSION LIFECYCLE RULE**: You MUST NOT exit until ALL work is complete and session-status.json is written. When you spawn subagents, you MUST **wait for each to finish** (run_in_background=false) before proceeding. Do NOT spawn an agent in the background and exit — that kills the session.
+**CRITICAL SESSION LIFECYCLE RULE**: You MUST NOT exit until ALL work is complete and session-status.json is written. When you spawn normal work subagents, you MUST **wait for each to finish** (run_in_background=false) before proceeding. The log-size monitor is the only allowed persistent background subagent. Do NOT spawn a work agent in the background and exit — that kills the session.
 
 **NON-INTERACTIVE MODE**: You are running in headless non-interactive mode. There is NO human on the other end. NEVER ask for user confirmation, NEVER wait for user input, NEVER use interactive prompts (e.g. "Would you like me to…"). If a skill has an interactive step (e.g. offer remediation, ask for approval), skip it and proceed autonomously. Make decisions based on the data available and move forward.
 
@@ -78,6 +78,7 @@ You are the **refactor session orchestrator**. Execute Refactor {{REFACTOR_ID}}:
 
 ## Execution Instructions
 
+{{LOG_SIZE_AWARENESS}}
 **YOU are the orchestrator. Execute each phase by spawning the appropriate team agent with run_in_background=false.**
 
 **Agent spawn failure policy (all Agent tool calls)**:
@@ -336,4 +337,4 @@ Write to: `{{SESSION_STATUS_PATH}}`
 - **Commit with** `refactor(<scope>):` prefix, NOT `feat:` or `fix:`
 - **Run full retrospective** (Job 1 + Job 2) — refactoring changes code structure
 - ALWAYS write session-status.json before exiting
-- 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

package/bundled/dev-pipeline/templates/sections/log-size-awareness.md

@@ -0,0 +1,76 @@
+## Session Log Budget Monitoring (PROACTIVE)
+
+Your session log grows with every tool call and subagent spawn.
+To prevent context exhaustion, **spawn a background monitoring subagent at session start**.
+
+### How to Set Up the Monitor
+
+1. **AS THE VERY FIRST ACTION** (before Phase 0), spawn a monitoring subagent
+   with `run_in_background: true` and this task:
+
+   ```
+   Run this command and keep it running:
+   bash {{LOG_MONITOR_SCRIPT}} {{SESSION_LOG_PATH}} {{MAX_LOG_SIZE}} {{LOG_MONITOR_POLL_INTERVAL}} {{LOG_MONITOR_STATUS_FILE}} {{LOG_MONITOR_BASELINE_FILE}}
+   ```
+
+   The subagent MUST use `run_in_background: true`. It writes a JSON status
+   file every {{LOG_MONITOR_POLL_INTERVAL}} seconds.
+
+2. **BEFORE EACH MAJOR PHASE** (Phase 0, 1, 2, ...), read the status:
+
+   ```bash
+   cat {{LOG_MONITOR_STATUS_FILE}} 2>/dev/null || echo '{"status":"OK"}'
+   ```
+
+   The status file contains structured diagnostics:
+
+   ```json
+   {
+     "status": "OK | COMPACT_NEEDED",
+     "total_bytes": <current session.log size>,
+     "baseline_bytes": <size after last /compact>,
+     "effective_bytes": <total - baseline, incremental growth>,
+     "threshold_bytes": <{{MAX_LOG_SIZE}}>,
+     "overage_bytes": <effective - threshold, 0 when OK>,
+     "usage_pct": <effective / threshold * 100>
+   }
+   ```
+
+   Extract fields for decision-making:
+   ```bash
+   status=$(jq -r '.status' {{LOG_MONITOR_STATUS_FILE}})
+   effective=$(jq -r '.effective_bytes' {{LOG_MONITOR_STATUS_FILE}})
+   overage=$(jq -r '.overage_bytes' {{LOG_MONITOR_STATUS_FILE}})
+   usage=$(jq -r '.usage_pct' {{LOG_MONITOR_STATUS_FILE}})
+   ```
+
+3. **On COMPACT_NEEDED** (effective_bytes > {{MAX_LOG_SIZE}} bytes, {{MAX_LOG_SIZE_HUMAN}}):
+   - Check `overage_bytes` to decide urgency:
+     - **Minor overage** (< 512KB): complete the current sub-step, update durable workflow checkpoint artifacts, write baseline, `/compact`
+     - **Major overage** (>= 512KB): update durable workflow checkpoint artifacts, write baseline, `/compact` — do NOT start new work
+   - Write baseline before `/compact`:
+     ```bash
+     wc -c < {{SESSION_LOG_PATH}} > {{LOG_MONITOR_BASELINE_FILE}}
+     ```
+   - Execute `/compact`
+   - Continue the workflow after `/compact`; re-read this status file before the next major phase
+
+### How the Baseline Prevents Infinite Compaction Loops
+
+- Before the first `/compact`: baseline = 0, effective = full log size → triggers when log exceeds threshold
+- After `/compact`: baseline = current log size, effective ≈ 0 → status resets to OK
+- The monitor only triggers again when **new** log growth since the last compact exceeds the threshold
+- Each `/compact` resets the baseline, breaking the infinite loop
+
+### Log Growth Reduction Tips
+
+- **Re-read context-snapshot.md instead of source files** — already in context
+- **Filter command output** — pipe to `tail -20` or `grep`, never full output
+- **Limit subagent prompts** — shorter, focused prompts = shorter transcripts
+- **Checkpoint often** — update durable workflow checkpoint artifacts before `/compact`
+
+### What Survives
+
+- All git commits are permanent
+- The workflow checkpoint is preserved and auto-resumed
+- `/compact` compresses context without losing progress

package/bundled/dev-pipeline-windows/lib/pipeline.ps1

@@ -50,6 +50,8 @@ function Invoke-PrizmPipeline {
     Write-Host ""
     Write-Host "Environment Variables:"
     Write-Host "  PRIZMKIT_EFFORT       AI reasoning effort (low|medium|high|xhigh|max; max is Claude Code only)"
+    Write-Host "  MAX_LOG_SIZE          Session log size threshold for compact warning (default: 2097152 = 2MB, set 0 to disable)"
+    Write-Host "  LOG_MONITOR_POLL_INTERVAL  Log monitor poll interval in seconds (default: 30)"
     $global:PRIZM_EXIT_CODE = 0
     return
   }

package/bundled/dev-pipeline-windows/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")
 
@@ -157,6 +159,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:
@@ -1310,7 +1360,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",
@@ -1347,7 +1398,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 = [
@@ -1359,7 +1412,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",
@@ -1373,7 +1428,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",
         ]
@@ -1412,12 +1469,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
@@ -1435,6 +1493,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"
@@ -1907,7 +1971,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,
@@ -1953,6 +2026,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.ps1",
+        ),
     }
 
     return replacements, effective_resume, browser_enabled, browser_tool

package/bundled/dev-pipeline-windows/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")
 
@@ -61,6 +63,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:
@@ -305,7 +358,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.ps1",
+        ),
         "{{RUN_ID}}": args.run_id,
         "{{SESSION_ID}}": args.session_id,
         "{{BUG_ID}}": args.bug_id,
@@ -422,9 +502,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
 
@@ -678,6 +759,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-windows/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")
 
@@ -152,6 +154,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:
@@ -465,7 +518,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.ps1",
+        ),
         "{{RUN_ID}}": args.run_id,
         "{{SESSION_ID}}": args.session_id,
         "{{REFACTOR_ID}}": args.refactor_id,
@@ -589,9 +669,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
 
@@ -756,6 +837,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: