From 1432691f8cda85f5f81c68cf0c3b81bd7bc3a947 Mon Sep 17 00:00:00 2001 From: "Edgar Y. Walker" <> Date: Thu, 12 Nov 2026 14:09:56 -0800 Subject: [PATCH 01/12] docs(release): prepare v0.3.0 changelog, upgrade notes and checklist (ITL-873) Assemble the changelog fragments into [0.3.0], add the SemiJoin fragment (ITL-847), add the upgrade notes, the v0.3 release checklist and the data context freeze step. Co-Authored-By: Claude Sonnet 5.5 --- CHANGELOG.md | 898 ++++++++++++++++++ README.md | 5 +- RELEASING.md | 13 +- changelog.d/ITL-864.md | 16 - changelog.d/ITL-892.md | 16 - changelog.d/ITL-895.md | 36 - changelog.d/ITL-896.md | 12 - changelog.d/ITL-904.md | 48 - changelog.d/ITL-905.md | 41 - changelog.d/ITL-910.md | 38 - changelog.d/ITL-919.md | 52 - changelog.d/ITL-926.md | 55 -- changelog.d/ITL-935.md | 44 - changelog.d/ITL-936.md | 27 - changelog.d/ITL-939.md | 12 - changelog.d/ITL-942.md | 35 - changelog.d/ITL-943.md | 21 - changelog.d/ITL-944.md | 139 --- changelog.d/ITL-945.md | 61 -- changelog.d/ITL-953.md | 40 - changelog.d/ITL-954.md | 35 - changelog.d/ITL-955.md | 32 - changelog.d/ITL-957.md | 42 - changelog.d/ITL-972.md | 98 -- changelog.d/ITL-975.md | 13 - docs/index.md | 5 +- .../2026-11-12-v0.3-release-checklist.md | 107 +++ 27 files changed, 1022 insertions(+), 919 deletions(-) delete mode 100644 changelog.d/ITL-864.md delete mode 100644 changelog.d/ITL-892.md delete mode 100644 changelog.d/ITL-895.md delete mode 100644 changelog.d/ITL-896.md delete mode 100644 changelog.d/ITL-904.md delete mode 100644 changelog.d/ITL-905.md delete mode 100644 changelog.d/ITL-910.md delete mode 100644 changelog.d/ITL-919.md delete mode 100644 changelog.d/ITL-926.md delete mode 100644 changelog.d/ITL-935.md delete mode 100644 changelog.d/ITL-936.md delete mode 100644 changelog.d/ITL-939.md delete mode 100644 changelog.d/ITL-942.md delete mode 100644 changelog.d/ITL-943.md delete mode 100644 changelog.d/ITL-944.md delete mode 100644 changelog.d/ITL-945.md delete mode 100644 changelog.d/ITL-953.md delete mode 100644 changelog.d/ITL-954.md delete mode 100644 changelog.d/ITL-955.md delete mode 100644 changelog.d/ITL-957.md delete mode 100644 changelog.d/ITL-972.md delete mode 100644 changelog.d/ITL-975.md create mode 100644 superpowers/plans/2026-11-12-v0.3-release-checklist.md diff --git a/CHANGELOG.md b/CHANGELOG.md index 878a6247b..2e3f57a2b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,30 @@ ### Breaking changes and migration +#### Upgrading from 0.2.0: what a v0.2 user does + +**v0.3 reads no table written by v0.2, and it moves every stored hash.** Nothing is migrated, +repaired or deleted: v0.2 tables stay as v0.2 left them and stay readable with v0.2. The first +v0.3 run computes every input again into new tables. A migration tool is planned (ITL-889, +ITL-913, ITL-914). The sections below give the detail; this table says what to do. + +| Change | What you do | +|---|---| +| Every table has a new path and a `__data_context` column; data context `std:v1:default`; layouts `pdb_v2`, `rdb_v2`, `tdb_v2`, `odb_v1`, `sdb_v1` (ITL-944) | Nothing to run. Expect a full recompute. Drop the old tables by hand when you no longer need them with v0.2. Remove `ignore_schema`, `orcapod.migrations` and `orcapod migrate` from your code; they are gone. | +| A node with side effects (side-effect pod, or a function pod taking the invocation context) finds a v0.2 log | It raises `SideEffectLogDataContextError` before delivering anything. Keep using v0.2 for that node, or accept that a fresh store repeats every side effect. | +| Every Arrow-derived hash changed: starfix hash format 2 (ITL-910), wrong hashes fixed (ITL-942), dict and set values hash in any order (ITL-905), function signatures and defaults hash as structures (ITL-953) | Nothing: stored v0.2 results are not looked up. Code that compares or stores hashes of v0.2 must recompute them. | +| Hash labels are `_v1` (`semantic_v1`, `arrow_v1`, `directory_v1`, `ndarray_v1`, `polars_expr_v1`), and a hash inside a name is a bare hex digest (ITL-945) | Change anything that parses a stored hash column or a path component. | +| Logical type identifiers carry versioned metadata (ITL-935); arrays are stored in the new `orcapod.ndarray` format (ITL-888) | Re-run pods that handle arrays. Anything that read the old `.npy` storage must read the new format. | +| Default source ids are `: