version-bump-ag

# Version Bump Workflow Automatically bump the project version, generate CHANGELOG entries from git history since the last tag, update every file that references the version, and refresh project documentation to reflect the current state. > **VERSION RULE: Always use PATCH bumps (3.x.y → 3.x.y+1)** > NEVER use `npm version minor` or `npm version major`. > Always use: `npm version patch --no-git-tag-version` > The threshold rule: when `y` reaches 1000, bump to `3.(x+1).0` — e.g. `3.4.999` → `3.5.0`. --- ## Phase 1: Determine Version ### 1. Read current version and last tag // turbo ```bash cd /home/diegosouzapw/dev/proxys/OmniRoute CURRENT_VERSION=$(node -p "require('./package.json').version") LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "") CURRENT_BRANCH=$(git branch --show-current) echo "Current version: $CURRENT_VERSION" echo "Last tag: $LAST_TAG" echo "Current branch: $CURRENT_BRANCH" ``` ### 2. Calculate new version Apply the patch bump rule: - If the current patch number is `9`, the new version is `3.(minor+1).0` - Otherwise, increment patch: `3.x.y` → `3.x.(y+1)` If the version was ALREADY bumped (e.g. you are on a release branch and package.json already has the new version), **skip the npm version bump** and use the existing version. ### 3. Bump package.json (if needed) // turbo ```bash # Only if version hasn't been bumped yet npm version patch --no-git-tag-version ``` Or for threshold (y=10): ```bash # Manual threshold bump VERSION="3...