autodev-cli 1.4.149 → 1.4.151

package/out/core/gimpPluginInstall.d.ts

@@ -0,0 +1,57 @@
+import { type DetectAppResult } from './binDetect';
+export interface GimpInstallDeps {
+    platform: NodeJS.Platform;
+    env: NodeJS.ProcessEnv;
+    homedir: () => string;
+    fileExists: (p: string) => boolean;
+    listDir: (p: string) => string[];
+    mkdirp: (p: string) => void;
+    writeFile: (p: string, data: string) => void;
+    chmod: (p: string, mode: number) => void;
+    copyFile: (src: string, dst: string) => void;
+    /** Read an existing file (for idempotent-skip content comparison). '' if unreadable. */
+    readFile: (p: string) => string;
+    /**
+     * The auto-start plugin source. Defaults to the EMBEDDED string
+     * (GIMP_PLUGIN_SOURCE) so it works when esbuild-bundled into the VS Code
+     * extension where media/gimp/gimp_mcp_server.py is NOT on disk at runtime.
+     */
+    readPluginSource: () => string;
+    /** GIMP detection (to gate on major < 3). Defaults to detectApp('gimp'). */
+    detectGimp: () => DetectAppResult;
+}
+export interface GimpInstallResult {
+    installed: boolean;
+    /** Absolute path(s) of the written gimp_mcp_server.py file(s). */
+    paths: string[];
+    /** The GIMP minor-version dir chosen (e.g. "3.2"), or null when not installed. */
+    version: string | null;
+    warnings: string[];
+}
+export interface GimpInstallOpts {
+    /**
+     * Explicit versioned GIMP config dir to target (e.g. `~/.config/GIMP/3.2`),
+     * bypassing the auto-resolver. Same semantics as GIMP3_DIRECTORY.
+     */
+    targetDir?: string;
+}
+/** Absolute path to the vendored auto-start plugin shipped in the tarball. */
+export declare function vendoredPluginSourcePath(): string;
+/** Extract the GIMP MAJOR version from a launcher path (e.g. gimp-2.10 → 2). */
+export declare function gimpMajorFromPath(p: string | null): number | null;
+/**
+ * Install the auto-start GIMP MCP plugin. Resolves the target plug-ins dir(s)
+ * per-OS and writes the vendored plugin so GIMP opens the localhost:9876 socket
+ * on launch. Does NOT install when a clearly < 3 GIMP is the only one detected.
+ */
+export declare function installGimpPlugin(opts?: GimpInstallOpts, deps?: Partial<GimpInstallDeps>): GimpInstallResult;
+/**
+ * Sync-path variant: install the auto-start plugin ONLY when GIMP 3.x is actually
+ * DETECTED. Unlike installGimpPlugin (which will create a 3.0 config dir even with
+ * no GIMP present — appropriate for the explicit `mcp detect --enable gimp` /
+ * `gimp-install-plugin` flows), this refuses to touch the filesystem when GIMP is
+ * absent or is clearly < 3, so a routine ConfigManager.syncProjectMcpServers on a
+ * box without GIMP never spuriously creates a config dir. Returns a skip result
+ * (installed:false + warning) instead of throwing so callers can swallow it.
+ */
+export declare function installGimpPluginIfDetected(opts?: GimpInstallOpts, deps?: Partial<GimpInstallDeps>): GimpInstallResult;

package/out/core/gimpPluginInstall.js

@@ -0,0 +1,273 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// gimpPluginInstall — drop the vendored AUTO-START GIMP MCP plugin into the
+// correct GIMP 3.x user plug-ins folder so the socket bridge opens on GIMP
+// launch (no manual copy, no menu click).
+//
+// GROUNDED RULES (see AutoDev research):
+//  - GIMP 3.x user config is MINOR-versioned: GIMP 3.2 → .../GIMP/3.2/ (NOT 3.0).
+//    Bases: linux $XDG_CONFIG_HOME/GIMP or ~/.config/GIMP; win32 %APPDATA%\GIMP;
+//    darwin ~/Library/Application Support/GIMP. Honor GIMP3_DIRECTORY (overrides
+//    the WHOLE versioned dir). Glob GIMP/3.* and pick the HIGHEST minor; if none
+//    exists, create 3.0 and warn (user should launch GIMP once).
+//  - GIMP 3.x layout: plug-ins/gimp_mcp_server/gimp_mcp_server.py — the .py MUST
+//    sit in a sub-folder whose name == the .py basename (a loose .py is ignored).
+//    On non-Windows the .py must be executable (0o755).
+//  - Windows Store (MSIX) GIMP reads the REAL %APPDATA%\GIMP\<ver>. As a safety
+//    net we ALSO write the virtualized path when a package dir exists:
+//    %LOCALAPPDATA%\Packages\GIMP.<...>_*\LocalCache\Roaming\GIMP\<ver>\plug-ins.
+//
+// Everything is dependency-injected (platform/env/homedir/fileExists/listDir/
+// mkdirp/writeFile/chmod/copyFile/readPluginSource/detectGimp) so the resolver is
+// unit-testable without a real GIMP or filesystem.
+// ---------------------------------------------------------------------------
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.vendoredPluginSourcePath = vendoredPluginSourcePath;
+exports.gimpMajorFromPath = gimpMajorFromPath;
+exports.installGimpPlugin = installGimpPlugin;
+exports.installGimpPluginIfDetected = installGimpPluginIfDetected;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const binDetect_1 = require("./binDetect");
+const gimpPluginSource_1 = require("./gimpPluginSource");
+/** Absolute path to the vendored auto-start plugin shipped in the tarball. */
+function vendoredPluginSourcePath() {
+    // Compiled to out/core/gimpPluginInstall.js → package root is ../../ .
+    return path.join(__dirname, '..', '..', 'media', 'gimp', 'gimp_mcp_server.py');
+}
+function realDeps() {
+    return {
+        platform: process.platform,
+        env: process.env,
+        homedir: os.homedir,
+        fileExists: (p) => { try {
+            return fs.existsSync(p);
+        }
+        catch {
+            return false;
+        } },
+        listDir: (p) => { try {
+            return fs.readdirSync(p);
+        }
+        catch {
+            return [];
+        } },
+        mkdirp: (p) => { fs.mkdirSync(p, { recursive: true }); },
+        writeFile: (p, data) => { fs.writeFileSync(p, data); },
+        chmod: (p, mode) => { try {
+            fs.chmodSync(p, mode);
+        }
+        catch { /* non-POSIX fs */ } },
+        copyFile: (src, dst) => { fs.copyFileSync(src, dst); },
+        readFile: (p) => { try {
+            return fs.readFileSync(p, 'utf8');
+        }
+        catch {
+            return '';
+        } },
+        // Runtime uses the EMBEDDED source (bundle-safe). media/gimp/gimp_mcp_server.py
+        // stays the canonical source + GPL attribution, but is no longer read at runtime.
+        readPluginSource: () => gimpPluginSource_1.GIMP_PLUGIN_SOURCE,
+        detectGimp: () => (0, binDetect_1.detectApp)('gimp'),
+    };
+}
+/** GIMP user-config BASE dir (the folder that CONTAINS the 3.x version dirs). */
+function gimpConfigBase(d) {
+    const home = d.homedir();
+    if (d.platform === 'win32') {
+        const appData = d.env.APPDATA || path.join(home, 'AppData', 'Roaming');
+        return path.join(appData, 'GIMP');
+    }
+    if (d.platform === 'darwin') {
+        return path.join(home, 'Library', 'Application Support', 'GIMP');
+    }
+    const xdg = d.env.XDG_CONFIG_HOME && d.env.XDG_CONFIG_HOME.trim();
+    const cfg = xdg ? xdg : path.join(home, '.config');
+    return path.join(cfg, 'GIMP');
+}
+/** Parse the numeric minor from a `3.<minor>` dir name; null if not `3.*`. */
+function minorOf(name) {
+    const m = /^3\.(\d+)$/.exec(name);
+    return m ? parseInt(m[1], 10) : null;
+}
+/**
+ * Pick the HIGHEST-minor `3.*` version dir under base. Returns the chosen
+ * version string and whether it already existed. When none exist, defaults to
+ * "3.0" (created + warned by the caller).
+ */
+function chooseVersion(base, d) {
+    const kids = d.listDir(base)
+        .map((n) => ({ name: n, minor: minorOf(n) }))
+        .filter((x) => x.minor !== null);
+    if (kids.length === 0) {
+        return { version: '3.0', existed: false };
+    }
+    kids.sort((a, b) => b.minor - a.minor);
+    return { version: kids[0].name, existed: true };
+}
+/**
+ * Windows Store virtualized fallback plug-ins dir(s) for a given version. Only
+ * returned when a `GIMP.*` package dir actually exists under %LOCALAPPDATA%\Packages.
+ */
+function storeVirtualizedPluginDirs(version, d) {
+    if (d.platform !== 'win32') {
+        return [];
+    }
+    const home = d.homedir();
+    const localAppData = d.env.LOCALAPPDATA || path.join(home, 'AppData', 'Local');
+    const packagesDir = path.join(localAppData, 'Packages');
+    const pkgs = d.listDir(packagesDir).filter((n) => /^GIMP\./i.test(n));
+    return pkgs.map((pkg) => path.join(packagesDir, pkg, 'LocalCache', 'Roaming', 'GIMP', version, 'plug-ins'));
+}
+/** Extract the GIMP MAJOR version from a launcher path (e.g. gimp-2.10 → 2). */
+function gimpMajorFromPath(p) {
+    if (!p) {
+        return null;
+    }
+    const base = p.replace(/\\/g, '/').split('/').pop() || p;
+    const m = /gimp[-_]?(\d+)/i.exec(base);
+    return m ? parseInt(m[1], 10) : null;
+}
+/**
+ * Write the plugin into one plug-ins dir. IDEMPOTENT: if the target already
+ * holds byte-identical content, skip the write (and the .bak) — but still ensure
+ * the executable bit on non-Windows. A .bak backup is made ONLY when overwriting
+ * content that DIFFERS from the source.
+ */
+function installInto(pluginsDir, source, d) {
+    const sub = path.join(pluginsDir, 'gimp_mcp_server');
+    const py = path.join(sub, 'gimp_mcp_server.py');
+    d.mkdirp(sub);
+    if (d.fileExists(py)) {
+        const existing = d.readFile(py);
+        if (existing === source) {
+            // Already up to date — no write, no backup. Still ensure it's executable.
+            if (d.platform !== 'win32') {
+                d.chmod(py, 0o755);
+            }
+            return py;
+        }
+        // Different content → back it up before overwriting.
+        d.copyFile(py, py + '.bak');
+    }
+    d.writeFile(py, source);
+    if (d.platform !== 'win32') {
+        d.chmod(py, 0o755);
+    }
+    return py;
+}
+/**
+ * Install the auto-start GIMP MCP plugin. Resolves the target plug-ins dir(s)
+ * per-OS and writes the vendored plugin so GIMP opens the localhost:9876 socket
+ * on launch. Does NOT install when a clearly < 3 GIMP is the only one detected.
+ */
+function installGimpPlugin(opts, deps) {
+    const d = { ...realDeps(), ...deps };
+    const warnings = [];
+    // Gate: if a GIMP is detected and is clearly < 3, do not install.
+    const det = d.detectGimp();
+    const major = gimpMajorFromPath(det.path);
+    if (det.installed && major !== null && major < 3) {
+        warnings.push(`Detected GIMP ${major}.x at ${det.path}. GIMP MCP needs GIMP 3.x — ` +
+            'the auto-start plugin uses the GIMP 3.0 Python API and was NOT installed. ' +
+            'Install GIMP 3 and re-run.');
+        return { installed: false, paths: [], version: null, warnings };
+    }
+    const source = d.readPluginSource();
+    // Resolve the versioned config dir(s). GIMP3_DIRECTORY / opts.targetDir
+    // override the WHOLE versioned dir.
+    const override = (opts?.targetDir && opts.targetDir.trim()) || (d.env.GIMP3_DIRECTORY && d.env.GIMP3_DIRECTORY.trim());
+    const targets = [];
+    let version;
+    if (override) {
+        version = path.basename(override) || 'custom';
+        if (!d.fileExists(override)) {
+            warnings.push(`GIMP dir ${override} does not exist yet — creating it. Launch GIMP once so it initialises its config.`);
+        }
+        targets.push(path.join(override, 'plug-ins'));
+    }
+    else {
+        const base = gimpConfigBase(d);
+        const chosen = chooseVersion(base, d);
+        version = chosen.version;
+        if (!chosen.existed) {
+            warnings.push(`No GIMP 3.x config dir found under ${base} — creating ${version}. ` +
+                'Launch GIMP 3 at least once (so it creates its real config dir), then re-run to be sure it lands in the right place.');
+        }
+        targets.push(path.join(base, version, 'plug-ins'));
+        // Windows Store virtualized safety net (only when a package dir exists).
+        for (const vdir of storeVirtualizedPluginDirs(version, d)) {
+            targets.push(vdir);
+        }
+    }
+    const paths = [];
+    for (const pluginsDir of targets) {
+        try {
+            paths.push(installInto(pluginsDir, source, d));
+        }
+        catch (e) {
+            warnings.push(`Failed to write plugin into ${pluginsDir}: ${e.message}`);
+        }
+    }
+    return { installed: paths.length > 0, paths, version, warnings };
+}
+/**
+ * Sync-path variant: install the auto-start plugin ONLY when GIMP 3.x is actually
+ * DETECTED. Unlike installGimpPlugin (which will create a 3.0 config dir even with
+ * no GIMP present — appropriate for the explicit `mcp detect --enable gimp` /
+ * `gimp-install-plugin` flows), this refuses to touch the filesystem when GIMP is
+ * absent or is clearly < 3, so a routine ConfigManager.syncProjectMcpServers on a
+ * box without GIMP never spuriously creates a config dir. Returns a skip result
+ * (installed:false + warning) instead of throwing so callers can swallow it.
+ */
+function installGimpPluginIfDetected(opts, deps) {
+    const d = { ...realDeps(), ...deps };
+    const det = d.detectGimp();
+    const major = gimpMajorFromPath(det.path);
+    // Require a detected GIMP that is not clearly < 3 (major null = version not in
+    // the launcher path, e.g. a macOS app bundle — allowed).
+    if (!det.installed || (major !== null && major < 3)) {
+        return {
+            installed: false,
+            paths: [],
+            version: null,
+            warnings: ['GIMP 3.x not detected — auto-start plugin install skipped (sync path).'],
+        };
+    }
+    return installGimpPlugin(opts, deps);
+}
+//# sourceMappingURL=gimpPluginInstall.js.map

package/out/core/gimpPluginInstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gimpPluginInstall.js","sourceRoot":"","sources":["../../src/core/gimpPluginInstall.ts"],"names":[],"mappings":"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"}

package/out/core/gimpPluginSource.d.ts

@@ -0,0 +1,4 @@
+/** sha256 (first 12 hex) of the canonical media/gimp/gimp_mcp_server.py. */
+export declare const GIMP_PLUGIN_SOURCE_HASH = "93b608412db2";
+/** Full body of the auto-start GIMP 3.x MCP plugin (media/gimp/gimp_mcp_server.py). */
+export declare const GIMP_PLUGIN_SOURCE = "#!/usr/bin/env python3\n# -*- coding: utf-8 -*-\n#\n# gimp_mcp_server.py \u2014 AutoDev auto-start GIMP 3.x MCP bridge\n#\n# Derived from libreearth/gimp-mcp @49c46dd (GPL-3.0); modified by AutoDev to\n# auto-start as a GIMP 3.x PERSISTENT extension. The upstream plugin registered a\n# manual \"<Image>/Filters/Development/ \u2192 Start MCP Server\" ImageProcedure that the\n# user had to click; this variant registers a PERSISTENT extension so GIMP starts\n# the socket server automatically on launch \u2014 no menu click, no open image needed.\n#\n# The socket / command-marshalling logic (start_server, handle_client,\n# execute_command, GLib.idle_add onto GIMP's main thread) is kept from upstream.\n# ONLY the registration + run() model changed to PERSISTENT + defensive ordering.\n#\n# ---------------------------------------------------------------------------\n# GIMP 3.x plugin layout (REQUIRED): this file must live at\n#   <gimp-config>/<ver>/plug-ins/gimp_mcp_server/gimp_mcp_server.py\n# i.e. inside a sub-folder whose name == this file's basename. A loose .py is\n# IGNORED by GIMP 3.x. On Linux/macOS it must ALSO be executable (chmod 0o755).\n# ---------------------------------------------------------------------------\n#\n# Copyright (C) 2023 libreearth (upstream, GPL-3.0)\n# Modifications Copyright (C) 2025 AutoDev\n#\n# This program is free software: you can redistribute it and/or modify it under\n# the terms of the GNU General Public License as published by the Free Software\n# Foundation, either version 3 of the License, or (at your option) any later\n# version.\n#\n# This program is distributed in the hope that it will be useful, but WITHOUT ANY\n# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A\n# PARTICULAR PURPOSE. See the GNU General Public License for more details.\n#\n# You should have received a copy of the GNU General Public License along with\n# this program. If not, see <https://www.gnu.org/licenses/>. A copy is vendored\n# next to this file as LICENSE.\n\nimport os\nimport sys\nimport json\nimport socket\nimport threading\nimport traceback\nimport datetime\n\nimport gi\ngi.require_version('Gimp', '3.0')\nfrom gi.repository import Gimp\nfrom gi.repository import GLib\n\n\n# ---------------------------------------------------------------------------\n# Logging \u2014 an auto-start extension has NO console, so every diagnostic goes to\n# a log file the user can read. We resolve it next to this plug-in first (always\n# writable if the plug-in loaded at all), falling back to the GIMP config dir.\n# Nothing here may raise: a logging failure must never stop GIMP from launching.\n# ---------------------------------------------------------------------------\ndef _log_path():\n    try:\n        here = os.path.dirname(os.path.abspath(__file__))\n        return os.path.join(here, 'gimp-mcp-server.log')\n    except Exception:\n        try:\n            return os.path.join(GLib.get_user_config_dir(), 'gimp-mcp-server.log')\n        except Exception:\n            return os.path.join(os.path.expanduser('~'), 'gimp-mcp-server.log')\n\n\n_LOG_FILE = _log_path()\n\n\ndef log(msg):\n    \"\"\"Best-effort append to the log file AND stderr. Never raises.\"\"\"\n    line = '[%s] %s' % (datetime.datetime.now().isoformat(timespec='seconds'), msg)\n    try:\n        with open(_LOG_FILE, 'a', encoding='utf-8') as fh:\n            fh.write(line + '\\n')\n    except Exception:\n        pass\n    try:\n        sys.stderr.write(line + '\\n')\n    except Exception:\n        pass\n\n\nclass MCPPlugin(Gimp.PlugIn):\n    # \u2500\u2500 Registration \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n    def do_query_procedures(self):\n        return [\"plug-in-mcp-server-autostart\"]\n\n    def do_create_procedure(self, name):\n        # PERSISTENT + no args + no menu = GIMP auto-starts this extension at\n        # launch. Adding ANY argument, a menu label, or a menu path would turn\n        # it back into a user-invoked plug-in and disable auto-start.\n        procedure = Gimp.Procedure.new(\n            self, name, Gimp.PDBProcType.PERSISTENT, self.run, None,\n        )\n        try:\n            procedure.set_documentation(\n                \"AutoDev MCP server (auto-start)\",\n                \"Auto-starts a localhost:9876 socket bridge so external MCP \"\n                \"clients can drive GIMP. Derived from libreearth/gimp-mcp \"\n                \"(GPL-3.0), modified by AutoDev to run as a PERSISTENT extension.\",\n                name,\n            )\n            procedure.set_attribution(\"AutoDev\", \"AutoDev (GPL-3.0)\", \"2025\")\n        except Exception as e:\n            # Attribution/doc setters are cosmetic \u2014 never let a binding\n            # mismatch here prevent the procedure from registering.\n            log(\"do_create_procedure: non-fatal setter error: %s\" % e)\n        return procedure\n\n    # \u2500\u2500 Extension entry point \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n    def run(self, procedure, config, run_data):\n        \"\"\"PERSISTENT extension entry point.\n\n        DEFENSIVE ORDER (the brick-risk part): call persistent_ready() FIRST.\n        Its ABSENCE is what hangs GIMP at startup, so it must run before\n        anything that could throw. Everything after it is wrapped so a bind\n        failure logs + degrades instead of taking GIMP core down with it.\n        \"\"\"\n        # 1) Hand control back to GIMP core IMMEDIATELY so the UI keeps loading.\n        try:\n            procedure.persistent_ready()\n            log(\"persistent_ready() OK \u2014 extension is live\")\n        except Exception as e:\n            # A binding mismatch on this exact call is the known lock-up cause;\n            # log it (do NOT re-raise) so GIMP still finishes launching.\n            log(\"persistent_ready() FAILED (non-fatal): %s\\n%s\"\n                % (e, traceback.format_exc()))\n\n        # 2) Start the socket server on a daemon thread. A bind failure (port in\n        #    use, sandbox denial) MUST NOT crash the process or block launch.\n        try:\n            t = threading.Thread(target=self.start_server, daemon=True)\n            t.start()\n            log(\"MCP server thread started (listening on localhost:9876)\")\n        except Exception as e:\n            log(\"failed to start MCP server thread (non-fatal): %s\\n%s\"\n                % (e, traceback.format_exc()))\n\n        # 3) Keep this extension process alive for the whole GIMP session so the\n        #    socket stays open and idle_add callbacks can marshal onto core.\n        try:\n            GLib.MainLoop().run()\n        except Exception as e:\n            log(\"main loop exited (non-fatal): %s\" % e)\n\n        # 4) Standard PERSISTENT success return.\n        return procedure.new_return_values(Gimp.PDBStatusType.SUCCESS, GLib.Error())\n\n    # \u2500\u2500 Socket server (kept from upstream) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n    def start_server(self):\n        host = 'localhost'\n        port = 9876\n        sock = None\n        try:\n            sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)\n            sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)\n            sock.bind((host, port))\n            sock.listen(1)\n            log(\"server listening on %s:%d\" % (host, port))\n        except Exception as e:\n            # Bind/listen failed (e.g. port already taken by Blender's MCP or a\n            # second GIMP). Log + bail out of the thread; GIMP keeps running.\n            log(\"bind/listen failed (non-fatal): %s\\n%s\" % (e, traceback.format_exc()))\n            try:\n                if sock is not None:\n                    sock.close()\n            except Exception:\n                pass\n            return\n\n        while True:\n            try:\n                client, addr = sock.accept()\n                log(\"client connected: %s\" % (addr,))\n                threading.Thread(\n                    target=self.handle_client, args=(client,), daemon=True,\n                ).start()\n            except Exception as e:\n                log(\"accept error: %s\" % e)\n                break\n        try:\n            sock.close()\n        except Exception:\n            pass\n\n    def handle_client(self, client):\n        buffer = b''\n        while True:\n            try:\n                data = client.recv(1024)\n                if not data:\n                    break\n                buffer += data\n                try:\n                    command = json.loads(buffer.decode('utf-8'))\n                    buffer = b''\n                    # Marshal onto GIMP's main thread \u2014 the PDB is not thread-safe.\n                    GLib.idle_add(self.execute_command, command, client)\n                except json.JSONDecodeError:\n                    # Partial frame \u2014 keep buffering until it parses.\n                    continue\n            except Exception as e:\n                log(\"client error: %s\" % e)\n                break\n        try:\n            client.close()\n        except Exception:\n            pass\n\n    def execute_command(self, command, client):\n        \"\"\"Runs on GIMP's main thread via idle_add. Guarded so a bad command or\n        a wrong binding logs + returns an error frame rather than hanging.\"\"\"\n        response = {}\n        try:\n            cmd_type = command.get(\"type\")\n            params = command.get(\"params\", {})\n\n            if cmd_type == \"call_api\":\n                api_path = params[\"api_path\"]\n                args = params.get(\"args\", [])\n                kwargs = params.get(\"kwargs\", {})\n\n                module = Gimp\n                for part in api_path.split(\".\"):\n                    module = getattr(module, part)\n\n                result = module(*args, **kwargs)\n\n                if hasattr(result, \"ID\"):\n                    result = {\"id\": result.ID}\n                elif isinstance(result, list):\n                    result = [self.serialize_gimp_object(item) for item in result]\n                else:\n                    result = str(result)\n\n                response = {\"status\": \"success\", \"result\": result}\n            else:\n                response = {\"status\": \"error\", \"message\": \"Unknown command: %s\" % cmd_type}\n        except Exception as e:\n            response = {\"status\": \"error\", \"message\": str(e),\n                        \"traceback\": traceback.format_exc()}\n\n        try:\n            client.sendall(json.dumps(response).encode('utf-8'))\n        except Exception as e:\n            log(\"failed to send response: %s\" % e)\n        return False  # one-shot idle callback\n\n    def serialize_gimp_object(self, obj):\n        try:\n            if hasattr(obj, \"ID\"):\n                return {\"id\": obj.ID, \"type\": obj.__class__.__name__}\n        except Exception:\n            pass\n        return str(obj)\n\n\ntry:\n    Gimp.main(MCPPlugin.__gtype__, sys.argv)\nexcept Exception as _e:\n    # If GIMP's main dispatch itself fails, log it \u2014 never let the plug-in\n    # process take the launch down with an unhandled traceback.\n    log(\"Gimp.main failed: %s\\n%s\" % (_e, traceback.format_exc()))\n";

package/out/core/gimpPluginSource.js

@@ -0,0 +1,284 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// gimpPluginSource.ts — GENERATED. Do not edit by hand.
+//
+// Source of truth: media/gimp/gimp_mcp_server.py (GPL-3.0; see media/gimp/LICENSE).
+// Regenerate with:  node scripts/gen-gimp-plugin-source.mjs  (runs in `npm run build`).
+//
+// This embeds the auto-start GIMP MCP plugin body as a string so the installer
+// works even when bundled (VS Code extension esbuild) with no media file on disk.
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GIMP_PLUGIN_SOURCE = exports.GIMP_PLUGIN_SOURCE_HASH = void 0;
+/** sha256 (first 12 hex) of the canonical media/gimp/gimp_mcp_server.py. */
+exports.GIMP_PLUGIN_SOURCE_HASH = "93b608412db2";
+/** Full body of the auto-start GIMP 3.x MCP plugin (media/gimp/gimp_mcp_server.py). */
+exports.GIMP_PLUGIN_SOURCE = `#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+#
+# gimp_mcp_server.py — AutoDev auto-start GIMP 3.x MCP bridge
+#
+# Derived from libreearth/gimp-mcp @49c46dd (GPL-3.0); modified by AutoDev to
+# auto-start as a GIMP 3.x PERSISTENT extension. The upstream plugin registered a
+# manual "<Image>/Filters/Development/ → Start MCP Server" ImageProcedure that the
+# user had to click; this variant registers a PERSISTENT extension so GIMP starts
+# the socket server automatically on launch — no menu click, no open image needed.
+#
+# The socket / command-marshalling logic (start_server, handle_client,
+# execute_command, GLib.idle_add onto GIMP's main thread) is kept from upstream.
+# ONLY the registration + run() model changed to PERSISTENT + defensive ordering.
+#
+# ---------------------------------------------------------------------------
+# GIMP 3.x plugin layout (REQUIRED): this file must live at
+#   <gimp-config>/<ver>/plug-ins/gimp_mcp_server/gimp_mcp_server.py
+# i.e. inside a sub-folder whose name == this file's basename. A loose .py is
+# IGNORED by GIMP 3.x. On Linux/macOS it must ALSO be executable (chmod 0o755).
+# ---------------------------------------------------------------------------
+#
+# Copyright (C) 2023 libreearth (upstream, GPL-3.0)
+# Modifications Copyright (C) 2025 AutoDev
+#
+# This program is free software: you can redistribute it and/or modify it under
+# the terms of the GNU General Public License as published by the Free Software
+# Foundation, either version 3 of the License, or (at your option) any later
+# version.
+#
+# This program is distributed in the hope that it will be useful, but WITHOUT ANY
+# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+# PARTICULAR PURPOSE. See the GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along with
+# this program. If not, see <https://www.gnu.org/licenses/>. A copy is vendored
+# next to this file as LICENSE.
+
+import os
+import sys
+import json
+import socket
+import threading
+import traceback
+import datetime
+
+import gi
+gi.require_version('Gimp', '3.0')
+from gi.repository import Gimp
+from gi.repository import GLib
+
+
+# ---------------------------------------------------------------------------
+# Logging — an auto-start extension has NO console, so every diagnostic goes to
+# a log file the user can read. We resolve it next to this plug-in first (always
+# writable if the plug-in loaded at all), falling back to the GIMP config dir.
+# Nothing here may raise: a logging failure must never stop GIMP from launching.
+# ---------------------------------------------------------------------------
+def _log_path():
+    try:
+        here = os.path.dirname(os.path.abspath(__file__))
+        return os.path.join(here, 'gimp-mcp-server.log')
+    except Exception:
+        try:
+            return os.path.join(GLib.get_user_config_dir(), 'gimp-mcp-server.log')
+        except Exception:
+            return os.path.join(os.path.expanduser('~'), 'gimp-mcp-server.log')
+
+
+_LOG_FILE = _log_path()
+
+
+def log(msg):
+    """Best-effort append to the log file AND stderr. Never raises."""
+    line = '[%s] %s' % (datetime.datetime.now().isoformat(timespec='seconds'), msg)
+    try:
+        with open(_LOG_FILE, 'a', encoding='utf-8') as fh:
+            fh.write(line + '\\n')
+    except Exception:
+        pass
+    try:
+        sys.stderr.write(line + '\\n')
+    except Exception:
+        pass
+
+
+class MCPPlugin(Gimp.PlugIn):
+    # ── Registration ──────────────────────────────────────────────────────
+    def do_query_procedures(self):
+        return ["plug-in-mcp-server-autostart"]
+
+    def do_create_procedure(self, name):
+        # PERSISTENT + no args + no menu = GIMP auto-starts this extension at
+        # launch. Adding ANY argument, a menu label, or a menu path would turn
+        # it back into a user-invoked plug-in and disable auto-start.
+        procedure = Gimp.Procedure.new(
+            self, name, Gimp.PDBProcType.PERSISTENT, self.run, None,
+        )
+        try:
+            procedure.set_documentation(
+                "AutoDev MCP server (auto-start)",
+                "Auto-starts a localhost:9876 socket bridge so external MCP "
+                "clients can drive GIMP. Derived from libreearth/gimp-mcp "
+                "(GPL-3.0), modified by AutoDev to run as a PERSISTENT extension.",
+                name,
+            )
+            procedure.set_attribution("AutoDev", "AutoDev (GPL-3.0)", "2025")
+        except Exception as e:
+            # Attribution/doc setters are cosmetic — never let a binding
+            # mismatch here prevent the procedure from registering.
+            log("do_create_procedure: non-fatal setter error: %s" % e)
+        return procedure
+
+    # ── Extension entry point ─────────────────────────────────────────────
+    def run(self, procedure, config, run_data):
+        """PERSISTENT extension entry point.
+
+        DEFENSIVE ORDER (the brick-risk part): call persistent_ready() FIRST.
+        Its ABSENCE is what hangs GIMP at startup, so it must run before
+        anything that could throw. Everything after it is wrapped so a bind
+        failure logs + degrades instead of taking GIMP core down with it.
+        """
+        # 1) Hand control back to GIMP core IMMEDIATELY so the UI keeps loading.
+        try:
+            procedure.persistent_ready()
+            log("persistent_ready() OK — extension is live")
+        except Exception as e:
+            # A binding mismatch on this exact call is the known lock-up cause;
+            # log it (do NOT re-raise) so GIMP still finishes launching.
+            log("persistent_ready() FAILED (non-fatal): %s\\n%s"
+                % (e, traceback.format_exc()))
+
+        # 2) Start the socket server on a daemon thread. A bind failure (port in
+        #    use, sandbox denial) MUST NOT crash the process or block launch.
+        try:
+            t = threading.Thread(target=self.start_server, daemon=True)
+            t.start()
+            log("MCP server thread started (listening on localhost:9876)")
+        except Exception as e:
+            log("failed to start MCP server thread (non-fatal): %s\\n%s"
+                % (e, traceback.format_exc()))
+
+        # 3) Keep this extension process alive for the whole GIMP session so the
+        #    socket stays open and idle_add callbacks can marshal onto core.
+        try:
+            GLib.MainLoop().run()
+        except Exception as e:
+            log("main loop exited (non-fatal): %s" % e)
+
+        # 4) Standard PERSISTENT success return.
+        return procedure.new_return_values(Gimp.PDBStatusType.SUCCESS, GLib.Error())
+
+    # ── Socket server (kept from upstream) ────────────────────────────────
+    def start_server(self):
+        host = 'localhost'
+        port = 9876
+        sock = None
+        try:
+            sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+            sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
+            sock.bind((host, port))
+            sock.listen(1)
+            log("server listening on %s:%d" % (host, port))
+        except Exception as e:
+            # Bind/listen failed (e.g. port already taken by Blender's MCP or a
+            # second GIMP). Log + bail out of the thread; GIMP keeps running.
+            log("bind/listen failed (non-fatal): %s\\n%s" % (e, traceback.format_exc()))
+            try:
+                if sock is not None:
+                    sock.close()
+            except Exception:
+                pass
+            return
+
+        while True:
+            try:
+                client, addr = sock.accept()
+                log("client connected: %s" % (addr,))
+                threading.Thread(
+                    target=self.handle_client, args=(client,), daemon=True,
+                ).start()
+            except Exception as e:
+                log("accept error: %s" % e)
+                break
+        try:
+            sock.close()
+        except Exception:
+            pass
+
+    def handle_client(self, client):
+        buffer = b''
+        while True:
+            try:
+                data = client.recv(1024)
+                if not data:
+                    break
+                buffer += data
+                try:
+                    command = json.loads(buffer.decode('utf-8'))
+                    buffer = b''
+                    # Marshal onto GIMP's main thread — the PDB is not thread-safe.
+                    GLib.idle_add(self.execute_command, command, client)
+                except json.JSONDecodeError:
+                    # Partial frame — keep buffering until it parses.
+                    continue
+            except Exception as e:
+                log("client error: %s" % e)
+                break
+        try:
+            client.close()
+        except Exception:
+            pass
+
+    def execute_command(self, command, client):
+        """Runs on GIMP's main thread via idle_add. Guarded so a bad command or
+        a wrong binding logs + returns an error frame rather than hanging."""
+        response = {}
+        try:
+            cmd_type = command.get("type")
+            params = command.get("params", {})
+
+            if cmd_type == "call_api":
+                api_path = params["api_path"]
+                args = params.get("args", [])
+                kwargs = params.get("kwargs", {})
+
+                module = Gimp
+                for part in api_path.split("."):
+                    module = getattr(module, part)
+
+                result = module(*args, **kwargs)
+
+                if hasattr(result, "ID"):
+                    result = {"id": result.ID}
+                elif isinstance(result, list):
+                    result = [self.serialize_gimp_object(item) for item in result]
+                else:
+                    result = str(result)
+
+                response = {"status": "success", "result": result}
+            else:
+                response = {"status": "error", "message": "Unknown command: %s" % cmd_type}
+        except Exception as e:
+            response = {"status": "error", "message": str(e),
+                        "traceback": traceback.format_exc()}
+
+        try:
+            client.sendall(json.dumps(response).encode('utf-8'))
+        except Exception as e:
+            log("failed to send response: %s" % e)
+        return False  # one-shot idle callback
+
+    def serialize_gimp_object(self, obj):
+        try:
+            if hasattr(obj, "ID"):
+                return {"id": obj.ID, "type": obj.__class__.__name__}
+        except Exception:
+            pass
+        return str(obj)
+
+
+try:
+    Gimp.main(MCPPlugin.__gtype__, sys.argv)
+except Exception as _e:
+    # If GIMP's main dispatch itself fails, log it — never let the plug-in
+    # process take the launch down with an unhandled traceback.
+    log("Gimp.main failed: %s\\n%s" % (_e, traceback.format_exc()))
+`;
+//# sourceMappingURL=gimpPluginSource.js.map

package/out/core/gimpPluginSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gimpPluginSource.js","sourceRoot":"","sources":["../../src/core/gimpPluginSource.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,wDAAwD;AACxD,EAAE;AACF,oFAAoF;AACpF,wFAAwF;AACxF,EAAE;AACF,+EAA+E;AAC/E,kFAAkF;AAClF,8EAA8E;;;AAE9E,4EAA4E;AAC/D,QAAA,uBAAuB,GAAG,cAAc,CAAC;AAEtD,uFAAuF;AAC1E,QAAA,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2QjC,CAAC"}