Skip to content

Commit 66a2db9

Browse files
committed
docs(releases): name the stored-metadata pass on the v17 page (#4327)
The v17 entry for #3903 described the read-path guarantee and stopped there, and the upgrade checklist listed the two per-deployment migrations without this one. Both now point at `os migrate meta --stored`, marked optional — it opens no gate, unlike its two neighbours in that list. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WoZPKPDqJ7WB7z84xk9y3f
1 parent 2b4be6b commit 66a2db9

1 file changed

Lines changed: 12 additions & 1 deletion

File tree

content/docs/releases/v17.mdx

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1672,7 +1672,12 @@ platform capabilities an administrator gains, then the Console delta.
16721672
source at every read seam (including `registerFlow` rehydration) — a stored
16731673
action with the removed `execute` dispatches via `target` again; boot
16741674
hydration validates each row post-conversion and diagnoses invalid ones
1675-
with `[metadata_spec_invalid]` instead of shrugging.
1675+
with `[metadata_spec_invalid]` instead of shrugging. **The rows themselves
1676+
can now be brought forward too (#4327):** `os migrate meta --stored`
1677+
replays the chain over `sys_metadata` and rewrites what still carries a
1678+
pre-protocol shape, through the normal write path. Optional — the read path
1679+
is the guarantee either way — but it is what makes the conversion pass a
1680+
no-op on your data instead of a permanent shim.
16761681
- **Studio's metadata forms tell the truth (#3786).** Four of seventeen forms
16771682
had drifted from their schemas, so controls saved nothing: the Object →
16781683
Capabilities toggles bound a key the schema does not declare (all seven
@@ -1977,6 +1982,12 @@ covers are folded into the list below rather than left to the changelog.)
19771982
fix what it reports before `--apply`. It converts nothing — the values it
19781983
names are application data — and a scan that was truncated or could not read
19791984
an object fails the gate even at zero violations.
1985+
- **Stored metadata (optional):** run `os migrate meta --stored` to see which
1986+
`sys_metadata` rows still carry a pre-17 shape, and `--apply` to rewrite
1987+
them. Unlike the two above this opens no gate and nothing depends on it —
1988+
those rows already read canonically, forever. It stops them re-converting on
1989+
every load, keeps diffs and exports clean going forward, and gives you an
1990+
exit code to assert on: nothing left to do exits `0`.
19801991
- **Datasources:** verify every declared datasource connects in every
19811992
environment — a bound datasource that cannot connect now fails the boot
19821993
instead of failing every later query.

0 commit comments

Comments
 (0)