fraim-framework 2.0.62 → 2.0.64

package/bin/fraim-mcp.js

@@ -1,14 +1,30 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 /**
- * FRAIM MCP Server Entry Point
+ * FRAIM Local MCP Proxy
  * 
- * This is called by MCP clients (Cursor, Claude Desktop, Windsurf, Kiro, etc.)
- * It starts the local STDIO MCP server that proxies to the remote FRAIM server
- * and performs template substitution.
+ * This is a thin wrapper that launches the local STDIO MCP server.
+ * The actual implementation is in dist/src/local-mcp-server/stdio-server.js
  */
 
-// Load and start the server
-const { FraimLocalMCPServer } = require('../dist/src/local-mcp-server/stdio-server.js');
+const path = require('path');
+const { spawn } = require('child_process');
 
-const server = new FraimLocalMCPServer();
-server.start();
+// Path to the actual server implementation
+const serverPath = path.join(__dirname, '..', 'dist', 'src', 'local-mcp-server', 'stdio-server.js');
+
+// Spawn the server with all arguments and environment variables
+const server = spawn('node', [serverPath, ...process.argv.slice(2)], {
+    stdio: 'inherit',
+    env: process.env
+});
+
+// Forward exit code
+server.on('exit', (code) => {
+    process.exit(code || 0);
+});
+
+// Handle errors
+server.on('error', (err) => {
+    console.error('Failed to start FRAIM MCP server:', err);
+    process.exit(1);
+});

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

@@ -10,22 +10,38 @@ const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
 const chalk_1 = __importDefault(require("chalk"));
 const sync_1 = require("./sync");
-const types_1 = require("../../fraim/types");
-const git_utils_1 = require("../../utils/git-utils");
+const platform_detection_1 = require("../../utils/platform-detection");
 const version_utils_1 = require("../../utils/version-utils");
 const checkGlobalSetup = () => {
     const globalConfigPath = path_1.default.join(os_1.default.homedir(), '.fraim', 'config.json');
-    return fs_1.default.existsSync(globalConfigPath);
+    if (!fs_1.default.existsSync(globalConfigPath)) {
+        return { exists: false };
+    }
+    try {
+        const config = JSON.parse(fs_1.default.readFileSync(globalConfigPath, 'utf8'));
+        return {
+            exists: true,
+            mode: config.mode || 'integrated', // Default to integrated for backward compatibility
+            tokens: config.tokens || {}
+        };
+    }
+    catch (e) {
+        return { exists: true, mode: 'integrated', tokens: {} };
+    }
 };
 const runInitProject = async () => {
     console.log(chalk_1.default.blue('🚀 Initializing FRAIM project...'));
     // Check if global setup exists
-    if (!checkGlobalSetup()) {
+    const globalSetup = checkGlobalSetup();
+    if (!globalSetup.exists) {
         console.log(chalk_1.default.red('❌ Global FRAIM setup not found.'));
         console.log(chalk_1.default.yellow('Please run global setup first:'));
-        console.log(chalk_1.default.cyan('   fraim setup --key=<your-fraim-key>'));
+        console.log(chalk_1.default.cyan('   fraim setup'));
         process.exit(1);
     }
+    const mode = globalSetup.mode;
+    const tokens = globalSetup.tokens || {};
+    console.log(chalk_1.default.gray(`   Mode: ${mode === 'conversational' ? 'Conversational' : 'Integrated'} (from global config)`));
     const projectRoot = process.cwd();
     const fraimDir = path_1.default.join(projectRoot, '.fraim');
     const configPath = path_1.default.join(fraimDir, 'config.json');
@@ -37,28 +53,84 @@ const runInitProject = async () => {
         console.log(chalk_1.default.yellow('ℹ️  .fraim directory already exists'));
     }
     if (!fs_1.default.existsSync(configPath)) {
-        const remoteInfo = (0, git_utils_1.getGitRemoteInfo)();
-        // Git remote is optional for project init
-        const repoOwner = remoteInfo.owner || 'your-username';
-        const repoName = remoteInfo.repo || path_1.default.basename(projectRoot);
-        const repoUrl = remoteInfo.owner && remoteInfo.repo
-            ? `https://github.com/${remoteInfo.owner}/${remoteInfo.repo}.git`
-            : `https://github.com/${repoOwner}/${repoName}.git`;
-        const config = {
-            ...types_1.DEFAULT_FRAIM_CONFIG,
-            version: (0, version_utils_1.getFraimVersion)(),
-            project: {
-                ...types_1.DEFAULT_FRAIM_CONFIG.project,
-                name: repoName
-            },
-            repository: {
-                provider: 'github',
-                owner: repoOwner,
-                name: repoName,
-                url: repoUrl,
-                defaultBranch: remoteInfo.defaultBranch || 'main'
+        let config;
+        if (mode === 'conversational') {
+            // Conversational mode - no platform integration
+            const projectName = path_1.default.basename(projectRoot);
+            config = {
+                version: (0, version_utils_1.getFraimVersion)(),
+                project: {
+                    name: projectName
+                },
+                mode: 'conversational',
+                customizations: {
+                    workflowsPath: '.fraim/workflows'
+                }
+            };
+            console.log(chalk_1.default.blue('   Conversational mode: No platform integration'));
+            console.log(chalk_1.default.gray(`   Project: ${projectName}`));
+        }
+        else {
+            // Integrated mode - try to detect platform
+            const detection = (0, platform_detection_1.detectPlatformFromGit)();
+            if (detection.provider !== 'unknown' && detection.repository) {
+                // Check if we have the appropriate token
+                const hasToken = detection.provider === 'github' ? tokens.github : tokens.ado;
+                if (!hasToken) {
+                    console.log(chalk_1.default.yellow(`\n⚠️  Warning: ${detection.provider.toUpperCase()} repository detected but no token configured`));
+                    console.log(chalk_1.default.gray(`   Platform features will be limited.`));
+                    console.log(chalk_1.default.cyan(`   Run: fraim setup --${detection.provider === 'github' ? 'github' : 'ado'}\n`));
+                }
+                // Use detected repository info
+                config = {
+                    version: (0, version_utils_1.getFraimVersion)(),
+                    project: {
+                        name: detection.repository.name
+                    },
+                    repository: detection.repository,
+                    mode: 'integrated',
+                    customizations: {
+                        workflowsPath: '.fraim/workflows'
+                    }
+                };
+                console.log(chalk_1.default.blue(`   Detected ${detection.provider.toUpperCase()} repository`));
+                if (detection.provider === 'github') {
+                    console.log(chalk_1.default.gray(`   Repository: ${detection.repository.owner}/${detection.repository.name}`));
+                    console.log(chalk_1.default.gray(`   Token: ${hasToken ? '✓ Configured' : '✗ Missing'}`));
+                }
+                else if (detection.provider === 'ado') {
+                    console.log(chalk_1.default.gray(`   Organization: ${detection.repository.organization}`));
+                    console.log(chalk_1.default.gray(`   Project: ${detection.repository.project}`));
+                    console.log(chalk_1.default.gray(`   Repository: ${detection.repository.name}`));
+                    console.log(chalk_1.default.gray(`   Token: ${hasToken ? '✓ Configured' : '✗ Missing'}`));
+                }
             }
-        };
+            else {
+                // No git remote detected - warn user
+                console.log(chalk_1.default.yellow('   ⚠️  No git remote detected'));
+                console.log(chalk_1.default.yellow('   Integrated mode requires a git remote for platform features.'));
+                console.log(chalk_1.default.gray('   Creating config with placeholder values...'));
+                const repoName = path_1.default.basename(projectRoot);
+                config = {
+                    version: (0, version_utils_1.getFraimVersion)(),
+                    project: {
+                        name: repoName
+                    },
+                    repository: {
+                        provider: 'github',
+                        owner: 'your-username',
+                        name: repoName,
+                        url: `https://github.com/your-username/${repoName}.git`,
+                        defaultBranch: 'main'
+                    },
+                    mode: 'integrated',
+                    customizations: {
+                        workflowsPath: '.fraim/workflows'
+                    }
+                };
+                console.log(chalk_1.default.gray('   Please update .fraim/config.json with your repository details.'));
+            }
+        }
         fs_1.default.writeFileSync(configPath, JSON.stringify(config, null, 2));
         console.log(chalk_1.default.green('✅ Created .fraim/config.json'));
     }

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

@@ -10,10 +10,10 @@ const path_1 = __importDefault(require("path"));
 const chalk_1 = __importDefault(require("chalk"));
 const first_run_1 = require("../setup/first-run");
 const sync_1 = require("./sync");
-const git_utils_1 = require("../../utils/git-utils");
+const platform_detection_1 = require("../../utils/platform-detection");
 const version_utils_1 = require("../../utils/version-utils");
 const script_sync_utils_1 = require("../../utils/script-sync-utils");
-const runInit = async () => {
+const runInit = async (options = {}) => {
     const projectRoot = process.cwd();
     const fraimDir = path_1.default.join(projectRoot, '.fraim');
     const configPath = path_1.default.join(fraimDir, 'config.json');
@@ -26,28 +26,85 @@ const runInit = async () => {
         console.log(chalk_1.default.yellow('ℹ️  .fraim directory already exists'));
     }
     if (!fs_1.default.existsSync(configPath)) {
-        const remoteInfo = (0, git_utils_1.getGitRemoteInfo)();
-        if (!remoteInfo.repo) {
-            console.log(chalk_1.default.red('❌ Error: No git remote found. FRAIM requires a git repository with remote origin.'));
-            console.log(chalk_1.default.yellow('💡 Make sure you\'re in a git repository and have set up a remote origin:'));
-            console.log(chalk_1.default.gray('   git remote add origin <your-repo-url>'));
-            process.exit(1);
+        let config;
+        // Try to detect platform from git remote
+        const detection = (0, platform_detection_1.detectPlatformFromGit)();
+        if (options.skipPlatform || detection.provider === 'unknown' || !detection.repository) {
+            // Conversational mode - no platform integration
+            if (!options.skipPlatform && (detection.provider === 'unknown' || !detection.repository)) {
+                console.log(chalk_1.default.yellow('\nℹ️  No git remote found or unsupported platform.'));
+                console.log(chalk_1.default.blue('   Initializing in conversational mode (no platform integration).'));
+                console.log(chalk_1.default.gray('   You can still use FRAIM workflows and AI features.'));
+                console.log(chalk_1.default.gray('   Platform features (issues, PRs) will be unavailable.\n'));
+            }
+            else {
+                console.log(chalk_1.default.blue('\n   Initializing in conversational mode (platform integration skipped).\n'));
+            }
+            // Get project name from directory or git
+            let projectName = path_1.default.basename(projectRoot);
+            try {
+                const { execSync } = require('child_process');
+                const gitName = execSync('git config --get remote.origin.url', {
+                    stdio: 'pipe',
+                    timeout: 2000
+                }).toString().trim();
+                const match = gitName.match(/\/([^\/]+?)(\.git)?$/);
+                if (match) {
+                    projectName = match[1];
+                }
+            }
+            catch (e) {
+                // Use directory name as fallback
+            }
+            config = {
+                version: (0, version_utils_1.getFraimVersion)(),
+                project: {
+                    name: projectName
+                },
+                mode: 'conversational',
+                customizations: {
+                    workflowsPath: '.fraim/workflows'
+                }
+            };
+            console.log(chalk_1.default.gray(`   Project: ${projectName}`));
+            console.log(chalk_1.default.gray(`   Mode: Conversational (no platform integration)`));
         }
-        const config = {
-            version: (0, version_utils_1.getFraimVersion)(),
-            project: {
-                name: remoteInfo.repo
-            },
-            repository: {
-                provider: 'github',
-                owner: remoteInfo.owner || 'your-username',
-                name: remoteInfo.repo,
-                defaultBranch: remoteInfo.defaultBranch || 'main'
-            },
-            customizations: {
-                workflowsPath: '.fraim/workflows'
+        else {
+            // Integrated mode - use platform
+            if (!detection.repository) {
+                console.log(chalk_1.default.red('❌ Error: Repository information not available'));
+                process.exit(1);
             }
-        };
+            // Validate the detected repository config
+            const validation = (0, platform_detection_1.validateRepositoryConfig)(detection.repository);
+            if (!validation.valid) {
+                console.log(chalk_1.default.red('❌ Error: Invalid repository configuration:'));
+                validation.errors.forEach(err => console.log(chalk_1.default.red(`   - ${err}`)));
+                process.exit(1);
+            }
+            console.log(chalk_1.default.blue('\n   Initializing in integrated mode (platform integration enabled).'));
+            console.log(chalk_1.default.gray(`   Platform: ${detection.provider.toUpperCase()}`));
+            if (detection.provider === 'github') {
+                console.log(chalk_1.default.gray(`   Repository: ${detection.repository.owner}/${detection.repository.name}`));
+            }
+            else if (detection.provider === 'ado') {
+                console.log(chalk_1.default.gray(`   Organization: ${detection.repository.organization}`));
+                console.log(chalk_1.default.gray(`   Project: ${detection.repository.project}`));
+                console.log(chalk_1.default.gray(`   Repository: ${detection.repository.name}`));
+            }
+            console.log();
+            config = {
+                version: (0, version_utils_1.getFraimVersion)(),
+                project: {
+                    name: detection.repository.name
+                },
+                repository: detection.repository,
+                mode: 'integrated',
+                customizations: {
+                    workflowsPath: '.fraim/workflows'
+                }
+            };
+        }
         fs_1.default.writeFileSync(configPath, JSON.stringify(config, null, 2));
         console.log(chalk_1.default.green('✅ Created .fraim/config.json'));
     }
@@ -89,4 +146,5 @@ const runInit = async () => {
 exports.runInit = runInit;
 exports.initCommand = new commander_1.Command('init')
     .description('Initialize FRAIM in the current project')
-    .action(exports.runInit);
+    .option('--skip-platform', 'Skip platform integration (conversational mode only)')
+    .action((options) => (0, exports.runInit)(options));