v1.9.25: cache /system/dependencies (5s → 0ms, ~6000x speedup)

SysAdminDoc · SysAdminDoc · commit f9d2b983e2b3 · 2026-04-11T18:47:38.000-04:00
Caught during the v1.9.24 binary smoke test: /system/dependencies took
~6.5s on the first cold call because it runs 20+ importlib.import_module()
probes (torch, mediapipe, audiocraft, pyannote, onnxruntime, rembg,
realesrgan, gfpgan, insightface, ...) plus an ffmpeg -version subprocess
plus an ollama HTTP probe — all synchronously in one request. This
blocked the Settings tab render on first open.

Fix: module-level _deps_cache with threading.Lock + 60-second TTL in
routes/system.py. Cold call still pays the ~5s import tax once; every
subsequent call within the window returns from memory in &lt;1ms.

Measured:
  cold call: 6463 ms
  warm call: 0 ms    (~6000x speedup)
  fresh=1:   22 ms   (bypasses cache)

New ?fresh=1 query param lets the frontend force a re-check after an
install/uninstall finishes.
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -181,7 +181,7 @@
 - Lint: `ruff check opencut/` — codebase is fully clean, pre-commit enforces on every commit
 
 ## Version
-- Current: **v1.9.24**
+- Current: **v1.9.25**
 - All version strings: `pyproject.toml`, `__init__.py`, `CSXS/manifest.xml` (ExtensionBundleVersion + Version), `com.opencut.uxp/manifest.json`, `com.opencut.uxp/main.js` (VERSION const), `index.html` version display, README badge, `package.json`
 - Use `python scripts/sync_version.py --set X.Y.Z` to update all 19 targets at once (including UXP files and package.json)
 - Use `python scripts/sync_version.py --check` in CI to verify all targets match
@@ -1067,6 +1067,13 @@ Comprehensive multi-phase audit across all 138 files (~82,500 lines). 103 issues
 - **4 new UXP Video features** — AI Upscale, Scene Detection, Style Transfer, Shorts Pipeline. Full HTML cards + JS handlers with job polling.
 - **UXP stale version fixed** — Settings showed "1.9.2" hardcoded. Now synced via version script.
 
+## v1.9.25 `/system/dependencies` TTL cache (5s → 0ms)
+Caught during the v1.9.24 binary smoke test: `/system/dependencies` took ~6.5 s on the first cold call because it runs 20+ `importlib.import_module()` probes (torch, mediapipe, audiocraft, pyannote, onnxruntime, rembg, realesrgan, gfpgan, insightface, ...) plus an `ffmpeg -version` subprocess plus an ollama HTTP probe — all synchronously in one request. This blocks the Settings tab render on first open.
+
+- Added a module-level `_deps_cache = {"data": None, "ts": 0.0}` + `threading.Lock` in `routes/system.py` with a 60-second TTL. Cold call still pays the ~5 s import tax once; every subsequent call within the window returns from memory in <1 ms.
+- Cold call: 6463 ms. Warm call: 0 ms. **~6000× speedup.**
+- New `?fresh=1` query param bypasses the cache when the frontend wants a forced re-check after an install/uninstall.
+
 ## v1.9.24 Env-var config (`OPENCUT_PORT` / `OPENCUT_HOST` / `OPENCUT_DEBUG`)
 Found during a binary smoke test — `OPENCUT_PORT=5789 ./OpenCut-Server.exe` silently ignored the env var and always bound to 5679. CLAUDE.md had long advertised env-based config, but `opencut/server.py::main()` only read `argparse` flags with hardcoded defaults. Fixed so that:
 - `OPENCUT_HOST` (default `127.0.0.1`)
diff --git a/Install.ps1 b/Install.ps1
@@ -155,7 +155,7 @@ Write-Host "  \___/| .__/ \___|_| |_|\____\__,_|\__|" -ForegroundColor Cyan
 Write-Host "       |_|                               " -ForegroundColor Cyan
 Write-Host ""
 Write-Host "  Open Source Video Editing Automation" -ForegroundColor DarkGray
-Write-Host "  Installer v1.9.24" -ForegroundColor DarkGray
+Write-Host "  Installer v1.9.25" -ForegroundColor DarkGray
 
 $isAdmin = Test-IsAdmin
 if ($isAdmin) {
diff --git a/OpenCut.iss b/OpenCut.iss
@@ -2,7 +2,7 @@
 ; Fully self-contained installer — bundles server exe, ffmpeg, and CEP extension
 
 #define MyAppName "OpenCut"
-#define MyAppVersion "1.9.24"
+#define MyAppVersion "1.9.25"
 #define MyAppPublisher "SysAdminDoc"
 #define MyAppURL "https://github.com/SysAdminDoc/OpenCut"
 
diff --git a/extension/com.opencut.panel/CSXS/manifest.xml b/extension/com.opencut.panel/CSXS/manifest.xml
@@ -2,11 +2,11 @@
 <ExtensionManifest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                    Version="7.0"
                    ExtensionBundleId="com.opencut.panel"
-                   ExtensionBundleVersion="1.9.24"
+                   ExtensionBundleVersion="1.9.25"
                    ExtensionBundleName="OpenCut">
 
     <ExtensionList>
-        <Extension Id="com.opencut.panel.main" Version="1.9.24" />
+        <Extension Id="com.opencut.panel.main" Version="1.9.25" />
     </ExtensionList>
 
     <ExecutionEnvironment>
diff --git a/extension/com.opencut.panel/client/index.html b/extension/com.opencut.panel/client/index.html
@@ -3524,7 +3524,7 @@ <h3 class="media-sidecar-title">No media in the workspace yet.</h3>
                     <div class="card-header"><div class="card-title" data-i18n="settings.about">About OpenCut</div></div>
                     <div class="settings-row">
                         <span class="settings-label">Version</span>
-                        <span class="settings-value">1.9.24</span>
+                        <span class="settings-value">1.9.25</span>
                     </div>
                     <div class="about-links">
                         <a href="https://github.com/SysAdminDoc/opencut" class="about-link" target="_blank">GitHub</a>
diff --git a/extension/com.opencut.panel/client/main.js b/extension/com.opencut.panel/client/main.js
@@ -1,5 +1,5 @@
 /* ============================================================
-   OpenCut CEP Panel - Main Controller v1.9.24
+   OpenCut CEP Panel - Main Controller v1.9.25
    6-Tab Professional Toolkit
    ============================================================ */
 (function () {
diff --git a/extension/com.opencut.panel/client/style.css b/extension/com.opencut.panel/client/style.css
@@ -1,5 +1,5 @@
 /* ============================================================
-   OpenCut CEP Panel v1.9.24 - ULTRA PREMIUM EDITION
+   OpenCut CEP Panel v1.9.25 - ULTRA PREMIUM EDITION
    Next-Generation AI Editing Suite for Adobe Premiere Pro
    ============================================================ */
 
diff --git a/extension/com.opencut.panel/package.json b/extension/com.opencut.panel/package.json
@@ -1,6 +1,6 @@
 {
   "name": "opencut-panel",
-  "version": "1.9.24",
+  "version": "1.9.25",
   "private": true,
   "description": "OpenCut CEP Panel for Adobe Premiere Pro",
   "scripts": {
diff --git a/extension/com.opencut.uxp/index.html b/extension/com.opencut.uxp/index.html
@@ -16,7 +16,7 @@
           <path d="M4 2.5a3 3 0 00-1.76 5.43L7.33 11l-5.09 3.07A3 3 0 104.8 19.5a3 3 0 001.76-5.43L8.93 12.6 16.5 17V5L8.93 9.4 6.56 7.93A3 3 0 004 2.5z" fill="var(--accent)"/>
         </svg>
         <span class="oc-logo">OpenCut</span>
-        <span class="oc-version">v1.9.24</span>
+        <span class="oc-version">v1.9.25</span>
       </div>
       <div class="oc-header-right">
         <div class="oc-connection" id="connectionStatus" title="Backend connection status">
diff --git a/extension/com.opencut.uxp/main.js b/extension/com.opencut.uxp/main.js
@@ -26,7 +26,7 @@ const HEALTH_CHECK_MS  = 8000;
 const HEALTH_MAX_MS    = 60000;
 const MEDIA_SCAN_MS    = 30000;
 const SSE_AVAILABLE    = typeof EventSource !== "undefined";
-const VERSION          = "1.9.24";
+const VERSION          = "1.9.25";
 
 async function detectBackend() {
   // Try ports 5679-5689 like CEP panel does
diff --git a/extension/com.opencut.uxp/manifest.json b/extension/com.opencut.uxp/manifest.json
@@ -1,7 +1,7 @@
 {
   "id": "com.opencut.uxp",
   "name": "OpenCut UXP",
-  "version": "1.9.24",
+  "version": "1.9.25",
   "main": "index.html",
   "host": [
     {
diff --git a/install.py b/install.py
@@ -10,7 +10,7 @@
 import subprocess
 import platform
 
-VERS = "1.9.24"
+VERS = "1.9.25"
 CEP_EXT = "com.opencut.panel"
 WIN_CEP_DIR = os.path.expandvars(r"%APPDATA%\Adobe\CEP\extensions")
 MAC_CEP_DIR = os.path.expanduser("~/Library/Application Support/Adobe/CEP/extensions")
diff --git a/installer/src/OpenCut.Installer/Models/AppConstants.cs b/installer/src/OpenCut.Installer/Models/AppConstants.cs
@@ -3,7 +3,7 @@ namespace OpenCut.Installer.Models;
 public static class AppConstants
 {
     public const string AppName = "OpenCut";
-    public const string AppVersion = "1.9.24";
+    public const string AppVersion = "1.9.25";
     public const string AppDisplayName = $"{AppName} v{AppVersion}";
     public const string AppPublisher = "SysAdminDoc";
     public const string AppUrl = "https://github.com/SysAdminDoc/OpenCut";
diff --git a/installer/src/OpenCut.Installer/OpenCut.Installer.csproj b/installer/src/OpenCut.Installer/OpenCut.Installer.csproj
@@ -7,8 +7,8 @@
     <RootNamespace>OpenCut.Installer</RootNamespace>
     <AssemblyName>OpenCut-Setup</AssemblyName>
     <ApplicationIcon>Assets\logo.ico</ApplicationIcon>
-    <Version>1.9.24</Version>
-    <FileVersion>1.9.24.0</FileVersion>
+    <Version>1.9.25</Version>
+    <FileVersion>1.9.25.0</FileVersion>
     <AssemblyVersion>1.3.0.0</AssemblyVersion>
     <Company>SysAdminDoc</Company>
     <Product>OpenCut Installer</Product>
diff --git a/installer/src/OpenCut.Installer/Properties/app.manifest b/installer/src/OpenCut.Installer/Properties/app.manifest
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <assembly manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1">
-  <assemblyIdentity version="1.9.24.0" name="OpenCut.Installer" />
+  <assemblyIdentity version="1.9.25.0" name="OpenCut.Installer" />
   <trustInfo xmlns="urn:schemas-microsoft-com:asm.v2">
     <security>
       <requestedPrivileges xmlns="urn:schemas-microsoft-com:asm.v3">
diff --git a/opencut/__init__.py b/opencut/__init__.py
@@ -5,6 +5,6 @@
 and more. Exports Premiere Pro / DaVinci Resolve / FCP XML.
 """
 
-__version__ = "1.9.24"
+__version__ = "1.9.25"
 __author__ = "OpenCut Contributors"
 __license__ = "MIT"
diff --git a/opencut/routes/system.py b/opencut/routes/system.py
@@ -531,9 +531,27 @@ def gpu_recommend():
 # ---------------------------------------------------------------------------
 # Dependency Health Dashboard
 # ---------------------------------------------------------------------------
+# Cold call invokes 20+ importlib.import_module() + ffprobe/ffmpeg subprocess +
+# an ollama HTTP probe. On first hit (Settings tab open) this takes ~5 s
+# which blocks the frontend. Cache the result for 60 s across all requests.
+_deps_cache = {"data": None, "ts": 0.0}
+_deps_cache_lock = threading.Lock()
+_DEPS_CACHE_TTL = 60.0
+
+
 @system_bp.route("/system/dependencies", methods=["GET"])
 def check_dependencies():
-    """Check all optional dependencies and return their status."""
+    """Check all optional dependencies and return their status.
+
+    Supports `?fresh=1` to bypass the 60 s TTL cache when the user explicitly
+    triggers a re-check (e.g., after an install finishes).
+    """
+    fresh = request.args.get("fresh", "").lower() in ("1", "true", "yes")
+    if not fresh:
+        with _deps_cache_lock:
+            if _deps_cache["data"] is not None and (time.time() - _deps_cache["ts"]) < _DEPS_CACHE_TTL:
+                return jsonify(_deps_cache["data"])
+
     deps = {}
     checks = {
         "faster-whisper": "faster_whisper",
@@ -642,6 +660,10 @@ def check_dependencies():
     except Exception:
         deps["nlp_command"] = {"installed": False, "version": None}
 
+    with _deps_cache_lock:
+        _deps_cache["data"] = deps
+        _deps_cache["ts"] = time.time()
+
     return jsonify(deps)
 
 
diff --git a/pyproject.toml b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "opencut"
-version = "1.9.24"
+version = "1.9.25"
 description = "Open-source AI video editing automation for Adobe Premiere Pro - captions, audio processing, visual effects, and more"
 readme = "README.md"
 license = {text = "MIT"}
diff --git a/requirements.txt b/requirements.txt
@@ -1,4 +1,4 @@
-# OpenCut v1.9.24 Requirements
+# OpenCut v1.9.25 Requirements
 # Install: pip install -r requirements.txt
 # For GPU: pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121
 

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "opencut-panel",`
`3`		`- "version": "1.9.24",`
	`3`	`+ "version": "1.9.25",`
`4`	`4`	`"private": true,`
`5`	`5`	`"description": "OpenCut CEP Panel for Adobe Premiere Pro",`
`6`	`6`	`"scripts": {`