@bastani/atomic 0.8.31-alpha.4 → 0.9.0-alpha.1

package/dist/builtin/mcp/config.ts

@@ -1,18 +1,17 @@
 // config.ts - Config loading with import support
-import { existsSync, readFileSync, writeFileSync, mkdirSync, renameSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { CONFIG_DIR_NAME, getProjectConfigPaths } from "@bastani/atomic";
 import { getAgentPath, getAgentPaths } from "./agent-dir.ts";
 import type { McpConfig, ServerEntry, McpSettings, ImportKind, ServerProvenance } from "./types.ts";
+import { buildConfigWritePreview, getServersObject, readRawConfigObject, setServersObject, writeRawConfigObject, type ConfigWritePreview } from "./config-write-utils.ts";
+export type { ConfigWritePreview } from "./config-write-utils.ts";
 
 const GENERIC_GLOBAL_CONFIG_PATH = join(homedir(), ".config", "mcp", "mcp.json");
 const PROJECT_CONFIG_NAME = ".mcp.json";
 const PROJECT_PI_CONFIG_NAME = `${CONFIG_DIR_NAME}/mcp.json`;
-const REPOPROMPT_BINARY_CANDIDATES = [
-  join(homedir(), "RepoPrompt", "repoprompt_cli"),
-  "/Applications/Repo Prompt.app/Contents/MacOS/repoprompt-mcp",
-];
+const REPOPROMPT_BINARY_CANDIDATES = [join(homedir(), "RepoPrompt", "repoprompt_cli"), "/Applications/Repo Prompt.app/Contents/MacOS/repoprompt-mcp"];
 
 const IMPORT_PATHS: Record<ImportKind, string[]> = {
   cursor: [join(homedir(), ".cursor", "mcp.json")],
@@ -59,7 +58,6 @@ export interface ConfigDiscoverySource extends ConfigDiscoveryPath {
 export interface ImportConfigSummary extends DiscoveredImportConfig {
   serverCount: number;
 }
-
 export interface RepoPromptDiscovery {
   configured: boolean;
   configuredPath?: string;
@@ -68,7 +66,6 @@ export interface RepoPromptDiscovery {
   serverName?: string;
   entry?: ServerEntry;
 }
-
 export interface McpDiscoverySummary {
   sources: ConfigDiscoverySource[];
   imports: ImportConfigSummary[];
@@ -80,36 +77,21 @@ export interface McpDiscoverySummary {
   fingerprint: string;
   repoPrompt: RepoPromptDiscovery;
 }
-
-export interface ConfigWritePreview {
-  path: string;
-  existed: boolean;
-  changed: boolean;
-  beforeText: string;
-  afterText: string;
-  diffText: string;
-}
-
 export function getPiGlobalConfigPath(overridePath?: string): string {
   return overridePath ? resolve(overridePath) : getAgentPath("mcp.json");
 }
-
 export function getGenericGlobalConfigPath(): string {
   return GENERIC_GLOBAL_CONFIG_PATH;
 }
-
 export function getProjectConfigPath(cwd = process.cwd()): string {
   return resolve(cwd, PROJECT_CONFIG_NAME);
 }
-
 export function getProjectPiConfigPath(cwd = process.cwd()): string {
   return resolve(cwd, PROJECT_PI_CONFIG_NAME);
 }
-
 function getProjectPiConfigPaths(cwd = process.cwd()): string[] {
   return getProjectConfigPaths(cwd, "mcp.json").map((p) => resolve(p));
 }
-
 export function getConfigDiscoveryPaths(overridePath?: string, cwd = process.cwd()): ConfigDiscoveryPath[] {
   return getConfigSources(overridePath, cwd).map((source) => ({
     label: source.label,
@@ -117,20 +99,16 @@ export function getConfigDiscoveryPaths(overridePath?: string, cwd = process.cwd
     exists: existsSync(source.readPath),
   }));
 }
-
 export function findAvailableImportConfigs(cwd = process.cwd()): DiscoveredImportConfig[] {
   const discovered: DiscoveredImportConfig[] = [];
-
   for (const importKind of Object.keys(IMPORT_PATHS) as ImportKind[]) {
     const importPath = resolveImportPath(importKind, cwd);
     if (importPath) {
       discovered.push({ kind: importKind, path: importPath });
     }
   }
-
   return discovered;
 }
-
 export function getMcpDiscoverySummary(overridePath?: string, cwd = process.cwd()): McpDiscoverySummary {
   const sources = getConfigSources(overridePath, cwd).map((source) => {
     const loaded = readValidatedConfig(source.readPath, `MCP config from ${source.readPath}`);
@@ -144,7 +122,6 @@ export function getMcpDiscoverySummary(overridePath?: string, cwd = process.cwd(
       serverCount: loaded ? Object.keys(loaded.mcpServers).length : 0,
     } satisfies ConfigDiscoverySource;
   });
-
   const imports = (Object.keys(IMPORT_PATHS) as ImportKind[])
     .map((kind) => {
       const path = resolveImportPath(kind, cwd);
@@ -156,13 +133,11 @@ export function getMcpDiscoverySummary(overridePath?: string, cwd = process.cwd(
       } satisfies ImportConfigSummary;
     })
     .filter((value): value is ImportConfigSummary => value !== null);
-
   const totalServerCount = sources.reduce((sum, source) => sum + source.serverCount, 0);
   const hasSharedServers = sources.some((source) => source.kind === "shared" && source.serverCount > 0);
   const hasPiOwnedServers = sources.some((source) => source.kind === "pi" && source.serverCount > 0);
   const hasAnyDetectedPaths = sources.some((source) => source.exists) || imports.length > 0;
   const hasAnyConfig = totalServerCount > 0 || imports.some((entry) => entry.serverCount > 0) || hasAnyDetectedPaths;
-
   const summaryWithoutRepoPrompt = {
     sources,
     imports,
@@ -172,38 +147,31 @@ export function getMcpDiscoverySummary(overridePath?: string, cwd = process.cwd(
     hasPiOwnedServers,
     totalServerCount,
   };
-
   const fingerprint = JSON.stringify({
     sources: sources.map((source) => [source.id, source.exists, source.serverCount]),
     imports: imports.map((entry) => [entry.kind, entry.path, entry.serverCount]),
   });
-
   return {
     ...summaryWithoutRepoPrompt,
     fingerprint,
     repoPrompt: detectRepoPrompt(summaryWithoutRepoPrompt, cwd),
   };
 }
-
 export function loadMcpConfig(overridePath?: string, cwd = process.cwd()): McpConfig {
   let config: McpConfig = { mcpServers: {} };
-
   for (const source of getConfigSources(overridePath, cwd)) {
     const loaded = readValidatedConfig(source.readPath, `MCP config from ${source.readPath}`);
     if (!loaded) continue;
     config = mergeConfigs(config, expandImports(loaded, cwd));
   }
-
   return config;
 }
-
 function getConfigSources(overridePath?: string, cwd = process.cwd()): ConfigSourceSpec[] {
   const userPath = getPiGlobalConfigPath(overridePath);
   const userPaths = overridePath ? [userPath] : getAgentPaths("mcp.json");
   const projectPath = getProjectConfigPath(cwd);
   const projectPiPaths = getProjectPiConfigPaths(cwd);
   const sources: ConfigSourceSpec[] = [];
-
   if (GENERIC_GLOBAL_CONFIG_PATH !== userPath) {
     sources.push({
       id: "shared-global",
@@ -216,7 +184,6 @@ function getConfigSources(overridePath?: string, cwd = process.cwd()): ConfigSou
       scope: "global",
     });
   }
-
   for (const readPath of userPaths.reverse()) {
     sources.push({
       id: "pi-global",
@@ -228,7 +195,6 @@ function getConfigSources(overridePath?: string, cwd = process.cwd()): ConfigSou
       scope: "global",
     });
   }
-
   if (projectPath !== userPath) {
     sources.push({
       id: "shared-project",
@@ -240,7 +206,6 @@ function getConfigSources(overridePath?: string, cwd = process.cwd()): ConfigSou
       scope: "project",
     });
   }
-
   for (const projectPiPath of projectPiPaths.reverse()) {
     if (projectPiPath !== userPath && projectPiPath !== projectPath) {
       sources.push({
@@ -254,10 +219,8 @@ function getConfigSources(overridePath?: string, cwd = process.cwd()): ConfigSou
       });
     }
   }
-
   return sources;
 }
-
 function mergeConfigs(base: McpConfig, next: McpConfig): McpConfig {
   return {
     mcpServers: { ...base.mcpServers, ...next.mcpServers },
@@ -265,21 +228,17 @@ function mergeConfigs(base: McpConfig, next: McpConfig): McpConfig {
     settings: next.settings ? { ...base.settings, ...next.settings } : base.settings,
   };
 }
-
 function mergeImports(left: ImportKind[] | undefined, right: ImportKind[] | undefined): ImportKind[] | undefined {
   const merged = [...(left ?? []), ...(right ?? [])];
   if (merged.length === 0) return undefined;
   return [...new Set(merged)];
 }
-
 function expandImports(config: McpConfig, cwd = process.cwd()): McpConfig {
   if (!config.imports?.length) return config;
-
   const importedServers: Record<string, ServerEntry> = {};
   for (const importKind of config.imports) {
     const importPath = resolveImportPath(importKind, cwd);
     if (!importPath) continue;
-
     try {
       const imported = JSON.parse(readFileSync(importPath, "utf-8"));
       const servers = extractServers(imported, importKind);
@@ -292,14 +251,12 @@ function expandImports(config: McpConfig, cwd = process.cwd()): McpConfig {
       console.warn(`Failed to import MCP config from ${importKind}:`, error);
     }
   }
-
   return {
     imports: config.imports,
     settings: config.settings,
     mcpServers: { ...importedServers, ...config.mcpServers },
   };
 }
-
 function resolveImportPath(importKind: ImportKind, cwd = process.cwd()): string | null {
   const candidates = IMPORT_PATHS[importKind] ?? [];
   for (const candidate of candidates) {
@@ -310,7 +267,6 @@ function resolveImportPath(importKind: ImportKind, cwd = process.cwd()): string
   }
   return null;
 }
-
 function getImportServerCount(importKind: ImportKind, path: string): number {
   try {
     const raw = JSON.parse(readFileSync(path, "utf-8"));
@@ -319,10 +275,8 @@ function getImportServerCount(importKind: ImportKind, path: string): number {
     return 0;
   }
 }
-
 function readValidatedConfig(path: string, label: string): McpConfig | null {
   if (!existsSync(path)) return null;
-
   try {
     return validateConfig(JSON.parse(readFileSync(path, "utf-8")));
   } catch (error) {
@@ -330,31 +284,24 @@ function readValidatedConfig(path: string, label: string): McpConfig | null {
     return null;
   }
 }
-
 function validateConfig(raw: unknown): McpConfig {
   if (!raw || typeof raw !== "object") {
     return { mcpServers: {} };
   }
-
   const obj = raw as Record<string, unknown>;
   const servers = obj.mcpServers ?? obj["mcp-servers"] ?? {};
-
   if (typeof servers !== "object" || servers === null || Array.isArray(servers)) {
     return { mcpServers: {} };
   }
-
   return {
     mcpServers: servers as Record<string, ServerEntry>,
     imports: Array.isArray(obj.imports) ? (obj.imports as ImportKind[]) : undefined,
     settings: obj.settings as McpSettings | undefined,
   };
 }
-
 function extractServers(config: unknown, kind: ImportKind): Record<string, ServerEntry> {
   if (!config || typeof config !== "object") return {};
-
   const obj = config as Record<string, unknown>;
-
   let servers: unknown;
   switch (kind) {
     case "claude-desktop":
@@ -370,119 +317,22 @@ function extractServers(config: unknown, kind: ImportKind): Record<string, Serve
     default:
       return {};
   }
-
   if (!servers || typeof servers !== "object" || Array.isArray(servers)) {
     return {};
   }
-
   return servers as Record<string, ServerEntry>;
 }
-
-function serializeRawConfig(raw: Record<string, unknown>): string {
-  return `${JSON.stringify(raw, null, 2)}\n`;
-}
-
-function buildUnifiedDiff(beforeText: string, afterText: string): string {
-  if (beforeText === afterText) return "(no changes)";
-
-  const before = beforeText.split("\n");
-  const after = afterText.split("\n");
-  const rows = before.length;
-  const cols = after.length;
-  const lcs = Array.from({ length: rows + 1 }, () => Array<number>(cols + 1).fill(0));
-
-  for (let i = rows - 1; i >= 0; i--) {
-    for (let j = cols - 1; j >= 0; j--) {
-      lcs[i][j] = before[i] === after[j]
-        ? lcs[i + 1][j + 1] + 1
-        : Math.max(lcs[i + 1][j], lcs[i][j + 1]);
-    }
-  }
-
-  const lines: string[] = ["--- before", "+++ after"];
-  let i = 0;
-  let j = 0;
-  while (i < rows || j < cols) {
-    if (i < rows && j < cols && before[i] === after[j]) {
-      lines.push(`  ${before[i]}`);
-      i++;
-      j++;
-      continue;
-    }
-    if (j < cols && (i === rows || lcs[i][j + 1] >= lcs[i + 1][j])) {
-      lines.push(`+ ${after[j]}`);
-      j++;
-      continue;
-    }
-    if (i < rows) {
-      lines.push(`- ${before[i]}`);
-      i++;
-    }
-  }
-
-  return lines.join("\n");
-}
-
-function buildConfigWritePreview(filePath: string, nextRaw: Record<string, unknown>): ConfigWritePreview {
-  const existed = existsSync(filePath);
-  const beforeRaw = readRawConfigObject(filePath);
-  const beforeText = existed ? serializeRawConfig(beforeRaw) : "";
-  const afterText = serializeRawConfig(nextRaw);
-  return {
-    path: filePath,
-    existed,
-    changed: beforeText !== afterText,
-    beforeText,
-    afterText,
-    diffText: buildUnifiedDiff(beforeText, afterText),
-  };
-}
-
-function readRawConfigObject(filePath: string): Record<string, unknown> {
-  if (!existsSync(filePath)) return {};
-
-  try {
-    const raw = JSON.parse(readFileSync(filePath, "utf-8"));
-    return raw && typeof raw === "object" && !Array.isArray(raw) ? raw as Record<string, unknown> : {};
-  } catch {
-    return {};
-  }
-}
-
-function writeRawConfigObject(filePath: string, raw: Record<string, unknown>): void {
-  mkdirSync(dirname(filePath), { recursive: true });
-  const tmpPath = `${filePath}.${process.pid}.tmp`;
-  writeFileSync(tmpPath, `${JSON.stringify(raw, null, 2)}\n`, "utf-8");
-  renameSync(tmpPath, filePath);
-}
-
-function getServersObject(raw: Record<string, unknown>): Record<string, ServerEntry> {
-  const existing = raw.mcpServers ?? raw["mcp-servers"] ?? {};
-  if (!existing || typeof existing !== "object" || Array.isArray(existing)) {
-    return {};
-  }
-  return existing as Record<string, ServerEntry>;
-}
-
-function setServersObject(raw: Record<string, unknown>, servers: Record<string, ServerEntry>): void {
-  delete raw["mcp-servers"];
-  raw.mcpServers = servers;
-}
-
 function isRepoPromptServer(name: string, entry: ServerEntry): boolean {
   const normalizedName = name.toLowerCase();
   if (normalizedName.includes("repoprompt") || normalizedName === "rp") {
     return true;
   }
-
   const command = entry.command?.toLowerCase() ?? "";
   if (command.includes("repoprompt") || command.includes("rp-mcp") || command.endsWith("repoprompt_cli")) {
     return true;
   }
-
   return (entry.args ?? []).some((arg) => typeof arg === "string" && arg.toLowerCase().includes("repoprompt"));
 }
-
 function findProjectRoot(cwd = process.cwd()): string | null {
   let current = resolve(cwd);
   while (true) {
@@ -494,13 +344,11 @@ function findProjectRoot(cwd = process.cwd()): string | null {
     ) {
       return current;
     }
-
     const parent = dirname(current);
     if (parent === current) return null;
     current = parent;
   }
 }
-
 function buildRepoPromptEntry(executablePath: string): ServerEntry {
   return {
     command: executablePath,
@@ -508,7 +356,6 @@ function buildRepoPromptEntry(executablePath: string): ServerEntry {
     lifecycle: "lazy",
   };
 }
-
 function detectRepoPrompt(summary: Omit<McpDiscoverySummary, "fingerprint" | "repoPrompt">, cwd = process.cwd()): RepoPromptDiscovery {
   for (const source of summary.sources) {
     if (source.kind !== "shared" || source.serverCount === 0) continue;
@@ -520,12 +367,10 @@ function detectRepoPrompt(summary: Omit<McpDiscoverySummary, "fingerprint" | "re
       }
     }
   }
-
   const executablePath = REPOPROMPT_BINARY_CANDIDATES.find((candidate) => existsSync(candidate));
   if (!executablePath) {
     return { configured: false };
   }
-
   const projectRoot = findProjectRoot(cwd);
   const targetPath = projectRoot ? join(projectRoot, PROJECT_CONFIG_NAME) : GENERIC_GLOBAL_CONFIG_PATH;
   return {
@@ -536,7 +381,6 @@ function detectRepoPrompt(summary: Omit<McpDiscoverySummary, "fingerprint" | "re
     entry: buildRepoPromptEntry(executablePath),
   };
 }
-
 export function previewCompatibilityImports(importKinds: ImportKind[], overridePath?: string): ConfigWritePreview {
   const targetPath = getPiGlobalConfigPath(overridePath);
   const raw = readRawConfigObject(targetPath);
@@ -546,7 +390,6 @@ export function previewCompatibilityImports(importKinds: ImportKind[], overrideP
   setServersObject(nextRaw, getServersObject(nextRaw));
   return buildConfigWritePreview(targetPath, nextRaw);
 }
-
 export function ensureCompatibilityImports(importKinds: ImportKind[], overridePath?: string): { path: string; added: ImportKind[] } {
   const targetPath = getPiGlobalConfigPath(overridePath);
   const raw = readRawConfigObject(targetPath);
@@ -556,33 +399,28 @@ export function ensureCompatibilityImports(importKinds: ImportKind[], overridePa
   if (added.length === 0) {
     return { path: targetPath, added: [] };
   }
-
   raw.imports = merged;
   const servers = getServersObject(raw);
   setServersObject(raw, servers);
   writeRawConfigObject(targetPath, raw);
   return { path: targetPath, added };
 }
-
 export function buildStarterProjectConfig(): McpConfig {
   return {
     mcpServers: {},
   };
 }
-
 export function previewStarterProjectConfig(cwd = process.cwd()): ConfigWritePreview {
   const targetPath = getProjectConfigPath(cwd);
   const nextRaw = { mcpServers: buildStarterProjectConfig().mcpServers };
   return buildConfigWritePreview(targetPath, nextRaw);
 }
-
 export function writeStarterProjectConfig(cwd = process.cwd()): string {
   const targetPath = getProjectConfigPath(cwd);
   const raw = { mcpServers: buildStarterProjectConfig().mcpServers };
   writeRawConfigObject(targetPath, raw);
   return targetPath;
 }
-
 export function previewSharedServerEntry(filePath: string, serverName: string, entry: ServerEntry): ConfigWritePreview {
   const raw = readRawConfigObject(filePath);
   const nextRaw = { ...raw };
@@ -591,7 +429,6 @@ export function previewSharedServerEntry(filePath: string, serverName: string, e
   setServersObject(nextRaw, servers);
   return buildConfigWritePreview(filePath, nextRaw);
 }
-
 export function writeSharedServerEntry(filePath: string, serverName: string, entry: ServerEntry): string {
   const raw = readRawConfigObject(filePath);
   const servers = getServersObject(raw);
@@ -600,20 +437,16 @@ export function writeSharedServerEntry(filePath: string, serverName: string, ent
   writeRawConfigObject(filePath, raw);
   return filePath;
 }
-
 export function getServerProvenance(overridePath?: string, cwd = process.cwd()): Map<string, ServerProvenance> {
   const provenance = new Map<string, ServerProvenance>();
   const userPath = getPiGlobalConfigPath(overridePath);
-
   for (const source of getConfigSources(overridePath, cwd)) {
     const loaded = readValidatedConfig(source.readPath, `MCP config from ${source.readPath}`);
     if (!loaded) continue;
-
     if (loaded.imports?.length) {
       for (const importKind of loaded.imports) {
         const importPath = resolveImportPath(importKind, cwd);
         if (!importPath) continue;
-
         try {
           const imported = JSON.parse(readFileSync(importPath, "utf-8"));
           const servers = extractServers(imported, importKind);
@@ -625,7 +458,6 @@ export function getServerProvenance(overridePath?: string, cwd = process.cwd()):
         } catch {}
       }
     }
-
     for (const name of Object.keys(loaded.mcpServers)) {
       provenance.set(name, {
         path: source.writePath,
@@ -634,31 +466,24 @@ export function getServerProvenance(overridePath?: string, cwd = process.cwd()):
       });
     }
   }
-
   return provenance;
 }
-
 export function writeDirectToolsConfig(
   changes: Map<string, true | string[] | false>,
   provenance: Map<string, ServerProvenance>,
   fullConfig: McpConfig,
 ): void {
   const byPath = new Map<string, { name: string; value: true | string[] | false; prov: ServerProvenance }[]>();
-
   for (const [serverName, value] of changes) {
     const prov = provenance.get(serverName);
     if (!prov) continue;
-
     const targetPath = prov.path;
-
     if (!byPath.has(targetPath)) byPath.set(targetPath, []);
     byPath.get(targetPath)!.push({ name: serverName, value, prov });
   }
-
   for (const [filePath, entries] of byPath) {
     const raw = readRawConfigObject(filePath);
     const servers = getServersObject(raw);
-
     for (const { name, value, prov } of entries) {
       if (prov.kind === "import") {
         const fullDef = fullConfig.mcpServers[name];
@@ -669,7 +494,6 @@ export function writeDirectToolsConfig(
         servers[name] = { ...servers[name], directTools: value };
       }
     }
-
     setServersObject(raw, servers);
     writeRawConfigObject(filePath, raw);
   }