chati-dev 4.5.8 → 4.5.9

package/framework/config.yaml

@@ -1,8 +1,8 @@
 # chati.dev Configuration
-version: "4.5.8"
+version: "4.5.9"
 installed_at: "2026-02-07T10:00:00Z"
 updated_at: "2026-08-27T00:00:00Z"
-installer_version: "4.5.8"
+installer_version: "4.5.9"
 project_type: greenfield
 language: en
 ides: []

package/framework/context/root.md

@@ -1,7 +1,7 @@
 # Chati.dev System Context
 
 ## Framework
-- **Version**: 4.5.8
+- **Version**: 4.5.9
 - **Agents**: Specialized discovery and planning agents feeding provider-neutral RAIL execution and a sealed release lane
 - **Constitution**: 25 Articles + Preamble
 - **Quality**: 5 pipeline gates + 3-tier verdicts + Fault Vector Protocol (Article XXII)

package/framework/data/entity-registry.yaml

@@ -3,7 +3,7 @@
 # and by the Health Check for system integrity validation.
 
 metadata:
-  version: "4.5.8"
+  version: "4.5.9"
   last_updated: "2026-08-27T00:00:00Z"
   entity_count: 109
   checksum_algorithm: sha256

package/framework/manifest.json

@@ -1,5 +1,5 @@
 {
-  "createdAt": "2026-08-27T12:02:42.275Z",
+  "createdAt": "2026-08-27T12:53:59.633Z",
   "files": {
     "agents/build/dev.md": {
       "hash": "13c2b3855c1f815154a2f4020b99fd8ee71e701b41783f5f26696222720a1466",
@@ -97,7 +97,7 @@
       "type": "md"
     },
     "config.yaml": {
-      "hash": "00aa2be05f8cd997b3aae234f56969e1b3309af68c35ada1c439e66cefb37ae5",
+      "hash": "2a0de0eae5e361cc23b1777573b3dadf4676ce8c231a3022dd14ebac385eb89f",
       "size": 2669,
       "type": "yaml"
     },
@@ -122,12 +122,12 @@
       "type": "md"
     },
     "context/root.md": {
-      "hash": "f04a8dc22486c1f0cc29ea2ec5ad30d4a1c343823f1dfc5674946acb854106bb",
+      "hash": "b76681d1bdd7c75e79733a520fc0c929858dc9399348dbb8ba30380e77c32849",
       "size": 1217,
       "type": "md"
     },
     "data/entity-registry.yaml": {
-      "hash": "d11e07cb0ab2790938af077da954580f9bf0d7230bf4e79b59e6c45a00e2dcb7",
+      "hash": "c4b2005f61055a6f1d04c674ba369dbb997dda8d7f81991d6012f25b5a89210f",
       "size": 34605,
       "type": "yaml"
     },
@@ -1352,5 +1352,5 @@
       "type": "yaml"
     }
   },
-  "version": "4.5.8"
+  "version": "4.5.9"
 }

package/framework/manifest.sig

@@ -1 +1 @@
-stchaq/GjnloDsRgwm8vCQpA4vFKsofjuyMg5b+4aU6pEblso6UgEAtPPlRkVVkxcmn8ctX9YxQmqe+MmaPsAA==
+Hb7c+de1wUKAcc4qkLRzsVYqMzP02CNhfXf+bcp5ezJLqsH+KyZ7sOvQUpRf89mWC57jrLu/dscvchEyVdxQBQ==

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chati-dev",
-  "version": "4.5.8",
+  "version": "4.5.9",
   "description": "AI-Powered Multi-Agent Orchestration System - Structured vibe coding for Full Stack Development",
   "type": "module",
   "bin": {

package/src/config/context-file-generator.js

@@ -32,7 +32,7 @@ const GEMINI_REPLACEMENTS = [
   ['.claude/commands/', '.gemini/commands/'],
   ['.claude/rules/chati/', '.gemini/context/'],
   ['.claude/rules/', '.gemini/context/'],
-  ['.claude/mcp.json', '.gemini/settings.json'],
+  ['.mcp.json', '.gemini/settings.json'],
   ['claude --print', 'gemini --prompt'],
   ['claude -p', 'gemini --prompt'],
   ['CLAUDE.local.md', '.gemini/session-lock.md'],
@@ -64,7 +64,7 @@ function buildCodexReplacements(frameworkDir = 'chati.dev') {
     ['.claude/commands/', `${frameworkDir}/orchestrator/`],
     ['.claude/rules/chati/', `${frameworkDir}/context/`],
     ['.claude/rules/', `${frameworkDir}/context/`],
-    ['.claude/mcp.json', '.codex/config.toml'],
+    ['.mcp.json', '.codex/config.toml'],
     ['claude --print', 'codex exec'],
     ['claude -p', 'codex exec'],
     ['CLAUDE.local.md', 'AGENTS.override.md'],

package/src/config/ide-configs.js

@@ -10,7 +10,7 @@ export const IDE_CONFIGS = {
     recommended: true,
     configPath: '.claude/commands/',
     rulesFile: '.claude/CLAUDE.md',
-    mcpConfigFile: '.claude/mcp.json',
+    mcpConfigFile: '.mcp.json',
     formatNotes: 'Native markdown format',
   },
   'gemini-cli': {
@@ -32,7 +32,7 @@ export const IDE_CONFIGS = {
     recommended: false,
     configPath: '.agents/skills/chati/',
     rulesFile: 'AGENTS.md',
-    mcpConfigFile: null,
+    mcpConfigFile: '.codex/config.toml',
     formatNotes: 'Codex skill format (SKILL.md with YAML frontmatter)',
     rulesPath: '.codex/rules/',
     overrideFile: 'AGENTS.override.md',
@@ -44,7 +44,7 @@ export const IDE_CONFIGS = {
     recommended: false,
     configPath: '.grok/commands/',
     rulesFile: 'AGENTS.md',
-    mcpConfigFile: '.grok/mcp.json',
+    mcpConfigFile: '.grok/config.toml',
     formatNotes: 'Native markdown command format',
   },
   'vscode': {

package/src/config/mcp-configs.js

@@ -10,7 +10,7 @@ export const MCP_CONFIGS = {
     name: 'Browser (Playwright)',
     description: 'Web automation and testing',
     requiresEnv: [],
-    claudeConfig: {
+    serverConfig: {
       command: 'npx',
       args: ['-y', '@playwright/mcp'],
     },
@@ -19,13 +19,16 @@ export const MCP_CONFIGS = {
     name: 'Context7',
     description: 'Library documentation search',
     requiresEnv: [],
-    claudeConfig: {
+    serverConfig: {
       command: 'npx',
-      args: ['-y', '@context7/mcp'],
+      args: ['-y', '@upstash/context7-mcp'],
     },
   },
 };
 
+export const MCP_TOML_BEGIN = '# BEGIN CHATI MANAGED MCP SERVERS';
+export const MCP_TOML_END = '# END CHATI MANAGED MCP SERVERS';
+
 /**
  * Agent-MCP dependency matrix
  */
@@ -47,22 +50,89 @@ export const AGENT_MCP_DEPS = {
 };
 
 /**
- * Generate MCP config for Claude Code (.claude/mcp.json)
+ * Resolve the provider-neutral server definitions selected by the user.
  */
-export function generateClaudeMCPConfig(selectedMCPs) {
+export function resolveSelectedMCPServers(selectedMCPs) {
   const mcpServers = {};
   for (const mcpKey of selectedMCPs) {
     const config = MCP_CONFIGS[mcpKey];
-    if (config?.claudeConfig) {
+    if (config?.serverConfig) {
       const entry = {
-        command: config.claudeConfig.command,
-        args: config.claudeConfig.args,
+        command: config.serverConfig.command,
+        args: [...(config.serverConfig.args || [])],
       };
-      if (config.claudeConfig.env) {
-        entry.env = config.claudeConfig.env;
+      if (config.serverConfig.env) {
+        entry.env = { ...config.serverConfig.env };
       }
       mcpServers[mcpKey] = entry;
     }
   }
+  return mcpServers;
+}
+
+/** Generate Claude Code's project-scoped root .mcp.json. */
+export function generateClaudeMCPConfig(selectedMCPs) {
+  const mcpServers = resolveSelectedMCPServers(selectedMCPs);
   return { mcpServers };
 }
+
+/**
+ * Merge CHATI-managed servers into an existing Claude project configuration.
+ * Unknown user-managed servers and top-level fields are preserved.
+ */
+export function mergeClaudeMCPConfig(existingContent, selectedMCPs) {
+  let existing = {};
+  if (existingContent?.trim()) {
+    existing = JSON.parse(existingContent);
+    if (!existing || typeof existing !== 'object' || Array.isArray(existing)) {
+      throw new Error('Existing .mcp.json must contain a JSON object');
+    }
+  }
+  if (
+    existing.mcpServers !== undefined
+    && (!existing.mcpServers || typeof existing.mcpServers !== 'object' || Array.isArray(existing.mcpServers))
+  ) {
+    throw new Error('Existing .mcp.json mcpServers must contain a JSON object');
+  }
+  const mcpServers = { ...(existing.mcpServers || {}) };
+  for (const key of Object.keys(MCP_CONFIGS)) delete mcpServers[key];
+  Object.assign(mcpServers, resolveSelectedMCPServers(selectedMCPs));
+  return { ...existing, mcpServers };
+}
+
+function tomlString(value) {
+  return JSON.stringify(String(value));
+}
+
+/** Generate the shared native TOML block used by Codex and Grok. */
+export function generateManagedMcpToml(selectedMCPs) {
+  const servers = resolveSelectedMCPServers(selectedMCPs);
+  const lines = [MCP_TOML_BEGIN];
+  for (const [name, config] of Object.entries(servers)) {
+    lines.push(`[mcp_servers.${name}]`);
+    lines.push(`command = ${tomlString(config.command)}`);
+    if (config.args?.length) lines.push(`args = [${config.args.map(tomlString).join(', ')}]`);
+    if (config.env && Object.keys(config.env).length > 0) {
+      const values = Object.entries(config.env).map(([key, value]) => `${key} = ${tomlString(value)}`);
+      lines.push(`env = { ${values.join(', ')} }`);
+    }
+    lines.push('');
+  }
+  lines.push(MCP_TOML_END);
+  return lines.join('\n').replace(/\n{3,}/g, '\n\n');
+}
+
+/** Replace only CHATI's marked TOML block and preserve all user configuration. */
+export function upsertManagedMcpToml(existingContent, selectedMCPs) {
+  const managedPattern = new RegExp(`(?:^|\\n)${MCP_TOML_BEGIN}[\\s\\S]*?${MCP_TOML_END}\\n?`);
+  const withoutManaged = String(existingContent || '').replace(managedPattern, '\n').trimEnd();
+  const userManagedNames = new Set();
+  const tablePattern = /^\s*\[mcp_servers\.(?:"([^"]+)"|'([^']+)'|([A-Za-z0-9_-]+))\]\s*(?:#.*)?$/gm;
+  for (const match of withoutManaged.matchAll(tablePattern)) {
+    userManagedNames.add(match[1] || match[2] || match[3]);
+  }
+  const managedSelections = (selectedMCPs || []).filter((name) => !userManagedNames.has(name));
+  if (!managedSelections.length) return withoutManaged ? `${withoutManaged}\n` : '';
+  const separator = withoutManaged ? '\n\n' : '';
+  return `${withoutManaged}${separator}${generateManagedMcpToml(managedSelections)}\n`;
+}

package/src/installer/core.js

@@ -4,7 +4,7 @@ import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { createRequire } from 'module';
 import { IDE_CONFIGS, IDE_TO_PROVIDER } from '../config/ide-configs.js';
-import { generateClaudeMCPConfig } from '../config/mcp-configs.js';
+import { mergeClaudeMCPConfig, upsertManagedMcpToml } from '../config/mcp-configs.js';
 import { generateSessionYaml, generateConfigYaml, generateClaudeMd, generateClaudeLocalMd, generateCodexSkill, generateGeminiRouter, generateGrokRouter, generateGeminiSessionLock, generateAgentsOverrideMd, generateCodexConstitutionGuardRules, generateCodexReadProtectionRules } from './templates.js';
 import { generateContextFiles } from '../config/context-file-generator.js';
 import { adaptFrameworkFile, ADAPTABLE_FILES } from '../config/framework-adapter.js';
@@ -417,14 +417,13 @@ Parse the JSON output. This single command already handled: license validation,
     // (Pre-v4.2.2 bug: this file was never written, hooks never ran.)
     writeClaudeSettingsWithMerge(join(targetDir, '.claude', 'settings.json'));
 
-    // MCP config
-    if (selectedMCPs.length > 0) {
-      const mcpConfig = generateClaudeMCPConfig(selectedMCPs);
-      writeFileSync(
-        join(targetDir, '.claude', 'mcp.json'),
-        JSON.stringify(mcpConfig, null, 2) + '\n',
-        'utf-8'
-      );
+    // Claude project-scope MCP config lives at the project root. Preserve
+    // unknown user-managed servers while replacing CHATI's known entries.
+    const mcpPath = join(targetDir, '.mcp.json');
+    if (selectedMCPs.length > 0 || existsSync(mcpPath)) {
+      const existingMcp = existsSync(mcpPath) ? readFileSync(mcpPath, 'utf-8') : '';
+      const mcpConfig = mergeClaudeMCPConfig(existingMcp, selectedMCPs);
+      writeFileSync(mcpPath, JSON.stringify(mcpConfig, null, 2) + '\n', 'utf-8');
     }
   } else if (ideKey === 'codex-cli') {
     // Codex CLI: chati skill via .agents/skills/chati/SKILL.md (invoke with $chati)
@@ -436,7 +435,7 @@ Parse the JSON output. This single command already handled: license validation,
 
     // Starlark execution policies (Codex sandboxed rule engine)
     createDir(join(targetDir, '.codex', 'rules'));
-    writeCodexConfigWithHooks(join(targetDir, '.codex', 'config.toml'));
+    writeCodexConfigWithHooks(join(targetDir, '.codex', 'config.toml'), selectedMCPs);
     writeFileSync(join(targetDir, '.codex', 'rules', 'constitution-guard.rules'), generateCodexConstitutionGuardRules(), 'utf-8');
     writeFileSync(join(targetDir, '.codex', 'rules', 'read-protection.rules'), generateCodexReadProtectionRules(), 'utf-8');
 
@@ -495,6 +494,11 @@ Parse the JSON output. This single command already handled: license validation,
   } else if (ideKey === 'grok-cli') {
     writeFileSync(join(targetDir, '.grok', 'commands', 'chati.md'), generateGrokRouter({ orchestratorPath }), 'utf-8');
     writeFileSync(join(targetDir, '.grok', 'session-lock.md'), generateClaudeLocalMd(), 'utf-8');
+    const grokConfigPath = join(targetDir, '.grok', 'config.toml');
+    if (selectedMCPs.length > 0 || existsSync(grokConfigPath)) {
+      const existingConfig = existsSync(grokConfigPath) ? readFileSync(grokConfigPath, 'utf-8') : '';
+      writeFileSync(grokConfigPath, upsertManagedMcpToml(existingConfig, selectedMCPs), 'utf-8');
+    }
   } else {
     // VS Code, Cursor, AntiGravity — generic rules file
     if (config.rulesFile) {
@@ -504,36 +508,32 @@ Parse the JSON output. This single command already handled: license validation,
   }
 }
 
-export function writeCodexConfigWithHooks(configPath) {
+export function writeCodexConfigWithHooks(configPath, selectedMCPs = []) {
   createDir(dirname(configPath));
-  if (!existsSync(configPath)) {
-    writeFileSync(configPath, '[features]\nhooks = true\n', 'utf-8');
-    return;
-  }
-
-  const original = readFileSync(configPath, 'utf-8');
-  if (/^\s*features\.hooks\s*=\s*true\s*(?:#.*)?$/m.test(original)) return;
-  if (/^\s*features\.hooks\s*=/m.test(original)) {
-    writeFileSync(configPath, original.replace(/^\s*features\.hooks\s*=.*$/m, 'features.hooks = true'), 'utf-8');
-    return;
-  }
-
-  const lines = original.split('\n');
-  const sectionStart = lines.findIndex((line) => /^\s*\[features\]\s*(?:#.*)?$/.test(line));
-  if (sectionStart === -1) {
-    const prefix = original.endsWith('\n') ? original : `${original}\n`;
-    writeFileSync(configPath, `${prefix}\n[features]\nhooks = true\n`, 'utf-8');
-    return;
+  const original = existsSync(configPath) ? readFileSync(configPath, 'utf-8') : '';
+  let hooksEnabled = original;
+  if (!original.trim()) {
+    hooksEnabled = '[features]\nhooks = true\n';
+  } else if (/^\s*features\.hooks\s*=/m.test(original)) {
+    hooksEnabled = original.replace(/^\s*features\.hooks\s*=.*$/m, 'features.hooks = true');
+  } else if (!/^\s*features\.hooks\s*=\s*true\s*(?:#.*)?$/m.test(original)) {
+    const lines = original.split('\n');
+    const sectionStart = lines.findIndex((line) => /^\s*\[features\]\s*(?:#.*)?$/.test(line));
+    if (sectionStart === -1) {
+      const prefix = original.endsWith('\n') ? original : `${original}\n`;
+      hooksEnabled = `${prefix}\n[features]\nhooks = true\n`;
+    } else {
+      let sectionEnd = lines.findIndex((line, index) => index > sectionStart && /^\s*\[.*\]\s*(?:#.*)?$/.test(line));
+      if (sectionEnd === -1) sectionEnd = lines.length;
+      const hookIndex = lines.findIndex((line, index) =>
+        index > sectionStart && index < sectionEnd && /^\s*hooks\s*=/.test(line)
+      );
+      if (hookIndex !== -1) lines[hookIndex] = 'hooks = true';
+      else lines.splice(sectionEnd, 0, 'hooks = true');
+      hooksEnabled = lines.join('\n');
+    }
   }
-
-  let sectionEnd = lines.findIndex((line, index) => index > sectionStart && /^\s*\[.*\]\s*(?:#.*)?$/.test(line));
-  if (sectionEnd === -1) sectionEnd = lines.length;
-  const hookIndex = lines.findIndex((line, index) =>
-    index > sectionStart && index < sectionEnd && /^\s*hooks\s*=/.test(line)
-  );
-  if (hookIndex !== -1) lines[hookIndex] = 'hooks = true';
-  else lines.splice(sectionEnd, 0, 'hooks = true');
-  writeFileSync(configPath, lines.join('\n'), 'utf-8');
+  writeFileSync(configPath, upsertManagedMcpToml(hooksEnabled, selectedMCPs), 'utf-8');
 }
 
 /**