mcp__gemini__precommit_guardian - Gemini MCP

mcpgeminiprecommit_guardian

Validate code changes before committing, detect issues like quality, security, and performance, and provide auto-fix suggestions. Blocks commits on critical issues with Git integration.

Instructions

Advanced pre-commit validation with auto-fix suggestions and Git integration

Input Schema

TableJSON Schema

Name	Required	Description	Default
`auto_fix`	No	Generate auto-fix suggestions
`block_on_issues`	No	Block commit on critical issues
`changes`	Yes	Code changes to validate
`check_types`	No	Check types
`language`	No	Programming language	javascript

Implementation Reference

src/tools/enhanced-tools.js:1055-1175 (handler)

The core handler function for the 'mcp__gemini__precommit_guardian' tool. It validates code changes for quality, security, and performance using AI prompts to aiClient.call(). Determines if commit should be blocked, generates Git pre-commit hook integration code, and stores validation metrics in storage.

    handler: async (args) => {
      const { changes, check_types = ['quality', 'security', 'performance'], auto_fix = true, block_on_issues = true, language = 'javascript' } = args;
      validateString(changes, 'changes');
      
      const timer = performanceMonitor.startTimer('precommit_guardian');
      
      const checks = Array.isArray(check_types) ? check_types : [check_types];
      
      // Pre-commit validation
      const validationPrompt = `Perform pre-commit validation for these ${language} changes:

\`\`\`${language}
${changes}
\`\`\`

**Validation Types**: ${checks.join(', ')}

Analyze:
1. **Critical Issues** (commit blockers)
   - Security vulnerabilities
   - Syntax errors
   - Breaking changes
   - Performance regressions

2. **Quality Issues** (warnings)
   - Code style violations
   - Best practice deviations
   - Documentation gaps
   - Test coverage concerns

3. **Performance Impact**
   - Performance implications
   - Resource usage changes
   - Scalability considerations

4. **Security Review**
   - Security pattern violations
   - Vulnerability introductions
   - Access control issues

${auto_fix ? '5. **Auto-fix Suggestions**\n   - Automated fixes for common issues\n   - Code style corrections\n   - Performance optimizations' : ''}

Provide:
- ✅ PASS / ❌ FAIL / ⚠️ WARNING for each category
- Specific line numbers for issues
- ${block_on_issues ? 'Clear indication if commit should be blocked' : 'Advisory feedback'}
- Remediation steps`;

      const validation = await aiClient.call(validationPrompt, 'review', { 
        complexity: 'medium',
        maxTokens: 3000 
      });
      
      // Extract commit decision
      const criticalIssues = validation.toLowerCase().includes('❌ fail') || validation.toLowerCase().includes('critical');
      const commitStatus = block_on_issues && criticalIssues ? 'BLOCKED' : 'APPROVED';
      
      let result = `🛡️ **Pre-commit Guardian** (${language})

**Status**: ${commitStatus === 'BLOCKED' ? '🚫 COMMIT BLOCKED' : '✅ COMMIT APPROVED'}
**Checks**: ${checks.join(', ')}
**Auto-fix**: ${auto_fix ? 'Enabled' : 'Disabled'}

${validation}`;

      // Generate Git hook integration if requested
      const gitHookPrompt = `Generate Git pre-commit hook integration:

Validation Status: ${commitStatus}
Issues Found: ${criticalIssues}

Provide:
1. **Git Hook Script** (bash/shell)
   - Pre-commit hook implementation
   - Integration with validation
   - Error handling and reporting

2. **Installation Instructions**
   - How to install the hook
   - Configuration options
   - Troubleshooting guide

3. **Workflow Integration**
   - CI/CD integration points
   - Team collaboration setup
   - Override procedures for emergencies`;

      const gitIntegration = await aiClient.call(gitHookPrompt, 'devops');
      
      result += `

---

🔗 **Git Integration**

${gitIntegration}`;

      // Store validation results for metrics
      const validationData = {
        timestamp: new Date().toISOString(),
        language,
        status: commitStatus,
        checks: checks,
        critical_issues: criticalIssues,
        changes_size: changes.length
      };
      
      const storageData = await storage.read('validations');
      if (!storageData.validations) storageData.validations = [];
      storageData.validations.push(validationData);
      
      // Keep only last 500 validations
      if (storageData.validations.length > 500) {
        storageData.validations = storageData.validations.slice(-500);
      }
      
      await storage.write('validations', storageData);
      
      timer.end();
      return result;
    }

src/tools/enhanced-tools.js:1048-1054 (schema)

Input schema defining parameters for the precommit guardian tool, including code changes, check types, auto-fix flag, block flag, and language.

parameters: {
  changes: { type: 'string', description: 'Code changes to validate', required: true },
  check_types: { type: 'array', description: 'Check types', default: ['quality', 'security', 'performance'] },
  auto_fix: { type: 'boolean', description: 'Generate auto-fix suggestions', default: true },
  block_on_issues: { type: 'boolean', description: 'Block commit on critical issues', default: true },
  language: { type: 'string', description: 'Programming language', default: 'javascript' }
},

src/tools/enhanced-tools.js:1046-1176 (registration)

Tool registration/definition within the enhancedTools object exported from this file. Includes description, parameters (schema), and handler.

  'mcp__gemini__precommit_guardian': {
    description: 'Advanced pre-commit validation with auto-fix suggestions and Git integration',
    parameters: {
      changes: { type: 'string', description: 'Code changes to validate', required: true },
      check_types: { type: 'array', description: 'Check types', default: ['quality', 'security', 'performance'] },
      auto_fix: { type: 'boolean', description: 'Generate auto-fix suggestions', default: true },
      block_on_issues: { type: 'boolean', description: 'Block commit on critical issues', default: true },
      language: { type: 'string', description: 'Programming language', default: 'javascript' }
    },
    handler: async (args) => {
      const { changes, check_types = ['quality', 'security', 'performance'], auto_fix = true, block_on_issues = true, language = 'javascript' } = args;
      validateString(changes, 'changes');
      
      const timer = performanceMonitor.startTimer('precommit_guardian');
      
      const checks = Array.isArray(check_types) ? check_types : [check_types];
      
      // Pre-commit validation
      const validationPrompt = `Perform pre-commit validation for these ${language} changes:

\`\`\`${language}
${changes}
\`\`\`

**Validation Types**: ${checks.join(', ')}

Analyze:
1. **Critical Issues** (commit blockers)
   - Security vulnerabilities
   - Syntax errors
   - Breaking changes
   - Performance regressions

2. **Quality Issues** (warnings)
   - Code style violations
   - Best practice deviations
   - Documentation gaps
   - Test coverage concerns

3. **Performance Impact**
   - Performance implications
   - Resource usage changes
   - Scalability considerations

4. **Security Review**
   - Security pattern violations
   - Vulnerability introductions
   - Access control issues

${auto_fix ? '5. **Auto-fix Suggestions**\n   - Automated fixes for common issues\n   - Code style corrections\n   - Performance optimizations' : ''}

Provide:
- ✅ PASS / ❌ FAIL / ⚠️ WARNING for each category
- Specific line numbers for issues
- ${block_on_issues ? 'Clear indication if commit should be blocked' : 'Advisory feedback'}
- Remediation steps`;

      const validation = await aiClient.call(validationPrompt, 'review', { 
        complexity: 'medium',
        maxTokens: 3000 
      });
      
      // Extract commit decision
      const criticalIssues = validation.toLowerCase().includes('❌ fail') || validation.toLowerCase().includes('critical');
      const commitStatus = block_on_issues && criticalIssues ? 'BLOCKED' : 'APPROVED';
      
      let result = `🛡️ **Pre-commit Guardian** (${language})

**Status**: ${commitStatus === 'BLOCKED' ? '🚫 COMMIT BLOCKED' : '✅ COMMIT APPROVED'}
**Checks**: ${checks.join(', ')}
**Auto-fix**: ${auto_fix ? 'Enabled' : 'Disabled'}

${validation}`;

      // Generate Git hook integration if requested
      const gitHookPrompt = `Generate Git pre-commit hook integration:

Validation Status: ${commitStatus}
Issues Found: ${criticalIssues}

Provide:
1. **Git Hook Script** (bash/shell)
   - Pre-commit hook implementation
   - Integration with validation
   - Error handling and reporting

2. **Installation Instructions**
   - How to install the hook
   - Configuration options
   - Troubleshooting guide

3. **Workflow Integration**
   - CI/CD integration points
   - Team collaboration setup
   - Override procedures for emergencies`;

      const gitIntegration = await aiClient.call(gitHookPrompt, 'devops');
      
      result += `

---

🔗 **Git Integration**

${gitIntegration}`;

      // Store validation results for metrics
      const validationData = {
        timestamp: new Date().toISOString(),
        language,
        status: commitStatus,
        checks: checks,
        critical_issues: criticalIssues,
        changes_size: changes.length
      };
      
      const storageData = await storage.read('validations');
      if (!storageData.validations) storageData.validations = [];
      storageData.validations.push(validationData);
      
      // Keep only last 500 validations
      if (storageData.validations.length > 500) {
        storageData.validations = storageData.validations.slice(-500);
      }
      
      await storage.write('validations', storageData);
      
      timer.end();
      return result;
    }
  },

Gemini MCP