@metalagman/semverctl-linux-arm64 0.0.7 → 0.0.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alexey Samoylov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -67,42 +67,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 (default)
-semverctl bump package.json
+# Bump patch in a file
+semverctl bump file package.json
 
 # Bump specific version component
-semverctl bump --minor package.json
-semverctl bump --major package.json
-semverctl bump --patch package.json
+semverctl bump file package.json --minor
+semverctl bump file package.json --major
 
 # Bump version at a custom path
-semverctl bump --path .app.version config.yaml
+semverctl bump file config.yaml --path .app.version
 
-# Bump all JSON files in a directory
-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 package.json
+# 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
-semverctl set 1.2.3 package.json
+# Set version to 1.2.3 in a file
+semverctl set file 1.2.3 package.json
 
 # Set version at a custom path
-semverctl set 2.0.0 --path .app.version config.yaml
+semverctl set file 2.0.0 config.yaml --path .app.version
 
 # Preview changes
-semverctl set 1.0.0 --dry-run package.json
+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
@@ -111,7 +153,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 config.json
+semverctl bump file config.json --numeric --path .version.Patch
 ```
 
 This increments the numeric value at the specified path by 1.
@@ -144,13 +186,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

@@ -8,11 +8,13 @@
   "description": "@metalagman/semverctl binary for linux/arm64",
   "files": [
     "bin",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
+  "license": "SEE LICENSE IN LICENSE",
   "name": "@metalagman/semverctl-linux-arm64",
   "os": [
     "linux"
   ],
-  "version": "0.0.7"
+  "version": "0.0.10"
 }