feat: v1.9.7 — priority worker pool, 5 MCP tools, final ffprobe fixes

SysAdminDoc · SysAdminDoc · commit 7e220060b54d · 2026-03-27T16:12:04.000-04:00
WorkerPool:
- Replace FIFO ThreadPoolExecutor with PriorityQueue-backed thread pool
- CRITICAL(0) jobs leapfrog BACKGROUND(200) when all workers busy
- Equal-priority jobs dispatched in FIFO order (sequence tiebreaker)
- Proper shutdown with poison pills

MCP Server (18 → 23 tools):
- opencut_denoise_audio, opencut_upscale, opencut_scene_detect,
  opencut_depth_map, opencut_shorts_pipeline

Fixes:
- 3 remaining bare "ffprobe" in audio.py, video_editing.py, utils/media.py
- get_ffmpeg_path()/get_ffprobe_path() now warn when binary not in PATH
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,15 @@
 # Changelog
 
+## [1.9.7] - 2026-03-27
+
+### Added
+- **5 new MCP tools** — `opencut_denoise_audio`, `opencut_upscale`, `opencut_scene_detect`, `opencut_depth_map`, `opencut_shorts_pipeline` (23 total, up from 18). AI clients can now drive denoising, upscaling, scene detection, depth mapping, and the full shorts pipeline.
+- **WorkerPool priority queue** — Replaced FIFO `ThreadPoolExecutor` with custom `PriorityQueue`-backed pool. `JobPriority.CRITICAL` (0) jobs now leapfrog `BACKGROUND` (200) work when all workers are busy. Equal-priority jobs still run in FIFO order.
+
+### Fixed (Batch 39)
+- **3 more bare `"ffprobe"` in routes/utils** — `audio.py` waveform probe, `video_editing.py` reframe probe, `utils/media.py` media probe — all crash on bundled installs where ffprobe isn't in PATH.
+- **FFmpeg/ffprobe path warning** — `get_ffmpeg_path()` and `get_ffprobe_path()` now log WARNING when binary not found in PATH (was silently falling back to bare name, causing confusing subprocess errors later).
+
 ## [1.9.6] - 2026-03-27
 
 ### Fixed (Batch 38 — Route Cleanup & Remaining Crash Bugs)
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -180,7 +180,7 @@
 - Lint: `ruff check opencut/` — codebase is fully clean, pre-commit enforces on every commit
 
 ## Version
-- Current: **v1.9.6**
+- Current: **v1.9.7**
 - 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
@@ -919,6 +919,12 @@ enhance = ["resemble-enhance>=0.0.1"]
 - **10 duplicate class attributes in HTML** — 10 elements had two `class=` attributes; HTML parser silently ignores the second, losing spacing utilities (mt-xs, mt-sm, mb-sm, mt-md). All merged into single attributes.
 - **pip install permission denied** — `safe_pip_install()` failed on Windows when both normal and `--user` installs hit Errno 13 (Microsoft Store Python, OneDrive-synced user dirs, restrictive ACLs). Added `--target ~/.opencut/packages` as third fallback strategy. server.py adds `~/.opencut/packages` to `sys.path` at startup.
 
+## v1.9.7 Batch 39 (Priority Queue, MCP Tools, Final ffprobe)
+- **WorkerPool priority queue** — replaced FIFO ThreadPoolExecutor with PriorityQueue-backed pool. CRITICAL(0) jobs leapfrog BACKGROUND(200) when workers busy.
+- **5 new MCP tools** — denoise_audio, upscale, scene_detect, depth_map, shorts_pipeline (23 total).
+- **3 more bare ffprobe** — audio.py waveform, video_editing.py reframe, utils/media.py probe. Fixed to get_ffprobe_path().
+- **FFmpeg path warnings** — get_ffmpeg_path()/get_ffprobe_path() now log WARNING when binary not found.
+
 ## v1.9.6 Batch 38 Bug Fixes (Route Cleanup)
 - **10 remaining `_p(pct, msg)` closures** — audio.py (3), video_fx.py (5), captions.py (1), workflow.py (1) all crashed with TypeError when core modules called on_progress with 1 arg. Fixed all to `msg=""`.
 - **Redundant filepath re-validation in 7+ routes** — face_enhance, face_swap, upscale_run, remove_watermark, title_overlay, particle_apply, color_correct, color_convert, color_external_lut all re-read `data.get("filepath")` despite @async_job handling it. Removed ~80 lines of dead code.
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.6" -ForegroundColor DarkGray
+Write-Host "  Installer v1.9.7" -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.6"
+#define MyAppVersion "1.9.7"
 #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.6"
+                   ExtensionBundleVersion="1.9.7"
                    ExtensionBundleName="OpenCut">
 
     <ExtensionList>
-        <Extension Id="com.opencut.panel.main" Version="1.9.6" />
+        <Extension Id="com.opencut.panel.main" Version="1.9.7" />
     </ExtensionList>
 
     <ExecutionEnvironment>
diff --git a/extension/com.opencut.panel/client/index.html b/extension/com.opencut.panel/client/index.html
@@ -3262,7 +3262,7 @@ <h1 class="content-title" id="contentTitle">Cut & Clean</h1>
                     <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.6</span>
+                        <span class="settings-value">1.9.7</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.6
+   OpenCut CEP Panel - Main Controller v1.9.7
    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.6 - ULTRA PREMIUM EDITION
+   OpenCut CEP Panel v1.9.7 - 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.6",
+  "version": "1.9.7",
   "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.6</span>
+        <span class="oc-version">v1.9.7</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.6";
+const VERSION          = "1.9.7";
 
 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.6",
+  "version": "1.9.7",
   "main": "index.html",
   "host": [
     {
diff --git a/install.py b/install.py
@@ -10,7 +10,7 @@
 import subprocess
 import platform
 
-VERS = "1.9.6"
+VERS = "1.9.7"
 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.6";
+    public const string AppVersion = "1.9.7";
     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.6</Version>
-    <FileVersion>1.9.6.0</FileVersion>
+    <Version>1.9.7</Version>
+    <FileVersion>1.9.7.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.6.0" name="OpenCut.Installer" />
+  <assemblyIdentity version="1.9.7.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.6"
+__version__ = "1.9.7"
 __author__ = "OpenCut Contributors"
 __license__ = "MIT"
diff --git a/opencut/helpers.py b/opencut/helpers.py
@@ -40,6 +40,8 @@ def get_ffmpeg_path() -> str:
     if _ffmpeg_path is not None:
         return _ffmpeg_path
     found = shutil.which("ffmpeg")
+    if not found:
+        logger.warning("ffmpeg not found in PATH — subprocess calls may fail")
     _ffmpeg_path = found if found else "ffmpeg"
     return _ffmpeg_path
 
@@ -50,6 +52,8 @@ def get_ffprobe_path() -> str:
     if _ffprobe_path is not None:
         return _ffprobe_path
     found = shutil.which("ffprobe")
+    if not found:
+        logger.warning("ffprobe not found in PATH — media probing may fail")
     _ffprobe_path = found if found else "ffprobe"
     return _ffprobe_path
 
diff --git a/opencut/mcp_server.py b/opencut/mcp_server.py
@@ -322,6 +322,73 @@ def _api(method, path, data=None):
             "required": ["file"],
         },
     },
+    {
+        "name": "opencut_denoise_audio",
+        "description": "Reduce noise from audio/video using FFmpeg filters (afftdn, highpass, gate)",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "filepath": {"type": "string", "description": "Path to audio/video file"},
+                "method": {"type": "string", "description": "Denoise method: afftdn, highpass, gate", "default": "afftdn"},
+                "strength": {"type": "number", "description": "Denoise strength 0-1", "default": 0.5},
+            },
+            "required": ["filepath"],
+        },
+    },
+    {
+        "name": "opencut_upscale",
+        "description": "AI upscale video using Real-ESRGAN (2x or 4x resolution)",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "filepath": {"type": "string", "description": "Path to video file"},
+                "scale": {"type": "integer", "description": "Upscale factor: 1-4", "default": 2},
+                "model": {"type": "string", "description": "Model: realesrgan-x4plus, realesrgan-x2plus", "default": "realesrgan-x4plus"},
+            },
+            "required": ["filepath"],
+        },
+    },
+    {
+        "name": "opencut_scene_detect",
+        "description": "Detect scene boundaries/cuts in a video file",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "filepath": {"type": "string", "description": "Path to video file"},
+                "method": {"type": "string", "description": "Detection method: ffmpeg, ml, pyscenedetect", "default": "ffmpeg"},
+                "threshold": {"type": "number", "description": "Detection sensitivity 0-1", "default": 0.3},
+            },
+            "required": ["filepath"],
+        },
+    },
+    {
+        "name": "opencut_depth_map",
+        "description": "Generate a depth map video using Depth Anything V2",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "filepath": {"type": "string", "description": "Path to video file"},
+                "model_size": {"type": "string", "description": "Model size: small, base, large", "default": "small"},
+            },
+            "required": ["filepath"],
+        },
+    },
+    {
+        "name": "opencut_shorts_pipeline",
+        "description": "One-click pipeline: transcribe + highlight + face-reframe + captions + export short-form clips",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "filepath": {"type": "string", "description": "Path to long-form video"},
+                "max_shorts": {"type": "integer", "default": 5},
+                "min_duration": {"type": "number", "default": 15},
+                "max_duration": {"type": "number", "default": 60},
+                "face_track": {"type": "boolean", "default": True},
+                "burn_captions": {"type": "boolean", "default": True},
+            },
+            "required": ["filepath"],
+        },
+    },
 ]
 
 # Route mapping for tool execution
@@ -344,6 +411,11 @@ def _api(method, path, data=None):
     "opencut_loudness_match": ("POST", "/audio/loudness-match"),
     "opencut_auto_zoom": ("POST", "/video/auto-zoom"),
     "opencut_multicam_cuts": ("POST", "/video/multicam-cuts"),
+    "opencut_denoise_audio": ("POST", "/audio/denoise"),
+    "opencut_upscale": ("POST", "/video/ai/upscale"),
+    "opencut_scene_detect": ("POST", "/video/scenes"),
+    "opencut_depth_map": ("POST", "/video/depth/map"),
+    "opencut_shorts_pipeline": ("POST", "/video/shorts-pipeline"),
 }
 
 
diff --git a/opencut/routes/audio.py b/opencut/routes/audio.py
@@ -20,6 +20,7 @@
 from opencut.helpers import (
     _make_sequence_name,
     _resolve_output_dir,
+    get_ffprobe_path,
 )
 from opencut.jobs import (
     _is_cancelled,
@@ -1343,7 +1344,7 @@ def audio_waveform(job_id, filepath, data):
 
     # Use FFmpeg to extract peak amplitude per chunk
     cmd = [
-        "ffprobe", "-v", "error", "-show_entries", "format=duration",
+        get_ffprobe_path(), "-v", "error", "-show_entries", "format=duration",
         "-of", "json", file_path
     ]
     dur_result = _sp.run(cmd, capture_output=True, text=True, timeout=10)
diff --git a/opencut/routes/video_editing.py b/opencut/routes/video_editing.py
@@ -15,6 +15,7 @@
 from opencut.helpers import (
     _resolve_output_dir,
     _unique_output_path,
+    get_ffprobe_path,
 )
 from opencut.jobs import (
     _is_cancelled,
@@ -84,7 +85,7 @@ def video_reframe(job_id, filepath, data):
 
     # Get source dimensions
     probe_cmd = [
-        "ffprobe", "-v", "error", "-select_streams", "v:0",
+        get_ffprobe_path(), "-v", "error", "-select_streams", "v:0",
         "-show_entries", "stream=width,height",
         "-of", "json", filepath
     ]
diff --git a/opencut/utils/media.py b/opencut/utils/media.py
@@ -12,6 +12,8 @@
 from fractions import Fraction
 from typing import Optional
 
+from opencut.helpers import get_ffprobe_path
+
 logger = logging.getLogger("opencut")
 
 
@@ -139,7 +141,7 @@ def probe(filepath: str) -> MediaInfo:
         raise FileNotFoundError(f"Media file not found: {filepath}")
 
     cmd = [
-        "ffprobe",
+        get_ffprobe_path(),
         "-v", "quiet",
         "-print_format", "json",
         "-show_format",
diff --git a/opencut/workers.py b/opencut/workers.py
diff --git a/pyproject.toml b/pyproject.toml
diff --git a/requirements.txt b/requirements.txt

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.6",`
	`3`	`+ "version": "1.9.7",`
`4`	`4`	`"private": true,`
`5`	`5`	`"description": "OpenCut CEP Panel for Adobe Premiere Pro",`
`6`	`6`	`"scripts": {`