@paulduvall/claude-dev-toolkit 0.0.1-alpha.10 → 0.0.1-alpha.12

package/README.md

@@ -1,12 +1,5 @@
 # Claude Dev Toolkit
 
-[![npm version](https://badge.fury.io/js/%40paulduvall%2Fclaude-dev-toolkit.svg)](https://www.npmjs.com/package/@paulduvall/claude-dev-toolkit)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-![Test Status](https://img.shields.io/badge/tests-100%25%20passing-brightgreen)
-![Active Commands](https://img.shields.io/badge/active%20commands-13-blue)
-![Experimental Commands](https://img.shields.io/badge/experimental%20commands-45-orange)
-![Total Commands](https://img.shields.io/badge/total%20commands-58-brightgreen)
-
 **Transform Claude Code into a complete development platform** with 58 AI-powered custom commands that automate your entire software development workflow.
 
 ## 🚀 Quick Installation

package/bin/claude-commands

@@ -266,11 +266,24 @@ program
         const oidcCmd = new OidcCommand();
         try {
             const result = await oidcCmd.execute(options);
-            if (!result.success && !result.dryRun) {
+            if (result.success) {
+                if (result.message) {
+                    console.log(result.message);
+                }
+                if (options.verbose && result.duration) {
+                    console.log(`✅ Completed in ${result.duration}ms`);
+                }
+            } else {
+                console.error(`❌ OIDC setup failed: ${result.error || 'Unknown error'}`);
+                if (result.enhancedError && result.enhancedError.suggestions) {
+                    result.enhancedError.suggestions.forEach(suggestion => {
+                        console.log(suggestion);
+                    });
+                }
                 process.exit(1);
             }
         } catch (error) {
-            console.error(`OIDC setup failed: ${error.message}`);
+            console.error(`❌ OIDC setup failed: ${error.message}`);
             process.exit(1);
         }
     });

package/lib/oidc-command.js

@@ -292,19 +292,81 @@ Run 'claude-commands oidc --help' for complete setup requirements.`;
         const { dryRun = false } = options;
 
         if (dryRun) {
-            return this.showDryRun(options);
+            await this.showDryRunWithDetection(options);
+            return { 
+                message: '✅ Dry run completed successfully',
+                dryRun: true 
+            };
         }
 
-        // Minimal implementation for current phase
-        this.showProgress('Initializing OIDC command...', options);
+        // Phase 2: Auto-detect configuration
+        this.showProgress('🚀 Initializing OIDC command...', options);
+        
+        const configResult = await this.autoDetectConfiguration(options);
+        if (!configResult.success) {
+            console.log(`❌ Configuration detection failed: ${configResult.error}`);
+            if (configResult.suggestions) {
+                configResult.suggestions.forEach(suggestion => console.log(suggestion));
+            }
+            return {
+                message: '❌ OIDC setup failed during configuration detection',
+                error: configResult.error
+            };
+        }
+        
+        // Display detected configuration
+        console.log('✅ Configuration detected successfully:');
+        console.log(`   📂 Repository: ${configResult.git.owner}/${configResult.git.repo}`);
+        console.log(`   🌍 AWS Region: ${configResult.aws.region} (${configResult.aws.source})`);
+        console.log(`   🎭 IAM Role: ${configResult.roleName}`);
+        console.log('');
+        
+        // For now, show that detection is working but full implementation is still in development
+        console.log('📋 OIDC Setup Status: Auto-detection implemented ✅');
+        console.log('⚠️  AWS resource creation is in development (Phase 3)');
+        console.log('💡 Use --dry-run to preview complete functionality');
         
         return { 
-            message: 'OIDC command executed successfully' 
+            message: '✅ OIDC command executed successfully (Phase 2: Detection completed)',
+            configuration: configResult
         };
     }
 
     /**
-     * Show dry run preview
+     * Show dry run preview with Phase 2 detection
+     */
+    async showDryRunWithDetection(options) {
+        console.log('🔍 Dry Run - Preview of OIDC configuration actions:\n');
+        
+        // Show what detection would find
+        console.log('📋 Phase 2: Auto-Detection Preview:');
+        try {
+            const configResult = await this.autoDetectConfiguration(options);
+            if (configResult.success) {
+                console.log(`   ✅ Repository: ${configResult.git.owner}/${configResult.git.repo}`);
+                console.log(`   ✅ AWS Region: ${configResult.aws.region} (${configResult.aws.source})`);
+                console.log(`   ✅ IAM Role: ${configResult.roleName}`);
+                console.log(`   ✅ Policy Template: ${configResult.policyTemplate.name}`);
+            } else {
+                console.log(`   ❌ Configuration detection would fail: ${configResult.error}`);
+            }
+        } catch (error) {
+            console.log(`   ❌ Detection error: ${error.message}`);
+        }
+        
+        console.log('\n📋 Phase 3: AWS Resource Creation (Planned):');
+        console.log('   • Create AWS OIDC Identity Provider for GitHub');
+        console.log('   • Create IAM role with trust policy for GitHub Actions');
+        console.log('   • Attach permission policies to IAM role');
+        console.log('   • Set up GitHub repository variables (AWS_DEPLOYMENT_ROLE, AWS_REGION)');
+        console.log('\n💡 This was a dry run - no changes were made');
+        console.log('   Run without --dry-run to execute OIDC setup (Phase 2 detection only)');
+        
+        return { dryRun: true, message: 'Dry run completed' };
+    }
+
+    /**
+     * Show dry run preview (legacy method)
      */
     showDryRun(options) {
         console.log('🔍 Dry Run - Preview of OIDC configuration actions:\n');
@@ -320,6 +382,330 @@ Run 'claude-commands oidc --help' for complete setup requirements.`;
         return { dryRun: true, message: 'Dry run completed' };
     }
 
+    /**
+     * REQ-DETECT-001: Git Repository Detection
+     * Auto-detect GitHub org/repo from git remote
+     */
+    async detectGitRepository(options = {}) {
+        try {
+            const { execSync } = require('child_process');
+            
+            // Get git remotes
+            const remotesOutput = execSync('git remote -v', { 
+                encoding: 'utf8',
+                cwd: options.repositoryPath || process.cwd()
+            });
+            
+            const remotes = this.parseGitRemotes(remotesOutput);
+            const selectedRemote = this.selectPreferredRemote(remotes);
+            
+            if (!selectedRemote) {
+                throw new Error('No GitHub remote found. Please add a GitHub remote origin.');
+            }
+            
+            const repoInfo = this.parseGitRemote(selectedRemote.url);
+            return {
+                success: true,
+                owner: repoInfo.owner,
+                repo: repoInfo.repo,
+                remote: selectedRemote.name,
+                url: selectedRemote.url
+            };
+            
+        } catch (error) {
+            return {
+                success: false,
+                error: error.message,
+                suggestions: [
+                    '🔧 Ensure you are in a git repository',
+                    '🔗 Add a GitHub remote: git remote add origin <github-url>',
+                    '✅ Verify remote: git remote -v'
+                ]
+            };
+        }
+    }
+
+    /**
+     * Parse git remotes output into structured format
+     */
+    parseGitRemotes(remotesOutput) {
+        const remotes = [];
+        const lines = remotesOutput.split('\n').filter(line => line.trim());
+        
+        lines.forEach(line => {
+            const match = line.match(/^(\w+)\s+(.+?)\s+\((fetch|push)\)$/);
+            if (match && match[3] === 'fetch') { // Only use fetch URLs
+                const [, name, url] = match;
+                if (url.includes('github.com')) {
+                    remotes.push({ name, url });
+                }
+            }
+        });
+        
+        return remotes;
+    }
+
+    /**
+     * Select preferred remote (prioritize 'origin')
+     */
+    selectPreferredRemote(remotes) {
+        if (remotes.length === 0) return null;
+        
+        // Prefer 'origin' remote
+        const origin = remotes.find(remote => remote.name === 'origin');
+        if (origin) return origin;
+        
+        // Fall back to first GitHub remote
+        return remotes[0];
+    }
+
+    /**
+     * Parse git remote URL to extract owner/repo
+     * Supports both SSH and HTTPS formats
+     */
+    parseGitRemote(url) {
+        // SSH format: git@github.com:owner/repo.git
+        const sshMatch = url.match(/^git@github\.com:([^\/]+)\/(.+?)(?:\.git)?$/);
+        if (sshMatch) {
+            return {
+                owner: sshMatch[1],
+                repo: sshMatch[2]
+            };
+        }
+        
+        // HTTPS format: https://github.com/owner/repo.git
+        const httpsMatch = url.match(/^https:\/\/github\.com\/([^\/]+)\/(.+?)(?:\.git)?$/);
+        if (httpsMatch) {
+            return {
+                owner: httpsMatch[1],
+                repo: httpsMatch[2]
+            };
+        }
+        
+        throw new Error(`Unsupported git remote URL format: ${url}`);
+    }
+
+    /**
+     * REQ-DETECT-002: AWS Configuration Detection
+     * Read AWS CLI config and environment variables
+     */
+    async detectAWSConfiguration(options = {}) {
+        try {
+            const fs = require('fs');
+            const path = require('path');
+            const os = require('os');
+            
+            let region = null;
+            let profile = 'default';
+            
+            // 1. Check environment variable first (highest priority)
+            region = this.getAWSRegionFromEnvironment();
+            
+            // 2. If no env var, try to read from AWS config files
+            if (!region) {
+                const awsConfigResult = this.readAWSConfigFiles();
+                region = awsConfigResult.region;
+                profile = awsConfigResult.profile;
+            }
+            
+            // 3. Default to us-east-1 if nothing found
+            if (!region) {
+                region = 'us-east-1';
+            }
+            
+            // 4. Validate region
+            const regionValid = this.validateAWSRegion(region);
+            
+            return {
+                success: true,
+                region: region,
+                profile: profile,
+                source: region === this.getAWSRegionFromEnvironment() ? 'environment' : 
+                        region === 'us-east-1' ? 'default' : 'config-file',
+                valid: regionValid
+            };
+            
+        } catch (error) {
+            return {
+                success: false,
+                error: error.message,
+                region: 'us-east-1', // Fallback
+                suggestions: [
+                    '🔧 Set AWS region: export AWS_DEFAULT_REGION=us-east-1',
+                    '⚙️ Configure AWS CLI: aws configure',
+                    '✅ Verify config: aws configure list'
+                ]
+            };
+        }
+    }
+
+    /**
+     * Get AWS region from environment variables
+     */
+    getAWSRegionFromEnvironment() {
+        return process.env.AWS_DEFAULT_REGION || process.env.AWS_REGION || null;
+    }
+
+    /**
+     * Read AWS CLI config files (~/.aws/config and ~/.aws/credentials)
+     */
+    readAWSConfigFiles() {
+        const fs = require('fs');
+        const path = require('path');
+        const os = require('os');
+        
+        const awsDir = path.join(os.homedir(), '.aws');
+        const configPath = path.join(awsDir, 'config');
+        const credentialsPath = path.join(awsDir, 'credentials');
+        
+        let region = null;
+        let profile = 'default';
+        
+        // Try to read config file first
+        try {
+            if (fs.existsSync(configPath)) {
+                const configContent = fs.readFileSync(configPath, 'utf8');
+                const regionMatch = configContent.match(/^\s*region\s*=\s*(.+)$/m);
+                if (regionMatch) {
+                    region = regionMatch[1].trim();
+                }
+            }
+        } catch (error) {
+            // Ignore config file read errors
+        }
+        
+        return { region, profile };
+    }
+
+    /**
+     * Validate AWS region format and existence
+     */
+    validateAWSRegion(region) {
+        if (!region) return false;
+        
+        // Basic format validation: region should be like us-east-1, eu-west-1, etc.
+        const regionPattern = /^[a-z]{2,3}-[a-z]+-\d+$/;
+        if (!regionPattern.test(region)) {
+            return false;
+        }
+        
+        // List of valid AWS regions (simplified list for validation)
+        const validRegions = [
+            'us-east-1', 'us-east-2', 'us-west-1', 'us-west-2',
+            'eu-west-1', 'eu-west-2', 'eu-west-3', 'eu-central-1',
+            'ap-southeast-1', 'ap-southeast-2', 'ap-northeast-1', 'ap-northeast-2',
+            'sa-east-1', 'ca-central-1', 'ap-south-1'
+        ];
+        
+        return validRegions.includes(region);
+    }
+
+    /**
+     * REQ-CLI-003: Zero Configuration Mode
+     * Combine git detection + AWS detection for zero-config experience
+     */
+    async autoDetectConfiguration(options = {}) {
+        try {
+            this.showProgress('🔍 Auto-detecting project configuration...', options);
+            
+            // Detect Git repository information
+            const gitResult = await this.detectGitRepository(options);
+            if (!gitResult.success) {
+                return {
+                    success: false,
+                    error: 'Git repository detection failed',
+                    details: gitResult,
+                    suggestions: gitResult.suggestions
+                };
+            }
+            
+            // Detect AWS configuration
+            const awsResult = await this.detectAWSConfiguration(options);
+            if (!awsResult.success) {
+                return {
+                    success: false,
+                    error: 'AWS configuration detection failed',
+                    details: awsResult,
+                    suggestions: awsResult.suggestions
+                };
+            }
+            
+            // Generate role name based on repository
+            const roleName = this.generateRoleName(gitResult.owner, gitResult.repo, options);
+            
+            // Get default policy template
+            const policyTemplate = this.getDefaultPolicyTemplate();
+            
+            return {
+                success: true,
+                git: gitResult,
+                aws: awsResult,
+                roleName: roleName,
+                policyTemplate: policyTemplate,
+                zeroConfig: true
+            };
+            
+        } catch (error) {
+            return {
+                success: false,
+                error: error.message,
+                suggestions: [
+                    '🔧 Ensure you are in a git repository with GitHub remote',
+                    '⚙️ Configure AWS CLI or set AWS_DEFAULT_REGION',
+                    '✅ Run with --dry-run to see what would be configured'
+                ]
+            };
+        }
+    }
+
+    /**
+     * Auto-generate role name based on repository
+     */
+    generateRoleName(owner, repo, options = {}) {
+        // Use provided role name if specified
+        if (options.roleName && options.roleName !== 'GitHubActionsRole') {
+            return options.roleName;
+        }
+        
+        // Generate role name: GitHubActions-owner-repo
+        const safeName = `GitHubActions-${owner}-${repo}`.replace(/[^a-zA-Z0-9-]/g, '-');
+        
+        // Ensure it meets IAM role name requirements (max 64 chars, alphanumeric + hyphens)
+        if (safeName.length > 64) {
+            return `GitHubActions-${owner}`.substring(0, 64);
+        }
+        
+        return safeName;
+    }
+
+    /**
+     * Get default policy template for standard use cases
+     */
+    getDefaultPolicyTemplate() {
+        return {
+            name: 'standard',
+            description: 'Standard permissions for common GitHub Actions workflows',
+            policies: [
+                {
+                    name: 'GitHubActionsBasePolicy',
+                    document: {
+                        Version: '2012-10-17',
+                        Statement: [
+                            {
+                                Effect: 'Allow',
+                                Action: [
+                                    'sts:GetCallerIdentity',
+                                    'sts:TagSession'
+                                ],
+                                Resource: '*'
+                            }
+                        ]
+                    }
+                }
+            ]
+        };
+    }
+
     /**
      * Get help text for OIDC command
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paulduvall/claude-dev-toolkit",
-  "version": "0.0.1-alpha.10",
+  "version": "0.0.1-alpha.12",
   "description": "Custom commands toolkit for Claude Code - streamline your development workflow",
   "author": "Paul Duvall",
   "license": "MIT",