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.
162 lines
8.2 KiB
Bash
Executable file
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"
|
|
}
|