docs: update ROADMAP.md with issue numbers [roadmap-sync]

Author: roadmap-sync[bot]

ROADMAP.md

@@ -1,56 +1,56 @@
 ## Phase 1 · Repository foundation (already done) <!-- phase:foundation -->
 
-- [ ] Consolidate monorepo structure with packages in `extensions/`, `themes/`, and `ui-mods/`
-- [ ] Publish root documentation: `README.md`, `CONTRIBUTING.md`, `SECURITY.md`, `CODE_OF_CONDUCT.md`, `SUPPORT.md`, `CHANGELOG.md`
-- [ ] Normalize package `README.md` files to GitHub-compatible HTML format
-- [ ] Define initial visual identity and previews in `assets/` and theme folders
-- [ ] Keep per-package licensing strategy (`MIT` for tooling and dedicated licenses for themes)
+- [ ] Consolidate monorepo structure with packages in `extensions/`, `themes/`, and `ui-mods/` (#5)
+- [ ] Publish root documentation: `README.md`, `CONTRIBUTING.md`, `SECURITY.md`, `CODE_OF_CONDUCT.md`, `SUPPORT.md`, `CHANGELOG.md` (#6)
+- [ ] Normalize package `README.md` files to GitHub-compatible HTML format (#7)
+- [ ] Define initial visual identity and previews in `assets/` and theme folders (#8)
+- [ ] Keep per-package licensing strategy (`MIT` for tooling and dedicated licenses for themes) (#9)
 
 ## Phase 2 · Governance and automation <!-- phase:automation -->
 
-- [ ] Integrate `xgh/github-roadmap-sync` into the main repo flow (`.github/scripts/sync_roadmap.py`)
-- [ ] Create `roadmap-sync.yml` workflow to sync `ROADMAP.md` with GitHub Issues
-- [ ] Define phase label convention and create baseline labels on GitHub
-- [ ] Run local `--dry-run` with authenticated `gh` and validate duplicate prevention
-- [ ] Document roadmap sync usage in root documentation
+- [ ] Integrate `xgh/github-roadmap-sync` into the main repo flow (`.github/scripts/sync_roadmap.py`) (#10)
+- [ ] Create `roadmap-sync.yml` workflow to sync `ROADMAP.md` with GitHub Issues (#11)
+- [ ] Define phase label convention and create baseline labels on GitHub (#12)
+- [ ] Run local `--dry-run` with authenticated `gh` and validate duplicate prevention (#13)
+- [ ] Document roadmap sync usage in root documentation (#14)
 
 ## Phase 3 · Theme quality <!-- phase:themes-quality -->
 
-- [ ] Audit contrast and readability for all themes in `themes/x-dark-colors/themes/*.json`
-- [ ] Audit contrast and readability for all themes in `themes/xscriptor-themes/themes/*.json`
-- [ ] Normalize naming (accents, city names, variants) across theme labels and docs
-- [ ] Review consistency between syntax colors and UI colors (activity bar, status bar, badges)
-- [ ] Improve accessibility for transparency combinations with `xglass`
-- [ ] Add a visual QA checklist per theme (JS/TS, JSON, Markdown, diff, terminal)
+- [ ] Audit contrast and readability for all themes in `themes/x-dark-colors/themes/*.json` (#15)
+- [ ] Audit contrast and readability for all themes in `themes/xscriptor-themes/themes/*.json` (#16)
+- [ ] Normalize naming (accents, city names, variants) across theme labels and docs (#17)
+- [ ] Review consistency between syntax colors and UI colors (activity bar, status bar, badges) (#18)
+- [ ] Improve accessibility for transparency combinations with `xglass` (#19)
+- [ ] Add a visual QA checklist per theme (JS/TS, JSON, Markdown, diff, terminal) (#20)
 
 ## Phase 4 · Versioning and releases <!-- phase:releases -->
 
-- [ ] Define semantic versioning strategy for `xglass`, `x-dark-colors`, and `xscriptor-themes`
-- [ ] Bump version in `extensions/xglass/package.json` with matching changelog notes
-- [ ] Bump version in `themes/x-dark-colors/package.json` with matching changelog notes
-- [ ] Bump version in `themes/xscriptor-themes/package.json` with matching changelog notes
-- [ ] Standardize release notes per package (highlights, breaking changes, migrations)
-- [ ] Prepare pipeline/manual process to package `.vsix` for each package
+- [ ] Define semantic versioning strategy for `xglass`, `x-dark-colors`, and `xscriptor-themes` (#21)
+- [ ] Bump version in `extensions/xglass/package.json` with matching changelog notes (#22)
+- [ ] Bump version in `themes/x-dark-colors/package.json` with matching changelog notes (#23)
+- [ ] Bump version in `themes/xscriptor-themes/package.json` with matching changelog notes (#24)
+- [ ] Standardize release notes per package (highlights, breaking changes, migrations) (#25)
+- [ ] Prepare pipeline/manual process to package `.vsix` for each package (#26)
 
 ## Phase 5 · XGlass functional improvements <!-- phase:xglass-improvements -->
 
-- [ ] Review `xglass.alpha` and `xglass.step` defaults based on real usage feedback
-- [ ] Add clearer validation and error messages for Linux/X11 environments
-- [ ] Improve behavior in compositors that ignore opacity
-- [ ] Review keybindings for potential conflicts with common shortcuts
-- [ ] Expand platform-specific troubleshooting documentation
+- [ ] Review `xglass.alpha` and `xglass.step` defaults based on real usage feedback (#27)
+- [ ] Add clearer validation and error messages for Linux/X11 environments (#28)
+- [ ] Improve behavior in compositors that ignore opacity (#29)
+- [ ] Review keybindings for potential conflicts with common shortcuts (#30)
+- [ ] Expand platform-specific troubleshooting documentation (#31)
 
 ## Phase 6 · UI Mods and UX improvements <!-- phase:ui-mods -->
 
-- [ ] Align preset structure between `ui-mods/x-ui/` and `ui-mods/xscriptor-ui/`
-- [ ] Add before/after previews for each major mod
-- [ ] Publish step-by-step installation guide for Custom UI Style
-- [ ] Review mod compatibility with newer VS Code releases
+- [ ] Align preset structure between `ui-mods/x-ui/` and `ui-mods/xscriptor-ui/` (#32)
+- [ ] Add before/after previews for each major mod (#33)
+- [ ] Publish step-by-step installation guide for Custom UI Style (#34)
+- [ ] Review mod compatibility with newer VS Code releases (#35)
 
 ## Phase 7 · Ongoing maintenance <!-- phase:maintenance -->
 
-- [ ] Create a monthly routine for issue triage and prioritization
-- [ ] Review broken links and missing images across documentation
-- [ ] Track user feedback to prioritize new palettes and improvements
-- [ ] Keep root `CHANGELOG.md` updated for every release
-- [ ] Define acceptance criteria for roadmap task closure
+- [ ] Create a monthly routine for issue triage and prioritization (#36)
+- [ ] Review broken links and missing images across documentation (#37)
+- [ ] Track user feedback to prioritize new palettes and improvements (#38)
+- [ ] Keep root `CHANGELOG.md` updated for every release (#39)
+- [ ] Define acceptance criteria for roadmap task closure (#40)