davinci-resolve-mcp 2.97.0 → 2.97.2

package/CHANGELOG.md

@@ -2,6 +2,61 @@
 
 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.97.2
+
+**The panel's inventory snapshot survives a large project.** Follow-up to the
+v2.97.1 fix: now that `inventory_limit` actually reaches the panel, the cache it
+feeds has to cope with what arrives.
+
+### Fixed
+
+- **The localStorage snapshot silently stopped working above ~5MB.** The panel
+  caches the last inventory so reopening it paints the previous view instantly
+  instead of "connection pending". That write was unbounded — and with
+  `inventory_limit` reaching 10000 clips, each carrying a file path, bin path,
+  status reasons, and the analysis overlay, it overruns the per-origin quota. The
+  write then threw, was caught, logged a `console.warn` no one reads, and the
+  instant-paint feature quietly did nothing on exactly the big projects where a
+  slow first fetch makes it worth having. The snapshot is now capped at 750
+  clips; on a quota failure the panel prunes cached inventories (including
+  snapshots for projects the user has moved on from) and retries once, and if
+  that still fails it removes its own key so a snapshot cannot outlive the walk
+  it described.
+- **A truncated snapshot no longer reads as a complete inventory.** A capped
+  snapshot carries `snapshot_partial` and the true clip count, and both surfaces
+  that show a number say so — the header reads `(cached preview of 3015)` and the
+  poll status reads `cached first 750 of 3015`. Capping the cache without this
+  would have re-created the v2.97.1 bug one layer down: a number presented as the
+  inventory that isn't.
+
+### Added
+
+- `tests/test_dashboard_inventory_snapshot.py` — guards that the inventory fetch
+  sends no `limit` of its own (the v2.97.1 regression), that the snapshot stays
+  capped, and that a partial snapshot declares itself.
+
+## What's New in v2.97.1
+
+**The control panel honors `media_analysis.inventory_limit` again.** Thanks to
+[@albertfdp](https://github.com/albertfdp) for finding and fixing this
+([#148](https://github.com/samuelgursky/davinci-resolve-mcp/pull/148)).
+
+### Fixed
+
+- **A configurable preference the panel could never reach.** `/api/resolve/media`
+  falls back to the `media_analysis.inventory_limit` preference (1–10000,
+  default 500) when the request carries no `limit`, and the Preferences pane has
+  always let you set it. But `refreshResolveMedia()` — the panel's only caller of
+  that endpoint, used for the first load, the manual refresh button, and the
+  background poll alike — hardcoded `?limit=500`, so the query param won every
+  time and the preference was inert. On a 3015-clip project the Overview panel
+  showed the first 500 clips and rendered real Media Pool bins as empty. The
+  fetch no longer sends `limit`; the server-side preference applies. Verified
+  against a live 3015-clip project: 3015 clips across 32 bins after the fix.
+
+This is the silent-lie class again — a setting that round-trips through the
+preferences store, reports itself as saved, and changes nothing observable.
+
 ## What's New in v2.97.0
 
 **`timeline_frame(action="capture")` now renders the frame.** v2.96.0 shipped it

package/README.md

@@ -2,7 +2,7 @@
 
 English | [简体中文](README.zh-CN.md)
 
-[![Version](https://img.shields.io/badge/version-2.97.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.97.2-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-35%20(353%20full)-blue.svg)](#server-modes)

package/README.zh-CN.md

@@ -2,7 +2,7 @@
 
 [English](README.md) | 简体中文
 
-[![Version](https://img.shields.io/badge/version-2.97.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.97.2-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-35%20(353%20full)-blue.svg)](#服务器模式)
@@ -12,7 +12,7 @@
 [![Python](https://img.shields.io/badge/python-3.10+-green.svg)](https://www.python.org/downloads/)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-> 本翻译对应 v2.97.0 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
+> 本翻译对应 v2.97.2 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
 
 一个 Model Context Protocol (MCP) 服务器，让 AI 助手通过官方脚本 API 控制 DaVinci Resolve Studio（达芬奇）。它提供完整的 API 覆盖，外加带护栏的工作流助手，涵盖剪辑、媒体池整理、渲染设置、审阅标记、调色、Fusion、Fairlight、项目生命周期任务、扩展开发，以及不碰源媒体的媒体分析。
 

package/install.py

@@ -37,7 +37,7 @@ from src.utils.update_check import (
 
 # ─── Version ──────────────────────────────────────────────────────────────────
 
-VERSION = "2.97.0"
+VERSION = "2.97.2"
 # 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.97.0",
+  "version": "2.97.2",
   "description": "NPM bootstrapper for the DaVinci Resolve MCP Server.",
   "license": "MIT",
   "author": "Samuel Gursky <samgursky@gmail.com>",

package/src/analysis_dashboard.py

@@ -5981,7 +5981,10 @@ HTML = r"""<!doctype html>
       const clips = filteredResolveClips(allClips);
       const projectLabel = payload.project?.name || 'Current Resolve project';
       const visibleCounts = summarizeVisibleClips(clips);
-      project.textContent = `${projectLabel} · ${clipLabel(clips.length)}`;
+      // A cached snapshot may hold only the first INVENTORY_SNAPSHOT_MAX_CLIPS
+      // clips; say so rather than letting the prefix read as the clip count.
+      const partialNote = payload.snapshot_partial ? ` (cached preview of ${payload.snapshot_total})` : '';
+      project.textContent = `${projectLabel} · ${clipLabel(clips.length)}${partialNote}`;
       const hasAnalyzableClips = clips.some(clip => clip.analyzable);
       selectBtn.disabled = !hasAnalyzableClips;
       analyzeBtn.disabled = !hasAnalyzableClips;
@@ -6621,10 +6624,12 @@ HTML = r"""<!doctype html>
         // probe (the server re-applies only the local analysis overlay); manual /
         // first loads do a full Media Pool walk with a fresh probe. The ETag lets
         // an unchanged poll short-circuit to 304 and skip the table re-render.
-        const query = options.silent ? '&probe=0&reuse=1' : '';
+        // No `limit` param: the server applies the media_analysis.inventory_limit
+        // preference, and sending one here would override what the user configured.
+        const query = options.silent ? '?probe=0&reuse=1' : '';
         const headers = {};
         if (state.mediaETag) headers['If-None-Match'] = state.mediaETag;
-        const res = await fetch(`/api/resolve/media?limit=500${query}`, { headers, cache: 'no-store' });
+        const res = await fetch(`/api/resolve/media${query}`, { headers, cache: 'no-store' });
         state.mediaLastRefresh = new Date();
         state.resolveMediaStale = false;
         if (res.status === 304) return;
@@ -6645,16 +6650,60 @@ HTML = r"""<!doctype html>
     // Persist the last good inventory so reopening the dashboard paints the
     // previous snapshot instantly (with a "refreshing" hint) instead of sitting
     // on "connection pending" until the first fetch returns.
+    // localStorage gives us roughly 5MB per origin, and a clip record — file
+    // path, bin path, status reasons, analysis overlay — runs several hundred
+    // bytes. inventory_limit reaches 10000, so a large project overruns the
+    // quota, and the write then throws and leaves the panel with no snapshot at
+    // all. Cache a bounded prefix instead, and carry the real clip count so a
+    // partial snapshot never presents itself as the whole inventory.
+    const INVENTORY_SNAPSHOT_MAX_CLIPS = 750;
+
     function inventorySnapshotKey() {
       return 'resolveMcpInventory:' + (state.activeContext?.project_root || state.boot?.project_root || state.boot?.project_name || 'default');
     }
+    function inventorySnapshotPayload(payload) {
+      const clips = payload.clips || [];
+      if (clips.length <= INVENTORY_SNAPSHOT_MAX_CLIPS) return payload;
+      return {
+        ...payload,
+        clips: clips.slice(0, INVENTORY_SNAPSHOT_MAX_CLIPS),
+        snapshot_partial: true,
+        snapshot_total: clips.length,
+      };
+    }
+    // Drop every cached inventory, including this project's own stale value —
+    // the panel is about to rewrite it, and snapshots for projects the user has
+    // since moved on from are the usual reason the quota is full.
+    function pruneInventorySnapshots() {
+      try {
+        const keys = [];
+        for (let i = 0; i < localStorage.length; i += 1) {
+          const key = localStorage.key(i);
+          if (key && key.startsWith('resolveMcpInventory:')) keys.push(key);
+        }
+        keys.forEach(key => localStorage.removeItem(key));
+      } catch (error) {
+        console.warn('Could not prune inventory snapshots', error);
+      }
+    }
     function saveInventorySnapshot(payload) {
       if (!payload?.resolve_available) return;
+      const key = inventorySnapshotKey();
+      const raw = JSON.stringify({ saved_at: Date.now(), payload: inventorySnapshotPayload(payload) });
       try {
-        localStorage.setItem(inventorySnapshotKey(), JSON.stringify({ saved_at: Date.now(), payload }));
+        localStorage.setItem(key, raw);
       } catch (error) {
-        // Quota or serialization failure is non-fatal — the snapshot is a nicety.
-        console.warn('Could not cache inventory snapshot', error);
+        // Out of quota: clear the cached inventories and try once more.
+        pruneInventorySnapshots();
+        try {
+          localStorage.setItem(key, raw);
+        } catch (retryError) {
+          // Still no room — drop our key so a snapshot from an older walk can't
+          // outlive the inventory it described. Non-fatal; the panel just paints
+          // "connection pending" until the first fetch returns.
+          try { localStorage.removeItem(key); } catch (removeError) { /* nothing left to do */ }
+          console.warn('Could not cache inventory snapshot', retryError);
+        }
       }
     }
     function loadInventorySnapshot() {
@@ -7168,7 +7217,11 @@ HTML = r"""<!doctype html>
       const poll = enabled ? `polling every ${Math.round(interval / 1000)}s` : 'polling off';
       const visible = state.resolveMedia?.clips ? clipLabel(filteredResolveClips(state.resolveMedia.clips).length) : 'no media snapshot';
       const prefix = state.mediaRefreshing ? 'refreshing' : poll;
-      const stale = state.resolveMediaStale ? 'cached · ' : '';
+      const stale = state.resolveMediaStale
+        ? (state.resolveMedia?.snapshot_partial
+            ? `cached first ${state.resolveMedia.clips.length} of ${state.resolveMedia.snapshot_total} · `
+            : 'cached · ')
+        : '';
       el.textContent = `${stale}${prefix} · last ${last} · ${visible}${extra ? ` · ${extra}` : ''}`;
     }
 

package/src/granular/common.py

@@ -87,7 +87,7 @@ if not logging.getLogger().handlers:
         handlers=[logging.StreamHandler()],
     )
 
-VERSION = "2.97.0"
+VERSION = "2.97.2"
 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 353-tool granular server instead
 """
 
-VERSION = "2.97.0"
+VERSION = "2.97.2"
 
 import base64
 import os