diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0d0d900..1b6d77c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,16 @@
 
 All notable changes to Floe are documented in this file.
 
+## v0.3.1
+
+- Delta merge write modes:
+  - added `merge_scd1` support for keyed upserts into accepted Delta outputs
+  - added `merge_scd2` support for history-preserving merges with managed current/validity columns
+- Schema/config validation:
+  - added `schema.primary_key` as the explicit merge key surface, including validation for required, known, unique, non-nullable key columns
+- Merge/reporting refinements:
+  - added configurable Delta merge options and SCD2 closed/unchanged reporting metrics
+
 ## v0.3.0
 
 - Core performance and observability:
diff --git a/Cargo.lock b/Cargo.lock
index 47d13ed..5d241b3 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -3376,7 +3376,7 @@ dependencies = [
 
 [[package]]
 name = "floe-cli"
-version = "0.3.0"
+version = "0.3.1"
 dependencies = [
  "assert_cmd",
  "clap",
@@ -3389,7 +3389,7 @@ dependencies = [
 
 [[package]]
 name = "floe-core"
-version = "0.3.0"
+version = "0.3.1"
 dependencies = [
  "apache-avro 0.16.0",
  "arrow",
diff --git a/crates/floe-cli/Cargo.toml b/crates/floe-cli/Cargo.toml
index 73f26fa..e230da7 100644
--- a/crates/floe-cli/Cargo.toml
+++ b/crates/floe-cli/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "floe-cli"
-version = "0.3.0"
+version = "0.3.1"
 edition = "2021"
 description = "CLI for Floe, a YAML-driven technical ingestion tool."
 license = "MIT"
@@ -17,7 +17,7 @@ path = "src/main.rs"
 
 [dependencies]
 clap = { version = "4", features = ["derive"] }
-floe-core = { path = "../floe-core", version = "0.3.0" }
+floe-core = { path = "../floe-core", version = "0.3.1" }
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 
diff --git a/crates/floe-core/Cargo.toml b/crates/floe-core/Cargo.toml
index e5d7a7f..3253675 100644
--- a/crates/floe-core/Cargo.toml
+++ b/crates/floe-core/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "floe-core"
-version = "0.3.0"
+version = "0.3.1"
 edition = "2021"
 description = "Core library for Floe, a YAML-driven technical ingestion tool."
 license = "MIT"