Merge pull request #19 from braintrustdata/release/0.4.0

Release 0.4.0

Author: dpguthrie

CHANGELOG.md

@@ -18,6 +18,23 @@ The format is based on Keep a Changelog and this project follows Semantic Versio
 
 - N/A
 
+## [0.4.0] - 2026-06-08
+
+### Added
+
+- Automatic spilling of oversized event fields into JSON attachments: when a row exceeds the ~20MB per-span logging upload limit, the largest of `input`, `output`, `metadata`, `expected`, `error`, and `span_attributes` are uploaded to the destination as `braintrust_attachment` references so the span migrates successfully instead of failing on `/logs3/overflow`. Applies to logs, experiment events, and dataset events; always on, no configuration required.
+- End-to-end and unit coverage for oversize-field spilling, including a full `LogsMigrator` run over a >20MB event.
+
+### Changed
+
+- Folded per-event size measurement into a single pass in the streaming insert path, reusing the result for both oversize detection and byte accounting (removes a redundant serialization).
+- Tracked spilled-field counts in streaming checkpoint state and migration reports.
+
+### Fixed
+
+- Experiment migration now remaps `parameters_id` (a foreign key to the prompts table) to the destination prompt id, or drops it together with `parameters_version` when the prompt was not migrated, preventing foreign-key violations introduced by recent OpenAPI schema additions.
+- Migrated `tags` for datasets, now that it is part of the dataset create schema.
+
 ## [0.3.0] - 2026-04-07
 
 ### Added

README.md

@@ -55,7 +55,7 @@ This tool provides migration capabilities for Braintrust organizations, handling
 This project is not yet published on PyPI. Install a pinned release from GitHub:
 
 ```bash
-pip install "git+https://github.com/braintrustdata/braintrust-migrate.git@v0.3.0"
+pip install "git+https://github.com/braintrustdata/braintrust-migrate.git@v0.4.0"
 ```
 
 > Avoid installing directly from `main` in production workflows.

braintrust_migrate/__init__.py

@@ -3,7 +3,7 @@
 A Python CLI & library for migrating Braintrust organizations with maximum fidelity.
 """
 
-__version__ = "0.3.0"
+__version__ = "0.4.0"
 __author__ = "Braintrust Migration Tool"
 __email__ = "support@braintrust.dev"
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "braintrust-migrate"
-version = "0.3.0"
+version = "0.4.0"
 description = "CLI & library for migrating Braintrust organizations with maximum fidelity"
 readme = "README.md"
 requires-python = ">=3.12"