History / Release Process

docs: make public release policy authoritative

Home: reorganize into six sections with progressive disclosure Home listed 40 links across 7 sections while leaving 19 pages unlinked, so it was neither short nor complete. The hub pages that carry each cluster already exist (Component Lifecycle, Vibe Tests, Night Watch Overview, Research Archive); Home now points at them instead of duplicating their contents. - Home: 15 top-level links in Start here / Architecture / Building a component / Quality / Operations / Also. Nothing removed from the wiki — every demoted page is one click deeper behind a hub that lists it. - Add _Sidebar.md so the same navigation renders on every page. - Re-home the four pages Home was the only link to: Blog Review Rubric and Testing Example Apps from Contributing, Hardening Audit Guide from Component Lifecycle. Zero orphans after the change. - Fix the Contributing with AI Assistants link in Release Process, broken by a line wrap inside the [[...]].

Release Process: the release gate is Step 0, and a broken gate blocks the cut

Release Process: codemods are for published packages; lab breaks freely

Correct the build pipeline description: Babel and tsc, ESM-only output core/lab/charts/richtext build with Babel plus tsc, not tsup; core is type: module so there is no CJS bundle or .mjs/.d.mts pair. @astryxdesign/build ships StyleX Babel/PostCSS/Vite plugins, not a tsup config.

Release-Process: codemods stage in transforms/next/ (auto-promoted at version time)

Release protocol: bump the minor for breaking changes while 0.x Match the release tooling change (facebook/astryx#4264): a [breaking] changeset now bumps the minor (0.x.y -> 0.(x+1).0, the breaking tier under caret ranges) and everything else bumps the patch. Update the 0.x semver rule, the changeset bump table, the [breaking] example, and the Distribution versioning section accordingly.

Revert "Release process: advance latest branch to the release commit in post-release" This reverts commit 20347a4ead94b1d5dca01f7ea6087bb1f3275170.

Release process: advance latest branch to the release commit in post-release

Release-Process: add attribution-coverage gate before version bump; align release-notes category order with the formatter; generalize downstream sync + announcement steps

Fix package facts: themes, counts, versions Reconcile remaining factual drift against .changeset/config.json (source of truth for what publishes): - Remove non-existent packages theme-default / theme-daily / theme-brutalist (dirs exist but have no package.json; default theme is theme-neutral) - Release-Process: "12 publishable packages" → 10; stale 0.0.15 → 0.1.1; drop agent-docs from the CLI command list - Testing-Example-Apps: theme-default → theme-neutral (pack + dependency) - System-Architecture: "Four published packages" → ten (core, cli, build, seven themes) Co-authored-by: Cursor <cursoragent@cursor.com>

Update wiki for XDS → Astryx rename Refresh outdated references across all wiki articles to match the current codebase after the XDS → Astryx rebrand: - Package scope @xds/* → @astryxdesign/* (theme-default/theme-daily → theme-neutral; ESLint rule → @astryx/*) - CLI command xds → astryx; fix stale commands (build-theme → theme build, agent-docs folded into init) - CSS/layers: xds.css → astryx.css, @layer xds → @layer astryx-base, @layer xds.theme → @layer astryx-theme - Config key "xds" → "astryx"; env var XDS_THEME → ASTRYX_THEME - Repo facebookexperimental/xds → facebook/astryx; versions 0.0.15 → 0.1.1 - Swizzle output dir components/xds/ → components/astryx/ - API rename xdsThemeProps → themeProps (verified against source) - Asset set xds_oss → astryx (browse via internalfb.com/assets/set/astryx) - Correct component-purity docs: components are unprefixed (no "Astryx" prefix) Co-authored-by: Cursor <cursoragent@cursor.com>

wiki(release): reconcile partially-shipped issues before closing a milestone

wiki(release): close version milestone + create next one on publish

Release-Process: document refreshing pnpm-lock.yaml after version bump

docs(release): stable publish is manual dispatch of release.yml, not automatic on merge

docs(release): add GitHub Release creation as a post-release step

Update release process: trusted publishing + provenance

Astryx design system wiki Documentation for the Astryx design system: API conventions, component authoring, theming, RSC utilities, Night Watch automation, and contribution guides.