Skip to content

docs(product): Compass DS token full-cutover + canvas migration design - #234

Open
seal-agent wants to merge 2 commits into
mainfrom
compass-ui-1876-ds-token-cutover-design
Open

docs(product): Compass DS token full-cutover + canvas migration design#234
seal-agent wants to merge 2 commits into
mainfrom
compass-ui-1876-ds-token-cutover-design

Conversation

@seal-agent

Copy link
Copy Markdown
Contributor

Full-cutover design record superseding the DL-157 incremental strangler
per Matt's ruling (2026-08-07): a pre-dogfood codebase has no live users
to protect, so the legacy :root token tier is deleted and every consumer
flips to --cx-* in one atomically-merged migration — canvas to Night Owl,
base.css un-shadowed, state dots recolored, D7 stylelint guard wired at
error — proven by a Playwright visual-smoke harness Matt reviews.

Ledger: flip DL-157 -> Superseded by DL-161; append DL-161.
Ledger-impact: DL-161 added; DL-157 superseded.

Four load-bearing Open Questions parked for Matt (overnight): the 4
--purple consumers, the --st-merged PR badge, --accent-dim fidelity +
paired foreground, and PR-train topology. Record merges once ruled.

Refs SEA-1876

Co-authored-by: Matt Wilkinson matt@sealedsecurity.com

Full-cutover design record superseding the DL-157 incremental strangler
per Matt's ruling (2026-08-07): a pre-dogfood codebase has no live users
to protect, so the legacy :root token tier is deleted and every consumer
flips to --cx-* in one atomically-merged migration — canvas to Night Owl,
base.css un-shadowed, state dots recolored, D7 stylelint guard wired at
error — proven by a Playwright visual-smoke harness Matt reviews.

Ledger: flip DL-157 -> Superseded by DL-161; append DL-161.
Ledger-impact: DL-161 added; DL-157 superseded.

Four load-bearing Open Questions parked for Matt (overnight): the 4
--purple consumers, the --st-merged PR badge, --accent-dim fidelity +
paired foreground, and PR-train topology. Record merges once ruled.

Refs SEA-1876

Co-authored-by: Matt Wilkinson <matt@sealedsecurity.com>
@linear-code

linear-code Bot commented Aug 8, 2026

Copy link
Copy Markdown

SEA-1876

Incomplete Open-Questions renumbering left 5 dangling refs after the
scrollbar-hover OQ was demoted to a stated assumption and topology
became OQ-4. Reconcile every OQ-n reference against the final 4-item
list (OQ-1 purple, OQ-2 st-merged, OQ-3 accent-dim, OQ-4 topology):
- L119-122 / T2: scrollbar-hover now points at the stated-assumption
  bullet, not a phantom OQ-4.
- Global constraints: "see OQ-5 topology" / "is OQ-5" -> OQ-4.
- tokens.css read-only note: drop OQ-4 from the compass-ux-coined
  list (topology coins no token); keep OQ-2.
- T3: "4 --purple refs" -> "4 remaining --purple consumers (5 var()
  refs)" to match the ref/consumer vocabulary the record uses.

Co-authored-by: Matt Wilkinson <matt@sealedsecurity.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant