autodev-cli 1.4.139 → 1.4.140

package/out/cli.js

@@ -51,6 +51,7 @@ const office_1 = require("./commands/office");
 const deprovision_1 = require("./commands/deprovision");
 const login_1 = require("./commands/login");
 const models_1 = require("./commands/models");
+const mcp_1 = require("./commands/mcp");
 const connect_2 = require("./connect");
 const logger_1 = require("./logger");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
@@ -130,6 +131,7 @@ const program = new commander_1.Command()
 (0, deprovision_1.deprovisionCommand)(program);
 (0, login_1.loginCommand)(program);
 (0, models_1.modelsCommand)(program);
+(0, mcp_1.mcpCommand)(program);
 program.parseAsync(process.argv).catch((err) => {
     console.error(err.message);
     process.exit(1);

package/out/cli.js.map

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

package/out/commands/mcp.d.ts

@@ -0,0 +1,28 @@
+import { Command } from 'commander';
+import { type McpJsonEntry } from '../core/projectMcp';
+import { type BinDetectDeps } from '../core/binDetect';
+import { type CreativeAppId } from '../core/mcpCatalog';
+export interface DetectPrereq {
+    id: string;
+    installed: boolean;
+    installHint: string;
+}
+export interface DetectApp {
+    id: CreativeAppId;
+    name: string;
+    installed: boolean;
+    path: string | null;
+    source: string | null;
+    experimental: boolean;
+    server: McpJsonEntry;
+    serverName: string;
+    prerequisites: DetectPrereq[];
+    postSetup: string[];
+    notes: string[];
+    alreadyEnabled: boolean;
+}
+export interface DetectResult {
+    apps: DetectApp[];
+}
+export declare function buildDetect(root: string, deps?: Partial<BinDetectDeps>): DetectResult;
+export declare function mcpCommand(program: Command): void;

package/out/commands/mcp.js

@@ -0,0 +1,380 @@
+"use strict";
+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.buildDetect = buildDetect;
+exports.mcpCommand = mcpCommand;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logger_1 = require("../logger");
+const projectMcp_1 = require("../core/projectMcp");
+const configManager_1 = require("../configManager");
+const mcpManager_1 = require("../mcpManager");
+const binDetect_1 = require("../core/binDetect");
+const mcpCatalog_1 = require("../core/mcpCatalog");
+const settingsLoader_1 = require("../core/settingsLoader");
+const secureFile_1 = require("../core/secureFile");
+// Names autodev treats as built-in MCP servers (toggled via disabledBuiltinMcp,
+// not via an enabled:false entry in .mcp.json).
+const BUILTIN_NAMES = new Set([
+    ...mcpManager_1.DEFAULT_MCP_SERVERS.map((s) => s.name), 'memory', 'pixel-office',
+]);
+function resolveRoot(p) {
+    return p ? path.resolve(p) : process.cwd();
+}
+/** Commander collector for repeatable single-value options (append into an array). */
+function collect(val, acc) {
+    acc.push(val);
+    return acc;
+}
+function sync(root) {
+    configManager_1.ConfigManager.syncProjectMcpServers(root, (m) => logger_1.log.gray(m));
+}
+function saveSettings(root, settings) {
+    const file = (0, settingsLoader_1.settingsWritePath)(root);
+    const dir = path.dirname(file);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    (0, secureFile_1.writeFileSecure)(file, JSON.stringify(settings, null, 2) + '\n');
+}
+/** Parse repeated K=V option values into an object (ignores malformed pairs). */
+function parseKvPairs(pairs) {
+    if (!pairs || pairs.length === 0) {
+        return undefined;
+    }
+    const out = {};
+    for (const p of pairs) {
+        const i = p.indexOf('=');
+        if (i <= 0) {
+            logger_1.log.warn(`Ignoring malformed pair "${p}" (expected KEY=VALUE)`);
+            continue;
+        }
+        out[p.slice(0, i)] = p.slice(i + 1);
+    }
+    return Object.keys(out).length ? out : undefined;
+}
+function isBuiltinName(root, name) {
+    if (BUILTIN_NAMES.has(name)) {
+        return true;
+    }
+    const all = (0, projectMcp_1.loadProjectAllMcp)(root);
+    return all[name]?._meta?.kind === 'builtin';
+}
+function transportOf(e) {
+    if ((0, projectMcp_1.isRemoteMcp)(e)) {
+        return e.type === 'sse' ? 'sse' : 'http';
+    }
+    return 'stdio';
+}
+/** Is a prerequisite launcher present on PATH? (uvx / python[3]). */
+function prereqInstalled(id, deps) {
+    if (id === 'python') {
+        return !!((0, binDetect_1.detectBinOnPath)('python3', deps) || (0, binDetect_1.detectBinOnPath)('python', deps));
+    }
+    return !!(0, binDetect_1.detectBinOnPath)(id, deps);
+}
+function buildDetect(root, deps) {
+    const platform = deps?.platform ?? process.platform;
+    const existing = (0, projectMcp_1.loadProjectAllMcp)(root);
+    const apps = (0, mcpCatalog_1.getCatalog)(platform).map((entry) => {
+        const det = (0, binDetect_1.detectApp)(entry.id, deps);
+        const server = (0, mcpCatalog_1.serverSpecFor)(entry.id, platform);
+        const prerequisites = entry.prerequisites.map((pr) => ({
+            id: pr.id,
+            installed: prereqInstalled(pr.id, deps),
+            installHint: pr.installHint,
+        }));
+        return {
+            id: entry.id,
+            name: entry.name,
+            installed: det.installed,
+            path: det.path,
+            source: det.source,
+            experimental: entry.experimental,
+            server,
+            serverName: entry.serverName,
+            prerequisites,
+            postSetup: entry.postSetup,
+            notes: entry.notes,
+            alreadyEnabled: !!existing[entry.serverName],
+        };
+    });
+    return { apps };
+}
+// ---------------------------------------------------------------------------
+// --enable <app> — write the server spec + propagate + print manual steps.
+// ---------------------------------------------------------------------------
+function enableApp(root, app, opts) {
+    const platform = process.platform;
+    const entry = (0, mcpCatalog_1.catalogEntry)(app, platform);
+    const det = (0, binDetect_1.detectApp)(app);
+    if (app === 'blender') {
+        if (!det.installed) {
+            logger_1.log.error('Blender was not detected on this machine. Install Blender first, then re-run.');
+            logger_1.log.gray('  (checked PATH + Program Files / Applications / flatpak / snap)');
+            return 1;
+        }
+        const server = (0, mcpCatalog_1.serverSpecFor)('blender', platform);
+        const user = (0, projectMcp_1.loadProjectUserMcp)(root);
+        user[entry.serverName] = server;
+        (0, projectMcp_1.saveProjectUserMcp)(root, user);
+        sync(root);
+        logger_1.log.success(`Configured Blender MCP server "${entry.serverName}" (${det.path}).`);
+        const uvx = prereqInstalled('uvx');
+        if (!uvx) {
+            logger_1.log.warn('⚠  `uvx` is NOT on PATH — the server is written but will not start until you install uv:');
+            logger_1.log.plain(`    ${entry.prerequisites[0].installHint}`);
+        }
+        logger_1.log.section('Next steps');
+        for (const s of entry.postSetup) {
+            logger_1.log.plain(`  • ${s}`);
+        }
+        return 0;
+    }
+    // gimp — experimental.
+    logger_1.log.warn('⚠  GIMP MCP is EXPERIMENTAL — upstream ships no packaged launcher; expect manual wiring.');
+    const gimpClient = (opts.gimpClient && opts.gimpClient.trim()) || undefined;
+    const server = (0, mcpCatalog_1.serverSpecFor)('gimp', platform, { gimpClientPath: gimpClient });
+    const user = (0, projectMcp_1.loadProjectUserMcp)(root);
+    user[entry.serverName] = server;
+    (0, projectMcp_1.saveProjectUserMcp)(root, user);
+    sync(root);
+    if (gimpClient) {
+        logger_1.log.success(`Configured GIMP MCP client "${entry.serverName}" → ${gimpClient}`);
+    }
+    else {
+        logger_1.log.warn(`Wrote a DISABLED stub "${entry.serverName}" (args: ${mcpCatalog_1.GIMP_CLIENT_PLACEHOLDER}). Provide --gimp-client <path> to complete it.`);
+    }
+    if (!prereqInstalled('python')) {
+        logger_1.log.warn('⚠  No python/python3 on PATH:');
+        logger_1.log.plain(`    ${entry.prerequisites[0].installHint}`);
+    }
+    logger_1.log.section('Manual steps');
+    for (const s of entry.postSetup) {
+        logger_1.log.plain(`  • ${s}`);
+    }
+    for (const n of entry.notes) {
+        logger_1.log.gray(`  ! ${n}`);
+    }
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// Command wiring
+// ---------------------------------------------------------------------------
+function mcpCommand(program) {
+    const cmd = program
+        .command('mcp')
+        .description('Manage this workspace\'s MCP servers (.mcp.json) and detect creative apps');
+    // autodev mcp list [path] [--json]
+    cmd
+        .command('list [path]')
+        .description('List MCP servers configured for this workspace')
+        .option('--json', 'Output the raw entries array as JSON')
+        .action((p, opts) => {
+        const root = resolveRoot(p);
+        const all = (0, projectMcp_1.loadProjectAllMcp)(root);
+        if (opts.json) {
+            const arr = Object.entries(all).map(([name, e]) => ({ name, ...e }));
+            process.stdout.write(JSON.stringify(arr, null, 2) + '\n');
+            return;
+        }
+        logger_1.log.section('🔌  MCP servers');
+        const names = Object.keys(all);
+        if (names.length === 0) {
+            logger_1.log.gray('  (none configured)');
+            return;
+        }
+        for (const name of names) {
+            const e = all[name];
+            const kind = e._meta?.kind === 'builtin' ? 'builtin' : 'user';
+            const enabled = e.enabled === false ? 'disabled' : 'enabled';
+            const detail = (0, projectMcp_1.isRemoteMcp)(e) ? e.url : [e.command, ...(e.args ?? [])].join(' ');
+            logger_1.log.plain(`  ${name.padEnd(20)} ${kind.padEnd(8)} ${enabled.padEnd(9)} ${transportOf(e).padEnd(6)} ${detail}`);
+        }
+    });
+    // autodev mcp add <name> [options] [path]
+    cmd
+        .command('add <name> [path]')
+        .description('Add a user MCP server (stdio via --command, or remote via --url)')
+        .option('--command <c>', 'stdio launcher (e.g. uvx, npx, python)')
+        .option('--arg <a>', 'stdio argument (repeatable; use --arg=-y for dash-prefixed values)', collect, [])
+        .option('--env <kv>', 'stdio env var KEY=VALUE (repeatable)', collect, [])
+        .option('--url <u>', 'remote MCP endpoint URL (http/sse)')
+        .option('--header <kv>', 'remote header KEY=VALUE (repeatable)', collect, [])
+        .option('--sse', 'remote transport is SSE (default http)')
+        .action((name, p, opts) => {
+        const root = resolveRoot(p);
+        if (opts.command && opts.url) {
+            logger_1.log.error('Provide EITHER --command (stdio) OR --url (remote), not both.');
+            process.exit(1);
+        }
+        if (!opts.command && !opts.url) {
+            logger_1.log.error('Provide --command <c> for a stdio server or --url <u> for a remote server.');
+            process.exit(1);
+        }
+        let entry;
+        if (opts.url) {
+            entry = {
+                type: opts.sse ? 'sse' : 'http',
+                url: opts.url,
+                ...(parseKvPairs(opts.header) ? { headers: parseKvPairs(opts.header) } : {}),
+            };
+        }
+        else {
+            entry = {
+                command: opts.command,
+                args: opts.arg ?? [],
+                ...(parseKvPairs(opts.env) ? { env: parseKvPairs(opts.env) } : {}),
+            };
+        }
+        const user = (0, projectMcp_1.loadProjectUserMcp)(root);
+        user[name] = entry;
+        (0, projectMcp_1.saveProjectUserMcp)(root, user);
+        sync(root);
+        logger_1.log.success(`Added MCP server "${name}" and propagated to all providers.`);
+    });
+    // autodev mcp remove <name> [path]
+    cmd
+        .command('remove <name> [path]')
+        .alias('rm')
+        .description('Remove a user MCP server')
+        .action((name, p) => {
+        const root = resolveRoot(p);
+        const removed = (0, projectMcp_1.removeProjectUserMcp)(root, name);
+        if (!removed) {
+            logger_1.log.error(`No user MCP server named "${name}" (built-ins are managed via enable/disable).`);
+            process.exit(1);
+        }
+        sync(root);
+        logger_1.log.success(`Removed MCP server "${name}".`);
+    });
+    // autodev mcp enable <name> [path]
+    cmd
+        .command('enable <name> [path]')
+        .description('Enable an MCP server (user entry or built-in)')
+        .action((name, p) => {
+        const root = resolveRoot(p);
+        setEnabled(root, name, true);
+    });
+    // autodev mcp disable <name> [path]
+    cmd
+        .command('disable <name> [path]')
+        .description('Disable an MCP server (kept in config; not synced to providers)')
+        .action((name, p) => {
+        const root = resolveRoot(p);
+        setEnabled(root, name, false);
+    });
+    // autodev mcp detect [path] [--json] [--enable <app>] [--gimp-client <path>]
+    cmd
+        .command('detect [path]')
+        .description('Detect installed creative apps (Blender / GIMP) and optionally enable their MCP server')
+        .option('--json', 'Output the stable detection JSON (consumed by the app + extension)')
+        .option('--enable <app>', 'Write + propagate the MCP server for this app (blender | gimp)')
+        .option('--gimp-client <path>', 'Path to gimp_mcp_client.py (for --enable gimp)')
+        .action((p, opts) => {
+        const root = resolveRoot(p);
+        if (opts.enable) {
+            const app = opts.enable.toLowerCase();
+            if (app !== 'blender' && app !== 'gimp') {
+                logger_1.log.error(`--enable expects "blender" or "gimp" (got "${opts.enable}").`);
+                process.exit(1);
+            }
+            const code = enableApp(root, app, { gimpClient: opts.gimpClient });
+            if (code !== 0) {
+                process.exit(code);
+            }
+            return;
+        }
+        const result = buildDetect(root);
+        if (opts.json) {
+            process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+            return;
+        }
+        logger_1.log.section('🎨  Creative-app MCP detection');
+        for (const a of result.apps) {
+            const mark = a.installed ? '✅' : '⬜';
+            const exp = a.experimental ? ' (experimental)' : '';
+            logger_1.log.plain(`  ${mark} ${a.name}${exp}`);
+            if (a.installed) {
+                logger_1.log.gray(`       path: ${a.path}  [${a.source}]`);
+            }
+            if (a.alreadyEnabled) {
+                logger_1.log.gray('       already configured in this workspace');
+            }
+            for (const pr of a.prerequisites) {
+                if (!pr.installed) {
+                    logger_1.log.warn(`       prerequisite "${pr.id}" missing → ${pr.installHint}`);
+                }
+            }
+        }
+        logger_1.log.plain('');
+        logger_1.log.gray('  Enable one with:  autodev mcp detect --enable blender');
+        logger_1.log.gray('  GIMP (experimental): autodev mcp detect --enable gimp --gimp-client <gimp_mcp_client.py>');
+    });
+}
+/** Flip enabled state for a user entry, or toggle disabledBuiltinMcp for a built-in. */
+function setEnabled(root, name, enabled) {
+    if (isBuiltinName(root, name)) {
+        const settings = (0, settingsLoader_1.loadSettingsForRoot)(root);
+        const disabled = new Set(settings.disabledBuiltinMcp ?? []);
+        if (enabled) {
+            disabled.delete(name);
+        }
+        else {
+            disabled.add(name);
+        }
+        settings.disabledBuiltinMcp = [...disabled];
+        saveSettings(root, settings);
+        sync(root);
+        logger_1.log.success(`${enabled ? 'Enabled' : 'Disabled'} built-in MCP server "${name}".`);
+        return;
+    }
+    const user = (0, projectMcp_1.loadProjectUserMcp)(root);
+    const entry = user[name];
+    if (!entry) {
+        logger_1.log.error(`No MCP server named "${name}" in this workspace.`);
+        process.exit(1);
+    }
+    if (enabled) {
+        delete entry.enabled;
+    }
+    else {
+        entry.enabled = false;
+    }
+    (0, projectMcp_1.saveProjectUserMcp)(root, user);
+    sync(root);
+    logger_1.log.success(`${enabled ? 'Enabled' : 'Disabled'} MCP server "${name}".`);
+}
+//# sourceMappingURL=mcp.js.map

package/out/commands/mcp.js.map

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

package/out/core/binDetect.d.ts

@@ -0,0 +1,28 @@
+export interface BinDetectDeps {
+    platform: NodeJS.Platform;
+    env: NodeJS.ProcessEnv;
+    homedir: () => string;
+    /** Existence probe (stat). Injected so tests can fake a filesystem. */
+    fileExists: (p: string) => boolean;
+    /** List a directory's immediate children. Returns [] on any error/missing dir. */
+    listDir: (p: string) => string[];
+}
+export declare function defaultBinDetectDeps(): BinDetectDeps;
+/**
+ * Resolve a bare launcher name against PATH, plus a few well-known install
+ * dirs that are frequently missing from a GUI-launched process's PATH
+ * (~/.local/bin everywhere; %LOCALAPPDATA%\Programs and %APPDATA%\npm on win).
+ * Returns the absolute path of the first match, or null.
+ */
+export declare function detectBinOnPath(bin: string, deps?: Partial<BinDetectDeps>): string | null;
+export type AppSource = 'path' | 'program-files' | 'app-bundle' | 'flatpak' | 'snap' | 'known-dir';
+export interface DetectAppResult {
+    installed: boolean;
+    path: string | null;
+    source: AppSource | null;
+}
+/**
+ * Detect a known creative app across PATH + platform default install locations.
+ * Never throws; never spawns the app.
+ */
+export declare function detectApp(app: 'blender' | 'gimp', deps?: Partial<BinDetectDeps>): DetectAppResult;

package/out/core/binDetect.js

@@ -0,0 +1,255 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// binDetect — cross-platform detection of on-PATH launchers AND creative apps
+// that install OUTSIDE PATH (Blender / GIMP).
+//
+// Everything is dependency-injected ({platform, env, homedir, fileExists}) so
+// the detection logic is unit-testable without the app actually being present:
+// a fake Program Files tree on win32, a PATH hit on linux, etc.
+//
+// We only ever stat / glob directories and read PATH — we never spawn the app.
+// (Node fs/path/os only; no child_process here.)
+// ---------------------------------------------------------------------------
+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.defaultBinDetectDeps = defaultBinDetectDeps;
+exports.detectBinOnPath = detectBinOnPath;
+exports.detectApp = detectApp;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+function realFileExists(p) {
+    try {
+        return fs.existsSync(p);
+    }
+    catch {
+        return false;
+    }
+}
+function realListDir(p) {
+    try {
+        return fs.readdirSync(p);
+    }
+    catch {
+        return [];
+    }
+}
+function defaultBinDetectDeps() {
+    return {
+        platform: process.platform,
+        env: process.env,
+        homedir: os.homedir,
+        fileExists: realFileExists,
+        listDir: realListDir,
+    };
+}
+function mergeDeps(deps) {
+    return { ...defaultBinDetectDeps(), ...(deps || {}) };
+}
+/** Windows executable extensions, honoring %PATHEXT% with a sane fallback. */
+function winExts(env) {
+    const raw = (env.PATHEXT || '').split(';').map((e) => e.trim()).filter(Boolean);
+    const exts = raw.length ? raw : ['.EXE', '.CMD', '.BAT', '.COM'];
+    // Always allow the bare name too (e.g. a launcher that already carries an ext).
+    return ['', ...exts.map((e) => (e.startsWith('.') ? e : '.' + e))];
+}
+/**
+ * Resolve a bare launcher name against PATH, plus a few well-known install
+ * dirs that are frequently missing from a GUI-launched process's PATH
+ * (~/.local/bin everywhere; %LOCALAPPDATA%\Programs and %APPDATA%\npm on win).
+ * Returns the absolute path of the first match, or null.
+ */
+function detectBinOnPath(bin, deps) {
+    const d = mergeDeps(deps);
+    const isWin = d.platform === 'win32';
+    // A caller that passes an explicit path (has a separator) just gets probed.
+    if (/[\\/]/.test(bin)) {
+        return d.fileExists(bin) ? bin : null;
+    }
+    const exts = isWin ? winExts(d.env) : [''];
+    const sep = isWin ? ';' : ':';
+    const pathDirs = (d.env.PATH || d.env.Path || '').split(sep).map((s) => s.trim()).filter(Boolean);
+    const extraDirs = [];
+    const home = d.homedir();
+    if (home) {
+        extraDirs.push(path.join(home, '.local', 'bin'));
+    }
+    if (isWin) {
+        const local = d.env.LOCALAPPDATA;
+        const appdata = d.env.APPDATA;
+        if (local) {
+            extraDirs.push(path.join(local, 'Programs'));
+        }
+        if (appdata) {
+            extraDirs.push(path.join(appdata, 'npm'));
+        }
+    }
+    for (const dir of [...pathDirs, ...extraDirs]) {
+        for (const ext of exts) {
+            const full = path.join(dir, bin + ext);
+            if (d.fileExists(full)) {
+                return full;
+            }
+        }
+    }
+    return null;
+}
+/** First candidate whose file exists wins (candidates are pre-ordered by preference). */
+function firstExisting(cands, d) {
+    for (const c of cands) {
+        if (c.path && d.fileExists(c.path)) {
+            return { installed: true, path: c.path, source: c.source };
+        }
+    }
+    return { installed: false, path: null, source: null };
+}
+/** Children of `parent` matching `re`, joined back to absolute paths (safe on missing dirs). */
+function globChildren(parent, re, d) {
+    return d.listDir(parent).filter((n) => re.test(n)).sort().map((n) => path.join(parent, n));
+}
+/** Flatpak per-app exported launcher path, checked in the user + system roots. */
+function flatpakExportCandidates(appId, d) {
+    const roots = [];
+    const home = d.homedir();
+    if (home) {
+        roots.push(path.join(home, '.local', 'share', 'flatpak'));
+    }
+    roots.push('/var/lib/flatpak');
+    return roots.map((r) => ({ path: path.join(r, 'exports', 'bin', appId), source: 'flatpak' }));
+}
+/** Windows "Program Files" roots we know about (64-bit, 32-bit, and env overrides). */
+function winProgramRoots(d) {
+    const roots = new Set();
+    for (const v of [d.env.PROGRAMFILES, d.env['ProgramW6432'], d.env['ProgramFiles(x86)']]) {
+        if (v) {
+            roots.add(v);
+        }
+    }
+    roots.add('C:\\Program Files');
+    roots.add('C:\\Program Files (x86)');
+    return [...roots];
+}
+function detectBlender(d) {
+    // 1) PATH (all platforms) — highest confidence.
+    const onPath = detectBinOnPath('blender', d);
+    if (onPath) {
+        return { installed: true, path: onPath, source: 'path' };
+    }
+    const cands = [];
+    if (d.platform === 'win32') {
+        // C:\Program Files\Blender Foundation\Blender X.Y\blender.exe
+        for (const root of winProgramRoots(d)) {
+            const foundation = path.join(root, 'Blender Foundation');
+            for (const verDir of globChildren(foundation, /^Blender/i, d)) {
+                cands.push({ path: path.join(verDir, 'blender.exe'), source: 'program-files' });
+            }
+        }
+        // %LOCALAPPDATA%\Programs\Blender Foundation\Blender X.Y\blender.exe
+        const local = d.env.LOCALAPPDATA;
+        if (local) {
+            const foundation = path.join(local, 'Programs', 'Blender Foundation');
+            for (const verDir of globChildren(foundation, /^Blender/i, d)) {
+                cands.push({ path: path.join(verDir, 'blender.exe'), source: 'program-files' });
+            }
+        }
+        // Steam: ...\Steam\steamapps\common\Blender\blender.exe
+        for (const root of winProgramRoots(d)) {
+            cands.push({ path: path.join(root, 'Steam', 'steamapps', 'common', 'Blender', 'blender.exe'), source: 'known-dir' });
+        }
+    }
+    else if (d.platform === 'darwin') {
+        cands.push({ path: '/Applications/Blender.app/Contents/MacOS/Blender', source: 'app-bundle' });
+        const home = d.homedir();
+        if (home) {
+            cands.push({ path: path.join(home, 'Applications', 'Blender.app', 'Contents', 'MacOS', 'Blender'), source: 'app-bundle' });
+        }
+    }
+    else {
+        cands.push({ path: '/usr/bin/blender', source: 'known-dir' });
+        cands.push({ path: '/usr/local/bin/blender', source: 'known-dir' });
+        cands.push({ path: '/snap/bin/blender', source: 'snap' });
+        cands.push(...flatpakExportCandidates('org.blender.Blender', d));
+    }
+    return firstExisting(cands, d);
+}
+function detectGimp(d) {
+    const binNames = ['gimp', 'gimp-3.0', 'gimp-2.99', 'gimp-2.10'];
+    // 1) PATH (all platforms).
+    for (const b of binNames) {
+        const onPath = detectBinOnPath(b, d);
+        if (onPath) {
+            return { installed: true, path: onPath, source: 'path' };
+        }
+    }
+    const cands = [];
+    if (d.platform === 'win32') {
+        // C:\Program Files\GIMP 2\bin\gimp-2.10.exe  (version dirs + version'd exe)
+        for (const root of winProgramRoots(d)) {
+            for (const gimpDir of globChildren(root, /^GIMP/i, d)) {
+                const bin = path.join(gimpDir, 'bin');
+                for (const exe of globChildren(bin, /^gimp.*\.exe$/i, d)) {
+                    cands.push({ path: exe, source: 'program-files' });
+                }
+            }
+        }
+    }
+    else if (d.platform === 'darwin') {
+        cands.push({ path: '/Applications/GIMP.app/Contents/MacOS/gimp', source: 'app-bundle' });
+        cands.push({ path: '/Applications/GIMP.app/Contents/MacOS/GIMP', source: 'app-bundle' });
+        // Versioned bundle naming (GIMP-2.10.app).
+        for (const appDir of globChildren('/Applications', /^GIMP[-.].*\.app$/i, d)) {
+            cands.push({ path: path.join(appDir, 'Contents', 'MacOS', 'gimp'), source: 'app-bundle' });
+            cands.push({ path: path.join(appDir, 'Contents', 'MacOS', 'GIMP'), source: 'app-bundle' });
+        }
+    }
+    else {
+        for (const b of binNames) {
+            cands.push({ path: `/usr/bin/${b}`, source: 'known-dir' });
+            cands.push({ path: `/usr/local/bin/${b}`, source: 'known-dir' });
+        }
+        cands.push({ path: '/snap/bin/gimp', source: 'snap' });
+        cands.push(...flatpakExportCandidates('org.gimp.GIMP', d));
+    }
+    return firstExisting(cands, d);
+}
+/**
+ * Detect a known creative app across PATH + platform default install locations.
+ * Never throws; never spawns the app.
+ */
+function detectApp(app, deps) {
+    const d = mergeDeps(deps);
+    return app === 'blender' ? detectBlender(d) : detectGimp(d);
+}
+//# sourceMappingURL=binDetect.js.map

package/out/core/binDetect.js.map

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

package/out/core/mcpCatalog.d.ts

@@ -0,0 +1,41 @@
+import type { McpJsonEntry } from './projectMcp';
+export type CreativeAppId = 'blender' | 'gimp';
+export interface McpPrerequisiteSpec {
+    /** Launcher/interpreter the server needs on PATH (e.g. 'uvx', 'python'). */
+    id: string;
+    /** Copy-pasteable command to install it, per platform. */
+    installHint: string;
+}
+export interface McpCatalogEntry {
+    id: CreativeAppId;
+    name: string;
+    /** True = prototype/best-effort. UIs should surface it as such, never one-click. */
+    experimental: boolean;
+    /** The name the server is written under in .mcp.json. */
+    serverName: string;
+    prerequisites: McpPrerequisiteSpec[];
+    /** Ordered manual steps the user still performs after the config is written. */
+    postSetup: string[];
+    /** Caveats worth surfacing (port clashes, upstream bugs). */
+    notes: string[];
+}
+/** Placeholder the GIMP stub carries until the user points it at their checkout. */
+export declare const GIMP_CLIENT_PLACEHOLDER = "<GIMP_MCP_CLIENT_PY>";
+/** 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. */
+export declare function pythonInstallHint(platform: NodeJS.Platform): string;
+/**
+ * The McpJsonEntry we would write for an app. Platform-aware.
+ *  - Blender: `uvx blender-mcp` (wrapped in `cmd /c` on win32 so the .cmd shim 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.
+ */
+export declare function serverSpecFor(app: CreativeAppId, platform: NodeJS.Platform, opts?: {
+    gimpClientPath?: string;
+}): McpJsonEntry;
+/** 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. */
+export declare function catalogEntry(app: CreativeAppId, platform: NodeJS.Platform): McpCatalogEntry;

package/out/core/mcpCatalog.js

@@ -0,0 +1,119 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// mcpCatalog — the known creative-app MCP registry. Single source of truth that
+// BOTH the Electron app and the VS Code extension consume via `autodev mcp
+// detect --json`; the CLI is what actually writes the server into .mcp.json and
+// propagates it to every provider, so the shapes here must stay stable.
+//
+// Each app declares: the McpJsonEntry we would write (platform-aware),
+// prerequisites (with an install hint), and honest post-setup / notes. GIMP is
+// flagged experimental because upstream ships no packaged launcher — see below.
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GIMP_CLIENT_PLACEHOLDER = void 0;
+exports.uvInstallHint = uvInstallHint;
+exports.pythonInstallHint = pythonInstallHint;
+exports.serverSpecFor = serverSpecFor;
+exports.getCatalog = getCatalog;
+exports.catalogEntry = catalogEntry;
+/** Placeholder the GIMP stub carries until the user points it at their checkout. */
+exports.GIMP_CLIENT_PLACEHOLDER = '<GIMP_MCP_CLIENT_PY>';
+/** Per-platform install hint for the `uv`/`uvx` toolchain (never `pip install uv`). */
+function uvInstallHint(platform) {
+    if (platform === 'win32') {
+        return 'powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"';
+    }
+    if (platform === 'darwin') {
+        return 'brew install uv   (or: curl -LsSf https://astral.sh/uv/install.sh | sh)';
+    }
+    return 'curl -LsSf https://astral.sh/uv/install.sh | sh';
+}
+/** Per-platform install hint for Python 3. */
+function pythonInstallHint(platform) {
+    if (platform === 'win32') {
+        return 'Install Python 3 from https://www.python.org/downloads/ (tick "Add to PATH")';
+    }
+    if (platform === 'darwin') {
+        return 'brew install python   (or install from https://www.python.org)';
+    }
+    return 'Install python3 via your package manager (e.g. apt install python3)';
+}
+/**
+ * The McpJsonEntry we would write for an app. Platform-aware.
+ *  - Blender: `uvx blender-mcp` (wrapped in `cmd /c` on win32 so the .cmd shim 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.
+ */
+function serverSpecFor(app, platform, opts) {
+    if (app === 'blender') {
+        return platform === 'win32'
+            ? { command: 'cmd', args: ['/c', 'uvx', 'blender-mcp'] }
+            : { command: 'uvx', args: ['blender-mcp'] };
+    }
+    // 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 } : {}),
+    };
+}
+/** Build the catalog for a given platform (install hints are platform-specific). */
+function getCatalog(platform) {
+    return [
+        {
+            id: 'blender',
+            name: 'Blender',
+            experimental: false,
+            serverName: 'blender',
+            prerequisites: [{ id: 'uvx', installHint: uvInstallHint(platform) }],
+            postSetup: [
+                'Run `uvx blender-mcp install-addon` to install the Blender addon',
+                "In Blender: Preferences → Add-ons → enable 'Interface: MCP for Blender'",
+                "In the 3D viewport press N → 'MCP for Blender' → Start MCP Server (listens on localhost:9876)",
+                'Run only one MCP client against Blender at a time',
+            ],
+            notes: [],
+        },
+        {
+            id: 'gimp',
+            name: 'GIMP',
+            experimental: true,
+            serverName: 'gimp',
+            prerequisites: [{ id: 'python', installHint: pythonInstallHint(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',
+            ],
+            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.',
+            ],
+        },
+    ];
+}
+/** GIMP 3.0 plug-ins directory step, per OS. */
+function gimpPluginStep(platform) {
+    const dir = platform === 'win32'
+        ? '%APPDATA%\\GIMP\\3.0\\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`;
+}
+/** Lookup a single catalog entry. */
+function catalogEntry(app, platform) {
+    const e = getCatalog(platform).find((x) => x.id === app);
+    if (!e) {
+        throw new Error(`Unknown creative app: ${app}`);
+    }
+    return e;
+}
+//# sourceMappingURL=mcpCatalog.js.map

package/out/core/mcpCatalog.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autodev-cli",
-  "version": "1.4.139",
+  "version": "1.4.140",
   "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/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"
+    "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/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"
   },
   "dependencies": {
     "@opencode-ai/sdk": "^1.14.41",