fraim-framework 2.0.77 → 2.0.80

package/README.md

@@ -233,6 +233,34 @@ npm install -g fraim-framework
 fraim setup  # Complete setup with IDE configuration
 ```
 
+The setup command supports three modes:
+
+**Conversational Mode**: AI workflows only, no platform integration required
+```bash
+fraim setup --key=<your-fraim-key>
+# Select "Conversational Mode" when prompted
+```
+
+**Integrated Mode**: Single platform for both code hosting and issue tracking
+```bash
+fraim setup --key=<your-fraim-key>
+# Select "Integrated Mode" when prompted
+# Choose platform: GitHub, Azure DevOps, or GitLab
+```
+
+**Split Mode**: Separate platforms for code hosting and issue tracking
+```bash
+fraim setup --key=<your-fraim-key>
+# Select "Split Mode" when prompted
+# Choose code repository platform: GitHub, Azure DevOps, or GitLab
+# Choose issue tracking platform: GitHub, Azure DevOps, GitLab, or Jira
+```
+
+Common Split mode combinations:
+- GitHub (code) + Jira (issues)
+- GitLab (code) + Jira (issues)
+- Azure DevOps (code) + GitHub (issues)
+
 ### **🔧 Additional Commands**
 
 After initial setup, you can use these commands:
@@ -244,6 +272,12 @@ fraim add-ide --ide antigravity     # Configure Gemini Antigravity
 fraim add-ide --all                 # Configure all detected IDEs
 fraim add-ide --list                # List supported IDEs
 
+# Add platform integrations to existing setup
+fraim setup --github                # Add GitHub integration
+fraim setup --ado                   # Add Azure DevOps integration
+fraim setup --gitlab                # Add GitLab integration
+fraim setup --jira                  # Add Jira integration
+
 # Project initialization
 fraim init-project                  # Initialize FRAIM in current project
 
@@ -255,7 +289,49 @@ fraim doctor                        # Diagnose configuration issues
 fraim sync                          # Sync latest workflows and rules
 ```
 
-**💡 Pro Tip**: Use `fraim add-ide` when you install a new IDE after initial setup. It reuses your existing FRAIM and GitHub keys, making it much faster than running full setup again.
+**💡 Pro Tip**: Use `fraim add-ide` when you install a new IDE after initial setup. It reuses your existing FRAIM and platform tokens, making it much faster than running full setup again.
+
+### **🔧 Jira Integration Setup**
+
+FRAIM uses the official Model Context Protocol (MCP) server for Jira integration. The setup command automatically configures the correct format.
+
+**Jira API Token Requirements**:
+1. Go to https://id.atlassian.com/manage-profile/security/api-tokens
+2. Click "Create API token"
+3. Give it a name (e.g., "FRAIM Integration")
+4. Copy the token (starts with ATATT3...)
+5. Use this token during `fraim setup`
+
+**Correct MCP Configuration** (automatically generated):
+```json
+{
+  "jira": {
+    "command": "npx",
+    "args": ["-y", "@modelcontextprotocol/server-jira"],
+    "env": {
+      "JIRA_API_TOKEN": "your-token-here"
+    }
+  }
+}
+```
+
+**⚠️ Common Issues**:
+- **Old configuration format**: If you see `https://mcp.atlassian.com/v1/sse` in your config, this is incorrect. Run `fraim setup --jira` to update.
+- **Token format**: Jira API tokens typically start with `ATATT3`. If your token doesn't match this format, verify you created an API token (not a personal access token).
+- **First run slow**: The first time `npx` runs the Jira MCP server, it downloads the package. This is normal and only happens once.
+
+**Troubleshooting**:
+```bash
+# Test Jira MCP connection
+fraim test-mcp
+
+# Reconfigure Jira integration
+fraim setup --jira
+
+# Check configuration
+cat ~/.kiro/settings/mcp.json  # For Kiro IDE
+cat ~/Library/Application\ Support/Claude/claude_desktop_config.json  # For Claude Desktop (macOS)
+```
 
 
 ## 🌟 **Why FRAIM is the Future**

package/bin/fraim-mcp.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * FRAIM MCP Server - Smart Entry Point

package/bin/fraim.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * FRAIM Framework CLI Entry Point

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

@@ -9,12 +9,12 @@ const chalk_1 = __importDefault(require("chalk"));
 const prompts_1 = __importDefault(require("prompts"));
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
-const os_1 = __importDefault(require("os"));
 const ide_detector_1 = require("../setup/ide-detector");
 const mcp_config_generator_1 = require("../setup/mcp-config-generator");
 const codex_local_config_1 = require("../setup/codex-local-config");
+const script_sync_utils_1 = require("../utils/script-sync-utils");
 const loadGlobalConfig = () => {
-    const globalConfigPath = path_1.default.join(os_1.default.homedir(), '.fraim', 'config.json');
+    const globalConfigPath = path_1.default.join((0, script_sync_utils_1.getUserFraimDir)(), 'config.json');
     if (!fs_1.default.existsSync(globalConfigPath)) {
         return null;
     }
@@ -23,7 +23,10 @@ const loadGlobalConfig = () => {
         return {
             fraimKey: config.apiKey,
             githubToken: config.tokens?.github || config.githubToken, // Support both old and new format
-            mode: config.mode
+            gitlabToken: config.tokens?.gitlab,
+            jiraToken: config.tokens?.jira,
+            mode: config.mode,
+            jiraConfig: config.jiraConfig
         };
     }
     catch (e) {
@@ -75,7 +78,7 @@ const promptForGitHubToken = async (isConversationalMode = false) => {
     return tokenResponse.token;
 };
 const saveGitHubTokenToConfig = (githubToken) => {
-    const globalConfigPath = path_1.default.join(os_1.default.homedir(), '.fraim', 'config.json');
+    const globalConfigPath = path_1.default.join((0, script_sync_utils_1.getUserFraimDir)(), 'config.json');
     if (fs_1.default.existsSync(globalConfigPath)) {
         try {
             const config = JSON.parse(fs_1.default.readFileSync(globalConfigPath, 'utf8'));
@@ -95,7 +98,7 @@ const saveGitHubTokenToConfig = (githubToken) => {
     }
 };
 exports.saveGitHubTokenToConfig = saveGitHubTokenToConfig;
-const configureIDEMCP = async (ide, fraimKey, githubToken) => {
+const configureIDEMCP = async (ide, fraimKey, tokens, jiraConfig) => {
     const configPath = (0, ide_detector_1.expandPath)(ide.configPath);
     console.log(chalk_1.default.blue(`🔧 Configuring ${ide.name}...`));
     // Create backup if config exists
@@ -112,10 +115,11 @@ const configureIDEMCP = async (ide, fraimKey, githubToken) => {
     }
     let existingConfig = {};
     let existingMCPServers = {};
+    const serversKey = ide.configType === 'vscode' ? 'servers' : 'mcpServers';
     if (fs_1.default.existsSync(configPath) && ide.configFormat === 'json') {
         try {
             existingConfig = JSON.parse(fs_1.default.readFileSync(configPath, 'utf8'));
-            existingMCPServers = existingConfig.mcpServers || {};
+            existingMCPServers = existingConfig[serversKey] || {};
             console.log(chalk_1.default.gray(`  📋 Found existing config with ${Object.keys(existingMCPServers).length} MCP servers`));
         }
         catch (e) {
@@ -129,8 +133,8 @@ const configureIDEMCP = async (ide, fraimKey, githubToken) => {
             existingTomlContent = fs_1.default.readFileSync(configPath, 'utf8');
             console.log(chalk_1.default.gray(`  📋 Found existing TOML config`));
         }
-        const newTomlContent = (0, mcp_config_generator_1.generateMCPConfig)(ide.configType, fraimKey, githubToken);
-        const serversToAdd = ['fraim', 'git', 'github', 'playwright'];
+        const newTomlContent = (0, mcp_config_generator_1.generateMCPConfig)(ide.configType, fraimKey, tokens, jiraConfig);
+        const serversToAdd = ['fraim', 'git', 'github', 'gitlab', 'jira', 'playwright'];
         const mergeResult = (0, mcp_config_generator_1.mergeTomlMCPServers)(existingTomlContent, newTomlContent, serversToAdd);
         fs_1.default.writeFileSync(configPath, mergeResult.content);
         mergeResult.addedServers.forEach(server => {
@@ -144,9 +148,9 @@ const configureIDEMCP = async (ide, fraimKey, githubToken) => {
         });
     }
     else {
-        // Handle JSON format
-        const newConfig = (0, mcp_config_generator_1.generateMCPConfig)(ide.configType, fraimKey, githubToken);
-        const newMCPServers = newConfig.mcpServers || {};
+        // For JSON configs - intelligent merging
+        const newConfig = (0, mcp_config_generator_1.generateMCPConfig)(ide.configType, fraimKey, tokens, jiraConfig);
+        const newMCPServers = newConfig[serversKey] || newConfig.mcpServers || {};
         // Merge MCP servers intelligently
         const mergedMCPServers = { ...existingMCPServers };
         const addedServers = [];
@@ -164,7 +168,7 @@ const configureIDEMCP = async (ide, fraimKey, githubToken) => {
         const mergedConfig = {
             ...existingConfig,
             ...newConfig,
-            mcpServers: mergedMCPServers
+            [serversKey]: mergedMCPServers
         };
         // Write updated config
         fs_1.default.writeFileSync(configPath, JSON.stringify(mergedConfig, null, 2));
@@ -197,7 +201,7 @@ const listSupportedIDEs = () => {
     console.log(chalk_1.default.yellow('💡 Use "fraim add-ide --ide <name>" to configure a specific IDE'));
     console.log(chalk_1.default.yellow('   Example: fraim add-ide --ide claude'));
 };
-const promptForIDESelection = async (availableIDEs, githubToken) => {
+const promptForIDESelection = async (availableIDEs, tokens) => {
     console.log(chalk_1.default.green(`✅ Found ${availableIDEs.length} IDEs that can be configured:\n`));
     availableIDEs.forEach((ide, index) => {
         const configExists = fs_1.default.existsSync((0, ide_detector_1.expandPath)(ide.configPath));
@@ -208,10 +212,16 @@ const promptForIDESelection = async (availableIDEs, githubToken) => {
     console.log(chalk_1.default.blue('\nFRAIM will add these MCP servers:'));
     console.log(chalk_1.default.gray('   • fraim (workflows and AI management)'));
     console.log(chalk_1.default.gray('   • git (version control integration)'));
-    if (githubToken) {
-        console.log(chalk_1.default.gray('   • github (GitHub API access)'));
+    if (tokens?.github) {
+        console.log(chalk_1.default.gray('   - github (GitHub API access)'));
     }
-    console.log(chalk_1.default.gray('   • playwright (browser automation)'));
+    if (tokens?.gitlab) {
+        console.log(chalk_1.default.gray('   - gitlab (GitLab API access)'));
+    }
+    if (tokens?.jira) {
+        console.log(chalk_1.default.gray('   - jira (Jira issue tracking)'));
+    }
+    console.log(chalk_1.default.gray('   - playwright (browser automation)'));
     const response = await (0, prompts_1.default)({
         type: 'text',
         name: 'selection',
@@ -250,12 +260,18 @@ const runAddIDE = async (options) => {
         process.exit(1);
     }
     let githubToken = globalConfig.githubToken;
+    const platformTokens = {
+        github: globalConfig.githubToken,
+        gitlab: globalConfig.gitlabToken,
+        jira: globalConfig.jiraToken
+    };
     const isConversationalMode = globalConfig.mode === 'conversational';
-    if (!githubToken && !isConversationalMode) {
+    if (!githubToken && !platformTokens.gitlab && !platformTokens.jira && !isConversationalMode) {
         console.log(chalk_1.default.yellow('⚠️ No GitHub token found in configuration.'));
         githubToken = await promptForGitHubToken(false);
         if (githubToken) {
             saveGitHubTokenToConfig(githubToken);
+            platformTokens.github = githubToken;
         }
     }
     if (isConversationalMode && !githubToken) {
@@ -295,7 +311,7 @@ const runAddIDE = async (options) => {
     }
     else {
         // Interactive selection
-        idesToConfigure = await promptForIDESelection(detectedIDEs, githubToken);
+        idesToConfigure = await promptForIDESelection(detectedIDEs, platformTokens);
     }
     if (idesToConfigure.length === 0) {
         console.log(chalk_1.default.yellow('⚠️ No IDEs selected for configuration.'));
@@ -308,7 +324,7 @@ const runAddIDE = async (options) => {
     };
     for (const ide of idesToConfigure) {
         try {
-            await configureIDEMCP(ide, globalConfig.fraimKey, githubToken || '');
+            await configureIDEMCP(ide, globalConfig.fraimKey, platformTokens, globalConfig.jiraConfig);
             results.successful.push(ide.name);
         }
         catch (error) {
@@ -341,7 +357,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, antigravity, kiro, cursor, vscode, codex, windsurf)')
+    .option('--ide <name>', 'Configure specific IDE (claude, claude-code, antigravity, kiro, cursor, vscode, codex, 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/init-project.js

@@ -75,12 +75,19 @@ const runInitProject = async () => {
                         owner: detection.repository.owner,
                         name: detection.repository.name
                     }
-                    : {
-                        provider: 'ado',
-                        organization: detection.repository.organization,
-                        project: detection.repository.project,
-                        name: detection.repository.name
-                    };
+                    : detection.provider === 'ado'
+                        ? {
+                            provider: 'ado',
+                            organization: detection.repository.organization,
+                            project: detection.repository.project,
+                            name: detection.repository.name
+                        }
+                        : {
+                            provider: 'gitlab',
+                            namespace: detection.repository.namespace,
+                            name: detection.repository.name,
+                            projectPath: detection.repository.projectPath
+                        };
                 config = {
                     version: (0, version_utils_1.getFraimVersion)(),
                     project: {
@@ -99,6 +106,10 @@ const runInitProject = async () => {
                     console.log(chalk_1.default.gray(`   Project: ${detection.repository.project}`));
                     console.log(chalk_1.default.gray(`   Repository: ${detection.repository.name}`));
                 }
+                else if (detection.provider === 'gitlab') {
+                    console.log(chalk_1.default.gray(`   Namespace: ${detection.repository.namespace || '(none)'}`));
+                    console.log(chalk_1.default.gray(`   Repository: ${detection.repository.name}`));
+                }
             }
             else {
                 config = {