autodev-cli 1.4.150 → 1.4.152

package/out/core/gimpPluginSource.js

@@ -0,0 +1,383 @@
+"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`).
+//
+// Embeds the user-verified GIMP 3.x MCP server plug-in 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 = "c4b85cccece9";
+/** Full body of the user-verified GIMP 3.x MCP server plug-in (media/gimp/gimp_mcp_server.py). */
+exports.GIMP_PLUGIN_SOURCE = `#!/usr/bin/env python3
+# ---------------------------------------------------------------------------
+# gimp_mcp_server.py — vendored, USER-VERIFIED GIMP 3.2 MCP bridge (plug-in).
+#
+# Derived from libreearth/gimp-mcp (GPL-3.0; see media/gimp/LICENSE) and fixed by
+# the user / AutoDev for GIMP 3.2 (Store / MSIX). Verified working on real GIMP
+# 3.2.44: a menu-triggered PLUGIN (Tools -> MCP / Filters -> Development -> Start
+# MCP Server) that listens on 127.0.0.1:9876 and drives GIMP. Keep the "GIMP MCP
+# Server" window open — GLib.MainLoop() holds the out-of-process plug-in alive.
+#
+# This is the user's verified file; the body below is kept byte-for-byte. The
+# lines in THIS block are a provenance comment only — do not edit the code below.
+# ---------------------------------------------------------------------------
+
+# GIMP MCP Server Plugin (GIMP 3.2)
+# Listens on localhost:9876 so the libreearth gimp-mcp client can drive GIMP.
+
+import gi
+gi.require_version('Gimp', '3.0')
+from gi.repository import Gimp
+from gi.repository import GLib
+from gi.repository import Gio
+from gi.repository import GObject
+
+import io
+import json
+import os
+import socket
+import sys
+import threading
+import traceback
+
+HOST = '127.0.0.1'
+PORT = 9876
+# Store GIMP redirects GLib config dir into the MSIX LocalCache. Also write
+# to the real roaming profile so the log is findable.
+_LOG_PATHS = [
+    os.path.join(GLib.get_user_config_dir(), 'GIMP', '3.2', 'gimp_mcp_server.log'),
+    os.path.join(os.environ.get('APPDATA', ''), 'GIMP', '3.2', 'gimp_mcp_server.log'),
+]
+
+_server_lock = threading.Lock()
+_server_started = False
+_exec_globals = None
+_main_loop = None
+
+
+def _log(msg):
+    line = msg.rstrip() + '\\n'
+    for path in _LOG_PATHS:
+        if not path:
+            continue
+        try:
+            os.makedirs(os.path.dirname(path), exist_ok=True)
+            with open(path, 'a', encoding='utf-8') as fh:
+                fh.write(line)
+        except Exception:
+            pass
+    print(msg, flush=True)
+
+
+def N_(message):
+    return message
+
+
+def _(message):
+    return GLib.dgettext(None, message)
+
+
+def _serialize(obj):
+    if obj is None or isinstance(obj, (str, int, float, bool)):
+        return obj
+    if isinstance(obj, (list, tuple)):
+        return [_serialize(item) for item in obj]
+    if isinstance(obj, dict):
+        return {str(k): _serialize(v) for k, v in obj.items()}
+    data = {'type': obj.__class__.__name__}
+    if hasattr(obj, 'get_id'):
+        try:
+            data['id'] = int(obj.get_id())
+        except Exception:
+            pass
+    elif hasattr(obj, 'ID'):
+        data['id'] = obj.ID
+    if hasattr(obj, 'get_name'):
+        try:
+            data['name'] = obj.get_name()
+        except Exception:
+            pass
+    if 'id' not in data and len(data) == 1:
+        return str(obj)
+    return data
+
+
+def _resolve_api(api_path):
+    parts = [p for p in str(api_path).split('.') if p]
+    if parts and parts[0] == 'Gimp':
+        parts = parts[1:]
+    elif len(parts) >= 3 and parts[0] == 'gi' and parts[1] == 'repository' and parts[2] == 'Gimp':
+        parts = parts[3:]
+
+    aliases = {
+        'list_images': 'get_images',
+        'list_fonts': 'get_fonts',
+        'fonts_get_list': 'get_fonts',
+    }
+
+    if not parts:
+        return Gimp
+
+    obj = Gimp
+    for part in parts:
+        part = aliases.get(part, part)
+        obj = getattr(obj, part)
+    return obj
+
+
+def _exec_namespace():
+    global _exec_globals
+    if _exec_globals is None:
+        ns = {
+            '__builtins__': __builtins__,
+            '__name__': '__main__',
+            'Gimp': Gimp,
+            'GLib': GLib,
+            'Gio': Gio,
+            'GObject': GObject,
+            'sys': sys,
+            'os': os,
+            'json': json,
+        }
+        try:
+            gi.require_version('Gegl', '0.4')
+            from gi.repository import Gegl
+            ns['Gegl'] = Gegl
+        except Exception as exc:
+            _log(f'Gegl import failed: {exc}')
+        try:
+            gi.require_version('Babl', '0.1')
+            from gi.repository import Babl
+            ns['Babl'] = Babl
+        except Exception:
+            pass
+        _exec_globals = ns
+    return _exec_globals
+
+
+def _extract_code(args, kwargs):
+    if kwargs.get('code'):
+        return str(kwargs['code'])
+    if not args:
+        return ''
+    if len(args) >= 2 and args[0] in ('exec', 'eval', 'pyGObject-console'):
+        payload = args[1]
+        if isinstance(payload, (list, tuple)):
+            return '\\n'.join(str(item) for item in payload)
+        return str(payload)
+    if isinstance(args[0], (list, tuple)):
+        return '\\n'.join(str(item) for item in args[0])
+    return str(args[0])
+
+
+def _run_python(code):
+    ns = _exec_namespace()
+    stdout = io.StringIO()
+    old_stdout = sys.stdout
+    sys.stdout = stdout
+    try:
+        exec(code, ns)
+    finally:
+        sys.stdout = old_stdout
+    printed = stdout.getvalue()
+    result = ns.get('_result')
+    if result is not None:
+        return {'printed': printed, 'result': _serialize(result)}
+    return {'printed': printed, 'result': None}
+
+
+class MCPPlugin(Gimp.PlugIn):
+    def do_set_i18n(self, name):
+        return False
+
+    def do_query_procedures(self):
+        return ['plug-in-mcp-server']
+
+    def do_create_procedure(self, name):
+        procedure = Gimp.Procedure.new(
+            self, name, Gimp.PDBProcType.PLUGIN, self.run, None
+        )
+        procedure.set_menu_label(_('Start MCP Server'))
+        procedure.set_documentation(
+            _('Starts an MCP server to control GIMP externally'),
+            _('Listens on 127.0.0.1:9876 for the GIMP MCP client'),
+            name,
+        )
+        procedure.set_attribution('GIMP MCP', 'GIMP MCP', '2026')
+        procedure.set_sensitivity_mask(Gimp.ProcedureSensitivityMask.ALWAYS)
+        procedure.add_enum_argument(
+            'run-mode',
+            _('Run mode'),
+            _('The run mode'),
+            Gimp.RunMode,
+            Gimp.RunMode.INTERACTIVE,
+            GObject.ParamFlags.READWRITE,
+        )
+        procedure.add_menu_path('<Image>/Tools/MCP')
+        procedure.add_menu_path('<Image>/Filters/Development/')
+        return procedure
+
+    def run(self, procedure, config, data):
+        global _main_loop
+        started, message = self.ensure_server()
+        _log(message)
+        try:
+            Gimp.message(message)
+        except Exception:
+            pass
+        if not started:
+            return procedure.new_return_values(Gimp.PDBStatusType.EXECUTION_ERROR, GLib.Error(message))
+
+        # GIMP 3 launches Python plug-ins out of process. Returning from run()
+        # would exit that process and kill the socket thread. Stay alive and
+        # dispatch GLib.idle_add work (API calls) on this main loop.
+        # A visible window is required: otherwise "Start MCP Server" looks like
+        # it did not open anything.
+        try:
+            self._show_status_window(message)
+        except Exception as exc:
+            _log(f'Status window failed: {exc}\\n{traceback.format_exc()}')
+
+        _main_loop = GLib.MainLoop()
+        _log('Entering GLib.MainLoop to keep MCP server process alive')
+        try:
+            _main_loop.run()
+        except Exception as exc:
+            _log(f'MainLoop exited: {exc}')
+        return procedure.new_return_values(Gimp.PDBStatusType.SUCCESS, GLib.Error())
+
+    def _show_status_window(self, message):
+        gi.require_version('Gtk', '3.0')
+        gi.require_version('GimpUi', '3.0')
+        from gi.repository import Gtk
+        from gi.repository import GimpUi
+
+        GimpUi.init('gimp_mcp_server.py')
+        window = Gtk.Window(title='GIMP MCP Server')
+        window.set_default_size(420, 160)
+        window.set_keep_above(True)
+        box = Gtk.Box(orientation=Gtk.Orientation.VERTICAL, spacing=8)
+        box.set_border_width(16)
+        label = Gtk.Label(label=message + '\\n\\nLeave this window open while Grok talks to GIMP.')
+        label.set_line_wrap(True)
+        box.pack_start(label, True, True, 0)
+        button = Gtk.Button(label='Stop server')
+        button.connect('clicked', lambda *_: window.destroy())
+        box.pack_start(button, False, False, 0)
+        window.add(box)
+        window.connect('destroy', self._on_status_closed)
+        window.show_all()
+        window.present()
+        _log('Status window opened')
+
+    def _on_status_closed(self, *_args):
+        global _main_loop
+        _log('Status window closed; stopping MCP server')
+        if _main_loop is not None:
+            _main_loop.quit()
+
+    def ensure_server(self):
+        global _server_started
+        with _server_lock:
+            if _server_started:
+                return True, f'MCP Server already listening on {HOST}:{PORT}'
+            try:
+                thread = threading.Thread(target=self.start_server, daemon=True)
+                thread.start()
+                _server_started = True
+                return True, f'MCP Server started on {HOST}:{PORT}'
+            except Exception as exc:
+                return False, f'Failed to start MCP Server: {exc}'
+
+    def start_server(self):
+        sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
+        try:
+            sock.bind((HOST, PORT))
+            sock.listen(8)
+            _log(f'Server listening on {HOST}:{PORT}')
+        except Exception as exc:
+            _log(f'Bind/listen failed: {exc}')
+            return
+
+        while True:
+            try:
+                client, addr = sock.accept()
+                _log(f'Connected to {addr}')
+                threading.Thread(target=self.handle_client, args=(client,), daemon=True).start()
+            except Exception as exc:
+                _log(f'Server accept error: {exc}')
+                break
+        sock.close()
+
+    def handle_client(self, client):
+        buffer = b''
+        try:
+            client.settimeout(120)
+            while True:
+                chunk = client.recv(65536)
+                if not chunk:
+                    break
+                buffer += chunk
+                while buffer:
+                    try:
+                        command = json.loads(buffer.decode('utf-8'))
+                        buffer = b''
+                    except json.JSONDecodeError:
+                        break
+                    GLib.idle_add(self.execute_command, command, client)
+        except Exception as exc:
+            _log(f'Client error: {exc}')
+        finally:
+            try:
+                client.close()
+            except Exception:
+                pass
+
+    def execute_command(self, command, client):
+        cmd_type = command.get('type')
+        params = command.get('params', {}) or {}
+        try:
+            if cmd_type == 'ping':
+                response = {'status': 'success', 'result': 'pong'}
+            elif cmd_type == 'exec':
+                code = _extract_code(params.get('args', []), params.get('kwargs', {}))
+                if not code:
+                    code = str(params.get('code', ''))
+                response = {'status': 'success', 'result': _run_python(code)}
+            elif cmd_type == 'call_api':
+                api_path = params.get('api_path', '')
+                args = params.get('args', []) or []
+                kwargs = params.get('kwargs', {}) or {}
+                if api_path in ('exec', 'eval', '__exec__'):
+                    response = {'status': 'success', 'result': _run_python(_extract_code(args, kwargs))}
+                else:
+                    method = _resolve_api(api_path)
+                    result = method(*args, **kwargs)
+                    response = {'status': 'success', 'result': _serialize(result)}
+            else:
+                response = {'status': 'error', 'message': f'Unknown command: {cmd_type}'}
+        except Exception as exc:
+            response = {
+                'status': 'error',
+                'message': str(exc),
+                'traceback': traceback.format_exc(),
+            }
+            _log(f'Command error: {response["message"]}\\n{response["traceback"]}')
+
+        try:
+            payload = json.dumps(response).encode('utf-8')
+            client.sendall(payload)
+        except Exception as exc:
+            _log(f'Response send failed: {exc}')
+        return False
+
+
+Gimp.main(MCPPlugin.__gtype__, sys.argv)
+`;
+//# 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,4GAA4G;AAC5G,0DAA0D;AAC1D,8EAA8E;;;AAE9E,4EAA4E;AAC/D,QAAA,uBAAuB,GAAG,cAAc,CAAC;AAEtD,kGAAkG;AACrF,QAAA,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8WjC,CAAC"}

package/out/core/mcpCatalog.d.ts

@@ -20,22 +20,18 @@ export interface McpCatalogEntry {
     notes: string[];
 }
 /**
- * Legacy placeholder the OLD GIMP stub carried until the user pointed it at a
- * local checkout. No longer the default (see serverSpecFor/gimp below) — kept
- * ONLY so the migration can recognise + upgrade pre-git-based stubs.
+ * Display placeholder for the gimp client path BEFORE install (path unknown).
+ * `serverSpecFor('gimp', …)` with no resolved client path emits this so the
+ * catalog/detect JSON never bakes in a machine-specific path — and, crucially,
+ * never the broken raw-github upstream client. It also lets the migration
+ * recognise a not-yet-resolved gimp entry and upgrade it once GIMP is detected.
  */
-export declare const GIMP_CLIENT_PLACEHOLDER = "<GIMP_MCP_CLIENT_PY>";
+export declare const GIMP_CLIENT_PLACEHOLDER = "<GIMP config>/mcp/gimp_mcp_client.py";
 /**
- * The GIMP MCP client, run straight from git by `uv` — no manual clone. Pinned
- * to a specific upstream commit + `mcp==1.2.0` for reproducibility: `uv run`
- * fetches this raw script, installs the PINNED mcp SDK, and launches the FastMCP
- * stdio server (it lazily connects to GIMP on localhost:9876, so it starts even
- * without GIMP running). Verified end-to-end (valid MCP initialize handshake,
- * clean exit). `mcp==1.2.0` is load-bearing — current mcp releases break this
- * client on a removed `description=` kwarg.
+ * The pinned mcp SDK version the client runs under. Load-bearing — current mcp
+ * releases break the client on a removed `description=` kwarg. `uv run --with
+ * mcp==1.2.0 <client>` installs exactly this into an ephemeral env.
  */
-export declare const GIMP_MCP_COMMIT = "49c46dd6146cb7393b42a9ecda630583b3117b33";
-export declare const GIMP_MCP_CLIENT_URL = "https://raw.githubusercontent.com/libreearth/gimp-mcp/49c46dd6146cb7393b42a9ecda630583b3117b33/gimp_mcp_client.py";
 export declare const GIMP_MCP_PIN = "mcp==1.2.0";
 /** Per-platform install hint for the `uv`/`uvx` toolchain (never `pip install uv`). */
 export declare function uvInstallHint(platform: NodeJS.Platform): string;
@@ -60,14 +56,26 @@ export declare const BLENDER_LAB_FROM = "git+https://projects.blender.org/lab/bl
  *    from Blender Lab" add-on. NEVER bare `uvx blender-mcp` (no --from) — that
  *    pulls the incompatible community PyPI package. (The exact launcher form is
  *    under review; the args are the load-bearing part the migration re-resolves.)
- *  - GIMP: the git-based client run by bare `uv` (`uv run --with mcp==1.2.0
- *    <raw github url>`) on every platform — runnable now, so written ENABLED
- *    (no disabled stub). `opts.gimpClientPath` is an OPTIONAL override for users
- *    who cloned the repo locally → `python[3] <that path>`. Still experimental.
+ *  - GIMP: the LOCALLY-INSTALLED, user-verified client run by bare `uv`
+ *    (`uv run --with mcp==1.2.0 <clientPath>`) on every platform. `clientPath`
+ *    is the client installGimpPlugin() writes to <GIMP-config>/<ver>/mcp/. Pass
+ *    the resolved path via `opts.gimpClientPath`; without it we emit the display
+ *    placeholder (never the broken raw-github upstream client). Experimental.
  */
 export declare function serverSpecFor(app: CreativeAppId, platform: NodeJS.Platform, opts?: {
     gimpClientPath?: string;
 }): McpJsonEntry;
+/** The client-path argument carried by a gimp .mcp.json entry, whatever the command form. */
+export declare function gimpClientArgOf(entry: {
+    command?: string;
+    args?: string[];
+}): string | undefined;
+/**
+ * Is `arg` a CONCRETE local client path — a real filesystem path we must not
+ * clobber (a user's own checkout, or the client we already installed)? False for
+ * the display placeholder and for ANY URL (incl. the broken raw-github client).
+ */
+export declare function isConcreteGimpClientArg(arg: string | undefined): boolean;
 /** Build the catalog for a given platform (install hints are platform-specific). */
 export declare function getCatalog(platform: NodeJS.Platform): McpCatalogEntry[];
 /** Lookup a single catalog entry. */

package/out/core/mcpCatalog.js

@@ -10,32 +10,29 @@
 // flagged experimental because upstream ships no packaged launcher — see below.
 // ---------------------------------------------------------------------------
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BLENDER_LAB_FROM = exports.GIMP_MCP_PIN = exports.GIMP_MCP_CLIENT_URL = exports.GIMP_MCP_COMMIT = exports.GIMP_CLIENT_PLACEHOLDER = void 0;
+exports.BLENDER_LAB_FROM = exports.GIMP_MCP_PIN = exports.GIMP_CLIENT_PLACEHOLDER = void 0;
 exports.uvInstallHint = uvInstallHint;
 exports.pythonInstallHint = pythonInstallHint;
 exports.gitInstallHint = gitInstallHint;
 exports.serverSpecFor = serverSpecFor;
+exports.gimpClientArgOf = gimpClientArgOf;
+exports.isConcreteGimpClientArg = isConcreteGimpClientArg;
 exports.getCatalog = getCatalog;
 exports.catalogEntry = catalogEntry;
 /**
- * Legacy placeholder the OLD GIMP stub carried until the user pointed it at a
- * local checkout. No longer the default (see serverSpecFor/gimp below) — kept
- * ONLY so the migration can recognise + upgrade pre-git-based stubs.
+ * Display placeholder for the gimp client path BEFORE install (path unknown).
+ * `serverSpecFor('gimp', …)` with no resolved client path emits this so the
+ * catalog/detect JSON never bakes in a machine-specific path — and, crucially,
+ * never the broken raw-github upstream client. It also lets the migration
+ * recognise a not-yet-resolved gimp entry and upgrade it once GIMP is detected.
  */
-exports.GIMP_CLIENT_PLACEHOLDER = '<GIMP_MCP_CLIENT_PY>';
+exports.GIMP_CLIENT_PLACEHOLDER = '<GIMP config>/mcp/gimp_mcp_client.py';
 /**
- * The GIMP MCP client, run straight from git by `uv` — no manual clone. Pinned
- * to a specific upstream commit + `mcp==1.2.0` for reproducibility: `uv run`
- * fetches this raw script, installs the PINNED mcp SDK, and launches the FastMCP
- * stdio server (it lazily connects to GIMP on localhost:9876, so it starts even
- * without GIMP running). Verified end-to-end (valid MCP initialize handshake,
- * clean exit). `mcp==1.2.0` is load-bearing — current mcp releases break this
- * client on a removed `description=` kwarg.
+ * The pinned mcp SDK version the client runs under. Load-bearing — current mcp
+ * releases break the client on a removed `description=` kwarg. `uv run --with
+ * mcp==1.2.0 <client>` installs exactly this into an ephemeral env.
  */
-exports.GIMP_MCP_COMMIT = '49c46dd6146cb7393b42a9ecda630583b3117b33';
-exports.GIMP_MCP_CLIENT_URL = `https://raw.githubusercontent.com/libreearth/gimp-mcp/${exports.GIMP_MCP_COMMIT}/gimp_mcp_client.py`;
 exports.GIMP_MCP_PIN = 'mcp==1.2.0';
-const GIMP_GIT_ARGS = ['run', '--with', exports.GIMP_MCP_PIN, exports.GIMP_MCP_CLIENT_URL];
 /** Per-platform install hint for the `uv`/`uvx` toolchain (never `pip install uv`). */
 function uvInstallHint(platform) {
     if (platform === 'win32') {
@@ -84,10 +81,11 @@ const BLENDER_LAB_ARGS = ['--from', exports.BLENDER_LAB_FROM, '--with', 'mcp<2',
  *    from Blender Lab" add-on. NEVER bare `uvx blender-mcp` (no --from) — that
  *    pulls the incompatible community PyPI package. (The exact launcher form is
  *    under review; the args are the load-bearing part the migration re-resolves.)
- *  - GIMP: the git-based client run by bare `uv` (`uv run --with mcp==1.2.0
- *    <raw github url>`) on every platform — runnable now, so written ENABLED
- *    (no disabled stub). `opts.gimpClientPath` is an OPTIONAL override for users
- *    who cloned the repo locally → `python[3] <that path>`. Still experimental.
+ *  - GIMP: the LOCALLY-INSTALLED, user-verified client run by bare `uv`
+ *    (`uv run --with mcp==1.2.0 <clientPath>`) on every platform. `clientPath`
+ *    is the client installGimpPlugin() writes to <GIMP-config>/<ver>/mcp/. Pass
+ *    the resolved path via `opts.gimpClientPath`; without it we emit the display
+ *    placeholder (never the broken raw-github upstream client). Experimental.
  */
 function serverSpecFor(app, platform, opts) {
     if (app === 'blender') {
@@ -95,15 +93,41 @@ function serverSpecFor(app, platform, opts) {
         // official Blender Lab `--from git+…lab…` client.
         return { command: 'uvx', args: [...BLENDER_LAB_ARGS] };
     }
-    // gimp — OPTIONAL local override: a user who cloned the repo points us at their
-    // gimp_mcp_client.py and we run it via python (enabled — it's a real path).
-    const local = opts?.gimpClientPath && opts.gimpClientPath.trim();
-    if (local && local !== exports.GIMP_CLIENT_PLACEHOLDER) {
-        return { command: platform === 'win32' ? 'python' : 'python3', args: [local] };
+    // gimp — run the locally-installed client via `uv` with the pinned mcp SDK.
+    // Same command shape on every platform; only the client path differs.
+    const client = (opts?.gimpClientPath && opts.gimpClientPath.trim()) || exports.GIMP_CLIENT_PLACEHOLDER;
+    return { command: 'uv', args: ['run', '--with', exports.GIMP_MCP_PIN, client] };
+}
+/** The client-path argument carried by a gimp .mcp.json entry, whatever the command form. */
+function gimpClientArgOf(entry) {
+    const args = Array.isArray(entry.args) ? entry.args : [];
+    if (entry.command === 'python' || entry.command === 'python3') {
+        return args[0];
+    }
+    if (entry.command === 'uv') {
+        return args[args.length - 1];
+    }
+    return undefined;
+}
+/**
+ * Is `arg` a CONCRETE local client path — a real filesystem path we must not
+ * clobber (a user's own checkout, or the client we already installed)? False for
+ * the display placeholder and for ANY URL (incl. the broken raw-github client).
+ */
+function isConcreteGimpClientArg(arg) {
+    if (typeof arg !== 'string' || arg.length === 0) {
+        return false;
     }
-    // Default: the git-based client, fetched + launched by `uv run`. Same on every
-    // platform. Enabled by default — it launches even without GIMP present.
-    return { command: 'uv', args: [...GIMP_GIT_ARGS] };
+    if (arg === exports.GIMP_CLIENT_PLACEHOLDER) {
+        return false;
+    }
+    if (/^https?:\/\//i.test(arg)) {
+        return false;
+    }
+    if (/raw\.githubusercontent\.com/i.test(arg)) {
+        return false;
+    }
+    return true;
 }
 /** Build the catalog for a given platform (install hints are platform-specific). */
 function getCatalog(platform) {
@@ -135,25 +159,33 @@ function getCatalog(platform) {
             serverName: 'gimp',
             prerequisites: [{ id: 'uv', installHint: uvInstallHint(platform) }],
             postSetup: [
-                'The MCP client runs from git automatically (uv fetches it) — no manual download of the client.',
-                `The GIMP-side AUTO-START plugin is installed for you into your GIMP 3.x plug-ins folder (${gimpPluginDir(platform)}) — just restart GIMP and the server auto-starts on localhost:9876 (no menu click). Re-run any time with: autodev mcp gimp-install-plugin`,
-                'Requires GIMP 3.0+ (the plugin uses the GIMP 3.0 API).',
+                `Plugin + client are installed automatically into your GIMP 3.x config (${gimpPluginDir(platform)}) — you copy nothing. Re-run any time with: autodev mcp gimp-install-plugin`,
+                "In GIMP: Tools → MCP → Start MCP Server (or Filters → Development → Start MCP Server), and KEEP the 'GIMP MCP Server' window open — it holds the plug-in process alive and the :9876 socket. One click per GIMP session (the window may hide behind other apps; use the taskbar).",
+                'Requires GIMP 3.x (the plugin uses the GIMP 3.0 Python API).',
                 "Port 9876 collides with Blender — don't run both MCP servers at once.",
             ],
             notes: [
-                'Experimental prototype: upstream is a prototype and its README contradicts its own code — expect rough edges.',
-                `The client is pinned to a specific commit (${exports.GIMP_MCP_COMMIT.slice(0, 7)}…) and ${exports.GIMP_MCP_PIN} for reproducibility (current mcp releases break the client on a removed description= kwarg).`,
+                `Log: ${gimpLogPath(platform)} (Store/MSIX GIMP also mirrors a copy inside its sandbox LocalCache).`,
+                `The client runs via \`uv run --with ${exports.GIMP_MCP_PIN} <installed client>\`; the ${exports.GIMP_MCP_PIN} pin is load-bearing (current mcp releases break the client on a removed description= kwarg).`,
             ],
         },
     ];
 }
-/** GIMP 3.0 plug-ins directory, per OS (where the server-side plugin lives). */
+/** GIMP 3.x config directory, per OS (where plug-ins/ and mcp/ get installed). */
 function gimpPluginDir(platform) {
     return platform === 'win32'
-        ? '%APPDATA%\\GIMP\\3.x\\plug-ins\\'
+        ? '%APPDATA%\\GIMP\\3.x\\'
+        : platform === 'darwin'
+            ? '~/Library/Application Support/GIMP/3.x/'
+            : '~/.config/GIMP/3.x/';
+}
+/** GIMP MCP server log path, per OS (dual-written by the plug-in). */
+function gimpLogPath(platform) {
+    return platform === 'win32'
+        ? '%APPDATA%\\GIMP\\3.x\\gimp_mcp_server.log'
         : platform === 'darwin'
-            ? '~/Library/Application Support/GIMP/3.x/plug-ins/'
-            : '~/.config/GIMP/3.x/plug-ins/';
+            ? '~/Library/Application Support/GIMP/3.x/gimp_mcp_server.log'
+            : '~/.config/GIMP/3.x/gimp_mcp_server.log';
 }
 /** Lookup a single catalog entry. */
 function catalogEntry(app, platform) {

package/out/core/mcpCatalog.js.map

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

package/out/core/mcpCatalogMigrate.d.ts

@@ -1,6 +1,14 @@
+export interface MigrateOpts {
+    /**
+     * Resolve the local gimp client path for this machine, or null when GIMP 3.x is
+     * absent. Defaults to resolveGimpClientPath() (real detection). Injectable for
+     * tests. When null, a gimp entry that needs upgrading is left as-is.
+     */
+    resolveGimpClient?: () => string | null;
+}
 /**
  * Re-resolve stale creative-app user entries in <root>/.mcp.json from the current
  * catalog. Persists the upgraded set back to .mcp.json when anything changed and
  * logs each upgrade. Returns true iff at least one entry was migrated.
  */
-export declare function migrateCreativeMcpEntries(root: string, platform: NodeJS.Platform, log?: (m: string) => void): boolean;
+export declare function migrateCreativeMcpEntries(root: string, platform: NodeJS.Platform, log?: (m: string) => void, opts?: MigrateOpts): boolean;