feat: Implement single-source versioning

- Version now maintained only in pyproject.toml
- __init__.py dynamically reads version from pyproject.toml
- Tests no longer hardcode version numbers
- Add release.py script for complete release automation
- Add bump-version.py for simple version updates
- Update scripts README with new tools

The release.py script automates the entire release process:
1. Bump version (major/minor/patch)
2. Run tests
3. Build and upload to PyPI
4. Create git commit and tag
5. Create GitHub release

This eliminates the need to update version in multiple places.

Fixes #18

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: rolfedh

CLAUDE.md

@@ -308,26 +308,26 @@ A comprehensive test suite prevents Jekyll deployment failures:
 ## Recent Development Focus (July 2025)
 
 ### Statistics
-- Total commits: 198
+- Total commits: 220
 
 ### Latest Achievements
+- ✅ Implement single-source versioning.
 - ✅ Add intermediate recheck step and fix accurate fix counting in journey workflow.
 - ✅ Add vale configuration and update asciidocdita styles for improved validation.
 - ✅ Reintroduce claude.md updater workflow with enhanced commit parsing.
 - ✅ Improve directory selection ui for better user experience.
-- ✅ Add demo script for getting started with aditi toolkit.
 
 ### Development Focus
-- **Ci/Cd**: 79 commits
-- **Features**: 22 commits
-- **Documentation**: 16 commits
-- **Bug Fixes**: 15 commits
-- **Testing**: 11 commits
+- **Ci/Cd**: 89 commits
+- **Features**: 23 commits
+- **Bug Fixes**: 18 commits
+- **Documentation**: 17 commits
+- **Testing**: 12 commits
 
 ### Most Active Files
-- `docs/_data/recent_commits.yml`: 76 changes
-- `CLAUDE.md`: 58 changes
-- `src/aditi/commands/journey.py`: 18 changes
+- `docs/_data/recent_commits.yml`: 85 changes
+- `CLAUDE.md`: 63 changes
+- `src/aditi/commands/journey.py`: 19 changes
 <!-- /AUTO-GENERATED:RECENT -->
 
 ## Building and Publishing

scripts/README.md

@@ -2,6 +2,60 @@
 
 Utility scripts for the Aditi project.
 
+## Release Management
+
+### 🚀 release.py
+**Complete release automation script** - Handles the entire release process in one command.
+
+```bash
+# Bump patch version and release (0.1.7 → 0.1.8)
+python scripts/release.py patch
+
+# Bump minor version and release (0.1.7 → 0.2.0)
+python scripts/release.py minor
+
+# Bump major version and release (0.1.7 → 1.0.0)
+python scripts/release.py major
+
+# Dry run to see what would happen
+python scripts/release.py patch --dry-run
+
+# Skip tests during release
+python scripts/release.py patch --skip-tests
+
+# Only do git operations (no PyPI upload)
+python scripts/release.py patch --skip-pypi
+```
+
+**What it does:**
+1. Bumps version in `pyproject.toml` (single source of truth!)
+2. Runs tests
+3. Builds the package
+4. Uploads to PyPI
+5. Creates git commit and tag
+6. Pushes to GitHub
+7. Creates GitHub release
+
+### 📝 bump-version.py
+**Simple version bump script** - Only updates the version number.
+
+```bash
+# Show current version
+python scripts/bump-version.py
+
+# Bump patch version (0.1.7 → 0.1.8)
+python scripts/bump-version.py patch
+
+# Bump minor version (0.1.7 → 0.2.0)
+python scripts/bump-version.py minor
+
+# Set specific version
+python scripts/bump-version.py --set 1.2.3
+```
+
+### 📦 publish-to-pypi.sh (Legacy)
+**Note:** This script is being replaced by `release.py`. It still works but requires manual version updates in multiple files.
+
 ## Blog Post Creation
 
 ### `new-blog-post.sh`

scripts/bump-version.py

@@ -0,0 +1,115 @@
+#!/usr/bin/env python3
+"""
+Simple version bump script for Aditi.
+
+This script only bumps the version in pyproject.toml.
+Use this when you want to bump the version without doing a full release.
+"""
+
+import argparse
+import sys
+import re
+from pathlib import Path
+
+try:
+    import tomllib
+except ImportError:
+    try:
+        import tomli as tomllib
+    except ImportError:
+        print("Error: tomli/tomllib not found. Install with: pip install tomli")
+        sys.exit(1)
+
+
+def get_current_version():
+    """Get current version from pyproject.toml."""
+    with open("pyproject.toml", "rb") as f:
+        data = tomllib.load(f)
+        return data["project"]["version"]
+
+
+def bump_version(version, bump_type):
+    """Bump version based on type (major, minor, patch)."""
+    parts = version.split(".")
+    major, minor, patch = int(parts[0]), int(parts[1]), int(parts[2])
+    
+    if bump_type == "major":
+        return f"{major + 1}.0.0"
+    elif bump_type == "minor":
+        return f"{major}.{minor + 1}.0"
+    else:  # patch
+        return f"{major}.{minor}.{patch + 1}"
+
+
+def update_version_in_file(file_path, old_version, new_version):
+    """Update version in a file."""
+    content = file_path.read_text()
+    # Match version = "x.y.z" pattern
+    pattern = f'version = "{re.escape(old_version)}"'
+    replacement = f'version = "{new_version}"'
+    
+    if pattern in content:
+        new_content = content.replace(pattern, replacement)
+        file_path.write_text(new_content)
+        return True
+    return False
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Bump Aditi version")
+    parser.add_argument(
+        "bump_type", 
+        choices=["major", "minor", "patch"],
+        nargs="?",
+        help="Version bump type (optional - will show current version if not provided)"
+    )
+    parser.add_argument(
+        "--set",
+        help="Set version to a specific value (e.g., --set 1.2.3)"
+    )
+    
+    args = parser.parse_args()
+    
+    # Check we're in the right directory
+    if not Path("pyproject.toml").exists():
+        print("❌ Error: pyproject.toml not found. Are you in the project root?")
+        sys.exit(1)
+    
+    # Get current version
+    current_version = get_current_version()
+    
+    # If no arguments, just show current version
+    if not args.bump_type and not args.set:
+        print(f"Current version: {current_version}")
+        print("\nUsage:")
+        print("  Bump version:  python scripts/bump-version.py [major|minor|patch]")
+        print("  Set version:   python scripts/bump-version.py --set 1.2.3")
+        return
+    
+    # Determine new version
+    if args.set:
+        new_version = args.set
+        # Validate version format
+        if not re.match(r'^\d+\.\d+\.\d+$', new_version):
+            print(f"❌ Invalid version format: {new_version}")
+            print("Version must be in format X.Y.Z (e.g., 1.2.3)")
+            sys.exit(1)
+    else:
+        new_version = bump_version(current_version, args.bump_type)
+    
+    print(f"🔄 Bumping version from {current_version} to {new_version}")
+    
+    # Update version in pyproject.toml
+    if not update_version_in_file(Path("pyproject.toml"), current_version, new_version):
+        print("❌ Failed to update version in pyproject.toml")
+        sys.exit(1)
+    
+    print(f"✅ Version updated to {new_version} in pyproject.toml")
+    print("\nNext steps:")
+    print("  1. Review the change: git diff pyproject.toml")
+    print("  2. Run tests: pytest")
+    print(f"  3. Full release: python scripts/release.py patch")
+
+
+if __name__ == "__main__":
+    main()