fraim-framework 2.0.60 → 2.0.63

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

@@ -66,16 +66,161 @@ const promptForFraimKey = async () => {
     console.log(chalk_1.default.gray('Please ensure you have a valid FRAIM key and try again.'));
     process.exit(1);
 };
-const saveGlobalConfig = (fraimKey, githubToken) => {
+const promptForMode = async () => {
+    console.log(chalk_1.default.blue('\n🎯 Usage Mode Selection'));
+    console.log(chalk_1.default.gray('Choose how you want to use FRAIM:\n'));
+    const response = await (0, prompts_1.default)({
+        type: 'select',
+        name: 'mode',
+        message: 'Select your preferred mode',
+        choices: [
+            {
+                title: 'Integrated Mode',
+                value: 'integrated',
+                description: 'Full platform integration with GitHub/ADO for issue tracking and PRs'
+            },
+            {
+                title: 'Conversational Mode',
+                value: 'conversational',
+                description: 'AI workflows only, no platform integration required'
+            }
+        ],
+        initial: 0
+    });
+    if (!response.mode) {
+        console.log(chalk_1.default.yellow('\nℹ️  No mode selected, defaulting to Integrated Mode'));
+        return 'integrated';
+    }
+    if (response.mode === 'conversational') {
+        console.log(chalk_1.default.blue('\n✓ Conversational mode selected'));
+        console.log(chalk_1.default.gray('  You can use FRAIM workflows without platform credentials.'));
+        console.log(chalk_1.default.gray('  Platform features (issues, PRs) will be unavailable.\n'));
+    }
+    else {
+        console.log(chalk_1.default.blue('\n✓ Integrated mode selected'));
+        console.log(chalk_1.default.gray('  Full platform integration will be available.\n'));
+    }
+    return response.mode;
+};
+const promptForPlatforms = async () => {
+    console.log(chalk_1.default.blue('\n🔧 Platform Selection'));
+    console.log(chalk_1.default.gray('Which platforms do you want to integrate with?\n'));
+    const response = await (0, prompts_1.default)({
+        type: 'multiselect',
+        name: 'platforms',
+        message: 'Select platforms (Space to select, Enter to confirm)',
+        choices: [
+            { title: 'GitHub', value: 'github', selected: true },
+            { title: 'Azure DevOps', value: 'ado', selected: false }
+        ],
+        min: 1
+    });
+    if (!response.platforms || response.platforms.length === 0) {
+        console.log(chalk_1.default.yellow('\nℹ️  No platforms selected, defaulting to GitHub'));
+        return { github: true, ado: false };
+    }
+    const platforms = {
+        github: response.platforms.includes('github'),
+        ado: response.platforms.includes('ado')
+    };
+    console.log(chalk_1.default.blue('\n✓ Selected platforms:'));
+    if (platforms.github)
+        console.log(chalk_1.default.gray('  • GitHub'));
+    if (platforms.ado)
+        console.log(chalk_1.default.gray('  • Azure DevOps'));
+    console.log();
+    return platforms;
+};
+const promptForADOToken = async () => {
+    console.log(chalk_1.default.blue('\n🔧 Azure DevOps Integration Setup'));
+    console.log('FRAIM requires an Azure DevOps Personal Access Token for ADO integration.\n');
+    console.log(chalk_1.default.yellow('🔑 Why ADO token is required:'));
+    console.log(chalk_1.default.gray('   • Create and manage work items'));
+    console.log(chalk_1.default.gray('   • Access repository information'));
+    console.log(chalk_1.default.gray('   • Perform git operations'));
+    console.log(chalk_1.default.gray('   • Enable full development workflow automation\n'));
+    const hasToken = await (0, prompts_1.default)({
+        type: 'confirm',
+        name: 'hasToken',
+        message: 'Do you have an Azure DevOps Personal Access Token?',
+        initial: false
+    });
+    if (!hasToken.hasToken) {
+        console.log(chalk_1.default.yellow('\n📝 To create an Azure DevOps Personal Access Token:'));
+        console.log(chalk_1.default.gray('   1. Go to https://dev.azure.com/{your-org}/_usersSettings/tokens'));
+        console.log(chalk_1.default.gray('   2. Click "New Token"'));
+        console.log(chalk_1.default.gray('   3. Select these scopes:'));
+        console.log(chalk_1.default.gray('      • Code (Read & Write)'));
+        console.log(chalk_1.default.gray('      • Work Items (Read & Write)'));
+        console.log(chalk_1.default.gray('      • Project and Team (Read)'));
+        console.log(chalk_1.default.gray('   4. Set expiration (recommend 1 year)'));
+        console.log(chalk_1.default.gray('   5. Click "Create" and copy the token immediately'));
+        console.log(chalk_1.default.yellow('   ⚠️ You won\'t be able to see the token again!\n'));
+    }
+    let token = null;
+    let attempts = 0;
+    const maxAttempts = 3;
+    while (!token && attempts < maxAttempts) {
+        const tokenResponse = await (0, prompts_1.default)({
+            type: 'password',
+            name: 'token',
+            message: attempts === 0
+                ? 'Enter your Azure DevOps PAT'
+                : `Enter your Azure DevOps PAT (attempt ${attempts + 1}/${maxAttempts})`,
+            validate: (value) => {
+                if (!value)
+                    return 'ADO token is required';
+                if (value.length < 20)
+                    return 'Token seems too short';
+                return true;
+            }
+        });
+        if (!tokenResponse.token) {
+            console.log(chalk_1.default.red('\n❌ ADO token is required for Azure DevOps integration.'));
+            attempts++;
+            if (attempts < maxAttempts) {
+                const retry = await (0, prompts_1.default)({
+                    type: 'confirm',
+                    name: 'retry',
+                    message: 'Would you like to try entering the token again?',
+                    initial: true
+                });
+                if (!retry.retry)
+                    break;
+            }
+            continue;
+        }
+        token = tokenResponse.token;
+        console.log(chalk_1.default.green('✅ Azure DevOps token received\n'));
+        return token; // Token is definitely set here
+    }
+    throw new Error('Failed to get Azure DevOps token');
+};
+const saveGlobalConfig = (fraimKey, mode, tokens) => {
     const globalConfigDir = path_1.default.join(os_1.default.homedir(), '.fraim');
     const globalConfigPath = path_1.default.join(globalConfigDir, 'config.json');
     if (!fs_1.default.existsSync(globalConfigDir)) {
         fs_1.default.mkdirSync(globalConfigDir, { recursive: true });
     }
+    // Read existing config to preserve any existing tokens
+    let existingConfig = {};
+    if (fs_1.default.existsSync(globalConfigPath)) {
+        try {
+            existingConfig = JSON.parse(fs_1.default.readFileSync(globalConfigPath, 'utf8'));
+        }
+        catch (e) {
+            // Ignore parse errors, will create new config
+        }
+    }
     const config = {
         version: (0, version_utils_1.getFraimVersion)(),
         apiKey: fraimKey,
-        githubToken: githubToken,
+        mode: mode,
+        tokens: {
+            // Preserve existing tokens and merge with new ones
+            ...(existingConfig.tokens || {}),
+            ...tokens
+        },
         configuredAt: new Date().toISOString(),
         userPreferences: {
             autoSync: true,
@@ -87,6 +232,10 @@ const saveGlobalConfig = (fraimKey, githubToken) => {
 };
 const syncGlobalScripts = () => {
     console.log(chalk_1.default.blue('🔄 Syncing FRAIM scripts to user directory...'));
+    // Ensure user directories exist and initialize user config
+    const { ensureUserFraimDirectories } = require('../../utils/script-sync-utils');
+    ensureUserFraimDirectories();
+    console.log(chalk_1.default.green('✅ Initialized user configuration'));
     // Find registry path
     let registryPath = path_1.default.join(__dirname, '../../../../registry');
     if (!fs_1.default.existsSync(registryPath)) {
@@ -105,19 +254,43 @@ const syncGlobalScripts = () => {
 };
 const runSetup = async (options) => {
     console.log(chalk_1.default.blue('🚀 Welcome to FRAIM! Let\'s get you set up.\n'));
-    // Show what we're about to do
-    console.log(chalk_1.default.yellow('📋 This setup will:'));
-    console.log(chalk_1.default.gray('   • Validate your FRAIM and GitHub tokens'));
-    console.log(chalk_1.default.gray('   • Create global FRAIM configuration'));
-    console.log(chalk_1.default.gray('   • Detect and configure supported IDEs'));
-    console.log(chalk_1.default.gray('   • Sync FRAIM scripts to your system'));
-    console.log(chalk_1.default.gray('   • Set up MCP servers for AI integration\n'));
-    // Get FRAIM key
-    let fraimKey = options.key;
-    if (!fraimKey) {
-        fraimKey = await promptForFraimKey();
+    // Determine if this is an update (adding platforms to existing setup)
+    const globalConfigPath = path_1.default.join(os_1.default.homedir(), '.fraim', 'config.json');
+    const isUpdate = fs_1.default.existsSync(globalConfigPath) && (options.github || options.ado);
+    let fraimKey;
+    let mode;
+    const tokens = {};
+    if (isUpdate) {
+        // Update existing setup - add platforms
+        console.log(chalk_1.default.blue('📝 Updating existing FRAIM configuration...\n'));
+        try {
+            const existingConfig = JSON.parse(fs_1.default.readFileSync(globalConfigPath, 'utf8'));
+            fraimKey = existingConfig.apiKey;
+            mode = existingConfig.mode || 'integrated';
+            // Preserve existing tokens
+            if (existingConfig.tokens) {
+                if (existingConfig.tokens.github)
+                    tokens.github = existingConfig.tokens.github;
+                if (existingConfig.tokens.ado)
+                    tokens.ado = existingConfig.tokens.ado;
+            }
+            console.log(chalk_1.default.gray(`   Current mode: ${mode}`));
+            console.log(chalk_1.default.gray(`   Existing tokens: ${tokens.github ? 'GitHub ✓' : ''} ${tokens.ado ? 'ADO ✓' : ''}\n`));
+        }
+        catch (e) {
+            console.log(chalk_1.default.red('❌ Failed to read existing configuration'));
+            process.exit(1);
+        }
     }
     else {
+        // Initial setup
+        console.log(chalk_1.default.yellow('📋 This setup will:'));
+        console.log(chalk_1.default.gray('   • Validate your FRAIM key'));
+        console.log(chalk_1.default.gray('   • Choose your usage mode'));
+        console.log(chalk_1.default.gray('   • Configure platform integrations'));
+        console.log(chalk_1.default.gray('   • Sync FRAIM scripts to your system\n'));
+        // Get FRAIM key
+        fraimKey = options.key || await promptForFraimKey();
         if (!(0, token_validator_1.isValidTokenFormat)(fraimKey, 'fraim')) {
             console.log(chalk_1.default.red('❌ Invalid FRAIM key format. Key must start with fraim_'));
             process.exit(1);
@@ -129,49 +302,104 @@ const runSetup = async (options) => {
             process.exit(1);
         }
         console.log(chalk_1.default.green('✅ FRAIM key validated\n'));
+        // Ask for mode preference
+        mode = await promptForMode();
     }
-    // Get GitHub token
-    let githubToken = options.githubToken;
-    if (!githubToken) {
-        githubToken = await (0, auto_mcp_setup_1.promptForGitHubToken)();
-    }
-    else {
-        if (!(0, token_validator_1.isValidTokenFormat)(githubToken, 'github')) {
-            console.log(chalk_1.default.red('❌ Invalid GitHub token format. Token must start with ghp_ or github_pat_'));
-            process.exit(1);
+    // Handle platform tokens based on mode
+    if (mode === 'integrated') {
+        let needGitHub = options.github || false;
+        let needADO = options.ado || false;
+        // If no specific platform flags and not an update, ask user
+        if (!isUpdate && !needGitHub && !needADO) {
+            const platforms = await promptForPlatforms();
+            needGitHub = platforms.github;
+            needADO = platforms.ado;
         }
-        console.log(chalk_1.default.blue('🔍 Validating GitHub token...'));
-        const isValid = await (0, token_validator_1.validateGitHubToken)(githubToken);
-        if (!isValid) {
-            console.log(chalk_1.default.red('❌ Invalid GitHub token'));
-            process.exit(1);
+        // Get GitHub token if needed
+        if (needGitHub && !tokens.github) {
+            if (options.githubToken) {
+                if (!(0, token_validator_1.isValidTokenFormat)(options.githubToken, 'github')) {
+                    console.log(chalk_1.default.red('❌ Invalid GitHub token format'));
+                    process.exit(1);
+                }
+                console.log(chalk_1.default.blue('🔍 Validating GitHub token...'));
+                const isValid = await (0, token_validator_1.validateGitHubToken)(options.githubToken);
+                if (!isValid) {
+                    console.log(chalk_1.default.red('❌ Invalid GitHub token'));
+                    process.exit(1);
+                }
+                tokens.github = options.githubToken;
+                console.log(chalk_1.default.green('✅ GitHub token validated\n'));
+            }
+            else {
+                try {
+                    tokens.github = await (0, auto_mcp_setup_1.promptForGitHubToken)();
+                }
+                catch (e) {
+                    // promptForGitHubToken calls process.exit on failure
+                    process.exit(1);
+                }
+            }
+        }
+        // Get ADO token if needed
+        if (needADO && !tokens.ado) {
+            if (options.adoToken) {
+                tokens.ado = options.adoToken;
+                console.log(chalk_1.default.green('✅ Azure DevOps token received\n'));
+            }
+            else {
+                try {
+                    tokens.ado = await promptForADOToken();
+                }
+                catch (e) {
+                    console.log(chalk_1.default.red('❌ Failed to get Azure DevOps token'));
+                    process.exit(1);
+                }
+            }
+        }
+        if (!tokens.github && !tokens.ado) {
+            console.log(chalk_1.default.yellow('⚠️  No platform tokens configured.'));
+            console.log(chalk_1.default.gray('   You can add them later with:'));
+            console.log(chalk_1.default.cyan('   fraim setup --github'));
+            console.log(chalk_1.default.cyan('   fraim setup --ado\n'));
         }
-        console.log(chalk_1.default.green('✅ GitHub token validated\n'));
+    }
+    else {
+        console.log(chalk_1.default.gray('ℹ️  Conversational mode: No platform tokens needed\n'));
     }
     // Save global configuration
     console.log(chalk_1.default.blue('💾 Saving global configuration...'));
-    saveGlobalConfig(fraimKey, githubToken);
-    // Sync global scripts
-    syncGlobalScripts();
-    // Configure IDEs
-    const selectedIDEs = options.ide ? options.ide.split(',') : undefined;
-    const autoAll = options.all;
-    if (autoAll && selectedIDEs) {
-        console.log(chalk_1.default.yellow('⚠️ Both --all and --ide specified. Using --ide selection.'));
-    }
-    await (0, auto_mcp_setup_1.autoConfigureMCP)(fraimKey, githubToken, selectedIDEs);
-    console.log(chalk_1.default.green('\n🎯 Setup complete! Next steps:'));
-    console.log(chalk_1.default.cyan('   1. Restart your configured IDEs'));
-    console.log(chalk_1.default.cyan('   2. Go to any project directory'));
-    console.log(chalk_1.default.cyan('   3. Run: fraim init-project'));
-    console.log(chalk_1.default.cyan('   4. Ask your AI agent: "list fraim workflows"'));
-    console.log(chalk_1.default.blue('\n💡 Use "fraim test-mcp" to verify your setup anytime.'));
+    saveGlobalConfig(fraimKey, mode, tokens);
+    // Sync global scripts (only on initial setup)
+    if (!isUpdate) {
+        syncGlobalScripts();
+    }
+    // Show summary
+    console.log(chalk_1.default.green('\n🎯 Configuration complete!'));
+    console.log(chalk_1.default.gray(`   Mode: ${mode}`));
+    if (mode === 'integrated') {
+        console.log(chalk_1.default.gray(`   Platforms: ${tokens.github ? 'GitHub ✓' : 'GitHub ✗'} ${tokens.ado ? 'ADO ✓' : 'ADO ✗'}`));
+    }
+    console.log(chalk_1.default.cyan('\n📝 Next steps:'));
+    console.log(chalk_1.default.cyan('   1. Go to any project directory'));
+    console.log(chalk_1.default.cyan('   2. Run: fraim init-project'));
+    console.log(chalk_1.default.cyan('   3. Start using FRAIM workflows'));
+    if (mode === 'integrated' && (!tokens.github || !tokens.ado)) {
+        console.log(chalk_1.default.gray('\n💡 To add more platforms later:'));
+        if (!tokens.github)
+            console.log(chalk_1.default.gray('   fraim setup --github'));
+        if (!tokens.ado)
+            console.log(chalk_1.default.gray('   fraim setup --ado'));
+    }
 };
 exports.runSetup = runSetup;
 exports.setupCommand = new commander_1.Command('setup')
-    .description('Complete global FRAIM setup with IDE configuration')
+    .description('Complete global FRAIM setup with platform configuration')
     .option('--key <key>', 'FRAIM API key')
     .option('--github-token <token>', 'GitHub Personal Access Token')
-    .option('--all', 'Auto-configure all detected IDEs')
-    .option('--ide <ides>', 'Configure specific IDEs (comma-separated: claude,cursor,kiro)')
+    .option('--ado-token <token>', 'Azure DevOps Personal Access Token')
+    .option('--github', 'Add/update GitHub integration')
+    .option('--ado', 'Add/update Azure DevOps integration')
+    .option('--all', 'Configure all detected IDEs (deprecated)')
+    .option('--ide <ides>', 'Configure specific IDEs (deprecated)')
     .action(exports.runSetup);