vnxt 1.8.0 → 1.9.0

package/README.md

@@ -10,7 +10,7 @@ A lightweight CLI tool for automated version bumping with changelog generation a
 
 - 🚀 Automatic semantic version detection from commit messages
 - 📝 Automatic CHANGELOG.md generation
-- 🏷️ Git tag annotation
+- 🏷️ Git tag annotation with configurable prefix
 - 🔍 Pre-flight checks for clean working directory
 - 🔬 Dry-run mode to preview changes
 - 📋 Release notes generation
@@ -18,6 +18,7 @@ A lightweight CLI tool for automated version bumping with changelog generation a
 - 💬 Interactive mode when no arguments provided
 - 🎨 Colored terminal output for better readability
 - 🤫 Quiet mode for CI/CD environments
+- 📦 Automated npm publishing via GitHub Actions Trusted Publishing
 
 ## <img src="./docs/logos/caret-38x38.png" width="24" align="center"> Installation
 
@@ -92,6 +93,7 @@ All options work with both `vnxt` and `vx`:
 -V, --version            Show 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
 -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)
@@ -242,9 +244,48 @@ vnxt --version
 
 Output:
 ```
-vnxt v1.7.0
+vnxt v1.8.0
 ```
 
+### npm Publish
+
+Trigger an automated npm publish via GitHub Actions using Trusted Publishing (OIDC):
+
+**Bash/PowerShell:**
+```bash
+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
+
+This means you can batch up multiple changes without publishing to npm each time:
+```bash
+vx -m "feat: add something"         # bump only
+vx -m "fix: fix something"          # bump only
+vx -m "feat: final thing" --publish # bump + publish everything
+```
+
+**Note:** `--publish` implies `--push`, so `-p` is not required.
+
+### Custom Tag Prefix
+
+Control the prefix used for git tags via `.vnxtrc.json`:
+
+```json
+{
+  "tagPrefix": "v"
+}
+```
+
+**Options:**
+- `"v"` → `v1.8.0` (default)
+- `""` → `1.8.0` (no prefix)
+- `"release-"` → `release-1.8.0` (useful in monorepos)
+
 ### Complete Workflow Example
 
 **Bash/PowerShell:**
@@ -362,6 +403,16 @@ vx -m "chore: refactor code" -a
 vx -m "chore: automated update" -q
 ```
 
+### Publish to npm
+
+**Bash/PowerShell:**
+```bash
+# Batch changes then publish when ready
+vx -m "feat: add feature one"
+vx -m "fix: fix something"
+vx -m "feat: final feature" --publish
+```
+
 ### Check Installed Version
 
 **Bash/PowerShell:**

package/package.json

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

package/vnxt.js

@@ -97,8 +97,8 @@ 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 push = noPush ? false : (hasFlag('--push', '-p') || config.autoPush);
 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;
@@ -197,6 +197,22 @@ async function main() {
             process.exit(1);
         }
 
+        // 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('');
+        }
+
         // PRE-FLIGHT CHECKS
         log('\n🔍 Running pre-flight checks...\n', 'cyan');
 
@@ -365,12 +381,24 @@ async function main() {
         // GENERATE RELEASE NOTES
         if (generateReleaseNotes) {
             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 {
+                author = '';
+            }
+
             const releaseNotes = `# Release ${config.tagPrefix}${newVersion}
 
-Released: ${new Date().toISOString().split('T')[0]}
+Released: ${dateShort} at ${timestamp.split(' ')[1]}${author ? `\nAuthor: ${author}` : ''}
 
 ## Changes
-${message}
+${message}${releaseNotesContext ? `\n\n## Release Notes\n${releaseNotesContext}` : ''}
 
 ## Installation
 \`\`\`bash