codex-overleaf-link 2.5.0 → 2.6.0

package/extension/src/content/runTimelineView.js

@@ -1,18 +1,29 @@
-(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';
 
+
   // 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,
+      PanelIcons,
       RunActivityModel,
       SubagentActivityView,
       RunGuidanceView,
+      getPendingGuidance = () => [],
       RunResultActions,
       RunScrollLayout,
       RunFailureNotice,
+      I18n,
+      FailureReasons,
+      projectContextLimitEvent = value => value,
+      localizeVisibleReason = value => value,
+      localizeCompileReason = value => value,
       tr,
       tx,
       getLocale,
@@ -47,6 +58,7 @@
       trackedChangeInFlight,
       projectRunSettlement,
       getCurrentProjectId,
+      getAccountScopeId,
       getProjectName
     } = deps;
 
@@ -59,6 +71,7 @@
   // drives the floating "jump to latest" button's counter.
   let scrollLogRafId = 0;
   let scrollLogPendingForce = false;
+  let pendingGuidanceReveal = null;
   let jumpToLatestButton = null;
   let unreadSinceDetach = 0;
   // Elapsed time belongs to the run; tool rows retain their own lifecycle.
@@ -69,11 +82,25 @@
     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 getNotStartedRun = run => RunResultActions.projectNotStartedRun?.(run, getLocale());
+  const getFinishedRun = run => RunResultActions.projectFinishedRun?.(run, getLocale(), { projectRunSettlement });
   const displayRun = run => RunFailureNotice?.projectResolvedUndo?.(run) || run;
-  const activitySummary = RunActivitySummary?.create({ RunActivityModel, SubagentActivityView, tx, findRunRecord: (...args) => displayRun(findRunRecord(...args)), getPanel, cssEscape,
+  const displayLocalizedRun = run => {
+    const displayed = displayRun(run);
+    return displayed ? { ...displayed, events: (displayed.events || []).map(sanitizeRunEventForRender) } : displayed;
+  };
+  const activitySummary = RunActivitySummary?.create({ RunActivityModel, RunGuidanceView, getPendingGuidance, SubagentActivityView, PanelIcons, tx, findRunRecord: (...args) => displayLocalizedRun(findRunRecord(...args)), getPanel, cssEscape,
+    projectReviewResultEvent: sanitizeRunEventForRender,
+    formatReviewResultFailure,
     formatEventTime, formatElapsed, renderMarkdownBlockText, renderRunEvent, formatEventDetail,
-    presence, classifyStatus: classifyRunPresence, getProjectId: () => getCurrentProjectId?.() || '',
+    presence, getNotStartedRun, getFinishedRun, classifyStatus: classifyRunPresence, getProjectId: () => getCurrentProjectId?.() || '',
     summarizeCommand: RunPresence?.commandSummary,
     isGuidance: event => Boolean(RunGuidanceView.getGuidanceText(event)), sanitizeAssistantVisibleText });
 
@@ -82,6 +109,7 @@
   function resetAutoFollow() {
     logAutoFollow = true;
     userScrollIntentUntil = 0;
+    pendingGuidanceReveal = null;
   }
 
   function bindLogAutoFollow() {
@@ -156,7 +184,7 @@
       ? tx(`↓ Latest · ${unreadSinceDetach}`, `↓ 最新 · ${unreadSinceDetach}`)
       : tx('↓ Latest', '↓ 最新');
     button.setAttribute('aria-label', unreadSinceDetach > 0
-      ? tx(`Jump to latest, ${unreadSinceDetach} new steps`, `跳到最新，${unreadSinceDetach} 个新步骤`)
+      ? tx(`Jump to latest, ${unreadSinceDetach} new step${unreadSinceDetach === 1 ? '' : 's'}`, `跳到最新，${unreadSinceDetach} 个新步骤`)
       : tx('Jump to latest', '跳到最新'));
   }
 
@@ -183,6 +211,7 @@
     if ((event?.type === 'wheel' && event.deltaY < 0) || ['ArrowUp', 'PageUp', 'Home'].includes(event?.key)) {
       logAutoFollow = false;
       scrollLogPendingForce = false;
+      pendingGuidanceReveal = null;
     }
   }
 
@@ -207,6 +236,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.
@@ -241,10 +271,26 @@
       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) {
+    const record = view?.recordId ? displayLocalizedRun(findRunRecord(view.recordId, view.sessionId)) : null;
+    if (record && getFinishedRun(record)) refreshCompletionView(view.root, view.report, record);
     if (activitySummary) { activitySummary.settle(view, statusText); return; }
     const runProcess = view?.runProcess || view?.root?.querySelector('[data-run-process]');
     if (runProcess) {
@@ -257,11 +303,22 @@
       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} · ${tx(`${stepCount} step${stepCount === 1 ? '' : 's'}`, `${stepCount} 步`)}`
         : statusText;
     }
   }
 
+  function refreshCompletionView(root, report, run) {
+    const event = (run.events || []).filter(item => item.kind === 'report').at(-1);
+    if (!root || !report || !event) return;
+    // Result actions may already live inside the previous report's facts row.
+    const actions = root.querySelector('.run-result-actions');
+    report.replaceChildren(renderCompletionReport(event, run));
+    if (actions) report.append(actions);
+    RunResultActions.configureResultActions(root, run);
+    configureEditButton(root, run);
+  }
+
   // Keep elapsed labels live without creating new activity records.
   function startRunElapsedTick() {
     stopRunElapsedTick();
@@ -357,7 +414,7 @@
   }
 
   function renderRunCard(run) {
-    run = displayRun(run);
+    run = displayLocalizedRun(run);
     const root = document.createElement('section');
     root.className = 'transcript-turn run-card';
     root.dataset.status = run.status || 'completed';
@@ -391,7 +448,6 @@
         <div class="run-result-actions" hidden>
           <button type="button" class="run-copy-action" data-run-copy hidden></button>
           <button type="button" class="run-fork-action" data-run-fork hidden></button>
-          <span class="run-completed-time" data-run-completed-time hidden></span>
         </div>
         <div class="run-report" data-run-report aria-live="polite" hidden></div>
       </div>
@@ -418,28 +474,15 @@
       truncated.textContent = tr('eventsTruncatedNote');
       events.append(truncated);
     }
-    const guidanceTarget = 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 (activitySummary || event.kind === 'technical') {
+      } else if (getNotStartedRun(run) || 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 {
@@ -457,7 +500,19 @@
   }
 
   function getRunStatusText(run = {}) {
+    const notStarted = getNotStartedRun(run);
+    if (notStarted) return notStarted.status;
+    const outcome = getFinishedRun(run);
+    if (outcome?.status) return outcome.status;
     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;
     }
@@ -532,20 +587,64 @@
   }
 
   function sanitizeRunEventForRender(event = {}) {
+    event = projectContextLimitEvent(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');
@@ -586,27 +685,48 @@
   // 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, trackedChangeInFlight, isTrackedChangeLifecycleRun, projectRunSettlement
+    tx, getLocale, tr, trackedChangeInFlight, isTrackedChangeLifecycleRun, projectRunSettlement,
+    projectId: getCurrentProjectId?.(), accountScopeId: getAccountScopeId?.()
   });
 
   // The user's own open/closed choice per run survives card re-renders.
   const metaOpenChoices = new Map();
 
+  // The completion time lives with the other run facts, not in the action row.
+  // `classed` matches lists whose rows carry the meta label/value classes.
+  function appendFinishedRow(list, run, { classed = false } = {}) {
+    const finishedAt = new Date(String(run?.finishedAt || ''));
+    if (!Number.isFinite(finishedAt.getTime())) return;
+    const dt = Object.assign(document.createElement('dt'), { textContent: tx('Finished', '完成于') });
+    dt.dataset.metaKey = 'finishedAt';
+    const dd = Object.assign(document.createElement('dd'), {
+      textContent: new Intl.DateTimeFormat(getLocale(), { hour: 'numeric', minute: '2-digit' }).format(finishedAt),
+      title: finishedAt.toLocaleString(getLocale()) });
+    if (classed) {
+      dt.className = 'run-final-answer__meta-label';
+      dd.className = 'run-final-answer__meta-value';
+    }
+    list.append(dt, dd);
+  }
+
   // 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) {
+  function appendCompletionMetaBlock(report, meta, run, { quiet = false } = {}) {
     if (!Array.isArray(meta) || !meta.length) {
       return;
     }
-    const rows = projectCompletionMeta(meta, run).filter(row => row?.label && row.value)
+    const noWrites = getFinishedRun(run)?.noWrites;
+    const rows = projectCompletionMeta(meta, run).filter(row => row?.label && row.value
+      && !(noWrites && ['writeResult', 'undo'].includes(row.key)))
       .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)
+      tx, failed: report.dataset.status === 'failed' && !noWrites, unconfirmed: rows.some(row => row.shown !== row.value)
     });
     const metaBlock = document.createElement('dl');
     metaBlock.className = 'run-final-answer__meta';
+    appendFinishedRow(metaBlock, run, { classed: true });
     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');
@@ -619,6 +739,12 @@
       if (summary.warnKeys.has(row.key)) dt.dataset.tone = dd.dataset.tone = 'warn';
       metaBlock.append(dt, dd);
     }
+    if (quiet) {
+      const details = createOutcomeDetails(run);
+      details.querySelector('.run-outcome-details-content').append(metaBlock);
+      report.append(details);
+      return;
+    }
     const facts = document.createElement('div');
     facts.className = 'run-final-answer__facts';
     const toggle = document.createElement('button');
@@ -633,12 +759,18 @@
       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);
+    // The chevron stays with the last fact, so a narrow row never leaves it alone on a line.
+    const tail = Object.assign(document.createElement('span'), { className: 'run-final-answer__facts-tail' });
+    if (toggle.lastElementChild) tail.append(toggle.lastElementChild);
+    tail.append(more);
+    toggle.append(tail);
     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>`;
+      // The facts are the toggle; the chevron and the tooltip carry its state.
+      toggle.title = open ? tx('Hide details', '收起详情') : tx('Show details', '展开详情');
+      more.innerHTML = `<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 => {
@@ -651,11 +783,130 @@
     report.append(facts);
   }
 
+  function createOutcomeDetails(run) {
+    const details = document.createElement('details');
+    details.className = 'run-outcome-details';
+    details.open = metaOpenChoices.get(run?.id) ?? false;
+    details.append(Object.assign(document.createElement('summary'), { textContent: tr('runOutcomeDetails') }));
+    details.append(Object.assign(document.createElement('div'), { className: 'run-outcome-details-content' }));
+    details.addEventListener('toggle', () => { if (run?.id) metaOpenChoices.set(run.id, details.open); });
+    return details;
+  }
+
+  function renderOutcomeCard(report, event, run, outcome) {
+    const card = document.createElement('div');
+    card.className = 'run-outcome';
+    card.dataset.outcome = outcome.kind;
+    const main = document.createElement('div');
+    main.className = 'run-final-answer';
+    const title = document.createElement('div');
+    title.className = 'run-final-heading';
+    title.textContent = sanitizeAssistantVisibleText(outcome.title);
+    main.append(title);
+    if (outcome.body) main.append(Object.assign(document.createElement('p'), {
+      className: 'run-outcome-body', textContent: sanitizeAssistantVisibleText(outcome.body)
+    }));
+    if (outcome.files.length) {
+      const files = document.createElement('ul');
+      files.className = 'run-outcome-files';
+      for (const item of outcome.files) {
+        const row = document.createElement('li');
+        const mark = document.createElement('span');
+        mark.className = 'run-outcome-file-icon';
+        mark.dataset.written = String(item.written);
+        mark.innerHTML = RunPresence.icon(item.written ? 'written' : 'skipped');
+        mark.setAttribute('aria-label', tr(item.written ? 'runOutcomeWritten' : 'runOutcomeSkipped'));
+        row.append(mark, Object.assign(document.createElement('span'), {
+          className: 'run-outcome-file-name', textContent: sanitizeAssistantVisibleText(item.file)
+        }));
+        if (item.reason) row.append(Object.assign(document.createElement('span'), {
+          className: 'run-outcome-file-reason', textContent: sanitizeAssistantVisibleText(item.reason)
+        }));
+        files.append(row);
+      }
+      main.append(files);
+    }
+    const next = document.createElement('dl');
+    next.className = 'run-outcome-next';
+    next.append(Object.assign(document.createElement('dt'), { textContent: tr('detailNext') }),
+      Object.assign(document.createElement('dd'), { textContent: sanitizeAssistantVisibleText(outcome.nextStep) }));
+    card.append(main, next);
+    report.append(card);
+    failureNotice?.append(report, event, run, card);
+    appendRecoveryActionForFailure(report, event, run);
+
+    const details = createOutcomeDetails(run);
+    const rows = projectCompletionMeta(event.detailStructured.meta || [], run)
+      .filter(row => row?.value && row.key !== 'nextStep'
+        && !(outcome.noWrites && ['writeResult', 'undo'].includes(row.key)));
+    if (outcome.failure?.code) rows.unshift({ label: tr('runOutcomeCode'), value: outcome.failure.code });
+    if (outcome.failure?.stage) rows.push({ label: tr('runOutcomeStage'), value: outcome.failure.stage });
+    if (outcome.noWrites) rows.push({ label: tr('runOutcomeWrites'), value: tr('runOutcomeNoneAttempted') });
+    const meta = document.createElement('dl');
+    meta.className = 'run-final-answer__meta';
+    appendFinishedRow(meta, run);
+    for (const row of rows) {
+      const label = Object.assign(document.createElement('dt'), { textContent: row.label });
+      if (row.key) label.dataset.metaKey = row.key;
+      meta.append(label, Object.assign(document.createElement('dd'), {
+        textContent: sanitizeAssistantVisibleText(failureNotice?.formatMetaValue(report, row) ?? row.value)
+      }));
+    }
+    const detailContent = details.querySelector('.run-outcome-details-content');
+    detailContent.append(meta);
+    // Preserve the original report body as optional context without repeating
+    // its skipped-item prose in the default outcome view.
+    if (event.detailStructured.body) {
+      const body = document.createElement('div');
+      renderMarkdownBlockText(body, RunResultActions.projectCompletionBody(event.detailStructured.body, tx));
+      detailContent.append(body);
+    }
+    card.append(details);
+  }
+
+  function formatCompileErrorNames(errors, totalCount) {
+    const names = [...new Set(errors.map(error => String(error)
+      .trim().replace(/^!\s*/, '').replace(/^(?:[A-Za-z]:)?[^:\r\n]+:\d+:\s*/, '').replace(/^!\s*/, '')
+      .split(/[ \t]+l\.\d+\b|[\r\n]/, 1)[0]
+      .trim().replace(/\.$/, '').replace(/\s+/g, ' ').trim()).filter(Boolean))];
+    const shown = names.slice(0, 3);
+    // History may retain fewer diagnostics than the original count. Preserve
+    // that omitted count without inventing names or changing the repair draft.
+    const more = Math.max(0, names.length - shown.length) + Math.max(0, totalCount - errors.length);
+    if (more) shown.push(tx(`+${more} more`, `另 ${more} 个`));
+    return shown.join(tx('; ', '；'));
+  }
+
   function renderCompletionReport(input, run) {
     const event = sanitizeRunEventForRender(input);
     const report = document.createElement('section');
     report.className = 'run-completion-report';
     report.dataset.status = event.status || 'completed';
+    const notStarted = getNotStartedRun(run);
+    if (notStarted) {
+      report.dataset.status = 'not-started';
+      const card = document.createElement('div');
+      card.className = 'run-outcome';
+      const main = document.createElement('div');
+      main.className = 'run-final-answer';
+      const title = document.createElement('div');
+      title.className = 'run-final-heading';
+      title.textContent = notStarted.title;
+      const body = document.createElement('p');
+      body.className = 'run-outcome-body';
+      body.textContent = notStarted.body;
+      main.append(title, body);
+      const next = document.createElement('dl');
+      next.className = 'run-outcome-next';
+      next.append(Object.assign(document.createElement('dt'), {
+        textContent: tr('detailNext')
+      }), Object.assign(document.createElement('dd'), {
+        textContent: notStarted.nextStep
+      }));
+      card.append(main, next);
+      report.append(card);
+      return report;
+    }
     // Compile errors captured post-write get a one-click fix loop: the
     // structured error list rides on the report event (compileErrors).
     const appendCompileFix = target => {
@@ -664,7 +915,7 @@
         return;
       }
       const fix = buildRecoveryButton('compile_errors',
-        tx(`Fix ${compileErrors.length} compile error(s)`, `修复 ${compileErrors.length} 个编译错误`),
+        tx(`Fix ${compileErrors.length} compile error${compileErrors.length === 1 ? '' : 's'}`, `修复 ${compileErrors.length} 个编译错误`),
         tx('Prefills a task with @compile-log and the captured errors.', '自动组一条带 @compile-log 和错误列表的任务。'));
       fix.addEventListener('click', clickEvent => {
         clickEvent.stopPropagation();
@@ -702,6 +953,13 @@
     // visually demoted block beneath, with a separator and muted color so
     // they read as run metadata rather than part of the answer.
     const structured = event.detailStructured;
+    const outcome = getFinishedRun(run);
+    if (outcome && !['cancelled', 'compile-errors'].includes(outcome.kind)) {
+      renderOutcomeCard(report, event, run, outcome);
+      appendCompileFix(report);
+      appendRejectedRedo(report);
+      return report;
+    }
     const hasStructured = structured
       && (structured.conclusion || structured.body || (Array.isArray(structured.meta) && structured.meta.length));
     if (hasStructured) {
@@ -709,10 +967,11 @@
       main.className = 'run-final-answer';
       const mainSections = [];
       if (structured.conclusion) {
-        mainSections.push(String(structured.conclusion));
+        mainSections.push(outcome?.kind === 'compile-errors' ? outcome.conclusion
+          : RunResultActions.projectCompletionConclusion?.(event, run, tx('en', 'zh'), { localizeCompileReason }) ?? 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'));
@@ -721,8 +980,20 @@
       }
 
       failureNotice?.append(report, event, run);
-      appendCompletionMetaBlock(report, structured.meta, run);
-      appendCompileFix(report);
+      if (outcome?.kind === 'compile-errors') {
+        const compile = document.createElement('div');
+        compile.className = 'run-outcome run-outcome-compile';
+        const capturedErrors = Array.isArray(event.compileErrors) ? event.compileErrors.filter(Boolean) : [];
+        compile.append(Object.assign(document.createElement('strong'), { className: 'run-final-heading', textContent: outcome.title }),
+          Object.assign(document.createElement('p'), { className: 'run-outcome-body',
+            textContent: formatCompileErrorNames(capturedErrors.length ? capturedErrors : outcome.compileErrors, outcome.compileCount) }));
+        appendCompileFix(compile);
+        report.append(compile);
+        appendCompletionMetaBlock(report, structured.meta, run, { quiet: true });
+      } else {
+        appendCompletionMetaBlock(report, structured.meta, run);
+        appendCompileFix(report);
+      }
       appendRejectedRedo(report);
       appendRecoveryActionForFailure(report, event, run);
       return report;
@@ -737,7 +1008,8 @@
     const split = splitFlatCompletionReport(flatText);
     const body = document.createElement('div');
     body.className = 'run-final-answer';
-    renderMarkdownBlockText(body, split.body || flatText);
+    renderMarkdownBlockText(body, RunResultActions.projectCompletionConclusion?.(event, run, tx('en', 'zh'),
+      { flat: true, text: split.body || flatText, localizeCompileReason }) ?? (split.body || flatText));
     decorateCompletionReport(body, { tx });
     report.append(body);
     appendCompileFix(report);
@@ -755,132 +1027,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 appendEditAndResend(report, run, actionKey) {
-    const retry = buildRecoveryButton(actionKey,
-      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);
-  }
-
-  function appendRecoveryActionForFailure(report, event, run) {
-    const recovery = failureNotice?.prepareRecovery(report, { openFile: openProjectFileForFailure });
-    const failureCode = event?.failure?.code || '';
-    if (recovery?.handled) return;
-    report = recovery?.target || report;
-    if (RETRYABLE_FAILURE_CODES.has(failureCode) && typeof refillComposerForRetry === 'function') {
-      appendEditAndResend(report, run, failureCode);
-      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) {
@@ -902,7 +1048,8 @@
       && Boolean(String(run?.task || '').trim())
       && typeof canEditRun === 'function' && canEditRun(run)
       && typeof refillComposerForRetry === 'function';
-    button.hidden = !available;
+    const cardHasEdit = Boolean(root.querySelector('.run-outcome [data-recovery-action="edit-resend"]'));
+    button.hidden = !available || cardHasEdit;
     if (!available) return;
     button.disabled = typeof options.running === 'boolean'
       ? options.running : Boolean(getCurrentRunView?.());
@@ -950,19 +1097,24 @@
     }
 
     const projection = RunResultActions.projectUndoAvailability(run, projectRunSettlement);
-    if (!projection.canUndo && run.undoStatus !== 'applied') {
+    if (!projection.canUndo && run.undoStatus !== 'applied' && !projection.undoUnavailable?.length) {
       button.hidden = true;
       return;
     }
 
     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 = !projection.canUndo || 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.', '撤销恢复检查暂不可用，请在连接恢复后重新加载此页面。');
+    if (projection.undoUnavailable?.length) button.title = tr('failureReason_snapshot_undo_unavailable_user')
+      + ' ' + projection.undoUnavailable.map(item => item.path).join(', ');
     button.addEventListener('click', event => {
       event.stopPropagation();
       undoRun(run.id);
@@ -979,6 +1131,9 @@
     const status = run.trackedChangeStatus || '';
     const inFlight = trackedChangeInFlight.get(run.id);
     const projection = projectRunSettlement(run);
+    const undoTitle = projection.undoUnavailable?.length
+      ? tr('failureReason_snapshot_undo_unavailable_user') + ' ' + projection.undoUnavailable.map(item => item.path).join(', ')
+      : tr('undoRunTitle');
     // §7 settlement matrix: needs_review keeps BOTH controls visible AND
     // actionable. Branch placed before the terminal branches so a
     // needs_review run is never treated as terminal.
@@ -986,7 +1141,7 @@
       button.hidden = false;
       button.disabled = !projection.canUndo || inFlight === 'reject' || inFlight === 'accept';
       button.textContent = tr('undoRun');
-      button.title = tr('undoRunTitle');
+      button.title = undoTitle;
       button.addEventListener('click', event => {
         event.stopPropagation();
         undoRun(run.id);
@@ -1006,7 +1161,7 @@
       button.hidden = false;
       button.disabled = true;
       button.textContent = tr('undoRun');
-      button.title = tr('undoRunTitle');
+      button.title = tr('undoAcceptedTitle');
       return;
     }
     if (status !== 'pending' && !inFlight) {
@@ -1016,7 +1171,7 @@
     button.hidden = false;
     button.disabled = !projection.canUndo || inFlight === 'reject' || inFlight === 'accept';
     button.textContent = tr('undoRun');
-    button.title = tr('undoRunTitle');
+    button.title = undoTitle;
     button.addEventListener('click', event => {
       event.stopPropagation();
       undoRun(run.id);
@@ -1085,7 +1240,7 @@
       button.hidden = false;
       button.disabled = true;
       button.textContent = tr('runAcceptTracked');
-      button.title = tr('runAcceptTrackedTitle');
+      button.title = tr('undoAppliedTitle');
       return;
     }
     if (status !== 'pending' && !inFlight) {
@@ -1146,7 +1301,7 @@
     const log = getPanel()?.querySelector('[data-log]');
     const existing = log?.querySelector(`[data-run-id="${cssEscape(runId)}"]`);
     const run = findRunRecord(runId);
-    if (!log || !existing || !run || displayRun(run) === run) {
+    if (!log || !existing || !run || (displayRun(run) === run && !getFinishedRun(run))) {
       return false;
     }
     const reading = scrollLayout?.snapshot(), open = existing.querySelector('[data-run-process]')?.open;
@@ -1158,7 +1313,43 @@
     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) refreshCompletionView(existing, report, 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,
@@ -1166,6 +1357,7 @@
       bindLogAutoFollow,
       bumpUnreadIfDetached,
       scrollLogToBottom,
+      revealGuidance,
       collapseRunProcess,
       startRunElapsedTick,
       stopRunElapsedTick,
@@ -1184,5 +1376,5 @@
     };
   }
 
-  window.CodexOverleafRunTimelineView = { create };
-})();
+  return { create };
+});