fraim-framework 2.0.170 → 2.0.173

package/dist/src/cli/commands/add-ide.js

@@ -51,6 +51,7 @@ const mcp_server_registry_1 = require("../mcp/mcp-server-registry");
 const get_provider_client_1 = require("../api/get-provider-client");
 const provider_prompts_1 = require("../setup/provider-prompts");
 const provider_registry_1 = require("../providers/provider-registry");
+const user_config_1 = require("../utils/user-config");
 const loadGlobalConfig = async () => {
     const globalConfigPath = path_1.default.join((0, script_sync_utils_1.getUserFraimDir)(), 'config.json');
     if (!fs_1.default.existsSync(globalConfigPath)) {
@@ -384,7 +385,7 @@ const runAddIDE = async (options) => {
         const detectedIDEs = (0, ide_detector_1.detectInstalledIDEs)();
         if (detectedIDEs.length === 0) {
             console.log(chalk_1.default.yellow('⚠️ No supported IDEs detected on your system.'));
-            console.log(chalk_1.default.gray('Supported IDEs: Claude, Claude Code, Antigravity, Gemini CLI, Kiro, Cursor, VSCode, Codex, Windsurf'));
+            console.log(chalk_1.default.gray('Supported IDEs: Claude, Claude Code, Antigravity, Gemini CLI, Kiro, Cursor, VSCode, Codex, Grok, Windsurf'));
             console.log(chalk_1.default.blue('\n💡 Install an IDE and run this command again.'));
             return;
         }
@@ -410,6 +411,7 @@ const runAddIDE = async (options) => {
         try {
             await configureIDEMCP(ide, globalConfig.fraimKey, platformTokens, globalConfig.providerConfigs);
             results.successful.push(ide.name);
+            (0, user_config_1.addInstalledIde)((0, ide_detector_1.getAdapterConfigType)(ide));
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : 'Unknown error';
@@ -446,7 +448,7 @@ const runAddIDE = async (options) => {
 exports.runAddIDE = runAddIDE;
 exports.addIDECommand = new commander_1.Command('add-ide')
     .description('Add FRAIM configuration to additional IDEs')
-    .option('--ide <name>', 'Configure specific IDE (claude, claude-code, claude-desktop, claude-cowork, antigravity, gemini, gemini-cli, kiro, cursor, vscode, codex, windsurf)')
+    .option('--ide <name>', 'Configure specific IDE (claude, claude-code, claude-desktop, claude-cowork, antigravity, gemini, gemini-cli, kiro, cursor, vscode, codex, grok, windsurf)')
     .option('--all', 'Configure all detected IDEs')
     .option('--list', 'List all supported IDEs and their detection status')
     .action(exports.runAddIDE);

package/dist/src/cli/commands/cleanup-artifacts.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanupArtifactsCommand = void 0;
+exports.runCleanupArtifactsCommand = runCleanupArtifactsCommand;
+const commander_1 = require("commander");
+const node_path_1 = __importDefault(require("node:path"));
+const artifact_retention_cleanup_1 = require("../../local-mcp-server/artifact-retention-cleanup");
+function runCleanupArtifactsCommand(options) {
+    const activeUserEmail = options.user || process.env.FRAIM_ACTIVE_USER_EMAIL || '';
+    if (!activeUserEmail.trim()) {
+        throw new Error('Missing active user email. Pass --user <email> or set FRAIM_ACTIVE_USER_EMAIL.');
+    }
+    const workspaceRoot = node_path_1.default.resolve(options.workspaceRoot || options.root || process.cwd());
+    const report = (0, artifact_retention_cleanup_1.runArtifactCleanup)(workspaceRoot, {
+        activeUserEmail: activeUserEmail.trim(),
+        apply: Boolean(options.apply),
+    });
+    process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+}
+exports.cleanupArtifactsCommand = new commander_1.Command('cleanup-artifacts')
+    .description('Evaluate and optionally apply artifact retention cleanup for the current FRAIM workspace')
+    .option('--user <email>', 'Active user email used only for user-scoped cleanup categories')
+    .option('--workspace-root <path>', 'Workspace root containing fraim/config.json')
+    .option('--root <path>', 'Alias for --workspace-root')
+    .option('--apply', 'Delete eligible files. Without this flag the command performs a dry run.')
+    .action((options) => {
+    try {
+        runCleanupArtifactsCommand(options);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`artifact cleanup failed: ${message}\n`);
+        process.exit(1);
+    }
+});

package/dist/src/cli/commands/init-project.js

@@ -18,6 +18,7 @@ const fraim_gitignore_1 = require("../utils/fraim-gitignore");
 const agent_adapters_1 = require("../utils/agent-adapters");
 const project_fraim_paths_1 = require("../../core/utils/project-fraim-paths");
 const project_bootstrap_1 = require("../utils/project-bootstrap");
+const user_config_1 = require("../utils/user-config");
 const checkGlobalSetup = () => {
     const fraimUserDir = process.env.FRAIM_USER_DIR || path_1.default.join(os_1.default.homedir(), '.fraim');
     const globalConfigPath = path_1.default.join(fraimUserDir, 'config.json');
@@ -178,20 +179,26 @@ const runInitProject = async (options = {}) => {
     else {
         result.warnings.push('Sync was skipped for this run.');
     }
-    const codexAvailable = (0, ide_detector_1.detectInstalledIDEs)().some((ide) => ide.configType === 'codex') ||
-        (0, ide_detector_1.detectInstalledIDEs)('cli-runnable').some((ide) => ide.configType === 'codex');
+    const detectedIdes = [
+        ...(0, ide_detector_1.detectInstalledIDEs)(),
+        ...(0, ide_detector_1.detectInstalledIDEs)('cli-runnable')
+    ];
+    const detectedConfigTypes = [...new Set(detectedIdes.map((ide) => (0, ide_detector_1.getAdapterConfigType)(ide)))];
+    if (detectedConfigTypes.length > 0) {
+        (0, user_config_1.writeUserFraimConfig)({ installedIdes: detectedConfigTypes });
+    }
+    const codexAvailable = detectedIdes.some((ide) => ide.configType === 'codex');
     if (codexAvailable) {
         const codexLocalResult = (0, codex_local_config_1.ensureCodexLocalConfig)(projectRoot);
         const status = codexLocalResult.created ? 'Created' : codexLocalResult.updated ? 'Updated' : 'Verified';
         console.log(chalk_1.default.green(`${status} project Codex config at ${codexLocalResult.path}`));
     }
     // Enable token telemetry for Claude Code (user-level, applies to all projects)
-    const claudeCodeAvailable = (0, ide_detector_1.detectInstalledIDEs)().some((ide) => ide.configType === 'claude-code') ||
-        (0, ide_detector_1.detectInstalledIDEs)('cli-runnable').some((ide) => ide.configType === 'claude-code');
+    const claudeCodeAvailable = detectedIdes.some((ide) => ide.configType === 'claude-code');
     if (claudeCodeAvailable) {
         (0, claude_code_telemetry_1.ensureClaudeCodeTelemetryEnv)();
     }
-    const adapterUpdates = (0, agent_adapters_1.ensureAgentAdapterFiles)(projectRoot);
+    const adapterUpdates = (0, agent_adapters_1.ensureAgentAdapterFiles)(projectRoot, detectedConfigTypes.length > 0 ? detectedConfigTypes : null);
     if (adapterUpdates.length > 0) {
         console.log(chalk_1.default.green(`Updated FRAIM agent adapter files: ${adapterUpdates.join(', ')}`));
     }

package/dist/src/cli/commands/setup.js

@@ -677,7 +677,7 @@ const runSetup = async (options) => {
             name: 'choice',
             message: 'How would you like to work with your AI employees?',
             choices: [
-                { title: 'In my IDE  (Claude Code, Cursor, or another AI tool)', value: 'ide' },
+                { title: 'In my IDE  (Claude Code, Cursor, Grok, or another AI tool)', value: 'ide' },
                 { title: 'In FRAIM Hub  (browser-based — no terminal needed)', value: 'hub' },
             ],
         });

package/dist/src/cli/commands/sync.js

@@ -47,6 +47,9 @@ const script_sync_utils_1 = require("../utils/script-sync-utils");
 const git_utils_1 = require("../../core/utils/git-utils");
 const agent_adapters_1 = require("../utils/agent-adapters");
 const fraim_gitignore_1 = require("../utils/fraim-gitignore");
+const user_config_1 = require("../utils/user-config");
+const ide_detector_1 = require("../setup/ide-detector");
+const remote_sync_1 = require("../utils/remote-sync");
 const project_fraim_paths_1 = require("../../core/utils/project-fraim-paths");
 function resolveExplicitLocalSyncUrl() {
     const candidates = [
@@ -83,9 +86,10 @@ function loadUserApiKey() {
         return undefined;
     }
 }
-function writeSyncMetadata(fraimDir, mode, remoteUrl) {
-    fs_1.default.mkdirSync(fraimDir, { recursive: true });
-    fs_1.default.writeFileSync(path_1.default.join(fraimDir, '.sync-metadata.json'), JSON.stringify({
+function writeSyncMetadata(mode, remoteUrl) {
+    const userDir = (0, project_fraim_paths_1.getUserFraimDirPath)();
+    fs_1.default.mkdirSync(userDir, { recursive: true });
+    fs_1.default.writeFileSync(path_1.default.join(userDir, '.sync-metadata.json'), JSON.stringify({
         localVersion: (0, version_utils_1.getFraimVersion)(),
         mode,
         remoteUrl,
@@ -109,6 +113,65 @@ function removeLegacyVersionFromConfig(fraimDir) {
         console.warn(chalk_1.default.yellow('Could not remove legacy version from config.json.'));
     }
 }
+function resolveAllowedConfigTypes() {
+    const persisted = (0, user_config_1.getInstalledIdes)();
+    const liveDetected = [
+        ...(0, ide_detector_1.detectInstalledIDEs)(),
+        ...(0, ide_detector_1.detectInstalledIDEs)('cli-runnable')
+    ].map((ide) => (0, ide_detector_1.getAdapterConfigType)(ide));
+    const liveSet = [...new Set(liveDetected)];
+    if (!persisted) {
+        return liveSet.length > 0 ? liveSet : null;
+    }
+    const merged = [...new Set([...persisted, ...liveSet])];
+    return merged.length > 0 ? merged : null;
+}
+async function cleanupStaleAdapterFiles(projectRoot, allowedConfigTypes) {
+    if (!allowedConfigTypes) {
+        return;
+    }
+    (0, project_fraim_paths_1.assertWorkspaceFraimRoot)(projectRoot);
+    const { execFile } = await Promise.resolve().then(() => __importStar(require('child_process')));
+    const { promisify } = await Promise.resolve().then(() => __importStar(require('util')));
+    const execFileAsync = promisify(execFile);
+    for (const [relPath, configType] of Object.entries((0, agent_adapters_1.getAdapterConfigTypes)())) {
+        if (configType === 'standard' || allowedConfigTypes.includes(configType)) {
+            continue;
+        }
+        const fullPath = path_1.default.join(projectRoot, relPath);
+        if (!fs_1.default.existsSync(fullPath)) {
+            continue;
+        }
+        try {
+            const content = fs_1.default.readFileSync(fullPath, 'utf8');
+            if (!content.includes(remote_sync_1.SYNCED_CONTENT_BANNER_MARKER)) {
+                continue;
+            }
+        }
+        catch {
+            continue;
+        }
+        try {
+            await execFileAsync('git', ['rm', '--cached', relPath], { cwd: projectRoot });
+        }
+        catch {
+            // Not tracked or git unavailable — still clean up from disk and gitignore.
+        }
+        try {
+            (0, fraim_gitignore_1.addToFraimGitignore)(projectRoot, relPath);
+        }
+        catch {
+            // Best-effort.
+        }
+        try {
+            fs_1.default.unlinkSync(fullPath);
+            console.log(chalk_1.default.green(`Removed stale FRAIM adapter file: ${relPath}`));
+        }
+        catch {
+            // Best-effort.
+        }
+    }
+}
 function failSync(mode, message) {
     if (mode === 'throw') {
         throw new Error(message);
@@ -222,9 +285,11 @@ const runSync = async (options) => {
         if (result.success) {
             console.log(chalk_1.default.green(`Successfully synced ${result.employeeJobsSynced} ai-employee jobs, ${result.managerJobsSynced} ai-manager jobs, ${result.skillsSynced} skills, ${result.rulesSynced} rules, ${result.scriptsSynced} scripts, and ${result.docsSynced} docs from local server`));
             removeLegacyVersionFromConfig(fraimDir);
-            writeSyncMetadata(fraimDir, 'local', localUrl);
+            writeSyncMetadata('local', localUrl);
             refreshLocalIgnoreConfig();
-            const adapterUpdates = (0, agent_adapters_1.ensureAgentAdapterFiles)(projectRoot);
+            const allowedTypes = resolveAllowedConfigTypes();
+            await cleanupStaleAdapterFiles(projectRoot, allowedTypes);
+            const adapterUpdates = (0, agent_adapters_1.ensureAgentAdapterFiles)(projectRoot, allowedTypes);
             if (adapterUpdates.length > 0) {
                 console.log(chalk_1.default.green(`Updated FRAIM agent adapter files: ${adapterUpdates.join(', ')}`));
             }
@@ -267,9 +332,11 @@ const runSync = async (options) => {
     }
     console.log(chalk_1.default.green(`Successfully synced ${result.employeeJobsSynced} ai-employee jobs, ${result.managerJobsSynced} ai-manager jobs, ${result.skillsSynced} skills, ${result.rulesSynced} rules, ${result.scriptsSynced} scripts, and ${result.docsSynced} docs from remote`));
     removeLegacyVersionFromConfig(fraimDir);
-    writeSyncMetadata(fraimDir, 'remote', config.remoteUrl || process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me');
+    writeSyncMetadata('remote', config.remoteUrl || process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me');
     refreshLocalIgnoreConfig();
-    const adapterUpdates = (0, agent_adapters_1.ensureAgentAdapterFiles)(projectRoot);
+    const allowedTypes = resolveAllowedConfigTypes();
+    await cleanupStaleAdapterFiles(projectRoot, allowedTypes);
+    const adapterUpdates = (0, agent_adapters_1.ensureAgentAdapterFiles)(projectRoot, allowedTypes);
     if (adapterUpdates.length > 0) {
         console.log(chalk_1.default.green(`Updated FRAIM agent adapter files: ${adapterUpdates.join(', ')}`));
     }

package/dist/src/cli/doctor/checks/ide-config-checks.js

@@ -35,8 +35,8 @@ function checkIDEsDetected() {
             return {
                 status: 'warning',
                 message: 'No IDEs detected',
-                suggestion: 'Install Claude Desktop, Cursor, or another supported IDE',
-                details: { supportedIDEs: ['Claude Desktop', 'Cursor', 'Windsurf', 'VS Code', 'Zed', 'Codex'] }
+                suggestion: 'Install Claude Desktop, Cursor, Grok, or another supported IDE',
+                details: { supportedIDEs: ['Claude Desktop', 'Cursor', 'Windsurf', 'VS Code', 'Zed', 'Codex', 'Grok'] }
             };
         }
     };

package/dist/src/cli/fraim.js

@@ -55,6 +55,7 @@ const first_run_1 = require("./commands/first-run");
 const workspace_config_1 = require("./commands/workspace-config");
 const org_1 = require("./commands/org");
 const manager_1 = require("./commands/manager");
+const cleanup_artifacts_1 = require("./commands/cleanup-artifacts");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const program = new commander_1.Command();
@@ -99,6 +100,7 @@ program.addCommand(first_run_1.firstRunCommand);
 program.addCommand(workspace_config_1.workspaceConfigCommand);
 program.addCommand(org_1.orgCommand);
 program.addCommand(manager_1.managerCommand);
+program.addCommand(cleanup_artifacts_1.cleanupArtifactsCommand);
 // Wait for async command initialization before parsing
 (async () => {
     // Import the initialization promise from setup command

package/dist/src/cli/mcp/ide-formats.js

@@ -2,7 +2,7 @@
 // IDE Format Adapters - transform logical server structure to IDE-specific formats
 // Uses the centralized registry to determine server types
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IDE_FORMATS = exports.CodexFormat = exports.WindsurfFormat = exports.ClaudeCodeFormat = exports.ClaudeFormat = exports.GeminiCliFormat = exports.VSCodeFormat = exports.KiroFormat = exports.StandardFormat = void 0;
+exports.IDE_FORMATS = exports.GrokFormat = exports.CodexFormat = exports.WindsurfFormat = exports.ClaudeCodeFormat = exports.ClaudeFormat = exports.GeminiCliFormat = exports.VSCodeFormat = exports.KiroFormat = exports.StandardFormat = void 0;
 exports.getIDEFormat = getIDEFormat;
 const mcp_server_registry_1 = require("./mcp-server-registry");
 const provider_registry_1 = require("../providers/provider-registry");
@@ -252,6 +252,13 @@ class CodexFormat {
     }
 }
 exports.CodexFormat = CodexFormat;
+class GrokFormat extends CodexFormat {
+    constructor() {
+        super(...arguments);
+        this.name = 'grok';
+    }
+}
+exports.GrokFormat = GrokFormat;
 // Format registry
 exports.IDE_FORMATS = {
     standard: new StandardFormat(),
@@ -261,7 +268,8 @@ exports.IDE_FORMATS = {
     claude: new ClaudeFormat(),
     'claude-code': new ClaudeCodeFormat(),
     windsurf: new WindsurfFormat(),
-    codex: new CodexFormat()
+    codex: new CodexFormat(),
+    grok: new GrokFormat()
 };
 function getIDEFormat(configType) {
     const format = exports.IDE_FORMATS[configType];

package/dist/src/cli/setup/auto-mcp-setup.js

@@ -187,7 +187,9 @@ const configureIDEMCP = async (ide, fraimKey, tokenInput, providerConfigs) => {
         }
         const newTomlContent = await (0, mcp_config_generator_1.generateMCPConfig)(ide.configType, fraimKey, tokens, providerConfigs);
         const { getAllMCPServerIds } = await Promise.resolve().then(() => __importStar(require('../mcp/mcp-server-registry')));
-        const serversToAdd = getAllMCPServerIds();
+        const baseServerIds = getAllMCPServerIds();
+        const providerServerIds = Object.keys(tokens).filter(id => tokens[id]);
+        const serversToAdd = [...baseServerIds, ...providerServerIds];
         const mergeResult = (0, mcp_config_generator_1.mergeTomlMCPServers)(existingTomlContent, newTomlContent, serversToAdd);
         fs_1.default.writeFileSync(configPath, mergeResult.content);
         mergeResult.addedServers.forEach(server => {
@@ -254,7 +256,7 @@ const autoConfigureMCP = async (fraimKey, tokenInput, selectedIDEs, providerConf
     const detectedIDEs = (0, ide_detector_1.detectInstalledIDEs)();
     if (detectedIDEs.length === 0 && (!selectedIDEs || selectedIDEs.length === 0)) {
         console.log(chalk_1.default.yellow('⚠️ No supported IDEs detected.'));
-        console.log(chalk_1.default.gray('Supported IDEs: Claude, Claude Code, Antigravity, Gemini CLI, Kiro, Cursor, VSCode, Codex, Windsurf'));
+        console.log(chalk_1.default.gray('Supported IDEs: Claude, Claude Code, Antigravity, Gemini CLI, Kiro, Cursor, VSCode, Codex, Grok, Windsurf'));
         console.log(chalk_1.default.blue('\n💡 You can install an IDE and run setup again later.'));
         console.log(chalk_1.default.gray('   Or continue with manual MCP configuration.'));
         if (process.env.FRAIM_NON_INTERACTIVE) {

package/dist/src/cli/setup/ide-detector.js

@@ -4,10 +4,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.expandPath = exports.findIDEByName = exports.getAllSupportedIDEs = exports.detectInstalledIDEs = exports.IDE_CONFIGS = void 0;
+exports.getAdapterConfigType = getAdapterConfigType;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
 const child_process_1 = require("child_process");
+/** Returns the configType to use for adapter file filtering. Falls back to configType when adapterConfigType is not set. */
+function getAdapterConfigType(ide) {
+    return ide.adapterConfigType ?? ide.configType;
+}
 const expandPath = (filePath) => {
     if (filePath.startsWith('~/')) {
         return path_1.default.join(os_1.default.homedir(), filePath.slice(2));
@@ -79,6 +84,13 @@ const detectCodexSurface = () => {
     ];
     return checkMultiplePaths(paths);
 };
+const detectGrokSurface = () => {
+    const paths = [
+        '~/.grok',
+        '~/.grok/config.toml'
+    ];
+    return checkMultiplePaths(paths);
+};
 exports.IDE_CONFIGS = [
     {
         name: 'Claude Code',
@@ -144,6 +156,7 @@ exports.IDE_CONFIGS = [
         configPath: '~/.cursor/mcp.json',
         configFormat: 'json',
         configType: 'kiro',
+        adapterConfigType: 'cursor',
         invocationProfile: 'cursor-mention',
         detectMethod: detectCursor,
         alternativePaths: [
@@ -180,6 +193,17 @@ exports.IDE_CONFIGS = [
         detectMethod: detectCodexSurface,
         description: 'Codex AI development environment'
     },
+    {
+        name: 'Grok',
+        configPath: '~/.grok/config.toml',
+        configFormat: 'toml',
+        configType: 'grok',
+        invocationProfile: 'grok-skill',
+        detectMethod: detectGrokSurface,
+        supportsConfigBootstrap: true,
+        aliases: ['grok', 'grok-cli', 'grok cli', 'grok build'],
+        description: 'xAI Grok Build CLI local settings'
+    },
     {
         name: 'Windsurf',
         configPath: '~/.codeium/windsurf/mcp_config.json',
@@ -219,6 +243,8 @@ const isDetectedForMode = (ide, mode) => {
                 return availableByVersionProbe('claude');
             case 'codex':
                 return availableByVersionProbe('codex');
+            case 'grok':
+                return availableByVersionProbe('grok');
             case 'gemini-cli':
                 return detectGeminiCli();
             default:

package/dist/src/cli/setup/ide-global-integration.js

@@ -35,7 +35,7 @@ function describeOnboardingInvocationSurfaces(installedIDEs) {
             return `${ide.name}: onboard this project`;
         if (profile === 'instructions-only')
             return `${ide.name}: "onboard this project"`;
-        // claude-slash, vscode-prompt, codex-skill, windsurf-command, kiro-hashtag, gemini-command
+        // claude-slash, vscode-prompt, codex-skill, grok-skill, windsurf-command, kiro-hashtag, gemini-command
         return `${ide.name}: /fraim onboard this project`;
     });
 }
@@ -55,7 +55,7 @@ async function installSlashCommands(homeDir) {
 }
 /**
  * Install FRAIM invocation artifacts for non-Claude IDEs.
- * Supports: Cursor, Codex, Gemini CLI, Windsurf, Kiro
+ * Supports: Cursor, Codex, Grok, Gemini CLI, Windsurf, Kiro
  * Does not overwrite existing files.
  */
 async function installGlobalRules(homeDir) {
@@ -68,6 +68,10 @@ async function installGlobalRules(homeDir) {
     if (fs_1.default.existsSync(codexDir)) {
         installFileIfMissing(path_1.default.join(codexDir, 'skills', 'fraim', 'SKILL.md'), (0, ide_invocation_surfaces_1.buildCodexSkillContent)(), 'Codex FRAIM skill (~/.codex/skills/fraim/SKILL.md)');
     }
+    const grokDir = path_1.default.join(home, '.grok');
+    if (fs_1.default.existsSync(grokDir)) {
+        installFileIfMissing(path_1.default.join(grokDir, 'skills', 'fraim', 'SKILL.md'), (0, ide_invocation_surfaces_1.buildGrokSkillContent)(), 'Grok FRAIM skill (~/.grok/skills/fraim/SKILL.md)');
+    }
     const geminiDir = path_1.default.join(home, '.gemini');
     if (fs_1.default.existsSync(geminiDir)) {
         installFileIfMissing(path_1.default.join(geminiDir, 'commands', 'fraim.toml'), (0, ide_invocation_surfaces_1.buildGeminiCommandContent)(), 'Gemini CLI FRAIM command (~/.gemini/commands/fraim.toml)');

package/dist/src/cli/setup/ide-invocation-surfaces.js

@@ -7,6 +7,7 @@ exports.buildClaudeCommandShimContent = buildClaudeCommandShimContent;
 exports.buildClaudeSlashCommandContent = buildClaudeSlashCommandContent;
 exports.buildCursorMentionRuleContent = buildCursorMentionRuleContent;
 exports.buildCodexSkillContent = buildCodexSkillContent;
+exports.buildGrokSkillContent = buildGrokSkillContent;
 exports.buildWindsurfCommandContent = buildWindsurfCommandContent;
 exports.buildKiroCommandContent = buildKiroCommandContent;
 exports.buildAntigravityCommandContent = buildAntigravityCommandContent;
@@ -95,13 +96,18 @@ ${buildFraimInvocationBody('generic-tool-discovery')}
 `;
 }
 function buildCodexSkillContent() {
-    return `# FRAIM
-
+    return `# FRAIM
+
 ${buildFraimInvocationBody('codex-tool-search')}`;
 }
+function buildGrokSkillContent() {
+    return `# FRAIM
+
+${buildFraimInvocationBody('generic-tool-discovery')}`;
+}
 function buildWindsurfCommandContent() {
-    return `# FRAIM
-
+    return `# FRAIM
+
 ${buildFraimInvocationBody('generic-tool-discovery')}`;
 }
 function buildKiroCommandContent() {
@@ -139,6 +145,8 @@ function describeInvocationSurface(ideName, invocationProfile) {
             return `${ideName}: /fraim via workspace prompt`;
         case 'codex-skill':
             return `${ideName}: /fraim, $fraim`;
+        case 'grok-skill':
+            return `${ideName}: /fraim`;
         case 'windsurf-command':
             return `${ideName}: /fraim`;
         case 'kiro-hashtag':

package/dist/src/cli/setup/mcp-config-generator.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateMCPConfig = exports.generateWindsurfMCPServers = exports.generateGeminiCliMCPServers = exports.generateVSCodeMCPServers = exports.generateCodexMCPServers = exports.generateKiroMCPServers = exports.generateClaudeCodeMCPServers = exports.generateClaudeMCPServers = exports.generateStandardMCPServers = exports.mergeTomlMCPServers = exports.extractTomlMcpServerBlock = void 0;
+exports.generateMCPConfig = exports.generateWindsurfMCPServers = exports.generateGeminiCliMCPServers = exports.generateVSCodeMCPServers = exports.generateGrokMCPServers = exports.generateCodexMCPServers = exports.generateKiroMCPServers = exports.generateClaudeCodeMCPServers = exports.generateClaudeMCPServers = exports.generateStandardMCPServers = exports.mergeTomlMCPServers = exports.extractTomlMcpServerBlock = void 0;
 const mcp_server_builder_1 = require("../mcp/mcp-server-builder");
 const ide_formats_1 = require("../mcp/ide-formats");
 const normalizeTokens = (tokenInput) => {
@@ -151,6 +151,15 @@ const generateCodexMCPServers = async (fraimKey, tokenInput, providerConfigs) =>
     return format.transform(builder.getServers());
 };
 exports.generateCodexMCPServers = generateCodexMCPServers;
+const generateGrokMCPServers = async (fraimKey, tokenInput, providerConfigs) => {
+    const tokens = normalizeTokens(tokenInput);
+    const builder = new mcp_server_builder_1.MCPServerBuilder();
+    builder.addBaseServers(fraimKey);
+    await addProviderServers(builder, tokens, providerConfigs);
+    const format = (0, ide_formats_1.getIDEFormat)('grok');
+    return format.transform(builder.getServers());
+};
+exports.generateGrokMCPServers = generateGrokMCPServers;
 const generateVSCodeMCPServers = async (fraimKey, tokenInput, providerConfigs) => {
     const tokens = normalizeTokens(tokenInput);
     const builder = new mcp_server_builder_1.MCPServerBuilder();
@@ -194,6 +203,8 @@ const generateMCPConfig = async (configType, fraimKey, tokenInput, providerConfi
             return await (0, exports.generateGeminiCliMCPServers)(fraimKey, tokenInput, providerConfigs);
         case 'codex':
             return await (0, exports.generateCodexMCPServers)(fraimKey, tokenInput, providerConfigs);
+        case 'grok':
+            return await (0, exports.generateGrokMCPServers)(fraimKey, tokenInput, providerConfigs);
         case 'windsurf':
             return await (0, exports.generateWindsurfMCPServers)(fraimKey, tokenInput, providerConfigs);
         default:

package/dist/src/cli/utils/agent-adapters.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAdapterConfigTypes = getAdapterConfigTypes;
 exports.ensureAgentAdapterFiles = ensureAgentAdapterFiles;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
@@ -15,6 +16,7 @@ const CLAUDE_FRAIM_COMMAND_PATH = path_1.default.join('.claude', 'commands', 'fr
 const CLAUDE_FRAIM_SKILL_PATH = path_1.default.join('.claude', 'skills', 'fraim', 'SKILL.md');
 const VSCODE_FRAIM_PROMPT_PATH = path_1.default.join('.github', 'prompts', 'fraim.prompt.md');
 const CODEX_FRAIM_SKILL_PATH = path_1.default.join('.codex', 'skills', 'fraim', 'SKILL.md');
+const GROK_FRAIM_SKILL_PATH = path_1.default.join('.grok', 'skills', 'fraim', 'SKILL.md');
 const GEMINI_FRAIM_COMMAND_PATH = path_1.default.join('.gemini', 'commands', 'fraim.toml');
 const GEMINI_PROJECT_INSTRUCTIONS_PATH = path_1.default.join('.gemini', 'GEMINI.md');
 const WINDSURF_FRAIM_COMMAND_PATH = path_1.default.join('.windsurf', 'commands', 'fraim.md');
@@ -46,7 +48,7 @@ function mergeCursorRule(existingContent, managedSection) {
     const mergedBody = mergeManagedSection(bodyWithoutLeadingFrontmatter, managedSection).trim();
     return `${ide_invocation_surfaces_1.CURSOR_MDC_FRONTMATTER}\n\n${mergedBody}\n`;
 }
-function getAdapterFiles() {
+function getAdapterFiles(allowedConfigTypes = null) {
     const fraimRoot = (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)().replace(/\/$/, '');
     const employeeJobsPath = (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('ai-employee/jobs');
     const managerJobsPath = (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('ai-manager/jobs');
@@ -108,26 +110,48 @@ ${(0, ide_invocation_surfaces_1.buildFraimInvocationBody)('generic-tool-discover
 
 @../AGENTS.md
 `;
-    return [
-        { path: 'AGENTS.md', content: markdownBody },
-        { path: 'CLAUDE.md', content: markdownBody },
-        { path: path_1.default.join('.github', 'copilot-instructions.md'), content: copilotBody },
-        { path: CURSOR_RULE_PATH, content: cursorManagedBody },
-        { path: VSCODE_FRAIM_PROMPT_PATH, content: vscodePrompt },
-        { path: path_1.default.join(project_fraim_paths_1.WORKSPACE_FRAIM_DIRNAME, 'README.md'), content: fraimReadme },
-        { path: CLAUDE_FRAIM_SKILL_PATH, content: (0, ide_invocation_surfaces_1.buildClaudeSkillContent)() },
-        { path: CLAUDE_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildClaudeCommandShimContent)() },
-        { path: CODEX_FRAIM_SKILL_PATH, content: (0, ide_invocation_surfaces_1.buildCodexSkillContent)() },
-        { path: GEMINI_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildGeminiCommandContent)() },
-        { path: GEMINI_PROJECT_INSTRUCTIONS_PATH, content: geminiProjectInstructions },
-        { path: WINDSURF_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildWindsurfCommandContent)() },
-        { path: KIRO_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildKiroCommandContent)() }
+    const all = [
+        { path: 'AGENTS.md', content: markdownBody, configType: 'standard' },
+        { path: 'CLAUDE.md', content: markdownBody, configType: 'standard' },
+        { path: path_1.default.join('.github', 'copilot-instructions.md'), content: copilotBody, configType: 'vscode' },
+        { path: CURSOR_RULE_PATH, content: cursorManagedBody, configType: 'cursor' },
+        { path: VSCODE_FRAIM_PROMPT_PATH, content: vscodePrompt, configType: 'vscode' },
+        { path: path_1.default.join(project_fraim_paths_1.WORKSPACE_FRAIM_DIRNAME, 'README.md'), content: fraimReadme, configType: 'standard' },
+        { path: CLAUDE_FRAIM_SKILL_PATH, content: (0, ide_invocation_surfaces_1.buildClaudeSkillContent)(), configType: 'claude-code' },
+        { path: CLAUDE_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildClaudeCommandShimContent)(), configType: 'claude-code' },
+        { path: CODEX_FRAIM_SKILL_PATH, content: (0, ide_invocation_surfaces_1.buildCodexSkillContent)(), configType: 'codex' },
+        { path: GROK_FRAIM_SKILL_PATH, content: (0, ide_invocation_surfaces_1.buildGrokSkillContent)(), configType: 'grok' },
+        { path: GEMINI_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildGeminiCommandContent)(), configType: 'gemini-cli' },
+        { path: GEMINI_PROJECT_INSTRUCTIONS_PATH, content: geminiProjectInstructions, configType: 'gemini-cli' },
+        { path: WINDSURF_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildWindsurfCommandContent)(), configType: 'windsurf' },
+        { path: KIRO_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildKiroCommandContent)(), configType: 'kiro' }
     ];
+    if (allowedConfigTypes === null) {
+        return all;
+    }
+    return all.filter(f => f.configType === 'standard' || allowedConfigTypes.includes(f.configType));
+}
+function getAdapterConfigTypes() {
+    const result = {};
+    for (const f of getAdapterFiles()) {
+        result[f.path.replace(/\\/g, '/')] = f.configType;
+    }
+    return result;
 }
-function ensureAgentAdapterFiles(projectRoot) {
+function ensureAgentAdapterFiles(projectRoot, allowedConfigTypes = null) {
+    (0, project_fraim_paths_1.assertWorkspaceFraimRoot)(projectRoot);
     const updatedPaths = [];
-    for (const file of getAdapterFiles()) {
+    const resolvedProjectRoot = path_1.default.resolve(projectRoot);
+    for (const file of getAdapterFiles(allowedConfigTypes)) {
         const fullPath = path_1.default.join(projectRoot, file.path);
+        const resolvedFullPath = path_1.default.resolve(fullPath);
+        const relativeToProject = path_1.default.relative(resolvedProjectRoot, resolvedFullPath);
+        if (relativeToProject === '' || relativeToProject.startsWith('..') || path_1.default.isAbsolute(relativeToProject)) {
+            throw new Error(`Refusing to write FRAIM adapter outside project root: ${resolvedFullPath}`);
+        }
+        if (file.path.replace(/\\/g, '/').startsWith(`${project_fraim_paths_1.WORKSPACE_FRAIM_DIRNAME}/`)) {
+            (0, project_fraim_paths_1.assertWorkspaceFraimPath)(projectRoot, fullPath);
+        }
         const dir = path_1.default.dirname(fullPath);
         if (!fs_1.default.existsSync(dir)) {
             fs_1.default.mkdirSync(dir, { recursive: true });
@@ -140,6 +164,7 @@ function ensureAgentAdapterFiles(projectRoot) {
                 || file.path === CLAUDE_FRAIM_SKILL_PATH
                 || file.path === CLAUDE_FRAIM_COMMAND_PATH
                 || file.path === CODEX_FRAIM_SKILL_PATH
+                || file.path === GROK_FRAIM_SKILL_PATH
                 || file.path === GEMINI_FRAIM_COMMAND_PATH
                 || file.path === GEMINI_PROJECT_INSTRUCTIONS_PATH
                 || file.path === WINDSURF_FRAIM_COMMAND_PATH

package/dist/src/cli/utils/fraim-gitignore.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ensureFraimSyncedContentLocallyExcluded = exports.removeFraimSyncedContentGitignoreBlock = exports.FRAIM_SYNC_GITIGNORE_ENTRIES = exports.FRAIM_SYNC_GITIGNORE_END = exports.FRAIM_SYNC_GITIGNORE_START = void 0;
+exports.addToFraimGitignore = addToFraimGitignore;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 exports.FRAIM_SYNC_GITIGNORE_START = '# BEGIN FRAIM SYNCED CONTENT';
@@ -73,6 +74,18 @@ const removeFraimSyncedContentGitignoreBlock = (projectRoot) => {
     return true;
 };
 exports.removeFraimSyncedContentGitignoreBlock = removeFraimSyncedContentGitignoreBlock;
+function addToFraimGitignore(projectRoot, entry) {
+    const gitignorePath = path_1.default.join(projectRoot, '.gitignore');
+    const existing = fs_1.default.existsSync(gitignorePath) ? fs_1.default.readFileSync(gitignorePath, 'utf8') : '';
+    const lines = existing.replace(/\r\n/g, '\n').split('\n');
+    if (lines.includes(entry)) {
+        return;
+    }
+    const appended = existing.trimEnd().length > 0
+        ? `${existing.trimEnd()}\n${entry}\n`
+        : `${entry}\n`;
+    fs_1.default.writeFileSync(gitignorePath, appended, 'utf8');
+}
 const ensureFraimSyncedContentLocallyExcluded = (projectRoot) => {
     const gitignoreUpdated = (0, exports.removeFraimSyncedContentGitignoreBlock)(projectRoot);
     const excludePath = resolveGitInfoExcludePath(projectRoot);