beads/scripts/migration-test/lib/versions.sh
Julian Knutsen b3d17caa6d Merge release/1.3.0 into main (post-tag forward-port)
Forward-ports the 38 commits that shipped on release/1.3.0 (tagged v1.3.0 at
f45b249ce) into main, as RELEASING.md mandates after a tag. None of them had
ever been forward-ported. Recorded as a merge so main becomes a superset of
the release branch and the lineage is in the history.

Migration ordinal collision (the reason this needed a human-shaped merge):
both branches independently claimed clone-local ignored slot 0026 under
different filenames, so git merged both in with no conflict and left the
series with two migrations at ordinal 26 — a single-integer cursor cannot
address that, and migrationSource.list() panics on it.

Main's ignored/0026_add_wisps_current_revision is renumbered to 0027.
Release's 0026_dep_rekey_dedup_marker is in the shipped v1.3.0 tag, so field
stores have already recorded it at 26 and it can never move; main's twin has
never shipped in any release, so it is the one that is free to move. 0027 was
unused in the ignored series (both sides topped out at 26).

This trips check-migration-hygiene.sh Check C (frozen migrations), which has
no exemption mechanism. That is expected and accepted: breaking the collision
requires a rename, and the ignored series' cursor table is itself dolt-ignored,
so its content hashes are clone-local and never participate in the cross-clone
ContentHashSkew comparison that Check C exists to protect. Main's 0067 body is
deliberately NOT edited for the same reason in reverse — it is main-plane and
its hash IS compared across clones.

Conflicts resolved:

  CHANGELOG.md                       release's finalized [1.3.0] section kept
                                     byte-identical; main's two unreleased
                                     entries (#6023, #5859) moved up under
                                     [Unreleased] where they belong
  cmd/bd/init_safety.go              union — release's added paragraph is
  cmd/bd/init_safety_help.go         accurate against the merged code (three
                                     exit-12 sources, incl. init.go:3147)
  internal/storage/uow/dolt_sql_provider.go
                                     kept main's newProvider refactor AND
                                     release's readOnly field/assertion;
                                     newProvider gained readOnly: opts.readOnly
                                     so release's read-through-refused-migration
                                     behavior survives main's refactor
  .github/workflows/main.yml         single -timeout=30m per release's #6091
  scripts/ci_workflow_test.go        design (flag on the invocation, not in
                                     matrix.test-flags); the shadowed 25m in
                                     matrix.test-flags removed
  scripts/migration-test/lib/versions.sh
                                     union — main's darwin/arm64 corpus plus
                                     release's v1.2.2 linux/amd64 entry
  integrations/beads-mcp/uv.lock     ruff 0.16.5 (release, newer); block is
                                     internally consistent, uv lock --check ok
  default.nix                        vendorHash left at main's value and is
                                     KNOWN STALE — see below

Version stamp lands at 1.3.0 (main had been sitting at the previously-released
1.2.2, this project's between-releases pattern). check-versions.sh: 24/24.

Known follow-up: default.nix vendorHash. The merged go.mod/go.sum is a genuine
union (release's kin-openapi/oapi-codegen bumps + main's newer Dolt stack) and
matches neither side, so neither recorded hash is correct. It must be
regenerated with scripts/update-nix-vendorhash.sh. The repo's automatic fixer
(update-vendor-hash.yml) is dependabot-only and will not run on this PR.
2026-09-15 22:09:13 +00:00

162 lines
8.2 KiB
Bash
Executable file

#!/bin/bash
# Storage era definitions and upgrade path matrix.
if ((BASH_VERSINFO[0] < 4)); then
printf 'versions.sh: this migration-test harness needs bash >= 4 for associative arrays (found %s).\n' "$BASH_VERSION" >&2
printf 'versions.sh: macOS ships bash 3.2 by default; install a newer bash (e.g. "brew install bash") and invoke this script through it.\n' >&2
return 1 2>/dev/null || exit 1
fi
# The explicit export/import bridges for reviewed classic SQLite layouts. They
# are not in-place schema migrations: each SQLite source remains a rollback copy.
readonly CLASSIC_SQLITE_VERSION="v0.49.6"
readonly CONFIGURED_SQLITE_VERSION="v0.50.3"
readonly PRE_CANONICAL_SQLITE_VERSION="v0.17.0"
# This source-tag-qualified lane deliberately has no release asset.
readonly SOURCE_TAG_SQLITE_VERSION="v0.9.1"
readonly SOURCE_TAG_SQLITE_MODULE="github.com/steveyegge/beads"
readonly SOURCE_TAG_SQLITE_MODULE_SUM="h1:2KRCRCEtHvfMzmhYrpZzWl2rk2Y1Wq9p2awTdQIK9yY="
readonly SOURCE_TAG_SQLITE_GOMOD_SUM="h1:CNV215xONrxBs18j3BXx/xvl1qyCO2SeQRqiTN213Vg="
readonly SOURCE_TAG_SQLITE_COMMIT="e3c8554fa2c3e4b9caf7e296e9c8abbe24211a72"
readonly SOURCE_TAG_SQLITE_REF="refs/tags/v0.9.1"
readonly SOURCE_TAG_SQLITE_GO_TOOLCHAIN="go1.25.0"
# Representative, public release binaries for the historical-Dolt E2E test.
# These are deliberately a small, reviewed compatibility corpus rather than
# a discovery mechanism or an exhaustive tag matrix.
declare -ar HISTORICAL_DOLT_VERSIONS=(
"v0.55.4"
"v0.56.1"
"v0.57.0"
"v0.62.0"
)
# Reviewed direct embedded-Dolt sources. Unlike the server corpus, their own
# embedded data is opened and migrated in place by the candidate.
declare -ar EMBEDDED_DOLT_VERSIONS=(
"v0.63.3"
"v1.0.0"
"v1.0.1"
"v1.1.0"
"v1.1.2"
"v1.2.2"
)
# Embedded-Dolt sources whose wisp plane is close enough to the 1.3.0 input
# regimes to be worth seeding: v1.0.1 is the legacy single-target
# wisp_dependencies shape with no ignored-migration cursor, while v1.1.0,
# v1.1.2 and v1.2.2 are the post-split shape with the cursor parked at
# ignored-0011. Both regimes are replayed over populated rows by the candidate's
# main 0054-0066 + ignored 0012-0025 chain. v1.2.2 is the v1.1.2 tree re-tagged
# by the recovery release, so it adds no new regime — it is here because it is
# the tag people in the field actually upgrade from. Also gates the external
# Dolt oracle download in migration-test.yml.
declare -ar WISP_PLANE_VERSIONS=(
"v1.0.1"
"v1.1.0"
"v1.1.2"
"v1.2.2"
)
# The test server is an external compatibility fixture, not the runner's
# ambient Dolt installation. CI downloads this exact linux/amd64 archive.
readonly DOLT_TEST_RUNTIME_VERSION="v2.1.8"
readonly DOLT_TEST_RUNTIME_SHA256="f66318f08ed66e409fc39363ae0fff8ce6fbf6dba9f5bac632b91527b9632a74"
# Classic SQLite files that must be retained byte-for-byte for rollback before
# the manual bridge removes the active copies.
declare -ar CLASSIC_SQLITE_ROLLBACK_FILES=(
"beads.db"
"beads.db-wal"
"beads.db-shm"
"metadata.json"
"config.json"
"config.yaml"
"issues.jsonl"
)
# Legacy Dolt-server metadata that must be retained with the dolt/ directory
# before the manual bridge clears the active source.
declare -ar LEGACY_DOLT_ROLLBACK_FILES=(
"metadata.json"
"config.json"
"config.yaml"
"issues.jsonl"
)
# Release artifacts and expected qualification outcomes for strict CI lanes.
# Strict entries are deliberately explicit: adding a historical lane requires
# reviewing the official asset, checksum, source capabilities, and supported
# migration outcome instead of silently discovering them at runtime.
declare -Ar STRICT_RELEASE_ASSETS=(
["v0.17.0|linux|amd64"]="beads_0.17.0_linux_amd64.tar.gz"
["v0.49.6|linux|amd64"]="beads_0.49.6_linux_amd64.tar.gz"
["v0.50.3|linux|amd64"]="beads_0.50.3_linux_amd64.tar.gz"
["v0.55.4|linux|amd64"]="beads_0.55.4_linux_amd64.tar.gz"
["v0.56.1|linux|amd64"]="beads_0.56.1_linux_amd64.tar.gz"
["v0.57.0|linux|amd64"]="beads_0.57.0_linux_amd64.tar.gz"
["v0.62.0|linux|amd64"]="beads_0.62.0_linux_amd64.tar.gz"
["v0.63.3|linux|amd64"]="beads_0.63.3_linux_amd64.tar.gz"
["v1.0.0|linux|amd64"]="beads_1.0.0_linux_amd64.tar.gz"
["v1.0.1|linux|amd64"]="beads_1.0.1_linux_amd64.tar.gz"
["v1.1.0|linux|amd64"]="beads_1.1.0_linux_amd64.tar.gz"
["v1.1.2|linux|amd64"]="beads_1.1.2_linux_amd64.tar.gz"
["v1.2.2|linux|amd64"]="beads_1.2.2_linux_amd64.tar.gz"
# darwin/arm64: reviewed 2026-08-29 (ga-9sghx) so the corpus can run
# natively on Apple Silicon. Every asset below was confirmed to exist via
# `gh release view <version> -R gastownhall/beads`, and every checksum was
# taken from that release's own goreleaser-published checksums.txt (the
# same provenance as the linux|amd64 entries above).
["v0.17.0|darwin|arm64"]="beads_0.17.0_darwin_arm64.tar.gz"
["v0.49.6|darwin|arm64"]="beads_0.49.6_darwin_arm64.tar.gz"
["v0.50.3|darwin|arm64"]="beads_0.50.3_darwin_arm64.tar.gz"
["v0.55.4|darwin|arm64"]="beads_0.55.4_darwin_arm64.tar.gz"
["v0.56.1|darwin|arm64"]="beads_0.56.1_darwin_arm64.tar.gz"
["v0.57.0|darwin|arm64"]="beads_0.57.0_darwin_arm64.tar.gz"
["v0.62.0|darwin|arm64"]="beads_0.62.0_darwin_arm64.tar.gz"
["v0.63.3|darwin|arm64"]="beads_0.63.3_darwin_arm64.tar.gz"
["v1.0.0|darwin|arm64"]="beads_1.0.0_darwin_arm64.tar.gz"
["v1.0.1|darwin|arm64"]="beads_1.0.1_darwin_arm64.tar.gz"
["v1.1.0|darwin|arm64"]="beads_1.1.0_darwin_arm64.tar.gz"
["v1.1.2|darwin|arm64"]="beads_1.1.2_darwin_arm64.tar.gz"
)
declare -Ar STRICT_RELEASE_SHA256=(
["v0.17.0|linux|amd64"]="d4d08617a324c85b45c9628bc519d659a9ff9c7c37da67aa48727e0af7f19a75"
["v0.49.6|linux|amd64"]="8546dc9a47e11dc31ac2bc9a0224a9c690975e91850932cbb62623053fbb7db8"
["v0.50.3|linux|amd64"]="e94b09e0b6a9324bbc0e81ea36bccaaa42172a926bfedfb389e9a26dedb63184"
["v0.55.4|linux|amd64"]="e0fa25456dd82890230eef17653448a0bf995104c78864be91c5ed84426a5f49"
["v0.56.1|linux|amd64"]="4f9f6cc44465a11613ff529009901eaaf841c6b1f91c15e002b0ecda2015a15c"
["v0.57.0|linux|amd64"]="f8629d5627bed7d25f06f92334addc171d679f9aed9d08c5d42a9684205dc04b"
["v0.62.0|linux|amd64"]="4cca7265b22e5c3ca8d62ab0b9752bec31f68b7f5fa636282a4c7e5454c35535"
["v0.63.3|linux|amd64"]="5f4efd2e010209b3f381dbcd783b2a3a652f50ea72f40ef04c8ba434d408bf9e"
["v1.0.0|linux|amd64"]="7057db1e92428fcf5c08d5dc6b07ead57e588b262cba78b9a26893d55bd29fdb"
["v1.0.1|linux|amd64"]="1d2364d5d7083a4634a9e734ca87822fb79c2b6625988f9f791e3376313b1b77"
["v1.1.0|linux|amd64"]="b0f3dd607c3fb989ee08d0a6854fba80d0402971eb108f9af6170bc14d491a34"
["v1.1.2|linux|amd64"]="a72d71ed374955dc9f83a0f90b54bd7b6a0016709dd1676ae2e368651ed401c2"
["v1.2.2|linux|amd64"]="8140098a51d3b81d5548d1c5e6db1a2d9930e5d141efe2a4bff7d079c4d321e8"
# darwin/arm64 — see provenance note on STRICT_RELEASE_ASSETS above.
["v0.17.0|darwin|arm64"]="41479fabf76ff76912096bf2e9c1988a9b0d0dd673c7e693342f711770f6d763"
["v0.49.6|darwin|arm64"]="007dacd919eeac48a3a0ecb6aad305ef04e903de02c43a8163d2fd6a63d9ab7d"
["v0.50.3|darwin|arm64"]="26c15b93d82be45c3fa9b6318ffee9a6ae89841ba7ec4ad5c8db6fe6e42d3d3a"
["v0.55.4|darwin|arm64"]="18afdf4f562323a71687b2f7ed95c27750aee8d361b176a4a79caf176f00c0b9"
["v0.56.1|darwin|arm64"]="aa8a4309de2ab8c27a90c03b652cedc53a45880a5c94cd65881006da3c2f0812"
["v0.57.0|darwin|arm64"]="fbbcbdff64da29f72fbe939d4cc285305d73e830889919d182c4c6826a338ced"
["v0.62.0|darwin|arm64"]="4f441c616240c7063a2257ac26138d06eae060a961f029c81855928eae6ae1c0"
["v0.63.3|darwin|arm64"]="2b3ab41dd74a3c2a79bc47dd0b36c0a63a2c5d76f1e3081db5288d294124f245"
["v1.0.0|darwin|arm64"]="b8763b428e6b68550eb2b2505483797794b49ae497a2e265ed3c60f0f0a0bcd2"
["v1.0.1|darwin|arm64"]="f9d5e878fbee8a7051289743e36e52b0b17f1058587170afab7f2d2a30f43199"
["v1.1.0|darwin|arm64"]="c42e24d83b258f7ba9f52a6d2d5f6b055869dfe7807165055988b12e7ea8c564"
["v1.1.2|darwin|arm64"]="9b0137a83a2afd343e2abd2a506be72ea032721000f76669c2cf81729e78501d"
)
strict_release_asset() {
local value="${STRICT_RELEASE_ASSETS["$1|$2|$3"]:-}"
[ -n "$value" ] || return 1
printf '%s\n' "$value"
}
strict_release_sha256() {
local value="${STRICT_RELEASE_SHA256["$1|$2|$3"]:-}"
[ -n "$value" ] || return 1
printf '%s\n' "$value"
}