npm - davinci-resolve-mcp - Versions diffs - 2.38.0 → 2.40.0 - Mend

davinci-resolve-mcp 2.38.0 → 2.40.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (17) hide show

package/CHANGELOG.md +50 -0
package/README.md +1 -1
package/docs/SKILL.md +7 -1
package/docs/guides/control-panel.md +121 -52
package/docs/process/release-process.md +11 -0
package/install.py +1 -1
package/package.json +1 -1
package/scripts/regen_panel_screenshots.py +75 -0
package/src/analysis_dashboard.py +197 -41
package/src/batch_cli.py +2 -0
package/src/granular/common.py +1 -1
package/src/server.py +84 -10
package/src/utils/actor_identity.py +46 -0
package/src/utils/brain_edits.py +4 -3
package/src/utils/resolve_ai_ledger.py +6 -4
package/src/utils/timeline_brain_db.py +15 -1
package/src/utils/timeline_versioning.py +4 -3

package/src/analysis_dashboard.py CHANGED Viewed

@@ -3753,6 +3753,7 @@ HTML = r"""<!doctype html>
         justify-content: flex-start;
         padding-bottom: 2px;
       }
+      .control-tabs select { max-width: 150px; min-width: 110px; }
       .lab-navbar {
         height: 88px;
         flex-wrap: wrap;
@@ -3817,10 +3818,11 @@ HTML = r"""<!doctype html>
     <nav class="control-tabs" aria-label="Control panel sections">
       <button class="control-tab active" data-panel-target="overview">Overview</button>
       <div class="control-nav-item">
-        <button class="control-tab has-menu" data-panel-target="analysis">Analysis <span class="tab-chevron" aria-hidden="true"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round"><path d="m6 9 6 6 6-6"></path></svg></span></button>
+        <button class="control-tab has-menu" data-panel-target="analysis">Media <span class="tab-chevron" aria-hidden="true"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round"><path d="m6 9 6 6 6-6"></path></svg></span></button>
         <div class="nav-dropdown" role="menu" aria-label="Analysis pages">
-          <button class="nav-dropdown-item" data-panel-target="analysis" data-subpage-target="media" role="menuitem"><span class="nav-dropdown-icon" aria-hidden="true"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="3" y="5" width="18" height="14" rx="2"></rect><path d="m7 15 3-3 2 2 4-5 1 2"></path></svg></span>Analyze</button>
+          <button class="nav-dropdown-item" data-panel-target="analysis" data-subpage-target="media" role="menuitem"><span class="nav-dropdown-icon" aria-hidden="true"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="3" y="5" width="18" height="14" rx="2"></rect><path d="m7 15 3-3 2 2 4-5 1 2"></path></svg></span>Inventory</button>
           <button class="nav-dropdown-item" data-panel-target="analysis" data-subpage-target="review" role="menuitem"><span class="nav-dropdown-icon" aria-hidden="true"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="3" y="3" width="18" height="14" rx="2"></rect><circle cx="9" cy="10" r="2"></circle><path d="m21 17-5-5-9 9"></path></svg></span>Review</button>
+          <button class="nav-dropdown-item" id="navHistoryItem" data-panel-target="analysis" data-subpage-target="review" data-review-view="history" role="menuitem"><span class="nav-dropdown-icon" aria-hidden="true"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 12a9 9 0 1 0 9-9 9.75 9.75 0 0 0-6.74 2.74L3 8"></path><path d="M3 3v5h5"></path><path d="M12 7v5l4 2"></path></svg></span>History</button>
         </div>
       </div>
       <button class="control-tab" data-panel-target="aiconsole">AI Console</button>
@@ -3969,7 +3971,7 @@ HTML = r"""<!doctype html>
     <section class="span-12 subpage active" data-subpage-scope="analysis" data-subpage="media">
         <div class="section-top">
           <div>
-            <h2>Analyze</h2>
+            <h2>Inventory</h2>
             <p class="section-copy">Resolve media is inventoried read-only and filtered to source clips so timelines, compounds, titles, and generated items stay out of analysis queues.</p>
             <div class="section-meta" id="resolveProject">Resolve connection pending</div>
             <div class="copy-status" id="copyPromptStatus"></div>
@@ -4048,7 +4050,7 @@ HTML = r"""<!doctype html>
         </div>
         <div class="controls" id="reviewControls">
           <button class="secondary" id="reviewRefreshBtn">Refresh</button>
-          <button class="secondary" id="reviewHistoryBtn" title="Timeline edit history (C6)">History</button>
+          <button class="secondary" id="reviewHistoryBtn" title="Timeline edit history">History</button>
           <button class="secondary" id="reviewBackBtn" style="display:none">← Back</button>
         </div>
       </div>
@@ -4057,7 +4059,6 @@ HTML = r"""<!doctype html>
           <div class="readiness-card-header">
             <span class="readiness-title">Project readiness</span>
             <span id="readinessEvidenceBase" class="readiness-evidence"></span>
-            <button id="readinessRefreshBtn" class="secondary" type="button" title="Refresh readiness summary">Refresh</button>
           </div>
           <div id="readinessSummaryRow" class="readiness-summary-row"></div>
           <div id="readinessDetails" class="readiness-details"></div>
@@ -4181,8 +4182,12 @@ HTML = r"""<!doctype html>
       <div class="caps-section" style="margin-top:12px;">
         <div class="caps-section-head"><div class="caps-section-title">Governance</div>
-          <div class="caps-section-hint">Soft per-session limits for the two media-creating ops (deblur, speech). Advisory only — you'll be warned in the confirm dialog, but never blocked (the ops are confirm-gated). Pick the tier that matches the job.</div></div>
+          <div class="caps-section-hint">Per-session limits for the two media-creating ops (deblur, speech). In <strong>Advisory</strong> mode you're warned in the confirm dialog but never blocked; in <strong>Enforce</strong> mode an over-tier run is refused until you raise the tier, relax the mode, or consciously override. Pick the tier that matches the job.</div></div>
         <div id="aiGovTiers" class="caps-preset-cards" role="radiogroup" aria-label="AI governance tier"></div>
+        <div class="review-view-toggle" id="aiGovMode" role="radiogroup" aria-label="Governance mode" style="margin-top:10px;">
+          <button type="button" data-gov-mode="advisory">Advisory</button>
+          <button type="button" data-gov-mode="enforce">Enforce</button>
+        </div>
         <div id="aiGovUsage" class="caps-usage-gauges" style="margin-top:10px;"></div>
       </div>
@@ -4527,6 +4532,7 @@ HTML = r"""<!doctype html>
               </tr></thead>
               <tbody id="resolveAiOpsRows"></tbody>
             </table>
+            <div id="resolveAiOpsRecent"></div>
           </div>
         </div>
@@ -4853,7 +4859,7 @@ HTML = r"""<!doctype html>
     const VIEW_ALL_PROJECTS_VALUE = '__view_all_projects__';
     const PANEL_LABELS = {
       overview: 'Overview',
-      analysis: 'Analysis',
+      analysis: 'Media',
       aiconsole: 'AI Console',
       diagnostics: 'Setup',
       projects: 'Projects',
@@ -4877,7 +4883,7 @@ HTML = r"""<!doctype html>
     };
     const SUBPAGE_LABELS = {
       analysis: {
-        media: 'Analyze',
+        media: 'Inventory',
         review: 'Review',
       },
       diagnostics: {
@@ -5153,6 +5159,10 @@ HTML = r"""<!doctype html>
           openClipDetail(clipId, { writePanelState: false, pushHash: false }).catch(alertError);
         }
       }
+      if (panelName === 'analysis' && subpage === 'review' && route[2] === 'history') {
+        reviewSetView('history');
+        refreshHistoryTimelines().catch(alertError);
+      }
       // Deep links: #analysis/review/combined/<id1,id2,...>
       if (panelName === 'analysis' && subpage === 'review' && route[2] === 'combined' && route[3]) {
         const ids = decodeURIComponent(route[3]).split(',').filter(Boolean);
@@ -5268,12 +5278,19 @@ HTML = r"""<!doctype html>
         renderInfoRows('overviewStatusList', [
           { label: 'Resolve project', value: resolveProject, icon: ICONS.project, pill: { tone: 'pill-ok', label: 'Read-only' } },
           { label: 'Source clips', value: `${clipLabel(clips.length)} · ${readyClips} ready`, icon: ICONS.clips, pill: { tone: clipsTone, label: `${readyClips} ready` } },
-          { label: 'Sequences', value: `${sequences} read-only context ${sequences === 1 ? 'item' : 'items'}`, icon: ICONS.sequences },
+          { label: 'Sequences', value: sequences ? `${sequences} timeline${sequences === 1 ? '' : 's'} detected (read-only)` : 'No timelines detected', icon: ICONS.sequences },
           { label: 'Clip media status', value: `${onlineClips} online · ${missingClips} missing/offline`, icon: ICONS.status, pill: { tone: mediaTone, label: missingClips ? `${missingClips} missing` : 'All online' } },
           { label: 'Analysis progress', value: `${analyzedClips} of ${clips.length} analyzed (${analyzedPct}%)`, icon: ICONS.analysis, pill: { tone: analysisTone, label: `${analyzedPct}%` }, meter: { percent: analyzedPct } },
           { label: 'Search index', value: index.detail, icon: ICONS.search, pill: { tone: index.tone, label: index.label } },
           { label: 'Safety', value: 'Source media is read-only; outputs stay in the active project analysis root.', icon: ICONS.safety, pill: { tone: 'pill-ok', label: 'Read-only' } },
         ]);
+        if (!clips.length) {
+          const list = $('overviewStatusList');
+          if (list) list.insertAdjacentHTML('afterbegin', chatPromptCard(
+            'This project has no source clips yet. Import media in Resolve, then ask your assistant to take it from there:',
+            'Look at my current Resolve project, inventory the media, and analyze the source clips.'
+          ));
+        }
       }
     }
@@ -5700,6 +5717,16 @@ HTML = r"""<!doctype html>
       analyzeBtn.disabled = !hasAnalyzableClips;
       copyBtn.disabled = !hasAnalyzableClips;
       setAnalyzeClientButtonsEnabled(hasAnalyzableClips);
+      if (!allClips.length) {
+        body.className = 'empty';
+        body.innerHTML = chatPromptCard(
+          'The Media Pool has no source clips yet. Import media in Resolve, then ask your assistant to inventory and analyze it:',
+          'Look at my current Resolve project, inventory the media, and analyze the source clips.'
+        );
+        updateMediaPollStatus();
+        renderControlPanels();
+        return;
+      }
       body.className = '';
       const rows = clips.map((clip, index) => {
         // The server normalizes 'succeeded'/'skipped' → 'analyzed' whenever the
@@ -6325,6 +6352,7 @@ HTML = r"""<!doctype html>
         state.resolveMediaStale = false;
         if (res.status === 304) return;
         const payload = await res.json();
+        if (payload && payload.unchanged) return;
         if (!res.ok || payload.success === false) {
           throw new Error(payload.error || res.statusText);
         }
@@ -6467,6 +6495,21 @@ HTML = r"""<!doctype html>
       }
     }
+    function chatPromptCard(message, prompt) {
+      return `<div class="empty" style="padding:var(--space-3);border:1px dashed var(--border-default);border-radius:var(--radius-md);display:grid;gap:8px;justify-items:start;text-align:left;">
+        <span>${escapeHtml(message)}</span>
+        <code style="font-size:12px;color:var(--text-secondary);white-space:normal;">\u201c${escapeHtml(prompt)}\u201d</code>
+        <button class="secondary" type="button" data-copy-chat-prompt="${escapeHtml(prompt)}">Copy prompt</button>
+      </div>`;
+    }
+    document.addEventListener('click', async (e) => {
+      const btn = e.target.closest('[data-copy-chat-prompt]');
+      if (!btn) return;
+      const ok = await writePromptToClipboard(btn.dataset.copyChatPrompt);
+      btn.textContent = ok ? 'Copied \u2014 paste in your chat session' : 'Copy prompt';
+      setTimeout(() => { btn.textContent = 'Copy prompt'; }, 2600);
+    });
     async function copyMcpPrompt() {
       const prompt = buildMcpPrompt();
       await writePromptToClipboard(prompt);
@@ -6829,6 +6872,7 @@ HTML = r"""<!doctype html>
       const interval = Number($('mediaPollInterval').value || 0);
       if (enabled && interval > 0) {
         state.mediaPollTimer = setInterval(() => {
+          if (document.hidden) return;
           refreshResolveMedia({ silent: true }).catch(error => {
             console.warn('Resolve media poll failed', error);
             updateMediaPollStatus(error.message || String(error));
@@ -7306,6 +7350,17 @@ HTML = r"""<!doctype html>
           <td style="padding:4px 6px;">${b.bytes_created ? fmtBytes(b.bytes_created) : '—'}</td>
         </tr>`;
       }).join('');
+      const recent = Array.isArray(data.recent) ? data.recent.slice(0, 8) : [];
+      const recentEl = $('resolveAiOpsRecent');
+      if (recentEl) {
+        recentEl.innerHTML = recent.length ? '<div class="caps-section-hint" style="margin-top:8px;">Recent runs</div>'
+          + recent.map(r => {
+            const when = (r.occurred_at || '').replace('T', ' ');
+            const who = r.actor ? ` · <span title="instance:pid that performed the op">${escapeHtml(r.actor)}</span>` : '';
+            const ok = r.success ? 'ok' : 'failed';
+            return `<div style="font-size:12px; color:var(--text-secondary); padding:2px 0;">${escapeHtml(when)} · ${escapeHtml(r.op)} · ${ok}${who}</div>`;
+          }).join('') : '';
+      }
       tableEl.style.display = '';
     }
@@ -7471,7 +7526,7 @@ HTML = r"""<!doctype html>
       standard: 'Sensible default',
       strict: 'Tight leash',
     };
-    state.aiGov = state.aiGov || { tier: 'standard', thresholds: {}, usage: {} };
+    state.aiGov = state.aiGov || { tier: 'standard', mode: 'advisory', thresholds: {}, usage: {} };
     function aiGovFmt(dim, v) {
       if (v == null) return '∞';
@@ -7515,14 +7570,26 @@ HTML = r"""<!doctype html>
         </div>`;
       }).join('');
     }
+    function renderGovMode() {
+      const el = $('aiGovMode');
+      if (!el) return;
+      const mode = state.aiGov.mode || 'advisory';
+      el.querySelectorAll('[data-gov-mode]').forEach(btn => {
+        const active = btn.dataset.govMode === mode;
+        btn.classList.toggle('active', active);
+        btn.setAttribute('aria-checked', active ? 'true' : 'false');
+      });
+    }
     async function refreshGovernance() {
       const data = await api('/api/resolve_ai/governance').catch(() => ({ success: false }));
       if (!data || !data.success) return;
       state.aiGov.tier = data.tier;
+      state.aiGov.mode = data.mode || 'advisory';
       state.aiGov.thresholds = data.thresholds || {};
       state.aiGov.usage = data.usage || {};
       state.aiGov.tiersAvailable = data.tiers_available || {};
       renderGovTiers();
+      renderGovMode();
       renderGovUsage();
     }
     async function setGovernanceTier(tier) {
@@ -7534,6 +7601,15 @@ HTML = r"""<!doctype html>
       if (!res || !res.success) console.warn('governance save failed:', res && res.error);
       await refreshGovernance();
     }
+    async function setGovernanceMode(mode) {
+      state.aiGov.mode = mode;
+      renderGovMode();
+      const res = await api('/api/resolve_ai/governance', {
+        method: 'POST', body: JSON.stringify({ mode }),
+      }).catch(err => ({ success: false, error: String(err) }));
+      if (!res || !res.success) console.warn('governance mode save failed:', res && res.error);
+      await refreshGovernance();
+    }
     function initAiConsole() {
       if (_aiConsoleInit) { renderAiConsole(); refreshGovernance().catch(() => {}); return; }
@@ -7549,6 +7625,13 @@ HTML = r"""<!doctype html>
           if (card && card.dataset.govTier) setGovernanceTier(card.dataset.govTier);
         });
       }
+      const govModeEl = $('aiGovMode');
+      if (govModeEl) {
+        govModeEl.addEventListener('click', (ev) => {
+          const btn = ev.target.closest('[data-gov-mode]');
+          if (btn && btn.dataset.govMode) setGovernanceMode(btn.dataset.govMode);
+        });
+      }
       refreshGovernance().catch(() => {});
     }
@@ -7979,7 +8062,7 @@ HTML = r"""<!doctype html>
         else if (view === 'shot') meta.textContent = `Shot ${state.review.currentShotIndex} of ${state.review.currentClipData?.card?.clip_name || 'clip'}`;
         else if (view === 'transcript') meta.textContent = `Transcript · ${state.review.currentClipData?.card?.clip_name || 'clip'}`;
         else if (view === 'combined') meta.textContent = `Combined review · ${state.review.combinedData?.clip_count || '?'} clips`;
-        else if (view === 'history') meta.textContent = 'Timeline history · versions and brain edits per timeline (C6)';
+        else if (view === 'history') meta.textContent = 'Timeline history · archived versions and brain edits per timeline';
       }
       if (opts.writePanelState !== false) {
         writePanelStateAsync({
@@ -8037,24 +8120,23 @@ HTML = r"""<!doctype html>
         ].map(stat => `<div class="readiness-stat ${stat.kind}"><span class="stat-value">${stat.value}</span><span class="stat-label">${escapeHtml(stat.label)}</span></div>`).join('');
       }
       if (details) {
+        const TRUST_LABELS = { trusted: 'Trusted source', unknown: 'Unverified source', untrusted: 'Untrusted source' };
+        const LAYER_LABELS = {
+          technical: 'Technical', motion: 'Motion', transcription: 'Transcript',
+          vision: 'Vision', cut_analysis: 'Cut analysis', readthrough: 'Readthrough',
+        };
         const trustChips = Object.entries(trustDist)
           .sort((a, b) => b[1] - a[1])
-          .map(([k, v]) => `<span class="chip" title="source_trust">${escapeHtml(k)}: ${v}</span>`)
+          .map(([k, v]) => `<span class="chip" title="clips by source trust">${escapeHtml(TRUST_LABELS[k] || k)} · ${v}</span>`)
           .join('');
-        const layerChips = ['technical', 'motion', 'transcription', 'vision', 'cut_analysis', 'readthrough']
-          .map(layer => `<span class="chip" title="layer present count">${escapeHtml(layer)}: ${layers[layer] || 0}</span>`)
+        const layerChips = Object.entries(LAYER_LABELS)
+          .filter(([layer]) => layers[layer])
+          .map(([layer, label]) => `<span class="chip" title="clips with this analysis layer">${escapeHtml(label)} · ${layers[layer]}</span>`)
           .join('');
-        details.innerHTML = `<span class="chip" style="background:none">source_trust:</span>${trustChips}<span class="chip" style="background:none">layers:</span>${layerChips}`;
+        details.innerHTML = trustChips + layerChips;
       }
     }
-    document.addEventListener('click', (e) => {
-      const target = e.target;
-      if (target && target.id === 'readinessRefreshBtn') {
-        refreshReadinessCard().catch(() => {});
-      }
-    });
     function populateBinFilter() {
       const data = state.review.clipList;
       const select = $('reviewBinFilter');
@@ -8097,10 +8179,16 @@ HTML = r"""<!doctype html>
       }
       const clips = filteredClips();
       if (!clips.length) {
-        if (summary) summary.textContent = state.review.binFilter
-          ? `No analyzed clips in bin "${state.review.binFilter}".`
-          : 'No analyzed clips yet — run analyze_clip first.';
-        if (grid) grid.innerHTML = '';
+        if (state.review.binFilter) {
+          if (summary) summary.textContent = `No analyzed clips in bin "${state.review.binFilter}".`;
+          if (grid) grid.innerHTML = '';
+        } else {
+          if (summary) summary.textContent = 'Nothing analyzed yet.';
+          if (grid) grid.innerHTML = chatPromptCard(
+            'Review fills in as clips are analyzed. Ask your assistant to analyze this project\u2019s media:',
+            'Analyze the source clips in my current Resolve project and build the search index.'
+          );
+        }
         return;
       }
       const selected = state.review.selectedBinClipIds;
@@ -8111,7 +8199,7 @@ HTML = r"""<!doctype html>
         const total = data.clips.length;
         const base = state.review.binFilter
           ? `${clips.length} of ${total} analyzed clip${total === 1 ? '' : 's'} · bin: ${state.review.binFilter}`
-          : `${total} analyzed clip${total === 1 ? '' : 's'} in ${data.project_root || 'this project'}.`;
+          : `${total} analyzed clip${total === 1 ? '' : 's'} in this project\u2019s analysis root.`;
         if (selected.size > 0) {
           summary.innerHTML = `<span>${escapeHtml(base)}</span>
             <span class="bin-selection-toolbar">
@@ -9215,7 +9303,7 @@ HTML = r"""<!doctype html>
       const safe = value == null ? '' : String(value);
       return `<div class="review-notes-row" data-notes-scope="${scope}">
         <div class="label">Notes</div>
-        <textarea data-notes-input="${scope}" placeholder="Editorial notes — saved to corrections.json…">${escapeHtml(safe)}</textarea>
+        <textarea data-notes-input="${scope}" placeholder="Editorial notes — saved with this clip\u2019s analysis and preserved on re-analysis\u2026">${escapeHtml(safe)}</textarea>
         <div class="controls">
           <button class="secondary" data-notes-save="${scope}" type="button">Save notes</button>
           <span class="saved" data-notes-saved="${scope}" style="opacity:0">Saved</span>
@@ -9402,13 +9490,21 @@ HTML = r"""<!doctype html>
         extrasHtml += `<div class="group"><div class="group-title">QC flags</div><div class="chip-row" style="display:flex;flex-wrap:wrap;gap:4px">${qcFlags.map(f => `<span class="review-chip">${escapeHtml(String(f))}</span>`).join('')}</div></div>`;
       }
       if (Array.isArray(shot.frame_indices_used) && shot.frame_indices_used.length) {
-        extrasHtml += `<div class="group"><div class="group-title">Frame indices</div><div class="value" style="font-family:var(--font-mono);font-size:12px;color:var(--text-secondary)">${escapeHtml(shot.frame_indices_used.join(', '))}</div></div>`;
+        const n = shot.frame_indices_used.length;
+        extrasHtml += `<div class="group"><div class="group-title">Sampled frames</div><div class="value" style="font-size:12px;color:var(--text-secondary)" title="frame indices ${escapeHtml(shot.frame_indices_used.join(', '))}">${n} frame${n === 1 ? '' : 's'} sampled from this shot (shown below)</div></div>`;
       }
       const emptyHint = !hasAnyGroup && !editing
         ? `<div class="empty" style="padding:var(--space-3);border:1px dashed var(--border-default);border-radius:var(--radius-md);color:var(--text-tertiary);font-size:12px">Shot-level analysis fields aren't populated in the report. The clip-level analysis blocks (above on the clip detail page) cover this clip. Re-run analysis with a fuller vision pass to fill in per-shot Visual / Content / Editorial fields.</div>`
         : '';
       $('reviewShotFields').innerHTML = groupsHtml + extrasHtml + emptyHint;
       const frames = data.frames || [];
+      const FRAME_REASON_LABELS = {
+        shot_start: 'Shot start', shot_end: 'Shot end', shot_progress: 'Mid-shot',
+        shot_representative: 'Key frame', cut_after: 'After cut', cut_before: 'Before cut',
+        flash_candidate: 'Flash frame', motion_peak: 'Motion peak', interval: 'Interval sample',
+        scene_change: 'Scene change', first_usable: 'First usable', last_usable: 'Last usable',
+        midpoint: 'Midpoint',
+      };
       $('reviewShotFrames').innerHTML = frames.map(f => {
         const peak = f.motion_peak ? 'peak' : '';
         const src = clipId ? `/api/clips/${encodeURIComponent(clipId)}/frames/${f.frame_index}` : '';
@@ -9416,7 +9512,7 @@ HTML = r"""<!doctype html>
           ${src ? `<img class="review-thumb" loading="lazy" src="${src}" alt="frame ${f.frame_index}" onerror="this.replaceWith(Object.assign(document.createElement('div'),{className:'review-thumb placeholder',textContent:'frame missing'}))">` : ''}
           <div class="label">
             <span>${f.time_seconds != null ? `${Number(f.time_seconds).toFixed(2)}s` : `#${f.frame_index}`}</span>
-            <span>${escapeHtml(f.selection_reason || '')}</span>
+            <span title="${escapeHtml(f.selection_reason || '')}">${escapeHtml(FRAME_REASON_LABELS[f.selection_reason] || f.selection_reason || '')}</span>
           </div>
         </div>`;
       }).join('');
@@ -9562,7 +9658,11 @@ HTML = r"""<!doctype html>
     function ensureReviewPanelStateTimer() {
       if (state.review.panelStateTimer) return;
+      state.review.panelStateTick = 0;
       state.review.panelStateTimer = window.setInterval(() => {
+        if (document.hidden) return;
+        state.review.panelStateTick = (state.review.panelStateTick + 1) % 5;
+        if (!document.hasFocus() && state.review.panelStateTick !== 0) return;
         if (state.activePanel === 'analysis' && state.activeSubpages.analysis === 'review') {
           pollPanelStateOnce().catch(() => {});
         }
@@ -9658,9 +9758,11 @@ HTML = r"""<!doctype html>
       const active = new Set((activeValues || []).map(value => String(value || '').trim()).filter(Boolean));
       const values = uniqueValues(candidates || [], Array.from(active));
       hidden.value = Array.from(active).join(', ');
-      container.innerHTML = values.map(value => `
-        <button type="button" class="token-pill${active.has(value) ? ' active' : ''}" data-token-value="${escapeHtml(value)}" aria-pressed="${active.has(value) ? 'true' : 'false'}">${escapeHtml(value)}</button>
-      `).join('');
+      container.innerHTML = values.map(value => {
+        const label = String(value).replace(/_/g, ' ');
+        return `
+        <button type="button" class="token-pill${active.has(value) ? ' active' : ''}" data-token-value="${escapeHtml(value)}" aria-pressed="${active.has(value) ? 'true' : 'false'}" title="${escapeHtml(value)}">${escapeHtml(label)}</button>
+      `; }).join('');
       container.querySelectorAll('[data-token-value]').forEach(button => {
         button.addEventListener('click', () => {
           button.classList.toggle('active');
@@ -9964,14 +10066,14 @@ HTML = r"""<!doctype html>
       if (options.updateHash !== false) {
         updateRouteHash('docs', state.activeDoc);
       }
-      const rendered = renderMarkdown(payload.content || '');
+      const rendered = renderMarkdown(payload.content || '', payload.path || '');
       setHtml('docReader', rendered.html);
       renderDocSectionNav(rendered.sections);
       setText('docSource', payload.path || '');
       applyDocFilters();
     }
-    function renderMarkdown(markdown) {
+    function renderMarkdown(markdown, docPath) {
       const lines = String(markdown || '').split(/\r?\n/);
       const parts = [];
       const sections = [];
@@ -10000,7 +10102,9 @@ HTML = r"""<!doctype html>
         const line = rawLine.trimEnd();
         if (!line.trim()) continue;
         const badgeMatches = parseBadgeTokens(line.trim());
-        if (badgeMatches.length) {
+        // Badge rows are external status shields; a linked LOCAL image (e.g.
+        // the README's control-panel screenshot) must reach the image handlers.
+        if (badgeMatches.length && badgeMatches.every(token => /^https?:/i.test(token.src))) {
           while (index + 1 < lines.length) {
             const nextMatches = parseBadgeTokens(lines[index + 1].trim());
             if (!nextMatches.length) break;
@@ -10029,9 +10133,14 @@ HTML = r"""<!doctype html>
           parts.push(`<h${level} id="${id}" class="doc-block" data-md-type="heading">${inlineMarkdown(heading[2])}</h${level}>`);
           continue;
         }
+        const linkedImage = line.match(/^\[!\[([^\]]*)\]\(([^)]+)\)\]\(([^)]+)\)$/);
+        if (linkedImage) {
+          parts.push(renderImageBlock(linkedImage[1], linkedImage[2], docPath));
+          continue;
+        }
         const image = line.match(/^!\[([^\]]*)\]\(([^)]+)\)$/);
         if (image) {
-          parts.push(renderImageBlock(image[1], image[2]));
+          parts.push(renderImageBlock(image[1], image[2], docPath));
           continue;
         }
         const bullet = line.match(/^[-*]\s+(.+)$/) || line.match(/^\d+\.\s+(.+)$/);
@@ -10099,8 +10208,27 @@ HTML = r"""<!doctype html>
       return tokens;
     }
-    function renderImageBlock(alt, src) {
-      return `<figure class="doc-image doc-block" data-md-type="image"><img src="${escapeAttribute(src)}" alt="${escapeAttribute(alt || src)}" loading="lazy"></figure>`;
+    function resolveDocAsset(src, docPath) {
+      const clean = String(src || '').trim();
+      if (/^(https?:|data:|\/)/i.test(clean)) return clean;
+      const stack = [];
+      const parts = String(docPath || '').split('/').slice(0, -1).concat(clean.split('/'));
+      for (const part of parts) {
+        if (!part || part === '.') continue;
+        if (part === '..') { stack.pop(); continue; }
+        stack.push(part);
+      }
+      const rel = stack.join('/');
+      const marker = 'docs/images/';
+      if (rel.startsWith(marker)) {
+        return '/api/doc_asset/' + rel.slice(marker.length).split('/').map(encodeURIComponent).join('/');
+      }
+      return clean;
+    }
+    function renderImageBlock(alt, src, docPath) {
+      const resolved = resolveDocAsset(src, docPath);
+      return `<figure class="doc-image doc-block" data-md-type="image"><img src="${escapeAttribute(resolved)}" alt="${escapeAttribute(alt || src)}" loading="lazy"></figure>`;
     }
     function renderMarkdownTable(lines) {
@@ -10280,6 +10408,13 @@ HTML = r"""<!doctype html>
         closeNavDropdowns();
         closeActionMenus();
         setPanel(control.dataset.panelTarget, { subpage: control.dataset.subpageTarget });
+        if (control.dataset.reviewView === 'history') {
+          reviewSetView('history');
+          refreshHistoryTimelines().catch(alertError);
+          if (window.location.hash !== '#analysis/review/history') {
+            window.history.replaceState(null, '', '#analysis/review/history');
+          }
+        }
       });
     });
     document.querySelectorAll('[data-doc]').forEach(control => {
@@ -10456,7 +10591,7 @@ HTML = r"""<!doctype html>
     refreshRestartBanner().catch(() => {});
     // Poll for restart marker every 30s
     if (state.updates.restartTimer) clearInterval(state.updates.restartTimer);
-    state.updates.restartTimer = setInterval(() => refreshRestartBanner().catch(() => {}), 30000);
+    state.updates.restartTimer = setInterval(() => { if (!document.hidden) refreshRestartBanner().catch(() => {}); }, 30000);
     // Auto-save preference (server-side preference; reads via /api/setup/defaults)
     $('prefAutoSaveAfterArchive')?.addEventListener('change', async e => {
@@ -13972,9 +14107,13 @@ class Handler(BaseHTTPRequestHandler):
         raw = json.dumps(payload, ensure_ascii=False, default=str).encode("utf-8")
         etag = '"' + hashlib.md5(raw).hexdigest() + '"'
         if self.headers.get("If-None-Match") == etag:
-            self.send_response(HTTPStatus.NOT_MODIFIED)
+            tiny = json.dumps({"success": True, "unchanged": True, "etag": etag}).encode("utf-8")
+            self.send_response(200)
+            self.send_header("Content-Type", "application/json; charset=utf-8")
+            self.send_header("Content-Length", str(len(tiny)))
             self.send_header("ETag", etag)
             self.end_headers()
+            self.wfile.write(tiny)
             return
         self.send_response(200)
         self.send_header("Content-Type", "application/json; charset=utf-8")
@@ -14105,6 +14244,21 @@ class Handler(BaseHTTPRequestHandler):
             payload = _dashboard_doc(doc)
             self._json(payload, 200 if payload.get("success") else 404)
             return
+        if path.startswith("/api/doc_asset/"):
+            rel = unquote(path[len("/api/doc_asset/"):])
+            base = os.path.realpath(os.path.join(_repo_root(), "docs", "images"))
+            full = os.path.realpath(os.path.join(base, rel))
+            if not (full.startswith(base + os.sep) or full == base):
+                self._json({"success": False, "error": "path escape"}, HTTPStatus.FORBIDDEN)
+                return
+            content_types = {".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg",
+                             ".gif": "image/gif", ".svg": "image/svg+xml", ".webp": "image/webp"}
+            ext = os.path.splitext(full)[1].lower()
+            if ext not in content_types or not os.path.isfile(full):
+                self._json({"success": False, "error": "not found"}, HTTPStatus.NOT_FOUND)
+                return
+            self._serve_file(full, content_types[ext])
+            return
         if path == "/api/setup/schema":
             self._json(_setup_defaults("schema"))
             return
@@ -14678,6 +14832,8 @@ def _warm_inventory_cache(project_root: str) -> None:
 def main() -> None:
+    from src.utils import actor_identity
+    actor_identity.set_instance("control-panel")
     args = parse_args()
     state = DashboardState(args.project_name, args.project_id, args.analysis_root)
     Handler.state = state

package/src/batch_cli.py CHANGED Viewed

@@ -526,6 +526,8 @@ _HANDLERS = {
 def main(argv: Optional[List[str]] = None) -> int:
+    from src.utils import actor_identity
+    actor_identity.set_instance("batch-cli")
     parser = _build_parser()
     args = parser.parse_args(argv)
     if not hasattr(args, "json"):

package/src/granular/common.py CHANGED Viewed

@@ -80,7 +80,7 @@ if not logging.getLogger().handlers:
         handlers=[logging.StreamHandler()],
     )
-VERSION = "2.38.0"
+VERSION = "2.40.0"
 logger = logging.getLogger("davinci-resolve-mcp")
 logger.info(f"Starting DaVinci Resolve MCP Server v{VERSION}")
 logger.info(f"Detected platform: {get_platform()}")