vnxt 1.9.1 → 1.13.0

package/README.md

@@ -22,42 +22,56 @@ A lightweight CLI tool for automated version bumping with changelog generation a
 
 ## <img src="./docs/logos/caret-38x38.png" width="24" align="center"> Installation
 
-### Global Installation
+### npm (all platforms)
 
-**Bash/PowerShell:**
 ```bash
 npm install -g vnxt
 ```
 
-After installation, you can use either `vnxt` or the shorter alias `vx`:
+### Scoop (Windows)
+
+```powershell
+scoop bucket add vnxt https://github.com/n-orrow/scoop-vnxt
+scoop install vnxt
+```
+
+### Chocolatey (Windows)
+
+> ⏳ Pending moderation — will be available on the Chocolatey community repository shortly.
+
+```powershell
+choco install vnxt
+```
+
+### Homebrew (macOS/Linux)
+
 ```bash
-vnxt --help
-vx --help  # Same thing, shorter!
+brew tap n-orrow/vnxt
+brew install vnxt
 ```
 
-### Local Installation (from source)
+### From Source
 
 **Bash/macOS/Linux:**
 ```bash
-# Clone the repository
 git clone https://github.com/n-orrow/vnxt.git
 cd vnxt
-
-# Install globally via npm link
 chmod +x vnxt.js
 npm link
 ```
 
 **PowerShell/Windows:**
 ```powershell
-# Clone the repository
 git clone https://github.com/n-orrow/vnxt.git
 cd vnxt
-
-# Install globally via npm link
 npm link
 ```
 
+After installation, you can use either `vnxt` or the shorter alias `vx`:
+```bash
+vx --help
+```
+
 ## <img src="./docs/logos/caret-38x38.png" width="24" align="center"> Usage
 
 ### Basic Examples
@@ -89,18 +103,19 @@ All options work with both `vnxt` and `vx`:
 ```
 -m, --message <msg>      Commit message (required unless using interactive mode)
 -t, --type <type>        Version type: patch, minor, major (auto-detected from message)
--v, --version <ver>      Set specific version (e.g., 2.0.0-beta.1)
--V, --version            Show vnxt version
--p, --push              Push to remote with tags
+-sv, --set-version <v>   Set a specific version (e.g., 2.0.0-beta.1)
+-vv, --vnxt-version      Show the installed vnxt version
+-gv, --get-version       Show the current project's version
+-p, --push               Push to remote with tags
 -dnp, --no-push          Prevent auto-push (overrides config)
---publish               Push and trigger npm publish via GitHub Actions
--c, --changelog         Update CHANGELOG.md
--d, --dry-run           Show what would happen without making changes
--a, --all [mode]        Stage files before versioning (prompts if no mode)
-                        Modes: tracked, all, interactive (i), patch (p)
--r, --release           Generate release notes file
--q, --quiet             Minimal output (errors only)
--h, --help              Show help message
+--publish                Push and trigger npm publish via GitHub Actions (implies --push)
+-c, --changelog          Update CHANGELOG.md
+-d, --dry-run            Show what would happen without making changes
+-a, --all [mode]         Stage files before versioning (prompts if no mode)
+                         Modes: tracked, all, interactive (i), patch (p)
+-r, --release            Generate release notes file (saved to release-notes/)
+-q, --quiet              Minimal output (errors only)
+-h, --help               Show help message
 ```
 
 ### Automatic Version Detection
@@ -112,7 +127,7 @@ vnxt automatically detects the version bump type from your commit message:
 - `patch:` → **patch** version bump
 - `feat:` or `feature:` → **minor** version bump
 - `fix:` → **patch** version bump
-- `BREAKING:` or contains `BREAKING` → **major** version bump
+- `BREAKING` (anywhere in message) or `breaking:` → **major** version bump
 
 You can override this with the `-t` flag.
 
@@ -144,8 +159,8 @@ Set a specific version number (useful for pre-releases):
 
 **Bash/PowerShell:**
 ```bash
-vx -v 2.0.0-beta.1 -m "beta: initial release candidate"
-vx -v 1.5.0-rc.2 -m "release candidate 2"
+vx -sv 2.0.0-beta.1 -m "beta: initial release candidate"
+vx -sv 1.5.0-rc.2 -m "release candidate 2"
 ```
 
 ### Changelog Generation
@@ -177,19 +192,25 @@ Generate a formatted release notes file:
 vx -m "feat: major feature release" -r
 ```
 
-Creates `release-notes-v1.2.0.md`:
+You'll be prompted to add optional context before the file is created. Release notes are saved to `release-notes/v1.2.0.md` (respects your `tagPrefix` config):
 ```markdown
 # Release v1.2.0
 
-Released: 2024-02-10
+Released: 2024-02-10 at 14:32:00 UTC
+Author: Your Name
 
 ## Changes
 feat: major feature release
 
 ## Installation
 npm install your-package@1.2.0
+
+## Full Changelog
+See CHANGELOG.md for complete version history.
 ```
 
+**Note:** `--publish` automatically generates release notes too, so `-r` is only needed for standalone bumps where you want the file without publishing.
+
 ### File Staging Options
 
 vnxt offers flexible file staging with the `-a` flag:
@@ -237,14 +258,28 @@ Display the installed vnxt version:
 
 **Bash/PowerShell:**
 ```bash
-vx -V
+vx -vv
+# or
+vnxt --vnxt-version
+```
+
+Output:
+```
+vnxt v1.9.3
+```
+
+Display the current project's version:
+
+**Bash/PowerShell:**
+```bash
+vx -gv
 # or
-vnxt --version
+vnxt --get-version
 ```
 
 Output:
 ```
-vnxt v1.8.0
+my-package v2.4.1
 ```
 
 ### npm Publish
@@ -257,10 +292,12 @@ vx -m "feat: new feature" --publish
 ```
 
 This will:
-1. Bump the version and commit
-2. Push with a standard `v*` tag
-3. Push an additional `publish/v*` tag
-4. GitHub Actions detects the `publish/v*` tag and publishes to npm automatically
+1. Prompt for optional release notes context
+2. Bump the version and commit
+3. Auto-generate a release notes file in `release-notes/`
+4. Push with a standard `v*` tag
+5. Push an additional `publish/v*` tag
+6. GitHub Actions detects the `publish/v*` tag and publishes to npm automatically
 
 This means you can batch up multiple changes without publishing to npm each time:
 ```bash
@@ -417,7 +454,7 @@ vx -m "feat: final feature" --publish
 
 **Bash/PowerShell:**
 ```bash
-vx -V
+vx -vv
 ```
 
 ## <img src="./docs/logos/caret-38x38.png" width="24" align="center"> Troubleshooting

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vnxt",
-  "version": "1.9.1",
+  "version": "1.13.0",
   "description": "Version incrementation CLI tool with built in git commit, push and changelog generation",
   "main": "vnxt.js",
   "bin": {

package/vnxt.js

@@ -1,16 +1,24 @@
 #!/usr/bin/env node
 
-const {execSync} = require('child_process');
+// =============================================================================
+// TODOs
+// -----------------------------------------------------------------------------
+// 1. Nothing comes to mind right now
+// =============================================================================
+
+// =============================================================================
+// Imports & Constants
+// =============================================================================
+
+const {execSync, execFileSync} = require('child_process');
 const fs = require('fs');
+const path = require('path');
 const readline = require('readline');
 
-// ANSI color codes for terminal output
 const colors = {
     reset: '\x1b[0m',
     bright: '\x1b[1m',
     dim: '\x1b[2m',
-
-    // Foreground colors
     red: '\x1b[31m',
     green: '\x1b[32m',
     yellow: '\x1b[33m',
@@ -20,10 +28,13 @@ const colors = {
     gray: '\x1b[90m'
 };
 
-// Quiet mode flag
+const args = process.argv.slice(2);
 let quietMode = false;
 
-// Helper to log with colors (respects quiet mode and colors config)
+// =============================================================================
+// Logging
+// =============================================================================
+
 function log(message, color = '') {
     if (quietMode) return;
     if (color && colors[color] && config.colors) {
@@ -34,8 +45,6 @@ function log(message, color = '') {
 }
 
 function logError(message) {
-    // Errors always show, even in quiet mode
-    // Colors can be disabled for errors too
     if (config.colors) {
         console.error(`${colors.red}${message}${colors.reset}`);
     } else {
@@ -43,10 +52,10 @@ function logError(message) {
     }
 }
 
-// Parse command line arguments
-const args = process.argv.slice(2);
+// =============================================================================
+// Argument Helpers
+// =============================================================================
 
-// Helper to parse flags
 function getFlag(flag, short) {
     const index = args.indexOf(flag) !== -1 ? args.indexOf(flag) : args.indexOf(short);
     if (index === -1) return null;
@@ -54,351 +63,382 @@ function getFlag(flag, short) {
 }
 
 function hasFlag(flag, short) {
-    return args.includes(flag) || args.includes(short);
+    return args.includes(flag) || (short ? args.includes(short) : false);
 }
 
-// Load config file if exists
-let config = {
-    autoChangelog: true,
-    defaultType: 'patch',
-    requireCleanWorkingDir: false,
-    autoPush: true,
-    defaultStageMode: 'tracked',
-    tagPrefix: 'v',
-    colors: true
-};
+// =============================================================================
+// Load Config
+// =============================================================================
+
+function loadConfig() {
+    const defaults = {
+        autoChangelog: true,
+        defaultType: 'patch',
+        requireCleanWorkingDir: false,
+        autoPush: true,
+        defaultStageMode: 'tracked',
+        tagPrefix: 'v',
+        colors: true
+    };
+
+    if (fs.existsSync('.vnxtrc.json')) {
+        const userConfig = JSON.parse(fs.readFileSync('.vnxtrc.json', 'utf8'));
+        return {...defaults, ...userConfig};
+    }
 
-if (fs.existsSync('.vnxtrc.json')) {
-    const userConfig = JSON.parse(fs.readFileSync('.vnxtrc.json', 'utf8'));
-    config = {...config, ...userConfig};
+    return defaults;
 }
 
-// Check for --version flag
-if (args.includes('--version') || args.includes('-V')) {
-    const pkg = JSON.parse(fs.readFileSync('./package.json', 'utf8'));
-    console.log(`vnxt v${pkg.version}`);
-    process.exit(0);
-}
+const config = loadConfig();
 
-// Check for --quiet flag
-if (args.includes('--quiet') || args.includes('-q')) {
-    quietMode = true;
-}
+// =============================================================================
+// Handle Quick Flags (exit immediately)
+// =============================================================================
 
-// Check if in a git repository
-if (!fs.existsSync('.git')) {
-    logError('❌ Not a git repository. Run `git init` first.');
-    process.exit(1);
+function handleQuickFlags() {
+    // -vv / --vnxt-version: show vnxt's own installed version
+    if (args.includes('--vnxt-version') || args.includes('-vv')) {
+        const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, 'package.json'), 'utf8'));
+        console.log(`vnxt v${pkg.version}`);
+        process.exit(0);
+    }
+
+    // -gv / --get-version: show the current project's version
+    if (args.includes('--get-version') || args.includes('-gv')) {
+        if (!fs.existsSync('./package.json')) {
+            console.error('❌ No package.json found in current directory.');
+            process.exit(1);
+        }
+        const pkg = JSON.parse(fs.readFileSync('./package.json', 'utf8'));
+        console.log(`${pkg.name} v${pkg.version}`);
+        process.exit(0);
+    }
+
+    // -h / --help
+    if (hasFlag('--help', '-h')) {
+        printHelp();
+        process.exit(0);
+    }
 }
 
-// Parse arguments
-let message = getFlag('--message', '-m');
-let type = getFlag('--type', '-t') || config.defaultType;
-let customVersion = getFlag('--version', '-v');
-let dryRun = hasFlag('--dry-run', '-d');
-let noPush = hasFlag('--no-push', '-dnp');
-let publishToNpm = hasFlag('--publish');
-let push = noPush ? false : (hasFlag('--push', '-p') || publishToNpm || config.autoPush);
-let generateChangelog = hasFlag('--changelog', '-c') || config.autoChangelog;
-const addAllFlag = getFlag('--all', '-a');
-let addMode = null;
-let promptForStaging = false;
-if (addAllFlag) {
-    if (typeof addAllFlag === 'string') {
-        const mode = addAllFlag.toLowerCase();
-        if (['tracked', 'all', 'a', 'interactive', 'i', 'patch', 'p'].includes(mode)) {
-            if (mode === 'a') addMode = 'all';
-            else if (mode === 'i') addMode = 'interactive';
-            else if (mode === 'p') addMode = 'patch';
-            else addMode = mode;
+// =============================================================================
+// Parse Args
+// =============================================================================
+
+function parseArgs() {
+    if (args.includes('--quiet') || args.includes('-q')) {
+        quietMode = true;
+    }
+
+    const addAllFlag = getFlag('--all', '-a');
+    let addMode = null;
+    let promptForStaging = false;
+
+    if (addAllFlag) {
+        if (typeof addAllFlag === 'string') {
+            const mode = addAllFlag.toLowerCase();
+            const modeMap = { a: 'all', i: 'interactive', p: 'patch' };
+            const valid = ['tracked', 'all', 'interactive', 'patch', ...Object.keys(modeMap)];
+            if (!valid.includes(mode)) {
+                logError(`Error: Invalid add mode '${addAllFlag}'. Use: tracked, all, interactive (i), or patch (p)`);
+                process.exit(1);
+            }
+            addMode = modeMap[mode] || mode;
         } else {
-            logError(`Error: Invalid add mode '${addAllFlag}'. Use: tracked, all, interactive (i), or patch (p)`);
-            process.exit(1);
+            promptForStaging = true;
         }
-    } else {
-        promptForStaging = true;
     }
+
+    const noPush = hasFlag('--no-push', '-dnp');
+    const publishToNpm = hasFlag('--publish');
+
+    return {
+        message:              getFlag('--message', '-m'),
+        type:                 getFlag('--type', '-t') || config.defaultType,
+        customVersion:        getFlag('--set-version', '-sv'),
+        dryRun:               hasFlag('--dry-run', '-d'),
+        noPush,
+        publishToNpm,
+        push:                 noPush ? false : (hasFlag('--push', '-p') || publishToNpm || config.autoPush),
+        generateChangelog:    hasFlag('--changelog', '-c') || config.autoChangelog,
+        generateReleaseNotes: hasFlag('--release', '-r'),
+        addMode,
+        promptForStaging
+    };
 }
-let generateReleaseNotes = hasFlag('--release', '-r');
 
-// Interactive mode helper
-async function prompt(question) {
-    const rl = readline.createInterface({
-        input: process.stdin, output: process.stdout
-    });
+// =============================================================================
+// Interactive Prompt Helper
+// =============================================================================
 
+async function prompt(question) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
     return new Promise(resolve => {
-        rl.question(question, answer => {
-            rl.close();
-            resolve(answer);
-        });
+        rl.question(question, answer => { rl.close(); resolve(answer); });
     });
 }
 
-// Main function
-async function main() {
-    try {
-        // Interactive mode if no message provided
-        if (!message) {
-            log('🤔 Interactive mode\n', 'cyan');
+// =============================================================================
+// Interactive Mode
+// =============================================================================
 
-            message = await prompt('Commit message: ');
-            if (!message) {
-                logError('Error: Commit message is required');
-                process.exit(1);
-            }
+async function runInteractiveMode(opts) {
+    log('🤔 Interactive mode\n', 'cyan');
 
-            const typeInput = await prompt('Version type (patch/minor/major) [auto-detect]: ');
-            if (typeInput && ['patch', 'minor', 'major'].includes(typeInput)) {
-                type = typeInput;
-            }
+    opts.message = await prompt('Commit message: ');
+    if (!opts.message) {
+        logError('Error: Commit message is required');
+        process.exit(1);
+    }
 
-            const changelogInput = await prompt('Update CHANGELOG.md? (y/n) [n]: ');
-            generateChangelog = changelogInput.toLowerCase() === 'y' || changelogInput.toLowerCase() === 'yes' || generateChangelog;
+    const typeInput = await prompt('Version type (patch/minor/major) [auto-detect]: ');
+    if (typeInput && ['patch', 'minor', 'major'].includes(typeInput)) {
+        opts.type = typeInput;
+    }
 
-            const releaseNotesInput = await prompt('Generate release notes? (y/n) [n]: ');
-            generateReleaseNotes = releaseNotesInput.toLowerCase() === 'y' || releaseNotesInput.toLowerCase() === 'yes';
+    const changelogInput = await prompt('Update CHANGELOG.md? (y/n) [n]: ');
+    opts.generateChangelog = changelogInput.toLowerCase() === 'y' || changelogInput.toLowerCase() === 'yes' || opts.generateChangelog;
 
-            const pushInput = await prompt('Push to remote? (y/n) [n]: ');
-            push = pushInput.toLowerCase() === 'y' || pushInput.toLowerCase() === 'yes' || push;
+    const publishInput = await prompt('Publish to npm? (y/n) [n]: ');
+    if (publishInput.toLowerCase() === 'y' || publishInput.toLowerCase() === 'yes') {
+        opts.publishToNpm = true;
+        opts.generateReleaseNotes = true;
+    }
 
-            const dryRunInput = await prompt('Dry run (preview only)? (y/n) [n]: ');
-            dryRun = dryRunInput.toLowerCase() === 'y' || dryRunInput.toLowerCase() === 'yes';
+    const pushInput = await prompt('Push to remote? (y/n) [n]: ');
+    opts.push = pushInput.toLowerCase() === 'y' || pushInput.toLowerCase() === 'yes' || opts.push;
 
-            log(''); // Blank line before proceeding
-        }
+    const dryRunInput = await prompt('Dry run (preview only)? (y/n) [n]: ');
+    opts.dryRun = dryRunInput.toLowerCase() === 'y' || dryRunInput.toLowerCase() === 'yes';
 
-        // Auto-detect version type from conventional commit format
-        if (!customVersion && !getFlag('--type', '-t')) {
-            if (message.startsWith('major:') || message.startsWith('MAJOR:')) {
-                type = 'major';
-                log('📝 Auto-detected: major version bump', 'cyan');
-            } else if (message.startsWith('minor:') || message.startsWith('MINOR:')) {
-                type = 'minor';
-                log('📝 Auto-detected: minor version bump', 'cyan');
-            } else if (message.startsWith('patch:') || message.startsWith('PATCH:')) {
-                type = 'patch';
-                log('📝 Auto-detected: patch version bump', 'cyan');
-            } else if (message.startsWith('feat:') || message.startsWith('feature:')) {
-                type = 'minor';
-                log('📝 Auto-detected: minor version bump (feature)', 'cyan');
-            } else if (message.startsWith('fix:')) {
-                type = 'patch';
-                log('📝 Auto-detected: patch version bump (fix)', 'cyan');
-            } else if (message.includes('BREAKING') || message.startsWith('breaking:')) {
-                type = 'major';
-                log('📝 Auto-detected: major version bump (breaking change)', 'cyan');
-            }
-        }
+    log('');
+}
 
-        // Validate version type
-        if (!customVersion && !['patch', 'minor', 'major'].includes(type)) {
-            logError('Error: Version type must be patch, minor, or major');
-            process.exit(1);
+// =============================================================================
+// Detect Version Type
+// =============================================================================
+
+function detectVersionType(message, currentType) {
+    const rules = [
+        { prefixes: ['major:', 'MAJOR:'],  type: 'major', label: 'major version bump' },
+        { prefixes: ['minor:', 'MINOR:'],  type: 'minor', label: 'minor version bump' },
+        { prefixes: ['patch:', 'PATCH:'],  type: 'patch', label: 'patch version bump' },
+        { prefixes: ['feat:', 'feature:'], type: 'minor', label: 'minor version bump (feature)' },
+        { prefixes: ['fix:'],              type: 'patch', label: 'patch version bump (fix)' },
+        { prefixes: ['breaking:'],         type: 'major', label: 'major version bump (breaking change)' },
+    ];
+
+    for (const rule of rules) {
+        if (rule.prefixes.some(p => message.startsWith(p))) {
+            log(`📝 Auto-detected: ${rule.label}`, 'cyan');
+            return rule.type;
         }
+    }
 
-        // AUTO-REQUIRE RELEASE NOTES for --publish
-        let releaseNotesContext = '';
-        const requireReleaseNotes = !generateReleaseNotes && publishToNpm;
-        if (requireReleaseNotes) {
-            generateReleaseNotes = true;
-            if (!quietMode) {
-                log(`\n📋 Release notes required for --publish.`, 'yellow');
-                releaseNotesContext = await prompt('   Add context (press Enter to skip): ');
-                if (releaseNotesContext) log('');
-            }
-        } else if (generateReleaseNotes && !quietMode) {
-            // -r flag was passed explicitly - still offer context prompt
-            releaseNotesContext = await prompt('\n📋 Add context to release notes (press Enter to skip): ');
-            if (releaseNotesContext) log('');
-        }
+    // Special case: BREAKING anywhere in message
+    if (message.includes('BREAKING')) {
+        log('📝 Auto-detected: major version bump (breaking change)', 'cyan');
+        return 'major';
+    }
+
+    return currentType;
+}
 
-        // PRE-FLIGHT CHECKS
-        log('\n🔍 Running pre-flight checks...\n', 'cyan');
-
-        // Check for uncommitted changes OR if user requested staging prompt
-        if ((config.requireCleanWorkingDir && !addMode) || promptForStaging) {
-            const status = execSync('git status --porcelain --untracked-files=no').toString().trim();
-            if (status || promptForStaging) {
-                if (status) {
-                    log('⚠️  You have uncommitted changes.\n', 'yellow');
-                }
-                log('📁 How would you like to stage files?\n');
-                log('  1. Tracked files only (git add -u)');
-                log('  2. All changes (git add -A)');
-                log('  3. Interactive selection (git add -i)');
-                log('  4. Patch mode (git add -p)');
-                log('  5. Skip staging (continue without staging)\n');
-
-                const choice = await prompt('Select [1-5]: ');
-
-                if (choice === '1') {
-                    addMode = 'tracked';
-                } else if (choice === '2') {
-                    addMode = 'all';
-                } else if (choice === '3') {
-                    addMode = 'interactive';
-                } else if (choice === '4') {
-                    addMode = 'patch';
-                } else if (choice === '5') {
-                    log('⚠️  Skipping file staging. Ensure files are staged manually.', 'yellow');
-                } else {
-                    logError('Invalid choice. Exiting.');
-                    process.exit(1);
-                }
-                log('');
+// =============================================================================
+// Pre-flight Checks
+// =============================================================================
+
+async function runPreflightChecks(opts) {
+    log('\n🔍 Running pre-flight checks...\n', 'cyan');
+
+    // Staging prompt if requested
+    if ((config.requireCleanWorkingDir && !opts.addMode) || opts.promptForStaging) {
+        const status = execSync('git status --porcelain --untracked-files=no').toString().trim();
+        if (status || opts.promptForStaging) {
+            if (status) log('⚠️  You have uncommitted changes.\n', 'yellow');
+
+            log('📁 How would you like to stage files?\n');
+            log('  1. Tracked files only (git add -u)');
+            log('  2. All changes (git add -A)');
+            log('  3. Interactive selection (git add -i)');
+            log('  4. Patch mode (git add -p)');
+            log('  5. Skip staging (continue without staging)\n');
+
+            const choice = await prompt('Select [1-5]: ');
+            const choiceMap = { '1': 'tracked', '2': 'all', '3': 'interactive', '4': 'patch' };
+
+            if (choiceMap[choice]) {
+                opts.addMode = choiceMap[choice];
+            } else if (choice === '5') {
+                log('⚠️  Skipping file staging. Ensure files are staged manually.', 'yellow');
+            } else {
+                logError('Invalid choice. Exiting.');
+                process.exit(1);
             }
+            log('');
         }
+    }
 
-        // Check current branch
-        const branch = execSync('git branch --show-current').toString().trim();
-        if (branch !== 'main' && branch !== 'master') {
-            log(`⚠️  Warning: You're on branch '${branch}', not main/master`, 'yellow');
-        }
+    // Branch check
+    const branch = execSync('git branch --show-current').toString().trim();
+    if (branch !== 'main' && branch !== 'master') {
+        log(`⚠️  Warning: You're on branch '${branch}', not main/master`, 'yellow');
+    }
 
-        // Check if remote exists
-        try {
-            execSync('git remote get-url origin', {stdio: 'pipe'});
-        } catch {
-            if (push) {
-                logError('❌ Error: No remote repository configured, cannot push');
-                process.exit(1);
-            }
-            log('⚠️  Warning: No remote repository configured', 'yellow');
+    // Remote check
+    try {
+        execSync('git remote get-url origin', {stdio: 'pipe'});
+    } catch {
+        if (opts.push) {
+            logError('❌ Error: No remote repository configured, cannot push');
+            process.exit(1);
         }
+        log('⚠️  Warning: No remote repository configured', 'yellow');
+    }
 
-        log('✅ Pre-flight checks passed\n', 'green');
-
-        // DRY RUN MODE
-        if (dryRun) {
-            log('🔬 DRY RUN MODE - No changes will be made\n', 'yellow');
-            log('Would perform the following actions:');
-
-            if (addMode) {
-                const modeDescriptions = {
-                    'tracked': 'Stage tracked files only (git add -u)',
-                    'all': 'Stage all changes (git add -A)',
-                    'interactive': 'Interactive selection (git add -i)',
-                    'patch': 'Patch mode (git add -p)'
-                };
-                log(`  1. ${modeDescriptions[addMode]}`);
-            }
+    log('✅ Pre-flight checks passed\n', 'green');
+    return branch;
+}
 
-            log(`  2. Bump ${type} version`);
-            log(`  3. Commit with message: "${message}"`);
-            log('  4. Create git tag with annotation');
+// =============================================================================
+// Dry Run
+// =============================================================================
+
+function runDryRun(opts) {
+    log('🔬 DRY RUN MODE - No changes will be made\n', 'yellow');
+    log('Would perform the following actions:');
+
+    if (opts.addMode) {
+        const modeDescriptions = {
+            tracked:     'Stage tracked files only (git add -u)',
+            all:         'Stage all changes (git add -A)',
+            interactive: 'Interactive selection (git add -i)',
+            patch:       'Patch mode (git add -p)'
+        };
+        log(`  1. ${modeDescriptions[opts.addMode]}`);
+    }
 
-            if (generateChangelog) {
-                log('  5. Update CHANGELOG.md');
-            } else {
-                log('  5. (Skipping changelog - use --changelog to enable)');
-            }
+    log(`  2. Bump ${opts.type} version`);
+    log(`  3. Commit with message: "${opts.message}"`);
+    log('  4. Create git tag with annotation');
+    log(opts.generateChangelog    ? '  5. Update CHANGELOG.md'                          : '  5. (Skipping changelog - use --changelog to enable)');
+    log(opts.generateReleaseNotes ? '  6. Generate release notes file'                  : '  6. (Skipping release notes - use --release to enable)');
+    log(opts.push                 ? '  7. Push to remote with tags'                     : '  7. (Skipping push - use --push to enable)');
 
-            if (generateReleaseNotes) {
-                log('  6. Generate release notes file');
-            } else {
-                log('  6. (Skipping release notes - use --release to enable)');
-            }
+    log('\n✓ Dry run complete. Use without -d to apply changes.', 'green');
+    process.exit(0);
+}
 
-            if (push) {
-                log('  7. Push to remote with tags');
-            } else {
-                log('  7. (Skipping push - use --push to enable)');
-            }
+// =============================================================================
+// Stage Files
+// =============================================================================
+
+function stageFiles(addMode) {
+    log('📦 Staging files...', 'cyan');
+    const modeCommands = {
+        tracked:     'git add -u',
+        all:         'git add -A',
+        interactive: 'git add -i',
+        patch:       'git add -p'
+    };
+    execSync(modeCommands[addMode], {stdio: 'inherit'});
+}
 
-            log('\n✓ Dry run complete. Use without -d to apply changes.', 'green');
-            process.exit(0);
-        }
+// =============================================================================
+// Bump Version
+// =============================================================================
 
-        // STAGE FILES if requested
-        if (addMode) {
-            log('📦 Staging files...', 'cyan');
-
-            if (addMode === 'tracked') {
-                execSync('git add -u', {stdio: 'inherit'});
-            } else if (addMode === 'all') {
-                execSync('git add -A', {stdio: 'inherit'});
-            } else if (addMode === 'interactive') {
-                execSync('git add -i', {stdio: 'inherit'});
-            } else if (addMode === 'patch') {
-                execSync('git add -p', {stdio: 'inherit'});
-            }
-        }
-        // BUMP VERSION
-        log(`\n🔼 Bumping version...`, 'cyan');
+function bumpVersion(opts) {
+    log('\n🔼 Bumping version...', 'cyan');
 
-        // Get current version before bump
-        const packageJson = JSON.parse(fs.readFileSync('./package.json', 'utf8'));
-        const oldVersion = packageJson.version;
+    const packageJson = JSON.parse(fs.readFileSync('./package.json', 'utf8'));
+    const oldVersion = packageJson.version;
 
-        // Always disable npm's git integration and handle it ourselves
-        if (customVersion) {
-            execSync(`npm version ${customVersion} --git-tag-version=false`, {stdio: quietMode ? 'pipe' : 'inherit'});
-        } else {
-            execSync(`npm version ${type} --git-tag-version=false`, {stdio: quietMode ? 'pipe' : 'inherit'});
-        }
+    const versionArg = opts.customVersion || opts.type;
+    execSync(`npm version ${versionArg} --git-tag-version=false`, {stdio: quietMode ? 'pipe' : 'inherit'});
 
-        // Get new version
-        const newVersion = JSON.parse(fs.readFileSync('./package.json', 'utf8')).version;
+    const newVersion = JSON.parse(fs.readFileSync('./package.json', 'utf8')).version;
 
-        // Stage package files
-        execSync('git add package.json', {stdio: 'pipe'});
-        if (fs.existsSync('package-lock.json')) {
-            execSync('git add package-lock.json', {stdio: 'pipe'});
-        }
+    // Stage package files and commit
+    execSync('git add package.json', {stdio: 'pipe'});
+    if (fs.existsSync('package-lock.json')) {
+        execSync('git add package-lock.json', {stdio: 'pipe'});
+    }
+    execFileSync('git', ['commit', '-m', opts.message], {stdio: quietMode ? 'pipe' : 'inherit'});
 
-        // Commit with user's message
-        execSync(`git commit -m "${message}"`, {stdio: quietMode ? 'pipe' : 'inherit'});
+    // Create annotated tag
+    log('🏷️  Adding tag annotation...', 'cyan');
+    const tagMessage = `Version ${newVersion}\n\n${opts.message}`;
+    execFileSync('git', ['tag', '-a', `${config.tagPrefix}${newVersion}`, '-m', tagMessage], {stdio: 'pipe'});
 
-        // Create annotated tag
-        log('🏷️  Adding tag annotation...', 'cyan');
-        const tagMessage = `Version ${newVersion}\n\n${message}`;
-        execSync(`git tag -a ${config.tagPrefix}${newVersion} -m "${tagMessage}"`, {stdio: 'pipe'});
+    return { oldVersion, newVersion, packageJson };
+}
 
-        // GENERATE CHANGELOG
-        if (generateChangelog) {
-            log('📄 Updating CHANGELOG.md...', 'cyan');
-            const date = new Date().toISOString().split('T')[0];
-            const changelogEntry = `\n## [${newVersion}] - ${date}\n- ${message}\n`;
+// =============================================================================
+// Generate Changelog
+// =============================================================================
 
-            let changelog = '# Changelog\n';
-            if (fs.existsSync('CHANGELOG.md')) {
-                changelog = fs.readFileSync('CHANGELOG.md', 'utf8');
-            }
+function generateChangelog(newVersion, message) {
+    log('📄 Updating CHANGELOG.md...', 'cyan');
 
-            // Insert new entry after the title
-            const lines = changelog.split('\n');
-            const titleIndex = lines.findIndex(line => line.startsWith('# Changelog'));
-            lines.splice(titleIndex + 1, 0, changelogEntry);
+    const date = new Date().toISOString().split('T')[0];
+    const entry = `\n## [${newVersion}] - ${date}\n- ${message}\n`;
 
-            fs.writeFileSync('CHANGELOG.md', lines.join('\n'));
+    let changelog = '# Changelog\n';
+    if (fs.existsSync('CHANGELOG.md')) {
+        changelog = fs.readFileSync('CHANGELOG.md', 'utf8');
+    }
 
-            // Stage the changelog
-            execSync('git add CHANGELOG.md', {stdio: 'pipe'});
-            execSync(`git commit --amend --no-edit`, {stdio: 'pipe'});
-        }
+    const lines = changelog.split('\n');
+    const titleIndex = lines.findIndex(line => line.startsWith('# Changelog'));
+    lines.splice(titleIndex + 1, 0, entry);
+    fs.writeFileSync('CHANGELOG.md', lines.join('\n'));
 
-        // GENERATE RELEASE NOTES
-        if (generateReleaseNotes) {
-            log('📋 Generating release notes...', 'cyan');
+    execSync('git add CHANGELOG.md', {stdio: 'pipe'});
+    execSync('git commit --amend --no-edit', {stdio: 'pipe'});
+}
 
-            const date = new Date();
-            const timestamp = date.toISOString().replace('T', ' ').split('.')[0] + ' UTC';
-            const dateShort = date.toISOString().split('T')[0];
+// =============================================================================
+// Generate Release Notes
+// =============================================================================
 
-            let author = '';
-            try {
-                author = execSync('git config user.name', {stdio: 'pipe'}).toString().trim();
-            } catch {
-                author = '';
+function generateReleaseNotes(newVersion, message, context, packageJson, isPublish = false) {
+    log('📋 Generating release notes...', 'cyan');
+
+    const date = new Date();
+    const timestamp = date.toISOString().replace('T', ' ').split('.')[0] + ' UTC';
+    const dateShort = date.toISOString().split('T')[0];
+
+    let author = '';
+    try { author = execSync('git config user.name', {stdio: 'pipe'}).toString().trim(); } catch {}
+
+    // If publishing, gather all commits since the last publish/v* tag
+    let changes = message;
+    if (isPublish) {
+        try {
+            const lastPublishTag = execSync(
+                'git tag --list "publish/v*" --sort=-version:refname',
+                {stdio: 'pipe'}
+            ).toString().trim().split('\n').filter(Boolean)[0];
+
+            if (lastPublishTag) {
+                const commits = execSync(
+                    `git log ${lastPublishTag}..HEAD --pretty=format:"- %s"`,
+                    {stdio: 'pipe'}
+                ).toString().trim();
+                if (commits) changes = commits;
             }
+        } catch {
+            // Fall back to current message if git log fails
+        }
+    }
 
-            const releaseNotes = `# Release ${config.tagPrefix}${newVersion}
+    const notes = `# Release ${config.tagPrefix}${newVersion}
 
 Released: ${dateShort} at ${timestamp.split(' ')[1]}${author ? `\nAuthor: ${author}` : ''}
 
 ## Changes
-${message}${releaseNotesContext ? `\n\n## Release Notes\n${releaseNotesContext}` : ''}
+${changes}${context ? `\n\n## Release Notes\n${context}` : ''}
 
 ## Installation
 \`\`\`bash
@@ -406,81 +446,79 @@ npm install ${packageJson.name}@${newVersion}
 \`\`\`
 
 ## Full Changelog
-See [CHANGELOG.md](./CHANGELOG.md) for complete version history.
+See [CHANGELOG.md](../CHANGELOG.md) for complete version history.
 `;
 
-            const releaseNotesDir = 'release-notes';
-            if (!fs.existsSync(releaseNotesDir)) {
-                fs.mkdirSync(releaseNotesDir);
-            }
+    const dir = 'release-notes';
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir);
 
-            const filename = `${releaseNotesDir}/${config.tagPrefix}${newVersion}.md`;
-            fs.writeFileSync(filename, releaseNotes);
-            log(`   Created: ${filename}`);
-
-            // Stage and amend commit to include release notes
-            execSync(`git add ${filename}`, {stdio: 'pipe'});
-            execSync(`git commit --amend --no-edit`, {stdio: 'pipe'});
-        }
+    const filename = `${dir}/${config.tagPrefix}${newVersion}.md`;
+    fs.writeFileSync(filename, notes);
+    log(`   Created: ${filename}`);
 
-        // PUSH TO REMOTE
-        if (push) {
-            log('🚀 Pushing to remote...', 'cyan');
-            execSync('git push --follow-tags', {stdio: quietMode ? 'pipe' : 'inherit'});
-
-            // If --publish flag, also push a publish/v* tag to trigger npm workflow
-            if (publishToNpm) {
-                log('📦 Pushing publish tag to trigger npm release...', 'cyan');
-                const publishTag = `publish/${config.tagPrefix}${newVersion}`;
-                execSync(`git tag ${publishTag}`, {stdio: 'pipe'});
-                execSync(`git push origin ${publishTag}`, {stdio: quietMode ? 'pipe' : 'inherit'});
-            }
-        }
-
-        // STATS/SUMMARY
-        log('\n📊 Summary:', 'cyan');
-        log('━'.repeat(50), 'gray');
+    execSync(`git add ${filename}`, {stdio: 'pipe'});
+    execSync('git commit --amend --no-edit', {stdio: 'pipe'});
+}
 
-        log(`\n📦 Version: ${oldVersion} → ${newVersion}`, 'green');
-        log(`💬 Message: ${message}`);
-        log(`🏷️  Tag: ${config.tagPrefix}${newVersion}`);
-        log(`🌿 Branch: ${branch}`);
+// =============================================================================
+// Push to Remote
+// =============================================================================
 
-        if (generateChangelog) {
-            log(`📄 Changelog: Updated`);
-        }
+function pushToRemote(opts, newVersion) {
+    log('🚀 Pushing to remote...', 'cyan');
+    execSync('git push --follow-tags', {stdio: quietMode ? 'pipe' : 'inherit'});
 
-        if (generateReleaseNotes) {
-            log(`📋 Release notes: Generated`);
-        }
+    if (opts.publishToNpm) {
+        log('📦 Pushing publish tag to trigger npm release...', 'cyan');
+        const publishTag = `publish/${config.tagPrefix}${newVersion}`;
+        execSync(`git tag ${publishTag}`, {stdio: 'pipe'});
+        execSync(`git push origin ${publishTag}`, {stdio: quietMode ? 'pipe' : 'inherit'});
+    }
+}
 
-        if (push) {
-            log(`🚀 Remote: Pushed with tags`, 'green');
-            if (publishToNpm) {
-                log(`📦 npm: Publishing triggered (publish/${config.tagPrefix}${newVersion})`, 'green');
-            }
-        } else {
-            log(`📍 Remote: Not pushed (use --push to enable)`, 'gray');
+// =============================================================================
+// Print Summary
+// =============================================================================
+
+function printSummary(opts, oldVersion, newVersion, branch) {
+    log('\n📊 Summary:', 'cyan');
+    log('━'.repeat(50), 'gray');
+    log(`\n📦 Version: ${oldVersion} → ${newVersion}`, 'green');
+    log(`💬 Message: ${opts.message}`);
+    log(`🏷️  Tag: ${config.tagPrefix}${newVersion}`);
+    log(`🌿 Branch: ${branch}`);
+
+    if (opts.generateChangelog)    log('📄 Changelog: Updated');
+    if (opts.generateReleaseNotes) log('📋 Release notes: Generated');
+
+    if (opts.push) {
+        log('🚀 Remote: Pushed with tags', 'green');
+        if (opts.publishToNpm) {
+            log(`📦 npm: Publishing triggered (publish/${config.tagPrefix}${newVersion})`, 'green');
         }
+    } else {
+        log('📍 Remote: Not pushed (use --push to enable)', 'gray');
+    }
 
-        // Show files changed
-        if (!quietMode) {
+    if (!quietMode) {
+        try {
             log('\n📝 Files changed:');
             const diff = execSync('git diff HEAD~1 --stat').toString();
             console.log(diff);
+        } catch {
+            // No previous commit to diff against
         }
-
-        log('━'.repeat(50), 'gray');
-        log('\n✅ Version bump complete!\n', 'green');
-
-    } catch (error) {
-        logError('\n❌ Error: ' + error.message);
-        process.exit(1);
     }
+
+    log('━'.repeat(50), 'gray');
+    log('\n✅ Version bump complete!\n', 'green');
 }
 
-// Show help
-if (hasFlag('--help', '-h')) {
+// =============================================================================
+// Help
+// =============================================================================
+
+function printHelp() {
     console.log(`
 vnxt (vx) - Version Bump CLI Tool
 
@@ -491,17 +529,18 @@ Usage:
 Options:
   -m, --message <msg>      Commit message (required, or use interactive mode)
   -t, --type <type>        Version type: patch, minor, major (auto-detected from message)
-  -v, --version <ver>      Set specific version (e.g., 2.0.0-beta.1)
-  -V, --version            Show vnxt version
+  -sv, --set-version <v>   Set a specific version (e.g., 2.0.0-beta.1)
+  -gv, --get-version       Show the current project's version
+  -vv, --vnxt-version      Show the installed vnxt version
   -p, --push               Push to remote with tags
   -dnp, --no-push          Prevent auto-push (overrides config)
-  --publish                Push and trigger npm publish via GitHub Actions
+  --publish                Push and trigger npm publish via GitHub Actions (implies --push)
   -c, --changelog          Update CHANGELOG.md
   -d, --dry-run            Show what would happen without making changes
   -a, --all [mode]         Stage files before versioning
                            Modes: tracked (default), all, interactive (i), patch (p)
                            If no mode specified, prompts interactively
-  -r, --release            Generate release notes file
+  -r, --release            Generate release notes file (saved to release-notes/)
   -q, --quiet              Minimal output (errors only)
   -h, --help               Show this help message
 
@@ -510,7 +549,7 @@ Auto-detection:
   - "minor:" → minor version
   - "patch:" → patch version
   - "feat:" or "feature:" → minor version
-  - "fix:" → patch version  
+  - "fix:" → patch version
   - "BREAKING" or "breaking:" → major version
 
 Configuration:
@@ -526,11 +565,12 @@ Configuration:
   }
 
 Examples:
-  vx -V                                   # Show version
+  vx -vv                                  # Show vnxt version
+  vx -gv                                  # Show current project version
   vx -m "fix: resolve bug"                # Auto-pushes with autoPush: true
   vx -m "feat: add new feature"           # Auto-pushes with autoPush: true
   vx -m "fix: bug" -dnp                   # Don't push (override)
-  vx -v 2.0.0-beta.1 -m "beta release"
+  vx -sv 2.0.0-beta.1 -m "beta release"
   vx -m "test" -d
   vx -m "fix: bug" -a                     # Interactive prompt for staging
   vx -m "fix: bug" -a tracked             # Stage tracked files only
@@ -539,10 +579,75 @@ Examples:
   vx -m "fix: bug" -a p                   # Patch mode
   vx -m "fix: bug" -q                     # Quiet mode (minimal output)
   vx -m "feat: new feature" --publish     # Bump, push and trigger npm publish
+  vx -m "fix: bug" -r                     # Generate release notes in release-notes/
   vx                                      # Interactive mode
 `);
-    process.exit(0);
 }
 
-// Run main function
+// =============================================================================
+// Main
+// =============================================================================
+
+async function main() {
+    try {
+        handleQuickFlags();
+
+        // Git repo check
+        if (!fs.existsSync('.git')) {
+            logError('❌ Not a git repository. Run `git init` first.');
+            process.exit(1);
+        }
+
+        const opts = parseArgs();
+
+        // Interactive mode if no message provided
+        if (!opts.message) {
+            await runInteractiveMode(opts);
+        }
+
+        // Auto-detect version type from commit message
+        if (!opts.customVersion && !getFlag('--type', '-t')) {
+            opts.type = detectVersionType(opts.message, opts.type);
+        }
+
+        // Validate version type
+        if (!opts.customVersion && !['patch', 'minor', 'major'].includes(opts.type)) {
+            logError('Error: Version type must be patch, minor, or major');
+            process.exit(1);
+        }
+
+        // Release notes context prompt
+        let releaseNotesContext = '';
+        if (!opts.generateReleaseNotes && opts.publishToNpm) {
+            opts.generateReleaseNotes = true;
+            if (!quietMode) {
+                log('\n📋 Release notes required for --publish.', 'yellow');
+                releaseNotesContext = await prompt('   Add context (press Enter to skip): ');
+                if (releaseNotesContext) log('');
+            }
+        } else if (opts.generateReleaseNotes && !quietMode) {
+            releaseNotesContext = await prompt('\n📋 Add context to release notes (press Enter to skip): ');
+            if (releaseNotesContext) log('');
+        }
+
+        const branch = await runPreflightChecks(opts);
+
+        if (opts.dryRun) runDryRun(opts);
+
+        if (opts.addMode) stageFiles(opts.addMode);
+
+        const { oldVersion, newVersion, packageJson } = bumpVersion(opts);
+
+        if (opts.generateChangelog)    generateChangelog(newVersion, opts.message);
+        if (opts.generateReleaseNotes) generateReleaseNotes(newVersion, opts.message, releaseNotesContext, packageJson, opts.publishToNpm);
+        if (opts.push)                 pushToRemote(opts, newVersion);
+
+        printSummary(opts, oldVersion, newVersion, branch);
+
+    } catch (error) {
+        logError('\n❌ Error: ' + error.message);
+        process.exit(1);
+    }
+}
+
 main();