autodev-cli 1.4.148 → 1.4.150

package/out/core/gimpPluginInstall.js

@@ -0,0 +1,224 @@
+"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;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const binDetect_1 = require("./binDetect");
+/** 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); },
+        readPluginSource: () => fs.readFileSync(vendoredPluginSourcePath(), 'utf8'),
+        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 vendored plugin into one plug-ins dir (backing up any existing copy). */
+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)) {
+        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 };
+}
+//# 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/mcpCatalog.d.ts

@@ -19,8 +19,24 @@ export interface McpCatalogEntry {
     /** Caveats worth surfacing (port clashes, upstream bugs). */
     notes: string[];
 }
-/** Placeholder the GIMP stub carries until the user points it at their checkout. */
+/**
+ * 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.
+ */
 export declare const GIMP_CLIENT_PLACEHOLDER = "<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.
+ */
+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;
 /** Per-platform install hint for Python 3. */
@@ -44,9 +60,10 @@ 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: a best-effort stdio stub `python <client.py>`, written enabled:false
- *    unless the caller supplies a real client path — GIMP ships no launcher, so
- *    we never pretend it's one-click.
+ *  - 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.
  */
 export declare function serverSpecFor(app: CreativeAppId, platform: NodeJS.Platform, opts?: {
     gimpClientPath?: string;

package/out/core/mcpCatalog.js

@@ -10,15 +10,32 @@
 // flagged experimental because upstream ships no packaged launcher — see below.
 // ---------------------------------------------------------------------------
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BLENDER_LAB_FROM = exports.GIMP_CLIENT_PLACEHOLDER = void 0;
+exports.BLENDER_LAB_FROM = exports.GIMP_MCP_PIN = exports.GIMP_MCP_CLIENT_URL = exports.GIMP_MCP_COMMIT = exports.GIMP_CLIENT_PLACEHOLDER = void 0;
 exports.uvInstallHint = uvInstallHint;
 exports.pythonInstallHint = pythonInstallHint;
 exports.gitInstallHint = gitInstallHint;
 exports.serverSpecFor = serverSpecFor;
 exports.getCatalog = getCatalog;
 exports.catalogEntry = catalogEntry;
-/** Placeholder the GIMP stub carries until the user points it at their checkout. */
+/**
+ * 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.
+ */
 exports.GIMP_CLIENT_PLACEHOLDER = '<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.
+ */
+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') {
@@ -67,9 +84,10 @@ 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: a best-effort stdio stub `python <client.py>`, written enabled:false
- *    unless the caller supplies a real client path — GIMP ships no launcher, so
- *    we never pretend it's one-click.
+ *  - 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.
  */
 function serverSpecFor(app, platform, opts) {
     if (app === 'blender') {
@@ -77,16 +95,15 @@ function serverSpecFor(app, platform, opts) {
         // official Blender Lab `--from git+…lab…` client.
         return { command: 'uvx', args: [...BLENDER_LAB_ARGS] };
     }
-    // gimp — experimental stub.
-    const client = (opts?.gimpClientPath && opts.gimpClientPath.trim()) || exports.GIMP_CLIENT_PLACEHOLDER;
-    const isStub = client === exports.GIMP_CLIENT_PLACEHOLDER;
-    return {
-        command: platform === 'win32' ? 'python' : 'python3',
-        args: [client],
-        // A stub (no real client path) is written disabled so it is preserved for the
-        // user to complete without being spawned as a broken server.
-        ...(isStub ? { enabled: false } : {}),
-    };
+    // 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] };
+    }
+    // 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] };
 }
 /** Build the catalog for a given platform (install hints are platform-specific). */
 function getCatalog(platform) {
@@ -116,29 +133,27 @@ function getCatalog(platform) {
             name: 'GIMP',
             experimental: true,
             serverName: 'gimp',
-            prerequisites: [{ id: 'python', installHint: pythonInstallHint(platform) }],
+            prerequisites: [{ id: 'uv', installHint: uvInstallHint(platform) }],
             postSetup: [
-                'Clone https://github.com/libreearth/gimp-mcp and point the server at its gimp_mcp_client.py',
-                '`pip install mcp` (the client needs the MCP Python SDK)',
-                gimpPluginStep(platform),
-                'In GIMP 3.0: Filters → Development → Start MCP Server (socket on :9876)',
-                'Re-run `autodev mcp detect --enable gimp --gimp-client <path-to-gimp_mcp_client.py>` once you have the client',
+                '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).',
+                "Port 9876 collides with Blender — don't run both MCP servers at once.",
             ],
             notes: [
-                'Experimental prototype: upstream ships NO packaged launcher and the README contradicts its own code — expect manual wiring.',
-                'Port 9876 collides with Blender — do not run both MCP servers at once.',
+                '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).`,
             ],
         },
     ];
 }
-/** GIMP 3.0 plug-ins directory step, per OS. */
-function gimpPluginStep(platform) {
-    const dir = platform === 'win32'
-        ? '%APPDATA%\\GIMP\\3.0\\plug-ins\\'
+/** GIMP 3.0 plug-ins directory, per OS (where the server-side plugin lives). */
+function gimpPluginDir(platform) {
+    return platform === 'win32'
+        ? '%APPDATA%\\GIMP\\3.x\\plug-ins\\'
         : platform === 'darwin'
-            ? '~/Library/Application Support/GIMP/3.0/plug-ins/'
-            : '~/.config/GIMP/3.0/plug-ins/';
-    return `Copy gimp_mcp_server.py into the GIMP 3.0 plug-ins dir (${dir}) and make it executable`;
+            ? '~/Library/Application Support/GIMP/3.x/plug-ins/'
+            : '~/.config/GIMP/3.x/plug-ins/';
 }
 /** 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.js

@@ -12,9 +12,11 @@
 // It is deliberately narrow:
 //   - blender : ALWAYS re-resolved if command/args drift from the catalog spec
 //               (Blender has no user-customizable fields, so replacing is safe).
-//   - gimp    : re-resolved ONLY while the entry is still a STUB (args still carry
-//               the <GIMP_MCP_CLIENT_PY> placeholder). If the user pointed it at a
-//               real client path, we never clobber it.
+//   - gimp    : re-resolved to the git-based `uv run …` spec if the stored entry
+//               drifts from the current catalog (covers the OLD <GIMP_MCP_CLIENT_PY>
+//               placeholder stub AND any earlier command). The ONE thing we never
+//               clobber is a user's LOCAL checkout: a python/python3 entry pointing
+//               at a concrete (non-placeholder) client path is preserved.
 // `enabled`, `env`, and `_meta` are preserved; the match is name-based so entries
 // written before any `_meta.catalogId` tag existed still migrate. Non-creative
 // entries (built-ins, filesystem's <ALLOWED_DIR>, custom user servers) are never
@@ -37,9 +39,18 @@ function _argsEqual(a, b) {
     }
     return true;
 }
-/** A gimp entry is still a STUB (never completed by the user) if its args carry the placeholder. */
-function _isGimpStub(e) {
-    return Array.isArray(e.args) && e.args.some((a) => a === mcpCatalog_1.GIMP_CLIENT_PLACEHOLDER);
+/**
+ * A gimp entry the migration must PRESERVE: a user's local checkout, i.e. a
+ * python/python3 command pointing at a concrete (non-placeholder) client path.
+ * Everything else (the old <GIMP_MCP_CLIENT_PY> placeholder stub, or any earlier
+ * command form) is upgradeable to the current git-based catalog spec.
+ */
+function _isGimpLocalPython(e) {
+    if (e.command !== 'python' && e.command !== 'python3') {
+        return false;
+    }
+    const first = Array.isArray(e.args) ? e.args[0] : undefined;
+    return typeof first === 'string' && first.length > 0 && first !== mcpCatalog_1.GIMP_CLIENT_PLACEHOLDER;
 }
 /**
  * Re-resolve stale creative-app user entries in <root>/.mcp.json from the current
@@ -63,8 +74,9 @@ function migrateCreativeMcpEntries(root, platform, log) {
         // under this name is not ours to touch.
         if (typeof entry.command !== 'string')
             continue;
-        // GIMP: never clobber a real client path — migrate only while still a stub.
-        if (id === 'gimp' && !_isGimpStub(entry))
+        // GIMP: never clobber a user's local checkout (python[3] + real client path);
+        // everything else (old placeholder stub / earlier command) upgrades below.
+        if (id === 'gimp' && _isGimpLocalPython(entry))
             continue;
         const spec = (0, mcpCatalog_1.serverSpecFor)(id, platform);
         // Idempotent — already the catalog spec, nothing to do.
@@ -79,7 +91,7 @@ function migrateCreativeMcpEntries(root, platform, log) {
         changed = true;
         log?.(id === 'blender'
             ? 'ConfigManager: migrated blender MCP server to the Blender Lab client'
-            : 'ConfigManager: migrated gimp MCP server stub to the current catalog spec');
+            : 'ConfigManager: migrated gimp MCP server to the git-based uv run client');
     }
     if (changed) {
         try {

package/out/core/mcpCatalogMigrate.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autodev-cli",
-  "version": "1.4.148",
+  "version": "1.4.150",
   "description": "AutoAIDev CLI — autonomous AI task loop with VS Code / Cursor launcher",
   "author": "Peter Ivanov <peter@microweber.com>",
   "license": "MIT",
@@ -33,7 +33,7 @@
     "start": "node bin/autodev.js",
     "test:coverage": "c8 npm test",
     "coverage:html": "c8 --reporter=html npm test",
-    "test": "node test/smoke.mjs && node test/liveNarration.smoke.mjs && node test/liveNarration.edge.smoke.mjs && node test/normalizer.parity.smoke.mjs && node test/providerConfig.smoke.mjs && node test/providers.services.smoke.mjs && node test/providers.dummy.smoke.mjs && node test/mcpOnlyOperator.smoke.mjs && node test/opencodeEventFilter.smoke.mjs && node test/copilotMcpIsolation.smoke.mjs && node test/grokSpawnError.smoke.mjs && node test/initTemplate.smoke.mjs && node test/settingsAliases.smoke.mjs && node test/setupWritesOfficeMcp.smoke.mjs && node test/provisionNoGlobalMcp.smoke.mjs && node test/deprovisionCleans.smoke.mjs && node test/hooksElectronSafe.smoke.mjs && node test/claudePermissions.smoke.mjs && node test/claudeMcpAllowList.smoke.mjs && node test/presenceGuard.smoke.mjs && node test/cliExitHardFail.smoke.mjs && node test/redactSecrets.smoke.mjs && node test/claudeUsage.smoke.mjs && node test/graphStore.smoke.mjs && node test/programReminder.smoke.mjs && node test/agentBackup.smoke.mjs && node test/persona.smoke.mjs && node test/soulUpdate.smoke.mjs && node test/sessionsGlobal.smoke.mjs && node test/resumeSessionLoopDefault.smoke.mjs && node test/secureFilePerms.smoke.mjs && node test/providers.dummy.office.smoke.mjs && node test/mcpDetect.smoke.mjs && node test/mcpCatalog.smoke.mjs && node test/mcpCatalogMigrate.smoke.mjs && node test/mcpStartupTimeout.smoke.mjs"
+    "test": "node test/smoke.mjs && node test/liveNarration.smoke.mjs && node test/liveNarration.edge.smoke.mjs && node test/normalizer.parity.smoke.mjs && node test/providerConfig.smoke.mjs && node test/providers.services.smoke.mjs && node test/providers.dummy.smoke.mjs && node test/mcpOnlyOperator.smoke.mjs && node test/opencodeEventFilter.smoke.mjs && node test/copilotMcpIsolation.smoke.mjs && node test/grokSpawnError.smoke.mjs && node test/initTemplate.smoke.mjs && node test/settingsAliases.smoke.mjs && node test/setupWritesOfficeMcp.smoke.mjs && node test/provisionNoGlobalMcp.smoke.mjs && node test/deprovisionCleans.smoke.mjs && node test/hooksElectronSafe.smoke.mjs && node test/claudePermissions.smoke.mjs && node test/claudeMcpAllowList.smoke.mjs && node test/presenceGuard.smoke.mjs && node test/cliExitHardFail.smoke.mjs && node test/redactSecrets.smoke.mjs && node test/claudeUsage.smoke.mjs && node test/graphStore.smoke.mjs && node test/programReminder.smoke.mjs && node test/agentBackup.smoke.mjs && node test/persona.smoke.mjs && node test/soulUpdate.smoke.mjs && node test/sessionsGlobal.smoke.mjs && node test/resumeSessionLoopDefault.smoke.mjs && node test/secureFilePerms.smoke.mjs && node test/providers.dummy.office.smoke.mjs && node test/mcpDetect.smoke.mjs && node test/gimpPluginInstall.smoke.mjs && node test/mcpCatalog.smoke.mjs && node test/mcpCatalogMigrate.smoke.mjs && node test/mcpStartupTimeout.smoke.mjs"
   },
   "dependencies": {
     "@opencode-ai/sdk": "^1.14.41",