docs(ms-ai-architect): fjern de doede design-system-instruksjonene fra egen dokumentasjon
Dokumentasjonen instruerte lesere om a kjore `node scripts/sync-design-system.mjs ms-ai-architect` fra marketplace-roten, og om a legge DS-endringer i `shared/playground-design-system/`. Malt 2026-08-26 mot ground truth: `find` over marketplace-treet (maxdepth 4) finner ikke skriptet noe sted, og `shared/`-katalogen finnes ikke. Marketplace er polyrepo; designsystemet er et eget soesterrepo med CSS-filene i rot. En dokumentasjon som peker pa et skript som ikke finnes er usann. Rettet, 9 linjer i 2 filer: - README.md 471, 473-475 (+ 474 som beskrev `--force`-oppforselen til samme skript) - docs/playground.md 55, 59, 61-62, 64 Erstatningsteksten oppgir bevisst INGEN ny kommando. Den riktige re-sync-veien er ukjent: spoersmalet er sendt til `playground-design-system` (coord 20260826T125424Z-633311263) og er ubesvart. Teksten sier na hva som er malt, at veien er under avklaring, og at den vendored kopien er komplett og fungerer som den er. "Under avklaring" er sant; en peker til et fravaerende skript er det ikke. IKKE roert - historiske oppforinger der stien var sann da den ble skrevet: CHANGELOG.md 203/291/336/399/412/452, README.md 409/420, docs/playground.md 41, playground/A11Y-RAPPORT.md 86. Heller ikke playground/vendor/** (upstreams filer) eller MANIFEST.json sitt source-felt (spurt om, ikke besvart). Verifisering: ingen test dekker prosa, sa grep ER sjekken. Hver av de 9 linjene ble lest med `sed -n Np` og telt med `grep -Fxc -e` foer erstatning (alle unike, 1 forekomst); en kjent-negativ ga 0/rc=1, sa telleren kan skille "ingen treff" fra "broedt kall". Diff-kontekst lest med -U6 foer commit. Suite over sporede testfiler: 1070/1070.
This commit is contained in:
parent
31d2b62aed
commit
66eda40cb4
2 changed files with 9 additions and 9 deletions
|
|
@ -468,11 +468,11 @@ Regenerate via `cd tests/screenshot && npm install && npx playwright install chr
|
|||
|
||||
### Vendored design-system
|
||||
|
||||
The playground loads CSS from `playground/vendor/playground-design-system/` — a vendored copy of the marketplace-root `shared/playground-design-system/`. This keeps the plugin **standalone**: copy the plugin folder anywhere and the playground still works.
|
||||
The playground loads CSS from `playground/vendor/playground-design-system/` — a vendored copy of the shared playground design-system (27 files + `MANIFEST.json`). This keeps the plugin **standalone**: copy the plugin folder anywhere and the playground still works.
|
||||
|
||||
- **Sync:** `node scripts/sync-design-system.mjs ms-ai-architect` (run from marketplace root)
|
||||
- **Drift detection:** `MANIFEST.json` records SHA-256 per file. Re-sync refuses to overwrite files modified locally — pass `--force` to override.
|
||||
- **Generated header:** Each vendored CSS file is prefixed with `/* Code generated by sync-design-system.mjs; DO NOT EDIT. */`. Edit `shared/`, then re-sync.
|
||||
- **Drift detection:** `MANIFEST.json` records SHA-256 per file, so local modification of a vendored file is detectable.
|
||||
- **Generated header:** Each vendored CSS file is prefixed with `/* Code generated by sync-design-system.mjs; DO NOT EDIT. */`. Never edit the vendored files directly.
|
||||
- **⚠️ Re-sync path under clarification — no command to run.** `MANIFEST.json` records this copy as synced from `shared/playground-design-system/` at the marketplace root via `scripts/sync-design-system.mjs`. Verified 2026-08-26: **neither that directory nor that script exists in the marketplace tree any more** — the marketplace is a polyrepo, and the design-system is its own sibling repository with the CSS files at its root. There is currently **no documented way to refresh this copy**, and this section deliberately names none rather than point at something that does not run. The question is with the design-system repository; this section will be updated when it is answered. The vendored copy is complete and the playground runs from it unchanged in the meantime.
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -52,15 +52,15 @@ v1.14.0 (DS v0.4.0): root-cause fix for tre DS-bugs som tidligere ble symptomati
|
|||
|
||||
Alle PARALLEL-CSS-navngrupper migrert til DS-konvensjon. `renderPageShell` + `renderKeyStatsGrid` refaktorert til DS markup. Severity-coded card-borders på rapport-cards, app-header-restruktur, `.stack-lg` body spacing på home/project/catalog, AI Act-pyramide bredde-fix, eyebrow-label på home-projects.
|
||||
|
||||
Ved videre hoisting: re-sync via `node scripts/sync-design-system.mjs ms-ai-architect`. Dette er endringer i delt asset — krever drift-deteksjon-handling per `MANIFEST.json`.
|
||||
Ved videre hoisting: dette er endringer i et delt asset og krever drift-deteksjons-håndtering per `MANIFEST.json`. ⚠️ Selve re-sync-veien er under avklaring — se «Vendored design-system» under; per 2026-08-26 finnes det ingen dokumentert kommando å kjøre.
|
||||
|
||||
## Vendored design-system
|
||||
|
||||
Playground laster CSS fra `playground/vendor/playground-design-system/` — en vendored kopi av marketplace-rotens `shared/playground-design-system/`. Dette holder pluginen **standalone**: HTML-filen kan åpnes fra `file://` uavhengig av marketplace-roten.
|
||||
Playground laster CSS fra `playground/vendor/playground-design-system/` — en vendored kopi av det delte playground-designsystemet (27 filer + `MANIFEST.json`). Dette holder pluginen **standalone**: HTML-filen kan åpnes fra `file://` uavhengig av marketplace-roten.
|
||||
|
||||
- **Sync-skript:** `node scripts/sync-design-system.mjs ms-ai-architect` (ved marketplace-rot)
|
||||
- **Drift-deteksjon:** `MANIFEST.json` lagrer SHA-256 per fil. Re-sync feiler hvis vendored fil er endret lokalt — `--force` overstyrer.
|
||||
- **⚠️ Re-sync-veien er under avklaring — ingen kommando å kjøre.** `MANIFEST.json` bokfører kopien som synket fra `shared/playground-design-system/` ved marketplace-roten, via `scripts/sync-design-system.mjs`. Målt 2026-08-26: **verken katalogen eller skriptet finnes lenger** i marketplace-treet — marketplace er polyrepo, og designsystemet er et eget søsterrepo med CSS-filene i rot. Det finnes derfor **ingen dokumentert måte å oppdatere kopien på** i dag, og dette avsnittet oppgir bevisst ingen framfor å peke på noe som ikke kjører. Spørsmålet ligger hos designsystem-repoet; avsnittet oppdateres når det er besvart. Kopien er komplett, og playgrounden kjører uendret på den i mellomtiden.
|
||||
- **Drift-deteksjon:** `MANIFEST.json` lagrer SHA-256 per fil, så lokal endring av en vendored fil er detekterbar.
|
||||
- **Lastes i HTML:** `<link>`-tags til `fonts.css`, `tokens.css`, `base.css`, `components.css`, `components-tier2.css`, `components-tier3.css`, `components-tier3-supplement.css` (i den rekkefølgen).
|
||||
- **Aldri rediger** filer under `vendor/playground-design-system/` direkte — endringer går i `shared/`, deretter re-sync.
|
||||
- **Aldri rediger** filer under `vendor/playground-design-system/` direkte. Oppstrøms-endringer hører hjemme i designsystem-repoet — men se punktet over: veien tilbake hit er under avklaring.
|
||||
|
||||
> v2-spec under `docs/playground-v2-spec.md` er beholdt som historisk referanse, men er IKKE gjeldende kontrakt. v3-arkitekturen er dokumentert i `.claude/projects/2026-05-03-playground-v3-architecture/`.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue