beads/scripts
Eddie the Engineer 2068dbee97 fix(schema): replace compaction_snapshots' descending index with an ascending twin (0071)
Review fixes for #7646, iterations 1, 2 and 3. This replaces the
unpushed iteration-1 commit 89f67d6bbe. The nine contributor commits are
rebased onto main at ce70b261c5, and the migration moves from 0070 to
0071 because #6943 landed its participation_generation migration at 0070
first. With two 0070s, the schema test package does not compile, the
hygiene check fails, and every bd command that opens a store panics with
"schema: duplicate migration version 70".

The Dolt 2.4.1 driver stores the created_at DESC that migration 0010
declares on idx_comp_snap_issue as descending (dolthub/dolt#11746), so
every database it creates was unreadable by Dolt older than 2.3.3:
released bd (v1.3.x links driver v2.2.0) failed on open with "table has
unknown fields", which BD_IGNORE_SCHEMA_SKEW=1 does not get past.
Migration 0071 adds idx_comp_snap_issue_asc (issue_id,
compaction_level, created_at) and then drops idx_comp_snap_issue, each
step guarded on INFORMATION_SCHEMA.STATISTICS the way 0042 is.
fk_comp_snap_issue keeps ON DELETE/ON UPDATE CASCADE. The descending
order never served a query.

Measured 2026-10-18 on a database bd init built from this tree
(schema_migrations at 71, participation_generation present, no
descending column at the root): dolt 2.1.8 and 2.2.0 read, write, push,
clone and pull it, and the installed v1.3.0 bd (driver v2.2.0) stops at
its structured "database is at v71, binary knows up to v69" refusal,
which BD_IGNORE_SCHEMA_SKEW=1 gets past. With 0071 reverted,
information_schema queries and writes fail with "table has unknown
fields" (push and clone still copy the chunks), on 2.1.8 an UPDATE or
DELETE on issues reports a fk_comp_snap_issue violation, 2.2.0's pull
fails, and the v1.3.0 bd fails with the engine error that
BD_IGNORE_SCHEMA_SKEW=1 does not get past.

History keeps the descending column: bd init commits each migration
separately, so the commits from before 0071 still hold it. On 2.1.8 and
2.2.0, reading compaction_snapshots at one of them (AS OF,
dolt_history_compaction_snapshots, dolt_diff_compaction_snapshots)
fails, and so does any dolt diff with one as an endpoint, even a diff
limited to issues. issues AS OF, dolt_history_issues and
dolt_diff_issues work. The up.sql header, the CHANGELOG and
docs/architecture/dolt.md say so.

Migrations take slots in landing order, and versions must stay
gap-free (TestAllMigrationsSQLAppliesThroughDoltCLIAndRecordsLatestVersion).
#6661 also numbers a migration 0071; whichever lands second renumbers.

Tests: TestLatestVersionIncludesMigration0071 is the slot pin, and
main's TestLatestVersionIncludesMigration0070 is deleted, as each
earlier pin was when the next migration landed. A pure-Go test checks
the frozen text and the down file, and a dolt CLI test checks the
bundle leaves no descending column. An embedded test covers the upgrade
from v69 through 0070 and 0071, a replay, the foreign key's cascade,
resume after the add, a store without the table, and a fresh store.
cli_prepared_ddl.go's inventory justifies the prepared ADD/DROP INDEX,
measured to execute through the CLI batch path on 2.1.8 and 2.4.1.

The example modules replace github.com/steveyegge/beads with the repo
root, so they have to follow its dependency bump. On the iteration-2
head 72f5a6794e, scripts/build-examples.sh failed both with "updates
to go.mod needed". go mod tidy in examples/library-usage and
examples/bd-example-extension-go moves them to the root's versions
(driver v2.4.1, dolthub/file-locks v0.1.2 and the go-deps group).
Every requirement they share with the root go.mod now matches it
except golang.org/x/exp, which both already pinned to a newer version
on main. The script now prints "2 example module(s) type-check
cleanly".

Minor and nit findings:
- The proxied-server old-version warning scopes each reason to the
  releases it covers, without naming a schema version: the
  CALL DOLT_RESET('--hard') regression measured on 2.3.0 and 2.3.1
  (2.3.2 through 2.4.0 unmeasured, 2.4.1 measured clean), the join
  mis-plan before 2.4.0, and "table has unknown fields" before 2.3.3.
  A 2.4.0 user now reads why 2.4.1 is still recommended.
  TestWarningMessage pins all three; dropping the DOLT_RESET clause
  fails it.
- scripts/ci/install-dolt.sh no longer says 2.4.1-engine storage is
  unwritable by 2.2.0. It names the join bug and the split between the
  current root, which 2.1.8 and 2.2.0 read and write, and the commits
  from before 0071.
- scripts/test-git-remote.sh keeps its dolt >= 2.2.0 floor, backed by
  a 2.2.0 run of its write, push, clone and pull steps.
- The dated cross-version measurements live in docs/architecture/dolt.md;
  policy.go and troubleshooting.md point there.
- The CHANGELOG scopes the fk_comp_snap_issue violation to 2.1.8.
- The localdoltserver port comment covers 2.4.1 as well as 2.2.0; both
  print "Port N already in use." on a held port (measured).
- TestEmbeddedFirstMintOnEmptyHistoryIsRevisionOne pins that revisions
  count per issue.
- docs/architecture/dolt.md says 2.4.1 is the only release after 2.3.1
  measured for the DOLT_RESET regression and that 2.3.2, 2.3.3 and
  2.4.0 have not been. It had said no release after 2.3.1 was, right
  under the 2.4.1 0 / 250 row.
- cli_migrations.go puts the parity oracle's green run against the
  then-pinned 2.2.0 sql-server in the past tense. Probed 2026-10-18, a
  prepared ADD COLUMN vanishes on the 2.2.0 CLI and lands on 2.4.1, so
  on the 2.4.1 pin the oracle cannot catch a dropped override; the
  comment names the two binary-free tests that still can.

Agent-Signature: claude-code-claude-opus-5-5-unknown-reasoning on behalf of Julian Knutsen
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-18 16:25:40 +00:00
..
bench-ready-indexes ci(bazel): split //scripts:scripts_test by what it reads; partition //:repo_files (#7414) 2026-10-09 05:13:07 +00:00
check-versions ci(bazel): split //scripts:scripts_test by what it reads; partition //:repo_files (#7414) 2026-10-09 05:13:07 +00:00
checkworkflowtags ci(bazel): split //scripts:scripts_test by what it reads; partition //:repo_files (#7414) 2026-10-09 05:13:07 +00:00
ci fix(schema): replace compaction_snapshots' descending index with an ascending twin (0071) 2026-10-18 16:25:40 +00:00
gitattributespolicy ci(bazel): split //scripts:scripts_test by what it reads; partition //:repo_files (#7414) 2026-10-09 05:13:07 +00:00
hooks feat: Add post-push hook to auto-install bd CLI after git push 2025-10-14 17:23:43 -07:00
internal/testbash ci(bazel): split //scripts:scripts_test by what it reads; partition //:repo_files (#7414) 2026-10-09 05:13:07 +00:00
migration-test ci(bazel): split //scripts:scripts_test by what it reads; partition //:repo_files (#7414) 2026-10-09 05:13:07 +00:00
pr-lint ci(bazel): split //scripts:scripts_test by what it reads; partition //:repo_files (#7414) 2026-10-09 05:13:07 +00:00
prlintmake ci(bazel): split //scripts:scripts_test by what it reads; partition //:repo_files (#7414) 2026-10-09 05:13:07 +00:00
repochecks test: ban ungated host go/gofmt execs under Bazel; pin compact_gc_fixture pure/norace (#7485) 2026-10-10 23:51:34 +00:00
repro-be-1he-slow-path perf(dolt): eliminate 12s slow path on bd commands when .local_version is stale (#3710) 2026-07-24 00:53:06 -07:00
repro-dolt-hang ci(bazel): split //scripts:scripts_test by what it reads; partition //:repo_files (#7414) 2026-10-09 05:13:07 +00:00
repro-dolt-prod-timeouts ci(bazel): split //scripts:scripts_test by what it reads; partition //:repo_files (#7414) 2026-10-09 05:13:07 +00:00
workflowtags ci(bazel): split //scripts:scripts_test by what it reads; partition //:repo_files (#7414) 2026-10-09 05:13:07 +00:00
bazel-autofix-push.sh ci: autofix pushes with the gastownhall-autofix App token (no more approve-and-run) (#7215) 2026-10-04 21:27:06 -07:00
bazel_autofix_push_test.go ci(bazel): split //scripts:scripts_test by what it reads; partition //:repo_files (#7414) 2026-10-09 05:13:07 +00:00
bazel_cache_mode_test.go ci(bazel): dolt-int gates server-storage + cmd-dolt in mode remote (item 5 A2) (#7535) 2026-10-13 09:17:54 +00:00
bazel_dolt_int_test.go test(bazel): pin the item-5 one-wave rule for dolt-race/dolt-int budgets (#7545) 2026-10-13 15:43:37 +00:00
bazel_dolt_race_test.go test(bazel): pin the item-5 one-wave rule for dolt-race/dolt-int budgets (#7545) 2026-10-13 15:43:37 +00:00
bazel_farm_workflow_test.go ci(bazel): remote repo contents cache: main-push seed, lane readers, nightly verify (#7453) 2026-10-10 02:50:26 +00:00
bazel_fork_mode_test.go ci(bazel): zstd for the anonymous fork cache when it advertises it (rbe-west E4) (#7202) 2026-10-04 12:26:54 -07:00
bazel_go_repository_tools_test.go ci(bazel): serve gazelle's go_repository tools from the repository cache (#7417) 2026-10-09 07:57:01 +00:00
bazel_hermetic_cc_test.go fix(build): pair Darwin SDKs with the native Apple linker (#7460) 2026-10-11 03:51:25 +00:00
bazel_invocations_test.go ci: F5 S2 Variant A — nogo ownership for the integration configuration group (#7486) 2026-10-10 23:19:16 +00:00
bazel_policy_test.go ci(bazel): split //scripts:scripts_test by what it reads; partition //:repo_files (#7414) 2026-10-09 05:13:07 +00:00
bazel_rbe_prewarm_test.go fix(ci): rbe pre-warm survives a failed gh run list under bash -e, and clamps an over-long worker count (#7162) (#7163) 2026-10-06 22:35:02 +00:00
bazel_rrc_test.go ci(bazel): dolt-int gates server-storage + cmd-dolt in mode remote (item 5 A2) (#7535) 2026-10-13 09:17:54 +00:00
bazel_skip_allowlist_test.go ci(bazel): split //scripts:scripts_test by what it reads; partition //:repo_files (#7414) 2026-10-09 05:13:07 +00:00
build-examples.sh fix(examples): tidy both example modules and build them in CI (#5229) 2026-08-12 21:16:27 -07:00
BUILD.bazel fix(scripts): update-nix-vendorhash no longer reports a build failure as success (#7504) 2026-10-14 22:18:15 +00:00
bump-version.sh refactor: replace bump-version.sh with molecule pointer 2026-01-14 21:53:06 -08:00
check-build-tags.sh fix(ci): require direct workflow build tags (#5679) 2026-10-01 01:24:03 -07:00
check-cli-docs-drift.sh docs(pipeline): pin the CLI docs to the released bd; repair main's broken CLI reference (#4876) 2026-07-17 18:03:28 -07:00
check-doc-flags.sh docs(agents): contributor-only agent instructions and documented-issue intake (#7223) 2026-10-05 08:43:53 +00:00
check-doc-freshness.sh fix(preflight): share checkout lint authority (#5780) 2026-09-30 22:41:55 -07:00
check-go-install-guidance.sh fix(install): use declared module path for go fallback (#4215) 2026-05-27 21:48:24 -07:00
check-migration-hygiene.sh ci(bazel): run pr.yml's repository guards as Bazel tests (#7329) 2026-10-07 00:59:18 +00:00
check-testing-short.sh fix(storage): a parent-child edge propagates only the parent's exogenous blockedness (#6506) (#6602) 2026-10-08 08:31:34 +00:00
check-versions.sh fix: make release-version checks shell-free (#5614) 2026-10-01 07:46:37 -07:00
check-winget-portable-alias.sh ci(bazel): run the scripts and source-walking tests remotely; retire their go test legs (#7320) 2026-10-06 22:20:16 +00:00
check-workapi-frontend-boundary.sh ci(bazel): retire main.yml's Linux jobs, nightly's go test jobs and ci-measurements (#7354) 2026-10-07 10:06:59 +00:00
check_build_tags_test.go fix(ci): require direct workflow build tags (#5679) 2026-10-01 01:24:03 -07:00
check_doc_freshness_test.go ci(bazel): nogo replaces go vet and golangci-lint (ga-96smfk.18) (#7341) 2026-10-07 05:17:22 +00:00
check_release_cross_compile_test.go ci(bazel): cross-compile every release target with Bazel, retire the go build job (#7332) 2026-10-07 03:18:37 +00:00
check_testing_short_test.go ci(bazel): split //scripts:scripts_test by what it reads; partition //:repo_files (#7414) 2026-10-09 05:13:07 +00:00
check_winget_portable_alias_test.go ci(bazel): split //scripts:scripts_test by what it reads; partition //:repo_files (#7414) 2026-10-09 05:13:07 +00:00
ci_actions_policy_test.go ci: pin the Actions allow-list for the selected-and-SHA-pinned policy (R3) (#7175) 2026-10-04 01:03:40 -07:00
ci_analytics_extract_test.go fix(bazel): re-vendor the BEP test-timing clamp from gascity (extractor 1.1.1) (#7477) 2026-10-10 16:20:37 +00:00
ci_analytics_workflow_test.go ci(bazel): dolt-int gates server-storage + cmd-dolt in mode remote (item 5 A2) (#7535) 2026-10-13 09:17:54 +00:00
ci_blacksmith_runner_test.go ci(bazel): dolt-int gates server-storage + cmd-dolt in mode remote (item 5 A2) (#7535) 2026-10-13 09:17:54 +00:00
ci_f7b_review_test.go ci(bazel): run every Windows/macOS job on Blacksmith; retire the Linux preflight leg and the cross-compiled Windows pair (#7355) 2026-10-07 10:41:14 +00:00
ci_f7c_advisory_test.go ci(bazel): run the hook-timeout-backends check under Bazel; test-nix stops running tests (#7357) 2026-10-07 11:05:39 +00:00
ci_merge_queue_test.go ci(bazel): dolt-int gates server-storage + cmd-dolt in mode remote (item 5 A2) (#7535) 2026-10-13 09:17:54 +00:00
ci_workflow_apt_get_timeout_test.go ci(bazel): run every Windows/macOS job on Blacksmith; retire the Linux preflight leg and the cross-compiled Windows pair (#7355) 2026-10-07 10:41:14 +00:00
ci_workflow_core_test.go ci: F5 S2 Variant A — nogo ownership for the integration configuration group (#7486) 2026-10-10 23:19:16 +00:00
ci_workflow_test.go fix(scripts): update-nix-vendorhash no longer reports a build failure as success (#7504) 2026-10-14 22:18:15 +00:00
clean-test-tmp.sh test(cmd/bd): route sync.Once test temp dirs through TestMain cleanup (#4108) 2026-05-22 16:48:22 -07:00
complexity_script_test.go test(bazel): fully green //..., tag taxonomy + docker lane, sharding, test sandbox ceiling (#6871) 2026-09-27 20:19:38 -07:00
conformance.sh feat(httpclient): OSS HTTP client store and roles + a served http conformance leg (contributed from bd-enterprise under MIT) (#7247) 2026-10-08 12:01:09 +00:00
conformance_script_test.go ci(bazel): pin httpclient_served_test's slow tests to shards (16 -> 26 shards) (#7443) 2026-10-09 22:11:43 +00:00
cross-version-smoke-test.sh docs: update user-facing URLs from steveyegge/beads to gastownhall/beads 2026-04-24 08:17:42 -07:00
docs-autofix-push.sh ci: autofix pushes with the gastownhall-autofix App token (no more approve-and-run) (#7215) 2026-10-04 21:27:06 -07:00
docs.md Validate doc freshness max age (#5524) (#5606) 2026-08-10 21:02:23 -07:00
embedded_shard_count_test.go fix(bazel): remove host-go dep from compact GC test; drop frozen shard blocks (#7478) 2026-10-10 19:24:21 +00:00
gen-winres.sh chore: re-land v1.1.0-rc.1 release prep (#4486) 2026-06-25 20:10:18 -07:00
generate-cli-docs.sh ci(bazel): retire main.yml's Linux jobs, nightly's go test jobs and ci-measurements (#7354) 2026-10-07 10:06:59 +00:00
generate-newsletter.py Newsletter dropped every commit made before the hour it ran (#6491) 2026-09-26 18:56:29 -07:00
generate-newsletter_README.md Newsletter dropped every commit made before the hour it ran (#6491) 2026-09-26 18:56:29 -07:00
gh-body-lint docs: align agent maintainer conventions (#4237) 2026-06-20 20:44:08 -07:00
host_tool_exec_policy_test.go fix(ci-policy): close M19/M21 scanner gaps from #7491 review (#7492) 2026-10-11 01:53:00 +00:00
host_tool_shell_policy_test.go fix(ci-policy): close review leftovers from #7485/#7486 (#7491) 2026-10-11 01:22:48 +00:00
host_tools_test.go ci(bazel): split //scripts:scripts_test by what it reads; partition //:repo_files (#7414) 2026-10-09 05:13:07 +00:00
install-hooks.sh feat: Add post-push hook to auto-install bd CLI after git push 2025-10-14 17:23:43 -07:00
install.sh docs(ci): add Mintlify preview, docsync guard, and broken-links workflow 2026-07-12 10:37:07 -07:00
install_dolt_test.go build(dolt): raise the Dolt CLI, container and Bazel pins to 2.4.1 2026-10-18 14:05:10 +00:00
makefile_bazel_primary_test.go docs(bazel): make bazel test the primary build and test path (ga-96smfk.23) (#7348) 2026-10-07 07:46:02 +00:00
managed_local_lane_test.go ci(bazel): run the managed-local proxied lifecycle lane under Bazel; retire proxied-local-smoke.yml (#7326) 2026-10-07 00:59:14 +00:00
migrate-jsonl-to-dolt.sh feat: add JSONL-to-Dolt migration script (GH#2276) 2026-03-02 22:05:38 -08:00
migrate-legacy-to-current.sh Guard and qualify historical upgrades to v1.2 (#4907) 2026-08-06 18:45:04 -07:00
migration_corpus_bazel_test.go ci(bazel): run the historical-upgrade corpus under Bazel; retire migration-test.yml (#7330) 2026-10-07 02:16:11 +00:00
mutation-equivalence.sh Fix a SIGPIPE in the mutation harness's worktree guard (#5434) 2026-08-08 08:28:08 -07:00
nogo_integration_scan_test.go ci: F5 S2 Variant A — nogo ownership for the integration configuration group (#7486) 2026-10-10 23:19:16 +00:00
nogo_integration_step_script_test.go ci: F5 S2 Variant A — nogo ownership for the integration configuration group (#7486) 2026-10-10 23:19:16 +00:00
nogo_lint_policy_test.go ci(bazel): dolt-int gates server-storage + cmd-dolt in mode remote (item 5 A2) (#7535) 2026-10-13 09:17:54 +00:00
pinned_shards_helpers_test.go test(bazel): shard http_served_test and corpus_served_test (embedded lane critical path) (#7537) 2026-10-13 11:35:34 +00:00
pinned_shards_sources_test.go test(bazel): shard http_served_test and corpus_served_test (embedded lane critical path) (#7537) 2026-10-13 11:35:34 +00:00
pinned_shards_test.go ci(bazel): pin httpclient_served_test's slow tests to shards (16 -> 26 shards) (#7443) 2026-10-09 22:11:43 +00:00
pr-preflight.sh fix(pr-preflight): warn when a PR-gate workflow is red for every PR while the base shows green (#5251) 2026-08-01 22:46:44 -07:00
pr_lanes_bazel_coverage_test.go fix(bazel): one nogo-validating lane per race configuration (F5 S1) (#7479) 2026-10-10 18:05:17 +00:00
pr_preflight_test.go ci(pr): cut the Windows PR preflight leg's fixed costs (slice W) (#7378) 2026-10-08 02:42:27 +00:00
pr_risk_bazel_coverage_test.go test(bazel): shard http_served_test and corpus_served_test (embedded lane critical path) (#7537) 2026-10-13 11:35:34 +00:00
pre-push-suite.sh docs(bazel): make bazel test the primary build and test path (ga-96smfk.23) (#7348) 2026-10-07 07:46:02 +00:00
pre_push_suite_test.go fix(hooks): key the push-time suite on the remote ref, never on the local ref's shape (#7352) 2026-10-08 07:49:57 +00:00
proxied_lane_coverage_test.go ci(bazel): run every BEADS_TEST_PROXIED_SERVER-gated cmd/bd test in the proxied lane (+ guard) (#7468) 2026-10-10 13:51:34 +00:00
pull_dolt_image_test.go ci(bazel): split //scripts:scripts_test by what it reads; partition //:repo_files (#7414) 2026-10-09 05:13:07 +00:00
rbe_worker_env_test.go ci(bazel): remote repo contents cache: main-push seed, lane readers, nightly verify (#7453) 2026-10-10 02:50:26 +00:00
README.md ci(bazel): split //scripts:scripts_test by what it reads; partition //:repo_files (#7414) 2026-10-09 05:13:07 +00:00
release.sh fix(release): harden shipped release formula adoption (#3668) 2026-05-06 12:14:54 -07:00
release_script_test.go ci(bazel): run pr.yml's repository guards as Bazel tests (#7329) 2026-10-07 00:59:18 +00:00
repo_helpers_test.go build(dolt): raise the Dolt CLI, container and Bazel pins to 2.4.1 2026-10-18 14:05:10 +00:00
required_suite_test.go test(ci): make doc-freshness selection fail closed (#5729) 2026-10-01 01:05:12 -07:00
resolve-docs-bd.sh docs(pipeline): pin the CLI docs to the released bd; repair main's broken CLI reference (#4876) 2026-07-17 18:03:28 -07:00
scripts_targets_test.go ci(bazel): split //scripts:scripts_test by what it reads; partition //:repo_files (#7414) 2026-10-09 05:13:07 +00:00
shard_manifest_test.go fix(bazel): remove host-go dep from compact GC test; drop frozen shard blocks (#7478) 2026-10-10 19:24:21 +00:00
sign-windows.sh docs: update user-facing URLs from steveyegge/beads to gastownhall/beads 2026-04-24 08:17:42 -07:00
test-cgo.sh Rename ICU-only test path to explicit opt-in workflow (bd-b18) (#3291) 2026-04-16 08:54:24 -07:00
test-git-remote.sh fix(schema): replace compaction_snapshots' descending index with an ascending twin (0071) 2026-10-18 16:25:40 +00:00
test-icu-path.sh Rename ICU-only test path to explicit opt-in workflow (bd-b18) (#3291) 2026-04-16 08:54:24 -07:00
test.sh ci(bazel): run every Windows/macOS job on Blacksmith; retire the Linux preflight leg and the cross-compiled Windows pair (#7355) 2026-10-07 10:41:14 +00:00
test_script_test.go ci(bazel): run the scripts and source-walking tests remotely; retire their go test legs (#7320) 2026-10-06 22:20:16 +00:00
testing_short_tree_test.go ci(bazel): split //scripts:scripts_test by what it reads; partition //:repo_files (#7414) 2026-10-09 05:13:07 +00:00
tracked_files_test.go ci(bazel): remote repo contents cache: main-push seed, lane readers, nightly verify (#7453) 2026-10-10 02:50:26 +00:00
update-nix-vendorhash.sh fix(scripts): update-nix-vendorhash no longer reports a build failure as success (#7504) 2026-10-14 22:18:15 +00:00
update-versions.sh fix(release): version bumps now own the tracked .githooks markers 2026-08-11 14:06:28 -07:00
update-winget.sh fix(winget): require PortableCommandAlias for GasTownHall.Beads (#5134) 2026-09-30 20:24:59 -07:00
update_nix_vendorhash_test.go fix(scripts): update-nix-vendorhash no longer reports a build failure as success (#7504) 2026-10-14 22:18:15 +00:00
update_nix_vendorhash_unix_test.go fix(scripts): update-nix-vendorhash no longer reports a build failure as success (#7504) 2026-10-14 22:18:15 +00:00
upgrade-smoke-test.sh Beads 1.2 remediation: migration-consent gate — bd never migrates an existing database without explicit consent (#5764) 2026-10-08 08:21:31 +00:00
upgrade_smoke_loop_test.go fix(smoke): clear the version list before child dispatch (#6398) 2026-09-28 08:25:22 -07:00
verify-cgo.sh fix: remove ICU runtime dependency from release binaries (#3066) 2026-04-07 09:48:44 -07:00
worker_env_autosync_test.go test: fix the three causes of Main's Test (macOS) failures (#7494) 2026-10-11 02:31:35 +00:00

Beads Scripts

Utility scripts for maintaining the beads project.

ci/

Repository-owned CI command wrappers. These scripts are the source of truth for the target CI tiers; Make targets are aliases for local discoverability.

make ci-pr-core
make ci-pr-lint
make ci-package-mcp
make ci-package-npm

Each wrapper auto-detects the repository root, sources .buildflags when it invokes Go in the default build mode, and records per-command timing through scripts/ci/lib/timing.sh.

ci-pr-lint keeps its supported Bash/Make entrypoint but delegates to the checkout-owned scripts/pr-lint Go driver, which runs nogo (//tools/nogo) under Bazel natively and cross-configured for windows/amd64 and darwin/arm64 (see engdocs/LINTING.md). This is the same shell-free lint authority used by bd preflight in a Beads source checkout.

Broad Go test wrappers also source scripts/ci/lib/test-env.sh, which creates a temporary HOME/XDG/Dolt root, isolates Git global/system config, clears runtime Beads/Dolt environment variables, and sets BEADS_TEST_SKIP=dolt before tests run. This keeps local make test-go and make ci-pr-core results comparable to the fast PR-core contract even on shared agent hosts. Set BEADS_TEST_ENV_RUN_DOLT=1 only when intentionally running the Dolt-dependent tests through these broad wrappers, or BEADS_TEST_ENV_DISABLE=1 when debugging against your real local configuration.

The broad Go wrappers also cap package and test parallelism to 4 by default (GO_TEST_PKG_PARALLEL and GO_TEST_PARALLEL). This avoids turning high-core shared hosts into a different test topology than GitHub Actions.

scripts/check-testing-short.sh (make check-testing-short; CI runs it in //scripts:go_sources_test) enforces that testing.Short() is only used for runtime, stress, or large-fixture skips. Use build tags, environment checks, or named wrappers for integration/e2e/API boundaries.

Package gate wrappers validate publishable/package-adjacent surfaces:

  • make ci-package-mcp builds or consumes a bd binary, puts it on PATH as bd, then runs locked MCP package uv sync, Ruff, mypy, pytest, and build checks.
  • make ci-package-npm builds or consumes the native binary expected by npm-package/bin/bd, runs the npm package test suite, and checks npm pack --dry-run.

Set BEADS_TEST_BD_BINARY=/path/to/bd for MCP and npm package gates to reuse a prebuilt candidate binary instead of rebuilding it inside the wrapper.

pr-preflight.sh

Read-only PR safety check for agents and maintainers.

# Before implementing or opening a related PR
./scripts/pr-preflight.sh --search "topic keywords" --repo gastownhall/beads

# Before changing, closing, or merging an existing PR
./scripts/pr-preflight.sh 123 --repo gastownhall/beads

It reports contributor/fork status, draft/review/merge/check state, risky diff signals such as .beads/ changes or missing tests, and the required contributor-protection next steps. It does not replace code review or local validation.

Base-branch health is supplemented by a warn-only PR-gate sample: the last 60 completed pull_request-event runs, grouped per workflow. A single workflow whose decisive runs (>= 5, across >= 3 distinct head branches) are all failure-class is reported as a broken PR gate — the case where a job that exists only in the PR workflow is red for every PR while the base branch shows green. This detector never blocks (deliberately: automation classifies unrecognized [block] lines as genuine merge blockers and would park merge lanes on a false positive); it is skipped entirely while the base branch is red.

gh-body-lint

Lint Markdown files before posting them with gh ... --body-file.

./scripts/gh-body-lint body.md
./scripts/gh-body-lint --fix body.md

The lint catches literal \n sequences, which render poorly on GitHub, and GH#123 references, which do not auto-link like #123 or owner/repo#123.

release.sh (⭐ The Easy Button)

One-command release from version bump to local installation.

Usage

# Full release (does everything)
./scripts/release.sh 0.9.3

# Preview what would happen
./scripts/release.sh 0.9.3 --dry-run

What It Does

This master script automates the entire release process:

  1. ✅ Stops running Dolt servers (avoids version conflicts)
  2. ✅ Runs tests and linting
  3. ✅ Bumps version in all files
  4. ✅ Commits and pushes version bump
  5. ✅ Creates and pushes git tag
  6. ✅ Verifies or opens the Homebrew core formula PR
  7. ✅ Upgrades local Homebrew installation
  8. ✅ Verifies everything works

After this script completes, your system is running the new version!

Examples

# Release version 0.9.3
./scripts/release.sh 0.9.3

# Preview a release (no changes made)
./scripts/release.sh 1.0.0 --dry-run

Prerequisites

  • Clean git working directory
  • All changes committed
  • Homebrew installed (for local upgrade)
  • Push access to gastownhall/beads

Output

The script provides colorful, step-by-step progress output:

  • 🟨 Yellow: Current step
  • 🟩 Green: Step completed
  • 🟥 Red: Errors
  • 🟦 Blue: Section headers

What Happens Next

After the script finishes:

  • GitHub Actions builds binaries for all platforms (~5 minutes)
  • PyPI package is published automatically
  • Homebrew core formula is verified or tracked through its canonical PR
  • Users can brew upgrade beads to get the new version after Homebrew merges
  • GitHub Release is created with binaries and changelog

bump-version.sh

Bumps the version number across all beads components in a single command.

Usage

# Show usage
./scripts/bump-version.sh

# Update versions (shows diff, no commit)
./scripts/bump-version.sh 0.9.3

# Update versions and auto-commit
./scripts/bump-version.sh 0.9.3 --commit

What It Does

Updates version in all these files:

  • cmd/bd/version.go - bd CLI version constant
  • plugins/beads/.claude-plugin/plugin.json - Claude plugin version
  • plugins/beads/.codex-plugin/plugin.json - Codex plugin version
  • .claude-plugin/marketplace.json - Claude marketplace plugin version
  • integrations/beads-mcp/pyproject.toml - MCP server version
  • README.md - Alpha status version
  • PLUGIN.md - Version requirements

Features

  • Validates semantic versioning format (MAJOR.MINOR.PATCH)
  • Verifies all versions match after update
  • Shows git diff of changes
  • Auto-commits with standardized message (optional)
  • Cross-platform compatible (macOS and Linux)

Examples

# Bump to 0.9.3 and review changes
./scripts/bump-version.sh 0.9.3
# Review the diff, then manually commit

# Bump to 1.0.0 and auto-commit
./scripts/bump-version.sh 1.0.0 --commit
git push origin main

Why This Script Exists

Previously, version bumps only updated cmd/bd/version.go, leaving other components out of sync. This script ensures all version numbers stay consistent across the project.

Safety

  • Checks for uncommitted changes before proceeding
  • Refuses to auto-commit if there are existing uncommitted changes
  • Validates version format before making any changes
  • Verifies all versions match after update
  • Shows diff for review before commit

sign-windows.sh

Signs Windows executables with an Authenticode certificate using osslsigncode.

Usage

# Sign a Windows executable
./scripts/sign-windows.sh path/to/bd.exe

# Environment variables required for signing:
export WINDOWS_SIGNING_CERT_PFX_BASE64="<base64-encoded-pfx>"
export WINDOWS_SIGNING_CERT_PASSWORD="<certificate-password>"

What It Does

This script is called automatically by GoReleaser during the release process:

  1. Decodes the PFX certificate from base64
  2. Signs the Windows executable using osslsigncode
  3. Timestamps the signature using DigiCert's RFC3161 server
  4. Replaces the original binary with the signed version
  5. Verifies the signature was applied correctly

Prerequisites

  • osslsigncode installed (apt install osslsigncode or brew install osslsigncode)
  • EV code signing certificate exported as PFX file
  • GitHub secrets configured:
    • WINDOWS_SIGNING_CERT_PFX_BASE64 - base64-encoded PFX file
    • WINDOWS_SIGNING_CERT_PASSWORD - certificate password

Graceful Degradation

If the signing secrets are not configured:

  • The script prints a warning and exits successfully
  • GoReleaser continues without signing
  • The release proceeds with unsigned Windows binaries

This allows releases to work before a certificate is acquired.

Why This Script Exists

Windows code signing helps reduce antivirus false positives that affect Go binaries. Kaspersky and other AV software commonly flag unsigned Go executables as potentially malicious due to heuristic detection. See docs/reference/antivirus.md for details.


Future Scripts

Additional maintenance scripts may be added here as needed.