Merge pull request #177 from buildkite/tet-323-release-version-09-of-…

…the-test-splitter-changelog

Update CHANGELOG.md for 0.9.0

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.9.0 - 2024-09-11
+- ⚠️ **BREAKING** Add the `BUILDKITE_SPLITTER_RESULT_PATH` required environment variable. See [Migrating to 0.9.0](https://github.com/buildkite/test-splitter/tree/db4cab8cd6c82392553cd80481cf75e3888c2f4c?tab=readme-ov-file#migrating-to-090).
+- Experimental support for Jest by setting `BUILDKITE_SPLITTER_TEST_RUNNER` to `jest`.
+- Update the retry behavior to only retry failed tests.
+- Update split-by-example behavior to perform more work server-side.
+- Improve configuration error message.
+- Fix issue printing dry-run errors.
+- Fix issue with `BUILDKITE_STEP_ID` presence validation.
+
 ## 0.8.1 - 2024-08-06
 - Add BUILDKITE_BRANCH env var for test plan experiments
 - Fix to zzglob library issue where files not matching the include pattern are in the test plan

README.md

@@ -3,6 +3,11 @@
 Buildkite Test Splitter is an open source tool to orchestrate your test suites. It uses your Buildkite Test Analytics suite data to intelligently partition and parallelise your tests. 
 Test Splitter currently only supports RSpec but support for other frameworks is coming soon.
 
+## Migrating to 0.9.0
+Version 0.9.0 introduces a new feature that requires Test Splitter to read test results from the runner for retries and verification purposes. To enable this feature, it is necessary to configure the `BUILDKITE_SPLITTER_RESULT_PATH` environment variable. This variable specifies the location of where the runner should store test results.
+
+Furthermore, we have updated the default test command for RSpec to `bundle exec rspec --format progress --format json --out {{resultPath}} {{testExamples}}`. Test Splitter will automatically replace `{{resultPath}}` with the value specified in `BUILDKITE_SPLITTER_RESULT_PATH`. If you want to customize the RSpec command, make sure to include `--format json --out {{resultPath}}` in the command. 
+
 ## Installation
 The latest version of Buildkite Test Splitter can be downloaded from https://github.com/buildkite/test-splitter/releases