@snapback/cli 1.1.12 → 1.1.14

package/README.md

@@ -1,10 +1,10 @@
-# @snapback/cli
-
-> **Git is for commits. SnapBack is for "oh no, what did I just do?"**
+<p align="center">
+  <img src="./assets/github-cli.png" alt="SnapBack CLI - The command-line interface for effortless restores and snapshots" />
+</p>
 
 [![npm version](https://img.shields.io/npm/v/@snapback/cli.svg)](https://www.npmjs.com/package/@snapback/cli)
 [![npm downloads](https://img.shields.io/npm/dm/@snapback/cli.svg)](https://www.npmjs.com/package/@snapback/cli)
-[![License](https://img.shields.io/npm/l/@snapback/cli.svg)](https://github.com/snapback-dev/snapback/blob/main/LICENSE)
+[![License](https://img.shields.io/npm/l/@snapback/cli.svg)](https://github.com/snapback-dev/snapback-cli/blob/main/LICENSE)
 
 AI coding assistants like **Cursor**, **GitHub Copilot**, and **Claude** are incredible—until they're not. One wrong autocomplete can cascade into hours of debugging. Git doesn't help because you haven't committed yet.
 
@@ -38,12 +38,12 @@ SnapBack has two primary interfaces:
 The extension provides the best experience with automatic snapshots, visual recovery UI, and real-time risk indicators.
 
 ```
-ext install snapback-vscode
+ext install MarcelleLabs.snapback-vscode
 ```
 
 Or search "SnapBack" in the VS Code Extensions marketplace.
 
-[![VS Code Marketplace](https://img.shields.io/visual-studio-marketplace/v/snapback.snapback-vscode.svg)](https://marketplace.visualstudio.com/items?itemName=snapback.snapback-vscode)
+[![VS Code Marketplace](https://img.shields.io/visual-studio-marketplace/v/MarcelleLabs.snapback-vscode.svg)](https://marketplace.visualstudio.com/items?itemName=MarcelleLabs.snapback-vscode)
 
 ### 💻 CLI Tool
 
@@ -572,7 +572,7 @@ $ snap doctor
 
 | Package | Description |
 |---------|-------------|
-| [snapback-vscode](https://marketplace.visualstudio.com/items?itemName=snapback.snapback-vscode) | VS Code extension with visual UI |
+| [MarcelleLabs.snapback-vscode](https://marketplace.visualstudio.com/items?itemName=MarcelleLabs.snapback-vscode) | VS Code extension with visual UI |
 
 ---
 
@@ -586,7 +586,7 @@ Unlock Pro features like checkpoint creation and restoration:
 
 ## License
 
-[Apache-2.0](https://github.com/snapback-dev/snapback/blob/main/LICENSE)
+[Apache-2.0](https://github.com/snapback-dev/snapback-cli/blob/main/LICENSE)
 
 ---
 
@@ -595,5 +595,5 @@ Unlock Pro features like checkpoint creation and restoration:
   <a href="https://snapback.dev">Website</a> ·
   <a href="https://docs.snapback.dev">Docs</a> ·
   <a href="https://console.snapback.dev">Dashboard</a> ·
-  <a href="https://discord.gg/snapback">Discord</a>
+  <a href="https://discord.gg/B4BXeYkE2F">Discord</a>
 </p>

package/dist/{analysis-Z53F5FT2.js → analysis-C6XVLBAL.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-export { ChangeImpactAnalyzer, CompletenessAnalyzer, SecurityAnalyzer, SyntaxAnalyzer, checkFilesForOrphanStatus, createChangeImpactAnalyzer, detectOrphans, filterOrphansToFiles, runStaticAnalysis } from './chunk-G7QXHNGB.js';
+export { ChangeImpactAnalyzer, CompletenessAnalyzer, SecurityAnalyzer, SyntaxAnalyzer, checkFilesForOrphanStatus, createChangeImpactAnalyzer, detectOrphans, filterOrphansToFiles, runStaticAnalysis } from './chunk-OJNDAPC2.js';
 export { analyzeSkippedTests, detectSkippedTests, getSkippedTestSummary } from './chunk-QAKFE3NE.js';
 import './chunk-BW7RALUZ.js';
-//# sourceMappingURL=analysis-Z53F5FT2.js.map
-//# sourceMappingURL=analysis-Z53F5FT2.js.map
+//# sourceMappingURL=analysis-C6XVLBAL.js.map
+//# sourceMappingURL=analysis-C6XVLBAL.js.map

package/dist/{analysis-Z53F5FT2.js.map → analysis-C6XVLBAL.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"analysis-Z53F5FT2.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"analysis-C6XVLBAL.js"}

package/dist/{chunk-KPETDXQO.js → chunk-2TOJVUVJ.js}

@@ -4,7 +4,8 @@ import { existsSync, readFileSync, mkdirSync, writeFileSync } from 'fs';
 import { homedir, platform } from 'os';
 import { join, resolve, dirname } from 'path';
 import { randomUUID } from 'crypto';
-import { execSync } from 'child_process';
+import { exec, execSync } from 'child_process';
+import { promisify } from 'util';
 
 var __defProp = Object.defineProperty;
 var __name2 = /* @__PURE__ */ __name((target, value) => __defProp(target, "name", {
@@ -35,7 +36,10 @@ var CLIENT_CONFIGS = {
     ] : [],
     join(_home, ".cursor/mcp.json")
   ], "cursor"),
-  windsurf: /* @__PURE__ */ __name2((home) => [
+  windsurf: /* @__PURE__ */ __name2((home, cwd) => [
+    ...cwd ? [
+      join(cwd, ".windsurf/mcp.json")
+    ] : [],
     join(home, ".codeium/windsurf/mcp_config.json")
   ], "windsurf"),
   continue: /* @__PURE__ */ __name2((home) => [
@@ -63,21 +67,24 @@ var CLIENT_CONFIGS = {
     join(home, ".roo-code/mcp.json")
   ], "roo-code"),
   // Qoder (VS Code fork) - supports both project-level and global configs
-  qoder: /* @__PURE__ */ __name2((home) => {
-    switch (platform()) {
-      case "darwin":
-        return [
-          join(home, "Library/Application Support/Qoder/SharedClientCache/extension/local/mcp.json")
-        ];
-      case "win32":
-        return [
-          join(process.env.APPDATA || "", "Qoder/mcp.json")
-        ];
-      default:
-        return [
-          join(home, ".config/Qoder/mcp.json")
-        ];
-    }
+  qoder: /* @__PURE__ */ __name2((home, cwd) => {
+    const workspaceConfig = cwd ? [
+      join(cwd, ".qoder-mcp-config.json")
+    ] : [];
+    const globalConfig = (() => {
+      switch (platform()) {
+        case "darwin":
+          return join(home, "Library/Application Support/Qoder/SharedClientCache/extension/local/mcp.json");
+        case "win32":
+          return join(process.env.APPDATA || "", "Qoder/mcp.json");
+        default:
+          return join(home, ".config/Qoder/mcp.json");
+      }
+    })();
+    return [
+      ...workspaceConfig,
+      globalConfig
+    ];
   }, "qoder")
 };
 var CLIENT_DISPLAY_NAMES = {
@@ -160,20 +167,29 @@ function checkForSnapback(config, format) {
     case "claude":
     case "cursor":
     case "windsurf":
-    case "vscode":
     case "cline":
     case "roo-code":
     case "qoder":
       if ("mcpServers" in configObj && typeof configObj.mcpServers === "object" && configObj.mcpServers !== null) {
         const servers = configObj.mcpServers;
-        return "snapback" in servers;
+        return "snapback" in servers || `snapback-${format}` in servers;
+      }
+      return false;
+    case "vscode":
+      if ("servers" in configObj && typeof configObj.servers === "object" && configObj.servers !== null) {
+        const servers = configObj.servers;
+        return "snapback" in servers || "snapback-vscode" in servers;
       }
       return false;
     case "gemini":
     case "zed":
+      if ("context_servers" in configObj && typeof configObj.context_servers === "object" && configObj.context_servers !== null) {
+        const servers = configObj.context_servers;
+        return "snapback" in servers || "snapback-zed" in servers;
+      }
       if ("mcpServers" in configObj && typeof configObj.mcpServers === "object" && configObj.mcpServers !== null) {
         const servers = configObj.mcpServers;
-        return "snapback" in servers;
+        return "snapback" in servers || `snapback-${format}` in servers;
       }
       return false;
     case "continue":
@@ -212,6 +228,64 @@ function readClientConfig(client) {
 }
 __name(readClientConfig, "readClientConfig");
 __name2(readClientConfig, "readClientConfig");
+function detectWorkspaceConfig(workspaceRoot) {
+  const root = workspaceRoot || process.cwd();
+  const qoderConfig = join(root, ".qoder-mcp-config.json");
+  if (existsSync(qoderConfig)) {
+    try {
+      const content = readFileSync(qoderConfig, "utf-8");
+      if (content.includes("snapback")) {
+        return {
+          path: qoderConfig,
+          type: "qoder"
+        };
+      }
+    } catch {
+    }
+  }
+  const cursorConfig = join(root, ".cursor", "mcp.json");
+  if (existsSync(cursorConfig)) {
+    try {
+      const content = readFileSync(cursorConfig, "utf-8");
+      if (content.includes("snapback")) {
+        return {
+          path: cursorConfig,
+          type: "cursor"
+        };
+      }
+    } catch {
+    }
+  }
+  const vscodeConfig = join(root, ".vscode", "mcp.json");
+  if (existsSync(vscodeConfig)) {
+    try {
+      const content = readFileSync(vscodeConfig, "utf-8");
+      if (content.includes("snapback")) {
+        return {
+          path: vscodeConfig,
+          type: "vscode"
+        };
+      }
+    } catch {
+    }
+  }
+  const windsurfConfig = join(root, ".windsurf", "mcp.json");
+  if (existsSync(windsurfConfig)) {
+    try {
+      const content = readFileSync(windsurfConfig, "utf-8");
+      if (content.includes("snapback")) {
+        return {
+          path: windsurfConfig,
+          type: "windsurf"
+        };
+      }
+    } catch {
+    }
+  }
+  return null;
+}
+__name(detectWorkspaceConfig, "detectWorkspaceConfig");
+__name2(detectWorkspaceConfig, "detectWorkspaceConfig");
 function getSnapbackConfigDir() {
   const isWindows = process.platform === "win32";
   if (isWindows) {
@@ -308,6 +382,90 @@ function resetIdentityCache() {
 }
 __name(resetIdentityCache, "resetIdentityCache");
 __name2(resetIdentityCache, "resetIdentityCache");
+var execAsync = promisify(exec);
+async function detectMCPProcesses() {
+  try {
+    const { stdout } = await execAsync('ps aux | grep -E "(mcp.*--stdio|--stdio.*mcp|uvx.*mcp-server|npx.*mcp|node.*mcp)" | grep -v grep', {
+      timeout: 5e3
+    });
+    const processes = parseProcessOutput(stdout);
+    const snapbackProcesses = processes.filter((p) => p.isSnapback);
+    return {
+      allProcesses: processes,
+      snapbackProcesses,
+      snapbackRunning: snapbackProcesses.length > 0,
+      totalCount: processes.length,
+      checkedAt: /* @__PURE__ */ new Date()
+    };
+  } catch {
+    return {
+      allProcesses: [],
+      snapbackProcesses: [],
+      snapbackRunning: false,
+      totalCount: 0,
+      checkedAt: /* @__PURE__ */ new Date()
+    };
+  }
+}
+__name(detectMCPProcesses, "detectMCPProcesses");
+__name2(detectMCPProcesses, "detectMCPProcesses");
+function parseProcessOutput(output) {
+  const lines = output.trim().split("\n").filter((line) => line.trim());
+  const processes = [];
+  for (const line of lines) {
+    const match = line.match(/^(\S+)\s+(\d+)\s+.*?\s+(.+)$/);
+    if (!match) {
+      continue;
+    }
+    const [, , pidStr, command] = match;
+    const pid = Number.parseInt(pidStr, 10);
+    if (Number.isNaN(pid)) {
+      continue;
+    }
+    const serverName = extractServerName(command);
+    const isSnapback = command.toLowerCase().includes("snapback");
+    processes.push({
+      pid,
+      command: command.trim(),
+      serverName,
+      isSnapback
+    });
+  }
+  return processes;
+}
+__name(parseProcessOutput, "parseProcessOutput");
+__name2(parseProcessOutput, "parseProcessOutput");
+function extractServerName(command) {
+  const patterns = [
+    // snapback mcp --stdio
+    /snapback[/\s]/i,
+    // mcp-server-fetch
+    /mcp-server-(\w+)/,
+    // @modelcontextprotocol/server-sequential-thinking
+    /server-(\w+)/,
+    // context7-mcp
+    /(\w+)-mcp/,
+    // fly mcp server
+    /fly.*mcp/i,
+    // supabase-mcp
+    /supabase-mcp/i
+  ];
+  for (const pattern of patterns) {
+    const match = command.match(pattern);
+    if (match) {
+      return match[1] || match[0];
+    }
+  }
+  return "mcp";
+}
+__name(extractServerName, "extractServerName");
+__name2(extractServerName, "extractServerName");
+async function isSnapbackMCPRunning() {
+  const health = await detectMCPProcesses();
+  return health.snapbackRunning;
+}
+__name(isSnapbackMCPRunning, "isSnapbackMCPRunning");
+__name2(isSnapbackMCPRunning, "isSnapbackMCPRunning");
 function validateClientConfig(client) {
   const issues = [];
   if (!existsSync(client.configPath)) {
@@ -504,7 +662,15 @@ function validateSnapbackConfig(config, issues) {
           severity: "error",
           code: "MISSING_STDIO_ARG",
           message: "Args must include '--stdio' flag",
-          fix: "Run: snap tools configure --force"
+          fix: "Run: snap mcp repair --client <name>"
+        });
+      }
+      if (config.args.includes("shim")) {
+        issues.push({
+          severity: "error",
+          code: "DEPRECATED_SHIM_COMMAND",
+          message: "Args contain deprecated 'shim' command - use '--stdio' instead",
+          fix: "Run: snap mcp repair --client <name>"
         });
       }
       if (!config.args.includes("--workspace")) {
@@ -623,8 +789,12 @@ function isCommandExecutable2(command) {
 }
 __name(isCommandExecutable2, "isCommandExecutable2");
 __name2(isCommandExecutable2, "isCommandExecutable");
+var STDIO_ONLY_CLIENTS = /* @__PURE__ */ new Set([
+  "claude"
+]);
 function getSnapbackMCPConfig(options = {}) {
-  const { apiKey, workspaceId, serverUrl, useNpx = false, useBinary = false, customCommand, additionalEnv, workspaceRoot, useLocalDev = false, localCliPath } = options;
+  const { apiKey, workspaceId, serverUrl, useBinary = false, customCommand, additionalEnv, workspaceRoot, useLocalDev = false, localCliPath, client } = options;
+  const useNpx = options.useNpx ?? (client ? STDIO_ONLY_CLIENTS.has(client) : false);
   const env = {
     ...additionalEnv
   };
@@ -773,6 +943,10 @@ function removeSnapbackConfig(client) {
       case "claude":
       case "cursor":
       case "windsurf":
+      case "cline":
+      case "roo-code":
+      case "gemini":
+      case "qoder":
         if (config.mcpServers?.[serverKey]) {
           delete config.mcpServers[serverKey];
         }
@@ -780,6 +954,28 @@ function removeSnapbackConfig(client) {
           delete config.mcpServers.snapback;
         }
         break;
+      case "vscode": {
+        const vscodeConfig = config;
+        const servers = vscodeConfig.servers;
+        if (servers?.[serverKey]) {
+          delete servers[serverKey];
+        }
+        if (servers?.snapback) {
+          delete servers.snapback;
+        }
+        break;
+      }
+      case "zed": {
+        const zedConfig = config;
+        const contextServers = zedConfig.context_servers;
+        if (contextServers?.[serverKey]) {
+          delete contextServers[serverKey];
+        }
+        if (contextServers?.snapback) {
+          delete contextServers.snapback;
+        }
+        break;
+      }
       case "continue": {
         const experimental = config.experimental;
         if (experimental?.modelContextProtocolServers) {
@@ -815,20 +1011,66 @@ function mergeConfig(existing, snapbackConfig, format) {
   switch (format) {
     case "claude":
     case "cursor":
-    case "windsurf":
-    case "vscode":
     case "cline":
     case "roo-code":
     case "gemini":
-    case "zed":
+      return {
+        ...existing,
+        mcpServers: {
+          ...existing.mcpServers || {},
+          [serverKey]: snapbackConfig
+        }
+      };
+    case "windsurf":
+      return {
+        ...existing,
+        mcpServers: {
+          ...existing.mcpServers || {},
+          [serverKey]: {
+            ...snapbackConfig,
+            disabled: false,
+            alwaysAllow: []
+          }
+        }
+      };
     case "qoder":
       return {
         ...existing,
         mcpServers: {
           ...existing.mcpServers || {},
+          [serverKey]: {
+            type: "stdio",
+            ...snapbackConfig
+          }
+        }
+      };
+    case "vscode": {
+      const vscodeConfig = existing;
+      const servers = vscodeConfig.servers || {};
+      const { mcpServers: _, ...rest } = vscodeConfig;
+      return {
+        ...rest,
+        servers: {
+          ...servers,
+          [serverKey]: {
+            type: "stdio",
+            ...snapbackConfig
+          }
+        }
+      };
+    }
+    case "zed": {
+      const zedConfig = existing;
+      const contextServers = zedConfig.context_servers || {};
+      const { mcpServers: _, ...rest } = zedConfig;
+      return {
+        ...rest,
+        context_servers: {
+          ...contextServers,
           [serverKey]: snapbackConfig
         }
       };
+    }
     case "continue": {
       const continueConfig = existing;
       const experimental = continueConfig.experimental || {};
@@ -872,15 +1114,33 @@ function validateConfig(client) {
       case "claude":
       case "cursor":
       case "windsurf":
-      case "vscode":
       case "cline":
       case "roo-code":
       case "gemini":
-      case "zed":
       case "qoder": {
         const serverConfig = config.mcpServers?.[serverKey] || config.mcpServers?.snapback;
         return Boolean(serverConfig?.command || serverConfig?.url);
       }
+      case "vscode": {
+        const vscodeConfig = config;
+        const servers = vscodeConfig.servers;
+        const serverConfig = servers?.[serverKey] || servers?.snapback;
+        if (typeof serverConfig === "object" && serverConfig !== null) {
+          const cfg = serverConfig;
+          return Boolean(cfg.command || cfg.url);
+        }
+        return false;
+      }
+      case "zed": {
+        const zedConfig = config;
+        const contextServers = zedConfig.context_servers;
+        const serverConfig = contextServers?.[serverKey] || contextServers?.snapback;
+        if (typeof serverConfig === "object" && serverConfig !== null) {
+          const cfg = serverConfig;
+          return Boolean(cfg.command || cfg.url);
+        }
+        return false;
+      }
       case "continue": {
         const expCfg = config.experimental;
         const srvs = expCfg?.modelContextProtocolServers;
@@ -1007,6 +1267,7 @@ function attemptFix(client, issue, _validation, options) {
     case "MISSING_ARGS":
     case "MISSING_MCP_ARG":
     case "MISSING_STDIO_ARG":
+    case "DEPRECATED_SHIM_COMMAND":
     case "INVALID_URL":
       return performFullReconfiguration(client, options);
     case "COMMAND_NOT_EXECUTABLE": {
@@ -1072,7 +1333,8 @@ function performFullReconfiguration(client, options) {
         workspaceId: options.workspaceId,
         workspaceRoot,
         useLocalDev: true,
-        localCliPath: cliPath
+        localCliPath: cliPath,
+        client: client.format
       });
       const nodePath = resolveNodePath();
       console.error(`[MCP Repair] Using node path: ${nodePath}`);
@@ -1080,9 +1342,10 @@ function performFullReconfiguration(client, options) {
       mcpConfig = getSnapbackMCPConfig({
         apiKey: options.apiKey,
         workspaceId: options.workspaceId,
-        useLocalDev: false
+        useLocalDev: false,
+        client: client.format
       });
-      console.error("[MCP Repair] Using remote HTTP mode (CLI not found locally)");
+      console.error("[MCP Repair] Using default mode (CLI not found locally)");
     }
     const writeResult = writeClientConfig(client, mcpConfig);
     if (writeResult.success) {
@@ -1155,6 +1418,6 @@ function findCliPath() {
 __name(findCliPath, "findCliPath");
 __name2(findCliPath, "findCliPath");
 
-export { createManagedMetadata, detectAIClients, getClient, getClientConfigPath, getConfiguredClients, getOrCreateIdentity, getServerKey, getSnapbackConfigDir, getSnapbackMCPConfig, injectWorkspacePath, isCommandExecutable2, isOwnedByThisInstall, readClientConfig, removeSnapbackConfig, repairClientConfig, resetIdentityCache, resolveNodePath, validateClientConfig, validateConfig, validateWorkspacePath, writeClientConfig };
-//# sourceMappingURL=chunk-KPETDXQO.js.map
-//# sourceMappingURL=chunk-KPETDXQO.js.map
+export { createManagedMetadata, detectAIClients, detectMCPProcesses, detectWorkspaceConfig, getClient, getClientConfigPath, getConfiguredClients, getOrCreateIdentity, getServerKey, getSnapbackConfigDir, getSnapbackMCPConfig, injectWorkspacePath, isCommandExecutable2, isOwnedByThisInstall, isSnapbackMCPRunning, readClientConfig, removeSnapbackConfig, repairClientConfig, resetIdentityCache, resolveNodePath, validateClientConfig, validateConfig, validateWorkspacePath, writeClientConfig };
+//# sourceMappingURL=chunk-2TOJVUVJ.js.map
+//# sourceMappingURL=chunk-2TOJVUVJ.js.map