Upgrade to v0.4.0
Exevra v0.4.0 is compatible with existing version-1 .exevra.yml files and schema-version-1 baselines. No migration is required for a standard Node or Maven configuration.
Update the CLI and Action
Section titled “Update the CLI and Action”Update the development dependency and lockfile:
npm install --save-dev @exevra-dev/cli@0.4.0If a workflow uses the GitHub Action, update its versioned reference:
- uses: Exevra/exevra@v0.4.0Keep uses: ./ only for testing a checked-out copy of Exevra.
Adopt the new workflows
Section titled “Adopt the new workflows”- Use
doctorwhen a check fails and you need to identify the failing stage. It does not modify configuration or the baseline. - Use
diffto review an intentional execution-contract change, then runrecord --writeonly after approval. - Use
aggregatein a collector job when matrix or shard reports have already been downloaded.
npx exevra doctornpx exevra diffnpx exevra record --writeBuild discovery changes
Section titled “Build discovery changes”For Gradle multi-project builds that use standard JUnit output, initialize a new configuration with:
npx exevra init --gradleExisting Maven configurations can opt into the explicit filter policy if they do not already have it:
maven: modules: auto filter_policy: warnMaven auto-discovery now checks declared child modules and keeps missing or unreadable standard reports visible. If a project uses custom report locations, use explicit report paths instead of relying on auto-discovery.
Verify the upgrade
Section titled “Verify the upgrade”Run the normal check and review any intentional baseline change before committing it:
npm cinpx exevra checknpx exevra diffOutput remains privacy-safe in text, JSON, GitHub Actions, and Action job summaries. Raw commands, selector values, test identifiers, and report contents are not included by default.