codeflow-hook 1.0.0

package/README.md

@@ -0,0 +1,248 @@
+# Codeflow Hook - AI-Powered Git Hooks
+
+An interactive CI/CD simulator and lightweight pre-push code reviewer that uses Google Gemini AI to analyze your code changes before commits and pushes.
+
+## 🚀 Features
+
+- **AI Code Review**: Get intelligent code analysis powered by Gemini AI
+- **Automated Git Hooks**: Automatic pre-commit and pre-push checks
+- **CI/CD Simulation**: Simulates full pipeline including tests and security checks
+- **Easy Installation**: Simple CLI setup for any project
+- **Developer-Friendly**: Clear feedback with actionable suggestions
+
+## 📦 Installation
+
+### Global Installation
+
+```bash
+npm install -g codeflow-hook
+```
+
+### Local Installation (for specific projects)
+
+```bash
+npm install --save-dev codeflow-hook
+```
+
+## ⚙️ Setup
+
+### 1. Configure AI Provider
+
+Choose your AI provider and configure with your API key:
+
+**Gemini (default):**
+```bash
+codeflow-hook config -p gemini -k YOUR_GEMINI_API_KEY
+```
+
+**OpenAI:**
+```bash
+codeflow-hook config -p openai -k YOUR_OPENAI_API_KEY
+```
+
+**Claude/Anthropic:**
+```bash
+codeflow-hook config -p claude -k YOUR_CLAUDE_API_KEY
+```
+
+**Custom model/URL:**
+```bash
+codeflow-hook config -p openai -k YOUR_API_KEY -m gpt-3.5-turbo -u https://your-custom-endpoint.com
+```
+
+### 2. Install Git Hooks
+
+In your project directory:
+
+```bash
+codeflow-hook install
+```
+
+This creates:
+- `pre-commit`: AI analysis of staged changes
+- `pre-push`: Full CI/CD simulation (tests + AI review)
+
+### 3. Check Status
+
+```bash
+codeflow-hook status
+```
+
+## 🛠️ Commands
+
+### Analyze Specific Changes
+
+Manually analyze a git diff:
+
+```bash
+git diff --staged | codeflow-hook analyze-diff
+```
+
+### Reinstall Hooks
+
+```bash
+codeflow-hook install --hooks-dir .custom-hooks
+```
+
+### View Help
+
+```bash
+codeflow-hook --help
+```
+
+## 🔄 How It Works
+
+### Pre-commit Hook
+- Analyzes staged changes only
+- Provides quick feedback on code quality
+- Prevents problematic commits
+
+### Pre-push Hook
+- Runs full test suite
+- Performs comprehensive AI code review
+- Simulates deployment pipeline
+- Blocks pushes with failing checks
+
+### AI Analysis Features
+- Code quality assessment
+- Security vulnerability detection
+- Performance optimization suggestions
+- Best practice recommendations
+- Maintainability evaluation
+
+## 💡 Usage Examples
+
+### Standard Development Workflow
+
+```bash
+# Stage your changes
+git add .
+
+# Pre-commit hook automatically runs AI analysis
+git commit -m "feat: add new authentication"
+
+# Pre-push hook runs tests and full AI review
+git push origin main
+```
+
+### Manual Analysis
+
+```bash
+# Analyze uncommitted changes
+git diff | codeflow-hook analyze-diff
+
+# Analyze specific files
+git diff path/to/file.js | codeflow-hook analyze-diff
+
+# Analyze between commits
+git diff HEAD~1 HEAD | codeflow-hook analyze-diff
+```
+
+## 🎯 AI Analysis Output
+
+The tool provides:
+
+- **Rating**: 1-10 quality score with color coding
+- **Summary**: Brief assessment of changes
+- **Issues**: Specific problems with solutions
+- **Recommendations**: Improvement suggestions
+
+Example output:
+```
+⭐ **Rating:** 9/10
+📝 **Summary:** Clean implementation with good separation of concerns
+
+⚠️ **Issues:**
+- Consider adding input validation for edge cases
+
+💡 **Recommendations:**
+- Add comprehensive error handling
+- Consider extracting common logic to a utility function
+```
+
+## 🔧 Configuration
+
+Configuration is stored in `~/.codeflow-hook/config.json`:
+
+```json
+{
+  "provider": "gemini",
+  "apiKey": "your-api-key",
+  "apiUrl": "https://generativelanguage.googleapis.com/v1beta/models/gemini-pro:generateContent",
+  "model": "gemini-pro"
+}
+```
+
+### Supported AI Providers
+
+- **Gemini**: `provider: "gemini"` - Default, uses Google AI
+- **OpenAI**: `provider: "openai"` - GPT models
+- **Claude**: `provider: "claude"` - Anthropic models
+
+Each provider has optimized prompts and supports custom endpoints.
+
+## 📋 Requirements
+
+- Node.js 16+
+- Git repository
+- Gemini API key
+
+## 🔒 Security
+
+- API keys stored locally (not in your repo)
+- Have to make an .env file for the credentials 
+- No data sent to third parties except Google Gemini
+- Code diffs analyzed locally before sending
+
+## 🐛 Troubleshooting
+
+### Common Issues
+
+**"No configuration found"**
+```bash
+codeflow-hook config -k YOUR_API_KEY
+```
+
+**Hooks not running**
+```bash
+codeflow-hook install
+# Ensure scripts are executable
+chmod +x .git/hooks/pre-commit .git/hooks/pre-push
+```
+
+**API errors**
+- Verify your API key is valid
+- Check Gemini API service status
+- Ensure you have quota remaining
+
+### Manual Hook Setup
+
+If automatic installation fails:
+
+1. Create `.git/hooks/pre-commit`
+2. Add executable permissions: `chmod +x .git/hooks/pre-commit`
+3. Call the CLI: `npx codeflow-hook analyze-diff "$(git diff --cached)"`
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Run tests: `npm test`
+5. Submit a pull request
+
+## 📄 License
+
+MIT License - see LICENSE file for details
+
+## 🎉 Acknowledgments
+
+Built with ❤️ using:
+- Google Gemini AI
+- Commander.js for CLI
+- Chalk for terminal colors
+- Ora for loading spinners
+
+---
+
+**Ready to supercharge your development workflow? Install Codeflow Hook today!**

package/bin/codeflow-hook.js

@@ -0,0 +1,352 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import axios from 'axios';
+import fs from 'fs';
+import path from 'path';
+import { execSync } from 'child_process';
+
+const program = new Command();
+
+program
+  .name('codeflow-hook')
+  .description('Interactive CI/CD simulator and AI-powered code reviewer')
+  .version('1.0.0');
+
+// Configure AI provider settings
+program
+  .command('config')
+  .description('Configure AI provider settings')
+  .option('-p, --provider <provider>', 'AI provider (gemini, openai, claude)', 'gemini')
+  .option('-k, --key <key>', 'API key for the chosen provider')
+  .option('-u, --url <url>', 'Custom API URL (optional)')
+  .option('-m, --model <model>', 'AI model name (optional - uses provider default)')
+  .action((options) => {
+    const configDir = path.join(process.env.HOME, '.codeflow-hook');
+    if (!fs.existsSync(configDir)) {
+      fs.mkdirSync(configDir, { recursive: true });
+    }
+
+    const configPath = path.join(configDir, 'config.json');
+    const existingConfig = fs.existsSync(configPath) ? JSON.parse(fs.readFileSync(configPath, 'utf8')) : {};
+
+    const config = {
+      ...existingConfig,
+      provider: options.provider || existingConfig.provider || 'gemini',
+      apiKey: options.key || existingConfig.apiKey,
+      apiUrl: options.url || existingConfig.apiUrl,
+      model: options.model || existingConfig.model
+    };
+
+    // Set defaults based on provider
+    if (!config.apiUrl) {
+      switch (config.provider) {
+        case 'openai':
+          config.apiUrl = 'https://api.openai.com/v1/chat/completions';
+          config.model = config.model || 'gpt-4';
+          break;
+        case 'claude':
+          config.apiUrl = 'https://api.anthropic.com/v1/messages';
+          config.model = config.model || 'claude-3-sonnet-20240229';
+          break;
+        case 'gemini':
+        default:
+          config.apiUrl = 'https://generativelanguage.googleapis.com/v1beta/models/gemini-pro:generateContent';
+          config.model = config.model || 'gemini-pro';
+          break;
+      }
+    }
+
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    console.log(chalk.green(`✅ Configuration saved for ${config.provider} provider`));
+  });
+
+// Install git hooks
+program
+  .command('install')
+  .description('Install git hooks (pre-commit and pre-push)')
+  .option('--hooks-dir <dir>', 'Custom hooks directory', '.git/hooks')
+  .action(async (options) => {
+    const spinner = ora('Installing git hooks...').start();
+
+    try {
+      const hooksDir = path.resolve(options.hooksDir);
+      if (!fs.existsSync(hooksDir)) {
+        fs.mkdirSync(hooksDir, { recursive: true });
+      }
+
+      // Create pre-commit hook
+      const preCommitHook = `#!/usr/bin/env bash
+# Codeflow pre-commit hook
+# Auto-generated by codeflow-hook CLI
+
+set -e
+
+echo "🔬 Running Codeflow AI Code Analysis..."
+
+# Get staged changes
+STAGED_DIFF=$(git diff --cached --no-color)
+
+if [ -z "$STAGED_DIFF" ]; then
+  echo "ℹ️  No staged changes to analyze"
+  exit 0
+fi
+
+# Run AI analysis
+npx codeflow-hook analyze-diff "$STAGED_DIFF"
+`;
+
+      fs.writeFileSync(path.join(hooksDir, 'pre-commit'), preCommitHook, { mode: 0o755 });
+
+      // Create pre-push hook (enhanced version)
+      const prePushHook = `#!/usr/bin/env bash
+# Codeflow pre-push hook
+# Auto-generated by codeflow-hook CLI
+
+set -e
+
+echo "🚀 Running Codeflow CI/CD simulation..."
+
+# Run tests if available
+if [ -f "package.json" ]; then
+  echo "🧪 Running tests..."
+  npm test || (echo "❌ Tests failed" && exit 1)
+fi
+
+# Get staged changes for AI analysis
+STAGED_DIFF=$(git diff --cached --no-color)
+
+if [ -n "$STAGED_DIFF" ]; then
+  echo "🔬 Running AI Code Review..."
+  npx codeflow-hook analyze-diff "$STAGED_DIFF" || exit 1
+fi
+
+echo "✅ All checks passed!"
+exit 0
+`;
+
+      fs.writeFileSync(path.join(hooksDir, 'pre-push'), prePushHook, { mode: 0o755 });
+
+      spinner.succeed('Git hooks installed successfully');
+      console.log(chalk.blue('📋 Installed hooks:'));
+      console.log(chalk.gray('  - pre-commit: AI analysis on staged changes'));
+      console.log(chalk.gray('  - pre-push: CI/CD simulation with AI review + tests'));
+
+    } catch (error) {
+      spinner.fail('Failed to install hooks');
+      console.error(chalk.red(error.message));
+      process.exit(1);
+    }
+  });
+
+// Analyze diff with configured AI provider
+program
+  .command('analyze-diff')
+  .description('Analyze git diff with configured AI provider')
+  .argument('<diff>', 'Git diff content')
+  .action(async (diff) => {
+    try {
+      const configPath = path.join(process.env.HOME, '.codeflow-hook', 'config.json');
+
+      if (!fs.existsSync(configPath)) {
+        console.log(chalk.red('No configuration found. Run: codeflow-hook config -k <api-key>'));
+        process.exit(1);
+      }
+
+      const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+
+      if (diff.trim() === '') {
+        console.log(chalk.gray('ℹ️  No changes to analyze'));
+        return;
+      }
+
+      const spinner = ora(`Analyzing code with ${config.provider}...`).start();
+      const prompt = generateCodeReviewPrompt(diff);
+
+      let result;
+      try {
+        result = await callAIProvider(config, prompt);
+      } catch (error) {
+        spinner.fail('Analysis failed');
+        console.error(chalk.red(`AI API Error: ${error.message}`));
+        process.exit(1);
+      }
+
+      spinner.succeed('Analysis complete');
+
+      // Parse and display results
+      displayAnalysisResults(result);
+
+    } catch (error) {
+      console.log(chalk.red(`Configuration error: ${error.message}`));
+      process.exit(1);
+    }
+  });
+
+// Show status
+program
+  .command('status')
+  .description('Show installation and configuration status')
+  .action(() => {
+    console.log(chalk.blue('🔍 Codeflow Hook Status'));
+    console.log();
+
+    // Check configuration
+    const configPath = path.join(process.env.HOME, '.codeflow-hook', 'config.json');
+    if (fs.existsSync(configPath)) {
+      console.log(chalk.green('✅ Configuration: Found'));
+    } else {
+      console.log(chalk.red('❌ Configuration: Not found (run: codeflow-hook config)'));
+    }
+
+    // Check git hooks
+    const hooksDir = '.git/hooks';
+    const preCommitHook = path.join(hooksDir, 'pre-commit');
+    const prePushHook = path.join(hooksDir, 'pre-push');
+
+    if (fs.existsSync(preCommitHook)) {
+      console.log(chalk.green('✅ Git Hook (pre-commit): Installed'));
+    } else {
+      console.log(chalk.red('❌ Git Hook (pre-commit): Not installed'));
+    }
+
+    if (fs.existsSync(prePushHook)) {
+      console.log(chalk.green('✅ Git Hook (pre-push): Installed'));
+    } else {
+      console.log(chalk.red('❌ Git Hook (pre-push): Not installed'));
+    }
+  });
+
+function generateCodeReviewPrompt(diff) {
+  return `You are "Codeflow", a world-class AI software engineering assistant acting as a Principal Engineer. Your mission is to perform a rigorous and constructive code review on the provided code changes.
+
+**Guidelines:**
+- Focus on code quality, security, performance, and best practices
+- Be constructive and provide actionable suggestions
+- Rate the changes on a scale of 1-10 (where 10 is excellent)
+- If there are critical issues, suggest fixes
+
+**Format your response as:**
+**Rating:** [1-10]/10
+**Summary:** [Brief summary]
+
+**Issues:** (if any)
+- [Issue description and suggestion]
+
+**Recommendations:** (if any)
+- [Recommendation]
+
+**Code Changes to Review:**
+\`\`\`
+${diff}
+\`\`\`
+
+Provide your analysis:`;
+}
+
+function callAIProvider(config, prompt) {
+  switch (config.provider) {
+    case 'openai':
+      return callOpenAI(config, prompt);
+    case 'claude':
+      return callClaude(config, prompt);
+    case 'gemini':
+    default:
+      return callGemini(config, prompt);
+  }
+}
+
+async function callGemini(config, prompt) {
+  const payload = {
+    contents: [{
+      parts: [{
+        text: prompt
+      }]
+    }],
+    generationConfig: {
+      temperature: 0.2,
+      topK: 40,
+      topP: 0.95,
+      maxOutputTokens: 2048,
+    }
+  };
+
+  const response = await axios.post(`${config.apiUrl}?key=${config.apiKey}`, payload, {
+    headers: {
+      'Content-Type': 'application/json'
+    }
+  });
+
+  return response.data.candidates[0].content.parts[0].text;
+}
+
+async function callOpenAI(config, prompt) {
+  const payload = {
+    model: config.model,
+    messages: [{ role: 'user', content: prompt }],
+    temperature: 0.2,
+    max_tokens: 2048
+  };
+
+  const response = await axios.post(config.apiUrl, payload, {
+    headers: {
+      'Content-Type': 'application/json',
+      'Authorization': `Bearer ${config.apiKey}`
+    }
+  });
+
+  return response.data.choices[0].message.content;
+}
+
+async function callClaude(config, prompt) {
+  const payload = {
+    model: config.model,
+    max_tokens: 2048,
+    messages: [{ role: 'user', content: prompt }]
+  };
+
+  const response = await axios.post(config.apiUrl, payload, {
+    headers: {
+      'Content-Type': 'application/json',
+      'x-api-key': config.apiKey,
+      'anthropic-version': '2023-06-01'
+    }
+  });
+
+  return response.data.content[0].text;
+}
+
+function displayAnalysisResults(result) {
+  // Parse the AI response and format it nicely
+  const lines = result.split('\n');
+
+  for (const line of lines) {
+    if (line.startsWith('**Rating:**')) {
+      const rating = line.match(/\*\*Rating:\*\*\s*(\d+)/);
+      if (rating) {
+        const score = parseInt(rating[1]);
+        if (score >= 8) {
+          console.log(chalk.green(`⭐ ${line}`));
+        } else if (score >= 5) {
+          console.log(chalk.yellow(`⚠️  ${line}`));
+        } else {
+          console.log(chalk.red(`❌ ${line}`));
+        }
+      }
+    } else if (line.includes('**Issues:**') || line.includes('**Recommendations:**')) {
+      console.log(chalk.blue(line));
+    } else if (line.startsWith('- ')) {
+      console.log(chalk.gray(line));
+    } else if (line.includes('**Summary:**')) {
+      console.log(chalk.cyan(line));
+    } else {
+      console.log(line);
+    }
+  }
+
+  console.log();
+}
+
+program.parse();

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "codeflow-hook",
+  "version": "1.0.0",
+  "description": "An interactive CI/CD simulator and lightweight pre-push code reviewer using Gemini AI",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "codeflow-hook": "./bin/codeflow-hook.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": ["git", "hooks", "ci", "cd", "code-review", "ai", "gemini"],
+  "author": "Sharv619",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^11.1.0",
+    "axios": "^1.6.0",
+    "chalk": "^5.3.0",
+    "ora": "^7.0.1"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}