semver_sherpa 1.1.0

CLI for Semantic Versioning and Keep a Changelog automation in Dart and Flutter repositories.

semver_sherpa

Flutter Sherpa Suite — Professional Engineering Toolkit for Flutter Teams

The Flutter Sherpa Suite is a collection of focused, production-grade engineering tools for Dart and Flutter projects. Each Sherpa solves a distinct problem in the software lifecycle — from architecture and versioning to technical debt, migrations, and risk analysis.

semver_sherpa automates Semantic Versioning and Keep a Changelog workflows for Dart and Flutter repositories.

Installation

dart pub global activate semver_sherpa
semver_sherpa --help

Quick Start

semver_sherpa bump patch
semver_sherpa changelog
semver_sherpa changelog --dry-run --format both --out reports
dart run semver_sherpa changelog --dry-run --json --report-output reports/semver/semver_changelog.json
semver_sherpa validate

Core Commands

semver_sherpa bump <major|minor|patch>
semver_sherpa set <version>
semver_sherpa changelog
semver_sherpa changelog --dry-run --format both --out reports
semver_sherpa changelog --dry-run --json --report-output reports/semver/semver_changelog.json
semver_sherpa validate

Canonical report files written by changelog --dry-run --format both --out reports:

• reports/semver_sherpa.json
• reports/semver_sherpa.md

Suite report example:

dart run semver_sherpa changelog --dry-run --json --report-output reports/semver/semver_changelog.json

Documentation

• Configuration and Behavior Reference
• Troubleshooting
• Pub Score Playbook
• Swift Package Manager Migration Changelog Examples

Part of the Flutter Sherpa Suite

• arch_sherpa - Architectural validation and structure enforcement
• dep_sherpa - Dependency risk intelligence and observability
• semver_sherpa - Semantic versioning and changelog automation
• techdebt_sherpa - Technical debt observatory and hotspot detection

Support the Project

• Buy Me a Coffee: https://buymeacoffee.com/carlosfdev
• Patreon: https://patreon.com/CarlosF_dev

License

MIT. See LICENSE.