codex-overleaf-link 2.4.1 → 2.5.1

package/extension/src/content/runTimelineView.js

@@ -1,21 +1,27 @@
-(function initCodexOverleafRunTimelineView() {
+(function (root, factory) {
+  if (typeof module === 'object' && module.exports) module.exports = factory(require('./runRecoveryActions'));
+  else root.CodexOverleafModuleRegistry.define('RunTimelineView', ['RunRecoveryActions'], factory);
+})(typeof window !== 'undefined' ? window : globalThis, function (RunRecoveryActions) {
   'use strict';
 
-  // Run-timeline view — the timeline render pipeline carved out of
-  // contentRuntime.js (v1.4.6 structural-debt phase 2): the scroll engine +
-  // jump-to-latest button, the live-elapsed tick and collapsed-header summary,
-  // run-card / stream-event / activity rendering, the completion report, and
-  // the run-card Undo/Accept controls. Code moved verbatim (original
-  // indentation kept); runtime collaborators are factory-injected and mutable
-  // runtime state (panel, panel state, the live run view) is read through lazy
-  // getters. The view-local scroll/timer state below moved here with the code
-  // that owns it.
+
+  // Owns scroll, cards, reports and mature run actions. The optional activity
+  // presenter projects stored events without taking ownership of settlement.
   function create(deps = {}) {
     const {
+      RunActivitySummary,
+      RunPresence,
+      RunActivityModel,
+      SubagentActivityView,
       RunGuidanceView,
+      getPendingGuidance = () => [],
       RunResultActions,
       RunScrollLayout,
       RunFailureNotice,
+      I18n,
+      FailureReasons,
+      localizeVisibleReason = value => value,
+      localizeCompileReason = value => value,
       tr,
       tx,
       getLocale,
@@ -25,6 +31,7 @@
       formatEventDetail,
       formatEventTime,
       renderAttachmentPreviewList,
+      renderSentSelection,
       formatModeLabel,
       undoRun,
       acceptRun,
@@ -41,11 +48,16 @@
       getState,
       getCurrentRunView,
       refillComposerForRetry,
+      canEditRun,
+      retryWriteback,
       showNativeSetupGuidance,
       openProjectFileForFailure,
       openStorageSettings,
       trackedChangeInFlight,
-      projectRunSettlement
+      projectRunSettlement,
+      getCurrentProjectId,
+      getAccountScopeId,
+      getProjectName
     } = deps;
 
   let logAutoFollow = true;
@@ -57,11 +69,10 @@
   // drives the floating "jump to latest" button's counter.
   let scrollLogRafId = 0;
   let scrollLogPendingForce = false;
+  let pendingGuidanceReveal = null;
   let jumpToLatestButton = null;
   let unreadSinceDetach = 0;
-  // Live-elapsed tick for the sticky run-process header. Without it the header
-  // reads a static "Processing…" and the user can't tell a working run from a
-  // hung one — the single highest-value streaming signal per competitor UX.
+  // Elapsed time belongs to the run; tool rows retain their own lifecycle.
   let runElapsedTimer = null;
   const scrollLayout = RunScrollLayout?.create({
     getScroller: getLogScrollContainer,
@@ -69,12 +80,32 @@
     onLayoutChange: scroller => logAutoFollow ? scrollLogToBottom() : updateJumpToLatestButton(scroller)
   });
   const failureNotice = RunFailureNotice?.create({ tr, projectRunSettlement, sanitizeText: sanitizeAssistantVisibleText });
+  const { buildRecoveryButton, appendRecoveryActionForFailure } = RunRecoveryActions.create({
+    document: typeof document === 'undefined' ? undefined : document,
+    window: typeof window === 'undefined' ? undefined : window,
+    tx, failureNotice, refillComposerForRetry, openProjectFileForFailure, showNativeSetupGuidance,
+    openStorageSettings, forceCancelStuckTaskForCurrentProject
+  });
+  const presence = RunPresence?.create({ tx, getLocale, formatElapsed });
+  const displayRun = run => RunFailureNotice?.projectResolvedUndo?.(run) || run;
+  const displayLocalizedRun = run => {
+    const displayed = displayRun(run);
+    return displayed ? { ...displayed, events: (displayed.events || []).map(sanitizeRunEventForRender) } : displayed;
+  };
+  const activitySummary = RunActivitySummary?.create({ RunActivityModel, RunGuidanceView, getPendingGuidance, SubagentActivityView, tx, findRunRecord: (...args) => displayLocalizedRun(findRunRecord(...args)), getPanel, cssEscape,
+    projectReviewResultEvent: sanitizeRunEventForRender,
+    formatReviewResultFailure,
+    formatEventTime, formatElapsed, renderMarkdownBlockText, renderRunEvent, formatEventDetail,
+    presence, classifyStatus: classifyRunPresence, getProjectId: () => getCurrentProjectId?.() || '',
+    summarizeCommand: RunPresence?.commandSummary,
+    isGuidance: event => Boolean(RunGuidanceView.getGuidanceText(event)), sanitizeAssistantVisibleText });
 
   // Re-arm auto-follow (called by the runtime when a new run starts, so the
   // log snaps back to following the live stream).
   function resetAutoFollow() {
     logAutoFollow = true;
     userScrollIntentUntil = 0;
+    pendingGuidanceReveal = null;
   }
 
   function bindLogAutoFollow() {
@@ -176,6 +207,7 @@
     if ((event?.type === 'wheel' && event.deltaY < 0) || ['ArrowUp', 'PageUp', 'Home'].includes(event?.key)) {
       logAutoFollow = false;
       scrollLogPendingForce = false;
+      pendingGuidanceReveal = null;
     }
   }
 
@@ -187,6 +219,7 @@
   }
 
   function scrollLogToBottom(options = {}) {
+    if (activitySummary?.isSubagentViewOpen?.()) return;
     const scroller = getLogScrollContainer();
     if (!scroller) {
       return;
@@ -199,6 +232,7 @@
       userScrollIntentUntil = 0;
       unreadSinceDetach = 0;
       scrollLogPendingForce = true;
+      pendingGuidanceReveal = null;
     } else if (!logAutoFollow) {
       // The user has scrolled up: do not yank them. Just keep the jump button
       // state current.
@@ -233,10 +267,25 @@
       writeNow();
     });
   }
+  function revealGuidance(row) {
+    if (!logAutoFollow || activitySummary?.isSubagentViewOpen?.() || !getLogScrollContainer()?.contains?.(row)) return false;
+    pendingGuidanceReveal = row;
+    scrollLogToBottom();
+    return true;
+  }
   function setLogScrollPosition(scroller) {
+    const reveal = pendingGuidanceReveal;
+    pendingGuidanceReveal = null;
+    const result = reveal && scrollLayout?.revealGuidance(reveal);
+    if (result) {
+      logAutoFollow = result.following;
+      if (!logAutoFollow) scrollLayout.captureAnchor(true);
+      return;
+    }
     scroller.scrollTop = scroller.scrollHeight;
   }
   function collapseRunProcess(view, statusText) {
+    if (activitySummary) { activitySummary.settle(view, statusText); return; }
     const runProcess = view?.runProcess || view?.root?.querySelector('[data-run-process]');
     if (runProcess) {
       runProcess.open = false;
@@ -245,23 +294,15 @@
     if (statusEl) {
       // Append the step count to the collapsed header ("Processed 18s · 6 steps")
       // so the user sees how much work the run did without expanding it.
-      const stepCount = countRunActivitySteps(view);
+      const record = view?.recordId ? findRunRecord(view.recordId, view.sessionId) : null;
+      const stepCount = (record?.events || []).filter(event => (event.kind || 'activity') === 'activity').length;
       statusEl.textContent = stepCount > 0
         ? `${statusText} · ${tx(`${stepCount} steps`, `${stepCount} 步`)}`
         : statusText;
     }
   }
 
-  function countRunActivitySteps(view) {
-    const record = view?.recordId ? findRunRecord(view.recordId, view.sessionId) : null;
-    if (!Array.isArray(record?.events)) {
-      return 0;
-    }
-    return record.events.filter(event => (event.kind || 'activity') === 'activity').length;
-  }
-
-  // The sticky run-process header shows a live "Processing… {elapsed}" while a
-  // run is in flight so the user can distinguish a working run from a hung one.
+  // Keep elapsed labels live without creating new activity records.
   function startRunElapsedTick() {
     stopRunElapsedTick();
     if (typeof window.setInterval !== 'function') {
@@ -272,6 +313,7 @@
         stopRunElapsedTick();
         return;
       }
+      if (activitySummary?.update(getCurrentRunView()) && presence) return;
       const statusEl = getCurrentRunView().status
         || getCurrentRunView().root?.querySelector('[data-run-status]');
       if (statusEl) {
@@ -289,6 +331,13 @@
     runElapsedTimer = null;
   }
 
+  function classifyRunPresence(run = {}) {
+    if (run.retryingWriteback) return 'plain';
+    if (run.status === 'completed') return 'done';
+    if (run.status === 'cancelled' || run.status === 'rejected') return 'stopped';
+    return run.status === 'failed' || run.status === 'abandoned_after_navigation' ? 'failed' : 'plain';
+  }
+
   function formatProcessedSummary(status, elapsedMs) {
     const elapsed = formatElapsed(elapsedMs);
     if (status === 'failed') {
@@ -303,6 +352,7 @@
     return tr('processed', { elapsed });
   }
   function renderRunHistory(options = {}) {
+    activitySummary?.closeSubagentView?.();
     const log = getPanel()?.querySelector('[data-log]');
     if (!log) {
       return;
@@ -323,7 +373,12 @@
       const hint = document.createElement('div');
       hint.className = 'empty-runs-hint';
       hint.textContent = tr('emptyRunsHint');
+      label.className = 'empty-runs-title';
       empty.append(icon, label, hint);
+      if (presence) {
+        icon.remove();
+        presence.decorateEmpty(empty, { projectName: getProjectName?.() || '' });
+      }
       log.append(empty);
       return;
     }
@@ -342,6 +397,7 @@
   }
 
   function renderRunCard(run) {
+    run = displayLocalizedRun(run);
     const root = document.createElement('section');
     root.className = 'transcript-turn run-card';
     root.dataset.status = run.status || 'completed';
@@ -356,11 +412,14 @@
     root.innerHTML = `
       <div class="transcript-turn-main">
         <div class="run-attachments codex-attachment-preview-list" data-run-attachments hidden></div>
+        <div class="run-selection" data-run-selection hidden></div>
         <div class="run-prompt" data-run-task></div>
         <div class="run-guidance-list" data-run-guidance></div>
         <div class="run-turn-meta">
           <button type="button" data-run-accept hidden title="Accept this run's tracked changes in Overleaf">Accept changes</button>
           <button type="button" data-run-undo hidden title="Undo this run's writes to Overleaf">Undo</button>
+          <button type="button" class="run-copy-action run-edit-action" data-run-edit hidden></button>
+          <button type="button" class="run-copy-action run-sync-action" data-run-sync-retry hidden></button>
         </div>
         <details class="run-process" data-run-process>
           <summary data-run-process-summary>
@@ -379,6 +438,7 @@
     `;
 
     renderAttachmentPreviewList(run.attachments, root.querySelector('[data-run-attachments]'), { readonly: true });
+    renderSentSelection?.(root.querySelector('[data-run-selection]'), run.executionSnapshot?.selectionContext, { document, tx });
     const runTask = root.querySelector('[data-run-task]');
     runTask.classList.add('run-user-message');
     runTask.textContent = run.task || '';
@@ -398,42 +458,41 @@
       truncated.textContent = tr('eventsTruncatedNote');
       events.append(truncated);
     }
-    const guidanceTarget = run.status === 'running' ? events : guidance;
-    const renderedGuidanceIds = new Set();
-    const completedLegacyGuidance = new Set((run.events || [])
-      .filter(event => event.kind === 'guidance' && !event.guidanceId && event.status === 'completed')
-      .map(event => event.title));
+    if (!activitySummary) RunGuidanceView.reconcileGuidance?.(guidance, (run.events || []).concat(getPendingGuidance(run)), tx, { active: run.status === 'running' });
     for (const event of run.events || []) {
       if (event.kind === 'report') {
         report.hidden = false;
         report.replaceChildren(renderCompletionReport(event, run));
-      } else if (event.kind === 'technical') {
+      } else if (activitySummary || event.kind === 'technical') {
         continue;
       } else if (RunGuidanceView.getGuidanceText(event)) {
-        if (event.guidanceId && renderedGuidanceIds.has(event.guidanceId)) {
-          continue;
-        }
-        if (!event.guidanceId && event.status === 'queued' && completedLegacyGuidance.has(event.title)) {
-          continue;
-        }
-        if (event.guidanceId) {
-          renderedGuidanceIds.add(event.guidanceId);
-        }
-        guidanceTarget.append(renderRunEvent(event));
+        continue;
       } else if (event.kind === 'stream') {
         upsertStreamEvent({ events }, event);
       } else {
-        events.append(renderRunEvent(event));
+        appendActivityDetail({ events }, renderRunEvent(event), event);
       }
     }
 
     RunResultActions.configureResultActions(root, run);
     configureAcceptButton(root, run);
     configureUndoButton(root, run);
+    configureEditButton(root, run);
+    configureWritebackButton(root, run);
+    activitySummary?.mount(root, run);
     return root;
   }
 
   function getRunStatusText(run = {}) {
+    if (run.retryingWriteback) return tx('Checking file sync', '正在检查文件同步');
+    if (['Stopped tracking after a page refresh', '页面刷新后已停止跟踪'].includes(run.statusText)) return tr('restoredRunStoppedStatus');
+    const knownStatus = /^(?:Done|Failed|Cancelled|Running|已处理|处理失败|已取消|处理中)(?:\s+[\d.]+(?:ms|s|m|h|秒|分钟)(?:\s+[\d.]+(?:ms|s|m|h|秒|分钟))*)?$/.test(run.statusText || '');
+    if (knownStatus) {
+      const elapsed = String(run.statusText).replace(/^(?:Done|Failed|Cancelled|Running|已处理|处理失败|已取消|处理中)\s*/, '');
+      const key = run.status === 'running' ? 'processing' : run.status === 'failed' ? 'processedFailed'
+        : ['rejected', 'cancelled'].includes(run.status) ? 'processedCancelled' : 'processed';
+      return tr(key, { elapsed }).trim();
+    }
     if (run.statusText) {
       return run.statusText;
     }
@@ -461,6 +520,7 @@
     if (!view?.events) {
       return;
     }
+    if (activitySummary?.update(view, event)) return;
     const streamKey = event.streamKey || event.streamRole || 'codex-stream';
     const selector = `[data-stream-key="${cssEscape(streamKey)}"]`;
     const existing = view.events.querySelector(selector);
@@ -477,7 +537,12 @@
       }
       return;
     }
-    view.events.append(renderStreamEvent({ ...event, streamKey }));
+    appendActivityDetail(view, renderStreamEvent({ ...event, streamKey }), event);
+  }
+
+  function appendActivityDetail(view, row, event) {
+    if (activitySummary) activitySummary.appendDetail(view, row, event);
+    else view.events.append(row);
   }
 
   function renderStreamEvent(input) {
@@ -504,18 +569,61 @@
   function sanitizeRunEventForRender(event = {}) {
     const streamRole = sanitizeAssistantVisibleText(event.streamRole);
     const title = sanitizeAssistantVisibleText(event.title);
+    const activity = !streamRole && (!event.kind || event.kind === 'activity') && !event.guidanceId;
+    const localized = activity ? localizeProductActivity(title, sanitizeAssistantVisibleValue(event.detail)) : null;
     return {
       ...event,
+      ...(activity && event.activity?.kind === 'compile' ? { activity: { ...event.activity, output: localizeCompileReason(event.activity.output) } } : {}),
       title: streamRole === 'reasoning'
         ? stripEmptyHtmlCommentPlaceholders(title)
-        : title,
+        : localized?.title || title,
       status: sanitizeAssistantVisibleText(event.status),
-      detail: sanitizeAssistantVisibleValue(event.detail),
+      detail: localized?.detail ?? sanitizeAssistantVisibleValue(event.detail),
       technicalDetail: sanitizeAssistantVisibleValue(event.technicalDetail),
       streamKey: sanitizeAssistantVisibleText(event.streamKey),
       streamRole
     };
   }
+
+  function localizeProductActivity(title, detail) {
+    let known = false, nextTitle = title;
+    const keys = ['undoUnsafeFullFileTitle', 'undoNoTraceTitle', 'undoFileSelectTitle', 'undoNoTraceStarted', 'undoTrackedTitle', 'undoNativeTitle', 'undoTrackedStarted', 'undoNativeStarted', 'undoSwitchedEditing', 'undoReviewingRestoreUnverified', 'runAcceptTrackedStarted', 'runAcceptTrackedFailed', 'undoResult', 'undoTrackedResult', 'undoNativeResult', 'runAcceptTrackedResult'];
+    if (I18n?.t) outer: for (const key of keys) for (const locale of ['en', 'zh']) {
+      const template = I18n.t(locale, key, { applied: '__APPLIED__', skipped: '__SKIPPED__' });
+      const pattern = template.replace(/[.*+?^${}()|[\]\\]/g, '\\$&').replace('__APPLIED__', '(\\d+)').replace('__SKIPPED__', '(\\d+)');
+      const match = new RegExp('^' + pattern + '$').exec(title);
+      if (match) { known = true; nextTitle = tr(key, { applied: match[1], skipped: match[2] }); break outer; }
+    }
+    let countedTitle;
+    const writeResult = /^(?:Write result: wrote (\d+) item\(s\), skipped (\d+)|写入结果：已写入 (\d+) 项，跳过 (\d+) 项)$/.exec(title);
+    const governance = /^(?:Project governance blocked (\d+) write\(s\) before review\.|项目治理规则在审核前阻止了 (\d+) 项写入。)$/.exec(title);
+    if (writeResult) {
+      const applied = writeResult[1] ?? writeResult[3], skipped = writeResult[2] ?? writeResult[4];
+      countedTitle = tx(`Write result: wrote ${applied} item(s), skipped ${skipped}`, `写入结果：已写入 ${applied} 项，跳过 ${skipped} 项`);
+    } else if (governance) {
+      const count = governance[1] ?? governance[2];
+      countedTitle = tx(`Project governance blocked ${count} write(s) before review.`, `项目治理规则在审核前阻止了 ${count} 项写入。`);
+    }
+    const labels = ['detailAccepted', 'detailRejected', 'detailUndone', 'detailSkipped', 'detailFile', 'detailRecord', 'detailReason'];
+    const project = (value, reason = false) => {
+      if (typeof value === 'string') return reason ? localizeVisibleReason(value) : value;
+      if (Array.isArray(value)) return value.map(item => project(item, reason));
+      if (!value || typeof value !== 'object') return value;
+      return Object.fromEntries(Object.entries(value).map(([key, child]) => {
+        const label = labels.find(id => ['en', 'zh'].some(locale => I18n?.t?.(locale, id) === key));
+        return [label ? tr(label) : key, project(child, label === 'detailReason')];
+      }));
+    };
+    return { title: countedTitle || (known ? nextTitle : localizeCompileReason(localizeVisibleReason(title))),
+      detail: typeof detail === 'string' ? localizeVisibleReason(detail) : known ? project(detail) : detail };
+  }
+  function formatReviewResultFailure(failure) {
+    if (failure?.code === 'unknown_legacy_failure' && (!failure.evidence?.originalCode || failure.evidence.originalCode === 'unknown_legacy_failure')
+      && ['Unknown reason', '未知原因'].includes(failure.userMessage)) {
+      failure = { ...failure, userMessage: tr('unknownReason') };
+    }
+    return FailureReasons?.formatFailureReasonForDisplay(failure, getLocale?.(), key => { const value = tr(key, failure?.file ? undefined : { file: tr('unknownFile'), activeFile: tr('unknownFile') }); return value && value !== key ? value : undefined; });
+  }
   function renderActivityLine(input) {
     const event = sanitizeRunEventForRender(input);
     const row = document.createElement('div');
@@ -543,54 +651,8 @@
     return row;
   }
 
-  function hasNonEmptyDetail(value) {
-    if (value === undefined || value === null || value === '') {
-      return false;
-    }
-    if (Array.isArray(value)) {
-      return value.length > 0;
-    }
-    if (typeof value === 'object') {
-      return Object.keys(value).length > 0;
-    }
-    return true;
-  }
-
-  function renderTechnicalEvent(event) {
-    const block = document.createElement('section');
-    block.className = 'run-technical-event';
-    block.dataset.status = event.status || 'info';
 
-    const title = document.createElement('div');
-    title.className = 'run-technical-event-title';
-    title.textContent = event.title || tr('technicalDetails');
-
-    const body = document.createElement('pre');
-    body.textContent = formatEventDetail(buildTechnicalEventDetail(event));
-    block.append(title, body);
-    return block;
-  }
 
-  function buildTechnicalEventDetail(event) {
-    if (event?.kind === 'technical') {
-      return event.detail || {};
-    }
-
-    const detail = {
-      [tx('Step', '步骤')]: event?.title || '',
-      [tx('Status', '状态')]: event?.status || ''
-    };
-    if (event?.timestamp) {
-      detail[tx('Time', '时间')] = formatEventTime(event.timestamp);
-    }
-    if (hasNonEmptyDetail(event?.detail)) {
-      detail[tx('Content', '内容')] = event.detail;
-    }
-    if (hasNonEmptyDetail(event?.technicalDetail)) {
-      detail[tx('Raw event', '原始事件')] = event.technicalDetail;
-    }
-    return detail;
-  }
 
   function buildActivityTooltip(event) {
     return [
@@ -599,71 +661,73 @@
     ].filter(Boolean).join('\n');
   }
 
-  // The trailing status sections emitted by formatHumanReport (agentTranscript):
-  // run metadata, not part of Codex's answer. Each entry matches the bilingual
-  // "Label: value" line so the flat-text fallback can split them out of the
-  // body and demote them into the same muted meta block the structured render
-  // uses. Order mirrors the structured meta order.
-  const FLAT_REPORT_STATUS_SECTIONS = [
-    { key: 'unchangedReason', prefixes: ['Why nothing changed:', '未修改原因：'], en: 'Why nothing changed', zh: '未修改原因' },
-    { key: 'writeResult', prefixes: ['Write result:', '写入结果：'], en: 'Write result', zh: '写入结果' },
-    { key: 'undo', prefixes: ['Undo:', '可撤销：'], en: 'Undo', zh: '可撤销' },
-    { key: 'nextStep', prefixes: ['Next:', '下一步：'], en: 'Next', zh: '下一步' }
-  ];
-
-  // Splits a flat completion-report string (formatHumanReport output) into the
-  // answer body and the demoted meta rows. Only single-line sections whose head
-  // matches a known status label are demoted, so a multi-paragraph conclusion
-  // that happens to contain "Next: …" prose stays in the body.
-  function splitFlatCompletionReport(text) {
-    const raw = typeof text === 'string' ? text : '';
-    if (!raw.trim()) {
-      return { body: raw, meta: [] };
-    }
-    const bodySections = [];
-    const meta = [];
-    for (const section of raw.split(/\n{2,}/)) {
-      const trimmed = section.trim();
-      if (!trimmed) continue;
-      const entry = trimmed.includes('\n')
-        ? null
-        : FLAT_REPORT_STATUS_SECTIONS.find(item => item.prefixes.some(prefix => trimmed.startsWith(prefix)));
-      if (entry) {
-        const prefix = entry.prefixes.find(p => trimmed.startsWith(p));
-        const value = trimmed.slice(prefix.length).trim();
-        if (value) {
-          meta.push({ key: entry.key, label: tx(entry.en, entry.zh), value });
-          continue;
-        }
-      }
-      bodySections.push(trimmed);
-    }
-    return { body: bodySections.join('\n\n'), meta };
-  }
+  // The result presenter owns parsing and current lifecycle metadata.
+  const splitFlatCompletionReport = text => RunResultActions.splitFlatCompletionReport(text, tx);
+  const projectCompletionMeta = (meta, run) => RunResultActions.projectCompletionMeta(meta, run, {
+    tx, getLocale, tr, trackedChangeInFlight, isTrackedChangeLifecycleRun, projectRunSettlement,
+    projectId: getCurrentProjectId?.(), accountScopeId: getAccountScopeId?.()
+  });
 
-  // Renders the demoted run-metadata block (Why nothing changed / Write result /
-  // Undo / Next) beneath the answer. Shared by the structured and flat-fallback
-  // render paths so both demote identically.
-  function appendCompletionMetaBlock(report, meta) {
+  // The user's own open/closed choice per run survives card re-renders.
+  const metaOpenChoices = new Map();
+
+  // Renders the run-metadata rows (Why nothing changed / Write result / Undo /
+  // Next) behind a one-line summary beneath the answer. Shared by the
+  // structured and flat-fallback render paths so both demote identically.
+  function appendCompletionMetaBlock(report, meta, run) {
     if (!Array.isArray(meta) || !meta.length) {
       return;
     }
+    const rows = projectCompletionMeta(meta, run).filter(row => row?.label && row.value)
+      .map(row => ({ ...row, shown: failureNotice?.formatMetaValue(report, row) ?? row.value }));
+    if (!rows.length) return;
+    const summary = RunResultActions.summarizeCompletionMeta(rows, run, {
+      tx, failed: report.dataset.status === 'failed', unconfirmed: rows.some(row => row.shown !== row.value)
+    });
     const metaBlock = document.createElement('dl');
     metaBlock.className = 'run-final-answer__meta';
-    for (const row of meta) {
-      if (!row || !row.label || !row.value) continue;
+    metaBlock.id = `codex-run-meta-${String(run?.id || 'report').replace(/[^a-zA-Z0-9_-]/g, '-')}`;
+    for (const row of rows) {
       const dt = document.createElement('dt');
       dt.className = 'run-final-answer__meta-label';
       dt.textContent = row.label;
       if (row.key) dt.dataset.metaKey = row.key;
       const dd = document.createElement('dd');
       dd.className = 'run-final-answer__meta-value';
-      dd.textContent = failureNotice?.formatMetaValue(report, row) ?? row.value;
+      dd.textContent = row.shown;
+      if (summary.warnKeys.has(row.key)) dt.dataset.tone = dd.dataset.tone = 'warn';
       metaBlock.append(dt, dd);
     }
-    if (metaBlock.children.length) {
-      report.append(metaBlock);
-    }
+    const facts = document.createElement('div');
+    facts.className = 'run-final-answer__facts';
+    const toggle = document.createElement('button');
+    toggle.type = 'button';
+    toggle.className = 'run-final-answer__facts-sum';
+    toggle.setAttribute('aria-controls', metaBlock.id);
+    summary.facts.forEach((fact, index) => {
+      if (index) toggle.append(Object.assign(document.createElement('span'), { className: 'run-final-answer__facts-sep', textContent: '·' }));
+      const item = Object.assign(document.createElement('span'), { className: 'run-final-answer__fact', textContent: fact.text });
+      if (fact.tone) item.dataset.tone = fact.tone;
+      item.dataset.fact = fact.key;
+      toggle.append(item);
+    });
+    const more = Object.assign(document.createElement('span'), { className: 'run-final-answer__facts-more' });
+    toggle.append(Object.assign(document.createElement('span'), { className: 'run-final-answer__facts-sep', textContent: '·' }), more);
+    const setOpen = open => {
+      facts.dataset.open = String(open);
+      metaBlock.hidden = !open;
+      toggle.setAttribute('aria-expanded', String(open));
+      more.innerHTML = `${open ? tx('Hide', '收起') : tx('Details', '详情')}<svg class="codex-glyph" viewBox="0 0 16 16" aria-hidden="true" focusable="false"><path d="m6 4 4 4-4 4"/></svg>`;
+    };
+    setOpen(metaOpenChoices.get(run?.id) ?? summary.open);
+    toggle.addEventListener('click', event => {
+      event.stopPropagation();
+      const open = facts.dataset.open !== 'true';
+      if (run?.id) metaOpenChoices.set(run.id, open);
+      setOpen(open);
+    });
+    facts.append(toggle, metaBlock);
+    report.append(facts);
   }
 
   function renderCompletionReport(input, run) {
@@ -724,10 +788,10 @@
       main.className = 'run-final-answer';
       const mainSections = [];
       if (structured.conclusion) {
-        mainSections.push(formatConclusionMarkdown(structured.conclusion));
+        mainSections.push(String(structured.conclusion));
       }
       if (structured.body) {
-        mainSections.push(structured.body);
+        mainSections.push(RunResultActions.projectCompletionBody?.(structured.body, tx) ?? structured.body);
       }
       if (mainSections.length) {
         renderMarkdownBlockText(main, mainSections.join('\n\n'));
@@ -736,7 +800,7 @@
       }
 
       failureNotice?.append(report, event, run);
-      appendCompletionMetaBlock(report, structured.meta);
+      appendCompletionMetaBlock(report, structured.meta, run);
       appendCompileFix(report);
       appendRejectedRedo(report);
       appendRecoveryActionForFailure(report, event, run);
@@ -758,24 +822,11 @@
     appendCompileFix(report);
     appendRejectedRedo(report);
     failureNotice?.append(report, event, run);
-    appendCompletionMetaBlock(report, split.meta);
+    appendCompletionMetaBlock(report, split.meta, run);
     appendRecoveryActionForFailure(report, event, run);
     return report;
   }
 
-  function formatConclusionMarkdown(value) {
-    const conclusion = String(value || '');
-    const label = getLocale() === 'zh' ? '结论：' : 'Conclusion:';
-    return hasLeadingMarkdownBlock(conclusion)
-      ? `${label}\n${conclusion}`
-      : `${label} ${conclusion}`;
-  }
-
-  function hasLeadingMarkdownBlock(value) {
-    const firstLine = String(value || '').trimStart().split(/\r?\n/, 1)[0];
-    return /^(?:#{1,6}\s+\S|```|~~~|(?:[-+*]|\d+[.)])\s+\S|\*\*[^*]+\*\*:?\s*$)/.test(firstLine);
-  }
-
   // For failure codes that have an actionable recovery path the user can
   // invoke directly from the run card, append a button inside the completion
   // report. Today's only consumer is codex_project_locked → "Force-release
@@ -783,128 +834,6 @@
   // the normal cancel button is hidden because currentRunView is null).
   // Recovery-action registry: failure codes whose "next step" is executable
   // from the panel get a button, not prose. One primary action per failure.
-  const RETRYABLE_FAILURE_CODES = new Set([
-    'native_request_failed', 'codex_timeout', 'codex_no_usable_result',
-    'codex_output_limit', 'stale_source_changed', 'patch_anchor_not_found',
-    'target_editor_not_ready', 'write_timeout', 'partial_write_needs_review',
-    'write_operation_failed'
-  ]);
-  const NATIVE_SETUP_FAILURE_CODES = new Set([
-    'native_bridge_unavailable', 'native_protocol_incompatible'
-  ]);
-  const OPEN_FILE_FAILURE_CODES = new Set([
-    'target_file_not_active', 'target_file_open_failed', 'target_file_not_found'
-  ]);
-  const STORAGE_FAILURE_CODES = new Set([
-    'storage_quota_exceeded', 'run_state_persist_failed'
-  ]);
-  // A missing `codex` binary is fixed in the terminal, not the panel — the
-  // action opens the README troubleshooting section (PATH / login checks).
-  const CODEX_INSTALL_FAILURE_CODES = new Set(['codex_not_found']);
-  const CODEX_CLI_TROUBLESHOOTING_URL = 'https://github.com/Ghqqqq/codex-overleaf-link#faq-and-troubleshooting';
-
-  function buildRecoveryButton(failureCode, label, title) {
-    const button = document.createElement('button');
-    button.type = 'button';
-    button.className = 'run-final-answer__recovery-action';
-    button.dataset.recoveryFor = failureCode;
-    button.textContent = label;
-    if (title) {
-      button.title = title;
-    }
-    return button;
-  }
-
-  function appendRecoveryActionForFailure(report, event, run) {
-    const recovery = failureNotice?.prepareRecovery(report, { openFile: openProjectFileForFailure });
-    if (recovery?.handled) return;
-    report = recovery?.target || report;
-    const failureCode = event?.failure?.code || '';
-    if (RETRYABLE_FAILURE_CODES.has(failureCode) && typeof refillComposerForRetry === 'function') {
-      const retry = buildRecoveryButton(failureCode,
-        tx('Edit & resend', '编辑后重发'),
-        tx('Put this run\u2019s task back into the composer so you can adjust and resend it.', '把本轮任务填回输入框，修改后可直接重发。'));
-      retry.addEventListener('click', clickEvent => {
-        clickEvent.stopPropagation();
-        refillComposerForRetry(run || null);
-      });
-      report.append(retry);
-      return;
-    }
-    if (NATIVE_SETUP_FAILURE_CODES.has(failureCode) && typeof showNativeSetupGuidance === 'function') {
-      const fix = buildRecoveryButton(failureCode,
-        tx('Fix the native host', '修复 native host'),
-        tx('Opens the install/update guidance with the copyable command.', '打开安装/更新指引（含可复制命令）。'));
-      fix.addEventListener('click', clickEvent => {
-        clickEvent.stopPropagation();
-        showNativeSetupGuidance();
-      });
-      report.append(fix);
-      return;
-    }
-    if (OPEN_FILE_FAILURE_CODES.has(failureCode) && event?.failure?.file && typeof openProjectFileForFailure === 'function') {
-      const open = buildRecoveryButton(failureCode,
-        tx(`Open ${event.failure.file} in Overleaf`, `在 Overleaf 打开 ${event.failure.file}`), '');
-      open.addEventListener('click', clickEvent => {
-        clickEvent.stopPropagation();
-        openProjectFileForFailure(event.failure.file);
-      });
-      report.append(open);
-      return;
-    }
-    if (STORAGE_FAILURE_CODES.has(failureCode) && typeof openStorageSettings === 'function') {
-      const clean = buildRecoveryButton(failureCode,
-        tx('Open history & storage cleanup', '打开历史与存储清理'), '');
-      clean.addEventListener('click', clickEvent => {
-        clickEvent.stopPropagation();
-        openStorageSettings();
-      });
-      report.append(clean);
-      return;
-    }
-    if (CODEX_INSTALL_FAILURE_CODES.has(failureCode)) {
-      const guide = buildRecoveryButton(failureCode,
-        tx('Codex CLI troubleshooting guide', '查看 Codex CLI 排查指引'),
-        tx('Opens the README section on fixing a missing `codex` command (PATH / login).', '打开 README 中「找不到 codex 命令」的排查说明（PATH／登录）。'));
-      guide.addEventListener('click', clickEvent => {
-        clickEvent.stopPropagation();
-        window.open(CODEX_CLI_TROUBLESHOOTING_URL, '_blank', 'noopener');
-      });
-      report.append(guide);
-      return;
-    }
-    if (failureCode !== 'codex_project_locked') return;
-    const button = document.createElement('button');
-    button.type = 'button';
-    button.className = 'run-final-answer__recovery-action';
-    button.dataset.recoveryFor = failureCode;
-    button.textContent = tx('Force-release the stuck task', '强制释放卡住的任务');
-    button.title = tx(
-      'Sends a force-cancel to the native host that drops the project lock so a new run can start. Use this when refreshing the tab did not free the project.',
-      '向 native host 发送强制取消请求，释放当前 Overleaf 项目的占用，让新的任务可以启动。刷新页面没用时使用。'
-    );
-    button.addEventListener('click', event => {
-      event.stopPropagation();
-      button.disabled = true;
-      button.textContent = tx('Releasing…', '正在释放…');
-      forceCancelStuckTaskForCurrentProject().then(result => {
-        if (result?.ok) {
-          button.textContent = tx('Force-released — you can retry the run.', '已释放，可以重试本轮任务。');
-          return;
-        }
-        // The helper resolves (never throws) with a non-ok result when the
-        // request was not delivered. Report the real outcome instead of a
-        // blanket success, and re-enable the button so the user can retry.
-        button.disabled = false;
-        button.textContent = tx('Release failed — refresh the tab, then try again.', '释放失败，请刷新页面后重试。');
-      }).catch(() => {
-        button.disabled = false;
-        button.textContent = tx('Release failed — refresh the tab, then try again.', '释放失败，请刷新页面后重试。');
-      });
-    });
-    report.append(button);
-  }
-
   // A run belongs to the tracked-change lifecycle iff trackedChangeStatus is set
   // or it still has tracked-change refs. Every other run is a legacy-undo run.
   function isTrackedChangeLifecycleRun(run) {
@@ -917,6 +846,47 @@
     return Array.isArray(run.undoTrackedChanges) && run.undoTrackedChanges.length > 0;
   }
 
+  function configureEditButton(root, run, options = {}) {
+    const existing = root.querySelector('[data-run-edit]');
+    if (!existing) return;
+    const button = existing.cloneNode(true);
+    existing.replaceWith(button);
+    const available = ['cancelled', 'rejected'].includes(run?.status)
+      && Boolean(String(run?.task || '').trim())
+      && typeof canEditRun === 'function' && canEditRun(run)
+      && typeof refillComposerForRetry === 'function';
+    button.hidden = !available;
+    if (!available) return;
+    button.disabled = typeof options.running === 'boolean'
+      ? options.running : Boolean(getCurrentRunView?.());
+    button.title = tx('Edit & resend', '编辑后重发');
+    button.setAttribute('aria-label', button.title);
+    button.innerHTML = '<svg viewBox="0 0 20 20" aria-hidden="true"><path d="m12.8 3.2 4 4M3.5 16.5l4.2-.9 9-9a1.7 1.7 0 0 0 0-2.4l-.9-.9a1.7 1.7 0 0 0-2.4 0l-9 9z"/></svg>';
+    button.addEventListener('click', event => {
+      event.stopPropagation();
+      if (getCurrentRunView?.()) return;
+      refillComposerForRetry(run);
+    });
+  }
+
+  function configureWritebackButton(root, run, options = {}) {
+    const existing = root.querySelector('[data-run-sync-retry]');
+    if (!existing) return;
+    const button = existing.cloneNode(true);
+    existing.replaceWith(button);
+    const count = run?.retryWriteback?.operations?.length || 0;
+    const available = !run?.forkSnapshot && (count || run?.saveCheck?.files?.length)
+      && run.undoStatus !== 'applied' && run.trackedChangeStatus !== 'rejected' && typeof retryWriteback === 'function';
+    button.hidden = !available;
+    if (!available) return;
+    button.disabled = typeof options.running === 'boolean' ? options.running : Boolean(getCurrentRunView?.());
+    button.title = count ? tx('Retry sync (' + count + ' files)', '重试同步（' + count + ' 个文件）')
+      : tx('Check save status', '检查保存状态');
+    button.setAttribute('aria-label', button.title);
+    button.innerHTML = '<svg viewBox="0 0 20 20" aria-hidden="true"><path d="M16.5 7A7 7 0 0 0 4 5L2 7m0-4v4h4M3.5 13A7 7 0 0 0 16 15l2-2m0 4v-4h-4"/></svg>';
+    button.addEventListener('click', event => { event.stopPropagation(); if (!getCurrentRunView?.()) void retryWriteback(run.id); });
+  }
+
   function configureUndoButton(root, run) {
     const existing = root.querySelector('[data-run-undo]');
     const button = existing.cloneNode(true);
@@ -939,13 +909,16 @@
     }
 
     button.hidden = false;
-    button.disabled = run.undoStatus === 'running' || run.undoStatus === 'applied';
-    button.textContent = run.undoStatus === 'applied'
+    const inFlight = trackedChangeInFlight?.get(run.id) === 'reject';
+    const applied = run.undoStatus === 'applied' && !inFlight;
+    button.disabled = inFlight || (run.undoStatus === 'running' && !run.undoRecoveryCheckRequired) || run.undoStatus === 'applied';
+    button.textContent = applied
       ? tr('undoApplied')
       : (run.partialWriteback ? tr('undoPartialRun') : tr('undoRun'));
-    button.title = run.undoStatus === 'applied'
+    button.title = applied
       ? tr('undoAppliedTitle')
       : (run.partialWriteback ? tr('undoPartialRunTitle') : tr('undoRunTitle'));
+    if (run.undoRecoveryUnavailable) button.title = tx('Undo recovery checks are unavailable. Reload this page after the connection recovers.', '撤销恢复检查暂不可用，请在连接恢复后重新加载此页面。');
     button.addEventListener('click', event => {
       event.stopPropagation();
       undoRun(run.id);
@@ -1028,7 +1001,11 @@
     }
 
     if (!isTrackedChangeLifecycleRun(run)) {
-      button.hidden = true;
+      const captures = run.undoStatus !== 'applied' && Array.isArray(run.trackedChangeCaptures) ? run.trackedChangeCaptures.filter(c => c && c.state !== 'observed') : [];
+      button.hidden = !captures.length; button.disabled = true;
+      button.textContent = tr('runAcceptTracked');
+      button.title = captures.length ? tx('Tracked-change ownership is unconfirmed. Check the reasons below.', '本轮留痕归属尚未确认，请先核对下方原因。')
+        + '\n' + captures.map(c => c.path + ': ' + (c.reason || c.state) + (c.diagnostics?.sourceReason ? ' / ' + c.diagnostics.sourceReason : '')).join('\n') : tr('runAcceptTrackedTitle');
       return;
     }
 
@@ -1125,17 +1102,63 @@
     const log = getPanel()?.querySelector('[data-log]');
     const existing = log?.querySelector(`[data-run-id="${cssEscape(runId)}"]`);
     const run = findRunRecord(runId);
-    if (!log || !existing || !run) {
-      return;
+    if (!log || !existing || !run || displayRun(run) === run) {
+      return false;
     }
-    existing.replaceWith(renderRunCard(run));
+    const reading = scrollLayout?.snapshot(), open = existing.querySelector('[data-run-process]')?.open;
+    const next = renderRunCard(run);
+    const process = next.querySelector('[data-run-process]');
+    if (process && typeof open === 'boolean') process.open = open;
+    existing.replaceWith(next);
+    if (reading) scrollLayout?.restore(reading);
+    return true;
+  }
+
+  function refreshLocale() {
+    const log = getPanel()?.querySelector('[data-log]');
+    if (!log) return;
+    if (!getState().runs?.length) { renderRunHistory({ preserveScroll: true }); return; }
+    const reading = scrollLayout?.snapshot() || { scrollTop: log.scrollTop };
+    for (const run of getState().runs) {
+      const existing = log.querySelector(`[data-run-id="${cssEscape(run.id)}"]`);
+      if (!existing) continue;
+      const current = getCurrentRunView();
+      if (current?.root === existing) {
+        // Streaming owners retain their DOM references and buffered model text.
+        const status = existing.querySelector('[data-run-status]');
+        if (status) status.textContent = getRunStatusText(run);
+        configureAcceptButton(existing, run); configureUndoButton(existing, run);
+        configureEditButton(existing, run); configureWritebackButton(existing, run);
+        RunResultActions.configureResultActions(existing, run);
+        const reportEvent = (run.events || []).filter(event => event.kind === 'report').at(-1);
+        const report = current.report || existing.querySelector('[data-run-report]');
+        if (reportEvent && report) report.replaceChildren(renderCompletionReport(reportEvent, displayLocalizedRun(run)));
+        activitySummary?.update(current);
+        if (!activitySummary) RunGuidanceView.reconcileGuidance?.(existing.querySelector('[data-run-guidance]'),
+          (run.events || []).concat(getPendingGuidance(run)), tx, { active: run.status === 'running' });
+        continue;
+      }
+      const open = existing.querySelector('[data-run-process]')?.open;
+      const next = renderRunCard(run);
+      const process = next.querySelector('[data-run-process]');
+      if (process && typeof open === 'boolean') process.open = open;
+      existing.replaceWith(next);
+    }
+    log.scrollTop = reading.scrollTop;
+    scrollLayout?.restore(reading);
+    updateJumpToLatestButton(log);
   }
 
     return {
+      refreshLocale,
+      refreshResolvedUndo: refreshRunCard,
+      refreshActivitySummary: activitySummary?.update,
+      appendActivityDetail,
       resetAutoFollow,
       bindLogAutoFollow,
       bumpUnreadIfDetached,
       scrollLogToBottom,
+      revealGuidance,
       collapseRunProcess,
       startRunElapsedTick,
       stopRunElapsedTick,
@@ -1147,10 +1170,12 @@
       upsertStreamEvent,
       renderCompletionReport,
       isTrackedChangeLifecycleRun,
+      configureEditButton,
+      configureWritebackButton,
       configureUndoButton,
       configureAcceptButton
     };
   }
 
-  window.CodexOverleafRunTimelineView = { create };
-})();
+  return { create };
+});