@1tool/js-boost 1.1.0 → 1.2.0

package/README.md

@@ -13,9 +13,11 @@ Instead of manually maintaining separate instruction files for each AI agent, yo
 ├── guidelines/
 │   ├── general.md       ← coding conventions
 │   └── testing.md       ← testing standards
-└── skills/
-    └── my-skill/
-        └── SKILL.md     ← on-demand skill (loaded when relevant)
+├── skills/
+│   └── my-skill/
+│       └── SKILL.md     ← on-demand skill (loaded when relevant)
+└── mcp/
+    └── mcp.json         ← MCP server definitions
 ```
 
 Run `npx @1tool/js-boost generate` and get the right file for each configured agent:
@@ -141,14 +143,11 @@ During `init` (and `agents`), installed agents are pre-selected automatically ba
 
 ## Configuration
 
-`js-boost.config.json` is managed by the CLI commands (`init`, `agents`, `mcp`) and committed to your repo.
+MCP server definitions live in `.ai/mcp/mcp.json` (managed by `js-boost mcp`):
 
 ```json
 {
-  "projectName": "my-app",
-  "projectDescription": "",
-  "agents": ["claude_code", "cursor", "codex"],
-  "mcpServers": {
+  "servers": {
     "my-api": {
       "type": "remote",
       "url": "https://my-mcp.com/mcp",
@@ -161,7 +160,17 @@ During `init` (and `agents`), installed agents are pre-selected automatically ba
       "env": { "API_KEY": "secret" }
     }
   },
-  "disableMcpServers": []
+  "disabled": []
+}
+```
+
+Agent selection and project metadata live in `js-boost.config.json` (managed by `init` / `agents`):
+
+```json
+{
+  "projectName": "my-app",
+  "projectDescription": "",
+  "agents": ["claude_code", "cursor", "codex"]
 }
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1tool/js-boost",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Laravel Boost-inspired CLI for JavaScript projects — generates agent files from your .ai/ folder",
   "main": "src/index.js",
   "type": "module",

package/src/cli.js

@@ -88,7 +88,7 @@ program
   .option('--dir <path>', 'Project directory', process.cwd())
   .action(async (options) => {
     const projectDir = path.resolve(options.dir);
-    const { readGuidelines, readSkills, readConfig } = await import('./utils/reader.js');
+    const { readGuidelines, readSkills, readConfig, readMcpConfig } = await import('./utils/reader.js');
     const { buildMcpServers } = await import('./utils/mcp.js');
     const { AGENTS, AGENTS_MD_CONSUMERS, MCP_JSON_CONSUMERS } = await import('./agents.js');
     const aiDir = path.join(projectDir, '.ai');
@@ -96,7 +96,7 @@ program
 
     const guidelines = await readGuidelines(aiDir);
     const skills = await readSkills(aiDir);
-    const mcpServers = buildMcpServers(config);
+    const mcpServers = buildMcpServers(readMcpConfig(aiDir));
 
     const allAgentKeys = Object.keys(AGENTS);
     const activeAgents = new Set(config.agents ?? allAgentKeys);

package/src/configure/mcp.js

@@ -2,11 +2,11 @@ import path from 'path';
 import chalk from 'chalk';
 import { text, select, multiselect, isCancel } from '@clack/prompts';
 import { DEFAULT_MCP_SERVERS } from '../utils/mcp.js';
-import { readConfig, writeFile } from '../utils/reader.js';
+import { readMcpConfig, writeMcpConfig } from '../utils/reader.js';
 
-function displayServers(config) {
-  const userServers = config.mcpServers || {};
-  const disabled = new Set(config.disableMcpServers || []);
+function displayServers(mcpConfig) {
+  const userServers = mcpConfig.servers || {};
+  const disabled = new Set(mcpConfig.disabled || []);
   const builtinKeys = Object.keys(DEFAULT_MCP_SERVERS);
 
   if (builtinKeys.length > 0) {
@@ -34,13 +34,13 @@ function displayServers(config) {
   console.log('');
 }
 
-async function addServer(config) {
+async function addServer(mcpConfig) {
   const name = await text({
     message: 'Server key',
     placeholder: 'my-api',
     validate: (v) => {
       if (!v.trim()) return 'Key is required';
-      if ((config.mcpServers || {})[v.trim()]) return `"${v.trim()}" already exists`;
+      if ((mcpConfig.servers || {})[v.trim()]) return `"${v.trim()}" already exists`;
       if (DEFAULT_MCP_SERVERS[v.trim()]) return `"${v.trim()}" is a built-in — use "Toggle built-ins" to enable/disable it`;
       if (!/^[a-z0-9_-]+$/.test(v.trim())) return 'Use only lowercase letters, numbers, hyphens, underscores';
     },
@@ -72,7 +72,7 @@ async function addServer(config) {
     });
     if (isCancel(description)) return;
 
-    config.mcpServers[key] = {
+    mcpConfig.servers[key] = {
       type: 'remote',
       url: url.trim(),
       ...(description.trim() ? { description: description.trim() } : {}),
@@ -111,7 +111,7 @@ async function addServer(config) {
       }
     }
 
-    config.mcpServers[key] = {
+    mcpConfig.servers[key] = {
       type: 'stdio',
       command: command.trim(),
       ...(args.length ? { args } : {}),
@@ -122,8 +122,8 @@ async function addServer(config) {
   console.log(`  ${chalk.green('✓')} Added ${chalk.cyan(key)}`);
 }
 
-async function removeServer(config) {
-  const keys = Object.keys(config.mcpServers);
+async function removeServer(mcpConfig) {
+  const keys = Object.keys(mcpConfig.servers);
   if (keys.length === 0) {
     console.log(chalk.dim('  No custom servers to remove.'));
     return;
@@ -132,7 +132,7 @@ async function removeServer(config) {
   const toRemove = await multiselect({
     message: 'Select servers to remove',
     options: keys.map((k) => {
-      const srv = config.mcpServers[k];
+      const srv = mcpConfig.servers[k];
       const addr = srv.type === 'remote'
         ? srv.url
         : `${srv.command}${srv.args?.length ? ' ' + srv.args.join(' ') : ''}`;
@@ -143,7 +143,7 @@ async function removeServer(config) {
   if (isCancel(toRemove)) return;
 
   for (const k of toRemove) {
-    delete config.mcpServers[k];
+    delete mcpConfig.servers[k];
   }
 
   if (toRemove.length) {
@@ -151,14 +151,14 @@ async function removeServer(config) {
   }
 }
 
-async function toggleDefaults(config) {
+async function toggleDefaults(mcpConfig) {
   const keys = Object.keys(DEFAULT_MCP_SERVERS);
   if (keys.length === 0) {
     console.log(chalk.dim('  No built-in servers configured.'));
     return;
   }
 
-  const disabled = new Set(config.disableMcpServers || []);
+  const disabled = new Set(mcpConfig.disabled || []);
 
   const enabled = await multiselect({
     message: 'Which built-in servers should be enabled?',
@@ -173,14 +173,12 @@ async function toggleDefaults(config) {
   if (isCancel(enabled)) return;
 
   const enabledSet = new Set(enabled);
-  config.disableMcpServers = keys.filter((k) => !enabledSet.has(k));
+  mcpConfig.disabled = keys.filter((k) => !enabledSet.has(k));
 }
 
 export async function configureMcp(projectDir) {
-  const configPath = path.join(projectDir, 'js-boost.config.json');
-  const config = readConfig(projectDir);
-  config.mcpServers = config.mcpServers || {};
-  config.disableMcpServers = config.disableMcpServers || [];
+  const aiDir = path.join(projectDir, '.ai');
+  const mcpConfig = readMcpConfig(aiDir);
 
   console.log('');
   console.log(chalk.bold.blue('⚡ js-boost') + chalk.dim(' — MCP server configuration'));
@@ -189,9 +187,9 @@ export async function configureMcp(projectDir) {
   let running = true;
 
   while (running) {
-    displayServers(config);
+    displayServers(mcpConfig);
 
-    const hasCustom = Object.keys(config.mcpServers).length > 0;
+    const hasCustom = Object.keys(mcpConfig.servers).length > 0;
     const hasBuiltins = Object.keys(DEFAULT_MCP_SERVERS).length > 0;
 
     const options = [
@@ -209,15 +207,15 @@ export async function configureMcp(projectDir) {
     }
 
     console.log('');
-    if (action === 'add')    await addServer(config);
-    if (action === 'remove') await removeServer(config);
-    if (action === 'toggle') await toggleDefaults(config);
+    if (action === 'add')    await addServer(mcpConfig);
+    if (action === 'remove') await removeServer(mcpConfig);
+    if (action === 'toggle') await toggleDefaults(mcpConfig);
     console.log('');
   }
 
-  writeFile(configPath, JSON.stringify(config, null, 2));
+  writeMcpConfig(aiDir, mcpConfig);
   console.log('');
-  console.log(chalk.green('  ✓ Saved to js-boost.config.json'));
-  console.log(chalk.dim('  Run `js-boost generate` to apply changes to agent files.'));
+  console.log(chalk.green('  ✓ Saved to .ai/mcp/mcp.json'));
+  console.log(chalk.dim('  Run `@1tool/js-boost generate` to apply changes to agent files.'));
   console.log('');
 }

package/src/index.js

@@ -1,6 +1,6 @@
 import path from 'path';
 import chalk from 'chalk';
-import { readGuidelines, readSkills, readConfig, writeFile } from './utils/reader.js';
+import { readGuidelines, readSkills, readConfig, readMcpConfig, writeFile } from './utils/reader.js';
 import { buildMcpServers, generateMcpJson, generateJunieMcpJson } from './utils/mcp.js';
 import { AGENTS_MD_CONSUMERS, MCP_JSON_CONSUMERS } from './agents.js';
 import { generateAgentsMd } from './generators/agents.js';
@@ -33,7 +33,7 @@ export async function generate(projectDir, options = {}) {
   // 1. Read source files
   const guidelines = await readGuidelines(aiDir);
   const skills = await readSkills(aiDir);
-  const mcpServers = buildMcpServers(config);
+  const mcpServers = buildMcpServers(readMcpConfig(aiDir));
 
   if (guidelines.length === 0 && skills.length === 0) {
     log(chalk.yellow('  ⚠ No guidelines or skills found in .ai/'));

package/src/init.js

@@ -2,7 +2,7 @@ import path from 'path';
 import fs from 'fs';
 import chalk from 'chalk';
 import { multiselect, isCancel, cancel } from '@clack/prompts';
-import { writeFile } from './utils/reader.js';
+import { writeFile, writeMcpConfig } from './utils/reader.js';
 import { AGENTS } from './agents.js';
 import { detectInstalledAgents } from './utils/detect.js';
 
@@ -102,6 +102,13 @@ export async function init(projectDir, options = {}) {
     }
   }
 
+  // Create .ai/mcp/mcp.json if it doesn't exist yet
+  const mcpJsonPath = path.join(aiDir, 'mcp', 'mcp.json');
+  if (!fs.existsSync(mcpJsonPath) || force) {
+    writeMcpConfig(aiDir, { servers: {}, disabled: [] });
+    console.log(`  ${chalk.green('✓')} ${chalk.cyan('.ai/mcp/mcp.json')}`);
+  }
+
   // Create js-boost.config.json with defaults (or read existing)
   const configPath = path.join(projectDir, 'js-boost.config.json');
   let existingConfig = {};
@@ -116,8 +123,6 @@ export async function init(projectDir, options = {}) {
     projectName: existingConfig.projectName || path.basename(projectDir),
     projectDescription: existingConfig.projectDescription || '',
     agents: selectedAgents,
-    mcpServers: existingConfig.mcpServers || {},
-    disableMcpServers: existingConfig.disableMcpServers || [],
   };
 
   writeFile(configPath, JSON.stringify(config, null, 2));

package/src/utils/mcp.js

@@ -8,9 +8,9 @@ export const DEFAULT_MCP_SERVERS = {
  * Build the MCP servers object, merging defaults with user-defined servers
  * from js-boost.config.json
  */
-export function buildMcpServers(config = {}) {
-  const userServers = config.mcpServers || {};
-  const disabledDefaults = config.disableMcpServers || [];
+export function buildMcpServers(mcpConfig = {}) {
+  const userServers = mcpConfig.servers || {};
+  const disabledDefaults = mcpConfig.disabled || [];
 
   const servers = {};
 

package/src/utils/reader.js

@@ -74,6 +74,31 @@ export function readConfig(projectDir) {
   }
 }
 
+/**
+ * Read .ai/mcp/mcp.json — MCP server definitions
+ * Returns { servers: {}, disabled: [] }
+ */
+export function readMcpConfig(aiDir) {
+  const mcpPath = path.join(aiDir, 'mcp', 'mcp.json');
+  if (!fs.existsSync(mcpPath)) return { servers: {}, disabled: [] };
+  try {
+    const parsed = JSON.parse(fs.readFileSync(mcpPath, 'utf8'));
+    return {
+      servers: parsed.servers || {},
+      disabled: parsed.disabled || [],
+    };
+  } catch {
+    return { servers: {}, disabled: [] };
+  }
+}
+
+/**
+ * Write .ai/mcp/mcp.json
+ */
+export function writeMcpConfig(aiDir, mcpConfig) {
+  writeFile(path.join(aiDir, 'mcp', 'mcp.json'), JSON.stringify(mcpConfig, null, 2));
+}
+
 /**
  * Ensure a directory exists
  */