Migration guides

One guide per release that has breaking changes. Adopters jumping multiple versions follow the guides in chronological order.

• v0.68.72026-11-04

  The schema baseline advances to version 29, the first forward migration: a store at schema 28 with the v0.68.3 baseline digest (v0.68.3 and later 0.68 releases) upgrades in place on its first open The upgrade adds `nodes.trusted_host` and records version 29 and its digest in one transaction on SQLite and PostgreSQL; on PostgreSQL the migration advisory lock lets controllers starting together run it once; `--sw-run-handle-file` writes an identity-only handle without `status` The handle recorded `"status":"pending"` at intake and kept it after the run finished, so a reader polling it saw a run that never ended; `--sw-run-handle-file` writes an identity-only handle without `status` The handle recorded `"status":"pending"` at intake and kept it after the run finished, so a reader polling it saw a run that never ended.

• v0.68.32026-11-02

  Shared Cloud pools replace hand-made per-team NodePools Replace per-team pool manifests with one pool per hardware class and the generic dedicated taint; Confine warm placeholder authority to a dedicated namespace Move placeholders and their Pod get/delete and ReplicaSet get Role to `launcher.warmNamespace` (default `<release namespace>-cloud-warm`); Replace per-team Karpenter NodePools with one shared pool per requested hardware class and deployment Nodes receive their permanent team/run binding at first reservation and never move between runs; Prepare the pipeline and fetch its source once per run Only Cloud-awarded planning owners publish source and SDK installation snapshots for jobs of that run; List endpoints that returned whole collections now return cursor pages of 50 records by default, up to 200 per request Follow `next_cursor` while `truncated` is true; Each team can create 20 Stripe Checkout Sessions per rolling hour across Add funds and saved-card setup Idempotent retries count once; The schema baseline advances to version 28 in v0.68.3 as a store reset Before 1.0, schema changes may require moving the local store aside or recreating a server database; Sizing and capacity responses drop stored resource pins, demand floors, queue waits, contention counters and drift Update API clients using the [capacity-profile migration guide](v0.68.3.md#capacity-profiles-report-measured-data); Sparkwing releases use the native tag-and-publication flow Platform deployment is separate; Personal machines and here hosts never claim repository-proven runs, including run-now and burst `machines`; Job credentials require an intake GitHub compare check; Latest outputs default to verified default-branch runs and exclude publication; Teams have no member cap Remove `free_team_members` from operator signup settings, invitation `warning` handling and the `team_full` refusal reason; Accounts can create teams without a lifetime creation cap Deleting or leaving a team does not reduce future team-creation access; Removed the version-aware takeover ladder Local startup attempts one replacement; Removed installation proofs, fleet modes, automatic global-hook chaining and doctor's fleet survey `--no-prove`, `--all-repos` and `--ungated` are gone; Removed commit-status reporting Runs report through Checks only; Removed `internal/guardcheck`, its `.guards/` allow-lists and standalone gate steps Dependency rules run through depguard in `.golangci.yml`, including the fast push tier; Removed binary-cache checkout owners, use counts, shared-entry counts and `related_entries` history `cache explain` retains the current build key and input digests; Removed the $100 admin grant guard and `--allow-large` `sparkwing-controller admin grant` accepts any positive amount the credit ledger can hold; Removed `SPARKS_GO_BIN` Select the Go executable through `PATH` for sparks resolution and overlay updates; Removed `--live-log-node-kb`, `--live-log-total-mb`, `--live-log-max-nodes` and `--live-log-idle` Live buffers retain fixed limits of 512 KiB per node, 64 MiB total, 1,024 nodes and a 10-minute idle timeout.

• v0.68.02026-10-30

  v0.68 rewrites the engine, the store and the trust model.

• v0.67.02026-10-12

  CLI, source selection and environment configuration changes.

• v0.66.02026-10-01

  Historical release changes. Follow the latest migration for the current CLI.

• v0.65.02026-09-29

  Historical release changes. Follow the latest migration for the current CLI.

• v0.62.02026-09-27

  Historical release changes. Follow the latest migration for the current CLI.

• v0.61.02026-09-26

  Historical release changes. Follow the latest migration for the current CLI.

• v0.57.02026-09-20

  Historical release changes. Follow the latest migration for the current CLI.

• v0.52.32026-09-15

  Historical release changes. Follow the latest migration for the current CLI.

• v0.50.52026-09-14

  Historical release changes. Follow the latest migration for the current CLI.

• v0.50.42026-09-14

  Historical release changes. Follow the latest migration for the current CLI.

• v0.50.22026-09-14

  Historical release changes. Follow the latest migration for the current CLI.

• v0.50.12026-09-13

  Historical release changes. Follow the latest migration for the current CLI.

• v0.50.02026-09-12

  Historical release changes. Follow the latest migration for the current CLI.

• v0.49.02026-09-10

  Historical release changes. Follow the latest migration for the current CLI.

• v0.48.12026-09-09

  Historical release changes. Follow the latest migration for the current CLI.

• v0.48.02026-09-09

  Historical release changes. Follow the latest migration for the current CLI.

• v0.47.02026-09-09

  Historical release changes. Follow the latest migration for the current CLI.

• v0.46.02026-09-08

  Historical release changes. Follow the latest migration for the current CLI.

• v0.41.02026-09-04

  Historical release changes. Follow the latest migration for the current CLI.

• v0.37.32026-08-30

  Historical release changes. Follow the latest migration for the current CLI.

• v0.37.02026-08-28

  Historical release changes. Follow the latest migration for the current CLI.

• v0.36.0
• v0.35.02026-08-24

  Historical release changes. Follow the latest migration for the current CLI.

• v0.34.0
• v0.33.0
• v0.32.1
• v0.32.0
• v0.28.0
• v0.27.0
• v0.23.1
• v0.23.02026-08-08

  Historical release changes. Follow the latest migration for the current CLI.

• v0.17.02026-07-13

  Historical release changes. Follow the latest migration for the current CLI.

• v0.16.02026-07-12

  Historical release changes. Follow the latest migration for the current CLI.

• v0.15.52026-07-10

  Historical release changes. Follow the latest migration for the current CLI.

• v0.15.42026-07-10

  Historical release changes. Follow the latest migration for the current CLI.

• v0.11.02026-06-17

  Historical release changes. Follow the latest migration for the current CLI.

• v0.10.02026-06-14

  Historical release changes. Follow the latest migration for the current CLI.

• v0.9.02026-06-09

  Historical release changes. Follow the latest migration for the current CLI.

• v0.6.02026-05-29

  Historical release changes. Follow the latest migration for the current CLI.

• v0.5.02026-05-28

  Historical release changes. Follow the latest migration for the current CLI.

• v0.4.02026-05-20

  Historical release changes. Follow the latest migration for the current CLI.