WORK-372
Setting up your dashboard 0 entities found · 7/31 branches scanned
ID:WORK-372Status:done

Soft-lint raw CSS covered by structured facets + bg reference docs

Add a build-time soft warning for raw CSS that a structured facet now covers, and document gradients/escape-hatch/overlay in the bg reference.

Priority:lowComplexity:simpleMilestone:v0.20.0Source:SPEC-088
main View source

Criteria completion

Criteria completion: 2 of 2 (100%) checked; tracking started on Jun 9, no incremental history yet0%25%50%75%100%Jun 9Jun 15

Tracking started Jun 9 — check back for trends.

Relationships

Implements 1
Branches 3
main current done
claude/spec-088-bg-gradients-scrim donemain doneclaude/mcp-server-verify-4lnxej ready

Acceptance Criteria

  • A build-time soft warning flags a raw gradient/background in style or overlay that a structured facet covers, pointing to the facet.
  • The bg reference docs document gradients (facets + presets), the escape hatch (contract + config home), and the overlay change, cross-linked with SPEC-087/086.

Approach

site/content/runes/bg.md. SPEC-088 §2–§3.

References

  • SPEC-088

Resolution

Completed: 2026-06-09

Branch: claude/spec-088-bg-gradients-scrim

What was done

  • validate.ts soft-lint: a build-time warning when a background preset's style escape hatch contains a raw gradient the structured gradient field now covers (raw overlay warns at runtime via warnRawOverlay).
  • bg.md reference rewritten: gradient facets + token-name stops + presets, the overlay vocabulary + deprecation, the structured scrim (incl. foreground polarity), and the escape-hatch contract + config homes; cross-linked to the surface model.

Notes

  • The lint is a warning, not an error — the escape hatch stays valid.