✨ Support explicit version name for changelog and release notes

Add --version-name option to changelog and release-notes commands

- Introduce CLI, API, and MCP support for explicit version name overrides
- Accept and plumb version_name through CLI args, MCP tool parameters, and
  internal generation logic for both changelogs and release notes
- Update documentation, man page, and help output to highlight this option
- Enhance changelog/release notes formatting and file update code to use
custom
  version name if provided, overriding Git tag detection
- Extend integration and unit tests to verify custom version name behavior

This unlocks precise control and repeatability in release automation,
enabling human-friendly, workflow-driven release documentation—regardless of
Git ref structure. (CI/CD, here’s your BFF.)

User experience win: teams can align changelogs and notes with manual or
external versioning sources, creating clarity across tools and audiences.

Author: hyperb1iss

Diff for: README.md

@@ -320,13 +320,20 @@ Options:
 - `--gitmoji`: Enable or disable Gitmoji in the changelog
 - `--update`: Update the changelog file with the new changes
 - `--file`: Path to the changelog file (defaults to CHANGELOG.md)
+- `--version-name`: Explicit version name to use in the changelog instead of getting it from Git
 
 Example:
 
 ```bash
 git-iris changelog --from v1.0.0 --to v1.1.0 --detail-level detailed --update
 ```
 
+Example using explicit version name (useful in release workflows):
+
+```bash
+git-iris changelog --from v1.0.0 --to HEAD --update --version-name v1.1.0
+```
+
 ### Generate Release Notes
 
 Create comprehensive release notes:
@@ -343,13 +350,20 @@ Options:
 - `--preset`: Select an instruction preset for release notes generation
 - `--detail-level`: Set the detail level (minimal, standard, detailed)
 - `--gitmoji`: Enable or disable Gitmoji in the release notes
+- `--version-name`: Explicit version name to use in the release notes instead of getting it from Git
 
 Example:
 
 ```bash
 git-iris release-notes --from v1.0.0 --to v1.1.0 --preset conventional
 ```
 
+Example using explicit version name:
+
+```bash
+git-iris release-notes --from v1.0.0 --to HEAD --version-name v1.1.0
+```
+
 ### Project Configuration
 
 Create or update project-specific settings:

Diff for: docs/MCP.md

@@ -114,6 +114,7 @@ Generate a detailed changelog between two Git references.
 - `detail_level`: (string) Level of detail for the changelog (minimal, standard, detailed)
 - `custom_instructions`: (string) Custom instructions for the AI
 - `repository`: (string, required) Repository path (local) or URL (remote). **Required.**
+- `version_name`: (string) Explicit version name to use in the changelog instead of getting it from Git
 
 Example (local path):
 
@@ -127,15 +128,15 @@ Example (local path):
 }
 ```
 
-Example (remote URL):
+Example with version name (useful in release workflows):
 
 ```json
 {
   "from": "v1.0.0",
-  "to": "v2.0.0",
+  "to": "HEAD",
   "detail_level": "detailed",
-  "custom_instructions": "Group changes by component",
-  "repository": "https://github.com/example/repo.git"
+  "version_name": "v2.0.0-beta",
+  "repository": "/home/bliss/dev/myproject"
 }
 ```
 
@@ -150,6 +151,7 @@ Generate comprehensive release notes between two Git references.
 - `detail_level`: (string) Level of detail for the release notes (minimal, standard, detailed)
 - `custom_instructions`: (string) Custom instructions for the AI
 - `repository`: (string, required) Repository path (local) or URL (remote). **Required.**
+- `version_name`: (string) Explicit version name to use in the release notes instead of getting it from Git
 
 Example (local path):
 
@@ -163,15 +165,15 @@ Example (local path):
 }
 ```
 
-Example (remote URL):
+Example with version name:
 
 ```json
 {
   "from": "v1.0.0",
-  "to": "v2.0.0",
+  "to": "HEAD",
   "detail_level": "standard",
-  "custom_instructions": "Highlight breaking changes",
-  "repository": "https://github.com/example/repo.git"
+  "version_name": "v2.0.0-rc1",
+  "repository": "/home/bliss/dev/myproject"
 }
 ```