davinci-resolve-mcp 2.39.0 → 2.40.0

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 Release history for the DaVinci Resolve MCP Server. The latest release is summarized in the root README; older entries live here to keep the README focused.
 
+## What's New in v2.40.0
+
+Control panel UX overhaul + docs refresh, from a full live audit of every
+panel view, with drift guards so neither can silently go stale again.
+
+- **Added** a governance mode toggle (Advisory / Enforce) to the AI Console,
+  with corrected copy (the old text predated v2.39.0 enforce mode), and a
+  Recent-runs list on the AI-ops ledger showing each run's actor.
+- **Added** chat-first onboarding: empty Overview, Review, and Inventory
+  states show plain-language guidance with a copyable suggested prompt
+  instead of zero-walls and MCP action names.
+- **Added** History as a first-class Media menu item, deep-linkable at
+  `#analysis/review/history`; documented the full hash deep-link scheme.
+- **Changed** the top-level "Analysis" menu to "Media" (it collided with the
+  Preferences page of the same name); "Analyze" is now "Inventory". Full
+  vocabulary pass: humanized readiness chips and frame-sampling labels, no
+  internal codenames, file names, or absolute paths in UI copy.
+- **Fixed** the README's linked screenshot rendering broken in the Docs
+  reader: badge parsing no longer claims local linked images, and a new
+  `/api/doc_asset/` route serves repo doc images (path-constrained).
+- **Fixed** poll hygiene: timers pause while the tab is hidden, panel-state
+  polling backs off when unfocused, and unchanged inventory polls return a
+  tiny 200 instead of a 304 that Chrome logged as an aborted request.
+- **Docs**: `docs/guides/control-panel.md` fully rewritten for the current
+  IA with all screenshots regenerated from the live panel
+  (`scripts/regen_panel_screenshots.py`). A new drift-guard test fails the
+  suite — and the publish workflow, which now runs all three static guards
+  on every tag — when the guide drifts from the panel's navigation or
+  screenshots.
+
 ## What's New in v2.39.0
 
 Governance enforce mode and actor identity — the staged Phase 3 of the

package/README.md

@@ -1,6 +1,6 @@
 # DaVinci Resolve MCP Server
 
-[![Version](https://img.shields.io/badge/version-2.39.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.40.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
 [![npm](https://img.shields.io/npm/v/davinci-resolve-mcp.svg?label=npm&color=CB3837)](https://www.npmjs.com/package/davinci-resolve-mcp)
 [![API Coverage](https://img.shields.io/badge/API%20Coverage-100%25-brightgreen.svg)](docs/reference/api-coverage.md)
 [![Tools](https://img.shields.io/badge/MCP%20Tools-33%20(341%20full)-blue.svg)](#server-modes)

package/docs/guides/control-panel.md

@@ -1,9 +1,9 @@
 # Local Control Panel
 
-The DaVinci Resolve MCP ships with a local, single-user browser control panel for
-inspecting Resolve state, running source-safe media analysis, drilling into
-analyzed clips and shots, fixing analysis output inline, and managing
-preferences.
+The DaVinci Resolve MCP ships with a local, single-user browser control panel
+for inspecting Resolve state, running source-safe media analysis, drilling into
+analyzed clips and shots, fixing analysis output inline, reviewing timeline
+edit history, driving Resolve's local AI operations, and managing preferences.
 
 The panel is a local HTTP server (default `http://127.0.0.1:8765`). It does not
 expose a network listener beyond loopback and does not modify source media.
@@ -21,8 +21,29 @@ npx davinci-resolve-mcp control-panel
 resolve_control(action="open_control_panel")
 ```
 
-Once running, you can `resolve_control(action="control_panel_status")` to check
-the pidfile or `resolve_control(action="close_control_panel")` to stop it.
+Once running, `resolve_control(action="control_panel_status")` checks the
+pidfile and `resolve_control(action="close_control_panel")` stops it.
+
+## Navigation and deep links
+
+Top-level sections: **Overview**, **Media** (Inventory / Review / History),
+**AI Console**, **Setup** (Resolve / MCP / Storage / Tools / Media Pool
+History), **Docs**, and **Preferences** (Analysis / Caps + Safety / Metadata
+and Markers / Paths and Workflow / MCP Updates). The project selector on the
+right scopes the panel to an analysis context; **View All Projects** opens a
+read-only browser over the Resolve project database with confirm-gated
+loading.
+
+Every view is addressable by URL hash, so links can be bookmarked or pasted
+into chat:
+
+```
+#overview                                  #aiconsole
+#analysis/media                            #analysis/review
+#analysis/review/history                   #analysis/review/clip/<clip_id>
+#analysis/review/clip/<clip_id>/shot/<n>   #analysis/review/clip/<clip_id>/transcript
+#diagnostics/mcp                           #preferences/caps
+```
 
 ## Tour
 
@@ -30,78 +51,125 @@ the pidfile or `resolve_control(action="close_control_panel")` to stop it.
 
 ![Control panel overview](../images/control-panel/01-overview.png)
 
-The Overview tab is the at-a-glance summary for the active project: Resolve
-connection state, source clip counts, analysis progress, search index size,
-and the source-media safety status.
+The at-a-glance summary for the active project: Resolve connection state,
+source clip counts, analysis progress, search-index status, and the
+source-media safety posture. When the project has no source clips yet, the
+view shows a get-started card with a suggested chat prompt and a
+**Copy prompt** button — the panel is summoned by conversation, and its empty
+states point back into it.
 
-### Analysis → Analyze
+### Media → Inventory
 
-![Analyze view](../images/control-panel/06-analyze.png)
+![Inventory view](../images/control-panel/06-inventory.png)
 
-The Analyze view inventories the Resolve media pool read-only and lets you
-queue source-safe analysis jobs. Filters cover bin, media type, clip status,
-and analysis status. Resolve media stays read-only; analysis outputs land under
-the configured analysis root.
+Inventory walks the Resolve Media Pool read-only and filters to source clips so
+timelines, compounds, titles, and generated items stay out of analysis queues.
+Filters cover bin, media type, clip status, and analysis status, with optional
+auto-refresh polling. From here you can select analyzable clips, copy a
+ready-made analysis prompt for your chat session, or launch a supported chat
+client directly.
 
-### Analysis → Review (bin grid)
+### Media → Review
 
 ![Review bin grid](../images/control-panel/02-review-bin-grid.png)
 
-The Review surface is the browser for analyzed clips. Each card shows a
-representative thumbnail, summary one-liner, primary use, shot count, and tags.
-Click into a card to drill down.
+Review is the browser for analyzed clips. The readiness strip summarizes the
+evidence base (analyzed / superseded / vision-pending / warnings) with
+humanized source-trust and analysis-layer chips. Cards show a representative
+thumbnail, duration, shot count, status, and summary one-liner; grid and list
+layouts are available, and full-text search covers clips, summaries, tags, and
+transcripts once the search index is built.
 
 ### Clip detail
 
 ![Clip detail with shot strip](../images/control-panel/03-clip-detail.png)
 
-The clip view shows the full summary, tags, editorial notes, and a strip of
-every detected shot with thumbnails. From here you can open the clip in
-Resolve, jump to the transcript, or click into any shot for the full V2 field
-breakdown.
+The clip view shows the full summary, tags, star rating, editorial notes, and
+a contact sheet of every detected shot. From here you can open the clip in
+Resolve, jump to the transcript, or click into any shot.
 
 ### Transcript
 
 ![Transcript view with word-level timing](../images/control-panel/04-transcript.png)
 
-The transcript view is reachable from the clip detail (top-right `Transcript`
-button). Each segment shows its start timecode, the cleaned sentence, and the
-word-level transcription beneath. The segment filter narrows by text; clicking
-a segment can jump the Resolve playhead to that source time. `Re-transcribe
-with words` re-runs the configured local transcription backend (Whisper by
-default) without re-doing visual analysis, and `corrections.json` captures
-inline edits so they survive future re-runs.
+Each segment shows its start time, the cleaned sentence, and the original
+machine transcription beneath. Inline edits are preserved across re-analysis,
+and `Re-transcribe with words` re-runs the configured local transcription
+backend (Whisper by default) without re-doing visual analysis.
 
 ### Shot detail with inline correction
 
-![Shot detail with V2 fields and frames](../images/control-panel/05-shot-detail.png)
+![Shot detail with fields and frames](../images/control-panel/05-shot-detail.png)
 
-The shot view shows every V2 schema field (shot size, framing, camera height,
-motion direction, lens character, lighting, composition notes, and more)
-alongside the frames the vision pass actually saw. Each subjective field is
-editable inline — edits land in `corrections.json` with an append-only
-changelog and are merged on top of the next re-analysis so human notes survive
-fresh vision runs. `Open in Resolve` bounces you straight to the clip in the
-source viewer with the shot's mark in/out set.
+The shot view shows the analysis fields for the shot alongside the frames the
+vision pass actually sampled, each labeled with why it was chosen ("Shot
+start", "After cut", "Flash frame", "Motion peak"). Subjective fields are
+editable inline; edits are kept with the clip's analysis and merged on top of
+future re-analysis so human notes survive fresh vision runs. `Open in Resolve`
+jumps straight to the clip in the source viewer with the shot's mark in/out
+set.
 
-### Setup → Resolve diagnostic
+### Media → History
 
-![Setup / Resolve diagnostic](../images/control-panel/07-diagnostics-resolve.png)
+![Timeline history](../images/control-panel/10-history.png)
 
-The Resolve diagnostic page reports the live connection, product/version,
-active page, project identity, and media pool inventory. Useful when chat
-sessions need to confirm Resolve is reachable before issuing scripted
-operations.
+The timeline edit history: archived timeline versions and brain edits per
+timeline. Begin/end labeled runs to group related edits, archive the current
+timeline before risky work, and select any timeline to inspect its version
+chain and the edits between versions. Every destructive timeline edit made
+through the MCP archives a version here automatically.
+
+### AI Console
+
+![AI Console with governance](../images/control-panel/09-ai-console.png)
+
+Runs Resolve's local AI operations (audio classification, IntelliSearch, slate
+analysis, transcription, motion deblur, speech generation) on the current
+Media Pool folder or a specific clip. Capability dots show what this Resolve
+build exposes and which AI Extras are required. The **Governance** card sets
+the per-session tier (off / lenient / standard / strict) for the two
+media-creating ops and the governance **mode**: *Advisory* warns in the
+confirm dialog; *Enforce* refuses an over-tier run until you raise the tier,
+relax the mode, or consciously override. Usage gauges track runs, media
+created, and render time against the active tier, and the AI-ops ledger
+(Preferences → Caps + Safety) records every run with the acting instance.
+
+### Setup
+
+![Setup / Resolve diagnostic](../images/control-panel/07-diagnostics-resolve.png)
 
-### Preferences → Analysis
+- **Resolve** — live connection, product/version, active page, project
+  identity, and Media Pool inventory.
+- **MCP** — server identity, detected Resolve scripting paths, transport
+  status (with a start button for the networked mode), and per-client install
+  status with one-click install/repair for every supported harness.
+- **Storage** — the analysis root, search index, and jobs database paths and
+  sizes for the active project.
+- **Tools** — runtime helpers (ffprobe, ffmpeg, Whisper backends, OpenCV)
+  with ready/missing status and copyable install commands.
+- **Media Pool History** — the provenance log for destructive media-pool
+  operations (deletes, replaces, relinks), kept separate from timeline brain
+  edits.
+
+### Preferences
 
 ![Preferences / Analysis defaults](../images/control-panel/08-preferences-analysis.png)
 
-Server-wide analysis defaults: vision on/off, transcription default, slate
-detection, source-trust grading (`auto` / `filename` / `low` / `medium` /
-`high`), default analysis depth, default sample frame count, persistence
-behavior, summary style, and report format. These are the defaults the
-`analyze_media` prompt uses when not overridden per call.
+Server-wide defaults for this MCP install (dashboard-only conveniences stay in
+the browser):
+
+- **Analysis** — vision/transcription defaults, slate detection, source-trust
+  grading, depth, frame-sampling mode, summary style, report format.
+- **Caps + Safety** — token and frame budget presets (minimal / standard /
+  generous / unlimited) with live usage gauges, per-clip/job/day caps, the
+  Resolve AI-ops ledger, and destructive-edit safety rails.
+- **Metadata and Markers** — Resolve metadata write-back fields, timed-marker
+  defaults, marker types and colors, overwrite policy.
+- **Paths and Workflow** — preferred analysis root, generated-media folder,
+  post-operation page behavior, and a read-only map of where files live.
+- **MCP Updates** — update policy (prompt / notify / auto / never), release
+  channel (stable / beta / dev), check cadence, apply/rollback with update
+  history.
 
 ## Chat ↔ panel state sharing
 
@@ -115,8 +183,9 @@ active project's analysis root). MCP actions:
 - `media_analysis(action="session_start_context")` — bootstrap a chat session
   with the panel's current focus
 
-The dashboard polls `/api/panel_state` every 2 seconds, so changes from chat
-appear in the UI without a refresh.
+The dashboard polls `/api/panel_state` every 2 seconds while it has focus,
+backs off to roughly every 10 seconds when the window is unfocused, and stops
+polling entirely while the tab is hidden.
 
 ## Open in Resolve
 

package/docs/process/release-process.md

@@ -30,6 +30,11 @@ Every release bump must update all version surfaces:
 - README current stats or latest-release summary when they changed
 - `CHANGELOG.md` latest release entry
 - `docs/SKILL.md` when tool discovery, examples, or behavior changed
+- `docs/guides/control-panel.md` when the control panel UI changed, plus
+  regenerated screenshots: start the panel against a project with analysis
+  data, then run `venv/bin/python scripts/regen_panel_screenshots.py`.
+  The `tests.test_panel_docs_drift` guard fails the suite (and the publish
+  workflow) when the guide drifts from the panel's navigation or screenshots.
 - Git tag, e.g. `v2.4.1`
 - GitHub Release notes
 
@@ -43,12 +48,18 @@ Always run static checks before release:
 ```bash
 venv/bin/python tests/test_import.py
 venv/bin/python scripts/audit_api_parity.py
+venv/bin/python -m unittest tests.test_static_undefined_names tests.test_action_list_drift tests.test_panel_docs_drift
 node bin/davinci-resolve-mcp.mjs --help
 node bin/davinci-resolve-mcp.mjs --version
 npm pack --dry-run
 git diff --check
 ```
 
+The three drift guards (undefined names in `src/`, tool action lists vs
+dispatch, control-panel guide vs panel navigation/screenshots) also run in the
+`Publish npm package` workflow on every `v*` tag, so a stale doc or drifted
+action list fails the publish — fix the drift rather than bypassing the gate.
+
 Run focused unit tests for the changed surface. For recent timeline/marker
 helpers, this usually includes:
 

package/install.py

@@ -35,7 +35,7 @@ from src.utils.update_check import (
 
 # ─── Version ──────────────────────────────────────────────────────────────────
 
-VERSION = "2.39.0"
+VERSION = "2.40.0"
 # Only hard floor: mcp[cli] requires Python 3.10+. There is no upper bound —
 # Resolve's scripting bridge loads into newer interpreters on recent builds
 # (Python 3.14 verified against Resolve Studio 20.3.2). Older Resolve builds

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "davinci-resolve-mcp",
-  "version": "2.39.0",
+  "version": "2.40.0",
   "description": "NPM bootstrapper for the DaVinci Resolve MCP Server.",
   "license": "MIT",
   "author": "Samuel Gursky <samgursky@gmail.com>",

package/scripts/regen_panel_screenshots.py

@@ -0,0 +1,75 @@
+#!/usr/bin/env python3
+"""Regenerate the control-panel doc screenshots from a live panel.
+
+Drives the panel's hash deep links headlessly and writes 1280x800 captures
+into docs/images/control-panel/. Run whenever the panel UI changes visibly.
+
+Setup:
+  1. venv/bin/pip install playwright  (chromium is fetched on first run if absent)
+  2. Start the panel bound to a project that HAS an analyzed clip, e.g.:
+       venv/bin/python -m src.control_panel --no-open
+     (Bind to a rich analysis context if the live Resolve project is empty.)
+  3. venv/bin/python scripts/regen_panel_screenshots.py [--clip-id <id>] [--port 8765]
+
+The clip id defaults to the first analyzed clip reported by /api/clips.
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import pathlib
+import sys
+import urllib.request
+
+OUT_DIR = pathlib.Path(__file__).resolve().parent.parent / "docs" / "images" / "control-panel"
+
+
+def first_clip_id(base: str) -> str:
+    with urllib.request.urlopen(f"{base}/api/clips", timeout=10) as resp:
+        payload = json.load(resp)
+    clips = payload.get("clips") or []
+    if not clips:
+        sys.exit("No analyzed clips in the panel's project — bind the panel to a project with analysis data first.")
+    return clips[0]["clip_id"]
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--port", type=int, default=8765)
+    parser.add_argument("--clip-id", default=None)
+    args = parser.parse_args()
+    base = f"http://127.0.0.1:{args.port}"
+
+    try:
+        from playwright.sync_api import sync_playwright
+    except ImportError:
+        sys.exit("playwright not installed: venv/bin/pip install playwright")
+
+    clip = args.clip_id or first_clip_id(base)
+    shots = [
+        ("#overview", "01-overview.png", 3000),
+        ("#analysis/review", "02-review-bin-grid.png", 3500),
+        (f"#analysis/review/clip/{clip}", "03-clip-detail.png", 4000),
+        (f"#analysis/review/clip/{clip}/transcript", "04-transcript.png", 4000),
+        (f"#analysis/review/clip/{clip}/shot/3", "05-shot-detail.png", 4500),
+        ("#analysis/media", "06-inventory.png", 3500),
+        ("#diagnostics/resolve", "07-diagnostics-resolve.png", 3000),
+        ("#preferences/analysis", "08-preferences-analysis.png", 3000),
+        ("#aiconsole", "09-ai-console.png", 3000),
+        ("#analysis/review/history", "10-history.png", 3500),
+    ]
+    with sync_playwright() as pw:
+        browser = pw.chromium.launch()
+        page = browser.new_page(viewport={"width": 1280, "height": 800})
+        for hash_, name, wait in shots:
+            page.goto(f"{base}/{hash_}")
+            page.wait_for_timeout(wait)
+            page.screenshot(path=str(OUT_DIR / name))
+            print("shot:", name)
+        browser.close()
+    print(f"done — {len(shots)} screenshots in {OUT_DIR}")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/src/analysis_dashboard.py

@@ -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

package/src/granular/common.py

@@ -80,7 +80,7 @@ if not logging.getLogger().handlers:
         handlers=[logging.StreamHandler()],
     )
 
-VERSION = "2.39.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()}")

package/src/server.py

@@ -11,7 +11,7 @@ Usage:
     python src/server.py --full       # Start the 341-tool granular server instead
 """
 
-VERSION = "2.39.0"
+VERSION = "2.40.0"
 
 import base64
 import os