@synthetic-ai/premiere-mcp 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [v2.2.0] — `--doctor` diagnostic command
+
+`premiere-pro-mcp --doctor` runs a standalone setup check — no MCP client or
+Premiere Pro needs to be running: Node version, Premiere Pro install
+detected on disk, license key present + live-validated against
+synthetic.com.ar, and the CEP bridge temp directory is writable. Prints a
+pass/warn/fail summary and exits 1 if anything failed, so it's scriptable.
+Fixed a real crash found while building this: forcing `process.exit()`
+right after the live license check's `fetch()` call could crash with a
+libuv assertion on Windows (`UV_HANDLE_CLOSING`, src/win/async.c) — now
+sets `process.exitCode` and lets the event loop drain naturally instead.
+
 ## [v2.1.0] — CRITICAL: correct the version line, ship everything since 2.0.0
 
 `@synthetic-ai/premiere-mcp@2.0.0` (published 2026-06-10, the npm rename

package/dist/index.js

@@ -2,12 +2,102 @@
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { createServer } from "./server.js";
 import { cleanupTempDir, getTempDir } from "./bridge/file-bridge.js";
+import { checkLicense } from "./license.js";
 import { execSync } from "child_process";
 import { fileURLToPath } from "url";
 import path from "path";
+import { existsSync, mkdirSync, writeFileSync, unlinkSync } from "fs";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const projectRoot = path.resolve(__dirname, "..");
+// ---------------------------------------------------------------------------
+// --doctor — standalone diagnostics, no MCP client or Premiere Pro required
+// to run it. Prints a PASS/WARN/FAIL summary and exits 1 if anything failed,
+// so it's also usable in a script (`premiere-mcp --doctor || echo "broken"`).
+// Defined before the flag-handling block below since it's called from there.
+// ---------------------------------------------------------------------------
+const GREEN = "\x1b[32m";
+const RED = "\x1b[31m";
+const YELLOW = "\x1b[33m";
+const DIM = "\x1b[2m";
+const RESET = "\x1b[0m";
+function printCheck(result, label, detail) {
+    const icon = result === "pass" ? `${GREEN}✓${RESET}` : result === "warn" ? `${YELLOW}!${RESET}` : `${RED}✗${RESET}`;
+    console.log(`  ${icon} ${label}${detail ? `\n      ${DIM}${detail}${RESET}` : ""}`);
+}
+function premiereInstallCandidates() {
+    const years = ["2026", "2025", "2024", "2023", "2022"];
+    if (process.platform === "darwin") {
+        return years.map((y) => `/Applications/Adobe Premiere Pro ${y}/Adobe Premiere Pro ${y}.app`);
+    }
+    return years.map((y) => `C:\\Program Files\\Adobe\\Adobe Premiere Pro ${y}\\Adobe Premiere Pro.exe`);
+}
+// Returns whether any check failed — the caller sets process.exitCode rather
+// than us calling process.exit() here. On Windows, forcing process.exit()
+// immediately after an in-flight fetch/AbortController teardown (the live
+// license check below) can crash with a libuv assertion
+// ("UV_HANDLE_CLOSING", src/win/async.c) before the process actually exits.
+// Setting exitCode and letting the event loop drain naturally avoids it.
+async function runDoctor() {
+    console.log(`\n${DIM}premiere-mcp doctor — checking your setup${RESET}\n`);
+    let hasFail = false;
+    // 1. Node version
+    const nodeMajor = parseInt(process.version.slice(1).split(".")[0], 10);
+    if (nodeMajor >= 18) {
+        printCheck("pass", `Node.js ${process.version}`);
+    }
+    else {
+        hasFail = true;
+        printCheck("fail", `Node.js ${process.version}`, "Requires Node 18 or newer — update from nodejs.org");
+    }
+    // 2. OS (informational — both are supported, this just confirms detection)
+    const osLabel = process.platform === "darwin" ? "macOS" : process.platform === "win32" ? "Windows" : process.platform;
+    printCheck(process.platform === "darwin" || process.platform === "win32" ? "pass" : "warn", `OS: ${osLabel}`);
+    // 3. Premiere Pro install detected on disk
+    const found = premiereInstallCandidates().find((p) => existsSync(p));
+    if (found) {
+        printCheck("pass", "Premiere Pro detected", found);
+    }
+    else {
+        printCheck("warn", "Premiere Pro not found in the usual install location", "Not fatal — the MCP server only needs Premiere Pro running when a tool actually calls it.");
+    }
+    // 4. License key present
+    const licenseKey = process.env.PREMIERE_PRO_MCP_LICENSE;
+    if (!licenseKey) {
+        hasFail = true;
+        printCheck("fail", "PREMIERE_PRO_MCP_LICENSE not set", "Add it to your MCP client config (claude_desktop_config.json or equivalent).");
+    }
+    else {
+        printCheck("pass", `License key present (${licenseKey.slice(0, 8)}...)`);
+        // 5. Live validation against synthetic.com.ar (also exercises network reachability)
+        const result = await checkLicense();
+        if (result.valid) {
+            printCheck("pass", "License validates", result.expiresAt ? `Expires: ${result.expiresAt}` : "No expiration");
+        }
+        else {
+            hasFail = true;
+            printCheck("fail", "License validation failed", result.message ?? "Unknown reason");
+        }
+    }
+    // 6. Bridge temp directory writable
+    const tempDir = getTempDir();
+    try {
+        if (!existsSync(tempDir))
+            mkdirSync(tempDir, { recursive: true, mode: 0o700 });
+        const probe = path.join(tempDir, `.doctor-probe-${Date.now()}`);
+        writeFileSync(probe, "ok");
+        unlinkSync(probe);
+        printCheck("pass", "Bridge temp directory writable", tempDir);
+    }
+    catch (err) {
+        hasFail = true;
+        printCheck("fail", "Bridge temp directory not writable", `${tempDir} — ${err instanceof Error ? err.message : String(err)}`);
+    }
+    console.log(hasFail
+        ? `\n${RED}Some checks failed.${RESET} Fix the items above, or share this output with support at https://synthetic.com.ar/dashboard/support\n`
+        : `\n${GREEN}Everything looks good.${RESET}\n`);
+    return hasFail;
+}
 // Handle CLI flags
 const args = process.argv.slice(2);
 if (args.includes("--help") || args.includes("-h")) {
@@ -16,6 +106,7 @@ premiere-pro-mcp — MCP server for Adobe Premiere Pro (437 tools)
 
 Usage:
   premiere-pro-mcp              Start the MCP server (stdio transport)
+  premiere-pro-mcp --doctor        Check your setup (Node, license, Premiere Pro, temp dir)
   premiere-pro-mcp --install-cep   Install the CEP plugin into Premiere Pro
   premiere-pro-mcp --help          Show this help message
   premiere-pro-mcp --version       Show version
@@ -33,6 +124,12 @@ if (args.includes("--version") || args.includes("-v")) {
     console.log(pkg.default.version);
     process.exit(0);
 }
+let ranAsFlag = false;
+if (args.includes("--doctor")) {
+    const hasFail = await runDoctor();
+    process.exitCode = hasFail ? 1 : 0;
+    ranAsFlag = true;
+}
 if (args.includes("--install-cep")) {
     const scriptPath = path.join(projectRoot, "scripts", "install-cep.sh");
     console.log("Installing CEP plugin...\n");
@@ -63,8 +160,10 @@ async function main() {
     await server.connect(transport);
     console.error(`[premiere-pro-mcp] Server connected and ready`);
 }
-main().catch((err) => {
-    console.error("[premiere-pro-mcp] Fatal error:", err);
-    process.exit(1);
-});
+if (!ranAsFlag) {
+    main().catch((err) => {
+        console.error("[premiere-pro-mcp] Fatal error:", err);
+        process.exit(1);
+    });
+}
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synthetic-ai/premiere-mcp",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "MCP server for controlling Adobe Premiere Pro via CEP/ExtendScript — 437 tools for AI-driven video editing",
   "main": "dist/index.js",
   "type": "module",