aiden-runtime 4.8.0 → 4.9.0

package/dist/cli/v4/commands/mcpClientInstall.js

@@ -0,0 +1,359 @@
+"use strict";
+/**
+ * Copyright (c) 2026 Shiva Deore (Taracod).
+ * Licensed under AGPL-3.0. See LICENSE for details.
+ *
+ * Aiden — local-first agent.
+ */
+/**
+ * cli/v4/commands/mcpClientInstall.ts — v4.9.0 Slice 2a.
+ *
+ * Handlers for `aiden mcp init|doctor|repair <client>`. Pure user-
+ * facing orchestration over the install primitives in
+ * `core/v4/mcp/install/`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runHealthCheck = exports.findLatestBackup = exports.countBackups = exports.detectWsl = exports.buildAidenEntry = exports.installClient = exports.planInstall = exports.readClient = exports.resolveClientPath = void 0;
+exports.runClientCommand = runClientCommand;
+const node_fs_1 = require("node:fs");
+const clientPaths_1 = require("../../../core/v4/mcp/install/clientPaths");
+Object.defineProperty(exports, "resolveClientPath", { enumerable: true, get: function () { return clientPaths_1.resolveClientPath; } });
+const clients_1 = require("../../../core/v4/mcp/install/clients");
+Object.defineProperty(exports, "installClient", { enumerable: true, get: function () { return clients_1.installClient; } });
+Object.defineProperty(exports, "planInstall", { enumerable: true, get: function () { return clients_1.planInstall; } });
+Object.defineProperty(exports, "readClient", { enumerable: true, get: function () { return clients_1.readClient; } });
+const jsoncMerge_1 = require("../../../core/v4/mcp/install/jsoncMerge");
+const wslDetect_1 = require("../../../core/v4/mcp/install/wslDetect");
+Object.defineProperty(exports, "detectWsl", { enumerable: true, get: function () { return wslDetect_1.detectWsl; } });
+Object.defineProperty(exports, "buildAidenEntry", { enumerable: true, get: function () { return wslDetect_1.buildAidenEntry; } });
+const backup_1 = require("../../../core/v4/mcp/install/backup");
+Object.defineProperty(exports, "countBackups", { enumerable: true, get: function () { return backup_1.countBackups; } });
+Object.defineProperty(exports, "findLatestBackup", { enumerable: true, get: function () { return backup_1.findLatestBackup; } });
+const healthCheck_1 = require("../../../core/v4/mcp/install/healthCheck");
+Object.defineProperty(exports, "runHealthCheck", { enumerable: true, get: function () { return healthCheck_1.runHealthCheck; } });
+const profiles_1 = require("../../../core/v4/mcp/install/profiles");
+const SUPPORTED = new Set(['claude', 'cursor', 'vscode']);
+function isClientId(s) {
+    return typeof s === 'string' && SUPPORTED.has(s);
+}
+function usage(io, action) {
+    io.writeErr(`Usage: aiden mcp ${action} <client> [--dry-run] [--print-snippet] [--yes] [--profile <name>]\n`);
+    io.writeErr(`Supported clients: ${Array.from(SUPPORTED).join(', ')}\n`);
+    io.writeErr(`Profiles: ${profiles_1.PROFILE_NAMES.join(', ')}\n`);
+    return 1;
+}
+/** Pull `--profile <name>` from extraArgs if present. Throws on missing arg. */
+function extractProfileFlag(extraArgs) {
+    const idx = extraArgs.indexOf('--profile');
+    if (idx === -1)
+        return undefined;
+    const value = extraArgs[idx + 1];
+    if (!value || value.startsWith('--')) {
+        throw new Error(`--profile requires a name. Available: ${profiles_1.PROFILE_NAMES.join(', ')}`);
+    }
+    return value;
+}
+async function runClientCommand(action, client, extraArgs, io) {
+    if (!isClientId(client))
+        return usage(io, action);
+    const dryRun = extraArgs.includes('--dry-run');
+    const printSnippet = extraArgs.includes('--print-snippet');
+    const yes = extraArgs.includes('--yes');
+    let profileName;
+    try {
+        profileName = extractProfileFlag(extraArgs);
+    }
+    catch (err) {
+        io.writeErr(`${err.message}\n`);
+        return 1;
+    }
+    if (action === 'init')
+        return doInit(client, io, { dryRun, printSnippet, yes, profileName });
+    if (action === 'doctor')
+        return doDoctor(client, io);
+    if (action === 'repair')
+        return doRepair(client, io, { yes, profileName });
+    return doUninstall(client, io, { dryRun, yes });
+}
+async function doInit(client, io, opts) {
+    // v4.9.0 Slice 2b — resolve profile (explicit --profile or client default).
+    // Profile name flows into both the spawn args AND the _aiden.profile marker.
+    let profile;
+    try {
+        profile = (0, profiles_1.resolveProfile)(opts.profileName, client);
+    }
+    catch (err) {
+        io.writeErr(`${err.message}\n`);
+        return 1;
+    }
+    const wsl = (0, wslDetect_1.detectWsl)();
+    const baseEntry = (0, wslDetect_1.buildAidenEntry)({ wsl, target: wsl.inWsl ? 'host' : undefined });
+    // Append `--profile <name>` to args so the wired serve command
+    // launches with the right tool allowlist.
+    const entry = {
+        command: baseEntry.command,
+        args: [...baseEntry.args, '--profile', profile.name],
+    };
+    const planned = (0, clients_1.planInstall)(client, { command: entry.command, args: entry.args, profile: profile.name });
+    if (!planned) {
+        io.writeErr(`Could not resolve config path for ${client}.\n`);
+        return 1;
+    }
+    if (opts.printSnippet) {
+        // Emit just the Aiden entry as a JSON blob the user can paste.
+        // Use the resolved schema so VS Code gets `servers.aiden` + type:'stdio'.
+        const obj = (0, jsoncMerge_1.buildAidenEntryObject)({
+            command: entry.command,
+            args: entry.args,
+            profile: profile.name,
+            schema: planned.resolution.schema,
+        });
+        const top = {};
+        top[planned.resolution.schema.topKey] = { aiden: obj };
+        io.writeOut(JSON.stringify(top, null, 2) + '\n');
+        return 0;
+    }
+    if (planned.parentMissing) {
+        // v4.9.0 Slice 2a hotfix #1 — clearer diagnostic. If the user
+        // believes the client IS installed (file is right there in
+        // Explorer / Finder), the most likely cause is that they're
+        // running an older `aiden` bin from npm that doesn't have these
+        // commands at all — globally-installed aiden-runtime predates
+        // v4.9.0. Surface that hypothesis explicitly so they don't chase
+        // a phantom path-detection bug.
+        io.writeErr(`${planned.resolution.displayName} doesn't appear to be installed.\n` +
+            `Expected parent dir: ${planned.resolution.parentDir}\n` +
+            `Install ${planned.resolution.displayName} first, or run with --print-snippet to copy the entry manually.\n` +
+            `\n` +
+            `If you're sure the client IS installed and you see this error,\n` +
+            `check that your \`aiden\` bin is the current dev build (not a\n` +
+            `published version): run \`which aiden\` (POSIX) or \`where aiden\`\n` +
+            `(Windows) and verify the resolved path matches your local repo.\n`);
+        return 1;
+    }
+    if (opts.dryRun) {
+        io.writeOut(`[dry-run] Would write to: ${planned.resolution.configPath}\n`);
+        io.writeOut(`[dry-run] New content (${planned.resolution.format}):\n`);
+        io.writeOut(planned.newText);
+        return 0;
+    }
+    if (!opts.yes) {
+        io.writeOut(`About to write Aiden's MCP entry to:\n  ${planned.resolution.configPath}\n`);
+        io.writeOut(`A timestamped backup will be created first. Continue? [Y/n]\n`);
+        // Best-effort confirmation: non-TTY callers (CI, npx) implicitly
+        // pass --yes; interactive callers can answer at the prompt below.
+        if (process.stdin.isTTY) {
+            const answer = await readOneLine();
+            if (answer && /^n/i.test(answer)) {
+                io.writeOut('Aborted.\n');
+                return 0;
+            }
+        }
+    }
+    const result = (0, clients_1.installClient)(client, { command: entry.command, args: entry.args });
+    if (result.outcome === 'error') {
+        io.writeErr(`Install failed: ${result.error}\n`);
+        return 1;
+    }
+    if (result.outcome === 'noop') {
+        io.writeOut(`${planned.resolution.displayName}: Aiden entry already up to date.\n`);
+        return 0;
+    }
+    io.writeOut(`✓ Wrote Aiden entry to ${result.configPath}\n`);
+    if (result.backupPath) {
+        io.writeOut(`  Backup: ${result.backupPath}\n`);
+    }
+    // Connection health check — spawn the wired command + parse JSON.
+    io.writeOut('Running health check…\n');
+    const health = await (0, healthCheck_1.runHealthCheck)({ command: entry.command, args: entry.args });
+    if (health.ok) {
+        io.writeOut(`✓ Health check ok — ${health.tools ?? '?'} tools exposed, build ${health.version ?? '?'}\n`);
+    }
+    else {
+        io.writeOut(`⚠ Health check failed: ${health.error}\n`);
+        io.writeOut(`  The entry is written; you can retry with /aiden mcp doctor ${client}.\n`);
+    }
+    // Restart guidance — per-client hint.
+    io.writeOut(`\nRestart ${planned.resolution.displayName} to load Aiden as an MCP server.\n`);
+    if (client === 'cursor') {
+        io.writeOut('  (In Cursor: Developer → Reload Window also picks up the change.)\n');
+    }
+    if (client === 'vscode') {
+        io.writeOut('  (Run VS Code\'s "Developer: Reload Window" command to reload the workspace MCP config without restarting VS Code.)\n');
+    }
+    io.writeOut(`Profile: ${profile.name} — ${profile.description}\n`);
+    return 0;
+}
+async function doDoctor(client, io) {
+    const { resolution, entry, exists, text } = (0, clients_1.readClient)(client);
+    io.writeOut(`${resolution.displayName} MCP diagnosis\n`);
+    io.writeOut(`  Config path:  ${resolution.configPath}\n`);
+    if (!exists) {
+        io.writeOut(`  ✗ Config file does not exist.\n`);
+        io.writeOut(`    Hint: run "aiden mcp init ${client}" to create it.\n`);
+        return 1;
+    }
+    io.writeOut(`  ✓ Config file exists\n`);
+    // Validate JSON / JSONC parses.
+    let parseOk = false;
+    try {
+        if (resolution.format === 'json')
+            JSON.parse(text ?? '');
+        // jsonc-parser tolerates everything; only plain-JSON.parse can fail
+        parseOk = true;
+    }
+    catch (err) {
+        io.writeOut(`  ✗ Config is malformed: ${err.message}\n`);
+        const latest = (0, backup_1.findLatestBackup)(resolution.configPath);
+        if (latest) {
+            io.writeOut(`    Latest backup: ${latest}\n`);
+            io.writeOut(`    Hint: aiden mcp repair ${client}  — restores from the latest backup.\n`);
+        }
+        return 1;
+    }
+    if (parseOk)
+        io.writeOut(`  ✓ Config parses cleanly\n`);
+    if (!entry) {
+        io.writeOut(`  ✗ Aiden entry missing under mcpServers.aiden\n`);
+        io.writeOut(`    Hint: aiden mcp init ${client}\n`);
+        return 1;
+    }
+    io.writeOut(`  ✓ Aiden entry present\n`);
+    const wsl = (0, wslDetect_1.detectWsl)();
+    const expected = (0, wslDetect_1.buildAidenEntry)({ wsl, target: wsl.inWsl ? 'host' : undefined });
+    const cmdOk = entry.command === expected.command;
+    const argsOk = JSON.stringify(entry.args) === JSON.stringify(expected.args);
+    io.writeOut(`  ${cmdOk ? '✓' : '✗'} command: ${entry.command} (expected ${expected.command})\n`);
+    io.writeOut(`  ${argsOk ? '✓' : '✗'} args:    ${JSON.stringify(entry.args)} (expected ${JSON.stringify(expected.args)})\n`);
+    const managed = entry._aiden?.managed === true;
+    io.writeOut(`  ${managed ? '✓' : '⚠'} Managed by Aiden: ${managed ? 'yes' : 'no — entry exists but was authored externally'}\n`);
+    if (entry._aiden?.profile) {
+        io.writeOut(`  Profile (pinned): ${entry._aiden.profile}\n`);
+    }
+    io.writeOut(`  Backups: ${(0, backup_1.countBackups)(resolution.configPath)} file(s)\n`);
+    // Health check.
+    const health = await (0, healthCheck_1.runHealthCheck)({ command: entry.command, args: entry.args });
+    if (health.ok) {
+        io.writeOut(`  ✓ Health check: ${health.tools ?? '?'} tools, build ${health.version ?? '?'}\n`);
+    }
+    else {
+        io.writeOut(`  ✗ Health check: ${health.error}\n`);
+    }
+    const allGood = cmdOk && argsOk && managed && health.ok;
+    return allGood ? 0 : 1;
+}
+async function doRepair(client, io, opts) {
+    const { resolution, entry, exists, text } = (0, clients_1.readClient)(client);
+    if (!exists) {
+        io.writeOut(`${resolution.displayName}: config doesn't exist. Running init instead.\n`);
+        return doInit(client, io, { dryRun: false, printSnippet: false, yes: opts.yes, profileName: opts.profileName });
+    }
+    // Try to parse the config; if it's broken, offer a restore.
+    let parseOk = true;
+    if (resolution.format === 'json') {
+        try {
+            JSON.parse(text ?? '');
+        }
+        catch {
+            parseOk = false;
+        }
+    }
+    if (!parseOk) {
+        const latest = (0, backup_1.findLatestBackup)(resolution.configPath);
+        if (!latest) {
+            io.writeErr(`Config is malformed and no backup is available. Aborting.\n`);
+            return 1;
+        }
+        io.writeOut(`Config is malformed. Restoring from backup: ${latest}\n`);
+        try {
+            (0, node_fs_1.copyFileSync)(latest, resolution.configPath);
+        }
+        catch (err) {
+            io.writeErr(`Restore failed: ${err.message}\n`);
+            return 1;
+        }
+        io.writeOut(`✓ Restored. Re-running init to ensure Aiden entry is present.\n`);
+        return doInit(client, io, { dryRun: false, printSnippet: false, yes: true });
+    }
+    const wsl = (0, wslDetect_1.detectWsl)();
+    let profile;
+    try {
+        profile = (0, profiles_1.resolveProfile)(opts.profileName ?? entry?._aiden?.profile, client);
+    }
+    catch (err) {
+        io.writeErr(`${err.message}\n`);
+        return 1;
+    }
+    const expectedBase = (0, wslDetect_1.buildAidenEntry)({ wsl, target: wsl.inWsl ? 'host' : undefined });
+    const expectedArgs = [...expectedBase.args, '--profile', profile.name];
+    const cmdOk = entry?.command === expectedBase.command;
+    const argsOk = JSON.stringify(entry?.args) === JSON.stringify(expectedArgs);
+    const profileOk = entry?._aiden?.profile === profile.name;
+    if (entry && cmdOk && argsOk && profileOk) {
+        io.writeOut(`${resolution.displayName}: entry already correct, nothing to repair.\n`);
+        return 0;
+    }
+    io.writeOut(`${resolution.displayName}: updating stale entry to current values (profile: ${profile.name}).\n`);
+    return doInit(client, io, { dryRun: false, printSnippet: false, yes: true, profileName: profile.name });
+}
+async function doUninstall(client, io, opts) {
+    const planned = (0, clients_1.planUninstall)(client);
+    if (!planned.willRemove) {
+        io.writeOut(`Aiden not configured for ${planned.resolution.displayName}. Nothing to do.\n`);
+        return 0;
+    }
+    const managed = planned.entry?._aiden?.managed === true;
+    if (!managed && !opts.yes) {
+        io.writeOut(`The aiden entry in ${planned.resolution.displayName}'s config wasn't installed by\n`);
+        io.writeOut(`'aiden mcp init' (no _aiden.managed marker). Proceed anyway? [y/N]\n`);
+        if (process.stdin.isTTY) {
+            const answer = await readOneLine();
+            if (!answer || !/^y/i.test(answer)) {
+                io.writeOut('Aborted.\n');
+                return 0;
+            }
+        }
+        else {
+            io.writeOut('Non-interactive shell — pass --yes to confirm removal of an unmanaged entry.\n');
+            return 1;
+        }
+    }
+    if (opts.dryRun) {
+        io.writeOut(`[dry-run] Would remove aiden entry from: ${planned.resolution.configPath}\n`);
+        io.writeOut(`[dry-run] Managed by Aiden: ${managed ? 'yes' : 'no (unmanaged)'}\n`);
+        io.writeOut(`[dry-run] New content (${planned.resolution.format}):\n`);
+        io.writeOut(planned.newText);
+        return 0;
+    }
+    const result = (0, clients_1.uninstallClient)(client);
+    if (result.outcome === 'error') {
+        io.writeErr(`Uninstall failed: ${result.error}\n`);
+        return 1;
+    }
+    if (result.outcome === 'noop') {
+        io.writeOut(`Aiden not configured for ${planned.resolution.displayName}. Nothing to do.\n`);
+        return 0;
+    }
+    io.writeOut(`✓ Removed aiden entry from ${result.configPath}\n`);
+    if (result.backupPath)
+        io.writeOut(`  Backup: ${result.backupPath}\n`);
+    io.writeOut(`\nRestart ${planned.resolution.displayName} to drop the now-disconnected Aiden MCP server.\n`);
+    return 0;
+}
+/** Read one line from stdin. Best-effort; tolerates non-TTY callers. */
+function readOneLine() {
+    return new Promise((resolve) => {
+        let buf = '';
+        const onData = (chunk) => {
+            buf += chunk.toString();
+            if (buf.includes('\n')) {
+                process.stdin.removeListener('data', onData);
+                resolve(buf.split('\n')[0].trim());
+            }
+        };
+        process.stdin.on('data', onData);
+    });
+}
+// Silence unused-import lint when only used as type.
+void node_fs_1.readFileSync;
+void node_fs_1.existsSync;