sfdx-gatekeeper 1.0.0

package/README.md

@@ -0,0 +1,183 @@
+# SFDX Gatekeeper
+
+A lightweight pre-commit validation framework for Salesforce projects.
+
+**Author:** Milanjeet Singh  
+**Created:** March 2026
+
+[![npm version](https://badge.fury.io/js/sfdx-gatekeeper.svg)](https://www.npmjs.com/package/sfdx-gatekeeper)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- **Easy Configuration** - Simple YAML config file
+- **Extensible** - Add your own validations
+- **Beautiful Output** - Formatted, colorful terminal output
+- **Minimal Dependencies** - Only `js-yaml` for config parsing
+- **Salesforce Focused** - Built specifically for SFDX projects
+
+## Installation
+
+```bash
+npm install sfdx-gatekeeper --save-dev
+```
+
+## Quick Start
+
+### 1. Initialize Configuration
+
+```bash
+npx sfdx-gatekeeper init
+```
+
+This creates `sfdx-gatekeeper.yml` in your project root.
+
+### 2. Install Git Hooks
+
+```bash
+npx sfdx-gatekeeper install
+```
+
+### 3. Done!
+
+Your commits will now be validated automatically.
+
+## Sample Output
+
+```
+┌──────────────────────────────────────────────────┐
+│          SFDX Gatekeeper Validations             │
+├──────────────────────────────────────────────────┤
+│ Commit Message Standard              ✔ [Pass]    │
+│ Component Prefix (CODVR_)            ✔ [Pass]    │
+│ Branch Naming Convention             ✔ [Pass]    │
+├──────────────────────────────────────────────────┤
+│           Result: 3/3 checks passed              │
+└──────────────────────────────────────────────────┘
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `npx sfdx-gatekeeper init` | Create config file |
+| `npx sfdx-gatekeeper install` | Install git hooks |
+| `npx sfdx-gatekeeper uninstall` | Remove git hooks |
+| `npx sfdx-gatekeeper run <hook>` | Run validations manually |
+| `npx sfdx-gatekeeper list` | List available validations |
+| `npx sfdx-gatekeeper test` | Test output formatting |
+
+## Configuration
+
+Edit `sfdx-gatekeeper.yml` to customize validations:
+
+```yaml
+settings:
+  name: "SFDX Gatekeeper Validations"
+  boxWidth: 50
+
+validations:
+  enabled:
+    - commit-message
+    - component-prefix
+    - branch-naming
+
+  commit-message:
+    prefix: "Commit for"
+    issuePattern: "[IS]-[0-9]+"
+    blockedPhrases:
+      - "initial commit"
+      - "dummy"
+      - "wip"
+    requireDescription: true
+
+  component-prefix:
+    prefix: "CODVR_"
+    checkTypes:
+      - lwc
+      - aura
+      - classes
+
+  branch-naming:
+    pattern: "^(feature|bugfix|hotfix|release)/"
+    exempt:
+      - main
+      - master
+      - develop
+```
+
+## Built-in Validations
+
+| Validation | Description |
+|------------|-------------|
+| `commit-message` | Validates commit message format |
+| `component-prefix` | Checks SF components have required prefix |
+| `branch-naming` | Enforces branch naming convention |
+| `package-xml` | Checks package.xml is in sync |
+
+## Adding Custom Validations
+
+Create a new file in `node_modules/sfdx-gatekeeper/validations/` or your project's validations folder:
+
+```javascript
+// validations/my-custom-check.js
+
+class MyCustomValidation {
+    constructor(validator) {
+        this.validator = validator;
+        this.displayName = 'My Custom Check';
+    }
+
+    async run() {
+        // Your validation logic here
+        
+        if (someCondition) {
+            return { status: 'pass', details: '' };
+        }
+        
+        return {
+            status: 'fail',
+            details: 'Reason for failure'
+        };
+    }
+}
+
+module.exports = MyCustomValidation;
+```
+
+Enable it in `sfdx-gatekeeper.yml`:
+
+```yaml
+validations:
+  enabled:
+    - commit-message
+    - my-custom-check
+```
+
+## Commit Message Format
+
+Valid commit messages:
+
+```
+Commit for I-12345 - Fixed login issue
+Commit for S-67890 - Added new feature
+Commit for codvr_myComponent - Updated styles
+Commit for Apex CODVR_Controller - Refactored query
+```
+
+## Requirements
+
+- Node.js >= 14.0.0
+- Git
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Author
+
+**Milanjeet Singh**
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+/**
+ * =============================================================================
+ * SFDX Gatekeeper - CLI Entry Point
+ * 
+ * Author: Milanjeet Singh
+ * Created: March 2026
+ * =============================================================================
+ */
+
+const { SFDXGatekeeper } = require('../src/index.js');
+
+const args = process.argv.slice(2);
+const command = args[0] || 'help';
+
+    const validator = new SFDXGatekeeper();
+
+async function main() {
+    try {
+        switch (command) {
+            case 'init':
+                await validator.init();
+                break;
+            
+            case 'install':
+                await validator.installHooks();
+                break;
+            
+            case 'uninstall':
+                await validator.uninstallHooks();
+                break;
+            
+            case 'run':
+                const hook = args[1] || 'pre-commit';
+                const hookArg = args[2];
+                const exitCode = await validator.run(hook, hookArg);
+                process.exit(exitCode);
+                break;
+            
+            case 'list':
+                validator.listValidations();
+                break;
+            
+            case 'test':
+                validator.testOutput();
+                break;
+            
+            case 'help':
+            case '--help':
+            case '-h':
+                printHelp();
+                break;
+            
+            case 'version':
+            case '--version':
+            case '-v':
+                const pkg = require('../package.json');
+                console.log(`mtx-validator v${pkg.version}`);
+                break;
+            
+            default:
+                console.error(`Unknown command: ${command}`);
+                printHelp();
+                process.exit(1);
+        }
+    } catch (error) {
+        console.error('Error:', error.message);
+        process.exit(1);
+    }
+}
+
+function printHelp() {
+    console.log(`
+SFDX Gatekeeper - Pre-commit validation framework for Salesforce
+Author: Milanjeet Singh
+
+Usage: sfdx-gatekeeper <command> [options]
+
+Commands:
+  init              Create sfdx-gatekeeper.yml config in current project
+  install           Install git hooks in current project
+  uninstall         Remove git hooks from current project
+  run <hook>        Run validations for a specific hook
+  list              List available validations
+  test              Test validator output (dry run)
+  version           Show version number
+  help              Show this help message
+
+Hooks:
+  pre-commit        Run before commit is created
+  commit-msg <file> Validate commit message
+  pre-push          Run before push
+
+Examples:
+  npx sfdx-gatekeeper init
+  npx sfdx-gatekeeper install
+  npx sfdx-gatekeeper run pre-commit
+  npx sfdx-gatekeeper run commit-msg .git/COMMIT_EDITMSG
+`);
+}
+
+main();

package/lib/output.js

@@ -0,0 +1,190 @@
+/**
+ * =============================================================================
+ * SFDX Gatekeeper - Output Formatting Library
+ * 
+ * Author: Milanjeet Singh
+ * Created: March 2026
+ * =============================================================================
+ */
+
+class Output {
+    constructor(boxWidth = 50) {
+        this.boxWidth = boxWidth;
+        this.supportsColor = process.stdout.isTTY;
+        
+        // Colors
+        this.colors = {
+            red: this.supportsColor ? '\x1b[31m' : '',
+            green: this.supportsColor ? '\x1b[32m' : '',
+            yellow: this.supportsColor ? '\x1b[33m' : '',
+            blue: this.supportsColor ? '\x1b[34m' : '',
+            cyan: this.supportsColor ? '\x1b[36m' : '',
+            bold: this.supportsColor ? '\x1b[1m' : '',
+            dim: this.supportsColor ? '\x1b[2m' : '',
+            reset: this.supportsColor ? '\x1b[0m' : ''
+        };
+        
+        // Symbols
+        this.symbols = {
+            pass: '✔',
+            fail: '✘',
+            warn: '⚠',
+            info: 'ℹ',
+            arrow: '→'
+        };
+        
+        // Box drawing
+        this.box = {
+            tl: '┌', tr: '┐', bl: '└', br: '┘',
+            h: '─', v: '│', ml: '├', mr: '┤'
+        };
+    }
+
+    /**
+     * Print header with title
+     */
+    printHeader(title) {
+        const { cyan, bold, reset } = this.colors;
+        const { tl, tr, h, v, ml, mr } = this.box;
+        const width = this.boxWidth;
+        
+        const padding = Math.floor((width - title.length) / 2);
+        const paddingStr = ' '.repeat(padding);
+        const extraSpace = (width - title.length) % 2 === 1 ? ' ' : '';
+        
+        console.log('');
+        console.log(`${cyan}${tl}${h.repeat(width)}${tr}${reset}`);
+        console.log(`${cyan}${v}${reset}${bold}${paddingStr}${title}${paddingStr}${extraSpace}${reset}${cyan}${v}${reset}`);
+        console.log(`${cyan}${ml}${h.repeat(width)}${mr}${reset}`);
+    }
+
+    /**
+     * Print footer
+     */
+    printFooter() {
+        const { cyan, reset } = this.colors;
+        const { bl, br, h } = this.box;
+        
+        console.log(`${cyan}${bl}${h.repeat(this.boxWidth)}${br}${reset}`);
+        console.log('');
+    }
+
+    /**
+     * Print divider
+     */
+    printDivider() {
+        const { cyan, reset } = this.colors;
+        const { ml, mr, h } = this.box;
+        
+        console.log(`${cyan}${ml}${h.repeat(this.boxWidth)}${mr}${reset}`);
+    }
+
+    /**
+     * Print result line
+     */
+    printResultLine(name, status) {
+        const { cyan, green, red, yellow, dim, reset } = this.colors;
+        const { v } = this.box;
+        const { pass, fail, warn } = this.symbols;
+        
+        let statusText, statusColor, symbol;
+        
+        switch (status) {
+            case 'pass':
+                statusText = 'Pass';
+                statusColor = green;
+                symbol = pass;
+                break;
+            case 'fail':
+                statusText = 'Failed';
+                statusColor = red;
+                symbol = fail;
+                break;
+            case 'warn':
+                statusText = 'Warning';
+                statusColor = yellow;
+                symbol = warn;
+                break;
+            case 'skip':
+                statusText = 'Skipped';
+                statusColor = dim;
+                symbol = '-';
+                break;
+            default:
+                statusText = status;
+                statusColor = '';
+                symbol = '?';
+        }
+        
+        const resultStr = `${symbol} [${statusText}]`;
+        const nameWidth = this.boxWidth - resultStr.length - 3;
+        const paddedName = name.substring(0, nameWidth).padEnd(nameWidth);
+        
+        console.log(`${cyan}${v}${reset} ${paddedName}${statusColor}${resultStr}${reset} ${cyan}${v}${reset}`);
+    }
+
+    /**
+     * Print detail line
+     */
+    printDetail(message) {
+        const { cyan, dim, reset } = this.colors;
+        const { v, arrow } = this.box;
+        
+        const indent = `  ${this.symbols.arrow} `;
+        const msgWidth = this.boxWidth - indent.length - 1;
+        const truncatedMsg = message.substring(0, msgWidth).padEnd(msgWidth);
+        
+        console.log(`${cyan}${v}${reset}${dim}${indent}${truncatedMsg}${reset}${cyan}${v}${reset}`);
+    }
+
+    /**
+     * Print summary
+     */
+    printSummary(passed, total) {
+        const { cyan, green, red, yellow, bold, reset } = this.colors;
+        const { v } = this.box;
+        
+        this.printDivider();
+        
+        const summary = `Result: ${passed}/${total} checks passed`;
+        const padding = Math.floor((this.boxWidth - summary.length) / 2);
+        const paddingStr = ' '.repeat(padding);
+        const extraSpace = (this.boxWidth - summary.length) % 2 === 1 ? ' ' : '';
+        
+        let color;
+        if (passed === total) {
+            color = green;
+        } else if (passed === 0) {
+            color = red;
+        } else {
+            color = yellow;
+        }
+        
+        console.log(`${cyan}${v}${reset}${paddingStr}${color}${bold}${summary}${reset}${paddingStr}${extraSpace}${cyan}${v}${reset}`);
+    }
+
+    /**
+     * Log helpers
+     */
+    logInfo(message) {
+        const { blue, reset } = this.colors;
+        console.log(`${blue}${this.symbols.info}${reset} ${message}`);
+    }
+
+    logSuccess(message) {
+        const { green, reset } = this.colors;
+        console.log(`${green}${this.symbols.pass}${reset} ${message}`);
+    }
+
+    logError(message) {
+        const { red, reset } = this.colors;
+        console.log(`${red}${this.symbols.fail}${reset} ${message}`);
+    }
+
+    logWarn(message) {
+        const { yellow, reset } = this.colors;
+        console.log(`${yellow}${this.symbols.warn}${reset} ${message}`);
+    }
+}
+
+module.exports = Output;

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "sfdx-gatekeeper",
+  "version": "1.0.0",
+  "description": "A lightweight pre-commit validation framework for Salesforce projects",
+  "author": "Milanjeet Singh",
+  "license": "MIT",
+  "keywords": [
+    "git",
+    "hooks",
+    "pre-commit",
+    "commit-msg",
+    "salesforce",
+    "sfdx",
+    "lwc",
+    "apex",
+    "validation",
+    "linter",
+    "gatekeeper"
+  ],
+  "main": "src/index.js",
+  "bin": {
+    "sfdx-gatekeeper": "./bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "lib",
+    "validations",
+    "templates"
+  ],
+  "scripts": {
+    "test": "node bin/cli.js test",
+    "lint": "eslint src/**/*.js"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.0"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/milanjeet-singh/sfdx-gatekeeper.git"
+  },
+  "bugs": {
+    "url": "https://gitlab.com/milanjeet-singh/sfdx-gatekeeper/-/issues"
+  },
+  "homepage": "https://gitlab.com/milanjeet-singh/sfdx-gatekeeper#readme"
+}

package/src/index.js

@@ -0,0 +1,440 @@
+/**
+ * =============================================================================
+ * SFDX Gatekeeper - Main Module
+ * 
+ * Author: Milanjeet Singh
+ * Created: March 2026
+ * =============================================================================
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+const yaml = require('js-yaml');
+const Output = require('../lib/output.js');
+
+class SFDXGatekeeper {
+    constructor(projectRoot = process.cwd()) {
+        this.projectRoot = projectRoot;
+        this.configPath = path.join(projectRoot, 'sfdx-gatekeeper.yml');
+        this.config = this.loadConfig();
+        this.output = new Output(this.config.settings?.boxWidth || 50);
+        this.results = [];
+        this.hookType = '';
+        this.commitMsgFile = '';
+    }
+
+    /**
+     * Load configuration from mtx-validator.yml
+     */
+    loadConfig() {
+        const defaultConfig = this.getDefaultConfig();
+        
+        if (fs.existsSync(this.configPath)) {
+            try {
+                const userConfig = yaml.load(fs.readFileSync(this.configPath, 'utf8'));
+                return this.mergeConfig(defaultConfig, userConfig);
+            } catch (error) {
+                console.warn(`Warning: Could not parse config file: ${error.message}`);
+                return defaultConfig;
+            }
+        }
+        
+        return defaultConfig;
+    }
+
+    /**
+     * Get default configuration
+     */
+    getDefaultConfig() {
+        return {
+            settings: {
+                name: 'SFDX Gatekeeper Validations',
+                boxWidth: 50
+            },
+            validations: {
+                enabled: ['commit-message', 'component-prefix', 'branch-naming'],
+                'commit-message': {
+                    prefix: 'Commit for',
+                    issuePattern: '[IS]-[0-9]+',
+                    blockedPhrases: ['initial commit', 'dummy', 'wip', 'fixup', 'squash'],
+                    requireDescription: true,
+                    validComponents: ['codvr', 'c_', 'lwc', 'aura', 'apex', 'flow', 'trigger', 'class', 'test', 'batch', 'scheduler', 'controller', 'handler', 'helper', 'service', 'util']
+                },
+                'component-prefix': {
+                    prefix: 'CODVR_',
+                    checkTypes: ['lwc', 'aura', 'classes', 'triggers'],
+                    paths: {
+                        lwc: 'force-app/main/default/lwc',
+                        aura: 'force-app/main/default/aura',
+                        classes: 'force-app/main/default/classes',
+                        triggers: 'force-app/main/default/triggers'
+                    }
+                },
+                'branch-naming': {
+                    pattern: '^(feature|bugfix|hotfix|release|develop|main|master)/',
+                    exempt: ['main', 'master', 'develop']
+                },
+                'package-xml': {
+                    path: 'manifest/package.xml',
+                    enabled: false
+                }
+            }
+        };
+    }
+
+    /**
+     * Deep merge configurations
+     */
+    mergeConfig(defaultConfig, userConfig) {
+        const merged = { ...defaultConfig };
+        
+        if (userConfig.settings) {
+            merged.settings = { ...defaultConfig.settings, ...userConfig.settings };
+        }
+        
+        if (userConfig.validations) {
+            merged.validations = { ...defaultConfig.validations };
+            
+            if (userConfig.validations.enabled) {
+                merged.validations.enabled = userConfig.validations.enabled;
+            }
+            
+            for (const key of Object.keys(userConfig.validations)) {
+                if (key !== 'enabled' && defaultConfig.validations[key]) {
+                    merged.validations[key] = { 
+                        ...defaultConfig.validations[key], 
+                        ...userConfig.validations[key] 
+                    };
+                }
+            }
+        }
+        
+        return merged;
+    }
+
+    /**
+     * Initialize config file in project
+     */
+    async init() {
+        const templatePath = path.join(__dirname, '..', 'templates', 'sfdx-gatekeeper.yml');
+        
+        if (fs.existsSync(this.configPath)) {
+            console.log('⚠ sfdx-gatekeeper.yml already exists');
+            return;
+        }
+
+        let template;
+        if (fs.existsSync(templatePath)) {
+            template = fs.readFileSync(templatePath, 'utf8');
+        } else {
+            template = this.generateConfigTemplate();
+        }
+        
+        fs.writeFileSync(this.configPath, template);
+        console.log('✔ Created sfdx-gatekeeper.yml');
+        console.log('  Edit this file to customize validations');
+    }
+
+    /**
+     * Generate config template
+     */
+    generateConfigTemplate() {
+        return `# =============================================================================
+# SFDX Gatekeeper Configuration
+# Author: Milanjeet Singh
+# =============================================================================
+
+settings:
+  name: "SFDX Gatekeeper Validations"
+  boxWidth: 50
+
+validations:
+  # List of enabled validations
+  enabled:
+    - commit-message
+    - component-prefix
+    - branch-naming
+    # - package-xml  # Uncomment to enable
+
+  # Commit message validation
+  commit-message:
+    prefix: "Commit for"
+    issuePattern: "[IS]-[0-9]+"
+    blockedPhrases:
+      - "initial commit"
+      - "dummy"
+      - "wip"
+      - "fixup"
+      - "squash"
+    requireDescription: true
+    validComponents:
+      - codvr
+      - lwc
+      - aura
+      - apex
+      - flow
+      - trigger
+      - class
+      - test
+      - batch
+      - controller
+      - handler
+      - service
+      - util
+
+  # Component prefix validation
+  component-prefix:
+    prefix: "CODVR_"
+    checkTypes:
+      - lwc
+      - aura
+      - classes
+      - triggers
+    paths:
+      lwc: "force-app/main/default/lwc"
+      aura: "force-app/main/default/aura"
+      classes: "force-app/main/default/classes"
+      triggers: "force-app/main/default/triggers"
+
+  # Branch naming validation
+  branch-naming:
+    pattern: "^(feature|bugfix|hotfix|release|develop|main|master)/"
+    exempt:
+      - main
+      - master
+      - develop
+
+  # Package XML sync validation
+  package-xml:
+    path: "manifest/package.xml"
+    enabled: false
+`;
+    }
+
+    /**
+     * Install git hooks
+     */
+    async installHooks() {
+        const gitDir = path.join(this.projectRoot, '.git');
+        
+        if (!fs.existsSync(gitDir)) {
+            throw new Error('Not a git repository');
+        }
+        
+        const hooksDir = path.join(gitDir, 'hooks');
+        if (!fs.existsSync(hooksDir)) {
+            fs.mkdirSync(hooksDir, { recursive: true });
+        }
+        
+        // Pre-commit hook
+        const preCommitHook = `#!/usr/bin/env sh
+npx sfdx-gatekeeper run pre-commit
+`;
+        fs.writeFileSync(path.join(hooksDir, 'pre-commit'), preCommitHook, { mode: 0o755 });
+        
+        // Commit-msg hook
+        const commitMsgHook = `#!/usr/bin/env sh
+npx sfdx-gatekeeper run commit-msg "$1"
+`;
+        fs.writeFileSync(path.join(hooksDir, 'commit-msg'), commitMsgHook, { mode: 0o755 });
+        
+        // Pre-push hook
+        const prePushHook = `#!/usr/bin/env sh
+npx sfdx-gatekeeper run pre-push
+`;
+        fs.writeFileSync(path.join(hooksDir, 'pre-push'), prePushHook, { mode: 0o755 });
+        
+        console.log('✔ Git hooks installed successfully!');
+        console.log('  Hooks installed in: ' + hooksDir);
+    }
+
+    /**
+     * Uninstall git hooks
+     */
+    async uninstallHooks() {
+        const hooksDir = path.join(this.projectRoot, '.git', 'hooks');
+        
+        for (const hook of ['pre-commit', 'commit-msg', 'pre-push']) {
+            const hookPath = path.join(hooksDir, hook);
+            if (fs.existsSync(hookPath)) {
+                fs.unlinkSync(hookPath);
+                console.log(`  Removed: ${hook}`);
+            }
+        }
+        
+        console.log('✔ Git hooks uninstalled!');
+    }
+
+    /**
+     * Run validations for a hook
+     */
+    async run(hook, hookArg) {
+        this.hookType = hook;
+        this.results = [];
+        
+        switch (hook) {
+            case 'pre-commit':
+                await this.runPreCommit();
+                break;
+            case 'commit-msg':
+                this.commitMsgFile = hookArg;
+                await this.runCommitMsg();
+                break;
+            case 'pre-push':
+                await this.runPrePush();
+                break;
+            default:
+                throw new Error(`Unknown hook: ${hook}`);
+        }
+        
+        this.displayResults();
+        
+        const failedCount = this.results.filter(r => r.status === 'fail').length;
+        return failedCount > 0 ? 1 : 0;
+    }
+
+    /**
+     * Run pre-commit validations
+     */
+    async runPreCommit() {
+        const enabled = this.config.validations.enabled;
+        
+        for (const name of enabled) {
+            if (name === 'commit-message') continue; // Runs in commit-msg hook
+            await this.runValidation(name);
+        }
+    }
+
+    /**
+     * Run commit-msg validations
+     */
+    async runCommitMsg() {
+        await this.runValidation('commit-message');
+    }
+
+    /**
+     * Run pre-push validations
+     */
+    async runPrePush() {
+        await this.runValidation('branch-naming');
+    }
+
+    /**
+     * Run a single validation
+     */
+    async runValidation(name) {
+        const validationPath = path.join(__dirname, '..', 'validations', `${name}.js`);
+        
+        if (!fs.existsSync(validationPath)) {
+            console.warn(`Warning: Validation not found: ${name}`);
+            return;
+        }
+        
+        const Validation = require(validationPath);
+        const validation = new Validation(this);
+        
+        try {
+            const result = await validation.run();
+            this.results.push({
+                name: validation.displayName,
+                status: result.status,
+                details: result.details
+            });
+        } catch (error) {
+            this.results.push({
+                name: name,
+                status: 'fail',
+                details: error.message
+            });
+        }
+    }
+
+    /**
+     * Display results
+     */
+    displayResults() {
+        const passed = this.results.filter(r => r.status === 'pass').length;
+        const total = this.results.length;
+        
+        this.output.printHeader(this.config.settings.name);
+        
+        for (const result of this.results) {
+            this.output.printResultLine(result.name, result.status);
+            if (result.details && result.status === 'fail') {
+                this.output.printDetail(result.details);
+            }
+        }
+        
+        this.output.printSummary(passed, total);
+        this.output.printFooter();
+    }
+
+    /**
+     * List available validations
+     */
+    listValidations() {
+        const validationsDir = path.join(__dirname, '..', 'validations');
+        const enabled = this.config.validations.enabled;
+        
+        console.log('Available validations:\n');
+        
+        if (fs.existsSync(validationsDir)) {
+            const files = fs.readdirSync(validationsDir).filter(f => f.endsWith('.js'));
+            
+            for (const file of files) {
+                const name = path.basename(file, '.js');
+                const marker = enabled.includes(name) ? '*' : ' ';
+                console.log(`  [${marker}] ${name}`);
+            }
+        }
+        
+        console.log('\n  [*] = enabled in sfdx-gatekeeper.yml');
+    }
+
+    /**
+     * Test output formatting
+     */
+    testOutput() {
+        this.output.printHeader(this.config.settings.name);
+        this.output.printResultLine('Commit Message Standard', 'pass');
+        this.output.printResultLine('Package XML in Sync', 'pass');
+        this.output.printResultLine('Component Prefix (CODVR_)', 'fail');
+        this.output.printDetail('myComponent missing CODVR_ prefix');
+        this.output.printResultLine('Branch Naming Convention', 'pass');
+        this.output.printSummary(3, 4);
+        this.output.printFooter();
+    }
+
+    /**
+     * Get staged files
+     */
+    getStagedFiles() {
+        try {
+            const result = execSync('git diff --cached --name-only --diff-filter=ACM', {
+                cwd: this.projectRoot,
+                encoding: 'utf8'
+            });
+            return result.trim().split('\n').filter(f => f);
+        } catch (error) {
+            return [];
+        }
+    }
+
+    /**
+     * Get current branch name
+     */
+    getCurrentBranch() {
+        try {
+            const result = execSync('git rev-parse --abbrev-ref HEAD', {
+                cwd: this.projectRoot,
+                encoding: 'utf8'
+            });
+            return result.trim();
+        } catch (error) {
+            return '';
+        }
+    }
+}
+
+module.exports = { SFDXGatekeeper };

package/validations/branch-naming.js

@@ -0,0 +1,47 @@
+/**
+ * =============================================================================
+ * Validation: Branch Naming Convention
+ * Ensures branch names follow the standard pattern
+ * 
+ * Author: Milanjeet Singh
+ * Created: March 2026
+ * =============================================================================
+ */
+
+class BranchNamingValidation {
+    constructor(validator) {
+        this.validator = validator;
+        this.config = validator.config.validations['branch-naming'];
+        this.displayName = 'Branch Naming Convention';
+    }
+
+    async run() {
+        const branch = this.validator.getCurrentBranch();
+        
+        if (!branch) {
+            return {
+                status: 'fail',
+                details: 'Could not determine branch name'
+            };
+        }
+        
+        // Check if branch is exempt
+        const exempt = this.config.exempt || [];
+        if (exempt.includes(branch)) {
+            return { status: 'pass', details: '' };
+        }
+        
+        // Check if branch matches pattern
+        const pattern = new RegExp(this.config.pattern);
+        if (pattern.test(branch)) {
+            return { status: 'pass', details: '' };
+        }
+        
+        return {
+            status: 'fail',
+            details: `'${branch}' doesn't match pattern`
+        };
+    }
+}
+
+module.exports = BranchNamingValidation;

package/validations/commit-message.js

@@ -0,0 +1,93 @@
+/**
+ * =============================================================================
+ * Validation: Commit Message Standard
+ * 
+ * Author: Milanjeet Singh
+ * Created: March 2026
+ * =============================================================================
+ */
+
+const fs = require('fs');
+
+class CommitMessageValidation {
+    constructor(validator) {
+        this.validator = validator;
+        this.config = validator.config.validations['commit-message'];
+        this.displayName = 'Commit Message Standard';
+    }
+
+    async run() {
+        const commitMsgFile = this.validator.commitMsgFile;
+        
+        // Read commit message
+        let commitMsg = '';
+        if (commitMsgFile && fs.existsSync(commitMsgFile)) {
+            commitMsg = fs.readFileSync(commitMsgFile, 'utf8').trim();
+        }
+        
+        // Check for empty message
+        if (!commitMsg) {
+            return {
+                status: 'fail',
+                details: 'Commit message is empty'
+            };
+        }
+        
+        // Check for blocked phrases
+        const blockedPhrases = this.config.blockedPhrases || [];
+        for (const phrase of blockedPhrases) {
+            if (commitMsg.toLowerCase().includes(phrase.toLowerCase())) {
+                return {
+                    status: 'fail',
+                    details: `Contains blocked phrase: "${phrase}"`
+                };
+            }
+        }
+        
+        // Check for required prefix
+        const prefix = this.config.prefix;
+        if (prefix && !commitMsg.startsWith(prefix + ' ')) {
+            return {
+                status: 'fail',
+                details: `Must start with "${prefix}"`
+            };
+        }
+        
+        // Check for Issue/Story number
+        const issuePattern = new RegExp(this.config.issuePattern);
+        if (issuePattern.test(commitMsg)) {
+            return { status: 'pass', details: '' };
+        }
+        
+        // Check for valid component name
+        const afterPrefix = commitMsg.substring(prefix.length + 1);
+        const component = afterPrefix.split(' ')[0];
+        
+        const validComponents = this.config.validComponents || [];
+        const isValidComponent = validComponents.some(vc => 
+            component.toLowerCase().startsWith(vc.toLowerCase())
+        );
+        
+        if (isValidComponent) {
+            // Check for description after dash
+            if (this.config.requireDescription) {
+                const hasDescription = /^[^ ]+ - .+/.test(afterPrefix);
+                if (!hasDescription) {
+                    return {
+                        status: 'fail',
+                        details: "Missing description after ' - '"
+                    };
+                }
+            }
+            return { status: 'pass', details: '' };
+        }
+        
+        // No valid pattern found
+        return {
+            status: 'fail',
+            details: 'Need I-xxx, S-xxx, or component name'
+        };
+    }
+}
+
+module.exports = CommitMessageValidation;

package/validations/component-prefix.js

@@ -0,0 +1,124 @@
+/**
+ * =============================================================================
+ * Validation: Component Prefix
+ * Ensures all components have the required prefix (e.g., CODVR_)
+ * 
+ * Author: Milanjeet Singh
+ * Created: March 2026
+ * =============================================================================
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+class ComponentPrefixValidation {
+    constructor(validator) {
+        this.validator = validator;
+        this.config = validator.config.validations['component-prefix'];
+        this.prefix = this.config.prefix || 'CODVR_';
+        this.displayName = `Component Prefix (${this.prefix})`;
+    }
+
+    async run() {
+        const invalidComponents = [];
+        const stagedFiles = this.validator.getStagedFiles();
+        const projectRoot = this.validator.projectRoot;
+        const checkTypes = this.config.checkTypes || [];
+        const paths = this.config.paths || {};
+        
+        // Check LWC components
+        if (checkTypes.includes('lwc')) {
+            const lwcPath = path.join(projectRoot, paths.lwc || 'force-app/main/default/lwc');
+            if (fs.existsSync(lwcPath)) {
+                const components = fs.readdirSync(lwcPath, { withFileTypes: true })
+                    .filter(d => d.isDirectory())
+                    .map(d => d.name);
+                
+                for (const name of components) {
+                    if (!this.hasValidPrefix(name)) {
+                        // Only check staged components
+                        const isStaged = stagedFiles.some(f => f.includes(`/lwc/${name}/`));
+                        if (stagedFiles.length === 0 || isStaged) {
+                            invalidComponents.push(`${name} (LWC)`);
+                        }
+                    }
+                }
+            }
+        }
+        
+        // Check Aura components
+        if (checkTypes.includes('aura')) {
+            const auraPath = path.join(projectRoot, paths.aura || 'force-app/main/default/aura');
+            if (fs.existsSync(auraPath)) {
+                const components = fs.readdirSync(auraPath, { withFileTypes: true })
+                    .filter(d => d.isDirectory())
+                    .map(d => d.name);
+                
+                for (const name of components) {
+                    if (!this.hasValidPrefix(name)) {
+                        const isStaged = stagedFiles.some(f => f.includes(`/aura/${name}/`));
+                        if (stagedFiles.length === 0 || isStaged) {
+                            invalidComponents.push(`${name} (Aura)`);
+                        }
+                    }
+                }
+            }
+        }
+        
+        // Check Apex classes
+        if (checkTypes.includes('classes')) {
+            const classesPath = path.join(projectRoot, paths.classes || 'force-app/main/default/classes');
+            if (fs.existsSync(classesPath)) {
+                const classes = fs.readdirSync(classesPath)
+                    .filter(f => f.endsWith('.cls'))
+                    .map(f => f.replace('.cls', ''));
+                
+                for (const name of classes) {
+                    if (!this.hasValidPrefix(name)) {
+                        const isStaged = stagedFiles.some(f => f.includes(`/classes/${name}.cls`));
+                        if (stagedFiles.length === 0 || isStaged) {
+                            invalidComponents.push(`${name} (Apex)`);
+                        }
+                    }
+                }
+            }
+        }
+        
+        // Check Triggers
+        if (checkTypes.includes('triggers')) {
+            const triggersPath = path.join(projectRoot, paths.triggers || 'force-app/main/default/triggers');
+            if (fs.existsSync(triggersPath)) {
+                const triggers = fs.readdirSync(triggersPath)
+                    .filter(f => f.endsWith('.trigger'))
+                    .map(f => f.replace('.trigger', ''));
+                
+                for (const name of triggers) {
+                    if (!this.hasValidPrefix(name)) {
+                        const isStaged = stagedFiles.some(f => f.includes(`/triggers/${name}.trigger`));
+                        if (stagedFiles.length === 0 || isStaged) {
+                            invalidComponents.push(`${name} (Trigger)`);
+                        }
+                    }
+                }
+            }
+        }
+        
+        if (invalidComponents.length === 0) {
+            return { status: 'pass', details: '' };
+        }
+        
+        return {
+            status: 'fail',
+            details: invalidComponents.slice(0, 3).join(', ') + 
+                     (invalidComponents.length > 3 ? ` (+${invalidComponents.length - 3} more)` : '')
+        };
+    }
+
+    hasValidPrefix(name) {
+        const prefix = this.prefix.toLowerCase();
+        return name.toLowerCase().startsWith(prefix) || 
+               name.toLowerCase().startsWith('c' + prefix.substring(1)); // cODVR_ format
+    }
+}
+
+module.exports = ComponentPrefixValidation;

package/validations/package-xml.js

@@ -0,0 +1,83 @@
+/**
+ * =============================================================================
+ * Validation: Package XML Sync
+ * Checks if package.xml is in sync with force-app components
+ * 
+ * Author: Milanjeet Singh
+ * Created: March 2026
+ * =============================================================================
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+class PackageXmlValidation {
+    constructor(validator) {
+        this.validator = validator;
+        this.config = validator.config.validations['package-xml'];
+        this.displayName = 'Package XML in Sync';
+    }
+
+    async run() {
+        const packageXmlPath = path.join(
+            this.validator.projectRoot, 
+            this.config.path || 'manifest/package.xml'
+        );
+        
+        // Check if package.xml exists
+        if (!fs.existsSync(packageXmlPath)) {
+            return {
+                status: 'warn',
+                details: 'package.xml not found'
+            };
+        }
+        
+        if (!this.config.enabled) {
+            return { status: 'skip', details: '' };
+        }
+        
+        const packageXmlContent = fs.readFileSync(packageXmlPath, 'utf8');
+        const stagedFiles = this.validator.getStagedFiles();
+        const missingComponents = [];
+        
+        // Check staged Apex classes
+        const stagedClasses = stagedFiles
+            .filter(f => f.endsWith('.cls') && !f.endsWith('-meta.xml'))
+            .map(f => path.basename(f, '.cls'));
+        
+        for (const className of stagedClasses) {
+            if (!packageXmlContent.includes(`<members>${className}</members>`)) {
+                missingComponents.push(className);
+            }
+        }
+        
+        // Check staged LWC components
+        const stagedLwc = [...new Set(
+            stagedFiles
+                .filter(f => f.includes('/lwc/'))
+                .map(f => {
+                    const match = f.match(/\/lwc\/([^/]+)\//);
+                    return match ? match[1] : null;
+                })
+                .filter(Boolean)
+        )];
+        
+        for (const lwcName of stagedLwc) {
+            if (!packageXmlContent.includes(`<members>${lwcName}</members>`)) {
+                missingComponents.push(lwcName);
+            }
+        }
+        
+        if (missingComponents.length === 0) {
+            return { status: 'pass', details: '' };
+        }
+        
+        return {
+            status: 'fail',
+            details: `Missing: ${missingComponents.slice(0, 3).join(', ')}` +
+                     (missingComponents.length > 3 ? ` (+${missingComponents.length - 3} more)` : '')
+        };
+    }
+}
+
+module.exports = PackageXmlValidation;