feat: add release baseline and workspace scene

2026-03-19 19:32:25 +08:00
parent 132bb6961d
commit d5e4d5ece3
9 changed files with 2137 additions and 90 deletions
@@ -0,0 +1,51 @@
+# Changesets In This Repo
+
+This directory is the release-intent ledger for Cadence UI.
+
+The repo is still an internal/private monorepo, so Changesets is used conservatively:
+
+- track version intent for releasable workspace packages
+- keep release notes attached to code changes
+- avoid auto-committing release files
+- avoid tagging private packages during early internal iteration
+
+## What should get a changeset
+
+Create a changeset when a change affects:
+
+- `@ai-ui/ui`
+- `@ai-ui/tokens`
+
+Do not create a changeset for docs-only work in `@ai-ui/docs` unless that work ships alongside
+a package change that already needs one. The docs app is ignored in the config on purpose.
+
+## What kind of summary to write
+
+Keep the summary short and consumer-facing:
+
+- describe what changed
+- mention the component, token, or contract surface
+- avoid implementation detail unless it changes behavior
+
+Good:
+
+```md
+Add the Sheet component for contextual side panels and bottom trays.
+```
+
+Less useful:
+
+```md
+Refactor dialog wrapper internals and update story coverage.
+```
+
+## Current release posture
+
+The root repo is private and package publishing is not fully wired yet. Until the main release
+flow is enabled, treat Changesets as the source of truth for:
+
+- which package versions should move
+- which changes deserve release notes
+- which internal dependency bumps should be coordinated
+
+See `docs/releasing.md` for the expected workflow around creating and consuming changesets.