@glw907/cairn-cms 0.57.1 → 0.58.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,35 @@
2
2
 
3
3
  All notable changes to this project are recorded here, most recent first.
4
4
 
5
+ ## 0.58.0
6
+
7
+ <!-- release-size: minor -->
8
+
9
+ The Media Library learns to fix an image everywhere it is used. Two new operations rewrite every
10
+ placement of one asset in a single commit to `main`, each behind a preview an editor confirms before
11
+ anything changes. Both read usage across `main` and every open edit branch, both report the held edits
12
+ they will not touch, and both fail closed when usage cannot be verified.
13
+
14
+ Replace swaps the file behind an image without revisiting the pages that use it. cairn is
15
+ content-addressed, so a corrected upload is a new object with a new content hash; replace repoints
16
+ every published reference from the old hash to the new one and keeps the slug, so `media:first-light.<old>`
17
+ becomes `media:first-light.<new>` and the name an author sees is unchanged. The old row and its R2 bytes
18
+ are kept, recoverable from git history, rather than erased. A typed-slug confirm gates the apply, since
19
+ it rewrites published content and can break a draft, and the preview names the open edit branches still
20
+ on the old file. Those branches keep the old file until they republish; they are never rewritten.
21
+
22
+ Push alt fills missing descriptions from one place. An image's default alt copies into every placement
23
+ that has none, in one atomic commit. An explicit opt-in, off by default, also overwrites placements
24
+ that already carry a custom alt, since that replaces an author's words. A frontmatter hero marked
25
+ decorative is skipped, because its empty alt is deliberate. The media manifest is not changed: the
26
+ default alt is read from the row, never rewritten there. Alt fill is reversible and frequent, so it
27
+ carries no typed-slug gate.
28
+
29
+ No consumer action is required. Both operations are admin-side and additive, with no public surface
30
+ change and no content-format change. An editor walkthrough is in
31
+ [manage the media library](docs/guides/manage-the-media-library.md), and the design rationale is in
32
+ [media storage](docs/explanation/media-storage.md).
33
+
5
34
  ## 0.57.1
6
35
 
7
36
  Media polish and cutover DX, the first follow-on after the `0.57.0` media stack. The Media Library