@girardmedia/bootspring 2.0.52 → 2.0.53

package/bin/bootspring.js

@@ -7,6 +7,7 @@
 
 const path = require('path');
 const selfUpdate = require('../core/self-update');
+const { ensureProjectMcpConfig } = require('../core/mcp-config');
 
 const VERSION = require('../package.json').version;
 
@@ -111,6 +112,11 @@ async function main() {
     return;
   }
 
+  const mcpConfigResult = ensureProjectMcpConfig(process.cwd(), { createIfMissing: false });
+  if (mcpConfigResult.status === 'updated') {
+    console.error('[bootspring] Updated .mcp.json to use the managed latest-package launcher.');
+  }
+
   try {
     await runCommand(command, args.slice(1));
   } catch (error) {

package/cli/init.js

@@ -15,7 +15,7 @@ const { execSync } = require('child_process');
 const config = require('../core/config');
 const utils = require('../core/utils');
 const contextLoader = require('../core/context-loader');
-const { getManagedMcpServerConfig } = require('../core/mcp-config');
+const { getManagedMcpServerConfig, ensureProjectMcpConfig } = require('../core/mcp-config');
 const { runQuestionnaire } = require('../generators/questionnaire');
 const claudeTemplate = require('../generators/templates/claude.template');
 const seedTemplate = require('../generators/templates/seed.template');
@@ -543,7 +543,6 @@ ${utils.COLORS.dim}Development scaffolding with intelligence${utils.COLORS.reset
   }
 
   // 4. MCP configuration (local or global)
-  const mcpPath = path.join(projectRoot, '.mcp.json');
   const globalMcpPath = getGlobalMcpPath();
   const isGlobal = isGloballyInstalled();
   const hasGlobalMcp = isGlobalMcpConfigured();
@@ -592,18 +591,17 @@ ${utils.COLORS.dim}Development scaffolding with intelligence${utils.COLORS.reset
     } catch (error) {
       globalSpinner.fail(`Global MCP config failed: ${error.message}`);
     }
-  } else if (!utils.fileExists(mcpPath)) {
-    // Local .mcp.json
+  } else {
     const mcpSpinner = utils.createSpinner('Creating .mcp.json').start();
-    const mcpConfig = {
-      mcpServers: {
-        bootspring: getManagedMcpServerConfig()
-      }
-    };
-    if (utils.writeFile(mcpPath, JSON.stringify(mcpConfig, null, 2))) {
+    const result = ensureProjectMcpConfig(projectRoot, { createIfMissing: true });
+    if (result.status === 'created') {
       mcpSpinner.succeed('Created .mcp.json (MCP server config)');
+    } else if (result.status === 'updated' || result.status === 'added') {
+      mcpSpinner.succeed('Updated .mcp.json (MCP server config)');
+    } else if (result.status === 'unchanged') {
+      mcpSpinner.succeed('Verified .mcp.json (MCP server config)');
     } else {
-      mcpSpinner.fail('Failed to create .mcp.json');
+      mcpSpinner.fail(`Failed to configure .mcp.json${result.error ? `: ${result.error.message}` : ''}`);
     }
   }
 

package/cli/mcp.js

@@ -3,12 +3,11 @@
  * Manage the hosted MCP proxy configuration.
  */
 
-const path = require('path');
 const config = require('../core/config');
 const utils = require('../core/utils');
 const api = require('../core/api-client');
 const auth = require('../core/auth');
-const { getManagedMcpServerConfig } = require('../core/mcp-config');
+const { ensureProjectMcpConfig } = require('../core/mcp-config');
 const { redactErrorMessage } = require('../core/redaction');
 
 const C = utils.COLORS;
@@ -20,18 +19,17 @@ async function startServer() {
 
 function generateConfig() {
   const cfg = config.load();
-  const mcpPath = path.join(cfg._projectRoot, '.mcp.json');
-  const mcpConfig = {
-    mcpServers: {
-      bootspring: getManagedMcpServerConfig()
-    }
-  };
-
   const spinner = utils.createSpinner('Generating .mcp.json').start();
-  if (utils.writeFile(mcpPath, JSON.stringify(mcpConfig, null, 2))) {
-    spinner.succeed(`Created ${mcpPath}`);
+  const result = ensureProjectMcpConfig(cfg._projectRoot, { createIfMissing: true });
+
+  if (result.status === 'created') {
+    spinner.succeed(`Created ${result.path}`);
+  } else if (result.status === 'updated' || result.status === 'added') {
+    spinner.succeed(`Updated ${result.path}`);
+  } else if (result.status === 'unchanged') {
+    spinner.succeed(`Already configured ${result.path}`);
   } else {
-    spinner.fail('Failed to create .mcp.json');
+    spinner.fail(`Failed to configure .mcp.json${result.error ? `: ${result.error.message}` : ''}`);
   }
 }
 

package/core/mcp-config.js

@@ -1,4 +1,8 @@
+const fs = require('fs');
+const path = require('path');
+
 const PACKAGE_NAME = require('../package.json').name || '@girardmedia/bootspring';
+const PROJECT_MCP_FILENAME = '.mcp.json';
 
 function getManagedMcpServerConfig() {
   return {
@@ -8,7 +12,104 @@ function getManagedMcpServerConfig() {
   };
 }
 
+function isManagedMcpServerConfig(serverConfig) {
+  const expected = getManagedMcpServerConfig();
+  return (
+    serverConfig?.command === expected.command &&
+    Array.isArray(serverConfig?.args) &&
+    serverConfig.args.join('\u0000') === expected.args.join('\u0000')
+  );
+}
+
+function normalizeManagedMcpServerConfig(existingServerConfig) {
+  const managedConfig = getManagedMcpServerConfig();
+  const env = existingServerConfig?.env && typeof existingServerConfig.env === 'object' && !Array.isArray(existingServerConfig.env)
+    ? existingServerConfig.env
+    : {};
+
+  return {
+    ...managedConfig,
+    env
+  };
+}
+
+function ensureProjectMcpConfig(projectRoot = process.cwd(), options = {}) {
+  const createIfMissing = options.createIfMissing === true;
+  const mcpPath = path.join(projectRoot, PROJECT_MCP_FILENAME);
+
+  if (!fs.existsSync(mcpPath)) {
+    if (!createIfMissing) {
+      return { status: 'missing', changed: false, path: mcpPath };
+    }
+
+    const nextConfig = {
+      mcpServers: {
+        bootspring: getManagedMcpServerConfig()
+      }
+    };
+
+    try {
+      fs.writeFileSync(mcpPath, JSON.stringify(nextConfig, null, 2));
+      return { status: 'created', changed: true, path: mcpPath, config: nextConfig };
+    } catch (error) {
+      return { status: 'error', changed: false, path: mcpPath, error };
+    }
+  }
+
+  let currentConfig;
+  try {
+    currentConfig = JSON.parse(fs.readFileSync(mcpPath, 'utf8'));
+  } catch (error) {
+    return { status: 'invalid', changed: false, path: mcpPath, error };
+  }
+
+  if (!currentConfig || typeof currentConfig !== 'object' || Array.isArray(currentConfig)) {
+    return {
+      status: 'invalid',
+      changed: false,
+      path: mcpPath,
+      error: new Error('Project MCP config must be a JSON object')
+    };
+  }
+
+  const currentServers = currentConfig.mcpServers && typeof currentConfig.mcpServers === 'object' && !Array.isArray(currentConfig.mcpServers)
+    ? currentConfig.mcpServers
+    : {};
+  const currentBootspring = currentServers.bootspring;
+
+  if (currentBootspring && isManagedMcpServerConfig(currentBootspring)) {
+    return { status: 'unchanged', changed: false, path: mcpPath, config: currentConfig };
+  }
+
+  if (!currentBootspring && !createIfMissing) {
+    return { status: 'absent', changed: false, path: mcpPath, config: currentConfig };
+  }
+
+  const nextConfig = {
+    ...currentConfig,
+    mcpServers: {
+      ...currentServers,
+      bootspring: normalizeManagedMcpServerConfig(currentBootspring)
+    }
+  };
+
+  try {
+    fs.writeFileSync(mcpPath, JSON.stringify(nextConfig, null, 2));
+    return {
+      status: currentBootspring ? 'updated' : 'added',
+      changed: true,
+      path: mcpPath,
+      config: nextConfig
+    };
+  } catch (error) {
+    return { status: 'error', changed: false, path: mcpPath, error };
+  }
+}
+
 module.exports = {
   PACKAGE_NAME,
-  getManagedMcpServerConfig
+  PROJECT_MCP_FILENAME,
+  getManagedMcpServerConfig,
+  isManagedMcpServerConfig,
+  ensureProjectMcpConfig
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@girardmedia/bootspring",
-  "version": "2.0.52",
+  "version": "2.0.53",
   "description": "Thin client for Bootspring cloud MCP, hosted agents, and paywalled workflow intelligence",
   "keywords": [
     "ai",