@promptbook/cli 0.112.0-43 → 0.112.0-45

package/esm/index.es.js

@@ -4,7 +4,7 @@ import _spaceTrim, { spaceTrim as spaceTrim$1 } from 'spacetrim';
 import * as fs from 'fs';
 import { mkdirSync, writeFileSync, readFileSync, existsSync } from 'fs';
 import { join, basename, dirname, isAbsolute, relative, extname, resolve } from 'path';
-import { readFile, writeFile, stat, mkdir, access, constants, readdir, watch, unlink, rm, rename, rmdir } from 'fs/promises';
+import { readFile, writeFile, stat, mkdir, access, constants, readdir, watch, unlink, rm, rename, rmdir, appendFile } from 'fs/promises';
 import { forTime, forEver } from 'waitasecond';
 import prompts from 'prompts';
 import * as dotenv from 'dotenv';
@@ -58,7 +58,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-43';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-45';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -3005,6 +3005,8 @@ function $initializeCoderRunCommand(program) {
             Features:
             - Automatically stages and commits changes with agent identity
             - Optional post-commit git push with explicit --auto-push opt-in
+            - Optional --preserve-logs keeps temp prompt/log artifacts after successful rounds
+            - Optional --no-ui keeps plain streaming console output for logging and debugging
             - Supports GPG signing of commits
             - Optional post-prompt verification with test-feedback retries
             - Progress tracking and interactive controls
@@ -3020,6 +3022,8 @@ function $initializeCoderRunCommand(program) {
         `));
     command.option('--context <context-or-file>', 'Append extra instructions either inline or from a file path relative to the current project');
     command.option('--test <test-command...>', 'Run a verification command after each prompt; quote it when the command itself contains top-level flags');
+    command.option('--preserve-logs', 'Keep generated temp prompt/log artifacts after successful rounds for debugging and analytics', false);
+    command.option('--no-ui', 'Disable the rich terminal UI and keep plain streaming console output for logging and debugging');
     command.addOption(new Option('--thinking-level <thinking-level>', `Set reasoning effort for supported runners (${THINKING_LEVEL_VALUES.join(', ')})`).choices([...THINKING_LEVEL_VALUES]));
     command.option('--priority <minimum-priority>', 'Filter prompts by minimum priority level', parseIntOption, 0);
     command.option('--no-wait', 'Skip user prompts between processing');
@@ -3030,8 +3034,9 @@ function $initializeCoderRunCommand(program) {
     command.option('--auto-migrate', 'Run testing-server database migrations automatically after each successfully processed prompt');
     command.option('--allow-destructive-auto-migrate', 'Allow auto-migrate even when heuristic SQL safety check flags destructive pending migrations');
     command.action(handleActionErrors(async (cliOptions) => {
-        const { dryRun, agent, model, context, test, thinkingLevel, priority, wait, ignoreGitChanges, allowCredits, normalizeLineEndings, autoMigrate, allowDestructiveAutoMigrate, autoPush, } = cliOptions;
+        const { dryRun, agent, model, context, test, preserveLogs, ui, thinkingLevel, priority, wait, ignoreGitChanges, allowCredits, normalizeLineEndings, autoMigrate, allowDestructiveAutoMigrate, autoPush, } = cliOptions;
         const testCommand = normalizeCommandOptionValue(test);
+        const noUi = !ui;
         // Validate agent
         let agentName = undefined;
         if (agent) {
@@ -3061,6 +3066,8 @@ function $initializeCoderRunCommand(program) {
             model,
             context,
             testCommand,
+            preserveLogs,
+            noUi,
             thinkingLevel,
             priority,
             normalizeLineEndings,
@@ -18384,7 +18391,7 @@ class DeleteCommitmentDefinition extends BaseCommitmentDefinition {
             DELETE Casual conversational style
             REMOVE All emoji usage
             GOAL Provide professional business communications
-            STYLE Use formal language and proper business etiquette
+            WRITING RULES Use formal language and proper business etiquette
             \`\`\`
 
             \`\`\`book
@@ -18395,7 +18402,7 @@ class DeleteCommitmentDefinition extends BaseCommitmentDefinition {
             DISCARD Technical jargon explanations
             CANCEL Advanced troubleshooting procedures
             GOAL Help users with simple, easy-to-follow solutions
-            STYLE Use plain language that anyone can understand
+            WRITING RULES Use plain language that anyone can understand
             \`\`\`
 
             \`\`\`book
@@ -18412,11 +18419,11 @@ class DeleteCommitmentDefinition extends BaseCommitmentDefinition {
             Concise Information Provider
 
             PERSONA You are a helpful assistant who provides detailed explanations
-            STYLE Include examples, analogies, and comprehensive context
+            WRITING RULES Include examples, analogies, and comprehensive context
             CANCEL Detailed explanation style
             DISCARD Examples and analogies
             GOAL Provide brief, direct answers without unnecessary elaboration
-            STYLE Be concise and to the point
+            WRITING RULES Be concise and to the point
             \`\`\`
         `);
     }
@@ -18600,7 +18607,7 @@ class FormatCommitmentDefinition extends BaseCommitmentDefinition {
             PERSONA You are a data analysis expert
             FORMAT Present results in structured tables
             FORMAT Include confidence scores for all predictions
-            STYLE Be concise and precise in explanations
+            WRITING RULES Be concise and precise in explanations
             \`\`\`
         `);
     }
@@ -18949,7 +18956,7 @@ class GoalCommitmentDefinition extends BaseCommitmentDefinition {
      * Short one-line description of GOAL.
      */
     get description() {
-        return 'Define main **goals** the AI assistant should achieve, with later goals having higher priority.';
+        return 'Define the effective agent **goal**; when multiple goals exist, only the last one stays effective.';
     }
     /**
      * Icon for this commitment.
@@ -18964,12 +18971,14 @@ class GoalCommitmentDefinition extends BaseCommitmentDefinition {
         return spaceTrim$1(`
             # ${this.type}
 
-            Defines the main goal which should be achieved by the AI assistant. There can be multiple goals, and later goals are more important than earlier goals.
+            Defines the main goal which should be achieved by the AI assistant.
+            There can be multiple goals in source, but after inheritance/source rewriting only the last \`GOAL\` /\`GOALS\` remains effective.
 
             ## Key aspects
 
             - Both terms work identically and can be used interchangeably.
-            - Later goals have higher priority and can override earlier goals.
+            - Later goals overwrite earlier goals.
+            - The public agent profile text is derived from the last goal.
             - Goals provide clear direction and purpose for the agent's responses.
             - Goals influence decision-making and response prioritization.
 
@@ -18982,9 +18991,7 @@ class GoalCommitmentDefinition extends BaseCommitmentDefinition {
             \`\`\`book
             Customer Support Agent
 
-            PERSONA You are a helpful customer support representative
             GOAL Resolve customer issues quickly and efficiently
-            GOAL Maintain high customer satisfaction scores
             GOAL Always follow company policies and procedures
             RULE Be polite and professional at all times
             \`\`\`
@@ -18992,19 +18999,15 @@ class GoalCommitmentDefinition extends BaseCommitmentDefinition {
             \`\`\`book
             Educational Assistant
 
-            PERSONA You are an educational assistant specializing in mathematics
             GOAL Help students understand mathematical concepts clearly
-            GOAL Encourage critical thinking and problem-solving skills
             GOAL Ensure all explanations are age-appropriate and accessible
-            STYLE Use simple language and provide step-by-step explanations
+            WRITING RULES Use simple language and provide step-by-step explanations
             \`\`\`
 
             \`\`\`book
             Safety-First Assistant
 
-            PERSONA You are a general-purpose AI assistant
             GOAL Be helpful and informative in all interactions
-            GOAL Provide accurate and reliable information
             GOAL Always prioritize user safety and ethical guidelines
             RULE Never provide harmful or dangerous advice
             \`\`\`
@@ -19412,7 +19415,7 @@ class KnowledgeCommitmentDefinition extends BaseCommitmentDefinition {
             KNOWLEDGE Academic research requires careful citation and verification
             KNOWLEDGE https://example.com/research-guidelines.pdf
             ACTION Can help with literature reviews and data analysis
-            STYLE Present information in clear, academic format
+            WRITING RULES Present information in clear, academic format
             \`\`\`
         `);
     }
@@ -21163,7 +21166,7 @@ class MetaImageCommitmentDefinition extends BaseCommitmentDefinition {
 
             META IMAGE https://example.com/professional-avatar.jpg
             PERSONA You are a professional business assistant
-            STYLE Maintain a formal and courteous tone
+            WRITING RULES Maintain a formal and courteous tone
             \`\`\`
 
             \`\`\`book
@@ -21171,7 +21174,7 @@ class MetaImageCommitmentDefinition extends BaseCommitmentDefinition {
 
             META IMAGE /assets/creative-bot-avatar.png
             PERSONA You are a creative and inspiring assistant
-            STYLE Be enthusiastic and encouraging
+            WRITING RULES Be enthusiastic and encouraging
             ACTION Can help with brainstorming and ideation
             \`\`\`
         `);
@@ -21330,7 +21333,7 @@ class MetaLinkCommitmentDefinition extends BaseCommitmentDefinition {
             META LINK https://twitter.com/devhandle
             PERSONA You are an experienced open source developer
             ACTION Can help with code reviews and architecture decisions
-            STYLE Be direct and technical in explanations
+            WRITING RULES Be direct and technical in explanations
             \`\`\`
         `);
     }
@@ -21536,7 +21539,7 @@ class ModelCommitmentDefinition extends BaseCommitmentDefinition {
             MODEL TEMPERATURE 0.8
             MODEL TOP_P 0.9
             MODEL MAX_TOKENS 2048
-            STYLE Be imaginative and expressive
+            WRITING RULES Be imaginative and expressive
             ACTION Can help with storytelling and character development
             \`\`\`
 
@@ -21748,7 +21751,7 @@ class NoteCommitmentDefinition extends BaseCommitmentDefinition {
             NOTE Uses RAG for accessing latest research papers
             PERSONA You are a knowledgeable research assistant
             ACTION Can help with literature reviews and citations
-            STYLE Present information in academic format
+            WRITING RULES Present information in academic format
             \`\`\`
         `);
     }
@@ -21863,7 +21866,16 @@ class PersonaCommitmentDefinition extends BaseCommitmentDefinition {
      * Short one-line description of PERSONA.
      */
     get description() {
-        return 'Define who the agent is: background, expertise, and personality.';
+        return 'Deprecated legacy profile commitment. Prefer `GOAL` for agent profile text and inheritance-safe rewrites.';
+    }
+    /**
+     * Optional UI/docs-only deprecation metadata.
+     */
+    get deprecation() {
+        return {
+            message: 'Use `GOAL` for agent profile text and inheritance-safe rewrites.',
+            replacedBy: ['GOAL'],
+        };
     }
     /**
      * Icon for this commitment.
@@ -21878,16 +21890,24 @@ class PersonaCommitmentDefinition extends BaseCommitmentDefinition {
         return spaceTrim$1(`
             # ${this.type}
 
-            Defines who the agent is, their background, expertise, and personality traits.
+            Deprecated legacy commitment that defines who the agent is, their background, expertise, and personality traits.
 
-            ## Key aspects
+            ## Migration
 
-            - Multiple \`PERSONA\` and \`PERSONAE\` commitments are merged together.
-            - Both terms work identically and can be used interchangeably.
-            - If they are in conflict, the last one takes precedence.
-            - You can write persona content in multiple lines.
+            - Existing \`${this.type}\` books still parse and compile.
+            - New books should prefer \`GOAL\`.
+            - Agent profile rendering now prefers the last \`GOAL\` and only falls back to \`${this.type}\` when no goal exists.
+            - Runtime compilation keeps the legacy multi-\`PERSONA\` merge behavior for backward compatibility.
 
-            ## Examples
+            ## Preferred replacement
+
+            \`\`\`book
+            Programming Assistant
+
+            GOAL Help the user solve programming problems with practical TypeScript and React guidance.
+            \`\`\`
+
+            ## Legacy compatibility example
 
             \`\`\`book
             Programming Assistant
@@ -22025,7 +22045,7 @@ class RuleCommitmentDefinition extends BaseCommitmentDefinition {
             RULE Always ask for clarification if the user's request is ambiguous
             RULE Be polite and professional in all interactions
             RULES Never provide medical or legal advice
-            STYLE Maintain a friendly and helpful tone
+            WRITING RULES Maintain a friendly and helpful tone
             \`\`\`
 
             \`\`\`book
@@ -22294,8 +22314,8 @@ class ScenarioCommitmentDefinition extends BaseCommitmentDefinition {
 /**
  * STYLE commitment definition
  *
- * The STYLE commitment defines how the agent should format and present its responses.
- * This includes tone, writing style, formatting preferences, and communication patterns.
+ * Deprecated legacy writing-style commitment kept for backward compatibility.
+ * New books should prefer `WRITING RULES` for writing-only constraints.
  *
  * Example usage in agent source:
  *
@@ -22314,7 +22334,16 @@ class StyleCommitmentDefinition extends BaseCommitmentDefinition {
      * Short one-line description of STYLE.
      */
     get description() {
-        return 'Control the tone and writing style of responses.';
+        return 'Deprecated legacy writing-style commitment. Prefer `WRITING RULES` for new books.';
+    }
+    /**
+     * Optional UI/docs-only deprecation metadata.
+     */
+    get deprecation() {
+        return {
+            message: 'Use `WRITING RULES` for writing-only constraints such as tone, length, formatting, or emoji usage.',
+            replacedBy: ['WRITING RULES'],
+        };
     }
     /**
      * Icon for this commitment.
@@ -22329,15 +22358,34 @@ class StyleCommitmentDefinition extends BaseCommitmentDefinition {
         return spaceTrim$1(`
             # ${this.type}
 
-            Defines how the agent should format and present its responses (tone, writing style, formatting).
+            Deprecated legacy commitment for writing and presentation instructions.
+
+            ## Migration
+
+            - Existing \`${this.type}\` books still parse and compile.
+            - New books should prefer \`WRITING RULES\`.
+            - Use \`WRITING SAMPLE\` when you want to anchor voice by example instead of stating constraints directly.
+            - The plural alias \`STYLES\` is the same legacy commitment family.
 
             ## Key aspects
 
-            - Both terms work identically and can be used interchangeably.
+            - \`${this.type}\` remains functional for backward compatibility only.
             - Later style instructions can override earlier ones.
             - Style affects both tone and presentation format.
 
-            ## Examples
+            ## Preferred replacement
+
+            \`\`\`book
+            Technical Writer
+
+            GOAL Help the user understand technical topics with practical, accurate guidance.
+            WRITING RULES Write in a professional but friendly tone.
+            WRITING RULES Use bullet points for lists.
+            WRITING RULES Always provide code examples when explaining programming concepts.
+            FORMAT Use markdown formatting with clear headings
+            \`\`\`
+
+            ## Legacy compatibility examples
 
             \`\`\`book
             Technical Writer
@@ -22652,7 +22700,7 @@ class TeamCommitmentDefinition extends BaseCommitmentDefinition {
             \`\`\`book
             Legal Assistant
 
-            PERSONA An expert software developer
+            GOAL Get expert software-development advice from the teammate when legal discussion needs technical context.
             TEAM You can talk with http://localhost:4440/agents/GMw67JN8TXxN7y to discuss the legal aspects.
             \`\`\`
         `);
@@ -23078,7 +23126,7 @@ class TemplateCommitmentDefinition extends BaseCommitmentDefinition {
 
             PERSONA You are a helpful customer support representative
             TEMPLATE Always structure your response with: 1) Acknowledgment, 2) Solution, 3) Follow-up question
-            STYLE Be professional and empathetic
+            WRITING RULES Be professional and empathetic
             \`\`\`
 
             \`\`\`book
@@ -23522,7 +23570,7 @@ class UseBrowserCommitmentDefinition extends BaseCommitmentDefinition {
 
             PERSONA You are a news analyst who stays up-to-date with current events
             USE BROWSER
-            STYLE Present news in a balanced and objective manner
+            WRITING RULES Present news in a balanced and objective manner
             ACTION Can search for and summarize news articles
             \`\`\`
 
@@ -41398,6 +41446,15 @@ const COMMITMENTS_WITH_AGENT_REFERENCES = new Set(['FROM', 'IMPORT', 'IMPORTS',
  * @private internal constant of `createAgentModelRequirementsWithCommitments`
  */
 const DELETE_COMMITMENT_TYPES = new Set(['DELETE', 'CANCEL', 'DISCARD', 'REMOVE']);
+/**
+ * Commitments whose earlier occurrences are overwritten by the last occurrence in source order.
+ *
+ * @private internal constant of `createAgentModelRequirementsWithCommitments`
+ */
+const OVERWRITTEN_COMMITMENT_GROUP_BY_TYPE = new Map([
+    ['GOAL', 'GOAL'],
+    ['GOALS', 'GOAL'],
+]);
 /**
  * Regex pattern matching markdown horizontal lines that should not be copied into the final system message.
  *
@@ -41448,7 +41505,7 @@ function getSafeReferenceCommitmentFallback(commitmentType, originalContent) {
  */
 async function createAgentModelRequirementsWithCommitments(agentSource, modelName, options) {
     const parseResult = parseAgentSourceWithCommitments(agentSource);
-    const filteredCommitments = filterDeletedCommitments(parseResult.commitments);
+    const filteredCommitments = filterOverwrittenCommitments(filterDeletedCommitments(parseResult.commitments));
     let requirements = createInitialAgentModelRequirements(parseResult.agentName, modelName);
     requirements = await applyCommitmentsToRequirements(requirements, filteredCommitments, options);
     requirements = aggregateUseCommitmentSystemMessages(requirements, filteredCommitments);
@@ -41459,6 +41516,35 @@ async function createAgentModelRequirementsWithCommitments(agentSource, modelNam
     requirements = await applyPendingInlineKnowledgeSources(requirements, options === null || options === void 0 ? void 0 : options.inlineKnowledgeSourceUploader);
     return finalizeRequirements(requirements);
 }
+/**
+ * Removes earlier commitments that are overwritten by later commitments of the same semantic group.
+ *
+ * This currently keeps only the last `GOAL` / `GOALS` commitment so inheritance rewrites
+ * and multi-goal sources expose one effective goal to the runtime.
+ *
+ * @param commitments - Parsed commitments after DELETE-like filtering.
+ * @returns Commitments with overwritten entries removed while preserving source order.
+ *
+ * @private internal utility of `createAgentModelRequirementsWithCommitments`
+ */
+function filterOverwrittenCommitments(commitments) {
+    const seenOverwriteGroups = new Set();
+    const keptCommitments = [];
+    for (let index = commitments.length - 1; index >= 0; index--) {
+        const commitment = commitments[index];
+        const overwriteGroup = OVERWRITTEN_COMMITMENT_GROUP_BY_TYPE.get(commitment.type);
+        if (!overwriteGroup) {
+            keptCommitments.push(commitment);
+            continue;
+        }
+        if (seenOverwriteGroups.has(overwriteGroup)) {
+            continue;
+        }
+        seenOverwriteGroups.add(overwriteGroup);
+        keptCommitments.push(commitment);
+    }
+    return keptCommitments.reverse();
+}
 /**
  * Creates the initial requirements object with the parsed agent name stored in metadata and an optional model override.
  *
@@ -42101,7 +42187,7 @@ function createDefaultAgentName(agentSource) {
 function parseAgentSource(agentSource) {
     const parseResult = parseAgentSourceWithCommitments(agentSource);
     const resolvedAgentName = parseResult.agentName || createDefaultAgentName(agentSource);
-    const personaDescription = extractPersonaDescription(parseResult.commitments);
+    const personaDescription = extractAgentProfileText(parseResult.commitments);
     const initialMessage = extractInitialMessage(parseResult.commitments);
     const parsedProfile = extractParsedAgentProfile(parseResult.commitments);
     ensureMetaFullname(parsedProfile.meta, resolvedAgentName);
@@ -42205,25 +42291,33 @@ const META_COMMITMENT_APPLIERS = {
  */
 const LOCAL_AGENT_REFERENCE_PREFIXES = ['./', '../', '/'];
 /**
- * Builds the combined persona description from PERSONA commitments.
+ * Resolves the public agent profile text from the last GOAL/GOALS commitment,
+ * falling back to the deprecated PERSONA/PERSONAE commitments when no goal exists.
  *
  * @private internal utility of `parseAgentSource`
  */
-function extractPersonaDescription(commitments) {
-    let personaDescription = null;
+function extractAgentProfileText(commitments) {
+    let goalDescription = '';
+    let hasGoalDescription = false;
+    let personaDescription = '';
+    let hasPersonaDescription = false;
     for (const commitment of commitments) {
-        if (commitment.type !== 'PERSONA') {
-            continue;
+        if (commitment.type === 'GOAL' || commitment.type === 'GOALS') {
+            goalDescription = commitment.content;
+            hasGoalDescription = true;
         }
-        if (personaDescription === null) {
-            personaDescription = '';
+        if (commitment.type === 'PERSONA' || commitment.type === 'PERSONAE') {
+            personaDescription = commitment.content;
+            hasPersonaDescription = true;
         }
-        else {
-            personaDescription += `\n\n${personaDescription}`;
-        }
-        personaDescription += commitment.content;
     }
-    return personaDescription;
+    if (hasGoalDescription) {
+        return goalDescription;
+    }
+    if (hasPersonaDescription) {
+        return personaDescription;
+    }
+    return null;
 }
 /**
  * Resolves the last INITIAL MESSAGE commitment, which is the public initial-message value.
@@ -42710,7 +42804,7 @@ async function createAgentModelRequirements(agentSource, modelName, availableMod
  * Selects the best model using the preparePersona function
  * This directly uses preparePersona to ensure DRY principle
  *
- * @param agentSource The agent source to derive persona description from
+ * @param agentSource The agent source to derive effective profile text from
  * @param llmTools LLM tools for preparing persona
  * @returns The name of the best selected model
  *
@@ -42718,9 +42812,9 @@ async function createAgentModelRequirements(agentSource, modelName, availableMod
  */
 async function selectBestModelUsingPersona(agentSource, llmTools) {
     var _a;
-    // Parse agent source to get persona description
+    // Parse agent source to get the effective profile description
     const { agentName, personaDescription } = parseAgentSource(agentSource);
-    // Use agent name as fallback if no persona description is available
+    // Use agent name as fallback if no profile description is available
     const description = personaDescription || agentName || 'AI Agent';
     try {
         // Use preparePersona directly
@@ -44182,7 +44276,7 @@ var findRefactorCandidates$1 = /*#__PURE__*/Object.freeze({
 /**
  * CLI usage text for this script.
  */
-const USAGE = 'Usage: run-codex-prompts [--dry-run] [--agent <agent-name>] [--model <model>] [--context <context-or-file>] [--test <test-command...>] [--thinking-level <thinking-level>] [--priority <minimum-priority>] [--allow-credits] [--auto-migrate] [--allow-destructive-auto-migrate] [--no-wait] [--ignore-git-changes] [--no-normalize-line-endings] [--auto-push]';
+const USAGE = 'Usage: run-codex-prompts [--dry-run] [--agent <agent-name>] [--model <model>] [--context <context-or-file>] [--test <test-command...>] [--preserve-logs] [--no-ui] [--thinking-level <thinking-level>] [--priority <minimum-priority>] [--allow-credits] [--auto-migrate] [--allow-destructive-auto-migrate] [--no-wait] [--ignore-git-changes] [--no-normalize-line-endings] [--auto-push]';
 /**
  * Top-level flags supported by this command.
  */
@@ -44192,6 +44286,8 @@ const KNOWN_OPTION_FLAGS = new Set([
     '--model',
     '--context',
     '--test',
+    '--preserve-logs',
+    '--no-ui',
     '--thinking-level',
     '--priority',
     '--allow-credits',
@@ -44224,6 +44320,8 @@ function parseRunOptions(args) {
     const context = readOptionValue(args, '--context');
     const hasTestCommandFlag = args.includes('--test');
     const testCommand = readVariadicOptionValue(args, '--test');
+    const preserveLogs = args.includes('--preserve-logs');
+    const noUi = args.includes('--no-ui');
     const hasThinkingLevelFlag = args.includes('--thinking-level');
     const thinkingLevelValue = readOptionValue(args, '--thinking-level');
     const hasPriorityFlag = args.includes('--priority');
@@ -44259,6 +44357,8 @@ function parseRunOptions(args) {
         autoMigrate,
         allowDestructiveAutoMigrate,
         autoPush,
+        preserveLogs,
+        noUi,
         agentName,
         model,
         context,
@@ -44339,18 +44439,10 @@ function appendCoderContext(prompt, context) {
     return `${normalizedPrompt}\n\n${normalizedContext}`;
 }
 
-/**
- * Refresh interval for the progress header in milliseconds.
- */
-const PROGRESS_REFRESH_INTERVAL_MS = 1000;
-/**
- * Number of terminal lines reserved for the sticky progress header.
- */
-const PROGRESS_HEADER_RESERVED_LINES = 1;
 /**
  * Calendar formats used when displaying the estimated completion time.
  */
-const ESTIMATED_DONE_CALENDAR_FORMATS$1 = {
+const ESTIMATED_DONE_CALENDAR_FORMATS = {
     sameDay: '[Today] h:mm',
     nextDay: '[Tomorrow] h:mm',
     nextWeek: 'dddd h:mm',
@@ -44358,6 +44450,121 @@ const ESTIMATED_DONE_CALENDAR_FORMATS$1 = {
     lastWeek: 'dddd h:mm',
     sameElse: 'MMM D h:mm',
 };
+/**
+ * Formats a duration into a compact string such as "3h 12m" or "45s".
+ */
+function formatDurationBrief(duration) {
+    const totalSeconds = Math.max(0, Math.round(duration.asSeconds()));
+    const hours = Math.floor(totalSeconds / 3600);
+    const minutes = Math.floor((totalSeconds % 3600) / 60);
+    const seconds = totalSeconds % 60;
+    const parts = [];
+    if (hours > 0) {
+        parts.push(`${hours}h`);
+    }
+    if (minutes > 0) {
+        parts.push(`${minutes}m`);
+    }
+    if (!parts.length && seconds > 0) {
+        parts.push(`${seconds}s`);
+    }
+    if (!parts.length) {
+        parts.push('0s');
+    }
+    return parts.join(' ');
+}
+
+/**
+ * Builds a session-scoped progress snapshot from prompt stats and elapsed active time.
+ */
+function buildCoderRunProgressSnapshot(stats, elapsedDuration, initialDone) {
+    const totalPrompts = stats.done + stats.forAgent + stats.toBeWritten;
+    const sessionDone = Math.max(0, stats.done - initialDone);
+    const sessionRemaining = stats.forAgent;
+    const sessionTotal = sessionDone + sessionRemaining;
+    const currentPromptIndex = sessionTotal > 0 ? Math.min(sessionDone + 1, sessionTotal) : 0;
+    const percentage = sessionTotal > 0 ? Math.round((sessionDone / sessionTotal) * 100) : 0;
+    const elapsedText = formatDurationBrief(elapsedDuration);
+    let estimatedTotalText = 'estimating...';
+    let estimatedLabel = 'after first completion';
+    let isEstimatedTotalKnown = false;
+    if (sessionTotal > 0 && sessionDone > 0) {
+        const estimatedTotalMs = (elapsedDuration.asMilliseconds() * sessionTotal) / sessionDone;
+        const estimatedRemainingMs = Math.max(0, estimatedTotalMs - elapsedDuration.asMilliseconds());
+        const estimatedTotalDuration = moment.duration(estimatedTotalMs);
+        const estimatedCompletion = moment().add(estimatedRemainingMs, 'milliseconds');
+        estimatedTotalText = formatDurationBrief(estimatedTotalDuration);
+        estimatedLabel = estimatedCompletion.calendar(null, ESTIMATED_DONE_CALENDAR_FORMATS);
+        isEstimatedTotalKnown = true;
+    }
+    return {
+        totalPrompts,
+        sessionDone,
+        sessionRemaining,
+        sessionTotal,
+        currentPromptIndex,
+        skippedPrompts: stats.belowMinimumPriority,
+        toBeWrittenPrompts: stats.toBeWritten,
+        percentage,
+        elapsedText,
+        estimatedTotalText,
+        estimatedLabel,
+        isEstimatedTotalKnown,
+    };
+}
+
+/**
+ * Tracks active coder-run time while excluding pauses and user-confirmation waits.
+ */
+class CoderRunTimer {
+    /**
+     * Creates a timer anchored at the provided start time.
+     */
+    constructor(startTime, isPausedInitially = false) {
+        this.startTime = startTime;
+        /**
+         * Total milliseconds spent in paused state across the run.
+         */
+        this.pausedMs = 0;
+        if (isPausedInitially) {
+            this.pausedSince = startTime.clone();
+        }
+    }
+    /**
+     * Pauses active-time tracking until `resume()` is called.
+     */
+    pause() {
+        if (this.pausedSince === undefined) {
+            this.pausedSince = moment();
+        }
+    }
+    /**
+     * Resumes active-time tracking after a pause.
+     */
+    resume() {
+        if (this.pausedSince !== undefined) {
+            this.pausedMs += moment().diff(this.pausedSince);
+            this.pausedSince = undefined;
+        }
+    }
+    /**
+     * Returns the currently accumulated active duration.
+     */
+    getElapsedDuration() {
+        const wallMs = moment().diff(this.startTime);
+        const currentPauseMs = this.pausedSince !== undefined ? moment().diff(this.pausedSince) : 0;
+        return moment.duration(Math.max(0, wallMs - this.pausedMs - currentPauseMs));
+    }
+}
+
+/**
+ * Refresh interval for the progress header in milliseconds.
+ */
+const PROGRESS_REFRESH_INTERVAL_MS = 1000;
+/**
+ * Number of terminal lines reserved for the sticky progress header.
+ */
+const PROGRESS_HEADER_RESERVED_LINES = 3;
 /**
  * Compact CLI progress display that stays pinned at the top of the terminal.
  */
@@ -44365,11 +44572,12 @@ class CliProgressDisplay {
     /**
      * Creates a new display that uses the provided start time when computing estimates.
      */
-    constructor(startTime) {
-        this.startTime = startTime;
+    constructor(startTime, minimumPriority) {
+        this.minimumPriority = minimumPriority;
         this.stats = { done: 0, forAgent: 0, belowMinimumPriority: 0, toBeWritten: 0 };
         this.isHeaderReserved = false;
         this.isInteractive = Boolean(process.stdout.isTTY);
+        this.timer = new CoderRunTimer(startTime);
         if (!this.isInteractive) {
             return;
         }
@@ -44388,6 +44596,20 @@ class CliProgressDisplay {
         this.stats = stats;
         this.render();
     }
+    /**
+     * Pauses the active timer while the runner is waiting for user input.
+     */
+    pauseTimer() {
+        this.timer.pause();
+        this.render();
+    }
+    /**
+     * Resumes the active timer after a pause.
+     */
+    resumeTimer() {
+        this.timer.resume();
+        this.render();
+    }
     /**
      * Stops the automatic refresh cycle and renders the final header once more.
      */
@@ -44405,14 +44627,17 @@ class CliProgressDisplay {
      * Repaint the header without disturbing the current cursor position.
      */
     render() {
+        var _a;
         if (!this.isInteractive) {
             return;
         }
-        const line = this.buildProgressLine();
+        const lines = this.buildProgressLines();
         process.stdout.write('\x1b[s');
-        cursorTo(process.stdout, 0, 0);
-        clearLine(process.stdout, 0);
-        process.stdout.write(line);
+        for (let lineIndex = 0; lineIndex < PROGRESS_HEADER_RESERVED_LINES; lineIndex++) {
+            cursorTo(process.stdout, 0, lineIndex);
+            clearLine(process.stdout, 0);
+            process.stdout.write((_a = lines[lineIndex]) !== null && _a !== void 0 ? _a : '');
+        }
         process.stdout.write('\x1b[u');
     }
     /**
@@ -44426,72 +44651,74 @@ class CliProgressDisplay {
         this.isHeaderReserved = true;
     }
     /**
-     * Builds the coloured progress text padded to the terminal width.
+     * Builds the colored progress text padded to the terminal width.
      */
-    buildProgressLine() {
+    buildProgressLines() {
         var _a, _b;
-        const snapshot = buildProgressSnapshot(this.stats, this.startTime, (_a = this.initialDone) !== null && _a !== void 0 ? _a : this.stats.done);
-        const sessionLabel = `${snapshot.sessionDone}/${snapshot.sessionTotal} Prompts`;
-        const totalLabel = `(${snapshot.totalPrompts} total)`;
-        const baseLine = `${sessionLabel} ${totalLabel} | ${snapshot.percentage}% | ${snapshot.elapsedText}/${snapshot.estimatedTotalText} | Estimated done ${snapshot.estimatedLabel}`;
-        const columns = (_b = process.stdout.columns) !== null && _b !== void 0 ? _b : baseLine.length;
-        const padded = baseLine.padEnd(columns > baseLine.length ? columns : baseLine.length);
-        return colors.bgWhite(colors.black(padded));
+        const snapshot = buildCoderRunProgressSnapshot(this.stats, this.timer.getElapsedDuration(), (_a = this.initialDone) !== null && _a !== void 0 ? _a : this.stats.done);
+        const columns = Math.max(40, (_b = process.stdout.columns) !== null && _b !== void 0 ? _b : 80);
+        const workingLine = snapshot.sessionTotal > 0
+            ? [
+                `Working on ${snapshot.currentPromptIndex}/${snapshot.sessionTotal} prompts`,
+                `Priority >=${this.minimumPriority}`,
+                `Repo total ${snapshot.totalPrompts}`,
+            ].join(' | ')
+            : [`No runnable prompts`, `Priority >=${this.minimumPriority}`, `Repo total ${snapshot.totalPrompts}`].join(' | ');
+        const detailParts = [
+            `Done ${snapshot.sessionDone}/${snapshot.sessionTotal} this run`,
+            `Elapsed ${snapshot.elapsedText} / ${snapshot.estimatedTotalText}`,
+            `Est. done ${snapshot.estimatedLabel}`,
+        ];
+        if (snapshot.skippedPrompts > 0) {
+            detailParts.splice(1, 0, `Skipping ${snapshot.skippedPrompts} prompts with Priority <${this.minimumPriority}`);
+        }
+        if (snapshot.toBeWrittenPrompts > 0) {
+            detailParts.splice(detailParts.length - 2, 0, `Write first ${formatPromptCount$1(snapshot.toBeWrittenPrompts)}`);
+        }
+        const progressLabel = `${snapshot.percentage}% complete (${snapshot.sessionDone}/${snapshot.sessionTotal} done)`;
+        const progressBar = buildProgressBar$1(snapshot.percentage, progressLabel, columns);
+        return [
+            colors.bgCyan.black(padPlainText(workingLine, columns)),
+            colors.bgBlack.white(padPlainText(detailParts.join(' | '), columns)),
+            colors.bgBlack(progressBar),
+        ];
     }
 }
 /**
- * Calculates progress metrics shown in the sticky header.
+ * Builds a colored progress bar with an explicit completion label.
  */
-function buildProgressSnapshot(stats, startTime, initialDone) {
-    const totalPrompts = stats.done + stats.forAgent + stats.toBeWritten;
-    const completedPrompts = stats.done;
-    const sessionDone = Math.max(0, completedPrompts - initialDone);
-    const sessionTotal = sessionDone + stats.forAgent;
-    const percentage = totalPrompts > 0 ? Math.round((completedPrompts / totalPrompts) * 100) : 0;
-    const elapsedDuration = moment.duration(moment().diff(startTime));
-    const elapsedText = formatDurationBrief$1(elapsedDuration);
-    let estimatedTotalText = '—';
-    let estimatedLabel = 'unknown';
-    if (totalPrompts > 0 && completedPrompts > 0) {
-        const estimatedTotalMs = (elapsedDuration.asMilliseconds() * totalPrompts) / completedPrompts;
-        const estimatedTotalDuration = moment.duration(estimatedTotalMs);
-        const estimatedCompletion = startTime.clone().add(estimatedTotalDuration);
-        estimatedTotalText = formatDurationBrief$1(estimatedTotalDuration);
-        estimatedLabel = estimatedCompletion.calendar(null, ESTIMATED_DONE_CALENDAR_FORMATS$1);
-    }
-    return {
-        totalPrompts,
-        completedPrompts,
-        sessionDone,
-        sessionTotal,
-        percentage,
-        elapsedText,
-        estimatedTotalText,
-        estimatedLabel,
-    };
+function buildProgressBar$1(percentage, label, width) {
+    const safeLabel = ` ${label}`;
+    const barWidth = Math.max(10, width - safeLabel.length);
+    const filledWidth = Math.round((percentage / 100) * barWidth);
+    const emptyWidth = Math.max(0, barWidth - filledWidth);
+    return `${colors.green('█'.repeat(filledWidth))}${colors.gray('░'.repeat(emptyWidth))}${safeLabel}`;
 }
 /**
- * Formats a duration into a compact string such as "3h 12m" or "45s".
+ * Pads or truncates one plain-text header line to the terminal width.
  */
-function formatDurationBrief$1(duration) {
-    const totalSeconds = Math.max(0, Math.round(duration.asSeconds()));
-    const hours = Math.floor(totalSeconds / 3600);
-    const minutes = Math.floor((totalSeconds % 3600) / 60);
-    const seconds = totalSeconds % 60;
-    const parts = [];
-    if (hours > 0) {
-        parts.push(`${hours}h`);
-    }
-    if (minutes > 0) {
-        parts.push(`${minutes}m`);
-    }
-    if (!parts.length && seconds > 0) {
-        parts.push(`${seconds}s`);
-    }
-    if (!parts.length) {
-        parts.push('0s');
+function padPlainText(text, width) {
+    if (text.length > width) {
+        if (width <= 3) {
+            return '.'.repeat(width);
+        }
+        return `${text.slice(0, width - 3)}...`;
     }
-    return parts.join(' ');
+    return text.padEnd(width);
+}
+/**
+ * Formats a prompt count with the correct singular/plural noun.
+ */
+function formatPromptCount$1(count) {
+    return `${count} prompt${count === 1 ? '' : 's'}`;
+}
+
+/**
+ * Formats commit message lines for console display.
+ */
+function formatCommitMessageForDisplay(message) {
+    const lines = message.split(/\r?\n/);
+    return lines.map((line) => colors.bgBlue.white(` ${line} `)).join('\n');
 }
 
 /**
@@ -44705,14 +44932,6 @@ function normalizeCrLfToLf(content) {
     return normalized.subarray(0, writeIndex);
 }
 
-/**
- * Formats commit message lines for console display.
- */
-function formatCommitMessageForDisplay(message) {
-    const lines = message.split(/\r?\n/);
-    return lines.map((line) => colors.bgBlue.white(` ${line} `)).join('\n');
-}
-
 /**
  * Prints the formatted commit message preview.
  */
@@ -44749,6 +44968,45 @@ async function resolveCoderContext(contextReference, currentWorkingDirectory) {
     return readFile(contextPath, 'utf-8');
 }
 
+/**
+ * Builds the temporary live runtime log path for one prompt script and its sibling test script.
+ */
+function buildScriptLogPath(scriptPath) {
+    const basePath = scriptPath.replace(/\.test\.sh$/iu, '').replace(/\.sh$/iu, '');
+    return `${basePath}.log.txt`;
+}
+
+/**
+ * Decides whether one temporary prompt artifact should be deleted after a round finishes.
+ */
+function shouldDeleteTemporaryArtifact({ preserveArtifactsOnSuccess, hasFailed, }) {
+    return !preserveArtifactsOnSuccess && !hasFailed;
+}
+
+/**
+ * Runs one prompt-processing round with a dedicated temporary runtime log file that is cleaned up only after successful non-preserved runs.
+ */
+async function withPromptRuntimeLog(scriptPath, handler, options) {
+    const logPath = buildScriptLogPath(scriptPath);
+    let hasFailed = false;
+    await unlink(logPath).catch(() => undefined);
+    try {
+        return await handler(logPath);
+    }
+    catch (error) {
+        hasFailed = true;
+        throw error;
+    }
+    finally {
+        if (shouldDeleteTemporaryArtifact({
+            preserveArtifactsOnSuccess: options === null || options === void 0 ? void 0 : options.preserveArtifactsOnSuccess,
+            hasFailed,
+        })) {
+            await unlink(logPath).catch(() => undefined);
+        }
+    }
+}
+
 /**
  * Waits for the user to press Enter before continuing.
  */
@@ -46588,6 +46846,15 @@ function buildPromptLabelForDisplay(file, section) {
     return `${relative(process.cwd(), file.path).replace(/\\/g, '/')}#${section.startLine + 1}`;
 }
 
+/**
+ * Extracts a short summary line from a prompt section.
+ */
+function buildPromptSummary(file, section) {
+    const lines = buildCodexPrompt(file, section).split(/\r?\n/);
+    const firstLine = lines.find((line) => line.trim() !== '');
+    return (firstLine === null || firstLine === void 0 ? void 0 : firstLine.trim()) || '(empty prompt)';
+}
+
 /**
  * Builds the script path for a prompt section.
  */
@@ -46647,15 +46914,6 @@ function findNextTodoPrompt(files, minimumPriority = 0) {
     return nextPrompt;
 }
 
-/**
- * Extracts a short summary line from a prompt section.
- */
-function buildPromptSummary(file, section) {
-    const lines = buildCodexPrompt(file, section).split(/\r?\n/);
-    const firstLine = lines.find((line) => line.trim() !== '');
-    return (firstLine === null || firstLine === void 0 ? void 0 : firstLine.trim()) || '(empty prompt)';
-}
-
 /**
  * Lists upcoming tasks that are ready to run (no authoring placeholders).
  */
@@ -47052,25 +47310,190 @@ function toPosixPath(filePath) {
 }
 
 /**
- * Creates a temporary script file, runs a handler, and ensures cleanup.
+ * Environment variable read by the shell wrapper to tee live output into the temporary runtime log file.
+ */
+const PTBK_CODER_LOG_FILE_ENV_NAME = 'PTBK_CODER_LOG_FILE';
+/**
+ * Small bash wrapper that preserves stdout/stderr streams while teeing both into the runtime log file.
+ */
+const LOGGED_BASH_WRAPPER_COMMAND = `
+if [ -n "\${${PTBK_CODER_LOG_FILE_ENV_NAME}:-}" ]; then
+    exec > >(tee -a "\$${PTBK_CODER_LOG_FILE_ENV_NAME}") 2> >(tee -a "\$${PTBK_CODER_LOG_FILE_ENV_NAME}" >&2)
+fi
+bash "$1"
+`.trim();
+/**
+ * Shapes one bash invocation that optionally mirrors live script output into a temporary log file.
+ */
+function buildLoggedBashExecution(scriptPath, logPath) {
+    return {
+        args: ['-lc', LOGGED_BASH_WRAPPER_COMMAND, 'ptbk-coder-temp-script', toPosixPath(scriptPath)],
+        env: logPath ? { [PTBK_CODER_LOG_FILE_ENV_NAME]: toPosixPath(logPath) } : undefined,
+    };
+}
+/**
+ * Appends one execution-start section with the raw script input before the shell begins producing output.
+ */
+async function appendScriptExecutionLogStart({ scriptPath, scriptContent, logPath, }) {
+    if (!logPath) {
+        return;
+    }
+    await mkdir(dirname(logPath), { recursive: true });
+    const scriptKind = describeTempScriptKind(scriptPath);
+    const normalizedInput = scriptContent.replace(/\r\n/g, '\n').trimEnd();
+    const logSection = [
+        `=== ${scriptKind} started at ${new Date().toISOString()} ===`,
+        `Script path: ${toPosixPath(scriptPath)}`,
+        '',
+        '--- raw input ---',
+        normalizedInput,
+        '',
+        '--- raw output ---',
+        '',
+    ].join('\n');
+    await appendFile(logPath, `${logSection}\n`, 'utf-8');
+}
+/**
+ * Appends one execution-finish section after the shell settles.
+ */
+async function appendScriptExecutionLogFinish({ scriptPath, logPath, status, details, }) {
+    if (!logPath) {
+        return;
+    }
+    const scriptKind = describeTempScriptKind(scriptPath);
+    const logLines = [
+        '',
+        `=== ${scriptKind} finished at ${new Date().toISOString()} ===`,
+        `Status: ${status}`,
+    ];
+    if (details !== undefined) {
+        logLines.push('');
+        logLines.push('--- details ---');
+        logLines.push(formatUnknownErrorDetails(details));
+    }
+    logLines.push('');
+    await appendFile(logPath, `${logLines.join('\n')}\n`, 'utf-8');
+}
+/**
+ * Distinguishes prompt-runner and verification temp shells in the shared runtime log.
+ */
+function describeTempScriptKind(scriptPath) {
+    return scriptPath.toLowerCase().endsWith('.test.sh') ? 'test shell' : 'runner shell';
+}
+
+/**
+ * Runs one temporary bash script, optionally mirroring its raw input/output into a live runtime log file.
+ */
+async function runBashScriptWithOutput(options) {
+    await appendScriptExecutionLogStart(options);
+    const bashExecution = buildLoggedBashExecution(options.scriptPath, options.logPath);
+    const scriptPathPosix = toPosixPath(options.scriptPath);
+    return await new Promise((resolve, reject) => {
+        const commandProcess = spawn('bash', bashExecution.args, {
+            env: bashExecution.env ? { ...process.env, ...bashExecution.env } : process.env,
+        });
+        let output = '';
+        let settled = false;
+        let isSettling = false;
+        /**
+         * Appends the final log footer before settling.
+         */
+        const finishLog = async (status, details) => {
+            await appendScriptExecutionLogFinish({
+                scriptPath: options.scriptPath,
+                logPath: options.logPath,
+                status,
+                details,
+            });
+        };
+        /**
+         * Ensures the promise settles only once.
+         */
+        const settleOnce = (handler) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            handler();
+        };
+        /**
+         * Appends the final log footer and settles the promise exactly once.
+         */
+        const settleWithLog = (status, handler, details) => {
+            if (isSettling || settled) {
+                return;
+            }
+            isSettling = true;
+            void finishLog(status, details).finally(() => {
+                settleOnce(handler);
+            });
+        };
+        commandProcess.stdout.on('data', (stdout) => {
+            const chunk = stdout.toString();
+            output += chunk;
+            console.info(chunk);
+        });
+        commandProcess.stderr.on('data', (stderr) => {
+            const chunk = stderr.toString();
+            output += chunk;
+            if (chunk.trim()) {
+                console.warn(chunk);
+            }
+        });
+        /**
+         * Handles process exit and resolves or rejects accordingly.
+         */
+        const handleExit = (code) => {
+            if (code === 0) {
+                settleWithLog('succeeded', () => resolve(spaceTrim$1(output)));
+                return;
+            }
+            const failure = new Error(spaceTrim$1(output) || `Command "bash ${scriptPathPosix}" exited with code ${code}`);
+            settleWithLog(`failed with exit code ${code !== null && code !== void 0 ? code : 'unknown'}`, () => reject(failure), failure);
+        };
+        commandProcess.on('close', handleExit);
+        commandProcess.on('exit', handleExit);
+        commandProcess.on('disconnect', () => {
+            const failure = new Error(`Command "bash ${scriptPathPosix}" disconnected`);
+            settleWithLog('failed after disconnect', () => reject(failure), failure);
+        });
+        commandProcess.on('error', (error) => {
+            const failure = new Error(`Command "bash ${scriptPathPosix}" failed: ${error.message}`);
+            settleWithLog('failed before completion', () => reject(failure), failure);
+        });
+    });
+}
+
+/**
+ * Creates a temporary script file, runs a handler, and cleans it up unless preservation is requested or the run fails.
  */
 async function withTempScript(options, handler) {
     const { scriptPath, scriptContent } = options;
+    let hasFailed = false;
     await mkdir(dirname$1(scriptPath), { recursive: true });
     await writeFile(scriptPath, scriptContent, 'utf-8');
-    const result = await handler(scriptPath);
-    await unlink(scriptPath).catch(() => undefined);
-    return result;
+    try {
+        return await handler(scriptPath);
+    }
+    catch (error) {
+        hasFailed = true;
+        throw error;
+    }
+    finally {
+        if (shouldDeleteTemporaryArtifact({ preserveArtifactsOnSuccess: options.preserveArtifactsOnSuccess, hasFailed })) {
+            await unlink(scriptPath).catch(() => undefined);
+        }
+    }
 }
 
 /**
- * Creates a temporary script file, runs it, captures output, and then deletes it.
+ * Creates a temporary script file, runs it, captures output, and cleans it up unless preservation is requested or the run fails.
  */
 async function $runGoScriptWithOutput(options) {
     return await withTempScript(options, async (scriptPath) => {
-        return await $execCommand({
-            command: `bash "${toPosixPath(scriptPath)}"`,
-            isVerbose: true, // <- Note: Proxy the raw command output to the console
+        return await runBashScriptWithOutput({
+            ...options,
+            scriptPath,
         });
     });
 }
@@ -47166,6 +47589,8 @@ class ClaudeCodeRunner {
         const output = await $runGoScriptWithOutput({
             scriptPath: options.scriptPath,
             scriptContent,
+            logPath: options.logPath,
+            preserveArtifactsOnSuccess: options.preserveArtifactsOnSuccess,
         });
         const usage = parseClaudeCodeJsonOutput(output);
         return { usage };
@@ -47173,13 +47598,13 @@ class ClaudeCodeRunner {
 }
 
 /**
- * Creates a temporary script file, runs it, and then deletes it.
+ * Creates a temporary script file, runs it, and cleans it up unless preservation is requested or the run fails.
  */
 async function $runGoScript(options) {
     await withTempScript(options, async (scriptPath) => {
-        await $execCommand({
-            command: `bash "${toPosixPath(scriptPath)}"`,
-            isVerbose: true, // <- Note: Proxy the raw command output to the console
+        await runBashScriptWithOutput({
+            ...options,
+            scriptPath,
         });
     });
 }
@@ -47228,6 +47653,8 @@ class ClineRunner {
             await $runGoScript({
                 scriptPath: options.scriptPath,
                 scriptContent,
+                logPath: options.logPath,
+                preserveArtifactsOnSuccess: options.preserveArtifactsOnSuccess,
             });
             return { usage: UNCERTAIN_USAGE };
         }
@@ -47351,6 +47778,8 @@ class GeminiRunner {
         const output = await $runGoScriptWithOutput({
             scriptPath: options.scriptPath,
             scriptContent,
+            logPath: options.logPath,
+            preserveArtifactsOnSuccess: options.preserveArtifactsOnSuccess,
         });
         const usage = parseGeminiUsageFromOutput(output, options.prompt, this.options.model);
         return { usage };
@@ -47406,6 +47835,8 @@ class GitHubCopilotRunner {
         await $runGoScript({
             scriptPath: options.scriptPath,
             scriptContent,
+            logPath: options.logPath,
+            preserveArtifactsOnSuccess: options.preserveArtifactsOnSuccess,
         });
         return { usage: UNCERTAIN_USAGE };
     }
@@ -47442,14 +47873,30 @@ function buildCommandFailureMessage(scriptPathPosix, code, fullOutput) {
 async function runScriptUntilMarkerIdle(options) {
     const { scriptPath, completionLineMatcher, idleTimeoutMs } = options;
     const scriptPathPosix = toPosixPath(scriptPath);
+    await appendScriptExecutionLogStart(options);
+    const bashExecution = buildLoggedBashExecution(scriptPath, options.logPath);
     return await new Promise((resolve, reject) => {
-        const commandProcess = spawn('bash', [scriptPathPosix], { env: process.env });
+        const commandProcess = spawn('bash', bashExecution.args, {
+            env: bashExecution.env ? { ...process.env, ...bashExecution.env } : process.env,
+        });
         let stdoutBuffer = '';
         let stderrBuffer = '';
         let fullOutput = '';
         let markerSeen = false;
         let idleTimer;
         let settled = false;
+        let isSettling = false;
+        /**
+         * Appends the final log footer before settling.
+         */
+        const finishLog = async (status, details) => {
+            await appendScriptExecutionLogFinish({
+                scriptPath,
+                logPath: options.logPath,
+                status,
+                details,
+            });
+        };
         /**
          * Ensures the promise settles only once.
          */
@@ -47464,6 +47911,18 @@ async function runScriptUntilMarkerIdle(options) {
             }
             handler();
         };
+        /**
+         * Appends the final log footer and settles the promise exactly once.
+         */
+        const settleWithLog = (status, handler, details) => {
+            if (isSettling || settled) {
+                return;
+            }
+            isSettling = true;
+            void finishLog(status, details).finally(() => {
+                settleOnce(handler);
+            });
+        };
         /**
          * Resets the idle timer that triggers termination after inactivity.
          */
@@ -47473,7 +47932,7 @@ async function runScriptUntilMarkerIdle(options) {
             }
             idleTimer = setTimeout(() => {
                 commandProcess.kill();
-                settleOnce(() => resolve(fullOutput));
+                settleWithLog('completed after idle timeout', () => resolve(fullOutput));
             }, idleTimeoutMs);
         };
         /**
@@ -47527,41 +47986,43 @@ async function runScriptUntilMarkerIdle(options) {
          * Handles process exit and resolves or rejects accordingly.
          */
         const handleExit = (code) => {
-            settleOnce(() => {
-                if (code === 0 || markerSeen) {
+            const failure = code === 0 || markerSeen ? undefined : new Error(buildCommandFailureMessage(scriptPathPosix, code, fullOutput));
+            const status = failure ? `failed with exit code ${code !== null && code !== void 0 ? code : 'unknown'}` : 'succeeded';
+            settleWithLog(status, () => {
+                if (!failure) {
                     resolve(fullOutput);
                     return;
                 }
-                reject(new Error(buildCommandFailureMessage(scriptPathPosix, code, fullOutput)));
+                reject(failure);
             });
         };
         commandProcess.on('close', handleExit);
         commandProcess.on('exit', handleExit);
         commandProcess.on('disconnect', () => {
-            settleOnce(() => {
-                reject(new Error(buildCommandFailureMessage(scriptPathPosix, null, fullOutput)));
-            });
+            const failure = new Error(buildCommandFailureMessage(scriptPathPosix, null, fullOutput));
+            settleWithLog('failed after disconnect', () => reject(failure), failure);
         });
         commandProcess.on('error', (error) => {
-            settleOnce(() => {
-                const outputSnippet = createOutputSnippet(fullOutput);
-                const details = outputSnippet ? `\n\n${outputSnippet}` : '';
-                reject(new Error(`Command "bash ${scriptPathPosix}" failed: ${error.message}${details}`));
-            });
+            const outputSnippet = createOutputSnippet(fullOutput);
+            const details = outputSnippet ? `\n\n${outputSnippet}` : '';
+            const failure = new Error(`Command "bash ${scriptPathPosix}" failed: ${error.message}${details}`);
+            settleWithLog('failed before completion', () => reject(failure), failure);
         });
     });
 }
 
 /**
- * Creates a temporary script file, runs it, waits for a completion marker and idle time, and then deletes it.
+ * Creates a temporary script file, runs it, waits for a completion marker and idle time, and cleans it up unless preservation is requested or the run fails.
  * Returns the captured output for post-processing.
  */
 async function $runGoScriptUntilMarkerIdle(options) {
     return await withTempScript(options, async (scriptPath) => {
         return await runScriptUntilMarkerIdle({
             scriptPath,
+            scriptContent: options.scriptContent,
             completionLineMatcher: options.completionLineMatcher,
             idleTimeoutMs: options.idleTimeoutMs,
+            logPath: options.logPath,
         });
     });
 }
@@ -47939,6 +48400,8 @@ class OpenAiCodexRunner {
                     scriptContent,
                     completionLineMatcher: CODEX_COMPLETION_LINE,
                     idleTimeoutMs: CODEX_COMPLETION_IDLE_MS,
+                    logPath: options.logPath,
+                    preserveArtifactsOnSuccess: options.preserveArtifactsOnSuccess,
                 });
                 this.rateLimitBackoff.reset();
                 return { usage: buildCodexUsageFromOutput(output, this.options.model) };
@@ -48072,6 +48535,8 @@ class OpencodeRunner {
             output = await $runGoScriptWithOutput({
                 scriptPath: options.scriptPath,
                 scriptContent,
+                logPath: options.logPath,
+                preserveArtifactsOnSuccess: options.preserveArtifactsOnSuccess,
             });
         }
         catch (error) {
@@ -48098,6 +48563,8 @@ async function runPromptTestCommand(options) {
             cd "${projectPath}"
             ${options.command}
         `),
+        logPath: options.logPath,
+        preserveArtifactsOnSuccess: options.preserveArtifactsOnSuccess,
     });
 }
 
@@ -48121,6 +48588,8 @@ async function runPromptWithTestFeedback(options) {
             prompt: options.prompt,
             scriptPath: options.scriptPath,
             projectPath: options.projectPath,
+            logPath: options.logPath,
+            preserveArtifactsOnSuccess: options.preserveArtifactsOnSuccess,
         });
         return { ...result, attemptCount: 1 };
     }
@@ -48132,6 +48601,8 @@ async function runPromptWithTestFeedback(options) {
             prompt: promptForCurrentAttempt,
             scriptPath: options.scriptPath,
             projectPath: options.projectPath,
+            logPath: options.logPath,
+            preserveArtifactsOnSuccess: options.preserveArtifactsOnSuccess,
         });
         console.info(colors.gray(`Running verification command after attempt #${attemptCount}: ${normalizedTestCommand}`));
         try {
@@ -48139,6 +48610,8 @@ async function runPromptWithTestFeedback(options) {
                 command: normalizedTestCommand,
                 projectPath: options.projectPath,
                 scriptPath: buildPromptTestScriptPath(options.scriptPath),
+                logPath: options.logPath,
+                preserveArtifactsOnSuccess: options.preserveArtifactsOnSuccess,
             });
             return { ...result, attemptCount };
         }
@@ -48220,24 +48693,203 @@ function buildPromptTestScriptPath(scriptPath) {
 }
 
 /**
- * Maximum number of agent output lines kept in the scrolling output area.
- *
- * @private internal constant of coder run UI
+ * Maximum number of output lines reserved for agent output in the UI.
  */
-const MAX_AGENT_OUTPUT_LINES = 12;
+const MAX_VISIBLE_OUTPUT_LINES = 8;
 /**
- * Calendar formats used when displaying the estimated completion time.
+ * Builds the complete boxed terminal frame for the rich `ptbk coder run` UI.
+ */
+function buildCoderRunUiFrame(options) {
+    const totalWidth = Math.max(56, Math.min(options.terminalWidth, 96));
+    const isPromptActive = options.phase === 'running' || options.phase === 'verifying' || options.phase === 'loading';
+    const promptStatusPrefix = isPromptActive ? `${colors.yellow(`${options.spinner} `)}` : '';
+    const sessionScopeLine = options.progress.sessionTotal > 0
+        ? `Working on ${options.progress.currentPromptIndex}/${options.progress.sessionTotal} prompts with Priority ≥${options.config.priority}`
+        : `No runnable prompts with Priority ≥${options.config.priority}`;
+    const sessionCountLine = `Done ${options.progress.sessionDone}/${options.progress.sessionTotal} this run  ·  Repo total ${options.progress.totalPrompts}`;
+    const sessionQueueParts = [];
+    if (options.progress.skippedPrompts > 0) {
+        sessionQueueParts.push(`Skipping ${formatPromptCount(options.progress.skippedPrompts)} with Priority <${options.config.priority}`);
+    }
+    if (options.progress.toBeWrittenPrompts > 0) {
+        sessionQueueParts.push(`Write first ${formatPromptCount(options.progress.toBeWrittenPrompts)}`);
+    }
+    const sessionLines = [
+        `${buildPhaseBadge(options.phase, options.pauseState)} ${fitPlainText(options.statusMessage, totalWidth - 18)}`,
+        sessionScopeLine,
+        sessionCountLine,
+        ...(sessionQueueParts.length > 0 ? [sessionQueueParts.join('  ·  ')] : []),
+        `Elapsed ${options.progress.elapsedText}  ·  Est. total ${options.progress.estimatedTotalText}  ·  Est. done ${options.progress.estimatedLabel}`,
+        buildProgressBar(options.progress.percentage, totalWidth - 6, `${options.progress.percentage}% complete (${options.progress.sessionDone}/${options.progress.sessionTotal} done)`),
+    ];
+    const metadataParts = [options.config.agentName || 'No agent selected'];
+    if (options.config.modelName) {
+        metadataParts.push(options.config.modelName);
+    }
+    if (options.config.thinkingLevel) {
+        metadataParts.push(`thinking ${options.config.thinkingLevel}`);
+    }
+    const runnerDetails = [
+        [`${colors.bgCyan.black(' PTBK ')}`, colors.bgBlue.white(' CODER '), colors.bold.white(' Promptbook Coder')]
+            .join(''),
+        metadataParts.join('  ·  '),
+        buildConfigSummaryLine(options.config),
+    ];
+    const currentTaskLines = options.currentPromptLabel
+        ? [
+            `${promptStatusPrefix}${colors.bold.white(fitPlainText(options.currentPromptLabel, totalWidth - 8))}`,
+            `Attempt ${options.currentAttempt}/${options.maxAttempts}  ·  ${options.statusMessage}`,
+            ...options.detailLines.map((detailLine) => `• ${detailLine}`),
+        ]
+        : [options.statusMessage, ...options.detailLines.map((detailLine) => `• ${detailLine}`)];
+    const visibleOutputLines = options.agentOutputLines.length > 0
+        ? options.agentOutputLines.slice(-MAX_VISIBLE_OUTPUT_LINES).map((line) => `› ${stripAnsi(line)}`)
+        : ['No live agent output yet.'];
+    const controls = buildControlPills(options.pauseState, options.pendingEnterLabel).join('  ');
+    const frame = [
+        ...renderBox('Brand', runnerDetails, totalWidth, colors.cyan.bold),
+        ...renderBox('Session', sessionLines, totalWidth, colors.yellow.bold),
+        ...renderBox(options.currentPromptLabel ? 'Current task' : 'Queue', currentTaskLines, totalWidth, colors.magenta.bold),
+        ...renderBox('Live output', visibleOutputLines, totalWidth, colors.green.bold),
+    ];
+    if (options.errors.length > 0) {
+        frame.push(...renderBox('Errors', options.errors.map((errorLine) => `${colors.red('✗')} ${errorLine}`), totalWidth, colors.red.bold));
+    }
+    frame.push(...renderBox('Controls', [controls], totalWidth, colors.white.bold));
+    return frame;
+}
+/**
+ * Renders a framed box with a colored title and padded body lines.
+ */
+function renderBox(title, lines, totalWidth, colorizeTitle) {
+    const bodyWidth = Math.max(10, totalWidth - 4);
+    const titleText = ` ${title} `;
+    const topBorder = colors.gray('┌') +
+        colorizeTitle(titleText) +
+        colors.gray('─'.repeat(Math.max(0, totalWidth - 2 - titleText.length)) + '┐');
+    const body = lines.map((line) => {
+        const paddedLine = padAnsiText(line, bodyWidth);
+        return colors.gray('│ ') + paddedLine + colors.gray(' │');
+    });
+    const bottomBorder = colors.gray(`└${'─'.repeat(totalWidth - 2)}┘`);
+    return [topBorder, ...body, bottomBorder];
+}
+/**
+ * Builds the compact config summary line shown in the branding box.
+ */
+function buildConfigSummaryLine(config) {
+    const parts = [`Priority ≥${config.priority}`];
+    if (config.context) {
+        parts.unshift(`Context ${config.context}`);
+    }
+    if (config.testCommand) {
+        parts.push(`Test ${config.testCommand}`);
+    }
+    return parts.join('  ·  ');
+}
+/**
+ * Builds the colored phase badge shown in the session box.
+ */
+function buildPhaseBadge(phase, pauseState) {
+    if (pauseState !== 'RUNNING' || phase === 'paused') {
+        return colors.bgYellow.black(' PAUSED ');
+    }
+    switch (phase) {
+        case 'loading':
+        case 'initializing':
+            return colors.bgCyan.black(' LOADING ');
+        case 'running':
+            return colors.bgGreen.black(' RUNNING ');
+        case 'verifying':
+            return colors.bgMagenta.white(' VERIFYING ');
+        case 'waiting':
+            return colors.bgBlue.white(' WAITING ');
+        case 'done':
+            return colors.bgGreen.black(' DONE ');
+        case 'error':
+            return colors.bgRed.white(' ERROR ');
+        default:
+            return colors.bgWhite.black(' READY ');
+    }
+}
+/**
+ * Builds the progress bar shown in the session box.
+ */
+function buildProgressBar(percentage, availableWidth, label) {
+    const percentageLabel = label;
+    const barWidth = Math.max(10, availableWidth - percentageLabel.length - 1);
+    const filledWidth = Math.round((percentage / 100) * barWidth);
+    const emptyWidth = Math.max(0, barWidth - filledWidth);
+    return `${colors.green('█'.repeat(filledWidth))}${colors.gray('░'.repeat(emptyWidth))} ${percentageLabel}`;
+}
+/**
+ * Formats a prompt count with singular/plural wording.
+ */
+function formatPromptCount(count) {
+    return `${count} prompt${count === 1 ? '' : 's'}`;
+}
+/**
+ * Builds the control pills shown in the footer box.
+ */
+function buildControlPills(pauseState, pendingEnterLabel) {
+    const pills = [];
+    if (pendingEnterLabel) {
+        pills.push(colors.bgWhite.black(' ENTER ') + colors.white(` ${pendingEnterLabel}`));
+    }
+    pills.push(pauseState === 'RUNNING'
+        ? colors.bgYellow.black(' P ') + colors.white(' Pause')
+        : colors.bgYellow.black(' P ') + colors.white(' Resume'));
+    pills.push(colors.bgRed.white(' CTRL+C ') + colors.white(' Exit'));
+    return pills;
+}
+/**
+ * Pads or truncates a possibly ANSI-colored line to the target visible width.
+ */
+function padAnsiText(text, width) {
+    const fittedText = fitAnsiText(text, width);
+    return fittedText + ' '.repeat(Math.max(0, width - visibleLength(fittedText)));
+}
+/**
+ * Truncates a possibly ANSI-colored line to the target visible width.
+ */
+function fitAnsiText(text, width) {
+    if (visibleLength(text) <= width) {
+        return text;
+    }
+    return fitPlainText(stripAnsi(text), width);
+}
+/**
+ * Truncates a plain-text line to the target width with an ellipsis.
+ */
+function fitPlainText(text, width) {
+    if (text.length <= width) {
+        return text;
+    }
+    if (width <= 3) {
+        return '.'.repeat(width);
+    }
+    return `${text.slice(0, width - 3)}...`;
+}
+/**
+ * Measures visible string width by stripping ANSI escape codes.
+ */
+function visibleLength(text) {
+    return stripAnsi(text).length;
+}
+/**
+ * Strips ANSI escape codes from a string.
+ */
+function stripAnsi(text) {
+    // eslint-disable-next-line no-control-regex
+    return text.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, '');
+}
+
+/**
+ * Maximum number of agent output lines kept in the scrolling output area.
  *
  * @private internal constant of coder run UI
  */
-const ESTIMATED_DONE_CALENDAR_FORMATS = {
-    sameDay: '[Today] h:mm',
-    nextDay: '[Tomorrow] h:mm',
-    nextWeek: 'dddd h:mm',
-    lastDay: '[Yesterday] h:mm',
-    lastWeek: 'dddd h:mm',
-    sameElse: 'MMM D h:mm',
-};
+const MAX_AGENT_OUTPUT_LINES = 12;
 /**
  * Reactive state manager for the coder run terminal UI.
  *
@@ -48253,35 +48905,27 @@ class CoderRunUiState extends EventEmitter {
         this.currentPromptLabel = '';
         this.currentAttempt = 1;
         this.maxAttempts = 3;
+        this.detailLines = [];
         this.agentOutputLines = [];
         this.phase = 'initializing';
         this.statusMessage = 'Initializing...';
         this.errors = [];
         this.stats = { done: 0, forAgent: 0, belowMinimumPriority: 0, toBeWritten: 0 };
-        /**
-         * Total milliseconds the timer was paused/waiting (excluded from elapsed display).
-         */
-        this.pausedMs = 0;
-        this.startTime = startTime;
-        // Timer starts paused — callers call `resumeTimer()` when actual work begins.
-        this.pausedSince = startTime.clone();
+        this.timer = new CoderRunTimer(startTime, true);
     }
     /**
      * Pauses the elapsed timer (e.g. while waiting for user input or paused state).
      */
     pauseTimer() {
-        if (this.pausedSince === undefined) {
-            this.pausedSince = moment();
-        }
+        this.timer.pause();
+        this.emitChange();
     }
     /**
      * Resumes the elapsed timer after a pause.
      */
     resumeTimer() {
-        if (this.pausedSince !== undefined) {
-            this.pausedMs += moment().diff(this.pausedSince);
-            this.pausedSince = undefined;
-        }
+        this.timer.resume();
+        this.emitChange();
     }
     /**
      * Replaces the configuration shown in the UI header.
@@ -48305,41 +48949,15 @@ class CoderRunUiState extends EventEmitter {
      */
     getProgress() {
         var _a;
-        const stats = this.stats;
-        const totalPrompts = stats.done + stats.forAgent + stats.toBeWritten;
-        const sessionDone = Math.max(0, stats.done - ((_a = this.initialDone) !== null && _a !== void 0 ? _a : stats.done));
-        const sessionTotal = sessionDone + stats.forAgent;
-        const percentage = totalPrompts > 0 ? Math.round((stats.done / totalPrompts) * 100) : 0;
-        const wallMs = moment().diff(this.startTime);
-        const currentPauseMs = this.pausedSince !== undefined ? moment().diff(this.pausedSince) : 0;
-        const activeMs = Math.max(0, wallMs - this.pausedMs - currentPauseMs);
-        const elapsedDuration = moment.duration(activeMs);
-        const elapsedText = formatDurationBrief(elapsedDuration);
-        let estimatedTotalText = '\u2014';
-        let estimatedLabel = 'unknown';
-        if (totalPrompts > 0 && stats.done > 0) {
-            const estimatedTotalMs = (elapsedDuration.asMilliseconds() * totalPrompts) / stats.done;
-            const estimatedRemainingMs = estimatedTotalMs - elapsedDuration.asMilliseconds();
-            const estimatedTotalDuration = moment.duration(estimatedTotalMs);
-            const estimatedCompletion = moment().add(estimatedRemainingMs, 'milliseconds');
-            estimatedTotalText = formatDurationBrief(estimatedTotalDuration);
-            estimatedLabel = estimatedCompletion.calendar(null, ESTIMATED_DONE_CALENDAR_FORMATS);
-        }
-        return {
-            totalPrompts,
-            sessionDone,
-            sessionTotal,
-            percentage,
-            elapsedText,
-            estimatedTotalText,
-            estimatedLabel,
-        };
+        return buildCoderRunProgressSnapshot(this.stats, this.timer.getElapsedDuration(), (_a = this.initialDone) !== null && _a !== void 0 ? _a : this.stats.done);
     }
     /**
      * Sets the label of the prompt currently being processed and resets per-prompt state.
      */
     setCurrentPrompt(label) {
         this.currentPromptLabel = label;
+        this.detailLines = [];
+        this.pendingEnterLabel = undefined;
         this.agentOutputLines = [];
         this.currentAttempt = 1;
         this.emitChange();
@@ -48379,6 +48997,20 @@ class CoderRunUiState extends EventEmitter {
         this.statusMessage = message;
         this.emitChange();
     }
+    /**
+     * Replaces the contextual detail lines shown beneath the current prompt status.
+     */
+    setDetailLines(detailLines) {
+        this.detailLines = detailLines.filter((detailLine) => detailLine.trim() !== '');
+        this.emitChange();
+    }
+    /**
+     * Sets or clears the Enter-key action label shown in the controls panel.
+     */
+    setPendingEnterLabel(pendingEnterLabel) {
+        this.pendingEnterLabel = pendingEnterLabel;
+        this.emitChange();
+    }
     /**
      * Appends an error message to the error list shown in the UI.
      */
@@ -48390,31 +49022,6 @@ class CoderRunUiState extends EventEmitter {
         this.emit('change');
     }
 }
-/**
- * Formats a duration into a compact string such as "3h 12m" or "45s".
- *
- * @private internal utility of coder run UI
- */
-function formatDurationBrief(duration) {
-    const totalSeconds = Math.max(0, Math.round(duration.asSeconds()));
-    const hours = Math.floor(totalSeconds / 3600);
-    const minutes = Math.floor((totalSeconds % 3600) / 60);
-    const seconds = totalSeconds % 60;
-    const parts = [];
-    if (hours > 0) {
-        parts.push(`${hours}h`);
-    }
-    if (minutes > 0) {
-        parts.push(`${minutes}m`);
-    }
-    if (!parts.length && seconds > 0) {
-        parts.push(`${seconds}s`);
-    }
-    if (!parts.length) {
-        parts.push('0s');
-    }
-    return parts.join(' ');
-}
 
 /**
  * Refresh interval for the terminal UI in milliseconds.
@@ -48422,18 +49029,6 @@ function formatDurationBrief(duration) {
  * @private internal constant of coder run UI
  */
 const UI_REFRESH_INTERVAL_MS = 200;
-/**
- * Character width used for the text progress bar.
- *
- * @private internal constant of coder run UI
- */
-const PROGRESS_BAR_WIDTH = 40;
-/**
- * Maximum number of output lines reserved for agent output in the UI.
- *
- * @private internal constant of coder run UI
- */
-const MAX_VISIBLE_OUTPUT_LINES = 8;
 /**
  * Spinner animation frames.
  *
@@ -48452,31 +49047,12 @@ const SPINNER_FRAMES = [
     '\u280F',
 ];
 /**
- * Strips ANSI escape codes from a string.
- *
- * @private internal utility of coder run UI
- */
-function stripAnsi(text) {
-    // eslint-disable-next-line no-control-regex
-    return text.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, '');
-}
-/**
- * Returns the usable terminal width, capped at 80.
+ * Returns the usable terminal width, capped at 96.
  *
  * @private internal utility of coder run UI
  */
 function getTerminalWidth() {
-    return Math.min(process.stdout.columns || 80, 80);
-}
-/**
- * Builds a text progress bar string from a percentage.
- *
- * @private internal utility of coder run UI
- */
-function buildProgressBar(percentage) {
-    const filled = Math.round((percentage / 100) * PROGRESS_BAR_WIDTH);
-    const empty = PROGRESS_BAR_WIDTH - filled;
-    return colors.green('\u2588'.repeat(filled)) + colors.gray('\u2591'.repeat(empty)) + ` ${percentage}%`;
+    return Math.min(process.stdout.columns || 80, 96);
 }
 /**
  * Boots the ANSI terminal UI for `ptbk coder run`.
@@ -48497,21 +49073,20 @@ function renderCoderRunUi(startTime) {
             state,
             startCapturingAgentOutput: () => { },
             stopCapturingAgentOutput: () => { },
+            waitForEnter: async () => { },
             cleanup: () => { },
         };
     }
-    // --- Console interception ---
     const originalConsoleInfo = console.info;
     const originalConsoleWarn = console.warn;
     const originalConsoleError = console.error;
     const originalConsoleLog = console.log;
     let isCapturing = false;
+    let pendingEnterResolver;
     console.info = (...args) => {
         if (isCapturing) {
             state.addAgentOutput(args.map(String).join(' '));
         }
-        // In UI mode, non-captured output is intentionally suppressed
-        // so it does not interfere with the repainted frame.
     };
     console.warn = (...args) => {
         if (isCapturing) {
@@ -48528,29 +49103,11 @@ function renderCoderRunUi(startTime) {
             state.addAgentOutput(args.map(String).join(' '));
         }
     };
-    // --- Keyboard input (pause) ---
     const readline = require('readline');
     readline.emitKeypressEvents(process.stdin);
     if (process.stdin.isTTY) {
         process.stdin.setRawMode(true);
     }
-    const keypressHandler = (_str, key) => {
-        if (key.ctrl && key.name === 'c') {
-            cleanup();
-            process.exit(0);
-        }
-        if (key.name === 'p') {
-            const current = getPauseState();
-            if (current === 'RUNNING') {
-                requestPause();
-            }
-            else {
-                requestResume();
-            }
-        }
-    };
-    process.stdin.on('keypress', keypressHandler);
-    // --- Rendering ---
     let spinnerFrame = 0;
     let previousFrameLineCount = 0;
     let isRendering = false;
@@ -48578,8 +49135,22 @@ function renderCoderRunUi(startTime) {
         }
         isRendering = true;
         try {
-            const lines = buildFrame();
-            // Move cursor up to clear the previous frame.
+            const lines = buildCoderRunUiFrame({
+                terminalWidth: getTerminalWidth(),
+                spinner: SPINNER_FRAMES[spinnerFrame],
+                pauseState: getPauseState(),
+                config: state.config,
+                phase: state.phase,
+                currentPromptLabel: state.currentPromptLabel,
+                currentAttempt: state.currentAttempt,
+                maxAttempts: state.maxAttempts,
+                statusMessage: state.statusMessage,
+                detailLines: state.detailLines,
+                pendingEnterLabel: state.pendingEnterLabel,
+                agentOutputLines: state.agentOutputLines,
+                errors: state.errors,
+                progress: state.getProgress(),
+            });
             if (previousFrameLineCount > 0) {
                 process.stdout.write(`\x1b[${previousFrameLineCount}A`);
             }
@@ -48591,14 +49162,12 @@ function renderCoderRunUi(startTime) {
                     process.stdout.write('\n');
                 }
             }
-            // Clear any leftover lines from a previous longer frame.
             if (lines.length < previousFrameLineCount) {
                 for (let i = lines.length; i < previousFrameLineCount; i++) {
                     process.stdout.write('\n');
                     clearLine(process.stdout, 0);
                     cursorTo(process.stdout, 0);
                 }
-                // Move back up to the end of the current frame.
                 const overshoot = previousFrameLineCount - lines.length;
                 if (overshoot > 0) {
                     process.stdout.write(`\x1b[${overshoot}A`);
@@ -48611,94 +49180,35 @@ function renderCoderRunUi(startTime) {
             isRendering = false;
         }
     }
-    /**
-     * Builds the complete frame as an array of terminal lines.
-     */
-    function buildFrame() {
-        const w = getTerminalWidth();
-        const sep = colors.gray('\u2500'.repeat(w - 2));
-        const spinner = SPINNER_FRAMES[spinnerFrame];
-        const { config, phase, currentPromptLabel, currentAttempt, maxAttempts, statusMessage, agentOutputLines, errors, } = state;
-        const progress = state.getProgress();
-        const isPaused = getPauseState() !== 'RUNNING';
-        const isActive = phase === 'running' || phase === 'verifying' || phase === 'loading';
-        const lines = [];
-        // --- Branding ---
-        lines.push(colors.bold.cyan('\u2728 Promptbook Coder'));
-        // --- Config ---
-        let configLine1 = `Agent: ${colors.bold.green(config.agentName)}`;
-        if (config.modelName) {
-            configLine1 += `  \u2502  Model: ${colors.bold(config.modelName)}`;
-        }
-        if (config.thinkingLevel) {
-            configLine1 += `  \u2502  Thinking: ${colors.bold(config.thinkingLevel)}`;
-        }
-        lines.push(configLine1);
-        let configLine2 = '';
-        if (config.context) {
-            configLine2 += `Context: ${colors.yellow(config.context)}  \u2502  `;
-        }
-        configLine2 += `Priority: \u2265${config.priority}`;
-        if (config.testCommand) {
-            configLine2 += `  \u2502  Test: ${colors.gray(config.testCommand)}`;
-        }
-        lines.push(configLine2);
-        // --- Separator ---
-        lines.push(sep);
-        // --- Progress ---
-        const progressSummary = [
-            `${progress.sessionDone}/${progress.sessionTotal} Prompts (${progress.totalPrompts} total)`,
-            `${progress.elapsedText}/${progress.estimatedTotalText}`,
-            `Est. done ${progress.estimatedLabel}`,
-        ].join(' \u2502 ');
-        lines.push(progressSummary);
-        lines.push(buildProgressBar(progress.percentage));
-        // --- Separator ---
-        lines.push(sep);
-        // --- Current prompt ---
-        if (currentPromptLabel) {
-            const spinnerPrefix = isActive ? colors.yellow(`${spinner} `) : '  ';
-            lines.push(spinnerPrefix + colors.bold(currentPromptLabel));
-            lines.push(colors.gray(`Attempt ${currentAttempt}/${maxAttempts} \u2502 ${statusMessage}`));
+    const keypressHandler = (_str, key) => {
+        if (key.ctrl && key.name === 'c') {
+            cleanup();
+            process.exit(0);
         }
-        else {
-            lines.push(colors.gray(statusMessage));
-        }
-        // --- Agent output ---
-        if (agentOutputLines.length > 0) {
-            lines.push('');
-            lines.push(colors.gray.bold('Agent output:'));
-            const visibleLines = agentOutputLines.slice(-MAX_VISIBLE_OUTPUT_LINES);
-            for (const line of visibleLines) {
-                const cleanLine = stripAnsi(line);
-                // Truncate to terminal width.
-                const truncated = cleanLine.length > w - 2 ? cleanLine.slice(0, w - 5) + '...' : cleanLine;
-                lines.push(colors.gray(truncated));
-            }
-        }
-        // --- Errors ---
-        if (errors.length > 0) {
-            lines.push('');
-            for (const err of errors) {
-                lines.push(colors.red(`\u2717 ${err}`));
-            }
-        }
-        // --- Separator ---
-        lines.push(sep);
-        // --- Controls ---
-        const pauseLabel = isPaused
-            ? colors.bgYellow.black(' PAUSED ') + colors.gray(' [P] Resume  \u2502  Ctrl+C Exit')
-            : colors.gray('[P] Pause  \u2502  Ctrl+C Exit');
-        lines.push(pauseLabel);
-        return lines;
-    }
-    // Initial render.
+        if (key.name === 'p') {
+            if (getPauseState() === 'RUNNING') {
+                requestPause();
+            }
+            else {
+                requestResume();
+            }
+            return;
+        }
+        if ((key.name === 'return' || key.name === 'enter') && pendingEnterResolver) {
+            const resolvePendingEnter = pendingEnterResolver;
+            pendingEnterResolver = undefined;
+            state.setPendingEnterLabel(undefined);
+            resolvePendingEnter();
+        }
+    };
+    process.stdin.on('keypress', keypressHandler);
     process.stdout.write('\n');
     render();
     const interval = setInterval(scheduleRender, UI_REFRESH_INTERVAL_MS);
-    // Listen for state changes and schedule a re-render (debounced).
     state.on('change', scheduleRender);
-    // --- Cleanup ---
+    /**
+     * Tears down the terminal UI and restores console / stdin state.
+     */
     function cleanup() {
         clearInterval(interval);
         state.off('change', scheduleRender);
@@ -48706,12 +49216,14 @@ function renderCoderRunUi(startTime) {
         if (process.stdin.isTTY) {
             process.stdin.setRawMode(false);
         }
+        const resolvePendingEnter = pendingEnterResolver;
+        pendingEnterResolver = undefined;
+        resolvePendingEnter === null || resolvePendingEnter === void 0 ? void 0 : resolvePendingEnter();
         isCapturing = false;
         console.info = originalConsoleInfo;
         console.warn = originalConsoleWarn;
         console.error = originalConsoleError;
         console.log = originalConsoleLog;
-        // Render one final frame so the user sees the last state.
         render();
         process.stdout.write('\n');
     }
@@ -48723,6 +49235,19 @@ function renderCoderRunUi(startTime) {
         stopCapturingAgentOutput() {
             isCapturing = false;
         },
+        waitForEnter(actionLabel) {
+            if (pendingEnterResolver) {
+                throw new Error('Coder run UI is already waiting for Enter.');
+            }
+            state.setPendingEnterLabel(actionLabel);
+            scheduleRender();
+            return new Promise((resolve) => {
+                pendingEnterResolver = () => {
+                    scheduleRender();
+                    resolve();
+                };
+            });
+        },
         cleanup,
     };
 }
@@ -48790,11 +49315,11 @@ async function runCodexPrompts(providedOptions) {
             `));
     }
     const runStartDate = moment();
-    const isUiMode = !options.dryRun && Boolean(process.stdout.isTTY);
-    const progressDisplay = options.dryRun || isUiMode ? undefined : new CliProgressDisplay(runStartDate);
-    const uiHandle = isUiMode ? renderCoderRunUi(runStartDate) : undefined;
+    const isRichUiEnabled = !options.dryRun && !options.noUi && Boolean(process.stdout.isTTY);
+    const progressDisplay = options.dryRun || options.noUi || isRichUiEnabled ? undefined : new CliProgressDisplay(runStartDate, options.priority);
+    const uiHandle = isRichUiEnabled ? renderCoderRunUi(runStartDate) : undefined;
     // When the Ink UI is active it handles keyboard input itself, so skip the raw stdin listener.
-    if (!isUiMode) {
+    if (!isRichUiEnabled) {
         listenForPause();
     }
     try {
@@ -48910,17 +49435,19 @@ async function runCodexPrompts(providedOptions) {
         let hasWaitedForStart = false;
         while (just(true)) {
             await checkPause({
-                silent: isUiMode,
+                silent: isRichUiEnabled,
                 onPaused: () => {
+                    progressDisplay === null || progressDisplay === void 0 ? void 0 : progressDisplay.pauseTimer();
                     uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.pauseTimer();
                     uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setPhase('paused');
                     uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setStatusMessage('Paused');
                 },
                 onResumed: () => {
+                    progressDisplay === null || progressDisplay === void 0 ? void 0 : progressDisplay.resumeTimer();
                     uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.resumeTimer();
                 },
             });
-            if (isUiMode) {
+            if (isRichUiEnabled) {
                 uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setPhase('loading');
                 uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setStatusMessage('Loading prompts...');
             }
@@ -48928,17 +49455,17 @@ async function runCodexPrompts(providedOptions) {
             const stats = summarizePrompts(promptFiles, options.priority);
             progressDisplay === null || progressDisplay === void 0 ? void 0 : progressDisplay.update(stats);
             uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.updateProgress(stats);
-            if (!isUiMode) {
+            if (!isRichUiEnabled) {
                 printStats(stats, options.priority);
             }
             const nextPrompt = findNextTodoPrompt(promptFiles, options.priority);
             if (!hasShownUpcomingTasks) {
-                if (stats.toBeWritten > 0 && !isUiMode) {
+                if (stats.toBeWritten > 0 && !isRichUiEnabled) {
                     console.info(colors.yellow('Following prompts need to be written:'));
                     printPromptsToBeWritten(promptFiles, options.priority);
                     console.info('');
                 }
-                if (!isUiMode) {
+                if (!isRichUiEnabled) {
                     printUpcomingTasks(listUpcomingTasks(promptFiles, options.priority));
                 }
                 hasShownUpcomingTasks = true;
@@ -48948,7 +49475,7 @@ async function runCodexPrompts(providedOptions) {
                     const message = 'No prompts ready for agent.';
                     uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setStatusMessage(message);
                     uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setPhase('done');
-                    if (!isUiMode) {
+                    if (!isRichUiEnabled) {
                         console.info(colors.yellow(message));
                     }
                 }
@@ -48956,16 +49483,28 @@ async function runCodexPrompts(providedOptions) {
                     const message = 'All prompts are done.';
                     uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setStatusMessage(message);
                     uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setPhase('done');
-                    if (!isUiMode) {
+                    if (!isRichUiEnabled) {
                         console.info(colors.green(message));
                     }
                 }
                 return;
             }
+            const promptLabel = buildPromptLabelForDisplay(nextPrompt.file, nextPrompt.section);
             if (options.waitForUser) {
+                progressDisplay === null || progressDisplay === void 0 ? void 0 : progressDisplay.pauseTimer();
                 uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.pauseTimer();
-                uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setStatusMessage(hasWaitedForStart ? 'Waiting... Press Enter to continue' : 'Waiting... Press Enter to start');
-                await waitForPromptStart(nextPrompt.file, nextPrompt.section, !hasWaitedForStart);
+                uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setCurrentPrompt(promptLabel);
+                uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setPhase('waiting');
+                uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setStatusMessage(hasWaitedForStart ? 'Waiting for confirmation to continue' : 'Waiting for confirmation to start');
+                uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setDetailLines([buildPromptSummary(nextPrompt.file, nextPrompt.section)]);
+                if (isRichUiEnabled) {
+                    await (uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.waitForEnter(hasWaitedForStart ? 'Continue' : 'Start'));
+                }
+                else {
+                    await waitForPromptStart(nextPrompt.file, nextPrompt.section, !hasWaitedForStart);
+                }
+                uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setDetailLines([]);
+                progressDisplay === null || progressDisplay === void 0 ? void 0 : progressDisplay.resumeTimer();
                 uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.resumeTimer();
                 hasWaitedForStart = true;
             }
@@ -48975,8 +49514,7 @@ async function runCodexPrompts(providedOptions) {
             const commitMessage = buildCommitMessage(nextPrompt.file, nextPrompt.section);
             const codexPrompt = appendCoderContext(buildCodexPrompt(nextPrompt.file, nextPrompt.section), resolvedCoderContext);
             const scriptPath = buildScriptPath(nextPrompt.file, nextPrompt.section);
-            const promptLabel = buildPromptLabelForDisplay(nextPrompt.file, nextPrompt.section);
-            if (isUiMode) {
+            if (isRichUiEnabled) {
                 uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setCurrentPrompt(promptLabel);
                 uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setPhase('running');
                 uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setStatusMessage('Running');
@@ -48989,55 +49527,71 @@ async function runCodexPrompts(providedOptions) {
             const roundChangedFilesSnapshot = options.normalizeLineEndings
                 ? await captureChangedFilesSnapshot(process.cwd())
                 : undefined;
-            try {
-                uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.startCapturingAgentOutput();
-                const result = await runPromptWithTestFeedback({
-                    runner,
-                    prompt: codexPrompt,
-                    scriptPath,
-                    projectPath: process.cwd(),
-                    promptLabel,
-                    testCommand: options.testCommand,
-                    onAttemptStarted: (nextAttemptCount) => {
-                        attemptCount = nextAttemptCount;
-                        uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setAttempt(nextAttemptCount);
-                        if (nextAttemptCount > 1) {
-                            uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setStatusMessage(`Retrying (attempt ${nextAttemptCount})`);
-                            uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setPhase('verifying');
+            await withPromptRuntimeLog(scriptPath, async (logPath) => {
+                try {
+                    uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.startCapturingAgentOutput();
+                    const result = await runPromptWithTestFeedback({
+                        runner,
+                        prompt: codexPrompt,
+                        scriptPath,
+                        projectPath: process.cwd(),
+                        promptLabel,
+                        testCommand: options.testCommand,
+                        preserveArtifactsOnSuccess: options.preserveLogs,
+                        logPath,
+                        onAttemptStarted: (nextAttemptCount) => {
+                            attemptCount = nextAttemptCount;
+                            uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setAttempt(nextAttemptCount);
+                            if (nextAttemptCount > 1) {
+                                uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setStatusMessage(`Retrying (attempt ${nextAttemptCount})`);
+                                uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setPhase('verifying');
+                            }
+                        },
+                    });
+                    uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.stopCapturingAgentOutput();
+                    uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setStatusMessage('Committing changes');
+                    markPromptDone(nextPrompt.file, nextPrompt.section, result.usage, runnerMetadata.runnerName, runnerMetadata.modelName, promptExecutionStartedDate, result.attemptCount);
+                    await writePromptFile(nextPrompt.file);
+                    await normalizeLineEndingsForCurrentRound(options, roundChangedFilesSnapshot);
+                    if (options.waitForUser) {
+                        progressDisplay === null || progressDisplay === void 0 ? void 0 : progressDisplay.pauseTimer();
+                        uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.pauseTimer();
+                        uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setPhase('waiting');
+                        uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setStatusMessage('Review the commit preview and confirm to continue');
+                        if (isRichUiEnabled) {
+                            uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setDetailLines(formatCommitMessageForDisplay(commitMessage)
+                                .split(/\r?\n/)
+                                .map((line) => line.trim()));
+                            await (uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.waitForEnter('Commit'));
+                            uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setDetailLines([]);
                         }
-                    },
-                });
-                uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.stopCapturingAgentOutput();
-                uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setStatusMessage('Committing changes');
-                markPromptDone(nextPrompt.file, nextPrompt.section, result.usage, runnerMetadata.runnerName, runnerMetadata.modelName, promptExecutionStartedDate, result.attemptCount);
-                await writePromptFile(nextPrompt.file);
-                await normalizeLineEndingsForCurrentRound(options, roundChangedFilesSnapshot);
-                if (options.waitForUser) {
-                    uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.pauseTimer();
-                    uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setStatusMessage('Waiting... Press Enter to commit');
-                    printCommitMessage(commitMessage);
-                    await waitForEnter(colors.bgWhite('Press Enter to commit and continue...'));
-                    uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.resumeTimer();
+                        else {
+                            printCommitMessage(commitMessage);
+                            await waitForEnter(colors.bgWhite('Press Enter to commit and continue...'));
+                        }
+                        progressDisplay === null || progressDisplay === void 0 ? void 0 : progressDisplay.resumeTimer();
+                        uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.resumeTimer();
+                    }
+                    await commitChanges(commitMessage, { autoPush: options.autoPush });
+                    await runPostPromptAutoMigrationIfEnabled(options);
                 }
-                await commitChanges(commitMessage, { autoPush: options.autoPush });
-                await runPostPromptAutoMigrationIfEnabled(options);
-            }
-            catch (error) {
-                uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.stopCapturingAgentOutput();
-                uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setPhase('error');
-                uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.addError(error instanceof Error ? error.message : String(error));
-                markPromptFailed(nextPrompt.file, nextPrompt.section, runnerMetadata.runnerName, runnerMetadata.modelName, promptExecutionStartedDate, attemptCount);
-                await writePromptFile(nextPrompt.file);
-                await writePromptErrorLog({
-                    file: nextPrompt.file,
-                    section: nextPrompt.section,
-                    runnerName: runnerMetadata.runnerName,
-                    modelName: runnerMetadata.modelName,
-                    error,
-                });
-                await normalizeLineEndingsForCurrentRound(options, roundChangedFilesSnapshot);
-                throw error;
-            }
+                catch (error) {
+                    uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.stopCapturingAgentOutput();
+                    uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setPhase('error');
+                    uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.addError(error instanceof Error ? error.message : String(error));
+                    markPromptFailed(nextPrompt.file, nextPrompt.section, runnerMetadata.runnerName, runnerMetadata.modelName, promptExecutionStartedDate, attemptCount);
+                    await writePromptFile(nextPrompt.file);
+                    await writePromptErrorLog({
+                        file: nextPrompt.file,
+                        section: nextPrompt.section,
+                        runnerName: runnerMetadata.runnerName,
+                        modelName: runnerMetadata.modelName,
+                        error,
+                    });
+                    await normalizeLineEndingsForCurrentRound(options, roundChangedFilesSnapshot);
+                    throw error;
+                }
+            }, { preserveArtifactsOnSuccess: options.preserveLogs });
         }
     }
     finally {