release: WRNexusJS 0.6.0

2026-08-01 06:50:37 +05:30
parent 687d345882
commit d5e834bc78
14 changed files with 960 additions and 1107 deletions
@@ -0,0 +1,33 @@
+# R12 release reference gate fix
+
+## Failure
+
+`bun run scripts/release.ts publish` could stop with:
+
+```text
+UI component reference is stale.
+M packages/ui/component-reference.json
+```
+
+even when the generated content was current.
+
+## Root cause
+
+The release gate used `git status --short` immediately after the generator ran. On Windows, generated files are written with LF while an `autocrlf` checkout may use CRLF. Git status can report the worktree file as modified even when its canonical Git content is unchanged.
+
+The generator also writes `component-catalog.json`, but that file was not part of the release gate. Component ordering used `localeCompare`, which can vary by operating-system locale.
+
+## Fix
+
+- Compare generated files with `git diff --quiet`, which applies Git text normalization.
+- Show real differences with `git diff --name-status`.
+- Include all generated UI reference files:
+  - `packages/ui/component-catalog.json`
+  - `packages/ui/component-reference.json`
+  - `packages/ui/COMPONENTS.md`
+- Replace locale-dependent sorting with a deterministic ASCII comparator.
+- Add validation guards for the complete release gate.
+
+## Expected result
+
+A line-ending-only rewrite does not block publication. A real component-reference, catalog, or documentation difference still blocks publication and prints the exact changed files.