| main-branch | Main branch to analyze changes from | no | main |
| feature-branch | Feature branch containing changes to analyze | yes | — |
| github-token | GitHub token for API access | no | ${{ github.token }} |
| package-json-path | Path to package.json file | no | ./package.json |
| changelog-path | Path to CHANGELOG.md file | no | ./CHANGELOG.md |
| versioning-strategy | Versioning analysis strategy: conventional, ai, or hybrid | no | hybrid |
| ai-provider | AI provider for analysis: openai, anthropic | no | openai |
| openai-api-key | OpenAI API key for AI-powered analysis | no | — |
| anthropic-api-key | Anthropic API key for AI-powered analysis | no | — |
| ai-model | AI model to use (e.g., gpt-4, gpt-3.5-turbo, claude-3-opus) | no | gpt-4 |
| ai-confidence-threshold | Minimum confidence score to trust AI analysis (0.0-1.0) | no | 0.7 |
| conventional-types | Comma-separated list of conventional commit types to recognize | no | feat,fix,docs,style,refactor,test,chore,build,ci,perf |
| changelog-format | Changelog format: keepachangelog, custom | no | keepachangelog |
| changelog-template | Path to custom changelog template (when format is custom) | no | — |
| pre-release | Generate a pre-release version (alpha, beta, rc) | no | false |
| pre-release-identifier | Pre-release identifier when pre-release is true | no | beta |
| skip-changelog | Skip changelog generation | no | false |
| skip-git-tag | Skip creating git tag for the release | no | false |
| max-commits-analysis | Maximum number of commits to analyze (performance optimization) | no | 100 |
| enable-caching | Enable AI response caching to reduce API costs | no | true |
| debug-mode | Enable detailed logging for debugging | no | false |