@gmickel/gno 0.7.0 → 0.8.2

package/src/cli/commands/mcp/install.ts

@@ -4,8 +4,8 @@
  * @module src/cli/commands/mcp/install
  */
 
-import { CliError } from '../../errors.js';
-import { getGlobals } from '../../program.js';
+import { CliError } from "../../errors.js";
+import { getGlobals } from "../../program.js";
 import {
   type AnyMcpConfig,
   buildEntry,
@@ -15,7 +15,7 @@ import {
   type StandardMcpEntry,
   setServerEntry,
   writeMcpConfig,
-} from './config.js';
+} from "./config.js";
 import {
   buildMcpServerEntry,
   getTargetDisplayName,
@@ -24,7 +24,7 @@ import {
   type McpTarget,
   resolveMcpConfigPath,
   TARGETS_WITH_PROJECT_SCOPE,
-} from './paths.js';
+} from "./paths.js";
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Types
@@ -49,7 +49,7 @@ interface InstallResult {
   target: McpTarget;
   scope: McpScope;
   configPath: string;
-  action: 'created' | 'updated' | 'dry_run_create' | 'dry_run_update';
+  action: "created" | "updated" | "dry_run_create" | "dry_run_update";
   serverEntry: { command: string; args: string[] };
 }
 
@@ -91,10 +91,10 @@ async function installToTarget(
   const alreadyExists = hasServerEntry(config, MCP_SERVER_NAME, configFormat);
   if (alreadyExists && !force) {
     throw new CliError(
-      'VALIDATION',
+      "VALIDATION",
       `${getTargetDisplayName(target)} already has gno configured.\n` +
         `  Config: ${configPath}\n` +
-        '  Use --force to overwrite.'
+        "  Use --force to overwrite."
     );
   }
 
@@ -105,12 +105,12 @@ async function installToTarget(
       target,
       scope,
       configPath,
-      action: wouldCreate ? 'dry_run_create' : 'dry_run_update',
+      action: wouldCreate ? "dry_run_create" : "dry_run_update",
       serverEntry,
     };
   }
 
-  const action = wouldCreate ? 'created' : 'updated';
+  const action = wouldCreate ? "created" : "updated";
 
   // Build format-specific entry and add to config
   const entry = buildEntry(serverEntry.command, serverEntry.args, configFormat);
@@ -143,8 +143,8 @@ function safeGetGlobals(): { json: boolean; quiet: boolean } {
  * Install gno MCP server.
  */
 export async function installMcp(opts: InstallOptions = {}): Promise<void> {
-  const target = opts.target ?? 'claude-desktop';
-  const scope = opts.scope ?? 'user';
+  const target = opts.target ?? "claude-desktop";
+  const scope = opts.scope ?? "user";
   const force = opts.force ?? false;
   const dryRun = opts.dryRun ?? false;
   const globals = safeGetGlobals();
@@ -152,9 +152,9 @@ export async function installMcp(opts: InstallOptions = {}): Promise<void> {
   const quiet = opts.quiet ?? globals.quiet;
 
   // Validate scope - only some targets support project scope
-  if (scope === 'project' && !TARGETS_WITH_PROJECT_SCOPE.includes(target)) {
+  if (scope === "project" && !TARGETS_WITH_PROJECT_SCOPE.includes(target)) {
     throw new CliError(
-      'VALIDATION',
+      "VALIDATION",
       `${getTargetDisplayName(target)} does not support project scope. Use --scope user.`
     );
   }
@@ -181,18 +181,18 @@ export async function installMcp(opts: InstallOptions = {}): Promise<void> {
   }
 
   if (dryRun) {
-    const dryRunVerb = result.action === 'dry_run_create' ? 'create' : 'update';
-    process.stdout.write('Dry run - no changes made.\n\n');
+    const dryRunVerb = result.action === "dry_run_create" ? "create" : "update";
+    process.stdout.write("Dry run - no changes made.\n\n");
     process.stdout.write(
       `Would ${dryRunVerb} gno in ${getTargetDisplayName(target)}:\n`
     );
     process.stdout.write(`  Config: ${result.configPath}\n`);
     process.stdout.write(`  Command: ${serverEntry.command}\n`);
-    process.stdout.write(`  Args: ${serverEntry.args.join(' ')}\n`);
+    process.stdout.write(`  Args: ${serverEntry.args.join(" ")}\n`);
     return;
   }
 
-  const verb = result.action === 'created' ? 'Installed' : 'Updated';
+  const verb = result.action === "created" ? "Installed" : "Updated";
   process.stdout.write(
     `${verb} gno MCP server in ${getTargetDisplayName(target)}.\n`
   );

package/src/cli/commands/mcp/paths.ts

@@ -5,27 +5,27 @@
  * @module src/cli/commands/mcp/paths
  */
 
-import { existsSync } from 'node:fs';
-import { homedir, platform } from 'node:os';
-import { join } from 'node:path';
+import { existsSync } from "node:fs";
+import { homedir, platform } from "node:os";
+import { join } from "node:path";
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Types
 // ─────────────────────────────────────────────────────────────────────────────
 
 export type McpTarget =
-  | 'claude-desktop'
-  | 'claude-code'
-  | 'codex'
-  | 'cursor'
-  | 'zed'
-  | 'windsurf'
-  | 'opencode'
-  | 'amp'
-  | 'lmstudio'
-  | 'librechat';
-
-export type McpScope = 'user' | 'project';
+  | "claude-desktop"
+  | "claude-code"
+  | "codex"
+  | "cursor"
+  | "zed"
+  | "windsurf"
+  | "opencode"
+  | "amp"
+  | "lmstudio"
+  | "librechat";
+
+export type McpScope = "user" | "project";
 
 /**
  * Config format varies by target.
@@ -36,11 +36,11 @@ export type McpScope = 'user' | 'project';
  * - yaml_standard: YAML file with mcpServers key (LibreChat)
  */
 export type McpConfigFormat =
-  | 'standard'
-  | 'context_servers'
-  | 'mcp'
-  | 'amp_mcp'
-  | 'yaml_standard';
+  | "standard"
+  | "context_servers"
+  | "mcp"
+  | "amp_mcp"
+  | "yaml_standard";
 
 export interface McpConfigPaths {
   /** Config file path */
@@ -69,44 +69,44 @@ export interface McpPathOptions {
 // Constants
 // ─────────────────────────────────────────────────────────────────────────────
 
-export const MCP_SERVER_NAME = 'gno';
+export const MCP_SERVER_NAME = "gno";
 
 /** All supported MCP targets */
 export const MCP_TARGETS: McpTarget[] = [
-  'claude-desktop',
-  'claude-code',
-  'codex',
-  'cursor',
-  'zed',
-  'windsurf',
-  'opencode',
-  'amp',
-  'lmstudio',
-  'librechat',
+  "claude-desktop",
+  "claude-code",
+  "codex",
+  "cursor",
+  "zed",
+  "windsurf",
+  "opencode",
+  "amp",
+  "lmstudio",
+  "librechat",
 ];
 
 /** Targets that support project scope */
 export const TARGETS_WITH_PROJECT_SCOPE: McpTarget[] = [
-  'claude-code',
-  'codex',
-  'cursor',
-  'opencode',
-  'librechat',
+  "claude-code",
+  "codex",
+  "cursor",
+  "opencode",
+  "librechat",
 ];
 
 /** Get config format for a target */
 export function getTargetConfigFormat(target: McpTarget): McpConfigFormat {
   switch (target) {
-    case 'zed':
-      return 'context_servers';
-    case 'opencode':
-      return 'mcp';
-    case 'amp':
-      return 'amp_mcp';
-    case 'librechat':
-      return 'yaml_standard';
+    case "zed":
+      return "context_servers";
+    case "opencode":
+      return "mcp";
+    case "amp":
+      return "amp_mcp";
+    case "librechat":
+      return "yaml_standard";
     default:
-      return 'standard';
+      return "standard";
   }
 }
 
@@ -123,18 +123,18 @@ const COMMANDS_PATH_PATTERN = /\/commands\/.*$/;
 function resolveClaudeDesktopPath(home: string): string {
   const plat = platform();
 
-  if (plat === 'darwin') {
+  if (plat === "darwin") {
     return join(
       home,
-      'Library/Application Support/Claude/claude_desktop_config.json'
+      "Library/Application Support/Claude/claude_desktop_config.json"
     );
   }
-  if (plat === 'win32') {
-    const appData = process.env.APPDATA || join(home, 'AppData/Roaming');
-    return join(appData, 'Claude/claude_desktop_config.json');
+  if (plat === "win32") {
+    const appData = process.env.APPDATA || join(home, "AppData/Roaming");
+    return join(appData, "Claude/claude_desktop_config.json");
   }
   // Linux and other Unix
-  return join(home, '.config/Claude/claude_desktop_config.json');
+  return join(home, ".config/Claude/claude_desktop_config.json");
 }
 
 /**
@@ -145,34 +145,34 @@ function resolveClaudeCodePath(
   home: string,
   cwd: string
 ): string {
-  if (scope === 'user') {
-    return join(home, '.claude.json');
+  if (scope === "user") {
+    return join(home, ".claude.json");
   }
-  return join(cwd, '.mcp.json');
+  return join(cwd, ".mcp.json");
 }
 
 /**
  * Resolve Codex config path.
  */
 function resolveCodexPath(scope: McpScope, home: string, cwd: string): string {
-  if (scope === 'user') {
-    return join(home, '.codex.json');
+  if (scope === "user") {
+    return join(home, ".codex.json");
   }
-  return join(cwd, '.codex/.mcp.json');
+  return join(cwd, ".codex/.mcp.json");
 }
 
 /**
  * Resolve Cursor config path.
  */
 function resolveCursorPath(scope: McpScope, home: string, cwd: string): string {
-  if (scope === 'user') {
+  if (scope === "user") {
     const plat = platform();
-    if (plat === 'win32') {
-      return join(home, '.cursor', 'mcp.json');
+    if (plat === "win32") {
+      return join(home, ".cursor", "mcp.json");
     }
-    return join(home, '.cursor/mcp.json');
+    return join(home, ".cursor/mcp.json");
   }
-  return join(cwd, '.cursor/mcp.json');
+  return join(cwd, ".cursor/mcp.json");
 }
 
 /**
@@ -180,16 +180,16 @@ function resolveCursorPath(scope: McpScope, home: string, cwd: string): string {
  */
 function resolveZedPath(home: string): string {
   const plat = platform();
-  if (plat === 'win32') {
+  if (plat === "win32") {
     // Zed not available on Windows, but provide path anyway
-    return join(home, '.config/zed/settings.json');
+    return join(home, ".config/zed/settings.json");
   }
   // macOS and Linux use XDG or fallback
   const xdgConfig = process.env.XDG_CONFIG_HOME;
   if (xdgConfig) {
-    return join(xdgConfig, 'zed/settings.json');
+    return join(xdgConfig, "zed/settings.json");
   }
-  return join(home, '.config/zed/settings.json');
+  return join(home, ".config/zed/settings.json");
 }
 
 /**
@@ -197,10 +197,10 @@ function resolveZedPath(home: string): string {
  */
 function resolveWindsurfPath(home: string): string {
   const plat = platform();
-  if (plat === 'win32') {
-    return join(home, '.codeium', 'windsurf', 'mcp_config.json');
+  if (plat === "win32") {
+    return join(home, ".codeium", "windsurf", "mcp_config.json");
   }
-  return join(home, '.codeium/windsurf/mcp_config.json');
+  return join(home, ".codeium/windsurf/mcp_config.json");
 }
 
 /**
@@ -211,15 +211,15 @@ function resolveOpenCodePath(
   home: string,
   cwd: string
 ): string {
-  if (scope === 'user') {
+  if (scope === "user") {
     const plat = platform();
-    if (plat === 'win32') {
-      return join(home, '.config', 'opencode', 'config.json');
+    if (plat === "win32") {
+      return join(home, ".config", "opencode", "config.json");
     }
-    return join(home, '.config/opencode/config.json');
+    return join(home, ".config/opencode/config.json");
   }
   // Project scope: opencode.json in project root
-  return join(cwd, 'opencode.json');
+  return join(cwd, "opencode.json");
 }
 
 /**
@@ -227,10 +227,10 @@ function resolveOpenCodePath(
  */
 function resolveAmpPath(home: string): string {
   const plat = platform();
-  if (plat === 'win32') {
-    return join(home, '.config', 'amp', 'settings.json');
+  if (plat === "win32") {
+    return join(home, ".config", "amp", "settings.json");
   }
-  return join(home, '.config/amp/settings.json');
+  return join(home, ".config/amp/settings.json");
 }
 
 /**
@@ -238,10 +238,10 @@ function resolveAmpPath(home: string): string {
  */
 function resolveLmStudioPath(home: string): string {
   const plat = platform();
-  if (plat === 'win32') {
-    return join(home, '.lmstudio', 'mcp.json');
+  if (plat === "win32") {
+    return join(home, ".lmstudio", "mcp.json");
   }
-  return join(home, '.lmstudio/mcp.json');
+  return join(home, ".lmstudio/mcp.json");
 }
 
 /**
@@ -249,7 +249,7 @@ function resolveLmStudioPath(home: string): string {
  * LibreChat uses librechat.yaml in project root (project scope only).
  */
 function resolveLibreChatPath(cwd: string): string {
-  return join(cwd, 'librechat.yaml');
+  return join(cwd, "librechat.yaml");
 }
 
 /**
@@ -258,7 +258,7 @@ function resolveLibreChatPath(cwd: string): string {
 export function resolveMcpConfigPath(opts: McpPathOptions): McpConfigPaths {
   const {
     target,
-    scope = 'user',
+    scope = "user",
     cwd = process.cwd(),
     homeDir = homedir(),
   } = opts;
@@ -267,61 +267,61 @@ export function resolveMcpConfigPath(opts: McpPathOptions): McpConfigPaths {
   const supportsProjectScope = TARGETS_WITH_PROJECT_SCOPE.includes(target);
 
   switch (target) {
-    case 'claude-desktop':
+    case "claude-desktop":
       return {
         configPath: resolveClaudeDesktopPath(homeDir),
         supportsProjectScope,
         configFormat,
       };
-    case 'claude-code':
+    case "claude-code":
       return {
         configPath: resolveClaudeCodePath(scope, homeDir, cwd),
         supportsProjectScope,
         configFormat,
       };
-    case 'codex':
+    case "codex":
       return {
         configPath: resolveCodexPath(scope, homeDir, cwd),
         supportsProjectScope,
         configFormat,
       };
-    case 'cursor':
+    case "cursor":
       return {
         configPath: resolveCursorPath(scope, homeDir, cwd),
         supportsProjectScope,
         configFormat,
       };
-    case 'zed':
+    case "zed":
       return {
         configPath: resolveZedPath(homeDir),
         supportsProjectScope,
         configFormat,
       };
-    case 'windsurf':
+    case "windsurf":
       return {
         configPath: resolveWindsurfPath(homeDir),
         supportsProjectScope,
         configFormat,
       };
-    case 'opencode':
+    case "opencode":
       return {
         configPath: resolveOpenCodePath(scope, homeDir, cwd),
         supportsProjectScope,
         configFormat,
       };
-    case 'amp':
+    case "amp":
       return {
         configPath: resolveAmpPath(homeDir),
         supportsProjectScope,
         configFormat,
       };
-    case 'lmstudio':
+    case "lmstudio":
       return {
         configPath: resolveLmStudioPath(homeDir),
         supportsProjectScope,
         configFormat,
       };
-    case 'librechat':
+    case "librechat":
       return {
         configPath: resolveLibreChatPath(cwd),
         supportsProjectScope,
@@ -329,7 +329,7 @@ export function resolveMcpConfigPath(opts: McpPathOptions): McpConfigPaths {
       };
     default: {
       const _exhaustive: never = target;
-      throw new Error(`Unknown target: ${_exhaustive}`);
+      throw new Error(`Unknown target: ${String(_exhaustive)}`);
     }
   }
 }
@@ -338,11 +338,11 @@ export function resolveMcpConfigPath(opts: McpPathOptions): McpConfigPaths {
  * Resolve paths for all targets.
  */
 export function resolveAllMcpPaths(
-  scope: McpScope | 'all' = 'all',
-  target: McpTarget | 'all' = 'all',
+  scope: McpScope | "all" = "all",
+  target: McpTarget | "all" = "all",
   overrides?: { cwd?: string; homeDir?: string }
 ): Array<{ target: McpTarget; scope: McpScope; paths: McpConfigPaths }> {
-  const targets: McpTarget[] = target === 'all' ? MCP_TARGETS : [target];
+  const targets: McpTarget[] = target === "all" ? MCP_TARGETS : [target];
   const results: Array<{
     target: McpTarget;
     scope: McpScope;
@@ -355,7 +355,7 @@ export function resolveAllMcpPaths(
     if (supportsProject) {
       // Targets that support both scopes
       const scopes: McpScope[] =
-        scope === 'all' ? ['user', 'project'] : [scope];
+        scope === "all" ? ["user", "project"] : [scope];
       for (const s of scopes) {
         results.push({
           target: t,
@@ -365,13 +365,13 @@ export function resolveAllMcpPaths(
       }
     } else {
       // User scope only - skip if filtering by project
-      if (scope === 'project') {
+      if (scope === "project") {
         continue;
       }
       results.push({
         target: t,
-        scope: 'user',
-        paths: resolveMcpConfigPath({ target: t, scope: 'user', ...overrides }),
+        scope: "user",
+        paths: resolveMcpConfigPath({ target: t, scope: "user", ...overrides }),
       });
     }
   }
@@ -401,40 +401,40 @@ export function findBunPath(): string {
 export function buildMcpServerEntry(): McpServerEntry {
   const bunPath = findBunPath();
   const home = homedir();
-  const isWindows = platform() === 'win32';
+  const isWindows = platform() === "win32";
 
   // 1. Check if running from source (dev mode)
   const scriptPath = process.argv[1];
   if (
-    scriptPath?.includes('/gno/src/cli/') ||
-    scriptPath?.includes('\\gno\\src\\cli\\')
+    scriptPath?.includes("/gno/src/cli/") ||
+    scriptPath?.includes("\\gno\\src\\cli\\")
   ) {
     // Dev mode: run the entry script directly with bun
-    const entryScript = scriptPath.replace(COMMANDS_PATH_PATTERN, '/index.ts');
-    return { command: bunPath, args: ['run', entryScript, 'mcp'] };
+    const entryScript = scriptPath.replace(COMMANDS_PATH_PATTERN, "/index.ts");
+    return { command: bunPath, args: ["run", entryScript, "mcp"] };
   }
 
   // 2. Check common gno install locations (cross-platform)
   const gnoCandidates = isWindows
     ? [
-        join(home, '.bun\\bin\\gno.exe'),
-        join(home, 'AppData\\Roaming\\npm\\gno.cmd'),
+        join(home, ".bun\\bin\\gno.exe"),
+        join(home, "AppData\\Roaming\\npm\\gno.cmd"),
       ]
     : [
-        join(home, '.bun/bin/gno'),
-        '/usr/local/bin/gno',
-        '/opt/homebrew/bin/gno',
+        join(home, ".bun/bin/gno"),
+        "/usr/local/bin/gno",
+        "/opt/homebrew/bin/gno",
       ];
 
   for (const gnoPath of gnoCandidates) {
     if (existsSync(gnoPath)) {
-      return { command: bunPath, args: [gnoPath, 'mcp'] };
+      return { command: bunPath, args: [gnoPath, "mcp"] };
     }
   }
 
   // 3. Fallback to bunx (works if gno is published to npm)
   // Note: This may trigger network access on first run
-  return { command: bunPath, args: ['x', '@gmickel/gno', 'mcp'] };
+  return { command: bunPath, args: ["x", "@gmickel/gno", "mcp"] };
 }
 
 /**
@@ -442,29 +442,29 @@ export function buildMcpServerEntry(): McpServerEntry {
  */
 export function getTargetDisplayName(target: McpTarget): string {
   switch (target) {
-    case 'claude-desktop':
-      return 'Claude Desktop';
-    case 'claude-code':
-      return 'Claude Code';
-    case 'codex':
-      return 'Codex';
-    case 'cursor':
-      return 'Cursor';
-    case 'zed':
-      return 'Zed';
-    case 'windsurf':
-      return 'Windsurf';
-    case 'opencode':
-      return 'OpenCode';
-    case 'amp':
-      return 'Amp';
-    case 'lmstudio':
-      return 'LM Studio';
-    case 'librechat':
-      return 'LibreChat';
+    case "claude-desktop":
+      return "Claude Desktop";
+    case "claude-code":
+      return "Claude Code";
+    case "codex":
+      return "Codex";
+    case "cursor":
+      return "Cursor";
+    case "zed":
+      return "Zed";
+    case "windsurf":
+      return "Windsurf";
+    case "opencode":
+      return "OpenCode";
+    case "amp":
+      return "Amp";
+    case "lmstudio":
+      return "LM Studio";
+    case "librechat":
+      return "LibreChat";
     default: {
       const _exhaustive: never = target;
-      throw new Error(`Unknown target: ${_exhaustive}`);
+      throw new Error(`Unknown target: ${String(_exhaustive)}`);
     }
   }
 }