| github-token | GitHub token for creating releases and tags | no | ${{ github.token }} |
| main-branch | Name of the main/production branch | no | main |
| version-prefix | Prefix for version tags (e.g., v for v1.2.3) | no | v |
| initial-version | Initial version if no tags exist | no | 0.1.0 |
| prerelease-prefix | Prefix for prerelease versions (e.g., beta, alpha, rc) | no | "" |
| changelog-path | Path to CHANGELOG.md file | no | ./CHANGELOG.md |
| changelog-enabled | Enable automatic changelog generation | no | true |
| commit-type-mapping | JSON mapping of commit types to changelog sections (empty uses convention-aware defaults) | no | "" |
| exclude-types | Comma-separated list of commit types to exclude from changelog (empty uses convention-aware defaults) | no | "" |
| exclude-scopes | Comma-separated list of commit scopes to exclude from changelog | no | "" |
| major-keywords | Comma-separated keywords that trigger major version bump | no | BREAKING CHANGE,BREAKING-CHANGE,breaking |
| minor-keywords | Comma-separated keywords that trigger minor version bump (empty uses convention-aware defaults) | no | "" |
| patch-keywords | Comma-separated keywords that trigger patch version bump (empty uses convention-aware defaults) | no | "" |
| create-release | Enable GitHub Release creation | no | true |
| release-draft | Create release as draft | no | false |
| release-prerelease | Mark release as prerelease | no | false |
| release-name-template | Template for release name (supports {tag}, {version}, {date}) | no | {tag} |
| git-user-name | Git user name for commits | no | WG Tech Labs |
| git-user-email | Git user email for commits | no | 262751631+wgtechlabs-automation@users.noreply.github.com |
| commit-changelog | Commit and push changelog changes back to repository | no | true |
| sync-version-files | Automatically update version in manifest files (package.json, Cargo.toml, pyproject.toml, pubspec.yaml) | no | true |
| version-file-paths | Comma-separated paths to manifest files to update (auto-detected if not specified) | no | "" |
| commit-convention | Commit message convention for auto-generated commits (clean-commit or conventional) | no | clean-commit |
| dry-run | Run without creating tags or releases (testing mode) | no | false |
| tag-only | Only create tag without GitHub Release | no | false |
| update-major-tag | Automatically update the major version tag (e.g., v1) to point to the latest release tag. Standard practice for GitHub Actions. | no | false |
| fetch-depth | Number of commits to fetch for changelog (0 for all) | no | 0 |
| include-all-commits | Include all commits in changelog, not just since last tag | no | false |
| monorepo | Enable monorepo mode for multi-package repositories | no | false |
| workspace-detection | Auto-detect workspace packages from package.json, pnpm-workspace.yaml, etc. | no | true |
| change-detection | How to detect affected packages: scope (commit scope), path (file changes), or both | no | both |
| scope-package-mapping | JSON mapping of commit scopes to package paths (auto-detected if not provided) | no | "" |
| per-package-changelog | Generate CHANGELOG.md in each package directory | no | true |
| root-changelog | Generate aggregated CHANGELOG.md at repository root | no | true |
| cascade-bumps | (Reserved for future use) Automatically bump packages that depend on updated packages | no | false |
| unified-version | All packages share a single unified version number | no | false |
| monorepo-root-release | Create a unified root release (tag and GitHub Release) alongside per-package releases in monorepo mode | no | true |
| package-manager | Package manager for workspace detection (npm, bun, pnpm, yarn) - auto-detected if not specified | no | "" |