@metalagman/semverctl-linux-arm64 0.0.8 → 0.0.11

package/README.md

@@ -9,15 +9,18 @@
 [![PyPI](https://img.shields.io/pypi/v/semverctl)](https://pypi.org/project/semverctl/)
 [![license](https://img.shields.io/github/license/metalagman/semverctl)](LICENSE)
 
-CLI for bumping and setting SemVer values in JSON/YAML files
+CLI for bumping and setting SemVer values in JSON/YAML files and Git tags
 
 ## Features
 
 - ✨ **Semantic Versioning** - Strict SemVer 2.0.0 compliance with prerelease and build metadata support
-- 📁 **Multiple Formats** - JSON and YAML file support
+- 📁 **File + Tag Workflows** - Explicit `bump/set file` and `bump/set tag` commands
+- 🏷️ **Git Tag Releases** - Bump from latest stable `vX.Y.Z` tag or set explicit tags
 - 🎯 **Path Navigation** - Dot-notation paths for nested version fields (e.g., `.app.version`)
 - 🔢 **Numeric Bumping** - Bump individual numeric fields for object-style versions
 - 🧪 **Dry-Run Mode** - Preview changes with unified diff output
+- 🤖 **Automation-Friendly JSON** - `--json` output for machine-readable success/error payloads
+- 🔒 **Safety Checks** - Tag operations require a clean repository state
 - 🌐 **Cross-Platform** - Linux, macOS, and Windows support (CGO-free)
 - ⚡ **Zero Dependencies** - Pure Go implementation with no runtime dependencies
 - 📦 **Multiple Distribution Channels** - Go install, npm, uv/PyPI, and GitHub Releases
@@ -67,45 +70,84 @@ sha256sum -c checksums.txt
 
 ## Usage
 
-### Bump Version
+### Bump File Version
 
-Bump the semantic version at the specified path in JSON or YAML files:
+Bump the semantic version in a specific JSON or YAML file:
 
 ```bash
-# Bump patch version in package.json (default target)
-semverctl bump
+# Bump patch in a file
+semverctl bump file package.json
 
-# Bump specific version component in package.json
-semverctl bump --minor
-semverctl bump --major
-semverctl bump --patch
+# Bump specific version component
+semverctl bump file package.json --minor
+semverctl bump file package.json --major
 
-# Bump version in a specific file at a custom path
-semverctl bump --file config.yaml --path .app.version
+# Bump version at a custom path
+semverctl bump file config.yaml --path .app.version
 
-# Bump all matching files in current directory tree
-semverctl bump --glob "**/*.json"
+# Preview changes without modifying the file
+semverctl bump file package.json --dry-run
 
-# Preview changes without modifying files
-semverctl bump --dry-run
+# Machine-readable output for automation
+semverctl bump file package.json --dry-run --json
 ```
 
-### Set Version
+### Set File Version
 
-Set an explicit version value:
+Set an explicit version value in a specific file:
 
 ```bash
-# Set version to 1.2.3 in package.json (default target)
-semverctl set 1.2.3
+# Set version to 1.2.3 in a file
+semverctl set file 1.2.3 package.json
 
-# Set version in a specific file at a custom path
-semverctl set 2.0.0 --file config.yaml --path .app.version
-
-# Set version in all matching files under current directory
-semverctl set 2.0.0 --glob "**/*.json"
+# Set version at a custom path
+semverctl set file 2.0.0 config.yaml --path .app.version
 
 # Preview changes
-semverctl set 1.0.0 --dry-run
+semverctl set file 1.0.0 package.json --dry-run
+
+# Machine-readable output for automation
+semverctl set file 1.2.3 package.json --json
+```
+
+### Bump Tag
+
+Bump from the latest stable git tag (`vX.Y.Z`) and create a new annotated tag:
+
+```bash
+# Create next patch tag
+semverctl bump tag
+
+# Create next minor tag
+semverctl bump tag --minor
+
+# Preview tag creation
+semverctl bump tag --dry-run
+
+# Create and push tag to origin
+semverctl bump tag --push
+
+# Machine-readable output for automation
+semverctl bump tag --dry-run --json
+```
+
+### Set Tag
+
+Create an explicit annotated git tag:
+
+```bash
+# Accepts 1.2.3 or v1.2.3
+semverctl set tag 1.2.3
+semverctl set tag v2.0.0
+
+# Preview tag creation
+semverctl set tag 2.1.0 --dry-run
+
+# Create and push tag to origin
+semverctl set tag 2.1.0 --push
+
+# Machine-readable output for automation
+semverctl set tag 2.1.0 --json
 ```
 
 ### Numeric Bump
@@ -114,7 +156,7 @@ For object-style version fields (e.g., `{ "Major": 1, "Minor": 2, "Patch": 3 }`)
 you can bump numeric scalar values:
 
 ```bash
-semverctl bump --numeric --path .version.Patch --file config.json
+semverctl bump file config.json --numeric --path .version.Patch
 ```
 
 This increments the numeric value at the specified path by 1.
@@ -147,13 +189,27 @@ semverctl follows the [Semantic Versioning 2.0.0](https://semver.org/) specifica
 
 ## Dry-Run Mode
 
-Use `--dry-run` to preview changes without modifying files:
+Use `--dry-run` to preview file changes or tag actions without mutation:
+
+```bash
+semverctl bump file package.json --dry-run
+semverctl bump tag --dry-run
+```
+
+For file commands, this outputs a unified diff showing what would change.
+
+## JSON Output
+
+Use `--json` for machine-readable automation output:
 
 ```bash
-semverctl bump --dry-run package.json
+semverctl bump tag --dry-run --json
+semverctl set tag 1.2.3 --json
+semverctl bump file package.json --dry-run --json
 ```
 
-This outputs a unified diff showing what would change.
+When `--json` is enabled, both success and failure responses are printed as JSON to stdout.
+Failures still return a non-zero exit code.
 
 ## Exit Codes
 

package/package.json

@@ -16,5 +16,5 @@
   "os": [
     "linux"
   ],
-  "version": "0.0.8"
+  "version": "0.0.11"
 }