refactor: v1.9.3 — split video.py into 5 blueprints, async_job adoption, app factory

Split monolithic video.py (3636 lines) into 5 domain blueprints:
video_core (1395), video_editing (750), video_fx (687),
video_specialty (489), video_ai (443). All URL paths unchanged.

Converted all 97 manual _new_job/Thread/_update_job patterns across 6
route files to @async_job decorator, removing ~2800 lines of boilerplate
and fixing cancelled-job-overwritten-to-complete race condition.

Added app factory pattern (create_app + OpenCutConfig dataclass),
install route factory (make_install_route replaces 6 identical handlers),
version sync CI enforcement with --check flag.

Author: SysAdminDoc

.github/workflows/build.yml

@@ -50,6 +50,9 @@ jobs:
           pip install pytest-cov
           python -m pytest tests/ -v --tb=short --cov=opencut --cov-report=term-missing --cov-fail-under=50
 
+      - name: Check version sync
+        run: python scripts/sync_version.py --check
+
       - name: Smoke test imports
         run: |
           python -c "from opencut.server import app; print('Import OK')"

CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog
 
-## [1.9.2] - 2026-03-26
+## [1.9.3] - 2026-03-27
 
 ### Added
 - **JSON Structured Logging** (Phase 0.3) — File handler now outputs JSON via `python-json-logger`. Each log line includes `timestamp`, `level`, `module`, `job_id`, `message`. Console handler stays plain text. Graceful fallback if `python-json-logger` not installed.
@@ -15,6 +15,13 @@
 - **Core Module Unit Tests Batch 2** (Phase 0.1) — 135 additional tests across 28 previously untested core modules (animated_captions, audio_enhance, audio_pro, audio_suite, caption_burnin, captions_enhanced, color_management, emotion_highlights, face_swap, face_tools, lut_library, motion_graphics, music_ai, music_gen, object_removal, particles, shorts_pipeline, style_transfer, styled_captions, transitions_3d, upscale_pro, video_ai, voice_gen, zoom, broll_insert, broll_generate, multimodal_diarize, social_post).
 - **ExtendScript Mock Harness** (Phase 0.1) — `tests/jsx_mock.js` provides fake Premiere Pro DOM (app.project, activeSequence, tracks, markers, ProjectItem). Tests 38 ExtendScript functions including ocApplySequenceCuts, ocBatchRenameProjectItems, ocAddSequenceMarkers, ocAddNativeCaptionTrack. 35 assertions pass under Node.js.
 
+### Refactored
+- **`async_job` decorator adoption** — All 97 manual `_new_job()` + `threading.Thread` + `_update_job(status="complete")` patterns across 6 route files converted to `@async_job` decorator. Fixes race condition where cancelled jobs could be overwritten to "complete". Removes ~2,800 lines of boilerplate. Decorator extended with `filepath_required` and `filepath_param` parameters.
+- **Split `video.py` into 5 domain blueprints** — Monolithic 3636-line `video.py` split into `video_core.py` (1395), `video_editing.py` (750), `video_fx.py` (687), `video_specialty.py` (489), `video_ai.py` (443). No file exceeds 1400 lines. All URL paths unchanged.
+- **App factory pattern** — `server.py` now exposes `create_app(config)` for isolated Flask instances. New `opencut/config.py` centralizes env var reads into `OpenCutConfig` dataclass. Tests use independent app instances. Module-level `app = create_app()` preserved for backward compat.
+- **Install route factory** — `make_install_route()` in `opencut/jobs.py` replaces 6 identical install endpoint handlers (depth, emotion, multimodal-diarize, broll-generate, face, crisper-whisper) with a single factory call per route.
+- **Version sync CI enforcement** — `scripts/sync_version.py` now includes `package.json` in targets and supports `--check` flag for CI. Added to `.github/workflows/build.yml`.
+
 ### Security
 - Replaced all `__import__()` calls with `importlib.import_module()` / `importlib.util.find_spec()` in helpers.py, system.py, engine_registry.py, plugins.py
 

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.0" -ForegroundColor DarkGray
+Write-Host "  Installer v1.9.3" -ForegroundColor DarkGray
 
 $isAdmin = Test-IsAdmin
 if ($isAdmin) {

OpenCut.iss

@@ -2,7 +2,7 @@
 ; Fully self-contained installer — bundles server exe, ffmpeg, and CEP extension
 
 #define MyAppName "OpenCut"
-#define MyAppVersion "1.9.0"
+#define MyAppVersion "1.9.3"
 #define MyAppPublisher "SysAdminDoc"
 #define MyAppURL "https://github.com/SysAdminDoc/OpenCut"
 

extension/com.opencut.panel/.eslintrc.json

@@ -0,0 +1,22 @@
+{
+  "env": {
+    "browser": true,
+    "es2021": true
+  },
+  "parserOptions": {
+    "ecmaVersion": 2021,
+    "sourceType": "script"
+  },
+  "rules": {
+    "no-undef": "warn",
+    "no-unused-vars": "warn",
+    "no-redeclare": "warn",
+    "eqeqeq": ["warn", "smart"],
+    "no-eval": "error"
+  },
+  "globals": {
+    "CSInterface": "readonly",
+    "CSEvent": "readonly",
+    "SystemPath": "readonly"
+  }
+}

extension/com.opencut.panel/package.json

@@ -1,14 +1,16 @@
 {
   "name": "opencut-panel",
-  "version": "1.7.2",
+  "version": "1.9.3",
   "private": true,
   "description": "OpenCut CEP Panel for Adobe Premiere Pro",
   "scripts": {
     "dev": "vite build --watch",
     "build": "vite build",
-    "preview": "vite preview"
+    "preview": "vite preview",
+    "lint": "eslint client/main.js"
   },
   "devDependencies": {
+    "eslint": "^8.0.0",
     "vite": "^5.0.0"
   }
 }

install.py

@@ -10,7 +10,7 @@
 import subprocess
 import platform
 
-VERS = "1.9.0"
+VERS = "1.9.3"
 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")

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.0</Version>
-    <FileVersion>1.9.0.0</FileVersion>
+    <Version>1.9.3</Version>
+    <FileVersion>1.9.3.0</FileVersion>
     <AssemblyVersion>1.3.0.0</AssemblyVersion>
     <Company>SysAdminDoc</Company>
     <Product>OpenCut Installer</Product>

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.0.0" name="OpenCut.Installer" />
+  <assemblyIdentity version="1.9.3.0" name="OpenCut.Installer" />
   <trustInfo xmlns="urn:schemas-microsoft-com:asm.v2">
     <security>
       <requestedPrivileges xmlns="urn:schemas-microsoft-com:asm.v3">

installer/src/OpenCut.Installer/bin/Release/net9.0-windows/win-x64/OpenCut-Setup.deps.json

@@ -7,7 +7,7 @@
   "targets": {
     ".NETCoreApp,Version=v9.0": {},
     ".NETCoreApp,Version=v9.0/win-x64": {
-      "OpenCut-Setup/1.9.0": {
+      "OpenCut-Setup/1.9.3": {
         "dependencies": {
           "runtimepack.Microsoft.NETCore.App.Runtime.win-x64": "9.0.14",
           "runtimepack.Microsoft.WindowsDesktop.App.Runtime.win-x64": "9.0.14"
@@ -943,7 +943,7 @@
     }
   },
   "libraries": {
-    "OpenCut-Setup/1.9.0": {
+    "OpenCut-Setup/1.9.3": {
       "type": "project",
       "serviceable": false,
       "sha512": ""